@loom-framework/core 0.1.0-alpha.14 → 0.1.0-alpha.141

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

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

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

package/dist/backend/index.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @loom-framework/backend - Main Server
+ *
+ * Assembles Fastify server with:
+ * - HTTP SSE chat route (Ant Design X compatible)
+ * - REST routes for DataAdapter CRUD + health check + sessions
+ * - Static file serving for production mode
+ * - Configuration from loom.config.ts
+ */
+import Fastify from 'fastify';
+import type { LoomConfig, AIEngine, DataAdapter, ServerConfig } from '../index.js';
+export interface LoomServerOptions {
+    /** Project root directory containing loom.config.ts */
+    projectRoot: string;
+    /** Override server config (merges over config file) */
+    serverConfig?: Partial<ServerConfig>;
+    /** Custom AI engine (defaults to ClaudeCodeEngine from config) */
+    engine?: AIEngine;
+    /** Custom DataAdapter (defaults to FileSystemAdapter from config) */
+    adapter?: DataAdapter;
+    /** Logger level */
+    logLevel?: string;
+}
+export declare class LoomServer {
+    private config;
+    private engine;
+    private adapter;
+    private sessionManager;
+    private interactionLogger;
+    private fastify;
+    private projectRoot;
+    private options;
+    constructor(options: LoomServerOptions);
+    /**
+     * Initialize server: load config, create engine/adapter, register routes
+     */
+    initialize(): Promise<void>;
+    /**
+     * Start listening
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the server
+     */
+    stop(): Promise<void>;
+    /** Expose Fastify instance for testing */
+    getFastify(): ReturnType<typeof Fastify>;
+    /** Expose config for testing */
+    getConfig(): LoomConfig;
+    /** Expose adapter for testing */
+    getAdapter(): DataAdapter;
+    /**
+     * Create DataAdapter based on config.data.defaultAdapter
+     */
+    private createAdapter;
+}
+/**
+ * Create and start a LoomServer from a project root
+ */
+export declare function startServer(projectRoot: string): Promise<LoomServer>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAM9B,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQnF,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACrC,kEAAkE;IAClE,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,qEAAqE;IACrE,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,mBAAmB;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,iBAAiB,CAAuB;IAChD,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAoB;gBAEvB,OAAO,EAAE,iBAAiB;IAKtC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA4FjC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,0CAA0C;IAC1C,UAAU,IAAI,UAAU,CAAC,OAAO,OAAO,CAAC;IAIxC,gCAAgC;IAChC,SAAS,IAAI,UAAU;IAIvB,iCAAiC;IACjC,UAAU,IAAI,WAAW;IAIzB;;OAEG;IACH,OAAO,CAAC,aAAa;CAUtB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAK1E"}

package/dist/backend/index.js

