mcp-codex-worker 0.1.11 → 0.1.13

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

@@ -0,0 +1,69 @@
+// ---------------------------------------------------------------------------
+// ProviderRegistry — routes task types to provider adapters
+// Spec reference: §3.4
+// ---------------------------------------------------------------------------
+/**
+ * Central registry for provider adapters.
+ *
+ * Supports:
+ * - Registration by provider ID
+ * - Default fallback provider
+ * - Per-task-type routing overrides
+ * - Bulk shutdown
+ */
+export class ProviderRegistry {
+    adapters = new Map();
+    defaultProvider;
+    taskTypeRoutes = new Map();
+    /** Register an adapter. Keyed by its `id` property. */
+    register(adapter) {
+        this.adapters.set(adapter.id, adapter);
+    }
+    /** Set the fallback provider used when no task-type route matches. */
+    setDefault(provider) {
+        this.defaultProvider = provider;
+    }
+    /** Override routing for a specific task type. */
+    setTaskTypeRoute(taskType, provider) {
+        this.taskTypeRoutes.set(taskType, provider);
+    }
+    /** Look up an adapter by provider ID. */
+    getAdapter(provider) {
+        return this.adapters.get(provider);
+    }
+    /**
+     * 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) {
+        // 1. Check explicit route
+        const routed = this.taskTypeRoutes.get(taskType);
+        if (routed !== undefined) {
+            const adapter = this.adapters.get(routed);
+            if (adapter)
+                return adapter;
+        }
+        // 2. Check default
+        if (this.defaultProvider !== undefined) {
+            const adapter = this.adapters.get(this.defaultProvider);
+            if (adapter)
+                return adapter;
+        }
+        // 3. Fall back to first registered
+        const all = Array.from(this.adapters.values());
+        return all.length > 0 ? all[0] : undefined;
+    }
+    /** Return all registered adapters. */
+    getAllAdapters() {
+        return Array.from(this.adapters.values());
+    }
+    /** Shut down all registered adapters in parallel. */
+    async shutdownAll() {
+        await Promise.all(Array.from(this.adapters.values()).map((a) => a.shutdown()));
+    }
+}
+//# sourceMappingURL=provider-registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider-registry.js","sourceRoot":"","sources":["../../../src/execution/provider-registry.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,4DAA4D;AAC5D,uBAAuB;AACvB,8EAA8E;AAK9E;;;;;;;;GAQG;AACH,MAAM,OAAO,gBAAgB;IACV,QAAQ,GAAG,IAAI,GAAG,EAAiC,CAAC;IAC7D,eAAe,CAAuB;IAC7B,cAAc,GAAG,IAAI,GAAG,EAA0B,CAAC;IAEpE,uDAAuD;IACvD,QAAQ,CAAC,OAA4B;QACnC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,sEAAsE;IACtE,UAAU,CAAC,QAAkB;QAC3B,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC;IAClC,CAAC;IAED,iDAAiD;IACjD,gBAAgB,CAAC,QAAsB,EAAE,QAAkB;QACzD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED,yCAAyC;IACzC,UAAU,CAAC,QAAkB;QAC3B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED;;;;;;;OAOG;IACH,iBAAiB,CAAC,QAAsB;QACtC,0BAA0B;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC1C,IAAI,OAAO;gBAAE,OAAO,OAAO,CAAC;QAC9B,CAAC;QAED,mBAAmB;QACnB,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACxD,IAAI,OAAO;gBAAE,OAAO,OAAO,CAAC;QAC9B,CAAC;QAED,mCAAmC;QACnC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/C,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7C,CAAC;IAED,sCAAsC;IACtC,cAAc;QACZ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,qDAAqD;IACrD,KAAK,CAAC,WAAW;QACf,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAC5D,CAAC;IACJ,CAAC;CACF"}

package/dist/src/mcp/resource-renderers.d.ts

