@ai-devkit/agent-manager 0.36.0 → 0.37.0

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

package/dist/harnesses/kiro/KiroAdapter.js

@@ -0,0 +1,125 @@
+import * as path from "path";
+import { executablePath } from "../../utils/process.js";
+import { findHarnessProcesses } from "../shared.js";
+import { KiroAgentMapper } from "./KiroAgentMapper.js";
+import { KiroSessionLocator } from "./KiroSessionLocator.js";
+import { KiroSessionParser } from "./KiroSessionParser.js";
+const KIRO_BASENAMES = new Set([
+    "kiro-cli",
+    "kiro"
+]);
+const SCRIPT_RUNTIMES = new Set([
+    "node",
+    "bun"
+]);
+/**
+ * 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 class KiroAdapter {
+    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.
+   */ processNames = [
+        "kiro-cli",
+        "kiro",
+        "kiro-cli-chat",
+        "node",
+        "bun"
+    ];
+    parser;
+    mapper;
+    locator;
+    constructor(){
+        this.parser = new KiroSessionParser();
+        this.mapper = new KiroAgentMapper(this.parser);
+        this.locator = new KiroSessionLocator();
+    }
+    canHandle(processInfo) {
+        return this.isKiroExecutable(processInfo.command);
+    }
+    async detectAgents(context) {
+        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 { relevant, processes } = await findHarnessProcesses(this, context);
+        if (processes.length === 0) return [];
+        const agents = [];
+        const matchedPids = new Set();
+        for (const match of this.locator.matchRunningProcesses(relevant, processes, (process)=>this.canHandle(process))){
+            const session = this.parser.readSessionIncremental(match.session, match.process.cwd);
+            if (!session) continue;
+            agents.push(this.mapper.mapSessionToAgent({
+                session,
+                processInfo: match.process
+            }));
+            matchedPids.add(match.process.pid);
+        }
+        for (const proc of processes){
+            if (!matchedPids.has(proc.pid)) {
+                agents.push(this.mapper.mapProcessOnlyAgent(proc));
+            }
+        }
+        return agents;
+    }
+    getConversation(sessionFilePath, options) {
+        return this.parser.getConversation(sessionFilePath, options);
+    }
+    async listSessions(opts) {
+        const summaries = [];
+        for (const paths of this.locator.listSessions()){
+            const session = this.parser.readSession(paths);
+            if (!session) continue;
+            if (opts?.cwd !== undefined && session.projectPath !== opts.cwd) continue;
+            summaries.push(this.toSessionSummary(session));
+        }
+        return summaries;
+    }
+    async findSessionsById(sessionId) {
+        const paths = this.locator.findSession(sessionId);
+        const session = paths ? this.parser.readSession(paths) : null;
+        // listSessions reports the metadata's id, so only an exact match counts.
+        return session?.sessionId === sessionId ? [
+            this.toSessionSummary(session)
+        ] : [];
+    }
+    toSessionSummary(session) {
+        return {
+            type: this.type,
+            sessionId: session.sessionId,
+            cwd: session.projectPath,
+            firstUserMessage: session.firstUserMessage,
+            lastActive: session.lastActive,
+            startedAt: session.sessionStart,
+            sessionFilePath: session.sessionFilePath
+        };
+    }
+    /** `kiro-cli` / `kiro`, directly or as a script run by node or bun. */ isKiroExecutable(command) {
+        const trimmed = command.trim();
+        const executable = executablePath(trimmed);
+        if (!executable) return false;
+        const executableName = kiroBasename(executable);
+        if (KIRO_BASENAMES.has(executableName)) return true;
+        if (!SCRIPT_RUNTIMES.has(executableName)) return false;
+        const args = trimmed.slice(executable.length).trim().split(/\s+/);
+        const scriptIndex = args.findIndex((token)=>token !== "" && !token.startsWith("-"));
+        if (scriptIndex === -1) return false;
+        // The script path may also contain spaces; resolve it like argv[0].
+        const script = executablePath(args.slice(scriptIndex).join(" "));
+        return KIRO_BASENAMES.has(kiroBasename(script));
+    }
+}
+function kiroBasename(executable) {
+    return path.basename(executable.replace(/\\/g, "/")).toLowerCase().replace(/\.(exe|js)$/, "");
+}
+
+//# sourceMappingURL=KiroAdapter.js.map

