@langchain/langgraph-checkpoint 1.0.4 → 1.1.0

package/dist/serde/types.cjs

@@ -4,11 +4,41 @@ const ERROR = "__error__";
 const SCHEDULED = "__scheduled__";
 const INTERRUPT = "__interrupt__";
 const RESUME = "__resume__";
+/**
+* Snapshot blob for a `DeltaChannel` with finite snapshot frequency.
+*
+* Stored directly in a checkpoint's `channel_values` in place of the full
+* accumulated value. The ancestor walk in
+* {@link BaseCheckpointSaver.getDeltaChannelHistory} terminates when it
+* encounters a populated `channel_values` entry for a channel; a
+* `DeltaSnapshot` value is the materialized state at that ancestor, so the
+* channel reconstructs directly from `.value` without replaying earlier
+* writes.
+*
+* @remarks Beta. The on-disk representation may change in future releases.
+*/
+var DeltaSnapshot = class {
+	/** Marker used for structural detection across module/realm boundaries. */
+	lg_name = "DeltaSnapshot";
+	value;
+	constructor(value) {
+		this.value = value;
+	}
+};
+/**
+* Structural type guard for {@link DeltaSnapshot}. Uses the `lg_name` marker
+* so it survives serialization round-trips and cross-package duplication.
+*/
+function isDeltaSnapshot(value) {
+	return value != null && typeof value === "object" && value.lg_name === "DeltaSnapshot";
+}
 //#endregion
+exports.DeltaSnapshot = DeltaSnapshot;
 exports.ERROR = ERROR;
 exports.INTERRUPT = INTERRUPT;
 exports.RESUME = RESUME;
 exports.SCHEDULED = SCHEDULED;
 exports.TASKS = TASKS;
+exports.isDeltaSnapshot = isDeltaSnapshot;
 
 //# sourceMappingURL=types.cjs.map

