@executioncontrolprotocol/core 0.11.3 → 0.13.0

package/dist/media/index.d.ts

@@ -0,0 +1,13 @@
+/**
+
+ * Unified file resolve/write for extensions.
+
+ * @packageDocumentation
+
+ * @category File
+
+ */
+export { resolveFile, STORAGE_ARTIFACT_URI_PREFIX, type ResolvedFile, type ResolveFileOptions, type FileCapabilityContext, } from "./resolve-file.js";
+export { writeMediaArtifact, type WriteMediaArtifactOptions, } from "./write-media.js";
+export { ARTIFACT_HTTP_PATH_PREFIX, artifactFetchPathname, defaultArtifactFilename, extensionForMediaType, isArtifactFetchPathname, parseArtifactFetchPathname, resolveArtifactFilename, type ArtifactFetchPathnameOptions, } from "./artifact-filename.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/media/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/media/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAEL,WAAW,EAEX,2BAA2B,EAE3B,KAAK,YAAY,EAEjB,KAAK,kBAAkB,EAEvB,KAAK,qBAAqB,GAE3B,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAEL,kBAAkB,EAElB,KAAK,yBAAyB,GAE/B,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAEL,yBAAyB,EAEzB,qBAAqB,EAErB,uBAAuB,EAEvB,qBAAqB,EAErB,uBAAuB,EAEvB,0BAA0B,EAE1B,uBAAuB,EAEvB,KAAK,4BAA4B,GAElC,MAAM,wBAAwB,CAAA"}

package/dist/media/index.js

@@ -0,0 +1,13 @@
+/**
+
+ * Unified file resolve/write for extensions.
+
+ * @packageDocumentation
+
+ * @category File
+
+ */
+export { resolveFile, STORAGE_ARTIFACT_URI_PREFIX, } from "./resolve-file.js";
+export { writeMediaArtifact, } from "./write-media.js";
+export { ARTIFACT_HTTP_PATH_PREFIX, artifactFetchPathname, defaultArtifactFilename, extensionForMediaType, isArtifactFetchPathname, parseArtifactFetchPathname, resolveArtifactFilename, } from "./artifact-filename.js";
+//# sourceMappingURL=index.js.map

package/dist/media/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/media/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAEL,WAAW,EAEX,2BAA2B,GAQ5B,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAEL,kBAAkB,GAInB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAEL,yBAAyB,EAEzB,qBAAqB,EAErB,uBAAuB,EAEvB,qBAAqB,EAErB,uBAAuB,EAEvB,0BAA0B,EAE1B,uBAAuB,GAIxB,MAAM,wBAAwB,CAAA"}

package/dist/media/resolve-file.d.ts

@@ -0,0 +1,32 @@
+import { type FileRef } from "@executioncontrolprotocol/types";
+import type { CapabilityContext } from "../runtime/context.js";
+/** URI prefix for durable storage-backed artifacts. @category File */
+export declare const STORAGE_ARTIFACT_URI_PREFIX = "ecp://storage/";
+/** Resolved file bytes from {@link resolveFile}. @category File */
+export interface ResolvedFile {
+    /** Raw bytes. */
+    bytes: Uint8Array;
+    /** MIME type when known. */
+    mediaType?: string;
+    /** Byte length. */
+    sizeBytes: number;
+    /** Optional display name. */
+    name?: string;
+}
+/** Options for {@link resolveFile}. @category File */
+export interface ResolveFileOptions {
+    /** When false (default), `kind: "url"` refs are rejected. */
+    allowRemoteUrls?: boolean;
+}
+/** Context required to resolve {@link FileRef} values. @category File */
+export type FileCapabilityContext = CapabilityContext & {
+    /** Bound extension config (limits / storage prefixes). */
+    extensionConfig?: Record<string, unknown>;
+};
+/**
+ * Resolve a portable {@link FileRef} to bytes using blobs, artifacts, fetch, or Node fs.
+ * Extensions should call this instead of reimplementing I/O.
+ * @category File
+ */
+export declare function resolveFile(ref: FileRef, ctx: FileCapabilityContext, options?: ResolveFileOptions): Promise<ResolvedFile>;
+//# sourceMappingURL=resolve-file.d.ts.map

