@langchain/langgraph-sdk 1.8.10 → 1.9.1

package/dist/client/threads/index.cjs

@@ -0,0 +1,271 @@
+require("../../_virtual/_rolldown/runtime.cjs");
+const require_base = require("../base.cjs");
+const require_index = require("../stream/index.cjs");
+const require_http = require("../stream/transport/http.cjs");
+const require_websocket = require("../stream/transport/websocket.cjs");
+let uuid = require("uuid");
+//#region src/client/threads/index.ts
+var ThreadsClient = class extends require_base.BaseClient {
+	/**
+	* Get a thread by ID.
+	*
+	* @param threadId ID of the thread.
+	* @returns The thread.
+	*/
+	async get(threadId, options) {
+		return this.fetch(`/threads/${threadId}`, {
+			params: { include: options?.include ?? void 0 },
+			signal: options?.signal
+		});
+	}
+	/**
+	* Create a new thread.
+	*
+	* @param payload Payload for creating a thread.
+	* @returns The created thread.
+	*/
+	async create(payload) {
+		const ttlPayload = typeof payload?.ttl === "number" ? {
+			ttl: payload.ttl,
+			strategy: "delete"
+		} : payload?.ttl;
+		return this.fetch(`/threads`, {
+			method: "POST",
+			json: {
+				metadata: {
+					...payload?.metadata,
+					graph_id: payload?.graphId
+				},
+				thread_id: payload?.threadId,
+				if_exists: payload?.ifExists,
+				supersteps: payload?.supersteps?.map((s) => ({ updates: s.updates.map((u) => ({
+					values: u.values,
+					command: u.command,
+					as_node: u.asNode
+				})) })),
+				ttl: ttlPayload
+			},
+			signal: payload?.signal
+		});
+	}
+	/**
+	* Copy an existing thread
+	* @param threadId ID of the thread to be copied
+	* @returns Newly copied thread
+	*/
+	async copy(threadId, options) {
+		return this.fetch(`/threads/${threadId}/copy`, {
+			method: "POST",
+			signal: options?.signal
+		});
+	}
+	async update(threadId, payload) {
+		const ttlPayload = typeof payload?.ttl === "number" ? {
+			ttl: payload.ttl,
+			strategy: "delete"
+		} : payload?.ttl;
+		return this.fetch(`/threads/${threadId}`, {
+			method: "PATCH",
+			headers: payload?.returnMinimal ? { Prefer: "return=minimal" } : void 0,
+			json: {
+				metadata: payload?.metadata,
+				ttl: ttlPayload
+			},
+			signal: payload?.signal
+		});
+	}
+	/**
+	* Delete a thread.
+	*
+	* @param threadId ID of the thread.
+	*/
+	async delete(threadId, options) {
+		return this.fetch(`/threads/${threadId}`, {
+			method: "DELETE",
+			signal: options?.signal
+		});
+	}
+	/**
+	* Prune threads by ID. The 'delete' strategy removes threads entirely.
+	* The 'keep_latest' strategy prunes old checkpoints but keeps threads
+	* and their latest state.
+	*
+	* @param threadIds List of thread IDs to prune.
+	* @param options Additional options for pruning.
+	* @param options.strategy The prune strategy. Defaults to 'delete'.
+	* @param options.signal Signal to abort the request.
+	* @returns An object containing `pruned_count`.
+	*/
+	async prune(threadIds, options) {
+		return this.fetch("/threads/prune", {
+			method: "POST",
+			json: {
+				thread_ids: threadIds,
+				strategy: options?.strategy ?? "delete"
+			},
+			signal: options?.signal
+		});
+	}
+	/**
+	* List threads
+	*
+	* @param query Query options
+	* @returns List of threads
+	*/
+	async search(query) {
+		return this.fetch("/threads/search", {
+			method: "POST",
+			json: {
+				metadata: query?.metadata ?? void 0,
+				ids: query?.ids ?? void 0,
+				limit: query?.limit ?? 10,
+				offset: query?.offset ?? 0,
+				status: query?.status,
+				sort_by: query?.sortBy,
+				sort_order: query?.sortOrder,
+				select: query?.select ?? void 0,
+				values: query?.values ?? void 0,
+				extract: query?.extract ?? void 0
+			},
+			signal: query?.signal
+		});
+	}
+	/**
+	* Count threads matching filters.
+	*
+	* @param query.metadata Thread metadata to filter on.
+	* @param query.values State values to filter on.
+	* @param query.status Thread status to filter on.
+	* @returns Number of threads matching the criteria.
+	*/
+	async count(query) {
+		return this.fetch(`/threads/count`, {
+			method: "POST",
+			json: {
+				metadata: query?.metadata ?? void 0,
+				values: query?.values ?? void 0,
+				status: query?.status ?? void 0
+			},
+			signal: query?.signal
+		});
+	}
+	/**
+	* Get state for a thread.
+	*
+	* @param threadId ID of the thread.
+	* @returns Thread state.
+	*/
+	async getState(threadId, checkpoint, options) {
+		if (checkpoint != null) {
+			if (typeof checkpoint !== "string") return this.fetch(`/threads/${threadId}/state/checkpoint`, {
+				method: "POST",
+				json: {
+					checkpoint,
+					subgraphs: options?.subgraphs
+				},
+				signal: options?.signal
+			});
+			return this.fetch(`/threads/${threadId}/state/${checkpoint}`, {
+				params: { subgraphs: options?.subgraphs },
+				signal: options?.signal
+			});
+		}
+		return this.fetch(`/threads/${threadId}/state`, {
+			params: { subgraphs: options?.subgraphs },
+			signal: options?.signal
+		});
+	}
+	/**
+	* Add state to a thread.
+	*
+	* @param threadId The ID of the thread.
+	* @returns
+	*/
+	async updateState(threadId, options) {
+		return this.fetch(`/threads/${threadId}/state`, {
+			method: "POST",
+			json: {
+				values: options.values,
+				checkpoint: options.checkpoint,
+				checkpoint_id: options.checkpointId,
+				as_node: options?.asNode
+			},
+			signal: options?.signal
+		});
+	}
+	/**
+	* Patch the metadata of a thread.
+	*
+	* @param threadIdOrConfig Thread ID or config to patch the state of.
+	* @param metadata Metadata to patch the state with.
+	*/
+	async patchState(threadIdOrConfig, metadata, options) {
+		let threadId;
+		if (typeof threadIdOrConfig !== "string") {
+			if (typeof threadIdOrConfig.configurable?.thread_id !== "string") throw new Error("Thread ID is required when updating state with a config.");
+			threadId = threadIdOrConfig.configurable.thread_id;
+		} else threadId = threadIdOrConfig;
+		return this.fetch(`/threads/${threadId}/state`, {
+			method: "PATCH",
+			json: { metadata },
+			signal: options?.signal
+		});
+	}
+	/**
+	* Get all past states for a thread.
+	*
+	* @param threadId ID of the thread.
+	* @param options Additional options.
+	* @returns List of thread states.
+	*/
+	async getHistory(threadId, options) {
+		return this.fetch(`/threads/${threadId}/history`, {
+			method: "POST",
+			json: {
+				limit: options?.limit ?? 10,
+				before: options?.before,
+				metadata: options?.metadata,
+				checkpoint: options?.checkpoint
+			},
+			signal: options?.signal
+		});
+	}
+	async *joinStream(threadId, options) {
+		yield* this.streamWithRetry({
+			endpoint: `/threads/${threadId}/stream`,
+			method: "GET",
+			signal: options?.signal,
+			headers: options?.lastEventId ? { "Last-Event-ID": options.lastEventId } : void 0,
+			params: options?.streamMode ? { stream_mode: options.streamMode } : void 0
+		});
+	}
+	stream(threadIdOrOptions, maybeOptions) {
+		const { threadId, options } = typeof threadIdOrOptions === "string" ? {
+			threadId: threadIdOrOptions,
+			options: maybeOptions
+		} : {
+			threadId: (0, uuid.v7)(),
+			options: threadIdOrOptions
+		};
+		let transport;
+		if (options.transport != null && typeof options.transport !== "string") transport = options.transport;
+		else transport = (options.transport ?? (this.streamProtocol === "v2-websocket" ? "websocket" : "sse")) === "websocket" ? new require_websocket.ProtocolWebSocketTransportAdapter({
+			apiUrl: this.apiUrl,
+			threadId,
+			defaultHeaders: this.defaultHeaders,
+			onRequest: this.onRequest,
+			webSocketFactory: options.webSocketFactory
+		}) : new require_http.ProtocolSseTransportAdapter({
+			apiUrl: this.apiUrl,
+			threadId,
+			defaultHeaders: this.defaultHeaders,
+			onRequest: this.onRequest,
+			fetch: options.fetch
+		});
+		return new require_index.ThreadStream(transport, options);
+	}
+};
+//#endregion
+exports.ThreadsClient = ThreadsClient;
+
+//# sourceMappingURL=index.cjs.map

