@executioncontrolprotocol/format-toon 0.10.0

package/dist/decode.d.ts

@@ -0,0 +1,10 @@
+import type { DecodeResult, EcpDecodeInput } from "@executioncontrolprotocol/types";
+import { type UtilityCapabilityContext } from "@executioncontrolprotocol/core";
+/**
+ * Decode TOON text to an ECP document via `@toon-format/toon`.
+ * @category Encoding
+ */
+export declare function decodeFromToon(input: EcpDecodeInput, _ctx: UtilityCapabilityContext): DecodeResult;
+/** @deprecated Use {@link decodeFromToon}. @category Encoding */
+export declare const decodeToonToWorkflow: typeof decodeFromToon;
+//# sourceMappingURL=decode.d.ts.map

package/dist/decode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode.d.ts","sourceRoot":"","sources":["../src/decode.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAa,MAAM,iCAAiC,CAAA;AAC9F,OAAO,EAA6C,KAAK,wBAAwB,EAAE,MAAM,gCAAgC,CAAA;AAmBzH;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,wBAAwB,GAC7B,YAAY,CAwDd;AAED,iEAAiE;AACjE,eAAO,MAAM,oBAAoB,uBAAiB,CAAA"}

package/dist/decode.js

@@ -0,0 +1,73 @@
+import { ECP_ENCODING_ERROR_CODES, LATEST_ECP_VERSION, } from "@executioncontrolprotocol/types";
+import { EcpError, decodeFailure, validateWorkflow } from "@executioncontrolprotocol/core";
+import { decodeDocumentFromToon } from "./toon-codec.js";
+import { validateEcpDocument, validationToDiagnostics } from "./validate-document.js";
+import { getEcpSchema } from "./schema.js";
+function wrapHeaderless(document, targetSchema) {
+    if (document !== null && typeof document === "object" && "schema" in document) {
+        return document;
+    }
+    return {
+        schema: targetSchema,
+        version: LATEST_ECP_VERSION,
+        ...document,
+    };
+}
+/**
+ * Decode TOON text to an ECP document via `@toon-format/toon`.
+ * @category Encoding
+ */
+export function decodeFromToon(input, _ctx) {
+    const targetSchema = input.targetSchema ?? "@executioncontrolprotocol.workflow";
+    const content = String(input.input);
+    const headersOpt = input.options?.headers ?? "auto";
+    const hasHeaders = headersOpt === true || (headersOpt === "auto" && /^\s*schema\s*:/m.test(content));
+    let document;
+    try {
+        document = decodeDocumentFromToon(content, {
+            strict: input.options?.strict ?? true,
+            compact: input.options?.compact ?? false,
+        });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return decodeFailure({
+            targetSchema,
+            diagnostics: [
+                {
+                    severity: "error",
+                    code: ECP_ENCODING_ERROR_CODES.FORMAT_DECODE_FAILED,
+                    message: `TOON decode failed: ${message}`,
+                },
+            ],
+        });
+    }
+    if (!hasHeaders) {
+        document = wrapHeaderless(document, targetSchema);
+    }
+    let validation = validateEcpDocument(document, targetSchema);
+    if (targetSchema === "@executioncontrolprotocol.workflow") {
+        validation = validateWorkflow(document);
+    }
+    const diagnostics = validationToDiagnostics(validation);
+    const success = validation.valid;
+    if (!success && input.options?.strict) {
+        throw new EcpError(ECP_ENCODING_ERROR_CODES.FORMAT_DECODE_FAILED, {
+            message: `Decoded document failed validation for ${targetSchema}.`,
+            diagnostics: validation.errors,
+        });
+    }
+    return {
+        schema: "@executioncontrolprotocol.decode.result",
+        version: LATEST_ECP_VERSION,
+        success,
+        targetSchema: getEcpSchema(document) ?? targetSchema,
+        targetVersion: input.targetVersion,
+        result: document,
+        validation,
+        diagnostics: [...diagnostics, ...validation.errors, ...validation.warnings],
+    };
+}
+/** @deprecated Use {@link decodeFromToon}. @category Encoding */
+export const decodeToonToWorkflow = decodeFromToon;
+//# sourceMappingURL=decode.js.map

package/dist/decode.js.map

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

package/dist/encode.d.ts

@@ -0,0 +1,10 @@
+import type { EcpEncodeInput, EncodeResult } from "@executioncontrolprotocol/types";
+import { type UtilityCapabilityContext } from "@executioncontrolprotocol/core";
+/**
+ * Encode document to TOON via `@toon-format/toon`.
+ * @category Encoding
+ */
+export declare function encodeToToon(input: EcpEncodeInput, _ctx: UtilityCapabilityContext): EncodeResult<string>;
+/** @deprecated Use {@link encodeToToon}. @category Encoding */
+export declare const encodeWorkflowToToon: typeof encodeToToon;
+//# sourceMappingURL=encode.d.ts.map

