@executioncontrolprotocol/cli 0.3.0 → 0.4.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAe,MAAM,aAAa,CAAC;AAqCnD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,OAAO;IAC3C,MAAM,CAAC,OAAO,SAAiC;IAE/C,MAAM,CAAC,KAAK;;;MAYV;IAEF,MAAM,CAAC,IAAI;;MAKT;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA8C3B"}

package/dist/commands/validate.js

@@ -0,0 +1,89 @@
+import { Command, Flags, Args } from "@oclif/core";
+import { resolve } from "node:path";
+import { loadContext, resolveInputs } from "@executioncontrolprotocol/runtime";
+import { parseKeyValueInputs } from "../lib/parsing.js";
+import { getRequiredInputNames } from "../lib/inputs.js";
+function collectExecutionObjectNames(context) {
+    const names = new Set();
+    const addName = (name) => {
+        names.add(name);
+    };
+    const visitOrchestrator = (orchestrator) => {
+        addName(orchestrator.name);
+        for (const executor of orchestrator.executors ?? []) {
+            addName(executor.name);
+        }
+        for (const child of orchestrator.orchestrators ?? []) {
+            visitOrchestrator(child);
+        }
+    };
+    if (context.orchestrator) {
+        visitOrchestrator(context.orchestrator);
+    }
+    for (const executor of context.executors ?? []) {
+        addName(executor.name);
+    }
+    return [...names];
+}
+export default class Validate extends Command {
+    static summary = "Validate a Context manifest";
+    static flags = {
+        input: Flags.string({
+            char: "i",
+            multiple: true,
+            description: "Set an input value (repeatable, key=value)",
+            summary: "Input value (key=value)",
+        }),
+        "skip-inputs": Flags.boolean({
+            description: "Validate the Context manifest itself but skip runtime input resolution (prints required inputs instead).",
+            default: false,
+        }),
+    };
+    static args = {
+        contextPath: Args.string({
+            required: true,
+            description: "Path to context.yaml (or context.json)",
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Validate);
+        const contextPath = resolve(args.contextPath);
+        console.log(`\nValidating: ${contextPath}\n`);
+        let context;
+        try {
+            const inputs = parseKeyValueInputs(flags.input, "--input");
+            context = loadContext(contextPath);
+            if (!flags["skip-inputs"]) {
+                resolveInputs(context, inputs);
+            }
+            const strategy = context.orchestration?.strategy ?? context.orchestrator?.strategy;
+            const executionObjectNames = collectExecutionObjectNames(context);
+            console.log(`  Context: ${context.metadata.name} v${context.metadata.version}`);
+            console.log(`  Strategy: ${strategy ?? "unknown"}`);
+            console.log(`  Execution objects: ${executionObjectNames.join(", ")}`);
+            console.log(`  Schemas: ${Object.keys(context.schemas ?? {}).join(", ")}`);
+            if (flags["skip-inputs"]) {
+                const requiredInputs = getRequiredInputNames(context);
+                if (requiredInputs.length > 0) {
+                    console.log(`\n  Required inputs (from Context): ${requiredInputs.join(", ")}`);
+                }
+                else {
+                    console.log(`\n  No required inputs declared in Context.`);
+                }
+            }
+            console.log(`\n  Validation passed.\n`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            const missing = msg.match(/^Missing required input: "([^"]+)"$/);
+            if (missing && context) {
+                const inputName = missing[1];
+                this.error(`\n  Missing required input "${inputName}" is defined in the Context.\n` +
+                    `  Provide it via --input ${inputName}=<value> (e.g. -i ${inputName}="...").\n`, { exit: 1 });
+                return;
+            }
+            this.error(`\n  Validation failed: ${msg}\n`, { exit: 1 });
+        }
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/commands/validate.js.map

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

package/dist/lib/ecp-home.d.ts

@@ -0,0 +1,3 @@
+export declare function getEcpHomeDir(): string;
+export declare function getDefaultTraceDir(): string;
+//# sourceMappingURL=ecp-home.d.ts.map

package/dist/lib/ecp-home.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecp-home.d.ts","sourceRoot":"","sources":["../../src/lib/ecp-home.ts"],"names":[],"mappings":"AAGA,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/dist/lib/ecp-home.js

@@ -0,0 +1,9 @@
+import { homedir } from "node:os";
+import { resolve } from "node:path";
+export function getEcpHomeDir() {
+    return resolve(homedir(), ".ecp");
+}
+export function getDefaultTraceDir() {
+    return resolve(getEcpHomeDir(), "traces");
+}
+//# sourceMappingURL=ecp-home.js.map

package/dist/lib/ecp-home.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecp-home.js","sourceRoot":"","sources":["../../src/lib/ecp-home.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,OAAO,CAAC,aAAa,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC5C,CAAC"}

package/dist/lib/inputs.d.ts

@@ -0,0 +1,3 @@
+import type { ECPContext } from "@executioncontrolprotocol/spec";
+export declare function getRequiredInputNames(context: ECPContext): string[];
+//# sourceMappingURL=inputs.d.ts.map

package/dist/lib/inputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../../src/lib/inputs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAEjE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,EAAE,CAKnE"}

package/dist/lib/inputs.js

@@ -0,0 +1,7 @@
+export function getRequiredInputNames(context) {
+    const defs = context.inputs ?? {};
+    return Object.entries(defs)
+        .filter(([_name, def]) => def.required === true)
+        .map(([name]) => name);
+}
+//# sourceMappingURL=inputs.js.map

package/dist/lib/inputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputs.js","sourceRoot":"","sources":["../../src/lib/inputs.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,qBAAqB,CAAC,OAAmB;IACvD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;IAClC,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;SACxB,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,CAAE,GAA8B,CAAC,QAAQ,KAAK,IAAI,CAAC;SAC3E,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC"}

package/dist/lib/parsing.d.ts

@@ -0,0 +1,12 @@
+export type InputValue = string | number | boolean;
+/**
+ * Parse `--input key=value` occurrences.
+ * - `true`/`false` become booleans
+ * - numeric-looking values become numbers
+ * - everything else stays a string
+ */
+export declare function parseKeyValueInputs(raw: string[] | undefined, flagName?: string): Record<string, InputValue>;
+export declare function splitCommaSeparated(raw: string[] | undefined): string[];
+export declare function parseJsonObject<T = unknown>(raw: string | undefined, flagName: string): T | undefined;
+export declare function resolveAndValidatePath(pathRaw: string, flagName: string): string;
+//# sourceMappingURL=parsing.d.ts.map

package/dist/lib/parsing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsing.d.ts","sourceRoot":"","sources":["../../src/lib/parsing.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EAAE,GAAG,SAAS,EACzB,QAAQ,SAAY,GACnB,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAoB5B;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,CAMvE;AAED,wBAAgB,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAQrG;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMhF"}

package/dist/lib/parsing.js

@@ -0,0 +1,57 @@
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+/**
+ * Parse `--input key=value` occurrences.
+ * - `true`/`false` become booleans
+ * - numeric-looking values become numbers
+ * - everything else stays a string
+ */
+export function parseKeyValueInputs(raw, flagName = "--input") {
+    const inputs = {};
+    for (const kv of raw ?? []) {
+        const eqIdx = kv.indexOf("=");
+        if (eqIdx === -1) {
+            throw new Error(`Invalid ${flagName} value "${kv}" (expected key=value).`);
+        }
+        const key = kv.slice(0, eqIdx).trim();
+        const valueRaw = kv.slice(eqIdx + 1);
+        if (!key) {
+            throw new Error(`Invalid ${flagName} value "${kv}" (missing key).`);
+        }
+        if (valueRaw === "true")
+            inputs[key] = true;
+        else if (valueRaw === "false")
+            inputs[key] = false;
+        else if (!isNaN(Number(valueRaw)) && valueRaw !== "")
+            inputs[key] = Number(valueRaw);
+        else
+            inputs[key] = valueRaw;
+    }
+    return inputs;
+}
+export function splitCommaSeparated(raw) {
+    const out = [];
+    for (const v of raw ?? []) {
+        out.push(...v.split(",").map((s) => s.trim()).filter(Boolean));
+    }
+    return out;
+}
+export function parseJsonObject(raw, flagName) {
+    if (!raw)
+        return undefined;
+    try {
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Invalid ${flagName}: ${msg}`);
+    }
+}
+export function resolveAndValidatePath(pathRaw, flagName) {
+    const p = resolve(pathRaw);
+    if (!existsSync(p)) {
+        throw new Error(`Invalid ${flagName}: file not found at ${p}`);
+    }
+    return p;
+}
+//# sourceMappingURL=parsing.js.map

package/dist/lib/parsing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsing.js","sourceRoot":"","sources":["../../src/lib/parsing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAyB,EACzB,QAAQ,GAAG,SAAS;IAEpB,MAAM,MAAM,GAA+B,EAAE,CAAC;IAC9C,KAAK,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,WAAW,QAAQ,WAAW,EAAE,yBAAyB,CAAC,CAAC;QAC7E,CAAC;QAED,MAAM,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,WAAW,QAAQ,WAAW,EAAE,kBAAkB,CAAC,CAAC;QACtE,CAAC;QAED,IAAI,QAAQ,KAAK,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;aACvC,IAAI,QAAQ,KAAK,OAAO;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;aAC9C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,QAAQ,KAAK,EAAE;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;;YAChF,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;IAC9B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAyB;IAC3D,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,GAAG,IAAI,EAAE,EAAE,CAAC;QAC1B,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,eAAe,CAAc,GAAuB,EAAE,QAAgB;IACpF,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,WAAW,QAAQ,KAAK,GAAG,EAAE,CAAC,CAAC;IACjD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAe,EAAE,QAAgB;IACtE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,WAAW,QAAQ,uBAAuB,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/lib/progress.d.ts

@@ -0,0 +1,4 @@
+import ora from "ora";
+import type { ProgressCallback } from "@executioncontrolprotocol/runtime";
+export declare function createProgressHandler(spinner: ReturnType<typeof ora>, contextPath: string, contextName: string): ProgressCallback;
+//# sourceMappingURL=progress.d.ts.map

package/dist/lib/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/lib/progress.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,KAAK,EAA0B,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAkBlG,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,UAAU,CAAC,OAAO,GAAG,CAAC,EAC/B,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,gBAAgB,CA4GlB"}

package/dist/lib/progress.js

@@ -0,0 +1,111 @@
+function phaseToLabel(status) {
+    const labels = {
+        loading: "Loading context...",
+        "hydrating-seed": "Hydrating seed mounts...",
+        "running-orchestrator": "Running orchestrator...",
+        delegating: "Delegating tasks...",
+        "hydrating-focus": "Hydrating focus mounts...",
+        "hydrating-deep": "Hydrating deep mounts...",
+        "running-specialist": "Running specialist...",
+        merging: "Merging outputs...",
+        completed: "Completed.",
+        failed: "Failed.",
+    };
+    return labels[status] ?? status;
+}
+export function createProgressHandler(spinner, contextPath, contextName) {
+    let currentText = "Starting...";
+    const completedSteps = [];
+    function redraw() {
+        const isTTY = process.stderr.isTTY;
+        if (isTTY) {
+            process.stderr.write("\x1b[2J\x1b[H");
+        }
+        process.stderr.write(`\n  Running: ${contextPath}\n`);
+        process.stderr.write(`  Context: ${contextName}\n\n`);
+        for (const s of completedSteps) {
+            process.stderr.write(`  Step ${s.step}: ${s.description} (${s.durationMs}ms)\n`);
+            if (s.model) {
+                process.stderr.write(`    Model: ${s.model}\n`);
+            }
+            if (s.tokens && s.tokens.total > 0) {
+                process.stderr.write(`    Tokens: ${s.tokens.prompt} prompt + ${s.tokens.completion} completion = ${s.tokens.total} total\n`);
+            }
+            if (s.output !== undefined) {
+                process.stderr.write(`    Output:\n`);
+                const json = JSON.stringify(s.output, null, 2);
+                for (const line of json.split(/\r?\n/)) {
+                    process.stderr.write(`      ${line}\n`);
+                }
+            }
+            process.stderr.write("\n");
+        }
+        spinner.start(currentText);
+    }
+    function appendLastStep() {
+        const s = completedSteps[completedSteps.length - 1];
+        if (!s)
+            return;
+        spinner.stopAndPersist({
+            text: `Step ${s.step}: ${s.description} (${s.durationMs}ms)`,
+        });
+        process.stderr.write(`    Model: ${s.model ?? "n/a"}\n`);
+        if (s.tokens && s.tokens.total > 0) {
+            process.stderr.write(`    Tokens: ${s.tokens.prompt} prompt + ${s.tokens.completion} completion = ${s.tokens.total} total\n`);
+        }
+        if (s.output !== undefined) {
+            process.stderr.write(`    Output:\n`);
+            const json = JSON.stringify(s.output, null, 2);
+            for (const line of json.split(/\r?\n/)) {
+                process.stderr.write(`      ${line}\n`);
+            }
+        }
+        process.stderr.write("\n");
+        spinner.start(currentText);
+    }
+    return async (event) => {
+        switch (event.type) {
+            case "phase":
+                currentText = phaseToLabel(event.status);
+                spinner.text = currentText;
+                break;
+            case "step_start":
+                currentText = event.description;
+                spinner.text = currentText;
+                break;
+            case "step_complete":
+                if (event.kind === "executor") {
+                    completedSteps.push({
+                        step: event.step,
+                        executorName: event.executorName ?? "",
+                        description: event.description,
+                        durationMs: event.durationMs,
+                        tokens: event.tokens,
+                        model: event.model,
+                        output: event.output,
+                    });
+                    spinner.stop();
+                    if (process.stderr.isTTY) {
+                        redraw();
+                    }
+                    else {
+                        appendLastStep();
+                    }
+                }
+                break;
+            case "executor_reasoning":
+                spinner.stop();
+                {
+                    const lines = event.reasoning.split(/\r?\n/);
+                    process.stderr.write(`\n  [${event.executorName}] Chain of thought:\n`);
+                    for (const line of lines) {
+                        process.stderr.write(`    ${line}\n`);
+                    }
+                    process.stderr.write("\n");
+                }
+                spinner.start(currentText);
+                break;
+        }
+    };
+}
+//# sourceMappingURL=progress.js.map

package/dist/lib/progress.js.map

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

package/dist/lib/trace-files.d.ts

@@ -0,0 +1,2 @@
+export declare function listTraceIds(traceDirRaw: string): Promise<string[]>;
+//# sourceMappingURL=trace-files.d.ts.map

package/dist/lib/trace-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-files.d.ts","sourceRoot":"","sources":["../../src/lib/trace-files.ts"],"names":[],"mappings":"AAIA,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAUzE"}

package/dist/lib/trace-files.js

@@ -0,0 +1,14 @@
+import { readdir } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+export async function listTraceIds(traceDirRaw) {
+    const traceDir = resolve(traceDirRaw);
+    if (!existsSync(traceDir))
+        return [];
+    const entries = await readdir(traceDir, { withFileTypes: true });
+    const ids = entries
+        .filter((e) => e.isFile() && e.name.endsWith(".json"))
+        .map((e) => e.name.slice(0, -".json".length));
+    return ids.sort();
+}
+//# sourceMappingURL=trace-files.js.map

package/dist/lib/trace-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-files.js","sourceRoot":"","sources":["../../src/lib/trace-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,WAAmB;IACpD,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACtC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IAErC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,MAAM,GAAG,GAAG,OAAO;SAChB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;SACrD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAEhD,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;AACpB,CAAC"}

package/dist/lib/trace-view.d.ts

@@ -0,0 +1,4 @@
+import type { ExecutionTrace } from "@executioncontrolprotocol/runtime";
+export type TraceOutputFormat = "text" | "graph";
+export declare function renderTraceView(trace: ExecutionTrace, output: TraceOutputFormat): Promise<string>;
+//# sourceMappingURL=trace-view.d.ts.map

package/dist/lib/trace-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-view.d.ts","sourceRoot":"","sources":["../../src/lib/trace-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAExE,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEjD,wBAAsB,eAAe,CACnC,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,MAAM,CAAC,CAMjB"}

package/dist/lib/trace-view.js

@@ -0,0 +1,8 @@
+export async function renderTraceView(trace, output) {
+    const runtime = await import("@executioncontrolprotocol/runtime");
+    if (output === "graph") {
+        return runtime.renderGraph(trace);
+    }
+    return runtime.formatTrace(trace);
+}
+//# sourceMappingURL=trace-view.js.map

package/dist/lib/trace-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-view.js","sourceRoot":"","sources":["../../src/lib/trace-view.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAqB,EACrB,MAAyB;IAEzB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,mCAAmC,CAAC,CAAC;IAClE,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACvB,OAAO,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC"}

package/package.json

@@ -1,28 +1,58 @@
 {
   "name": "@executioncontrolprotocol/cli",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "CLI for the ECP runtime engine — run Context manifests from the command line",
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/executioncontrolprotocol/executioncontrolprotocol",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/executioncontrolprotocol/executioncontrolprotocol.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/executioncontrolprotocol/executioncontrolprotocol/issues"
+  },
+  "keywords": [
+    "ecp",
+    "execution-control-protocol",
+    "mcp",
+    "model-context-protocol",
+    "agents",
+    "cli"
+  ],
   "private": false,
   "type": "module",
   "bin": {
-    "ecp": "./bin/ecp.cjs"
+    "ecp": "./bin/run.js"
   },
   "files": [
-    "bin/ecp.cjs",
-    "dist"
+    "bin/run.js",
+    "bin/run.cmd",
+    "bin/dev.js",
+    "bin/dev.cmd",
+    "dist",
+    "README.md"
   ],
   "scripts": {
     "build": "tsc -b",
-    "start": "tsx src/index.ts"
+    "start": "node ./bin/dev.js"
   },
   "dependencies": {
-    "@executioncontrolprotocol/runtime": "^0.3.0",
+    "@executioncontrolprotocol/runtime": "^0.4.0",
+    "@oclif/core": "^4.10.0",
     "ora": "^8.1.1"
   },
   "devDependencies": {
-    "@executioncontrolprotocol/spec": "^0.3.0",
+    "@executioncontrolprotocol/spec": "^0.4.0",
     "@types/node": "^25.3.3",
+    "ts-node": "^10.9.2",
     "tsx": "^4.0.0",
     "typescript": "^5.7.0"
+  },
+  "oclif": {
+    "bin": "ecp",
+    "commands": "./dist/commands",
+    "dirname": "ecp",
+    "topicSeparator": " "
   }
 }

package/bin/ecp.cjs

@@ -1,21 +0,0 @@
-#!/usr/bin/env node
-/**
- * Launcher so Windows npm bin shims always invoke Node (never open .ts in an editor).
- */
-const { spawnSync } = require("node:child_process");
-const path = require("node:path");
-const fs = require("node:fs");
-
-const entry = path.join(__dirname, "..", "dist", "index.js");
-if (!fs.existsSync(entry)) {
-  console.error(
-    "ecp: dist/index.js not found. Run from repo root: npm run build",
-  );
-  process.exit(1);
-}
-
-const r = spawnSync(process.execPath, [entry, ...process.argv.slice(2)], {
-  stdio: "inherit",
-  env: process.env,
-});
-process.exit(r.status === null ? 1 : r.status);

package/dist/index.d.ts

@@ -1,13 +0,0 @@
-/**
- * ECP CLI — run Context manifests from the command line.
- *
- * Usage:
- *   ecp run <context.yaml> [--input key=value ...] [--debug] [--model <model>] [--trace]
- *   ecp validate <context.yaml>
- *   ecp trace <run_id>
- *   ecp graph <run_id>
- *
- * @category CLI
- */
-export {};
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}