@czi-sds/mcp 0.2.0 → 0.2.2

package/README.md

@@ -1,34 +1,439 @@
 # SDS MCP Server
 
-An MCP server providing AI assistants with access to SDS components,
-examples, design tokens and migration patterns.
+Welcome to the Science Design System (SDS) MCP Server! This guide will help you understand the architecture, create new tools, test your changes, and publish the server.
 
-## Features
+## Table of Contents
 
-- **Component Library**: Get components, props, and usage examples
-- **Migration Support**: Upgrade guidance with before/after code
-  snippets
-- **Design Tokens**: Access semantic tokens and font styles for consistent
-  theming
+- [Architecture Overview](#architecture-overview)
+- [Setting Up Development Environment](#setting-up-development-environment)
+- [Creating a New Tool](#creating-a-new-tool)
+- [Testing Your Changes](#testing-your-changes)
+- [Publishing to NPM](#publishing-to-npm)
+- [Real-World Testing](#real-world-testing)
+- [Best Practices](#best-practices)
 
-## Available Tools
+## Architecture Overview
 
-- `get_components` - List all Chakra UI components
-- `get_component_props` - Get component properties and configuration
-- `get_component_example` - Retrieve usage examples and code patterns
-- `get_theme` - Get theme tokens, semantic tokens, text styles and layer styles
+### Project Structure
 
-## Setup
+```
+packages/mcp/
+├── src/
+│   ├── tools/              # Tool implementations
+│   │   ├── index.ts        # Tool registry and initialization
+│   │   └── *.ts            # Individual tool files
+│   ├── lib/
+│   │   ├── types.ts        # TypeScript type definitions
+│   │   └── fetch.ts        # Data fetching utilities
+│   ├── server.ts           # Core MCP server setup
+│   ├── stdio.ts            # STDIO transport implementation
+│   └── http.ts             # HTTP transport implementation
+├── data/                   # Static data files
+│   ├── component-list.json
+│   ├── component-props/
+│   ├── component-props-storybook/
+│   └── tailwind.json
+├── scripts/                # Build and generation scripts
+│   ├── generate-*.ts       # Data generation scripts
+│   └── inspect.js          # Inspector helper
+└── dist/                   # Built output
+```
+
+### Core Concepts
+
+#### 1. **MCP Server**
+
+The Model Context Protocol (MCP) server provides tools to AI assistants for interacting with the SDS component library. It supports two transport methods:
+
+- **STDIO**: For local CLI usage (primary method)
+- **HTTP**: For web-based integrations
+
+#### 2. **Tools**
+
+Tools are functions that AI assistants can call to retrieve information or perform actions. Each tool:
+
+- Has a unique name and description
+- Defines input parameters using Zod schemas
+- Returns structured data to the assistant
+- Can have initialization context (`ctx`)
+
+#### 3. **Data Layer**
+
+The `data/` directory contains pre-generated JSON files with component information:
+
+- Component lists and properties
+- Storybook metadata
+- Design tokens (Tailwind config)
+
+## Setting Up Development Environment
+
+### Prerequisites
+
+1. Clone the repository:
+
+```bash
+git clone https://github.com/chanzuckerberg/sci-components.git
+cd sci-components
+```
+
+2. Install/Use the correct NodeJs version
+
+```bash
+nvm use
+```
+
+3. Install dependencies:
+
+```bash
+yarn install
+```
+
+4. Build packages (required for data generation):
+
+```bash
+yarn build
+```
+
+5. Navigate to the MCP package:
+
+```bash
+cd packages/mcp
+```
+
+## Creating a New Tool
+
+### Step 1: Create the Tool File
+
+Create a new file in `src/tools/` (e.g., `src/tools/my-new-tool.ts`):
+
+```typescript
+import { z } from "zod";
+import { type Tool } from "../lib/types.js";
+
+// Define the tool's context type (optional)
+type MyToolContext = {
+  // Any data needed during initialization
+  availableOptions?: string[];
+};
+
+export const myNewTool: Tool<MyToolContext> = {
+  name: "my_new_tool",
+  description: "Brief description of what this tool does for AI assistants",
+
+  // Optional: Initialize context data
+  async ctx() {
+    // Load any necessary data at startup
+    const availableOptions = await loadOptions();
+    return { availableOptions };
+  },
+
+  // Optional: Conditionally disable the tool
+  disabled(config) {
+    return config.someFeatureFlag === false;
+  },
+
+  // Register and implement the tool
+  exec(server, { ctx, name, description }) {
+    server.tool(
+      name,
+      description,
+      {
+        // Define input parameters using Zod
+        param1: z.string().describe("Description of param1"),
+        param2: z
+          .enum(["option1", "option2"])
+          .optional()
+          .describe("Optional parameter with enum values"),
+      },
+      async ({ param1, param2 }) => {
+        try {
+          // Tool implementation
+          const result = await processData(param1, param2);
+
+          return {
+            content: [
+              {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+              },
+            ],
+          };
+        } catch (error) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Error: ${error instanceof Error ? error.message : "Unknown error"}`,
+              },
+            ],
+          };
+        }
+      }
+    );
+  },
+};
+```
+
+### Step 2: Register the Tool
+
+Add your tool to `src/tools/index.ts`:
+
+```typescript
+import { myNewTool } from "./my-new-tool.ts";
+
+const tools: Tool[] = [
+  getComponentPropsTool,
+  getComponentPropsStorybookTool,
+  listComponentsTool,
+  getTailwindTokensTool,
+  myNewTool, // Add your tool here
+];
+```
+
+### Step 3: Add TypeScript Types (if needed)
+
+If your tool requires custom types, add them to `src/lib/types.ts`:
+
+```typescript
+export interface MyToolData {
+  // Define your data structure
+}
+```
+
+### Step 4: Add Data Generation Script (if needed)
+
+If your tool requires pre-generated data, create a script in `scripts/`:
+
+```typescript
+// scripts/generate-my-data.ts
+import { writeFileSync } from "fs";
+import { join } from "path";
+
+async function generateMyData() {
+  const data = await collectData();
+
+  const outputPath = join(process.cwd(), "data", "my-data.json");
+  writeFileSync(outputPath, JSON.stringify(data, null, 2));
+
+  console.log("✓ Generated my-data.json");
+}
+
+generateMyData().catch(console.error);
+```
+
+Add the script to `package.json`:
+
+```json
+{
+  "scripts": {
+    "generate:my-data": "tsx scripts/generate-my-data.ts",
+    "generate:all": "... && yarn generate:my-data"
+  }
+}
+```
+
+## Testing Your Changes
+
+### Using the MCP Inspector
+
+The MCP Inspector provides an interactive UI for testing your tools:
+
+1. **Start the inspector from monorepo root with your local server:**
+
+```bash
+yarn mcp:inspect:dev
+```
+
+You can also navigate to the MCP package directory first and then run the commands directly from there:
+
+```bash
+cd packages/mcp
+yarn inspect:dev
+```
+
+This will open a web interface where you can:
+
+- See all available tools
+- Test tool invocations with different parameters
+- View responses in real-time
+- Debug any issues
+
+2. **Test your specific tool:**
 
-### Claude Desktop / Cursor
+- Click "Connect" in the left sidebar to connect to the MCP server.
+- Click "List Tools" to view all available tools.
+- Fill in the required parameters.
+- Click "Run Tool" to execute it and view the response.
+- Verify both the output format and the content.
+
+### Manual Testing with the Built Server
+
+1. **Build the server:**
+
+```bash
+cd packages/mcp
+yarn build
+```
+
+2. **Run the inspector with the built version:**
+
+```bash
+cd packages/mcp
+yarn inspect
+```
+
+## Publishing to NPM
+
+### Pre-publish Checklist
+
+Navigate to the MCP package directory first and then run the following commands:
+
+1. **Ensure all data is generated:**
+
+```bash
+yarn generate:all
+```
+
+2. **Build the package:**
+
+```bash
+yarn build
+```
+
+3. **Test the built package:**
+
+```bash
+yarn inspect
+```
+
+### Publishing Process
+
+The SDS monorepo uses Lerna for publishing. From the repository root:
+
+1. **Commit all changes:**
+
+```bash
+git add .
+git commit
+```
+
+2. **Push to main branch** (after PR approval):
+
+```bash
+git push origin main
+```
+
+3. **Publish via CI/CD:**
+   The automated workflow handles publishing when changes are pushed to the `prod` branch:
+
+```bash
+# Sync prod with main
+git checkout prod
+git pull origin main
+git push origin prod
+```
+
+## Real-World Testing
+
+### Testing in Claude Desktop
+
+1. **Configure Claude Desktop:**
+
+Add to your Claude Desktop configuration file:
+
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+For local MCP testing, make sure the path to your sci-components project matches your setup.
+
+```json
+{
+  "mcpServers": {
+    "sds-mcp": {
+      "command": "node",
+      "args": ["/sci-components/packages/mcp/dist/stdio.js"]
+    }
+  }
+}
+```
+
+To test the published version simply use npx to run the mcp server package:
 
 ```json
 {
   "mcpServers": {
     "sds-mcp": {
+      "type": "stdio",
       "command": "npx",
       "args": ["-y", "@czi-sds/mcp"]
     }
   }
 }
 ```
+
+3. **Restart Claude Desktop** and test your tool in conversations
+
+### Testing in Other MCP Clients
+
+The server can be integrated with any MCP-compatible client:
+
+1. **Via NPX (without installation):**
+
+```json
+{
+  "mcpServers": {
+    "sds-mcp": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@czi-sds/mcp"]
+    }
+  }
+}
+```
+
+## Best Practices
+
+### Tool Design
+
+1. **Clear Naming**: Use descriptive, snake_case names (e.g., `get_component_props`)
+2. **Comprehensive Descriptions**: Help AI assistants understand when to use your tool
+3. **Error Handling**: Always wrap async operations in try-catch blocks
+4. **Structured Output**: Return consistent JSON structures
+5. **Parameter Validation**: Use Zod schemas to validate inputs
+
+### Performance
+
+1. **Lazy Loading**: Load data only when needed using the `ctx()` function
+2. **Caching**: Cache expensive operations in the tool context
+3. **Data Size**: Keep responses under reasonable size limits
+4. **Async Operations**: Use async/await for all I/O operations
+
+## Common Issues and Solutions
+
+### Issue: Tool not appearing in inspector
+
+**Solution**: Ensure the tool is properly registered in `src/tools/index.ts` and rebuild
+
+### Issue: Data files not found
+
+**Solution**: Run `yarn generate:all` before building
+
+### Issue: Permission denied when running built script
+
+**Solution**: Run `chmod +x dist/stdio.js` after building
+
+## Getting Help
+
+- **GitHub Issues**: [Report bugs or request features](https://github.com/chanzuckerberg/sci-components/issues)
+- **Design System Docs**: [sds.czi.design](https://sds.czi.design)
+- **MCP Documentation**: [Model Context Protocol](https://modelcontextprotocol.io)
+
+## Contributing Guidelines
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/new-tool`)
+3. Make your changes
+4. Write/update tests if applicable
+5. Submit a pull request
+
+Thank you for contributing to the SDS MCP Server!

