@executioncontrolprotocol/core 0.10.0

package/dist/runtime/in-memory-executor.js

@@ -0,0 +1,328 @@
+import { LATEST_ECP_VERSION } from "@executioncontrolprotocol/types";
+import { createConsoleLogger, createUsageLedger, } from "./context.js";
+import { emitLifecycle } from "./lifecycle.js";
+import { pendingToMutationRecords } from "./mutation-records.js";
+import { evaluatePolicies } from "./policy-engine.js";
+import { resolveStepInput } from "./resolve-input.js";
+import { collectStateHandles, createMutationBuffer, createTransactionalStore, } from "./store.js";
+import { commitTransaction } from "./commit.js";
+function newRunId() {
+    return globalThis.crypto.randomUUID();
+}
+function throwIfAborted(signal) {
+    if (signal?.aborted) {
+        throw new DOMException("Run aborted", "AbortError");
+    }
+}
+function evalExpr(expr, state) {
+    if (!expr)
+        return true;
+    if ("eq" in expr && Array.isArray(expr.eq)) {
+        const [path, expected] = expr.eq;
+        const parts = String(path).split(".");
+        let cur = state;
+        for (const p of parts) {
+            if (cur && typeof cur === "object")
+                cur = cur[p];
+        }
+        return cur === expected;
+    }
+    return true;
+}
+async function runWithConcurrency(tasks, maxConcurrency) {
+    const results = new Array(tasks.length);
+    let index = 0;
+    const workers = Array.from({ length: Math.min(maxConcurrency, tasks.length) }, async () => {
+        while (index < tasks.length) {
+            const i = index++;
+            results[i] = await tasks[i]();
+        }
+    });
+    await Promise.all(workers);
+    return results;
+}
+/** Platform-neutral in-memory workflow executor. @category Runtime */
+export class InMemoryRuntimeExecutor {
+    async execute(manifest, context) {
+        const runId = context.runId || newRunId();
+        const signal = context.signal;
+        const maxConcurrency = context.maxConcurrency ??
+            context.bindings.runtime.config.maxConcurrency ??
+            4;
+        const state = { ...context.input };
+        const history = {};
+        const usage = createUsageLedger();
+        const logger = createConsoleLogger();
+        const extensionHooks = context.bindings.extensionHooks;
+        const runBase = {
+            workflow: manifest,
+            run: { id: runId, input: context.input },
+            state,
+        };
+        await emitLifecycle("run:before", extensionHooks, {
+            event: "run:before",
+            ...runBase,
+        });
+        await emitLifecycle("run:started", extensionHooks, {
+            event: "run:started",
+            ...runBase,
+        });
+        try {
+            throwIfAborted(signal);
+            await this.runNodes(manifest.steps, {
+                manifest,
+                runId,
+                state,
+                history,
+                usage,
+                logger,
+                context,
+                extensionHooks,
+                signal,
+                maxConcurrency,
+            });
+            await emitLifecycle("run:completed", extensionHooks, {
+                event: "run:completed",
+                ...runBase,
+                state,
+            });
+            return {
+                schema: "@executioncontrolprotocol.run.result",
+                version: LATEST_ECP_VERSION,
+                run: { id: runId, status: "completed" },
+                state,
+                history,
+                usage: { ...usage },
+            };
+        }
+        catch (err) {
+            if (signal?.aborted || (err instanceof DOMException && err.name === "AbortError")) {
+                await emitLifecycle("run:cancelled", extensionHooks, {
+                    event: "run:cancelled",
+                    ...runBase,
+                    state,
+                });
+                return {
+                    schema: "@executioncontrolprotocol.run.result",
+                    version: LATEST_ECP_VERSION,
+                    run: { id: runId, status: "cancelled" },
+                    state,
+                    history,
+                    usage: { ...usage },
+                };
+            }
+            await emitLifecycle("run:failed", extensionHooks, {
+                event: "run:failed",
+                ...runBase,
+                state,
+            });
+            return {
+                schema: "@executioncontrolprotocol.run.result",
+                version: LATEST_ECP_VERSION,
+                run: { id: runId, status: "failed" },
+                state,
+                history,
+                usage: { ...usage },
+            };
+        }
+        finally {
+            await emitLifecycle("run:finally", extensionHooks, {
+                event: "run:finally",
+                ...runBase,
+                state,
+            });
+        }
+    }
+    async runNodes(nodes, ctx) {
+        for (const node of nodes) {
+            throwIfAborted(ctx.signal);
+            await this.runNode(node, ctx);
+        }
+    }
+    async runNode(node, ctx) {
+        if (node.type === "parallel") {
+            const tasks = node.branches.map((branch) => () => this.runNodes(branch, ctx));
+            await runWithConcurrency(tasks, ctx.maxConcurrency);
+            return;
+        }
+        if (node.type === "branch") {
+            for (const b of node.branches) {
+                if (evalExpr(b.when, ctx.state)) {
+                    await this.runNodes(b.steps, ctx);
+                    break;
+                }
+            }
+            return;
+        }
+        if (node.type === "loop") {
+            let rounds = 0;
+            while (!node.until || !evalExpr(node.until, ctx.state)) {
+                throwIfAborted(ctx.signal);
+                if (node.maxRounds !== undefined && rounds >= node.maxRounds)
+                    break;
+                await this.runNodes(node.steps, ctx);
+                rounds++;
+                if (node.until && evalExpr(node.until, ctx.state))
+                    break;
+            }
+            return;
+        }
+        const step = node;
+        if (step.when && !evalExpr(step.when, ctx.state))
+            return;
+        await this.executeStep(step, ctx);
+    }
+    async executeStep(step, ctx) {
+        throwIfAborted(ctx.signal);
+        const cap = ctx.context.registry.getCapability(step.uses);
+        if (!cap) {
+            throw new Error(`Unknown capability: ${step.uses}`);
+        }
+        const stepCtx = {
+            id: step.id,
+            capabilityId: step.uses,
+            label: step.label,
+        };
+        const stepRecord = { status: "failed" };
+        let output;
+        let buffer;
+        let policyCtxBase;
+        const lifecycleBase = {
+            workflow: ctx.manifest,
+            run: { id: ctx.runId, input: ctx.context.input },
+            step: stepCtx,
+            state: ctx.state,
+        };
+        const runStepFinally = async () => {
+            await emitLifecycle("step:finally", ctx.extensionHooks, {
+                event: "step:finally",
+                ...lifecycleBase,
+            });
+            if (policyCtxBase) {
+                await evaluatePolicies("policy:finally", ctx.context.bindings.policyHooks, {
+                    ...policyCtxBase,
+                    output,
+                });
+            }
+        };
+        try {
+            await emitLifecycle("step:before", ctx.extensionHooks, {
+                event: "step:before",
+                ...lifecycleBase,
+            });
+            const resolvedInput = resolveStepInput(step.input, ctx.state);
+            const mutableHandles = collectStateHandles(resolvedInput);
+            const stateBeforeMutations = structuredClone(ctx.state);
+            policyCtxBase = {
+                workflow: ctx.manifest,
+                run: { id: ctx.runId, input: ctx.context.input },
+                step: stepCtx,
+                state: ctx.state,
+                input: resolvedInput,
+                mutableStateHandles: [...mutableHandles].map((p) => ({
+                    path: p,
+                    __brand: undefined,
+                })),
+                usage: ctx.usage,
+            };
+            const preDecision = await evaluatePolicies("policy:pre", ctx.context.bindings.policyHooks, policyCtxBase);
+            if (preDecision.type === "deny") {
+                stepRecord.status = "failed";
+                return;
+            }
+            if (preDecision.type === "pause") {
+                stepRecord.status = "paused";
+                return;
+            }
+            throwIfAborted(ctx.signal);
+            buffer = createMutationBuffer(ctx.state, mutableHandles);
+            const store = createTransactionalStore({
+                state: ctx.state,
+                buffer,
+                allowedHandles: mutableHandles,
+            });
+            const extId = step.uses.replace(/\.[^.]+$/, "");
+            const extBinding = ctx.context.bindings.extensions.find((e) => e.id === extId);
+            const capCtx = {
+                store,
+                state: ctx.state,
+                run: { id: ctx.runId, input: ctx.context.input },
+                step: stepCtx,
+                logger: ctx.logger,
+                usage: ctx.usage,
+                extensionConfig: extBinding?.config,
+                capabilities: {
+                    call: async (id, input) => {
+                        const c = ctx.context.registry.getCapability(id);
+                        if (!c)
+                            throw new Error(`Unknown capability: ${id}`);
+                        return c.handler(input, capCtx);
+                    },
+                },
+            };
+            await emitLifecycle("step:started", ctx.extensionHooks, {
+                event: "step:started",
+                ...lifecycleBase,
+            });
+            try {
+                output = await cap.handler(resolvedInput, capCtx);
+            }
+            catch {
+                buffer.discard();
+                await emitLifecycle("step:failed", ctx.extensionHooks, {
+                    event: "step:failed",
+                    ...lifecycleBase,
+                });
+                stepRecord.status = "failed";
+                return;
+            }
+            throwIfAborted(ctx.signal);
+            const proposedState = buffer.preview(ctx.state);
+            const postDecision = await evaluatePolicies("policy:post", ctx.context.bindings.policyHooks, {
+                ...policyCtxBase,
+                output,
+                pendingMutations: buffer.pending(),
+                proposedState,
+            });
+            if (postDecision.type === "deny" || postDecision.type === "pause") {
+                buffer.discard();
+                stepRecord.status = postDecision.type === "pause" ? "paused" : "failed";
+                stepRecord.output = output;
+                return;
+            }
+            if (ctx.signal?.aborted) {
+                buffer.discard();
+                await emitLifecycle("step:cancelled", ctx.extensionHooks, {
+                    event: "step:cancelled",
+                    ...lifecycleBase,
+                });
+                stepRecord.status = "cancelled";
+                throw new DOMException("Step aborted", "AbortError");
+            }
+            const pending = buffer.pending();
+            commitTransaction({
+                state: ctx.state,
+                mutations: pending,
+                output,
+                as: step.as,
+                mode: step.mode,
+            });
+            stepRecord.status = "completed";
+            stepRecord.output = output;
+            stepRecord.committedAs = step.as ?? null;
+            stepRecord.mutations = pendingToMutationRecords(pending, step.id, step.uses, stateBeforeMutations);
+            await emitLifecycle("step:completed", ctx.extensionHooks, {
+                event: "step:completed",
+                ...lifecycleBase,
+                output,
+            });
+        }
+        finally {
+            ctx.history[step.id] = stepRecord;
+            if (policyCtxBase) {
+                await runStepFinally();
+            }
+        }
+    }
+}
+//# sourceMappingURL=in-memory-executor.js.map

