@supaku/agentfactory 0.1.0

package/dist/src/orchestrator/state-types.d.ts

@@ -0,0 +1,165 @@
+/**
+ * Worktree State Types
+ *
+ * Types for persisting agent state to the .agent/ directory within each worktree.
+ * This enables crash recovery, heartbeat monitoring, and progress tracking.
+ */
+import type { AgentWorkType } from '@supaku/agentfactory-linear';
+/**
+ * Status of the agent's work in the worktree
+ */
+export type WorktreeStatus = 'initializing' | 'running' | 'completing' | 'completed' | 'failed' | 'stopped';
+/**
+ * Primary state file for the worktree
+ * Stored at: .agent/state.json
+ */
+export interface WorktreeState {
+    /** Linear issue ID (UUID) */
+    issueId: string;
+    /** Human-readable issue identifier (e.g., SUP-123) */
+    issueIdentifier: string;
+    /** Linear AgentSession ID (if available) */
+    linearSessionId: string | null;
+    /** Claude CLI session ID for --resume (if available) */
+    claudeSessionId: string | null;
+    /** Type of work being performed */
+    workType: AgentWorkType;
+    /** The prompt that was given to the agent */
+    prompt: string;
+    /** Unix timestamp when work started */
+    startedAt: number;
+    /** Current status of the work */
+    status: WorktreeStatus;
+    /** Human-readable description of current activity */
+    currentPhase: string | null;
+    /** Unix timestamp of last state update */
+    lastUpdatedAt: number;
+    /** Number of times recovery has been attempted */
+    recoveryAttempts: number;
+    /** Worker ID if running on a remote worker */
+    workerId: string | null;
+    /** Process ID of the agent */
+    pid: number | null;
+    /** Error message if status is 'failed' */
+    errorMessage?: string;
+    /** PR URL if one was created */
+    pullRequestUrl?: string;
+    /**
+     * Claude Code Task List ID for intra-session task coordination
+     * Format: {issueIdentifier}-{WORKTYPE} (e.g., "SUP-123-DEV")
+     * Enables task persistence across crashes and subagent coordination
+     */
+    taskListId?: string;
+}
+/**
+ * Activity type for heartbeat tracking
+ */
+export type HeartbeatActivityType = 'tool_use' | 'thinking' | 'waiting' | 'idle';
+/**
+ * Heartbeat state file for liveness detection
+ * Stored at: .agent/heartbeat.json
+ * Updated every 10 seconds while the agent is running
+ */
+export interface HeartbeatState {
+    /** Unix timestamp of this heartbeat */
+    timestamp: number;
+    /** Process ID of the agent */
+    pid: number;
+    /** Memory usage in megabytes */
+    memoryUsageMB: number;
+    /** Uptime in seconds since agent started */
+    uptime: number;
+    /** Type of last detected activity */
+    lastActivityType: HeartbeatActivityType;
+    /** Unix timestamp of last activity */
+    lastActivityTimestamp: number;
+    /** Total number of tool calls made so far */
+    toolCallsCount: number;
+    /** Current operation being performed (if any) */
+    currentOperation: string | null;
+}
+/**
+ * Todo item status (mirrors TodoWrite tool)
+ */
+export type TodoStatus = 'pending' | 'in_progress' | 'completed';
+/**
+ * Todo item (mirrors TodoWrite tool structure)
+ */
+export interface TodoItem {
+    /** Task description (imperative form) */
+    content: string;
+    /** Current status */
+    status: TodoStatus;
+    /** Present continuous form for display */
+    activeForm: string;
+}
+/**
+ * Persisted todo list state
+ * Stored at: .agent/todos.json
+ * Synced with TodoWrite tool calls
+ */
+export interface TodosState {
+    /** Unix timestamp of last update */
+    updatedAt: number;
+    /** Current todo items */
+    items: TodoItem[];
+}
+/**
+ * Progress log entry type
+ */
+export type ProgressEventType = 'start' | 'phase' | 'tool' | 'error' | 'recovery' | 'complete' | 'stop';
+/**
+ * Progress log entry
+ * Appended to: .agent/progress.log
+ * Format: timestamp|event_type|details
+ */
+export interface ProgressLogEntry {
+    /** Unix timestamp */
+    timestamp: number;
+    /** Type of event */
+    eventType: ProgressEventType;
+    /** Event details (JSON stringified if object) */
+    details: string;
+}
+/**
+ * Result of checking for recoverable state in a worktree
+ */
+export interface RecoveryCheckResult {
+    /** Whether recovery is possible */
+    canRecover: boolean;
+    /** Whether an agent is currently alive (heartbeat fresh) */
+    agentAlive: boolean;
+    /** The state if found */
+    state?: WorktreeState;
+    /** The heartbeat if found */
+    heartbeat?: HeartbeatState;
+    /** The todos if found */
+    todos?: TodosState;
+    /** Reason why recovery is not possible */
+    reason?: 'no_state' | 'agent_alive' | 'max_attempts' | 'invalid_state';
+    /** Human-readable message */
+    message: string;
+}
+/**
+ * Configuration for heartbeat writer
+ */
+export interface HeartbeatWriterConfig {
+    /** Directory path to write heartbeat to */
+    agentDir: string;
+    /** Process ID of the agent */
+    pid: number;
+    /** Interval between heartbeats in milliseconds (default: 10000) */
+    intervalMs?: number;
+    /** Start time of the agent (for uptime calculation) */
+    startTime: number;
+}
+/**
+ * Configuration for progress logger
+ */
+export interface ProgressLoggerConfig {
+    /** Directory path to write progress log to */
+    agentDir: string;
+    /** Maximum log file size in bytes before rotation (default: 1MB) */
+    maxSizeBytes?: number;
+}
+//# sourceMappingURL=state-types.d.ts.map

