@cloudcli-ai/cloudcli 1.29.1 → 1.29.3

package/dist-server/server/providers/gemini/adapter.js

@@ -0,0 +1,174 @@
+/**
+ * Gemini provider adapter.
+ *
+ * Normalizes Gemini CLI session history into NormalizedMessage format.
+ * @module adapters/gemini
+ */
+import sessionManager from '../../sessionManager.js';
+import { getGeminiCliSessionMessages } from '../../projects.js';
+import { createNormalizedMessage, generateMessageId } from '../types.js';
+const PROVIDER = 'gemini';
+/**
+ * Normalize a realtime NDJSON event from Gemini CLI into NormalizedMessage(s).
+ * Handles: message (delta/final), tool_use, tool_result, result, error.
+ * @param {object} raw - A parsed NDJSON event
+ * @param {string} sessionId
+ * @returns {import('../types.js').NormalizedMessage[]}
+ */
+export function normalizeMessage(raw, sessionId) {
+    const ts = raw.timestamp || new Date().toISOString();
+    const baseId = raw.uuid || generateMessageId('gemini');
+    if (raw.type === 'message' && raw.role === 'assistant') {
+        const content = raw.content || '';
+        const msgs = [];
+        if (content) {
+            msgs.push(createNormalizedMessage({ id: baseId, sessionId, timestamp: ts, provider: PROVIDER, kind: 'stream_delta', content }));
+        }
+        // If not a delta, also send stream_end
+        if (raw.delta !== true) {
+            msgs.push(createNormalizedMessage({ sessionId, timestamp: ts, provider: PROVIDER, kind: 'stream_end' }));
+        }
+        return msgs;
+    }
+    if (raw.type === 'tool_use') {
+        return [createNormalizedMessage({
+                id: baseId, sessionId, timestamp: ts, provider: PROVIDER,
+                kind: 'tool_use', toolName: raw.tool_name, toolInput: raw.parameters || {},
+                toolId: raw.tool_id || baseId,
+            })];
+    }
+    if (raw.type === 'tool_result') {
+        return [createNormalizedMessage({
+                id: baseId, sessionId, timestamp: ts, provider: PROVIDER,
+                kind: 'tool_result', toolId: raw.tool_id || '',
+                content: raw.output === undefined ? '' : String(raw.output),
+                isError: raw.status === 'error',
+            })];
+    }
+    if (raw.type === 'result') {
+        const msgs = [createNormalizedMessage({ sessionId, timestamp: ts, provider: PROVIDER, kind: 'stream_end' })];
+        if (raw.stats?.total_tokens) {
+            msgs.push(createNormalizedMessage({
+                sessionId, timestamp: ts, provider: PROVIDER,
+                kind: 'status', text: 'Complete', tokens: raw.stats.total_tokens, canInterrupt: false,
+            }));
+        }
+        return msgs;
+    }
+    if (raw.type === 'error') {
+        return [createNormalizedMessage({
+                id: baseId, sessionId, timestamp: ts, provider: PROVIDER,
+                kind: 'error', content: raw.error || raw.message || 'Unknown Gemini streaming error',
+            })];
+    }
+    return [];
+}
+/**
+ * @type {import('../types.js').ProviderAdapter}
+ */
+export const geminiAdapter = {
+    normalizeMessage,
+    /**
+     * Fetch session history for Gemini.
+     * First tries in-memory session manager, then falls back to CLI sessions on disk.
+     */
+    async fetchHistory(sessionId, opts = {}) {
+        let rawMessages;
+        try {
+            rawMessages = sessionManager.getSessionMessages(sessionId);
+            // Fallback to Gemini CLI sessions on disk
+            if (rawMessages.length === 0) {
+                rawMessages = await getGeminiCliSessionMessages(sessionId);
+            }
+        }
+        catch (error) {
+            console.warn(`[GeminiAdapter] Failed to load session ${sessionId}:`, error.message);
+            return { messages: [], total: 0, hasMore: false, offset: 0, limit: null };
+        }
+        const normalized = [];
+        for (let i = 0; i < rawMessages.length; i++) {
+            const raw = rawMessages[i];
+            const ts = raw.timestamp || new Date().toISOString();
+            const baseId = raw.uuid || generateMessageId('gemini');
+            // sessionManager format: { type: 'message', message: { role, content }, timestamp }
+            // CLI format: { role: 'user'|'gemini'|'assistant', content: string|array }
+            const role = raw.message?.role || raw.role;
+            const content = raw.message?.content || raw.content;
+            if (!role || !content)
+                continue;
+            const normalizedRole = (role === 'user') ? 'user' : 'assistant';
+            if (Array.isArray(content)) {
+                for (let partIdx = 0; partIdx < content.length; partIdx++) {
+                    const part = content[partIdx];
+                    if (part.type === 'text' && part.text) {
+                        normalized.push(createNormalizedMessage({
+                            id: `${baseId}_${partIdx}`,
+                            sessionId,
+                            timestamp: ts,
+                            provider: PROVIDER,
+                            kind: 'text',
+                            role: normalizedRole,
+                            content: part.text,
+                        }));
+                    }
+                    else if (part.type === 'tool_use') {
+                        normalized.push(createNormalizedMessage({
+                            id: `${baseId}_${partIdx}`,
+                            sessionId,
+                            timestamp: ts,
+                            provider: PROVIDER,
+                            kind: 'tool_use',
+                            toolName: part.name,
+                            toolInput: part.input,
+                            toolId: part.id || generateMessageId('gemini_tool'),
+                        }));
+                    }
+                    else if (part.type === 'tool_result') {
+                        normalized.push(createNormalizedMessage({
+                            id: `${baseId}_${partIdx}`,
+                            sessionId,
+                            timestamp: ts,
+                            provider: PROVIDER,
+                            kind: 'tool_result',
+                            toolId: part.tool_use_id || '',
+                            content: part.content === undefined ? '' : String(part.content),
+                            isError: Boolean(part.is_error),
+                        }));
+                    }
+                }
+            }
+            else if (typeof content === 'string' && content.trim()) {
+                normalized.push(createNormalizedMessage({
+                    id: baseId,
+                    sessionId,
+                    timestamp: ts,
+                    provider: PROVIDER,
+                    kind: 'text',
+                    role: normalizedRole,
+                    content,
+                }));
+            }
+        }
+        // Attach tool results to tool_use messages
+        const toolResultMap = new Map();
+        for (const msg of normalized) {
+            if (msg.kind === 'tool_result' && msg.toolId) {
+                toolResultMap.set(msg.toolId, msg);
+            }
+        }
+        for (const msg of normalized) {
+            if (msg.kind === 'tool_use' && msg.toolId && toolResultMap.has(msg.toolId)) {
+                const tr = toolResultMap.get(msg.toolId);
+                msg.toolResult = { content: tr.content, isError: tr.isError };
+            }
+        }
+        return {
+            messages: normalized,
+            total: normalized.length,
+            hasMore: false,
+            offset: 0,
+            limit: null,
+        };
+    },
+};
+//# sourceMappingURL=adapter.js.map

