lattice-orchestrator 0.7.0

package/dist/services/commands-service.d.ts

@@ -0,0 +1,20 @@
+export interface Command {
+    name: string;
+    type: 'builtin' | 'custom';
+    description?: string;
+    argumentHint?: string;
+}
+/**
+ * Get hardcoded builtin commands
+ */
+export declare function getBuiltinCommands(): Command[];
+/**
+ * Get custom commands from .claude/commands/ directories
+ * Parses YAML frontmatter for description and argument-hint
+ */
+export declare function getCustomCommands(workingDirectory?: string): Command[];
+/**
+ * Get all available commands (builtin + custom)
+ */
+export declare function getAvailableCommands(workingDirectory?: string): Command[];
+//# sourceMappingURL=commands-service.d.ts.map

package/dist/services/commands-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands-service.d.ts","sourceRoot":"","sources":["../../src/services/commands-service.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAsDD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,EAAE,CAS9C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE,CA0CtE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE,CAMzE"}

package/dist/services/commands-service.js

@@ -0,0 +1,115 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { createLogger } from './infrastructure/logger.js';
+const logger = createLogger('CommandsService');
+/**
+ * Parse YAML frontmatter from a markdown file
+ * Returns { description, argumentHint } or empty object if no frontmatter
+ */
+function parseYamlFrontmatter(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        // Check if file starts with frontmatter
+        if (!content.startsWith('---')) {
+            return {};
+        }
+        // Find the closing ---
+        const endIndex = content.indexOf('---', 3);
+        if (endIndex === -1) {
+            return {};
+        }
+        const frontmatter = content.substring(3, endIndex).trim();
+        const result = {};
+        // Simple line-by-line parsing (avoiding yaml dependency)
+        for (const line of frontmatter.split('\n')) {
+            const colonIndex = line.indexOf(':');
+            if (colonIndex === -1)
+                continue;
+            const key = line.substring(0, colonIndex).trim();
+            let value = line.substring(colonIndex + 1).trim();
+            // Remove quotes if present
+            if ((value.startsWith('"') && value.endsWith('"')) ||
+                (value.startsWith("'") && value.endsWith("'"))) {
+                value = value.slice(1, -1);
+            }
+            if (key === 'description') {
+                result.description = value;
+            }
+            else if (key === 'argument-hint') {
+                result.argumentHint = value;
+            }
+        }
+        return result;
+    }
+    catch (error) {
+        logger.debug('Failed to parse frontmatter', { filePath, error: error instanceof Error ? error.message : String(error) });
+        return {};
+    }
+}
+/**
+ * Get hardcoded builtin commands
+ */
+export function getBuiltinCommands() {
+    return [
+        { name: '/add-dir', type: 'builtin', description: 'Add a new working directory' },
+        { name: '/clear', type: 'builtin', description: 'Clear conversation history and free up context' },
+        { name: '/compact', type: 'builtin', description: 'Clear conversation history but keep a summary in context' },
+        { name: '/init', type: 'builtin', description: 'Initialize a new CLAUDE.md file with codebase documentation' },
+        { name: '/model', type: 'builtin', description: 'Set the AI model for Claude Code' },
+        { name: '/permissions', type: 'builtin', description: 'Manage allow & deny tool permission rules' }
+    ];
+}
+/**
+ * Get custom commands from .claude/commands/ directories
+ * Parses YAML frontmatter for description and argument-hint
+ */
+export function getCustomCommands(workingDirectory) {
+    const commands = new Map();
+    // Helper to process a directory
+    const processDirectory = (dir) => {
+        try {
+            if (!fs.existsSync(dir))
+                return;
+            const files = fs.readdirSync(dir);
+            for (const file of files) {
+                if (file.endsWith('.md')) {
+                    const commandName = '/' + file.slice(0, -3); // Remove .md extension
+                    const filePath = path.join(dir, file);
+                    const frontmatter = parseYamlFrontmatter(filePath);
+                    commands.set(commandName, {
+                        name: commandName,
+                        type: 'custom',
+                        description: frontmatter.description,
+                        argumentHint: frontmatter.argumentHint,
+                    });
+                }
+            }
+        }
+        catch (error) {
+            logger.warn('Failed to read commands directory', {
+                error: error instanceof Error ? error.message : String(error),
+                path: dir
+            });
+        }
+    };
+    // Always check global directory first
+    const globalDir = path.join(os.homedir(), '.claude', 'commands');
+    processDirectory(globalDir);
+    // Check local directory if provided (overrides global)
+    if (workingDirectory) {
+        const localDir = path.join(workingDirectory, '.claude', 'commands');
+        processDirectory(localDir);
+    }
+    return Array.from(commands.values());
+}
+/**
+ * Get all available commands (builtin + custom)
+ */
+export function getAvailableCommands(workingDirectory) {
+    const builtin = getBuiltinCommands();
+    const custom = getCustomCommands(workingDirectory);
+    // Merge arrays
+    return [...builtin, ...custom];
+}
+//# sourceMappingURL=commands-service.js.map

