@executioncontrolprotocol/node 0.10.0

package/README.md

@@ -0,0 +1,36 @@
+# @executioncontrolprotocol/node
+
+**Node.js runtime host** for ECP: Node executor, process-env and secrets extensions, and re-exports of Node-only compile from `@executioncontrolprotocol/core`.
+
+## vs `@executioncontrolprotocol/core`
+
+| Package | Role |
+| ------- | ---- |
+| `@executioncontrolprotocol/core` | Runtime-agnostic API and in-memory engine |
+| `@executioncontrolprotocol/node` | Node host: `@executioncontrolprotocol/node` runtime, `process.env`, secrets, `compileWorkflowSource` via `@executioncontrolprotocol/core/compile` |
+
+Node apps and the CLI compose environments with `@executioncontrolprotocol/node`; they import compile/loaders from `@executioncontrolprotocol/core/compile` or `@executioncontrolprotocol/core/node`, not from the core main barrel.
+
+## Typical usage
+
+```ts
+import { environment, extension, workflow, step } from "@executioncontrolprotocol/node"
+import "@executioncontrolprotocol/core/testing"
+
+const env = (await environment("dev")).withExtensions([
+  extension("@executioncontrolprotocol/test").with({}),
+])
+const ecp = await env.init()
+await ecp.run(
+  workflow("Echo")
+    .run([step("@executioncontrolprotocol/test.echo", "Echo").with({ value: "hi" }).as("out")])
+    .toManifest()
+)
+```
+
+## Related
+
+- [`@executioncontrolprotocol/core`](../core/README.md) — core API and subpaths
+- [`@executioncontrolprotocol/cli`](../cli/) — `ecp run`, `ecp compile`, etc. (uses `@executioncontrolprotocol/core/loaders` + `@executioncontrolprotocol/core/compile`)
+
+See [AGENTS.md](../../AGENTS.md) for CLI commands and extension catalog rules.

package/dist/environment.d.ts

@@ -0,0 +1,9 @@
+import type { Environment } from "@executioncontrolprotocol/core";
+/** Register Node runtime and standard Node extensions. */
+export declare function registerNodeDefaults(): Promise<void>;
+/**
+ * Create a Node environment with `@executioncontrolprotocol/node` runtime pre-bound.
+ * @category Environment
+ */
+export declare function environment(id: string, label?: string): Promise<Environment>;
+//# sourceMappingURL=environment.d.ts.map

package/dist/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AAMjE,0DAA0D;AAC1D,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAK1D;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAGlF"}

package/dist/environment.js

@@ -0,0 +1,21 @@
+import { environment as coreEnvironment, runtime } from "@executioncontrolprotocol/core";
+import { registerStandardPolicies } from "@executioncontrolprotocol/policies";
+import { NODE_RUNTIME_ID, registerNodeRuntime } from "./runtime/builtin-node.js";
+import { registerProcessEnvExtension } from "@executioncontrolprotocol/process-env";
+import { registerSecretsExtension } from "@executioncontrolprotocol/secrets";
+/** Register Node runtime and standard Node extensions. */
+export async function registerNodeDefaults() {
+    await registerNodeRuntime();
+    await registerSecretsExtension();
+    await registerProcessEnvExtension();
+    await registerStandardPolicies();
+}
+/**
+ * Create a Node environment with `@executioncontrolprotocol/node` runtime pre-bound.
+ * @category Environment
+ */
+export async function environment(id, label) {
+    await registerNodeDefaults();
+    return coreEnvironment(id, label).withRuntime(runtime(NODE_RUNTIME_ID, "Node Runtime"));
+}
+//# sourceMappingURL=environment.js.map

