@ai-devkit/agent-manager 0.33.1 → 0.35.0

package/dist/providers/opencode/OpenCodeSessionParser.js

@@ -0,0 +1,104 @@
+const EMPTY_STATS = {
+    lastRole: null,
+    lastTimeUpdated: 0,
+    lastAssistantCompleted: false,
+    lastAssistantErrored: false,
+    summary: ""
+};
+export class OpenCodeSessionParser {
+    getConversation(db, sessionId, options) {
+        const verbose = options?.verbose ?? false;
+        try {
+            const rows = db.prepare(`
+                SELECT json_extract(m.data, '$.role') AS role,
+                       p.data AS partData,
+                       p.time_created AS timeCreated
+                FROM part p
+                JOIN message m ON p.message_id = m.id
+                WHERE p.session_id = ?
+                ORDER BY p.time_created ASC
+            `).all(sessionId);
+            const messages = [];
+            for (const row of rows){
+                const partData = this.parsePartData(row.partData);
+                if (!partData) continue;
+                const role = row.role === "user" ? "user" : "assistant";
+                if (partData.type === "text" && partData.text) {
+                    messages.push({
+                        role,
+                        content: partData.text
+                    });
+                } else if (partData.type === "reasoning" && verbose) {
+                    const text = partData.reasoning || partData.text || "";
+                    if (text) messages.push({
+                        role: "assistant",
+                        content: `[thinking] ${text}`
+                    });
+                } else if (partData.type === "tool" && verbose) {
+                    const toolName = partData.tool || "tool";
+                    messages.push({
+                        role: "assistant",
+                        content: `[tool: ${toolName}]`
+                    });
+                }
+            }
+            return messages;
+        } catch  {
+            return [];
+        }
+    }
+    getSessionStats(db, sessionId) {
+        try {
+            // Order by time_created — time_updated can lag when OpenCode appends
+            // metadata (e.g. summary diffs) to user messages after a turn finishes.
+            const last = db.prepare(`
+                SELECT json_extract(data, '$.role') AS role,
+                       time_updated AS timeUpdated
+                FROM message
+                WHERE session_id = ?
+                ORDER BY time_created DESC
+                LIMIT 1
+            `).get(sessionId);
+            const heartbeat = db.prepare(`
+                SELECT MAX(time_updated) AS maxUpdated FROM message WHERE session_id = ?
+            `).get(sessionId);
+            const lastAssistant = db.prepare(`
+                SELECT json_extract(data, '$.time.completed') AS completed,
+                       json_extract(data, '$.time.error') AS errored
+                FROM message
+                WHERE session_id = ? AND json_extract(data, '$.role') = 'assistant'
+                ORDER BY time_created DESC
+                LIMIT 1
+            `).get(sessionId);
+            const first = db.prepare(`
+                SELECT json_extract(p.data, '$.text') AS text
+                FROM part p
+                JOIN message m ON p.message_id = m.id
+                WHERE p.session_id = ?
+                  AND json_extract(m.data, '$.role') = 'user'
+                  AND json_extract(p.data, '$.type') = 'text'
+                  AND json_extract(p.data, '$.text') IS NOT NULL
+                ORDER BY p.time_created ASC
+                LIMIT 1
+            `).get(sessionId);
+            return {
+                lastRole: last?.role ?? null,
+                lastTimeUpdated: heartbeat?.maxUpdated ?? last?.timeUpdated ?? 0,
+                lastAssistantCompleted: lastAssistant?.completed != null,
+                lastAssistantErrored: lastAssistant?.errored != null,
+                summary: first?.text?.trim() ?? ""
+            };
+        } catch  {
+            return EMPTY_STATS;
+        }
+    }
+    parsePartData(partData) {
+        try {
+            return JSON.parse(partData);
+        } catch  {
+            return null;
+        }
+    }
+}
+
+//# sourceMappingURL=OpenCodeSessionParser.js.map

package/dist/providers/opencode/OpenCodeSessionParser.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/providers/opencode/OpenCodeSessionParser.ts"],"sourcesContent":["import type { ConversationMessage } from \"../../adapters/AgentAdapter.js\";\nimport type Database from \"better-sqlite3\";\n\nexport interface OpenCodeSessionStats {\n  lastRole: string | null;\n  lastTimeUpdated: number;\n  /** OpenCode writes `time.completed` on the assistant message only when the turn finishes. */\n  lastAssistantCompleted: boolean;\n  lastAssistantErrored: boolean;\n  summary: string;\n}\n\ninterface OpenCodePartData {\n  type?: string;\n  text?: string;\n  reasoning?: string;\n  tool?: string;\n}\n\nconst EMPTY_STATS: OpenCodeSessionStats = {\n  lastRole: null,\n  lastTimeUpdated: 0,\n  lastAssistantCompleted: false,\n  lastAssistantErrored: false,\n  summary: \"\",\n};\n\nexport class OpenCodeSessionParser {\n  getConversation(\n    db: Database.Database,\n    sessionId: string,\n    options?: { verbose?: boolean },\n  ): ConversationMessage[] {\n    const verbose = options?.verbose ?? false;\n\n    try {\n      const rows = db\n        .prepare<[string], { role: string; partData: string; timeCreated: number }>(`\n                SELECT json_extract(m.data, '$.role') AS role,\n                       p.data AS partData,\n                       p.time_created AS timeCreated\n                FROM part p\n                JOIN message m ON p.message_id = m.id\n                WHERE p.session_id = ?\n                ORDER BY p.time_created ASC\n            `)\n        .all(sessionId);\n\n      const messages: ConversationMessage[] = [];\n\n      for (const row of rows) {\n        const partData = this.parsePartData(row.partData);\n        if (!partData) continue;\n\n        const role = row.role === \"user\" ? \"user\" : \"assistant\";\n\n        if (partData.type === \"text\" && partData.text) {\n          messages.push({ role, content: partData.text });\n        } else if (partData.type === \"reasoning\" && verbose) {\n          const text = partData.reasoning || partData.text || \"\";\n          if (text) messages.push({ role: \"assistant\", content: `[thinking] ${text}` });\n        } else if (partData.type === \"tool\" && verbose) {\n          const toolName = partData.tool || \"tool\";\n          messages.push({ role: \"assistant\", content: `[tool: ${toolName}]` });\n        }\n      }\n\n      return messages;\n    } catch {\n      return [];\n    }\n  }\n\n  getSessionStats(db: Database.Database, sessionId: string): OpenCodeSessionStats {\n    try {\n      // Order by time_created — time_updated can lag when OpenCode appends\n      // metadata (e.g. summary diffs) to user messages after a turn finishes.\n      const last = db\n        .prepare<[string], { role: string; timeUpdated: number }>(`\n                SELECT json_extract(data, '$.role') AS role,\n                       time_updated AS timeUpdated\n                FROM message\n                WHERE session_id = ?\n                ORDER BY time_created DESC\n                LIMIT 1\n            `)\n        .get(sessionId);\n\n      const heartbeat = db\n        .prepare<[string], { maxUpdated: number }>(`\n                SELECT MAX(time_updated) AS maxUpdated FROM message WHERE session_id = ?\n            `)\n        .get(sessionId);\n\n      const lastAssistant = db\n        .prepare<\n          [string],\n          {\n            completed: number | null;\n            errored: number | null;\n          }\n        >(`\n                SELECT json_extract(data, '$.time.completed') AS completed,\n                       json_extract(data, '$.time.error') AS errored\n                FROM message\n                WHERE session_id = ? AND json_extract(data, '$.role') = 'assistant'\n                ORDER BY time_created DESC\n                LIMIT 1\n            `)\n        .get(sessionId);\n\n      const first = db\n        .prepare<[string], { text: string }>(`\n                SELECT json_extract(p.data, '$.text') AS text\n                FROM part p\n                JOIN message m ON p.message_id = m.id\n                WHERE p.session_id = ?\n                  AND json_extract(m.data, '$.role') = 'user'\n                  AND json_extract(p.data, '$.type') = 'text'\n                  AND json_extract(p.data, '$.text') IS NOT NULL\n                ORDER BY p.time_created ASC\n                LIMIT 1\n            `)\n        .get(sessionId);\n\n      return {\n        lastRole: last?.role ?? null,\n        lastTimeUpdated: heartbeat?.maxUpdated ?? last?.timeUpdated ?? 0,\n        lastAssistantCompleted: lastAssistant?.completed != null,\n        lastAssistantErrored: lastAssistant?.errored != null,\n        summary: first?.text?.trim() ?? \"\",\n      };\n    } catch {\n      return EMPTY_STATS;\n    }\n  }\n\n  private parsePartData(partData: string): OpenCodePartData | null {\n    try {\n      return JSON.parse(partData) as OpenCodePartData;\n    } catch {\n      return null;\n    }\n  }\n}\n"],"names":["EMPTY_STATS","lastRole","lastTimeUpdated","lastAssistantCompleted","lastAssistantErrored","summary","OpenCodeSessionParser","getConversation","db","sessionId","options","verbose","rows","prepare","all","messages","row","partData","parsePartData","role","type","text","push","content","reasoning","toolName","tool","getSessionStats","last","get","heartbeat","lastAssistant","first","maxUpdated","timeUpdated","completed","errored","trim","JSON","parse"],"mappings":"AAmBA,MAAMA,cAAoC;IACxCC,UAAU;IACVC,iBAAiB;IACjBC,wBAAwB;IACxBC,sBAAsB;IACtBC,SAAS;AACX;AAEA,OAAO,MAAMC;IACXC,gBACEC,EAAqB,EACrBC,SAAiB,EACjBC,OAA+B,EACR;QACvB,MAAMC,UAAUD,SAASC,WAAW;QAEpC,IAAI;YACF,MAAMC,OAAOJ,GACVK,OAAO,CAAoE,CAAC;;;;;;;;YAQzE,CAAC,EACJC,GAAG,CAACL;YAEP,MAAMM,WAAkC,EAAE;YAE1C,KAAK,MAAMC,OAAOJ,KAAM;gBACtB,MAAMK,WAAW,IAAI,CAACC,aAAa,CAACF,IAAIC,QAAQ;gBAChD,IAAI,CAACA,UAAU;gBAEf,MAAME,OAAOH,IAAIG,IAAI,KAAK,SAAS,SAAS;gBAE5C,IAAIF,SAASG,IAAI,KAAK,UAAUH,SAASI,IAAI,EAAE;oBAC7CN,SAASO,IAAI,CAAC;wBAAEH;wBAAMI,SAASN,SAASI,IAAI;oBAAC;gBAC/C,OAAO,IAAIJ,SAASG,IAAI,KAAK,eAAeT,SAAS;oBACnD,MAAMU,OAAOJ,SAASO,SAAS,IAAIP,SAASI,IAAI,IAAI;oBACpD,IAAIA,MAAMN,SAASO,IAAI,CAAC;wBAAEH,MAAM;wBAAaI,SAAS,CAAC,WAAW,EAAEF,MAAM;oBAAC;gBAC7E,OAAO,IAAIJ,SAASG,IAAI,KAAK,UAAUT,SAAS;oBAC9C,MAAMc,WAAWR,SAASS,IAAI,IAAI;oBAClCX,SAASO,IAAI,CAAC;wBAAEH,MAAM;wBAAaI,SAAS,CAAC,OAAO,EAAEE,SAAS,CAAC,CAAC;oBAAC;gBACpE;YACF;YAEA,OAAOV;QACT,EAAE,OAAM;YACN,OAAO,EAAE;QACX;IACF;IAEAY,gBAAgBnB,EAAqB,EAAEC,SAAiB,EAAwB;QAC9E,IAAI;YACF,qEAAqE;YACrE,wEAAwE;YACxE,MAAMmB,OAAOpB,GACVK,OAAO,CAAkD,CAAC;;;;;;;YAOvD,CAAC,EACJgB,GAAG,CAACpB;YAEP,MAAMqB,YAAYtB,GACfK,OAAO,CAAmC,CAAC;;YAExC,CAAC,EACJgB,GAAG,CAACpB;YAEP,MAAMsB,gBAAgBvB,GACnBK,OAAO,CAMN,CAAC;;;;;;;YAOC,CAAC,EACJgB,GAAG,CAACpB;YAEP,MAAMuB,QAAQxB,GACXK,OAAO,CAA6B,CAAC;;;;;;;;;;YAUlC,CAAC,EACJgB,GAAG,CAACpB;YAEP,OAAO;gBACLR,UAAU2B,MAAMT,QAAQ;gBACxBjB,iBAAiB4B,WAAWG,cAAcL,MAAMM,eAAe;gBAC/D/B,wBAAwB4B,eAAeI,aAAa;gBACpD/B,sBAAsB2B,eAAeK,WAAW;gBAChD/B,SAAS2B,OAAOX,MAAMgB,UAAU;YAClC;QACF,EAAE,OAAM;YACN,OAAOrC;QACT;IACF;IAEQkB,cAAcD,QAAgB,EAA2B;QAC/D,IAAI;YACF,OAAOqB,KAAKC,KAAK,CAACtB;QACpB,EAAE,OAAM;YACN,OAAO;QACT;IACF;AACF"}