package/dist/serde/types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.cjs","names":[],"sources":["../../src/serde/types.ts"],"sourcesContent":["export const TASKS = \"__pregel_tasks\";\nexport const ERROR = \"__error__\";\nexport const SCHEDULED = \"__scheduled__\";\nexport const INTERRUPT = \"__interrupt__\";\nexport const RESUME = \"__resume__\";\n\n// Mirrors BaseChannel in \"@langchain/langgraph\"\nexport interface ChannelProtocol<\n  ValueType = unknown,\n  UpdateType = unknown,\n  CheckpointType = unknown,\n> {\n  ValueType: ValueType;\n\n  UpdateType: UpdateType;\n\n  /**\n   * The name of the channel.\n   */\n  lc_graph_name: string;\n\n  /**\n   * Return a new identical channel, optionally initialized from a checkpoint.\n   * Can be thought of as a \"restoration\" from a checkpoint which is a \"snapshot\" of the channel's state.\n   *\n   * @param {CheckpointType | undefined} checkpoint\n   * @returns {this}\n   */\n  fromCheckpoint(checkpoint?: CheckpointType): this;\n\n  /**\n   * Update the channel's value with the given sequence of updates.\n   * The order of the updates in the sequence is arbitrary.\n   *\n   * @throws {InvalidUpdateError} if the sequence of updates is invalid.\n   * @param {Array<UpdateType>} values\n   * @returns {void}\n   */\n  update(values: UpdateType[]): void;\n\n  /**\n   * Return the current value of the channel.\n   *\n   * @throws {EmptyChannelError} if the channel is empty (never updated yet).\n   * @returns {ValueType}\n   */\n  get(): ValueType;\n\n  /**\n   * Return a string representation of the channel's current state.\n   *\n   * @throws {EmptyChannelError} if the channel is empty (never updated yet), or doesn't support checkpoints.\n   * @returns {CheckpointType | undefined}\n   */\n  checkpoint(): CheckpointType | undefined;\n}\n\n// Mirrors SendInterface in \"@langchain/langgraph\"\nexport interface SendProtocol {\n  node: string;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  args: any;\n}\n"],"mappings":";AAAA,MAAa,QAAQ;AACrB,MAAa,QAAQ;AACrB,MAAa,YAAY;AACzB,MAAa,YAAY;AACzB,MAAa,SAAS"}
+{"version":3,"file":"types.cjs","names":[],"sources":["../../src/serde/types.ts"],"sourcesContent":["export const TASKS = \"__pregel_tasks\";\nexport const ERROR = \"__error__\";\nexport const SCHEDULED = \"__scheduled__\";\nexport const INTERRUPT = \"__interrupt__\";\nexport const RESUME = \"__resume__\";\n\n/**\n * Snapshot blob for a `DeltaChannel` with finite snapshot frequency.\n *\n * Stored directly in a checkpoint's `channel_values` in place of the full\n * accumulated value. The ancestor walk in\n * {@link BaseCheckpointSaver.getDeltaChannelHistory} terminates when it\n * encounters a populated `channel_values` entry for a channel; a\n * `DeltaSnapshot` value is the materialized state at that ancestor, so the\n * channel reconstructs directly from `.value` without replaying earlier\n * writes.\n *\n * @remarks Beta. The on-disk representation may change in future releases.\n */\nexport class DeltaSnapshot<Value = unknown> {\n  /** Marker used for structural detection across module/realm boundaries. */\n  lg_name = \"DeltaSnapshot\" as const;\n\n  value: Value;\n\n  constructor(value: Value) {\n    this.value = value;\n  }\n}\n\n/**\n * Structural type guard for {@link DeltaSnapshot}. Uses the `lg_name` marker\n * so it survives serialization round-trips and cross-package duplication.\n */\nexport function isDeltaSnapshot<Value = unknown>(\n  value: unknown\n): value is DeltaSnapshot<Value> {\n  return (\n    value != null &&\n    typeof value === \"object\" &&\n    (value as { lg_name?: string }).lg_name === \"DeltaSnapshot\"\n  );\n}\n\n// Mirrors BaseChannel in \"@langchain/langgraph\"\nexport interface ChannelProtocol<\n  ValueType = unknown,\n  UpdateType = unknown,\n  CheckpointType = unknown,\n> {\n  ValueType: ValueType;\n\n  UpdateType: UpdateType;\n\n  /**\n   * The name of the channel.\n   */\n  lc_graph_name: string;\n\n  /**\n   * Return a new identical channel, optionally initialized from a checkpoint.\n   * Can be thought of as a \"restoration\" from a checkpoint which is a \"snapshot\" of the channel's state.\n   *\n   * @param {CheckpointType | undefined} checkpoint\n   * @returns {this}\n   */\n  fromCheckpoint(checkpoint?: CheckpointType): this;\n\n  /**\n   * Update the channel's value with the given sequence of updates.\n   * The order of the updates in the sequence is arbitrary.\n   *\n   * @throws {InvalidUpdateError} if the sequence of updates is invalid.\n   * @param {Array<UpdateType>} values\n   * @returns {void}\n   */\n  update(values: UpdateType[]): void;\n\n  /**\n   * Return the current value of the channel.\n   *\n   * @throws {EmptyChannelError} if the channel is empty (never updated yet).\n   * @returns {ValueType}\n   */\n  get(): ValueType;\n\n  /**\n   * Return a string representation of the channel's current state.\n   *\n   * @throws {EmptyChannelError} if the channel is empty (never updated yet), or doesn't support checkpoints.\n   * @returns {CheckpointType | undefined}\n   */\n  checkpoint(): CheckpointType | undefined;\n}\n\n// Mirrors SendInterface in \"@langchain/langgraph\"\nexport interface SendProtocol {\n  node: string;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  args: any;\n  // Optional per-task timeout policy. Structural to avoid a dependency on the\n  // langgraph package; mirrors `TimeoutPolicy` in \"@langchain/langgraph\".\n  timeout?: {\n    runTimeout?: number;\n    idleTimeout?: number;\n    refreshOn?: \"auto\" | \"heartbeat\";\n  };\n}\n"],"mappings":";AAAA,MAAa,QAAQ;AACrB,MAAa,QAAQ;AACrB,MAAa,YAAY;AACzB,MAAa,YAAY;AACzB,MAAa,SAAS;;;;;;;;;;;;;;AAetB,IAAa,gBAAb,MAA4C;;CAE1C,UAAU;CAEV;CAEA,YAAY,OAAc;AACxB,OAAK,QAAQ;;;;;;;AAQjB,SAAgB,gBACd,OAC+B;AAC/B,QACE,SAAS,QACT,OAAO,UAAU,YAChB,MAA+B,YAAY"}

package/dist/serde/types.d.cts

@@ -4,6 +4,30 @@ declare const ERROR = "__error__";
 declare const SCHEDULED = "__scheduled__";
 declare const INTERRUPT = "__interrupt__";
 declare const RESUME = "__resume__";
