@ironflow/langgraph 0.20.2 → 0.22.0

package/dist/encoding.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Base64 helpers — LangGraph's serde returns Uint8Array for serialized
+ * checkpoints/metadata/writes, but Ironflow's AppendEvent payload is JSON.
+ * Encode bytes as base64 strings on write; decode back to bytes on read.
+ */
+export declare function bytesToB64(bytes: Uint8Array): string;
+export declare function b64ToBytes(b64: string): Uint8Array;
+//# sourceMappingURL=encoding.d.ts.map

package/dist/encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../src/encoding.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEpD;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAElD"}

package/dist/encoding.js

@@ -0,0 +1,12 @@
+/**
+ * Base64 helpers — LangGraph's serde returns Uint8Array for serialized
+ * checkpoints/metadata/writes, but Ironflow's AppendEvent payload is JSON.
+ * Encode bytes as base64 strings on write; decode back to bytes on read.
+ */
+export function bytesToB64(bytes) {
+    return Buffer.from(bytes).toString("base64");
+}
+export function b64ToBytes(b64) {
+    return new Uint8Array(Buffer.from(b64, "base64"));
+}
+//# sourceMappingURL=encoding.js.map

package/dist/encoding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.js","sourceRoot":"","sources":["../src/encoding.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,UAAU,UAAU,CAAC,KAAiB;IAC1C,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;AACpD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @ironflow/langgraph — durable LangGraph checkpoint saver.
+ *
+ * Drop-in replacement for MemorySaver / SqliteSaver / PostgresSaver. Stores
+ * each thread's checkpoint stream in Ironflow as a per-thread entity stream
+ * (`irn:agent-ckpt:{thread_id}`), inheriting Ironflow's crash-resume,
+ * audit, and replay semantics.
+ *
+ * @example
+ * ```ts
+ * import { IronflowClient } from "@ironflow/node";
+ * import { IronflowSaver } from "@ironflow/langgraph";
+ * import { StateGraph } from "@langchain/langgraph";
+ *
+ * const client = new IronflowClient({ serverUrl: process.env.IRONFLOW_URL! });
+ * const saver = new IronflowSaver({ client });
+ * const graph = new StateGraph(...).compile({ checkpointer: saver });
+ * await graph.invoke(input, { configurable: { thread_id: "thread-1" } });
+ * ```
+ */
+export { IronflowSaver } from "./saver.js";
+export type { IronflowSaverConfig } from "./saver.js";
+//# 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;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+/**
+ * @ironflow/langgraph — durable LangGraph checkpoint saver.
+ *
+ * Drop-in replacement for MemorySaver / SqliteSaver / PostgresSaver. Stores
+ * each thread's checkpoint stream in Ironflow as a per-thread entity stream
+ * (`irn:agent-ckpt:{thread_id}`), inheriting Ironflow's crash-resume,
+ * audit, and replay semantics.
+ *
+ * @example
+ * ```ts
+ * import { IronflowClient } from "@ironflow/node";
+ * import { IronflowSaver } from "@ironflow/langgraph";
+ * import { StateGraph } from "@langchain/langgraph";
+ *
+ * const client = new IronflowClient({ serverUrl: process.env.IRONFLOW_URL! });
+ * const saver = new IronflowSaver({ client });
+ * const graph = new StateGraph(...).compile({ checkpointer: saver });
+ * await graph.invoke(input, { configurable: { thread_id: "thread-1" } });
+ * ```
+ */
+export { IronflowSaver } from "./saver.js";
+//# 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;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/saver.d.ts

