aicodeman 0.2.8

package/dist/task-tracker.js

@@ -0,0 +1,488 @@
+/**
+ * @fileoverview Background Task Tracker for Claude Code sessions
+ *
+ * This module tracks background tasks (subagents) spawned by Claude Code
+ * during session execution. It parses both JSON messages and terminal output
+ * to detect when tasks are created, updated, and completed.
+ *
+ * ## Task Hierarchy
+ *
+ * Tasks can be nested (parent-child relationships) when Claude spawns
+ * a subagent from within another subagent. The tracker maintains a stack
+ * to track nesting and a tree structure for visualization.
+ *
+ * ## Detection Methods
+ *
+ * 1. **JSON Messages**: Parses `tool_use` blocks for Task tool invocations
+ *    and `tool_result` blocks for completion
+ * 2. **Terminal Output**: Fallback pattern matching for launch/complete messages
+ *
+ * @module task-tracker
+ */
+import { EventEmitter } from 'node:events';
+import { assertNever } from './utils/index.js';
+// ========== Configuration Constants ==========
+/**
+ * Maximum number of completed tasks to keep in memory.
+ * Oldest completed tasks are removed when this limit is exceeded.
+ */
+const MAX_COMPLETED_TASKS = 100;
+/**
+ * Maximum age for pending tool uses (in milliseconds).
+ * Entries older than this are cleaned up to prevent unbounded growth.
+ * Default: 1 hour
+ */
+const PENDING_TOOL_USE_MAX_AGE_MS = 60 * 60 * 1000;
+/**
+ * Maximum number of pending tool uses to allow.
+ * Prevents unbounded growth if tool_results never arrive.
+ */
+const MAX_PENDING_TOOL_USES = 100;
+// ========== Pre-compiled Regex Patterns ==========
+/**
+ * Patterns that indicate a new task/agent is being launched.
+ * Used as fallback when JSON parsing doesn't capture the launch.
+ * Capture group 1: Agent/task type name
+ */
+const LAUNCH_PATTERNS = [/Launching\s+(\w+)\s+agent/i, /Starting\s+(\w+)\s+task/i, /Spawning\s+(\w+)\s+agent/i];
+/**
+ * Patterns that indicate a task has completed.
+ * Used as fallback when JSON parsing doesn't capture the result.
+ */
+const COMPLETE_PATTERNS = [/Task\s+completed/i, /Agent\s+finished/i, /Background\s+task\s+done/i];
+/**
+ * TaskTracker - Detects and tracks background tasks in Claude Code sessions.
+ *
+ * ## How It Works
+ *
+ * Claude Code outputs JSON messages when executing. When it spawns a subagent
+ * via the Task tool, we see:
+ *
+ * 1. `tool_use` block with `name: "Task"` and input parameters
+ * 2. ... task execution output ...
+ * 3. `tool_result` block with the result or error
+ *
+ * The tracker maintains:
+ * - A map of all tasks by ID
+ * - A stack of currently running tasks (for nesting)
+ * - Parent-child relationships between tasks
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * const tracker = new TaskTracker();
+ *
+ * tracker.on('taskCreated', (task) => {
+ *   console.log(`New task: ${task.description}`);
+ * });
+ *
+ * tracker.on('taskCompleted', (task) => {
+ *   console.log(`Task done: ${task.id}`);
+ * });
+ *
+ * // Feed in Claude messages
+ * tracker.processMessage(claudeJsonMessage);
+ *
+ * // Or terminal output as fallback
+ * tracker.processTerminalOutput(ptyData);
+ * ```
+ *
+ * @extends EventEmitter
+ */
+export class TaskTracker extends EventEmitter {
+    /** Map of task ID to task object */
+    tasks = new Map();
+    /** Stack of active task IDs for tracking nesting depth */
+    taskStack = [];
+    /** Pending tool_use blocks waiting for results (with timestamp for cleanup) */
+    pendingToolUses = new Map();
+    /**
+     * Creates a new TaskTracker instance.
+     */
+    constructor() {
+        super();
+    }
+    /**
+     * Process a Claude JSON message to detect task events.
+     *
+     * Looks for `tool_use` blocks with `name: "Task"` and `tool_result` blocks
+     * to track task lifecycle.
+     *
+     * @param msg - Parsed Claude JSON message object
+     * @fires taskCreated - When a new task is detected
+     * @fires taskCompleted - When a task finishes successfully
+     * @fires taskFailed - When a task finishes with error
+     */
+    processMessage(msg) {
+        if (!msg || !msg.message?.content)
+            return;
+        for (const block of msg.message.content) {
+            if (block.type === 'tool_use' && block.name === 'Task') {
+                this.handleTaskToolUse(block);
+            }
+            else if (block.type === 'tool_result') {
+                this.handleToolResult(block);
+            }
+        }
+    }
+    /**
+     * Process raw terminal output to detect task patterns.
+     *
+     * This is a fallback for when JSON parsing doesn't capture everything.
+     * Uses pre-compiled patterns to detect launch and completion messages.
+     *
+     * Note: May create duplicate tasks in some cases; deduplication is
+     * handled by checking for existing running tasks of the same type.
+     *
+     * @param data - Raw terminal output string
+     * @fires taskCreated - When a launch pattern is matched
+     * @fires taskCompleted - When a complete pattern is matched
+     */
+    processTerminalOutput(data) {
+        // Detect task launch patterns in terminal output
+        // Claude Code shows things like "Launching explore agent..." or similar
+        for (const pattern of LAUNCH_PATTERNS) {
+            const match = data.match(pattern);
+            if (match) {
+                // This is a heuristic detection - might create duplicate tasks
+                // but we dedupe by checking if we already have a running task of this type
+                const agentType = match[1].toLowerCase();
+                // Optimize: use iterator directly instead of Array.from
+                let existingRunning = false;
+                for (const task of this.tasks.values()) {
+                    if (task.subagentType === agentType && task.status === 'running') {
+                        existingRunning = true;
+                        break;
+                    }
+                }
+                if (!existingRunning) {
+                    this.createTaskFromTerminal(agentType, data);
+                }
+            }
+        }
+        // Detect task completion patterns
+        for (const pattern of COMPLETE_PATTERNS) {
+            if (pattern.test(data)) {
+                // Complete the most recent running task
+                const runningTask = this.getMostRecentRunningTask();
+                if (runningTask) {
+                    this.completeTask(runningTask.id);
+                }
+            }
+        }
+    }
+    /**
+     * Handle a tool_use block for the Task tool.
+     * Creates a new task and pushes it onto the stack.
+     *
+     * @param block - The tool_use content block
+     * @fires taskCreated
+     */
+    handleTaskToolUse(block) {
+        const toolUseId = block.id;
+        const params = block.input || {};
+        const description = params.description || params.prompt?.substring(0, 50) || 'Background task';
+        const subagentType = params.subagent_type || 'general';
+        // Determine parent (current top of stack or null)
+        const parentId = this.taskStack.length > 0 ? this.taskStack[this.taskStack.length - 1] : null;
+        // Store pending tool use - task starts when we see activity
+        this.pendingToolUses.set(toolUseId, {
+            description,
+            subagentType,
+            parentId,
+            createdAt: Date.now(),
+        });
+        // Clean up old pending entries to prevent unbounded growth
+        this.cleanupOldPendingToolUses();
+        // Create the task immediately
+        const task = {
+            id: toolUseId,
+            parentId,
+            description,
+            subagentType,
+            status: 'running',
+            startTime: Date.now(),
+            children: [],
+        };
+        this.tasks.set(toolUseId, task);
+        this.taskStack.push(toolUseId);
+        // Update parent's children list
+        if (parentId) {
+            const parent = this.tasks.get(parentId);
+            if (parent) {
+                parent.children.push(toolUseId);
+            }
+        }
+        this.emit('taskCreated', task);
+    }
+    /**
+     * Handle a tool_result block.
+     * Marks the corresponding task as completed or failed.
+     *
+     * @param block - The tool_result content block
+     * @fires taskCompleted - If result is success
+     * @fires taskFailed - If result is error
+     */
+    handleToolResult(block) {
+        const toolUseId = block.tool_use_id;
+        const task = this.tasks.get(toolUseId);
+        if (task) {
+            task.status = block.is_error ? 'failed' : 'completed';
+            task.endTime = Date.now();
+            task.output = typeof block.content === 'string' ? block.content : JSON.stringify(block.content);
+            // Remove from stack
+            const stackIndex = this.taskStack.indexOf(toolUseId);
+            if (stackIndex !== -1) {
+                this.taskStack.splice(stackIndex, 1);
+            }
+            if (block.is_error) {
+                this.emit('taskFailed', task, task.output || 'Unknown error');
+            }
+            else {
+                this.emit('taskCompleted', task);
+            }
+            // Clean up old completed tasks to prevent unbounded growth
+            this.cleanupCompletedTasks();
+        }
+        // Clean up pending
+        this.pendingToolUses.delete(toolUseId);
+    }
+    /**
+     * Remove old pending tool uses that never received results.
+     * Prevents unbounded growth if tool_results never arrive.
+     */
+    cleanupOldPendingToolUses() {
+        const now = Date.now();
+        const toDelete = [];
+        // Remove entries older than PENDING_TOOL_USE_MAX_AGE_MS
+        for (const [id, entry] of this.pendingToolUses) {
+            if (now - entry.createdAt > PENDING_TOOL_USE_MAX_AGE_MS) {
+                toDelete.push(id);
+            }
+        }
+        // If still over limit after age-based cleanup, remove oldest entries
+        if (this.pendingToolUses.size - toDelete.length > MAX_PENDING_TOOL_USES) {
+            const entries = Array.from(this.pendingToolUses.entries())
+                .filter(([id]) => !toDelete.includes(id))
+                .sort((a, b) => a[1].createdAt - b[1].createdAt);
+            const removeCount = entries.length - MAX_PENDING_TOOL_USES;
+            for (let i = 0; i < removeCount; i++) {
+                toDelete.push(entries[i][0]);
+            }
+        }
+        for (const id of toDelete) {
+            this.pendingToolUses.delete(id);
+        }
+    }
+    /**
+     * Remove old completed/failed tasks when exceeding the limit
+     * Keeps running tasks and the most recent completed tasks
+     */
+    cleanupCompletedTasks() {
+        const completedTasks = [];
+        // Collect all completed/failed tasks
+        for (const task of this.tasks.values()) {
+            if (task.status === 'completed' || task.status === 'failed') {
+                completedTasks.push(task);
+            }
+        }
+        // If under limit, no cleanup needed
+        if (completedTasks.length <= MAX_COMPLETED_TASKS) {
+            return;
+        }
+        // Sort by end time (oldest first)
+        completedTasks.sort((a, b) => (a.endTime || 0) - (b.endTime || 0));
+        // Remove oldest tasks beyond the limit
+        const toRemove = completedTasks.slice(0, completedTasks.length - MAX_COMPLETED_TASKS);
+        for (const task of toRemove) {
+            // Remove from parent's children list if applicable
+            if (task.parentId) {
+                const parent = this.tasks.get(task.parentId);
+                if (parent) {
+                    const childIndex = parent.children.indexOf(task.id);
+                    if (childIndex !== -1) {
+                        parent.children.splice(childIndex, 1);
+                    }
+                }
+            }
+            this.tasks.delete(task.id);
+        }
+    }
+    /**
+     * Create a task from terminal pattern detection.
+     * Used as fallback when JSON messages aren't available.
+     *
+     * @param agentType - Type of agent detected
+     * @param context - Terminal context for debugging
+     * @fires taskCreated
+     */
+    createTaskFromTerminal(agentType, _context) {
+        const taskId = `terminal-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;
+        const parentId = this.taskStack.length > 0 ? this.taskStack[this.taskStack.length - 1] : null;
+        const task = {
+            id: taskId,
+            parentId,
+            description: `${agentType} agent`,
+            subagentType: agentType,
+            status: 'running',
+            startTime: Date.now(),
+            children: [],
+        };
+        this.tasks.set(taskId, task);
+        this.taskStack.push(taskId);
+        if (parentId) {
+            const parent = this.tasks.get(parentId);
+            if (parent) {
+                parent.children.push(taskId);
+            }
+        }
+        this.emit('taskCreated', task);
+    }
+    /**
+     * Mark a task as completed.
+     *
+     * @param taskId - ID of task to complete
+     * @fires taskCompleted - If task was running
+     */
+    completeTask(taskId) {
+        const task = this.tasks.get(taskId);
+        if (task && task.status === 'running') {
+            task.status = 'completed';
+            task.endTime = Date.now();
+            const stackIndex = this.taskStack.indexOf(taskId);
+            if (stackIndex !== -1) {
+                this.taskStack.splice(stackIndex, 1);
+            }
+            this.emit('taskCompleted', task);
+        }
+    }
+    /**
+     * Get the most recently started running task.
+     * Returns the task at the top of the stack (most nested).
+     *
+     * @returns Most recent running task, or undefined if none
+     */
+    getMostRecentRunningTask() {
+        // Return the task at the top of the stack
+        if (this.taskStack.length > 0) {
+            const taskId = this.taskStack[this.taskStack.length - 1];
+            return this.tasks.get(taskId);
+        }
+        return undefined;
+    }
+    /**
+     * Get root-level tasks as a list.
+     *
+     * Child tasks can be accessed via the `children` array on each task.
+     * Use this for displaying a task tree in the UI.
+     *
+     * @returns Array of tasks without parents (root level)
+     */
+    getTaskTree() {
+        const rootTasks = [];
+        for (const task of this.tasks.values()) {
+            if (!task.parentId) {
+                rootTasks.push(task);
+            }
+        }
+        return rootTasks;
+    }
+    /**
+     * Lightweight task tree for SSE broadcasts — strips large `output` strings
+     * to avoid serializing 5-10MB of task results every 500ms.
+     * Full task details available via getTaskTree().
+     *
+     * @returns Array of root tasks with output truncated to 200 chars
+     */
+    getTaskTreeLight() {
+        const rootTasks = [];
+        for (const task of this.tasks.values()) {
+            if (!task.parentId) {
+                // Strip output to avoid serializing large strings on every broadcast
+                const { output: _output, ...lightTask } = task;
+                rootTasks.push(lightTask);
+            }
+        }
+        return rootTasks;
+    }
+    /**
+     * Get all tasks as a flat Map.
+     *
+     * @returns Copy of the internal tasks map (safe to modify)
+     */
+    getAllTasks() {
+        return new Map(this.tasks);
+    }
+    /**
+     * Get a specific task by its ID.
+     *
+     * @param taskId - The task ID to look up
+     * @returns The task if found, undefined otherwise
+     */
+    getTask(taskId) {
+        return this.tasks.get(taskId);
+    }
+    /**
+     * Get the count of currently running tasks.
+     *
+     * @returns Number of tasks with status 'running'
+     */
+    getRunningCount() {
+        let count = 0;
+        for (const task of this.tasks.values()) {
+            if (task.status === 'running')
+                count++;
+        }
+        return count;
+    }
+    /**
+     * Get aggregated statistics about all tracked tasks.
+     *
+     * @returns Object with counts:
+     *   - total: Total number of tracked tasks
+     *   - running: Tasks currently executing
+     *   - completed: Successfully finished tasks
+     *   - failed: Tasks that ended with errors
+     */
+    getStats() {
+        let running = 0, completed = 0, failed = 0;
+        for (const task of this.tasks.values()) {
+            switch (task.status) {
+                case 'running':
+                    running++;
+                    break;
+                case 'completed':
+                    completed++;
+                    break;
+                case 'failed':
+                    failed++;
+                    break;
+                default:
+                    assertNever(task.status, `Unhandled BackgroundTask status: ${task.status}`);
+            }
+        }
+        return { total: this.tasks.size, running, completed, failed };
+    }
+    /**
+     * Clear all tracked tasks.
+     *
+     * Use when the session is cleared or closed.
+     * Resets the task map, stack, and pending tool uses.
+     */
+    clear() {
+        this.tasks.clear();
+        this.taskStack = [];
+        this.pendingToolUses.clear();
+    }
+    /**
+     * Clean up resources and release memory.
+     *
+     * Call this when the session is being destroyed to prevent memory leaks.
+     * Clears all data and removes all event listeners.
+     */
+    destroy() {
+        this.clear();
+        this.removeAllListeners();
+    }
+}
+//# sourceMappingURL=task-tracker.js.map

package/dist/task-tracker.js.map

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

package/dist/task.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @fileoverview Task model for Claude prompt execution
+ *
+ * Represents a single task (prompt) to be executed by a Claude session.
+ * Tasks support priority ordering, dependencies, and completion detection.
+ *
+ * @module task
+ */
+import { TaskDefinition, TaskState, TaskStatus } from './types.js';
+/**
+ * Options for creating a new task.
+ */
+export interface CreateTaskOptions {
+    prompt: string;
+    workingDir?: string;
+    priority?: number;
+    dependencies?: string[];
+    completionPhrase?: string;
+    timeoutMs?: number;
+}
+/**
+ * A task representing a prompt to be executed by a Claude session.
+ *
+ * @description
+ * Tasks have a lifecycle: pending → running → completed/failed
+ * They support priority ordering and dependency chains.
+ */
+export declare class Task {
+    readonly id: string;
+    readonly prompt: string;
+    readonly workingDir: string;
+    readonly priority: number;
+    readonly dependencies: string[];
+    readonly completionPhrase: string | undefined;
+    readonly timeoutMs: number | undefined;
+    readonly createdAt: number;
+    private _status;
+    private _assignedSessionId;
+    private _startedAt;
+    private _completedAt;
+    private _output;
+    private _error;
+    /** Pre-compiled regex for completion phrase detection (avoids re-creation per check) */
+    private readonly _completionPattern;
+    constructor(options: CreateTaskOptions, id?: string);
+    get status(): TaskStatus;
+    get assignedSessionId(): string | null;
+    get startedAt(): number | null;
+    get completedAt(): number | null;
+    get output(): string;
+    get error(): string | null;
+    isPending(): boolean;
+    isRunning(): boolean;
+    isCompleted(): boolean;
+    isFailed(): boolean;
+    isDone(): boolean;
+    toDefinition(): TaskDefinition;
+    toState(): TaskState;
+    /** Reconstructs a Task from persisted state. */
+    static fromState(state: TaskState): Task;
+    /** Assigns this task to a session and marks it as running. */
+    assign(sessionId: string): void;
+    appendOutput(output: string): void;
+    setError(error: string): void;
+    complete(): void;
+    fail(error?: string): void;
+    reset(): void;
+    /** Checks if output contains the completion phrase. */
+    checkCompletion(output: string): boolean;
+    /** Returns true if the task has exceeded its timeout. */
+    isTimedOut(): boolean;
+}
+//# sourceMappingURL=task.d.ts.map

package/dist/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../src/task.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAUnE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,qBAAa,IAAI;IACf,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,kBAAkB,CAAuB;IACjD,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,MAAM,CAAuB;IACrC,wFAAwF;IACxF,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAgB;gBAEvC,OAAO,EAAE,iBAAiB,EAAE,EAAE,CAAC,EAAE,MAAM;IAcnD,IAAI,MAAM,IAAI,UAAU,CAEvB;IAED,IAAI,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAErC;IAED,IAAI,SAAS,IAAI,MAAM,GAAG,IAAI,CAE7B;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,IAAI,CAE/B;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,KAAK,IAAI,MAAM,GAAG,IAAI,CAEzB;IAED,SAAS,IAAI,OAAO;IAIpB,SAAS,IAAI,OAAO;IAIpB,WAAW,IAAI,OAAO;IAItB,QAAQ,IAAI,OAAO;IAInB,MAAM,IAAI,OAAO;IAIjB,YAAY,IAAI,cAAc;IAY9B,OAAO,IAAI,SAAS;IAapB,gDAAgD;IAChD,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAqBxC,8DAA8D;IAC9D,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAS/B,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIlC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7B,QAAQ,IAAI,IAAI;IAKhB,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ1B,KAAK,IAAI,IAAI;IASb,uDAAuD;IACvD,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAQxC,yDAAyD;IACzD,UAAU,IAAI,OAAO;CAMtB"}