package/dist/services/commands-service.js.map

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

package/dist/services/connection-debug-logger.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Connection Debug Logger
+ *
+ * Provides coordinated logging for diagnosing streaming/connection issues.
+ * Logs to both console and a dedicated file for post-mortem analysis.
+ *
+ * Enabled via:
+ *   - Backend: Set DEBUG_CONNECTION=1 env var or call enableDebugLogging()
+ *   - Frontend: Call window.__enableConnectionDebug() in browser console
+ *
+ * Log file: ~/.claudia/logs/connection-debug.log
+ */
+export interface ConnectionDebugEvent {
+    timestamp: string;
+    traceId?: string;
+    source: 'backend' | 'frontend';
+    component: string;
+    event: string;
+    details?: Record<string, unknown>;
+}
+declare class ConnectionDebugLogger {
+    private enabled;
+    private logFile;
+    private buffer;
+    private writeTimeout;
+    private maxBufferSize;
+    private flushIntervalMs;
+    constructor();
+    enable(): void;
+    disable(): void;
+    isEnabled(): boolean;
+    log(component: string, event: string, details?: Record<string, unknown>, traceId?: string): void;
+    /**
+     * Log a frontend event received via API
+     */
+    logFrontendEvent(component: string, event: string, details?: Record<string, unknown>, traceId?: string): void;
+    private flush;
+    /**
+     * Get recent log entries (for API endpoint)
+     */
+    getRecentLogs(limit?: number): ConnectionDebugEvent[];
+    /**
+     * Clear the log file
+     */
+    clearLogs(): void;
+}
+export declare const connectionDebugLogger: ConnectionDebugLogger;
+/**
+ * Generate a trace ID that can be shared between frontend and backend
+ */
+export declare function generateTraceId(): string;
+/**
+ * Interface for state snapshot providers
+ */
+export interface ConnectionStateProvider {
+    getConnectionState(): {
+        conversationStatusManager: {
+            activeSessions: Array<{
+                claudeSessionId: string;
+                streamingId: string;
+            }>;
+        };
+        streamManager: {
+            activeSessions: string[];
+            clientCounts: Record<string, number>;
+        } | null;
+        processManager: {
+            activeSessions: string[];
+        };
+    };
+}
+/**
+ * Register a state provider for periodic logging
+ */
+export declare function registerStateProvider(provider: ConnectionStateProvider): void;
+/**
+ * Start periodic state logging (logs every N seconds when debug is enabled)
+ */
+export declare function startPeriodicStateLogging(intervalMs?: number): void;
+/**
+ * Stop periodic state logging
+ */
+export declare function stopPeriodicStateLogging(): void;
+export {};
+//# sourceMappingURL=connection-debug-logger.d.ts.map

