Open-source AI browser agent for Chrome and Firefox (monorepo) ðŸ§
JavaScript ai-agentai-agentsai-toolsbrowser-aibrowser-automationbrowser-extensionchrome-aichrome-devtoolschrome-extensionchrome-extensionsfirefox-addonfirefox-addonsfirefox-extensionfirefox-extensionsgemmagemma4minimaxoffline-aioffline-llmqwen
feat(providers): add Freebuff2API integration
Codex release-state testf625741be34c
diff --git a/docs/providers-and-models.md b/docs/providers-and-models.mdindex f38668ae8..897cf5135 100644--- a/docs/providers-and-models.md+++ b/docs/providers-and-models.md@@ -119,17 +119,17 @@ class BaseLLMProvider {### Extended provider catalog-WebBrain also ships 80 disabled-by-default provider cards. Most are sourced+WebBrain also ships 81 disabled-by-default provider cards. Most are sourcedfrom the OpenCode provider catalog snapshot at commit`62e4641235d7847dadc60da37cca8a023dd54fc1`; provider-specific additions usetheir official API documentation. Together with the original cards, Settings-contains **113 built-in providers on Chromium** and **112 on Firefox**; the+contains **114 built-in providers on Chromium** and **113 on Firefox**; thedifference is the Chromium-only in-browser WebGPU runtime.| IDs ||---|| `302ai`, `abacus`, `aihubmix`, `alibaba-coding-plan`, `alibaba-coding-plan-cn`, `azure-cognitive-services`, `bailing`, `baseten`, `berget`, `cerebras`, `chutes`, `clarifai`, `cloudferro-sherlock`, `cohere`, `cortecs`, `deepinfra`, `demonroute`, `digitalocean`, `dinference`, `drun`, `evroc`, `fastrouter`, `friendli` |-| `google-vertex`, `google-vertex-anthropic`, `helicone`, `iflowcn`, `inception`, `inference`, `io-net`, `jiekou`, `kilo`, `kimi-for-coding`, `kuae-cloud-coding-plan`, `llama`, `lucidquery`, `meganova`, `minimax-cn-coding-plan`, `minimax-coding-plan`, `moark`, `modelscope`, `morph` |+| `freebuff2api`, `google-vertex`, `google-vertex-anthropic`, `helicone`, `iflowcn`, `inception`, `inference`, `io-net`, `jiekou`, `kilo`, `kimi-for-coding`, `kuae-cloud-coding-plan`, `llama`, `lucidquery`, `meganova`, `minimax-cn-coding-plan`, `minimax-coding-plan`, `moark`, `modelscope`, `morph` || `nano-gpt`, `nearai`, `nebius`, `nova`, `novita-ai`, `ollama-cloud`, `opencode`, `opencode-go`, `orcarouter`, `ovhcloud`, `perplexity`, `perplexity-agent`, `poe`, `pollinations`, `privatemode-ai`, `qihang-ai`, `qiniu-ai`, `requesty`, `scaleway`, `siliconflow`, `siliconflow-cn`, `stackit` || `stepfun`, `submodel`, `synthetic`, `tencent-coding-plan`, `upstage`, `v0`, `venice`, `vercel`, `vivgrid`, `vultr`, `wandb`, `xiaomi`, `zai-coding-plan`, `zenmux`, `zhipuai`, `zhipuai-coding-plan` |@@ -148,6 +148,22 @@ Morph and standard Perplexity Sonar are text-only integrations in the agentand advertise `supportsTools: false`. New provider cards remain inactive untilthe user saves their credentials and selects the provider.+#### Freebuff2API++[Freebuff2API](https://github.com/Quorinex/Freebuff2API) is a self-hosted,+OpenAI-compatible proxy. Start the server, then configure the **Freebuff2API+(Local)** card with its URL (the default is `http://127.0.0.1:8080/v1`) and+select a model with **Load Models**. Enter a proxy API key only when its+`API_KEYS` access control is enabled; Freebuff authentication tokens remain on+the proxy server and are never entered into WebBrain.++#### IO.NET and Synthetic++[IO.NET](https://io.net/docs/guides/intelligence/io-intelligence) and+[Synthetic](https://synthetic.new/) are built-in OpenAI-compatible cloud+providers. Add each service's bearer API key in its Settings card, choose a+model, save, and select the provider.+#### NEAR AI Cloud[NEAR AI Cloud](https://cloud.near.ai/) exposes an OpenAI-compatible API atdiff --git a/package.json b/package.jsonindex 88888ce6d..6a9565bee 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: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 test/memcode-recall.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:provider-catalog && 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 test/memcode-recall.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:provider-catalog": "node test/provider-catalog-integrations.mjs","test:openrouter-capabilities": "node --test test/openrouter-model-capabilities.mjs test/muse-tool-choice.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",diff --git a/src/chrome/icons/providers/SOURCES.md b/src/chrome/icons/providers/SOURCES.mdindex c7bf6b76c..eecd0ed5e 100644--- a/src/chrome/icons/providers/SOURCES.md+++ b/src/chrome/icons/providers/SOURCES.md@@ -11,7 +11,7 @@ Most brand marks come from [Lobe Icons](https://github.com/lobehub/lobe-icons)| osaurus | [Osaurus official logo](https://github.com/osaurus-ai/osaurus/blob/main/App/osaurus/Assets.xcassets/osaurus-logo.imageset/osaurus-logo-black.svg) (`osaurus-ai/osaurus`, MIT) || localai | LocalAI official logo (`mudler/LocalAI`) || gpt4all | Simple mark (not an official GPT4All brand asset) |-| local_openai_proxy, webgpu | WebBrain-authored generic local-runtime marks |+| local_openai_proxy, webgpu, freebuff2api | WebBrain-authored generic local-runtime marks || ods | [Official ODS product logo](https://osmantic.com/assets/images/products/ods-logo.png) (Osmantic) || unsloth | Unsloth official `images/unsloth logo only.png` (`unslothai/unsloth`), vectorized || sglang | SGLang official `logo_square` (`sgl-project/sglang`) |diff --git a/src/chrome/icons/providers/freebuff2api.svg b/src/chrome/icons/providers/freebuff2api.svgnew file mode 100644index 000000000..80c3eca2a--- /dev/null+++ b/src/chrome/icons/providers/freebuff2api.svg@@ -0,0 +1,3 @@+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" role="img" aria-label="Freebuff2API">+ <path fill="currentColor" d="M3 3h11a5 5 0 0 1 0 10H8v8H3V3Zm5 5h6a1 1 0 0 0 0-2H8v2Zm0 9h7a3 3 0 0 1 0 6H3v-6h5Zm0 3h7a1 1 0 0 0 0-2H8v2Z"/>+</svg>diff --git a/src/chrome/src/providers/manager.js b/src/chrome/src/providers/manager.jsindex d02928de8..ca7edf836 100644--- a/src/chrome/src/providers/manager.js+++ b/src/chrome/src/providers/manager.js@@ -79,7 +79,7 @@ import {const WEBBRAIN_CLOUD_PROVIDER_ID = 'webbrain_cloud';const WEBBRAIN_CLOUD_PROVIDER_LABEL = 'WebBrain Compass';const DUPLICATE_PROVIDER_SUFFIX = '__duplicate';-const LOCAL_MODEL_LIST_PROVIDER_IDS = ['llamacpp', 'ollama', 'ods', 'lmstudio', 'osaurus', 'jan', 'vllm', 'sglang', 'localai', 'gpt4all', 'local_openai_proxy', 'unsloth'];+const LOCAL_MODEL_LIST_PROVIDER_IDS = ['llamacpp', 'ollama', 'ods', 'lmstudio', 'osaurus', 'jan', 'vllm', 'sglang', 'localai', 'gpt4all', 'local_openai_proxy', 'unsloth', 'freebuff2api'];const WEBBRAIN_CLOUD_CONTEXT_WINDOW = 1000000;const WEBBRAIN_CLOUD_LEGACY_CONTEXT_WINDOW = 256000;const WEBBRAIN_DEVICE_GUID_KEY = 'webbrainDeviceGuid';diff --git a/src/chrome/src/providers/provider-catalog.js b/src/chrome/src/providers/provider-catalog.jsindex 3f92e3bbf..a2014ac2e 100644--- a/src/chrome/src/providers/provider-catalog.js+++ b/src/chrome/src/providers/provider-catalog.js@@ -82,6 +82,7 @@ const PROVIDERS = [provider('drun', 'D.Run (China)', 'https://chat.d.run/v1', 'public/deepseek-v3', 131072, { apiKeyUrl: 'https://www.d.run', inputCostPerMillionUsd: 0.28, outputCostPerMillionUsd: 1.1 }),provider('evroc', 'evroc', 'https://models.think.evroc.com/v1', 'moonshotai/Kimi-K2.6', 262144, { apiKeyUrl: 'https://docs.evroc.com/products/think/overview.html', supportsVision: true, inputCostPerMillionUsd: 1.4375, outputCostPerMillionUsd: 5.75 }),provider('fastrouter', 'FastRouter', 'https://go.fastrouter.ai/api/v1', 'moonshotai/kimi-k2', 131072, { apiKeyUrl: 'https://fastrouter.ai/models', inputCostPerMillionUsd: 0.55, outputCostPerMillionUsd: 2.2 }),+ provider('freebuff2api', 'Freebuff2API (Local)', 'http://127.0.0.1:8080/v1', '', 16384, { category: 'local', apiKeyUrl: 'https://github.com/Quorinex/Freebuff2API', requiresModel: true, apiKeyPlaceholder: 'Optional proxy API key' }),provider('friendli', 'Friendli', 'https://api.friendli.ai/serverless/v1', 'google/gemma-4-31B-it', 262144, { apiKeyUrl: 'https://friendli.ai/docs/guides/serverless_endpoints/introduction', supportsVision: true, inputCostPerMillionUsd: 0.14, outputCostPerMillionUsd: 0.4 }),provider('google-vertex', 'Google Vertex AI', 'https://{vertex_endpoint}/v1/projects/{project}/locations/{location}/endpoints/openapi', 'gemini-3.7-flash', 1048576, { category: 'cloud', apiKeyUrl: 'https://console.cloud.google.com/apis/credentials', apiKeyHeader: 'x-goog-api-key', project: '', location: 'us-central1', supportsVision: true, apiKeyPlaceholder: 'Google authorization key', suggestions: ['gemini-3.1-pro', 'gemini-3.7-flash', 'gemini-3.6-flash', 'gemini-3.5-flash'] }),provider('google-vertex-anthropic', 'Google Vertex AI (Anthropic)', 'https://{vertex_endpoint}', 'claude-sonnet-5', 1000000, { category: 'cloud', type: 'vertex_anthropic', apiKeyUrl: 'https://console.cloud.google.com/apis/credentials', project: '', location: 'us-east5', supportsVision: true, inputCostPerMillionUsd: 2, cacheReadCostPerMillionUsd: 0.2, cacheWriteCostPerMillionUsd: 2.5, outputCostPerMillionUsd: 10, apiKeyPlaceholder: 'Google authorization key', suggestions: ['claude-opus-5', 'claude-sonnet-5', 'claude-haiku-4-5@20251001'] }),diff --git a/src/firefox/icons/providers/SOURCES.md b/src/firefox/icons/providers/SOURCES.mdindex 30a148992..3904f161f 100644--- a/src/firefox/icons/providers/SOURCES.md+++ b/src/firefox/icons/providers/SOURCES.md@@ -11,7 +11,7 @@ Most brand marks come from [Lobe Icons](https://github.com/lobehub/lobe-icons)| osaurus | [Osaurus official logo](https://github.com/osaurus-ai/osaurus/blob/main/App/osaurus/Assets.xcassets/osaurus-logo.imageset/osaurus-logo-black.svg) (`osaurus-ai/osaurus`, MIT) || localai | LocalAI official logo (`mudler/LocalAI`) || gpt4all | Simple mark (not an official GPT4All brand asset) |-| local_openai_proxy | WebBrain-authored generic proxy mark |+| local_openai_proxy, freebuff2api | WebBrain-authored generic proxy marks || ods | [Official ODS product logo](https://osmantic.com/assets/images/products/ods-logo.png) (Osmantic) || unsloth | Unsloth official `images/unsloth logo only.png` (`unslothai/unsloth`), vectorized || sglang | SGLang official `logo_square` (`sgl-project/sglang`) |diff --git a/src/firefox/icons/providers/freebuff2api.svg b/src/firefox/icons/providers/freebuff2api.svgnew file mode 100644index 000000000..80c3eca2a--- /dev/null+++ b/src/firefox/icons/providers/freebuff2api.svg@@ -0,0 +1,3 @@+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" role="img" aria-label="Freebuff2API">+ <path fill="currentColor" d="M3 3h11a5 5 0 0 1 0 10H8v8H3V3Zm5 5h6a1 1 0 0 0 0-2H8v2Zm0 9h7a3 3 0 0 1 0 6H3v-6h5Zm0 3h7a1 1 0 0 0 0-2H8v2Z"/>+</svg>diff --git a/src/firefox/src/providers/manager.js b/src/firefox/src/providers/manager.jsindex b5e01b51c..f3066b1d0 100644--- a/src/firefox/src/providers/manager.js+++ b/src/firefox/src/providers/manager.js@@ -53,7 +53,7 @@ import {const WEBBRAIN_CLOUD_PROVIDER_ID = 'webbrain_cloud';const WEBBRAIN_CLOUD_PROVIDER_LABEL = 'WebBrain Compass';const DUPLICATE_PROVIDER_SUFFIX = '__duplicate';-const LOCAL_MODEL_LIST_PROVIDER_IDS = ['llamacpp', 'ollama', 'ods', 'lmstudio', 'osaurus', 'jan', 'vllm', 'sglang', 'localai', 'gpt4all', 'local_openai_proxy', 'unsloth'];+const LOCAL_MODEL_LIST_PROVIDER_IDS = ['llamacpp', 'ollama', 'ods', 'lmstudio', 'osaurus', 'jan', 'vllm', 'sglang', 'localai', 'gpt4all', 'local_openai_proxy', 'unsloth', 'freebuff2api'];const WEBBRAIN_CLOUD_CONTEXT_WINDOW = 1000000;const WEBBRAIN_CLOUD_LEGACY_CONTEXT_WINDOW = 256000;const WEBBRAIN_DEVICE_GUID_KEY = 'webbrainDeviceGuid';diff --git a/src/firefox/src/providers/provider-catalog.js b/src/firefox/src/providers/provider-catalog.jsindex 3f92e3bbf..a2014ac2e 100644--- a/src/firefox/src/providers/provider-catalog.js+++ b/src/firefox/src/providers/provider-catalog.js@@ -82,6 +82,7 @@ const PROVIDERS = [provider('drun', 'D.Run (China)', 'https://chat.d.run/v1', 'public/deepseek-v3', 131072, { apiKeyUrl: 'https://www.d.run', inputCostPerMillionUsd: 0.28, outputCostPerMillionUsd: 1.1 }),provider('evroc', 'evroc', 'https://models.think.evroc.com/v1', 'moonshotai/Kimi-K2.6', 262144, { apiKeyUrl: 'https://docs.evroc.com/products/think/overview.html', supportsVision: true, inputCostPerMillionUsd: 1.4375, outputCostPerMillionUsd: 5.75 }),provider('fastrouter', 'FastRouter', 'https://go.fastrouter.ai/api/v1', 'moonshotai/kimi-k2', 131072, { apiKeyUrl: 'https://fastrouter.ai/models', inputCostPerMillionUsd: 0.55, outputCostPerMillionUsd: 2.2 }),+ provider('freebuff2api', 'Freebuff2API (Local)', 'http://127.0.0.1:8080/v1', '', 16384, { category: 'local', apiKeyUrl: 'https://github.com/Quorinex/Freebuff2API', requiresModel: true, apiKeyPlaceholder: 'Optional proxy API key' }),provider('friendli', 'Friendli', 'https://api.friendli.ai/serverless/v1', 'google/gemma-4-31B-it', 262144, { apiKeyUrl: 'https://friendli.ai/docs/guides/serverless_endpoints/introduction', supportsVision: true, inputCostPerMillionUsd: 0.14, outputCostPerMillionUsd: 0.4 }),provider('google-vertex', 'Google Vertex AI', 'https://{vertex_endpoint}/v1/projects/{project}/locations/{location}/endpoints/openapi', 'gemini-3.7-flash', 1048576, { category: 'cloud', apiKeyUrl: 'https://console.cloud.google.com/apis/credentials', apiKeyHeader: 'x-goog-api-key', project: '', location: 'us-central1', supportsVision: true, apiKeyPlaceholder: 'Google authorization key', suggestions: ['gemini-3.1-pro', 'gemini-3.7-flash', 'gemini-3.6-flash', 'gemini-3.5-flash'] }),provider('google-vertex-anthropic', 'Google Vertex AI (Anthropic)', 'https://{vertex_endpoint}', 'claude-sonnet-5', 1000000, { category: 'cloud', type: 'vertex_anthropic', apiKeyUrl: 'https://console.cloud.google.com/apis/credentials', project: '', location: 'us-east5', supportsVision: true, inputCostPerMillionUsd: 2, cacheReadCostPerMillionUsd: 0.2, cacheWriteCostPerMillionUsd: 2.5, outputCostPerMillionUsd: 10, apiKeyPlaceholder: 'Google authorization key', suggestions: ['claude-opus-5', 'claude-sonnet-5', 'claude-haiku-4-5@20251001'] }),diff --git a/test/provider-catalog-integrations.mjs b/test/provider-catalog-integrations.mjsnew file mode 100644index 000000000..eb589b95b--- /dev/null+++ b/test/provider-catalog-integrations.mjs@@ -0,0 +1,36 @@+import { strict as assert } from 'node:assert';+import fs from 'node:fs';+import path from 'node:path';+import { fileURLToPath, pathToFileURL } from 'node:url';++const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');++for (const browser of ['chrome', 'firefox']) {+ const prefix = path.join(ROOT, 'src', browser, 'src');+ const { ADDITIONAL_PROVIDER_DEFAULTS, ADDITIONAL_PROVIDER_UI } = await import(+ pathToFileURL(path.join(prefix, 'providers', 'provider-catalog.js')).href+ );++ const ioNet = ADDITIONAL_PROVIDER_DEFAULTS['io-net'];+ assert.equal(ioNet.type, 'openai', `${browser}: IO.NET must use the OpenAI-compatible adapter`);+ assert.equal(ioNet.baseUrl, 'https://api.intelligence.io.solutions/api/v1', `${browser}: IO.NET endpoint changed`);+ assert.ok(ioNet.model, `${browser}: IO.NET needs a default model`);++ const synthetic = ADDITIONAL_PROVIDER_DEFAULTS.synthetic;+ assert.equal(synthetic.type, 'openai', `${browser}: Synthetic must use the OpenAI-compatible adapter`);+ assert.equal(synthetic.baseUrl, 'https://api.synthetic.new/openai/v1', `${browser}: Synthetic endpoint changed`);+ assert.ok(synthetic.model, `${browser}: Synthetic needs a default model`);++ const freebuff = ADDITIONAL_PROVIDER_DEFAULTS.freebuff2api;+ assert.equal(freebuff.type, 'openai', `${browser}: Freebuff2API must use the OpenAI-compatible adapter`);+ assert.equal(freebuff.category, 'local', `${browser}: Freebuff2API must be a local proxy card`);+ assert.equal(freebuff.baseUrl, 'http://127.0.0.1:8080/v1', `${browser}: Freebuff2API default endpoint changed`);+ assert.equal(freebuff.requiresModel, true, `${browser}: Freebuff2API must require a selected model`);+ assert.equal(freebuff.requiresApiKey, undefined, `${browser}: Freebuff2API API key must remain optional`);+ assert.equal(ADDITIONAL_PROVIDER_UI.freebuff2api.apiKeyPlaceholder, 'Optional proxy API key', `${browser}: Freebuff2API API key hint changed`);++ const manager = fs.readFileSync(path.join(prefix, 'providers', 'manager.js'), 'utf8');+ assert.match(manager, /LOCAL_MODEL_LIST_PROVIDER_IDS = \[[^\]]*'freebuff2api'/, `${browser}: Freebuff2API model discovery is not enabled`);+}++console.log('provider catalog integration tests passed');