@ai-devkit/agent-manager 0.34.0 → 0.35.0

package/dist/adapters/GrokCliAdapter.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/adapters/GrokCliAdapter.ts"],"sourcesContent":["import * as path from \"path\";\nimport type {\n  AgentAdapter,\n  AgentInfo,\n  ProcessInfo,\n  ConversationMessage,\n  SessionSummary,\n  ListSessionsOptions,\n  AgentDetectionContext,\n} from \"./AgentAdapter.js\";\nimport { AgentStatus } from \"./AgentAdapter.js\";\nimport {\n  captureProcessSnapshot,\n  executableBasename,\n  filterByProcessNames,\n} from \"../utils/process.js\";\nimport { isDirectory, safeReadFile, safeReaddir, safeStat } from \"../utils/session.js\";\nimport { generateAgentName } from \"../utils/matching.js\";\n\n/**\n * Grok Build CLI Adapter\n *\n * Detects running Grok Build CLI agents by:\n * 1. Filtering `grok` processes from a shared asynchronous snapshot — Grok is\n *    a native binary at ~/.grok/bin/grok, so argv[0] basename is `grok`.\n * 2. Resolving each live process to its working directory via\n *    ~/.grok/active_sessions.json, which Grok maintains as a list of\n *    { pid, cwd, opened_at } for every running session. The cwd is then encoded\n *    into the session group dir ~/.grok/sessions/<encodeURIComponent(cwd)>/, and\n *    the most recently active session subdirectory is picked from it. The\n *    process cwd from lsof is only a fallback when the PID is not registered.\n * 3. Reading the session transcript from chat_history.jsonl (the authoritative\n *    record of the conversation). The last user turn (the text inside\n *    <user_query>...</user_query>) is the summary; the file's mtime is the last\n *    activity time. summary.json / updates.jsonl are intentionally not used.\n */\n\nconst CHAT_HISTORY_FILE = \"chat_history.jsonl\";\nconst ACTIVE_SESSIONS_FILE = \"active_sessions.json\";\nconst CWD_FILE = \".cwd\";\nconst IDLE_THRESHOLD_MINUTES = 5;\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/** One line of chat_history.jsonl. */\ninterface ChatRecord {\n  type?: string;\n  content?: unknown;\n}\n\ninterface ChatScan {\n  messages: ConversationMessage[];\n  firstUserMessage?: string;\n  lastUserMessage?: string;\n  lastRole?: ConversationMessage[\"role\"];\n}\n\n/** Parsed state for a single ~/.grok/sessions/<cwd>/<id>/ directory. */\ninterface GrokSession {\n  sessionId: string;\n  projectPath: string;\n  summary: string;\n  sessionStart: Date;\n  lastActive: Date;\n  firstUserMessage?: string;\n  lastUserMessage?: string;\n  lastRole?: ConversationMessage[\"role\"];\n}\n\nexport class GrokCliAdapter implements AgentAdapter {\n  readonly type = \"grok_cli\" as const;\n  readonly processNames = [\"grok\"] as const;\n\n  private base: string;\n  private sessionsDir: string;\n\n  constructor() {\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    const homeDir = process.env.HOME || process.env.USERPROFILE || \"\";\n    this.base = process.env.GROK_HOME || path.join(homeDir, \".grok\");\n    this.sessionsDir = path.join(this.base, \"sessions\");\n  }\n\n  canHandle(processInfo: ProcessInfo): boolean {\n    return this.isGrokExecutable(processInfo.command);\n  }\n\n  private isGrokExecutable(command: string): boolean {\n    const base = executableBasename(command);\n    return base === \"grok\" || base === \"grok.exe\";\n  }\n\n  async detectAgents(context?: AgentDetectionContext): Promise<AgentInfo[]> {\n    const snapshot = context?.processes ?? (await captureProcessSnapshot(this.processNames));\n    const relevant = filterByProcessNames(snapshot, this.processNames);\n    const processes = relevant.filter((process) => this.canHandle(process));\n    if (processes.length === 0) {\n      return [];\n    }\n\n    // active_sessions.json is the authoritative pid -> cwd map for live\n    // sessions; the lsof-derived process cwd is only a fallback.\n    const pidToCwd = this.readActiveSessions();\n\n    const agents: AgentInfo[] = [];\n    for (const proc of processes) {\n      const cwd = pidToCwd.get(proc.pid) || proc.cwd || \"\";\n      const sessionDir = cwd ? this.latestSessionDir(cwd) : null;\n      const session = sessionDir ? this.readSession(sessionDir, cwd) : null;\n\n      if (session && sessionDir) {\n        agents.push(this.mapSessionToAgent(session, proc, sessionDir));\n      } else {\n        agents.push(this.mapProcessOnlyAgent(proc, cwd));\n      }\n    }\n\n    return agents;\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.base, 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   * Full paths of the session subdirectories directly under a group dir,\n   * skipping any non-directory entries. Shared by latestSessionDir() and\n   * listSessions() so both enumerate session dirs the same way.\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   * 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 = this.getProjectDir(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 mapSessionToAgent(\n    session: GrokSession,\n    processInfo: ProcessInfo,\n    sessionDir: string,\n  ): AgentInfo {\n    const projectPath = session.projectPath || processInfo.cwd || \"\";\n    return {\n      name: generateAgentName(projectPath, processInfo.pid),\n      type: this.type,\n      status: this.determineStatus(session),\n      summary: session.summary || \"Grok CLI session active\",\n      pid: processInfo.pid,\n      projectPath,\n      sessionId: session.sessionId,\n      lastActive: session.lastActive,\n      sessionFilePath: path.join(sessionDir, CHAT_HISTORY_FILE),\n    };\n  }\n\n  private mapProcessOnlyAgent(processInfo: ProcessInfo, cwd: string): AgentInfo {\n    const projectPath = cwd || processInfo.cwd || \"\";\n    return {\n      name: generateAgentName(projectPath, processInfo.pid),\n      type: this.type,\n      status: AgentStatus.RUNNING,\n      summary: \"Grok CLI process running\",\n      pid: processInfo.pid,\n      projectPath,\n      sessionId: `pid-${processInfo.pid}`,\n      lastActive: new Date(),\n    };\n  }\n\n  getConversation(sessionFilePath: string, options?: { verbose?: boolean }): ConversationMessage[] {\n    return this.parseChatHistory(this.resolveChatPath(sessionFilePath), options?.verbose ?? false)\n      .messages;\n  }\n\n  async listSessions(opts?: ListSessionsOptions): Promise<SessionSummary[]> {\n    if (!isDirectory(this.sessionsDir)) return [];\n\n    const filterCwd = opts?.cwd;\n    const summaries: SessionSummary[] = [];\n\n    for (const groupName of safeReaddir(this.sessionsDir)) {\n      const groupDir = path.join(this.sessionsDir, groupName);\n      if (!isDirectory(groupDir)) continue;\n\n      const decodedCwd = this.decodeGroupCwd(groupName, groupDir);\n\n      for (const sessionDir of this.listSessionDirs(groupDir)) {\n        const session = this.readSession(sessionDir, decodedCwd);\n        if (!session) continue;\n\n        const cwd = session.projectPath || decodedCwd;\n        if (filterCwd !== undefined && cwd !== filterCwd) continue;\n\n        summaries.push({\n          type: this.type,\n          sessionId: session.sessionId,\n          cwd,\n          firstUserMessage: session.firstUserMessage || \"\",\n          lastActive: session.lastActive,\n          startedAt: session.sessionStart,\n          sessionFilePath: path.join(sessionDir, CHAT_HISTORY_FILE),\n        });\n      }\n    }\n\n    return summaries;\n  }\n\n  // --- Session parsing (chat_history.jsonl) ---\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  private 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 scan = this.parseChatHistory(chatPath, false);\n    const dirStat = safeStat(sessionDir);\n    const lastActive = chatStat.mtime;\n\n    return {\n      sessionId: path.basename(sessionDir),\n      projectPath: defaultCwd || \"\",\n      summary: scan.lastUserMessage || \"Grok CLI session active\",\n      sessionStart: dirStat?.birthtime || lastActive,\n      lastActive,\n      firstUserMessage: scan.firstUserMessage,\n      lastUserMessage: scan.lastUserMessage,\n      lastRole: scan.lastRole,\n    };\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  private determineStatus(session: GrokSession): AgentStatus {\n    const diffMinutes = (Date.now() - session.lastActive.getTime()) / 60000;\n    if (diffMinutes > IDLE_THRESHOLD_MINUTES) {\n      return AgentStatus.IDLE;\n    }\n    if (session.lastRole === \"assistant\") {\n      return AgentStatus.WAITING;\n    }\n    return AgentStatus.RUNNING;\n  }\n\n  /**\n   * Single pass over chat_history.jsonl. Each line is a\n   * { type: 'system' | 'user' | 'assistant', content } record where content is\n   * 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 parseChatHistory(chatPath: string, verbose: boolean): ChatScan {\n    const empty: ChatScan = { messages: [] };\n    const content = safeReadFile(chatPath);\n    if (content === undefined) return empty;\n\n    const messages: ConversationMessage[] = [];\n    let lastRole: ConversationMessage[\"role\"] | undefined;\n\n    for (const line of content.trim().split(\"\\n\")) {\n      if (!line.trim()) continue;\n\n      let record: ChatRecord;\n      try {\n        record = JSON.parse(line);\n      } catch {\n        continue;\n      }\n\n      const text = this.extractText(record.content);\n      if (record.type === \"user\") {\n        const query = this.extractUserQuery(text);\n        if (query === null) continue; // context injection, not a real prompt\n        messages.push({ role: \"user\", content: query });\n        lastRole = \"user\";\n      } else if (record.type === \"assistant\") {\n        if (!text) continue;\n        messages.push({ role: \"assistant\", content: text });\n        lastRole = \"assistant\";\n      } else if (verbose && record.type === \"system\") {\n        if (!text) continue;\n        messages.push({ role: \"system\", content: text });\n      }\n    }\n\n    const userTurns = messages.filter((m) => m.role === \"user\");\n    return {\n      messages,\n      firstUserMessage: userTurns[0]?.content,\n      lastUserMessage: userTurns[userTurns.length - 1]?.content,\n      lastRole,\n    };\n  }\n\n  /** Flatten a chat record's content (string or text-block array) to text. */\n  private extractText(content: unknown): string {\n    if (typeof content === \"string\") return content;\n    if (Array.isArray(content)) {\n      return content\n        .map((block) =>\n          block &&\n          typeof block === \"object\" &&\n          typeof (block as { text?: unknown }).text === \"string\"\n            ? (block as { text: string }).text\n            : \"\",\n        )\n        .join(\"\");\n    }\n    return \"\";\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  private getProjectDir(cwd: string): string {\n    return path.join(this.sessionsDir, encodeURIComponent(cwd));\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","AgentStatus","captureProcessSnapshot","executableBasename","filterByProcessNames","isDirectory","safeReadFile","safeReaddir","safeStat","generateAgentName","CHAT_HISTORY_FILE","ACTIVE_SESSIONS_FILE","CWD_FILE","IDLE_THRESHOLD_MINUTES","GrokCliAdapter","type","processNames","base","sessionsDir","homeDir","process","env","HOME","USERPROFILE","GROK_HOME","join","canHandle","processInfo","isGrokExecutable","command","detectAgents","context","snapshot","processes","relevant","filter","length","pidToCwd","readActiveSessions","agents","proc","cwd","get","pid","sessionDir","latestSessionDir","session","readSession","push","mapSessionToAgent","mapProcessOnlyAgent","map","Map","content","undefined","entries","JSON","parse","Array","isArray","entry","set","listSessionDirs","groupDir","sessionId","getProjectDir","best","stat","mtimeMs","dir","projectPath","name","status","determineStatus","summary","lastActive","sessionFilePath","RUNNING","Date","getConversation","options","parseChatHistory","resolveChatPath","verbose","messages","listSessions","opts","filterCwd","summaries","groupName","decodedCwd","decodeGroupCwd","firstUserMessage","startedAt","sessionStart","defaultCwd","chatPath","chatStat","scan","dirStat","mtime","basename","lastUserMessage","birthtime","lastRole","diffMinutes","now","getTime","IDLE","WAITING","empty","line","trim","split","record","text","extractText","query","extractUserQuery","role","userTurns","m","block","match","sessionPath","endsWith","encodeURIComponent","fromFile","decodeURIComponent"],"mappings":"AAAA,YAAYA,UAAU,OAAO;AAU7B,SAASC,WAAW,QAAQ,oBAAoB;AAChD,SACEC,sBAAsB,EACtBC,kBAAkB,EAClBC,oBAAoB,QACf,sBAAsB;AAC7B,SAASC,WAAW,EAAEC,YAAY,EAAEC,WAAW,EAAEC,QAAQ,QAAQ,sBAAsB;AACvF,SAASC,iBAAiB,QAAQ,uBAAuB;AAEzD;;;;;;;;;;;;;;;;CAgBC,GAED,MAAMC,oBAAoB;AAC1B,MAAMC,uBAAuB;AAC7B,MAAMC,WAAW;AACjB,MAAMC,yBAAyB;AAkC/B,OAAO,MAAMC;IACFC,OAAO,WAAoB;IAC3BC,eAAe;QAAC;KAAO,CAAU;IAElCC,KAAa;IACbC,YAAoB;IAE5B,aAAc;QACZ,sEAAsE;QACtE,sDAAsD;QACtD,+BAA+B;QAC/B,MAAMC,UAAUC,QAAQC,GAAG,CAACC,IAAI,IAAIF,QAAQC,GAAG,CAACE,WAAW,IAAI;QAC/D,IAAI,CAACN,IAAI,GAAGG,QAAQC,GAAG,CAACG,SAAS,IAAIxB,KAAKyB,IAAI,CAACN,SAAS;QACxD,IAAI,CAACD,WAAW,GAAGlB,KAAKyB,IAAI,CAAC,IAAI,CAACR,IAAI,EAAE;IAC1C;IAEAS,UAAUC,WAAwB,EAAW;QAC3C,OAAO,IAAI,CAACC,gBAAgB,CAACD,YAAYE,OAAO;IAClD;IAEQD,iBAAiBC,OAAe,EAAW;QACjD,MAAMZ,OAAOd,mBAAmB0B;QAChC,OAAOZ,SAAS,UAAUA,SAAS;IACrC;IAEA,MAAMa,aAAaC,OAA+B,EAAwB;QACxE,MAAMC,WAAWD,SAASE,aAAc,MAAM/B,uBAAuB,IAAI,CAACc,YAAY;QACtF,MAAMkB,WAAW9B,qBAAqB4B,UAAU,IAAI,CAAChB,YAAY;QACjE,MAAMiB,YAAYC,SAASC,MAAM,CAAC,CAACf,WAAY,IAAI,CAACM,SAAS,CAACN;QAC9D,IAAIa,UAAUG,MAAM,KAAK,GAAG;YAC1B,OAAO,EAAE;QACX;QAEA,oEAAoE;QACpE,6DAA6D;QAC7D,MAAMC,WAAW,IAAI,CAACC,kBAAkB;QAExC,MAAMC,SAAsB,EAAE;QAC9B,KAAK,MAAMC,QAAQP,UAAW;YAC5B,MAAMQ,MAAMJ,SAASK,GAAG,CAACF,KAAKG,GAAG,KAAKH,KAAKC,GAAG,IAAI;YAClD,MAAMG,aAAaH,MAAM,IAAI,CAACI,gBAAgB,CAACJ,OAAO;YACtD,MAAMK,UAAUF,aAAa,IAAI,CAACG,WAAW,CAACH,YAAYH,OAAO;YAEjE,IAAIK,WAAWF,YAAY;gBACzBL,OAAOS,IAAI,CAAC,IAAI,CAACC,iBAAiB,CAACH,SAASN,MAAMI;YACpD,OAAO;gBACLL,OAAOS,IAAI,CAAC,IAAI,CAACE,mBAAmB,CAACV,MAAMC;YAC7C;QACF;QAEA,OAAOF;IACT;IAEA;;;;GAIC,GACD,AAAQD,qBAA0C;QAChD,MAAMa,MAAM,IAAIC;QAChB,MAAMC,UAAU/C,aAAaN,KAAKyB,IAAI,CAAC,IAAI,CAACR,IAAI,EAAEN;QAClD,IAAI0C,YAAYC,WAAW,OAAOH;QAElC,IAAII;QACJ,IAAI;YACFA,UAAUC,KAAKC,KAAK,CAACJ;QACvB,EAAE,OAAM;YACN,OAAOF;QACT;QACA,IAAI,CAACO,MAAMC,OAAO,CAACJ,UAAU,OAAOJ;QAEpC,KAAK,MAAMS,SAASL,QAAiC;YACnD,IAAI,OAAOK,OAAOjB,QAAQ,YAAY,OAAOiB,OAAOnB,QAAQ,YAAYmB,MAAMnB,GAAG,EAAE;gBACjFU,IAAIU,GAAG,CAACD,MAAMjB,GAAG,EAAEiB,MAAMnB,GAAG;YAC9B;QACF;QACA,OAAOU;IACT;IAEA;;;;GAIC,GACD,AAAQW,gBAAgBC,QAAgB,EAAY;QAClD,OAAOxD,YAAYwD,UAChBZ,GAAG,CAAC,CAACa,YAAchE,KAAKyB,IAAI,CAACsC,UAAUC,YACvC7B,MAAM,CAAC,CAACS,aAAevC,YAAYuC;IACxC;IAEA;;;;;GAKC,GACD,AAAQC,iBAAiBJ,GAAW,EAAiB;QACnD,MAAMsB,WAAW,IAAI,CAACE,aAAa,CAACxB;QACpC,IAAI,CAACpC,YAAY0D,WAAW,OAAO;QAEnC,IAAIG,OAAgD;QACpD,KAAK,MAAMtB,cAAc,IAAI,CAACkB,eAAe,CAACC,UAAW;YACvD,MAAMI,OAAO3D,SAASR,KAAKyB,IAAI,CAACmB,YAAYlC;YAC5C,IAAI,CAACyD,MAAM;YACX,IAAI,CAACD,QAAQC,KAAKC,OAAO,GAAGF,KAAKE,OAAO,EAAE;gBACxCF,OAAO;oBAAEG,KAAKzB;oBAAYwB,SAASD,KAAKC,OAAO;gBAAC;YAClD;QACF;QACA,OAAOF,MAAMG,OAAO;IACtB;IAEQpB,kBACNH,OAAoB,EACpBnB,WAAwB,EACxBiB,UAAkB,EACP;QACX,MAAM0B,cAAcxB,QAAQwB,WAAW,IAAI3C,YAAYc,GAAG,IAAI;QAC9D,OAAO;YACL8B,MAAM9D,kBAAkB6D,aAAa3C,YAAYgB,GAAG;YACpD5B,MAAM,IAAI,CAACA,IAAI;YACfyD,QAAQ,IAAI,CAACC,eAAe,CAAC3B;YAC7B4B,SAAS5B,QAAQ4B,OAAO,IAAI;YAC5B/B,KAAKhB,YAAYgB,GAAG;YACpB2B;YACAN,WAAWlB,QAAQkB,SAAS;YAC5BW,YAAY7B,QAAQ6B,UAAU;YAC9BC,iBAAiB5E,KAAKyB,IAAI,CAACmB,YAAYlC;QACzC;IACF;IAEQwC,oBAAoBvB,WAAwB,EAAEc,GAAW,EAAa;QAC5E,MAAM6B,cAAc7B,OAAOd,YAAYc,GAAG,IAAI;QAC9C,OAAO;YACL8B,MAAM9D,kBAAkB6D,aAAa3C,YAAYgB,GAAG;YACpD5B,MAAM,IAAI,CAACA,IAAI;YACfyD,QAAQvE,YAAY4E,OAAO;YAC3BH,SAAS;YACT/B,KAAKhB,YAAYgB,GAAG;YACpB2B;YACAN,WAAW,CAAC,IAAI,EAAErC,YAAYgB,GAAG,EAAE;YACnCgC,YAAY,IAAIG;QAClB;IACF;IAEAC,gBAAgBH,eAAuB,EAAEI,OAA+B,EAAyB;QAC/F,OAAO,IAAI,CAACC,gBAAgB,CAAC,IAAI,CAACC,eAAe,CAACN,kBAAkBI,SAASG,WAAW,OACrFC,QAAQ;IACb;IAEA,MAAMC,aAAaC,IAA0B,EAA6B;QACxE,IAAI,CAACjF,YAAY,IAAI,CAACa,WAAW,GAAG,OAAO,EAAE;QAE7C,MAAMqE,YAAYD,MAAM7C;QACxB,MAAM+C,YAA8B,EAAE;QAEtC,KAAK,MAAMC,aAAalF,YAAY,IAAI,CAACW,WAAW,EAAG;YACrD,MAAM6C,WAAW/D,KAAKyB,IAAI,CAAC,IAAI,CAACP,WAAW,EAAEuE;YAC7C,IAAI,CAACpF,YAAY0D,WAAW;YAE5B,MAAM2B,aAAa,IAAI,CAACC,cAAc,CAACF,WAAW1B;YAElD,KAAK,MAAMnB,cAAc,IAAI,CAACkB,eAAe,CAACC,UAAW;gBACvD,MAAMjB,UAAU,IAAI,CAACC,WAAW,CAACH,YAAY8C;gBAC7C,IAAI,CAAC5C,SAAS;gBAEd,MAAML,MAAMK,QAAQwB,WAAW,IAAIoB;gBACnC,IAAIH,cAAcjC,aAAab,QAAQ8C,WAAW;gBAElDC,UAAUxC,IAAI,CAAC;oBACbjC,MAAM,IAAI,CAACA,IAAI;oBACfiD,WAAWlB,QAAQkB,SAAS;oBAC5BvB;oBACAmD,kBAAkB9C,QAAQ8C,gBAAgB,IAAI;oBAC9CjB,YAAY7B,QAAQ6B,UAAU;oBAC9BkB,WAAW/C,QAAQgD,YAAY;oBAC/BlB,iBAAiB5E,KAAKyB,IAAI,CAACmB,YAAYlC;gBACzC;YACF;QACF;QAEA,OAAO8E;IACT;IAEA,+CAA+C;IAE/C;;;;GAIC,GACD,AAAQzC,YAAYH,UAAkB,EAAEmD,UAAkB,EAAsB;QAC9E,MAAMC,WAAWhG,KAAKyB,IAAI,CAACmB,YAAYlC;QACvC,MAAMuF,WAAWzF,SAASwF;QAC1B,IAAI,CAACC,UAAU,OAAO;QAEtB,MAAMC,OAAO,IAAI,CAACjB,gBAAgB,CAACe,UAAU;QAC7C,MAAMG,UAAU3F,SAASoC;QACzB,MAAM+B,aAAasB,SAASG,KAAK;QAEjC,OAAO;YACLpC,WAAWhE,KAAKqG,QAAQ,CAACzD;YACzB0B,aAAayB,cAAc;YAC3BrB,SAASwB,KAAKI,eAAe,IAAI;YACjCR,cAAcK,SAASI,aAAa5B;YACpCA;YACAiB,kBAAkBM,KAAKN,gBAAgB;YACvCU,iBAAiBJ,KAAKI,eAAe;YACrCE,UAAUN,KAAKM,QAAQ;QACzB;IACF;IAEA;;;;;;GAMC,GACD,AAAQ/B,gBAAgB3B,OAAoB,EAAe;QACzD,MAAM2D,cAAc,AAAC3B,CAAAA,KAAK4B,GAAG,KAAK5D,QAAQ6B,UAAU,CAACgC,OAAO,EAAC,IAAK;QAClE,IAAIF,cAAc5F,wBAAwB;YACxC,OAAOZ,YAAY2G,IAAI;QACzB;QACA,IAAI9D,QAAQ0D,QAAQ,KAAK,aAAa;YACpC,OAAOvG,YAAY4G,OAAO;QAC5B;QACA,OAAO5G,YAAY4E,OAAO;IAC5B;IAEA;;;;;;;;GAQC,GACD,AAAQI,iBAAiBe,QAAgB,EAAEb,OAAgB,EAAY;QACrE,MAAM2B,QAAkB;YAAE1B,UAAU,EAAE;QAAC;QACvC,MAAM/B,UAAU/C,aAAa0F;QAC7B,IAAI3C,YAAYC,WAAW,OAAOwD;QAElC,MAAM1B,WAAkC,EAAE;QAC1C,IAAIoB;QAEJ,KAAK,MAAMO,QAAQ1D,QAAQ2D,IAAI,GAAGC,KAAK,CAAC,MAAO;YAC7C,IAAI,CAACF,KAAKC,IAAI,IAAI;YAElB,IAAIE;YACJ,IAAI;gBACFA,SAAS1D,KAAKC,KAAK,CAACsD;YACtB,EAAE,OAAM;gBACN;YACF;YAEA,MAAMI,OAAO,IAAI,CAACC,WAAW,CAACF,OAAO7D,OAAO;YAC5C,IAAI6D,OAAOnG,IAAI,KAAK,QAAQ;gBAC1B,MAAMsG,QAAQ,IAAI,CAACC,gBAAgB,CAACH;gBACpC,IAAIE,UAAU,MAAM,UAAU,uCAAuC;gBACrEjC,SAASpC,IAAI,CAAC;oBAAEuE,MAAM;oBAAQlE,SAASgE;gBAAM;gBAC7Cb,WAAW;YACb,OAAO,IAAIU,OAAOnG,IAAI,KAAK,aAAa;gBACtC,IAAI,CAACoG,MAAM;gBACX/B,SAASpC,IAAI,CAAC;oBAAEuE,MAAM;oBAAalE,SAAS8D;gBAAK;gBACjDX,WAAW;YACb,OAAO,IAAIrB,WAAW+B,OAAOnG,IAAI,KAAK,UAAU;gBAC9C,IAAI,CAACoG,MAAM;gBACX/B,SAASpC,IAAI,CAAC;oBAAEuE,MAAM;oBAAUlE,SAAS8D;gBAAK;YAChD;QACF;QAEA,MAAMK,YAAYpC,SAASjD,MAAM,CAAC,CAACsF,IAAMA,EAAEF,IAAI,KAAK;QACpD,OAAO;YACLnC;YACAQ,kBAAkB4B,SAAS,CAAC,EAAE,EAAEnE;YAChCiD,iBAAiBkB,SAAS,CAACA,UAAUpF,MAAM,GAAG,EAAE,EAAEiB;YAClDmD;QACF;IACF;IAEA,0EAA0E,GAC1E,AAAQY,YAAY/D,OAAgB,EAAU;QAC5C,IAAI,OAAOA,YAAY,UAAU,OAAOA;QACxC,IAAIK,MAAMC,OAAO,CAACN,UAAU;YAC1B,OAAOA,QACJF,GAAG,CAAC,CAACuE,QACJA,SACA,OAAOA,UAAU,YACjB,OAAO,AAACA,MAA6BP,IAAI,KAAK,WAC1C,AAACO,MAA2BP,IAAI,GAChC,IAEL1F,IAAI,CAAC;QACV;QACA,OAAO;IACT;IAEA;;;GAGC,GACD,AAAQ6F,iBAAiBH,IAAY,EAAiB;QACpD,MAAMQ,QAAQR,KAAKQ,KAAK,CAAC;QACzB,OAAOA,QAAQA,KAAK,CAAC,EAAE,CAACX,IAAI,KAAK;IACnC;IAEA,8EAA8E,GAC9E,AAAQ9B,gBAAgB0C,WAAmB,EAAU;QACnD,OAAOA,YAAYC,QAAQ,CAAC,YAAYD,cAAc5H,KAAKyB,IAAI,CAACmG,aAAalH;IAC/E;IAEQuD,cAAcxB,GAAW,EAAU;QACzC,OAAOzC,KAAKyB,IAAI,CAAC,IAAI,CAACP,WAAW,EAAE4G,mBAAmBrF;IACxD;IAEA;;;;;;;GAOC,GACD,AAAQkD,eAAeF,SAAiB,EAAE1B,QAAgB,EAAU;QAClE,MAAMgE,WAAWzH,aAAaN,KAAKyB,IAAI,CAACsC,UAAUnD;QAClD,IAAImH,aAAazE,aAAayE,SAASf,IAAI,IAAI,OAAOe,SAASf,IAAI;QACnE,IAAI;YACF,OAAOgB,mBAAmBvC;QAC5B,EAAE,OAAM;YACN,OAAO;QACT;IACF;AACF"}

