@loom-framework/core 0.1.0-alpha.19 → 0.1.0-alpha.190

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

@@ -0,0 +1,30 @@
+/**
+ * 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
+ */
+import type { FastifyInstance } from 'fastify';
+import type { AIEngine } from '../../types/ai.js';
+import type { LoomConfig } from '../../types/config.js';
+import { SessionManager } from '../ai/session-manager.js';
+import { AIInteractionLogger } from '../observe/index.js';
+import type { LoomPaths } from '../loom-paths.js';
+import type { EventBus } from '../events/event-bus.js';
+export interface ChatRouteOptions {
+    engine: AIEngine;
+    sessionManager: SessionManager;
+    config: LoomConfig;
+    logger?: AIInteractionLogger;
+    paths: LoomPaths;
+    eventBus?: EventBus;
+}
+/**
+ * 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;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAC7E,OAAO,KAAK,EAAE,QAAQ,EAAW,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAIxD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAUvD,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,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AA+BD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,gBAAgB,GACxB,IAAI,CAiMN"}

package/dist/backend/routes/chat.js

@@ -0,0 +1,258 @@
+/**
+ * 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
+ */
+import { generateId } from '../../utils/id.js';
+import { mergeContentBlock } from '../ai/content-blocks.js';
+import { resolveButtonPrompt } from '../ai/button-resolver.js';
+import { saveUploadedFile } from './upload.js';
+import { startHeartbeat, startIdleTimeout, refreshIdleTimeout, cleanupSSE, sendSSE, endSSE } from './chat-sse.js';
+import { registerSessionRoutes } from './session-routes.js';
+// ── Shared Schemas ──
+const chatBodySchema = {
+    type: 'object',
+    properties: {
+        content: { type: 'string' },
+        session_id: { type: 'string' },
+        button_id: { type: 'string' },
+        context: { type: 'object', additionalProperties: true },
+        model: { type: 'string' },
+        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' },
+                },
+            },
+        },
+    },
+};
+// ── Route Registration ──
+/**
+ * Register chat SSE route and session REST routes
+ */
+export function registerChatRoutes(fastify, options) {
+    const { engine, sessionManager, config, logger, paths, eventBus } = options;
+    // Register session CRUD routes (extracted to session-routes.ts)
+    registerSessionRoutes(fastify, { sessionManager, eventBus });
+    // 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, model } = 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) {
+            for (const file of files) {
+                if (file.content) {
+                    try {
+                        const result = await saveUploadedFile(paths, resolvedSessionId, file.name, file.content);
+                        uploadedFiles.push({ name: file.name, path: result.path });
+                        void eventBus?.emit('file:uploaded', { filename: file.name, sessionId: resolvedSessionId, path: result.path, size: file.size }, { userId: request.user?.userId, source: 'server' });
+                    }
+                    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, url: `/api/v1/uploads/${resolvedSessionId}/${f.name}` })),
+        };
+        await sessionManager.addMessages(resolvedSessionId, [userMsg]);
+        // Call AI engine and stream chunks
+        let aiContent = '';
+        let 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,
+                model,
+                userToken: request.user?.token,
+            })) {
+                // Check if client is still connected
+                if (!sseState.clientConnected)
+                    break;
+                // Merge chunk into content blocks using shared merge logic
+                aiContentBlocks = mergeContentBlock(aiContentBlocks, chunk);
+                if (chunk.type === 'content' && chunk.content) {
+                    aiContent += 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) {
+                    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') {
+                    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') {
+                    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);
+    });
+}
+// ── Helpers ──
+function generateMessageId() {
+    return generateId('msg');
+}
+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

package/dist/backend/routes/chat.js.map

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

