@executioncontrolprotocol/core 0.10.0

package/dist/runtime/store.js

@@ -0,0 +1,97 @@
+import { getAtPath, setAtPath } from "../util/path.js";
+function randomUUID() {
+    return globalThis.crypto.randomUUID();
+}
+export function createMutationBuffer(_state, _allowedPaths) {
+    const mutations = [];
+    return {
+        pending: () => [...mutations],
+        push(m) {
+            mutations.push(m);
+        },
+        preview(base) {
+            const copy = structuredClone(base);
+            for (const m of mutations) {
+                if (m.op === "append") {
+                    const existing = getAtPath(copy, m.path);
+                    const arr = Array.isArray(existing) ? [...existing] : [];
+                    arr.push(m.value);
+                    setAtPath(copy, m.path, arr);
+                }
+                else if (m.op === "merge" && typeof m.value === "object") {
+                    const existing = getAtPath(copy, m.path);
+                    setAtPath(copy, m.path, {
+                        ...(typeof existing === "object" && existing !== null ? existing : {}),
+                        ...m.value,
+                    });
+                }
+                else {
+                    setAtPath(copy, m.path, m.value);
+                }
+            }
+            return copy;
+        },
+        discard() {
+            mutations.length = 0;
+        },
+    };
+}
+export function createTransactionalStore(options) {
+    const { state, buffer, allowedHandles } = options;
+    function pathFromHandle(handle) {
+        return typeof handle === "string" ? handle : handle.path;
+    }
+    function assertAllowed(path) {
+        if (!allowedHandles.has(path)) {
+            throw new Error(`Store write to '${path}' requires a state() handle in step input`);
+        }
+    }
+    function record(op, path, value, opts) {
+        assertAllowed(path);
+        const m = {
+            id: randomUUID(),
+            op,
+            path,
+            value,
+            status: "pending",
+            ...(opts?.reason ? { reason: opts.reason } : {}),
+            ...(opts?.metadata ? { metadata: opts.metadata } : {}),
+        };
+        buffer.push(m);
+        return m;
+    }
+    return {
+        async read(handleOrPath, readOpts) {
+            const path = pathFromHandle(handleOrPath);
+            const base = readOpts?.includePending ? buffer.preview(state) : state;
+            return getAtPath(base, path);
+        },
+        async set(handle, value, opts) {
+            return record("set", pathFromHandle(handle), value, opts);
+        },
+        async replace(handle, value, opts) {
+            return record("replace", pathFromHandle(handle), value, opts);
+        },
+        async merge(handle, value, opts) {
+            return record("merge", pathFromHandle(handle), value, opts);
+        },
+        async append(handle, value, opts) {
+            return record("append", pathFromHandle(handle), value, opts);
+        },
+    };
+}
+export function collectStateHandles(input) {
+    const paths = new Set();
+    function walk(v) {
+        if (v && typeof v === "object" && "$state" in v) {
+            paths.add(String(v.$state));
+        }
+        if (v && typeof v === "object") {
+            for (const child of Object.values(v))
+                walk(child);
+        }
+    }
+    walk(input);
+    return paths;
+}
+//# sourceMappingURL=store.js.map

package/dist/runtime/store.js.map

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

package/dist/testing/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Side-effect entry: catalogs {@link testExtension} for `extension("@executioncontrolprotocol/test")` bindings.
+ * @category Testing
+ */
+import "./test-extension.js";
+export { registerTestExtension, testExtension } from "./test-extension.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,qBAAqB,CAAA;AAE5B,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/testing/index.js

@@ -0,0 +1,7 @@
+/**
+ * Side-effect entry: catalogs {@link testExtension} for `extension("@executioncontrolprotocol/test")` bindings.
+ * @category Testing
+ */
+import "./test-extension.js";
+export { registerTestExtension, testExtension } from "./test-extension.js";
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,qBAAqB,CAAA;AAE5B,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/testing/test-extension.d.ts

@@ -0,0 +1,5 @@
+/** In-repo stub extension for examples and tests. @category Testing */
+export declare const testExtension: import("../browser-runtime-entry.js").ExtensionDefinition;
+/** Register @executioncontrolprotocol/test capabilities for examples and tests. */
+export declare function registerTestExtension(registry?: import("../registry/registry.js").Registry): Promise<void>;
+//# sourceMappingURL=test-extension.d.ts.map

