@executioncontrolprotocol/core 0.12.0 → 0.13.0

package/dist/media/write-media.js

@@ -0,0 +1,46 @@
+import { FILE_REF_KINDS } from "@executioncontrolprotocol/types";
+import { defaultArtifactFilename } from "./artifact-filename.js";
+import { STORAGE_ARTIFACT_URI_PREFIX, } from "./resolve-file.js";
+/**
+ * Write bytes into the host artifact store (or durable storage) and return an artifact {@link FileRef}.
+ * @category Media
+ */
+export async function writeMediaArtifact(data, options, ctx) {
+    const cfg = ctx.extensionConfig ?? {};
+    const storage = cfg.storage ?? {};
+    const prefix = options.prefix ?? storage.outputPrefix ?? "artifacts/media";
+    const name = options.name ?? defaultArtifactFilename(options.mediaType);
+    const uri = `ecp://${prefix}/${name}`;
+    if (options.store === "storage" || storage.defaultStore === "storage") {
+        const key = `${prefix}/${name}`;
+        await ctx.capabilities.call("@executioncontrolprotocol/storage.write", {
+            key,
+            value: data,
+        });
+        return {
+            kind: FILE_REF_KINDS.ARTIFACT,
+            uri: `${STORAGE_ARTIFACT_URI_PREFIX}${key}`,
+            mediaType: options.mediaType,
+            name,
+            sizeBytes: data.byteLength,
+        };
+    }
+    if (!ctx.artifacts) {
+        throw new Error("No artifact store on capability context. Ensure the runtime wires ctx.artifacts (env.ensureArtifactStore).");
+    }
+    const bytes = data instanceof Uint8Array ? data : new Uint8Array(data);
+    ctx.artifacts.set(uri, {
+        mediaType: options.mediaType,
+        name,
+        size: bytes.byteLength,
+        bytes,
+    });
+    return {
+        kind: FILE_REF_KINDS.ARTIFACT,
+        uri,
+        mediaType: options.mediaType,
+        name,
+        sizeBytes: bytes.byteLength,
+    };
+}
+//# sourceMappingURL=write-media.js.map

package/dist/media/write-media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-media.js","sourceRoot":"","sources":["../../src/media/write-media.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAgB,MAAM,iCAAiC,CAAA;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,EACL,2BAA2B,GAE5B,MAAM,mBAAmB,CAAA;AAc1B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAgB,EAChB,OAAkC,EAClC,GAA0B;IAE1B,MAAM,GAAG,GAAG,GAAG,CAAC,eAAe,IAAI,EAAE,CAAA;IACrC,MAAM,OAAO,GAAI,GAAG,CAAC,OAAwE,IAAI,EAAE,CAAA;IACnG,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,YAAY,IAAI,iBAAiB,CAAA;IAC1E,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,uBAAuB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IACvE,MAAM,GAAG,GAAG,SAAS,MAAM,IAAI,IAAI,EAAE,CAAA;IAErC,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACtE,MAAM,GAAG,GAAG,GAAG,MAAM,IAAI,IAAI,EAAE,CAAA;QAC/B,MAAM,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,yCAAyC,EAAE;YACrE,GAAG;YACH,KAAK,EAAE,IAAI;SACZ,CAAC,CAAA;QACF,OAAO;YACL,IAAI,EAAE,cAAc,CAAC,QAAQ;YAC7B,GAAG,EAAE,GAAG,2BAA2B,GAAG,GAAG,EAAE;YAC3C,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,UAAU;SAC3B,CAAA;IACH,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,4GAA4G,CAC7G,CAAA;IACH,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,YAAY,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAA;IACtE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE;QACrB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,IAAI;QACJ,IAAI,EAAE,KAAK,CAAC,UAAU;QACtB,KAAK;KACN,CAAC,CAAA;IAEF,OAAO;QACL,IAAI,EAAE,cAAc,CAAC,QAAQ;QAC7B,GAAG;QACH,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,IAAI;QACJ,SAAS,EAAE,KAAK,CAAC,UAAU;KAC5B,CAAA;AACH,CAAC"}

package/dist/patch/patch-document.d.ts

