feat: support Design.md workflow for design system creation (#359)

Stitch recently added the ability to create design systems from markdown
files (DESIGN.md). This is a two-step workflow:

1. Upload a markdown file describing the design language to a project
2. Create a design system from that uploaded file, which Stitch interprets
   and converts into actionable design tokens

SDK (domain classes):

  const instance = await project.uploadDesignMd(btoa(markdown));
  const ds = await project.createDesignSystemFromDesignMd(instance, 'DESKTOP');

Agent (callTool / tool definitions):

Both tools are also registered in the tool definitions, so agents using
callTool or the ADK/AI SDK adapters can discover and invoke them directly.

This brings the SDK to full MCP tool coverage (14/14) across both modalities.

Author: davideast

packages/sdk/generated/domain-map.json

@@ -423,6 +423,43 @@
         ],
         "array": true
       }
+    },
+    {
+      "tool": "upload_design_md",
+      "class": "Project",
+      "method": "uploadDesignMd",
+      "args": {
+        "projectId": {
+          "from": "self"
+        },
+        "designMdBase64": {
+          "from": "param"
+        }
+      },
+      "returns": {
+        "projection": []
+      }
+    },
+    {
+      "tool": "create_design_system_from_design_md",
+      "class": "Project",
+      "method": "createDesignSystemFromDesignMd",
+      "args": {
+        "projectId": {
+          "from": "self"
+        },
+        "selectedScreenInstance": {
+          "from": "param"
+        },
+        "deviceType": {
+          "from": "param",
+          "optional": true
+        }
+      },
+      "returns": {
+        "class": "DesignSystem",
+        "projection": []
+      }
     }
   ]
 }

packages/sdk/generated/src/designsystem.ts

@@ -2,13 +2,14 @@
  * AUTO-GENERATED by scripts/generate-sdk.ts
 DO NOT EDIT — changes will be overwritten.
 
