@executioncontrolprotocol/core 0.10.0

package/dist/environment/ecp.d.ts

@@ -0,0 +1,58 @@
+import type { CapabilityId, DescribeQuery, EnvironmentDescriptor, RunResult, SearchOptions, SearchResult, ValidationResult, WorkflowManifest } from "@executioncontrolprotocol/types";
+import type { Registry } from "../registry/registry.js";
+import type { Environment, RunOptions } from "./environment.js";
+import { type DecodeOperationBuilder, type EncodeOperationBuilder } from "../encoding/index.js";
+import { type PatchOperationBuilder } from "../patch/index.js";
+import type { InvokeOperationBuilder } from "../invoke/invoke-builder.js";
+export type { RunOptions } from "./environment.js";
+/**
+ * Initialized operational ECP instance (returned from {@link Environment.init}).
+ * @category Environment
+ */
+export interface Ecp {
+    /** Environment id. */
+    id: string;
+    /** Optional label. */
+    label?: string;
+    /** Environment discovery descriptor. */
+    describe(query?: DescribeQuery): Promise<EnvironmentDescriptor>;
+    /** Search capabilities and policies. */
+    search(query: string, options?: SearchOptions): Promise<SearchResult>;
+    /** Encode a document via format extensions or JSON. */
+    encode(input: unknown): EncodeOperationBuilder;
+    /** Decode encoded content via format extensions or JSON. */
+    decode(input: unknown): DecodeOperationBuilder;
+    /** Apply a canonical JSON patch to a document. */
+    patch<T = unknown>(document: T): PatchOperationBuilder<T>;
+    /** Validate a workflow manifest or environment-only when omitted. */
+    validate(workflow?: WorkflowManifest): Promise<ValidationResult>;
+    /** Execute a workflow manifest. */
+    run(workflow: WorkflowManifest, options?: RunOptions): Promise<RunResult>;
+    /** Invoke a registered capability outside workflow execution. */
+    invoke(capabilityId: CapabilityId | string): InvokeOperationBuilder;
+    /** Underlying registry. */
+    getRegistry(): Registry;
+    /** Terminate the environment and release resources. */
+    terminate(): Promise<void>;
+}
+/**
+ * Operational facade over a prepared {@link Environment}.
+ * @category Environment
+ */
+export declare class EcpImpl implements Ecp {
+    private readonly env;
+    constructor(env: Environment);
+    get id(): string;
+    get label(): string | undefined;
+    describe(query?: DescribeQuery): Promise<EnvironmentDescriptor>;
+    search(query: string, options?: SearchOptions): Promise<SearchResult>;
+    encode(input: unknown): EncodeOperationBuilder;
+    decode(input: unknown): DecodeOperationBuilder;
+    patch<T = unknown>(document: T): PatchOperationBuilder<T>;
+    validate(workflow?: WorkflowManifest): Promise<ValidationResult>;
+    run(workflow: WorkflowManifest, options?: RunOptions): Promise<RunResult>;
+    invoke(capabilityId: CapabilityId | string): InvokeOperationBuilder;
+    getRegistry(): Registry;
+    terminate(): Promise<void>;
+}
+//# sourceMappingURL=ecp.d.ts.map

package/dist/environment/ecp.d.ts.map

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

package/dist/environment/ecp.js