@@ -0,0 +1,47 @@
+/**
+ * IronflowSaver — LangGraph BaseCheckpointSaver backed by Ironflow entity streams.
+ *
+ * Storage model:
+ *   - One entity stream per LangGraph thread, id = `irn:agent-ckpt:{thread_id}`
+ *   - entity_type = `agent-ckpt`
+ *   - Three event names:
+ *       checkpoint.put          — full checkpoint snapshot
+ *       checkpoint.putWrites    — pending writes for a task before next checkpoint
+ *       checkpoint.deleteThread — tombstone; drops all events at-or-before its position
+ *
+ * Replay semantics:
+ *   - put events use idempotency key `lg:put:{thread}:{ns}:{checkpoint_id}` so
+ *     server-side dedup makes re-puts a no-op (LangGraph re-emits the same
+ *     checkpoint_id on retry).
+ *   - putWrites events use no idempotency key — replays append fresh events and
+ *     materialize() dedupes by (taskId, idx) at read time. This matches
+ *     MemorySaver's cross-call accumulation: a second putWrites for the same
+ *     (checkpoint_id, task_id) with different writes adds them to the visible
+ *     pendingWrites list rather than dropping the whole event.
+ *
+ * Read path materializes the stream in memory. v1 is happy with full scans
+ * (typical thread has <100 events). Optimization via a managed projection
+ * is a separate issue once profiling shows it's worth it.
+ */
+import { BaseCheckpointSaver, type Checkpoint, type CheckpointListOptions, type CheckpointTuple, type ChannelVersions } from "@langchain/langgraph-checkpoint";
+import type { CheckpointMetadata, PendingWrite, SerializerProtocol } from "@langchain/langgraph-checkpoint";
+import type { RunnableConfig } from "@langchain/core/runnables";
+import type { IronflowClient } from "@ironflow/node";
+export interface IronflowSaverConfig {
+    /** Ironflow client used for stream reads/writes. */
+    client: IronflowClient;
+    /** Optional serializer override. Default: BaseCheckpointSaver's JSON serde. */
+    serde?: SerializerProtocol;
+}
+export declare class IronflowSaver extends BaseCheckpointSaver {
+    private readonly client;
+    constructor(config: IronflowSaverConfig);
+    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>;
+    deleteThread(threadId: string): Promise<void>;
+    private readStream;
+    private toTuple;
+}
+//# 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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EACL,mBAAmB,EACnB,KAAK,UAAU,EACf,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EAEpB,KAAK,eAAe,EAGrB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EACV,kBAAkB,EAElB,YAAY,EACZ,kBAAkB,EACnB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAkCrD,MAAM,WAAW,mBAAmB;IAClC,oDAAoD;IACpD,MAAM,EAAE,cAAc,CAAC;IACvB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC5B;AAED,qBAAa,aAAc,SAAQ,mBAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;gBAE5B,MAAM,EAAE,mBAAmB;IAKjC,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAiBrE,IAAI,CACT,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,cAAc,CAAC,eAAe,CAAC;IA0C5B,GAAG,CACP,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,kBAAkB,EAC5B,YAAY,EAAE,eAAe,GAC5B,OAAO,CAAC,cAAc,CAAC;IAwCpB,SAAS,CACb,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,YAAY,EAAE,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IA0CV,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAcrC,UAAU;YAkBV,OAAO;CAkDtB"}

package/dist/saver.js

