@samjurnio_/memento 0.2.0

package/dist/redact.js.map

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

package/dist/render.d.ts

@@ -0,0 +1,11 @@
+import type { Packet } from "./packet.js";
+/**
+ * The markdown twin (spec §5.3): the same packet, rendered for (a) agents
+ * that can only read files and (b) humans. JSON is canonical; this is
+ * generated. Also the resume prompt wrapper (spec §7.3).
+ */
+export declare function renderMarkdown(packet: Packet): string;
+/** One-screen packet summary (CLI `status` and MCP `memento_status`). */
+export declare function renderStatus(packet: Packet, sealVerified: boolean): string;
+/** Spec §7.3 — instructions wrapped around every packet at resume time. */
+export declare function renderResumePrompt(packet: Packet): string;

package/dist/render.js

@@ -0,0 +1,145 @@
+/**
+ * The markdown twin (spec §5.3): the same packet, rendered for (a) agents
+ * that can only read files and (b) humans. JSON is canonical; this is
+ * generated. Also the resume prompt wrapper (spec §7.3).
+ */
+export function renderMarkdown(packet) {
+    const p = packet.packet;
+    const lines = [];
+    lines.push(`# Memento Handoff — ${packet.task.title}`);
+    lines.push("");
+    lines.push(`> Continuation Packet \`${p.id}\` · task \`${p.taskId}\` · seq ${p.seq}${p.parent ? ` · parent \`${p.parent}\`` : ""}`);
+    lines.push(`> From **${p.from.peer}** (${p.from.agent}${p.from.model ? `, ${p.from.model}` : ""}${p.from.human ? `, operator ${p.from.human}` : ""}) · reason: **${p.reason}** · ${p.createdAt}`);
+    if (packet.seal) {
+        lines.push(`> Sealed: \`${packet.seal.alg}:${packet.seal.digest.slice(0, 16)}…\`${packet.redaction.applied ? ` · ${packet.redaction.count} redaction(s) applied [${packet.redaction.rules.join(", ")}]` : ""}`);
+    }
+    lines.push(`> ⚠ Provenance: machine-compiled from a session ledger. Verify workspace state before acting.`);
+    lines.push("");
+    lines.push("## Objective");
+    lines.push("");
+    lines.push(packet.task.objective);
+    lines.push("");
+    if (packet.task.constraints.length > 0) {
+        lines.push("## Constraints");
+        lines.push("");
+        packet.task.constraints.forEach((constraint) => lines.push(`- ${constraint}`));
+        lines.push("");
+    }
+    if (packet.plan.steps.length > 0) {
+        lines.push("## Plan");
+        lines.push("");
+        for (const step of packet.plan.steps) {
+            const box = step.status === "done" ? "x" : step.status === "in_progress" ? "~" : " ";
+            lines.push(`- [${box}] ${step.n}. ${step.desc}${step.note ? ` — ${step.note}` : ""}`);
+        }
+        lines.push("");
+    }
+    if (packet.decisions.length > 0) {
+        lines.push("## Decisions made (do not relitigate without cause)");
+        lines.push("");
+        packet.decisions.forEach((decision) => lines.push(`- **${decision.what}** — ${decision.why}`));
+        lines.push("");
+    }
+    lines.push("## Workspace");
+    lines.push("");
+    const git = packet.workspace.git;
+    if (git) {
+        lines.push(`- branch \`${git.branch ?? "(detached)"}\` at \`${git.headSha ?? "(no commits)"}\`${git.remote ? ` · remote ${git.remote}` : ""}`);
+        lines.push(`- snapshot: ${git.snapshotRef ? `\`${git.snapshotRef}\` (full tree incl. uncommitted work)` : "(none)"}`);
+        lines.push(`- dirty digest \`${git.dirtyDigest}\``);
+        if (git.dirty.length > 0) {
+            lines.push(`- dirty files at capture:`);
+            git.dirty.forEach((file) => lines.push(`  - \`${file.path}\` (${file.state})`));
+        }
+        else {
+            lines.push("- working tree was clean at capture");
+        }
+    }
+    else {
+        lines.push("- (not a git repository at capture time)");
+    }
+    if (packet.workspace.lastRun) {
+        lines.push(`- last command: \`${packet.workspace.lastRun.cmd}\` → ${packet.workspace.lastRun.result}`);
+    }
+    lines.push("");
+    lines.push("## Tool state");
+    lines.push("");
+    if (packet.toolState.completed.length > 0) {
+        packet.toolState.completed.forEach((entry) => {
+            lines.push(`- ${entry.tool}${entry.target ? ` \`${entry.target}\`` : ""}: ${entry.outcome}`);
+        });
+    }
+    else {
+        lines.push("- (no tool activity captured)");
+    }
+    if (packet.toolState.inFlight.length > 0) {
+        lines.push("");
+        lines.push("**⚠ In-flight at capture (NOT applied):**");
+        packet.toolState.inFlight.forEach((entry) => {
+            lines.push(`- ${entry.tool}${entry.target ? ` \`${entry.target}\`` : ""} — ${entry.disposition}`);
+        });
+    }
+    const denied = packet.toolState.approvals.denied;
+    if (denied.length > 0) {
+        lines.push("");
+        lines.push("**⛔ Operator-denied actions (binding):**");
+        denied.forEach((entry) => lines.push(`- ${entry.tool}${entry.target ? ` \`${entry.target}\`` : ""}${entry.note ? ` — ${entry.note}` : ""}`));
+    }
+    lines.push("");
+    lines.push("## Next steps");
+    lines.push("");
+    packet.next.forEach((step, index) => lines.push(`${index + 1}. ${step}`));
+    lines.push("");
+    if (packet.warnings.length > 0) {
+        lines.push("## Warnings");
+        lines.push("");
+        packet.warnings.forEach((warning) => lines.push(`- ⚠ ${warning}`));
+        lines.push("");
+    }
+    if (packet.memory.inline.length > 0) {
+        lines.push("## Relevant memory");
+        lines.push("");
+        packet.memory.inline.forEach((memory) => lines.push(`- ${memory}`));
+        lines.push("");
+    }
+    if (packet.ledgerRef) {
+        lines.push(`---`);
+        lines.push(`Full session history: \`${packet.ledgerRef}\``);
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+/** One-screen packet summary (CLI `status` and MCP `memento_status`). */
+export function renderStatus(packet, sealVerified) {
+    const p = packet.packet;
+    return [
+        `packet   ${p.id} (seq ${p.seq}${p.parent ? `, parent ${p.parent}` : ""})`,
+        `task     ${p.taskId} — ${packet.task.title}`,
+        `from     ${p.from.peer} (${p.from.agent}) · reason ${p.reason} · ${p.createdAt}`,
+        `seal     ${packet.seal ? (sealVerified ? "verified" : "INVALID") : "missing"}`,
+        `next     ${packet.next[0] ?? "(none)"}`,
+    ].join("\n");
+}
+/** Spec §7.3 — instructions wrapped around every packet at resume time. */
+export function renderResumePrompt(packet) {
+    return [
+        "You are continuing a task another agent started. The handoff packet",
+        "below is the authoritative state. Before doing anything else:",
+        "",
+        "1. Verify the workspace: run `git status` and `git diff --stat` and",
+        "   compare against the Workspace section. If anything has drifted,",
+        "   STOP and report the drift to the operator.",
+        "2. Restate the objective and the next 1-3 steps in your own words.",
+        "3. Honor every constraint and warning — operator-denied actions are",
+        "   decisions, not suggestions.",
+        "4. Items marked in-flight were NOT applied. Re-derive from the actual",
+        "   file state; never assume an edit happened.",
+        "",
+        "Then continue the work from the Next steps section.",
+        "",
+        "---",
+        "",
+        renderMarkdown(packet),
+    ].join("\n");
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

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

package/dist/summarize.d.ts

@@ -0,0 +1,35 @@
+import { type Ledger } from "./ledger.js";
+import type { Packet } from "./packet.js";
+/**
+ * The compiler's narrative half (spec §7.2): deterministic fields are
+ * extracted, narrative fields are summarized. Summarizer is pluggable so an
+ * LLM can write better prose later — Phase 0 ships a heuristic that needs no
+ * network and no model, keeping `memento compile` fully offline.
+ */
+export interface Summary {
+    objective: string;
+    planSteps: Packet["plan"]["steps"];
+    decisions: Packet["decisions"];
+    next: string[];
+    warnings: string[];
+}
+export interface Summarizer {
+    readonly id: string;
+    summarize(ledger: Ledger): Summary | Promise<Summary>;
+}
+export declare class HeuristicSummarizer implements Summarizer {
+    readonly id = "heuristic";
+    summarize(ledger: Ledger): Summary;
+}
+export interface LlmSummarizerOptions {
+    provider?: "openai" | "anthropic";
+    apiKey?: string;
+    model?: string;
+    baseURL?: string;
+}
+export declare class LlmSummarizer implements Summarizer {
+    readonly id = "llm";
+    private options;
+    constructor(options?: LlmSummarizerOptions);
+    summarize(ledger: Ledger): Promise<Summary>;
+}

package/dist/summarize.js

@@ -0,0 +1,166 @@
+import { firstUserMessage, inFlightCalls, truncate, } from "./ledger.js";
+export class HeuristicSummarizer {
+    id = "heuristic";
+    summarize(ledger) {
+        const objective = truncate(firstUserMessage(ledger) ?? "(no user message captured in this session)", 400);
+        const next = [];
+        const warnings = [];
+        // In-flight tool calls: the receiver must re-derive, never assume.
+        for (const event of inFlightCalls(ledger)) {
+            const what = [event.tool?.name, event.tool?.target].filter(Boolean).join(" ");
+            warnings.push(`In-flight at capture (NOT applied — re-derive from the working tree): ${what}`);
+        }
+        // Failures near the tail are usually the live problem.
+        const failures = ledger.events.filter((event) => event.type === "tool.failed");
+        const lastFailure = failures[failures.length - 1];
+        if (lastFailure?.tool) {
+            const what = [lastFailure.tool.name, lastFailure.tool.target].filter(Boolean).join(" ");
+            next.push(`Investigate the last failure: ${what} — ${truncate(lastFailure.tool.outcome ?? "no output", 160)}`);
+        }
+        if (failures.length > 1) {
+            warnings.push(`${failures.length} tool call(s) failed during this session — see ledger for details.`);
+        }
+        // The last assistant message is the best statement of "where we were".
+        const assistantMessages = ledger.events.filter((event) => event.type === "message.assistant");
+        const lastAssistant = assistantMessages[assistantMessages.length - 1];
+        if (lastAssistant?.content) {
+            next.push(`Pick up from the previous agent's last status: "${truncate(lastAssistant.content, 220)}"`);
+        }
+        const compactions = ledger.events.filter((event) => event.type === "compaction");
+        if (compactions.length > 0) {
+            warnings.push(`Session was compacted ${compactions.length} time(s); early detail lives only in the source transcript.`);
+        }
+        next.push("Verify workspace state against the packet (memento verify) before editing anything.");
+        return {
+            objective,
+            planSteps: [],
+            decisions: [],
+            next,
+            warnings,
+        };
+    }
+}
+export class LlmSummarizer {
+    id = "llm";
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async summarize(ledger) {
+        const provider = this.options.provider ??
+            (process.env.ANTHROPIC_API_KEY ? "anthropic" : "openai");
+        const apiKey = this.options.apiKey ??
+            (provider === "anthropic" ? process.env.ANTHROPIC_API_KEY : process.env.OPENAI_API_KEY);
+        const model = this.options.model ??
+            (provider === "anthropic" ? "claude-3-5-haiku-latest" : "gpt-4o-mini");
+        if (!apiKey) {
+            return new HeuristicSummarizer().summarize(ledger);
+        }
+        const eventsText = formatLedgerForPrompt(ledger);
+        const prompt = `You are compiling a Continuation Packet from an agent session ledger.
+Analyze the chronological events below and extract:
+1. The overall task objective (concise).
+2. The current plan steps, their numbers, descriptions, and statuses (done, in_progress, pending). Note any progress or details.
+3. Key decisions made during the session (what was decided, why, and a reference line or tool/event context).
+4. The immediate next steps to continue this task.
+5. Critical warnings or constraints.
+
+Output a valid JSON object matching this schema exactly (do not output any other text or markdown wrappers):
+{
+  "objective": "overall objective",
+  "planSteps": [
+    { "n": 1, "desc": "Step description", "status": "done" | "in_progress" | "pending", "note": "optional details" }
+  ],
+  "decisions": [
+    { "what": "decision description", "why": "rationale for decision", "ref": "optional reference context" }
+  ],
+  "next": ["next step 1", "next step 2"],
+  "warnings": ["warning 1"]
+}
+
+Ledger Events:
+${eventsText}`;
+        try {
+            let jsonText = "";
+            if (provider === "anthropic") {
+                const baseURL = this.options.baseURL ?? "https://api.anthropic.com";
+                const res = await fetch(`${baseURL}/v1/messages`, {
+                    method: "POST",
+                    headers: {
+                        "x-api-key": apiKey,
+                        "anthropic-version": "2023-06-01",
+                        "Content-Type": "application/json",
+                    },
+                    body: JSON.stringify({
+                        model,
+                        max_tokens: 4000,
+                        messages: [{ role: "user", content: prompt }],
+                    }),
+                });
+                if (!res.ok) {
+                    throw new Error(`Anthropic API returned status ${res.status}`);
+                }
+                const data = await res.json();
+                const text = data?.content?.[0]?.text;
+                jsonText = extractJson(text || "");
+            }
+            else {
+                const baseURL = this.options.baseURL ?? "https://api.openai.com/v1";
+                const res = await fetch(`${baseURL}/chat/completions`, {
+                    method: "POST",
+                    headers: {
+                        "Authorization": `Bearer ${apiKey}`,
+                        "Content-Type": "application/json",
+                    },
+                    body: JSON.stringify({
+                        model,
+                        messages: [{ role: "user", content: prompt }],
+                        response_format: { type: "json_object" },
+                    }),
+                });
+                if (!res.ok) {
+                    throw new Error(`OpenAI API returned status ${res.status}`);
+                }
+                const data = await res.json();
+                const text = data?.choices?.[0]?.message?.content;
+                jsonText = text || "";
+            }
+            const parsed = JSON.parse(jsonText);
+            return {
+                objective: parsed.objective || new HeuristicSummarizer().summarize(ledger).objective,
+                planSteps: Array.isArray(parsed.planSteps) ? parsed.planSteps : [],
+                decisions: Array.isArray(parsed.decisions) ? parsed.decisions : [],
+                next: Array.isArray(parsed.next) ? parsed.next.map(String) : new HeuristicSummarizer().summarize(ledger).next,
+                warnings: Array.isArray(parsed.warnings) ? parsed.warnings.map(String) : new HeuristicSummarizer().summarize(ledger).warnings,
+            };
+        }
+        catch {
+            return new HeuristicSummarizer().summarize(ledger);
+        }
+    }
+}
+function formatLedgerForPrompt(ledger) {
+    return ledger.events.map((e) => {
+        const at = e.at ? ` [${e.at}]` : "";
+        let detail = "";
+        if (e.type === "message.user" || e.type === "message.assistant" || e.type === "task.started") {
+            detail = `: ${e.content}`;
+        }
+        else if (e.type === "tool.called" && e.tool) {
+            detail = `: ${e.tool.name}(${JSON.stringify(e.tool.input ?? {})})`;
+        }
+        else if ((e.type === "tool.completed" || e.type === "tool.failed") && e.tool) {
+            detail = `: ${e.tool.name} -> ${e.tool.outcome}`;
+        }
+        return `[${e.seq}] ${e.type}${at}${detail}`;
+    }).join("\n");
+}
+function extractJson(text) {
+    const start = text.indexOf("{");
+    const end = text.lastIndexOf("}");
+    if (start !== -1 && end !== -1 && end > start) {
+        return text.substring(start, end + 1);
+    }
+    return text;
+}
+//# sourceMappingURL=summarize.js.map

package/dist/summarize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize.js","sourceRoot":"","sources":["../src/summarize.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,gBAAgB,EAChB,aAAa,EACb,QAAQ,GAEX,MAAM,aAAa,CAAC;AAuBrB,MAAM,OAAO,mBAAmB;IACnB,EAAE,GAAG,WAAW,CAAC;IAE1B,SAAS,CAAC,MAAc;QACpB,MAAM,SAAS,GAAG,QAAQ,CACtB,gBAAgB,CAAC,MAAM,CAAC,IAAI,4CAA4C,EACxE,GAAG,CACN,CAAC;QAEF,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,mEAAmE;QACnE,KAAK,MAAM,KAAK,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC9E,QAAQ,CAAC,IAAI,CACT,yEAAyE,IAAI,EAAE,CAClF,CAAC;QACN,CAAC;QAED,uDAAuD;QACvD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC;QAC/E,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAElD,IAAI,WAAW,EAAE,IAAI,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACxF,IAAI,CAAC,IAAI,CAAC,iCAAiC,IAAI,MAAM,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,IAAI,WAAW,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACnH,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,oEAAoE,CAAC,CAAC;QAC1G,CAAC;QAED,uEAAuE;QACvE,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC;QAC9F,MAAM,aAAa,GAAG,iBAAiB,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAEtE,IAAI,aAAa,EAAE,OAAO,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,mDAAmD,QAAQ,CAAC,aAAa,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1G,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;QAEjF,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,QAAQ,CAAC,IAAI,CACT,yBAAyB,WAAW,CAAC,MAAM,6DAA6D,CAC3G,CAAC;QACN,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,qFAAqF,CAAC,CAAC;QAEjG,OAAO;YACH,SAAS;YACT,SAAS,EAAE,EAAE;YACb,SAAS,EAAE,EAAE;YACb,IAAI;YACJ,QAAQ;SACX,CAAC;IACN,CAAC;CACJ;AASD,MAAM,OAAO,aAAa;IACb,EAAE,GAAG,KAAK,CAAC;IACZ,OAAO,CAAuB;IAEtC,YAAY,UAAgC,EAAE;QAC1C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAc;QAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ;YAClC,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM;YAC9B,CAAC,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC5F,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK;YAC5B,CAAC,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;QAE3E,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,OAAO,IAAI,mBAAmB,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,UAAU,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;EAsBrB,UAAU,EAAE,CAAC;QAEP,IAAI,CAAC;YACD,IAAI,QAAQ,GAAG,EAAE,CAAC;YAElB,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;gBAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,2BAA2B,CAAC;gBACpE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,cAAc,EAAE;oBAC9C,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE;wBACL,WAAW,EAAE,MAAM;wBACnB,mBAAmB,EAAE,YAAY;wBACjC,cAAc,EAAE,kBAAkB;qBACrC;oBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACjB,KAAK;wBACL,UAAU,EAAE,IAAI;wBAChB,QAAQ,EAAE,CAAC,EAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAC,CAAC;qBAC9C,CAAC;iBACL,CAAC,CAAC;gBAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;oBACV,MAAM,IAAI,KAAK,CAAC,iCAAiC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;gBACnE,CAAC;gBAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAS,CAAC;gBACrC,MAAM,IAAI,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAc,CAAC;gBAChD,QAAQ,GAAG,WAAW,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YACvC,CAAC;iBAAM,CAAC;gBACJ,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,2BAA2B,CAAC;gBACpE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,mBAAmB,EAAE;oBACnD,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE;wBACL,eAAe,EAAE,UAAU,MAAM,EAAE;wBACnC,cAAc,EAAE,kBAAkB;qBACrC;oBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACjB,KAAK;wBACL,QAAQ,EAAE,CAAC,EAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAC,CAAC;wBAC3C,eAAe,EAAE,EAAC,IAAI,EAAE,aAAa,EAAC;qBACzC,CAAC;iBACL,CAAC,CAAC;gBAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;oBACV,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;gBAChE,CAAC;gBAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAS,CAAC;gBACrC,MAAM,IAAI,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAiB,CAAC;gBAC5D,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC;YAC1B,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAqB,CAAC;YAExD,OAAO;gBACH,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI,mBAAmB,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,SAAS;gBACpF,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;gBAClE,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;gBAClE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,mBAAmB,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI;gBAC7G,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,mBAAmB,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ;aAChI,CAAC;QACN,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,IAAI,mBAAmB,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACvD,CAAC;IACL,CAAC;CACJ;AAED,SAAS,qBAAqB,CAAC,MAAc;IACzC,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC3B,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACpC,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,CAAC,IAAI,KAAK,cAAc,IAAI,CAAC,CAAC,IAAI,KAAK,mBAAmB,IAAI,CAAC,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAC3F,MAAM,GAAG,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;QAC9B,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,aAAa,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YAC5C,MAAM,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,CAAC;QACvE,CAAC;aAAM,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,gBAAgB,IAAI,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YAC7E,MAAM,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACrD,CAAC;QACD,OAAO,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAChD,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,GAAG,GAAG,KAAK,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@samjurnio_/memento",
+  "version": "0.2.0",
+  "description": "Cross-agent session continuity: hand off in-progress coding tasks between Claude Code, Codex, Gemini CLI, Pi and others.",
+  "type": "module",
+  "license": "Apache-2.0",
+  "author": "Samwel Charles <hi@samjunior.dev>",
+  "bin": {
+    "memento": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "schemas",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22.5.0"
+  },
+  "scripts": {
+    "dev": "tsx src/cli.ts",
+    "build": "tsc && chmod +x dist/cli.js",
+    "typecheck": "tsc --noEmit",
+    "test": "node --import tsx --test \"src/**/*.test.ts\"",
+    "schema": "tsx src/cli.ts schema > schemas/packet.v1.schema.json",
+    "pack:dry": "npm pack --dry-run",
+    "smoke:pack": "mkdir -p /tmp/memento-pack-smoke && pnpm pack --pack-destination /tmp/memento-pack-smoke && npm exec --yes --package /tmp/memento-pack-smoke/samjurnio_-memento-$(node -p \"require('./package.json').version\").tgz -- memento version",
+    "prepack": "pnpm build && pnpm schema",
+    "prepublishOnly": "pnpm typecheck && pnpm test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/younggeeks/memento.git"
+  },
+  "homepage": "https://github.com/younggeeks/memento#readme",
+  "bugs": {
+    "url": "https://github.com/younggeeks/memento/issues"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "claude",
+    "codex",
+    "gemini",
+    "session-continuity",
+    "handoff",
+    "mcp"
+  ]
+}