@langgraph-js/pure-graph 3.1.1 → 3.2.0

package/dist/storage/index.d.ts

@@ -3,11 +3,13 @@ import { KyselyThreadsManager } from './kysely/threads';
 import { ShallowMemorySaver } from './memory/shallow-memory';
 import { MemoryThreadsManager } from './memory/threads';
 import type { SqliteSaver as SqliteSaverType } from './sqlite/checkpoint';
+import type { SqliteShallowSaver as SqliteShallowSaverType } from './sqlite/shallow-checkpoint';
 import type { PostgresSaver } from '@langchain/langgraph-checkpoint-postgres';
 export { ShallowMemorySaver } from './memory/shallow-memory';
 export { MemorySaver } from './memory/checkpoint';
-export declare const createCheckPointer: () => Promise<ShallowMemorySaver | SqliteSaverType | PostgresSaver | import("@langchain/langgraph-checkpoint-redis").RedisSaver | import("@langchain/langgraph-checkpoint-redis/shallow").ShallowRedisSaver>;
+export { SqliteShallowSaver } from './sqlite/shallow-checkpoint';
+export declare const createCheckPointer: () => Promise<ShallowMemorySaver | SqliteSaverType | SqliteShallowSaverType | PostgresSaver | import("@langchain/langgraph-checkpoint-redis").RedisSaver | import("@langchain/langgraph-checkpoint-redis/shallow").ShallowRedisSaver>;
 export declare const createMessageQueue: () => Promise<StreamQueueManager<BaseStreamQueueInterface>>;
 export declare const createThreadManager: (config: {
-    checkpointer?: SqliteSaverType | PostgresSaver;
+    checkpointer?: SqliteSaverType | SqliteShallowSaverType | PostgresSaver;
 }) => Promise<import("./kysely").RemoteKyselyThreadsManager<unknown> | KyselyThreadsManager<unknown> | MemoryThreadsManager<unknown>>;

package/dist/storage/kysely/sqlite-adapter.d.ts

