@fungi.computer/darkroom 0.0.0-stage → 0.1.0

package/dist/app-media-contracts.d.ts

@@ -0,0 +1,499 @@
+import * as z from "zod";
+/** Bounded catalog decoded by the App media broker before host filtering. */
+export declare const mediaModelsSchema: z.ZodLazy<z.ZodArray<z.ZodReadonly<z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    kind: z.ZodEnum<{
+        readonly image: "image";
+        readonly video: "video";
+    }>;
+    tier: z.ZodEnum<{
+        readonly draft: "draft";
+        readonly balanced: "balanced";
+        readonly premium: "premium";
+        readonly max: "max";
+    }>;
+    outputFormats: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+        readonly png: "png";
+        readonly jpeg: "jpeg";
+        readonly webp: "webp";
+    }>>>;
+    input: z.ZodLazy<z.ZodReadonly<z.ZodObject<{
+        transport: z.ZodEnum<{
+            readonly json: "json";
+            readonly multipart: "multipart";
+        }>;
+        dimensions: z.ZodEnum<{
+            readonly none: "none";
+            readonly own: "own";
+        }>;
+        maxDimension: z.ZodNullable<z.ZodNumber>;
+        defaultWidth: z.ZodNumber;
+        defaultHeight: z.ZodNumber;
+        steps: z.ZodEnum<{
+            readonly steps: "steps";
+            readonly num_steps: "num_steps";
+            readonly fixed: "fixed";
+        }>;
+        maxSteps: z.ZodNullable<z.ZodNumber>;
+        defaultSteps: z.ZodNullable<z.ZodNumber>;
+        referenceField: z.ZodNullable<z.ZodString>;
+        maxReferences: z.ZodNumber;
+    }, z.core.$strict>>>;
+    sizes: z.ZodNullable<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+    video: z.ZodNullable<z.ZodLazy<z.ZodReadonly<z.ZodObject<{
+        minSeconds: z.ZodNumber;
+        maxSeconds: z.ZodNumber;
+        defaultSeconds: z.ZodNumber;
+        durations: z.ZodReadonly<z.ZodArray<z.ZodNumber>>;
+        provider: z.ZodEnum<{
+            readonly seedance: "seedance";
+            readonly veo: "veo";
+            readonly minimax: "minimax";
+        }>;
+        formats: z.ZodReadonly<z.ZodArray<z.ZodLazy<z.ZodReadonly<z.ZodObject<{
+            resolution: z.ZodEnum<{
+                readonly p480: "480p";
+                readonly p720: "720p";
+                readonly p768: "768p";
+                readonly p1080: "1080p";
+                readonly p4k: "4k";
+            }>;
+            aspectRatio: z.ZodEnum<{
+                readonly wide: "16:9";
+                readonly landscape: "4:3";
+                readonly square: "1:1";
+                readonly portrait: "3:4";
+                readonly tall: "9:16";
+                readonly ultrawide: "21:9";
+                readonly ultratall: "9:21";
+            }>;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>>>>>;
+        defaultResolution: z.ZodEnum<{
+            readonly p480: "480p";
+            readonly p720: "720p";
+            readonly p768: "768p";
+            readonly p1080: "1080p";
+            readonly p4k: "4k";
+        }>;
+        defaultAspectRatio: z.ZodEnum<{
+            readonly wide: "16:9";
+            readonly landscape: "4:3";
+            readonly square: "1:1";
+            readonly portrait: "3:4";
+            readonly tall: "9:16";
+            readonly ultrawide: "21:9";
+            readonly ultratall: "9:21";
+        }>;
+        defaultGenerateAudio: z.ZodNullable<z.ZodBoolean>;
+        maxPromptLength: z.ZodNumber;
+        referenceRoles: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+            readonly first: "first-frame";
+            readonly last: "last-frame";
+            readonly reference: "reference";
+        }>>>;
+        maxReferenceImages: z.ZodNumber;
+        referenceResolutions: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+            readonly p480: "480p";
+            readonly p720: "720p";
+            readonly p768: "768p";
+            readonly p1080: "1080p";
+            readonly p4k: "4k";
+        }>>>;
+        prices: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
+            resolution: z.ZodEnum<{
+                readonly p480: "480p";
+                readonly p720: "720p";
+                readonly p768: "768p";
+                readonly p1080: "1080p";
+                readonly p4k: "4k";
+            }>;
+            silentMilliunitsPerSecond: z.ZodNumber;
+            audioMilliunitsPerSecond: z.ZodNumber;
+        }, z.core.$strict>>>>;
+    }, z.core.$strict>>>>;
+}, z.core.$strict>>>>;
+/** An absolute output path on the Computer admitted by the App host. */
+export declare const destinationSchema: z.ZodObject<{
+    computerId: z.ZodString;
+    path: z.ZodString;
+}, z.core.$strict>;
+/** Completed App generation output, with its admitted Computer destination. */
+export declare const appMediaGenerationResultSchema: z.ZodObject<{
+    format: z.ZodEnum<{
+        readonly png: "png";
+        readonly jpeg: "jpeg";
+        readonly gif: "gif";
+        readonly webp: "webp";
+        readonly mp4: "mp4";
+    }>;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    bytes: z.ZodNumber;
+    model: z.ZodString;
+    costMilliunits: z.ZodNumber;
+    destination: z.ZodObject<{
+        computerId: z.ZodString;
+        path: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+/** Authority refusals emitted by Media admission before a host call. */
+export declare const appMediaAdmissionErrorSchema: z.ZodObject<{
+    error: z.ZodEnum<{
+        /** The captured App selection or attachment changed. */
+        readonly revoked: "revoked";
+        /** The caller does not hold this Media grant. */
+        readonly not_granted: "not_granted";
+        /** The attachment's grantor no longer holds authority. */
+        readonly grantor_lost_authority: "grantor_lost_authority";
+        /** Admission could not resolve the current resource. */
+        readonly unavailable: "unavailable";
+    }>;
+}, z.core.$strict>;
+/** Attachment budget refusal emitted by the Media reservation owner. */
+export declare const appMediaBudgetRefusalSchema: z.ZodLazy<z.ZodObject<{
+    error: z.ZodLiteral<"attachment_budget_exceeded">;
+    kind: z.ZodLiteral<"media">;
+    retryAfterMs: z.ZodNumber;
+}, z.core.$strict>>;
+/** Existing Media admission refusals, without an admitted selector or callable. */
+export declare const appMediaAdmissionRefusalSchema: z.ZodUnion<readonly [z.ZodObject<{
+    error: z.ZodEnum<{
+        /** The captured App selection or attachment changed. */
+        readonly revoked: "revoked";
+        /** The caller does not hold this Media grant. */
+        readonly not_granted: "not_granted";
+        /** The attachment's grantor no longer holds authority. */
+        readonly grantor_lost_authority: "grantor_lost_authority";
+        /** Admission could not resolve the current resource. */
+        readonly unavailable: "unavailable";
+    }>;
+}, z.core.$strict>, z.ZodLazy<z.ZodObject<{
+    error: z.ZodLiteral<"attachment_budget_exceeded">;
+    kind: z.ZodLiteral<"media">;
+    retryAfterMs: z.ZodNumber;
+}, z.core.$strict>>]>;
+/** Admission errors plus invalid/oversized inputs emitted directly by the broker. */
+export declare const appMediaBrokerErrorSchema: z.ZodObject<{
+    error: z.ZodEnum<{
+        /** The broker refused the input representation or selection. */
+        readonly invalid: "invalid";
+        /** The input exceeds the existing broker byte ceiling. */
+        readonly too_large: "too_large";
+        /** The captured App selection or attachment changed. */
+        readonly revoked: "revoked";
+        /** The caller does not hold this Media grant. */
+        readonly not_granted: "not_granted";
+        /** The attachment's grantor no longer holds authority. */
+        readonly grantor_lost_authority: "grantor_lost_authority";
+        /** Admission could not resolve the current resource. */
+        readonly unavailable: "unavailable";
+    }>;
+}, z.core.$strict>;
+/** Missing-library refusal decoded and returned by the App media broker. */
+export declare const agentAppMediaLibraryFailureSchema: z.ZodLazy<z.ZodObject<{
+    error: z.ZodLiteral<"library_unavailable">;
+    message: z.ZodString;
+}, z.core.$strict>>;
+/** Broker projection of an HTTP failure: code becomes error and error becomes message. */
+export declare const appMediaBrokerFailureSchema: z.ZodObject<{
+    error: z.ZodEnum<{
+        readonly CAPABILITY_DENIED: "CAPABILITY_DENIED";
+        readonly INSUFFICIENT_CREDIT: "INSUFFICIENT_CREDIT";
+        readonly HOST_FAILURE: "HOST_FAILURE";
+        readonly INVALID_ARGUMENT: "INVALID_ARGUMENT";
+        readonly SAFETY_FILTER_REFUSED: "SAFETY_FILTER_REFUSED";
+    }>;
+    message: z.ZodString;
+    stage: z.ZodEnum<{
+        readonly admission: "admission";
+        readonly "generation-authorization": "generation-authorization";
+        readonly settings: "settings";
+        readonly estimate: "estimate";
+        readonly billing: "billing";
+        readonly operation: "operation";
+        readonly provider: "provider";
+        readonly normalization: "normalization";
+        readonly artifact: "artifact";
+        readonly "destination-authorization": "destination-authorization";
+        readonly "destination-write": "destination-write";
+    }>;
+    retryable: z.ZodBoolean;
+}, z.core.$strict>;
+/** Refusal payloads emitted by the App media broker, separate from transport errors. */
+export declare const appMediaRefusalSchema: z.ZodUnion<readonly [z.ZodObject<{
+    error: z.ZodEnum<{
+        /** The broker refused the input representation or selection. */
+        readonly invalid: "invalid";
+        /** The input exceeds the existing broker byte ceiling. */
+        readonly too_large: "too_large";
+        /** The captured App selection or attachment changed. */
+        readonly revoked: "revoked";
+        /** The caller does not hold this Media grant. */
+        readonly not_granted: "not_granted";
+        /** The attachment's grantor no longer holds authority. */
+        readonly grantor_lost_authority: "grantor_lost_authority";
+        /** Admission could not resolve the current resource. */
+        readonly unavailable: "unavailable";
+    }>;
+}, z.core.$strict>, z.ZodLazy<z.ZodObject<{
+    error: z.ZodLiteral<"attachment_budget_exceeded">;
+    kind: z.ZodLiteral<"media">;
+    retryAfterMs: z.ZodNumber;
+}, z.core.$strict>>, z.ZodLazy<z.ZodObject<{
+    error: z.ZodLiteral<"library_unavailable">;
+    message: z.ZodString;
+}, z.core.$strict>>, z.ZodObject<{
+    error: z.ZodEnum<{
+        readonly CAPABILITY_DENIED: "CAPABILITY_DENIED";
+        readonly INSUFFICIENT_CREDIT: "INSUFFICIENT_CREDIT";
+        readonly HOST_FAILURE: "HOST_FAILURE";
+        readonly INVALID_ARGUMENT: "INVALID_ARGUMENT";
+        readonly SAFETY_FILTER_REFUSED: "SAFETY_FILTER_REFUSED";
+    }>;
+    message: z.ZodString;
+    stage: z.ZodEnum<{
+        readonly admission: "admission";
+        readonly "generation-authorization": "generation-authorization";
+        readonly settings: "settings";
+        readonly estimate: "estimate";
+        readonly billing: "billing";
+        readonly operation: "operation";
+        readonly provider: "provider";
+        readonly normalization: "normalization";
+        readonly artifact: "artifact";
+        readonly "destination-authorization": "destination-authorization";
+        readonly "destination-write": "destination-write";
+    }>;
+    retryable: z.ZodBoolean;
+}, z.core.$strict>]>;
+/** Model-list payload or an existing broker refusal. */
+export declare const appMediaModelsOutcomeSchema: z.ZodUnion<readonly [z.ZodLazy<z.ZodArray<z.ZodReadonly<z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    kind: z.ZodEnum<{
+        readonly image: "image";
+        readonly video: "video";
+    }>;
+    tier: z.ZodEnum<{
+        readonly draft: "draft";
+        readonly balanced: "balanced";
+        readonly premium: "premium";
+        readonly max: "max";
+    }>;
+    outputFormats: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+        readonly png: "png";
+        readonly jpeg: "jpeg";
+        readonly webp: "webp";
+    }>>>;
+    input: z.ZodLazy<z.ZodReadonly<z.ZodObject<{
+        transport: z.ZodEnum<{
+            readonly json: "json";
+            readonly multipart: "multipart";
+        }>;
+        dimensions: z.ZodEnum<{
+            readonly none: "none";
+            readonly own: "own";
+        }>;
+        maxDimension: z.ZodNullable<z.ZodNumber>;
+        defaultWidth: z.ZodNumber;
+        defaultHeight: z.ZodNumber;
+        steps: z.ZodEnum<{
+            readonly steps: "steps";
+            readonly num_steps: "num_steps";
+            readonly fixed: "fixed";
+        }>;
+        maxSteps: z.ZodNullable<z.ZodNumber>;
+        defaultSteps: z.ZodNullable<z.ZodNumber>;
+        referenceField: z.ZodNullable<z.ZodString>;
+        maxReferences: z.ZodNumber;
+    }, z.core.$strict>>>;
+    sizes: z.ZodNullable<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+    video: z.ZodNullable<z.ZodLazy<z.ZodReadonly<z.ZodObject<{
+        minSeconds: z.ZodNumber;
+        maxSeconds: z.ZodNumber;
+        defaultSeconds: z.ZodNumber;
+        durations: z.ZodReadonly<z.ZodArray<z.ZodNumber>>;
+        provider: z.ZodEnum<{
+            readonly seedance: "seedance";
+            readonly veo: "veo";
+            readonly minimax: "minimax";
+        }>;
+        formats: z.ZodReadonly<z.ZodArray<z.ZodLazy<z.ZodReadonly<z.ZodObject<{
+            resolution: z.ZodEnum<{
+                readonly p480: "480p";
+                readonly p720: "720p";
+                readonly p768: "768p";
+                readonly p1080: "1080p";
+                readonly p4k: "4k";
+            }>;
+            aspectRatio: z.ZodEnum<{
+                readonly wide: "16:9";
+                readonly landscape: "4:3";
+                readonly square: "1:1";
+                readonly portrait: "3:4";
+                readonly tall: "9:16";
+                readonly ultrawide: "21:9";
+                readonly ultratall: "9:21";
+            }>;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>>>>>;
+        defaultResolution: z.ZodEnum<{
+            readonly p480: "480p";
+            readonly p720: "720p";
+            readonly p768: "768p";
+            readonly p1080: "1080p";
+            readonly p4k: "4k";
+        }>;
+        defaultAspectRatio: z.ZodEnum<{
+            readonly wide: "16:9";
+            readonly landscape: "4:3";
+            readonly square: "1:1";
+            readonly portrait: "3:4";
+            readonly tall: "9:16";
+            readonly ultrawide: "21:9";
+            readonly ultratall: "9:21";
+        }>;
+        defaultGenerateAudio: z.ZodNullable<z.ZodBoolean>;
+        maxPromptLength: z.ZodNumber;
+        referenceRoles: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+            readonly first: "first-frame";
+            readonly last: "last-frame";
+            readonly reference: "reference";
+        }>>>;
+        maxReferenceImages: z.ZodNumber;
+        referenceResolutions: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+            readonly p480: "480p";
+            readonly p720: "720p";
+            readonly p768: "768p";
+            readonly p1080: "1080p";
+            readonly p4k: "4k";
+        }>>>;
+        prices: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
+            resolution: z.ZodEnum<{
+                readonly p480: "480p";
+                readonly p720: "720p";
+                readonly p768: "768p";
+                readonly p1080: "1080p";
+                readonly p4k: "4k";
+            }>;
+            silentMilliunitsPerSecond: z.ZodNumber;
+            audioMilliunitsPerSecond: z.ZodNumber;
+        }, z.core.$strict>>>>;
+    }, z.core.$strict>>>>;
+}, z.core.$strict>>>>, z.ZodUnion<readonly [z.ZodObject<{
+    error: z.ZodEnum<{
+        /** The broker refused the input representation or selection. */
+        readonly invalid: "invalid";
+        /** The input exceeds the existing broker byte ceiling. */
+        readonly too_large: "too_large";
+        /** The captured App selection or attachment changed. */
+        readonly revoked: "revoked";
+        /** The caller does not hold this Media grant. */
+        readonly not_granted: "not_granted";
+        /** The attachment's grantor no longer holds authority. */
+        readonly grantor_lost_authority: "grantor_lost_authority";
+        /** Admission could not resolve the current resource. */
+        readonly unavailable: "unavailable";
+    }>;
+}, z.core.$strict>, z.ZodLazy<z.ZodObject<{
+    error: z.ZodLiteral<"attachment_budget_exceeded">;
+    kind: z.ZodLiteral<"media">;
+    retryAfterMs: z.ZodNumber;
+}, z.core.$strict>>, z.ZodLazy<z.ZodObject<{
+    error: z.ZodLiteral<"library_unavailable">;
+    message: z.ZodString;
+}, z.core.$strict>>, z.ZodObject<{
+    error: z.ZodEnum<{
+        readonly CAPABILITY_DENIED: "CAPABILITY_DENIED";
+        readonly INSUFFICIENT_CREDIT: "INSUFFICIENT_CREDIT";
+        readonly HOST_FAILURE: "HOST_FAILURE";
+        readonly INVALID_ARGUMENT: "INVALID_ARGUMENT";
+        readonly SAFETY_FILTER_REFUSED: "SAFETY_FILTER_REFUSED";
+    }>;
+    message: z.ZodString;
+    stage: z.ZodEnum<{
+        readonly admission: "admission";
+        readonly "generation-authorization": "generation-authorization";
+        readonly settings: "settings";
+        readonly estimate: "estimate";
+        readonly billing: "billing";
+        readonly operation: "operation";
+        readonly provider: "provider";
+        readonly normalization: "normalization";
+        readonly artifact: "artifact";
+        readonly "destination-authorization": "destination-authorization";
+        readonly "destination-write": "destination-write";
+    }>;
+    retryable: z.ZodBoolean;
+}, z.core.$strict>]>]>;
+/** Completed generation, Agar polling result, or an existing broker refusal. */
+export declare const appMediaGenerationOutcomeSchema: z.ZodUnion<readonly [z.ZodObject<{
+    format: z.ZodEnum<{
+        readonly png: "png";
+        readonly jpeg: "jpeg";
+        readonly gif: "gif";
+        readonly webp: "webp";
+        readonly mp4: "mp4";
+    }>;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    bytes: z.ZodNumber;
+    model: z.ZodString;
+    costMilliunits: z.ZodNumber;
+    destination: z.ZodObject<{
+        computerId: z.ZodString;
+        path: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"pending">;
+    retryAfterMs: z.ZodNumber;
+}, z.core.$strict>, z.ZodUnion<readonly [z.ZodObject<{
+    error: z.ZodEnum<{
+        /** The broker refused the input representation or selection. */
+        readonly invalid: "invalid";
+        /** The input exceeds the existing broker byte ceiling. */
+        readonly too_large: "too_large";
+        /** The captured App selection or attachment changed. */
+        readonly revoked: "revoked";
+        /** The caller does not hold this Media grant. */
+        readonly not_granted: "not_granted";
+        /** The attachment's grantor no longer holds authority. */
+        readonly grantor_lost_authority: "grantor_lost_authority";
+        /** Admission could not resolve the current resource. */
+        readonly unavailable: "unavailable";
+    }>;
+}, z.core.$strict>, z.ZodLazy<z.ZodObject<{
+    error: z.ZodLiteral<"attachment_budget_exceeded">;
+    kind: z.ZodLiteral<"media">;
+    retryAfterMs: z.ZodNumber;
+}, z.core.$strict>>, z.ZodLazy<z.ZodObject<{
+    error: z.ZodLiteral<"library_unavailable">;
+    message: z.ZodString;
+}, z.core.$strict>>, z.ZodObject<{
+    error: z.ZodEnum<{
+        readonly CAPABILITY_DENIED: "CAPABILITY_DENIED";
+        readonly INSUFFICIENT_CREDIT: "INSUFFICIENT_CREDIT";
+        readonly HOST_FAILURE: "HOST_FAILURE";
+        readonly INVALID_ARGUMENT: "INVALID_ARGUMENT";
+        readonly SAFETY_FILTER_REFUSED: "SAFETY_FILTER_REFUSED";
+    }>;
+    message: z.ZodString;
+    stage: z.ZodEnum<{
+        readonly admission: "admission";
+        readonly "generation-authorization": "generation-authorization";
+        readonly settings: "settings";
+        readonly estimate: "estimate";
+        readonly billing: "billing";
+        readonly operation: "operation";
+        readonly provider: "provider";
+        readonly normalization: "normalization";
+        readonly artifact: "artifact";
+        readonly "destination-authorization": "destination-authorization";
+        readonly "destination-write": "destination-write";
+    }>;
+    retryable: z.ZodBoolean;
+}, z.core.$strict>]>]>;

package/dist/app-media-contracts.js

@@ -0,0 +1,96 @@
+import * as z from "zod";
+import { listMediaModels, mediaModelSchema } from "./model-catalog.js";
+import { mediaResultSchema } from "./media-operation-contract.js";
+import { pendingSchema } from "@fungi.computer/agar/backend-definition";
+import { mediaFailureSchema } from "./browser-failure.js";
+/** Bounded catalog decoded by the App media broker before host filtering. */
+export const mediaModelsSchema = z.lazy(() => z.array(mediaModelSchema).max(listMediaModels().length));
+/** An absolute output path on the Computer admitted by the App host. */
+export const destinationSchema = z.strictObject({
+    /** Computer admitted by the host. */
+    computerId: z.string().min(1).max(256),
+    /** Absolute Computer output path. */
+    path: z.string().startsWith("/").max(1_024),
+});
+/** Completed App generation output, with its admitted Computer destination. */
+export const appMediaGenerationResultSchema = mediaResultSchema
+    .omit({ path: true })
+    .extend({
+    /** Admitted Computer and absolute output path. */
+    destination: destinationSchema,
+});
+/** Authority refusals emitted by Media admission before a host call. */
+export const appMediaAdmissionErrorSchema = z.strictObject({
+    /** Existing admission refusal code. */
+    error: z.enum({
+        /** The captured App selection or attachment changed. */
+        revoked: "revoked",
+        /** The caller does not hold this Media grant. */
+        not_granted: "not_granted",
+        /** The attachment's grantor no longer holds authority. */
+        grantor_lost_authority: "grantor_lost_authority",
+        /** Admission could not resolve the current resource. */
+        unavailable: "unavailable",
+    }),
+});
+/** Attachment budget refusal emitted by the Media reservation owner. */
+export const appMediaBudgetRefusalSchema = z.lazy(() => z.strictObject({
+    /** The attachment's operation budget refused this request. */
+    error: z.literal("attachment_budget_exceeded"),
+    /** Media reservations use the Media budget, not exec or write. */
+    kind: z.literal("media"),
+    /** Delay emitted by the reservation owner. */
+    retryAfterMs: z.number(),
+}));
+/** Existing Media admission refusals, without an admitted selector or callable. */
+export const appMediaAdmissionRefusalSchema = z.union([
+    appMediaAdmissionErrorSchema,
+    appMediaBudgetRefusalSchema,
+]);
+/** Admission errors plus invalid/oversized inputs emitted directly by the broker. */
+export const appMediaBrokerErrorSchema = appMediaAdmissionErrorSchema.extend({
+    /** Existing broker refusal code. */
+    error: z.enum({
+        ...appMediaAdmissionErrorSchema.shape.error.enum,
+        /** The broker refused the input representation or selection. */
+        invalid: "invalid",
+        /** The input exceeds the existing broker byte ceiling. */
+        too_large: "too_large",
+    }),
+});
+/** Missing-library refusal decoded and returned by the App media broker. */
+export const agentAppMediaLibraryFailureSchema = z.lazy(() => z.strictObject({
+    /** The calling Installation's library is unavailable. */
+    error: z.literal("library_unavailable"),
+    /** Existing library-owner presentation copy. */
+    message: z.string().max(4096),
+}));
+/** Broker projection of an HTTP failure: code becomes error and error becomes message. */
+export const appMediaBrokerFailureSchema = z.strictObject({
+    /** Original typed HTTP failure code. */
+    error: mediaFailureSchema.shape.code,
+    /** Original HTTP failure presentation copy. */
+    message: mediaFailureSchema.shape.error,
+    /** Original failure stage. */
+    stage: mediaFailureSchema.shape.stage,
+    /** Original retry truth. */
+    retryable: mediaFailureSchema.shape.retryable,
+});
+/** Refusal payloads emitted by the App media broker, separate from transport errors. */
+export const appMediaRefusalSchema = z.union([
+    appMediaBrokerErrorSchema,
+    appMediaBudgetRefusalSchema,
+    agentAppMediaLibraryFailureSchema,
+    appMediaBrokerFailureSchema,
+]);
+/** Model-list payload or an existing broker refusal. */
+export const appMediaModelsOutcomeSchema = z.union([
+    mediaModelsSchema,
+    appMediaRefusalSchema,
+]);
+/** Completed generation, Agar polling result, or an existing broker refusal. */
+export const appMediaGenerationOutcomeSchema = z.union([
+    appMediaGenerationResultSchema,
+    pendingSchema,
+    appMediaRefusalSchema,
+]);

package/dist/browser-failure.d.ts

@@ -0,0 +1,40 @@
+import * as z from "zod";
+/** Host diagnostic sink; generation errors and retry truth remain transport-owned. */
+export type MediaGenerationDiagnostic = (operation: "app_media_pending_response_unavailable" | "media_failure_body_read_failed", cause: unknown, details?: Readonly<{
+    /** HTTP response status when the diagnostic concerns a response. */
+    status: number;
+}>) => void;
+/** Sanitized HTTP refusal emitted by a Media host and decoded at the browser boundary. */
+export declare const mediaFailureSchema: z.ZodObject<{
+    error: z.ZodString;
+    stage: z.ZodEnum<{
+        readonly admission: "admission";
+        readonly "generation-authorization": "generation-authorization";
+        readonly settings: "settings";
+        readonly estimate: "estimate";
+        readonly billing: "billing";
+        readonly operation: "operation";
+        readonly provider: "provider";
+        readonly normalization: "normalization";
+        readonly artifact: "artifact";
+        readonly "destination-authorization": "destination-authorization";
+        readonly "destination-write": "destination-write";
+    }>;
+    code: z.ZodEnum<{
+        /** Host admission or Computer access was denied. */
+        readonly CAPABILITY_DENIED: "CAPABILITY_DENIED";
+        /** Host billing did not admit this attempt. */
+        readonly INSUFFICIENT_CREDIT: "INSUFFICIENT_CREDIT";
+        /** The host could not complete generation or saving. */
+        readonly HOST_FAILURE: "HOST_FAILURE";
+        /** The host refused the selected input. */
+        readonly INVALID_ARGUMENT: "INVALID_ARGUMENT";
+        /** The model's safety filter refused generation. */
+        readonly SAFETY_FILTER_REFUSED: "SAFETY_FILTER_REFUSED";
+    }>;
+    retryable: z.ZodBoolean;
+}, z.core.$strict>;
+/** Sanitized Media failure carried from the authenticated host to Agar. */
+export type MediaFailure = z.output<typeof mediaFailureSchema>;
+/** Read and decode one Media host failure at the browser HTTP boundary. */
+export declare function readMediaFailure(response: Response, diagnostic?: MediaGenerationDiagnostic): Promise<MediaFailure | null>;

package/dist/browser-failure.js

@@ -0,0 +1,39 @@
+import * as z from "zod";
+import { mediaFailureStageSchema } from "./execution-error.js";
+import { Option, Schema } from "effect";
+import { reportCatchFailure } from "./failure.js";
+/** Sanitized HTTP refusal emitted by a Media host and decoded at the browser boundary. */
+export const mediaFailureSchema = z.strictObject({
+    /** Host-supplied presentation copy. */
+    error: z.string().min(1).max(512),
+    /** The failed generation or save stage. */
+    stage: mediaFailureStageSchema,
+    /** Typed refusal reason; the host retains retry truth. */
+    code: z.enum({
+        /** Host admission or Computer access was denied. */
+        CAPABILITY_DENIED: "CAPABILITY_DENIED",
+        /** Host billing did not admit this attempt. */
+        INSUFFICIENT_CREDIT: "INSUFFICIENT_CREDIT",
+        /** The host could not complete generation or saving. */
+        HOST_FAILURE: "HOST_FAILURE",
+        /** The host refused the selected input. */
+        INVALID_ARGUMENT: "INVALID_ARGUMENT",
+        /** The model's safety filter refused generation. */
+        SAFETY_FILTER_REFUSED: "SAFETY_FILTER_REFUSED",
+    }),
+    /** Whether repeating this exact attempt may recover. */
+    retryable: z.boolean(),
+});
+const decodeJson = Schema.decodeUnknownOption(Schema.fromJsonString(Schema.Json));
+function parseMediaFailureJson(json) {
+    const parsed = mediaFailureSchema.safeParse(Option.getOrUndefined(decodeJson(json)));
+    return parsed.success ? parsed.data : null;
+}
+/** Read and decode one Media host failure at the browser HTTP boundary. */
+export async function readMediaFailure(response, diagnostic = reportCatchFailure) {
+    const json = await response.text().catch((cause) => {
+        diagnostic("media_failure_body_read_failed", cause);
+        return null;
+    });
+    return json === null ? null : parseMediaFailureJson(json);
+}

package/dist/browser.d.ts

@@ -0,0 +1,2 @@
+export { mediaFailureSchema, readMediaFailure } from "./browser-failure.js";
+export type { MediaFailure, MediaGenerationDiagnostic, } from "./browser-failure.js";

package/dist/browser.js

@@ -0,0 +1 @@
+export { mediaFailureSchema, readMediaFailure } from "./browser-failure.js";