@langgraph-js/pure-graph 2.8.1 → 3.0.0

package/dist/remote-threads-CrG03ZS7.js

@@ -0,0 +1,255 @@
+var RemoteErrorCode = /* @__PURE__ */ ((RemoteErrorCode2) => {
+  RemoteErrorCode2["NETWORK_ERROR"] = "NETWORK_ERROR";
+  RemoteErrorCode2["CONNECTION_TIMEOUT"] = "CONNECTION_TIMEOUT";
+  RemoteErrorCode2["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+  RemoteErrorCode2["THREAD_NOT_FOUND"] = "THREAD_NOT_FOUND";
+  RemoteErrorCode2["THREAD_BUSY"] = "THREAD_BUSY";
+  RemoteErrorCode2["RUN_NOT_FOUND"] = "RUN_NOT_FOUND";
+  RemoteErrorCode2["GRAPH_NOT_FOUND"] = "GRAPH_NOT_FOUND";
+  RemoteErrorCode2["INVALID_REQUEST"] = "INVALID_REQUEST";
+  return RemoteErrorCode2;
+})(RemoteErrorCode || {});
+class RemoteApiError extends Error {
+  constructor(code, message, statusCode) {
+    super(message);
+    this.code = code;
+    this.statusCode = statusCode;
+    this.name = "RemoteApiError";
+  }
+}
+
+async function request(url, method, options) {
+  try {
+    let requestUrl = url;
+    if (options?.query) {
+      const searchParams = new URLSearchParams();
+      Object.entries(options.query).forEach(([key, value]) => {
+        searchParams.append(key, String(value));
+      });
+      requestUrl += `?${searchParams.toString()}`;
+    }
+    const response = await fetch(requestUrl, {
+      method,
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: options?.body ? JSON.stringify(options.body) : void 0
+    });
+    const data = await response.json();
+    if (!response.ok || !data.success) {
+      throw new RemoteApiError(
+        data.error?.code || RemoteErrorCode.INTERNAL_ERROR,
+        data.error?.message || "Unknown error",
+        response.status
+      );
+    }
+    return data;
+  } catch (error) {
+    if (error instanceof RemoteApiError) {
+      throw error;
+    }
+    throw new RemoteApiError(
+      RemoteErrorCode.NETWORK_ERROR,
+      `Network error: ${error instanceof Error ? error.message : "Unknown error"}`
+    );
+  }
+}
+async function remoteGet(url, query) {
+  return request(url, "GET", { query });
+}
+async function remotePost(url, body, query) {
+  return request(url, "POST", { body, query });
+}
+async function remotePut(url, body, query) {
+  return request(url, "PUT", { body, query });
+}
+async function remoteDelete(url, query) {
+  return request(url, "DELETE", { query });
+}
+
+class RemoteKyselyThreadsManager {
+  constructor(serverUrl, httpClient) {
+    this.serverUrl = serverUrl;
+    this.httpClient = httpClient;
+    this.serverUrl = serverUrl.replace(/\/$/, "");
+    this.httpClient = httpClient || fetch;
+  }
+  /**
+   * 初始化数据库
+   */
+  async setup() {
+    await remotePost(`${this.serverUrl}/setup`);
+  }
+  /**
+   * 创建线程
+   */
+  async create(payload) {
+    const response = await remotePost(`${this.serverUrl}/threads`, payload);
+    return response.data;
+  }
+  /**
+   * 搜索线程
+   */
+  async search(query) {
+    const params = {};
+    if (query?.ids !== void 0 && query.ids.length > 0) {
+      params.ids = JSON.stringify(query.ids);
+    }
+    if (query?.metadata !== void 0) {
+      params.metadata = JSON.stringify(query.metadata);
+    }
+    if (query?.limit !== void 0) {
+      params.limit = query.limit;
+    }
+    if (query?.offset !== void 0) {
+      params.offset = query.offset;
+    }
+    if (query?.status !== void 0) {
+      params.status = query.status;
+    }
+    if (query?.sortBy !== void 0) {
+      params.sortBy = query.sortBy;
+    }
+    if (query?.sortOrder !== void 0) {
+      params.sortOrder = query.sortOrder;
+    }
+    if (query?.values !== void 0) {
+      params.values = JSON.stringify(query.values);
+    }
+    if (query?.select !== void 0) {
+      params.select = JSON.stringify(query.select);
+    }
+    if (query?.withoutDetails !== void 0) {
+      params.withoutDetails = query.withoutDetails;
+    }
+    const response = await remoteGet(`${this.serverUrl}/threads`, params);
+    return response.data;
+  }
+  /**
+   * 获取线程
+   */
+  async get(threadId) {
+    const response = await remoteGet(`${this.serverUrl}/threads/${threadId}`);
+    return response.data;
+  }
+  /**
+   * 更新线程
+   */
+  async set(threadId, thread) {
+    await remotePut(`${this.serverUrl}/threads/${threadId}`, thread);
+  }
+  /**
+   * 删除线程
+   */
+  async delete(threadId) {
+    await remoteDelete(`${this.serverUrl}/threads/${threadId}`);
+  }
+  /**
+   * 更新状态
+   */
+  async updateState(threadId, thread) {
+    const response = await remotePost(
+      `${this.serverUrl}/threads/${threadId}/state`,
+      thread
+    );
+    return response.data;
+  }
+  /**
+   * 创建运行
+   */
+  async createRun(threadId, assistantId, payload) {
+    const response = await remotePost(`${this.serverUrl}/threads/${threadId}/runs`, payload || {}, {
+      assistantId
+    });
+    return response.data;
+  }
+  /**
+   * 列出运行
+   */
+  async listRuns(threadId, options) {
+    const params = {};
+    if (options?.limit !== void 0) {
+      params.limit = options.limit;
+    }
+    if (options?.offset !== void 0) {
+      params.offset = options.offset;
+    }
+    if (options?.status !== void 0) {
+      params.status = options.status;
+    }
+    const response = await remoteGet(`${this.serverUrl}/threads/${threadId}/runs`, params);
+    return response.data;
+  }
+  /**
+   * 更新运行
+   */
+  async updateRun(runId, run) {
+    await remotePut(`${this.serverUrl}/runs/${runId}`, run);
+  }
+  // New methods for Threads API
+  /**
+   * 计算线程数量
+   */
+  async count(query) {
+    const params = {};
+    if (query?.ids !== void 0 && query.ids.length > 0) {
+      params.ids = JSON.stringify(query.ids);
+    }
+    if (query?.metadata !== void 0) {
+      params.metadata = JSON.stringify(query.metadata);
+    }
+    if (query?.status !== void 0) {
+      params.status = query.status;
+    }
+    if (query?.values !== void 0) {
+      params.values = JSON.stringify(query.values);
+    }
+    const response = await remoteGet(`${this.serverUrl}/threads/count`, params);
+    return response.data;
+  }
+  /**
+   * 更新线程元数据
+   */
+  async patch(threadId, updates) {
+    const response = await remotePost(`${this.serverUrl}/threads/${threadId}`, updates);
+    return response.data;
+  }
+  /**
+   * 获取线程状态
+   */
+  async getState(threadId, options) {
+    const params = {};
+    if (options?.subgraphs !== void 0) {
+      params.subgraphs = options.subgraphs;
+    }
+    if (options?.checkpointId !== void 0) {
+      params.checkpointId = options.checkpointId;
+    }
+    const response = await remotePost(`${this.serverUrl}/threads/${threadId}/state`, params);
+    return response.data;
+  }
+  /**
+   * 获取线程历史
+   */
+  async getStateHistory(threadId, options) {
+    const params = {};
+    if (options?.limit !== void 0) {
+      params.limit = options.limit;
+    }
+    if (options?.before !== void 0) {
+      params.before = options.before;
+    }
+    const response = await remotePost(`${this.serverUrl}/threads/${threadId}/history`, params);
+    return response.data;
+  }
+  /**
+   * 复制线程
+   */
+  async copy(threadId) {
+    const response = await remotePost(`${this.serverUrl}/threads/${threadId}/copy`);
+    return response.data;
+  }
+}
+
+export { RemoteKyselyThreadsManager };
+//# sourceMappingURL=remote-threads-CrG03ZS7.js.map

package/dist/remote-threads-CrG03ZS7.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-threads-CrG03ZS7.js","sources":["../src/storage/remote/types.ts","../src/storage/remote/fetch.ts","../src/storage/kysely/remote-threads.ts"],"sourcesContent":["/**\n * Remote PostgreSQL Adapter 类型定义\n * 定义 API 请求/响应格式和错误类型\n */\n\nimport { Metadata, OnConflictBehavior, Run, Thread, ThreadStatus, Command } from '@langgraph-js/sdk';\nimport { RunStatus, SortOrder, ThreadSortBy } from '../../types';\n\n/**\n * API 响应通用格式\n */\nexport interface RemoteResponse<T = any> {\n    success: boolean;\n    data?: T;\n    error?: {\n        code: string;\n        message: string;\n    };\n}\n\n/**\n * 错误码枚举\n */\nexport enum RemoteErrorCode {\n    // 网络错误\n    NETWORK_ERROR = 'NETWORK_ERROR',\n    CONNECTION_TIMEOUT = 'CONNECTION_TIMEOUT',\n\n    // 服务器错误\n    INTERNAL_ERROR = 'INTERNAL_ERROR',\n\n    // 业务错误\n    THREAD_NOT_FOUND = 'THREAD_NOT_FOUND',\n    THREAD_BUSY = 'THREAD_BUSY',\n    RUN_NOT_FOUND = 'RUN_NOT_FOUND',\n    GRAPH_NOT_FOUND = 'GRAPH_NOT_FOUND',\n    INVALID_REQUEST = 'INVALID_REQUEST',\n}\n\n/**\n * 远程 API 错误类\n */\nexport class RemoteApiError extends Error {\n    constructor(\n        public code: string,\n        message: string,\n        public statusCode?: number\n    ) {\n        super(message);\n        this.name = 'RemoteApiError';\n    }\n}\n\n/**\n * Setup API 响应\n */\nexport interface SetupResponse {\n    message: string;\n}\n\n/**\n * Create Thread API 请求\n */\nexport interface CreateThreadRequest {\n    metadata?: Metadata;\n    threadId?: string;\n    ifExists?: OnConflictBehavior;\n    graphId?: string;\n    supersteps?: Array<{ updates: Array<{ values: unknown; command?: Command; asNode: string }> }>;\n}\n\n/**\n * Search Threads API 请求\n */\nexport interface SearchThreadsRequest {\n    ids?: string[];\n    metadata?: Metadata;\n    limit?: number;\n    offset?: number;\n    status?: ThreadStatus;\n    sortBy?: ThreadSortBy;\n    sortOrder?: SortOrder;\n    values?: unknown;\n    select?: Array<'thread_id' | 'created_at' | 'updated_at' | 'metadata' | 'config' | 'context' | 'status' | 'values' | 'interrupts'>;\n    /**\n     * @deprecated Use `select` parameter instead for fine-grained field control\n     */\n    withoutDetails?: boolean;\n}\n\n/**\n * Update Thread API 请求\n */\nexport interface UpdateThreadRequest {\n    metadata?: Metadata;\n    status?: ThreadStatus;\n    values?: any;\n    interrupts?: Record<string, any>;\n}\n\n/**\n * Update State API 请求\n */\nexport interface UpdateStateRequest {\n    values?: any;\n}\n\n/**\n * Update State API 响应\n */\nexport interface UpdateStateResponse {\n    configurable: Record<string, any>;\n}\n\n/**\n * Create Run API 请求\n */\nexport interface CreateRunRequest {\n    metadata?: Metadata;\n}\n\n/**\n * List Runs API 请求\n */\nexport interface ListRunsRequest {\n    limit?: number;\n    offset?: number;\n    status?: RunStatus;\n}\n\n/**\n * Update Run API 请求\n */\nexport interface UpdateRunRequest {\n    status?: RunStatus;\n    metadata?: Metadata;\n    multitask_strategy?: 'reject' | 'interrupt' | 'rollback';\n}\n","/**\n * Remote PostgreSQL Adapter - 简化的 Fetch 工具函数\n */\n\nimport { RemoteResponse } from './types';\nimport { RemoteApiError, RemoteErrorCode } from './types';\n\n/**\n * 发起 HTTP 请求的简化函数\n */\nasync function request<T>(\n    url: string,\n    method: string,\n    options?: {\n        query?: Record<string, string | number | boolean>;\n        body?: any;\n    },\n): Promise<RemoteResponse<T>> {\n    try {\n        // 添加查询参数\n        let requestUrl = url;\n        if (options?.query) {\n            const searchParams = new URLSearchParams();\n            Object.entries(options.query).forEach(([key, value]) => {\n                searchParams.append(key, String(value));\n            });\n            requestUrl += `?${searchParams.toString()}`;\n        }\n\n        // 发起请求\n        const response = await fetch(requestUrl, {\n            method,\n            headers: {\n                'Content-Type': 'application/json',\n            },\n            body: options?.body ? JSON.stringify(options.body) : undefined,\n        });\n\n        // 解析响应\n        const data: RemoteResponse<T> = (await response.json()) as any;\n\n        // 检查响应状态\n        if (!response.ok || !data.success) {\n            throw new RemoteApiError(\n                data.error?.code || RemoteErrorCode.INTERNAL_ERROR,\n                data.error?.message || 'Unknown error',\n                response.status,\n            );\n        }\n\n        return data;\n    } catch (error) {\n        // 如果是 RemoteApiError，直接抛出\n        if (error instanceof RemoteApiError) {\n            throw error;\n        }\n\n        // 网络错误转换为 RemoteApiError\n        throw new RemoteApiError(\n            RemoteErrorCode.NETWORK_ERROR,\n            `Network error: ${error instanceof Error ? error.message : 'Unknown error'}`,\n        );\n    }\n}\n\n/**\n * GET 请求\n */\nexport async function remoteGet<T>(\n    url: string,\n    query?: Record<string, string | number | boolean>,\n): Promise<RemoteResponse<T>> {\n    return request<T>(url, 'GET', { query });\n}\n\n/**\n * POST 请求\n */\nexport async function remotePost<T>(\n    url: string,\n    body?: any,\n    query?: Record<string, string | number | boolean>,\n): Promise<RemoteResponse<T>> {\n    return request<T>(url, 'POST', { body, query });\n}\n\n/**\n * PUT 请求\n */\nexport async function remotePut<T>(\n    url: string,\n    body?: any,\n    query?: Record<string, string | number | boolean>,\n): Promise<RemoteResponse<T>> {\n    return request<T>(url, 'PUT', { body, query });\n}\n\n/**\n * DELETE 请求\n */\nexport async function remoteDelete<T>(\n    url: string,\n    query?: Record<string, string | number | boolean>,\n): Promise<RemoteResponse<T>> {\n    return request<T>(url, 'DELETE', { query });\n}\n","/**\n * Remote Kysely Threads Manager\n * 通过 HTTP/REST API 与远程 PostgreSQL 服务器通信\n */\n\nimport { BaseThreadsManager } from '../../threads';\nimport { Metadata, OnConflictBehavior, Run, Thread, ThreadState } from '@langgraph-js/sdk';\nimport { RunStatus, SortOrder, ThreadSortBy } from '../../types';\nimport { remoteGet, remotePost, remotePut, remoteDelete } from '../remote/fetch';\nimport { RemoteApiError, RemoteErrorCode } from '../remote/types';\n\n/**\n * 远程 Kysely Threads Manager\n */\nexport class RemoteKyselyThreadsManager<ValuesType = unknown> implements BaseThreadsManager<ValuesType> {\n    constructor(private serverUrl: string, private httpClient?: typeof fetch) {\n        // 确保服务器 URL 没有尾部斜杠\n        this.serverUrl = serverUrl.replace(/\\/$/, '');\n        this.httpClient = httpClient || fetch;\n    }\n\n    /**\n     * 初始化数据库\n     */\n    async setup(): Promise<void> {\n        await remotePost(`${this.serverUrl}/setup`);\n    }\n\n    /**\n     * 创建线程\n     */\n    async create(payload?: {\n        metadata?: Metadata;\n        threadId?: string;\n        ifExists?: OnConflictBehavior;\n        graphId?: string;\n        supersteps?: Array<{ updates: Array<{ values: unknown; command?: any; asNode: string }> }>;\n    }): Promise<Thread<ValuesType>> {\n        const response = await remotePost<Thread<ValuesType>>(`${this.serverUrl}/threads`, payload);\n        return response.data as Thread<ValuesType>;\n    }\n\n    /**\n     * 搜索线程\n     */\n    async search(query?: {\n        ids?: string[];\n        metadata?: Metadata;\n        limit?: number;\n        offset?: number;\n        status?: any;\n        sortBy?: ThreadSortBy;\n        sortOrder?: SortOrder;\n        values?: ValuesType;\n        select?: Array<\n            | 'thread_id'\n            | 'created_at'\n            | 'updated_at'\n            | 'metadata'\n            | 'config'\n            | 'context'\n            | 'status'\n            | 'values'\n            | 'interrupts'\n        >;\n        /**\n         * @deprecated Use `select` parameter instead for fine-grained field control\n         */\n        withoutDetails?: boolean;\n    }): Promise<Thread<ValuesType>[]> {\n        const params: Record<string, string | number | boolean> = {};\n\n        if (query?.ids !== undefined && query.ids.length > 0) {\n            params.ids = JSON.stringify(query.ids);\n        }\n        if (query?.metadata !== undefined) {\n            params.metadata = JSON.stringify(query.metadata);\n        }\n        if (query?.limit !== undefined) {\n            params.limit = query.limit;\n        }\n        if (query?.offset !== undefined) {\n            params.offset = query.offset;\n        }\n        if (query?.status !== undefined) {\n            params.status = query.status;\n        }\n        if (query?.sortBy !== undefined) {\n            params.sortBy = query.sortBy;\n        }\n        if (query?.sortOrder !== undefined) {\n            params.sortOrder = query.sortOrder;\n        }\n        if (query?.values !== undefined) {\n            params.values = JSON.stringify(query.values);\n        }\n        if (query?.select !== undefined) {\n            params.select = JSON.stringify(query.select);\n        }\n        if (query?.withoutDetails !== undefined) {\n            params.withoutDetails = query.withoutDetails;\n        }\n\n        const response = await remoteGet<Thread<ValuesType>[]>(`${this.serverUrl}/threads`, params);\n        return response.data as Thread<ValuesType>[];\n    }\n\n    /**\n     * 获取线程\n     */\n    async get(threadId: string): Promise<Thread<ValuesType>> {\n        const response = await remoteGet<Thread<ValuesType>>(`${this.serverUrl}/threads/${threadId}`);\n        return response.data as Thread<ValuesType>;\n    }\n\n    /**\n     * 更新线程\n     */\n    async set(threadId: string, thread: Partial<Thread<ValuesType>>): Promise<void> {\n        await remotePut(`${this.serverUrl}/threads/${threadId}`, thread);\n    }\n\n    /**\n     * 删除线程\n     */\n    async delete(threadId: string): Promise<void> {\n        await remoteDelete(`${this.serverUrl}/threads/${threadId}`);\n    }\n\n    /**\n     * 更新状态\n     */\n    async updateState(\n        threadId: string,\n        thread: Partial<Thread<ValuesType>>,\n    ): Promise<{ configurable: Record<string, any> }> {\n        const response = await remotePost<{ configurable: Record<string, any> }>(\n            `${this.serverUrl}/threads/${threadId}/state`,\n            thread,\n        );\n        return response.data as { configurable: Record<string, any> };\n    }\n\n    /**\n     * 创建运行\n     */\n    async createRun(threadId: string, assistantId: string, payload?: { metadata?: Metadata }): Promise<Run> {\n        const response = await remotePost<Run>(`${this.serverUrl}/threads/${threadId}/runs`, payload || {}, {\n            assistantId,\n        });\n        return response.data as Run;\n    }\n\n    /**\n     * 列出运行\n     */\n    async listRuns(\n        threadId: string,\n        options?: { limit?: number; offset?: number; status?: RunStatus },\n    ): Promise<Run[]> {\n        const params: Record<string, string | number> = {};\n\n        if (options?.limit !== undefined) {\n            params.limit = options.limit;\n        }\n        if (options?.offset !== undefined) {\n            params.offset = options.offset;\n        }\n        if (options?.status !== undefined) {\n            params.status = options.status;\n        }\n\n        const response = await remoteGet<Run[]>(`${this.serverUrl}/threads/${threadId}/runs`, params);\n        return response.data as Run[];\n    }\n\n    /**\n     * 更新运行\n     */\n    async updateRun(runId: string, run: Partial<Run>): Promise<void> {\n        await remotePut(`${this.serverUrl}/runs/${runId}`, run);\n    }\n\n    // New methods for Threads API\n\n    /**\n     * 计算线程数量\n     */\n    async count(query?: { ids?: string[]; metadata?: Metadata; status?: any; values?: ValuesType }): Promise<number> {\n        const params: Record<string, string> = {};\n\n        if (query?.ids !== undefined && query.ids.length > 0) {\n            params.ids = JSON.stringify(query.ids);\n        }\n        if (query?.metadata !== undefined) {\n            params.metadata = JSON.stringify(query.metadata);\n        }\n        if (query?.status !== undefined) {\n            params.status = query.status;\n        }\n        if (query?.values !== undefined) {\n            params.values = JSON.stringify(query.values);\n        }\n\n        const response = await remoteGet<number>(`${this.serverUrl}/threads/count`, params);\n        return response.data as number;\n    }\n\n    /**\n     * 更新线程元数据\n     */\n    async patch(\n        threadId: string,\n        updates: Partial<Omit<Thread<ValuesType>, 'thread_id' | 'created_at' | 'updated_at'>>,\n    ): Promise<Thread<ValuesType>> {\n        const response = await remotePost<Thread<ValuesType>>(`${this.serverUrl}/threads/${threadId}`, updates);\n        return response.data as Thread<ValuesType>;\n    }\n\n    /**\n     * 获取线程状态\n     */\n    async getState(threadId: string, options?: { subgraphs?: boolean; checkpointId?: string }): Promise<ThreadState> {\n        const params: Record<string, boolean | string> = {};\n\n        if (options?.subgraphs !== undefined) {\n            params.subgraphs = options.subgraphs;\n        }\n        if (options?.checkpointId !== undefined) {\n            params.checkpointId = options.checkpointId;\n        }\n\n        const response = await remotePost<ThreadState>(`${this.serverUrl}/threads/${threadId}/state`, params);\n        return response.data as ThreadState;\n    }\n\n    /**\n     * 获取线程历史\n     */\n    async getStateHistory(\n        threadId: string,\n        options?: {\n            limit?: number;\n            before?: string;\n            filter?: { source?: string; step?: number };\n        },\n    ): Promise<ThreadState[]> {\n        const params: Record<string, number | string> = {};\n\n        if (options?.limit !== undefined) {\n            params.limit = options.limit;\n        }\n        if (options?.before !== undefined) {\n            params.before = options.before;\n        }\n\n        const response = await remotePost<ThreadState[]>(`${this.serverUrl}/threads/${threadId}/history`, params);\n        return response.data as ThreadState[];\n    }\n\n    /**\n     * 复制线程\n     */\n    async copy(threadId: string): Promise<Thread<ValuesType>> {\n        const response = await remotePost<Thread<ValuesType>>(`${this.serverUrl}/threads/${threadId}/copy`);\n        return response.data as Thread<ValuesType>;\n    }\n}\n"],"names":["RemoteErrorCode"],"mappings":"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"}

package/dist/storage/index.d.ts

@@ -8,4 +8,4 @@ export declare const createCheckPointer: () => Promise<SqliteSaverType | Postgre
 export declare const createMessageQueue: () => Promise<StreamQueueManager<BaseStreamQueueInterface>>;
 export declare const createThreadManager: (config: {
     checkpointer?: SqliteSaverType | PostgresSaver;
-}) => Promise<KyselyThreadsManager<unknown> | MemoryThreadsManager<unknown>>;
+}) => Promise<import("./kysely").RemoteKyselyThreadsManager<unknown> | KyselyThreadsManager<unknown> | MemoryThreadsManager<unknown>>;

