@samjurnio_/memento 0.2.0

package/dist/adapters/gemini.js

@@ -0,0 +1,171 @@
+import { readdirSync, readFileSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { truncate, cleanUserMessage } from "../ledger.js";
+import { extractTarget } from "./claude-code.js";
+/**
+ * Gemini CLI adapter: normalizes a /chat-save checkpoint
+ * (~/.gemini/tmp/<project_hash>/chats/checkpoint-<tag>.json) into a ledger.
+ *
+ * Format (GenAI Content array — research-derived, NOT yet validated against
+ * a real local file; none existed on the dev machine):
+ *   [{role: "user"|"model", parts: [{text} | {functionCall: {name, args}}
+ *     | {functionResponse: {name, response}}]}]
+ *
+ * Caveats vs the other adapters:
+ *  - No call ids: functionResponse is correlated to the oldest unmatched
+ *    functionCall with the same name (synthetic callIds by arrival order).
+ *  - No cwd in the format: workspace-scoped auto-discovery is impossible
+ *    (the project-hash derivation is undocumented), so discovery returns the
+ *    newest checkpoint across ALL projects — prefer --transcript here.
+ */
+const OUTCOME_MAX = 400;
+const MESSAGE_MAX = 2000;
+export function parseGeminiCheckpoint(json, sourcePath) {
+    const events = [];
+    let seq = 0;
+    let sawUserMessage = false;
+    let callCounter = 0;
+    // name → queue of unmatched synthetic callIds, oldest first.
+    const pendingByName = new Map();
+    const push = (event) => {
+        events.push({ ...event, seq: seq++ });
+    };
+    let contents;
+    try {
+        const parsed = JSON.parse(json);
+        contents = Array.isArray(parsed)
+            ? parsed
+            // Some versions wrap the array: {history: [...]} / {messages: [...]}
+            : parsed.history
+                ?? parsed.messages
+                ?? [];
+    }
+    catch {
+        contents = [];
+    }
+    for (const content of contents) {
+        if (!content || !Array.isArray(content.parts)) {
+            continue;
+        }
+        const role = content.role === "model" ? "model" : "user";
+        for (const part of content.parts) {
+            if (typeof part?.text === "string" && part.text.trim()) {
+                if (role === "user") {
+                    const cleanedText = cleanUserMessage(part.text);
+                    if (cleanedText) {
+                        if (!sawUserMessage) {
+                            sawUserMessage = true;
+                            push({ type: "task.started", content: truncate(cleanedText, MESSAGE_MAX) });
+                        }
+                        push({ type: "message.user", content: truncate(cleanedText, MESSAGE_MAX) });
+                    }
+                }
+                else {
+                    push({ type: "message.assistant", content: truncate(part.text, MESSAGE_MAX) });
+                }
+                continue;
+            }
+            if (part?.functionCall?.name) {
+                const callId = `gem_${callCounter++}`;
+                const queue = pendingByName.get(part.functionCall.name) ?? [];
+                queue.push(callId);
+                pendingByName.set(part.functionCall.name, queue);
+                const tool = {
+                    name: part.functionCall.name,
+                    callId,
+                    ...(part.functionCall.args !== undefined ? { input: part.functionCall.args } : {}),
+                    ...(extractTarget(part.functionCall.args)
+                        ? { target: extractTarget(part.functionCall.args) }
+                        : {}),
+                };
+                push({ type: "tool.called", tool });
+                continue;
+            }
+            if (part?.functionResponse?.name) {
+                const name = part.functionResponse.name;
+                const callId = pendingByName.get(name)?.shift();
+                const { outcome, isError } = describeResponse(part.functionResponse.response);
+                const tool = {
+                    name,
+                    outcome,
+                    isError,
+                    ...(callId ? { callId } : {}),
+                };
+                push({ type: isError ? "tool.failed" : "tool.completed", tool });
+            }
+        }
+    }
+    return {
+        sessionId: sourcePath ? basenameNoExt(sourcePath) : "unknown",
+        agent: "gemini-cli",
+        ...(sourcePath ? { sourcePath } : {}),
+        events,
+    };
+}
+function describeResponse(response) {
+    if (response === null || response === undefined) {
+        return { outcome: "(no output)", isError: false };
+    }
+    if (typeof response === "string") {
+        return { outcome: truncate(response, OUTCOME_MAX), isError: false };
+    }
+    const record = response;
+    const isError = record.error !== undefined && record.error !== null;
+    const body = record.output ?? record.content ?? record.error ?? response;
+    const text = typeof body === "string" ? body : JSON.stringify(body);
+    return { outcome: truncate(text, OUTCOME_MAX), isError };
+}
+function basenameNoExt(path) {
+    const base = path.split("/").pop() ?? path;
+    return base.replace(/\.json$/, "");
+}
+/**
+ * Newest checkpoint across ALL Gemini projects. The checkpoint format
+ * carries no cwd and the project-hash derivation is undocumented, so this
+ * cannot be workspace-scoped — pass an explicit --transcript when precision
+ * matters.
+ */
+export function latestGeminiCheckpoint(home = homedir()) {
+    const root = join(home, ".gemini", "tmp");
+    const candidates = [];
+    let hashes;
+    try {
+        hashes = readdirSync(root);
+    }
+    catch {
+        return undefined;
+    }
+    for (const hash of hashes) {
+        for (const dir of [join(root, hash, "chats"), join(root, hash)]) {
+            let entries;
+            try {
+                entries = readdirSync(dir);
+            }
+            catch {
+                continue;
+            }
+            for (const name of entries) {
+                if (!name.endsWith(".json")) {
+                    continue;
+                }
+                const full = join(dir, name);
+                try {
+                    const stat = statSync(full);
+                    if (stat.isFile()) {
+                        candidates.push({ path: full, mtime: stat.mtimeMs });
+                    }
+                }
+                catch {
+                    continue;
+                }
+            }
+        }
+    }
+    candidates.sort((a, b) => b.mtime - a.mtime);
+    return candidates[0]?.path;
+}
+export function loadGeminiLedger(checkpointPath) {
+    return parseGeminiCheckpoint(readFileSync(checkpointPath, "utf8"), checkpointPath);
+}
+//# sourceMappingURL=gemini.js.map

package/dist/adapters/gemini.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.js","sourceRoot":"","sources":["../../src/adapters/gemini.ts"],"names":[],"mappings":"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"}

package/dist/adapters/opencode.d.ts

@@ -0,0 +1,3 @@
+import { type Ledger } from "../ledger.js";
+export declare function loadOpencodeLedger(messageDir: string): Ledger;
+export declare function latestOpencodeSession(_workspaceDir: string, home?: string): string | undefined;

package/dist/adapters/opencode.js

@@ -0,0 +1,137 @@
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, join } from "node:path";
+import { truncate } from "../ledger.js";
+const MESSAGE_MAX = 4000;
+/**
+ * opencode (github.com/sst/opencode) stores a session as many JSON files, not a
+ * single transcript:
+ *   <storage>/message/<sessionID>/msg_*.json  → { id, sessionID, role, time }
+ *   <storage>/part/<messageID>/prt_*.json     → { type: "text", text }  or
+ *                                                { type: "tool", tool, callID, state }
+ * The adapter's "path" is therefore the session's message directory; we read its
+ * messages (ordered by time.created) and each message's parts.
+ */
+function storageRootFor(messageDir) {
+    // <storage>/message/<sessionID>  →  <storage>
+    return join(messageDir, "..", "..");
+}
+function readJson(path) {
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+function partsForMessage(storageRoot, messageId) {
+    const dir = join(storageRoot, "part", messageId);
+    let files;
+    try {
+        files = readdirSync(dir).filter((f) => f.endsWith(".json")).sort();
+    }
+    catch {
+        return [];
+    }
+    return files.map((f) => readJson(join(dir, f))).filter((p) => p !== undefined);
+}
+export function loadOpencodeLedger(messageDir) {
+    const sessionId = basename(messageDir);
+    const storageRoot = storageRootFor(messageDir);
+    let msgFiles;
+    try {
+        msgFiles = readdirSync(messageDir).filter((f) => f.endsWith(".json"));
+    }
+    catch {
+        msgFiles = [];
+    }
+    const messages = msgFiles
+        .map((f) => readJson(join(messageDir, f)))
+        .filter((m) => m !== undefined)
+        .sort((a, b) => {
+        const ta = (a.time?.created) ?? 0;
+        const tb = (b.time?.created) ?? 0;
+        if (ta !== tb)
+            return ta - tb;
+        return String(a.id).localeCompare(String(b.id));
+    });
+    const events = [];
+    let seq = 0;
+    const push = (event) => {
+        events.push({ ...event, seq: seq++ });
+    };
+    let sawUser = false;
+    for (const msg of messages) {
+        const role = msg.role;
+        const created = msg.time?.created;
+        const at = typeof created === "number" ? { at: new Date(created).toISOString() } : {};
+        const parts = partsForMessage(storageRoot, String(msg.id));
+        for (const part of parts) {
+            if (part.type === "text" && typeof part.text === "string" && part.text.trim()) {
+                const text = truncate(part.text.trim(), MESSAGE_MAX);
+                if (role === "user") {
+                    if (!sawUser) {
+                        push({ type: "task.started", content: text, ...at });
+                        sawUser = true;
+                    }
+                    else {
+                        push({ type: "message.user", content: text, ...at });
+                    }
+                }
+                else if (role === "assistant") {
+                    push({ type: "message.assistant", content: text, ...at });
+                }
+            }
+            else if (part.type === "tool") {
+                const state = part.state ?? {};
+                const name = typeof part.tool === "string" ? part.tool : "tool";
+                const callId = typeof part.callID === "string" ? part.callID : undefined;
+                push({ type: "tool.called", tool: { name, ...(callId ? { callId } : {}), input: state.input }, ...at });
+                if (state.status && state.status !== "running" && state.status !== "pending") {
+                    const isError = state.status === "error";
+                    push({
+                        type: isError ? "tool.failed" : "tool.completed",
+                        tool: { name, ...(callId ? { callId } : {}), outcome: truncate(String(state.output ?? ""), MESSAGE_MAX), ...(isError ? { isError: true } : {}) },
+                        ...at,
+                    });
+                }
+            }
+        }
+    }
+    return { sessionId, agent: "opencode", sourcePath: messageDir, events };
+}
+function opencodeStorage(home) {
+    return join(home, ".local", "share", "opencode", "storage");
+}
+export function latestOpencodeSession(_workspaceDir, home = homedir()) {
+    // opencode discovery is not workspace-scoped (sessions live in a global
+    // store); pass an explicit session message dir to target a specific one.
+    const messageRoot = join(opencodeStorage(home), "message");
+    if (!existsSync(messageRoot))
+        return undefined;
+    let sessionDirs;
+    try {
+        sessionDirs = readdirSync(messageRoot).filter((d) => d.startsWith("ses_"));
+    }
+    catch {
+        return undefined;
+    }
+    let best;
+    for (const d of sessionDirs) {
+        const full = join(messageRoot, d);
+        try {
+            // newest mtime across the session's message files
+            const files = readdirSync(full);
+            let m = 0;
+            for (const f of files)
+                m = Math.max(m, statSync(join(full, f)).mtimeMs);
+            if (!best || m > best.mtime)
+                best = { path: full, mtime: m };
+        }
+        catch {
+            continue;
+        }
+    }
+    return best?.path;
+}
+//# sourceMappingURL=opencode.js.map

package/dist/adapters/opencode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.js","sourceRoot":"","sources":["../../src/adapters/opencode.ts"],"names":[],"mappings":"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"}

package/dist/adapters/pi.d.ts

@@ -0,0 +1,6 @@
+import { type Ledger } from "../ledger.js";
+export declare function parsePiSession(jsonl: string, sourcePath?: string): Ledger;
+/** Fill tool.completed names from the tool.called that shares its callId. */
+export declare function resolvePiToolNames(ledger: Ledger): Ledger;
+export declare function latestPiSession(workspaceDir: string, home?: string): string | undefined;
+export declare function loadPiLedger(sessionPath: string): Ledger;

package/dist/adapters/pi.js

@@ -0,0 +1,172 @@
+import { readdirSync, readFileSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, join } from "node:path";
+import { truncate } from "../ledger.js";
+const MESSAGE_MAX = 4000;
+const DISCOVERY_SCAN_LIMIT = 50;
+/**
+ * Pi (github.com/earendil-works/pi) persists a session as JSONL of SessionEntry
+ * objects. Message entries are `{ type: "message", message: Message }` where a
+ * Message is one of:
+ *   - { role: "user",       content: string | Part[] }
+ *   - { role: "assistant",  content: Part[] }   (text, thinking, and toolCall parts)
+ *   - { role: "toolResult", toolCallId, content: Part[] }
+ * Text parts are `{ type: "text", text }`; tool calls are parts on the assistant
+ * message carrying a name + arguments + id.
+ */
+function partsToText(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return "";
+    return content
+        .filter((p) => p && typeof p === "object" && typeof p.text === "string")
+        .map((p) => p.text)
+        .join("\n")
+        .trim();
+}
+function isToolCallPart(part) {
+    if (!part || typeof part !== "object")
+        return false;
+    const p = part;
+    return (p.type === "toolCall" || p.type === "tool_call" || p.type === "tool-call") && typeof p.name === "string";
+}
+export function parsePiSession(jsonl, sourcePath) {
+    const events = [];
+    let seq = 0;
+    const push = (event) => {
+        events.push({ ...event, seq: seq++ });
+    };
+    let sessionId = sourcePath ? basename(sourcePath).replace(/\.jsonl$/, "") : "pi-session";
+    let cwd;
+    let sawUser = false;
+    for (const line of jsonl.split("\n")) {
+        const t = line.trim();
+        if (!t)
+            continue;
+        let entry;
+        try {
+            entry = JSON.parse(t);
+        }
+        catch {
+            continue;
+        }
+        if (typeof entry.sessionId === "string")
+            sessionId = entry.sessionId;
+        if (typeof entry.cwd === "string")
+            cwd = entry.cwd;
+        if (entry.type !== "message" || !entry.message)
+            continue;
+        const msg = entry.message;
+        const at = typeof entry.timestamp === "string" ? { at: entry.timestamp } : {};
+        if (msg.role === "user") {
+            const text = partsToText(msg.content);
+            if (!text)
+                continue;
+            if (!sawUser) {
+                push({ type: "task.started", content: truncate(text, MESSAGE_MAX), ...at });
+                sawUser = true;
+            }
+            else {
+                push({ type: "message.user", content: truncate(text, MESSAGE_MAX), ...at });
+            }
+        }
+        else if (msg.role === "assistant") {
+            const parts = Array.isArray(msg.content) ? msg.content : [];
+            const text = partsToText(parts);
+            if (text)
+                push({ type: "message.assistant", content: truncate(text, MESSAGE_MAX), ...at });
+            for (const part of parts) {
+                if (isToolCallPart(part)) {
+                    push({
+                        type: "tool.called",
+                        tool: {
+                            name: part.name ?? "tool",
+                            ...(part.id ? { callId: part.id } : {}),
+                            input: part.arguments ?? part.input,
+                        },
+                        ...at,
+                    });
+                }
+            }
+        }
+        else if (msg.role === "toolResult") {
+            const outcome = partsToText(msg.content);
+            push({
+                type: "tool.completed",
+                tool: { name: "", ...(msg.toolCallId ? { callId: msg.toolCallId } : {}), outcome: truncate(outcome, MESSAGE_MAX) },
+                ...at,
+            });
+        }
+    }
+    return {
+        sessionId,
+        agent: "pi",
+        ...(sourcePath ? { sourcePath } : {}),
+        ...(cwd ? { cwd } : {}),
+        events,
+    };
+}
+/** Fill tool.completed names from the tool.called that shares its callId. */
+export function resolvePiToolNames(ledger) {
+    const nameById = new Map();
+    for (const event of ledger.events) {
+        if (event.type === "tool.called" && event.tool?.callId) {
+            nameById.set(event.tool.callId, event.tool.name);
+        }
+    }
+    for (const event of ledger.events) {
+        if (event.type === "tool.completed" && event.tool && !event.tool.name && event.tool.callId) {
+            const name = nameById.get(event.tool.callId);
+            if (name)
+                event.tool.name = name;
+        }
+    }
+    return ledger;
+}
+function piSessionsDir(home) {
+    const agentDir = process.env.PI_CODING_AGENT_DIR ?? join(home, ".pi", "agent");
+    return join(agentDir, "sessions");
+}
+export function latestPiSession(workspaceDir, home = homedir()) {
+    const dir = piSessionsDir(home);
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return undefined;
+    }
+    const candidates = entries
+        .filter((f) => f.endsWith(".jsonl"))
+        .map((f) => {
+        const full = join(dir, f);
+        try {
+            return { path: full, mtime: statSync(full).mtimeMs };
+        }
+        catch {
+            return undefined;
+        }
+    })
+        .filter((c) => c !== undefined)
+        .sort((a, b) => b.mtime - a.mtime);
+    // Prefer a session whose recorded cwd matches the workspace; else newest.
+    for (const candidate of candidates.slice(0, DISCOVERY_SCAN_LIMIT)) {
+        const ledger = parsePiSession(readFileSafe(candidate.path), candidate.path);
+        if (ledger.cwd && ledger.cwd === workspaceDir)
+            return candidate.path;
+    }
+    return candidates[0]?.path;
+}
+function readFileSafe(path) {
+    try {
+        return readFileSync(path, "utf8");
+    }
+    catch {
+        return "";
+    }
+}
+export function loadPiLedger(sessionPath) {
+    return resolvePiToolNames(parsePiSession(readFileSync(sessionPath, "utf8"), sessionPath));
+}
+//# sourceMappingURL=pi.js.map

