@ai-devkit/agent-manager 0.40.0 → 0.42.0

package/dist/harnesses/devin/DevinSessionParser.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/harnesses/devin/DevinSessionParser.ts"],"sourcesContent":["import type { ConversationMessage, ConversationOptions } from \"../../adapters/AgentAdapter.js\";\nimport { sliceTail } from \"../../utils/jsonlTail.js\";\nimport { SUMMARY_MAX_LENGTH, truncate } from \"../shared.js\";\nimport type Database from \"better-sqlite3\";\n\nexport interface DevinSessionStats {\n  lastRole: string | null;\n  /** Epoch milliseconds of the newest message node. */\n  lastTimeUpdated: number;\n  summary: string;\n}\n\ninterface DevinChatMessage {\n  message_id?: string;\n  role?: string;\n  content?: unknown;\n  tool_calls?: { name?: string; function?: { name?: string } }[];\n  thinking?: { thinking?: string } | string;\n  name?: string;\n  metadata?: { is_user_input?: boolean };\n}\n\ninterface MessageNodeRow {\n  node_id: number;\n  chat_message: string;\n}\n\nconst EMPTY_STATS: DevinSessionStats = {\n  lastRole: null,\n  lastTimeUpdated: 0,\n  summary: \"\",\n};\n\n/** Rows fetched per requested tail message; revisions/tools eat into the window. */\nconst TAIL_OVERFETCH = 8;\nconst TOOL_CONTENT_MAX = 500;\n\nexport class DevinSessionParser {\n  getConversation(\n    db: Database.Database,\n    sessionId: string,\n    options?: ConversationOptions,\n  ): ConversationMessage[] {\n    const verbose = options?.verbose ?? false;\n    const tail =\n      options?.tail && Number.isInteger(options.tail) && options.tail > 0\n        ? options.tail\n        : undefined;\n\n    try {\n      // LIMIT -1 = unbounded in SQLite; one query serves the full and tail paths.\n      const limit = tail ? tail * TAIL_OVERFETCH : -1;\n      const rows = db\n        .prepare<[string, number], MessageNodeRow>(`\n                SELECT node_id, chat_message\n                FROM message_nodes\n                WHERE session_id = ?\n                ORDER BY node_id DESC\n                LIMIT ?\n            `)\n        .all(sessionId, limit)\n        .reverse();\n\n      const messages: ConversationMessage[] = [];\n      const latestNodeByMessageId = new Map<string, number>();\n      const parsed: { nodeId: number; message: DevinChatMessage }[] = [];\n\n      for (const row of rows) {\n        const message = this.parseChatMessage(row.chat_message);\n        if (!message) continue;\n        parsed.push({ nodeId: row.node_id, message });\n        if (message.message_id) {\n          latestNodeByMessageId.set(\n            message.message_id,\n            Math.max(latestNodeByMessageId.get(message.message_id) ?? 0, row.node_id),\n          );\n        }\n      }\n\n      for (const { nodeId, message } of parsed) {\n        if (\n          message.message_id &&\n          latestNodeByMessageId.get(message.message_id) !== nodeId\n        ) {\n          continue;\n        }\n\n        const role = message.role;\n        if (role === \"system\") continue;\n\n        const content = typeof message.content === \"string\" ? message.content : \"\";\n\n        if (role === \"user\") {\n          if (message.metadata?.is_user_input === false || !content.trim()) continue;\n          messages.push({ role: \"user\", content });\n          continue;\n        }\n\n        if (role === \"assistant\") {\n          const thinking =\n            typeof message.thinking === \"string\"\n              ? message.thinking\n              : message.thinking?.thinking;\n          if (verbose && thinking) {\n            messages.push({ role: \"assistant\", content: `[thinking] ${thinking}` });\n          }\n          if (content.trim()) messages.push({ role: \"assistant\", content });\n          if (verbose) {\n            for (const call of message.tool_calls ?? []) {\n              const name = call.function?.name ?? call.name ?? \"tool\";\n              messages.push({ role: \"assistant\", content: `[tool: ${name}]` });\n            }\n          }\n          continue;\n        }\n\n        if (role === \"tool\" && verbose) {\n          const label = message.name ? `[tool: ${message.name}]` : \"[tool]\";\n          messages.push({\n            role: \"assistant\",\n            content: `${label} ${truncate(content.trim(), TOOL_CONTENT_MAX)}`.trim(),\n          });\n        }\n      }\n\n      return sliceTail(messages, tail);\n    } catch {\n      return [];\n    }\n  }\n\n  getSessionStats(db: Database.Database, sessionId: string): DevinSessionStats {\n    try {\n      const frontier = db\n        .prepare<[string], { chat_message: string }>(`\n                SELECT chat_message\n                FROM message_nodes\n                WHERE session_id = ?\n                ORDER BY node_id DESC\n                LIMIT 1\n            `)\n        .get(sessionId);\n\n      const heartbeat = db\n        .prepare<[string], { maxCreated: number | null }>(`\n                SELECT MAX(created_at) AS maxCreated\n                FROM message_nodes\n                WHERE session_id = ?\n            `)\n        .get(sessionId);\n\n      return {\n        lastRole: this.parseChatMessage(frontier?.chat_message ?? \"\")?.role ?? null,\n        lastTimeUpdated: (heartbeat?.maxCreated ?? 0) * 1000,\n        summary: this.getLastUserPrompt(db, sessionId),\n      };\n    } catch {\n      return EMPTY_STATS;\n    }\n  }\n\n  /**\n   * Most recent typed prompt for the \"working on\" summary, matching the\n   * last-user-message convention of the other adapters.\n   */\n  getLastUserPrompt(db: Database.Database, sessionId: string): string {\n    return this.userPrompt(db, sessionId, \"DESC\");\n  }\n\n  /**\n   * First typed prompt for session-list identity (`firstUserMessage`).\n   */\n  getFirstUserMessage(db: Database.Database, sessionId: string): string {\n    return this.userPrompt(db, sessionId, \"ASC\");\n  }\n\n  /**\n   * Typed prompt in the given direction. `prompt_history` is authoritative;\n   * shell `!` commands and `/` slash commands are skipped. Falls back to a\n   * bounded `is_user_input` node scan in the same direction.\n   */\n  private userPrompt(\n    db: Database.Database,\n    sessionId: string,\n    direction: \"ASC\" | \"DESC\",\n  ): string {\n    try {\n      const prompt = db\n        .prepare<[string], { content: string }>(`\n                SELECT content\n                FROM prompt_history\n                WHERE session_id = ? AND is_shell = 0 AND content NOT LIKE '/%'\n                ORDER BY timestamp ${direction}\n                LIMIT 1\n            `)\n        .get(sessionId);\n      if (prompt?.content?.trim()) return truncate(prompt.content.trim(), SUMMARY_MAX_LENGTH);\n    } catch {\n      /* fall through to message_nodes */\n    }\n\n    try {\n      const rows = db\n        .prepare<[string], { chat_message: string }>(`\n                SELECT chat_message\n                FROM message_nodes\n                WHERE session_id = ? AND json_extract(chat_message, '$.role') = 'user'\n                ORDER BY node_id ${direction}\n                LIMIT 8\n            `)\n        .all(sessionId);\n      for (const row of rows) {\n        const message = this.parseChatMessage(row.chat_message);\n        if (\n          message?.role === \"user\" &&\n          message.metadata?.is_user_input !== false &&\n          typeof message.content === \"string\" &&\n          message.content.trim()\n        ) {\n          return truncate(message.content.trim(), SUMMARY_MAX_LENGTH);\n        }\n      }\n    } catch {\n      /* ignore */\n    }\n    return \"\";\n  }\n\n  private parseChatMessage(raw: string): DevinChatMessage | null {\n    try {\n      return JSON.parse(raw) as DevinChatMessage;\n    } catch {\n      return null;\n    }\n  }\n}\n"],"names":["sliceTail","SUMMARY_MAX_LENGTH","truncate","EMPTY_STATS","lastRole","lastTimeUpdated","summary","TAIL_OVERFETCH","TOOL_CONTENT_MAX","DevinSessionParser","getConversation","db","sessionId","options","verbose","tail","Number","isInteger","undefined","limit","rows","prepare","all","reverse","messages","latestNodeByMessageId","Map","parsed","row","message","parseChatMessage","chat_message","push","nodeId","node_id","message_id","set","Math","max","get","role","content","metadata","is_user_input","trim","thinking","call","tool_calls","name","function","label","getSessionStats","frontier","heartbeat","maxCreated","getLastUserPrompt","userPrompt","getFirstUserMessage","direction","prompt","raw","JSON","parse"],"mappings":"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"}
+{"version":3,"sources":["../../../src/harnesses/devin/DevinSessionParser.ts"],"sourcesContent":["import type { ConversationMessage, ConversationOptions } from \"../../adapters/AgentAdapter.js\";\nimport { sliceTail } from \"../../utils/jsonlTail.js\";\nimport { SUMMARY_MAX_LENGTH, truncate } from \"../shared.js\";\nimport type Database from \"better-sqlite3\";\n\nexport interface DevinSessionStats {\n  lastRole: string | null;\n  /** Epoch milliseconds of the newest message node. */\n  lastTimeUpdated: number;\n  summary: string;\n}\n\ninterface DevinChatMessage {\n  message_id?: string;\n  role?: string;\n  content?: unknown;\n  tool_calls?: { name?: string; function?: { name?: string } }[];\n  thinking?: { thinking?: string } | string;\n  name?: string;\n  metadata?: { is_user_input?: boolean };\n}\n\ninterface MessageNodeRow {\n  node_id: number;\n  chat_message: string;\n}\n\nconst EMPTY_STATS: DevinSessionStats = {\n  lastRole: null,\n  lastTimeUpdated: 0,\n  summary: \"\",\n};\n\n/** Rows fetched per requested tail message; revisions/tools eat into the window. */\nconst TAIL_OVERFETCH = 8;\nconst TOOL_CONTENT_MAX = 500;\n\nexport class DevinSessionParser {\n  getConversation(\n    db: Database.Database,\n    sessionId: string,\n    options?: ConversationOptions,\n  ): ConversationMessage[] {\n    const verbose = options?.verbose ?? false;\n    const tail =\n      options?.tail && Number.isInteger(options.tail) && options.tail > 0\n        ? options.tail\n        : undefined;\n\n    try {\n      // LIMIT -1 = unbounded in SQLite; one query serves the full and tail paths.\n      const limit = tail ? tail * TAIL_OVERFETCH : -1;\n      const rows = db\n        .prepare<[string, number], MessageNodeRow>(`\n                SELECT node_id, chat_message\n                FROM message_nodes\n                WHERE session_id = ?\n                ORDER BY node_id DESC\n                LIMIT ?\n            `)\n        .all(sessionId, limit)\n        .reverse();\n\n      const messages: ConversationMessage[] = [];\n      const latestNodeByMessageId = new Map<string, number>();\n      const parsed: { nodeId: number; message: DevinChatMessage }[] = [];\n\n      for (const row of rows) {\n        const message = this.parseChatMessage(row.chat_message);\n        if (!message) continue;\n        parsed.push({ nodeId: row.node_id, message });\n        if (message.message_id) {\n          latestNodeByMessageId.set(\n            message.message_id,\n            Math.max(latestNodeByMessageId.get(message.message_id) ?? 0, row.node_id),\n          );\n        }\n      }\n\n      for (const { nodeId, message } of parsed) {\n        if (message.message_id && latestNodeByMessageId.get(message.message_id) !== nodeId) {\n          continue;\n        }\n\n        const role = message.role;\n        if (role === \"system\") continue;\n\n        const content = typeof message.content === \"string\" ? message.content : \"\";\n\n        if (role === \"user\") {\n          if (message.metadata?.is_user_input === false || !content.trim()) continue;\n          messages.push({ role: \"user\", content });\n          continue;\n        }\n\n        if (role === \"assistant\") {\n          const thinking =\n            typeof message.thinking === \"string\" ? message.thinking : message.thinking?.thinking;\n          if (verbose && thinking) {\n            messages.push({ role: \"assistant\", content: `[thinking] ${thinking}` });\n          }\n          if (content.trim()) messages.push({ role: \"assistant\", content });\n          if (verbose) {\n            for (const call of message.tool_calls ?? []) {\n              const name = call.function?.name ?? call.name ?? \"tool\";\n              messages.push({ role: \"assistant\", content: `[tool: ${name}]` });\n            }\n          }\n          continue;\n        }\n\n        if (role === \"tool\" && verbose) {\n          const label = message.name ? `[tool: ${message.name}]` : \"[tool]\";\n          messages.push({\n            role: \"assistant\",\n            content: `${label} ${truncate(content.trim(), TOOL_CONTENT_MAX)}`.trim(),\n          });\n        }\n      }\n\n      return sliceTail(messages, tail);\n    } catch {\n      return [];\n    }\n  }\n\n  getSessionStats(db: Database.Database, sessionId: string): DevinSessionStats {\n    try {\n      const frontier = db\n        .prepare<[string], { chat_message: string }>(`\n                SELECT chat_message\n                FROM message_nodes\n                WHERE session_id = ?\n                ORDER BY node_id DESC\n                LIMIT 1\n            `)\n        .get(sessionId);\n\n      const heartbeat = db\n        .prepare<[string], { maxCreated: number | null }>(`\n                SELECT MAX(created_at) AS maxCreated\n                FROM message_nodes\n                WHERE session_id = ?\n            `)\n        .get(sessionId);\n\n      return {\n        lastRole: this.parseChatMessage(frontier?.chat_message ?? \"\")?.role ?? null,\n        lastTimeUpdated: (heartbeat?.maxCreated ?? 0) * 1000,\n        summary: this.getLastUserPrompt(db, sessionId),\n      };\n    } catch {\n      return EMPTY_STATS;\n    }\n  }\n\n  /**\n   * Most recent typed prompt for the \"working on\" summary, matching the\n   * last-user-message convention of the other adapters.\n   */\n  getLastUserPrompt(db: Database.Database, sessionId: string): string {\n    return this.userPrompt(db, sessionId, \"DESC\");\n  }\n\n  /**\n   * First typed prompt for session-list identity (`firstUserMessage`).\n   */\n  getFirstUserMessage(db: Database.Database, sessionId: string): string {\n    return this.userPrompt(db, sessionId, \"ASC\");\n  }\n\n  /**\n   * Typed prompt in the given direction. `prompt_history` is authoritative;\n   * shell `!` commands and `/` slash commands are skipped. Falls back to a\n   * bounded `is_user_input` node scan in the same direction.\n   */\n  private userPrompt(db: Database.Database, sessionId: string, direction: \"ASC\" | \"DESC\"): string {\n    try {\n      const prompt = db\n        .prepare<[string], { content: string }>(`\n                SELECT content\n                FROM prompt_history\n                WHERE session_id = ? AND is_shell = 0 AND content NOT LIKE '/%'\n                ORDER BY timestamp ${direction}\n                LIMIT 1\n            `)\n        .get(sessionId);\n      if (prompt?.content?.trim()) return truncate(prompt.content.trim(), SUMMARY_MAX_LENGTH);\n    } catch {\n      /* fall through to message_nodes */\n    }\n\n    try {\n      const rows = db\n        .prepare<[string], { chat_message: string }>(`\n                SELECT chat_message\n                FROM message_nodes\n                WHERE session_id = ? AND json_extract(chat_message, '$.role') = 'user'\n                ORDER BY node_id ${direction}\n                LIMIT 8\n            `)\n        .all(sessionId);\n      for (const row of rows) {\n        const message = this.parseChatMessage(row.chat_message);\n        if (\n          message?.role === \"user\" &&\n          message.metadata?.is_user_input !== false &&\n          typeof message.content === \"string\" &&\n          message.content.trim()\n        ) {\n          return truncate(message.content.trim(), SUMMARY_MAX_LENGTH);\n        }\n      }\n    } catch {\n      /* ignore */\n    }\n    return \"\";\n  }\n\n  private parseChatMessage(raw: string): DevinChatMessage | null {\n    try {\n      return JSON.parse(raw) as DevinChatMessage;\n    } catch {\n      return null;\n    }\n  }\n}\n"],"names":["sliceTail","SUMMARY_MAX_LENGTH","truncate","EMPTY_STATS","lastRole","lastTimeUpdated","summary","TAIL_OVERFETCH","TOOL_CONTENT_MAX","DevinSessionParser","getConversation","db","sessionId","options","verbose","tail","Number","isInteger","undefined","limit","rows","prepare","all","reverse","messages","latestNodeByMessageId","Map","parsed","row","message","parseChatMessage","chat_message","push","nodeId","node_id","message_id","set","Math","max","get","role","content","metadata","is_user_input","trim","thinking","call","tool_calls","name","function","label","getSessionStats","frontier","heartbeat","maxCreated","getLastUserPrompt","userPrompt","getFirstUserMessage","direction","prompt","raw","JSON","parse"],"mappings":"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"}

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

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

