@ai-devkit/agent-manager 0.41.0 → 0.42.0

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

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

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

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

@@ -0,0 +1,77 @@
+import type { ConversationMessage, ConversationOptions } from "../../adapters/AgentAdapter.js";
+import { AgentStatus } from "../../adapters/AgentAdapter.js";
+/**
+ * A single unwrapped inner record from a Muse session frame.
+ *
+ * Each session.jsonl line is one of: a direct inner record, a
+ * `{ record_json: string }` envelope, or a `retained_frame` wrapper whose
+ * `children[]` carry `record_json` strings. Inner records dispatch on
+ * `payload_type`; timestamps (`recorded_at`) are microseconds.
+ */
+export interface MuseInnerRecord {
+    stream?: {
+        kind?: string;
+        id?: string;
+    };
+    sequence?: number;
+    recorded_at?: number;
+    record_type?: string;
+    payload_type?: string;
+    payload?: Record<string, unknown>;
+}
+/** Parsed session state extracted from a Muse transcript. */
+export interface MuseSession {
+    sessionId: string;
+    projectPath: string;
+    /** Last display name from `session.name.changed`, when present. */
+    displayName?: string;
+    modelId?: string;
+    sessionStart: Date;
+    lastActive: Date;
+    /** Last conversation signal: user-intent, assistant reply, approval, tool batch… */
+    lastSignal?: string;
+    lastUserMessage?: string;
+    /** First meaningful user prompt in the session. */
+    firstUserMessage?: string;
+}
+/** `recorded_at` microseconds → epoch ms; null when invalid. */
+export declare function museTimestampToMs(value: unknown): number | null;
+/** Unwrap one raw frame line into zero or more inner records. */
+export declare function unwrapFrameRecords(line: string): MuseInnerRecord[];
+/** Unwrap an already-parsed frame value into zero or more inner records. */
+export declare function unwrapOuterRecords(outer: unknown): MuseInnerRecord[];
+export declare class MuseSessionParser {
+    private readonly tailReader;
+    private readonly sessionCache;
+    constructor();
+    readSession(filePath: string, projectPath: string): MuseSession | null;
+    readSessionIncremental(filePath: string, projectPath: string): MuseSession | null;
+    pruneSessionCache(): void;
+    private readonly summaryReducer;
+    /**
+     * Fold one inner record into the summary. `isHead` marks the first line
+     * (session start only); `canBeFirst` allows the first user message from any
+     * line read before a bounded-skip.
+     */
+    private foldRecord;
+    private toSession;
+    /**
+     * Status mapping over the last conversation signal:
+     * - user-intent → RUNNING (agent is processing the new turn)
+     * - assistant → WAITING (reply committed, awaiting user)
+     * - approval-wait / input-requested → WAITING (blocked on the user)
+     * - run-terminal → IDLE; no signal → UNKNOWN.
+     */
+    determineStatus(session: MuseSession): AgentStatus;
+    getConversation(sessionFilePath: string, options?: ConversationOptions): ConversationMessage[];
+    /** One raw frame line → conversation messages (usually zero or one). */
+    private linesToMessages;
+    /**
+     * One raw frame line → its first conversation message, for tail reads.
+     * A retained frame can theoretically hold several messages; the tail
+     * window counts lines, so a boundary line keeps only its first message.
+     */
+    private lineToMessage;
+    private recordToMessage;
+}
+//# sourceMappingURL=MuseSessionParser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MuseSessionParser.d.ts","sourceRoot":"","sources":["../../../src/harnesses/muse/MuseSessionParser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC/F,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAQ7D;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,6DAA6D;AAC7D,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,IAAI,CAAC;IACnB,UAAU,EAAE,IAAI,CAAC;IACjB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AA2ED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAI/D;AAED,iEAAiE;AACjE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE,CAQlE;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CA6BpE;AA4CD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IACpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4C;;IAMzE,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAWtE,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAKjF,iBAAiB,IAAI,IAAI;IAIzB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAkB7B;IAEF;;;;OAIG;IACH,OAAO,CAAC,UAAU;IA2DlB,OAAO,CAAC,SAAS;IAejB;;;;;;OAMG;IACH,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW;IAelD,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,EAAE;IAwB9F,wEAAwE;IACxE,OAAO,CAAC,eAAe;IASvB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,eAAe;CAiCxB"}