@@ -0,0 +1,49 @@
+import { createDecodeBuilder, createEncodeBuilder, } from "../encoding/index.js";
+import { createPatchBuilder } from "../patch/index.js";
+/**
+ * Operational facade over a prepared {@link Environment}.
+ * @category Environment
+ */
+export class EcpImpl {
+    env;
+    constructor(env) {
+        this.env = env;
+    }
+    get id() {
+        return this.env.getEnvId();
+    }
+    get label() {
+        return this.env.getEnvLabel();
+    }
+    describe(query) {
+        return this.env.ecpDescribe(query);
+    }
+    search(query, options) {
+        return this.env.ecpSearch(query, options);
+    }
+    encode(input) {
+        return createEncodeBuilder(this.env, input);
+    }
+    decode(input) {
+        return createDecodeBuilder(this.env, input);
+    }
+    patch(document) {
+        return createPatchBuilder(document);
+    }
+    validate(workflow) {
+        return this.env.ecpValidate(workflow);
+    }
+    run(workflow, options) {
+        return this.env.ecpRun(workflow, options);
+    }
+    invoke(capabilityId) {
+        return this.env.ecpInvoke(capabilityId);
+    }
+    getRegistry() {
+        return this.env.getRegistry();
+    }
+    terminate() {
+        return this.env.ecpTerminate();
+    }
+}
+//# sourceMappingURL=ecp.js.map

package/dist/environment/ecp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecp.js","sourceRoot":"","sources":["../../src/environment/ecp.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GAGpB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,kBAAkB,EAA8B,MAAM,mBAAmB,CAAA;AAoClF;;;GAGG;AACH,MAAM,OAAO,OAAO;IACW;IAA7B,YAA6B,GAAgB;QAAhB,QAAG,GAAH,GAAG,CAAa;IAAG,CAAC;IAEjD,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;IAC5B,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAA;IAC/B,CAAC;IAED,QAAQ,CAAC,KAAqB;QAC5B,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;IACpC,CAAC;IAED,MAAM,CAAC,KAAa,EAAE,OAAuB;QAC3C,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IAC3C,CAAC;IAED,MAAM,CAAC,KAAc;QACnB,OAAO,mBAAmB,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IAC7C,CAAC;IAED,MAAM,CAAC,KAAc;QACnB,OAAO,mBAAmB,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IAC7C,CAAC;IAED,KAAK,CAAc,QAAW;QAC5B,OAAO,kBAAkB,CAAC,QAAQ,CAAC,CAAA;IACrC,CAAC;IAED,QAAQ,CAAC,QAA2B;QAClC,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA;IACvC,CAAC;IAED,GAAG,CAAC,QAA0B,EAAE,OAAoB;QAClD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC3C,CAAC;IAED,MAAM,CAAC,YAAmC;QACxC,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,YAA4B,CAAC,CAAA;IACzD,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAA;IAC/B,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAA;IAChC,CAAC;CACF"}

package/dist/environment/encoding-host.d.ts

@@ -0,0 +1,17 @@
+import type { Registry } from "../registry/registry.js";
+/**
+ * Minimal environment surface required by encode/decode builders.
+ * @category Environment
+ * @internal
+ */
+export interface EncodingEnvironmentHost {
+    /** Register extension definitions for bound extensions. */
+    ensureBoundExtensionsRegistered(): Promise<void>;
+    /** Environment id. */
+    getEnvId(): string;
+    /** Optional environment label. */
+    getEnvLabel(): string | undefined;
+    /** Definition registry. */
+    getRegistry(): Registry;
+}
+//# sourceMappingURL=encoding-host.d.ts.map

package/dist/environment/encoding-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding-host.d.ts","sourceRoot":"","sources":["../../src/environment/encoding-host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAEvD;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,2DAA2D;IAC3D,+BAA+B,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,sBAAsB;IACtB,QAAQ,IAAI,MAAM,CAAA;IAClB,kCAAkC;IAClC,WAAW,IAAI,MAAM,GAAG,SAAS,CAAA;IACjC,2BAA2B;IAC3B,WAAW,IAAI,QAAQ,CAAA;CACxB"}

package/dist/environment/encoding-host.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=encoding-host.js.map

package/dist/environment/encoding-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding-host.js","sourceRoot":"","sources":["../../src/environment/encoding-host.ts"],"names":[],"mappings":""}

package/dist/environment/environment.d.ts

