llm-cli-gateway 2.12.1 → 2.13.0

package/dist/provider-types.d.ts

@@ -0,0 +1,4 @@
+export declare const CLI_TYPES: readonly ["claude", "codex", "gemini", "grok", "mistral", "devin", "cursor"];
+export type CliType = (typeof CLI_TYPES)[number];
+export declare const API_PROVIDER_TYPES: readonly ["grok-api"];
+export type KnownApiProviderType = (typeof API_PROVIDER_TYPES)[number];

package/dist/provider-types.js

@@ -0,0 +1,10 @@
+export const CLI_TYPES = [
+    "claude",
+    "codex",
+    "gemini",
+    "grok",
+    "mistral",
+    "devin",
+    "cursor",
+];
+export const API_PROVIDER_TYPES = ["grok-api"];

package/dist/resources.d.ts

@@ -2,7 +2,7 @@ import { ISessionManager } from "./session-manager.js";
 import { PerformanceMetrics } from "./metrics.js";
 import { FlightRecorderQuery } from "./flight-recorder.js";
 import { type GlobalCacheStats, type PrefixCacheStats, type SessionCacheStats } from "./cache-stats.js";
-import type { CacheAwarenessConfig } from "./config.js";
+import { type CacheAwarenessConfig, type ProvidersConfig } from "./config.js";
 export interface ResourceDefinition {
     uri: string;
     name: string;
@@ -25,8 +25,12 @@ export declare class ResourceProvider {
     private performanceMetrics;
     private flightRecorder;
     private cacheAwareness;
-    constructor(sessionManager: ISessionManager, performanceMetrics: PerformanceMetrics, flightRecorder?: FlightRecorderQuery, cacheAwareness?: CacheAwarenessConfig | null);
+    private providers;
+    constructor(sessionManager: ISessionManager, performanceMetrics: PerformanceMetrics, flightRecorder?: FlightRecorderQuery, cacheAwareness?: CacheAwarenessConfig | null, providers?: ProvidersConfig | null);
     getFlightRecorderQuery(): FlightRecorderQuery;
+    private apiRuntimes;
+    private continuityTrackedApiRuntimes;
+    private providerCapabilityIds;
     readCacheStateGlobal(opts?: {
         lastNHours?: number;
     }): GlobalCacheStats;

package/dist/resources.js

@@ -2,22 +2,36 @@ import { CLI_TYPES, PROVIDER_TYPES } from "./session-manager.js";
 import { getRequestContext, principalCanAccess, resolveOwnerPrincipal } from "./request-context.js";
 import { getAvailableCliInfo } from "./model-registry.js";
 import { computeGlobalCacheStats, computePrefixCacheStats, computeSessionCacheStats, computeTtlRemaining, } from "./cache-stats.js";
+import { enabledApiProviders, } from "./config.js";
+import { apiContinuityForKind } from "./api-provider.js";
+import { apiProviderCatalogEntry } from "./api-request.js";
 import { buildProviderSubcommandsCompactCatalog, getCliSubcommandContract, serializeCliSubcommandContract, } from "./upstream-contracts.js";
-import { getOneProviderToolCapabilities, getProviderToolCapabilities, providerCapabilityIds, } from "./provider-tool-capabilities.js";
+import { getOneProviderToolCapabilities, getProviderToolCapabilities, knownProviderCapabilityIds, providerCapabilityIds, } from "./provider-tool-capabilities.js";
 export class ResourceProvider {
     sessionManager;
     performanceMetrics;
     flightRecorder;
     cacheAwareness;
-    constructor(sessionManager, performanceMetrics, flightRecorder = { queryRequests: () => [] }, cacheAwareness = null) {
+    providers;
+    constructor(sessionManager, performanceMetrics, flightRecorder = { queryRequests: () => [] }, cacheAwareness = null, providers = null) {
         this.sessionManager = sessionManager;
         this.performanceMetrics = performanceMetrics;
         this.flightRecorder = flightRecorder;
         this.cacheAwareness = cacheAwareness;
+        this.providers = providers;
     }
     getFlightRecorderQuery() {
         return this.flightRecorder;
     }
+    apiRuntimes() {
+        return this.providers ? enabledApiProviders(this.providers) : [];
+    }
+    continuityTrackedApiRuntimes() {
+        return this.apiRuntimes().filter(rt => apiContinuityForKind(rt.kind) !== "none");
+    }
+    providerCapabilityIds() {
+        return this.providers ? providerCapabilityIds(this.providers) : knownProviderCapabilityIds();
+    }
     readCacheStateGlobal(opts = {}) {
         return computeGlobalCacheStats(this.flightRecorder, opts);
     }
@@ -101,6 +115,17 @@ export class ResourceProvider {
                     priority: 0.6,
                 },
             },
+            ...this.continuityTrackedApiRuntimes().map(rt => ({
+                uri: `sessions://${rt.name}`,
+                name: `${rt.name} Sessions`,
+                title: `${rt.name} Sessions`,
+                description: `List of ${rt.name} API provider conversation sessions`,
+                mimeType: "application/json",
+                annotations: {
+                    audience: ["user", "assistant"],
+                    priority: 0.6,
+                },
+            })),
             {
                 uri: "models://claude",
                 name: "Claude Models",
@@ -156,6 +181,17 @@ export class ResourceProvider {
                     priority: 0.8,
                 },
             },
+            ...this.apiRuntimes().map(rt => ({
+                uri: `models://${rt.name}`,
+                name: `${rt.name} Models`,
+                title: `${rt.name} Models & Capabilities`,
+                description: `Configured ${rt.name} API provider model catalog`,
+                mimeType: "application/json",
+                annotations: {
+                    audience: ["user", "assistant"],
+                    priority: 0.8,
+                },
+            })),
             {
                 uri: "metrics://performance",
                 name: "Performance Metrics",
@@ -189,7 +225,7 @@ export class ResourceProvider {
                     priority: 0.8,
                 },
             },
-            ...providerCapabilityIds().map(cli => ({
+            ...this.providerCapabilityIds().map(cli => ({
                 uri: `provider-tools://${cli}`,
                 name: `${cli} Tool Capabilities`,
                 title: `${cli} Tool Capabilities`,
@@ -338,6 +374,32 @@ export class ResourceProvider {
                 text: JSON.stringify(cliInfo.mistral, null, 2),
             };
         }
+        if (uri.startsWith("models://")) {
+            const runtime = this.apiRuntimes().find(rt => `models://${rt.name}` === uri);
+            if (runtime) {
+                return {
+                    uri,
+                    mimeType: "application/json",
+                    text: JSON.stringify(apiProviderCatalogEntry(runtime), null, 2),
+                };
+            }
+        }
+        if (uri.startsWith("sessions://")) {
+            const runtime = this.continuityTrackedApiRuntimes().find(rt => `sessions://${rt.name}` === uri);
+            if (runtime) {
+                const sessions = this.ownedSessions(await this.sessionManager.listSessions(runtime.name));
+                return {
+                    uri,
+                    mimeType: "application/json",
+                    text: JSON.stringify({
+                        cli: runtime.name,
+                        total: sessions.length,
+                        sessions,
+                        activeSession: await this.ownedActiveId(runtime.name),
+                    }, null, 2),
+                };
+            }
+        }
         if (uri === "metrics://performance") {
             return {
                 uri,
@@ -356,15 +418,17 @@ export class ResourceProvider {
             return {
                 uri,
                 mimeType: "application/json",
-                text: JSON.stringify(getProviderToolCapabilities(), null, 2),
+                text: JSON.stringify(getProviderToolCapabilities({ providersConfig: this.providers ?? undefined }), null, 2),
             };
         }
-        const providerToolsResource = parseProviderToolsUri(uri);
+        const providerToolsResource = parseProviderToolsUri(uri, this.providerCapabilityIds());
         if (providerToolsResource) {
             return {
                 uri,
                 mimeType: "application/json",
-                text: JSON.stringify(getOneProviderToolCapabilities(providerToolsResource.provider), null, 2),
+                text: JSON.stringify(getOneProviderToolCapabilities(providerToolsResource.provider, {
+                    providersConfig: this.providers ?? undefined,
+                }), null, 2),
             };
         }
         const subcommandResource = parseProviderSubcommandUri(uri);
@@ -401,7 +465,7 @@ function parseProviderSubcommandUri(uri) {
         commandPath: pathParts.map(part => decodeURIComponent(part)).filter(Boolean),
     };
 }
-function parseProviderToolsUri(uri) {
+function parseProviderToolsUri(uri, providerIds) {
     const prefix = uri.startsWith("provider-tools://")
         ? "provider-tools://"
         : uri.startsWith("provider_tools://")
@@ -410,7 +474,7 @@ function parseProviderToolsUri(uri) {
     if (!prefix || uri === `${prefix}catalog`)
         return null;
     const provider = uri.slice(prefix.length);
-    if (!providerCapabilityIds().includes(provider))
+    if (!providerIds.includes(provider))
         return null;
     return { provider: provider };
 }

package/dist/session-manager.d.ts

@@ -1,14 +1,12 @@
 import type { Config } from "./config.js";
 import type { DatabaseConnection } from "./db.js";
 import type { Logger } from "./logger.js";
-export declare const CLI_TYPES: readonly ["claude", "codex", "gemini", "grok", "mistral", "devin"];
-export type CliType = (typeof CLI_TYPES)[number];
-export declare const API_PROVIDER_TYPES: readonly ["grok-api"];
-export type KnownApiProviderType = (typeof API_PROVIDER_TYPES)[number];
+import { API_PROVIDER_TYPES, CLI_TYPES, type CliType, type KnownApiProviderType } from "./provider-types.js";
+export { API_PROVIDER_TYPES, CLI_TYPES, type CliType, type KnownApiProviderType };
 export type ApiProviderType = KnownApiProviderType | (string & {});
 export type ProviderType = CliType | ApiProviderType;
 export type ProviderKind = "cli" | "api";
-export declare const PROVIDER_TYPES: readonly ["claude", "codex", "gemini", "grok", "mistral", "devin", "grok-api"];
+export declare const PROVIDER_TYPES: readonly ["claude", "codex", "gemini", "grok", "mistral", "devin", "cursor", "grok-api"];
 export declare function isCliType(provider: string): provider is CliType;
 export declare function providerKind(provider: ProviderType): ProviderKind;
 export declare function defaultSessionDescription(provider: ProviderType): string;

package/dist/session-manager.js

@@ -5,8 +5,8 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync, renameSync, openSyn
 import { DEFAULT_SESSION_TTL_SECONDS } from "./config.js";
 import { noopLogger } from "./logger.js";
 import { getRequestContext, resolveOwnerPrincipal } from "./request-context.js";
-export const CLI_TYPES = ["claude", "codex", "gemini", "grok", "mistral", "devin"];
-export const API_PROVIDER_TYPES = ["grok-api"];
+import { API_PROVIDER_TYPES, CLI_TYPES, } from "./provider-types.js";
+export { API_PROVIDER_TYPES, CLI_TYPES };
 export const PROVIDER_TYPES = [...CLI_TYPES, ...API_PROVIDER_TYPES];
 export function isCliType(provider) {
     return CLI_TYPES.includes(provider);
@@ -20,6 +20,8 @@ const KNOWN_SESSION_DESCRIPTIONS = {
     gemini: "Gemini Session",
     grok: "Grok Session",
     mistral: "Mistral Session",
+    devin: "Devin Session",
+    cursor: "Cursor Session",
     "grok-api": "Grok API Session",
 };
 export function defaultSessionDescription(provider) {

package/dist/upstream-contracts.js

@@ -70,6 +70,17 @@ export const ACP_ENTRYPOINT_CONTRACTS = {
         evidence: 'Native ACP entrypoint `devin acp` (stdio JSON-RPC). Slice D1 manual initialize + session/new smoke passed (protocolVersion 1, agent "Affogato", session created). Third native runtime pilot; routing stays config-gated.',
         docsRef: "docs/plans/first-class-acp-gateway-extension.dag.toml#provider_matrix.devin",
     },
+    cursor: {
+        cli: "cursor",
+        displayName: "Cursor Agent CLI",
+        status: "native",
+        executable: "cursor-agent",
+        entrypointArgs: ["acp"],
+        targetVersion: "cursor-agent 2026.06.29-2ad2186",
+        probeArgs: [["acp", "--help"]],
+        evidence: "Native hidden ACP entrypoint `cursor-agent acp` (stdio JSON-RPC). `cursor-agent acp --help` was verified locally; manual initialize + session/new smoke passed locally (protocolVersion 1, session created; no agentInfo returned). Runtime routing stays config-gated.",
+        docsRef: "docs/plans/first-class-acp-gateway-extension.dag.toml#provider_matrix.cursor",
+    },
 };
 const PERMISSION_MODES = [
     "default",
@@ -1826,6 +1837,164 @@ export const UPSTREAM_CLI_CONTRACTS = {
             },
         ],
     },
+    cursor: {
+        cli: "cursor",
+        executable: "cursor-agent",
+        upstream: "Cursor Agent CLI",
+        upstreamMetadata: {
+            sourceUrls: [
+                "https://cursor.com/cli",
+                "https://cursor.com/docs/cli/acp",
+                "https://cursor.com/docs/cli/reference/parameters",
+            ],
+            packageName: "cursor-agent",
+            installDocsUrl: "https://cursor.com/cli",
+            releaseChannel: "vendor",
+            watchCategories: [
+                "flags",
+                "subcommands",
+                "session-resume",
+                "execution-modes",
+                "acp-entrypoint",
+            ],
+        },
+        helpArgs: [["--help"]],
+        subcommands: {},
+        maxPositionals: 1,
+        mcpTools: ["cursor_request", "cursor_request_async"],
+        mcpParameters: [
+            "prompt",
+            "model",
+            "mode",
+            "outputFormat",
+            "force",
+            "autoReview",
+            "sandbox",
+            "trust",
+            "workspace",
+            "addDir",
+            "sessionId",
+            "resumeLatest",
+            "createNewSession",
+        ],
+        flags: {
+            "--print": {
+                arity: "none",
+                description: "Print responses to console for scripts/non-interactive use",
+            },
+            "--output-format": {
+                arity: "one",
+                values: ["text", "json", "stream-json"],
+                description: "Output format for --print mode",
+            },
+            "--model": { arity: "one", description: "Model to use for the session" },
+            "--mode": {
+                arity: "one",
+                values: ["plan", "ask"],
+                description: "Execution mode (plan or ask)",
+            },
+            "--force": { arity: "none", description: "Force allow commands unless denied" },
+            "--auto-review": { arity: "none", description: "Use Cursor Smart Auto-review" },
+            "--sandbox": {
+                arity: "one",
+                values: ["enabled", "disabled"],
+                description: "Enable or disable Cursor sandbox mode",
+            },
+            "--trust": { arity: "none", description: "Trust workspace in headless mode" },
+            "--workspace": { arity: "one", description: "Workspace directory or saved workspace" },
+            "--add-dir": { arity: "one", description: "Additional workspace root directory" },
+            "--resume": { arity: "one", description: "Resume a specific Cursor chat/session" },
+            "--continue": { arity: "none", description: "Continue the latest Cursor chat" },
+        },
+        acknowledgedUpstreamFlags: [
+            "--api-key",
+            "--header",
+            "-H",
+            "-p",
+            "--plan",
+            "--yolo",
+            "--approve-mcps",
+            "--plugin-dir",
+            "--worktree",
+            "-w",
+            "--worktree-base",
+            "--skip-worktree-setup",
+            "--stream-partial-output",
+            "--list-models",
+            "--version",
+            "-v",
+            "--help",
+            "-h",
+        ],
+        env: {
+            CURSOR_API_KEY: {
+                arity: "one",
+                description: "Cursor Agent API key for headless authentication",
+            },
+        },
+        conformanceFixtures: [
+            {
+                id: "cursor-minimal",
+                description: "Minimal print-mode prompt request",
+                args: ["--print", "hello"],
+                expect: "pass",
+            },
+            {
+                id: "cursor-output-format",
+                description: "--output-format json is accepted",
+                args: ["--print", "--output-format", "json", "hello"],
+                expect: "pass",
+            },
+            {
+                id: "cursor-mode",
+                description: "--mode plan is accepted",
+                args: ["--print", "--mode", "plan", "hello"],
+                expect: "pass",
+            },
+            {
+                id: "cursor-high-impact-controls",
+                description: "Model, force, auto-review, sandbox, trust, and workspace controls are accepted",
+                args: [
+                    "--print",
+                    "--model",
+                    "gpt-5",
+                    "--force",
+                    "--auto-review",
+                    "--sandbox",
+                    "enabled",
+                    "--trust",
+                    "--workspace",
+                    "/tmp/workspace",
+                    "hello",
+                ],
+                expect: "pass",
+            },
+            {
+                id: "cursor-mode-invalid",
+                description: "Invalid --mode is rejected",
+                args: ["--print", "--mode", "dangerous", "hello"],
+                expect: "fail",
+            },
+            {
+                id: "cursor-resume",
+                description: "Resume by chat id accepted",
+                args: ["--print", "--resume", "chat-123", "hello"],
+                expect: "pass",
+            },
+            {
+                id: "cursor-add-dir",
+                description: "Repeatable --add-dir is accepted",
+                args: ["--print", "--add-dir", "/tmp/extra", "hello"],
+                expect: "pass",
+            },
+            {
+                id: "cursor-unsupported-flag",
+                description: "Unsupported flag is rejected before spawn",
+                args: ["--print", "--not-a-cursor-flag", "hello"],
+                expect: "fail",
+            },
+        ],
+    },
 };
 export function validateUpstreamCliArgs(cli, args) {
     const contract = UPSTREAM_CLI_CONTRACTS[cli];

package/dist/validation-normalizer.js

@@ -1,10 +1,11 @@
 export function normalizeStartedJob(provider, model, snapshot, warning) {
+    const inProgress = snapshot.status === "running" || snapshot.status === "queued";
     return {
         provider,
         model,
-        status: snapshot.status,
-        verdict: snapshot.status === "running" ? "pending" : null,
-        rationale: snapshot.status === "running" ? "Provider job is running asynchronously." : null,
+        status: snapshot.status === "queued" ? "running" : snapshot.status,
+        verdict: inProgress ? "pending" : null,
+        rationale: inProgress ? "Provider job is running asynchronously." : null,
         risks: [],
         rawJobReference: {
             jobId: snapshot.id,
@@ -34,7 +35,7 @@ export function normalizeJobResult(provider, model, result) {
     return {
         provider,
         model,
-        status: result.status,
+        status: result.status === "queued" ? "running" : result.status,
         verdict: inferVerdict(output, result.status),
         rationale: output ? excerpt(output, 1800) : error,
         risks: extractRisks(output, error),

package/dist/validation-orchestrator.js

@@ -220,6 +220,10 @@ function buildProviderArgs(provider, prompt) {
     if (provider === "claude" || provider === "grok" || provider === "mistral") {
         return ["-p", prompt];
     }
+    if (provider === "devin")
+        return ["-p", prompt];
+    if (provider === "cursor")
+        return ["--print", "--mode", "ask", "--sandbox", "enabled", prompt];
     if (provider === "codex")
         return ["exec", "--skip-git-repo-check", prompt];
     return [prompt];

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "llm-cli-gateway",
-  "version": "2.12.1",
+  "version": "2.13.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "llm-cli-gateway",
-      "version": "2.12.1",
+      "version": "2.13.0",
       "license": "MIT",
       "dependencies": {
         "@modelcontextprotocol/sdk": "^1.29.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "llm-cli-gateway",
-  "version": "2.12.1",
+  "version": "2.13.0",
   "mcpName": "io.github.verivus-oss/llm-cli-gateway",
   "description": "MCP server providing unified access to Claude Code, Codex, Gemini, Grok, Mistral Vibe, and Devin CLIs with session management, retry logic, async job orchestration, durable job results, and cross-LLM validation.",
   "license": "MIT",

package/setup/status.schema.json

@@ -118,7 +118,7 @@
     },
     "providers": {
       "type": "object",
-      "required": ["claude", "codex", "gemini", "grok", "mistral"],
+      "minProperties": 1,
       "additionalProperties": {
         "type": "object",
         "required": [
@@ -353,7 +353,7 @@
             "catalog": { "const": "provider-tools://catalog" },
             "providers": {
               "type": "object",
-              "required": ["claude", "codex", "gemini", "grok", "grok_api", "mistral"],
+              "minProperties": 1,
               "additionalProperties": { "type": "string" }
             }
           },
@@ -362,7 +362,7 @@
         "cache_ttl_ms": { "type": "integer", "minimum": 0 },
         "providers": {
           "type": "object",
-          "required": ["claude", "codex", "gemini", "grok", "grok_api", "mistral"],
+          "minProperties": 1,
           "additionalProperties": {
             "type": "object",
             "required": [
@@ -405,6 +405,71 @@
       },
       "additionalProperties": false
     },
+    "api_providers": {
+      "type": "object",
+      "description": "Slice 6: health of enabled [providers.<name>] (kind:api) providers. OMITTED entirely when none are enabled (dormant byte-identical).",
+      "required": ["enabled_count", "providers"],
+      "properties": {
+        "enabled_count": { "type": "integer", "minimum": 1 },
+        "providers": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "required": [
+              "name",
+              "kind",
+              "base_url",
+              "default_model",
+              "models",
+              "api_key_env",
+              "api_key_present",
+              "reachable",
+              "login_guidance"
+            ],
+            "properties": {
+              "name": { "type": "string" },
+              "kind": { "enum": ["openai-compatible", "anthropic", "xai-responses"] },
+              "base_url": { "type": "string" },
+              "default_model": { "type": "string" },
+              "models": {
+                "type": ["array", "null"],
+                "items": { "type": "string" }
+              },
+              "api_key_env": { "type": ["string", "null"] },
+              "api_key_present": { "type": "boolean" },
+              "reachable": { "type": ["boolean", "null"] },
+              "reachability_error": { "type": "string" },
+              "login_guidance": {
+                "type": "object",
+                "required": [
+                  "provider",
+                  "displayName",
+                  "kind",
+                  "baseUrl",
+                  "apiKeyEnv",
+                  "summary",
+                  "steps",
+                  "credentialHandling"
+                ],
+                "properties": {
+                  "provider": { "type": "string" },
+                  "displayName": { "type": "string" },
+                  "kind": { "enum": ["openai-compatible", "anthropic", "xai-responses"] },
+                  "baseUrl": { "type": "string" },
+                  "apiKeyEnv": { "type": ["string", "null"] },
+                  "summary": { "type": "string" },
+                  "steps": { "type": "array", "items": { "type": "string" } },
+                  "credentialHandling": { "type": "string" }
+                },
+                "additionalProperties": false
+              }
+            },
+            "additionalProperties": false
+          }
+        }
+      },
+      "additionalProperties": false
+    },
     "upstream": {
       "type": "object",
       "required": [