@executioncontrolprotocol/core 0.10.0

package/dist/encoding/contracts.d.ts

@@ -0,0 +1,17 @@
+import type { CapabilityDefinition } from "../definitions/types.js";
+/**
+ * Validate that a capability matches the encode contract.
+ * @category Encoding
+ */
+export declare function validateEncodeCapabilityContract(cap: CapabilityDefinition): void;
+/**
+ * Validate that a capability matches the decode contract.
+ * @category Encoding
+ */
+export declare function validateDecodeCapabilityContract(cap: CapabilityDefinition): void;
+/**
+ * Normalize extension id to namespaced form.
+ * @category Encoding
+ */
+export declare function normalizeNamespacedId(extensionId: string): string;
+//# sourceMappingURL=contracts.d.ts.map

package/dist/encoding/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/encoding/contracts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAInE;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,GAAG,EAAE,oBAAoB,GAAG,IAAI,CAYhF;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,GAAG,EAAE,oBAAoB,GAAG,IAAI,CAMhF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAGjE"}

package/dist/encoding/contracts.js

@@ -0,0 +1,41 @@
+import { ECP_ENCODING_ERROR_CODES } from "@executioncontrolprotocol/types";
+import { EcpError } from "./errors.js";
+import { ecpEncodeInputSchema } from "./schemas.js";
+/**
+ * Validate that a capability matches the encode contract.
+ * @category Encoding
+ */
+export function validateEncodeCapabilityContract(cap) {
+    if (!cap.inputSchema || !cap.outputSchema) {
+        throw new EcpError(ECP_ENCODING_ERROR_CODES.FORMAT_ENCODER_INVALID_CONTRACT, {
+            message: `Capability ${cap.id} must define input and output schemas for encode.`,
+        });
+    }
+    const inputOk = ecpEncodeInputSchema.safeParse({ source: {} }).success;
+    if (!inputOk) {
+        throw new EcpError(ECP_ENCODING_ERROR_CODES.FORMAT_ENCODER_INVALID_CONTRACT, {
+            message: `Capability ${cap.id} encode input schema is incompatible.`,
+        });
+    }
+}
+/**
+ * Validate that a capability matches the decode contract.
+ * @category Encoding
+ */
+export function validateDecodeCapabilityContract(cap) {
+    if (!cap.inputSchema || !cap.outputSchema) {
+        throw new EcpError(ECP_ENCODING_ERROR_CODES.FORMAT_DECODER_INVALID_CONTRACT, {
+            message: `Capability ${cap.id} must define input and output schemas for decode.`,
+        });
+    }
+}
+/**
+ * Normalize extension id to namespaced form.
+ * @category Encoding
+ */
+export function normalizeNamespacedId(extensionId) {
+    if (extensionId.startsWith("@"))
+        return extensionId;
+    return `@executioncontrolprotocol/${extensionId}`;
+}
+//# sourceMappingURL=contracts.js.map

package/dist/encoding/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/encoding/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAA;AAE1E,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAEnD;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAAC,GAAyB;IACxE,IAAI,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;QAC1C,MAAM,IAAI,QAAQ,CAAC,wBAAwB,CAAC,+BAA+B,EAAE;YAC3E,OAAO,EAAE,cAAc,GAAG,CAAC,EAAE,mDAAmD;SACjF,CAAC,CAAA;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,oBAAoB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAA;IACtE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,QAAQ,CAAC,wBAAwB,CAAC,+BAA+B,EAAE;YAC3E,OAAO,EAAE,cAAc,GAAG,CAAC,EAAE,uCAAuC;SACrE,CAAC,CAAA;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAAC,GAAyB;IACxE,IAAI,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;QAC1C,MAAM,IAAI,QAAQ,CAAC,wBAAwB,CAAC,+BAA+B,EAAE;YAC3E,OAAO,EAAE,cAAc,GAAG,CAAC,EAAE,mDAAmD;SACjF,CAAC,CAAA;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,WAAmB;IACvD,IAAI,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,WAAW,CAAA;IACnD,OAAO,6BAA6B,WAAW,EAAE,CAAA;AACnD,CAAC"}

