lattice-orchestrator 0.7.0

package/dist/routes/conversation.routes.js

@@ -0,0 +1,79 @@
+/**
+ * Conversation Routes - Main API for session management.
+ *
+ * This module composes focused sub-routers for maintainability:
+ *
+ * - session-lifecycle.routes.ts  - Start/Resume sessions
+ * - session-query.routes.ts      - List, Active, Details (read operations)
+ * - session-stream.routes.ts     - Activity-stream SSE (real-time updates)
+ * - session-control.routes.ts    - Process control, metadata, archive, branch
+ *
+ * ROUTES OVERVIEW:
+ * ================
+ *
+ * LIFECYCLE:
+ *   POST /start                    - Start new or resume existing session
+ *
+ * QUERY:
+ *   GET /                          - List all conversations
+ *   GET /active                    - Get active session IDs
+ *   GET /:sessionId                - Get conversation details
+ *
+ * STREAM:
+ *   GET /activity-stream           - SSE for real-time updates
+ *
+ * CONTROL:
+ *   POST /:streamingId/interrupt   - Send Ctrl+C
+ *   POST /:streamingId/stop        - Graceful stop
+ *   POST /session/:sessionId/stop  - Stop by session ID
+ *   POST /session/:sessionId/force-kill - Force kill
+ *   POST /session/:sessionId/inject - Inject stdin
+ *   PUT /:sessionId/rename         - Rename session
+ *   PUT /:sessionId/update         - Update properties
+ *   POST /session/:sessionId/branch - Create branch
+ *   POST /archive-all              - Archive all sessions
+ */
+import { Router } from 'express';
+import { InsightsComputer } from '../services/insights/insights-computer.js';
+import { createSessionLifecycleRoutes } from './session-lifecycle.routes.js';
+import { createSessionQueryRoutes } from './session-query.routes.js';
+import { createSessionStreamRoutes } from './session-stream.routes.js';
+import { createSessionControlRoutes } from './session-control.routes.js';
+export function createConversationRoutes(processManager, historyReader, conversationStatusManager, sessionInfoService, toolMetricsService) {
+    const router = Router();
+    // Create shared InsightsComputer instance
+    const insightsComputer = new InsightsComputer(historyReader, sessionInfoService);
+    // Mount sub-routers
+    // IMPORTANT: Order matters! More specific routes must come before parameterized routes.
+    // /activity-stream must be mounted before /:sessionId or it will be captured as a sessionId.
+    // Lifecycle routes (POST /start)
+    router.use(createSessionLifecycleRoutes({
+        processManager,
+        historyReader,
+        conversationStatusManager,
+        sessionInfoService
+    }));
+    // Stream routes (GET /activity-stream) - must come before query routes!
+    router.use(createSessionStreamRoutes({
+        historyReader,
+        conversationStatusManager,
+        insightsComputer
+    }));
+    // Query routes (GET /, GET /active, GET /:sessionId)
+    router.use(createSessionQueryRoutes({
+        historyReader,
+        conversationStatusManager,
+        sessionInfoService,
+        toolMetricsService,
+        insightsComputer
+    }));
+    // Control routes (POST operations, PUT operations)
+    router.use(createSessionControlRoutes({
+        processManager,
+        historyReader,
+        conversationStatusManager,
+        sessionInfoService
+    }));
+    return router;
+}
+//# sourceMappingURL=conversation.routes.js.map

package/dist/routes/conversation.routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.routes.js","sourceRoot":"","sources":["../../src/routes/conversation.routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAMjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAE5E,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAEzE,MAAM,UAAU,wBAAwB,CACtC,cAAqC,EACrC,aAAkC,EAClC,yBAAoD,EACpD,kBAAsC,EACtC,kBAAsC;IAEtC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB,0CAA0C;IAC1C,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;IAEjF,oBAAoB;IACpB,wFAAwF;IACxF,6FAA6F;IAE7F,iCAAiC;IACjC,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC;QACtC,cAAc;QACd,aAAa;QACb,yBAAyB;QACzB,kBAAkB;KACnB,CAAC,CAAC,CAAC;IAEJ,wEAAwE;IACxE,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC;QACnC,aAAa;QACb,yBAAyB;QACzB,gBAAgB;KACjB,CAAC,CAAC,CAAC;IAEJ,qDAAqD;IACrD,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC;QAClC,aAAa;QACb,yBAAyB;QACzB,kBAAkB;QAClB,kBAAkB;QAClB,gBAAgB;KACjB,CAAC,CAAC,CAAC;IAEJ,mDAAmD;IACnD,MAAM,CAAC,GAAG,CAAC,0BAA0B,CAAC;QACpC,cAAc;QACd,aAAa;QACb,yBAAyB;QACzB,kBAAkB;KACnB,CAAC,CAAC,CAAC;IAEJ,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/routes/filesystem.routes.d.ts

