llm-cli-gateway 2.10.0 → 2.11.1

package/dist/request-helpers.d.ts

@@ -32,8 +32,8 @@ export declare function resolveMistralSessionArgs(opts: {
     resumeLatest?: boolean;
     createNewSession?: boolean;
 }): SessionResumeResult;
-export declare const MISTRAL_AGENT_MODES: readonly ["default", "plan", "accept-edits", "auto-approve", "chat", "explore", "lean"];
-export type MistralAgentMode = (typeof MISTRAL_AGENT_MODES)[number];
+export declare const MISTRAL_BUILTIN_AGENT_MODES: readonly ["default", "plan", "accept-edits", "auto-approve"];
+export type MistralAgentMode = string;
 export declare const MISTRAL_DEFAULT_AGENT_MODE: MistralAgentMode;
 export interface PrepareMistralRequestInput {
     prompt: string;
@@ -105,7 +105,7 @@ export declare const CLAUDE_HIGH_IMPACT_PARAMS_SCHEMA: z.ZodEffects<z.ZodObject<
     appendSystemPrompt?: string | undefined;
     maxBudgetUsd?: number | undefined;
     maxTurns?: number | undefined;
-    effort?: "medium" | "low" | "high" | "xhigh" | "max" | undefined;
+    effort?: "low" | "medium" | "high" | "xhigh" | "max" | undefined;
     excludeDynamicSystemPromptSections?: boolean | undefined;
 }, {
     agent?: string | undefined;
@@ -115,7 +115,7 @@ export declare const CLAUDE_HIGH_IMPACT_PARAMS_SCHEMA: z.ZodEffects<z.ZodObject<
     appendSystemPrompt?: string | undefined;
     maxBudgetUsd?: number | undefined;
     maxTurns?: number | undefined;
-    effort?: "medium" | "low" | "high" | "xhigh" | "max" | undefined;
+    effort?: "low" | "medium" | "high" | "xhigh" | "max" | undefined;
     excludeDynamicSystemPromptSections?: boolean | undefined;
 }>, {
     agent?: string | undefined;
@@ -125,7 +125,7 @@ export declare const CLAUDE_HIGH_IMPACT_PARAMS_SCHEMA: z.ZodEffects<z.ZodObject<
     appendSystemPrompt?: string | undefined;
     maxBudgetUsd?: number | undefined;
     maxTurns?: number | undefined;
-    effort?: "medium" | "low" | "high" | "xhigh" | "max" | undefined;
+    effort?: "low" | "medium" | "high" | "xhigh" | "max" | undefined;
     excludeDynamicSystemPromptSections?: boolean | undefined;
 }, {
     agent?: string | undefined;
@@ -135,7 +135,7 @@ export declare const CLAUDE_HIGH_IMPACT_PARAMS_SCHEMA: z.ZodEffects<z.ZodObject<
     appendSystemPrompt?: string | undefined;
     maxBudgetUsd?: number | undefined;
     maxTurns?: number | undefined;
-    effort?: "medium" | "low" | "high" | "xhigh" | "max" | undefined;
+    effort?: "low" | "medium" | "high" | "xhigh" | "max" | undefined;
     excludeDynamicSystemPromptSections?: boolean | undefined;
 }>;
 export declare const CLAUDE_AGENT_DEFINITION_SCHEMA: z.ZodObject<{

package/dist/request-helpers.js

@@ -93,14 +93,11 @@ export function resolveMistralSessionArgs(opts) {
     }
     return { resumeArgs: [], effectiveSessionId: undefined, userProvidedSession: false };
 }
