mcp-codex-worker 0.1.11 → 0.1.12

package/dist/src/execution/base-adapter.d.ts

@@ -0,0 +1,63 @@
+import type { TaskHandle } from '../task/task-handle.js';
+import type { Provider } from '../task/task-state.js';
+import type { ProviderCapabilities } from './provider-capabilities.js';
+/**
+ * Options passed to `BaseProviderAdapter.spawn()` to start a provider session.
+ */
+export interface ProviderSpawnOptions {
+    taskId: string;
+    prompt: string;
+    cwd: string;
+    timeout: number;
+    model?: string;
+}
+/**
+ * Result of an availability check on a provider adapter.
+ */
+export type AvailabilityResult = {
+    available: true;
+} | {
+    available: false;
+    reason: string;
+};
+/**
+ * Base class for all provider adapters.
+ *
+ * Implements the Template Method pattern: `spawn()` provides the common
+ * lifecycle skeleton (abort controller, timeout, error handling) and
+ * delegates the actual provider interaction to `executeSession()`.
+ */
+export declare abstract class BaseProviderAdapter {
+    /** Unique provider identifier. */
+    abstract readonly id: Provider;
+    /** Human-readable display name. */
+    abstract readonly displayName: string;
+    /** Check whether the provider is currently available. */
+    abstract checkAvailability(): AvailabilityResult;
+    /** Return the capability matrix for this provider. */
+    abstract getCapabilities(): ProviderCapabilities;
+    /** Return runtime statistics for observability. */
+    abstract getStats(): Record<string, unknown>;
+    /**
+     * Template Method hook — the actual provider session logic.
+     * Subclasses implement this to drive the provider (spawn process, call API, etc.).
+     */
+    protected abstract executeSession(handle: TaskHandle, prompt: string, signal: AbortSignal, options: ProviderSpawnOptions): Promise<void>;
+    /**
+     * Spawn a provider session for the given task.
+     *
+     * Template method: checks terminal state, sets up AbortController + timeout,
+     * calls `executeSession`, and handles errors.
+     */
+    spawn(options: ProviderSpawnOptions, handle: TaskHandle): Promise<void>;
+    /**
+     * Attempt to abort a running task by ID.
+     * Default implementation returns false (not supported).
+     */
+    abort(_taskId: string): Promise<boolean>;
+    /**
+     * Graceful shutdown hook. Called when the server is stopping.
+     * Default implementation is a no-op.
+     */
+    shutdown(): Promise<void>;
+}

package/dist/src/execution/base-adapter.js

@@ -0,0 +1,74 @@
+// ---------------------------------------------------------------------------
+// BaseProviderAdapter — Template Method pattern for provider lifecycle
+// Spec reference: §3.4
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// Abstract class
+// ---------------------------------------------------------------------------
+/**
+ * Base class for all provider adapters.
+ *
+ * Implements the Template Method pattern: `spawn()` provides the common
+ * lifecycle skeleton (abort controller, timeout, error handling) and
+ * delegates the actual provider interaction to `executeSession()`.
+ */
+export class BaseProviderAdapter {
+    // -- Public lifecycle methods ---------------------------------------------
+    /**
+     * Spawn a provider session for the given task.
+     *
+     * Template method: checks terminal state, sets up AbortController + timeout,
+     * calls `executeSession`, and handles errors.
+     */
+    async spawn(options, handle) {
+        // Guard: do nothing if already in a terminal state
+        if (handle.isTerminal()) {
+            return;
+        }
+        const controller = new AbortController();
+        handle.registerAbort(controller);
+        let timer;
+        if (options.timeout > 0) {
+            timer = setTimeout(() => {
+                controller.abort();
+            }, options.timeout);
+            // Allow the Node.js process to exit even if this timer is pending
+            if (timer && typeof timer === 'object' && 'unref' in timer) {
+                timer.unref();
+            }
+        }
+        try {
+            await this.executeSession(handle, options.prompt, controller.signal, options);
+        }
+        catch (err) {
+            if (controller.signal.aborted) {
+                handle.markCancelled('Session timed out');
+            }
+            else {
+                const message = err instanceof Error ? err.message : String(err);
+                handle.markFailed(message);
+            }
+        }
+        finally {
+            if (timer !== undefined) {
+                clearTimeout(timer);
+            }
+            handle.unregisterAbort();
+        }
+    }
+    /**
+     * Attempt to abort a running task by ID.
+     * Default implementation returns false (not supported).
+     */
+    async abort(_taskId) {
+        return false;
+    }
+    /**
+     * Graceful shutdown hook. Called when the server is stopping.
+     * Default implementation is a no-op.
+     */
+    async shutdown() {
+        // no-op by default
+    }
+}
+//# sourceMappingURL=base-adapter.js.map

