@ai-devkit/agent-manager 0.36.0 → 0.38.0

package/dist/harnesses/grok/GrokSessionLocator.js

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

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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"}

package/dist/harnesses/grok/GrokSessionParser.d.ts

@@ -0,0 +1,87 @@
+import type { ConversationMessage, ConversationOptions } from "../../adapters/AgentAdapter.js";
+import { AgentStatus } from "../../adapters/AgentAdapter.js";
+import { type JsonlSummaryBounds } from "../../utils/IncrementalJsonlSummary.js";
+export declare const CHAT_HISTORY_FILE = "chat_history.jsonl";
+/** Parsed state for a single ~/.grok/sessions/<cwd>/<id>/ directory. */
+export interface GrokSession {
+    sessionId: string;
+    projectPath: string;
+    sessionFilePath: string;
+    sessionStart: Date;
+    lastActive: Date;
+    firstUserMessage?: string;
+    lastUserMessage?: string;
+    lastRole?: ConversationMessage["role"];
+}
+export interface GrokSessionParserOptions {
+    /** Cold-start scan bounds for `readSessionIncremental` (see IncrementalJsonlSummary). */
+    summaryBounds?: JsonlSummaryBounds | false;
+}
+export declare class GrokSessionParser {
+    /** Incremental reader backing `getConversation({ tail })`. */
+    private readonly tailReader;
+    private readonly sessionCache;
+    constructor(options?: GrokSessionParserOptions);
+    /**
+     * Parse a session directory into a {@link GrokSession} from its
+     * chat_history.jsonl transcript. Returns null when the transcript is
+     * missing — i.e. there is no real session to surface.
+     */
+    readSession(sessionDir: string, defaultCwd: string): GrokSession | null;
+    /**
+     * Same result as `readSession`, but backed by a per-instance incremental
+     * cache so repeated refreshes only parse bytes appended since the last call.
+     * Call `pruneSessionCache()` once per refresh to evict files no longer read.
+     *
+     * The first read of a large transcript is a bounded head + tail scan (see
+     * `summaryReducer.skip`); fields whose entries lie only in the skipped
+     * middle fall back to their defaults instead of forcing a full parse.
+     */
+    readSessionIncremental(sessionDir: string, defaultCwd: string): GrokSession | null;
+    /** Evict cached summaries for files not read since the previous prune. */
+    pruneSessionCache(): void;
+    /** Accepts a session dir or an explicit chat_history.jsonl path. */
+    getConversation(sessionPath: string, options?: ConversationOptions): ConversationMessage[];
+    /**
+     * Determine agent status from parsed session state.
+     *
+     * - past the idle threshold → IDLE
+     * - last transcript turn is an assistant message → WAITING (awaiting user)
+     * - otherwise (last turn was a user message, or unknown) → RUNNING
+     */
+    determineStatus(session: GrokSession): AgentStatus;
+    /**
+     * Fold one chat_history.jsonl entry into the O(1) summary. Uses the same
+     * record rules as `getConversation` (see `toMessage`), minus system records.
+     *
+     * `skip` (bounded cold start) keeps the head's first user message and
+     * clears the last user message and last role, so those come from the tail
+     * only. A first user message beyond the head stays undefined rather than
+     * being filled from the tail; latest fields before the tail window stay
+     * undefined.
+     */
+    private readonly summaryReducer;
+    private toSession;
+    /** Full pass over chat_history.jsonl building every conversation turn. */
+    private parseChatHistory;
+    /**
+     * Map one parsed chat record to a conversation turn, or null to skip it.
+     * Each record is a { type: 'system' | 'user' | 'assistant', content } object
+     * where content is either a string or an array of { type: 'text', text } blocks.
+     *
+     * Grok wraps the real user prompt in <user_query>...</user_query>; the other
+     * user records are context injections (<user_info>, <system-reminder>, ...)
+     * and are skipped so the summary is the actual prompt, not boilerplate.
+     */
+    private toMessage;
+    /** Convert one chat_history.jsonl line into a message, or null when it is not one. */
+    private lineToMessage;
+    /**
+     * Extract the prompt inside <user_query>...</user_query>. Returns null when
+     * the record has no such tag (a context injection rather than a prompt).
+     */
+    private extractUserQuery;
+    /** Resolve a session dir or an explicit chat_history.jsonl path to the file. */
+    private resolveChatPath;
+}
+//# sourceMappingURL=GrokSessionParser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GrokSessionParser.d.ts","sourceRoot":"","sources":["../../../src/harnesses/grok/GrokSessionParser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC/F,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAGL,KAAK,kBAAkB,EAExB,MAAM,wCAAwC,CAAC;AAKhD,eAAO,MAAM,iBAAiB,uBAAuB,CAAC;AAoBtD,wEAAwE;AACxE,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,IAAI,CAAC;IACnB,UAAU,EAAE,IAAI,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,wBAAwB;IACvC,yFAAyF;IACzF,aAAa,CAAC,EAAE,kBAAkB,GAAG,KAAK,CAAC;CAC5C;AAED,qBAAa,iBAAiB;IAC5B,8DAA8D;IAC9D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IAEpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4C;gBAE7D,OAAO,GAAE,wBAA6B;IAMlD;;;;OAIG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAUvE;;;;;;;;OAQG;IACH,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAWlF,0EAA0E;IAC1E,iBAAiB,IAAI,IAAI;IAIzB,oEAAoE;IACpE,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,EAAE;IAe1F;;;;;;OAMG;IACH,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW;IAUlD;;;;;;;;;OASG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAiB7B;IAEF,OAAO,CAAC,SAAS;IAoBjB,0EAA0E;IAC1E,OAAO,CAAC,gBAAgB;IAYxB;;;;;;;;OAQG;IACH,OAAO,CAAC,SAAS;IAkBjB,sFAAsF;IACtF,OAAO,CAAC,aAAa;IAYrB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAKxB,gFAAgF;IAChF,OAAO,CAAC,eAAe;CAGxB"}

