tuff-lil-unit 0.1.0

package/dist/rate-limit.js

@@ -0,0 +1,52 @@
+export class RateLimiter {
+    #rpm;
+    #tpm;
+    #requestTokens;
+    #tokenBucketTokens;
+    #lastRefill;
+    constructor(config) {
+        this.#rpm = config.rpm;
+        this.#tpm = config.tpm;
+        this.#requestTokens = config.rpm;
+        this.#tokenBucketTokens = config.tpm;
+        this.#lastRefill = Date.now();
+    }
+    tryAcquire(estimatedTokens = 0) {
+        this.#refill();
+        if (this.#rpm === 0 && this.#tpm === 0)
+            return true;
+        const needsRequest = this.#rpm > 0;
+        const needsTokens = this.#tpm > 0 && estimatedTokens > 0;
+        const hasRequestCapacity = !needsRequest || this.#requestTokens >= 1;
+        const hasTokenCapacity = !needsTokens || this.#tokenBucketTokens >= estimatedTokens;
+        if (hasRequestCapacity && hasTokenCapacity) {
+            if (needsRequest)
+                this.#requestTokens -= 1;
+            if (needsTokens)
+                this.#tokenBucketTokens -= estimatedTokens;
+            return true;
+        }
+        return false;
+    }
+    release(actualTokens) {
+        // Token bucket already consumed estimated tokens in tryAcquire
+        // This method could be used to adjust if actual differs from estimated
+        // For now, no-op as we pre-consume estimated tokens
+    }
+    #refill() {
+        const now = Date.now();
+        const elapsedMs = now - this.#lastRefill;
+        if (elapsedMs <= 0)
+            return;
+        if (this.#rpm > 0) {
+            const requestRefill = (this.#rpm / 60000) * elapsedMs;
+            this.#requestTokens = Math.min(this.#requestTokens + requestRefill, this.#rpm);
+        }
+        if (this.#tpm > 0) {
+            const tokenRefill = (this.#tpm / 60000) * elapsedMs;
+            this.#tokenBucketTokens = Math.min(this.#tokenBucketTokens + tokenRefill, this.#tpm);
+        }
+        this.#lastRefill = now;
+    }
+}
+//# sourceMappingURL=rate-limit.js.map

package/dist/rate-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.js","sourceRoot":"","sources":["../src/rate-limit.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,WAAW;IACtB,IAAI,CAAS;IACb,IAAI,CAAS;IACb,cAAc,CAAS;IACvB,kBAAkB,CAAS;IAC3B,WAAW,CAAS;IAEpB,YAAY,MAAiB;QAC3B,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC;QACjC,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC;QACrC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAChC,CAAC;IAED,UAAU,CAAC,kBAA0B,CAAC;QACpC,IAAI,CAAC,OAAO,EAAE,CAAC;QAEf,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEpD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACnC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,eAAe,GAAG,CAAC,CAAC;QAEzD,MAAM,kBAAkB,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC;QACrE,MAAM,gBAAgB,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,kBAAkB,IAAI,eAAe,CAAC;QAEpF,IAAI,kBAAkB,IAAI,gBAAgB,EAAE,CAAC;YAC3C,IAAI,YAAY;gBAAE,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC;YAC3C,IAAI,WAAW;gBAAE,IAAI,CAAC,kBAAkB,IAAI,eAAe,CAAC;YAC5D,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,CAAC,YAAoB;QAC1B,+DAA+D;QAC/D,uEAAuE;QACvE,oDAAoD;IACtD,CAAC;IAED,OAAO;QACL,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,SAAS,GAAG,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC;QAEzC,IAAI,SAAS,IAAI,CAAC;YAAE,OAAO;QAE3B,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAClB,MAAM,aAAa,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,SAAS,CAAC;YACtD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,GAAG,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACjF,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAClB,MAAM,WAAW,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,SAAS,CAAC;YACpD,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,GAAG,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACvF,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC;IACzB,CAAC;CACF"}

package/dist/retry.d.ts

@@ -0,0 +1,12 @@
+import type { Options as PRetryOptions } from 'p-retry';
+export interface ErrorClassification {
+    type: 'rate_limit' | 'transient' | 'token_limit' | 'budget_exceeded' | 'permanent';
+    retriable: boolean;
+    retryAfterMs?: number;
+}
+export declare function classifyError(error: unknown): ErrorClassification;
+/** Returns p-retry options using classifyError to decide retriability and respect Retry-After. */
+export declare function createRetryConfig(opts?: {
+    maxRetries?: number;
+}): PRetryOptions;
+//# sourceMappingURL=retry.d.ts.map

package/dist/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAgB,MAAM,SAAS,CAAC;AAEtE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,YAAY,GAAG,WAAW,GAAG,aAAa,GAAG,iBAAiB,GAAG,WAAW,CAAC;IACnF,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAkDjE;AAED,kGAAkG;AAClG,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CAmB/E"}

package/dist/retry.js

@@ -0,0 +1,59 @@
+export function classifyError(error) {
+    if (!error) {
+        return { type: 'permanent', retriable: false };
+    }
+    // Check for enhanced error types with retryAfterMs
+    if (error instanceof Error && 'retryAfterMs' in error) {
+        const retryAfterMs = error.retryAfterMs;
+        return {
+            type: 'rate_limit',
+            retriable: true,
+            retryAfterMs,
+        };
+    }
+    const errorObj = error;
+    const message = String(errorObj.message || error).toLowerCase();
+    if (errorObj.status === 429 || message.includes('rate limit')) {
+        return { type: 'rate_limit', retriable: true };
+    }
+    if (message.includes('token limit') ||
+        message.includes('context limit') ||
+        message.includes('maximum context') ||
+        message.includes('too many tokens')) {
+        return { type: 'token_limit', retriable: false };
+    }
+    if (message.includes('budget exceeded')) {
+        return { type: 'budget_exceeded', retriable: false };
+    }
+    // AbortError from per-request timeouts (AbortController pattern) — retriable
+    // Note: pipeline-level aborts are handled separately in context.ts (signal check)
+    if (errorObj.name === 'AbortError' || message.includes('timed out')) {
+        return { type: 'transient', retriable: true };
+    }
+    if (typeof errorObj.status === 'number' &&
+        errorObj.status >= 500 &&
+        errorObj.status < 600) {
+        return { type: 'transient', retriable: true };
+    }
+    return { type: 'permanent', retriable: false };
+}
+/** Returns p-retry options using classifyError to decide retriability and respect Retry-After. */
+export function createRetryConfig(opts) {
+    return {
+        retries: opts?.maxRetries ?? 3,
+        factor: 2,
+        minTimeout: 1000,
+        maxTimeout: 60_000,
+        shouldRetry: (context) => {
+            const classification = classifyError(context.error);
+            return classification.retriable;
+        },
+        onFailedAttempt: async (context) => {
+            const classification = classifyError(context.error);
+            if (classification.retriable && classification.retryAfterMs && context.retriesLeft > 0) {
+                await new Promise((resolve) => setTimeout(resolve, classification.retryAfterMs));
+            }
+        },
+    };
+}
+//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

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

package/dist/schema-sync.d.ts

@@ -0,0 +1,7 @@
+import type Database from 'better-sqlite3';
+/**
+ * Sync schema to DB — creates new tables via IF NOT EXISTS, adds new columns
+ * via PRAGMA table_info diffing + ALTER TABLE ADD COLUMN.
+ */
+export declare function syncSchema(db: Database.Database, statements: string[]): void;
+//# sourceMappingURL=schema-sync.d.ts.map

package/dist/schema-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-sync.d.ts","sourceRoot":"","sources":["../src/schema-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAM3C;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,CA8B5E"}

package/dist/schema-sync.js

@@ -0,0 +1,32 @@
+/**
+ * Sync schema to DB — creates new tables via IF NOT EXISTS, adds new columns
+ * via PRAGMA table_info diffing + ALTER TABLE ADD COLUMN.
+ */
+export function syncSchema(db, statements) {
+    for (const sql of statements) {
+        db.exec(sql);
+        // After CREATE TABLE IF NOT EXISTS, diff columns for additive migrations
+        const match = sql.match(/CREATE\s+TABLE\s+IF\s+NOT\s+EXISTS\s+(\w+)/i);
+        if (!match)
+            continue;
+        const tableName = match[1];
+        const existingCols = new Set(db.prepare(`PRAGMA table_info('${tableName}')`).all()
+            .map((c) => c.name));
+        // Parse column definitions — strip table constraints before splitting on commas
+        const bodyMatch = sql.match(/\(([^]*)\)/);
+        if (!bodyMatch)
+            continue;
+        // Remove PRIMARY KEY(...) and similar table constraints before comma-splitting
+        const body = bodyMatch[1].replace(/,?\s*PRIMARY\s+KEY\s*\([^)]*\)/gi, '');
+        for (const line of body.split(',')) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            const colName = trimmed.split(/\s+/)[0];
+            if (!existingCols.has(colName)) {
+                db.exec(`ALTER TABLE ${tableName} ADD COLUMN ${trimmed}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=schema-sync.js.map

package/dist/schema-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-sync.js","sourceRoot":"","sources":["../src/schema-sync.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,EAAqB,EAAE,UAAoB;IACpE,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEb,yEAAyE;QACzE,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACvE,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QAE5B,MAAM,YAAY,GAAG,IAAI,GAAG,CACzB,EAAE,CAAC,OAAO,CAAC,sBAAsB,SAAS,IAAI,CAAC,CAAC,GAAG,EAAmB;aACpE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CACtB,CAAC;QAEF,gFAAgF;QAChF,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC1C,IAAI,CAAC,SAAS;YAAE,SAAS;QAEzB,+EAA+E;QAC/E,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,kCAAkC,EAAE,EAAE,CAAC,CAAC;QAE3E,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO;gBAAE,SAAS;YACvB,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,CAAC;YACzC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/B,EAAE,CAAC,IAAI,CAAC,eAAe,SAAS,eAAe,OAAO,EAAE,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,24 @@
+export declare const SCHEMA_SQL: string[];
+export interface TuffRun {
+    id: string;
+    config: string | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface TuffStep {
+    run_id: string;
+    step_id: string;
+    output: string;
+    usage_input: number;
+    usage_output: number;
+    duration_ms: number | null;
+    created_at: string;
+}
+export interface TuffStepFailure {
+    run_id: string;
+    step_id: string;
+    error: string;
+    duration_ms: number | null;
+    created_at: string;
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,UAyBtB,CAAC;AAEF,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/schema.js

@@ -0,0 +1,27 @@
+export const SCHEMA_SQL = [
+    `CREATE TABLE IF NOT EXISTS tuff_runs (
+    id TEXT PRIMARY KEY,
+    config TEXT,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+  )`,
+    `CREATE TABLE IF NOT EXISTS tuff_steps (
+    run_id TEXT NOT NULL,
+    step_id TEXT NOT NULL,
+    output TEXT NOT NULL,
+    usage_input INTEGER NOT NULL DEFAULT 0,
+    usage_output INTEGER NOT NULL DEFAULT 0,
+    duration_ms INTEGER,
+    created_at TEXT NOT NULL,
+    PRIMARY KEY (run_id, step_id)
+  )`,
+    `CREATE TABLE IF NOT EXISTS tuff_step_failures (
+    run_id TEXT NOT NULL,
+    step_id TEXT NOT NULL,
+    error TEXT NOT NULL,
+    duration_ms INTEGER,
+    created_at TEXT NOT NULL,
+    PRIMARY KEY (run_id, step_id)
+  )`,
+];
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB;;;;;IAKE;IACF;;;;;;;;;IASE;IACF;;;;;;;IAOE;CACH,CAAC"}

package/dist/state.d.ts

@@ -0,0 +1,28 @@
+import type Database from 'better-sqlite3';
+import type { TuffRun, TuffStepFailure } from './schema.js';
+import type { TokenUsage } from './types.js';
+export declare class StateManager {
+    #private;
+    constructor(db: Database.Database, runId: string);
+    initRun(id: string, config: unknown): void;
+    getRun(id: string): TuffRun | undefined;
+    /**
+     * Returns the deserialized output for a step, or undefined if not found.
+     * Step functions must return JSON-serializable values — Date, Buffer, and
+     * class instances silently corrupt on round-trip.
+     */
+    getStep(stepId: string): unknown;
+    setStep(stepId: string, output: unknown, usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    }, durationMs?: number): void;
+    setStepFailure(stepId: string, error: string, durationMs?: number): void;
+    getStepFailure(stepId: string): TuffStepFailure | undefined;
+    /** Purge cached output + failure for a step — used by force invalidation. */
+    deleteStep(stepId: string): void;
+    /** Total steps completed in the previous run — seeds progress prediction on resume. */
+    getStepCount(): number;
+    /** Sums token usage across all completed steps — used to restore BudgetManager on resume. */
+    getUsageSummary(): TokenUsage;
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,qBAAa,YAAY;;gBAIX,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM;IAKhD,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAO1C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIvC;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAShC,OAAO,CACL,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EACf,KAAK,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,EACrD,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI;IAoCP,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAYxE,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAM3D,6EAA6E;IAC7E,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAWhC,uFAAuF;IACvF,YAAY,IAAI,MAAM;IAOtB,6FAA6F;IAC7F,eAAe,IAAI,UAAU;CAU9B"}

package/dist/state.js

@@ -0,0 +1,86 @@
+export class StateManager {
+    #db;
+    #runId;
+    constructor(db, runId) {
+        this.#db = db;
+        this.#runId = runId;
+    }
+    initRun(id, config) {
+        const now = new Date().toISOString();
+        this.#db.prepare('INSERT INTO tuff_runs (id, config, created_at, updated_at) VALUES (?, ?, ?, ?)').run(id, JSON.stringify(config), now, now);
+    }
+    getRun(id) {
+        return this.#db.prepare('SELECT * FROM tuff_runs WHERE id = ?').get(id);
+    }
+    /**
+     * Returns the deserialized output for a step, or undefined if not found.
+     * Step functions must return JSON-serializable values — Date, Buffer, and
+     * class instances silently corrupt on round-trip.
+     */
+    getStep(stepId) {
+        const row = this.#db.prepare('SELECT output FROM tuff_steps WHERE run_id = ? AND step_id = ?').get(this.#runId, stepId);
+        if (!row)
+            return undefined;
+        return JSON.parse(row.output);
+    }
+    setStep(stepId, output, usage, durationMs) {
+        // Provider outputs are already JSON-safe: generateText returns strings,
+        // generateObject validates through zod. This guard only catches raw step
+        // callbacks returning functions/symbols (→ JSON.stringify returns undefined).
+        // Date/Map/Set produce valid-but-lossy JSON — user's responsibility per JSDoc.
+        const serialized = JSON.stringify(output);
+        if (serialized === undefined) {
+            throw new Error(`Step '${stepId}' returned a non-JSON-serializable value (function or symbol)`);
+        }
+        const now = new Date().toISOString();
+        // Atomically write success + clear any prior failure record
+        this.#db.transaction(() => {
+            this.#db.prepare(`
+        INSERT INTO tuff_steps (run_id, step_id, output, usage_input, usage_output, duration_ms, created_at)
+        VALUES (?, ?, ?, ?, ?, ?, ?)
+        ON CONFLICT (run_id, step_id) DO UPDATE SET
+          output = excluded.output,
+          usage_input = excluded.usage_input,
+          usage_output = excluded.usage_output,
+          duration_ms = excluded.duration_ms,
+          created_at = excluded.created_at
+      `).run(this.#runId, stepId, serialized, usage?.inputTokens ?? 0, usage?.outputTokens ?? 0, durationMs ?? null, now);
+            this.#db.prepare('DELETE FROM tuff_step_failures WHERE run_id = ? AND step_id = ?').run(this.#runId, stepId);
+        })();
+    }
+    setStepFailure(stepId, error, durationMs) {
+        const now = new Date().toISOString();
+        this.#db.prepare(`
+      INSERT INTO tuff_step_failures (run_id, step_id, error, duration_ms, created_at)
+      VALUES (?, ?, ?, ?, ?)
+      ON CONFLICT (run_id, step_id) DO UPDATE SET
+        error = excluded.error,
+        duration_ms = excluded.duration_ms,
+        created_at = excluded.created_at
+    `).run(this.#runId, stepId, error, durationMs ?? null, now);
+    }
+    getStepFailure(stepId) {
+        return this.#db.prepare('SELECT * FROM tuff_step_failures WHERE run_id = ? AND step_id = ?').get(this.#runId, stepId);
+    }
+    /** Purge cached output + failure for a step — used by force invalidation. */
+    deleteStep(stepId) {
+        this.#db.transaction(() => {
+            this.#db.prepare('DELETE FROM tuff_steps WHERE run_id = ? AND step_id = ?').run(this.#runId, stepId);
+            this.#db.prepare('DELETE FROM tuff_step_failures WHERE run_id = ? AND step_id = ?').run(this.#runId, stepId);
+        })();
+    }
+    /** Total steps completed in the previous run — seeds progress prediction on resume. */
+    getStepCount() {
+        const row = this.#db.prepare('SELECT COUNT(*) AS count FROM tuff_steps WHERE run_id = ?').get(this.#runId);
+        return row.count;
+    }
+    /** Sums token usage across all completed steps — used to restore BudgetManager on resume. */
+    getUsageSummary() {
+        const row = this.#db.prepare('SELECT COALESCE(SUM(usage_input), 0) AS input_total, COALESCE(SUM(usage_output), 0) AS output_total FROM tuff_steps WHERE run_id = ?').get(this.#runId);
+        return {
+            inputTokens: row.input_total,
+            outputTokens: row.output_total,
+        };
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

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

package/dist/tuff.d.ts

@@ -0,0 +1,8 @@
+import { Context } from './context.js';
+import type { DurableConfig } from './types.js';
+/**
+ * Run a durable pipeline with step memoization. Call again with the same id to
+ * resume — cached steps return instantly, execution continues from first uncached step.
+ */
+export declare function tuff<T>(id: string, config: DurableConfig, fn: (ctx: Context) => Promise<T>): Promise<T>;
+//# sourceMappingURL=tuff.d.ts.map

package/dist/tuff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tuff.d.ts","sourceRoot":"","sources":["../src/tuff.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAIvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,wBAAsB,IAAI,CAAC,CAAC,EAC1B,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,aAAa,EACrB,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC,CAgEZ"}

package/dist/tuff.js

@@ -0,0 +1,73 @@
+import Database from 'better-sqlite3';
+import { mkdirSync } from 'node:fs';
+import { BudgetManager } from './budget.js';
+import { Context } from './context.js';
+import { SCHEMA_SQL } from './schema.js';
+import { syncSchema } from './schema-sync.js';
+import { StateManager } from './state.js';
+/**
+ * Run a durable pipeline with step memoization. Call again with the same id to
+ * resume — cached steps return instantly, execution continues from first uncached step.
+ */
+export async function tuff(id, config, fn) {
+    if (!id)
+        throw new Error('tuff: id must be a non-empty string');
+    if (!config.stateDir)
+        throw new Error('tuff: stateDir is required');
+    if (config.concurrency !== undefined && (config.concurrency < 1 || !Number.isInteger(config.concurrency))) {
+        throw new Error('tuff: concurrency must be a positive integer');
+    }
+    if (config.budget?.tokens !== undefined && config.budget.tokens < 1) {
+        throw new Error('tuff: budget.tokens must be positive');
+    }
+    const controller = new AbortController();
+    const onSignal = () => controller.abort();
+    if (config.handleProcessSignals) {
+        process.on('SIGTERM', onSignal);
+        process.on('SIGINT', onSignal);
+    }
+    mkdirSync(config.stateDir, { recursive: true });
+    const db = new Database(`${config.stateDir}/tuff.db`);
+    db.pragma('journal_mode = WAL');
+    db.pragma('busy_timeout = 5000');
+    syncSchema(db, [...SCHEMA_SQL, ...(config.setup ?? [])]);
+    const state = new StateManager(db, id);
+    // Resume detection: if run exists, continue; otherwise initialize
+    const existingRun = state.getRun(id);
+    if (!existingRun) {
+        const { setup: _setup, ...serializableConfig } = config;
+        state.initRun(id, serializableConfig);
+    }
+    // Restore budget from prior run so remaining budget is accurate on resume
+    const budgetManager = new BudgetManager(config.budget);
+    const priorUsage = state.getUsageSummary();
+    if (priorUsage.inputTokens > 0 || priorUsage.outputTokens > 0) {
+        budgetManager.consume(priorUsage);
+    }
+    const ctx = new Context({
+        id,
+        concurrency: config.concurrency ?? 5,
+        onProgress: config.onProgress,
+        signal: controller.signal,
+        state,
+        budgetManager,
+        db,
+    });
+    try {
+        return await fn(ctx);
+    }
+    catch (error) {
+        // Log before aborting — queued steps will throw AbortError, masking this root cause
+        console.error('[tuff] Pipeline error:', error);
+        controller.abort();
+        throw error;
+    }
+    finally {
+        if (config.handleProcessSignals) {
+            process.off('SIGTERM', onSignal);
+            process.off('SIGINT', onSignal);
+        }
+        db.close();
+    }
+}
+//# sourceMappingURL=tuff.js.map

package/dist/tuff.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,49 @@
+export interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens?: number;
+    cacheReadTokens?: number;
+}
+export interface ProviderResult {
+    output: unknown;
+    usage: TokenUsage;
+    durationMs: number;
+}
+export interface Progress {
+    stage: string;
+    completed: number;
+    total: number;
+    usage: {
+        tokens: number;
+    };
+}
+/** Per-step budget limits — controls token spend on individual steps. */
+export interface StepBudget {
+    /** Cap output tokens (API-enforced for LLM providers, total-token kill-threshold for Claude CLI). */
+    maxTokens?: number;
+    /** Pre-call input token check — refuses execution if estimated input exceeds limit. */
+    maxInputTokens?: number;
+    /** Behavior when post-call actual usage exceeds limits. Default: 'throw'. */
+    onExceed?: 'throw' | 'warn';
+    /** Override the default chars/4 estimator for pre-call input checks. */
+    tokenEstimator?: (text: string) => number;
+}
+export interface DurableConfig {
+    stateDir: string;
+    /** Max steps to run in parallel. Defaults to 5 — conservative for rate-limited LLM APIs. */
+    concurrency?: number;
+    budget?: {
+        tokens: number;
+    };
+    onProgress?: (progress: Progress) => void;
+    /** Register SIGTERM/SIGINT handlers for graceful abort. Default: false. */
+    handleProcessSignals?: boolean;
+    /**
+     * Additional SQL CREATE TABLE statements to execute at startup.
+     * @example
+     * const setup = ['CREATE TABLE IF NOT EXISTS pages (url TEXT PRIMARY KEY, title TEXT)'];
+     * tuff('id', { stateDir, setup }, async (ctx) => { ... });
+     */
+    setup?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAGD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAGD,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3B;AAED,yEAAyE;AACzE,MAAM,WAAW,UAAU;IACzB,qGAAqG;IACrG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC5B,wEAAwE;IACxE,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAC3C;AAGD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,4FAA4F;IAC5F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC1C,2EAA2E;IAC3E,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/upsert.d.ts

@@ -0,0 +1,9 @@
+import type Database from 'better-sqlite3';
+/** JSON.stringify arrays and plain objects; coerce booleans to 0/1; primitives pass through. */
+export declare function autoStringify(row: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Upsert a row: auto-stringify objects/arrays, build conflict update from non-PK columns.
+ * Row keys must match SQL column names (snake_case).
+ */
+export declare function upsertRow(db: Database.Database, table: string, row: Record<string, unknown>, updateColumns?: string[]): void;
+//# sourceMappingURL=upsert.d.ts.map

package/dist/upsert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upsert.d.ts","sourceRoot":"","sources":["../src/upsert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAO3C,gGAAgG;AAChG,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYnF;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,IAAI,CAyBN"}

package/dist/upsert.js

@@ -0,0 +1,42 @@
+/** JSON.stringify arrays and plain objects; coerce booleans to 0/1; primitives pass through. */
+export function autoStringify(row) {
+    const out = {};
+    for (const [k, v] of Object.entries(row)) {
+        if (typeof v === 'boolean') {
+            out[k] = v ? 1 : 0;
+        }
+        else if (Array.isArray(v) || (v !== null && typeof v === 'object' && v.constructor === Object)) {
+            out[k] = JSON.stringify(v);
+        }
+        else {
+            out[k] = v;
+        }
+    }
+    return out;
+}
+/**
+ * Upsert a row: auto-stringify objects/arrays, build conflict update from non-PK columns.
+ * Row keys must match SQL column names (snake_case).
+ */
+export function upsertRow(db, table, row, updateColumns) {
+    const stringified = autoStringify(row);
+    const columns = db.prepare(`PRAGMA table_info('${table}')`).all();
+    const pkNames = new Set(columns.filter((c) => c.pk > 0).map((c) => c.name));
+    if (pkNames.size === 0) {
+        throw new Error(`No primary key found on table "${table}"`);
+    }
+    const colNames = Object.keys(stringified);
+    const values = Object.values(stringified);
+    const placeholders = colNames.map(() => '?').join(', ');
+    // Build SET clause: either explicit updateColumns or all non-PK columns present in row
+    const updateCols = updateColumns
+        ? updateColumns.filter((c) => c in stringified)
+        : colNames.filter((c) => !pkNames.has(c));
+    const setClause = updateCols.map((c) => `${c} = excluded.${c}`).join(', ');
+    const pkList = [...pkNames].join(', ');
+    const sql = setClause
+        ? `INSERT INTO ${table} (${colNames.join(', ')}) VALUES (${placeholders}) ON CONFLICT (${pkList}) DO UPDATE SET ${setClause}`
+        : `INSERT INTO ${table} (${colNames.join(', ')}) VALUES (${placeholders}) ON CONFLICT (${pkList}) DO NOTHING`;
+    db.prepare(sql).run(...values);
+}
+//# sourceMappingURL=upsert.js.map

package/dist/upsert.js.map

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

package/dist/workflow.d.ts

@@ -0,0 +1,12 @@
+import type { Job, WorkflowConfig, WorkflowResult } from './types.js';
+export declare class Workflow {
+    #private;
+    constructor(config: WorkflowConfig);
+    static resume(config: WorkflowConfig, options?: {
+        retryFailed?: boolean;
+        ignoreVersionMismatch?: boolean;
+    }): Workflow;
+    addJob(job: Job): void;
+    run(): Promise<WorkflowResult>;
+}
+//# sourceMappingURL=workflow.d.ts.map

package/dist/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAyB,cAAc,EAAE,cAAc,EAAiB,MAAM,YAAY,CAAC;AAS5G,qBAAa,QAAQ;;gBAcP,MAAM,EAAE,cAAc;IAqBlC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAC;QAAC,qBAAqB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,QAAQ;IA0HrH,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI;IAwIhB,GAAG,IAAI,OAAO,CAAC,cAAc,CAAC;CA6RrC"}