@ai-devkit/agent-manager 0.34.0 → 0.35.0

package/src/providers/opencode/OpenCodeSessionLocator.ts

@@ -16,6 +16,12 @@ export interface OpenCodeSession {
   timeCreated: number;
 }
 
+interface OpenCodeSessionRow {
+  id: string;
+  directory: string;
+  timeCreated: number;
+}
+
 export class OpenCodeSessionLocator {
   private readonly dbPath: string;
   private db: Database.Database | null = null;
@@ -82,7 +88,7 @@ export class OpenCodeSessionLocator {
 
     try {
       const rows = db
-        .prepare<[], { id: string; directory: string; timeCreated: number }>(`
+        .prepare<[], OpenCodeSessionRow>(`
                 SELECT id, directory, time_created AS timeCreated
                 FROM session
                 ORDER BY time_created DESC
@@ -94,20 +100,7 @@ export class OpenCodeSessionLocator {
       for (const row of rows) {
         if (opts?.cwd !== undefined && row.directory !== opts.cwd) continue;
 
-        const stats = this.parser.getSessionStats(db, row.id);
-        const lastActive =
-          stats.lastTimeUpdated > 0 ? new Date(stats.lastTimeUpdated) : new Date(row.timeCreated);
-        const startedAt = new Date(row.timeCreated);
-
-        summaries.push({
-          type: "opencode",
-          sessionId: row.id,
-          cwd: row.directory,
-          firstUserMessage: stats.summary,
-          lastActive,
-          startedAt,
-          sessionFilePath: encodeOpenCodeSessionRef(this.dbPath, row.id),
-        });
+        summaries.push(this.toSessionSummary(db, row));
       }
 
       return summaries;
@@ -117,6 +110,41 @@ export class OpenCodeSessionLocator {
     }
   }
 
+  findSessionsById(sessionId: string): SessionSummary[] {
+    const db = this.openDb();
+    if (!db) return [];
+
+    try {
+      const row = db
+        .prepare<[string], OpenCodeSessionRow>(`
+                SELECT id, directory, time_created AS timeCreated
+                FROM session
+                WHERE id = ?
+            `)
+        .get(sessionId);
+      return row ? [this.toSessionSummary(db, row)] : [];
+    } catch {
+      this.close();
+      return [];
+    }
+  }
+
+  private toSessionSummary(db: Database.Database, row: OpenCodeSessionRow): SessionSummary {
+    const stats = this.parser.getSessionStats(db, row.id);
+    const lastActive =
+      stats.lastTimeUpdated > 0 ? new Date(stats.lastTimeUpdated) : new Date(row.timeCreated);
+
+    return {
+      type: "opencode",
+      sessionId: row.id,
+      cwd: row.directory,
+      firstUserMessage: stats.summary,
+      lastActive,
+      startedAt: new Date(row.timeCreated),
+      sessionFilePath: encodeOpenCodeSessionRef(this.dbPath, row.id),
+    };
+  }
+
   get dbFilePath(): string {
     return this.dbPath;
   }

package/src/providers/pi/PiAdapter.ts

@@ -92,6 +92,18 @@ export class PiAdapter implements AgentAdapter {
     return summaries;
   }
 
+  async findSessionsById(sessionId: string): Promise<SessionSummary[]> {
+    const summaries: SessionSummary[] = [];
+    const filePaths = this.createLocator().findHistoricalSessionFilesById(sessionId);
+    for (const filePath of filePaths) {
+      const summary = this.parser.fileToSessionSummary(filePath);
+      if (summary?.sessionId === sessionId) summaries.push(summary);
+    }
+
+    if (summaries.length > 0) return summaries;
+    return (await this.listSessions()).filter((summary) => summary.sessionId === sessionId);
+  }
+
   private async getPiProcesses(context?: AgentDetectionContext): Promise<ProcessInfo[]> {
     const snapshot = context?.processes ?? (await captureProcessSnapshot(this.processNames));
     const relevant = filterByProcessNames(snapshot, this.processNames);

package/src/providers/pi/PiSessionLocator.ts

@@ -1,7 +1,13 @@
 import * as path from "path";
 import type { ProcessInfo } from "../../adapters/AgentAdapter.js";
 import { matchProcessesToSessions, type MatchResult } from "../../utils/matching.js";
-import { isDirectory, safeReaddir, safeStat, type SessionFile } from "../../utils/session.js";
+import {
+  isDirectory,
+  isSafePathSegment,
+  safeReaddir,
+  safeStat,
+  type SessionFile,
+} from "../../utils/session.js";
 import { PiSessionParser } from "./PiSessionParser.js";
 
 export interface PiSessionLocatorOptions {
@@ -64,6 +70,15 @@ export class PiSessionLocator {
     return this.collectJsonlFiles(this.sessionsDir);
   }
 
+  findHistoricalSessionFilesById(sessionId: string): string[] {
+    if (!isSafePathSegment(sessionId)) return [];
+
+    return this.collectJsonlFiles(this.sessionsDir).filter((filePath) => {
+      const basename = path.basename(filePath, ".jsonl");
+      return basename === sessionId || basename.endsWith(`_${sessionId}`);
+    });
+  }
+
   private buildProjectDirCwdMap(processes: ProcessInfo[]): Map<string, string> {
     const map = new Map<string, string>();
     for (const proc of processes) {

package/src/utils/session.ts

@@ -36,6 +36,17 @@ export function isDirectory(p: string): boolean {
   return safeStat(p)?.isDirectory() ?? false;
 }
 
+/** Return whether a value can be safely appended as one filesystem path segment. */
+export function isSafePathSegment(value: string): boolean {
+  return (
+    value.length > 0 &&
+    value !== "." &&
+    value !== ".." &&
+    !value.includes("\0") &&
+    path.basename(value) === value
+  );
+}
+
 /**
  * `fs.statSync` that swallows errors and returns `undefined` on failure.
  * Callers can pull whichever fields they need (mtime, birthtime, ...).

package/dist/__tests__/adapters/GrokCliAdapter.test.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/__tests__/adapters/GrokCliAdapter.test.ts"],"sourcesContent":["/**\n * Tests for GrokCliAdapter\n *\n * The adapter resolves a live process to its cwd via ~/.grok/active_sessions.json\n * and reads session details from chat_history.jsonl (not summary.json/updates.jsonl).\n */\n\nimport type { MockedFunction } from \"vitest\";\nimport * as fs from \"fs\";\nimport * as os from \"os\";\nimport * as path from \"path\";\n\nimport { GrokCliAdapter } from \"../../adapters/GrokCliAdapter.js\";\nimport type { ProcessInfo } from \"../../adapters/AgentAdapter.js\";\nimport { AgentStatus } from \"../../adapters/AgentAdapter.js\";\nimport {\n  listAgentProcesses,\n  enrichProcesses,\n  captureProcessSnapshot,\n} from \"../../utils/process.js\";\nimport { generateAgentName } from \"../../utils/matching.js\";\n\nvi.mock(\"../../utils/process.js\", async (importOriginal) => {\n  const actual = (await importOriginal()) as typeof import(\"../../utils/process.js\");\n  return {\n    ...actual,\n    listAgentProcesses: vi.fn(),\n    enrichProcesses: vi.fn(),\n    captureProcessSnapshot: vi.fn(),\n  };\n});\n\nvi.mock(\"../../utils/matching.js\", async (importOriginal) => {\n  const actual = (await importOriginal()) as typeof import(\"../../utils/matching.js\");\n  return {\n    ...actual,\n    generateAgentName: vi.fn(),\n  };\n});\n\nconst mockedListAgentProcesses = listAgentProcesses as MockedFunction<typeof listAgentProcesses>;\nconst mockedEnrichProcesses = enrichProcesses as MockedFunction<typeof enrichProcesses>;\nconst mockedCaptureProcessSnapshot = captureProcessSnapshot as MockedFunction<\n  typeof captureProcessSnapshot\n>;\nconst mockedGenerateAgentName = generateAgentName as MockedFunction<typeof generateAgentName>;\n\nconst SESSION_ID = \"019f16c3-5d5d-7dc3-85d1-bc629416ca2d\";\n\n/** A user transcript record: the real prompt wrapped in <user_query> like Grok writes it. */\nconst userRecord = (text: string) => ({\n  type: \"user\",\n  content: [{ type: \"text\", text: `<user_query>\\n${text}\\n</user_query>` }],\n});\n/** A user context-injection record (no <user_query>) — should be ignored as a prompt. */\nconst contextRecord = (text: string) => ({ type: \"user\", content: [{ type: \"text\", text }] });\nconst assistantRecord = (text: string) => ({\n  type: \"assistant\",\n  content: [{ type: \"text\", text }],\n});\nconst systemRecord = (text: string) => ({ type: \"system\", content: text });\n\ndescribe(\"GrokCliAdapter\", () => {\n  let adapter: GrokCliAdapter;\n  let tmpHome: string;\n  let cwd: string;\n\n  beforeEach(() => {\n    tmpHome = fs.mkdtempSync(path.join(os.tmpdir(), \"grok-adapter-test-\"));\n    process.env.HOME = tmpHome;\n    delete process.env.GROK_HOME;\n    cwd = \"/Users/dev/my-project\";\n\n    adapter = new GrokCliAdapter();\n\n    mockedListAgentProcesses.mockReset();\n    mockedEnrichProcesses.mockReset();\n    mockedCaptureProcessSnapshot.mockReset();\n    mockedGenerateAgentName.mockReset();\n\n    mockedEnrichProcesses.mockImplementation((procs) => procs);\n    // Compatibility shim for standalone adapter discovery; the manager captures once and slices by name.\n    mockedCaptureProcessSnapshot.mockImplementation(async (names) =>\n      enrichProcesses(names.flatMap((name) => listAgentProcesses(name))),\n    );\n    mockedGenerateAgentName.mockImplementation(\n      (c: string, pid: number) => `${path.basename(c) || \"unknown\"}-${pid}`,\n    );\n  });\n\n  afterEach(() => {\n    fs.rmSync(tmpHome, { recursive: true, force: true });\n  });\n\n  /** Write a session dir under ~/.grok/sessions/<enc(cwd)>/<id>/chat_history.jsonl. */\n  function writeSession(opts: {\n    sessionCwd?: string;\n    id?: string;\n    records?: object[];\n    chat?: boolean;\n    mtime?: Date;\n  }): string {\n    const sessionCwd = opts.sessionCwd ?? cwd;\n    const id = opts.id ?? SESSION_ID;\n    const sessionDir = path.join(tmpHome, \".grok\", \"sessions\", encodeURIComponent(sessionCwd), id);\n    fs.mkdirSync(sessionDir, { recursive: true });\n\n    if (opts.chat !== false) {\n      const records = opts.records ?? [userRecord(\"fix the bug\")];\n      const chatPath = path.join(sessionDir, \"chat_history.jsonl\");\n      fs.writeFileSync(chatPath, records.map((r) => JSON.stringify(r)).join(\"\\n\"));\n      if (opts.mtime) fs.utimesSync(chatPath, opts.mtime, opts.mtime);\n    }\n\n    return sessionDir;\n  }\n\n  /** Write ~/.grok/active_sessions.json (the live pid -> cwd registry). */\n  function writeActiveSessions(\n    entries: Array<{ pid: number; cwd: string; opened_at?: number }>,\n  ): void {\n    fs.mkdirSync(path.join(tmpHome, \".grok\"), { recursive: true });\n    fs.writeFileSync(path.join(tmpHome, \".grok\", \"active_sessions.json\"), JSON.stringify(entries));\n  }\n\n  function proc(overrides: Partial<ProcessInfo> = {}): ProcessInfo {\n    return {\n      pid: 4242,\n      ppid: 1,\n      command: \"grok\",\n      cwd,\n      tty: \"ttys010\",\n      startTime: new Date(),\n      ...overrides,\n    };\n  }\n\n  describe(\"initialization\", () => {\n    it(\"exposes the grok_cli type\", () => {\n      expect(adapter.type).toBe(\"grok_cli\");\n    });\n  });\n\n  describe(\"canHandle\", () => {\n    it(\"returns true for a plain grok command\", () => {\n      expect(adapter.canHandle(proc({ command: \"grok\" }))).toBe(true);\n    });\n\n    it(\"returns true for grok with a full path and args\", () => {\n      expect(\n        adapter.canHandle(proc({ command: \"/Users/dev/.grok/bin/grok --always-approve\" })),\n      ).toBe(true);\n    });\n\n    it(\"returns false for non-grok processes\", () => {\n      expect(adapter.canHandle(proc({ command: \"node app.js\" }))).toBe(false);\n    });\n\n    it('returns false when \"grok\" appears only in an argument path', () => {\n      expect(adapter.canHandle(proc({ command: \"node /path/to/grok-thing.js\" }))).toBe(false);\n    });\n  });\n\n  describe(\"detectAgents\", () => {\n    it(\"returns [] when there are no grok processes\", async () => {\n      mockedListAgentProcesses.mockReturnValue([]);\n      expect(await adapter.detectAgents()).toEqual([]);\n    });\n\n    it(\"resolves the cwd via active_sessions.json (authoritative over the process cwd)\", async () => {\n      const realCwd = \"/Users/dev/real-project\";\n      writeSession({ sessionCwd: realCwd });\n      // The process cwd is stale/wrong; active_sessions.json has the truth.\n      writeActiveSessions([{ pid: 4242, cwd: realCwd, opened_at: 1 }]);\n      mockedListAgentProcesses.mockReturnValue([proc({ cwd: \"/wrong/path\" })]);\n\n      const agents = await adapter.detectAgents();\n\n      expect(agents).toHaveLength(1);\n      expect(agents[0]).toMatchObject({\n        type: \"grok_cli\",\n        pid: 4242,\n        projectPath: realCwd,\n        sessionId: SESSION_ID,\n        summary: \"fix the bug\",\n      });\n      expect(agents[0].sessionFilePath).toBe(\n        path.join(\n          tmpHome,\n          \".grok\",\n          \"sessions\",\n          encodeURIComponent(realCwd),\n          SESSION_ID,\n          \"chat_history.jsonl\",\n        ),\n      );\n    });\n\n    it(\"falls back to the process cwd when the pid is not in active_sessions.json\", async () => {\n      writeSession({});\n      writeActiveSessions([{ pid: 9999, cwd: \"/somewhere/else\" }]);\n      mockedListAgentProcesses.mockReturnValue([proc()]);\n\n      const agents = await adapter.detectAgents();\n\n      expect(agents[0]).toMatchObject({ projectPath: cwd, sessionId: SESSION_ID });\n    });\n\n    it(\"picks the most recently active session dir when a cwd has several\", async () => {\n      const older = new Date(Date.now() - 60 * 60 * 1000);\n      writeSession({\n        id: \"019f0000-0000-7000-8000-00000000000a\",\n        records: [userRecord(\"old one\")],\n        mtime: older,\n      });\n      writeSession({\n        id: \"019f0000-0000-7000-8000-00000000000b\",\n        records: [userRecord(\"newest one\")],\n      });\n      mockedListAgentProcesses.mockReturnValue([proc()]);\n\n      const agents = await adapter.detectAgents();\n\n      expect(agents[0].sessionId).toBe(\"019f0000-0000-7000-8000-00000000000b\");\n      expect(agents[0].summary).toBe(\"newest one\");\n    });\n\n    it(\"falls back to a process-only RUNNING agent when no session matches\", async () => {\n      mockedListAgentProcesses.mockReturnValue([proc()]);\n\n      const agents = await adapter.detectAgents();\n\n      expect(agents).toHaveLength(1);\n      expect(agents[0].status).toBe(AgentStatus.RUNNING);\n      expect(agents[0].sessionId).toBe(\"pid-4242\");\n      expect(agents[0].sessionFilePath).toBeUndefined();\n    });\n\n    it(\"treats a session dir without chat_history.jsonl as no match (process-only)\", async () => {\n      writeSession({ chat: false });\n      mockedListAgentProcesses.mockReturnValue([proc()]);\n\n      const agents = await adapter.detectAgents();\n\n      expect(agents).toHaveLength(1);\n      expect(agents[0].sessionId).toBe(\"pid-4242\");\n    });\n  });\n\n  describe(\"getConversation\", () => {\n    it(\"maps user (<user_query>) and assistant records to roles\", () => {\n      const dir = writeSession({ records: [userRecord(\"hi\"), assistantRecord(\"hello\")] });\n      expect(adapter.getConversation(path.join(dir, \"chat_history.jsonl\"))).toEqual([\n        { role: \"user\", content: \"hi\" },\n        { role: \"assistant\", content: \"hello\" },\n      ]);\n    });\n\n    it(\"accepts a session dir path and skips context-injection user records\", () => {\n      const dir = writeSession({\n        records: [contextRecord(\"<user_info>OS: macos</user_info>\"), userRecord(\"do the thing\")],\n      });\n      expect(adapter.getConversation(dir)).toEqual([{ role: \"user\", content: \"do the thing\" }]);\n    });\n\n    it(\"skips malformed lines\", () => {\n      const dir = writeSession({ records: [userRecord(\"hi\")] });\n      fs.appendFileSync(path.join(dir, \"chat_history.jsonl\"), \"\\n{bad json\");\n      expect(adapter.getConversation(dir)).toEqual([{ role: \"user\", content: \"hi\" }]);\n    });\n\n    it(\"excludes system records unless verbose\", () => {\n      const dir = writeSession({ records: [systemRecord(\"You are Grok\"), userRecord(\"go\")] });\n      expect(adapter.getConversation(dir)).toEqual([{ role: \"user\", content: \"go\" }]);\n      expect(adapter.getConversation(dir, { verbose: true }).map((m) => m.role)).toEqual([\n        \"system\",\n        \"user\",\n      ]);\n    });\n  });\n\n  describe(\"detectAgents status + summary mapping\", () => {\n    const detectFirst = async () => (await adapter.detectAgents())[0];\n\n    it(\"marks WAITING when the last transcript turn is an assistant message\", async () => {\n      writeSession({ records: [userRecord(\"go\"), assistantRecord(\"done\")] });\n      mockedListAgentProcesses.mockReturnValue([proc()]);\n      expect((await detectFirst()).status).toBe(AgentStatus.WAITING);\n    });\n\n    it(\"marks RUNNING when the last transcript turn is a user message\", async () => {\n      writeSession({ records: [userRecord(\"still there?\")] });\n      mockedListAgentProcesses.mockReturnValue([proc()]);\n      expect((await detectFirst()).status).toBe(AgentStatus.RUNNING);\n    });\n\n    it(\"marks IDLE when chat_history.jsonl is older than the threshold\", async () => {\n      const old = new Date(Date.now() - 10 * 60 * 1000);\n      writeSession({ records: [userRecord(\"go\")], mtime: old });\n      mockedListAgentProcesses.mockReturnValue([proc()]);\n      expect((await detectFirst()).status).toBe(AgentStatus.IDLE);\n    });\n\n    it(\"uses the last user prompt as the agent summary\", async () => {\n      writeSession({ records: [userRecord(\"refactor the parser\"), assistantRecord(\"on it\")] });\n      mockedListAgentProcesses.mockReturnValue([proc()]);\n      expect((await detectFirst()).summary).toBe(\"refactor the parser\");\n    });\n  });\n\n  describe(\"listSessions\", () => {\n    it(\"returns [] when the sessions dir does not exist\", async () => {\n      expect(await adapter.listSessions()).toEqual([]);\n    });\n\n    it(\"lists historical sessions with cwd decoded from the group dir\", async () => {\n      writeSession({});\n      const summaries = await adapter.listSessions();\n      expect(summaries).toHaveLength(1);\n      expect(summaries[0]).toMatchObject({\n        type: \"grok_cli\",\n        sessionId: SESSION_ID,\n        cwd,\n        firstUserMessage: \"fix the bug\",\n      });\n      expect(summaries[0].sessionFilePath).toBe(\n        path.join(\n          tmpHome,\n          \".grok\",\n          \"sessions\",\n          encodeURIComponent(cwd),\n          SESSION_ID,\n          \"chat_history.jsonl\",\n        ),\n      );\n    });\n\n    it(\"applies the cwd filter against the decoded cwd\", async () => {\n      writeSession({\n        sessionCwd: \"/Users/dev/project-a\",\n        id: \"019f0000-0000-7000-8000-00000000000a\",\n      });\n      writeSession({\n        sessionCwd: \"/Users/dev/project-b\",\n        id: \"019f0000-0000-7000-8000-00000000000b\",\n      });\n\n      const all = await adapter.listSessions();\n      expect(all).toHaveLength(2);\n\n      const filtered = await adapter.listSessions({ cwd: \"/Users/dev/project-a\" });\n      expect(filtered).toHaveLength(1);\n      expect(filtered[0].cwd).toBe(\"/Users/dev/project-a\");\n    });\n\n    it(\"skips non-session entries (e.g. prompt_history.jsonl) in a group dir\", async () => {\n      writeSession({});\n      // Grok writes a group-level prompt_history.jsonl alongside session dirs.\n      fs.writeFileSync(\n        path.join(tmpHome, \".grok\", \"sessions\", encodeURIComponent(cwd), \"prompt_history.jsonl\"),\n        '{\"text\":\"noise\"}',\n      );\n      const summaries = await adapter.listSessions();\n      expect(summaries).toHaveLength(1);\n    });\n  });\n});\n"],"names":["fs","os","path","GrokCliAdapter","AgentStatus","listAgentProcesses","enrichProcesses","captureProcessSnapshot","generateAgentName","vi","mock","importOriginal","actual","fn","mockedListAgentProcesses","mockedEnrichProcesses","mockedCaptureProcessSnapshot","mockedGenerateAgentName","SESSION_ID","userRecord","text","type","content","contextRecord","assistantRecord","systemRecord","describe","adapter","tmpHome","cwd","beforeEach","mkdtempSync","join","tmpdir","process","env","HOME","GROK_HOME","mockReset","mockImplementation","procs","names","flatMap","name","c","pid","basename","afterEach","rmSync","recursive","force","writeSession","opts","sessionCwd","id","sessionDir","encodeURIComponent","mkdirSync","chat","records","chatPath","writeFileSync","map","r","JSON","stringify","mtime","utimesSync","writeActiveSessions","entries","proc","overrides","ppid","command","tty","startTime","Date","it","expect","toBe","canHandle","mockReturnValue","detectAgents","toEqual","realCwd","opened_at","agents","toHaveLength","toMatchObject","projectPath","sessionId","summary","sessionFilePath","older","now","status","RUNNING","toBeUndefined","dir","getConversation","role","appendFileSync","verbose","m","detectFirst","WAITING","old","IDLE","listSessions","summaries","firstUserMessage","all","filtered"],"mappings":"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"}

package/dist/adapters/GrokCliAdapter.d.ts

@@ -1,80 +0,0 @@
-import type { AgentAdapter, AgentInfo, ProcessInfo, ConversationMessage, SessionSummary, ListSessionsOptions, AgentDetectionContext } from "./AgentAdapter.js";
-export declare class GrokCliAdapter implements AgentAdapter {
-    readonly type: "grok_cli";
-    readonly processNames: readonly ["grok"];
-    private base;
-    private sessionsDir;
-    constructor();
-    canHandle(processInfo: ProcessInfo): boolean;
-    private isGrokExecutable;
-    detectAgents(context?: AgentDetectionContext): Promise<AgentInfo[]>;
-    /**
-     * 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;
-    /**
-     * 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;
-    /**
-     * 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;
-    private mapSessionToAgent;
-    private mapProcessOnlyAgent;
-    getConversation(sessionFilePath: string, options?: {
-        verbose?: boolean;
-    }): ConversationMessage[];
-    listSessions(opts?: ListSessionsOptions): Promise<SessionSummary[]>;
-    /**
-     * 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;
-    /**
-     * 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;
-    /**
-     * 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;
-    /** Flatten a chat record's content (string or text-block array) to text. */
-    private extractText;
-    /**
-     * 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;
-    private getProjectDir;
-    /**
-     * 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;
-}
-//# sourceMappingURL=GrokCliAdapter.d.ts.map

package/dist/adapters/GrokCliAdapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"GrokCliAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/GrokCliAdapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,mBAAmB,CAAC;AAiE3B,qBAAa,cAAe,YAAW,YAAY;IACjD,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;IACpC,QAAQ,CAAC,YAAY,oBAAqB;IAE1C,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,WAAW,CAAS;;IAW5B,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO;IAI5C,OAAO,CAAC,gBAAgB;IAKlB,YAAY,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IA4BzE;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAMvB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,iBAAiB;IAmBzB,OAAO,CAAC,mBAAmB;IAc3B,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,mBAAmB,EAAE;IAK1F,YAAY,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAoCzE;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAqBnB;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAWvB;;;;;;;;OAQG;IACH,OAAO,CAAC,gBAAgB;IA2CxB,4EAA4E;IAC5E,OAAO,CAAC,WAAW;IAgBnB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAKxB,gFAAgF;IAChF,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,aAAa;IAIrB;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;CASvB"}

package/dist/adapters/GrokCliAdapter.js

@@ -1,310 +0,0 @@
-import * as path from "path";
-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;
-export class GrokCliAdapter {
-    type = "grok_cli";
-    processNames = [
-        "grok"
-    ];
-    base;
-    sessionsDir;
-    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) {
-        return this.isGrokExecutable(processInfo.command);
-    }
-    isGrokExecutable(command) {
-        const base = executableBasename(command);
-        return base === "grok" || base === "grok.exe";
-    }
-    async detectAgents(context) {
-        const snapshot = context?.processes ?? await captureProcessSnapshot(this.processNames);
-        const relevant = filterByProcessNames(snapshot, this.processNames);
-        const processes = relevant.filter((process1)=>this.canHandle(process1));
-        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 = [];
-        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.
-   */ readActiveSessions() {
-        const map = new Map();
-        const content = safeReadFile(path.join(this.base, 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;
-    }
-    /**
-   * 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.
-   */ listSessionDirs(groupDir) {
-        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.
-   */ latestSessionDir(cwd) {
-        const groupDir = this.getProjectDir(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;
-    }
-    mapSessionToAgent(session, processInfo, sessionDir) {
-        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)
-        };
-    }
-    mapProcessOnlyAgent(processInfo, cwd) {
-        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, options) {
-        return this.parseChatHistory(this.resolveChatPath(sessionFilePath), options?.verbose ?? false).messages;
-    }
-    async listSessions(opts) {
-        if (!isDirectory(this.sessionsDir)) return [];
-        const filterCwd = opts?.cwd;
-        const summaries = [];
-        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.
-   */ readSession(sessionDir, defaultCwd) {
-        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
-   */ determineStatus(session) {
-        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.
-   */ parseChatHistory(chatPath, verbose) {
-        const empty = {
-            messages: []
-        };
-        const content = safeReadFile(chatPath);
-        if (content === undefined) return empty;
-        const messages = [];
-        let lastRole;
-        for (const line of content.trim().split("\n")){
-            if (!line.trim()) continue;
-            let record;
-            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. */ extractText(content) {
-        if (typeof content === "string") return content;
-        if (Array.isArray(content)) {
-            return content.map((block)=>block && typeof block === "object" && typeof block.text === "string" ? block.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).
-   */ 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);
-    }
-    getProjectDir(cwd) {
-        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.
-   */ 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=GrokCliAdapter.js.map