A personal agent with a browser, terminal, files, and work that keeps going built with CopilotKit and AG-UI.
TypeScript
fix: suggest the openai/ prefix for gateway model IDs (#55)
Asem ahmed064044ef666b
diff --git a/.env.example b/.env.exampleindex 2136a81..91e0668 100644--- a/.env.example+++ b/.env.example@@ -16,6 +16,7 @@ TASK_WORKER_ENABLED=true# GOOGLE_API_KEY=# Optional OpenAI-compatible Responses API endpoint:# OPENAI_BASE_URL=+# For a gateway model ID such as vendor/model, set MODEL=openai/vendor/model.# Live Google workspace: WORKSPACE_MODE=live, AGENT_BACKEND=model.# OPENMUSE_ACCESS_KEY= # random secret, at least 24 charactersdiff --git a/apps/server/src/engine/tanstack-agent.ts b/apps/server/src/engine/tanstack-agent.tsindex 8c05326..5701955 100644--- a/apps/server/src/engine/tanstack-agent.ts+++ b/apps/server/src/engine/tanstack-agent.ts@@ -47,12 +47,24 @@ function adapter(spec: string) {},});default:- throw new Error(- `Unknown provider "${provider}" in "${spec}". Supported: openai, anthropic, google (gemini).`,- );+ throw unknownProvider(provider, spec);}}+/** With OPENAI_BASE_URL set, a gateway model ID most likely needs the openai/ prefix. */+export function unknownProvider(+ provider: string,+ spec: string,+ baseUrl = process.env.OPENAI_BASE_URL,+) {+ const hint = baseUrl?.trim()+ ? ` For a model on your OPENAI_BASE_URL gateway, use "openai/${spec.trim()}".`+ : "";+ return new Error(+ `Unknown provider "${provider}" in "${spec}". Supported: openai, anthropic, google (gemini).${hint}`,+ );+}+// The classic BuiltInAgent always offers these two state tools. The converter turns their// results into STATE_SNAPSHOT / STATE_DELTA events.const stateTools = [diff --git a/tests/model-provider.test.ts b/tests/model-provider.test.tsnew file mode 100644index 0000000..24ec3e3--- /dev/null+++ b/tests/model-provider.test.ts@@ -0,0 +1,30 @@+import assert from "node:assert/strict";+import { test } from "node:test";+import { unknownProvider } from "../apps/server/src/engine/tanstack-agent.ts";++const spec = "deepseek/deepseek-v4.1-flash";++test("an unknown provider suggests the openai/ prefix only when a gateway is set", () => {+ const gateway = unknownProvider("deepseek", spec, "https://gateway.test/v1");+ assert.match(+ gateway.message,+ /^Unknown provider "deepseek" in "deepseek\/deepseek-v4.1-flash"\./,+ );+ assert.match(gateway.message, /use "openai\/deepseek\/deepseek-v4.1-flash"\.$/);++ for (const baseUrl of ["", " "])+ assert.doesNotMatch(unknownProvider("deepseek", spec, baseUrl).message, /openai\//);+});++test("the unknown provider hint reads OPENAI_BASE_URL by default", () => {+ const previous = process.env.OPENAI_BASE_URL;+ try {+ delete process.env.OPENAI_BASE_URL;+ assert.doesNotMatch(unknownProvider("deepseek", spec).message, /openai\//);+ process.env.OPENAI_BASE_URL = "https://gateway.test/v1";+ assert.match(unknownProvider("deepseek", spec).message, /use "openai\//);+ } finally {+ if (previous === undefined) delete process.env.OPENAI_BASE_URL;+ else process.env.OPENAI_BASE_URL = previous;+ }+});