package/dist/stdio.js

@@ -3,9 +3,8 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
 import fs from 'fs';
-import path, { join } from 'path';
+import path from 'path';
 import { fileURLToPath } from 'url';
-import { readFile } from 'fs/promises';
 
 var server = new McpServer({
   name: "sds-mcp",
@@ -124,6 +123,37 @@ async function fetchComponentPropsStorybook(component) {
     );
   }
 }
+async function fetchTailwindTokens() {
+  try {
+    const possiblePaths = [
+      path.join(dirname, "../../data/tailwind.json"),
+      // From src/lib in dev
+      path.join(dirname, "../data/tailwind.json"),
+      // From dist in prod
+      path.join(process.cwd(), "data/tailwind.json")
+      // From current working directory
+    ];
+    let dataPath = "";
+    for (const p of possiblePaths) {
+      if (fs.existsSync(p)) {
+        dataPath = p;
+        break;
+      }
+    }
+    if (!dataPath) {
+      throw new Error(
+        "Component list not found in any expected location. Please run 'yarn generate:tailwind-tokens' first."
+      );
+    }
+    const fileContent = fs.readFileSync(dataPath, "utf-8");
+    const tailwindTokens = JSON.parse(fileContent);
+    return tailwindTokens;
+  } catch (error) {
+    throw new Error(
+      `Failed to load tailwind tokens: ${error instanceof Error ? error.message : `Unknown error ${error}`}`
+    );
+  }
+}
 
 // src/tools/get-component-props.ts
 var getComponentPropsTool = {
@@ -254,13 +284,293 @@ var getComponentPropsStorybookTool = {
     );
   }
 };
