@langchain/langgraph-sdk 0.0.20 → 0.0.22

package/dist/client.cjs

@@ -375,6 +375,7 @@ class ThreadsClient extends BaseClient {
                 metadata: query?.metadata ?? undefined,
                 limit: query?.limit ?? 10,
                 offset: query?.offset ?? 0,
+                status: query?.status,
             },
         });
     }
@@ -646,13 +647,15 @@ class RunsClient extends BaseClient {
      * @param threadId The ID of the thread.
      * @param runId The ID of the run.
      * @param wait Whether to block when canceling
+     * @param action Action to take when cancelling the run. Possible values are `interrupt` or `rollback`. Default is `interrupt`.
      * @returns
      */
-    async cancel(threadId, runId, wait = false) {
+    async cancel(threadId, runId, wait = false, action = "interrupt") {
         return this.fetch(`/threads/${threadId}/runs/${runId}/cancel`, {
             method: "POST",
             params: {
                 wait: wait ? "1" : "0",
+                action: action,
             },
         });
     }

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { Assistant, AssistantGraph, Config, DefaultValues, GraphSchema, Metadata, Run, Thread, ThreadState, Cron, AssistantVersion, Subgraphs, Checkpoint, SearchItemsResponse, ListNamespaceResponse, Item } from "./schema.js";
+import { Assistant, AssistantGraph, CancelAction, Config, DefaultValues, GraphSchema, Metadata, Run, Thread, ThreadState, Cron, AssistantVersion, Subgraphs, Checkpoint, SearchItemsResponse, ListNamespaceResponse, Item, ThreadStatus } from "./schema.js";
 import { AsyncCaller, AsyncCallerParams } from "./utils/async_caller.js";
 import { RunsCreatePayload, RunsStreamPayload, RunsWaitPayload, StreamEvent, CronsCreatePayload, OnConflictBehavior } from "./types.js";
 interface ClientConfig {
@@ -222,6 +222,11 @@ export declare class ThreadsClient extends BaseClient {
          * Offset to start from.
          */
         offset?: number;
+        /**
+         * Thread status to filter on.
+         * Must be one of 'idle', 'busy', 'interrupted' or 'error'.
+         */
+        status?: ThreadStatus;
     }): Promise<Thread[]>;
     /**
      * Get state for a thread.
@@ -327,9 +332,10 @@ export declare class RunsClient extends BaseClient {
      * @param threadId The ID of the thread.
      * @param runId The ID of the run.
      * @param wait Whether to block when canceling
+     * @param action Action to take when cancelling the run. Possible values are `interrupt` or `rollback`. Default is `interrupt`.
      * @returns
      */
-    cancel(threadId: string, runId: string, wait?: boolean): Promise<void>;
+    cancel(threadId: string, runId: string, wait?: boolean, action?: CancelAction): Promise<void>;
     /**
      * Block until a run is done.
      *

package/dist/client.js

@@ -370,6 +370,7 @@ export class ThreadsClient extends BaseClient {
                 metadata: query?.metadata ?? undefined,
                 limit: query?.limit ?? 10,
                 offset: query?.offset ?? 0,
+                status: query?.status,
             },
         });
     }
@@ -640,13 +641,15 @@ export class RunsClient extends BaseClient {
      * @param threadId The ID of the thread.
      * @param runId The ID of the run.
      * @param wait Whether to block when canceling
+     * @param action Action to take when cancelling the run. Possible values are `interrupt` or `rollback`. Default is `interrupt`.
      * @returns
      */
-    async cancel(threadId, runId, wait = false) {
+    async cancel(threadId, runId, wait = false, action = "interrupt") {
         return this.fetch(`/threads/${threadId}/runs/${runId}/cancel`, {
             method: "POST",
             params: {
                 wait: wait ? "1" : "0",
+                action: action,
             },
         });
     }

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export { Client } from "./client.js";
-export type { Assistant, AssistantVersion, AssistantGraph, Config, DefaultValues, GraphSchema, Metadata, Run, Thread, ThreadState, Cron, Checkpoint, } from "./schema.js";
+export type { Assistant, AssistantVersion, AssistantGraph, Config, DefaultValues, GraphSchema, Metadata, Run, Thread, ThreadState, ThreadStatus, Cron, Checkpoint, } from "./schema.js";
 export type { OnConflictBehavior } from "./types.js";

package/dist/schema.d.ts

@@ -1,8 +1,9 @@
 import type { JSONSchema7 } from "json-schema";
 type Optional<T> = T | null | undefined;
 type RunStatus = "pending" | "running" | "error" | "success" | "timeout" | "interrupted";
-type ThreadStatus = "idle" | "busy" | "interrupted" | "error";
+export type ThreadStatus = "idle" | "busy" | "interrupted" | "error";
 type MultitaskStrategy = "reject" | "interrupt" | "rollback" | "enqueue";
+export type CancelAction = "interrupt" | "rollback";
 export interface Config {
     /**
      * Tags for this call and any sub-calls (eg. a Chain calling an LLM).
@@ -56,7 +57,13 @@ export interface GraphSchema {
     config_schema?: JSONSchema7;
 }
 export type Subgraphs = Record<string, GraphSchema>;
-export type Metadata = Optional<Record<string, unknown>>;
+export type Metadata = Optional<{
+    source?: "input" | "loop" | "update" | (string & {});
+    step?: number;
+    writes?: Record<string, unknown> | null;
+    parents?: Record<string, string>;
+    [key: string]: unknown;
+}>;
 export interface AssistantBase {
     /** The ID of the assistant. */
     assistant_id: string;
@@ -79,7 +86,20 @@ export interface Assistant extends AssistantBase {
     /** The name of the assistant */
     name: string;
 }
-export type AssistantGraph = Record<string, Array<Record<string, unknown>>>;
+export interface AssistantGraph {
+    nodes: Array<{
+        id: string | number;
+        name?: string;
+        data?: Record<string, any> | string;
+        metadata?: unknown;
+    }>;
+    edges: Array<{
+        source: string;
+        target: string;
+        data?: string;
+        conditional?: boolean;
+    }>;
+}
 export interface Thread<ValuesType = DefaultValues> {
     /** The ID of the thread. */
     thread_id: string;
@@ -131,7 +151,10 @@ export interface ThreadTask {
     id: string;
     name: string;
     error: Optional<string>;
-    interrupts: Array<Record<string, unknown>>;
+    interrupts: Array<{
+        value: unknown;
+        when: "during";
+    }>;
     checkpoint: Optional<Checkpoint>;
     state: Optional<ThreadState>;
 }

package/dist/types.d.ts

@@ -29,11 +29,11 @@ interface RunsInvokePayload {
     /**
      * Interrupt execution before entering these nodes.
      */
-    interruptBefore?: string[];
+    interruptBefore?: "*" | string[];
     /**
      * Interrupt execution after leaving these nodes.
      */
-    interruptAfter?: string[];
+    interruptAfter?: "*" | string[];
     /**
      * Strategy to handle concurrent runs on the same thread. Only relevant if
      * there is a pending/inflight run on the same thread. One of:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph-sdk",
-  "version": "0.0.20",
+  "version": "0.0.22",
   "description": "Client library for interacting with the LangGraph API",
   "type": "module",
   "packageManager": "yarn@1.22.19",