@gakim-digital/dexter-bridge 0.11.17 → 0.11.20

package/README.md

@@ -166,11 +166,18 @@ for support and automation:
 npx @gakim-digital/dexter-bridge pair 123456 --api http://localhost:3800/iwm-api/0.0.1
 npx @gakim-digital/dexter-bridge start --agent claude-code
 npx @gakim-digital/dexter-bridge start --agent codex
+npx @gakim-digital/dexter-bridge start --agent cursor
 npx @gakim-digital/dexter-bridge status
 npx @gakim-digital/dexter-bridge doctor
 npx @gakim-digital/dexter-bridge logout
 ```
 
+Cursor needs the Cursor CLI signed in on the same computer
+(`curl https://cursor.com/install -fsS | bash`, then `cursor-agent login`).
+The bridge runs `cursor-agent acp` with Cursor's shell, file, and web tools
+denied, so Cursor can use only Dexter's Framer tools. Set
+`DEXTER_BRIDGE_CURSOR_BIN` if `cursor-agent` is installed elsewhere.
+
 On Windows, the bridge checks the native Claude Code install at
 `%USERPROFILE%\.local\bin\claude.exe` in addition to `PATH`. Before pairing,
 verify the same PowerShell window can run:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gakim-digital/dexter-bridge",
-  "version": "0.11.17",
+  "version": "0.11.20",
   "description": "Local bridge for InstaWebAI and Dexter — runs Codex, Claude Code, or OpenCode on your machine.",
   "type": "module",
   "bin": {

package/src/agent.js

@@ -1,4 +1,5 @@
 import { execFileSync } from 'node:child_process';
+import crypto from 'node:crypto';
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
@@ -27,6 +28,7 @@ import {
 } from './config.js';
 import {
   assertOutcomeResponseContract,
+  buildFramerOutcomePrompt,
   buildOutcomePrompt,
   buildModelTurnDeltaPrompt,
   buildModelTurnFallbackPrompt,
@@ -172,6 +174,15 @@ export const AGENT_DEFINITIONS = {
     model: 'codex:gpt-5.5',
     statusStage: 'codex_start',
   },
+  cursor: {
+    id: 'cursor',
+    label: 'Cursor',
+    commandEnv: 'DEXTER_BRIDGE_CURSOR_BIN',
+    fallbackCommand: 'cursor-agent',
+    promptMode: 'stdin',
+    model: 'cursor:grok-4.7',
+    statusStage: 'cursor_start',
+  },
 };
 
 export const AGENT_AUTHENTICATION_REQUIRED_CODE = 'DEXTER_AGENT_AUTHENTICATION_REQUIRED';
@@ -328,6 +339,23 @@ function claudeModelEngineSystemPrompt(product) {
   ].join(' ');
 }
 