package/dist/testing/test-extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-extension.d.ts","sourceRoot":"","sources":["../../src/testing/test-extension.ts"],"names":[],"mappings":"AAeA,uEAAuE;AACvE,eAAO,MAAM,aAAa,2DAgChB,CAAA;AAIV,mFAAmF;AACnF,wBAAsB,qBAAqB,CACzC,QAAQ,6CAAiB,GACxB,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/testing/test-extension.js

@@ -0,0 +1,52 @@
+import { defineExtension } from "../definitions/extension.js";
+import { capabilityFor } from "../definitions/capability.js";
+import { catalogExtension } from "../registry/extension-catalog.js";
+import { globalRegistry } from "../registry/registry.js";
+import { modelGenerateInputSchema, modelGenerateOutputSchema } from "@executioncontrolprotocol/types";
+import { testModelGenerateHandler } from "./test-model-generate.js";
+import { z } from "zod";
+const TestStubInput = z.object({ payload: z.unknown().optional() });
+const TestStubOutput = z.object({ ok: z.boolean(), result: z.unknown().optional() });
+function testStubHandler(input) {
+    return { ok: true, result: input.payload ?? "test-stub" };
+}
+/** In-repo stub extension for examples and tests. @category Testing */
+export const testExtension = defineExtension("@executioncontrolprotocol", "test")
+    .withConfig({})
+    .withCapabilities([
+    capabilityFor("@executioncontrolprotocol/test", "echo")
+        .withInput(z.object({ value: z.unknown().optional() }))
+        .withOutput(z.object({ echo: z.unknown() }))
+        .withHandler(async (input) => ({
+        echo: input.value ?? "hi",
+    })),
+    capabilityFor("@executioncontrolprotocol/test", "generate")
+        .withInput(modelGenerateInputSchema)
+        .withOutput(modelGenerateOutputSchema)
+        .withHandler(async (input) => testModelGenerateHandler(input)),
+    capabilityFor("@executioncontrolprotocol/test", "summarize")
+        .withInput(TestStubInput)
+        .withOutput(TestStubOutput)
+        .withHandler(async (input) => testStubHandler(input)),
+    capabilityFor("@executioncontrolprotocol/test", "translate")
+        .withInput(TestStubInput)
+        .withOutput(TestStubOutput)
+        .withHandler(async (input) => testStubHandler(input)),
+    capabilityFor("@executioncontrolprotocol/test", "notify")
+        .withInput(TestStubInput)
+        .withOutput(TestStubOutput)
+        .withHandler(async (input) => testStubHandler(input)),
+    capabilityFor("@executioncontrolprotocol/test", "validate")
+        .withInput(TestStubInput)
+        .withOutput(TestStubOutput)
+        .withHandler(async (input) => testStubHandler(input)),
+])
+    .build();
+catalogExtension(testExtension);
+/** Register @executioncontrolprotocol/test capabilities for examples and tests. */
+export async function registerTestExtension(registry = globalRegistry) {
+    if (!registry.getExtension("@executioncontrolprotocol/test")) {
+        await registry.registerExtension(testExtension);
+    }
+}
+//# sourceMappingURL=test-extension.js.map

package/dist/testing/test-extension.js.map

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

package/dist/testing/test-lifecycle-extension.d.ts

@@ -0,0 +1,12 @@
+import type { LifecycleEvent } from "@executioncontrolprotocol/types";
+/** Recorded extension lifecycle hook events (reset via `resetLifecycleSpy()`). */
+export declare const lifecycleSpyEvents: LifecycleEvent[];
+/** Capability invocation count for spy capabilities. */
+export declare let capabilityInvokeCount: number;
+/** Reset spy state between tests. */
+export declare function resetLifecycleSpy(): void;
+/** Lifecycle spy extension for conformance tests. @category Testing */
+export declare const lifecycleSpyExtension: import("../browser-runtime-entry.js").ExtensionDefinition;
+/** Register lifecycle spy extension on global registry. */
+export declare function registerLifecycleSpyExtension(): Promise<void>;
+//# sourceMappingURL=test-lifecycle-extension.d.ts.map