@@ -0,0 +1,94 @@
+import type { DescribeQuery, EnvironmentDescriptor, EnvironmentManifest, RegistryRegistrationRequest, RunResult, SearchOptions, SearchResult, ValidationResult, WorkflowManifest } from "@executioncontrolprotocol/types";
+import type { NamespacedId } from "@executioncontrolprotocol/types";
+import { type ExtensionBindingBuilder } from "../bindings/extension.js";
+import type { HarnessBindingBuilder } from "../bindings/harness.js";
+import { type PolicyBindingBuilder } from "../bindings/policy.js";
+import type { RuntimeBindingBuilder } from "../bindings/runtime.js";
+import { Registry } from "../registry/registry.js";
+import type { EnvironmentLifecycleHost } from "../runtime/context.js";
+import { type ResolvedBindings } from "./bindings.js";
+import type { EnvironmentConfigResolver } from "./config-resolver.js";
+import type { EncodingEnvironmentHost } from "./encoding-host.js";
+import { type Ecp } from "./ecp.js";
+/** Run options. @category Environment */
+export interface RunOptions {
+    input?: Record<string, unknown>;
+    dryRun?: boolean;
+    signal?: AbortSignal;
+}
+/**
+ * Configured ECP environment.
+ * @category Environment
+ */
+export declare class Environment implements EnvironmentLifecycleHost, EncodingEnvironmentHost {
+    private readonly envId;
+    private readonly envLabel;
+    private runtimeBinding;
+    private extensionBindings;
+    private policyBindings;
+    private harnessBindings;
+    private readonly registry;
+    private resolved?;
+    private discoveryPrepared;
+    private readonly configResolvers;
+    constructor(envId: string, envLabel: string | undefined, runtimeBinding: RuntimeBindingBuilder | undefined, extensionBindings?: ExtensionBindingBuilder[], policyBindings?: PolicyBindingBuilder[], harnessBindings?: HarnessBindingBuilder[], registry?: Registry);
+    registerConfigResolver(resolver: EnvironmentConfigResolver): void;
+    withRuntime(binding: RuntimeBindingBuilder): this;
+    withExtensions(bindings: ExtensionBindingBuilder[]): this;
+    withPolicies(bindings: PolicyBindingBuilder[]): this;
+    /** Bind harness definitions with default providers and config. */
+    withHarnesses(bindings: HarnessBindingBuilder[]): this;
+    /** Dynamically add an extension binding (e.g. browser registry auto-bind). */
+    addExtensionBinding(ref: NamespacedId, config?: Record<string, unknown>): void;
+    /** Dynamically add a policy binding. */
+    addPolicyBinding(ref: NamespacedId, config?: Record<string, unknown>): void;
+    private invalidatePrepared;
+    private collectPolicyHooks;
+    /** Evaluate bound policies before registry accepts a registration. */
+    evaluateRegistryRegistration(request: RegistryRegistrationRequest): Promise<void>;
+    private emitEnvironmentEvent;
+    /** Discovery path: configuring only (no ready). */
+    private prepareForDiscovery;
+    /** Run path: full binding resolution and ready. */
+    private prepareForRun;
+    private resolveBindings;
+    /** @internal {@link EcpImpl} — resolved bindings after init. */
+    ecpResolveBindings(): ResolvedBindings;
+    /** Prepare bindings for execution and emit environment:ready. */
+    ensureReady(): Promise<void>;
+    compile(): EnvironmentManifest;
+    getRegistry(): Registry;
+    /**
+     * Register extension definitions for all bindings (catalog lookup or inline def).
+     * Idempotent; safe to call before encode, decode, describe, or run.
+     * @category Environment
+     */
+    ensureBoundExtensionsRegistered(): Promise<void>;
+    /** Environment id (for utility operations). @category Environment */
+    getEnvId(): string;
+    /** Environment label when set. @category Environment */
+    getEnvLabel(): string | undefined;
+    /**
+     * Initialize environment for operational use and return an {@link Ecp} instance.
+     * @category Environment
+     */
+    init(): Promise<Ecp>;
+    /** @internal {@link EcpImpl} — describe. */
+    ecpDescribe(query?: DescribeQuery): Promise<EnvironmentDescriptor>;
+    /** @internal {@link EcpImpl} — search. */
+    ecpSearch(query: string, options?: SearchOptions): Promise<SearchResult>;
+    /** @internal {@link EcpImpl} — validate. */
+    ecpValidate(workflow?: WorkflowManifest): Promise<ValidationResult>;
+    /** @internal {@link EcpImpl} — terminate. */
+    ecpTerminate(): Promise<void>;
+    /** @internal {@link EcpImpl} — invoke. */
+    ecpInvoke(capabilityId: import("@executioncontrolprotocol/types").CapabilityId): import("../invoke/invoke-builder.js").InvokeOperationBuilder;
+    /** @internal {@link EcpImpl} — run. */
+    ecpRun(workflow: WorkflowManifest, options?: RunOptions): Promise<RunResult>;
+}
+/**
+ * Create an ECP environment (no default runtime; bind with `.withRuntime(...)`).
+ * @category Environment
+ */
+export declare function environment(id: string, label?: string, registry?: Registry): Environment;
+//# sourceMappingURL=environment.d.ts.map