package/dist/services/connection-debug-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-debug-logger.d.ts","sourceRoot":"","sources":["../../src/services/connection-debug-logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,cAAM,qBAAqB;IACzB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,aAAa,CAAO;IAC5B,OAAO,CAAC,eAAe,CAAQ;;IAY/B,MAAM,IAAI,IAAI;IAkBd,OAAO,IAAI,IAAI;IAOf,SAAS,IAAI,OAAO;IAIpB,GAAG,CACD,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,CAAC,EAAE,MAAM,GACf,IAAI;IA6BP;;OAEG;IACH,gBAAgB,CACd,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,CAAC,EAAE,MAAM,GACf,IAAI;IAwBP,OAAO,CAAC,KAAK;IAiBb;;OAEG;IACH,aAAa,CAAC,KAAK,SAAM,GAAG,oBAAoB,EAAE;IAwBlD;;OAEG;IACH,SAAS,IAAI,IAAI;CAUlB;AAGD,eAAO,MAAM,qBAAqB,uBAA8B,CAAC;AAEjE;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,kBAAkB,IAAI;QACpB,yBAAyB,EAAE;YAAE,cAAc,EAAE,KAAK,CAAC;gBAAE,eAAe,EAAE,MAAM,CAAC;gBAAC,WAAW,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,CAAC;QACvG,aAAa,EAAE;YAAE,cAAc,EAAE,MAAM,EAAE,CAAC;YAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;SAAE,GAAG,IAAI,CAAC;QACzF,cAAc,EAAE;YAAE,cAAc,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC;KAC9C,CAAC;CACH;AAKD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI,CAE7E;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,SAAQ,GAAG,IAAI,CAwClE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAK/C"}

package/dist/services/connection-debug-logger.js