package/dist/harnesses/index.js

@@ -8,6 +8,7 @@ import { KiroAdapter } from "./kiro/KiroAdapter.js";
 import { OpenCodeAdapter } from "./opencode/OpenCodeAdapter.js";
 import { PiAdapter } from "./pi/PiAdapter.js";
 import { DevinAdapter } from "./devin/DevinAdapter.js";
+import { MuseAdapter } from "./muse/MuseAdapter.js";
 /**
  * One instance of every built-in harness adapter, in registration order
  * (which is also the order agents are listed in). Register a new harness here.
@@ -22,7 +23,8 @@ import { DevinAdapter } from "./devin/DevinAdapter.js";
         new AntigravityCliAdapter(),
         new OpenCodeAdapter(),
         new PiAdapter(),
-        new DevinAdapter()
+        new DevinAdapter(),
+        new MuseAdapter()
     ];
 }
 

package/dist/harnesses/index.js.map

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

package/dist/harnesses/muse/MuseAdapter.d.ts

@@ -0,0 +1,33 @@
+import type { AgentAdapter, AgentDetectionContext, AgentInfo, ConversationMessage, ConversationOptions, ListSessionsOptions, ProcessInfo, SessionSummary } from "../../adapters/AgentAdapter.js";
+export interface MuseAdapterOptions {
+    homeDir?: string;
+}
+/**
+ * Muse (Meta Muse Code) adapter.
+ *
+ * Detection joins two sources:
+ * 1. Live runtime entries (`~/.local/share/muse/runtime/muse/sessions/<id>.json`)
+ *    matched to processes by `process_generation_hint: "pid=<n>"`.
+ * 2. The dated transcript archive (`sessions/yyyy/mm/dd/<uuid>/session.jsonl`).
+ *
+ * The launcher binary is versioned (`muse-bin-<version>-<build>`), so discovery
+ * uses `processNamePrefixes`; `canHandle` keeps the precise shape check.
+ */
+export declare class MuseAdapter implements AgentAdapter {
+    readonly type: "muse";
+    readonly processNames: readonly ["muse"];
+    readonly processNamePrefixes: readonly ["muse"];
+    private readonly home;
+    private readonly parser;
+    private readonly mapper;
+    constructor(options?: MuseAdapterOptions);
+    canHandle(processInfo: ProcessInfo): boolean;
+    detectAgents(context?: AgentDetectionContext): Promise<AgentInfo[]>;
+    private detectRunningAgents;
+    private createLocator;
+    getConversation(sessionFilePath: string, options?: ConversationOptions): ConversationMessage[];
+    listSessions(opts?: ListSessionsOptions): Promise<SessionSummary[]>;
+    findSessionsById(sessionId: string): Promise<SessionSummary[]>;
+    private toSessionSummary;
+}
+//# sourceMappingURL=MuseAdapter.d.ts.map

