@ai-devkit/agent-manager 0.35.0 → 0.37.0

package/dist/{providers → harnesses}/gemini/GeminiSessionParser.d.ts

@@ -1,4 +1,4 @@
-import type { ConversationMessage, SessionSummary } from "../../adapters/AgentAdapter.js";
+import type { ConversationMessage, ConversationOptions, SessionSummary } from "../../adapters/AgentAdapter.js";
 import { AgentStatus } from "../../adapters/AgentAdapter.js";
 /**
  * A single Gemini CLI message content part. Mirrors the `{text?: string}`
@@ -47,27 +47,54 @@ export interface GeminiSession {
     lastMessageType?: string;
 }
 export declare class GeminiSessionParser {
+    private readonly sessionCache;
     /**
      * Parse session file content into GeminiSession.
-     * Uses cached content if available, otherwise reads from disk.
+     * Uses the given content if available; otherwise reads from disk, reusing
+     * the previous result while the file's inode, size and mtime are unchanged.
      */
     parseSession(cachedContent: string | undefined, filePath: string): GeminiSession | null;
+    private rememberSession;
+    private buildSession;
     determineStatus(session: GeminiSession): AgentStatus;
     /**
      * Read the full conversation from a Gemini CLI session JSON file.
      *
      * Gemini sessions store messages in an array with `type` field — typically
      * 'user' or 'gemini' for visible turns, with tool and system entries mixed in.
+     *
+     * `tail` only slices the result: the session is a single JSON document, so
+     * it cannot be read from the end and is always parsed in full. Callers that
+     * poll (the console preview) rely on their mtime cache to skip re-parses.
      */
-    getConversation(sessionFilePath: string, options?: {
-        verbose?: boolean;
-    }): ConversationMessage[];
+    getConversation(sessionFilePath: string, options?: ConversationOptions): ConversationMessage[];
     /**
      * Read a Gemini session JSON file and produce a {@link SessionSummary}.
      * Returns null when the file is unreadable, the JSON doesn't parse,
      * or the body lacks a sessionId.
      */
     fileToSessionSummary(filePath: string): SessionSummary | null;
+    /**
+     * Parse either session format into the legacy single-document shape:
+     * `session-*.json` is one JSON document, `session-*.jsonl` (Gemini CLI
+     * 0.46+) is an append-only log replayed by {@link replaySessionLog}.
+     */
+    private parseSessionContent;
+    /**
+     * Rebuild a session document from a `.jsonl` log, mirroring Gemini CLI's
+     * own loader (`loadConversationRecord`):
+     * - a record with a string `id` is a message, upserted by id in place;
+     * - `{"$set": {...}}` merges metadata; a `$set.messages` array replaces
+     *   every message;
+     * - `{"$rewindTo": id}` drops that message and all later ones (all
+     *   messages when the id is unknown);
+     * - a record with `sessionId` and `projectHash` (line 1) merges metadata.
+     * Unknown operators, non-object lines and a torn trailing line (a write
+     * in progress) are ignored.
+     */
+    private replaySessionLog;
+    private rewindMessages;
+    private parseLogRecord;
     private parseSessionJson;
     private readSessionFile;
     private roleForEntry;
@@ -87,8 +114,8 @@ export declare class GeminiSessionParser {
      */
     private resolveContent;
     private extractFirstUserMessage;
-    private parseTimestamp;
-    private truncate;
 }
+/** Gemini CLI 0.46+ writes sessions as append-only `.jsonl` logs. */
+export declare function isSessionLogPath(filePath: string): boolean;
 export {};
 //# sourceMappingURL=GeminiSessionParser.d.ts.map

package/dist/harnesses/gemini/GeminiSessionParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeminiSessionParser.d.ts","sourceRoot":"","sources":["../../../src/harnesses/gemini/GeminiSessionParser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACf,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAM7D;;;;;;GAMG;AACH,UAAU,iBAAiB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,KAAK,oBAAoB,GAAG,MAAM,GAAG,iBAAiB,EAAE,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IACjC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,cAAc,CAAC,EAAE,oBAAoB,CAAC;CACvC;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,IAAI,CAAC;IACnB,UAAU,EAAE,IAAI,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAWD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0C;IAEvE;;;;OAIG;IACH,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAmBvF,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,YAAY;IAiCpB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,WAAW;IAYpD;;;;;;;;;OASG;IACH,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,EAAE;IA0B9F;;;;OAIG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAkC7D;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,gBAAgB;IAmCxB,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,cAAc;IAWtB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAMnB;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IActB,OAAO,CAAC,uBAAuB;CAQhC;AAED,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D"}

package/dist/harnesses/gemini/GeminiSessionParser.js

