@executioncontrolprotocol/core 0.10.0

package/dist/encoding/strip-harness-typescript-output.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Normalize model text before compiling harness TypeScript (workflow, intent, reply).
+ * Strips markdown fences, a lone leading "typescript" line, and common trailing typos.
+ * @category Encoding
+ */
+export declare function stripHarnessTypeScriptOutput(text: string): string;
+//# sourceMappingURL=strip-harness-typescript-output.d.ts.map

package/dist/encoding/strip-harness-typescript-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-harness-typescript-output.d.ts","sourceRoot":"","sources":["../../src/encoding/strip-harness-typescript-output.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAgCjE"}

package/dist/encoding/strip-harness-typescript-output.js

@@ -0,0 +1,40 @@
+import { stripMarkdownCodeFences } from "./strip-markdown-fences.js";
+const FORMAT_LANGUAGE_LINE = /^(?:typescript|ts|javascript|js)$/i;
+const TYPESCRIPT_FENCE = /^```(?:typescript|ts)\s*$/i;
+/**
+ * Normalize model text before compiling harness TypeScript (workflow, intent, reply).
+ * Strips markdown fences, a lone leading "typescript" line, and common trailing typos.
+ * @category Encoding
+ */
+export function stripHarnessTypeScriptOutput(text) {
+    let trimmed = stripMarkdownCodeFences(text).trim();
+    const wholeTs = /^```(?:typescript|ts)\s*\r?\n?([\s\S]*?)\r?\n?```$/i.exec(trimmed);
+    if (wholeTs) {
+        trimmed = wholeTs[1].trim();
+    }
+    else {
+        const blockTs = /```(?:typescript|ts)\s*\r?\n([\s\S]*?)\r?\n```/i.exec(trimmed);
+        if (blockTs) {
+            trimmed = blockTs[1].trim();
+        }
+        else {
+            const lines = trimmed.split(/\r?\n/);
+            if (TYPESCRIPT_FENCE.test(lines[0] ?? "")) {
+                lines.shift();
+                while (lines.length > 0 && /^```\s*$/.test(lines[lines.length - 1] ?? "")) {
+                    lines.pop();
+                }
+                trimmed = lines.join("\n").trim();
+            }
+        }
+    }
+    const lines = trimmed.split(/\r?\n/);
+    while (lines.length > 0 && FORMAT_LANGUAGE_LINE.test(lines[0].trim())) {
+        lines.shift();
+    }
+    trimmed = lines.join("\n").trim();
+    trimmed = trimmed.replace(/\]\s*\)\s*;\s*\)\s*:\s*\)\s*;?\s*$/s, "]);");
+    trimmed = trimmed.replace(/\]\s*\)\s*;\s*\)\s*:/g, "]);");
+    return trimmed;
+}
+//# sourceMappingURL=strip-harness-typescript-output.js.map

package/dist/encoding/strip-harness-typescript-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-harness-typescript-output.js","sourceRoot":"","sources":["../../src/encoding/strip-harness-typescript-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA;AAEpE,MAAM,oBAAoB,GAAG,oCAAoC,CAAA;AACjE,MAAM,gBAAgB,GAAG,4BAA4B,CAAA;AAErD;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAAC,IAAY;IACvD,IAAI,OAAO,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAA;IAElD,MAAM,OAAO,GAAG,qDAAqD,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACnF,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IAC7B,CAAC;SAAM,CAAC;QACN,MAAM,OAAO,GAAG,iDAAiD,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC/E,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QAC7B,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YACpC,IAAI,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;gBAC1C,KAAK,CAAC,KAAK,EAAE,CAAA;gBACb,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;oBAC1E,KAAK,CAAC,GAAG,EAAE,CAAA;gBACb,CAAC;gBACD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAA;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACpC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QACvE,KAAK,CAAC,KAAK,EAAE,CAAA;IACf,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAA;IAEjC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,qCAAqC,EAAE,KAAK,CAAC,CAAA;IACvE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAA;IAEzD,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/encoding/strip-markdown-fences.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Strip common markdown code fences from text before format decode.
+ * @category Encoding
+ */
+export declare function stripMarkdownCodeFences(text: string): string;
+//# sourceMappingURL=strip-markdown-fences.d.ts.map

