@drawcall/design 0.5.8 → 0.5.11

package/dist/mcp/schema.d.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import { type CreateFrame } from "../v1/schemas.js";
+export declare const projectIdSchema: z.ZodString;
+export declare const frameIdSchema: z.ZodString;
+export declare const directoryPathSchema: z.ZodUnion<readonly [z.ZodLiteral<"/">, z.ZodString]>;
+export declare const filePathSchema: z.ZodString;
+export declare const createFrameSchema: z.ZodObject<{
+    project: z.ZodString;
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        image: "image";
+        glts: "glts";
+        market: "market";
+    }>;
+    width: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    height: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    image: z.ZodOptional<z.ZodString>;
+    asset: z.ZodOptional<z.ZodString>;
+    x: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    y: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>;
+export declare const projectInput: z.ZodObject<{
+    project: z.ZodString;
+}, z.core.$strict>;
+export declare const frameInput: z.ZodObject<{
+    project: z.ZodString;
+    frame: z.ZodString;
+}, z.core.$strict>;
+export declare const fileInput: z.ZodObject<{
+    project: z.ZodString;
+    path: z.ZodString;
+}, z.core.$strict>;
+export declare function frameCreationInput(input: z.infer<typeof createFrameSchema>): CreateFrame;

package/dist/mcp/schema.js

@@ -0,0 +1,108 @@
+import { z } from "zod";
+import { MAX_FRAME_DIMENSION, designIdSchema, frameNameSchema, imageUrlSchema, marketAssetSchema, projectDirectoryPathSchema, projectFilePathSchema, } from "../v1/schemas.js";
+export const projectIdSchema = designIdSchema.describe("Exact project ID returned by list_projects");
+export const frameIdSchema = designIdSchema.describe("Exact frame ID returned by list_frames");
+export const directoryPathSchema = projectDirectoryPathSchema.describe("Project-absolute directory path without a trailing slash; omit it to list the entire project");
+export const filePathSchema = projectFilePathSchema.describe("Project-absolute file path returned by list_files, including the frame ID; pass it unchanged");
+const sizeSchema = z.coerce.number().int().min(1).max(MAX_FRAME_DIMENSION);
+const positionSchema = z.coerce.number().finite();
+// Some MCP clients lose property types in discriminated unions and serialize
+// every create_frame argument as a string. Keep the wire schema flat.
+export const createFrameSchema = z
+    .object({
+    project: projectIdSchema,
+    name: frameNameSchema,
+    type: z.enum(["glts", "image", "market"]),
+    width: sizeSchema.optional(),
+    height: sizeSchema.optional(),
+    image: imageUrlSchema.optional(),
+    asset: marketAssetSchema.optional(),
+    x: positionSchema.optional(),
+    y: positionSchema.optional(),
+})
+    .strict()
+    .superRefine((input, context) => {
+    const require = (key) => {
+        if (input[key] !== undefined)
+            return;
+        context.addIssue({
+            code: "custom",
+            path: [key],
+            message: `${key} is required for a ${input.type} frame`,
+        });
+    };
+    const reject = (key) => {
+        if (input[key] === undefined)
+            return;
+        context.addIssue({
+            code: "custom",
+            path: [key],
+            message: `${key} is not valid for a ${input.type} frame`,
+        });
+    };
+    switch (input.type) {
+        case "glts":
+            require("width");
+            require("height");
+            reject("image");
+            reject("asset");
+            break;
+        case "image":
+            require("image");
+            reject("width");
+            reject("height");
+            reject("asset");
+            break;
+        case "market":
+            require("asset");
+            reject("width");
+            reject("height");
+            reject("image");
+            break;
+    }
+});
+export const projectInput = z.object({ project: projectIdSchema }).strict();
+export const frameInput = projectInput.extend({ frame: frameIdSchema });
+export const fileInput = projectInput.extend({ path: filePathSchema });
+export function frameCreationInput(input) {
+    const position = {
+        ...(input.x === undefined ? {} : { x: input.x }),
+        ...(input.y === undefined ? {} : { y: input.y }),
+    };
+    switch (input.type) {
+        case "glts":
+            if (input.width === undefined || input.height === undefined) {
+                throw new Error("Validated GLTS frame input is missing dimensions");
+            }
+            return {
+                project: input.project,
+                name: input.name,
+                type: input.type,
+                width: input.width,
+                height: input.height,
+                ...position,
+            };
+        case "image":
+            if (input.image === undefined) {
+                throw new Error("Validated image frame input is missing an image");
+            }
+            return {
+                project: input.project,
+                name: input.name,
+                type: input.type,
+                image: input.image,
+                ...position,
+            };
+        case "market":
+            if (input.asset === undefined) {
+                throw new Error("Validated Market frame input is missing an asset");
+            }
+            return {
+                project: input.project,
+                name: input.name,
+                type: input.type,
+                asset: input.asset,
+                ...position,
+            };
+    }
+}