@@ -0,0 +1,272 @@
+import * as fs from "fs";
+import { AgentStatus } from "../../adapters/AgentAdapter.js";
+import { sliceTail } from "../../utils/jsonlTail.js";
+import { safeReadFile, safeStat } from "../../utils/session.js";
+import { fileSignature } from "./fileSignature.js";
+import { isIdle, parseTimestamp, SUMMARY_MAX_LENGTH, truncate } from "../shared.js";
+const SESSION_LOG_EXTENSION = ".jsonl";
+/** Parsed sessions are small (summary is truncated); cap entries, not bytes. */ const MAX_CACHED_SESSIONS = 256;
+export class GeminiSessionParser {
+    sessionCache = new Map();
+    /**
+   * Parse session file content into GeminiSession.
+   * Uses the given content if available; otherwise reads from disk, reusing
+   * the previous result while the file's inode, size and mtime are unchanged.
+   */ parseSession(cachedContent, filePath) {
+        const fileStat = safeStat(filePath);
+        if (cachedContent !== undefined) return this.buildSession(cachedContent, filePath, fileStat);
+        if (!fileStat) {
+            this.sessionCache.delete(filePath);
+            return null;
+        }
+        const signature = fileSignature(fileStat);
+        const cached = this.sessionCache.get(filePath);
+        if (cached?.signature === signature) return cached.session;
+        const content = this.readSessionFile(filePath);
+        const session = content === null ? null : this.buildSession(content, filePath, fileStat);
+        this.rememberSession(filePath, {
+            signature,
+            session
+        });
+        return session;
+    }
+    rememberSession(filePath, entry) {
+        this.sessionCache.delete(filePath);
+        this.sessionCache.set(filePath, entry);
+        while(this.sessionCache.size > MAX_CACHED_SESSIONS){
+            const oldest = this.sessionCache.keys().next().value;
+            if (oldest === undefined) break;
+            this.sessionCache.delete(oldest);
+        }
+    }
+    buildSession(content, filePath, fileStat) {
+        const parsed = this.parseSessionContent(content, filePath);
+        if (!parsed?.sessionId) return null;
+        const messages = Array.isArray(parsed.messages) ? parsed.messages : [];
+        const lastEntry = messages.length > 0 ? messages[messages.length - 1] : undefined;
+        const lastActive = parseTimestamp(parsed.lastUpdated) || parseTimestamp(lastEntry?.timestamp) || fileStat?.mtime || new Date();
+        const sessionStart = parseTimestamp(parsed.startTime) || lastActive;
+        const projectPath = Array.isArray(parsed.directories) && parsed.directories.length > 0 ? parsed.directories[0] : "";
+        return {
+            sessionId: parsed.sessionId,
+            projectPath,
+            summary: this.extractSummary(messages),
+            sessionStart,
+            lastActive,
+            lastMessageType: lastEntry?.type
+        };
+    }
+    determineStatus(session) {
+        if (isIdle(session.lastActive)) {
+            return AgentStatus.IDLE;
+        }
+        if (session.lastMessageType === "gemini" || session.lastMessageType === "assistant") {
+            return AgentStatus.WAITING;
+        }
+        return AgentStatus.RUNNING;
+    }
+    /**
+   * Read the full conversation from a Gemini CLI session JSON file.
+   *
+   * Gemini sessions store messages in an array with `type` field — typically
+   * 'user' or 'gemini' for visible turns, with tool and system entries mixed in.
+   *
+   * `tail` only slices the result: the session is a single JSON document, so
+   * it cannot be read from the end and is always parsed in full. Callers that
+   * poll (the console preview) rely on their mtime cache to skip re-parses.
+   */ getConversation(sessionFilePath, options) {
+        const verbose = options?.verbose ?? false;
+        const content = safeReadFile(sessionFilePath);
+        if (content === undefined) return [];
+        const parsed = this.parseSessionContent(content, sessionFilePath);
+        if (!Array.isArray(parsed?.messages)) return [];
+        const messages = [];
+        for (const entry of parsed.messages){
+            const role = this.roleForEntry(entry?.type, verbose);
+            if (!role) continue;
+            const text = this.messageText(entry).trim();
+            if (!text) continue;
+            messages.push({
+                role,
+                content: text,
+                timestamp: entry.timestamp
+            });
+        }
+        return sliceTail(messages, options?.tail);
+    }
+    /**
+   * Read a Gemini session JSON file and produce a {@link SessionSummary}.
+   * Returns null when the file is unreadable, the JSON doesn't parse,
+   * or the body lacks a sessionId.
+   */ fileToSessionSummary(filePath) {
+        const content = safeReadFile(filePath);
+        if (content === undefined) return null;
+        const parsed = this.parseSessionContent(content, filePath);
+        if (!parsed?.sessionId) return null;
+        const messages = Array.isArray(parsed.messages) ? parsed.messages : [];
+        const firstUserMessage = this.extractFirstUserMessage(messages);
+        const cwd = Array.isArray(parsed.directories) && parsed.directories.length > 0 ? parsed.directories[0] : "";
+        const stat = safeStat(filePath);
+        const lastEntryTimestamp = parseTimestamp(messages.length > 0 ? messages[messages.length - 1]?.timestamp : undefined);
+        const lastActive = parseTimestamp(parsed.lastUpdated) || lastEntryTimestamp || stat?.mtime || new Date();
+        const startedAt = parseTimestamp(parsed.startTime) || stat?.birthtime || stat?.mtime || lastActive;
+        return {
+            type: "gemini_cli",
+            sessionId: parsed.sessionId,
+            cwd,
+            firstUserMessage,
+            lastActive,
+            startedAt,
+            sessionFilePath: filePath
+        };
+    }
+    /**
+   * Parse either session format into the legacy single-document shape:
+   * `session-*.json` is one JSON document, `session-*.jsonl` (Gemini CLI
+   * 0.46+) is an append-only log replayed by {@link replaySessionLog}.
+   */ parseSessionContent(content, filePath) {
+        return isSessionLogPath(filePath) ? this.replaySessionLog(content) : this.parseSessionJson(content);
+    }
+    /**
+   * Rebuild a session document from a `.jsonl` log, mirroring Gemini CLI's
+   * own loader (`loadConversationRecord`):
+   * - a record with a string `id` is a message, upserted by id in place;
+   * - `{"$set": {...}}` merges metadata; a `$set.messages` array replaces
+   *   every message;
+   * - `{"$rewindTo": id}` drops that message and all later ones (all
+   *   messages when the id is unknown);
+   * - a record with `sessionId` and `projectHash` (line 1) merges metadata.
+   * Unknown operators, non-object lines and a torn trailing line (a write
+   * in progress) are ignored.
+   */ replaySessionLog(content) {
+        let metadata = {};
+        const messages = new Map();
+        const upsertAll = (entries)=>{
+            if (!Array.isArray(entries)) return;
+            for (const entry of entries){
+                if (isRecord(entry) && typeof entry.id === "string") messages.set(entry.id, entry);
+            }
+        };
+        for (const line of content.split("\n")){
+            if (!line.trim()) continue;
+            const record = this.parseLogRecord(line);
+            if (!record) continue;
+            if (typeof record.$rewindTo === "string") {
+                this.rewindMessages(messages, record.$rewindTo);
+            } else if (typeof record.id === "string") {
+                messages.set(record.id, record);
+            } else if (isRecord(record.$set)) {
+                if (Array.isArray(record.$set.messages)) {
+                    messages.clear();
+                    upsertAll(record.$set.messages);
+                }
+                metadata = {
+                    ...metadata,
+                    ...record.$set
+                };
+            } else if (typeof record.sessionId === "string" && typeof record.projectHash === "string") {
+                metadata = {
+                    ...metadata,
+                    ...record
+                };
+                upsertAll(record.messages);
+            }
+        }
+        if (typeof metadata.sessionId !== "string") return null;
+        return {
+            ...metadata,
+            messages: Array.from(messages.values())
+        };
+    }
+    rewindMessages(messages, messageId) {
+        if (!messages.has(messageId)) {
+            messages.clear();
+            return;
+        }
+        let found = false;
+        for (const id of Array.from(messages.keys())){
+            if (id === messageId) found = true;
+            if (found) messages.delete(id);
+        }
+    }
+    parseLogRecord(line) {
+        try {
+            const record = JSON.parse(line);
+            return isRecord(record) ? record : null;
+        } catch  {
+            return null;
+        }
+    }
+    parseSessionJson(content) {
+        try {
+            return JSON.parse(content);
+        } catch  {
+            return null;
+        }
+    }
+    readSessionFile(filePath) {
+        try {
+            return fs.readFileSync(filePath, "utf-8");
+        } catch  {
+            return null;
+        }
+    }
+    roleForEntry(entryType, verbose) {
+        if (entryType === "user") return "user";
+        if (entryType === "gemini" || entryType === "assistant") return "assistant";
+        if (verbose && entryType) return "system";
+        return null;
+    }
+    extractSummary(messages) {
+        for(let i = messages.length - 1; i >= 0; i--){
+            const entry = messages[i];
+            if (entry?.type !== "user") continue;
+            const text = this.messageText(entry).trim();
+            if (text) return truncate(text, SUMMARY_MAX_LENGTH);
+        }
+        return "Gemini CLI session active";
+    }
+    /**
+   * Normalize an entry's content/displayContent into a plain string.
+   * Prefers displayContent when both are present (matches Gemini CLI's
+   * own rendering priority for the /chat UI).
+   */ messageText(entry) {
+        const displayText = this.resolveContent(entry.displayContent);
+        if (displayText) return displayText;
+        return this.resolveContent(entry.content);
+    }
+    /**
+   * Collapse a Gemini message content field into plain text.
+   * Accepts either a pre-joined string (assistant turns) or a Part[]
+   * list (user turns carrying `[{text: "..."}]`). Non-text part
+   * variants (data, file) are dropped since this helper is only used
+   * for summary/conversation rendering.
+   */ resolveContent(content) {
+        if (!content) return "";
+        if (typeof content === "string") return content;
+        if (!Array.isArray(content)) return "";
+        const parts = [];
+        for (const part of content){
+            if (part && typeof part.text === "string" && part.text) {
+                parts.push(part.text);
+            }
+        }
+        return parts.join("");
+    }
+    extractFirstUserMessage(messages) {
+        for (const entry of messages){
+            if (entry?.type !== "user") continue;
+            const text = this.messageText(entry).trim();
+            if (text) return text;
+        }
+        return "";
+    }
+}
+/** Gemini CLI 0.46+ writes sessions as append-only `.jsonl` logs. */ export function isSessionLogPath(filePath) {
+    return filePath.endsWith(SESSION_LOG_EXTENSION);
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+
+//# sourceMappingURL=GeminiSessionParser.js.map

package/dist/harnesses/gemini/GeminiSessionParser.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/harnesses/gemini/GeminiSessionParser.ts"],"sourcesContent":["import * as fs from \"fs\";\nimport type {\n  ConversationMessage,\n  ConversationOptions,\n  SessionSummary,\n} from \"../../adapters/AgentAdapter.js\";\nimport { AgentStatus } from \"../../adapters/AgentAdapter.js\";\nimport { sliceTail } from \"../../utils/jsonlTail.js\";\nimport { safeReadFile, safeStat } from \"../../utils/session.js\";\nimport { fileSignature } from \"./fileSignature.js\";\nimport { isIdle, parseTimestamp, SUMMARY_MAX_LENGTH, truncate } from \"../shared.js\";\n\n/**\n * A single Gemini CLI message content part. Mirrors the `{text?: string}`\n * shape that Gemini writes for user message parts (derived from the\n * Gemini API `Content.parts[]` schema). Non-text part variants (data,\n * file, etc.) are preserved via the index signature but ignored by\n * `resolveContent` since the adapter only surfaces human-readable text.\n */\ninterface GeminiContentPart {\n  text?: string;\n  [key: string]: unknown;\n}\n\ntype GeminiMessageContent = string | GeminiContentPart[];\n\nexport interface GeminiMessageEntry {\n  id?: string;\n  timestamp?: string;\n  type?: string;\n  /**\n   * Gemini CLI stores two different content shapes depending on the\n   * message origin:\n   * - `type: \"user\"` messages carry the raw Part[] from userContent.parts\n   *   (e.g. `[{ text: \"hello\" }]`).\n   * - `type: \"gemini\"` (assistant) messages carry a pre-joined string\n   *   built from `consolidatedParts.filter(p => p.text).join('').trim()`.\n   * Both forms must be normalized via resolveContent before any string\n   * operation is applied.\n   */\n  content?: GeminiMessageContent;\n  displayContent?: GeminiMessageContent;\n}\n\nexport interface GeminiSessionFile {\n  sessionId?: string;\n  projectHash?: string;\n  startTime?: string;\n  lastUpdated?: string;\n  messages?: GeminiMessageEntry[];\n  directories?: string[];\n  kind?: string;\n}\n\nexport interface GeminiSession {\n  sessionId: string;\n  projectPath: string;\n  summary: string;\n  sessionStart: Date;\n  lastActive: Date;\n  lastMessageType?: string;\n}\n\ninterface CachedParsedSession {\n  signature: string;\n  session: GeminiSession | null;\n}\n\nconst SESSION_LOG_EXTENSION = \".jsonl\";\n/** Parsed sessions are small (summary is truncated); cap entries, not bytes. */\nconst MAX_CACHED_SESSIONS = 256;\n\nexport class GeminiSessionParser {\n  private readonly sessionCache = new Map<string, CachedParsedSession>();\n\n  /**\n   * Parse session file content into GeminiSession.\n   * Uses the given content if available; otherwise reads from disk, reusing\n   * the previous result while the file's inode, size and mtime are unchanged.\n   */\n  parseSession(cachedContent: string | undefined, filePath: string): GeminiSession | null {\n    const fileStat = safeStat(filePath);\n    if (cachedContent !== undefined) return this.buildSession(cachedContent, filePath, fileStat);\n\n    if (!fileStat) {\n      this.sessionCache.delete(filePath);\n      return null;\n    }\n\n    const signature = fileSignature(fileStat);\n    const cached = this.sessionCache.get(filePath);\n    if (cached?.signature === signature) return cached.session;\n\n    const content = this.readSessionFile(filePath);\n    const session = content === null ? null : this.buildSession(content, filePath, fileStat);\n    this.rememberSession(filePath, { signature, session });\n    return session;\n  }\n\n  private rememberSession(filePath: string, entry: CachedParsedSession): void {\n    this.sessionCache.delete(filePath);\n    this.sessionCache.set(filePath, entry);\n    while (this.sessionCache.size > MAX_CACHED_SESSIONS) {\n      const oldest = this.sessionCache.keys().next().value;\n      if (oldest === undefined) break;\n      this.sessionCache.delete(oldest);\n    }\n  }\n\n  private buildSession(\n    content: string,\n    filePath: string,\n    fileStat: fs.Stats | undefined,\n  ): GeminiSession | null {\n    const parsed = this.parseSessionContent(content, filePath);\n    if (!parsed?.sessionId) return null;\n\n    const messages = Array.isArray(parsed.messages) ? parsed.messages : [];\n    const lastEntry = messages.length > 0 ? messages[messages.length - 1] : undefined;\n\n    const lastActive =\n      parseTimestamp(parsed.lastUpdated) ||\n      parseTimestamp(lastEntry?.timestamp) ||\n      fileStat?.mtime ||\n      new Date();\n\n    const sessionStart = parseTimestamp(parsed.startTime) || lastActive;\n    const projectPath =\n      Array.isArray(parsed.directories) && parsed.directories.length > 0\n        ? parsed.directories[0]\n        : \"\";\n\n    return {\n      sessionId: parsed.sessionId,\n      projectPath,\n      summary: this.extractSummary(messages),\n      sessionStart,\n      lastActive,\n      lastMessageType: lastEntry?.type,\n    };\n  }\n\n  determineStatus(session: GeminiSession): AgentStatus {\n    if (isIdle(session.lastActive)) {\n      return AgentStatus.IDLE;\n    }\n\n    if (session.lastMessageType === \"gemini\" || session.lastMessageType === \"assistant\") {\n      return AgentStatus.WAITING;\n    }\n\n    return AgentStatus.RUNNING;\n  }\n\n  /**\n   * Read the full conversation from a Gemini CLI session JSON file.\n   *\n   * Gemini sessions store messages in an array with `type` field — typically\n   * 'user' or 'gemini' for visible turns, with tool and system entries mixed in.\n   *\n   * `tail` only slices the result: the session is a single JSON document, so\n   * it cannot be read from the end and is always parsed in full. Callers that\n   * poll (the console preview) rely on their mtime cache to skip re-parses.\n   */\n  getConversation(sessionFilePath: string, options?: ConversationOptions): ConversationMessage[] {\n    const verbose = options?.verbose ?? false;\n    const content = safeReadFile(sessionFilePath);\n    if (content === undefined) return [];\n\n    const parsed = this.parseSessionContent(content, sessionFilePath);\n    if (!Array.isArray(parsed?.messages)) return [];\n\n    const messages: ConversationMessage[] = [];\n    for (const entry of parsed.messages) {\n      const role = this.roleForEntry(entry?.type, verbose);\n      if (!role) continue;\n\n      const text = this.messageText(entry).trim();\n      if (!text) continue;\n\n      messages.push({\n        role,\n        content: text,\n        timestamp: entry.timestamp,\n      });\n    }\n\n    return sliceTail(messages, options?.tail);\n  }\n\n  /**\n   * Read a Gemini session JSON file and produce a {@link SessionSummary}.\n   * Returns null when the file is unreadable, the JSON doesn't parse,\n   * or the body lacks a sessionId.\n   */\n  fileToSessionSummary(filePath: string): SessionSummary | null {\n    const content = safeReadFile(filePath);\n    if (content === undefined) return null;\n\n    const parsed = this.parseSessionContent(content, filePath);\n    if (!parsed?.sessionId) return null;\n\n    const messages = Array.isArray(parsed.messages) ? parsed.messages : [];\n    const firstUserMessage = this.extractFirstUserMessage(messages);\n    const cwd =\n      Array.isArray(parsed.directories) && parsed.directories.length > 0\n        ? parsed.directories[0]\n        : \"\";\n\n    const stat = safeStat(filePath);\n    const lastEntryTimestamp = parseTimestamp(\n      messages.length > 0 ? messages[messages.length - 1]?.timestamp : undefined,\n    );\n    const lastActive =\n      parseTimestamp(parsed.lastUpdated) || lastEntryTimestamp || stat?.mtime || new Date();\n    const startedAt =\n      parseTimestamp(parsed.startTime) || stat?.birthtime || stat?.mtime || lastActive;\n\n    return {\n      type: \"gemini_cli\",\n      sessionId: parsed.sessionId,\n      cwd,\n      firstUserMessage,\n      lastActive,\n      startedAt,\n      sessionFilePath: filePath,\n    };\n  }\n\n  /**\n   * Parse either session format into the legacy single-document shape:\n   * `session-*.json` is one JSON document, `session-*.jsonl` (Gemini CLI\n   * 0.46+) is an append-only log replayed by {@link replaySessionLog}.\n   */\n  private parseSessionContent(content: string, filePath: string): GeminiSessionFile | null {\n    return isSessionLogPath(filePath)\n      ? this.replaySessionLog(content)\n      : this.parseSessionJson(content);\n  }\n\n  /**\n   * Rebuild a session document from a `.jsonl` log, mirroring Gemini CLI's\n   * own loader (`loadConversationRecord`):\n   * - a record with a string `id` is a message, upserted by id in place;\n   * - `{\"$set\": {...}}` merges metadata; a `$set.messages` array replaces\n   *   every message;\n   * - `{\"$rewindTo\": id}` drops that message and all later ones (all\n   *   messages when the id is unknown);\n   * - a record with `sessionId` and `projectHash` (line 1) merges metadata.\n   * Unknown operators, non-object lines and a torn trailing line (a write\n   * in progress) are ignored.\n   */\n  private replaySessionLog(content: string): GeminiSessionFile | null {\n    let metadata: Record<string, unknown> = {};\n    const messages = new Map<string, GeminiMessageEntry>();\n    const upsertAll = (entries: unknown): void => {\n      if (!Array.isArray(entries)) return;\n      for (const entry of entries) {\n        if (isRecord(entry) && typeof entry.id === \"string\") messages.set(entry.id, entry);\n      }\n    };\n\n    for (const line of content.split(\"\\n\")) {\n      if (!line.trim()) continue;\n      const record = this.parseLogRecord(line);\n      if (!record) continue;\n\n      if (typeof record.$rewindTo === \"string\") {\n        this.rewindMessages(messages, record.$rewindTo);\n      } else if (typeof record.id === \"string\") {\n        messages.set(record.id, record);\n      } else if (isRecord(record.$set)) {\n        if (Array.isArray(record.$set.messages)) {\n          messages.clear();\n          upsertAll(record.$set.messages);\n        }\n        metadata = { ...metadata, ...record.$set };\n      } else if (typeof record.sessionId === \"string\" && typeof record.projectHash === \"string\") {\n        metadata = { ...metadata, ...record };\n        upsertAll(record.messages);\n      }\n    }\n\n    if (typeof metadata.sessionId !== \"string\") return null;\n    return { ...(metadata as GeminiSessionFile), messages: Array.from(messages.values()) };\n  }\n\n  private rewindMessages(messages: Map<string, GeminiMessageEntry>, messageId: string): void {\n    if (!messages.has(messageId)) {\n      messages.clear();\n      return;\n    }\n    let found = false;\n    for (const id of Array.from(messages.keys())) {\n      if (id === messageId) found = true;\n      if (found) messages.delete(id);\n    }\n  }\n\n  private parseLogRecord(line: string): Record<string, unknown> | null {\n    try {\n      const record: unknown = JSON.parse(line);\n      return isRecord(record) ? record : null;\n    } catch {\n      return null;\n    }\n  }\n\n  private parseSessionJson(content: string): GeminiSessionFile | null {\n    try {\n      return JSON.parse(content) as GeminiSessionFile;\n    } catch {\n      return null;\n    }\n  }\n\n  private readSessionFile(filePath: string): string | null {\n    try {\n      return fs.readFileSync(filePath, \"utf-8\");\n    } catch {\n      return null;\n    }\n  }\n\n  private roleForEntry(\n    entryType: string | undefined,\n    verbose: boolean,\n  ): ConversationMessage[\"role\"] | null {\n    if (entryType === \"user\") return \"user\";\n    if (entryType === \"gemini\" || entryType === \"assistant\") return \"assistant\";\n    if (verbose && entryType) return \"system\";\n    return null;\n  }\n\n  private extractSummary(messages: GeminiMessageEntry[]): string {\n    for (let i = messages.length - 1; i >= 0; i--) {\n      const entry = messages[i];\n      if (entry?.type !== \"user\") continue;\n      const text = this.messageText(entry).trim();\n      if (text) return truncate(text, SUMMARY_MAX_LENGTH);\n    }\n\n    return \"Gemini CLI session active\";\n  }\n\n  /**\n   * Normalize an entry's content/displayContent into a plain string.\n   * Prefers displayContent when both are present (matches Gemini CLI's\n   * own rendering priority for the /chat UI).\n   */\n  private messageText(entry: GeminiMessageEntry): string {\n    const displayText = this.resolveContent(entry.displayContent);\n    if (displayText) return displayText;\n    return this.resolveContent(entry.content);\n  }\n\n  /**\n   * Collapse a Gemini message content field into plain text.\n   * Accepts either a pre-joined string (assistant turns) or a Part[]\n   * list (user turns carrying `[{text: \"...\"}]`). Non-text part\n   * variants (data, file) are dropped since this helper is only used\n   * for summary/conversation rendering.\n   */\n  private resolveContent(content: GeminiMessageContent | undefined): string {\n    if (!content) return \"\";\n    if (typeof content === \"string\") return content;\n    if (!Array.isArray(content)) return \"\";\n\n    const parts: string[] = [];\n    for (const part of content) {\n      if (part && typeof part.text === \"string\" && part.text) {\n        parts.push(part.text);\n      }\n    }\n    return parts.join(\"\");\n  }\n\n  private extractFirstUserMessage(messages: GeminiMessageEntry[]): string {\n    for (const entry of messages) {\n      if (entry?.type !== \"user\") continue;\n      const text = this.messageText(entry).trim();\n      if (text) return text;\n    }\n    return \"\";\n  }\n}\n\n/** Gemini CLI 0.46+ writes sessions as append-only `.jsonl` logs. */\nexport function isSessionLogPath(filePath: string): boolean {\n  return filePath.endsWith(SESSION_LOG_EXTENSION);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n"],"names":["fs","AgentStatus","sliceTail","safeReadFile","safeStat","fileSignature","isIdle","parseTimestamp","SUMMARY_MAX_LENGTH","truncate","SESSION_LOG_EXTENSION","MAX_CACHED_SESSIONS","GeminiSessionParser","sessionCache","Map","parseSession","cachedContent","filePath","fileStat","undefined","buildSession","delete","signature","cached","get","session","content","readSessionFile","rememberSession","entry","set","size","oldest","keys","next","value","parsed","parseSessionContent","sessionId","messages","Array","isArray","lastEntry","length","lastActive","lastUpdated","timestamp","mtime","Date","sessionStart","startTime","projectPath","directories","summary","extractSummary","lastMessageType","type","determineStatus","IDLE","WAITING","RUNNING","getConversation","sessionFilePath","options","verbose","role","roleForEntry","text","messageText","trim","push","tail","fileToSessionSummary","firstUserMessage","extractFirstUserMessage","cwd","stat","lastEntryTimestamp","startedAt","birthtime","isSessionLogPath","replaySessionLog","parseSessionJson","metadata","upsertAll","entries","isRecord","id","line","split","record","parseLogRecord","$rewindTo","rewindMessages","$set","clear","projectHash","from","values","messageId","has","found","JSON","parse","readFileSync","entryType","i","displayText","resolveContent","displayContent","parts","part","join","endsWith"],"mappings":"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"}