package/dist/harnesses/grok/GrokSessionParser.js

@@ -0,0 +1,185 @@
+import * as path from "path";
+import { AgentStatus } from "../../adapters/AgentAdapter.js";
+import { IncrementalJsonlSummary, reduceJsonlContent } from "../../utils/IncrementalJsonlSummary.js";
+import { JsonlTailReader, normalizeTail } from "../../utils/jsonlTail.js";
+import { safeReadFile, safeStat } from "../../utils/session.js";
+import { flattenTextBlocks, isIdle } from "../shared.js";
+export const CHAT_HISTORY_FILE = "chat_history.jsonl";
+export class GrokSessionParser {
+    /** Incremental reader backing `getConversation({ tail })`. */ tailReader = new JsonlTailReader();
+    sessionCache;
+    constructor(options = {}){
+        this.sessionCache = new IncrementalJsonlSummary(this.summaryReducer, {
+            bounds: options.summaryBounds
+        });
+    }
+    /**
+   * Parse a session directory into a {@link GrokSession} from its
+   * chat_history.jsonl transcript. Returns null when the transcript is
+   * missing — i.e. there is no real session to surface.
+   */ readSession(sessionDir, defaultCwd) {
+        const chatPath = path.join(sessionDir, CHAT_HISTORY_FILE);
+        const chatStat = safeStat(chatPath);
+        if (!chatStat) return null;
+        const content = safeReadFile(chatPath);
+        const state = content === undefined ? {} : reduceJsonlContent(this.summaryReducer, content);
+        return this.toSession(sessionDir, defaultCwd, chatPath, chatStat.mtime, state);
+    }
+    /**
+   * Same result as `readSession`, but backed by a per-instance incremental
+   * cache so repeated refreshes only parse bytes appended since the last call.
+   * Call `pruneSessionCache()` once per refresh to evict files no longer read.
+   *
+   * The first read of a large transcript is a bounded head + tail scan (see
+   * `summaryReducer.skip`); fields whose entries lie only in the skipped
+   * middle fall back to their defaults instead of forcing a full parse.
+   */ readSessionIncremental(sessionDir, defaultCwd) {
+        const chatPath = path.join(sessionDir, CHAT_HISTORY_FILE);
+        const result = this.sessionCache.read(chatPath);
+        if (result) {
+            return this.toSession(sessionDir, defaultCwd, chatPath, result.mtime, result.state);
+        }
+        // Present but unreadable: surface the session without a summary, like readSession.
+        const chatStat = safeStat(chatPath);
+        return chatStat ? this.toSession(sessionDir, defaultCwd, chatPath, chatStat.mtime, {}) : null;
+    }
+    /** Evict cached summaries for files not read since the previous prune. */ pruneSessionCache() {
+        this.sessionCache.prune();
+    }
+    /** Accepts a session dir or an explicit chat_history.jsonl path. */ getConversation(sessionPath, options) {
+        const chatPath = this.resolveChatPath(sessionPath);
+        const verbose = options?.verbose ?? false;
+        const tail = normalizeTail(options?.tail);
+        if (tail !== undefined) {
+            return this.tailReader.read(chatPath, tail, {
+                parseLine: (line)=>this.lineToMessage(line, verbose)
+            }, String(verbose));
+        }
+        return this.parseChatHistory(chatPath, verbose);
+    }
+    /**
+   * Determine agent status from parsed session state.
+   *
+   * - past the idle threshold → IDLE
+   * - last transcript turn is an assistant message → WAITING (awaiting user)
+   * - otherwise (last turn was a user message, or unknown) → RUNNING
+   */ determineStatus(session) {
+        if (isIdle(session.lastActive)) {
+            return AgentStatus.IDLE;
+        }
+        if (session.lastRole === "assistant") {
+            return AgentStatus.WAITING;
+        }
+        return AgentStatus.RUNNING;
+    }
+    /**
+   * Fold one chat_history.jsonl entry into the O(1) summary. Uses the same
+   * record rules as `getConversation` (see `toMessage`), minus system records.
+   *
+   * `skip` (bounded cold start) keeps the head's first user message and
+   * clears the last user message and last role, so those come from the tail
+   * only. A first user message beyond the head stays undefined rather than
+   * being filled from the tail; latest fields before the tail window stay
+   * undefined.
+   */ summaryReducer = {
+        initial: ()=>({}),
+        reduce: (state, value)=>{
+            const message = this.toMessage(value, false);
+            if (!message) return state;
+            if (message.role === "user") {
+                return {
+                    ...state,
+                    firstUserMessage: state.firstUserMessage ?? (state.pastHead ? undefined : message.content),
+                    lastUserMessage: message.content,
+                    lastRole: "user"
+                };
+            }
+            return {
+                ...state,
+                lastRole: message.role
+            };
+        },
+        skip: (state)=>({
+                pastHead: true,
+                firstUserMessage: state.firstUserMessage
+            })
+    };
+    toSession(sessionDir, defaultCwd, chatPath, lastActive, state) {
+        const dirStat = safeStat(sessionDir);
+        return {
+            sessionId: path.basename(sessionDir),
+            projectPath: defaultCwd,
+            sessionFilePath: chatPath,
+            sessionStart: dirStat?.birthtime || lastActive,
+            lastActive,
+            firstUserMessage: state.firstUserMessage,
+            lastUserMessage: state.lastUserMessage,
+            lastRole: state.lastRole
+        };
+    }
+    /** Full pass over chat_history.jsonl building every conversation turn. */ parseChatHistory(chatPath, verbose) {
+        const content = safeReadFile(chatPath);
+        if (content === undefined) return [];
+        const messages = [];
+        for (const line of content.trim().split("\n")){
+            const message = this.lineToMessage(line, verbose);
+            if (message) messages.push(message);
+        }
+        return messages;
+    }
+    /**
+   * Map one parsed chat record to a conversation turn, or null to skip it.
+   * Each record is a { type: 'system' | 'user' | 'assistant', content } object
+   * where content is either a string or an array of { type: 'text', text } blocks.
+   *
+   * Grok wraps the real user prompt in <user_query>...</user_query>; the other
+   * user records are context injections (<user_info>, <system-reminder>, ...)
+   * and are skipped so the summary is the actual prompt, not boilerplate.
+   */ toMessage(value, verbose) {
+        if (!value || typeof value !== "object") return null;
+        const record = value;
+        const text = flattenTextBlocks(record.content);
+        if (record.type === "user") {
+            const query = this.extractUserQuery(text);
+            return query === null ? null : {
+                role: "user",
+                content: query
+            };
+        }
+        if (record.type === "assistant") {
+            return text ? {
+                role: "assistant",
+                content: text
+            } : null;
+        }
+        if (verbose && record.type === "system") {
+            return text ? {
+                role: "system",
+                content: text
+            } : null;
+        }
+        return null;
+    }
+    /** Convert one chat_history.jsonl line into a message, or null when it is not one. */ lineToMessage(line, verbose) {
+        if (!line.trim()) return null;
+        let record;
+        try {
+            record = JSON.parse(line);
+        } catch  {
+            return null;
+        }
+        return this.toMessage(record, verbose);
+    }
+    /**
+   * Extract the prompt inside <user_query>...</user_query>. Returns null when
+   * the record has no such tag (a context injection rather than a prompt).
+   */ extractUserQuery(text) {
+        const match = text.match(/<user_query>\s*([\s\S]*?)\s*<\/user_query>/);
+        return match ? match[1].trim() : null;
+    }
+    /** Resolve a session dir or an explicit chat_history.jsonl path to the file. */ resolveChatPath(sessionPath) {
+        return sessionPath.endsWith(".jsonl") ? sessionPath : path.join(sessionPath, CHAT_HISTORY_FILE);
+    }
+}
+
+//# sourceMappingURL=GrokSessionParser.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/harnesses/grok/GrokSessionParser.ts"],"sourcesContent":["import * as path from \"path\";\nimport type { ConversationMessage, ConversationOptions } from \"../../adapters/AgentAdapter.js\";\nimport { AgentStatus } from \"../../adapters/AgentAdapter.js\";\nimport {\n  IncrementalJsonlSummary,\n  reduceJsonlContent,\n  type JsonlSummaryBounds,\n  type JsonlSummaryReducer,\n} from \"../../utils/IncrementalJsonlSummary.js\";\nimport { JsonlTailReader, normalizeTail } from \"../../utils/jsonlTail.js\";\nimport { safeReadFile, safeStat } from \"../../utils/session.js\";\nimport { flattenTextBlocks, isIdle } from \"../shared.js\";\n\nexport const CHAT_HISTORY_FILE = \"chat_history.jsonl\";\n\n/** One line of chat_history.jsonl. */\ninterface ChatRecord {\n  type?: string;\n  content?: unknown;\n}\n\n/**\n * O(1) running summary folded from chat records: only the first/last real\n * prompt and the role of the last user/assistant turn, never the turns.\n */\ninterface GrokSummaryState {\n  /** A bounded cold start skipped the middle: later lines are not the session's first. */\n  pastHead?: boolean;\n  firstUserMessage?: string;\n  lastUserMessage?: string;\n  lastRole?: ConversationMessage[\"role\"];\n}\n\n/** Parsed state for a single ~/.grok/sessions/<cwd>/<id>/ directory. */\nexport interface GrokSession {\n  sessionId: string;\n  projectPath: string;\n  sessionFilePath: string;\n  sessionStart: Date;\n  lastActive: Date;\n  firstUserMessage?: string;\n  lastUserMessage?: string;\n  lastRole?: ConversationMessage[\"role\"];\n}\n\nexport interface GrokSessionParserOptions {\n  /** Cold-start scan bounds for `readSessionIncremental` (see IncrementalJsonlSummary). */\n  summaryBounds?: JsonlSummaryBounds | false;\n}\n\nexport class GrokSessionParser {\n  /** Incremental reader backing `getConversation({ tail })`. */\n  private readonly tailReader = new JsonlTailReader();\n\n  private readonly sessionCache: IncrementalJsonlSummary<GrokSummaryState>;\n\n  constructor(options: GrokSessionParserOptions = {}) {\n    this.sessionCache = new IncrementalJsonlSummary(this.summaryReducer, {\n      bounds: options.summaryBounds,\n    });\n  }\n\n  /**\n   * Parse a session directory into a {@link GrokSession} from its\n   * chat_history.jsonl transcript. Returns null when the transcript is\n   * missing — i.e. there is no real session to surface.\n   */\n  readSession(sessionDir: string, defaultCwd: string): GrokSession | null {\n    const chatPath = path.join(sessionDir, CHAT_HISTORY_FILE);\n    const chatStat = safeStat(chatPath);\n    if (!chatStat) return null;\n\n    const content = safeReadFile(chatPath);\n    const state = content === undefined ? {} : reduceJsonlContent(this.summaryReducer, content);\n    return this.toSession(sessionDir, defaultCwd, chatPath, chatStat.mtime, state);\n  }\n\n  /**\n   * Same result as `readSession`, but backed by a per-instance incremental\n   * cache so repeated refreshes only parse bytes appended since the last call.\n   * Call `pruneSessionCache()` once per refresh to evict files no longer read.\n   *\n   * The first read of a large transcript is a bounded head + tail scan (see\n   * `summaryReducer.skip`); fields whose entries lie only in the skipped\n   * middle fall back to their defaults instead of forcing a full parse.\n   */\n  readSessionIncremental(sessionDir: string, defaultCwd: string): GrokSession | null {\n    const chatPath = path.join(sessionDir, CHAT_HISTORY_FILE);\n    const result = this.sessionCache.read(chatPath);\n    if (result) {\n      return this.toSession(sessionDir, defaultCwd, chatPath, result.mtime, result.state);\n    }\n    // Present but unreadable: surface the session without a summary, like readSession.\n    const chatStat = safeStat(chatPath);\n    return chatStat ? this.toSession(sessionDir, defaultCwd, chatPath, chatStat.mtime, {}) : null;\n  }\n\n  /** Evict cached summaries for files not read since the previous prune. */\n  pruneSessionCache(): void {\n    this.sessionCache.prune();\n  }\n\n  /** Accepts a session dir or an explicit chat_history.jsonl path. */\n  getConversation(sessionPath: string, options?: ConversationOptions): ConversationMessage[] {\n    const chatPath = this.resolveChatPath(sessionPath);\n    const verbose = options?.verbose ?? false;\n    const tail = normalizeTail(options?.tail);\n    if (tail !== undefined) {\n      return this.tailReader.read(\n        chatPath,\n        tail,\n        { parseLine: (line) => this.lineToMessage(line, verbose) },\n        String(verbose),\n      );\n    }\n    return this.parseChatHistory(chatPath, verbose);\n  }\n\n  /**\n   * Determine agent status from parsed session state.\n   *\n   * - past the idle threshold → IDLE\n   * - last transcript turn is an assistant message → WAITING (awaiting user)\n   * - otherwise (last turn was a user message, or unknown) → RUNNING\n   */\n  determineStatus(session: GrokSession): AgentStatus {\n    if (isIdle(session.lastActive)) {\n      return AgentStatus.IDLE;\n    }\n    if (session.lastRole === \"assistant\") {\n      return AgentStatus.WAITING;\n    }\n    return AgentStatus.RUNNING;\n  }\n\n  /**\n   * Fold one chat_history.jsonl entry into the O(1) summary. Uses the same\n   * record rules as `getConversation` (see `toMessage`), minus system records.\n   *\n   * `skip` (bounded cold start) keeps the head's first user message and\n   * clears the last user message and last role, so those come from the tail\n   * only. A first user message beyond the head stays undefined rather than\n   * being filled from the tail; latest fields before the tail window stay\n   * undefined.\n   */\n  private readonly summaryReducer: JsonlSummaryReducer<GrokSummaryState> = {\n    initial: () => ({}),\n    reduce: (state, value) => {\n      const message = this.toMessage(value, false);\n      if (!message) return state;\n      if (message.role === \"user\") {\n        return {\n          ...state,\n          firstUserMessage:\n            state.firstUserMessage ?? (state.pastHead ? undefined : message.content),\n          lastUserMessage: message.content,\n          lastRole: \"user\",\n        };\n      }\n      return { ...state, lastRole: message.role };\n    },\n    skip: (state) => ({ pastHead: true, firstUserMessage: state.firstUserMessage }),\n  };\n\n  private toSession(\n    sessionDir: string,\n    defaultCwd: string,\n    chatPath: string,\n    lastActive: Date,\n    state: GrokSummaryState,\n  ): GrokSession {\n    const dirStat = safeStat(sessionDir);\n    return {\n      sessionId: path.basename(sessionDir),\n      projectPath: defaultCwd,\n      sessionFilePath: chatPath,\n      sessionStart: dirStat?.birthtime || lastActive,\n      lastActive,\n      firstUserMessage: state.firstUserMessage,\n      lastUserMessage: state.lastUserMessage,\n      lastRole: state.lastRole,\n    };\n  }\n\n  /** Full pass over chat_history.jsonl building every conversation turn. */\n  private parseChatHistory(chatPath: string, verbose: boolean): ConversationMessage[] {\n    const content = safeReadFile(chatPath);\n    if (content === undefined) return [];\n\n    const messages: ConversationMessage[] = [];\n    for (const line of content.trim().split(\"\\n\")) {\n      const message = this.lineToMessage(line, verbose);\n      if (message) messages.push(message);\n    }\n    return messages;\n  }\n\n  /**\n   * Map one parsed chat record to a conversation turn, or null to skip it.\n   * Each record is a { type: 'system' | 'user' | 'assistant', content } object\n   * where content is either a string or an array of { type: 'text', text } blocks.\n   *\n   * Grok wraps the real user prompt in <user_query>...</user_query>; the other\n   * user records are context injections (<user_info>, <system-reminder>, ...)\n   * and are skipped so the summary is the actual prompt, not boilerplate.\n   */\n  private toMessage(value: unknown, verbose: boolean): ConversationMessage | null {\n    if (!value || typeof value !== \"object\") return null;\n    const record = value as ChatRecord;\n\n    const text = flattenTextBlocks(record.content);\n    if (record.type === \"user\") {\n      const query = this.extractUserQuery(text);\n      return query === null ? null : { role: \"user\", content: query };\n    }\n    if (record.type === \"assistant\") {\n      return text ? { role: \"assistant\", content: text } : null;\n    }\n    if (verbose && record.type === \"system\") {\n      return text ? { role: \"system\", content: text } : null;\n    }\n    return null;\n  }\n\n  /** Convert one chat_history.jsonl line into a message, or null when it is not one. */\n  private lineToMessage(line: string, verbose: boolean): ConversationMessage | null {\n    if (!line.trim()) return null;\n\n    let record: unknown;\n    try {\n      record = JSON.parse(line);\n    } catch {\n      return null;\n    }\n    return this.toMessage(record, verbose);\n  }\n\n  /**\n   * Extract the prompt inside <user_query>...</user_query>. Returns null when\n   * the record has no such tag (a context injection rather than a prompt).\n   */\n  private extractUserQuery(text: string): string | null {\n    const match = text.match(/<user_query>\\s*([\\s\\S]*?)\\s*<\\/user_query>/);\n    return match ? match[1].trim() : null;\n  }\n\n  /** Resolve a session dir or an explicit chat_history.jsonl path to the file. */\n  private resolveChatPath(sessionPath: string): string {\n    return sessionPath.endsWith(\".jsonl\") ? sessionPath : path.join(sessionPath, CHAT_HISTORY_FILE);\n  }\n}\n"],"names":["path","AgentStatus","IncrementalJsonlSummary","reduceJsonlContent","JsonlTailReader","normalizeTail","safeReadFile","safeStat","flattenTextBlocks","isIdle","CHAT_HISTORY_FILE","GrokSessionParser","tailReader","sessionCache","options","summaryReducer","bounds","summaryBounds","readSession","sessionDir","defaultCwd","chatPath","join","chatStat","content","state","undefined","toSession","mtime","readSessionIncremental","result","read","pruneSessionCache","prune","getConversation","sessionPath","resolveChatPath","verbose","tail","parseLine","line","lineToMessage","String","parseChatHistory","determineStatus","session","lastActive","IDLE","lastRole","WAITING","RUNNING","initial","reduce","value","message","toMessage","role","firstUserMessage","pastHead","lastUserMessage","skip","dirStat","sessionId","basename","projectPath","sessionFilePath","sessionStart","birthtime","messages","trim","split","push","record","text","type","query","extractUserQuery","JSON","parse","match","endsWith"],"mappings":"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"}

