@executioncontrolprotocol/cli 0.3.0 → 0.4.2

package/dist/commands/config.js

@@ -0,0 +1,43 @@
+import { Command } from "@oclif/core";
+import { OS_PROVIDER_ID } from "../lib/secret-provider-ids.js";
+export default class Config extends Command {
+    static summary = "Manage ECP system configuration";
+    static description = `Inspect and edit system config (project ecp.config.* or global ~/.ecp/).
+
+v0.5 layout: policy under top-level security (mirrors models, tools, loggers, …); wiring under models.providers, tools.servers, loggers.config, agents.endpoints, plugins.installs, secrets.
+
+Subcommands: security, plugins (installs + deprecated allow paths), models, tools, loggers, secrets (store ops + yaml *), endpoints (agents.endpoints).
+You can also edit the file directly — use "ecp config path" for the resolved path.`;
+    static examples = [
+        "ecp config init",
+        "ecp config init --global",
+        "ecp config get",
+        "ecp config path --global",
+        "ecp config plugins get",
+        "ecp config models allow add ollama llama3.2:3b",
+        "ecp config tools add fetch --json '{\"transport\":{\"type\":\"stdio\",\"command\":\"docker\",\"args\":[\"run\",\"-i\",\"--rm\",\"mcp/fetch\"]}}'",
+        `ecp config secrets add --provider ${OS_PROVIDER_ID} --key server/fetch.token --prompt`,
+        "ecp config secrets providers doctor",
+    ];
+    async run() {
+        await this.parse(Config);
+        this.log([
+            "Usage: ecp config <subcommand>",
+            "",
+            "  init              Write best-practices default if missing",
+            "  path              Print config file path",
+            "  get               Print merged config (YAML or JSON)",
+            "  security          Dump security.* (policy mirror)",
+            "  plugins           installs list/add/remove; legacy allow → security.models",
+            "  models            CRUD for models.providers",
+            "  tools             CRUD for tools.servers",
+            "  loggers           security.loggers + loggers.config",
+            `  secrets           Store ops + yaml get/set-default-provider/set-policy`,
+            "  endpoints         CRUD for agents.endpoints (A2A URLs)",
+            "",
+            "Resource commands use verbs: add, get, remove, update (see ecp config <topic> --help).",
+            "Run ecp config --help for flags and full help.",
+        ].join("\n"));
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,OAAO;IACzC,MAAM,CAAC,OAAO,GAAG,iCAAiC,CAAC;IAEnD,MAAM,CAAC,WAAW,GAAG;;;;;mFAK4D,CAAC;IAElF,MAAM,CAAC,QAAQ,GAAG;QAChB,iBAAiB;QACjB,0BAA0B;QAC1B,gBAAgB;QAChB,0BAA0B;QAC1B,wBAAwB;QACxB,gDAAgD;QAChD,kJAAkJ;QAClJ,qCAAqC,cAAc,oCAAoC;QACvF,qCAAqC;KACtC,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACzB,IAAI,CAAC,GAAG,CACN;YACE,gCAAgC;YAChC,EAAE;YACF,6DAA6D;YAC7D,4CAA4C;YAC5C,wDAAwD;YACxD,qDAAqD;YACrD,8EAA8E;YAC9E,+CAA+C;YAC/C,4CAA4C;YAC5C,uDAAuD;YACvD,0EAA0E;YAC1E,0DAA0D;YAC1D,EAAE;YACF,wFAAwF;YACxF,gDAAgD;SACjD,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACJ,CAAC"}

package/dist/commands/graph.d.ts

@@ -0,0 +1,14 @@
+import { EcpEnvironmentCommand } from "../lib/ecp-environment-command.js";
+export default class Graph extends EcpEnvironmentCommand {
+    static summary: string;
+    static hidden: boolean;
+    static flags: {
+        "trace-dir": import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        environment: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    static args: {
+        runId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=graph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/commands/graph.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,qBAAqB;IACtD,MAAM,CAAC,OAAO,SAA6B;IAE3C,MAAM,CAAC,MAAM,UAAQ;IAErB,MAAM,CAAC,KAAK;;;MAMV;IAEF,MAAM,CAAC,IAAI;;MAKT;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAoB3B"}

package/dist/commands/graph.js

@@ -0,0 +1,39 @@
+import { Flags, Args } from "@oclif/core";
+import { readFileSync, existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { renderTraceView } from "../lib/trace-view.js";
+import { getDefaultTraceDir } from "../lib/ecp-home.js";
+import { EcpEnvironmentCommand } from "../lib/ecp-environment-command.js";
+export default class Graph extends EcpEnvironmentCommand {
+    static summary = "Display execution graph";
+    // Backwards-compatible alias for `ecp trace --output graph`.
+    static hidden = true;
+    static flags = {
+        ...EcpEnvironmentCommand.flags,
+        "trace-dir": Flags.string({
+            description: "Directory for trace files",
+            default: getDefaultTraceDir(),
+        }),
+    };
+    static args = {
+        runId: Args.string({
+            required: true,
+            description: "run id (e.g. run-123...)",
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Graph);
+        this.applyEnvironmentFlag(flags);
+        const runId = args.runId;
+        const traceDir = flags["trace-dir"];
+        const filePath = resolve(traceDir, `${runId}.json`);
+        if (!existsSync(filePath)) {
+            this.error(`\n  Trace not found: ${filePath}\n  Run ` +
+                `ecp run <context.yaml> (tracing is enabled by default; use --no-trace to disable)\n`, { exit: 1 });
+        }
+        const trace = JSON.parse(readFileSync(filePath, "utf-8"));
+        const rendered = await renderTraceView(trace, "graph");
+        console.log(rendered);
+    }
+}
+//# sourceMappingURL=graph.js.map

package/dist/commands/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../src/commands/graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAE,eAAe,EAA0B,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,qBAAqB;IACtD,MAAM,CAAC,OAAO,GAAG,yBAAyB,CAAC;IAC3C,6DAA6D;IAC7D,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC;IAErB,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,qBAAqB,CAAC,KAAK;QAC9B,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC;YACxB,WAAW,EAAE,2BAA2B;YACxC,OAAO,EAAE,kBAAkB,EAAE;SAC9B,CAAC;KACH,CAAC;IAEF,MAAM,CAAC,IAAI,GAAG;QACZ,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC;YACjB,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,0BAA0B;SACxC,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAChD,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QAEzB,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC;QAEpD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,KAAK,CACR,wBAAwB,QAAQ,UAAU;gBACxC,qFAAqF,EACvF,EAAE,IAAI,EAAE,CAAC,EAAE,CACZ,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAmB,CAAC;QAC5E,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,KAAK,EAAE,OAA4B,CAAC,CAAC;QAC5E,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxB,CAAC"}

package/dist/commands/run.d.ts

@@ -0,0 +1,23 @@
+import { EcpEnvironmentCommand } from "../lib/ecp-environment-command.js";
+export default class Run extends EcpEnvironmentCommand {
+    static summary: string;
+    static flags: {
+        input: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        model: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        provider: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        config: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        trace: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "trace-dir": import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        logger: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        debug: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        environment: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    static args: {
+        contextPath: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+    private createModelProviderOrFail;
+    private assertProviderAllowedByPolicy;
+    private assertModelAllowedByPolicy;
+}
+//# sourceMappingURL=run.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AAsCA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AA+C1E,MAAM,CAAC,OAAO,OAAO,GAAI,SAAQ,qBAAqB;IACpD,MAAM,CAAC,OAAO,SAAgC;IAE9C,MAAM,CAAC,KAAK;;;;;;;;;;MA4CV;IAEF,MAAM,CAAC,IAAI;;MAKT;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IA2Q1B,OAAO,CAAC,yBAAyB;IAmBjC,OAAO,CAAC,6BAA6B;IAsBrC,OAAO,CAAC,0BAA0B;CAenC"}

package/dist/commands/run.js

@@ -0,0 +1,363 @@
+import { Flags, Args } from "@oclif/core";
+import { resolve } from "node:path";
+import ora from "ora";
+import { BUILTIN_PLUGIN_VERSION, createDefaultSecretBroker, ECPEngine, loadContext, resolveInputs, resolveSystemConfig, MCPToolInvoker, A2AAgentTransport, ExtensionRegistry, registerBuiltinModelProviders, registerBuiltinLoggers, registerBuiltinPlugins, TraceCollector, ConsoleTraceExporter, JsonFileTraceExporter, getSecurityConfig, resolveAgentEndpointsMap, } from "@executioncontrolprotocol/runtime";
+import { getContextPlugins } from "@executioncontrolprotocol/spec";
+import { commandErrorMessage } from "../lib/command-helpers.js";
+import { parseKeyValueInputs, splitCommaSeparated } from "../lib/parsing.js";
+import { createProgressHandler } from "../lib/progress.js";
+import { getDefaultTraceDir } from "../lib/ecp-home.js";
+import { EcpEnvironmentCommand } from "../lib/ecp-environment-command.js";
+import { resolveDotenvPathFromConfig, resolveSecretPolicyFromConfig } from "../lib/secrets-config.js";
+function contextHasMemory(context) {
+    const visit = (orchestrator) => {
+        if (orchestrator.memory)
+            return true;
+        for (const executor of orchestrator.executors ?? []) {
+            if (executor.memory)
+                return true;
+        }
+        for (const child of orchestrator.orchestrators ?? []) {
+            if (visit(child))
+                return true;
+        }
+        return false;
+    };
+    if (context.orchestrator && visit(context.orchestrator))
+        return true;
+    return (context.executors ?? []).some((e) => e.memory != null);
+}
+function inferModelProviderFromContext(context) {
+    const providers = new Set();
+    const visitExecutor = (executor) => {
+        const providerName = executor.model?.provider?.name;
+        if (providerName)
+            providers.add(providerName);
+    };
+    const visitOrchestrator = (orchestrator) => {
+        for (const executor of orchestrator.executors ?? []) {
+            visitExecutor(executor);
+        }
+        for (const child of orchestrator.orchestrators ?? []) {
+            visitOrchestrator(child);
+        }
+    };
+    if (context.orchestrator)
+        visitOrchestrator(context.orchestrator);
+    for (const executor of context.executors ?? []) {
+        visitExecutor(executor);
+    }
+    if (providers.size === 1)
+        return [...providers][0];
+    if (providers.size === 0)
+        return undefined;
+    throw new Error(`Context declares multiple model providers (${[...providers].join(", ")}). Please pass --provider.`);
+}
+export default class Run extends EcpEnvironmentCommand {
+    static summary = "Execute a Context manifest";
+    static flags = {
+        ...EcpEnvironmentCommand.flags,
+        input: Flags.string({
+            char: "i",
+            multiple: true,
+            description: "Set an input value (repeatable, key=value)",
+            summary: "Input value (key=value)",
+        }),
+        model: Flags.string({
+            char: "m",
+            description: "Override model name (must be allowed by system config policy)",
+        }),
+        provider: Flags.string({
+            char: "p",
+            description: "Override provider (must be allowed by system config policy)",
+            options: ["openai", "ollama"],
+        }),
+        config: Flags.string({
+            char: "c",
+            description: "Path to system config (YAML/JSON). Default: ./ecp.config.yaml, ./ecp.config.json, then ~/.ecp/ (see ecp config path)",
+            default: "",
+        }),
+        trace: Flags.boolean({
+            char: "t",
+            description: "Enable tracing (saves to the user traces directory by default)",
+            default: true,
+            allowNo: true,
+        }),
+        "trace-dir": Flags.string({
+            description: "Directory for trace files",
+            default: getDefaultTraceDir(),
+        }),
+        logger: Flags.string({
+            char: "l",
+            multiple: true,
+            multipleNonGreedy: true,
+            description: "Enable a logger plugin (e.g. file). Repeatable or comma-separated.",
+        }),
+        debug: Flags.boolean({
+            char: "d",
+            description: "Enable debug logging",
+            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(Run);
+        this.applyEnvironmentFlag(flags);
+        const contextPath = resolve(args.contextPath);
+        const inputs = (() => {
+            try {
+                return parseKeyValueInputs(flags.input, "--input");
+            }
+            catch (err) {
+                this.error(commandErrorMessage(err), { exit: 1 });
+            }
+        })();
+        const cwd = process.cwd();
+        const systemConfig = (() => {
+            try {
+                return resolveSystemConfig(flags.config ? flags.config : undefined, cwd);
+            }
+            catch (err) {
+                this.error(commandErrorMessage(err), { exit: 1 });
+            }
+        })();
+        const loggerRaw = splitCommaSeparated(flags.logger);
+        const context = loadContext(contextPath);
+        let providerToUse;
+        try {
+            providerToUse = flags.provider ?? inferModelProviderFromContext(context);
+        }
+        catch (err) {
+            this.error(commandErrorMessage(err), { exit: 1 });
+        }
+        if (!providerToUse) {
+            this.error('Model provider could not be inferred from the Context. Pass --provider openai|ollama.', { exit: 1 });
+        }
+        this.assertProviderAllowedByPolicy(providerToUse, systemConfig);
+        const selectedModel = flags.model;
+        if (selectedModel) {
+            this.assertModelAllowedByPolicy(providerToUse, selectedModel, systemConfig);
+        }
+        const secModels = getSecurityConfig(systemConfig)?.models;
+        const enableFromConfig = secModels?.defaultProviders ?? [];
+        const enableForRun = [...new Set([...enableFromConfig, providerToUse])];
+        const allowProviders = secModels?.allowProviders;
+        if (allowProviders && allowProviders.length > 0) {
+            for (const id of enableForRun) {
+                if (!allowProviders.includes(id)) {
+                    this.error(`Provider "${id}" cannot be used because it is not in system config security.models.allowProviders.\n` +
+                        `Allowed: ${allowProviders.join(", ")}\n` +
+                        `Update your config first (ecp.config.yaml / ecp config) and rerun.`, { exit: 1 });
+                }
+            }
+        }
+        const dotenvPath = this.effectiveDotenvPath ?? resolveDotenvPathFromConfig(cwd, systemConfig);
+        const { broker: secretBroker } = createDefaultSecretBroker({
+            policy: resolveSecretPolicyFromConfig(systemConfig),
+            dotenvPath,
+            cwd,
+        });
+        const registry = new ExtensionRegistry();
+        const providers = systemConfig?.models?.providers ?? {};
+        const openaiDefaults = providers.openai ?? {};
+        const ollamaDefaults = providers.ollama ?? {};
+        const ollamaBaseURL = typeof ollamaDefaults.config?.baseURL === "string"
+            ? ollamaDefaults.config.baseURL
+            : undefined;
+        registerBuiltinModelProviders(registry, {
+            version: BUILTIN_PLUGIN_VERSION,
+            openai: { defaultModel: selectedModel ?? openaiDefaults.defaultModel },
+            ollama: {
+                baseURL: ollamaBaseURL,
+                defaultModel: selectedModel ?? ollamaDefaults.defaultModel,
+            },
+        });
+        registerBuiltinLoggers(registry, { version: BUILTIN_PLUGIN_VERSION, file: {} });
+        registerBuiltinPlugins(registry, { version: BUILTIN_PLUGIN_VERSION });
+        registry.lock();
+        const modelProvider = this.createModelProviderOrFail(registry, providerToUse);
+        const toolInvoker = new MCPToolInvoker();
+        const agentTransport = new A2AAgentTransport();
+        const toolServers = systemConfig?.tools?.servers;
+        const mcpServerAllowList = getSecurityConfig(systemConfig)?.tools?.allowServers;
+        if (ollamaBaseURL) {
+            try {
+                new URL(ollamaBaseURL);
+            }
+            catch {
+                this.error(`Invalid models.providers.ollama.config.baseURL in system config: "${ollamaBaseURL}"`, { exit: 1 });
+            }
+        }
+        const loggerCallbacks = [];
+        const loggersConfig = systemConfig?.loggers;
+        const secLoggers = getSecurityConfig(systemConfig)?.loggers;
+        const loggersEnabled = loggerRaw.length > 0 ? loggerRaw : secLoggers?.defaultEnable ?? [];
+        const loggersAllow = secLoggers?.allowEnable;
+        if (loggersAllow && loggersAllow.length > 0) {
+            for (const id of loggersEnabled) {
+                if (!loggersAllow.includes(id)) {
+                    this.error(`Logger "${id}" is not in system config security.loggers.allowEnable. Allowed: ${loggersAllow.join(", ")}`, { exit: 1 });
+                }
+            }
+        }
+        for (const id of loggersEnabled) {
+            try {
+                const cb = registry.createLogger(id, loggersConfig?.config?.[id]);
+                loggerCallbacks.push(cb);
+            }
+            catch (err) {
+                this.error(`Failed to create logger "${id}": ${commandErrorMessage(err)}`, { exit: 1 });
+            }
+        }
+        const spinner = flags.debug ? undefined : ora({ stream: process.stderr }).start("Loading context...");
+        const builtInProgress = spinner
+            ? createProgressHandler(spinner, contextPath, context.metadata.name)
+            : undefined;
+        const onProgress = builtInProgress && loggerCallbacks.length > 0
+            ? [builtInProgress, ...loggerCallbacks]
+            : builtInProgress ?? (loggerCallbacks.length > 0 ? loggerCallbacks : undefined);
+        if (flags.debug) {
+            console.log(`\n  Running: ${contextPath}\n`);
+        }
+        // Keep memory-store lifecycle in the CLI so we can close it after a run.
+        let memoryStore;
+        if (contextHasMemory(context)) {
+            const pluginReg = registry.listPlugins().find((p) => p.id === "memory");
+            if (pluginReg) {
+                try {
+                    const instance = pluginReg.create(getContextPlugins(context)?.config?.memory);
+                    memoryStore = await instance.open();
+                }
+                catch (err) {
+                    if (flags.debug) {
+                        console.error(`  Memory plugin open failed: ${commandErrorMessage(err)}\n`);
+                    }
+                }
+            }
+        }
+        const agentEndpoints = resolveAgentEndpointsMap(systemConfig);
+        const agentEndpointsForEngine = Object.keys(agentEndpoints).length > 0 ? agentEndpoints : undefined;
+        const engine = new ECPEngine(modelProvider, toolInvoker, agentTransport, {
+            toolServers,
+            mcpServerAllowList,
+            secretBroker,
+            agentEndpoints: agentEndpointsForEngine,
+            defaultModel: selectedModel ?? openaiDefaults.defaultModel ?? ollamaDefaults.defaultModel,
+            modelOverride: selectedModel,
+            debug: flags.debug,
+            trace: flags.trace,
+            memoryStore,
+            onProgress,
+            plugins: {
+                registry,
+                enable: enableForRun,
+                allowEnable: secModels?.allowProviders,
+                security: getSecurityConfig(systemConfig)?.plugins ?? getContextPlugins(context)?.security,
+            },
+        });
+        if (flags.trace) {
+            const collector = new TraceCollector();
+            collector.addExporters(new ConsoleTraceExporter(), new JsonFileTraceExporter({ outputDir: flags["trace-dir"] }));
+            engine.setTraceCollector(collector);
+        }
+        let resolvedInputs;
+        try {
+            resolvedInputs = resolveInputs(context, inputs);
+        }
+        catch (err) {
+            const msg = commandErrorMessage(err);
+            const missing = msg.match(/^Missing required input: "([^"]+)"$/);
+            if (missing) {
+                const inputName = missing[1];
+                this.error(`\n  Error: Missing required input "${inputName}" defined in the Context manifest.\n` +
+                    `  Provide it via --input ${inputName}=<value> (e.g. -i ${inputName}="...").\n`, { exit: 1 });
+            }
+            throw err;
+        }
+        const result = await engine.run({ context, inputs: resolvedInputs });
+        if (memoryStore && typeof memoryStore.close === "function") {
+            await memoryStore.close();
+        }
+        if (spinner) {
+            if (result.success)
+                spinner.succeed("Execution completed.");
+            else
+                spinner.fail("Execution failed.");
+        }
+        console.log("\n--- Execution Result ---");
+        console.log(`  Run ID:     ${result.runId}`);
+        console.log(`  Context:    ${result.contextName} v${result.contextVersion}`);
+        console.log(`  Success:    ${result.success}`);
+        console.log(`  Duration:   ${result.durationMs}ms`);
+        console.log(`  Tool calls: ${result.totalBudgetUsage.toolCalls}`);
+        if (result.error) {
+            console.log(`  Error:      ${result.error}`);
+        }
+        if (result.output) {
+            console.log("\n--- Output ---");
+            console.log(JSON.stringify(result.output, null, 2));
+        }
+        if (!spinner) {
+            console.log("\n--- Executor Outputs ---");
+            for (const [name, output] of Object.entries(result.executorOutputs)) {
+                console.log(`\n  [${name}]`);
+                console.log(JSON.stringify(output, null, 2));
+            }
+        }
+        if (flags.debug) {
+            console.log("\n--- Execution Log ---");
+            for (const entry of result.log) {
+                console.log(`  [${entry.level.toUpperCase().padEnd(5)}] ${entry.message}`);
+            }
+        }
+        if (flags.trace) {
+            console.log(`\n  Trace saved to: ${flags["trace-dir"]}/${result.runId}.json`);
+            console.log(`  View with: ecp trace ${result.runId}`);
+            console.log(`  Graph with: ecp trace --output graph ${result.runId}`);
+        }
+        this.exit(result.success ? 0 : 1);
+    }
+    createModelProviderOrFail(registry, providerId) {
+        const registration = registry.getModelProviderRegistration(providerId);
+        if (!registration) {
+            const known = registry.listModelProviders().map((p) => p.id).join(", ");
+            this.error(`Unknown provider "${providerId}". Registered providers: ${known}`, { exit: 1 });
+        }
+        try {
+            return registry.createModelProvider(providerId);
+        }
+        catch (err) {
+            const rawMsg = commandErrorMessage(err);
+            const hint = err && typeof err === "object" && "hint" in err ? err.hint : undefined;
+            this.error(`${rawMsg}${hint ? `\n${hint}` : ""}`, { exit: 1 });
+        }
+    }
+    assertProviderAllowedByPolicy(providerId, systemConfig) {
+        const allowProviders = getSecurityConfig(systemConfig)?.models?.allowProviders;
+        if (allowProviders?.length && !allowProviders.includes(providerId)) {
+            this.error(`Provider "${providerId}" is blocked by system config security.models.allowProviders.\n` +
+                `Allowed: ${allowProviders.join(", ")}\n` +
+                `Update your config first (ecp.config.yaml / ecp config) and rerun.`, { exit: 1 });
+        }
+        const allowIds = getSecurityConfig(systemConfig)?.plugins?.allowIds;
+        if (allowIds?.length && !allowIds.includes(providerId)) {
+            this.error(`Provider "${providerId}" is blocked by system config security.plugins.allowIds.\n` +
+                `Allowed IDs: ${allowIds.join(", ")}\n` +
+                `Update your config first (ecp.config.yaml / ecp config) and rerun.`, { exit: 1 });
+        }
+    }
+    assertModelAllowedByPolicy(providerId, modelName, systemConfig) {
+        const allowedModels = systemConfig?.models?.providers?.[providerId]?.allowedModels;
+        if (allowedModels?.length && !allowedModels.includes(modelName)) {
+            this.error(`Model "${modelName}" is blocked for provider "${providerId}" by system config models.providers.${providerId}.allowedModels.\n` +
+                `Allowed models: ${allowedModels.join(", ")}\n` +
+                `Update your config first (ecp.config.yaml / ecp config) and rerun.`, { exit: 1 });
+        }
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

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

package/dist/commands/trace/list.d.ts

@@ -0,0 +1,10 @@
+import { EcpEnvironmentCommand } from "../../lib/ecp-environment-command.js";
+export default class TraceList extends EcpEnvironmentCommand {
+    static summary: string;
+    static flags: {
+        "trace-dir": import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        environment: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/trace/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/trace/list.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAE7E,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,qBAAqB;IAC1D,MAAM,CAAC,OAAO,SAAmC;IAEjD,MAAM,CAAC,KAAK;;;MAMV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAkB3B"}

package/dist/commands/trace/list.js

@@ -0,0 +1,32 @@
+import { Flags } from "@oclif/core";
+import { runWithCommandError } from "../../lib/command-helpers.js";
+import { listTraceIds } from "../../lib/trace-files.js";
+import { getDefaultTraceDir } from "../../lib/ecp-home.js";
+import { EcpEnvironmentCommand } from "../../lib/ecp-environment-command.js";
+export default class TraceList extends EcpEnvironmentCommand {
+    static summary = "List locally available traces";
+    static flags = {
+        ...EcpEnvironmentCommand.flags,
+        "trace-dir": Flags.string({
+            description: "Directory for trace files",
+            default: getDefaultTraceDir(),
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(TraceList);
+        this.applyEnvironmentFlag(flags);
+        const traceDir = flags["trace-dir"];
+        await runWithCommandError(this, async () => {
+            const ids = await listTraceIds(traceDir);
+            if (ids.length === 0) {
+                console.log(`No trace files found in ${traceDir}.`);
+                return;
+            }
+            console.log(`Available traces in ${traceDir}:`);
+            for (const id of ids) {
+                console.log(`- ${id}`);
+            }
+        });
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/trace/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/trace/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAE7E,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,qBAAqB;IAC1D,MAAM,CAAC,OAAO,GAAG,+BAA+B,CAAC;IAEjD,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,qBAAqB,CAAC,KAAK;QAC9B,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC;YACxB,WAAW,EAAE,2BAA2B;YACxC,OAAO,EAAE,kBAAkB,EAAE;SAC9B,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;QAEpC,MAAM,mBAAmB,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;YACzC,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;YACzC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACrB,OAAO,CAAC,GAAG,CAAC,2BAA2B,QAAQ,GAAG,CAAC,CAAC;gBACpD,OAAO;YACT,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,uBAAuB,QAAQ,GAAG,CAAC,CAAC;YAChD,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;gBACrB,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACzB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC"}

package/dist/commands/trace.d.ts

@@ -0,0 +1,14 @@
+import { EcpEnvironmentCommand } from "../lib/ecp-environment-command.js";
+export default class Trace extends EcpEnvironmentCommand {
+    static summary: string;
+    static flags: {
+        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        "trace-dir": import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        environment: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    static args: {
+        runId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=trace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/commands/trace.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,qBAAqB;IACtD,MAAM,CAAC,OAAO,SAA6B;IAE3C,MAAM,CAAC,KAAK;;;;MAWV;IAEF,MAAM,CAAC,IAAI;;MAKT;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAqB3B"}

package/dist/commands/trace.js

@@ -0,0 +1,43 @@
+import { Flags, Args } from "@oclif/core";
+import { readFileSync, existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { renderTraceView } from "../lib/trace-view.js";
+import { getDefaultTraceDir } from "../lib/ecp-home.js";
+import { EcpEnvironmentCommand } from "../lib/ecp-environment-command.js";
+export default class Trace extends EcpEnvironmentCommand {
+    static summary = "Display execution trace";
+    static flags = {
+        ...EcpEnvironmentCommand.flags,
+        output: Flags.string({
+            description: "Render mode: 'text' (human log) or 'graph' (ASCII visualization)",
+            options: ["text", "graph"],
+            default: "text",
+        }),
+        "trace-dir": Flags.string({
+            description: "Directory for trace files",
+            default: getDefaultTraceDir(),
+        }),
+    };
+    static args = {
+        runId: Args.string({
+            required: true,
+            description: "run id (e.g. run-123...)",
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Trace);
+        this.applyEnvironmentFlag(flags);
+        const runId = args.runId;
+        const output = flags.output;
+        const traceDir = flags["trace-dir"];
+        const filePath = resolve(traceDir, `${runId}.json`);
+        if (!existsSync(filePath)) {
+            this.error(`\n  Trace not found: ${filePath}\n  Run ` +
+                `ecp run <context.yaml> (tracing is enabled by default; use --no-trace to disable)\n`, { exit: 1 });
+        }
+        const trace = JSON.parse(readFileSync(filePath, "utf-8"));
+        const rendered = await renderTraceView(trace, output);
+        console.log(rendered);
+    }
+}
+//# sourceMappingURL=trace.js.map