package/dist/harnesses/gemini/fileSignature.d.ts

@@ -0,0 +1,8 @@
+import type * as fs from "fs";
+/**
+ * Identity of a file's current contents derived from `stat` alone:
+ * inode, size and mtime. Used to reuse metadata and parse results across
+ * refreshes without re-reading unchanged Gemini chat files.
+ */
+export declare function fileSignature(stat: fs.Stats): string;
+//# sourceMappingURL=fileSignature.d.ts.map

package/dist/harnesses/gemini/fileSignature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileSignature.d.ts","sourceRoot":"","sources":["../../../src/harnesses/gemini/fileSignature.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,EAAE,MAAM,IAAI,CAAC;AAE9B;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,GAAG,MAAM,CAEpD"}

package/dist/harnesses/gemini/fileSignature.js

@@ -0,0 +1,9 @@
+/**
+ * Identity of a file's current contents derived from `stat` alone:
+ * inode, size and mtime. Used to reuse metadata and parse results across
+ * refreshes without re-reading unchanged Gemini chat files.
+ */ export function fileSignature(stat) {
+    return `${stat.ino}:${stat.size}:${stat.mtimeMs}`;
+}
+
+//# sourceMappingURL=fileSignature.js.map

package/dist/harnesses/gemini/fileSignature.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/harnesses/gemini/fileSignature.ts"],"sourcesContent":["import type * as fs from \"fs\";\n\n/**\n * Identity of a file's current contents derived from `stat` alone:\n * inode, size and mtime. Used to reuse metadata and parse results across\n * refreshes without re-reading unchanged Gemini chat files.\n */\nexport function fileSignature(stat: fs.Stats): string {\n  return `${stat.ino}:${stat.size}:${stat.mtimeMs}`;\n}\n"],"names":["fileSignature","stat","ino","size","mtimeMs"],"mappings":"AAEA;;;;CAIC,GACD,OAAO,SAASA,cAAcC,IAAc;IAC1C,OAAO,GAAGA,KAAKC,GAAG,CAAC,CAAC,EAAED,KAAKE,IAAI,CAAC,CAAC,EAAEF,KAAKG,OAAO,EAAE;AACnD"}

