@automate.ax/api-contract 0.85.0 → 0.86.2

package/dist/index.d.ts

@@ -4,8 +4,8 @@ export { AUTOMATION_SDK_VERSION, deploymentOutputSchema, deploymentStatusSchema,
 export { AUTOMATION_RUNTIME_PROTOCOL_VERSION } from "./runtime-protocol.js";
 export { AUTOMATION_ERROR_CAUSE_DEPTH, automationErrorSchema, type AutomationErrorValue, } from "./errors.js";
 export { integrationAccountOutputSchema, integrationAccountRevocationImpactOutputSchema, integrationAccountRevocationOutputSchema, integrationServiceOutputSchema, } from "./account.js";
-export { AUTOMATION_INVOCATION_DEFAULT_ENTRYPOINT, AUTOMATION_INVOCATION_RESERVED_ENTRYPOINT_PREFIX, AUTOMATION_LOG_MAX_ENTRIES, AUTOMATION_LOG_MAX_MESSAGE_LENGTH, AUTOMATION_OBSERVABILITY_MAX_ENCODED_BYTES, AUTOMATION_OBSERVABILITY_MAX_FIELDS, AUTOMATION_TRACE_MAX_NAME_LENGTH, AUTOMATION_TRACE_MAX_SPANS, DEFAULT_GATEWAY_MODEL_ID, automationInvocationInputSchema, automationInvocationOutputSchema, automationInvocationScheduleSchema, generationInputSchema, generationResultSchema, hashSignalCoordinatorConfiguration, runtimeContract, type GenerationInput, type GenerationResult, type RuntimeGenerationInput, type RuntimeCoordinationOffer, } from "./runtime.js";
-export type { GatewayModelId } from "@ai-sdk/gateway";
+export { AUTOMATION_INVOCATION_DEFAULT_ENTRYPOINT, AUTOMATION_INVOCATION_RESERVED_ENTRYPOINT_PREFIX, AUTOMATION_IMAGE_GENERATION_ENTRYPOINT_PREFIX, AUTOMATION_LOG_MAX_ENTRIES, AUTOMATION_LOG_MAX_MESSAGE_LENGTH, AUTOMATION_OBSERVABILITY_MAX_ENCODED_BYTES, AUTOMATION_OBSERVABILITY_MAX_FIELDS, AUTOMATION_TRACE_MAX_NAME_LENGTH, AUTOMATION_TRACE_MAX_SPANS, DEFAULT_GATEWAY_IMAGE_MODEL_ID, DEFAULT_GATEWAY_MODEL_ID, automationInvocationInputSchema, automationInvocationOutputSchema, automationInvocationScheduleSchema, generationInputSchema, generationResultSchema, imageGenerationInputSchema, imageGenerationCompletionSchema, imageGenerationResultSchema, platformImageGenerationInputSchema, platformImageGenerationStartSchema, hashSignalCoordinatorConfiguration, runtimeContract, type GenerationInput, type GenerationResult, type ImageGenerationInput, type ImageGenerationCompletion, type ImageGenerationResult, type PlatformImageGenerationInput, type RuntimeGenerationInput, type RuntimeCoordinationOffer, } from "./runtime.js";
+export type { GatewayImageModelId, GatewayModelId } from "@ai-sdk/gateway";
 export { createdOrganizationApiKeyOutputSchema, organizationApiKeyOutputSchema, } from "./api-key.js";
 export { activeSubscriptionOutputSchema, createdInvitationOutputSchema, organizationDetailsOutputSchema, organizationInvitationOutputSchema, organizationMemberOutputSchema, organizationProjectOutputSchema, organizationRoleSchema, organizationSummaryOutputSchema, publicOrganizationOutputSchema, } from "./org.js";
 export { projectOutputSchema } from "./project.js";
@@ -2841,6 +2841,25 @@ export declare const contract: {
                 type: import("zod").ZodLiteral<"other">;
             }, import("zod/v4/core").$strip>], "type">>>;
         }, import("zod/v4/core").$strip>, Record<never, never>, Record<never, never>>;
+        startImageGeneration: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
+            aspectRatio: import("zod").ZodOptional<import("zod").ZodCustom<`${number}:${number}`, `${number}:${number}`>>;
+            headers: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+            maxImagesPerCall: import("zod").ZodOptional<import("zod").ZodNumber>;
+            maxRetries: import("zod").ZodOptional<import("zod").ZodNumber>;
+            model: import("zod").ZodDefault<import("zod").ZodCustom<import("@ai-sdk/gateway").GatewayImageModelId, import("@ai-sdk/gateway").GatewayImageModelId>>;
+            n: import("zod").ZodOptional<import("zod").ZodNumber>;
+            prompt: import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodObject<{
+                images: import("zod").ZodArray<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodCustom<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>, import("zod").ZodCustom<ArrayBuffer, ArrayBuffer>, import("zod").ZodCustom<Blob, Blob>]>>;
+                mask: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodCustom<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>, import("zod").ZodCustom<ArrayBuffer, ArrayBuffer>, import("zod").ZodCustom<Blob, Blob>]>>;
+                text: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>]>;
+            providerOptions: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodJSONSchema>>>;
+            seed: import("zod").ZodOptional<import("zod").ZodNumber>;
+            size: import("zod").ZodOptional<import("zod").ZodCustom<`${number}x${number}`, `${number}x${number}`>>;
+            entrypoint: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            key: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>, Record<never, never>, Record<never, never>>;
         createCallbackToken: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
             endpointKey: import("zod").ZodString;
         }, import("zod/v4/core").$strip>, import("zod").ZodString, Record<never, never>, Record<never, never>>;

