@drawcall/design 0.2.12 → 0.3.0

package/README.md

@@ -32,4 +32,4 @@ npx @drawcall/design -p r6z2n9k4x8m1qc frame create oak-chair \
   --type market --asset oak-chair@1.2.3
 ```
 
-GLTS frames accept only `.glts` files. `index.glts` is optional: an absent entry renders an empty frame. Image and Market files are available through the same filesystem but are read-only. Read `npx @drawcall/design skill` (or MCP `get_skill`) before creating or changing a GLTS asset.
+GLTS frames accept only `.glts` files. An absent `index.glts` still renders an intentionally empty frame. For authored scenes, work top-down: write `index.glts`, reference planned child assets, then implement those children progressively. A missing imported `.glts` path renders a labeled glowing placeholder without creating a stored file; writing the real file replaces it on revalidation. Image and Market files are available through the same filesystem but are read-only. Read `npx @drawcall/design skill` (or MCP `get_skill`) before creating or changing a GLTS asset.

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 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 { parseFrameSize } from "./target.js";
-export { acknowledgesInspection, inspectionCommandSchema, inspectionFrameMessageSchema, inspectionMessageTypes, projectSyncUrl, type InspectionAppliedMessage, type InspectionCommand, type InspectionFrameMessage, } from "./protocol.js";
-export type { BinaryFile, CreateFrame, CreateGltsFrame, CreateImageFrame, CreateMarketFrame, DesignFile, FileList, FileMutation, Frame, GltsFrame, ImageFrame, MarketFrame, Project, Screenshot, TextFile, User, } from "./v1/schemas.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";

package/dist/index.js

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

package/dist/protocol.d.ts

@@ -1,4 +1,8 @@
 import { z } from "zod";
+export declare const projectSyncMaps: {
+    readonly filesystemRevision: "filesystem-revision";
+    readonly frameRecords: "frame-records";
+};
 export declare const inspectionMessageTypes: {
     readonly applied: "drawcall:inspection:applied";
     readonly exit: "drawcall:inspection:exit";

package/dist/protocol.js

@@ -1,4 +1,8 @@
 import { z } from "zod";
+export const projectSyncMaps = {
+    filesystemRevision: "filesystem-revision",
+    frameRecords: "frame-records",
+};
 export const inspectionMessageTypes = {
     applied: "drawcall:inspection:applied",
     exit: "drawcall:inspection:exit",

package/dist/skill.generated.d.ts

@@ -1 +1 @@
-export declare const designSkill = "---\nname: drawcall-design\ndescription: Create, modify, inspect, and screenshot 3D assets and reference frames in Drawcall Design. Use for Drawcall Design projects, frames, the project filesystem, GLTS assets, or Drawcall Market frames. Do not use for full games or applications.\n---\n\n# Drawcall Design\n\nUse the Drawcall Design MCP tools when available. Otherwise use `npx @drawcall/design`. Design is a remote, current-state canvas: inspect the project and its frames before changing them. Use immutable IDs for every project and frame target; names are only labels.\n\n## Project filesystem\n\nA project is a hosted filesystem at `https://<project-id>.design.drawcallcontent.com/`. Each frame owns one top-level folder, `/<frame-id>/`. The CLI selects the project with `-p <project-id>`; its file paths are exactly the absolute paths inside that project, for example `/f7k3m9q2x8vd/index.glts`.\n\nCreate frames with an explicit type. GLTS frames require `--size`; image and Market frames derive their canvas size. A Market frame requires an exact public asset reference, `name@version`.\n\nRead a file before editing it. Use a narrow edit for one known change and write a complete file when replacing it. Only GLTS frame files may be created or deleted. Image and Market frame files are read-only.\n\n## GLTS assets\n\nA GLTS frame contains only `.glts` files. `index.glts` is its optional root asset; without it the frame renders empty. Every `.glts` file is a trusted TypeScript ESM module that default-exports a no-argument class derived from `THREE.Object3D`. Avoid top-level side effects because reload evaluates the module again. Implement `dispose()` when the asset exclusively owns disposable resources.\n\n```ts\nimport * as THREE from \"three\";\nimport Wheel from \"./parts/wheel.glts\";\n\nexport default class Racecar extends THREE.Group {\n  constructor() {\n    super();\n    this.add(new Wheel());\n  }\n}\n```\n\nUse relative `.glts` imports within a frame. Use a project-absolute path to import a GLTS asset from another frame:\n\n```ts\nimport Chassis from \"/other-frame-id/index.glts\";\n```\n\nFor a non-GLTS file from an image or Market frame, preserve the project filesystem URL through `import.meta.url`:\n\n```ts\nconst modelUrl = new URL(\"/market-frame-id/models/car.glb\", import.meta.url);\n```\n\nGLTS supports static `.glts`, `three`, Three addons, and bare npm imports. It does not support local helper `.ts` modules, dynamic imports, cyclic GLTS graphs, or cross-asset inheritance. Keep the asset self-contained and compose with nested GLTS assets.\n\nThe viewer uses the first camera found by depth-first traversal. If none exists, it autofits the asset. Put an authored camera in the scene only when its framing is intentional. Double-clicking a frame enters orbit from that resolved view; deselecting restores it.\n\nAfter every meaningful visual change, take and inspect a screenshot. Iterate until the asset, camera, composition, and requested frame size are right.\n";
+export declare const designSkill = "---\nname: drawcall-design\ndescription: Create, modify, inspect, and screenshot 3D assets and reference frames in Drawcall Design. Use for Drawcall Design projects, frames, the project filesystem, GLTS assets, or Drawcall Market frames. Do not use for full games or applications.\n---\n\n# Drawcall Design\n\nUse the Drawcall Design MCP tools when available. Otherwise use `npx @drawcall/design`. Design is a remote, current-state canvas: inspect the project and its frames before changing them. Use immutable IDs for every project and frame target; names are only labels.\n\n## Project filesystem\n\nA project is a hosted filesystem at `https://<project-id>.design.drawcallcontent.com/`. Each frame owns one top-level folder, `/<frame-id>/`. The CLI selects the project with `-p <project-id>`; its file paths are exactly the absolute paths inside that project, for example `/f7k3m9q2x8vd/index.glts`.\n\nCreate frames with an explicit type. GLTS frames require `--size`; image and Market frames derive their canvas size. A Market frame requires an exact public asset reference, `name@version`.\n\nRead a file before editing it. Use a narrow edit for one known change and write a complete file when replacing it. Only GLTS frame files may be created or deleted. Image and Market frame files are read-only.\n\n## GLTS assets\n\nA GLTS frame contains only `.glts` files. `index.glts` is its optional root asset; without it the frame renders empty. Every `.glts` file is a trusted TypeScript ESM module that default-exports a no-argument class derived from `THREE.Object3D`. Avoid top-level side effects because reload evaluates the module again. Implement `dispose()` when the asset exclusively owns disposable resources.\n\nAuthor GLTS scenes top-down: create the root entry scene first, reference the child `.glts` assets it will compose, then implement those children progressively. A missing `.glts` import renders as a glowing marker labeled with its filename until the real file is written, so the completed parts of the scene remain visible. Treat the marker and its console warning as a temporary missing-dependency diagnostic, not as authored content.\n\n```ts\nimport * as THREE from \"three\";\nimport Wheel from \"./parts/wheel.glts\";\n\nexport default class Racecar extends THREE.Group {\n  constructor() {\n    super();\n    this.add(new Wheel());\n  }\n}\n```\n\nUse relative `.glts` imports within a frame. Use a project-absolute path to import a GLTS asset from another frame:\n\n```ts\nimport Chassis from \"/other-frame-id/index.glts\";\n```\n\nFor a non-GLTS file from an image or Market frame, preserve the project filesystem URL through `import.meta.url`:\n\n```ts\nconst modelUrl = new URL(\"/market-frame-id/models/car.glb\", import.meta.url);\n```\n\nGLTS supports static `.glts`, `three`, Three addons, and bare npm imports. It does not support local helper `.ts` modules, dynamic imports, cyclic GLTS graphs, or cross-asset inheritance. Keep the asset self-contained and compose with nested GLTS assets.\n\nThe viewer uses the first camera found by depth-first traversal. If none exists, it autofits the asset. Put an authored camera in the scene only when its framing is intentional. Double-clicking a frame enters orbit from that resolved view; deselecting restores it.\n\nAfter every meaningful visual change, take and inspect a screenshot. Iterate until the asset, camera, composition, and requested frame size are right.\n";