package/dist/client/threads/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["BaseClient","ProtocolWebSocketTransportAdapter","ProtocolSseTransportAdapter","ThreadStream"],"sources":["../../../src/client/threads/index.ts"],"sourcesContent":["import { v7 as uuidv7 } from \"uuid\";\n\nimport {\n  Checkpoint,\n  Config,\n  DefaultValues,\n  Metadata,\n  SortOrder,\n  Thread,\n  ThreadSelectField,\n  ThreadSortBy,\n  ThreadState,\n  ThreadStatus,\n  ThreadValuesFilter,\n} from \"../../schema.js\";\nimport type { Command, OnConflictBehavior, StreamEvent } from \"../../types.js\";\nimport type { ThreadStreamMode } from \"../../types.stream.js\";\nimport { BaseClient } from \"../base.js\";\nimport { ThreadStream } from \"../stream/index.js\";\nimport type {\n  ThreadStreamOptions,\n  ThreadStreamTransportKind,\n} from \"../stream/types.js\";\nimport { ProtocolSseTransportAdapter } from \"../stream/transport/http.js\";\nimport { ProtocolWebSocketTransportAdapter } from \"../stream/transport/websocket.js\";\nimport type { TransportAdapter } from \"../stream/transport.js\";\n\nexport class ThreadsClient<\n  TStateType = DefaultValues,\n  TUpdateType = TStateType,\n> extends BaseClient {\n  /**\n   * Get a thread by ID.\n   *\n   * @param threadId ID of the thread.\n   * @returns The thread.\n   */\n  async get<ValuesType = TStateType>(\n    threadId: string,\n    options?: { signal?: AbortSignal; include?: string[] }\n  ): Promise<Thread<ValuesType>> {\n    return this.fetch<Thread<ValuesType>>(`/threads/${threadId}`, {\n      params: {\n        include: options?.include ?? undefined,\n      },\n      signal: options?.signal,\n    });\n  }\n\n  /**\n   * Create a new thread.\n   *\n   * @param payload Payload for creating a thread.\n   * @returns The created thread.\n   */\n  async create(payload?: {\n    metadata?: Metadata;\n    threadId?: string;\n    ifExists?: OnConflictBehavior;\n    graphId?: string;\n    supersteps?: Array<{\n      updates: Array<{ values: unknown; command?: Command; asNode: string }>;\n    }>;\n    ttl?: number | { ttl: number; strategy?: \"delete\" };\n    signal?: AbortSignal;\n  }): Promise<Thread<TStateType>> {\n    const ttlPayload =\n      typeof payload?.ttl === \"number\"\n        ? { ttl: payload.ttl, strategy: \"delete\" as const }\n        : payload?.ttl;\n\n    return this.fetch<Thread<TStateType>>(`/threads`, {\n      method: \"POST\",\n      json: {\n        metadata: {\n          ...payload?.metadata,\n          graph_id: payload?.graphId,\n        },\n        thread_id: payload?.threadId,\n        if_exists: payload?.ifExists,\n        supersteps: payload?.supersteps?.map((s) => ({\n          updates: s.updates.map((u) => ({\n            values: u.values,\n            command: u.command,\n            as_node: u.asNode,\n          })),\n        })),\n        ttl: ttlPayload,\n      },\n      signal: payload?.signal,\n    });\n  }\n\n  /**\n   * Copy an existing thread\n   * @param threadId ID of the thread to be copied\n   * @returns Newly copied thread\n   */\n  async copy(\n    threadId: string,\n    options?: { signal?: AbortSignal }\n  ): Promise<Thread<TStateType>> {\n    return this.fetch<Thread<TStateType>>(`/threads/${threadId}/copy`, {\n      method: \"POST\",\n      signal: options?.signal,\n    });\n  }\n\n  /**\n   * Update a thread.\n   *\n   * @param threadId ID of the thread.\n   * @param payload Payload for updating the thread.\n   * @returns The updated thread.\n   */\n  async update(\n    threadId: string,\n    payload?: {\n      metadata?: Metadata;\n      ttl?: number | { ttl: number; strategy?: \"delete\" };\n      returnMinimal?: false;\n      signal?: AbortSignal;\n    }\n  ): Promise<Thread>;\n  async update(\n    threadId: string,\n    payload: {\n      metadata?: Metadata;\n      ttl?: number | { ttl: number; strategy?: \"delete\" };\n      returnMinimal: true;\n      signal?: AbortSignal;\n    }\n  ): Promise<void>;\n  async update(\n    threadId: string,\n    payload: {\n      metadata?: Metadata;\n      ttl?: number | { ttl: number; strategy?: \"delete\" };\n      returnMinimal: boolean;\n      signal?: AbortSignal;\n    }\n  ): Promise<Thread | void>;\n  async update(\n    threadId: string,\n    payload?: {\n      metadata?: Metadata;\n      ttl?: number | { ttl: number; strategy?: \"delete\" };\n      returnMinimal?: boolean;\n      signal?: AbortSignal;\n    }\n  ): Promise<Thread | void> {\n    const ttlPayload =\n      typeof payload?.ttl === \"number\"\n        ? { ttl: payload.ttl, strategy: \"delete\" as const }\n        : payload?.ttl;\n\n    return this.fetch<Thread | void>(`/threads/${threadId}`, {\n      method: \"PATCH\",\n      headers: payload?.returnMinimal\n        ? { Prefer: \"return=minimal\" }\n        : undefined,\n      json: { metadata: payload?.metadata, ttl: ttlPayload },\n      signal: payload?.signal,\n    });\n  }\n\n  /**\n   * Delete a thread.\n   *\n   * @param threadId ID of the thread.\n   */\n  async delete(\n    threadId: string,\n    options?: { signal?: AbortSignal }\n  ): Promise<void> {\n    return this.fetch<void>(`/threads/${threadId}`, {\n      method: \"DELETE\",\n      signal: options?.signal,\n    });\n  }\n\n  /**\n   * Prune threads by ID. The 'delete' strategy removes threads entirely.\n   * The 'keep_latest' strategy prunes old checkpoints but keeps threads\n   * and their latest state.\n   *\n   * @param threadIds List of thread IDs to prune.\n   * @param options Additional options for pruning.\n   * @param options.strategy The prune strategy. Defaults to 'delete'.\n   * @param options.signal Signal to abort the request.\n   * @returns An object containing `pruned_count`.\n   */\n  async prune(\n    threadIds: string[],\n    options?: {\n      strategy?: \"delete\" | \"keep_latest\";\n      signal?: AbortSignal;\n    }\n  ): Promise<{ pruned_count: number }> {\n    return this.fetch<{ pruned_count: number }>(\"/threads/prune\", {\n      method: \"POST\",\n      json: {\n        thread_ids: threadIds,\n        strategy: options?.strategy ?? \"delete\",\n      },\n      signal: options?.signal,\n    });\n  }\n\n  /**\n   * List threads\n   *\n   * @param query Query options\n   * @returns List of threads\n   */\n  async search<ValuesType = TStateType>(query?: {\n    metadata?: Metadata;\n    ids?: string[];\n    limit?: number;\n    offset?: number;\n    status?: ThreadStatus;\n    sortBy?: ThreadSortBy;\n    sortOrder?: SortOrder;\n    select?: ThreadSelectField[];\n    values?: ThreadValuesFilter;\n    extract?: Record<string, string>;\n    signal?: AbortSignal;\n  }): Promise<Thread<ValuesType>[]> {\n    return this.fetch<Thread<ValuesType>[]>(\"/threads/search\", {\n      method: \"POST\",\n      json: {\n        metadata: query?.metadata ?? undefined,\n        ids: query?.ids ?? undefined,\n        limit: query?.limit ?? 10,\n        offset: query?.offset ?? 0,\n        status: query?.status,\n        sort_by: query?.sortBy,\n        sort_order: query?.sortOrder,\n        select: query?.select ?? undefined,\n        values: query?.values ?? undefined,\n        extract: query?.extract ?? undefined,\n      },\n      signal: query?.signal,\n    });\n  }\n\n  /**\n   * Count threads matching filters.\n   *\n   * @param query.metadata Thread metadata to filter on.\n   * @param query.values State values to filter on.\n   * @param query.status Thread status to filter on.\n   * @returns Number of threads matching the criteria.\n   */\n  async count<ValuesType = TStateType>(query?: {\n    metadata?: Metadata;\n    values?: ValuesType;\n    status?: ThreadStatus;\n    signal?: AbortSignal;\n  }): Promise<number> {\n    return this.fetch<number>(`/threads/count`, {\n      method: \"POST\",\n      json: {\n        metadata: query?.metadata ?? undefined,\n        values: query?.values ?? undefined,\n        status: query?.status ?? undefined,\n      },\n      signal: query?.signal,\n    });\n  }\n\n  /**\n   * Get state for a thread.\n   *\n   * @param threadId ID of the thread.\n   * @returns Thread state.\n   */\n  async getState<ValuesType = TStateType>(\n    threadId: string,\n    checkpoint?: Checkpoint | string,\n    options?: { subgraphs?: boolean; signal?: AbortSignal }\n  ): Promise<ThreadState<ValuesType>> {\n    if (checkpoint != null) {\n      if (typeof checkpoint !== \"string\") {\n        return this.fetch<ThreadState<ValuesType>>(\n          `/threads/${threadId}/state/checkpoint`,\n          {\n            method: \"POST\",\n            json: { checkpoint, subgraphs: options?.subgraphs },\n            signal: options?.signal,\n          }\n        );\n      }\n\n      // deprecated\n      return this.fetch<ThreadState<ValuesType>>(\n        `/threads/${threadId}/state/${checkpoint}`,\n        { params: { subgraphs: options?.subgraphs }, signal: options?.signal }\n      );\n    }\n\n    return this.fetch<ThreadState<ValuesType>>(`/threads/${threadId}/state`, {\n      params: { subgraphs: options?.subgraphs },\n      signal: options?.signal,\n    });\n  }\n\n  /**\n   * Add state to a thread.\n   *\n   * @param threadId The ID of the thread.\n   * @returns\n   */\n  async updateState<ValuesType = TUpdateType>(\n    threadId: string,\n    options: {\n      values: ValuesType;\n      checkpoint?: Checkpoint;\n      checkpointId?: string;\n      asNode?: string;\n      signal?: AbortSignal;\n    }\n  ): Promise<Pick<Config, \"configurable\">> {\n    return this.fetch<Pick<Config, \"configurable\">>(\n      `/threads/${threadId}/state`,\n      {\n        method: \"POST\",\n        json: {\n          values: options.values,\n          checkpoint: options.checkpoint,\n          checkpoint_id: options.checkpointId,\n          as_node: options?.asNode,\n        },\n        signal: options?.signal,\n      }\n    );\n  }\n\n  /**\n   * Patch the metadata of a thread.\n   *\n   * @param threadIdOrConfig Thread ID or config to patch the state of.\n   * @param metadata Metadata to patch the state with.\n   */\n  async patchState(\n    threadIdOrConfig: string | Config,\n    metadata: Metadata,\n    options?: { signal?: AbortSignal }\n  ): Promise<void> {\n    let threadId: string;\n\n    if (typeof threadIdOrConfig !== \"string\") {\n      if (typeof threadIdOrConfig.configurable?.thread_id !== \"string\") {\n        throw new Error(\n          \"Thread ID is required when updating state with a config.\"\n        );\n      }\n      threadId = threadIdOrConfig.configurable.thread_id;\n    } else {\n      threadId = threadIdOrConfig;\n    }\n\n    return this.fetch<void>(`/threads/${threadId}/state`, {\n      method: \"PATCH\",\n      json: { metadata },\n      signal: options?.signal,\n    });\n  }\n\n  /**\n   * Get all past states for a thread.\n   *\n   * @param threadId ID of the thread.\n   * @param options Additional options.\n   * @returns List of thread states.\n   */\n  async getHistory<ValuesType = TStateType>(\n    threadId: string,\n    options?: {\n      limit?: number;\n      before?: Config;\n      checkpoint?: Partial<Omit<Checkpoint, \"thread_id\">>;\n      metadata?: Metadata;\n      signal?: AbortSignal;\n    }\n  ): Promise<ThreadState<ValuesType>[]> {\n    return this.fetch<ThreadState<ValuesType>[]>(\n      `/threads/${threadId}/history`,\n      {\n        method: \"POST\",\n        json: {\n          limit: options?.limit ?? 10,\n          before: options?.before,\n          metadata: options?.metadata,\n          checkpoint: options?.checkpoint,\n        },\n        signal: options?.signal,\n      }\n    );\n  }\n\n  async *joinStream(\n    threadId: string,\n    options?: {\n      lastEventId?: string;\n      streamMode?: ThreadStreamMode | ThreadStreamMode[];\n      signal?: AbortSignal;\n    }\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ): AsyncGenerator<{ id?: string; event: StreamEvent; data: any }> {\n    yield* this.streamWithRetry({\n      endpoint: `/threads/${threadId}/stream`,\n      method: \"GET\",\n      signal: options?.signal,\n      headers: options?.lastEventId\n        ? { \"Last-Event-ID\": options.lastEventId }\n        : undefined,\n      params: options?.streamMode\n        ? { stream_mode: options.streamMode }\n        : undefined,\n    });\n  }\n\n  /**\n   * Open a protocol stream over the thread-centric v2 protocol.\n   *\n   * Returns a {@link ThreadStream} with lazy getters\n   * (`.messages`, `.values`, `.toolCalls`, `.subgraphs`, `.subagents`,\n   * `.output`) and `thread.run.start({ input, ... })` for starting runs.\n   * Mirrors the in-process `graph.streamEvents(..., { version: \"v3\" })` API.\n   *\n   * The thread is bound to `options.assistantId` for its lifetime.\n   * The wire transport defaults to SSE; pass `transport: \"websocket\"`\n   * in options (or configure `streamProtocol: \"v2-websocket\"` on the\n   * client) to use a WebSocket instead.\n   *\n   * @example New thread (UUID generated client-side)\n   * ```ts\n   * const thread = client.threads.stream({ assistantId: \"my-agent\" });\n   * ```\n   *\n   * @example Attach to an existing thread\n   * ```ts\n   * const thread = client.threads.stream(threadId, { assistantId: \"my-agent\" });\n   * ```\n   *\n   * @example WebSocket transport\n   * ```ts\n   * const thread = client.threads.stream({\n   *   assistantId: \"my-agent\",\n   *   transport: \"websocket\",\n   * });\n   * ```\n   */\n  stream<TExtensions extends Record<string, unknown> = Record<string, unknown>>(\n    options: ThreadStreamOptions\n  ): ThreadStream<TExtensions>;\n  stream<TExtensions extends Record<string, unknown> = Record<string, unknown>>(\n    threadId: string,\n    options: ThreadStreamOptions\n  ): ThreadStream<TExtensions>;\n  stream<TExtensions extends Record<string, unknown> = Record<string, unknown>>(\n    threadIdOrOptions: string | ThreadStreamOptions,\n    maybeOptions?: ThreadStreamOptions\n  ): ThreadStream<TExtensions> {\n    const { threadId, options } =\n      typeof threadIdOrOptions === \"string\"\n        ? {\n            threadId: threadIdOrOptions,\n            options: maybeOptions as ThreadStreamOptions,\n          }\n        : { threadId: uuidv7(), options: threadIdOrOptions };\n\n    // `transport` accepts either a preset string (`\"sse\"` / `\"websocket\"`)\n    // or a custom {@link AgentServerAdapter}. A custom adapter replaces\n    // the built-in factories entirely — this is the seam that lets users\n    // point `useStream` at any agent server (including the thin wrappers\n    // produced by `HttpAgentServerAdapter`).\n    let transport: TransportAdapter;\n    if (options.transport != null && typeof options.transport !== \"string\") {\n      transport = options.transport;\n    } else {\n      const transportKind: ThreadStreamTransportKind =\n        options.transport ??\n        (this.streamProtocol === \"v2-websocket\" ? \"websocket\" : \"sse\");\n      transport =\n        transportKind === \"websocket\"\n          ? new ProtocolWebSocketTransportAdapter({\n              apiUrl: this.apiUrl,\n              threadId,\n              defaultHeaders: this.defaultHeaders,\n              onRequest: this.onRequest,\n              webSocketFactory: options.webSocketFactory,\n            })\n          : new ProtocolSseTransportAdapter({\n              apiUrl: this.apiUrl,\n              threadId,\n              defaultHeaders: this.defaultHeaders,\n              onRequest: this.onRequest,\n              fetch: options.fetch,\n            });\n    }\n\n    return new ThreadStream<TExtensions>(transport, options);\n  }\n}\n"],"mappings":"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"}

