claudia-orchestrator 0.1.0

package/dist/services/gemini-service.js

@@ -0,0 +1,431 @@
+import { GoogleGenAI, Type } from '@google/genai';
+import { setGlobalDispatcher, ProxyAgent } from 'undici';
+import sharp from 'sharp';
+import { CUIError } from '../types/index.js';
+import { createLogger } from '../services/logger.js';
+import { ConfigService } from './config-service.js';
+// Set up proxy support using environment variables (production only)
+const proxyUrl = process.env.HTTPS_PROXY || process.env.https_proxy;
+if (proxyUrl && process.env.NODE_ENV !== 'test') {
+    const dispatcher = new ProxyAgent({ uri: new URL(proxyUrl).toString() });
+    setGlobalDispatcher(dispatcher);
+}
+export class GeminiService {
+    logger;
+    genAI = null;
+    model;
+    constructor() {
+        this.logger = createLogger('GeminiService');
+        this.model = 'gemini-2.5-flash';
+    }
+    async initialize() {
+        const config = ConfigService.getInstance().getConfig();
+        const apiKey = config.gemini?.apiKey || process.env.GOOGLE_API_KEY;
+        if (!apiKey) {
+            this.logger.warn('Gemini API key not configured');
+            return;
+        }
+        try {
+            this.genAI = new GoogleGenAI({
+                apiKey: apiKey
+            });
+            if (config.gemini?.model) {
+                this.model = config.gemini.model;
+            }
+            this.logger.info('Gemini service initialized', { model: this.model });
+        }
+        catch (error) {
+            this.logger.error('Failed to initialize Gemini service', { error });
+            throw new CUIError('GEMINI_INIT_ERROR', 'Failed to initialize Gemini service', 500);
+        }
+    }
+    async checkHealth() {
+        if (!this.genAI) {
+            return {
+                status: 'unhealthy',
+                message: 'Gemini API key not configured',
+                apiKeyValid: false
+            };
+        }
+        try {
+            // Test the API with a simple request
+            const response = await this.genAI.models.generateContent({
+                model: this.model,
+                contents: [{
+                        role: 'user',
+                        parts: [{
+                                text: 'Say hello and nothing else'
+                            }]
+                    }]
+            });
+            if (response.text) {
+                return {
+                    status: 'healthy',
+                    message: 'Gemini API is accessible',
+                    apiKeyValid: true
+                };
+            }
+            return {
+                status: 'unhealthy',
+                message: 'Unexpected response from Gemini API',
+                apiKeyValid: true
+            };
+        }
+        catch (error) {
+            this.logger.error('Health check failed', { error });
+            return {
+                status: 'unhealthy',
+                message: error instanceof Error ? error.message : 'Unknown error',
+                apiKeyValid: false
+            };
+        }
+    }
+    async transcribe(audio, mimeType) {
+        if (!this.genAI) {
+            throw new CUIError('GEMINI_API_KEY_MISSING', 'Gemini API key not configured', 400);
+        }
+        try {
+            const response = await this.genAI.models.generateContent({
+                model: this.model,
+                contents: [{
+                        role: 'user',
+                        parts: [
+                            {
+                                inlineData: {
+                                    mimeType: mimeType,
+                                    data: audio
+                                }
+                            },
+                            {
+                                text: 'Transcribe the above audio instructions, which are likely related to software development and may include a mix of different languages and technical terms (e.g., code references, file paths, API names). Transcribe verbatim with correct punctuation, do not add explanations or non-verbal cues. Return the raw transcribed text only:'
+                            }
+                        ]
+                    }]
+            });
+            const text = response.text;
+            if (!text) {
+                throw new CUIError('GEMINI_TRANSCRIBE_ERROR', 'No transcription returned', 500);
+            }
+            this.logger.debug('Audio transcribed successfully', { textLength: text.length });
+            return { text: text.trim() };
+        }
+        catch (error) {
+            if (error instanceof CUIError) {
+                throw error;
+            }
+            this.logger.error('Transcription failed', { error });
+            throw new CUIError('GEMINI_TRANSCRIBE_ERROR', 'Failed to transcribe audio', 500);
+        }
+    }
+    async summarize(text) {
+        if (!this.genAI) {
+            throw new CUIError('GEMINI_API_KEY_MISSING', 'Gemini API key not configured', 400);
+        }
+        const schema = {
+            type: Type.OBJECT,
+            properties: {
+                title: {
+                    type: Type.STRING,
+                    description: 'A concise title summarizing the conversation'
+                },
+                keypoints: {
+                    type: Type.ARRAY,
+                    items: {
+                        type: Type.STRING
+                    },
+                    description: 'List of key points from the text'
+                }
+            },
+            required: ['title', 'keypoints']
+        };
+        try {
+            const response = await this.genAI.models.generateContent({
+                model: this.model,
+                contents: [{
+                        role: 'user',
+                        parts: [{
+                                text: `Please summarize the following text into a title and key points:\n\n${text}`
+                            }]
+                    }],
+                config: {
+                    responseMimeType: 'application/json',
+                    responseSchema: schema
+                }
+            });
+            const responseText = response.text;
+            if (!responseText) {
+                throw new CUIError('GEMINI_SUMMARIZE_ERROR', 'No response text returned', 500);
+            }
+            const result = JSON.parse(responseText);
+            if (!result.title || !Array.isArray(result.keypoints)) {
+                throw new CUIError('GEMINI_SUMMARIZE_ERROR', 'Invalid response format', 500);
+            }
+            this.logger.debug('Text summarized successfully', {
+                titleLength: result.title.length,
+                keypointCount: result.keypoints.length
+            });
+            return result;
+        }
+        catch (error) {
+            if (error instanceof CUIError) {
+                throw error;
+            }
+            this.logger.error('Summarization failed', { error });
+            throw new CUIError('GEMINI_SUMMARIZE_ERROR', 'Failed to summarize text', 500);
+        }
+    }
+    async generateSessionName(conversationText) {
+        if (!this.genAI) {
+            throw new CUIError('GEMINI_API_KEY_MISSING', 'Gemini API key not configured', 400);
+        }
+        const schema = {
+            type: Type.OBJECT,
+            properties: {
+                name: {
+                    type: Type.STRING,
+                    description: 'A brief, descriptive name for this coding session (3-6 words)'
+                }
+            },
+            required: ['name']
+        };
+        try {
+            const response = await this.genAI.models.generateContent({
+                model: this.model,
+                contents: [{
+                        role: 'user',
+                        parts: [{
+                                text: `Generate a brief, descriptive name (3-6 words) for this coding session. Focus on the main task or feature being worked on. Do not include generic words like "session", "conversation", or "chat". Examples of good names: "Fix auth redirect bug", "Add dark mode support", "Refactor user service".
+
+Conversation:
+${conversationText}`
+                            }]
+                    }],
+                config: {
+                    responseMimeType: 'application/json',
+                    responseSchema: schema
+                }
+            });
+            const responseText = response.text;
+            if (!responseText) {
+                throw new CUIError('GEMINI_SESSION_NAME_ERROR', 'No response text returned', 500);
+            }
+            const result = JSON.parse(responseText);
+            if (!result.name) {
+                throw new CUIError('GEMINI_SESSION_NAME_ERROR', 'Invalid response format', 500);
+            }
+            this.logger.debug('Session name generated successfully', {
+                nameLength: result.name.length
+            });
+            return result;
+        }
+        catch (error) {
+            if (error instanceof CUIError) {
+                throw error;
+            }
+            this.logger.error('Session name generation failed', { error });
+            throw new CUIError('GEMINI_SESSION_NAME_ERROR', 'Failed to generate session name', 500);
+        }
+    }
+    /**
+     * Generate structured session insights for display
+     */
+    async generateSessionInsights(conversationText) {
+        if (!this.genAI) {
+            throw new CUIError('GEMINI_API_KEY_MISSING', 'Gemini API key not configured', 400);
+        }
+        const schema = {
+            type: Type.OBJECT,
+            properties: {
+                purposes: {
+                    type: Type.ARRAY,
+                    items: { type: Type.STRING },
+                    description: 'The main goals/purposes of this session (1-3 items). Each should be a concise phrase like "Implement dark mode" or "Debug auth flow"'
+                },
+                milestones: {
+                    type: Type.ARRAY,
+                    items: {
+                        type: Type.OBJECT,
+                        properties: {
+                            label: { type: Type.STRING, description: 'Short milestone description (3-8 words)' },
+                            status: { type: Type.STRING, description: 'One of: done, current, pending' }
+                        },
+                        required: ['label', 'status']
+                    },
+                    description: 'Key chunks of work in this session (2-5 items). Mark completed work as "done", active work as "current", planned work as "pending"'
+                },
+                recentActions: {
+                    type: Type.ARRAY,
+                    items: { type: Type.STRING },
+                    description: 'The 3-4 most recent concrete actions taken, each as a concise phrase (e.g., "Added migration for new columns", "Fixed JSON parsing bug")'
+                }
+            },
+            required: ['purposes', 'milestones', 'recentActions']
+        };
+        try {
+            const response = await this.genAI.models.generateContent({
+                model: this.model,
+                contents: [{
+                        role: 'user',
+                        parts: [{
+                                text: `Analyze this coding session and extract structured information.
+
+${conversationText}
+
+Extract:
+1. purposes: The main goals of this session (1-3 concise phrases)
+2. milestones: Key chunks of work with status (done/current/pending)
+3. recentActions: The 3-4 most recent concrete actions taken`
+                            }]
+                    }],
+                config: {
+                    responseMimeType: 'application/json',
+                    responseSchema: schema
+                }
+            });
+            const responseText = response.text;
+            if (!responseText) {
+                throw new CUIError('GEMINI_INSIGHTS_ERROR', 'No response text returned', 500);
+            }
+            const result = JSON.parse(responseText);
+            if (!result.purposes || !result.milestones || !result.recentActions) {
+                throw new CUIError('GEMINI_INSIGHTS_ERROR', 'Invalid response format', 500);
+            }
+            this.logger.debug('Session insights generated successfully');
+            return result;
+        }
+        catch (error) {
+            if (error instanceof CUIError) {
+                throw error;
+            }
+            this.logger.error('Session insights generation failed', { error });
+            throw new CUIError('GEMINI_INSIGHTS_ERROR', 'Failed to generate session insights', 500);
+        }
+    }
+    /**
+     * Map session theme to a neon glow color for visual differentiation.
+     * This creates instant visual grouping - all debugging sessions are amber,
+     * all implementing sessions are green, etc.
+     */
+    getColorForTheme(theme) {
+        const themeColorMap = {
+            'debugging': 'warm amber/orange',
+            'investigating': 'cool cyan/blue',
+            'implementing': 'green/emerald',
+            'polishing': 'gold/yellow',
+            'exploring': 'purple/violet',
+            'refactoring': 'gold/yellow',
+            'designing': 'purple/violet',
+            'experimenting': 'magenta/pink',
+            'research': 'purple/violet',
+            'implementation': 'green/emerald',
+        };
+        if (!theme)
+            return 'cyan/blue';
+        const themeLower = theme.toLowerCase();
+        for (const [key, color] of Object.entries(themeColorMap)) {
+            if (themeLower.includes(key)) {
+                return color;
+            }
+        }
+        return 'cyan/blue'; // default
+    }
+    /**
+     * Create a black canvas PNG to use as base for image editing.
+     * Using inpainting on a black canvas ensures consistent black backgrounds.
+     */
+    async createBlackCanvas() {
+        // Create at higher resolution for quality, will resize after generation
+        return sharp({
+            create: {
+                width: 512,
+                height: 960,
+                channels: 3,
+                background: { r: 0, g: 0, b: 0 }
+            }
+        }).png().toBuffer();
+    }
+    /**
+     * Generate an abstract visual identity image for a session.
+     * Uses image editing on a black canvas to ensure consistent black backgrounds,
+     * with color-mood mapping for instant visual differentiation between session types.
+     */
+    async generateSessionImage(sessionContext) {
+        if (!this.genAI) {
+            throw new CUIError('GEMINI_API_KEY_MISSING', 'Gemini API key not configured', 400);
+        }
+        // Get color based on session theme for visual grouping
+        const glowColor = this.getColorForTheme(sessionContext.theme);
+        // Build the prompt - shorter and more focused than before
+        const prompt = `Add a glowing neon icon to this black image.
+
+TASK: ${sessionContext.mission}
+COLOR: ${glowColor} glow
+
+Requirements:
+- Single bold central symbol
+- Neon glow effect
+- Keep the black background intact
+- No text, no faces
+- Tech/circuit aesthetic optional`;
+        this.logger.debug('Session image prompt', {
+            theme: sessionContext.theme,
+            color: glowColor,
+            mission: sessionContext.mission
+        });
+        try {
+            // Create black canvas as base image
+            const blackCanvas = await this.createBlackCanvas();
+            const blackCanvasBase64 = blackCanvas.toString('base64');
+            // Use image editing mode - pass black canvas + prompt
+            const response = await this.genAI.models.generateContent({
+                model: 'gemini-3-pro-image-preview',
+                contents: [
+                    {
+                        role: 'user',
+                        parts: [
+                            { inlineData: { mimeType: 'image/png', data: blackCanvasBase64 } },
+                            { text: prompt }
+                        ]
+                    }
+                ],
+                config: {
+                    responseModalities: ['TEXT', 'IMAGE'],
+                }
+            });
+            // Extract image from response parts
+            if (response.candidates?.[0]?.content?.parts) {
+                for (const part of response.candidates[0].content.parts) {
+                    if (part.inlineData) {
+                        this.logger.debug('Raw session image generated, resizing to 80x150');
+                        const rawImageBuffer = Buffer.from(part.inlineData.data, 'base64');
+                        // Resize to final dimensions and encode as JPEG
+                        const resizedBuffer = await sharp(rawImageBuffer)
+                            .resize(80, 150, { fit: 'cover' })
+                            .jpeg({ quality: 80 })
+                            .toBuffer();
+                        const resizedBase64 = resizedBuffer.toString('base64');
+                        this.logger.debug('Session image resized successfully', {
+                            originalSize: rawImageBuffer.length,
+                            resizedSize: resizedBuffer.length
+                        });
+                        return {
+                            imageData: resizedBase64,
+                            mimeType: 'image/jpeg'
+                        };
+                    }
+                }
+            }
+            throw new CUIError('GEMINI_IMAGE_ERROR', 'No image was generated in the response', 500);
+        }
+        catch (error) {
+            if (error instanceof CUIError) {
+                throw error;
+            }
+            this.logger.error('Session image generation failed', { error });
+            throw new CUIError('GEMINI_IMAGE_ERROR', 'Failed to generate session image', 500);
+        }
+    }
+}
+// Export singleton instance
+export const geminiService = new GeminiService();
+//# sourceMappingURL=gemini-service.js.map

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

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