package/dist-server/server/providers/gemini/adapter.js.map

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

package/dist-server/server/providers/registry.js

@@ -0,0 +1,39 @@
+/**
+ * Provider Registry
+ *
+ * Centralizes provider adapter lookup. All code that needs a provider adapter
+ * should go through this registry instead of importing individual adapters directly.
+ *
+ * @module providers/registry
+ */
+import { claudeAdapter } from './claude/adapter.js';
+import { cursorAdapter } from './cursor/adapter.js';
+import { codexAdapter } from './codex/adapter.js';
+import { geminiAdapter } from './gemini/adapter.js';
+/**
+ * @typedef {import('./types.js').ProviderAdapter} ProviderAdapter
+ * @typedef {import('./types.js').SessionProvider} SessionProvider
+ */
+/** @type {Map<string, ProviderAdapter>} */
+const providers = new Map();
+// Register built-in providers
+providers.set('claude', claudeAdapter);
+providers.set('cursor', cursorAdapter);
+providers.set('codex', codexAdapter);
+providers.set('gemini', geminiAdapter);
+/**
+ * Get a provider adapter by name.
+ * @param {string} name - Provider name (e.g., 'claude', 'cursor', 'codex', 'gemini')
+ * @returns {ProviderAdapter | undefined}
+ */
+export function getProvider(name) {
+    return providers.get(name);
+}
+/**
+ * Get all registered provider names.
+ * @returns {string[]}
+ */
+export function getAllProviders() {
+    return Array.from(providers.keys());
+}
+//# sourceMappingURL=registry.js.map

