@grimoirelabs/core 0.1.0

package/dist/runtime/interpreter.js

@@ -0,0 +1,414 @@
+/**
+ * Spell Interpreter
+ * Executes compiled SpellIR
+ */
+import { createExecutor } from "../wallet/executor.js";
+import { createProvider } from "../wallet/provider.js";
+import { CircuitBreakerManager } from "./circuit-breaker.js";
+import { InMemoryLedger, createContext, getPersistentStateObject, incrementAdvisoryCalls, markStepExecuted, } from "./context.js";
+import { createEvalContext, evaluateAsync } from "./expression-evaluator.js";
+import { resolveAdvisorSkill } from "./skills/registry.js";
+// Step executors
+import { executeActionStep } from "./steps/action.js";
+import { executeAdvisoryStep } from "./steps/advisory.js";
+import { executeComputeStep } from "./steps/compute.js";
+import { executeConditionalStep } from "./steps/conditional.js";
+import { executeEmitStep } from "./steps/emit.js";
+import { executeHaltStep } from "./steps/halt.js";
+import { executeLoopStep } from "./steps/loop.js";
+import { executeParallelStep } from "./steps/parallel.js";
+import { executePipelineStep } from "./steps/pipeline.js";
+import { executeTryStep } from "./steps/try.js";
+import { executeWaitStep } from "./steps/wait.js";
+/**
+ * Execute a compiled spell
+ */
+export async function execute(options) {
+    const { spell, vault, chain, params = {}, persistentState = {}, simulate = false } = options;
+    const actionMode = resolveExecutionMode(options, simulate);
+    const actionExecution = createActionExecutionOptions(options, actionMode, chain);
+    // Initialize circuit breaker manager if policy has breakers
+    if (options.policy?.circuitBreakers?.length) {
+        actionExecution.circuitBreakerManager = new CircuitBreakerManager(options.policy.circuitBreakers);
+    }
+    // Create execution context
+    const ctx = createContext({
+        spell,
+        vault,
+        chain,
+        params,
+        persistentState,
+    });
+    ctx.advisorTooling = buildAdvisorTooling(spell.advisors, options.advisorSkillsDirs);
+    // Create ledger
+    const ledger = new InMemoryLedger(ctx.runId, spell.id);
+    // Log run start
+    ledger.emit({
+        type: "run_started",
+        runId: ctx.runId,
+        spellId: spell.id,
+        trigger: ctx.trigger,
+    });
+    try {
+        // Check pre-execution guards
+        const guardResult = await checkGuards(spell.guards, ctx, ledger);
+        if (!guardResult.success) {
+            throw new Error(`Guard failed: ${guardResult.error}`);
+        }
+        // Build step map for quick lookup
+        const stepMap = new Map(spell.steps.map((s) => [s.id, s]));
+        // Execute steps in order (topological sort would be ideal, but for now sequential)
+        for (const step of spell.steps) {
+            // Skip steps already executed by a parent (try/loop/conditional)
+            if (ctx.executedSteps.includes(step.id)) {
+                continue;
+            }
+            // Check dependencies
+            for (const depId of step.dependsOn) {
+                if (!ctx.executedSteps.includes(depId)) {
+                    throw new Error(`Step '${step.id}' depends on '${depId}' which has not been executed`);
+                }
+            }
+            // Execute step
+            const result = await executeStep(step, ctx, ledger, stepMap, actionExecution, options.onAdvisory);
+            // Mark all child steps of container steps (try/loop/conditional) as executed
+            // so the main loop doesn't re-execute them standalone
+            for (const childId of getChildStepIds(step)) {
+                if (!ctx.executedSteps.includes(childId)) {
+                    markStepExecuted(ctx, childId);
+                }
+            }
+            // Enrich step_failed ledger events with source location
+            if (!result.success) {
+                const loc = spell.sourceMap?.[step.id];
+                if (loc) {
+                    enrichStepFailedEvents(ledger, step.id, loc);
+                }
+            }
+            // Handle halt
+            if (result.halted) {
+                ledger.emit({
+                    type: "run_completed",
+                    runId: ctx.runId,
+                    success: true,
+                    metrics: ctx.metrics,
+                });
+                return {
+                    success: true,
+                    runId: ctx.runId,
+                    startTime: ctx.startTime,
+                    endTime: Date.now(),
+                    duration: Date.now() - ctx.startTime,
+                    metrics: ctx.metrics,
+                    finalState: getPersistentStateObject(ctx),
+                    ledgerEvents: ledger.getEntries(),
+                };
+            }
+            // Handle failure
+            if (!result.success) {
+                const onFailure = "onFailure" in step ? step.onFailure : "revert";
+                const loc = spell.sourceMap?.[step.id];
+                const locSuffix = loc ? ` at line ${loc.line}, column ${loc.column}` : "";
+                switch (onFailure) {
+                    case "halt":
+                        throw new Error(`Step '${step.id}' failed${locSuffix}: ${result.error}`);
+                    case "revert":
+                        throw new Error(`Step '${step.id}' failed${locSuffix}: ${result.error}`);
+                    case "skip":
+                        ledger.emit({
+                            type: "step_skipped",
+                            stepId: step.id,
+                            reason: result.error ?? "Unknown error",
+                        });
+                        continue;
+                    case "catch":
+                        // Would be handled by try/catch step
+                        continue;
+                }
+            }
+            markStepExecuted(ctx, step.id);
+        }
+        // Check post-execution guards
+        const postGuardResult = await checkGuards(spell.guards, ctx, ledger);
+        if (!postGuardResult.success && postGuardResult.severity === "halt") {
+            throw new Error(`Post-execution guard failed: ${postGuardResult.error}`);
+        }
+        // Log run completion
+        ledger.emit({
+            type: "run_completed",
+            runId: ctx.runId,
+            success: true,
+            metrics: ctx.metrics,
+        });
+        return {
+            success: true,
+            runId: ctx.runId,
+            startTime: ctx.startTime,
+            endTime: Date.now(),
+            duration: Date.now() - ctx.startTime,
+            metrics: ctx.metrics,
+            finalState: getPersistentStateObject(ctx),
+            ledgerEvents: ledger.getEntries(),
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        ledger.emit({
+            type: "run_failed",
+            runId: ctx.runId,
+            error: message,
+        });
+        return {
+            success: false,
+            runId: ctx.runId,
+            startTime: ctx.startTime,
+            endTime: Date.now(),
+            duration: Date.now() - ctx.startTime,
+            error: message,
+            metrics: ctx.metrics,
+            finalState: getPersistentStateObject(ctx),
+            ledgerEvents: ledger.getEntries(),
+        };
+    }
+}
+function resolveExecutionMode(options, simulate) {
+    if (options.executionMode) {
+        return options.executionMode;
+    }
+    if (simulate) {
+        return "simulate";
+    }
+    if (options.wallet) {
+        return "execute";
+    }
+    return "simulate";
+}
+function createActionExecutionOptions(options, mode, chainId) {
+    if (mode === "simulate") {
+        return { mode };
+    }
+    if (!options.wallet) {
+        throw new Error("Wallet is required for non-simulated execution");
+    }
+    const provider = options.provider ?? createProvider(chainId, options.rpcUrl);
+    const executor = createExecutor({
+        wallet: options.wallet,
+        provider,
+        mode,
+        gasMultiplier: options.gasMultiplier,
+        confirmCallback: options.confirmCallback,
+        progressCallback: options.progressCallback,
+        skipTestnetConfirmation: options.skipTestnetConfirmation,
+        adapters: options.adapters,
+    });
+    return { mode, executor };
+}
+function buildAdvisorTooling(advisors, searchDirs) {
+    if (!advisors.length)
+        return undefined;
+    const tooling = {};
+    const dirs = (searchDirs ?? []).filter((dir) => dir.length > 0);
+    for (const advisor of advisors) {
+        const skills = advisor.skills ? [...advisor.skills] : [];
+        const allowedTools = new Set(advisor.allowedTools ?? []);
+        if (skills.length > 0 && dirs.length > 0) {
+            for (const skillName of skills) {
+                const meta = resolveAdvisorSkill(skillName, dirs);
+                if (meta?.allowedTools?.length) {
+                    for (const tool of meta.allowedTools) {
+                        allowedTools.add(tool);
+                    }
+                }
+            }
+        }
+        if (skills.length > 0 || allowedTools.size > 0 || advisor.mcp?.length) {
+            tooling[advisor.name] = {
+                skills,
+                allowedTools: Array.from(allowedTools),
+                mcp: advisor.mcp,
+            };
+        }
+    }
+    return Object.keys(tooling).length > 0 ? tooling : undefined;
+}
+/**
+ * Execute a single step
+ */
+async function executeStep(step, ctx, ledger, stepMap, actionExecution, advisoryHandler, evalCtx) {
+    // Helper to execute steps by ID (for loops, conditionals, etc.)
+    const executeStepById = async (stepId, ctx, innerEvalCtx) => {
+        const innerStep = stepMap.get(stepId);
+        if (!innerStep) {
+            return { success: false, stepId, error: `Unknown step: ${stepId}` };
+        }
+        return executeStep(innerStep, ctx, ledger, stepMap, actionExecution, advisoryHandler, innerEvalCtx);
+    };
+    switch (step.kind) {
+        case "compute":
+            return executeComputeStep(step, ctx, ledger);
+        case "conditional": {
+            const condResult = await executeConditionalStep(step, ctx, ledger);
+            if (!condResult.success) {
+                return condResult;
+            }
+            // Execute branch steps
+            for (const branchStepId of condResult.branchSteps) {
+                const branchResult = await executeStepById(branchStepId, ctx, evalCtx);
+                if (!branchResult.success) {
+                    return branchResult;
+                }
+                if (branchResult.halted) {
+                    return branchResult;
+                }
+            }
+            return condResult;
+        }
+        case "loop":
+            return executeLoopStep(step, ctx, ledger, executeStepById);
+        case "wait":
+            return executeWaitStep(step, ctx, ledger);
+        case "emit":
+            return executeEmitStep(step, ctx, ledger);
+        case "halt":
+            return executeHaltStep(step, ctx, ledger);
+        case "action":
+            return executeActionStep(step, ctx, ledger, actionExecution);
+        case "try":
+            return executeTryStep(step, ctx, ledger, executeStepById);
+        case "parallel":
+            return executeParallelStep(step, ctx, ledger, executeStepById);
+        case "pipeline":
+            return executePipelineStep(step, ctx, ledger, executeStepById);
+        case "advisory":
+            return executeAdvisoryStep(step, ctx, ledger, advisoryHandler);
+        default:
+            return {
+                success: false,
+                stepId: step.id,
+                error: `Unknown step kind: ${step.kind}`,
+            };
+    }
+}
+/**
+ * Collect all child step IDs from container steps (try, loop, conditional)
+ * so the main loop can skip them after the parent executes.
+ */
+function getChildStepIds(step) {
+    switch (step.kind) {
+        case "try":
+            return [
+                ...step.trySteps,
+                ...step.catchBlocks.flatMap((cb) => cb.steps ?? []),
+                ...(step.finallySteps ?? []),
+            ];
+        case "loop":
+            return step.bodySteps;
+        case "conditional":
+            return [...step.thenSteps, ...step.elseSteps];
+        case "parallel":
+            return step.branches.flatMap((b) => b.steps);
+        case "pipeline":
+            return step.stages.filter((s) => "step" in s).map((s) => s.step);
+        default:
+            return [];
+    }
+}
+/**
+ * Check guards
+ */
+async function checkGuards(guards, ctx, ledger) {
+    const evalCtx = createEvalContext(ctx);
+    for (const guard of guards) {
+        if ("advisor" in guard) {
+            const tooling = ctx.advisorTooling?.[guard.advisor];
+            const skills = tooling?.skills?.length ? tooling.skills : undefined;
+            const allowedTools = tooling?.allowedTools?.length ? tooling.allowedTools : undefined;
+            incrementAdvisoryCalls(ctx);
+            ledger.emit({
+                type: "advisory_started",
+                advisor: guard.advisor,
+                prompt: guard.check,
+                skills,
+                allowedTools,
+            });
+            const decision = guard.fallback ?? true;
+            ledger.emit({
+                type: "advisory_completed",
+                advisor: guard.advisor,
+                output: decision,
+            });
+            if (decision) {
+                ledger.emit({ type: "guard_passed", guardId: guard.id });
+            }
+            else {
+                const severity = guard.severity === "pause" ? "pause" : "warn";
+                const message = `Advisory guard '${guard.id}' returned false`;
+                ledger.emit({
+                    type: "guard_failed",
+                    guardId: guard.id,
+                    severity,
+                    message,
+                });
+                if (severity === "pause") {
+                    return { success: false, error: message, severity };
+                }
+            }
+            continue;
+        }
+        const expressionGuard = guard;
+        try {
+            const result = await evaluateAsync(expressionGuard.check, evalCtx);
+            const passed = Boolean(result);
+            if (passed) {
+                ledger.emit({ type: "guard_passed", guardId: guard.id });
+            }
+            else {
+                ledger.emit({
+                    type: "guard_failed",
+                    guardId: guard.id,
+                    severity: expressionGuard.severity,
+                    message: expressionGuard.message,
+                });
+                if (expressionGuard.severity === "halt" || expressionGuard.severity === "revert") {
+                    return {
+                        success: false,
+                        error: expressionGuard.message,
+                        severity: expressionGuard.severity,
+                    };
+                }
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            ledger.emit({
+                type: "guard_failed",
+                guardId: guard.id,
+                severity: "error",
+                message,
+            });
+            if (expressionGuard.severity === "halt") {
+                return { success: false, error: message, severity: "halt" };
+            }
+        }
+    }
+    return { success: true };
+}
+/**
+ * Enrich step_failed ledger events with source location info.
+ * Scans recent events to find step_failed events for the given stepId
+ * and adds line/column from the source map.
+ */
+function enrichStepFailedEvents(ledger, stepId, loc) {
+    const entries = ledger.getEntries();
+    for (let i = entries.length - 1; i >= 0; i--) {
+        const entry = entries[i];
+        if (!entry)
+            continue;
+        if (entry.event.type === "step_failed" && entry.event.stepId === stepId) {
+            entry.event.line = loc.line;
+            entry.event.column = loc.column;
+            break;
+        }
+    }
+}
+//# sourceMappingURL=interpreter.js.map

package/dist/runtime/interpreter.js.map

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

package/dist/runtime/skills/registry.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Advisor Skill Registry (Agent Skills compatible)
+ * Loads SKILL.md frontmatter metadata for allowed tools.
+ */
+export interface AdvisorSkillMeta {
+    name: string;
+    dir: string;
+    allowedTools?: string[];
+}
+export declare function resolveAdvisorSkill(name: string, searchDirs: string[]): AdvisorSkillMeta | null;
+//# sourceMappingURL=registry.d.ts.map

package/dist/runtime/skills/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/runtime/skills/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,gBAAgB,GAAG,IAAI,CAc/F"}

package/dist/runtime/skills/registry.js

@@ -0,0 +1,73 @@
+/**
+ * Advisor Skill Registry (Agent Skills compatible)
+ * Loads SKILL.md frontmatter metadata for allowed tools.
+ */
+import fs from "node:fs";
+import path from "node:path";
+export function resolveAdvisorSkill(name, searchDirs) {
+    for (const base of searchDirs) {
+        const dir = path.join(base, name);
+        const skillPath = path.join(dir, "SKILL.md");
+        if (!fs.existsSync(skillPath))
+            continue;
+        const content = fs.readFileSync(skillPath, "utf8");
+        const meta = parseFrontmatter(content);
+        return {
+            name: meta.name ?? name,
+            dir,
+            allowedTools: meta.allowedTools,
+        };
+    }
+    return null;
+}
+function parseFrontmatter(content) {
+    if (!content.startsWith("---"))
+        return {};
+    const end = content.indexOf("\n---", 3);
+    if (end === -1)
+        return {};
+    const fm = content.slice(3, end).trim();
+    const lines = fm.split("\n");
+    const result = {};
+    const allowedToolsKeys = new Set(["allowed-tools", "allowed_tools", "allowedTools", "tools"]);
+    let currentKey = null;
+    for (const rawLine of lines) {
+        const line = rawLine.trim();
+        if (!line)
+            continue;
+        if (line.startsWith("-") && currentKey && allowedToolsKeys.has(currentKey)) {
+            const tool = line.replace(/^-+\s*/, "");
+            if (!result.allowedTools)
+                result.allowedTools = [];
+            result.allowedTools.push(tool);
+            continue;
+        }
+        const match = line.match(/^([a-zA-Z0-9_-]+):\s*(.*)$/);
+        if (!match)
+            continue;
+        const [, key, value] = match;
+        currentKey = key;
+        if (key === "name") {
+            result.name = value.replace(/^\"|\"$/g, "");
+        }
+        if (allowedToolsKeys.has(key)) {
+            if (value.startsWith("[") && value.endsWith("]")) {
+                const inner = value.slice(1, -1).trim();
+                if (inner) {
+                    result.allowedTools = inner
+                        .split(",")
+                        .map((v) => v.trim().replace(/^\"|\"$/g, ""))
+                        .filter(Boolean);
+                }
+            }
+            else if (value) {
+                result.allowedTools = [value.replace(/^\"|\"$/g, "")];
+            }
+            else {
+                result.allowedTools = [];
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=registry.js.map

package/dist/runtime/skills/registry.js.map

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

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

@@ -0,0 +1,28 @@
+/**
+ * SQLite-based StateStore implementation
+ * Uses bun:sqlite when available, otherwise falls back to better-sqlite3.
+ */
+import type { LedgerEntry } from "../types/execution.js";
+import type { RunRecord, StateStore } from "./state-store.js";
+export interface SqliteStateStoreOptions {
+    /** Path to SQLite database file (default: .grimoire/grimoire.db) */
+    dbPath?: string;
+    /** Maximum number of run records per spell before pruning (default: 100) */
+    maxRuns?: number;
+}
+export declare class SqliteStateStore implements StateStore {
+    private db;
+    private maxRuns;
+    constructor(options?: SqliteStateStoreOptions);
+    private initSchema;
+    load(spellId: string): Promise<Record<string, unknown> | null>;
+    save(spellId: string, state: Record<string, unknown>): Promise<void>;
+    addRun(spellId: string, run: RunRecord): Promise<void>;
+    getRuns(spellId: string, limit?: number): Promise<RunRecord[]>;
+    saveLedger(spellId: string, runId: string, entries: LedgerEntry[]): Promise<void>;
+    loadLedger(spellId: string, runId: string): Promise<LedgerEntry[] | null>;
+    listSpells(): Promise<string[]>;
+    /** Close the database connection */
+    close(): void;
+}
+//# sourceMappingURL=sqlite-state-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-state-store.d.ts","sourceRoot":"","sources":["../../src/runtime/sqlite-state-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9D,MAAM,WAAW,uBAAuB;IACtC,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA0FD,qBAAa,gBAAiB,YAAW,UAAU;IACjD,OAAO,CAAC,EAAE,CAAe;IACzB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE,uBAA4B;IAYjD,OAAO,CAAC,UAAU;IA+BZ,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAS9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAUpE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BtD,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAY9D,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUjF,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC;IAWzE,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAQrC,oCAAoC;IACpC,KAAK,IAAI,IAAI;CAGd"}