package/dist/encoding/strip-markdown-fences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-markdown-fences.d.ts","sourceRoot":"","sources":["../../src/encoding/strip-markdown-fences.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAkB5D"}

package/dist/encoding/strip-markdown-fences.js

@@ -0,0 +1,23 @@
+/**
+ * Strip common markdown code fences from text before format decode.
+ * @category Encoding
+ */
+export function stripMarkdownCodeFences(text) {
+    const trimmed = text.trim();
+    const whole = /^```(?:json|toon|yaml)?\s*\r?\n?([\s\S]*?)\r?\n?```$/i.exec(trimmed);
+    if (whole)
+        return whole[1].trim();
+    const block = /```(?:json|toon|yaml)?\s*\r?\n([\s\S]*?)\r?\n```/i.exec(trimmed);
+    if (block)
+        return block[1].trim();
+    const lines = trimmed.split(/\r?\n/);
+    if (/^```(?:json|toon|yaml)?\s*$/i.test(lines[0] ?? "")) {
+        lines.shift();
+        while (lines.length > 0 && /^```\s*$/.test(lines[lines.length - 1] ?? "")) {
+            lines.pop();
+        }
+        return lines.join("\n").trim();
+    }
+    return trimmed;
+}
+//# sourceMappingURL=strip-markdown-fences.js.map

package/dist/encoding/strip-markdown-fences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-markdown-fences.js","sourceRoot":"","sources":["../../src/encoding/strip-markdown-fences.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IAC3B,MAAM,KAAK,GAAG,uDAAuD,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACnF,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IAEjC,MAAM,KAAK,GAAG,mDAAmD,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC/E,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IAEjC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACpC,IAAI,8BAA8B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,KAAK,CAAC,KAAK,EAAE,CAAA;QACb,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAC1E,KAAK,CAAC,GAAG,EAAE,CAAA;QACb,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAA;IAChC,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/encoding/utility-context.d.ts

@@ -0,0 +1,29 @@
+import type { Registry } from "../registry/registry.js";
+import type { Logger, UsageLedger } from "../runtime/context.js";
+import type { StoreContext } from "../runtime/store.js";
+/** Limited context for utility capabilities (encode/decode). @category Encoding */
+export interface UtilityCapabilityContext {
+    /** Environment identity. */
+    environment: {
+        /** Environment id. */
+        id: string;
+        /** Optional label. */
+        label?: string;
+    };
+    /** Definition registry. */
+    registry: Registry;
+    /** Logger instance. */
+    logger: Logger;
+    /** Usage ledger (no-op accumulation for utilities). */
+    usage: UsageLedger;
+    /** Unavailable store — utilities must not mutate workflow state. */
+    store: StoreContext;
+}
+/** Store that rejects workflow state access from utility capabilities. @category Encoding */
+export declare function createUnavailableStoreContext(): StoreContext;
+/**
+ * Build utility context for an environment encode/decode operation.
+ * @category Encoding
+ */
+export declare function createUtilityCapabilityContext(envId: string, envLabel: string | undefined, registry: Registry): UtilityCapabilityContext;
+//# sourceMappingURL=utility-context.d.ts.map

package/dist/encoding/utility-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility-context.d.ts","sourceRoot":"","sources":["../../src/encoding/utility-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAGvD,mFAAmF;AACnF,MAAM,WAAW,wBAAwB;IACvC,4BAA4B;IAC5B,WAAW,EAAE;QACX,sBAAsB;QACtB,EAAE,EAAE,MAAM,CAAA;QACV,sBAAsB;QACtB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;IACD,2BAA2B;IAC3B,QAAQ,EAAE,QAAQ,CAAA;IAClB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,uDAAuD;IACvD,KAAK,EAAE,WAAW,CAAA;IAClB,oEAAoE;IACpE,KAAK,EAAE,YAAY,CAAA;CACpB;AAQD,6FAA6F;AAC7F,wBAAgB,6BAA6B,IAAI,YAAY,CAW5D;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,EAAE,QAAQ,GACjB,wBAAwB,CAQ1B"}

package/dist/encoding/utility-context.js

