lattice-orchestrator 0.7.0

package/dist/services/web-push-service.js

@@ -0,0 +1,186 @@
+import fs from 'fs';
+import path from 'path';
+import Database from 'better-sqlite3';
+import webpush from 'web-push';
+import { createLogger } from './infrastructure/logger.js';
+import { ConfigService } from './infrastructure/config-service.js';
+import { CONFIG_DIR } from '../utils/constants.js';
+export class WebPushService {
+    static instance;
+    logger;
+    db;
+    dbPath;
+    configDir;
+    isInitialized = false;
+    configService;
+    insertStmt;
+    deleteStmt;
+    upsertSeenStmt;
+    listStmt;
+    countStmt;
+    constructor(customConfigDir) {
+        this.logger = createLogger('WebPushService');
+        this.configService = ConfigService.getInstance();
+        this.initializePaths(customConfigDir);
+    }
+    static getInstance() {
+        if (!WebPushService.instance) {
+            WebPushService.instance = new WebPushService();
+        }
+        return WebPushService.instance;
+    }
+    initializePaths(customConfigDir) {
+        const baseConfigDir = customConfigDir || CONFIG_DIR;
+        this.configDir = baseConfigDir;
+        this.dbPath = path.join(baseConfigDir, 'web-push.db');
+        this.logger.debug('Initialized web push database paths', {
+            dir: this.configDir,
+            dbPath: this.dbPath,
+        });
+    }
+    async initialize() {
+        if (this.isInitialized)
+            return;
+        try {
+            if (this.dbPath !== ':memory:' && !fs.existsSync(this.configDir)) {
+                fs.mkdirSync(this.configDir, { recursive: true });
+            }
+            this.db = new Database(this.dbPath);
+            this.db.pragma('journal_mode = WAL');
+            this.db.exec(`
+        CREATE TABLE IF NOT EXISTS subscriptions (
+          endpoint TEXT PRIMARY KEY,
+          p256dh TEXT NOT NULL,
+          auth TEXT NOT NULL,
+          user_agent TEXT NOT NULL DEFAULT '',
+          created_at TEXT NOT NULL,
+          last_seen TEXT NOT NULL,
+          expired INTEGER NOT NULL DEFAULT 0
+        );
+      `);
+            this.prepareStatements();
+            this.configureVapid();
+            this.isInitialized = true;
+        }
+        catch (error) {
+            this.logger.error('Failed to initialize web push database', error);
+            throw new Error(`WebPush database initialization failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    prepareStatements() {
+        this.insertStmt = this.db.prepare('INSERT OR REPLACE INTO subscriptions (endpoint, p256dh, auth, user_agent, created_at, last_seen, expired) VALUES (?, ?, ?, ?, COALESCE((SELECT created_at FROM subscriptions WHERE endpoint = ?), ?), ?, 0)');
+        this.deleteStmt = this.db.prepare('DELETE FROM subscriptions WHERE endpoint = ?');
+        this.upsertSeenStmt = this.db.prepare('UPDATE subscriptions SET last_seen = ?, expired = ? WHERE endpoint = ?');
+        this.listStmt = this.db.prepare('SELECT * FROM subscriptions WHERE expired = 0');
+        this.countStmt = this.db.prepare('SELECT COUNT(*) as count FROM subscriptions WHERE expired = 0');
+    }
+    configureVapid() {
+        const config = this.configService.getConfig();
+        let subject = config.interface.notifications?.webPush?.subject || 'mailto:admin@example.com';
+        let publicKey = config.interface.notifications?.webPush?.vapidPublicKey;
+        let privateKey = config.interface.notifications?.webPush?.vapidPrivateKey;
+        // Auto-generate VAPID keys if missing and notifications enabled
+        let generated = false;
+        if (this.getEnabled() && (!publicKey || !privateKey)) {
+            try {
+                const keys = webpush.generateVAPIDKeys();
+                publicKey = keys.publicKey;
+                privateKey = keys.privateKey;
+                // Persist into config (partial update preserves other interface fields)
+                void this.configService.updateConfig({
+                    interface: {
+                        ...config.interface,
+                        notifications: {
+                            ...(config.interface.notifications || { enabled: true }),
+                            webPush: {
+                                subject,
+                                vapidPublicKey: publicKey,
+                                vapidPrivateKey: privateKey,
+                            },
+                        },
+                    },
+                }).catch((_err) => {
+                    this.logger.warn('Failed to persist generated VAPID keys to config');
+                });
+                this.logger.info('Generated and applied VAPID keys');
+                generated = true;
+            }
+            catch (_e) {
+                this.logger.error('Failed to generate VAPID keys');
+            }
+        }
+        if (!publicKey || !privateKey) {
+            this.logger.warn('Web Push VAPID keys are not configured. Native push will be disabled until set in config');
+            return;
+        }
+        webpush.setVapidDetails(subject, publicKey, privateKey);
+        // If keys were generated just now, expire existing subscriptions to force re-register
+        if (generated) {
+            try {
+                this.db.prepare('UPDATE subscriptions SET expired = 1').run();
+                this.logger.info('Expired all existing web push subscriptions due to VAPID key generation');
+            }
+            catch (_e) {
+                this.logger.warn('Failed to expire existing subscriptions after VAPID key generation');
+            }
+        }
+    }
+    getPublicKey() {
+        const publicKey = this.configService.getConfig().interface.notifications?.webPush?.vapidPublicKey || null;
+        return publicKey || null;
+    }
+    getEnabled() {
+        const enabled = this.configService.getConfig().interface.notifications?.enabled ?? false;
+        return enabled;
+    }
+    getSubscriptionCount() {
+        const row = this.countStmt.get();
+        return row?.count || 0;
+    }
+    addOrUpdateSubscription(subscription, userAgent = '') {
+        const now = new Date().toISOString();
+        const { endpoint, keys } = subscription;
+        if (!endpoint || !keys?.p256dh || !keys?.auth) {
+            throw new Error('Invalid subscription payload: missing endpoint/keys');
+        }
+        this.insertStmt.run(endpoint, keys.p256dh, keys.auth, userAgent || '', endpoint, now, now);
+    }
+    removeSubscriptionByEndpoint(endpoint) {
+        this.deleteStmt.run(endpoint);
+    }
+    listSubscriptions() {
+        return this.listStmt.all();
+    }
+    async broadcast(payload) {
+        await this.initialize();
+        const subs = this.listSubscriptions();
+        let sent = 0;
+        let failed = 0;
+        await Promise.all(subs.map(async (row) => {
+            const sub = {
+                endpoint: row.endpoint,
+                expirationTime: null,
+                keys: { p256dh: row.p256dh, auth: row.auth },
+            };
+            try {
+                await webpush.sendNotification(sub, JSON.stringify(payload), { TTL: 60 });
+                this.upsertSeenStmt.run(new Date().toISOString(), 0, row.endpoint);
+                sent += 1;
+            }
+            catch (_err) {
+                failed += 1;
+                // 410 Gone or 404 Not Found => expire subscription
+                const status = undefined;
+                if (status === 404 || status === 410) {
+                    this.upsertSeenStmt.run(new Date().toISOString(), 1, row.endpoint);
+                    this.logger.info('Expired web push subscription removed', { endpoint: row.endpoint, status });
+                }
+                else {
+                    this.logger.error('Failed sending web push notification', { endpoint: row.endpoint, statusCode: status });
+                }
+            }
+        }));
+        return { sent, failed };
+    }
+}
+//# sourceMappingURL=web-push-service.js.map

package/dist/services/web-push-service.js.map

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

package/dist/services/working-directories-service.d.ts

@@ -0,0 +1,19 @@
+import { WorkingDirectoriesResponse } from '../types/index.js';
+import { ClaudeHistoryReader } from './sessions/claude-history-reader.js';
+import { Logger } from './infrastructure/logger.js';
+export declare class WorkingDirectoriesService {
+    private historyReader;
+    private logger;
+    constructor(historyReader: ClaudeHistoryReader, logger: Logger);
+    getWorkingDirectories(): Promise<WorkingDirectoriesResponse>;
+    /**
+     * Compute shortest unique suffixes for a list of paths
+     *
+     * Examples:
+     * - ["/home/alice/project", "/home/bob/project"] -> ["alice/project", "bob/project"]
+     * - ["/home/user/web", "/home/user/api"] -> ["web", "api"]
+     * - ["/single/path"] -> ["path"]
+     */
+    private computeShortnames;
+}
+//# sourceMappingURL=working-directories-service.d.ts.map

package/dist/services/working-directories-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"working-directories-service.d.ts","sourceRoot":"","sources":["../../src/services/working-directories-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEpD,qBAAa,yBAAyB;IAIlC,OAAO,CAAC,aAAa;IAHvB,OAAO,CAAC,MAAM,CAAS;gBAGb,aAAa,EAAE,mBAAmB,EAC1C,MAAM,EAAE,MAAM;IAKV,qBAAqB,IAAI,OAAO,CAAC,0BAA0B,CAAC;IA8DlE;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;CA8C1B"}

package/dist/services/working-directories-service.js

@@ -0,0 +1,103 @@
+export class WorkingDirectoriesService {
+    historyReader;
+    logger;
+    constructor(historyReader, logger) {
+        this.historyReader = historyReader;
+        this.logger = logger.child({ component: 'WorkingDirectoriesService' });
+    }
+    async getWorkingDirectories() {
+        try {
+            // Get all conversations from history
+            const { conversations } = await this.historyReader.listConversations();
+            // Build directory map with metadata
+            const directoryMap = new Map();
+            for (const conversation of conversations) {
+                const path = conversation.projectPath;
+                if (!path)
+                    continue;
+                const existing = directoryMap.get(path);
+                const conversationDate = new Date(conversation.updatedAt);
+                if (!existing || conversationDate > existing.lastDate) {
+                    directoryMap.set(path, {
+                        lastDate: conversationDate,
+                        count: (existing?.count || 0) + 1
+                    });
+                }
+                else {
+                    existing.count++;
+                }
+            }
+            // Convert to array and compute shortnames
+            const paths = Array.from(directoryMap.keys());
+            const shortnames = this.computeShortnames(paths);
+            // Build response
+            const directories = [];
+            for (const [path, metadata] of directoryMap.entries()) {
+                directories.push({
+                    path,
+                    shortname: shortnames.get(path) || path.split('/').pop() || path,
+                    lastDate: metadata.lastDate.toISOString().replace(/\.\d{3}Z$/, 'Z'), // Remove milliseconds for consistency
+                    conversationCount: metadata.count
+                });
+            }
+            // Sort by lastDate descending
+            directories.sort((a, b) => new Date(b.lastDate).getTime() - new Date(a.lastDate).getTime());
+            this.logger.debug('Retrieved working directories', {
+                totalDirectories: directories.length
+            });
+            return {
+                directories,
+                totalCount: directories.length
+            };
+        }
+        catch (error) {
+            this.logger.error('Failed to get working directories', error);
+            throw error;
+        }
+    }
+    /**
+     * Compute shortest unique suffixes for a list of paths
+     *
+     * Examples:
+     * - ["/home/alice/project", "/home/bob/project"] -> ["alice/project", "bob/project"]
+     * - ["/home/user/web", "/home/user/api"] -> ["web", "api"]
+     * - ["/single/path"] -> ["path"]
+     */
+    computeShortnames(paths) {
+        const result = new Map();
+        // Handle edge cases
+        if (paths.length === 0)
+            return result;
+        if (paths.length === 1) {
+            const segments = paths[0].split('/').filter(s => s);
+            result.set(paths[0], segments[segments.length - 1] || paths[0]);
+            return result;
+        }
+        // Split all paths into segments
+        const pathSegments = paths.map(path => ({
+            path,
+            segments: path.split('/').filter(s => s)
+        }));
+        // For each path, find the shortest unique suffix
+        for (const { path, segments } of pathSegments) {
+            let suffixLength = 1;
+            let shortname = '';
+            // Keep adding segments until we have a unique suffix
+            while (suffixLength <= segments.length) {
+                const suffix = segments.slice(-suffixLength).join('/');
+                // Check if this suffix is unique among all paths
+                const isUnique = pathSegments.every(other => other.path === path ||
+                    other.segments.slice(-suffixLength).join('/') !== suffix);
+                if (isUnique) {
+                    shortname = suffix;
+                    break;
+                }
+                suffixLength++;
+            }
+            // If we couldn't find a unique suffix (shouldn't happen), use full path
+            result.set(path, shortname || path);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=working-directories-service.js.map

package/dist/services/working-directories-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"working-directories-service.js","sourceRoot":"","sources":["../../src/services/working-directories-service.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,yBAAyB;IAI1B;IAHF,MAAM,CAAS;IAEvB,YACU,aAAkC,EAC1C,MAAc;QADN,kBAAa,GAAb,aAAa,CAAqB;QAG1C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,2BAA2B,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,qBAAqB;QACzB,IAAI,CAAC;YACH,qCAAqC;YACrC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,iBAAiB,EAAE,CAAC;YAEvE,oCAAoC;YACpC,MAAM,YAAY,GAAG,IAAI,GAAG,EAGxB,CAAC;YAEL,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;gBACzC,MAAM,IAAI,GAAG,YAAY,CAAC,WAAW,CAAC;gBACtC,IAAI,CAAC,IAAI;oBAAE,SAAS;gBAEpB,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACxC,MAAM,gBAAgB,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;gBAE1D,IAAI,CAAC,QAAQ,IAAI,gBAAgB,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC;oBACtD,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE;wBACrB,QAAQ,EAAE,gBAAgB;wBAC1B,KAAK,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC;qBAClC,CAAC,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACN,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACnB,CAAC;YACH,CAAC;YAED,0CAA0C;YAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;YAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAEjD,iBAAiB;YACjB,MAAM,WAAW,GAAuB,EAAE,CAAC;YAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC;gBACtD,WAAW,CAAC,IAAI,CAAC;oBACf,IAAI;oBACJ,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI;oBAChE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,sCAAsC;oBAC3G,iBAAiB,EAAE,QAAQ,CAAC,KAAK;iBAClC,CAAC,CAAC;YACL,CAAC;YAED,8BAA8B;YAC9B,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACxB,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAChE,CAAC;YAEF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE;gBACjD,gBAAgB,EAAE,WAAW,CAAC,MAAM;aACrC,CAAC,CAAC;YAEH,OAAO;gBACL,WAAW;gBACX,UAAU,EAAE,WAAW,CAAC,MAAM;aAC/B,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;YAC9D,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACK,iBAAiB,CAAC,KAAe;QACvC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;QAEzC,oBAAoB;QACpB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC;QACtC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACpD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAChE,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,gCAAgC;QAChC,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACtC,IAAI;YACJ,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;SACzC,CAAC,CAAC,CAAC;QAEJ,iDAAiD;QACjD,KAAK,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,YAAY,EAAE,CAAC;YAC9C,IAAI,YAAY,GAAG,CAAC,CAAC;YACrB,IAAI,SAAS,GAAG,EAAE,CAAC;YAEnB,qDAAqD;YACrD,OAAO,YAAY,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACvC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAEvD,iDAAiD;gBACjD,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAC1C,KAAK,CAAC,IAAI,KAAK,IAAI;oBACnB,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,MAAM,CACzD,CAAC;gBAEF,IAAI,QAAQ,EAAE,CAAC;oBACb,SAAS,GAAG,MAAM,CAAC;oBACnB,MAAM;gBACR,CAAC;gBAED,YAAY,EAAE,CAAC;YACjB,CAAC;YAED,wEAAwE;YACxE,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,IAAI,IAAI,CAAC,CAAC;QACtC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/types/config.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Configuration types for CUI
+ */
+import { RouterConfiguration } from './router-config.js';
+/** Canonical permission modes for Claude sessions */
+export declare const PERMISSION_MODES: readonly ["default", "acceptEdits", "bypassPermissions", "plan"];
+export type PermissionMode = typeof PERMISSION_MODES[number];
+export interface ServerConfig {
+    host: string;
+    port: number;
+    /**
+     * Default working directory for new Claude sessions
+     * Falls back to user's home directory if not specified
+     */
+    defaultWorkingDirectory?: string;
+    /**
+     * Default permission mode for new Claude sessions
+     * 'default' = ask for permissions, 'acceptEdits' = auto-accept edits,
+     * 'bypassPermissions' = skip all prompts, 'plan' = plan only mode
+     */
+    defaultPermissionMode?: PermissionMode;
+    /**
+     * Custom system prompt injected into all Claude sessions spawned by Claudia.
+     * This is appended to Claude's default system prompt via --system-prompt.
+     * Use this for global instructions, persona customization, or project context.
+     */
+    systemPrompt?: string;
+}
+export interface GeminiConfig {
+    /**
+     * Google API key for Gemini
+     * Can also be set via GOOGLE_API_KEY environment variable
+     */
+    apiKey?: string;
+    /**
+     * Gemini model to use
+     * Default: 'gemini-2.5-flash'
+     */
+    model?: string;
+}
+export interface AnthropicConfig {
+    /**
+     * Anthropic API key
+     * Can also be set via ANTHROPIC_API_KEY environment variable
+     */
+    apiKey?: string;
+    /**
+     * Claude model to use for full insight generation (expensive, high quality)
+     * @deprecated Use models.generation instead
+     * Default: 'claude-sonnet-4-5-20250929'
+     */
+    model?: string;
+    /**
+     * Model configuration for the insights system.
+     * Allows fine-tuning which models are used for different operations.
+     * See DEFAULT_MODELS in anthropic-service.ts for actual defaults.
+     */
+    models?: {
+        /** Full insight generation - needs high capability. Default: sonnet */
+        generation?: string;
+        /** Quick staleness checks - needs speed. Default: haiku */
+        quickCheck?: string;
+        /** Fast patch generation - speed over quality. Default: haiku */
+        patch?: string;
+        /** Full patch generation (fallback when fast path fails). Default: haiku */
+        fullPatch?: string;
+        /** Proposition extraction - factual extraction. Default: haiku */
+        propositions?: string;
+    };
+}
+export interface InterfaceConfig {
+    colorScheme: 'light' | 'dark' | 'system';
+    language: string;
+    /**
+     * Enable developer mode (shows prototypes, debug tools)
+     * Only set to true on your local development machine
+     */
+    devMode?: boolean;
+    notifications?: {
+        enabled: boolean;
+        ntfyUrl?: string;
+        webPush?: {
+            subject?: string;
+            vapidPublicKey?: string;
+            vapidPrivateKey?: string;
+        };
+    };
+}
+export interface CUIConfig {
+    /**
+     * Unique machine identifier
+     * Format: {hostname}-{16char_hash}
+     * Example: "wenbomacbook-a1b2c3d4e5f6g7h8"
+     */
+    machine_id: string;
+    /**
+     * Server configuration
+     */
+    server: ServerConfig;
+    /**
+     * Gemini API configuration (optional)
+     */
+    gemini?: GeminiConfig;
+    /**
+     * Anthropic API configuration (optional)
+     * Used for session insights extraction with Opus 4.5
+     */
+    anthropic?: AnthropicConfig;
+    /**
+     * Optional router configuration for Claude Code Router
+     */
+    router?: RouterConfiguration;
+    /**
+     * Interface preferences and settings
+     */
+    interface: InterfaceConfig;
+}
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_CONFIG: Omit<CUIConfig, 'machine_id'>;
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAQzD,qDAAqD;AACrD,eAAO,MAAM,gBAAgB,kEAAmE,CAAC;AACjG,MAAM,MAAM,cAAc,GAAG,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAE7D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,cAAc,CAAC;IACvC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,MAAM,CAAC,EAAE;QACP,uEAAuE;QACvE,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,2DAA2D;QAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,iEAAiE;QACjE,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,4EAA4E;QAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,kEAAkE;QAClE,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE;QACd,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE;YACR,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,cAAc,CAAC,EAAE,MAAM,CAAC;YACxB,eAAe,CAAC,EAAE,MAAM,CAAC;SAC1B,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,EAAE,YAAY,CAAC;IAErB;;OAEG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB;;;OAGG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAE5B;;OAEG;IACH,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAE7B;;OAEG;IACH,SAAS,EAAE,eAAe,CAAC;CAC5B;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,IAAI,CAAC,SAAS,EAAE,YAAY,CASxD,CAAC"}

package/dist/types/config.js

@@ -0,0 +1,21 @@
+// ============================================================
+// Permission Modes - Single Source of Truth
+// ============================================================
+// Used by: ServerConfig type, conversation.routes.ts validation
+// When updating, grep for PERMISSION_MODES to find all usages.
+/** Canonical permission modes for Claude sessions */
+export const PERMISSION_MODES = ['default', 'acceptEdits', 'bypassPermissions', 'plan'];
+/**
+ * Default configuration values
+ */
+export const DEFAULT_CONFIG = {
+    server: {
+        host: 'localhost',
+        port: 3001
+    },
+    interface: {
+        colorScheme: 'system',
+        language: 'en'
+    }
+};
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAKA,+DAA+D;AAC/D,4CAA4C;AAC5C,+DAA+D;AAC/D,gEAAgE;AAChE,+DAA+D;AAE/D,qDAAqD;AACrD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,SAAS,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,CAAU,CAAC;AA8HjG;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAkC;IAC3D,MAAM,EAAE;QACN,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,IAAI;KACX;IACD,SAAS,EAAE;QACT,WAAW,EAAE,QAAQ;QACrB,QAAQ,EAAE,IAAI;KACf;CACF,CAAC"}

package/dist/types/express.d.ts

@@ -0,0 +1,5 @@
+import { Request } from 'express';
+export interface RequestWithRequestId extends Request {
+    requestId?: string;
+}
+//# sourceMappingURL=express.d.ts.map

package/dist/types/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../src/types/express.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,MAAM,WAAW,oBAAqB,SAAQ,OAAO;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/types/express.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=express.js.map

package/dist/types/express.js.map

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