package/dist/storage/kysely/index.d.ts

@@ -7,3 +7,4 @@ export { type DatabaseAdapter } from './adapter';
 export { PostgresAdapter } from './pg-adapter';
 export { SQLiteAdapter } from './sqlite-adapter';
 export { KyselyThreadsManager } from './threads';
+export { RemoteKyselyThreadsManager } from './remote-threads';

package/dist/storage/kysely/remote-threads.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Remote Kysely Threads Manager
+ * 通过 HTTP/REST API 与远程 PostgreSQL 服务器通信
+ */
+import { BaseThreadsManager } from '../../threads';
+import { Metadata, OnConflictBehavior, Run, Thread, ThreadState } from '@langgraph-js/sdk';
+import { RunStatus, SortOrder, ThreadSortBy } from '../../types';
+/**
+ * 远程 Kysely Threads Manager
+ */
+export declare class RemoteKyselyThreadsManager<ValuesType = unknown> implements BaseThreadsManager<ValuesType> {
+    private serverUrl;
+    private httpClient?;
+    constructor(serverUrl: string, httpClient?: typeof fetch | undefined);
+    /**
+     * 初始化数据库
+     */
+    setup(): Promise<void>;
+    /**
+     * 创建线程
+     */
+    create(payload?: {
+        metadata?: Metadata;
+        threadId?: string;
+        ifExists?: OnConflictBehavior;
+        graphId?: string;
+        supersteps?: Array<{
+            updates: Array<{
+                values: unknown;
+                command?: any;
+                asNode: string;
+            }>;
+        }>;
+    }): Promise<Thread<ValuesType>>;
+    /**
+     * 搜索线程
+     */
+    search(query?: {
+        ids?: string[];
+        metadata?: Metadata;
+        limit?: number;
+        offset?: number;
+        status?: any;
+        sortBy?: ThreadSortBy;
+        sortOrder?: SortOrder;
+        values?: ValuesType;
+        select?: Array<'thread_id' | 'created_at' | 'updated_at' | 'metadata' | 'config' | 'context' | 'status' | 'values' | 'interrupts'>;
+        /**
+         * @deprecated Use `select` parameter instead for fine-grained field control
+         */
+        withoutDetails?: boolean;
+    }): Promise<Thread<ValuesType>[]>;
+    /**
+     * 获取线程
+     */
+    get(threadId: string): Promise<Thread<ValuesType>>;
+    /**
+     * 更新线程
+     */
+    set(threadId: string, thread: Partial<Thread<ValuesType>>): Promise<void>;
+    /**
+     * 删除线程
+     */
+    delete(threadId: string): Promise<void>;
+    /**
+     * 更新状态
+     */
+    updateState(threadId: string, thread: Partial<Thread<ValuesType>>): Promise<{
+        configurable: Record<string, any>;
+    }>;
+    /**
+     * 创建运行
+     */
+    createRun(threadId: string, assistantId: string, payload?: {
+        metadata?: Metadata;
+    }): Promise<Run>;
+    /**
+     * 列出运行
+     */
+    listRuns(threadId: string, options?: {
+        limit?: number;
+        offset?: number;
+        status?: RunStatus;
+    }): Promise<Run[]>;
+    /**
+     * 更新运行
+     */
+    updateRun(runId: string, run: Partial<Run>): Promise<void>;
+    /**
+     * 计算线程数量
+     */
+    count(query?: {
+        ids?: string[];
+        metadata?: Metadata;
+        status?: any;
+        values?: ValuesType;
+    }): Promise<number>;
+    /**
+     * 更新线程元数据
+     */
+    patch(threadId: string, updates: Partial<Omit<Thread<ValuesType>, 'thread_id' | 'created_at' | 'updated_at'>>): Promise<Thread<ValuesType>>;
+    /**
+     * 获取线程状态
+     */
+    getState(threadId: string, options?: {
+        subgraphs?: boolean;
+        checkpointId?: string;
+    }): Promise<ThreadState>;
+    /**
+     * 获取线程历史
+     */
+    getStateHistory(threadId: string, options?: {
+        limit?: number;
+        before?: string;
+        filter?: {
+            source?: string;
+            step?: number;
+        };
+    }): Promise<ThreadState[]>;
+    /**
+     * 复制线程
+     */
+    copy(threadId: string): Promise<Thread<ValuesType>>;
+}