package/dist/harnesses/muse/MuseAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MuseAdapter.d.ts","sourceRoot":"","sources":["../../../src/harnesses/muse/MuseAdapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,qBAAqB,EACrB,SAAS,EACT,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,cAAc,EACf,MAAM,gCAAgC,CAAC;AAOxC,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,WAAY,YAAW,YAAY;IAC9C,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;IAChC,QAAQ,CAAC,YAAY,oBAAqB;IAC1C,QAAQ,CAAC,mBAAmB,oBAAqB;IAEjD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAE7B,OAAO,GAAE,kBAAuB;IAM5C,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO;IAKtC,YAAY,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;YAQ3D,mBAAmB;IAuDjC,OAAO,CAAC,aAAa;IAIrB,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,EAAE;IAIxF,YAAY,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAYnE,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAOpE,OAAO,CAAC,gBAAgB;CAczB"}

package/dist/harnesses/muse/MuseAdapter.js

@@ -0,0 +1,122 @@
+import * as path from "path";
+import { safeStat } from "../../utils/session.js";
+import { MuseAgentMapper } from "./MuseAgentMapper.js";
+import { MuseSessionLocator } from "./MuseSessionLocator.js";
+import { MuseSessionParser } from "./MuseSessionParser.js";
+import { findHarnessProcesses, homeDir } from "../shared.js";
+/**
+ * Muse (Meta Muse Code) adapter.
+ *
+ * Detection joins two sources:
+ * 1. Live runtime entries (`~/.local/share/muse/runtime/muse/sessions/<id>.json`)
+ *    matched to processes by `process_generation_hint: "pid=<n>"`.
+ * 2. The dated transcript archive (`sessions/yyyy/mm/dd/<uuid>/session.jsonl`).
+ *
+ * The launcher binary is versioned (`muse-bin-<version>-<build>`), so discovery
+ * uses `processNamePrefixes`; `canHandle` keeps the precise shape check.
+ */ export class MuseAdapter {
+    type = "muse";
+    processNames = [
+        "muse"
+    ];
+    processNamePrefixes = [
+        "muse"
+    ];
+    home;
+    parser;
+    mapper;
+    constructor(options = {}){
+        this.home = options.homeDir ?? homeDir();
+        this.parser = new MuseSessionParser();
+        this.mapper = new MuseAgentMapper(this.parser);
+    }
+    canHandle(processInfo) {
+        const base = path.basename(processInfo.command.trim().split(/\s+/)[0] ?? "").toLowerCase();
+        return base === "muse" || base === "muse.exe" || base.startsWith("muse-bin-");
+    }
+    async detectAgents(context) {
+        try {
+            return await this.detectRunningAgents(context);
+        } finally{
+            this.parser.pruneSessionCache();
+        }
+    }
+    async detectRunningAgents(context) {
+        const { processes } = await findHarnessProcesses(this, context);
+        if (processes.length === 0) return [];
+        const { direct, legacyMatches } = this.createLocator().matchRunningProcesses(processes);
+        const matchedPids = new Set([
+            ...direct.map((d)=>d.process.pid),
+            ...legacyMatches.map((m)=>m.process.pid)
+        ]);
+        const agents = [];
+        for (const match of direct){
+            const sessionData = this.parser.readSessionIncremental(match.sessionFile.filePath, match.sessionFile.resolvedCwd);
+            if (sessionData) {
+                agents.push(this.mapper.mapSessionToAgent({
+                    session: sessionData,
+                    processInfo: match.process,
+                    sessionFile: match.sessionFile
+                }));
+            } else {
+                matchedPids.delete(match.process.pid);
+            }
+        }
+        for (const match of legacyMatches){
+            const sessionData = this.parser.readSessionIncremental(match.session.filePath, match.session.resolvedCwd);
+            if (sessionData) {
+                agents.push(this.mapper.mapSessionToAgent({
+                    session: sessionData,
+                    processInfo: match.process,
+                    sessionFile: match.session
+                }));
+            } else {
+                matchedPids.delete(match.process.pid);
+            }
+        }
+        for (const proc of processes){
+            if (!matchedPids.has(proc.pid)) {
+                agents.push(this.mapper.mapProcessOnlyAgent(proc));
+            }
+        }
+        return agents;
+    }
+    createLocator() {
+        return new MuseSessionLocator({
+            homeDir: this.home
+        });
+    }
+    getConversation(sessionFilePath, options) {
+        return this.parser.getConversation(sessionFilePath, options);
+    }
+    async listSessions(opts) {
+        const filterCwd = opts?.cwd;
+        const summaries = [];
+        for (const { filePath, defaultCwd } of this.createLocator().discoverHistoricalSessionFiles()){
+            const summary = this.toSessionSummary(filePath, defaultCwd);
+            if (!summary) continue;
+            if (filterCwd !== undefined && summary.cwd !== filterCwd) continue;
+            summaries.push(summary);
+        }
+        return summaries;
+    }
+    async findSessionsById(sessionId) {
+        return this.createLocator().findHistoricalSessionFilesById(sessionId).map(({ filePath, defaultCwd })=>this.toSessionSummary(filePath, defaultCwd)).filter((summary)=>summary?.sessionId === sessionId);
+    }
+    toSessionSummary(filePath, defaultCwd) {
+        const session = this.parser.readSession(filePath, defaultCwd);
+        if (!session?.lastSignal && !session?.firstUserMessage) return null;
+        const stat = safeStat(filePath);
+        return {
+            type: "muse",
+            sessionId: session.sessionId,
+            cwd: session.projectPath || defaultCwd,
+            firstUserMessage: session.firstUserMessage || "",
+            lastActive: session.lastActive ?? stat?.mtime ?? new Date(),
+            startedAt: session.sessionStart ?? stat?.birthtime ?? stat?.mtime ?? new Date(),
+            sessionFilePath: filePath
+        };
+    }
+}
+
+//# sourceMappingURL=MuseAdapter.js.map

