@samjurnio_/memento 0.2.0

package/dist/cli.js

@@ -0,0 +1,338 @@
+#!/usr/bin/env node
+import { createRequire } from "node:module";
+import { resolve } from "node:path";
+import { loadPacket } from "./artifacts.js";
+import { captureGitState, restoreWorkspace, snapshotRefExists, verifyWorkspace } from "./git.js";
+import { AGENTS, performHandoff, REASONS } from "./handoff.js";
+import { handleHookPayload, installClaudeHooks, readStdin } from "./hooks.js";
+import { runMcpServer } from "./mcp.js";
+import { packetJsonSchema, verifySeal } from "./packet.js";
+import { renderResumePrompt, renderStatus } from "./render.js";
+import { INJECT_TARGETS, injectPacket, isInjectTarget } from "./inject/dispatch.js";
+const HELP = `memento — cross-agent session continuity
+
+Usage:
+  memento compile [--agent claude-code|codex|gemini-cli|antigravity|pi|opencode]
+                [--transcript <path>] [--workspace <dir>] [--reason <reason>]
+                [--task <taskId>] [--no-snapshot]
+      Compile a Continuation Packet from an agent session and write it to
+      <workspace>/.memento/handoff.json + HANDOFF.md.
+      --reason: context_exhaustion | operator_switch | session_end |
+      scheduled | team_handoff  (default: operator_switch)
+
+  memento inject codex|antigravity|claude-code [--workspace <dir>]
+      Write the compiled packet as a native session in the target agent's
+      sessions directory so it appears in their Recent list — no paste step.
+        codex        → ~/.codex/sessions/<date>/rollout-*.jsonl  + SQLite index
+        antigravity  → brain logs + SQLite
+        claude-code  → ~/.claude/projects/<workspace>/<uuid>.jsonl
+
+  memento handoff <from> <to> [--workspace <dir>] [--reason <reason>]
+      One shot: compile the latest <from> session and inject it as a native
+      <to> session — the whole point of memento.
+        <from>: claude-code | codex | gemini-cli | antigravity | pi | opencode
+        <to>:   codex | claude-code | antigravity
+      e.g.  memento handoff codex claude-code
+
+  memento resume [--workspace <dir>]
+      Print the resume prompt for pasting into any agent:
+      codex exec "$(memento resume)"
+
+  memento verify [--workspace <dir>]
+      Compare the live workspace against the packet's recorded git state.
+      Exit 0 when clean, 1 on drift.
+
+  memento restore [--workspace <dir>] [--force]
+      Materialize the packet's working-tree snapshot into the workspace — the
+      prior agent's actual uncommitted + untracked files, not just a summary.
+      Refuses to overwrite diverging local edits unless --force.
+
+  memento status [--workspace <dir>]
+      One-line packet summary.
+
+  memento schema
+      Print the Packet v1 JSON Schema.
+
+  memento install-hooks claude-code [--workspace <dir>] [--command <cmd>]
+      Add PreCompact + SessionEnd hooks to <workspace>/.claude/settings.json
+      so a packet is compiled automatically at context pressure.
+      --command defaults to "memento hook" (requires memento on PATH).
+
+  memento install-hooks codex
+      Register [mcp_servers.memento] in ~/.codex/config.toml so Codex calls
+      memento_resume / memento_handoff natively. Idempotent, append-only.
+
+  memento hook
+      Hook stdin entrypoint: reads the Claude Code hook payload and compiles
+      a packet from the session's own transcript. Always exits 0.
+
+  memento mcp
+      Run Memento as an MCP server over stdio, exposing memento_handoff,
+      memento_resume, memento_verify, memento_status as native agent tools.
+      Register: claude mcp add memento -- memento mcp
+
+  memento bench [--json <path>]
+      Continuity Bench: fixed scenarios scoring packet fidelity
+      (objective survival, failure surfacing, in-flight state, redaction,
+      chain integrity). Offline, reproducible. Exit 1 on any failed check.
+
+  memento bench-live [--exec "<cmd>"] [--baseline] [--json <path>]
+      Live bench: a REAL receiving agent gets the resume prompt on stdin in
+      a fixture repo; what it does is scored mechanically (next step done,
+      constraint honored, completed work not redone). --baseline adds a
+      cold-start arm — the delta is what the packet buys.
+      Default executor: claude -p --permission-mode acceptEdits
+`;
+function flag(args, name) {
+    const index = args.indexOf(name);
+    return index !== -1 ? args[index + 1] : undefined;
+}
+function readPacket(workspace) {
+    const packet = loadPacket(workspace);
+    if (!packet) {
+        console.error(`No packet found in ${workspace}/.memento — run \`memento compile\` first.`);
+        process.exit(1);
+    }
+    return packet;
+}
+async function main() {
+    const [command, ...args] = process.argv.slice(2);
+    const workspace = resolve(flag(args, "--workspace") ?? process.cwd());
+    if (command === "version" || command === "--version" || command === "-v") {
+        const pkg = createRequire(import.meta.url)("../package.json");
+        console.log(`memento ${pkg.version}`);
+        return;
+    }
+    switch (command) {
+        case "compile": {
+            const reasonInput = flag(args, "--reason") ?? "operator_switch";
+            if (!REASONS.includes(reasonInput)) {
+                console.error(`Unknown --reason "${reasonInput}". One of: ${REASONS.join(", ")}`);
+                process.exit(1);
+            }
+            const agent = flag(args, "--agent");
+            const transcript = flag(args, "--transcript");
+            const taskId = flag(args, "--task");
+            const result = await performHandoff({
+                workspaceDir: workspace,
+                reason: reasonInput,
+                ...(agent ? { agent } : {}),
+                ...(transcript ? { transcript } : {}),
+                ...(taskId ? { taskId } : {}),
+                ...(args.includes("--no-snapshot") ? { noSnapshot: true } : {}),
+            });
+            const { packet, artifacts } = result;
+            console.log(`Sealed packet ${packet.packet.id} (task ${packet.packet.taskId}, seq ${packet.packet.seq})`);
+            console.log(`  ledger:    ${result.transcriptPath} (${result.eventCount} events)`);
+            console.log(`  snapshot:  ${packet.workspace.git?.snapshotRef ?? "(none)"}`);
+            console.log(`  redaction: ${packet.redaction.count} hit(s)`);
+            console.log(`  wrote:     ${artifacts.jsonPath}`);
+            console.log(`             ${artifacts.markdownPath}`);
+            return;
+        }
+        case "inject": {
+            const target = args.find((a) => !a.startsWith("--"));
+            if (!target || !isInjectTarget(target)) {
+                console.error(`Usage: memento inject ${INJECT_TARGETS.join("|")} [--workspace <dir>]`);
+                process.exit(1);
+            }
+            const packet = readPacket(workspace);
+            try {
+                const lines = await injectPacket(target, packet, workspace);
+                console.log(lines.join("\n"));
+            }
+            catch (err) {
+                console.error(`Inject failed: ${err instanceof Error ? err.message : String(err)}`);
+                process.exit(1);
+            }
+            return;
+        }
+        case "handoff": {
+            // One shot: compile from <from>, inject into <to>. The whole point
+            // of memento — pass the live session straight to the next agent.
+            const positionals = args.filter((a) => !a.startsWith("--"));
+            const from = positionals[0];
+            const to = positionals[1];
+            if (!from || !to || !AGENTS.includes(from) || !isInjectTarget(to)) {
+                console.error(`Usage: memento handoff <from> <to>    e.g. memento handoff codex claude-code`);
+                console.error(`  <from> (session to read): ${AGENTS.join(" | ")}`);
+                console.error(`  <to>   (native target):   ${INJECT_TARGETS.join(" | ")}`);
+                process.exit(1);
+            }
+            const reasonInput = flag(args, "--reason") ?? "operator_switch";
+            if (!REASONS.includes(reasonInput)) {
+                console.error(`Unknown --reason "${reasonInput}". One of: ${REASONS.join(", ")}`);
+                process.exit(1);
+            }
+            const transcript = flag(args, "--transcript");
+            const result = await performHandoff({
+                workspaceDir: workspace,
+                reason: reasonInput,
+                agent: from,
+                ...(transcript ? { transcript } : {}),
+                ...(args.includes("--no-snapshot") ? { noSnapshot: true } : {}),
+            });
+            console.log(`Compiled packet ${result.packet.packet.id} from ${from} (${result.eventCount} events).`);
+            try {
+                const lines = await injectPacket(to, result.packet, workspace);
+                console.log(lines.join("\n"));
+            }
+            catch (err) {
+                console.error(`Inject failed: ${err instanceof Error ? err.message : String(err)}`);
+                process.exit(1);
+            }
+            console.log(`\nHanded off ${from} → ${to}.`);
+            return;
+        }
+        case "mcp": {
+            await runMcpServer();
+            return;
+        }
+        case "bench-live": {
+            const { runLiveBench, formatLiveBenchReport, shellExecutor } = await import("./bench-live.js");
+            const command = flag(args, "--exec") ?? "claude -p --permission-mode acceptEdits";
+            const report = await runLiveBench({
+                executor: shellExecutor(command),
+                executorLabel: command,
+                ...(args.includes("--baseline") ? { baseline: true } : {}),
+            });
+            console.log(formatLiveBenchReport(report));
+            const liveOut = flag(args, "--json");
+            if (liveOut) {
+                const { writeFileSync } = await import("node:fs");
+                writeFileSync(liveOut, `${JSON.stringify(report, null, 2)}\n`);
+                console.log(`report: ${liveOut}`);
+            }
+            return;
+        }
+        case "bench": {
+            const { runContinuityBench, formatBenchReport } = await import("./bench.js");
+            const report = await runContinuityBench();
+            console.log(formatBenchReport(report));
+            const out = flag(args, "--json");
+            if (out) {
+                const { writeFileSync } = await import("node:fs");
+                writeFileSync(out, `${JSON.stringify(report, null, 2)}\n`);
+                console.log(`report: ${out}`);
+            }
+            if (!report.allPassed) {
+                process.exit(1);
+            }
+            return;
+        }
+        case "install-hooks": {
+            const agent = args.find((arg) => !arg.startsWith("--")) ?? "claude-code";
+            if (agent === "codex") {
+                const { installCodexMcp } = await import("./hooks.js");
+                const result = installCodexMcp();
+                console.log(result.installed
+                    ? `Registered [mcp_servers.memento] in ${result.configPath}`
+                    : `Already registered in ${result.configPath} — left as-is.`);
+                console.log(`Codex can now call memento_resume / memento_handoff / memento_verify / memento_status natively.`);
+                return;
+            }
+            if (agent !== "claude-code") {
+                console.error(`Installer for "${agent}" is not implemented yet (claude-code | codex).`);
+                process.exit(1);
+            }
+            const command = flag(args, "--command") ?? "memento hook";
+            const result = installClaudeHooks(workspace, command);
+            console.log(`Updated ${result.settingsPath}`);
+            result.installed.forEach((event) => console.log(`  + ${event} → ${command}`));
+            result.skipped.forEach((event) => console.log(`  = ${event} (already installed, left as-is)`));
+            if (command === "memento hook") {
+                console.log(`\nNote: "memento" must be on PATH for hooks to fire (pnpm build && npm link).`);
+            }
+            return;
+        }
+        case "hook": {
+            const outcome = await handleHookPayload(await readStdin());
+            console.error(outcome.message);
+            // Always exit 0: a capture failure must never disrupt the
+            // session it is trying to protect.
+            return;
+        }
+        case "resume": {
+            const packet = readPacket(workspace);
+            if (!verifySeal(packet)) {
+                console.error("⚠ Packet seal does not verify — it was modified after sealing. Refusing.");
+                process.exit(1);
+            }
+            console.log(renderResumePrompt(packet));
+            return;
+        }
+        case "verify": {
+            const packet = readPacket(workspace);
+            if (!packet.workspace.git) {
+                console.log("Packet carries no git state; nothing to verify.");
+                return;
+            }
+            const report = await verifyWorkspace(workspace, packet.workspace.git);
+            if (report.clean) {
+                console.log(`✓ Workspace matches packet ${packet.packet.id} — safe to continue.`);
+                return;
+            }
+            console.error(`✗ Drift detected against packet ${packet.packet.id}:`);
+            report.drift.forEach((line) => console.error(`  ${line}`));
+            process.exit(1);
+            // eslint-disable-next-line no-unreachable
+            return;
+        }
+        case "restore": {
+            const packet = readPacket(workspace);
+            const snapshotRef = packet.workspace.git?.snapshotRef;
+            if (!snapshotRef) {
+                console.error("Packet carries no working-tree snapshot — nothing to restore.");
+                process.exit(1);
+            }
+            if (!(await snapshotRefExists(workspace, snapshotRef))) {
+                console.error(`Snapshot ${snapshotRef} is not present in this repo.`);
+                console.error("Restore runs where the packet was captured; cross-machine restore needs a bundle.");
+                process.exit(1);
+            }
+            // Don't silently clobber the receiver's own uncommitted work: refuse
+            // when the live tree has edits that diverge from the packet, unless
+            // --force. A clean checkout (or one already matching the packet) is
+            // safe — that's the primary "bring the work here" case.
+            const force = args.includes("--force");
+            if (!force && packet.workspace.git) {
+                const current = await captureGitState(workspace);
+                if (current && current.dirty.length > 0) {
+                    const report = await verifyWorkspace(workspace, packet.workspace.git);
+                    if (!report.clean) {
+                        console.error("⚠ Workspace has uncommitted changes that diverge from the packet — restore would overwrite them.");
+                        report.drift.forEach((line) => console.error(`  ${line}`));
+                        console.error("Commit/stash your changes, or re-run with --force to overwrite.");
+                        process.exit(1);
+                    }
+                }
+            }
+            const result = await restoreWorkspace(workspace, snapshotRef);
+            console.log(`✓ Restored ${result.files.length} file(s) from ${snapshotRef} into ${workspace}.`);
+            result.files.slice(0, 12).forEach((file) => console.log(`  ${file}`));
+            if (result.files.length > 12) {
+                console.log(`  … and ${result.files.length - 12} more`);
+            }
+            console.log("\nThe prior agent's working tree (uncommitted + untracked included) is now in place.");
+            return;
+        }
+        case "status": {
+            const packet = readPacket(workspace);
+            console.log(renderStatus(packet, verifySeal(packet)));
+            return;
+        }
+        case "schema": {
+            console.log(JSON.stringify(packetJsonSchema(), null, 2));
+            return;
+        }
+        default: {
+            console.log(HELP);
+            process.exit(command ? 1 : 0);
+        }
+    }
+}
+main().catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/compile.d.ts