package/dist/providers/pi/PiAdapter.d.ts

@@ -15,6 +15,7 @@ export declare class PiAdapter implements AgentAdapter {
         verbose?: boolean;
     }): ConversationMessage[];
     listSessions(opts?: ListSessionsOptions): Promise<SessionSummary[]>;
+    findSessionsById(sessionId: string): Promise<SessionSummary[]>;
     private getPiProcesses;
     private createLocator;
     private createTracker;

package/dist/providers/pi/PiAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PiAdapter.d.ts","sourceRoot":"","sources":["../../../src/providers/pi/PiAdapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,gCAAgC,CAAC;AAMxC,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAgB7D,qBAAa,SAAU,YAAW,YAAY;IAC5C,QAAQ,CAAC,IAAI,EAAG,IAAI,CAAU;IAC9B,QAAQ,CAAC,YAAY,0BAA2B;IAEhD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;gBAE3B,QAAQ,GAAE,aAAuC;IAU7D,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO;IAItC,YAAY,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAqBzE,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,mBAAmB,EAAE;IAI1F,YAAY,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;YAa3D,cAAc;IAW5B,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,gBAAgB;IAwBxB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,qBAAqB;IAgB7B,OAAO,CAAC,sBAAsB;IAK9B,OAAO,CAAC,cAAc;CAOvB"}
+{"version":3,"file":"PiAdapter.d.ts","sourceRoot":"","sources":["../../../src/providers/pi/PiAdapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,gCAAgC,CAAC;AAMxC,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAgB7D,qBAAa,SAAU,YAAW,YAAY;IAC5C,QAAQ,CAAC,IAAI,EAAG,IAAI,CAAU;IAC9B,QAAQ,CAAC,YAAY,0BAA2B;IAEhD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;gBAE3B,QAAQ,GAAE,aAAuC;IAU7D,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO;IAItC,YAAY,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAqBzE,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,mBAAmB,EAAE;IAI1F,YAAY,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAanE,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;YAYtD,cAAc;IAW5B,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,gBAAgB;IAwBxB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,qBAAqB;IAgB7B,OAAO,CAAC,sBAAsB;IAK9B,OAAO,CAAC,cAAc;CAOvB"}

package/dist/providers/pi/PiAdapter.js

@@ -57,6 +57,16 @@ export class PiAdapter {
         }
         return summaries;
     }