package/dist/encoding/decode-builder.d.ts

@@ -0,0 +1,17 @@
+import type { DecodeResult, EcpDecodeOptions, EcpSchema, EcpVersion, NamespacedId } from "@executioncontrolprotocol/types";
+import type { EncodingEnvironmentHost } from "../environment/encoding-host.js";
+/** Fluent builder for `ecp.decode()`. @category Encoding */
+export interface DecodeOperationBuilder {
+    uses(extensionId: NamespacedId | string): this;
+    from(format: string): this;
+    to(targetSchema: EcpSchema, version?: EcpVersion): this;
+    with(options: EcpDecodeOptions): this;
+    strict(enabled?: boolean): this;
+    process<T = unknown>(): Promise<DecodeResult<T>>;
+}
+/**
+ * Create decode operation builder.
+ * @category Encoding
+ */
+export declare function createDecodeBuilder(env: EncodingEnvironmentHost, content: unknown): DecodeOperationBuilder;
+//# sourceMappingURL=decode-builder.d.ts.map

package/dist/encoding/decode-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode-builder.d.ts","sourceRoot":"","sources":["../../src/encoding/decode-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,YAAY,EACb,MAAM,iCAAiC,CAAA;AAExC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAA;AAU9E,4DAA4D;AAC5D,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,WAAW,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,CAAA;IAC9C,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IACvD,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACrC,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IAC/B,OAAO,CAAC,CAAC,GAAG,OAAO,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;CACjD;AAmCD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,uBAAuB,EAC5B,OAAO,EAAE,OAAO,GACf,sBAAsB,CA6ExB"}

package/dist/encoding/decode-builder.js

@@ -0,0 +1,98 @@
+import { ECP_ENCODING_ERROR_CODES, LATEST_ECP_VERSION, ecpIntentSchema } from "@executioncontrolprotocol/types";
+import { EcpError } from "./errors.js";
+import { invokeDecodeCapability } from "./invoke-utility.js";
+import { resolveDecoder } from "./resolve.js";
+import { createUtilityCapabilityContext } from "./utility-context.js";
+import { validateWorkflow } from "../validate/workflow.js";
+import { ecpPatchDocumentSchema } from "../patch/patch-document.js";
+import { zodIssuesToValidationIssues } from "../validate/zod-mapper.js";
+import { emptyValidationResult } from "../validate/workflow-schema.js";
+function validateDecodedDocument(document, targetSchema) {
+    if (targetSchema === "@executioncontrolprotocol.workflow") {
+        return validateWorkflow(document);
+    }
+    if (targetSchema === "@executioncontrolprotocol.patch") {
+        const parsed = ecpPatchDocumentSchema.safeParse(document);
+        if (parsed.success)
+            return emptyValidationResult(true);
+        const result = emptyValidationResult(false);
+        result.errors.push(...zodIssuesToValidationIssues(parsed.error.issues));
+        return result;
+    }
+    if (targetSchema === "@executioncontrolprotocol.intent") {
+        const parsed = ecpIntentSchema.safeParse(document);
+        if (parsed.success)
+            return emptyValidationResult(true);
+        const result = emptyValidationResult(false);
+        result.errors.push(...zodIssuesToValidationIssues(parsed.error.issues));
+        return result;
+    }
+    return emptyValidationResult(true);
+}
+/**
+ * Create decode operation builder.
+ * @category Encoding
+ */
+export function createDecodeBuilder(env, content) {
+    const state = { content, options: {} };
+    const builder = {
+        uses(extensionId) {
+            state.extensionId = String(extensionId);
+            return builder;
+        },
+        from(format) {
+            state.format = format;
+            return builder;
+        },
+        to(targetSchema, version) {
+            state.targetSchema = targetSchema;
+            state.targetVersion = version ?? LATEST_ECP_VERSION;
+            return builder;
+        },
+        with(options) {
+            state.options = { ...state.options, ...options };
+            return builder;
+        },
+        strict(enabled = true) {
+            state.options.strict = enabled;
+            return builder;
+        },
+        async process() {
+            await env.ensureBoundExtensionsRegistered();
+            if (!state.extensionId) {
+                throw new EcpError(ECP_ENCODING_ERROR_CODES.FORMAT_DECODER_NOT_FOUND, {
+                    message: "Decode requires .uses(formatterId), e.g. .uses(\"@executioncontrolprotocol/format-json\") or .uses(\"@executioncontrolprotocol/format-toon\").",
+                });
+            }
+            const ctx = createUtilityCapabilityContext(env.getEnvId(), env.getEnvLabel(), env.getRegistry());
+            const cap = resolveDecoder(env.getRegistry(), state.extensionId);
+            const raw = await invokeDecodeCapability(cap, {
+                input: state.content,
+                format: state.format,
+                targetSchema: state.targetSchema,
+                targetVersion: state.targetVersion,
+                options: state.options,
+            }, ctx);
+            let result = raw;
+            const target = state.targetSchema ?? result.targetSchema;
+            if (result.success && result.result !== undefined && target) {
+                const validation = validateDecodedDocument(result.result, target);
+                result = {
+                    ...result,
+                    validation,
+                    success: result.success && validation.valid,
+                    diagnostics: [...result.diagnostics, ...validation.errors, ...validation.warnings],
+                };
+            }
+            if (state.options.strict && !result.success) {
+                throw new EcpError(ECP_ENCODING_ERROR_CODES.FORMAT_DECODE_FAILED, {
+                    message: "Decode failed in strict mode.",
+                    diagnostics: result.diagnostics,
+                });
+            }
+            return result;
+        },
+    };
+    return builder;
+}
+//# sourceMappingURL=decode-builder.js.map

