mcp-codex-subagent 2.0.8 → 2.0.10

package/dist/services/template-init.js

@@ -0,0 +1,41 @@
+/**
+ * Template initialization — copies bundled templates to ~/.mcp-codex-subagent/templates/
+ * on first run. Skips if destination already exists (preserves user customizations).
+ */
+import { existsSync, cpSync, mkdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { CONFIG_HOME } from '../types.js';
+const TEMPLATES_DEST = join(CONFIG_HOME, 'templates');
+/**
+ * Resolve the path to bundled templates.
+ * Works for both dist/ (compiled) and src/ (tsx dev mode).
+ */
+function getBundledTemplatesDir() {
+    const thisFile = fileURLToPath(import.meta.url);
+    const thisDir = dirname(thisFile);
+    // In dist/: thisDir = dist/services/ → templates at dist/templates/
+    // In src/:  thisDir = src/services/  → templates at src/templates/
+    const parentDir = dirname(thisDir);
+    return join(parentDir, 'templates');
+}
+/**
+ * Initialize templates directory at ~/.mcp-codex-subagent/templates/.
+ * Copies bundled templates on first run only.
+ */
+export async function initTemplates() {
+    if (existsSync(TEMPLATES_DEST)) {
+        return; // Already initialized — preserve user customizations
+    }
+    const bundledDir = getBundledTemplatesDir();
+    if (!existsSync(bundledDir)) {
+        console.error(`[template-init] Warning: bundled templates not found at ${bundledDir}`);
+        return;
+    }
+    // Ensure parent directory exists
+    mkdirSync(CONFIG_HOME, { recursive: true });
+    // Recursive copy
+    cpSync(bundledDir, TEMPLATES_DEST, { recursive: true });
+    console.error(`[template-init] Templates initialized at ${TEMPLATES_DEST}`);
+}
+//# sourceMappingURL=template-init.js.map

package/dist/services/template-init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-init.js","sourceRoot":"","sources":["../../src/services/template-init.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AAEtD;;;GAGG;AACH,SAAS,sBAAsB;IAC7B,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAElC,oEAAoE;IACpE,mEAAmE;IACnE,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,OAAO,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,IAAI,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,qDAAqD;IAC/D,CAAC;IAED,MAAM,UAAU,GAAG,sBAAsB,EAAE,CAAC;IAC5C,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,KAAK,CACX,2DAA2D,UAAU,EAAE,CACxE,CAAC;QACF,OAAO;IACT,CAAC;IAED,iCAAiC;IACjC,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,iBAAiB;IACjB,MAAM,CAAC,UAAU,EAAE,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAExD,OAAO,CAAC,KAAK,CAAC,4CAA4C,cAAc,EAAE,CAAC,CAAC;AAC9E,CAAC"}

package/dist/session/file-storage.d.ts

@@ -0,0 +1,27 @@
+/**
+ * JSONL-based persistent session storage.
+ *
+ * Layout: ~/.mcp-codex-subagent/sessions/{sanitized-cwd}/{session-id}.jsonl
+ *
+ * JSONL format:
+ *   Line 1: {"type":"meta","id":"...","createdAt":"...","codexConversationId":"..."}
+ *   Line N: {"type":"turn","prompt":"...","response":"...","timestamp":"..."}
+ */
+import type { SessionStorage, SessionData, ConversationTurn } from './storage.js';
+export declare class FileSessionStorage implements SessionStorage {
+    private readonly maxSessionIdLength;
+    private readonly sessionIdPattern;
+    createSession(): string;
+    ensureSession(sessionId: string): void;
+    getSession(sessionId: string): SessionData | undefined;
+    updateSession(sessionId: string, data: Partial<SessionData>): void;
+    deleteSession(sessionId: string): boolean;
+    listSessions(): SessionData[];
+    addTurn(sessionId: string, turn: ConversationTurn): void;
+    resetSession(sessionId: string): void;
+    setCodexConversationId(sessionId: string, conversationId: string): void;
+    getCodexConversationId(sessionId: string): string | undefined;
+    private cleanupExpired;
+    private enforceMaxSessions;
+}
+//# sourceMappingURL=file-storage.d.ts.map

package/dist/session/file-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-storage.d.ts","sourceRoot":"","sources":["../../src/session/file-storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiBH,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,gBAAgB,EACjB,MAAM,cAAc,CAAC;AA6GtB,qBAAa,kBAAmB,YAAW,cAAc;IACvD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAO;IAC1C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAsB;IAEvD,aAAa,IAAI,MAAM;IAgBvB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IA0BtC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAgBtD,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAalE,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAOzC,YAAY,IAAI,WAAW,EAAE;IAqC7B,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAcxD,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAerC,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI;IASvE,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAM7D,OAAO,CAAC,cAAc;IAuCtB,OAAO,CAAC,kBAAkB;CAU3B"}

package/dist/session/file-storage.js

@@ -0,0 +1,281 @@
+/**
+ * JSONL-based persistent session storage.
+ *
+ * Layout: ~/.mcp-codex-subagent/sessions/{sanitized-cwd}/{session-id}.jsonl
+ *
+ * JSONL format:
+ *   Line 1: {"type":"meta","id":"...","createdAt":"...","codexConversationId":"..."}
+ *   Line N: {"type":"turn","prompt":"...","response":"...","timestamp":"..."}
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync, appendFileSync, readdirSync, unlinkSync, statSync, rmSync, } from 'fs';
+import { join } from 'path';
+import { CONFIG_HOME } from '../types.js';
+import { TOOLS } from '../types.js';
+import { ValidationError } from '../errors.js';
+const SESSIONS_ROOT = join(CONFIG_HOME, 'sessions');
+const SESSION_TTL_MS = 7 * 24 * 60 * 60 * 1000; // 7 days
+const MAX_SESSIONS = 200;
+// --- Path helpers ---
+function sanitizeCwd(cwd) {
+    // /Users/foo/project → Users_foo_project
+    return cwd
+        .replace(/^\//, '')
+        .replace(/[/\\:]/g, '_')
+        .replace(/_{2,}/g, '_');
+}
+function getSessionDir(cwd) {
+    const sanitized = sanitizeCwd(cwd || process.cwd());
+    return join(SESSIONS_ROOT, sanitized);
+}
+function getSessionFilePath(sessionId, cwd) {
+    return join(getSessionDir(cwd), `${sessionId}.jsonl`);
+}
+// --- JSONL parsing ---
+function parseSessionFile(filePath) {
+    if (!existsSync(filePath))
+        return null;
+    try {
+        const content = readFileSync(filePath, 'utf-8');
+        const lines = content.trim().split('\n').filter(Boolean);
+        if (lines.length === 0)
+            return null;
+        const meta = JSON.parse(lines[0]);
+        if (meta.type !== 'meta')
+            return null;
+        const turns = [];
+        for (let i = 1; i < lines.length; i++) {
+            try {
+                const line = JSON.parse(lines[i]);
+                if (line.type === 'turn') {
+                    turns.push({
+                        prompt: line.prompt,
+                        response: line.response,
+                        timestamp: new Date(line.timestamp),
+                    });
+                }
+            }
+            catch {
+                // Skip malformed lines
+            }
+        }
+        return { meta, turns };
+    }
+    catch {
+        return null;
+    }
+}
+function writeMetaLine(filePath, meta) {
+    const dir = join(filePath, '..');
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(filePath, JSON.stringify(meta) + '\n', 'utf-8');
+}
+function appendTurnLine(filePath, turn) {
+    appendFileSync(filePath, JSON.stringify(turn) + '\n', 'utf-8');
+}
+/**
+ * Rewrite the meta line in a session file (e.g. when codexConversationId changes).
+ */
+function rewriteMeta(filePath, meta) {
+    if (!existsSync(filePath)) {
+        writeMetaLine(filePath, meta);
+        return;
+    }
+    const content = readFileSync(filePath, 'utf-8');
+    const lines = content.split('\n');
+    // Replace first line (meta) and keep rest
+    lines[0] = JSON.stringify(meta);
+    writeFileSync(filePath, lines.join('\n'), 'utf-8');
+}
+// --- FileSessionStorage ---
+export class FileSessionStorage {
+    maxSessionIdLength = 256;
+    sessionIdPattern = /^[a-zA-Z0-9_-]+$/;
+    createSession() {
+        const sessionId = crypto.randomUUID();
+        const filePath = getSessionFilePath(sessionId);
+        const now = new Date().toISOString();
+        const meta = {
+            type: 'meta',
+            id: sessionId,
+            createdAt: now,
+        };
+        writeMetaLine(filePath, meta);
+        this.enforceMaxSessions();
+        return sessionId;
+    }
+    ensureSession(sessionId) {
+        if (!sessionId ||
+            sessionId.length > this.maxSessionIdLength ||
+            !this.sessionIdPattern.test(sessionId)) {
+            throw new ValidationError(TOOLS.SPAWN_SUBAGENT, 'Session ID must be 1-256 characters and contain only letters, numbers, hyphens, and underscores');
+        }
+        const filePath = getSessionFilePath(sessionId);
+        if (existsSync(filePath))
+            return;
+        const now = new Date().toISOString();
+        const meta = {
+            type: 'meta',
+            id: sessionId,
+            createdAt: now,
+        };
+        writeMetaLine(filePath, meta);
+        this.enforceMaxSessions();
+    }
+    getSession(sessionId) {
+        const filePath = getSessionFilePath(sessionId);
+        const parsed = parseSessionFile(filePath);
+        if (!parsed)
+            return undefined;
+        const stat = statSync(filePath);
+        return {
+            id: parsed.meta.id,
+            createdAt: new Date(parsed.meta.createdAt),
+            lastAccessedAt: stat.mtime,
+            turns: parsed.turns,
+            codexConversationId: parsed.meta.codexConversationId,
+        };
+    }
+    updateSession(sessionId, data) {
+        const filePath = getSessionFilePath(sessionId);
+        if (!existsSync(filePath))
+            return;
+        if (data.codexConversationId !== undefined) {
+            const parsed = parseSessionFile(filePath);
+            if (parsed) {
+                parsed.meta.codexConversationId = data.codexConversationId;
+                rewriteMeta(filePath, parsed.meta);
+            }
+        }
+    }
+    deleteSession(sessionId) {
+        const filePath = getSessionFilePath(sessionId);
+        if (!existsSync(filePath))
+            return false;
+        unlinkSync(filePath);
+        return true;
+    }
+    listSessions() {
+        this.cleanupExpired();
+        const sessions = [];
+        if (!existsSync(SESSIONS_ROOT))
+            return sessions;
+        for (const cwdDir of readdirSync(SESSIONS_ROOT)) {
+            const cwdPath = join(SESSIONS_ROOT, cwdDir);
+            try {
+                const stat = statSync(cwdPath);
+                if (!stat.isDirectory())
+                    continue;
+            }
+            catch {
+                continue;
+            }
+            for (const file of readdirSync(cwdPath)) {
+                if (!file.endsWith('.jsonl'))
+                    continue;
+                const filePath = join(cwdPath, file);
+                const parsed = parseSessionFile(filePath);
+                if (!parsed)
+                    continue;
+                const fstat = statSync(filePath);
+                sessions.push({
+                    id: parsed.meta.id,
+                    createdAt: new Date(parsed.meta.createdAt),
+                    lastAccessedAt: fstat.mtime,
+                    turns: parsed.turns,
+                    codexConversationId: parsed.meta.codexConversationId,
+                });
+            }
+        }
+        return sessions.sort((a, b) => b.lastAccessedAt.getTime() - a.lastAccessedAt.getTime());
+    }
+    addTurn(sessionId, turn) {
+        const filePath = getSessionFilePath(sessionId);
+        if (!existsSync(filePath))
+            return;
+        const turnLine = {
+            type: 'turn',
+            prompt: turn.prompt,
+            response: turn.response,
+            timestamp: turn.timestamp.toISOString(),
+        };
+        appendTurnLine(filePath, turnLine);
+    }
+    resetSession(sessionId) {
+        const filePath = getSessionFilePath(sessionId);
+        const parsed = parseSessionFile(filePath);
+        if (!parsed)
+            return;
+        // Rewrite file with just the meta line (clear conversation ID too)
+        const meta = {
+            type: 'meta',
+            id: parsed.meta.id,
+            createdAt: parsed.meta.createdAt,
+        };
+        writeMetaLine(filePath, meta);
+    }
+    setCodexConversationId(sessionId, conversationId) {
+        const filePath = getSessionFilePath(sessionId);
+        const parsed = parseSessionFile(filePath);
+        if (!parsed)
+            return;
+        parsed.meta.codexConversationId = conversationId;
+        rewriteMeta(filePath, parsed.meta);
+    }
+    getCodexConversationId(sessionId) {
+        const filePath = getSessionFilePath(sessionId);
+        const parsed = parseSessionFile(filePath);
+        return parsed?.meta.codexConversationId;
+    }
+    cleanupExpired() {
+        if (!existsSync(SESSIONS_ROOT))
+            return;
+        const now = Date.now();
+        for (const cwdDir of readdirSync(SESSIONS_ROOT)) {
+            const cwdPath = join(SESSIONS_ROOT, cwdDir);
+            try {
+                const stat = statSync(cwdPath);
+                if (!stat.isDirectory())
+                    continue;
+            }
+            catch {
+                continue;
+            }
+            const files = readdirSync(cwdPath);
+            for (const file of files) {
+                if (!file.endsWith('.jsonl'))
+                    continue;
+                const filePath = join(cwdPath, file);
+                try {
+                    const fstat = statSync(filePath);
+                    if (now - fstat.mtimeMs > SESSION_TTL_MS) {
+                        unlinkSync(filePath);
+                    }
+                }
+                catch {
+                    // Ignore stat/unlink errors
+                }
+            }
+            // Remove empty directories
+            try {
+                const remaining = readdirSync(cwdPath);
+                if (remaining.length === 0) {
+                    rmSync(cwdPath, { recursive: true, force: true });
+                }
+            }
+            catch {
+                // Ignore
+            }
+        }
+    }
+    enforceMaxSessions() {
+        const sessions = this.listSessions();
+        if (sessions.length <= MAX_SESSIONS)
+            return;
+        // Delete oldest sessions beyond limit
+        const toDelete = sessions.slice(MAX_SESSIONS);
+        for (const session of toDelete) {
+            this.deleteSession(session.id);
+        }
+    }
+}
+//# sourceMappingURL=file-storage.js.map

package/dist/session/file-storage.js.map

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

package/dist/session/storage.js

@@ -25,7 +25,7 @@ export class InMemorySessionStorage {
         if (!sessionId ||
             sessionId.length > this.maxSessionIdLength ||
             !this.sessionIdPattern.test(sessionId)) {
-            throw new ValidationError(TOOLS.CODEX, 'Session ID must be 1-256 characters and contain only letters, numbers, hyphens, and underscores');
+            throw new ValidationError(TOOLS.SPAWN_SUBAGENT, 'Session ID must be 1-256 characters and contain only letters, numbers, hyphens, and underscores');
         }
         const existing = this.sessions.get(sessionId);
         if (existing) {

package/dist/session/storage.js.map

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

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

@@ -0,0 +1,27 @@
+/**
+ * Task state machine — defines valid transitions and guards.
+ *
+ * States: created → running | failed | cancelled | timed_out
+ *                   running → completed | failed | cancelled | timed_out
+ *
+ * Terminal states reject all further transitions (first-writer-wins).
+ */
+import { type TaskState } from './types.js';
+/**
+ * Check whether a state transition is valid.
+ */
+export declare function isValidTransition(from: TaskState, to: TaskState): boolean;
+/**
+ * Check whether a state is terminal (no further transitions).
+ */
+export declare function isTerminalState(state: TaskState): boolean;
+/**
+ * Attempt a state transition. Returns the new state on success,
+ * or null if the transition is invalid.
+ */
+export declare function transition(from: TaskState, to: TaskState): TaskState | null;
+/**
+ * Map from terminal state to a human-readable reason.
+ */
+export declare const TERMINAL_REASONS: Record<string, string>;
+//# sourceMappingURL=state-machine.d.ts.map

package/dist/task/state-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.d.ts","sourceRoot":"","sources":["../../src/task/state-machine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAmB,MAAM,YAAY,CAAC;AAsB7D;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,GAAG,OAAO,CAIzE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAEzD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAG3E;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKnD,CAAC"}

package/dist/task/state-machine.js

@@ -0,0 +1,59 @@
+/**
+ * Task state machine — defines valid transitions and guards.
+ *
+ * States: created → running | failed | cancelled | timed_out
+ *                   running → completed | failed | cancelled | timed_out
+ *
+ * Terminal states reject all further transitions (first-writer-wins).
+ */
+import { TERMINAL_STATES } from './types.js';
+/**
+ * Valid state transitions.
+ * Key = from state, Value = set of allowed target states.
+ */
+const VALID_TRANSITIONS = new Map([
+    ['created', new Set(['running', 'failed', 'cancelled', 'timed_out'])],
+    [
+        'running',
+        new Set(['completed', 'failed', 'cancelled', 'timed_out']),
+    ],
+    // Terminal states have no valid transitions
+    ['completed', new Set()],
+    ['failed', new Set()],
+    ['cancelled', new Set()],
+    ['timed_out', new Set()],
+]);
+/**
+ * Check whether a state transition is valid.
+ */
+export function isValidTransition(from, to) {
+    const allowed = VALID_TRANSITIONS.get(from);
+    if (!allowed)
+        return false;
+    return allowed.has(to);
+}
+/**
+ * Check whether a state is terminal (no further transitions).
+ */
+export function isTerminalState(state) {
+    return TERMINAL_STATES.has(state);
+}
+/**
+ * Attempt a state transition. Returns the new state on success,
+ * or null if the transition is invalid.
+ */
+export function transition(from, to) {
+    if (!isValidTransition(from, to))
+        return null;
+    return to;
+}
+/**
+ * Map from terminal state to a human-readable reason.
+ */
+export const TERMINAL_REASONS = {
+    completed: 'Task completed successfully',
+    failed: 'Task failed',
+    cancelled: 'Task was cancelled',
+    timed_out: 'Task exceeded timeout',
+};
+//# sourceMappingURL=state-machine.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.js","sourceRoot":"","sources":["../../src/task/state-machine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAkB,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7D;;;GAGG;AACH,MAAM,iBAAiB,GAGnB,IAAI,GAAG,CAAC;IACV,CAAC,SAAS,EAAE,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,CAAgB,CAAC,CAAC;IACpF;QACE,SAAS;QACT,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,CAAgB,CAAC;KAC1E;IACD,4CAA4C;IAC5C,CAAC,WAAW,EAAE,IAAI,GAAG,EAAa,CAAC;IACnC,CAAC,QAAQ,EAAE,IAAI,GAAG,EAAa,CAAC;IAChC,CAAC,WAAW,EAAE,IAAI,GAAG,EAAa,CAAC;IACnC,CAAC,WAAW,EAAE,IAAI,GAAG,EAAa,CAAC;CACpC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAe,EAAE,EAAa;IAC9D,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAgB;IAC9C,OAAO,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAe,EAAE,EAAa;IACvD,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD,SAAS,EAAE,6BAA6B;IACxC,MAAM,EAAE,aAAa;IACrB,SAAS,EAAE,oBAAoB;IAC/B,SAAS,EAAE,uBAAuB;CACnC,CAAC"}

package/dist/task/store.d.ts

@@ -0,0 +1,91 @@
+/**
+ * TaskStore — single authoritative source for task state.
+ *
+ * Module-level singleton that replaces the old task-manager.ts.
+ * Uses explicit state machine, ring buffer for output, and
+ * deterministic cleanup on terminal transitions.
+ */
+import type { ChildProcess } from 'child_process';
+import { type TaskState, type TaskRecord, type TaskSummary, type CreateTaskOptions } from './types.js';
+export declare class TaskStore {
+    private readonly tasks;
+    private readonly maxTasks;
+    private readonly maxOutputLines;
+    constructor(maxTasks?: number, maxOutputLines?: number);
+    /**
+     * Create a new task. Returns the task record.
+     * Task starts in 'created' state.
+     */
+    createTask(opts: CreateTaskOptions): Promise<TaskRecord>;
+    /**
+     * Transition a task to a new state.
+     * Returns true on success, false if the transition is invalid.
+     *
+     * On terminal transitions, runs the cleanup procedure.
+     */
+    transitionTo(id: string, newState: TaskState, options?: {
+        error?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<boolean>;
+    /**
+     * Set the process reference and PID on a task.
+     */
+    setProcess(id: string, proc: ChildProcess): void;
+    /**
+     * Get the process reference for a task.
+     */
+    getProcess(id: string): ChildProcess | undefined;
+    /**
+     * Append an output line to a task's ring buffer and output file.
+     */
+    appendOutput(id: string, line: string): Promise<void>;
+    /**
+     * Get a task by ID.
+     */
+    getTask(id: string): TaskRecord | undefined;
+    /**
+     * Get all tasks.
+     */
+    getAllTasks(): TaskRecord[];
+    /**
+     * Get task counts by state.
+     */
+    getTaskCounts(): Record<string, number>;
+    /**
+     * Convert a TaskRecord to a TaskSummary (for external APIs).
+     * Maps the new state field to the legacy 'status' field.
+     */
+    toSummary(task: TaskRecord): TaskSummary;
+    /**
+     * Cancel a single running task.
+     * Returns true if the task was successfully cancelled.
+     */
+    cancelTask(id: string): Promise<boolean>;
+    /**
+     * Cancel all running tasks (for shutdown).
+     * Returns the number of tasks cancelled.
+     */
+    cancelAll(): Promise<number>;
+    /**
+     * Get stall warning for a running task.
+     */
+    getStallWarning(task: TaskRecord): string | null;
+    /**
+     * Reset all state (for testing only).
+     */
+    resetForTesting(): void;
+    /**
+     * Cleanup procedure for terminal transitions.
+     */
+    private cleanupTerminal;
+    /**
+     * Generate a collision-free task ID.
+     */
+    private generateUniqueId;
+    /**
+     * Evict oldest terminal tasks if at capacity.
+     */
+    private evictIfNeeded;
+}
+export declare const taskStore: TaskStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/task/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/task/store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AASlD,OAAO,EACL,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AAkBpB,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAGtC,QAAQ,GAAE,MAAkB,EAC5B,cAAc,GAAE,MAAyB;IAQ3C;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;IA6B9D;;;;;OAKG;IACG,YAAY,CAChB,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,SAAS,EACnB,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GACA,OAAO,CAAC,OAAO,CAAC;IA0BnB;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI;IAUhD;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAOhD;;OAEG;IACG,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe3D;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI3C;;OAEG;IACH,WAAW,IAAI,UAAU,EAAE;IAI3B;;OAEG;IACH,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAmBvC;;;OAGG;IACH,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW;IAgCxC;;;OAGG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAM9C;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAiBlC;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI;IAchD;;OAEG;IACH,eAAe,IAAI,IAAI;IAYvB;;OAEG;YACW,eAAe;IAyC7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;OAEG;IACH,OAAO,CAAC,aAAa;CAYtB;AAID,eAAO,MAAM,SAAS,WAAkB,CAAC"}