lattice-orchestrator 0.7.0

package/dist/routes/permission.routes.d.ts

@@ -0,0 +1,18 @@
+import { Router } from 'express';
+import { PermissionTracker } from '../services/permission-tracker.js';
+/**
+ * Check if a tool invocation is allowed by allowlists.
+ * Now supports pattern matching like "Bash(npm *)", "Write(src/**)".
+ *
+ * @returns Object with matching pattern and source if allowed, null otherwise
+ */
+export declare function isToolAllowed(toolName: string, toolInput: Record<string, unknown>, streamingId?: string): {
+    pattern: string;
+    source: 'global' | 'session';
+} | null;
+export declare function addToSessionAllowlist(streamingId: string, pattern: string): void;
+export declare function addToGlobalAllowlist(pattern: string): void;
+export declare function clearSessionAllowlist(streamingId: string): void;
+export { suggestPatterns } from '../services/permission-pattern-matcher.js';
+export declare function createPermissionRoutes(permissionTracker: PermissionTracker): Router;
+//# sourceMappingURL=permission.routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"permission.routes.d.ts","sourceRoot":"","sources":["../../src/routes/permission.routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAgErE;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,WAAW,CAAC,EAAE,MAAM,GACnB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAA;CAAE,GAAG,IAAI,CAoB1D;AAGD,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAOhF;AAGD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAM1D;AAGD,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAE/D;AAGD,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAE3E,wBAAgB,sBAAsB,CACpC,iBAAiB,EAAE,iBAAiB,GACnC,MAAM,CAgUR"}

package/dist/routes/permission.routes.js

