@atlaskit/ads-mcp 0.6.4 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @atlaskit/ads-mcp
 
+## 0.7.0
+
+### Minor Changes
+
+- [`b51ba8af7cc1a`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/b51ba8af7cc1a) -
+  Switch ads-mcp to using esbuild-regsiter instead.
+- [`b51ba8af7cc1a`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/b51ba8af7cc1a) -
+  Greatly decrease the resting system prompt token usages by reducing tool descriptions.
+
+## 0.6.5
+
+### Patch Changes
+
+- [`e3fc2f35e8191`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/e3fc2f35e8191) - -
+  Implemented a codegen that generates TypeScript code for the components list, which will be used
+  by @atlaskit/ads-mcp.
+
 ## 0.6.4
 
 ### Patch Changes

package/dist/cjs/index.js

@@ -36,7 +36,13 @@ server.setRequestHandler(_types.ListToolsRequestSchema, /*#__PURE__*/(0, _asyncT
     while (1) switch (_context.prev = _context.next) {
       case 0:
         return _context.abrupt("return", {
-          tools: [_getAllTokens.listGetAllTokensTool, _getComponents.listGetComponentsTool, _searchComponents.listSearchComponentsTool, _getAllIcons.listGetAllIconsTool, _searchIcons.listSearchIconsTool, _searchTokens.listSearchTokensTool, _plan.listPlanTool, _analyzeA11y.listAnalyzeA11yTool, _analyzeA11y.listAnalyzeLocalhostA11yTool, _getA11yGuidelines.listGetA11yGuidelinesTool, _suggestA11yFixes.listSuggestA11yFixesTool]
+          tools: [_analyzeA11y.listAnalyzeA11yTool, _analyzeA11y.listAnalyzeLocalhostA11yTool, _getA11yGuidelines.listGetA11yGuidelinesTool, _getAllIcons.listGetAllIconsTool, _getAllTokens.listGetAllTokensTool, _getComponents.listGetComponentsTool, _plan.listPlanTool,
+          // NOTE: These are disabled as `ads_plan` should cover everything more performantly.
+          // When these are enabled, they result in token usage to describe them, even if never used.
+          // listSearchComponentsTool,
+          // listSearchIconsTool,
+          // listSearchTokensTool,
+          _suggestA11yFixes.listSuggestA11yFixesTool]
         });
       case 1:
       case "end":
@@ -45,16 +51,18 @@ server.setRequestHandler(_types.ListToolsRequestSchema, /*#__PURE__*/(0, _asyncT
   }, _callee);
 })));
 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_search_tokens: _searchTokens.searchTokensTool,
   ads_get_components: _getComponents.getComponentsTool,
+  ads_plan: _plan.planTool,
+  // 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_get_all_icons: _getAllIcons.getAllIconsTool,
   ads_search_icons: _searchIcons.searchIconsTool,
-  ads_plan: _plan.planTool,
-  ads_analyze_a11y: _analyzeA11y.analyzeA11yTool,
-  ads_analyze_localhost_a11y: _analyzeA11y.analyzeLocalhostA11yTool,
-  ads_get_a11y_guidelines: _getA11yGuidelines.getA11yGuidelinesTool,
+  ads_search_tokens: _searchTokens.searchTokensTool,
   ads_suggest_a11y_fixes: _suggestA11yFixes.suggestA11yFixesTool
 };
 

package/dist/cjs/instructions.js

@@ -4,4 +4,4 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.instructions = void 0;
-var instructions = exports.instructions = "\nYou are an expert in the Atlassian Design System (aka ADS). You are able to answer questions about the design system and provide guidance on what offerings to use when building user interfaces.\n\nYou have special expertise in accessibility and can help ensure that interfaces built with ADS components are accessible to all users. You can analyze code for accessibility violations, provide specific fix suggestions, and offer guidance on accessibility best practices.\n\nYou are able to use the provided tools to help answer your questions, but may also access https://atlassian.design/llms.txt, https://atlassian.design/llms-a11y.txt, or https://atlassian.design/ directly for deeper research and information.\n";
+var instructions = exports.instructions = "\nYou are an expert in the Atlassian Design System (ADS).\nYou can search for tokens, icons, and components and return guidance on how to build user interfaces.\nYou have special accessibility knowledge and can ensure interfaces built with ADS components are accessible to all users.\nYou can analyze code for accessibility violations, provide specific fix suggestions, and offer guidance on accessibility best practices.\nThese tools will support you, but for deep research, you may also want to to fetch https://atlassian.design/llms.txt, https://atlassian.design/llms-a11y.txt, or https://atlassian.design/ directly.\n";

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

