mcp-codex-worker 0.1.11 → 0.1.13

package/dist/src/task/task-manager.d.ts

@@ -0,0 +1,99 @@
+import { TaskStatus } from './task-state.js';
+import type { TaskState, TaskTypeName, Provider, PendingQuestion } from './task-state.js';
+import type { TaskHandle } from './task-handle.js';
+export interface TaskManagerOptions {
+    /**
+     * Root directory for persistence files.
+     * `undefined` means persistence is disabled (in-memory only).
+     */
+    persistenceRoot: string | undefined;
+}
+export interface CreateTaskInput {
+    prompt: string;
+    cwd: string;
+    provider: Provider;
+    taskType: TaskTypeName;
+    model?: string;
+    timeoutMs?: number;
+    dependsOn?: string[];
+    labels?: string[];
+}
+export type StatusChangeListener = (task: TaskState, previousStatus: TaskStatus) => void;
+export type OutputListener = (taskId: string, line: string) => void;
+/**
+ * Central orchestrator for task lifecycle management.
+ *
+ * Wraps {@link TaskStore} with:
+ * - Human-readable ID generation (adjective-animal-number)
+ * - {@link TaskHandle} creation for provider adapters
+ * - Event bus (status changes, output lines)
+ * - Output ring buffer capping
+ *
+ * Spec reference: §3.1 (layer model), §3.2 (TaskHandle)
+ */
+export declare class TaskManager {
+    private readonly store;
+    private readonly handles;
+    private readonly abortControllers;
+    private readonly abortListeners;
+    private readonly statusListeners;
+    private readonly outputListeners;
+    readonly persistenceRoot: string | undefined;
+    constructor(options: TaskManagerOptions);
+    /**
+     * Create a new task with a human-readable ID, store it, and return
+     * the initial {@link TaskState}.
+     */
+    createTask(input: CreateTaskInput): TaskState;
+    getTask(id: string): TaskState | undefined;
+    getBySessionId(sessionId: string): TaskState | undefined;
+    getHandle(id: string): TaskHandle | undefined;
+    getAllTasks(): TaskState[];
+    /**
+     * Apply a partial update to a task.
+     *
+     * If the update includes a status change, the FSM is validated by the store.
+     * On successful status change the event bus is notified.
+     */
+    updateTask(id: string, updates: Partial<TaskState>): TaskState | undefined;
+    /**
+     * Append a line to the task's in-memory output ring buffer.
+     * Caps at {@link OUTPUT_RING_BUFFER_MAX} lines (oldest lines evicted).
+     */
+    appendOutput(id: string, line: string): void;
+    /**
+     * Record a verbose-only output line.
+     * Updates lastOutputAt and fires the output listener with a prefix,
+     * but does NOT push to the in-memory ring buffer.
+     */
+    appendOutputFileOnly(id: string, line: string): void;
+    registerAbort(id: string, controller: AbortController): void;
+    unregisterAbort(id: string): void;
+    getAbortController(id: string): AbortController | undefined;
+    /**
+     * Register a callback for when a task's abort controller fires.
+     * Returns an unsubscribe function.
+     */
+    onAborted(id: string, cb: () => void): () => void;
+    /** Fire abort listeners for a task. Called when AbortController signals. */
+    fireAbortListeners(id: string): void;
+    queuePendingQuestion(id: string, q: PendingQuestion): void;
+    dequeuePendingQuestion(id: string): PendingQuestion | undefined;
+    getPendingQuestions(id: string): readonly PendingQuestion[];
+    /**
+     * Subscribe to status change events.
+     * Returns an unsubscribe function.
+     */
+    onStatusChange(cb: StatusChangeListener): () => void;
+    /**
+     * Subscribe to output line events.
+     * Returns an unsubscribe function.
+     */
+    onOutput(cb: OutputListener): () => void;
+    /**
+     * Emit a status change event to all listeners.
+     * Public so that the TaskHandle implementation can call it directly.
+     */
+    emitStatusChange(task: TaskState, previousStatus: TaskStatus): void;
+    private generateId;
+}

