@loom-framework/core 0.1.0-alpha.6 → 0.1.0-alpha.61

package/dist/backend/index.js.map

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

package/dist/backend/observe/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Observability module - AI interaction logging and metrics
+ */
+export { AIInteractionLogger, parseDuration } from './logger.js';
+export type { AIInteractionLog, LogFilter } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/observe/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/backend/observe/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjE,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/backend/observe/index.js

@@ -0,0 +1,5 @@
+/**
+ * Observability module - AI interaction logging and metrics
+ */
+export { AIInteractionLogger, parseDuration } from './logger.js';
+//# sourceMappingURL=index.js.map

package/dist/backend/observe/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/backend/observe/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/backend/observe/logger.d.ts

@@ -0,0 +1,28 @@
+/**
+ * AIInteractionLogger
+ *
+ * Records each AI interaction to .loom/logs/ as JSON files.
+ * Each interaction is stored as a separate file: .loom/logs/{messageId}.json
+ */
+import type { AIInteractionLog, LogFilter } from './types.js';
+export declare class AIInteractionLogger {
+    private logsDir;
+    constructor(projectRoot: string);
+    /**
+     * Ensure logs directory exists
+     */
+    initialize(): Promise<void>;
+    /**
+     * Record an AI interaction log
+     */
+    log(entry: AIInteractionLog): Promise<void>;
+    /**
+     * Read all logs, optionally filtered
+     */
+    readLogs(filter?: LogFilter): Promise<AIInteractionLog[]>;
+}
+/**
+ * Parse a duration string like '1h', '30m', '7d' into milliseconds
+ */
+export declare function parseDuration(duration: string): number;
+//# sourceMappingURL=logger.d.ts.map

package/dist/backend/observe/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/backend/observe/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE9D,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAAS;gBAEZ,WAAW,EAAE,MAAM;IAI/B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;OAEG;IACG,GAAG,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjD;;OAEG;IACG,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAgChE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAgBtD"}

package/dist/backend/observe/logger.js