package/dist/harnesses/kiro/KiroAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/harnesses/kiro/KiroAdapter.ts"],"sourcesContent":["import * as path from \"path\";\nimport type {\n  AgentAdapter,\n  AgentInfo,\n  ProcessInfo,\n  ConversationMessage,\n  ConversationOptions,\n  SessionSummary,\n  ListSessionsOptions,\n  AgentDetectionContext,\n} from \"../../adapters/AgentAdapter.js\";\nimport { executablePath } from \"../../utils/process.js\";\nimport { findHarnessProcesses } from \"../shared.js\";\nimport { KiroAgentMapper } from \"./KiroAgentMapper.js\";\nimport { KiroSessionLocator } from \"./KiroSessionLocator.js\";\nimport { KiroSessionParser, type KiroSession } from \"./KiroSessionParser.js\";\n\nconst KIRO_BASENAMES = new Set([\"kiro-cli\", \"kiro\"]);\nconst SCRIPT_RUNTIMES = new Set([\"node\", \"bun\"]);\n\n/**\n * Kiro Adapter\n *\n * Detects running Kiro agents by matching the PID in each\n * ~/.kiro/sessions/cli/<session-id>.lock to a running Kiro process (walking up\n * from helper processes such as `kiro-cli-chat acp`), then reading the sibling\n * <session-id>.json metadata and <session-id>.jsonl transcript.\n */\nexport class KiroAdapter implements AgentAdapter {\n  readonly type = \"kiro\" as const;\n  /**\n   * Also collects the helpers between a lock holder and its kiro-cli, such as\n   * the bundled `bun … tui.js`; `canHandle` still decides which are agents.\n   */\n  readonly processNames = [\"kiro-cli\", \"kiro\", \"kiro-cli-chat\", \"node\", \"bun\"] as const;\n\n  private parser: KiroSessionParser;\n  private mapper: KiroAgentMapper;\n  private locator: KiroSessionLocator;\n\n  constructor() {\n    this.parser = new KiroSessionParser();\n    this.mapper = new KiroAgentMapper(this.parser);\n    this.locator = new KiroSessionLocator();\n  }\n\n  canHandle(processInfo: ProcessInfo): boolean {\n    return this.isKiroExecutable(processInfo.command);\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 { relevant, processes } = await findHarnessProcesses(this, context);\n    if (processes.length === 0) return [];\n\n    const agents: AgentInfo[] = [];\n    const matchedPids = new Set<number>();\n    for (const match of this.locator.matchRunningProcesses(relevant, processes, (process) =>\n      this.canHandle(process),\n    )) {\n      const session = this.parser.readSessionIncremental(match.session, match.process.cwd);\n      if (!session) continue;\n\n      agents.push(this.mapper.mapSessionToAgent({ session, processInfo: match.process }));\n      matchedPids.add(match.process.pid);\n    }\n\n    for (const proc of processes) {\n      if (!matchedPids.has(proc.pid)) {\n        agents.push(this.mapper.mapProcessOnlyAgent(proc));\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 summaries: SessionSummary[] = [];\n    for (const paths of this.locator.listSessions()) {\n      const session = this.parser.readSession(paths);\n      if (!session) continue;\n      if (opts?.cwd !== undefined && session.projectPath !== opts.cwd) continue;\n\n      summaries.push(this.toSessionSummary(session));\n    }\n    return summaries;\n  }\n\n  async findSessionsById(sessionId: string): Promise<SessionSummary[]> {\n    const paths = this.locator.findSession(sessionId);\n    const session = paths ? this.parser.readSession(paths) : null;\n    // listSessions reports the metadata's id, so only an exact match counts.\n    return session?.sessionId === sessionId ? [this.toSessionSummary(session)] : [];\n  }\n\n  private toSessionSummary(session: KiroSession): 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  /** `kiro-cli` / `kiro`, directly or as a script run by node or bun. */\n  private isKiroExecutable(command: string): boolean {\n    const trimmed = command.trim();\n    const executable = executablePath(trimmed);\n    if (!executable) return false;\n\n    const executableName = kiroBasename(executable);\n    if (KIRO_BASENAMES.has(executableName)) return true;\n    if (!SCRIPT_RUNTIMES.has(executableName)) return false;\n\n    const args = trimmed.slice(executable.length).trim().split(/\\s+/);\n    const scriptIndex = args.findIndex((token) => token !== \"\" && !token.startsWith(\"-\"));\n    if (scriptIndex === -1) return false;\n    // The script path may also contain spaces; resolve it like argv[0].\n    const script = executablePath(args.slice(scriptIndex).join(\" \"));\n    return KIRO_BASENAMES.has(kiroBasename(script));\n  }\n}\n\nfunction kiroBasename(executable: string): string {\n  return path\n    .basename(executable.replace(/\\\\/g, \"/\"))\n    .toLowerCase()\n    .replace(/\\.(exe|js)$/, \"\");\n}\n"],"names":["path","executablePath","findHarnessProcesses","KiroAgentMapper","KiroSessionLocator","KiroSessionParser","KIRO_BASENAMES","Set","SCRIPT_RUNTIMES","KiroAdapter","type","processNames","parser","mapper","locator","canHandle","processInfo","isKiroExecutable","command","detectAgents","context","detectRunningAgents","pruneSessionCache","relevant","processes","length","agents","matchedPids","match","matchRunningProcesses","process","session","readSessionIncremental","cwd","push","mapSessionToAgent","add","pid","proc","has","mapProcessOnlyAgent","getConversation","sessionFilePath","options","listSessions","opts","summaries","paths","readSession","undefined","projectPath","toSessionSummary","findSessionsById","sessionId","findSession","firstUserMessage","lastActive","startedAt","sessionStart","trimmed","trim","executable","executableName","kiroBasename","args","slice","split","scriptIndex","findIndex","token","startsWith","script","join","basename","replace","toLowerCase"],"mappings":"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"}

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