package/dist/harnesses/index.d.ts

@@ -0,0 +1,7 @@
+import type { AgentAdapter } from "../adapters/AgentAdapter.js";
+/**
+ * One instance of every built-in harness adapter, in registration order
+ * (which is also the order agents are listed in). Register a new harness here.
+ */
+export declare function createBuiltinAdapters(): AgentAdapter[];
+//# sourceMappingURL=index.d.ts.map

package/dist/harnesses/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/harnesses/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAWhE;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,YAAY,EAAE,CAYtD"}

package/dist/harnesses/index.js

@@ -0,0 +1,27 @@
+import { AntigravityCliAdapter } from "./antigravity/AntigravityCliAdapter.js";
+import { ClaudeCodeAdapter } from "./claude/ClaudeCodeAdapter.js";
+import { CodexAdapter } from "./codex/CodexAdapter.js";
+import { CopilotAdapter } from "./copilot/CopilotAdapter.js";
+import { GeminiCliAdapter } from "./gemini/GeminiCliAdapter.js";
+import { GrokCliAdapter } from "./grok/GrokCliAdapter.js";
+import { KiroAdapter } from "./kiro/KiroAdapter.js";
+import { OpenCodeAdapter } from "./opencode/OpenCodeAdapter.js";
+import { PiAdapter } from "./pi/PiAdapter.js";
+/**
+ * One instance of every built-in harness adapter, in registration order
+ * (which is also the order agents are listed in). Register a new harness here.
+ */ export function createBuiltinAdapters() {
+    return [
+        new ClaudeCodeAdapter(),
+        new CodexAdapter(),
+        new CopilotAdapter(),
+        new GeminiCliAdapter(),
+        new GrokCliAdapter(),
+        new KiroAdapter(),
+        new AntigravityCliAdapter(),
+        new OpenCodeAdapter(),
+        new PiAdapter()
+    ];
+}
+
+//# sourceMappingURL=index.js.map