@@ -0,0 +1,166 @@
+/**
+ * @loom-framework/backend - Main Server
+ *
+ * Assembles Fastify server with:
+ * - HTTP SSE chat route (Ant Design X compatible)
+ * - REST routes for DataAdapter CRUD + health check + sessions
+ * - Static file serving for production mode
+ * - Configuration from loom.config.ts
+ */
+import Fastify from 'fastify';
+import cors from '@fastify/cors';
+import staticPlugin from '@fastify/static';
+import path from 'path';
+import { FileSystemAdapter, loadConfig, SQLiteAdapter } from '../index.js';
+import { ClaudeCodeEngine } from './ai/engine.js';
+import { SessionManager } from './ai/session-manager.js';
+import { AIInteractionLogger } from './observe/index.js';
+import { registerDataRoutes, registerHealthRoute, registerUploadRoutes, registerChatRoutes, registerSkillRoutes, registerAIConfigRoutes } from './routes/index.js';
+export class LoomServer {
+    config;
+    engine;
+    adapter;
+    sessionManager;
+    interactionLogger;
+    fastify;
+    projectRoot;
+    options;
+    constructor(options) {
+        this.projectRoot = options.projectRoot;
+        this.options = options;
+    }
+    /**
+     * Initialize server: load config, create engine/adapter, register routes
+     */
+    async initialize() {
+        // Load config
+        this.config = await loadConfig(this.projectRoot);
+        const serverConfig = {
+            ...this.config.server,
+            ...this.options.serverConfig,
+        };
+        // Create Fastify instance
+        // bodyLimit: 50MB to support file uploads via base64 (base64 encoding adds ~33% overhead)
+        this.fastify = Fastify({
+            bodyLimit: 50 * 1024 * 1024,
+            logger: {
+                level: this.options.logLevel || serverConfig.logLevel || 'info',
+            },
+        });
+        // Global error handler - provides structured error responses
+        this.fastify.setErrorHandler((error, _request, reply) => {
+            if (error.validation) {
+                reply.status(400).send({ error: 'Validation error', details: error.validation });
+                return;
+            }
+            this.fastify.log.error(error);
+            const statusCode = error.statusCode || 500;
+            reply.status(statusCode).send({
+                error: statusCode === 500 ? 'Internal server error' : error.message,
+            });
+        });
+        // Initialize DataAdapter based on config
+        this.adapter = this.options.adapter || this.createAdapter(this.config);
+        await this.adapter.initialize();
+        // Initialize AI Engine
+        this.engine = this.options.engine || new ClaudeCodeEngine({
+            config: this.config.ai?.claudeCode || {},
+            projectRoot: this.projectRoot,
+        });
+        // Initialize Session Manager
+        this.sessionManager = new SessionManager(this.projectRoot);
+        await this.sessionManager.initialize();
+        // Initialize Interaction Logger
+        this.interactionLogger = new AIInteractionLogger(this.projectRoot);
+        await this.interactionLogger.initialize();
+        // Register plugins
+        if (serverConfig.cors !== false) {
+            await this.fastify.register(cors, { origin: true });
+        }
+        // Static file serving in production
+        if (serverConfig.staticDir) {
+            const staticDir = path.resolve(this.projectRoot, serverConfig.staticDir);
+            await this.fastify.register(staticPlugin, {
+                root: staticDir,
+                prefix: '/',
+                wildcard: false,
+            });
+        }
+        // Register routes
+        registerHealthRoute(this.fastify, this.adapter);
+        registerDataRoutes(this.fastify, this.adapter, this.config);
+        registerUploadRoutes(this.fastify, { projectRoot: this.projectRoot });
+        registerChatRoutes(this.fastify, {
+            engine: this.engine,
+            sessionManager: this.sessionManager,
+            config: this.config,
+            logger: this.interactionLogger,
+            projectRoot: this.projectRoot,
+        });
+        registerSkillRoutes(this.fastify, { projectRoot: this.projectRoot });
+        registerAIConfigRoutes(this.fastify, {
+            projectRoot: this.projectRoot,
+        });
+        // Graceful shutdown handlers
+        const cleanup = async () => {
+            if (this.engine instanceof ClaudeCodeEngine) {
+                this.engine.killAll();
+            }
+            await this.fastify.close();
+        };
+        process.on('SIGINT', cleanup);
+        process.on('SIGTERM', cleanup);
+    }
+    /**
+     * Start listening
+     */
+    async start() {
+        const port = this.config.server?.port || 3000;
+        const host = this.config.server?.host || '0.0.0.0';
+        await this.fastify.listen({ port, host });
+    }
+    /**
+     * Stop the server
+     */
+    async stop() {
+        if (this.engine instanceof ClaudeCodeEngine) {
+            this.engine.killAll();
+        }
+        await this.fastify.close();
+    }
+    /** Expose Fastify instance for testing */
+    getFastify() {
+        return this.fastify;
+    }
+    /** Expose config for testing */
+    getConfig() {
+        return this.config;
+    }
+    /** Expose adapter for testing */
+    getAdapter() {
+        return this.adapter;
+    }
+    /**
+     * Create DataAdapter based on config.data.defaultAdapter
+     */
+    createAdapter(config) {
+        if (config.data.defaultAdapter === 'sqlite') {
+            const dbPath = path.join(this.projectRoot, config.data.sqlite?.filename || 'data/loom.db');
+            return new SQLiteAdapter({ dbPath, config });
+        }
+        return new FileSystemAdapter({
+            dataDir: path.join(this.projectRoot, 'data'),
+            config,
+        });
+    }
+}
+/**
+ * Create and start a LoomServer from a project root
+ */
+export async function startServer(projectRoot) {
+    const server = new LoomServer({ projectRoot });
+    await server.initialize();
+    await server.start();
+    return server;
+}
+//# sourceMappingURL=index.js.map

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"}