package/dist/storage/kysely/threads.d.ts

@@ -1,5 +1,5 @@
 import { BaseThreadsManager } from '../../threads/index.js';
-import { Command, Config, Metadata, OnConflictBehavior, Run, Thread, ThreadStatus } from '@langgraph-js/sdk';
+import { Command, Config, Metadata, OnConflictBehavior, Run, Thread, ThreadState, ThreadStatus } from '@langgraph-js/sdk';
 import { RunStatus, SortOrder, ThreadSortBy } from '../../types';
 import { DatabaseAdapter } from './adapter';
 /**
@@ -25,18 +25,21 @@ export declare class KyselyThreadsManager<ValuesType = unknown> implements BaseT
         }>;
     }): Promise<Thread<ValuesType>>;
     search(query?: {
+        ids?: string[];
         metadata?: Metadata;
         limit?: number;
         offset?: number;
         status?: ThreadStatus;
         sortBy?: ThreadSortBy;
         sortOrder?: SortOrder;
+        values?: ValuesType;
+        select?: Array<'thread_id' | 'created_at' | 'updated_at' | 'metadata' | 'config' | 'context' | 'status' | 'values' | 'interrupts'>;
         withoutDetails?: boolean;
     }): Promise<Thread<ValuesType>[]>;
     get(threadId: string): Promise<Thread<ValuesType>>;
     set(threadId: string, thread: Partial<Thread<ValuesType>>): Promise<void>;
-    updateState(threadId: string, thread: Partial<Thread<ValuesType>>): Promise<Pick<Config, 'configurable'>>;
     delete(threadId: string): Promise<void>;
+    updateState(threadId: string, thread: Partial<Thread<ValuesType>>): Promise<Pick<Config, 'configurable'>>;
     createRun(threadId: string, assistantId: string, payload?: {
         metadata?: Metadata;
     }): Promise<Run>;
@@ -46,4 +49,25 @@ export declare class KyselyThreadsManager<ValuesType = unknown> implements BaseT
         status?: RunStatus;
     }): Promise<Run[]>;
     updateRun(runId: string, run: Partial<Run>): Promise<void>;
+    count(query?: {
+        ids?: string[];
+        metadata?: Metadata;
+        status?: ThreadStatus;
+        values?: ValuesType;
+    }): Promise<number>;
+    patch(threadId: string, updates: Partial<Omit<Thread<ValuesType>, 'thread_id' | 'created_at' | 'updated_at'>>): Promise<Thread<ValuesType>>;
+    getState(threadId: string, options?: {
+        subgraphs?: boolean;
+        checkpointId?: string;
+    }): Promise<ThreadState>;
+    getStateHistory(threadId: string, options?: {
+        limit?: number;
+        before?: string;
+        filter?: {
+            source?: string;
+            step?: number;
+        };
+    }): Promise<ThreadState[]>;
+    copy(threadId: string): Promise<Thread<ValuesType>>;
+    private saveCheckpoint;
 }

package/dist/storage/kysely/types.d.ts

@@ -11,6 +11,15 @@ export interface ThreadsTable {
     values: any;
     interrupts: Record<string, any>;
 }
+export interface CheckpointsTable {
+    checkpoint_id: string;
+    thread_id: string;
+    values: any;
+    next: string[];
+    config: any;
+    created_at: Date;
+    metadata: Record<string, any>;
+}
 export interface RunsTable {
     run_id: string;
     thread_id: string;
@@ -23,5 +32,6 @@ export interface RunsTable {
 }
 export interface Database {
     threads: ThreadsTable;
+    checkpoints: CheckpointsTable;
     runs: RunsTable;
 }

package/dist/storage/memory/queue.d.ts

@@ -13,6 +13,6 @@ export declare class MemoryStreamQueue extends BaseStreamQueue implements BaseSt
     getAll(): Promise<EventMessage[]>;
     clear(): void;
     cancelSignal: AbortController;
-    cancel(): void;
+    cancel(): Promise<void>;
     copyToQueue(toId: string, ttl?: number): Promise<MemoryStreamQueue>;
 }

package/dist/storage/memory/threads.d.ts

@@ -1,8 +1,9 @@
 import { BaseThreadsManager } from '../../threads/index.js';
-import { Command, Config, Metadata, OnConflictBehavior, Run, Thread, ThreadStatus } from '@langgraph-js/sdk';
+import { Command, Config, Metadata, OnConflictBehavior, Run, Thread, ThreadState, ThreadStatus } from '@langgraph-js/sdk';
 import { RunStatus, SortOrder, ThreadSortBy } from '../../types';
 export declare class MemoryThreadsManager<ValuesType = unknown> implements BaseThreadsManager<ValuesType> {
     private threads;
+    private checkpoints;
     setup(): Promise<void>;
     create(payload?: {
         metadata?: Metadata;
@@ -18,14 +19,18 @@ export declare class MemoryThreadsManager<ValuesType = unknown> implements BaseT
         }>;
     }): Promise<Thread<ValuesType>>;
     search(query?: {
+        ids?: string[];
         metadata?: Metadata;
         limit?: number;
         offset?: number;
         status?: ThreadStatus;
         sortBy?: ThreadSortBy;
         sortOrder?: SortOrder;
+        values?: ValuesType;
+        select?: Array<'thread_id' | 'created_at' | 'updated_at' | 'metadata' | 'config' | 'context' | 'status' | 'values' | 'interrupts'>;
         withoutDetails?: boolean;
     }): Promise<Thread<ValuesType>[]>;
+    private deepEqual;
     get(threadId: string): Promise<Thread<ValuesType>>;
     set(threadId: string, thread: Partial<Thread<ValuesType>>): Promise<void>;
     delete(threadId: string): Promise<void>;
@@ -40,4 +45,25 @@ export declare class MemoryThreadsManager<ValuesType = unknown> implements BaseT
         status?: RunStatus;
     }): Promise<Run[]>;
     updateRun(runId: string, run: Partial<Run>): Promise<void>;
+    count(query?: {
+        ids?: string[];
+        metadata?: Metadata;
+        status?: ThreadStatus;
+        values?: ValuesType;
+    }): Promise<number>;
+    patch(threadId: string, updates: Partial<Omit<Thread<ValuesType>, 'thread_id' | 'created_at' | 'updated_at'>>): Promise<Thread<ValuesType>>;
+    getState(threadId: string, options?: {
+        subgraphs?: boolean;
+        checkpointId?: string;
+    }): Promise<ThreadState>;
+    getStateHistory(threadId: string, options?: {
+        limit?: number;
+        before?: string;
+        filter?: {
+            source?: string;
+            step?: number;
+        };
+    }): Promise<ThreadState[]>;
+    copy(threadId: string): Promise<Thread<ValuesType>>;
+    saveCheckpoint(threadId: string, values: any, next: string[], config: Config, metadata?: Metadata): Promise<void>;
 }

package/dist/storage/redis/queue.d.ts

@@ -1,34 +1,34 @@
 import { EventMessage } from '../../queue/event_message.js';
 import { BaseStreamQueue } from '../../queue/stream_queue.js';
 import { BaseStreamQueueInterface } from '../../queue/stream_queue.js';
-import { RedisClientType } from 'redis';
 /**
- * Redis 实现的消息队列，用于存储消息
+ * Redis Stream 实现的消息队列，用于存储消息
+ * 使用 Redis Streams 替代 pub/sub，支持集群模式
  */
 export declare class RedisStreamQueue extends BaseStreamQueue implements BaseStreamQueueInterface {
     readonly id: string;
     readonly compressMessages: boolean;
     readonly ttl: number;
-    static redis: RedisClientType;
-    static subscriberRedis: RedisClientType;
-    static isQueueExist(id: string): Promise<boolean>;
     private redis;
-    private subscriberRedis;
-    private queueKey;
-    private channelKey;
+    private streamKey;
+    private listKey;
     private isConnected;
     cancelSignal: AbortController;
+    private lastStreamId;
+    private pollInterval;
     constructor(id: string, compressMessages?: boolean, ttl?: number);
     /**
-     * 推送消息到 Redis 队列
+     * 推送消息到 Redis Stream 和 List
+     * - Stream: 用于实时推送（集群友好）
+     * - List: 用于 getAll() 批量获取历史数据
      */
     push(item: EventMessage): Promise<void>;
     /**
-     * 异步生成器：支持 for await...of 方式消费队列数据
+     * 异步生成器：使用 Redis Streams XREAD 轮询消费队列数据
      */
     onDataReceive(): AsyncGenerator<EventMessage, void, unknown>;
     /**
-     * 获取队列中的所有数据
+     * 获取队列中的所有数据（从 List 获取历史数据）
      */
     getAll(): Promise<EventMessage[]>;
     /**
@@ -38,6 +38,9 @@ export declare class RedisStreamQueue extends BaseStreamQueue implements BaseStr
     /**
      * 取消操作
      */
-    cancel(): void;
+    cancel(): Promise<void>;
+    /**
+     * 复制队列到另一个队列
+     */
     copyToQueue(toId: string, ttl?: number): Promise<RedisStreamQueue>;
 }

package/dist/storage/remote/fetch.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Remote PostgreSQL Adapter - 简化的 Fetch 工具函数
+ */
+import { RemoteResponse } from './types';
+/**
+ * GET 请求
+ */
+export declare function remoteGet<T>(url: string, query?: Record<string, string | number | boolean>): Promise<RemoteResponse<T>>;
+/**
+ * POST 请求
+ */
+export declare function remotePost<T>(url: string, body?: any, query?: Record<string, string | number | boolean>): Promise<RemoteResponse<T>>;
+/**
+ * PUT 请求
+ */
+export declare function remotePut<T>(url: string, body?: any, query?: Record<string, string | number | boolean>): Promise<RemoteResponse<T>>;
+/**
+ * DELETE 请求
+ */
+export declare function remoteDelete<T>(url: string, query?: Record<string, string | number | boolean>): Promise<RemoteResponse<T>>;