@@ -0,0 +1,27 @@
+import { type Ledger } from "./ledger.js";
+import { type Packet } from "./packet.js";
+import { type Summarizer } from "./summarize.js";
+/**
+ * The packet compiler (spec §7.2). Deterministic fields (git state, tool
+ * outcomes, in-flight calls) are EXTRACTED from the ledger and workspace;
+ * narrative fields (objective, next, warnings) come from the pluggable
+ * summarizer. The LLM — when one is configured — only ever writes prose
+ * around verified facts, never the facts themselves.
+ */
+export interface CompilePacketOptions {
+    ledger: Ledger;
+    workspaceDir: string;
+    reason: Packet["packet"]["reason"];
+    peer?: string;
+    human?: string;
+    model?: string;
+    taskId?: string;
+    parent?: string | null;
+    seq?: number;
+    scope?: Packet["packet"]["scope"];
+    summarizer?: Summarizer;
+    /** Skip the refs/memento/* snapshot (e.g. read-only checkouts). */
+    noSnapshot?: boolean;
+    now?: () => Date;
+}
+export declare function compilePacket(options: CompilePacketOptions): Promise<Packet>;

package/dist/compile.js

@@ -0,0 +1,193 @@
+import { inFlightCalls, truncate } from "./ledger.js";
+import { newPacketId, newTaskId, workspaceId } from "./ids.js";
+import { captureGitState } from "./git.js";
+import { PacketSchema, sealPacket, } from "./packet.js";
+import { redactDeep } from "./redact.js";
+import { HeuristicSummarizer } from "./summarize.js";
+const COMPLETED_MAX = 14;
+const OUTCOME_MAX = 200;
+export async function compilePacket(options) {
+    let summarizer = options.summarizer;
+    if (!summarizer) {
+        if (process.env.OPENAI_API_KEY || process.env.ANTHROPIC_API_KEY) {
+            try {
+                const { LlmSummarizer } = await import("./summarize.js");
+                summarizer = new LlmSummarizer();
+            }
+            catch {
+                summarizer = new HeuristicSummarizer();
+            }
+        }
+        else {
+            summarizer = new HeuristicSummarizer();
+        }
+    }
+    const now = options.now ?? (() => new Date());
+    const packetId = newPacketId();
+    const git = await captureGitState(options.workspaceDir, {
+        ...(options.noSnapshot ? {} : { snapshotPacketId: packetId }),
+    });
+    const finalSummarizer = summarizer || new HeuristicSummarizer();
+    const summary = await finalSummarizer.summarize(options.ledger);
+    const toolState = extractToolState(options.ledger);
+    const lastRun = extractLastRun(options.ledger);
+    // Redact everything narrative or tool-derived BEFORE assembly; git paths
+    // and ids are structural and stay as-is.
+    const redacted = redactDeep({
+        objective: summary.objective,
+        planSteps: summary.planSteps,
+        decisions: summary.decisions,
+        next: summary.next,
+        warnings: summary.warnings,
+        toolState,
+        lastRun,
+    });
+    const r = redacted.value;
+    const title = truncate(r.objective.split(/[.!?\n]/)[0] ?? r.objective, 80);
+    const packet = {
+        memento: "1.0",
+        packet: {
+            id: packetId,
+            taskId: options.taskId ?? newTaskId(),
+            workspaceId: workspaceId(git?.remote ?? options.workspaceDir),
+            scope: options.scope ?? "workspace",
+            createdAt: now().toISOString(),
+            reason: options.reason,
+            from: {
+                peer: options.peer ?? `peer_${options.ledger.agent}`,
+                agent: options.ledger.agent,
+                ...(options.model ? { model: options.model } : {}),
+                ...(options.human ? { human: options.human } : {}),
+            },
+            seq: options.seq ?? 0,
+            parent: options.parent ?? null,
+        },
+        task: {
+            title,
+            objective: r.objective,
+            constraints: [],
+            acceptance: [],
+        },
+        plan: { steps: r.planSteps },
+        decisions: r.decisions,
+        workspace: {
+            ...(git ? { git } : {}),
+            ...(r.lastRun ? { lastRun: r.lastRun } : {}),
+        },
+        toolState: r.toolState,
+        memory: { inline: [] },
+        next: r.next,
+        warnings: r.warnings,
+        ...(options.ledger.sourcePath ? { ledgerRef: options.ledger.sourcePath } : {}),
+        fidelity: "structural",
+        redaction: {
+            applied: redacted.count > 0,
+            rules: redacted.rulesHit,
+            count: redacted.count,
+        },
+        ...(options.ledger.sourcePath ? { ledgerRef: options.ledger.sourcePath } : {}),
+    };
+    // Validate against the schema before sealing — a packet that does not
+    // parse is a bug here, not a surprise for the receiving agent.
+    return sealPacket(PacketSchema.parse(packet));
+}
+function extractToolState(ledger) {
+    const completed = [];
+    const seen = new Set();
+    // Walk backwards: the most recent outcome per tool+target wins, and the
+    // packet keeps only the freshest COMPLETED_MAX.
+    for (let i = ledger.events.length - 1; i >= 0; i -= 1) {
+        const event = ledger.events[i];
+        if (!event || (event.type !== "tool.completed" && event.type !== "tool.failed") || !event.tool) {
+            continue;
+        }
+        const key = `${event.tool.name} ${event.tool.target ?? ""}`;
+        if (seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        completed.unshift({
+            tool: event.tool.name,
+            ...(event.tool.target ? { target: event.tool.target } : {}),
+            outcome: `${event.type === "tool.failed" ? "FAILED: " : ""}${truncate(event.tool.outcome ?? "(no output)", OUTCOME_MAX)}`,
+        });
+        if (completed.length >= COMPLETED_MAX) {
+            break;
+        }
+    }
+    const inFlight = inFlightCalls(ledger).map((event) => ({
+        tool: event.tool?.name ?? "unknown",
+        ...(event.tool?.target ? { target: event.tool.target } : {}),
+        disposition: "NOT applied — re-derive from the actual working tree, do not assume this ran.",
+    }));
+    return {
+        completed,
+        inFlight,
+        approvals: extractApprovals(ledger),
+    };
+}
+function extractApprovals(ledger) {
+    const grantedSessionSet = new Set();
+    const pendingRequests = new Map();
+    const denied = [];
+    // Map to find request details for a resolved event
+    const requestedById = new Map();
+    for (const event of ledger.events) {
+        if (event.type === "approval.requested" && event.tool) {
+            const approvalId = event.meta?.approvalId ?? String(event.seq);
+            const detail = {
+                tool: event.tool.name,
+                target: event.tool.target,
+                reason: event.content,
+            };
+            requestedById.set(approvalId, detail);
+            pendingRequests.set(approvalId, detail);
+        }
+        else if (event.type === "approval.resolved" && event.tool) {
+            const approvalId = event.meta?.approvalId ?? String(event.seq);
+            const status = event.meta?.status;
+            const scope = event.meta?.scope;
+            // Remove from pending as it is resolved
+            pendingRequests.delete(approvalId);
+            const req = requestedById.get(approvalId);
+            const tool = event.tool.name || req?.tool || "unknown";
+            const target = event.tool.target || req?.target;
+            if (status === "approved" && scope === "session") {
+                const key = target ? `${tool}:${target}` : tool;
+                grantedSessionSet.add(key);
+            }
+            else if (status === "denied") {
+                denied.push({
+                    tool,
+                    ...(target ? { target } : {}),
+                    ...(event.content ? { note: event.content } : req?.reason ? { note: req.reason } : {}),
+                });
+            }
+        }
+    }
+    const pending = Array.from(pendingRequests.values()).map((req) => {
+        return req.target ? `${req.tool}:${req.target}` : req.tool;
+    });
+    return {
+        granted_session: Array.from(grantedSessionSet),
+        pending,
+        denied,
+    };
+}
+function extractLastRun(ledger) {
+    for (let i = ledger.events.length - 1; i >= 0; i -= 1) {
+        const event = ledger.events[i];
+        if (event
+            && (event.type === "tool.completed" || event.type === "tool.failed")
+            && event.tool?.name.toLowerCase() === "bash"
+            && event.tool.target) {
+            return {
+                cmd: event.tool.target,
+                result: truncate(event.tool.outcome ?? "(no output)", OUTCOME_MAX),
+                ...(event.at ? { at: event.at } : {}),
+            };
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=compile.js.map

package/dist/compile.js.map

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

package/dist/git.d.ts

@@ -0,0 +1,45 @@
+import type { PacketGitState } from "./packet.js";
+export interface CaptureGitStateOptions {
+    /** Create a refs/memento/<packetId> snapshot of the full tree. Default true. */
+    snapshotPacketId?: string;
+}
+/**
+ * Capture the workspace's git state for a packet. Returns undefined when the
+ * directory is not a git repository (packets allow workspace.git to be absent).
+ */
+export declare function captureGitState(dir: string, options?: CaptureGitStateOptions): Promise<PacketGitState | undefined>;
+export declare function digestDirtyState(porcelain: string, diff: string): string;
+/**
+ * Snapshot the FULL working tree (incl. uncommitted and untracked files) into
+ * a shadow commit at refs/memento/<packetId>. Uses GIT_INDEX_FILE so the user's
+ * staging area is untouched. Returns the ref name, or null on failure —
+ * snapshot failure must never block packet compilation.
+ */
+export declare function snapshotWorkspace(dir: string, packetId: string, headSha: string | null): Promise<string | null>;
+export interface DriftReport {
+    clean: boolean;
+    drift: string[];
+}
+/**
+ * The continuity check (spec §7.4): compare the live workspace against the
+ * git state recorded in a packet. Drift is surfaced, never auto-resolved.
+ */
+export declare function verifyWorkspace(dir: string, expected: PacketGitState): Promise<DriftReport>;
+/** True if `ref` resolves in this repo (snapshots live only where captured). */
+export declare function snapshotRefExists(dir: string, ref: string): Promise<boolean>;
+export interface RestoreReport {
+    /** Paths written into the working tree from the snapshot. */
+    files: string[];
+}
+/**
+ * Materialize a packet's working-tree snapshot (refs/memento/<id>) back into
+ * `dir` — the receiving agent gets the prior agent's actual uncommitted AND
+ * untracked files, not just a description of them. This is what makes a memento
+ * carry executable state rather than notes.
+ *
+ * Uses a TEMPORARY index + checkout-index so the real index and HEAD are never
+ * touched. Existing files are overwritten (-f); files absent from the snapshot
+ * are left in place (non-deleting by design — restore is additive, never
+ * destructive to work the snapshot didn't know about).
+ */
+export declare function restoreWorkspace(dir: string, snapshotRef: string): Promise<RestoreReport>;