@executioncontrolprotocol/core 0.10.0

package/dist/invoke/execute-invoke.js

@@ -0,0 +1,137 @@
+import { ECP_INVOKE_ERROR_CODES, LATEST_ECP_VERSION, } from "@executioncontrolprotocol/types";
+import { isHarnessCapabilityId } from "../harness/harness-catalog.js";
+import { executeHarnessInvoke } from "../harness/execute-harness.js";
+import { createUtilityCapabilityContext } from "../encoding/utility-context.js";
+import { evaluatePolicies } from "../runtime/policy-engine.js";
+import { createUsageLedger } from "../runtime/context.js";
+import { emptyValidationResult } from "../validate/workflow-schema.js";
+import { zodIssuesToValidationIssues } from "../validate/zod-mapper.js";
+import { LATEST_ECP_VERSION as CORE_VERSION } from "@executioncontrolprotocol/types";
+const INVOKE_STUB_WORKFLOW = {
+    schema: "@executioncontrolprotocol.workflow",
+    version: LATEST_ECP_VERSION,
+    workflow: { id: "invoke-stub" },
+    steps: [],
+};
+function invokeFailure(capabilityId, code, message, validation) {
+    return {
+        schema: "@executioncontrolprotocol.invoke.result",
+        version: CORE_VERSION,
+        success: false,
+        capabilityId,
+        validation,
+        diagnostics: [{ severity: "error", code, message }],
+    };
+}
+function usageSummary(ledger) {
+    if (ledger.modelCalls === 0 &&
+        ledger.costUsd === 0 &&
+        ledger.tokens === 0 &&
+        ledger.retries === 0) {
+        return undefined;
+    }
+    return {
+        modelCalls: ledger.modelCalls,
+        costUsd: ledger.costUsd,
+        tokens: ledger.tokens,
+        retries: ledger.retries,
+    };
+}
+function findExtensionConfig(bindings, capabilityId) {
+    const extPrefix = capabilityId.replace(/\.[^.]+$/, "");
+    const binding = bindings.extensions.find((e) => e.id === extPrefix);
+    return binding?.config;
+}
+/**
+ * Execute a capability outside workflow run/step lifecycle.
+ * @category Invoke
+ * @internal
+ */
+export async function executeInvoke(env, capabilityId, input, providerOverride) {
+    await env.ensureBoundExtensionsRegistered();
+    await env.ensureReady();
+    if (isHarnessCapabilityId(capabilityId)) {
+        return executeHarnessInvoke(env, capabilityId, input, providerOverride);
+    }
+    const registry = env.getRegistry();
+    const cap = registry.getCapability(capabilityId);
+    if (!cap) {
+        return invokeFailure(capabilityId, ECP_INVOKE_ERROR_CODES.CAPABILITY_NOT_FOUND, `Capability not registered: ${capabilityId}`);
+    }
+    let validation = emptyValidationResult(true);
+    if (cap.inputSchema) {
+        const parsed = cap.inputSchema.safeParse(input);
+        if (!parsed.success) {
+            validation = emptyValidationResult(false);
+            validation.errors.push(...zodIssuesToValidationIssues(parsed.error.issues));
+            return invokeFailure(capabilityId, ECP_INVOKE_ERROR_CODES.INVOKE_INPUT_INVALID, "Invoke input validation failed", validation);
+        }
+        input = parsed.data;
+    }
+    const bindings = env.ecpResolveBindings();
+    const policyCtx = {
+        workflow: INVOKE_STUB_WORKFLOW,
+        run: { id: env.getEnvId(), input: {} },
+        step: { id: "invoke", capabilityId },
+        state: {},
+        input: (input ?? {}),
+        usage: createUsageLedger(),
+        scope: "invoke",
+        operation: "invoke",
+        capabilityId,
+    };
+    const preDecision = await evaluatePolicies("policy:pre", bindings.policyHooks, policyCtx);
+    if (preDecision.type === "deny") {
+        return invokeFailure(capabilityId, ECP_INVOKE_ERROR_CODES.INVOKE_DENIED, preDecision.reason ?? "Invocation denied by policy");
+    }
+    if (preDecision.type === "pause") {
+        return invokeFailure(capabilityId, ECP_INVOKE_ERROR_CODES.INVOKE_DENIED, preDecision.reason ?? "Invocation paused by policy");
+    }
+    const utilityCtx = createUtilityCapabilityContext(env.getEnvId(), env.getEnvLabel(), registry);
+    const extensionConfig = findExtensionConfig(bindings, capabilityId);
+    const capCtx = {
+        store: utilityCtx.store,
+        state: {},
+        run: { id: env.getEnvId(), input: {} },
+        step: { id: "invoke", capabilityId },
+        logger: utilityCtx.logger,
+        usage: policyCtx.usage,
+        extensionConfig,
+        capabilities: {
+            call: async (id, nestedInput) => {
+                const nested = registry.getCapability(id);
+                if (!nested)
+                    throw new Error(`Unknown capability: ${id}`);
+                return nested.handler(nestedInput, capCtx);
+            },
+        },
+    };
+    let output;
+    try {
+        output = await cap.handler(input, capCtx);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return invokeFailure(capabilityId, ECP_INVOKE_ERROR_CODES.INVOKE_FAILED, message);
+    }
+    if (cap.outputSchema) {
+        const parsed = cap.outputSchema.safeParse(output);
+        if (!parsed.success) {
+            const outValidation = emptyValidationResult(false);
+            outValidation.errors.push(...zodIssuesToValidationIssues(parsed.error.issues));
+            return invokeFailure(capabilityId, ECP_INVOKE_ERROR_CODES.INVOKE_OUTPUT_INVALID, "Invoke output validation failed", outValidation);
+        }
+        output = parsed.data;
+    }
+    return {
+        schema: "@executioncontrolprotocol.invoke.result",
+        version: CORE_VERSION,
+        success: true,
+        capabilityId,
+        result: output,
+        validation,
+        diagnostics: [],
+        usage: usageSummary(policyCtx.usage),
+    };
+}
+//# sourceMappingURL=execute-invoke.js.map

