@thoughtflow/core 0.1.2

package/dist/libs/checkpoint-manager.js

@@ -0,0 +1,320 @@
+"use strict";
+/**
+ * Checkpoint persistence for resumable workflows
+ *
+ * Enables capturing workflow state at specific points to enable:
+ * - Resumption from failures
+ * - State inspection and debugging
+ * - Time-travel debugging
+ * - Durable execution
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CheckpointBuilder = exports.CheckpointManager = exports.InMemoryCheckpointProvider = void 0;
+/**
+ * In-memory checkpoint provider
+ */
+class InMemoryCheckpointProvider {
+    checkpoints = new Map();
+    async save(checkpoint) {
+        this.checkpoints.set(checkpoint.metadata.id, checkpoint);
+    }
+    async load(id) {
+        return this.checkpoints.get(id);
+    }
+    async delete(id) {
+        return this.checkpoints.delete(id);
+    }
+    async query(options) {
+        let results = Array.from(this.checkpoints.values());
+        // Filter by source
+        if (options.source) {
+            results = results.filter((cp) => cp.metadata.source === options.source);
+        }
+        // Filter by graphId
+        if (options.graphId) {
+            results = results.filter((cp) => cp.metadata.graphId === options.graphId);
+        }
+        // Filter by tags
+        if (options.tags) {
+            results = results.filter((cp) => {
+                const cpTags = cp.metadata.tags || {};
+                return Object.entries(options.tags).every(([key, value]) => cpTags[key] === value);
+            });
+        }
+        // Filter by time range
+        if (options.startTime) {
+            results = results.filter((cp) => cp.metadata.createdAt >= options.startTime);
+        }
+        if (options.endTime) {
+            results = results.filter((cp) => cp.metadata.createdAt <= options.endTime);
+        }
+        // Sort
+        if (options.order === "asc") {
+            results.sort((a, b) => a.metadata.createdAt.getTime() - b.metadata.createdAt.getTime());
+        }
+        else {
+            results.sort((a, b) => b.metadata.createdAt.getTime() - a.metadata.createdAt.getTime());
+        }
+        // Limit
+        if (options.limit) {
+            results = results.slice(0, options.limit);
+        }
+        return results;
+    }
+    async listIds() {
+        return Array.from(this.checkpoints.keys());
+    }
+    async clear() {
+        this.checkpoints.clear();
+    }
+}
+exports.InMemoryCheckpointProvider = InMemoryCheckpointProvider;
+/**
+ * Checkpoint manager for creating, loading, and managing checkpoints
+ */
+class CheckpointManager {
+    provider;
+    checkpointIndex = new Map(); // source -> latest checkpoint ID
+    idCounter = 0;
+    constructor(provider) {
+        this.provider = provider || new InMemoryCheckpointProvider();
+    }
+    /**
+     * Create a new checkpoint
+     */
+    async createCheckpoint(state, source, context, options) {
+        const id = this.generateCheckpointId();
+        const checkpoint = {
+            metadata: {
+                id,
+                createdAt: new Date(),
+                source,
+                version: options?.version,
+                graphId: options?.graphId,
+                tags: options?.tags,
+            },
+            state: { ...state },
+            context: context || {},
+            parentId: options?.parentId,
+            depth: options?.parentId ? 1 : 0,
+        };
+        await this.provider.save(checkpoint);
+        // Update index for quick access to latest checkpoint per source
+        this.checkpointIndex.set(source, id);
+        return id;
+    }
+    /**
+     * Get a checkpoint by ID
+     */
+    async getCheckpoint(id) {
+        return this.provider.load(id);
+    }
+    /**
+     * Get the latest checkpoint for a source
+     */
+    async getLatestCheckpoint(source) {
+        const id = this.checkpointIndex.get(source);
+        if (!id) {
+            // Fallback: query the provider
+            const checkpoints = await this.provider.query({
+                source,
+                limit: 1,
+                order: "desc",
+            });
+            return checkpoints[0];
+        }
+        return this.provider.load(id);
+    }
+    /**
+     * Resume from a checkpoint
+     */
+    async resumeFromCheckpoint(checkpointId) {
+        const checkpoint = await this.provider.load(checkpointId);
+        if (!checkpoint) {
+            return null;
+        }
+        return {
+            state: { ...checkpoint.state },
+            context: { ...checkpoint.context },
+        };
+    }
+    /**
+     * Delete a checkpoint
+     */
+    async deleteCheckpoint(id) {
+        return this.provider.delete(id);
+    }
+    /**
+     * Query checkpoints
+     */
+    async queryCheckpoints(options) {
+        return this.provider.query(options);
+    }
+    /**
+     * Get checkpoints for a specific source
+     */
+    async getCheckpointsForSource(source, limit) {
+        return this.provider.query({ source, limit, order: "desc" });
+    }
+    /**
+     * Get checkpoints for a specific graph
+     */
+    async getCheckpointsForGraph(graphId, limit) {
+        return this.provider.query({ graphId, limit, order: "desc" });
+    }
+    /**
+     * Get all checkpoint IDs
+     */
+    async listCheckpoints() {
+        return this.provider.listIds();
+    }
+    /**
+     * Get count of all checkpoints
+     */
+    async getCheckpointCount() {
+        const ids = await this.provider.listIds();
+        return ids.length;
+    }
+    /**
+     * Get checkpoint statistics
+     */
+    async getStats() {
+        const ids = await this.provider.listIds();
+        const totalCheckpoints = ids.length;
+        if (totalCheckpoints === 0) {
+            return {
+                totalCheckpoints: 0,
+                sourceCount: 0,
+                graphCount: 0,
+            };
+        }
+        // Get all checkpoints to calculate stats
+        const allCheckpoints = await this.provider.query({
+            limit: Number.MAX_SAFE_INTEGER,
+        });
+        const sources = new Set(allCheckpoints.map((cp) => cp.metadata.source));
+        const graphs = new Set(allCheckpoints.map((cp) => cp.metadata.graphId).filter(Boolean));
+        const dates = allCheckpoints
+            .map((cp) => cp.metadata.createdAt.getTime())
+            .sort();
+        return {
+            totalCheckpoints,
+            sourceCount: sources.size,
+            graphCount: graphs.size,
+            oldestCheckpoint: new Date(dates[0]),
+            newestCheckpoint: new Date(dates[dates.length - 1]),
+        };
+    }
+    /**
+     * Clear all checkpoints
+     */
+    async clearAll() {
+        await this.provider.clear();
+        this.checkpointIndex.clear();
+    }
+    /**
+     * Generate unique checkpoint ID
+     */
+    generateCheckpointId() {
+        return `cp_${Date.now()}_${++this.idCounter}`;
+    }
+    /**
+     * Dispose resources
+     */
+    async dispose() {
+        await this.clearAll();
+    }
+}
+exports.CheckpointManager = CheckpointManager;
+/**
+ * Checkpoint builder for fluent checkpoint creation
+ */
+class CheckpointBuilder {
+    state = {};
+    context = {};
+    source;
+    graphId;
+    version;
+    tags = {};
+    parentId;
+    /**
+     * Set checkpoint state
+     */
+    withState(state) {
+        this.state = state;
+        return this;
+    }
+    /**
+     * Set checkpoint context
+     */
+    withContext(context) {
+        this.context = context;
+        return this;
+    }
+    /**
+     * Set source node
+     */
+    fromSource(source) {
+        this.source = source;
+        return this;
+    }
+    /**
+     * Set graph ID
+     */
+    forGraph(graphId) {
+        this.graphId = graphId;
+        return this;
+    }
+    /**
+     * Set version
+     */
+    withVersion(version) {
+        this.version = version;
+        return this;
+    }
+    /**
+     * Add a tag
+     */
+    addTag(key, value) {
+        this.tags[key] = value;
+        return this;
+    }
+    /**
+     * Add multiple tags
+     */
+    addTags(tags) {
+        this.tags = { ...this.tags, ...tags };
+        return this;
+    }
+    /**
+     * Set parent checkpoint
+     */
+    fromParent(parentId) {
+        this.parentId = parentId;
+        return this;
+    }
+    /**
+     * Build checkpoint
+     */
+    build() {
+        if (!this.source) {
+            throw new Error("Checkpoint must have a source");
+        }
+        return {
+            metadata: {
+                id: `cp_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
+                createdAt: new Date(),
+                source: this.source,
+                version: this.version,
+                graphId: this.graphId,
+                tags: Object.keys(this.tags).length > 0 ? this.tags : undefined,
+            },
+            state: { ...this.state },
+            context: { ...this.context },
+            parentId: this.parentId,
+            depth: this.parentId ? 1 : 0,
+        };
+    }
+}
+exports.CheckpointBuilder = CheckpointBuilder;
+//# sourceMappingURL=checkpoint-manager.js.map

package/dist/libs/checkpoint-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-manager.js","sourceRoot":"","sources":["../../src/libs/checkpoint-manager.ts"],"names":[],"mappings":"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"}

package/dist/libs/checkpointer-backends.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Checkpointer backend implementations
+ *
+ * Provides pluggable storage backends for checkpoint persistence:
+ * - In-Memory (built-in, no external deps)
+ * - File-based JSON
+ * - Redis (external)
+ * - Postgres (external)
+ */
+import { ICheckpointProvider, Checkpoint, CheckpointQueryOptions } from "./checkpoint-manager";
+/**
+ * File-based checkpoint provider using JSON storage
+ */
+export declare class FileCheckpointProvider implements ICheckpointProvider {
+    private readonly baseDir;
+    private readonly indexFile;
+    private index;
+    constructor(baseDir?: string);
+    /**
+     * Ensure checkpoint directory exists
+     */
+    private ensureDirectory;
+    /**
+     * Load index from disk
+     */
+    private loadIndex;
+    /**
+     * Save index to disk
+     */
+    private saveIndex;
+    /**
+     * Rebuild index by scanning directory
+     */
+    private rebuildIndex;
+    /**
+     * Get filename for checkpoint
+     */
+    private getFilePath;
+    save(checkpoint: Checkpoint): Promise<void>;
+    load(id: string): Promise<Checkpoint | undefined>;
+    delete(id: string): Promise<boolean>;
+    query(options: CheckpointQueryOptions): Promise<Checkpoint[]>;
+    listIds(): Promise<string[]>;
+    clear(): Promise<void>;
+    /**
+     * Remove the checkpoint directory entirely
+     */
+    cleanup(): Promise<void>;
+}
+/**
+ * Redis checkpoint provider (interface for external implementation)
+ *
+ * This is a stub demonstrating the interface. Actual implementation
+ * would require the 'redis' npm package.
+ *
+ * Usage with external Redis:
+ *   const redis = require('redis').createClient();
+ *   const provider = new RedisCheckpointProvider(redis);
+ */
+export declare class RedisCheckpointProvider implements ICheckpointProvider {
+    private readonly client;
+    private readonly keyPrefix;
+    constructor(client: any, keyPrefix?: string);
+    save(checkpoint: Checkpoint): Promise<void>;
+    load(id: string): Promise<Checkpoint | undefined>;
+    delete(id: string): Promise<boolean>;
+    query(options: CheckpointQueryOptions): Promise<Checkpoint[]>;
+    listIds(): Promise<string[]>;
+    clear(): Promise<void>;
+}
+/**
+ * Postgres checkpoint provider (interface for external implementation)
+ *
+ * This is a stub demonstrating the interface. Actual implementation
+ * would require a postgres driver like 'pg' or 'psycopg2'.
+ *
+ * Usage with external Postgres:
+ *   const pool = new Pool({...});
+ *   const provider = new PostgresCheckpointProvider(pool);
+ *   await provider.init(); // Create tables
+ */
+export declare class PostgresCheckpointProvider implements ICheckpointProvider {
+    private readonly pool;
+    private readonly tableName;
+    constructor(pool: any, tableName?: string);
+    /**
+     * Initialize database schema (must be called once)
+     */
+    init(): Promise<void>;
+    save(checkpoint: Checkpoint): Promise<void>;
+    load(id: string): Promise<Checkpoint | undefined>;
+    delete(id: string): Promise<boolean>;
+    query(options: CheckpointQueryOptions): Promise<Checkpoint[]>;
+    listIds(): Promise<string[]>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=checkpointer-backends.d.ts.map

package/dist/libs/checkpointer-backends.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpointer-backends.d.ts","sourceRoot":"","sources":["../../src/libs/checkpointer-backends.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE/F;;GAEG;AACH,qBAAa,sBAAuB,YAAW,mBAAmB;IAChE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,KAAK,CAAkC;gBAEnC,OAAO,GAAE,MAAuB;IAO5C;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACH,OAAO,CAAC,SAAS;IAajB;;OAEG;IACH,OAAO,CAAC,SAAS;IAKjB;;OAEG;IACH,OAAO,CAAC,YAAY;IAsBpB;;OAEG;IACH,OAAO,CAAC,WAAW;IAMb,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAc3C,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAsBjD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBpC,KAAK,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IA+D7D,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAI5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB5B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAe/B;AAED;;;;;;;;;GASG;AACH,qBAAa,uBAAwB,YAAW,mBAAmB;IACjE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAM;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,EAAE,GAAG,EAAE,SAAS,GAAE,MAAsB;IAKpD,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAkC3C,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAoBjD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBpC,KAAK,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAsE7D,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAO5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAM7B;AAED;;;;;;;;;;GAUG;AACH,qBAAa,0BAA2B,YAAW,mBAAmB;IACpE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAM;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,IAAI,EAAE,GAAG,EAAE,SAAS,GAAE,MAAsB;IAKxD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BrB,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB3C,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAkBjD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMpC,KAAK,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAiE7D,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAM5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}