@langchain/langgraph-checkpoint 0.1.1 → 1.0.1

package/dist/base.cjs

@@ -1,104 +1,89 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WRITES_IDX_MAP = exports.BaseCheckpointSaver = void 0;
-exports.deepCopy = deepCopy;
-exports.emptyCheckpoint = emptyCheckpoint;
-exports.copyCheckpoint = copyCheckpoint;
-exports.compareChannelVersions = compareChannelVersions;
-exports.maxChannelVersion = maxChannelVersion;
-exports.getCheckpointId = getCheckpointId;
-const id_js_1 = require("./id.cjs");
-const types_js_1 = require("./serde/types.cjs");
-const jsonplus_js_1 = require("./serde/jsonplus.cjs");
+const require_id = require("./id.cjs");
+const require_types = require("./serde/types.cjs");
+const require_jsonplus = require("./serde/jsonplus.cjs");
+//#region src/base.ts
 function deepCopy(obj) {
-    if (typeof obj !== "object" || obj === null) {
-        return obj;
-    }
-    const newObj = Array.isArray(obj) ? [] : {};
-    for (const key in obj) {
-        if (Object.prototype.hasOwnProperty.call(obj, key)) {
-            newObj[key] = deepCopy(obj[key]);
-        }
-    }
-    return newObj;
+	if (typeof obj !== "object" || obj === null) return obj;
+	const newObj = Array.isArray(obj) ? [] : {};
+	for (const key in obj) if (Object.prototype.hasOwnProperty.call(obj, key)) newObj[key] = deepCopy(obj[key]);
+	return newObj;
 }
 /** @hidden */
 function emptyCheckpoint() {
-    return {
-        v: 4,
-        id: (0, id_js_1.uuid6)(-2),
-        ts: new Date().toISOString(),
-        channel_values: {},
-        channel_versions: {},
-        versions_seen: {},
-    };
+	return {
+		v: 4,
+		id: require_id.uuid6(-2),
+		ts: (/* @__PURE__ */ new Date()).toISOString(),
+		channel_values: {},
+		channel_versions: {},
+		versions_seen: {}
+	};
 }
 /** @hidden */
 function copyCheckpoint(checkpoint) {
-    return {
-        v: checkpoint.v,
-        id: checkpoint.id,
-        ts: checkpoint.ts,
-        channel_values: { ...checkpoint.channel_values },
-        channel_versions: { ...checkpoint.channel_versions },
-        versions_seen: deepCopy(checkpoint.versions_seen),
-    };
+	return {
+		v: checkpoint.v,
+		id: checkpoint.id,
+		ts: checkpoint.ts,
+		channel_values: { ...checkpoint.channel_values },
+		channel_versions: { ...checkpoint.channel_versions },
+		versions_seen: deepCopy(checkpoint.versions_seen)
+	};
 }