package/dist/mcp/skill.d.ts

@@ -0,0 +1,2 @@
+import type { DesignMcpServer } from "./types.js";
+export declare function registerSkillTool(server: DesignMcpServer): void;

package/dist/mcp/skill.js

@@ -0,0 +1,14 @@
+import { z } from "zod";
+import { mcpDesignSkill } from "../skill.generated.js";
+export function registerSkillTool(server) {
+    server.registerTool("get_skill", {
+        description: "Return instructions for building and composing 3D GLTS assets in Drawcall Design. Read it before creating or changing GLTS files.",
+        inputSchema: z.object({}).strict(),
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+            idempotentHint: true,
+        },
+    }, async () => ({ content: [{ type: "text", text: mcpDesignSkill }] }));
+}

package/dist/mcp/types.d.ts

@@ -0,0 +1,54 @@
+import type { CreateFrame, DesignFile, FileList, FileMutation, Frame, GenerateImageFrame, Project, Screenshot } from "../v1/schemas.js";
+import type { z } from "zod";
+export interface DesignMcpToolResult {
+    [key: string]: unknown;
+    content: Array<{
+        type: "text";
+        text: string;
+    } | {
+        type: "image";
+        data: string;
+        mimeType: string;
+    }>;
+    structuredContent?: Record<string, unknown>;
+}
+interface DesignMcpToolAnnotations {
+    readOnlyHint?: boolean;
+    destructiveHint?: boolean;
+    idempotentHint?: boolean;
+    openWorldHint?: boolean;
+}
+interface DesignMcpToolConfig<Input extends z.ZodType | undefined> {
+    description?: string;
+    inputSchema?: Input;
+    annotations?: DesignMcpToolAnnotations;
+}
+type DesignMcpToolHandler<Input extends z.ZodType | undefined> = Input extends z.ZodType ? (input: z.output<Input>) => Promise<DesignMcpToolResult> : () => Promise<DesignMcpToolResult>;
+export interface DesignMcpServer {
+    registerTool<Input extends z.ZodType | undefined = undefined>(name: string, config: DesignMcpToolConfig<Input>, handler: DesignMcpToolHandler<Input>): unknown;
+}
+export interface DesignMcpScreenshot extends Screenshot {
+    png: Uint8Array;
+}
+export type DesignMcpOperationRunner = <Result>(name: string, operation: () => Promise<Result>) => Promise<Result>;
+export interface DesignMcpOperations {
+    listProjects(): Promise<Project[]>;
+    createProject(name: string): Promise<Project>;
+    deleteProject(project: string): Promise<{
+        id: string;
+    }>;
+    listFrames(project: string): Promise<Frame[]>;
+    createFrame(input: CreateFrame): Promise<Frame>;
+    generateImage(input: GenerateImageFrame): Promise<Frame>;
+    renameFrame(project: string, frame: string, name: string): Promise<Frame>;
+    deleteFrame(project: string, frame: string): Promise<{
+        id: string;
+    }>;
+    listFiles(project: string, path?: string): Promise<FileList>;
+    readFile(project: string, path: string): Promise<DesignFile>;
+    writeFile(project: string, path: string, text: string): Promise<FileMutation>;
+    editFile(project: string, path: string, oldText: string, newText: string): Promise<FileMutation>;
+    deleteFile(project: string, path: string): Promise<FileMutation>;
+    screenshot(project: string, frame: string): Promise<DesignMcpScreenshot>;
+}
+export {};

package/dist/mcp/types.js

@@ -0,0 +1 @@
+export {};

package/dist/project-state.d.ts

