npm - @bitkyc08/opencodex - Versions diffs - 2.6.17 → 2.6.18 - Mend

@bitkyc08/opencodex 2.6.17 → 2.6.18

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (84) hide show

package/README.md +9 -0
package/bin/ocx.mjs +70 -5
package/gui/dist/assets/index-DDcEW0Cm.css +1 -0
package/gui/dist/assets/index-DbTEyo46.js +9 -0
package/gui/dist/index.html +2 -2
package/package.json +3 -1
package/src/adapters/anthropic.ts +9 -2
package/src/adapters/base.ts +6 -0
package/src/adapters/cursor/arg-codec.ts +38 -0
package/src/adapters/cursor/arg-normalize.ts +88 -0
package/src/adapters/cursor/cursor-errors.ts +85 -0
package/src/adapters/cursor/discovery.ts +144 -0
package/src/adapters/cursor/effort-map.ts +74 -0
package/src/adapters/cursor/exec-policy.ts +44 -0
package/src/adapters/cursor/framing.ts +136 -0
package/src/adapters/cursor/gen/agent_pb.ts +15274 -0
package/src/adapters/cursor/kv-store.ts +25 -0
package/src/adapters/cursor/live-models.ts +93 -0
package/src/adapters/cursor/live-smoke-gate.ts +41 -0
package/src/adapters/cursor/live-transport.ts +758 -0
package/src/adapters/cursor/mcp-config.ts +42 -0
package/src/adapters/cursor/mcp-manager.ts +236 -0
package/src/adapters/cursor/message-mapper.ts +46 -0
package/src/adapters/cursor/native-exec-common.ts +55 -0
package/src/adapters/cursor/native-exec-desktop.ts +177 -0
package/src/adapters/cursor/native-exec-fs.ts +284 -0
package/src/adapters/cursor/native-exec-mcp.ts +151 -0
package/src/adapters/cursor/native-exec-network.ts +32 -0
package/src/adapters/cursor/native-exec-shell.ts +191 -0
package/src/adapters/cursor/native-exec-tools.ts +118 -0
package/src/adapters/cursor/native-exec.ts +177 -0
package/src/adapters/cursor/protobuf-events.ts +309 -0
package/src/adapters/cursor/protobuf-request.ts +347 -0
package/src/adapters/cursor/request-builder.ts +98 -0
package/src/adapters/cursor/tool-definitions.ts +301 -0
package/src/adapters/cursor/transport-retry.ts +116 -0
package/src/adapters/cursor/transport.ts +47 -0
package/src/adapters/cursor/types.ts +36 -0
package/src/adapters/cursor.ts +99 -0
package/src/adapters/google.ts +7 -1
package/src/adapters/kiro.ts +15 -0
package/src/adapters/openai-chat.ts +7 -2
package/src/adapters/run-turn-queue.ts +58 -0
package/src/adapters/tool-catalog-nudge.ts +71 -0
package/src/bridge.ts +7 -1
package/src/cli-help.ts +9 -2
package/src/cli-status.ts +7 -5
package/src/cli.ts +122 -79
package/src/codex-catalog.ts +213 -71
package/src/codex-history-provider.ts +31 -14
package/src/codex-inject.ts +17 -9
package/src/codex-paths.ts +2 -1
package/src/codex-shim.ts +30 -7
package/src/codex-sync.ts +70 -0
package/src/config.ts +58 -2
package/src/doctor.ts +4 -2
package/src/index.ts +1 -0
package/src/model-cache.ts +22 -2
package/src/oauth/callback-server.ts +44 -16
package/src/oauth/cursor.ts +188 -0
package/src/oauth/index.ts +29 -3
package/src/oauth/key-providers.ts +20 -33
package/src/oauth/login-cli.ts +7 -4
package/src/open-url.ts +5 -1
package/src/ports.ts +13 -0
package/src/process-control.ts +76 -0
package/src/provider-label.ts +10 -5
package/src/providers/derive.ts +30 -3
package/src/providers/registry.ts +39 -1
package/src/proxy-liveness.ts +122 -0
package/src/responses/parser.ts +1 -0
package/src/responses/state.ts +83 -0
package/src/router.ts +38 -23
package/src/server/adapter-resolve.ts +3 -0
package/src/server.ts +130 -18
package/src/service.ts +94 -32
package/src/types.ts +24 -1
package/src/update-job.ts +360 -0
package/src/update.ts +73 -11
package/src/usage-log.ts +3 -3
package/src/usage-summary.ts +3 -2
package/src/win-paths.ts +68 -0
package/gui/dist/assets/index-DIBiVVC0.css +0 -1
package/gui/dist/assets/index-DcnD944i.js +0 -9