@@ -0,0 +1,33 @@
+import { createUsageLedger } from "../runtime/context.js";
+const noopLogger = {
+    info: () => undefined,
+    warn: () => undefined,
+    error: () => undefined,
+};
+/** Store that rejects workflow state access from utility capabilities. @category Encoding */
+export function createUnavailableStoreContext() {
+    const err = () => {
+        throw new Error("Utility capabilities cannot read or mutate workflow state.");
+    };
+    return {
+        read: async () => err(),
+        set: async () => err(),
+        replace: async () => err(),
+        merge: async () => err(),
+        append: async () => err(),
+    };
+}
+/**
+ * Build utility context for an environment encode/decode operation.
+ * @category Encoding
+ */
+export function createUtilityCapabilityContext(envId, envLabel, registry) {
+    return {
+        environment: { id: envId, label: envLabel },
+        registry,
+        logger: noopLogger,
+        usage: createUsageLedger(),
+        store: createUnavailableStoreContext(),
+    };
+}
+//# sourceMappingURL=utility-context.js.map

package/dist/encoding/utility-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility-context.js","sourceRoot":"","sources":["../../src/encoding/utility-context.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAqBzD,MAAM,UAAU,GAAW;IACzB,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;IACrB,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;IACrB,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;CACvB,CAAA;AAED,6FAA6F;AAC7F,MAAM,UAAU,6BAA6B;IAC3C,MAAM,GAAG,GAAG,GAAG,EAAE;QACf,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAA;IAC/E,CAAC,CAAA;IACD,OAAO;QACL,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,GAAG,EAAE;QACvB,GAAG,EAAE,KAAK,IAAI,EAAE,CAAC,GAAG,EAAE;QACtB,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,GAAG,EAAE;QAC1B,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,GAAG,EAAE;QACxB,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,GAAG,EAAE;KAC1B,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAC5C,KAAa,EACb,QAA4B,EAC5B,QAAkB;IAElB,OAAO;QACL,WAAW,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE;QAC3C,QAAQ;QACR,MAAM,EAAE,UAAU;QAClB,KAAK,EAAE,iBAAiB,EAAE;QAC1B,KAAK,EAAE,6BAA6B,EAAE;KACvC,CAAA;AACH,CAAC"}

package/dist/environment/bindings.d.ts

@@ -0,0 +1,69 @@
+import type { CapabilityId, HarnessId, NamespacedId } from "@executioncontrolprotocol/types";
+import type { HookDefinition } from "../definitions/types.js";
+import { type EnvironmentConfigResolver } from "./config-resolver.js";
+/** Resolved runtime binding. */
+export interface ResolvedRuntimeBinding {
+    id: NamespacedId;
+    label?: string;
+    config: Record<string, unknown>;
+}
+/** Resolved extension binding. */
+export interface ResolvedExtensionBinding {
+    id: NamespacedId;
+    label?: string;
+    order: number;
+    config: Record<string, unknown>;
+}
+/** Resolved policy binding. */
+export interface ResolvedPolicyBinding {
+    id: NamespacedId;
+    label?: string;
+    order: number;
+    config: Record<string, unknown>;
+}
+/** Resolved harness binding. */
+export interface ResolvedHarnessBinding {
+    id: HarnessId;
+    label?: string;
+    uses: CapabilityId;
+    config: Record<string, unknown>;
+}
+/** All resolved bindings for execution. */
+export interface ResolvedBindings {
+    runtime: ResolvedRuntimeBinding;
+    extensions: ResolvedExtensionBinding[];
+    policies: ResolvedPolicyBinding[];
+    harnesses: ResolvedHarnessBinding[];
+    extensionHooks: HookDefinition[];
+    policyHooks: Array<{
+        hook: HookDefinition;
+        config: Record<string, unknown>;
+    }>;
+}
+/** Unresolved config for environment manifests (keeps `$env` placeholders). */
+export declare function manifestConfig(config: Record<string, unknown>): Record<string, unknown>;
+/** Resolve bindings for execution using the config resolver chain. */
+export declare function resolveBindingsForRun(runtimeBinding: {
+    id: NamespacedId;
+    label?: string;
+    rawConfig: Record<string, unknown>;
+}, extensionBindings: Array<{
+    id: NamespacedId;
+    label?: string;
+    order: number;
+    rawConfig: Record<string, unknown>;
+}>, policyBindings: Array<{
+    id: NamespacedId;
+    label?: string;
+    order: number;
+    rawConfig: Record<string, unknown>;
+}>, harnessBindings: Array<{
+    id: HarnessId;
+    label?: string;
+    uses: CapabilityId;
+    rawConfig: Record<string, unknown>;
+}>, extensionHooks: HookDefinition[], policyHooks: Array<{
+    hook: HookDefinition;
+    config: Record<string, unknown>;
+}>, resolvers: EnvironmentConfigResolver[]): Promise<ResolvedBindings>;
+//# sourceMappingURL=bindings.d.ts.map

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

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