@@ -38,8 +38,8 @@ export declare const ecpPatchDocumentSchema: z.ZodObject<{
         mode?: "replace" | "merge" | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
-    version: string;
     schema: "@executioncontrolprotocol.patch";
+    version: string;
     targetSchema: string;
     patches: {
         path: string;
@@ -48,8 +48,8 @@ export declare const ecpPatchDocumentSchema: z.ZodObject<{
         mode?: "replace" | "merge" | undefined;
     }[];
 }, {
-    version: string;
     schema: "@executioncontrolprotocol.patch";
+    version: string;
     targetSchema: string;
     patches: {
         path: string;

package/dist/runtime/artifacts.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Host-side artifact bytes keyed by `ecp://…` URIs (invoke/run preview and hop outputs).
+ * @category Runtime
+ */
+/** Stored host artifact (bytes + metadata). @category Runtime */
+export interface CapabilityArtifact {
+    /** MIME type for HTTP / browser preview. */
+    readonly mediaType: string;
+    /** Optional display / download name. */
+    readonly name?: string;
+    /** Size in bytes. */
+    readonly size: number;
+    /** Artifact bytes. */
+    readonly bytes: Uint8Array;
+}
+/** Environment-scoped map of artifact URIs to bytes. @category Runtime */
+export interface CapabilityArtifactStore {
+    /** Look up a stored artifact. */
+    get(uri: string): CapabilityArtifact | undefined;
+    /** Store an artifact under its URI. */
+    set(uri: string, artifact: CapabilityArtifact): void;
+    /** Remove a URI. */
+    delete(uri: string): void;
+    /** Drop all artifacts. */
+    clear(): void;
+    /** Number of stored artifacts. */
+    size(): number;
+}
+/** In-memory {@link CapabilityArtifactStore}. @category Runtime */
+export declare function createCapabilityArtifactStore(): CapabilityArtifactStore;
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/runtime/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/runtime/artifacts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iEAAiE;AACjE,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,qBAAqB;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,sBAAsB;IACtB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAC3B;AAED,0EAA0E;AAC1E,MAAM,WAAW,uBAAuB;IACtC,iCAAiC;IACjC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAAA;IAChD,uCAAuC;IACvC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAA;IACpD,oBAAoB;IACpB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,0BAA0B;IAC1B,KAAK,IAAI,IAAI,CAAA;IACb,kCAAkC;IAClC,IAAI,IAAI,MAAM,CAAA;CACf;AAED,mEAAmE;AACnE,wBAAgB,6BAA6B,IAAI,uBAAuB,CAmBvE"}

package/dist/runtime/artifacts.js

@@ -0,0 +1,26 @@
+/**
+ * Host-side artifact bytes keyed by `ecp://…` URIs (invoke/run preview and hop outputs).
+ * @category Runtime
+ */
+/** In-memory {@link CapabilityArtifactStore}. @category Runtime */
+export function createCapabilityArtifactStore() {
+    const items = new Map();
+    return {
+        get(uri) {
+            return items.get(uri);
+        },
+        set(uri, artifact) {
+            items.set(uri, artifact);
+        },
+        delete(uri) {
+            items.delete(uri);
+        },
+        clear() {
+            items.clear();
+        },
+        size() {
+            return items.size;
+        },
+    };
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/runtime/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../src/runtime/artifacts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4BH,mEAAmE;AACnE,MAAM,UAAU,6BAA6B;IAC3C,MAAM,KAAK,GAAG,IAAI,GAAG,EAA8B,CAAA;IACnD,OAAO;QACL,GAAG,CAAC,GAAG;YACL,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACvB,CAAC;QACD,GAAG,CAAC,GAAG,EAAE,QAAQ;YACf,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;QAC1B,CAAC;QACD,MAAM,CAAC,GAAG;YACR,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACnB,CAAC;QACD,KAAK;YACH,KAAK,CAAC,KAAK,EAAE,CAAA;QACf,CAAC;QACD,IAAI;YACF,OAAO,KAAK,CAAC,IAAI,CAAA;QACnB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/runtime/blobs.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Locator prefix for files stashed in the browser run map.
+ * @category Runtime
+ */
+export declare const BROWSER_FILE_LOCATOR_PREFIX = "ecp://browser/";
+/** Browser-stashed file handle used by mixed upload handlers. @category Runtime */
+export interface CapabilityBlob {
+    /** Original file name when available. */
+    readonly name: string;
+    /** MIME type. */
+    readonly type: string;
+    /** Size in bytes. */
+    readonly size: number;
+    /** Read file bytes. */
+    arrayBuffer(): Promise<ArrayBuffer>;
+}
+/** Run-scoped map of browser file locators to blobs. @category Runtime */
+export interface CapabilityBlobStore {
+    /** Look up a stashed file. */
+    get(locator: string): CapabilityBlob | undefined;
+    /** Stash a file under a locator. */
+    set(locator: string, blob: CapabilityBlob): void;
+    /** Remove a locator. */
+    delete(locator: string): void;
+    /** Drop all locators. */
+    clear(): void;
+    /** Number of stashed files. */
+    size(): number;
+}
+/**
+ * Wire format for hopping browser blobs to a host invoke (transport only; not workflow state).
+ * @category Runtime
+ */
+export interface SerializedCapabilityBlob {
+    /** Original file name when available. */
+    name: string;
+    /** MIME type. */
+    type: string;
+    /** Size in bytes. */
+    size: number;
+    /** File bytes as base64 (invoke hop transport). */
+    dataBase64: string;
+}
+/** Whether a string is a browser file locator. @category Runtime */
+export declare function isBrowserFileLocator(value: string): boolean;
+/** Create a unique browser file locator. @category Runtime */
+export declare function createBrowserFileLocator(): string;
+/** In-memory {@link CapabilityBlobStore}. @category Runtime */
+export declare function createCapabilityBlobStore(): CapabilityBlobStore;
+/**
+ * Stash a blob and return its locator.
+ * @category Runtime
+ */
+export declare function stashCapabilityBlob(store: CapabilityBlobStore, blob: CapabilityBlob): string;
+/**
+ * Collect `ecp://browser/<id>` locators from an invoke/run payload.
+ * Walks nested objects/arrays, including {@link FileRef} `file.path` and
+ * `artifact.uri` when they hold browser locators.
+ * @category Runtime
+ */
+export declare function collectBrowserLocators(value: unknown, out?: string[]): string[];
+/**
+ * Serialize selected locators for a host invoke hop (bytes travel on the wire only).
+ * @category Runtime
+ */
+export declare function serializeCapabilityBlobs(store: CapabilityBlobStore, locators: string[]): Promise<Record<string, SerializedCapabilityBlob>>;
+/**
+ * Hydrate a blob store from hop transport payloads.
+ * @category Runtime
+ */
+export declare function hydrateCapabilityBlobs(store: CapabilityBlobStore, serialized: Record<string, SerializedCapabilityBlob>): void;
+//# sourceMappingURL=blobs.d.ts.map

package/dist/runtime/blobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blobs.d.ts","sourceRoot":"","sources":["../../src/runtime/blobs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,2BAA2B,mBAAmB,CAAA;AAE3D,mFAAmF;AACnF,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,iBAAiB;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,qBAAqB;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,uBAAuB;IACvB,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAA;CACpC;AAED,0EAA0E;AAC1E,MAAM,WAAW,mBAAmB;IAClC,8BAA8B;IAC9B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAA;IAChD,oCAAoC;IACpC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAAA;IAChD,wBAAwB;IACxB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,yBAAyB;IACzB,KAAK,IAAI,IAAI,CAAA;IACb,+BAA+B;IAC/B,IAAI,IAAI,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAA;IACZ,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,oEAAoE;AACpE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,8DAA8D;AAC9D,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED,+DAA+D;AAC/D,wBAAgB,yBAAyB,IAAI,mBAAmB,CAmB/D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,CAI5F;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE,CAcnF;AAwBD;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC,CAcnD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,mBAAmB,EAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,GACnD,IAAI,CAaN"}

package/dist/runtime/blobs.js

@@ -0,0 +1,129 @@
+/**
+ * Locator prefix for files stashed in the browser run map.
+ * @category Runtime
+ */
+export const BROWSER_FILE_LOCATOR_PREFIX = "ecp://browser/";
+/** Whether a string is a browser file locator. @category Runtime */
+export function isBrowserFileLocator(value) {
+    return value.startsWith(BROWSER_FILE_LOCATOR_PREFIX) && value.length > BROWSER_FILE_LOCATOR_PREFIX.length;
+}
+/** Create a unique browser file locator. @category Runtime */
+export function createBrowserFileLocator() {
+    return `${BROWSER_FILE_LOCATOR_PREFIX}${globalThis.crypto.randomUUID()}`;
+}
+/** In-memory {@link CapabilityBlobStore}. @category Runtime */
+export function createCapabilityBlobStore() {
+    const files = new Map();
+    return {
+        get(locator) {
+            return files.get(locator);
+        },
+        set(locator, blob) {
+            files.set(locator, blob);
+        },
+        delete(locator) {
+            files.delete(locator);
+        },
+        clear() {
+            files.clear();
+        },
+        size() {
+            return files.size;
+        },
+    };
+}
+/**
+ * Stash a blob and return its locator.
+ * @category Runtime
+ */
+export function stashCapabilityBlob(store, blob) {
+    const locator = createBrowserFileLocator();
+    store.set(locator, blob);
+    return locator;
+}
+/**
+ * Collect `ecp://browser/<id>` locators from an invoke/run payload.
+ * Walks nested objects/arrays, including {@link FileRef} `file.path` and
+ * `artifact.uri` when they hold browser locators.
+ * @category Runtime
+ */
+export function collectBrowserLocators(value, out = []) {
+    if (typeof value === "string") {
+        if (isBrowserFileLocator(value) && !out.includes(value))
+            out.push(value);
+        return out;
+    }
+    if (Array.isArray(value)) {
+        for (const item of value)
+            collectBrowserLocators(item, out);
+        return out;
+    }
+    if (value !== null && typeof value === "object") {
+        const row = value;
+        for (const child of Object.values(row))
+            collectBrowserLocators(child, out);
+    }
+    return out;
+}
+function bytesToBase64(bytes) {
+    if (typeof Buffer !== "undefined") {
+        return Buffer.from(bytes).toString("base64");
+    }
+    const chunk = 0x8000;
+    let binary = "";
+    for (let i = 0; i < bytes.length; i += chunk) {
+        binary += String.fromCharCode(...bytes.subarray(i, i + chunk));
+    }
+    return btoa(binary);
+}
+function base64ToBytes(dataBase64) {
+    if (typeof Buffer !== "undefined") {
+        return new Uint8Array(Buffer.from(dataBase64, "base64"));
+    }
+    const binary = atob(dataBase64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++)
+        bytes[i] = binary.charCodeAt(i);
+    return bytes;
+}
+/**
+ * Serialize selected locators for a host invoke hop (bytes travel on the wire only).
+ * @category Runtime
+ */
+export async function serializeCapabilityBlobs(store, locators) {
+    const out = {};
+    for (const locator of locators) {
+        const blob = store.get(locator);
+        if (!blob)
+            continue;
+        const bytes = new Uint8Array(await blob.arrayBuffer());
+        out[locator] = {
+            name: blob.name,
+            type: blob.type,
+            size: blob.size,
+            dataBase64: bytesToBase64(bytes),
+        };
+    }
+    return out;
+}
+/**
+ * Hydrate a blob store from hop transport payloads.
+ * @category Runtime
+ */
+export function hydrateCapabilityBlobs(store, serialized) {
+    for (const [locator, row] of Object.entries(serialized)) {
+        if (!isBrowserFileLocator(locator))
+            continue;
+        if (typeof row?.dataBase64 !== "string")
+            continue;
+        const bytes = base64ToBytes(row.dataBase64);
+        const copy = bytes.slice().buffer;
+        store.set(locator, {
+            name: typeof row.name === "string" ? row.name : "blob",
+            type: typeof row.type === "string" ? row.type : "application/octet-stream",
+            size: typeof row.size === "number" ? row.size : bytes.byteLength,
+            arrayBuffer: async () => copy,
+        });
+    }
+}
+//# sourceMappingURL=blobs.js.map

package/dist/runtime/blobs.js.map

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

package/dist/runtime/capability-execution.d.ts

@@ -0,0 +1,22 @@
+import type { CapabilityExecution } from "@executioncontrolprotocol/types";
+/** Extension shape needed to infer capability execution. @category Runtime */
+export interface ExecutionExtensionHint {
+    /** Runtimes this extension supports when restricted. */
+    supportedRuntimes?: readonly string[];
+}
+/** Capability shape needed to resolve execution. @category Runtime */
+export interface ExecutionCapabilityHint {
+    /** Explicit execution declaration. */
+    execution?: CapabilityExecution;
+}
+/**
+ * Resolve capability execution, defaulting from extension `supportedRuntimes`.
+ * Unrestricted capabilities default to **host**; browser-only extensions default to **local**.
+ * @category Runtime
+ */
+export declare function resolveCapabilityExecution(cap: ExecutionCapabilityHint, ext?: ExecutionExtensionHint): CapabilityExecution;
+/** Whether this runtime id is the browser host. @category Runtime */
+export declare function isBrowserRuntimeId(runtimeId: string): boolean;
+/** Whether this runtime id is the Node host. @category Runtime */
+export declare function isNodeRuntimeId(runtimeId: string): boolean;
+//# sourceMappingURL=capability-execution.d.ts.map

package/dist/runtime/capability-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-execution.d.ts","sourceRoot":"","sources":["../../src/runtime/capability-execution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AAG1E,8EAA8E;AAC9E,MAAM,WAAW,sBAAsB;IACrC,wDAAwD;IACxD,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACtC;AAED,sEAAsE;AACtE,MAAM,WAAW,uBAAuB;IACtC,sCAAsC;IACtC,SAAS,CAAC,EAAE,mBAAmB,CAAA;CAChC;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,uBAAuB,EAC5B,GAAG,CAAC,EAAE,sBAAsB,GAC3B,mBAAmB,CAMrB;AAED,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,kEAAkE;AAClE,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE1D"}

package/dist/runtime/capability-execution.js

@@ -0,0 +1,25 @@
+import { BROWSER_RUNTIME_ID, NODE_RUNTIME_ID } from "./runtime-ids.js";
+/**
+ * Resolve capability execution, defaulting from extension `supportedRuntimes`.
+ * Unrestricted capabilities default to **host**; browser-only extensions default to **local**.
+ * @category Runtime
+ */
+export function resolveCapabilityExecution(cap, ext) {
+    if (cap.execution)
+        return cap.execution;
+    const supported = ext?.supportedRuntimes;
+    if (supported?.length === 1 && supported[0] === NODE_RUNTIME_ID)
+        return "host";
+    if (supported?.length === 1 && supported[0] === BROWSER_RUNTIME_ID)
+        return "local";
+    return "host";
+}
+/** Whether this runtime id is the browser host. @category Runtime */
+export function isBrowserRuntimeId(runtimeId) {
+    return runtimeId === BROWSER_RUNTIME_ID;
+}
+/** Whether this runtime id is the Node host. @category Runtime */
+export function isNodeRuntimeId(runtimeId) {
+    return runtimeId === NODE_RUNTIME_ID;
+}
+//# sourceMappingURL=capability-execution.js.map

package/dist/runtime/capability-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-execution.js","sourceRoot":"","sources":["../../src/runtime/capability-execution.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AActE;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,GAA4B,EAC5B,GAA4B;IAE5B,IAAI,GAAG,CAAC,SAAS;QAAE,OAAO,GAAG,CAAC,SAAS,CAAA;IACvC,MAAM,SAAS,GAAG,GAAG,EAAE,iBAAiB,CAAA;IACxC,IAAI,SAAS,EAAE,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,eAAe;QAAE,OAAO,MAAM,CAAA;IAC9E,IAAI,SAAS,EAAE,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,kBAAkB;QAAE,OAAO,OAAO,CAAA;IAClF,OAAO,MAAM,CAAA;AACf,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,OAAO,SAAS,KAAK,kBAAkB,CAAA;AACzC,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,OAAO,SAAS,KAAK,eAAe,CAAA;AACtC,CAAC"}

package/dist/runtime/context.d.ts

@@ -1,6 +1,8 @@
-import type { LifecycleEvent, PolicyEvaluationScope, RegistryRegistrationRequest, WorkflowManifest } from "@executioncontrolprotocol/types";
+import type { LifecycleEvent, PolicyEvaluationScope, RegistryRegistrationRequest, ValidationIssue, WorkflowManifest } from "@executioncontrolprotocol/types";
 import type { PendingMutation, StoreStateHandle } from "@executioncontrolprotocol/types";
 import type { StoreContext } from "./store.js";
+import type { CapabilityArtifactStore } from "./artifacts.js";
+import type { CapabilityBlobStore } from "./blobs.js";
 /** Run-level context. @category Runtime */
 export interface RunContext {
     id: string;
@@ -23,6 +25,10 @@ export interface CapabilityContext {
     capabilities: {
         call(id: string, input: unknown): Promise<unknown>;
     };
+    /** Run-scoped browser files keyed by `ecp://browser/<id>` locators. */
+    blobs?: CapabilityBlobStore;
+    /** Environment-scoped host artifacts keyed by `ecp://…` URIs. */
+    artifacts?: CapabilityArtifactStore;
 }
 /** Host surface exposed on environment lifecycle hooks. @category Environment */
 export interface EnvironmentLifecycleHost {
@@ -41,6 +47,8 @@ export interface LifecycleContext {
     state: Record<string, unknown>;
     /** Step capability output when available (e.g. `step:completed`). */
     output?: unknown;
+    /** Failure diagnostics when the step did not complete (e.g. `step:failed`). */
+    diagnostics?: ValidationIssue[];
     /** Present on `environment:*` events. */
     environment?: EnvironmentLifecycleHost;
 }

package/dist/runtime/context.d.ts.map

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

package/dist/runtime/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/runtime/context.ts"],"names":[],"mappings":"AAsGA,6BAA6B;AAC7B,MAAM,UAAU,iBAAiB;IAC/B,qEAAqE;IACrE,yEAAyE;IACzE,yEAAyE;IACzE,MAAM,MAAM,GAAgB;QAC1B,UAAU,EAAE,CAAC;QACb,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,CAAC;QACT,OAAO,EAAE,CAAC;QACV,SAAS,CAAC,OAAO;YACf,IAAI,OAAO,CAAC,UAAU;gBAAE,MAAM,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,CAAA;YAC/D,IAAI,OAAO,CAAC,OAAO;gBAAE,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAA;YACtD,IAAI,OAAO,CAAC,MAAM;gBAAE,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAA;YACnD,IAAI,OAAO,CAAC,OAAO;gBAAE,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAA;QACxD,CAAC;KACF,CAAA;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;QAC7C,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;QAC9C,KAAK,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;KACjD,CAAA;AACH,CAAC"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/runtime/context.ts"],"names":[],"mappings":"AA+GA,6BAA6B;AAC7B,MAAM,UAAU,iBAAiB;IAC/B,qEAAqE;IACrE,yEAAyE;IACzE,yEAAyE;IACzE,MAAM,MAAM,GAAgB;QAC1B,UAAU,EAAE,CAAC;QACb,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,CAAC;QACT,OAAO,EAAE,CAAC;QACV,SAAS,CAAC,OAAO;YACf,IAAI,OAAO,CAAC,UAAU;gBAAE,MAAM,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,CAAA;YAC/D,IAAI,OAAO,CAAC,OAAO;gBAAE,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAA;YACtD,IAAI,OAAO,CAAC,MAAM;gBAAE,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAA;YACnD,IAAI,OAAO,CAAC,OAAO;gBAAE,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAA;QACxD,CAAC;KACF,CAAA;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;QAC7C,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;QAC9C,KAAK,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;KACjD,CAAA;AACH,CAAC"}

package/dist/runtime/dispatch-capability.d.ts

@@ -0,0 +1,42 @@
+import { type InvokeResult } from "@executioncontrolprotocol/types";
+import type { Registry } from "../registry/registry.js";
+import type { CapabilityContext } from "./context.js";
+import { type RemoteInvokeBinding } from "./remote-invoke.js";
+/** Error thrown when dispatch cannot produce handler output. @category Runtime */
+export declare class CapabilityDispatchError extends Error {
+    /** Structured invoke failure. */
+    readonly result: InvokeResult;
+    constructor(result: InvokeResult);
+}
+/** Inputs for {@link dispatchCapability}. @category Runtime */
+export interface DispatchCapabilityOptions {
+    /** Capability id to run or hop. */
+    capabilityId: string;
+    /** Capability input. */
+    input: unknown;
+    /** Handler context (nested `call` should use this dispatcher). */
+    ctx: CapabilityContext;
+    /** Live registry. */
+    registry: Registry;
+    /** Current environment runtime id. */
+    runtimeId: string;
+    /** Remote invoke host when this environment hops. */
+    remoteInvoke?: RemoteInvokeBinding;
+}
+/**
+ * Run a capability locally or hop to `POST /v1/invoke` on the same id.
+ * Returns handler output. Throws {@link CapabilityDispatchError} on failure.
+ * @category Runtime
+ */
+export declare function dispatchCapability(options: DispatchCapabilityOptions): Promise<unknown>;
+/**
+ * Nested `ctx.capabilities.call` that uses the same local/hop dispatcher.
+ * @category Runtime
+ */
+export declare function createDispatchingCall(options: Omit<DispatchCapabilityOptions, "capabilityId" | "input">): (id: string, input: unknown) => Promise<unknown>;
+/**
+ * Like {@link dispatchCapability} but always returns an {@link InvokeResult}.
+ * @category Runtime
+ */
+export declare function dispatchCapabilityResult(options: DispatchCapabilityOptions): Promise<InvokeResult>;
+//# sourceMappingURL=dispatch-capability.d.ts.map

package/dist/runtime/dispatch-capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-capability.d.ts","sourceRoot":"","sources":["../../src/runtime/dispatch-capability.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,iCAAiC,CAAA;AACxC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAErD,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,oBAAoB,CAAA;AAO3B,kFAAkF;AAClF,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;gBAEjB,MAAM,EAAE,YAAY;CAKjC;AAED,+DAA+D;AAC/D,MAAM,WAAW,yBAAyB;IACxC,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAA;IACpB,wBAAwB;IACxB,KAAK,EAAE,OAAO,CAAA;IACd,kEAAkE;IAClE,GAAG,EAAE,iBAAiB,CAAA;IACtB,qBAAqB;IACrB,QAAQ,EAAE,QAAQ,CAAA;IAClB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAA;IACjB,qDAAqD;IACrD,YAAY,CAAC,EAAE,mBAAmB,CAAA;CACnC;AAcD;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,OAAO,CAAC,CAqD7F;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,IAAI,CAAC,yBAAyB,EAAE,cAAc,GAAG,OAAO,CAAC,GACjE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAElD;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,YAAY,CAAC,CAoBvB"}

package/dist/runtime/dispatch-capability.js

@@ -0,0 +1,94 @@
+import { ECP_INVOKE_ERROR_CODES, LATEST_ECP_VERSION, } from "@executioncontrolprotocol/types";
+import { resolveCapabilityExecution, isBrowserRuntimeId } from "./capability-execution.js";
+import { hopRemoteInvoke, invokeFailure, } from "./remote-invoke.js";
+import { collectBrowserLocators, serializeCapabilityBlobs, } from "./blobs.js";
+/** Error thrown when dispatch cannot produce handler output. @category Runtime */
+export class CapabilityDispatchError extends Error {
+    /** Structured invoke failure. */
+    result;
+    constructor(result) {
+        super(result.diagnostics[0]?.message ?? "Capability dispatch failed");
+        this.name = "CapabilityDispatchError";
+        this.result = result;
+    }
+}
+function extensionForCapability(registry, cap) {
+    const extId = cap.id.replace(/\.[^.]+$/, "");
+    return registry.getExtension(extId);
+}
+function remoteRequiredMessage(capabilityId) {
+    return `Capability ${capabilityId} requires a local host. Start \`ecp up --env …\`.`;
+}
+/**
+ * Run a capability locally or hop to `POST /v1/invoke` on the same id.
+ * Returns handler output. Throws {@link CapabilityDispatchError} on failure.
+ * @category Runtime
+ */
+export async function dispatchCapability(options) {
+    const { capabilityId, input, ctx, registry, runtimeId, remoteInvoke } = options;
+    const cap = registry.getCapability(capabilityId);
+    if (!cap) {
+        throw new CapabilityDispatchError(invokeFailure(capabilityId, ECP_INVOKE_ERROR_CODES.CAPABILITY_NOT_FOUND, `Capability not registered: ${capabilityId}`));
+    }
+    const ext = extensionForCapability(registry, cap);
+    const execution = resolveCapabilityExecution(cap, ext);
+    const onBrowser = isBrowserRuntimeId(runtimeId);
+    const hopHost = execution === "host" && onBrowser;
+    const mixedNeedsHost = execution === "mixed" && onBrowser;
+    if (hopHost || mixedNeedsHost) {
+        if (!remoteInvoke?.url || !remoteInvoke.token) {
+            throw new CapabilityDispatchError(invokeFailure(capabilityId, ECP_INVOKE_ERROR_CODES.REMOTE_INVOKE_REQUIRED, remoteRequiredMessage(capabilityId)));
+        }
+    }
+    if (hopHost) {
+        const locators = collectBrowserLocators(input);
+        const blobs = ctx.blobs && locators.length > 0
+            ? await serializeCapabilityBlobs(ctx.blobs, locators)
+            : undefined;
+        const hopped = await hopRemoteInvoke(remoteInvoke, capabilityId, input, blobs);
+        if (!hopped.success) {
+            throw new CapabilityDispatchError(hopped);
+        }
+        return hopped.result;
+    }
+    try {
+        return await cap.handler(input, ctx);
+    }
+    catch (err) {
+        if (err instanceof CapabilityDispatchError)
+            throw err;
+        const message = err instanceof Error ? err.message : String(err);
+        throw new CapabilityDispatchError(invokeFailure(capabilityId, ECP_INVOKE_ERROR_CODES.INVOKE_FAILED, message));
+    }
+}
+/**
+ * Nested `ctx.capabilities.call` that uses the same local/hop dispatcher.
+ * @category Runtime
+ */
+export function createDispatchingCall(options) {
+    return (id, input) => dispatchCapability({ ...options, capabilityId: id, input });
+}
+/**
+ * Like {@link dispatchCapability} but always returns an {@link InvokeResult}.
+ * @category Runtime
+ */
+export async function dispatchCapabilityResult(options) {
+    try {
+        const output = await dispatchCapability(options);
+        return {
+            schema: "@executioncontrolprotocol.invoke.result",
+            version: LATEST_ECP_VERSION,
+            success: true,
+            capabilityId: options.capabilityId,
+            result: output,
+            diagnostics: [],
+        };
+    }
+    catch (err) {
+        if (err instanceof CapabilityDispatchError)
+            return err.result;
+        const message = err instanceof Error ? err.message : String(err);
+        return invokeFailure(options.capabilityId, ECP_INVOKE_ERROR_CODES.INVOKE_FAILED, message);
+    }
+}
+//# sourceMappingURL=dispatch-capability.js.map

package/dist/runtime/dispatch-capability.js.map

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

package/dist/runtime/executor.d.ts

@@ -1,4 +1,7 @@
 import type { RunResult, StepRunRecord, WorkflowManifest } from "@executioncontrolprotocol/types";
+import type { RemoteInvokeBinding } from "./remote-invoke.js";
+import type { CapabilityArtifactStore } from "./artifacts.js";
+import type { CapabilityBlobStore } from "./blobs.js";
 /** Runtime execution mode. @category Runtime */
 export type RuntimeExecutionMode = "run" | "test";
 /** Runtime execution options passed to the executor. @category Runtime */
@@ -21,6 +24,12 @@ export interface RuntimeExecutionContext {
     stopAfterStepId?: string;
     /** Execute only this leaf step id (test `rerun`). */
     onlyStepId?: string;
+    /** Local invoke host for host/mixed hops. */
+    remoteInvoke?: RemoteInvokeBinding;
+    /** Run-scoped browser file map. */
+    blobs?: CapabilityBlobStore;
+    /** Environment-scoped host artifact map. */
+    artifacts?: CapabilityArtifactStore;
 }
 /** Runtime executor interface. @category Runtime */
 export interface RuntimeExecutor {