trellis/dist/plugins/sprite-tools/checkpoint-middleware.d.ts

Agentic State Engine — event-sourced causal graph with branching, decision traces, and realtime sync for AI-native applications

/**
 * Checkpoint Middleware — Deterministic auto-checkpointing before large mutations.
 *
 * Counts facts + links in each mutation and triggers a kernel checkpoint when
 * a batch exceeds a configurable threshold. This ensures safety-critical
 * behavior is deterministic (middleware), not dependent on LLM prompt
 * compliance.
 *
 * @module trellis/plugins/sprite-tools
 */
import type { KernelMiddleware } from '../../core/kernel/middleware.js';
export interface CheckpointMiddlewareConfig {
    /**
     * Trigger a checkpoint when a single mutation batch contains this many
     * or more combined facts + links (adds + deletes).
     * Default: 50.
     */
    threshold?: number;
    /**
     * Callback invoked when a checkpoint is auto-triggered.
     * Useful for logging or notification.
     */
    onCheckpoint?: (batchSize: number) => void;
}
/**
 * Create a CheckpointMiddleware instance.
 *
 * The middleware hooks into `handleOp`. It inspects each op's payload size
 * and if it exceeds the threshold, calls `checkpoint()` on the kernel
 * *before* the op proceeds through the chain.
 *
 * Because the middleware only has access to the op and the `next` function
 * (not the kernel directly), the actual checkpoint call is deferred to the
 * caller via the `onCheckpoint` callback. The caller should wire this to
 * `kernel.checkpoint()`.
 */
export declare function createCheckpointMiddleware(config?: CheckpointMiddlewareConfig): KernelMiddleware & {
    getStats: () => {
        checkpointsTriggered: number;
        lastBatchSize: number;
    };
};
//# sourceMappingURL=checkpoint-middleware.d.ts.map