package/dist/services/insight-queue.d.ts

@@ -0,0 +1,99 @@
+/**
+ * InsightQueue - Serializes insight operations per session to eliminate race conditions.
+ *
+ * The Problem This Solves:
+ * Previously, background regenerations could race with patches:
+ *   T+0s: Patch starts (Haiku)
+ *   T+1s: Background regen starts (Opus)
+ *   T+5s: Patch completes, writes to cache
+ *   T+8s: Regen completes, merge decision uses stale snapshot, overwrites patch
+ *
+ * The Solution:
+ * All insight operations go through this queue. Operations for the same session
+ * are serialized - a REFRESH can't start until the PATCH completes.
+ *
+ * Key Design Decisions:
+ * - One queue per session (different sessions can run in parallel)
+ * - Operations coalesce (if PATCH is queued and another PATCH comes in, skip the new one)
+ * - Priority ordering: PATCH > GENERATE > REFRESH
+ * - In-memory only (operations are idempotent, no need for persistence)
+ */
+import { EventEmitter } from 'events';
+export type InsightOperationType = 'GENERATE' | 'PATCH' | 'REFRESH';
+export type InsightTrigger = 'initial' | 'user_message' | 'completion' | 'tool_use' | 'scheduled' | 'manual' | 'missing_fields';
+export interface InsightOperation {
+    type: InsightOperationType;
+    sessionId: string;
+    priority: 'high' | 'normal' | 'low';
+    trigger: InsightTrigger;
+    enqueuedAt: number;
+    traceId?: string;
+}
+interface QueueStats {
+    totalEnqueued: number;
+    totalProcessed: number;
+    totalSkipped: number;
+    byType: Record<InsightOperationType, number>;
+    byTrigger: Record<string, number>;
+}
+export declare class InsightQueue extends EventEmitter {
+    private logger;
+    private queues;
+    private processing;
+    private processingType;
+    private stats;
+    private executor;
+    constructor();
+    /**
+     * Set the executor function that processes operations.
+     * This is injected to break the circular dependency between queue and handler.
+     */
+    setExecutor(executor: (op: InsightOperation) => Promise<void>): void;
+    /**
+     * Enqueue an insight operation.
+     * Operations are coalesced (duplicate type+session skipped) and prioritized.
+     */
+    enqueue(op: Omit<InsightOperation, 'enqueuedAt'>): boolean;
+    /**
+     * Process the next operation in a session's queue.
+     * This is the serialization point - only one operation per session at a time.
+     */
+    private processNext;
+    /**
+     * Get the current queue for a session (for debugging/UI).
+     */
+    getQueue(sessionId: string): InsightOperation[];
+    /**
+     * Check if a session is currently being processed.
+     */
+    isProcessing(sessionId: string): boolean;
+    /**
+     * Get the operation type currently being processed for a session.
+     */
+    getProcessingType(sessionId: string): InsightOperationType | undefined;
+    /**
+     * Get the number of pending operations for a session.
+     */
+    getPendingCount(sessionId: string): number;
+    /**
+     * Get all sessions with pending operations.
+     */
+    getActiveSessionIds(): string[];
+    /**
+     * Get queue statistics.
+     */
+    getStats(): QueueStats;
+    /**
+     * Clear the queue for a session (e.g., when session is archived).
+     */
+    clearSession(sessionId: string): void;
+    /**
+     * Shutdown the queue (for graceful server shutdown).
+     * Waits for in-flight operations to complete but doesn't process new ones.
+     */
+    shutdown(timeoutMs?: number): Promise<void>;
+}
+export declare function getInsightQueue(): InsightQueue;
+export declare function resetInsightQueue(): void;
+export {};
+//# sourceMappingURL=insight-queue.d.ts.map

package/dist/services/insight-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insight-queue.d.ts","sourceRoot":"","sources":["../../src/services/insight-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;AAEpE,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,cAAc,GACd,YAAY,GACZ,UAAU,GACV,WAAW,GACX,QAAQ,GACR,gBAAgB,CAAC;AAErB,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,OAAO,EAAE,cAAc,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,UAAU;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAiCD,qBAAa,YAAa,SAAQ,YAAY;IAC5C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAA8C;IAC5D,OAAO,CAAC,UAAU,CAA0B;IAE5C,OAAO,CAAC,cAAc,CAAgD;IACtE,OAAO,CAAC,KAAK,CAMX;IAGF,OAAO,CAAC,QAAQ,CAA0D;;IAO1E;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAKpE;;;OAGG;IACH,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAC,GAAG,OAAO;IAoD1D;;;OAGG;YACW,WAAW;IA0EzB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAI/C;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIxC;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAItE;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAI1C;;OAEG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAM/B;;OAEG;IACH,QAAQ,IAAI,UAAU;IAItB;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAWrC;;;OAGG;IACG,QAAQ,CAAC,SAAS,GAAE,MAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAuBzD;AAKD,wBAAgB,eAAe,IAAI,YAAY,CAK9C;AAGD,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}