package/dist/runtime/in-memory-executor.js.map

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

package/dist/runtime/lifecycle.d.ts

@@ -0,0 +1,6 @@
+import type { LifecycleEvent } from "@executioncontrolprotocol/types";
+import type { HookDefinition } from "../definitions/types.js";
+import type { LifecycleContext } from "./context.js";
+/** Emit extension lifecycle hooks. */
+export declare function emitLifecycle(event: LifecycleEvent, hooks: HookDefinition[], ctx: LifecycleContext): Promise<void>;
+//# sourceMappingURL=lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/runtime/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAEpD,sCAAsC;AACtC,wBAAsB,aAAa,CACjC,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,cAAc,EAAE,EACvB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/runtime/lifecycle.js

@@ -0,0 +1,10 @@
+/** Emit extension lifecycle hooks. */
+export async function emitLifecycle(event, hooks, ctx) {
+    const sorted = [...hooks]
+        .filter((h) => h.event === event)
+        .sort((a, b) => (a.priority ?? 0) - (b.priority ?? 0));
+    for (const hook of sorted) {
+        await hook.handler(ctx);
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/runtime/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/runtime/lifecycle.ts"],"names":[],"mappings":"AAIA,sCAAsC;AACtC,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAqB,EACrB,KAAuB,EACvB,GAAqB;IAErB,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC;SACtB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC;SAChC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAA;IAExD,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACzB,CAAC;AACH,CAAC"}

package/dist/runtime/mutation-records.d.ts

@@ -0,0 +1,4 @@
+import type { MutationRecord, PendingMutation } from "@executioncontrolprotocol/types";
+/** Map staged mutations to committed audit records. */
+export declare function pendingToMutationRecords(pending: PendingMutation[], stepId: string, capability: string, stateBefore: Record<string, unknown>): MutationRecord[];
+//# sourceMappingURL=mutation-records.d.ts.map

package/dist/runtime/mutation-records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-records.d.ts","sourceRoot":"","sources":["../../src/runtime/mutation-records.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AAYtF,uDAAuD;AACvD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,eAAe,EAAE,EAC1B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,cAAc,EAAE,CAelB"}

package/dist/runtime/mutation-records.js

@@ -0,0 +1,28 @@
+function getAtPath(obj, path) {
+    const parts = path.split(".");
+    let cur = obj;
+    for (const p of parts) {
+        if (cur === null || cur === undefined || typeof cur !== "object")
+            return undefined;
+        cur = cur[p];
+    }
+    return cur;
+}
+/** Map staged mutations to committed audit records. */
+export function pendingToMutationRecords(pending, stepId, capability, stateBefore) {
+    const timestamp = new Date().toISOString();
+    return pending.map((m) => ({
+        id: m.id,
+        op: m.op,
+        path: m.path,
+        before: getAtPath(stateBefore, m.path),
+        after: m.value,
+        ...(m.reason ? { reason: m.reason } : {}),
+        ...(m.metadata ? { metadata: m.metadata } : {}),
+        status: "committed",
+        stepId,
+        capability,
+        timestamp,
+    }));
+}
+//# sourceMappingURL=mutation-records.js.map

package/dist/runtime/mutation-records.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-records.js","sourceRoot":"","sources":["../../src/runtime/mutation-records.ts"],"names":[],"mappings":"AAEA,SAAS,SAAS,CAAC,GAA4B,EAAE,IAAY;IAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC7B,IAAI,GAAG,GAAY,GAAG,CAAA;IACtB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAA;QAClF,GAAG,GAAI,GAA+B,CAAC,CAAC,CAAC,CAAA;IAC3C,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,wBAAwB,CACtC,OAA0B,EAC1B,MAAc,EACd,UAAkB,EAClB,WAAoC;IAEpC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAC1C,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACzB,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,MAAM,EAAE,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC;QACtC,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,MAAM,EAAE,WAAoB;QAC5B,MAAM;QACN,UAAU;QACV,SAAS;KACV,CAAC,CAAC,CAAA;AACL,CAAC"}

package/dist/runtime/policy-engine.d.ts

@@ -0,0 +1,13 @@
+import type { PolicyDecision, PolicyLifecycleEvent } from "@executioncontrolprotocol/types";
+import type { HookDefinition } from "../definitions/types.js";
+import type { PolicyContext } from "./context.js";
+/** Combine policy decisions per spec. */
+export declare function combinePolicyDecisions(decisions: PolicyDecision[]): PolicyDecision;
+type PolicyHookEntry = {
+    hook: HookDefinition;
+    config: Record<string, unknown>;
+};
+/** Evaluate policy hooks for an event. */
+export declare function evaluatePolicies(event: PolicyLifecycleEvent, hooks: PolicyHookEntry[], ctx: PolicyContext): Promise<PolicyDecision>;
+export {};
+//# sourceMappingURL=policy-engine.d.ts.map

package/dist/runtime/policy-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-engine.d.ts","sourceRoot":"","sources":["../../src/runtime/policy-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAA;AAC3F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD,yCAAyC;AACzC,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,cAAc,EAAE,GAC1B,cAAc,CAUhB;AAED,KAAK,eAAe,GAAG;IACrB,IAAI,EAAE,cAAc,CAAA;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC,CAAA;AAED,0CAA0C;AAC1C,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,eAAe,EAAE,EACxB,GAAG,EAAE,aAAa,GACjB,OAAO,CAAC,cAAc,CAAC,CA8BzB"}

package/dist/runtime/policy-engine.js

@@ -0,0 +1,46 @@
+/** Combine policy decisions per spec. */
+export function combinePolicyDecisions(decisions) {
+    if (decisions.some((d) => d.type === "deny")) {
+        return decisions.find((d) => d.type === "deny");
+    }
+    if (decisions.some((d) => d.type === "pause")) {
+        return decisions.find((d) => d.type === "pause");
+    }
+    const modify = decisions.filter((d) => d.type === "modify");
+    if (modify.length > 0)
+        return modify[0];
+    return { type: "allow" };
+}
+/** Evaluate policy hooks for an event. */
+export async function evaluatePolicies(event, hooks, ctx) {
+    const relevant = hooks
+        .filter((h) => h.hook.event === event)
+        .sort((a, b) => (a.hook.priority ?? 0) - (b.hook.priority ?? 0));
+    const decisions = [];
+    for (const { hook, config } of relevant) {
+        const result = await hook.handler({
+            event,
+            workflow: ctx.workflow,
+            run: ctx.run,
+            step: ctx.step,
+            state: ctx.state,
+            input: ctx.input,
+            output: ctx.output,
+            usage: ctx.usage,
+            mutableStateHandles: ctx.mutableStateHandles,
+            pendingMutations: ctx.pendingMutations,
+            proposedState: ctx.proposedState,
+            scope: ctx.scope,
+            operation: ctx.operation,
+            registryRequest: ctx.registryRequest,
+            config,
+        });
+        if (result && typeof result === "object" && "type" in result) {
+            decisions.push(result);
+        }
+    }
+    if (decisions.length === 0)
+        return { type: "allow" };
+    return combinePolicyDecisions(decisions);
+}
+//# sourceMappingURL=policy-engine.js.map

package/dist/runtime/policy-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-engine.js","sourceRoot":"","sources":["../../src/runtime/policy-engine.ts"],"names":[],"mappings":"AAIA,yCAAyC;AACzC,MAAM,UAAU,sBAAsB,CACpC,SAA2B;IAE3B,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,EAAE,CAAC;QAC7C,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAE,CAAA;IAClD,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,EAAE,CAAC;QAC9C,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAE,CAAA;IACnD,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAA;IAC3D,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC,CAAC,CAAE,CAAA;IACxC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;AAC1B,CAAC;AAOD,0CAA0C;AAC1C,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAA2B,EAC3B,KAAwB,EACxB,GAAkB;IAElB,MAAM,QAAQ,GAAG,KAAK;SACnB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC;SACrC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAA;IAElE,MAAM,SAAS,GAAqB,EAAE,CAAA;IACtC,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;YAChC,KAAK;YACL,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,mBAAmB,EAAE,GAAG,CAAC,mBAAmB;YAC5C,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;YACtC,aAAa,EAAE,GAAG,CAAC,aAAa;YAChC,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,eAAe,EAAE,GAAG,CAAC,eAAe;YACpC,MAAM;SAC0E,CAAC,CAAA;QACnF,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;YAC7D,SAAS,CAAC,IAAI,CAAC,MAAwB,CAAC,CAAA;QAC1C,CAAC;IACH,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;IACpD,OAAO,sBAAsB,CAAC,SAAS,CAAC,CAAA;AAC1C,CAAC"}

package/dist/runtime/resolve-input.d.ts

@@ -0,0 +1,4 @@
+import type { InputValue } from "@executioncontrolprotocol/types";
+/** Resolve $ref values from committed state. */
+export declare function resolveStepInput(input: Record<string, InputValue> | undefined, state: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=resolve-input.d.ts.map

package/dist/runtime/resolve-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-input.d.ts","sourceRoot":"","sources":["../../src/runtime/resolve-input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAwB,MAAM,iCAAiC,CAAA;AAgBvF,gDAAgD;AAChD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,SAAS,EAC7C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6BzB"}

package/dist/runtime/resolve-input.js

@@ -0,0 +1,46 @@
+function getStatePath(ref) {
+    return ref.startsWith("state.") ? ref.slice(6) : ref;
+}
+function getAtPath(state, path) {
+    const parts = path.split(".");
+    let cur = state;
+    for (const p of parts) {
+        if (cur === null || cur === undefined || typeof cur !== "object")
+            return undefined;
+        cur = cur[p];
+    }
+    return cur;
+}
+/** Resolve $ref values from committed state. */
+export function resolveStepInput(input, state) {
+    if (!input)
+        return {};
+    function resolveValue(v) {
+        if (v !== null && typeof v === "object") {
+            if ("$ref" in v) {
+                const r = v;
+                const val = getAtPath(state, getStatePath(r.$ref));
+                if (val === undefined && r.optional)
+                    return r.fallback;
+                return val;
+            }
+            if ("$state" in v) {
+                return v;
+            }
+            if (Array.isArray(v))
+                return v.map((x) => resolveValue(x));
+            const out = {};
+            for (const [k, child] of Object.entries(v)) {
+                out[k] = resolveValue(child);
+            }
+            return out;
+        }
+        return v;
+    }
+    const out = {};
+    for (const [k, v] of Object.entries(input)) {
+        out[k] = resolveValue(v);
+    }
+    return out;
+}
+//# sourceMappingURL=resolve-input.js.map

package/dist/runtime/resolve-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-input.js","sourceRoot":"","sources":["../../src/runtime/resolve-input.ts"],"names":[],"mappings":"AAEA,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;AACtD,CAAC;AAED,SAAS,SAAS,CAAC,KAA8B,EAAE,IAAY;IAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC7B,IAAI,GAAG,GAAY,KAAK,CAAA;IACxB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAA;QAClF,GAAG,GAAI,GAA+B,CAAC,CAAC,CAAC,CAAA;IAC3C,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,gBAAgB,CAC9B,KAA6C,EAC7C,KAA8B;IAE9B,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAA;IAErB,SAAS,YAAY,CAAC,CAAa;QACjC,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YACxC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;gBAChB,MAAM,CAAC,GAAG,CAAa,CAAA;gBACvB,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;gBAClD,IAAI,GAAG,KAAK,SAAS,IAAI,CAAC,CAAC,QAAQ;oBAAE,OAAO,CAAC,CAAC,QAAQ,CAAA;gBACtD,OAAO,GAAG,CAAA;YACZ,CAAC;YACD,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;gBAClB,OAAO,CAAe,CAAA;YACxB,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;gBAAE,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAe,CAAC,CAAC,CAAA;YACxE,MAAM,GAAG,GAA4B,EAAE,CAAA;YACvC,KAAK,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3C,GAAG,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,KAAmB,CAAC,CAAA;YAC5C,CAAC;YACD,OAAO,GAAG,CAAA;QACZ,CAAC;QACD,OAAO,CAAC,CAAA;IACV,CAAC;IAED,MAAM,GAAG,GAA4B,EAAE,CAAA;IACvC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3C,GAAG,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAA;IAC1B,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/runtime/store.d.ts

@@ -0,0 +1,38 @@
+import type { PendingMutation, StoreStateHandle } from "@executioncontrolprotocol/types";
+/** Options for store reads. @category Runtime */
+export interface StoreReadOptions {
+    /** When true, include pending (uncommitted) mutations in the read. */
+    includePending?: boolean;
+}
+/** Options for store writes. @category Runtime */
+export interface StoreWriteOptions {
+    /** Human-readable reason for the mutation (policy/audit). */
+    reason?: string;
+    /** Non-standard metadata attached to the pending mutation. */
+    metadata?: Record<string, unknown>;
+}
+/** Transactional store for capability handlers. @category Runtime */
+export interface StoreContext {
+    read<T = unknown>(handleOrPath: StoreStateHandle<T> | string, options?: StoreReadOptions): Promise<T>;
+    set<T = unknown>(handle: StoreStateHandle<T>, value: T, options?: StoreWriteOptions): Promise<PendingMutation>;
+    replace<T = unknown>(handle: StoreStateHandle<T>, value: T, options?: StoreWriteOptions): Promise<PendingMutation>;
+    merge<T extends Record<string, unknown>>(handle: StoreStateHandle<T>, value: Partial<T>, options?: StoreWriteOptions): Promise<PendingMutation>;
+    append<T = unknown>(handle: StoreStateHandle<T[]>, value: T, options?: StoreWriteOptions): Promise<PendingMutation>;
+}
+export interface MutationBuffer {
+    pending(): PendingMutation[];
+    preview(state: Record<string, unknown>): Record<string, unknown>;
+    discard(): void;
+}
+export declare function createMutationBuffer(_state: Record<string, unknown>, _allowedPaths: Set<string>): MutationBuffer & {
+    push(m: PendingMutation): void;
+};
+export declare function createTransactionalStore(options: {
+    state: Record<string, unknown>;
+    buffer: MutationBuffer & {
+        push(m: PendingMutation): void;
+    };
+    allowedHandles: Set<string>;
+}): StoreContext;
+export declare function collectStateHandles(input: Record<string, unknown>): Set<string>;
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/runtime/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAOxF,iDAAiD;AACjD,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,CAAC,GAAG,OAAO,EACd,YAAY,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,MAAM,EAC1C,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,CAAC,CAAC,CAAA;IAEb,GAAG,CAAC,CAAC,GAAG,OAAO,EACb,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC3B,KAAK,EAAE,CAAC,EACR,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAAA;IAE3B,OAAO,CAAC,CAAC,GAAG,OAAO,EACjB,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC3B,KAAK,EAAE,CAAC,EACR,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAAA;IAE3B,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC3B,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EACjB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAAA;IAE3B,MAAM,CAAC,CAAC,GAAG,OAAO,EAChB,MAAM,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,EAC7B,KAAK,EAAE,CAAC,EACR,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAAA;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,IAAI,eAAe,EAAE,CAAA;IAC5B,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChE,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,GACzB,cAAc,GAAG;IAAE,IAAI,CAAC,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;CAAE,CAgCrD;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,MAAM,EAAE,cAAc,GAAG;QAAE,IAAI,CAAC,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;KAAE,CAAA;IAC3D,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAC5B,GAAG,YAAY,CAoDf;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,GAAG,CAAC,MAAM,CAAC,CAYb"}