@sudocode-ai/types 0.1.10 → 0.1.12

package/dist/claude-to-ag-ui.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Claude to AG-UI Transformation Logic
+ *
+ * Shared transformation functions for converting raw Claude stream-json messages
+ * to AG-UI events. Used by both:
+ * - Backend: Real-time transformation for SSE streaming
+ * - Frontend: Historical transformation for log replay
+ *
+ * @module claude-to-ag-ui
+ */
+/**
+ * Claude stream-json message format
+ * Based on Claude Code CLI output structure
+ */
+export interface ClaudeStreamMessage {
+    type: "assistant" | "tool_result" | "result" | "error";
+    message?: {
+        id?: string;
+        model?: string;
+        role?: string;
+        content?: Array<{
+            type: "text" | "tool_use";
+            text?: string;
+            id?: string;
+            name?: string;
+            input?: any;
+        }>;
+        stop_reason?: string;
+        stop_sequence?: string | null;
+    };
+    result?: {
+        tool_use_id?: string;
+        content?: Array<{
+            type: string;
+            text?: string;
+        }>;
+    };
+    usage?: {
+        input_tokens?: number;
+        output_tokens?: number;
+        cache_read_input_tokens?: number;
+        cache_creation_input_tokens?: number;
+    };
+    error?: {
+        message: string;
+        type?: string;
+    };
+}
+/**
+ * AG-UI Event types
+ * Minimal interface needed for transformation
+ */
+export interface AgUiEvent {
+    type: string;
+    timestamp: number;
+    [key: string]: any;
+}
+/**
+ * Transform a single Claude stream-json message to AG-UI events
+ *
+ * @param message - Raw Claude message from stream-json output
+ * @param startSequence - Starting sequence number for events
+ * @returns Array of AG-UI events (may be empty for unhandled message types)
+ *
+ * @example
+ * ```typescript
+ * const message = JSON.parse(line);
+ * const events = transformClaudeMessageToAgUi(message, 0);
+ * events.forEach(event => console.log(event));
+ * ```
+ */
+export declare function transformClaudeMessageToAgUi(message: ClaudeStreamMessage, startSequence: number): AgUiEvent[];
+/**
+ * Parse array of raw execution logs (NDJSON format) to AG-UI events
+ *
+ * Processes each line as a separate Claude message and transforms to AG-UI events.
+ * Handles parse errors gracefully by logging warnings and continuing.
+ *
+ * @param rawLogs - Array of NDJSON log lines
+ * @returns Promise resolving to array of AG-UI events
+ *
+ * @example
+ * ```typescript
+ * const logs = await fetch('/api/executions/123/logs').then(r => r.json());
+ * const events = await parseExecutionLogs(logs.logs);
+ * console.log(`Parsed ${events.length} events`);
+ * ```
+ */
+export declare function parseExecutionLogs(rawLogs: string[]): Promise<AgUiEvent[]>;
+//# sourceMappingURL=claude-to-ag-ui.d.ts.map

package/dist/claude-to-ag-ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-to-ag-ui.d.ts","sourceRoot":"","sources":["../src/claude-to-ag-ui.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC;IACvD,OAAO,CAAC,EAAE;QACR,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,KAAK,CAAC;YACd,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;YAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,EAAE,CAAC,EAAE,MAAM,CAAC;YACZ,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,KAAK,CAAC,EAAE,GAAG,CAAC;SACb,CAAC,CAAC;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B,CAAC;IACF,MAAM,CAAC,EAAE;QACP,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAClD,CAAC;IACF,KAAK,CAAC,EAAE;QACN,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,uBAAuB,CAAC,EAAE,MAAM,CAAC;QACjC,2BAA2B,CAAC,EAAE,MAAM,CAAC;KACtC,CAAC;IACF,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,mBAAmB,EAC5B,aAAa,EAAE,MAAM,GACpB,SAAS,EAAE,CAoGb;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,SAAS,EAAE,CAAC,CAiCtB"}

package/dist/claude-to-ag-ui.js

@@ -0,0 +1,153 @@
+/**
+ * Claude to AG-UI Transformation Logic
+ *
+ * Shared transformation functions for converting raw Claude stream-json messages
+ * to AG-UI events. Used by both:
+ * - Backend: Real-time transformation for SSE streaming
+ * - Frontend: Historical transformation for log replay
+ *
+ * @module claude-to-ag-ui
+ */
+/**
+ * Transform a single Claude stream-json message to AG-UI events
+ *
+ * @param message - Raw Claude message from stream-json output
+ * @param startSequence - Starting sequence number for events
+ * @returns Array of AG-UI events (may be empty for unhandled message types)
+ *
+ * @example
+ * ```typescript
+ * const message = JSON.parse(line);
+ * const events = transformClaudeMessageToAgUi(message, 0);
+ * events.forEach(event => console.log(event));
+ * ```
+ */
+export function transformClaudeMessageToAgUi(message, startSequence) {
+    const events = [];
+    const timestamp = Date.now();
+    switch (message.type) {
+        case "assistant": {
+            // Extract content blocks from assistant message
+            const content = message.message?.content || [];
+            for (const block of content) {
+                if (block.type === "text" && block.text) {
+                    // Text message → TEXT_MESSAGE_CONTENT event
+                    events.push({
+                        type: "CUSTOM",
+                        timestamp,
+                        name: "TEXT_MESSAGE_CONTENT",
+                        value: {
+                            content: block.text,
+                        },
+                    });
+                }
+                else if (block.type === "tool_use") {
+                    // Tool use → TOOL_CALL_START + TOOL_CALL_ARGS events
+                    const toolId = block.id || `tool-${Date.now()}`;
+                    events.push({
+                        type: "TOOL_CALL_START",
+                        timestamp,
+                        toolCallId: toolId,
+                        toolCallName: block.name || "unknown",
+                    }, {
+                        type: "TOOL_CALL_ARGS",
+                        timestamp,
+                        toolCallId: toolId,
+                        delta: JSON.stringify(block.input || {}),
+                    });
+                }
+            }
+            break;
+        }
+        case "tool_result": {
+            // Tool result → TOOL_CALL_END + TOOL_CALL_RESULT events
+            const toolUseId = message.result?.tool_use_id || "unknown";
+            const resultContent = message.result?.content || [];
+            const resultText = resultContent.find((c) => c.type === "text")?.text || "";
+            events.push({
+                type: "TOOL_CALL_END",
+                timestamp,
+                toolCallId: toolUseId,
+            }, {
+                type: "TOOL_CALL_RESULT",
+                timestamp,
+                messageId: `msg-${toolUseId}`,
+                toolCallId: toolUseId,
+                content: resultText,
+            });
+            break;
+        }
+        case "result": {
+            // Result message with usage → USAGE_UPDATE event
+            if (message.usage) {
+                const usage = message.usage;
+                events.push({
+                    type: "CUSTOM",
+                    timestamp,
+                    name: "USAGE_UPDATE",
+                    value: {
+                        inputTokens: usage.input_tokens || 0,
+                        outputTokens: usage.output_tokens || 0,
+                        cacheTokens: usage.cache_read_input_tokens || 0,
+                        totalTokens: (usage.input_tokens || 0) + (usage.output_tokens || 0),
+                    },
+                });
+            }
+            break;
+        }
+        case "error": {
+            // Error message → RUN_ERROR event
+            events.push({
+                type: "RUN_ERROR",
+                timestamp,
+                message: message.error?.message || "Unknown error",
+                errorType: message.error?.type,
+            });
+            break;
+        }
+    }
+    return events;
+}
+/**
+ * Parse array of raw execution logs (NDJSON format) to AG-UI events
+ *
+ * Processes each line as a separate Claude message and transforms to AG-UI events.
+ * Handles parse errors gracefully by logging warnings and continuing.
+ *
+ * @param rawLogs - Array of NDJSON log lines
+ * @returns Promise resolving to array of AG-UI events
+ *
+ * @example
+ * ```typescript
+ * const logs = await fetch('/api/executions/123/logs').then(r => r.json());
+ * const events = await parseExecutionLogs(logs.logs);
+ * console.log(`Parsed ${events.length} events`);
+ * ```
+ */
+export async function parseExecutionLogs(rawLogs) {
+    const events = [];
+    let sequence = 0;
+    for (let i = 0; i < rawLogs.length; i++) {
+        const line = rawLogs[i].trim();
+        // Skip empty lines
+        if (!line) {
+            continue;
+        }
+        try {
+            // Parse JSON line
+            const message = JSON.parse(line);
+            // Transform to AG-UI events
+            const agUiEvents = transformClaudeMessageToAgUi(message, sequence);
+            // Accumulate events
+            events.push(...agUiEvents);
+            sequence += agUiEvents.length;
+        }
+        catch (error) {
+            // Log warning but continue processing
+            console.warn(`[parseExecutionLogs] Failed to parse log line ${i + 1}:`, error instanceof Error ? error.message : String(error));
+            // Don't throw - continue with remaining logs
+        }
+    }
+    return events;
+}
+//# sourceMappingURL=claude-to-ag-ui.js.map

