@executioncontrolprotocol/cli 0.10.0 → 0.11.0

package/README.md

@@ -9,6 +9,9 @@ This CLI is how you run ECP deterministically in a Node.js / TypeScript ecosyste
 - Validate workflows against an environment’s registered capabilities
 - Describe/search environment capabilities for agent/UI discovery
 - Run workflows and print structured run results
+- Invoke a single capability outside a workflow (`ecp invoke`)
+- Serve an environment over loopback HTTP for `POST /v1/invoke` (`ecp serve`)
+- Test workflows with a persistent session (`ecp test start|run|rerun|status`)
 - Encode/decode workflows using format extensions (TOON, Fluent, JSON)
 
 For the architecture and monorepo package boundaries, start with
@@ -74,6 +77,64 @@ ecp describe --env examples/01-echo/environment.ts
 ecp search "echo" --env examples/01-echo/environment.ts
 ```
 
+### Test session (`ecp test`)
+
+Drive a workflow incrementally with frozen state (distinct from `@executioncontrolprotocol/core/testing` stubs):
+
+```sh
+ecp test start workflow.ts --env environment.ts -o session.json
+ecp test run --to step-b --env environment.ts --session session.json
+ecp test rerun step-a --env environment.ts --session session.json
+ecp test status --session session.json
+```
+
+- `run --to <step-id>` is **inclusive** (runs through that step, then pauses).
+- `rerun <step-id>` re-executes one step and **clears** downstream history and `.as` state keys.
+- Session file schema: `@executioncontrolprotocol.test.session`.
+
+Fluent API: `ecp.test(workflow).with({ input }).start()` then `session.runTo(id)` / `session.rerun(id)`.
+
+### Invoke a capability
+
+Call a single bound capability without a workflow:
+
+```sh
+ecp invoke @executioncontrolprotocol/test.echo --env examples/01-echo/environment.ts --input input.json
+```
+
+Optional `--uses <provider-capability-id>` overrides the harness default provider. Prints an `InvokeResult` JSON document; exits non-zero when `success` is false.
+
+### Serve (`ecp serve`)
+
+Expose any `--env` over loopback HTTP (no auth; loopback-only trust):
+
+```sh
+ecp serve --env examples/01-echo/environment.ts
+ecp serve --env environment.ts --port 3090 --cors-origin http://localhost:5173
+```
+
+- `GET /health` — `{ ok, version }`
+- `POST /v1/invoke` — body `{ capability, input?, provider? }` → `ecp.invoke(...).with(...).process()`
+
+Default port **3090** (ECP leet), host `127.0.0.1`.
+
+### Local daemon (`ecp up`)
+
+Ollama/PNA **demo bridge** (fixed local env, not arbitrary `--env`). Prefer `ecp serve` for general HTTP invoke. Start the daemon, then open the demo with a pairing token:
+
+```sh
+ecp up
+# Opens https://executioncontrolprotocol.github.io/browser-demo/?token=<uuid>&bridge=http://127.0.0.1:3090
+
+ecp up --open-url http://localhost:5173/
+ecp up --no-open
+```
+
+- `GET /health` — `{ ok, version, ollamaReachable }` (no auth; used by the demo to enable Ollama)
+- `POST /v1/invoke` — Bearer token required; same body shape as `ecp serve`
+
+Default port **3090**. The demo reads `?token=` (and optional `?bridge=`) automatically. Hosted HTTPS demos need **Chromium** (Chrome/Edge) for Private Network Access. Add extra page origins with `--cors-origin`.
+
 ### Encode / decode formats
 
 Encoding and decoding uses **format extensions** bound in your environment.

package/dist/commands/invoke.d.ts

@@ -0,0 +1,17 @@
+import { EnvModuleCommand } from "../lib/env-module-command.js";
+/** Invoke a single capability outside a workflow run. */
+export default class Invoke extends EnvModuleCommand {
+    static summary: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        "capability-id": import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        input: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        uses: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        env: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=invoke.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../../src/commands/invoke.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAE/D,yDAAyD;AACzD,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,gBAAgB;IAClD,MAAM,CAAC,OAAO,SAAwB;IAEtC,MAAM,CAAC,WAAW,SAEmD;IAErE,MAAM,CAAC,QAAQ,WAGd;IAED,MAAM,CAAC,IAAI;;MAKV;IAED,MAAM,CAAC,KAAK;;;;MAQX;IAEK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAiB3B"}

package/dist/commands/invoke.js

@@ -0,0 +1,47 @@
+import { Args, Flags } from "@oclif/core";
+import { readJsonFile, runWithCommandError } from "../lib/command-helpers.js";
+import { EnvModuleCommand } from "../lib/env-module-command.js";
+/** Invoke a single capability outside a workflow run. */
+export default class Invoke extends EnvModuleCommand {
+    static summary = "Invoke a capability";
+    static description = "Call a registered capability by id using the runtime and extensions from --env, " +
+        "without running a workflow. Prints an InvokeResult JSON document.";
+    static examples = [
+        "<%= config.bin %> <%= command.id %> @executioncontrolprotocol/test.echo --env examples/01-echo/environment.ts --input input.json",
+        "<%= config.bin %> <%= command.id %> @executioncontrolprotocol/harness-browser-nano.evaluate --env environment.ts --input in.json --uses @executioncontrolprotocol/ollama.generate",
+    ];
+    static args = {
+        "capability-id": Args.string({
+            required: true,
+            description: "Capability id to invoke (e.g. @executioncontrolprotocol/test.echo)",
+        }),
+    };
+    static flags = {
+        ...EnvModuleCommand.flags,
+        input: Flags.string({
+            description: "Path to JSON file with capability input object",
+        }),
+        uses: Flags.string({
+            description: "Optional provider capability override (harness .uses)",
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Invoke);
+        let result;
+        await runWithCommandError(this, async () => {
+            const input = flags.input
+                ? await readJsonFile(flags.input, "--input")
+                : {};
+            const ecp = await this.loadEcp(flags);
+            let builder = ecp.invoke(args["capability-id"]).with(input);
+            if (flags.uses)
+                builder = builder.uses(flags.uses);
+            result = await builder.process();
+            this.log(JSON.stringify(result, null, 2));
+        });
+        if (result !== undefined && !result.success) {
+            this.error("Capability invoke did not succeed", { exit: 1 });
+        }
+    }
+}
+//# sourceMappingURL=invoke.js.map

package/dist/commands/invoke.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke.js","sourceRoot":"","sources":["../../src/commands/invoke.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAE/D,yDAAyD;AACzD,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,gBAAgB;IAClD,MAAM,CAAC,OAAO,GAAG,qBAAqB,CAAA;IAEtC,MAAM,CAAC,WAAW,GAChB,kFAAkF;QAClF,mEAAmE,CAAA;IAErE,MAAM,CAAC,QAAQ,GAAG;QAChB,kIAAkI;QAClI,mLAAmL;KACpL,CAAA;IAED,MAAM,CAAC,IAAI,GAAG;QACZ,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC;YAC3B,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,oEAAoE;SAClF,CAAC;KACH,CAAA;IAED,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,gBAAgB,CAAC,KAAK;QACzB,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC;YAClB,WAAW,EAAE,gDAAgD;SAC9D,CAAC;QACF,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;YACjB,WAAW,EAAE,uDAAuD;SACrE,CAAC;KACH,CAAA;IAED,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QAChD,IAAI,MAAgC,CAAA;QACpC,MAAM,mBAAmB,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;YACzC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK;gBACvB,CAAC,CAAC,MAAM,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC;gBAC5C,CAAC,CAAC,EAAE,CAAA;YACN,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;YACrC,IAAI,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YAC3D,IAAI,KAAK,CAAC,IAAI;gBAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YAClD,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAA;YAChC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QAC3C,CAAC,CAAC,CAAA;QACF,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC5C,IAAI,CAAC,KAAK,CAAC,mCAAmC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAA;QAC9D,CAAC;IACH,CAAC"}

package/dist/commands/serve.d.ts

@@ -0,0 +1,15 @@
+import { EnvModuleCommand } from "../lib/env-module-command.js";
+/** Serve an environment over loopback HTTP for capability invoke. */
+export default class Serve extends EnvModuleCommand {
+    static summary: string;
+    static description: string;
+    static examples: string[];
+    static flags: {
+        port: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        host: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        "cors-origin": import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
+        env: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=serve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAE/D,qEAAqE;AACrE,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,gBAAgB;IACjD,MAAM,CAAC,OAAO,SAAmC;IAEjD,MAAM,CAAC,WAAW,SAGyB;IAE3C,MAAM,CAAC,QAAQ,WAGd;IAED,MAAM,CAAC,KAAK;;;;;MAeX;IAEK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAuB3B"}

package/dist/commands/serve.js

@@ -0,0 +1,53 @@
+import { Flags } from "@oclif/core";
+import { DEFAULT_ECP_UP_HOST, DEFAULT_ECP_UP_PORT } from "../lib/up/constants.js";
+import { startEcpServe } from "../lib/http/create-serve.js";
+import { EnvModuleCommand } from "../lib/env-module-command.js";
+/** Serve an environment over loopback HTTP for capability invoke. */
+export default class Serve extends EnvModuleCommand {
+    static summary = "Serve an environment over HTTP";
+    static description = "Run a loopback HTTP server that exposes POST /v1/invoke for any capability " +
+        "bound in --env. No auth (loopback-only trust model). For the Ollama browser " +
+        "demo bridge with pairing, use `ecp up`.";
+    static examples = [
+        "<%= config.bin %> <%= command.id %> --env examples/01-echo/environment.ts",
+        "<%= config.bin %> <%= command.id %> --env environment.ts --port 3090 --cors-origin http://localhost:5173",
+    ];
+    static flags = {
+        ...EnvModuleCommand.flags,
+        port: Flags.integer({
+            description: "Listen port (ECP leet default 3090)",
+            default: DEFAULT_ECP_UP_PORT,
+        }),
+        host: Flags.string({
+            description: "Bind host (loopback only by default)",
+            default: DEFAULT_ECP_UP_HOST,
+        }),
+        "cors-origin": Flags.string({
+            description: "Extra allowed CORS origin (repeatable)",
+            multiple: true,
+            default: [],
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(Serve);
+        const ecp = await this.loadEcp(flags);
+        const daemon = await startEcpServe({
+            ecp,
+            port: flags.port,
+            host: flags.host,
+            corsOrigins: flags["cors-origin"],
+        });
+        const baseURL = `http://${daemon.host}:${daemon.port}`;
+        this.log(`ECP serve on ${baseURL}`);
+        this.log("GET /health · POST /v1/invoke (no auth; loopback)");
+        this.log("Press Ctrl+C to stop.");
+        await new Promise((resolve) => {
+            const shutdown = () => {
+                void daemon.close().finally(() => resolve());
+            };
+            process.once("SIGINT", shutdown);
+            process.once("SIGTERM", shutdown);
+        });
+    }
+}
+//# sourceMappingURL=serve.js.map

