@executioncontrolprotocol/types 0.11.3 → 0.13.0

package/dist/capability-execution.d.ts

@@ -0,0 +1,5 @@
+/** Where a capability may execute. @category Capabilities */
+export declare const CAPABILITY_EXECUTION: readonly ["local", "host", "mixed"];
+/** Capability execution kind. @category Capabilities */
+export type CapabilityExecution = (typeof CAPABILITY_EXECUTION)[number];
+//# sourceMappingURL=capability-execution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capability-execution.d.ts","sourceRoot":"","sources":["../src/capability-execution.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,eAAO,MAAM,oBAAoB,qCAAsC,CAAA;AAEvE,wDAAwD;AACxD,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAA"}

package/dist/capability-execution.js

@@ -0,0 +1,3 @@
+/** Where a capability may execute. @category Capabilities */
+export const CAPABILITY_EXECUTION = ["local", "host", "mixed"];
+//# sourceMappingURL=capability-execution.js.map

package/dist/capability-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-execution.js","sourceRoot":"","sources":["../src/capability-execution.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAU,CAAA"}

package/dist/environment.d.ts

@@ -1,5 +1,6 @@
 import type { NamespacedId } from "./schema.js";
 import type { EcpVersion } from "./version.js";
+import type { CapabilityExecution } from "./capability-execution.js";
 /** Environment manifest (bindings only). @category Environment */
 export interface EnvironmentManifest {
     schema: "@executioncontrolprotocol.environment";
@@ -54,6 +55,10 @@ export interface EnvironmentDescriptor {
     extensions: ExtensionDescription[];
     capabilities: CapabilityDescription[];
     policies: PolicyDescription[];
+    /** Local invoke host URL when this environment hops host/mixed capabilities. Token is never included. */
+    remoteInvoke?: {
+        url: string;
+    };
 }
 /** Runtime section of descriptor. @category Environment */
 export interface RuntimeDescription {
@@ -79,6 +84,11 @@ export interface CapabilityDescription {
     inputSchema?: unknown;
     outputSchema?: unknown;
     examples?: unknown[];
+    /**
+     * Where this capability executes (`local` | `host` | `mixed`).
+     * Omitted when not declared and not inferred from the extension.
+     */
+    execution?: CapabilityExecution;
 }
 /** Policy metadata in descriptor. @category Environment */
 export interface PolicyDescription {

package/dist/environment.d.ts.map

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

package/dist/file-ref.d.ts

@@ -0,0 +1,84 @@
+import { z } from "zod";
+/** Portable file reference kinds. @category File */
+export declare const FILE_REF_KINDS: {
+    readonly ARTIFACT: "artifact";
+    readonly FILE: "file";
+    readonly URL: "url";
+    readonly BUFFER: "buffer";
+};
+/** File reference kind union. @category File */
+export type FileRefKind = (typeof FILE_REF_KINDS)[keyof typeof FILE_REF_KINDS];
+/** Artifact-backed file reference. @category File */
+export interface ArtifactFileRef {
+    /** Reference kind. */
+    kind: typeof FILE_REF_KINDS.ARTIFACT;
+    /**
+     * Artifact URI (`ecp://…` in `ctx.artifacts`, `ecp://storage/…`, or
+     * `ecp://browser/…` when bytes live in `ctx.blobs`).
+     */
+    uri: string;
+    /** Optional MIME type. */
+    mediaType?: string;
+    /** Optional display name. */
+    name?: string;
+    /** Optional byte size when known. */
+    sizeBytes?: number;
+}
+/** Filesystem or browser-locator file reference. @category File */
+export interface FileFileRef {
+    /** Reference kind. */
+    kind: typeof FILE_REF_KINDS.FILE;
+    /**
+     * Absolute or relative file path on Node, or an `ecp://browser/<id>` locator
+     * stashed in `ctx.blobs` for browser/mixed hops.
+     */
+    path: string;
+    /** Optional MIME type. */
+    mediaType?: string;
+    /** Optional byte size when known. */
+    sizeBytes?: number;
+}
+/** Remote URL file reference. @category File */
+export interface UrlFileRef {
+    /** Reference kind. */
+    kind: typeof FILE_REF_KINDS.URL;
+    /** File URL. */
+    url: string;
+    /** Optional request headers. */
+    headers?: Record<string, string>;
+    /** Optional MIME type. */
+    mediaType?: string;
+}
+/** In-memory buffer file reference (runtime/tests; not manifest-portable). @category File */
+export interface BufferFileRef {
+    /** Reference kind. */
+    kind: typeof FILE_REF_KINDS.BUFFER;
+    /** Base64-encoded file bytes. */
+    data: string;
+    /** Optional MIME type. */
+    mediaType?: string;
+}
+/** Portable file reference for workflow steps. @category File */
+export type FileRef = ArtifactFileRef | FileFileRef | UrlFileRef | BufferFileRef;
+/** Options carried on {@link fileRefSchema} instances for UI and validation hints. @category File */
+export interface FileRefSchemaOptions {
+    /** Expected MIME type or wildcard (e.g. `image/*`). */
+    contentMediaType?: string | string[];
+}
+/**
+ * Canonical portable JSON Schema hint for file-ref ports and workflow I/O.
+ * @category File
+ */
+export declare function fileRefValueSchemaHint(options?: FileRefSchemaOptions): Record<string, unknown>;
+/**
+ * Zod schema for {@link FileRef} with optional {@link FileRefSchemaOptions} metadata.
+ * @category File
+ */
+export declare function fileRefSchema(options?: FileRefSchemaOptions): z.ZodType<FileRef>;
+/** Detect optional/nullable wrappers; true for {@link fileRefSchema} instances. @category File */
+export declare function isFileRefSchema(type: z.ZodType): boolean;
+/** Read contentMediaType hint from a {@link fileRefSchema} (after unwrap). @category File */
+export declare function fileRefSchemaOptions(type: z.ZodType): FileRefSchemaOptions | undefined;
+/** @category File */
+export declare function isFileRefKind(value: unknown): value is FileRefKind;
+//# sourceMappingURL=file-ref.d.ts.map

package/dist/file-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-ref.d.ts","sourceRoot":"","sources":["../src/file-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,oDAAoD;AACpD,eAAO,MAAM,cAAc;;;;;CAKjB,CAAA;AAEV,gDAAgD;AAChD,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAA;AAE9E,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,sBAAsB;IACtB,IAAI,EAAE,OAAO,cAAc,CAAC,QAAQ,CAAA;IACpC;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAA;IACX,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,mEAAmE;AACnE,MAAM,WAAW,WAAW;IAC1B,sBAAsB;IACtB,IAAI,EAAE,OAAO,cAAc,CAAC,IAAI,CAAA;IAChC;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,gDAAgD;AAChD,MAAM,WAAW,UAAU;IACzB,sBAAsB;IACtB,IAAI,EAAE,OAAO,cAAc,CAAC,GAAG,CAAA;IAC/B,gBAAgB;IAChB,GAAG,EAAE,MAAM,CAAA;IACX,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,6FAA6F;AAC7F,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,IAAI,EAAE,OAAO,cAAc,CAAC,MAAM,CAAA;IAClC,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,iEAAiE;AACjE,MAAM,MAAM,OAAO,GAAG,eAAe,GAAG,WAAW,GAAG,UAAU,GAAG,aAAa,CAAA;AAEhF,qGAAqG;AACrG,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CACrC;AA0DD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoB9F;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAOhF;AAED,kGAAkG;AAClG,wBAAgB,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,GAAG,OAAO,CAIxD;AAED,6FAA6F;AAC7F,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,GAAG,oBAAoB,GAAG,SAAS,CAQtF;AAED,qBAAqB;AACrB,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAKlE"}

package/dist/file-ref.js

@@ -0,0 +1,117 @@
+import { z } from "zod";
+/** Portable file reference kinds. @category File */
+export const FILE_REF_KINDS = {
+    ARTIFACT: "artifact",
+    FILE: "file",
+    URL: "url",
+    BUFFER: "buffer",
+};
+const baseFileRefSchema = z.discriminatedUnion("kind", [
+    z.object({
+        kind: z.literal(FILE_REF_KINDS.ARTIFACT),
+        uri: z.string(),
+        mediaType: z.string().optional(),
+        name: z.string().optional(),
+        sizeBytes: z.number().optional(),
+    }),
+    z.object({
+        kind: z.literal(FILE_REF_KINDS.FILE),
+        path: z.string(),
+        mediaType: z.string().optional(),
+        sizeBytes: z.number().optional(),
+    }),
+    z.object({
+        kind: z.literal(FILE_REF_KINDS.URL),
+        url: z.string(),
+        headers: z.record(z.string(), z.string()).optional(),
+        mediaType: z.string().optional(),
+    }),
+    z.object({
+        kind: z.literal(FILE_REF_KINDS.BUFFER),
+        data: z.string(),
+        mediaType: z.string().optional(),
+    }),
+]);
+const fileRefSchemaMeta = new WeakMap();
+function unwrapZodType(type) {
+    if (type instanceof z.ZodOptional) {
+        return unwrapZodType(type.unwrap());
+    }
+    if (type instanceof z.ZodDefault) {
+        return unwrapZodType(type.removeDefault());
+    }
+    if (type instanceof z.ZodNullable) {
+        return unwrapZodType(type.unwrap());
+    }
+    return type;
+}
+function fileRefSchemaChain(type) {
+    const chain = [];
+    let current = unwrapZodType(type);
+    for (;;) {
+        chain.push(current);
+        if (current instanceof z.ZodEffects) {
+            current = current._def.schema;
+            continue;
+        }
+        break;
+    }
+    return chain;
+}
+/**
+ * Canonical portable JSON Schema hint for file-ref ports and workflow I/O.
+ * @category File
+ */
+export function fileRefValueSchemaHint(options) {
+    const hint = {
+        "x-ecp-file": true,
+        type: "object",
+        properties: {
+            kind: { type: "string", enum: Object.values(FILE_REF_KINDS) },
+            path: { type: "string" },
+            uri: { type: "string" },
+            url: { type: "string" },
+            data: { type: "string" },
+            mediaType: { type: "string" },
+            sizeBytes: { type: "number" },
+            name: { type: "string" },
+            headers: { type: "object" },
+        },
+    };
+    if (options?.contentMediaType !== undefined) {
+        hint.contentMediaType = options.contentMediaType;
+    }
+    return hint;
+}
+/**
+ * Zod schema for {@link FileRef} with optional {@link FileRefSchemaOptions} metadata.
+ * @category File
+ */
+export function fileRefSchema(options) {
+    if (options?.contentMediaType === undefined) {
+        return baseFileRefSchema;
+    }
+    const schema = baseFileRefSchema.superRefine(() => undefined);
+    fileRefSchemaMeta.set(schema, options);
+    return schema;
+}
+/** Detect optional/nullable wrappers; true for {@link fileRefSchema} instances. @category File */
+export function isFileRefSchema(type) {
+    return fileRefSchemaChain(type).some((node) => node === baseFileRefSchema || fileRefSchemaMeta.has(node));
+}
+/** Read contentMediaType hint from a {@link fileRefSchema} (after unwrap). @category File */
+export function fileRefSchemaOptions(type) {
+    for (const node of fileRefSchemaChain(type)) {
+        const meta = fileRefSchemaMeta.get(node);
+        if (meta?.contentMediaType !== undefined) {
+            return meta;
+        }
+    }
+    return isFileRefSchema(type) ? {} : undefined;
+}
+/** @category File */
+export function isFileRefKind(value) {
+    return (typeof value === "string" &&
+        Object.values(FILE_REF_KINDS).includes(value));
+}
+//# sourceMappingURL=file-ref.js.map

package/dist/file-ref.js.map

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

package/dist/harness-run-context.d.ts

@@ -64,11 +64,11 @@ export declare const runResultSchema: z.ZodObject<{
     usage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
     version: string;
+    schema: "@executioncontrolprotocol.run.result";
     run: {
         status: string;
         id: string;
     };
-    schema: "@executioncontrolprotocol.run.result";
     usage?: Record<string, unknown> | undefined;
     state?: Record<string, unknown> | undefined;
     history?: Record<string, {
@@ -81,11 +81,11 @@ export declare const runResultSchema: z.ZodObject<{
     }> | undefined;
 }, {
     version: string;
+    schema: "@executioncontrolprotocol.run.result";
     run: {
         status: string;
         id: string;
     };
-    schema: "@executioncontrolprotocol.run.result";
     usage?: Record<string, unknown> | undefined;
     state?: Record<string, unknown> | undefined;
     history?: Record<string, {
@@ -145,11 +145,11 @@ export declare const harnessRunContextSchema: z.ZodObject<{
         usage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
         version: string;
+        schema: "@executioncontrolprotocol.run.result";
         run: {
             status: string;
             id: string;
         };
-        schema: "@executioncontrolprotocol.run.result";
         usage?: Record<string, unknown> | undefined;
         state?: Record<string, unknown> | undefined;
         history?: Record<string, {
@@ -162,11 +162,11 @@ export declare const harnessRunContextSchema: z.ZodObject<{
         }> | undefined;
     }, {
         version: string;
+        schema: "@executioncontrolprotocol.run.result";
         run: {
             status: string;
             id: string;
         };
-        schema: "@executioncontrolprotocol.run.result";
         usage?: Record<string, unknown> | undefined;
         state?: Record<string, unknown> | undefined;
         history?: Record<string, {
@@ -182,11 +182,11 @@ export declare const harnessRunContextSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     run: {
         version: string;
+        schema: "@executioncontrolprotocol.run.result";
         run: {
             status: string;
             id: string;
         };
-        schema: "@executioncontrolprotocol.run.result";
         usage?: Record<string, unknown> | undefined;
         state?: Record<string, unknown> | undefined;
         history?: Record<string, {
@@ -202,11 +202,11 @@ export declare const harnessRunContextSchema: z.ZodObject<{
 }, {
     run: {
         version: string;
+        schema: "@executioncontrolprotocol.run.result";
         run: {
             status: string;
             id: string;
         };
-        schema: "@executioncontrolprotocol.run.result";
         usage?: Record<string, unknown> | undefined;
         state?: Record<string, unknown> | undefined;
         history?: Record<string, {

package/dist/harness-tasks.d.ts

@@ -85,11 +85,11 @@ export declare const harnessChatInputSchema: z.ZodObject<{
             usage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, "strip", z.ZodTypeAny, {
             version: string;
+            schema: "@executioncontrolprotocol.run.result";
             run: {
                 status: string;
                 id: string;
             };
-            schema: "@executioncontrolprotocol.run.result";
             usage?: Record<string, unknown> | undefined;
             state?: Record<string, unknown> | undefined;
             history?: Record<string, {
@@ -102,11 +102,11 @@ export declare const harnessChatInputSchema: z.ZodObject<{
             }> | undefined;
         }, {
             version: string;
+            schema: "@executioncontrolprotocol.run.result";
             run: {
                 status: string;
                 id: string;
             };
-            schema: "@executioncontrolprotocol.run.result";
             usage?: Record<string, unknown> | undefined;
             state?: Record<string, unknown> | undefined;
             history?: Record<string, {
@@ -122,11 +122,11 @@ export declare const harnessChatInputSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         run: {
             version: string;
+            schema: "@executioncontrolprotocol.run.result";
             run: {
                 status: string;
                 id: string;
             };
-            schema: "@executioncontrolprotocol.run.result";
             usage?: Record<string, unknown> | undefined;
             state?: Record<string, unknown> | undefined;
             history?: Record<string, {
@@ -142,11 +142,11 @@ export declare const harnessChatInputSchema: z.ZodObject<{
     }, {
         run: {
             version: string;
+            schema: "@executioncontrolprotocol.run.result";
             run: {
                 status: string;
                 id: string;
             };
-            schema: "@executioncontrolprotocol.run.result";
             usage?: Record<string, unknown> | undefined;
             state?: Record<string, unknown> | undefined;
             history?: Record<string, {
@@ -171,11 +171,11 @@ export declare const harnessChatInputSchema: z.ZodObject<{
     runContext?: {
         run: {
             version: string;
+            schema: "@executioncontrolprotocol.run.result";
             run: {
                 status: string;
                 id: string;
             };
-            schema: "@executioncontrolprotocol.run.result";
             usage?: Record<string, unknown> | undefined;
             state?: Record<string, unknown> | undefined;
             history?: Record<string, {
@@ -197,11 +197,11 @@ export declare const harnessChatInputSchema: z.ZodObject<{
     runContext?: {
         run: {
             version: string;
+            schema: "@executioncontrolprotocol.run.result";
             run: {
                 status: string;
                 id: string;
             };
-            schema: "@executioncontrolprotocol.run.result";
             usage?: Record<string, unknown> | undefined;
             state?: Record<string, unknown> | undefined;
             history?: Record<string, {
@@ -266,11 +266,11 @@ export declare const harnessWorkflowAssistantInputSchema: z.ZodObject<{
             usage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, "strip", z.ZodTypeAny, {
             version: string;
+            schema: "@executioncontrolprotocol.run.result";
             run: {
                 status: string;
                 id: string;
             };
-            schema: "@executioncontrolprotocol.run.result";
             usage?: Record<string, unknown> | undefined;
             state?: Record<string, unknown> | undefined;
             history?: Record<string, {
@@ -283,11 +283,11 @@ export declare const harnessWorkflowAssistantInputSchema: z.ZodObject<{
             }> | undefined;
         }, {
             version: string;
+            schema: "@executioncontrolprotocol.run.result";
             run: {
                 status: string;
                 id: string;
             };
-            schema: "@executioncontrolprotocol.run.result";
             usage?: Record<string, unknown> | undefined;
             state?: Record<string, unknown> | undefined;
             history?: Record<string, {
@@ -303,11 +303,11 @@ export declare const harnessWorkflowAssistantInputSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         run: {
             version: string;
+            schema: "@executioncontrolprotocol.run.result";
             run: {
                 status: string;
                 id: string;
             };
-            schema: "@executioncontrolprotocol.run.result";
             usage?: Record<string, unknown> | undefined;
             state?: Record<string, unknown> | undefined;
             history?: Record<string, {
@@ -323,11 +323,11 @@ export declare const harnessWorkflowAssistantInputSchema: z.ZodObject<{
     }, {
         run: {
             version: string;
+            schema: "@executioncontrolprotocol.run.result";
             run: {
                 status: string;
                 id: string;
             };
-            schema: "@executioncontrolprotocol.run.result";
             usage?: Record<string, unknown> | undefined;
             state?: Record<string, unknown> | undefined;
             history?: Record<string, {
@@ -350,11 +350,11 @@ export declare const harnessWorkflowAssistantInputSchema: z.ZodObject<{
     runContext?: {
         run: {
             version: string;
+            schema: "@executioncontrolprotocol.run.result";
             run: {
                 status: string;
                 id: string;
             };
-            schema: "@executioncontrolprotocol.run.result";
             usage?: Record<string, unknown> | undefined;
             state?: Record<string, unknown> | undefined;
             history?: Record<string, {
@@ -375,11 +375,11 @@ export declare const harnessWorkflowAssistantInputSchema: z.ZodObject<{
     runContext?: {
         run: {
             version: string;
+            schema: "@executioncontrolprotocol.run.result";
             run: {
                 status: string;
                 id: string;
             };
-            schema: "@executioncontrolprotocol.run.result";
             usage?: Record<string, unknown> | undefined;
             state?: Record<string, unknown> | undefined;
             history?: Record<string, {

package/dist/harness.d.ts

@@ -92,13 +92,13 @@ export declare const harnessEvaluateOutputSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     raw: string;
     trace: HarnessTrace;
-    validation?: unknown;
     artifact?: unknown;
+    validation?: unknown;
 }, {
     raw: string;
     trace: HarnessTrace;
-    validation?: unknown;
     artifact?: unknown;
+    validation?: unknown;
 }>;
 /** Inferred harness evaluate output from {@link harnessEvaluateOutputSchema}. @category Harness */
 export type HarnessEvaluateOutput = z.infer<typeof harnessEvaluateOutputSchema>;

package/dist/image-output.d.ts

@@ -0,0 +1,32 @@
+/** Supported image output formats. @category Image */
+export declare const IMAGE_OUTPUT_FORMATS: {
+    readonly JPEG: "jpeg";
+    readonly PNG: "png";
+    readonly WEBP: "webp";
+    readonly AVIF: "avif";
+    readonly TIFF: "tiff";
+    readonly GIF: "gif";
+    readonly RAW: "raw";
+};
+/** Image output format union. @category Image */
+export type ImageOutputFormat = (typeof IMAGE_OUTPUT_FORMATS)[keyof typeof IMAGE_OUTPUT_FORMATS];
+/** Image processing output info summary. @category Image */
+export interface ImageOutputInfo {
+    /** Output format. */
+    format: string;
+    /** Width in pixels. */
+    width: number;
+    /** Height in pixels. */
+    height: number;
+    /** Channel count. */
+    channels: number;
+    /** Output size in bytes. */
+    sizeBytes: number;
+    /** Premultiplied alpha when relevant. */
+    premultiplied?: boolean;
+    /** Crop offset when relevant. */
+    cropOffsetLeft?: number;
+    /** Crop offset when relevant. */
+    cropOffsetTop?: number;
+}
+//# sourceMappingURL=image-output.d.ts.map

package/dist/image-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-output.d.ts","sourceRoot":"","sources":["../src/image-output.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,eAAO,MAAM,oBAAoB;;;;;;;;CAQvB,CAAA;AAEV,iDAAiD;AACjD,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,OAAO,oBAAoB,CAAC,CAAA;AAEhG,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,yCAAyC;IACzC,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,iCAAiC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,iCAAiC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB"}

package/dist/image-output.js

@@ -0,0 +1,11 @@
+/** Supported image output formats. @category Image */
+export const IMAGE_OUTPUT_FORMATS = {
+    JPEG: "jpeg",
+    PNG: "png",
+    WEBP: "webp",
+    AVIF: "avif",
+    TIFF: "tiff",
+    GIF: "gif",
+    RAW: "raw",
+};
+//# sourceMappingURL=image-output.js.map

package/dist/image-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-output.js","sourceRoot":"","sources":["../src/image-output.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;CACF,CAAA"}

package/dist/index.d.ts

@@ -15,8 +15,10 @@ export type { GenerateCapabilityInput, GenerateCapabilityOutput, EvaluateCapabil
 export { ECP_PATCH_ERROR_CODES } from "./patch-errors.js";
 export type { EcpPatchErrorCode } from "./patch-errors.js";
 export type { PatchMode, EcpPatchEntry, EcpPatchDocument, EcpPatchInput, AppliedPatchEntry, PatchResult, PatchResultDocument, EcpPatchDocumentRecord, } from "./patch.js";
-export { ECP_INVOKE_ERROR_CODES } from "./invoke.js";
+export { ECP_INVOKE_ERROR_CODES, httpStatusForInvokeResult } from "./invoke.js";
 export type { EcpInvokeErrorCode, InvokeResult, UsageSummary } from "./invoke.js";
+export { CAPABILITY_EXECUTION } from "./capability-execution.js";
+export type { CapabilityExecution } from "./capability-execution.js";
 export { ECP_MODEL_GENERATE_INTERFACE, ECP_MODEL_CAPABILITY_NAME, ECP_MODEL_RESPONSE_FORMATS, modelGenerateInputSchema, modelGenerateOutputSchema, } from "./model.js";
 export type { EcpModelResponseFormat, ModelGenerateInput, ModelGenerateOutput, } from "./model.js";
 export { ECP_HARNESS_CAPABILITY_NAME, ECP_HARNESS_ERROR_CODES, ECP_CORE_FORMATTER_IDS, harnessCapabilityId, harnessEvaluateOutputSchema, } from "./harness.js";
@@ -30,6 +32,8 @@ export { ECP_HARNESS_REPLY_SCHEMA, ECP_HARNESS_REPLY_CITATION_KINDS, harnessRepl
 export type { HarnessReply } from "./harness-reply.js";
 export { HARNESS_TASK_IDS, harnessChatInputSchema, harnessIntentClassificationInputSchema, harnessWorkflowAuthoringInputSchema, harnessWorkflowAssistantInputSchema, } from "./harness-tasks.js";
 export type { HarnessTaskId, HarnessChatInput, HarnessIntentClassificationInput, HarnessWorkflowAuthoringInput, HarnessWorkflowAssistantInput, } from "./harness-tasks.js";
-export { IMAGE_REF_KINDS, IMAGE_OUTPUT_FORMATS, imageRefSchema, } from "./image.js";
-export type { ImageRefKind, ImageOutputFormat, ArtifactImageRef, FileImageRef, UrlImageRef, BufferImageRef, ImageRef, ImageOutputInfo, } from "./image.js";
+export { FILE_REF_KINDS, fileRefSchema, fileRefValueSchemaHint, isFileRefSchema, fileRefSchemaOptions, isFileRefKind, } from "./file-ref.js";
+export type { FileRefKind, ArtifactFileRef, FileFileRef, UrlFileRef, BufferFileRef, FileRef, FileRefSchemaOptions, } from "./file-ref.js";
+export { IMAGE_OUTPUT_FORMATS } from "./image-output.js";
+export type { ImageOutputFormat, ImageOutputInfo } from "./image-output.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,12 +1,14 @@
 export { LATEST_ECP_VERSION } from "./version.js";
 export { ECP_FORMAT_CAPABILITY_NAMES, ECP_FORMATS, ECP_ENCODING_ERROR_CODES, } from "./encoding.js";
 export { ECP_PATCH_ERROR_CODES } from "./patch-errors.js";
-export { ECP_INVOKE_ERROR_CODES } from "./invoke.js";
+export { ECP_INVOKE_ERROR_CODES, httpStatusForInvokeResult } from "./invoke.js";
+export { CAPABILITY_EXECUTION } from "./capability-execution.js";
 export { ECP_MODEL_GENERATE_INTERFACE, ECP_MODEL_CAPABILITY_NAME, ECP_MODEL_RESPONSE_FORMATS, modelGenerateInputSchema, modelGenerateOutputSchema, } from "./model.js";
 export { ECP_HARNESS_CAPABILITY_NAME, ECP_HARNESS_ERROR_CODES, ECP_CORE_FORMATTER_IDS, harnessCapabilityId, harnessEvaluateOutputSchema, } from "./harness.js";
 export { ECP_INTENT_SCHEMA, ECP_INTENT_VALUES, ecpIntentSchema } from "./intent.js";
 export { harnessRunContextSchema, runResultSchema, stepRunRecordSchema, toHarnessRunContext, } from "./harness-run-context.js";
 export { ECP_HARNESS_REPLY_SCHEMA, ECP_HARNESS_REPLY_CITATION_KINDS, harnessReplySchema, harnessReplyCitationSchema, } from "./harness-reply.js";
 export { HARNESS_TASK_IDS, harnessChatInputSchema, harnessIntentClassificationInputSchema, harnessWorkflowAuthoringInputSchema, harnessWorkflowAssistantInputSchema, } from "./harness-tasks.js";
-export { IMAGE_REF_KINDS, IMAGE_OUTPUT_FORMATS, imageRefSchema, } from "./image.js";
+export { FILE_REF_KINDS, fileRefSchema, fileRefValueSchemaHint, isFileRefSchema, fileRefSchemaOptions, isFileRefKind, } from "./file-ref.js";
+export { IMAGE_OUTPUT_FORMATS } from "./image-output.js";
 //# sourceMappingURL=index.js.map