package/dist/harnesses/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/harnesses/index.ts"],"sourcesContent":["import type { AgentAdapter } from \"../adapters/AgentAdapter.js\";\nimport { AntigravityCliAdapter } from \"./antigravity/AntigravityCliAdapter.js\";\nimport { ClaudeCodeAdapter } from \"./claude/ClaudeCodeAdapter.js\";\nimport { CodexAdapter } from \"./codex/CodexAdapter.js\";\nimport { CopilotAdapter } from \"./copilot/CopilotAdapter.js\";\nimport { GeminiCliAdapter } from \"./gemini/GeminiCliAdapter.js\";\nimport { GrokCliAdapter } from \"./grok/GrokCliAdapter.js\";\nimport { KiroAdapter } from \"./kiro/KiroAdapter.js\";\nimport { OpenCodeAdapter } from \"./opencode/OpenCodeAdapter.js\";\nimport { PiAdapter } from \"./pi/PiAdapter.js\";\n\n/**\n * One instance of every built-in harness adapter, in registration order\n * (which is also the order agents are listed in). Register a new harness here.\n */\nexport function createBuiltinAdapters(): AgentAdapter[] {\n  return [\n    new ClaudeCodeAdapter(),\n    new CodexAdapter(),\n    new CopilotAdapter(),\n    new GeminiCliAdapter(),\n    new GrokCliAdapter(),\n    new KiroAdapter(),\n    new AntigravityCliAdapter(),\n    new OpenCodeAdapter(),\n    new PiAdapter(),\n  ];\n}\n"],"names":["AntigravityCliAdapter","ClaudeCodeAdapter","CodexAdapter","CopilotAdapter","GeminiCliAdapter","GrokCliAdapter","KiroAdapter","OpenCodeAdapter","PiAdapter","createBuiltinAdapters"],"mappings":"AACA,SAASA,qBAAqB,QAAQ,yCAAyC;AAC/E,SAASC,iBAAiB,QAAQ,gCAAgC;AAClE,SAASC,YAAY,QAAQ,0BAA0B;AACvD,SAASC,cAAc,QAAQ,8BAA8B;AAC7D,SAASC,gBAAgB,QAAQ,+BAA+B;AAChE,SAASC,cAAc,QAAQ,2BAA2B;AAC1D,SAASC,WAAW,QAAQ,wBAAwB;AACpD,SAASC,eAAe,QAAQ,gCAAgC;AAChE,SAASC,SAAS,QAAQ,oBAAoB;AAE9C;;;CAGC,GACD,OAAO,SAASC;IACd,OAAO;QACL,IAAIR;QACJ,IAAIC;QACJ,IAAIC;QACJ,IAAIC;QACJ,IAAIC;QACJ,IAAIC;QACJ,IAAIN;QACJ,IAAIO;QACJ,IAAIC;KACL;AACH"}