package/dist/harnesses/muse/MuseAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/harnesses/muse/MuseAdapter.ts"],"sourcesContent":["import * as path from \"path\";\nimport type {\n  AgentAdapter,\n  AgentDetectionContext,\n  AgentInfo,\n  ConversationMessage,\n  ConversationOptions,\n  ListSessionsOptions,\n  ProcessInfo,\n  SessionSummary,\n} from \"../../adapters/AgentAdapter.js\";\nimport { safeStat } from \"../../utils/session.js\";\nimport { MuseAgentMapper } from \"./MuseAgentMapper.js\";\nimport { MuseSessionLocator } from \"./MuseSessionLocator.js\";\nimport { MuseSessionParser } from \"./MuseSessionParser.js\";\nimport { findHarnessProcesses, homeDir } from \"../shared.js\";\n\nexport interface MuseAdapterOptions {\n  homeDir?: string;\n}\n\n/**\n * Muse (Meta Muse Code) adapter.\n *\n * Detection joins two sources:\n * 1. Live runtime entries (`~/.local/share/muse/runtime/muse/sessions/<id>.json`)\n *    matched to processes by `process_generation_hint: \"pid=<n>\"`.\n * 2. The dated transcript archive (`sessions/yyyy/mm/dd/<uuid>/session.jsonl`).\n *\n * The launcher binary is versioned (`muse-bin-<version>-<build>`), so discovery\n * uses `processNamePrefixes`; `canHandle` keeps the precise shape check.\n */\nexport class MuseAdapter implements AgentAdapter {\n  readonly type = \"muse\" as const;\n  readonly processNames = [\"muse\"] as const;\n  readonly processNamePrefixes = [\"muse\"] as const;\n\n  private readonly home: string;\n  private readonly parser: MuseSessionParser;\n  private readonly mapper: MuseAgentMapper;\n\n  constructor(options: MuseAdapterOptions = {}) {\n    this.home = options.homeDir ?? homeDir();\n    this.parser = new MuseSessionParser();\n    this.mapper = new MuseAgentMapper(this.parser);\n  }\n\n  canHandle(processInfo: ProcessInfo): boolean {\n    const base = path.basename(processInfo.command.trim().split(/\\s+/)[0] ?? \"\").toLowerCase();\n    return base === \"muse\" || base === \"muse.exe\" || base.startsWith(\"muse-bin-\");\n  }\n\n  async detectAgents(context?: AgentDetectionContext): Promise<AgentInfo[]> {\n    try {\n      return await this.detectRunningAgents(context);\n    } finally {\n      this.parser.pruneSessionCache();\n    }\n  }\n\n  private async detectRunningAgents(context?: AgentDetectionContext): Promise<AgentInfo[]> {\n    const { processes } = await findHarnessProcesses(this, context);\n    if (processes.length === 0) return [];\n\n    const { direct, legacyMatches } = this.createLocator().matchRunningProcesses(processes);\n    const matchedPids = new Set([\n      ...direct.map((d) => d.process.pid),\n      ...legacyMatches.map((m) => m.process.pid),\n    ]);\n    const agents: AgentInfo[] = [];\n\n    for (const match of direct) {\n      const sessionData = this.parser.readSessionIncremental(\n        match.sessionFile.filePath,\n        match.sessionFile.resolvedCwd,\n      );\n      if (sessionData) {\n        agents.push(\n          this.mapper.mapSessionToAgent({\n            session: sessionData,\n            processInfo: match.process,\n            sessionFile: match.sessionFile,\n          }),\n        );\n      } else {\n        matchedPids.delete(match.process.pid);\n      }\n    }\n\n    for (const match of legacyMatches) {\n      const sessionData = this.parser.readSessionIncremental(\n        match.session.filePath,\n        match.session.resolvedCwd,\n      );\n      if (sessionData) {\n        agents.push(\n          this.mapper.mapSessionToAgent({\n            session: sessionData,\n            processInfo: match.process,\n            sessionFile: match.session,\n          }),\n        );\n      } else {\n        matchedPids.delete(match.process.pid);\n      }\n    }\n\n    for (const proc of processes) {\n      if (!matchedPids.has(proc.pid)) {\n        agents.push(this.mapper.mapProcessOnlyAgent(proc));\n      }\n    }\n    return agents;\n  }\n\n  private createLocator(): MuseSessionLocator {\n    return new MuseSessionLocator({ homeDir: this.home });\n  }\n\n  getConversation(sessionFilePath: string, options?: ConversationOptions): ConversationMessage[] {\n    return this.parser.getConversation(sessionFilePath, options);\n  }\n\n  async listSessions(opts?: ListSessionsOptions): Promise<SessionSummary[]> {\n    const filterCwd = opts?.cwd;\n    const summaries: SessionSummary[] = [];\n    for (const { filePath, defaultCwd } of this.createLocator().discoverHistoricalSessionFiles()) {\n      const summary = this.toSessionSummary(filePath, defaultCwd);\n      if (!summary) continue;\n      if (filterCwd !== undefined && summary.cwd !== filterCwd) continue;\n      summaries.push(summary);\n    }\n    return summaries;\n  }\n\n  async findSessionsById(sessionId: string): Promise<SessionSummary[]> {\n    return this.createLocator()\n      .findHistoricalSessionFilesById(sessionId)\n      .map(({ filePath, defaultCwd }) => this.toSessionSummary(filePath, defaultCwd))\n      .filter((summary): summary is SessionSummary => summary?.sessionId === sessionId);\n  }\n\n  private toSessionSummary(filePath: string, defaultCwd: string): SessionSummary | null {\n    const session = this.parser.readSession(filePath, defaultCwd);\n    if (!session?.lastSignal && !session?.firstUserMessage) return null;\n    const stat = safeStat(filePath);\n    return {\n      type: \"muse\",\n      sessionId: session.sessionId,\n      cwd: session.projectPath || defaultCwd,\n      firstUserMessage: session.firstUserMessage || \"\",\n      lastActive: session.lastActive ?? stat?.mtime ?? new Date(),\n      startedAt: session.sessionStart ?? stat?.birthtime ?? stat?.mtime ?? new Date(),\n      sessionFilePath: filePath,\n    };\n  }\n}\n"],"names":["path","safeStat","MuseAgentMapper","MuseSessionLocator","MuseSessionParser","findHarnessProcesses","homeDir","MuseAdapter","type","processNames","processNamePrefixes","home","parser","mapper","options","canHandle","processInfo","base","basename","command","trim","split","toLowerCase","startsWith","detectAgents","context","detectRunningAgents","pruneSessionCache","processes","length","direct","legacyMatches","createLocator","matchRunningProcesses","matchedPids","Set","map","d","process","pid","m","agents","match","sessionData","readSessionIncremental","sessionFile","filePath","resolvedCwd","push","mapSessionToAgent","session","delete","proc","has","mapProcessOnlyAgent","getConversation","sessionFilePath","listSessions","opts","filterCwd","cwd","summaries","defaultCwd","discoverHistoricalSessionFiles","summary","toSessionSummary","undefined","findSessionsById","sessionId","findHistoricalSessionFilesById","filter","readSession","lastSignal","firstUserMessage","stat","projectPath","lastActive","mtime","Date","startedAt","sessionStart","birthtime"],"mappings":"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"}