package/dist/adapters/pi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi.js","sourceRoot":"","sources":["../../src/adapters/pi.ts"],"names":[],"mappings":"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"}

package/dist/artifacts.d.ts

@@ -0,0 +1,25 @@
+import { type Packet } from "./packet.js";
+export interface WrittenArtifacts {
+    jsonPath: string;
+    markdownPath: string;
+}
+/** Write the canonical packet + markdown twin under <workspace>/.memento/. */
+export declare function writePacketArtifacts(workspaceDir: string, packet: Packet): WrittenArtifacts;
+/**
+ * Read the workspace's current packet. Missing → undefined; present but
+ * unparseable/invalid → throws (a corrupt packet must be surfaced to whoever
+ * is about to resume from it, not silently ignored).
+ */
+export declare function loadPacket(workspaceDir: string): Packet | undefined;
+export interface ChainLink {
+    taskId: string;
+    parent: string;
+    seq: number;
+}
+/**
+ * Packet-chain continuity (spec §5.1/§8.1): when a packet already exists in
+ * the workspace, the next compile continues its chain — same taskId, parent
+ * pointing at the previous packet, seq incremented. An unreadable or invalid
+ * prior packet starts a fresh chain rather than failing the compile.
+ */
+export declare function chainFromPrior(workspaceDir: string): ChainLink | undefined;