package/dist/testing/test-lifecycle-extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-lifecycle-extension.d.ts","sourceRoot":"","sources":["../../src/testing/test-lifecycle-extension.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AAQrE,kFAAkF;AAClF,eAAO,MAAM,kBAAkB,EAAE,cAAc,EAAO,CAAA;AAEtD,wDAAwD;AACxD,eAAO,IAAI,qBAAqB,QAAI,CAAA;AAEpC,qCAAqC;AACrC,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC;AAQD,uEAAuE;AACvE,eAAO,MAAM,qBAAqB,2DAmCxB,CAAA;AAIV,2DAA2D;AAC3D,wBAAsB,6BAA6B,IAAI,OAAO,CAAC,IAAI,CAAC,CAInE"}

package/dist/testing/test-lifecycle-extension.js

@@ -0,0 +1,65 @@
+import { defineExtension } from "../definitions/extension.js";
+import { capabilityFor } from "../definitions/capability.js";
+import { hook } from "../definitions/hook.js";
+import { catalogExtension } from "../registry/extension-catalog.js";
+import { globalRegistry } from "../registry/registry.js";
+import { z } from "zod";
+/** Recorded extension lifecycle hook events (reset via `resetLifecycleSpy()`). */
+export const lifecycleSpyEvents = [];
+/** Capability invocation count for spy capabilities. */
+export let capabilityInvokeCount = 0;
+/** Reset spy state between tests. */
+export function resetLifecycleSpy() {
+    lifecycleSpyEvents.length = 0;
+    capabilityInvokeCount = 0;
+}
+function spyHook(event) {
+    return hook(event, async () => {
+        lifecycleSpyEvents.push(event);
+    });
+}
+/** Lifecycle spy extension for conformance tests. @category Testing */
+export const lifecycleSpyExtension = defineExtension("@executioncontrolprotocol", "lifecycle-spy")
+    .withConfig({})
+    .withCapabilities([
+    capabilityFor("@executioncontrolprotocol/lifecycle-spy", "echo")
+        .withInput(z.object({ value: z.unknown().optional() }))
+        .withOutput(z.object({ echo: z.unknown() }))
+        .withHandler(async (input) => {
+        capabilityInvokeCount++;
+        return { echo: input.value ?? "hi" };
+    }),
+    capabilityFor("@executioncontrolprotocol/lifecycle-spy", "throw")
+        .withInput(z.object({}))
+        .withOutput(z.object({}))
+        .withHandler(async () => {
+        capabilityInvokeCount++;
+        throw new Error("capability failed");
+    }),
+    capabilityFor("@executioncontrolprotocol/lifecycle-spy", "merge-state")
+        .withInput(z.object({ target: z.unknown() }))
+        .withOutput(z.object({ ok: z.boolean() }))
+        .withHandler(async (input, ctx) => {
+        capabilityInvokeCount++;
+        const handle = input
+            .target;
+        await ctx.store.merge(handle, { merged: true });
+        return { ok: true };
+    }),
+])
+    .withHooks([
+    spyHook("step:before"),
+    spyHook("step:started"),
+    spyHook("step:completed"),
+    spyHook("step:failed"),
+    spyHook("step:finally"),
+])
+    .build();
+catalogExtension(lifecycleSpyExtension);
+/** Register lifecycle spy extension on global registry. */
+export async function registerLifecycleSpyExtension() {
+    if (!globalRegistry.getExtension("@executioncontrolprotocol/lifecycle-spy")) {
+        await globalRegistry.registerExtension(lifecycleSpyExtension);
+    }
+}
+//# sourceMappingURL=test-lifecycle-extension.js.map

package/dist/testing/test-lifecycle-extension.js.map

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

package/dist/testing/test-model-generate.d.ts

@@ -0,0 +1,15 @@
+/** Deterministic model generate handler for framework unit tests. @category Testing */
+export interface TestModelGenerateInput {
+    /** User prompt text. */
+    prompt?: string;
+    /** Optional system prompt. */
+    system?: string;
+}
+/**
+ * Deterministic generate handler for `@executioncontrolprotocol/test.generate`.
+ * @category Testing
+ */
+export declare function testModelGenerateHandler(input: TestModelGenerateInput): {
+    text: string;
+};
+//# sourceMappingURL=test-model-generate.d.ts.map