package/dist/harnesses/muse/MuseAgentMapper.d.ts

@@ -0,0 +1,15 @@
+import type { AgentInfo, ProcessInfo } from "../../adapters/AgentAdapter.js";
+import type { SessionFile } from "../../utils/session.js";
+import { MuseSessionParser, type MuseSession } from "./MuseSessionParser.js";
+export interface MuseSessionAgentInput {
+    session: MuseSession;
+    processInfo: ProcessInfo;
+    sessionFile: SessionFile;
+}
+export declare class MuseAgentMapper {
+    private readonly parser;
+    constructor(parser?: MuseSessionParser);
+    mapSessionToAgent({ session, processInfo, sessionFile }: MuseSessionAgentInput): AgentInfo;
+    mapProcessOnlyAgent(processInfo: ProcessInfo): AgentInfo;
+}
+//# sourceMappingURL=MuseAgentMapper.d.ts.map

package/dist/harnesses/muse/MuseAgentMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MuseAgentMapper.d.ts","sourceRoot":"","sources":["../../../src/harnesses/muse/MuseAgentMapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAE7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG7E,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,GAAE,iBAA2C;IAEhF,iBAAiB,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE,qBAAqB,GAAG,SAAS;IAc1F,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,SAAS;CAGzD"}

package/dist/harnesses/muse/MuseAgentMapper.js

