@velum-labs/routekit-tool-cursor 0.16.4 → 0.16.6

package/dist/launch.d.ts

@@ -1,7 +1,7 @@
 import type { ToolLaunchContext } from "@velum-labs/routekit-tools";
 /** Base URL for Cursor's "Override OpenAI Base URL" setting. */
 export declare function cursorByokBaseUrl(gatewayUrl: string): string;
-export declare function cursorInstructions(gatewayUrl: string, model: string, apiKey?: string): string;
+export declare function cursorInstructions(gatewayUrl: string, model: string, apiKey?: string, reasoning?: ToolLaunchContext["spec"]["reasoning"]): string;
 /**
  * Print the endpoint Cursor must be pointed at, then return.
  *

package/dist/launch.js

@@ -1,21 +1,28 @@
-import { cursorModelName } from "@velum-labs/routekit-contracts";
+import { cursorModelName, EFFORT_QUALIFIED_MODEL_CODEC, effortQualifiedClientModel } from "@velum-labs/routekit-contracts";
 import { normalizeApiBaseUrl } from "@velum-labs/routekit-runtime";
 import { scaffoldCursorSubagents } from "./subagents.js";
 /** Base URL for Cursor's "Override OpenAI Base URL" setting. */
 export function cursorByokBaseUrl(gatewayUrl) {
     return `${normalizeApiBaseUrl(gatewayUrl)}/cursor`;
 }
-export function cursorInstructions(gatewayUrl, model, apiKey) {
+export function cursorInstructions(gatewayUrl, model, apiKey, reasoning) {
     // Cursor routes BYOK by model-name prefix (`claude-*` → Anthropic,
     // `gemini-*` → Google). The gateway's /v1/cursor mirror namespaces every
     // id under `routekit/` so the pasted name always uses the OpenAI key +
-    // base-URL override.
+    // base-URL override. Effort selections use the same `<base>:<effort>`
+    // spelling advertised by `/v1/cursor/models`.
+    const modelName = effortQualifiedClientModel(cursorModelName(model), reasoning, EFFORT_QUALIFIED_MODEL_CODEC);
     return [
         "In Cursor Settings -> Models, enable Override OpenAI Base URL and set:",
         `  Override OpenAI Base URL : ${cursorByokBaseUrl(gatewayUrl)}`,
-        `  Model name               : ${cursorModelName(model)}`,
+        `  Model name               : ${modelName}`,
         `  OpenAI API Key           : ${apiKey ?? "routekit-local"}`,
-        "Names are namespaced under routekit/ so Cursor does not route them to Anthropic/Google keys."
+        "Names are namespaced under routekit/ so Cursor does not route them to Anthropic/Google keys.",
+        ...(reasoning?.mode === "effort"
+            ? [
+                `Effort "${reasoning.effort}" is encoded in the model name; select this exact id in Cursor.`
+            ]
+            : [])
     ].join("\n");
 }
 /**
@@ -30,7 +37,7 @@ export async function launchCursor(ctx) {
     if (profiles.length > 0) {
         scaffoldCursorSubagents(ctx.spec.cwd ?? process.cwd(), profiles, ctx.log);
     }
-    ctx.log(cursorInstructions(ctx.spec.publicUrl ?? ctx.spec.gatewayUrl, ctx.spec.defaultModel, ctx.spec.auth?.token));
+    ctx.log(cursorInstructions(ctx.spec.publicUrl ?? ctx.spec.gatewayUrl, ctx.spec.defaultModel, ctx.spec.auth?.token, ctx.spec.reasoning));
     ctx.log("The gateway keeps serving this endpoint; Cursor connects on its own.");
     return 0;
 }

package/dist/test/launch.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/launch.test.js

@@ -0,0 +1,14 @@
+import assert from "node:assert/strict";
+import { test } from "node:test";
+import { cursorInstructions } from "../launch.js";
+test("Cursor setup instructions encode selected effort in the model name", () => {
+    assert.match(cursorInstructions("http://127.0.0.1:8080", "openai/gpt-5.5"), /Model name\s+: routekit\/openai\/gpt-5\.5\n/);
+    assert.match(cursorInstructions("http://127.0.0.1:8080", "openai/gpt-5.5", "token", {
+        mode: "effort",
+        effort: "high"
+    }), /Model name\s+: routekit\/openai\/gpt-5\.5:high\n/);
+    assert.match(cursorInstructions("http://127.0.0.1:8080", "openai/gpt-5.5", "token", {
+        mode: "effort",
+        effort: "high"
+    }), /Effort "high" is encoded in the model name/);
+});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@velum-labs/routekit-tool-cursor",
   "private": false,
-  "version": "0.16.4",
+  "version": "0.16.6",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/velum-labs/routekit.git",
@@ -28,10 +28,10 @@
   "dependencies": {
     "@zed-industries/agent-client-protocol": "0.4.5",
     "zod": "4.4.3",
-    "@velum-labs/routekit-contracts": "0.16.4",
-    "@velum-labs/routekit-harness-core": "0.16.4",
-    "@velum-labs/routekit-runtime": "0.16.4",
-    "@velum-labs/routekit-tools": "0.16.4"
+    "@velum-labs/routekit-contracts": "0.16.6",
+    "@velum-labs/routekit-harness-core": "0.16.6",
+    "@velum-labs/routekit-runtime": "0.16.6",
+    "@velum-labs/routekit-tools": "0.16.6"
   },
   "keywords": [
     "llm",