package/dist/skill.generated.js

@@ -1,2 +1,2 @@
 // Generated from skills/drawcall-design/SKILL.md.
-export const designSkill = '---\nname: drawcall-design\ndescription: Create, modify, inspect, and screenshot 3D assets and reference frames in Drawcall Design. Use for Drawcall Design projects, frames, the project filesystem, GLTS assets, or Drawcall Market frames. Do not use for full games or applications.\n---\n\n# Drawcall Design\n\nUse the Drawcall Design MCP tools when available. Otherwise use `npx @drawcall/design`. Design is a remote, current-state canvas: inspect the project and its frames before changing them. Use immutable IDs for every project and frame target; names are only labels.\n\n## Project filesystem\n\nA project is a hosted filesystem at `https://<project-id>.design.drawcallcontent.com/`. Each frame owns one top-level folder, `/<frame-id>/`. The CLI selects the project with `-p <project-id>`; its file paths are exactly the absolute paths inside that project, for example `/f7k3m9q2x8vd/index.glts`.\n\nCreate frames with an explicit type. GLTS frames require `--size`; image and Market frames derive their canvas size. A Market frame requires an exact public asset reference, `name@version`.\n\nRead a file before editing it. Use a narrow edit for one known change and write a complete file when replacing it. Only GLTS frame files may be created or deleted. Image and Market frame files are read-only.\n\n## GLTS assets\n\nA GLTS frame contains only `.glts` files. `index.glts` is its optional root asset; without it the frame renders empty. Every `.glts` file is a trusted TypeScript ESM module that default-exports a no-argument class derived from `THREE.Object3D`. Avoid top-level side effects because reload evaluates the module again. Implement `dispose()` when the asset exclusively owns disposable resources.\n\n```ts\nimport * as THREE from "three";\nimport Wheel from "./parts/wheel.glts";\n\nexport default class Racecar extends THREE.Group {\n  constructor() {\n    super();\n    this.add(new Wheel());\n  }\n}\n```\n\nUse relative `.glts` imports within a frame. Use a project-absolute path to import a GLTS asset from another frame:\n\n```ts\nimport Chassis from "/other-frame-id/index.glts";\n```\n\nFor a non-GLTS file from an image or Market frame, preserve the project filesystem URL through `import.meta.url`:\n\n```ts\nconst modelUrl = new URL("/market-frame-id/models/car.glb", import.meta.url);\n```\n\nGLTS supports static `.glts`, `three`, Three addons, and bare npm imports. It does not support local helper `.ts` modules, dynamic imports, cyclic GLTS graphs, or cross-asset inheritance. Keep the asset self-contained and compose with nested GLTS assets.\n\nThe viewer uses the first camera found by depth-first traversal. If none exists, it autofits the asset. Put an authored camera in the scene only when its framing is intentional. Double-clicking a frame enters orbit from that resolved view; deselecting restores it.\n\nAfter every meaningful visual change, take and inspect a screenshot. Iterate until the asset, camera, composition, and requested frame size are right.\n';
+export const designSkill = '---\nname: drawcall-design\ndescription: Create, modify, inspect, and screenshot 3D assets and reference frames in Drawcall Design. Use for Drawcall Design projects, frames, the project filesystem, GLTS assets, or Drawcall Market frames. Do not use for full games or applications.\n---\n\n# Drawcall Design\n\nUse the Drawcall Design MCP tools when available. Otherwise use `npx @drawcall/design`. Design is a remote, current-state canvas: inspect the project and its frames before changing them. Use immutable IDs for every project and frame target; names are only labels.\n\n## Project filesystem\n\nA project is a hosted filesystem at `https://<project-id>.design.drawcallcontent.com/`. Each frame owns one top-level folder, `/<frame-id>/`. The CLI selects the project with `-p <project-id>`; its file paths are exactly the absolute paths inside that project, for example `/f7k3m9q2x8vd/index.glts`.\n\nCreate frames with an explicit type. GLTS frames require `--size`; image and Market frames derive their canvas size. A Market frame requires an exact public asset reference, `name@version`.\n\nRead a file before editing it. Use a narrow edit for one known change and write a complete file when replacing it. Only GLTS frame files may be created or deleted. Image and Market frame files are read-only.\n\n## GLTS assets\n\nA GLTS frame contains only `.glts` files. `index.glts` is its optional root asset; without it the frame renders empty. Every `.glts` file is a trusted TypeScript ESM module that default-exports a no-argument class derived from `THREE.Object3D`. Avoid top-level side effects because reload evaluates the module again. Implement `dispose()` when the asset exclusively owns disposable resources.\n\nAuthor GLTS scenes top-down: create the root entry scene first, reference the child `.glts` assets it will compose, then implement those children progressively. A missing `.glts` import renders as a glowing marker labeled with its filename until the real file is written, so the completed parts of the scene remain visible. Treat the marker and its console warning as a temporary missing-dependency diagnostic, not as authored content.\n\n```ts\nimport * as THREE from "three";\nimport Wheel from "./parts/wheel.glts";\n\nexport default class Racecar extends THREE.Group {\n  constructor() {\n    super();\n    this.add(new Wheel());\n  }\n}\n```\n\nUse relative `.glts` imports within a frame. Use a project-absolute path to import a GLTS asset from another frame:\n\n```ts\nimport Chassis from "/other-frame-id/index.glts";\n```\n\nFor a non-GLTS file from an image or Market frame, preserve the project filesystem URL through `import.meta.url`:\n\n```ts\nconst modelUrl = new URL("/market-frame-id/models/car.glb", import.meta.url);\n```\n\nGLTS supports static `.glts`, `three`, Three addons, and bare npm imports. It does not support local helper `.ts` modules, dynamic imports, cyclic GLTS graphs, or cross-asset inheritance. Keep the asset self-contained and compose with nested GLTS assets.\n\nThe viewer uses the first camera found by depth-first traversal. If none exists, it autofits the asset. Put an authored camera in the scene only when its framing is intentional. Double-clicking a frame enters orbit from that resolved view; deselecting restores it.\n\nAfter every meaningful visual change, take and inspect a screenshot. Iterate until the asset, camera, composition, and requested frame size are right.\n';