package/dist/media/resolve-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-file.d.ts","sourceRoot":"","sources":["../../src/media/resolve-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,OAAO,EACb,MAAM,iCAAiC,CAAA;AAExC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAE9D,sEAAsE;AACtE,eAAO,MAAM,2BAA2B,mBAAmB,CAAA;AAE3D,mEAAmE;AACnE,MAAM,WAAW,YAAY;IAC3B,iBAAiB;IACjB,KAAK,EAAE,UAAU,CAAA;IACjB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mBAAmB;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,sDAAsD;AACtD,MAAM,WAAW,kBAAkB;IACjC,6DAA6D;IAC7D,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,yEAAyE;AACzE,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG;IACtD,0DAA0D;IAC1D,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC1C,CAAA;AAgDD;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,qBAAqB,EAC1B,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,YAAY,CAAC,CAmEvB"}

package/dist/media/resolve-file.js

@@ -0,0 +1,110 @@
+import { FILE_REF_KINDS, } from "@executioncontrolprotocol/types";
+import { isBrowserFileLocator } from "../runtime/blobs.js";
+/** URI prefix for durable storage-backed artifacts. @category File */
+export const STORAGE_ARTIFACT_URI_PREFIX = "ecp://storage/";
+async function readFileFromPath(path) {
+    try {
+        const mod = await import("../loaders/read-media-file.js");
+        return mod.readMediaFileFromPath(path);
+    }
+    catch {
+        throw new Error("File media refs require Node.js (node:fs/promises is not available in this runtime)");
+    }
+}
+async function readBrowserLocator(locator, ctx, mediaType) {
+    const blob = ctx.blobs?.get(locator);
+    if (!blob) {
+        throw new Error(`No file stashed for locator ${locator}`);
+    }
+    const bytes = new Uint8Array(await blob.arrayBuffer());
+    return {
+        bytes,
+        mediaType: mediaType || blob.type || undefined,
+        sizeBytes: bytes.byteLength,
+        name: blob.name || undefined,
+    };
+}
+function readStoredArtifact(uri, ctx, mediaType) {
+    const fromCtx = ctx.artifacts?.get(uri);
+    if (!fromCtx) {
+        throw new Error(`Artifact not found: ${uri}`);
+    }
+    return {
+        bytes: fromCtx.bytes instanceof Uint8Array ? fromCtx.bytes : new Uint8Array(fromCtx.bytes),
+        mediaType: mediaType ?? fromCtx.mediaType,
+        sizeBytes: fromCtx.size,
+        name: fromCtx.name,
+    };
+}
+/**
+ * Resolve a portable {@link FileRef} to bytes using blobs, artifacts, fetch, or Node fs.
+ * Extensions should call this instead of reimplementing I/O.
+ * @category File
+ */
+export async function resolveFile(ref, ctx, options = {}) {
+    const cfg = ctx.extensionConfig ?? {};
+    const limits = cfg.limits ?? {};
+    const allowRemoteUrls = options.allowRemoteUrls ?? limits.allowRemoteUrls ?? false;
+    switch (ref.kind) {
+        case FILE_REF_KINDS.BUFFER: {
+            const bytes = typeof Buffer !== "undefined"
+                ? new Uint8Array(Buffer.from(ref.data, "base64"))
+                : Uint8Array.from(atob(ref.data), (c) => c.charCodeAt(0));
+            return { bytes, mediaType: ref.mediaType, sizeBytes: bytes.byteLength };
+        }
+        case FILE_REF_KINDS.FILE: {
+            if (isBrowserFileLocator(ref.path)) {
+                return readBrowserLocator(ref.path, ctx, ref.mediaType);
+            }
+            const bytes = await readFileFromPath(ref.path);
+            return { bytes, mediaType: ref.mediaType, sizeBytes: bytes.byteLength };
+        }
+        case FILE_REF_KINDS.URL: {
+            if (!allowRemoteUrls) {
+                throw new Error("Remote URL media refs are disabled (allowRemoteUrls)");
+            }
+            const res = await fetch(ref.url, { headers: ref.headers });
+            if (!res.ok)
+                throw new Error(`Failed to fetch media URL: ${res.status}`);
+            const arrayBuf = await res.arrayBuffer();
+            const bytes = new Uint8Array(arrayBuf);
+            const mediaType = ref.mediaType ?? res.headers.get("content-type") ?? undefined;
+            return { bytes, mediaType, sizeBytes: bytes.byteLength };
+        }
+        case FILE_REF_KINDS.ARTIFACT: {
+            if (isBrowserFileLocator(ref.uri)) {
+                return readBrowserLocator(ref.uri, ctx, ref.mediaType);
+            }
+            if (ref.uri.startsWith(STORAGE_ARTIFACT_URI_PREFIX)) {
+                const key = ref.uri.slice(STORAGE_ARTIFACT_URI_PREFIX.length);
+                const result = (await ctx.capabilities.call("@executioncontrolprotocol/storage.read", {
+                    key,
+                }));
+                if (result.value instanceof Uint8Array) {
+                    return {
+                        bytes: result.value,
+                        mediaType: ref.mediaType,
+                        sizeBytes: result.value.byteLength,
+                        name: ref.name,
+                    };
+                }
+                if (typeof result.value === "string") {
+                    const bytes = typeof Buffer !== "undefined"
+                        ? new Uint8Array(Buffer.from(result.value, "base64"))
+                        : Uint8Array.from(atob(result.value), (c) => c.charCodeAt(0));
+                    return {
+                        bytes,
+                        mediaType: ref.mediaType,
+                        sizeBytes: bytes.byteLength,
+                        name: ref.name,
+                    };
+                }
+                throw new Error(`Artifact not found: ${ref.uri}`);
+            }
+            return readStoredArtifact(ref.uri, ctx, ref.mediaType);
+        }
+        default:
+            throw new Error("Unsupported file reference kind");
+    }
+}
+//# sourceMappingURL=resolve-file.js.map

