@executioncontrolprotocol/core 0.10.0

package/dist/registry/namespace.js

@@ -0,0 +1,19 @@
+/**
+ * Match a namespaced id against an allow/deny pattern (`@customer/*` or exact).
+ * @category Runtime
+ */
+export function matchesNamespace(id, pattern) {
+    if (pattern.endsWith("/*")) {
+        const prefix = pattern.slice(0, -2);
+        return id === prefix || id.startsWith(`${prefix}/`);
+    }
+    return id === pattern;
+}
+/**
+ * Returns true if id matches any pattern in the list.
+ * @category Runtime
+ */
+export function matchesAnyNamespace(id, patterns) {
+    return patterns.some((p) => matchesNamespace(id, p));
+}
+//# sourceMappingURL=namespace.js.map

package/dist/registry/namespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.js","sourceRoot":"","sources":["../../src/registry/namespace.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAU,EAAE,OAAe;IAC1D,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QACnC,OAAO,EAAE,KAAK,MAAM,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,CAAA;IACrD,CAAC;IACD,OAAO,EAAE,KAAK,OAAO,CAAA;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAAU,EAAE,QAAkB;IAChE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;AACtD,CAAC"}

package/dist/registry/registry.d.ts

@@ -0,0 +1,45 @@
+import type { CapabilityId, NamespacedId, RegistryRegistrationRequest } from "@executioncontrolprotocol/types";
+import type { CapabilityDefinition, ExtensionDefinition, PolicyDefinition, RuntimeDefinition } from "../definitions/types.js";
+/** Guard invoked before registry registration. @category Runtime */
+export type RegistryRegistrationGuard = (request: RegistryRegistrationRequest) => void | Promise<void>;
+/**
+ * Global definition registry.
+ * @category Runtime
+ */
+export declare class Registry {
+    private runtimes;
+    private extensions;
+    private policies;
+    private capabilities;
+    private frozen;
+    private freezeReason?;
+    private guard?;
+    /** Attach a guard checked before each registration. */
+    setRegistrationGuard(guard: RegistryRegistrationGuard | undefined): void;
+    /** Lock registry; further registrations throw {@link RegistryFrozenError}. */
+    freeze(reason?: string): void;
+    /** Whether the registry accepts new registrations. */
+    isFrozen(): boolean;
+    /** Last freeze reason if frozen. */
+    getFreezeReason(): string | undefined;
+    private buildRequest;
+    private assertCanRegister;
+    /** Register a runtime definition. */
+    registerRuntime(def: RuntimeDefinition, extra?: Partial<RegistryRegistrationRequest>): Promise<void>;
+    /** Register an extension and its capabilities. */
+    registerExtension(def: ExtensionDefinition, extra?: Partial<RegistryRegistrationRequest>): Promise<void>;
+    /** Register a policy definition. */
+    registerPolicy(def: PolicyDefinition, extra?: Partial<RegistryRegistrationRequest>): Promise<void>;
+    getRuntime(id: string): RuntimeDefinition | undefined;
+    getExtension(id: string): ExtensionDefinition | undefined;
+    getPolicy(id: string): PolicyDefinition | undefined;
+    getCapability(id: string): CapabilityDefinition | undefined;
+    listCapabilities(): CapabilityDefinition[];
+    listExtensions(): ExtensionDefinition[];
+    listPolicies(): PolicyDefinition[];
+    resolveCapability(ref: CapabilityId | string): CapabilityDefinition | undefined;
+    resolveNamespacedId(ref: NamespacedId | string): NamespacedId;
+}
+/** Shared default registry. @category Runtime */
+export declare const globalRegistry: Registry;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/registry/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAA;AAC9G,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,yBAAyB,CAAA;AAGhC,oEAAoE;AACpE,MAAM,MAAM,yBAAyB,GAAG,CACtC,OAAO,EAAE,2BAA2B,KACjC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAEzB;;;GAGG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,UAAU,CAAyC;IAC3D,OAAO,CAAC,QAAQ,CAAsC;IACtD,OAAO,CAAC,YAAY,CAA0C;IAC9D,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,YAAY,CAAC,CAAQ;IAC7B,OAAO,CAAC,KAAK,CAAC,CAA2B;IAEzC,uDAAuD;IACvD,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,SAAS,GAAG,IAAI;IAIxE,8EAA8E;IAC9E,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAK7B,sDAAsD;IACtD,QAAQ,IAAI,OAAO;IAInB,oCAAoC;IACpC,eAAe,IAAI,MAAM,GAAG,SAAS;IAIrC,OAAO,CAAC,YAAY;YAaN,iBAAiB;IAS/B,qCAAqC;IAC/B,eAAe,CACnB,GAAG,EAAE,iBAAiB,EACtB,KAAK,CAAC,EAAE,OAAO,CAAC,2BAA2B,CAAC,GAC3C,OAAO,CAAC,IAAI,CAAC;IAKhB,kDAAkD;IAC5C,iBAAiB,CACrB,GAAG,EAAE,mBAAmB,EACxB,KAAK,CAAC,EAAE,OAAO,CAAC,2BAA2B,CAAC,GAC3C,OAAO,CAAC,IAAI,CAAC;IAQhB,oCAAoC;IAC9B,cAAc,CAClB,GAAG,EAAE,gBAAgB,EACrB,KAAK,CAAC,EAAE,OAAO,CAAC,2BAA2B,CAAC,GAC3C,OAAO,CAAC,IAAI,CAAC;IAKhB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIrD,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAIzD,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAInD,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAI3D,gBAAgB,IAAI,oBAAoB,EAAE;IAI1C,cAAc,IAAI,mBAAmB,EAAE;IAIvC,YAAY,IAAI,gBAAgB,EAAE;IAIlC,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAI/E,mBAAmB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,GAAG,YAAY;CAG9D;AAED,iDAAiD;AACjD,eAAO,MAAM,cAAc,UAAiB,CAAA"}