package/dist/testing/test-model-generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-model-generate.d.ts","sourceRoot":"","sources":["../../src/testing/test-model-generate.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAEvF,MAAM,WAAW,sBAAsB;IACrC,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAoCD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,sBAAsB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CA8BxF"}

package/dist/testing/test-model-generate.js

@@ -0,0 +1,71 @@
+/** Deterministic model generate handler for framework unit tests. @category Testing */
+function testIntentResponse(prompt) {
+    const lower = prompt.toLowerCase();
+    let intent = "general";
+    if (/create.*workflow|new workflow|sends.*email|build a workflow/.test(lower)) {
+        intent = "workflow-create";
+    }
+    else if (/update|patch|change.*step|modify.*workflow|failed on|help me fix/.test(lower)) {
+        intent = "workflow-patch";
+    }
+    else if (/what is ecp|how does|how do|execution control protocol/.test(lower)) {
+        intent = "faq";
+    }
+    return `INTENT ${intent}`;
+}
+function testAssistantResponse(prompt) {
+    const msgMatch = prompt.match(/User message:\s*(.+?)(?:\n|$)/i);
+    const message = (msgMatch?.[1] ?? prompt).toLowerCase();
+    if (/what is ecp|execution control protocol/.test(message)) {
+        return 'REPLY\n  ANSWER "ECP is the Execution Control Protocol: portable workflows run in governed environments that bind tools, models, policies, and runtimes."';
+    }
+    if (/what can you do|what are you good at/.test(message)) {
+        return 'REPLY\n  ANSWER "I build and patch ECP workflows, answer ECP questions, and explain capabilities registered in this environment. I cannot install extensions."';
+    }
+    if (/register|install.*extension/.test(message)) {
+        return 'REPLY\n  ANSWER "I cannot register or install extensions. I can list loaded capabilities and help you build workflows with them."';
+    }
+    if (/capabilit|extensions?|plugins?/.test(message)) {
+        return 'REPLY\n  ANSWER "Loaded capabilities include @executioncontrolprotocol/test.echo and @executioncontrolprotocol/test.summarize, @executioncontrolprotocol/test.validate, @executioncontrolprotocol/test.notify, @executioncontrolprotocol/test.translate."\n  CITATION extension @executioncontrolprotocol/test "@executioncontrolprotocol/test.echo"';
+    }
+    if (/error|fail|fix/.test(message)) {
+        return 'REPLY\n  ANSWER "The echo step failed with an error; patch the echo step input to recover."\n  CITATION step echo "Failed echo step in run context."';
+    }
+    return 'REPLY\n  ANSWER "I am the ECP assistant. Ask about workflows, ECP, or available capabilities."';
+}
+/**
+ * Deterministic generate handler for `@executioncontrolprotocol/test.generate`.
+ * @category Testing
+ */
+export function testModelGenerateHandler(input) {
+    const prompt = input.prompt ?? "";
+    const system = input.system ?? "";
+    if (/intent router/i.test(system)) {
+        return { text: testIntentResponse(prompt) };
+    }
+    if (/ECP assistant|harness\.reply|REPLY block/i.test(system)) {
+        return { text: testAssistantResponse(prompt) };
+    }
+    if (prompt.includes("User message:")) {
+        return { text: testIntentResponse(prompt) };
+    }
+    if (prompt.includes("@executioncontrolprotocol.patch") || /PATCH\s+WORKFLOW/i.test(prompt)) {
+        return {
+            text: [
+                "PATCH WORKFLOW echo-test",
+                "UPDATE STEP echo",
+                '  WITH value = "patched"',
+            ].join("\n"),
+        };
+    }
+    return {
+        text: [
+            'WORKFLOW demo-generated "Demo generated"',
+            "STEP echo USES @executioncontrolprotocol/test.echo",
+            '  LABEL "Demo Echo"',
+            '  WITH value = "hello"',
+            "  AS echo",
+        ].join("\n"),
+    };
+}
+//# sourceMappingURL=test-model-generate.js.map