package/dist/src/orchestrator/state-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-types.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/state-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAEhE;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,SAAS,GACT,YAAY,GACZ,WAAW,GACX,QAAQ,GACR,SAAS,CAAA;AAEb;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,sDAAsD;IACtD,eAAe,EAAE,MAAM,CAAA;IACvB,4CAA4C;IAC5C,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,wDAAwD;IACxD,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,mCAAmC;IACnC,QAAQ,EAAE,aAAa,CAAA;IACvB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAA;IACd,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAA;IACjB,iCAAiC;IACjC,MAAM,EAAE,cAAc,CAAA;IACtB,qDAAqD;IACrD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAA;IACrB,kDAAkD;IAClD,gBAAgB,EAAE,MAAM,CAAA;IACxB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,8BAA8B;IAC9B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gCAAgC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC7B,UAAU,GACV,UAAU,GACV,SAAS,GACT,MAAM,CAAA;AAEV;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAA;IACjB,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,gCAAgC;IAChC,aAAa,EAAE,MAAM,CAAA;IACrB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAA;IACd,qCAAqC;IACrC,gBAAgB,EAAE,qBAAqB,CAAA;IACvC,sCAAsC;IACtC,qBAAqB,EAAE,MAAM,CAAA;IAC7B,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAA;IACtB,iDAAiD;IACjD,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;CAChC;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,CAAA;AAEhE;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAA;IACf,qBAAqB;IACrB,MAAM,EAAE,UAAU,CAAA;IAClB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAA;IACjB,yBAAyB;IACzB,KAAK,EAAE,QAAQ,EAAE,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,OAAO,GACP,OAAO,GACP,MAAM,GACN,OAAO,GACP,UAAU,GACV,UAAU,GACV,MAAM,CAAA;AAEV;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,oBAAoB;IACpB,SAAS,EAAE,iBAAiB,CAAA;IAC5B,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,UAAU,EAAE,OAAO,CAAA;IACnB,4DAA4D;IAC5D,UAAU,EAAE,OAAO,CAAA;IACnB,yBAAyB;IACzB,KAAK,CAAC,EAAE,aAAa,CAAA;IACrB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,cAAc,CAAA;IAC1B,yBAAyB;IACzB,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,UAAU,GAAG,aAAa,GAAG,cAAc,GAAG,eAAe,CAAA;IACtE,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAA;IAChB,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAA;IAChB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB"}

package/dist/src/orchestrator/state-types.js

@@ -0,0 +1,7 @@
+/**
+ * Worktree State Types
+ *
+ * Types for persisting agent state to the .agent/ directory within each worktree.
+ * This enables crash recovery, heartbeat monitoring, and progress tracking.
+ */
+export {};