package/dist/registry/registry.js

@@ -0,0 +1,95 @@
+import { RegistryFrozenError } from "./errors.js";
+/**
+ * Global definition registry.
+ * @category Runtime
+ */
+export class Registry {
+    runtimes = new Map();
+    extensions = new Map();
+    policies = new Map();
+    capabilities = new Map();
+    frozen = false;
+    freezeReason;
+    guard;
+    /** Attach a guard checked before each registration. */
+    setRegistrationGuard(guard) {
+        this.guard = guard;
+    }
+    /** Lock registry; further registrations throw {@link RegistryFrozenError}. */
+    freeze(reason) {
+        this.frozen = true;
+        this.freezeReason = reason;
+    }
+    /** Whether the registry accepts new registrations. */
+    isFrozen() {
+        return this.frozen;
+    }
+    /** Last freeze reason if frozen. */
+    getFreezeReason() {
+        return this.freezeReason;
+    }
+    buildRequest(kind, def, extra) {
+        return {
+            kind,
+            id: def.id,
+            definition: def,
+            ...extra,
+        };
+    }
+    async assertCanRegister(request) {
+        if (this.frozen) {
+            throw new RegistryFrozenError(this.freezeReason);
+        }
+        if (this.guard) {
+            await this.guard(request);
+        }
+    }
+    /** Register a runtime definition. */
+    async registerRuntime(def, extra) {
+        await this.assertCanRegister(this.buildRequest("runtime", def, extra));
+        this.runtimes.set(def.id, def);
+    }
+    /** Register an extension and its capabilities. */
+    async registerExtension(def, extra) {
+        await this.assertCanRegister(this.buildRequest("extension", def, extra));
+        this.extensions.set(def.id, def);
+        for (const cap of def.capabilities) {
+            this.capabilities.set(cap.id, cap);
+        }
+    }
+    /** Register a policy definition. */
+    async registerPolicy(def, extra) {
+        await this.assertCanRegister(this.buildRequest("policy", def, extra));
+        this.policies.set(def.id, def);
+    }
+    getRuntime(id) {
+        return this.runtimes.get(id);
+    }
+    getExtension(id) {
+        return this.extensions.get(id);
+    }
+    getPolicy(id) {
+        return this.policies.get(id);
+    }
+    getCapability(id) {
+        return this.capabilities.get(id);
+    }
+    listCapabilities() {
+        return [...this.capabilities.values()];
+    }
+    listExtensions() {
+        return [...this.extensions.values()];
+    }
+    listPolicies() {
+        return [...this.policies.values()];
+    }
+    resolveCapability(ref) {
+        return this.capabilities.get(ref);
+    }
+    resolveNamespacedId(ref) {
+        return ref;
+    }
+}
+/** Shared default registry. @category Runtime */
+export const globalRegistry = new Registry();
+//# sourceMappingURL=registry.js.map