package/dist/testing/test-model-generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-model-generate.js","sourceRoot":"","sources":["../../src/testing/test-model-generate.ts"],"names":[],"mappings":"AAAA,uFAAuF;AASvF,SAAS,kBAAkB,CAAC,MAAc;IACxC,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,EAAE,CAAA;IAClC,IAAI,MAAM,GAAG,SAAS,CAAA;IACtB,IAAI,6DAA6D,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9E,MAAM,GAAG,iBAAiB,CAAA;IAC5B,CAAC;SAAM,IAAI,kEAAkE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1F,MAAM,GAAG,gBAAgB,CAAA;IAC3B,CAAC;SAAM,IAAI,wDAAwD,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAChF,MAAM,GAAG,KAAK,CAAA;IAChB,CAAC;IACD,OAAO,UAAU,MAAM,EAAE,CAAA;AAC3B,CAAC;AAED,SAAS,qBAAqB,CAAC,MAAc;IAC3C,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAA;IAC/D,MAAM,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,CAAA;IACvD,IAAI,wCAAwC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3D,OAAO,2JAA2J,CAAA;IACpK,CAAC;IACD,IAAI,sCAAsC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACzD,OAAO,gKAAgK,CAAA;IACzK,CAAC;IACD,IAAI,6BAA6B,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAChD,OAAO,mIAAmI,CAAA;IAC5I,CAAC;IACD,IAAI,gCAAgC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,OAAO,sVAAsV,CAAA;IAC/V,CAAC;IACD,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACnC,OAAO,sJAAsJ,CAAA;IAC/J,CAAC;IACD,OAAO,gGAAgG,CAAA;AACzG,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAA6B;IACpE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,EAAE,CAAA;IACjC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,EAAE,CAAA;IACjC,IAAI,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAA;IAC7C,CAAC;IACD,IAAI,2CAA2C,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7D,OAAO,EAAE,IAAI,EAAE,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAA;IAChD,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QACrC,OAAO,EAAE,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAA;IAC7C,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,iCAAiC,CAAC,IAAI,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3F,OAAO;YACL,IAAI,EAAE;gBACJ,0BAA0B;gBAC1B,kBAAkB;gBAClB,0BAA0B;aAC3B,CAAC,IAAI,CAAC,IAAI,CAAC;SACb,CAAA;IACH,CAAC;IACD,OAAO;QACL,IAAI,EAAE;YACJ,0CAA0C;YAC1C,oDAAoD;YACpD,qBAAqB;YACrB,wBAAwB;YACxB,WAAW;SACZ,CAAC,IAAI,CAAC,IAAI,CAAC;KACb,CAAA;AACH,CAAC"}

package/dist/util/path.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Read a value at a lodash-style or dotted path.
+ * @category Common
+ */
+export declare function getAtPath(obj: unknown, path: string): unknown;
+/**
+ * Write a value at a lodash-style or dotted path, creating intermediate objects/arrays as needed.
+ * @category Common
+ */
+export declare function setAtPath(obj: unknown, path: string, value: unknown): void;
+/**
+ * Deep-merge plain objects (arrays and primitives from `source` replace `target`).
+ * @category Common
+ */
+export declare function deepMerge<T extends object>(target: T, source: object): T;
+//# sourceMappingURL=path.d.ts.map

package/dist/util/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/util/path.ts"],"names":[],"mappings":"AAsCA;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAc7D;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAkC1E;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,CAkBxE"}

package/dist/util/path.js