@@ -0,0 +1,29 @@
+import { generateAgentName } from "../../utils/matching.js";
+import { MuseSessionParser } from "./MuseSessionParser.js";
+import { processOnlyAgent } from "../shared.js";
+export class MuseAgentMapper {
+    parser;
+    constructor(parser = new MuseSessionParser()){
+        this.parser = parser;
+    }
+    mapSessionToAgent({ session, processInfo, sessionFile }) {
+        return {
+            name: generateAgentName(processInfo.cwd, processInfo.pid),
+            type: "muse",
+            status: this.parser.determineStatus(session),
+            summary: session.lastUserMessage || "Session started",
+            pid: processInfo.pid,
+            projectPath: session.projectPath || sessionFile.resolvedCwd || processInfo.cwd || "",
+            sessionId: sessionFile.sessionId,
+            lastActive: session.lastActive,
+            sessionFilePath: sessionFile.filePath
+        };
+    }
+    mapProcessOnlyAgent(processInfo) {
+        return processOnlyAgent("muse", processInfo, {
+            summary: "Muse process running"
+        });
+    }
+}
+
+//# sourceMappingURL=MuseAgentMapper.js.map

package/dist/harnesses/muse/MuseAgentMapper.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/harnesses/muse/MuseAgentMapper.ts"],"sourcesContent":["import type { AgentInfo, ProcessInfo } from \"../../adapters/AgentAdapter.js\";\nimport { generateAgentName } from \"../../utils/matching.js\";\nimport type { SessionFile } from \"../../utils/session.js\";\nimport { MuseSessionParser, type MuseSession } from \"./MuseSessionParser.js\";\nimport { processOnlyAgent } from \"../shared.js\";\n\nexport interface MuseSessionAgentInput {\n  session: MuseSession;\n  processInfo: ProcessInfo;\n  sessionFile: SessionFile;\n}\n\nexport class MuseAgentMapper {\n  constructor(private readonly parser: MuseSessionParser = new MuseSessionParser()) {}\n\n  mapSessionToAgent({ session, processInfo, sessionFile }: MuseSessionAgentInput): AgentInfo {\n    return {\n      name: generateAgentName(processInfo.cwd, processInfo.pid),\n      type: \"muse\",\n      status: this.parser.determineStatus(session),\n      summary: session.lastUserMessage || \"Session started\",\n      pid: processInfo.pid,\n      projectPath: session.projectPath || sessionFile.resolvedCwd || processInfo.cwd || \"\",\n      sessionId: sessionFile.sessionId,\n      lastActive: session.lastActive,\n      sessionFilePath: sessionFile.filePath,\n    };\n  }\n\n  mapProcessOnlyAgent(processInfo: ProcessInfo): AgentInfo {\n    return processOnlyAgent(\"muse\", processInfo, { summary: \"Muse process running\" });\n  }\n}\n"],"names":["generateAgentName","MuseSessionParser","processOnlyAgent","MuseAgentMapper","parser","mapSessionToAgent","session","processInfo","sessionFile","name","cwd","pid","type","status","determineStatus","summary","lastUserMessage","projectPath","resolvedCwd","sessionId","lastActive","sessionFilePath","filePath","mapProcessOnlyAgent"],"mappings":"AACA,SAASA,iBAAiB,QAAQ,0BAA0B;AAE5D,SAASC,iBAAiB,QAA0B,yBAAyB;AAC7E,SAASC,gBAAgB,QAAQ,eAAe;AAQhD,OAAO,MAAMC;;IACX,YAAY,AAAiBC,SAA4B,IAAIH,mBAAmB,CAAE;aAArDG,SAAAA;IAAsD;IAEnFC,kBAAkB,EAAEC,OAAO,EAAEC,WAAW,EAAEC,WAAW,EAAyB,EAAa;QACzF,OAAO;YACLC,MAAMT,kBAAkBO,YAAYG,GAAG,EAAEH,YAAYI,GAAG;YACxDC,MAAM;YACNC,QAAQ,IAAI,CAACT,MAAM,CAACU,eAAe,CAACR;YACpCS,SAAST,QAAQU,eAAe,IAAI;YACpCL,KAAKJ,YAAYI,GAAG;YACpBM,aAAaX,QAAQW,WAAW,IAAIT,YAAYU,WAAW,IAAIX,YAAYG,GAAG,IAAI;YAClFS,WAAWX,YAAYW,SAAS;YAChCC,YAAYd,QAAQc,UAAU;YAC9BC,iBAAiBb,YAAYc,QAAQ;QACvC;IACF;IAEAC,oBAAoBhB,WAAwB,EAAa;QACvD,OAAOL,iBAAiB,QAAQK,aAAa;YAAEQ,SAAS;QAAuB;IACjF;AACF"}

package/dist/harnesses/muse/MuseSessionLocator.d.ts

