agentsmcp-langgraph 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AgentMailbox contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,98 @@
+# agentsmcp-langgraph
+
+LangGraph checkpointer backed by [agentsmcp](https://www.npmjs.com/package/agentsmcp).
+Drop-in `BaseCheckpointSaver` — your graph state lives in an AgentMailbox
+thread, so it survives process restarts, runs across machines, and is
+inspectable from any other agentsmcp client.
+
+## Install
+
+```bash
+npm install agentsmcp-langgraph @langchain/langgraph
+```
+
+You'll also need an agentsmcp HTTP server reachable from your process.
+Run it locally with `npx agentsmcp-server`, or point at any deployment.
+
+## Usage
+
+```ts
+import { StateGraph } from "@langchain/langgraph";
+import { AgentsmcpSaver } from "agentsmcp-langgraph";
+
+const checkpointer = new AgentsmcpSaver({
+  server: process.env.AGENTSMCP_SERVER ?? "http://localhost:3000",
+  agentId: "langgraph@my-app",         // stable identity = stable threads
+  apiKey: process.env.AGENTSMCP_API_KEY,
+});
+await checkpointer.connect();
+
+const graph = workflow.compile({ checkpointer });
+
+await graph.invoke(input, {
+  configurable: { thread_id: "session-abc" },
+});
+```
+
+Restart the process, invoke again with the same `thread_id`, and the
+graph picks up exactly where it left off. Same property in another
+process on another machine, as long as `agentId` and `thread_id` match.
+
+## How it maps
+
+| LangGraph | agentsmcp |
+| --- | --- |
+| `thread_id` (RunnableConfig) | One thread per `thread_id` |
+| `checkpoint_id` (uuid6) | Stored in the message payload |
+| `Checkpoint` bytes | Base64'd into `payload.checkpoint` |
+| `CheckpointMetadata` bytes | Base64'd into `payload.metadata` |
+| `pendingWrites` | Sibling messages of `kind: "writes"`, merged on read |
+| `checkpoint_ns` | Filter tag inside the payload — subgraphs isolated |
+
+The recipient on every message is the synthetic agent
+`{thread_id}@checkpoints`. It's never real; it just gives the thread
+a stable identity so cold-restart can look it up by participant.
+
+## What you get vs `MemorySaver` / `SqliteSaver`
+
+- **Cross-process** — write from one node, read from another. No file
+  to share, no DB to provision; just an HTTP URL.
+- **Inspectable** — every checkpoint is a message on a thread. Any
+  agentsmcp client (the JS/Python SDK, the MCP adapter, `curl`) can
+  read the state of your graph at any point in its history.
+- **Compressed when long** — once a thread crosses the configured
+  compression threshold (default 20 messages), the agentsmcp server
+  folds older checkpoints into a structured summary that you can use
+  alongside the verbatim recent window. Useful for very long graphs
+  where re-reading every checkpoint is wasteful.
+
+## Configuration
+
+```ts
+new AgentsmcpSaver({
+  server,   // default: AGENTSMCP_SERVER env, then localhost:3000
+  agentId,  // default: AGENTSMCP_AGENT_ID env, then `langgraph@<hostname>`
+  apiKey,   // default: AGENTSMCP_API_KEY env
+  serde,    // default: LangGraph's JsonPlusSerializer
+});
+```
+
+If you want every process to share state, pin `agentId` to a stable
+string. If you want each process to have its own slice, let it default
+to the hostname.
+
+## Limitations (worth knowing)
+
+- **`list()` reads the whole thread.** Fine for ~hundreds of
+  checkpoints. For very long threads, lean on compression and accept
+  that `list()` is paginated client-side.
+- **No deduplication of repeat `put()`.** The agentsmcp server assigns
+  message IDs server-side, so a re-put produces a duplicate row;
+  `getTuple()` and `list()` dedupe by `checkpoint_id` on read.
+- **Checkpoint writes are O(1) — but always a network round-trip.**
+  If your graph checkpoints aggressively in a hot loop, that's a real
+  cost; pair this saver with a local agentsmcp server for low latency.
+
+## License
+
+MIT — see [LICENSE](../LICENSE).

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { AgentsmcpSaver, type AgentsmcpSaverOptions } from "./saver";
+export type { CheckpointContext, CheckpointPayload, PendingWriteWire, WritesPayload, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,SAAS,CAAC;AACrE,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,GACd,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentsmcpSaver = void 0;
+var saver_1 = require("./saver");
+Object.defineProperty(exports, "AgentsmcpSaver", { enumerable: true, get: function () { return saver_1.AgentsmcpSaver; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iCAAqE;AAA5D,uGAAA,cAAc,OAAA"}

package/dist/os-shim.d.ts

@@ -0,0 +1,3 @@
+import * as nodeOs from "os";
+export declare const os: typeof nodeOs;
+//# sourceMappingURL=os-shim.d.ts.map

package/dist/os-shim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"os-shim.d.ts","sourceRoot":"","sources":["../src/os-shim.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,MAAM,IAAI,CAAC;AAC7B,eAAO,MAAM,EAAE,eAAS,CAAC"}

package/dist/os-shim.js

@@ -0,0 +1,41 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.os = void 0;
+// Small re-export so the saver can import "os" without TS module-resolution
+// gymnastics under commonjs+esModuleInterop=true.
+const nodeOs = __importStar(require("os"));
+exports.os = nodeOs;
+//# sourceMappingURL=os-shim.js.map

package/dist/os-shim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"os-shim.js","sourceRoot":"","sources":["../src/os-shim.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4EAA4E;AAC5E,kDAAkD;AAClD,2CAA6B;AAChB,QAAA,EAAE,GAAG,MAAM,CAAC"}

package/dist/saver.d.ts

@@ -0,0 +1,53 @@
+import type { RunnableConfig } from "@langchain/core/runnables";
+import { BaseCheckpointSaver, type Checkpoint, type CheckpointListOptions, type CheckpointMetadata, type CheckpointTuple, type ChannelVersions, type PendingWrite, type SerializerProtocol } from "@langchain/langgraph-checkpoint";
+import type { ContextFrame } from "agentsmcp";
+export interface AgentsmcpSaverOptions {
+    /** Where the agentsmcp HTTP server lives. Defaults to env or localhost:3000. */
+    server?: string;
+    /**
+     * Agent identity this saver writes as. Defaults to
+     * `langgraph@<hostname>`. Use a stable id so threads persist across
+     * process restarts.
+     */
+    agentId?: string;
+    /** Bearer token forwarded to agentsmcp. Defaults to env. */
+    apiKey?: string;
+    /** Plug your own LangGraph serializer if you have a custom one. */
+    serde?: SerializerProtocol;
+}
+/**
+ * LangGraph BaseCheckpointSaver backed by an agentsmcp HTTP server.
+ *
+ * One LangGraph thread (`config.configurable.thread_id`) maps to one
+ * agentsmcp thread. Every checkpoint and every batch of intermediate
+ * writes becomes one message on that thread. Process restart resumes
+ * by reading the thread.
+ *
+ * AgentsmcpSaver intentionally does not implement deterministic message
+ * IDs — the agentsmcp server generates them. Instead the LangGraph
+ * `checkpoint_id` is carried inside the payload and used as the
+ * primary key on read.
+ */
+export declare class AgentsmcpSaver extends BaseCheckpointSaver {
+    private readonly mail;
+    private readonly agentId;
+    private connected;
+    /** langgraph thread_id → agentsmcp threadId (resolved lazily) */
+    private readonly threadCache;
+    constructor(opts?: AgentsmcpSaverOptions);
+    /** Register this saver's agent identity with the server. Idempotent. */
+    connect(): Promise<void>;
+    getTuple(config: RunnableConfig): Promise<CheckpointTuple | undefined>;
+    list(config: RunnableConfig, options?: CheckpointListOptions): AsyncGenerator<CheckpointTuple>;
+    put(config: RunnableConfig, checkpoint: Checkpoint, metadata: CheckpointMetadata, _newVersions: ChannelVersions): Promise<RunnableConfig>;
+    putWrites(config: RunnableConfig, writes: PendingWrite[], taskId: string): Promise<void>;
+    /**
+     * Look up the agentsmcp threadId for a given LangGraph thread_id.
+     * Hits the cache first; falls back to a thread listing on first call
+     * after a process restart.
+     */
+    private resolveThread;
+    private messageToTuple;
+}
+export type { ContextFrame };
+//# sourceMappingURL=saver.d.ts.map

package/dist/saver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"saver.d.ts","sourceRoot":"","sources":["../src/saver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EACL,mBAAmB,EACnB,KAAK,UAAU,EACf,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EAEvB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACxB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,KAAK,EAAE,YAAY,EAAW,MAAM,WAAW,CAAC;AAUvD,MAAM,WAAW,qBAAqB;IACpC,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC5B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,cAAe,SAAQ,mBAAmB;IACrD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,iEAAiE;IACjE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;gBAE7C,IAAI,GAAE,qBAA0B;IAqB5C,wEAAwE;IAClE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAUxB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAgCrE,IAAI,CACT,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,cAAc,CAAC,eAAe,CAAC;IAmD5B,GAAG,CACP,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,kBAAkB,EAC5B,YAAY,EAAE,eAAe,GAC5B,OAAO,CAAC,cAAc,CAAC;IAsDpB,SAAS,CACb,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,YAAY,EAAE,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IA2ChB;;;;OAIG;YACW,aAAa;YAmBb,cAAc;CAwE7B;AAuCD,YAAY,EAAE,YAAY,EAAE,CAAC"}

package/dist/saver.js

@@ -0,0 +1,287 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentsmcpSaver = void 0;
+const os_shim_1 = require("./os-shim");
+const langgraph_checkpoint_1 = require("@langchain/langgraph-checkpoint");
+const agentsmcp_1 = require("agentsmcp");
+const serializer_1 = require("./serializer");
+/**
+ * LangGraph BaseCheckpointSaver backed by an agentsmcp HTTP server.
+ *
+ * One LangGraph thread (`config.configurable.thread_id`) maps to one
+ * agentsmcp thread. Every checkpoint and every batch of intermediate
+ * writes becomes one message on that thread. Process restart resumes
+ * by reading the thread.
+ *
+ * AgentsmcpSaver intentionally does not implement deterministic message
+ * IDs — the agentsmcp server generates them. Instead the LangGraph
+ * `checkpoint_id` is carried inside the payload and used as the
+ * primary key on read.
+ */
+class AgentsmcpSaver extends langgraph_checkpoint_1.BaseCheckpointSaver {
+    constructor(opts = {}) {
+        super(opts.serde);
+        this.connected = false;
+        /** langgraph thread_id → agentsmcp threadId (resolved lazily) */
+        this.threadCache = new Map();
+        const server = opts.server ??
+            process.env.AGENTSMCP_SERVER ??
+            process.env.AGENTMAILBOX_SERVER ??
+            "http://localhost:3000";
+        this.agentId =
+            opts.agentId ??
+                process.env.AGENTSMCP_AGENT_ID ??
+                `langgraph@${os_shim_1.os.hostname()}`;
+        this.mail = new agentsmcp_1.AgentMailbox({
+            agentId: this.agentId,
+            server,
+            apiKey: opts.apiKey ??
+                process.env.AGENTSMCP_API_KEY ??
+                process.env.AGENTMAILBOX_API_KEY,
+        });
+    }
+    /** Register this saver's agent identity with the server. Idempotent. */
+    async connect() {
+        if (this.connected)
+            return;
+        await this.mail.connect();
+        this.connected = true;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // BaseCheckpointSaver surface
+    // ─────────────────────────────────────────────────────────────────
+    async getTuple(config) {
+        await this.connect();
+        const thread_id = requireThreadId(config);
+        const checkpoint_ns = config.configurable?.checkpoint_ns ?? "";
+        const requested_id = config.configurable?.checkpoint_id;
+        const agentsmcpThreadId = await this.resolveThread(thread_id);
+        if (!agentsmcpThreadId)
+            return undefined;
+        const messages = await this.mail.threads().then(async (threads) => {
+            const t = threads.find((x) => x.id === agentsmcpThreadId);
+            return t ? t.messages : [];
+        });
+        const checkpointMsgs = messages.filter((m) => isCheckpointPayload(m.payload) && m.payload.checkpoint_ns === checkpoint_ns);
+        let target = requested_id
+            ? checkpointMsgs.find((m) => isCheckpointPayload(m.payload) &&
+                m.payload.checkpoint_id === requested_id)
+            : checkpointMsgs[checkpointMsgs.length - 1];
+        if (!target)
+            return undefined;
+        return this.messageToTuple(target, messages, thread_id, checkpoint_ns);
+    }
+    async *list(config, options) {
+        await this.connect();
+        const thread_id = requireThreadId(config);
+        const configured_ns = config.configurable?.checkpoint_ns;
+        const agentsmcpThreadId = await this.resolveThread(thread_id);
+        if (!agentsmcpThreadId)
+            return;
+        const threads = await this.mail.threads();
+        const t = threads.find((x) => x.id === agentsmcpThreadId);
+        if (!t)
+            return;
+        const messages = t.messages;
+        const checkpointMsgs = messages.filter((m) => {
+            if (!isCheckpointPayload(m.payload))
+                return false;
+            if (configured_ns !== undefined && m.payload.checkpoint_ns !== configured_ns) {
+                return false;
+            }
+            if (options?.before?.configurable?.checkpoint_id) {
+                const cutoff = options.before.configurable.checkpoint_id;
+                // LangGraph checkpoint_ids are uuid6 / lexicographically sortable.
+                return m.payload.checkpoint_id < cutoff;
+            }
+            return true;
+        });
+        // Newest first. agentsmcp returns messages timestamp-ascending.
+        checkpointMsgs.reverse();
+        const seenCheckpointIds = new Set();
+        let emitted = 0;
+        for (const m of checkpointMsgs) {
+            const cpId = m.payload.checkpoint_id;
+            if (seenCheckpointIds.has(cpId))
+                continue; // dedupe repeated put
+            seenCheckpointIds.add(cpId);
+            if (options?.limit !== undefined && emitted >= options.limit)
+                break;
+            yield await this.messageToTuple(m, messages, thread_id, m.payload.checkpoint_ns);
+            emitted += 1;
+        }
+    }
+    async put(config, checkpoint, metadata, _newVersions) {
+        await this.connect();
+        const thread_id = requireThreadId(config);
+        const checkpoint_ns = config.configurable?.checkpoint_ns ?? "";
+        const parent_checkpoint_id = config.configurable?.checkpoint_id;
+        const checkpointBlob = await (0, serializer_1.dumpToBase64)(this.serde, checkpoint);
+        const metadataBlob = await (0, serializer_1.dumpToBase64)(this.serde, metadata);
+        const payload = {
+            kind: "checkpoint",
+            checkpoint: checkpointBlob.data,
+            metadata: metadataBlob.data,
+            checkpoint_ns,
+            checkpoint_id: checkpoint.id,
+            parent_checkpoint_id,
+        };
+        // Stash the serializer type tags alongside in contextSnapshot so we
+        // can round-trip without hardcoding "json".
+        const ctx = {
+            checkpoint_id: checkpoint.id,
+            checkpoint_ns,
+            thread_id,
+            step: metadata.step ?? -1,
+            source: metadata.source ?? "input",
+            _checkpoint_type: checkpointBlob.type,
+            _metadata_type: metadataBlob.type,
+        };
+        const existing = this.threadCache.get(thread_id);
+        const sendResult = await this.mail.send(syntheticRecipient(thread_id), payload, {
+            threadId: existing,
+            contextSnapshot: ctx,
+        });
+        this.threadCache.set(thread_id, sendResult.threadId);
+        return {
+            configurable: {
+                thread_id,
+                checkpoint_ns,
+                checkpoint_id: checkpoint.id,
+            },
+        };
+    }
+    async putWrites(config, writes, taskId) {
+        await this.connect();
+        const thread_id = requireThreadId(config);
+        const checkpoint_ns = config.configurable?.checkpoint_ns ?? "";
+        const checkpoint_id = config.configurable?.checkpoint_id;
+        if (!checkpoint_id) {
+            throw new Error("AgentsmcpSaver.putWrites: config.configurable.checkpoint_id is required");
+        }
+        const wireWrites = await Promise.all(writes.map(async ([channel, value]) => {
+            const blob = await (0, serializer_1.dumpToBase64)(this.serde, value);
+            return { taskId, channel, value: blob.data, type: blob.type };
+        }));
+        const payload = {
+            kind: "writes",
+            checkpoint_id,
+            checkpoint_ns,
+            writes: wireWrites,
+        };
+        const existing = this.threadCache.get(thread_id);
+        const sendResult = await this.mail.send(syntheticRecipient(thread_id), payload, {
+            threadId: existing,
+            contextSnapshot: { kind: "writes", checkpoint_id, taskId, checkpoint_ns },
+        });
+        this.threadCache.set(thread_id, sendResult.threadId);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Private helpers
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Look up the agentsmcp threadId for a given LangGraph thread_id.
+     * Hits the cache first; falls back to a thread listing on first call
+     * after a process restart.
+     */
+    async resolveThread(langgraphThreadId) {
+        const cached = this.threadCache.get(langgraphThreadId);
+        if (cached)
+            return cached;
+        const recipient = syntheticRecipient(langgraphThreadId);
+        const threads = await this.mail.threads();
+        const match = threads.find((t) => t.participants.includes(recipient) ||
+            t.silentParticipants.includes(recipient));
+        if (match) {
+            this.threadCache.set(langgraphThreadId, match.id);
+            return match.id;
+        }
+        return undefined;
+    }
+    async messageToTuple(checkpointMsg, allMessages, thread_id, checkpoint_ns) {
+        if (!isCheckpointPayload(checkpointMsg.payload)) {
+            throw new Error("messageToTuple called with non-checkpoint message");
+        }
+        const cp = checkpointMsg.payload;
+        const ctx = checkpointMsg.contextSnapshot;
+        const checkpoint = await (0, serializer_1.loadFromBase64)(this.serde, {
+            type: ctx._checkpoint_type ?? "json",
+            data: cp.checkpoint,
+        });
+        const metadata = await (0, serializer_1.loadFromBase64)(this.serde, {
+            type: ctx._metadata_type ?? "json",
+            data: cp.metadata,
+        });
+        // Merge any writes messages that came AFTER this checkpoint message
+        // but before the next checkpoint message on the same ns. Those are
+        // this checkpoint's pendingWrites.
+        const idx = allMessages.findIndex((m) => m.id === checkpointMsg.id);
+        const pendingWrites = [];
+        for (let i = idx + 1; i < allMessages.length; i++) {
+            const m = allMessages[i];
+            if (isCheckpointPayload(m.payload)) {
+                if (m.payload.checkpoint_ns === cp.checkpoint_ns)
+                    break;
+                continue;
+            }
+            if (isWritesPayload(m.payload) &&
+                m.payload.checkpoint_id === cp.checkpoint_id &&
+                m.payload.checkpoint_ns === cp.checkpoint_ns) {
+                for (const w of m.payload.writes) {
+                    const value = await (0, serializer_1.loadFromBase64)(this.serde, {
+                        type: w.type,
+                        data: w.value,
+                    });
+                    pendingWrites.push([w.taskId, w.channel, value]);
+                }
+            }
+        }
+        const tuple = {
+            config: {
+                configurable: {
+                    thread_id,
+                    checkpoint_ns: cp.checkpoint_ns,
+                    checkpoint_id: cp.checkpoint_id,
+                },
+            },
+            checkpoint,
+            metadata,
+            pendingWrites,
+        };
+        if (cp.parent_checkpoint_id) {
+            tuple.parentConfig = {
+                configurable: {
+                    thread_id,
+                    checkpoint_ns: cp.checkpoint_ns,
+                    checkpoint_id: cp.parent_checkpoint_id,
+                },
+            };
+        }
+        return tuple;
+    }
+}
+exports.AgentsmcpSaver = AgentsmcpSaver;
+// ───────────────────────────────────────────────────────────────────
+// Module-private helpers
+// ───────────────────────────────────────────────────────────────────
+function syntheticRecipient(threadId) {
+    return `${threadId}@checkpoints`;
+}
+function requireThreadId(config) {
+    const id = config.configurable?.thread_id;
+    if (typeof id !== "string" || id.length === 0) {
+        throw new Error("config.configurable.thread_id is required for AgentsmcpSaver");
+    }
+    return id;
+}
+function isCheckpointPayload(p) {
+    return (typeof p === "object" &&
+        p !== null &&
+        p.kind === "checkpoint");
+}
+function isWritesPayload(p) {
+    return (typeof p === "object" &&
+        p !== null &&
+        p.kind === "writes");
+}
+//# sourceMappingURL=saver.js.map

package/dist/saver.js.map

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

package/dist/serializer.d.ts

@@ -0,0 +1,13 @@
+import type { SerializerProtocol } from "@langchain/langgraph-checkpoint";
+/**
+ * LangGraph's serializer returns `[type: string, bytes: Uint8Array]`.
+ * agentsmcp's JSON wire format can't carry binary, so we base64-encode
+ * the bytes and keep the type tag alongside.
+ */
+export interface SerializedTyped {
+    type: string;
+    data: string;
+}
+export declare function dumpToBase64(serde: SerializerProtocol, value: unknown): Promise<SerializedTyped>;
+export declare function loadFromBase64<T = unknown>(serde: SerializerProtocol, s: SerializedTyped): Promise<T>;
+//# sourceMappingURL=serializer.d.ts.map

package/dist/serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../src/serializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAE1E;;;;GAIG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,YAAY,CAChC,KAAK,EAAE,kBAAkB,EACzB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,eAAe,CAAC,CAG1B;AAED,wBAAsB,cAAc,CAAC,CAAC,GAAG,OAAO,EAC9C,KAAK,EAAE,kBAAkB,EACzB,CAAC,EAAE,eAAe,GACjB,OAAO,CAAC,CAAC,CAAC,CAGZ"}

package/dist/serializer.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dumpToBase64 = dumpToBase64;
+exports.loadFromBase64 = loadFromBase64;
+async function dumpToBase64(serde, value) {
+    const [type, bytes] = await serde.dumpsTyped(value);
+    return { type, data: bytesToBase64(bytes) };
+}
+async function loadFromBase64(serde, s) {
+    const bytes = base64ToBytes(s.data);
+    return (await serde.loadsTyped(s.type, bytes));
+}
+function bytesToBase64(bytes) {
+    // Buffer is available everywhere we run (Node 18+).
+    return Buffer.from(bytes).toString("base64");
+}
+function base64ToBytes(b64) {
+    return new Uint8Array(Buffer.from(b64, "base64"));
+}
+//# sourceMappingURL=serializer.js.map

package/dist/serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.js","sourceRoot":"","sources":["../src/serializer.ts"],"names":[],"mappings":";;AAaA,oCAMC;AAED,wCAMC;AAdM,KAAK,UAAU,YAAY,CAChC,KAAyB,EACzB,KAAc;IAEd,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACpD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;AAC9C,CAAC;AAEM,KAAK,UAAU,cAAc,CAClC,KAAyB,EACzB,CAAkB;IAElB,MAAM,KAAK,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACpC,OAAO,CAAC,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAM,CAAC;AACtD,CAAC;AAED,SAAS,aAAa,CAAC,KAAiB;IACtC,oDAAoD;IACpD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,aAAa,CAAC,GAAW;IAChC,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;AACpD,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Wire shapes the checkpointer writes into agentsmcp messages.
+ *
+ * Two kinds of messages live on the underlying thread:
+ *  - kind="checkpoint" — a full LangGraph checkpoint snapshot
+ *  - kind="writes"     — intermediate writes (putWrites) that get
+ *                        merged into the next checkpoint's pendingWrites
+ *
+ * Both are tagged so getTuple/list can filter without ambiguity.
+ */
+export interface CheckpointPayload {
+    kind: "checkpoint";
+    /** base64-encoded bytes from the LangGraph serializer */
+    checkpoint: string;
+    /** base64-encoded CheckpointMetadata bytes */
+    metadata: string;
+    /** "" for the root graph, "sub:name" for subgraphs */
+    checkpoint_ns: string;
+    /** LangGraph's checkpoint id (uuid6) — distinct from agentsmcp message id */
+    checkpoint_id: string;
+    /** id of the previous checkpoint on this thread/ns; undefined for the first */
+    parent_checkpoint_id?: string;
+}
+export interface PendingWriteWire {
+    taskId: string;
+    channel: string;
+    /** base64-encoded value bytes */
+    value: string;
+    /** LangGraph's value type tag returned by the serializer */
+    type: string;
+}
+export interface WritesPayload {
+    kind: "writes";
+    /** which checkpoint these writes belong to */
+    checkpoint_id: string;
+    checkpoint_ns: string;
+    writes: PendingWriteWire[];
+}
+/** Shape stored in agentsmcp's contextSnapshot for each checkpoint message. */
+export interface CheckpointContext extends Record<string, unknown> {
+    checkpoint_id: string;
+    checkpoint_ns: string;
+    thread_id: string;
+    step: number;
+    source: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,YAAY,CAAC;IACnB,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,aAAa,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,aAAa,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,+EAA+E;AAC/E,MAAM,WAAW,iBAAkB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAChE,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/types.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Wire shapes the checkpointer writes into agentsmcp messages.
+ *
+ * Two kinds of messages live on the underlying thread:
+ *  - kind="checkpoint" — a full LangGraph checkpoint snapshot
+ *  - kind="writes"     — intermediate writes (putWrites) that get
+ *                        merged into the next checkpoint's pendingWrites
+ *
+ * Both are tagged so getTuple/list can filter without ambiguity.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "agentsmcp-langgraph",
+  "version": "0.1.0",
+  "description": "LangGraph BaseCheckpointSaver backed by agentsmcp (AgentMailbox). Drop-in checkpointer for LangGraph.js — your graph state lives in an AgentMailbox thread.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "commonjs",
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "langgraph",
+    "langchain",
+    "checkpointer",
+    "agents",
+    "agentsmcp",
+    "agentmailbox"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RagavRida/agentsmcp.git",
+    "directory": "langgraph"
+  },
+  "homepage": "https://github.com/RagavRida/agentsmcp/tree/main/langgraph",
+  "bugs": {
+    "url": "https://github.com/RagavRida/agentsmcp/issues"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "agentsmcp": ">=0.3.5 <0.5.0"
+  },
+  "peerDependencies": {
+    "@langchain/langgraph-checkpoint": ">=0.0.10"
+  },
+  "devDependencies": {
+    "@langchain/langgraph-checkpoint": "^0.0.10",
+    "@types/node": "^22.5.0",
+    "typescript": "^5.5.4",
+    "vitest": "^2.0.0"
+  }
+}