package/dist/src/execution/base-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-adapter.js","sourceRoot":"","sources":["../../../src/execution/base-adapter.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,uEAAuE;AACvE,uBAAuB;AACvB,8EAA8E;AA4B9E,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,OAAgB,mBAAmB;IA6BvC,4EAA4E;IAE5E;;;;;OAKG;IACH,KAAK,CAAC,KAAK,CAAC,OAA6B,EAAE,MAAkB;QAC3D,mDAAmD;QACnD,IAAI,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QAEjC,IAAI,KAAgD,CAAC;QAErD,IAAI,OAAO,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YACxB,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBACtB,UAAU,CAAC,KAAK,EAAE,CAAC;YACrB,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;YACpB,kEAAkE;YAClE,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;gBAC3D,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChF,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC9B,MAAM,CAAC,aAAa,CAAC,mBAAmB,CAAC,CAAC;YAC5C,CAAC;iBAAM,CAAC;gBACN,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjE,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,YAAY,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;YACD,MAAM,CAAC,eAAe,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,OAAe;QACzB,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ;QACZ,mBAAmB;IACrB,CAAC;CACF"}

package/dist/src/execution/claude-adapter.d.ts

@@ -0,0 +1,12 @@
+import type { Provider } from '../task/task-state.js';
+import type { TaskHandle } from '../task/task-handle.js';
+import type { ProviderCapabilities } from './provider-capabilities.js';
+import { BaseProviderAdapter, type ProviderSpawnOptions, type AvailabilityResult } from './base-adapter.js';
+export declare class ClaudeAdapter extends BaseProviderAdapter {
+    readonly id: Provider;
+    readonly displayName = "Claude";
+    checkAvailability(): AvailabilityResult;
+    getCapabilities(): ProviderCapabilities;
+    getStats(): Record<string, unknown>;
+    protected executeSession(_handle: TaskHandle, _prompt: string, _signal: AbortSignal, _options: ProviderSpawnOptions): Promise<void>;
+}

package/dist/src/execution/claude-adapter.js

@@ -0,0 +1,23 @@
+// ---------------------------------------------------------------------------
+// ClaudeAdapter — Phase 2 stub
+// Spec reference: §3.4
+// ---------------------------------------------------------------------------
+import { CLAUDE_CAPABILITIES } from './provider-capabilities.js';
+import { BaseProviderAdapter, } from './base-adapter.js';
+export class ClaudeAdapter extends BaseProviderAdapter {
+    id = 'claude-cli';
+    displayName = 'Claude';
+    checkAvailability() {
+        return { available: false, reason: 'Phase 2 — not yet implemented' };
+    }
+    getCapabilities() {
+        return CLAUDE_CAPABILITIES;
+    }
+    getStats() {
+        return {};
+    }
+    async executeSession(_handle, _prompt, _signal, _options) {
+        throw new Error('Not implemented — Phase 2');
+    }
+}
+//# sourceMappingURL=claude-adapter.js.map

package/dist/src/execution/claude-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-adapter.js","sourceRoot":"","sources":["../../../src/execution/claude-adapter.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,+BAA+B;AAC/B,uBAAuB;AACvB,8EAA8E;AAK9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EACL,mBAAmB,GAGpB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,OAAO,aAAc,SAAQ,mBAAmB;IAC3C,EAAE,GAAa,YAAY,CAAC;IAC5B,WAAW,GAAG,QAAQ,CAAC;IAEhC,iBAAiB;QACf,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,+BAA+B,EAAE,CAAC;IACvE,CAAC;IAED,eAAe;QACb,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,QAAQ;QACN,OAAO,EAAE,CAAC;IACZ,CAAC;IAES,KAAK,CAAC,cAAc,CAC5B,OAAmB,EACnB,OAAe,EACf,OAAoB,EACpB,QAA8B;QAE9B,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;CACF"}

package/dist/src/execution/codex-adapter.d.ts