package/dist/src/orchestrator/stream-parser.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Claude Stream-JSON Parser
+ *
+ * Parses Claude's stream-json output format and maps events to handler callbacks.
+ * The stream-json format emits newline-delimited JSON events during execution.
+ *
+ * Event types:
+ * - init: Initial message with configuration
+ * - system: System messages and prompts
+ * - assistant: Assistant text output (partial/streaming)
+ * - tool_use: Tool being invoked
+ * - tool_result: Result from tool execution
+ * - result: Final result when complete
+ * - error: Error events
+ */
+/** Base event structure */
+export interface ClaudeStreamEvent {
+    type: string;
+    timestamp?: string;
+}
+/** Initialization event */
+export interface ClaudeInitEvent extends ClaudeStreamEvent {
+    type: 'init';
+    message: string;
+    sessionId?: string;
+}
+/** System message event */
+export interface ClaudeSystemEvent extends ClaudeStreamEvent {
+    type: 'system';
+    message: string;
+    subtype?: 'prompt' | 'info' | 'warning';
+}
+/** Assistant text output event */
+export interface ClaudeAssistantEvent extends ClaudeStreamEvent {
+    type: 'assistant';
+    message: string;
+    partial?: boolean;
+}
+/** Tool use event - when Claude invokes a tool */
+export interface ClaudeToolUseEvent extends ClaudeStreamEvent {
+    type: 'tool_use';
+    tool: string;
+    input: Record<string, unknown>;
+    tool_use_id?: string;
+}
+/** Tool result event - when tool execution completes */
+export interface ClaudeToolResultEvent extends ClaudeStreamEvent {
+    type: 'tool_result';
+    tool: string;
+    output: string;
+    tool_use_id?: string;
+    is_error?: boolean;
+}
+/** Final result event */
+export interface ClaudeResultEvent extends ClaudeStreamEvent {
+    type: 'result';
+    result: string;
+    cost?: {
+        input_tokens: number;
+        output_tokens: number;
+    };
+    duration_ms?: number;
+}
+/** Error event */
+export interface ClaudeErrorEvent extends ClaudeStreamEvent {
+    type: 'error';
+    error: {
+        message: string;
+        code?: string;
+        details?: unknown;
+    };
+}
+/** Todo item in a user event */
+export interface ClaudeTodoItem {
+    content: string;
+    status: 'pending' | 'in_progress' | 'completed';
+    activeForm: string;
+}
+/** User event - contains tool results including todo updates */
+export interface ClaudeUserEvent extends ClaudeStreamEvent {
+    type: 'user';
+    message?: {
+        role: 'user';
+        content?: Array<{
+            tool_use_id?: string;
+            type?: string;
+            content?: string;
+        }>;
+    };
+    tool_use_result?: {
+        oldTodos?: ClaudeTodoItem[];
+        newTodos?: ClaudeTodoItem[];
+    };
+}
+/** Union of all Claude stream event types */
+export type ClaudeEvent = ClaudeInitEvent | ClaudeSystemEvent | ClaudeAssistantEvent | ClaudeToolUseEvent | ClaudeToolResultEvent | ClaudeResultEvent | ClaudeErrorEvent | ClaudeUserEvent | ClaudeStreamEvent;
+/** Event handlers for Claude stream events */
+export interface ClaudeStreamHandlers {
+    onInit?: (event: ClaudeInitEvent) => void | Promise<void>;
+    onSystem?: (event: ClaudeSystemEvent) => void | Promise<void>;
+    onAssistant?: (event: ClaudeAssistantEvent) => void | Promise<void>;
+    onToolUse?: (event: ClaudeToolUseEvent) => void | Promise<void>;
+    onToolResult?: (event: ClaudeToolResultEvent) => void | Promise<void>;
+    onResult?: (event: ClaudeResultEvent) => void | Promise<void>;
+    onError?: (event: ClaudeErrorEvent) => void | Promise<void>;
+    onUser?: (event: ClaudeUserEvent) => void | Promise<void>;
+    onTodo?: (newTodos: ClaudeTodoItem[], oldTodos: ClaudeTodoItem[]) => void | Promise<void>;
+    onUnknown?: (event: ClaudeStreamEvent) => void | Promise<void>;
+}
+/**
+ * Claude Stream Parser
+ *
+ * Handles parsing of newline-delimited JSON stream from Claude,
+ * including buffering for partial lines.
+ */
+export declare class ClaudeStreamParser {
+    private buffer;
+    private handlers;
+    constructor(handlers?: ClaudeStreamHandlers);
+    /**
+     * Feed raw data from stdout into the parser
+     */
+    feed(data: Buffer | string): Promise<void>;
+    /**
+     * Flush any remaining buffered data
+     */
+    flush(): Promise<void>;
+    /**
+     * Parse a single JSON line and dispatch to appropriate handler
+     */
+    private parseLine;
+    /**
+     * Dispatch an event to the appropriate handler
+     */
+    private dispatchEvent;
+    /**
+     * Handle user events, extracting todo updates if present
+     */
+    private handleUserEvent;
+}
+/**
+ * Create a new Claude stream parser instance
+ */
+export declare function createStreamParser(handlers: ClaudeStreamHandlers): ClaudeStreamParser;
+//# sourceMappingURL=stream-parser.d.ts.map