@@ -0,0 +1,80 @@
+/**
+ * AIInteractionLogger
+ *
+ * Records each AI interaction to .loom/logs/ as JSON files.
+ * Each interaction is stored as a separate file: .loom/logs/{messageId}.json
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+export class AIInteractionLogger {
+    logsDir;
+    constructor(projectRoot) {
+        this.logsDir = path.join(projectRoot, '.loom', 'logs');
+    }
+    /**
+     * Ensure logs directory exists
+     */
+    async initialize() {
+        await fs.mkdir(this.logsDir, { recursive: true });
+    }
+    /**
+     * Record an AI interaction log
+     */
+    async log(entry) {
+        const filePath = path.join(this.logsDir, `${entry.messageId}.json`);
+        await fs.writeFile(filePath, JSON.stringify(entry, null, 2), 'utf-8');
+    }
+    /**
+     * Read all logs, optionally filtered
+     */
+    async readLogs(filter) {
+        try {
+            const files = await fs.readdir(this.logsDir);
+            const logs = [];
+            for (const file of files) {
+                if (!file.endsWith('.json'))
+                    continue;
+                try {
+                    const content = await fs.readFile(path.join(this.logsDir, file), 'utf-8');
+                    const entry = JSON.parse(content);
+                    if (filter?.session && entry.sessionId !== filter.session)
+                        continue;
+                    if (filter?.last) {
+                        const cutoff = Date.now() - parseDuration(filter.last);
+                        if (new Date(entry.timestamp).getTime() < cutoff)
+                            continue;
+                    }
+                    logs.push(entry);
+                }
+                catch {
+                    // Skip malformed files
+                }
+            }
+            // Sort by timestamp descending (most recent first)
+            logs.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+            return logs;
+        }
+        catch {
+            return [];
+        }
+    }
+}
+/**
+ * Parse a duration string like '1h', '30m', '7d' into milliseconds
+ */
+export function parseDuration(duration) {
+    const match = duration.match(/^(\d+)(s|m|h|d)$/);
+    if (!match) {
+        throw new Error(`Invalid duration format: ${duration}. Use format like '1h', '30m', '7d'`);
+    }
+    const value = parseInt(match[1], 10);
+    const unit = match[2];
+    switch (unit) {
+        case 's': return value * 1000;
+        case 'm': return value * 60 * 1000;
+        case 'h': return value * 60 * 60 * 1000;
+        case 'd': return value * 24 * 60 * 60 * 1000;
+        default: throw new Error(`Unknown duration unit: ${unit}`);
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/backend/observe/logger.js.map

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

package/dist/backend/observe/types.d.ts

@@ -0,0 +1,26 @@
+/**
+ * AI Interaction Log Types
+ *
+ * Defines the structure for observability logging of AI interactions.
+ */
+export interface AIInteractionLog {
+    sessionId: string;
+    messageId: string;
+    timestamp: string;
+    prompt: string;
+    response: string;
+    duration: number;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    mcpCalls: string[];
+    cliCalls: string[];
+    error?: string;
+}
+export interface LogFilter {
+    session?: string;
+    /** Duration string like '1h', '30m', '7d' */
+    last?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/backend/observe/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/backend/observe/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/backend/observe/types.js

@@ -0,0 +1,7 @@
+/**
+ * AI Interaction Log Types
+ *
+ * Defines the structure for observability logging of AI interactions.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/backend/observe/types.js.map

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

package/dist/backend/routes/chat.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Chat SSE Route - HTTP Server-Sent Events streaming for AI chat
+ *
+ * Replaces WebSocket with HTTP SSE for AI conversation streaming.
+ * Ant Design X (useXChat + XRequest) natively consumes this format.
+ *
+ * POST /api/v1/chat
+ *   Body: { content, session_id, button_id?, context?, files? }
+ *   Response: SSE stream with data lines containing JSON chunks
+ *
+ * GET /api/v1/sessions - List sessions
+ * POST /api/v1/sessions - Create session
+ * GET /api/v1/sessions/:id - Load session
+ * DELETE /api/v1/sessions/:id - Delete session
+ */
+import type { FastifyInstance } from 'fastify';
+import type { AIEngine, LoomConfig } from '../../index.js';
+import { SessionManager } from '../ai/session-manager.js';
+import { AIInteractionLogger } from '../observe/index.js';
+export interface ChatRouteOptions {
+    engine: AIEngine;
+    sessionManager: SessionManager;
+    config: LoomConfig;
+    logger?: AIInteractionLogger;
+    projectRoot: string;
+}
+/**
+ * Register chat SSE route and session REST routes
+ */
+export declare function registerChatRoutes(fastify: FastifyInstance, options: ChatRouteOptions): void;
+//# sourceMappingURL=chat.d.ts.map

package/dist/backend/routes/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../../src/backend/routes/chat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAC7E,OAAO,KAAK,EAAE,QAAQ,EAAW,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEpE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAoC1D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,QAAQ,CAAC;IACjB,cAAc,EAAE,cAAc,CAAC;IAC/B,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB;AA0HD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,gBAAgB,GACxB,IAAI,CAwRN"}

package/dist/backend/routes/chat.js

@@ -0,0 +1,426 @@
+/**
+ * Chat SSE Route - HTTP Server-Sent Events streaming for AI chat
+ *
+ * Replaces WebSocket with HTTP SSE for AI conversation streaming.
+ * Ant Design X (useXChat + XRequest) natively consumes this format.
+ *
+ * POST /api/v1/chat
+ *   Body: { content, session_id, button_id?, context?, files? }
+ *   Response: SSE stream with data lines containing JSON chunks
+ *
+ * GET /api/v1/sessions - List sessions
+ * POST /api/v1/sessions - Create session
+ * GET /api/v1/sessions/:id - Load session
+ * DELETE /api/v1/sessions/:id - Delete session
+ */
+import { resolveButtonPrompt } from '../ai/button-resolver.js';
+import { saveUploadedFile } from './upload.js';
+// ── Shared Schemas ──
+const chatBodySchema = {
+    type: 'object',
+    properties: {
+        content: { type: 'string' },
+        session_id: { type: 'string' },
+        button_id: { type: 'string' },
+        context: { type: 'object', additionalProperties: true },
+        files: {
+            type: 'array',
+            items: {
+                type: 'object',
+                required: ['uid', 'name', 'size', 'type', 'content'],
+                properties: {
+                    uid: { type: 'string' },
+                    name: { type: 'string' },
+                    size: { type: 'number' },
+                    type: { type: 'string' },
+                    content: { type: 'string' },
+                },
+            },
+        },
+    },
+};
+const sessionParamsSchema = {
+    type: 'object',
+    required: ['id'],
+    properties: {
+        id: { type: 'string', minLength: 1 },
+    },
+};
+const messageParamsSchema = {
+    type: 'object',
+    required: ['id', 'messageId'],
+    properties: {
+        id: { type: 'string', minLength: 1 },
+        messageId: { type: 'string', minLength: 1 },
+    },
+};
+const truncateBodySchema = {
+    type: 'object',
+    required: ['fromIndex'],
+    properties: {
+        fromIndex: { type: 'integer', minimum: 0 },
+    },
+};
+function startHeartbeat(reply) {
+    return setInterval(() => {
+        try {
+            reply.raw.write(':\n\n'); // SSE comment line - keeps connection alive
+        }
+        catch {
+            // Connection already closed
+        }
+    }, 30000);
+}
+function startIdleTimeout(reply, onTimeout) {
+    return setTimeout(() => {
+        try {
+            reply.raw.end();
+        }
+        catch {
+            // Already closed
+        }
+        onTimeout();
+    }, 5 * 60 * 1000); // 5 minutes idle timeout
+}
+function refreshIdleTimeout(state, reply, onTimeout) {
+    clearTimeout(state.timeout);
+    state.timeout = startIdleTimeout(reply, onTimeout);
+}
+function cleanupSSE(state) {
+    clearInterval(state.heartbeat);
+    clearTimeout(state.timeout);
+    state.clientConnected = false;
+}
+// ── SSE Helpers ──
+async function sendSSE(reply, event) {
+    try {
+        const ok = reply.raw.write(`data: ${JSON.stringify(event)}\n\n`);
+        if (!ok) {
+            // Backpressure: wait for drain or timeout after 5s
+            await new Promise((resolve) => {
+                const drainHandler = () => { reply.raw.off('drain', drainHandler); resolve(); };
+                reply.raw.once('drain', drainHandler);
+                setTimeout(() => { reply.raw.off('drain', drainHandler); resolve(); }, 5000);
+            });
+        }
+        return true;
+    }
+    catch {
+        return false; // Client disconnected
+    }
+}
+function endSSE(reply) {
+    try {
+        reply.raw.end();
+    }
+    catch {
+        // Already closed
+    }
+}
+// ── Route Registration ──
+/**
+ * Register chat SSE route and session REST routes
+ */
+export function registerChatRoutes(fastify, options) {
+    const { engine, sessionManager, config, logger, projectRoot } = options;
+    // POST /api/v1/chat — SSE streaming AI response
+    fastify.post('/api/v1/chat', {
+        schema: { body: chatBodySchema },
+    }, async (request, reply) => {
+        const body = request.body;
+        const { content, session_id, button_id, context, files } = body;
+        if (!content && !button_id) {
+            return reply.status(400).send({ error: 'content or button_id is required' });
+        }
+        // Auto-generate session_id if not provided
+        const resolvedSessionId = session_id || `session_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;
+        const isNewSession = !session_id;
+        // Set SSE headers
+        reply.raw.writeHead(200, {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache',
+            Connection: 'keep-alive',
+            'X-Accel-Buffering': 'no', // Disable nginx buffering
+        });
+        // Start heartbeat and idle timeout
+        const sseState = {
+            heartbeat: startHeartbeat(reply),
+            timeout: startIdleTimeout(reply, () => { sseState.clientConnected = false; }),
+            clientConnected: true,
+        };
+        const messageId = generateMessageId();
+        const startTime = Date.now();
+        // Track active process for abort on disconnect
+        let activeProcessKey;
+        // Handle client disconnect - abort the engine process
+        reply.raw.on('close', () => {
+            if (activeProcessKey && engine && 'killSession' in engine) {
+                engine.killSession(activeProcessKey);
+            }
+            cleanupSSE(sseState);
+        });
+        // Handle file uploads
+        const uploadedFiles = [];
+        if (files && files.length > 0 && projectRoot) {
+            for (const file of files) {
+                if (file.content) {
+                    try {
+                        const result = await saveUploadedFile(projectRoot, resolvedSessionId, file.name, file.content);
+                        uploadedFiles.push({ name: file.name, path: result.path });
+                    }
+                    catch (err) {
+                        fastify.log.warn('Failed to save uploaded file %s: %s', file.name, err);
+                    }
+                }
+            }
+        }
+        // Resolve prompt: AI button or direct content
+        let prompt;
+        if (button_id) {
+            const resolved = resolveButtonPrompt(button_id, context, config);
+            if (!resolved) {
+                await sendSSE(reply, { type: 'error', error: `AI button "${button_id}" not found`, message_id: messageId, session_id: resolvedSessionId });
+                endSSE(reply);
+                cleanupSSE(sseState);
+                return;
+            }
+            if (resolved.error) {
+                await sendSSE(reply, { type: 'error', error: resolved.error, message_id: messageId, session_id: resolvedSessionId });
+                endSSE(reply);
+                cleanupSSE(sseState);
+                return;
+            }
+            prompt = resolved.prompt;
+        }
+        else {
+            prompt = content;
+        }
+        // Get or create session
+        const session = await sessionManager.getOrCreate(resolvedSessionId);
+        activeProcessKey = resolvedSessionId;
+        // Add user message to session
+        const userMsg = {
+            id: messageId,
+            role: 'user',
+            content: prompt,
+            timestamp: new Date().toISOString(),
+            files: files?.map((f) => ({ uid: f.uid, name: f.name, size: f.size, type: f.type })),
+        };
+        await sessionManager.addMessages(resolvedSessionId, [userMsg]);
+        // Call AI engine and stream chunks
+        let aiContent = '';
+        const aiContentBlocks = [];
+        let claudeSessionId;
+        let usage;
+        try {
+            for await (const chunk of engine.call(prompt, {
+                sessionId: resolvedSessionId,
+                resumeSessionId: session.claudeSessionId,
+                files: uploadedFiles.length > 0 ? uploadedFiles : undefined,
+            })) {
+                // Check if client is still connected
+                if (!sseState.clientConnected)
+                    break;
+                if (chunk.type === 'content' && chunk.content) {
+                    aiContent += chunk.content;
+                    // Merge into last content block or append
+                    const last = aiContentBlocks[aiContentBlocks.length - 1];
+                    if (last?.type === 'content') {
+                        last.content = (last.content || '') + chunk.content;
+                    }
+                    else {
+                        aiContentBlocks.push({ type: 'content', content: chunk.content });
+                    }
+                    const sent = await sendSSE(reply, { type: 'content', content: chunk.content, message_id: messageId, session_id: resolvedSessionId });
+                    if (!sent)
+                        break;
+                    refreshIdleTimeout(sseState, reply, () => { sseState.clientConnected = false; });
+                }
+                else if (chunk.type === 'thinking' && chunk.content) {
+                    // Merge into last thinking block or append
+                    const last = aiContentBlocks[aiContentBlocks.length - 1];
+                    if (last?.type === 'thinking') {
+                        last.thinking = (last.thinking || '') + chunk.content;
+                    }
+                    else {
+                        aiContentBlocks.push({ type: 'thinking', thinking: chunk.content });
+                    }
+                    const sent = await sendSSE(reply, { type: 'thinking', thinking: chunk.content, message_id: messageId, session_id: resolvedSessionId });
+                    if (!sent)
+                        break;
+                    refreshIdleTimeout(sseState, reply, () => { sseState.clientConnected = false; });
+                }
+                else if (chunk.type === 'session_info') {
+                    claudeSessionId = chunk.sessionId;
+                    if (chunk.usage)
+                        usage = chunk.usage;
+                }
+                else if (chunk.type === 'error' && chunk.error) {
+                    await sendSSE(reply, { type: 'error', error: chunk.error, message_id: messageId, session_id: resolvedSessionId });
+                }
+                else if (chunk.type === 'tool_call') {
+                    // Update existing tool_call block or append
+                    const blockIdx = aiContentBlocks.findIndex(b => b.type === 'tool_call' && b.toolUseId === chunk.toolUseId);
+                    if (blockIdx >= 0) {
+                        const existing = aiContentBlocks[blockIdx];
+                        const newInput = chunk.toolInput;
+                        const shouldUpdateInput = newInput !== undefined &&
+                            (typeof newInput !== 'object' || newInput === null || Object.keys(newInput).length > 0 || existing.toolInput === undefined);
+                        aiContentBlocks[blockIdx] = {
+                            ...existing,
+                            ...(shouldUpdateInput ? { toolInput: newInput } : {}),
+                            status: 'started',
+                        };
+                    }
+                    else {
+                        aiContentBlocks.push({
+                            type: 'tool_call',
+                            tool: chunk.toolName || 'unknown',
+                            toolUseId: chunk.toolUseId || '',
+                            status: 'started',
+                            toolInput: chunk.toolInput,
+                        });
+                    }
+                    const sent = await sendSSE(reply, {
+                        type: 'tool_call',
+                        toolUseId: chunk.toolUseId,
+                        toolName: chunk.toolName,
+                        toolInput: chunk.toolInput,
+                    });
+                    if (!sent)
+                        break;
+                    refreshIdleTimeout(sseState, reply, () => { sseState.clientConnected = false; });
+                }
+                else if (chunk.type === 'tool_result') {
+                    // Find matching tool_call block and update
+                    const blockIdx = aiContentBlocks.findIndex(b => b.type === 'tool_call' && b.toolUseId === chunk.toolUseId);
+                    if (blockIdx >= 0) {
+                        aiContentBlocks[blockIdx] = { ...aiContentBlocks[blockIdx], status: 'completed', result: chunk.toolResult };
+                    }
+                    const sent = await sendSSE(reply, {
+                        type: 'tool_result',
+                        toolUseId: chunk.toolUseId || '',
+                        toolResult: chunk.toolResult,
+                    });
+                    if (!sent)
+                        break;
+                    refreshIdleTimeout(sseState, reply, () => { sseState.clientConnected = false; });
+                }
+            }
+        }
+        catch (error) {
+            fastify.log.error('AI engine exception: %s', error);
+            recordLog(logger, resolvedSessionId, messageId, prompt, '', startTime, [], [], error instanceof Error ? error.message : String(error), fastify);
+            await sendSSE(reply, { type: 'error', error: `Processing error: ${error}`, message_id: messageId, session_id: resolvedSessionId });
+            endSSE(reply);
+            cleanupSSE(sseState);
+            return;
+        }
+        // Send completion
+        if (sseState.clientConnected) {
+            const completePayload = {
+                type: 'done',
+                content: aiContent || '(empty response)',
+                message_id: messageId,
+                assistant_message_id: `resp_${messageId}`,
+                session_id: resolvedSessionId,
+                is_new_session: isNewSession || undefined,
+            };
+            if (claudeSessionId)
+                completePayload.claude_session_id = claudeSessionId;
+            if (usage)
+                completePayload.usage = usage;
+            await sendSSE(reply, completePayload);
+            // Persist assistant message (with contentBlocks)
+            const assistantMsg = {
+                id: `resp_${messageId}`,
+                role: 'assistant',
+                content: aiContent || '(empty response)',
+                timestamp: new Date().toISOString(),
+                ...(aiContentBlocks.length > 0 ? { contentBlocks: aiContentBlocks } : {}),
+            };
+            await sessionManager.addMessages(resolvedSessionId, [assistantMsg], claudeSessionId, usage);
+            recordLog(logger, resolvedSessionId, messageId, prompt, aiContent || '(empty response)', startTime, [], [], undefined, fastify, usage);
+        }
+        endSSE(reply);
+        cleanupSSE(sseState);
+    });
+    // GET /api/v1/sessions — List sessions
+    fastify.get('/api/v1/sessions', async (_request, reply) => {
+        const sessions = await sessionManager.listSessions();
+        return reply.send(sessions);
+    });
+    // POST /api/v1/sessions — Create session
+    fastify.post('/api/v1/sessions', {
+        schema: { body: { type: 'object', properties: { id: { type: 'string' } } } },
+    }, async (request, reply) => {
+        const body = request.body;
+        const session = await sessionManager.createSession(body?.id);
+        return reply.code(201).send(session);
+    });
+    // GET /api/v1/sessions/:id — Load session
+    fastify.get('/api/v1/sessions/:id', {
+        schema: { params: sessionParamsSchema },
+    }, async (request, reply) => {
+        const { id } = request.params;
+        const session = await sessionManager.readSession(id);
+        if (!session)
+            return reply.status(404).send({ error: 'Session not found' });
+        return reply.send(session);
+    });
+    // DELETE /api/v1/sessions/:id — Delete session
+    fastify.delete('/api/v1/sessions/:id', {
+        schema: { params: sessionParamsSchema },
+    }, async (request, reply) => {
+        const { id } = request.params;
+        const success = await sessionManager.deleteSession(id);
+        if (!success)
+            return reply.status(404).send({ error: 'Session not found' });
+        return reply.send({ success: true });
+    });
+    // DELETE /api/v1/sessions/:id/messages/:messageId — Delete a single message
+    fastify.delete('/api/v1/sessions/:id/messages/:messageId', {
+        schema: { params: messageParamsSchema },
+    }, async (request, reply) => {
+        const { id, messageId } = request.params;
+        const session = await sessionManager.deleteMessage(id, messageId);
+        if (!session)
+            return reply.status(404).send({ error: 'Session or message not found' });
+        return reply.send(session);
+    });
+    // POST /api/v1/sessions/:id/truncate — Truncate messages from a given index
+    fastify.post('/api/v1/sessions/:id/truncate', {
+        schema: { params: sessionParamsSchema, body: truncateBodySchema },
+    }, async (request, reply) => {
+        const { id } = request.params;
+        const body = request.body;
+        const session = await sessionManager.truncateMessagesFromIndex(id, body.fromIndex);
+        if (!session)
+            return reply.status(404).send({ error: 'Session not found or invalid index' });
+        return reply.send(session);
+    });
+}
+// ── Helpers ──
+function generateMessageId() {
+    return `msg_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;
+}
+function recordLog(logger, sessionId, messageId, prompt, response, startTime, mcpCalls, cliCalls, error, fastify, usage) {
+    if (!logger)
+        return;
+    const logEntry = {
+        sessionId,
+        messageId,
+        timestamp: new Date().toISOString(),
+        prompt,
+        response,
+        duration: Date.now() - startTime,
+        usage: usage ? { inputTokens: usage.inputTokens, outputTokens: usage.outputTokens } : undefined,
+        mcpCalls,
+        cliCalls,
+        error,
+    };
+    logger.log(logEntry).catch((err) => {
+        fastify.log.warn('Failed to write interaction log: %s', err);
+    });
+}
+//# sourceMappingURL=chat.js.map