+/**
+ * Snapshot blob for a `DeltaChannel` with finite snapshot frequency.
+ *
+ * Stored directly in a checkpoint's `channel_values` in place of the full
+ * accumulated value. The ancestor walk in
+ * {@link BaseCheckpointSaver.getDeltaChannelHistory} terminates when it
+ * encounters a populated `channel_values` entry for a channel; a
+ * `DeltaSnapshot` value is the materialized state at that ancestor, so the
+ * channel reconstructs directly from `.value` without replaying earlier
+ * writes.
+ *
+ * @remarks Beta. The on-disk representation may change in future releases.
+ */
+declare class DeltaSnapshot<Value = unknown> {
+  /** Marker used for structural detection across module/realm boundaries. */
+  lg_name: "DeltaSnapshot";
+  value: Value;
+  constructor(value: Value);
+}
+/**
+ * Structural type guard for {@link DeltaSnapshot}. Uses the `lg_name` marker
+ * so it survives serialization round-trips and cross-package duplication.
+ */
+declare function isDeltaSnapshot<Value = unknown>(value: unknown): value is DeltaSnapshot<Value>;
 interface ChannelProtocol<ValueType = unknown, UpdateType = unknown, CheckpointType = unknown> {
   ValueType: ValueType;
   UpdateType: UpdateType;
@@ -46,7 +70,12 @@ interface ChannelProtocol<ValueType = unknown, UpdateType = unknown, CheckpointT
 interface SendProtocol {
   node: string;
   args: any;
+  timeout?: {
+    runTimeout?: number;
+    idleTimeout?: number;
+    refreshOn?: "auto" | "heartbeat";
+  };
 }
 //#endregion
-export { ChannelProtocol, ERROR, INTERRUPT, RESUME, SCHEDULED, SendProtocol, TASKS };
+export { ChannelProtocol, DeltaSnapshot, ERROR, INTERRUPT, RESUME, SCHEDULED, SendProtocol, TASKS, isDeltaSnapshot };
 //# sourceMappingURL=types.d.cts.map

package/dist/serde/types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/serde/types.ts"],"mappings":";cAAa,KAAA;AAAA,cACA,KAAA;AAAA,cACA,SAAA;AAAA,cACA,SAAA;AAAA,cACA,MAAA;AAAA,UAGI,eAAA;EAKf,SAAA,EAAW,SAAA;EAEX,UAAA,EAAY,UAAA;;;;EAKZ,aAAA;EAjBoB;;;;AACtB;;;EAyBE,cAAA,CAAe,UAAA,GAAa,cAAA;EAzBR;AACtB;;;;;AAGA;;EA+BE,MAAA,CAAO,MAAA,EAAQ,UAAA;EA1BJ;;;;;;EAkCX,GAAA,IAAO,SAAA;EAQqB;;;;;;EAA5B,UAAA,IAAc,cAAA;AAAA;AAAA,UAIC,YAAA;EACf,IAAA;EAEA,IAAA;AAAA"}
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/serde/types.ts"],"mappings":";cAAa,KAAA;AAAA,cACA,KAAA;AAAA,cACA,SAAA;AAAA,cACA,SAAA;AAAA,cACA,MAAA;;AAHb;;;;;AACA;;;;;AACA;;cAgBa,aAAA;EAhBS;EAkBpB,OAAA;EAEA,KAAA,EAAO,KAAA;EAEP,WAAA,CAAY,KAAA,EAAO,KAAA;AAAA;;;AANrB;;iBAegB,eAAA,iBAAA,CACd,KAAA,YACC,KAAA,IAAS,aAAA,CAAc,KAAA;AAAA,UAST,eAAA;EAKf,SAAA,EAAW,SAAA;EAEX,UAAA,EAAY,UAAA;EA7BZ;;;EAkCA,aAAA;EAhCY;;;AASd;;;;EAgCE,cAAA,CAAe,UAAA,GAAa,cAAA;EA/B5B;;;;;;AAUF;;EA+BE,MAAA,CAAO,MAAA,EAAQ,UAAA;EA1BJ;;;;;;EAkCX,GAAA,IAAO,SAAA;EAQqB;;;;;;EAA5B,UAAA,IAAc,cAAA;AAAA;AAAA,UAIC,YAAA;EACf,IAAA;EAEA,IAAA;EAGA,OAAA;IACE,UAAA;IACA,WAAA;IACA,SAAA;EAAA;AAAA"}

package/dist/serde/types.d.ts

@@ -4,6 +4,30 @@ declare const ERROR = "__error__";
 declare const SCHEDULED = "__scheduled__";
 declare const INTERRUPT = "__interrupt__";
 declare const RESUME = "__resume__";
+/**
+ * Snapshot blob for a `DeltaChannel` with finite snapshot frequency.
+ *
+ * Stored directly in a checkpoint's `channel_values` in place of the full
+ * accumulated value. The ancestor walk in
+ * {@link BaseCheckpointSaver.getDeltaChannelHistory} terminates when it
+ * encounters a populated `channel_values` entry for a channel; a
+ * `DeltaSnapshot` value is the materialized state at that ancestor, so the
+ * channel reconstructs directly from `.value` without replaying earlier
+ * writes.
+ *
+ * @remarks Beta. The on-disk representation may change in future releases.
+ */
+declare class DeltaSnapshot<Value = unknown> {
+  /** Marker used for structural detection across module/realm boundaries. */
+  lg_name: "DeltaSnapshot";
+  value: Value;
+  constructor(value: Value);
+}
+/**
+ * Structural type guard for {@link DeltaSnapshot}. Uses the `lg_name` marker
+ * so it survives serialization round-trips and cross-package duplication.
+ */
+declare function isDeltaSnapshot<Value = unknown>(value: unknown): value is DeltaSnapshot<Value>;
 interface ChannelProtocol<ValueType = unknown, UpdateType = unknown, CheckpointType = unknown> {
   ValueType: ValueType;
   UpdateType: UpdateType;
@@ -46,7 +70,12 @@ interface ChannelProtocol<ValueType = unknown, UpdateType = unknown, CheckpointT
 interface SendProtocol {
   node: string;
   args: any;
+  timeout?: {
+    runTimeout?: number;
+    idleTimeout?: number;
+    refreshOn?: "auto" | "heartbeat";
+  };
 }
 //#endregion
-export { ChannelProtocol, ERROR, INTERRUPT, RESUME, SCHEDULED, SendProtocol, TASKS };
+export { ChannelProtocol, DeltaSnapshot, ERROR, INTERRUPT, RESUME, SCHEDULED, SendProtocol, TASKS, isDeltaSnapshot };
 //# sourceMappingURL=types.d.ts.map

package/dist/serde/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/serde/types.ts"],"mappings":";cAAa,KAAA;AAAA,cACA,KAAA;AAAA,cACA,SAAA;AAAA,cACA,SAAA;AAAA,cACA,MAAA;AAAA,UAGI,eAAA;EAKf,SAAA,EAAW,SAAA;EAEX,UAAA,EAAY,UAAA;;;;EAKZ,aAAA;EAjBoB;;;;AACtB;;;EAyBE,cAAA,CAAe,UAAA,GAAa,cAAA;EAzBR;AACtB;;;;;AAGA;;EA+BE,MAAA,CAAO,MAAA,EAAQ,UAAA;EA1BJ;;;;;;EAkCX,GAAA,IAAO,SAAA;EAQqB;;;;;;EAA5B,UAAA,IAAc,cAAA;AAAA;AAAA,UAIC,YAAA;EACf,IAAA;EAEA,IAAA;AAAA"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/serde/types.ts"],"mappings":";cAAa,KAAA;AAAA,cACA,KAAA;AAAA,cACA,SAAA;AAAA,cACA,SAAA;AAAA,cACA,MAAA;;AAHb;;;;;AACA;;;;;AACA;;cAgBa,aAAA;EAhBS;EAkBpB,OAAA;EAEA,KAAA,EAAO,KAAA;EAEP,WAAA,CAAY,KAAA,EAAO,KAAA;AAAA;;;AANrB;;iBAegB,eAAA,iBAAA,CACd,KAAA,YACC,KAAA,IAAS,aAAA,CAAc,KAAA;AAAA,UAST,eAAA;EAKf,SAAA,EAAW,SAAA;EAEX,UAAA,EAAY,UAAA;EA7BZ;;;EAkCA,aAAA;EAhCY;;;AASd;;;;EAgCE,cAAA,CAAe,UAAA,GAAa,cAAA;EA/B5B;;;;;;AAUF;;EA+BE,MAAA,CAAO,MAAA,EAAQ,UAAA;EA1BJ;;;;;;EAkCX,GAAA,IAAO,SAAA;EAQqB;;;;;;EAA5B,UAAA,IAAc,cAAA;AAAA;AAAA,UAIC,YAAA;EACf,IAAA;EAEA,IAAA;EAGA,OAAA;IACE,UAAA;IACA,WAAA;IACA,SAAA;EAAA;AAAA"}

