Skip to content

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.example
index 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 characters
diff --git a/apps/server/src/engine/tanstack-agent.ts b/apps/server/src/engine/tanstack-agent.ts
index 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.ts
new file mode 100644
index 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;
+ }
+});