package/dist/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,IAAI,eAAe,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAA;AAExF,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAA;AAC7E,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAChF,OAAO,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAA;AACnF,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAA;AAE5E,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,MAAM,mBAAmB,EAAE,CAAA;IAC3B,MAAM,wBAAwB,EAAE,CAAA;IAChC,MAAM,2BAA2B,EAAE,CAAA;IACnC,MAAM,wBAAwB,EAAE,CAAA;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAAU,EAAE,KAAc;IAC1D,MAAM,oBAAoB,EAAE,CAAA;IAC5B,OAAO,eAAe,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC,CAAA;AACzF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { NODE_RUNTIME_ID, nodeRuntimeDefinition, NodeRuntimeExecutor, registerNodeRuntime, } from "./runtime/builtin-node.js";
+export { processEnvExtension, registerProcessEnvExtension, } from "@executioncontrolprotocol/process-env";
+export { secretsExtension, registerSecretsExtension, setMemorySecret, setSecretsProvider, setSecretsStore, resetSecretsStore, memorySecretsProvider, memorySecretsStore, createOsSecretsStore, redactSecret, type SecretsStore, } from "@executioncontrolprotocol/secrets";
+export { registerNodeDefaults, environment } from "./environment.js";
+export { workflow, step, ref, state, env, secrets, expr, parallel, branch, loop, extension, runtime, policy, defineExtension, defineRuntime, definePolicy, capability, capabilityFor, hook, Environment, Registry, globalRegistry, registerTestExtension, validateWorkflow, } from "@executioncontrolprotocol/core";
+export { compileWorkflowSource, compileAndValidateWorkflowSource } from "@executioncontrolprotocol/core/compile";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,2BAA2B,CAAA;AAElC,OAAO,EACL,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,uCAAuC,CAAA;AAE9C,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,YAAY,EACZ,KAAK,YAAY,GAClB,MAAM,mCAAmC,CAAA;AAE1C,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEpE,OAAO,EACL,QAAQ,EACR,IAAI,EACJ,GAAG,EACH,KAAK,EACL,GAAG,EACH,OAAO,EACP,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,IAAI,EACJ,SAAS,EACT,OAAO,EACP,MAAM,EACN,eAAe,EACf,aAAa,EACb,YAAY,EACZ,UAAU,EACV,aAAa,EACb,IAAI,EACJ,WAAW,EACX,QAAQ,EACR,cAAc,EACd,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,gCAAgC,CAAA;AACvC,OAAO,EAAE,qBAAqB,EAAE,gCAAgC,EAAE,MAAM,wCAAwC,CAAA"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { NODE_RUNTIME_ID, nodeRuntimeDefinition, NodeRuntimeExecutor, registerNodeRuntime, } from "./runtime/builtin-node.js";
+export { processEnvExtension, registerProcessEnvExtension, } from "@executioncontrolprotocol/process-env";
+export { secretsExtension, registerSecretsExtension, setMemorySecret, setSecretsProvider, setSecretsStore, resetSecretsStore, memorySecretsProvider, memorySecretsStore, createOsSecretsStore, redactSecret, } from "@executioncontrolprotocol/secrets";
+export { registerNodeDefaults, environment } from "./environment.js";
+export { workflow, step, ref, state, env, secrets, expr, parallel, branch, loop, extension, runtime, policy, defineExtension, defineRuntime, definePolicy, capability, capabilityFor, hook, Environment, Registry, globalRegistry, registerTestExtension, validateWorkflow, } from "@executioncontrolprotocol/core";
+export { compileWorkflowSource, compileAndValidateWorkflowSource } from "@executioncontrolprotocol/core/compile";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,2BAA2B,CAAA;AAElC,OAAO,EACL,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,uCAAuC,CAAA;AAE9C,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,YAAY,GAEb,MAAM,mCAAmC,CAAA;AAE1C,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEpE,OAAO,EACL,QAAQ,EACR,IAAI,EACJ,GAAG,EACH,KAAK,EACL,GAAG,EACH,OAAO,EACP,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,IAAI,EACJ,SAAS,EACT,OAAO,EACP,MAAM,EACN,eAAe,EACf,aAAa,EACb,YAAY,EACZ,UAAU,EACV,aAAa,EACb,IAAI,EACJ,WAAW,EACX,QAAQ,EACR,cAAc,EACd,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,gCAAgC,CAAA;AACvC,OAAO,EAAE,qBAAqB,EAAE,gCAAgC,EAAE,MAAM,wCAAwC,CAAA"}

package/dist/runtime/builtin-node.d.ts

@@ -0,0 +1,8 @@
+export { NodeRuntimeExecutor } from "./node-executor.js";
+/** Node runtime id. @category Runtime */
+export declare const NODE_RUNTIME_ID: "@executioncontrolprotocol/node";
+/** Built-in Node runtime definition. @category Runtime */
+export declare const nodeRuntimeDefinition: import("@executioncontrolprotocol/core").RuntimeDefinition;
+/** Register `@executioncontrolprotocol/node` on the global registry. */
+export declare function registerNodeRuntime(registry?: import("@executioncontrolprotocol/core").Registry): Promise<void>;
+//# sourceMappingURL=builtin-node.d.ts.map

package/dist/runtime/builtin-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-node.d.ts","sourceRoot":"","sources":["../../src/runtime/builtin-node.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAExD,yCAAyC;AACzC,eAAO,MAAM,eAAe,EAAG,gCAAyC,CAAA;AAExE,0DAA0D;AAC1D,eAAO,MAAM,qBAAqB,4DAIQ,CAAA;AAE1C,wEAAwE;AACxE,wBAAsB,mBAAmB,CAAC,QAAQ,oDAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAIlF"}

package/dist/runtime/builtin-node.js