package/dist/index.js

@@ -15,7 +15,7 @@ export { AUTOMATION_SDK_VERSION, deploymentOutputSchema, deploymentStatusSchema,
 export { AUTOMATION_RUNTIME_PROTOCOL_VERSION } from "./runtime-protocol.js";
 export { AUTOMATION_ERROR_CAUSE_DEPTH, automationErrorSchema, } from "./errors.js";
 export { integrationAccountOutputSchema, integrationAccountRevocationImpactOutputSchema, integrationAccountRevocationOutputSchema, integrationServiceOutputSchema, } from "./account.js";
-export { AUTOMATION_INVOCATION_DEFAULT_ENTRYPOINT, AUTOMATION_INVOCATION_RESERVED_ENTRYPOINT_PREFIX, AUTOMATION_LOG_MAX_ENTRIES, AUTOMATION_LOG_MAX_MESSAGE_LENGTH, AUTOMATION_OBSERVABILITY_MAX_ENCODED_BYTES, AUTOMATION_OBSERVABILITY_MAX_FIELDS, AUTOMATION_TRACE_MAX_NAME_LENGTH, AUTOMATION_TRACE_MAX_SPANS, DEFAULT_GATEWAY_MODEL_ID, automationInvocationInputSchema, automationInvocationOutputSchema, automationInvocationScheduleSchema, generationInputSchema, generationResultSchema, hashSignalCoordinatorConfiguration, runtimeContract, } from "./runtime.js";
+export { AUTOMATION_INVOCATION_DEFAULT_ENTRYPOINT, AUTOMATION_INVOCATION_RESERVED_ENTRYPOINT_PREFIX, AUTOMATION_IMAGE_GENERATION_ENTRYPOINT_PREFIX, AUTOMATION_LOG_MAX_ENTRIES, AUTOMATION_LOG_MAX_MESSAGE_LENGTH, AUTOMATION_OBSERVABILITY_MAX_ENCODED_BYTES, AUTOMATION_OBSERVABILITY_MAX_FIELDS, AUTOMATION_TRACE_MAX_NAME_LENGTH, AUTOMATION_TRACE_MAX_SPANS, DEFAULT_GATEWAY_IMAGE_MODEL_ID, DEFAULT_GATEWAY_MODEL_ID, automationInvocationInputSchema, automationInvocationOutputSchema, automationInvocationScheduleSchema, generationInputSchema, generationResultSchema, imageGenerationInputSchema, imageGenerationCompletionSchema, imageGenerationResultSchema, platformImageGenerationInputSchema, platformImageGenerationStartSchema, hashSignalCoordinatorConfiguration, runtimeContract, } from "./runtime.js";
 export { createdOrganizationApiKeyOutputSchema, organizationApiKeyOutputSchema, } from "./api-key.js";
 export { activeSubscriptionOutputSchema, createdInvitationOutputSchema, organizationDetailsOutputSchema, organizationInvitationOutputSchema, organizationMemberOutputSchema, organizationProjectOutputSchema, organizationRoleSchema, organizationSummaryOutputSchema, publicOrganizationOutputSchema, } from "./org.js";
 export { projectOutputSchema } from "./project.js";

package/dist/runtime.d.ts

@@ -1,17 +1,30 @@
 import { type SensitivityMask } from "@automate.ax/codec";
-import type { GatewayModelId } from "@ai-sdk/gateway";
+import type { GatewayImageModelId, GatewayModelId } from "@ai-sdk/gateway";
 import * as z from "zod";
-export type { GatewayModelId } from "@ai-sdk/gateway";
+export type { GatewayImageModelId, GatewayModelId } from "@ai-sdk/gateway";
 /** Default model used by the platform Vercel AI Gateway account. */
 export declare const DEFAULT_GATEWAY_MODEL_ID = "openai/gpt-4.1-nano";
+/** Default image model used by the platform Vercel AI Gateway account. */
+export declare const DEFAULT_GATEWAY_IMAGE_MODEL_ID = "bfl/flux-2-flex";
 export declare const AUTOMATION_INVOCATION_DEFAULT_ENTRYPOINT = "default";
 export declare const AUTOMATION_INVOCATION_RESERVED_ENTRYPOINT_PREFIX = "__$";
 export declare const AUTOMATION_DELAY_ENTRYPOINT_PREFIX: "__$delay:";
+export declare const AUTOMATION_IMAGE_GENERATION_ENTRYPOINT_PREFIX: "__$generate-image:";
 export declare const CALLBACK_PROTECTION_QUERY_PARAMETER = "_axCallback";
 export declare const AUTOMATION_LOG_MAX_ENTRIES = 1000;
 export declare const AUTOMATION_TRACE_MAX_SPANS = 250;
 export declare const AUTOMATION_OBSERVABILITY_MAX_FIELDS = 64;
 export declare const AUTOMATION_OBSERVABILITY_MAX_ENCODED_BYTES: number;
+/** Preserves Blob media types while oRPC carries the bytes as multipart data. */
+export declare const runtimeBlobJsonSerializer: {
+    type: number;
+    condition: (value: unknown) => boolean;
+    serialize(value: Blob): {
+        transportValue: Blob;
+        type: string;
+    };
+    deserialize(value: unknown): Blob;
+};
 export declare const AUTOMATION_LOG_MAX_MESSAGE_LENGTH = 16384;
 export declare const AUTOMATION_TRACE_MAX_NAME_LENGTH = 256;
 /** Runtime-validated structural policy for author-visible value projection. */
@@ -472,6 +485,124 @@ declare const RUNTIME_GENERATION_INPUT_SCHEMA: z.ZodUnion<readonly [z.ZodObject<
     }, z.core.$strip>>;
 }, z.core.$strip>]>;
 export type RuntimeGenerationInput = z.output<typeof RUNTIME_GENERATION_INPUT_SCHEMA>;