@@ -0,0 +1,116 @@
+/**
+ * Parse a lodash-style path (`steps[0].label`, `workflow.version`) into segments.
+ * @category Common
+ */
+function parsePath(path) {
+    const segments = [];
+    let i = 0;
+    while (i < path.length) {
+        if (path[i] === ".") {
+            i++;
+            continue;
+        }
+        if (path[i] === "[") {
+            const end = path.indexOf("]", i);
+            if (end === -1) {
+                throw new Error(`Invalid path: ${path}`);
+            }
+            const index = Number(path.slice(i + 1, end));
+            if (!Number.isInteger(index)) {
+                throw new Error(`Invalid path index: ${path}`);
+            }
+            segments.push(index);
+            i = end + 1;
+            continue;
+        }
+        let j = i;
+        while (j < path.length && path[j] !== "." && path[j] !== "[") {
+            j++;
+        }
+        segments.push(path.slice(i, j));
+        i = j;
+    }
+    return segments;
+}
+/**
+ * Read a value at a lodash-style or dotted path.
+ * @category Common
+ */
+export function getAtPath(obj, path) {
+    const segments = parsePath(path);
+    let cur = obj;
+    for (const seg of segments) {
+        if (cur === null || cur === undefined) {
+            return undefined;
+        }
+        if (typeof seg === "number") {
+            cur = Array.isArray(cur) ? cur[seg] : undefined;
+            continue;
+        }
+        cur = typeof cur === "object" ? cur[seg] : undefined;
+    }
+    return cur;
+}
+/**
+ * Write a value at a lodash-style or dotted path, creating intermediate objects/arrays as needed.
+ * @category Common
+ */
+export function setAtPath(obj, path, value) {
+    const segments = parsePath(path);
+    if (segments.length === 0) {
+        throw new Error("Empty path");
+    }
+    let cur = obj;
+    for (let i = 0; i < segments.length - 1; i++) {
+        const seg = segments[i];
+        const nextSeg = segments[i + 1];
+        if (typeof seg === "number") {
+            if (!Array.isArray(cur)) {
+                throw new Error(`Cannot index non-array at path: ${path}`);
+            }
+            if (cur[seg] === undefined || cur[seg] === null) {
+                cur[seg] = typeof nextSeg === "number" ? [] : {};
+            }
+            cur = cur[seg];
+            continue;
+        }
+        const record = cur;
+        if (!(seg in record) || record[seg] === null || typeof record[seg] !== "object") {
+            record[seg] = typeof nextSeg === "number" ? [] : {};
+        }
+        cur = record[seg];
+    }
+    const last = segments[segments.length - 1];
+    if (typeof last === "number") {
+        if (!Array.isArray(cur)) {
+            throw new Error(`Cannot index non-array at path: ${path}`);
+        }
+        cur[last] = value;
+        return;
+    }
+    ;
+    cur[last] = value;
+}
+/**
+ * Deep-merge plain objects (arrays and primitives from `source` replace `target`).
+ * @category Common
+ */
+export function deepMerge(target, source) {
+    const result = structuredClone(target);
+    for (const [key, value] of Object.entries(source)) {
+        const existing = result[key];
+        if (value !== null &&
+            typeof value === "object" &&
+            !Array.isArray(value) &&
+            existing !== null &&
+            typeof existing === "object" &&
+            !Array.isArray(existing)) {
+            result[key] = deepMerge(existing, value);
+        }
+        else {
+            result[key] = structuredClone(value);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=path.js.map

package/dist/util/path.js.map

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

package/dist/util/slug.d.ts

@@ -0,0 +1,3 @@
+/** Slugify a label for stable ids. */
+export declare function slugify(label: string): string;
+//# sourceMappingURL=slug.d.ts.map

package/dist/util/slug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.d.ts","sourceRoot":"","sources":["../../src/util/slug.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM7C"}

package/dist/util/slug.js

@@ -0,0 +1,9 @@
+/** Slugify a label for stable ids. */
+export function slugify(label) {
+    return label
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 64) || "workflow";
+}
+//# sourceMappingURL=slug.js.map

package/dist/util/slug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.js","sourceRoot":"","sources":["../../src/util/slug.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,KAAK;SACT,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,UAAU,CAAA;AAC/B,CAAC"}

package/dist/validate/environment.d.ts

@@ -0,0 +1,5 @@
+import type { EnvironmentDescriptor, ValidationResult, WorkflowManifest } from "@executioncontrolprotocol/types";
+import type { ResolvedBindings } from "../environment/bindings.js";
+/** Validate workflow against a live environment. */
+export declare function validateEnvironmentWithWorkflow(workflow: WorkflowManifest, descriptor: EnvironmentDescriptor, bindings: ResolvedBindings): ValidationResult;
+//# sourceMappingURL=environment.d.ts.map

package/dist/validate/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/validate/environment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAGhH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAElE,oDAAoD;AACpD,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,gBAAgB,EAC1B,UAAU,EAAE,qBAAqB,EACjC,QAAQ,EAAE,gBAAgB,GACzB,gBAAgB,CA0BlB"}

package/dist/validate/environment.js

@@ -0,0 +1,30 @@
+import { LATEST_ECP_VERSION } from "@executioncontrolprotocol/types";
+import { globalRegistry } from "../registry/registry.js";
+import { validateWorkflow } from "./workflow.js";
+/** Validate workflow against a live environment. */
+export function validateEnvironmentWithWorkflow(workflow, descriptor, bindings) {
+    const result = validateWorkflow(workflow, descriptor);
+    const rtId = String(bindings.runtime.id);
+    for (const ext of bindings.extensions) {
+        const def = globalRegistry.getExtension(String(ext.id));
+        const supported = def?.supportedRuntimes;
+        if (supported?.length && !supported.includes(rtId)) {
+            result.valid = false;
+            result.errors.push({
+                code: "UNSUPPORTED_RUNTIME_EXTENSION",
+                message: `Extension ${ext.id} does not support runtime ${rtId}. Supported: ${supported.join(", ")}`,
+            });
+        }
+    }
+    if (rtId === "@executioncontrolprotocol/local") {
+        result.valid = false;
+        result.errors.push({
+            code: "DEPRECATED_RUNTIME",
+            message: "Runtime @executioncontrolprotocol/local was replaced by @executioncontrolprotocol/node.",
+        });
+    }
+    result.schema = "@executioncontrolprotocol.validation.result";
+    result.version = LATEST_ECP_VERSION;
+    return result;
+}
+//# sourceMappingURL=environment.js.map

package/dist/validate/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../src/validate/environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AAEpE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAGhD,oDAAoD;AACpD,MAAM,UAAU,+BAA+B,CAC7C,QAA0B,EAC1B,UAAiC,EACjC,QAA0B;IAE1B,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;IACrD,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAExC,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,cAAc,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;QACvD,MAAM,SAAS,GAAG,GAAG,EAAE,iBAAiB,CAAA;QACxC,IAAI,SAAS,EAAE,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAkC,CAAC,EAAE,CAAC;YACjF,MAAM,CAAC,KAAK,GAAG,KAAK,CAAA;YACpB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;gBACjB,IAAI,EAAE,+BAA+B;gBACrC,OAAO,EAAE,aAAa,GAAG,CAAC,EAAE,6BAA6B,IAAI,gBAAgB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aACpG,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,IAAI,IAAI,KAAK,iCAAiC,EAAE,CAAC;QAC/C,MAAM,CAAC,KAAK,GAAG,KAAK,CAAA;QACpB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;YACjB,IAAI,EAAE,oBAAoB;YAC1B,OAAO,EAAE,yFAAyF;SACnG,CAAC,CAAA;IACJ,CAAC;IACD,MAAM,CAAC,MAAM,GAAG,6CAA6C,CAAA;IAC7D,MAAM,CAAC,OAAO,GAAG,kBAAkB,CAAA;IACnC,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/validate/harness.d.ts

@@ -0,0 +1,11 @@
+import { ECP_CORE_FORMATTER_IDS, type ValidationResult } from "@executioncontrolprotocol/types";
+import type { Registry } from "../registry/registry.js";
+import type { ResolvedBindings } from "../environment/bindings.js";
+/**
+ * Validate harness bindings against registry and environment extensions.
+ * @category Harness
+ */
+export declare function validateHarnessBindings(registry: Registry, bindings: ResolvedBindings): ValidationResult;
+/** Known core formatter ids for tests. @internal */
+export { ECP_CORE_FORMATTER_IDS };
+//# sourceMappingURL=harness.d.ts.map

package/dist/validate/harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../src/validate/harness.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EAKtB,KAAK,gBAAgB,EACtB,MAAM,iCAAiC,CAAA;AACxC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAalE;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,gBAAgB,GACzB,gBAAgB,CA6GlB;AAED,oDAAoD;AACpD,OAAO,EAAE,sBAAsB,EAAE,CAAA"}