package/src/adapters/GrokCliAdapter.ts

@@ -1,408 +0,0 @@
-import * as path from "path";
-import type {
-  AgentAdapter,
-  AgentInfo,
-  ProcessInfo,
-  ConversationMessage,
-  SessionSummary,
-  ListSessionsOptions,
-  AgentDetectionContext,
-} from "./AgentAdapter.js";
-import { AgentStatus } from "./AgentAdapter.js";
-import {
-  captureProcessSnapshot,
-  executableBasename,
-  filterByProcessNames,
-} from "../utils/process.js";
-import { isDirectory, safeReadFile, safeReaddir, safeStat } from "../utils/session.js";
-import { generateAgentName } from "../utils/matching.js";
-
-/**
- * Grok Build CLI Adapter
- *
- * Detects running Grok Build CLI agents by:
- * 1. Filtering `grok` processes from a shared asynchronous snapshot — Grok is
- *    a native binary at ~/.grok/bin/grok, so argv[0] basename is `grok`.
- * 2. Resolving each live process to its working directory via
- *    ~/.grok/active_sessions.json, which Grok maintains as a list of
- *    { pid, cwd, opened_at } for every running session. The cwd is then encoded
- *    into the session group dir ~/.grok/sessions/<encodeURIComponent(cwd)>/, and
- *    the most recently active session subdirectory is picked from it. The
- *    process cwd from lsof is only a fallback when the PID is not registered.
- * 3. Reading the session transcript from chat_history.jsonl (the authoritative
- *    record of the conversation). The last user turn (the text inside
- *    <user_query>...</user_query>) is the summary; the file's mtime is the last
- *    activity time. summary.json / updates.jsonl are intentionally not used.
- */
-
-const CHAT_HISTORY_FILE = "chat_history.jsonl";
-const ACTIVE_SESSIONS_FILE = "active_sessions.json";
-const CWD_FILE = ".cwd";
-const IDLE_THRESHOLD_MINUTES = 5;
-
-/** One entry of ~/.grok/active_sessions.json. */
-interface ActiveSessionEntry {
-  pid?: number;
-  cwd?: string;
-  opened_at?: number | string;
-}
-
-/** One line of chat_history.jsonl. */
-interface ChatRecord {
-  type?: string;
-  content?: unknown;
-}
-
-interface ChatScan {
-  messages: ConversationMessage[];
-  firstUserMessage?: string;
-  lastUserMessage?: string;
-  lastRole?: ConversationMessage["role"];
-}
-
-/** Parsed state for a single ~/.grok/sessions/<cwd>/<id>/ directory. */
-interface GrokSession {
-  sessionId: string;
-  projectPath: string;
-  summary: string;
-  sessionStart: Date;
-  lastActive: Date;
-  firstUserMessage?: string;
-  lastUserMessage?: string;
-  lastRole?: ConversationMessage["role"];
-}
-
-export class GrokCliAdapter implements AgentAdapter {
-  readonly type = "grok_cli" as const;
-  readonly processNames = ["grok"] as const;
-
-  private base: string;
-  private sessionsDir: string;
-
-  constructor() {
-    // GROK_HOME overrides the ~/.grok base directory; sessions live under
-    // <base>/sessions/ and the active-session registry at
-    // <base>/active_sessions.json.
-    const homeDir = process.env.HOME || process.env.USERPROFILE || "";
-    this.base = process.env.GROK_HOME || path.join(homeDir, ".grok");
-    this.sessionsDir = path.join(this.base, "sessions");
-  }
-
-  canHandle(processInfo: ProcessInfo): boolean {
-    return this.isGrokExecutable(processInfo.command);
-  }
-
-  private isGrokExecutable(command: string): boolean {
-    const base = executableBasename(command);
-    return base === "grok" || base === "grok.exe";
-  }
-
-  async detectAgents(context?: AgentDetectionContext): Promise<AgentInfo[]> {
-    const snapshot = context?.processes ?? (await captureProcessSnapshot(this.processNames));
-    const relevant = filterByProcessNames(snapshot, this.processNames);
-    const processes = relevant.filter((process) => this.canHandle(process));
-    if (processes.length === 0) {
-      return [];
-    }
-
-    // active_sessions.json is the authoritative pid -> cwd map for live
-    // sessions; the lsof-derived process cwd is only a fallback.
-    const pidToCwd = this.readActiveSessions();
-
-    const agents: AgentInfo[] = [];
-    for (const proc of processes) {
-      const cwd = pidToCwd.get(proc.pid) || proc.cwd || "";
-      const sessionDir = cwd ? this.latestSessionDir(cwd) : null;
-      const session = sessionDir ? this.readSession(sessionDir, cwd) : null;
-
-      if (session && sessionDir) {
-        agents.push(this.mapSessionToAgent(session, proc, sessionDir));
-      } else {
-        agents.push(this.mapProcessOnlyAgent(proc, cwd));
-      }
-    }
-
-    return agents;
-  }
-
-  /**
-   * 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.
-   */
-  private readActiveSessions(): Map<number, string> {
-    const map = new Map<number, string>();
-    const content = safeReadFile(path.join(this.base, ACTIVE_SESSIONS_FILE));
-    if (content === undefined) return map;
-
-    let entries: unknown;
-    try {
-      entries = JSON.parse(content);
-    } catch {
-      return map;
-    }
-    if (!Array.isArray(entries)) return map;
-
-    for (const entry of entries as ActiveSessionEntry[]) {
-      if (typeof entry?.pid === "number" && typeof entry?.cwd === "string" && entry.cwd) {
-        map.set(entry.pid, entry.cwd);
-      }
-    }
-    return map;
-  }
-
-  /**
-   * Full paths of the session subdirectories directly under a group dir,
-   * skipping any non-directory entries. Shared by latestSessionDir() and
-   * listSessions() so both enumerate session dirs the same way.
-   */
-  private listSessionDirs(groupDir: string): string[] {
-    return safeReaddir(groupDir)
-      .map((sessionId) => path.join(groupDir, sessionId))
-      .filter((sessionDir) => isDirectory(sessionDir));
-  }
-
-  /**
-   * 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.
-   */
-  private latestSessionDir(cwd: string): string | null {
-    const groupDir = this.getProjectDir(cwd);
-    if (!isDirectory(groupDir)) return null;
-
-    let best: { dir: string; mtimeMs: number } | null = 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;
-  }
-
-  private mapSessionToAgent(
-    session: GrokSession,
-    processInfo: ProcessInfo,
-    sessionDir: string,
-  ): AgentInfo {
-    const projectPath = session.projectPath || processInfo.cwd || "";
-    return {
-      name: generateAgentName(projectPath, processInfo.pid),
-      type: this.type,
-      status: this.determineStatus(session),
-      summary: session.summary || "Grok CLI session active",
-      pid: processInfo.pid,
-      projectPath,
-      sessionId: session.sessionId,
-      lastActive: session.lastActive,
-      sessionFilePath: path.join(sessionDir, CHAT_HISTORY_FILE),
-    };
-  }
-
-  private mapProcessOnlyAgent(processInfo: ProcessInfo, cwd: string): AgentInfo {
-    const projectPath = cwd || processInfo.cwd || "";
-    return {
-      name: generateAgentName(projectPath, processInfo.pid),
-      type: this.type,
-      status: AgentStatus.RUNNING,
-      summary: "Grok CLI process running",
-      pid: processInfo.pid,
-      projectPath,
-      sessionId: `pid-${processInfo.pid}`,
-      lastActive: new Date(),
-    };
-  }
-
-  getConversation(sessionFilePath: string, options?: { verbose?: boolean }): ConversationMessage[] {
-    return this.parseChatHistory(this.resolveChatPath(sessionFilePath), options?.verbose ?? false)
-      .messages;
-  }
-
-  async listSessions(opts?: ListSessionsOptions): Promise<SessionSummary[]> {
-    if (!isDirectory(this.sessionsDir)) return [];
-
-    const filterCwd = opts?.cwd;
-    const summaries: SessionSummary[] = [];
-
-    for (const groupName of safeReaddir(this.sessionsDir)) {
-      const groupDir = path.join(this.sessionsDir, groupName);
-      if (!isDirectory(groupDir)) continue;
-
-      const decodedCwd = this.decodeGroupCwd(groupName, groupDir);
-
-      for (const sessionDir of this.listSessionDirs(groupDir)) {
-        const session = this.readSession(sessionDir, decodedCwd);
-        if (!session) continue;
-
-        const cwd = session.projectPath || decodedCwd;
-        if (filterCwd !== undefined && cwd !== filterCwd) continue;
-
-        summaries.push({
-          type: this.type,
-          sessionId: session.sessionId,
-          cwd,
-          firstUserMessage: session.firstUserMessage || "",
-          lastActive: session.lastActive,
-          startedAt: session.sessionStart,
-          sessionFilePath: path.join(sessionDir, CHAT_HISTORY_FILE),
-        });
-      }
-    }
-
-    return summaries;
-  }
-
-  // --- Session parsing (chat_history.jsonl) ---
-
-  /**
-   * 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.
-   */
-  private readSession(sessionDir: string, defaultCwd: string): GrokSession | null {
-    const chatPath = path.join(sessionDir, CHAT_HISTORY_FILE);
-    const chatStat = safeStat(chatPath);
-    if (!chatStat) return null;
-
-    const scan = this.parseChatHistory(chatPath, false);
-    const dirStat = safeStat(sessionDir);
-    const lastActive = chatStat.mtime;
-
-    return {
-      sessionId: path.basename(sessionDir),
-      projectPath: defaultCwd || "",
-      summary: scan.lastUserMessage || "Grok CLI session active",
-      sessionStart: dirStat?.birthtime || lastActive,
-      lastActive,
-      firstUserMessage: scan.firstUserMessage,
-      lastUserMessage: scan.lastUserMessage,
-      lastRole: scan.lastRole,
-    };
-  }
-
-  /**
-   * 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
-   */
-  private determineStatus(session: GrokSession): AgentStatus {
-    const diffMinutes = (Date.now() - session.lastActive.getTime()) / 60000;
-    if (diffMinutes > IDLE_THRESHOLD_MINUTES) {
-      return AgentStatus.IDLE;
-    }
-    if (session.lastRole === "assistant") {
-      return AgentStatus.WAITING;
-    }
-    return AgentStatus.RUNNING;
-  }
-
-  /**
-   * Single pass over chat_history.jsonl. Each line is a
-   * { type: 'system' | 'user' | 'assistant', content } record 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 parseChatHistory(chatPath: string, verbose: boolean): ChatScan {
-    const empty: ChatScan = { messages: [] };
-    const content = safeReadFile(chatPath);
-    if (content === undefined) return empty;
-
-    const messages: ConversationMessage[] = [];
-    let lastRole: ConversationMessage["role"] | undefined;
-
-    for (const line of content.trim().split("\n")) {
-      if (!line.trim()) continue;
-
-      let record: ChatRecord;
-      try {
-        record = JSON.parse(line);
-      } catch {
-        continue;
-      }
-
-      const text = this.extractText(record.content);
-      if (record.type === "user") {
-        const query = this.extractUserQuery(text);
-        if (query === null) continue; // context injection, not a real prompt
-        messages.push({ role: "user", content: query });
-        lastRole = "user";
-      } else if (record.type === "assistant") {
-        if (!text) continue;
-        messages.push({ role: "assistant", content: text });
-        lastRole = "assistant";
-      } else if (verbose && record.type === "system") {
-        if (!text) continue;
-        messages.push({ role: "system", content: text });
-      }
-    }
-
-    const userTurns = messages.filter((m) => m.role === "user");
-    return {
-      messages,
-      firstUserMessage: userTurns[0]?.content,
-      lastUserMessage: userTurns[userTurns.length - 1]?.content,
-      lastRole,
-    };
-  }
-
-  /** Flatten a chat record's content (string or text-block array) to text. */
-  private extractText(content: unknown): string {
-    if (typeof content === "string") return content;
-    if (Array.isArray(content)) {
-      return content
-        .map((block) =>
-          block &&
-          typeof block === "object" &&
-          typeof (block as { text?: unknown }).text === "string"
-            ? (block as { text: string }).text
-            : "",
-        )
-        .join("");
-    }
-    return "";
-  }
-
-  /**
-   * 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(text: string): string | null {
-    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. */
-  private resolveChatPath(sessionPath: string): string {
-    return sessionPath.endsWith(".jsonl") ? sessionPath : path.join(sessionPath, CHAT_HISTORY_FILE);
-  }
-
-  private getProjectDir(cwd: string): string {
-    return path.join(this.sessionsDir, encodeURIComponent(cwd));
-  }
-
-  /**
-   * 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.
-   */
-  private decodeGroupCwd(groupName: string, groupDir: string): string {
-    const fromFile = safeReadFile(path.join(groupDir, CWD_FILE));
-    if (fromFile !== undefined && fromFile.trim()) return fromFile.trim();
-    try {
-      return decodeURIComponent(groupName);
-    } catch {
-      return "";
-    }
-  }
-}