package/dist/serde/types.js

@@ -4,7 +4,35 @@ const ERROR = "__error__";
 const SCHEDULED = "__scheduled__";
 const INTERRUPT = "__interrupt__";
 const RESUME = "__resume__";
+/**
+* Snapshot blob for a `DeltaChannel` with finite snapshot frequency.
+*
+* Stored directly in a checkpoint's `channel_values` in place of the full
+* accumulated value. The ancestor walk in
+* {@link BaseCheckpointSaver.getDeltaChannelHistory} terminates when it
+* encounters a populated `channel_values` entry for a channel; a
+* `DeltaSnapshot` value is the materialized state at that ancestor, so the
+* channel reconstructs directly from `.value` without replaying earlier
+* writes.
+*
+* @remarks Beta. The on-disk representation may change in future releases.
+*/
+var DeltaSnapshot = class {
+	/** Marker used for structural detection across module/realm boundaries. */
+	lg_name = "DeltaSnapshot";
+	value;
+	constructor(value) {
+		this.value = value;
+	}
+};
+/**
+* Structural type guard for {@link DeltaSnapshot}. Uses the `lg_name` marker
+* so it survives serialization round-trips and cross-package duplication.
+*/
+function isDeltaSnapshot(value) {
+	return value != null && typeof value === "object" && value.lg_name === "DeltaSnapshot";
+}
 //#endregion