@@ -65,8 +65,8 @@ export declare const projectImageFrameRecordSchema: z.ZodObject<{
             frameUpdatedAt: z.ZodString;
         }, z.core.$strip>>;
         result: z.ZodEnum<{
-            replace: "replace";
             new: "new";
+            replace: "replace";
         }>;
         provider: z.ZodLiteral<"fal-ai">;
         model: z.ZodLiteral<"openai/gpt-image-2">;
@@ -82,8 +82,8 @@ export declare const projectImageFrameRecordSchema: z.ZodObject<{
             frameUpdatedAt: z.ZodString;
         }, z.core.$strip>>;
         result: z.ZodEnum<{
-            replace: "replace";
             new: "new";
+            replace: "replace";
         }>;
         provider: z.ZodLiteral<"cloudflare-workers-ai">;
         model: z.ZodLiteral<"@cf/black-forest-labs/flux-2-klein-4b">;
@@ -177,8 +177,8 @@ export declare const projectFrameRecordSchema: z.ZodDiscriminatedUnion<[z.ZodObj
             frameUpdatedAt: z.ZodString;
         }, z.core.$strip>>;
         result: z.ZodEnum<{
-            replace: "replace";
             new: "new";
+            replace: "replace";
         }>;
         provider: z.ZodLiteral<"fal-ai">;
         model: z.ZodLiteral<"openai/gpt-image-2">;
@@ -194,8 +194,8 @@ export declare const projectFrameRecordSchema: z.ZodDiscriminatedUnion<[z.ZodObj
             frameUpdatedAt: z.ZodString;
         }, z.core.$strip>>;
         result: z.ZodEnum<{
-            replace: "replace";
             new: "new";
+            replace: "replace";
         }>;
         provider: z.ZodLiteral<"cloudflare-workers-ai">;
         model: z.ZodLiteral<"@cf/black-forest-labs/flux-2-klein-4b">;
@@ -287,8 +287,8 @@ export declare const projectStateSchema: z.ZodObject<{
                 frameUpdatedAt: z.ZodString;
             }, z.core.$strip>>;
             result: z.ZodEnum<{
-                replace: "replace";
                 new: "new";
+                replace: "replace";
             }>;
             provider: z.ZodLiteral<"fal-ai">;
             model: z.ZodLiteral<"openai/gpt-image-2">;
@@ -304,8 +304,8 @@ export declare const projectStateSchema: z.ZodObject<{
                 frameUpdatedAt: z.ZodString;
             }, z.core.$strip>>;
             result: z.ZodEnum<{
-                replace: "replace";
                 new: "new";
+                replace: "replace";
             }>;
             provider: z.ZodLiteral<"cloudflare-workers-ai">;
             model: z.ZodLiteral<"@cf/black-forest-labs/flux-2-klein-4b">;

package/dist/v1/contract.d.ts

@@ -154,8 +154,8 @@ export declare const contract: {
                     frameUpdatedAt: z.ZodString;
                 }, z.core.$strip>>;
                 result: z.ZodEnum<{
-                    replace: "replace";
                     new: "new";
+                    replace: "replace";
                 }>;
                 provider: z.ZodLiteral<"fal-ai">;
                 model: z.ZodLiteral<"openai/gpt-image-2">;
@@ -171,8 +171,8 @@ export declare const contract: {
                     frameUpdatedAt: z.ZodString;
                 }, z.core.$strip>>;
                 result: z.ZodEnum<{
-                    replace: "replace";
                     new: "new";
+                    replace: "replace";
                 }>;
                 provider: z.ZodLiteral<"cloudflare-workers-ai">;
                 model: z.ZodLiteral<"@cf/black-forest-labs/flux-2-klein-4b">;
@@ -264,8 +264,8 @@ export declare const contract: {
                     frameUpdatedAt: z.ZodString;
                 }, z.core.$strip>>;
                 result: z.ZodEnum<{
-                    replace: "replace";
                     new: "new";
+                    replace: "replace";
                 }>;
                 provider: z.ZodLiteral<"fal-ai">;
                 model: z.ZodLiteral<"openai/gpt-image-2">;
@@ -281,8 +281,8 @@ export declare const contract: {
                     frameUpdatedAt: z.ZodString;
                 }, z.core.$strip>>;
                 result: z.ZodEnum<{
-                    replace: "replace";
                     new: "new";
+                    replace: "replace";
                 }>;
                 provider: z.ZodLiteral<"cloudflare-workers-ai">;
                 model: z.ZodLiteral<"@cf/black-forest-labs/flux-2-klein-4b">;
