@almadar/agent 1.6.3 → 2.0.0

package/dist/firestore-checkpointer-CkNKXoun.d.ts

@@ -1,184 +0,0 @@
-import { BaseCheckpointSaver, CheckpointTuple, CheckpointListOptions, Checkpoint, CheckpointMetadata, PendingWrite } from '@langchain/langgraph-checkpoint';
-import { RunnableConfig } from '@langchain/core/runnables';
-
-/**
- * Persistence Types
- *
- * Interfaces for pluggable persistence backends.
- * Consumers provide implementations (memory, Firestore, etc.)
- */
-/**
- * Session metadata stored by any backend.
- */
-interface SessionMetadata {
-    skill: string;
-    workDir: string;
-    createdAt: number;
-    lastActivityAt: number;
-    /** If true, auto-approve all future interrupts without user interaction */
-    approveAll?: boolean;
-}
-/**
- * Session record with thread ID (for listing).
- */
-interface SessionRecord extends SessionMetadata {
-    threadId: string;
-}
-/**
- * Persistence mode for agent sessions.
- * - 'memory': In-memory storage (default, lost on restart)
- * - 'firestore': Firestore-backed storage (persistent)
- */
-type PersistenceMode = 'memory' | 'firestore';
-/**
- * Session data for Firestore storage.
- */
-interface Session {
-    threadId: string;
-    skill: string;
-    workDir: string;
-    userId?: string;
-    createdAt: Date;
-    lastActivityAt: Date;
-}
-
-/**
- * Firestore Checkpointer for LangGraph
- *
- * Custom implementation of BaseCheckpointSaver using Firebase Firestore.
- * This is required because LangGraph only provides Postgres/Redis savers.
- *
- * IMPORTANT: This module does NOT import firebase-admin directly.
- * The Firestore `db` instance must be injected via constructor options.
- * This keeps the @almadar/agent package free of firebase-admin as a direct dependency.
- */
-
-/**
- * Minimal Firestore interface to avoid importing firebase-admin.
- * Consumers pass their own Firestore instance.
- */
-interface FirestoreDb {
-    collection(path: string): FirestoreCollectionRef;
-    batch(): FirestoreBatch;
-}
-interface FirestoreCollectionRef {
-    doc(id: string): FirestoreDocRef;
-    where(field: string, op: string, value: unknown): FirestoreQuery;
-    orderBy(field: string, direction?: string): FirestoreQuery;
-    limit(n: number): FirestoreQuery;
-}
-interface FirestoreDocRef {
-    set(data: unknown): Promise<unknown>;
-    get(): Promise<FirestoreDocSnapshot>;
-    update(data: unknown): Promise<unknown>;
-    delete(): Promise<unknown>;
-    readonly ref: unknown;
-}
-interface FirestoreDocSnapshot {
-    exists: boolean;
-    data(): Record<string, unknown> | undefined;
-    readonly ref: unknown;
-}
-interface FirestoreQuery {
-    where(field: string, op: string, value: unknown): FirestoreQuery;
-    orderBy(field: string, direction?: string): FirestoreQuery;
-    limit(n: number): FirestoreQuery;
-    startAfter(doc: unknown): FirestoreQuery;
-    get(): Promise<FirestoreQuerySnapshot>;
-}
-interface FirestoreQuerySnapshot {
-    empty: boolean;
-    docs: FirestoreQueryDocSnapshot[];
-    size: number;
-}
-interface FirestoreQueryDocSnapshot {
-    data(): Record<string, unknown>;
-    readonly ref: unknown;
-}
-interface FirestoreBatch {
-    set(ref: unknown, data: unknown): void;
-    delete(ref: unknown): void;
-    commit(): Promise<unknown>;
-}
-/**
- * Firestore Timestamp-like interface.
- */
-interface FirestoreTimestamp {
-    toDate(): Date;
-}
-/**
- * Options for FirestoreCheckpointer.
- */
-interface FirestoreCheckpointerOptions {
-    /**
-     * Firestore instance. Required — injected by consumer.
-     */
-    db: FirestoreDb;
-    /**
-     * Collection name for checkpoints.
-     * @default 'agent_checkpoints'
-     */
-    checkpointsCollection?: string;
-    /**
-     * Collection name for pending writes.
-     * @default 'agent_writes'
-     */
-    writesCollection?: string;
-}
-/**
- * Firestore-backed checkpointer for LangGraph agents.
- *
- * Provides persistent checkpoint storage across server restarts.
- * Thread checkpoints are stored as Firestore documents.
- *
- * @example
- * ```typescript
- * import { getFirestore } from 'firebase-admin/firestore';
- *
- * const checkpointer = new FirestoreCheckpointer({
- *   db: getFirestore(),
- *   checkpointsCollection: 'agent_checkpoints',
- * });
- *
- * const agent = createDeepAgent({
- *   // ...
- *   checkpointer,
- * });
- * ```
- */
-declare class FirestoreCheckpointer extends BaseCheckpointSaver {
-    private db;
-    private checkpointsCollection;
-    private writesCollection;
-    constructor(options: FirestoreCheckpointerOptions);
-    /**
-     * Get thread ID from config.
-     */
-    private getThreadId;
-    /**
-     * Get checkpoint ID from config, or undefined for latest.
-     */
-    private getCheckpointId;
-    /**
-     * Get checkpoint by config.
-     */
-    getTuple(config: RunnableConfig): Promise<CheckpointTuple | undefined>;
-    /**
-     * List checkpoints for a thread.
-     */
-    list(config: RunnableConfig, options?: CheckpointListOptions): AsyncGenerator<CheckpointTuple>;
-    /**
-     * Save a checkpoint.
-     */
-    put(config: RunnableConfig, checkpoint: Checkpoint, metadata: CheckpointMetadata, _newVersions: Record<string, number | string>): Promise<RunnableConfig>;
-    /**
-     * Store pending writes for a checkpoint.
-     */
-    putWrites(config: RunnableConfig, writes: PendingWrite[], taskId: string): Promise<void>;
-    /**
-     * Delete all checkpoints and writes for a thread.
-     */
-    deleteThread(threadId: string): Promise<void>;
-}
-
-export { FirestoreCheckpointer as F, type PersistenceMode as P, type SessionMetadata as S, type FirestoreCheckpointerOptions as a, type FirestoreDb as b, type FirestoreTimestamp as c, type Session as d, type SessionRecord as e };