Skip to content

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

Simplify Companion provider card with Details section and auto-selection

Codex release-state testf7bf37885ae3
diff --git a/src/chrome/src/providers/companion-config.js b/src/chrome/src/providers/companion-config.js
new file mode 100644
index 000000000..2559282f9
--- /dev/null
+++ b/src/chrome/src/providers/companion-config.js
@@ -0,0 +1,31 @@
+/**
+ * WebBrain Companion configuration and model selection rules.
+ *
+ * Companion connects WebBrain to a local subscription proxy running on
+ * loopback port 8327.
+ */
+
+export const WEBBRAIN_COMPANION_DEFAULT_BASE_URL = 'http://127.0.0.1:8327/v1';
+
+// Preferred models in priority order:
+// 1. haiku-5.5 (Claude Haiku 5.5)
+// 2. luna-6.1 (GPT-6.1 Luna)
+// 3. gemini-3.8-flash (Gemini 3.8 Flash)
+export const COMPANION_PREFERRED_MODEL_PATTERNS = [
+ /haiku[-_.]?5[.\-_]?5/i,
+ /luna[-_.]?6[.\-_]?1|gpt[-_.]?6[.\-_]?1.*luna/i,
+ /gemini[-_.]?3[.\-_]?8[-_.]?flash/i,
+];
+
+/**
+ * Automatically select the most preferred model from a list of Companion models.
+ * If none of the preferred patterns match, falls back to the first available model.
+ */
+export function selectPreferredCompanionModel(models = []) {
+ if (!Array.isArray(models) || models.length === 0) return '';
+ for (const pattern of COMPANION_PREFERRED_MODEL_PATTERNS) {
+ const matched = models.find((m) => typeof m === 'string' && pattern.test(m));
+ if (matched) return matched;
+ }
+ return typeof models[0] === 'string' ? models[0] : '';
+}
diff --git a/src/chrome/src/providers/manager.js b/src/chrome/src/providers/manager.js
index f01f6418b..4eee001fa 100644
--- a/src/chrome/src/providers/manager.js
+++ b/src/chrome/src/providers/manager.js
@@ -364,6 +364,13 @@ export class ProviderManager {
|| (!String(config.model || '').trim() && config.visionDetection != null)
);
});
+ const companionVisionConfigMigrated = Object.entries(data.providers || {}).some(([id, config]) => {
+ const defId = config?.duplicateOf || id;
+ return defId === 'webbrain_companion' && (
+ !VISION_MODES.has(config.visionMode)
+ || Object.hasOwn(config, 'supportsVision')
+ );
+ });
const hadLegacyClaudeSubscription = Object.hasOwn(data.providers || {}, 'claude_subscription');
const rawStoredProviders = data.providers || {};
const stored = this._migrateStoredProviderConfigs(rawStoredProviders);
@@ -419,6 +426,14 @@ export class ProviderManager {
}
}
for (const [id, config] of Object.entries(configs)) {
+ if ((config?.duplicateOf || id) === 'webbrain_companion') {
+ if (!VISION_MODES.has(config.visionMode)) {
+ config.visionMode = typeof config.supportsVision === 'boolean'
+ ? (config.supportsVision ? 'on' : 'off')
+ : 'auto';
+ }
+ delete config.supportsVision;
+ }
if (config.duplicateOf && !this._isValidDuplicateConfig(id, config, configs)) {
delete configs[id];
providerStateMigrated = true;
@@ -432,6 +447,7 @@ export class ProviderManager {
// token bundle here — otherwise a previously-signed-in user's raw
// access/refresh tokens would sit in storage with no UI path to clear them.
if (hadLegacyClaudeSubscription) await signOutClaude();
+ if (companionVisionConfigMigrated) providerStateMigrated = true;
const deviceGuid = await this._getDeviceGuid(data[WEBBRAIN_DEVICE_GUID_KEY]);
for (const id of WEBBRAIN_CLOUD_PROVIDER_IDS) {
if (!configs[id]) continue;
@@ -706,7 +722,7 @@ export class ProviderManager {
contextWindow: LOCAL_OPENAI_PROXY_CONTEXT_WINDOW,
apiKey: '',
supportsAskStreaming: true,
- supportsVision: false,
+ visionMode: 'auto',
enabled: true,
},
local_openai_proxy: {
@@ -1403,6 +1419,14 @@ export class ProviderManager {
: 'auto';
delete normalizedConfig.supportsVision;
}
+ if (definitionId === 'webbrain_companion') {
+ normalizedConfig.visionMode = VISION_MODES.has(normalizedConfig.visionMode)
+ ? normalizedConfig.visionMode
+ : (typeof normalizedConfig.supportsVision === 'boolean'
+ ? (normalizedConfig.supportsVision ? 'on' : 'off')
+ : 'auto');
+ delete normalizedConfig.supportsVision;
+ }
if (visionProviderKind(definitionId, normalizedConfig)) {
const legacySupportsVision = normalizedConfig.supportsVision;
normalizedConfig.visionMode = VISION_MODES.has(normalizedConfig.visionMode)
@@ -2233,6 +2257,15 @@ export class ProviderManager {
merged.visionDetection = null;
}
}
+ if (this._providerDefinitionId(id, current) === 'webbrain_companion') {
+ const explicitLegacyVision = Object.hasOwn(config, 'supportsVision') && !Object.hasOwn(config, 'visionMode')
+ ? config.supportsVision
+ : null;
+ merged.visionMode = typeof explicitLegacyVision === 'boolean'
+ ? (explicitLegacyVision ? 'on' : 'off')
+ : (VISION_MODES.has(merged.visionMode) ? merged.visionMode : 'auto');
+ delete merged.supportsVision;
+ }
const definitionId = this._providerDefinitionId(id, merged);
const genericVisionKind = visionProviderKind(definitionId, merged);
if (genericVisionKind) {
diff --git a/src/chrome/src/ui/locales/provider-guide-copy.mjs b/src/chrome/src/ui/locales/provider-guide-copy.mjs
index cb8b17475..2c28ad3f1 100644
--- a/src/chrome/src/ui/locales/provider-guide-copy.mjs
+++ b/src/chrome/src/ui/locales/provider-guide-copy.mjs
@@ -4,6 +4,7 @@ export const providerGuideEnglish = Object.freeze({
'st.providers.companion_guide.supported': 'Supports Claude (Pro, Max or Team), ChatGPT (Plus or Pro via Codex), Google Gemini (via Antigravity), SuperGrok (via Grok Build), Kimi Code (kimi.ai or kimi.com), Meta Muse (Muse Code), and Devin.',
'st.providers.companion_guide.body': 'Get WebBrain Companion, start it, then load a model. No API key is needed on this computer.',
'st.providers.companion_guide.download': 'Download WebBrain Companion',
+ 'st.providers.companion_guide.details': 'Details',
'st.providers.subscription_guide.card_body': 'Have a {product} account or subscription instead of an API key?',
'st.providers.subscription_guide.card_link': 'See third-party proxy setup & risks',
'st.providers.subscription_guide.local_body': 'Using EasyCLIProxyAPI or CLIProxyAPI?',
@@ -17,6 +18,32 @@ const companionGuideTranslations = {
zh: ['安装并启动 WebBrain Companion,然后加载模型。本机无需 API 密钥。', '下载 WebBrain Companion'],
};
+const companionDetailsTranslations = {
+ ar: 'التفاصيل',
+ bn: 'বিস্তারিত',
+ de: 'Details',
+ en: 'Details',
+ es: 'Detalles',
+ fa: 'جزئیات',
+ fr: 'Détails',
+ he: 'פרטים',
+ hi: 'विवरण',
+ id: 'Detail',
+ ja: '詳細',
+ ko: '세부 정보',
+ ms: 'Butiran',
+ nl: 'Details',
+ pl: 'Szczegóły',
+ pt: 'Detalhes',
+ ru: 'Подробности',
+ th: 'รายละเอียด',
+ tl: 'Mga Detalye',
+ tr: 'Ayrıntılar',
+ uk: 'Подробиці',
+ vi: 'Chi tiết',
+ zh: '详情',
+};
+
export const providerGuideTranslations = Object.freeze(Object.fromEntries(Object.entries({
es: {
'st.providers.companion_guide.title': 'Tu suscripción actual',
@@ -181,7 +208,10 @@ export const providerGuideTranslations = Object.freeze(Object.fromEntries(Object
'st.providers.subscription_guide.local_link': 'Anleitung zu Einrichtung, Sicherheit und Kontorisiken lesen',
},
}).map(([code, copy]) => [code, {
+ 'st.providers.companion_guide.summary': providerGuideEnglish['st.providers.companion_guide.summary'],
+ 'st.providers.companion_guide.supported': providerGuideEnglish['st.providers.companion_guide.supported'],
'st.providers.companion_guide.body': companionGuideTranslations[code]?.[0] || providerGuideEnglish['st.providers.companion_guide.body'],
'st.providers.companion_guide.download': companionGuideTranslations[code]?.[1] || providerGuideEnglish['st.providers.companion_guide.download'],
+ 'st.providers.companion_guide.details': companionDetailsTranslations[code] || providerGuideEnglish['st.providers.companion_guide.details'],
...copy,
}])));
diff --git a/src/chrome/src/ui/settings.js b/src/chrome/src/ui/settings.js
index d3183df51..951150790 100644
--- a/src/chrome/src/ui/settings.js
+++ b/src/chrome/src/ui/settings.js
@@ -92,6 +92,10 @@ import {
webgpuModelDisplayName,
webgpuModelSupportsVision,
} from '../providers/webgpu.js';
+import {
+ COMPANION_PREFERRED_MODEL_PATTERNS,
+ selectPreferredCompanionModel,
+} from '../providers/companion-config.js';
import { AUTO_GROUP_TABS_KEY } from '../tab-group-preference.js';
const VISION_UI_PROVIDER_IDS = new Set(['ollama', ...AUTO_VISION_PROVIDER_IDS]);
@@ -2855,6 +2859,119 @@ const SHARE_RESEARCH_FIELD = {
type: 'checkbox',
};
+export {
+ COMPANION_PREFERRED_MODEL_PATTERNS,
+ selectPreferredCompanionModel,
+};
+
+if (typeof window !== 'undefined') {
+ window.COMPANION_PREFERRED_MODEL_PATTERNS = COMPANION_PREFERRED_MODEL_PATTERNS;
+ window.selectPreferredCompanionModel = selectPreferredCompanionModel;
+}
+
+const companionAutoCheckInFlight = new Set();
+const companionAutoCheckedAt = new Map();
+
+function updateCollapsedProviderHeader(id, config) {
+ const card = document.querySelector(`.provider-card[data-provider-id="${id}"]`);
+ if (!card) return;
+ const isSelected = id === activeProviderId;
+ const isConfigured = id !== 'webbrain_cloud' && config.configured === true;
+ if (isConfigured) {
+ card.classList.add('configured');
+ } else {
+ card.classList.remove('configured');
+ }
+ const header = card.querySelector('.provider-header');
+ if (!header) return;
+ const left = header.querySelector('.provider-header-left');
+ if (left) {
+ let modelBadge = left.querySelector('.provider-model');
+ const modelStr = (config.model && String(config.model).trim()) || '';
+ if (modelStr) {
+ if (!modelBadge) {
+ modelBadge = document.createElement('span');
+ modelBadge.className = 'provider-model';
+ left.appendChild(modelBadge);
+ }
+ modelBadge.title = modelStr;
+ modelBadge.textContent = modelStr;
+ } else if (modelBadge) {
+ modelBadge.remove();
+ }
+ }
+ const badges = header.querySelector('.provider-status-badges');
+ if (badges) {
+ let activeBadge = badges.querySelector('.provider-status-badge.active');
+ if (isConfigured) {
+ if (!activeBadge) {
+ activeBadge = document.createElement('span');
+ activeBadge.className = 'provider-status-badge active';
+ activeBadge.textContent = t('st.providers.active');
+ badges.prepend(activeBadge);
+ }
+ } else if (activeBadge) {
+ activeBadge.remove();
+ }
+ }
+ refreshActiveProviderFilterCount();
+ refreshProviderCardStatus(id);
+}
+
+async function checkAndAutoSelectCompanionModel(id) {
+ if (companionAutoCheckInFlight.has(id)) return;
+ const lastCheck = companionAutoCheckedAt.get(id) || 0;
+ if (Date.now() - lastCheck < 10000) return;
+ companionAutoCheckInFlight.add(id);
+ companionAutoCheckedAt.set(id, Date.now());
+
+ try {
+ const res = await sendToBackground('list_provider_models', { providerId: id });
+ if (!res?.ok || !Array.isArray(res.models) || res.models.length === 0) {
+ return;
+ }
+
+ const config = providersData[id];
+ if (!config) return;
+
+ const currentModel = String(config.model || '').trim();
+ let selectedModel = currentModel;
+ if (!currentModel || !res.models.includes(currentModel)) {
+ selectedModel = selectPreferredCompanionModel(res.models);
+ }
+ if (!selectedModel) return;
+
+ const needsUpdate = config.model !== selectedModel || !config.configured;
+ if (needsUpdate) {
+ config.model = selectedModel;
+ config.configured = true;
+ if (res.baseUrl && (!config.baseUrl || config.baseUrl === 'http://127.0.0.1:8327/v1')) {
+ config.baseUrl = res.baseUrl;
+ }
+ if (res.contextWindow && (!config.contextWindow || config.manualContextWindow !== true)) {
+ config.contextWindow = res.contextWindow;
+ }
+
+ await sendToBackground('update_provider', {
+ providerId: id,
+ config: {
+ model: selectedModel,
+ configured: true,
+ ...(config.baseUrl ? { baseUrl: config.baseUrl } : {}),
+ ...(config.contextWindow ? { contextWindow: config.contextWindow } : {}),
+ },
+ markConfigured: true,
+ });
+
+ updateCollapsedProviderHeader(id, config);
+ }
+ } catch {
+ // Companion is not running or unreachable — do not error or warn
+ } finally {
+ companionAutoCheckInFlight.delete(id);
+ }
+}
+
function providerDefinitionId(id, config = providersData[id]) {
return String(config?.sourceProviderId || config?.duplicateOf || id || '');
}
@@ -3690,7 +3807,7 @@ function renderProviders() {
OPTIONAL_LOCAL_API_KEY_FIELD,
{ key: 'model', labelKey: 'st.provider.field.model', type: 'text', placeholder: 'model listed in WebBrain Companion' },
LOCAL_PROXY_CONTEXT_WINDOW_FIELD,
- { key: 'supportsVision', labelKey: 'st.provider.field.supports_vision', type: 'checkbox' },
+ VISION_MODE_FIELD,
PROMPT_TIER_FIELD,
],
},
@@ -4042,6 +4159,9 @@ function renderProviders() {
if (providerQuery && !providerSearchTextForEntry(id, config, fieldDefs).includes(providerQuery)) continue;
visibleCount++;
+ const isCompanion = definitionId === 'webbrain_companion';
+ let topFieldsHTML = '';
+ let detailsFieldsHTML = '';
let fieldsHTML = '';
let collapsedFieldsHTML = '';
for (const field of fieldDefs) {
@@ -4142,10 +4262,33 @@ function renderProviders() {
</div>
`;
}
- if (field.collapsed) collapsedFieldsHTML += fieldHTML;
- else fieldsHTML += fieldHTML;
+ if (isCompanion) {
+ if (field.key === 'model' || field.key === 'shareQueriesForResearch') {
+ topFieldsHTML += fieldHTML;
+ } else {
+ detailsFieldsHTML += fieldHTML;
+ }
+ } else if (field.collapsed) {
+ collapsedFieldsHTML += fieldHTML;
+ } else {
+ fieldsHTML += fieldHTML;
+ }
}
- if (collapsedFieldsHTML) {
+ const compatibilitySettings = renderProviderCompatibilitySettings(id, config);
+ if (isCompanion) {
+ fieldsHTML = `
+ ${topFieldsHTML}
+ <details class="provider-compatibility provider-companion-details">
+ <summary>
+ <span class="provider-compatibility-title">${escapeHtml(t('st.providers.companion_guide.details'))}</span>
+ </summary>
+ <div class="provider-compatibility-body">
+ ${detailsFieldsHTML}
+ ${compatibilitySettings}
+ </div>
+ </details>
+ `;
+ } else if (collapsedFieldsHTML) {
fieldsHTML += `
<details class="provider-compatibility provider-local-auth">
<summary>
@@ -4192,7 +4335,6 @@ function renderProviders() {
target="_blank" rel="noopener noreferrer">${escapeHtml(t('st.providers.ollama_warning.link'))} ↗</a>
</aside>`
: '';
- const compatibilitySettings = renderProviderCompatibilitySettings(id, config);
const duplicateDisabledKey = !config.canDuplicate
? 'st.providers.duplicate_unavailable'
: ((!isConfigured || dirtyProviderIds.has(id)) ? 'st.providers.duplicate_inactive' : '');
@@ -4209,7 +4351,7 @@ function renderProviders() {
${providerNote}
${id === 'webbrain_cloud' ? '<div class="webbrain-payment-notice" role="status" hidden></div>' : ''}
${ollamaWarning}
- ${compatibilitySettings}
+ ${isCompanion ? '' : compatibilitySettings}
<div class="btn-row">
<button class="btn-primary btn-save" data-provider="${id}">${escapeHtml(t('st.providers.save'))}</button>
<button class="btn-secondary btn-test" data-provider="${id}">${escapeHtml(t('st.providers.test'))}</button>
@@ -4224,6 +4366,10 @@ function renderProviders() {
`;
providersContainer.appendChild(wrapCollapsibleCard(id, config, isSelected, isConfigured, body));
+ const expanded = isSelected || expandedProviders.has(id);
+ if (!expanded && isCompanion) {
+ void checkAndAutoSelectCompanionModel(id);
+ }
}
// If the filter would leave the list empty (no cards match and no selected
@@ -4532,8 +4678,12 @@ function wrapCollapsibleCard(id, config, isSelected, isConfigured, bodyHtml) {
// Snapshot unsaved typing in other expanded cards before we rebuild
// the DOM — same reason as the filter-pill handler above.
syncInputsIntoProvidersData();
- if (expandedProviders.has(id)) expandedProviders.delete(id);
- else expandedProviders.add(id);
+ if (expandedProviders.has(id)) {
+ expandedProviders.delete(id);
+ companionAutoCheckedAt.delete(id);
+ } else {
+ expandedProviders.add(id);
+ }
renderProviders();
});
diff --git a/src/firefox/src/providers/companion-config.js b/src/firefox/src/providers/companion-config.js
new file mode 100644
index 000000000..2559282f9
--- /dev/null
+++ b/src/firefox/src/providers/companion-config.js
@@ -0,0 +1,31 @@
+/**
+ * WebBrain Companion configuration and model selection rules.
+ *
+ * Companion connects WebBrain to a local subscription proxy running on
+ * loopback port 8327.
+ */
+
+export const WEBBRAIN_COMPANION_DEFAULT_BASE_URL = 'http://127.0.0.1:8327/v1';
+
+// Preferred models in priority order:
+// 1. haiku-5.5 (Claude Haiku 5.5)
+// 2. luna-6.1 (GPT-6.1 Luna)
+// 3. gemini-3.8-flash (Gemini 3.8 Flash)
+export const COMPANION_PREFERRED_MODEL_PATTERNS = [
+ /haiku[-_.]?5[.\-_]?5/i,
+ /luna[-_.]?6[.\-_]?1|gpt[-_.]?6[.\-_]?1.*luna/i,
+ /gemini[-_.]?3[.\-_]?8[-_.]?flash/i,
+];
+
+/**
+ * Automatically select the most preferred model from a list of Companion models.
+ * If none of the preferred patterns match, falls back to the first available model.
+ */
+export function selectPreferredCompanionModel(models = []) {
+ if (!Array.isArray(models) || models.length === 0) return '';
+ for (const pattern of COMPANION_PREFERRED_MODEL_PATTERNS) {
+ const matched = models.find((m) => typeof m === 'string' && pattern.test(m));
+ if (matched) return matched;
+ }
+ return typeof models[0] === 'string' ? models[0] : '';
+}
diff --git a/src/firefox/src/providers/manager.js b/src/firefox/src/providers/manager.js
index f3e311848..ef3e8b47f 100644
--- a/src/firefox/src/providers/manager.js
+++ b/src/firefox/src/providers/manager.js
@@ -309,6 +309,13 @@ export class ProviderManager {
|| (!String(config.model || '').trim() && config.visionDetection != null)
);
});
+ const companionVisionConfigMigrated = Object.entries(data.providers || {}).some(([id, config]) => {
+ const defId = config?.duplicateOf || id;
+ return defId === 'webbrain_companion' && (
+ !VISION_MODES.has(config.visionMode)
+ || Object.hasOwn(config, 'supportsVision')
+ );
+ });
const hadLegacyClaudeSubscription = Object.hasOwn(data.providers || {}, 'claude_subscription');
const rawStoredProviders = data.providers || {};
const stored = this._migrateStoredProviderConfigs(rawStoredProviders);
@@ -360,6 +367,14 @@ export class ProviderManager {
}
}
for (const [id, config] of Object.entries(configs)) {
+ if ((config?.duplicateOf || id) === 'webbrain_companion') {
+ if (!VISION_MODES.has(config.visionMode)) {
+ config.visionMode = typeof config.supportsVision === 'boolean'
+ ? (config.supportsVision ? 'on' : 'off')
+ : 'auto';
+ }
+ delete config.supportsVision;
+ }
if (config.duplicateOf && !this._isValidDuplicateConfig(id, config, configs)) {
delete configs[id];
providerStateMigrated = true;
@@ -373,6 +388,7 @@ export class ProviderManager {
// token bundle here — otherwise a previously-signed-in user's raw
// access/refresh tokens would sit in storage with no UI path to clear them.
if (hadLegacyClaudeSubscription) await signOutClaude();
+ if (companionVisionConfigMigrated) providerStateMigrated = true;
const deviceGuid = await this._getDeviceGuid(data[WEBBRAIN_DEVICE_GUID_KEY]);
for (const id of WEBBRAIN_CLOUD_PROVIDER_IDS) {
if (!configs[id]) continue;
@@ -601,7 +617,7 @@ export class ProviderManager {
contextWindow: LOCAL_OPENAI_PROXY_CONTEXT_WINDOW,
apiKey: '',
supportsAskStreaming: true,
- supportsVision: false,
+ visionMode: 'auto',
enabled: true,
},
local_openai_proxy: {
@@ -1246,6 +1262,14 @@ export class ProviderManager {
: 'auto';
delete normalizedConfig.supportsVision;
}
+ if (definitionId === 'webbrain_companion') {
+ normalizedConfig.visionMode = VISION_MODES.has(normalizedConfig.visionMode)
+ ? normalizedConfig.visionMode
+ : (typeof normalizedConfig.supportsVision === 'boolean'
+ ? (normalizedConfig.supportsVision ? 'on' : 'off')
+ : 'auto');
+ delete normalizedConfig.supportsVision;
+ }
if (visionProviderKind(definitionId, normalizedConfig)) {
const legacySupportsVision = normalizedConfig.supportsVision;
normalizedConfig.visionMode = VISION_MODES.has(normalizedConfig.visionMode)
@@ -1665,6 +1689,15 @@ export class ProviderManager {
merged.visionDetection = null;
}
}
+ if (this._providerDefinitionId(id, current) === 'webbrain_companion') {
+ const explicitLegacyVision = Object.hasOwn(config, 'supportsVision') && !Object.hasOwn(config, 'visionMode')
+ ? config.supportsVision
+ : null;
+ merged.visionMode = typeof explicitLegacyVision === 'boolean'
+ ? (explicitLegacyVision ? 'on' : 'off')
+ : (VISION_MODES.has(merged.visionMode) ? merged.visionMode : 'auto');
+ delete merged.supportsVision;
+ }
const definitionId = this._providerDefinitionId(id, merged);
const genericVisionKind = visionProviderKind(definitionId, merged);
if (genericVisionKind) {
diff --git a/src/firefox/src/ui/locales/provider-guide-copy.mjs b/src/firefox/src/ui/locales/provider-guide-copy.mjs
index cb8b17475..2c28ad3f1 100644
--- a/src/firefox/src/ui/locales/provider-guide-copy.mjs
+++ b/src/firefox/src/ui/locales/provider-guide-copy.mjs
@@ -4,6 +4,7 @@ export const providerGuideEnglish = Object.freeze({
'st.providers.companion_guide.supported': 'Supports Claude (Pro, Max or Team), ChatGPT (Plus or Pro via Codex), Google Gemini (via Antigravity), SuperGrok (via Grok Build), Kimi Code (kimi.ai or kimi.com), Meta Muse (Muse Code), and Devin.',
'st.providers.companion_guide.body': 'Get WebBrain Companion, start it, then load a model. No API key is needed on this computer.',
'st.providers.companion_guide.download': 'Download WebBrain Companion',
+ 'st.providers.companion_guide.details': 'Details',
'st.providers.subscription_guide.card_body': 'Have a {product} account or subscription instead of an API key?',
'st.providers.subscription_guide.card_link': 'See third-party proxy setup & risks',
'st.providers.subscription_guide.local_body': 'Using EasyCLIProxyAPI or CLIProxyAPI?',
@@ -17,6 +18,32 @@ const companionGuideTranslations = {
zh: ['安装并启动 WebBrain Companion,然后加载模型。本机无需 API 密钥。', '下载 WebBrain Companion'],
};
+const companionDetailsTranslations = {
+ ar: 'التفاصيل',
+ bn: 'বিস্তারিত',
+ de: 'Details',
+ en: 'Details',
+ es: 'Detalles',
+ fa: 'جزئیات',
+ fr: 'Détails',
+ he: 'פרטים',
+ hi: 'विवरण',
+ id: 'Detail',
+ ja: '詳細',
+ ko: '세부 정보',
+ ms: 'Butiran',
+ nl: 'Details',
+ pl: 'Szczegóły',
+ pt: 'Detalhes',
+ ru: 'Подробности',
+ th: 'รายละเอียด',
+ tl: 'Mga Detalye',
+ tr: 'Ayrıntılar',
+ uk: 'Подробиці',
+ vi: 'Chi tiết',
+ zh: '详情',
+};
+
export const providerGuideTranslations = Object.freeze(Object.fromEntries(Object.entries({
es: {
'st.providers.companion_guide.title': 'Tu suscripción actual',
@@ -181,7 +208,10 @@ export const providerGuideTranslations = Object.freeze(Object.fromEntries(Object
'st.providers.subscription_guide.local_link': 'Anleitung zu Einrichtung, Sicherheit und Kontorisiken lesen',
},
}).map(([code, copy]) => [code, {
+ 'st.providers.companion_guide.summary': providerGuideEnglish['st.providers.companion_guide.summary'],
+ 'st.providers.companion_guide.supported': providerGuideEnglish['st.providers.companion_guide.supported'],
'st.providers.companion_guide.body': companionGuideTranslations[code]?.[0] || providerGuideEnglish['st.providers.companion_guide.body'],
'st.providers.companion_guide.download': companionGuideTranslations[code]?.[1] || providerGuideEnglish['st.providers.companion_guide.download'],
+ 'st.providers.companion_guide.details': companionDetailsTranslations[code] || providerGuideEnglish['st.providers.companion_guide.details'],
...copy,
}])));
diff --git a/src/firefox/src/ui/settings.js b/src/firefox/src/ui/settings.js
index 50b9f0b0d..3efaa83f8 100644
--- a/src/firefox/src/ui/settings.js
+++ b/src/firefox/src/ui/settings.js
@@ -71,6 +71,10 @@ import {
import { ADDITIONAL_PROVIDER_UI } from '../providers/provider-catalog.js';
import { AUTO_VISION_PROVIDER_IDS, visionDetectionMatches } from '../providers/vision-capabilities.js';
import { canonicalizeOllamaBaseUrl } from '../providers/context-windows.js';
+import {
+ COMPANION_PREFERRED_MODEL_PATTERNS,
+ selectPreferredCompanionModel,
+} from '../providers/companion-config.js';
import { AUTO_GROUP_TABS_KEY } from '../tab-group-preference.js';
const VISION_UI_PROVIDER_IDS = new Set(['ollama', ...AUTO_VISION_PROVIDER_IDS]);
@@ -2421,6 +2425,119 @@ const SHARE_RESEARCH_FIELD = {
type: 'checkbox',
};
+export {
+ COMPANION_PREFERRED_MODEL_PATTERNS,
+ selectPreferredCompanionModel,
+};
+
+if (typeof window !== 'undefined') {
+ window.COMPANION_PREFERRED_MODEL_PATTERNS = COMPANION_PREFERRED_MODEL_PATTERNS;
+ window.selectPreferredCompanionModel = selectPreferredCompanionModel;
+}
+
+const companionAutoCheckInFlight = new Set();
+const companionAutoCheckedAt = new Map();
+
+function updateCollapsedProviderHeader(id, config) {
+ const card = document.querySelector(`.provider-card[data-provider-id="${id}"]`);
+ if (!card) return;
+ const isSelected = id === activeProviderId;
+ const isConfigured = id !== 'webbrain_cloud' && config.configured === true;
+ if (isConfigured) {
+ card.classList.add('configured');
+ } else {
+ card.classList.remove('configured');
+ }
+ const header = card.querySelector('.provider-header');
+ if (!header) return;
+ const left = header.querySelector('.provider-header-left');
+ if (left) {
+ let modelBadge = left.querySelector('.provider-model');
+ const modelStr = (config.model && String(config.model).trim()) || '';
+ if (modelStr) {
+ if (!modelBadge) {
+ modelBadge = document.createElement('span');
+ modelBadge.className = 'provider-model';
+ left.appendChild(modelBadge);
+ }
+ modelBadge.title = modelStr;
+ modelBadge.textContent = modelStr;
+ } else if (modelBadge) {
+ modelBadge.remove();
+ }
+ }
+ const badges = header.querySelector('.provider-status-badges');
+ if (badges) {
+ let activeBadge = badges.querySelector('.provider-status-badge.active');
+ if (isConfigured) {
+ if (!activeBadge) {
+ activeBadge = document.createElement('span');
+ activeBadge.className = 'provider-status-badge active';
+ activeBadge.textContent = t('st.providers.active');
+ badges.prepend(activeBadge);
+ }
+ } else if (activeBadge) {
+ activeBadge.remove();
+ }
+ }
+ refreshActiveProviderFilterCount();
+ refreshProviderCardStatus(id);
+}
+
+async function checkAndAutoSelectCompanionModel(id) {
+ if (companionAutoCheckInFlight.has(id)) return;
+ const lastCheck = companionAutoCheckedAt.get(id) || 0;
+ if (Date.now() - lastCheck < 10000) return;
+ companionAutoCheckInFlight.add(id);
+ companionAutoCheckedAt.set(id, Date.now());
+
+ try {
+ const res = await sendToBackground('list_provider_models', { providerId: id });
+ if (!res?.ok || !Array.isArray(res.models) || res.models.length === 0) {
+ return;
+ }
+
+ const config = providersData[id];
+ if (!config) return;
+
+ const currentModel = String(config.model || '').trim();
+ let selectedModel = currentModel;
+ if (!currentModel || !res.models.includes(currentModel)) {
+ selectedModel = selectPreferredCompanionModel(res.models);
+ }
+ if (!selectedModel) return;
+
+ const needsUpdate = config.model !== selectedModel || !config.configured;
+ if (needsUpdate) {
+ config.model = selectedModel;
+ config.configured = true;
+ if (res.baseUrl && (!config.baseUrl || config.baseUrl === 'http://127.0.0.1:8327/v1')) {
+ config.baseUrl = res.baseUrl;
+ }
+ if (res.contextWindow && (!config.contextWindow || config.manualContextWindow !== true)) {
+ config.contextWindow = res.contextWindow;
+ }
+
+ await sendToBackground('update_provider', {
+ providerId: id,
+ config: {
+ model: selectedModel,
+ configured: true,
+ ...(config.baseUrl ? { baseUrl: config.baseUrl } : {}),
+ ...(config.contextWindow ? { contextWindow: config.contextWindow } : {}),
+ },
+ markConfigured: true,
+ });
+
+ updateCollapsedProviderHeader(id, config);
+ }
+ } catch {
+ // Companion is not running or unreachable — do not error or warn
+ } finally {
+ companionAutoCheckInFlight.delete(id);
+ }
+}
+
async function confirmResearchSharing(event) {
const input = event.currentTarget;
if (!input.checked) return;
@@ -3055,7 +3172,7 @@ function renderProviders() {
OPTIONAL_LOCAL_API_KEY_FIELD,
{ key: 'model', labelKey: 'st.provider.field.model', type: 'text', placeholder: 'model listed in WebBrain Companion' },
LOCAL_PROXY_CONTEXT_WINDOW_FIELD,
- { key: 'supportsVision', labelKey: 'st.provider.field.supports_vision', type: 'checkbox' },
+ VISION_MODE_FIELD,
PROMPT_TIER_FIELD,
],
},
@@ -3383,6 +3500,9 @@ function renderProviders() {
if (providerQuery && !providerSearchTextForEntry(id, config, fieldDefs).includes(providerQuery)) continue;
visibleCount++;
+ const isCompanion = definitionId === 'webbrain_companion';
+ let topFieldsHTML = '';
+ let detailsFieldsHTML = '';
let fieldsHTML = '';
let collapsedFieldsHTML = '';
for (const field of fieldDefs) {
@@ -3481,10 +3601,33 @@ function renderProviders() {
</div>
`;
}
- if (field.collapsed) collapsedFieldsHTML += fieldHTML;
- else fieldsHTML += fieldHTML;
+ if (isCompanion) {
+ if (field.key === 'model' || field.key === 'shareQueriesForResearch') {
+ topFieldsHTML += fieldHTML;
+ } else {
+ detailsFieldsHTML += fieldHTML;
+ }
+ } else if (field.collapsed) {
+ collapsedFieldsHTML += fieldHTML;
+ } else {
+ fieldsHTML += fieldHTML;
+ }
}
- if (collapsedFieldsHTML) {
+ const compatibilitySettings = renderProviderCompatibilitySettings(id, config);
+ if (isCompanion) {
+ fieldsHTML = `
+ ${topFieldsHTML}
+ <details class="provider-compatibility provider-companion-details">
+ <summary>
+ <span class="provider-compatibility-title">${escapeHtml(t('st.providers.companion_guide.details'))}</span>
+ </summary>
+ <div class="provider-compatibility-body">
+ ${detailsFieldsHTML}
+ ${compatibilitySettings}
+ </div>
+ </details>
+ `;
+ } else if (collapsedFieldsHTML) {
fieldsHTML += `
<details class="provider-compatibility provider-local-auth">
<summary>
@@ -3531,7 +3674,6 @@ function renderProviders() {
target="_blank" rel="noopener noreferrer">${escapeHtml(t('st.providers.ollama_warning.link'))} ↗</a>
</aside>`
: '';
- const compatibilitySettings = renderProviderCompatibilitySettings(id, config);
const duplicateDisabledKey = !config.canDuplicate
? 'st.providers.duplicate_unavailable'
: ((!isConfigured || dirtyProviderIds.has(id)) ? 'st.providers.duplicate_inactive' : '');
@@ -3548,7 +3690,7 @@ function renderProviders() {
${providerNote}
${id === 'webbrain_cloud' ? '<div class="webbrain-payment-notice" role="status" hidden></div>' : ''}
${ollamaWarning}
- ${compatibilitySettings}
+ ${isCompanion ? '' : compatibilitySettings}
<div class="btn-row">
<button class="btn-primary btn-save" data-provider="${id}">${escapeHtml(t('st.providers.save'))}</button>
<button class="btn-secondary btn-test" data-provider="${id}">${escapeHtml(t('st.providers.test'))}</button>
@@ -3561,6 +3703,10 @@ function renderProviders() {
`;
providersContainer.appendChild(wrapCollapsibleCard(id, config, isSelected, isConfigured, body));
+ const expanded = isSelected || expandedProviders.has(id);
+ if (!expanded && isCompanion) {
+ void checkAndAutoSelectCompanionModel(id);
+ }
}
if (visibleCount === 0) {
@@ -3831,8 +3977,12 @@ function wrapCollapsibleCard(id, config, isSelected, isConfigured, bodyHtml) {
// Snapshot unsaved typing in other expanded cards before we rebuild
// the DOM — same reason as the filter-pill handler above.
syncInputsIntoProvidersData();
- if (expandedProviders.has(id)) expandedProviders.delete(id);
- else expandedProviders.add(id);
+ if (expandedProviders.has(id)) {
+ expandedProviders.delete(id);
+ companionAutoCheckedAt.delete(id);
+ } else {
+ expandedProviders.add(id);
+ }
renderProviders();
});
diff --git a/test/companion-provider-details.mjs b/test/companion-provider-details.mjs
new file mode 100644
index 000000000..482e53c84
--- /dev/null
+++ b/test/companion-provider-details.mjs
@@ -0,0 +1,312 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { createServer } from 'node:http';
+import { readFile } from 'node:fs/promises';
+import { resolve, extname, sep, join } from 'node:path';
+import { pathToFileURL, fileURLToPath } from 'node:url';
+import { chromium, firefox } from 'playwright';
+
+const ROOT = resolve(fileURLToPath(import.meta.url), '../..');
+
+// ── 1. Unit tests: selectPreferredCompanionModel & ProviderManager defaults ──
+
+for (const build of ['chrome', 'firefox']) {
+ const prefix = join(ROOT, 'src', build, 'src');
+ const { ProviderManager } = await import(pathToFileURL(join(prefix, 'providers', 'manager.js')).href);
+ const { selectPreferredCompanionModel, COMPANION_PREFERRED_MODEL_PATTERNS } = await import(
+ pathToFileURL(join(prefix, 'providers', 'companion-config.js')).href
+ );
+
+ test(`${build}: selectPreferredCompanionModel preference ranking`, () => {
+ assert.equal(typeof selectPreferredCompanionModel, 'function');
+ assert.equal(COMPANION_PREFERRED_MODEL_PATTERNS.length, 3);
+
+ // haiku-5.5 ranks first even if later in the list
+ assert.equal(
+ selectPreferredCompanionModel(['gemini-3.8-flash', 'gpt-6.1-luna', 'claude-haiku-5-5']),
+ 'claude-haiku-5-5',
+ );
+ assert.equal(
+ selectPreferredCompanionModel(['haiku-5.5', 'luna-6.1']),
+ 'haiku-5.5',
+ );
+
+ // luna-6.1 ranks second
+ assert.equal(
+ selectPreferredCompanionModel(['other-model', 'gemini-3.8-flash', 'gpt-6.1-luna-pro']),
+ 'gpt-6.1-luna-pro',
+ );
+ assert.equal(
+ selectPreferredCompanionModel(['luna-6.1', 'gemini-3.8-flash']),
+ 'luna-6.1',
+ );
+
+ // gemini-3.8-flash ranks third
+ assert.equal(
+ selectPreferredCompanionModel(['unsloth-qwen', 'gemini-3.8-flash', 'llama-3']),
+ 'gemini-3.8-flash',
+ );
+
+ // Fallback to first model when no preference matches
+ assert.equal(
+ selectPreferredCompanionModel(['bonsai-2-27b', 'unsloth-qwen']),
+ 'bonsai-2-27b',
+ );
+
+ // Empty array returns empty string
+ assert.equal(selectPreferredCompanionModel([]), '');
+ });
+
+ test(`${build}: webbrain_companion default config & visionMode handling`, async () => {
+ const manager = new ProviderManager();
+ manager.save = async () => {};
+ const defaults = manager._defaultConfigs().webbrain_companion;
+ assert.equal(defaults.baseUrl, 'http://127.0.0.1:8327/v1');
+ assert.equal(defaults.visionMode, 'auto', 'visionMode must default to auto');
+ assert.equal(defaults.supportsVision, undefined, 'legacy supportsVision must not be preset to false');
+
+ // Create provider with default config
+ const provider = manager._createProvider('webbrain_companion', defaults);
+ assert.equal(provider.config.visionMode, 'auto');
+ assert.equal(provider.config.supportsVision, undefined);
+
+ // Verify vision sniffing works when visionMode is auto
+ const claudeVision = manager._createProvider('webbrain_companion', {
+ ...defaults,
+ model: 'claude-haiku-5-5',
+ });
+ assert.equal(claudeVision.supportsVision, true, 'Haiku 5.5 should sniff as vision-capable');
+
+ const textOnly = manager._createProvider('webbrain_companion', {
+ ...defaults,
+ model: 'deepseek-chat',
+ });
+ assert.equal(textOnly.supportsVision, false, 'text-only model should not sniff vision');
+
+ // updateProvider migrating legacy supportsVision
+ manager.providers.set('webbrain_companion', provider);
+ await manager.updateProvider('webbrain_companion', { supportsVision: true });
+ assert.equal(manager.providers.get('webbrain_companion').config.visionMode, 'on');
+
+ await manager.updateProvider('webbrain_companion', { visionMode: 'off' });
+ assert.equal(manager.providers.get('webbrain_companion').config.visionMode, 'off');
+ });
+}
+
+// ── 2. UI tests: Card layout, Details section, & Auto-selection when collapsed ──
+
+const server = createServer(async (req, res) => {
+ try {
+ const file = resolve(ROOT, '.' + new URL(req.url, 'http://localhost').pathname);
+ if (!file.startsWith(ROOT + sep)) throw Error();
+ res.setHeader('Content-Type', ({
+ '.js': 'text/javascript',
+ '.mjs': 'text/javascript',
+ '.html': 'text/html',
+ '.css': 'text/css',
+ '.svg': 'image/svg+xml',
+ '.png': 'image/png',
+ })[extname(file)] || 'text/plain');
+ res.end(await readFile(file));
+ } catch { res.statusCode = 404; res.end(); }
+});
+await new Promise(done => server.listen(0, '127.0.0.1', done));
+const origin = `http://127.0.0.1:${server.address().port}`;
+
+for (const [build, engine] of [['chrome', chromium], ['firefox', firefox]]) {
+ test(`${build}: Companion provider card layout and auto-selection when collapsed`, async (t) => {
+ let browser;
+ try {
+ browser = await engine.launch();
+ } catch (e) {
+ t.skip(`${build} browser unavailable: ${e.message.split('\n')[0]}`);
+ return;
+ }
+
+ try {
+ const page = await browser.newPage({ viewport: { width: 1280, height: 1000 } });
+ const errors = [];
+ page.on('pageerror', err => errors.push(err.message));
+
+ await page.addInitScript(({ build }) => {
+ localStorage.setItem('wbLocale', 'en');
+ const data = {
+ wbLocale: 'en',
+ providers: {
+ webbrain_cloud: { type: 'cloud', category: 'cloud', label: 'WebBrain Compass', configured: true },
+ webbrain_companion: {
+ type: 'openai',
+ category: 'local',
+ label: 'Your Existing Subscription',
+ providerName: 'webbrain-companion',
+ baseUrl: 'http://127.0.0.1:8327/v1',
+ model: '',
+ visionMode: 'auto',
+ configured: false,
+ },
+ },
+ activeProvider: 'webbrain_cloud',
+ };
+ window.testStore = data;
+ window.companionMockModels = ['gemini-3.8-flash', 'claude-haiku-5-5'];
+
+ const storage = {
+ async get(keys) {
+ return keys == null ? { ...data } : Object.fromEntries(
+ (Array.isArray(keys) ? keys : typeof keys === 'string' ? [keys] : Object.keys(keys))
+ .map(k => [k, data[k]]),
+ );
+ },
+ async set(values) { Object.assign(data, values); },
+ async remove(keys) {
+ for (const key of Array.isArray(keys) ? keys : [keys]) delete data[key];
+ },
+ };
+
+ window.chrome = window.browser = {
+ storage: { local: storage, onChanged: { addListener() {} } },
+ runtime: {
+ getURL: path => `${location.origin}/src/${build}/${path}`,
+ getManifest: () => ({ version: '44.0.2' }),
+ onMessage: { addListener() {} },
+ sendMessage(msg, callback) {
+ if (msg.action === 'get_providers') {
+ const res = { providers: data.providers, active: data.activeProvider };
+ callback?.(res);
+ return Promise.resolve(res);
+ }
+ if (msg.action === 'list_provider_models' && msg.providerId === 'webbrain_companion') {
+ const res = { ok: true, models: window.companionMockModels, baseUrl: 'http://127.0.0.1:8327/v1' };
+ callback?.(res);
+ return Promise.resolve(res);
+ }
+ if (msg.action === 'update_provider') {
+ Object.assign(data.providers[msg.providerId], msg.config);
+ if (msg.markConfigured) data.providers[msg.providerId].configured = true;
+ const res = { ok: true, activeProviderId: data.activeProvider };
+ callback?.(res);
+ return Promise.resolve(res);
+ }
+ const res = { ok: true };
+ callback?.(res);
+ return Promise.resolve(res);
+ },
+ },
+ commands: { getAll: async () => [] },
+ tabs: { create: async () => ({}) },
+ };
+ }, { build });
+
+ await page.goto(`${origin}/src/${build}/src/ui/providers.html#llm`);
+
+ const card = page.locator('.provider-card[data-provider-id="webbrain_companion"]');
+ await card.waitFor();
+
+ // 1. Verify card started collapsed
+ assert.ok(await card.evaluate(el => el.classList.contains('collapsed')), 'card must start collapsed');
+
+ // 2. Verify auto-selection when collapsed:
+ // It probes Companion models, picks preferred 'claude-haiku-5-5' (over 'gemini-3.8-flash'),
+ // marks card configured, and renders the model badge and active badge in header.
+ await page.waitForFunction(() => {
+ const c = document.querySelector('.provider-card[data-provider-id="webbrain_companion"]');
+ return c?.classList.contains('configured') && c?.querySelector('.provider-model')?.textContent === 'claude-haiku-5-5';
+ }, null, { timeout: 5000 });
+
+ assert.equal(
+ await card.locator('.provider-model').textContent(),
+ 'claude-haiku-5-5',
+ 'header must display auto-selected model',
+ );
+ assert.equal(
+ await card.locator('.provider-status-badge.active').textContent(),
+ 'ACTIVE',
+ 'header must show Active status badge',
+ );
+
+ // 3. Expand the card and verify layout
+ await card.locator('.provider-header').click();
+ assert.ok(await card.evaluate(el => el.classList.contains('expanded')), 'card should expand on header click');
+
+ // Top level fields: Title, Model, Share queries
+ const topInputs = await card.locator('> .provider-body > .field input, > .provider-body > .field select').evaluateAll(
+ els => els.map(el => el.dataset.key),
+ );
+ assert.ok(topInputs.includes('label'), 'title input must be at top level');
+ assert.ok(topInputs.includes('model'), 'model input must be at top level');
+ assert.ok(topInputs.includes('shareQueriesForResearch'), 'shareQueries checkbox must be at top level');
+ assert.ok(!topInputs.includes('baseUrl'), 'baseUrl must NOT be at top level');
+ assert.ok(!topInputs.includes('contextWindow'), 'contextWindow must NOT be at top level');
+ assert.ok(!topInputs.includes('visionMode'), 'visionMode must NOT be at top level');
+
+ // Model input must contain the auto-selected model
+ assert.equal(
+ await card.locator('input[data-key="model"]').inputValue(),
+ 'claude-haiku-5-5',
+ );
+
+ // Details section
+ const details = card.locator('details.provider-companion-details');
+ assert.equal(await details.count(), 1, 'Details collapsible must exist');
+ assert.equal(
+ await details.locator('> summary .provider-compatibility-title').textContent(),
+ 'Details',
+ 'Details summary title must be "Details"',
+ );
+
+ // Inside Details: baseUrl, apiKey, contextWindow, visionMode, promptTier, maxOutputTokens, compatibilitySettings
+ const detailKeys = await details.locator('.provider-compatibility-body [data-key]').evaluateAll(
+ els => els.map(el => el.dataset.key),
+ );
+ assert.ok(detailKeys.includes('baseUrl'), 'baseUrl inside Details');
+ assert.ok(detailKeys.includes('apiKey'), 'apiKey inside Details');
+ assert.ok(detailKeys.includes('contextWindow'), 'contextWindow inside Details');
+ assert.ok(detailKeys.includes('visionMode'), 'visionMode inside Details');
+ assert.ok(detailKeys.includes('promptTier'), 'promptTier inside Details');
+ assert.ok(detailKeys.includes('maxOutputTokens'), 'maxOutputTokens inside Details');
+
+ // visionMode must be a selectbox with 'auto' preselected, with options auto, on, off
+ const visionSelect = details.locator('select[data-key="visionMode"]');
+ assert.equal(await visionSelect.count(), 1, 'visionMode select must exist');
+ assert.equal(await visionSelect.inputValue(), 'auto', 'visionMode must default to auto');
+ const visionOptions = await visionSelect.locator('option').evaluateAll(opts => opts.map(o => o.value));
+ assert.deepEqual(visionOptions, ['auto', 'on', 'off'], 'visionMode options must be auto, on, off');
+
+ // Compatibility settings details must be present inside companion Details
+ assert.equal(
+ await details.locator('.provider-compatibility[data-provider-id="webbrain_companion"]').count(),
+ 1,
+ 'Compatibility settings must be nested inside Details',
+ );
+
+ // 4. Test re-collapsing with updated available models (e.g. proxy rotated models)
+ await page.evaluate(() => {
+ window.companionMockModels = ['gpt-6.1-luna', 'gemini-3.8-flash'];
+ // Clear current model to trigger auto-reselection
+ window.testStore.providers.webbrain_companion.model = '';
+ });
+ await card.locator('.provider-header').click();
+ assert.ok(await card.evaluate(el => el.classList.contains('collapsed')), 'card should re-collapse on header click');
+
+ // Auto-selection runs and selects luna-6.1
+ await page.waitForFunction(() => {
+ const c = document.querySelector('.provider-card[data-provider-id="webbrain_companion"]');
+ return c?.querySelector('.provider-model')?.textContent === 'gpt-6.1-luna';
+ }, null, { timeout: 5000 });
+
+ assert.equal(
+ await card.locator('.provider-model').textContent(),
+ 'gpt-6.1-luna',
+ 'header must display updated auto-selected model',
+ );
+
+ assert.deepEqual(errors, [], 'no uncaught page errors');
+ } finally {
+ await browser.close();
+ }
+ });
+}
+
+test.after(() => {
+ server.close();
+});
diff --git a/test/run.js b/test/run.js
index ab537a626..1d1e238a4 100644
--- a/test/run.js
+++ b/test/run.js
@@ -77523,6 +77523,8 @@ test('WebBrain Companion loads models and chats over its keyless local endpoint'
assert.equal(defaults.baseUrl, 'http://127.0.0.1:8327/v1', `${browser}: Companion URL`);
assert.equal(defaults.requiresApiKey, undefined, `${browser}: loopback access must be keyless`);
assert.equal(defaults.requiresModel, true, `${browser}: model selection must be explicit`);
+ assert.equal(defaults.visionMode, 'auto', `${browser}: visionMode must default to auto`);
+ assert.equal(defaults.supportsVision, undefined, `${browser}: legacy supportsVision must not be present in defaults`);
manager.providers.set('webbrain_companion', manager._createProvider('webbrain_companion', defaults));
const requests = [];
globalThis.fetch = async (url, init = {}) => {
@@ -134848,7 +134850,7 @@ test('generate_image tool exists in both builds, full tier only, and settings UI
const agentJs = fs.readFileSync(path.join(ROOT, `src/${build}/src/agent/agent.js`), 'utf8');
assert.ok(agentJs.includes("name === 'generate_image'"), `${build}: agent.js should dispatch generate_image`);
- assert.match(agentJs, /generateImage\(args, \{\s*signal: executionContext\?\._contentActionAbortSignal,\s*\.\.\.\(executionContext\?\.imageGenConfig \? \{ config: executionContext\.imageGenConfig \} : \{\}\),/,
+ assert.match(agentJs, /generateImage\(providerArgs, \{\s*signal: executionContext\?\._contentActionAbortSignal,\s*\.\.\.\(config !== undefined \? \{ config \} : \{\}\),/,
`${build}: agent.js should pass the linked run signal into fal generation`);
assert.equal(untrustedTools.has('generate_image'), true, `${build}: fal.ai output must be untrusted`);