@@ -9,7 +9,14 @@ import { Database } from './types';
  */
 export declare class SQLiteAdapter implements DatabaseAdapter {
     db: Kysely<Database>;
+    private pragmaPromise;
     constructor(database: Kysely<any>);
+    /**
+     * 设置 SQLite PRAGMA 配置，解决锁问题
+     * 使用 Promise 缓存确保并发安全且只执行一次
+     */
+    private ensurePragma;
+    private doEnsurePragma;
     dateToDb(date: Date): string;
     dbToDate(dbValue: any): Date;
     jsonToDb(obj: any): string;

package/dist/storage/sqlite/shallow-checkpoint.d.ts

@@ -0,0 +1,59 @@
+import { Dialect, Kysely } from 'kysely';
+import type { RunnableConfig } from '@langchain/core/runnables';
+import { BaseCheckpointSaver, type Checkpoint, type CheckpointListOptions, type CheckpointTuple, type SerializerProtocol, type PendingWrite, type CheckpointMetadata } from '@langchain/langgraph-checkpoint';
+interface ShallowCheckpointsTable {
+    thread_id: string;
+    checkpoint_ns: string;
+    checkpoint_id: string;
+    parent_checkpoint_id: string | null;
+    type: string | null;
+    checkpoint: Uint8Array;
+    metadata: Uint8Array;
+    checkpoint_ts: number;
+}
+interface WritesTable {
+    thread_id: string;
+    checkpoint_ns: string;
+    checkpoint_id: string;
+    task_id: string;
+    idx: number;
+    channel: string;
+    type: string | null;
+    value: Uint8Array | null;
+}
+interface ShallowCheckpointDatabase {
+    shallow_checkpoints: ShallowCheckpointsTable;
+    writes: WritesTable;
+}
+/**
+ * SqliteShallowSaver - SQLite 浅层检查点存储器
+ *
+ * 特性:
+ * - 每个 thread_id + checkpoint_ns 组合只保留最新的 checkpoint
+ * - 新 checkpoint 写入时自动清理旧 checkpoint 的 writes
+ * - 使用 checkpoint_ts 时间戳排序
+ * - 大幅减少存储数据量
+ */
+export declare class SqliteShallowSaver extends BaseCheckpointSaver {
+    db: Kysely<ShallowCheckpointDatabase>;
+    protected isSetup: boolean;
+    constructor(dialect: Dialect, serde?: SerializerProtocol);
+    static fromConnStringAsync(connStringOrLocalPath: string): Promise<SqliteShallowSaver>;
+    protected setup(): Promise<void>;
+    /**
+     * 获取 checkpoint（便捷方法）
+     */
+    get(config: RunnableConfig): Promise<Checkpoint | undefined>;
+    getTuple(config: RunnableConfig): Promise<CheckpointTuple | undefined>;
+    list(config: RunnableConfig, options?: CheckpointListOptions): AsyncGenerator<CheckpointTuple>;
+    /**
+     * Check metadata filter matches (with deep comparison support)
+     * Matches ShallowMemorySaver behavior
+     */
+    private _checkMetadataFilterMatch;
+    put(config: RunnableConfig, checkpoint: Checkpoint, metadata: CheckpointMetadata, _newVersions?: Record<string, string | number>): Promise<RunnableConfig>;
+    putWrites(config: RunnableConfig, writes: PendingWrite[], taskId: string): Promise<void>;
+    deleteThread(threadId: string): Promise<void>;
+    protected migratePendingSends(checkpoint: Checkpoint, threadId: string, parentCheckpointId: string): Promise<void>;
+}
+export {};

package/dist/{stream-3xunCZso.js → stream-pZfO6Y-p.js}

@@ -5,6 +5,7 @@ import { EventEmitter } from 'eventemitter3';
 import { load } from '@langchain/core/load';
 import { v7 } from 'uuid';
 import { BaseCheckpointSaver, TASKS, maxChannelVersion, getCheckpointId, copyCheckpoint, uuid6, WRITES_IDX_MAP } from '@langchain/langgraph-checkpoint';
+import 'kysely';
 
 const getLangGraphCommand = (command) => {
   let goto = command.goto != null && !Array.isArray(command.goto) ? [command.goto] : command.goto;
@@ -1599,7 +1600,7 @@ class MemoryThreadsManager {
 }
 
 const createCheckPointer = async () => {
-  if (process.env.REDIS_URL && process.env.CHECKPOINT_TYPE === "redis" || process.env.CHECKPOINT_TYPE === "shallow/redis") {
+  if (process.env.REDIS_URL && (process.env.CHECKPOINT_TYPE === "redis" || process.env.CHECKPOINT_TYPE === "shallow/redis")) {
     if (process.env.CHECKPOINT_TYPE === "redis") {
       console.debug("LG | Using redis as checkpoint");
       const { RedisSaver } = await import('@langchain/langgraph-checkpoint-redis');
@@ -1621,9 +1622,15 @@ const createCheckPointer = async () => {
     return createPGCheckpoint();
   }
   if (process.env.SQLITE_DATABASE_URI) {
-    console.debug("LG | Using sqlite as checkpoint");
-    const { SqliteSaver } = await import('./checkpoint-1sAx_j1E.js');
-    const db = await SqliteSaver.fromConnStringAsync(process.env.SQLITE_DATABASE_URI);
+    if (process.env.CHECKPOINT_TYPE === "sqlite") {
+      console.debug("LG | Using sqlite (full) as checkpoint");
+      const { SqliteSaver } = await import('./checkpoint-C5AFBYE-.js');
+      const db2 = await SqliteSaver.fromConnStringAsync(process.env.SQLITE_DATABASE_URI);
+      return db2;
+    }
+    console.debug("LG | Using shallow sqlite as checkpoint (default)");
+    const { SqliteShallowSaver: SqliteShallowSaver2 } = await import('./shallow-checkpoint-BEhTdp7z.js');
+    const db = await SqliteShallowSaver2.fromConnStringAsync(process.env.SQLITE_DATABASE_URI);
     return db;
   }
   console.log("LG | You are using memory as checkpoint!");
@@ -1641,7 +1648,7 @@ const createMessageQueue = async () => {
   let q;
   if (process.env.REDIS_URL) {
     console.debug("LG | Using redis as stream queue");
-    const { RedisStreamQueue } = await import('./queue-8-m4OzOj.js');
+    const { RedisStreamQueue } = await import('./queue-DySatFkr.js');
     q = RedisStreamQueue;
   } else {
     q = MemoryStreamQueue;
@@ -1681,7 +1688,7 @@ const createThreadManager = async (config) => {
   }
   if (process.env.SQLITE_DATABASE_URI && config.checkpointer) {
     console.debug("LG | Using SQLite ThreadsManager");
-    const { SQLiteAdapter } = await import('./sqlite-adapter-Bbonr5S5.js');
+    const { SQLiteAdapter } = await import('./sqlite-adapter-oBA95xba.js');
     const database = config.checkpointer.db;
     const threadsManager = new KyselyThreadsManager(new SQLiteAdapter(database));
     await threadsManager.setup();
@@ -1879,4 +1886,4 @@ async function* streamState(threads, run, payload, options) {
 }
 
 export { BaseStreamQueue as B, CancelEventMessage as C, GRAPHS as G, KyselyThreadsManager as K, LangGraphGlobal as L, streamState as a, getGraph as g, registerGraph as r, serialiseAsDict as s };
-//# sourceMappingURL=stream-3xunCZso.js.map
+//# sourceMappingURL=stream-pZfO6Y-p.js.map