+    async findSessionsById(sessionId) {
+        const summaries = [];
+        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);
+    }
     async getPiProcesses(context) {
         const snapshot = context?.processes ?? await captureProcessSnapshot(this.processNames);
         const relevant = filterByProcessNames(snapshot, this.processNames);

package/dist/providers/pi/PiAdapter.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/providers/pi/PiAdapter.ts"],"sourcesContent":["import * as fs from \"fs\";\nimport * as path from \"path\";\nimport type {\n  AgentAdapter,\n  AgentInfo,\n  ProcessInfo,\n  ConversationMessage,\n  SessionSummary,\n  ListSessionsOptions,\n  AgentDetectionContext,\n} from \"../../adapters/AgentAdapter.js\";\nimport {\n  captureProcessSnapshot,\n  executableBasename,\n  filterByProcessNames,\n} from \"../../utils/process.js\";\nimport { AgentRegistry } from \"../../utils/AgentRegistry.js\";\nimport { PiAgentMapper } from \"./PiAgentMapper.js\";\nimport { PiSessionLocator } from \"./PiSessionLocator.js\";\nimport { PiSessionParser } from \"./PiSessionParser.js\";\nimport { PiSessionTracker } from \"./PiSessionTracker.js\";\n\ninterface MappedAgentResult {\n  agents: AgentInfo[];\n  fallback: ProcessInfo[];\n}\n\ninterface SessionFileMatch {\n  process: ProcessInfo;\n  filePath: string;\n}\n\nexport class PiAdapter implements AgentAdapter {\n  readonly type = \"pi\" as const;\n  readonly processNames = [\"pi\", \"node\"] as const;\n\n  private readonly piSessionsDir: string;\n  private readonly trackerPath: string;\n  private readonly registry: AgentRegistry;\n  private readonly parser: PiSessionParser;\n  private readonly mapper: PiAgentMapper;\n\n  constructor(registry: AgentRegistry = AgentRegistry.default()) {\n    const homeDir = process.env.HOME || process.env.USERPROFILE || \"\";\n    const piAgentDir = path.join(homeDir, \".pi\", \"agent\");\n    this.piSessionsDir = path.join(piAgentDir, \"sessions\");\n    this.trackerPath = path.join(piAgentDir, \"sessions.json\");\n    this.registry = registry;\n    this.parser = new PiSessionParser();\n    this.mapper = new PiAgentMapper(this.parser);\n  }\n\n  canHandle(processInfo: ProcessInfo): boolean {\n    return this.isPiExecutable(processInfo.command);\n  }\n\n  async detectAgents(context?: AgentDetectionContext): Promise<AgentInfo[]> {\n    const processes = await this.getPiProcesses(context);\n    if (processes.length === 0) return [];\n\n    const cacheResult = this.mapRegistryCache(processes);\n    const trackerResult = this.mapTrackerMatches(cacheResult.fallback);\n    const locatorResult = this.createLocator().matchRunningProcesses(trackerResult.fallback);\n    const legacyResult = this.mapLegacyMatches(locatorResult.legacyMatches);\n    const unmatchedProcesses = this.findUnmatchedProcesses(\n      locatorResult.fallback,\n      legacyResult.agents,\n    );\n\n    return [\n      ...cacheResult.agents,\n      ...trackerResult.agents,\n      ...legacyResult.agents,\n      ...unmatchedProcesses.map((processInfo) => this.mapper.mapProcessOnlyAgent(processInfo)),\n    ];\n  }\n\n  getConversation(sessionFilePath: string, options?: { verbose?: boolean }): ConversationMessage[] {\n    return this.parser.getConversation(sessionFilePath, options);\n  }\n\n  async listSessions(opts?: ListSessionsOptions): Promise<SessionSummary[]> {\n    const summaries: SessionSummary[] = [];\n\n    for (const filePath of this.createLocator().discoverHistoricalSessionFiles()) {\n      const summary = this.parser.fileToSessionSummary(filePath);\n      if (!summary) continue;\n      if (opts?.cwd !== undefined && summary.cwd !== opts.cwd) continue;\n      summaries.push(summary);\n    }\n\n    return summaries;\n  }\n\n  private async getPiProcesses(context?: AgentDetectionContext): Promise<ProcessInfo[]> {\n    const snapshot = context?.processes ?? (await captureProcessSnapshot(this.processNames));\n    const relevant = filterByProcessNames(snapshot, this.processNames);\n\n    const byPid = new Map<number, ProcessInfo>();\n    for (const processInfo of relevant) {\n      if (this.canHandle(processInfo)) byPid.set(processInfo.pid, processInfo);\n    }\n    return Array.from(byPid.values());\n  }\n\n  private createLocator(): PiSessionLocator {\n    return new PiSessionLocator({ sessionsDir: this.piSessionsDir }, this.parser);\n  }\n\n  private createTracker(): PiSessionTracker {\n    return new PiSessionTracker({\n      sessionsDir: this.piSessionsDir,\n      trackerPath: this.trackerPath,\n    });\n  }\n\n  private mapRegistryCache(processes: ProcessInfo[]): MappedAgentResult {\n    const matches: SessionFileMatch[] = [];\n    const fallback: ProcessInfo[] = [];\n    const byPid = new Map(this.registry.list().map((entry) => [entry.pid, entry]));\n\n    for (const processInfo of processes) {\n      const entry = byPid.get(processInfo.pid);\n      if (\n        !entry ||\n        entry.type !== this.type ||\n        !entry.sessionFilePath ||\n        !fs.existsSync(entry.sessionFilePath)\n      ) {\n        fallback.push(processInfo);\n        continue;\n      }\n\n      matches.push({ process: processInfo, filePath: entry.sessionFilePath });\n    }\n\n    const mapped = this.mapSessionFileMatches(matches);\n    return { agents: mapped.agents, fallback: [...fallback, ...mapped.fallback] };\n  }\n\n  private mapTrackerMatches(processes: ProcessInfo[]): MappedAgentResult {\n    const { matches, fallback } = this.createTracker().match(processes);\n    const mapped = this.mapSessionFileMatches(matches);\n    return { agents: mapped.agents, fallback: [...fallback, ...mapped.fallback] };\n  }\n\n  private mapLegacyMatches(\n    matches: Array<{ process: ProcessInfo; session: { filePath: string } }>,\n  ): MappedAgentResult {\n    return this.mapSessionFileMatches(\n      matches.map((match) => ({ process: match.process, filePath: match.session.filePath })),\n    );\n  }\n\n  private mapSessionFileMatches(matches: SessionFileMatch[]): MappedAgentResult {\n    const agents: AgentInfo[] = [];\n    const fallback: ProcessInfo[] = [];\n\n    for (const match of matches) {\n      const session = this.parser.readSession(match.filePath, match.process.cwd);\n      if (session) {\n        agents.push(this.mapper.mapSessionToAgent(session, match.process, match.filePath));\n      } else {\n        fallback.push(match.process);\n      }\n    }\n\n    return { agents, fallback };\n  }\n\n  private findUnmatchedProcesses(processes: ProcessInfo[], agents: AgentInfo[]): ProcessInfo[] {\n    const matchedPids = new Set(agents.map((agent) => agent.pid));\n    return processes.filter((processInfo) => !matchedPids.has(processInfo.pid));\n  }\n\n  private isPiExecutable(command: string): boolean {\n    for (const token of command.trim().split(/\\s+/)) {\n      const base = executableBasename(token);\n      if (base === \"pi\" || base === \"pi.exe\" || base === \"pi.js\") return true;\n    }\n    return false;\n  }\n}\n"],"names":["fs","path","captureProcessSnapshot","executableBasename","filterByProcessNames","AgentRegistry","PiAgentMapper","PiSessionLocator","PiSessionParser","PiSessionTracker","PiAdapter","type","processNames","piSessionsDir","trackerPath","registry","parser","mapper","default","homeDir","process","env","HOME","USERPROFILE","piAgentDir","join","canHandle","processInfo","isPiExecutable","command","detectAgents","context","processes","getPiProcesses","length","cacheResult","mapRegistryCache","trackerResult","mapTrackerMatches","fallback","locatorResult","createLocator","matchRunningProcesses","legacyResult","mapLegacyMatches","legacyMatches","unmatchedProcesses","findUnmatchedProcesses","agents","map","mapProcessOnlyAgent","getConversation","sessionFilePath","options","listSessions","opts","summaries","filePath","discoverHistoricalSessionFiles","summary","fileToSessionSummary","cwd","undefined","push","snapshot","relevant","byPid","Map","set","pid","Array","from","values","sessionsDir","createTracker","matches","list","entry","get","existsSync","mapped","mapSessionFileMatches","match","session","readSession","mapSessionToAgent","matchedPids","Set","agent","filter","has","token","trim","split","base"],"mappings":"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"}
+{"version":3,"sources":["../../../src/providers/pi/PiAdapter.ts"],"sourcesContent":["import * as fs from \"fs\";\nimport * as path from \"path\";\nimport type {\n  AgentAdapter,\n  AgentInfo,\n  ProcessInfo,\n  ConversationMessage,\n  SessionSummary,\n  ListSessionsOptions,\n  AgentDetectionContext,\n} from \"../../adapters/AgentAdapter.js\";\nimport {\n  captureProcessSnapshot,\n  executableBasename,\n  filterByProcessNames,\n} from \"../../utils/process.js\";\nimport { AgentRegistry } from \"../../utils/AgentRegistry.js\";\nimport { PiAgentMapper } from \"./PiAgentMapper.js\";\nimport { PiSessionLocator } from \"./PiSessionLocator.js\";\nimport { PiSessionParser } from \"./PiSessionParser.js\";\nimport { PiSessionTracker } from \"./PiSessionTracker.js\";\n\ninterface MappedAgentResult {\n  agents: AgentInfo[];\n  fallback: ProcessInfo[];\n}\n\ninterface SessionFileMatch {\n  process: ProcessInfo;\n  filePath: string;\n}\n\nexport class PiAdapter implements AgentAdapter {\n  readonly type = \"pi\" as const;\n  readonly processNames = [\"pi\", \"node\"] as const;\n\n  private readonly piSessionsDir: string;\n  private readonly trackerPath: string;\n  private readonly registry: AgentRegistry;\n  private readonly parser: PiSessionParser;\n  private readonly mapper: PiAgentMapper;\n\n  constructor(registry: AgentRegistry = AgentRegistry.default()) {\n    const homeDir = process.env.HOME || process.env.USERPROFILE || \"\";\n    const piAgentDir = path.join(homeDir, \".pi\", \"agent\");\n    this.piSessionsDir = path.join(piAgentDir, \"sessions\");\n    this.trackerPath = path.join(piAgentDir, \"sessions.json\");\n    this.registry = registry;\n    this.parser = new PiSessionParser();\n    this.mapper = new PiAgentMapper(this.parser);\n  }\n\n  canHandle(processInfo: ProcessInfo): boolean {\n    return this.isPiExecutable(processInfo.command);\n  }\n\n  async detectAgents(context?: AgentDetectionContext): Promise<AgentInfo[]> {\n    const processes = await this.getPiProcesses(context);\n    if (processes.length === 0) return [];\n\n    const cacheResult = this.mapRegistryCache(processes);\n    const trackerResult = this.mapTrackerMatches(cacheResult.fallback);\n    const locatorResult = this.createLocator().matchRunningProcesses(trackerResult.fallback);\n    const legacyResult = this.mapLegacyMatches(locatorResult.legacyMatches);\n    const unmatchedProcesses = this.findUnmatchedProcesses(\n      locatorResult.fallback,\n      legacyResult.agents,\n    );\n\n    return [\n      ...cacheResult.agents,\n      ...trackerResult.agents,\n      ...legacyResult.agents,\n      ...unmatchedProcesses.map((processInfo) => this.mapper.mapProcessOnlyAgent(processInfo)),\n    ];\n  }\n\n  getConversation(sessionFilePath: string, options?: { verbose?: boolean }): ConversationMessage[] {\n    return this.parser.getConversation(sessionFilePath, options);\n  }\n\n  async listSessions(opts?: ListSessionsOptions): Promise<SessionSummary[]> {\n    const summaries: SessionSummary[] = [];\n\n    for (const filePath of this.createLocator().discoverHistoricalSessionFiles()) {\n      const summary = this.parser.fileToSessionSummary(filePath);\n      if (!summary) continue;\n      if (opts?.cwd !== undefined && summary.cwd !== opts.cwd) continue;\n      summaries.push(summary);\n    }\n\n    return summaries;\n  }\n\n  async findSessionsById(sessionId: string): Promise<SessionSummary[]> {\n    const summaries: SessionSummary[] = [];\n    const filePaths = this.createLocator().findHistoricalSessionFilesById(sessionId);\n    for (const filePath of filePaths) {\n      const summary = this.parser.fileToSessionSummary(filePath);\n      if (summary?.sessionId === sessionId) summaries.push(summary);\n    }\n\n    if (summaries.length > 0) return summaries;\n    return (await this.listSessions()).filter((summary) => summary.sessionId === sessionId);\n  }\n\n  private async getPiProcesses(context?: AgentDetectionContext): Promise<ProcessInfo[]> {\n    const snapshot = context?.processes ?? (await captureProcessSnapshot(this.processNames));\n    const relevant = filterByProcessNames(snapshot, this.processNames);\n\n    const byPid = new Map<number, ProcessInfo>();\n    for (const processInfo of relevant) {\n      if (this.canHandle(processInfo)) byPid.set(processInfo.pid, processInfo);\n    }\n    return Array.from(byPid.values());\n  }\n\n  private createLocator(): PiSessionLocator {\n    return new PiSessionLocator({ sessionsDir: this.piSessionsDir }, this.parser);\n  }\n\n  private createTracker(): PiSessionTracker {\n    return new PiSessionTracker({\n      sessionsDir: this.piSessionsDir,\n      trackerPath: this.trackerPath,\n    });\n  }\n\n  private mapRegistryCache(processes: ProcessInfo[]): MappedAgentResult {\n    const matches: SessionFileMatch[] = [];\n    const fallback: ProcessInfo[] = [];\n    const byPid = new Map(this.registry.list().map((entry) => [entry.pid, entry]));\n\n    for (const processInfo of processes) {\n      const entry = byPid.get(processInfo.pid);\n      if (\n        !entry ||\n        entry.type !== this.type ||\n        !entry.sessionFilePath ||\n        !fs.existsSync(entry.sessionFilePath)\n      ) {\n        fallback.push(processInfo);\n        continue;\n      }\n\n      matches.push({ process: processInfo, filePath: entry.sessionFilePath });\n    }\n\n    const mapped = this.mapSessionFileMatches(matches);\n    return { agents: mapped.agents, fallback: [...fallback, ...mapped.fallback] };\n  }\n\n  private mapTrackerMatches(processes: ProcessInfo[]): MappedAgentResult {\n    const { matches, fallback } = this.createTracker().match(processes);\n    const mapped = this.mapSessionFileMatches(matches);\n    return { agents: mapped.agents, fallback: [...fallback, ...mapped.fallback] };\n  }\n\n  private mapLegacyMatches(\n    matches: Array<{ process: ProcessInfo; session: { filePath: string } }>,\n  ): MappedAgentResult {\n    return this.mapSessionFileMatches(\n      matches.map((match) => ({ process: match.process, filePath: match.session.filePath })),\n    );\n  }\n\n  private mapSessionFileMatches(matches: SessionFileMatch[]): MappedAgentResult {\n    const agents: AgentInfo[] = [];\n    const fallback: ProcessInfo[] = [];\n\n    for (const match of matches) {\n      const session = this.parser.readSession(match.filePath, match.process.cwd);\n      if (session) {\n        agents.push(this.mapper.mapSessionToAgent(session, match.process, match.filePath));\n      } else {\n        fallback.push(match.process);\n      }\n    }\n\n    return { agents, fallback };\n  }\n\n  private findUnmatchedProcesses(processes: ProcessInfo[], agents: AgentInfo[]): ProcessInfo[] {\n    const matchedPids = new Set(agents.map((agent) => agent.pid));\n    return processes.filter((processInfo) => !matchedPids.has(processInfo.pid));\n  }\n\n  private isPiExecutable(command: string): boolean {\n    for (const token of command.trim().split(/\\s+/)) {\n      const base = executableBasename(token);\n      if (base === \"pi\" || base === \"pi.exe\" || base === \"pi.js\") return true;\n    }\n    return false;\n  }\n}\n"],"names":["fs","path","captureProcessSnapshot","executableBasename","filterByProcessNames","AgentRegistry","PiAgentMapper","PiSessionLocator","PiSessionParser","PiSessionTracker","PiAdapter","type","processNames","piSessionsDir","trackerPath","registry","parser","mapper","default","homeDir","process","env","HOME","USERPROFILE","piAgentDir","join","canHandle","processInfo","isPiExecutable","command","detectAgents","context","processes","getPiProcesses","length","cacheResult","mapRegistryCache","trackerResult","mapTrackerMatches","fallback","locatorResult","createLocator","matchRunningProcesses","legacyResult","mapLegacyMatches","legacyMatches","unmatchedProcesses","findUnmatchedProcesses","agents","map","mapProcessOnlyAgent","getConversation","sessionFilePath","options","listSessions","opts","summaries","filePath","discoverHistoricalSessionFiles","summary","fileToSessionSummary","cwd","undefined","push","findSessionsById","sessionId","filePaths","findHistoricalSessionFilesById","filter","snapshot","relevant","byPid","Map","set","pid","Array","from","values","sessionsDir","createTracker","matches","list","entry","get","existsSync","mapped","mapSessionFileMatches","match","session","readSession","mapSessionToAgent","matchedPids","Set","agent","has","token","trim","split","base"],"mappings":"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"}