package/dist/v1/capabilities.d.ts

@@ -0,0 +1,10 @@
+export type FrameCreationCapabilityId = "add-image" | "create-glts" | "search-assets";
+export type FrameCreationInput = "asset" | "height" | "image" | "name" | "width";
+export interface FrameCreationCapability {
+    id: FrameCreationCapabilityId;
+    frameType: "glts" | "image" | "market";
+    label: string;
+    description: string;
+    inputs: readonly FrameCreationInput[];
+}
+export declare const frameCreationCapabilities: readonly FrameCreationCapability[];

package/dist/v1/capabilities.js

@@ -0,0 +1,23 @@
+export const frameCreationCapabilities = [
+    {
+        id: "add-image",
+        frameType: "image",
+        label: "Add image",
+        description: "Upload a PNG, JPEG, or WebP image",
+        inputs: ["image"],
+    },
+    {
+        id: "create-glts",
+        frameType: "glts",
+        label: "Create GLTS frame",
+        description: "Create an empty programmable 3D frame",
+        inputs: ["name", "width", "height"],
+    },
+    {
+        id: "search-assets",
+        frameType: "market",
+        label: "Search assets",
+        description: "Find an approved public Drawcall Market asset",
+        inputs: ["asset"],
+    },
+];

package/dist/v1/contract.d.ts