@@ -0,0 +1,221 @@
+/**
+ * Connection Debug Logger
+ *
+ * Provides coordinated logging for diagnosing streaming/connection issues.
+ * Logs to both console and a dedicated file for post-mortem analysis.
+ *
+ * Enabled via:
+ *   - Backend: Set DEBUG_CONNECTION=1 env var or call enableDebugLogging()
+ *   - Frontend: Call window.__enableConnectionDebug() in browser console
+ *
+ * Log file: ~/.claudia/logs/connection-debug.log
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { homedir } from 'os';
+class ConnectionDebugLogger {
+    enabled = false;
+    logFile;
+    buffer = [];
+    writeTimeout = null;
+    maxBufferSize = 100;
+    flushIntervalMs = 1000;
+    constructor() {
+        const logDir = path.join(homedir(), '.claudia', 'logs');
+        this.logFile = path.join(logDir, 'connection-debug.log');
+        // Enable via env var
+        if (process.env.DEBUG_CONNECTION === '1' || process.env.DEBUG_CONNECTION === 'true') {
+            this.enable();
+        }
+    }
+    enable() {
+        if (this.enabled)
+            return;
+        this.enabled = true;
+        // Ensure log directory exists
+        const logDir = path.dirname(this.logFile);
+        if (!fs.existsSync(logDir)) {
+            fs.mkdirSync(logDir, { recursive: true });
+        }
+        // Write header
+        const header = `\n${'='.repeat(80)}\nConnection Debug Session Started: ${new Date().toISOString()}\n${'='.repeat(80)}\n`;
+        fs.appendFileSync(this.logFile, header);
+        console.log(`[ConnectionDebug] Enabled - logging to ${this.logFile}`);
+    }
+    disable() {
+        if (!this.enabled)
+            return;
+        this.flush();
+        this.enabled = false;
+        console.log('[ConnectionDebug] Disabled');
+    }
+    isEnabled() {
+        return this.enabled;
+    }
+    log(component, event, details, traceId) {
+        if (!this.enabled)
+            return;
+        const entry = {
+            timestamp: new Date().toISOString(),
+            traceId,
+            source: 'backend',
+            component,
+            event,
+            details,
+        };
+        // Console output for real-time monitoring
+        const shortTrace = traceId ? `[${traceId.slice(0, 8)}]` : '';
+        const detailsStr = details ? ` ${JSON.stringify(details)}` : '';
+        console.log(`[ConnDebug] ${shortTrace} ${component}:${event}${detailsStr}`);
+        // Buffer for file output
+        this.buffer.push(entry);
+        // Flush if buffer is full
+        if (this.buffer.length >= this.maxBufferSize) {
+            this.flush();
+        }
+        else if (!this.writeTimeout) {
+            // Schedule a flush
+            this.writeTimeout = setTimeout(() => this.flush(), this.flushIntervalMs);
+        }
+    }
+    /**
+     * Log a frontend event received via API
+     */
+    logFrontendEvent(component, event, details, traceId) {
+        if (!this.enabled)
+            return;
+        const entry = {
+            timestamp: new Date().toISOString(),
+            traceId,
+            source: 'frontend',
+            component,
+            event,
+            details,
+        };
+        this.buffer.push(entry);
+        // Console output
+        const shortTrace = traceId ? `[${traceId.slice(0, 8)}]` : '';
+        const detailsStr = details ? ` ${JSON.stringify(details)}` : '';
+        console.log(`[ConnDebug:FE] ${shortTrace} ${component}:${event}${detailsStr}`);
+        if (this.buffer.length >= this.maxBufferSize) {
+            this.flush();
+        }
+    }
+    flush() {
+        if (this.writeTimeout) {
+            clearTimeout(this.writeTimeout);
+            this.writeTimeout = null;
+        }
+        if (this.buffer.length === 0)
+            return;
+        try {
+            const lines = this.buffer.map(e => JSON.stringify(e)).join('\n') + '\n';
+            fs.appendFileSync(this.logFile, lines);
+            this.buffer = [];
+        }
+        catch (err) {
+            console.error('[ConnectionDebug] Failed to write to log file:', err);
+        }
+    }
+    /**
+     * Get recent log entries (for API endpoint)
+     */
+    getRecentLogs(limit = 200) {
+        // Read from file
+        try {
+            if (!fs.existsSync(this.logFile)) {
+                return [];
+            }
+            const content = fs.readFileSync(this.logFile, 'utf-8');
+            const lines = content.split('\n').filter(line => line.trim() && line.startsWith('{'));
+            const entries = lines.slice(-limit).map(line => {
+                try {
+                    return JSON.parse(line);
+                }
+                catch {
+                    return null;
+                }
+            }).filter((e) => e !== null);
+            return entries;
+        }
+        catch (err) {
+            console.error('[ConnectionDebug] Failed to read log file:', err);
+            return [];
+        }
+    }
+    /**
+     * Clear the log file
+     */
+    clearLogs() {
+        this.buffer = [];
+        try {
+            if (fs.existsSync(this.logFile)) {
+                fs.truncateSync(this.logFile);
+            }
+        }
+        catch (err) {
+            console.error('[ConnectionDebug] Failed to clear log file:', err);
+        }
+    }
+}
+// Singleton instance
+export const connectionDebugLogger = new ConnectionDebugLogger();
+/**
+ * Generate a trace ID that can be shared between frontend and backend
+ */
+export function generateTraceId() {
+    return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+}
+let stateProvider = null;
+let periodicLogInterval = null;
+/**
+ * Register a state provider for periodic logging
+ */
+export function registerStateProvider(provider) {
+    stateProvider = provider;
+}
+/**
+ * Start periodic state logging (logs every N seconds when debug is enabled)
+ */
+export function startPeriodicStateLogging(intervalMs = 30000) {
+    if (periodicLogInterval)
+        return;
+    periodicLogInterval = setInterval(() => {
+        if (!connectionDebugLogger.isEnabled() || !stateProvider)
+            return;
+        const state = stateProvider.getConnectionState();
+        // Check for mismatches - sessions tracked but no clients
+        const trackedStreamingIds = new Set(state.conversationStatusManager.activeSessions.map(s => s.streamingId));
+        const connectedStreamingIds = new Set(state.streamManager?.activeSessions || []);
+        const orphanedSessions = state.conversationStatusManager.activeSessions.filter(s => !connectedStreamingIds.has(s.streamingId));
+        if (orphanedSessions.length > 0) {
+            connectionDebugLogger.log('PeriodicCheck', 'orphaned-sessions-detected', {
+                orphanedCount: orphanedSessions.length,
+                orphanedSessions: orphanedSessions.map(s => ({
+                    sessionId: s.claudeSessionId.slice(0, 8),
+                    streamingId: s.streamingId.slice(0, 8),
+                })),
+                totalTracked: trackedStreamingIds.size,
+                totalConnected: connectedStreamingIds.size,
+            });
+        }
+        // Also log if there are clients for unknown sessions
+        const unknownClients = (state.streamManager?.activeSessions || []).filter(s => !trackedStreamingIds.has(s));
+        if (unknownClients.length > 0) {
+            connectionDebugLogger.log('PeriodicCheck', 'unknown-clients-detected', {
+                unknownCount: unknownClients.length,
+                unknownStreamingIds: unknownClients.map(s => s.slice(0, 8)),
+            });
+        }
+    }, intervalMs);
+}
+/**
+ * Stop periodic state logging
+ */
+export function stopPeriodicStateLogging() {
+    if (periodicLogInterval) {
+        clearInterval(periodicLogInterval);
+        periodicLogInterval = null;
+    }
+}
+//# sourceMappingURL=connection-debug-logger.js.map