@@ -0,0 +1,4 @@
+import { Router } from 'express';
+import { FileSystemService } from '../services/infrastructure/file-system-service.js';
+export declare function createFileSystemRoutes(fileSystemService: FileSystemService): Router;
+//# sourceMappingURL=filesystem.routes.d.ts.map

package/dist/routes/filesystem.routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.routes.d.ts","sourceRoot":"","sources":["../../src/routes/filesystem.routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAW,MAAM,SAAS,CAAC;AAS1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AAGrF,wBAAgB,sBAAsB,CACpC,iBAAiB,EAAE,iBAAiB,GACnC,MAAM,CA6FR"}

package/dist/routes/filesystem.routes.js

@@ -0,0 +1,86 @@
+import { Router } from 'express';
+import { LatticeError } from '../types/index.js';
+import { createLogger } from '../services/infrastructure/logger.js';
+export function createFileSystemRoutes(fileSystemService) {
+    const router = Router();
+    const logger = createLogger('FileSystemRoutes');
+    // Helper to strictly parse boolean query params (accepts "true"/"false" and booleans)
+    const parseBooleanParam = (value, paramName) => {
+        if (value === undefined)
+            return undefined;
+        if (typeof value === 'boolean')
+            return value;
+        if (typeof value === 'string') {
+            if (value.toLowerCase() === 'true')
+                return true;
+            if (value.toLowerCase() === 'false')
+                return false;
+        }
+        throw new LatticeError('INVALID_PARAM', `${paramName} must be boolean (true/false)`, 400);
+    };
+    // List directory contents
+    router.get('/list', async (req, res, next) => {
+        const requestId = req.requestId;
+        logger.debug('List directory request', {
+            requestId,
+            path: req.query.path,
+            recursive: req.query.recursive,
+            respectGitignore: req.query.respectGitignore
+        });
+        try {
+            // Validate required parameters
+            if (!req.query.path) {
+                throw new LatticeError('MISSING_PATH', 'path query parameter is required', 400);
+            }
+            // Parse boolean query parameters
+            const recursive = parseBooleanParam(req.query.recursive, 'recursive') ?? false;
+            const respectGitignore = parseBooleanParam(req.query.respectGitignore, 'respectGitignore') ?? false;
+            const result = await fileSystemService.listDirectory(req.query.path, recursive, respectGitignore);
+            logger.debug('Directory listed successfully', {
+                requestId,
+                path: result.path,
+                entryCount: result.entries.length
+            });
+            res.json(result);
+        }
+        catch (error) {
+            logger.debug('List directory failed', {
+                requestId,
+                path: req.query.path,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            next(error);
+        }
+    });
+    // Read file contents
+    router.get('/read', async (req, res, next) => {
+        const requestId = req.requestId;
+        logger.debug('Read file request', {
+            requestId,
+            path: req.query.path
+        });
+        try {
+            // Validate required parameters
+            if (!req.query.path) {
+                throw new LatticeError('MISSING_PATH', 'path query parameter is required', 400);
+            }
+            const result = await fileSystemService.readFile(req.query.path);
+            logger.debug('File read successfully', {
+                requestId,
+                path: result.path,
+                size: result.size
+            });
+            res.json(result);
+        }
+        catch (error) {
+            logger.debug('Read file failed', {
+                requestId,
+                path: req.query.path,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            next(error);
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=filesystem.routes.js.map

package/dist/routes/filesystem.routes.js.map

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

package/dist/routes/insights.routes.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Session insights routes - AI-powered session analysis, refresh, and observability.
+ *
+ * Endpoints:
+ * - GET /:sessionId/insights - Get insights for a session
+ * - POST /:sessionId/generate-name - Generate AI session name
+ * - POST /refresh - Refresh insights for all sessions (smart or force)
+ * - POST /activity-check - Lightweight heartbeat with mtime tracking
+ * - POST /pulse - 5-minute lightweight edit-check
+ * - GET /debug/:sessionId - Observability endpoint
+ * - GET /stats - Global insights stats
+ */
+import { Router } from 'express';
+import { ClaudeHistoryReader } from '../services/sessions/claude-history-reader.js';
+import { SessionInfoService } from '../services/sessions/session-info-service.js';
+export declare function createInsightsRoutes(historyReader: ClaudeHistoryReader, sessionInfoService: SessionInfoService): Router;
+//# sourceMappingURL=insights.routes.d.ts.map

package/dist/routes/insights.routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insights.routes.d.ts","sourceRoot":"","sources":["../../src/routes/insights.routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AAQjF,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,mBAAmB,EAClC,kBAAkB,EAAE,kBAAkB,GACrC,MAAM,CAqsBR"}