package/dist/src/orchestrator/stream-parser.d.ts.map

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

package/dist/src/orchestrator/stream-parser.js

@@ -0,0 +1,131 @@
+/**
+ * Claude Stream-JSON Parser
+ *
+ * Parses Claude's stream-json output format and maps events to handler callbacks.
+ * The stream-json format emits newline-delimited JSON events during execution.
+ *
+ * Event types:
+ * - init: Initial message with configuration
+ * - system: System messages and prompts
+ * - assistant: Assistant text output (partial/streaming)
+ * - tool_use: Tool being invoked
+ * - tool_result: Result from tool execution
+ * - result: Final result when complete
+ * - error: Error events
+ */
+/**
+ * Claude Stream Parser
+ *
+ * Handles parsing of newline-delimited JSON stream from Claude,
+ * including buffering for partial lines.
+ */
+export class ClaudeStreamParser {
+    buffer = '';
+    handlers;
+    constructor(handlers = {}) {
+        this.handlers = handlers;
+    }
+    /**
+     * Feed raw data from stdout into the parser
+     */
+    async feed(data) {
+        this.buffer += data.toString();
+        // Process complete lines
+        const lines = this.buffer.split('\n');
+        // Keep the last incomplete line in buffer
+        this.buffer = lines.pop() ?? '';
+        for (const line of lines) {
+            if (line.trim()) {
+                await this.parseLine(line);
+            }
+        }
+    }
+    /**
+     * Flush any remaining buffered data
+     */
+    async flush() {
+        if (this.buffer.trim()) {
+            await this.parseLine(this.buffer);
+            this.buffer = '';
+        }
+    }
+    /**
+     * Parse a single JSON line and dispatch to appropriate handler
+     */
+    async parseLine(line) {
+        let event;
+        try {
+            event = JSON.parse(line);
+        }
+        catch (error) {
+            // Log JSON parse errors with context for debugging
+            // This helps diagnose truncated or malformed messages
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            const linePreview = line.length > 200
+                ? line.substring(0, 200) + `... (${line.length} chars total)`
+                : line;
+            console.warn('JSON parse error in stream', {
+                error: errorMessage,
+                lineLength: line.length,
+                linePreview,
+            });
+            return;
+        }
+        await this.dispatchEvent(event);
+    }
+    /**
+     * Dispatch an event to the appropriate handler
+     */
+    async dispatchEvent(event) {
+        try {
+            switch (event.type) {
+                case 'init':
+                    await this.handlers.onInit?.(event);
+                    break;
+                case 'system':
+                    await this.handlers.onSystem?.(event);
+                    break;
+                case 'assistant':
+                    await this.handlers.onAssistant?.(event);
+                    break;
+                case 'tool_use':
+                    await this.handlers.onToolUse?.(event);
+                    break;
+                case 'tool_result':
+                    await this.handlers.onToolResult?.(event);
+                    break;
+                case 'result':
+                    await this.handlers.onResult?.(event);
+                    break;
+                case 'error':
+                    await this.handlers.onError?.(event);
+                    break;
+                case 'user':
+                    await this.handleUserEvent(event);
+                    break;
+                default:
+                    await this.handlers.onUnknown?.(event);
+            }
+        }
+        catch (error) {
+            console.error(`Error handling ${event.type} event:`, error);
+        }
+    }
+    /**
+     * Handle user events, extracting todo updates if present
+     */
+    async handleUserEvent(event) {
+        // Always call onUser if registered
+        await this.handlers.onUser?.(event);
+        // Check for todo updates in tool_use_result
+        if (event.tool_use_result?.newTodos) {
+            await this.handlers.onTodo?.(event.tool_use_result.newTodos, event.tool_use_result.oldTodos ?? []);
+        }
+    }
+}
+/**
+ * Create a new Claude stream parser instance
+ */
+export function createStreamParser(handlers) {
+    return new ClaudeStreamParser(handlers);
+}

package/dist/src/orchestrator/types.d.ts

