@google/stitch-sdk 0.0.1

package/README.md

@@ -0,0 +1,271 @@
+# @google/stitch-sdk
+
+Generate UI screens from text prompts and extract their HTML and screenshots programmatically.
+
+## Quick Start
+
+Set your API key and generate a screen:
+
+```ts
+import { stitch } from "@google/stitch-sdk";
+
+// STITCH_API_KEY must be set in the environment
+const project = await stitch.createProject("My App");
+const screen = await project.generate("A login page with email and password fields");
+const html = await screen.getHtml();
+const imageUrl = await screen.getImage();
+```
+
+`html` is a download URL for the screen's HTML. `imageUrl` is a download URL for the screenshot.
+
+## Install
+
+```bash
+npm install @google/stitch-sdk
+```
+
+To use `stitchTools()` with the [Vercel AI SDK](https://sdk.vercel.ai/), install `ai` as well:
+
+```bash
+npm install @google/stitch-sdk ai
+```
+
+## Working with Projects and Screens
+
+### List existing projects
+
+```ts
+import { stitch } from "@google/stitch-sdk";
+
+const projects = await stitch.projects();
+for (const project of projects) {
+  console.log(project.id, project.projectId);
+  const screens = await project.screens();
+  console.log(`  ${screens.length} screens`);
+}
+```
+
+### Reference a project by ID
+
+If you already have a project ID, reference it directly:
+
+```ts
+const project = stitch.project("4044680601076201931");
+// Call methods on it — each method fetches data as needed
+const screens = await project.screens();
+```
+
+### Edit a screen
+
+```ts
+const screen = await project.generate("A dashboard with charts");
+const edited = await screen.edit("Make the background dark and add a sidebar");
+const editedHtml = await edited.getHtml();
+```
+
+### Generate variants
+
+```ts
+const variants = await screen.variants("Try different color schemes", {
+  variantCount: 3,
+  creativeRange: "EXPLORE",
+  aspects: ["COLOR_SCHEME", "LAYOUT"],
+});
+
+for (const variant of variants) {
+  console.log(variant.id, await variant.getHtml());
+}
+```
+
+`variantOptions` fields:
+
+| Field | Type | Default | Description |
+|---|---|---|---|
+| `variantCount` | `number` | 3 | Number of variants (1–5) |
+| `creativeRange` | `string` | `"EXPLORE"` | `"REFINE"`, `"EXPLORE"`, or `"REIMAGINE"` |
+| `aspects` | `string[]` | all | `"LAYOUT"`, `"COLOR_SCHEME"`, `"IMAGES"`, `"TEXT_FONT"`, `"TEXT_CONTENT"` |
+
+## Tool Client (Agent Usage)
+
+For agents and orchestration scripts that need direct MCP tool access:
+
+```ts
+import { StitchToolClient } from "@google/stitch-sdk";
+
+const client = new StitchToolClient({ apiKey: "your-api-key" });
+
+// List available tools
+const { tools } = await client.listTools();
+for (const tool of tools) {
+  console.log(tool.name, tool.description);
+}
+
+// Call a tool directly
+const result = await client.callTool("create_project", {
+  title: "Agent Project",
+});
+
+await client.close();
+```
+
+The client auto-connects on the first `callTool` or `listTools` call. No explicit `connect()` needed.
+
+## API Reference
+
+### `Stitch`
+
+The root class. Manages projects.
+
+| Method | Parameters | Returns | Description |
+|---|---|---|---|
+| `createProject(title)` | `title: string` | `Promise<Project>` | Create a new project |
+| `projects()` | — | `Promise<Project[]>` | List all accessible projects |
+| `project(id)` | `id: string` | `Project` | Reference a project by ID (no API call) |
+
+### `Project`
+
+A Stitch project containing screens.
+
+| Property | Type | Description |
+|---|---|---|
+| `id` | `string` | Alias for `projectId` |
+| `projectId` | `string` | Bare project ID (no `projects/` prefix) |
+
+| Method | Parameters | Returns | Description |
+|---|---|---|---|
+| `generate(prompt, deviceType?)` | `prompt: string`, `deviceType?: DeviceType` | `Promise<Screen>` | Generate a screen from a text prompt |
+| `screens()` | — | `Promise<Screen[]>` | List all screens in the project |
+| `getScreen(screenId)` | `screenId: string` | `Promise<Screen>` | Retrieve a specific screen by ID |
+
+`DeviceType`: `"MOBILE"` \| `"DESKTOP"` \| `"TABLET"` \| `"AGNOSTIC"`
+
+### `Screen`
+
+A generated UI screen. Provides access to HTML and screenshots.
+
+| Property | Type | Description |
+|---|---|---|
+| `id` | `string` | Alias for `screenId` |
+| `screenId` | `string` | Bare screen ID |
+| `projectId` | `string` | Parent project ID |
+
+| Method | Parameters | Returns | Description |
+|---|---|---|---|
+| `edit(prompt, deviceType?, modelId?)` | `prompt: string` | `Promise<Screen>` | Edit the screen with a text prompt |
+| `variants(prompt, variantOptions, deviceType?, modelId?)` | `prompt: string`, `variantOptions: object` | `Promise<Screen[]>` | Generate design variants |
+| `getHtml()` | — | `Promise<string>` | Get the screen's HTML download URL |
+| `getImage()` | — | `Promise<string>` | Get the screen's screenshot download URL |
+
+`getHtml()` and `getImage()` use cached data from the generation response when available. If the screen was loaded from `screens()` or `getScreen()`, they call the `get_screen` API automatically.
+
+`modelId`: `"GEMINI_3_PRO"` \| `"GEMINI_3_FLASH"`
+
+### `StitchToolClient`
+
+Low-level authenticated pipe to the Stitch MCP server. Use this when you need direct tool access (e.g., in an AI agent).
+
+```ts
+const client = new StitchToolClient({ apiKey: "..." });
+const result = await client.callTool<any>("tool_name", { arg: "value" });
+await client.close();
+```
+
+| Method | Parameters | Returns | Description |
+|---|---|---|---|
+| `callTool<T>(name, args)` | `name: string`, `args: Record<string, any>` | `Promise<T>` | Call an MCP tool |
+| `listTools()` | — | `Promise<{ tools }>` | List available tools |
+| `connect()` | — | `Promise<void>` | Explicitly connect (auto-called by `callTool`) |
+| `close()` | — | `Promise<void>` | Close the connection |
+
+### `StitchProxy`
+
+An MCP proxy server that forwards requests to Stitch. Use this to expose Stitch tools through your own MCP server.
+
+```ts
+import { StitchProxy } from "@google/stitch-sdk";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+
+const proxy = new StitchProxy({ apiKey: "..." });
+const transport = new StdioServerTransport();
+await proxy.start(transport);
+```
+
+### `stitch` Singleton
+
+A pre-configured `Stitch` instance that reads `STITCH_API_KEY` from the environment. Lazily initialized on first use.
+
+```ts
+import { stitch } from "@google/stitch-sdk";
+
+// No setup needed — just use it
+const projects = await stitch.projects();
+```
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Required | Description |
+|---|---|---|
+| `STITCH_API_KEY` | Yes (or use OAuth) | API key for authentication |
+| `STITCH_ACCESS_TOKEN` | No | OAuth access token (alternative to API key) |
+| `GOOGLE_CLOUD_PROJECT` | With OAuth | Google Cloud project ID |
+| `STITCH_HOST` | No | Override the MCP server URL |
+
+### Explicit Configuration
+
+```ts
+import { Stitch, StitchToolClient } from "@google/stitch-sdk";
+
+const client = new StitchToolClient({
+  apiKey: "your-api-key",
+  baseUrl: "https://stitch.googleapis.com/mcp",
+  timeout: 300_000,
+});
+
+const sdk = new Stitch(client);
+const projects = await sdk.projects();
+```
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `apiKey` | `string` | `STITCH_API_KEY` | API key |
+| `accessToken` | `string` | `STITCH_ACCESS_TOKEN` | OAuth token |
+| `projectId` | `string` | `GOOGLE_CLOUD_PROJECT` | Cloud project ID |
+| `baseUrl` | `string` | `https://stitch.googleapis.com/mcp` | MCP server URL |
+| `timeout` | `number` | `300000` | Request timeout (ms) |
+
+Authentication requires either `apiKey` or both `accessToken` and `projectId`.
+
+## Error Handling
+
+All domain class methods throw `StitchError` on failure:
+
+```ts
+import { stitch, StitchError } from "@google/stitch-sdk";
+
+try {
+  const project = stitch.project("bad-id");
+  await project.screens();
+} catch (error) {
+  if (error instanceof StitchError) {
+    console.error(error.code);        // "UNKNOWN_ERROR"
+    console.error(error.message);     // Human-readable description
+    console.error(error.recoverable); // false
+  }
+}
+```
+
+Error codes: `AUTH_FAILED`, `NOT_FOUND`, `PERMISSION_DENIED`, `RATE_LIMITED`, `NETWORK_ERROR`, `VALIDATION_ERROR`, `UNKNOWN_ERROR`.
+
+---
+
+## Disclaimer
+
+This is not an officially supported Google product. This project is not
+eligible for the [Google Open Source Software Vulnerability Rewards
+Program](https://bughunters.google.com/open-source-security).
+
+## License
+
+Apache 2.0 — see [LICENSE](LICENSE) for details.

package/dist/generated/src/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * AUTO-GENERATED by scripts/generate-sdk.ts
+DO NOT EDIT — changes will be overwritten.
+
+Source: tools-manifest.json (sha256:1f84b31604f9...)
+        domain-map.json     (sha256:49ed76857ca3...)
+Generated: 2026-03-12T15:11:01.420Z
+ */
+export { Stitch } from "./stitch.js";
+export { Project } from "./project.js";
+export { Screen } from "./screen.js";
+export { toolDefinitions, type ToolDefinition } from "./tool-definitions.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/generated/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../generated/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/generated/src/index.js

@@ -0,0 +1,13 @@
+/**
+ * AUTO-GENERATED by scripts/generate-sdk.ts
+DO NOT EDIT — changes will be overwritten.
+
+Source: tools-manifest.json (sha256:1f84b31604f9...)
+        domain-map.json     (sha256:49ed76857ca3...)
+Generated: 2026-03-12T15:11:01.420Z
+ */
+export { Stitch } from "./stitch.js";
+export { Project } from "./project.js";
+export { Screen } from "./screen.js";
+export { toolDefinitions } from "./tool-definitions.js";
+//# sourceMappingURL=index.js.map

package/dist/generated/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../generated/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,eAAe,EAAuB,MAAM,uBAAuB,CAAC"}

package/dist/generated/src/project.d.ts

@@ -0,0 +1,35 @@
+/**
+ * AUTO-GENERATED by scripts/generate-sdk.ts
+DO NOT EDIT — changes will be overwritten.
+
+Source: tools-manifest.json (sha256:1f84b31604f9...)
+        domain-map.json     (sha256:49ed76857ca3...)
+Generated: 2026-03-12T15:11:01.420Z
+ */
+import { type StitchToolClient } from "../../src/client.js";
+import { Screen } from "./screen.js";
+/** A Stitch project containing screens. */
+export declare class Project {
+    private client;
+    readonly projectId: string;
+    data: any;
+    constructor(client: StitchToolClient, data: any);
+    /** Convenience alias for projectId */
+    get id(): string;
+    /**
+     * Generates a new screen within a project from a text prompt.
+     * Tool: generate_screen_from_text
+     */
+    generate(prompt: string, deviceType?: "DEVICE_TYPE_UNSPECIFIED" | "MOBILE" | "DESKTOP" | "TABLET" | "AGNOSTIC", modelId?: "MODEL_ID_UNSPECIFIED" | "GEMINI_3_PRO" | "GEMINI_3_FLASH"): Promise<Screen>;
+    /**
+     * Lists all screens within a given Stitch project.
+     * Tool: list_screens
+     */
+    screens(): Promise<Screen[]>;
+    /**
+     * Retrieves the details of a specific screen within a project.
+     * Tool: get_screen
+     */
+    getScreen(screenId: string): Promise<Screen>;
+}
+//# sourceMappingURL=project.d.ts.map

package/dist/generated/src/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../generated/src/project.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,2CAA2C;AAC3C,qBAAa,OAAO;IAIJ,OAAO,CAAC,MAAM;IAH1B,SAAgB,SAAS,EAAE,MAAM,CAAC;IAC3B,IAAI,EAAE,GAAG,CAAC;gBAEG,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,GAAG;IAUvD,sCAAsC;IACtC,IAAI,EAAE,IAAI,MAAM,CAEf;IAED;;;OAGG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,yBAAyB,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,cAAc,GAAG,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAS5M;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IASlC;;;OAGG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAQrD"}

package/dist/generated/src/project.js

@@ -0,0 +1,62 @@
+import { StitchError } from "../../src/spec/errors.js";
+import { Screen } from "./screen.js";
+/** A Stitch project containing screens. */
+export class Project {
+    client;
+    projectId;
+    data;
+    constructor(client, data) {
+        this.client = client;
+        {
+            let _v = typeof data === "string" ? data : data.name;
+            if (typeof _v === "string" && _v.startsWith("projects/"))
+                _v = _v.slice(9);
+            this.projectId = _v;
+        }
+        this.data = typeof data === "object" ? data : undefined;
+    }
+    /** Convenience alias for projectId */
+    get id() {
+        return this.projectId;
+    }
+    /**
+     * Generates a new screen within a project from a text prompt.
+     * Tool: generate_screen_from_text
+     */
+    async generate(prompt, deviceType, modelId) {
+        try {
+            const raw = await this.client.callTool("generate_screen_from_text", { projectId: this.projectId, prompt, deviceType, modelId });
+            return new Screen(this.client, { ...raw.outputComponents[0].design.screens[0], projectId: this.projectId });
+        }
+        catch (error) {
+            throw StitchError.fromUnknown(error);
+        }
+    }
+    /**
+     * Lists all screens within a given Stitch project.
+     * Tool: list_screens
+     */
+    async screens() {
+        try {
+            const raw = await this.client.callTool("list_screens", { projectId: this.projectId });
+            return (raw.screens || []).map((item) => new Screen(this.client, { ...item, projectId: this.projectId }));
+        }
+        catch (error) {
+            throw StitchError.fromUnknown(error);
+        }
+    }
+    /**
+     * Retrieves the details of a specific screen within a project.
+     * Tool: get_screen
+     */
+    async getScreen(screenId) {
+        try {
+            const raw = await this.client.callTool("get_screen", { projectId: this.projectId, screenId, name: `projects/${this.projectId}/screens/${screenId}` });
+            return new Screen(this.client, { ...raw, projectId: this.projectId });
+        }
+        catch (error) {
+            throw StitchError.fromUnknown(error);
+        }
+    }
+}
+//# sourceMappingURL=project.js.map

package/dist/generated/src/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../../generated/src/project.ts"],"names":[],"mappings":"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"}

package/dist/generated/src/screen.d.ts

@@ -0,0 +1,40 @@
+/**
+ * AUTO-GENERATED by scripts/generate-sdk.ts
+DO NOT EDIT — changes will be overwritten.
+
+Source: tools-manifest.json (sha256:1f84b31604f9...)
+        domain-map.json     (sha256:49ed76857ca3...)
+Generated: 2026-03-12T15:11:01.420Z
+ */
+import { type StitchToolClient } from "../../src/client.js";
+/** A generated UI screen. Provides access to HTML and screenshots. */
+export declare class Screen {
+    private client;
+    readonly projectId: string;
+    readonly screenId: string;
+    data: any;
+    constructor(client: StitchToolClient, data: any);
+    /** Convenience alias for screenId */
+    get id(): string;
+    /**
+     * Edits existing screens within a project using a text prompt.
+     * Tool: edit_screens
+     */
+    edit(prompt: string, deviceType?: "DEVICE_TYPE_UNSPECIFIED" | "MOBILE" | "DESKTOP" | "TABLET" | "AGNOSTIC", modelId?: "MODEL_ID_UNSPECIFIED" | "GEMINI_3_PRO" | "GEMINI_3_FLASH"): Promise<Screen>;
+    /**
+     * Generates variants of existing screens within a project using a text prompt.
+     * Tool: generate_variants
+     */
+    variants(prompt: string, variantOptions: any, deviceType?: "DEVICE_TYPE_UNSPECIFIED" | "MOBILE" | "DESKTOP" | "TABLET" | "AGNOSTIC", modelId?: "MODEL_ID_UNSPECIFIED" | "GEMINI_3_PRO" | "GEMINI_3_FLASH"): Promise<Screen[]>;
+    /**
+     * Retrieves the details of a specific screen within a project.
+     * Tool: get_screen
+     */
+    getHtml(): Promise<string>;
+    /**
+     * Retrieves the details of a specific screen within a project.
+     * Tool: get_screen
+     */
+    getImage(): Promise<string>;
+}
+//# sourceMappingURL=screen.d.ts.map

package/dist/generated/src/screen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen.d.ts","sourceRoot":"","sources":["../../../generated/src/screen.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,sEAAsE;AACtE,qBAAa,MAAM;IAKH,OAAO,CAAC,MAAM;IAJ1B,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,GAAG,CAAC;gBAEG,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,GAAG;IAWvD,qCAAqC;IACrC,IAAI,EAAE,IAAI,MAAM,CAEf;IAED;;;OAGG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,yBAAyB,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,cAAc,GAAG,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IASxM;;;OAGG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,UAAU,CAAC,EAAE,yBAAyB,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,cAAc,GAAG,gBAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IASnO;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAYhC;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;CAWpC"}

package/dist/generated/src/screen.js

@@ -0,0 +1,82 @@
+import { StitchError } from "../../src/spec/errors.js";
+/** A generated UI screen. Provides access to HTML and screenshots. */
+export class Screen {
+    client;
+    projectId;
+    screenId;
+    data;
+    constructor(client, data) {
+        this.client = client;
+        this.projectId = typeof data === "string" ? data : data.projectId;
+        this.screenId = typeof data === "string" ? data : data.id;
+        if (!this.screenId && typeof data === "object" && data.name) {
+            const parts = data.name.split("/screens/");
+            if (parts.length === 2)
+                this.screenId = parts[1];
+        }
+        this.data = typeof data === "object" ? data : undefined;
+    }
+    /** Convenience alias for screenId */
+    get id() {
+        return this.screenId;
+    }
+    /**
+     * Edits existing screens within a project using a text prompt.
+     * Tool: edit_screens
+     */
+    async edit(prompt, deviceType, modelId) {
+        try {
+            const raw = await this.client.callTool("edit_screens", { projectId: this.projectId, selectedScreenIds: [this.screenId], prompt, deviceType, modelId });
+            return new Screen(this.client, { ...raw.outputComponents[0].design.screens[0], projectId: this.projectId });
+        }
+        catch (error) {
+            throw StitchError.fromUnknown(error);
+        }
+    }
+    /**
+     * Generates variants of existing screens within a project using a text prompt.
+     * Tool: generate_variants
+     */
+    async variants(prompt, variantOptions, deviceType, modelId) {
+        try {
+            const raw = await this.client.callTool("generate_variants", { projectId: this.projectId, selectedScreenIds: [this.screenId], prompt, variantOptions, deviceType, modelId });
+            return ((raw.outputComponents || []).flatMap((a) => a?.design?.screens || []) || []).map((item) => new Screen(this.client, { ...item, projectId: this.projectId }));
+        }
+        catch (error) {
+            throw StitchError.fromUnknown(error);
+        }
+    }
+    /**
+     * Retrieves the details of a specific screen within a project.
+     * Tool: get_screen
+     */
+    async getHtml() {
+        // Use cached HTML download URL from generation response if available
+        if (this.data?.htmlCode?.downloadUrl)
+            return this.data?.htmlCode?.downloadUrl;
+        try {
+            const raw = await this.client.callTool("get_screen", { projectId: this.projectId, screenId: this.screenId, name: `projects/${this.projectId}/screens/${this.screenId}` });
+            return raw.htmlCode.downloadUrl || "";
+        }
+        catch (error) {
+            throw StitchError.fromUnknown(error);
+        }
+    }
+    /**
+     * Retrieves the details of a specific screen within a project.
+     * Tool: get_screen
+     */
+    async getImage() {
+        // Use cached screenshot URL from generation response
+        if (this.data?.screenshot?.downloadUrl)
+            return this.data?.screenshot?.downloadUrl;
+        try {
+            const raw = await this.client.callTool("get_screen", { projectId: this.projectId, screenId: this.screenId, name: `projects/${this.projectId}/screens/${this.screenId}` });
+            return raw.screenshot.downloadUrl || "";
+        }
+        catch (error) {
+            throw StitchError.fromUnknown(error);
+        }
+    }
+}
+//# sourceMappingURL=screen.js.map

package/dist/generated/src/screen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen.js","sourceRoot":"","sources":["../../../generated/src/screen.ts"],"names":[],"mappings":"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"}

package/dist/generated/src/stitch.d.ts

@@ -0,0 +1,23 @@
+/**
+ * AUTO-GENERATED by scripts/generate-sdk.ts
+DO NOT EDIT — changes will be overwritten.
+
+Source: tools-manifest.json (sha256:1f84b31604f9...)
+        domain-map.json     (sha256:49ed76857ca3...)
+Generated: 2026-03-12T15:11:01.420Z
+ */
+import { type StitchToolClient } from "../../src/client.js";
+import { Project } from "./project.js";
+/** Main entry point. Manages projects. */
+export declare class Stitch {
+    private client;
+    constructor(client: StitchToolClient);
+    /**
+     * Lists all Stitch projects accessible to the user. By default, it lists projects owned by the user.
+     * Tool: list_projects
+     */
+    projects(): Promise<Project[]>;
+    /** Create a Project handle from an existing ID without an API call. */
+    project(id: string): Project;
+}
+//# sourceMappingURL=stitch.d.ts.map

package/dist/generated/src/stitch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stitch.d.ts","sourceRoot":"","sources":["../../../generated/src/stitch.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,0CAA0C;AAC1C,qBAAa,MAAM;IACH,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,gBAAgB;IAG5C;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IASpC,uEAAuE;IACvE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAG/B"}

package/dist/generated/src/stitch.js

@@ -0,0 +1,27 @@
+import { StitchError } from "../../src/spec/errors.js";
+import { Project } from "./project.js";
+/** Main entry point. Manages projects. */
+export class Stitch {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Lists all Stitch projects accessible to the user. By default, it lists projects owned by the user.
+     * Tool: list_projects
+     */
+    async projects() {
+        try {
+            const raw = await this.client.callTool("list_projects", {});
+            return (raw.projects || []).map((item) => new Project(this.client, item));
+        }
+        catch (error) {
+            throw StitchError.fromUnknown(error);
+        }
+    }
+    /** Create a Project handle from an existing ID without an API call. */
+    project(id) {
+        return new Project(this.client, id);
+    }
+}
+//# sourceMappingURL=stitch.js.map

package/dist/generated/src/stitch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stitch.js","sourceRoot":"","sources":["../../../generated/src/stitch.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,0CAA0C;AAC1C,MAAM,OAAO,MAAM;IACK;IAApB,YAAoB,MAAwB;QAAxB,WAAM,GAAN,MAAM,CAAkB;IAC5C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ;QACV,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAM,eAAe,EAAE,EAAI,CAAC,CAAC;YACnE,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;QACjF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,WAAW,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACvC,CAAC;IACL,CAAC;IAED,uEAAuE;IACvE,OAAO,CAAC,EAAU;QACd,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC;CACJ"}

package/dist/generated/src/tool-definitions.d.ts

@@ -0,0 +1,20 @@
+/**
+ * AUTO-GENERATED by scripts/generate-sdk.ts
+DO NOT EDIT — changes will be overwritten.
+
+Source: tools-manifest.json (sha256:1f84b31604f9...)
+        domain-map.json     (sha256:49ed76857ca3...)
+Generated: 2026-03-12T15:11:01.420Z
+ */
+/** Static tool definition from the Stitch MCP server manifest. */
+export interface ToolDefinition {
+    /** MCP tool name, e.g. "create_project" */
+    name: string;
+    /** Human-readable description of what the tool does */
+    description: string;
+    /** JSON Schema for the tool's input parameters */
+    inputSchema: Record<string, unknown>;
+}
+/** All tools available on the Stitch MCP server, generated from tools-manifest.json. */
+export declare const toolDefinitions: ToolDefinition[];
+//# sourceMappingURL=tool-definitions.d.ts.map

package/dist/generated/src/tool-definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-definitions.d.ts","sourceRoot":"","sources":["../../../generated/src/tool-definitions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC3B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,wFAAwF;AACxF,eAAO,MAAM,eAAe,EAAE,cAAc,EA0U3C,CAAC"}