-export { ERROR, INTERRUPT, RESUME, SCHEDULED, TASKS };
+export { DeltaSnapshot, ERROR, INTERRUPT, RESUME, SCHEDULED, TASKS, isDeltaSnapshot };
 
 //# sourceMappingURL=types.js.map

package/dist/serde/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../../src/serde/types.ts"],"sourcesContent":["export const TASKS = \"__pregel_tasks\";\nexport const ERROR = \"__error__\";\nexport const SCHEDULED = \"__scheduled__\";\nexport const INTERRUPT = \"__interrupt__\";\nexport const RESUME = \"__resume__\";\n\n// Mirrors BaseChannel in \"@langchain/langgraph\"\nexport interface ChannelProtocol<\n  ValueType = unknown,\n  UpdateType = unknown,\n  CheckpointType = unknown,\n> {\n  ValueType: ValueType;\n\n  UpdateType: UpdateType;\n\n  /**\n   * The name of the channel.\n   */\n  lc_graph_name: string;\n\n  /**\n   * Return a new identical channel, optionally initialized from a checkpoint.\n   * Can be thought of as a \"restoration\" from a checkpoint which is a \"snapshot\" of the channel's state.\n   *\n   * @param {CheckpointType | undefined} checkpoint\n   * @returns {this}\n   */\n  fromCheckpoint(checkpoint?: CheckpointType): this;\n\n  /**\n   * Update the channel's value with the given sequence of updates.\n   * The order of the updates in the sequence is arbitrary.\n   *\n   * @throws {InvalidUpdateError} if the sequence of updates is invalid.\n   * @param {Array<UpdateType>} values\n   * @returns {void}\n   */\n  update(values: UpdateType[]): void;\n\n  /**\n   * Return the current value of the channel.\n   *\n   * @throws {EmptyChannelError} if the channel is empty (never updated yet).\n   * @returns {ValueType}\n   */\n  get(): ValueType;\n\n  /**\n   * Return a string representation of the channel's current state.\n   *\n   * @throws {EmptyChannelError} if the channel is empty (never updated yet), or doesn't support checkpoints.\n   * @returns {CheckpointType | undefined}\n   */\n  checkpoint(): CheckpointType | undefined;\n}\n\n// Mirrors SendInterface in \"@langchain/langgraph\"\nexport interface SendProtocol {\n  node: string;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  args: any;\n}\n"],"mappings":";AAAA,MAAa,QAAQ;AACrB,MAAa,QAAQ;AACrB,MAAa,YAAY;AACzB,MAAa,YAAY;AACzB,MAAa,SAAS"}
+{"version":3,"file":"types.js","names":[],"sources":["../../src/serde/types.ts"],"sourcesContent":["export const TASKS = \"__pregel_tasks\";\nexport const ERROR = \"__error__\";\nexport const SCHEDULED = \"__scheduled__\";\nexport const INTERRUPT = \"__interrupt__\";\nexport const RESUME = \"__resume__\";\n\n/**\n * Snapshot blob for a `DeltaChannel` with finite snapshot frequency.\n *\n * Stored directly in a checkpoint's `channel_values` in place of the full\n * accumulated value. The ancestor walk in\n * {@link BaseCheckpointSaver.getDeltaChannelHistory} terminates when it\n * encounters a populated `channel_values` entry for a channel; a\n * `DeltaSnapshot` value is the materialized state at that ancestor, so the\n * channel reconstructs directly from `.value` without replaying earlier\n * writes.\n *\n * @remarks Beta. The on-disk representation may change in future releases.\n */\nexport class DeltaSnapshot<Value = unknown> {\n  /** Marker used for structural detection across module/realm boundaries. */\n  lg_name = \"DeltaSnapshot\" as const;\n\n  value: Value;\n\n  constructor(value: Value) {\n    this.value = value;\n  }\n}\n\n/**\n * Structural type guard for {@link DeltaSnapshot}. Uses the `lg_name` marker\n * so it survives serialization round-trips and cross-package duplication.\n */\nexport function isDeltaSnapshot<Value = unknown>(\n  value: unknown\n): value is DeltaSnapshot<Value> {\n  return (\n    value != null &&\n    typeof value === \"object\" &&\n    (value as { lg_name?: string }).lg_name === \"DeltaSnapshot\"\n  );\n}\n\n// Mirrors BaseChannel in \"@langchain/langgraph\"\nexport interface ChannelProtocol<\n  ValueType = unknown,\n  UpdateType = unknown,\n  CheckpointType = unknown,\n> {\n  ValueType: ValueType;\n\n  UpdateType: UpdateType;\n\n  /**\n   * The name of the channel.\n   */\n  lc_graph_name: string;\n\n  /**\n   * Return a new identical channel, optionally initialized from a checkpoint.\n   * Can be thought of as a \"restoration\" from a checkpoint which is a \"snapshot\" of the channel's state.\n   *\n   * @param {CheckpointType | undefined} checkpoint\n   * @returns {this}\n   */\n  fromCheckpoint(checkpoint?: CheckpointType): this;\n\n  /**\n   * Update the channel's value with the given sequence of updates.\n   * The order of the updates in the sequence is arbitrary.\n   *\n   * @throws {InvalidUpdateError} if the sequence of updates is invalid.\n   * @param {Array<UpdateType>} values\n   * @returns {void}\n   */\n  update(values: UpdateType[]): void;\n\n  /**\n   * Return the current value of the channel.\n   *\n   * @throws {EmptyChannelError} if the channel is empty (never updated yet).\n   * @returns {ValueType}\n   */\n  get(): ValueType;\n\n  /**\n   * Return a string representation of the channel's current state.\n   *\n   * @throws {EmptyChannelError} if the channel is empty (never updated yet), or doesn't support checkpoints.\n   * @returns {CheckpointType | undefined}\n   */\n  checkpoint(): CheckpointType | undefined;\n}\n\n// Mirrors SendInterface in \"@langchain/langgraph\"\nexport interface SendProtocol {\n  node: string;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  args: any;\n  // Optional per-task timeout policy. Structural to avoid a dependency on the\n  // langgraph package; mirrors `TimeoutPolicy` in \"@langchain/langgraph\".\n  timeout?: {\n    runTimeout?: number;\n    idleTimeout?: number;\n    refreshOn?: \"auto\" | \"heartbeat\";\n  };\n}\n"],"mappings":";AAAA,MAAa,QAAQ;AACrB,MAAa,QAAQ;AACrB,MAAa,YAAY;AACzB,MAAa,YAAY;AACzB,MAAa,SAAS;;;;;;;;;;;;;;AAetB,IAAa,gBAAb,MAA4C;;CAE1C,UAAU;CAEV;CAEA,YAAY,OAAc;AACxB,OAAK,QAAQ;;;;;;;AAQjB,SAAgB,gBACd,OAC+B;AAC/B,QACE,SAAS,QACT,OAAO,UAAU,YAChB,MAA+B,YAAY"}