package/dist/encoding/decode-builder.js.map

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

package/dist/encoding/encode-builder.d.ts

@@ -0,0 +1,19 @@
+import type { EncodeResult, EcpFormatOptions, EcpSchema, EcpVersion, NamespacedId } from "@executioncontrolprotocol/types";
+import type { EncodingEnvironmentHost } from "../environment/encoding-host.js";
+/** Fluent builder for `ecp.encode()`. @category Encoding */
+export interface EncodeOperationBuilder {
+    uses(extensionId: NamespacedId | string): this;
+    to(schema: EcpSchema, version?: EcpVersion): this;
+    with(options: EcpFormatOptions): this;
+    compact(enabled?: boolean): this;
+    asString(): this;
+    asObject(): this;
+    include(fields: string[]): this;
+    process<T = unknown>(): Promise<EncodeResult<T>>;
+}
+/**
+ * Create encode operation builder.
+ * @category Encoding
+ */
+export declare function createEncodeBuilder(env: EncodingEnvironmentHost, source: unknown): EncodeOperationBuilder;
+//# sourceMappingURL=encode-builder.d.ts.map

package/dist/encoding/encode-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode-builder.d.ts","sourceRoot":"","sources":["../../src/encoding/encode-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAA;AAE1H,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAA;AAQ9E,4DAA4D;AAC5D,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,WAAW,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,CAAA;IAC9C,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IACjD,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACrC,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IAChC,QAAQ,IAAI,IAAI,CAAA;IAChB,QAAQ,IAAI,IAAI,CAAA;IAChB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IAC/B,OAAO,CAAC,CAAC,GAAG,OAAO,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;CACjD;AAUD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,uBAAuB,EAC5B,MAAM,EAAE,OAAO,GACd,sBAAsB,CAgFxB"}

package/dist/encoding/encode-builder.js