package/dist/environment/environment.d.ts.map

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

package/dist/environment/environment.js

@@ -0,0 +1,370 @@
+import { LATEST_ECP_VERSION } from "@executioncontrolprotocol/types";
+import { extension } from "../bindings/extension.js";
+import { policy } from "../bindings/policy.js";
+import { globalRegistry } from "../registry/registry.js";
+import { ensureBoundExtensionsRegistered as ensureBoundExtensions } from "../registry/ensure-bound-extensions.js";
+import { RegistryRegistrationDeniedError } from "../registry/errors.js";
+import { createUsageLedger } from "../runtime/context.js";
+import { evaluatePolicies } from "../runtime/policy-engine.js";
+import { manifestConfig, resolveBindingsForRun, } from "./bindings.js";
+import { buildDescriptor } from "./describe.js";
+import { searchCapabilities } from "./search.js";
+import { validateEnvironmentWithWorkflow } from "../validate/environment.js";
+import { validateHarnessBindings } from "../validate/harness.js";
+import { registerCoreFormats } from "../formats/register-core-formats.js";
+import { EcpImpl } from "./ecp.js";
+import { createInvokeBuilder } from "../invoke/invoke-builder.js";
+function resolveId(ref) {
+    if (typeof ref === "string")
+        return ref;
+    if ("id" in ref)
+        return ref.id;
+    return ref;
+}
+function emptyWorkflowStub() {
+    return {
+        schema: "@executioncontrolprotocol.workflow",
+        version: LATEST_ECP_VERSION,
+        workflow: { id: "environment-stub" },
+        steps: [],
+    };
+}
+const REGISTRY_CHECK_STEP = {
+    id: "registry-check",
+    capabilityId: "registry.registerExtension",
+};
+/**
+ * Configured ECP environment.
+ * @category Environment
+ */
+export class Environment {
+    envId;
+    envLabel;
+    runtimeBinding;
+    extensionBindings;
+    policyBindings;
+    harnessBindings;
+    registry;
+    resolved;
+    discoveryPrepared = false;
+    configResolvers = [];
+    constructor(envId, envLabel, runtimeBinding, extensionBindings = [], policyBindings = [], harnessBindings = [], registry = globalRegistry) {
+        this.envId = envId;
+        this.envLabel = envLabel;
+        this.runtimeBinding = runtimeBinding;
+        this.extensionBindings = extensionBindings;
+        this.policyBindings = policyBindings;
+        this.harnessBindings = harnessBindings;
+        this.registry = registry;
+    }
+    registerConfigResolver(resolver) {
+        this.configResolvers.push(resolver);
+    }
+    withRuntime(binding) {
+        this.runtimeBinding = binding;
+        this.invalidatePrepared();
+        return this;
+    }
+    withExtensions(bindings) {
+        this.extensionBindings = bindings;
+        this.invalidatePrepared();
+        return this;
+    }
+    withPolicies(bindings) {
+        this.policyBindings = bindings;
+        this.invalidatePrepared();
+        return this;
+    }
+    /** Bind harness definitions with default providers and config. */
+    withHarnesses(bindings) {
+        this.harnessBindings = bindings;
+        this.invalidatePrepared();
+        return this;
+    }
+    /** Dynamically add an extension binding (e.g. browser registry auto-bind). */
+    addExtensionBinding(ref, config = {}) {
+        this.extensionBindings.push(extension(ref).with(config));
+        this.invalidatePrepared();
+    }
+    /** Dynamically add a policy binding. */
+    addPolicyBinding(ref, config = {}) {
+        this.policyBindings.push(policy(ref).with(config));
+        this.invalidatePrepared();
+    }
+    invalidatePrepared() {
+        this.resolved = undefined;
+        this.discoveryPrepared = false;
+    }
+    collectPolicyHooks(event) {
+        return this.policyBindings.flatMap((b) => {
+            const id = resolveId(b.getRef());
+            const def = this.registry.getPolicy(id);
+            if (!def)
+                return [];
+            return def.hooks
+                .filter((h) => h.event === event)
+                .map((hook) => ({ hook, config: b.getConfig() }));
+        });
+    }
+    /** Evaluate bound policies before registry accepts a registration. */
+    async evaluateRegistryRegistration(request) {
+        await this.prepareForDiscovery();
+        const ctx = {
+            workflow: emptyWorkflowStub(),
+            run: { id: this.envId, input: {} },
+            step: REGISTRY_CHECK_STEP,
+            state: {},
+            input: {},
+            usage: createUsageLedger(),
+            scope: "environment",
+            operation: request.kind === "extension"
+                ? "registry.registerExtension"
+                : request.kind === "policy"
+                    ? "registry.registerPolicy"
+                    : "registry.registerRuntime",
+            registryRequest: request,
+        };
+        const decision = await evaluatePolicies("policy:pre", this.collectPolicyHooks("policy:pre"), ctx);
+        if (decision.type === "deny") {
+            throw new RegistryRegistrationDeniedError(request.id, decision.reason ?? "Registration denied by policy");
+        }
+    }
+    async emitEnvironmentEvent(event) {
+        const base = {
+            event,
+            workflow: emptyWorkflowStub(),
+            run: { id: this.envId, input: {} },
+            state: {},
+            environment: this,
+        };
+        for (const binding of this.extensionBindings) {
+            const id = resolveId(binding.getRef());
+            const def = this.registry.getExtension(id);
+            if (!def)
+                continue;
+            const hooks = [...def.hooks]
+                .filter((h) => h.event === event)
+                .sort((a, b) => (a.priority ?? 0) - (b.priority ?? 0));
+            for (const h of hooks) {
+                await h.handler({
+                    ...base,
+                    extensionConfig: binding.getConfig(),
+                });
+            }
+        }
+    }
+    /** Discovery path: configuring only (no ready). */
+    async prepareForDiscovery() {
+        if (this.discoveryPrepared)
+            return;
+        await registerCoreFormats(this.registry);
+        await this.ensureBoundExtensionsRegistered();
+        await this.emitEnvironmentEvent("environment:created");
+        if (!this.runtimeBinding) {
+            throw new Error("Environment requires a runtime binding (.withRuntime(...))");
+        }
+        await this.emitEnvironmentEvent("environment:configuring");
+        this.discoveryPrepared = true;
+    }
+    /** Run path: full binding resolution and ready. */
+    async prepareForRun() {
+        await this.prepareForDiscovery();
+        if (this.resolved)
+            return this.resolved;
+        const rtId = resolveId(this.runtimeBinding.getRef());
+        const rtDef = this.registry.getRuntime(rtId);
+        if (!rtDef)
+            throw new Error(`Runtime ${rtId} is not registered`);
+        const extensionBindings = this.extensionBindings.map((b, i) => ({
+            id: resolveId(b.getRef()),
+            label: b.getLabel(),
+            order: i,
+            rawConfig: b.getConfig(),
+        }));
+        const policyBindings = this.policyBindings.map((b, i) => ({
+            id: resolveId(b.getRef()),
+            label: b.getLabel(),
+            order: i,
+            rawConfig: b.getConfig(),
+        }));
+        const extensionHooks = extensionBindings.flatMap((ext) => {
+            const def = this.registry.getExtension(ext.id);
+            return def?.hooks ?? [];
+        });
+        const policyHooks = policyBindings.flatMap((pol) => {
+            const def = this.registry.getPolicy(pol.id);
+            if (!def)
+                return [];
+            return def.hooks.map((hook) => ({ hook, config: pol.rawConfig }));
+        });
+        const harnessBindings = this.harnessBindings.map((b) => {
+            const id = b.getRef();
+            const uses = b.getUses();
+            if (!uses) {
+                throw new Error(`Harness ${id} requires .uses(providerCapabilityId)`);
+            }
+            return {
+                id,
+                label: b.getLabel(),
+                uses,
+                rawConfig: b.getConfig(),
+            };
+        });
+        this.resolved = await resolveBindingsForRun({
+            id: rtId,
+            label: this.runtimeBinding.getLabel(),
+            rawConfig: this.runtimeBinding.getConfig(),
+        }, extensionBindings, policyBindings, harnessBindings, extensionHooks, policyHooks, this.configResolvers);
+        const harnessValidation = validateHarnessBindings(this.registry, this.resolved);
+        if (!harnessValidation.valid) {
+            throw new Error(`Harness validation failed: ${harnessValidation.errors.map((e) => e.message).join("; ")}`);
+        }
+        await this.emitEnvironmentEvent("environment:ready");
+        return this.resolved;
+    }
+    resolveBindings() {
+        if (!this.resolved) {
+            throw new Error("Environment not prepared for run; call init() or validate(workflow) first");
+        }
+        return this.resolved;
+    }
+    /** @internal {@link EcpImpl} — resolved bindings after init. */
+    ecpResolveBindings() {
+        return this.resolveBindings();
+    }
+    /** Prepare bindings for execution and emit environment:ready. */
+    async ensureReady() {
+        await this.prepareForRun();
+    }
+    compile() {
+        if (!this.runtimeBinding) {
+            throw new Error("Environment requires a runtime binding (.withRuntime(...))");
+        }
+        const rtId = resolveId(this.runtimeBinding.getRef());
+        return {
+            schema: "@executioncontrolprotocol.environment",
+            version: LATEST_ECP_VERSION,
+            environment: {
+                id: this.envId,
+                ...(this.envLabel ? { label: this.envLabel } : {}),
+            },
+            runtime: {
+                id: rtId,
+                ...(this.runtimeBinding.getLabel() ? { label: this.runtimeBinding.getLabel() } : {}),
+                config: manifestConfig(this.runtimeBinding.getConfig()),
+            },
+            extensions: this.extensionBindings.map((b, i) => ({
+                id: resolveId(b.getRef()),
+                ...(b.getLabel() ? { label: b.getLabel() } : {}),
+                order: i,
+                config: manifestConfig(b.getConfig()),
+            })),
+            policies: this.policyBindings.map((b, i) => ({
+                id: resolveId(b.getRef()),
+                ...(b.getLabel() ? { label: b.getLabel() } : {}),
+                order: i,
+                config: manifestConfig(b.getConfig()),
+            })),
+        };
+    }
+    getRegistry() {
+        return this.registry;
+    }
+    /**
+     * Register extension definitions for all bindings (catalog lookup or inline def).
+     * Idempotent; safe to call before encode, decode, describe, or run.
+     * @category Environment
+     */
+    async ensureBoundExtensionsRegistered() {
+        await ensureBoundExtensions(this.extensionBindings, this.registry);
+    }
+    /** Environment id (for utility operations). @category Environment */
+    getEnvId() {
+        return this.envId;
+    }
+    /** Environment label when set. @category Environment */
+    getEnvLabel() {
+        return this.envLabel;
+    }
+    /**
+     * Initialize environment for operational use and return an {@link Ecp} instance.
+     * @category Environment
+     */
+    async init() {
+        await this.prepareForRun();
+        return new EcpImpl(this);
+    }
+    /** @internal {@link EcpImpl} — describe. */
+    async ecpDescribe(query) {
+        await this.prepareForDiscovery();
+        return buildDescriptor(this.registry, this.compile(), query);
+    }
+    /** @internal {@link EcpImpl} — search. */
+    async ecpSearch(query, options) {
+        const descriptor = await this.ecpDescribe();
+        return searchCapabilities(query, descriptor, options);
+    }
+    /** @internal {@link EcpImpl} — validate. */
+    async ecpValidate(workflow) {
+        if (workflow) {
+            await this.prepareForRun();
+            return validateEnvironmentWithWorkflow(workflow, await this.ecpDescribe(), this.resolveBindings());
+        }
+        await this.prepareForDiscovery();
+        if (this.harnessBindings.length === 0) {
+            return {
+                schema: "@executioncontrolprotocol.validation.result",
+                version: LATEST_ECP_VERSION,
+                valid: true,
+                errors: [],
+                warnings: [],
+            };
+        }
+        await this.prepareForRun();
+        return validateHarnessBindings(this.registry, this.resolveBindings());
+    }
+    /** @internal {@link EcpImpl} — terminate. */
+    async ecpTerminate() {
+        await this.emitEnvironmentEvent("environment:terminate");
+        this.invalidatePrepared();
+    }
+    /** @internal {@link EcpImpl} — invoke. */
+    ecpInvoke(capabilityId) {
+        return createInvokeBuilder(this, capabilityId);
+    }
+    /** @internal {@link EcpImpl} — run. */
+    async ecpRun(workflow, options) {
+        await this.prepareForRun();
+        const validation = await validateEnvironmentWithWorkflow(workflow, await this.ecpDescribe(), this.resolveBindings());
+        if (!validation.valid) {
+            throw new Error(`Workflow validation failed: ${validation.errors.map((e) => e.message).join("; ")}`);
+        }
+        if (options?.dryRun) {
+            return {
+                schema: "@executioncontrolprotocol.run.result",
+                version: LATEST_ECP_VERSION,
+                run: { id: "dry-run", status: "completed" },
+                state: options.input ?? {},
+            };
+        }
+        await this.emitEnvironmentEvent("environment:beforeRun");
+        const bindings = this.resolveBindings();
+        const rtDef = this.registry.getRuntime(bindings.runtime.id);
+        const executor = rtDef.executor;
+        return executor.execute(workflow, {
+            runId: globalThis.crypto.randomUUID(),
+            input: options?.input ?? {},
+            registry: this.registry,
+            bindings,
+            signal: options?.signal,
+        });
+    }
+}
+/**
+ * Create an ECP environment (no default runtime; bind with `.withRuntime(...)`).
+ * @category Environment
+ */
+export function environment(id, label, registry = globalRegistry) {
+    return new Environment(id, label, undefined, [], [], [], registry);
+}
+//# sourceMappingURL=environment.js.map

package/dist/environment/environment.js.map

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

package/dist/environment/search.d.ts

@@ -0,0 +1,4 @@
+import type { EnvironmentDescriptor, SearchOptions, SearchResult } from "@executioncontrolprotocol/types";
+/** Fuzzy search over environment descriptor sections. */
+export declare function searchCapabilities(query: string, descriptor: EnvironmentDescriptor, options?: SearchOptions): SearchResult;
+//# sourceMappingURL=search.d.ts.map

package/dist/environment/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/environment/search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,aAAa,EAAE,YAAY,EAAoB,MAAM,iCAAiC,CAAA;AAgB3H,yDAAyD;AACzD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,qBAAqB,EACjC,OAAO,CAAC,EAAE,aAAa,GACtB,YAAY,CAiEd"}