package/dist/types.d.cts

@@ -29,7 +29,53 @@ type CheckpointMetadata<ExtraProperties extends object = object> = {
    * Mapping from checkpoint namespace to checkpoint ID.
    */
   parents: Record<string, string>;
+  /**
+   * Per-channel counters since the last `DeltaSnapshot` was written, backing
+   * `DeltaChannel`.
+   *
+   * Maps channel name to a `[updates, supersteps]` pair:
+   * - `updates` (index 0): number of supersteps that wrote to this channel
+   *   since its last snapshot blob.
+   * - `supersteps` (index 1): total supersteps elapsed since this channel's
+   *   last snapshot, regardless of whether the channel was written.
+   *
+   * A snapshot fires when EITHER `updates >= ch.snapshotFrequency` OR
+   * `supersteps >= DELTA_MAX_SUPERSTEPS_SINCE_SNAPSHOT` (system-wide bound,
+   * default 5000, env `LANGGRAPH_DELTA_MAX_SUPERSTEPS_SINCE_SNAPSHOT`). The
+   * supersteps bound prevents unbounded ancestor walks on threads where a
+   * delta channel exists but is no longer being updated.
+   *
+   * Absent on threads that don't use delta channels.
+   *
+   * @remarks Beta. The key name and contents may change while the
+   * delta-channel design stabilizes.
+   */
+  counters_since_delta_snapshot?: Record<string, [number, number]>;
 } & ExtraProperties;
