@loom-framework/backend 0.1.0-alpha.1

package/dist/ai/engine.d.ts

@@ -0,0 +1,37 @@
+/**
+ * AI Engine - Core abstraction for AI communication
+ *
+ * ClaudeCodeEngine: spawns `claude -p --output-format json` processes
+ * with support for --resume, --model, and MCP config.
+ */
+import type { AIEngine, AICallOptions, AIChunk, ClaudeCodeConfig } from '@loom-framework/core';
+export interface ClaudeCodeEngineOptions {
+    config: ClaudeCodeConfig;
+    projectRoot: string;
+}
+/**
+ * ClaudeCodeEngine - Spawns Claude Code in headless mode
+ *
+ * Uses `claude -p --output-format json --mcp-config .loom/mcp.json`
+ * to invoke AI capabilities. Supports session resume and model selection.
+ */
+export declare class ClaudeCodeEngine implements AIEngine {
+    readonly name = "claude-code";
+    private config;
+    private projectRoot;
+    private activeProcesses;
+    constructor(options: ClaudeCodeEngineOptions);
+    /**
+     * Call Claude Code with a prompt and stream back AIChunk objects
+     */
+    call(prompt: string, options: AICallOptions): AsyncGenerator<AIChunk>;
+    /**
+     * Kill an active process by session ID
+     */
+    killSession(sessionId: string): boolean;
+    /**
+     * Kill all active processes (for graceful shutdown)
+     */
+    killAll(): void;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/ai/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/ai/engine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAM/F,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,QAAQ;IAC/C,QAAQ,CAAC,IAAI,iBAAiB;IAE9B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,eAAe,CAAwC;gBAEnD,OAAO,EAAE,uBAAuB;IAK5C;;OAEG;IACI,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,cAAc,CAAC,OAAO,CAAC;IAgG5E;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAUvC;;OAEG;IACH,OAAO,IAAI,IAAI;CAQhB"}

package/dist/ai/engine.js

@@ -0,0 +1,137 @@
+/**
+ * AI Engine - Core abstraction for AI communication
+ *
+ * ClaudeCodeEngine: spawns `claude -p --output-format json` processes
+ * with support for --resume, --model, and MCP config.
+ */
+import { spawn } from 'child_process';
+import path from 'path';
+import { parseClaudeOutput } from './output-parser.js';
+/** Default timeout for Claude Code processes (2 minutes) */
+const DEFAULT_PROCESS_TIMEOUT_MS = 120_000;
+/**
+ * ClaudeCodeEngine - Spawns Claude Code in headless mode
+ *
+ * Uses `claude -p --output-format json --mcp-config .loom/mcp.json`
+ * to invoke AI capabilities. Supports session resume and model selection.
+ */
+export class ClaudeCodeEngine {
+    name = 'claude-code';
+    config;
+    projectRoot;
+    activeProcesses = new Map();
+    constructor(options) {
+        this.config = options.config;
+        this.projectRoot = options.projectRoot;
+    }
+    /**
+     * Call Claude Code with a prompt and stream back AIChunk objects
+     */
+    async *call(prompt, options) {
+        const claudePath = this.config.path || process.env.CLAUDE_CODE_PATH || 'claude';
+        const timeout = options.timeout ?? this.config.timeout ?? DEFAULT_PROCESS_TIMEOUT_MS;
+        const pluginRoot = this.config.pluginRoot || path.join(this.projectRoot, '.claude');
+        const mcpConfigPath = path.join(this.projectRoot, '.loom', 'mcp.json');
+        const args = [
+            '-p',
+            '--output-format', 'json',
+            '--mcp-config', mcpConfigPath,
+        ];
+        if (this.config.skipPermissions !== false) {
+            args.push('--dangerously-skip-permissions');
+        }
+        if (options.model || this.config.defaultModel) {
+            args.push('--model', options.model || this.config.defaultModel);
+        }
+        if (options.resumeSessionId) {
+            args.push('--resume', options.resumeSessionId);
+        }
+        // Read prompt from stdin to avoid ARG_MAX
+        args.push('-');
+        const childProcess = spawn(claudePath, args, {
+            cwd: this.projectRoot,
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env: {
+                ...process.env,
+                CLAUDE_PLUGIN_ROOT: pluginRoot,
+            },
+        });
+        // Track active process for cleanup
+        this.activeProcesses.set(options.sessionId, childProcess);
+        // Send prompt via stdin then close
+        childProcess.stdin.write(prompt);
+        childProcess.stdin.end();
+        // Parse output stream
+        try {
+            for await (const chunk of parseClaudeOutput(childProcess.stdout)) {
+                // For result-type content chunks that carry sessionId, split into two chunks
+                if (chunk.type === 'content' && chunk.sessionId) {
+                    const { sessionId, usage, ...contentChunk } = chunk;
+                    yield contentChunk;
+                    if (sessionId) {
+                        yield {
+                            type: 'session_info',
+                            sessionId,
+                            usage,
+                        };
+                    }
+                }
+                else {
+                    yield chunk;
+                }
+            }
+        }
+        catch (error) {
+            yield {
+                type: 'error',
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+        // Wait for process completion with timeout
+        await new Promise((resolve, reject) => {
+            const timeoutHandle = setTimeout(() => {
+                childProcess.kill('SIGTERM');
+                // Force kill after 5s
+                setTimeout(() => {
+                    childProcess.kill('SIGKILL');
+                }, 5_000);
+                reject(new Error(`Claude Code process timed out after ${timeout}ms`));
+            }, timeout);
+            childProcess.on('close', () => {
+                clearTimeout(timeoutHandle);
+                this.activeProcesses.delete(options.sessionId);
+                resolve();
+            });
+            childProcess.on('error', (err) => {
+                clearTimeout(timeoutHandle);
+                this.activeProcesses.delete(options.sessionId);
+                reject(err);
+            });
+        });
+        yield { type: 'done' };
+    }
+    /**
+     * Kill an active process by session ID
+     */
+    killSession(sessionId) {
+        const proc = this.activeProcesses.get(sessionId);
+        if (proc && !proc.killed) {
+            proc.kill('SIGTERM');
+            this.activeProcesses.delete(sessionId);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Kill all active processes (for graceful shutdown)
+     */
+    killAll() {
+        for (const [sessionId, proc] of this.activeProcesses) {
+            if (!proc.killed) {
+                proc.kill('SIGTERM');
+            }
+            this.activeProcesses.delete(sessionId);
+        }
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/ai/engine.js.map

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

package/dist/ai/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * AI Module - Barrel Export
+ */
+export { ClaudeCodeEngine } from './engine.js';
+export type { ClaudeCodeEngineOptions } from './engine.js';
+export { SessionManager } from './session-manager.js';
+export type { SessionRecord, SessionMessage, SessionFileRef } from './session-manager.js';
+export { parseClaudeOutput } from './output-parser.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/ai/index.js

@@ -0,0 +1,7 @@
+/**
+ * AI Module - Barrel Export
+ */
+export { ClaudeCodeEngine } from './engine.js';
+export { SessionManager } from './session-manager.js';
+export { parseClaudeOutput } from './output-parser.js';
+//# sourceMappingURL=index.js.map

package/dist/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/ai/output-parser.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Claude Code Output Parser
+ *
+ * Parses `claude -p --output-format json` output stream into AIChunk objects.
+ * Handles both newline-delimited JSON (streaming) and single JSON object (batch) modes.
+ */
+import type { AIChunk } from '@loom-framework/core';
+/**
+ * Parse Claude Code stdout stream into typed AIChunk objects
+ *
+ * Strategy:
+ * 1. Collect all stdout into a buffer
+ * 2. Strip ANSI escape codes
+ * 3. Try parsing as newline-delimited JSON lines first
+ * 4. Fall back to parsing the entire buffer as a single JSON object
+ * 5. Ultimate fallback: yield raw text as content chunk
+ */
+export declare function parseClaudeOutput(stdout: NodeJS.ReadableStream): AsyncGenerator<AIChunk>;
+//# sourceMappingURL=output-parser.d.ts.map

package/dist/ai/output-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-parser.d.ts","sourceRoot":"","sources":["../../src/ai/output-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAW,MAAM,sBAAsB,CAAC;AA6B7D;;;;;;;;;GASG;AACH,wBAAuB,iBAAiB,CACtC,MAAM,EAAE,MAAM,CAAC,cAAc,GAC5B,cAAc,CAAC,OAAO,CAAC,CAiCzB"}

package/dist/ai/output-parser.js

@@ -0,0 +1,154 @@
+/**
+ * Claude Code Output Parser
+ *
+ * Parses `claude -p --output-format json` output stream into AIChunk objects.
+ * Handles both newline-delimited JSON (streaming) and single JSON object (batch) modes.
+ */
+/** ANSI escape code pattern */
+const ANSI_ESCAPE = /\x1b\[[0-9;]*m/g;
+/**
+ * Parse Claude Code stdout stream into typed AIChunk objects
+ *
+ * Strategy:
+ * 1. Collect all stdout into a buffer
+ * 2. Strip ANSI escape codes
+ * 3. Try parsing as newline-delimited JSON lines first
+ * 4. Fall back to parsing the entire buffer as a single JSON object
+ * 5. Ultimate fallback: yield raw text as content chunk
+ */
+export async function* parseClaudeOutput(stdout) {
+    let buffer = '';
+    for await (const chunk of stdout) {
+        buffer += chunk.toString();
+    }
+    const cleanOutput = buffer.replace(ANSI_ESCAPE, '').trim();
+    if (!cleanOutput)
+        return;
+    // Strategy 1: Try newline-delimited JSON
+    const lines = cleanOutput.split('\n').map((l) => l.trim()).filter(Boolean);
+    const parsedChunks = tryParseJsonLines(lines);
+    if (parsedChunks.length > 0) {
+        for (const chunk of parsedChunks) {
+            yield chunk;
+        }
+        return;
+    }
+    // Strategy 2: Try single JSON object
+    const singleChunk = tryParseSingleJson(cleanOutput);
+    if (singleChunk) {
+        yield singleChunk;
+        return;
+    }
+    // Strategy 3: Raw text fallback
+    yield {
+        type: 'content',
+        content: cleanOutput,
+    };
+}
+/**
+ * Attempt to parse multiple JSON lines into AIChunk objects
+ */
+function tryParseJsonLines(lines) {
+    const chunks = [];
+    let hasValidJson = false;
+    for (const line of lines) {
+        try {
+            const data = JSON.parse(line);
+            hasValidJson = true;
+            const chunk = mapJsonToChunk(data);
+            if (chunk)
+                chunks.push(chunk);
+        }
+        catch {
+            // Not valid JSON on this line, skip
+        }
+    }
+    return hasValidJson ? chunks : [];
+}
+/**
+ * Attempt to parse the entire output as a single JSON object
+ */
+function tryParseSingleJson(output) {
+    try {
+        const data = JSON.parse(output);
+        return mapJsonToChunk(data);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Map a parsed JSON object to an AIChunk
+ */
+function mapJsonToChunk(data) {
+    switch (data.type) {
+        case 'result': {
+            if (data.is_error) {
+                return {
+                    type: 'error',
+                    error: data.result || 'Unknown error from Claude Code',
+                };
+            }
+            // For single-result mode, emit content + session_info together
+            // The caller (engine) will handle splitting them
+            if (data.result) {
+                return {
+                    type: 'content',
+                    content: data.result,
+                    sessionId: data.session_id,
+                    usage: extractUsage(data),
+                };
+            }
+            // No content but has session info
+            return extractSessionInfo(data);
+        }
+        case 'assistant': {
+            if (data.subtype === 'text' && data.content) {
+                return { type: 'content', content: data.content };
+            }
+            return null;
+        }
+        default:
+            return null;
+    }
+}
+/**
+ * Extract session metadata from a result object
+ */
+function extractSessionInfo(data) {
+    if (!data.session_id)
+        return null;
+    const usage = extractUsage(data);
+    return {
+        type: 'session_info',
+        sessionId: data.session_id,
+        usage,
+    };
+}
+/**
+ * Extract usage info, dynamically handling any model name key
+ */
+function extractUsage(data) {
+    // Try modelUsage first (dynamic keys)
+    if (data.modelUsage) {
+        const firstKey = Object.keys(data.modelUsage)[0];
+        const modelUsage = firstKey ? data.modelUsage[firstKey] : undefined;
+        if (modelUsage) {
+            return {
+                inputTokens: modelUsage.inputTokens,
+                outputTokens: modelUsage.outputTokens,
+                contextWindow: modelUsage.contextWindow,
+            };
+        }
+    }
+    // Fallback to top-level usage
+    if (data.usage) {
+        return {
+            inputTokens: data.usage.input_tokens,
+            outputTokens: data.usage.output_tokens,
+            contextWindow: 0,
+        };
+    }
+    return undefined;
+}
+//# sourceMappingURL=output-parser.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"output-parser.js","sourceRoot":"","sources":["../../src/ai/output-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4BH,+BAA+B;AAC/B,MAAM,WAAW,GAAG,iBAAiB,CAAC;AAEtC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,iBAAiB,CACtC,MAA6B;IAE7B,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC7B,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3D,IAAI,CAAC,WAAW;QAAE,OAAO;IAEzB,yCAAyC;IACzC,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3E,MAAM,YAAY,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAE9C,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;YACjC,MAAM,KAAK,CAAC;QACd,CAAC;QACD,OAAO;IACT,CAAC;IAED,qCAAqC;IACrC,MAAM,WAAW,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACpD,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,WAAW,CAAC;QAClB,OAAO;IACT,CAAC;IAED,gCAAgC;IAChC,MAAM;QACJ,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,WAAW;KACrB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,KAAe;IACxC,MAAM,MAAM,GAAc,EAAE,CAAC;IAC7B,IAAI,YAAY,GAAG,KAAK,CAAC;IAEzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAqB,CAAC;YAClD,YAAY,GAAG,IAAI,CAAC;YACpB,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,KAAK;gBAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,oCAAoC;QACtC,CAAC;IACH,CAAC;IAED,OAAO,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,MAAc;IACxC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAqB,CAAC;QACpD,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,IAAsB;IAC5C,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,OAAO;oBACL,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,IAAI,CAAC,MAAM,IAAI,gCAAgC;iBACvD,CAAC;YACJ,CAAC;YAED,+DAA+D;YAC/D,iDAAiD;YACjD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,OAAO;oBACL,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,IAAI,CAAC,MAAM;oBACpB,SAAS,EAAE,IAAI,CAAC,UAAU;oBAC1B,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC;iBAC1B,CAAC;YACJ,CAAC;YAED,kCAAkC;YAClC,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;QAED,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,IAAI,IAAI,CAAC,OAAO,KAAK,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBAC5C,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;YACpD,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,IAAsB;IAChD,IAAI,CAAC,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAElC,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,SAAS,EAAE,IAAI,CAAC,UAAU;QAC1B,KAAK;KACN,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,IAAsB;IAC1C,sCAAsC;IACtC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACpE,IAAI,UAAU,EAAE,CAAC;YACf,OAAO;gBACL,WAAW,EAAE,UAAU,CAAC,WAAW;gBACnC,YAAY,EAAE,UAAU,CAAC,YAAY;gBACrC,aAAa,EAAE,UAAU,CAAC,aAAa;aACxC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY;YACpC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa;YACtC,aAAa,EAAE,CAAC;SACjB,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

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

@@ -0,0 +1,81 @@
+/**
+ * Session Manager
+ *
+ * Manages AI sessions with lazy creation and 30-minute stale cleanup.
+ * Sessions are persisted to .loom/sessions/ as JSON files.
+ */
+import type { AIUsage } from '@loom-framework/core';
+/** On-disk session record */
+export interface SessionRecord {
+    id: string;
+    claudeSessionId?: string;
+    title: string;
+    createdAt: string;
+    updatedAt: string;
+    messages: SessionMessage[];
+    usage?: AIUsage;
+}
+export interface SessionMessage {
+    id: string;
+    role: 'user' | 'assistant';
+    content: string;
+    timestamp: string;
+    files?: SessionFileRef[];
+}
+export interface SessionFileRef {
+    uid: string;
+    name: string;
+    size: number;
+    type: string;
+    url?: string;
+}
+export declare class SessionManager {
+    private sessionsDir;
+    /** In-memory index of active sessions for stale detection */
+    private activeIndex;
+    private cleanupTimer?;
+    constructor(projectRoot: string);
+    /**
+     * Ensure sessions directory exists
+     */
+    initialize(): Promise<void>;
+    /**
+     * Start the stale session cleanup timer
+     */
+    startCleanup(intervalMs?: number): void;
+    /**
+     * Stop the cleanup timer
+     */
+    stopCleanup(): void;
+    /**
+     * Create a new session on demand (lazy, no pre-allocation)
+     */
+    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
+     */
+    listSessions(): Promise<SessionRecord[]>;
+    /**
+     * Delete a session
+     */
+    deleteSession(id: string): Promise<boolean>;
+    /**
+     * Get or create a session by ID
+     */
+    getOrCreate(id: string): Promise<SessionRecord>;
+    /**
+     * Clean up stale sessions from the active index
+     */
+    private cleanStaleSessions;
+    private getSessionPath;
+    private writeSessionFile;
+}
+//# sourceMappingURL=session-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../src/ai/session-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAiB,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAKnE,6BAA6B;AAC7B,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,6DAA6D;IAC7D,OAAO,CAAC,WAAW,CAAyC;IAC5D,OAAO,CAAC,YAAY,CAAC,CAAiC;gBAE1C,WAAW,EAAE,MAAM;IAI/B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAejC;;OAEG;IACH,YAAY,CAAC,UAAU,GAAE,MAAe,GAAG,IAAI;IAM/C;;OAEG;IACH,WAAW,IAAI,IAAI;IAOnB;;OAEG;IACG,aAAa,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAsBxD;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAU5D;;OAEG;IACG,WAAW,CACf,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,cAAc,EAAE,EAC1B,eAAe,CAAC,EAAE,MAAM,EACxB,KAAK,CAAC,EAAE,OAAO,GACd,OAAO,CAAC,aAAa,CAAC;IAqCzB;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IA2B9C;;OAEG;IACG,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWjD;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAMrD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,cAAc;YAIR,gBAAgB;CAK/B"}

package/dist/ai/session-manager.js

@@ -0,0 +1,193 @@
+/**
+ * Session Manager
+ *
+ * Manages AI sessions with lazy creation and 30-minute stale cleanup.
+ * Sessions are persisted to .loom/sessions/ as JSON files.
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+/** Stale session threshold: 30 minutes */
+const STALE_SESSION_MS = 30 * 60 * 1000;
+export class SessionManager {
+    sessionsDir;
+    /** In-memory index of active sessions for stale detection */
+    activeIndex = new Map();
+    cleanupTimer;
+    constructor(projectRoot) {
+        this.sessionsDir = path.join(projectRoot, '.loom', 'sessions');
+    }
+    /**
+     * Ensure sessions directory exists
+     */
+    async initialize() {
+        await fs.mkdir(this.sessionsDir, { recursive: true });
+        // Load existing sessions into active index
+        const sessions = await this.listSessions();
+        const now = Date.now();
+        for (const session of sessions) {
+            this.activeIndex.set(session.id, {
+                id: session.id,
+                claudeSessionId: session.claudeSessionId,
+                lastActivity: new Date(session.updatedAt).getTime(),
+                createdAt: new Date(session.createdAt).getTime(),
+            });
+        }
+    }
+    /**
+     * Start the stale session cleanup timer
+     */
+    startCleanup(intervalMs = 60_000) {
+        this.cleanupTimer = setInterval(() => {
+            this.cleanStaleSessions();
+        }, intervalMs);
+    }
+    /**
+     * Stop the cleanup timer
+     */
+    stopCleanup() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = undefined;
+        }
+    }
+    /**
+     * Create a new session on demand (lazy, no pre-allocation)
+     */
+    async createSession(id) {
+        const sessionId = id || generateSessionId();
+        const now = new Date().toISOString();
+        const session = {
+            id: sessionId,
+            title: 'New Session',
+            createdAt: now,
+            updatedAt: now,
+            messages: [],
+        };
+        await this.writeSessionFile(session);
+        this.activeIndex.set(sessionId, {
+            id: sessionId,
+            lastActivity: Date.now(),
+            createdAt: Date.now(),
+        });
+        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) {
+        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);
+        // Update active index
+        this.activeIndex.set(id, {
+            id,
+            claudeSessionId: session.claudeSessionId,
+            lastActivity: Date.now(),
+            createdAt: new Date(session.createdAt).getTime(),
+        });
+        return session;
+    }
+    /**
+     * List all sessions sorted by most recent first
+     */
+    async listSessions() {
+        try {
+            const files = await fs.readdir(this.sessionsDir);
+            const sessions = [];
+            for (const file of files) {
+                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
+                }
+            }
+            // Sort by updatedAt descending
+            sessions.sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
+            return sessions;
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Delete a session
+     */
+    async deleteSession(id) {
+        const filePath = this.getSessionPath(id);
+        try {
+            await fs.unlink(filePath);
+            this.activeIndex.delete(id);
+            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);
+    }
+    /**
+     * Clean up stale sessions from the active index
+     */
+    cleanStaleSessions() {
+        const now = Date.now();
+        for (const [id, session] of this.activeIndex) {
+            if (now - session.lastActivity > STALE_SESSION_MS) {
+                this.activeIndex.delete(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');
+    }
+}
+function generateSessionId() {
+    return `session_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;
+}
+//# sourceMappingURL=session-manager.js.map