package/dist/invoke/execute-invoke.js.map

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

package/dist/invoke/index.d.ts

@@ -0,0 +1,3 @@
+export { createInvokeBuilder, type InvokeOperationBuilder } from "./invoke-builder.js";
+export { executeInvoke } from "./execute-invoke.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/invoke/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/invoke/index.js

@@ -0,0 +1,3 @@
+export { createInvokeBuilder } from "./invoke-builder.js";
+export { executeInvoke } from "./execute-invoke.js";
+//# sourceMappingURL=index.js.map

package/dist/invoke/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/invoke/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAA+B,MAAM,qBAAqB,CAAA;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/invoke/invoke-builder.d.ts

@@ -0,0 +1,17 @@
+import type { CapabilityId, InvokeResult } from "@executioncontrolprotocol/types";
+import type { Environment } from "../environment/environment.js";
+/** Fluent builder for `ecp.invoke()`. @category Invoke */
+export interface InvokeOperationBuilder {
+    /** Capability input payload. */
+    with(input: unknown): this;
+    /** Override harness default provider capability. */
+    uses(providerCapabilityId: CapabilityId | string): this;
+    /** Run the invocation. */
+    process<T = unknown>(): Promise<InvokeResult<T>>;
+}
+/**
+ * Create invoke operation builder.
+ * @category Invoke
+ */
+export declare function createInvokeBuilder(env: Environment, capabilityId: CapabilityId): InvokeOperationBuilder;
+//# sourceMappingURL=invoke-builder.d.ts.map