@@ -0,0 +1,19 @@
+import { defineRuntime, globalRegistry } from "@executioncontrolprotocol/core";
+import { z } from "zod";
+import { NodeRuntimeExecutor } from "./node-executor.js";
+export { NodeRuntimeExecutor } from "./node-executor.js";
+/** Node runtime id. @category Runtime */
+export const NODE_RUNTIME_ID = "@executioncontrolprotocol/node";
+/** Built-in Node runtime definition. @category Runtime */
+export const nodeRuntimeDefinition = defineRuntime("@executioncontrolprotocol", "node")
+    .withConfig({
+    maxConcurrency: z.number().optional(),
+})
+    .withExecutor(new NodeRuntimeExecutor());
+/** Register `@executioncontrolprotocol/node` on the global registry. */
+export async function registerNodeRuntime(registry = globalRegistry) {
+    if (!registry.getRuntime(NODE_RUNTIME_ID)) {
+        await registry.registerRuntime(nodeRuntimeDefinition);
+    }
+}
+//# sourceMappingURL=builtin-node.js.map

package/dist/runtime/builtin-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-node.js","sourceRoot":"","sources":["../../src/runtime/builtin-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAC9E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAExD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAExD,yCAAyC;AACzC,MAAM,CAAC,MAAM,eAAe,GAAG,gCAAyC,CAAA;AAExE,0DAA0D;AAC1D,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAAC,2BAA2B,EAAE,MAAM,CAAC;KACpF,UAAU,CAAC;IACV,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACtC,CAAC;KACD,YAAY,CAAC,IAAI,mBAAmB,EAAE,CAAC,CAAA;AAE1C,wEAAwE;AACxE,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,QAAQ,GAAG,cAAc;IACjE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QAC1C,MAAM,QAAQ,CAAC,eAAe,CAAC,qBAAqB,CAAC,CAAA;IACvD,CAAC;AACH,CAAC"}

package/dist/runtime/node-executor.d.ts

@@ -0,0 +1,8 @@
+import type { RunResult, WorkflowManifest } from "@executioncontrolprotocol/types";
+import type { RuntimeExecutionContext, RuntimeExecutor } from "@executioncontrolprotocol/core";
+/** Node.js runtime executor (delegates to in-memory engine). @category Runtime */
+export declare class NodeRuntimeExecutor implements RuntimeExecutor {
+    private readonly inner;
+    execute(manifest: WorkflowManifest, context: RuntimeExecutionContext): Promise<RunResult>;
+}
+//# sourceMappingURL=node-executor.d.ts.map

package/dist/runtime/node-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-executor.d.ts","sourceRoot":"","sources":["../../src/runtime/node-executor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAClF,OAAO,KAAK,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAE9F,kFAAkF;AAClF,qBAAa,mBAAoB,YAAW,eAAe;IACzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IAEtD,OAAO,CACL,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,SAAS,CAAC;CAMtB"}

package/dist/runtime/node-executor.js

@@ -0,0 +1,11 @@
+import { InMemoryRuntimeExecutor } from "@executioncontrolprotocol/core";
+/** Node.js runtime executor (delegates to in-memory engine). @category Runtime */
+export class NodeRuntimeExecutor {
+    inner = new InMemoryRuntimeExecutor();
+    execute(manifest, context) {
+        const maxConcurrency = context.maxConcurrency ??
+            context.bindings.runtime.config.maxConcurrency;
+        return this.inner.execute(manifest, { ...context, maxConcurrency });
+    }
+}
+//# sourceMappingURL=node-executor.js.map

package/dist/runtime/node-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-executor.js","sourceRoot":"","sources":["../../src/runtime/node-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAA;AAIxE,kFAAkF;AAClF,MAAM,OAAO,mBAAmB;IACb,KAAK,GAAG,IAAI,uBAAuB,EAAE,CAAA;IAEtD,OAAO,CACL,QAA0B,EAC1B,OAAgC;QAEhC,MAAM,cAAc,GAClB,OAAO,CAAC,cAAc;YACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,cAAqC,CAAA;QACxE,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,GAAG,OAAO,EAAE,cAAc,EAAE,CAAC,CAAA;IACrE,CAAC;CACF"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@executioncontrolprotocol/node",
+  "version": "0.10.0",
+  "description": "ECP Node.js runtime and environment extensions",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "peerDependencies": {
+    "zod": "^3.24.0"
+  },
+  "dependencies": {
+    "@executioncontrolprotocol/core": "0.10.0",
+    "@executioncontrolprotocol/types": "0.10.0",
+    "@executioncontrolprotocol/policies": "0.10.0",
+    "@executioncontrolprotocol/secrets": "0.10.0",
+    "@executioncontrolprotocol/process-env": "0.10.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "zod": "^3.24.0"
+  }
+}