package/dist/services/connection-debug-logger.js.map

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

package/dist/services/debug-log.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Debug Log - Writes to ~/cui-debug.log for unified browser+server debugging
+ */
+export declare function debugLog(message: string, data?: Record<string, unknown>): void;
+export declare function clearDebugLog(): void;
+//# sourceMappingURL=debug-log.d.ts.map

package/dist/services/debug-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-log.d.ts","sourceRoot":"","sources":["../../src/services/debug-log.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAU9E;AAED,wBAAgB,aAAa,IAAI,IAAI,CAMpC"}

package/dist/services/debug-log.js

@@ -0,0 +1,27 @@
+/**
+ * Debug Log - Writes to ~/cui-debug.log for unified browser+server debugging
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+const DEBUG_LOG_PATH = path.join(os.homedir(), 'cui-debug.log');
+export function debugLog(message, data) {
+    const timestamp = new Date().toISOString();
+    const dataStr = data ? ` ${JSON.stringify(data)}` : '';
+    const line = `[${timestamp}] [SERVER] [debug] ${message}${dataStr}\n`;
+    try {
+        fs.appendFileSync(DEBUG_LOG_PATH, line);
+    }
+    catch {
+        // Silently fail
+    }
+}
+export function clearDebugLog() {
+    try {
+        fs.writeFileSync(DEBUG_LOG_PATH, `--- Debug log cleared at ${new Date().toISOString()} ---\n`);
+    }
+    catch {
+        // Silently fail
+    }
+}
+//# sourceMappingURL=debug-log.js.map

package/dist/services/debug-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-log.js","sourceRoot":"","sources":["../../src/services/debug-log.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,eAAe,CAAC,CAAC;AAEhE,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,IAA8B;IACtE,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACvD,MAAM,IAAI,GAAG,IAAI,SAAS,sBAAsB,OAAO,GAAG,OAAO,IAAI,CAAC;IAEtE,IAAI,CAAC;QACH,EAAE,CAAC,cAAc,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,gBAAgB;IAClB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,cAAc,EAAE,4BAA4B,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACjG,CAAC;IAAC,MAAM,CAAC;QACP,gBAAgB;IAClB,CAAC;AACH,CAAC"}

package/dist/services/gemini-service.d.ts

@@ -0,0 +1,35 @@
+export interface GeminiSessionNameResponse {
+    name: string;
+}
+export interface GeminiImageResponse {
+    imageData: string;
+    mimeType: string;
+}
+export declare class GeminiService {
+    private logger;
+    private genAI;
+    private model;
+    constructor();
+    initialize(): Promise<void>;
+    generateSessionName(conversationText: string): Promise<GeminiSessionNameResponse>;
+    /**
+     * Create a black canvas PNG to use as base for image editing.
+     * Using inpainting on a black canvas ensures consistent black backgrounds.
+     */
+    private createBlackCanvas;
+    /**
+     * Generate a visually distinctive identity banner for a session.
+     *
+     * Uses randomized visual parameters (colors, style, composition) plus
+     * loose context from the session to create unique, scannable banners.
+     * No Claude extraction step - faster and cheaper while achieving better diversity.
+     */
+    generateSessionImage(sessionContext: {
+        mission: string;
+        project?: string;
+        theme?: string;
+        workTypes?: string[];
+    }): Promise<GeminiImageResponse>;
+}
+export declare const geminiService: GeminiService;
+//# sourceMappingURL=gemini-service.d.ts.map

package/dist/services/gemini-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-service.d.ts","sourceRoot":"","sources":["../../src/services/gemini-service.ts"],"names":[],"mappings":"AAkEA,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,KAAK,CAAS;;IAOhB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB3B,mBAAmB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;IA8DvF;;;OAGG;YACW,iBAAiB;IAgB/B;;;;;;OAMG;IACG,oBAAoB,CAAC,cAAc,EAAE;QACzC,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAgGjC;AAGD,eAAO,MAAM,aAAa,eAAsB,CAAC"}