package/dist-server/server/providers/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../server/providers/registry.js"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;GAGG;AAEH,2CAA2C;AAC3C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;AAE5B,8BAA8B;AAC9B,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;AACvC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;AACvC,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AACrC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;AAEvC;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAI;IAC9B,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;AACtC,CAAC"}

package/dist-server/server/providers/types.js

@@ -0,0 +1,106 @@
+/**
+ * Provider Types & Interface
+ *
+ * Defines the normalized message format and the provider adapter interface.
+ * All providers normalize their native formats into NormalizedMessage
+ * before sending over REST or WebSocket.
+ *
+ * @module providers/types
+ */
+// ─── Session Provider ────────────────────────────────────────────────────────
+/**
+ * @typedef {'claude' | 'cursor' | 'codex' | 'gemini'} SessionProvider
+ */
+// ─── Message Kind ────────────────────────────────────────────────────────────
+/**
+ * @typedef {'text' | 'tool_use' | 'tool_result' | 'thinking' | 'stream_delta' | 'stream_end'
+ *   | 'error' | 'complete' | 'status' | 'permission_request' | 'permission_cancelled'
+ *   | 'session_created' | 'interactive_prompt' | 'task_notification'} MessageKind
+ */
+// ─── NormalizedMessage ───────────────────────────────────────────────────────
+/**
+ * @typedef {Object} NormalizedMessage
+ * @property {string} id - Unique message id (for dedup between server + realtime)
+ * @property {string} sessionId
+ * @property {string} timestamp - ISO 8601
+ * @property {SessionProvider} provider
+ * @property {MessageKind} kind
+ *
+ * Additional fields depending on kind:
+ * - text:                 role ('user'|'assistant'), content, images?
+ * - tool_use:             toolName, toolInput, toolId
+ * - tool_result:          toolId, content, isError
+ * - thinking:             content
+ * - stream_delta:         content
+ * - stream_end:           (no extra fields)
+ * - error:                content
+ * - complete:             (no extra fields)
+ * - status:               text, tokens?, canInterrupt?
+ * - permission_request:   requestId, toolName, input, context?
+ * - permission_cancelled: requestId
+ * - session_created:      newSessionId
+ * - interactive_prompt:   content
+ * - task_notification:    status, summary
+ */
+// ─── Fetch History ───────────────────────────────────────────────────────────
+/**
+ * @typedef {Object} FetchHistoryOptions
+ * @property {string} [projectName] - Project name (required for Claude)
+ * @property {string} [projectPath] - Absolute project path (required for Cursor cwdId hash)
+ * @property {number|null} [limit] - Page size (null = all messages)
+ * @property {number} [offset] - Pagination offset (default: 0)
+ */
+/**
+ * @typedef {Object} FetchHistoryResult
+ * @property {NormalizedMessage[]} messages - Normalized messages
+ * @property {number} total - Total number of messages in the session
+ * @property {boolean} hasMore - Whether more messages exist before the current page
+ * @property {number} offset - Current offset
+ * @property {number|null} limit - Page size used
+ * @property {object} [tokenUsage] - Token usage data (provider-specific)
+ */
+// ─── Provider Adapter Interface ──────────────────────────────────────────────
+/**
+ * Every provider adapter MUST implement this interface.
+ *
+ * @typedef {Object} ProviderAdapter
+ *
+ * @property {(sessionId: string, opts?: FetchHistoryOptions) => Promise<FetchHistoryResult>} fetchHistory
+ *   Read persisted session messages from disk/database and return them as NormalizedMessage[].
+ *   The backend calls this from the unified GET /api/sessions/:id/messages endpoint.
+ *
+ *   Provider implementations:
+ *   - Claude: reads ~/.claude/projects/{projectName}/*.jsonl
+ *   - Cursor: reads from SQLite store.db (via normalizeCursorBlobs helper)
+ *   - Codex:  reads ~/.codex/sessions/*.jsonl
+ *   - Gemini: reads from in-memory sessionManager or ~/.gemini/tmp/ JSON files
+ *
+ * @property {(raw: any, sessionId: string) => NormalizedMessage[]} normalizeMessage
+ *   Normalize a provider-specific event (JSONL entry or live SDK event) into NormalizedMessage[].
+ *   Used by provider files to convert both history and realtime events.
+ */
+// ─── Runtime Helpers ─────────────────────────────────────────────────────────
+/**
+ * Generate a unique message ID.
+ * Uses crypto.randomUUID() to avoid collisions across server restarts and workers.
+ * @param {string} [prefix='msg'] - Optional prefix
+ * @returns {string}
+ */
+export function generateMessageId(prefix = 'msg') {
+    return `${prefix}_${crypto.randomUUID()}`;
+}
+/**
+ * Create a NormalizedMessage with common fields pre-filled.
+ * @param {Partial<NormalizedMessage> & {kind: MessageKind, provider: SessionProvider}} fields
+ * @returns {NormalizedMessage}
+ */
+export function createNormalizedMessage(fields) {
+    return {
+        ...fields,
+        id: fields.id || generateMessageId(fields.kind),
+        sessionId: fields.sessionId || '',
+        timestamp: fields.timestamp || new Date().toISOString(),
+        provider: fields.provider,
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist-server/server/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../server/providers/types.js"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,gFAAgF;AAEhF;;GAEG;AAEH,gFAAgF;AAEhF;;;;GAIG;AAEH,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,gFAAgF;AAEhF;;;;;;GAMG;AAEH;;;;;;;;GAQG;AAEH,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;GAkBG;AAEH,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAM,GAAG,KAAK;IAC9C,OAAO,GAAG,MAAM,IAAI,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAM;IAC5C,OAAO;QACL,GAAG,MAAM;QACT,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC;QAC/C,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE;QACjC,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACvD,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;AACJ,CAAC"}

package/dist-server/server/providers/utils.js

@@ -0,0 +1,28 @@
+/**
+ * Shared provider utilities.
+ *
+ * @module providers/utils
+ */
+/**
+ * Prefixes that indicate internal/system content which should be hidden from the UI.
+ * @type {readonly string[]}
+ */
+export const INTERNAL_CONTENT_PREFIXES = Object.freeze([
+    '<command-name>',
+    '<command-message>',
+    '<command-args>',
+    '<local-command-stdout>',
+    '<system-reminder>',
+    'Caveat:',
+    'This session is being continued from a previous',
+    '[Request interrupted',
+]);
+/**
+ * Check if user text content is internal/system that should be skipped.
+ * @param {string} content
+ * @returns {boolean}
+ */
+export function isInternalContent(content) {
+    return INTERNAL_CONTENT_PREFIXES.some(prefix => content.startsWith(prefix));
+}
+//# sourceMappingURL=utils.js.map

package/dist-server/server/providers/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../server/providers/utils.js"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,MAAM,CAAC;IACrD,gBAAgB;IAChB,mBAAmB;IACnB,gBAAgB;IAChB,wBAAwB;IACxB,mBAAmB;IACnB,SAAS;IACT,iDAAiD;IACjD,sBAAsB;CACvB,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAO;IACvC,OAAO,yBAAyB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AAC9E,CAAC"}