@executioncontrolprotocol/runtime 0.3.0

package/dist/tracing/exporters/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../../src/tracing/exporters/console.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjE;;;;GAIG;AACH,qBAAa,oBAAqB,YAAW,aAAa;IACxD,QAAQ,CAAC,IAAI,aAAa;IAEpB,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAqEnD"}

package/dist/tracing/exporters/console.js

@@ -0,0 +1,76 @@
+/**
+ * Console trace exporter — prints a human-readable execution trace
+ * to stderr.
+ *
+ * @category Tracing
+ */
+/**
+ * Exports execution traces as formatted text to the console.
+ *
+ * @category Tracing
+ */
+export class ConsoleTraceExporter {
+    name = "console";
+    async export(trace) {
+        const lines = [];
+        lines.push("");
+        lines.push("═══ Execution Trace ═══");
+        lines.push(`  Execution ID: ${trace.executionId}`);
+        lines.push(`  Context:      ${trace.contextName} v${trace.contextVersion}`);
+        lines.push(`  Strategy:     ${trace.strategy}`);
+        lines.push(`  Duration:     ${trace.durationMs}ms`);
+        lines.push(`  Success:      ${trace.success}`);
+        if (trace.error) {
+            lines.push(`  Error:        ${trace.error}`);
+        }
+        lines.push("");
+        for (const span of trace.spans) {
+            const prefix = `  Step ${span.step}`;
+            switch (span.type) {
+                case "executor":
+                    lines.push(`${prefix} [Executor: ${span.executorName}] (${span.durationMs}ms)`);
+                    if (span.error)
+                        lines.push(`         Error: ${span.error}`);
+                    break;
+                case "model-generation":
+                    lines.push(`${prefix} [Model: ${span.model ?? "unknown"}] (${span.durationMs}ms)`);
+                    if (span.tokens) {
+                        lines.push(`         Tokens: ${span.tokens.prompt} prompt + ${span.tokens.completion} completion = ${span.tokens.total} total`);
+                    }
+                    if (span.reasoning) {
+                        const short = span.reasoning.length > 200
+                            ? span.reasoning.slice(0, 200) + "…"
+                            : span.reasoning;
+                        lines.push(`         Reasoning: ${short}`);
+                    }
+                    if (span.output) {
+                        const json = JSON.stringify(span.output);
+                        const short = json.length > 200 ? json.slice(0, 200) + "…" : json;
+                        lines.push(`         Output: ${short}`);
+                    }
+                    break;
+                case "tool-call":
+                    lines.push(`${prefix} [Tool: ${span.toolName}] (${span.durationMs}ms)`);
+                    if (span.toolArgs) {
+                        lines.push(`         Args: ${JSON.stringify(span.toolArgs)}`);
+                    }
+                    if (span.toolIsError) {
+                        lines.push(`         Error: ${JSON.stringify(span.toolResult)}`);
+                    }
+                    break;
+                case "mount-hydration":
+                    lines.push(`${prefix} [Mount: ${span.mountName} (${span.mountStage})] ` +
+                        `${span.mountItemCount ?? 0} items (${span.durationMs}ms)`);
+                    break;
+                case "delegation":
+                    lines.push(`${prefix} [Delegate: ${span.executorName}] (${span.durationMs}ms)`);
+                    if (span.error)
+                        lines.push(`         Error: ${span.error}`);
+                    break;
+            }
+        }
+        lines.push("");
+        console.error(lines.join("\n"));
+    }
+}
+//# sourceMappingURL=console.js.map

package/dist/tracing/exporters/console.js.map

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

package/dist/tracing/exporters/index.d.ts

@@ -0,0 +1,4 @@
+export { ConsoleTraceExporter } from "./console.js";
+export { JsonFileTraceExporter } from "./json-file.js";
+export type { JsonFileExporterConfig } from "./json-file.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tracing/exporters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tracing/exporters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,YAAY,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/tracing/exporters/index.js