package/dist/providers/pi/PiSessionLocator.d.ts

@@ -16,6 +16,7 @@ export declare class PiSessionLocator {
     matchRunningProcesses(processes: ProcessInfo[]): PiProcessSessionMatches;
     discoverLiveSessions(processes?: ProcessInfo[]): SessionFile[];
     discoverHistoricalSessionFiles(): string[];
+    findHistoricalSessionFilesById(sessionId: string): string[];
     private buildProjectDirCwdMap;
     private collectJsonlFiles;
     private encodeProjectDir;

package/dist/providers/pi/PiSessionLocator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PiSessionLocator.d.ts","sourceRoot":"","sources":["../../../src/providers/pi/PiSessionLocator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAA4B,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,EAAsC,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC9F,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,WAAW,uBAAuB;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,qBAAa,gBAAgB;IAKzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAGnC,OAAO,GAAE,uBAA4B,EACpB,MAAM,GAAE,eAAuC;IAMlE,qBAAqB,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,uBAAuB;IAYxE,oBAAoB,CAAC,SAAS,GAAE,WAAW,EAAO,GAAG,WAAW,EAAE;IAwBlE,8BAA8B,IAAI,MAAM,EAAE;IAI1C,OAAO,CAAC,qBAAqB;IAS7B,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,gBAAgB;CAIzB"}
+{"version":3,"file":"PiSessionLocator.d.ts","sourceRoot":"","sources":["../../../src/providers/pi/PiSessionLocator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAA4B,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,EAKL,KAAK,WAAW,EACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,WAAW,uBAAuB;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,qBAAa,gBAAgB;IAKzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAGnC,OAAO,GAAE,uBAA4B,EACpB,MAAM,GAAE,eAAuC;IAMlE,qBAAqB,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,uBAAuB;IAYxE,oBAAoB,CAAC,SAAS,GAAE,WAAW,EAAO,GAAG,WAAW,EAAE;IAwBlE,8BAA8B,IAAI,MAAM,EAAE;IAI1C,8BAA8B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE;IAS3D,OAAO,CAAC,qBAAqB;IAS7B,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,gBAAgB;CAIzB"}

package/dist/providers/pi/PiSessionLocator.js

@@ -1,6 +1,6 @@
 import * as path from "path";
 import { matchProcessesToSessions } from "../../utils/matching.js";
-import { isDirectory, safeReaddir, safeStat } from "../../utils/session.js";
+import { isDirectory, isSafePathSegment, safeReaddir, safeStat } from "../../utils/session.js";
 import { PiSessionParser } from "./PiSessionParser.js";
 export class PiSessionLocator {
     parser;
@@ -48,6 +48,13 @@ export class PiSessionLocator {
     discoverHistoricalSessionFiles() {
         return this.collectJsonlFiles(this.sessionsDir);
     }
+    findHistoricalSessionFilesById(sessionId) {
+        if (!isSafePathSegment(sessionId)) return [];
+        return this.collectJsonlFiles(this.sessionsDir).filter((filePath)=>{
+            const basename = path.basename(filePath, ".jsonl");
+            return basename === sessionId || basename.endsWith(`_${sessionId}`);
+        });
+    }
     buildProjectDirCwdMap(processes) {
         const map = new Map();
         for (const proc of processes){

package/dist/providers/pi/PiSessionLocator.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/providers/pi/PiSessionLocator.ts"],"sourcesContent":["import * as path from \"path\";\nimport type { ProcessInfo } from \"../../adapters/AgentAdapter.js\";\nimport { matchProcessesToSessions, type MatchResult } from \"../../utils/matching.js\";\nimport { isDirectory, safeReaddir, safeStat, type SessionFile } from \"../../utils/session.js\";\nimport { PiSessionParser } from \"./PiSessionParser.js\";\n\nexport interface PiSessionLocatorOptions {\n  sessionsDir?: string;\n}\n\nexport interface PiProcessSessionMatches {\n  legacyMatches: MatchResult[];\n  fallback: ProcessInfo[];\n}\n\nexport class PiSessionLocator {\n  private readonly sessionsDir: string;\n\n  constructor(\n    options: PiSessionLocatorOptions = {},\n    private readonly parser: PiSessionParser = new PiSessionParser(),\n  ) {\n    const homeDir = process.env.HOME || process.env.USERPROFILE || \"\";\n    this.sessionsDir = options.sessionsDir ?? path.join(homeDir, \".pi\", \"agent\", \"sessions\");\n  }\n\n  matchRunningProcesses(processes: ProcessInfo[]): PiProcessSessionMatches {\n    if (processes.length === 0) return { legacyMatches: [], fallback: [] };\n\n    const sessions = this.discoverLiveSessions(processes);\n    if (sessions.length === 0) return { legacyMatches: [], fallback: processes };\n\n    return {\n      legacyMatches: matchProcessesToSessions(processes, sessions),\n      fallback: processes,\n    };\n  }\n\n  discoverLiveSessions(processes: ProcessInfo[] = []): SessionFile[] {\n    if (!isDirectory(this.sessionsDir)) return [];\n\n    const cwdByProjectDir = this.buildProjectDirCwdMap(processes);\n    const sessions: SessionFile[] = [];\n    for (const filePath of this.discoverHistoricalSessionFiles()) {\n      const stat = safeStat(filePath);\n      if (!stat) continue;\n\n      const session = this.parser.readSession(filePath);\n      const sessionId = session?.sessionId || this.parser.sessionIdFromFile(filePath);\n      const projectDir = path.dirname(filePath);\n      sessions.push({\n        sessionId,\n        filePath,\n        projectDir,\n        birthtimeMs: stat.birthtimeMs || stat.mtimeMs,\n        resolvedCwd: session?.projectPath || cwdByProjectDir.get(path.basename(projectDir)) || \"\",\n      });\n    }\n\n    return sessions;\n  }\n\n  discoverHistoricalSessionFiles(): string[] {\n    return this.collectJsonlFiles(this.sessionsDir);\n  }\n\n  private buildProjectDirCwdMap(processes: ProcessInfo[]): Map<string, string> {\n    const map = new Map<string, string>();\n    for (const proc of processes) {\n      if (!proc.cwd) continue;\n      map.set(this.encodeProjectDir(proc.cwd), proc.cwd);\n    }\n    return map;\n  }\n\n  private collectJsonlFiles(dir: string): string[] {\n    const files: string[] = [];\n    for (const entry of safeReaddir(dir)) {\n      const fullPath = path.join(dir, entry);\n      const stat = safeStat(fullPath);\n      if (!stat) continue;\n      if (stat.isDirectory()) {\n        files.push(...this.collectJsonlFiles(fullPath));\n      } else if (stat.isFile() && entry.endsWith(\".jsonl\")) {\n        files.push(fullPath);\n      }\n    }\n    return files;\n  }\n\n  private encodeProjectDir(cwd: string): string {\n    const normalized = path.resolve(cwd);\n    return `--${normalized.replace(/^\\//, \"\").replace(/\\//g, \"-\")}--`;\n  }\n}\n"],"names":["path","matchProcessesToSessions","isDirectory","safeReaddir","safeStat","PiSessionParser","PiSessionLocator","sessionsDir","options","parser","homeDir","process","env","HOME","USERPROFILE","join","matchRunningProcesses","processes","length","legacyMatches","fallback","sessions","discoverLiveSessions","cwdByProjectDir","buildProjectDirCwdMap","filePath","discoverHistoricalSessionFiles","stat","session","readSession","sessionId","sessionIdFromFile","projectDir","dirname","push","birthtimeMs","mtimeMs","resolvedCwd","projectPath","get","basename","collectJsonlFiles","map","Map","proc","cwd","set","encodeProjectDir","dir","files","entry","fullPath","isFile","endsWith","normalized","resolve","replace"],"mappings":"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"}
+{"version":3,"sources":["../../../src/providers/pi/PiSessionLocator.ts"],"sourcesContent":["import * as path from \"path\";\nimport type { ProcessInfo } from \"../../adapters/AgentAdapter.js\";\nimport { matchProcessesToSessions, type MatchResult } from \"../../utils/matching.js\";\nimport {\n  isDirectory,\n  isSafePathSegment,\n  safeReaddir,\n  safeStat,\n  type SessionFile,\n} from \"../../utils/session.js\";\nimport { PiSessionParser } from \"./PiSessionParser.js\";\n\nexport interface PiSessionLocatorOptions {\n  sessionsDir?: string;\n}\n\nexport interface PiProcessSessionMatches {\n  legacyMatches: MatchResult[];\n  fallback: ProcessInfo[];\n}\n\nexport class PiSessionLocator {\n  private readonly sessionsDir: string;\n\n  constructor(\n    options: PiSessionLocatorOptions = {},\n    private readonly parser: PiSessionParser = new PiSessionParser(),\n  ) {\n    const homeDir = process.env.HOME || process.env.USERPROFILE || \"\";\n    this.sessionsDir = options.sessionsDir ?? path.join(homeDir, \".pi\", \"agent\", \"sessions\");\n  }\n\n  matchRunningProcesses(processes: ProcessInfo[]): PiProcessSessionMatches {\n    if (processes.length === 0) return { legacyMatches: [], fallback: [] };\n\n    const sessions = this.discoverLiveSessions(processes);\n    if (sessions.length === 0) return { legacyMatches: [], fallback: processes };\n\n    return {\n      legacyMatches: matchProcessesToSessions(processes, sessions),\n      fallback: processes,\n    };\n  }\n\n  discoverLiveSessions(processes: ProcessInfo[] = []): SessionFile[] {\n    if (!isDirectory(this.sessionsDir)) return [];\n\n    const cwdByProjectDir = this.buildProjectDirCwdMap(processes);\n    const sessions: SessionFile[] = [];\n    for (const filePath of this.discoverHistoricalSessionFiles()) {\n      const stat = safeStat(filePath);\n      if (!stat) continue;\n\n      const session = this.parser.readSession(filePath);\n      const sessionId = session?.sessionId || this.parser.sessionIdFromFile(filePath);\n      const projectDir = path.dirname(filePath);\n      sessions.push({\n        sessionId,\n        filePath,\n        projectDir,\n        birthtimeMs: stat.birthtimeMs || stat.mtimeMs,\n        resolvedCwd: session?.projectPath || cwdByProjectDir.get(path.basename(projectDir)) || \"\",\n      });\n    }\n\n    return sessions;\n  }\n\n  discoverHistoricalSessionFiles(): string[] {\n    return this.collectJsonlFiles(this.sessionsDir);\n  }\n\n  findHistoricalSessionFilesById(sessionId: string): string[] {\n    if (!isSafePathSegment(sessionId)) return [];\n\n    return this.collectJsonlFiles(this.sessionsDir).filter((filePath) => {\n      const basename = path.basename(filePath, \".jsonl\");\n      return basename === sessionId || basename.endsWith(`_${sessionId}`);\n    });\n  }\n\n  private buildProjectDirCwdMap(processes: ProcessInfo[]): Map<string, string> {\n    const map = new Map<string, string>();\n    for (const proc of processes) {\n      if (!proc.cwd) continue;\n      map.set(this.encodeProjectDir(proc.cwd), proc.cwd);\n    }\n    return map;\n  }\n\n  private collectJsonlFiles(dir: string): string[] {\n    const files: string[] = [];\n    for (const entry of safeReaddir(dir)) {\n      const fullPath = path.join(dir, entry);\n      const stat = safeStat(fullPath);\n      if (!stat) continue;\n      if (stat.isDirectory()) {\n        files.push(...this.collectJsonlFiles(fullPath));\n      } else if (stat.isFile() && entry.endsWith(\".jsonl\")) {\n        files.push(fullPath);\n      }\n    }\n    return files;\n  }\n\n  private encodeProjectDir(cwd: string): string {\n    const normalized = path.resolve(cwd);\n    return `--${normalized.replace(/^\\//, \"\").replace(/\\//g, \"-\")}--`;\n  }\n}\n"],"names":["path","matchProcessesToSessions","isDirectory","isSafePathSegment","safeReaddir","safeStat","PiSessionParser","PiSessionLocator","sessionsDir","options","parser","homeDir","process","env","HOME","USERPROFILE","join","matchRunningProcesses","processes","length","legacyMatches","fallback","sessions","discoverLiveSessions","cwdByProjectDir","buildProjectDirCwdMap","filePath","discoverHistoricalSessionFiles","stat","session","readSession","sessionId","sessionIdFromFile","projectDir","dirname","push","birthtimeMs","mtimeMs","resolvedCwd","projectPath","get","basename","collectJsonlFiles","findHistoricalSessionFilesById","filter","endsWith","map","Map","proc","cwd","set","encodeProjectDir","dir","files","entry","fullPath","isFile","normalized","resolve","replace"],"mappings":"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"}

package/dist/utils/session.d.ts

@@ -25,6 +25,8 @@ export interface SessionFile {
  * Returns false on any error (missing path, permission denied, broken symlink, etc.).
  */
 export declare function isDirectory(p: string): boolean;
+/** Return whether a value can be safely appended as one filesystem path segment. */
+export declare function isSafePathSegment(value: string): boolean;
 /**
  * `fs.statSync` that swallows errors and returns `undefined` on failure.
  * Callers can pull whichever fields they need (mtime, birthtime, ...).

package/dist/utils/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/utils/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAGzB;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAElB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IAEjB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IAEnB,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IAEpB,kGAAkG;IAClG,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,EAAE,CAAC,KAAK,GAAG,SAAS,CAM/D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMjE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAMjD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAE/C;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAwC3E"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/utils/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAGzB;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAElB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IAEjB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IAEnB,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IAEpB,kGAAkG;IAClG,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAQxD;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,EAAE,CAAC,KAAK,GAAG,SAAS,CAM/D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMjE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAMjD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAE/C;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAwC3E"}

package/dist/utils/session.js

@@ -11,6 +11,9 @@ import * as path from "path";
  */ export function isDirectory(p) {
     return safeStat(p)?.isDirectory() ?? false;
 }
+/** Return whether a value can be safely appended as one filesystem path segment. */ export function isSafePathSegment(value) {
+    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/utils/session.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/session.ts"],"sourcesContent":["/**\n * Session File Utilities\n *\n * Utilities for discovering session files and their birth times.\n * Uses Node.js fs APIs to get birth timestamps without reading file contents.\n */\n\nimport * as fs from \"fs\";\nimport * as path from \"path\";\n\n/**\n * Represents a session file with its birth time metadata.\n */\nexport interface SessionFile {\n  /** Session identifier (filename without .jsonl extension) */\n  sessionId: string;\n\n  /** Full path to the session file */\n  filePath: string;\n\n  /** Parent directory of the session file */\n  projectDir: string;\n\n  /** File creation time in milliseconds since epoch */\n  birthtimeMs: number;\n\n  /** CWD this session maps to — set by the adapter after calling batchGetSessionFileBirthtimes() */\n  resolvedCwd: string;\n}\n\n/**\n * Check whether a path exists and is a directory.\n * Returns false on any error (missing path, permission denied, broken symlink, etc.).\n */\nexport function isDirectory(p: string): boolean {\n  return safeStat(p)?.isDirectory() ?? false;\n}\n\n/**\n * `fs.statSync` that swallows errors and returns `undefined` on failure.\n * Callers can pull whichever fields they need (mtime, birthtime, ...).\n */\nexport function safeStat(filePath: string): fs.Stats | undefined {\n  try {\n    return fs.statSync(filePath);\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * `fs.readFileSync` (utf-8) that swallows errors and returns `undefined`\n * on failure. Use when an unreadable file should be skipped rather than\n * raised.\n */\nexport function safeReadFile(filePath: string): string | undefined {\n  try {\n    return fs.readFileSync(filePath, \"utf-8\");\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * `fs.readdirSync` that swallows errors and returns `[]` on failure.\n * Useful when walking optional/transient directories where missing or\n * unreadable entries should be skipped silently.\n */\nexport function safeReaddir(dir: string): string[] {\n  try {\n    return fs.readdirSync(dir);\n  } catch {\n    return [];\n  }\n}\n\n/**\n * List entries in a directory that end with `.jsonl`. Returns `[]` on\n * read errors. The result preserves directory order (no sorting).\n */\nexport function listJsonl(dir: string): string[] {\n  return safeReaddir(dir).filter((name) => name.endsWith(\".jsonl\"));\n}\n\n/**\n * Get birth times for .jsonl session files across multiple directories.\n *\n * Enumerates each directory with readdirSync and stats each .jsonl file\n * to get its birth time. No shell commands are used.\n * Returns empty array if no directories have .jsonl files or reads fail.\n * resolvedCwd is left empty — the adapter must set it.\n */\nexport function batchGetSessionFileBirthtimes(dirs: string[]): SessionFile[] {\n  if (dirs.length === 0) return [];\n\n  const results: SessionFile[] = [];\n\n  for (const dir of dirs) {\n    let entries: string[];\n    try {\n      entries = fs.readdirSync(dir);\n    } catch {\n      continue;\n    }\n\n    for (const entry of entries) {\n      if (!entry.endsWith(\".jsonl\")) continue;\n\n      const filePath = path.join(dir, entry);\n\n      let birthtimeMs: number;\n      try {\n        birthtimeMs = fs.statSync(filePath).birthtimeMs;\n      } catch {\n        continue;\n      }\n\n      if (!Number.isFinite(birthtimeMs) || birthtimeMs <= 0) continue;\n\n      const sessionId = entry.replace(/\\.jsonl$/, \"\");\n\n      results.push({\n        sessionId,\n        filePath,\n        projectDir: dir,\n        birthtimeMs,\n        resolvedCwd: \"\",\n      });\n    }\n  }\n\n  return results;\n}\n"],"names":["fs","path","isDirectory","p","safeStat","filePath","statSync","undefined","safeReadFile","readFileSync","safeReaddir","dir","readdirSync","listJsonl","filter","name","endsWith","batchGetSessionFileBirthtimes","dirs","length","results","entries","entry","join","birthtimeMs","Number","isFinite","sessionId","replace","push","projectDir","resolvedCwd"],"mappings":"AAAA;;;;;CAKC,GAED,YAAYA,QAAQ,KAAK;AACzB,YAAYC,UAAU,OAAO;AAsB7B;;;CAGC,GACD,OAAO,SAASC,YAAYC,CAAS;IACnC,OAAOC,SAASD,IAAID,iBAAiB;AACvC;AAEA;;;CAGC,GACD,OAAO,SAASE,SAASC,QAAgB;IACvC,IAAI;QACF,OAAOL,GAAGM,QAAQ,CAACD;IACrB,EAAE,OAAM;QACN,OAAOE;IACT;AACF;AAEA;;;;CAIC,GACD,OAAO,SAASC,aAAaH,QAAgB;IAC3C,IAAI;QACF,OAAOL,GAAGS,YAAY,CAACJ,UAAU;IACnC,EAAE,OAAM;QACN,OAAOE;IACT;AACF;AAEA;;;;CAIC,GACD,OAAO,SAASG,YAAYC,GAAW;IACrC,IAAI;QACF,OAAOX,GAAGY,WAAW,CAACD;IACxB,EAAE,OAAM;QACN,OAAO,EAAE;IACX;AACF;AAEA;;;CAGC,GACD,OAAO,SAASE,UAAUF,GAAW;IACnC,OAAOD,YAAYC,KAAKG,MAAM,CAAC,CAACC,OAASA,KAAKC,QAAQ,CAAC;AACzD;AAEA;;;;;;;CAOC,GACD,OAAO,SAASC,8BAA8BC,IAAc;IAC1D,IAAIA,KAAKC,MAAM,KAAK,GAAG,OAAO,EAAE;IAEhC,MAAMC,UAAyB,EAAE;IAEjC,KAAK,MAAMT,OAAOO,KAAM;QACtB,IAAIG;QACJ,IAAI;YACFA,UAAUrB,GAAGY,WAAW,CAACD;QAC3B,EAAE,OAAM;YACN;QACF;QAEA,KAAK,MAAMW,SAASD,QAAS;YAC3B,IAAI,CAACC,MAAMN,QAAQ,CAAC,WAAW;YAE/B,MAAMX,WAAWJ,KAAKsB,IAAI,CAACZ,KAAKW;YAEhC,IAAIE;YACJ,IAAI;gBACFA,cAAcxB,GAAGM,QAAQ,CAACD,UAAUmB,WAAW;YACjD,EAAE,OAAM;gBACN;YACF;YAEA,IAAI,CAACC,OAAOC,QAAQ,CAACF,gBAAgBA,eAAe,GAAG;YAEvD,MAAMG,YAAYL,MAAMM,OAAO,CAAC,YAAY;YAE5CR,QAAQS,IAAI,CAAC;gBACXF;gBACAtB;gBACAyB,YAAYnB;gBACZa;gBACAO,aAAa;YACf;QACF;IACF;IAEA,OAAOX;AACT"}
+{"version":3,"sources":["../../src/utils/session.ts"],"sourcesContent":["/**\n * Session File Utilities\n *\n * Utilities for discovering session files and their birth times.\n * Uses Node.js fs APIs to get birth timestamps without reading file contents.\n */\n\nimport * as fs from \"fs\";\nimport * as path from \"path\";\n\n/**\n * Represents a session file with its birth time metadata.\n */\nexport interface SessionFile {\n  /** Session identifier (filename without .jsonl extension) */\n  sessionId: string;\n\n  /** Full path to the session file */\n  filePath: string;\n\n  /** Parent directory of the session file */\n  projectDir: string;\n\n  /** File creation time in milliseconds since epoch */\n  birthtimeMs: number;\n\n  /** CWD this session maps to — set by the adapter after calling batchGetSessionFileBirthtimes() */\n  resolvedCwd: string;\n}\n\n/**\n * Check whether a path exists and is a directory.\n * Returns false on any error (missing path, permission denied, broken symlink, etc.).\n */\nexport function isDirectory(p: string): boolean {\n  return safeStat(p)?.isDirectory() ?? false;\n}\n\n/** Return whether a value can be safely appended as one filesystem path segment. */\nexport function isSafePathSegment(value: string): boolean {\n  return (\n    value.length > 0 &&\n    value !== \".\" &&\n    value !== \"..\" &&\n    !value.includes(\"\\0\") &&\n    path.basename(value) === value\n  );\n}\n\n/**\n * `fs.statSync` that swallows errors and returns `undefined` on failure.\n * Callers can pull whichever fields they need (mtime, birthtime, ...).\n */\nexport function safeStat(filePath: string): fs.Stats | undefined {\n  try {\n    return fs.statSync(filePath);\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * `fs.readFileSync` (utf-8) that swallows errors and returns `undefined`\n * on failure. Use when an unreadable file should be skipped rather than\n * raised.\n */\nexport function safeReadFile(filePath: string): string | undefined {\n  try {\n    return fs.readFileSync(filePath, \"utf-8\");\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * `fs.readdirSync` that swallows errors and returns `[]` on failure.\n * Useful when walking optional/transient directories where missing or\n * unreadable entries should be skipped silently.\n */\nexport function safeReaddir(dir: string): string[] {\n  try {\n    return fs.readdirSync(dir);\n  } catch {\n    return [];\n  }\n}\n\n/**\n * List entries in a directory that end with `.jsonl`. Returns `[]` on\n * read errors. The result preserves directory order (no sorting).\n */\nexport function listJsonl(dir: string): string[] {\n  return safeReaddir(dir).filter((name) => name.endsWith(\".jsonl\"));\n}\n\n/**\n * Get birth times for .jsonl session files across multiple directories.\n *\n * Enumerates each directory with readdirSync and stats each .jsonl file\n * to get its birth time. No shell commands are used.\n * Returns empty array if no directories have .jsonl files or reads fail.\n * resolvedCwd is left empty — the adapter must set it.\n */\nexport function batchGetSessionFileBirthtimes(dirs: string[]): SessionFile[] {\n  if (dirs.length === 0) return [];\n\n  const results: SessionFile[] = [];\n\n  for (const dir of dirs) {\n    let entries: string[];\n    try {\n      entries = fs.readdirSync(dir);\n    } catch {\n      continue;\n    }\n\n    for (const entry of entries) {\n      if (!entry.endsWith(\".jsonl\")) continue;\n\n      const filePath = path.join(dir, entry);\n\n      let birthtimeMs: number;\n      try {\n        birthtimeMs = fs.statSync(filePath).birthtimeMs;\n      } catch {\n        continue;\n      }\n\n      if (!Number.isFinite(birthtimeMs) || birthtimeMs <= 0) continue;\n\n      const sessionId = entry.replace(/\\.jsonl$/, \"\");\n\n      results.push({\n        sessionId,\n        filePath,\n        projectDir: dir,\n        birthtimeMs,\n        resolvedCwd: \"\",\n      });\n    }\n  }\n\n  return results;\n}\n"],"names":["fs","path","isDirectory","p","safeStat","isSafePathSegment","value","length","includes","basename","filePath","statSync","undefined","safeReadFile","readFileSync","safeReaddir","dir","readdirSync","listJsonl","filter","name","endsWith","batchGetSessionFileBirthtimes","dirs","results","entries","entry","join","birthtimeMs","Number","isFinite","sessionId","replace","push","projectDir","resolvedCwd"],"mappings":"AAAA;;;;;CAKC,GAED,YAAYA,QAAQ,KAAK;AACzB,YAAYC,UAAU,OAAO;AAsB7B;;;CAGC,GACD,OAAO,SAASC,YAAYC,CAAS;IACnC,OAAOC,SAASD,IAAID,iBAAiB;AACvC;AAEA,kFAAkF,GAClF,OAAO,SAASG,kBAAkBC,KAAa;IAC7C,OACEA,MAAMC,MAAM,GAAG,KACfD,UAAU,OACVA,UAAU,QACV,CAACA,MAAME,QAAQ,CAAC,SAChBP,KAAKQ,QAAQ,CAACH,WAAWA;AAE7B;AAEA;;;CAGC,GACD,OAAO,SAASF,SAASM,QAAgB;IACvC,IAAI;QACF,OAAOV,GAAGW,QAAQ,CAACD;IACrB,EAAE,OAAM;QACN,OAAOE;IACT;AACF;AAEA;;;;CAIC,GACD,OAAO,SAASC,aAAaH,QAAgB;IAC3C,IAAI;QACF,OAAOV,GAAGc,YAAY,CAACJ,UAAU;IACnC,EAAE,OAAM;QACN,OAAOE;IACT;AACF;AAEA;;;;CAIC,GACD,OAAO,SAASG,YAAYC,GAAW;IACrC,IAAI;QACF,OAAOhB,GAAGiB,WAAW,CAACD;IACxB,EAAE,OAAM;QACN,OAAO,EAAE;IACX;AACF;AAEA;;;CAGC,GACD,OAAO,SAASE,UAAUF,GAAW;IACnC,OAAOD,YAAYC,KAAKG,MAAM,CAAC,CAACC,OAASA,KAAKC,QAAQ,CAAC;AACzD;AAEA;;;;;;;CAOC,GACD,OAAO,SAASC,8BAA8BC,IAAc;IAC1D,IAAIA,KAAKhB,MAAM,KAAK,GAAG,OAAO,EAAE;IAEhC,MAAMiB,UAAyB,EAAE;IAEjC,KAAK,MAAMR,OAAOO,KAAM;QACtB,IAAIE;QACJ,IAAI;YACFA,UAAUzB,GAAGiB,WAAW,CAACD;QAC3B,EAAE,OAAM;YACN;QACF;QAEA,KAAK,MAAMU,SAASD,QAAS;YAC3B,IAAI,CAACC,MAAML,QAAQ,CAAC,WAAW;YAE/B,MAAMX,WAAWT,KAAK0B,IAAI,CAACX,KAAKU;YAEhC,IAAIE;YACJ,IAAI;gBACFA,cAAc5B,GAAGW,QAAQ,CAACD,UAAUkB,WAAW;YACjD,EAAE,OAAM;gBACN;YACF;YAEA,IAAI,CAACC,OAAOC,QAAQ,CAACF,gBAAgBA,eAAe,GAAG;YAEvD,MAAMG,YAAYL,MAAMM,OAAO,CAAC,YAAY;YAE5CR,QAAQS,IAAI,CAAC;gBACXF;gBACArB;gBACAwB,YAAYlB;gBACZY;gBACAO,aAAa;YACf;QACF;IACF;IAEA,OAAOX;AACT"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-devkit/agent-manager",
-  "version": "0.33.1",
+  "version": "0.35.0",
   "description": "Standalone agent detection and management utilities for AI DevKit",
   "keywords": [
     "agent",

package/src/AgentManager.ts

@@ -347,6 +347,40 @@ export class AgentManager {
     return merged;
   }
 
+  /** Resolve an exact historical session ID across the selected providers. */
+  async findSessionsById(
+    sessionId: string,
+    opts?: Pick<ListSessionsOptions, "type">,
+  ): Promise<SessionSummary[]> {
+    const targetAdapters = Array.from(this.adapters.values()).filter(
+      (adapter) => opts?.type === undefined || adapter.type === opts.type,
+    );
+    const errors: Array<{ type: string; error: Error }> = [];
+
+    const results = await Promise.all(
+      targetAdapters.map(async (adapter) => {
+        try {
+          if (adapter.findSessionsById) return await adapter.findSessionsById(sessionId);
+          const sessions = await adapter.listSessions(opts);
+          return sessions.filter((session) => session.sessionId === sessionId);
+        } catch (error) {
+          const err = error instanceof Error ? error : new Error(String(error));
+          errors.push({ type: adapter.type, error: err });
+          return [];
+        }
+      }),
+    );
+
+    if (errors.length > 0) {
+      console.error(`Warning: ${errors.length} adapter(s) failed to find session by ID:`);
+      for (const { type, error } of errors) {
+        console.error(`  - ${type}: ${error.message}`);
+      }
+    }
+
+    return results.flat();
+  }
+
   /**
    * Get count of registered adapters
    *

package/src/__tests__/AgentManager.test.ts

@@ -21,6 +21,7 @@ import type { HerdrAgentPane } from "../runtime/herdr/HerdrAgentDiscovery.js";
 // Mock adapter for testing
 class MockAdapter implements AgentAdapter {
   public lastListSessionsOpts: unknown = undefined;
+  public findSessionsByIdCalls: string[] = [];
 
   constructor(
     public readonly type: AgentType,
@@ -53,6 +54,11 @@ class MockAdapter implements AgentAdapter {
     return this.mockSessions;
   }
 
+  async findSessionsById(sessionId: string): Promise<SessionSummary[]> {
+    this.findSessionsByIdCalls.push(sessionId);
+    return this.mockSessions.filter((session) => session.sessionId === sessionId);
+  }
+
   setAgents(agents: AgentInfo[]): void {
     this.mockAgents = agents;
   }
@@ -1119,6 +1125,60 @@ describe("AgentManager", () => {
     });
   });
 
+  describe("findSessionsById", () => {
+    const session = (type: AgentType, sessionId: string): SessionSummary => ({
+      type,
+      sessionId,
+      cwd: "/repo",
+      firstUserMessage: "hello",
+      lastActive: new Date("2025-01-01T00:00:00Z"),
+      startedAt: new Date("2025-01-01T00:00:00Z"),
+      sessionFilePath: `/tmp/${sessionId}`,
+    });
+
+    it("uses each built-in adapter direct lookup and preserves cross-provider ambiguity", async () => {
+      const claude = new MockAdapter("claude", [], false, [session("claude", "shared")]);
+      const codex = new MockAdapter("codex", [], false, [session("codex", "shared")]);
+      manager.registerAdapter(claude);
+      manager.registerAdapter(codex);
+
+      const result = await manager.findSessionsById("shared");
+
+      expect(result).toHaveLength(2);
+      expect(claude.findSessionsByIdCalls).toEqual(["shared"]);
+      expect(codex.findSessionsByIdCalls).toEqual(["shared"]);
+      expect(claude.lastListSessionsOpts).toBeUndefined();
+      expect(codex.lastListSessionsOpts).toBeUndefined();
+    });
+
+    it("skips non-matching providers when type is supplied", async () => {
+      const claude = new MockAdapter("claude", [], false, [session("claude", "target")]);
+      const codex = new MockAdapter("codex", [], false, [session("codex", "target")]);
+      manager.registerAdapter(claude);
+      manager.registerAdapter(codex);
+
+      const result = await manager.findSessionsById("target", { type: "codex" });
+
+      expect(result).toEqual([expect.objectContaining({ type: "codex", sessionId: "target" })]);
+      expect(claude.findSessionsByIdCalls).toEqual([]);
+      expect(codex.findSessionsByIdCalls).toEqual(["target"]);
+    });
+
+    it("falls back to filtered listing for external adapters without direct lookup", async () => {
+      const external = new MockAdapter("other", [], false, [
+        session("other", "target"),
+        session("other", "different"),
+      ]);
+      (external as Partial<AgentAdapter>).findSessionsById = undefined;
+      manager.registerAdapter(external);
+
+      const result = await manager.findSessionsById("target");
+
+      expect(result).toEqual([expect.objectContaining({ sessionId: "target" })]);
+      expect(external.lastListSessionsOpts).toEqual(undefined);
+    });
+  });
+
   describe("resolveAgent", () => {
     it("should return null for empty input or empty agents list", () => {
       const agent = createMockAgent({ name: "test-agent" });

package/src/__tests__/adapters/ClaudeCodeAdapter.test.ts

@@ -1624,6 +1624,29 @@ describe("ClaudeCodeAdapter", () => {
       expect(cwds).toEqual([cwdA, cwdB]);
     });
 
+    it("finds an exact session ID without returning other project sessions", async () => {
+      const wantedPath = writeSession(path.join(projectsDir, "-repo-a"), "wanted", [
+        {
+          type: "user",
+          timestamp: "2025-01-01T00:00:00Z",
+          cwd: "/repo-a",
+          message: { content: "wanted prompt" },
+        },
+      ]);
+      writeSession(path.join(projectsDir, "-repo-b"), "other", [
+        {
+          type: "user",
+          timestamp: "2025-01-01T00:00:00Z",
+          cwd: "/repo-b",
+          message: { content: "other prompt" },
+        },
+      ]);
+
+      await expect(adapter.findSessionsById("wanted")).resolves.toEqual([
+        expect.objectContaining({ sessionId: "wanted", sessionFilePath: wantedPath }),
+      ]);
+    });
+
     it("drops sessions whose recorded cwd does not match opts.cwd (strict equality)", async () => {
       const cwdReal = "/Users/test/foo";
       const cwdRequested = "/Users/test/foo/sub";

package/src/__tests__/adapters/CodexAdapter.test.ts

@@ -339,6 +339,13 @@ describe("CodexAdapter", () => {
         sessionFilePath: sessionFile,
       },
     ]);
+    await expect(adapter.findSessionsById("listed")).resolves.toMatchObject([
+      {
+        type: "codex",
+        sessionId: "listed",
+        sessionFilePath: sessionFile,
+      },
+    ]);
   });
 
   function writeSession(