package/dist/commands/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACnC,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAE/D,qEAAqE;AACrE,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,gBAAgB;IACjD,MAAM,CAAC,OAAO,GAAG,gCAAgC,CAAA;IAEjD,MAAM,CAAC,WAAW,GAChB,6EAA6E;QAC7E,8EAA8E;QAC9E,yCAAyC,CAAA;IAE3C,MAAM,CAAC,QAAQ,GAAG;QAChB,2EAA2E;QAC3E,0GAA0G;KAC3G,CAAA;IAED,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,gBAAgB,CAAC,KAAK;QACzB,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC;YAClB,WAAW,EAAE,qCAAqC;YAClD,OAAO,EAAE,mBAAmB;SAC7B,CAAC;QACF,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;YACjB,WAAW,EAAE,sCAAsC;YACnD,OAAO,EAAE,mBAAmB;SAC7B,CAAC;QACF,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC;YAC1B,WAAW,EAAE,wCAAwC;YACrD,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,EAAE;SACZ,CAAC;KACH,CAAA;IAED,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QACzC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QACrC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC;YACjC,GAAG;YACH,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,WAAW,EAAE,KAAK,CAAC,aAAa,CAAC;SAClC,CAAC,CAAA;QAEF,MAAM,OAAO,GAAG,UAAU,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,CAAA;QACtD,IAAI,CAAC,GAAG,CAAC,gBAAgB,OAAO,EAAE,CAAC,CAAA;QACnC,IAAI,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAA;QAC7D,IAAI,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAA;QAEjC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,MAAM,QAAQ,GAAG,GAAG,EAAE;gBACpB,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;YAC9C,CAAC,CAAA;YACD,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;YAChC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;QACnC,CAAC,CAAC,CAAA;IACJ,CAAC"}