@@ -0,0 +1,61 @@
+import type { ProcessInfo } from "../../adapters/AgentAdapter.js";
+import { type MatchResult } from "../../utils/matching.js";
+import { type SessionFile } from "../../utils/session.js";
+/** Entry in `~/.local/share/muse/runtime/muse/sessions/<session-id>.json`. */
+export interface MuseRuntimeEntry {
+    sessionId: string;
+    pid: number;
+}
+/** A live Muse process paired with its transcript through the runtime file. */
+export interface MuseDirectMatch {
+    process: ProcessInfo;
+    sessionFile: SessionFile;
+}
+export interface MuseProcessSessionMatches {
+    direct: MuseDirectMatch[];
+    legacyMatches: MatchResult[];
+    /** Muse processes no strategy could pair (become process-only agents). */
+    fallback: ProcessInfo[];
+}
+export interface MuseSessionLocatorOptions {
+    homeDir?: string;
+    runtimeDir?: string;
+    archiveDir?: string;
+}
+export declare class MuseSessionLocator {
+    private readonly home;
+    private readonly runtimeDir;
+    private readonly archiveDir;
+    constructor(options?: MuseSessionLocatorOptions);
+    /**
+     * Pair live Muse processes with transcripts.
+     *
+     * Two staged strategies, each handing unmatched processes onward:
+     * 1. Runtime-file matching via `runtime/muse/sessions/<id>.json`
+     *    (authoritative; guarded against recycled pids).
+     * 2. Legacy cwd+birthtime heuristic over recent transcripts.
+     */
+    matchRunningProcesses(processes: ProcessInfo[]): MuseProcessSessionMatches;
+    private tryRuntimeFileMatching;
+    /** Recent transcripts for legacy cwd+birthtime matching (today-first, bounded). */
+    discoverLiveSessions(processes: ProcessInfo[]): SessionFile[];
+    /**
+     * Every archived transcript: walks `sessions/yyyy/mm/dd/<uuid>/session.jsonl`.
+     * Only directories matching the session-id pattern that contain a transcript
+     * are returned; `subagent/`, logs, and databases never match.
+     */
+    discoverHistoricalSessionFiles(): Array<{
+        filePath: string;
+        defaultCwd: string;
+    }>;
+    findHistoricalSessionFilesById(sessionId: string): Array<{
+        filePath: string;
+        defaultCwd: string;
+    }>;
+    /** Exact transcript lookup by session id across dated dirs. */
+    findTranscriptById(sessionId: string): string | null;
+    private walkTranscripts;
+    /** Dated directories `sessions/yyyy/mm/dd`, each level guarded by a pattern. */
+    private listDayDirs;
+}
+//# sourceMappingURL=MuseSessionLocator.d.ts.map

package/dist/harnesses/muse/MuseSessionLocator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MuseSessionLocator.d.ts","sourceRoot":"","sources":["../../../src/harnesses/muse/MuseSessionLocator.ts"],"names":[],"mappings":"AAEA,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;AAGhC,8EAA8E;AAC9E,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,0EAA0E;IAC1E,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA6ED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,OAAO,GAAE,yBAA8B;IAOnD;;;;;;;OAOG;IACH,qBAAqB,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,yBAAyB;IAmB1E,OAAO,CAAC,sBAAsB;IAyC9B,mFAAmF;IACnF,oBAAoB,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE;IA2B7D;;;;OAIG;IACH,8BAA8B,IAAI,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAQjF,8BAA8B,CAC5B,SAAS,EAAE,MAAM,GAChB,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAMlD,+DAA+D;IAC/D,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IASpD,OAAO,CAAC,eAAe;IAYvB,gFAAgF;IAChF,OAAO,CAAC,WAAW;CAoBpB"}

package/dist/harnesses/muse/MuseSessionLocator.js