package/dist/claude-to-ag-ui.js.map

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

package/dist/crdt.d.ts

@@ -0,0 +1,117 @@
+/**
+ * CRDT Type Definitions
+ *
+ * Shared type definitions for CRDT state synchronization between
+ * the coordinator and agents.
+ */
+import { IssueStatus } from './index.js';
+/**
+ * Issue state in CRDT
+ */
+export interface IssueState {
+    id: string;
+    title: string;
+    content: string;
+    status: IssueStatus;
+    priority: number;
+    parent?: string;
+    archived: boolean;
+    createdAt: number;
+    updatedAt: number;
+    lastModifiedBy: string;
+    version: number;
+    tempStatus?: string;
+    tempProgress?: {
+        current: number;
+        total: number;
+        message?: string;
+    };
+}
+/**
+ * Spec state in CRDT
+ */
+export interface SpecState {
+    id: string;
+    title: string;
+    content: string;
+    priority: number;
+    parent?: string;
+    createdAt: number;
+    updatedAt: number;
+    lastModifiedBy: string;
+    version: number;
+    tempSections?: Record<string, string>;
+    tempDiff?: string;
+}
+/**
+ * Execution state in CRDT
+ */
+export interface ExecutionState {
+    id: string;
+    issueId?: string;
+    specId?: string;
+    status: 'preparing' | 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
+    phase?: string;
+    progress?: {
+        current: number;
+        total: number;
+        message?: string;
+    };
+    startedAt: number;
+    updatedAt: number;
+    completedAt?: number;
+    agentId: string;
+}
+/**
+ * Agent metadata in CRDT
+ */
+export interface AgentMetadata {
+    id: string;
+    executionId?: string;
+    status: 'initializing' | 'idle' | 'working' | 'disconnected';
+    lastHeartbeat: number;
+    connectedAt: number;
+    disconnectedAt?: number;
+    worktreePath?: string;
+}
+/**
+ * Feedback state in CRDT
+ */
+export interface FeedbackState {
+    id: string;
+    specId: string;
+    issueId: string;
+    type: 'comment' | 'suggestion' | 'request';
+    content: string;
+    anchorLine?: number;
+    anchorText?: string;
+    createdAt: number;
+    updatedAt: number;
+    lastModifiedBy: string;
+}
+/**
+ * CRDT Agent configuration
+ */
+export interface CRDTAgentConfig {
+    agentId: string;
+    coordinatorUrl?: string;
+    coordinatorHost?: string;
+    coordinatorPort?: number;
+    heartbeatInterval?: number;
+    maxReconnectAttempts?: number;
+    reconnectBaseDelay?: number;
+    reconnectMaxDelay?: number;
+    connectionTimeout?: number;
+}
+/**
+ * CRDT Coordinator configuration
+ */
+export interface CRDTCoordinatorConfig {
+    port?: number;
+    host?: string;
+    persistInterval?: number;
+    gcInterval?: number;
+    executionTTL?: number;
+    agentTTL?: number;
+}
+//# sourceMappingURL=crdt.d.ts.map

package/dist/crdt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crdt.d.ts","sourceRoot":"","sources":["../src/crdt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAEhB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAEhB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAClF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE;QACT,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,cAAc,CAAC;IAC7D,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/crdt.js

@@ -0,0 +1,8 @@
+/**
+ * CRDT Type Definitions
+ *
+ * Shared type definitions for CRDT state synchronization between
+ * the coordinator and agents.
+ */
+export {};
+//# sourceMappingURL=crdt.js.map

package/dist/crdt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crdt.js","sourceRoot":"","sources":["../src/crdt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/history.d.ts