package/dist/registry/registry.js.map

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

package/dist/runtime/commit.d.ts

@@ -0,0 +1,11 @@
+import type { CommitMode } from "@executioncontrolprotocol/types";
+import type { PendingMutation } from "@executioncontrolprotocol/types";
+/** Apply staged mutations and step output commit. */
+export declare function commitTransaction(options: {
+    state: Record<string, unknown>;
+    mutations: PendingMutation[];
+    output: unknown;
+    as?: string;
+    mode?: CommitMode;
+}): void;
+//# sourceMappingURL=commit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commit.d.ts","sourceRoot":"","sources":["../../src/runtime/commit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AAGtE,qDAAqD;AACrD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,SAAS,EAAE,eAAe,EAAE,CAAA;IAC5B,MAAM,EAAE,OAAO,CAAA;IACf,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,UAAU,CAAA;CAClB,GAAG,IAAI,CAsCP"}

package/dist/runtime/commit.js

@@ -0,0 +1,44 @@
+import { getAtPath, setAtPath } from "../util/path.js";
+/** Apply staged mutations and step output commit. */
+export function commitTransaction(options) {
+    const { state, mutations, output, as: commitKey, mode: commitMode = "create" } = options;
+    for (const m of mutations) {
+        if (m.op === "merge" && typeof m.value === "object") {
+            const existing = getAtPath(state, m.path);
+            setAtPath(state, m.path, {
+                ...(typeof existing === "object" && existing !== null ? existing : {}),
+                ...m.value,
+            });
+        }
+        else if (m.op === "append") {
+            const existing = getAtPath(state, m.path);
+            const arr = Array.isArray(existing) ? [...existing] : [];
+            arr.push(m.value);
+            setAtPath(state, m.path, arr);
+        }
+        else {
+            setAtPath(state, m.path, m.value);
+        }
+    }
+    if (!commitKey)
+        return;
+    const existing = state[commitKey];
+    if (commitMode === "create" && existing !== undefined) {
+        throw new Error(`State key '${commitKey}' already exists (mode: create)`);
+    }
+    if (commitMode === "merge" && typeof output === "object" && output !== null) {
+        state[commitKey] = {
+            ...(typeof existing === "object" && existing !== null ? existing : {}),
+            ...output,
+        };
+    }
+    else if (commitMode === "append") {
+        const arr = Array.isArray(existing) ? [...existing] : [];
+        arr.push(output);
+        state[commitKey] = arr;
+    }
+    else {
+        state[commitKey] = output;
+    }
+}
+//# sourceMappingURL=commit.js.map

package/dist/runtime/commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit.js","sourceRoot":"","sources":["../../src/runtime/commit.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEtD,qDAAqD;AACrD,MAAM,UAAU,iBAAiB,CAAC,OAMjC;IACC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAA;IAExF,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,IAAI,CAAC,CAAC,EAAE,KAAK,OAAO,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACpD,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;YACzC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE;gBACvB,GAAG,CAAC,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtE,GAAI,CAAC,CAAC,KAAgB;aACvB,CAAC,CAAA;QACJ,CAAC;aAAM,IAAI,CAAC,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;YACzC,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;YACxD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;YACjB,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;QAC/B,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAA;QACnC,CAAC;IACH,CAAC;IAED,IAAI,CAAC,SAAS;QAAE,OAAM;IAEtB,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,CAAA;IACjC,IAAI,UAAU,KAAK,QAAQ,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,cAAc,SAAS,iCAAiC,CAAC,CAAA;IAC3E,CAAC;IACD,IAAI,UAAU,KAAK,OAAO,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAC5E,KAAK,CAAC,SAAS,CAAC,GAAG;YACjB,GAAG,CAAC,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,GAAG,MAAM;SACV,CAAA;IACH,CAAC;SAAM,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QACxD,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAChB,KAAK,CAAC,SAAS,CAAC,GAAG,GAAG,CAAA;IACxB,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,SAAS,CAAC,GAAG,MAAM,CAAA;IAC3B,CAAC;AACH,CAAC"}

package/dist/runtime/context.d.ts