@@ -0,0 +1,25 @@
+import type { TaskState } from '../task/task-state.js';
+/**
+ * Compact all-tasks view.
+ *
+ * Resource URI: `task:///all`
+ */
+export declare function renderScoreboard(tasks: TaskState[]): string;
+/**
+ * Full task detail view as markdown.
+ *
+ * Resource URI: `task:///{id}`
+ */
+export declare function renderTaskDetail(task: TaskState): string;
+/**
+ * Last 20 lines from task.output.
+ *
+ * Resource URI: `task:///{id}/log`
+ */
+export declare function renderSummaryLog(task: TaskState): string;
+/**
+ * All lines from task.output (no truncation).
+ *
+ * Resource URI: `task:///{id}/log.verbose`
+ */
+export declare function renderVerboseLog(task: TaskState): string;

package/dist/src/mcp/resource-renderers.js

@@ -0,0 +1,190 @@
+import { TaskStatus } from '../task/task-state.js';
+import { mapToDisplay } from '../task/wire-state-mapper.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const PROMPT_MAX_LEN = 50;
+const SUMMARY_LOG_LINES = 20;
+const DETAIL_OUTPUT_LINES = 10;
+// ---------------------------------------------------------------------------
+// Sorting helpers
+// ---------------------------------------------------------------------------
+/** Active statuses that should appear first on the scoreboard. */
+const ACTIVE_STATUSES = new Set([
+    TaskStatus.RUNNING,
+    TaskStatus.WAITING_ANSWER,
+    TaskStatus.RATE_LIMITED,
+]);
+/** Pending statuses that appear between active and terminal. */
+const PENDING_STATUSES = new Set([
+    TaskStatus.WAITING,
+    TaskStatus.PENDING,
+]);
+function sortPriority(status) {
+    if (ACTIVE_STATUSES.has(status))
+        return 0;
+    if (PENDING_STATUSES.has(status))
+        return 1;
+    return 2; // terminal
+}
+// ---------------------------------------------------------------------------
+// Formatting helpers
+// ---------------------------------------------------------------------------
+function truncatePrompt(prompt, maxLen = PROMPT_MAX_LEN) {
+    if (prompt.length <= maxLen)
+        return prompt;
+    return prompt.slice(0, maxLen - 3) + '...';
+}
+function formatElapsed(createdAt, updatedAt) {
+    const start = new Date(createdAt).getTime();
+    const end = new Date(updatedAt).getTime();
+    const diffMs = Math.max(0, end - start);
+    const totalSec = Math.floor(diffMs / 1000);
+    const min = Math.floor(totalSec / 60);
+    const sec = totalSec % 60;
+    if (min > 0) {
+        return `${min}m ${sec}s`;
+    }
+    return `${sec}s`;
+}
+/**
+ * Build a status-count summary string like "3 done, 1 busy, 1 wait".
+ * Uses the display badge labels (without brackets) as category names.
+ */
+function statusSummary(tasks) {
+    const counts = new Map();
+    for (const t of tasks) {
+        const badge = mapToDisplay(t.status);
+        // Strip brackets: "[busy]" → "busy"
+        const label = badge.slice(1, -1);
+        counts.set(label, (counts.get(label) ?? 0) + 1);
+    }
+    return Array.from(counts.entries())
+        .map(([label, count]) => `${count} ${label}`)
+        .join(', ');
+}
+// ---------------------------------------------------------------------------
+// renderScoreboard
+// ---------------------------------------------------------------------------
+/**
+ * Compact all-tasks view.
+ *
+ * Resource URI: `task:///all`
+ */
+export function renderScoreboard(tasks) {
+    const sorted = [...tasks].sort((a, b) => sortPriority(a.status) - sortPriority(b.status));
+    const summary = tasks.length > 0 ? ` (${statusSummary(tasks)})` : '';
+    const header = `tasks -- ${tasks.length} total${summary}`;
+    const lines = [header, ''];
+    for (const task of sorted) {
+        const badge = mapToDisplay(task.status);
+        const prompt = truncatePrompt(task.prompt);
+        const elapsed = formatElapsed(task.createdAt, task.updatedAt);
+        lines.push(`${badge} ${task.id} -- "${prompt}" (${elapsed})`);
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// renderTaskDetail
+// ---------------------------------------------------------------------------
+/**
+ * Full task detail view as markdown.
+ *
+ * Resource URI: `task:///{id}`
+ */
+export function renderTaskDetail(task) {
+    const badge = mapToDisplay(task.status);
+    const lines = [
+        `# Task: ${task.id} -- ${truncatePrompt(task.prompt)}`,
+        '',
+        '| Field | Value |',
+        '|---|---|',
+        `| **Status** | ${badge} \`${task.status}\` |`,
+        `| **Provider** | ${task.provider} |`,
+    ];
+    if (task.sessionId) {
+        lines.push(`| **Session ID** | \`${task.sessionId}\` |`);
+    }
+    if (task.model) {
+        lines.push(`| **Model** | \`${task.model}\` |`);
+    }
+    lines.push(`| **Task type** | ${task.taskType} |`);
+    lines.push(`| **CWD** | \`${task.cwd}\` |`);
+    lines.push(`| **Created** | ${task.createdAt} |`);
+    if (task.startedAt) {
+        lines.push(`| **Started** | ${task.startedAt} |`);
+    }
+    if (task.completedAt) {
+        lines.push(`| **Completed** | ${task.completedAt} |`);
+    }
+    lines.push(`| **Updated** | ${task.updatedAt} |`);
+    lines.push('');
+    // Pending questions
+    if (task.pendingQuestions.length > 0) {
+        lines.push('## Pending Question', '');
+        for (const q of task.pendingQuestions) {
+            lines.push(formatPendingQuestion(q));
+        }
+        lines.push('');
+    }
+    // Error
+    if (task.error) {
+        lines.push('## Error', '', `\`\`\`\n${task.error}\n\`\`\``, '');
+    }
+    // Last N output lines
+    if (task.output.length > 0) {
+        const tail = task.output.slice(-DETAIL_OUTPUT_LINES);
+        lines.push('## Recent Output', '');
+        for (const line of tail) {
+            lines.push(line);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+function formatPendingQuestion(q) {
+    switch (q.type) {
+        case 'user_input':
+            return q.questions.map((iq) => `- **${iq.text}**${iq.options ? ` (options: ${iq.options.join(', ')})` : ''}`).join('\n');
+        case 'command_approval':
+            return `- **Command approval**: \`${q.command}\``;
+        case 'file_approval':
+            return `- **File approval**: ${q.fileChanges.map((f) => f.path).join(', ')}`;
+        case 'elicitation':
+            return `- **Elicitation**: ${q.message}`;
+        case 'dynamic_tool':
+            return `- **Dynamic tool**: \`${q.toolName}\``;
+    }
+}
+// ---------------------------------------------------------------------------
+// renderSummaryLog
+// ---------------------------------------------------------------------------
+/**
+ * Last 20 lines from task.output.
+ *
+ * Resource URI: `task:///{id}/log`
+ */
+export function renderSummaryLog(task) {
+    if (task.output.length === 0) {
+        return `# Log: ${task.id}\n\nNo output yet.`;
+    }
+    const tail = task.output.slice(-SUMMARY_LOG_LINES);
+    const header = `# Log: ${task.id} (last ${tail.length} of ${task.output.length} lines)`;
+    return [header, '', ...tail].join('\n');
+}
+// ---------------------------------------------------------------------------
+// renderVerboseLog
+// ---------------------------------------------------------------------------
+/**
+ * All lines from task.output (no truncation).
+ *
+ * Resource URI: `task:///{id}/log.verbose`
+ */
+export function renderVerboseLog(task) {
+    if (task.output.length === 0) {
+        return `# Verbose Log: ${task.id}\n\nNo output yet.`;
+    }
+    const header = `# Verbose Log: ${task.id} (${task.output.length} lines)`;
+    return [header, '', ...task.output].join('\n');
+}
+//# sourceMappingURL=resource-renderers.js.map

package/dist/src/mcp/resource-renderers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-renderers.js","sourceRoot":"","sources":["../../../src/mcp/resource-renderers.ts"],"names":[],"mappings":"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"}

package/dist/src/mcp/sep1686-handlers.d.ts

@@ -0,0 +1,56 @@
+import type { TaskState, PendingQuestion } from '../task/task-state.js';
+import type { WireState } from '../task/wire-state-mapper.js';
+/**
+ * Response shape for `tasks/get` — a single task's status snapshot.
+ */
+export interface TasksGetResponse {
+    taskId: string;
+    status: WireState;
+    pollFrequency: number;
+    keepAlive?: number;
+    metadata?: {
+        pendingQuestion?: PendingQuestion;
+    };
+    error?: string;
+}
+/**
+ * List item shape for `tasks/list` — lightweight summary per task.
+ */
+export interface TasksListItem {
+    taskId: string;
+    status: WireState;
+    pollFrequency: number;
+    createdAt: string;
+    lastUpdatedAt: string;
+}
+/**
+ * Returns the recommended poll interval in milliseconds based on task status.
+ *
+ * - WAITING_ANSWER → 2 000 ms  (client should check frequently for input-required)
+ * - PENDING, RUNNING → 5 000 ms
+ * - All others (WAITING, RATE_LIMITED, terminal) → 30 000 ms
+ */
+export declare function computePollFrequency(task: TaskState): number;
+/**
+ * Builds a SEP-1686 `tasks/get` response from internal TaskState.
+ *
+ * - Maps internal status to wire state via `mapToWireState`
+ * - Computes poll frequency via `computePollFrequency`
+ * - Includes `keepAlive` from task if present
+ * - Includes first pending question in metadata when status is
+ *   WAITING_ANSWER and the queue is non-empty
+ * - Includes error string if present
+ */
+export declare function buildTasksGetResponse(task: TaskState): TasksGetResponse;
+/**
+ * Builds a SEP-1686 `tasks/list` response.
+ *
+ * - Filters by wire status if `statusFilter` is provided
+ * - Sorts by `createdAt` descending (newest first)
+ * - Paginates with page size 50; cursor is a string-encoded start index
+ * - Returns `nextCursor` if more pages exist
+ */
+export declare function buildTasksListResponse(tasks: TaskState[], cursor?: string, statusFilter?: WireState): {
+    tasks: TasksListItem[];
+    nextCursor?: string;
+};

package/dist/src/mcp/sep1686-handlers.js

@@ -0,0 +1,98 @@
+import { TaskStatus } from '../task/task-state.js';
+import { mapToWireState } from '../task/wire-state-mapper.js';
+// ---------------------------------------------------------------------------
+// Poll frequency computation
+// ---------------------------------------------------------------------------
+/**
+ * Returns the recommended poll interval in milliseconds based on task status.
+ *
+ * - WAITING_ANSWER → 2 000 ms  (client should check frequently for input-required)
+ * - PENDING, RUNNING → 5 000 ms
+ * - All others (WAITING, RATE_LIMITED, terminal) → 30 000 ms
+ */
+export function computePollFrequency(task) {
+    switch (task.status) {
+        case TaskStatus.WAITING_ANSWER:
+            return 2000;
+        case TaskStatus.PENDING:
+        case TaskStatus.RUNNING:
+            return 5000;
+        default:
+            return 30000;
+    }
+}
+// ---------------------------------------------------------------------------
+// tasks/get response builder
+// ---------------------------------------------------------------------------
+/**
+ * Builds a SEP-1686 `tasks/get` response from internal TaskState.
+ *
+ * - Maps internal status to wire state via `mapToWireState`
+ * - Computes poll frequency via `computePollFrequency`
+ * - Includes `keepAlive` from task if present
+ * - Includes first pending question in metadata when status is
+ *   WAITING_ANSWER and the queue is non-empty
+ * - Includes error string if present
+ */
+export function buildTasksGetResponse(task) {
+    const status = mapToWireState(task.status);
+    const pollFrequency = computePollFrequency(task);
+    const hasPendingQuestion = task.status === TaskStatus.WAITING_ANSWER &&
+        task.pendingQuestions.length > 0;
+    const response = {
+        taskId: task.id,
+        status,
+        pollFrequency,
+    };
+    if (task.keepAlive !== undefined) {
+        response.keepAlive = task.keepAlive;
+    }
+    if (hasPendingQuestion) {
+        const firstQuestion = task.pendingQuestions[0];
+        if (firstQuestion !== undefined) {
+            response.metadata = { pendingQuestion: firstQuestion };
+        }
+    }
+    if (task.error !== undefined) {
+        response.error = task.error;
+    }
+    return response;
+}
+// ---------------------------------------------------------------------------
+// tasks/list response builder
+// ---------------------------------------------------------------------------
+const PAGE_SIZE = 50;
+/**
+ * Builds a SEP-1686 `tasks/list` response.
+ *
+ * - Filters by wire status if `statusFilter` is provided
+ * - Sorts by `createdAt` descending (newest first)
+ * - Paginates with page size 50; cursor is a string-encoded start index
+ * - Returns `nextCursor` if more pages exist
+ */
+export function buildTasksListResponse(tasks, cursor, statusFilter) {
+    // 1. Filter by wire status if requested
+    const filtered = statusFilter
+        ? tasks.filter(t => mapToWireState(t.status) === statusFilter)
+        : [...tasks];
+    // 2. Sort by createdAt descending
+    filtered.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+    // 3. Paginate
+    const start = cursor ? parseInt(cursor, 10) : 0;
+    const page = filtered.slice(start, start + PAGE_SIZE);
+    const nextStart = start + PAGE_SIZE;
+    // 4. Map to list items
+    const items = page.map(t => ({
+        taskId: t.id,
+        status: mapToWireState(t.status),
+        pollFrequency: computePollFrequency(t),
+        createdAt: t.createdAt,
+        lastUpdatedAt: t.updatedAt,
+    }));
+    const result = { tasks: items };
+    if (nextStart < filtered.length) {
+        result.nextCursor = String(nextStart);
+    }
+    return result;
+}
+//# sourceMappingURL=sep1686-handlers.js.map

package/dist/src/mcp/sep1686-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sep1686-handlers.js","sourceRoot":"","sources":["../../../src/mcp/sep1686-handlers.ts"],"names":[],"mappings":"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"}

package/dist/src/mcp/tool-definitions.d.ts

@@ -148,6 +148,158 @@ declare const waitSchema: z.ZodObject<{
     timeout_ms?: number | undefined;
     poll_interval_ms?: number | undefined;
 }>;
+declare const spawnTaskSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    task_type: z.ZodDefault<z.ZodEnum<["coder", "planner", "tester", "researcher", "general"]>>;
+    provider: z.ZodOptional<z.ZodEnum<["codex", "copilot", "claude-cli"]>>;
+    model: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    timeout_ms: z.ZodOptional<z.ZodNumber>;
+    keep_alive: z.ZodOptional<z.ZodNumber>;
+    labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    depends_on: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    developer_instructions: z.ZodOptional<z.ZodString>;
+    context_files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        description?: string | undefined;
+    }, {
+        path: string;
+        description?: string | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    prompt: string;
+    task_type: "coder" | "planner" | "tester" | "researcher" | "general";
+    model?: string | undefined;
+    cwd?: string | undefined;
+    developer_instructions?: string | undefined;
+    timeout_ms?: number | undefined;
+    provider?: "codex" | "copilot" | "claude-cli" | undefined;
+    keep_alive?: number | undefined;
+    labels?: string[] | undefined;
+    depends_on?: string[] | undefined;
+    context_files?: {
+        path: string;
+        description?: string | undefined;
+    }[] | undefined;
+}, {
+    prompt: string;
+    model?: string | undefined;
+    cwd?: string | undefined;
+    developer_instructions?: string | undefined;
+    timeout_ms?: number | undefined;
+    task_type?: "coder" | "planner" | "tester" | "researcher" | "general" | undefined;
+    provider?: "codex" | "copilot" | "claude-cli" | undefined;
+    keep_alive?: number | undefined;
+    labels?: string[] | undefined;
+    depends_on?: string[] | undefined;
+    context_files?: {
+        path: string;
+        description?: string | undefined;
+    }[] | undefined;
+}>;
+declare const waitTaskSchema: z.ZodObject<{
+    task_id: z.ZodString;
+    timeout_ms: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    poll_interval_ms: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    task_id: string;
+    timeout_ms?: number | undefined;
+    poll_interval_ms?: number | undefined;
+}, {
+    task_id: string;
+    timeout_ms?: number | undefined;
+    poll_interval_ms?: number | undefined;
+}>;
+declare const respondTaskSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    task_id: z.ZodString;
+    type: z.ZodLiteral<"user_input">;
+    answers: z.ZodRecord<z.ZodString, z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "user_input";
+    answers: Record<string, string>;
+    task_id: string;
+}, {
+    type: "user_input";
+    answers: Record<string, string>;
+    task_id: string;
+}>, z.ZodObject<{
+    task_id: z.ZodString;
+    type: z.ZodLiteral<"command_approval">;
+    decision: z.ZodEnum<["accept", "reject"]>;
+}, "strip", z.ZodTypeAny, {
+    type: "command_approval";
+    decision: "accept" | "reject";
+    task_id: string;
+}, {
+    type: "command_approval";
+    decision: "accept" | "reject";
+    task_id: string;
+}>, z.ZodObject<{
+    task_id: z.ZodString;
+    type: z.ZodLiteral<"file_approval">;
+    decision: z.ZodEnum<["accept", "reject"]>;
+}, "strip", z.ZodTypeAny, {
+    type: "file_approval";
+    decision: "accept" | "reject";
+    task_id: string;
+}, {
+    type: "file_approval";
+    decision: "accept" | "reject";
+    task_id: string;
+}>, z.ZodObject<{
+    task_id: z.ZodString;
+    type: z.ZodLiteral<"elicitation">;
+    action: z.ZodEnum<["accept", "decline"]>;
+    content: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: "elicitation";
+    action: "accept" | "decline";
+    task_id: string;
+    content?: Record<string, unknown> | undefined;
+}, {
+    type: "elicitation";
+    action: "accept" | "decline";
+    task_id: string;
+    content?: Record<string, unknown> | undefined;
+}>, z.ZodObject<{
+    task_id: z.ZodString;
+    type: z.ZodLiteral<"dynamic_tool">;
+    result: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "dynamic_tool";
+    task_id: string;
+    result?: string | undefined;
+    error?: string | undefined;
+}, {
+    type: "dynamic_tool";
+    task_id: string;
+    result?: string | undefined;
+    error?: string | undefined;
+}>]>;
+declare const messageTaskSchema: z.ZodObject<{
+    task_id: z.ZodString;
+    message: z.ZodString;
+    model: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    task_id: string;
+    model?: string | undefined;
+}, {
+    message: string;
+    task_id: string;
+    model?: string | undefined;
+}>;
+declare const cancelTaskSchema: z.ZodObject<{
+    task_id: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
+}, "strip", z.ZodTypeAny, {
+    task_id: string | string[];
+}, {
+    task_id: string | string[];
+}>;
 export interface ToolDefinition {
     name: string;
     description: string;
@@ -174,4 +326,9 @@ export type TurnInterruptInput = z.infer<typeof turnInterruptSchema>;
 export type RequestListInput = z.infer<typeof requestListSchema>;
 export type RequestRespondInput = z.infer<typeof requestRespondSchema>;
 export type WaitInput = z.infer<typeof waitSchema>;
+export type SpawnTaskInput = z.infer<typeof spawnTaskSchema>;
+export type WaitTaskInput = z.infer<typeof waitTaskSchema>;
+export type RespondTaskInput = z.infer<typeof respondTaskSchema>;
+export type MessageTaskInput = z.infer<typeof messageTaskSchema>;
+export type CancelTaskInput = z.infer<typeof cancelTaskSchema>;
 export {};