@@ -0,0 +1,72 @@
+/**
+ * CRDT History Type Definitions
+ *
+ * Types for in-memory CRDT update history tracking.
+ */
+/**
+ * Record of a single CRDT update with metadata
+ */
+export interface CRDTUpdateRecord {
+    id: string;
+    entityType: 'issue' | 'spec' | 'feedback';
+    entityId: string;
+    updateData: Uint8Array;
+    clientId: string;
+    timestamp: number;
+    contentSnapshot?: {
+        title: string;
+        content: string;
+        [key: string]: any;
+    };
+}
+/**
+ * In-memory history storage structure
+ */
+export interface UpdateHistory {
+    updates: CRDTUpdateRecord[];
+    entityIndex: Map<string, number[]>;
+    clientIndex: Map<string, number[]>;
+    oldestTimestamp: number;
+    newestTimestamp: number;
+}
+/**
+ * Metadata about the history state
+ */
+export interface HistoryMetadata {
+    oldestTimestamp: number;
+    newestTimestamp: number;
+    totalUpdates: number;
+    retentionWindowMs: number;
+    entitiesTracked: number;
+    memoryUsageMB: number;
+}
+/**
+ * Document version at a specific timestamp
+ */
+export interface VersionInfo {
+    timestamp: number;
+    title: string;
+    content: string;
+    lastModifiedBy: string;
+    [key: string]: any;
+}
+/**
+ * Diff chunk between two versions
+ */
+export interface DiffChunk {
+    type: 'added' | 'removed' | 'unchanged';
+    value: string;
+    count: number;
+}
+/**
+ * Line-by-line blame/attribution information
+ */
+export interface BlameInfo {
+    lines: Array<{
+        lineNumber: number;
+        author: string;
+        timestamp: number;
+        line: string;
+    }>;
+}
+//# sourceMappingURL=history.d.ts.map

package/dist/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACnC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,KAAK,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;CACJ"}

package/dist/history.js

@@ -0,0 +1,7 @@
+/**
+ * CRDT History Type Definitions
+ *
+ * Types for in-memory CRDT update history tracking.
+ */
+export {};
+//# sourceMappingURL=history.js.map

package/dist/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/schema.d.ts

@@ -19,6 +19,8 @@ export declare const ISSUE_FEEDBACK_TABLE = "\nCREATE TABLE IF NOT EXISTS issue_
 export declare const EXECUTIONS_TABLE = "\nCREATE TABLE IF NOT EXISTS executions (\n    id TEXT PRIMARY KEY,\n    issue_id TEXT,\n    issue_uuid TEXT,\n\n    -- Execution mode and configuration\n    mode TEXT CHECK(mode IN ('worktree', 'local')),\n    prompt TEXT,\n    config TEXT,\n\n    -- Process information (legacy + new)\n    agent_type TEXT,\n    session_id TEXT,\n    workflow_execution_id TEXT,\n\n    -- Git/branch information\n    target_branch TEXT NOT NULL,\n    branch_name TEXT NOT NULL,\n    before_commit TEXT,\n    after_commit TEXT,\n    worktree_path TEXT,\n\n    -- Status (unified - supports both old and new statuses)\n    status TEXT NOT NULL CHECK(status IN (\n        'preparing', 'pending', 'running', 'paused',\n        'completed', 'failed', 'cancelled', 'stopped'\n    )),\n\n    -- Timing (consistent with other tables)\n    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,\n    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,\n    started_at DATETIME,\n    completed_at DATETIME,\n    cancelled_at DATETIME,\n\n    -- Results and metadata\n    exit_code INTEGER,\n    error_message TEXT,\n    error TEXT,\n    model TEXT,\n    summary TEXT,\n    files_changed TEXT,\n\n    -- Relationships\n    parent_execution_id TEXT,\n\n    -- Multi-step workflow support (future extension)\n    step_type TEXT,\n    step_index INTEGER,\n    step_config TEXT,\n\n    FOREIGN KEY (issue_id) REFERENCES issues(id) ON DELETE SET NULL,\n    FOREIGN KEY (issue_uuid) REFERENCES issues(uuid) ON DELETE SET NULL,\n    FOREIGN KEY (parent_execution_id) REFERENCES executions(id) ON DELETE SET NULL\n);\n";
 export declare const PROMPT_TEMPLATES_TABLE = "\nCREATE TABLE IF NOT EXISTS prompt_templates (\n    id TEXT PRIMARY KEY,\n    name TEXT NOT NULL,\n    description TEXT,\n    type TEXT NOT NULL CHECK(type IN ('issue', 'spec', 'custom')),\n    template TEXT NOT NULL,\n    variables TEXT NOT NULL,\n    is_default INTEGER NOT NULL DEFAULT 0 CHECK(is_default IN (0, 1)),\n    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,\n    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP\n);\n";
 export declare const EXECUTION_LOGS_TABLE = "\nCREATE TABLE IF NOT EXISTS execution_logs (\n    execution_id TEXT PRIMARY KEY,\n    raw_logs TEXT,\n    normalized_entry TEXT,\n    byte_size INTEGER NOT NULL DEFAULT 0,\n    line_count INTEGER NOT NULL DEFAULT 0,\n    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,\n    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,\n    FOREIGN KEY (execution_id) REFERENCES executions(id) ON DELETE CASCADE,\n    CHECK (raw_logs IS NOT NULL OR normalized_entry IS NOT NULL)\n);\n";
+export declare const WORKFLOWS_TABLE = "\nCREATE TABLE IF NOT EXISTS workflows (\n    id TEXT PRIMARY KEY,\n    title TEXT NOT NULL,\n    source TEXT NOT NULL,          -- JSON (WorkflowSource: spec, issues, root_issue, or goal)\n    status TEXT NOT NULL DEFAULT 'pending' CHECK(status IN (\n        'pending', 'running', 'paused',\n        'completed', 'failed', 'cancelled'\n    )),\n    steps TEXT NOT NULL DEFAULT '[]',  -- JSON array (WorkflowStep[])\n    worktree_path TEXT,\n    branch_name TEXT,\n    base_branch TEXT NOT NULL,\n    current_step_index INTEGER NOT NULL DEFAULT 0,\n    orchestrator_execution_id TEXT,\n    orchestrator_session_id TEXT,\n    config TEXT NOT NULL,          -- JSON (WorkflowConfig)\n    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,\n    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,\n    started_at DATETIME,\n    completed_at DATETIME,\n    FOREIGN KEY (orchestrator_execution_id) REFERENCES executions(id) ON DELETE SET NULL\n);\n";
+export declare const WORKFLOW_EVENTS_TABLE = "\nCREATE TABLE IF NOT EXISTS workflow_events (\n    id TEXT PRIMARY KEY,\n    workflow_id TEXT NOT NULL,\n    type TEXT NOT NULL,            -- WorkflowEventType (step_completed, workflow_paused, etc.)\n    step_id TEXT,\n    execution_id TEXT,\n    payload TEXT NOT NULL DEFAULT '{}',  -- JSON (event-specific data)\n    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,\n    processed_at DATETIME,         -- When orchestrator processed this event\n    FOREIGN KEY (workflow_id) REFERENCES workflows(id) ON DELETE CASCADE,\n    FOREIGN KEY (execution_id) REFERENCES executions(id) ON DELETE SET NULL\n);\n";
 /**
  * Index definitions
  */