package/dist/client/threads/index.d.cts

@@ -0,0 +1,235 @@
+import { Checkpoint, Config, DefaultValues, Metadata, SortOrder, Thread, ThreadSelectField, ThreadSortBy, ThreadState, ThreadStatus, ThreadValuesFilter } from "../../schema.cjs";
+import { ThreadStreamMode } from "../../types.stream.cjs";
+import { Command, OnConflictBehavior, StreamEvent } from "../../types.cjs";
+import { BaseClient } from "../base.cjs";
+import { ThreadStreamOptions } from "../stream/types.cjs";
+import { ThreadStream } from "../stream/index.cjs";
+
+//#region src/client/threads/index.d.ts
+declare class ThreadsClient<TStateType = DefaultValues, TUpdateType = TStateType> extends BaseClient {
+  /**
+   * Get a thread by ID.
+   *
+   * @param threadId ID of the thread.
+   * @returns The thread.
+   */
+  get<ValuesType = TStateType>(threadId: string, options?: {
+    signal?: AbortSignal;
+    include?: string[];
+  }): Promise<Thread<ValuesType>>;
+  /**
+   * Create a new thread.
+   *
+   * @param payload Payload for creating a thread.
+   * @returns The created thread.
+   */
+  create(payload?: {
+    metadata?: Metadata;
+    threadId?: string;
+    ifExists?: OnConflictBehavior;
+    graphId?: string;
+    supersteps?: Array<{
+      updates: Array<{
+        values: unknown;
+        command?: Command;
+        asNode: string;
+      }>;
+    }>;
+    ttl?: number | {
+      ttl: number;
+      strategy?: "delete";
+    };
+    signal?: AbortSignal;
+  }): Promise<Thread<TStateType>>;
+  /**
+   * Copy an existing thread
+   * @param threadId ID of the thread to be copied
+   * @returns Newly copied thread
+   */
+  copy(threadId: string, options?: {
+    signal?: AbortSignal;
+  }): Promise<Thread<TStateType>>;
+  /**
+   * Update a thread.
+   *
+   * @param threadId ID of the thread.
+   * @param payload Payload for updating the thread.
+   * @returns The updated thread.
+   */
+  update(threadId: string, payload?: {
+    metadata?: Metadata;
+    ttl?: number | {
+      ttl: number;
+      strategy?: "delete";
+    };
+    returnMinimal?: false;
+    signal?: AbortSignal;
+  }): Promise<Thread>;
+  update(threadId: string, payload: {
+    metadata?: Metadata;
+    ttl?: number | {
+      ttl: number;
+      strategy?: "delete";
+    };
+    returnMinimal: true;
+    signal?: AbortSignal;
+  }): Promise<void>;
+  update(threadId: string, payload: {
+    metadata?: Metadata;
+    ttl?: number | {
+      ttl: number;
+      strategy?: "delete";
+    };
+    returnMinimal: boolean;
+    signal?: AbortSignal;
+  }): Promise<Thread | void>;
+  /**
+   * Delete a thread.
+   *
+   * @param threadId ID of the thread.
+   */
+  delete(threadId: string, options?: {
+    signal?: AbortSignal;
+  }): Promise<void>;
+  /**
+   * Prune threads by ID. The 'delete' strategy removes threads entirely.
+   * The 'keep_latest' strategy prunes old checkpoints but keeps threads
+   * and their latest state.
+   *
+   * @param threadIds List of thread IDs to prune.
+   * @param options Additional options for pruning.
+   * @param options.strategy The prune strategy. Defaults to 'delete'.
+   * @param options.signal Signal to abort the request.
+   * @returns An object containing `pruned_count`.
+   */
+  prune(threadIds: string[], options?: {
+    strategy?: "delete" | "keep_latest";
+    signal?: AbortSignal;
+  }): Promise<{
+    pruned_count: number;
+  }>;
+  /**
+   * List threads
+   *
+   * @param query Query options
+   * @returns List of threads
+   */
+  search<ValuesType = TStateType>(query?: {
+    metadata?: Metadata;
+    ids?: string[];
+    limit?: number;
+    offset?: number;
+    status?: ThreadStatus;
+    sortBy?: ThreadSortBy;
+    sortOrder?: SortOrder;
+    select?: ThreadSelectField[];
+    values?: ThreadValuesFilter;
+    extract?: Record<string, string>;
+    signal?: AbortSignal;
+  }): Promise<Thread<ValuesType>[]>;
+  /**
+   * Count threads matching filters.
+   *
+   * @param query.metadata Thread metadata to filter on.
+   * @param query.values State values to filter on.
+   * @param query.status Thread status to filter on.
+   * @returns Number of threads matching the criteria.
+   */
+  count<ValuesType = TStateType>(query?: {
+    metadata?: Metadata;
+    values?: ValuesType;
+    status?: ThreadStatus;
+    signal?: AbortSignal;
+  }): Promise<number>;
+  /**
+   * Get state for a thread.
+   *
+   * @param threadId ID of the thread.
+   * @returns Thread state.
+   */
+  getState<ValuesType = TStateType>(threadId: string, checkpoint?: Checkpoint | string, options?: {
+    subgraphs?: boolean;
+    signal?: AbortSignal;
+  }): Promise<ThreadState<ValuesType>>;
+  /**
+   * Add state to a thread.
+   *
+   * @param threadId The ID of the thread.
+   * @returns
+   */
+  updateState<ValuesType = TUpdateType>(threadId: string, options: {
+    values: ValuesType;
+    checkpoint?: Checkpoint;
+    checkpointId?: string;
+    asNode?: string;
+    signal?: AbortSignal;
+  }): Promise<Pick<Config, "configurable">>;
+  /**
+   * Patch the metadata of a thread.
+   *
+   * @param threadIdOrConfig Thread ID or config to patch the state of.
+   * @param metadata Metadata to patch the state with.
+   */
+  patchState(threadIdOrConfig: string | Config, metadata: Metadata, options?: {
+    signal?: AbortSignal;
+  }): Promise<void>;
+  /**
+   * Get all past states for a thread.
+   *
+   * @param threadId ID of the thread.
+   * @param options Additional options.
+   * @returns List of thread states.
+   */
+  getHistory<ValuesType = TStateType>(threadId: string, options?: {
+    limit?: number;
+    before?: Config;
+    checkpoint?: Partial<Omit<Checkpoint, "thread_id">>;
+    metadata?: Metadata;
+    signal?: AbortSignal;
+  }): Promise<ThreadState<ValuesType>[]>;
+  joinStream(threadId: string, options?: {
+    lastEventId?: string;
+    streamMode?: ThreadStreamMode | ThreadStreamMode[];
+    signal?: AbortSignal;
+  }): AsyncGenerator<{
+    id?: string;
+    event: StreamEvent;
+    data: any;
+  }>;
+  /**
+   * Open a protocol stream over the thread-centric v2 protocol.
+   *
+   * Returns a {@link ThreadStream} with lazy getters
+   * (`.messages`, `.values`, `.toolCalls`, `.subgraphs`, `.subagents`,
+   * `.output`) and `thread.run.start({ input, ... })` for starting runs.
+   * Mirrors the in-process `graph.streamEvents(..., { version: "v3" })` API.
+   *
+   * The thread is bound to `options.assistantId` for its lifetime.
+   * The wire transport defaults to SSE; pass `transport: "websocket"`
+   * in options (or configure `streamProtocol: "v2-websocket"` on the
+   * client) to use a WebSocket instead.
+   *
+   * @example New thread (UUID generated client-side)
+   * ```ts
+   * const thread = client.threads.stream({ assistantId: "my-agent" });
+   * ```
+   *
+   * @example Attach to an existing thread
+   * ```ts
+   * const thread = client.threads.stream(threadId, { assistantId: "my-agent" });
+   * ```
+   *
+   * @example WebSocket transport
+   * ```ts
+   * const thread = client.threads.stream({
+   *   assistantId: "my-agent",
+   *   transport: "websocket",
+   * });
+   * ```
+   */
+  stream<TExtensions extends Record<string, unknown> = Record<string, unknown>>(options: ThreadStreamOptions): ThreadStream<TExtensions>;
+  stream<TExtensions extends Record<string, unknown> = Record<string, unknown>>(threadId: string, options: ThreadStreamOptions): ThreadStream<TExtensions>;
+}
+//#endregion
+export { ThreadsClient };
+//# sourceMappingURL=index.d.cts.map