@@ -0,0 +1,21 @@
+import type { Provider } from '../task/task-state.js';
+import type { TaskHandle } from '../task/task-handle.js';
+import type { ProviderCapabilities } from './provider-capabilities.js';
+import { BaseProviderAdapter, type ProviderSpawnOptions, type AvailabilityResult } from './base-adapter.js';
+export interface CodexAdapterOptions {
+    command?: string;
+    args?: string[];
+    env?: NodeJS.ProcessEnv;
+}
+export declare class CodexAdapter extends BaseProviderAdapter {
+    readonly id: Provider;
+    readonly displayName = "Codex";
+    private readonly options;
+    private runtime?;
+    constructor(options: CodexAdapterOptions);
+    checkAvailability(): AvailabilityResult;
+    getCapabilities(): ProviderCapabilities;
+    getStats(): Record<string, unknown>;
+    protected executeSession(_handle: TaskHandle, _prompt: string, _signal: AbortSignal, _options: ProviderSpawnOptions): Promise<void>;
+    shutdown(): Promise<void>;
+}

package/dist/src/execution/codex-adapter.js

@@ -0,0 +1,35 @@
+// ---------------------------------------------------------------------------
+// CodexAdapter — wraps CodexRuntime behind the BaseProviderAdapter contract
+// Spec reference: §3.4
+// ---------------------------------------------------------------------------
+import { CODEX_CAPABILITIES } from './provider-capabilities.js';
+import { BaseProviderAdapter, } from './base-adapter.js';
+// ---------------------------------------------------------------------------
+// Adapter
+// ---------------------------------------------------------------------------
+export class CodexAdapter extends BaseProviderAdapter {
+    id = 'codex';
+    displayName = 'Codex';
+    options;
+    runtime;
+    constructor(options) {
+        super();
+        this.options = options;
+    }
+    checkAvailability() {
+        return { available: true };
+    }
+    getCapabilities() {
+        return CODEX_CAPABILITIES;
+    }
+    getStats() {
+        return {};
+    }
+    async executeSession(_handle, _prompt, _signal, _options) {
+        throw new Error('CodexAdapter.executeSession is not yet implemented');
+    }
+    async shutdown() {
+        await this.runtime?.shutdown();
+    }
+}
+//# sourceMappingURL=codex-adapter.js.map

package/dist/src/execution/codex-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-adapter.js","sourceRoot":"","sources":["../../../src/execution/codex-adapter.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,4EAA4E;AAC5E,uBAAuB;AACvB,8EAA8E;AAK9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EACL,mBAAmB,GAGpB,MAAM,mBAAmB,CAAC;AAa3B,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,MAAM,OAAO,YAAa,SAAQ,mBAAmB;IAC1C,EAAE,GAAa,OAAO,CAAC;IACvB,WAAW,GAAG,OAAO,CAAC;IAEd,OAAO,CAAsB;IACtC,OAAO,CAAgB;IAE/B,YAAY,OAA4B;QACtC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,iBAAiB;QACf,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAC7B,CAAC;IAED,eAAe;QACb,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,QAAQ;QACN,OAAO,EAAE,CAAC;IACZ,CAAC;IAES,KAAK,CAAC,cAAc,CAC5B,OAAmB,EACnB,OAAe,EACf,OAAoB,EACpB,QAA8B;QAE9B,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC;IACjC,CAAC;CACF"}

package/dist/src/execution/codex-pause-flow.d.ts

@@ -0,0 +1,23 @@
+import type { AppServerClient } from '../services/app-server-client.js';
+import type { TaskHandle } from '../task/task-handle.js';
+import type { PendingQuestion } from '../task/task-state.js';
+import type { JsonLineRequest } from '../types/codex.js';
+/**
+ * Translate a raw Codex JSON-RPC server request into a provider-blind
+ * PendingQuestion variant.
+ *
+ * Returns `null` for:
+ * - Guardian Subagent auto-approval events (method contains `autoApprovalReview`)
+ * - Unrecognised / unmapped methods
+ *
+ * Spec reference: §6.1, §6.2
+ */
+export declare function translateCodexRequestToPendingQuestion(req: JsonLineRequest): PendingQuestion | null;
+/**
+ * Listen for `server-request` events on the AppServerClient, translate each
+ * to a PendingQuestion, queue it on the handle, and transition to
+ * WAITING_ANSWER. Returns an unsubscribe function.
+ *
+ * Spec reference: §6.2, §6.3
+ */
+export declare function attachPauseFlow(client: AppServerClient, handle: TaskHandle, threadId: string): () => void;

package/dist/src/execution/codex-pause-flow.js

