@loom-framework/core 0.1.0-alpha.9 → 0.1.0-alpha.91

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

@@ -0,0 +1,247 @@
+/**
+ * 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),
+        });
+    }
+    if (data.is_error) {
+        chunks.push({ type: 'error', error: data.result || 'Unknown error' });
+    }
+    chunks.push({ type: 'done' });
+    return chunks;
+}
+function extractStreamUsage(usage) {
+    if (!usage)
+        return undefined;
+    const firstKey = Object.keys(usage)[0];
+    const modelUsage = firstKey ? usage[firstKey] : undefined;
+    if (!modelUsage)
+        return undefined;
+    return {
+        inputTokens: modelUsage.inputTokens,
+        outputTokens: modelUsage.outputTokens,
+        contextWindow: 0,
+    };
+}
+//# 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,103 @@
+/**
+ * Session Manager
+ *
+ * Manages AI sessions with lazy creation.
+ * Sessions are persisted to .loom/sessions/ as JSON files.
+ */
+import type { AIUsage } from '../../index.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 sessionsDir;
+    /** In-memory session index for fast listing */
+    private sessionIndex;
+    /** Per-session mutex locks to prevent read-modify-write race conditions */
+    private locks;
+    constructor(projectRoot: string);
+    /**
+     * 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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"}

package/dist/backend/ai/session-manager.js

@@ -0,0 +1,298 @@
+/**
+ * Session Manager
+ *
+ * Manages AI sessions with lazy creation.
+ * Sessions are persisted to .loom/sessions/ as JSON files.
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+export class SessionManager {
+    sessionsDir;
+    /** In-memory session index for fast listing */
+    sessionIndex = { sessions: [], lastUpdated: '' };
+    /** Per-session mutex locks to prevent read-modify-write race conditions */
+    locks = new Map();
+    constructor(projectRoot) {
+        this.sessionsDir = path.join(projectRoot, '.loom', 'sessions');
+    }
+    /**
+     * Acquire a per-key mutex lock. Prevents concurrent read-modify-write on the same session.
+     */
+    async withLock(key, fn) {
+        // Wait for any existing lock to release
+        while (this.locks.has(key)) {
+            await this.locks.get(key);
+        }
+        // Acquire lock
+        let resolve;
+        const promise = new Promise((r) => { resolve = r; });
+        this.locks.set(key, promise);
+        try {
+            return await fn();
+        }
+        finally {
+            this.locks.delete(key);
+            resolve();
+        }
+    }
+    /**
+     * Ensure sessions directory exists and load index
+     */
+    async initialize() {
+        await fs.mkdir(this.sessionsDir, { recursive: true });
+        // Try to load index from disk
+        const indexLoaded = await this.loadIndex();
+        if (!indexLoaded) {
+            // Fallback: rebuild index from session files
+            const sessions = await this.listSessionsFromFiles();
+            this.sessionIndex = {
+                sessions: sessions.map((s) => ({
+                    id: s.id,
+                    title: s.title,
+                    updatedAt: s.updatedAt,
+                    createdAt: s.createdAt,
+                })),
+                lastUpdated: new Date().toISOString(),
+            };
+            await this.saveIndex();
+        }
+    }
+    /**
+     * Create a new session on demand (lazy, no pre-allocation)
+     * Safe against race conditions: checks if session already exists before creating.
+     */
+    async createSession(id) {
+        const sessionId = id || generateSessionId();
+        return this.withLock(sessionId, async () => {
+            // Check if session already exists (handles getOrCreate race condition)
+            const existing = await this.readSession(sessionId);
+            if (existing)
+                return existing;
+            const now = new Date().toISOString();
+            const session = {
+                id: sessionId,
+                title: 'New Session',
+                createdAt: now,
+                updatedAt: now,
+                messages: [],
+            };
+            await this.writeSessionFile(session);
+            // Update index (avoid duplicates)
+            if (!this.sessionIndex.sessions.some(e => e.id === sessionId)) {
+                this.sessionIndex.sessions.push({
+                    id: sessionId,
+                    title: session.title,
+                    updatedAt: session.updatedAt,
+                    createdAt: session.createdAt,
+                });
+                this.sessionIndex.lastUpdated = new Date().toISOString();
+                await this.saveIndex();
+            }
+            return session;
+        });
+    }
+    /**
+     * Read a session by ID
+     */
+    async readSession(id) {
+        const filePath = this.getSessionPath(id);
+        try {
+            const content = await fs.readFile(filePath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Add messages to a session and update claudeSessionId
+     */
+    async addMessages(id, messages, claudeSessionId, usage) {
+        return this.withLock(id, async () => {
+            const session = await this.readSession(id);
+            if (!session) {
+                throw new Error(`Session not found: ${id}`);
+            }
+            session.messages.push(...messages);
+            session.updatedAt = new Date().toISOString();
+            if (claudeSessionId) {
+                session.claudeSessionId = claudeSessionId;
+            }
+            if (usage) {
+                session.usage = usage;
+            }
+            // Auto-title from first user message
+            if (session.title === 'New Session' && session.messages.length > 0) {
+                const firstUser = session.messages.find((m) => m.role === 'user');
+                if (firstUser) {
+                    session.title = firstUser.content.slice(0, 80) + (firstUser.content.length > 80 ? '...' : '');
+                }
+            }
+            await this.writeSessionFile(session);
+            // Sync index entry (title may have changed)
+            const idxEntry = this.sessionIndex.sessions.find((e) => e.id === id);
+            if (idxEntry) {
+                idxEntry.title = session.title;
+                idxEntry.updatedAt = session.updatedAt;
+            }
+            this.sessionIndex.lastUpdated = new Date().toISOString();
+            await this.saveIndex();
+            return session;
+        });
+    }
+    /**
+     * List all sessions sorted by most recent first (from index, O(1))
+     */
+    async listSessions() {
+        // Use index for fast path: only return summary data
+        // For full records, callers should use readSession(id)
+        const entries = [...this.sessionIndex.sessions];
+        entries.sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
+        // Map index entries to minimal SessionRecord shape
+        return entries.map((e) => ({
+            id: e.id,
+            title: e.title,
+            createdAt: e.createdAt,
+            updatedAt: e.updatedAt,
+            messages: [],
+        }));
+    }
+    /**
+     * List full session records from files (fallback, used during initialization)
+     */
+    async listSessionsFromFiles() {
+        try {
+            const files = await fs.readdir(this.sessionsDir);
+            const sessions = [];
+            for (const file of files) {
+                if (file === 'index.json')
+                    continue;
+                if (!file.endsWith('.json'))
+                    continue;
+                const filePath = path.join(this.sessionsDir, file);
+                try {
+                    const content = await fs.readFile(filePath, 'utf-8');
+                    sessions.push(JSON.parse(content));
+                }
+                catch {
+                    // Skip malformed files
+                }
+            }
+            sessions.sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
+            return sessions;
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Delete a single message from a session
+     */
+    async deleteMessage(sessionId, messageId) {
+        return this.withLock(sessionId, async () => {
+            const session = await this.readSession(sessionId);
+            if (!session)
+                return null;
+            const originalLen = session.messages.length;
+            session.messages = session.messages.filter((m) => m.id !== messageId);
+            if (session.messages.length === originalLen)
+                return null; // message not found
+            session.updatedAt = new Date().toISOString();
+            await this.writeSessionFile(session);
+            // Sync index
+            const idxEntry = this.sessionIndex.sessions.find((e) => e.id === sessionId);
+            if (idxEntry) {
+                idxEntry.updatedAt = session.updatedAt;
+            }
+            this.sessionIndex.lastUpdated = new Date().toISOString();
+            await this.saveIndex();
+            return session;
+        });
+    }
+    /**
+     * Truncate all messages from a given message index onward (inclusive).
+     * Returns the updated session, or null if session not found.
+     */
+    async truncateMessagesFromIndex(sessionId, fromIndex) {
+        return this.withLock(sessionId, async () => {
+            const session = await this.readSession(sessionId);
+            if (!session)
+                return null;
+            if (fromIndex < 0 || fromIndex >= session.messages.length)
+                return null;
+            session.messages = session.messages.slice(0, fromIndex);
+            session.updatedAt = new Date().toISOString();
+            await this.writeSessionFile(session);
+            // Sync index
+            const idxEntry = this.sessionIndex.sessions.find((e) => e.id === sessionId);
+            if (idxEntry) {
+                idxEntry.updatedAt = session.updatedAt;
+            }
+            this.sessionIndex.lastUpdated = new Date().toISOString();
+            await this.saveIndex();
+            return session;
+        });
+    }
+    /**
+     * Delete a session
+     */
+    async deleteSession(id) {
+        return this.withLock(id, async () => {
+            const filePath = this.getSessionPath(id);
+            try {
+                await fs.unlink(filePath);
+                // Sync index
+                this.sessionIndex.sessions = this.sessionIndex.sessions.filter((e) => e.id !== id);
+                this.sessionIndex.lastUpdated = new Date().toISOString();
+                await this.saveIndex();
+                return true;
+            }
+            catch {
+                return false;
+            }
+        });
+    }
+    /**
+     * Get or create a session by ID
+     */
+    async getOrCreate(id) {
+        const existing = await this.readSession(id);
+        if (existing)
+            return existing;
+        return this.createSession(id);
+    }
+    getSessionPath(id) {
+        return path.join(this.sessionsDir, `${id}.json`);
+    }
+    async writeSessionFile(session) {
+        const filePath = this.getSessionPath(session.id);
+        await fs.mkdir(this.sessionsDir, { recursive: true });
+        await fs.writeFile(filePath, JSON.stringify(session, null, 2), 'utf-8');
+    }
+    getIndexFilePath() {
+        return path.join(this.sessionsDir, 'index.json');
+    }
+    async loadIndex() {
+        try {
+            const content = await fs.readFile(this.getIndexFilePath(), 'utf-8');
+            this.sessionIndex = JSON.parse(content);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async saveIndex() {
+        try {
+            await fs.mkdir(this.sessionsDir, { recursive: true });
+            await fs.writeFile(this.getIndexFilePath(), JSON.stringify(this.sessionIndex, null, 2), 'utf-8');
+        }
+        catch {
+            // Non-critical: index is in-memory, will rebuild on next init
+        }
+    }
+}
+function generateSessionId() {
+    return `session_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;
+}
+//# sourceMappingURL=session-manager.js.map