package/dist/invoke/invoke-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke-builder.d.ts","sourceRoot":"","sources":["../../src/invoke/invoke-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAA;AACjF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAGhE,0DAA0D;AAC1D,MAAM,WAAW,sBAAsB;IACrC,gCAAgC;IAChC,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;IAC1B,oDAAoD;IACpD,IAAI,CAAC,oBAAoB,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,CAAA;IACvD,0BAA0B;IAC1B,OAAO,CAAC,CAAC,GAAG,OAAO,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;CACjD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,WAAW,EAChB,YAAY,EAAE,YAAY,GACzB,sBAAsB,CAmBxB"}

package/dist/invoke/invoke-builder.js

@@ -0,0 +1,24 @@
+import { executeInvoke } from "./execute-invoke.js";
+/**
+ * Create invoke operation builder.
+ * @category Invoke
+ */
+export function createInvokeBuilder(env, capabilityId) {
+    let input = {};
+    let providerOverride;
+    const builder = {
+        with(payload) {
+            input = payload;
+            return builder;
+        },
+        uses(providerCapabilityId) {
+            providerOverride = providerCapabilityId;
+            return builder;
+        },
+        process() {
+            return executeInvoke(env, capabilityId, input, providerOverride);
+        },
+    };
+    return builder;
+}
+//# sourceMappingURL=invoke-builder.js.map

package/dist/invoke/invoke-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke-builder.js","sourceRoot":"","sources":["../../src/invoke/invoke-builder.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAYnD;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAgB,EAChB,YAA0B;IAE1B,IAAI,KAAK,GAAY,EAAE,CAAA;IACvB,IAAI,gBAA0C,CAAA;IAE9C,MAAM,OAAO,GAA2B;QACtC,IAAI,CAAC,OAAgB;YACnB,KAAK,GAAG,OAAO,CAAA;YACf,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,IAAI,CAAC,oBAA2C;YAC9C,gBAAgB,GAAG,oBAAoC,CAAA;YACvD,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,OAAO;YACL,OAAO,aAAa,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,gBAAgB,CAA6B,CAAA;QAC9F,CAAC;KACF,CAAA;IAED,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/loaders/files.d.ts

@@ -0,0 +1,13 @@
+import type { WorkflowManifest } from "@executioncontrolprotocol/types";
+import type { Environment } from "../environment/environment.js";
+/** Read file as utf-8. */
+export declare function readTextFile(path: string): Promise<string>;
+/** Load JSON workflow manifest from disk. */
+export declare function loadWorkflowJson(path: string): Promise<WorkflowManifest>;
+/** Load workflow from .json, .ts, or .js path. */
+export declare function loadWorkflowFile(path: string): Promise<WorkflowManifest>;
+/** Load environment module default export. */
+export declare function loadEnvironmentModule(path: string): Promise<Environment>;
+/** Load workflow module and return manifest. */
+export declare function loadWorkflowModule(path: string): Promise<WorkflowManifest>;
+//# sourceMappingURL=files.d.ts.map

package/dist/loaders/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/loaders/files.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAIhE,0BAA0B;AAC1B,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEhE;AAED,6CAA6C;AAC7C,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAG9E;AAED,kDAAkD;AAClD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAa9E;AAkBD,8CAA8C;AAC9C,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAe9E;AAED,gDAAgD;AAChD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAEhF"}

package/dist/loaders/files.js

