@drawcall/design 0.3.0 → 0.4.1

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export * as v1 from "./v1/index.js";
 export { designSkill } from "./skill.generated.js";
 export { frameCreationCapabilities, type FrameCreationCapability, type FrameCreationCapabilityId, type FrameCreationInput, } from "./v1/capabilities.js";
+export { IMAGE_GENERATION_MODEL, IMAGE_GENERATION_PROVIDER, } from "./v1/schemas.js";
 export { parseFrameSize } from "./target.js";
 export { acknowledgesInspection, inspectionCommandSchema, inspectionFrameMessageSchema, inspectionMessageTypes, projectSyncMaps, projectSyncUrl, type InspectionAppliedMessage, type InspectionCommand, type InspectionFrameMessage, } from "./protocol.js";
-export type { BinaryFile, CreateFrame, CreateProjectFromBrief, CreateGltsFrame, CreateImageFrame, CreateMarketFrame, DesignFile, FileList, FileMutation, Frame, GltsFrame, ImageFrame, MarketFrame, Project, ProjectDerivationStatus, Screenshot, TextFile, User, } from "./v1/schemas.js";
+export type { BinaryFile, CreateFrame, CreateProjectFromBrief, CreateGltsFrame, CreateImageFrame, CreateMarketFrame, GenerateImageFrame, DesignFile, FileList, FileMutation, Frame, GltsFrame, ImageFrame, ImageGenerationOperation, ImageGenerationProvenance, ImageGenerationResult, MarketFrame, Project, ProjectDerivationStatus, Screenshot, TextFile, User, } from "./v1/schemas.js";

package/dist/index.js

@@ -1,5 +1,6 @@
 export * as v1 from "./v1/index.js";
 export { designSkill } from "./skill.generated.js";
 export { frameCreationCapabilities, } from "./v1/capabilities.js";
+export { IMAGE_GENERATION_MODEL, IMAGE_GENERATION_PROVIDER, } from "./v1/schemas.js";
 export { parseFrameSize } from "./target.js";
 export { acknowledgesInspection, inspectionCommandSchema, inspectionFrameMessageSchema, inspectionMessageTypes, projectSyncMaps, projectSyncUrl, } from "./protocol.js";

package/dist/protocol.d.ts

@@ -1,5 +1,6 @@
 import { z } from "zod";
 export declare const projectSyncMaps: {
+    readonly frameContentRevisions: "frame-content-revisions";
     readonly filesystemRevision: "filesystem-revision";
     readonly frameRecords: "frame-records";
 };

package/dist/protocol.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 export const projectSyncMaps = {
+    frameContentRevisions: "frame-content-revisions",
     filesystemRevision: "filesystem-revision",
     frameRecords: "frame-records",
 };

package/dist/v1/capabilities.d.ts