+/** Shared options accepted by the built-in image-generation action. */
+export declare const imageGenerationInputSchema: z.ZodObject<{
+    aspectRatio: z.ZodOptional<z.ZodCustom<`${number}:${number}`, `${number}:${number}`>>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    maxImagesPerCall: z.ZodOptional<z.ZodNumber>;
+    maxRetries: z.ZodOptional<z.ZodNumber>;
+    model: z.ZodDefault<z.ZodCustom<GatewayImageModelId, GatewayImageModelId>>;
+    n: z.ZodOptional<z.ZodNumber>;
+    prompt: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        images: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodCustom<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>, z.ZodCustom<ArrayBuffer, ArrayBuffer>, z.ZodCustom<Blob, Blob>]>>;
+        mask: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodCustom<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>, z.ZodCustom<ArrayBuffer, ArrayBuffer>, z.ZodCustom<Blob, Blob>]>>;
+        text: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>;
+    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodJSONSchema>>>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    size: z.ZodOptional<z.ZodCustom<`${number}x${number}`, `${number}x${number}`>>;
+}, z.core.$strip>;
+/** Serializable subset of the AI SDK image-generation result. */
+export declare const imageGenerationResultSchema: z.ZodObject<{
+    images: z.ZodArray<z.ZodCustom<Blob, Blob>>;
+    providerMetadata: z.ZodRecord<z.ZodString, z.ZodObject<{
+        images: z.ZodOptional<z.ZodArray<z.ZodJSONSchema>>;
+    }, z.core.$catchall<z.ZodJSONSchema>>>;
+    responses: z.ZodArray<z.ZodObject<{
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        modelId: z.ZodString;
+        timestamp: z.ZodISODateTime;
+    }, z.core.$strip>>;
+    usage: z.ZodObject<{
+        inputTokens: z.ZodOptional<z.ZodNumber>;
+        outputTokens: z.ZodOptional<z.ZodNumber>;
+        totalTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    warnings: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        details: z.ZodOptional<z.ZodString>;
+        feature: z.ZodString;
+        type: z.ZodLiteral<"unsupported">;
+    }, z.core.$strip>, z.ZodObject<{
+        details: z.ZodOptional<z.ZodString>;
+        feature: z.ZodString;
+        type: z.ZodLiteral<"compatibility">;
+    }, z.core.$strip>, z.ZodObject<{
+        message: z.ZodString;
+        setting: z.ZodString;
+        type: z.ZodLiteral<"deprecated">;
+    }, z.core.$strip>, z.ZodObject<{
+        message: z.ZodString;
+        type: z.ZodLiteral<"other">;
+    }, z.core.$strip>], "type">>;
+}, z.core.$strip>;
+/** Internal terminal delivery emitted by a platform image-generation job. */
+export declare const imageGenerationCompletionSchema: z.ZodObject<{
+    key: z.ZodString;
+    outcome: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        result: z.ZodObject<{
+            images: z.ZodArray<z.ZodCustom<Blob, Blob>>;
+            providerMetadata: z.ZodRecord<z.ZodString, z.ZodObject<{
+                images: z.ZodOptional<z.ZodArray<z.ZodJSONSchema>>;
+            }, z.core.$catchall<z.ZodJSONSchema>>>;
+            responses: z.ZodArray<z.ZodObject<{
+                headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                modelId: z.ZodString;
+                timestamp: z.ZodISODateTime;
+            }, z.core.$strip>>;
+            usage: z.ZodObject<{
+                inputTokens: z.ZodOptional<z.ZodNumber>;
+                outputTokens: z.ZodOptional<z.ZodNumber>;
+                totalTokens: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>;
+            warnings: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                details: z.ZodOptional<z.ZodString>;
+                feature: z.ZodString;
+                type: z.ZodLiteral<"unsupported">;
+            }, z.core.$strip>, z.ZodObject<{
+                details: z.ZodOptional<z.ZodString>;
+                feature: z.ZodString;
+                type: z.ZodLiteral<"compatibility">;
+            }, z.core.$strip>, z.ZodObject<{
+                message: z.ZodString;
+                setting: z.ZodString;
+                type: z.ZodLiteral<"deprecated">;
+            }, z.core.$strip>, z.ZodObject<{
+                message: z.ZodString;
+                type: z.ZodLiteral<"other">;
+            }, z.core.$strip>], "type">>;
+        }, z.core.$strip>;
+        status: z.ZodLiteral<"succeeded">;
+    }, z.core.$strip>, z.ZodObject<{
+        failure: z.ZodType<import("./errors").AutomationErrorValue, import("./errors").AutomationErrorValue, z.core.$ZodTypeInternals<import("./errors").AutomationErrorValue, import("./errors").AutomationErrorValue>>;
+        status: z.ZodLiteral<"failed">;
+    }, z.core.$strip>], "status">;
+}, z.core.$strip>;
+/** Starts platform image generation for one reserved internal entrypoint. */
+export declare const platformImageGenerationInputSchema: z.ZodObject<{
+    aspectRatio: z.ZodOptional<z.ZodCustom<`${number}:${number}`, `${number}:${number}`>>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    maxImagesPerCall: z.ZodOptional<z.ZodNumber>;
+    maxRetries: z.ZodOptional<z.ZodNumber>;
+    model: z.ZodDefault<z.ZodCustom<GatewayImageModelId, GatewayImageModelId>>;
+    n: z.ZodOptional<z.ZodNumber>;
+    prompt: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        images: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodCustom<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>, z.ZodCustom<ArrayBuffer, ArrayBuffer>, z.ZodCustom<Blob, Blob>]>>;
+        mask: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodCustom<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>, z.ZodCustom<ArrayBuffer, ArrayBuffer>, z.ZodCustom<Blob, Blob>]>>;
+        text: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>;
+    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodJSONSchema>>>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    size: z.ZodOptional<z.ZodCustom<`${number}x${number}`, `${number}x${number}`>>;
+    entrypoint: z.ZodString;
+}, z.core.$strip>;
+/** Durable identity returned after platform image generation is queued. */
+export declare const platformImageGenerationStartSchema: z.ZodObject<{
+    key: z.ZodString;
+}, z.core.$strip>;
+export type ImageGenerationInput = z.output<typeof imageGenerationInputSchema>;
+export type ImageGenerationResult = z.output<typeof imageGenerationResultSchema>;
+export type ImageGenerationCompletion = z.output<typeof imageGenerationCompletionSchema>;
+export type PlatformImageGenerationInput = z.output<typeof platformImageGenerationInputSchema>;
 /**
  * Hashes one coordinator definition exactly as the runtime stores it.
  *
@@ -1061,6 +1192,25 @@ export declare const runtimeContract: {
             type: z.ZodLiteral<"other">;
         }, z.core.$strip>], "type">>>;
     }, z.core.$strip>, Record<never, never>, Record<never, never>>;
+    startImageGeneration: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        aspectRatio: z.ZodOptional<z.ZodCustom<`${number}:${number}`, `${number}:${number}`>>;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        maxImagesPerCall: z.ZodOptional<z.ZodNumber>;
+        maxRetries: z.ZodOptional<z.ZodNumber>;
+        model: z.ZodDefault<z.ZodCustom<GatewayImageModelId, GatewayImageModelId>>;
+        n: z.ZodOptional<z.ZodNumber>;
+        prompt: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            images: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodCustom<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>, z.ZodCustom<ArrayBuffer, ArrayBuffer>, z.ZodCustom<Blob, Blob>]>>;
+            mask: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodCustom<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>, z.ZodCustom<ArrayBuffer, ArrayBuffer>, z.ZodCustom<Blob, Blob>]>>;
+            text: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>]>;
+        providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodJSONSchema>>>;
+        seed: z.ZodOptional<z.ZodNumber>;
+        size: z.ZodOptional<z.ZodCustom<`${number}x${number}`, `${number}x${number}`>>;
+        entrypoint: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        key: z.ZodString;
+    }, z.core.$strip>, Record<never, never>, Record<never, never>>;
     createCallbackToken: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
         endpointKey: z.ZodString;
     }, z.core.$strip>, z.ZodString, Record<never, never>, Record<never, never>>;

package/dist/runtime.js

@@ -5,14 +5,36 @@ import * as z from "zod";
 import { automationErrorSchema } from "./errors.js";
 /** Default model used by the platform Vercel AI Gateway account. */
 export const DEFAULT_GATEWAY_MODEL_ID = "openai/gpt-4.1-nano";
