@fungi.computer/darkroom 0.0.1 → 0.2.0

package/dist/media-operation-owner.js

@@ -3,8 +3,13 @@ import { defineIdFamily } from "@fungi.computer/cairn/id";
 import { mediaGenerationSettingsSchema, validateMediaGenerationSettings, } from "./index.js";
 import { z } from "zod";
 import { reportCatchFailure } from "./failure.js";
-import { MediaSafetyFilterRefusal } from "./execution-error.js";
-const providerRefusalSchema = z.literal("safety_filter_refused");
+import { MediaExecutionError, MediaSafetyFilterRefusal, mediaFailureStageSchema, } from "./execution-error.js";
+import { mediaProviderDiagnosticWireSchema, } from "@fungi.computer/agar/errors";
+const providerFailureSchema = z.strictObject({
+    stage: mediaFailureStageSchema.extract(["provider", "normalization"]),
+    safetyRefused: z.boolean(),
+    provider: mediaProviderDiagnosticWireSchema.optional(),
+});
 const ids = defineIdFamily({
     family: "hub-media-operation",
     version: 1,
@@ -12,21 +17,21 @@ const ids = defineIdFamily({
 });
 const text = z.string().min(1).max(256);
 const path = z.string().min(1).max(1_024);
-const referenceMetadataSchema = z.object({
+const referenceMetadataSchema = z.lazy(() => z.object({
     format: z.enum(["png", "jpeg", "gif", "webp"]),
     width: z.coerce.number().int().positive(),
     height: z.coerce.number().int().positive(),
-});
+}));
 const referenceKey = (operationId, index) => `media-reference/v1/${operationId}/${String(index)}`;
 /** Fixed generation destination captured before provider dispatch. */
-export const mediaOperationDestinationSchema = z.strictObject({
+export const mediaOperationDestinationSchema = z.lazy(() => z.strictObject({
     /** Host-admitted destination or reference identity. */
     computerId: text,
     /** Fixed relative path in the admitted destination. */
     path,
     /** Optional verified image encoding pin. */
     outputFormat: mediaRequestedImageFormatSchema.optional(),
-});
+}));
 /** Decode host namespace and owner identity. */
 export const mediaOperationCoordinatesSchema = z.strictObject({
     /** Host isolation namespace. */
@@ -54,13 +59,13 @@ export const mediaOperationStateSchema = z.enum({
     interrupted: "interrupted",
 });
 /** Decode retained or saved output size and encoding. */
-export const mediaImageSchema = z.strictObject({
+export const mediaImageSchema = z.lazy(() => z.strictObject({
     /** Output byte length. */
     bytes: z.number().int().positive(),
     /** Actual output encoding. */
     format: text,
-});
-const retainedFormatSchema = z
+}));
+const retainedFormatSchema = z.lazy(() => z
     .enum(["image/png", "image/jpeg", "image/gif", "image/webp", "video/mp4"])
     .transform((mime) => ({
     "image/png": "png",
@@ -68,15 +73,15 @@ const retainedFormatSchema = z
     "image/gif": "gif",
     "image/webp": "webp",
     "video/mp4": "mp4",
-})[mime]);
-const outputSchema = z.strictObject({
+})[mime]));
+const outputSchema = z.lazy(() => z.strictObject({
     key: text,
     version: text,
     bytes: z.number().int().positive(),
     format: text,
-});
+}));
 /** Decode the settled receipt, including the host-admitted customer price. */
-export const mediaOperationResultSchema = z.strictObject({
+export const mediaOperationResultSchema = z.lazy(() => z.strictObject({
     /** Durable operation identifier. */
     generationId: text,
     /** Output byte length. */
@@ -85,7 +90,7 @@ export const mediaOperationResultSchema = z.strictObject({
     format: text,
     /** Admitted price in milliunits, where 1 cent is 1,000 milliunits. */
     costMilliunits: z.number().int().nonnegative(),
-});
+}));
 class MediaOperationError extends Error {
     code;
     constructor(
@@ -98,7 +103,7 @@ class MediaOperationError extends Error {
 }
 /** Stored media type for an output format. */
 const outputMime = (format) => format === "mp4" ? "video/mp4" : `image/${format}`;
-const operationRowSchema = z.object({
+const operationRowSchema = z.lazy(() => z.object({
     operation_id: z.string(),
     request_id: z.string(),
     actor_user_id: z.string(),
@@ -118,7 +123,7 @@ const operationRowSchema = z.object({
     updated_at: z.number(),
     background: z.number(),
     dispatched_at: z.number().nullable(),
-});
+}));
 const schemaStatements = [
     `CREATE TABLE hub_media_operation (
     singleton INTEGER PRIMARY KEY CHECK(singleton=1),
@@ -143,12 +148,12 @@ const schemaStatements = [
     dispatched_at INTEGER
   ) STRICT`,
     "CREATE TABLE hub_media_spent_failure (singleton INTEGER PRIMARY KEY CHECK(singleton=1),code TEXT NOT NULL CHECK(code='output_format_mismatch')) STRICT",
-    "CREATE TABLE hub_media_provider_refusal (singleton INTEGER PRIMARY KEY CHECK(singleton=1),code TEXT NOT NULL CHECK(code='safety_filter_refused')) STRICT",
+    "CREATE TABLE hub_media_provider_failure (singleton INTEGER PRIMARY KEY CHECK(singleton=1),failure_json TEXT NOT NULL) STRICT",
 ];
 function fingerprint(input) {
     return JSON.stringify(input);
 }
-const objectSchema = z.record(z.string(), z.unknown());
+const objectSchema = z.lazy(() => z.record(z.string(), z.unknown()));
 function decodeStoredRequest(serialized) {
     let raw;
     try {
@@ -235,8 +240,8 @@ export class MediaOperationOwner {
         }
         else {
             // Pre-launch stores use the current fresh schema or get reset by the host.
-            // Missing refusal facts are not healed or incrementally migrated here.
-            this.ctx.storage.sql.exec("SELECT code FROM hub_media_provider_refusal LIMIT 0");
+            // Missing failure facts are not healed or incrementally migrated here.
+            this.ctx.storage.sql.exec("SELECT failure_json FROM hub_media_provider_failure LIMIT 0");
         }
         this.initialized = true;
     }
@@ -301,12 +306,14 @@ export class MediaOperationOwner {
                 code: z.literal("output_format_mismatch"),
             })
                 .parse(failure).code;
-        const refusal = this.ctx.storage.sql
-            .exec("SELECT code FROM hub_media_provider_refusal WHERE singleton=1")
+        const failureRow = this.ctx.storage.sql
+            .exec("SELECT failure_json FROM hub_media_provider_failure WHERE singleton=1")
             .toArray()[0];
-        const providerRefusal = refusal === undefined
+        const providerFailure = failureRow === undefined
             ? null
-            : z.strictObject({ code: providerRefusalSchema }).parse(refusal).code;
+            : this.decodeJson(z
+                .strictObject({ failure_json: z.string().max(1024) })
+                .parse(failureRow).failure_json, providerFailureSchema);
         return Object.freeze({
             operationId: record.operationId,
             requestId: record.requestId,
@@ -314,7 +321,7 @@ export class MediaOperationOwner {
             owner: record.owner,
             state: record.state,
             spentFailure,
-            providerRefusal,
+            providerFailure,
             estimatedCostMilliunits: record.estimatedCostMilliunits,
             image: record.image,
             result: record.result,
@@ -684,8 +691,13 @@ export class MediaOperationOwner {
             // Nothing was delivered; the next retry sees interrupted and releases
             // the billing hold at zero units.
             try {
-                this.interruptGeneration(leaseId, cause instanceof MediaSafetyFilterRefusal
-                    ? "safety_filter_refused"
+                this.interruptGeneration(leaseId, cause instanceof MediaExecutionError &&
+                    (cause.stage === "provider" || cause.stage === "normalization")
+                    ? {
+                        stage: cause.stage,
+                        safetyRefused: cause instanceof MediaSafetyFilterRefusal,
+                        provider: cause.provider,
+                    }
                     : undefined);
             }
             catch (cause) {
@@ -702,8 +714,8 @@ export class MediaOperationOwner {
         this.ctx.storage.sql.exec("UPDATE hub_media_operation SET lease_id=NULL, lease_expires_at=NULL WHERE singleton=1 AND state='writing' AND lease_id=?", leaseId);
     }
     /** An aborted in-flight provider call is terminal for this request ID. */
-    interruptGeneration(leaseId, refusalInput) {
-        const refusal = providerRefusalSchema.optional().parse(refusalInput);
+    interruptGeneration(leaseId, failureInput) {
+        const failure = providerFailureSchema.optional().parse(failureInput);
         const record = this.requireRecord();
         if (record.state !== "generating" || record.leaseId !== leaseId)
             throw new MediaOperationError("lease_lost");
@@ -720,8 +732,8 @@ export class MediaOperationOwner {
                 writeReceipt: null,
                 result: null,
             });
-            if (refusal !== undefined)
-                this.ctx.storage.sql.exec("INSERT INTO hub_media_provider_refusal(singleton,code) VALUES(1,?)", refusal);
+            if (failure !== undefined)
+                this.ctx.storage.sql.exec("INSERT INTO hub_media_provider_failure(singleton,failure_json) VALUES(1,?)", JSON.stringify(failure));
             return this.project(interrupted);
         });
     }

package/dist/media-operation.js

@@ -72,8 +72,13 @@ export function executeMediaOperation(input) {
         }
         if (claim.kind === "interrupted") {
             yield* settleNothing();
-            if (claim.operation.providerRefusal === "safety_filter_refused")
-                return yield* Effect.fail(new MediaSafetyFilterRefusal());
+            const failure = claim.operation.providerFailure;
+            if (failure !== null)
+                return yield* Effect.fail(failure.safetyRefused
+                    ? new MediaSafetyFilterRefusal({ provider: failure.provider })
+                    : new MediaExecutionError(failure.stage, {
+                        provider: failure.provider,
+                    }));
         }
         if (claim.kind !== "claimed" || claim.leaseId === undefined)
             return {
@@ -149,11 +154,16 @@ export function executeMediaOperation(input) {
                 }, "provider").pipe(
                 // A provider failure delivered nothing and wrote no output: end the
                 // request now and release its hold rather than leave it unresolved.
-                Effect.tapError((error) => error.stage === "provider"
-                    ? call(() => input.operation.interruptGeneration(leaseId, error instanceof MediaSafetyFilterRefusal
-                        ? "safety_filter_refused"
-                        : undefined), "operation").pipe(Effect.andThen(settleNothing()), Effect.ignore)
-                    : Effect.void));
+                Effect.tapError((error) => {
+                    const stage = error.stage;
+                    return stage === "provider" || stage === "normalization"
+                        ? call(() => input.operation.interruptGeneration(leaseId, {
+                            stage,
+                            safetyRefused: error instanceof MediaSafetyFilterRefusal,
+                            provider: error.provider,
+                        }), "operation").pipe(Effect.andThen(settleNothing()), Effect.ignore)
+                        : Effect.void;
+                }));
                 if (generation.kind === "interrupted") {
                     yield* settleNothing();
                     return { kind: "interrupted" };

package/dist/model-catalog.d.ts

@@ -26,7 +26,7 @@ export declare const mediaModelTierSchema: z.ZodEnum<{
 /** A model selection tier, independent of billing price. */
 export type MediaModelTier = z.output<typeof mediaModelTierSchema>;
 /** Media's provider catalog: Workers AI images plus gateway image and video models. */
-export declare const mediaModelInputSchema: z.ZodReadonly<z.ZodObject<{
+export declare const mediaModelInputSchema: z.ZodLazy<z.ZodReadonly<z.ZodObject<{
     transport: z.ZodEnum<{
         /** JSON provider input. */
         readonly json: "json";
@@ -54,7 +54,7 @@ export declare const mediaModelInputSchema: z.ZodReadonly<z.ZodObject<{
     defaultSteps: z.ZodNullable<z.ZodNumber>;
     referenceField: z.ZodNullable<z.ZodString>;
     maxReferences: z.ZodNumber;
-}, z.core.$strict>>;
+}, z.core.$strict>>>;
 /** Verified Unified AI video identifiers; no inferred family aliases. */
 export declare const mediaVideoModelIdSchema: z.ZodEnum<{
     /** Seedance 2.0. */
@@ -118,7 +118,7 @@ export declare const mediaVideoReferenceRoleSchema: z.ZodEnum<{
 /** The role of a selected reference image in a video request. */
 export type MediaVideoReferenceRole = z.output<typeof mediaVideoReferenceRoleSchema>;
 /** One nominal size used to select provider resolution and aspect. */
-export declare const mediaVideoFormatSchema: z.ZodReadonly<z.ZodObject<{
+export declare const mediaVideoFormatSchema: z.ZodLazy<z.ZodReadonly<z.ZodObject<{
     resolution: z.ZodEnum<{
         /** 480p. */
         readonly p480: "480p";
@@ -149,11 +149,11 @@ export declare const mediaVideoFormatSchema: z.ZodReadonly<z.ZodObject<{
     }>;
     width: z.ZodNumber;
     height: z.ZodNumber;
-}, z.core.$strict>>;
+}, z.core.$strict>>>;
 /** One immutable nominal video format. */
 export type MediaVideoFormat = z.output<typeof mediaVideoFormatSchema>;
 /** Verified video parameters and provider costs, checked 2026-10-11. */
-export declare const mediaVideoSchema: z.ZodReadonly<z.ZodObject<{
+export declare const mediaVideoSchema: z.ZodLazy<z.ZodReadonly<z.ZodObject<{
     minSeconds: z.ZodNumber;
     maxSeconds: z.ZodNumber;
     defaultSeconds: z.ZodNumber;
@@ -166,7 +166,7 @@ export declare const mediaVideoSchema: z.ZodReadonly<z.ZodObject<{
         /** MiniMax multimodal `content[]` array and uppercase resolution. */
         readonly minimax: "minimax";
     }>;
-    formats: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
+    formats: z.ZodReadonly<z.ZodArray<z.ZodLazy<z.ZodReadonly<z.ZodObject<{
         resolution: z.ZodEnum<{
             /** 480p. */
             readonly p480: "480p";
@@ -197,7 +197,7 @@ export declare const mediaVideoSchema: z.ZodReadonly<z.ZodObject<{
         }>;
         width: z.ZodNumber;
         height: z.ZodNumber;
-    }, z.core.$strict>>>>;
+    }, z.core.$strict>>>>>;
     defaultResolution: z.ZodEnum<{
         /** 480p. */
         readonly p480: "480p";
@@ -265,7 +265,7 @@ export declare const mediaVideoSchema: z.ZodReadonly<z.ZodObject<{
         silentMilliunitsPerSecond: z.ZodNumber;
         audioMilliunitsPerSecond: z.ZodNumber;
     }, z.core.$strict>>>>;
-}, z.core.$strict>>;
+}, z.core.$strict>>>;
 /** Immutable video capability and price metadata. */
 export type MediaVideoModel = z.output<typeof mediaVideoSchema>;
 /** Public wire grammar for a catalog entry returned by the Media owner. */
@@ -296,7 +296,7 @@ export declare const mediaModelSchema: z.ZodReadonly<z.ZodObject<{
         /** WebP image encoding. */
         readonly webp: "webp";
     }>>>;
-    input: z.ZodReadonly<z.ZodObject<{
+    input: z.ZodLazy<z.ZodReadonly<z.ZodObject<{
         transport: z.ZodEnum<{
             /** JSON provider input. */
             readonly json: "json";
@@ -324,9 +324,9 @@ export declare const mediaModelSchema: z.ZodReadonly<z.ZodObject<{
         defaultSteps: z.ZodNullable<z.ZodNumber>;
         referenceField: z.ZodNullable<z.ZodString>;
         maxReferences: z.ZodNumber;
-    }, z.core.$strict>>;
+    }, z.core.$strict>>>;
     sizes: z.ZodNullable<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
-    video: z.ZodNullable<z.ZodReadonly<z.ZodObject<{
+    video: z.ZodNullable<z.ZodLazy<z.ZodReadonly<z.ZodObject<{
         minSeconds: z.ZodNumber;
         maxSeconds: z.ZodNumber;
         defaultSeconds: z.ZodNumber;
@@ -339,7 +339,7 @@ export declare const mediaModelSchema: z.ZodReadonly<z.ZodObject<{
             /** MiniMax multimodal `content[]` array and uppercase resolution. */
             readonly minimax: "minimax";
         }>;
-        formats: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
+        formats: z.ZodReadonly<z.ZodArray<z.ZodLazy<z.ZodReadonly<z.ZodObject<{
             resolution: z.ZodEnum<{
                 /** 480p. */
                 readonly p480: "480p";
@@ -370,7 +370,7 @@ export declare const mediaModelSchema: z.ZodReadonly<z.ZodObject<{
             }>;
             width: z.ZodNumber;
             height: z.ZodNumber;
-        }, z.core.$strict>>>>;
+        }, z.core.$strict>>>>>;
         defaultResolution: z.ZodEnum<{
             /** 480p. */
             readonly p480: "480p";
@@ -438,7 +438,7 @@ export declare const mediaModelSchema: z.ZodReadonly<z.ZodObject<{
             silentMilliunitsPerSecond: z.ZodNumber;
             audioMilliunitsPerSecond: z.ZodNumber;
         }, z.core.$strict>>>>;
-    }, z.core.$strict>>>;
+    }, z.core.$strict>>>>;
 }, z.core.$strict>>;
 /** Model-specific dimensions, steps, transport and reference limits. */
 export type MediaModelInput = z.output<typeof mediaModelInputSchema>;

package/dist/model-catalog.js

@@ -24,7 +24,7 @@ export const mediaModelTierSchema = z.enum({
     max: "max",
 });
 /** Media's provider catalog: Workers AI images plus gateway image and video models. */
-export const mediaModelInputSchema = z
+export const mediaModelInputSchema = z.lazy(() => z
     .strictObject({
     /** Provider input transport. */
     transport: z.enum({
@@ -64,7 +64,7 @@ export const mediaModelInputSchema = z
     /** Maximum references accepted by this model. */
     maxReferences: z.number().int().nonnegative(),
 })
-    .readonly();
+    .readonly());
 /** Verified Unified AI video identifiers; no inferred family aliases. */
 export const mediaVideoModelIdSchema = z.enum({
     /** Seedance 2.0. */
@@ -120,7 +120,7 @@ export const mediaVideoReferenceRoleSchema = z.enum({
     reference: "reference",
 });
 /** One nominal size used to select provider resolution and aspect. */
-export const mediaVideoFormatSchema = z
+export const mediaVideoFormatSchema = z.lazy(() => z
     .strictObject({
     /** Provider resolution. */
     resolution: mediaVideoResolutionSchema,
@@ -131,9 +131,9 @@ export const mediaVideoFormatSchema = z
     /** Nominal height; actual MP4 dimensions are not decoded. */
     height: z.number().int().positive(),
 })
-    .readonly();
+    .readonly());
 /** Verified video parameters and provider costs, checked 2026-10-11. */
-export const mediaVideoSchema = z
+export const mediaVideoSchema = z.lazy(() => z
     .strictObject({
     /** Minimum duration, for callers displaying bounds. */
     minSeconds: z.number().int().positive(),
@@ -182,7 +182,7 @@ export const mediaVideoSchema = z
         .readonly())
         .readonly(),
 })
-    .readonly();
+    .readonly());
 /** Public wire grammar for a catalog entry returned by the Media owner. */
 export const mediaModelSchema = z
     .strictObject({

package/dist/server.d.ts

@@ -4,7 +4,7 @@ import { z } from "zod";
 import { validateMediaGenerationSettings, type MediaProvider, type MediaReference, type MediaReferenceBytes } from "./index.js";
 import { type MediaExecution, type MediaMetering } from "./media-operation-contract.js";
 import { MediaExecutionError, type MediaBillingRefusalCode } from "./execution-error.js";
-export { MediaBillingRefusal, MediaExecutionError, type MediaBillingRefusalCode, type MediaFailureStage, } from "./execution-error.js";
+export { MediaBillingRefusal, MediaExecutionError, type MediaBillingRefusalCode, type MediaFailureStage, type MediaExecutionErrorOptions, } from "./execution-error.js";
 export { mediaUnits, type MediaUnits } from "./gateway-models.js";
 export type { MediaMetering, MediaOperation, } from "./media-operation-contract.js";
 export { MediaOperationOwner, mediaOperationDestinationSchema, mediaOperationCoordinatesSchema, mediaOperationStateSchema, mediaImageSchema, mediaOperationResultSchema, } from "./media-operation-owner.js";

package/dist/server.js

@@ -11,7 +11,7 @@ import { MediaOutputFormatMismatch, MediaBillingRefusal, MediaExecutionError, Me
 export { MediaBillingRefusal, MediaExecutionError, } from "./execution-error.js";
 export { mediaUnits } from "./gateway-models.js";
 export { MediaOperationOwner, mediaOperationDestinationSchema, mediaOperationCoordinatesSchema, mediaOperationStateSchema, mediaImageSchema, mediaOperationResultSchema, } from "./media-operation-owner.js";
-const identifier = z.string().min(1).max(256);
+const identifier = z.lazy(() => z.string().min(1).max(256));
 /** Decode relative service generation input. Identity comes from the host. */
 export const mediaRequestSchema = z.strictObject({
     /** Fixed destination or reference file path. */
@@ -51,6 +51,7 @@ function failure(error, refusalMessages) {
             stage: "provider",
             code: "SAFETY_FILTER_REFUSED",
             retryable: false,
+            provider: error.provider,
         }, { status: 400, headers });
     if (error instanceof MediaExecutionError &&
         error.cause instanceof MediaOutputFormatMismatch)
@@ -105,6 +106,7 @@ function failure(error, refusalMessages) {
         stage: error.stage,
         code: "HOST_FAILURE",
         retryable: error.stage !== "normalization" && error.stage !== "provider",
+        provider: error instanceof MediaExecutionError ? error.provider : undefined,
     }, {
         status: 503,
         headers,

package/dist/video-providers/minimax.js

@@ -19,12 +19,12 @@ const minimaxRoleWire = {
 /** MiniMax's documented task wrapper: `{task: {status, content: {url}}}`,
  * distinct from the Unified gateway's `{state, result}` shape Seedance and
  * Veo normalize into. https://developers.cloudflare.com/ai/models/minimax/h3-max/ */
-const minimaxTaskOutputSchema = z.looseObject({
+const minimaxTaskOutputSchema = z.lazy(() => z.looseObject({
     task: z.looseObject({
         status: z.enum(["queued", "running", "succeeded", "failed", "cancelled"]),
         content: z.looseObject({ url: resultUrl.optional() }).optional(),
     }),
-});
+}));
 export const minimaxVideoAdapter = {
     buildInput(checked, references, model) {
         if (checked.generateAudio !== undefined)