@@ -1,5 +1,5 @@
-export type FrameCreationCapabilityId = "add-image" | "create-glts" | "search-assets";
-export type FrameCreationInput = "asset" | "height" | "image" | "name" | "width";
+export type FrameCreationCapabilityId = "add-image" | "create-glts" | "generate-image" | "search-assets";
+export type FrameCreationInput = "asset" | "height" | "image" | "name" | "prompt" | "references" | "width";
 export interface FrameCreationCapability {
     id: FrameCreationCapabilityId;
     frameType: "glts" | "image" | "market";

package/dist/v1/capabilities.js

@@ -13,6 +13,13 @@ export const frameCreationCapabilities = [
         description: "Create an empty programmable 3D frame",
         inputs: ["name", "width", "height"],
     },
+    {
+        id: "generate-image",
+        frameType: "image",
+        label: "Generate image",
+        description: "Create or edit an image with optional frame references",
+        inputs: ["name", "prompt", "references"],
+    },
     {
         id: "search-assets",
         frameType: "market",

package/dist/v1/contract.d.ts

@@ -76,6 +76,24 @@ export declare const contract: {
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
         }, z.core.$strip>, Record<never, never>, Record<never, never>>;
+        rename: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+            project: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            sourceBrief: z.ZodNullable<z.ZodString>;
+            title: z.ZodNullable<z.ZodString>;
+            summary: z.ZodNullable<z.ZodString>;
+            derivationStatus: z.ZodEnum<{
+                not_requested: "not_requested";
+                pending: "pending";
+                failed: "failed";
+                complete: "complete";
+            }>;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+        }, z.core.$strip>, Record<never, never>, Record<never, never>>;
         delete: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
             project: z.ZodString;
         }, z.core.$strip>, z.ZodObject<{
@@ -110,6 +128,41 @@ export declare const contract: {
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"image">;
             file: z.ZodString;
+            provenance: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"generated">;
+                operation: z.ZodEnum<{
+                    generate: "generate";
+                    edit: "edit";
+                }>;
+                prompt: z.ZodString;
+                references: z.ZodArray<z.ZodObject<{
+                    frameId: z.ZodString;
+                    frameUpdatedAt: z.ZodString;
+                }, z.core.$strip>>;
+                result: z.ZodEnum<{
+                    replace: "replace";
+                    new: "new";
+                }>;
+                provider: z.ZodLiteral<"fal-ai">;
+                model: z.ZodLiteral<"openai/gpt-image-2">;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"generated">;
+                operation: z.ZodEnum<{
+                    generate: "generate";
+                    edit: "edit";
+                }>;
+                prompt: z.ZodString;
+                references: z.ZodArray<z.ZodObject<{
+                    frameId: z.ZodString;
+                    frameUpdatedAt: z.ZodString;
+                }, z.core.$strip>>;
+                result: z.ZodEnum<{
+                    replace: "replace";
+                    new: "new";
+                }>;
+                provider: z.ZodLiteral<"cloudflare-workers-ai">;
+                model: z.ZodLiteral<"@cf/black-forest-labs/flux-2-klein-4b">;
+            }, z.core.$strip>], "provider">>;
         }, z.core.$strip>, z.ZodObject<{
             id: z.ZodString;
             projectId: z.ZodString;
@@ -171,6 +224,131 @@ export declare const contract: {
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"image">;
             file: z.ZodString;
+            provenance: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"generated">;
+                operation: z.ZodEnum<{
+                    generate: "generate";
+                    edit: "edit";
+                }>;
+                prompt: z.ZodString;
+                references: z.ZodArray<z.ZodObject<{
+                    frameId: z.ZodString;
+                    frameUpdatedAt: z.ZodString;
+                }, z.core.$strip>>;
+                result: z.ZodEnum<{
+                    replace: "replace";
+                    new: "new";
+                }>;
+                provider: z.ZodLiteral<"fal-ai">;
+                model: z.ZodLiteral<"openai/gpt-image-2">;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"generated">;
+                operation: z.ZodEnum<{
+                    generate: "generate";
+                    edit: "edit";
+                }>;
+                prompt: z.ZodString;
+                references: z.ZodArray<z.ZodObject<{
+                    frameId: z.ZodString;
+                    frameUpdatedAt: z.ZodString;
+                }, z.core.$strip>>;
+                result: z.ZodEnum<{
+                    replace: "replace";
+                    new: "new";
+                }>;
+                provider: z.ZodLiteral<"cloudflare-workers-ai">;
+                model: z.ZodLiteral<"@cf/black-forest-labs/flux-2-klein-4b">;
+            }, z.core.$strip>], "provider">>;
+        }, z.core.$strip>, z.ZodObject<{
+            id: z.ZodString;
+            projectId: z.ZodString;
+            name: z.ZodString;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            viewUrl: z.ZodString;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+            type: z.ZodLiteral<"market">;
+            asset: z.ZodString;
+        }, z.core.$strip>], "type">, Record<never, never>, Record<never, never>>;
+        generateImage: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+            project: z.ZodString;
+            operation: z.ZodEnum<{
+                generate: "generate";
+                edit: "edit";
+            }>;
+            prompt: z.ZodString;
+            target: z.ZodOptional<z.ZodString>;
+            references: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            result: z.ZodEnum<{
+                replace: "replace";
+                new: "new";
+            }>;
+            name: z.ZodOptional<z.ZodString>;
+            x: z.ZodOptional<z.ZodNumber>;
+            y: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+            id: z.ZodString;
+            projectId: z.ZodString;
+            name: z.ZodString;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            viewUrl: z.ZodString;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+            type: z.ZodLiteral<"glts">;
+        }, z.core.$strip>, z.ZodObject<{
+            id: z.ZodString;
+            projectId: z.ZodString;
+            name: z.ZodString;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            viewUrl: z.ZodString;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+            type: z.ZodLiteral<"image">;
+            file: z.ZodString;
+            provenance: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"generated">;
+                operation: z.ZodEnum<{
+                    generate: "generate";
+                    edit: "edit";
+                }>;
+                prompt: z.ZodString;
+                references: z.ZodArray<z.ZodObject<{
+                    frameId: z.ZodString;
+                    frameUpdatedAt: z.ZodString;
+                }, z.core.$strip>>;
+                result: z.ZodEnum<{
+                    replace: "replace";
+                    new: "new";
+                }>;
+                provider: z.ZodLiteral<"fal-ai">;
+                model: z.ZodLiteral<"openai/gpt-image-2">;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"generated">;
+                operation: z.ZodEnum<{
+                    generate: "generate";
+                    edit: "edit";
+                }>;
+                prompt: z.ZodString;
+                references: z.ZodArray<z.ZodObject<{
+                    frameId: z.ZodString;
+                    frameUpdatedAt: z.ZodString;
+                }, z.core.$strip>>;
+                result: z.ZodEnum<{
+                    replace: "replace";
+                    new: "new";
+                }>;
+                provider: z.ZodLiteral<"cloudflare-workers-ai">;
+                model: z.ZodLiteral<"@cf/black-forest-labs/flux-2-klein-4b">;
+            }, z.core.$strip>], "provider">>;
         }, z.core.$strip>, z.ZodObject<{
             id: z.ZodString;
             projectId: z.ZodString;
@@ -214,6 +392,41 @@ export declare const contract: {
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"image">;
             file: z.ZodString;
+            provenance: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"generated">;
+                operation: z.ZodEnum<{
+                    generate: "generate";
+                    edit: "edit";
+                }>;
+                prompt: z.ZodString;
+                references: z.ZodArray<z.ZodObject<{
+                    frameId: z.ZodString;
+                    frameUpdatedAt: z.ZodString;
+                }, z.core.$strip>>;
+                result: z.ZodEnum<{
+                    replace: "replace";
+                    new: "new";
+                }>;
+                provider: z.ZodLiteral<"fal-ai">;
+                model: z.ZodLiteral<"openai/gpt-image-2">;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"generated">;
+                operation: z.ZodEnum<{
+                    generate: "generate";
+                    edit: "edit";
+                }>;
+                prompt: z.ZodString;
+                references: z.ZodArray<z.ZodObject<{
+                    frameId: z.ZodString;
+                    frameUpdatedAt: z.ZodString;
+                }, z.core.$strip>>;
+                result: z.ZodEnum<{
+                    replace: "replace";
+                    new: "new";
+                }>;
+                provider: z.ZodLiteral<"cloudflare-workers-ai">;
+                model: z.ZodLiteral<"@cf/black-forest-labs/flux-2-klein-4b">;
+            }, z.core.$strip>], "provider">>;
         }, z.core.$strip>, z.ZodObject<{
             id: z.ZodString;
             projectId: z.ZodString;

package/dist/v1/contract.js

@@ -1,6 +1,6 @@
 import { oc } from "@orpc/contract";
 import { z } from "zod";
-import { createFrameSchema, createProjectFromBriefSchema, designIdSchema, fileListSchema, fileMutationSchema, fileSchema, fileTextSchema, frameNameSchema, frameSchema, projectDirectoryPathSchema, projectNameSchema, projectPathSchema, projectSchema, screenshotSchema, userSchema, } from "./schemas.js";
+import { createFrameSchema, createProjectFromBriefSchema, designIdSchema, fileListSchema, fileMutationSchema, fileSchema, fileTextSchema, frameNameSchema, frameSchema, generateImageFrameSchema, projectDirectoryPathSchema, projectNameSchema, projectPathSchema, projectSchema, screenshotSchema, userSchema, } from "./schemas.js";
 const projectInputSchema = z.object({ project: designIdSchema });
 const frameInputSchema = projectInputSchema.extend({ frame: designIdSchema });
 const fileInputSchema = projectInputSchema.extend({ path: projectPathSchema });
@@ -28,6 +28,10 @@ export const contract = {
         })
             .input(projectInputSchema)
             .output(projectSchema),