package/dist/environment/bindings.js

@@ -0,0 +1,39 @@
+import { cloneConfigForManifest, resolveEnvConfigAsync, } from "./config-resolver.js";
+/** Unresolved config for environment manifests (keeps `$env` placeholders). */
+export function manifestConfig(config) {
+    return cloneConfigForManifest(config);
+}
+/** Resolve bindings for execution using the config resolver chain. */
+export async function resolveBindingsForRun(runtimeBinding, extensionBindings, policyBindings, harnessBindings, extensionHooks, policyHooks, resolvers) {
+    return {
+        runtime: {
+            id: runtimeBinding.id,
+            label: runtimeBinding.label,
+            config: await resolveEnvConfigAsync(runtimeBinding.rawConfig, resolvers),
+        },
+        extensions: await Promise.all(extensionBindings.map(async (b) => ({
+            id: b.id,
+            label: b.label,
+            order: b.order,
+            config: await resolveEnvConfigAsync(b.rawConfig, resolvers),
+        }))),
+        policies: await Promise.all(policyBindings.map(async (b) => ({
+            id: b.id,
+            label: b.label,
+            order: b.order,
+            config: await resolveEnvConfigAsync(b.rawConfig, resolvers),
+        }))),
+        harnesses: await Promise.all(harnessBindings.map(async (b) => ({
+            id: b.id,
+            label: b.label,
+            uses: b.uses,
+            config: await resolveEnvConfigAsync(b.rawConfig, resolvers),
+        }))),
+        extensionHooks,
+        policyHooks: await Promise.all(policyHooks.map(async (p) => ({
+            hook: p.hook,
+            config: await resolveEnvConfigAsync(p.config, resolvers),
+        }))),
+    };
+}
+//# sourceMappingURL=bindings.js.map

package/dist/environment/bindings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindings.js","sourceRoot":"","sources":["../../src/environment/bindings.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GAEtB,MAAM,sBAAsB,CAAA;AA2C7B,+EAA+E;AAC/E,MAAM,UAAU,cAAc,CAAC,MAA+B;IAC5D,OAAO,sBAAsB,CAAC,MAAM,CAAC,CAAA;AACvC,CAAC;AAED,sEAAsE;AACtE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,cAIC,EACD,iBAKE,EACF,cAKE,EACF,eAKE,EACF,cAAgC,EAChC,WAA6E,EAC7E,SAAsC;IAEtC,OAAO;QACL,OAAO,EAAE;YACP,EAAE,EAAE,cAAc,CAAC,EAAE;YACrB,KAAK,EAAE,cAAc,CAAC,KAAK;YAC3B,MAAM,EAAE,MAAM,qBAAqB,CAAC,cAAc,CAAC,SAAS,EAAE,SAAS,CAAC;SACzE;QACD,UAAU,EAAE,MAAM,OAAO,CAAC,GAAG,CAC3B,iBAAiB,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YAClC,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,MAAM,qBAAqB,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC;SAC5D,CAAC,CAAC,CACJ;QACD,QAAQ,EAAE,MAAM,OAAO,CAAC,GAAG,CACzB,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/B,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,MAAM,qBAAqB,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC;SAC5D,CAAC,CAAC,CACJ;QACD,SAAS,EAAE,MAAM,OAAO,CAAC,GAAG,CAC1B,eAAe,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YAChC,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,MAAM,EAAE,MAAM,qBAAqB,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC;SAC5D,CAAC,CAAC,CACJ;QACD,cAAc;QACd,WAAW,EAAE,MAAM,OAAO,CAAC,GAAG,CAC5B,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,MAAM,EAAE,MAAM,qBAAqB,CAAC,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC;SACzD,CAAC,CAAC,CACJ;KACF,CAAA;AACH,CAAC"}