-Source: tools-manifest.json (sha256:2f1a623ec115...)
-        domain-map.json     (sha256:0ee09d686be6...)
-Generated: 2026-06-01T03:47:10.743Z
+Source: tools-manifest.json (sha256:d831990b27e9...)
+        domain-map.json     (sha256:715639788724...)
+Generated: 2026-06-01T04:11:36.685Z
  */
 import { type StitchToolClient } from "../../src/client.js";
 import { StitchError } from "../../src/spec/errors.js";
 import {
+  ComponentTokens,
   DesignTheme,
   File,
   ProjectMetadata,
@@ -29,7 +30,10 @@ import {
   PrototypeLinks,
   PrototypeState,
   PrototypeV2Spec,
+  Question,
+  QuestionsAsked,
   ScreenMetadata,
+  SessionEvent,
   SessionOutputComponent,
   VariantOptions,
   SelectedScreenInstance,

packages/sdk/generated/src/index.ts

@@ -2,9 +2,9 @@
  * AUTO-GENERATED by scripts/generate-sdk.ts
 DO NOT EDIT — changes will be overwritten.
 
-Source: tools-manifest.json (sha256:2f1a623ec115...)
-        domain-map.json     (sha256:0ee09d686be6...)
-Generated: 2026-06-01T03:47:10.743Z
+Source: tools-manifest.json (sha256:d831990b27e9...)
+        domain-map.json     (sha256:715639788724...)
+Generated: 2026-06-01T04:11:36.685Z
  */
 export { Stitch } from "./stitch.js";
 export { Project } from "./project.js";

packages/sdk/generated/src/project.ts

@@ -2,13 +2,14 @@
  * AUTO-GENERATED by scripts/generate-sdk.ts
 DO NOT EDIT — changes will be overwritten.
 
-Source: tools-manifest.json (sha256:2f1a623ec115...)
-        domain-map.json     (sha256:0ee09d686be6...)
-Generated: 2026-06-01T03:47:10.743Z
+Source: tools-manifest.json (sha256:d831990b27e9...)
+        domain-map.json     (sha256:715639788724...)
+Generated: 2026-06-01T04:11:36.685Z
  */
 import { type StitchToolClient } from "../../src/client.js";
 import { StitchError } from "../../src/spec/errors.js";
 import {
+  ComponentTokens,
   DesignTheme,
   File,
   ProjectMetadata,
@@ -29,7 +30,10 @@ import {
   PrototypeLinks,
   PrototypeState,
   PrototypeV2Spec,
+  Question,
+  QuestionsAsked,
   ScreenMetadata,
+  SessionEvent,
   SessionOutputComponent,
   VariantOptions,
   SelectedScreenInstance,
@@ -40,6 +44,8 @@ import {
   GetScreenResponse,
   CreateDesignSystemResponse,
   ListDesignSystemsResponse,
+  UploadDesignMdResponse,
+  CreateDesignSystemFromDesignMdResponse,
 } from "./responses.generated.js";
 import { Screen } from "./screen.js";
 import { DesignSystem } from "./designsystem.js";
@@ -187,6 +193,51 @@ export class Project {
     }
   }
 
+  /**
+   * Uploads DESIGN.md to a Stitch project. Use this tool when the user wants to create a design system from a DESIGN.md file.
+   * Tool: upload_design_md
+   */
+  async uploadDesignMd(designMdBase64: string): Promise<any> {
+    try {
+      const raw = await this.client.callTool<UploadDesignMdResponse>(
+        "upload_design_md",
+        { projectId: this.projectId, designMdBase64 },
+      );
+      return raw || "";
+    } catch (error) {
+      throw StitchError.fromUnknown(error);
+    }
+  }
+
+  /**
+   * Creates a design system for a project, with user uploaded DESIGN.md file, and displays the design system in the UI.
+   * Tool: create_design_system_from_design_md
+   */
+  async createDesignSystemFromDesignMd(
+    selectedScreenInstance: SelectedScreenInstance,
+    deviceType?:
+      | "DEVICE_TYPE_UNSPECIFIED"
+      | "MOBILE"
+      | "DESKTOP"
+      | "TABLET"
+      | "AGNOSTIC",
+  ): Promise<DesignSystem> {
+    try {
+      const raw =
+        await this.client.callTool<CreateDesignSystemFromDesignMdResponse>(
+          "create_design_system_from_design_md",
+          { projectId: this.projectId, selectedScreenInstance, deviceType },
+        );
+      return this.client.entities.resolve(
+        DesignSystem,
+        ["projectId", "assetId"],
+        { ...raw, projectId: this.projectId },
+      );
+    } catch (error) {
+      throw StitchError.fromUnknown(error);
+    }
+  }
+
   /** Create a DesignSystem handle from an existing ID without an API call. */
   designSystem(id: string): DesignSystem {
     return this.client.entities.resolve(

packages/sdk/generated/src/responses.generated.ts

@@ -1,4 +1,5 @@
 import {
+  ComponentTokens,
   DesignTheme,
   File,
   ProjectMetadata,
@@ -19,7 +20,10 @@ import {
   PrototypeLinks,
   PrototypeState,
   PrototypeV2Spec,
+  Question,
+  QuestionsAsked,
   ScreenMetadata,
+  SessionEvent,
   SessionOutputComponent,
   VariantOptions,
   SelectedScreenInstance,
@@ -28,9 +32,9 @@ import {
  * AUTO-GENERATED by scripts/generate-sdk.ts
 DO NOT EDIT — changes will be overwritten.
 
-Source: tools-manifest.json (sha256:2f1a623ec115...)
-        domain-map.json     (sha256:0ee09d686be6...)
-Generated: 2026-06-01T03:47:10.743Z
+Source: tools-manifest.json (sha256:d831990b27e9...)
+        domain-map.json     (sha256:715639788724...)
+Generated: 2026-06-01T04:11:36.685Z
  */
 
 /** Response message for create_project. */
@@ -140,6 +144,31 @@ export interface GenerateVariantsResponse {
   sessionId?: string;
 }
 
+/** Response message for upload_design_md. */
+export interface UploadDesignMdResponse {
+  groupId?: string;
+  groupName?: string;
+  height?: number;
+  hidden?: boolean;
+  id?: string;
+  isFavourite?: boolean;
+  isResized?: boolean;
+  label?: string;
+  sourceAsset?: string;
+  sourceScreen?: string;
+  textContent?: string;
+  type?:
+    | "SCREEN_INSTANCE_TYPE_UNSPECIFIED"
+    | "SCREEN_INSTANCE"
+    | "DESIGN_SYSTEM_INSTANCE"
+    | "GROUP_INSTANCE"
+    | "TEXT_INSTANCE";
+  variantScreenInstance?: ScreenInstance;
+  width?: number;
+  x?: number;
+  y?: number;
+}
+
 /** Response message for create_design_system. */
 export interface CreateDesignSystemResponse {
   copiedFrom?: string;
@@ -148,6 +177,11 @@ export interface CreateDesignSystemResponse {
   version?: string;
 }
 
+/** Response message for create_design_system_from_design_md. */
+export interface CreateDesignSystemFromDesignMdResponse {
+  assetId?: string;
+}
+
 /** Response message for update_design_system. */
 export interface UpdateDesignSystemResponse {
   copiedFrom?: string;

packages/sdk/generated/src/screen.ts

@@ -2,13 +2,14 @@
  * AUTO-GENERATED by scripts/generate-sdk.ts
 DO NOT EDIT — changes will be overwritten.
 
-Source: tools-manifest.json (sha256:2f1a623ec115...)
-        domain-map.json     (sha256:0ee09d686be6...)
-Generated: 2026-06-01T03:47:10.743Z
+Source: tools-manifest.json (sha256:d831990b27e9...)
+        domain-map.json     (sha256:715639788724...)
+Generated: 2026-06-01T04:11:36.685Z
  */
 import { type StitchToolClient } from "../../src/client.js";
 import { StitchError } from "../../src/spec/errors.js";
 import {
+  ComponentTokens,
   DesignTheme,
   File,
   ProjectMetadata,
@@ -29,7 +30,10 @@ import {
   PrototypeLinks,
   PrototypeState,
   PrototypeV2Spec,
+  Question,
+  QuestionsAsked,
   ScreenMetadata,
+  SessionEvent,
   SessionOutputComponent,
   VariantOptions,
   SelectedScreenInstance,

packages/sdk/generated/src/stitch.ts

@@ -2,13 +2,14 @@
  * AUTO-GENERATED by scripts/generate-sdk.ts
 DO NOT EDIT — changes will be overwritten.
 
-Source: tools-manifest.json (sha256:2f1a623ec115...)
-        domain-map.json     (sha256:0ee09d686be6...)
-Generated: 2026-06-01T03:47:10.743Z
+Source: tools-manifest.json (sha256:d831990b27e9...)
+        domain-map.json     (sha256:715639788724...)
+Generated: 2026-06-01T04:11:36.685Z
  */
 import { type StitchToolClient } from "../../src/client.js";
 import { StitchError } from "../../src/spec/errors.js";
 import {
+  ComponentTokens,
   DesignTheme,
   File,
   ProjectMetadata,
@@ -29,7 +30,10 @@ import {
   PrototypeLinks,
   PrototypeState,
   PrototypeV2Spec,
+  Question,
+  QuestionsAsked,
   ScreenMetadata,
+  SessionEvent,
   SessionOutputComponent,
   VariantOptions,
   SelectedScreenInstance,