+/** Default image model used by the platform Vercel AI Gateway account. */
+export const DEFAULT_GATEWAY_IMAGE_MODEL_ID = "bfl/flux-2-flex";
 export const AUTOMATION_INVOCATION_DEFAULT_ENTRYPOINT = "default";
 export const AUTOMATION_INVOCATION_RESERVED_ENTRYPOINT_PREFIX = "__$";
 export const AUTOMATION_DELAY_ENTRYPOINT_PREFIX = `${AUTOMATION_INVOCATION_RESERVED_ENTRYPOINT_PREFIX}delay:`;
+export const AUTOMATION_IMAGE_GENERATION_ENTRYPOINT_PREFIX = `${AUTOMATION_INVOCATION_RESERVED_ENTRYPOINT_PREFIX}generate-image:`;
 export const CALLBACK_PROTECTION_QUERY_PARAMETER = "_axCallback";
 export const AUTOMATION_LOG_MAX_ENTRIES = 1_000;
 export const AUTOMATION_TRACE_MAX_SPANS = 250;
 export const AUTOMATION_OBSERVABILITY_MAX_FIELDS = 64;
 export const AUTOMATION_OBSERVABILITY_MAX_ENCODED_BYTES = 64 * 1_024;
+const RUNTIME_BLOB_JSON_SERIALIZER_TYPE = 8;
+/** Blob wrappers that should use oRPC's native multipart serialization. */
+const runtimeBlobTransportValues = new WeakSet();
+/** Preserves Blob media types while oRPC carries the bytes as multipart data. */
+export const runtimeBlobJsonSerializer = {
+    type: RUNTIME_BLOB_JSON_SERIALIZER_TYPE,
+    condition: (value) => value instanceof Blob && !runtimeBlobTransportValues.has(value),
+    serialize(value) {
+        const transportValue = new Blob([value]);
+        runtimeBlobTransportValues.add(transportValue);
+        return { transportValue, type: value.type };
+    },
+    deserialize(value) {
+        const { transportValue, type } = z
+            .object({ transportValue: z.instanceof(Blob), type: z.string() })
+            .parse(value);
+        return new Blob([transportValue], { type });
+    },
+};
 export const AUTOMATION_LOG_MAX_MESSAGE_LENGTH = 16_384;
 export const AUTOMATION_TRACE_MAX_NAME_LENGTH = 256;
 const OUTCOME_SEQUENCE_SCHEMA = z.number().int().positive();