-class BaseCheckpointSaver {
-    constructor(serde) {
-        Object.defineProperty(this, "serde", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: new jsonplus_js_1.JsonPlusSerializer()
-        });
-        this.serde = serde || this.serde;
-    }
-    async get(config) {
-        const value = await this.getTuple(config);
-        return value ? value.checkpoint : undefined;
-    }
-    /**
-     * Generate the next version ID for a channel.
-     *
-     * Default is to use integer versions, incrementing by 1. If you override, you can use str/int/float versions,
-     * as long as they are monotonically increasing.
-     */
-    getNextVersion(current) {
-        if (typeof current === "string") {
-            throw new Error("Please override this method to use string versions.");
-        }
-        return (current !== undefined && typeof current === "number" ? current + 1 : 1);
-    }
-}
-exports.BaseCheckpointSaver = BaseCheckpointSaver;
+var BaseCheckpointSaver = class {
+	serde = new require_jsonplus.JsonPlusSerializer();
+	constructor(serde) {
+		this.serde = serde || this.serde;
+	}
+	async get(config) {
+		const value = await this.getTuple(config);
+		return value ? value.checkpoint : void 0;
+	}
+	/**
+	* Generate the next version ID for a channel.
+	*
+	* Default is to use integer versions, incrementing by 1. If you override, you can use str/int/float versions,
+	* as long as they are monotonically increasing.
+	*/
+	getNextVersion(current) {
+		if (typeof current === "string") throw new Error("Please override this method to use string versions.");
+		return current !== void 0 && typeof current === "number" ? current + 1 : 1;
+	}
+};
 function compareChannelVersions(a, b) {
-    if (typeof a === "number" && typeof b === "number") {
-        return Math.sign(a - b);
-    }
-    return String(a).localeCompare(String(b));
+	if (typeof a === "number" && typeof b === "number") return Math.sign(a - b);
+	return String(a).localeCompare(String(b));
 }
 function maxChannelVersion(...versions) {
-    return versions.reduce((max, version, idx) => {
-        if (idx === 0)
-            return version;
-        return compareChannelVersions(max, version) >= 0 ? max : version;
-    });
+	return versions.reduce((max, version, idx) => {
+		if (idx === 0) return version;
+		return compareChannelVersions(max, version) >= 0 ? max : version;
+	});
 }
 /**
- * Mapping from error type to error index.
- * Regular writes just map to their index in the list of writes being saved.
- * Special writes (e.g. errors) map to negative indices, to avoid those writes from
- * conflicting with regular writes.
- * Each Checkpointer implementation should use this mapping in put_writes.
- */
-exports.WRITES_IDX_MAP = {
-    [types_js_1.ERROR]: -1,
-    [types_js_1.SCHEDULED]: -2,
-    [types_js_1.INTERRUPT]: -3,
-    [types_js_1.RESUME]: -4,
+* Mapping from error type to error index.
+* Regular writes just map to their index in the list of writes being saved.
+* Special writes (e.g. errors) map to negative indices, to avoid those writes from
+* conflicting with regular writes.
+* Each Checkpointer implementation should use this mapping in put_writes.
+*/
+const WRITES_IDX_MAP = {
+	[require_types.ERROR]: -1,
+	[require_types.SCHEDULED]: -2,
+	[require_types.INTERRUPT]: -3,
+	[require_types.RESUME]: -4
 };
 function getCheckpointId(config) {
-    return (config.configurable?.checkpoint_id || config.configurable?.thread_ts || "");
+	return config.configurable?.checkpoint_id || config.configurable?.thread_ts || "";
 }
-//# sourceMappingURL=base.js.map
+//#endregion
+exports.BaseCheckpointSaver = BaseCheckpointSaver;
+exports.WRITES_IDX_MAP = WRITES_IDX_MAP;
+exports.compareChannelVersions = compareChannelVersions;
+exports.copyCheckpoint = copyCheckpoint;
+exports.deepCopy = deepCopy;
+exports.emptyCheckpoint = emptyCheckpoint;
+exports.getCheckpointId = getCheckpointId;
+exports.maxChannelVersion = maxChannelVersion;
+
+//# sourceMappingURL=base.cjs.map

package/dist/base.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.cjs","names":["uuid6","JsonPlusSerializer","ERROR","SCHEDULED","INTERRUPT","RESUME"],"sources":["../src/base.ts"],"sourcesContent":["import type { RunnableConfig } from \"@langchain/core/runnables\";\nimport { SerializerProtocol } from \"./serde/base.js\";\nimport { uuid6 } from \"./id.js\";\nimport type {\n  PendingWrite,\n  CheckpointPendingWrite,\n  CheckpointMetadata,\n} from \"./types.js\";\nimport { ERROR, INTERRUPT, RESUME, SCHEDULED } from \"./serde/types.js\";\nimport { JsonPlusSerializer } from \"./serde/jsonplus.js\";\n\n/** @inline */\ntype ChannelVersion = number | string;\n\nexport type ChannelVersions = Record<string, ChannelVersion>;\n\nexport interface Checkpoint<\n  N extends string = string,\n  C extends string = string\n> {\n  /**\n   * The version of the checkpoint format. Currently 4\n   */\n  v: number;\n  /**\n   * Checkpoint ID {uuid6}\n   */\n  id: string;\n  /**\n   * Timestamp {new Date().toISOString()}\n   */\n  ts: string;\n  /**\n   * @default {}\n   */\n  channel_values: Record<C, unknown>;\n  /**\n   * @default {}\n   */\n  channel_versions: Record<C, ChannelVersion>;\n  /**\n   * @default {}\n   */\n  versions_seen: Record<N, Record<C, ChannelVersion>>;\n}\n\nexport interface ReadonlyCheckpoint extends Readonly<Checkpoint> {\n  readonly channel_values: Readonly<Record<string, unknown>>;\n  readonly channel_versions: Readonly<Record<string, ChannelVersion>>;\n  readonly versions_seen: Readonly<\n    Record<string, Readonly<Record<string, ChannelVersion>>>\n  >;\n}\n\nexport function deepCopy<T>(obj: T): T {\n  if (typeof obj !== \"object\" || obj === null) {\n    return obj;\n  }\n\n  const newObj = Array.isArray(obj) ? [] : {};\n\n  for (const key in obj) {\n    if (Object.prototype.hasOwnProperty.call(obj, key)) {\n      (newObj as Record<PropertyKey, unknown>)[key] = deepCopy(\n        (obj as Record<string, unknown>)[key]\n      );\n    }\n  }\n\n  return newObj as T;\n}\n\n/** @hidden */\nexport function emptyCheckpoint(): Checkpoint {\n  return {\n    v: 4,\n    id: uuid6(-2),\n    ts: new Date().toISOString(),\n    channel_values: {},\n    channel_versions: {},\n    versions_seen: {},\n  };\n}\n\n/** @hidden */\nexport function copyCheckpoint(checkpoint: ReadonlyCheckpoint): Checkpoint {\n  return {\n    v: checkpoint.v,\n    id: checkpoint.id,\n    ts: checkpoint.ts,\n    channel_values: { ...checkpoint.channel_values },\n    channel_versions: { ...checkpoint.channel_versions },\n    versions_seen: deepCopy(checkpoint.versions_seen),\n  };\n}\n\nexport interface CheckpointTuple {\n  config: RunnableConfig;\n  checkpoint: Checkpoint;\n  metadata?: CheckpointMetadata;\n  parentConfig?: RunnableConfig;\n  pendingWrites?: CheckpointPendingWrite[];\n}\n\nexport type CheckpointListOptions = {\n  limit?: number;\n  before?: RunnableConfig;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  filter?: Record<string, any>;\n};\n\nexport abstract class BaseCheckpointSaver<V extends string | number = number> {\n  serde: SerializerProtocol = new JsonPlusSerializer();\n\n  constructor(serde?: SerializerProtocol) {\n    this.serde = serde || this.serde;\n  }\n\n  async get(config: RunnableConfig): Promise<Checkpoint | undefined> {\n    const value = await this.getTuple(config);\n    return value ? value.checkpoint : undefined;\n  }\n\n  abstract getTuple(\n    config: RunnableConfig\n  ): Promise<CheckpointTuple | undefined>;\n\n  abstract list(\n    config: RunnableConfig,\n    options?: CheckpointListOptions\n  ): AsyncGenerator<CheckpointTuple>;\n\n  abstract put(\n    config: RunnableConfig,\n    checkpoint: Checkpoint,\n    metadata: CheckpointMetadata,\n    newVersions: ChannelVersions\n  ): Promise<RunnableConfig>;\n\n  /**\n   * Store intermediate writes linked to a checkpoint.\n   */\n  abstract putWrites(\n    config: RunnableConfig,\n    writes: PendingWrite[],\n    taskId: string\n  ): Promise<void>;\n\n  /**\n   * Delete all checkpoints and writes associated with a specific thread ID.\n   * @param threadId The thread ID whose checkpoints should be deleted.\n   */\n  abstract deleteThread(threadId: string): Promise<void>;\n\n  /**\n   * Generate the next version ID for a channel.\n   *\n   * Default is to use integer versions, incrementing by 1. If you override, you can use str/int/float versions,\n   * as long as they are monotonically increasing.\n   */\n  getNextVersion(current: V | undefined): V {\n    if (typeof current === \"string\") {\n      throw new Error(\"Please override this method to use string versions.\");\n    }\n    return (\n      current !== undefined && typeof current === \"number\" ? current + 1 : 1\n    ) as V;\n  }\n}\n\nexport function compareChannelVersions(\n  a: ChannelVersion,\n  b: ChannelVersion\n): number {\n  if (typeof a === \"number\" && typeof b === \"number\") {\n    return Math.sign(a - b);\n  }\n\n  return String(a).localeCompare(String(b));\n}\n\nexport function maxChannelVersion(\n  ...versions: ChannelVersion[]\n): ChannelVersion {\n  return versions.reduce((max, version, idx) => {\n    if (idx === 0) return version;\n    return compareChannelVersions(max, version) >= 0 ? max : version;\n  });\n}\n\n/**\n * Mapping from error type to error index.\n * Regular writes just map to their index in the list of writes being saved.\n * Special writes (e.g. errors) map to negative indices, to avoid those writes from\n * conflicting with regular writes.\n * Each Checkpointer implementation should use this mapping in put_writes.\n */\nexport const WRITES_IDX_MAP: Record<string, number> = {\n  [ERROR]: -1,\n  [SCHEDULED]: -2,\n  [INTERRUPT]: -3,\n  [RESUME]: -4,\n};\n\nexport function getCheckpointId(config: RunnableConfig): string {\n  return (\n    config.configurable?.checkpoint_id || config.configurable?.thread_ts || \"\"\n  );\n}\n"],"mappings":";;;;AAsDA,SAAgB,SAAY,KAAW;AACrC,KAAI,OAAO,QAAQ,YAAY,QAAQ,KACrC,QAAO;CAGT,MAAM,SAAS,MAAM,QAAQ,IAAI,GAAG,EAAE,GAAG,EAAE;AAE3C,MAAK,MAAM,OAAO,IAChB,KAAI,OAAO,UAAU,eAAe,KAAK,KAAK,IAAI,CAC/C,QAAwC,OAAO,SAC7C,IAAgC,KAClC;AAIL,QAAO;;;AAIT,SAAgB,kBAA8B;AAC5C,QAAO;EACL,GAAG;EACH,IAAIA,WAAAA,MAAM,GAAG;EACb,qBAAI,IAAI,MAAM,EAAC,aAAa;EAC5B,gBAAgB,EAAE;EAClB,kBAAkB,EAAE;EACpB,eAAe,EAAE;EAClB;;;AAIH,SAAgB,eAAe,YAA4C;AACzE,QAAO;EACL,GAAG,WAAW;EACd,IAAI,WAAW;EACf,IAAI,WAAW;EACf,gBAAgB,EAAE,GAAG,WAAW,gBAAgB;EAChD,kBAAkB,EAAE,GAAG,WAAW,kBAAkB;EACpD,eAAe,SAAS,WAAW,cAAc;EAClD;;AAkBH,IAAsB,sBAAtB,MAA8E;CAC5E,QAA4B,IAAIC,iBAAAA,oBAAoB;CAEpD,YAAY,OAA4B;AACtC,OAAK,QAAQ,SAAS,KAAK;;CAG7B,MAAM,IAAI,QAAyD;EACjE,MAAM,QAAQ,MAAM,KAAK,SAAS,OAAO;AACzC,SAAO,QAAQ,MAAM,aAAa,KAAA;;;;;;;;CAwCpC,eAAe,SAA2B;AACxC,MAAI,OAAO,YAAY,SACrB,OAAM,IAAI,MAAM,sDAAsD;AAExE,SACE,YAAY,KAAA,KAAa,OAAO,YAAY,WAAW,UAAU,IAAI;;;AAK3E,SAAgB,uBACd,GACA,GACQ;AACR,KAAI,OAAO,MAAM,YAAY,OAAO,MAAM,SACxC,QAAO,KAAK,KAAK,IAAI,EAAE;AAGzB,QAAO,OAAO,EAAE,CAAC,cAAc,OAAO,EAAE,CAAC;;AAG3C,SAAgB,kBACd,GAAG,UACa;AAChB,QAAO,SAAS,QAAQ,KAAK,SAAS,QAAQ;AAC5C,MAAI,QAAQ,EAAG,QAAO;AACtB,SAAO,uBAAuB,KAAK,QAAQ,IAAI,IAAI,MAAM;GACzD;;;;;;;;;AAUJ,MAAa,iBAAyC;EACnDC,cAAAA,QAAQ;EACRC,cAAAA,YAAY;EACZC,cAAAA,YAAY;EACZC,cAAAA,SAAS;CACX;AAED,SAAgB,gBAAgB,QAAgC;AAC9D,QACE,OAAO,cAAc,iBAAiB,OAAO,cAAc,aAAa"}