+        rename: oc
+            .route({ method: "PATCH", path: "/projects/{project}" })
+            .input(projectInputSchema.extend({ name: projectNameSchema }))
+            .output(projectSchema),
         delete: oc
             .route({ method: "DELETE", path: "/projects/{project}" })
             .input(projectInputSchema)
@@ -42,6 +46,13 @@ export const contract = {
             .route({ method: "POST", path: "/projects/{project}/frames" })
             .input(createFrameSchema)
             .output(frameSchema),
+        generateImage: oc
+            .route({
+            method: "POST",
+            path: "/projects/{project}/images/generations",
+        })
+            .input(generateImageFrameSchema)
+            .output(frameSchema),
         rename: oc
             .route({ method: "PATCH", path: "/projects/{project}/frames/{frame}" })
             .input(frameInputSchema.extend({ name: frameNameSchema }))

package/dist/v1/schemas.d.ts

@@ -1,6 +1,8 @@
 import { z } from "zod";
 export declare const MAX_FRAME_DIMENSION = 4096;
 export declare const MAX_FILE_LENGTH = 512000;
+export declare const MAX_IMAGE_GENERATION_PROMPT_LENGTH = 2048;
+export declare const MAX_IMAGE_GENERATION_REFERENCES = 4;
 export declare const designIdSchema: z.ZodString;
 export declare const projectNameSchema: z.ZodString;
 export declare const projectBriefSchema: z.ZodString;
@@ -62,6 +64,57 @@ export declare const gltsFrameSchema: z.ZodObject<{
     updatedAt: z.ZodString;
     type: z.ZodLiteral<"glts">;
 }, z.core.$strip>;
+export declare const imageGenerationOperationSchema: z.ZodEnum<{
+    generate: "generate";
+    edit: "edit";
+}>;
+export declare const imageGenerationResultSchema: z.ZodEnum<{
+    replace: "replace";
+    new: "new";
+}>;
+export declare const imageGenerationReferenceSchema: z.ZodObject<{
+    frameId: z.ZodString;
+    frameUpdatedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const IMAGE_GENERATION_PROVIDER = "fal-ai";
+export declare const IMAGE_GENERATION_MODEL = "openai/gpt-image-2";
+export declare const LEGACY_IMAGE_GENERATION_PROVIDER = "cloudflare-workers-ai";
+export declare const LEGACY_IMAGE_GENERATION_MODEL = "@cf/black-forest-labs/flux-2-klein-4b";
+export declare const imageGenerationProvenanceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"generated">;
+    operation: z.ZodEnum<{
+        generate: "generate";
+        edit: "edit";
+    }>;
+    prompt: z.ZodString;
+    references: z.ZodArray<z.ZodObject<{
+        frameId: z.ZodString;
+        frameUpdatedAt: z.ZodString;
+    }, z.core.$strip>>;
+    result: z.ZodEnum<{
+        replace: "replace";
+        new: "new";
+    }>;
+    provider: z.ZodLiteral<"fal-ai">;
+    model: z.ZodLiteral<"openai/gpt-image-2">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"generated">;
+    operation: z.ZodEnum<{
+        generate: "generate";
+        edit: "edit";
+    }>;
+    prompt: z.ZodString;
+    references: z.ZodArray<z.ZodObject<{
+        frameId: z.ZodString;
+        frameUpdatedAt: z.ZodString;
+    }, z.core.$strip>>;
+    result: z.ZodEnum<{
+        replace: "replace";
+        new: "new";
+    }>;
+    provider: z.ZodLiteral<"cloudflare-workers-ai">;
+    model: z.ZodLiteral<"@cf/black-forest-labs/flux-2-klein-4b">;
+}, z.core.$strip>], "provider">;
 export declare const imageFrameSchema: z.ZodObject<{
     id: z.ZodString;
     projectId: z.ZodString;
@@ -75,6 +128,41 @@ export declare const imageFrameSchema: z.ZodObject<{
     updatedAt: z.ZodString;
     type: z.ZodLiteral<"image">;
     file: z.ZodString;
+    provenance: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"generated">;
+        operation: z.ZodEnum<{
+            generate: "generate";
+            edit: "edit";
+        }>;
+        prompt: z.ZodString;
+        references: z.ZodArray<z.ZodObject<{
+            frameId: z.ZodString;
+            frameUpdatedAt: z.ZodString;
+        }, z.core.$strip>>;
+        result: z.ZodEnum<{
+            replace: "replace";
+            new: "new";
+        }>;
+        provider: z.ZodLiteral<"fal-ai">;
+        model: z.ZodLiteral<"openai/gpt-image-2">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"generated">;
+        operation: z.ZodEnum<{
+            generate: "generate";
+            edit: "edit";
+        }>;
+        prompt: z.ZodString;
+        references: z.ZodArray<z.ZodObject<{
+            frameId: z.ZodString;
+            frameUpdatedAt: z.ZodString;
+        }, z.core.$strip>>;
+        result: z.ZodEnum<{
+            replace: "replace";
+            new: "new";
+        }>;
+        provider: z.ZodLiteral<"cloudflare-workers-ai">;
+        model: z.ZodLiteral<"@cf/black-forest-labs/flux-2-klein-4b">;
+    }, z.core.$strip>], "provider">>;
 }, z.core.$strip>;
 export declare const marketFrameSchema: z.ZodObject<{
     id: z.ZodString;
@@ -115,6 +203,41 @@ export declare const frameSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     updatedAt: z.ZodString;
     type: z.ZodLiteral<"image">;
     file: z.ZodString;
+    provenance: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"generated">;
+        operation: z.ZodEnum<{
+            generate: "generate";
+            edit: "edit";
+        }>;
+        prompt: z.ZodString;
+        references: z.ZodArray<z.ZodObject<{
+            frameId: z.ZodString;
+            frameUpdatedAt: z.ZodString;
+        }, z.core.$strip>>;
+        result: z.ZodEnum<{
+            replace: "replace";
+            new: "new";
+        }>;
+        provider: z.ZodLiteral<"fal-ai">;
+        model: z.ZodLiteral<"openai/gpt-image-2">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"generated">;
+        operation: z.ZodEnum<{
+            generate: "generate";
+            edit: "edit";
+        }>;
+        prompt: z.ZodString;
+        references: z.ZodArray<z.ZodObject<{
+            frameId: z.ZodString;
+            frameUpdatedAt: z.ZodString;
+        }, z.core.$strip>>;
+        result: z.ZodEnum<{
+            replace: "replace";
+            new: "new";
+        }>;
+        provider: z.ZodLiteral<"cloudflare-workers-ai">;
+        model: z.ZodLiteral<"@cf/black-forest-labs/flux-2-klein-4b">;
+    }, z.core.$strip>], "provider">>;
 }, z.core.$strip>, z.ZodObject<{
     id: z.ZodString;
     projectId: z.ZodString;
@@ -177,6 +300,23 @@ export declare const createFrameSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"market">;
     asset: z.ZodString;
 }, z.core.$strict>], "type">;