-export const MISTRAL_AGENT_MODES = [
+export const MISTRAL_BUILTIN_AGENT_MODES = [
     "default",
     "plan",
     "accept-edits",
     "auto-approve",
-    "chat",
-    "explore",
-    "lean",
 ];
 export const MISTRAL_DEFAULT_AGENT_MODE = "auto-approve";
 export function prepareMistralRequest(input) {

package/dist/session-manager-pg.js

@@ -1,13 +1,6 @@
 import { randomUUID } from "crypto";
+import { defaultSessionDescription } from "./session-manager.js";
 import { getRequestContext, resolveOwnerPrincipal } from "./request-context.js";
-const DEFAULT_SESSION_DESCRIPTIONS = {
-    claude: "Claude Session",
-    codex: "Codex Session",
-    gemini: "Gemini Session",
-    grok: "Grok Session",
-    mistral: "Mistral Session",
-    "grok-api": "Grok API Session",
-};
 export class PostgreSQLSessionManager {
     pool;
     constructor(pool) {
@@ -15,7 +8,7 @@ export class PostgreSQLSessionManager {
     }
     async createSession(cli, description, sessionId) {
         const id = sessionId || randomUUID();
-        const sessionDescription = description ?? DEFAULT_SESSION_DESCRIPTIONS[cli];
+        const sessionDescription = description ?? defaultSessionDescription(cli);
         const now = new Date().toISOString();
         const ownerPrincipal = resolveOwnerPrincipal(getRequestContext());
         const client = await this.pool.connect();

package/dist/session-manager.d.ts

@@ -1,12 +1,17 @@
 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"];
+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 ApiProviderType = (typeof API_PROVIDER_TYPES)[number];
-export declare const PROVIDER_TYPES: readonly ["claude", "codex", "gemini", "grok", "mistral", "grok-api"];
-export type ProviderType = (typeof PROVIDER_TYPES)[number];
+export type KnownApiProviderType = (typeof API_PROVIDER_TYPES)[number];
+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 function isCliType(provider: string): provider is CliType;
+export declare function providerKind(provider: ProviderType): ProviderKind;
+export declare function defaultSessionDescription(provider: ProviderType): string;
 export interface Session {
     id: string;
     cli: ProviderType;

package/dist/session-manager.js

@@ -5,11 +5,16 @@ 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"];
+export const CLI_TYPES = ["claude", "codex", "gemini", "grok", "mistral", "devin"];
 export const API_PROVIDER_TYPES = ["grok-api"];
 export const PROVIDER_TYPES = [...CLI_TYPES, ...API_PROVIDER_TYPES];
-const createEmptyActiveSessions = () => Object.fromEntries(PROVIDER_TYPES.map(provider => [provider, null]));
-const DEFAULT_SESSION_DESCRIPTIONS = {
+export function isCliType(provider) {
+    return CLI_TYPES.includes(provider);
+}
+export function providerKind(provider) {
+    return isCliType(provider) ? "cli" : "api";
+}
+const KNOWN_SESSION_DESCRIPTIONS = {
     claude: "Claude Session",
     codex: "Codex Session",
     gemini: "Gemini Session",
@@ -17,6 +22,10 @@ const DEFAULT_SESSION_DESCRIPTIONS = {
     mistral: "Mistral Session",
     "grok-api": "Grok API Session",
 };
+export function defaultSessionDescription(provider) {
+    return KNOWN_SESSION_DESCRIPTIONS[provider] ?? `${provider} Session`;
+}
+const createEmptyActiveSessions = () => Object.fromEntries(PROVIDER_TYPES.map(provider => [provider, null]));
 export class FileSessionManager {
     storagePath;
     storage = { sessions: {}, activeSession: createEmptyActiveSessions() };
@@ -107,7 +116,7 @@ export class FileSessionManager {
     createSession(cli, description, sessionId) {
         this.evictExpiredSessions();
         const id = sessionId || randomUUID();
-        const sessionDescription = description ?? DEFAULT_SESSION_DESCRIPTIONS[cli];
+        const sessionDescription = description ?? defaultSessionDescription(cli);
         const session = {
             id,
             cli,

package/dist/upstream-contracts.js

@@ -8,7 +8,7 @@ export const ACP_ENTRYPOINT_CONTRACTS = {
         status: "native",
         executable: "vibe-acp",
         entrypointArgs: [],
-        targetVersion: "vibe 2.14.1",
+        targetVersion: "vibe 2.17.1",
         probeArgs: [["--version"], ["--help"]],
         evidence: "Native ACP executable vibe-acp; manual initialize + session/new smoke passed. First runtime pilot.",
         docsRef: "docs/plans/first-class-acp-gateway-extension.dag.toml#provider_matrix.mistral",
@@ -19,9 +19,9 @@ export const ACP_ENTRYPOINT_CONTRACTS = {
         status: "native",
         executable: "grok",
         entrypointArgs: ["agent", "stdio"],
-        targetVersion: "grok 0.2.50 (cadf94855)",
+        targetVersion: "grok 0.2.60 (474c2bbfc)",
         probeArgs: [["agent", "stdio", "--help"]],
-        evidence: "Native ACP via `grok agent stdio`; initialize + session/new smoke passed with isolated leader socket. Second runtime pilot.",
+        evidence: "Native ACP via `grok agent stdio`; initialize + session/new smoke passed with isolated leader socket. Second runtime pilot. Bumped for 0.2.60.",
         docsRef: "docs/plans/first-class-acp-gateway-extension.dag.toml#provider_matrix.grok",
     },
     codex: {
@@ -30,10 +30,10 @@ export const ACP_ENTRYPOINT_CONTRACTS = {
         status: "adapter_mediated_deferred",
         executable: "codex",
         entrypointArgs: [],
-        targetVersion: "codex-cli 0.139.0",
+        targetVersion: "codex-cli 0.141.0",
         probeArgs: [],
         adapterCandidates: ["zed-industries/codex-acp", "agentclientprotocol/codex-acp"],
-        evidence: "No native ACP entrypoint at codex-cli 0.139.0. Adapter evidence tracked as documentation only; not native gateway ACP support.",
+        evidence: "No native ACP entrypoint at codex-cli 0.141.0. Adapter evidence tracked as documentation only; not native gateway ACP support.",
         docsRef: "docs/plans/first-class-acp-gateway-extension.dag.toml#provider_matrix.codex",
     },
     claude: {
@@ -42,10 +42,10 @@ export const ACP_ENTRYPOINT_CONTRACTS = {
         status: "adapter_mediated_deferred",
         executable: "claude",
         entrypointArgs: [],
-        targetVersion: "claude 2.1.175",
+        targetVersion: "claude 2.1.185",
         probeArgs: [],
         adapterCandidates: ["Claude Agent SDK ACP adapter"],
-        evidence: "No native Claude Code CLI ACP entrypoint at claude 2.1.175. Adapter ownership/permission bridging unresolved; deferred.",
+        evidence: "No native Claude Code CLI ACP entrypoint at claude 2.1.185. Adapter ownership/permission bridging unresolved; deferred.",
         docsRef: "docs/plans/first-class-acp-gateway-extension.dag.toml#provider_matrix.claude",
     },
     gemini: {
@@ -54,11 +54,22 @@ export const ACP_ENTRYPOINT_CONTRACTS = {
         status: "absent_watchlist",
         executable: "agy",
         entrypointArgs: [],
-        targetVersion: "agy 1.0.7",
+        targetVersion: "agy 1.0.10",
         probeArgs: [],
-        evidence: "agy 1.0.7 has no ACP flag or subcommand. Legacy Gemini CLI ACP evidence does not transfer. Watchlist item.",
+        evidence: "agy 1.0.10 has no ACP flag or subcommand. Legacy Gemini CLI ACP evidence does not transfer. Watchlist item.",
         docsRef: "docs/plans/first-class-acp-gateway-extension.dag.toml#provider_matrix.gemini",
     },
+    devin: {
+        cli: "devin",
+        displayName: "Cognition Devin CLI",
+        status: "native",
+        executable: "devin",
+        entrypointArgs: ["acp"],
+        targetVersion: "devin 2026.7.23 (3bd47f77)",
+        probeArgs: [["--version"]],
+        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",
+    },
 };
 const PERMISSION_MODES = [
     "default",
@@ -136,6 +147,7 @@ export const UPSTREAM_CLI_CONTRACTS = {
             agents: subcommand(["agents"], "Inspect and manage Claude agent definitions.", "writes_local_config", [
                 "--add-dir",
                 "--agent",
+                "--all",
                 "--allow-dangerously-skip-permissions",
                 "--cwd",
                 "--dangerously-skip-permissions",
@@ -294,6 +306,7 @@ export const UPSTREAM_CLI_CONTRACTS = {
         acknowledgedUpstreamFlags: [
             "--allow-dangerously-skip-permissions",
             "--allowed",
+            "--ax-screen-reader",
             "--bare",
             "--betas",
             "--brief",
@@ -318,6 +331,7 @@ export const UPSTREAM_CLI_CONTRACTS = {
             "--remote-control-session-name-prefix",
             "--replay-user-messages",
             "--resume",
+            "--safe-mode",
             "--tmux",
             "--version",
             "--worktree",
@@ -460,33 +474,40 @@ export const UPSTREAM_CLI_CONTRACTS = {
             ], {
                 children: {
                     resume: subcommand(["exec", "resume"], "Resume Codex sessions from the interactive CLI.", "executes_agent", [
-                        "--add-dir",
                         "--all",
-                        "--cd",
                         "--config",
                         "--dangerously-bypass-approvals-and-sandbox",
                         "--dangerously-bypass-hook-trust",
                         "--disable",
                         "--enable",
+                        "--ephemeral",
+                        "--ignore-rules",
+                        "--ignore-user-config",
                         "--image",
-                        "--include-non-interactive",
+                        "--json",
                         "--last",
-                        "--local-provider",
                         "--model",
-                        "--no-alt-screen",
-                        "--oss",
-                        "--profile",
-                        "--remote",
-                        "--remote-auth-token-env",
-                        "--sandbox",
+                        "--output-last-message",
+                        "--output-schema",
+                        "--skip-git-repo-check",
                         "--strict-config",
                     ]),
                     review: subcommand(["exec", "review"], "Run Codex code review workflows.", "executes_agent", [
                         "--base",
                         "--commit",
                         "--config",
+                        "--dangerously-bypass-approvals-and-sandbox",
+                        "--dangerously-bypass-hook-trust",
                         "--disable",
                         "--enable",
+                        "--ephemeral",
+                        "--ignore-rules",
+                        "--ignore-user-config",
+                        "--json",
+                        "--model",
+                        "--output-last-message",
+                        "--output-schema",
+                        "--skip-git-repo-check",
                         "--strict-config",
                         "--title",
                         "--uncommitted",
@@ -1011,6 +1032,17 @@ export const UPSTREAM_CLI_CONTRACTS = {
                 },
             }),
             completions: subcommand(["completions"], "Generate Grok shell completions.", "read_only", ["--leader-socket"], { tier: "inspect" }),
+            dashboard: subcommand(["dashboard"], "Open the Agent Dashboard view at startup.", "read_only", ["--leader-socket"], {
+                tier: "inspect",
+                fixtures: [
+                    {
+                        id: "grok-dashboard",
+                        description: "grok dashboard subcommand (leader socket passthrough)",
+                        args: ["--leader-socket", "/tmp/dash.sock"],
+                        expect: "pass",
+                    },
+                ],
+            }),
             export: subcommand(["export"], "Export Grok session data.", "read_only", ["--clipboard", "--leader-socket"], { tier: "inspect" }),
             import: subcommand(["import"], "Import Grok session data.", "writes_local_config", [
                 "--json",
@@ -1186,7 +1218,11 @@ export const UPSTREAM_CLI_CONTRACTS = {
                 description: "Custom leader socket path (isolated leader, Grok 0.2.32+)",
             },
             "--single": { arity: "one", description: "Single-turn prompt" },
-            "--todo-gate": { arity: "none", description: "Enable runtime turn-end TodoGate" },
+            "--todo-gate": {
+                arity: "none",
+                description: "Enable runtime turn-end TodoGate (accepted at 0.2.60+ but hidden from --help)",
+                hiddenFromHelp: true,
+            },
             "--verbatim": { arity: "none", description: "Send prompt exactly as given" },
             "--version": { arity: "none", description: "Print version" },
             "--worktree": {
@@ -1197,11 +1233,13 @@ export const UPSTREAM_CLI_CONTRACTS = {
                 arity: "one",
                 values: ["summary", "transcript", "segments"],
                 description: "Compaction mode (default summary; sets GROK_COMPACTION_MODE). `segments` persists per-segment markdown.",
+                hiddenFromHelp: true,
             },
             "--compaction-detail": {
                 arity: "one",
                 values: ["none", "minimal", "balanced", "verbose"],
                 description: "Segment verbatim detail (default verbose; sets GROK_COMPACTION_DETAIL). Only affects `--compaction-mode segments`.",
+                hiddenFromHelp: true,
             },
         },
         env: {},
@@ -1366,7 +1404,7 @@ export const UPSTREAM_CLI_CONTRACTS = {
         executable: "vibe",
         upstream: "Mistral Vibe CLI",
         upstreamMetadata: {
-            sourceUrls: ["https://github.com/mistralai/mistral-vibe/releases"],
+            sourceUrls: ["https://api.github.com/repos/mistralai/mistral-vibe/releases/latest"],
             packageName: "mistral-vibe",
             repo: "https://github.com/mistralai/mistral-vibe",
             installDocsUrl: "https://github.com/mistralai/mistral-vibe#installation",
@@ -1412,8 +1450,7 @@ export const UPSTREAM_CLI_CONTRACTS = {
             },
             "--agent": {
                 arity: "one",
-                values: ["default", "plan", "accept-edits", "auto-approve", "chat", "explore", "lean"],
-                description: "Agent/permission mode",
+                description: "Agent/permission mode (builtin, install-gated, or custom agent name)",
             },
             "--enabled-tools": { arity: "one", description: "Enabled tool" },
             "--resume": {
@@ -1449,6 +1486,7 @@ export const UPSTREAM_CLI_CONTRACTS = {
                 description: "Additional writable workspace directory (Phase 4 slice ζ; repeat once per directory)",
             },
         },
+        acknowledgedUpstreamFlags: ["--auto-approve", "--check-upgrade", "--yolo"],
         env: {
             VIBE_ACTIVE_MODEL: {
                 arity: "one",
@@ -1547,11 +1585,25 @@ export const UPSTREAM_CLI_CONTRACTS = {
             },
             {
                 id: "mistral-current-help-surface",
-                description: "Vibe 2.12.x help surface: --prompt, -v, --version, --setup accepted",
+                description: "Vibe 2.17.1 request-time help surface: --prompt, -v, --version, --setup accepted",
                 args: ["--prompt", "hello", "--agent", "auto-approve", "-v", "--version", "--setup"],
                 env: { VIBE_ACTIVE_MODEL: "mistral-medium-3.5" },
                 expect: "pass",
             },
+            {
+                id: "mistral-yolo-shortcut-rejected",
+                description: "Vibe 2.17.1 advertises --yolo as a shortcut, but the gateway keeps using explicit --agent auto-approve",
+                args: ["-p", "hello", "--yolo"],
+                env: { VIBE_ACTIVE_MODEL: "mistral-medium-3.5" },
+                expect: "fail",
+            },
+            {
+                id: "mistral-check-upgrade-rejected",
+                description: "Vibe 2.17.1 advertises --check-upgrade, but gateway request validation rejects update-prompt flags",
+                args: ["--check-upgrade"],
+                env: { VIBE_ACTIVE_MODEL: "mistral-medium-3.5" },
+                expect: "fail",
+            },
             {
                 id: "mistral-resume-bare",
                 description: "Vibe --resume without session ID is accepted (optional arity)",
@@ -1561,6 +1613,112 @@ export const UPSTREAM_CLI_CONTRACTS = {
             },
         ],
     },
+    devin: {
+        cli: "devin",
+        executable: "devin",
+        upstream: "Cognition Devin CLI",
+        upstreamMetadata: {
+            sourceUrls: ["https://cli.devin.ai/docs/reference/commands", "https://docs.devin.ai/cli"],
+            packageName: "devin",
+            installDocsUrl: "https://docs.devin.ai/cli",
+            releaseChannel: "vendor",
+            watchCategories: ["flags", "subcommands", "permission-modes", "acp-entrypoint"],
+        },
+        helpArgs: [["--help"]],
+        subcommands: {},
+        maxPositionals: 0,
+        mcpTools: ["devin_request", "devin_request_async"],
+        mcpParameters: [
+            "prompt",
+            "model",
+            "permissionMode",
+            "sessionId",
+            "resumeLatest",
+            "createNewSession",
+            "promptFile",
+        ],
+        flags: {
+            "-p": {
+                arity: "one",
+                description: "Print response and exit (non-interactive); prompt value",
+            },
+            "--model": { arity: "one", description: "AI model for this session" },
+            "--permission-mode": {
+                arity: "one",
+                values: ["auto", "smart", "dangerous"],
+                description: "Permission mode (auto = read-only auto-approve; smart = additionally auto-runs safe actions per fast model; dangerous = approve all)",
+            },
+            "--prompt-file": { arity: "one", description: "Load the initial prompt from a file" },
+            "--resume": { arity: "one", description: "Resume a specific session by ID" },
+            "--continue": { arity: "none", description: "Resume the most recent session in cwd" },
+        },
+        acknowledgedUpstreamFlags: [
+            "--agent-config",
+            "--config",
+            "--export",
+            "--print",
+            "--respect-workspace-trust",
+            "--sandbox",
+            "--version",
+        ],
+        env: {},
+        conformanceFixtures: [
+            {
+                id: "devin-minimal",
+                description: "Minimal print-mode prompt request",
+                args: ["-p", "hello"],
+                expect: "pass",
+            },
+            {
+                id: "devin-unsupported-flag",
+                description: "Unsupported flag is rejected before spawn",
+                args: ["-p", "hello", "--not-a-devin-flag"],
+                expect: "fail",
+            },
+            {
+                id: "devin-model",
+                description: "--model is accepted",
+                args: ["-p", "hello", "--model", "opus"],
+                expect: "pass",
+            },
+            {
+                id: "devin-permission-mode",
+                description: "Valid --permission-mode 'dangerous' accepted",
+                args: ["-p", "hello", "--permission-mode", "dangerous"],
+                expect: "pass",
+            },
+            {
+                id: "devin-permission-mode-auto",
+                description: "Valid --permission-mode 'auto' accepted",
+                args: ["-p", "hello", "--permission-mode", "auto"],
+                expect: "pass",
+            },
+            {
+                id: "devin-permission-mode-smart",
+                description: "Valid --permission-mode 'smart' accepted",
+                args: ["-p", "hello", "--permission-mode", "smart"],
+                expect: "pass",
+            },
+            {
+                id: "devin-permission-mode-invalid",
+                description: "Invalid --permission-mode value rejected by contract",
+                args: ["-p", "hello", "--permission-mode", "ludicrous"],
+                expect: "fail",
+            },
+            {
+                id: "devin-prompt-file",
+                description: "--prompt-file is accepted",
+                args: ["-p", "hello", "--prompt-file", "/tmp/prompt.txt"],
+                expect: "pass",
+            },
+            {
+                id: "devin-resume",
+                description: "Resume by session id accepted",
+                args: ["-p", "hello", "--resume", "abc12345"],
+                expect: "pass",
+            },
+        ],
+    },
 };
 export function validateUpstreamCliArgs(cli, args) {
     const contract = UPSTREAM_CLI_CONTRACTS[cli];
@@ -1936,6 +2094,8 @@ export function extractDiscoveredFlags(helpText) {
             const name = `--${match[1].toLowerCase().replace(/_/g, "-")}`;
             if (name === "--help")
                 continue;
+            if (name.endsWith("-"))
+                continue;
             discovered.add(name);
         }
     }

package/dist/validation-normalizer.d.ts

@@ -1,5 +1,5 @@
-import type { AsyncJobResult, AsyncJobSnapshot } from "./async-job-manager.js";
-export type ValidationProvider = "claude" | "codex" | "gemini" | "grok" | "mistral";
+import type { AsyncJobResult, AsyncJobSnapshot, JobProvider } from "./async-job-manager.js";
+export type ValidationProvider = JobProvider;
 export type NormalizedValidationStatus = "running" | "completed" | "failed" | "canceled" | "orphaned" | "skipped";
 export interface RawJobReference {
     jobId: string;

package/dist/validation-orchestrator.d.ts

@@ -1,11 +1,13 @@
 import type { AsyncJobManager } from "./async-job-manager.js";
 import { type ProviderRuntimeStatus } from "./provider-status.js";
+import type { ApiProviderRuntime } from "./config.js";
 import { type NormalizedValidationResult, type ValidationProvider } from "./validation-normalizer.js";
 import { type ValidationReport } from "./validation-report.js";
 import { type ValidationIntent } from "./validation-prompts.js";
 export interface ValidationOrchestratorDeps {
     asyncJobManager: AsyncJobManager;
     getProviderRuntimeStatus?: (provider: ValidationProvider) => ProviderRuntimeStatus;
+    apiProviders?: ApiProviderRuntime[];
 }
 export interface StartValidationInput {
     intent: ValidationIntent;

package/dist/validation-orchestrator.js

@@ -1,8 +1,31 @@
 import { randomUUID } from "node:crypto";
 import { getProviderRuntimeStatus } from "./provider-status.js";
+import { createApiProvider } from "./api-provider.js";
+import { prepareApiRequest } from "./api-request.js";
 import { normalizeJobResult, normalizeSkippedProvider, normalizeStartedJob, } from "./validation-normalizer.js";
 import { buildValidationReport } from "./validation-report.js";
 import { buildJudgePrompt, buildValidationPrompt, } from "./validation-prompts.js";
+function findApiReviewer(deps, provider) {
+    return deps.apiProviders?.find(p => p.name === provider) ?? null;
+}
+function resolveReviewerStatus(deps, provider) {
+    const api = findApiReviewer(deps, provider);
+    if (api) {
+        return { installed: true, version: null, loginStatus: "authenticated", displayName: api.name };
+    }
+    const runtimeStatus = deps.getProviderRuntimeStatus ?? getProviderRuntimeStatus;
+    return runtimeStatus(provider);
+}
+function dispatchProviderJob(deps, provider, prompt, correlationId) {
+    const api = findApiReviewer(deps, provider);
+    if (api) {
+        const apiProvider = createApiProvider(api.name, api.kind);
+        const apiRequest = prepareApiRequest(api, { prompt });
+        return deps.asyncJobManager.startHttpJob({ provider: apiProvider, apiRequest, correlationId })
+            .snapshot;
+    }
+    return deps.asyncJobManager.startJob(provider, buildProviderArgs(provider, prompt), correlationId);
+}
 export function startValidationRun(deps, input) {
     const validationId = randomUUID();
     const startedAt = new Date().toISOString();
@@ -67,8 +90,7 @@ export function startJudgeSynthesis(deps, input) {
             note: "Judge synthesis requires at least one completed provider result; skipped, failed, canceled, or orphaned results are preserved in the report but are not judge evidence.",
         };
     }
-    const runtimeStatus = deps.getProviderRuntimeStatus ?? getProviderRuntimeStatus;
-    const runtime = runtimeStatus(input.judgeProvider);
+    const runtime = resolveReviewerStatus(deps, input.judgeProvider);
     if (!runtime.installed) {
         return {
             status: "skipped",
@@ -77,10 +99,10 @@ export function startJudgeSynthesis(deps, input) {
             note: `${runtime.displayName} was selected as judge but is not installed.`,
         };
     }
-    const snapshot = deps.asyncJobManager.startJob(input.judgeProvider, buildProviderArgs(input.judgeProvider, buildJudgePrompt({
+    const snapshot = dispatchProviderJob(deps, input.judgeProvider, buildJudgePrompt({
         question: input.question,
         providerResults: completedResults,
-    })), `validation-judge-${randomUUID()}-${input.judgeProvider}`);
+    }), `validation-judge-${randomUUID()}-${input.judgeProvider}`);
     return {
         status: "running",
         judgeModel: input.judgeProvider,
@@ -102,15 +124,14 @@ export function collectValidationJobResult(deps, provider, jobId, model, maxChar
     return normalizeJobResult(provider, model, result);
 }
 function startProviderJob(deps, provider, prompt, validationId) {
-    const runtimeStatus = deps.getProviderRuntimeStatus ?? getProviderRuntimeStatus;
-    const runtime = runtimeStatus(provider);
+    const runtime = resolveReviewerStatus(deps, provider);
     if (!runtime.installed) {
         return normalizeSkippedProvider(provider, `${runtime.displayName} runtime is not installed.`);
     }
     const warning = runtime.loginStatus === "authenticated"
         ? undefined
         : `${runtime.displayName} login status is ${runtime.loginStatus}; the job may fail until login is complete.`;
-    const snapshot = deps.asyncJobManager.startJob(provider, buildProviderArgs(provider, prompt), `validation-${validationId}-${provider}`);
+    const snapshot = dispatchProviderJob(deps, provider, prompt, `validation-${validationId}-${provider}`);
     return normalizeStartedJob(provider, runtime.version, snapshot, warning);
 }
 function plannedJudgeSynthesis(input) {