Skip to content

Open-source AI browser agent for Chrome and Firefox (monorepo) 🧠

Add OpenRouter tool and vision capability overrides

Codex release-state test5eb46b1379c5
diff --git a/.gitignore b/.gitignore
index 1d7725c51..c226e2203 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,4 +1,5 @@
.claude/
+.poolside/
.DS_Store
node_modules/
test/anonymous/.test-profile/
diff --git a/package.json b/package.json
index 83fa615b9..acc70abeb 100644
--- a/package.json
+++ b/package.json
@@ -5,11 +5,12 @@
"private": true,
"type": "module",
"scripts": {
-"test": "npm run test:cms && npm run test:markdown && npm run test:systemone && npm run test:systemone:fast && node --test test/browser-dialogs.mjs test/capsolver-cloud-broker.mjs test/captcha-providers.mjs test/captcha-weighted-fallback.mjs test/captcha-hcaptcha-providers.mjs test/captcha-native-providers.mjs test/captcha-runtime-policy.mjs test/captcha-callback-bridge.mjs test/captcha-aws-recovery.mjs test/captcha-documented-contracts.mjs test/huggingface-signup-recovery.mjs test/trace-full-export.mjs && npm run test:firefox-bidi && npm run test:runtime-lifecycle && npm run test:billing-notice && npm run test:provider-limits && npm run test:accessibility-tree-benchmark && npm run test:toolbar-guard && npm run test:cloud-bridge-approval && npm run test:discord && npm run test:pdf-read && npm run test:pdf-selection && npm run test:social-contract && npm run test:safesocial && npm run test:build-unpacked && npm run test:attachment-drop && npm run test:workflow-editor && node --test test/profile-sync-stats.mjs && node test/run.js && node test/selection-scope-restoration.mjs && node scripts/benchmark-offline-relevance.mjs && npm run test:security",
+"test": "npm run test:cms && npm run test:markdown && npm run test:systemone && npm run test:systemone:fast && node --test test/browser-dialogs.mjs test/capsolver-cloud-broker.mjs test/captcha-providers.mjs test/captcha-weighted-fallback.mjs test/captcha-hcaptcha-providers.mjs test/captcha-native-providers.mjs test/captcha-runtime-policy.mjs test/captcha-callback-bridge.mjs test/captcha-aws-recovery.mjs test/captcha-documented-contracts.mjs test/huggingface-signup-recovery.mjs test/trace-full-export.mjs && npm run test:firefox-bidi && npm run test:runtime-lifecycle && npm run test:billing-notice && npm run test:provider-limits && npm run test:openrouter-capabilities && npm run test:accessibility-tree-benchmark && npm run test:toolbar-guard && npm run test:cloud-bridge-approval && npm run test:discord && npm run test:pdf-read && npm run test:pdf-selection && npm run test:social-contract && npm run test:safesocial && npm run test:build-unpacked && npm run test:attachment-drop && npm run test:workflow-editor && node --test test/profile-sync-stats.mjs && node test/run.js && node test/selection-scope-restoration.mjs && node scripts/benchmark-offline-relevance.mjs && npm run test:security",
"test:captcha:ui": "node test/captcha-settings-ui.mjs && node test/captcha-application-ui.mjs",
"test:captcha:bridge:ui": "node test/captcha-callback-bridge-ui.mjs",
"test:billing-notice": "node test/billing-payment-notice.mjs",
"test:provider-limits": "node test/provider-model-limits.mjs",
+ "test:openrouter-capabilities": "node --test test/openrouter-model-capabilities.mjs",
"test:markdown": "node --test test/markdown-render.mjs",
"test:accessibility-tree-benchmark": "node --test test/llm/lib/accessibility-tree-formats.test.mjs && node test/llm/accessibility-tree-benchmark.mjs --no-exact-tokenizer --check",
"test:attachment-drop": "node test/attachment-drop.mjs",
diff --git a/src/chrome/src/providers/manager.js b/src/chrome/src/providers/manager.js
index dc063b0d0..d02928de8 100644
--- a/src/chrome/src/providers/manager.js
+++ b/src/chrome/src/providers/manager.js
@@ -278,6 +278,7 @@ const DUPLICATE_BLANK_CONFIG_KEYS = [
'outputCostPerMillionUsd',
'promptTier',
'routingVariant',
+ 'toolsMode',
'visionMode',
'visionDetection',
'supportsVision',
diff --git a/src/chrome/src/providers/openai.js b/src/chrome/src/providers/openai.js
index 3ca144804..ce09503af 100644
--- a/src/chrome/src/providers/openai.js
+++ b/src/chrome/src/providers/openai.js
@@ -1,9 +1,12 @@
import { BaseLLMProvider } from './base.js';
import { fetchWithFallback } from './fetch-with-fallback.js';
import {
+ baseModelNameSniffedVision,
isNewOpenAIContractConfig,
isOfficialOpenAIConfig,
isOpenCodeZenConfig,
+ isOpenRouterLingVisionModel,
+ isOpenRouterNexN25MiniModel,
requiresOpenAIDefaultTemperature,
shouldUseOpenAIResponsesApi,
supportsOpenAIAskStreaming,
@@ -106,6 +109,12 @@ export class OpenAICompatibleProvider extends BaseLLMProvider {
}
get supportsTools() {
+ const mode = this._capabilityMode('toolsMode');
+ if (mode === 'on') return true;
+ if (mode === 'off') return false;
+ // OpenRouter's Nex N2.5 mini route accepts chat completions but has no
+ // function-compatible endpoint. Sending even read-only tools returns 404.
+ if (this._isOpenRouterNexN25Mini()) return false;
return this.config.supportsTools !== false;
}
@@ -130,9 +139,18 @@ export class OpenAICompatibleProvider extends BaseLLMProvider {
if (AUTO_VISION_PROVIDER_IDS.has(providerName)) {
return configuredVisionSupport(providerName, this.config);
}
- // Explicit user opt-in always wins (used by LM Studio and any custom
- // OpenAI-compatible endpoint where the loaded model varies).
+ // The Advanced vision selector (auto/on/off) wins first. For OpenRouter
+ // the /vision slash command also writes visionMode (see sidepanel
+ // toggledVisionProviderConfig), so the toggle keeps working.
+ const mode = this._capabilityMode('visionMode');
+ if (mode === 'on') return true;
+ if (mode === 'off') return false;
+ // Legacy explicit opt-in/out (used by LM Studio, custom endpoints, and
+ // the /vision toggle for non-OpenRouter providers) wins over detection.
if (this.config.supportsVision != null) return !!this.config.supportsVision;
+ // OpenRouter-scoped detection for models the shared sniff cannot name
+ // (router route ids such as inclusionai/ling-3.0-flash-vl).
+ if (this._isOpenRouterLingVisionModel()) return true;
// Otherwise sniff the model name for known vision-capable identifiers.
// Qwen went natively multimodal starting at 3.5 (no separate -VL
// checkpoint needed), so qwen3\.[5-9] catches those alongside the
@@ -150,7 +168,22 @@ export class OpenAICompatibleProvider extends BaseLLMProvider {
* `supportsVision` getter above.
*/
_modelNameSniffedVision(model) {
- return /gpt-4o|gpt-4\.1|gpt-4-turbo|gpt-5|gpt-6-(?:luna-pro|sol|astra)(?:$|[-_.:/])|claude|gemini|grok|minimax-m3|kimi-k(?:-?3|2\.[5-9])|llava|qwen.*vl|qwen2.*vl|qwen3.*vl|qwen3\.[5-9]|qwen3p8-27b|pixtral|llama.*vision|gemma.*vision|gemma-?[34]|step-3/.test(String(model || ''));
+ return baseModelNameSniffedVision(model);
+ }
+
+ _isOpenRouterNexN25Mini() {
+ return String(this.config.providerName || '').trim().toLowerCase() === 'openrouter'
+ && isOpenRouterNexN25MiniModel(this.model);
+ }
+
+ _isOpenRouterLingVisionModel() {
+ return String(this.config.providerName || '').trim().toLowerCase() === 'openrouter'
+ && isOpenRouterLingVisionModel(this.model);
+ }
+
+ _capabilityMode(key) {
+ const mode = String(this.config[key] || '').trim().toLowerCase();
+ return ['auto', 'on', 'off'].includes(mode) ? mode : 'auto';
}
get useCompactPrompt() {
diff --git a/src/chrome/src/providers/provider-compatibility.js b/src/chrome/src/providers/provider-compatibility.js
index 63101f53c..cee1d9ab3 100644
--- a/src/chrome/src/providers/provider-compatibility.js
+++ b/src/chrome/src/providers/provider-compatibility.js
@@ -14,6 +14,29 @@ const MAX_TOKEN_FIELDS = new Set(['auto', 'max_tokens', 'max_completion_tokens']
const OPENROUTER_ROUTING_VARIANT_VALUES = new Set(['standard', 'nitro', 'exacto']);
const OPENROUTER_MODEL_VARIANT_SUFFIXES = /(?::(?:free|extended|thinking|online|nitro|floor|exacto))+$/i;
export const OPENROUTER_ROUTING_VARIANTS = Object.freeze(['standard', 'nitro', 'exacto']);
+
+// Shared base vision sniff (provider-agnostic). OpenAICompatibleProvider exposes
+// it via _modelNameSniffedVision so vendor subclasses (e.g. DeepSeek) can extend
+// it without duplicating the explicit-override precedence in supportsVision.
+const BASE_VISION_MODEL_PATTERN = /gpt-4o|gpt-4\.1|gpt-4-turbo|gpt-5|gpt-6-(?:luna-pro|sol|astra)(?:$|[-_.:/])|claude|gemini|grok|minimax-m3|kimi-k(?:-?3|2\.[5-9])|llava|qwen.*vl|qwen2.*vl|qwen3.*vl|qwen3\.[5-9]|qwen3p8-27b|pixtral|llama.*vision|gemma.*vision|gemma-?[34]|step-3/;
+export function baseModelNameSniffedVision(model) {
+ return BASE_VISION_MODEL_PATTERN.test(String(model || ''));
+}
+
+// OpenRouter model-specific capability helpers (pure model-id checks; callers
+// scope them with providerName === 'openrouter'). Nex N2.5 mini has no
+// function-compatible route: match the base id with any trailing variant
+// (colon variants like :free/:nitro, or hyphenated snapshots) so future
+// variants stay safe by default. Users can still Force on via toolsMode.
+export function isOpenRouterNexN25MiniModel(model) {
+ return /^nex-agi\/nex-n2\.5-mini(?:[:\-].*)?$/i.test(String(model || '').trim());
+}
+
+// Ling 3 Flash VL family: requires the -vl marker so text-only Ling
+// checkpoints never match. Accepts an optional org prefix and trailing variants.
+export function isOpenRouterLingVisionModel(model) {
+ return /(?:^|\/)ling-3[^/]*-vl(?:[:\-].*)?$/i.test(String(model || '').trim());
+}
const STRUCTURED_OUTPUT_PROVIDER_NAMES = new Set([
'azure-openai',
'llamacpp',
diff --git a/src/chrome/src/ui/locales/ar.js b/src/chrome/src/ui/locales/ar.js
index 117ca4aa2..f743440fd 100644
--- a/src/chrome/src/ui/locales/ar.js
+++ b/src/chrome/src/ui/locales/ar.js
@@ -399,6 +399,7 @@ export default {
'st.provider.field.model': 'النموذج',
'st.provider.field.model_optional': 'النموذج (اختياري)',
'st.provider.field.supports_vision': 'النموذج يدعم الرؤية (متعدّد الوسائط)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'تلقائي',
'st.provider.field.vision_force_on': 'فرض التشغيل',
'st.provider.field.vision_detected_vision': 'تم الاكتشاف تلقائيًا: يدعم الرؤية',
diff --git a/src/chrome/src/ui/locales/bn.js b/src/chrome/src/ui/locales/bn.js
index 49307b184..be1a39710 100644
--- a/src/chrome/src/ui/locales/bn.js
+++ b/src/chrome/src/ui/locales/bn.js
@@ -852,6 +852,7 @@ export default {
'st.provider.field.context_window': "প্রসঙ্গ উইন্ডো (টোকেন)",
'st.provider.field.max_output_tokens': "সর্বোচ্চ আউটপুট (টোকেন)",
'st.provider.field.supports_vision': "মডেল দৃষ্টি সমর্থন করে (মাল্টিমোডাল)",
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'স্বয়ংক্রিয়',
'st.provider.field.vision_force_on': 'জোর করে চালু',
'st.provider.field.vision_detected_vision': 'স্বয়ংক্রিয়ভাবে শনাক্ত: ভিশন',
diff --git a/src/chrome/src/ui/locales/de.js b/src/chrome/src/ui/locales/de.js
index 114a87678..d06fedae9 100644
--- a/src/chrome/src/ui/locales/de.js
+++ b/src/chrome/src/ui/locales/de.js
@@ -790,6 +790,7 @@ export default {
'st.provider.field.context_window': 'Kontextfenster (Tokens)',
'st.provider.field.max_output_tokens': 'Maximale Ausgabe (Tokens)',
'st.provider.field.supports_vision': 'Modell unterstützt Vision (multimodal)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'Automatisch',
'st.provider.field.vision_force_on': 'Erzwingen',
'st.provider.field.vision_detected_vision': 'Automatisch erkannt: Bildverarbeitung',
diff --git a/src/chrome/src/ui/locales/en.js b/src/chrome/src/ui/locales/en.js
index 0cd6cde90..5f076dcaf 100644
--- a/src/chrome/src/ui/locales/en.js
+++ b/src/chrome/src/ui/locales/en.js
@@ -853,6 +853,7 @@ export default {
'st.provider.field.context_window': 'Context window (tokens)',
'st.provider.field.max_output_tokens': 'Max output (tokens)',
'st.provider.field.supports_vision': 'Model supports vision (multimodal)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'Auto',
'st.provider.field.vision_force_on': 'Force on',
'st.provider.field.vision_detected_vision': 'Auto-detected: Vision',
diff --git a/src/chrome/src/ui/locales/es.js b/src/chrome/src/ui/locales/es.js
index 3c679b607..0add4c4db 100644
--- a/src/chrome/src/ui/locales/es.js
+++ b/src/chrome/src/ui/locales/es.js
@@ -399,6 +399,7 @@ export default {
'st.provider.field.model': 'Modelo',
'st.provider.field.model_optional': 'Modelo (opcional)',
'st.provider.field.supports_vision': 'El modelo admite visión (multimodal)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'Automático',
'st.provider.field.vision_force_on': 'Forzar activación',
'st.provider.field.vision_detected_vision': 'Detectado automáticamente: Visión',
diff --git a/src/chrome/src/ui/locales/fa.js b/src/chrome/src/ui/locales/fa.js
index f6c8fc523..c93b3713a 100644
--- a/src/chrome/src/ui/locales/fa.js
+++ b/src/chrome/src/ui/locales/fa.js
@@ -852,6 +852,7 @@ export default {
'st.provider.field.context_window': "پنجره زمینه (توکن ها)",
'st.provider.field.max_output_tokens': "حداکثر خروجی (توکن ها)",
'st.provider.field.supports_vision': "مدل از بینایی پشتیبانی می کند (چند وجهی)",
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'خودکار',
'st.provider.field.vision_force_on': 'اجباری روشن',
'st.provider.field.vision_detected_vision': 'شناسایی خودکار: بینایی',
diff --git a/src/chrome/src/ui/locales/fr.js b/src/chrome/src/ui/locales/fr.js
index 1e2132017..c151c20dd 100644
--- a/src/chrome/src/ui/locales/fr.js
+++ b/src/chrome/src/ui/locales/fr.js
@@ -399,6 +399,7 @@ export default {
'st.provider.field.model': 'Modèle',
'st.provider.field.model_optional': 'Modèle (facultatif)',
'st.provider.field.supports_vision': 'Le modèle gère la vision (multimodal)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'Automatique',
'st.provider.field.vision_force_on': 'Forcer l’activation',
'st.provider.field.vision_detected_vision': 'Détection automatique : vision',
diff --git a/src/chrome/src/ui/locales/he.js b/src/chrome/src/ui/locales/he.js
index 0a9423375..9ceab0782 100644
--- a/src/chrome/src/ui/locales/he.js
+++ b/src/chrome/src/ui/locales/he.js
@@ -775,6 +775,7 @@ export default {
"st.provider.field.context_window": "חלון הקשר (אסימונים)",
"st.provider.field.max_output_tokens": "פלט מקסימלי (אסימונים)",
"st.provider.field.supports_vision": "הדגם תומך בראייה (מולטימודאלי)",
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'אוטומטי',
'st.provider.field.vision_force_on': 'הפעלה מאולצת',
'st.provider.field.vision_detected_vision': 'זוהה אוטומטית: ראייה',
diff --git a/src/chrome/src/ui/locales/hi.js b/src/chrome/src/ui/locales/hi.js
index 7fad1bddc..7cc39a2c0 100644
--- a/src/chrome/src/ui/locales/hi.js
+++ b/src/chrome/src/ui/locales/hi.js
@@ -852,6 +852,7 @@ export default {
'st.provider.field.context_window': "संदर्भ विंडो (टोकन)",
'st.provider.field.max_output_tokens': "अधिकतम आउटपुट (टोकन)",
'st.provider.field.supports_vision': "मॉडल दृष्टि का समर्थन करता है (मल्टीमॉडल)",
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'स्वचालित',
'st.provider.field.vision_force_on': 'बलपूर्वक चालू',
'st.provider.field.vision_detected_vision': 'स्वतः पहचाना गया: विज़न',
diff --git a/src/chrome/src/ui/locales/id.js b/src/chrome/src/ui/locales/id.js
index 55dbb83b7..caf5ff9b4 100644
--- a/src/chrome/src/ui/locales/id.js
+++ b/src/chrome/src/ui/locales/id.js
@@ -399,6 +399,7 @@ export default {
'st.provider.field.model': 'Model',
'st.provider.field.model_optional': 'Model (opsional)',
'st.provider.field.supports_vision': 'Model mendukung visi (multimodal)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'Otomatis',
'st.provider.field.vision_force_on': 'Paksa aktif',
'st.provider.field.vision_detected_vision': 'Terdeteksi otomatis: Vision',
diff --git a/src/chrome/src/ui/locales/ja.js b/src/chrome/src/ui/locales/ja.js
index 038e5e6c6..986bdd4d0 100644
--- a/src/chrome/src/ui/locales/ja.js
+++ b/src/chrome/src/ui/locales/ja.js
@@ -399,6 +399,7 @@ export default {
'st.provider.field.model': 'モデル',
'st.provider.field.model_optional': 'モデル(任意)',
'st.provider.field.supports_vision': 'モデルは画像認識(マルチモーダル)対応',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': '自動',
'st.provider.field.vision_force_on': '強制的にオン',
'st.provider.field.vision_detected_vision': '自動検出:画像対応',
diff --git a/src/chrome/src/ui/locales/ko.js b/src/chrome/src/ui/locales/ko.js
index d3289196d..7600afd87 100644
--- a/src/chrome/src/ui/locales/ko.js
+++ b/src/chrome/src/ui/locales/ko.js
@@ -399,6 +399,7 @@ export default {
'st.provider.field.model': '모델',
'st.provider.field.model_optional': '모델 (선택)',
'st.provider.field.supports_vision': '모델이 비전(멀티모달)을 지원합니다',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': '자동',
'st.provider.field.vision_force_on': '강제로 켜기',
'st.provider.field.vision_detected_vision': '자동 감지: 비전',
diff --git a/src/chrome/src/ui/locales/ms.js b/src/chrome/src/ui/locales/ms.js
index d851a87e7..e34722927 100644
--- a/src/chrome/src/ui/locales/ms.js
+++ b/src/chrome/src/ui/locales/ms.js
@@ -399,6 +399,7 @@ export default {
'st.provider.field.model': 'Model',
'st.provider.field.model_optional': 'Model (pilihan)',
'st.provider.field.supports_vision': 'Model menyokong penglihatan (multimodal)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'Automatik',
'st.provider.field.vision_force_on': 'Paksa hidup',
'st.provider.field.vision_detected_vision': 'Dikesan secara automatik: Penglihatan',
diff --git a/src/chrome/src/ui/locales/nl.js b/src/chrome/src/ui/locales/nl.js
index 738b6ed84..9dc839f86 100644
--- a/src/chrome/src/ui/locales/nl.js
+++ b/src/chrome/src/ui/locales/nl.js
@@ -762,6 +762,7 @@ export default {
'st.provider.field.context_window': 'Contextvenster (tokens)',
'st.provider.field.max_output_tokens': 'Maximale uitvoer (tokens)',
'st.provider.field.supports_vision': 'Model ondersteunt visie (multimodaal)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'Automatisch',
'st.provider.field.vision_force_on': 'Geforceerd aan',
'st.provider.field.vision_detected_vision': 'Automatisch gedetecteerd: Visie',
diff --git a/src/chrome/src/ui/locales/pl.js b/src/chrome/src/ui/locales/pl.js
index c4e8835ee..61a674698 100644
--- a/src/chrome/src/ui/locales/pl.js
+++ b/src/chrome/src/ui/locales/pl.js
@@ -598,6 +598,7 @@ export default {
'st.provider.field.context_window': 'Okno kontekstu (tokeny)',
'st.provider.field.max_output_tokens': 'Maksymalne wyjście (tokeny)',
'st.provider.field.supports_vision': 'Model obsługuje wizję (multimodalność)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'Automatycznie',
'st.provider.field.vision_force_on': 'Wymuś włączenie',
'st.provider.field.vision_detected_vision': 'Wykryto automatycznie: Obsługa obrazu',
diff --git a/src/chrome/src/ui/locales/pt.js b/src/chrome/src/ui/locales/pt.js
index cbf1d9683..e66224264 100644
--- a/src/chrome/src/ui/locales/pt.js
+++ b/src/chrome/src/ui/locales/pt.js
@@ -852,6 +852,7 @@ export default {
'st.provider.field.context_window': "Janela de contexto (tokens)",
'st.provider.field.max_output_tokens': "Saída máxima (tokens)",
'st.provider.field.supports_vision': "Modelo apoia visão (multimodal)",
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'Automático',
'st.provider.field.vision_force_on': 'Forçar ativação',
'st.provider.field.vision_detected_vision': 'Detectado automaticamente: Visão',
diff --git a/src/chrome/src/ui/locales/ru.js b/src/chrome/src/ui/locales/ru.js
index ebbd8135c..b20953c1d 100644
--- a/src/chrome/src/ui/locales/ru.js
+++ b/src/chrome/src/ui/locales/ru.js
@@ -399,6 +399,7 @@ export default {
'st.provider.field.model': 'Модель',
'st.provider.field.model_optional': 'Модель (необязательно)',
'st.provider.field.supports_vision': 'Модель поддерживает зрение (мультимодальная)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'Автоматически',
'st.provider.field.vision_force_on': 'Принудительно включить',
'st.provider.field.vision_detected_vision': 'Определено автоматически: Поддержка изображений',
diff --git a/src/chrome/src/ui/locales/th.js b/src/chrome/src/ui/locales/th.js
index 42790001c..a9b65ebf4 100644
--- a/src/chrome/src/ui/locales/th.js
+++ b/src/chrome/src/ui/locales/th.js
@@ -399,6 +399,7 @@ export default {
'st.provider.field.model': 'โมเดล',
'st.provider.field.model_optional': 'โมเดล (ไม่บังคับ)',
'st.provider.field.supports_vision': 'โมเดลรองรับการมองเห็น (มัลติโมดัล)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'อัตโนมัติ',
'st.provider.field.vision_force_on': 'บังคับเปิด',
'st.provider.field.vision_detected_vision': 'ตรวจพบอัตโนมัติ: รองรับภาพ',
diff --git a/src/chrome/src/ui/locales/tl.js b/src/chrome/src/ui/locales/tl.js
index 7f9f5419b..8930cf645 100644
--- a/src/chrome/src/ui/locales/tl.js
+++ b/src/chrome/src/ui/locales/tl.js
@@ -399,6 +399,7 @@ export default {
'st.provider.field.model': 'Modelo',
'st.provider.field.model_optional': 'Modelo (opsyonal)',
'st.provider.field.supports_vision': 'Sumusuporta ang modelo sa bisyon (multimodal)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'Awtomatiko',
'st.provider.field.vision_force_on': 'Sapilitang i-on',
'st.provider.field.vision_detected_vision': 'Awtomatikong natukoy: Vision',
diff --git a/src/chrome/src/ui/locales/tr.js b/src/chrome/src/ui/locales/tr.js
index e82b2d8b5..2e0f8cfb6 100644
--- a/src/chrome/src/ui/locales/tr.js
+++ b/src/chrome/src/ui/locales/tr.js
@@ -439,6 +439,7 @@ export default {
'st.provider.field.model': 'Model',
'st.provider.field.model_optional': 'Model (isteğe bağlı)',
'st.provider.field.supports_vision': 'Model görme yeteneğini destekliyor (çok kipli)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'Otomatik',
'st.provider.field.vision_force_on': 'Zorla açık',
'st.provider.field.vision_detected_vision': 'Otomatik algılandı: Görsel',
diff --git a/src/chrome/src/ui/locales/uk.js b/src/chrome/src/ui/locales/uk.js
index de18ad4df..34787a965 100644
--- a/src/chrome/src/ui/locales/uk.js
+++ b/src/chrome/src/ui/locales/uk.js
@@ -399,6 +399,7 @@ export default {
'st.provider.field.model': 'Модель',
'st.provider.field.model_optional': 'Модель (необов\'язково)',
'st.provider.field.supports_vision': 'Модель підтримує зір (мультимодальна)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'Автоматично',
'st.provider.field.vision_force_on': 'Примусово ввімкнути',
'st.provider.field.vision_detected_vision': 'Визначено автоматично: Підтримка зображень',
diff --git a/src/chrome/src/ui/locales/vi.js b/src/chrome/src/ui/locales/vi.js
index 6066ab2c4..5e4cd8760 100644
--- a/src/chrome/src/ui/locales/vi.js
+++ b/src/chrome/src/ui/locales/vi.js
@@ -852,6 +852,7 @@ export default {
'st.provider.field.context_window': "Cửa sổ ngữ cảnh (mã thông báo)",
'st.provider.field.max_output_tokens': "Đầu ra tối đa (mã thông báo)",
'st.provider.field.supports_vision': "Mô hình hỗ trợ tầm nhìn (đa phương thức)",
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'Tự động',
'st.provider.field.vision_force_on': 'Buộc bật',
'st.provider.field.vision_detected_vision': 'Tự động phát hiện: Thị giác',
diff --git a/src/chrome/src/ui/locales/zh.js b/src/chrome/src/ui/locales/zh.js
index a73350166..f14d87095 100644
--- a/src/chrome/src/ui/locales/zh.js
+++ b/src/chrome/src/ui/locales/zh.js
@@ -399,6 +399,7 @@ export default {
'st.provider.field.model': '模型',
'st.provider.field.model_optional': '模型(可选)',
'st.provider.field.supports_vision': '模型支持视觉(多模态)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': '自动',
'st.provider.field.vision_force_on': '强制开启',
'st.provider.field.vision_detected_vision': '自动检测:支持视觉',
diff --git a/src/chrome/src/ui/settings.js b/src/chrome/src/ui/settings.js
index 27b9d1dfe..bbf9f214a 100644
--- a/src/chrome/src/ui/settings.js
+++ b/src/chrome/src/ui/settings.js
@@ -2388,6 +2388,18 @@ const VISION_MODE_FIELD = {
{ value: 'off', labelKey: 'st.providers.compat.value.off' },
],
};
+const TOOL_MODE_FIELD = {
+ key: 'toolsMode',
+ labelKey: 'st.provider.field.tools_mode',
+ type: 'select',
+ collapsed: true,
+ options: [
+ { value: 'auto', labelKey: 'st.provider.field.vision_auto' },
+ { value: 'on', labelKey: 'st.provider.field.vision_force_on' },
+ { value: 'off', labelKey: 'st.providers.compat.value.off' },
+ ],
+};
+const OPENROUTER_VISION_MODE_FIELD = { ...VISION_MODE_FIELD, collapsed: true };
const OLLAMA_VISION_MODE_FIELD = VISION_MODE_FIELD;
const OPTIONAL_LOCAL_API_KEY_FIELD = {
key: 'apiKey',
@@ -3284,6 +3296,8 @@ function renderProviders() {
suggestions: ['openrouter/free', 'anthropic/claude-opus-5.5', 'qwen/qwen3.8-27b', 'moonshotai/kimi-k3', 'z-ai/glm-5.3', 'minimax/minimax-m3'] },
{ key: 'baseUrl', labelKey: 'st.provider.field.api_base_url', type: 'text', placeholder: 'https://openrouter.ai/api/v1' },
PROMPT_TIER_FIELD,
+ TOOL_MODE_FIELD,
+ OPENROUTER_VISION_MODE_FIELD,
],
},
huggingface: {
diff --git a/src/chrome/src/ui/sidepanel.js b/src/chrome/src/ui/sidepanel.js
index e6b31c6e9..38de65ce8 100644
--- a/src/chrome/src/ui/sidepanel.js
+++ b/src/chrome/src/ui/sidepanel.js
@@ -72,6 +72,7 @@ import { providerIconUrl } from './provider-icons.js';
import { parseWatchSlashCommand, WATCH_COMMAND_USAGE } from './watch-command.js';
import { createSidePanelWindowScope } from './sidepanel-window-scope.js';
import { visionProviderKind } from '../providers/vision-capabilities.js';
+import { baseModelNameSniffedVision, isOpenRouterLingVisionModel } from '../providers/provider-compatibility.js';
import {
clearStagedScreenshots,
loadStagedScreenshots,
@@ -8158,6 +8159,25 @@ function toggledVisionProviderConfig(providerId, config) {
const { supportsVision: _legacy, ...withoutLegacy } = config;
return { enabled, config: { ...withoutLegacy, visionMode: enabled ? 'on' : 'off' } };
}
+ if (String(providerId || '').trim().toLowerCase() === 'openrouter'
+ || String(config?.providerName || '').trim().toLowerCase() === 'openrouter') {
+ // OpenRouter exposes the tri-state vision selector, so the toggle flips
+ // visionMode (not the legacy boolean). Effective state mirrors the
+ // provider: explicit visionMode, then legacy supportsVision, then
+ // automatic model detection.
+ const model = String(config?.model || '');
+ const visionEnabled = config.visionMode === 'on'
+ || (config.visionMode !== 'off' && (
+ config.supportsVision === true
+ || (config.supportsVision == null && (
+ isOpenRouterLingVisionModel(model)
+ || baseModelNameSniffedVision(model.toLowerCase())
+ ))
+ ));
+ const enabled = !visionEnabled;
+ const { supportsVision: _legacy, ...withoutLegacy } = config;
+ return { enabled, config: { ...withoutLegacy, visionMode: enabled ? 'on' : 'off' } };
+ }
const enabled = !config.supportsVision;
return { enabled, config: { ...config, supportsVision: enabled } };
}
diff --git a/src/firefox/src/providers/manager.js b/src/firefox/src/providers/manager.js
index f01e04629..b5e01b51c 100644
--- a/src/firefox/src/providers/manager.js
+++ b/src/firefox/src/providers/manager.js
@@ -252,6 +252,7 @@ const DUPLICATE_BLANK_CONFIG_KEYS = [
'outputCostPerMillionUsd',
'promptTier',
'routingVariant',
+ 'toolsMode',
'visionMode',
'visionDetection',
'supportsVision',
diff --git a/src/firefox/src/providers/openai.js b/src/firefox/src/providers/openai.js
index aa2f74952..77a563347 100644
--- a/src/firefox/src/providers/openai.js
+++ b/src/firefox/src/providers/openai.js
@@ -1,9 +1,12 @@
import { BaseLLMProvider } from './base.js';
import { fetchWithTimeout } from './fetch-timeout.js';
import {
+ baseModelNameSniffedVision,
isNewOpenAIContractConfig,
isOfficialOpenAIConfig,
isOpenCodeZenConfig,
+ isOpenRouterLingVisionModel,
+ isOpenRouterNexN25MiniModel,
requiresOpenAIDefaultTemperature,
shouldUseOpenAIResponsesApi,
supportsOpenAIAskStreaming,
@@ -107,6 +110,12 @@ export class OpenAICompatibleProvider extends BaseLLMProvider {
}
get supportsTools() {
+ const mode = this._capabilityMode('toolsMode');
+ if (mode === 'on') return true;
+ if (mode === 'off') return false;
+ // OpenRouter's Nex N2.5 mini route accepts chat completions but has no
+ // function-compatible endpoint. Sending even read-only tools returns 404.
+ if (this._isOpenRouterNexN25Mini()) return false;
return this.config.supportsTools !== false;
}
@@ -131,9 +140,18 @@ export class OpenAICompatibleProvider extends BaseLLMProvider {
if (AUTO_VISION_PROVIDER_IDS.has(providerName)) {
return configuredVisionSupport(providerName, this.config);
}
- // Explicit user opt-in always wins (used by LM Studio and any custom
- // OpenAI-compatible endpoint where the loaded model varies).
+ // The Advanced vision selector (auto/on/off) wins first. For OpenRouter
+ // the /vision slash command also writes visionMode (see sidepanel
+ // toggledVisionProviderConfig), so the toggle keeps working.
+ const mode = this._capabilityMode('visionMode');
+ if (mode === 'on') return true;
+ if (mode === 'off') return false;
+ // Legacy explicit opt-in/out (used by LM Studio, custom endpoints, and
+ // the /vision toggle for non-OpenRouter providers) wins over detection.
if (this.config.supportsVision != null) return !!this.config.supportsVision;
+ // OpenRouter-scoped detection for models the shared sniff cannot name
+ // (router route ids such as inclusionai/ling-3.0-flash-vl).
+ if (this._isOpenRouterLingVisionModel()) return true;
// Otherwise sniff the model name for known vision-capable identifiers.
// Qwen went natively multimodal starting at 3.5 (no separate -VL
// checkpoint needed), so qwen3\.[5-9] catches those alongside the
@@ -151,7 +169,22 @@ export class OpenAICompatibleProvider extends BaseLLMProvider {
* `supportsVision` getter above.
*/
_modelNameSniffedVision(model) {
- return /gpt-4o|gpt-4\.1|gpt-4-turbo|gpt-5|gpt-6-(?:luna-pro|sol|astra)(?:$|[-_.:/])|claude|gemini|grok|minimax-m3|kimi-k(?:-?3|2\.[5-9])|llava|qwen.*vl|qwen2.*vl|qwen3.*vl|qwen3\.[5-9]|qwen3p8-27b|pixtral|llama.*vision|gemma.*vision|gemma-?[34]|step-3/.test(String(model || ''));
+ return baseModelNameSniffedVision(model);
+ }
+
+ _isOpenRouterNexN25Mini() {
+ return String(this.config.providerName || '').trim().toLowerCase() === 'openrouter'
+ && isOpenRouterNexN25MiniModel(this.model);
+ }
+
+ _isOpenRouterLingVisionModel() {
+ return String(this.config.providerName || '').trim().toLowerCase() === 'openrouter'
+ && isOpenRouterLingVisionModel(this.model);
+ }
+
+ _capabilityMode(key) {
+ const mode = String(this.config[key] || '').trim().toLowerCase();
+ return ['auto', 'on', 'off'].includes(mode) ? mode : 'auto';
}
get useCompactPrompt() {
diff --git a/src/firefox/src/providers/provider-compatibility.js b/src/firefox/src/providers/provider-compatibility.js
index 63101f53c..cee1d9ab3 100644
--- a/src/firefox/src/providers/provider-compatibility.js
+++ b/src/firefox/src/providers/provider-compatibility.js
@@ -14,6 +14,29 @@ const MAX_TOKEN_FIELDS = new Set(['auto', 'max_tokens', 'max_completion_tokens']
const OPENROUTER_ROUTING_VARIANT_VALUES = new Set(['standard', 'nitro', 'exacto']);
const OPENROUTER_MODEL_VARIANT_SUFFIXES = /(?::(?:free|extended|thinking|online|nitro|floor|exacto))+$/i;
export const OPENROUTER_ROUTING_VARIANTS = Object.freeze(['standard', 'nitro', 'exacto']);
+
+// Shared base vision sniff (provider-agnostic). OpenAICompatibleProvider exposes
+// it via _modelNameSniffedVision so vendor subclasses (e.g. DeepSeek) can extend
+// it without duplicating the explicit-override precedence in supportsVision.
+const BASE_VISION_MODEL_PATTERN = /gpt-4o|gpt-4\.1|gpt-4-turbo|gpt-5|gpt-6-(?:luna-pro|sol|astra)(?:$|[-_.:/])|claude|gemini|grok|minimax-m3|kimi-k(?:-?3|2\.[5-9])|llava|qwen.*vl|qwen2.*vl|qwen3.*vl|qwen3\.[5-9]|qwen3p8-27b|pixtral|llama.*vision|gemma.*vision|gemma-?[34]|step-3/;
+export function baseModelNameSniffedVision(model) {
+ return BASE_VISION_MODEL_PATTERN.test(String(model || ''));
+}
+
+// OpenRouter model-specific capability helpers (pure model-id checks; callers
+// scope them with providerName === 'openrouter'). Nex N2.5 mini has no
+// function-compatible route: match the base id with any trailing variant
+// (colon variants like :free/:nitro, or hyphenated snapshots) so future
+// variants stay safe by default. Users can still Force on via toolsMode.
+export function isOpenRouterNexN25MiniModel(model) {
+ return /^nex-agi\/nex-n2\.5-mini(?:[:\-].*)?$/i.test(String(model || '').trim());
+}
+
+// Ling 3 Flash VL family: requires the -vl marker so text-only Ling
+// checkpoints never match. Accepts an optional org prefix and trailing variants.
+export function isOpenRouterLingVisionModel(model) {
+ return /(?:^|\/)ling-3[^/]*-vl(?:[:\-].*)?$/i.test(String(model || '').trim());
+}
const STRUCTURED_OUTPUT_PROVIDER_NAMES = new Set([
'azure-openai',
'llamacpp',
diff --git a/src/firefox/src/ui/locales/ar.js b/src/firefox/src/ui/locales/ar.js
index aea73eb67..6c68d1415 100644
--- a/src/firefox/src/ui/locales/ar.js
+++ b/src/firefox/src/ui/locales/ar.js
@@ -391,6 +391,7 @@ export default {
'st.provider.field.model': 'النموذج',
'st.provider.field.model_optional': 'النموذج (اختياري)',
'st.provider.field.supports_vision': 'النموذج يدعم الرؤية (متعدّد الوسائط)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'تلقائي',
'st.provider.field.vision_force_on': 'فرض التشغيل',
'st.provider.field.vision_detected_vision': 'تم الاكتشاف تلقائيًا: يدعم الرؤية',
diff --git a/src/firefox/src/ui/locales/bn.js b/src/firefox/src/ui/locales/bn.js
index 0097313d8..09f8adea4 100644
--- a/src/firefox/src/ui/locales/bn.js
+++ b/src/firefox/src/ui/locales/bn.js
@@ -838,6 +838,7 @@ export default {
'st.provider.field.context_window': "প্রসঙ্গ উইন্ডো (টোকেন)",
'st.provider.field.max_output_tokens': "সর্বোচ্চ আউটপুট (টোকেন)",
'st.provider.field.supports_vision': "মডেল দৃষ্টি সমর্থন করে (মাল্টিমোডাল)",
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'স্বয়ংক্রিয়',
'st.provider.field.vision_force_on': 'জোর করে চালু',
'st.provider.field.vision_detected_vision': 'স্বয়ংক্রিয়ভাবে শনাক্ত: ভিশন',
diff --git a/src/firefox/src/ui/locales/de.js b/src/firefox/src/ui/locales/de.js
index ce9fbfdd8..adaad7c7e 100644
--- a/src/firefox/src/ui/locales/de.js
+++ b/src/firefox/src/ui/locales/de.js
@@ -776,6 +776,7 @@ export default {
'st.provider.field.context_window': 'Kontextfenster (Tokens)',
'st.provider.field.max_output_tokens': 'Maximale Ausgabe (Tokens)',
'st.provider.field.supports_vision': 'Modell unterstützt Vision (multimodal)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'Automatisch',
'st.provider.field.vision_force_on': 'Erzwingen',
'st.provider.field.vision_detected_vision': 'Automatisch erkannt: Bildverarbeitung',
diff --git a/src/firefox/src/ui/locales/en.js b/src/firefox/src/ui/locales/en.js
index 9b02ea98b..db37ff396 100644
--- a/src/firefox/src/ui/locales/en.js
+++ b/src/firefox/src/ui/locales/en.js
@@ -839,6 +839,7 @@ export default {
'st.provider.field.context_window': 'Context window (tokens)',
'st.provider.field.max_output_tokens': 'Max output (tokens)',
'st.provider.field.supports_vision': 'Model supports vision (multimodal)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'Auto',
'st.provider.field.vision_force_on': 'Force on',
'st.provider.field.vision_detected_vision': 'Auto-detected: Vision',
diff --git a/src/firefox/src/ui/locales/es.js b/src/firefox/src/ui/locales/es.js
index b61e20541..f844ab85a 100644
--- a/src/firefox/src/ui/locales/es.js
+++ b/src/firefox/src/ui/locales/es.js
@@ -391,6 +391,7 @@ export default {
'st.provider.field.model': 'Modelo',
'st.provider.field.model_optional': 'Modelo (opcional)',
'st.provider.field.supports_vision': 'El modelo admite visión (multimodal)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'Automático',
'st.provider.field.vision_force_on': 'Forzar activación',
'st.provider.field.vision_detected_vision': 'Detectado automáticamente: Visión',
diff --git a/src/firefox/src/ui/locales/fa.js b/src/firefox/src/ui/locales/fa.js
index 898d20c4c..f87a63510 100644
--- a/src/firefox/src/ui/locales/fa.js
+++ b/src/firefox/src/ui/locales/fa.js
@@ -838,6 +838,7 @@ export default {
'st.provider.field.context_window': "پنجره زمینه (توکن ها)",
'st.provider.field.max_output_tokens': "حداکثر خروجی (توکن ها)",
'st.provider.field.supports_vision': "مدل از بینایی پشتیبانی می کند (چند وجهی)",
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'خودکار',
'st.provider.field.vision_force_on': 'اجباری روشن',
'st.provider.field.vision_detected_vision': 'شناسایی خودکار: بینایی',
diff --git a/src/firefox/src/ui/locales/fr.js b/src/firefox/src/ui/locales/fr.js
index 235b0c6d4..fc574d103 100644
--- a/src/firefox/src/ui/locales/fr.js
+++ b/src/firefox/src/ui/locales/fr.js
@@ -391,6 +391,7 @@ export default {
'st.provider.field.model': 'Modèle',
'st.provider.field.model_optional': 'Modèle (facultatif)',
'st.provider.field.supports_vision': 'Le modèle gère la vision (multimodal)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'Automatique',
'st.provider.field.vision_force_on': 'Forcer l’activation',
'st.provider.field.vision_detected_vision': 'Détection automatique : vision',
diff --git a/src/firefox/src/ui/locales/he.js b/src/firefox/src/ui/locales/he.js
index 917a93703..fdca206e4 100644
--- a/src/firefox/src/ui/locales/he.js
+++ b/src/firefox/src/ui/locales/he.js
@@ -754,6 +754,7 @@ export default {
"st.provider.field.context_window": "חלון הקשר (אסימונים)",
"st.provider.field.max_output_tokens": "פלט מקסימלי (אסימונים)",
"st.provider.field.supports_vision": "הדגם תומך בראייה (מולטימודאלי)",
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'אוטומטי',
'st.provider.field.vision_force_on': 'הפעלה מאולצת',
'st.provider.field.vision_detected_vision': 'זוהה אוטומטית: ראייה',
diff --git a/src/firefox/src/ui/locales/hi.js b/src/firefox/src/ui/locales/hi.js
index bf122b9ee..b81342794 100644
--- a/src/firefox/src/ui/locales/hi.js
+++ b/src/firefox/src/ui/locales/hi.js
@@ -838,6 +838,7 @@ export default {
'st.provider.field.context_window': "संदर्भ विंडो (टोकन)",
'st.provider.field.max_output_tokens': "अधिकतम आउटपुट (टोकन)",
'st.provider.field.supports_vision': "मॉडल दृष्टि का समर्थन करता है (मल्टीमॉडल)",
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'स्वचालित',
'st.provider.field.vision_force_on': 'बलपूर्वक चालू',
'st.provider.field.vision_detected_vision': 'स्वतः पहचाना गया: विज़न',
diff --git a/src/firefox/src/ui/locales/id.js b/src/firefox/src/ui/locales/id.js
index ba69f516e..898e78644 100644
--- a/src/firefox/src/ui/locales/id.js
+++ b/src/firefox/src/ui/locales/id.js
@@ -391,6 +391,7 @@ export default {
'st.provider.field.model': 'Model',
'st.provider.field.model_optional': 'Model (opsional)',
'st.provider.field.supports_vision': 'Model mendukung visi (multimodal)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'Otomatis',
'st.provider.field.vision_force_on': 'Paksa aktif',
'st.provider.field.vision_detected_vision': 'Terdeteksi otomatis: Vision',
diff --git a/src/firefox/src/ui/locales/ja.js b/src/firefox/src/ui/locales/ja.js
index d72b987c5..3e01b1ab9 100644
--- a/src/firefox/src/ui/locales/ja.js
+++ b/src/firefox/src/ui/locales/ja.js
@@ -391,6 +391,7 @@ export default {
'st.provider.field.model': 'モデル',
'st.provider.field.model_optional': 'モデル(任意)',
'st.provider.field.supports_vision': 'モデルは画像認識(マルチモーダル)対応',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': '自動',
'st.provider.field.vision_force_on': '強制的にオン',
'st.provider.field.vision_detected_vision': '自動検出:画像対応',
diff --git a/src/firefox/src/ui/locales/ko.js b/src/firefox/src/ui/locales/ko.js
index a538fee31..cd3897697 100644
--- a/src/firefox/src/ui/locales/ko.js
+++ b/src/firefox/src/ui/locales/ko.js
@@ -391,6 +391,7 @@ export default {
'st.provider.field.model': '모델',
'st.provider.field.model_optional': '모델 (선택)',
'st.provider.field.supports_vision': '모델이 비전(멀티모달)을 지원합니다',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': '자동',
'st.provider.field.vision_force_on': '강제로 켜기',
'st.provider.field.vision_detected_vision': '자동 감지: 비전',
diff --git a/src/firefox/src/ui/locales/ms.js b/src/firefox/src/ui/locales/ms.js
index 5f253fbf9..a0750ffcd 100644
--- a/src/firefox/src/ui/locales/ms.js
+++ b/src/firefox/src/ui/locales/ms.js
@@ -391,6 +391,7 @@ export default {
'st.provider.field.model': 'Model',
'st.provider.field.model_optional': 'Model (pilihan)',
'st.provider.field.supports_vision': 'Model menyokong penglihatan (multimodal)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'Automatik',
'st.provider.field.vision_force_on': 'Paksa hidup',
'st.provider.field.vision_detected_vision': 'Dikesan secara automatik: Penglihatan',
diff --git a/src/firefox/src/ui/locales/nl.js b/src/firefox/src/ui/locales/nl.js
index 36c23fe1b..98ab8dd2e 100644
--- a/src/firefox/src/ui/locales/nl.js
+++ b/src/firefox/src/ui/locales/nl.js
@@ -748,6 +748,7 @@ export default {
'st.provider.field.context_window': 'Contextvenster (tokens)',
'st.provider.field.max_output_tokens': 'Maximale uitvoer (tokens)',
'st.provider.field.supports_vision': 'Model ondersteunt visie (multimodaal)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'Automatisch',
'st.provider.field.vision_force_on': 'Geforceerd aan',
'st.provider.field.vision_detected_vision': 'Automatisch gedetecteerd: Visie',
diff --git a/src/firefox/src/ui/locales/pl.js b/src/firefox/src/ui/locales/pl.js
index c3a32dd60..ed67c2286 100644
--- a/src/firefox/src/ui/locales/pl.js
+++ b/src/firefox/src/ui/locales/pl.js
@@ -589,6 +589,7 @@ export default {
'st.provider.field.context_window': 'Okno kontekstu (tokeny)',
'st.provider.field.max_output_tokens': 'Maksymalne wyjście (tokeny)',
'st.provider.field.supports_vision': 'Model obsługuje wizję (multimodalność)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'Automatycznie',
'st.provider.field.vision_force_on': 'Wymuś włączenie',
'st.provider.field.vision_detected_vision': 'Wykryto automatycznie: Obsługa obrazu',
diff --git a/src/firefox/src/ui/locales/pt.js b/src/firefox/src/ui/locales/pt.js
index fbf6421f7..11600c8be 100644
--- a/src/firefox/src/ui/locales/pt.js
+++ b/src/firefox/src/ui/locales/pt.js
@@ -838,6 +838,7 @@ export default {
'st.provider.field.context_window': "Janela de contexto (tokens)",
'st.provider.field.max_output_tokens': "Saída máxima (tokens)",
'st.provider.field.supports_vision': "Modelo apoia visão (multimodal)",
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'Automático',
'st.provider.field.vision_force_on': 'Forçar ativação',
'st.provider.field.vision_detected_vision': 'Detectado automaticamente: Visão',
diff --git a/src/firefox/src/ui/locales/ru.js b/src/firefox/src/ui/locales/ru.js
index 9e00c0914..dc20659be 100644
--- a/src/firefox/src/ui/locales/ru.js
+++ b/src/firefox/src/ui/locales/ru.js
@@ -391,6 +391,7 @@ export default {
'st.provider.field.model': 'Модель',
'st.provider.field.model_optional': 'Модель (необязательно)',
'st.provider.field.supports_vision': 'Модель поддерживает зрение (мультимодальная)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'Автоматически',
'st.provider.field.vision_force_on': 'Принудительно включить',
'st.provider.field.vision_detected_vision': 'Определено автоматически: Поддержка изображений',
diff --git a/src/firefox/src/ui/locales/th.js b/src/firefox/src/ui/locales/th.js
index 16ff5db0c..ffcbfced4 100644
--- a/src/firefox/src/ui/locales/th.js
+++ b/src/firefox/src/ui/locales/th.js
@@ -391,6 +391,7 @@ export default {
'st.provider.field.model': 'โมเดล',
'st.provider.field.model_optional': 'โมเดล (ไม่บังคับ)',
'st.provider.field.supports_vision': 'โมเดลรองรับการมองเห็น (มัลติโมดัล)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'อัตโนมัติ',
'st.provider.field.vision_force_on': 'บังคับเปิด',
'st.provider.field.vision_detected_vision': 'ตรวจพบอัตโนมัติ: รองรับภาพ',
diff --git a/src/firefox/src/ui/locales/tl.js b/src/firefox/src/ui/locales/tl.js
index df2f34e4e..3f41f4d9e 100644
--- a/src/firefox/src/ui/locales/tl.js
+++ b/src/firefox/src/ui/locales/tl.js
@@ -391,6 +391,7 @@ export default {
'st.provider.field.model': 'Modelo',
'st.provider.field.model_optional': 'Modelo (opsyonal)',
'st.provider.field.supports_vision': 'Sumusuporta ang modelo sa bisyon (multimodal)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'Awtomatiko',
'st.provider.field.vision_force_on': 'Sapilitang i-on',
'st.provider.field.vision_detected_vision': 'Awtomatikong natukoy: Vision',
diff --git a/src/firefox/src/ui/locales/tr.js b/src/firefox/src/ui/locales/tr.js
index 45b043327..96ccfa89b 100644
--- a/src/firefox/src/ui/locales/tr.js
+++ b/src/firefox/src/ui/locales/tr.js
@@ -431,6 +431,7 @@ export default {
'st.provider.field.model': 'Model',
'st.provider.field.model_optional': 'Model (isteğe bağlı)',
'st.provider.field.supports_vision': 'Model görme yeteneğini destekliyor (çok kipli)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'Otomatik',
'st.provider.field.vision_force_on': 'Zorla açık',
'st.provider.field.vision_detected_vision': 'Otomatik algılandı: Görsel',
diff --git a/src/firefox/src/ui/locales/uk.js b/src/firefox/src/ui/locales/uk.js
index 7ecc40a3a..5df8d251a 100644
--- a/src/firefox/src/ui/locales/uk.js
+++ b/src/firefox/src/ui/locales/uk.js
@@ -391,6 +391,7 @@ export default {
'st.provider.field.model': 'Модель',
'st.provider.field.model_optional': 'Модель (необов\'язково)',
'st.provider.field.supports_vision': 'Модель підтримує зір (мультимодальна)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'Автоматично',
'st.provider.field.vision_force_on': 'Примусово ввімкнути',
'st.provider.field.vision_detected_vision': 'Визначено автоматично: Підтримка зображень',
diff --git a/src/firefox/src/ui/locales/vi.js b/src/firefox/src/ui/locales/vi.js
index d1b97ed26..339bc05a0 100644
--- a/src/firefox/src/ui/locales/vi.js
+++ b/src/firefox/src/ui/locales/vi.js
@@ -838,6 +838,7 @@ export default {
'st.provider.field.context_window': "Cửa sổ ngữ cảnh (mã thông báo)",
'st.provider.field.max_output_tokens': "Đầu ra tối đa (mã thông báo)",
'st.provider.field.supports_vision': "Mô hình hỗ trợ tầm nhìn (đa phương thức)",
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': 'Tự động',
'st.provider.field.vision_force_on': 'Buộc bật',
'st.provider.field.vision_detected_vision': 'Tự động phát hiện: Thị giác',
diff --git a/src/firefox/src/ui/locales/zh.js b/src/firefox/src/ui/locales/zh.js
index 84772ac52..305753760 100644
--- a/src/firefox/src/ui/locales/zh.js
+++ b/src/firefox/src/ui/locales/zh.js
@@ -391,6 +391,7 @@ export default {
'st.provider.field.model': '模型',
'st.provider.field.model_optional': '模型(可选)',
'st.provider.field.supports_vision': '模型支持视觉(多模态)',
+ 'st.provider.field.tools_mode': 'Native tool use',
'st.provider.field.vision_auto': '自动',
'st.provider.field.vision_force_on': '强制开启',
'st.provider.field.vision_detected_vision': '自动检测:支持视觉',
diff --git a/src/firefox/src/ui/settings.js b/src/firefox/src/ui/settings.js
index 275c847c9..539530ebc 100644
--- a/src/firefox/src/ui/settings.js
+++ b/src/firefox/src/ui/settings.js
@@ -1986,6 +1986,18 @@ const VISION_MODE_FIELD = {
{ value: 'off', labelKey: 'st.providers.compat.value.off' },
],
};
+const TOOL_MODE_FIELD = {
+ key: 'toolsMode',
+ labelKey: 'st.provider.field.tools_mode',
+ type: 'select',
+ collapsed: true,
+ options: [
+ { value: 'auto', labelKey: 'st.provider.field.vision_auto' },
+ { value: 'on', labelKey: 'st.provider.field.vision_force_on' },
+ { value: 'off', labelKey: 'st.providers.compat.value.off' },
+ ],
+};
+const OPENROUTER_VISION_MODE_FIELD = { ...VISION_MODE_FIELD, collapsed: true };
const OLLAMA_VISION_MODE_FIELD = VISION_MODE_FIELD;
const OPTIONAL_LOCAL_API_KEY_FIELD = {
key: 'apiKey',
@@ -2669,6 +2681,8 @@ function renderProviders() {
suggestions: ['openrouter/free', 'anthropic/claude-opus-5.5', 'qwen/qwen3.8-27b', 'moonshotai/kimi-k3', 'z-ai/glm-5.3', 'minimax/minimax-m3'] },
{ key: 'baseUrl', labelKey: 'st.provider.field.api_base_url', type: 'text', placeholder: 'https://openrouter.ai/api/v1' },
PROMPT_TIER_FIELD,
+ TOOL_MODE_FIELD,
+ OPENROUTER_VISION_MODE_FIELD,
],
},
huggingface: {
diff --git a/src/firefox/src/ui/sidepanel.js b/src/firefox/src/ui/sidepanel.js
index c95312d53..a6285009c 100644
--- a/src/firefox/src/ui/sidepanel.js
+++ b/src/firefox/src/ui/sidepanel.js
@@ -73,6 +73,7 @@ import { providerIconUrl } from './provider-icons.js';
import { parseWatchSlashCommand, WATCH_COMMAND_USAGE } from './watch-command.js';
import { createSidePanelWindowScope } from './sidepanel-window-scope.js';
import { visionProviderKind } from '../providers/vision-capabilities.js';
+import { baseModelNameSniffedVision, isOpenRouterLingVisionModel } from '../providers/provider-compatibility.js';
import {
SHORTCUT_COMMAND_STORAGE_KEY,
shortcutCommandForWindow,
@@ -7942,6 +7943,25 @@ function toggledVisionProviderConfig(providerId, config) {
const { supportsVision: _legacy, ...withoutLegacy } = config;
return { enabled, config: { ...withoutLegacy, visionMode: enabled ? 'on' : 'off' } };
}
+ if (String(providerId || '').trim().toLowerCase() === 'openrouter'
+ || String(config?.providerName || '').trim().toLowerCase() === 'openrouter') {
+ // OpenRouter exposes the tri-state vision selector, so the toggle flips
+ // visionMode (not the legacy boolean). Effective state mirrors the
+ // provider: explicit visionMode, then legacy supportsVision, then
+ // automatic model detection.
+ const model = String(config?.model || '');
+ const visionEnabled = config.visionMode === 'on'
+ || (config.visionMode !== 'off' && (
+ config.supportsVision === true
+ || (config.supportsVision == null && (
+ isOpenRouterLingVisionModel(model)
+ || baseModelNameSniffedVision(model.toLowerCase())
+ ))
+ ));
+ const enabled = !visionEnabled;
+ const { supportsVision: _legacy, ...withoutLegacy } = config;
+ return { enabled, config: { ...withoutLegacy, visionMode: enabled ? 'on' : 'off' } };
+ }
const enabled = !config.supportsVision;
return { enabled, config: { ...config, supportsVision: enabled } };
}
diff --git a/test/openrouter-model-capabilities.mjs b/test/openrouter-model-capabilities.mjs
new file mode 100644
index 000000000..c806dc356
--- /dev/null
+++ b/test/openrouter-model-capabilities.mjs
@@ -0,0 +1,98 @@
+import assert from 'node:assert/strict';
+import { test } from 'node:test';
+
+for (const browser of ['chrome', 'firefox']) {
+ const { OpenAICompatibleProvider } = await import(
+ new URL(`../src/${browser}/src/providers/openai.js`, import.meta.url)
+ );
+ const compat = await import(
+ new URL(`../src/${browser}/src/providers/provider-compatibility.js`, import.meta.url)
+ );
+
+ test(`${browser}: OpenRouter Ling 3 Flash VL supports vision`, () => {
+ const provider = new OpenAICompatibleProvider({
+ providerName: 'openrouter',
+ model: 'inclusionai/ling-3.0-flash-vl',
+ });
+
+ assert.equal(provider.supportsVision, true);
+ });
+
+ test(`${browser}: OpenRouter Ling vision covers variants but not text-only checkpoints`, () => {
+ assert.equal(compat.isOpenRouterLingVisionModel('inclusionai/ling-3.0-flash-vl:free'), true);
+ assert.equal(compat.isOpenRouterLingVisionModel('ling-3.0-flash-vl'), true);
+ assert.equal(compat.isOpenRouterLingVisionModel('inclusionai/ling-3.0-flash'), false);
+ assert.equal(compat.isOpenRouterLingVisionModel('inclusionai/ling-2.6-1t'), false);
+
+ const textOnly = new OpenAICompatibleProvider({
+ providerName: 'openrouter',
+ model: 'inclusionai/ling-3.0-flash',
+ });
+ assert.equal(textOnly.supportsVision, false);
+ });
+
+ test(`${browser}: OpenRouter Nex N2.5 mini reports native tools as unsupported`, () => {
+ const provider = new OpenAICompatibleProvider({
+ providerName: 'openrouter',
+ model: 'nex-agi/nex-n2.5-mini:free',
+ });
+
+ assert.equal(provider.supportsTools, false);
+ });
+
+ test(`${browser}: OpenRouter Nex mini detection covers routing and snapshot suffixes`, () => {
+ assert.equal(compat.isOpenRouterNexN25MiniModel('nex-agi/nex-n2.5-mini'), true);
+ assert.equal(compat.isOpenRouterNexN25MiniModel('nex-agi/nex-n2.5-mini:nitro'), true);
+ assert.equal(compat.isOpenRouterNexN25MiniModel('nex-agi/nex-n2.5-mini-20260908'), true);
+ assert.equal(compat.isOpenRouterNexN25MiniModel('nex-agi/nex-n2.5-pro'), false);
+
+ const snapshot = new OpenAICompatibleProvider({
+ providerName: 'openrouter',
+ model: 'nex-agi/nex-n2.5-mini-20260908',
+ });
+ assert.equal(snapshot.supportsTools, false);
+ });
+
+ test(`${browser}: OpenRouter capability overrides take precedence over model defaults`, () => {
+ const toolsForcedOn = new OpenAICompatibleProvider({
+ providerName: 'openrouter',
+ model: 'nex-agi/nex-n2.5-mini',
+ toolsMode: 'on',
+ });
+ const toolsForcedOff = new OpenAICompatibleProvider({
+ providerName: 'openrouter',
+ model: 'nex-agi/nex-n2.5-pro',
+ toolsMode: 'off',
+ });
+ const visionForcedOff = new OpenAICompatibleProvider({
+ providerName: 'openrouter',
+ model: 'inclusionai/ling-3.0-flash-vl',
+ visionMode: 'off',
+ });
+ const visionForcedOn = new OpenAICompatibleProvider({
+ providerName: 'openrouter',
+ model: 'nex-agi/nex-n2.5-mini',
+ visionMode: 'on',
+ });
+ const legacyVisionOff = new OpenAICompatibleProvider({
+ providerName: 'openrouter',
+ model: 'inclusionai/ling-3.0-flash-vl',
+ supportsVision: false,
+ });
+
+ assert.equal(toolsForcedOn.supportsTools, true);
+ assert.equal(toolsForcedOff.supportsTools, false);
+ assert.equal(visionForcedOff.supportsVision, false);
+ assert.equal(visionForcedOn.supportsVision, true);
+ assert.equal(legacyVisionOff.supportsVision, false);
+ });
+
+ test(`${browser}: other OpenRouter Nex models retain native tools`, () => {
+ const provider = new OpenAICompatibleProvider({
+ providerName: 'openrouter',
+ model: 'nex-agi/nex-n2.5-pro',
+ });
+
+ assert.equal(provider.supportsTools, true);
+ });
+}