@atlaskit/ads-mcp 0.8.1 → 0.8.2

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @atlaskit/ads-mcp
 
+## 0.8.2
+
+### Patch Changes
+
+- [`64561aae4b705`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/64561aae4b705) -
+  Enhance README.md with comprehensive updates including a new Table of Contents, detailed usage
+  instructions for various tools, and FAQs for troubleshooting. Added sections on accessibility
+  features and environment variables for better user guidance.
+
 ## 0.8.1
 
 ### Patch Changes

package/README.md

@@ -8,6 +8,29 @@ provides tools to access design tokens, icons, and components/primitives program
 **New: Accessibility Analysis & Guidance** The server now includes comprehensive accessibility tools
 to help ensure your interfaces are accessible to all users.
 
+## Table of Contents
+
+- [Available Tools](#available-tools)
+  - [Design System Tools](#design-system-tools)
+  - [Accessibility Tools](#accessibility-tools)
+- [Accessibility Features](#accessibility-features)
+  - [Example Usage](#example-usage)
+- [Usage](#usage)
+  - [For AFM Users (internal Atlassians only)](#for-afm-users-internal-atlassians-only)
+  - [For non-AFM Users](#for-non-afm-users)
+    - [Cursor IDE](#cursor-ide)
+    - [Visual Studio Code](#visual-studio-code)
+      - [Github Copilot](#github-copilot)
+      - [Codelassian](#codelassian)
+    - [Rovodev](#rovodev)
+    - [MCP Plugin for Atlas CLI](#mcp-plugin-for-atlas-cli)
+  - [Environment Variables](#environment-variables)
+- [Analytics](#analytics)
+  - [What We Track](#what-we-track)
+  - [Privacy & Error Handling](#privacy--error-handling)
+- [Development](#development)
+- [FAQs](#faqs)
+
 ## Available Tools
 
 ### Design System Tools
@@ -104,9 +127,22 @@ const fixes = await suggest_a11y_fixes({
 
 ## Usage
 
-### Cursor IDE
+### For AFM Users (internal Atlassians only)
+
+If you are working in the AFM root folder or any of the main product folders (`platform/`, `jira/`, `confluence/`,
+`post-office/`, `confluence/`, or `townsquare/`), ads-mcp is pre-configured and ready to use with
+supported tools like Cursor, VSCode (Copilot/Codelassian), and Rovodev.
+
+For most users, ads-mcp is pre-configured in AFM, but you may need to manually enable it in
+Cursor or Copilot. Rovodev users get ads-mcp enabled automatically anywhere within AFM. For other
+tools, make sure you are running them from the AFM root or one of the main product folders to access
+ads-mcp.
 
-Add the following entry to your `mcp.json` file (located at `~/.cursor/mcp.json` for user-level or `.cursor/mcp.json` in your workspace):
+### For non-AFM Users
+#### Cursor IDE
+
+Add the following entry to your `mcp.json` file (located at `~/.cursor/mcp.json` for user-level or
+`.cursor/mcp.json` in your workspace):
 
 ```json
 {
@@ -122,9 +158,13 @@ Add the following entry to your `mcp.json` file (located at `~/.cursor/mcp.json`
 }
 ```
 
-### Visual Studio Code (Github Copilot and/or Codelassian)
+#### Visual Studio Code
+
+##### Github Copilot
 
-Add the following entry to your `mcp.json` file (located at `~/Library/Application Support/Code/User/mcp.json` for user-level or `.vscode/mcp.json` in your workspace):
+Add the following entry to your `mcp.json` file (located at
+`~/Library/Application Support/Code/User/mcp.json` for user-level or `.vscode/mcp.json` in your
+workspace):
 
 ```json
 {
@@ -133,32 +173,62 @@ Add the following entry to your `mcp.json` file (located at `~/Library/Applicati
 			"type": "stdio",
 			"command": "npx",
 			"args": ["-y", "@atlaskit/ads-mcp"]
+		},
+		"env": {
+			"ADSMCMP_AGENT": "vscode"
 		}
 	}
 }
 ```
 
-### Rovodev
+##### Codelassian
 
-Add the following entry to your `mcp.json` file (located at `~/.rovodev/mcp.json` for user-level or `mcp.json` in your workspace):
+Add the following entry to your `mcp.json` file (located at `~/.codelassian/mcp.json` for user-level
+or `.codelassian/mcp.json` in your workspace):
 
 ```json
 {
 	"mcpServers": {
 		"ads-mcp": {
 			"command": "npx",
-			"args": ["-y", "@atlaskit/ads-mcp"]
+			"args": ["-y", "@atlaskit/ads-mcp"],
+			"env": {
+				"ADSMCP_AGENT": "codelassian"
+			}
+		}
+	}
+}
+```
+
+#### Rovodev
+
+Add the following entry to your `mcp.json` file (located at `~/.rovodev/mcp.json` for user-level or
+`mcp.json` in your workspace):
+
+```json
+{
+	"mcpServers": {
+		"ads-mcp": {
+			"command": "npx",
+			"args": ["-y", "@atlaskit/ads-mcp"],
+			"env": {
+				"ADSMCP_AGENT": "rovodev"
+			}
 		}
 	}
 }
 ```
-> **Note:**  
-> The `timeout` field is supported in the Rovodev configuration. For example, setting `"timeout": 300` will specify the maximum time in **seconds** that the MCP server will wait before terminating the process if it becomes unresponsive. Adjust this value as needed for your environment or workflow.  
 
+> **Note:**  
+> The `timeout` field is supported in the Rovodev configuration. For example, setting
+> `"timeout": 300` will specify the maximum time in **seconds** that the MCP server will wait before
+> terminating the process if it becomes unresponsive. Adjust this value as needed for your
+> environment or workflow.
 
-### MCP Plugin for Atlas CLI
+#### MCP Plugin for Atlas CLI
 
-Atlas CLI provides a plugin for managing MCP servers, including listing available servers from a registry and installing new ones.
+Atlas CLI provides a plugin for managing MCP servers, including listing available servers from a
+registry and installing new ones.
 
 To install the MCP plugin, run:
 
@@ -173,69 +243,16 @@ atlas mcp install --name=ads-mcp --agent=rovodev
 ```
 
 > **Note:**  
-> To see the list of available agents, visit: [Introducing the MCP plugin for Atlas CLI](https://hello.atlassian.net/wiki/spaces/~dnorton/blog/2025/10/07/5931517464/Introducing+the+MCP+plugin+for+Atlas+CLI)
-
-
-### AFM-specific issues
-
-When using the Atlassian Frontend Monorepo (AFM), there are some issues with project-level or workspace-level MCP configuration when using `npx`. These issues typically manifest as:
-
-- **Performance**: `npx` can be slower in AFM environments due to package resolution overhead
-- **Reliability**: Network timeouts and package resolution conflicts are more common
-
-> **Note:** These issues only affect project-level or workspace-level MCP configurations. User-level settings (like `~/.cursor/mcp.json` or `~/.rovodev/mcp.json`) work fine with `npx` and don't require the workarounds below.
-
-#### Recommended Solution
-
-Instead of using `npx`, `yarn dlx` provides better speed and reliability in AFM environments because:
-
-- **Faster execution**: Leverages AFM's existing yarn workspace configuration
-- **Better caching**: Uses yarn's package cache more effectively
-- **Consistent resolution**: Respects AFM's package resolution strategy
-
-#### Simple Configuration
-
-For most AFM users, this configuration will work reliably:
-
-```json
-{
-	"mcpServers": {
-		"ads-mcp": {
-			"command": "yarn",
-			"args": [
-				"dlx",
-				"-q",
-				"@atlaskit/ads-mcp"
-			]
-		}
-	}
-}
-```
-
-#### Robust Configuration with Fallback
-
-If you need maximum reliability across different environments, use this configuration that falls back to `npm` if `yarn` is unavailable:
+> To see the list of available agents, visit:
+> [Introducing the MCP plugin for Atlas CLI](https://hello.atlassian.net/wiki/spaces/~dnorton/blog/2025/10/07/5931517464/Introducing+the+MCP+plugin+for+Atlas+CLI)
 
-```json
-{
-	"mcpServers": {
-		"ads-mcp": {
-			"command": "sh",
-			"args": [
-				"-c",
-				"which yarn &>/dev/null && [ \"$(yarn --version | cut -d. -f1)\" -ge 2 ] && yarn dlx -q @atlaskit/ads-mcp || (which ads-mcp &>/dev/null && (npm update -g @atlaskit/ads-mcp && ads-mcp) || (npm install -g @atlaskit/ads-mcp && ads-mcp))"
-			]
-		}
-	}
-}
-```
+### Environment Variables
 
-This robust configuration:
-1. **First tries yarn dlx** if yarn v2+ is available
-2. **Falls back to npm update** if the package is already installed globally
-3. **Finally installs globally** with npm if nothing else works
+The ADS MCP server supports several environment variables, mainly for analytics purposes to help
+improve the service. These variables enable platform identification, specification of configuration
+paths, and opting out of analytics collection if needed.
 
-### Environment Variables
+> **Note:** All environment variables are optional. The MCP server will work without any of them set.
 
 - `ADSMCP_AGENT` - Identifies the AI agent/platform using the MCP server. Supported values:
   - `cursor` - Cursor editor
@@ -247,21 +264,28 @@ This robust configuration:
   The `ADSMCP_AGENT` variable helps track which platforms are using the MCP server for analytics
   purposes.
 
+- `ADSMCP_CONFIG_PATH` - Specifies the path to the MCP config file being used to run the server.
+  This is used for analytics to understand where the server is being configured from (e.g.,
+  `mcp.json`, `jira/.cursor/mcp.json`, `platform/.vscode/mcp.json`). Defaults to `unknown` if not
+  specified.
+
 - `ADSMCP_ANALYTICS_OPT_OUT` - Opt out of analytics collection. Set to `true` to disable:
-  ```json
-  {
-  	"mcpServers": {
-  		"ads": {
-  			"command": "npx",
-  			"args": ["-y", "@atlaskit/ads-mcp"],
-  			"env": {
-  				"ADSMCP_AGENT": "cursor",
-  				"ADSMCP_ANALYTICS_OPT_OUT": true
-  			}
-  		}
-  	}
-  }
-  ```
+
+```json
+{
+	"mcpServers": {
+		"ads": {
+			"command": "npx",
+			"args": ["-y", "@atlaskit/ads-mcp"],
+			"env": {
+				"ADSMCP_AGENT": "codelassian",
+				"ADSMCP_CONFIG_PATH": "platform/.codelassian/mcp.json",
+				"ADSMCP_ANALYTICS_OPT_OUT": true
+			}
+		}
+	}
+}
+```
 
 ## Analytics
 
@@ -311,3 +335,26 @@ running it from, but you should force it like so:
 	}
 }
 ```
+
+## FAQs
+
+1. I'm seeing an error like "Error: Cannot find module
+   `/Users/[username]/.npm/_npx/[hash]/node_modules/[module]/...`"
+
+   This usually means the cached package is corrupted or outdated. To resolve:
+   1. Disable `ads-mcp` in your list of installed MCP servers.
+   2. Delete the affected `/Users/[username]/.npm/_npx/[hash]` directory.
+   3. Re-enable `ads-mcp` in your MCP servers.
+
+2. In VSCode (Copilot), `ads-mcp` keeps auto-starting in the chat panel even when disabled.
+
+   To prevent auto-start:
+   1. Open VSCode settings.
+   2. Search for `@feature:chat mcp`.
+   3. Set `Chat › Mcp: Autostart` to `never`.
+
+3. Who should I contact for support or questions?
+
+   For internal Atlassians, please reach out in the
+   [#help-ads-ai](https://atlassian.enterprise.slack.com/archives/C091C8JCUTV) Slack channel with
+   any issues or inquiries.

package/dist/cjs/helpers/validation.js

@@ -0,0 +1,49 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.validateToolArguments = validateToolArguments;
+var _zodToJsonSchema = require("zod-to-json-schema");
+/**
+ * Validates arguments against a Zod schema and returns a discriminated union result.
+ *
+ * @param schema - The Zod schema to validate against
+ * @param args - The arguments to validate
+ * @returns { success: true; data: T } if validation succeeds, { success: false; error: ValidationErrorResult } if validation fails
+ */
+function validateToolArguments(schema, args) {
+  var result = schema.safeParse(args);
+  if (result.success) {
+    return {
+      success: true,
+      data: result.data
+    };
+  }
+
+  // Convert the Zod schema to JSON Schema for the error response
+  var jsonSchema = (0, _zodToJsonSchema.zodToJsonSchema)(schema);
+  var validationErrors = result.error.errors.map(function (error) {
+    return {
+      path: error.path.join('.'),
+      message: error.message,
+      code: error.code
+    };
+  });
+  var errorMessage = {
+    error: 'Invalid arguments provided',
+    validationErrors: validationErrors,
+    expectedSchema: jsonSchema,
+    receivedArguments: args
+  };
+  return {
+    success: false,
+    error: {
+      content: [{
+        isError: true,
+        type: 'text',
+        text: JSON.stringify(errorMessage, null, 2)
+      }]
+    }
+  };
+}

package/dist/cjs/index.js

@@ -2,11 +2,13 @@
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
 var _index = require("@modelcontextprotocol/sdk/server/index.js");
 var _stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
 var _types = require("@modelcontextprotocol/sdk/types.js");
 var _analytics = require("./helpers/analytics");
+var _validation = require("./helpers/validation");
 var _instructions = require("./instructions");
 var _analyzeA11y = require("./tools/analyze-a11y");
 var _getA11yGuidelines = require("./tools/get-a11y-guidelines");
@@ -91,30 +93,30 @@ server.setRequestHandler(_types.ListToolsRequestSchema, /*#__PURE__*/function ()
   };
 }());
 var callTools = {
-  ads_analyze_a11y: _analyzeA11y.analyzeA11yTool,
-  ads_analyze_localhost_a11y: _analyzeA11y.analyzeLocalhostA11yTool,
-  ads_get_a11y_guidelines: _getA11yGuidelines.getA11yGuidelinesTool,
-  ads_get_all_icons: _getAllIcons.getAllIconsTool,
-  ads_get_all_tokens: _getAllTokens.getAllTokensTool,
-  ads_get_components: _getComponents.getComponentsTool,
-  ads_plan: _plan.planTool,
+  ads_analyze_a11y: [_analyzeA11y.analyzeA11yTool, _analyzeA11y.analyzeA11yInputSchema],
+  ads_analyze_localhost_a11y: [_analyzeA11y.analyzeLocalhostA11yTool, _analyzeA11y.analyzeA11yLocalhostInputSchema],
+  ads_get_a11y_guidelines: [_getA11yGuidelines.getA11yGuidelinesTool, _getA11yGuidelines.getA11yGuidelinesInputSchema],
+  ads_get_all_icons: [_getAllIcons.getAllIconsTool, null],
+  ads_get_all_tokens: [_getAllTokens.getAllTokensTool, null],
+  ads_get_components: [_getComponents.getComponentsTool, null],
+  ads_plan: [_plan.planTool, _plan.planInputSchema],
   // NOTE: These should not actually be called as they're not in the `list_tools` endpoint.
   // But there might be a reason to keep them around for backwards-compatibility.
-  ads_search_components: _searchComponents.searchComponentsTool,
-  ads_search_icons: _searchIcons.searchIconsTool,
-  ads_search_tokens: _searchTokens.searchTokensTool,
-  ads_suggest_a11y_fixes: _suggestA11yFixes.suggestA11yFixesTool
+  ads_search_components: [_searchComponents.searchComponentsTool, _searchComponents.searchComponentsInputSchema],
+  ads_search_icons: [_searchIcons.searchIconsTool, _searchIcons.searchIconsInputSchema],
+  ads_search_tokens: [_searchTokens.searchTokensTool, _searchTokens.searchTokensInputSchema],
+  ads_suggest_a11y_fixes: [_suggestA11yFixes.suggestA11yFixesTool, _suggestA11yFixes.suggestA11yFixesInputSchema]
 };
 
 // Handle tool execution
 server.setRequestHandler(_types.CallToolRequestSchema, /*#__PURE__*/function () {
   var _ref2 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2(request, extra) {
-    var toolName, tool, actionSubject, result;
+    var toolName, _callTools$toolName, tool, inputSchema, actionSubject, toolArguments, inputValidation, result;
     return _regenerator.default.wrap(function _callee2$(_context2) {
       while (1) switch (_context2.prev = _context2.next) {
         case 0:
           toolName = request.params.name;
-          tool = callTools[toolName];
+          _callTools$toolName = (0, _slicedToArray2.default)(callTools[toolName], 2), tool = _callTools$toolName[0], inputSchema = _callTools$toolName[1];
           actionSubject = "ads.mcp.callTool"; // Track call tool request
           (0, _analytics.sendOperationalEvent)({
             action: 'called',
@@ -127,13 +129,38 @@ server.setRequestHandler(_types.CallToolRequestSchema, /*#__PURE__*/function ()
             }
           });
           if (!tool) {
-            _context2.next = 17;
+            _context2.next = 23;
             break;
           }
           _context2.prev = 5;
-          _context2.next = 8;
-          return tool(request.params.arguments);
-        case 8:
+          if (!inputSchema) {
+            _context2.next = 12;
+            break;
+          }
+          inputValidation = (0, _validation.validateToolArguments)(inputSchema, request.params.arguments);
+          if (inputValidation.success) {
+            _context2.next = 11;
+            break;
+          }
+          (0, _analytics.sendOperationalEvent)({
+            action: 'failed',
+            actionSubject: actionSubject,
+            actionSubjectId: toolName,
+            attributes: {
+              toolName: toolName,
+              request: request,
+              extra: extra,
+              errorMessage: 'Invalid arguments provided',
+              failedValidation: true
+            }
+          });
+          return _context2.abrupt("return", inputValidation.error);
+        case 11:
+          toolArguments = inputValidation.data;
+        case 12:
+          _context2.next = 14;
+          return tool(toolArguments);
+        case 14:
           result = _context2.sent;
           // Track successful tool execution
           (0, _analytics.sendOperationalEvent)({
@@ -147,8 +174,8 @@ server.setRequestHandler(_types.CallToolRequestSchema, /*#__PURE__*/function ()
             }
           });
           return _context2.abrupt("return", result);
-        case 13:
-          _context2.prev = 13;
+        case 19:
+          _context2.prev = 19;
           _context2.t0 = _context2["catch"](5);
           // Track tool execution error
           (0, _analytics.sendOperationalEvent)({
@@ -168,7 +195,7 @@ server.setRequestHandler(_types.CallToolRequestSchema, /*#__PURE__*/function ()
           - when used alone, without the throw new McpError, it causes "Client error for command...", which will loop back to this catch
           */
           throw new _types.McpError(-32000, "Failed to execute '".concat(toolName, "' tool: ").concat(_context2.t0 instanceof Error ? _context2.t0.message : 'Unknown error'));
-        case 17:
+        case 23:
           // Track tool not found error
           (0, _analytics.sendOperationalEvent)({
             action: 'notFound',
@@ -182,11 +209,11 @@ server.setRequestHandler(_types.CallToolRequestSchema, /*#__PURE__*/function ()
           });
           console.error("Tool '".concat(request.params.name, "' not found, only the following tools are available: ").concat(Object.keys(callTools).join(', ')));
           return _context2.abrupt("return");
-        case 20:
+        case 26:
         case "end":
           return _context2.stop();
       }
-    }, _callee2, null, [[5, 13]]);
+    }, _callee2, null, [[5, 19]]);
   }));
   return function (_x3, _x4) {
     return _ref2.apply(this, arguments);

package/dist/cjs/tools/analyze-a11y/index.js

@@ -4,7 +4,7 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.listAnalyzeLocalhostA11yTool = exports.listAnalyzeA11yTool = exports.analyzeLocalhostA11yTool = exports.analyzeA11yTool = void 0;
+exports.listAnalyzeLocalhostA11yTool = exports.listAnalyzeA11yTool = exports.analyzeLocalhostA11yTool = exports.analyzeA11yTool = exports.analyzeA11yLocalhostInputSchema = exports.analyzeA11yInputSchema = void 0;
 var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
 var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
@@ -16,11 +16,11 @@ var _zod = require("zod");
 var _zodToJsonSchema = require("zod-to-json-schema");
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
-var inputSchema = _zod.z.object({
+var analyzeA11yInputSchema = exports.analyzeA11yInputSchema = _zod.z.object({
   code: _zod.z.string().describe('React component code to analyze for accessibility'),
-  componentName: _zod.z.string().optional().describe('Name of the component being analyzed'),
-  context: _zod.z.string().optional().describe('Additional context about the component usage'),
-  includePatternAnalysis: _zod.z.boolean().optional().default(true).describe('Include pattern-based analysis in addition to axe-core')
+  componentName: _zod.z.string().describe('Name of the component being analyzed').optional(),
+  context: _zod.z.string().describe('Additional context about the component usage').optional(),
+  includePatternAnalysis: _zod.z.boolean().default(true).describe('Include pattern-based analysis in addition to axe-core').optional()
 });
 var listAnalyzeA11yTool = exports.listAnalyzeA11yTool = {
   name: 'ads_analyze_a11y',
@@ -32,9 +32,9 @@ var listAnalyzeA11yTool = exports.listAnalyzeA11yTool = {
     idempotentHint: true,
     openWorldHint: true
   },
-  inputSchema: (0, _zodToJsonSchema.zodToJsonSchema)(inputSchema)
+  inputSchema: (0, _zodToJsonSchema.zodToJsonSchema)(analyzeA11yInputSchema)
 };
-var urlInputSchema = _zod.z.object({
+var analyzeA11yLocalhostInputSchema = exports.analyzeA11yLocalhostInputSchema = _zod.z.object({
   url: _zod.z.string().describe('The URL to analyze for accessibility (e.g. `http://localhost:9000`)'),
   componentName: _zod.z.string().optional().describe('Name of the component being analyzed'),
   context: _zod.z.string().optional().describe('Additional context about the component usage'),
@@ -50,7 +50,7 @@ var listAnalyzeLocalhostA11yTool = exports.listAnalyzeLocalhostA11yTool = {
     idempotentHint: true,
     openWorldHint: true
   },
-  inputSchema: (0, _zodToJsonSchema.zodToJsonSchema)(urlInputSchema)
+  inputSchema: (0, _zodToJsonSchema.zodToJsonSchema)(analyzeA11yLocalhostInputSchema)
 };
 
 // Common accessibility patterns to detect in code

package/dist/cjs/tools/get-a11y-guidelines/index.js

@@ -4,7 +4,7 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.listGetA11yGuidelinesTool = exports.getA11yGuidelinesTool = void 0;
+exports.listGetA11yGuidelinesTool = exports.getA11yGuidelinesTool = exports.getA11yGuidelinesInputSchema = void 0;
 var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
@@ -14,7 +14,7 @@ var _guidelines = require("./guidelines");
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 var topics = Object.keys(_guidelines.accessibilityGuidelines);
-var inputSchema = _zod.z.object({
+var getA11yGuidelinesInputSchema = exports.getA11yGuidelinesInputSchema = _zod.z.object({
   topic: _zod.z.string().optional().describe('Select the topic to get the accessibility guidelines for: ' + topics.join(', '))
 });
 var listGetA11yGuidelinesTool = exports.listGetA11yGuidelinesTool = {
@@ -27,7 +27,7 @@ var listGetA11yGuidelinesTool = exports.listGetA11yGuidelinesTool = {
     idempotentHint: true,
     openWorldHint: true
   },
-  inputSchema: (0, _zodToJsonSchema.zodToJsonSchema)(inputSchema)
+  inputSchema: (0, _zodToJsonSchema.zodToJsonSchema)(getA11yGuidelinesInputSchema)
 };
 var getA11yGuidelinesTool = exports.getA11yGuidelinesTool = /*#__PURE__*/function () {
   var _ref2 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(_ref) {

package/dist/cjs/tools/plan/index.js

@@ -4,7 +4,7 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.planTool = exports.listPlanTool = void 0;
+exports.planTool = exports.planInputSchema = exports.listPlanTool = void 0;
 var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
@@ -15,12 +15,12 @@ var _searchIcons = require("../search-icons");
 var _searchTokens = require("../search-tokens");
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
-var inputSchema = _zod.z.object({
+var planInputSchema = exports.planInputSchema = _zod.z.object({
   tokens: _zod.z.array(_zod.z.string()).describe('Array of terms to search for tokens, eg. `["spacing", "inverted text", "background primary"]`. Provide a minimum of 2 terms when known.'),
   icons: _zod.z.array(_zod.z.string()).describe('Array of terms to search for icons, eg. `["search", "folder", "user"]`. Provide a minimum of 2 terms when known.'),
   components: _zod.z.array(_zod.z.string()).describe('Array of terms to search for components, eg. `["button", "input", "select"]`. Provide a minimum of 2 terms when known.'),
-  limit: _zod.z.number().optional().default(1).describe('Maximum number of results per search term in the provided arrays (default: 1)'),
-  exactName: _zod.z.boolean().optional().default(false).describe('Search tokens, icons, and components by their exact name match (use when you explicitly know the name and need more details)')
+  limit: _zod.z.number().default(1).describe('Maximum number of results per search term in the provided arrays (default: 1)').optional(),
+  exactName: _zod.z.boolean().default(false).describe('Search tokens, icons, and components by their exact name match (use when you explicitly know the name and need more details)').optional()
 });
 var listPlanTool = exports.listPlanTool = {
   name: 'ads_plan',
@@ -32,7 +32,7 @@ var listPlanTool = exports.listPlanTool = {
     idempotentHint: true,
     openWorldHint: true
   },
-  inputSchema: (0, _zodToJsonSchema.zodToJsonSchema)(inputSchema)
+  inputSchema: (0, _zodToJsonSchema.zodToJsonSchema)(planInputSchema)
 };
 var planTool = exports.planTool = /*#__PURE__*/function () {
   var _ref = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(params) {

package/dist/cjs/tools/search-components/index.js

@@ -4,7 +4,7 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.searchComponentsTool = exports.listSearchComponentsTool = void 0;
+exports.searchComponentsTool = exports.searchComponentsInputSchema = exports.listSearchComponentsTool = void 0;
 var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
 var _fuse = _interopRequireDefault(require("fuse.js"));
@@ -12,10 +12,10 @@ var _zod = require("zod");
 var _zodToJsonSchema = require("zod-to-json-schema");
 var _helpers = require("../../helpers");
 var _components = require("../get-components/components");
-var inputSchema = _zod.z.object({
+var searchComponentsInputSchema = exports.searchComponentsInputSchema = _zod.z.object({
   terms: _zod.z.array(_zod.z.string()).describe('An array of search terms to find components by name, package name, description, or example, eg. `["button", "input", "select"]`'),
-  limit: _zod.z.number().optional().default(1).describe('Maximum number of results per search term in the array (default: 1)'),
-  exactName: _zod.z.boolean().optional().default(false).describe('Enable to explicitly search components by the exact name match (when you know the name, but need more details)')
+  limit: _zod.z.number().default(1).describe('Maximum number of results per search term in the array (default: 1)').optional(),
+  exactName: _zod.z.boolean().default(false).describe('Enable to explicitly search components by the exact name match (when you know the name, but need more details)').optional()
 });
 var listSearchComponentsTool = exports.listSearchComponentsTool = {
   name: 'ads_search_components',
@@ -27,7 +27,7 @@ var listSearchComponentsTool = exports.listSearchComponentsTool = {
     idempotentHint: true,
     openWorldHint: true
   },
-  inputSchema: (0, _zodToJsonSchema.zodToJsonSchema)(inputSchema)
+  inputSchema: (0, _zodToJsonSchema.zodToJsonSchema)(searchComponentsInputSchema)
 };
 
 // Clean component result to only return name, package name, example, and props

package/dist/cjs/tools/search-icons/index.js

@@ -4,7 +4,7 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.searchIconsTool = exports.listSearchIconsTool = void 0;
+exports.searchIconsTool = exports.searchIconsInputSchema = exports.listSearchIconsTool = void 0;
 var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
 var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
@@ -13,10 +13,10 @@ var _zod = require("zod");
 var _zodToJsonSchema = require("zod-to-json-schema");
 var _metadata = require("@atlaskit/icon/metadata");
 var _helpers = require("../../helpers");
-var inputSchema = _zod.z.object({
+var searchIconsInputSchema = exports.searchIconsInputSchema = _zod.z.object({
   terms: _zod.z.array(_zod.z.string()).describe('An array of search terms to find icons by name, keywords, or categorization, eg. `["search", "folder", "user"]`'),
-  limit: _zod.z.number().optional().default(1).describe('Maximum number of results per search term in the array (default: 1)'),
-  exactName: _zod.z.boolean().optional().default(false).describe('Enable to explicitly search icons by the exact name match (when you know the name, but need more details)')
+  limit: _zod.z.number().default(1).describe('Maximum number of results per search term in the array (default: 1)').optional(),
+  exactName: _zod.z.boolean().default(false).describe('Enable to explicitly search icons by the exact name match (when you know the name, but need more details)').optional()
 });
 var icons = Object.entries(_metadata.coreIconMetadata).map(function (_ref) {
   var _ref2 = (0, _slicedToArray2.default)(_ref, 2),
@@ -45,7 +45,7 @@ var listSearchIconsTool = exports.listSearchIconsTool = {
     idempotentHint: true,
     openWorldHint: true
   },
-  inputSchema: (0, _zodToJsonSchema.zodToJsonSchema)(inputSchema)
+  inputSchema: (0, _zodToJsonSchema.zodToJsonSchema)(searchIconsInputSchema)
 };
 var searchIconsTool = exports.searchIconsTool = /*#__PURE__*/function () {
   var _ref3 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(params) {