package/dist/{providers → harnesses}/grok/GrokAgentMapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GrokAgentMapper.d.ts","sourceRoot":"","sources":["../../../src/providers/grok/GrokAgentMapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAG7E,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE7E,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,GAAE,iBAA2C;IAEhF,iBAAiB,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,qBAAqB,GAAG,SAAS;IAc7E,mFAAmF;IACnF,mBAAmB,CAAC,WAAW,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS;CAYtE"}
+{"version":3,"file":"GrokAgentMapper.d.ts","sourceRoot":"","sources":["../../../src/harnesses/grok/GrokAgentMapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAG7E,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE7E,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,GAAE,iBAA2C;IAEhF,iBAAiB,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,qBAAqB,GAAG,SAAS;IAc7E,mFAAmF;IACnF,mBAAmB,CAAC,WAAW,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS;CAGtE"}

package/dist/{providers → harnesses}/grok/GrokAgentMapper.js

@@ -1,5 +1,5 @@
-import { AgentStatus } from "../../adapters/AgentAdapter.js";
 import { generateAgentName } from "../../utils/matching.js";
+import { processOnlyAgent } from "../shared.js";
 import { GrokSessionParser } from "./GrokSessionParser.js";
 export class GrokAgentMapper {
     parser;
@@ -20,16 +20,10 @@ export class GrokAgentMapper {
         };
     }
     /** `cwd` is already resolved by the locator (registry first, then process cwd). */ mapProcessOnlyAgent(processInfo, cwd) {
-        return {
-            name: generateAgentName(cwd, processInfo.pid),
-            type: "grok_cli",
-            status: AgentStatus.RUNNING,
+        return processOnlyAgent("grok_cli", processInfo, {
             summary: "Grok CLI process running",
-            pid: processInfo.pid,
-            projectPath: cwd,
-            sessionId: `pid-${processInfo.pid}`,
-            lastActive: new Date()
-        };
+            cwd
+        });
     }
 }
 

