@velum-labs/routekit-gateway 0.9.6 → 0.9.7

package/dist/adapters/cursor.js

@@ -49,7 +49,7 @@ export function isCursorChatBody(body) {
  * model catalog.
  */
 export function cursorModelAliasId(id) {
-    return id.replace("/", "-");
+    return id.replaceAll("/", "-");
 }
 /**
  * Resolve Cursor's dash-separated spelling back to a served namespaced id.

package/dist/router.d.ts

@@ -94,6 +94,7 @@ export declare const routerConfigSchema: z.ZodObject<{
         }, z.core.$strict>>;
     }, z.core.$strict>;
     defaultModel: z.ZodOptional<z.ZodString>;
+    modelAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     reasoningCapabilities: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         status: z.ZodDefault<z.ZodEnum<{
             unknown: "unknown";

package/dist/router.js

@@ -96,6 +96,7 @@ export const routerConfigSchema = z
     })
         .strict(),
     defaultModel: z.string().min(3).optional(),
+    modelAliases: z.record(z.string().min(1), z.string().min(3)).optional(),
     reasoningCapabilities: z
         .record(z.string().min(3), reasoningCapabilityOverrideSchema)
         .optional()
@@ -143,6 +144,15 @@ export function parseRouterConfig(value) {
             throw new Error(`default model provider "${selected.provider}" is not configured`);
         }
     }
+    for (const [alias, target] of Object.entries(config.modelAliases ?? {})) {
+        if (alias.includes("/")) {
+            throw new Error(`model alias "${alias}" must not contain "/"; aliases exist to give namespaced models slash-free names`);
+        }
+        const selected = splitNamespacedModel(target);
+        if (config.providers[selected.provider] === undefined) {
+            throw new Error(`model alias "${alias}" targets "${target}" but provider "${selected.provider}" is not configured`);
+        }
+    }
     return config;
 }
 function routeBilling(provider) {
@@ -236,6 +246,16 @@ export class CatalogBackend {
                     });
                 }
             }
+            for (const [alias, target] of Object.entries(config.modelAliases ?? {})) {
+                const entry = entries.get(target);
+                if (entry === undefined) {
+                    throw new Error(`model alias "${alias}" targets "${target}", which no configured provider serves`);
+                }
+                if (entries.has(alias)) {
+                    throw new Error(`model alias "${alias}" collides with a served model id`);
+                }
+                entries.set(alias, { ...entry, publicId: alias });
+            }
             const first = entries.keys().next().value;
             const defaultModel = config.defaultModel ?? first;
             if (defaultModel === undefined) {

package/dist/test/cursor.test.js

@@ -51,7 +51,12 @@ 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");
+    assert.equal(cursorModelAliasId("openrouter/moonshotai/kimi-k2-thinking"), "openrouter-moonshotai-kimi-k2-thinking", "every slash is respelled, not just the namespace separator");
     const served = ["claude-code/claude-fable-5", "openai/gpt-4o", "route-primary"];
+    assert.equal(resolveCursorModelAlias("openrouter-moonshotai-kimi-k2-thinking", [
+        ...served,
+        "openrouter/moonshotai/kimi-k2-thinking"
+    ]), "openrouter/moonshotai/kimi-k2-thinking");
     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.

package/dist/test/router.test.js

@@ -156,6 +156,58 @@ test("catalog namespaces live models and strips the source before dispatch", asy
     });
     assert.equal(backend.modelInfo("openai/not-real"), undefined);
 });
+test("configured model aliases serve namespaced models under slash-free names", async () => {
+    const calls = [];
+    const backend = await CatalogBackend.create({
+        config: {
+            providers: { "claude-code": {} },
+            modelAliases: { "velum-fable-5": "claude-code/claude-fable-5" }
+        },
+        sources: {
+            "claude-code": fakeSource("claude-code", [{ id: "claude-fable-5" }], calls)
+        }
+    });
+    assert.deepEqual(backend.listModelIds(), [
+        "claude-code/claude-fable-5",
+        "velum-fable-5"
+    ]);
+    assert.equal(backend.servesModel("velum-fable-5"), true);
+    assert.deepEqual(backend.resolveModelRoute("velum-fable-5"), {
+        publicId: "velum-fable-5",
+        nativeId: "claude-fable-5",
+        provider: "claude-code"
+    });
+    assert.equal(backend.modelInfo("velum-fable-5")?.id, "velum-fable-5");
+    assert.equal(backend.modelInfo("velum-fable-5")?.nativeModel, "claude-fable-5");
+    await backend.chat({ model: "velum-fable-5", messages: [] });
+    assert.deepEqual(calls, [
+        { source: "claude-code", model: "claude-fable-5" }
+    ]);
+});
+test("model aliases reject bad shapes and unknown targets", async () => {
+    assert.throws(() => parseRouterConfig({
+        providers: { openai: {} },
+        modelAliases: { "bad/alias": "openai/gpt-5.5" }
+    }), /must not contain "\/"/);
+    assert.throws(() => parseRouterConfig({
+        providers: { openai: {} },
+        modelAliases: { "velum-fable-5": "claude-code/claude-fable-5" }
+    }), /provider "claude-code" is not configured/);
+    await assert.rejects(CatalogBackend.create({
+        config: {
+            providers: { openai: {} },
+            modelAliases: { "velum-gpt": "openai/not-discovered" }
+        },
+        sources: { openai: fakeSource("openai", [{ id: "gpt-5.5" }]) }
+    }), /targets "openai\/not-discovered", which no configured provider serves/);
+    await assert.rejects(CatalogBackend.create({
+        config: {
+            providers: { openai: {} },
+            modelAliases: { "openai/gpt-5.5": "openai/gpt-5.5" }
+        },
+        sources: { openai: fakeSource("openai", [{ id: "gpt-5.5" }]) }
+    }), /must not contain "\/"/);
+});
 test("model info exhaustively classifies subscription and proxy billing", async () => {
     const backend = await CatalogBackend.create({
         config: {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@velum-labs/routekit-gateway",
   "private": false,
-  "version": "0.9.6",
+  "version": "0.9.7",
   "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.6",
-    "@velum-labs/routekit-registry": "0.9.6",
-    "@velum-labs/routekit-runtime": "0.9.6",
-    "@velum-labs/routekit-tracing": "0.9.6"
+    "@velum-labs/routekit-contracts": "0.9.7",
+    "@velum-labs/routekit-tracing": "0.9.7",
+    "@velum-labs/routekit-runtime": "0.9.7",
+    "@velum-labs/routekit-registry": "0.9.7"
   },
   "keywords": [
     "routekit",