+
+// src/lib/tailwind-guidance.ts
+var TAILWIND_TOKEN_GUIDANCE = {
+  colors: {
+    category: "Colors",
+    description: "Theme-aware color tokens with light/dark mode support. Both light and dark mode colors are using the same token name. Use the dark:color-token-name to use the dark mode color.",
+    prefixes: [
+      "bg-",
+      "border-",
+      "divide-",
+      "outline-",
+      "ring-",
+      "ring-offset-",
+      "text-",
+      "placeholder-",
+      "caret-",
+      "decoration-",
+      "accent-",
+      "shadow-",
+      "fill-",
+      "stroke-",
+      "from-",
+      "via-",
+      "to-"
+    ],
+    examples: [
+      {
+        description: "Basic text and background colors",
+        code: `<div className="bg-sds-color-semantic-base-background-primary dark:bg-sds-color-semantic-base-background-primary text-sds-color-semantic-base-text-primary dark:text-sds-color-semantic-base-text-primary">
+  Content with semantic colors
+</div>`
+      },
+      {
+        description: "Dark mode with hover states",
+        code: `<button className="bg-sds-color-semantic-accent-fill-primary dark:bg-sds-color-semantic-accent-fill-primary
+        hover:bg-sds-color-semantic-accent-fill-hover dark:hover:bg-sds-color-semantic-accent-fill-hover">
+  Click me
+</button>`
+      },
+      {
+        description: "Border and focus states",
+        code: `<input className="
+  border-sds-color-semantic-base-border-primary
+  hover:border-sds-color-semantic-base-border-primary-hover
+  focus:border-sds-color-semantic-base-border-primary-pressed
+"/>`
+      }
+    ],
+    tips: [
+      "Always use semantic colors (e.g., 'sds-color-semantic-base-background-primary') over primitive colors when possible",
+      "Include both light and dark variants for proper theme support"
+    ]
+  },
+  typography: {
+    category: "Typography",
+    description: "Complete text styling presets including font, size, weight, and spacing",
+    prefixes: ["font-", "text-", "leading-", "tracking-"],
+    examples: [
+      {
+        description: "Typography presets (recommended). SDS typography tokens come in narrow and wide variants: use token-narrow on screens smaller than md, and token-wide on md and up.",
+        code: `<!-- Use typography tokens for complete text styling -->
+<h1 className="prose-sds-title-l-700-wide">Title</h1>     
+<h1 className="prose-sds-header-xl-600-wide">Heading</h1>
+<p className="prose-sds-body-m-500-wide">Body text</p>
+<span className="prose-sds-caps-xxs-600-wide">SMALL CAPS TEXT</span>
+<span className="prose-sds-tabular-xxs-600-wide">Tabular Numbers</span>
+<span className="prose-sds-code-s-500-wide">Code</span>
+<span className="prose-sds-link-l-500-wide">Link style</span>`
+      },
+      {
+        description: "Individual typography properties",
+        code: `<!-- Or use individual properties when needed -->
+<p className="
+  font-sds-body
+  text-sds-body-m-400-wide
+  leading-sds-body-m-400-wide
+  tracking-sds-body-m-400-wide
+">
+  Custom styled text
+</p>`
+      }
+    ],
+    tips: [
+      "Use 'narrow' variants for mobile/compact layouts",
+      "Use 'wide' variants for desktop/spacious layouts",
+      "Font weights: 400 (regular), 500 (medium), 600 (semibold), 700 (bold)"
+    ]
+  },
+  spacing: {
+    category: "Spacing",
+    description: "Consistent spacing scale for padding, margin, and gaps",
+    prefixes: [
+      "p-",
+      "px-",
+      "py-",
+      "pt-",
+      "pr-",
+      "pb-",
+      "pl-",
+      "m-",
+      "mx-",
+      "my-",
+      "mt-",
+      "mr-",
+      "mb-",
+      "ml-",
+      "gap-",
+      "gap-x-",
+      "gap-y-",
+      "space-x-",
+      "space-y-"
+    ],
+    examples: [
+      {
+        description: "Padding and margin",
+        code: `<div className="p-sds-m mx-sds-l my-sds-s">
+  Content with medium padding and different margins
+</div>`
+      },
+      {
+        description: "Flexbox and grid gaps",
+        code: `<div className="flex gap-sds-m">
+  <div>Item 1</div>
+  <div>Item 2</div>
+</div>
+
+<div className="grid grid-cols-3 gap-sds-l">
+  <div>Grid item</div>
+</div>`
+      },
+      {
+        description: "Negative margins for overlapping",
+        code: `<div className="-mt-sds-s">
+  Overlapping element
+</div>`
+      }
+    ],
+    tips: [
+      "Scale: sds-s (small), sds-default (default), sds-m (medium), sds-l (large), sds-xl (extra large)",
+      "Use consistent spacing throughout your component",
+      "Combine with responsive prefixes: sm:p-sds-m lg:p-sds-l"
+    ]
+  },
+  borderRadius: {
+    category: "Border Radius",
+    description: "Corner radius values for rounded elements",
+    prefixes: [
+      "rounded-",
+      "rounded-t-",
+      "rounded-r-",
+      "rounded-b-",
+      "rounded-l-"
+    ],
+    examples: [
+      {
+        description: "Basic rounded corners",
+        code: `<div className="rounded-sds-default">
+  Standard rounded corners
+</div>
+
+<button className="rounded-sds-m">
+  More rounded button
+</button>`
+      },
+      {
+        description: "Directional radius",
+        code: `<div className="rounded-t-sds-l rounded-b-none">
+  Only top corners rounded
+</div>`
+      }
+    ],
+    tips: [
+      "Use sds-default for most UI elements",
+      "Larger values (sds-l, sds-xl) for prominent elements",
+      "Combine with borders: border rounded-sds-m"
+    ]
+  },
+  boxShadow: {
+    category: "Box Shadow",
+    description: "Elevation shadows for depth and hierarchy",
+    prefixes: ["shadow-", "hover:shadow-", "focus:shadow-"],
+    examples: [
+      {
+        description: "Basic shadows",
+        code: `<div className="shadow-sds-s">
+  Subtle shadow
+</div>
+
+<div className="shadow-sds-m">
+  Medium elevation
+</div>`
+      },
+      {
+        description: "Interactive shadows",
+        code: `<button className="
+  shadow-sds-s
+  hover:shadow-sds-m
+  active:shadow-sds-xs
+  transition-shadow
+">
+  Interactive element
+</button>`
+      }
+    ],
+    tips: [
+      "Use smaller shadows (sds-xs, sds-s) for subtle depth",
+      "Use larger shadows (sds-l, sds-xl) for modals and popovers",
+      "Combine with hover states for interactive feedback"
+    ]
+  }
+};
+function getTokenGuidance(category) {
+  if (!category || category === "all") {
+    return `SDS Design System Tokens for Tailwind CSS
+
+The Science Design System provides a comprehensive set of design tokens that map directly to Tailwind utilities.
+
+QUICK START:
+1. Request specific categories for detailed guidance: fontFamily, fontSize, fontVariantNumeric, letterSpacing, lineHeight, textDecoration, textTransform, typography, height, width, borderRadius, boxShadow, breakpoints, colors, spacing
+2. Use semantic tokens over primitive ones when available
+3. Include responsive and theme variants for robust implementations
+4. Use the @czi-sds/components/dist/tailwind.json file to get the exact token name and value
+5. To use the typography tokens, you need to add the @tailwindcss/typography plugin to your tailwind.config.js file and then use the typography tokens in your tailwind classes like prose-[typography-token-name] for example prose-sds-body-m-400-wide.
+6. Colors have been defined in light and dark mode with the same name. Use the dark:color-token-name to use the dark mode color.
+7. Use spacing tokens like sds-m for paddings, margins, etc. for example p-sds-m for padding-medium.
+8. Use borderRadius tokens like sds-default for rounded corners for example rounded-sds-default.
+9. Use boxShadow tokens like sds-s for subtle shadows for example shadow-sds-s.
+10. Use breakpoints tokens like sds-m for medium breakpoints for example md:sds-m.
+11. Use fontFamily tokens like sds-body for body font for example font-sds-body.
+12. Use fontSize tokens like sds-body-m-400-wide for body font size for example text-sds-body-m-400-wide.
+13. Use fontVariantNumeric tokens like sds-body-m-400-wide for body font variant numeric for example font-variant-numeric-sds-body-m-400-wide.
+14. Use letterSpacing tokens like sds-body-m-400-wide for body letter spacing for example tracking-sds-body-m-400-wide.
+
+For detailed examples, request a specific category.`;
+  }
+  const guidance = TAILWIND_TOKEN_GUIDANCE[category];
+  if (!guidance) {
+    return `Category "${category}" not found. Available categories: ${Object.keys(
+      TAILWIND_TOKEN_GUIDANCE
+    ).join(", ")}`;
+  }
+  let output = `## ${guidance.category} Tokens
+
+`;
+  output += `${guidance.description}
+
+`;
+  output += `**Tailwind Prefixes:** ${guidance.prefixes.join(", ")}
+
+`;
+  output += `### Examples:
+
+`;
+  guidance.examples.forEach((example, index) => {
+    output += `${index + 1}. **${example.description}**
+\`\`\`jsx
+${example.code}
+\`\`\`
+
+`;
+  });
+  if (guidance.tips && guidance.tips.length > 0) {
+    output += `### Tips:
+`;
+    guidance.tips.forEach((tip) => {
+      output += `- ${tip}
+`;
+    });
+  }
+  return output;
+}
+
+// src/tools/get-tailwind-tokens.ts
 var getTailwindTokensTool = {
   name: "get_tailwind_tokens",
-  description: "Get all available Tailwind tokens from the SDS design system. Returns design tokens including colors, typography, spacing, borders, shadows, and other design system values formatted for Tailwind CSS.",
+  description: "Get all available Tailwind tokens from the SDS design system. Available design tokens include fontFamily, fontSize, fontVariantNumeric, letterSpacing, lineHeight, textDecoration, textTransform, typography, height, width, borderRadius, boxShadow, breakpoints, colors, spacing, and more.",
   async ctx() {
-    return {};
+    try {
+      const tailwindTokens = await fetchTailwindTokens();
+      return { tailwindTokens };
+    } catch (error) {
+      throw new Error(
+        `Failed to initialize tailwind tokens tool: ${error instanceof Error ? error.message : "Unknown error"}`
+      );
+    }
   },
-  exec(server2, { name, description }) {
+  exec(server2, { ctx, name, description }) {
     server2.tool(
       name,
       description,
@@ -288,20 +598,25 @@ var getTailwindTokensTool = {
       },
       async ({ category }) => {
         try {
-          const dataPath = join(process.cwd(), "data", "tailwind.json");
-          const fileContent = await readFile(dataPath, "utf-8");
-          const tokens = JSON.parse(fileContent);
-          let result = tokens;
-          if (category && category !== "all") {
+          const tokens = ctx.tailwindTokens;
+          let result;
+          if (!category || category === "all") {
+            result = tokens;
+          } else {
             result = tokens[category] || {};
           }
+          const responseContent = [];
+          const guidance = getTokenGuidance(category);
+          responseContent.push({
+            type: "text",
+            text: guidance
+          });
+          responseContent.push({
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          });
           return {
-            content: [
-              {
-                type: "text",
-                text: JSON.stringify(result, null, 2)
-              }
-            ]
+            content: responseContent
           };
         } catch (error) {
           return {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@czi-sds/mcp",
   "description": "The official MCP server for SDS",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "main": "dist/stdio.js",
   "files": [
     "dist",
@@ -62,5 +62,5 @@
     "tsx": "^4.20.3",
     "typescript": "^5.9.2"
   },
-  "gitHead": "f4621fab06e1ddad620b4952aefd5675318d4318"
+  "gitHead": "34691ada3ef3cc877dcf1e2eef0f09efab53e668"
 }