@@ -0,0 +1,3 @@
+export { ConsoleTraceExporter } from "./console.js";
+export { JsonFileTraceExporter } from "./json-file.js";
+//# sourceMappingURL=index.js.map

package/dist/tracing/exporters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tracing/exporters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/tracing/exporters/json-file.d.ts

@@ -0,0 +1,30 @@
+/**
+ * JSON file trace exporter — persists execution traces as JSON files
+ * so they can be loaded later by `ecp trace` and `ecp graph`.
+ *
+ * @category Tracing
+ */
+import type { ExecutionTrace, TraceExporter } from "../types.js";
+/**
+ * Configuration for the JSON file exporter.
+ *
+ * @category Tracing
+ */
+export interface JsonFileExporterConfig {
+    /** Directory to write trace files to. Defaults to `"./traces"`. */
+    outputDir?: string;
+}
+/**
+ * Exports execution traces as JSON files to disk.
+ *
+ * Each trace is saved as `<outputDir>/<executionId>.json`.
+ *
+ * @category Tracing
+ */
+export declare class JsonFileTraceExporter implements TraceExporter {
+    readonly name = "json-file";
+    private readonly outputDir;
+    constructor(config?: JsonFileExporterConfig);
+    export(trace: ExecutionTrace): Promise<void>;
+}
+//# sourceMappingURL=json-file.d.ts.map

package/dist/tracing/exporters/json-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-file.d.ts","sourceRoot":"","sources":["../../../src/tracing/exporters/json-file.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjE;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,qBAAa,qBAAsB,YAAW,aAAa;IACzD,QAAQ,CAAC,IAAI,eAAe;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,GAAE,sBAA2B;IAIzC,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAKnD"}

package/dist/tracing/exporters/json-file.js

@@ -0,0 +1,28 @@
+/**
+ * JSON file trace exporter — persists execution traces as JSON files
+ * so they can be loaded later by `ecp trace` and `ecp graph`.
+ *
+ * @category Tracing
+ */
+import { writeFileSync, mkdirSync } from "node:fs";
+import { resolve } from "node:path";
+/**
+ * Exports execution traces as JSON files to disk.
+ *
+ * Each trace is saved as `<outputDir>/<executionId>.json`.
+ *
+ * @category Tracing
+ */
+export class JsonFileTraceExporter {
+    name = "json-file";
+    outputDir;
+    constructor(config = {}) {
+        this.outputDir = config.outputDir ?? "./traces";
+    }
+    async export(trace) {
+        mkdirSync(this.outputDir, { recursive: true });
+        const filePath = resolve(this.outputDir, `${trace.executionId}.json`);
+        writeFileSync(filePath, JSON.stringify(trace, null, 2), "utf-8");
+    }
+}
+//# sourceMappingURL=json-file.js.map

package/dist/tracing/exporters/json-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-file.js","sourceRoot":"","sources":["../../../src/tracing/exporters/json-file.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC;;;;;;GAMG;AACH,MAAM,OAAO,qBAAqB;IACvB,IAAI,GAAG,WAAW,CAAC;IACX,SAAS,CAAS;IAEnC,YAAY,SAAiC,EAAE;QAC7C,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,UAAU,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAqB;QAChC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,KAAK,CAAC,WAAW,OAAO,CAAC,CAAC;QACtE,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;CACF"}

package/dist/tracing/formatter.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Trace formatter — produces human-readable output for `ecp trace`.
+ *
+ * @category Tracing
+ */
+import type { ExecutionTrace } from "./types.js";
+/**
+ * Format an execution trace for terminal display.
+ *
+ * @param trace - The trace to format.
+ * @returns Multi-line string ready for printing.
+ *
+ * @category Tracing
+ */
+export declare function formatTrace(trace: ExecutionTrace): string;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/tracing/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/tracing/formatter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAa,MAAM,YAAY,CAAC;AAyD5D;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAoBzD"}

package/dist/tracing/formatter.js