package/dist/base.d.cts

@@ -0,0 +1,94 @@
+import { SerializerProtocol } from "./serde/base.cjs";
+import { CheckpointMetadata, CheckpointPendingWrite, PendingWrite } from "./types.cjs";
+import { RunnableConfig } from "@langchain/core/runnables";
+
+//#region src/base.d.ts
+/** @inline */
+type ChannelVersion = number | string;
+type ChannelVersions = Record<string, ChannelVersion>;
+interface Checkpoint<N extends string = string, C extends string = string> {
+  /**
+   * The version of the checkpoint format. Currently 4
+   */
+  v: number;
+  /**
+   * Checkpoint ID {uuid6}
+   */
+  id: string;
+  /**
+   * Timestamp {new Date().toISOString()}
+   */
+  ts: string;
+  /**
+   * @default {}
+   */
+  channel_values: Record<C, unknown>;
+  /**
+   * @default {}
+   */
+  channel_versions: Record<C, ChannelVersion>;
+  /**
+   * @default {}
+   */
+  versions_seen: Record<N, Record<C, ChannelVersion>>;
+}
+interface ReadonlyCheckpoint extends Readonly<Checkpoint> {
+  readonly channel_values: Readonly<Record<string, unknown>>;
+  readonly channel_versions: Readonly<Record<string, ChannelVersion>>;
+  readonly versions_seen: Readonly<Record<string, Readonly<Record<string, ChannelVersion>>>>;
+}
+declare function deepCopy<T>(obj: T): T;
+/** @hidden */
+declare function emptyCheckpoint(): Checkpoint;
+/** @hidden */
+declare function copyCheckpoint(checkpoint: ReadonlyCheckpoint): Checkpoint;
+interface CheckpointTuple {
+  config: RunnableConfig;
+  checkpoint: Checkpoint;
+  metadata?: CheckpointMetadata;
+  parentConfig?: RunnableConfig;
+  pendingWrites?: CheckpointPendingWrite[];
+}
+type CheckpointListOptions = {
+  limit?: number;
+  before?: RunnableConfig;
+  filter?: Record<string, any>;
+};
+declare abstract class BaseCheckpointSaver<V extends string | number = number> {
+  serde: SerializerProtocol;
+  constructor(serde?: SerializerProtocol);
+  get(config: RunnableConfig): Promise<Checkpoint | undefined>;
+  abstract getTuple(config: RunnableConfig): Promise<CheckpointTuple | undefined>;
+  abstract list(config: RunnableConfig, options?: CheckpointListOptions): AsyncGenerator<CheckpointTuple>;
+  abstract put(config: RunnableConfig, checkpoint: Checkpoint, metadata: CheckpointMetadata, newVersions: ChannelVersions): Promise<RunnableConfig>;
+  /**
+   * Store intermediate writes linked to a checkpoint.
+   */
+  abstract putWrites(config: RunnableConfig, writes: PendingWrite[], taskId: string): Promise<void>;
+  /**
+   * Delete all checkpoints and writes associated with a specific thread ID.
+   * @param threadId The thread ID whose checkpoints should be deleted.
+   */
+  abstract deleteThread(threadId: string): Promise<void>;
+  /**
+   * Generate the next version ID for a channel.
+   *
+   * Default is to use integer versions, incrementing by 1. If you override, you can use str/int/float versions,
+   * as long as they are monotonically increasing.
+   */
+  getNextVersion(current: V | undefined): V;
+}
+declare function compareChannelVersions(a: ChannelVersion, b: ChannelVersion): number;
+declare function maxChannelVersion(...versions: ChannelVersion[]): ChannelVersion;
+/**
+ * Mapping from error type to error index.
+ * Regular writes just map to their index in the list of writes being saved.
+ * Special writes (e.g. errors) map to negative indices, to avoid those writes from
+ * conflicting with regular writes.
+ * Each Checkpointer implementation should use this mapping in put_writes.
+ */
+declare const WRITES_IDX_MAP: Record<string, number>;
+declare function getCheckpointId(config: RunnableConfig): string;
+//#endregion
+export { BaseCheckpointSaver, ChannelVersions, Checkpoint, CheckpointListOptions, CheckpointTuple, ReadonlyCheckpoint, WRITES_IDX_MAP, compareChannelVersions, copyCheckpoint, deepCopy, emptyCheckpoint, getCheckpointId, maxChannelVersion };
+//# sourceMappingURL=base.d.cts.map