@@ -0,0 +1,91 @@
+import type { LifecycleEvent, PolicyEvaluationScope, RegistryRegistrationRequest, WorkflowManifest } from "@executioncontrolprotocol/types";
+import type { PendingMutation, StoreStateHandle } from "@executioncontrolprotocol/types";
+import type { StoreContext } from "./store.js";
+/** Run-level context. @category Runtime */
+export interface RunContext {
+    id: string;
+    input: Record<string, unknown>;
+}
+/** Step execution context. @category Runtime */
+export interface StepExecutionContext {
+    id: string;
+    capabilityId: string;
+    label?: string;
+}
+/** Capability invocation context. @category Runtime */
+export interface CapabilityContext {
+    store: StoreContext;
+    state: Readonly<Record<string, unknown>>;
+    run: RunContext;
+    step: StepExecutionContext;
+    logger: Logger;
+    usage: UsageLedger;
+    capabilities: {
+        call(id: string, input: unknown): Promise<unknown>;
+    };
+}
+/** Host surface exposed on environment lifecycle hooks. @category Environment */
+export interface EnvironmentLifecycleHost {
+    registerConfigResolver(resolver: import("../environment/config-resolver.js").EnvironmentConfigResolver): void;
+    getRegistry(): import("../registry/registry.js").Registry;
+    addExtensionBinding?(ref: import("@executioncontrolprotocol/types").NamespacedId, config?: Record<string, unknown>): void;
+    /** Evaluate bound policies before accepting a registry registration. */
+    evaluateRegistryRegistration?(request: RegistryRegistrationRequest): Promise<void>;
+}
+/** Lifecycle hook context. @category Runtime */
+export interface LifecycleContext {
+    event: LifecycleEvent;
+    workflow: WorkflowManifest;
+    run: RunContext;
+    step?: StepExecutionContext;
+    state: Record<string, unknown>;
+    /** Step capability output when available (e.g. `step:completed`). */
+    output?: unknown;
+    /** Present on `environment:*` events. */
+    environment?: EnvironmentLifecycleHost;
+}
+/** Policy evaluation context. @category Policies */
+export interface PolicyContext {
+    workflow: WorkflowManifest;
+    run: RunContext;
+    step: StepExecutionContext;
+    state: Record<string, unknown>;
+    input: Record<string, unknown>;
+    output?: unknown;
+    mutableStateHandles?: StoreStateHandle[];
+    pendingMutations?: PendingMutation[];
+    proposedState?: Record<string, unknown>;
+    usage: UsageLedger;
+    /** Non-step policy scope (e.g. environment registry checks). */
+    scope?: PolicyEvaluationScope;
+    /** Operation identifier for environment-scoped checks. */
+    operation?: string;
+    /** Present when evaluating dynamic registry registration. */
+    registryRequest?: RegistryRegistrationRequest;
+    /** Present when {@link PolicyEvaluationScope} is `invoke`. */
+    capabilityId?: import("@executioncontrolprotocol/types").CapabilityId;
+}
+/** Minimal logger. @category Runtime */
+export interface Logger {
+    info(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    error(message: string, meta?: Record<string, unknown>): void;
+}
+/** Usage tracking. @category Runtime */
+export interface UsageLedger {
+    /** Number of model/provider calls made. */
+    modelCalls: number;
+    /** Accumulated cost in USD reported by providers. */
+    costUsd: number;
+    /** Accumulated token count reported by providers. */
+    tokens: number;
+    /** Technical retry attempts reported by providers or the runtime. */
+    retries: number;
+    /** Accumulate usage. Counters are mutated in place on this ledger. */
+    increment(partial: Partial<Pick<UsageLedger, "modelCalls" | "costUsd" | "tokens" | "retries">>): void;
+}
+/** Create a usage ledger. */
+export declare function createUsageLedger(): UsageLedger;
+/** Console logger implementation. */
+export declare function createConsoleLogger(): Logger;
+//# 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,32 @@
+/** Create a usage ledger. */
+export function createUsageLedger() {
+    // `increment` closes over `ledger` (the returned object) so reads of
+    // `ledger.modelCalls` etc. reflect accumulated usage. A previous version
+    // spread the counters into a new object, leaving reads permanently at 0.
+    const ledger = {
+        modelCalls: 0,
+        costUsd: 0,
+        tokens: 0,
+        retries: 0,
+        increment(partial) {
+            if (partial.modelCalls)
+                ledger.modelCalls += partial.modelCalls;
+            if (partial.costUsd)
+                ledger.costUsd += partial.costUsd;
+            if (partial.tokens)
+                ledger.tokens += partial.tokens;
+            if (partial.retries)
+                ledger.retries += partial.retries;
+        },
+    };
+    return ledger;
+}
+/** Console logger implementation. */
+export function createConsoleLogger() {
+    return {
+        info: (m, meta) => console.log(m, meta ?? ""),
+        warn: (m, meta) => console.warn(m, meta ?? ""),
+        error: (m, meta) => console.error(m, meta ?? ""),
+    };
+}
+//# 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":"AAsGA,6BAA6B;AAC7B,MAAM,UAAU,iBAAiB;IAC/B,qEAAqE;IACrE,yEAAyE;IACzE,yEAAyE;IACzE,MAAM,MAAM,GAAgB;QAC1B,UAAU,EAAE,CAAC;QACb,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,CAAC;QACT,OAAO,EAAE,CAAC;QACV,SAAS,CAAC,OAAO;YACf,IAAI,OAAO,CAAC,UAAU;gBAAE,MAAM,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,CAAA;YAC/D,IAAI,OAAO,CAAC,OAAO;gBAAE,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAA;YACtD,IAAI,OAAO,CAAC,MAAM;gBAAE,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAA;YACnD,IAAI,OAAO,CAAC,OAAO;gBAAE,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAA;QACxD,CAAC;KACF,CAAA;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;QAC7C,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;QAC9C,KAAK,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;KACjD,CAAA;AACH,CAAC"}

package/dist/runtime/executor.d.ts

@@ -0,0 +1,17 @@
+import type { RunResult, WorkflowManifest } from "@executioncontrolprotocol/types";
+/** Runtime execution options passed to the executor. @category Runtime */
+export interface RuntimeExecutionContext {
+    runId: string;
+    input: Record<string, unknown>;
+    registry: import("../registry/registry.js").Registry;
+    bindings: import("../environment/bindings.js").ResolvedBindings;
+    /** Optional cancellation signal (browser/Node). */
+    signal?: AbortSignal;
+    /** Max parallel branches (runtime config may override). */
+    maxConcurrency?: number;
+}
+/** Runtime executor interface. @category Runtime */
+export interface RuntimeExecutor {
+    execute(manifest: WorkflowManifest, context: RuntimeExecutionContext): Promise<RunResult>;
+}
+//# sourceMappingURL=executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/runtime/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAElF,0EAA0E;AAC1E,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,QAAQ,EAAE,OAAO,yBAAyB,EAAE,QAAQ,CAAA;IACpD,QAAQ,EAAE,OAAO,4BAA4B,EAAE,gBAAgB,CAAA;IAC/D,mDAAmD;IACnD,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,OAAO,CACL,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,SAAS,CAAC,CAAA;CACtB"}

package/dist/runtime/executor.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=executor.js.map

package/dist/runtime/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/runtime/executor.ts"],"names":[],"mappings":""}

package/dist/runtime/in-memory-executor.d.ts

@@ -0,0 +1,10 @@
+import type { RunResult, WorkflowManifest } from "@executioncontrolprotocol/types";
+import type { RuntimeExecutor, RuntimeExecutionContext } from "./executor.js";
+/** Platform-neutral in-memory workflow executor. @category Runtime */
+export declare class InMemoryRuntimeExecutor implements RuntimeExecutor {
+    execute(manifest: WorkflowManifest, context: RuntimeExecutionContext): Promise<RunResult>;
+    private runNodes;
+    private runNode;
+    private executeStep;
+}
+//# sourceMappingURL=in-memory-executor.d.ts.map

package/dist/runtime/in-memory-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-executor.d.ts","sourceRoot":"","sources":["../../src/runtime/in-memory-executor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,SAAS,EAGT,gBAAgB,EAEjB,MAAM,iCAAiC,CAAA;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AA2E7E,sEAAsE;AACtE,qBAAa,uBAAwB,YAAW,eAAe;IACvD,OAAO,CACX,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,SAAS,CAAC;YAgGP,QAAQ;YAOR,OAAO;YAmCP,WAAW;CAiM1B"}