@langgraph-js/pure-graph 2.8.1 → 3.0.0

package/dist/storage/remote/remote-server.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Remote PostgreSQL Server
+ * 提供 HTTP API 端点，代理 PostgreSQL 操作
+ */
+import { Hono } from 'hono';
+import { BaseThreadsManager } from '../../threads';
+/**
+ * Remote Server 类
+ */
+export declare class RemoteServer {
+    private threadsManager;
+    constructor(threadsManager: BaseThreadsManager);
+    /**
+     * 创建 Hono 路由
+     */
+    getRouter(): Hono;
+}

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

@@ -0,0 +1,11 @@
+/**
+ * Remote PostgreSQL Server 启动示例
+ *
+ * 这个文件展示如何启动一个远程 PG 服务器
+ * 运行: bun run src/storage/remote/server.ts
+ */
+declare const _default: {
+    fetch: (request: Request, Env?: unknown, executionCtx?: import("hono").ExecutionContext) => Response | Promise<Response>;
+    port: number;
+};
+export default _default;

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

@@ -0,0 +1,121 @@
+/**
+ * Remote PostgreSQL Adapter 类型定义
+ * 定义 API 请求/响应格式和错误类型
+ */
+import { Metadata, OnConflictBehavior, ThreadStatus, Command } from '@langgraph-js/sdk';
+import { RunStatus, SortOrder, ThreadSortBy } from '../../types';
+/**
+ * API 响应通用格式
+ */
+export interface RemoteResponse<T = any> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+/**
+ * 错误码枚举
+ */
+export declare enum RemoteErrorCode {
+    NETWORK_ERROR = "NETWORK_ERROR",
+    CONNECTION_TIMEOUT = "CONNECTION_TIMEOUT",
+    INTERNAL_ERROR = "INTERNAL_ERROR",
+    THREAD_NOT_FOUND = "THREAD_NOT_FOUND",
+    THREAD_BUSY = "THREAD_BUSY",
+    RUN_NOT_FOUND = "RUN_NOT_FOUND",
+    GRAPH_NOT_FOUND = "GRAPH_NOT_FOUND",
+    INVALID_REQUEST = "INVALID_REQUEST"
+}
+/**
+ * 远程 API 错误类
+ */
+export declare class RemoteApiError extends Error {
+    code: string;
+    statusCode?: number | undefined;
+    constructor(code: string, message: string, statusCode?: number | undefined);
+}
+/**
+ * Setup API 响应
+ */
+export interface SetupResponse {
+    message: string;
+}
+/**
+ * Create Thread API 请求
+ */
+export interface CreateThreadRequest {
+    metadata?: Metadata;
+    threadId?: string;
+    ifExists?: OnConflictBehavior;
+    graphId?: string;
+    supersteps?: Array<{
+        updates: Array<{
+            values: unknown;
+            command?: Command;
+            asNode: string;
+        }>;
+    }>;
+}
+/**
+ * Search Threads API 请求
+ */
+export interface SearchThreadsRequest {
+    ids?: string[];
+    metadata?: Metadata;
+    limit?: number;
+    offset?: number;
+    status?: ThreadStatus;
+    sortBy?: ThreadSortBy;
+    sortOrder?: SortOrder;
+    values?: unknown;
+    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;
+}
+/**
+ * Update Thread API 请求
+ */
+export interface UpdateThreadRequest {
+    metadata?: Metadata;
+    status?: ThreadStatus;
+    values?: any;
+    interrupts?: Record<string, any>;
+}
+/**
+ * Update State API 请求
+ */
+export interface UpdateStateRequest {
+    values?: any;
+}
+/**
+ * Update State API 响应
+ */
+export interface UpdateStateResponse {
+    configurable: Record<string, any>;
+}
+/**
+ * Create Run API 请求
+ */
+export interface CreateRunRequest {
+    metadata?: Metadata;
+}
+/**
+ * List Runs API 请求
+ */
+export interface ListRunsRequest {
+    limit?: number;
+    offset?: number;
+    status?: RunStatus;
+}
+/**
+ * Update Run API 请求
+ */
+export interface UpdateRunRequest {
+    status?: RunStatus;
+    metadata?: Metadata;
+    multitask_strategy?: 'reject' | 'interrupt' | 'rollback';
+}