@@ -311,8 +311,8 @@ export declare const contract: {
             target: z.ZodOptional<z.ZodString>;
             references: z.ZodDefault<z.ZodArray<z.ZodString>>;
             result: z.ZodEnum<{
-                replace: "replace";
                 new: "new";
+                replace: "replace";
             }>;
             name: z.ZodOptional<z.ZodString>;
             x: z.ZodOptional<z.ZodNumber>;
@@ -368,8 +368,8 @@ export declare const contract: {
                     frameUpdatedAt: z.ZodString;
                 }, z.core.$strip>>;
                 result: z.ZodEnum<{
-                    replace: "replace";
                     new: "new";
+                    replace: "replace";
                 }>;
                 provider: z.ZodLiteral<"fal-ai">;
                 model: z.ZodLiteral<"openai/gpt-image-2">;
@@ -385,8 +385,8 @@ export declare const contract: {
                     frameUpdatedAt: z.ZodString;
                 }, z.core.$strip>>;
                 result: z.ZodEnum<{
-                    replace: "replace";
                     new: "new";
+                    replace: "replace";
                 }>;
                 provider: z.ZodLiteral<"cloudflare-workers-ai">;
                 model: z.ZodLiteral<"@cf/black-forest-labs/flux-2-klein-4b">;
@@ -460,8 +460,8 @@ export declare const contract: {
                     frameUpdatedAt: z.ZodString;
                 }, z.core.$strip>>;
                 result: z.ZodEnum<{
-                    replace: "replace";
                     new: "new";
+                    replace: "replace";
                 }>;
                 provider: z.ZodLiteral<"fal-ai">;
                 model: z.ZodLiteral<"openai/gpt-image-2">;
@@ -477,8 +477,8 @@ export declare const contract: {
                     frameUpdatedAt: z.ZodString;
                 }, z.core.$strip>>;
                 result: z.ZodEnum<{
-                    replace: "replace";
                     new: "new";
+                    replace: "replace";
                 }>;
                 provider: z.ZodLiteral<"cloudflare-workers-ai">;
                 model: z.ZodLiteral<"@cf/black-forest-labs/flux-2-klein-4b">;
@@ -566,8 +566,8 @@ export declare const contract: {
                     frameUpdatedAt: z.ZodString;
                 }, z.core.$strip>>;
                 result: z.ZodEnum<{
-                    replace: "replace";
                     new: "new";
+                    replace: "replace";
                 }>;
                 provider: z.ZodLiteral<"fal-ai">;
                 model: z.ZodLiteral<"openai/gpt-image-2">;
@@ -583,8 +583,8 @@ export declare const contract: {
                     frameUpdatedAt: z.ZodString;
                 }, z.core.$strip>>;
                 result: z.ZodEnum<{
-                    replace: "replace";
                     new: "new";
+                    replace: "replace";
                 }>;
                 provider: z.ZodLiteral<"cloudflare-workers-ai">;
                 model: z.ZodLiteral<"@cf/black-forest-labs/flux-2-klein-4b">;
@@ -661,8 +661,8 @@ export declare const contract: {
                     frameUpdatedAt: z.ZodString;
                 }, z.core.$strip>>;
                 result: z.ZodEnum<{
-                    replace: "replace";
                     new: "new";
+                    replace: "replace";
                 }>;
                 provider: z.ZodLiteral<"fal-ai">;
                 model: z.ZodLiteral<"openai/gpt-image-2">;
@@ -678,8 +678,8 @@ export declare const contract: {
                     frameUpdatedAt: z.ZodString;
                 }, z.core.$strip>>;
                 result: z.ZodEnum<{
-                    replace: "replace";
                     new: "new";
+                    replace: "replace";
                 }>;
                 provider: z.ZodLiteral<"cloudflare-workers-ai">;
                 model: z.ZodLiteral<"@cf/black-forest-labs/flux-2-klein-4b">;

package/dist/v1/schemas.d.ts

@@ -97,8 +97,8 @@ export declare const imageGenerationOperationSchema: z.ZodEnum<{
     edit: "edit";
 }>;
 export declare const imageGenerationResultSchema: z.ZodEnum<{
-    replace: "replace";
     new: "new";
+    replace: "replace";
 }>;
 export declare const imageGenerationReferenceSchema: z.ZodObject<{
     frameId: z.ZodString;
@@ -120,8 +120,8 @@ export declare const imageGenerationProvenanceSchema: z.ZodDiscriminatedUnion<[z
         frameUpdatedAt: z.ZodString;
     }, z.core.$strip>>;
     result: z.ZodEnum<{
-        replace: "replace";
         new: "new";
+        replace: "replace";
     }>;
     provider: z.ZodLiteral<"fal-ai">;
     model: z.ZodLiteral<"openai/gpt-image-2">;
@@ -137,8 +137,8 @@ export declare const imageGenerationProvenanceSchema: z.ZodDiscriminatedUnion<[z
         frameUpdatedAt: z.ZodString;
     }, z.core.$strip>>;
     result: z.ZodEnum<{
-        replace: "replace";
         new: "new";
+        replace: "replace";
     }>;
     provider: z.ZodLiteral<"cloudflare-workers-ai">;
     model: z.ZodLiteral<"@cf/black-forest-labs/flux-2-klein-4b">;
@@ -168,8 +168,8 @@ export declare const imageFrameSchema: z.ZodObject<{
             frameUpdatedAt: z.ZodString;
         }, z.core.$strip>>;
         result: z.ZodEnum<{
-            replace: "replace";
             new: "new";
+            replace: "replace";
         }>;
         provider: z.ZodLiteral<"fal-ai">;
         model: z.ZodLiteral<"openai/gpt-image-2">;
@@ -185,8 +185,8 @@ export declare const imageFrameSchema: z.ZodObject<{
             frameUpdatedAt: z.ZodString;
         }, z.core.$strip>>;
         result: z.ZodEnum<{
-            replace: "replace";
             new: "new";
+            replace: "replace";
         }>;
         provider: z.ZodLiteral<"cloudflare-workers-ai">;
         model: z.ZodLiteral<"@cf/black-forest-labs/flux-2-klein-4b">;
@@ -257,8 +257,8 @@ export declare const frameSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             frameUpdatedAt: z.ZodString;
         }, z.core.$strip>>;
         result: z.ZodEnum<{
-            replace: "replace";
             new: "new";
+            replace: "replace";
         }>;
         provider: z.ZodLiteral<"fal-ai">;
         model: z.ZodLiteral<"openai/gpt-image-2">;
@@ -274,8 +274,8 @@ export declare const frameSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             frameUpdatedAt: z.ZodString;
         }, z.core.$strip>>;
         result: z.ZodEnum<{
-            replace: "replace";
             new: "new";
+            replace: "replace";
         }>;
         provider: z.ZodLiteral<"cloudflare-workers-ai">;
         model: z.ZodLiteral<"@cf/black-forest-labs/flux-2-klein-4b">;