@@ -0,0 +1,13 @@
+import type { AgentInfo, ProcessInfo } from "../../adapters/AgentAdapter.js";
+import { KiroSessionParser, type KiroSession } from "./KiroSessionParser.js";
+export interface KiroSessionAgentInput {
+    session: KiroSession;
+    processInfo: ProcessInfo;
+}
+export declare class KiroAgentMapper {
+    private readonly parser;
+    constructor(parser?: KiroSessionParser);
+    mapSessionToAgent({ session, processInfo }: KiroSessionAgentInput): AgentInfo;
+    mapProcessOnlyAgent(processInfo: ProcessInfo): AgentInfo;
+}
+//# sourceMappingURL=KiroAgentMapper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"KiroAgentMapper.d.ts","sourceRoot":"","sources":["../../../src/harnesses/kiro/KiroAgentMapper.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;IAiB7E,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,SAAS;CAGzD"}

package/dist/harnesses/kiro/KiroAgentMapper.js

@@ -0,0 +1,29 @@
+import { generateAgentName } from "../../utils/matching.js";
+import { processOnlyAgent, SUMMARY_MAX_LENGTH, truncate } from "../shared.js";
+import { KiroSessionParser } from "./KiroSessionParser.js";
+export class KiroAgentMapper {
+    parser;
+    constructor(parser = new KiroSessionParser()){
+        this.parser = parser;
+    }
+    mapSessionToAgent({ session, processInfo }) {
+        return {
+            name: generateAgentName(session.projectPath, processInfo.pid),
+            type: "kiro",
+            status: this.parser.determineStatus(session),
+            summary: truncate(session.lastUserMessage || session.title || "Kiro session active", SUMMARY_MAX_LENGTH),
+            pid: processInfo.pid,
+            projectPath: session.projectPath,
+            sessionId: session.sessionId,
+            lastActive: session.lastActive,
+            sessionFilePath: session.sessionFilePath
+        };
+    }
+    mapProcessOnlyAgent(processInfo) {
+        return processOnlyAgent("kiro", processInfo, {
+            summary: "Kiro process running"
+        });
+    }
+}
+
+//# sourceMappingURL=KiroAgentMapper.js.map

