@grimoirelabs/core 0.1.0

package/dist/runtime/steps/action.js

@@ -0,0 +1,430 @@
+/**
+ * Action Step Executor
+ * Executes on-chain actions using the wallet executor when provided.
+ */
+import { addGasUsed, incrementActions, setBinding } from "../context.js";
+import { classifyError } from "../error-classifier.js";
+import { createEvalContext, evaluateAsync } from "../expression-evaluator.js";
+export async function executeActionStep(step, ctx, ledger, options) {
+    ledger.emit({ type: "step_started", stepId: step.id, kind: "action" });
+    incrementActions(ctx);
+    // Circuit breaker pre-check
+    if (options.circuitBreakerManager) {
+        const cbCheck = options.circuitBreakerManager.check();
+        if (!cbCheck.allowed) {
+            for (const blocker of cbCheck.blockedBy) {
+                ledger.emit({
+                    type: "circuit_breaker_action",
+                    breakerId: blocker.id,
+                    action: blocker.action,
+                });
+            }
+            const firstBlocker = cbCheck.blockedBy[0];
+            if (firstBlocker?.action === "pause") {
+                ledger.emit({
+                    type: "step_skipped",
+                    stepId: step.id,
+                    reason: `Circuit breaker '${firstBlocker.id}' is open`,
+                });
+                return {
+                    success: true,
+                    stepId: step.id,
+                    skipped: true,
+                    output: { skippedByCircuitBreaker: firstBlocker.id },
+                };
+            }
+            // halt or unwind
+            const breakerLabel = firstBlocker?.id ?? "unknown";
+            ledger.emit({
+                type: "step_failed",
+                stepId: step.id,
+                error: `Circuit breaker '${breakerLabel}' is open`,
+            });
+            return {
+                success: false,
+                stepId: step.id,
+                error: `Circuit breaker '${breakerLabel}' is open`,
+            };
+        }
+    }
+    try {
+        const evalCtx = createEvalContext(ctx);
+        const explicitSkill = step.skill
+            ? ctx.spell.skills.find((s) => s.name === step.skill)
+            : undefined;
+        const actionVenue = hasVenue(step.action) ? step.action.venue : undefined;
+        const inferredSkill = !explicitSkill && actionVenue
+            ? ctx.spell.skills.find((s) => s.name === actionVenue)
+            : undefined;
+        const skill = explicitSkill ?? inferredSkill;
+        const skillName = skill?.name;
+        const actionWithVenue = resolveActionVenue(step.action, skill, ctx, skillName);
+        const resolvedAction = await resolveAction(actionWithVenue, evalCtx);
+        const mergedConstraints = applySkillDefaults(step.constraints, skill);
+        const resolvedConstraints = await resolveConstraints(mergedConstraints, evalCtx);
+        const actionWithConstraints = { ...resolvedAction, constraints: resolvedConstraints };
+        ledger.emit({
+            type: "constraint_evaluated",
+            stepId: step.id,
+            constraints: resolvedConstraints,
+        });
+        if (options.mode === "simulate") {
+            const amountValue = "amount" in actionWithConstraints
+                ? actionWithConstraints.amount
+                : undefined;
+            const amountText = amountValue !== undefined ? String(amountValue) : "";
+            ledger.emit({
+                type: "action_simulated",
+                action: actionWithConstraints,
+                venue: resolveVenueAlias(actionWithConstraints, ctx),
+                result: {
+                    success: true,
+                    input: {
+                        asset: "asset" in resolvedAction ? String(resolvedAction.asset ?? "") : "",
+                        amount: amountText,
+                    },
+                    output: {
+                        asset: "asset" in resolvedAction ? String(resolvedAction.asset ?? "") : "",
+                        amount: amountText,
+                    },
+                    gasEstimate: "0",
+                },
+            });
+            ledger.emit({
+                type: "step_completed",
+                stepId: step.id,
+                result: { simulated: true, action: actionWithConstraints },
+            });
+            if (step.outputBinding) {
+                setBinding(ctx, step.outputBinding, { simulated: true, action: actionWithConstraints });
+            }
+            return {
+                success: true,
+                stepId: step.id,
+                output: { simulated: true, action: actionWithConstraints },
+            };
+        }
+        if (!options.executor) {
+            throw new Error("No executor configured for action execution");
+        }
+        const result = await options.executor.executeAction(actionWithConstraints);
+        if (!result.success) {
+            const failError = result.error ?? "Action execution failed";
+            // Feed failure to circuit breaker
+            if (options.circuitBreakerManager) {
+                const errorType = classifyError(failError);
+                const eventType = errorType === "slippage_exceeded"
+                    ? "slippage"
+                    : errorType === "gas_exceeded"
+                        ? "gas"
+                        : "revert";
+                const cbResult = options.circuitBreakerManager.recordEvent({
+                    timestamp: Date.now(),
+                    type: eventType,
+                });
+                if (cbResult) {
+                    ledger.emit({
+                        type: "circuit_breaker_triggered",
+                        breakerId: cbResult.breakerId,
+                        trigger: cbResult.trigger,
+                    });
+                }
+            }
+            ledger.emit({
+                type: "step_failed",
+                stepId: step.id,
+                error: failError,
+            });
+            if (result.hash) {
+                ledger.emit({
+                    type: "action_reverted",
+                    txHash: result.hash,
+                    reason: failError,
+                });
+            }
+            return {
+                success: false,
+                stepId: step.id,
+                error: failError,
+            };
+        }
+        if (result.hash) {
+            ledger.emit({
+                type: "action_submitted",
+                action: actionWithConstraints,
+                txHash: result.hash,
+            });
+        }
+        if (result.receipt) {
+            addGasUsed(ctx, result.receipt.gasUsed);
+            ledger.emit({
+                type: "action_confirmed",
+                txHash: result.receipt.hash,
+                gasUsed: result.receipt.gasUsed.toString(),
+            });
+        }
+        // Record success for circuit breaker tracking
+        if (options.circuitBreakerManager) {
+            options.circuitBreakerManager.recordSuccess();
+        }
+        const output = {
+            action: actionWithConstraints,
+            hash: result.hash,
+            receipt: result.receipt,
+            gasUsed: result.gasUsed,
+        };
+        if (step.outputBinding) {
+            setBinding(ctx, step.outputBinding, output);
+        }
+        ledger.emit({
+            type: "step_completed",
+            stepId: step.id,
+            result: serializeValue(output),
+        });
+        return {
+            success: true,
+            stepId: step.id,
+            output,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        ledger.emit({
+            type: "step_failed",
+            stepId: step.id,
+            error: message,
+        });
+        return {
+            success: false,
+            stepId: step.id,
+            error: message,
+        };
+    }
+}
+function hasVenue(action) {
+    return "venue" in action;
+}
+function resolveActionVenue(action, skill, ctx, skillName) {
+    if (!skill || !skill.adapters.length) {
+        return action;
+    }
+    const hasAlias = (venue) => !!venue && ctx.spell.aliases.some((a) => a.alias === venue);
+    const venue = action.venue;
+    const isSkillNamedVenue = !!skillName && venue === skillName;
+    if (!isSkillNamedVenue && hasAlias(venue)) {
+        return action;
+    }
+    const selected = skill.adapters.find((adapter) => hasAlias(adapter));
+    if (!selected) {
+        return action;
+    }
+    return { ...action, venue: selected };
+}
+function applySkillDefaults(constraints, skill) {
+    if (!skill?.defaultConstraints)
+        return constraints;
+    const merged = { ...(constraints ?? {}) };
+    if (merged.maxSlippageBps === undefined && skill.defaultConstraints.maxSlippage !== undefined) {
+        merged.maxSlippageBps = skill.defaultConstraints.maxSlippage;
+    }
+    return merged;
+}
+async function resolveAction(action, evalCtx) {
+    switch (action.type) {
+        case "swap":
+            return {
+                ...action,
+                amount: await resolveAmount(action.amount, evalCtx),
+            };
+        case "lend":
+            return {
+                ...action,
+                amount: await resolveAmount(action.amount, evalCtx),
+            };
+        case "withdraw":
+            return {
+                ...action,
+                amount: await resolveAmount(action.amount, evalCtx),
+            };
+        case "borrow":
+            return {
+                ...action,
+                amount: await resolveAmount(action.amount, evalCtx),
+            };
+        case "repay":
+            return {
+                ...action,
+                amount: await resolveAmount(action.amount, evalCtx),
+            };
+        case "stake":
+            return {
+                ...action,
+                amount: await resolveAmount(action.amount, evalCtx),
+            };
+        case "unstake":
+            return {
+                ...action,
+                amount: await resolveAmount(action.amount, evalCtx),
+            };
+        case "bridge":
+            return {
+                ...action,
+                amount: await resolveAmount(action.amount, evalCtx),
+                toChain: await resolveChainId(action.toChain, evalCtx),
+            };
+        case "transfer":
+            return {
+                ...action,
+                amount: await resolveAmount(action.amount, evalCtx),
+                to: await resolveAddress(action.to, evalCtx),
+            };
+        case "approve":
+            return {
+                ...action,
+                amount: await resolveAmount(action.amount, evalCtx),
+            };
+        case "claim":
+            return action;
+        default:
+            return action;
+    }
+}
+async function resolveAmount(amount, evalCtx) {
+    if (amount === undefined || amount === null || amount === "max") {
+        return amount;
+    }
+    if (typeof amount === "bigint") {
+        return amount;
+    }
+    if (typeof amount === "number") {
+        return BigInt(Math.floor(amount));
+    }
+    if (typeof amount === "string") {
+        return BigInt(amount);
+    }
+    const value = await evaluateAsync(amount, evalCtx);
+    return toBigInt(value);
+}
+async function resolveChainId(toChain, evalCtx) {
+    if (typeof toChain === "number") {
+        return toChain;
+    }
+    if (typeof toChain === "bigint") {
+        return toNumber(toChain);
+    }
+    if (typeof toChain === "string") {
+        return toNumber(toChain);
+    }
+    const value = await evaluateAsync(toChain, evalCtx);
+    return toNumber(value);
+}
+async function resolveAddress(to, evalCtx) {
+    if (typeof to === "string") {
+        return to;
+    }
+    const value = await evaluateAsync(to, evalCtx);
+    if (typeof value !== "string") {
+        throw new Error(`Expected address string, got ${typeof value}`);
+    }
+    return value;
+}
+async function resolveConstraints(constraints, evalCtx) {
+    const active = constraints ?? {};
+    const minOutput = active.minOutput
+        ? toBigInt(await evaluateAsync(active.minOutput, evalCtx))
+        : undefined;
+    const maxInput = active.maxInput
+        ? toBigInt(await evaluateAsync(active.maxInput, evalCtx))
+        : undefined;
+    const minLiquidity = active.minLiquidity
+        ? toBigInt(await evaluateAsync(active.minLiquidity, evalCtx))
+        : undefined;
+    const maxGas = active.maxGas ? toBigInt(await evaluateAsync(active.maxGas, evalCtx)) : undefined;
+    const requireQuote = active.requireQuote
+        ? Boolean(await evaluateAsync(active.requireQuote, evalCtx))
+        : undefined;
+    const requireSimulation = active.requireSimulation
+        ? Boolean(await evaluateAsync(active.requireSimulation, evalCtx))
+        : undefined;
+    return {
+        maxSlippageBps: active.maxSlippageBps,
+        maxPriceImpactBps: active.maxPriceImpactBps,
+        deadline: active.deadline,
+        minOutput,
+        maxInput,
+        minLiquidity,
+        requireQuote,
+        requireSimulation,
+        maxGas,
+    };
+}
+function toBigInt(value) {
+    if (typeof value === "bigint") {
+        return value;
+    }
+    if (typeof value === "number") {
+        return BigInt(Math.floor(value));
+    }
+    if (typeof value === "string") {
+        try {
+            return BigInt(value);
+        }
+        catch {
+            throw new Error(`Cannot convert string '${value}' to bigint`);
+        }
+    }
+    throw new Error(`Unsupported amount type: ${typeof value}`);
+}
+function toNumber(value) {
+    if (typeof value === "number") {
+        if (!Number.isFinite(value)) {
+            throw new Error("Chain id must be a finite number");
+        }
+        return Math.floor(value);
+    }
+    if (typeof value === "bigint") {
+        const numeric = Number(value);
+        if (!Number.isSafeInteger(numeric)) {
+            throw new Error("Chain id is too large to fit in a number");
+        }
+        return numeric;
+    }
+    if (typeof value === "string") {
+        const numeric = Number(value);
+        if (!Number.isFinite(numeric)) {
+            throw new Error(`Cannot convert string '${value}' to number`);
+        }
+        return Math.floor(numeric);
+    }
+    throw new Error(`Unsupported chain id type: ${typeof value}`);
+}
+function resolveVenueAlias(action, ctx) {
+    if ("venue" in action) {
+        const alias = ctx.spell.aliases.find((entry) => entry.alias === action.venue);
+        if (alias) {
+            return alias;
+        }
+    }
+    return {
+        alias: "unknown",
+        chain: ctx.chain,
+        address: "0x0000000000000000000000000000000000000000",
+    };
+}
+function serializeValue(value) {
+    if (typeof value === "bigint") {
+        return value.toString();
+    }
+    if (Array.isArray(value)) {
+        return value.map(serializeValue);
+    }
+    if (typeof value === "object" && value !== null) {
+        const result = {};
+        for (const [k, v] of Object.entries(value)) {
+            result[k] = serializeValue(v);
+        }
+        return result;
+    }
+    return value;
+}
+//# sourceMappingURL=action.js.map

package/dist/runtime/steps/action.js.map

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

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

@@ -0,0 +1,28 @@
+/**
+ * Advisory Step Executor
+ * Uses fallback outputs (no tool execution yet).
+ */
+import type { ExecutionContext, StepResult } from "../../types/execution.js";
+import type { AdvisoryStep } from "../../types/steps.js";
+import type { InMemoryLedger } from "../context.js";
+export interface AdvisoryHandlerInput {
+    advisor: string;
+    prompt: string;
+    model?: string;
+    outputSchema: AdvisoryStep["outputSchema"];
+    timeout: number;
+    skills?: string[];
+    allowedTools?: string[];
+    mcp?: string[];
+    context: {
+        params: Record<string, unknown>;
+        bindings: Record<string, unknown>;
+        state: {
+            persistent: Record<string, unknown>;
+            ephemeral: Record<string, unknown>;
+        };
+    };
+}
+export type AdvisoryHandler = (input: AdvisoryHandlerInput) => Promise<unknown>;
+export declare function executeAdvisoryStep(step: AdvisoryStep, ctx: ExecutionContext, ledger: InMemoryLedger, handler?: AdvisoryHandler): Promise<StepResult>;
+//# sourceMappingURL=advisory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"advisory.d.ts","sourceRoot":"","sources":["../../../src/runtime/steps/advisory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAuB,gBAAgB,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAClG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,KAAK,EAAE;YACL,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACpC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACpC,CAAC;KACH,CAAC;CACH;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEhF,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,YAAY,EAClB,GAAG,EAAE,gBAAgB,EACrB,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,UAAU,CAAC,CA4GrB"}