package/dist/commands/test/rerun.d.ts

@@ -0,0 +1,16 @@
+import { EnvModuleCommand } from "../../lib/env-module-command.js";
+/** Rerun a single step in a test session. */
+export default class TestRerun extends EnvModuleCommand {
+    static summary: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        "step-id": import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        session: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        env: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=rerun.d.ts.map

package/dist/commands/test/rerun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rerun.d.ts","sourceRoot":"","sources":["../../../src/commands/test/rerun.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAGlE,6CAA6C;AAC7C,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,gBAAgB;IACrD,MAAM,CAAC,OAAO,SAAqC;IAEnD,MAAM,CAAC,WAAW,SAEwD;IAE1E,MAAM,CAAC,QAAQ,WAEd;IAED,MAAM,CAAC,IAAI;;MAKV;IAED,MAAM,CAAC,KAAK;;;MAMX;IAEK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAW3B"}

package/dist/commands/test/rerun.js

@@ -0,0 +1,38 @@
+import { Args, Flags } from "@oclif/core";
+import { runWithCommandError } from "../../lib/command-helpers.js";
+import { EnvModuleCommand } from "../../lib/env-module-command.js";
+import { readTestSessionFile, writeTestSessionFile } from "../../lib/test-session-io.js";
+/** Rerun a single step in a test session. */
+export default class TestRerun extends EnvModuleCommand {
+    static summary = "Rerun one step in a test session";
+    static description = "Execute a single step against frozen prior state, replace its committed output, " +
+        "and clear downstream history and `.as` state keys. Rewrites --session.";
+    static examples = [
+        "<%= config.bin %> <%= command.id %> echo --env examples/01-echo/environment.ts --session session.json",
+    ];
+    static args = {
+        "step-id": Args.string({
+            required: true,
+            description: "Step id to rerun",
+        }),
+    };
+    static flags = {
+        ...EnvModuleCommand.flags,
+        session: Flags.string({
+            required: true,
+            description: "Path to test session JSON file",
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(TestRerun);
+        await runWithCommandError(this, async () => {
+            const snap = await readTestSessionFile(flags.session);
+            const ecp = await this.loadEcp(flags);
+            const session = await ecp.restoreTestSession(snap);
+            const next = await session.rerun(args["step-id"]);
+            await writeTestSessionFile(flags.session, next);
+            this.log(JSON.stringify(next, null, 2));
+        });
+    }
+}
+//# sourceMappingURL=rerun.js.map

package/dist/commands/test/rerun.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rerun.js","sourceRoot":"","sources":["../../../src/commands/test/rerun.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAClE,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAExF,6CAA6C;AAC7C,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,gBAAgB;IACrD,MAAM,CAAC,OAAO,GAAG,kCAAkC,CAAA;IAEnD,MAAM,CAAC,WAAW,GAChB,kFAAkF;QAClF,wEAAwE,CAAA;IAE1E,MAAM,CAAC,QAAQ,GAAG;QAChB,uGAAuG;KACxG,CAAA;IAED,MAAM,CAAC,IAAI,GAAG;QACZ,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC;YACrB,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,kBAAkB;SAChC,CAAC;KACH,CAAA;IAED,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,gBAAgB,CAAC,KAAK;QACzB,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC;YACpB,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,gCAAgC;SAC9C,CAAC;KACH,CAAA;IAED,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QACnD,MAAM,mBAAmB,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;YACzC,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YACrD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;YACrC,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAA;YAClD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAA;YACjD,MAAM,oBAAoB,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;YAC/C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QACzC,CAAC,CAAC,CAAA;IACJ,CAAC"}

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

@@ -0,0 +1,14 @@
+import { EnvModuleCommand } from "../../lib/env-module-command.js";
+/** Inclusive run-to within a test session. */
+export default class TestRun extends EnvModuleCommand {
+    static summary: string;
+    static description: string;
+    static examples: string[];
+    static flags: {
+        to: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        session: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        env: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=run.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/commands/test/run.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAGlE,8CAA8C;AAC9C,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,gBAAgB;IACnD,MAAM,CAAC,OAAO,SAAsC;IAEpD,MAAM,CAAC,WAAW,SAE0C;IAE5D,MAAM,CAAC,QAAQ,WAEd;IAED,MAAM,CAAC,KAAK;;;;MAUX;IAEK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAW3B"}

package/dist/commands/test/run.js

@@ -0,0 +1,36 @@
+import { Flags } from "@oclif/core";
+import { runWithCommandError } from "../../lib/command-helpers.js";
+import { EnvModuleCommand } from "../../lib/env-module-command.js";
+import { readTestSessionFile, writeTestSessionFile } from "../../lib/test-session-io.js";
+/** Inclusive run-to within a test session. */
+export default class TestRun extends EnvModuleCommand {
+    static summary = "Run a test session through a step";
+    static description = "Inclusively execute through --to <step-id>, skipping already-completed prior steps " +
+        "and freezing state for later reruns. Rewrites --session.";
+    static examples = [
+        "<%= config.bin %> <%= command.id %> --to echo --env examples/01-echo/environment.ts --session session.json",
+    ];
+    static flags = {
+        ...EnvModuleCommand.flags,
+        to: Flags.string({
+            required: true,
+            description: "Inclusive step id to run through",
+        }),
+        session: Flags.string({
+            required: true,
+            description: "Path to test session JSON file",
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(TestRun);
+        await runWithCommandError(this, async () => {
+            const snap = await readTestSessionFile(flags.session);
+            const ecp = await this.loadEcp(flags);
+            const session = await ecp.restoreTestSession(snap);
+            const next = await session.runTo(flags.to);
+            await writeTestSessionFile(flags.session, next);
+            this.log(JSON.stringify(next, null, 2));
+        });
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/test/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/commands/test/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAClE,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAExF,8CAA8C;AAC9C,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,gBAAgB;IACnD,MAAM,CAAC,OAAO,GAAG,mCAAmC,CAAA;IAEpD,MAAM,CAAC,WAAW,GAChB,qFAAqF;QACrF,0DAA0D,CAAA;IAE5D,MAAM,CAAC,QAAQ,GAAG;QAChB,4GAA4G;KAC7G,CAAA;IAED,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,gBAAgB,CAAC,KAAK;QACzB,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC;YACf,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,kCAAkC;SAChD,CAAC;QACF,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC;YACpB,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,gCAAgC;SAC9C,CAAC;KACH,CAAA;IAED,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAC3C,MAAM,mBAAmB,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;YACzC,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YACrD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;YACrC,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAA;YAClD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YAC1C,MAAM,oBAAoB,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;YAC/C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QACzC,CAAC,CAAC,CAAA;IACJ,CAAC"}

package/dist/commands/test/start.d.ts

@@ -0,0 +1,17 @@
+import { WorkflowEnvCommand } from "../../lib/env-module-command.js";
+/** Create a workflow test session file. */
+export default class TestStart extends WorkflowEnvCommand {
+    static summary: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        "workflow-path": import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        input: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        env: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=start.d.ts.map

package/dist/commands/test/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/commands/test/start.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AAEpE,2CAA2C;AAC3C,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,kBAAkB;IACvD,MAAM,CAAC,OAAO,SAAkC;IAEhD,MAAM,CAAC,WAAW,SAE4C;IAE9D,MAAM,CAAC,QAAQ,WAEd;IAED,MAAM,CAAC,IAAI;;MAEV;IAED,MAAM,CAAC,KAAK;;;;MAUX;IAEK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAc3B"}

package/dist/commands/test/start.js

@@ -0,0 +1,43 @@
+import { Flags } from "@oclif/core";
+import { loadWorkflowFile } from "@executioncontrolprotocol/core/loaders";
+import { readJsonFile, runWithCommandError } from "../../lib/command-helpers.js";
+import { writeTestSessionFile } from "../../lib/test-session-io.js";
+import { WorkflowEnvCommand } from "../../lib/env-module-command.js";
+/** Create a workflow test session file. */
+export default class TestStart extends WorkflowEnvCommand {
+    static summary = "Start a workflow test session";
+    static description = "Create an idle test session snapshot for a workflow. Use `ecp test run --to` " +
+        "and `ecp test rerun` to drive execution with frozen state.";
+    static examples = [
+        "<%= config.bin %> <%= command.id %> examples/01-echo/workflow.ts --env examples/01-echo/environment.ts -o session.json",
+    ];
+    static args = {
+        ...WorkflowEnvCommand.args,
+    };
+    static flags = {
+        ...WorkflowEnvCommand.flags,
+        input: Flags.string({
+            description: "Path to JSON file with workflow input object",
+        }),
+        output: Flags.string({
+            char: "o",
+            required: true,
+            description: "Path to write the test session JSON file",
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(TestStart);
+        await runWithCommandError(this, async () => {
+            const input = flags.input
+                ? await readJsonFile(flags.input, "--input")
+                : {};
+            const ecp = await this.loadEcp(flags);
+            const workflow = await loadWorkflowFile(args["workflow-path"]);
+            const session = await ecp.test(workflow).with({ input }).start();
+            const snap = session.snapshot();
+            await writeTestSessionFile(flags.output, snap);
+            this.log(JSON.stringify(snap, null, 2));
+        });
+    }
+}
+//# sourceMappingURL=start.js.map

package/dist/commands/test/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../../src/commands/test/start.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAA;AACzE,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AAEpE,2CAA2C;AAC3C,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,kBAAkB;IACvD,MAAM,CAAC,OAAO,GAAG,+BAA+B,CAAA;IAEhD,MAAM,CAAC,WAAW,GAChB,+EAA+E;QAC/E,4DAA4D,CAAA;IAE9D,MAAM,CAAC,QAAQ,GAAG;QAChB,wHAAwH;KACzH,CAAA;IAED,MAAM,CAAC,IAAI,GAAG;QACZ,GAAG,kBAAkB,CAAC,IAAI;KAC3B,CAAA;IAED,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,kBAAkB,CAAC,KAAK;QAC3B,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC;YAClB,WAAW,EAAE,8CAA8C;SAC5D,CAAC;QACF,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,GAAG;YACT,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,0CAA0C;SACxD,CAAC;KACH,CAAA;IAED,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QACnD,MAAM,mBAAmB,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;YACzC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK;gBACvB,CAAC,CAAC,MAAM,YAAY,CAA0B,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC;gBACrE,CAAC,CAAC,EAAE,CAAA;YACN,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;YACrC,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAA;YAC9D,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAA;YAChE,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAA;YAC/B,MAAM,oBAAoB,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;YAC9C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QACzC,CAAC,CAAC,CAAA;IACJ,CAAC"}

package/dist/commands/test/status.d.ts

@@ -0,0 +1,12 @@
+import { Command } from "@oclif/core";
+/** Print test session status. */
+export default class TestStatus extends Command {
+    static summary: string;
+    static description: string;
+    static examples: string[];
+    static flags: {
+        session: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/test/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/test/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,OAAO,EAAE,MAAM,aAAa,CAAA;AAI5C,iCAAiC;AACjC,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,OAAO;IAC7C,MAAM,CAAC,OAAO,SAA6B;IAE3C,MAAM,CAAC,WAAW,SACwD;IAE1E,MAAM,CAAC,QAAQ,WAAiE;IAEhF,MAAM,CAAC,KAAK;;MAMX;IAEK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAO3B"}

package/dist/commands/test/status.js

@@ -0,0 +1,24 @@
+import { Flags, Command } from "@oclif/core";
+import { runWithCommandError } from "../../lib/command-helpers.js";
+import { readTestSessionFile } from "../../lib/test-session-io.js";
+/** Print test session status. */
+export default class TestStatus extends Command {
+    static summary = "Show test session status";
+    static description = "Print the test session snapshot (status, cursor, state keys, history).";
+    static examples = ["<%= config.bin %> <%= command.id %> --session session.json"];
+    static flags = {
+        ...Command.baseFlags,
+        session: Flags.string({
+            required: true,
+            description: "Path to test session JSON file",
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(TestStatus);
+        await runWithCommandError(this, async () => {
+            const snap = await readTestSessionFile(flags.session);
+            this.log(JSON.stringify(snap, null, 2));
+        });
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/test/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/commands/test/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AAElE,iCAAiC;AACjC,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,OAAO;IAC7C,MAAM,CAAC,OAAO,GAAG,0BAA0B,CAAA;IAE3C,MAAM,CAAC,WAAW,GAChB,wEAAwE,CAAA;IAE1E,MAAM,CAAC,QAAQ,GAAG,CAAC,4DAA4D,CAAC,CAAA;IAEhF,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,OAAO,CAAC,SAAS;QACpB,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC;YACpB,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,gCAAgC;SAC9C,CAAC;KACH,CAAA;IAED,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;QAC9C,MAAM,mBAAmB,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;YACzC,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YACrD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QACzC,CAAC,CAAC,CAAA;IACJ,CAAC"}

package/dist/commands/test.d.ts

@@ -0,0 +1,9 @@
+import { Command } from "@oclif/core";
+/** Workflow test sessions (run-to / rerun with frozen state). */
+export default class TestTopic extends Command {
+    static summary: string;
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}
+//# sourceMappingURL=test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../src/commands/test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAErC,iEAAiE;AACjE,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,OAAO;IAC5C,MAAM,CAAC,OAAO,SAA8C;IAE5D,MAAM,CAAC,WAAW,SAM8B;IAEhD,MAAM,CAAC,QAAQ,WAKd;IAEK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAe3B"}

package/dist/commands/test.js

@@ -0,0 +1,32 @@
+import { Command } from "@oclif/core";
+/** Workflow test sessions (run-to / rerun with frozen state). */
+export default class TestTopic extends Command {
+    static summary = "Test a workflow with a persistent session";
+    static description = `Create and drive a test session that freezes workflow state between operations.
+
+Subcommands:
+  start   Create a session file from a workflow
+  run     Inclusive run-to via --to <step-id>
+  rerun   Rerun one step and clear downstream state
+  status  Print session status / cursor / history`;
+    static examples = [
+        "<%= config.bin %> test start workflow.ts --env environment.ts -o session.json",
+        "<%= config.bin %> test run --to step-b --env environment.ts --session session.json",
+        "<%= config.bin %> test rerun step-a --env environment.ts --session session.json",
+        "<%= config.bin %> test status --session session.json",
+    ];
+    async run() {
+        await this.parse(TestTopic);
+        this.log([
+            "Usage: ecp test <subcommand>",
+            "",
+            "  start WORKFLOW-PATH  Create a session (-o session.json)",
+            "  run --to STEP-ID     Inclusive run through a step",
+            "  rerun STEP-ID        Rerun one step; clear downstream",
+            "  status               Show session snapshot summary",
+            "",
+            "Run ecp test <cmd> --help for flags.",
+        ].join("\n"));
+    }
+}
+//# sourceMappingURL=test.js.map

package/dist/commands/test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../../src/commands/test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAErC,iEAAiE;AACjE,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,OAAO;IAC5C,MAAM,CAAC,OAAO,GAAG,2CAA2C,CAAA;IAE5D,MAAM,CAAC,WAAW,GAAG;;;;;;kDAM2B,CAAA;IAEhD,MAAM,CAAC,QAAQ,GAAG;QAChB,+EAA+E;QAC/E,oFAAoF;QACpF,iFAAiF;QACjF,sDAAsD;KACvD,CAAA;IAED,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QAC3B,IAAI,CAAC,GAAG,CACN;YACE,8BAA8B;YAC9B,EAAE;YACF,2DAA2D;YAC3D,qDAAqD;YACrD,yDAAyD;YACzD,sDAAsD;YACtD,EAAE;YACF,sCAAsC;SACvC,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAA;IACH,CAAC"}

package/dist/commands/up.d.ts

@@ -0,0 +1,18 @@
+import { Command } from "@oclif/core";
+/** Start the local ECP daemon (bridges Ollama for the browser demo). */
+export default class Up extends Command {
+    static summary: string;
+    static description: string;
+    static examples: string[];
+    static flags: {
+        port: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        host: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        "ollama-url": import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        "cors-origin": import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
+        token: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "open-url": import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        open: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=up.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"up.d.ts","sourceRoot":"","sources":["../../src/commands/up.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAA;AAU5C,wEAAwE;AACxE,MAAM,CAAC,OAAO,OAAO,EAAG,SAAQ,OAAO;IACrC,MAAM,CAAC,OAAO,SAA+B;IAE7C,MAAM,CAAC,WAAW,SAEmE;IAErF,MAAM,CAAC,QAAQ,WAId;IAED,MAAM,CAAC,KAAK;;;;;;;;MA8BX;IAEK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAmD3B"}