package/dist/media/resolve-file.js.map

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

package/dist/media/write-media.d.ts

@@ -0,0 +1,19 @@
+import { type FileRef } from "@executioncontrolprotocol/types";
+import { type FileCapabilityContext } from "./resolve-file.js";
+/** Options for {@link writeMediaArtifact}. @category Media */
+export interface WriteMediaArtifactOptions {
+    /** MIME type. */
+    mediaType: string;
+    /** Optional filename. */
+    name?: string;
+    /** URI path prefix under `ecp://` (default `artifacts/media`). */
+    prefix?: string;
+    /** When `"storage"`, write via `@executioncontrolprotocol/storage.write`. */
+    store?: string;
+}
+/**
+ * Write bytes into the host artifact store (or durable storage) and return an artifact {@link FileRef}.
+ * @category Media
+ */
+export declare function writeMediaArtifact(data: Uint8Array, options: WriteMediaArtifactOptions, ctx: FileCapabilityContext): Promise<FileRef>;
+//# sourceMappingURL=write-media.d.ts.map

package/dist/media/write-media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-media.d.ts","sourceRoot":"","sources":["../../src/media/write-media.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,OAAO,EAAE,MAAM,iCAAiC,CAAA;AAE9E,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,mBAAmB,CAAA;AAE1B,8DAA8D;AAC9D,MAAM,WAAW,yBAAyB;IACxC,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,yBAAyB,EAClC,GAAG,EAAE,qBAAqB,GACzB,OAAO,CAAC,OAAO,CAAC,CA2ClB"}

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"}