package/dist/artifacts.js

@@ -0,0 +1,50 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { PacketSchema } from "./packet.js";
+import { renderMarkdown } from "./render.js";
+/** Write the canonical packet + markdown twin under <workspace>/.memento/. */
+export function writePacketArtifacts(workspaceDir, packet) {
+    const dir = join(workspaceDir, ".memento");
+    mkdirSync(dir, { recursive: true });
+    const jsonPath = join(dir, "handoff.json");
+    const markdownPath = join(dir, "HANDOFF.md");
+    writeFileSync(jsonPath, `${JSON.stringify(packet, null, 2)}\n`);
+    writeFileSync(markdownPath, `${renderMarkdown(packet)}\n`);
+    return { jsonPath, markdownPath };
+}
+/**
+ * Read the workspace's current packet. Missing → undefined; present but
+ * unparseable/invalid → throws (a corrupt packet must be surfaced to whoever
+ * is about to resume from it, not silently ignored).
+ */
+export function loadPacket(workspaceDir) {
+    const path = join(workspaceDir, ".memento", "handoff.json");
+    if (!existsSync(path)) {
+        return undefined;
+    }
+    return PacketSchema.parse(JSON.parse(readFileSync(path, "utf8")));
+}
+/**
+ * Packet-chain continuity (spec §5.1/§8.1): when a packet already exists in
+ * the workspace, the next compile continues its chain — same taskId, parent
+ * pointing at the previous packet, seq incremented. An unreadable or invalid
+ * prior packet starts a fresh chain rather than failing the compile.
+ */
+export function chainFromPrior(workspaceDir) {
+    const path = join(workspaceDir, ".memento", "handoff.json");
+    if (!existsSync(path)) {
+        return undefined;
+    }
+    try {
+        const prior = PacketSchema.parse(JSON.parse(readFileSync(path, "utf8")));
+        return {
+            taskId: prior.packet.taskId,
+            parent: prior.packet.id,
+            seq: prior.packet.seq + 1,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../src/artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAC,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAC/B,OAAO,EAAC,YAAY,EAAc,MAAM,aAAa,CAAC;AACtD,OAAO,EAAC,cAAc,EAAC,MAAM,aAAa,CAAC;AAO3C,8EAA8E;AAC9E,MAAM,UAAU,oBAAoB,CAAC,YAAoB,EAAE,MAAc;IACrE,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC3C,SAAS,CAAC,GAAG,EAAE,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC,CAAC;IAElC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAE7C,aAAa,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAChE,aAAa,CAAC,YAAY,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAE3D,OAAO,EAAC,QAAQ,EAAE,YAAY,EAAC,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,YAAoB;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;IAE5D,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACpB,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,OAAO,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;AACtE,CAAC;AAQD;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,YAAoB;IAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;IAE5D,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACpB,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,IAAI,CAAC;QACD,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QAEzE,OAAO;YACH,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;YAC3B,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE;YACvB,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC;SAC5B,CAAC;IACN,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC"}

package/dist/bench-live.d.ts

@@ -0,0 +1,28 @@
+export interface LiveCheck {
+    name: string;
+    pass: boolean;
+    detail?: string;
+}
+export interface LiveArmResult {
+    arm: "packet" | "baseline";
+    checks: LiveCheck[];
+    passed: number;
+    total: number;
+    output: string;
+    durationMs: number;
+}
+export interface LiveBenchReport {
+    version: string;
+    ranAt: string;
+    executor: string;
+    arms: LiveArmResult[];
+}
+export type Executor = (prompt: string, cwd: string) => Promise<string>;
+export declare function shellExecutor(command: string, timeoutMs?: number): Executor;
+export interface RunLiveBenchOptions {
+    executor: Executor;
+    executorLabel: string;
+    baseline?: boolean;
+}
+export declare function runLiveBench(options: RunLiveBenchOptions): Promise<LiveBenchReport>;
+export declare function formatLiveBenchReport(report: LiveBenchReport): string;