llm-cli-gateway 2.13.2 → 2.14.0

package/dist/provider-definitions.js

@@ -0,0 +1,758 @@
+import { CLI_TYPES } from "./provider-types.js";
+export { CLI_TYPES };
+export function adminSurfaceKind(family) {
+    return family.kind ?? "cli-subcommand";
+}
+export const DEVIN_ACP_AGENT_TYPES = ["summarizer", "review"];
+const PROVIDER_DEFINITIONS = {
+    claude: {
+        id: "claude",
+        displayName: "Anthropic Claude Code",
+        sessionLabel: "Claude Session",
+        icon: "🤖",
+        executables: ["claude"],
+        primaryExecutable: "claude",
+        requestSurface: {
+            sync: true,
+            async: true,
+            transport: "cli",
+            acpCapable: false,
+            syncToolName: "claude_request",
+            asyncToolName: "claude_request_async",
+        },
+        docs: { primary: ["https://code.claude.com/docs/en/cli-reference"] },
+        discovery: {
+            version: { argv: ["--version"], purpose: "version" },
+            rootHelp: { argv: ["--help"], purpose: "root-help" },
+            subcommandHelp: [
+                { argv: ["mcp", "--help"], purpose: "subcommand-help" },
+                { argv: ["plugin", "--help"], purpose: "subcommand-help" },
+                { argv: ["doctor", "--help"], purpose: "subcommand-help" },
+                { argv: ["auth", "--help"], purpose: "subcommand-help" },
+            ],
+            modelDiscovery: {
+                strategy: "static-catalog",
+                argv: [],
+                parse: "curated-catalog",
+                fallbackPolicy: "curated-static-catalog",
+                configSources: [
+                    {
+                        kind: "env",
+                        keys: ["CLAUDE_DEFAULT_MODEL", "CLAUDE_MODELS", "CLAUDE_MODEL_ALIASES"],
+                        note: "Gateway env overrides for the Claude default model, extra models, and aliases.",
+                    },
+                    {
+                        kind: "config-file",
+                        path: ".claude/settings.json",
+                        keys: ["model", "model.name"],
+                        note: "Claude settings.json / settings.local.json default model.",
+                    },
+                ],
+                facts: {
+                    effortLevels: ["low", "medium", "high", "xhigh", "max"],
+                    supportsFallbackModelChain: true,
+                    aliases: ["fable", "opus", "sonnet"],
+                    agentProfiles: [],
+                },
+                evidence: "Claude Code has no read-only model-listing command; aliases ('fable'/'opus'/'sonnet') and full ids ('claude-fable-5'), --effort levels (low/medium/high/xhigh/max), and --fallback-model comma-separated chains come from claude --help and the CLI reference, curated as an accurate catalog.",
+            },
+            sessionContinuity: {
+                continue: true,
+                resume: true,
+                fork: true,
+                sessionIdSelection: true,
+                flags: ["--continue", "--session-id", "--resume", "--fork-session"],
+                evidence: "claude --help: --continue, --session-id, --resume, --fork-session.",
+            },
+        },
+        adminSubcommands: [
+            { family: "auth", safety: "mutating-gated", evidence: "claude auth login/logout/status" },
+            { family: "agents", safety: "mutating-gated", evidence: "claude agents" },
+            {
+                family: "mcp",
+                safety: "mutating-gated",
+                evidence: "claude mcp add/list/get/remove/login/logout/enable/disable",
+            },
+            { family: "plugin", safety: "mutating-gated", evidence: "claude plugin and plugins" },
+            { family: "project", safety: "mutating-gated", evidence: "claude project purge" },
+            { family: "doctor", safety: "read-only", evidence: "claude doctor" },
+            { family: "update", safety: "mutating-gated", evidence: "claude update/upgrade" },
+            { family: "install", safety: "mutating-gated", evidence: "claude install" },
+            { family: "setup-token", safety: "mutating-gated", evidence: "claude setup-token" },
+            { family: "ultrareview", safety: "read-only", evidence: "claude ultrareview" },
+        ],
+        acp: {
+            classification: "none",
+            nativeEntrypoint: null,
+            entrypoint: null,
+            probeArgv: [],
+            evidence: "No native Claude Code ACP subcommand or flag in installed help (claude 2.1.198) or the official CLI reference. Coverage is CLI-first; ACP reporting says no native entrypoint is advertised.",
+        },
+        safetyModes: {
+            sandbox: false,
+            permissionMode: true,
+            approvalMode: false,
+            trust: false,
+            flags: ["--permission-mode", "--dangerously-skip-permissions"],
+        },
+        outputFormats: ["text", "json", "stream-json"],
+        streamingFormats: ["stream-json"],
+        resourcePolicy: { exposesModelsResource: true, exposesSessionsResource: true },
+        upstreamContract: { targetVersion: "Claude Code 2.1.198", helpChecksumRef: "claude--help.txt" },
+        capabilityScope: "full",
+    },
+    codex: {
+        id: "codex",
+        displayName: "OpenAI Codex CLI",
+        sessionLabel: "Codex Session",
+        icon: "💻",
+        executables: ["codex"],
+        primaryExecutable: "codex",
+        requestSurface: {
+            sync: true,
+            async: true,
+            transport: "cli",
+            acpCapable: false,
+            syncToolName: "codex_request",
+            asyncToolName: "codex_request_async",
+        },
+        docs: {
+            primary: [
+                "https://developers.openai.com/codex/cli",
+                "https://developers.openai.com/codex/cli/reference",
+            ],
+        },
+        discovery: {
+            version: { argv: ["--version"], purpose: "version" },
+            rootHelp: { argv: ["--help"], purpose: "root-help" },
+            subcommandHelp: [
+                { argv: ["exec", "--help"], purpose: "subcommand-help" },
+                { argv: ["exec", "resume", "--help"], purpose: "subcommand-help" },
+                { argv: ["mcp", "--help"], purpose: "subcommand-help" },
+                { argv: ["doctor", "--help"], purpose: "subcommand-help" },
+                { argv: ["login", "--help"], purpose: "subcommand-help" },
+            ],
+            modelDiscovery: {
+                strategy: "native-command",
+                argv: ["debug", "models"],
+                parse: "codex-debug-json",
+                fallbackPolicy: "live-catalog-primary",
+                configSources: [
+                    {
+                        kind: "config-file",
+                        path: ".codex/config.toml",
+                        keys: ["model", "profiles.*.model", "notice.model_migrations"],
+                        note: "Codex config default model, profile model overrides, and migration targets.",
+                    },
+                    {
+                        kind: "env",
+                        keys: ["CODEX_DEFAULT_MODEL", "CODEX_MODELS"],
+                        note: "Gateway env overrides for the Codex default model and extra models.",
+                    },
+                ],
+                facts: {
+                    effortLevels: ["low", "medium", "high", "xhigh"],
+                    supportsFallbackModelChain: false,
+                    aliases: [],
+                    agentProfiles: [],
+                },
+                evidence: "codex debug models renders the raw model catalog as JSON ({models:[{slug,display_name,visibility,supported_in_api,supported_reasoning_levels}]}); visibility list vs hide distinguishes the live catalog, and the model-registry bundled fallback stays the offline/bundled catalog.",
+            },
+            sessionContinuity: {
+                continue: false,
+                resume: true,
+                fork: true,
+                sessionIdSelection: true,
+                flags: ["exec resume", "exec resume --last", "fork", "--all"],
+                evidence: "codex exec resume <UUID>/--last and codex fork; resume requires a real Codex UUID from ~/.codex/sessions/ (gw-* ids are rejected).",
+            },
+        },
+        adminSubcommands: [
+            { family: "login", safety: "mutating-gated", evidence: "codex login/logout/status" },
+            {
+                family: "mcp",
+                safety: "mutating-gated",
+                evidence: "codex mcp list/get/add/remove/login/logout",
+            },
+            {
+                family: "plugin",
+                safety: "mutating-gated",
+                evidence: "codex plugin list/add/remove and marketplace",
+            },
+            { family: "doctor", safety: "read-only", evidence: "codex doctor" },
+            { family: "features", safety: "mutating-gated", evidence: "codex features" },
+            { family: "sandbox", safety: "mutating-gated", evidence: "codex sandbox" },
+            { family: "debug", safety: "read-only", evidence: "codex debug models" },
+            { family: "cloud", safety: "mutating-gated", evidence: "codex cloud list/exec" },
+            { family: "apply", safety: "mutating-gated", evidence: "codex apply" },
+            {
+                family: "resume",
+                safety: "mutating-gated",
+                evidence: "codex resume (continue a saved session)",
+            },
+            { family: "archive", safety: "mutating-gated", evidence: "codex archive <session>" },
+            {
+                family: "delete",
+                safety: "mutating-gated",
+                evidence: "codex delete <session> (destructive)",
+            },
+            { family: "unarchive", safety: "mutating-gated", evidence: "codex unarchive <session>" },
+            {
+                family: "fork",
+                safety: "mutating-gated",
+                evidence: "codex fork (executes agent; not exposed)",
+            },
+            { family: "completion", safety: "read-only", evidence: "codex completion" },
+            { family: "update", safety: "mutating-gated", evidence: "codex update" },
+            {
+                family: "app-server",
+                safety: "mutating-gated",
+                evidence: "codex app-server / mcp-server (Codex transports, not native ACP)",
+            },
+        ],
+        acp: {
+            classification: "none",
+            nativeEntrypoint: null,
+            entrypoint: null,
+            probeArgv: [],
+            evidence: "codex-cli 0.142.4 advertises mcp-server and app-server transports, not a native ACP agent entrypoint. Third-party adapters exist but are documentation only and are never treated as native gateway ACP.",
+        },
+        safetyModes: {
+            sandbox: true,
+            permissionMode: false,
+            approvalMode: true,
+            trust: true,
+            flags: [
+                "--sandbox",
+                "--ask-for-approval",
+                "--dangerously-bypass-approvals-and-sandbox",
+                "--dangerously-bypass-hook-trust",
+            ],
+        },
+        outputFormats: ["text", "json"],
+        streamingFormats: ["jsonl"],
+        resourcePolicy: { exposesModelsResource: true, exposesSessionsResource: true },
+        upstreamContract: {
+            targetVersion: "codex-cli 0.142.4",
+            helpChecksumRef: "codex-exec--help.txt",
+        },
+        capabilityScope: "full",
+    },
+    gemini: {
+        id: "gemini",
+        displayName: "Google Antigravity CLI",
+        sessionLabel: "Gemini Session",
+        icon: "✨",
+        executables: ["agy"],
+        primaryExecutable: "agy",
+        requestSurface: {
+            sync: true,
+            async: true,
+            transport: "cli",
+            acpCapable: false,
+            syncToolName: "gemini_request",
+            asyncToolName: "gemini_request_async",
+        },
+        docs: {
+            primary: [
+                "https://antigravity.google/docs/cli-overview",
+                "https://antigravity.google/docs/cli-using",
+                "https://antigravity.google/docs/cli/plugins",
+                "https://antigravity.google/docs/cli-features",
+            ],
+        },
+        discovery: {
+            version: { argv: ["--version"], purpose: "version" },
+            rootHelp: { argv: ["--help"], purpose: "root-help" },
+            subcommandHelp: [
+                { argv: ["models", "--help"], purpose: "subcommand-help" },
+                { argv: ["plugin", "--help"], purpose: "subcommand-help" },
+            ],
+            modelDiscovery: {
+                strategy: "native-command",
+                argv: ["models"],
+                parse: "agy-models-text",
+                fallbackPolicy: "live-catalog-primary",
+                configSources: [
+                    {
+                        kind: "config-file",
+                        path: ".gemini/settings.json",
+                        keys: ["model", "model.name", "selectedModel", "defaultModel"],
+                        note: "Antigravity settings.json default/selected model.",
+                    },
+                    {
+                        kind: "env",
+                        keys: ["GEMINI_DEFAULT_MODEL", "GEMINI_MODELS"],
+                        note: "Gateway env overrides for the Gemini default model and extra models.",
+                    },
+                ],
+                facts: {
+                    effortLevels: [],
+                    supportsFallbackModelChain: false,
+                    aliases: ["flash", "pro"],
+                    agentProfiles: [],
+                },
+                evidence: "agy models is the primary account-aware model discovery command (agy --help lists it); it prints one account model label per line (e.g. 'Gemini 3.5 Flash (Medium)').",
+            },
+            sessionContinuity: {
+                continue: true,
+                resume: true,
+                fork: false,
+                sessionIdSelection: true,
+                flags: ["--continue", "--conversation", "--project"],
+                evidence: "agy --help: --continue (most recent), --conversation <ID> (resume), --project/--new-project continuity.",
+            },
+        },
+        adminSubcommands: [
+            { family: "models", safety: "read-only", evidence: "agy models" },
+            {
+                family: "plugin",
+                safety: "mutating-gated",
+                evidence: "agy plugin list/install/uninstall/enable/disable; plugins alias",
+            },
+            { family: "changelog", safety: "read-only", evidence: "agy changelog" },
+            { family: "install", safety: "mutating-gated", evidence: "agy install" },
+            { family: "update", safety: "mutating-gated", evidence: "agy update" },
+        ],
+        acp: {
+            classification: "none",
+            nativeEntrypoint: null,
+            entrypoint: null,
+            probeArgv: [],
+            evidence: "agy 1.0.14 has no ACP flag or subcommand in installed help or the Antigravity CLI docs. Legacy Gemini CLI ACP evidence does not transfer. No native entrypoint advertised.",
+        },
+        safetyModes: {
+            sandbox: true,
+            permissionMode: false,
+            approvalMode: true,
+            trust: false,
+            flags: ["--sandbox", "--dangerously-skip-permissions"],
+        },
+        outputFormats: ["text"],
+        streamingFormats: [],
+        resourcePolicy: { exposesModelsResource: true, exposesSessionsResource: true },
+        upstreamContract: { targetVersion: "agy 1.0.14", helpChecksumRef: "agy--help.txt" },
+        capabilityScope: "full",
+    },
+    grok: {
+        id: "grok",
+        displayName: "xAI Grok Build",
+        sessionLabel: "Grok Session",
+        icon: "⚡",
+        executables: ["grok"],
+        primaryExecutable: "grok",
+        requestSurface: {
+            sync: true,
+            async: true,
+            transport: "cli",
+            acpCapable: true,
+            syncToolName: "grok_request",
+            asyncToolName: "grok_request_async",
+        },
+        docs: {
+            primary: [
+                "https://docs.x.ai/build/overview",
+                "https://x.ai/build/changelog",
+                "https://docs.x.ai/developers/models",
+            ],
+        },
+        discovery: {
+            version: { argv: ["--version"], purpose: "version" },
+            rootHelp: { argv: ["--help"], purpose: "root-help" },
+            subcommandHelp: [
+                { argv: ["agent", "--help"], purpose: "subcommand-help" },
+                { argv: ["mcp", "--help"], purpose: "subcommand-help" },
+                { argv: ["sessions", "--help"], purpose: "subcommand-help" },
+            ],
+            modelDiscovery: {
+                strategy: "native-command",
+                argv: ["models"],
+                parse: "grok-models-text",
+                fallbackPolicy: "live-catalog-primary",
+                configSources: [
+                    {
+                        kind: "config-file",
+                        path: ".grok/config.toml",
+                        keys: ["models.default", "models", "ui.fork_secondary_model"],
+                        note: "Grok config.toml configured default ([models].default) and custom model facts.",
+                    },
+                    {
+                        kind: "env",
+                        keys: ["GROK_DEFAULT_MODEL", "GROK_MODELS"],
+                        note: "Gateway env overrides for the Grok default model and extra models.",
+                    },
+                ],
+                facts: {
+                    effortLevels: ["low", "medium", "high", "xhigh", "max"],
+                    supportsFallbackModelChain: false,
+                    aliases: [],
+                    agentProfiles: [],
+                },
+                evidence: "grok models lists the CLI-local catalog ('Default model: X' then '* id (default)'/'- id' lines); ~/.grok/config.toml [models].default and custom model facts are additional. Native Grok Build API models are catalogued separately.",
+            },
+            sessionContinuity: {
+                continue: true,
+                resume: true,
+                fork: true,
+                sessionIdSelection: true,
+                flags: ["--continue", "--resume", "--fork-session", "--session-id"],
+                evidence: "grok --help: --resume/--continue/--fork-session/--session-id.",
+            },
+        },
+        adminSubcommands: [
+            { family: "models", safety: "read-only", evidence: "grok models" },
+            { family: "inspect", safety: "read-only", evidence: "grok inspect" },
+            { family: "mcp", safety: "mutating-gated", evidence: "grok mcp" },
+            { family: "plugin", safety: "mutating-gated", evidence: "grok plugin" },
+            {
+                family: "sessions",
+                safety: "mutating-gated",
+                evidence: "grok sessions; grok export/import",
+            },
+            { family: "worktree", safety: "mutating-gated", evidence: "grok worktree" },
+            { family: "dashboard", safety: "mutating-gated", evidence: "grok dashboard" },
+            { family: "leader", safety: "mutating-gated", evidence: "grok leader" },
+            { family: "memory", safety: "mutating-gated", evidence: "grok memory" },
+            { family: "trace", safety: "read-only", evidence: "grok trace" },
+            { family: "setup", safety: "mutating-gated", evidence: "grok setup" },
+            { family: "auth", safety: "mutating-gated", evidence: "grok login/logout" },
+            { family: "update", safety: "mutating-gated", evidence: "grok update" },
+        ],
+        acp: {
+            classification: "native",
+            nativeEntrypoint: "grok agent stdio",
+            entrypoint: { command: "grok", args: ["agent", "stdio"] },
+            probeArgv: [["agent", "stdio", "--help"]],
+            evidence: "Official xAI docs: Grok Build runs via TUI, headless scripts, or ACP in other apps. Installed help advertises `grok agent stdio`. `grok agent stdio --help` is the safe probe; bare `grok agent stdio` starts the live server and is never probed.",
+        },
+        safetyModes: {
+            sandbox: true,
+            permissionMode: true,
+            approvalMode: true,
+            trust: false,
+            flags: ["--sandbox", "--permission-mode", "--always-approve", "--allow", "--deny"],
+        },
+        outputFormats: ["text", "json"],
+        streamingFormats: ["json"],
+        resourcePolicy: { exposesModelsResource: true, exposesSessionsResource: true },
+        upstreamContract: {
+            targetVersion: "grok 0.2.77 (44e77bec3a)",
+            helpChecksumRef: "grok--help.txt",
+        },
+        capabilityScope: "full",
+    },
+    mistral: {
+        id: "mistral",
+        displayName: "Mistral Vibe",
+        sessionLabel: "Mistral Session",
+        icon: "🌬",
+        executables: ["vibe", "vibe-acp"],
+        primaryExecutable: "vibe",
+        requestSurface: {
+            sync: true,
+            async: true,
+            transport: "cli",
+            acpCapable: true,
+            syncToolName: "mistral_request",
+            asyncToolName: "mistral_request_async",
+        },
+        docs: { primary: ["https://github.com/mistralai/mistral-vibe"] },
+        discovery: {
+            version: { argv: ["--version"], purpose: "version" },
+            rootHelp: { argv: ["--help"], purpose: "root-help" },
+            subcommandHelp: [{ argv: ["--help"], purpose: "subcommand-help", executable: "vibe-acp" }],
+            modelDiscovery: {
+                strategy: "config-inspection",
+                argv: [],
+                parse: "config-or-env",
+                fallbackPolicy: "config-active-model",
+                configSources: [
+                    {
+                        kind: "env",
+                        keys: ["VIBE_ACTIVE_MODEL", "MISTRAL_DEFAULT_MODEL", "VIBE_MODELS"],
+                        note: "Vibe active model via env; there is NO --model flag (VIBE_* overrides config).",
+                    },
+                    {
+                        kind: "config-file",
+                        path: ".vibe/config.toml",
+                        keys: ["active_model", "default_agent", "models"],
+                        note: "Vibe config.toml active_model, default_agent, and custom models.",
+                    },
+                ],
+                facts: {
+                    effortLevels: [],
+                    supportsFallbackModelChain: false,
+                    aliases: [],
+                    agentProfiles: ["default", "plan", "accept-edits", "auto-approve", "custom"],
+                },
+                evidence: "Vibe has NO --model flag; the active model is selected via VIBE_ACTIVE_MODEL and config.toml active_model. default_agent plus --agent profiles (default, plan, accept-edits, auto-approve, or custom from ~/.vibe/agents/NAME.toml) are the vibe --help agent-profile facts.",
+            },
+            sessionContinuity: {
+                continue: true,
+                resume: true,
+                fork: false,
+                sessionIdSelection: true,
+                flags: ["--continue", "--resume"],
+                evidence: "vibe --help: --continue/--resume.",
+            },
+        },
+        adminSubcommands: [
+            {
+                family: "setup",
+                safety: "mutating-gated",
+                kind: "cli-flag",
+                evidence: "vibe --help: --setup (Setup API key and exit).",
+            },
+            {
+                family: "check-upgrade",
+                safety: "mutating-gated",
+                kind: "cli-flag",
+                evidence: "vibe --help: --check-upgrade (Check for a Vibe update now, prompt to install it, and exit); mutating.",
+            },
+            {
+                family: "config",
+                safety: "read-only",
+                kind: "config-projection",
+                evidence: "Projection of VIBE_HOME/config.toml (vibe --help env: VIBE_HOME, VIBE_*).",
+            },
+            {
+                family: "mcp",
+                safety: "read-only",
+                kind: "config-projection",
+                evidence: "Projection of MCP server config from VIBE_HOME config; no vibe mcp subcommand.",
+            },
+            {
+                family: "skills",
+                safety: "read-only",
+                kind: "config-projection",
+                evidence: "Projection of discovered skills from VIBE_HOME; no vibe skills subcommand.",
+            },
+            {
+                family: "agents",
+                safety: "read-only",
+                kind: "config-projection",
+                evidence: "Projection of agent profiles (~/.vibe/agents/*.toml, per --agent help); no vibe agents subcommand.",
+            },
+        ],
+        acp: {
+            classification: "native",
+            nativeEntrypoint: "vibe-acp",
+            entrypoint: { command: "vibe-acp", args: [] },
+            probeArgv: [["--version"], ["--help"]],
+            evidence: "Mistral Vibe README: ACP-capable editors/IDEs can use Vibe. Installed `vibe-acp --help` advertises ACP mode. Probes are `vibe-acp --version`/`--help`; bare `vibe-acp` starts the live server and is never probed.",
+        },
+        safetyModes: {
+            sandbox: false,
+            permissionMode: false,
+            approvalMode: true,
+            trust: true,
+            flags: ["--auto-approve", "--yolo", "--trust"],
+        },
+        outputFormats: ["text", "json"],
+        streamingFormats: [],
+        resourcePolicy: { exposesModelsResource: true, exposesSessionsResource: true },
+        upstreamContract: { targetVersion: "vibe 2.18.3", helpChecksumRef: "vibe--help.txt" },
+        capabilityScope: "full",
+    },
+    devin: {
+        id: "devin",
+        displayName: "Cognition Devin CLI",
+        sessionLabel: "Devin Session",
+        icon: "🔷",
+        executables: ["devin"],
+        primaryExecutable: "devin",
+        requestSurface: {
+            sync: true,
+            async: true,
+            transport: "cli",
+            acpCapable: true,
+            syncToolName: "devin_request",
+            asyncToolName: "devin_request_async",
+        },
+        docs: { primary: ["https://docs.devin.ai/cli/reference/commands"] },
+        discovery: {
+            version: { argv: ["--version"], purpose: "version" },
+            rootHelp: { argv: ["--help"], purpose: "root-help" },
+            subcommandHelp: [
+                { argv: ["acp", "--help"], purpose: "subcommand-help" },
+                { argv: ["mcp", "--help"], purpose: "subcommand-help" },
+                { argv: ["auth", "--help"], purpose: "subcommand-help" },
+            ],
+            modelDiscovery: {
+                strategy: "config-inspection",
+                argv: [],
+                parse: "config-or-env",
+                fallbackPolicy: "cli-owned-surface-only",
+                configSources: [
+                    {
+                        kind: "env",
+                        keys: ["DEVIN_MODEL"],
+                        note: "devin --help: --model <MODEL> reads [env: DEVIN_MODEL]. Account decides availability.",
+                    },
+                ],
+                facts: {
+                    effortLevels: [],
+                    supportsFallbackModelChain: false,
+                    aliases: ["opus", "codex"],
+                    agentProfiles: [],
+                },
+                evidence: "Devin exposes --model <MODEL> (e.g. 'claude-sonnet-4', 'claude-opus-4.6', 'opus', 'codex'; [env: DEVIN_MODEL]); the CLI owns model selection and the account decides available models, so no static account-specific list is hardcoded.",
+            },
+            sessionContinuity: {
+                continue: true,
+                resume: true,
+                fork: false,
+                sessionIdSelection: true,
+                flags: ["--continue", "--resume"],
+                evidence: "devin --help / docs: --continue and --resume <id>.",
+            },
+        },
+        adminSubcommands: [
+            { family: "auth", safety: "mutating-gated", evidence: "devin auth login/logout/status" },
+            {
+                family: "mcp",
+                safety: "mutating-gated",
+                evidence: "devin mcp add/list/get/remove/login/logout/enable/disable",
+            },
+            { family: "rules", safety: "read-only", evidence: "devin rules list/show/paths" },
+            { family: "skills", safety: "read-only", evidence: "devin skills list/show/paths" },
+            {
+                family: "plugins",
+                safety: "mutating-gated",
+                evidence: "devin plugins install/list/info/update/remove",
+            },
+            {
+                family: "cloud",
+                safety: "mutating-gated",
+                evidence: "devin cloud environment/sandbox/build",
+            },
+            { family: "list", safety: "read-only", evidence: "devin list/ls (JSON and CSV)" },
+            { family: "update", safety: "mutating-gated", evidence: "devin update" },
+            { family: "version", safety: "read-only", evidence: "devin version" },
+            { family: "sandbox", safety: "mutating-gated", evidence: "devin sandbox setup" },
+            { family: "setup", safety: "mutating-gated", evidence: "devin setup; devin shell setup" },
+        ],
+        acp: {
+            classification: "native",
+            nativeEntrypoint: "devin acp",
+            entrypoint: { command: "devin", args: ["acp"] },
+            probeArgv: [["acp", "--help"]],
+            agentTypes: [
+                {
+                    id: "summarizer",
+                    description: "Summarizer agent with no tools; outputs the full summary as text (persisted by a PostAgentIteration cog).",
+                },
+                {
+                    id: "review",
+                    description: "Code-review agent with read-only + shell tools; reviews diffs for correctness, style, security, performance, and completeness.",
+                },
+            ],
+            evidence: "Official Devin docs advertise `devin acp` as an ACP stdio server; installed `devin acp --help` confirms it with --agent-type summarizer/review options. `devin acp --help` is the safe probe; bare `devin acp` starts the live server and is never probed.",
+        },
+        safetyModes: {
+            sandbox: true,
+            permissionMode: true,
+            approvalMode: false,
+            trust: true,
+            flags: ["--sandbox", "--permission-mode", "--respect-workspace-trust"],
+        },
+        outputFormats: ["text", "json"],
+        streamingFormats: [],
+        resourcePolicy: { exposesModelsResource: true, exposesSessionsResource: true },
+        upstreamContract: {
+            targetVersion: "devin 2026.8.18 (16737566)",
+            helpChecksumRef: "devin--help.txt",
+        },
+        capabilityScope: "full",
+    },
+    cursor: {
+        id: "cursor",
+        displayName: "Cursor Agent CLI",
+        sessionLabel: "Cursor Session",
+        icon: "🖱",
+        executables: ["cursor-agent"],
+        primaryExecutable: "cursor-agent",
+        requestSurface: {
+            sync: true,
+            async: true,
+            transport: "cli",
+            acpCapable: true,
+            syncToolName: "cursor_request",
+            asyncToolName: "cursor_request_async",
+        },
+        docs: { primary: ["https://docs.cursor.com/en/cli/overview"] },
+        discovery: {
+            version: { argv: ["--version"], purpose: "version" },
+            rootHelp: { argv: ["--help"], purpose: "root-help" },
+            subcommandHelp: [{ argv: ["acp", "--help"], purpose: "subcommand-help" }],
+            modelDiscovery: {
+                strategy: "static-catalog",
+                argv: [],
+                parse: "curated-catalog",
+                fallbackPolicy: "curated-static-catalog",
+                configSources: [],
+                facts: {
+                    effortLevels: [],
+                    supportsFallbackModelChain: false,
+                    aliases: [],
+                    agentProfiles: [],
+                },
+                evidence: "Cursor is maintain-only in this initiative; the CLI owns model selection and the gateway keeps a curated catalog. No new model-discovery capability is added here.",
+            },
+            sessionContinuity: {
+                continue: true,
+                resume: true,
+                fork: false,
+                sessionIdSelection: true,
+                flags: ["--resume", "--continue"],
+                evidence: "cursor-agent --help: --resume [chatId] (Resume a specific Cursor chat/session) and --continue (Continue the latest Cursor chat).",
+            },
+        },
+        adminSubcommands: [
+            {
+                family: "version",
+                safety: "read-only",
+                kind: "cli-flag",
+                evidence: "cursor-agent --help: -v, --version (maintain-only).",
+            },
+        ],
+        acp: {
+            classification: "native",
+            nativeEntrypoint: "cursor-agent acp",
+            entrypoint: { command: "cursor-agent", args: ["acp"] },
+            probeArgv: [["acp", "--help"]],
+            evidence: "Native ACP entrypoint `cursor-agent acp` (stdio JSON-RPC). Captured `cursor-agent acp --help` (help/cursor-agent-acp--help.txt) confirms: 'Start the Cursor Agent as an ACP (Agent Client Protocol) server'. Maintain-only in this initiative; kept complete so shared generation covers cursor.",
+        },
+        safetyModes: {
+            sandbox: true,
+            permissionMode: false,
+            approvalMode: true,
+            trust: true,
+            flags: ["--mode", "--force", "--auto-review", "--sandbox", "--trust"],
+        },
+        outputFormats: ["text", "json", "stream-json"],
+        streamingFormats: ["stream-json"],
+        resourcePolicy: { exposesModelsResource: true, exposesSessionsResource: true },
+        upstreamContract: {
+            targetVersion: "cursor-agent 2026.06.29-2ad2186",
+            helpChecksumRef: "cursor-agent--help.txt",
+        },
+        capabilityScope: "maintain-only",
+    },
+};
+export const PROVIDER_DEFINITIONS_BY_ID = Object.freeze(PROVIDER_DEFINITIONS);
+export function getAllProviderDefinitions() {
+    return CLI_TYPES.map(id => PROVIDER_DEFINITIONS_BY_ID[id]);
+}
+export function getProviderDefinition(id) {
+    return PROVIDER_DEFINITIONS_BY_ID[id];
+}
+export function listProviderIds() {
+    return CLI_TYPES;
+}
+export function getProviderDisplayName(id) {
+    return PROVIDER_DEFINITIONS_BY_ID[id].displayName;
+}
+export function getProviderSessionLabel(id) {
+    return PROVIDER_DEFINITIONS_BY_ID[id].sessionLabel;
+}