@langchain/langgraph-sdk 0.0.1-rc.7 → 0.0.1-rc.9

package/dist/client.d.mts

@@ -138,17 +138,16 @@ declare class ThreadsClient extends BaseClient {
      * @param threadId ID of the thread.
      * @returns Thread state.
      */
-    getState<ValuesType = DefaultValues>(threadId: string): Promise<ThreadState<ValuesType>>;
+    getState<ValuesType = DefaultValues>(threadId: string, checkpointId?: string): Promise<ThreadState<ValuesType>>;
     /**
      * Add state to a thread.
      *
-     * @param threadIdOrConfig Thread ID or config that identifies the state to start from.
-     * @param values The state update
-     * @param options Additional options.
+     * @param threadId The ID of the thread.
      * @returns
      */
-    updateState<ValuesType = DefaultValues>(threadIdOrConfig: string | Config, options: {
+    updateState<ValuesType = DefaultValues>(threadId: string, options: {
         values: ValuesType;
+        checkpointId?: string;
         asNode?: string;
     }): Promise<void>;
     /**
@@ -168,6 +167,7 @@ declare class ThreadsClient extends BaseClient {
     getHistory<ValuesType = DefaultValues>(threadId: string, options?: {
         limit?: number;
         before?: Config;
+        metadata?: Metadata;
     }): Promise<ThreadState<ValuesType>[]>;
 }
 declare class RunsClient extends BaseClient {

package/dist/client.mjs

@@ -198,34 +198,25 @@ class ThreadsClient extends BaseClient {
      * @param threadId ID of the thread.
      * @returns Thread state.
      */
-    async getState(threadId) {
-        return this.fetch(`/threads/${threadId}/state`);
+    async getState(threadId, checkpointId) {
+        return this.fetch(checkpointId != null
+            ? `/threads/${threadId}/state/${checkpointId}`
+            : `/threads/${threadId}/state`);
     }
     /**
      * Add state to a thread.
      *
-     * @param threadIdOrConfig Thread ID or config that identifies the state to start from.
-     * @param values The state update
-     * @param options Additional options.
+     * @param threadId The ID of the thread.
      * @returns
      */
-    async updateState(threadIdOrConfig, options) {
-        let config = undefined;
-        let threadId;
-        if (typeof threadIdOrConfig !== "string") {
-            config = threadIdOrConfig;
-            if (typeof config.configurable?.thread_id !== "string") {
-                throw new Error("Thread ID is required when updating state with a config.");
-            }
-            threadId = config.configurable.thread_id;
-        }
-        else {
-            config = undefined;
-            threadId = threadIdOrConfig;
-        }
+    async updateState(threadId, options) {
         return this.fetch(`/threads/${threadId}/state`, {
             method: "POST",
-            json: { values: options.values, config, as_node: options?.asNode },
+            json: {
+                values: options.values,
+                checkpoint_id: options.checkpointId,
+                as_node: options?.asNode,
+            },
         });
     }
     /**
@@ -259,9 +250,11 @@ class ThreadsClient extends BaseClient {
      */
     async getHistory(threadId, options) {
         return this.fetch(`/threads/${threadId}/history`, {
-            params: {
+            method: "POST",
+            json: {
                 limit: options?.limit ?? 10,
                 before: options?.before,
+                metadata: options?.metadata,
             },
         });
     }

package/dist/schema.d.ts

@@ -1,3 +1,4 @@
+import type { JSONSchema7 } from "json-schema";
 type Optional<T> = T | null | undefined;
 export interface Config {
     /**
@@ -14,7 +15,14 @@ export interface Config {
      * Runtime values for attributes previously made configurable on this Runnable.
      */
     configurable: {
+        /**
+         * ID of the thread
+         */
         thread_id?: string;
+        /**
+         * Timestamp of the state checkpoint
+         */
+        thread_ts?: string;
         [key: string]: unknown;
     };
 }
@@ -26,11 +34,11 @@ export interface GraphSchema {
     /**
      * The schema for the graph state
      */
-    state_schema: Record<string, unknown>;
+    state_schema: JSONSchema7;
     /**
      * The schema for the graph config
      */
-    config_schema: Record<string, unknown>;
+    config_schema: JSONSchema7;
 }
 export type Metadata = Optional<Record<string, unknown>>;
 export interface Assistant {
@@ -52,10 +60,10 @@ export type DefaultValues = Record<string, unknown>[] | Record<string, unknown>;
 export interface ThreadState<ValuesType = DefaultValues> {
     values: ValuesType;
     next: string[];
-    config: Config;
+    checkpoint_id: string;
     metadata: Metadata;
     created_at: Optional<string>;
-    parent_config: Optional<Config>;
+    parent_checkpoint_id: Optional<string>;
 }
 export interface Run {
     run_id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph-sdk",
-  "version": "0.0.1-rc.7",
+  "version": "0.0.1-rc.9",
   "description": "Client library for interacting with the LangGraph API",
   "type": "module",
   "packageManager": "yarn@1.22.19",
@@ -16,6 +16,7 @@
   "main": "index.js",
   "license": "MIT",
   "dependencies": {
+    "@types/json-schema": "^7.0.15",
     "eventsource-parser": "^1.1.2",
     "p-queue": "^6.6.2",
     "p-retry": "4",