@@ -482,7 +504,7 @@ const TARGET_ACTION_SCHEMA = z.union([
         status: z.enum(["failed", "skipped", "succeeded"]),
     }),
 ]);
-const GENERATION_WARNING_SCHEMA = z.discriminatedUnion("type", [
+const AI_WARNING_SCHEMA = z.discriminatedUnion("type", [
     z.object({
         details: z.string().optional(),
         feature: z.string(),
@@ -580,7 +602,7 @@ export const generationResultSchema = z.object({
     }),
     text: z.string(),
     usage: GENERATION_USAGE_SCHEMA,
-    warnings: GENERATION_WARNING_SCHEMA.array().optional(),
+    warnings: AI_WARNING_SCHEMA.array().optional(),
 });
 const RUNTIME_GENERATION_OUTPUT_SCHEMA = z
     .object({
@@ -597,6 +619,84 @@ const RUNTIME_GENERATION_INPUT_SCHEMA = z.union([
         output: RUNTIME_GENERATION_OUTPUT_SCHEMA,
     }),
 ]);
+const IMAGE_DATA_CONTENT_SCHEMA = z.union([
+    z.string(),
+    z.custom((value) => value instanceof Uint8Array),
+    z.instanceof(ArrayBuffer),
+    z.instanceof(Blob),
+]);
+const IMAGE_GENERATION_PROMPT_SCHEMA = z.union([
+    z.string(),
+    z.object({
+        images: IMAGE_DATA_CONTENT_SCHEMA.array(),
+        mask: IMAGE_DATA_CONTENT_SCHEMA.optional(),
+        text: z.string().optional(),
+    }),
+]);
+const GATEWAY_IMAGE_MODEL_ID_SCHEMA = z
+    .custom((value) => typeof value === "string" && value.length > 0, "Model must be a nonempty AI Gateway image model ID.")
+    .default(DEFAULT_GATEWAY_IMAGE_MODEL_ID);
+/** Shared options accepted by the built-in image-generation action. */
+export const imageGenerationInputSchema = z.object({
+    aspectRatio: z
+        .custom((value) => typeof value === "string" && /^\d+(?:\.\d+)?:\d+(?:\.\d+)?$/.test(value), "Aspect ratio must use the format {width}:{height}.")
+        .optional(),
+    headers: z.record(z.string(), z.string()).optional(),
+    maxImagesPerCall: z.number().int().positive().optional(),
+    maxRetries: z.number().int().nonnegative().optional(),
+    model: GATEWAY_IMAGE_MODEL_ID_SCHEMA,
+    n: z.number().int().positive().optional(),
+    prompt: IMAGE_GENERATION_PROMPT_SCHEMA,
+    providerOptions: z
+        .record(z.string(), z.record(z.string(), z.json()))
+        .optional(),
+    seed: z.number().int().optional(),
+    size: z
+        .custom((value) => typeof value === "string" && /^\d+x\d+$/.test(value), "Size must use the format {width}x{height}.")
+        .optional(),
+});
+const IMAGE_PROVIDER_METADATA_SCHEMA = z
+    .object({ images: z.json().array().optional() })
+    .catchall(z.json());
+/** Serializable subset of the AI SDK image-generation result. */
+export const imageGenerationResultSchema = z.object({
+    images: z.instanceof(Blob).array().min(1),
+    providerMetadata: z.record(z.string(), IMAGE_PROVIDER_METADATA_SCHEMA),
+    responses: z
+        .object({
+        headers: z.record(z.string(), z.string()).optional(),
+        modelId: z.string(),
+        timestamp: z.iso.datetime(),
+    })
+        .array(),
+    usage: z.object({
+        inputTokens: z.number().optional(),
+        outputTokens: z.number().optional(),
+        totalTokens: z.number().optional(),
+    }),
+    warnings: AI_WARNING_SCHEMA.array(),
+});
+/** Internal terminal delivery emitted by a platform image-generation job. */
+export const imageGenerationCompletionSchema = z.object({
+    key: z.string().min(1),
+    outcome: z.discriminatedUnion("status", [
+        z.object({
+            result: imageGenerationResultSchema,
+            status: z.literal("succeeded"),
+        }),
+        z.object({ failure: automationErrorSchema, status: z.literal("failed") }),
+    ]),
+});
+/** Starts platform image generation for one reserved internal entrypoint. */
+export const platformImageGenerationInputSchema = imageGenerationInputSchema.extend({
+    entrypoint: z
+        .string()
+        .startsWith(AUTOMATION_IMAGE_GENERATION_ENTRYPOINT_PREFIX),
+});
+/** Durable identity returned after platform image generation is queued. */
+export const platformImageGenerationStartSchema = z.object({
+    key: z.string().min(1),
+});
 /**
  * Hashes one coordinator definition exactly as the runtime stores it.
  *
@@ -667,6 +767,9 @@ export const runtimeContract = {
     generate: oc
         .input(RUNTIME_GENERATION_INPUT_SCHEMA)
         .output(generationResultSchema),
+    startImageGeneration: oc
+        .input(platformImageGenerationInputSchema)
+        .output(platformImageGenerationStartSchema),
     createCallbackToken: oc
         .input(z.object({ endpointKey: z.string().min(1) }))
         .output(z.string()),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automate.ax/api-contract",
-  "version": "0.85.0",
+  "version": "0.86.2",
   "description": "Public oRPC contract for the Automate.ax API.",
   "license": "MIT",
   "repository": {
@@ -30,9 +30,9 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/gateway": "^4.0.46",
-    "@automate.ax/codec": "0.85.0",
-    "@automate.ax/integration-contracts": "0.85.0",
+    "@ai-sdk/gateway": "4.0.46",
+    "@automate.ax/codec": "0.86.2",
+    "@automate.ax/integration-contracts": "0.86.2",
     "@orpc/contract": "1.15.0",
     "fast-json-stable-stringify": "^2.1.0",
     "zod": "^4.3.6"

package/src/index.ts

@@ -44,26 +44,37 @@ export {
 export {
   AUTOMATION_INVOCATION_DEFAULT_ENTRYPOINT,
   AUTOMATION_INVOCATION_RESERVED_ENTRYPOINT_PREFIX,
+  AUTOMATION_IMAGE_GENERATION_ENTRYPOINT_PREFIX,
   AUTOMATION_LOG_MAX_ENTRIES,
   AUTOMATION_LOG_MAX_MESSAGE_LENGTH,
   AUTOMATION_OBSERVABILITY_MAX_ENCODED_BYTES,
   AUTOMATION_OBSERVABILITY_MAX_FIELDS,
   AUTOMATION_TRACE_MAX_NAME_LENGTH,
   AUTOMATION_TRACE_MAX_SPANS,
+  DEFAULT_GATEWAY_IMAGE_MODEL_ID,
   DEFAULT_GATEWAY_MODEL_ID,
   automationInvocationInputSchema,
   automationInvocationOutputSchema,
   automationInvocationScheduleSchema,
   generationInputSchema,
   generationResultSchema,
+  imageGenerationInputSchema,
+  imageGenerationCompletionSchema,
+  imageGenerationResultSchema,
+  platformImageGenerationInputSchema,
+  platformImageGenerationStartSchema,
   hashSignalCoordinatorConfiguration,
   runtimeContract,
   type GenerationInput,
   type GenerationResult,
+  type ImageGenerationInput,
+  type ImageGenerationCompletion,
+  type ImageGenerationResult,
+  type PlatformImageGenerationInput,
   type RuntimeGenerationInput,
   type RuntimeCoordinationOffer,
 } from "./runtime"
-export type { GatewayModelId } from "@ai-sdk/gateway"
+export type { GatewayImageModelId, GatewayModelId } from "@ai-sdk/gateway"
 export {
   createdOrganizationApiKeyOutputSchema,
   organizationApiKeyOutputSchema,

package/src/runtime.ts

@@ -3,26 +3,55 @@ import {
   isSensitivityMask,
   type SensitivityMask,
 } from "@automate.ax/codec"
-import type { GatewayModelId } from "@ai-sdk/gateway"
+import type { GatewayImageModelId, GatewayModelId } from "@ai-sdk/gateway"
 import { oc } from "@orpc/contract"
 import stableStringify from "fast-json-stable-stringify"
 import * as z from "zod"
 import { automationErrorSchema } from "./errors"
 
-export type { GatewayModelId } from "@ai-sdk/gateway"
+export type { GatewayImageModelId, GatewayModelId } from "@ai-sdk/gateway"
 
 /** Default model used by the platform Vercel AI Gateway account. */
 export const DEFAULT_GATEWAY_MODEL_ID =
   "openai/gpt-4.1-nano" satisfies GatewayModelId
+
+/** Default image model used by the platform Vercel AI Gateway account. */
+export const DEFAULT_GATEWAY_IMAGE_MODEL_ID =
+  "bfl/flux-2-flex" satisfies GatewayImageModelId
 export const AUTOMATION_INVOCATION_DEFAULT_ENTRYPOINT = "default"
 export const AUTOMATION_INVOCATION_RESERVED_ENTRYPOINT_PREFIX = "__$"
 export const AUTOMATION_DELAY_ENTRYPOINT_PREFIX =
   `${AUTOMATION_INVOCATION_RESERVED_ENTRYPOINT_PREFIX}delay:` as const
+export const AUTOMATION_IMAGE_GENERATION_ENTRYPOINT_PREFIX =
+  `${AUTOMATION_INVOCATION_RESERVED_ENTRYPOINT_PREFIX}generate-image:` as const
 export const CALLBACK_PROTECTION_QUERY_PARAMETER = "_axCallback"
 export const AUTOMATION_LOG_MAX_ENTRIES = 1_000
 export const AUTOMATION_TRACE_MAX_SPANS = 250
 export const AUTOMATION_OBSERVABILITY_MAX_FIELDS = 64
 export const AUTOMATION_OBSERVABILITY_MAX_ENCODED_BYTES = 64 * 1_024
+
+const RUNTIME_BLOB_JSON_SERIALIZER_TYPE = 8
+
+/** Blob wrappers that should use oRPC's native multipart serialization. */
+const runtimeBlobTransportValues = new WeakSet<Blob>()
+
+/** Preserves Blob media types while oRPC carries the bytes as multipart data. */
+export const runtimeBlobJsonSerializer = {
+  type: RUNTIME_BLOB_JSON_SERIALIZER_TYPE,
+  condition: (value: unknown) =>
+    value instanceof Blob && !runtimeBlobTransportValues.has(value),
+  serialize(value: Blob) {
+    const transportValue = new Blob([value])
+    runtimeBlobTransportValues.add(transportValue)
+    return { transportValue, type: value.type }
+  },
+  deserialize(value: unknown) {
+    const { transportValue, type } = z
+      .object({ transportValue: z.instanceof(Blob), type: z.string() })
+      .parse(value)
+    return new Blob([transportValue], { type })
+  },
+}
 export const AUTOMATION_LOG_MAX_MESSAGE_LENGTH = 16_384
 export const AUTOMATION_TRACE_MAX_NAME_LENGTH = 256
 
@@ -552,7 +581,7 @@ const TARGET_ACTION_SCHEMA = z.union([
   }),
 ])
 
-const GENERATION_WARNING_SCHEMA = z.discriminatedUnion("type", [
+const AI_WARNING_SCHEMA = z.discriminatedUnion("type", [
   z.object({
     details: z.string().optional(),
     feature: z.string(),
@@ -660,7 +689,7 @@ export const generationResultSchema = z.object({
   }),
   text: z.string(),
   usage: GENERATION_USAGE_SCHEMA,
-  warnings: GENERATION_WARNING_SCHEMA.array().optional(),
+  warnings: AI_WARNING_SCHEMA.array().optional(),
 })
 
 export type GenerationInput = z.output<typeof generationInputSchema>
@@ -687,6 +716,106 @@ export type RuntimeGenerationInput = z.output<
   typeof RUNTIME_GENERATION_INPUT_SCHEMA
 >
 
+const IMAGE_DATA_CONTENT_SCHEMA = z.union([
+  z.string(),
+  z.custom<Uint8Array>((value) => value instanceof Uint8Array),
+  z.instanceof(ArrayBuffer),
+  z.instanceof(Blob),
+])
+
+const IMAGE_GENERATION_PROMPT_SCHEMA = z.union([
+  z.string(),
+  z.object({
+    images: IMAGE_DATA_CONTENT_SCHEMA.array(),
+    mask: IMAGE_DATA_CONTENT_SCHEMA.optional(),
+    text: z.string().optional(),
+  }),
+])
+
+const GATEWAY_IMAGE_MODEL_ID_SCHEMA = z
+  .custom<GatewayImageModelId>(
+    (value) => typeof value === "string" && value.length > 0,
+    "Model must be a nonempty AI Gateway image model ID.",
+  )
+  .default(DEFAULT_GATEWAY_IMAGE_MODEL_ID)
+
+/** Shared options accepted by the built-in image-generation action. */
+export const imageGenerationInputSchema = z.object({
+  aspectRatio: z
+    .custom<`${number}:${number}`>((value) => typeof value === "string" && /^\d+(?:\.\d+)?:\d+(?:\.\d+)?$/.test(value), "Aspect ratio must use the format {width}:{height}.")
+    .optional(),
+  headers: z.record(z.string(), z.string()).optional(),
+  maxImagesPerCall: z.number().int().positive().optional(),
+  maxRetries: z.number().int().nonnegative().optional(),
+  model: GATEWAY_IMAGE_MODEL_ID_SCHEMA,
+  n: z.number().int().positive().optional(),
+  prompt: IMAGE_GENERATION_PROMPT_SCHEMA,
+  providerOptions: z
+    .record(z.string(), z.record(z.string(), z.json()))
+    .optional(),
+  seed: z.number().int().optional(),
+  size: z
+    .custom<`${number}x${number}`>((value) => typeof value === "string" && /^\d+x\d+$/.test(value), "Size must use the format {width}x{height}.")
+    .optional(),
+})
+
+const IMAGE_PROVIDER_METADATA_SCHEMA = z
+  .object({ images: z.json().array().optional() })
+  .catchall(z.json())
+
+/** Serializable subset of the AI SDK image-generation result. */
+export const imageGenerationResultSchema = z.object({
+  images: z.instanceof(Blob).array().min(1),
+  providerMetadata: z.record(z.string(), IMAGE_PROVIDER_METADATA_SCHEMA),
+  responses: z
+    .object({
+      headers: z.record(z.string(), z.string()).optional(),
+      modelId: z.string(),
+      timestamp: z.iso.datetime(),
+    })
+    .array(),
+  usage: z.object({
+    inputTokens: z.number().optional(),
+    outputTokens: z.number().optional(),
+    totalTokens: z.number().optional(),
+  }),
+  warnings: AI_WARNING_SCHEMA.array(),
+})
+
+/** Internal terminal delivery emitted by a platform image-generation job. */
+export const imageGenerationCompletionSchema = z.object({
+  key: z.string().min(1),
+  outcome: z.discriminatedUnion("status", [
+    z.object({
+      result: imageGenerationResultSchema,
+      status: z.literal("succeeded"),
+    }),
+    z.object({ failure: automationErrorSchema, status: z.literal("failed") }),
+  ]),
+})
+
+/** Starts platform image generation for one reserved internal entrypoint. */
+export const platformImageGenerationInputSchema =
+  imageGenerationInputSchema.extend({
+    entrypoint: z
+      .string()
+      .startsWith(AUTOMATION_IMAGE_GENERATION_ENTRYPOINT_PREFIX),
+  })
+
+/** Durable identity returned after platform image generation is queued. */
+export const platformImageGenerationStartSchema = z.object({
+  key: z.string().min(1),
+})
+
+export type ImageGenerationInput = z.output<typeof imageGenerationInputSchema>
+export type ImageGenerationResult = z.output<typeof imageGenerationResultSchema>
+export type ImageGenerationCompletion = z.output<
+  typeof imageGenerationCompletionSchema
+>
+export type PlatformImageGenerationInput = z.output<
+  typeof platformImageGenerationInputSchema
+>
+
 /**
  * Hashes one coordinator definition exactly as the runtime stores it.
  *
@@ -778,6 +907,9 @@ export const runtimeContract = {
   generate: oc
     .input(RUNTIME_GENERATION_INPUT_SCHEMA)
     .output(generationResultSchema),
+  startImageGeneration: oc
+    .input(platformImageGenerationInputSchema)
+    .output(platformImageGenerationStartSchema),
   createCallbackToken: oc
     .input(z.object({ endpointKey: z.string().min(1) }))
     .output(z.string()),