@grimoirelabs/core 0.1.0

package/dist/runtime/sqlite-state-store.js

@@ -0,0 +1,180 @@
+/**
+ * SQLite-based StateStore implementation
+ * Uses bun:sqlite when available, otherwise falls back to better-sqlite3.
+ */
+import { mkdirSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname } from "node:path";
+const DEFAULT_DB_PATH = ".grimoire/grimoire.db";
+const DEFAULT_MAX_RUNS = 100;
+class BetterSqliteAdapter {
+    db;
+    constructor(dbPath) {
+        const BetterSqlite = loadBetterSqlite3();
+        this.db = new BetterSqlite(dbPath);
+    }
+    exec(sql) {
+        this.db.exec(sql);
+    }
+    query(sql) {
+        const stmt = this.db.prepare(sql);
+        return {
+            get: (...params) => stmt.get(...params),
+            all: (...params) => stmt.all(...params),
+            run: (...params) => {
+                stmt.run(...params);
+            },
+        };
+    }
+    transaction(fn) {
+        const wrapped = this.db.transaction(fn);
+        return () => {
+            wrapped();
+        };
+    }
+    close() {
+        this.db.close();
+    }
+}
+function loadBetterSqlite3() {
+    const require = createRequire(import.meta.url);
+    try {
+        return require("better-sqlite3");
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`SqliteStateStore requires bun:sqlite (Bun) or better-sqlite3 (Node). Install better-sqlite3 to use SqliteStateStore in Node (npm i better-sqlite3). (${message})`);
+    }
+}
+function createDatabase(dbPath) {
+    const isBun = typeof globalThis.Bun !== "undefined";
+    if (isBun) {
+        const require = createRequire(import.meta.url);
+        const { Database } = require("bun:sqlite");
+        return new Database(dbPath);
+    }
+    return new BetterSqliteAdapter(dbPath);
+}
+export class SqliteStateStore {
+    db;
+    maxRuns;
+    constructor(options = {}) {
+        const dbPath = options.dbPath ?? DEFAULT_DB_PATH;
+        this.maxRuns = options.maxRuns ?? DEFAULT_MAX_RUNS;
+        // Ensure parent directory exists
+        mkdirSync(dirname(dbPath), { recursive: true });
+        this.db = createDatabase(dbPath);
+        this.db.exec("PRAGMA journal_mode = WAL");
+        this.initSchema();
+    }
+    initSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS spell_state (
+        spell_id TEXT PRIMARY KEY,
+        state TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS runs (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        spell_id TEXT NOT NULL,
+        run_id TEXT NOT NULL,
+        timestamp TEXT NOT NULL,
+        success INTEGER NOT NULL,
+        error TEXT,
+        duration INTEGER NOT NULL,
+        metrics TEXT NOT NULL,
+        final_state TEXT NOT NULL,
+        UNIQUE(spell_id, run_id)
+      );
+
+      CREATE TABLE IF NOT EXISTS ledger (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        spell_id TEXT NOT NULL,
+        run_id TEXT NOT NULL,
+        entries TEXT NOT NULL,
+        UNIQUE(spell_id, run_id)
+      );
+    `);
+    }
+    async load(spellId) {
+        const row = this.db
+            .query("SELECT state FROM spell_state WHERE spell_id = ?")
+            .get(spellId);
+        if (!row)
+            return null;
+        return JSON.parse(row.state);
+    }
+    async save(spellId, state) {
+        this.db
+            .query(`INSERT INTO spell_state (spell_id, state, updated_at)
+         VALUES (?, ?, ?)
+         ON CONFLICT(spell_id) DO UPDATE SET state = excluded.state, updated_at = excluded.updated_at`)
+            .run(spellId, JSON.stringify(state), new Date().toISOString());
+    }
+    async addRun(spellId, run) {
+        const tx = this.db.transaction(() => {
+            this.db
+                .query(`INSERT INTO runs (spell_id, run_id, timestamp, success, error, duration, metrics, final_state)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?)`)
+                .run(spellId, run.runId, run.timestamp, run.success ? 1 : 0, run.error ?? null, run.duration, JSON.stringify(run.metrics), JSON.stringify(run.finalState));
+            // Prune old runs beyond maxRuns
+            this.db
+                .query(`DELETE FROM runs WHERE spell_id = ? AND id NOT IN (
+             SELECT id FROM runs WHERE spell_id = ? ORDER BY id DESC LIMIT ?
+           )`)
+                .run(spellId, spellId, this.maxRuns);
+        });
+        tx();
+    }
+    async getRuns(spellId, limit) {
+        const query = limit
+            ? "SELECT * FROM runs WHERE spell_id = ? ORDER BY id DESC LIMIT ?"
+            : "SELECT * FROM runs WHERE spell_id = ? ORDER BY id DESC";
+        const rows = limit
+            ? this.db.query(query).all(spellId, limit)
+            : this.db.query(query).all(spellId);
+        return rows.map(rowToRunRecord);
+    }
+    async saveLedger(spellId, runId, entries) {
+        this.db
+            .query(`INSERT INTO ledger (spell_id, run_id, entries)
+         VALUES (?, ?, ?)
+         ON CONFLICT(spell_id, run_id) DO UPDATE SET entries = excluded.entries`)
+            .run(spellId, runId, JSON.stringify(entries, bigintReplacer));
+    }
+    async loadLedger(spellId, runId) {
+        const row = this.db
+            .query("SELECT entries FROM ledger WHERE spell_id = ? AND run_id = ?")
+            .get(spellId, runId);
+        if (!row)
+            return null;
+        return JSON.parse(row.entries);
+    }
+    async listSpells() {
+        const rows = this.db
+            .query("SELECT spell_id FROM spell_state ORDER BY spell_id")
+            .all();
+        return rows.map((r) => r.spell_id);
+    }
+    /** Close the database connection */
+    close() {
+        this.db.close();
+    }
+}
+function rowToRunRecord(row) {
+    return {
+        runId: row.run_id,
+        timestamp: row.timestamp,
+        success: row.success === 1,
+        error: row.error ?? undefined,
+        duration: row.duration,
+        metrics: JSON.parse(row.metrics),
+        finalState: JSON.parse(row.final_state),
+    };
+}
+/** JSON replacer that converts bigint values to strings */
+function bigintReplacer(_key, value) {
+    return typeof value === "bigint" ? value.toString() : value;
+}
+//# sourceMappingURL=sqlite-state-store.js.map

package/dist/runtime/sqlite-state-store.js.map

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

package/dist/runtime/state-store.d.ts

@@ -0,0 +1,52 @@
+/**
+ * State Store interface and helpers
+ * Abstract persistence layer for spell state across runs
+ */
+import type { ExecutionResult, LedgerEntry } from "../types/execution.js";
+/**
+ * Serialized run metrics (bigint → string)
+ */
+export interface RunMetrics {
+    stepsExecuted: number;
+    actionsExecuted: number;
+    gasUsed: string;
+    advisoryCalls: number;
+    errors: number;
+    retries: number;
+}
+/**
+ * Record of a single spell execution
+ */
+export interface RunRecord {
+    runId: string;
+    timestamp: string;
+    success: boolean;
+    error?: string;
+    duration: number;
+    metrics: RunMetrics;
+    finalState: Record<string, unknown>;
+}
+/**
+ * Abstract interface for persisting spell state and run history
+ */
+export interface StateStore {
+    /** Load persistent state for a spell (null if never saved) */
+    load(spellId: string): Promise<Record<string, unknown> | null>;
+    /** Save persistent state for a spell */
+    save(spellId: string, state: Record<string, unknown>): Promise<void>;
+    /** Append a run record */
+    addRun(spellId: string, run: RunRecord): Promise<void>;
+    /** Get run records, most recent first */
+    getRuns(spellId: string, limit?: number): Promise<RunRecord[]>;
+    /** Save ledger entries for a run */
+    saveLedger(spellId: string, runId: string, entries: LedgerEntry[]): Promise<void>;
+    /** Load ledger entries for a run */
+    loadLedger(spellId: string, runId: string): Promise<LedgerEntry[] | null>;
+    /** List all spell IDs with saved state */
+    listSpells(): Promise<string[]>;
+}
+/**
+ * Create a RunRecord from an ExecutionResult
+ */
+export declare function createRunRecord(result: ExecutionResult): RunRecord;
+//# sourceMappingURL=state-store.d.ts.map

package/dist/runtime/state-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-store.d.ts","sourceRoot":"","sources":["../../src/runtime/state-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAoB,eAAe,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAE5F;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,UAAU,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,8DAA8D;IAC9D,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IAE/D,wCAAwC;IACxC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErE,0BAA0B;IAC1B,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD,yCAAyC;IACzC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAE/D,oCAAoC;IACpC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElF,oCAAoC;IACpC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,CAAC;IAE1E,0CAA0C;IAC1C,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACjC;AAgBD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAUlE"}

package/dist/runtime/state-store.js

@@ -0,0 +1,32 @@
+/**
+ * State Store interface and helpers
+ * Abstract persistence layer for spell state across runs
+ */
+/**
+ * Serialize ExecutionMetrics to RunMetrics (bigint → string)
+ */
+function serializeMetrics(metrics) {
+    return {
+        stepsExecuted: metrics.stepsExecuted,
+        actionsExecuted: metrics.actionsExecuted,
+        gasUsed: metrics.gasUsed.toString(),
+        advisoryCalls: metrics.advisoryCalls,
+        errors: metrics.errors,
+        retries: metrics.retries,
+    };
+}
+/**
+ * Create a RunRecord from an ExecutionResult
+ */
+export function createRunRecord(result) {
+    return {
+        runId: result.runId,
+        timestamp: new Date(result.startTime).toISOString(),
+        success: result.success,
+        error: result.error,
+        duration: result.duration,
+        metrics: serializeMetrics(result.metrics),
+        finalState: result.finalState,
+    };
+}
+//# sourceMappingURL=state-store.js.map

package/dist/runtime/state-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-store.js","sourceRoot":"","sources":["../../src/runtime/state-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuDH;;GAEG;AACH,SAAS,gBAAgB,CAAC,OAAyB;IACjD,OAAO;QACL,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE;QACnC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAuB;IACrD,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,SAAS,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;QACnD,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC;QACzC,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC;AACJ,CAAC"}

package/dist/runtime/steps/action.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Action Step Executor
+ * Executes on-chain actions using the wallet executor when provided.
+ */
+import type { ExecutionContext, StepResult } from "../../types/execution.js";
+import type { ActionStep } from "../../types/steps.js";
+import type { Executor } from "../../wallet/executor.js";
+import type { ExecutionMode } from "../../wallet/executor.js";
+import type { CircuitBreakerManager } from "../circuit-breaker.js";
+import type { InMemoryLedger } from "../context.js";
+export interface ActionExecutionOptions {
+    mode: ExecutionMode;
+    executor?: Executor;
+    circuitBreakerManager?: CircuitBreakerManager;
+}
+export declare function executeActionStep(step: ActionStep, ctx: ExecutionContext, ledger: InMemoryLedger, options: ActionExecutionOptions): Promise<StepResult>;
+//# sourceMappingURL=action.d.ts.map

package/dist/runtime/steps/action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../../src/runtime/steps/action.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE7E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAIpD,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;CAC/C;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,gBAAgB,EACrB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,UAAU,CAAC,CA+NrB"}