@loom-framework/core 0.1.0-alpha.18 → 0.1.0-alpha.180

package/dist/backend/ai/output-parser.js

@@ -0,0 +1,264 @@
+/**
+ * Claude Code Output Parser
+ *
+ * Parses `claude -p --output-format stream-json --verbose --include-partial-messages` output stream.
+ * Supports real-time streaming with thinking, tool calls, and text deltas.
+ *
+ * Key insight: Tool input comes via input_json_delta events, need to accumulate them.
+ */
+/** ANSI escape code pattern */
+const ANSI_ESCAPE = /\x1b\[[0-9;]*m/g;
+/** Check if a parsed toolInput is empty (no meaningful content) */
+function isEmptyToolInput(input) {
+    if (input === undefined || input === null)
+        return true;
+    if (typeof input === 'object' && Object.keys(input).length === 0)
+        return true;
+    return false;
+}
+/**
+ * Parse Claude Code stdout stream into typed AIChunk objects
+ *
+ * Strategy:
+ * 1. Process lines as they arrive (true streaming)
+ * 2. Strip ANSI escape codes
+ * 3. Parse each line as JSON
+ * 4. Map to appropriate AIChunk types
+ * 5. Accumulate tool input from input_json_delta events
+ */
+export async function* parseClaudeOutput(stdout, logger) {
+    let buffer = '';
+    const state = {
+        toolInputBuffers: new Map(),
+        activeToolId: null,
+        activeToolName: null,
+        emittedToolIds: new Set(),
+    };
+    for await (const chunk of stdout) {
+        buffer += chunk.toString();
+        // Process complete lines
+        const lines = buffer.split('\n');
+        buffer = lines.pop() || '';
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            const chunks = parseLine(trimmed, logger, state);
+            for (const c of chunks) {
+                yield c;
+            }
+        }
+    }
+    // Process any remaining buffer
+    if (buffer.trim()) {
+        const cleanOutput = buffer.replace(ANSI_ESCAPE, '').trim();
+        const chunks = parseLine(cleanOutput, logger, state);
+        for (const c of chunks)
+            yield c;
+    }
+}
+function parseLine(line, logger, state) {
+    try {
+        const data = JSON.parse(line);
+        logger?.({ type: 'LINE_PARSED', timestamp: new Date().toISOString(), message: `Parsed ${data.type}` });
+        return mapToChunks(data, state);
+    }
+    catch {
+        logger?.({ type: 'PARSE_ERROR', timestamp: new Date().toISOString(), message: 'Failed to parse line', data: line.slice(0, 200) });
+        return [];
+    }
+}
+function mapToChunks(data, state) {
+    switch (data.type) {
+        case 'system':
+            if (data.subtype === 'init' && data.session_id) {
+                return [{ type: 'session_info', sessionId: data.session_id }];
+            }
+            return [];
+        case 'stream_event':
+            return handleStreamEvent(data, state);
+        case 'assistant':
+            // Process assistant message - it contains complete tool_use with full input
+            return handleAssistantMessage(data, state);
+        case 'user':
+            return handleUserMessage(data);
+        case 'result':
+            return handleResult(data);
+        default:
+            return [];
+    }
+}
+function handleStreamEvent(wrapper, state) {
+    const { event } = wrapper;
+    switch (event.type) {
+        case 'content_block_delta':
+            // Handle thinking and text deltas
+            if (event.delta?.type === 'thinking_delta' && event.delta.thinking) {
+                return [{ type: 'thinking', content: event.delta.thinking }];
+            }
+            if (event.delta?.type === 'text_delta' && event.delta.text) {
+                return [{ type: 'content', content: event.delta.text }];
+            }
+            // Handle tool input JSON delta - accumulate it
+            if (event.delta?.type === 'input_json_delta' && event.delta.partial_json) {
+                if (state.activeToolId) {
+                    const current = state.toolInputBuffers.get(state.activeToolId) || '';
+                    state.toolInputBuffers.set(state.activeToolId, current + event.delta.partial_json);
+                }
+                return []; // Don't emit until tool call is complete
+            }
+            return [];
+        case 'content_block_start':
+            if (event.content_block?.type === 'tool_use') {
+                const toolUseId = event.content_block.id || '';
+                const toolName = event.content_block.name || 'unknown';
+                // Set active tool for accumulation
+                state.activeToolId = toolUseId;
+                state.activeToolName = toolName;
+                // Initialize buffer if there's already input
+                if (event.content_block.input !== undefined) {
+                    state.toolInputBuffers.set(toolUseId, JSON.stringify(event.content_block.input));
+                }
+                else {
+                    state.toolInputBuffers.set(toolUseId, '');
+                }
+                // Don't emit tool_call yet - wait for content_block_stop with complete input
+                return [];
+            }
+            return [];
+        case 'content_block_stop':
+            // When content block stops, emit the complete tool input if we have one
+            if (state.activeToolId && event.index !== undefined) {
+                const accumulatedInput = state.toolInputBuffers.get(state.activeToolId);
+                if (accumulatedInput && state.activeToolName) {
+                    try {
+                        const parsedInput = JSON.parse(accumulatedInput);
+                        // Skip empty tool inputs (abandoned tool calls from Claude)
+                        if (isEmptyToolInput(parsedInput)) {
+                            state.activeToolId = null;
+                            state.activeToolName = null;
+                            return [];
+                        }
+                        const chunks = [{
+                                type: 'tool_call',
+                                toolUseId: state.activeToolId,
+                                toolName: state.activeToolName,
+                                toolInput: parsedInput,
+                            }];
+                        state.emittedToolIds.add(state.activeToolId);
+                        state.activeToolId = null;
+                        state.activeToolName = null;
+                        return chunks;
+                    }
+                    catch {
+                        // JSON not complete yet, keep state
+                    }
+                }
+                state.activeToolId = null;
+                state.activeToolName = null;
+            }
+            return [];
+        default:
+            return [];
+    }
+}
+function handleAssistantMessage(data, state) {
+    const chunks = [];
+    for (const block of data.message.content || []) {
+        if (block.type === 'thinking' && block.thinking) {
+            // Skip - already sent via thinking_delta
+        }
+        if (block.type === 'text' && block.text) {
+            // Skip - already sent via text_delta
+        }
+        if (block.type === 'tool_use') {
+            // Skip already-emitted tool calls (from content_block_stop)
+            const toolUseId = block.id || '';
+            if (state.emittedToolIds.has(toolUseId))
+                continue;
+            // Use the accumulated input if we have it, otherwise use the block's input
+            const accumulatedInput = state.toolInputBuffers.get(toolUseId);
+            let toolInput;
+            if (accumulatedInput) {
+                try {
+                    toolInput = JSON.parse(accumulatedInput);
+                }
+                catch {
+                    toolInput = block.input;
+                }
+            }
+            else {
+                toolInput = block.input;
+            }
+            // Skip empty tool inputs (abandoned tool calls from Claude)
+            if (isEmptyToolInput(toolInput))
+                continue;
+            chunks.push({
+                type: 'tool_call',
+                toolUseId,
+                toolName: block.name || 'unknown',
+                toolInput,
+            });
+        }
+    }
+    return chunks;
+}
+function handleUserMessage(data) {
+    const chunks = [];
+    for (const block of data.message.content) {
+        if (block.type === 'tool_result') {
+            chunks.push({
+                type: 'tool_result',
+                toolUseId: block.tool_use_id,
+                toolResult: block.content,
+            });
+        }
+    }
+    return chunks;
+}
+function handleResult(data) {
+    const chunks = [];
+    if (data.session_id) {
+        chunks.push({
+            type: 'session_info',
+            sessionId: data.session_id,
+            usage: extractStreamUsage(data.usage, data.modelUsage),
+        });
+    }
+    if (data.is_error) {
+        chunks.push({ type: 'error', error: data.result || 'Unknown error' });
+    }
+    chunks.push({ type: 'done' });
+    return chunks;
+}
+function extractStreamUsage(usage, modelUsage) {
+    // Prefer modelUsage — it carries contextWindow and cacheReadInputTokens
+    if (modelUsage) {
+        const firstKey = Object.keys(modelUsage)[0];
+        const entry = firstKey ? modelUsage[firstKey] : undefined;
+        if (entry) {
+            const cacheRead = entry.cacheReadInputTokens ?? 0;
+            return {
+                inputTokens: entry.inputTokens + cacheRead,
+                outputTokens: entry.outputTokens,
+                contextWindow: entry.contextWindow,
+            };
+        }
+    }
+    // Fallback to legacy usage — also has cache fields at top level
+    if (usage) {
+        const firstKey = Object.keys(usage)[0];
+        const entry = firstKey ? usage[firstKey] : undefined;
+        if (entry) {
+            // Top-level usage has cache_read_input_tokens but we can't access it here
+            // from the per-model entry; use raw inputTokens as-is
+            return {
+                inputTokens: entry.inputTokens,
+                outputTokens: entry.outputTokens,
+                contextWindow: 0,
+            };
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=output-parser.js.map

package/dist/backend/ai/output-parser.js.map

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

package/dist/backend/ai/session-manager.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Session Manager
+ *
+ * Manages AI sessions with lazy creation.
+ * Sessions are persisted to .loom/sessions/ as JSON files.
+ */
+import type { AIUsage } from '../../types/ai.js';
+import type { LoomPaths } from '../loom-paths.js';
+/** On-disk session record */
+export interface SessionRecord {
+    id: string;
+    claudeSessionId?: string;
+    title: string;
+    createdAt: string;
+    updatedAt: string;
+    messages: SessionMessage[];
+    usage?: AIUsage;
+}
+export interface ContentBlock {
+    type: 'thinking' | 'content' | 'tool_call';
+    thinking?: string;
+    content?: string;
+    tool?: string;
+    toolUseId?: string;
+    toolInput?: unknown;
+    result?: unknown;
+    status?: 'started' | 'completed' | 'error';
+    error?: string;
+}
+export interface SessionMessage {
+    id: string;
+    role: 'user' | 'assistant';
+    content: string;
+    timestamp: string;
+    files?: SessionFileRef[];
+    contentBlocks?: ContentBlock[];
+}
+export interface SessionFileRef {
+    uid: string;
+    name: string;
+    size: number;
+    type: string;
+    url?: string;
+}
+export declare class SessionManager {
+    private paths;
+    private defaultUserId;
+    /** In-memory session index for fast listing */
+    private sessionIndex;
+    /** Per-session mutex locks to prevent read-modify-write race conditions */
+    private locks;
+    constructor(paths: LoomPaths, defaultUserId?: string);
+    private get sessionsDir();
+    /**
+     * Acquire a per-key mutex lock. Prevents concurrent read-modify-write on the same session.
+     */
+    private withLock;
+    /**
+     * Ensure sessions directory exists and load index
+     */
+    initialize(): Promise<void>;
+    /**
+     * Create a new session on demand (lazy, no pre-allocation)
+     * Safe against race conditions: checks if session already exists before creating.
+     */
+    createSession(id?: string): Promise<SessionRecord>;
+    /**
+     * Read a session by ID
+     */
+    readSession(id: string): Promise<SessionRecord | null>;
+    /**
+     * Add messages to a session and update claudeSessionId
+     */
+    addMessages(id: string, messages: SessionMessage[], claudeSessionId?: string, usage?: AIUsage): Promise<SessionRecord>;
+    /**
+     * List all sessions sorted by most recent first (from index, O(1))
+     */
+    listSessions(): Promise<SessionRecord[]>;
+    /**
+     * List full session records from files (fallback, used during initialization)
+     */
+    private listSessionsFromFiles;
+    /**
+     * Delete a single message from a session
+     */
+    deleteMessage(sessionId: string, messageId: string): Promise<SessionRecord | null>;
+    /**
+     * Truncate all messages from a given message index onward (inclusive).
+     * Returns the updated session, or null if session not found.
+     */
+    truncateMessagesFromIndex(sessionId: string, fromIndex: number): Promise<SessionRecord | null>;
+    /**
+     * Delete a session
+     */
+    deleteSession(id: string): Promise<boolean>;
+    /**
+     * Get or create a session by ID
+     */
+    getOrCreate(id: string): Promise<SessionRecord>;
+    private getSessionPath;
+    private writeSessionFile;
+    private getIndexFilePath;
+    private loadIndex;
+    private saveIndex;
+}
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/backend/ai/session-manager.d.ts.map

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