@@ -0,0 +1,233 @@
+import * as fs from "fs";
+import * as path from "path";
+import { matchProcessesToSessions } from "../../utils/matching.js";
+import { isDirectory, isSafePathSegment, safeReaddir, safeStat } from "../../utils/session.js";
+import { homeDir } from "../shared.js";
+/** Session ids are UUID-shaped; anything else is never a session dir. */ const SESSION_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/** Maximum |process start − transcript birth| before a pid match is recycled. */ const PID_STALENESS_MS = 60000;
+function parsePidHint(value) {
+    if (typeof value !== "string") return null;
+    const match = /^pid=(\d+)$/.exec(value.trim());
+    return match ? Number(match[1]) : null;
+}
+function parseRuntimeEntry(filePath) {
+    let raw;
+    try {
+        raw = fs.readFileSync(filePath, "utf-8");
+    } catch  {
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    } catch  {
+        return null;
+    }
+    if (!parsed || typeof parsed !== "object") return null;
+    const entry = parsed;
+    const sessionId = typeof entry.session_id === "string" ? entry.session_id : null;
+    const pid = parsePidHint(entry.process_generation_hint);
+    if (!sessionId || !SESSION_ID_PATTERN.test(sessionId) || pid === null) return null;
+    return {
+        sessionId,
+        pid
+    };
+}
+/** Head-read a transcript for its recorded workspace root (bounded, cheap). */ function readWorkspaceRootHead(filePath, maxBytes = 8192) {
+    let fd;
+    try {
+        fd = fs.openSync(filePath, "r");
+    } catch  {
+        return null;
+    }
+    try {
+        const stat = fs.fstatSync(fd);
+        const buf = Buffer.alloc(Math.min(maxBytes, stat.size));
+        fs.readSync(fd, buf, 0, buf.length, 0);
+        const text = buf.toString("utf-8");
+        for (const line of text.split("\n")){
+            if (!line.includes("runtime.session.metadata")) continue;
+            try {
+                const outer = JSON.parse(line);
+                const inner = typeof outer.record_json === "string" ? JSON.parse(outer.record_json) : outer;
+                const root = inner.payload?.record?.workspace_root;
+                if (typeof root === "string" && root) return root;
+            } catch  {
+            /* keep scanning */ }
+        }
+        return null;
+    } catch  {
+        return null;
+    } finally{
+        try {
+            fs.closeSync(fd);
+        } catch  {
+        /* best effort */ }
+    }
+}
+export class MuseSessionLocator {
+    home;
+    runtimeDir;
+    archiveDir;
+    constructor(options = {}){
+        this.home = options.homeDir ?? homeDir();
+        const store = path.join(this.home, ".local", "share", "muse");
+        this.runtimeDir = options.runtimeDir ?? path.join(store, "runtime", "muse", "sessions");
+        this.archiveDir = options.archiveDir ?? path.join(store, "sessions");
+    }
+    /**
+   * Pair live Muse processes with transcripts.
+   *
+   * Two staged strategies, each handing unmatched processes onward:
+   * 1. Runtime-file matching via `runtime/muse/sessions/<id>.json`
+   *    (authoritative; guarded against recycled pids).
+   * 2. Legacy cwd+birthtime heuristic over recent transcripts.
+   */ matchRunningProcesses(processes) {
+        // Callers pass muse processes only (the adapter pre-filters via canHandle).
+        const { direct, fallback: noDirect } = this.tryRuntimeFileMatching(processes);
+        const legacySessions = this.discoverLiveSessions(noDirect);
+        const legacyMatches = noDirect.length > 0 && legacySessions.length > 0 ? matchProcessesToSessions(noDirect, legacySessions) : [];
+        const matchedPids = new Set([
+            ...direct.map((d)=>d.process.pid),
+            ...legacyMatches.map((m)=>m.process.pid)
+        ]);
+        return {
+            direct,
+            legacyMatches,
+            fallback: noDirect.filter((p)=>!matchedPids.has(p.pid))
+        };
+    }
+    tryRuntimeFileMatching(processes) {
+        const byPid = new Map();
+        for (const proc of processes){
+            if (!byPid.has(proc.pid)) byPid.set(proc.pid, proc);
+        }
+        const direct = [];
+        const usedPids = new Set();
+        if (!isDirectory(this.runtimeDir)) return {
+            direct,
+            fallback: processes
+        };
+        for (const name of safeReaddir(this.runtimeDir)){
+            if (!name.endsWith(".json")) continue;
+            const entry = parseRuntimeEntry(path.join(this.runtimeDir, name));
+            if (!entry) continue;
+            const proc = byPid.get(entry.pid);
+            if (!proc || usedPids.has(proc.pid)) continue;
+            const transcript = this.findTranscriptById(entry.sessionId);
+            if (!transcript) continue;
+            // Guard against pid recycling: the live process must have started
+            // around the transcript's creation.
+            const birth = safeStat(transcript)?.birthtimeMs;
+            const start = proc.startTime?.getTime();
+            if (birth === undefined || start === undefined) continue;
+            if (Math.abs(start - birth) > PID_STALENESS_MS) continue;
+            usedPids.add(proc.pid);
+            direct.push({
+                process: proc,
+                sessionFile: {
+                    sessionId: entry.sessionId,
+                    filePath: transcript,
+                    projectDir: path.dirname(transcript),
+                    birthtimeMs: birth,
+                    resolvedCwd: proc.cwd ?? ""
+                }
+            });
+        }
+        return {
+            direct,
+            fallback: processes.filter((p)=>!usedPids.has(p.pid))
+        };
+    }
+    /** Recent transcripts for legacy cwd+birthtime matching (today-first, bounded). */ discoverLiveSessions(processes) {
+        const cwds = new Set(processes.map((p)=>p.cwd).filter((cwd)=>!!cwd));
+        if (cwds.size === 0 || !isDirectory(this.archiveDir)) return [];
+        const dayDirs = this.listDayDirs().slice(-2);
+        const sessionFiles = [];
+        for (const dayDir of dayDirs){
+            for (const name of safeReaddir(dayDir)){
+                if (!SESSION_ID_PATTERN.test(name)) continue;
+                const filePath = path.join(dayDir, name, "session.jsonl");
+                const stat = safeStat(filePath);
+                if (!stat?.isFile() || !Number.isFinite(stat.birthtimeMs) || stat.birthtimeMs <= 0) {
+                    continue;
+                }
+                const workspaceRoot = readWorkspaceRootHead(filePath);
+                if (!workspaceRoot || !cwds.has(workspaceRoot)) continue;
+                sessionFiles.push({
+                    sessionId: name,
+                    filePath,
+                    projectDir: path.dirname(filePath),
+                    birthtimeMs: stat.birthtimeMs,
+                    resolvedCwd: workspaceRoot
+                });
+            }
+        }
+        return sessionFiles;
+    }
+    /**
+   * Every archived transcript: walks `sessions/yyyy/mm/dd/<uuid>/session.jsonl`.
+   * Only directories matching the session-id pattern that contain a transcript
+   * are returned; `subagent/`, logs, and databases never match.
+   */ discoverHistoricalSessionFiles() {
+        const out = [];
+        for (const filePath of this.walkTranscripts()){
+            out.push({
+                filePath,
+                defaultCwd: ""
+            });
+        }
+        return out;
+    }
+    findHistoricalSessionFilesById(sessionId) {
+        if (!isSafePathSegment(sessionId) || !SESSION_ID_PATTERN.test(sessionId)) return [];
+        const filePath = this.findTranscriptById(sessionId);
+        return filePath ? [
+            {
+                filePath,
+                defaultCwd: ""
+            }
+        ] : [];
+    }
+    /** Exact transcript lookup by session id across dated dirs. */ findTranscriptById(sessionId) {
+        if (!isSafePathSegment(sessionId) || !SESSION_ID_PATTERN.test(sessionId)) return null;
+        for (const dayDir of this.listDayDirs()){
+            const filePath = path.join(dayDir, sessionId, "session.jsonl");
+            if (safeStat(filePath)?.isFile()) return filePath;
+        }
+        return null;
+    }
+    walkTranscripts() {
+        const out = [];
+        for (const dayDir of this.listDayDirs()){
+            for (const name of safeReaddir(dayDir)){
+                if (!SESSION_ID_PATTERN.test(name)) continue;
+                const filePath = path.join(dayDir, name, "session.jsonl");
+                if (safeStat(filePath)?.isFile()) out.push(filePath);
+            }
+        }
+        return out;
+    }
+    /** Dated directories `sessions/yyyy/mm/dd`, each level guarded by a pattern. */ listDayDirs() {
+        const out = [];
+        if (!isDirectory(this.archiveDir)) return out;
+        for (const yyyy of safeReaddir(this.archiveDir)){
+            if (!/^\d{4}$/.test(yyyy)) continue;
+            const yDir = path.join(this.archiveDir, yyyy);
+            if (!isDirectory(yDir)) continue;
+            for (const mm of safeReaddir(yDir)){
+                if (!/^\d{2}$/.test(mm)) continue;
+                const mDir = path.join(yDir, mm);
+                if (!isDirectory(mDir)) continue;
+                for (const dd of safeReaddir(mDir)){
+                    if (!/^\d{2}$/.test(dd)) continue;
+                    const dDir = path.join(mDir, dd);
+                    if (isDirectory(dDir)) out.push(dDir);
+                }
+            }
+        }
+        return out;
+    }
+}
+
+//# sourceMappingURL=MuseSessionLocator.js.map