Environments

An environment is the governed execution container for ECP (Execution Control Protocol) workflows. Workflows stay portable; environments hold host bindings.

Create and bind

Node host (CLI and server apps):

import { environment, extension, policy } from "@executioncontrolprotocol/node"
import "@executioncontrolprotocol/core/testing"
import "@executioncontrolprotocol/format-toon"

export default (await environment("echo-dev", "Echo development"))
  .withExtensions([
    extension("@executioncontrolprotocol/test").with({}),
    extension("@executioncontrolprotocol/format-toon").with({}),
  ])

Common builder methods:

Method	Role
`.withRuntime(…)`	Override or set runtime
`.withExtensions([...])`	Bind cataloged extensions
`.withPolicies([...])`	Bind policies
`.withHarnesses([...])`	Bind harnesses (common in browser apps)
`.init()`	Return operational Ecp

Import extension packages for side-effect catalog registration before binding by string id.

Init and operational APIs

const env = await environment("dev")
  .withExtensions([extension("@executioncontrolprotocol/test").with({})])

const ecp = await env.init()

await ecp.describe()
await ecp.search("echo")
await ecp.validate(manifest)
await ecp.run(manifest)
await ecp.encode(source).uses("@executioncontrolprotocol/format-toon").to("@executioncontrolprotocol.workflow").process()
await ecp.terminate()

Do not call run/encode on the environment builder — use the Ecp returned by init().

Browser hosts

@executioncontrolprotocol/browser provides a slim host (executor, registry, session). Apps bind providers and harnesses. The browser demo is one such app; see Demo providers and configuration.

CLI

Point commands at an environment module:

ecp run workflow.ts --env environment.ts
ecp describe --env environment.ts
ecp search "echo" --env environment.ts

Getting started

Learn

Build

Alternatives

AI tools

Reference

Environments

Environments

Create and bind

Init and operational APIs

Browser hosts

CLI

Next steps

​Environments

​Create and bind

​Init and operational APIs

​Browser hosts

​CLI

​Next steps

Environments

Create and bind

Init and operational APIs

Browser hosts

CLI

Next steps