@@ -0,0 +1,185 @@
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function asObject(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return undefined;
+    }
+    return value;
+}
+function asArray(value) {
+    return Array.isArray(value) ? value : undefined;
+}
+function asString(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+// ---------------------------------------------------------------------------
+// Translation: Codex server-request → PendingQuestion
+// ---------------------------------------------------------------------------
+/**
+ * Translate a raw Codex JSON-RPC server request into a provider-blind
+ * PendingQuestion variant.
+ *
+ * Returns `null` for:
+ * - Guardian Subagent auto-approval events (method contains `autoApprovalReview`)
+ * - Unrecognised / unmapped methods
+ *
+ * Spec reference: §6.1, §6.2
+ */
+export function translateCodexRequestToPendingQuestion(req) {
+    // Guardian Subagent bypass (PR #13860) — never surface as a pause
+    if (req.method.includes('autoApprovalReview')) {
+        return null;
+    }
+    const params = asObject(req.params);
+    const requestId = String(req.id);
+    switch (req.method) {
+        // -- user_input --------------------------------------------------------
+        case 'tool/requestUserInput':
+        case 'item/tool/requestUserInput': {
+            const rawQuestions = asArray(params?.questions) ?? [];
+            const questions = rawQuestions.map((raw) => {
+                const q = asObject(raw) ?? {};
+                return {
+                    id: asString(q.id) ?? '',
+                    text: asString(q.text) ?? asString(q.question) ?? '',
+                    ...(asArray(q.options)
+                        ? { options: q.options.map(String) }
+                        : {}),
+                    ...(q.isOther !== undefined || q.allowEmpty !== undefined
+                        ? { allowFreeform: Boolean(q.isOther ?? q.allowEmpty) }
+                        : {}),
+                };
+            });
+            return { type: 'user_input', requestId, questions };
+        }
+        // -- command_approval --------------------------------------------------
+        case 'item/commandExecution/requestApproval':
+        case 'execCommandApproval': {
+            const command = asString(params?.command) ?? '';
+            const sandboxPolicy = asString(params?.sandbox_policy) ?? asString(params?.sandboxPolicy);
+            return {
+                type: 'command_approval',
+                requestId,
+                command,
+                ...(sandboxPolicy !== undefined ? { sandboxPolicy } : {}),
+            };
+        }
+        // -- file_approval -----------------------------------------------------
+        case 'item/fileChange/requestApproval':
+        case 'applyPatchApproval': {
+            const rawChanges = asArray(params?.file_changes) ?? asArray(params?.fileChanges) ?? [];
+            const fileChanges = rawChanges.map((raw) => {
+                const fc = asObject(raw) ?? {};
+                return {
+                    path: asString(fc.path) ?? '',
+                    patch: asString(fc.patch) ?? '',
+                };
+            });
+            return { type: 'file_approval', requestId, fileChanges };
+        }
+        // -- elicitation -------------------------------------------------------
+        case 'mcpServer/elicitation/request': {
+            const serverName = asString(params?.server_name) ?? asString(params?.serverName);
+            const message = asString(params?.message) ?? '';
+            const schema = params?.schema;
+            return {
+                type: 'elicitation',
+                requestId,
+                ...(serverName !== undefined ? { serverName } : {}),
+                message,
+                ...(schema !== undefined ? { schema } : {}),
+            };
+        }
+        // -- dynamic_tool ------------------------------------------------------
+        case 'item/tool/call': {
+            const toolName = asString(params?.tool_name) ?? asString(params?.toolName) ?? '';
+            const rawArgs = params?.arguments;
+            const args = typeof rawArgs === 'string'
+                ? rawArgs
+                : rawArgs !== undefined
+                    ? JSON.stringify(rawArgs)
+                    : '{}';
+            return { type: 'dynamic_tool', requestId, toolName, arguments: args };
+        }
+        default:
+            return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Elicitation auto-decline (Issue #11816 workaround)
+// ---------------------------------------------------------------------------
+const ELICITATION_AUTO_DECLINE_MS = 30_000;
+function scheduleElicitationAutoDecline(client, handle, question, timeoutMs = ELICITATION_AUTO_DECLINE_MS) {
+    const timer = setTimeout(() => {
+        const still = handle
+            .getPendingQuestions()
+            .find((q) => q.requestId === question.requestId);
+        if (!still)
+            return;
+        client
+            .respondToServerRequest(question.requestId, {
+            action: 'decline',
+            content: {},
+        })
+            .catch(() => { });
+        const head = handle.getPendingQuestions()[0];
+        if (head?.requestId === question.requestId) {
+            handle.dequeuePendingQuestion();
+        }
+        handle.writeOutput(`[elicitation] auto-declined after ${timeoutMs}ms (issue #11816 workaround)`);
+    }, timeoutMs);
+    timer.unref();
+}
+// ---------------------------------------------------------------------------
+// Attachment: wire pause-flow onto an AppServerClient + TaskHandle
+// ---------------------------------------------------------------------------
+function extractThreadIdFromParams(params) {
+    const obj = asObject(params);
+    const threadId = obj?.threadId;
+    if (typeof threadId === 'string')
+        return threadId;
+    const thread = asObject(obj?.thread);
+    if (typeof thread?.id === 'string')
+        return thread.id;
+    return undefined;
+}
+/**
+ * Listen for `server-request` events on the AppServerClient, translate each
+ * to a PendingQuestion, queue it on the handle, and transition to
+ * WAITING_ANSWER. Returns an unsubscribe function.
+ *
+ * Spec reference: §6.2, §6.3
+ */
+export function attachPauseFlow(client, handle, threadId) {
+    const onServerRequest = (pending) => {
+        const reqThreadId = extractThreadIdFromParams(pending.params);
+        if (reqThreadId !== threadId)
+            return;
+        // Guardian Subagent bypass — log but don't surface
+        if (pending.method.includes('autoApprovalReview')) {
+            handle.writeOutputFileOnly(`[guardian] ${pending.method}`);
+            return;
+        }
+        const req = {
+            method: pending.method,
+            id: pending.id,
+            params: pending.params,
+        };
+        const question = translateCodexRequestToPendingQuestion(req);
+        if (!question)
+            return;
+        handle.queuePendingQuestion(question);
+        if (!handle.isTerminal()) {
+            handle.markInputRequired();
+        }
+        if (question.type === 'elicitation') {
+            scheduleElicitationAutoDecline(client, handle, question);
+        }
+    };
+    client.on('server-request', onServerRequest);
+    return () => {
+        client.off('server-request', onServerRequest);
+    };
+}
+//# sourceMappingURL=codex-pause-flow.js.map

package/dist/src/execution/codex-pause-flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-pause-flow.js","sourceRoot":"","sources":["../../../src/execution/codex-pause-flow.ts"],"names":[],"mappings":"AAKA,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,8EAA8E;AAC9E,sDAAsD;AACtD,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,UAAU,sCAAsC,CACpD,GAAoB;IAEpB,kEAAkE;IAClE,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEjC,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC;QACnB,yEAAyE;QACzE,KAAK,uBAAuB,CAAC;QAC7B,KAAK,4BAA4B,CAAC,CAAC,CAAC;YAClC,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;YACtD,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;gBACzC,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;gBAC9B,OAAO;oBACL,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE;oBACxB,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE;oBACpD,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;wBACpB,CAAC,CAAC,EAAE,OAAO,EAAG,CAAC,CAAC,OAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;wBACnD,CAAC,CAAC,EAAE,CAAC;oBACP,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS;wBACvD,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,UAAU,CAAC,EAAE;wBACvD,CAAC,CAAC,EAAE,CAAC;iBACR,CAAC;YACJ,CAAC,CAAC,CAAC;YACH,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;QACtD,CAAC;QAED,yEAAyE;QACzE,KAAK,uCAAuC,CAAC;QAC7C,KAAK,qBAAqB,CAAC,CAAC,CAAC;YAC3B,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;YAChD,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,IAAI,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;YAC1F,OAAO;gBACL,IAAI,EAAE,kBAAkB;gBACxB,SAAS;gBACT,OAAO;gBACP,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC1D,CAAC;QACJ,CAAC;QAED,yEAAyE;QACzE,KAAK,iCAAiC,CAAC;QACvC,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;YACvF,MAAM,WAAW,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;gBACzC,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;gBAC/B,OAAO;oBACL,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE;oBAC7B,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE;iBAChC,CAAC;YACJ,CAAC,CAAC,CAAC;YACH,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;QAC3D,CAAC;QAED,yEAAyE;QACzE,KAAK,+BAA+B,CAAC,CAAC,CAAC;YACrC,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YACjF,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;YAChD,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC;YAC9B,OAAO;gBACL,IAAI,EAAE,aAAa;gBACnB,SAAS;gBACT,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnD,OAAO;gBACP,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5C,CAAC;QACJ,CAAC;QAED,yEAAyE;QACzE,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;YACjF,MAAM,OAAO,GAAG,MAAM,EAAE,SAAS,CAAC;YAClC,MAAM,IAAI,GACR,OAAO,OAAO,KAAK,QAAQ;gBACzB,CAAC,CAAC,OAAO;gBACT,CAAC,CAAC,OAAO,KAAK,SAAS;oBACrB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;oBACzB,CAAC,CAAC,IAAI,CAAC;YACb,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QACxE,CAAC;QAED;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,qDAAqD;AACrD,8EAA8E;AAE9E,MAAM,2BAA2B,GAAG,MAAM,CAAC;AAE3C,SAAS,8BAA8B,CACrC,MAAuB,EACvB,MAAkB,EAClB,QAA2D,EAC3D,YAAoB,2BAA2B;IAE/C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;QAC5B,MAAM,KAAK,GAAG,MAAM;aACjB,mBAAmB,EAAE;aACrB,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,QAAQ,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,MAAM;aACH,sBAAsB,CAAC,QAAQ,CAAC,SAAS,EAAE;YAC1C,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,EAAE;SACZ,CAAC;aACD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAEnB,MAAM,IAAI,GAAG,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7C,IAAI,IAAI,EAAE,SAAS,KAAK,QAAQ,CAAC,SAAS,EAAE,CAAC;YAC3C,MAAM,CAAC,sBAAsB,EAAE,CAAC;QAClC,CAAC;QAED,MAAM,CAAC,WAAW,CAChB,qCAAqC,SAAS,8BAA8B,CAC7E,CAAC;IACJ,CAAC,EAAE,SAAS,CAAC,CAAC;IACd,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,mEAAmE;AACnE,8EAA8E;AAE9E,SAAS,yBAAyB,CAAC,MAAe;IAChD,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7B,MAAM,QAAQ,GAAG,GAAG,EAAE,QAAQ,CAAC;IAC/B,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAClD,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACrC,IAAI,OAAO,MAAM,EAAE,EAAE,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,EAAE,CAAC;IACrD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAuB,EACvB,MAAkB,EAClB,QAAgB;IAEhB,MAAM,eAAe,GAAG,CAAC,OAA6B,EAAE,EAAE;QACxD,MAAM,WAAW,GAAG,yBAAyB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC9D,IAAI,WAAW,KAAK,QAAQ;YAAE,OAAO;QAErC,mDAAmD;QACnD,IAAI,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC;YAClD,MAAM,CAAC,mBAAmB,CAAC,cAAc,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAC3D,OAAO;QACT,CAAC;QAED,MAAM,GAAG,GAAoB;YAC3B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC;QAEF,MAAM,QAAQ,GAAG,sCAAsC,CAAC,GAAG,CAAC,CAAC;QAC7D,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEtB,MAAM,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC;YACzB,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAC7B,CAAC;QAED,IAAI,QAAQ,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACpC,8BAA8B,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,CAAC,EAAE,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;IAC7C,OAAO,GAAG,EAAE;QACV,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;IAChD,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/execution/copilot-adapter.d.ts

@@ -0,0 +1,12 @@
+import type { Provider } from '../task/task-state.js';
+import type { TaskHandle } from '../task/task-handle.js';
+import type { ProviderCapabilities } from './provider-capabilities.js';
+import { BaseProviderAdapter, type ProviderSpawnOptions, type AvailabilityResult } from './base-adapter.js';
+export declare class CopilotAdapter extends BaseProviderAdapter {
+    readonly id: Provider;
+    readonly displayName = "Copilot";
+    checkAvailability(): AvailabilityResult;
+    getCapabilities(): ProviderCapabilities;
+    getStats(): Record<string, unknown>;
+    protected executeSession(_handle: TaskHandle, _prompt: string, _signal: AbortSignal, _options: ProviderSpawnOptions): Promise<void>;
+}

package/dist/src/execution/copilot-adapter.js

@@ -0,0 +1,23 @@
+// ---------------------------------------------------------------------------
+// CopilotAdapter — Phase 2 stub
+// Spec reference: §3.4
+// ---------------------------------------------------------------------------
+import { COPILOT_CAPABILITIES } from './provider-capabilities.js';
+import { BaseProviderAdapter, } from './base-adapter.js';
+export class CopilotAdapter extends BaseProviderAdapter {
+    id = 'copilot';
+    displayName = 'Copilot';
+    checkAvailability() {
+        return { available: false, reason: 'Phase 2 — not yet implemented' };
+    }
+    getCapabilities() {
+        return COPILOT_CAPABILITIES;
+    }
+    getStats() {
+        return {};
+    }
+    async executeSession(_handle, _prompt, _signal, _options) {
+        throw new Error('Not implemented — Phase 2');
+    }
+}
+//# sourceMappingURL=copilot-adapter.js.map

package/dist/src/execution/copilot-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-adapter.js","sourceRoot":"","sources":["../../../src/execution/copilot-adapter.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,gCAAgC;AAChC,uBAAuB;AACvB,8EAA8E;AAK9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EACL,mBAAmB,GAGpB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,OAAO,cAAe,SAAQ,mBAAmB;IAC5C,EAAE,GAAa,SAAS,CAAC;IACzB,WAAW,GAAG,SAAS,CAAC;IAEjC,iBAAiB;QACf,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,+BAA+B,EAAE,CAAC;IACvE,CAAC;IAED,eAAe;QACb,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED,QAAQ;QACN,OAAO,EAAE,CAAC;IACZ,CAAC;IAES,KAAK,CAAC,cAAc,CAC5B,OAAmB,EACnB,OAAe,EACf,OAAoB,EACpB,QAA8B;QAE9B,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;CACF"}

package/dist/src/execution/provider-capabilities.d.ts

@@ -0,0 +1,35 @@
+import type { PendingQuestionType } from '../task/task-state.js';
+/**
+ * Declares what a provider adapter can do at runtime.
+ * TaskManager reads these at startup and uses them to route behavior.
+ */
+export interface ProviderCapabilities {
+    /** Session survives server restart (e.g. Codex rollout files). */
+    sessionPersistence: boolean;
+    /** Distinct approve/decline protocol (e.g. Codex 4 approval types). */
+    structuredApproval: boolean;
+    /** Can stream tokens/chunks. */
+    streamingOutput: boolean;
+    /** Has explicit cancel primitive (e.g. turn/interrupt). */
+    abortPrimitive: boolean;
+    /** Supports thread/read-style probe for crash recovery. */
+    crashRecovery: boolean;
+    /** How the provider selects a model. */
+    modelRouting: 'config' | 'api-param' | 'none';
+    /** Emits structured rate-limit error. */
+    rateLimitSignal: boolean;
+    /** Subset of the 5 PendingQuestion types this provider supports. */
+    pauseTypes: readonly PendingQuestionType[];
+}
+export declare const CODEX_CAPABILITIES: Readonly<ProviderCapabilities>;
+export declare const COPILOT_CAPABILITIES: Readonly<ProviderCapabilities>;
+export declare const CLAUDE_CAPABILITIES: Readonly<ProviderCapabilities>;
+export interface ValidationResult {
+    ok: boolean;
+    reason?: string;
+}
+/**
+ * Validates that a pause type is supported by the provider's capabilities.
+ * Returns `{ ok: false, reason }` if the provider does not support the given type.
+ */
+export declare function validateResponseAgainstCapabilities(caps: ProviderCapabilities, pauseType: PendingQuestionType): ValidationResult;

package/dist/src/execution/provider-capabilities.js

@@ -0,0 +1,58 @@
+// ---------------------------------------------------------------------------
+// CapabilityMatrix — runtime-enforced provider contract
+// Spec reference: §3.4
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// Concrete capability declarations — Phase 1 matrix
+// ---------------------------------------------------------------------------
+const ALL_PAUSE_TYPES = [
+    'user_input',
+    'command_approval',
+    'file_approval',
+    'elicitation',
+    'dynamic_tool',
+];
+export const CODEX_CAPABILITIES = {
+    sessionPersistence: true,
+    structuredApproval: true,
+    streamingOutput: true,
+    abortPrimitive: true,
+    crashRecovery: true,
+    modelRouting: 'config',
+    rateLimitSignal: true,
+    pauseTypes: ALL_PAUSE_TYPES,
+};
+export const COPILOT_CAPABILITIES = {
+    sessionPersistence: false,
+    structuredApproval: false,
+    streamingOutput: true,
+    abortPrimitive: true,
+    crashRecovery: false,
+    modelRouting: 'api-param',
+    rateLimitSignal: true,
+    pauseTypes: ['user_input'],
+};
+export const CLAUDE_CAPABILITIES = {
+    sessionPersistence: false,
+    structuredApproval: false,
+    streamingOutput: true,
+    abortPrimitive: true,
+    crashRecovery: false,
+    modelRouting: 'api-param',
+    rateLimitSignal: true,
+    pauseTypes: ['user_input'],
+};
+/**
+ * Validates that a pause type is supported by the provider's capabilities.
+ * Returns `{ ok: false, reason }` if the provider does not support the given type.
+ */
+export function validateResponseAgainstCapabilities(caps, pauseType) {
+    if (caps.pauseTypes.includes(pauseType)) {
+        return { ok: true };
+    }
+    return {
+        ok: false,
+        reason: `this provider does not support ${pauseType} responses`,
+    };
+}
+//# sourceMappingURL=provider-capabilities.js.map

package/dist/src/execution/provider-capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-capabilities.js","sourceRoot":"","sources":["../../../src/execution/provider-capabilities.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wDAAwD;AACxD,uBAAuB;AACvB,8EAA8E;AA2B9E,8EAA8E;AAC9E,oDAAoD;AACpD,8EAA8E;AAE9E,MAAM,eAAe,GAAmC;IACtD,YAAY;IACZ,kBAAkB;IAClB,eAAe;IACf,aAAa;IACb,cAAc;CACN,CAAC;AAEX,MAAM,CAAC,MAAM,kBAAkB,GAAmC;IAChE,kBAAkB,EAAE,IAAI;IACxB,kBAAkB,EAAE,IAAI;IACxB,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,IAAI;IACnB,YAAY,EAAE,QAAQ;IACtB,eAAe,EAAE,IAAI;IACrB,UAAU,EAAE,eAAe;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAmC;IAClE,kBAAkB,EAAE,KAAK;IACzB,kBAAkB,EAAE,KAAK;IACzB,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,KAAK;IACpB,YAAY,EAAE,WAAW;IACzB,eAAe,EAAE,IAAI;IACrB,UAAU,EAAE,CAAC,YAAY,CAAU;CACpC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAmC;IACjE,kBAAkB,EAAE,KAAK;IACzB,kBAAkB,EAAE,KAAK;IACzB,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,KAAK;IACpB,YAAY,EAAE,WAAW;IACzB,eAAe,EAAE,IAAI;IACrB,UAAU,EAAE,CAAC,YAAY,CAAU;CACpC,CAAC;AAWF;;;GAGG;AACH,MAAM,UAAU,mCAAmC,CACjD,IAA0B,EAC1B,SAA8B;IAE9B,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACxC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC;IACD,OAAO;QACL,EAAE,EAAE,KAAK;QACT,MAAM,EAAE,kCAAkC,SAAS,YAAY;KAChE,CAAC;AACJ,CAAC"}

package/dist/src/execution/provider-registry.d.ts

@@ -0,0 +1,37 @@
+import type { Provider, TaskTypeName } from '../task/task-state.js';
+import type { BaseProviderAdapter } from './base-adapter.js';
+/**
+ * Central registry for provider adapters.
+ *
+ * Supports:
+ * - Registration by provider ID
+ * - Default fallback provider
+ * - Per-task-type routing overrides
+ * - Bulk shutdown
+ */
+export declare class ProviderRegistry {
+    private readonly adapters;
+    private defaultProvider;
+    private readonly taskTypeRoutes;
+    /** Register an adapter. Keyed by its `id` property. */
+    register(adapter: BaseProviderAdapter): void;
+    /** Set the fallback provider used when no task-type route matches. */
+    setDefault(provider: Provider): void;
+    /** Override routing for a specific task type. */
+    setTaskTypeRoute(taskType: TaskTypeName, provider: Provider): void;
+    /** Look up an adapter by provider ID. */
+    getAdapter(provider: Provider): BaseProviderAdapter | undefined;
+    /**
+     * Select the best adapter for a given task type.
+     *
+     * Resolution order:
+     * 1. Explicit task-type route
+     * 2. Default provider
+     * 3. First registered adapter (arbitrary but deterministic)
+     */
+    selectForTaskType(taskType: TaskTypeName): BaseProviderAdapter | undefined;
+    /** Return all registered adapters. */
+    getAllAdapters(): BaseProviderAdapter[];
+    /** Shut down all registered adapters in parallel. */
+    shutdownAll(): Promise<void>;
+}