@atlaskit/ads-mcp 0.18.0 → 0.19.0

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

@@ -1,19 +1,19 @@
+import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
 import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
 import _regeneratorRuntime from "@babel/runtime/regenerator";
 /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
 
 import Fuse from 'fuse.js';
 import { z } from 'zod';
-import { cleanQuery, zodToJsonSchema } from '../../helpers';
-import { loadAllComponents } from '../get-components/load-all-components';
+import { cleanQuery, mergeMultiTermFuseResults, zodToJsonSchema } from '../../helpers';
+import { loadAllComponents } from '../get-all-components/load-all-components';
 export var searchComponentsInputSchema = z.object({
-  terms: z.array(z.string()).describe('An array of search terms to find components by name, package name, description, or example, eg. `["button", "input", "select"]`'),
-  limit: z.number().default(1).describe('Maximum number of results per search term in the array (default: 1)').optional(),
-  exactName: 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()
+  terms: z.array(z.string()).describe('Required: one or more search terms (fuzzy over name, package, category, description, keywords, examples). Example: `["button", "modal", "select"]`.'),
+  limit: z.number().default(2).describe('Max matches **per term** (default 2).').optional()
 });
 export var listSearchComponentsTool = {
   name: 'ads_search_components',
-  description: 'Search for Atlassian Design System components.',
+  description: "Searches the bundled Atlassian Design System (ADS) component catalog. Returns JSON objects with **name**, **package**, **examples**, and **props** for each match (trimmed payload).\n\nWHEN TO USE:\n**Selecting which ADS component to use**\u2014package name, examples, and props\u2014before implementation. Use when composing a new view or swapping a primitive. Prefer `ads_plan` when you also need token and icon discovery in one shot.",
   annotations: {
     title: 'Search ADS components',
     readOnlyHint: true,
@@ -23,9 +23,7 @@ export var listSearchComponentsTool = {
   },
   inputSchema: zodToJsonSchema(searchComponentsInputSchema)
 };
-
-// Clean component result to only return name, package name, example, and props
-var cleanComponentResult = function cleanComponentResult(result) {
+var buildComponentResult = function buildComponentResult(result) {
   return {
     name: result.name,
     package: result.package,
@@ -34,52 +32,29 @@ var cleanComponentResult = function cleanComponentResult(result) {
   };
 };
 export var searchComponentsTool = /*#__PURE__*/function () {
-  var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(params) {
-    var terms, _params$limit, limit, _params$exactName, exactName, searchTerms, components, exactNameMatches, fuse, results, uniqueResults;
+  var _ref2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(_ref) {
+    var terms, _ref$limit, limit, searchTerms, components, fuse, matchedItems;
     return _regeneratorRuntime.wrap(function _callee$(_context) {
       while (1) switch (_context.prev = _context.next) {
         case 0:
-          terms = params.terms, _params$limit = params.limit, limit = _params$limit === void 0 ? 1 : _params$limit, _params$exactName = params.exactName, exactName = _params$exactName === void 0 ? false : _params$exactName;
-          searchTerms = terms.filter(Boolean).map(cleanQuery);
+          terms = _ref.terms, _ref$limit = _ref.limit, limit = _ref$limit === void 0 ? 2 : _ref$limit;
+          searchTerms = _toConsumableArray(new Set(terms.filter(Boolean).map(cleanQuery)));
           if (searchTerms.length) {
             _context.next = 4;
             break;
           }
           return _context.abrupt("return", {
-            isError: true,
             content: [{
               type: 'text',
-              text: "Error: Required parameter 'terms' is missing or empty"
+              text: '[]'
             }]
           });
         case 4:
           components = loadAllComponents();
-          if (!exactName) {
-            _context.next = 9;
-            break;
-          }
-          // for each search term, search for the exact match
-          exactNameMatches = searchTerms.map(function (term) {
-            return components.find(function (component) {
-              return component.name.toLowerCase() === term.toLowerCase();
-            });
-          }).filter(Boolean);
-          if (!(exactNameMatches.length > 0)) {
-            _context.next = 9;
-            break;
-          }
-          return _context.abrupt("return", {
-            content: [{
-              type: 'text',
-              text: JSON.stringify(exactNameMatches.map(cleanComponentResult))
-            }]
-          });
-        case 9:
-          // use Fuse.js to fuzzy-search through the components
           fuse = new Fuse(components, {
             keys: [{
               name: 'name',
-              weight: 3
+              weight: 5
             }, {
               name: 'package',
               weight: 3
@@ -89,30 +64,42 @@ export var searchComponentsTool = /*#__PURE__*/function () {
             }, {
               name: 'description',
               weight: 2
+            }, {
+              name: 'keywords',
+              weight: 2
+            }, {
+              name: 'usageGuidelines',
+              weight: 2
+            }, {
+              name: 'contentGuidelines',
+              weight: 1
+            }, {
+              name: 'accessibilityGuidelines',
+              weight: 1
             }, {
               name: 'examples',
               weight: 1
             }],
-            threshold: 0.4
-          }); // every search term, search for the results
-          results = searchTerms.map(function (term) {
-            // always search exact match from the components first
-            var exactNameMatch = components.find(function (component) {
-              return component.name.toLowerCase() === term.toLowerCase();
-            });
-            if (exactNameMatch) {
-              return [{
-                item: exactNameMatch
-              }];
+            threshold: 0.4,
+            distance: 80,
+            minMatchCharLength: 3,
+            ignoreFieldNorm: true,
+            includeScore: true
+          });
+          matchedItems = mergeMultiTermFuseResults({
+            searchTerms: searchTerms,
+            limit: limit,
+            search: function search(query) {
+              return fuse.search(query, {
+                limit: limit * searchTerms.length
+              });
             }
-            return fuse.search(term).slice(0, limit);
-          }).flat();
-          if (results.length) {
-            _context.next = 13;
+          });
+          if (matchedItems.length) {
+            _context.next = 9;
             break;
           }
           return _context.abrupt("return", {
-            isError: true,
             content: [{
               type: 'text',
               text: "Error: No components found for '".concat(terms.join(', '), "'. Available components: ").concat(components.map(function (c) {
@@ -120,28 +107,20 @@ export var searchComponentsTool = /*#__PURE__*/function () {
               }).join(', '))
             }]
           });
-        case 13:
-          // Remove duplicates based on component name
-          uniqueResults = results.filter(function (result, index, arr) {
-            return arr.findIndex(function (r) {
-              return r.item.name === result.item.name;
-            }) === index;
-          });
+        case 9:
           return _context.abrupt("return", {
             content: [{
               type: 'text',
-              text: JSON.stringify(uniqueResults.map(function (result) {
-                return result.item;
-              }).map(cleanComponentResult))
+              text: JSON.stringify(matchedItems.map(buildComponentResult))
             }]
           });
-        case 15:
+        case 10:
         case "end":
           return _context.stop();
       }
     }, _callee);
   }));
   return function searchComponentsTool(_x) {
-    return _ref.apply(this, arguments);
+    return _ref2.apply(this, arguments);
   };
 }();

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

@@ -1,19 +1,26 @@
+import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
 import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
 import _regeneratorRuntime from "@babel/runtime/regenerator";
 /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
 
 import Fuse from 'fuse.js';
 import { z } from 'zod';
-import { cleanQuery, zodToJsonSchema } from '../../helpers';
+import { cleanQuery, mergeMultiTermFuseResults, zodToJsonSchema } from '../../helpers';
 import { icons } from '../get-all-icons/icons';
 export var searchIconsInputSchema = z.object({
-  terms: z.array(z.string()).describe('An array of search terms to find icons by name, keywords, or categorization, eg. `["search", "folder", "user"]`'),
-  limit: z.number().default(1).describe('Maximum number of results per search term in the array (default: 1)').optional(),
-  exactName: 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()
+  terms: z.array(z.string()).describe('Required: one or more terms; fuzzy match on icon **componentName**, **iconName**, **keywords**, **categorization**, **type**, and **usage**. Example: `["search", "folder", "user"]`.'),
+  limit: z.number().default(2).describe('Max matches **per term** (default 2).').optional()
 });
+var buildIconResult = function buildIconResult(icon) {
+  return {
+    componentName: icon.componentName,
+    package: icon.package,
+    usage: icon.usage
+  };
+};
 export var listSearchIconsTool = {
   name: 'ads_search_icons',
-  description: "Search for Atlassian Design System icons.\n\nExample icon usage:\n```tsx\nimport AddIcon from '@atlaskit/icon/core/add';\n<AddIcon label=\"Add work item\" size=\"small\" />\n```",
+  description: "Searches the bundled Atlassian Design System **icon** catalog. Returns JSON with **componentName**, **package**, and **usage** for each match.\n\nWHEN TO USE:\n**Choosing an icon** for a control, nav item, empty state, or illustration\u2014find `@atlaskit/icon` import paths and usage notes. Prefer `ads_plan` when you also need tokens and components together.\n\nExample:\n```tsx\nimport AddIcon from '@atlaskit/icon/core/add';\n<AddIcon label=\"Add work item\" size=\"small\" />\n```",
   annotations: {
     title: 'Search ADS icons',
     readOnlyHint: true,
@@ -24,51 +31,28 @@ export var listSearchIconsTool = {
   inputSchema: zodToJsonSchema(searchIconsInputSchema)
 };
 export var searchIconsTool = /*#__PURE__*/function () {
-  var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(params) {
-    var terms, _params$limit, limit, _params$exactName, exactName, searchTerms, exactNameMatches, fuse, results, uniqueResults, matchedIcons;
+  var _ref2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(_ref) {
+    var terms, _ref$limit, limit, searchTerms, fuse, matchedItems;
     return _regeneratorRuntime.wrap(function _callee$(_context) {
       while (1) switch (_context.prev = _context.next) {
         case 0:
-          terms = params.terms, _params$limit = params.limit, limit = _params$limit === void 0 ? 1 : _params$limit, _params$exactName = params.exactName, exactName = _params$exactName === void 0 ? false : _params$exactName;
-          searchTerms = terms.filter(Boolean).map(cleanQuery);
+          terms = _ref.terms, _ref$limit = _ref.limit, limit = _ref$limit === void 0 ? 2 : _ref$limit;
+          searchTerms = _toConsumableArray(new Set(terms.filter(Boolean).map(cleanQuery)));
           if (searchTerms.length) {
             _context.next = 4;
             break;
           }
           return _context.abrupt("return", {
-            isError: true,
             content: [{
               type: 'text',
-              text: "Error: Required parameter 'terms' is missing or empty"
+              text: '[]'
             }]
           });
         case 4:
-          if (!exactName) {
-            _context.next = 8;
-            break;
-          }
-          // for each search term, search for the exact match
-          exactNameMatches = searchTerms.map(function (term) {
-            return icons.find(function (icon) {
-              return icon.componentName.toLowerCase() === term.toLowerCase();
-            });
-          }).filter(Boolean);
-          if (!(exactNameMatches.length > 0)) {
-            _context.next = 8;
-            break;
-          }
-          return _context.abrupt("return", {
-            content: [{
-              type: 'text',
-              text: JSON.stringify(exactNameMatches)
-            }]
-          });
-        case 8:
-          // use Fuse.js to fuzzy-search through the icons
           fuse = new Fuse(icons, {
             keys: [{
               name: 'componentName',
-              weight: 3
+              weight: 5
             }, {
               name: 'iconName',
               weight: 3
@@ -77,34 +61,37 @@ export var searchIconsTool = /*#__PURE__*/function () {
               weight: 2
             }, {
               name: 'categorization',
-              weight: 1
+              weight: 2
             }, {
               name: 'type',
               weight: 1
             }, {
               name: 'usage',
-              weight: 1
+              weight: 2
             }],
-            threshold: 0.4
-          }); // every search term, search for the results
-          results = searchTerms.map(function (term) {
-            // always search exact match from the icons
-            var exactNameMatch = icons.find(function (icon) {
-              return icon.componentName.toLowerCase() === term.toLowerCase();
-            });
-            if (exactNameMatch) {
-              return [{
-                item: exactNameMatch
-              }];
+            threshold: 0.4,
+            distance: 80,
+            minMatchCharLength: 3,
+            ignoreFieldNorm: true,
+            includeScore: true
+          });
+          matchedItems = mergeMultiTermFuseResults({
+            searchTerms: searchTerms,
+            limit: limit,
+            search: function search(query) {
+              return fuse.search(query, {
+                limit: limit * searchTerms.length
+              });
+            },
+            tokenKey: function tokenKey(icon) {
+              return icon.componentName;
             }
-            return fuse.search(term).slice(0, limit);
-          }).flat();
-          if (results.length) {
-            _context.next = 12;
+          });
+          if (matchedItems.length) {
+            _context.next = 8;
             break;
           }
           return _context.abrupt("return", {
-            isError: true,
             content: [{
               type: 'text',
               text: "Error: No icons found for '".concat(terms.join(', '), "'. Available icons: ").concat(icons.map(function (i) {
@@ -112,33 +99,20 @@ export var searchIconsTool = /*#__PURE__*/function () {
               }).join(', '))
             }]
           });
-        case 12:
-          // Remove duplicates based on componentName
-          uniqueResults = results.filter(function (result, index, arr) {
-            return arr.findIndex(function (r) {
-              return r.item.componentName === result.item.componentName;
-            }) === index;
-          });
-          matchedIcons = uniqueResults.map(function (result) {
-            return {
-              componentName: result.item.componentName,
-              package: result.item.package,
-              usage: result.item.usage
-            };
-          });
+        case 8:
           return _context.abrupt("return", {
             content: [{
               type: 'text',
-              text: JSON.stringify(matchedIcons)
+              text: JSON.stringify(matchedItems.map(buildIconResult))
             }]
           });
-        case 15:
+        case 9:
         case "end":
           return _context.stop();
       }
     }, _callee);
   }));
   return function searchIconsTool(_x) {
-    return _ref.apply(this, arguments);
+    return _ref2.apply(this, arguments);
   };
 }();

package/dist/esm/tools/search-tokens/index.js

@@ -1,3 +1,4 @@
+import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
 import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
 import _regeneratorRuntime from "@babel/runtime/regenerator";
 /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
@@ -5,15 +6,14 @@ import _regeneratorRuntime from "@babel/runtime/regenerator";
 import Fuse from 'fuse.js';
 import { z } from 'zod';
 import { tokens } from '@atlaskit/tokens/token-metadata';
-import { cleanQuery, zodToJsonSchema } from '../../helpers';
+import { cleanQuery, mergeMultiTermFuseResults, zodToJsonSchema } from '../../helpers';
 export var searchTokensInputSchema = z.object({
-  terms: z.array(z.string()).describe('An array of search terms to find tokens by name or description, eg. `["spacing", "inverted text", "background primary"]`'),
-  limit: z.number().default(1).describe('Maximum number of results per search term in the array (default: 1)').optional(),
-  exactName: z.boolean().default(false).describe('Enable to explicitly search tokens by the exact name match (when you know the name, but need more details)').optional()
+  terms: z.array(z.string()).describe('Required: one or more terms; fuzzy match on token **name**, **description**, **exampleValue**, **usageGuidelines.usage**, and **usageGuidelines.cssProperties**. Example: `["spacing", "color.text", "background"]`.'),
+  limit: z.number().default(2).describe('Max matches **per term** (default 2).').optional()
 });
 export var listSearchTokensTool = {
   name: 'ads_search_tokens',
-  description: "Search for Atlassian Design System tokens.\n\nExample token usage:\n```tsx\nimport { token } from '@atlaskit/tokens';\nconst styles = css({ color: token('color.text'), padding: token('space.100') });\n```",
+  description: "Searches Atlassian Design System **design tokens** from bundled metadata. Returns JSON objects with **name** and **exampleValue** for each match (search also considers description, usage guidelines, and CSS property hints in metadata).\n\nWHEN TO USE:\n**Styling or theming in code**\u2014you need the right `token('\u2026')` names for colors, space, typography, etc. Use during layout and visual work when tokens must match ADS. Prefer `ads_plan` when you also need icons and components in the same step.\n\nExample:\n```tsx\nimport { token } from '@atlaskit/tokens';\nconst styles = css({ color: token('color.text'), padding: token('space.100') });\n```",
   annotations: {
     title: 'Search ADS tokens',
     readOnlyHint: true,
@@ -24,80 +24,93 @@ export var listSearchTokensTool = {
   inputSchema: zodToJsonSchema(searchTokensInputSchema)
 };
 export var searchTokensTool = /*#__PURE__*/function () {
-  var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(params) {
-    var terms, _params$limit, limit, _params$exactName, exactName, searchTerms, exactNameMatches, fuse, results, uniqueResults, matchedTokens;
+  var _ref2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(_ref) {
+    var terms, _ref$limit, limit, searchTerms, fuse, matchedItems, matchedTokens;
     return _regeneratorRuntime.wrap(function _callee$(_context) {
       while (1) switch (_context.prev = _context.next) {
         case 0:
-          terms = params.terms, _params$limit = params.limit, limit = _params$limit === void 0 ? 1 : _params$limit, _params$exactName = params.exactName, exactName = _params$exactName === void 0 ? false : _params$exactName;
-          searchTerms = terms.filter(Boolean).map(cleanQuery);
-          if (!exactName) {
-            _context.next = 6;
-            break;
-          }
-          // for each search term, search for the exact match
-          exactNameMatches = searchTerms.map(function (term) {
-            return tokens.find(function (token) {
-              return token.name.toLowerCase() === term.toLowerCase();
-            });
-          }).filter(Boolean);
-          if (!(exactNameMatches.length > 0)) {
-            _context.next = 6;
+          terms = _ref.terms, _ref$limit = _ref.limit, limit = _ref$limit === void 0 ? 2 : _ref$limit;
+          // Unique cleaned terms (order preserved) so duplicates don't concatenate into a bogus query.
+          searchTerms = _toConsumableArray(new Set(terms.filter(Boolean).map(cleanQuery)));
+          if (searchTerms.length) {
+            _context.next = 4;
             break;
           }
           return _context.abrupt("return", {
             content: [{
               type: 'text',
-              text: JSON.stringify(exactNameMatches.map(function (token) {
-                return {
-                  name: token.name,
-                  exampleValue: token.exampleValue
-                };
-              }))
+              text: '[]'
             }]
           });
-        case 6:
-          // use Fuse.js to fuzzy-search for the tokens
+        case 4:
           fuse = new Fuse(tokens, {
             keys: [{
               name: 'name',
-              weight: 3
+              weight: 5
+            }, {
+              name: 'path',
+              weight: 2
             }, {
               name: 'description',
               weight: 2
+            }, {
+              name: 'usageGuidelines.usage',
+              weight: 2
+            }, {
+              name: 'usageGuidelines.cssProperties',
+              weight: 3
             }, {
               name: 'exampleValue',
-              weight: 1
+              weight: 0.5
             }],
-            threshold: 0.4
+            threshold: 0.4,
+            distance: 80,
+            minMatchCharLength: 3,
+            ignoreFieldNorm: true,
+            includeScore: true
           });
-          results = searchTerms.map(function (term) {
-            return fuse.search(term).slice(0, limit);
-          }).flat(); // Remove duplicates based on token name
-          uniqueResults = results.filter(function (result, index, arr) {
-            return arr.findIndex(function (r) {
-              return r.item.name === result.item.name;
-            }) === index;
+          matchedItems = mergeMultiTermFuseResults({
+            searchTerms: searchTerms,
+            limit: limit,
+            search: function search(query) {
+              return fuse.search(query, {
+                limit: limit * searchTerms.length
+              });
+            },
+            searchTermsJoin: '.'
           });
-          matchedTokens = uniqueResults.map(function (result) {
+          matchedTokens = matchedItems.map(function (item) {
             return {
-              name: result.item.name,
-              exampleValue: result.item.exampleValue
+              name: item.name,
+              exampleValue: item.exampleValue
             };
           });
+          if (matchedTokens.length) {
+            _context.next = 9;
+            break;
+          }
+          return _context.abrupt("return", {
+            content: [{
+              type: 'text',
+              text: "Error: No tokens found for '".concat(terms.join(', '), "'. Available tokens: ").concat(tokens.map(function (t) {
+                return t.name;
+              }).join(', '))
+            }]
+          });
+        case 9:
           return _context.abrupt("return", {
             content: [{
               type: 'text',
               text: JSON.stringify(matchedTokens)
             }]
           });
-        case 11:
+        case 10:
         case "end":
           return _context.stop();
       }
     }, _callee);
   }));
   return function searchTokensTool(_x) {
-    return _ref.apply(this, arguments);
+    return _ref2.apply(this, arguments);
   };
 }();

package/dist/esm/tools/suggest-a11y-fixes/index.js

@@ -14,16 +14,16 @@ import { zodToJsonSchema } from '../../helpers';
 import { accessibilityFixes } from './fixes';
 import { violationKeywords } from './keywords';
 export var suggestA11yFixesInputSchema = z.object({
-  violation: z.string().describe('Description of the accessibility violation'),
-  code: z.string().describe('The problematic code that needs fixing'),
-  component: z.string().optional().describe('Component name or type'),
-  context: z.string().optional().describe('Additional context about the usage')
+  violation: z.string().describe('Human-readable description of the issue (e.g. axe rule help text, "button has no accessible name", "missing alt"). Used to match curated recipes when possible; otherwise the tool falls back to generic guidance.'),
+  code: z.string().describe('Snippet of the problematic code or markup so the response can be tailored (may be shown in the output for traceability).'),
+  component: z.string().optional().describe('Optional: React component name involved (e.g. `Button`, `TextField`)—may be ADS or app-specific.'),
+  context: z.string().optional().describe('Optional: where this appears (e.g. modal, table row, page section) or constraints.')
 });
 export var listSuggestA11yFixesTool = {
   name: 'ads_suggest_a11y_fixes',
-  description: "Suggests specific accessibility fixes using Atlassian Design System components and patterns.",
+  description: "Suggests remediation steps for an accessibility issue described in natural language (often pasted from **axe-core**, ESLint, or review).\n\nWHAT YOU GET (varies by match):\n- **Curated hit:** ADS-biased examples and patterns from this server\u2019s recipe map (components, tokens, common fixes).\n- **No strong match:** Generic guidance (e.g. \u201Cuse ADS components\u201D, labeling, testing)\u2014still useful, but **not** guaranteed to be ADS-specific. May reference axe/atlassian.design resources.\n\nWHEN TO USE:\nAfter `ads_analyze_a11y` or `ads_analyze_localhost_a11y`, or whenever you have a violation string. For **topic-level** Atlassian Design System accessibility guidance, call `ads_get_a11y_guidelines` (this tool is fix-oriented, not a full guideline browse).\n\nDoes not replace manual testing with assistive technologies or keyboard-only navigation.",
   annotations: {
-    title: 'Suggest Accessibility Fixes',
+    title: 'Suggest accessibility fixes',
     readOnlyHint: true,
     destructiveHint: false,
     idempotentHint: true,
@@ -164,7 +164,7 @@ export var suggestA11yFixesTool = /*#__PURE__*/function () {
                 availableFixTypes: Object.keys(accessibilityFixes),
                 suggestions: ['Try describing the issue with keywords like: button, label, missing, text, color, contrast, focus, etc.', 'Use axe-core violation IDs or descriptions directly', 'Be more specific about the element type (button, input, image, etc.)'],
                 additionalResources: ['https://atlassian.design/llms-a11y.txt - Complete ADS accessibility documentation', 'https://atlassian.design/foundations/accessibility - ADS accessibility foundation'],
-                recommendation: 'Try the get_a11y_guidelines tool for component-specific guidance'
+                recommendation: 'Try the ads_get_a11y_guidelines tool for component-specific guidance'
               }, null, 2)
             }]
           });

package/dist/types/helpers/fuse-multi-term.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Allocation for multi-query Fuse search: each term alone, plus one spaced combined query.
+ *
+ * `poolMax = limit * termCount`. From each term we take up to `perTermTake` hits; the rest of the
+ * pool is filled from the spaced combined query.
+ */
+export declare function computeMultiTermFuseAllocation(limit: number, termCount: number): {
+    /**
+     * The amount token by each term, minimum of 1.
+     */
+    perTermTake: number;
+    /**
+     * Hits to take from the spaced combined query.
+     */
+    combinedTake: number;
+    /**
+     * The total amount of hits to take, minimum of 1.
+     */
+    totalTake: number;
+};
+export type FuseHit<T> = {
+    item: T;
+    /**
+     * Fuse score when `includeScore` is enabled; lower is a better match.
+     */
+    score?: number;
+};
+/**
+ * Runs `search` for each term (top `perTermTake`) and for `terms.join(' ')` (top `combinedTake`),
+ * merges pools, sorts globally by Fuse score, then returns the first `limit` **distinct** keys
+ * (later duplicate keys are skipped).
+ *
+ * Default `tokenKey` uses `item.name` when present; pass an explicit `tokenKey` for types without
+ * `name` (e.g. icons keyed by `componentName`).
+ */
+export declare function mergeMultiTermFuseResults<T>({ searchTerms, limit, search, tokenKey, searchTermsJoin, }: {
+    searchTerms: string[];
+    limit: number;
+    search: (query: string) => FuseHit<T>[];
+    tokenKey?: (item: T) => string;
+    /**
+     * Join the search terms when querying with this separator, eg. `color.text` vs. `color text`
+     */
+    searchTermsJoin?: ' ' | '.';
+}): T[];

package/dist/types/helpers/index.d.ts

@@ -1,4 +1,5 @@
 import type { Tool } from '@modelcontextprotocol/sdk/types.js';
 import { zodToJsonSchema as zodToJsonSchemaHelper } from 'zod-to-json-schema';
+export { computeMultiTermFuseAllocation, type FuseHit, mergeMultiTermFuseResults, } from './fuse-multi-term';
 export declare const cleanQuery: (query: string) => string;
 export declare const zodToJsonSchema: <T = Tool["inputSchema"]>(schema: Parameters<typeof zodToJsonSchemaHelper>[0], options?: Parameters<typeof zodToJsonSchemaHelper>[1]) => T;

package/dist/types/instructions.d.ts

@@ -1 +1 @@
-export declare const 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";
+export declare const 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.\nFor org-wide standards alongside ADS tools: pair Context Engine `get_accessibility_docs` with `ads_get_a11y_guidelines`, `get_content_standards_docs` with `ads_get_guidelines`, and `get_i18n_docs` with `ads_i18n_conversion_guide` (Traduki/i18n policy plus the bundled formatMessage refactor guide).\nThese tools will support you, but for deep research you may also fetch https://atlassian.design/llms.txt, https://atlassian.design/llms-a11y.txt, or https://atlassian.design/ directly.\n";

package/dist/types/tools/{get-components → get-all-components}/index.d.ts

@@ -1,6 +1,6 @@
 import type { Tool } from '@modelcontextprotocol/sdk/types.js';
-export declare const listGetComponentsTool: Tool;
-export declare const getComponentsTool: () => Promise<{
+export declare const listGetAllComponentsTool: Tool;
+export declare const getAllComponentsTool: () => Promise<{
     content: {
         type: string;
         text: string;