package/dist/harnesses/grok/GrokAgentMapper.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/harnesses/grok/GrokAgentMapper.ts"],"sourcesContent":["import type { AgentInfo, ProcessInfo } from \"../../adapters/AgentAdapter.js\";\nimport { generateAgentName } from \"../../utils/matching.js\";\nimport { processOnlyAgent } from \"../shared.js\";\nimport { GrokSessionParser, type GrokSession } from \"./GrokSessionParser.js\";\n\nexport interface GrokSessionAgentInput {\n  session: GrokSession;\n  processInfo: ProcessInfo;\n}\n\nexport class GrokAgentMapper {\n  constructor(private readonly parser: GrokSessionParser = new GrokSessionParser()) {}\n\n  mapSessionToAgent({ session, processInfo }: GrokSessionAgentInput): AgentInfo {\n    return {\n      name: generateAgentName(session.projectPath, processInfo.pid),\n      type: \"grok_cli\",\n      status: this.parser.determineStatus(session),\n      summary: session.lastUserMessage || \"Grok CLI session active\",\n      pid: processInfo.pid,\n      projectPath: session.projectPath,\n      sessionId: session.sessionId,\n      lastActive: session.lastActive,\n      sessionFilePath: session.sessionFilePath,\n    };\n  }\n\n  /** `cwd` is already resolved by the locator (registry first, then process cwd). */\n  mapProcessOnlyAgent(processInfo: ProcessInfo, cwd: string): AgentInfo {\n    return processOnlyAgent(\"grok_cli\", processInfo, { summary: \"Grok CLI process running\", cwd });\n  }\n}\n"],"names":["generateAgentName","processOnlyAgent","GrokSessionParser","GrokAgentMapper","parser","mapSessionToAgent","session","processInfo","name","projectPath","pid","type","status","determineStatus","summary","lastUserMessage","sessionId","lastActive","sessionFilePath","mapProcessOnlyAgent","cwd"],"mappings":"AACA,SAASA,iBAAiB,QAAQ,0BAA0B;AAC5D,SAASC,gBAAgB,QAAQ,eAAe;AAChD,SAASC,iBAAiB,QAA0B,yBAAyB;AAO7E,OAAO,MAAMC;;IACX,YAAY,AAAiBC,SAA4B,IAAIF,mBAAmB,CAAE;aAArDE,SAAAA;IAAsD;IAEnFC,kBAAkB,EAAEC,OAAO,EAAEC,WAAW,EAAyB,EAAa;QAC5E,OAAO;YACLC,MAAMR,kBAAkBM,QAAQG,WAAW,EAAEF,YAAYG,GAAG;YAC5DC,MAAM;YACNC,QAAQ,IAAI,CAACR,MAAM,CAACS,eAAe,CAACP;YACpCQ,SAASR,QAAQS,eAAe,IAAI;YACpCL,KAAKH,YAAYG,GAAG;YACpBD,aAAaH,QAAQG,WAAW;YAChCO,WAAWV,QAAQU,SAAS;YAC5BC,YAAYX,QAAQW,UAAU;YAC9BC,iBAAiBZ,QAAQY,eAAe;QAC1C;IACF;IAEA,iFAAiF,GACjFC,oBAAoBZ,WAAwB,EAAEa,GAAW,EAAa;QACpE,OAAOnB,iBAAiB,YAAYM,aAAa;YAAEO,SAAS;YAA4BM;QAAI;IAC9F;AACF"}

