@atlaskit/ads-mcp 0.18.1 → 0.19.0

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

@@ -16,17 +16,16 @@ 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; } /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
 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().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()
+  tokens: _zod.z.array(_zod.z.string()).describe('Search terms for ADS design tokens (fuzzy by default). Use `[]` if you only need icons or components. Prefer **at least two** terms per non-empty list when you know what you need.'),
+  icons: _zod.z.array(_zod.z.string()).describe('Search terms for ADS icons. Use `[]` if you only need tokens or components. Prefer **at least two** terms per non-empty list when known.'),
+  components: _zod.z.array(_zod.z.string()).describe('Search terms for ADS components. Use `[]` if you only need tokens or icons. Prefer **at least two** terms per non-empty list when known.'),
+  limit: _zod.z.number().default(2).describe('Max matches **per term** for each non-empty list (default 2). Same limit applies to tokens, icons, and components searches.').optional()
 });
 var listPlanTool = exports.listPlanTool = {
   name: 'ads_plan',
-  description: "Search how to use the Atlassian Design System offerings and get guidance on `tokens`, `icons`, and `components`.\n\nYOU MUST ALWAYS call this tool with known parameters and include a minimum of 2 search terms per parameter when known, eg.\n```json\n{\n\t\"tokens\": [\"spacing\", \"inverted text\", \"background primary\", \"animation\"],\n\t\"icons\": [\"search\", \"folder\", \"user\"],\n\t\"components\": [\"button\", \"input\", \"select\", \"heading\"]\n}\n```\n\nPlease note, there may not be results for everything as there are minor gaps in offerings or how we describe them.\n\nExample token usage:\n```tsx\nimport { token } from '@atlaskit/tokens';\nconst styles = css({ color: token('color.text'), padding: token('space.100') });\n```\n\nExample icon usage:\n```tsx\nimport AddIcon from '@atlaskit/icon/core/add';\n<AddIcon label=\"Add work item\" size=\"small\" />\n```",
+  description: "Runs **ads_search_tokens**, **ads_search_icons**, and **ads_search_components** in one call and returns a single JSON payload (each section only if that list was non-empty). Use this as the default way to discover ADS **tokens**, **icons**, and **components** for a UI task.\n\nWHEN TO USE:\n**Implementing or iterating on a UI**\u2014new screen, feature, or polish\u2014and you need candidate **token** names, **icon** imports, and **component** packages/props in one pass. Also use when exploring ADS building blocks before you write code.\n\nAt least one of `tokens`, `icons`, or `components` must contain search terms (use `[]` for lists you do not need).\n\nPrefer supplying **multiple** terms per non-empty array when you know them\u2014broader queries improve recall. Some queries return no rows where metadata is thin; try alternate wording.\n\nThis is equivalent to calling the individual search tools; there are no extra merge semantics beyond concatenating results.\n\nExample request:\n```json\n{\n\t\"tokens\": [\"spacing\", \"inverted text\", \"background primary\", \"animation\"],\n\t\"icons\": [\"search\", \"folder\", \"user\"],\n\t\"components\": [\"button\", \"input\", \"select\", \"heading\"]\n}\n```\n\nExample token usage:\n```tsx\nimport { token } from '@atlaskit/tokens';\nconst styles = css({ color: token('color.text'), padding: token('space.100') });\n```\n\nExample icon usage:\n```tsx\nimport AddIcon from '@atlaskit/icon/core/add';\n<AddIcon label=\"Add work item\" size=\"small\" />\n```",
   annotations: {
-    title: 'Plan ADS resources',
+    title: 'Search ADS tokens, icons, and components to plan what to build',
     readOnlyHint: true,
     destructiveHint: false,
     idempotentHint: true,
@@ -35,12 +34,12 @@ var listPlanTool = exports.listPlanTool = {
   inputSchema: (0, _helpers.zodToJsonSchema)(planInputSchema)
 };
 var planTool = exports.planTool = /*#__PURE__*/function () {
-  var _ref = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(params) {
-    var tokens_search, icons_search, components_search, _params$limit, limit, _params$exactName, exactName, results, searchPromises, getResultCount, consolidatedResult;
+  var _ref2 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(_ref) {
+    var tokens_search, icons_search, components_search, limit, results, searchPromises, getResultCount, consolidatedResult;
     return _regenerator.default.wrap(function _callee$(_context) {
       while (1) switch (_context.prev = _context.next) {
         case 0:
-          tokens_search = params.tokens, icons_search = params.icons, components_search = params.components, _params$limit = params.limit, limit = _params$limit === void 0 ? 1 : _params$limit, _params$exactName = params.exactName, exactName = _params$exactName === void 0 ? false : _params$exactName; // Validate that at least one search type is provided
+          tokens_search = _ref.tokens, icons_search = _ref.icons, components_search = _ref.components, limit = _ref.limit;
           if (!(!(tokens_search !== null && tokens_search !== void 0 && tokens_search.length) && !(icons_search !== null && icons_search !== void 0 && icons_search.length) && !(components_search !== null && components_search !== void 0 && components_search.length))) {
             _context.next = 3;
             break;
@@ -58,8 +57,7 @@ var planTool = exports.planTool = /*#__PURE__*/function () {
           if (tokens_search !== null && tokens_search !== void 0 && tokens_search.length) {
             searchPromises.push((0, _searchTokens.searchTokensTool)({
               terms: tokens_search,
-              limit: limit,
-              exactName: exactName
+              limit: limit
             }).then(function (result) {
               results.tokens = result;
             }));
@@ -67,8 +65,7 @@ var planTool = exports.planTool = /*#__PURE__*/function () {
           if (icons_search !== null && icons_search !== void 0 && icons_search.length) {
             searchPromises.push((0, _searchIcons.searchIconsTool)({
               terms: icons_search,
-              limit: limit,
-              exactName: exactName
+              limit: limit
             }).then(function (result) {
               results.icons = result;
             }));
@@ -76,8 +73,7 @@ var planTool = exports.planTool = /*#__PURE__*/function () {
           if (components_search !== null && components_search !== void 0 && components_search.length) {
             searchPromises.push((0, _searchComponents.searchComponentsTool)({
               terms: components_search,
-              limit: limit,
-              exactName: exactName
+              limit: limit
             }).then(function (result) {
               results.components = result;
             }));
@@ -131,6 +127,6 @@ var planTool = exports.planTool = /*#__PURE__*/function () {
     }, _callee);
   }));
   return function planTool(_x) {
-    return _ref.apply(this, arguments);
+    return _ref2.apply(this, arguments);
   };
 }();

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

@@ -6,21 +6,21 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.searchComponentsTool = exports.searchComponentsInputSchema = exports.listSearchComponentsTool = 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"));
 var _fuse = _interopRequireDefault(require("fuse.js"));
 var _zod = require("zod");
 var _helpers = require("../../helpers");
-var _loadAllComponents = require("../get-components/load-all-components");
+var _loadAllComponents = require("../get-all-components/load-all-components");
 /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
 
 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().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()
+  terms: _zod.z.array(_zod.z.string()).describe('Required: one or more search terms (fuzzy over name, package, category, description, keywords, examples). Example: `["button", "modal", "select"]`.'),
+  limit: _zod.z.number().default(2).describe('Max matches **per term** (default 2).').optional()
 });
 var listSearchComponentsTool = exports.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,
@@ -30,9 +30,7 @@ var listSearchComponentsTool = exports.listSearchComponentsTool = {
   },
   inputSchema: (0, _helpers.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,
@@ -41,52 +39,29 @@ var cleanComponentResult = function cleanComponentResult(result) {
   };
 };
 var searchComponentsTool = exports.searchComponentsTool = /*#__PURE__*/function () {
-  var _ref = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(params) {
-    var terms, _params$limit, limit, _params$exactName, exactName, searchTerms, components, exactNameMatches, fuse, results, uniqueResults;
+  var _ref2 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(_ref) {
+    var terms, _ref$limit, limit, searchTerms, components, fuse, matchedItems;
     return _regenerator.default.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(_helpers.cleanQuery);
+          terms = _ref.terms, _ref$limit = _ref.limit, limit = _ref$limit === void 0 ? 2 : _ref$limit;
+          searchTerms = (0, _toConsumableArray2.default)(new Set(terms.filter(Boolean).map(_helpers.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 = (0, _loadAllComponents.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.default(components, {
             keys: [{
               name: 'name',
-              weight: 3
+              weight: 5
             }, {
               name: 'package',
               weight: 3
@@ -96,30 +71,42 @@ var searchComponentsTool = exports.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 = (0, _helpers.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) {
@@ -127,28 +114,20 @@ var searchComponentsTool = exports.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/cjs/tools/search-icons/index.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.searchIconsTool = exports.searchIconsInputSchema = exports.listSearchIconsTool = 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"));
 var _fuse = _interopRequireDefault(require("fuse.js"));
 var _zod = require("zod");
@@ -14,13 +15,19 @@ var _icons = require("../get-all-icons/icons");
 /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
 
 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().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()
+  terms: _zod.z.array(_zod.z.string()).describe('Required: one or more terms; fuzzy match on icon **componentName**, **iconName**, **keywords**, **categorization**, **type**, and **usage**. Example: `["search", "folder", "user"]`.'),
+  limit: _zod.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
+  };
+};
 var listSearchIconsTool = exports.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,
@@ -31,51 +38,28 @@ var listSearchIconsTool = exports.listSearchIconsTool = {
   inputSchema: (0, _helpers.zodToJsonSchema)(searchIconsInputSchema)
 };
 var searchIconsTool = exports.searchIconsTool = /*#__PURE__*/function () {
-  var _ref = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(params) {
-    var terms, _params$limit, limit, _params$exactName, exactName, searchTerms, exactNameMatches, fuse, results, uniqueResults, matchedIcons;
+  var _ref2 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(_ref) {
+    var terms, _ref$limit, limit, searchTerms, fuse, matchedItems;
     return _regenerator.default.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(_helpers.cleanQuery);
+          terms = _ref.terms, _ref$limit = _ref.limit, limit = _ref$limit === void 0 ? 2 : _ref$limit;
+          searchTerms = (0, _toConsumableArray2.default)(new Set(terms.filter(Boolean).map(_helpers.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.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.default(_icons.icons, {
             keys: [{
               name: 'componentName',
-              weight: 3
+              weight: 5
             }, {
               name: 'iconName',
               weight: 3
@@ -84,34 +68,37 @@ var searchIconsTool = exports.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.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 = (0, _helpers.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.icons.map(function (i) {
@@ -119,33 +106,20 @@ var searchIconsTool = exports.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/cjs/tools/search-tokens/index.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.searchTokensTool = exports.searchTokensInputSchema = exports.listSearchTokensTool = 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"));
 var _fuse = _interopRequireDefault(require("fuse.js"));
 var _zod = require("zod");
@@ -14,13 +15,12 @@ var _helpers = require("../../helpers");
 /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
 
 var searchTokensInputSchema = exports.searchTokensInputSchema = _zod.z.object({
-  terms: _zod.z.array(_zod.z.string()).describe('An array of search terms to find tokens by name or description, eg. `["spacing", "inverted text", "background primary"]`'),
-  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 tokens by the exact name match (when you know the name, but need more details)').optional()
+  terms: _zod.z.array(_zod.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: _zod.z.number().default(2).describe('Max matches **per term** (default 2).').optional()
 });
 var listSearchTokensTool = exports.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,
@@ -31,80 +31,93 @@ var listSearchTokensTool = exports.listSearchTokensTool = {
   inputSchema: (0, _helpers.zodToJsonSchema)(searchTokensInputSchema)
 };
 var searchTokensTool = exports.searchTokensTool = /*#__PURE__*/function () {
-  var _ref = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(params) {
-    var terms, _params$limit, limit, _params$exactName, exactName, searchTerms, exactNameMatches, fuse, results, uniqueResults, matchedTokens;
+  var _ref2 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(_ref) {
+    var terms, _ref$limit, limit, searchTerms, fuse, matchedItems, matchedTokens;
     return _regenerator.default.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(_helpers.cleanQuery);
-          if (!exactName) {
-            _context.next = 6;
-            break;
-          }
-          // for each search term, search for the exact match
-          exactNameMatches = searchTerms.map(function (term) {
-            return _tokenMetadata.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 = (0, _toConsumableArray2.default)(new Set(terms.filter(Boolean).map(_helpers.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.default(_tokenMetadata.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 = (0, _helpers.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(_tokenMetadata.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);
   };
 }();