package/dist/environment/config-resolver.d.ts

@@ -0,0 +1,33 @@
+/** Extension id for process environment resolution. @category Environment */
+export declare const PROCESS_ENV_RESOLVER_ID = "@executioncontrolprotocol/process-env";
+/** Extension id for OS secrets resolution. @category Environment */
+export declare const SECRETS_RESOLVER_ID = "@executioncontrolprotocol/secrets";
+/** Extension id for browser encrypted secrets resolution. @category Environment */
+export declare const BROWSER_SECRETS_RESOLVER_ID = "@executioncontrolprotocol/browser-secrets";
+/** Resolves `env("KEY")` and `secrets("KEY")` values for environment bindings. @category Environment */
+export interface EnvironmentConfigResolver {
+    /** Resolver identifier (e.g. extension id). */
+    id: string;
+    /** Resolve a config key name to a value, or undefined if not handled. */
+    resolve(name: string): Promise<unknown> | unknown;
+}
+/** Options when resolving a single config key. @category Environment */
+export interface ResolveEnvNameOptions {
+    optional?: boolean;
+    fallback?: unknown;
+}
+/**
+ * Resolve a key using a specific extension resolver.
+ * @category Environment
+ */
+export declare function resolveConfigName(name: string, resolvers: EnvironmentConfigResolver[], options?: ResolveEnvNameOptions & {
+    resolverId?: string;
+}): Promise<unknown>;
+/**
+ * Resolve `$env`, `$secret`, and `$browser` placeholders in a config object using extension resolvers.
+ * @category Environment
+ */
+export declare function resolveEnvConfigAsync(config: Record<string, unknown>, resolvers: EnvironmentConfigResolver[]): Promise<Record<string, unknown>>;
+/** Copy config for manifests without resolving secrets. @category Environment */
+export declare function cloneConfigForManifest(config: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=config-resolver.d.ts.map

package/dist/environment/config-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-resolver.d.ts","sourceRoot":"","sources":["../../src/environment/config-resolver.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,eAAO,MAAM,uBAAuB,0CAA0C,CAAA;AAE9E,oEAAoE;AACpE,eAAO,MAAM,mBAAmB,sCAAsC,CAAA;AAEtE,mFAAmF;AACnF,eAAO,MAAM,2BAA2B,8CAA8C,CAAA;AActF,wGAAwG;AACxG,MAAM,WAAW,yBAAyB;IACxC,+CAA+C;IAC/C,EAAE,EAAE,MAAM,CAAA;IACV,yEAAyE;IACzE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAA;CAClD;AAED,wEAAwE;AACxE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AASD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,yBAAyB,EAAE,EACtC,OAAO,CAAC,EAAE,qBAAqB,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACxD,OAAO,CAAC,OAAO,CAAC,CAkBlB;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,EAAE,yBAAyB,EAAE,GACrC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAMlC;AA2CD,iFAAiF;AACjF,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzB"}

package/dist/environment/config-resolver.js

@@ -0,0 +1,100 @@
+/** Extension id for process environment resolution. @category Environment */
+export const PROCESS_ENV_RESOLVER_ID = "@executioncontrolprotocol/process-env";
+/** Extension id for OS secrets resolution. @category Environment */
+export const SECRETS_RESOLVER_ID = "@executioncontrolprotocol/secrets";
+/** Extension id for browser encrypted secrets resolution. @category Environment */
+export const BROWSER_SECRETS_RESOLVER_ID = "@executioncontrolprotocol/browser-secrets";
+/** Resolvers excluded from the `$env` fallback chain. @category Environment */
+const ENV_CHAIN_EXCLUDED_RESOLVER_IDS = new Set([
+    SECRETS_RESOLVER_ID,
+    BROWSER_SECRETS_RESOLVER_ID,
+]);
+function resolverErrorLabel(resolverId) {
+    if (resolverId === SECRETS_RESOLVER_ID)
+        return "Secret";
+    if (resolverId === BROWSER_SECRETS_RESOLVER_ID)
+        return "Browser secret";
+    return "Environment variable";
+}
+function findResolver(resolvers, id) {
+    return resolvers.find((r) => r.id === id);
+}
+/**
+ * Resolve a key using a specific extension resolver.
+ * @category Environment
+ */
+export async function resolveConfigName(name, resolvers, options) {
+    const resolverId = options?.resolverId;
+    if (resolverId) {
+        const resolver = findResolver(resolvers, resolverId);
+        if (resolver) {
+            const value = await resolver.resolve(name);
+            if (value !== undefined)
+                return value;
+        }
+        if (options?.optional)
+            return options.fallback;
+        throw new Error(`${resolverErrorLabel(resolverId)} ${name} is not set`);
+    }
+    for (const resolver of resolvers) {
+        const value = await resolver.resolve(name);
+        if (value !== undefined)
+            return value;
+    }
+    if (options?.optional)
+        return options.fallback;
+    throw new Error(`Environment variable ${name} is not set`);
+}
+/**
+ * Resolve `$env`, `$secret`, and `$browser` placeholders in a config object using extension resolvers.
+ * @category Environment
+ */
+export async function resolveEnvConfigAsync(config, resolvers) {
+    const out = {};
+    for (const [k, v] of Object.entries(config)) {
+        out[k] = await resolveEnvValueAsync(v, resolvers);
+    }
+    return out;
+}
+async function resolveEnvValueAsync(v, resolvers) {
+    if (v !== null && typeof v === "object" && "$env" in v) {
+        const e = v;
+        const envResolvers = resolvers.filter((r) => !ENV_CHAIN_EXCLUDED_RESOLVER_IDS.has(r.id));
+        return resolveConfigName(e.$env, envResolvers, {
+            optional: e.optional,
+            fallback: e.fallback,
+        });
+    }
+    if (v !== null && typeof v === "object" && "$secret" in v) {
+        const s = v;
+        return resolveConfigName(s.$secret, resolvers, {
+            optional: s.optional,
+            fallback: s.fallback,
+            resolverId: SECRETS_RESOLVER_ID,
+        });
+    }
+    if (v !== null && typeof v === "object" && "$browser" in v) {
+        const b = v;
+        return resolveConfigName(b.$browser, resolvers, {
+            optional: b.optional,
+            fallback: b.fallback,
+            resolverId: BROWSER_SECRETS_RESOLVER_ID,
+        });
+    }
+    if (Array.isArray(v)) {
+        return Promise.all(v.map((item) => resolveEnvValueAsync(item, resolvers)));
+    }
+    if (v !== null && typeof v === "object") {
+        const o = {};
+        for (const [k, c] of Object.entries(v)) {
+            o[k] = await resolveEnvValueAsync(c, resolvers);
+        }
+        return o;
+    }
+    return v;
+}
+/** Copy config for manifests without resolving secrets. @category Environment */
+export function cloneConfigForManifest(config) {
+    return structuredClone(config);
+}
+//# sourceMappingURL=config-resolver.js.map

package/dist/environment/config-resolver.js.map

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

package/dist/environment/describe.d.ts

@@ -0,0 +1,6 @@
+import type { DescribeQuery, EnvironmentDescriptor } from "@executioncontrolprotocol/types";
+import type { Registry } from "../registry/registry.js";
+import type { EnvironmentManifest } from "@executioncontrolprotocol/types";
+/** Build environment descriptor from registry + bindings. */
+export declare function buildDescriptor(registry: Registry, manifest: EnvironmentManifest, query?: DescribeQuery): Promise<EnvironmentDescriptor>;
+//# sourceMappingURL=describe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../../src/environment/describe.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,aAAa,EAEb,qBAAqB,EAGtB,MAAM,iCAAiC,CAAA;AACxC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AA2C1E,6DAA6D;AAC7D,wBAAsB,eAAe,CACnC,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,mBAAmB,EAC7B,KAAK,CAAC,EAAE,aAAa,GACpB,OAAO,CAAC,qBAAqB,CAAC,CAiGhC"}

package/dist/environment/describe.js

@@ -0,0 +1,132 @@
+import { LATEST_ECP_VERSION } from "@executioncontrolprotocol/types";
+function fuzzyMatch(haystack, needle) {
+    return haystack.toLowerCase().includes(needle.toLowerCase());
+}
+function tokenMatchScore(text, query) {
+    const tokens = query.toLowerCase().split(/\s+/).filter(Boolean);
+    if (tokens.length === 0)
+        return 0;
+    const hay = text.toLowerCase();
+    let matched = 0;
+    for (const t of tokens) {
+        if (hay.includes(t))
+            matched++;
+    }
+    return matched / tokens.length;
+}
+function matchesSelection(text, id, selection) {
+    if (!selection?.match)
+        return true;
+    const mode = selection.mode ?? "fuzzy";
+    if (mode === "exact")
+        return id === selection.match;
+    if (mode === "partial")
+        return fuzzyMatch(text, selection.match);
+    return fuzzyMatch(text, selection.match) || tokenMatchScore(text, selection.match) > 0;
+}
+function pickFields(obj, include) {
+    if (!include || include.length === 0)
+        return obj;
+    const out = {};
+    for (const key of include) {
+        if (key in obj)
+            out[key] = obj[key];
+    }
+    return out;
+}
+function applyLimit(items, limit) {
+    if (limit === undefined)
+        return items;
+    return items.slice(0, limit);
+}
+/** Build environment descriptor from registry + bindings. */
+export async function buildDescriptor(registry, manifest, query) {
+    const caps = [];
+    for (const extBinding of manifest.extensions ?? []) {
+        const def = registry.getExtension(String(extBinding.id));
+        if (!def)
+            continue;
+        for (const cap of def.capabilities) {
+            const text = `${cap.id} ${cap.name}`;
+            if (!matchesSelection(text, cap.id, query?.capabilities))
+                continue;
+            const desc = {
+                id: cap.id,
+                label: cap.name,
+                extension: def.id,
+                inputSchema: cap.inputSchema,
+                outputSchema: cap.outputSchema,
+            };
+            caps.push(pickFields(desc, query?.capabilities?.include));
+        }
+    }
+    const extensions = applyLimit((manifest.extensions ?? [])
+        .map((e, i) => {
+        const def = registry.getExtension(String(e.id));
+        const text = `${e.id} ${e.label ?? ""} ${def?.name ?? ""}`;
+        if (!matchesSelection(text, String(e.id), query?.extensions))
+            return null;
+        const desc = {
+            id: String(e.id),
+            label: e.label,
+            order: e.order ?? i,
+            capabilities: def?.capabilities.map((c) => c.id) ?? [],
+            ...(def?.supportedRuntimes?.length
+                ? { supportedRuntimes: [...def.supportedRuntimes] }
+                : {}),
+        };
+        return pickFields(desc, query?.extensions?.include);
+    })
+        .filter((x) => x !== null), query?.extensions?.limit);
+    const policies = applyLimit((manifest.policies ?? [])
+        .map((p) => {
+        const def = registry.getPolicy(String(p.id));
+        const text = `${p.id} ${p.label ?? ""} ${def?.name ?? ""}`;
+        if (!matchesSelection(text, String(p.id), query?.policies))
+            return null;
+        const desc = {
+            id: String(p.id),
+            label: p.label,
+            summary: def?.name,
+            config: p.config,
+            configSchema: def?.configSchema,
+        };
+        return pickFields(desc, query?.policies?.include);
+    })
+        .filter((x) => x !== null), query?.policies?.limit);
+    const runtimeId = String(manifest.runtime?.id ?? "@executioncontrolprotocol/node");
+    const runtimeLabel = manifest.runtime?.label;
+    const runtimeText = `${runtimeId} ${runtimeLabel ?? ""}`;
+    const includeRuntime = !query?.runtime?.match || matchesSelection(runtimeText, runtimeId, query.runtime);
+    return {
+        schema: "@executioncontrolprotocol.environment.describe",
+        version: LATEST_ECP_VERSION,
+        environment: manifest.environment,
+        runtime: includeRuntime
+            ? {
+                id: runtimeId,
+                label: runtimeLabel,
+                features: {
+                    loops: true,
+                    parallel: true,
+                    branches: true,
+                    pauses: true,
+                    cancellation: true,
+                },
+            }
+            : {
+                id: runtimeId,
+                features: {
+                    loops: false,
+                    parallel: false,
+                    branches: false,
+                    pauses: false,
+                    cancellation: false,
+                },
+            },
+        extensions,
+        capabilities: applyLimit(caps, query?.capabilities?.limit),
+        policies,
+    };
+}
+//# sourceMappingURL=describe.js.map

package/dist/environment/describe.js.map

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