+/**
+ * Per-channel result entry from
+ * {@link BaseCheckpointSaver.getDeltaChannelHistory}.
+ *
+ * Storage-level view of what one channel contributed across the ancestor
+ * chain of a target checkpoint:
+ *
+ * - `writes` — on-path deltas oldest→newest as {@link CheckpointPendingWrite}
+ *   tuples. Always present; possibly empty. Already filtered to one channel.
+ *   Writes stored at the target checkpoint itself are pending for the next
+ *   super-step and are excluded.
+ * - `seed` — the stored value at the nearest ancestor whose
+ *   `channel_values[ch]` is populated. Omitted if the walk reached the root
+ *   without finding any stored value (the consumer treats absence as "start
+ *   empty"). Typically a `DeltaSnapshot` for delta channels with finite
+ *   snapshot frequency, or a plain value for threads migrated from a
+ *   pre-delta channel type.
+ *
+ * @remarks Beta. Field names and semantics may change.
+ */
+type DeltaChannelHistory = {
+  writes: CheckpointPendingWrite[];
+  seed?: unknown;
+};
 //#endregion
-export { All, CheckpointMetadata, CheckpointPendingWrite, PendingWrite, PendingWriteValue };
+export { All, CheckpointMetadata, CheckpointPendingWrite, DeltaChannelHistory, PendingWrite, PendingWriteValue };
 //# sourceMappingURL=types.d.cts.map

package/dist/types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","names":[],"sources":["../src/types.ts"],"mappings":";KAAY,GAAA;AAAA,KAEA,iBAAA;AAAA,KAEA,YAAA,sBAAkC,OAAA,EAAS,iBAAA;AAAA,KAE3C,sBAAA,qBACV,MAAA,KACG,YAAA;;;;;AAJL;KAYY,kBAAA;EAZY;;;;;;;EAoBtB,MAAA;EAlBgC;;;;;;EA0BhC,IAAA;EAxBe;AAQjB;;;EAsBE,OAAA,EAAS,MAAA;AAAA,IACP,eAAA"}
+{"version":3,"file":"types.d.cts","names":[],"sources":["../src/types.ts"],"mappings":";KAAY,GAAA;AAAA,KAEA,iBAAA;AAAA,KAEA,YAAA,sBAAkC,OAAA,EAAS,iBAAA;AAAA,KAE3C,sBAAA,qBACV,MAAA,KACG,YAAA;;;;;AAJL;KAYY,kBAAA;EAZY;;;;;;;EAoBtB,MAAA;EAlBgC;;;;;;EA0BhC,IAAA;EAxBe;AAQjB;;;EAsBE,OAAA,EAAS,MAAA;EAuBuB;;;;;;;;;;;;;;AAuBlC;;;;;;;EAvBE,6BAAA,GAAgC,MAAA;AAAA,IAC9B,eAAA;;;;;;;;;;;;;;;;;;;;;KAsBQ,mBAAA;EACV,MAAA,EAAQ,sBAAA;EACR,IAAA;AAAA"}

package/dist/types.d.ts