@@ -31,6 +33,8 @@ export declare const ISSUE_FEEDBACK_INDEXES = "\nCREATE INDEX IF NOT EXISTS idx_
 export declare const EXECUTIONS_INDEXES = "\nCREATE INDEX IF NOT EXISTS idx_executions_issue_id ON executions(issue_id);\nCREATE INDEX IF NOT EXISTS idx_executions_issue_uuid ON executions(issue_uuid);\nCREATE INDEX IF NOT EXISTS idx_executions_status ON executions(status);\nCREATE INDEX IF NOT EXISTS idx_executions_session_id ON executions(session_id);\nCREATE INDEX IF NOT EXISTS idx_executions_parent ON executions(parent_execution_id);\nCREATE INDEX IF NOT EXISTS idx_executions_created_at ON executions(created_at);\nCREATE INDEX IF NOT EXISTS idx_executions_workflow ON executions(workflow_execution_id);\nCREATE INDEX IF NOT EXISTS idx_executions_workflow_step ON executions(workflow_execution_id, step_index);\nCREATE INDEX IF NOT EXISTS idx_executions_step_type ON executions(step_type);\n";
 export declare const PROMPT_TEMPLATES_INDEXES = "\nCREATE INDEX IF NOT EXISTS idx_templates_type ON prompt_templates(type);\nCREATE INDEX IF NOT EXISTS idx_templates_default ON prompt_templates(is_default);\n";
 export declare const EXECUTION_LOGS_INDEXES = "\nCREATE INDEX IF NOT EXISTS idx_execution_logs_updated_at ON execution_logs(updated_at);\nCREATE INDEX IF NOT EXISTS idx_execution_logs_byte_size ON execution_logs(byte_size);\nCREATE INDEX IF NOT EXISTS idx_execution_logs_line_count ON execution_logs(line_count);\n";
+export declare const WORKFLOWS_INDEXES = "\nCREATE INDEX IF NOT EXISTS idx_workflows_status ON workflows(status);\nCREATE INDEX IF NOT EXISTS idx_workflows_orchestrator ON workflows(orchestrator_execution_id);\nCREATE INDEX IF NOT EXISTS idx_workflows_created_at ON workflows(created_at);\nCREATE INDEX IF NOT EXISTS idx_workflows_updated_at ON workflows(updated_at);\nCREATE INDEX IF NOT EXISTS idx_workflows_base_branch ON workflows(base_branch);\n";
+export declare const WORKFLOW_EVENTS_INDEXES = "\nCREATE INDEX IF NOT EXISTS idx_workflow_events_workflow_id ON workflow_events(workflow_id);\nCREATE INDEX IF NOT EXISTS idx_workflow_events_type ON workflow_events(type);\nCREATE INDEX IF NOT EXISTS idx_workflow_events_execution_id ON workflow_events(execution_id);\nCREATE INDEX IF NOT EXISTS idx_workflow_events_processed ON workflow_events(processed_at);\nCREATE INDEX IF NOT EXISTS idx_workflow_events_created_at ON workflow_events(created_at);\nCREATE INDEX IF NOT EXISTS idx_workflow_events_unprocessed ON workflow_events(workflow_id, processed_at) WHERE processed_at IS NULL;\n";
 /**
  * View definitions
  */

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,cAAc,QAAQ,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,SAAS,uSAarB,CAAC;AAEF;;GAEG;AAEH,eAAO,MAAM,WAAW,ysBAiBvB,CAAC;AAEF,eAAO,MAAM,YAAY,qwBAmBxB,CAAC;AAEF,eAAO,MAAM,mBAAmB,iaAa/B,CAAC;AAEF,eAAO,MAAM,UAAU,mNAQtB,CAAC;AAEF,eAAO,MAAM,YAAY,uZAexB,CAAC;AAEF,eAAO,MAAM,oBAAoB,2qBAiBhC,CAAC;AAEF,eAAO,MAAM,gBAAgB,0jDAwD5B,CAAC;AAGF,eAAO,MAAM,sBAAsB,ocAYlC,CAAC;AAOF,eAAO,MAAM,oBAAoB,4eAYhC,CAAC;AAEF;;GAEG;AAEH,eAAO,MAAM,aAAa,oeAQzB,CAAC;AAEF,eAAO,MAAM,cAAc,+rBAW1B,CAAC;AAEF,eAAO,MAAM,qBAAqB,seAOjC,CAAC;AAEF,eAAO,MAAM,YAAY,kOAIxB,CAAC;AAEF,eAAO,MAAM,cAAc,2cAO1B,CAAC;AAEF,eAAO,MAAM,sBAAsB,+iBAQlC,CAAC;AAEF,eAAO,MAAM,kBAAkB,0vBAU9B,CAAC;AAEF,eAAO,MAAM,wBAAwB,oKAGpC,CAAC;AAEF,eAAO,MAAM,sBAAsB,gRAIlC,CAAC;AAEF;;GAEG;AAEH,eAAO,MAAM,iBAAiB,gqBAkB7B,CAAC;AAEF,eAAO,MAAM,mBAAmB,ovBAmB/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,UAUtB,CAAC;AAEF,eAAO,MAAM,WAAW,UAUvB,CAAC;AAEF,eAAO,MAAM,SAAS,UAA2C,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,cAAc,QAAQ,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,SAAS,uSAarB,CAAC;AAEF;;GAEG;AAEH,eAAO,MAAM,WAAW,ysBAiBvB,CAAC;AAEF,eAAO,MAAM,YAAY,qwBAmBxB,CAAC;AAEF,eAAO,MAAM,mBAAmB,iaAa/B,CAAC;AAEF,eAAO,MAAM,UAAU,mNAQtB,CAAC;AAEF,eAAO,MAAM,YAAY,uZAexB,CAAC;AAEF,eAAO,MAAM,oBAAoB,2qBAiBhC,CAAC;AAEF,eAAO,MAAM,gBAAgB,0jDAwD5B,CAAC;AAGF,eAAO,MAAM,sBAAsB,ocAYlC,CAAC;AAOF,eAAO,MAAM,oBAAoB,4eAYhC,CAAC;AAIF,eAAO,MAAM,eAAe,67BAuB3B,CAAC;AAGF,eAAO,MAAM,qBAAqB,0mBAajC,CAAC;AAEF;;GAEG;AAEH,eAAO,MAAM,aAAa,oeAQzB,CAAC;AAEF,eAAO,MAAM,cAAc,+rBAW1B,CAAC;AAEF,eAAO,MAAM,qBAAqB,seAOjC,CAAC;AAEF,eAAO,MAAM,YAAY,kOAIxB,CAAC;AAEF,eAAO,MAAM,cAAc,2cAO1B,CAAC;AAEF,eAAO,MAAM,sBAAsB,+iBAQlC,CAAC;AAEF,eAAO,MAAM,kBAAkB,0vBAU9B,CAAC;AAEF,eAAO,MAAM,wBAAwB,oKAGpC,CAAC;AAEF,eAAO,MAAM,sBAAsB,gRAIlC,CAAC;AAEF,eAAO,MAAM,iBAAiB,6ZAM7B,CAAC;AAEF,eAAO,MAAM,uBAAuB,+kBAOnC,CAAC;AAEF;;GAEG;AAEH,eAAO,MAAM,iBAAiB,gqBAkB7B,CAAC;AAEF,eAAO,MAAM,mBAAmB,ovBAmB/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,UAYtB,CAAC;AAEF,eAAO,MAAM,WAAW,UAYvB,CAAC;AAEF,eAAO,MAAM,SAAS,UAA2C,CAAC"}