@@ -0,0 +1,81 @@
+/**
+ * Trace formatter — produces human-readable output for `ecp trace`.
+ *
+ * @category Tracing
+ */
+function truncate(str, max) {
+    return str.length > max ? str.slice(0, max) + "…" : str;
+}
+function formatSpan(span) {
+    const lines = [];
+    const label = `Step ${span.step}`;
+    switch (span.type) {
+        case "executor":
+            lines.push(`${label}  [Executor] ${span.executorName} (${span.durationMs}ms)`);
+            if (span.error)
+                lines.push(`        Error: ${span.error}`);
+            break;
+        case "model-generation":
+            lines.push(`${label}  [Model] ${span.model ?? "unknown"} for ${span.executorName} (${span.durationMs}ms)`);
+            if (span.tokens) {
+                lines.push(`        Tokens: ${span.tokens.prompt} in / ${span.tokens.completion} out / ${span.tokens.total} total`);
+            }
+            if (span.reasoning) {
+                lines.push(`        Reasoning: ${truncate(span.reasoning, 300)}`);
+            }
+            if (span.output) {
+                lines.push(`        Output: ${truncate(JSON.stringify(span.output), 300)}`);
+            }
+            if (span.error)
+                lines.push(`        Error: ${span.error}`);
+            break;
+        case "tool-call":
+            lines.push(`${label}  [Tool] ${span.toolName} for ${span.executorName} (${span.durationMs}ms)`);
+            if (span.toolArgs && Object.keys(span.toolArgs).length > 0) {
+                lines.push(`        Args: ${truncate(JSON.stringify(span.toolArgs), 200)}`);
+            }
+            if (span.toolIsError) {
+                lines.push(`        Error: ${truncate(JSON.stringify(span.toolResult), 200)}`);
+            }
+            else if (span.toolResult !== undefined) {
+                lines.push(`        Result: ${truncate(JSON.stringify(span.toolResult), 200)}`);
+            }
+            break;
+        case "mount-hydration":
+            lines.push(`${label}  [Mount] ${span.mountName} (${span.mountStage}) → ${span.mountItemCount ?? 0} items (${span.durationMs}ms)`);
+            break;
+        case "delegation":
+            lines.push(`${label}  [Delegate] → ${span.executorName} (${span.durationMs}ms)`);
+            if (span.error)
+                lines.push(`        Error: ${span.error}`);
+            break;
+    }
+    return lines;
+}
+/**
+ * Format an execution trace for terminal display.
+ *
+ * @param trace - The trace to format.
+ * @returns Multi-line string ready for printing.
+ *
+ * @category Tracing
+ */
+export function formatTrace(trace) {
+    const lines = [];
+    lines.push("");
+    lines.push(`Execution ID: ${trace.executionId}`);
+    lines.push(`Context:      ${trace.contextName} v${trace.contextVersion}`);
+    lines.push(`Strategy:     ${trace.strategy}`);
+    lines.push(`Duration:     ${trace.durationMs}ms`);
+    lines.push(`Status:       ${trace.success ? "success" : "failed"}`);
+    if (trace.error) {
+        lines.push(`Error:        ${trace.error}`);
+    }
+    lines.push("");
+    for (const span of trace.spans) {
+        lines.push(...formatSpan(span));
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+//# sourceMappingURL=formatter.js.map

package/dist/tracing/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../src/tracing/formatter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,SAAS,QAAQ,CAAC,GAAW,EAAE,GAAW;IACxC,OAAO,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AAC1D,CAAC;AAED,SAAS,UAAU,CAAC,IAAe;IACjC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;IAElC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,UAAU;YACb,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,gBAAgB,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,UAAU,KAAK,CAAC,CAAC;YAC/E,IAAI,IAAI,CAAC,KAAK;gBAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAC3D,MAAM;QAER,KAAK,kBAAkB;YACrB,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,aAAa,IAAI,CAAC,KAAK,IAAI,SAAS,QAAQ,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,UAAU,KAAK,CAAC,CAAC;YAC3G,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,KAAK,CAAC,IAAI,CAAC,mBAAmB,IAAI,CAAC,MAAM,CAAC,MAAM,SAAS,IAAI,CAAC,MAAM,CAAC,UAAU,UAAU,IAAI,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC;YACtH,CAAC;YACD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnB,KAAK,CAAC,IAAI,CAAC,sBAAsB,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YACpE,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,KAAK,CAAC,IAAI,CAAC,mBAAmB,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9E,CAAC;YACD,IAAI,IAAI,CAAC,KAAK;gBAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAC3D,MAAM;QAER,KAAK,WAAW;YACd,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,YAAY,IAAI,CAAC,QAAQ,QAAQ,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,UAAU,KAAK,CAAC,CAAC;YAChG,IAAI,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3D,KAAK,CAAC,IAAI,CAAC,iBAAiB,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9E,CAAC;YACD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACrB,KAAK,CAAC,IAAI,CAAC,kBAAkB,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YACjF,CAAC;iBAAM,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBACzC,KAAK,CAAC,IAAI,CAAC,mBAAmB,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAClF,CAAC;YACD,MAAM;QAER,KAAK,iBAAiB;YACpB,KAAK,CAAC,IAAI,CACR,GAAG,KAAK,aAAa,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,UAAU,OAAO,IAAI,CAAC,cAAc,IAAI,CAAC,WAAW,IAAI,CAAC,UAAU,KAAK,CACtH,CAAC;YACF,MAAM;QAER,KAAK,YAAY;YACf,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,kBAAkB,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,UAAU,KAAK,CAAC,CAAC;YACjF,IAAI,IAAI,CAAC,KAAK;gBAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAC3D,MAAM;IACV,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,KAAqB;IAC/C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,iBAAiB,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CAAC,iBAAiB,KAAK,CAAC,WAAW,KAAK,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC;IAC1E,KAAK,CAAC,IAAI,CAAC,iBAAiB,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9C,KAAK,CAAC,IAAI,CAAC,iBAAiB,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;IAClD,KAAK,CAAC,IAAI,CAAC,iBAAiB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;IACpE,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,iBAAiB,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7C,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/tracing/graph.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Execution graph renderer — produces an ASCII tree visualization
+ * of a Context execution for `ecp graph`.
+ *
+ * @category Tracing
+ */
+import type { ExecutionTrace } from "./types.js";
+/**
+ * Render an execution trace as an ASCII tree.
+ *
+ * @param trace - The trace to render.
+ * @returns Multi-line string with tree visualization.
+ *
+ * @category Tracing
+ */
+export declare function renderGraph(trace: ExecutionTrace): string;
+//# sourceMappingURL=graph.d.ts.map

package/dist/tracing/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/tracing/graph.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAa,MAAM,YAAY,CAAC;AAkH5D;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAezD"}

package/dist/tracing/graph.js

@@ -0,0 +1,116 @@
+/**
+ * Execution graph renderer — produces an ASCII tree visualization
+ * of a Context execution for `ecp graph`.
+ *
+ * @category Tracing
+ */
+function truncate(str, max) {
+    return str.length > max ? str.slice(0, max) + "…" : str;
+}
+function spanLabel(span) {
+    switch (span.type) {
+        case "executor":
+            return `${span.executorName}`;
+        case "model-generation": {
+            const tok = span.tokens ? `, ${span.tokens.total} tok` : "";
+            return `model: ${span.model ?? "?"}${tok}, ${span.durationMs}ms`;
+        }
+        case "tool-call":
+            return `tool: ${span.toolName} (${span.durationMs}ms)`;
+        case "mount-hydration":
+            return `mount: ${span.mountName} [${span.mountStage}] → ${span.mountItemCount ?? 0} items`;
+        case "delegation":
+            return `delegate → ${span.executorName}`;
+        default:
+            return span.type;
+    }
+}
+function spanDetail(span) {
+    if (span.reasoning) {
+        return `reasoning: ${truncate(span.reasoning, 120)}`;
+    }
+    if (span.output) {
+        return `output: ${truncate(JSON.stringify(span.output), 120)}`;
+    }
+    if (span.error) {
+        return `error: ${span.error}`;
+    }
+    return undefined;
+}
+function buildTree(trace) {
+    const root = {
+        label: `${trace.executionId} — ${trace.contextName} v${trace.contextVersion} (${trace.strategy}, ${trace.durationMs}ms)`,
+        children: [],
+    };
+    const executorNodes = new Map();
+    const executorSpanIds = new Map();
+    for (const span of trace.spans) {
+        if (span.type === "executor") {
+            const node = {
+                label: `${span.executorName} (${span.durationMs}ms)`,
+                detail: span.error ? `error: ${span.error}` : undefined,
+                children: [],
+            };
+            executorNodes.set(span.executorName, node);
+            executorSpanIds.set(span.id, span.executorName);
+            root.children.push(node);
+        }
+    }
+    for (const span of trace.spans) {
+        if (span.type === "executor")
+            continue;
+        let parent = executorNodes.get(span.executorName);
+        if (!parent) {
+            parent = {
+                label: `${span.executorName}`,
+                children: [],
+            };
+            executorNodes.set(span.executorName, parent);
+            root.children.push(parent);
+        }
+        const node = {
+            label: spanLabel(span),
+            detail: spanDetail(span),
+            children: [],
+        };
+        parent.children.push(node);
+    }
+    return root;
+}
+function renderTree(node, prefix, isLast) {
+    const lines = [];
+    const connector = isLast ? "└── " : "├── ";
+    const childPrefix = isLast ? "    " : "│   ";
+    lines.push(prefix + connector + node.label);
+    if (node.detail) {
+        lines.push(prefix + childPrefix + node.detail);
+    }
+    for (let i = 0; i < node.children.length; i++) {
+        const child = node.children[i];
+        const last = i === node.children.length - 1;
+        lines.push(...renderTree(child, prefix + childPrefix, last));
+    }
+    return lines;
+}
+/**
+ * Render an execution trace as an ASCII tree.
+ *
+ * @param trace - The trace to render.
+ * @returns Multi-line string with tree visualization.
+ *
+ * @category Tracing
+ */
+export function renderGraph(trace) {
+    const tree = buildTree(trace);
+    const lines = [];
+    lines.push("");
+    lines.push(tree.label);
+    for (let i = 0; i < tree.children.length; i++) {
+        const child = tree.children[i];
+        const last = i === tree.children.length - 1;
+        lines.push(...renderTree(child, "", last));
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+//# sourceMappingURL=graph.js.map

package/dist/tracing/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../src/tracing/graph.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,SAAS,QAAQ,CAAC,GAAW,EAAE,GAAW;IACxC,OAAO,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AAC1D,CAAC;AAED,SAAS,SAAS,CAAC,IAAe;IAChC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,UAAU;YACb,OAAO,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAEhC,KAAK,kBAAkB,CAAC,CAAC,CAAC;YACxB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,OAAO,UAAU,IAAI,CAAC,KAAK,IAAI,GAAG,GAAG,GAAG,KAAK,IAAI,CAAC,UAAU,IAAI,CAAC;QACnE,CAAC;QAED,KAAK,WAAW;YACd,OAAO,SAAS,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,UAAU,KAAK,CAAC;QAEzD,KAAK,iBAAiB;YACpB,OAAO,UAAU,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,UAAU,OAAO,IAAI,CAAC,cAAc,IAAI,CAAC,QAAQ,CAAC;QAE7F,KAAK,YAAY;YACf,OAAO,cAAc,IAAI,CAAC,YAAY,EAAE,CAAC;QAE3C;YACE,OAAO,IAAI,CAAC,IAAI,CAAC;IACrB,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,IAAe;IACjC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,OAAO,cAAc,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC;IACvD,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,OAAO,WAAW,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IACjE,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,SAAS,CAAC,KAAqB;IACtC,MAAM,IAAI,GAAa;QACrB,KAAK,EAAE,GAAG,KAAK,CAAC,WAAW,MAAM,KAAK,CAAC,WAAW,KAAK,KAAK,CAAC,cAAc,KAAK,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,UAAU,KAAK;QACxH,QAAQ,EAAE,EAAE;KACb,CAAC;IAEF,MAAM,aAAa,GAAG,IAAI,GAAG,EAAoB,CAAC;IAClD,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;IAElD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAa;gBACrB,KAAK,EAAE,GAAG,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,UAAU,KAAK;gBACpD,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS;gBACvD,QAAQ,EAAE,EAAE;aACb,CAAC;YACF,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;YAC3C,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;YAChD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;YAAE,SAAS;QAEvC,IAAI,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG;gBACP,KAAK,EAAE,GAAG,IAAI,CAAC,YAAY,EAAE;gBAC7B,QAAQ,EAAE,EAAE;aACb,CAAC;YACF,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YAC7C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QAED,MAAM,IAAI,GAAa;YACrB,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC;YACtB,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC;YACxB,QAAQ,EAAE,EAAE;SACb,CAAC;QACF,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CAAC,IAAc,EAAE,MAAc,EAAE,MAAe;IACjE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAE7C,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QAC5C,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,KAAqB;IAC/C,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QAC5C,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/tracing/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./types.js";
+export * from "./collector.js";
+export * from "./exporters/index.js";
+export { formatTrace } from "./formatter.js";
+export { renderGraph } from "./graph.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tracing/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/tracing/index.js

@@ -0,0 +1,6 @@
+export * from "./types.js";
+export * from "./collector.js";
+export * from "./exporters/index.js";
+export { formatTrace } from "./formatter.js";
+export { renderGraph } from "./graph.js";
+//# sourceMappingURL=index.js.map

package/dist/tracing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tracing/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/tracing/types.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Tracing data model for ECP executions.
+ *
+ * Captures structured spans for every model generation, tool call,
+ * mount hydration, and delegation — providing full observability
+ * into a Context run.
+ *
+ * @category Tracing
+ */
+/**
+ * Token usage for a single model generation.
+ *
+ * @category Tracing
+ */
+export interface SpanTokenUsage {
+    /** Tokens consumed by the prompt/input. */
+    prompt: number;
+    /** Tokens generated in the response. */
+    completion: number;
+    /** Total tokens (prompt + completion). */
+    total: number;
+}
+/**
+ * The type of work a span represents.
+ *
+ * @category Tracing
+ */
+export type SpanType = "executor" | "model-generation" | "tool-call" | "mount-hydration" | "delegation";
+/**
+ * A single span in an execution trace.
+ *
+ * Spans form a tree: each executor span is the parent of its child
+ * model-generation, tool-call, and mount-hydration spans.
+ *
+ * @category Tracing
+ */
+export interface TraceSpan {
+    /** Unique span identifier. */
+    id: string;
+    /** Parent span ID (undefined for root executor spans). */
+    parentId?: string;
+    /** What kind of work this span represents. */
+    type: SpanType;
+    /** Executor that owns this span. */
+    executorName: string;
+    /** ISO-8601 start timestamp. */
+    startedAt: string;
+    /** ISO-8601 end timestamp. */
+    endedAt: string;
+    /** Duration in milliseconds. */
+    durationMs: number;
+    /** Model identifier (for model-generation spans). */
+    model?: string;
+    /** Chain-of-thought or reasoning from the model (when available). */
+    reasoning?: string;
+    /** Structured output produced by this span. */
+    output?: unknown;
+    /** Token usage (for model-generation spans). */
+    tokens?: SpanTokenUsage;
+    /** Qualified tool name, e.g. `"jira:issues.search"` (for tool-call spans). */
+    toolName?: string;
+    /** Tool call arguments (for tool-call spans). */
+    toolArgs?: Record<string, unknown>;
+    /** Tool call result (for tool-call spans). */
+    toolResult?: unknown;
+    /** Whether the tool call returned an error (for tool-call spans). */
+    toolIsError?: boolean;
+    /** Mount name and stage (for mount-hydration spans). */
+    mountName?: string;
+    /** Mount stage (for mount-hydration spans). */
+    mountStage?: string;
+    /** Number of items returned (for mount-hydration spans). */
+    mountItemCount?: number;
+    /** Error message if this span failed. */
+    error?: string;
+    /** Sequential step number within the execution (1-based). */
+    step: number;
+}
+/**
+ * A complete execution trace capturing every span from a Context run.
+ *
+ * @category Tracing
+ */
+export interface ExecutionTrace {
+    /** Unique execution/run identifier. */
+    executionId: string;
+    /** Context name. */
+    contextName: string;
+    /** Context version. */
+    contextVersion: string;
+    /** Orchestration strategy used. */
+    strategy: string;
+    /** ISO-8601 start timestamp. */
+    startedAt: string;
+    /** ISO-8601 end timestamp. */
+    endedAt: string;
+    /** Total duration in milliseconds. */
+    durationMs: number;
+    /** Whether the execution succeeded. */
+    success: boolean;
+    /** Top-level error message (if failed). */
+    error?: string;
+    /** Ordered list of all spans in the execution. */
+    spans: TraceSpan[];
+}
+/**
+ * Interface for exporting execution traces to external systems.
+ *
+ * Implement this interface to send traces to observability platforms
+ * such as Splunk, New Relic, Datadog, or any custom backend.
+ *
+ * @category Tracing
+ */
+export interface TraceExporter {
+    /** Human-readable exporter name (e.g. `"splunk"`, `"newrelic"`). */
+    readonly name: string;
+    /**
+     * Export a completed execution trace.
+     *
+     * @param trace - The execution trace to export.
+     */
+    export(trace: ExecutionTrace): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tracing/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tracing/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IAEf,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IAEnB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAChB,UAAU,GACV,kBAAkB,GAClB,WAAW,GACX,iBAAiB,GACjB,YAAY,CAAC;AAEjB;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IAEX,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,8CAA8C;IAC9C,IAAI,EAAE,QAAQ,CAAC;IAEf,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IAErB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAElB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAEhB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IAEnB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,gDAAgD;IAChD,MAAM,CAAC,EAAE,cAAc,CAAC;IAExB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC,8CAA8C;IAC9C,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,qEAAqE;IACrE,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IAEpB,oBAAoB;IACpB,WAAW,EAAE,MAAM,CAAC;IAEpB,uBAAuB;IACvB,cAAc,EAAE,MAAM,CAAC;IAEvB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IAEjB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAElB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAEhB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IAEnB,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IAEjB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,kDAAkD;IAClD,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C"}

package/dist/tracing/types.js

@@ -0,0 +1,11 @@
+/**
+ * Tracing data model for ECP executions.
+ *
+ * Captures structured spans for every model generation, tool call,
+ * mount hydration, and delegation — providing full observability
+ * into a Context run.
+ *
+ * @category Tracing
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tracing/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tracing/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@executioncontrolprotocol/runtime",
+  "version": "0.3.0",
+  "description": "ECP runtime engine — loads, validates, and executes Context manifests",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./extensions": {
+      "types": "./dist/extensions/index.d.ts",
+      "import": "./dist/extensions/index.js",
+      "default": "./dist/extensions/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "dependencies": {
+    "@a2a-js/sdk": "^0.3.0",
+    "@executioncontrolprotocol/spec": "^0.3.0",
+    "@modelcontextprotocol/sdk": "^1.27.0",
+    "ajv": "^8.17.0",
+    "js-yaml": "^4.1.0",
+    "openai": "^4.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^25.3.3",
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.0"
+  }
+}