@@ -0,0 +1,64 @@
+import { readFile, mkdtemp, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { compileWorkflowSource } from "../compile/index.js";
+import { bundleWorkflowSource } from "../compile/transpile.js";
+/** Read file as utf-8. */
+export async function readTextFile(path) {
+    return readFile(path, "utf8");
+}
+/** Load JSON workflow manifest from disk. */
+export async function loadWorkflowJson(path) {
+    const text = await readTextFile(path);
+    return JSON.parse(text);
+}
+/** Load workflow from .json, .ts, or .js path. */
+export async function loadWorkflowFile(path) {
+    if (path.endsWith(".json"))
+        return loadWorkflowJson(path);
+    const abs = resolve(path);
+    const source = await readTextFile(abs);
+    const result = await compileWorkflowSource({ source, filename: abs });
+    if (!result.ok || !result.manifest) {
+        throw new Error(result.compileErrors?.[0]?.message ??
+            result.validation?.errors[0]?.message ??
+            "Failed to compile workflow");
+    }
+    return result.manifest;
+}
+async function loadBundledModule(source, filename) {
+    const abs = resolve(filename);
+    const code = await bundleWorkflowSource(source, abs, dirname(abs));
+    const dir = await mkdtemp(join(tmpdir(), "ecp-bundle-"));
+    const file = join(dir, "module.mjs");
+    try {
+        await writeFile(file, code, "utf8");
+        return (await import(pathToFileURL(file).href));
+    }
+    finally {
+        await rm(dir, { recursive: true, force: true });
+    }
+}
+/** Load environment module default export. */
+export async function loadEnvironmentModule(path) {
+    const abs = resolve(path);
+    const source = await readFile(abs, "utf8");
+    const mod = await loadBundledModule(source, abs);
+    const exp = mod.default ?? mod.environment;
+    if (!exp)
+        throw new Error(`Environment module must export default or 'environment'`);
+    const raw = typeof exp === "function"
+        ? exp()
+        : exp;
+    const value = await Promise.resolve(raw);
+    if (!value || typeof value.init !== "function") {
+        throw new Error("Environment export must be an Environment instance");
+    }
+    return value;
+}
+/** Load workflow module and return manifest. */
+export async function loadWorkflowModule(path) {
+    return loadWorkflowFile(path);
+}
+//# sourceMappingURL=files.js.map

package/dist/loaders/files.js.map

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

package/dist/loaders/index.d.ts

@@ -0,0 +1,2 @@
+export { readTextFile, loadWorkflowJson, loadWorkflowFile, loadEnvironmentModule, loadWorkflowModule, } from "./files.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/loaders/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,YAAY,CAAA"}

package/dist/loaders/index.js

@@ -0,0 +1,2 @@
+export { readTextFile, loadWorkflowJson, loadWorkflowFile, loadEnvironmentModule, loadWorkflowModule, } from "./files.js";
+//# sourceMappingURL=index.js.map

package/dist/loaders/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/loaders/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,YAAY,CAAA"}

package/dist/node.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Node host conveniences: file loaders and workflow compile (native esbuild).
+ * Import from `@executioncontrolprotocol/core/node` in Node runtimes; browser apps use `@executioncontrolprotocol/core/browser`.
+ * @packageDocumentation
+ */
+export * from "./loaders/index.js";
+export { compileWorkflowSource, compileAndValidateWorkflowSource, extractWorkflowFromModule, compileHarnessArtifactSource, extractArtifactFromModule, type CompileWorkflowResult, type CompileWorkflowSourceOptions, type CompileDiagnostic, type CompileHarnessArtifactResult, type CompileHarnessArtifactSourceOptions, type HarnessArtifactSchema, } from "./compile/entry.js";
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,oBAAoB,CAAA;AAClC,OAAO,EACL,qBAAqB,EACrB,gCAAgC,EAChC,yBAAyB,EACzB,4BAA4B,EAC5B,yBAAyB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,EACtB,KAAK,4BAA4B,EACjC,KAAK,mCAAmC,EACxC,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAA"}

package/dist/node.js

@@ -0,0 +1,8 @@
+/**
+ * Node host conveniences: file loaders and workflow compile (native esbuild).
+ * Import from `@executioncontrolprotocol/core/node` in Node runtimes; browser apps use `@executioncontrolprotocol/core/browser`.
+ * @packageDocumentation
+ */
+export * from "./loaders/index.js";
+export { compileWorkflowSource, compileAndValidateWorkflowSource, extractWorkflowFromModule, compileHarnessArtifactSource, extractArtifactFromModule, } from "./compile/entry.js";
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,oBAAoB,CAAA;AAClC,OAAO,EACL,qBAAqB,EACrB,gCAAgC,EAChC,yBAAyB,EACzB,4BAA4B,EAC5B,yBAAyB,GAO1B,MAAM,oBAAoB,CAAA"}