package/dist/src/task/task-manager.js

@@ -0,0 +1,246 @@
+import { uniqueNamesGenerator, adjectives, animals, } from 'unique-names-generator';
+import { TaskStatus } from './task-state.js';
+import { TaskStore } from './task-store.js';
+import { createTaskHandle } from './task-handle-impl.js';
+// ---------------------------------------------------------------------------
+// Configuration
+// ---------------------------------------------------------------------------
+/** Maximum lines retained in the in-memory output ring buffer. */
+const OUTPUT_RING_BUFFER_MAX = 500;
+// ---------------------------------------------------------------------------
+// TaskManager
+// ---------------------------------------------------------------------------
+/**
+ * Central orchestrator for task lifecycle management.
+ *
+ * Wraps {@link TaskStore} with:
+ * - Human-readable ID generation (adjective-animal-number)
+ * - {@link TaskHandle} creation for provider adapters
+ * - Event bus (status changes, output lines)
+ * - Output ring buffer capping
+ *
+ * Spec reference: §3.1 (layer model), §3.2 (TaskHandle)
+ */
+export class TaskManager {
+    store = new TaskStore();
+    handles = new Map();
+    abortControllers = new Map();
+    abortListeners = new Map();
+    statusListeners = new Set();
+    outputListeners = new Set();
+    persistenceRoot;
+    constructor(options) {
+        this.persistenceRoot = options.persistenceRoot;
+    }
+    // -------------------------------------------------------------------------
+    // Task creation
+    // -------------------------------------------------------------------------
+    /**
+     * Create a new task with a human-readable ID, store it, and return
+     * the initial {@link TaskState}.
+     */
+    createTask(input) {
+        const id = this.generateId();
+        const now = new Date().toISOString();
+        const task = {
+            id,
+            status: TaskStatus.PENDING,
+            provider: input.provider,
+            taskType: input.taskType,
+            prompt: input.prompt,
+            cwd: input.cwd,
+            createdAt: now,
+            updatedAt: now,
+            labels: input.labels ?? [],
+            output: [],
+            pendingQuestions: [],
+        };
+        // Only set optional properties when defined (exactOptionalPropertyTypes)
+        if (input.model !== undefined)
+            task.model = input.model;
+        if (input.timeoutMs !== undefined)
+            task.timeoutMs = input.timeoutMs;
+        if (input.dependsOn !== undefined)
+            task.dependsOn = input.dependsOn;
+        this.store.create(task);
+        // Pre-create the handle so getHandle never returns undefined for a known task
+        const handle = createTaskHandle(this, id);
+        this.handles.set(id, handle);
+        return task;
+    }
+    // -------------------------------------------------------------------------
+    // Lookups
+    // -------------------------------------------------------------------------
+    getTask(id) {
+        return this.store.get(id);
+    }
+    getBySessionId(sessionId) {
+        return this.store.getBySessionId(sessionId);
+    }
+    getHandle(id) {
+        return this.handles.get(id);
+    }
+    getAllTasks() {
+        return this.store.getAll();
+    }
+    // -------------------------------------------------------------------------
+    // Mutations (called by TaskHandle implementation)
+    // -------------------------------------------------------------------------
+    /**
+     * Apply a partial update to a task.
+     *
+     * If the update includes a status change, the FSM is validated by the store.
+     * On successful status change the event bus is notified.
+     */
+    updateTask(id, updates) {
+        const prev = this.store.get(id);
+        if (!prev)
+            return undefined;
+        const previousStatus = prev.status;
+        const result = this.store.update(id, updates);
+        if (result && result.status !== previousStatus) {
+            this.emitStatusChange(result, previousStatus);
+        }
+        return result;
+    }
+    /**
+     * Append a line to the task's in-memory output ring buffer.
+     * Caps at {@link OUTPUT_RING_BUFFER_MAX} lines (oldest lines evicted).
+     */
+    appendOutput(id, line) {
+        const task = this.store.get(id);
+        if (!task)
+            return;
+        task.output.push(line);
+        if (task.output.length > OUTPUT_RING_BUFFER_MAX) {
+            task.output.splice(0, task.output.length - OUTPUT_RING_BUFFER_MAX);
+        }
+        task.lastOutputAt = new Date().toISOString();
+        task.updatedAt = task.lastOutputAt;
+        for (const listener of this.outputListeners) {
+            listener(id, line);
+        }
+    }
+    /**
+     * Record a verbose-only output line.
+     * Updates lastOutputAt and fires the output listener with a prefix,
+     * but does NOT push to the in-memory ring buffer.
+     */
+    appendOutputFileOnly(id, line) {
+        const task = this.store.get(id);
+        if (!task)
+            return;
+        task.lastOutputAt = new Date().toISOString();
+        task.updatedAt = task.lastOutputAt;
+        for (const listener of this.outputListeners) {
+            listener(id, `[verbose-only] ${line}`);
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Abort management
+    // -------------------------------------------------------------------------
+    registerAbort(id, controller) {
+        this.abortControllers.set(id, controller);
+    }
+    unregisterAbort(id) {
+        this.abortControllers.delete(id);
+    }
+    getAbortController(id) {
+        return this.abortControllers.get(id);
+    }
+    /**
+     * Register a callback for when a task's abort controller fires.
+     * Returns an unsubscribe function.
+     */
+    onAborted(id, cb) {
+        let listeners = this.abortListeners.get(id);
+        if (!listeners) {
+            listeners = new Set();
+            this.abortListeners.set(id, listeners);
+        }
+        listeners.add(cb);
+        return () => {
+            listeners.delete(cb);
+        };
+    }
+    /** Fire abort listeners for a task. Called when AbortController signals. */
+    fireAbortListeners(id) {
+        const listeners = this.abortListeners.get(id);
+        if (!listeners)
+            return;
+        for (const cb of listeners) {
+            cb();
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Pending question queue
+    // -------------------------------------------------------------------------
+    queuePendingQuestion(id, q) {
+        const task = this.store.get(id);
+        if (!task)
+            return;
+        task.pendingQuestions.push(q);
+        task.updatedAt = new Date().toISOString();
+    }
+    dequeuePendingQuestion(id) {
+        const task = this.store.get(id);
+        if (!task)
+            return undefined;
+        const q = task.pendingQuestions.shift();
+        if (q !== undefined) {
+            task.updatedAt = new Date().toISOString();
+        }
+        return q;
+    }
+    getPendingQuestions(id) {
+        const task = this.store.get(id);
+        if (!task)
+            return [];
+        return task.pendingQuestions;
+    }
+    // -------------------------------------------------------------------------
+    // Event bus
+    // -------------------------------------------------------------------------
+    /**
+     * Subscribe to status change events.
+     * Returns an unsubscribe function.
+     */
+    onStatusChange(cb) {
+        this.statusListeners.add(cb);
+        return () => {
+            this.statusListeners.delete(cb);
+        };
+    }
+    /**
+     * Subscribe to output line events.
+     * Returns an unsubscribe function.
+     */
+    onOutput(cb) {
+        this.outputListeners.add(cb);
+        return () => {
+            this.outputListeners.delete(cb);
+        };
+    }
+    /**
+     * Emit a status change event to all listeners.
+     * Public so that the TaskHandle implementation can call it directly.
+     */
+    emitStatusChange(task, previousStatus) {
+        for (const listener of this.statusListeners) {
+            listener(task, previousStatus);
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Internal helpers
+    // -------------------------------------------------------------------------
+    generateId() {
+        const name = uniqueNamesGenerator({
+            dictionaries: [adjectives, animals],
+            separator: '-',
+            length: 2,
+        });
+        const num = Math.floor(Math.random() * 900) + 100; // 100-999
+        return `${name}-${num}`;
+    }
+}
+//# sourceMappingURL=task-manager.js.map

package/dist/src/task/task-manager.js.map

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

package/dist/src/task/task-persistence.d.ts

@@ -0,0 +1,18 @@
+import type { TaskState } from './task-state.js';
+export interface PersistedProfileState {
+    id: string;
+    configDir: string;
+    cooldownUntil?: number;
+    failureCount: number;
+    lastFailureReason?: string;
+}
+export interface PersistedState {
+    version: 1;
+    tasks: TaskState[];
+    profiles: PersistedProfileState[];
+    lastSavedAt: string;
+}
+export declare function persistenceDir(root: string, cwd: string): string;
+export declare function saveState(dir: string, state: PersistedState): Promise<void>;
+export declare function loadState(dir: string): Promise<PersistedState | null>;
+export declare function applyRecovery(task: TaskState, hasCrashRecovery: boolean): TaskState;

package/dist/src/task/task-persistence.js

@@ -0,0 +1,61 @@
+import { createHash } from 'node:crypto';
+import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { TaskStatus, isTerminalStatus } from './task-state.js';
+// ---------------------------------------------------------------------------
+// persistenceDir — deterministic per-workspace directory
+// ---------------------------------------------------------------------------
+export function persistenceDir(root, cwd) {
+    const hash = createHash('md5').update(cwd).digest('hex');
+    return join(root, hash);
+}
+// ---------------------------------------------------------------------------
+// saveState — atomic write: write tmp → rename
+// ---------------------------------------------------------------------------
+export async function saveState(dir, state) {
+    await mkdir(dir, { recursive: true });
+    const target = join(dir, 'state.json');
+    const tmp = join(dir, `state.json.tmp.${process.pid}`);
+    await writeFile(tmp, JSON.stringify(state, null, 2), 'utf-8');
+    await rename(tmp, target);
+}
+// ---------------------------------------------------------------------------
+// loadState — read + parse, null on missing or corrupt
+// ---------------------------------------------------------------------------
+export async function loadState(dir) {
+    try {
+        const raw = await readFile(join(dir, 'state.json'), 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// applyRecovery — per-task recovery on server restart
+// Spec reference: §9.2 steps 1–2
+// ---------------------------------------------------------------------------
+export function applyRecovery(task, hasCrashRecovery) {
+    // 1. Terminal states restore as-is
+    if (isTerminalStatus(task.status)) {
+        return task;
+    }
+    // 2. Adapters without crash recovery → UNKNOWN
+    if (!hasCrashRecovery) {
+        const now = new Date().toISOString();
+        return {
+            ...task,
+            status: TaskStatus.UNKNOWN,
+            error: `Server restarted; ${task.provider} sessions don't survive restarts`,
+            completedAt: now,
+            output: [
+                ...task.output,
+                `[recovery] Task was ${task.status} when server restarted; marked UNKNOWN`,
+            ],
+            recovered: true,
+        };
+    }
+    // 3. Has crash recovery (e.g. Codex) — return as-is; adapter handles externally
+    return task;
+}
+//# sourceMappingURL=task-persistence.js.map

package/dist/src/task/task-persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-persistence.js","sourceRoot":"","sources":["../../../src/task/task-persistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AA2B/D,8EAA8E;AAC9E,yDAAyD;AACzD,8EAA8E;AAE9E,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,GAAW;IACtD,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACzD,OAAO,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,8EAA8E;AAC9E,+CAA+C;AAC/C,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW,EAAE,KAAqB;IAChE,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,kBAAkB,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACvD,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC9D,MAAM,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,8EAA8E;AAC9E,uDAAuD;AACvD,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW;IACzC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,sDAAsD;AACtD,iCAAiC;AACjC,8EAA8E;AAE9E,MAAM,UAAU,aAAa,CAAC,IAAe,EAAE,gBAAyB;IACtE,mCAAmC;IACnC,IAAI,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+CAA+C;IAC/C,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,OAAO;YACL,GAAG,IAAI;YACP,MAAM,EAAE,UAAU,CAAC,OAAO;YAC1B,KAAK,EAAE,qBAAqB,IAAI,CAAC,QAAQ,kCAAkC;YAC3E,WAAW,EAAE,GAAG;YAChB,MAAM,EAAE;gBACN,GAAG,IAAI,CAAC,MAAM;gBACd,uBAAuB,IAAI,CAAC,MAAM,wCAAwC;aAC3E;YACD,SAAS,EAAE,IAAI;SAChB,CAAC;IACJ,CAAC;IAED,gFAAgF;IAChF,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/task/task-state.d.ts

@@ -0,0 +1,79 @@
+export declare enum TaskStatus {
+    WAITING = "waiting",
+    PENDING = "pending",
+    RUNNING = "running",
+    RATE_LIMITED = "rate_limited",
+    WAITING_ANSWER = "waiting_answer",
+    COMPLETED = "completed",
+    FAILED = "failed",
+    TIMED_OUT = "timed_out",
+    CANCELLED = "cancelled",
+    UNKNOWN = "unknown"
+}
+export declare const TERMINAL_STATUSES: ReadonlySet<TaskStatus>;
+export declare function isTerminalStatus(status: TaskStatus): boolean;
+export type TaskTypeName = 'coder' | 'planner' | 'tester' | 'researcher' | 'general';
+export type Provider = 'codex' | 'copilot' | 'claude-cli';
+export type PendingQuestion = {
+    type: 'user_input';
+    requestId: string;
+    questions: Array<{
+        id: string;
+        text: string;
+        options?: string[];
+        allowFreeform?: boolean;
+    }>;
+} | {
+    type: 'command_approval';
+    requestId: string;
+    command: string;
+    sandboxPolicy?: string;
+} | {
+    type: 'file_approval';
+    requestId: string;
+    fileChanges: Array<{
+        path: string;
+        patch: string;
+    }>;
+} | {
+    type: 'elicitation';
+    requestId: string;
+    serverName?: string;
+    message: string;
+    schema?: unknown;
+} | {
+    type: 'dynamic_tool';
+    requestId: string;
+    toolName: string;
+    arguments: string;
+};
+export type PendingQuestionType = PendingQuestion['type'];
+export interface TaskState {
+    id: string;
+    status: TaskStatus;
+    provider: Provider;
+    taskType: TaskTypeName;
+    prompt: string;
+    cwd: string;
+    model?: string;
+    sessionId?: string;
+    operationId?: string;
+    createdAt: string;
+    updatedAt: string;
+    startedAt?: string;
+    completedAt?: string;
+    lastOutputAt?: string;
+    timeoutMs?: number;
+    timeoutAt?: string;
+    keepAlive?: number;
+    output: string[];
+    outputFilePath?: string;
+    dependsOn?: string[];
+    labels: string[];
+    pendingQuestions: PendingQuestion[];
+    error?: string;
+    exitCode?: number;
+    result?: unknown;
+    recovered?: boolean;
+    degraded?: boolean;
+}

package/dist/src/task/task-state.js

@@ -0,0 +1,24 @@
+export var TaskStatus;
+(function (TaskStatus) {
+    TaskStatus["WAITING"] = "waiting";
+    TaskStatus["PENDING"] = "pending";
+    TaskStatus["RUNNING"] = "running";
+    TaskStatus["RATE_LIMITED"] = "rate_limited";
+    TaskStatus["WAITING_ANSWER"] = "waiting_answer";
+    TaskStatus["COMPLETED"] = "completed";
+    TaskStatus["FAILED"] = "failed";
+    TaskStatus["TIMED_OUT"] = "timed_out";
+    TaskStatus["CANCELLED"] = "cancelled";
+    TaskStatus["UNKNOWN"] = "unknown";
+})(TaskStatus || (TaskStatus = {}));
+export const TERMINAL_STATUSES = new Set([
+    TaskStatus.COMPLETED,
+    TaskStatus.FAILED,
+    TaskStatus.CANCELLED,
+    TaskStatus.TIMED_OUT,
+    TaskStatus.UNKNOWN,
+]);
+export function isTerminalStatus(status) {
+    return TERMINAL_STATUSES.has(status);
+}
+//# sourceMappingURL=task-state.js.map

package/dist/src/task/task-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-state.js","sourceRoot":"","sources":["../../../src/task/task-state.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,UAWX;AAXD,WAAY,UAAU;IACpB,iCAAmB,CAAA;IACnB,iCAAmB,CAAA;IACnB,iCAAmB,CAAA;IACnB,2CAA6B,CAAA;IAC7B,+CAAiC,CAAA;IACjC,qCAAuB,CAAA;IACvB,+BAAiB,CAAA;IACjB,qCAAuB,CAAA;IACvB,qCAAuB,CAAA;IACvB,iCAAmB,CAAA;AACrB,CAAC,EAXW,UAAU,KAAV,UAAU,QAWrB;AAED,MAAM,CAAC,MAAM,iBAAiB,GAA4B,IAAI,GAAG,CAAC;IAChE,UAAU,CAAC,SAAS;IACpB,UAAU,CAAC,MAAM;IACjB,UAAU,CAAC,SAAS;IACpB,UAAU,CAAC,SAAS;IACpB,UAAU,CAAC,OAAO;CACnB,CAAC,CAAC;AAEH,MAAM,UAAU,gBAAgB,CAAC,MAAkB;IACjD,OAAO,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC"}

package/dist/src/task/task-store.d.ts

@@ -0,0 +1,46 @@
+import type { TaskState, TaskStatus } from './task-state.js';
+/**
+ * In-memory task store with FSM-validated state transitions.
+ *
+ * This is the single source of truth for task state. It enforces the FSM at
+ * the data layer — illegal transitions are rejected before any mutation occurs.
+ *
+ * Terminal tasks can be evicted by age to prevent unbounded memory growth.
+ */
+export declare class TaskStore {
+    private readonly tasks;
+    /** Store a new task. Overwrites if the ID already exists. */
+    create(task: TaskState): void;
+    /** Retrieve a task by its unique ID. */
+    get(id: string): TaskState | undefined;
+    /** Linear scan for a task matching the given session ID. */
+    getBySessionId(sessionId: string): TaskState | undefined;
+    /** Return all tasks as an array. */
+    getAll(): TaskState[];
+    /**
+     * Transition a task to a new status.
+     *
+     * Returns `true` if the transition was valid and applied, `false` if the
+     * task was not found or the transition is illegal per the FSM.
+     */
+    updateStatus(id: string, next: TaskStatus): boolean;
+    /**
+     * Apply a partial update to a task. If the update includes a `status`
+     * change, the FSM is validated first — an illegal transition causes the
+     * entire update to be rejected (returns `undefined`).
+     */
+    update(id: string, updates: Partial<TaskState>): TaskState | undefined;
+    /** Remove a task by ID. Returns `true` if it existed. */
+    delete(id: string): boolean;
+    /**
+     * Remove terminal tasks whose `updatedAt` timestamp is older than
+     * `maxAgeMs` milliseconds from now.
+     *
+     * Returns the number of tasks evicted.
+     */
+    evict(maxAgeMs: number): number;
+    /** Remove all tasks. */
+    clear(): void;
+    /** Return the number of stored tasks. */
+    size(): number;
+}