@velum-labs/routekit-gateway 0.9.5 → 0.9.6

package/dist/adapters/cursor.d.ts

@@ -22,6 +22,24 @@ type JsonObject = Record<string, unknown>;
  * job; the translation itself stays total.
  */
 export declare function isCursorChatBody(body: unknown): body is JsonObject;
+/**
+ * Spell a namespaced model id the way Cursor's custom-model settings accept
+ * it. Cursor rejects ids containing "/" ("Model name is not valid"), so the
+ * cursor route advertises and answers to a dash-separated spelling
+ * (`claude-code/claude-fable-5` -> `claude-code-claude-fable-5`). Dashes are
+ * preferred over dots because dotted names can collide with Cursor's managed
+ * model catalog.
+ */
+export declare function cursorModelAliasId(id: string): string;
+/**
+ * Resolve Cursor's dash-separated spelling back to a served namespaced id.
+ *
+ * Resolution is an exact lookup over the gateway's served ids rather than a
+ * separator split, because namespaces themselves contain dashes. A rewrite
+ * only happens when the model is not served as spelled; if two served ids
+ * produce the same alias, the first one listed wins.
+ */
+export declare function resolveCursorModelAlias(model: unknown, servedIds: readonly string[]): string | undefined;
 /**
  * Map a Cursor BYOK request body onto a Chat Completions body.
  *

package/dist/adapters/cursor.js

@@ -40,6 +40,31 @@ function isObject(value) {
 export function isCursorChatBody(body) {
     return isObject(body) && ("messages" in body || "input" in body);
 }
+/**
+ * Spell a namespaced model id the way Cursor's custom-model settings accept
+ * it. Cursor rejects ids containing "/" ("Model name is not valid"), so the
+ * cursor route advertises and answers to a dash-separated spelling
+ * (`claude-code/claude-fable-5` -> `claude-code-claude-fable-5`). Dashes are
+ * preferred over dots because dotted names can collide with Cursor's managed
+ * model catalog.
+ */
+export function cursorModelAliasId(id) {
+    return id.replace("/", "-");
+}
+/**
+ * Resolve Cursor's dash-separated spelling back to a served namespaced id.
+ *
+ * Resolution is an exact lookup over the gateway's served ids rather than a
+ * separator split, because namespaces themselves contain dashes. A rewrite
+ * only happens when the model is not served as spelled; if two served ids
+ * produce the same alias, the first one listed wins.
+ */
+export function resolveCursorModelAlias(model, servedIds) {
+    if (typeof model !== "string" || model.length === 0 || servedIds.includes(model)) {
+        return undefined;
+    }
+    return servedIds.find((id) => id.includes("/") && cursorModelAliasId(id) === model);
+}
 /**
  * Map a Cursor BYOK request body onto a Chat Completions body.
  *

package/dist/server.js

@@ -4,7 +4,7 @@ import { ProviderFailureError } from "@velum-labs/routekit-contracts";
 import { anthropicModelsResponse, handleAnthropicMessages, handleCountTokens, resolveClaudeModelAlias } from "./adapters/anthropic.js";
 import { effectiveModel, isStream, withDefaultModel } from "./adapters/chat.js";
 import { authorizedRequest } from "./auth.js";
-import { isCursorChatBody, translateCursorRequest } from "./adapters/cursor.js";
+import { cursorModelAliasId, isCursorChatBody, resolveCursorModelAlias, translateCursorRequest } from "./adapters/cursor.js";
 import { handleResponses } from "./adapters/responses.js";
 import { validateAnthropicRequest, validateChatRequest, validateCountTokensRequest, validateResponsesRequest } from "./adapters/validate.js";
 import { buildModelCallRecord, MODEL_CALL_ID_HEADER, modelCallId } from "./provenance.js";
@@ -273,9 +273,22 @@ export async function startGateway(options) {
             return;
         }
         // Cursor may probe the models list relative to its BYOK base URL
-        // (`.../v1/cursor`); mirror /v1/models there.
+        // (`.../v1/cursor`); mirror /v1/models there. Namespaced ids are respelled
+        // with dashes because Cursor's custom-model settings reject "/" in names;
+        // the chat route below resolves the dashed spelling back.
         if (method === "GET" && path === "/v1/cursor/models") {
-            await pipeUpstream(res, await backend.models());
+            const upstream = await backend.models();
+            if (!upstream.ok) {
+                await pipeUpstream(res, upstream);
+                return;
+            }
+            const payload = (await upstream.json());
+            writeJson(res, 200, {
+                ...payload,
+                data: (payload.data ?? []).map((entry) => typeof entry.id === "string"
+                    ? { ...entry, id: cursorModelAliasId(entry.id) }
+                    : entry)
+            });
             return;
         }
         // Anthropic single-model retrieve (`GET /v1/models/{id}`): Claude Code probes
@@ -349,6 +362,9 @@ export async function startGateway(options) {
             const translated = translateCursorRequest(raw);
             if (rejectInvalid(res, validateChatRequest(translated)))
                 return;
+            const aliased = resolveCursorModelAlias(translated.model, backend.listModelIds?.() ?? []);
+            if (aliased !== undefined)
+                translated.model = aliased;
             const body = withDefaultModel(translated, backend.defaultModel);
             await handleModelCall(res, provenance, {
                 dialect: "openai-chat",

package/dist/test/cursor.test.js

@@ -1,6 +1,6 @@
 import assert from "node:assert/strict";
 import { test } from "node:test";
-import { isCursorChatBody, translateCursorRequest } from "../adapters/cursor.js";
+import { cursorModelAliasId, isCursorChatBody, resolveCursorModelAlias, translateCursorRequest } from "../adapters/cursor.js";
 import { startGateway } from "../server.js";
 const cursorBody = {
     model: "route-primary",
@@ -47,6 +47,18 @@ test("Cursor hybrid requests translate to chat messages and tools", () => {
     ]);
     assert.equal(translated.tools[0]?.function.name, "read_file");
 });
+test("Cursor model aliases respell namespaced ids with dashes", () => {
+    assert.equal(cursorModelAliasId("claude-code/claude-fable-5"), "claude-code-claude-fable-5");
+    assert.equal(cursorModelAliasId("openai/gpt-4o"), "openai-gpt-4o");
+    assert.equal(cursorModelAliasId("route-primary"), "route-primary");
+    const served = ["claude-code/claude-fable-5", "openai/gpt-4o", "route-primary"];
+    assert.equal(resolveCursorModelAlias("claude-code-claude-fable-5", served), "claude-code/claude-fable-5");
+    assert.equal(resolveCursorModelAlias("openai-gpt-4o", served), "openai/gpt-4o");
+    // Served-as-spelled ids and unknown names never rewrite.
+    assert.equal(resolveCursorModelAlias("route-primary", served), undefined);
+    assert.equal(resolveCursorModelAlias("claude-fable-5", served), undefined);
+    assert.equal(resolveCursorModelAlias(undefined, served), undefined);
+});
 test("Cursor hybrid detection rejects unrelated bodies", () => {
     assert.equal(isCursorChatBody({ input: "hello" }), true);
     assert.equal(isCursorChatBody({ messages: [] }), true);
@@ -98,3 +110,53 @@ test("RouteKit serves the Cursor hybrid through its neutral HTTP boundary", asyn
         await gateway.close();
     }
 });
+test("Cursor route resolves dashed model aliases to namespaced ids", async () => {
+    let received;
+    const backend = {
+        defaultModel: "claude-code/claude-fable-5",
+        chat(body) {
+            received = body;
+            return Promise.resolve(Response.json({
+                id: "chatcmpl_2",
+                object: "chat.completion",
+                model: "claude-code/claude-fable-5",
+                choices: [
+                    {
+                        index: 0,
+                        message: { role: "assistant", content: "done" },
+                        finish_reason: "stop"
+                    }
+                ]
+            }));
+        },
+        models: () => Promise.resolve(Response.json({
+            object: "list",
+            data: [
+                { id: "claude-code/claude-fable-5", object: "model" },
+                { id: "openai/gpt-4o", object: "model" }
+            ]
+        })),
+        listModelIds: () => ["claude-code/claude-fable-5", "openai/gpt-4o"],
+        embeddings: () => Promise.resolve(new Response(null, { status: 501 }))
+    };
+    const gateway = await startGateway({ backend });
+    try {
+        const response = await fetch(`${gateway.url()}/v1/cursor/chat/completions`, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({
+                model: "claude-code-claude-fable-5",
+                messages: [{ role: "user", content: "hi" }]
+            })
+        });
+        assert.equal(response.status, 200);
+        assert.equal(received?.model, "claude-code/claude-fable-5");
+        // The models mirror advertises the dashed spelling Cursor accepts.
+        const models = await fetch(`${gateway.url()}/v1/cursor/models`);
+        assert.equal(models.status, 200);
+        assert.deepEqual((await models.json()).data.map((model) => model.id), ["claude-code-claude-fable-5", "openai-gpt-4o"]);
+    }
+    finally {
+        await gateway.close();
+    }
+});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@velum-labs/routekit-gateway",
   "private": false,
-  "version": "0.9.5",
+  "version": "0.9.6",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/velum-labs/handoffkit.git",
@@ -27,10 +27,10 @@
   },
   "dependencies": {
     "zod": "4.4.3",
-    "@velum-labs/routekit-contracts": "0.9.5",
-    "@velum-labs/routekit-tracing": "0.9.5",
-    "@velum-labs/routekit-runtime": "0.9.5",
-    "@velum-labs/routekit-registry": "0.9.5"
+    "@velum-labs/routekit-contracts": "0.9.6",
+    "@velum-labs/routekit-registry": "0.9.6",
+    "@velum-labs/routekit-runtime": "0.9.6",
+    "@velum-labs/routekit-tracing": "0.9.6"
   },
   "keywords": [
     "routekit",