package/dist/encode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode.d.ts","sourceRoot":"","sources":["../src/encode.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAA;AACnF,OAAO,EAA6C,KAAK,wBAAwB,EAAE,MAAM,gCAAgC,CAAA;AAWzH;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,wBAAwB,GAC7B,YAAY,CAAC,MAAM,CAAC,CA4CtB;AAED,+DAA+D;AAC/D,eAAO,MAAM,oBAAoB,qBAAe,CAAA"}

package/dist/encode.js

@@ -0,0 +1,59 @@
+import { ECP_ENCODING_ERROR_CODES, ECP_FORMATS, LATEST_ECP_VERSION, } from "@executioncontrolprotocol/types";
+import { EcpError, encodeFailure, validateWorkflow } from "@executioncontrolprotocol/core";
+import { encodeDocumentToToon } from "./toon-codec.js";
+import { validateEcpDocument, validationToDiagnostics } from "./validate-document.js";
+function stripDocumentHeaders(doc) {
+    const rest = { ...doc };
+    delete rest.schema;
+    delete rest.version;
+    return rest;
+}
+/**
+ * Encode document to TOON via `@toon-format/toon`.
+ * @category Encoding
+ */
+export function encodeToToon(input, _ctx) {
+    const sourceSchema = input.sourceSchema;
+    const validation = validateEcpDocument(input.source, sourceSchema);
+    const diagnostics = validationToDiagnostics(validation);
+    if (sourceSchema === "@executioncontrolprotocol.workflow") {
+        const wfValidation = validateWorkflow(input.source);
+        if (!wfValidation.valid) {
+            return encodeFailure({
+                format: ECP_FORMATS.TOON,
+                sourceSchema,
+                validation: wfValidation,
+                diagnostics: [...diagnostics, ...wfValidation.errors, ...wfValidation.warnings],
+            });
+        }
+    }
+    const headers = input.options?.headers !== false;
+    const compact = input.options?.compact ?? false;
+    try {
+        let payload = input.source;
+        if (!headers && payload !== null && typeof payload === "object") {
+            payload = stripDocumentHeaders(payload);
+        }
+        const content = encodeDocumentToToon(payload, { compact });
+        return {
+            schema: "@executioncontrolprotocol.encode.result",
+            version: LATEST_ECP_VERSION,
+            success: true,
+            format: ECP_FORMATS.TOON,
+            mediaType: "text/ecp-toon",
+            sourceSchema,
+            sourceVersion: input.sourceVersion,
+            result: content,
+            diagnostics,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new EcpError(ECP_ENCODING_ERROR_CODES.FORMAT_ENCODE_FAILED, {
+            message: `TOON encode failed: ${message}`,
+        });
+    }
+}
+/** @deprecated Use {@link encodeToToon}. @category Encoding */
+export const encodeWorkflowToToon = encodeToToon;
+//# sourceMappingURL=encode.js.map

package/dist/encode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode.js","sourceRoot":"","sources":["../src/encode.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,WAAW,EACX,kBAAkB,GACnB,MAAM,iCAAiC,CAAA;AAExC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,gBAAgB,EAAiC,MAAM,gCAAgC,CAAA;AACzH,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAErF,SAAS,oBAAoB,CAAC,GAA4B;IACxD,MAAM,IAAI,GAAG,EAAE,GAAG,GAAG,EAAE,CAAA;IACvB,OAAO,IAAI,CAAC,MAAM,CAAA;IAClB,OAAO,IAAI,CAAC,OAAO,CAAA;IACnB,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAqB,EACrB,IAA8B;IAE9B,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,CAAA;IACvC,MAAM,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IAClE,MAAM,WAAW,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAA;IAEvD,IAAI,YAAY,KAAK,oCAAoC,EAAE,CAAC;QAC1D,MAAM,YAAY,GAAG,gBAAgB,CAAC,KAAK,CAAC,MAAoE,CAAC,CAAA;QACjH,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;YACxB,OAAO,aAAa,CAAC;gBACnB,MAAM,EAAE,WAAW,CAAC,IAAI;gBACxB,YAAY;gBACZ,UAAU,EAAE,YAAY;gBACxB,WAAW,EAAE,CAAC,GAAG,WAAW,EAAE,GAAG,YAAY,CAAC,MAAM,EAAE,GAAG,YAAY,CAAC,QAAQ,CAAC;aAChF,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,OAAO,KAAK,KAAK,CAAA;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,OAAO,IAAI,KAAK,CAAA;IAE/C,IAAI,CAAC;QACH,IAAI,OAAO,GAAG,KAAK,CAAC,MAAM,CAAA;QAC1B,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChE,OAAO,GAAG,oBAAoB,CAAC,OAAkC,CAAC,CAAA;QACpE,CAAC;QACD,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;QAE1D,OAAO;YACL,MAAM,EAAE,yCAAyC;YACjD,OAAO,EAAE,kBAAkB;YAC3B,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,WAAW,CAAC,IAAI;YACxB,SAAS,EAAE,eAAe;YAC1B,YAAY;YACZ,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,MAAM,EAAE,OAAO;YACf,WAAW;SACZ,CAAA;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,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,uBAAuB,OAAO,EAAE;SAC1C,CAAC,CAAA;IACJ,CAAC;AACH,CAAC;AAED,+DAA+D;AAC/D,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAAA"}

package/dist/extension.d.ts

@@ -0,0 +1,3 @@
+/** TOON format extension definition. @category Extensions */
+export declare const formatToonExtension: import("@executioncontrolprotocol/core").ExtensionDefinition;
+//# sourceMappingURL=extension.d.ts.map

package/dist/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../src/extension.ts"],"names":[],"mappings":"AAWA,6DAA6D;AAC7D,eAAO,MAAM,mBAAmB,8DAYtB,CAAA"}

package/dist/extension.js

@@ -0,0 +1,17 @@
+import { capabilityFor, defineExtension, ecpDecodeInputSchema, ecpDecodeResultSchema, ecpEncodeInputSchema, ecpEncodeResultSchema, } from "@executioncontrolprotocol/core";
+import { decodeFromToon } from "./decode.js";
+import { encodeToToon } from "./encode.js";
+/** TOON format extension definition. @category Extensions */
+export const formatToonExtension = defineExtension("@executioncontrolprotocol", "format-toon")
+    .withCapabilities([
+    capabilityFor("@executioncontrolprotocol/format-toon", "encode")
+        .withInput(ecpEncodeInputSchema)
+        .withOutput(ecpEncodeResultSchema)
+        .withHandler((input, ctx) => encodeToToon(input, ctx)),
+    capabilityFor("@executioncontrolprotocol/format-toon", "decode")
+        .withInput(ecpDecodeInputSchema)
+        .withOutput(ecpDecodeResultSchema)
+        .withHandler((input, ctx) => decodeFromToon(input, ctx)),
+])
+    .build();
+//# sourceMappingURL=extension.js.map

package/dist/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../src/extension.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,gCAAgC,CAAA;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,6DAA6D;AAC7D,MAAM,CAAC,MAAM,mBAAmB,GAAG,eAAe,CAAC,2BAA2B,EAAE,aAAa,CAAC;KAC3F,gBAAgB,CAAC;IAChB,aAAa,CAAC,uCAAuC,EAAE,QAAQ,CAAC;SAC7D,SAAS,CAAC,oBAAoB,CAAC;SAC/B,UAAU,CAAC,qBAAqB,CAAC;SACjC,WAAW,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,KAAiE,EAAE,GAAY,CAAC,CAAC;IAE7H,aAAa,CAAC,uCAAuC,EAAE,QAAQ,CAAC;SAC7D,SAAS,CAAC,oBAAoB,CAAC;SAC/B,UAAU,CAAC,qBAAqB,CAAC;SACjC,WAAW,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,cAAc,CAAC,KAAiE,EAAE,GAAY,CAAC,CAAC;CAChI,CAAC;KACD,KAAK,EAAE,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import { formatToonExtension } from "./extension.js";
+export { formatToonExtension } from "./extension.js";
+export { encodeToToon, encodeWorkflowToToon } from "./encode.js";
+export { decodeFromToon, decodeToonToWorkflow } from "./decode.js";
+export { encodeDocumentToToon, decodeDocumentFromToon, type EncodeDocumentToToonOptions, type DecodeDocumentFromToonOptions, } from "./toon-codec.js";
+export { validateEcpDocument, validationToDiagnostics, TOON_VALIDATED_ECP_SCHEMAS, environmentManifestSchema, environmentDescribeSchema, environmentSearchSchema, type ToonValidatedEcpSchema, } from "./validate-document.js";
+export { getEcpSchema } from "./schema.js";
+/** Register TOON format extension on the registry. @category Extensions */
+export declare function registerFormatToonExtension(registry?: import("@executioncontrolprotocol/core").Registry): Promise<void>;
+export default formatToonExtension;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAIpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAChE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClE,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,KAAK,2BAA2B,EAChC,KAAK,6BAA6B,GACnC,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACvB,KAAK,sBAAsB,GAC5B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,2EAA2E;AAC3E,wBAAsB,2BAA2B,CAC/C,QAAQ,oDAAiB,GACxB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,eAAe,mBAAmB,CAAA"}

package/dist/index.js

@@ -0,0 +1,17 @@
+import { catalogExtension, globalRegistry } from "@executioncontrolprotocol/core";
+import { formatToonExtension } from "./extension.js";
+catalogExtension(formatToonExtension);
+export { formatToonExtension } from "./extension.js";
+export { encodeToToon, encodeWorkflowToToon } from "./encode.js";
+export { decodeFromToon, decodeToonToWorkflow } from "./decode.js";
+export { encodeDocumentToToon, decodeDocumentFromToon, } from "./toon-codec.js";
+export { validateEcpDocument, validationToDiagnostics, TOON_VALIDATED_ECP_SCHEMAS, environmentManifestSchema, environmentDescribeSchema, environmentSearchSchema, } from "./validate-document.js";
+export { getEcpSchema } from "./schema.js";
+/** Register TOON format extension on the registry. @category Extensions */
+export async function registerFormatToonExtension(registry = globalRegistry) {
+    if (!registry.getExtension("@executioncontrolprotocol/format-toon")) {
+        await registry.registerExtension(formatToonExtension);
+    }
+}
+export default formatToonExtension;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAEpD,gBAAgB,CAAC,mBAAmB,CAAC,CAAA;AAErC,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAChE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClE,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GAGvB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,GAExB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,2EAA2E;AAC3E,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,QAAQ,GAAG,cAAc;IAEzB,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,uCAAuC,CAAC,EAAE,CAAC;QACpE,MAAM,QAAQ,CAAC,iBAAiB,CAAC,mBAAmB,CAAC,CAAA;IACvD,CAAC;AACH,CAAC;AAED,eAAe,mBAAmB,CAAA"}

package/dist/schema.d.ts

@@ -0,0 +1,7 @@
+import type { EcpSchema } from "@executioncontrolprotocol/types";
+/**
+ * Infer ECP schema discriminator from a document object.
+ * @category Encoding
+ */
+export declare function getEcpSchema(value: unknown): EcpSchema | undefined;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAA;AAEhE;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAMlE"}

package/dist/schema.js

@@ -0,0 +1,13 @@
+/**
+ * Infer ECP schema discriminator 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;
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,QAAQ,IAAI,KAAK,EAAE,CAAC;QACrE,MAAM,CAAC,GAAI,KAA6B,CAAC,MAAM,CAAA;QAC/C,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAc,CAAA;IAClD,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC"}

package/dist/toon-codec.d.ts

@@ -0,0 +1,23 @@
+/** Options for encoding a document to TOON. @category Encoding */
+export interface EncodeDocumentToToonOptions {
+    /** When true, omit indentation (single-line friendly). */
+    compact?: boolean;
+}
+/**
+ * Encode any JSON-compatible document with `@toon-format/toon`.
+ * @category Encoding
+ */
+export declare function encodeDocumentToToon(document: unknown, options?: EncodeDocumentToToonOptions): string;
+/** Options for decoding TOON text. @category Encoding */
+export interface DecodeDocumentFromToonOptions {
+    /** Pass through to the TOON decoder (array length checks, etc.). */
+    strict?: boolean;
+    /** When true, expand dotted keys produced by compact (`keyFolding: safe`) encoding. */
+    compact?: boolean;
+}
+/**
+ * Decode TOON text to a JSON-compatible value with `@toon-format/toon`.
+ * @category Encoding
+ */
+export declare function decodeDocumentFromToon(text: string, options?: DecodeDocumentFromToonOptions): unknown;
+//# sourceMappingURL=toon-codec.d.ts.map

package/dist/toon-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toon-codec.d.ts","sourceRoot":"","sources":["../src/toon-codec.ts"],"names":[],"mappings":"AAEA,kEAAkE;AAClE,MAAM,WAAW,2BAA2B;IAC1C,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,OAAO,EACjB,OAAO,GAAE,2BAAgC,GACxC,MAAM,CAKR;AAED,yDAAyD;AACzD,MAAM,WAAW,6BAA6B;IAC5C,oEAAoE;IACpE,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,uFAAuF;IACvF,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,6BAAkC,GAC1C,OAAO,CAKT"}

package/dist/toon-codec.js

@@ -0,0 +1,22 @@
+import { encode as toonEncode, decode as toonDecode } from "@toon-format/toon";
+/**
+ * Encode any JSON-compatible document with `@toon-format/toon`.
+ * @category Encoding
+ */
+export function encodeDocumentToToon(document, options = {}) {
+    return toonEncode(document, {
+        indent: 2,
+        keyFolding: options.compact ? "safe" : "off",
+    });
+}
+/**
+ * Decode TOON text to a JSON-compatible value with `@toon-format/toon`.
+ * @category Encoding
+ */
+export function decodeDocumentFromToon(text, options = {}) {
+    return toonDecode(text, {
+        strict: options.strict ?? true,
+        expandPaths: options.compact ? "safe" : "off",
+    });
+}
+//# sourceMappingURL=toon-codec.js.map

package/dist/toon-codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toon-codec.js","sourceRoot":"","sources":["../src/toon-codec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAQ9E;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAiB,EACjB,UAAuC,EAAE;IAEzC,OAAO,UAAU,CAAC,QAAQ,EAAE;QAC1B,MAAM,EAAE,CAAC;QACT,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK;KAC7C,CAAC,CAAA;AACJ,CAAC;AAUD;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAY,EACZ,UAAyC,EAAE;IAE3C,OAAO,UAAU,CAAC,IAAI,EAAE;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK;KAC9C,CAAC,CAAA;AACJ,CAAC"}

package/dist/validate-document.d.ts

@@ -0,0 +1,392 @@
+import type { EcpSchema, ValidationIssue, ValidationResult } from "@executioncontrolprotocol/types";
+import { z } from "zod";
+/** Zod schema for `@executioncontrolprotocol.environment` manifests. @category Encoding */
+export declare const environmentManifestSchema: z.ZodObject<{
+    schema: z.ZodLiteral<"@executioncontrolprotocol.environment">;
+    version: z.ZodString;
+    environment: z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        label?: string | undefined;
+    }, {
+        id: string;
+        label?: string | undefined;
+    }>;
+    runtime: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        label?: string | undefined;
+        config?: Record<string, unknown> | undefined;
+    }, {
+        id: string;
+        label?: string | undefined;
+        config?: Record<string, unknown> | undefined;
+    }>>;
+    extensions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        order: z.ZodNumber;
+        config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        order: number;
+        label?: string | undefined;
+        config?: Record<string, unknown> | undefined;
+    }, {
+        id: string;
+        order: number;
+        label?: string | undefined;
+        config?: Record<string, unknown> | undefined;
+    }>, "many">>;
+    policies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        order: z.ZodNumber;
+        config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        order: number;
+        label?: string | undefined;
+        config?: Record<string, unknown> | undefined;
+    }, {
+        id: string;
+        order: number;
+        label?: string | undefined;
+        config?: Record<string, unknown> | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    schema: "@executioncontrolprotocol.environment";
+    version: string;
+    environment: {
+        id: string;
+        label?: string | undefined;
+    };
+    runtime?: {
+        id: string;
+        label?: string | undefined;
+        config?: Record<string, unknown> | undefined;
+    } | undefined;
+    extensions?: {
+        id: string;
+        order: number;
+        label?: string | undefined;
+        config?: Record<string, unknown> | undefined;
+    }[] | undefined;
+    policies?: {
+        id: string;
+        order: number;
+        label?: string | undefined;
+        config?: Record<string, unknown> | undefined;
+    }[] | undefined;
+}, {
+    schema: "@executioncontrolprotocol.environment";
+    version: string;
+    environment: {
+        id: string;
+        label?: string | undefined;
+    };
+    runtime?: {
+        id: string;
+        label?: string | undefined;
+        config?: Record<string, unknown> | undefined;
+    } | undefined;
+    extensions?: {
+        id: string;
+        order: number;
+        label?: string | undefined;
+        config?: Record<string, unknown> | undefined;
+    }[] | undefined;
+    policies?: {
+        id: string;
+        order: number;
+        label?: string | undefined;
+        config?: Record<string, unknown> | undefined;
+    }[] | undefined;
+}>;
+/** Zod schema for `@executioncontrolprotocol.environment.describe` documents. @category Encoding */
+export declare const environmentDescribeSchema: z.ZodObject<{
+    schema: z.ZodLiteral<"@executioncontrolprotocol.environment.describe">;
+    version: z.ZodString;
+    environment: z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        label?: string | undefined;
+    }, {
+        id: string;
+        label?: string | undefined;
+    }>;
+    runtime: z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        features: z.ZodObject<{
+            durableExecution: z.ZodOptional<z.ZodBoolean>;
+            loops: z.ZodOptional<z.ZodBoolean>;
+            parallel: z.ZodOptional<z.ZodBoolean>;
+            branches: z.ZodOptional<z.ZodBoolean>;
+            pauses: z.ZodOptional<z.ZodBoolean>;
+            cancellation: z.ZodOptional<z.ZodBoolean>;
+            longRunningWorkflows: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            durableExecution?: boolean | undefined;
+            loops?: boolean | undefined;
+            parallel?: boolean | undefined;
+            branches?: boolean | undefined;
+            pauses?: boolean | undefined;
+            cancellation?: boolean | undefined;
+            longRunningWorkflows?: boolean | undefined;
+        }, {
+            durableExecution?: boolean | undefined;
+            loops?: boolean | undefined;
+            parallel?: boolean | undefined;
+            branches?: boolean | undefined;
+            pauses?: boolean | undefined;
+            cancellation?: boolean | undefined;
+            longRunningWorkflows?: boolean | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        features: {
+            durableExecution?: boolean | undefined;
+            loops?: boolean | undefined;
+            parallel?: boolean | undefined;
+            branches?: boolean | undefined;
+            pauses?: boolean | undefined;
+            cancellation?: boolean | undefined;
+            longRunningWorkflows?: boolean | undefined;
+        };
+        label?: string | undefined;
+    }, {
+        id: string;
+        features: {
+            durableExecution?: boolean | undefined;
+            loops?: boolean | undefined;
+            parallel?: boolean | undefined;
+            branches?: boolean | undefined;
+            pauses?: boolean | undefined;
+            cancellation?: boolean | undefined;
+            longRunningWorkflows?: boolean | undefined;
+        };
+        label?: string | undefined;
+    }>;
+    extensions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        order: z.ZodNumber;
+        configSchema: z.ZodOptional<z.ZodUnknown>;
+        capabilities: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        order: number;
+        capabilities: string[];
+        label?: string | undefined;
+        configSchema?: unknown;
+    }, {
+        id: string;
+        order: number;
+        capabilities: string[];
+        label?: string | undefined;
+        configSchema?: unknown;
+    }>, "many">;
+    capabilities: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        extension: z.ZodString;
+        inputSchema: z.ZodOptional<z.ZodUnknown>;
+        outputSchema: z.ZodOptional<z.ZodUnknown>;
+        examples: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        extension: string;
+        label?: string | undefined;
+        inputSchema?: unknown;
+        outputSchema?: unknown;
+        examples?: unknown[] | undefined;
+    }, {
+        id: string;
+        extension: string;
+        label?: string | undefined;
+        inputSchema?: unknown;
+        outputSchema?: unknown;
+        examples?: unknown[] | undefined;
+    }>, "many">;
+    policies: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        summary: z.ZodOptional<z.ZodString>;
+        config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        configSchema: z.ZodOptional<z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        label?: string | undefined;
+        config?: Record<string, unknown> | undefined;
+        configSchema?: unknown;
+        summary?: string | undefined;
+    }, {
+        id: string;
+        label?: string | undefined;
+        config?: Record<string, unknown> | undefined;
+        configSchema?: unknown;
+        summary?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    schema: "@executioncontrolprotocol.environment.describe";
+    version: string;
+    environment: {
+        id: string;
+        label?: string | undefined;
+    };
+    runtime: {
+        id: string;
+        features: {
+            durableExecution?: boolean | undefined;
+            loops?: boolean | undefined;
+            parallel?: boolean | undefined;
+            branches?: boolean | undefined;
+            pauses?: boolean | undefined;
+            cancellation?: boolean | undefined;
+            longRunningWorkflows?: boolean | undefined;
+        };
+        label?: string | undefined;
+    };
+    extensions: {
+        id: string;
+        order: number;
+        capabilities: string[];
+        label?: string | undefined;
+        configSchema?: unknown;
+    }[];
+    policies: {
+        id: string;
+        label?: string | undefined;
+        config?: Record<string, unknown> | undefined;
+        configSchema?: unknown;
+        summary?: string | undefined;
+    }[];
+    capabilities: {
+        id: string;
+        extension: string;
+        label?: string | undefined;
+        inputSchema?: unknown;
+        outputSchema?: unknown;
+        examples?: unknown[] | undefined;
+    }[];
+}, {
+    schema: "@executioncontrolprotocol.environment.describe";
+    version: string;
+    environment: {
+        id: string;
+        label?: string | undefined;
+    };
+    runtime: {
+        id: string;
+        features: {
+            durableExecution?: boolean | undefined;
+            loops?: boolean | undefined;
+            parallel?: boolean | undefined;
+            branches?: boolean | undefined;
+            pauses?: boolean | undefined;
+            cancellation?: boolean | undefined;
+            longRunningWorkflows?: boolean | undefined;
+        };
+        label?: string | undefined;
+    };
+    extensions: {
+        id: string;
+        order: number;
+        capabilities: string[];
+        label?: string | undefined;
+        configSchema?: unknown;
+    }[];
+    policies: {
+        id: string;
+        label?: string | undefined;
+        config?: Record<string, unknown> | undefined;
+        configSchema?: unknown;
+        summary?: string | undefined;
+    }[];
+    capabilities: {
+        id: string;
+        extension: string;
+        label?: string | undefined;
+        inputSchema?: unknown;
+        outputSchema?: unknown;
+        examples?: unknown[] | undefined;
+    }[];
+}>;
+/** Zod schema for `@executioncontrolprotocol.environment.search` documents. @category Encoding */
+export declare const environmentSearchSchema: z.ZodObject<{
+    schema: z.ZodLiteral<"@executioncontrolprotocol.environment.search">;
+    version: z.ZodString;
+    results: z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        score: z.ZodNumber;
+        reason: z.ZodOptional<z.ZodString>;
+        inputSchema: z.ZodOptional<z.ZodUnknown>;
+        outputSchema: z.ZodOptional<z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        type: string;
+        score: number;
+        label?: string | undefined;
+        inputSchema?: unknown;
+        outputSchema?: unknown;
+        reason?: string | undefined;
+    }, {
+        id: string;
+        type: string;
+        score: number;
+        label?: string | undefined;
+        inputSchema?: unknown;
+        outputSchema?: unknown;
+        reason?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    schema: "@executioncontrolprotocol.environment.search";
+    version: string;
+    results: {
+        id: string;
+        type: string;
+        score: number;
+        label?: string | undefined;
+        inputSchema?: unknown;
+        outputSchema?: unknown;
+        reason?: string | undefined;
+    }[];
+}, {
+    schema: "@executioncontrolprotocol.environment.search";
+    version: string;
+    results: {
+        id: string;
+        type: string;
+        score: number;
+        label?: string | undefined;
+        inputSchema?: unknown;
+        outputSchema?: unknown;
+        reason?: string | undefined;
+    }[];
+}>;
+/** Schemas that receive optional structural validation after TOON decode. @category Encoding */
+export declare const TOON_VALIDATED_ECP_SCHEMAS: readonly ["@executioncontrolprotocol.workflow", "@executioncontrolprotocol.environment", "@executioncontrolprotocol.environment.describe", "@executioncontrolprotocol.environment.search", "@executioncontrolprotocol.patch"];
+/** Union of schemas with built-in TOON validation. @category Encoding */
+export type ToonValidatedEcpSchema = (typeof TOON_VALIDATED_ECP_SCHEMAS)[number];
+/**
+ * Validate a decoded document when its schema is known to ECP.
+ * Unknown schemas return valid with no diagnostics (schema-agnostic TOON).
+ * @category Encoding
+ */
+export declare function validateEcpDocument(document: unknown, schema?: EcpSchema | string): ValidationResult;
+/**
+ * Merge validation issues into a diagnostics list.
+ * @category Encoding
+ */
+export declare function validationToDiagnostics(validation: ValidationResult): ValidationIssue[];
+//# sourceMappingURL=validate-document.d.ts.map