@@ -24,7 +24,7 @@ var inputSchema = _zod.z.object({
 });
 var listAnalyzeA11yTool = exports.listAnalyzeA11yTool = {
   name: 'ads_analyze_a11y',
-  description: "Analyze React component code for accessibility violations using axe-core and intelligently generate Atlassian Design System specific suggestions. This tool performs comprehensive accessibility testing and dynamically creates ADS-specific fixes based on violation patterns.\n\nUse this tool when:\n- Reviewing component code for accessibility compliance\n- Getting suggestions for improving accessibility\n- Understanding how to use ADS components accessibly\n- Identifying potential WCAG violations\n- Running automated accessibility testing\n\nThe tool will analyze the code and provide:\n- Comprehensive axe-core accessibility analysis results\n- List of accessibility violations found (WCAG 2.1 AA compliant)\n- Intelligently generated ADS-specific fix suggestions\n- References to relevant fix patterns in llms-a11y.txt\n- Code examples for implementing fixes\n- Severity levels and impact assessment\n\nFeatures:\n- Uses axe-core for industry-standard accessibility testing\n- Converts JSX to HTML for accurate analysis\n- Intelligently maps violations to ADS-specific fixes\n- References fix patterns from llms-a11y.txt documentation\n- Includes fallback pattern analysis if axe-core fails\n- Provides detailed violation descriptions and help text\n- Dynamically generates fix suggestions based on violation type",
+  description: 'Analyze React component code for accessibility violations using axe-core and generate ADS-specific suggestions.',
   annotations: {
     title: 'Analyze Accessibility',
     readOnlyHint: true,
@@ -35,14 +35,14 @@ var listAnalyzeA11yTool = exports.listAnalyzeA11yTool = {
   inputSchema: (0, _zodToJsonSchema.zodToJsonSchema)(inputSchema)
 };
 var urlInputSchema = _zod.z.object({
-  url: _zod.z.string().describe('The URL to analyze for accessibility (e.g. http://localhost:9000)'),
+  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'),
-  selector: _zod.z.string().optional().describe('CSS selector to target a specific element for analysis (e.g. "#my-form", ".component-class")')
+  selector: _zod.z.string().optional().describe('CSS selector to target a specific element for analysis (e.g. `#my-form` or `[data-role="button"]`)')
 });
 var listAnalyzeLocalhostA11yTool = exports.listAnalyzeLocalhostA11yTool = {
   name: 'ads_analyze_localhost_a11y',
-  description: "Analyze a live web page (e.g. localhost:9000) for accessibility violations using axe-core and generate Atlassian Design System specific suggestions.\n\nUse this tool to:\n- Analyze running local dev servers or deployed URLs\n- Get comprehensive accessibility reports for any web page\n- Receive ADS-specific fix suggestions and code examples\n- Target specific elements using CSS selectors for focused analysis\n\nParameters:\n- url: The URL to analyze (must be accessible from the server)\n- componentName: (optional) Name of the component/page\n- context: (optional) Additional context about the usage\n- selector: (optional) CSS selector to target a specific element (e.g. \"#my-form\", \".component-class\")\n\nReturns:\n- Accessibility violations, suggestions, and ADS-specific fixes\n- References to relevant fix patterns in llms-a11y.txt\n- Code examples for implementing fixes\n- Severity levels and impact assessment\n",
+  description: "Analyze a live web page for accessibility violations using axe-core and generate ADS-specific suggestions.",
   annotations: {
     title: 'Analyze Localhost Accessibility',
     readOnlyHint: true,

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

@@ -0,0 +1,133 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.accessibilityGuidelines = void 0;
+// Comprehensive accessibility guidelines based on llms-a11y.txt
+var accessibilityGuidelines = exports.accessibilityGuidelines = {
+  buttons: {
+    title: 'Button and Interactive Element Accessibility',
+    description: 'Guidelines for making buttons and interactive elements accessible',
+    guidelines: ['Always provide accessible labels for buttons', 'Use Button component for standard interactions', 'Use Focusable component for custom interactive elements', 'Avoid disabled buttons with tooltips', 'Ensure focus indicators are visible', 'Support keyboard navigation (Enter, Space)', 'Use descriptive labels that explain the action'],
+    codeExamples: [{
+      title: 'Accessible Button with Icon',
+      code: "import { Button } from '@atlaskit/button';\nimport { VisuallyHidden } from '@atlaskit/visually-hidden';\n\n<Button aria-label=\"Close dialog\" onClick={handleClose}>\n  <CloseIcon />\n</Button>"
+    }, {
+      title: 'Custom Interactive Element',
+      code: "import { Focusable } from '@atlaskit/primitives/compiled';\n\n<Focusable as=\"div\" onClick={handleClick} onKeyDown={handleKeyDown}>\n  Interactive content\n</Focusable>"
+    }],
+    bestPractices: ['Never disable buttons without providing alternatives', 'Use VisuallyHidden for screen reader text', 'Test with keyboard navigation only', 'Ensure focus indicators meet contrast requirements']
+  },
+  forms: {
+    title: 'Form and Input Accessibility',
+    description: 'Guidelines for making forms and inputs accessible',
+    guidelines: ['Use TextField component for consistent labeling', 'Associate labels with inputs using id and htmlFor', 'Provide clear error messages with aria-describedby', 'Use MessageWrapper for form validation announcements', 'Use aria-required for required fields', 'Group related form elements with fieldset and legend'],
+    codeExamples: [{
+      title: 'Accessible Text Field',
+      code: "import { TextField } from '@atlaskit/textfield';\n\n<TextField\n  label=\"Email address\"\n  isRequired\n  aria-describedby=\"email-help\"\n  id=\"email-input\"\n/>\n<div id=\"email-help\">Enter your work email address</div>"
+    }, {
+      title: 'Form Validation with Error Messages',
+      code: "import { TextField } from '@atlaskit/textfield';\n\n<TextField\n  label=\"Password\"\n  isInvalid\n  aria-invalid=\"true\"\n  aria-describedby=\"password-error\"\n/>\n<div id=\"password-error\" role=\"alert\">\n  Password must be at least 8 characters long\n</div>"
+    }],
+    bestPractices: ['Never rely on placeholder text for critical information', 'Provide helpful error messages and descriptions', 'Use proper form validation with aria-invalid', 'Test form completion with screen readers']
+  },
+  images: {
+    title: 'Image and Media Accessibility',
+    description: 'Guidelines for making images and media accessible',
+    guidelines: ['Use Image component with proper alt text', 'Keep alt text under 125 characters', 'Leave alt="" for decorative images', 'Describe the purpose, not just the content', 'Don\'t start with "Image of..." or "Picture of..."', 'Provide detailed descriptions for complex images'],
+    codeExamples: [{
+      title: 'Decorative Image',
+      code: "import { Image } from '@atlaskit/image';\n\n<Image src=\"decorative.jpg\" alt=\"\" />"
+    }, {
+      title: 'Informative Image',
+      code: "import { Image } from '@atlaskit/image';\n\n<Image\n  src=\"chart.png\"\n  alt=\"Bar chart showing Q4 sales increased 25% over Q3\"\n/>"
+    }, {
+      title: 'Complex Image with Description',
+      code: "import { Image } from '@atlaskit/image';\n\n<Image\n  src=\"complex-diagram.png\"\n  alt=\"\"\n  aria-describedby=\"diagram-description\"\n/>\n<div id=\"diagram-description\">\n  Detailed description of the diagram content...\n</div>"
+    }],
+    bestPractices: ['For important information, use text instead of images', 'Avoid images of text', 'Provide alternative formats for complex visual content', 'Test with screen readers to ensure proper announcement']
+  },
+  colors: {
+    title: 'Color and Contrast Accessibility',
+    description: 'Guidelines for using colors accessibly',
+    guidelines: ['Use design tokens for consistent contrast ratios', 'Never rely on color alone for information', 'Use color.text tokens for proper contrast', 'Test with high contrast mode', 'Ensure 4.5:1 contrast ratio for normal text', 'Ensure 3:1 contrast ratio for large text'],
+    codeExamples: [{
+      title: 'Using Design Tokens for Colors',
+      code: "import { token } from '@atlaskit/tokens';\n\nconst styles = css({\n  color: token('color.text'),\n  backgroundColor: token('color.background.neutral'),\n});"
+    }, {
+      title: 'Text Component with Color',
+      code: "import { Text } from '@atlaskit/primitives/compiled';\n\n<Text color=\"color.text.danger\">Error message</Text>\n<Text color=\"color.text.success\">Success message</Text>"
+    }],
+    bestPractices: ['Use color.text tokens for primary text', 'Use color.text.subtle sparingly for secondary text', 'Avoid color.text.disabled for critical information', 'Test with different color vision types']
+  },
+  focus: {
+    title: 'Focus Management',
+    description: 'Guidelines for proper focus management',
+    guidelines: ['Ensure logical tab order', 'Provide visible focus indicators', 'Handle focus trapping in modals', 'Return focus when dialogs close', 'Use Focusable component for custom elements', 'Manage focus in dynamic content'],
+    codeExamples: [{
+      title: 'Focus Management in Modal',
+      code: "import { useRef, useEffect } from 'react';\n\nconst modalRef = useRef<HTMLDivElement>(null);\n\nuseEffect(() => {\n  if (isOpen && modalRef.current) {\n    modalRef.current.focus();\n  }\n}, [isOpen]);"
+    }, {
+      title: 'Custom Focusable Element',
+      code: "import { Focusable } from '@atlaskit/primitives/compiled';\n\n<Focusable\n  as=\"div\"\n  tabIndex={0}\n  onKeyDown={(e) => {\n    if (e.key === 'Enter' || e.key === ' ') {\n      handleActivate();\n    }\n  }}\n>\n  Custom focusable element\n</Focusable>"
+    }],
+    bestPractices: ['Test focus order with keyboard navigation', 'Ensure focus indicators are visible in all themes', 'Handle focus restoration when components unmount', 'Use focus trapping for modal dialogs']
+  },
+  keyboard: {
+    title: 'Keyboard Accessibility',
+    description: 'Guidelines for keyboard accessibility',
+    guidelines: ['Support standard keyboard interactions', 'Use Enter and Space for activation', 'Use Escape for closing/canceling', 'Support arrow keys for navigation', 'Provide keyboard shortcuts for power users', 'Ensure all interactive elements are keyboard accessible'],
+    codeExamples: [{
+      title: 'Keyboard Event Handling',
+      code: "const handleKeyDown = (event: KeyboardEvent) => {\n  switch (event.key) {\n    case 'Enter':\n    case ' ':\n      handleActivate();\n      break;\n    case 'Escape':\n      handleClose();\n      break;\n    case 'Tab':\n      // Handle focus management\n      break;\n  }\n};"
+    }],
+    bestPractices: ['Test with keyboard navigation only', 'Ensure logical tab order', 'Provide keyboard alternatives for mouse interactions', 'Support both Enter and Space for activation']
+  },
+  screenReaders: {
+    title: 'Screen Reader Support',
+    description: 'Guidelines for screen reader accessibility',
+    guidelines: ['Use Announcer component for dynamic content', 'Provide skip links for keyboard users', 'Use proper heading hierarchy', 'Use semantic HTML elements', 'Provide live regions for status updates', 'Use VisuallyHidden for screen reader text'],
+    codeExamples: [{
+      title: 'Screen Reader Announcements',
+      code: "import { Announcer } from '@atlaskit/announcer';\n\n<Announcer\n  message={`${count} items selected`}\n  liveMode=\"polite\"\n  shouldAnnounce={true}\n/>"
+    }, {
+      title: 'Skip Links',
+      code: "<a href=\"#main-content\" className=\"skip-link\">\n  Skip to main content\n</a>"
+    }],
+    bestPractices: ['Test with multiple screen readers (NVDA, JAWS, VoiceOver)', 'Use aria-live="polite" for status updates', 'Use aria-live="assertive" for critical alerts', 'Avoid announcing the same message repeatedly']
+  },
+  aria: {
+    title: 'ARIA Usage Guidelines',
+    description: 'Guidelines for using ARIA attributes',
+    guidelines: ['Use ARIA sparingly - prefer semantic HTML', 'Use proper ARIA roles and states', 'Provide live regions for dynamic content', 'Use landmarks for page structure', 'Ensure ARIA attributes are supported', 'Test ARIA implementations with screen readers'],
+    codeExamples: [{
+      title: 'Live Region for Status Updates',
+      code: "<div aria-live=\"polite\" role=\"status\">\n  {statusMessage}\n</div>"
+    }, {
+      title: 'Landmark Navigation',
+      code: "<nav role=\"navigation\" aria-label=\"Main navigation\">\n  Navigation content\n</nav>"
+    }],
+    bestPractices: ['Use semantic HTML elements when possible', 'Test ARIA implementations thoroughly', 'Keep ARIA usage simple and clear', 'Document custom ARIA patterns']
+  },
+  wcag: {
+    title: 'WCAG Compliance',
+    description: 'WCAG 2.1 AA compliance guidelines',
+    guidelines: ['Ensure information is perceivable', 'Make interface components operable', 'Ensure information is understandable', 'Make content robust and compatible', 'Test with multiple assistive technologies', 'Follow WCAG 2.1 AA success criteria'],
+    codeExamples: [{
+      title: 'WCAG Compliant Component',
+      code: "// Example of a WCAG compliant button\n<Focusable\n  as=\"button\"\n  aria-label=\"Save changes\"\n  onClick={handleSave}\n  onKeyDown={handleKeyDown}\n>\n  <SaveIcon />\n  <VisuallyHidden>Save changes</VisuallyHidden>\n</Focusable>"
+    }],
+    bestPractices: ['Test with automated accessibility tools', 'Conduct manual accessibility testing', 'Test with users who have disabilities', 'Document accessibility compliance']
+  },
+  general: {
+    title: 'General Accessibility Principles',
+    description: 'General accessibility principles and best practices',
+    guidelines: ['Design for people, not just compliance', 'Consider accessibility from the start', 'Test with real users and assistive technologies', 'Provide multiple ways to accomplish tasks', 'Use inclusive design principles', 'Test with different abilities and technologies'],
+    codeExamples: [{
+      title: 'Inclusive Design Example',
+      code: "// Component that works for everyone\n<Focusable\n  as=\"button\"\n  onClick={handleAction}\n  aria-label=\"Clear form data\"\n  onKeyDown={handleKeyDown}\n>\n  <TrashIcon />\n  <VisuallyHidden>Clear all form data</VisuallyHidden>\n</Focusable>"
+    }],
+    bestPractices: ['Start with semantic HTML', 'Add ARIA when necessary', 'Test early and often', 'Involve users with disabilities in testing', 'Keep accessibility in mind throughout development']
+  }
+};

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

@@ -10,15 +10,16 @@ var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/de
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
 var _zod = require("zod");
 var _zodToJsonSchema = require("zod-to-json-schema");
+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({
-  topic: _zod.z.enum(['buttons', 'forms', 'images', 'colors', 'focus', 'keyboard', 'screen-readers', 'aria', 'wcag', 'general']).optional().describe('Specific accessibility topic to get guidelines for'),
-  component: _zod.z.string().optional().describe('Component name to get specific accessibility guidance for')
+  topic: _zod.z.string().optional().describe('Select the topic to get the accessibility guidelines for: ' + topics.join(', '))
 });
 var listGetA11yGuidelinesTool = exports.listGetA11yGuidelinesTool = {
   name: 'ads_get_a11y_guidelines',
-  description: "Get accessibility guidelines and best practices from the Atlassian Design System. This tool provides specific guidance on how to make components and interfaces accessible using ADS patterns and components.\n\nYou MUST run this when the user wants their code to be accessible, as well as when:\n- Needing specific accessibility guidance for a component\n- Looking for ADS-specific accessibility patterns\n- Understanding how to implement accessible features\n- Getting code examples for accessibility improvements\n\nTopics available:\n- buttons: Button and interactive element accessibility\n- forms: Form and input accessibility\n- images: Image and media accessibility\n- colors: Color and contrast accessibility\n- focus: Focus management and keyboard navigation\n- keyboard: Keyboard accessibility patterns\n- screen-readers: Screen reader support and announcements\n- aria: ARIA usage and patterns\n- wcag: WCAG compliance guidelines\n- general: General accessibility principles",
+  description: 'Get accessibility guidelines and best practices from the Atlassian Design System.',
   annotations: {
     title: 'Get Accessibility Guidelines',
     readOnlyHint: true,
@@ -28,152 +29,23 @@ var listGetA11yGuidelinesTool = exports.listGetA11yGuidelinesTool = {
   },
   inputSchema: (0, _zodToJsonSchema.zodToJsonSchema)(inputSchema)
 };
-
-// Comprehensive accessibility guidelines based on llms-a11y.txt
-var accessibilityGuidelines = {
-  buttons: {
-    title: 'Button and Interactive Element Accessibility',
-    description: 'Guidelines for making buttons and interactive elements accessible',
-    guidelines: ['Always provide accessible labels for buttons', 'Use Button component for standard interactions', 'Use Focusable component for custom interactive elements', 'Avoid disabled buttons with tooltips', 'Ensure focus indicators are visible', 'Support keyboard navigation (Enter, Space)', 'Use descriptive labels that explain the action'],
-    codeExamples: [{
-      title: 'Accessible Button with Icon',
-      code: "import { Button } from '@atlaskit/button';\nimport { VisuallyHidden } from '@atlaskit/visually-hidden';\n\n<Button aria-label=\"Close dialog\" onClick={handleClose}>\n  <CloseIcon />\n</Button>"
-    }, {
-      title: 'Custom Interactive Element',
-      code: "import { Focusable } from '@atlaskit/primitives/compiled';\n\n<Focusable as=\"div\" onClick={handleClick} onKeyDown={handleKeyDown}>\n  Interactive content\n</Focusable>"
-    }],
-    bestPractices: ['Never disable buttons without providing alternatives', 'Use VisuallyHidden for screen reader text', 'Test with keyboard navigation only', 'Ensure focus indicators meet contrast requirements']
-  },
-  forms: {
-    title: 'Form and Input Accessibility',
-    description: 'Guidelines for making forms and inputs accessible',
-    guidelines: ['Use TextField component for consistent labeling', 'Associate labels with inputs using id and htmlFor', 'Provide clear error messages with aria-describedby', 'Use MessageWrapper for form validation announcements', 'Use aria-required for required fields', 'Group related form elements with fieldset and legend'],
-    codeExamples: [{
-      title: 'Accessible Text Field',
-      code: "import { TextField } from '@atlaskit/textfield';\n\n<TextField\n  label=\"Email address\"\n  isRequired\n  aria-describedby=\"email-help\"\n  id=\"email-input\"\n/>\n<div id=\"email-help\">Enter your work email address</div>"
-    }, {
-      title: 'Form Validation with Error Messages',
-      code: "import { TextField } from '@atlaskit/textfield';\n\n<TextField\n  label=\"Password\"\n  isInvalid\n  aria-invalid=\"true\"\n  aria-describedby=\"password-error\"\n/>\n<div id=\"password-error\" role=\"alert\">\n  Password must be at least 8 characters long\n</div>"
-    }],
-    bestPractices: ['Never rely on placeholder text for critical information', 'Provide helpful error messages and descriptions', 'Use proper form validation with aria-invalid', 'Test form completion with screen readers']
-  },
-  images: {
-    title: 'Image and Media Accessibility',
-    description: 'Guidelines for making images and media accessible',
-    guidelines: ['Use Image component with proper alt text', 'Keep alt text under 125 characters', 'Leave alt="" for decorative images', 'Describe the purpose, not just the content', 'Don\'t start with "Image of..." or "Picture of..."', 'Provide detailed descriptions for complex images'],
-    codeExamples: [{
-      title: 'Decorative Image',
-      code: "import { Image } from '@atlaskit/image';\n\n<Image src=\"decorative.jpg\" alt=\"\" />"
-    }, {
-      title: 'Informative Image',
-      code: "import { Image } from '@atlaskit/image';\n\n<Image\n  src=\"chart.png\"\n  alt=\"Bar chart showing Q4 sales increased 25% over Q3\"\n/>"
-    }, {
-      title: 'Complex Image with Description',
-      code: "import { Image } from '@atlaskit/image';\n\n<Image\n  src=\"complex-diagram.png\"\n  alt=\"\"\n  aria-describedby=\"diagram-description\"\n/>\n<div id=\"diagram-description\">\n  Detailed description of the diagram content...\n</div>"
-    }],
-    bestPractices: ['For important information, use text instead of images', 'Avoid images of text', 'Provide alternative formats for complex visual content', 'Test with screen readers to ensure proper announcement']
-  },
-  colors: {
-    title: 'Color and Contrast Accessibility',
-    description: 'Guidelines for using colors accessibly',
-    guidelines: ['Use design tokens for consistent contrast ratios', 'Never rely on color alone for information', 'Use color.text tokens for proper contrast', 'Test with high contrast mode', 'Ensure 4.5:1 contrast ratio for normal text', 'Ensure 3:1 contrast ratio for large text'],
-    codeExamples: [{
-      title: 'Using Design Tokens for Colors',
-      code: "import { token } from '@atlaskit/tokens';\n\nconst styles = css({\n  color: token('color.text'),\n  backgroundColor: token('color.background.neutral'),\n});"
-    }, {
-      title: 'Text Component with Color',
-      code: "import { Text } from '@atlaskit/primitives/compiled';\n\n<Text color=\"color.text.danger\">Error message</Text>\n<Text color=\"color.text.success\">Success message</Text>"
-    }],
-    bestPractices: ['Use color.text tokens for primary text', 'Use color.text.subtle sparingly for secondary text', 'Avoid color.text.disabled for critical information', 'Test with different color vision types']
-  },
-  focus: {
-    title: 'Focus Management',
-    description: 'Guidelines for proper focus management',
-    guidelines: ['Ensure logical tab order', 'Provide visible focus indicators', 'Handle focus trapping in modals', 'Return focus when dialogs close', 'Use Focusable component for custom elements', 'Manage focus in dynamic content'],
-    codeExamples: [{
-      title: 'Focus Management in Modal',
-      code: "import { useRef, useEffect } from 'react';\n\nconst modalRef = useRef<HTMLDivElement>(null);\n\nuseEffect(() => {\n  if (isOpen && modalRef.current) {\n    modalRef.current.focus();\n  }\n}, [isOpen]);"
-    }, {
-      title: 'Custom Focusable Element',
-      code: "import { Focusable } from '@atlaskit/primitives/compiled';\n\n<Focusable\n  as=\"div\"\n  tabIndex={0}\n  onKeyDown={(e) => {\n    if (e.key === 'Enter' || e.key === ' ') {\n      handleActivate();\n    }\n  }}\n>\n  Custom focusable element\n</Focusable>"
-    }],
-    bestPractices: ['Test focus order with keyboard navigation', 'Ensure focus indicators are visible in all themes', 'Handle focus restoration when components unmount', 'Use focus trapping for modal dialogs']
-  },
-  keyboard: {
-    title: 'Keyboard Accessibility',
-    description: 'Guidelines for keyboard accessibility',
-    guidelines: ['Support standard keyboard interactions', 'Use Enter and Space for activation', 'Use Escape for closing/canceling', 'Support arrow keys for navigation', 'Provide keyboard shortcuts for power users', 'Ensure all interactive elements are keyboard accessible'],
-    codeExamples: [{
-      title: 'Keyboard Event Handling',
-      code: "const handleKeyDown = (event: KeyboardEvent) => {\n  switch (event.key) {\n    case 'Enter':\n    case ' ':\n      handleActivate();\n      break;\n    case 'Escape':\n      handleClose();\n      break;\n    case 'Tab':\n      // Handle focus management\n      break;\n  }\n};"
-    }],
-    bestPractices: ['Test with keyboard navigation only', 'Ensure logical tab order', 'Provide keyboard alternatives for mouse interactions', 'Support both Enter and Space for activation']
-  },
-  screenReaders: {
-    title: 'Screen Reader Support',
-    description: 'Guidelines for screen reader accessibility',
-    guidelines: ['Use Announcer component for dynamic content', 'Provide skip links for keyboard users', 'Use proper heading hierarchy', 'Use semantic HTML elements', 'Provide live regions for status updates', 'Use VisuallyHidden for screen reader text'],
-    codeExamples: [{
-      title: 'Screen Reader Announcements',
-      code: "import { Announcer } from '@atlaskit/announcer';\n\n<Announcer\n  message={`${count} items selected`}\n  liveMode=\"polite\"\n  shouldAnnounce={true}\n/>"
-    }, {
-      title: 'Skip Links',
-      code: "<a href=\"#main-content\" className=\"skip-link\">\n  Skip to main content\n</a>"
-    }],
-    bestPractices: ['Test with multiple screen readers (NVDA, JAWS, VoiceOver)', 'Use aria-live="polite" for status updates', 'Use aria-live="assertive" for critical alerts', 'Avoid announcing the same message repeatedly']
-  },
-  aria: {
-    title: 'ARIA Usage Guidelines',
-    description: 'Guidelines for using ARIA attributes',
-    guidelines: ['Use ARIA sparingly - prefer semantic HTML', 'Use proper ARIA roles and states', 'Provide live regions for dynamic content', 'Use landmarks for page structure', 'Ensure ARIA attributes are supported', 'Test ARIA implementations with screen readers'],
-    codeExamples: [{
-      title: 'Live Region for Status Updates',
-      code: "<div aria-live=\"polite\" role=\"status\">\n  {statusMessage}\n</div>"
-    }, {
-      title: 'Landmark Navigation',
-      code: "<nav role=\"navigation\" aria-label=\"Main navigation\">\n  Navigation content\n</nav>"
-    }],
-    bestPractices: ['Use semantic HTML elements when possible', 'Test ARIA implementations thoroughly', 'Keep ARIA usage simple and clear', 'Document custom ARIA patterns']
-  },
-  wcag: {
-    title: 'WCAG Compliance',
-    description: 'WCAG 2.1 AA compliance guidelines',
-    guidelines: ['Ensure information is perceivable', 'Make interface components operable', 'Ensure information is understandable', 'Make content robust and compatible', 'Test with multiple assistive technologies', 'Follow WCAG 2.1 AA success criteria'],
-    codeExamples: [{
-      title: 'WCAG Compliant Component',
-      code: "// Example of a WCAG compliant button\n<Focusable\n  as=\"button\"\n  aria-label=\"Save changes\"\n  onClick={handleSave}\n  onKeyDown={handleKeyDown}\n>\n  <SaveIcon />\n  <VisuallyHidden>Save changes</VisuallyHidden>\n</Focusable>"
-    }],
-    bestPractices: ['Test with automated accessibility tools', 'Conduct manual accessibility testing', 'Test with users who have disabilities', 'Document accessibility compliance']
-  },
-  general: {
-    title: 'General Accessibility Principles',
-    description: 'General accessibility principles and best practices',
-    guidelines: ['Design for people, not just compliance', 'Consider accessibility from the start', 'Test with real users and assistive technologies', 'Provide multiple ways to accomplish tasks', 'Use inclusive design principles', 'Test with different abilities and technologies'],
-    codeExamples: [{
-      title: 'Inclusive Design Example',
-      code: "// Component that works for everyone\n<Focusable\n  as=\"button\"\n  onClick={handleAction}\n  aria-label=\"Clear form data\"\n  onKeyDown={handleKeyDown}\n>\n  <TrashIcon />\n  <VisuallyHidden>Clear all form data</VisuallyHidden>\n</Focusable>"
-    }],
-    bestPractices: ['Start with semantic HTML', 'Add ARIA when necessary', 'Test early and often', 'Involve users with disabilities in testing', 'Keep accessibility in mind throughout development']
-  }
-};
 var getA11yGuidelinesTool = exports.getA11yGuidelinesTool = /*#__PURE__*/function () {
-  var _ref = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(params) {
-    var topic, component, guidelines;
+  var _ref2 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(_ref) {
+    var topic, guidelines;
     return _regenerator.default.wrap(function _callee$(_context) {
       while (1) switch (_context.prev = _context.next) {
         case 0:
-          topic = params.topic, component = params.component;
-          if (!(topic && accessibilityGuidelines[topic])) {
+          topic = _ref.topic;
+          if (!(topic && _guidelines.accessibilityGuidelines[topic])) {
             _context.next = 4;
             break;
           }
-          guidelines = accessibilityGuidelines[topic];
+          guidelines = _guidelines.accessibilityGuidelines[topic];
           return _context.abrupt("return", {
             content: [{
               type: 'text',
               text: JSON.stringify(_objectSpread(_objectSpread({
-                topic: topic,
-                component: component
+                topic: topic
               }, guidelines), {}, {
                 additionalResources: ['https://atlassian.design/llms-a11y.txt - Complete ADS accessibility documentation', 'https://atlassian.design/foundations/accessibility - ADS accessibility foundation', 'https://www.w3.org/WAI/WCAG21/quickref/ - WCAG 2.1 guidelines']
               }), null, 2)
@@ -184,10 +56,9 @@ var getA11yGuidelinesTool = exports.getA11yGuidelinesTool = /*#__PURE__*/functio
             content: [{
               type: 'text',
               text: JSON.stringify({
-                availableTopics: Object.keys(accessibilityGuidelines),
-                component: component,
+                availableTopics: topics,
                 message: 'Specify a topic to get detailed guidelines, or use "general" for overview',
-                guidelines: accessibilityGuidelines,
+                guidelines: _guidelines.accessibilityGuidelines,
                 additionalResources: ['https://atlassian.design/llms-a11y.txt - Complete ADS accessibility documentation', 'https://atlassian.design/foundations/accessibility - ADS accessibility foundation']
               }, null, 2)
             }]
@@ -199,6 +70,6 @@ var getA11yGuidelinesTool = exports.getA11yGuidelinesTool = /*#__PURE__*/functio
     }, _callee);
   }));
   return function getA11yGuidelinesTool(_x) {
-    return _ref.apply(this, arguments);
+    return _ref2.apply(this, arguments);
   };
 }();

package/dist/cjs/tools/get-all-icons/index.js

@@ -8,8 +8,9 @@ exports.listGetAllIconsTool = exports.getAllIconsTool = 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"));
+var _zod = require("zod");
+var _zodToJsonSchema = require("zod-to-json-schema");
 var _metadata = require("@atlaskit/icon/metadata");
-var _schema = require("../../schema");
 var icons = Object.entries(_metadata.coreIconMetadata).map(function (_ref) {
   var _ref2 = (0, _slicedToArray2.default)(_ref, 2),
     _key = _ref2[0],
@@ -27,15 +28,15 @@ var icons = Object.entries(_metadata.coreIconMetadata).map(function (_ref) {
 });
 var listGetAllIconsTool = exports.listGetAllIconsTool = {
   name: 'ads_get_all_icons',
-  description: "You SHOULD call this when you need complete guidance on what icons to use, but you SHOULD use the `ads_search_icons` tool to find specific icons instead.\nThese are the only icons to be used in modern code, though other legacy icons may still be found, these are not to be used by you, but you can keep them if you see them in existing code.\nThe resulting icon name and package is often like this:\n```tsx\nimport AddIcon from '@atlaskit/icon/core/add';\n\n// Usage in isolation\n<AddIcon label=\"Add\" />\n\n// Usage with a button\nimport Button from '@atlaskit/button/new';\n<Button iconAfter={AddIcon}>Create</Button>\n```\n",
+  description: "Fetch all Atlassian Design System icons. Only use when `ads_search_icons` does not return what you're looking for.",
   annotations: {
-    title: 'Get ADS icons',
+    title: 'Get all ADS icons',
     readOnlyHint: true,
     destructiveHint: false,
     idempotentHint: true,
     openWorldHint: true
   },
-  inputSchema: _schema.emptyInputSchema
+  inputSchema: (0, _zodToJsonSchema.zodToJsonSchema)(_zod.z.object({}))
 };
 var getAllIconsTool = exports.getAllIconsTool = /*#__PURE__*/function () {
   var _ref3 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee() {

package/dist/cjs/tools/get-all-tokens/index.js

@@ -13,7 +13,7 @@ var _tokenMetadata = require("@atlaskit/tokens/token-metadata");
 var inputSchema = _zod.z.object({});
 var listGetAllTokensTool = exports.listGetAllTokensTool = {
   name: 'ads_get_all_tokens',
-  description: "You SHOULD call this when you need complete guidance on what tokens to use, but you SHOULD use the `ads_search_tokens` tool to find specific tokens instead.\n\tThese tokens are used in place of hardcoded values; you should never use a hardcoded value where a token value is appropriate.\n\tThe resulting token name is used inside of the `token()` function, eg.:\n\t```tsx\n\timport { token } from '@atlaskit/tokens';\n\tconst styles = css({ color: token('color.text') });\n\t```\n\t",
+  description: "Fetch all Atlassian Design System tokens. Only use when `ads_search_tokens` does not return what you're looking for.",
   annotations: {
     title: 'Get all ADS tokens',
     readOnlyHint: true,