package/dist/harnesses/kiro/KiroAdapter.d.ts

@@ -0,0 +1,31 @@
+import type { AgentAdapter, AgentInfo, ProcessInfo, ConversationMessage, ConversationOptions, SessionSummary, ListSessionsOptions, AgentDetectionContext } from "../../adapters/AgentAdapter.js";
+/**
+ * Kiro Adapter
+ *
+ * Detects running Kiro agents by matching the PID in each
+ * ~/.kiro/sessions/cli/<session-id>.lock to a running Kiro process (walking up
+ * from helper processes such as `kiro-cli-chat acp`), then reading the sibling
+ * <session-id>.json metadata and <session-id>.jsonl transcript.
+ */
+export declare class KiroAdapter implements AgentAdapter {
+    readonly type: "kiro";
+    /**
+     * Also collects the helpers between a lock holder and its kiro-cli, such as
+     * the bundled `bun … tui.js`; `canHandle` still decides which are agents.
+     */
+    readonly processNames: readonly ["kiro-cli", "kiro", "kiro-cli-chat", "node", "bun"];
+    private parser;
+    private mapper;
+    private locator;
+    constructor();
+    canHandle(processInfo: ProcessInfo): boolean;
+    detectAgents(context?: AgentDetectionContext): Promise<AgentInfo[]>;
+    private detectRunningAgents;
+    getConversation(sessionFilePath: string, options?: ConversationOptions): ConversationMessage[];
+    listSessions(opts?: ListSessionsOptions): Promise<SessionSummary[]>;
+    findSessionsById(sessionId: string): Promise<SessionSummary[]>;
+    private toSessionSummary;
+    /** `kiro-cli` / `kiro`, directly or as a script run by node or bun. */
+    private isKiroExecutable;
+}
+//# sourceMappingURL=KiroAdapter.d.ts.map

package/dist/harnesses/kiro/KiroAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KiroAdapter.d.ts","sourceRoot":"","sources":["../../../src/harnesses/kiro/KiroAdapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,gCAAgC,CAAC;AAUxC;;;;;;;GAOG;AACH,qBAAa,WAAY,YAAW,YAAY;IAC9C,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;IAChC;;;OAGG;IACH,QAAQ,CAAC,YAAY,gEAAiE;IAEtF,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;IAwBjC,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;IAYnE,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAOpE,OAAO,CAAC,gBAAgB;IAYxB,uEAAuE;IACvE,OAAO,CAAC,gBAAgB;CAgBzB"}