@grimoirelabs/core 0.1.0

package/dist/runtime/circuit-breaker.js

@@ -0,0 +1,155 @@
+/**
+ * Circuit Breaker Runtime
+ *
+ * Implements the CLOSED -> OPEN -> HALF_OPEN state machine for runtime
+ * risk controls. Tracks events within time windows and triggers breakers
+ * when thresholds are exceeded.
+ */
+export class CircuitBreakerManager {
+    breakers;
+    now;
+    constructor(definitions, nowFn) {
+        this.now = nowFn ?? (() => Date.now());
+        this.breakers = new Map();
+        for (const def of definitions) {
+            this.breakers.set(def.id, {
+                id: def.id,
+                state: "closed",
+                definition: def,
+                events: [],
+                actionCount: 0,
+            });
+        }
+    }
+    /** Check if any breaker is OPEN - call before executing an action */
+    check() {
+        const blockedBy = [];
+        for (const record of this.breakers.values()) {
+            // Transition OPEN -> HALF_OPEN if cooldown elapsed
+            if (record.state === "open" && record.openedAt !== undefined) {
+                const cooldown = record.definition.cooldown ?? 0;
+                if (cooldown > 0 && this.now() - record.openedAt >= cooldown * 1000) {
+                    record.state = "half_open";
+                }
+            }
+            if (record.state === "open") {
+                blockedBy.push({ id: record.id, action: record.definition.action });
+            }
+        }
+        return {
+            allowed: blockedBy.length === 0,
+            blockedBy,
+        };
+    }
+    /** Record a successful action (for rate tracking) */
+    recordSuccess() {
+        for (const record of this.breakers.values()) {
+            record.actionCount++;
+            // HALF_OPEN -> CLOSED on success
+            if (record.state === "half_open") {
+                record.state = "closed";
+                record.openedAt = undefined;
+                record.events = [];
+                record.actionCount = 0;
+            }
+        }
+    }
+    /** Record an event (action failure, slippage, gas spike) */
+    recordEvent(event) {
+        let triggered = null;
+        for (const record of this.breakers.values()) {
+            record.events.push(event);
+            record.actionCount++;
+            // HALF_OPEN -> OPEN on failure
+            if (record.state === "half_open") {
+                record.state = "open";
+                record.openedAt = this.now();
+                triggered = {
+                    breakerId: record.id,
+                    trigger: record.definition.trigger,
+                    action: record.definition.action,
+                };
+                continue;
+            }
+            // Only evaluate triggers when CLOSED
+            if (record.state !== "closed")
+                continue;
+            this.pruneEvents(record);
+            if (this.evaluateTrigger(record)) {
+                record.state = "open";
+                record.openedAt = this.now();
+                triggered = {
+                    breakerId: record.id,
+                    trigger: record.definition.trigger,
+                    action: record.definition.action,
+                };
+            }
+        }
+        return triggered;
+    }
+    /** Get current state of all breakers */
+    getStates() {
+        const states = [];
+        for (const record of this.breakers.values()) {
+            states.push({ id: record.id, state: record.state });
+        }
+        return states;
+    }
+    /** Prune events outside the time window */
+    pruneEvents(record) {
+        const trigger = record.definition.trigger;
+        if (!("window" in trigger))
+            return;
+        const windowMs = trigger.window * 1000;
+        const cutoff = this.now() - windowMs;
+        record.events = record.events.filter((e) => e.timestamp >= cutoff);
+    }
+    /** Evaluate whether a trigger condition has been met */
+    evaluateTrigger(record) {
+        const trigger = record.definition.trigger;
+        switch (trigger.type) {
+            case "revert_rate":
+                return this.evaluateRevertRate(record, trigger);
+            case "cumulative_slippage":
+                return this.evaluateCumulativeSlippage(record, trigger);
+            case "gas_spike":
+                return this.evaluateGasSpike(record, trigger);
+            case "oracle_deviation":
+            case "nav_drawdown":
+                // TODO: These require external price feeds
+                return false;
+        }
+    }
+    evaluateRevertRate(record, trigger) {
+        const windowMs = trigger.window * 1000;
+        const cutoff = this.now() - windowMs;
+        const recentReverts = record.events.filter((e) => e.type === "revert" && e.timestamp >= cutoff).length;
+        // Need at least 1 action to compute a rate
+        if (record.actionCount === 0)
+            return false;
+        const rate = recentReverts / record.actionCount;
+        return rate > trigger.maxPercent;
+    }
+    evaluateCumulativeSlippage(record, trigger) {
+        const windowMs = trigger.window * 1000;
+        const cutoff = this.now() - windowMs;
+        const totalSlippage = record.events
+            .filter((e) => e.type === "slippage" && e.timestamp >= cutoff)
+            .reduce((sum, e) => sum + (e.value ?? 0), 0);
+        return totalSlippage > trigger.maxBps;
+    }
+    evaluateGasSpike(record, trigger) {
+        const gasEvents = record.events.filter((e) => e.type === "gas");
+        if (gasEvents.length < 2)
+            return false;
+        const latest = gasEvents[gasEvents.length - 1];
+        if (!latest)
+            return false;
+        const previous = gasEvents.slice(0, -1);
+        const avg = previous.reduce((sum, e) => sum + (e.value ?? 0), 0) / previous.length;
+        if (avg === 0)
+            return false;
+        return (latest.value ?? 0) / avg > trigger.maxMultiple;
+    }
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/runtime/circuit-breaker.js.map

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

package/dist/runtime/context.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Execution Context
+ * Manages state during spell execution
+ */
+import type { CallFrame, ExecutionContext, LedgerEntry, LedgerEvent } from "../types/execution.js";
+import type { SpellIR } from "../types/ir.js";
+import type { PolicySet } from "../types/policy.js";
+import type { Address, ChainId } from "../types/primitives.js";
+/**
+ * Options for creating an execution context
+ */
+export interface CreateContextOptions {
+    spell: SpellIR;
+    policy?: PolicySet;
+    vault: Address;
+    chain: ChainId;
+    params?: Record<string, unknown>;
+    persistentState?: Record<string, unknown>;
+}
+/**
+ * Create a new execution context
+ */
+export declare function createContext(options: CreateContextOptions): ExecutionContext;
+/**
+ * Push a call frame onto the stack
+ */
+export declare function pushFrame(ctx: ExecutionContext, stepId: string, iteration?: number, branch?: string): void;
+/**
+ * Pop a call frame from the stack
+ */
+export declare function popFrame(ctx: ExecutionContext): CallFrame | undefined;
+/**
+ * Set a binding value
+ */
+export declare function setBinding(ctx: ExecutionContext, name: string, value: unknown): void;
+/**
+ * Get a binding value
+ */
+export declare function getBinding(ctx: ExecutionContext, name: string): unknown;
+/**
+ * Update persistent state
+ */
+export declare function setPersistentState(ctx: ExecutionContext, key: string, value: unknown): void;
+/**
+ * Update ephemeral state
+ */
+export declare function setEphemeralState(ctx: ExecutionContext, key: string, value: unknown): void;
+/**
+ * Mark a step as executed
+ */
+export declare function markStepExecuted(ctx: ExecutionContext, stepId: string): void;
+/**
+ * Increment action counter
+ */
+export declare function incrementActions(ctx: ExecutionContext): void;
+/**
+ * Add gas used
+ */
+export declare function addGasUsed(ctx: ExecutionContext, gas: bigint): void;
+/**
+ * Increment error counter
+ */
+export declare function incrementErrors(ctx: ExecutionContext): void;
+/**
+ * Increment retry counter
+ */
+export declare function incrementRetries(ctx: ExecutionContext): void;
+/**
+ * Increment advisory call counter
+ */
+export declare function incrementAdvisoryCalls(ctx: ExecutionContext): void;
+/**
+ * Check if a step has been executed
+ */
+export declare function isStepExecuted(ctx: ExecutionContext, stepId: string): boolean;
+/**
+ * Get persistent state as a plain object
+ */
+export declare function getPersistentStateObject(ctx: ExecutionContext): Record<string, unknown>;
+/**
+ * Simple in-memory ledger for Mode 1
+ */
+export declare class InMemoryLedger {
+    private entries;
+    private runId;
+    private spellId;
+    constructor(runId: string, spellId: string);
+    emit(event: LedgerEvent): void;
+    getEntries(): LedgerEntry[];
+    toJSON(): object;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/runtime/context.d.ts.map

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

package/dist/runtime/context.js

@@ -0,0 +1,219 @@
+/**
+ * Execution Context
+ * Manages state during spell execution
+ */
+/**
+ * Create a new execution context
+ */
+export function createContext(options) {
+    const { spell, policy, vault, chain, params = {}, persistentState = {} } = options;
+    // Generate run ID
+    const now = new Date();
+    const timestamp = now
+        .toISOString()
+        .replace(/[-:]/g, "")
+        .replace(/\.\d+Z$/, "");
+    const random = Math.random().toString(36).slice(2, 8);
+    const runId = `${timestamp}-${random}`;
+    // Initialize state from schema
+    const persistent = new Map();
+    const ephemeral = new Map();
+    // Load persistent state schema defaults
+    for (const [key, field] of Object.entries(spell.state.persistent)) {
+        persistent.set(key, persistentState[key] ?? field.initialValue);
+    }
+    // Initialize ephemeral state from schema
+    for (const [key, field] of Object.entries(spell.state.ephemeral)) {
+        ephemeral.set(key, field.initialValue);
+    }
+    // Initialize bindings with state defaults first
+    const bindings = new Map();
+    for (const [key, value] of persistent.entries()) {
+        bindings.set(key, value);
+    }
+    for (const [key, value] of ephemeral.entries()) {
+        bindings.set(key, value);
+    }
+    // Initialize bindings with params (override state keys if same name)
+    for (const param of spell.params) {
+        const value = params[param.name] ?? param.default;
+        bindings.set(param.name, value);
+    }
+    // Make asset symbols available as string bindings (e.g., ETH → "ETH")
+    // and the "assets" array itself for `for asset in assets:` loops
+    for (const asset of spell.assets) {
+        bindings.set(asset.symbol, asset.symbol);
+    }
+    bindings.set("assets", spell.assets.map((a) => a.symbol));
+    // Make limits available as a "limits" object binding so `limits.x` property
+    // access works at runtime (limits are stored as params with "limit_" prefix)
+    const limitsObj = {};
+    for (const param of spell.params) {
+        if (param.name.startsWith("limit_")) {
+            const key = param.name.slice("limit_".length);
+            limitsObj[key] = params[param.name] ?? param.default;
+        }
+    }
+    if (Object.keys(limitsObj).length > 0) {
+        bindings.set("limits", limitsObj);
+    }
+    return {
+        spell,
+        policy,
+        runId,
+        startTime: now.getTime(),
+        trigger: { type: "manual" },
+        vault,
+        chain,
+        state: { persistent, ephemeral },
+        bindings,
+        callStack: [],
+        executedSteps: [],
+        metrics: {
+            stepsExecuted: 0,
+            actionsExecuted: 0,
+            gasUsed: 0n,
+            advisoryCalls: 0,
+            errors: 0,
+            retries: 0,
+        },
+    };
+}
+/**
+ * Push a call frame onto the stack
+ */
+export function pushFrame(ctx, stepId, iteration, branch) {
+    ctx.callStack.push({
+        stepId,
+        startTime: Date.now(),
+        iteration,
+        branch,
+    });
+}
+/**
+ * Pop a call frame from the stack
+ */
+export function popFrame(ctx) {
+    return ctx.callStack.pop();
+}
+/**
+ * Set a binding value
+ */
+export function setBinding(ctx, name, value) {
+    ctx.bindings.set(name, value);
+    if (ctx.state.persistent.has(name)) {
+        ctx.state.persistent.set(name, value);
+    }
+    else if (ctx.state.ephemeral.has(name)) {
+        ctx.state.ephemeral.set(name, value);
+    }
+}
+/**
+ * Get a binding value
+ */
+export function getBinding(ctx, name) {
+    return ctx.bindings.get(name);
+}
+/**
+ * Update persistent state
+ */
+export function setPersistentState(ctx, key, value) {
+    ctx.state.persistent.set(key, value);
+    ctx.bindings.set(key, value);
+}
+/**
+ * Update ephemeral state
+ */
+export function setEphemeralState(ctx, key, value) {
+    ctx.state.ephemeral.set(key, value);
+    ctx.bindings.set(key, value);
+}
+/**
+ * Mark a step as executed
+ */
+export function markStepExecuted(ctx, stepId) {
+    ctx.executedSteps.push(stepId);
+    ctx.metrics.stepsExecuted++;
+}
+/**
+ * Increment action counter
+ */
+export function incrementActions(ctx) {
+    ctx.metrics.actionsExecuted++;
+}
+/**
+ * Add gas used
+ */
+export function addGasUsed(ctx, gas) {
+    ctx.metrics.gasUsed += gas;
+}
+/**
+ * Increment error counter
+ */
+export function incrementErrors(ctx) {
+    ctx.metrics.errors++;
+}
+/**
+ * Increment retry counter
+ */
+export function incrementRetries(ctx) {
+    ctx.metrics.retries++;
+}
+/**
+ * Increment advisory call counter
+ */
+export function incrementAdvisoryCalls(ctx) {
+    ctx.metrics.advisoryCalls++;
+}
+/**
+ * Check if a step has been executed
+ */
+export function isStepExecuted(ctx, stepId) {
+    return ctx.executedSteps.includes(stepId);
+}
+/**
+ * Get persistent state as a plain object
+ */
+export function getPersistentStateObject(ctx) {
+    const obj = {};
+    for (const [key, value] of ctx.state.persistent) {
+        obj[key] = value;
+    }
+    return obj;
+}
+/**
+ * Simple in-memory ledger for Mode 1
+ */
+export class InMemoryLedger {
+    entries = [];
+    runId;
+    spellId;
+    constructor(runId, spellId) {
+        this.runId = runId;
+        this.spellId = spellId;
+    }
+    emit(event) {
+        this.entries.push({
+            id: `evt_${this.entries.length.toString().padStart(3, "0")}`,
+            timestamp: Date.now(),
+            runId: this.runId,
+            spellId: this.spellId,
+            event,
+        });
+    }
+    getEntries() {
+        return [...this.entries];
+    }
+    toJSON() {
+        return {
+            runId: this.runId,
+            spellId: this.spellId,
+            events: this.entries.map((e) => ({
+                id: e.id,
+                timestamp: new Date(e.timestamp).toISOString(),
+                event: e.event,
+            })),
+        };
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/runtime/context.js.map

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

package/dist/runtime/error-classifier.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Error Classifier
+ * Maps error messages to typed ErrorType values for catch block matching
+ */
+import type { ErrorType } from "../types/steps.js";
+/**
+ * Classify an error message into a typed ErrorType.
+ * Returns null if no pattern matches.
+ */
+export declare function classifyError(error: string): ErrorType | null;
+/**
+ * Check whether an error type matches a catch block's error type filter.
+ * Wildcard "*" matches any error (including unclassified ones).
+ */
+export declare function matchesCatchBlock(errorType: ErrorType | null, catchErrorType: ErrorType | "*"): boolean;
+//# sourceMappingURL=error-classifier.d.ts.map

package/dist/runtime/error-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-classifier.d.ts","sourceRoot":"","sources":["../../src/runtime/error-classifier.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAenD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAO7D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,SAAS,GAAG,IAAI,EAC3B,cAAc,EAAE,SAAS,GAAG,GAAG,GAC9B,OAAO,CAGT"}

package/dist/runtime/error-classifier.js

@@ -0,0 +1,38 @@
+/**
+ * Error Classifier
+ * Maps error messages to typed ErrorType values for catch block matching
+ */
+const ERROR_PATTERNS = [
+    [/slippage/i, "slippage_exceeded"],
+    [/insufficient.*liquidity/i, "insufficient_liquidity"],
+    [/insufficient.*(?:balance|funds)/i, "insufficient_balance"],
+    [/venue.*(?:unavailable|down)/i, "venue_unavailable"],
+    [/deadline/i, "deadline_exceeded"],
+    [/simulation.*fail/i, "simulation_failed"],
+    [/policy.*violation/i, "policy_violation"],
+    [/guard.*fail/i, "guard_failed"],
+    [/revert/i, "tx_reverted"],
+    [/(?:gas.*exceed|out.*gas)/i, "gas_exceeded"],
+];
+/**
+ * Classify an error message into a typed ErrorType.
+ * Returns null if no pattern matches.
+ */
+export function classifyError(error) {
+    for (const [pattern, errorType] of ERROR_PATTERNS) {
+        if (pattern.test(error)) {
+            return errorType;
+        }
+    }
+    return null;
+}
+/**
+ * Check whether an error type matches a catch block's error type filter.
+ * Wildcard "*" matches any error (including unclassified ones).
+ */
+export function matchesCatchBlock(errorType, catchErrorType) {
+    if (catchErrorType === "*")
+        return true;
+    return errorType === catchErrorType;
+}
+//# sourceMappingURL=error-classifier.js.map

package/dist/runtime/error-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-classifier.js","sourceRoot":"","sources":["../../src/runtime/error-classifier.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,cAAc,GAA+B;IACjD,CAAC,WAAW,EAAE,mBAAmB,CAAC;IAClC,CAAC,0BAA0B,EAAE,wBAAwB,CAAC;IACtD,CAAC,kCAAkC,EAAE,sBAAsB,CAAC;IAC5D,CAAC,8BAA8B,EAAE,mBAAmB,CAAC;IACrD,CAAC,WAAW,EAAE,mBAAmB,CAAC;IAClC,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;IAC1C,CAAC,oBAAoB,EAAE,kBAAkB,CAAC;IAC1C,CAAC,cAAc,EAAE,cAAc,CAAC;IAChC,CAAC,SAAS,EAAE,aAAa,CAAC;IAC1B,CAAC,2BAA2B,EAAE,cAAc,CAAC;CAC9C,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,KAAK,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,cAAc,EAAE,CAAC;QAClD,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAA2B,EAC3B,cAA+B;IAE/B,IAAI,cAAc,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACxC,OAAO,SAAS,KAAK,cAAc,CAAC;AACtC,CAAC"}

package/dist/runtime/expression-evaluator.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Expression Evaluator
+ * Evaluates Expression IR nodes to concrete values
+ */
+import type { ExecutionContext } from "../types/execution.js";
+import type { Expression } from "../types/expressions.js";
+export type EvalValue = string | number | boolean | bigint | unknown[] | Record<string, unknown> | null;
+export interface EvalContext {
+    params: Map<string, unknown>;
+    bindings: Map<string, unknown>;
+    state: {
+        persistent: Map<string, unknown>;
+        ephemeral: Map<string, unknown>;
+    };
+    item?: unknown;
+    index?: number;
+    queryBalance?: (asset: string, address?: string) => Promise<bigint>;
+    queryPrice?: (base: string, quote: string, source?: string) => Promise<number>;
+    queryApy?: (venue: string, asset: string) => Promise<number>;
+    queryHealthFactor?: (venue: string) => Promise<number>;
+    queryPosition?: (venue: string, asset: string) => Promise<unknown>;
+    queryDebt?: (venue: string, asset: string) => Promise<bigint>;
+}
+/**
+ * Evaluate an expression synchronously (for non-async expressions)
+ */
+export declare function evaluate(expr: Expression, ctx: EvalContext): EvalValue;
+/**
+ * Evaluate an expression asynchronously (for blockchain queries)
+ */
+export declare function evaluateAsync(expr: Expression, ctx: EvalContext): Promise<EvalValue>;
+/**
+ * Create an evaluation context from execution context
+ */
+export declare function createEvalContext(execCtx: ExecutionContext): EvalContext;
+//# sourceMappingURL=expression-evaluator.d.ts.map

package/dist/runtime/expression-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression-evaluator.d.ts","sourceRoot":"","sources":["../../src/runtime/expression-evaluator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErE,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,GACN,OAAO,EAAE,GACT,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB,IAAI,CAAC;AAET,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,EAAE;QACL,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,CAAC;IACF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACpE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/E,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7D,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnE,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,GAAG,SAAS,CAwFtE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CA6C1F;AA8QD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,WAAW,CAWxE"}