@@ -0,0 +1,205 @@
+/**
+ * Agent Orchestrator Types
+ */
+import type { AgentWorkType } from '@supaku/agentfactory-linear';
+import type { AgentProvider } from '../providers/types';
+/**
+ * Result of parsing an agent's output to determine pass/fail
+ * Used for QA and acceptance work types to decide status transitions
+ */
+export type AgentWorkResult = 'passed' | 'failed' | 'unknown';
+/**
+ * Timeout configuration for a specific work type
+ */
+export interface WorkTypeTimeoutConfig {
+    /** Inactivity timeout in milliseconds for this work type */
+    inactivityTimeoutMs?: number;
+    /** Maximum session duration in milliseconds for this work type */
+    maxSessionTimeoutMs?: number;
+}
+export interface OrchestratorConfig {
+    /** Agent provider instance. If not provided, resolved via AGENT_PROVIDER env var (default: claude) */
+    provider?: AgentProvider;
+    /** Maximum concurrent agents (default: 3) */
+    maxConcurrent?: number;
+    /** Project name to filter backlog issues */
+    project?: string;
+    /** Base path for git worktrees (default: .worktrees) */
+    worktreePath?: string;
+    /** Linear API key (defaults to LINEAR_API_KEY env var) */
+    linearApiKey?: string;
+    /** Whether to auto-transition issue status (default: true) */
+    autoTransition?: boolean;
+    /**
+     * Preserve worktree when PR creation fails for development work types (default: true).
+     * When true, worktrees are kept if:
+     * - Work type is 'development' or 'inflight' and no PR URL was detected
+     * - There are uncommitted changes in the worktree
+     * - There are unpushed commits on the branch
+     * This prevents data loss when git push or PR creation fails.
+     */
+    preserveWorkOnPrFailure?: boolean;
+    /**
+     * Enable sandbox mode for spawned agents (default: false).
+     *
+     * WARNING: Currently defaults to false due to known bugs in Claude Code's sandbox:
+     * - https://github.com/anthropics/claude-code/issues/14162 (excludedCommands doesn't bypass network)
+     * - https://github.com/anthropics/claude-code/issues/12150 (proxy set for excluded commands)
+     *
+     * Set to true to re-enable sandbox once these issues are fixed.
+     */
+    sandboxEnabled?: boolean;
+    /** Configuration for streaming activities to Linear */
+    streamConfig?: OrchestratorStreamConfig;
+    /**
+     * Configuration for proxying activities through the agent API.
+     * When set, activities are sent to the API endpoint instead of directly to Linear.
+     * This is required for remote workers because Linear's Agent API requires OAuth tokens.
+     */
+    apiActivityConfig?: {
+        /** Base URL of the agent API (e.g., https://agent.supaku.dev) */
+        baseUrl: string;
+        /** API authentication key for the worker */
+        apiKey: string;
+        /** Worker ID for identification */
+        workerId: string;
+    };
+    /**
+     * Inactivity timeout in milliseconds (default: 300000 = 5 minutes).
+     * Agent is stopped if no activity for this duration.
+     * Can be overridden per work type via workTypeTimeouts.
+     */
+    inactivityTimeoutMs?: number;
+    /**
+     * Maximum session duration in milliseconds (default: unlimited).
+     * Hard cap on total agent runtime regardless of activity.
+     * Can be overridden per work type via workTypeTimeouts.
+     */
+    maxSessionTimeoutMs?: number;
+    /**
+     * Per-work-type timeout overrides.
+     * Different work types (e.g., QA, development) can have different thresholds.
+     */
+    workTypeTimeouts?: Partial<Record<AgentWorkType, WorkTypeTimeoutConfig>>;
+}
+export interface OrchestratorIssue {
+    id: string;
+    identifier: string;
+    title: string;
+    description: string | undefined;
+    url: string;
+    priority: number;
+    labels: string[];
+}
+export interface AgentProcess {
+    issueId: string;
+    identifier: string;
+    /** Worktree identifier includes work type suffix (e.g., "SUP-294-QA") */
+    worktreeIdentifier: string;
+    sessionId?: string;
+    /** Claude CLI session ID for resuming sessions with --resume */
+    claudeSessionId?: string;
+    worktreePath: string;
+    pid: number | undefined;
+    status: 'starting' | 'running' | 'completed' | 'failed' | 'stopped' | 'incomplete';
+    startedAt: Date;
+    completedAt?: Date;
+    exitCode?: number;
+    error?: Error;
+    /** Type of work: 'development' or 'qa' */
+    workType?: AgentWorkType;
+    /** GitHub PR URL if a pull request was created */
+    pullRequestUrl?: string;
+    /** Full completion message from Claude (stored for comment posting) */
+    resultMessage?: string;
+    /** Reason why work was marked incomplete (only set when status is 'incomplete') */
+    incompleteReason?: 'no_pr_created' | 'uncommitted_changes' | 'unpushed_commits';
+    /** Result of work for QA/acceptance agents (passed/failed/unknown) */
+    workResult?: AgentWorkResult;
+    /** Reason why agent was stopped (only set when status is 'stopped') */
+    stopReason?: 'user_request' | 'timeout';
+    /** Last activity timestamp for inactivity timeout tracking */
+    lastActivityAt: Date;
+    /** Total cost in USD (accumulated from provider result events) */
+    totalCostUsd?: number;
+    /** Total input tokens used */
+    inputTokens?: number;
+    /** Total output tokens used */
+    outputTokens?: number;
+}
+export interface OrchestratorEvents {
+    onAgentStart?: (agent: AgentProcess) => void;
+    onAgentComplete?: (agent: AgentProcess) => void;
+    onAgentError?: (agent: AgentProcess, error: Error) => void;
+    onAgentStopped?: (agent: AgentProcess) => void;
+    /** Called when agent work is incomplete (no PR, uncommitted changes, etc.) */
+    onAgentIncomplete?: (agent: AgentProcess) => void;
+    onIssueSelected?: (issue: OrchestratorIssue) => void;
+    /** Called when Claude session ID is captured from init event */
+    onClaudeSessionId?: (linearSessionId: string, claudeSessionId: string) => void | Promise<void>;
+    /** Called when an activity is emitted for an agent (used for timeout tracking) */
+    onActivityEmitted?: (agent: AgentProcess, activityType: string) => void;
+}
+export interface SpawnAgentOptions {
+    issueId: string;
+    identifier: string;
+    /** Worktree identifier with work type suffix (e.g., "SUP-294-QA") */
+    worktreeIdentifier: string;
+    sessionId?: string;
+    worktreePath: string;
+    /** Enable streaming activities to Linear (default: true when sessionId is provided) */
+    streamActivities?: boolean;
+    /** Type of work: determines prompt and agent routing (defaults to 'development') */
+    workType?: AgentWorkType;
+    /** Custom prompt override. If not provided, generates prompt based on workType */
+    prompt?: string;
+}
+export interface OrchestratorStreamConfig {
+    /** Minimum interval between activities in ms (default: 500ms) */
+    minInterval?: number;
+    /** Maximum length for tool outputs before truncation (default: 2000) */
+    maxOutputLength?: number;
+    /** Whether to include timestamps in activities (default: false) */
+    includeTimestamps?: boolean;
+}
+export interface OrchestratorResult {
+    success: boolean;
+    agents: AgentProcess[];
+    errors: Array<{
+        issueId: string;
+        error: Error;
+    }>;
+}
+export interface StopAgentResult {
+    stopped: boolean;
+    reason?: 'not_found' | 'already_stopped' | 'signal_failed';
+    agent?: AgentProcess;
+}
+export interface ForwardPromptResult {
+    forwarded: boolean;
+    resumed: boolean;
+    /** True if message was injected into running session (no restart needed) */
+    injected?: boolean;
+    reason?: 'not_found' | 'spawn_failed' | 'no_worktree';
+    agent?: AgentProcess;
+    error?: Error;
+}
+export interface InjectMessageResult {
+    /** True if message was successfully injected into running session */
+    injected: boolean;
+    reason?: 'not_running' | 'no_query' | 'injection_failed';
+    error?: Error;
+}
+export interface SpawnAgentWithResumeOptions {
+    issueId: string;
+    identifier: string;
+    /** Worktree identifier with work type suffix (e.g., "SUP-294-QA") */
+    worktreeIdentifier: string;
+    sessionId: string;
+    worktreePath: string;
+    prompt: string;
+    claudeSessionId?: string;
+    /** Type of work: determines transitions and agent behavior (defaults to 'development') */
+    workType?: AgentWorkType;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/orchestrator/types.d.ts.map

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

package/dist/src/orchestrator/types.js

@@ -0,0 +1,4 @@
+/**
+ * Agent Orchestrator Types
+ */
+export {};