package/dist/schema.js

@@ -207,6 +207,47 @@ CREATE TABLE IF NOT EXISTS execution_logs (
     CHECK (raw_logs IS NOT NULL OR normalized_entry IS NOT NULL)
 );
 `;
+// Workflows table - orchestrates multi-issue execution
+// Supports both sequential and agent-managed workflow strategies
+export const WORKFLOWS_TABLE = `
+CREATE TABLE IF NOT EXISTS workflows (
+    id TEXT PRIMARY KEY,
+    title TEXT NOT NULL,
+    source TEXT NOT NULL,          -- JSON (WorkflowSource: spec, issues, root_issue, or goal)
+    status TEXT NOT NULL DEFAULT 'pending' CHECK(status IN (
+        'pending', 'running', 'paused',
+        'completed', 'failed', 'cancelled'
+    )),
+    steps TEXT NOT NULL DEFAULT '[]',  -- JSON array (WorkflowStep[])
+    worktree_path TEXT,
+    branch_name TEXT,
+    base_branch TEXT NOT NULL,
+    current_step_index INTEGER NOT NULL DEFAULT 0,
+    orchestrator_execution_id TEXT,
+    orchestrator_session_id TEXT,
+    config TEXT NOT NULL,          -- JSON (WorkflowConfig)
+    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    started_at DATETIME,
+    completed_at DATETIME,
+    FOREIGN KEY (orchestrator_execution_id) REFERENCES executions(id) ON DELETE SET NULL
+);
+`;
+// Workflow events table - tracks workflow lifecycle events for orchestrator wakeups
+export const WORKFLOW_EVENTS_TABLE = `
+CREATE TABLE IF NOT EXISTS workflow_events (
+    id TEXT PRIMARY KEY,
+    workflow_id TEXT NOT NULL,
+    type TEXT NOT NULL,            -- WorkflowEventType (step_completed, workflow_paused, etc.)
+    step_id TEXT,
+    execution_id TEXT,
+    payload TEXT NOT NULL DEFAULT '{}',  -- JSON (event-specific data)
+    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    processed_at DATETIME,         -- When orchestrator processed this event
+    FOREIGN KEY (workflow_id) REFERENCES workflows(id) ON DELETE CASCADE,
+    FOREIGN KEY (execution_id) REFERENCES executions(id) ON DELETE SET NULL
+);
+`;
 /**
  * Index definitions
  */
@@ -281,6 +322,21 @@ CREATE INDEX IF NOT EXISTS idx_execution_logs_updated_at ON execution_logs(updat
 CREATE INDEX IF NOT EXISTS idx_execution_logs_byte_size ON execution_logs(byte_size);
 CREATE INDEX IF NOT EXISTS idx_execution_logs_line_count ON execution_logs(line_count);
 `;
+export const WORKFLOWS_INDEXES = `
+CREATE INDEX IF NOT EXISTS idx_workflows_status ON workflows(status);
+CREATE INDEX IF NOT EXISTS idx_workflows_orchestrator ON workflows(orchestrator_execution_id);
+CREATE INDEX IF NOT EXISTS idx_workflows_created_at ON workflows(created_at);
+CREATE INDEX IF NOT EXISTS idx_workflows_updated_at ON workflows(updated_at);
+CREATE INDEX IF NOT EXISTS idx_workflows_base_branch ON workflows(base_branch);
+`;
+export const WORKFLOW_EVENTS_INDEXES = `
+CREATE INDEX IF NOT EXISTS idx_workflow_events_workflow_id ON workflow_events(workflow_id);
+CREATE INDEX IF NOT EXISTS idx_workflow_events_type ON workflow_events(type);
+CREATE INDEX IF NOT EXISTS idx_workflow_events_execution_id ON workflow_events(execution_id);
+CREATE INDEX IF NOT EXISTS idx_workflow_events_processed ON workflow_events(processed_at);
+CREATE INDEX IF NOT EXISTS idx_workflow_events_created_at ON workflow_events(created_at);
+CREATE INDEX IF NOT EXISTS idx_workflow_events_unprocessed ON workflow_events(workflow_id, processed_at) WHERE processed_at IS NULL;
+`;
 /**
  * View definitions
  */