+export declare const generateImageFrameSchema: z.ZodObject<{
+    project: z.ZodString;
+    operation: z.ZodEnum<{
+        generate: "generate";
+        edit: "edit";
+    }>;
+    prompt: z.ZodString;
+    target: z.ZodOptional<z.ZodString>;
+    references: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    result: z.ZodEnum<{
+        replace: "replace";
+        new: "new";
+    }>;
+    name: z.ZodOptional<z.ZodString>;
+    x: z.ZodOptional<z.ZodNumber>;
+    y: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
 export declare const fileListSchema: z.ZodObject<{
     paths: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
@@ -218,12 +358,16 @@ export type CreateProjectFromBrief = z.infer<typeof createProjectFromBriefSchema
 export type ProjectDerivationStatus = z.infer<typeof projectDerivationStatusSchema>;
 export type GltsFrame = z.infer<typeof gltsFrameSchema>;
 export type ImageFrame = z.infer<typeof imageFrameSchema>;
+export type ImageGenerationOperation = z.infer<typeof imageGenerationOperationSchema>;
+export type ImageGenerationResult = z.infer<typeof imageGenerationResultSchema>;
+export type ImageGenerationProvenance = z.infer<typeof imageGenerationProvenanceSchema>;
 export type MarketFrame = z.infer<typeof marketFrameSchema>;
 export type Frame = z.infer<typeof frameSchema>;
 export type CreateGltsFrame = z.infer<typeof createGltsFrameSchema>;
 export type CreateImageFrame = z.infer<typeof createImageFrameSchema>;
 export type CreateMarketFrame = z.infer<typeof createMarketFrameSchema>;
 export type CreateFrame = z.infer<typeof createFrameSchema>;
+export type GenerateImageFrame = z.infer<typeof generateImageFrameSchema>;
 export type FileList = z.infer<typeof fileListSchema>;
 export type TextFile = z.infer<typeof textFileSchema>;
 export type BinaryFile = z.infer<typeof binaryFileSchema>;

package/dist/v1/schemas.js

@@ -1,6 +1,8 @@
 import { z } from "zod";
 export const MAX_FRAME_DIMENSION = 4_096;
 export const MAX_FILE_LENGTH = 512_000;
+export const MAX_IMAGE_GENERATION_PROMPT_LENGTH = 2_048;
+export const MAX_IMAGE_GENERATION_REFERENCES = 4;
 export const designIdSchema = z
     .string()
     .regex(/^[a-z0-9]{14}$/, "IDs are 14 lowercase alphanumeric characters");
@@ -91,9 +93,39 @@ const frameBaseSchema = z.object({
 export const gltsFrameSchema = frameBaseSchema.extend({
     type: z.literal("glts"),
 });
+export const imageGenerationOperationSchema = z.enum(["generate", "edit"]);
+export const imageGenerationResultSchema = z.enum(["new", "replace"]);
+export const imageGenerationReferenceSchema = z.object({
+    frameId: designIdSchema,
+    frameUpdatedAt: z.string().datetime(),
+});
+export const IMAGE_GENERATION_PROVIDER = "fal-ai";
+export const IMAGE_GENERATION_MODEL = "openai/gpt-image-2";
+export const LEGACY_IMAGE_GENERATION_PROVIDER = "cloudflare-workers-ai";
+export const LEGACY_IMAGE_GENERATION_MODEL = "@cf/black-forest-labs/flux-2-klein-4b";
+const imageGenerationProvenanceBaseSchema = z.object({
+    kind: z.literal("generated"),
+    operation: imageGenerationOperationSchema,
+    prompt: z.string().min(1).max(MAX_IMAGE_GENERATION_PROMPT_LENGTH),
+    references: z
+        .array(imageGenerationReferenceSchema)
+        .max(MAX_IMAGE_GENERATION_REFERENCES),
+    result: imageGenerationResultSchema,
+});
+export const imageGenerationProvenanceSchema = z.discriminatedUnion("provider", [
+    imageGenerationProvenanceBaseSchema.extend({
+        provider: z.literal(IMAGE_GENERATION_PROVIDER),
+        model: z.literal(IMAGE_GENERATION_MODEL),
+    }),
+    imageGenerationProvenanceBaseSchema.extend({
+        provider: z.literal(LEGACY_IMAGE_GENERATION_PROVIDER),
+        model: z.literal(LEGACY_IMAGE_GENERATION_MODEL),
+    }),
+]);
 export const imageFrameSchema = frameBaseSchema.extend({
     type: z.literal("image"),
     file: projectPathSchema,
+    provenance: imageGenerationProvenanceSchema.optional(),
 });
 export const marketFrameSchema = frameBaseSchema.extend({
     type: z.literal("market"),
@@ -137,6 +169,85 @@ export const createFrameSchema = z.discriminatedUnion("type", [
     createImageFrameSchema,
     createMarketFrameSchema,
 ]);
+export const generateImageFrameSchema = z
+    .object({
+    project: designIdSchema,
+    operation: imageGenerationOperationSchema,
+    prompt: z.string().trim().min(1).max(MAX_IMAGE_GENERATION_PROMPT_LENGTH),
+    target: designIdSchema.optional(),
+    references: z
+        .array(designIdSchema)
+        .max(MAX_IMAGE_GENERATION_REFERENCES)
+        .default([]),
+    result: imageGenerationResultSchema,
+    name: frameNameSchema.optional(),
+    x: framePositionSchema.optional(),
+    y: framePositionSchema.optional(),
+})
+    .strict()
+    .superRefine((input, context) => {
+    const orderedReferences = [
+        ...(input.target ? [input.target] : []),
+        ...input.references,
+    ];
+    if (new Set(orderedReferences).size !== orderedReferences.length) {
+        context.addIssue({
+            code: "custom",
+            path: ["references"],
+            message: "Image references must be unique",
+        });
+    }
+    if (orderedReferences.length > MAX_IMAGE_GENERATION_REFERENCES) {
+        context.addIssue({
+            code: "custom",
+            path: ["references"],
+            message: `Image generation supports at most ${MAX_IMAGE_GENERATION_REFERENCES} references`,
+        });
+    }
+    if (input.operation === "generate" && input.target) {
+        context.addIssue({
+            code: "custom",
+            path: ["target"],
+            message: "A generation request cannot have an edit target",
+        });
+    }
+    if (input.operation === "edit" && !input.target) {
+        context.addIssue({
+            code: "custom",
+            path: ["target"],
+            message: "An edit request requires an image target",
+        });
+    }
+    if (input.result === "replace" && input.operation !== "edit") {
+        context.addIssue({
+            code: "custom",
+            path: ["result"],
+            message: "Only an image edit can replace a frame",
+        });
+    }
+    if (input.result === "new" && !input.name) {
+        context.addIssue({
+            code: "custom",
+            path: ["name"],
+            message: "A new generated frame requires a name",
+        });
+    }
+    if (input.result === "replace" && input.name) {
+        context.addIssue({
+            code: "custom",
+            path: ["name"],
+            message: "A replacement keeps the target frame name",
+        });
+    }
+    if (input.result === "replace" &&
+        (input.x !== undefined || input.y !== undefined)) {
+        context.addIssue({
+            code: "custom",
+            path: [input.x !== undefined ? "x" : "y"],
+            message: "A replacement keeps the target frame position",
+        });
+    }
+});
 export const fileListSchema = z.object({
     paths: z.array(projectPathSchema),
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drawcall/design",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "Typed API and remote CLI for Drawcall Design",
   "repository": {
     "type": "git",