package/dist/patch/apply-patch.d.ts

@@ -0,0 +1,8 @@
+import { type EcpSchema, type PatchResult, type WorkflowManifest } from "@executioncontrolprotocol/types";
+import type { EcpPatchInput } from "@executioncontrolprotocol/types";
+/**
+ * Apply a patch to a workflow manifest (canonical JSON only).
+ * @category Patch
+ */
+export declare function applyPatch<T extends WorkflowManifest>(document: T, input: EcpPatchInput, targetSchema?: EcpSchema): PatchResult<T>;
+//# sourceMappingURL=apply-patch.d.ts.map

package/dist/patch/apply-patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-patch.d.ts","sourceRoot":"","sources":["../../src/patch/apply-patch.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,SAAS,EACd,KAAK,WAAW,EAGhB,KAAK,gBAAgB,EAEtB,MAAM,iCAAiC,CAAA;AAMxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAA;AA8LpE;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,gBAAgB,EACnD,QAAQ,EAAE,CAAC,EACX,KAAK,EAAE,aAAa,EACpB,YAAY,GAAE,SAAgD,GAC7D,WAAW,CAAC,CAAC,CAAC,CAyIhB"}

package/dist/patch/apply-patch.js

@@ -0,0 +1,286 @@
+import { ECP_PATCH_ERROR_CODES, LATEST_ECP_VERSION, } from "@executioncontrolprotocol/types";
+import { validateWorkflow } from "../validate/workflow.js";
+import { deepMerge, getAtPath, setAtPath } from "../util/path.js";
+import { buildStepIndex } from "./step-index.js";
+import { normalizePatchInput, validatePatchDocument } from "./normalize-input.js";
+import { resolveEcpPatchPath } from "./resolve-path.js";
+function emptyDiagnostics() {
+    return [];
+}
+function stepIndexFromPath(stepPath) {
+    const match = stepPath.match(/^steps\[(\d+)\]$/);
+    return match ? Number(match[1]) : undefined;
+}
+function insertStepAtAnchor(manifest, step, after, before) {
+    const index = buildStepIndex(manifest);
+    let insertAt = manifest.steps.length;
+    if (after !== undefined) {
+        const anchorPath = index.pathsById.get(after);
+        if (!anchorPath) {
+            return { ok: false, message: `Anchor step not found for AFTER: ${after}` };
+        }
+        const anchorIndex = stepIndexFromPath(anchorPath);
+        if (anchorIndex === undefined) {
+            return { ok: false, message: `Unsupported anchor path for AFTER: ${anchorPath}` };
+        }
+        insertAt = anchorIndex + 1;
+    }
+    else if (before !== undefined) {
+        const anchorPath = index.pathsById.get(before);
+        if (!anchorPath) {
+            return { ok: false, message: `Anchor step not found for BEFORE: ${before}` };
+        }
+        const anchorIndex = stepIndexFromPath(anchorPath);
+        if (anchorIndex === undefined) {
+            return { ok: false, message: `Unsupported anchor path for BEFORE: ${anchorPath}` };
+        }
+        insertAt = anchorIndex;
+    }
+    const nextSteps = [...manifest.steps];
+    nextSteps.splice(insertAt, 0, step);
+    return { ok: true, steps: nextSteps };
+}
+function removeStepAtPath(manifest, stepPath) {
+    const stepIndex = stepIndexFromPath(stepPath);
+    if (stepIndex === undefined)
+        return undefined;
+    return manifest.steps.filter((_, index) => index !== stepIndex);
+}
+function applyEqlSpecialEntry(manifest, entry) {
+    const mode = entry.mode ?? "merge";
+    if (entry.reason === "eql:add-step") {
+        const payload = entry.value;
+        const inserted = insertStepAtAnchor(manifest, payload.step, payload._eqlInsertAfter, payload._eqlInsertBefore);
+        if (!inserted.ok) {
+            return {
+                handled: true,
+                mode,
+                success: false,
+                message: inserted.message,
+                code: ECP_PATCH_ERROR_CODES.PATCH_PATH_NOT_FOUND,
+            };
+        }
+        return { handled: true, manifest: { ...manifest, steps: inserted.steps }, mode, success: true };
+    }
+    if (entry.reason === "eql:delete") {
+        const resolved = resolveEcpPatchPath(manifest, entry.path);
+        if (!resolved.ok) {
+            return {
+                handled: true,
+                mode,
+                success: false,
+                message: resolved.message,
+                code: resolved.code,
+            };
+        }
+        const nextSteps = removeStepAtPath(manifest, resolved.lodashPath);
+        if (nextSteps === undefined) {
+            return {
+                handled: true,
+                mode,
+                success: false,
+                message: `Unsupported delete path: ${resolved.lodashPath}`,
+                code: ECP_PATCH_ERROR_CODES.PATCH_PATH_UNSUPPORTED,
+            };
+        }
+        return { handled: true, manifest: { ...manifest, steps: nextSteps }, mode, success: true };
+    }
+    if (entry.reason === "eql:move") {
+        const resolved = resolveEcpPatchPath(manifest, entry.path);
+        if (!resolved.ok) {
+            return {
+                handled: true,
+                mode,
+                success: false,
+                message: resolved.message,
+                code: resolved.code,
+            };
+        }
+        const stepIndex = stepIndexFromPath(resolved.lodashPath);
+        if (stepIndex === undefined) {
+            return {
+                handled: true,
+                mode,
+                success: false,
+                message: `Unsupported move path: ${resolved.lodashPath}`,
+                code: ECP_PATCH_ERROR_CODES.PATCH_PATH_UNSUPPORTED,
+            };
+        }
+        const move = entry.value;
+        const stepNode = manifest.steps[stepIndex];
+        if (!stepNode) {
+            return {
+                handled: true,
+                mode,
+                success: false,
+                message: `Step missing at move path: ${resolved.lodashPath}`,
+                code: ECP_PATCH_ERROR_CODES.PATCH_PATH_NOT_FOUND,
+            };
+        }
+        const without = manifest.steps.filter((_, index) => index !== stepIndex);
+        const inserted = insertStepAtAnchor({ ...manifest, steps: without }, stepNode, move._eqlMoveAfter, move._eqlMoveBefore);
+        if (!inserted.ok) {
+            return {
+                handled: true,
+                mode,
+                success: false,
+                message: inserted.message,
+                code: ECP_PATCH_ERROR_CODES.PATCH_PATH_NOT_FOUND,
+            };
+        }
+        return { handled: true, manifest: { ...manifest, steps: inserted.steps }, mode, success: true };
+    }
+    return { handled: false };
+}
+function resolvePatchValue(currentValue, patchValue, mode) {
+    if (mode === "replace")
+        return patchValue;
+    if (patchValue === null ||
+        typeof patchValue !== "object" ||
+        Array.isArray(patchValue)) {
+        return patchValue;
+    }
+    if (currentValue === null ||
+        currentValue === undefined ||
+        typeof currentValue !== "object" ||
+        Array.isArray(currentValue)) {
+        return patchValue;
+    }
+    return deepMerge(currentValue, patchValue);
+}
+/**
+ * Apply a patch to a workflow manifest (canonical JSON only).
+ * @category Patch
+ */
+export function applyPatch(document, input, targetSchema = "@executioncontrolprotocol.workflow") {
+    const diagnostics = emptyDiagnostics();
+    const patch = normalizePatchInput(input, targetSchema);
+    const patchValidation = validatePatchDocument(patch);
+    if (!patchValidation.valid) {
+        return {
+            schema: "@executioncontrolprotocol.patch.result",
+            version: LATEST_ECP_VERSION,
+            success: false,
+            targetSchema,
+            patch,
+            applied: [],
+            diagnostics: patchValidation.errors.map((message) => ({
+                severity: "error",
+                message,
+                code: ECP_PATCH_ERROR_CODES.PATCH_INVALID_DOCUMENT,
+            })),
+        };
+    }
+    const index = buildStepIndex(document);
+    if (index.duplicates.length > 0) {
+        return {
+            schema: "@executioncontrolprotocol.patch.result",
+            version: LATEST_ECP_VERSION,
+            success: false,
+            targetSchema,
+            patch,
+            applied: [],
+            diagnostics: index.duplicates.map((id) => ({
+                severity: "error",
+                code: ECP_PATCH_ERROR_CODES.DUPLICATE_STEP_ID,
+                message: `Duplicate step id: ${id}`,
+            })),
+        };
+    }
+    const nextDocument = structuredClone(document);
+    const applied = [];
+    for (const entry of patch.patches) {
+        const special = applyEqlSpecialEntry(nextDocument, entry);
+        if (special.handled) {
+            if (special.success) {
+                Object.assign(nextDocument, special.manifest);
+                applied.push({ path: entry.path, mode: special.mode, success: true });
+            }
+            else {
+                applied.push({
+                    path: entry.path,
+                    mode: special.mode,
+                    success: false,
+                    diagnostics: [
+                        {
+                            severity: "error",
+                            code: special.code,
+                            message: special.message,
+                        },
+                    ],
+                });
+                diagnostics.push({
+                    severity: "error",
+                    code: special.code,
+                    message: special.message,
+                    path: entry.path,
+                });
+            }
+            continue;
+        }
+        const resolved = resolveEcpPatchPath(nextDocument, entry.path);
+        if (!resolved.ok) {
+            applied.push({
+                path: entry.path,
+                mode: entry.mode ?? "merge",
+                success: false,
+                diagnostics: [
+                    {
+                        severity: "error",
+                        code: resolved.code,
+                        message: resolved.message,
+                    },
+                ],
+            });
+            diagnostics.push({
+                severity: "error",
+                code: resolved.code,
+                message: resolved.message,
+                path: entry.path,
+            });
+            continue;
+        }
+        const mode = entry.mode ?? "merge";
+        const currentValue = getAtPath(nextDocument, resolved.lodashPath);
+        const nextValue = resolvePatchValue(currentValue, entry.value, mode);
+        try {
+            setAtPath(nextDocument, resolved.lodashPath, nextValue);
+            applied.push({ path: entry.path, mode, success: true });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            applied.push({
+                path: entry.path,
+                mode,
+                success: false,
+                diagnostics: [
+                    {
+                        severity: "error",
+                        code: ECP_PATCH_ERROR_CODES.PATCH_APPLY_FAILED,
+                        message,
+                    },
+                ],
+            });
+            diagnostics.push({
+                severity: "error",
+                code: ECP_PATCH_ERROR_CODES.PATCH_APPLY_FAILED,
+                message,
+                path: entry.path,
+            });
+        }
+    }
+    const validation = validateWorkflow(nextDocument);
+    const success = diagnostics.length === 0 && validation.valid;
+    return {
+        schema: "@executioncontrolprotocol.patch.result",
+        version: LATEST_ECP_VERSION,
+        success,
+        targetSchema,
+        result: nextDocument,
+        patch,
+        applied,
+        validation,
+        diagnostics: [...diagnostics, ...validation.errors, ...validation.warnings],
+    };
+}
+//# sourceMappingURL=apply-patch.js.map