package/dist/{providers → harnesses}/grok/GrokCliAdapter.d.ts

@@ -1,4 +1,4 @@
-import type { AgentAdapter, AgentInfo, ProcessInfo, ConversationMessage, SessionSummary, ListSessionsOptions, AgentDetectionContext } from "../../adapters/AgentAdapter.js";
+import type { AgentAdapter, AgentInfo, ProcessInfo, ConversationMessage, ConversationOptions, SessionSummary, ListSessionsOptions, AgentDetectionContext } from "../../adapters/AgentAdapter.js";
 /**
  * Grok Build CLI Adapter
  *
@@ -15,6 +15,8 @@ import type { AgentAdapter, AgentInfo, ProcessInfo, ConversationMessage, Session
  *    record of the conversation). The last user turn (the text inside
  *    <user_query>...</user_query>) is the summary; the file's mtime is the last
  *    activity time. summary.json / updates.jsonl are intentionally not used.
+ *    The summary is cached incrementally across refreshes, so an unchanged
+ *    transcript is not re-read and an appended one is read only from its tail.
  */
 export declare class GrokCliAdapter implements AgentAdapter {
     readonly type: "grok_cli";
@@ -24,11 +26,9 @@ export declare class GrokCliAdapter implements AgentAdapter {
     private locator;
     constructor();
     canHandle(processInfo: ProcessInfo): boolean;
-    private isGrokExecutable;
     detectAgents(context?: AgentDetectionContext): Promise<AgentInfo[]>;
-    getConversation(sessionFilePath: string, options?: {
-        verbose?: boolean;
-    }): ConversationMessage[];
+    private detectRunningAgents;
+    getConversation(sessionFilePath: string, options?: ConversationOptions): ConversationMessage[];
     listSessions(opts?: ListSessionsOptions): Promise<SessionSummary[]>;
     findSessionsById(sessionId: string): Promise<SessionSummary[]>;
     private toSessionSummary;

package/dist/harnesses/grok/GrokCliAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GrokCliAdapter.d.ts","sourceRoot":"","sources":["../../../src/harnesses/grok/GrokCliAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,gCAAgC,CAAC;AAMxC;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,cAAe,YAAW,YAAY;IACjD,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;IACpC,QAAQ,CAAC,YAAY,oBAAqB;IAE1C,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAqB;;IAQpC,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO;IAItC,YAAY,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;YAS3D,mBAAmB;IAoBjC,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,EAAE;IAIxF,YAAY,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAgBnE,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAapE,OAAO,CAAC,gBAAgB;CAWzB"}

package/dist/{providers → harnesses}/grok/GrokCliAdapter.js

@@ -1,4 +1,4 @@
-import { captureProcessSnapshot, executableBasename, filterByProcessNames } from "../../utils/process.js";
+import { findHarnessProcesses, matchesExecutable } from "../shared.js";
 import { GrokAgentMapper } from "./GrokAgentMapper.js";
 import { GrokSessionLocator } from "./GrokSessionLocator.js";
 import { GrokSessionParser } from "./GrokSessionParser.js";
@@ -18,6 +18,8 @@ import { GrokSessionParser } from "./GrokSessionParser.js";
  *    record of the conversation). The last user turn (the text inside
  *    <user_query>...</user_query>) is the summary; the file's mtime is the last
  *    activity time. summary.json / updates.jsonl are intentionally not used.
+ *    The summary is cached incrementally across refreshes, so an unchanged
+ *    transcript is not re-read and an appended one is read only from its tail.
  */ export class GrokCliAdapter {
     type = "grok_cli";
     processNames = [
@@ -32,22 +34,24 @@ import { GrokSessionParser } from "./GrokSessionParser.js";
         this.locator = new GrokSessionLocator();
     }
     canHandle(processInfo) {
-        return this.isGrokExecutable(processInfo.command);
-    }
-    isGrokExecutable(command) {
-        const base = executableBasename(command);
-        return base === "grok" || base === "grok.exe";
+        return matchesExecutable(processInfo.command, "grok");
     }
     async detectAgents(context) {
-        const snapshot = context?.processes ?? await captureProcessSnapshot(this.processNames);
-        const relevant = filterByProcessNames(snapshot, this.processNames);
-        const processes = relevant.filter((process)=>this.canHandle(process));
+        try {
+            return await this.detectRunningAgents(context);
+        } finally{
+            // Drop cached summaries for sessions that were not part of this refresh
+            this.parser.pruneSessionCache();
+        }
+    }
+    async detectRunningAgents(context) {
+        const { processes } = await findHarnessProcesses(this, context);
         if (processes.length === 0) {
             return [];
         }
         const agents = [];
         for (const { process: proc, cwd, sessionDir } of this.locator.matchRunningProcesses(processes)){
-            const session = sessionDir ? this.parser.readSession(sessionDir, cwd) : null;
+            const session = sessionDir ? this.parser.readSessionIncremental(sessionDir, cwd) : null;
             if (session) {
                 agents.push(this.mapper.mapSessionToAgent({
                     session,

package/dist/harnesses/grok/GrokCliAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/harnesses/grok/GrokCliAdapter.ts"],"sourcesContent":["import type {\n  AgentAdapter,\n  AgentInfo,\n  ProcessInfo,\n  ConversationMessage,\n  ConversationOptions,\n  SessionSummary,\n  ListSessionsOptions,\n  AgentDetectionContext,\n} from \"../../adapters/AgentAdapter.js\";\nimport { findHarnessProcesses, matchesExecutable } from \"../shared.js\";\nimport { GrokAgentMapper } from \"./GrokAgentMapper.js\";\nimport { GrokSessionLocator } from \"./GrokSessionLocator.js\";\nimport { GrokSessionParser, type GrokSession } from \"./GrokSessionParser.js\";\n\n/**\n * Grok Build CLI Adapter\n *\n * Detects running Grok Build CLI agents by:\n * 1. Filtering `grok` processes from a shared asynchronous snapshot — Grok is\n *    a native binary at ~/.grok/bin/grok, so argv[0] basename is `grok`.\n * 2. Resolving each live process to its working directory via\n *    ~/.grok/active_sessions.json, which Grok maintains as a list of\n *    { pid, cwd, opened_at } for every running session. The cwd is then encoded\n *    into the session group dir ~/.grok/sessions/<encodeURIComponent(cwd)>/, and\n *    the most recently active session subdirectory is picked from it. The\n *    process cwd from lsof is only a fallback when the PID is not registered.\n * 3. Reading the session transcript from chat_history.jsonl (the authoritative\n *    record of the conversation). The last user turn (the text inside\n *    <user_query>...</user_query>) is the summary; the file's mtime is the last\n *    activity time. summary.json / updates.jsonl are intentionally not used.\n *    The summary is cached incrementally across refreshes, so an unchanged\n *    transcript is not re-read and an appended one is read only from its tail.\n */\nexport class GrokCliAdapter implements AgentAdapter {\n  readonly type = \"grok_cli\" as const;\n  readonly processNames = [\"grok\"] as const;\n\n  private parser: GrokSessionParser;\n  private mapper: GrokAgentMapper;\n  private locator: GrokSessionLocator;\n\n  constructor() {\n    this.parser = new GrokSessionParser();\n    this.mapper = new GrokAgentMapper(this.parser);\n    this.locator = new GrokSessionLocator();\n  }\n\n  canHandle(processInfo: ProcessInfo): boolean {\n    return matchesExecutable(processInfo.command, \"grok\");\n  }\n\n  async detectAgents(context?: AgentDetectionContext): Promise<AgentInfo[]> {\n    try {\n      return await this.detectRunningAgents(context);\n    } finally {\n      // Drop cached summaries for sessions that were not part of this refresh\n      this.parser.pruneSessionCache();\n    }\n  }\n\n  private async detectRunningAgents(context?: AgentDetectionContext): Promise<AgentInfo[]> {\n    const { processes } = await findHarnessProcesses(this, context);\n    if (processes.length === 0) {\n      return [];\n    }\n\n    const agents: AgentInfo[] = [];\n    for (const { process: proc, cwd, sessionDir } of this.locator.matchRunningProcesses(\n      processes,\n    )) {\n      const session = sessionDir ? this.parser.readSessionIncremental(sessionDir, cwd) : null;\n      if (session) {\n        agents.push(this.mapper.mapSessionToAgent({ session, processInfo: proc }));\n      } else {\n        agents.push(this.mapper.mapProcessOnlyAgent(proc, cwd));\n      }\n    }\n    return agents;\n  }\n\n  getConversation(sessionFilePath: string, options?: ConversationOptions): ConversationMessage[] {\n    return this.parser.getConversation(sessionFilePath, options);\n  }\n\n  async listSessions(opts?: ListSessionsOptions): Promise<SessionSummary[]> {\n    const filterCwd = opts?.cwd;\n    const summaries: SessionSummary[] = [];\n\n    for (const { sessionDir, defaultCwd } of this.locator.discoverHistoricalSessionDirs()) {\n      const session = this.parser.readSession(sessionDir, defaultCwd);\n      if (!session) continue;\n\n      if (filterCwd !== undefined && session.projectPath !== filterCwd) continue;\n\n      summaries.push(this.toSessionSummary(session));\n    }\n\n    return summaries;\n  }\n\n  async findSessionsById(sessionId: string): Promise<SessionSummary[]> {\n    const summaries: SessionSummary[] = [];\n    for (const { sessionDir, defaultCwd } of this.locator.findHistoricalSessionDirsById(\n      sessionId,\n    )) {\n      const session = this.parser.readSession(sessionDir, defaultCwd);\n      if (!session) continue;\n\n      summaries.push(this.toSessionSummary(session));\n    }\n    return summaries;\n  }\n\n  private toSessionSummary(session: GrokSession): SessionSummary {\n    return {\n      type: this.type,\n      sessionId: session.sessionId,\n      cwd: session.projectPath,\n      firstUserMessage: session.firstUserMessage || \"\",\n      lastActive: session.lastActive,\n      startedAt: session.sessionStart,\n      sessionFilePath: session.sessionFilePath,\n    };\n  }\n}\n"],"names":["findHarnessProcesses","matchesExecutable","GrokAgentMapper","GrokSessionLocator","GrokSessionParser","GrokCliAdapter","type","processNames","parser","mapper","locator","canHandle","processInfo","command","detectAgents","context","detectRunningAgents","pruneSessionCache","processes","length","agents","process","proc","cwd","sessionDir","matchRunningProcesses","session","readSessionIncremental","push","mapSessionToAgent","mapProcessOnlyAgent","getConversation","sessionFilePath","options","listSessions","opts","filterCwd","summaries","defaultCwd","discoverHistoricalSessionDirs","readSession","undefined","projectPath","toSessionSummary","findSessionsById","sessionId","findHistoricalSessionDirsById","firstUserMessage","lastActive","startedAt","sessionStart"],"mappings":"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"}

package/dist/{providers → harnesses}/grok/GrokSessionLocator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GrokSessionLocator.d.ts","sourceRoot":"","sources":["../../../src/providers/grok/GrokSessionLocator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAoBlE,iFAAiF;AACjF,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,WAAW,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,wEAAwE;AACxE,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,OAAO,GAAE,yBAA8B;IASnD;;;;;;OAMG;IACH,qBAAqB,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,gBAAgB,EAAE;IAQnE,4EAA4E;IAC5E,6BAA6B,IAAI,cAAc,EAAE;IAUjD,yEAAyE;IACzE,6BAA6B,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE;IAalE;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,UAAU;IAYlB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAMvB;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;CASvB"}
+{"version":3,"file":"GrokSessionLocator.d.ts","sourceRoot":"","sources":["../../../src/harnesses/grok/GrokSessionLocator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAqBlE,iFAAiF;AACjF,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,WAAW,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,wEAAwE;AACxE,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,OAAO,GAAE,yBAA8B;IAQnD;;;;;;OAMG;IACH,qBAAqB,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,gBAAgB,EAAE;IAQnE,4EAA4E;IAC5E,6BAA6B,IAAI,cAAc,EAAE;IAUjD,yEAAyE;IACzE,6BAA6B,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE;IAalE;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,UAAU;IAYlB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAMvB;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;CASvB"}

package/dist/{providers → harnesses}/grok/GrokSessionLocator.js

@@ -1,5 +1,6 @@
 import * as path from "path";
 import { isDirectory, isSafePathSegment, safeReadFile, safeReaddir, safeStat } from "../../utils/session.js";
+import { homeDir } from "../shared.js";
 import { CHAT_HISTORY_FILE } from "./GrokSessionParser.js";
 const ACTIVE_SESSIONS_FILE = "active_sessions.json";
 const CWD_FILE = ".cwd";
@@ -10,8 +11,7 @@ export class GrokSessionLocator {
         // GROK_HOME overrides the ~/.grok base directory; sessions live under
         // <base>/sessions/ and the active-session registry at
         // <base>/active_sessions.json.
-        const homeDir = process.env.HOME || process.env.USERPROFILE || "";
-        this.baseDir = options.baseDir ?? (process.env.GROK_HOME || path.join(homeDir, ".grok"));
+        this.baseDir = options.baseDir ?? (process.env.GROK_HOME || path.join(homeDir(), ".grok"));
         this.sessionsDir = path.join(this.baseDir, "sessions");
     }
     /**

package/dist/harnesses/grok/GrokSessionLocator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/harnesses/grok/GrokSessionLocator.ts"],"sourcesContent":["import * as path from \"path\";\nimport type { ProcessInfo } from \"../../adapters/AgentAdapter.js\";\nimport {\n  isDirectory,\n  isSafePathSegment,\n  safeReadFile,\n  safeReaddir,\n  safeStat,\n} from \"../../utils/session.js\";\nimport { homeDir } from \"../shared.js\";\nimport { CHAT_HISTORY_FILE } from \"./GrokSessionParser.js\";\n\nconst ACTIVE_SESSIONS_FILE = \"active_sessions.json\";\nconst CWD_FILE = \".cwd\";\n\n/** One entry of ~/.grok/active_sessions.json. */\ninterface ActiveSessionEntry {\n  pid?: number;\n  cwd?: string;\n  opened_at?: number | string;\n}\n\n/** A live Grok process paired with its resolved cwd and (if any) session dir. */\nexport interface GrokProcessMatch {\n  process: ProcessInfo;\n  cwd: string;\n  sessionDir: string | null;\n}\n\n/** A historical session dir plus the cwd decoded from its group dir. */\nexport interface GrokSessionDir {\n  sessionDir: string;\n  defaultCwd: string;\n}\n\nexport interface GrokSessionLocatorOptions {\n  /** Overrides the ~/.grok base directory (defaults to GROK_HOME or ~/.grok). */\n  baseDir?: string;\n}\n\nexport class GrokSessionLocator {\n  private readonly baseDir: string;\n  private readonly sessionsDir: string;\n\n  constructor(options: GrokSessionLocatorOptions = {}) {\n    // GROK_HOME overrides the ~/.grok base directory; sessions live under\n    // <base>/sessions/ and the active-session registry at\n    // <base>/active_sessions.json.\n    this.baseDir = options.baseDir ?? (process.env.GROK_HOME || path.join(homeDir(), \".grok\"));\n    this.sessionsDir = path.join(this.baseDir, \"sessions\");\n  }\n\n  /**\n   * Pair live Grok processes with their session dirs.\n   *\n   * active_sessions.json is the authoritative pid -> cwd map for live\n   * sessions; the lsof-derived process cwd is only a fallback. The most\n   * recently active session under that cwd's group dir is picked.\n   */\n  matchRunningProcesses(processes: ProcessInfo[]): GrokProcessMatch[] {\n    const pidToCwd = this.readActiveSessions();\n    return processes.map((proc) => {\n      const cwd = pidToCwd.get(proc.pid) || proc.cwd || \"\";\n      return { process: proc, cwd, sessionDir: cwd ? this.latestSessionDir(cwd) : null };\n    });\n  }\n\n  /** Every session dir under ~/.grok/sessions/, across all project groups. */\n  discoverHistoricalSessionDirs(): GrokSessionDir[] {\n    const results: GrokSessionDir[] = [];\n    for (const { groupDir, defaultCwd } of this.listGroups()) {\n      for (const sessionDir of this.listSessionDirs(groupDir)) {\n        results.push({ sessionDir, defaultCwd });\n      }\n    }\n    return results;\n  }\n\n  /** Session dirs named exactly `sessionId`, across all project groups. */\n  findHistoricalSessionDirsById(sessionId: string): GrokSessionDir[] {\n    if (!isSafePathSegment(sessionId)) return [];\n\n    const results: GrokSessionDir[] = [];\n    for (const { groupDir, defaultCwd } of this.listGroups()) {\n      const sessionDir = path.join(groupDir, sessionId);\n      if (isDirectory(sessionDir)) {\n        results.push({ sessionDir, defaultCwd });\n      }\n    }\n    return results;\n  }\n\n  /**\n   * Read ~/.grok/active_sessions.json into a pid -> cwd map. Grok writes one\n   * { pid, cwd, opened_at } entry per running session and removes it on exit,\n   * so this is the reliable way to learn a live process's working directory.\n   */\n  private readActiveSessions(): Map<number, string> {\n    const map = new Map<number, string>();\n    const content = safeReadFile(path.join(this.baseDir, ACTIVE_SESSIONS_FILE));\n    if (content === undefined) return map;\n\n    let entries: unknown;\n    try {\n      entries = JSON.parse(content);\n    } catch {\n      return map;\n    }\n    if (!Array.isArray(entries)) return map;\n\n    for (const entry of entries as ActiveSessionEntry[]) {\n      if (typeof entry?.pid === \"number\" && typeof entry?.cwd === \"string\" && entry.cwd) {\n        map.set(entry.pid, entry.cwd);\n      }\n    }\n    return map;\n  }\n\n  /**\n   * Return the most recently active session subdirectory for a cwd, i.e. the\n   * ~/.grok/sessions/<encodeURIComponent(cwd)>/<id>/ whose chat_history.jsonl\n   * was written last. Returns null when the group dir or any transcript is\n   * missing.\n   */\n  private latestSessionDir(cwd: string): string | null {\n    const groupDir = path.join(this.sessionsDir, encodeURIComponent(cwd));\n    if (!isDirectory(groupDir)) return null;\n\n    let best: { dir: string; mtimeMs: number } | null = null;\n    for (const sessionDir of this.listSessionDirs(groupDir)) {\n      const stat = safeStat(path.join(sessionDir, CHAT_HISTORY_FILE));\n      if (!stat) continue;\n      if (!best || stat.mtimeMs > best.mtimeMs) {\n        best = { dir: sessionDir, mtimeMs: stat.mtimeMs };\n      }\n    }\n    return best?.dir ?? null;\n  }\n\n  private listGroups(): Array<{ groupDir: string; defaultCwd: string }> {\n    if (!isDirectory(this.sessionsDir)) return [];\n\n    const groups: Array<{ groupDir: string; defaultCwd: string }> = [];\n    for (const groupName of safeReaddir(this.sessionsDir)) {\n      const groupDir = path.join(this.sessionsDir, groupName);\n      if (!isDirectory(groupDir)) continue;\n      groups.push({ groupDir, defaultCwd: this.decodeGroupCwd(groupName, groupDir) });\n    }\n    return groups;\n  }\n\n  /**\n   * Full paths of the session subdirectories directly under a group dir,\n   * skipping any non-directory entries (e.g. prompt_history.jsonl).\n   */\n  private listSessionDirs(groupDir: string): string[] {\n    return safeReaddir(groupDir)\n      .map((sessionId) => path.join(groupDir, sessionId))\n      .filter((sessionDir) => isDirectory(sessionDir));\n  }\n\n  /**\n   * Resolve the working directory a session group dir was created for.\n   *\n   * The common case is `decodeURIComponent(<group-name>)`. For paths whose\n   * encoded form exceeds the filesystem limit Grok uses a slug+hash and records\n   * the original path in a `.cwd` file inside the group — prefer that when\n   * present.\n   */\n  private decodeGroupCwd(groupName: string, groupDir: string): string {\n    const fromFile = safeReadFile(path.join(groupDir, CWD_FILE));\n    if (fromFile !== undefined && fromFile.trim()) return fromFile.trim();\n    try {\n      return decodeURIComponent(groupName);\n    } catch {\n      return \"\";\n    }\n  }\n}\n"],"names":["path","isDirectory","isSafePathSegment","safeReadFile","safeReaddir","safeStat","homeDir","CHAT_HISTORY_FILE","ACTIVE_SESSIONS_FILE","CWD_FILE","GrokSessionLocator","baseDir","sessionsDir","options","process","env","GROK_HOME","join","matchRunningProcesses","processes","pidToCwd","readActiveSessions","map","proc","cwd","get","pid","sessionDir","latestSessionDir","discoverHistoricalSessionDirs","results","groupDir","defaultCwd","listGroups","listSessionDirs","push","findHistoricalSessionDirsById","sessionId","Map","content","undefined","entries","JSON","parse","Array","isArray","entry","set","encodeURIComponent","best","stat","mtimeMs","dir","groups","groupName","decodeGroupCwd","filter","fromFile","trim","decodeURIComponent"],"mappings":"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"}