package/dist/base.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.cts","names":[],"sources":["../src/base.ts"],"mappings":";;;;;;KAYK,cAAA;AAAA,KAEO,eAAA,GAAkB,MAAA,SAAe,cAAA;AAAA,UAE5B,UAAA;;;;EAOf,CAAA;EATyB;;;EAazB,EAAA;EAXe;;;EAef,EAAA;EAIgB;;;EAAhB,cAAA,EAAgB,MAAA,CAAO,CAAA;EAQD;;;EAJtB,gBAAA,EAAkB,MAAA,CAAO,CAAA,EAAG,cAAA;EAIb;;;EAAf,aAAA,EAAe,MAAA,CAAO,CAAA,EAAG,MAAA,CAAO,CAAA,EAAG,cAAA;AAAA;AAAA,UAGpB,kBAAA,SAA2B,QAAA,CAAS,UAAA;EAAA,SAC1C,cAAA,EAAgB,QAAA,CAAS,MAAA;EAAA,SACzB,gBAAA,EAAkB,QAAA,CAAS,MAAA,SAAe,cAAA;EAAA,SAC1C,aAAA,EAAe,QAAA,CACtB,MAAA,SAAe,QAAA,CAAS,MAAA,SAAe,cAAA;AAAA;AAAA,iBAI3B,QAAA,GAAA,CAAY,GAAA,EAAK,CAAA,GAAI,CAAA;;iBAmBrB,eAAA,CAAA,GAAmB,UAAA;;iBAYnB,cAAA,CAAe,UAAA,EAAY,kBAAA,GAAqB,UAAA;AAAA,UAW/C,eAAA;EACf,MAAA,EAAQ,cAAA;EACR,UAAA,EAAY,UAAA;EACZ,QAAA,GAAW,kBAAA;EACX,YAAA,GAAe,cAAA;EACf,aAAA,GAAgB,sBAAA;AAAA;AAAA,KAGN,qBAAA;EACV,KAAA;EACA,MAAA,GAAS,cAAA;EAET,MAAA,GAAS,MAAA;AAAA;AAAA,uBAGW,mBAAA;EACpB,KAAA,EAAO,kBAAA;EAEP,WAAA,CAAY,KAAA,GAAQ,kBAAA;EAId,GAAA,CAAI,MAAA,EAAQ,cAAA,GAAiB,OAAA,CAAQ,UAAA;EAAA,SAKlC,QAAA,CACP,MAAA,EAAQ,cAAA,GACP,OAAA,CAAQ,eAAA;EAAA,SAEF,IAAA,CACP,MAAA,EAAQ,cAAA,EACR,OAAA,GAAU,qBAAA,GACT,cAAA,CAAe,eAAA;EAAA,SAET,GAAA,CACP,MAAA,EAAQ,cAAA,EACR,UAAA,EAAY,UAAA,EACZ,QAAA,EAAU,kBAAA,EACV,WAAA,EAAa,eAAA,GACZ,OAAA,CAAQ,cAAA;EAvFM;;;EAAA,SA4FR,SAAA,CACP,MAAA,EAAQ,cAAA,EACR,MAAA,EAAQ,YAAA,IACR,MAAA,WACC,OAAA;EApG+C;;;;EAAA,SA0GzC,YAAA,CAAa,QAAA,WAAmB,OAAA;EAzGhB;;;;;;EAiHzB,cAAA,CAAe,OAAA,EAAS,CAAA,eAAgB,CAAA;AAAA;AAAA,iBAU1B,sBAAA,CACd,CAAA,EAAG,cAAA,EACH,CAAA,EAAG,cAAA;AAAA,iBASW,iBAAA,CAAA,GACX,QAAA,EAAU,cAAA,KACZ,cAAA;;;;;AAjIH;;;cA+Ia,cAAA,EAAgB,MAAA;AAAA,iBAOb,eAAA,CAAgB,MAAA,EAAQ,cAAA"}