@@ -352,8 +352,8 @@ export declare const generateImageFrameSchema: z.ZodObject<{
     target: z.ZodOptional<z.ZodString>;
     references: z.ZodDefault<z.ZodArray<z.ZodString>>;
     result: z.ZodEnum<{
-        replace: "replace";
         new: "new";
+        replace: "replace";
     }>;
     name: z.ZodOptional<z.ZodString>;
     x: z.ZodOptional<z.ZodNumber>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drawcall/design",
-  "version": "0.5.8",
+  "version": "0.5.11",
   "description": "Typed API and remote CLI for Drawcall Design",
   "repository": {
     "type": "git",
@@ -8,13 +8,9 @@
     "directory": "packages/design"
   },
   "type": "module",
+  "main": "./dist/index.js",
+  "browser": "./dist/browser.js",
   "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    }
-  },
   "files": [
     "dist",
     "skills"
@@ -34,15 +30,23 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
+    "@drawcall/auth": "^0.1.0",
     "@orpc/client": "^1.14.13",
     "@orpc/contract": "^1.14.13",
     "@orpc/openapi-client": "^1.14.13",
     "commander": "^14.0.3",
-    "open": "^10.1.0",
-    "openid-client": "^6.8.4",
     "zod": "^4.3.6"
   },
+  "peerDependencies": {
+    "@modelcontextprotocol/server": "^2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@modelcontextprotocol/server": {
+      "optional": true
+    }
+  },
   "devDependencies": {
+    "@modelcontextprotocol/server": "^2.0.0",
     "@types/node": "^25.6.0",
     "prettier": "^3.6.2",
     "tsx": "^4.21.0",