@@ -0,0 +1,299 @@
+/**
+ * IronflowSaver — LangGraph BaseCheckpointSaver backed by Ironflow entity streams.
+ *
+ * Storage model:
+ *   - One entity stream per LangGraph thread, id = `irn:agent-ckpt:{thread_id}`
+ *   - entity_type = `agent-ckpt`
+ *   - Three event names:
+ *       checkpoint.put          — full checkpoint snapshot
+ *       checkpoint.putWrites    — pending writes for a task before next checkpoint
+ *       checkpoint.deleteThread — tombstone; drops all events at-or-before its position
+ *
+ * Replay semantics:
+ *   - put events use idempotency key `lg:put:{thread}:{ns}:{checkpoint_id}` so
+ *     server-side dedup makes re-puts a no-op (LangGraph re-emits the same
+ *     checkpoint_id on retry).
+ *   - putWrites events use no idempotency key — replays append fresh events and
+ *     materialize() dedupes by (taskId, idx) at read time. This matches
+ *     MemorySaver's cross-call accumulation: a second putWrites for the same
+ *     (checkpoint_id, task_id) with different writes adds them to the visible
+ *     pendingWrites list rather than dropping the whole event.
+ *
+ * Read path materializes the stream in memory. v1 is happy with full scans
+ * (typical thread has <100 events). Optimization via a managed projection
+ * is a separate issue once profiling shows it's worth it.
+ */
+import { BaseCheckpointSaver, WRITES_IDX_MAP, copyCheckpoint, getCheckpointId, } from "@langchain/langgraph-checkpoint";
+import { IronflowError } from "@ironflow/core";
+import { b64ToBytes, bytesToB64 } from "./encoding.js";
+const ENTITY_TYPE = "agent-ckpt";
+const EVT_PUT = "checkpoint.put";
+const EVT_PUT_WRITES = "checkpoint.putWrites";
+const EVT_DELETE = "checkpoint.deleteThread";
+const READ_BATCH = 500;
+export class IronflowSaver extends BaseCheckpointSaver {
+    client;
+    constructor(config) {
+        super(config.serde);
+        this.client = config.client;
+    }
+    async getTuple(config) {
+        const threadId = requireThreadId(config);
+        const ns = config.configurable?.checkpoint_ns ?? "";
+        const requestedId = getCheckpointId(config);
+        const events = await this.readStream(threadId);
+        const view = materialize(events, ns);
+        if (!view)
+            return undefined;
+        const target = requestedId
+            ? view.checkpoints.get(requestedId)
+            : view.latest;
+        if (!target)
+            return undefined;
+        return await this.toTuple(target, ns, threadId, view, requestedId ? config : undefined);
+    }
+    async *list(config, options) {
+        const { before, limit, filter } = options ?? {};
+        const threadId = config.configurable?.thread_id;
+        const ns = config.configurable?.checkpoint_ns;
+        const filterCheckpointId = config.configurable?.checkpoint_id;
+        const beforeId = before?.configurable?.checkpoint_id;
+        if (!threadId) {
+            throw new IronflowError("list() without thread_id requires server-side index — pass thread_id in config.configurable", { code: "LG_THREAD_ID_REQUIRED", retryable: false });
+        }
+        let yielded = 0;
+        const events = await this.readStream(threadId);
+        const namespaces = ns !== undefined ? [ns] : namespacesIn(events);
+        for (const useNs of namespaces) {
+            const view = materialize(events, useNs);
+            if (!view)
+                continue;
+            // Sort by checkpoint_id descending. LangGraph's checkpoint IDs are
+            // UUID v6 (timestamp-prefixed lex-ordered) per
+            // @langchain/langgraph-checkpoint base.d.ts; this matches MemorySaver
+            // / SqliteSaver / PostgresSaver "ORDER BY checkpoint_id DESC" semantics.
+            const ordered = [...view.checkpoints.values()].sort((a, b) => b.data.checkpoint_id.localeCompare(a.data.checkpoint_id));
+            for (const entry of ordered) {
+                const id = entry.data.checkpoint_id;
+                if (filterCheckpointId && id !== filterCheckpointId)
+                    continue;
+                if (beforeId && id >= beforeId)
+                    continue;
+                const tuple = await this.toTuple(entry, useNs, threadId, view, undefined);
+                if (filter && !matchesFilter(tuple.metadata, filter))
+                    continue;
+                if (limit !== undefined && yielded >= limit)
+                    return;
+                yielded += 1;
+                yield tuple;
+            }
+        }
+    }
+    async put(config, checkpoint, metadata, _newVersions) {
+        const threadId = requireThreadId(config);
+        const ns = config.configurable?.checkpoint_ns ?? "";
+        const parentId = config.configurable?.checkpoint_id;
+        const prepared = copyCheckpoint(checkpoint);
+        const [[cpType, cpBytes], [metaType, metaBytes],] = await Promise.all([
+            this.serde.dumpsTyped(prepared),
+            this.serde.dumpsTyped(metadata),
+        ]);
+        const data = {
+            checkpoint_ns: ns,
+            checkpoint_id: checkpoint.id,
+            type: cpType,
+            checkpoint_b64: bytesToB64(cpBytes),
+            metadata_b64: bytesToB64(metaBytes),
+            metadata_type: metaType,
+            ts: checkpoint.ts,
+            ...(parentId ? { parent_checkpoint_id: parentId } : {}),
+        };
+        await this.client.streams.append(streamId(threadId), { name: EVT_PUT, data: data, entityType: ENTITY_TYPE }, { idempotencyKey: `lg:put:${threadId}:${ns}:${checkpoint.id}` });
+        return {
+            configurable: {
+                thread_id: threadId,
+                checkpoint_ns: ns,
+                checkpoint_id: checkpoint.id,
+            },
+        };
+    }
+    async putWrites(config, writes, taskId) {
+        const threadId = requireThreadId(config);
+        const ns = config.configurable?.checkpoint_ns ?? "";
+        const checkpointId = config.configurable?.checkpoint_id;
+        if (typeof checkpointId !== "string" || !checkpointId) {
+            throw new IronflowError("putWrites requires checkpoint_id in RunnableConfig.configurable", { code: "LG_CHECKPOINT_ID_REQUIRED", retryable: false });
+        }
+        const seen = new Set();
+        const entries = [];
+        for (let i = 0; i < writes.length; i += 1) {
+            const [channel, value] = writes[i];
+            const idx = WRITES_IDX_MAP[channel] ?? i;
+            const dedupKey = `${taskId}:${idx}`;
+            if (idx >= 0 && seen.has(dedupKey))
+                continue;
+            seen.add(dedupKey);
+            const [type, bytes] = await this.serde.dumpsTyped(value);
+            entries.push({ channel, idx, type, value_b64: bytesToB64(bytes) });
+        }
+        if (entries.length === 0)
+            return;
+        const data = {
+            checkpoint_ns: ns,
+            checkpoint_id: checkpointId,
+            task_id: taskId,
+            writes: entries,
+        };
+        await this.client.streams.append(streamId(threadId), {
+            name: EVT_PUT_WRITES,
+            data: data,
+            entityType: ENTITY_TYPE,
+        });
+    }
+    async deleteThread(threadId) {
+        // No idempotency key — semantics are "append a tombstone", not dedup.
+        // Multiple deletes append multiple tombstones; reads use the highest one
+        // as cutoff, so duplicate tombstones are harmless.
+        await this.client.streams.append(streamId(threadId), {
+            name: EVT_DELETE,
+            data: { deleted_at: new Date().toISOString() },
+            entityType: ENTITY_TYPE,
+        });
+    }
+    async readStream(threadId) {
+        const all = [];
+        let fromVersion = 0;
+        while (true) {
+            const { events } = await this.client.streams.read(streamId(threadId), {
+                fromVersion,
+                limit: READ_BATCH,
+                direction: "forward",
+            });
+            if (events.length === 0)
+                break;
+            all.push(...events);
+            const last = events[events.length - 1];
+            if (events.length < READ_BATCH)
+                break;
+            fromVersion = last.entityVersion + 1;
+        }
+        return all;
+    }
+    async toTuple(entry, ns, threadId, view, originalConfig) {
+        const checkpoint = (await this.serde.loadsTyped(entry.data.type, b64ToBytes(entry.data.checkpoint_b64)));
+        const metadata = (await this.serde.loadsTyped(entry.data.metadata_type, b64ToBytes(entry.data.metadata_b64)));
+        const writes = view.writes.get(entry.data.checkpoint_id) ?? [];
+        const pendingWrites = [];
+        const seenWrite = new Set();
+        for (const w of writes) {
+            const key = `${w.taskId}:${w.idx}`;
+            if (w.idx >= 0 && seenWrite.has(key))
+                continue;
+            seenWrite.add(key);
+            const value = await this.serde.loadsTyped(w.type, b64ToBytes(w.value_b64));
+            pendingWrites.push([w.taskId, w.channel, value]);
+        }
+        const tuple = {
+            config: originalConfig ?? {
+                configurable: {
+                    thread_id: threadId,
+                    checkpoint_ns: ns,
+                    checkpoint_id: entry.data.checkpoint_id,
+                },
+            },
+            checkpoint,
+            metadata,
+            pendingWrites,
+        };
+        if (entry.data.parent_checkpoint_id) {
+            tuple.parentConfig = {
+                configurable: {
+                    thread_id: threadId,
+                    checkpoint_ns: ns,
+                    checkpoint_id: entry.data.parent_checkpoint_id,
+                },
+            };
+        }
+        return tuple;
+    }
+}
+function streamId(threadId) {
+    return `irn:agent-ckpt:${threadId}`;
+}
+function requireThreadId(config) {
+    const threadId = config.configurable?.thread_id;
+    if (typeof threadId !== "string" || !threadId) {
+        throw new IronflowError("RunnableConfig.configurable.thread_id is required", { code: "LG_THREAD_ID_REQUIRED", retryable: false });
+    }
+    return threadId;
+}
+function materialize(events, ns) {
+    let cutoff = -1;
+    for (const e of events) {
+        if (e.name === EVT_DELETE && e.entityVersion > cutoff) {
+            cutoff = e.entityVersion;
+        }
+    }
+    const checkpoints = new Map();
+    const writes = new Map();
+    let latest;
+    for (const e of events) {
+        if (e.entityVersion <= cutoff)
+            continue;
+        if (e.name === EVT_PUT) {
+            const data = e.data;
+            if (data.checkpoint_ns !== ns)
+                continue;
+            const entry = { data, version: e.entityVersion };
+            checkpoints.set(data.checkpoint_id, entry);
+            // Lex-MAX of checkpoint_id matches MemorySaver / SqliteSaver /
+            // PostgresSaver "latest" semantics (ORDER BY checkpoint_id DESC LIMIT 1).
+            // LangGraph IDs are UUID v6, so lex order == time order.
+            if (!latest || data.checkpoint_id > latest.data.checkpoint_id) {
+                latest = entry;
+            }
+        }
+        else if (e.name === EVT_PUT_WRITES) {
+            const data = e.data;
+            if (data.checkpoint_ns !== ns)
+                continue;
+            const list = writes.get(data.checkpoint_id) ?? [];
+            for (const w of data.writes) {
+                list.push({
+                    checkpointId: data.checkpoint_id,
+                    taskId: data.task_id,
+                    channel: w.channel,
+                    idx: w.idx,
+                    type: w.type,
+                    value_b64: w.value_b64,
+                    version: e.entityVersion,
+                });
+            }
+            writes.set(data.checkpoint_id, list);
+        }
+    }
+    if (checkpoints.size === 0)
+        return undefined;
+    return { checkpoints, writes, latest };
+}
+function namespacesIn(events) {
+    const set = new Set();
+    for (const e of events) {
+        if (e.name === EVT_PUT || e.name === EVT_PUT_WRITES) {
+            const ns = e.data.checkpoint_ns ?? "";
+            set.add(ns);
+        }
+    }
+    return [...set];
+}
+function matchesFilter(metadata, filter) {
+    if (!metadata)
+        return false;
+    const m = metadata;
+    for (const [k, v] of Object.entries(filter)) {
+        if (m[k] !== v)
+            return false;
+    }
+    return true;
+}
+//# 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ironflow/langgraph",
-  "version": "0.20.2",
+  "version": "0.22.0",
   "description": "LangGraph checkpoint saver backed by Ironflow entity streams — durable agent state with crash-resume",
   "type": "module",
   "main": "./dist/index.js",
@@ -18,8 +18,8 @@
     "README.md"
   ],
   "dependencies": {
-    "@ironflow/core": "^0.20.2",
-    "@ironflow/node": "^0.20.2"
+    "@ironflow/core": "^0.22.0",
+    "@ironflow/node": "^0.22.0"
   },
   "peerDependencies": {
     "@langchain/core": "^1.0.0",