@@ -336,6 +392,8 @@ export const ALL_TABLES = [
     EXECUTIONS_TABLE,
     PROMPT_TEMPLATES_TABLE,
     EXECUTION_LOGS_TABLE,
+    WORKFLOWS_TABLE,
+    WORKFLOW_EVENTS_TABLE,
 ];
 export const ALL_INDEXES = [
     SPECS_INDEXES,
@@ -347,6 +405,8 @@ export const ALL_INDEXES = [
     EXECUTIONS_INDEXES,
     PROMPT_TEMPLATES_INDEXES,
     EXECUTION_LOGS_INDEXES,
+    WORKFLOWS_INDEXES,
+    WORKFLOW_EVENTS_INDEXES,
 ];
 export const ALL_VIEWS = [READY_ISSUES_VIEW, BLOCKED_ISSUES_VIEW];
 //# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC;AAEpC;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;;;;CAaxB,CAAC;AAEF;;GAEG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;CAiB1B,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;CAmB3B,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;CAalC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;;CAQzB,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;CAe3B,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;CAiBnC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwD/B,CAAC;AAEF,yBAAyB;AACzB,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;;;;;CAYrC,CAAC;AAEF,0DAA0D;AAC1D,wBAAwB;AACxB,mFAAmF;AACnF,8FAA8F;AAC9F,gEAAgE;AAChE,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;CAYnC,CAAC;AAEF;;GAEG;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;CAQ5B,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;CAW7B,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;CAOpC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG;;;;CAI3B,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;CAO7B,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;CAQrC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;CAUjC,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG;;;CAGvC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;CAIrC,CAAC;AAEF;;GAEG;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;CAkBhC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;CAmBlC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,WAAW;IACX,YAAY;IACZ,mBAAmB;IACnB,UAAU;IACV,YAAY;IACZ,oBAAoB;IACpB,gBAAgB;IAChB,sBAAsB;IACtB,oBAAoB;CACrB,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,aAAa;IACb,cAAc;IACd,qBAAqB;IACrB,YAAY;IACZ,cAAc;IACd,sBAAsB;IACtB,kBAAkB;IAClB,wBAAwB;IACxB,sBAAsB;CACvB,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC;AAEpC;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;;;;CAaxB,CAAC;AAEF;;GAEG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;CAiB1B,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;CAmB3B,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;CAalC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;;CAQzB,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;CAe3B,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;CAiBnC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwD/B,CAAC;AAEF,yBAAyB;AACzB,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;;;;;CAYrC,CAAC;AAEF,0DAA0D;AAC1D,wBAAwB;AACxB,mFAAmF;AACnF,8FAA8F;AAC9F,gEAAgE;AAChE,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;CAYnC,CAAC;AAEF,uDAAuD;AACvD,iEAAiE;AACjE,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;CAuB9B,CAAC;AAEF,oFAAoF;AACpF,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;CAapC,CAAC;AAEF;;GAEG;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;CAQ5B,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;CAW7B,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;CAOpC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG;;;;CAI3B,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;CAO7B,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;CAQrC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;CAUjC,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG;;;CAGvC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;CAIrC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;CAMhC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;CAOtC,CAAC;AAEF;;GAEG;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;CAkBhC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;CAmBlC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,WAAW;IACX,YAAY;IACZ,mBAAmB;IACnB,UAAU;IACV,YAAY;IACZ,oBAAoB;IACpB,gBAAgB;IAChB,sBAAsB;IACtB,oBAAoB;IACpB,eAAe;IACf,qBAAqB;CACtB,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,aAAa;IACb,cAAc;IACd,qBAAqB;IACrB,YAAY;IACZ,cAAc;IACd,sBAAsB;IACtB,kBAAkB;IAClB,wBAAwB;IACxB,sBAAsB;IACtB,iBAAiB;IACjB,uBAAuB;CACxB,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sudocode-ai/types",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "TypeScript type definitions for sudocode",
   "types": "src/index.d.ts",
   "type": "module",
@@ -17,6 +17,10 @@
       "types": "./src/agents.d.ts",
       "default": "./src/agents.d.ts"
     },
+    "./workflows": {
+      "types": "./src/workflows.d.ts",
+      "default": "./src/workflows.d.ts"
+    },
     "./schema": {
       "types": "./dist/schema.d.ts",
       "default": "./dist/schema.js"
@@ -54,6 +58,8 @@
     "src/index.d.ts",
     "src/events.d.ts",
     "src/agents.d.ts",
+    "src/artifacts.d.ts",
+    "src/workflows.d.ts",
     "dist"
   ],
   "devDependencies": {

package/src/agents.d.ts

@@ -135,6 +135,27 @@ export interface ClaudeCodeConfig extends BaseAgentConfig {
   };
   /** Prompt to send to Claude Code */
   prompt?: string;
+
+  // === Directory Restriction ===
+  /**
+   * Restrict file operations to the working directory
+   *
+   * When enabled, a PreToolUse hook is configured to block Read, Write, Edit,
+   * Glob, and Grep operations that target files outside the working directory.
+   *
+   * This provides security isolation when running agents in worktrees or
+   * sandboxed environments.
+   *
+   * @default false
+   */
+  restrictToWorkDir?: boolean;
+  /**
+   * Path to the directory guard hook script
+   *
+   * Only used when restrictToWorkDir is enabled. If not specified,
+   * the executor will use the bundled hook script from agent-execution-engine.
+   */
+  directoryGuardHookPath?: string;
 }
 
 /**

package/src/artifacts.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Execution artifacts types
+ *
+ * Types for artifacts created during executions (code changes, outputs, etc.)
+ */
+
+/**
+ * File change statistics for execution diff
+ */
+export interface FileChangeStat {
+  path: string;
+  additions: number;
+  deletions: number;
+  status: 'A' | 'M' | 'D' | 'R'; // Added, Modified, Deleted, Renamed
+}
+
+/**
+ * Changes snapshot at a specific point in time
+ */
+export interface ChangesSnapshot {
+  files: FileChangeStat[];
+  summary: {
+    totalFiles: number;
+    totalAdditions: number;
+    totalDeletions: number;
+  };
+  commitRange: {
+    before: string;
+    after: string;
+  } | null;
+  uncommitted: boolean;
+}
+
+/**
+ * Result of execution changes calculation
+ */
+export interface ExecutionChangesResult {
+  available: boolean;
+  reason?: 'missing_commits' | 'commits_not_found' | 'incomplete_execution' | 'git_error' | 'worktree_deleted_with_uncommitted_changes' | 'branch_deleted';
+
+  // Captured state: changes at execution completion time
+  captured?: ChangesSnapshot;
+
+  // Uncommitted changes at execution completion time (if any)
+  // This allows displaying both committed and uncommitted changes separately
+  uncommittedSnapshot?: ChangesSnapshot;
+
+  // Current state: changes at current branch HEAD (if different from captured)
+  current?: ChangesSnapshot;
+
+  // Branch and worktree metadata
+  branchName?: string; // Branch associated with execution
+  branchExists?: boolean; // Whether branch still exists
+  worktreeExists?: boolean; // Whether worktree still exists
+  additionalCommits?: number; // Number of commits since execution completed (current - captured)
+  commitsAhead?: number; // Number of commits the branch is ahead of target branch (for merge action visibility)
+  executionMode?: 'worktree' | 'local' | null; // Execution mode - helps distinguish between local and worktree executions
+
+  // Legacy compatibility (deprecated - use captured instead)
+  changes?: ChangesSnapshot;
+  commitRange?: {
+    before: string;
+    after: string;
+  } | null;
+  uncommitted?: boolean;
+}

package/src/index.d.ts

@@ -291,3 +291,40 @@ export type {
   ExecutionChangesResult,
   ChangesSnapshot,
 } from './artifacts.js';