package/dist/harnesses/kiro/KiroAgentMapper.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/harnesses/kiro/KiroAgentMapper.ts"],"sourcesContent":["import type { AgentInfo, ProcessInfo } from \"../../adapters/AgentAdapter.js\";\nimport { generateAgentName } from \"../../utils/matching.js\";\nimport { processOnlyAgent, SUMMARY_MAX_LENGTH, truncate } from \"../shared.js\";\nimport { KiroSessionParser, type KiroSession } from \"./KiroSessionParser.js\";\n\nexport interface KiroSessionAgentInput {\n  session: KiroSession;\n  processInfo: ProcessInfo;\n}\n\nexport class KiroAgentMapper {\n  constructor(private readonly parser: KiroSessionParser = new KiroSessionParser()) {}\n\n  mapSessionToAgent({ session, processInfo }: KiroSessionAgentInput): AgentInfo {\n    return {\n      name: generateAgentName(session.projectPath, processInfo.pid),\n      type: \"kiro\",\n      status: this.parser.determineStatus(session),\n      summary: truncate(\n        session.lastUserMessage || session.title || \"Kiro session active\",\n        SUMMARY_MAX_LENGTH,\n      ),\n      pid: processInfo.pid,\n      projectPath: session.projectPath,\n      sessionId: session.sessionId,\n      lastActive: session.lastActive,\n      sessionFilePath: session.sessionFilePath,\n    };\n  }\n\n  mapProcessOnlyAgent(processInfo: ProcessInfo): AgentInfo {\n    return processOnlyAgent(\"kiro\", processInfo, { summary: \"Kiro process running\" });\n  }\n}\n"],"names":["generateAgentName","processOnlyAgent","SUMMARY_MAX_LENGTH","truncate","KiroSessionParser","KiroAgentMapper","parser","mapSessionToAgent","session","processInfo","name","projectPath","pid","type","status","determineStatus","summary","lastUserMessage","title","sessionId","lastActive","sessionFilePath","mapProcessOnlyAgent"],"mappings":"AACA,SAASA,iBAAiB,QAAQ,0BAA0B;AAC5D,SAASC,gBAAgB,EAAEC,kBAAkB,EAAEC,QAAQ,QAAQ,eAAe;AAC9E,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,MAAMV,kBAAkBQ,QAAQG,WAAW,EAAEF,YAAYG,GAAG;YAC5DC,MAAM;YACNC,QAAQ,IAAI,CAACR,MAAM,CAACS,eAAe,CAACP;YACpCQ,SAASb,SACPK,QAAQS,eAAe,IAAIT,QAAQU,KAAK,IAAI,uBAC5ChB;YAEFU,KAAKH,YAAYG,GAAG;YACpBD,aAAaH,QAAQG,WAAW;YAChCQ,WAAWX,QAAQW,SAAS;YAC5BC,YAAYZ,QAAQY,UAAU;YAC9BC,iBAAiBb,QAAQa,eAAe;QAC1C;IACF;IAEAC,oBAAoBb,WAAwB,EAAa;QACvD,OAAOR,iBAAiB,QAAQQ,aAAa;YAAEO,SAAS;QAAuB;IACjF;AACF"}

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

@@ -0,0 +1,38 @@
+import type { ProcessInfo } from "../../adapters/AgentAdapter.js";
+import { type KiroSessionPaths } from "./KiroSessionParser.js";
+/** A live Kiro process and the session whose lock it holds. */
+export interface KiroProcessMatch {
+    process: ProcessInfo;
+    session: KiroSessionPaths;
+}
+export interface KiroSessionLocatorOptions {
+    /** Overrides ~/.kiro/sessions/cli. */
+    sessionsDir?: string;
+}
+export declare class KiroSessionLocator {
+    private readonly sessionsDir;
+    constructor(options?: KiroSessionLocatorOptions);
+    /**
+     * Pair `<session-id>.lock` files with running Kiro processes.
+     *
+     * @param snapshot every process collected for Kiro's process names, used to
+     *   walk up from the lock's PID (often a `kiro-cli-chat acp` helper)
+     * @param kiroProcesses the top-level Kiro processes that become agents
+     * @param isKiro whether a process is a top-level Kiro process
+     */
+    matchRunningProcesses(snapshot: readonly ProcessInfo[], kiroProcesses: readonly ProcessInfo[], isKiro: (process: ProcessInfo) => boolean): KiroProcessMatch[];
+    /** Every session with a transcript under the sessions dir. */
+    listSessions(): KiroSessionPaths[];
+    /** The session stored as `<sessionId>.jsonl`, if it exists. */
+    findSession(sessionId: string): KiroSessionPaths | null;
+    private sessionPaths;
+    private discoverActiveLocks;
+    /** The outermost Kiro process on the lock PID's parent chain, if collected. */
+    private findKiroAncestor;
+    /**
+     * Fallback when the chain is broken (an uncollected intermediate process):
+     * attach to the only Kiro process on the lock holder's terminal.
+     */
+    private matchSoleProcessOnTty;
+}
+//# sourceMappingURL=KiroSessionLocator.d.ts.map