package/dist/client/threads/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/client/threads/index.ts"],"mappings":";;;;;;;;cA2Ba,aAAA,cACE,aAAA,gBACC,UAAA,UACN,UAAA;;AAHV;;;;;EAUQ,GAAA,cAAiB,UAAA,CAAA,CACrB,QAAA,UACA,OAAA;IAAY,MAAA,GAAS,WAAA;IAAa,OAAA;EAAA,IACjC,OAAA,CAAQ,MAAA,CAAO,UAAA;EAAf;;;;;;EAeG,MAAA,CAAO,OAAA;IACX,QAAA,GAAW,QAAA;IACX,QAAA;IACA,QAAA,GAAW,kBAAA;IACX,OAAA;IACA,UAAA,GAAa,KAAA;MACX,OAAA,EAAS,KAAA;QAAQ,MAAA;QAAiB,OAAA,GAAU,OAAA;QAAS,MAAA;MAAA;IAAA;IAEvD,GAAA;MAAiB,GAAA;MAAa,QAAA;IAAA;IAC9B,MAAA,GAAS,WAAA;EAAA,IACP,OAAA,CAAQ,MAAA,CAAO,UAAA;EA4EhB;;;;;EA3CG,IAAA,CACJ,QAAA,UACA,OAAA;IAAY,MAAA,GAAS,WAAA;EAAA,IACpB,OAAA,CAAQ,MAAA,CAAO,UAAA;EAwHP;;;;;;;EA1GL,MAAA,CACJ,QAAA,UACA,OAAA;IACE,QAAA,GAAW,QAAA;IACX,GAAA;MAAiB,GAAA;MAAa,QAAA;IAAA;IAC9B,aAAA;IACA,MAAA,GAAS,WAAA;EAAA,IAEV,OAAA,CAAQ,MAAA;EACL,MAAA,CACJ,QAAA,UACA,OAAA;IACE,QAAA,GAAW,QAAA;IACX,GAAA;MAAiB,GAAA;MAAa,QAAA;IAAA;IAC9B,aAAA;IACA,MAAA,GAAS,WAAA;EAAA,IAEV,OAAA;EACG,MAAA,CACJ,QAAA,UACA,OAAA;IACE,QAAA,GAAW,QAAA;IACX,GAAA;MAAiB,GAAA;MAAa,QAAA;IAAA;IAC9B,aAAA;IACA,MAAA,GAAS,WAAA;EAAA,IAEV,OAAA,CAAQ,MAAA;EAgPmB;;;;;EAlNxB,MAAA,CACJ,QAAA,UACA,OAAA;IAAY,MAAA,GAAS,WAAA;EAAA,IACpB,OAAA;EAuOc;;;;;;;;;;;EArNX,KAAA,CACJ,SAAA,YACA,OAAA;IACE,QAAA;IACA,MAAA,GAAS,WAAA;EAAA,IAEV,OAAA;IAAU,YAAA;EAAA;EAxKK;;;;;;EAyLZ,MAAA,cAAoB,UAAA,CAAA,CAAY,KAAA;IACpC,QAAA,GAAW,QAAA;IACX,GAAA;IACA,KAAA;IACA,MAAA;IACA,MAAA,GAAS,YAAA;IACT,MAAA,GAAS,YAAA;IACT,SAAA,GAAY,SAAA;IACZ,MAAA,GAAS,iBAAA;IACT,MAAA,GAAS,kBAAA;IACT,OAAA,GAAU,MAAA;IACV,MAAA,GAAS,WAAA;EAAA,IACP,OAAA,CAAQ,MAAA,CAAO,UAAA;EA3KN;;;;;;;;EAsMP,KAAA,cAAmB,UAAA,CAAA,CAAY,KAAA;IACnC,QAAA,GAAW,QAAA;IACX,MAAA,GAAS,UAAA;IACT,MAAA,GAAS,YAAA;IACT,MAAA,GAAS,WAAA;EAAA,IACP,OAAA;EApMe;;;;;;EAsNb,QAAA,cAAsB,UAAA,CAAA,CAC1B,QAAA,UACA,UAAA,GAAa,UAAA,WACb,OAAA;IAAY,SAAA;IAAqB,MAAA,GAAS,WAAA;EAAA,IACzC,OAAA,CAAQ,WAAA,CAAY,UAAA;EArLT;;;;;;EAqNR,WAAA,cAAyB,WAAA,CAAA,CAC7B,QAAA,UACA,OAAA;IACE,MAAA,EAAQ,UAAA;IACR,UAAA,GAAa,UAAA;IACb,YAAA;IACA,MAAA;IACA,MAAA,GAAS,WAAA;EAAA,IAEV,OAAA,CAAQ,IAAA,CAAK,MAAA;EA1MZ;;;;;;EAgOE,UAAA,CACJ,gBAAA,WAA2B,MAAA,EAC3B,QAAA,EAAU,QAAA,EACV,OAAA;IAAY,MAAA,GAAS,WAAA;EAAA,IACpB,OAAA;EA7NY;;;;;;;EAyPT,UAAA,cAAwB,UAAA,CAAA,CAC5B,QAAA,UACA,OAAA;IACE,KAAA;IACA,MAAA,GAAS,MAAA;IACT,UAAA,GAAa,OAAA,CAAQ,IAAA,CAAK,UAAA;IAC1B,QAAA,GAAW,QAAA;IACX,MAAA,GAAS,WAAA;EAAA,IAEV,OAAA,CAAQ,WAAA,CAAY,UAAA;EAgBhB,UAAA,CACL,QAAA,UACA,OAAA;IACE,WAAA;IACA,UAAA,GAAa,gBAAA,GAAmB,gBAAA;IAChC,MAAA,GAAS,WAAA;EAAA,IAGV,cAAA;IAAiB,EAAA;IAAa,KAAA,EAAO,WAAA;IAAa,IAAA;EAAA;EA7OnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0RF,MAAA,qBAA2B,MAAA,oBAA0B,MAAA,kBAAA,CACnD,OAAA,EAAS,mBAAA,GACR,YAAA,CAAa,WAAA;EAChB,MAAA,qBAA2B,MAAA,oBAA0B,MAAA,kBAAA,CACnD,QAAA,UACA,OAAA,EAAS,mBAAA,GACR,YAAA,CAAa,WAAA;AAAA"}