package/dist/validate-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-document.d.ts","sourceRoot":"","sources":["../src/validate-document.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAEnG,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AASvB,2FAA2F;AAC3F,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBpC,CAAA;AAYF,oGAAoG;AACpG,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwCpC,CAAA;AAEF,kGAAkG;AAClG,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAclC,CAAA;AAEF,gGAAgG;AAChG,eAAO,MAAM,0BAA0B,+NAME,CAAA;AAEzC,yEAAyE;AACzE,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAA;AAmBhF;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,OAAO,EACjB,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,GAC1B,gBAAgB,CA4BlB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,gBAAgB,GAAG,eAAe,EAAE,CAEvF"}

package/dist/validate-document.js

@@ -0,0 +1,149 @@
+import { ecpPatchDocumentSchema, validateWorkflow, zodIssuesToValidationIssues, } from "@executioncontrolprotocol/core";
+import { LATEST_ECP_VERSION } from "@executioncontrolprotocol/types";
+import { z } from "zod";
+const bindingSchema = z.object({
+    id: z.string().min(1),
+    label: z.string().optional(),
+    order: z.number().int().nonnegative(),
+    config: z.record(z.unknown()).optional(),
+});
+/** Zod schema for `@executioncontrolprotocol.environment` manifests. @category Encoding */
+export const environmentManifestSchema = z.object({
+    schema: z.literal("@executioncontrolprotocol.environment"),
+    version: z.string(),
+    environment: z.object({
+        id: z.string().min(1),
+        label: z.string().optional(),
+    }),
+    runtime: z
+        .object({
+        id: z.string().min(1),
+        label: z.string().optional(),
+        config: z.record(z.unknown()).optional(),
+    })
+        .optional(),
+    extensions: z.array(bindingSchema).optional(),
+    policies: z.array(bindingSchema).optional(),
+});
+const runtimeFeaturesSchema = z.object({
+    durableExecution: z.boolean().optional(),
+    loops: z.boolean().optional(),
+    parallel: z.boolean().optional(),
+    branches: z.boolean().optional(),
+    pauses: z.boolean().optional(),
+    cancellation: z.boolean().optional(),
+    longRunningWorkflows: z.boolean().optional(),
+});
+/** Zod schema for `@executioncontrolprotocol.environment.describe` documents. @category Encoding */
+export const environmentDescribeSchema = z.object({
+    schema: z.literal("@executioncontrolprotocol.environment.describe"),
+    version: z.string(),
+    environment: z.object({
+        id: z.string().min(1),
+        label: z.string().optional(),
+    }),
+    runtime: z.object({
+        id: z.string().min(1),
+        label: z.string().optional(),
+        features: runtimeFeaturesSchema,
+    }),
+    extensions: z.array(z.object({
+        id: z.string().min(1),
+        label: z.string().optional(),
+        order: z.number().int().nonnegative(),
+        configSchema: z.unknown().optional(),
+        capabilities: z.array(z.string()),
+    })),
+    capabilities: z.array(z.object({
+        id: z.string().min(1),
+        label: z.string().optional(),
+        extension: z.string().min(1),
+        inputSchema: z.unknown().optional(),
+        outputSchema: z.unknown().optional(),
+        examples: z.array(z.unknown()).optional(),
+    })),
+    policies: z.array(z.object({
+        id: z.string().min(1),
+        label: z.string().optional(),
+        summary: z.string().optional(),
+        config: z.record(z.unknown()).optional(),
+        configSchema: z.unknown().optional(),
+    })),
+});
+/** Zod schema for `@executioncontrolprotocol.environment.search` documents. @category Encoding */
+export const environmentSearchSchema = z.object({
+    schema: z.literal("@executioncontrolprotocol.environment.search"),
+    version: z.string(),
+    results: z.array(z.object({
+        type: z.string().min(1),
+        id: z.string().min(1),
+        label: z.string().optional(),
+        score: z.number(),
+        reason: z.string().optional(),
+        inputSchema: z.unknown().optional(),
+        outputSchema: z.unknown().optional(),
+    })),
+});
+/** Schemas that receive optional structural validation after TOON decode. @category Encoding */
+export const TOON_VALIDATED_ECP_SCHEMAS = [
+    "@executioncontrolprotocol.workflow",
+    "@executioncontrolprotocol.environment",
+    "@executioncontrolprotocol.environment.describe",
+    "@executioncontrolprotocol.environment.search",
+    "@executioncontrolprotocol.patch",
+];
+function emptyValidation(valid) {
+    return {
+        schema: "@executioncontrolprotocol.validation.result",
+        version: LATEST_ECP_VERSION,
+        valid,
+        errors: [],
+        warnings: [],
+    };
+}
+function zodToResult(parsed) {
+    if (parsed.success)
+        return emptyValidation(true);
+    const result = emptyValidation(false);
+    result.errors.push(...zodIssuesToValidationIssues(parsed.error.issues));
+    return result;
+}
+/**
+ * Validate a decoded document when its schema is known to ECP.
+ * Unknown schemas return valid with no diagnostics (schema-agnostic TOON).
+ * @category Encoding
+ */
+export function validateEcpDocument(document, schema) {
+    const resolved = schema ??
+        (document !== null &&
+            typeof document === "object" &&
+            "schema" in document &&
+            typeof document.schema === "string"
+            ? document.schema
+            : undefined);
+    if (!resolved || !TOON_VALIDATED_ECP_SCHEMAS.includes(resolved)) {
+        return emptyValidation(true);
+    }
+    switch (resolved) {
+        case "@executioncontrolprotocol.workflow":
+            return validateWorkflow(document);
+        case "@executioncontrolprotocol.environment":
+            return zodToResult(environmentManifestSchema.safeParse(document));
+        case "@executioncontrolprotocol.environment.describe":
+            return zodToResult(environmentDescribeSchema.safeParse(document));
+        case "@executioncontrolprotocol.environment.search":
+            return zodToResult(environmentSearchSchema.safeParse(document));
+        case "@executioncontrolprotocol.patch":
+            return zodToResult(ecpPatchDocumentSchema.safeParse(document));
+        default:
+            return emptyValidation(true);
+    }
+}
+/**
+ * Merge validation issues into a diagnostics list.
+ * @category Encoding
+ */
+export function validationToDiagnostics(validation) {
+    return [...validation.errors, ...validation.warnings];
+}
+//# sourceMappingURL=validate-document.js.map

package/dist/validate-document.js.map

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

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@executioncontrolprotocol/format-toon",
+  "version": "0.10.0",
+  "description": "ECP TOON format extension using @toon-format/toon (schema-agnostic with optional ECP validation)",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "dependencies": {
+    "@toon-format/toon": "^2.3.0"
+  },
+  "peerDependencies": {
+    "@executioncontrolprotocol/core": "^0.10.0",
+    "@executioncontrolprotocol/types": "^0.10.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@executioncontrolprotocol/core": "0.10.0",
+    "@executioncontrolprotocol/types": "0.10.0",
+    "typescript": "^5.7.0",
+    "zod": "^3.24.0"
+  }
+}