@langchain/langgraph-sdk 0.0.19 → 0.0.21

package/dist/client.cjs

@@ -109,6 +109,7 @@ class CronsClient extends BaseClient {
             interrupt_after: payload?.interruptAfter,
             webhook: payload?.webhook,
             multitask_strategy: payload?.multitaskStrategy,
+            if_not_exists: payload?.ifNotExists,
         };
         return this.fetch(`/threads/${threadId}/runs/crons`, {
             method: "POST",
@@ -132,6 +133,7 @@ class CronsClient extends BaseClient {
             interrupt_after: payload?.interruptAfter,
             webhook: payload?.webhook,
             multitask_strategy: payload?.multitaskStrategy,
+            if_not_exists: payload?.ifNotExists,
         };
         return this.fetch(`/runs/crons`, {
             method: "POST",
@@ -482,6 +484,7 @@ class RunsClient extends BaseClient {
             on_completion: payload?.onCompletion,
             on_disconnect: payload?.onDisconnect,
             after_seconds: payload?.afterSeconds,
+            if_not_exists: payload?.ifNotExists,
         };
         const endpoint = threadId == null ? `/runs/stream` : `/threads/${threadId}/runs/stream`;
         const response = await this.asyncCaller.fetch(...this.prepareFetchOptions(endpoint, {
@@ -544,6 +547,7 @@ class RunsClient extends BaseClient {
             checkpoint_id: payload?.checkpointId,
             multitask_strategy: payload?.multitaskStrategy,
             after_seconds: payload?.afterSeconds,
+            if_not_exists: payload?.ifNotExists,
         };
         return this.fetch(`/threads/${threadId}/runs`, {
             method: "POST",
@@ -591,6 +595,7 @@ class RunsClient extends BaseClient {
             on_completion: payload?.onCompletion,
             on_disconnect: payload?.onDisconnect,
             after_seconds: payload?.afterSeconds,
+            if_not_exists: payload?.ifNotExists,
         };
         const endpoint = threadId == null ? `/runs/wait` : `/threads/${threadId}/runs/wait`;
         const response = await this.fetch(endpoint, {
@@ -641,13 +646,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 } from "./schema.js";
 import { AsyncCaller, AsyncCallerParams } from "./utils/async_caller.js";
 import { RunsCreatePayload, RunsStreamPayload, RunsWaitPayload, StreamEvent, CronsCreatePayload, OnConflictBehavior } from "./types.js";
 interface ClientConfig {
@@ -327,9 +327,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

@@ -106,6 +106,7 @@ export class CronsClient extends BaseClient {
             interrupt_after: payload?.interruptAfter,
             webhook: payload?.webhook,
             multitask_strategy: payload?.multitaskStrategy,
+            if_not_exists: payload?.ifNotExists,
         };
         return this.fetch(`/threads/${threadId}/runs/crons`, {
             method: "POST",
@@ -129,6 +130,7 @@ export class CronsClient extends BaseClient {
             interrupt_after: payload?.interruptAfter,
             webhook: payload?.webhook,
             multitask_strategy: payload?.multitaskStrategy,
+            if_not_exists: payload?.ifNotExists,
         };
         return this.fetch(`/runs/crons`, {
             method: "POST",
@@ -476,6 +478,7 @@ export class RunsClient extends BaseClient {
             on_completion: payload?.onCompletion,
             on_disconnect: payload?.onDisconnect,
             after_seconds: payload?.afterSeconds,
+            if_not_exists: payload?.ifNotExists,
         };
         const endpoint = threadId == null ? `/runs/stream` : `/threads/${threadId}/runs/stream`;
         const response = await this.asyncCaller.fetch(...this.prepareFetchOptions(endpoint, {
@@ -538,6 +541,7 @@ export class RunsClient extends BaseClient {
             checkpoint_id: payload?.checkpointId,
             multitask_strategy: payload?.multitaskStrategy,
             after_seconds: payload?.afterSeconds,
+            if_not_exists: payload?.ifNotExists,
         };
         return this.fetch(`/threads/${threadId}/runs`, {
             method: "POST",
@@ -585,6 +589,7 @@ export class RunsClient extends BaseClient {
             on_completion: payload?.onCompletion,
             on_disconnect: payload?.onDisconnect,
             after_seconds: payload?.afterSeconds,
+            if_not_exists: payload?.ifNotExists,
         };
         const endpoint = threadId == null ? `/runs/wait` : `/threads/${threadId}/runs/wait`;
         const response = await this.fetch(endpoint, {
@@ -635,13 +640,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/schema.d.ts

@@ -3,6 +3,7 @@ type Optional<T> = T | null | undefined;
 type RunStatus = "pending" | "running" | "error" | "success" | "timeout" | "interrupted";
 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:
@@ -72,6 +72,10 @@ interface RunsInvokePayload {
      * Use to schedule future runs.
      */
     afterSeconds?: number;
+    /**
+     * Behavior if the specified run doesn't exist. Defaults to "reject".
+     */
+    ifNotExists?: "create" | "reject";
 }
 export interface RunsStreamPayload extends RunsInvokePayload {
     /**

package/package.json

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