package/dist/base.d.ts

@@ -1,82 +1,85 @@
-import type { RunnableConfig } from "@langchain/core/runnables";
 import { SerializerProtocol } from "./serde/base.js";
-import type { PendingWrite, CheckpointPendingWrite, CheckpointMetadata } from "./types.js";
+import { CheckpointMetadata, CheckpointPendingWrite, PendingWrite } from "./types.js";
+import { RunnableConfig } from "@langchain/core/runnables";
+
+//#region src/base.d.ts
+/** @inline */
 type ChannelVersion = number | string;
-export type ChannelVersions = Record<string, ChannelVersion>;
-export interface Checkpoint<N extends string = string, C extends string = string> {
-    /**
-     * The version of the checkpoint format. Currently 4
-     */
-    v: number;
-    /**
-     * Checkpoint ID {uuid6}
-     */
-    id: string;
-    /**
-     * Timestamp {new Date().toISOString()}
-     */
-    ts: string;
-    /**
-     * @default {}
-     */
-    channel_values: Record<C, unknown>;
-    /**
-     * @default {}
-     */
-    channel_versions: Record<C, ChannelVersion>;
-    /**
-     * @default {}
-     */
-    versions_seen: Record<N, Record<C, ChannelVersion>>;
+type ChannelVersions = Record<string, ChannelVersion>;
+interface Checkpoint<N extends string = string, C extends string = string> {
+  /**
+   * The version of the checkpoint format. Currently 4
+   */
+  v: number;
+  /**
+   * Checkpoint ID {uuid6}
+   */
+  id: string;
+  /**
+   * Timestamp {new Date().toISOString()}
+   */
+  ts: string;
+  /**
+   * @default {}
+   */
+  channel_values: Record<C, unknown>;
+  /**
+   * @default {}
+   */
+  channel_versions: Record<C, ChannelVersion>;
+  /**
+   * @default {}
+   */
+  versions_seen: Record<N, Record<C, ChannelVersion>>;
 }
-export interface ReadonlyCheckpoint extends Readonly<Checkpoint> {
-    readonly channel_values: Readonly<Record<string, unknown>>;
-    readonly channel_versions: Readonly<Record<string, ChannelVersion>>;
-    readonly versions_seen: Readonly<Record<string, Readonly<Record<string, ChannelVersion>>>>;
+interface ReadonlyCheckpoint extends Readonly<Checkpoint> {
+  readonly channel_values: Readonly<Record<string, unknown>>;
+  readonly channel_versions: Readonly<Record<string, ChannelVersion>>;
+  readonly versions_seen: Readonly<Record<string, Readonly<Record<string, ChannelVersion>>>>;
 }
-export declare function deepCopy<T>(obj: T): T;
+declare function deepCopy<T>(obj: T): T;
 /** @hidden */
-export declare function emptyCheckpoint(): Checkpoint;
+declare function emptyCheckpoint(): Checkpoint;
 /** @hidden */
-export declare function copyCheckpoint(checkpoint: ReadonlyCheckpoint): Checkpoint;
-export interface CheckpointTuple {
-    config: RunnableConfig;
-    checkpoint: Checkpoint;
-    metadata?: CheckpointMetadata;
-    parentConfig?: RunnableConfig;
-    pendingWrites?: CheckpointPendingWrite[];
+declare function copyCheckpoint(checkpoint: ReadonlyCheckpoint): Checkpoint;
+interface CheckpointTuple {
+  config: RunnableConfig;
+  checkpoint: Checkpoint;
+  metadata?: CheckpointMetadata;
+  parentConfig?: RunnableConfig;
+  pendingWrites?: CheckpointPendingWrite[];
 }
-export type CheckpointListOptions = {
-    limit?: number;
-    before?: RunnableConfig;
-    filter?: Record<string, any>;
+type CheckpointListOptions = {
+  limit?: number;
+  before?: RunnableConfig;
+  filter?: Record<string, any>;
 };
-export declare abstract class BaseCheckpointSaver<V extends string | number = number> {
-    serde: SerializerProtocol;
-    constructor(serde?: SerializerProtocol);
-    get(config: RunnableConfig): Promise<Checkpoint | undefined>;
-    abstract getTuple(config: RunnableConfig): Promise<CheckpointTuple | undefined>;
-    abstract list(config: RunnableConfig, options?: CheckpointListOptions): AsyncGenerator<CheckpointTuple>;
-    abstract put(config: RunnableConfig, checkpoint: Checkpoint, metadata: CheckpointMetadata, newVersions: ChannelVersions): Promise<RunnableConfig>;
-    /**
-     * Store intermediate writes linked to a checkpoint.
-     */
-    abstract putWrites(config: RunnableConfig, writes: PendingWrite[], taskId: string): Promise<void>;
-    /**
-     * Delete all checkpoints and writes associated with a specific thread ID.
-     * @param threadId The thread ID whose checkpoints should be deleted.
-     */
-    abstract deleteThread(threadId: string): Promise<void>;
-    /**
-     * Generate the next version ID for a channel.
-     *
-     * Default is to use integer versions, incrementing by 1. If you override, you can use str/int/float versions,
-     * as long as they are monotonically increasing.
-     */
-    getNextVersion(current: V | undefined): V;
+declare abstract class BaseCheckpointSaver<V extends string | number = number> {
+  serde: SerializerProtocol;
+  constructor(serde?: SerializerProtocol);
+  get(config: RunnableConfig): Promise<Checkpoint | undefined>;
+  abstract getTuple(config: RunnableConfig): Promise<CheckpointTuple | undefined>;
+  abstract list(config: RunnableConfig, options?: CheckpointListOptions): AsyncGenerator<CheckpointTuple>;
+  abstract put(config: RunnableConfig, checkpoint: Checkpoint, metadata: CheckpointMetadata, newVersions: ChannelVersions): Promise<RunnableConfig>;
+  /**
+   * Store intermediate writes linked to a checkpoint.
+   */
+  abstract putWrites(config: RunnableConfig, writes: PendingWrite[], taskId: string): Promise<void>;
+  /**
+   * Delete all checkpoints and writes associated with a specific thread ID.
+   * @param threadId The thread ID whose checkpoints should be deleted.
+   */
+  abstract deleteThread(threadId: string): Promise<void>;
+  /**
+   * Generate the next version ID for a channel.
+   *
+   * Default is to use integer versions, incrementing by 1. If you override, you can use str/int/float versions,
+   * as long as they are monotonically increasing.
+   */
+  getNextVersion(current: V | undefined): V;
 }
-export declare function compareChannelVersions(a: ChannelVersion, b: ChannelVersion): number;
-export declare function maxChannelVersion(...versions: ChannelVersion[]): ChannelVersion;
+declare function compareChannelVersions(a: ChannelVersion, b: ChannelVersion): number;
+declare function maxChannelVersion(...versions: ChannelVersion[]): ChannelVersion;
 /**
  * Mapping from error type to error index.
  * Regular writes just map to their index in the list of writes being saved.
@@ -84,6 +87,8 @@ export declare function maxChannelVersion(...versions: ChannelVersion[]): Channe
  * conflicting with regular writes.
  * Each Checkpointer implementation should use this mapping in put_writes.
  */
-export declare const WRITES_IDX_MAP: Record<string, number>;
-export declare function getCheckpointId(config: RunnableConfig): string;
-export {};
+declare const WRITES_IDX_MAP: Record<string, number>;
+declare function getCheckpointId(config: RunnableConfig): string;
+//#endregion
+export { BaseCheckpointSaver, ChannelVersions, Checkpoint, CheckpointListOptions, CheckpointTuple, ReadonlyCheckpoint, WRITES_IDX_MAP, compareChannelVersions, copyCheckpoint, deepCopy, emptyCheckpoint, getCheckpointId, maxChannelVersion };
+//# sourceMappingURL=base.d.ts.map

package/dist/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","names":[],"sources":["../src/base.ts"],"mappings":";;;;;;KAYK,cAAA;AAAA,KAEO,eAAA,GAAkB,MAAA,SAAe,cAAA;AAAA,UAE5B,UAAA;;;;EAOf,CAAA;EATyB;;;EAazB,EAAA;EAXe;;;EAef,EAAA;EAIgB;;;EAAhB,cAAA,EAAgB,MAAA,CAAO,CAAA;EAQD;;;EAJtB,gBAAA,EAAkB,MAAA,CAAO,CAAA,EAAG,cAAA;EAIb;;;EAAf,aAAA,EAAe,MAAA,CAAO,CAAA,EAAG,MAAA,CAAO,CAAA,EAAG,cAAA;AAAA;AAAA,UAGpB,kBAAA,SAA2B,QAAA,CAAS,UAAA;EAAA,SAC1C,cAAA,EAAgB,QAAA,CAAS,MAAA;EAAA,SACzB,gBAAA,EAAkB,QAAA,CAAS,MAAA,SAAe,cAAA;EAAA,SAC1C,aAAA,EAAe,QAAA,CACtB,MAAA,SAAe,QAAA,CAAS,MAAA,SAAe,cAAA;AAAA;AAAA,iBAI3B,QAAA,GAAA,CAAY,GAAA,EAAK,CAAA,GAAI,CAAA;;iBAmBrB,eAAA,CAAA,GAAmB,UAAA;;iBAYnB,cAAA,CAAe,UAAA,EAAY,kBAAA,GAAqB,UAAA;AAAA,UAW/C,eAAA;EACf,MAAA,EAAQ,cAAA;EACR,UAAA,EAAY,UAAA;EACZ,QAAA,GAAW,kBAAA;EACX,YAAA,GAAe,cAAA;EACf,aAAA,GAAgB,sBAAA;AAAA;AAAA,KAGN,qBAAA;EACV,KAAA;EACA,MAAA,GAAS,cAAA;EAET,MAAA,GAAS,MAAA;AAAA;AAAA,uBAGW,mBAAA;EACpB,KAAA,EAAO,kBAAA;EAEP,WAAA,CAAY,KAAA,GAAQ,kBAAA;EAId,GAAA,CAAI,MAAA,EAAQ,cAAA,GAAiB,OAAA,CAAQ,UAAA;EAAA,SAKlC,QAAA,CACP,MAAA,EAAQ,cAAA,GACP,OAAA,CAAQ,eAAA;EAAA,SAEF,IAAA,CACP,MAAA,EAAQ,cAAA,EACR,OAAA,GAAU,qBAAA,GACT,cAAA,CAAe,eAAA;EAAA,SAET,GAAA,CACP,MAAA,EAAQ,cAAA,EACR,UAAA,EAAY,UAAA,EACZ,QAAA,EAAU,kBAAA,EACV,WAAA,EAAa,eAAA,GACZ,OAAA,CAAQ,cAAA;EAvFM;;;EAAA,SA4FR,SAAA,CACP,MAAA,EAAQ,cAAA,EACR,MAAA,EAAQ,YAAA,IACR,MAAA,WACC,OAAA;EApG+C;;;;EAAA,SA0GzC,YAAA,CAAa,QAAA,WAAmB,OAAA;EAzGhB;;;;;;EAiHzB,cAAA,CAAe,OAAA,EAAS,CAAA,eAAgB,CAAA;AAAA;AAAA,iBAU1B,sBAAA,CACd,CAAA,EAAG,cAAA,EACH,CAAA,EAAG,cAAA;AAAA,iBASW,iBAAA,CAAA,GACX,QAAA,EAAU,cAAA,KACZ,cAAA;;;;;AAjIH;;;cA+Ia,cAAA,EAAgB,MAAA;AAAA,iBAOb,eAAA,CAAgB,MAAA,EAAQ,cAAA"}

package/dist/base.js

@@ -1,94 +1,82 @@
 import { uuid6 } from "./id.js";
 import { ERROR, INTERRUPT, RESUME, SCHEDULED } from "./serde/types.js";
 import { JsonPlusSerializer } from "./serde/jsonplus.js";
-export function deepCopy(obj) {
-    if (typeof obj !== "object" || obj === null) {
-        return obj;
-    }
-    const newObj = Array.isArray(obj) ? [] : {};
-    for (const key in obj) {
-        if (Object.prototype.hasOwnProperty.call(obj, key)) {
-            newObj[key] = deepCopy(obj[key]);
-        }
-    }
-    return newObj;
+//#region src/base.ts
+function deepCopy(obj) {
+	if (typeof obj !== "object" || obj === null) return obj;
+	const newObj = Array.isArray(obj) ? [] : {};
+	for (const key in obj) if (Object.prototype.hasOwnProperty.call(obj, key)) newObj[key] = deepCopy(obj[key]);
+	return newObj;
 }
 /** @hidden */
-export function emptyCheckpoint() {
-    return {
-        v: 4,
-        id: uuid6(-2),
-        ts: new Date().toISOString(),
-        channel_values: {},
-        channel_versions: {},
-        versions_seen: {},
-    };
+function emptyCheckpoint() {
+	return {
+		v: 4,
+		id: uuid6(-2),
+		ts: (/* @__PURE__ */ new Date()).toISOString(),
+		channel_values: {},
+		channel_versions: {},
+		versions_seen: {}
+	};
 }
 /** @hidden */
-export function copyCheckpoint(checkpoint) {
-    return {
-        v: checkpoint.v,
-        id: checkpoint.id,
-        ts: checkpoint.ts,
-        channel_values: { ...checkpoint.channel_values },
-        channel_versions: { ...checkpoint.channel_versions },
-        versions_seen: deepCopy(checkpoint.versions_seen),
-    };
+function copyCheckpoint(checkpoint) {
+	return {
+		v: checkpoint.v,
+		id: checkpoint.id,
+		ts: checkpoint.ts,
+		channel_values: { ...checkpoint.channel_values },
+		channel_versions: { ...checkpoint.channel_versions },
+		versions_seen: deepCopy(checkpoint.versions_seen)
+	};
 }
-export class BaseCheckpointSaver {
-    constructor(serde) {
-        Object.defineProperty(this, "serde", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: new JsonPlusSerializer()
-        });
-        this.serde = serde || this.serde;
-    }
-    async get(config) {
-        const value = await this.getTuple(config);
-        return value ? value.checkpoint : undefined;
-    }
-    /**
-     * Generate the next version ID for a channel.
-     *
-     * Default is to use integer versions, incrementing by 1. If you override, you can use str/int/float versions,
-     * as long as they are monotonically increasing.
-     */
-    getNextVersion(current) {
-        if (typeof current === "string") {
-            throw new Error("Please override this method to use string versions.");
-        }
-        return (current !== undefined && typeof current === "number" ? current + 1 : 1);
-    }
-}
-export function compareChannelVersions(a, b) {
-    if (typeof a === "number" && typeof b === "number") {
-        return Math.sign(a - b);
-    }
-    return String(a).localeCompare(String(b));
+var BaseCheckpointSaver = class {
+	serde = new JsonPlusSerializer();
+	constructor(serde) {
+		this.serde = serde || this.serde;
+	}
+	async get(config) {
+		const value = await this.getTuple(config);
+		return value ? value.checkpoint : void 0;
+	}
+	/**
+	* Generate the next version ID for a channel.
+	*
+	* Default is to use integer versions, incrementing by 1. If you override, you can use str/int/float versions,
+	* as long as they are monotonically increasing.
+	*/
+	getNextVersion(current) {
+		if (typeof current === "string") throw new Error("Please override this method to use string versions.");
+		return current !== void 0 && typeof current === "number" ? current + 1 : 1;
+	}
+};
+function compareChannelVersions(a, b) {
+	if (typeof a === "number" && typeof b === "number") return Math.sign(a - b);
+	return String(a).localeCompare(String(b));
 }
-export function maxChannelVersion(...versions) {
-    return versions.reduce((max, version, idx) => {
-        if (idx === 0)
-            return version;
-        return compareChannelVersions(max, version) >= 0 ? max : version;
-    });
+function maxChannelVersion(...versions) {
+	return versions.reduce((max, version, idx) => {
+		if (idx === 0) return version;
+		return compareChannelVersions(max, version) >= 0 ? max : version;
+	});
 }
 /**
- * Mapping from error type to error index.
- * Regular writes just map to their index in the list of writes being saved.
- * Special writes (e.g. errors) map to negative indices, to avoid those writes from
- * conflicting with regular writes.
- * Each Checkpointer implementation should use this mapping in put_writes.
- */
-export const WRITES_IDX_MAP = {
-    [ERROR]: -1,
-    [SCHEDULED]: -2,
-    [INTERRUPT]: -3,
-    [RESUME]: -4,
+* Mapping from error type to error index.
+* Regular writes just map to their index in the list of writes being saved.
+* Special writes (e.g. errors) map to negative indices, to avoid those writes from
+* conflicting with regular writes.
+* Each Checkpointer implementation should use this mapping in put_writes.
+*/
+const WRITES_IDX_MAP = {
+	[ERROR]: -1,
+	[SCHEDULED]: -2,
+	[INTERRUPT]: -3,
+	[RESUME]: -4
 };
-export function getCheckpointId(config) {
-    return (config.configurable?.checkpoint_id || config.configurable?.thread_ts || "");
+function getCheckpointId(config) {
+	return config.configurable?.checkpoint_id || config.configurable?.thread_ts || "";
 }
+//#endregion
+export { BaseCheckpointSaver, WRITES_IDX_MAP, compareChannelVersions, copyCheckpoint, deepCopy, emptyCheckpoint, getCheckpointId, maxChannelVersion };
+
 //# sourceMappingURL=base.js.map