@@ -0,0 +1,76 @@
+import { ECP_ENCODING_ERROR_CODES, LATEST_ECP_VERSION } from "@executioncontrolprotocol/types";
+import { encodeFailure, getEcpSchema } from "./json-codec.js";
+import { EcpError } from "./errors.js";
+import { invokeEncodeCapability } from "./invoke-utility.js";
+import { resolveEncoder } from "./resolve.js";
+import { createUtilityCapabilityContext } from "./utility-context.js";
+import { validateWorkflow } from "../validate/workflow.js";
+/**
+ * Create encode operation builder.
+ * @category Encoding
+ */
+export function createEncodeBuilder(env, source) {
+    const state = { source, options: {} };
+    const builder = {
+        uses(extensionId) {
+            state.extensionId = String(extensionId);
+            return builder;
+        },
+        to(schema, version) {
+            state.targetSchema = schema;
+            state.targetVersion = version ?? LATEST_ECP_VERSION;
+            return builder;
+        },
+        with(options) {
+            state.options = { ...state.options, ...options };
+            return builder;
+        },
+        compact(enabled = true) {
+            state.options.compact = enabled;
+            return builder;
+        },
+        asString() {
+            state.options.as = "string";
+            return builder;
+        },
+        asObject() {
+            state.options.as = "object";
+            return builder;
+        },
+        include(fields) {
+            state.options.include = fields;
+            return builder;
+        },
+        async process() {
+            await env.ensureBoundExtensionsRegistered();
+            if (!state.extensionId) {
+                throw new EcpError(ECP_ENCODING_ERROR_CODES.FORMAT_ENCODER_NOT_FOUND, {
+                    message: "Encode requires .uses(formatterId), e.g. .uses(\"@executioncontrolprotocol/format-json\") or .uses(\"@executioncontrolprotocol/format-fluent\").",
+                });
+            }
+            const sourceSchema = state.targetSchema ?? getEcpSchema(state.source);
+            const ctx = createUtilityCapabilityContext(env.getEnvId(), env.getEnvLabel(), env.getRegistry());
+            if (sourceSchema === "@executioncontrolprotocol.workflow") {
+                const validation = validateWorkflow(state.source);
+                if (!validation.valid) {
+                    return encodeFailure({
+                        format: "json",
+                        sourceSchema,
+                        validation,
+                        diagnostics: [...validation.errors, ...validation.warnings],
+                    });
+                }
+            }
+            const cap = resolveEncoder(env.getRegistry(), state.extensionId);
+            const result = await invokeEncodeCapability(cap, {
+                source: state.source,
+                sourceSchema,
+                sourceVersion: state.targetVersion,
+                options: state.options,
+            }, ctx);
+            return result;
+        },
+    };
+    return builder;
+}
+//# sourceMappingURL=encode-builder.js.map

package/dist/encoding/encode-builder.js.map

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

package/dist/encoding/errors.d.ts