package/gui/dist/index.html CHANGED Viewed

@@ -16,8 +16,8 @@
         } catch (e) {}
       })();
     </script>
-    <script type="module" crossorigin src="/assets/index-DcnD944i.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-DIBiVVC0.css">
+    <script type="module" crossorigin src="/assets/index-DbTEyo46.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-DDcEW0Cm.css">
   </head>
   <body>
     <div id="root"></div>

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@bitkyc08/opencodex",
-  "version": "2.6.17",
+  "version": "2.6.18",
   "description": "Universal provider proxy for OpenAI Codex — use any LLM with Codex CLI/App/SDK",
   "type": "module",
   "main": "./bin/package-main.mjs",
@@ -48,6 +48,8 @@
     "release:watch": "bun scripts/release.ts watch"
   },
   "dependencies": {
+    "@bufbuild/protobuf": "^2.12.0",
+    "@modelcontextprotocol/sdk": "^1",
     "bun": "1.3.14",
     "zod": "4.4.3"
   },

package/src/adapters/anthropic.ts CHANGED Viewed

@@ -18,6 +18,7 @@ import { ANTHROPIC_OAUTH_BETA, CLAUDE_CODE_SYSTEM_INSTRUCTION, applyClaudeToolPr
 import { parseDataUrl } from "./image";
 import { neutralizeIdentity } from "./identity";
 import { CLAUDE_CODE_HEADERS, claudeCodeSessionId } from "./client-fingerprint";
+import { buildNonOpenAIToolCatalogNudgeForTools } from "./tool-catalog-nudge";
 /** Map a user content part to an Anthropic content block (text or image source). */
 function toAnthropicContentPart(p: OcxContentPart): unknown {
@@ -140,8 +141,14 @@ function messagesToAnthropicFormat(
   parsed: OcxParsedRequest,
   toolNames: { toWire: (name: string) => string },
 ): { system: string | undefined; messages: unknown[] } {
-  const system = parsed.context.systemPrompt?.length
-    ? neutralizeIdentity(parsed.context.systemPrompt.join("\n\n")) || undefined
+  const toolCatalogNudge = buildNonOpenAIToolCatalogNudgeForTools(
+    parsed.context.tools,
+    parsed.options.toolChoice,
+    tool => toolNames.toWire(namespacedToolName(tool.namespace, tool.name)),
+  );
+  const systemParts = [...(parsed.context.systemPrompt ?? []), ...(toolCatalogNudge ? [toolCatalogNudge] : [])];
+  const system = systemParts.length
+    ? neutralizeIdentity(systemParts.join("\n\n")) || undefined
     : undefined;
   const messages: unknown[] = [];

package/src/adapters/base.ts CHANGED Viewed

@@ -3,6 +3,7 @@ import type { AdapterEvent, OcxParsedRequest } from "../types";
 /** Metadata about the caller's incoming request, for auth-forwarding adapters. */
 export interface IncomingMeta {
   headers: Headers;
+  abortSignal?: AbortSignal;
 }
 export interface ProviderAdapter {
@@ -19,6 +20,11 @@ export interface ProviderAdapter {
   parseStream(response: Response): AsyncGenerator<AdapterEvent>;
   parseResponse?(response: Response): Promise<AdapterEvent[]>;
+  runTurn?(
+    parsed: OcxParsedRequest,
+    incoming: IncomingMeta,
+    emit: (event: AdapterEvent) => void,
+  ): Promise<void>;
 }
 export interface AdapterRequest {

package/src/adapters/cursor/arg-codec.ts ADDED Viewed

@@ -0,0 +1,38 @@
+import { fromBinary, toBinary, toJson } from "@bufbuild/protobuf";
+import { ValueSchema } from "@bufbuild/protobuf/wkt";
+import { textDecoder } from "./native-exec-common";
+function parseJsonText(text: string): unknown {
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
+function sameBytes(a: Uint8Array, b: Uint8Array): boolean {
+  if (a.length !== b.length) return false;
+  for (let i = 0; i < a.length; i++) {
+    if (a[i] !== b[i]) return false;
+  }
+  return true;
+}
+export function decodeCursorArgValue(value: Uint8Array): unknown {
+  try {
+    const parsed = fromBinary(ValueSchema, value);
+    if (!sameBytes(toBinary(ValueSchema, parsed), value)) throw new Error("not canonical protobuf Value bytes");
+    const jsonValue = toJson(ValueSchema, parsed);
+    return typeof jsonValue === "string" ? parseJsonText(jsonValue) : jsonValue;
+  } catch {
+    return parseJsonText(textDecoder.decode(value));
+  }
+}
+export function decodeCursorArgsMap(args: { [key: string]: Uint8Array } | undefined): Record<string, unknown> {
+  const out: Record<string, unknown> = {};
+  for (const [key, value] of Object.entries(args ?? {})) {
+    out[key] = decodeCursorArgValue(value);
+  }
+  return out;
+}

package/src/adapters/cursor/arg-normalize.ts ADDED Viewed

@@ -0,0 +1,88 @@
+/**
+ * Schema-aware argument key normalization for Cursor tool calls.
+ *
+ * Cursor-trained models sometimes emit argument keys that differ from the tool's declared schema
+ * (e.g. `filepath` instead of `path`, `cmd` instead of `command`). This module maps common aliases
+ * to the canonical key name ONLY when the tool schema declares that canonical key. Keys already
+ * matching the schema are never touched.
+ *
+ * Derived from opencode-cursor reference (src/provider/tool-schema-compat.ts).
+ */
+const KEY_ALIASES = new Map<string, string>([
+  ["filepath", "path"],
+  ["filename", "path"],
+  ["file", "path"],
+  ["targetpath", "path"],
+  ["directorypath", "path"],
+  ["dir", "path"],
+  ["folder", "path"],
+  ["directory", "path"],
+  ["targetdirectory", "path"],
+  ["targetfile", "path"],
+  ["globpattern", "pattern"],
+  ["filepattern", "pattern"],
+  ["searchpattern", "pattern"],
+  ["includepattern", "include"],
+  ["workingdirectory", "cwd"],
+  ["workdir", "cwd"],
+  ["currentdirectory", "cwd"],
+  ["cmd", "command"],
+  ["script", "command"],
+  ["shellcommand", "command"],
+  ["terminalcommand", "command"],
+  ["contents", "content"],
+  ["text", "content"],
+  ["body", "content"],
+  ["data", "content"],
+  ["payload", "content"],
+  ["streamcontent", "content"],
+  ["oldstring", "old_string"],
+  ["newstring", "new_string"],
+  ["oldtext", "old_string"],
+  ["newtext", "new_string"],
+  ["oldcontent", "old_string"],
+  ["newcontent", "new_string"],
+  ["recursive", "force"],
+]);
+/**
+ * Extract the set of declared property names from a JSON Schema parameters object.
+ * Handles the common `{ type: "object", properties: { ... } }` shape.
+ */
+function schemaPropertyNames(schema: unknown): Set<string> | undefined {
+  if (!schema || typeof schema !== "object") return undefined;
+  const obj = schema as Record<string, unknown>;
+  const props = obj.properties;
+  if (!props || typeof props !== "object") return undefined;
+  return new Set(Object.keys(props as Record<string, unknown>));
+}
+/**
+ * Normalize argument keys against the tool's declared schema. Keys not in the schema that have a
+ * known alias pointing to a schema-declared key are renamed. Keys already in the schema or with no
+ * matching alias are left untouched.
+ *
+ * Returns the original object reference if no changes were needed (cheap identity check for callers).
+ */
+export function normalizeArgKeys(args: Record<string, unknown>, toolSchema: unknown): Record<string, unknown> {
+  const declared = schemaPropertyNames(toolSchema);
+  if (!declared || declared.size === 0) return args;
+  let changed = false;
+  const result: Record<string, unknown> = {};
+  for (const [key, value] of Object.entries(args)) {
+    if (declared.has(key)) {
+      result[key] = value;
+      continue;
+    }
+    const canonical = KEY_ALIASES.get(key.toLowerCase());
+    if (canonical && declared.has(canonical) && !(canonical in result)) {
+      result[canonical] = value;
+      changed = true;
+    } else {
+      result[key] = value;
+    }
+  }
+  return changed ? result : args;
+}

package/src/adapters/cursor/cursor-errors.ts ADDED Viewed

@@ -0,0 +1,85 @@
+import { redactSecretString } from "../../redact";
+const ABSOLUTE_PATH_PATTERN = /(?:\/Users\/[^ "';,]+|\/home\/[^ "';,]+|[A-Za-z]:\\Users\\[^ "';,]+)/g;
+// Cursor error messages can contain raw credential key=value pairs beyond what the shared
+// redactSecretString covers. We handle the additional transport-specific patterns locally.
+const CURSOR_CREDENTIAL_PATTERN = /\b(authorization|auth[_-]?token|cursor[_-]?token)=([^&\s"',;]+)/gi;
+function sanitize(value: string): string {
+  return redactSecretString(value)
+    .replace(CURSOR_CREDENTIAL_PATTERN, "$1=[REDACTED]")
+    .replace(ABSOLUTE_PATH_PATTERN, "[REDACTED_PATH]");
+}
+/**
+ * Classify a Cursor transport/Connect/gRPC error message into an actionable category.
+ * The returned prefix string is recognized by `src/errors.ts` `classifyError` keywords,
+ * so bridge-level error mapping produces the right Codex error type (rate_limit, auth, etc.).
+ */
+export function classifyCursorError(message: string): string {
+  const lower = message.toLowerCase();
+  if (
+    lower.includes("resource_exhausted") ||
+    lower.includes("resource exhausted") ||
+    lower.includes("rate limit") ||
+    lower.includes("rate-limit") ||
+    lower.includes("too many requests") ||
+    lower.includes("quota")
+  ) return "Cursor rate limit exceeded";
+  if (
+    lower.includes("unauthenticated") ||
+    lower.includes("unauthorized") ||
+    lower.includes("permission_denied") ||
+    lower.includes("permission denied") ||
+    lower.includes("forbidden") ||
+    lower.includes("invalid token") ||
+    lower.includes("expired token") ||
+    lower.includes("authentication") ||
+    lower.includes("access denied")
+  ) return "Cursor authentication failed";
+  if (
+    lower.includes("unavailable") ||
+    lower.includes("overloaded") ||
+    lower.includes("temporarily") ||
+    lower.includes("server is busy")
+  ) return "Cursor server overloaded";
+  if (
+    lower.includes("invalid") ||
+    lower.includes("not found") ||
+    lower.includes("unsupported") ||
+    lower.includes("malformed") ||
+    lower.includes("unimplemented")
+  ) return "Cursor invalid request";
+  if (
+    lower.includes("timed out") ||
+    lower.includes("timeout") ||
+    lower.includes("etimedout") ||
+    lower.includes("deadline")
+  ) return "Cursor request timed out";
+  if (
+    lower.includes("econnreset") ||
+    lower.includes("econnrefused") ||
+    lower.includes("goaway") ||
+    lower.includes("nghttp2") ||
+    lower.includes("socket hang up") ||
+    lower.includes("connection reset")
+  ) return "Cursor connection failed";
+  return "Cursor upstream error";
+}
+/**
+ * Produce a user-facing, secret-safe Cursor error message with an actionable category prefix.
+ * Mirrors `safeKiroErrorMessage` / `safeKiroHttpErrorMessage` in kiro-errors.ts.
+ */
+export function safeCursorErrorMessage(rawMessage: string): string {
+  const detail = sanitize(rawMessage).slice(0, 500);
+  const prefix = classifyCursorError(rawMessage);
+  return detail ? `${prefix}: ${detail}` : prefix;
+}

package/src/adapters/cursor/discovery.ts ADDED Viewed

@@ -0,0 +1,144 @@
+export interface CursorModelInfo {
+  id: string;
+  contextWindow?: number;
+  supportsReasoningEffort?: boolean;
+  inputModalities?: string[];
+}
+export const CURSOR_DEFAULT_CONTEXT_WINDOW = 128_000;
+const CURSOR_REASONING_EFFORTS = ["low", "medium", "high"] as const;
+const CURSOR_DEFAULT_INPUT_MODALITIES = ["text", "image"] as const;
+const CONTEXT_1M = 1_000_000;
+const CONTEXT_GEMINI = 1_048_576;
+const CONTEXT_272K = 272_000;
+const CONTEXT_262K = 262_144;
+const CONTEXT_256K = 256_000;
+const CONTEXT_200K = 200_000;
+export function inferCursorContextWindow(modelId: string): number {
+  const id = modelId.trim().toLowerCase();
+  if (id.includes("1m")) return CONTEXT_1M;
+  if (id.startsWith("gemini-")) return CONTEXT_1M;
+  if (id === "glm-5.2") return CONTEXT_1M;
+  if (id.startsWith("gpt-5") || id === "gpt-5-codex") return CONTEXT_272K;
+  if (id.startsWith("grok-")) return CONTEXT_256K;
+  if (id.includes("claude")) return CONTEXT_200K;
+  return CURSOR_DEFAULT_CONTEXT_WINDOW;
+}
+function normalizeInputModalities(input: string[] | undefined): string[] {
+  const values = (input ?? [...CURSOR_DEFAULT_INPUT_MODALITIES])
+    .map(item => item.trim())
+    .filter(Boolean);
+  return values.length > 0 ? [...new Set(values)] : [...CURSOR_DEFAULT_INPUT_MODALITIES];
+}
+export function normalizeCursorModels(models: readonly CursorModelInfo[]): CursorModelInfo[] {
+  const byId = new Map<string, CursorModelInfo>();
+  for (const model of models) {
+    const id = model.id.trim();
+    if (!id || byId.has(id)) continue;
+    byId.set(id, {
+      id,
+      contextWindow: typeof model.contextWindow === "number" && model.contextWindow > 0
+        ? model.contextWindow
+        : inferCursorContextWindow(id),
+      supportsReasoningEffort: model.supportsReasoningEffort === true,
+      inputModalities: normalizeInputModalities(model.inputModalities),
+    });
+  }
+  return [...byId.values()].sort((a, b) => a.id.localeCompare(b.id));
+}
+export const CURSOR_STATIC_MODELS: readonly CursorModelInfo[] = normalizeCursorModels([
+  // Context windows and the model lineup mirror Cursor's public models/pricing docs plus the jawcode
+  // SOT (../jawcode/packages/ai/src/models.json, `cursor` provider), which mirrors the real
+  // GetUsableModels catalog. Live discovery is the preferred path when logged in; these ids seed the
+  // routed Codex catalog and provide a static fallback. Cursor base ids carry no effort suffix here —
+  // the request builder appends the per-model suffix (see effort-map.ts) and reasoning models
+  // advertise effort so Codex exposes the tier picker. `supportsReasoningEffort` tracks whether the
+  // model has *selectable effort tiers* (CURSOR_MODEL_EFFORT_TIERS), NOT merely whether it reasons:
+  // gemini/grok/kimi/gpt-5-mini are reasoning models in the SOT but are sent bare (no tier picker).
+  { id: "auto", contextWindow: CONTEXT_200K, supportsReasoningEffort: false },
+  { id: "claude-sonnet-5", contextWindow: CONTEXT_200K },
+  { id: "claude-4-sonnet", contextWindow: CONTEXT_200K },
+  { id: "claude-4-sonnet-1m", contextWindow: CONTEXT_1M },
+  { id: "claude-4.5-haiku", contextWindow: CONTEXT_200K },
+  { id: "claude-4.5-sonnet", contextWindow: CONTEXT_200K },
+  { id: "claude-4.5-opus", contextWindow: CONTEXT_200K, supportsReasoningEffort: true },
+  { id: "claude-4.6-opus", contextWindow: CONTEXT_200K, supportsReasoningEffort: true },
+  { id: "claude-4.6-sonnet", contextWindow: CONTEXT_200K, supportsReasoningEffort: true },
+  { id: "claude-opus-4-7", contextWindow: CONTEXT_200K, supportsReasoningEffort: true },
+  { id: "claude-opus-4-8", contextWindow: CONTEXT_200K, supportsReasoningEffort: true },
+  { id: "claude-fable-5", contextWindow: CONTEXT_200K, supportsReasoningEffort: true },
+  { id: "composer-1", contextWindow: CONTEXT_200K },
+  { id: "composer-1.5", contextWindow: CONTEXT_200K },
+  { id: "composer-2", contextWindow: CONTEXT_200K },
+  { id: "composer-2.5", contextWindow: CONTEXT_200K },
+  { id: "composer-2.5-fast", contextWindow: CONTEXT_200K },
+  { id: "gemini-2.5-flash", contextWindow: CONTEXT_GEMINI },
+  { id: "gemini-3-flash", contextWindow: CONTEXT_GEMINI },
+  { id: "gemini-3-pro", contextWindow: CONTEXT_GEMINI },
+  { id: "gemini-3-pro-image-preview", contextWindow: CONTEXT_200K },
+  { id: "gemini-3.1-pro", contextWindow: CONTEXT_GEMINI },
+  { id: "gemini-3.5-flash", contextWindow: CONTEXT_200K },
+  { id: "gpt-5-codex", contextWindow: CONTEXT_272K },
+  { id: "gpt-5-fast", contextWindow: CONTEXT_272K },
+  { id: "gpt-5-mini", contextWindow: CONTEXT_272K },
+  { id: "gpt-5.1", contextWindow: CONTEXT_272K, supportsReasoningEffort: true },
+  { id: "gpt-5.1-codex", contextWindow: CONTEXT_272K },
+  { id: "gpt-5.1-codex-max", contextWindow: CONTEXT_272K, supportsReasoningEffort: true },
+  { id: "gpt-5.1-codex-mini", contextWindow: CONTEXT_272K, supportsReasoningEffort: true },
+  { id: "gpt-5.2", contextWindow: CONTEXT_272K, supportsReasoningEffort: true },
+  { id: "gpt-5.2-codex", contextWindow: CONTEXT_272K, supportsReasoningEffort: true },
+  { id: "gpt-5.3-codex", contextWindow: CONTEXT_272K, supportsReasoningEffort: true },
+  { id: "gpt-5.4", contextWindow: CONTEXT_272K, supportsReasoningEffort: true },
+  { id: "gpt-5.4-mini", contextWindow: CONTEXT_272K, supportsReasoningEffort: true },
+  { id: "gpt-5.4-nano", contextWindow: CONTEXT_272K, supportsReasoningEffort: true },
+  { id: "gpt-5.5", contextWindow: CONTEXT_272K, supportsReasoningEffort: true },
+  { id: "gpt-5.5-extra", contextWindow: CONTEXT_200K, supportsReasoningEffort: true },
+  { id: "grok-4.3", contextWindow: CONTEXT_200K, supportsReasoningEffort: true },
+  { id: "grok-4.20", contextWindow: CONTEXT_200K, supportsReasoningEffort: true },
+  { id: "grok-build-0.1", contextWindow: CONTEXT_256K },
+  { id: "grok-code-fast-1", contextWindow: CONTEXT_256K },
+  { id: "glm-5.2", contextWindow: CONTEXT_200K },
+  { id: "kimi-k2.5", contextWindow: CONTEXT_262K },
+]);
+export function cursorModelIds(models: readonly CursorModelInfo[] = CURSOR_STATIC_MODELS): string[] {
+  return normalizeCursorModels(models).map(model => model.id);
+}
+export function cursorModelContextWindows(
+  models: readonly CursorModelInfo[] = CURSOR_STATIC_MODELS,
+): Record<string, number> {
+  return Object.fromEntries(
+    normalizeCursorModels(models).map(model => [model.id, model.contextWindow ?? inferCursorContextWindow(model.id)]),
+  );
+}
+export function cursorModelInputModalities(
+  models: readonly CursorModelInfo[] = CURSOR_STATIC_MODELS,
+): Record<string, string[]> {
+  return Object.fromEntries(
+    normalizeCursorModels(models).map(model => [model.id, normalizeInputModalities(model.inputModalities)]),
+  );
+}
+export function cursorModelReasoningEfforts(
+  models: readonly CursorModelInfo[] = CURSOR_STATIC_MODELS,
+): Record<string, string[]> {
+  return Object.fromEntries(
+    normalizeCursorModels(models).map(model => [
+      model.id,
+      model.supportsReasoningEffort === true ? [...CURSOR_REASONING_EFFORTS] : [],
+    ]),
+  );
+}

package/src/adapters/cursor/effort-map.ts ADDED Viewed

@@ -0,0 +1,74 @@
+/**
+ * Per-model Cursor reasoning-effort mapping.
+ *
+ * Cursor model ids encode the reasoning effort as a suffix (`claude-4.6-opus-high`), and the available
+ * tiers differ per model — `claude-4.6-opus` tops out at `-max`, `claude-opus-4-8` at `-xhigh`,
+ * `claude-4.6-sonnet` only has `-medium`, and `composer`/`grok`/`gemini` take no suffix at all. A bare
+ * id for a model that requires a suffix is rejected `ERROR_BAD_MODEL_NAME` (devlog 350.105).
+ *
+ * `CURSOR_MODEL_EFFORT_TIERS` is the real catalog (from the Cursor `GetUsableModels` naming, mirrored in
+ * jawcode's bundle), each base model -> its available suffixes in ascending order. `cursorEffortSuffix`
+ * clamps a Codex reasoning effort onto that model's tiers so Codex's TOP effort maps to the model's TOP
+ * tier (a `-max` model -> max, an `-xhigh` model -> xhigh), per the requested behavior.
+ */
+const CURSOR_MODEL_EFFORT_TIERS: Record<string, readonly string[]> = {
+  "claude-4.5-opus": ["high"],
+  "claude-4.6-opus": ["high", "max"],
+  "claude-4.6-sonnet": ["medium"],
+  "claude-fable-5": ["low", "medium", "high", "max", "xhigh"],
+  "claude-opus-4-7": ["low", "medium", "high", "max", "xhigh"],
+  "claude-opus-4-8": ["low", "medium", "high", "max", "xhigh"],
+  "gpt-5.1": ["low", "high"],
+  "gpt-5.1-codex-max": ["low", "medium", "high", "xhigh"],
+  "gpt-5.1-codex-mini": ["low", "high"],
+  "gpt-5.2": ["low", "high", "xhigh"],
+  "gpt-5.2-codex": ["low", "high", "xhigh"],
+  "gpt-5.3-codex": ["low", "high", "xhigh"],
+  "gpt-5.4": ["low", "medium", "high", "xhigh"],
+  "gpt-5.4-mini": ["low", "medium", "high", "xhigh"],
+  "gpt-5.4-nano": ["low", "medium", "high", "xhigh"],
+  "gpt-5.5": ["low", "medium", "high"],
+  "gpt-5.5-extra": ["high"],
+};
+/** Collapse a Codex reasoning-effort label to a low/medium/high rank for clamping onto a model's tiers. */
+function codexEffortRank(reasoning: string | undefined): "low" | "medium" | "high" {
+  switch ((reasoning ?? "").toLowerCase()) {
+    case "none":
+    case "minimal":
+    case "low":
+      return "low";
+    case "medium":
+      return "medium";
+    case "high":
+    case "max":
+    case "xhigh":
+      return "high";
+    default:
+      // No explicit effort: a bare reasoning-model id is invalid, so pick the model's top tier.
+      return "high";
+  }
+}
+/**
+ * The Cursor effort suffix to use for `baseModelId` given a Codex reasoning effort, or `undefined` when
+ * the model takes no suffix (bare). Codex's top effort maps to the model's top tier (max / xhigh).
+ */
+export function cursorEffortSuffix(baseModelId: string, reasoning: string | undefined): string | undefined {
+  const tiers = CURSOR_MODEL_EFFORT_TIERS[baseModelId];
+  if (!tiers || tiers.length === 0) return undefined;
+  switch (codexEffortRank(reasoning)) {
+    case "low":
+      return tiers[0];
+    case "high":
+      return tiers[tiers.length - 1];
+    case "medium":
+      return tiers[Math.floor((tiers.length - 1) / 2)];
+  }
+}
+/** Base models known to carry a reasoning-effort suffix (everything else is sent bare). */
+export function cursorModelHasEffortTiers(baseModelId: string): boolean {
+  return (CURSOR_MODEL_EFFORT_TIERS[baseModelId]?.length ?? 0) > 0;
+}

package/src/adapters/cursor/exec-policy.ts ADDED Viewed

@@ -0,0 +1,44 @@
+import type { CursorClientMessage } from "./types";
+export const CURSOR_EXEC_CASES_DENIED = [
+  "readArgs",
+  "lsArgs",
+  "grepArgs",
+  "writeArgs",
+  "deleteArgs",
+  "shellArgs",
+  "shellStreamArgs",
+  "diagnosticsArgs",
+  "mcpArgs",
+  "fetchArgs",
+  "recordScreenArgs",
+  "computerUseArgs",
+  "unknownExecCase",
+] as const;
+export type CursorDeniedExecCase = (typeof CURSOR_EXEC_CASES_DENIED)[number];
+export function cursorExecDeniedMessage(execCase: string): string {
+  return [
+    `Cursor legacy mock transport cannot execute ${execCase}.`,
+    "Production Cursor requests use the live protobuf native exec bridge.",
+    "The legacy mock path returns a non-executing placeholder for tests only.",
+  ].join(" ");
+}
+export function cursorExecResult(requestId: string, execCase: string): CursorClientMessage {
+  if (execCase === "requestContextArgs") {
+    return {
+      type: "exec_result",
+      requestId,
+      ok: true,
+      message: "Cursor request context is empty in legacy mock transport mode.",
+    };
+  }
+  return {
+    type: "exec_result",
+    requestId,
+    ok: false,
+    message: cursorExecDeniedMessage(execCase),
+  };
+}