@@ -29,7 +29,53 @@ type CheckpointMetadata<ExtraProperties extends object = object> = {
    * Mapping from checkpoint namespace to checkpoint ID.
    */
   parents: Record<string, string>;
+  /**
+   * Per-channel counters since the last `DeltaSnapshot` was written, backing
+   * `DeltaChannel`.
+   *
+   * Maps channel name to a `[updates, supersteps]` pair:
+   * - `updates` (index 0): number of supersteps that wrote to this channel
+   *   since its last snapshot blob.
+   * - `supersteps` (index 1): total supersteps elapsed since this channel's
+   *   last snapshot, regardless of whether the channel was written.
+   *
+   * A snapshot fires when EITHER `updates >= ch.snapshotFrequency` OR
+   * `supersteps >= DELTA_MAX_SUPERSTEPS_SINCE_SNAPSHOT` (system-wide bound,
+   * default 5000, env `LANGGRAPH_DELTA_MAX_SUPERSTEPS_SINCE_SNAPSHOT`). The
+   * supersteps bound prevents unbounded ancestor walks on threads where a
+   * delta channel exists but is no longer being updated.
+   *
+   * Absent on threads that don't use delta channels.
+   *
+   * @remarks Beta. The key name and contents may change while the
+   * delta-channel design stabilizes.
+   */
+  counters_since_delta_snapshot?: Record<string, [number, number]>;
 } & ExtraProperties;
+/**
+ * Per-channel result entry from
+ * {@link BaseCheckpointSaver.getDeltaChannelHistory}.
+ *
+ * Storage-level view of what one channel contributed across the ancestor
+ * chain of a target checkpoint:
+ *
+ * - `writes` — on-path deltas oldest→newest as {@link CheckpointPendingWrite}
+ *   tuples. Always present; possibly empty. Already filtered to one channel.
+ *   Writes stored at the target checkpoint itself are pending for the next
+ *   super-step and are excluded.
+ * - `seed` — the stored value at the nearest ancestor whose
+ *   `channel_values[ch]` is populated. Omitted if the walk reached the root
+ *   without finding any stored value (the consumer treats absence as "start
+ *   empty"). Typically a `DeltaSnapshot` for delta channels with finite
+ *   snapshot frequency, or a plain value for threads migrated from a
+ *   pre-delta channel type.
+ *
+ * @remarks Beta. Field names and semantics may change.
+ */
+type DeltaChannelHistory = {
+  writes: CheckpointPendingWrite[];
+  seed?: unknown;
+};
 //#endregion
-export { All, CheckpointMetadata, CheckpointPendingWrite, PendingWrite, PendingWriteValue };
+export { All, CheckpointMetadata, CheckpointPendingWrite, DeltaChannelHistory, PendingWrite, PendingWriteValue };
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"mappings":";KAAY,GAAA;AAAA,KAEA,iBAAA;AAAA,KAEA,YAAA,sBAAkC,OAAA,EAAS,iBAAA;AAAA,KAE3C,sBAAA,qBACV,MAAA,KACG,YAAA;;;;;AAJL;KAYY,kBAAA;EAZY;;;;;;;EAoBtB,MAAA;EAlBgC;;;;;;EA0BhC,IAAA;EAxBe;AAQjB;;;EAsBE,OAAA,EAAS,MAAA;AAAA,IACP,eAAA"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"mappings":";KAAY,GAAA;AAAA,KAEA,iBAAA;AAAA,KAEA,YAAA,sBAAkC,OAAA,EAAS,iBAAA;AAAA,KAE3C,sBAAA,qBACV,MAAA,KACG,YAAA;;;;;AAJL;KAYY,kBAAA;EAZY;;;;;;;EAoBtB,MAAA;EAlBgC;;;;;;EA0BhC,IAAA;EAxBe;AAQjB;;;EAsBE,OAAA,EAAS,MAAA;EAuBuB;;;;;;;;;;;;;;AAuBlC;;;;;;;EAvBE,6BAAA,GAAgC,MAAA;AAAA,IAC9B,eAAA;;;;;;;;;;;;;;;;;;;;;KAsBQ,mBAAA;EACV,MAAA,EAAQ,sBAAA;EACR,IAAA;AAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph-checkpoint",
-  "version": "1.0.4",
+  "version": "1.1.0",
   "description": "Library with base interfaces for LangGraph checkpoint savers.",
   "type": "module",
   "engines": {
@@ -30,7 +30,7 @@
     "rollup": "^4.37.0",
     "tsx": "^4.19.3",
     "typescript": "^4.9.5 || ^5.4.5",
-    "vitest": "^3.2.4"
+    "vitest": "^4.1.0"
   },
   "publishConfig": {
     "access": "public",