+
+/**
+ * Workflow types for multi-issue orchestration
+ * See workflows.d.ts for detailed workflow types
+ */
+export type {
+  // Status types
+  WorkflowStatus,
+  WorkflowStepStatus,
+  // Source types
+  WorkflowSource,
+  WorkflowSourceSpec,
+  WorkflowSourceIssues,
+  WorkflowSourceRootIssue,
+  WorkflowSourceGoal,
+  // Escalation types (Human-in-the-Loop)
+  EscalationStatus,
+  EscalationResponse,
+  EscalationData,
+  // Configuration types
+  WorkflowParallelism,
+  WorkflowFailureStrategy,
+  WorkflowAutonomyLevel,
+  WorkflowConfig,
+  // Core entity types
+  WorkflowStep,
+  Workflow,
+  // Event types
+  WorkflowEventType,
+  WorkflowEvent,
+  // Database row types
+  WorkflowRow,
+  WorkflowEventRow,
+  // Utility types
+  CreateWorkflowOptions,
+  DependencyGraph,
+} from "./workflows.js";

package/src/workflows.d.ts

@@ -0,0 +1,501 @@
+/**
+ * Workflow types for sudocode
+ * Enables multi-issue automation with dependency-based orchestration
+ */
+
+import type { AgentType } from "./agents.js";
+
+// =============================================================================
+// Status Types
+// =============================================================================
+
+/**
+ * Workflow lifecycle status
+ */
+export type WorkflowStatus =
+  | "pending" // Created, not yet started
+  | "running" // Actively executing steps (includes planning phase)
+  | "paused" // Paused by user or orchestrator
+  | "completed" // All steps finished successfully
+  | "failed" // Workflow failed (unrecoverable)
+  | "cancelled"; // User cancelled
+
+/**
+ * Individual workflow step status
+ */
+export type WorkflowStepStatus =
+  | "pending" // Not yet ready (dependencies not met)
+  | "ready" // Dependencies met, can be executed
+  | "running" // Currently executing
+  | "completed" // Finished successfully
+  | "failed" // Execution failed
+  | "skipped" // Skipped by orchestrator
+  | "blocked"; // Blocked by failed dependency
+
+// =============================================================================
+// Source Types
+// =============================================================================
+
+/**
+ * Defines how a workflow's scope is determined
+ */
+export type WorkflowSource =
+  | WorkflowSourceSpec
+  | WorkflowSourceIssues
+  | WorkflowSourceRootIssue
+  | WorkflowSourceGoal;
+
+/**
+ * Workflow from issues implementing a spec
+ */
+export interface WorkflowSourceSpec {
+  type: "spec";
+  specId: string;
+}
+
+/**
+ * Workflow from explicit list of issues
+ */
+export interface WorkflowSourceIssues {
+  type: "issues";
+  issueIds: string[];
+}
+
+/**
+ * Workflow from a root issue and all its blockers
+ */
+export interface WorkflowSourceRootIssue {
+  type: "root_issue";
+  issueId: string;
+}
+
+/**
+ * Goal-based workflow where orchestrator creates issues dynamically
+ */
+export interface WorkflowSourceGoal {
+  type: "goal";
+  goal: string;
+}
+
+// =============================================================================
+// Escalation Types (Human-in-the-Loop)
+// =============================================================================
+
+/**
+ * Escalation status for human-in-the-loop workflows
+ */
+export type EscalationStatus = "pending" | "resolved" | "bypassed";
+
+/**
+ * User response to an escalation request
+ */
+export interface EscalationResponse {
+  /** User's action choice */
+  action: "approve" | "reject" | "custom";
+  /** Optional message from user */
+  message?: string;
+  /** When the user responded */
+  respondedAt: string;
+}
+
+/**
+ * Escalation data structure for pending or resolved escalations
+ */
+export interface EscalationData {
+  /** Unique escalation request identifier */
+  requestId: string;
+  /** Message displayed to user */
+  message: string;
+  /** Optional predefined options for user to choose */
+  options?: string[];
+  /** Additional context for the escalation */
+  context?: Record<string, unknown>;
+  /** User's response (present when resolved) */
+  response?: EscalationResponse;
+}
+
+// =============================================================================
+// Configuration Types
+// =============================================================================
+
+/**
+ * Workflow engine type
+ * - sequential: Steps are executed in order by the server, no agent orchestration
+ * - orchestrator: An AI agent orchestrates the workflow, making decisions dynamically
+ */
+export type WorkflowEngineType = "sequential" | "orchestrator";
+
+/**
+ * Workflow parallelism mode
+ */
+export type WorkflowParallelism = "sequential" | "parallel";
+
+/**
+ * Failure handling strategy
+ */
+export type WorkflowFailureStrategy =
+  | "stop" // Stop workflow immediately
+  | "pause" // Pause for user intervention
+  | "skip_dependents" // Skip this step and all dependents
+  | "continue"; // Continue with other independent steps
+
+/**
+ * Autonomy level for orchestrator-managed workflows
+ */
+export type WorkflowAutonomyLevel = "full_auto" | "human_in_the_loop";
+
+/**
+ * Workflow configuration options
+ */
+export interface WorkflowConfig {
+  // === Engine Selection ===
+
+  /**
+   * Which engine to use for workflow execution
+   * - sequential: Server-managed step execution (default)
+   * - orchestrator: AI agent orchestrates the workflow
+   * @default "sequential"
+   */
+  engineType: WorkflowEngineType;
+
+  // === Sequential Engine Options ===
+
+  /**
+   * Execution mode: sequential or parallel
+   * @default "sequential"
+   */
+  parallelism: WorkflowParallelism;
+
+  /**
+   * Maximum concurrent executions (when parallelism is "parallel")
+   */
+  maxConcurrency?: number;
+
+  /**
+   * How to handle step failures
+   * @default "pause"
+   */
+  onFailure: WorkflowFailureStrategy;
+
+  /**
+   * Auto-commit changes after each successful step
+   * @default true
+   */
+  autoCommitAfterStep: boolean;
+
+  /**
+   * Default agent type for step executions
+   * @default "claude-code"
+   */
+  defaultAgentType: AgentType;
+
+  // === Orchestrator Engine Options ===
+
+  /**
+   * Agent type for the orchestrator (agent-managed mode)
+   */
+  orchestratorAgentType?: AgentType;
+
+  /**
+   * Model for the orchestrator agent
+   */
+  orchestratorModel?: string;
+
+  /**
+   * Autonomy level for orchestrator decisions
+   * - full_auto: No user intervention, escalate_to_user bypassed
+   * - human_in_the_loop: Pause on escalations for user input
+   * @default "human_in_the_loop"
+   */
+  autonomyLevel: WorkflowAutonomyLevel;
+
+  // === Timeout Options ===
+
+  /**
+   * Timeout for individual executions (ms)
+   * Orchestrator will cancel stuck executions after this time
+   */
+  executionTimeoutMs?: number;
+
+  /**
+   * Idle timeout (ms) - wake orchestrator if nothing happens
+   */
+  idleTimeoutMs?: number;
+
+  /**
+   * Batch window for wakeup events (ms)
+   * Multiple events within this window are batched into one wakeup
+   */
+  wakeupBatchWindowMs?: number;
+
+  // === Worktree Options ===
+
+  /**
+   * Base branch for worktree creation
+   * Defaults to current working branch if not specified
+   */
+  baseBranch?: string;
+
+  /**
+   * Whether to create baseBranch if it doesn't exist
+   * @default false
+   */
+  createBaseBranch?: boolean;
+
+  /**
+   * Reuse an existing worktree by path
+   * If set, the workflow will use this worktree instead of creating a new one
+   * The path must exist and be a valid git worktree
+   */
+  reuseWorktreePath?: string;
+
+  // === Metadata Options ===
+
+  /**
+   * Custom workflow title
+   * Auto-generated from source if not specified
+   */
+  title?: string;
+}
+
+// =============================================================================
+// Core Entity Types
+// =============================================================================
+
+/**
+ * A single step in a workflow
+ * Each step corresponds to one issue execution
+ */
+export interface WorkflowStep {
+  /** Unique step identifier */
+  id: string;
+
+  /** Issue ID this step executes */
+  issueId: string;
+
+  /** Step index in workflow (for ordering) */
+  index: number;
+
+  /** Step IDs this step depends on */
+  dependencies: string[];
+
+  /** Current step status */
+  status: WorkflowStepStatus;
+
+  /** Execution ID once started */
+  executionId?: string;
+
+  /** Git commit SHA after step completion */
+  commitSha?: string;
+
+  /** Error message if failed */
+  error?: string;
+
+  /** Agent type override for this step */
+  agentType?: AgentType;
+
+  /** Model override for this step */
+  model?: string;
+}
+
+/**
+ * A workflow orchestrating multiple issue executions
+ */
+export interface Workflow {
+  /** Unique workflow identifier */
+  id: string;
+
+  /** Human-readable workflow title */
+  title: string;
+
+  /** How the workflow scope was defined */
+  source: WorkflowSource;
+
+  /** Current workflow status */
+  status: WorkflowStatus;
+
+  /** Steps in this workflow (empty initially for goal-based) */
+  steps: WorkflowStep[];
+
+  // === Worktree Information ===
+
+  /** Shared worktree path for sequential execution */
+  worktreePath?: string;
+
+  /** Branch name for workflow changes */
+  branchName?: string;
+
+  /** Base branch to create workflow branch from */
+  baseBranch: string;
+
+  // === Progress Tracking ===
+
+  /** Current step index (for sequential mode) */
+  currentStepIndex: number;
+
+  // === Orchestrator Information (agent-managed mode) ===
+
+  /** Execution ID of the orchestrator agent */
+  orchestratorExecutionId?: string;
+
+  /** Session ID for orchestrator (maintained across wakeups) */
+  orchestratorSessionId?: string;
+
+  // === Configuration ===
+
+  /** Workflow configuration */
+  config: WorkflowConfig;
+
+  // === Timestamps ===
+
+  /** When workflow was created */
+  createdAt: string;
+
+  /** When workflow was last updated */
+  updatedAt: string;
+
+  /** When workflow execution started */
+  startedAt?: string;
+
+  /** When workflow completed (success or failure) */
+  completedAt?: string;
+}
+
+// =============================================================================
+// Event Types
+// =============================================================================
+
+/**
+ * Types of workflow events
+ */
+export type WorkflowEventType =
+  // Step events
+  | "step_started"
+  | "step_completed"
+  | "step_failed"
+  | "step_skipped"
+  // Workflow lifecycle events
+  | "workflow_started"
+  | "workflow_paused"
+  | "workflow_resumed"
+  | "workflow_completed"
+  | "workflow_failed"
+  | "workflow_cancelled"
+  // Escalation events
+  | "escalation_requested"
+  | "escalation_resolved"
+  // Notification events
+  | "user_notification"
+  // Orchestrator events
+  | "orchestrator_wakeup"
+  | "user_response";
+
+/**
+ * A workflow event for tracking and orchestrator wakeups
+ */
+export interface WorkflowEvent {
+  /** Unique event identifier */
+  id: string;
+
+  /** Workflow this event belongs to */
+  workflowId: string;
+
+  /** Event type */
+  type: WorkflowEventType;
+
+  /** Related step ID (for step events) */
+  stepId?: string;
+
+  /** Related execution ID */
+  executionId?: string;
+
+  /** Event-specific payload */
+  payload: Record<string, unknown>;
+
+  /** When event was created */
+  createdAt: string;
+
+  /** When event was processed by orchestrator */
+  processedAt?: string;
+}
+
+// =============================================================================
+// Database Row Types (snake_case for SQLite)
+// =============================================================================
+
+/**
+ * Workflow row as stored in SQLite
+ * JSON fields are serialized as TEXT
+ */
+export interface WorkflowRow {
+  id: string;
+  title: string;
+  source: string; // JSON (WorkflowSource)
+  status: WorkflowStatus;
+  steps: string; // JSON (WorkflowStep[])
+  worktree_path: string | null;
+  branch_name: string | null;
+  base_branch: string;
+  current_step_index: number;
+  orchestrator_execution_id: string | null;
+  orchestrator_session_id: string | null;
+  config: string; // JSON (WorkflowConfig)
+  created_at: string;
+  updated_at: string;
+  started_at: string | null;
+  completed_at: string | null;
+}
+
+/**
+ * Workflow event row as stored in SQLite
+ */
+export interface WorkflowEventRow {
+  id: string;
+  workflow_id: string;
+  type: WorkflowEventType;
+  step_id: string | null;
+  execution_id: string | null;
+  payload: string; // JSON
+  created_at: string;
+  processed_at: string | null;
+}
+
+// =============================================================================
+// Utility Types
+// =============================================================================
+
+/**
+ * Options for creating a new workflow
+ */
+export interface CreateWorkflowOptions {
+  title: string;
+  source: WorkflowSource;
+  config?: Partial<WorkflowConfig>;
+  baseBranch?: string;
+}
+
+/**
+ * Dependency graph analysis result
+ */
+export interface DependencyGraph {
+  /** Issue IDs in the graph */
+  issueIds: string[];
+
+  /** Edges: [fromId, toId] pairs (from blocks to) */
+  edges: Array<[string, string]>;
+
+  /** Issues in topological order */
+  topologicalOrder: string[];
+
+  /** Detected cycles (if any) */
+  cycles: string[][] | null;
+
+  /** Groups of issues that can run in parallel */
+  parallelGroups: string[][];
+}
+
+/**
+ * Default workflow configuration values (type declaration)
+ * Actual defaults should be implemented in consuming packages
+ */
+export declare const DEFAULT_WORKFLOW_CONFIG: Readonly<WorkflowConfig>;