@@ -12,6 +12,15 @@ export declare const contract: {
         list: import("@orpc/contract").ContractProcedureBuilderWithOutput<import("@orpc/contract").Schema<unknown, unknown>, z.ZodArray<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>>;
@@ -20,6 +29,50 @@ export declare const contract: {
         }, 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>>;
+        createFromBrief: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+            brief: z.ZodString;
+            requestId: 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>>;
+        retryDerivation: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+            project: 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>>;

package/dist/v1/contract.js

@@ -1,6 +1,6 @@
 import { oc } from "@orpc/contract";
 import { z } from "zod";
-import { createFrameSchema, 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, 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 });
@@ -17,6 +17,17 @@ export const contract = {
             .route({ method: "POST", path: "/projects" })
             .input(z.object({ name: projectNameSchema }))
             .output(projectSchema),
+        createFromBrief: oc
+            .route({ method: "POST", path: "/projects/from-brief" })
+            .input(createProjectFromBriefSchema)
+            .output(projectSchema),
+        retryDerivation: oc
+            .route({
+            method: "POST",
+            path: "/projects/{project}/derivation",
+        })
+            .input(projectInputSchema)
+            .output(projectSchema),
         delete: oc
             .route({ method: "DELETE", path: "/projects/{project}" })
             .input(projectInputSchema)

package/dist/v1/index.d.ts

@@ -1,3 +1,4 @@
 export { contract, type V1Contract } from "./contract.js";
+export { frameCreationCapabilities, type FrameCreationCapability, type FrameCreationCapabilityId, type FrameCreationInput, } from "./capabilities.js";
 export { createClient, DEFAULT_BASE_URL, type DesignV1Client, type DesignV1ClientOptions, } from "./client.js";
 export * from "./schemas.js";

package/dist/v1/index.js

@@ -1,3 +1,4 @@
 export { contract } from "./contract.js";
+export { frameCreationCapabilities, } from "./capabilities.js";
 export { createClient, DEFAULT_BASE_URL, } from "./client.js";
 export * from "./schemas.js";

package/dist/v1/schemas.d.ts

@@ -3,6 +3,14 @@ export declare const MAX_FRAME_DIMENSION = 4096;
 export declare const MAX_FILE_LENGTH = 512000;
 export declare const designIdSchema: z.ZodString;
 export declare const projectNameSchema: z.ZodString;
+export declare const projectBriefSchema: z.ZodString;
+export declare const projectSummarySchema: z.ZodString;
+export declare const projectDerivationStatusSchema: z.ZodEnum<{
+    not_requested: "not_requested";
+    pending: "pending";
+    failed: "failed";
+    complete: "complete";
+}>;
 export declare const frameNameSchema: z.ZodString;
 export declare const frameSizeSchema: z.ZodNumber;
 export declare const framePositionSchema: z.ZodNumber;
@@ -25,9 +33,22 @@ export declare const userSchema: z.ZodObject<{
 export declare const projectSchema: 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>;
+export declare const createProjectFromBriefSchema: z.ZodObject<{
+    brief: z.ZodString;
+    requestId: z.ZodString;
+}, z.core.$strip>;
 export declare const gltsFrameSchema: z.ZodObject<{
     id: z.ZodString;
     projectId: z.ZodString;
@@ -193,6 +214,8 @@ export declare const screenshotSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type User = z.infer<typeof userSchema>;
 export type Project = z.infer<typeof projectSchema>;
+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 MarketFrame = z.infer<typeof marketFrameSchema>;

package/dist/v1/schemas.js

@@ -10,6 +10,17 @@ export const projectNameSchema = z
     .min(1)
     .max(80)
     .refine((name) => !name.includes("/"), "Project names cannot contain /");
+export const projectBriefSchema = z
+    .string()
+    .max(4_000)
+    .refine((brief) => brief.trim().length > 0, "Project briefs cannot be empty");
+export const projectSummarySchema = z.string().trim().min(1).max(280);
+export const projectDerivationStatusSchema = z.enum([
+    "not_requested",
+    "pending",
+    "failed",
+    "complete",
+]);
 export const frameNameSchema = z
     .string()
     .trim()
@@ -54,9 +65,17 @@ export const userSchema = z.object({
 export const projectSchema = z.object({
     id: designIdSchema,
     name: projectNameSchema,
+    sourceBrief: projectBriefSchema.nullable(),
+    title: projectNameSchema.nullable(),
+    summary: projectSummarySchema.nullable(),
+    derivationStatus: projectDerivationStatusSchema,
     createdAt: z.string().datetime(),
     updatedAt: z.string().datetime(),
 });
+export const createProjectFromBriefSchema = z.object({
+    brief: projectBriefSchema,
+    requestId: z.string().uuid(),
+});
 const frameBaseSchema = z.object({
     id: designIdSchema,
     projectId: designIdSchema,

package/package.json

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

package/skills/drawcall-design/SKILL.md

@@ -19,6 +19,8 @@ Read a file before editing it. Use a narrow edit for one known change and write
 
 A GLTS frame contains only `.glts` files. `index.glts` is its optional root asset; without it the frame renders empty. Every `.glts` file is a trusted TypeScript ESM module that default-exports a no-argument class derived from `THREE.Object3D`. Avoid top-level side effects because reload evaluates the module again. Implement `dispose()` when the asset exclusively owns disposable resources.
 
+Author GLTS scenes top-down: create the root entry scene first, reference the child `.glts` assets it will compose, then implement those children progressively. A missing `.glts` import renders as a glowing marker labeled with its filename until the real file is written, so the completed parts of the scene remain visible. Treat the marker and its console warning as a temporary missing-dependency diagnostic, not as authored content.
+
 ```ts
 import * as THREE from "three";
 import Wheel from "./parts/wheel.glts";