@@ -0,0 +1,25 @@
+import type { EcpEncodingErrorCode } from "@executioncontrolprotocol/types";
+import type { ValidationIssue } from "@executioncontrolprotocol/types";
+/** Options for {@link EcpError}. @category Encoding */
+export interface EcpErrorOptions {
+    /** Human-readable message. */
+    message: string;
+    /** Validation issues when decode/encode fails validation. */
+    diagnostics?: ValidationIssue[];
+    /** Additional context. */
+    details?: Record<string, unknown>;
+}
+/**
+ * Typed error for encoding operations.
+ * @category Encoding
+ */
+export declare class EcpError extends Error {
+    /** Error code from {@link ECP_ENCODING_ERROR_CODES}. */
+    readonly code: EcpEncodingErrorCode;
+    /** Optional validation diagnostics. */
+    readonly diagnostics?: ValidationIssue[];
+    /** Optional extra details. */
+    readonly details?: Record<string, unknown>;
+    constructor(code: EcpEncodingErrorCode, options: EcpErrorOptions);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/encoding/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/encoding/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAA;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AAEtE,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,6DAA6D;IAC7D,WAAW,CAAC,EAAE,eAAe,EAAE,CAAA;IAC/B,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAED;;;GAGG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAA;IACnC,uCAAuC;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,EAAE,CAAA;IACxC,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;gBAE9B,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,eAAe;CAOjE"}

package/dist/encoding/errors.js

@@ -0,0 +1,20 @@
+/**
+ * Typed error for encoding operations.
+ * @category Encoding
+ */
+export class EcpError extends Error {
+    /** Error code from {@link ECP_ENCODING_ERROR_CODES}. */
+    code;
+    /** Optional validation diagnostics. */
+    diagnostics;
+    /** Optional extra details. */
+    details;
+    constructor(code, options) {
+        super(options.message);
+        this.name = "EcpError";
+        this.code = code;
+        this.diagnostics = options.diagnostics;
+        this.details = options.details;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/encoding/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/encoding/errors.ts"],"names":[],"mappings":"AAaA;;;GAGG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,wDAAwD;IAC/C,IAAI,CAAsB;IACnC,uCAAuC;IAC9B,WAAW,CAAoB;IACxC,8BAA8B;IACrB,OAAO,CAA0B;IAE1C,YAAY,IAA0B,EAAE,OAAwB;QAC9D,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QACtB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAA;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAA;QACtC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAA;IAChC,CAAC;CACF"}

package/dist/encoding/index.d.ts

@@ -0,0 +1,10 @@
+export { EcpError, type EcpErrorOptions } from "./errors.js";
+export { createEncodeBuilder, type EncodeOperationBuilder, } from "./encode-builder.js";
+export { createDecodeBuilder, type DecodeOperationBuilder, } from "./decode-builder.js";
+export { encodeJson, decodeJson, getEcpSchema, encodeFailure, decodeFailure, } from "./json-codec.js";
+export { normalizeWorkflowManifest } from "./normalize-workflow.js";
+export { normalizeNamespacedId, validateEncodeCapabilityContract, validateDecodeCapabilityContract, } from "./contracts.js";
+export { resolveEncoder, resolveDecoder } from "./resolve.js";
+export { createUtilityCapabilityContext, createUnavailableStoreContext, type UtilityCapabilityContext, } from "./utility-context.js";
+export { ecpEncodeInputSchema, ecpDecodeInputSchema, ecpEncodeResultSchema, ecpDecodeResultSchema, } from "./schemas.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/encoding/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,EACL,mBAAmB,EACnB,KAAK,sBAAsB,GAC5B,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,mBAAmB,EACnB,KAAK,sBAAsB,GAC5B,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,UAAU,EACV,UAAU,EACV,YAAY,EACZ,aAAa,EACb,aAAa,GACd,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAA;AACnE,OAAO,EACL,qBAAqB,EACrB,gCAAgC,EAChC,gCAAgC,GACjC,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7D,OAAO,EACL,8BAA8B,EAC9B,6BAA6B,EAC7B,KAAK,wBAAwB,GAC9B,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,cAAc,CAAA"}

package/dist/encoding/index.js

@@ -0,0 +1,10 @@
+export { EcpError } from "./errors.js";
+export { createEncodeBuilder, } from "./encode-builder.js";
+export { createDecodeBuilder, } from "./decode-builder.js";
+export { encodeJson, decodeJson, getEcpSchema, encodeFailure, decodeFailure, } from "./json-codec.js";
+export { normalizeWorkflowManifest } from "./normalize-workflow.js";
+export { normalizeNamespacedId, validateEncodeCapabilityContract, validateDecodeCapabilityContract, } from "./contracts.js";
+export { resolveEncoder, resolveDecoder } from "./resolve.js";
+export { createUtilityCapabilityContext, createUnavailableStoreContext, } from "./utility-context.js";
+export { ecpEncodeInputSchema, ecpDecodeInputSchema, ecpEncodeResultSchema, ecpDecodeResultSchema, } from "./schemas.js";
+//# sourceMappingURL=index.js.map

package/dist/encoding/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/encoding/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAwB,MAAM,aAAa,CAAA;AAC5D,OAAO,EACL,mBAAmB,GAEpB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,mBAAmB,GAEpB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,UAAU,EACV,UAAU,EACV,YAAY,EACZ,aAAa,EACb,aAAa,GACd,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAA;AACnE,OAAO,EACL,qBAAqB,EACrB,gCAAgC,EAChC,gCAAgC,GACjC,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7D,OAAO,EACL,8BAA8B,EAC9B,6BAA6B,GAE9B,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,cAAc,CAAA"}

package/dist/encoding/invoke-utility.d.ts

@@ -0,0 +1,14 @@
+import type { EcpDecodeInput, EcpEncodeInput } from "@executioncontrolprotocol/types";
+import type { CapabilityDefinition } from "../definitions/types.js";
+import type { UtilityCapabilityContext } from "./utility-context.js";
+/**
+ * Invoke an encode capability handler outside workflow execution.
+ * @category Encoding
+ */
+export declare function invokeEncodeCapability(cap: CapabilityDefinition, input: EcpEncodeInput, ctx: UtilityCapabilityContext): Promise<unknown>;
+/**
+ * Invoke a decode capability handler outside workflow execution.
+ * @category Encoding
+ */
+export declare function invokeDecodeCapability(cap: CapabilityDefinition, input: EcpDecodeInput, ctx: UtilityCapabilityContext): Promise<unknown>;
+//# sourceMappingURL=invoke-utility.d.ts.map

package/dist/encoding/invoke-utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke-utility.d.ts","sourceRoot":"","sources":["../../src/encoding/invoke-utility.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AACrF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAEnE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AAGpE;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,oBAAoB,EACzB,KAAK,EAAE,cAAc,EACrB,GAAG,EAAE,wBAAwB,GAC5B,OAAO,CAAC,OAAO,CAAC,CAgBlB;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,oBAAoB,EACzB,KAAK,EAAE,cAAc,EACrB,GAAG,EAAE,wBAAwB,GAC5B,OAAO,CAAC,OAAO,CAAC,CAgBlB"}

package/dist/encoding/invoke-utility.js

@@ -0,0 +1,50 @@
+import { ECP_ENCODING_ERROR_CODES } from "@executioncontrolprotocol/types";
+import { ecpDecodeInputSchema, ecpEncodeInputSchema } from "./schemas.js";
+import { EcpError } from "./errors.js";
+/**
+ * Invoke an encode capability handler outside workflow execution.
+ * @category Encoding
+ */
+export async function invokeEncodeCapability(cap, input, ctx) {
+    const parsed = ecpEncodeInputSchema.safeParse(input);
+    if (!parsed.success) {
+        throw new EcpError(ECP_ENCODING_ERROR_CODES.FORMAT_ENCODE_FAILED, {
+            message: `Invalid encode input: ${parsed.error.message}`,
+        });
+    }
+    try {
+        return await cap.handler(parsed.data, ctx);
+    }
+    catch (err) {
+        if (err instanceof EcpError)
+            throw err;
+        const message = err instanceof Error ? err.message : String(err);
+        throw new EcpError(ECP_ENCODING_ERROR_CODES.FORMAT_ENCODE_FAILED, {
+            message: `Encode failed: ${message}`,
+        });
+    }
+}
+/**
+ * Invoke a decode capability handler outside workflow execution.
+ * @category Encoding
+ */
+export async function invokeDecodeCapability(cap, input, ctx) {
+    const parsed = ecpDecodeInputSchema.safeParse(input);
+    if (!parsed.success) {
+        throw new EcpError(ECP_ENCODING_ERROR_CODES.FORMAT_DECODE_FAILED, {
+            message: `Invalid decode input: ${parsed.error.message}`,
+        });
+    }
+    try {
+        return await cap.handler(parsed.data, ctx);
+    }
+    catch (err) {
+        if (err instanceof EcpError)
+            throw err;
+        const message = err instanceof Error ? err.message : String(err);
+        throw new EcpError(ECP_ENCODING_ERROR_CODES.FORMAT_DECODE_FAILED, {
+            message: `Decode failed: ${message}`,
+        });
+    }
+}
+//# sourceMappingURL=invoke-utility.js.map

package/dist/encoding/invoke-utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke-utility.js","sourceRoot":"","sources":["../../src/encoding/invoke-utility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAA;AAG1E,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAEzE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAEtC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,GAAyB,EACzB,KAAqB,EACrB,GAA6B;IAE7B,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IACpD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,QAAQ,CAAC,wBAAwB,CAAC,oBAAoB,EAAE;YAChE,OAAO,EAAE,yBAAyB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE;SACzD,CAAC,CAAA;IACJ,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,GAAY,CAAC,CAAA;IACrD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,QAAQ;YAAE,MAAM,GAAG,CAAA;QACtC,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAChE,MAAM,IAAI,QAAQ,CAAC,wBAAwB,CAAC,oBAAoB,EAAE;YAChE,OAAO,EAAE,kBAAkB,OAAO,EAAE;SACrC,CAAC,CAAA;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,GAAyB,EACzB,KAAqB,EACrB,GAA6B;IAE7B,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IACpD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,QAAQ,CAAC,wBAAwB,CAAC,oBAAoB,EAAE;YAChE,OAAO,EAAE,yBAAyB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE;SACzD,CAAC,CAAA;IACJ,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,GAAY,CAAC,CAAA;IACrD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,QAAQ;YAAE,MAAM,GAAG,CAAA;QACtC,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAChE,MAAM,IAAI,QAAQ,CAAC,wBAAwB,CAAC,oBAAoB,EAAE;YAChE,OAAO,EAAE,kBAAkB,OAAO,EAAE;SACrC,CAAC,CAAA;IACJ,CAAC;AACH,CAAC"}

package/dist/encoding/json-codec.d.ts

@@ -0,0 +1,38 @@
+import type { DecodeResult, EcpFormatOptions, EcpDecodeOptions, EcpSchema, EncodeResult, ValidationResult } from "@executioncontrolprotocol/types";
+/**
+ * Infer ECP schema from a document object.
+ * @category Encoding
+ */
+export declare function getEcpSchema(value: unknown): EcpSchema | undefined;
+/**
+ * Encode a document as canonical JSON.
+ * @category Encoding
+ */
+export declare function encodeJson(input: unknown, options?: EcpFormatOptions & {
+    sourceSchema?: EcpSchema;
+    sourceVersion?: string;
+}): EncodeResult;
+/**
+ * Build a failed encode result envelope.
+ * @category Encoding
+ */
+export declare function encodeFailure<T = unknown>(partial: Partial<EncodeResult<T>> & {
+    diagnostics: EncodeResult["diagnostics"];
+}): EncodeResult<T>;
+/**
+ * Decode JSON text or object to a document.
+ * @category Encoding
+ */
+export declare function decodeJson<T = unknown>(input: unknown, options?: EcpDecodeOptions & {
+    targetSchema?: EcpSchema;
+    targetVersion?: string;
+    validation?: ValidationResult;
+}): DecodeResult<T>;
+/**
+ * Build a failed decode result envelope.
+ * @category Encoding
+ */
+export declare function decodeFailure(partial: Partial<DecodeResult> & {
+    diagnostics: DecodeResult["diagnostics"];
+}): DecodeResult;
+//# sourceMappingURL=json-codec.d.ts.map

package/dist/encoding/json-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-codec.d.ts","sourceRoot":"","sources":["../../src/encoding/json-codec.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EAET,YAAY,EACZ,gBAAgB,EACjB,MAAM,iCAAiC,CAAA;AAGxC;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAMlE;AAMD;;;GAGG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,gBAAgB,GAAG;IAAE,YAAY,CAAC,EAAE,SAAS,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GACpF,YAAY,CAsBd;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,EACvC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG;IAAE,WAAW,EAAE,YAAY,CAAC,aAAa,CAAC,CAAA;CAAE,GAC/E,YAAY,CAAC,CAAC,CAAC,CASjB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,GAAG,OAAO,EACpC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,gBAAgB,GAAG;IAC1B,YAAY,CAAC,EAAE,SAAS,CAAA;IACxB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,UAAU,CAAC,EAAE,gBAAgB,CAAA;CACzB,GACL,YAAY,CAAC,CAAC,CAAC,CAmCjB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG;IAAE,WAAW,EAAE,YAAY,CAAC,aAAa,CAAC,CAAA;CAAE,GAC5E,YAAY,CAQd"}

package/dist/encoding/json-codec.js

@@ -0,0 +1,108 @@
+import { ECP_FORMATS, LATEST_ECP_VERSION } from "@executioncontrolprotocol/types";
+import { emptyValidationResult } from "../validate/workflow-schema.js";
+/**
+ * Infer ECP schema from a document object.
+ * @category Encoding
+ */
+export function getEcpSchema(value) {
+    if (value !== null && typeof value === "object" && "schema" in value) {
+        const s = value.schema;
+        if (typeof s === "string")
+            return s;
+    }
+    return undefined;
+}
+function failureDiagnostics(validation) {
+    return validation ? [...validation.errors, ...validation.warnings] : [];
+}
+/**
+ * Encode a document as canonical JSON.
+ * @category Encoding
+ */
+export function encodeJson(input, options = {}) {
+    const sourceSchema = options.sourceSchema ?? getEcpSchema(input);
+    const compact = options.compact ?? false;
+    const validation = emptyValidationResult(true);
+    const resultPayload = options.as === "string"
+        ? JSON.stringify(input, null, compact ? 0 : 2)
+        : input;
+    return {
+        schema: "@executioncontrolprotocol.encode.result",
+        version: LATEST_ECP_VERSION,
+        success: true,
+        format: ECP_FORMATS.JSON,
+        mediaType: "application/ecp+json",
+        sourceSchema,
+        sourceVersion: options.sourceVersion,
+        result: resultPayload,
+        validation,
+        diagnostics: failureDiagnostics(validation),
+    };
+}
+/**
+ * Build a failed encode result envelope.
+ * @category Encoding
+ */
+export function encodeFailure(partial) {
+    return {
+        schema: "@executioncontrolprotocol.encode.result",
+        version: LATEST_ECP_VERSION,
+        success: false,
+        format: partial.format ?? ECP_FORMATS.JSON,
+        ...partial,
+        diagnostics: partial.diagnostics,
+    };
+}
+/**
+ * Decode JSON text or object to a document.
+ * @category Encoding
+ */
+export function decodeJson(input, options = {}) {
+    let document;
+    try {
+        document =
+            typeof input === "string" ? JSON.parse(input) : input;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            schema: "@executioncontrolprotocol.decode.result",
+            version: LATEST_ECP_VERSION,
+            success: false,
+            targetSchema: options.targetSchema,
+            diagnostics: [
+                {
+                    severity: "error",
+                    message: `JSON parse failed: ${message}`,
+                    code: "FORMAT_DECODE_FAILED",
+                },
+            ],
+        };
+    }
+    const validation = options.validation ?? emptyValidationResult(true);
+    const success = validation.valid;
+    return {
+        schema: "@executioncontrolprotocol.decode.result",
+        version: LATEST_ECP_VERSION,
+        success,
+        targetSchema: options.targetSchema ?? getEcpSchema(document),
+        targetVersion: options.targetVersion,
+        result: document,
+        validation,
+        diagnostics: failureDiagnostics(validation),
+    };
+}
+/**
+ * Build a failed decode result envelope.
+ * @category Encoding
+ */
+export function decodeFailure(partial) {
+    return {
+        schema: "@executioncontrolprotocol.decode.result",
+        version: LATEST_ECP_VERSION,
+        success: false,
+        ...partial,
+        diagnostics: partial.diagnostics,
+    };
+}
+//# sourceMappingURL=json-codec.js.map

package/dist/encoding/json-codec.js.map

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

package/dist/encoding/normalize-workflow.d.ts

@@ -0,0 +1,7 @@
+import type { WorkflowManifest } from "@executioncontrolprotocol/types";
+/**
+ * Normalize a workflow manifest for stable round-trip comparison.
+ * @category Encoding
+ */
+export declare function normalizeWorkflowManifest(manifest: WorkflowManifest): WorkflowManifest;
+//# sourceMappingURL=normalize-workflow.d.ts.map

package/dist/encoding/normalize-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-workflow.d.ts","sourceRoot":"","sources":["../../src/encoding/normalize-workflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAMV,gBAAgB,EAEjB,MAAM,iCAAiC,CAAA;AA+FxC;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,gBAAgB,CAUtF"}