@@ -0,0 +1,370 @@
+import { Router } from 'express';
+import { LatticeError } from '../types/index.js';
+import { createLogger } from '../services/infrastructure/logger.js';
+import { isAllowedByPatterns, suggestPatterns } from '../services/permission-pattern-matcher.js';
+import { anthropicService } from '../services/insights/anthropic-service.js';
+import { getPermissionEventLog } from '../services/permission-event-log.js';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+// Claude Code's native settings file (source of truth for allowlists)
+const CLAUDE_SETTINGS_PATH = path.join(os.homedir(), '.claude', 'settings.json');
+// Note: Legacy allowlist was at ~/.claudia/allowed-tools.json
+// Now we use Claude's native ~/.claude/settings.json toolPermissions.allow
+// Session-level allowlists (in-memory, keyed by streamingId, stores patterns)
+const sessionAllowlists = new Map();
+// Load Claude Code's native settings.json
+function loadClaudeSettings() {
+    try {
+        if (fs.existsSync(CLAUDE_SETTINGS_PATH)) {
+            const data = fs.readFileSync(CLAUDE_SETTINGS_PATH, 'utf-8');
+            return JSON.parse(data);
+        }
+    }
+    catch {
+        // Ignore errors, return empty
+    }
+    return {};
+}
+// Save Claude Code's native settings.json (preserving other settings)
+function saveClaudeSettings(settings) {
+    const dir = path.dirname(CLAUDE_SETTINGS_PATH);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(CLAUDE_SETTINGS_PATH, JSON.stringify(settings, null, 2));
+}
+// Load global allowlist from Claude's native settings
+function loadGlobalAllowlist() {
+    const settings = loadClaudeSettings();
+    return settings.toolPermissions?.allow || [];
+}
+// Save pattern to Claude's native settings.json allowlist
+function saveGlobalAllowlist(patterns) {
+    const settings = loadClaudeSettings();
+    if (!settings.toolPermissions) {
+        settings.toolPermissions = {};
+    }
+    settings.toolPermissions.allow = patterns;
+    saveClaudeSettings(settings);
+}
+/**
+ * Check if a tool invocation is allowed by allowlists.
+ * Now supports pattern matching like "Bash(npm *)", "Write(src/**)".
+ *
+ * @returns Object with matching pattern and source if allowed, null otherwise
+ */
+export function isToolAllowed(toolName, toolInput, streamingId) {
+    // Check global allowlist with pattern matching
+    const globalAllowlist = loadGlobalAllowlist();
+    const globalMatch = isAllowedByPatterns(globalAllowlist, toolName, toolInput);
+    if (globalMatch) {
+        return { pattern: globalMatch, source: 'global' };
+    }
+    // Check session allowlist with pattern matching
+    if (streamingId) {
+        const sessionAllowlist = sessionAllowlists.get(streamingId);
+        if (sessionAllowlist) {
+            const sessionMatch = isAllowedByPatterns(Array.from(sessionAllowlist), toolName, toolInput);
+            if (sessionMatch) {
+                return { pattern: sessionMatch, source: 'session' };
+            }
+        }
+    }
+    return null;
+}
+// Add pattern to session allowlist
+export function addToSessionAllowlist(streamingId, pattern) {
+    let allowlist = sessionAllowlists.get(streamingId);
+    if (!allowlist) {
+        allowlist = new Set();
+        sessionAllowlists.set(streamingId, allowlist);
+    }
+    allowlist.add(pattern);
+}
+// Add pattern to global allowlist
+export function addToGlobalAllowlist(pattern) {
+    const allowlist = loadGlobalAllowlist();
+    if (!allowlist.includes(pattern)) {
+        allowlist.push(pattern);
+        saveGlobalAllowlist(allowlist);
+    }
+}
+// Clear session allowlist (call when session ends)
+export function clearSessionAllowlist(streamingId) {
+    sessionAllowlists.delete(streamingId);
+}
+// Re-export suggestPatterns for use by frontend
+export { suggestPatterns } from '../services/permission-pattern-matcher.js';
+export function createPermissionRoutes(permissionTracker) {
+    const router = Router();
+    const logger = createLogger('PermissionRoutes');
+    // Notify endpoint - called by MCP server when permission is requested
+    // Returns auto-approved if tool invocation matches an allowlist pattern
+    router.post('/notify', async (req, res, next) => {
+        const requestId = req.requestId;
+        const permissionLog = getPermissionEventLog();
+        logger.debug('Permission notification received', {
+            requestId,
+            body: req.body
+        });
+        try {
+            const { toolName, toolInput, streamingId } = req.body;
+            if (!toolName) {
+                throw new LatticeError('MISSING_TOOL_NAME', 'toolName is required', 400);
+            }
+            // Check if tool invocation is auto-allowed by any pattern (session or global)
+            const match = isToolAllowed(toolName, toolInput || {}, streamingId);
+            if (match) {
+                // Log auto-approval with structured event
+                permissionLog.autoApproved({
+                    toolName,
+                    toolInput,
+                    streamingId,
+                    matchedPattern: match.pattern,
+                    patternSource: match.source,
+                });
+                res.json({ success: true, id: 'auto-approved', autoApproved: true, matchedPattern: match.pattern });
+                return;
+            }
+            // Add permission request with the provided streamingId
+            const request = permissionTracker.addPermissionRequest(toolName, toolInput, streamingId);
+            // Log permission request with structured event
+            permissionLog.request({
+                toolName,
+                toolInput,
+                streamingId,
+                permissionRequestId: request.id,
+            });
+            res.json({ success: true, id: request.id });
+        }
+        catch (error) {
+            logger.debug('Permission notification failed', {
+                requestId,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            next(error);
+        }
+    });
+    // Get suggested patterns for a tool invocation
+    // Called by frontend to show pattern options in the permission banner
+    // Uses LLM (Haiku) for intelligent suggestions, with heuristic fallback
+    router.post('/suggest-patterns', async (req, res, next) => {
+        const requestId = req.requestId;
+        const permissionLog = getPermissionEventLog();
+        const startTime = Date.now();
+        try {
+            const { toolName, toolInput, useLLM = true } = req.body;
+            if (!toolName) {
+                throw new LatticeError('MISSING_TOOL_NAME', 'toolName is required', 400);
+            }
+            let patterns;
+            let source;
+            // Try LLM-powered suggestions first (if enabled and configured)
+            if (useLLM && anthropicService.isConfigured()) {
+                try {
+                    const llmPatterns = await anthropicService.suggestPermissionPatterns(toolName, toolInput || {});
+                    if (llmPatterns.length > 0) {
+                        patterns = llmPatterns;
+                        source = 'llm';
+                        // Log structured event
+                        permissionLog.patternSuggest({
+                            toolName,
+                            toolInput,
+                            suggestedPatterns: patterns,
+                            suggestionSource: 'llm',
+                            durationMs: Date.now() - startTime,
+                        });
+                        res.json({ patterns, source });
+                        return;
+                    }
+                }
+                catch (llmError) {
+                    logger.debug('LLM pattern suggestion failed, falling back to heuristic', {
+                        requestId,
+                        error: llmError instanceof Error ? llmError.message : String(llmError)
+                    });
+                }
+            }
+            // Fallback to heuristic-based suggestions
+            patterns = suggestPatterns(toolName, toolInput || {});
+            source = 'heuristic';
+            // Log structured event
+            permissionLog.patternSuggest({
+                toolName,
+                toolInput,
+                suggestedPatterns: patterns,
+                suggestionSource: 'heuristic',
+                durationMs: Date.now() - startTime,
+            });
+            res.json({ patterns, source });
+        }
+        catch (error) {
+            next(error);
+        }
+    });
+    // Add pattern to session allowlist
+    // Accepts either `pattern` (new) or `toolName` (legacy, for backwards compat)
+    router.post('/allowlist/session', async (req, res, next) => {
+        const permissionLog = getPermissionEventLog();
+        try {
+            const { pattern, toolName, streamingId } = req.body;
+            const effectivePattern = pattern || toolName; // Support both new and old API
+            if (!effectivePattern || !streamingId) {
+                throw new LatticeError('MISSING_PARAMS', 'pattern (or toolName) and streamingId are required', 400);
+            }
+            addToSessionAllowlist(streamingId, effectivePattern);
+            // Log structured event
+            permissionLog.allowlistAdd({
+                pattern: effectivePattern,
+                scope: 'session',
+                streamingId,
+            });
+            res.json({ success: true, pattern: effectivePattern });
+        }
+        catch (error) {
+            next(error);
+        }
+    });
+    // Add pattern to global allowlist
+    // Accepts either `pattern` (new) or `toolName` (legacy, for backwards compat)
+    router.post('/allowlist/global', async (req, res, next) => {
+        const permissionLog = getPermissionEventLog();
+        try {
+            const { pattern, toolName } = req.body;
+            const effectivePattern = pattern || toolName; // Support both new and old API
+            if (!effectivePattern) {
+                throw new LatticeError('MISSING_PARAMS', 'pattern (or toolName) is required', 400);
+            }
+            addToGlobalAllowlist(effectivePattern);
+            // Log structured event
+            permissionLog.allowlistAdd({
+                pattern: effectivePattern,
+                scope: 'global',
+            });
+            res.json({ success: true, pattern: effectivePattern });
+        }
+        catch (error) {
+            next(error);
+        }
+    });
+    // Get current allowlists
+    router.get('/allowlist', async (req, res) => {
+        const { streamingId } = req.query;
+        const global = loadGlobalAllowlist();
+        const session = streamingId ? Array.from(sessionAllowlists.get(streamingId) || []) : [];
+        res.json({ global, session });
+    });
+    // Get permission event log (for debugging and monitoring)
+    router.get('/events', async (req, res) => {
+        const permissionLog = getPermissionEventLog();
+        const { streamingId, limit = '50', format = 'json' } = req.query;
+        const limitNum = Math.min(parseInt(limit, 10) || 50, 200);
+        if (format === 'timeline') {
+            // Return human-readable timeline
+            const timeline = streamingId
+                ? permissionLog.getForSession(streamingId, limitNum).map(e => {
+                    const time = new Date(e.timestamp).toISOString().slice(11, 19);
+                    return `${time} ${e.eventType}: ${e.toolName}${e.matchedPattern ? ` [${e.matchedPattern}]` : ''}`;
+                })
+                : permissionLog.getTimeline(limitNum);
+            res.json({ timeline });
+        }
+        else {
+            // Return structured events
+            const events = streamingId
+                ? permissionLog.getForSession(streamingId, limitNum)
+                : permissionLog.getAll(limitNum);
+            res.json({ events });
+        }
+    });
+    // Get permission pattern statistics
+    router.get('/events/stats', async (req, res) => {
+        const permissionLog = getPermissionEventLog();
+        const stats = permissionLog.getPatternStats();
+        res.json(stats);
+    });
+    // List permissions
+    router.get('/', async (req, res, next) => {
+        const requestId = req.requestId;
+        logger.debug('List permissions request', {
+            requestId,
+            query: req.query
+        });
+        try {
+            const { streamingId, status } = req.query;
+            const permissions = permissionTracker.getPermissionRequests({ streamingId, status });
+            logger.debug('Permissions listed successfully', {
+                requestId,
+                count: permissions.length,
+                filter: { streamingId, status }
+            });
+            res.json({ permissions });
+        }
+        catch (error) {
+            logger.debug('List permissions failed', {
+                requestId,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            next(error);
+        }
+    });
+    // Permission decision endpoint - called by frontend to approve/deny permissions
+    router.post('/:requestId/decision', async (req, res, next) => {
+        const requestIdHeader = req.requestId;
+        const { requestId } = req.params;
+        const decisionRequest = req.body;
+        const permissionLog = getPermissionEventLog();
+        logger.debug('Permission decision request', {
+            requestId: requestIdHeader,
+            permissionRequestId: requestId,
+            decision: decisionRequest
+        });
+        try {
+            // Validate request body
+            if (!decisionRequest.action || !['approve', 'deny'].includes(decisionRequest.action)) {
+                throw new LatticeError('INVALID_ACTION', 'Action must be either "approve" or "deny"', 400);
+            }
+            // Get the permission request to validate it exists and is pending
+            const permissions = permissionTracker.getPermissionRequests({ status: 'pending' });
+            const permission = permissions.find(p => p.id === requestId);
+            if (!permission) {
+                throw new LatticeError('PERMISSION_NOT_FOUND', 'Permission request not found or not pending', 404);
+            }
+            // Update permission status
+            let updated;
+            if (decisionRequest.action === 'approve') {
+                updated = permissionTracker.updatePermissionStatus(requestId, 'approved', { modifiedInput: decisionRequest.modifiedInput });
+            }
+            else {
+                updated = permissionTracker.updatePermissionStatus(requestId, 'denied', { denyReason: decisionRequest.denyReason });
+            }
+            if (!updated) {
+                throw new LatticeError('UPDATE_FAILED', 'Failed to update permission status', 500);
+            }
+            // Log structured event
+            permissionLog.decision({
+                permissionRequestId: requestId,
+                toolName: permission.toolName,
+                decision: decisionRequest.action,
+                denyReason: decisionRequest.denyReason,
+                streamingId: permission.streamingId,
+            });
+            const response = {
+                success: true,
+                message: `Permission ${decisionRequest.action === 'approve' ? 'approved' : 'denied'} successfully`
+            };
+            res.json(response);
+        }
+        catch (error) {
+            logger.debug('Permission decision failed', {
+                requestId: requestIdHeader,
+                permissionRequestId: requestId,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            next(error);
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=permission.routes.js.map

package/dist/routes/permission.routes.js.map

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

package/dist/routes/process-events.routes.d.ts

@@ -0,0 +1,9 @@
+/**
+ * API routes for process event log observability.
+ *
+ * Provides endpoints to query Claude process lifecycle events for debugging.
+ */
+import { Router } from 'express';
+declare const router: Router;
+export default router;
+//# sourceMappingURL=process-events.routes.d.ts.map

package/dist/routes/process-events.routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-events.routes.d.ts","sourceRoot":"","sources":["../../src/routes/process-events.routes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAA+B,MAAM,SAAS,CAAC;AAG9D,QAAA,MAAM,MAAM,EAAE,MAAiB,CAAC;AAmJhC,eAAe,MAAM,CAAC"}

package/dist/routes/process-events.routes.js

@@ -0,0 +1,141 @@
+/**
+ * API routes for process event log observability.
+ *
+ * Provides endpoints to query Claude process lifecycle events for debugging.
+ */
+import { Router } from 'express';
+import { getProcessEventLog } from '../services/process/process-event-log.js';
+const router = Router();
+/**
+ * GET /api/process-events
+ * Get recent process events across all streams.
+ *
+ * Query params:
+ *   limit: number of events to return (default 100)
+ */
+router.get('/', (_req, res) => {
+    const limit = parseInt(_req.query.limit) || 100;
+    const log = getProcessEventLog();
+    const events = log.getAll(limit);
+    res.json({ events });
+});
+/**
+ * GET /api/process-events/summary
+ * Get lifecycle summary statistics.
+ */
+router.get('/summary', (_req, res) => {
+    const log = getProcessEventLog();
+    const summary = log.getLifecycleSummary();
+    res.json(summary);
+});
+/**
+ * GET /api/process-events/active
+ * Get all currently active processes.
+ */
+router.get('/active', (_req, res) => {
+    const log = getProcessEventLog();
+    const active = log.getActiveProcesses();
+    res.json({ processes: active });
+});
+/**
+ * GET /api/process-events/exits
+ * Get recent process exits.
+ *
+ * Query params:
+ *   limit: number of events to return (default 20)
+ */
+router.get('/exits', (_req, res) => {
+    const limit = parseInt(_req.query.limit) || 20;
+    const log = getProcessEventLog();
+    const exits = log.getRecentExits(limit);
+    res.json({ events: exits });
+});
+/**
+ * GET /api/process-events/errors
+ * Get recent error events.
+ *
+ * Query params:
+ *   limit: number of events to return (default 20)
+ */
+router.get('/errors', (_req, res) => {
+    const limit = parseInt(_req.query.limit) || 20;
+    const log = getProcessEventLog();
+    const errors = log.getRecentErrors(limit);
+    res.json({ events: errors });
+});
+/**
+ * GET /api/process-events/stream/:streamingId
+ * Get events for a specific streaming ID.
+ *
+ * Query params:
+ *   format: 'json' | 'timeline' (default 'json')
+ *   limit: number of events to return (default 50)
+ */
+router.get('/stream/:streamingId', (req, res) => {
+    const { streamingId } = req.params;
+    const format = req.query.format || 'json';
+    const limit = parseInt(req.query.limit) || 50;
+    const log = getProcessEventLog();
+    if (format === 'timeline') {
+        const timeline = log.getTimeline(streamingId, limit);
+        res.json({ timeline });
+    }
+    else {
+        const events = log.getForStreamingId(streamingId, limit);
+        const state = log.getProcessState(streamingId);
+        res.json({ events, state });
+    }
+});
+/**
+ * GET /api/process-events/session/:sessionId
+ * Get events for a specific Claude session ID.
+ *
+ * Query params:
+ *   limit: number of events to return (default 50)
+ */
+router.get('/session/:sessionId', (req, res) => {
+    const { sessionId } = req.params;
+    const limit = parseInt(req.query.limit) || 50;
+    const log = getProcessEventLog();
+    const events = log.getForSessionId(sessionId, limit);
+    res.json({ events });
+});
+/**
+ * GET /api/process-events/trace/:traceId
+ * Get all events for a specific trace ID.
+ */
+router.get('/trace/:traceId', (req, res) => {
+    const { traceId } = req.params;
+    const log = getProcessEventLog();
+    const events = log.getByTraceId(traceId);
+    res.json({ events });
+});
+/**
+ * GET /api/process-events/type/:eventType
+ * Get events by type.
+ *
+ * Query params:
+ *   limit: number of events to return (default 50)
+ */
+router.get('/type/:eventType', (req, res) => {
+    const { eventType } = req.params;
+    const limit = parseInt(req.query.limit) || 50;
+    const log = getProcessEventLog();
+    const events = log.getByType(eventType, limit);
+    res.json({ events });
+});
+/**
+ * GET /api/process-events/states
+ * Get all process states (including exited).
+ *
+ * Query params:
+ *   limit: number of states to return (default 50)
+ */
+router.get('/states', (_req, res) => {
+    const limit = parseInt(_req.query.limit) || 50;
+    const log = getProcessEventLog();
+    const states = log.getAllProcessStates(limit);
+    res.json({ states });
+});
+export default router;
+//# sourceMappingURL=process-events.routes.js.map

package/dist/routes/process-events.routes.js.map

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

package/dist/routes/prototype.routes.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Prototype routes - experimental features for testing and development.
+ *
+ * In production builds, these routes are gated and return 404 by default.
+ * They can be enabled by setting CLAUDIA_ENABLE_PROTOTYPES=true.
+ */
+import { Router } from 'express';
+export declare function createPrototypeRoutes(): Router;
+//# sourceMappingURL=prototype.routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prototype.routes.d.ts","sourceRoot":"","sources":["../../src/routes/prototype.routes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAA0B,MAAM,SAAS,CAAC;AA+IzD,wBAAgB,qBAAqB,IAAI,MAAM,CAyrB9C"}