+// Content-addressed, so identical instructions reuse one file and stay
+// byte-identical for Claude Code's prompt cache.
+function writeClaudeSystemPromptFile(content) {
+  const directory = path.join(os.tmpdir(), 'instawebai-outcome-prompts');
+  const file = path.join(
+    directory,
+    `${crypto.createHash('sha256').update(content).digest('hex').slice(0, 32)}.md`,
+  );
+  if (!fs.existsSync(file)) {
+    fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
+    const partial = `${file}.${process.pid}.${crypto.randomUUID()}.tmp`;
+    fs.writeFileSync(partial, content, { mode: 0o600 });
+    fs.renameSync(partial, file);
+  }
+  return file;
+}
+
 function claudeOutcomeSystemPrompt(product) {
   const name = normalizeBridgeProduct(product).name;
   if (normalizeBridgeProduct(product).id === 'dexter') {
@@ -337,7 +365,6 @@ function claudeOutcomeSystemPrompt(product) {
       'Inspect the project, perform the requested work, verify the result, and return the structured outcome.',
       'Do not access local credentials, unrelated files, other projects, account settings, or billing.',
       'Do not publish unless the assignment explicitly authorizes publishing.',
-      'Call progress_update before the first inspection or edit and at meaningful phase changes. Use one or two natural first-person sentences that name the specific page area, component, or behavior and the concrete change you are about to make or are making now; optionally say what you will check next. Avoid generic updates such as "working on the next step", "thinking", "loading", or "making changes".',
       'If framer_write is rejected by the safety boundary, do not retry JavaScript variants. Switch to framer_apply_changes, inspect the relevant state, or report the concrete blocker.',
       `Return only the structured outcome result requested by ${name}.`,
     ].join(' ');
@@ -510,13 +537,18 @@ function argsWithClaudeModelEngine(args, definition, options = {}, env = process
   let isolated = argsWithoutFlagValue(args, '--system-prompt');
   isolated = argsWithoutFlagValue(isolated, '--append-system-prompt');
   isolated = argsWithoutFlagValue(isolated, '--agent');
+  isolated = argsWithoutFlagValue(isolated, '--system-prompt-file');
   isolated = argsWithoutFlagValue(isolated, '--effort');
   return [
     ...isolated,
-    '--system-prompt',
-    options.harnessMode
-      ? claudeOutcomeSystemPrompt(options.product)
-      : claudeModelEngineSystemPrompt(options.product),
+    ...(options.harnessMode && options.systemPromptFile
+      ? ['--system-prompt-file', options.systemPromptFile]
+      : [
+          '--system-prompt',
+          options.harnessMode
+            ? claudeOutcomeSystemPrompt(options.product)
+            : claudeModelEngineSystemPrompt(options.product),
+        ]),
     '--effort',
     claudeEffortForStep(options.step, env),
   ];
@@ -864,7 +896,15 @@ export function processEnvWithCliPath(baseEnv = process.env, platform = process.
           baseEnv.APPDATA ? pathApi.join(baseEnv.APPDATA, 'npm') : '',
           baseEnv.LOCALAPPDATA ? pathApi.join(baseEnv.LOCALAPPDATA, 'Programs') : '',
         ]
-      : ['/opt/homebrew/bin', '/usr/local/bin', '/usr/bin', '/bin', '/usr/sbin', '/sbin'];
+      : [
+          homeDirectory ? pathApi.join(homeDirectory, '.local', 'bin') : '',
+          '/opt/homebrew/bin',
+          '/usr/local/bin',
+          '/usr/bin',
+          '/bin',
+          '/usr/sbin',
+          '/sbin',
+        ];
   const shellEnv = platform === 'win32' ? {} : loginShellEnv();
   const existingPath = String(baseEnv.PATH || '');
   const mergedPath = mergePathEntries([shellEnv.PATH, existingPath, ...fallbackPath], platform);
@@ -1393,6 +1433,7 @@ function definitionForRuntimeProfile(profile, fallbackAgent) {
   if (!profile) return definitionForAgent(fallbackAgent);
   if (profile.driver === 'claude-code-cli') return AGENT_DEFINITIONS['claude-code'];
   if (profile.driver === 'codex-app-server') return AGENT_DEFINITIONS.codex;
+  if (profile.driver === 'cursor-acp') return AGENT_DEFINITIONS.cursor;
   return {
     id: profile.id || profile.driver,
     label: profile.label || profile.driver || 'Local runtime',
@@ -2314,7 +2355,15 @@ async function executeOutcomeRun(run, send, agent, options = {}) {
       1_000,
     ),
   );
-  const sessionKey = companionSessionKey(run);
+  const framerAgentOutcome =
+    run?.outcome?.kind === 'framer-project'
+    || run?.outcome?.context?.executionMode === 'framer-agent';
+  // Every Dexter message starts a fresh provider session. The assignment
+  // already carries the recent conversation, and resuming would make every
+  // turn of this run re-read the whole previous run as well.
+  const sessionKey = framerAgentOutcome
+    ? run?.runId || companionSessionKey(run)
+    : companionSessionKey(run);
   const infrastructureAbortController = new AbortController();
   const controlMonitorAbort = new AbortController();
   let finished = false;
@@ -2462,9 +2511,15 @@ async function executeOutcomeRun(run, send, agent, options = {}) {
       Boolean(event.message || event.name) ||
       event.kind === 'turn_started';
     if (!meaningful) return;
+    // Framer runs narrate in plain text rather than through a progress tool
+    // (a tool call costs a whole turn), so that text is the user's progress.
+    const narration =
+      framerAgentOutcome
+      && event.kind === 'output_delta'
+      && String(event.activity || '').startsWith('assistant:');
     const userFacingUpdate =
-      event.kind === 'status_update'
-      && event.source === 'harness';
+      (event.kind === 'status_update' && event.source === 'harness')
+      || narration;
     void postActivity({
       stage: 'outcome',
       outcomeId: run?.outcome?.outcomeId,
@@ -2474,9 +2529,10 @@ async function executeOutcomeRun(run, send, agent, options = {}) {
       provider: definition.id,
       tool: event.name || undefined,
       toolPhase: event.phase || undefined,
-      activity:
-        event.activity ||
-        (userFacingUpdate ? `assistant-progress:${Date.now()}` : undefined),
+      activity: narration
+        ? event.activity.replace(/^assistant:/, 'assistant-progress:')
+        : event.activity ||
+          (userFacingUpdate ? `assistant-progress:${Date.now()}` : undefined),
       paths: event.paths || undefined,
       tokenUsage: event.tokenUsage || undefined,
       occurredAt: event.occurredAt || new Date().toISOString(),
@@ -2522,18 +2578,16 @@ async function executeOutcomeRun(run, send, agent, options = {}) {
     }
   };
   const controlMonitor = monitorControl();
-  const rememberedSession =
-    rememberedCompanionSession(sessionKey) ||
-    (run?.outcome?.session?.providerSessionId
-      ? {
-          providerSessionId: run.outcome.session.providerSessionId,
-          agent: definition.id,
-          updatedAt: Date.now(),
-        }
-      : null);
-  const framerAgentOutcome =
-    run?.outcome?.kind === 'framer-project'
-    || run?.outcome?.context?.executionMode === 'framer-agent';
+  const rememberedSession = framerAgentOutcome
+    ? null
+    : rememberedCompanionSession(sessionKey) ||
+      (run?.outcome?.session?.providerSessionId
+        ? {
+            providerSessionId: run.outcome.session.providerSessionId,
+            agent: definition.id,
+            updatedAt: Date.now(),
+          }
+        : null);
   const materialized = materializeOutcomeWorkspace(run?.outcome, {
     sessionId: run?.outcome?.context?.harnessSessionId || sessionKey,
   });
@@ -2677,11 +2731,34 @@ async function executeOutcomeRun(run, send, agent, options = {}) {
           cancellation,
         ])
       : null;
-    prompt = buildOutcomePrompt(executionOutcome, product, {
+    const promptContext = {
       doctrine: run?.doctrine,
       doctrineVersion: run?.doctrineVersion,
       framerGuidance: framerGuidance?.content,
-    });
+      projectInventory: framerGuidance?.inventory,
+    };
+    // Claude Code gets the run-independent instructions as its system prompt,
+    // which it caches across sessions: later runs and follow-up messages read
+    // them from the cache instead of writing them again.
+    let systemPromptFile = null;
+    let systemPromptBytes = 0;
+    if (
+      framerAgentOutcome
+      && definition.id === 'claude-code'
+      && !options.providerAdapter?.runOutcome
+    ) {
+      const { instructions, task } = buildFramerOutcomePrompt(
+        executionOutcome,
+        product,
+        promptContext,
+      );
+      const systemPrompt = `${claudeOutcomeSystemPrompt(product)}\n\n${instructions}`;
+      systemPromptFile = writeClaudeSystemPromptFile(systemPrompt);
+      systemPromptBytes = Buffer.byteLength(systemPrompt, 'utf8');
+      prompt = task;
+    } else {
+      prompt = buildOutcomePrompt(executionOutcome, product, promptContext);
+    }
     const unresolvedTargets = preflight?.unresolvedTargets || [];
     if (unresolvedTargets.length > 0) {
       prompt = [
@@ -2696,7 +2773,7 @@ async function executeOutcomeRun(run, send, agent, options = {}) {
     harnessTools.configurePromptContext?.({
       doctrineLoaded: Boolean(run?.doctrine),
       doctrineVersion: run?.doctrineVersion,
-      promptBytes: Buffer.byteLength(prompt, 'utf8'),
+      promptBytes: systemPromptBytes + Buffer.byteLength(prompt, 'utf8'),
     });
     const gateway =
       definition.id === 'codex' ? null : await harnessTools.startGateway();
@@ -2798,6 +2875,7 @@ async function executeOutcomeRun(run, send, agent, options = {}) {
           maxDurationMs: outcomeMaxDurationMs,
           cwd: materialized.directory,
           harnessMode: true,
+          systemPromptFile,
           framerHarness: framerAgentOutcome ? executionOutcome : false,
           harnessToolNames: harnessTools.toolNames,
           nativeSkillsEnabled: Boolean(materializedNativeSkills),
@@ -2821,6 +2899,7 @@ async function executeOutcomeRun(run, send, agent, options = {}) {
           maxDurationMs: outcomeMaxDurationMs,
           cwd: materialized.directory,
           harnessMode: true,
+          systemPromptFile,
           framerHarness: framerAgentOutcome ? executionOutcome : false,
           harnessToolNames: harnessTools.toolNames,
           nativeSkillsEnabled: Boolean(materializedNativeSkills),
@@ -3083,7 +3162,8 @@ export async function executeRun(
   });
   const runtimeProfile = run?.runtimeProfile || suppliedRuntimeProfile || null;
   const normalizedAgent = normalizeAgentName(
-    run?.companion?.agent || (runtimeProfile?.driver === 'claude-code-cli' ? 'claude-code' : agent),
+    run?.companion?.agent
+      || ({ 'claude-code-cli': 'claude-code', 'cursor-acp': 'cursor' }[runtimeProfile?.driver] || agent),
   );
   const runModel = runtimeProfile?.model?.id || run?.companion?.model?.id || run?.model || selectedModel;
   const usageAccumulator = createCompanionUsageAccumulator(normalizedAgent);
@@ -3274,10 +3354,10 @@ export async function checkAgentAvailability(agent, model, options = {}) {
       modelCatalogRefreshedAt,
     };
   }
-  if (normalizedAgent === 'codex') {
+  if (normalizedAgent === 'codex' || normalizedAgent === 'cursor') {
     const adapter =
       options.providerAdapter
-      || createLocalAgentAdapter('codex', {
+      || createLocalAgentAdapter(normalizedAgent, {
         env: options.env,
       });
     try {
@@ -3297,7 +3377,7 @@ export async function checkAgentAvailability(agent, model, options = {}) {
           code: detection.installed === false ? 'DEXTER_AGENT_NOT_FOUND' : AGENT_AUTHENTICATION_REQUIRED_CODE,
           error:
             detection.error
-            || 'Codex is not signed in. Run `codex login` on this computer, then run the bridge command again.',
+            || `${definition.label} is not signed in. Sign in on this computer, then run the bridge command again.`,
           modelCatalogSource: 'fallback',
           modelCatalogRefreshedAt,
         };
@@ -3377,6 +3457,7 @@ export async function checkAllAgents(options = {}) {
   const agents = await Promise.all([
     checkAgentAvailability('claude-code', undefined, options),
     checkAgentAvailability('codex', undefined, options),
+    checkAgentAvailability('cursor', undefined, options),
   ]);
   return {
     agents,

package/src/cli.js

@@ -16,7 +16,8 @@ import {
   resolveCompanionModelName,
   saveConfigPatch,
 } from './config.js';
-import { checkAgentAvailability, checkAllAgents, executeRun } from './agent.js';
+import { checkAgentAvailability, checkAllAgents, executeRun, processEnvWithCliPath } from './agent.js';
+import { setUpCursorCli } from './providers/cursorAcp.js';
 import {
   claimPairing,
   heartbeat,
@@ -55,11 +56,12 @@ function usage() {
     'Environment:',
     '  DEXTER_API_URL              API base URL, e.g. https://api.example.com/iwm-api/0.0.1',
     '  DEXTER_BRIDGE_RUNTIME       codex, claude-code, or opencode',
-    '  DEXTER_BRIDGE_AGENT         claude-code, codex, opencode, or dry-run',
+    '  DEXTER_BRIDGE_AGENT         claude-code, codex, cursor, opencode, or dry-run',
     '  DEXTER_BRIDGE_MODEL         Companion model, e.g. claude-code:sonnet or codex:gpt-5.5',
     '  DEXTER_BRIDGE_CLAUDE_BIN    Claude CLI binary name/path',
     '  DEXTER_BRIDGE_CLAUDE_ARGS   Claude CLI args, default: -p',
     '  DEXTER_BRIDGE_CODEX_BIN     Codex CLI binary name/path',
+    '  DEXTER_BRIDGE_CURSOR_BIN    Cursor CLI binary name/path, default: cursor-agent',
     '  DEXTER_BRIDGE_CODEX_MAX_THREADS Maximum retained App Server threads, default: 32',
     '  DEXTER_BRIDGE_LOG_DIR       Log directory, default: ~/.dexter-bridge/logs',
   ].join('\n');
@@ -134,6 +136,28 @@ function requireDeviceToken(config) {
   return config.deviceToken;
 }
 
+async function confirmPrompt(question) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    const answer = (await rl.question(question)).trim().toLowerCase();
+    return answer === '' || answer === 'y' || answer === 'yes';
+  } catch {
+    return false;
+  } finally {
+    rl.close();
+  }
+}
+
+// One `connect --agent cursor` command installs and signs in to the Cursor CLI
+// when needed, so the Cursor setup has no separate steps.
+async function prepareRequestedAgent(flags, config) {
+  if (normalizeAgentName(flags.agent || config.agent) !== 'cursor') return;
+  await setUpCursorCli({
+    env: processEnvWithCliPath(agentEnvironment(config)),
+    confirm: process.stdin.isTTY ? confirmPrompt : null,
+  });
+}
+
 async function promptForPairingCode() {
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
   try {
@@ -309,6 +333,9 @@ function agentEnvironment(config = {}, baseEnv = process.env) {
   if (!env.DEXTER_BRIDGE_CODEX_BIN && commands.codex) {
     env.DEXTER_BRIDGE_CODEX_BIN = commands.codex;
   }
+  if (!env.DEXTER_BRIDGE_CURSOR_BIN && commands.cursor) {
+    env.DEXTER_BRIDGE_CURSOR_BIN = commands.cursor;
+  }
   return env;
 }
 
@@ -316,11 +343,11 @@ function modelCatalogStatus(runtimeProfiles = []) {
   return Object.fromEntries(
     runtimeProfiles.flatMap((profile) => {
       const agent =
-        profile.driver === 'codex-app-server'
-          ? 'codex'
-          : profile.driver === 'claude-code-cli'
-            ? 'claude-code'
-            : null;
+        {
+          'codex-app-server': 'codex',
+          'claude-code-cli': 'claude-code',
+          'cursor-acp': 'cursor',
+        }[profile.driver] || null;
       return agent ? [[agent, profile.modelCatalog]] : [];
     }),
   );
@@ -466,7 +493,8 @@ function requireAvailableAgent(availability, agent, platform = process.platform)
   const check = selectedAgentCheck(availability, agent);
   if (check?.ok) return check;
 
-  const label = agent === 'claude-code' ? 'Claude Code' : agent === 'codex' ? 'Codex' : 'The selected agent';
+  const label = { 'claude-code': 'Claude Code', codex: 'Codex', cursor: 'Cursor' }[agent]
+    || 'The selected agent';
   let message = check?.error || `${label} is not installed or could not be started.`;
   if (agent === 'claude-code' && check?.status === 'authentication_required') {
     message = check.error || 'Claude Code is not signed in. Run `claude auth login`, then try again.';
@@ -778,11 +806,11 @@ async function startCommand({ apiBaseUrl, config, flags, configDir }) {
         const runAgent = normalizeAgentName(
           poll.run?.companion?.agent
           || (
-            runtimeProfile?.driver === 'claude-code-cli'
-              ? 'claude-code'
-              : runtimeProfile?.driver === 'opencode'
-                ? 'opencode'
-                : 'codex'
+            {
+              'claude-code-cli': 'claude-code',
+              'cursor-acp': 'cursor',
+              opencode: 'opencode',
+            }[runtimeProfile?.driver] || 'codex'
           ),
         );
         await executeClaimedRun({
@@ -865,6 +893,7 @@ export async function runCli(argv) {
     // The one-command production path: claim the pairing code (when given or
     // not yet paired), save config, and go straight into the polling loop.
     case 'connect':
+      await prepareRequestedAgent(parsed.flags, config);
       if (parsed.args[0]) {
         await pairCommand({ apiBaseUrl, args: parsed.args, flags: parsed.flags, configDir });
       }

package/src/config.js

@@ -31,6 +31,7 @@ export const BRIDGE_BUILD_FINGERPRINT = crypto
     './providers/directByok.js',
     './providers/openCode.js',
     './providers/acp.js',
+    './providers/cursorAcp.js',
   ].map((relativePath) => {
     const url = new URL(relativePath, import.meta.url);
     return `${relativePath}\u0000${fs.readFileSync(url, 'utf8')}`;
@@ -52,6 +53,7 @@ export const BRIDGE_CAPABILITIES = [
   'native-skills-v1',
   'model-progress-v1',
   'model-catalog-refresh-v1',
+  'cursor-acp-v1',
 ];
 export const BRIDGE_PRODUCTS = {
   dexter: {
@@ -69,7 +71,7 @@ export const BRIDGE_PRODUCTS = {
 // user explicitly connects the locally installed CLI and chooses one of its
 // reported models.
 export const DEFAULT_BRIDGE_AGENT = 'codex';
-export const BRIDGE_AGENTS = ['claude-code', 'codex', 'opencode', 'dry-run'];
+export const BRIDGE_AGENTS = ['claude-code', 'codex', 'cursor', 'opencode', 'dry-run'];
 export const COMPANION_MODEL_DEFINITIONS = [
   {
     id: 'claude-code:fable',
@@ -162,6 +164,63 @@ export const COMPANION_MODEL_DEFINITIONS = [
     costTier: '$',
     description: 'Low-latency Codex model for quick coding iterations.',
   },
+  // Cursor lists every model it offers, whatever the user's plan; Dexter
+  // shows frontier models plus Composer. Paid Cursor plans include Grok and
+  // Composer; Claude, GPT and Gemini are billed from Cursor credits.
+  {
+    id: 'cursor:grok-4.7',
+    agent: 'cursor',
+    provider: 'cursor',
+    displayName: 'Grok 4.7',
+    invocationName: 'grok-4.7',
+    costTier: '$$$',
+    description: 'Grok 4.7, included in paid Cursor plans.',
+  },
+  {
+    id: 'cursor:composer-2.5',
+    agent: 'cursor',
+    provider: 'cursor',
+    displayName: 'Composer 2.5',
+    invocationName: 'composer-2.5',
+    costTier: '$$',
+    description: "Cursor's fast model, included in paid Cursor plans.",
+  },
+  {
+    id: 'cursor:claude-opus-5-5',
+    agent: 'cursor',
+    provider: 'cursor',
+    displayName: 'Claude Opus 5.5',
+    invocationName: 'claude-opus-5-5',
+    costTier: '$$$',
+    description: 'Claude Opus 5.5 via your Cursor plan.',
+  },
+  {
+    id: 'cursor:claude-fable-5-1',
+    agent: 'cursor',
+    provider: 'cursor',
+    displayName: 'Claude Fable 5.1',
+    invocationName: 'claude-fable-5-1',
+    costTier: '$$$',
+    description: 'Claude Fable 5.1 via your Cursor plan.',
+  },
+  {
+    id: 'cursor:gpt-5.6-sol',
+    agent: 'cursor',
+    provider: 'cursor',
+    displayName: 'GPT-5.6 Sol',
+    invocationName: 'gpt-5.6-sol',
+    costTier: '$$$',
+    description: 'GPT-5.6 Sol via your Cursor plan.',
+  },
+  {
+    id: 'cursor:gemini-4-argon',
+    agent: 'cursor',
+    provider: 'cursor',
+    displayName: 'Gemini 4 Argon',
+    invocationName: 'gemini-4-argon',
+    costTier: '$$$',
+    description: 'Gemini 4 Argon via your Cursor plan.',
+  },
   {
     id: 'dry-run:default',
     agent: 'dry-run',
@@ -176,6 +235,7 @@ export const COMPANION_MODEL_DEFINITIONS = [
 const DEFAULT_MODEL_BY_AGENT = {
   'claude-code': 'claude-code:sonnet',
   codex: 'codex:gpt-5.5',
+  cursor: 'cursor:grok-4.7',
   'dry-run': 'dry-run:default',
 };
 
@@ -237,6 +297,7 @@ export function normalizeAgentName(value, fallback = DEFAULT_BRIDGE_AGENT) {
   const raw = String(value || '').trim().toLowerCase();
   if (raw === 'claude' || raw === 'claude_code' || raw === 'claude-code') return 'claude-code';
   if (raw === 'openai-codex' || raw === 'openai_codex' || raw === 'codex') return 'codex';
+  if (raw === 'cursor' || raw === 'cursor-agent' || raw === 'cursor_agent') return 'cursor';
   if (raw === 'open-code' || raw === 'open_code' || raw === 'opencode') return 'opencode';
   if (raw === 'dryrun' || raw === 'dry_run' || raw === 'dry-run') return 'dry-run';
   return BRIDGE_AGENTS.includes(fallback) ? fallback : DEFAULT_BRIDGE_AGENT;
@@ -269,11 +330,11 @@ export function companionModelDefinition(value, agent = DEFAULT_BRIDGE_AGENT) {
       return {
         id: `${normalizedAgent}:${invocationName}`,
         agent: normalizedAgent,
-        provider: normalizedAgent === 'codex' ? 'openai' : normalizedAgent === 'claude-code' ? 'anthropic' : 'companion',
+        provider: normalizedAgent === 'codex' ? 'openai' : normalizedAgent === 'claude-code' ? 'anthropic' : normalizedAgent === 'cursor' ? 'cursor' : 'companion',
         displayName: invocationName,
         invocationName,
         costTier: '$$',
-        description: `${normalizedAgent === 'codex' ? 'Codex' : 'Claude Code'} model reported by the connected bridge.`,
+        description: `${{ codex: 'Codex', cursor: 'Cursor' }[normalizedAgent] || 'Claude Code'} model reported by the connected bridge.`,
       };
     }
   }