package/dist/backend/routes/config-writer.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Config Writer — Surgically modify loom.config.ts
+ *
+ * Provides string/comment-aware bracket matching and section-level writes
+ * for processes.definitions, events.subscriptions, and ai.claudeCode.models.
+ *
+ * Key design decisions:
+ * - `findMatchingBracket()` tracks both `[]` and `{}` depth
+ * - `skipStringAndComment()` skips string literals, template literals, and comments
+ * - All writes are atomic: backup → modify → write → verify (failed writes restore from .bak)
+ * - `writeModelsToConfig()` refactored to use `findMatchingBracket()` for robustness
+ */
+import type { ModelConfig } from '../../types/ai.js';
+import type { ProcessDefinitionConfig } from '../../types/process.js';
+import type { EventSubscription } from '../../types/event.js';
+/**
+ * Skip over a string literal, template literal, or comment starting at `pos`.
+ * Returns the position AFTER the closed string/comment.
+ * If the character at `pos` is not a string/comment opener, returns `pos` unchanged.
+ */
+export declare function skipStringAndComment(text: string, pos: number): number;
+/**
+ * Find the matching bracket for an open bracket at `start`.
+ * Skips strings, comments, and tracks depth for both `[]` and `{}`.
+ * Returns the position AFTER the closing bracket.
+ */
+export declare function findMatchingBracket(text: string, start: number, open: string, close: string): number;
+export interface ConfigSectionTarget {
+    /** Regex to locate the parent object (e.g., /processes:\s*\{/) */
+    parentRegex: RegExp;
+    /** Field key inside the parent (e.g., "definitions") */
+    fieldKey: string;
+    /** JSON string value for the field (e.g., "[{...}]") */
+    fieldValue: string;
+    /** Base indent level (spaces) inside the parent object */
+    baseIndent: number;
+    /** If parentRegex doesn't match, try this fallback parent (e.g., "processes:") */
+    fallbackParent?: string;
+    /** If no parent matches, insert this full section before defineConfig closing */
+    fallbackSection?: string;
+}
+/**
+ * Write one or more sections to loom.config.ts.
+ * Creates a .bak backup before writing and restores on failure.
+ */
+export declare function writeConfigSection(projectRoot: string, sections: ConfigSectionTarget[]): Promise<void>;
+/**
+ * Write models array to loom.config.ts.
+ * Refactored to use findMatchingBracket() for string/comment awareness.
+ */
+export declare function writeModelsToConfig(projectRoot: string, models: ModelConfig[]): Promise<void>;
+/**
+ * Write process definitions to loom.config.ts (processes.definitions).
+ */
+export declare function writeProcessesToConfig(projectRoot: string, definitions: ProcessDefinitionConfig[]): Promise<void>;
+/**
+ * Write event subscriptions to loom.config.ts (events.subscriptions).
+ */
+export declare function writeEventSubscriptionsToConfig(projectRoot: string, subscriptions: EventSubscription[]): Promise<void>;
+/**
+ * Atomically write a process definition and its event subscription at the same time.
+ * This ensures that a process with a source always has its subscription in the same write.
+ * Uses writeConfigSection with multiple sections for atomicity (single backup/restore cycle).
+ */
+export declare function writeProcessWithSubscription(projectRoot: string, definition: ProcessDefinitionConfig, subscription?: {
+    pattern: string;
+    config: {
+        process: string;
+        filter?: Record<string, unknown>;
+        debounceMs?: number;
+    };
+}, mode?: 'add' | 'remove'): Promise<void>;
+/**
+ * Read process definitions from loom.config.ts.
+ */
+export declare function readProcessDefinitions(projectRoot: string): Promise<ProcessDefinitionConfig[]>;
+/**
+ * Read event subscriptions from loom.config.ts.
+ */
+export declare function readEventSubscriptions(projectRoot: string): Promise<EventSubscription[]>;
+/**
+ * Find a subscription by its stable ID.
+ * Returns the subscription object or undefined if not found.
+ */
+export declare function findSubscriptionById(subscriptions: EventSubscription[], id: string): EventSubscription | undefined;
+/**
+ * Ensure every subscription has a stable `id`.
+ * Assigns IDs to any subscriptions missing one, then writes back if changed.
+ * Returns the subscriptions with all IDs populated.
+ *
+ * Should be called once at server startup, not on every read.
+ */
+export declare function ensureSubscriptionIds(projectRoot: string): Promise<EventSubscription[]>;
+//# sourceMappingURL=config-writer.d.ts.map

package/dist/backend/routes/config-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-writer.d.ts","sourceRoot":"","sources":["../../../src/backend/routes/config-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAO9D;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAqDtE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAWpG;AAMD,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,mBAAmB,EAAE,GAC9B,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAoJD;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmEnG;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,uBAAuB,EAAE,GACrC,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED;;GAEG;AACH,wBAAsB,+BAA+B,CACnD,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,iBAAiB,EAAE,GACjC,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;;;GAIG;AACH,wBAAsB,4BAA4B,CAChD,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,uBAAuB,EACnC,YAAY,CAAC,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,EACtH,IAAI,GAAE,KAAK,GAAG,QAAgB,GAC7B,OAAO,CAAC,IAAI,CAAC,CA6Ef;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAQpG;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAQ9F;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,iBAAiB,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAElH;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAgB7F"}