@atlaskit/ads-mcp 0.18.1 → 0.19.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @atlaskit/ads-mcp
 
+## 0.19.0
+
+### Minor Changes
+
+- [`a841a60987add`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/a841a60987add) -
+  Overhaul search-icon, search-tokens, search-components, and plan tools to make empty messages, no
+  results, and fuzzy searching more consistent and better. Fixes token results such as border.radius
+  or font.size
+
 ## 0.18.1
 
 ### Patch Changes

package/README.md

@@ -54,7 +54,7 @@ to help ensure your interfaces are accessible to all users.
 
 - `ads_get_all_tokens` - Get all available design tokens for colors, spacing, typography, etc.
 - `ads_search_tokens` - Search for specific design tokens by name, description, or example values
-- `ads_get_components` - Get a list of all available components with basic information
+- `ads_get_all_components` - Get all available components with basic information (full catalog)
 - `ads_search_components` - Search for components by name, description, category, or package name
 - `ads_get_all_icons` - Get all available icons from the design system
 - `ads_search_icons` - Search for specific icons by name, keywords, or categorization
@@ -91,7 +91,7 @@ const designResources = await plan({
 });
 
 // Get all available items (fallback when search doesn't find what you need)
-const allComponents = await get_components();
+const allComponents = await get_all_components();
 const allTokens = await get_all_tokens();
 const allIcons = await get_all_icons();
 ```

package/dist/cjs/helpers/fuse-multi-term.js

@@ -0,0 +1,130 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.computeMultiTermFuseAllocation = computeMultiTermFuseAllocation;
+exports.mergeMultiTermFuseResults = mergeMultiTermFuseResults;
+var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t.return || t.return(); } finally { if (u) throw o; } } }; }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+/**
+ * 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.
+ */
+function computeMultiTermFuseAllocation(limit, termCount) {
+  if (termCount <= 1) return {
+    perTermTake: 1,
+    combinedTake: 0,
+    totalTake: 1
+  };
+  var perTermTake = Math.max(Math.round(limit / termCount), 1);
+  var combinedTake = Math.max(limit * termCount - termCount * perTermTake, 1);
+  var totalTake = Math.max(perTermTake * termCount + combinedTake, 1);
+  return {
+    perTermTake: perTermTake,
+    combinedTake: combinedTake,
+    totalTake: totalTake
+  };
+}
+/**
+ * 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`).
+ */
+function mergeMultiTermFuseResults(_ref) {
+  var searchTerms = _ref.searchTerms,
+    limit = _ref.limit,
+    search = _ref.search,
+    _ref$tokenKey = _ref.tokenKey,
+    tokenKey = _ref$tokenKey === void 0 ? function (item) {
+      var _name;
+      return String((_name = item.name) !== null && _name !== void 0 ? _name : '');
+    } : _ref$tokenKey,
+    _ref$searchTermsJoin = _ref.searchTermsJoin,
+    searchTermsJoin = _ref$searchTermsJoin === void 0 ? ' ' : _ref$searchTermsJoin;
+  var n = searchTerms.length;
+  if (n === 0) {
+    return [];
+  }
+  if (n === 1) {
+    return takeFirstUniqueKeys(sortByScoreAsc(toScoredHits(search(searchTerms[0]), tokenKey)), limit);
+  }
+  var _computeMultiTermFuse = computeMultiTermFuseAllocation(limit, n),
+    perTermTake = _computeMultiTermFuse.perTermTake,
+    combinedTake = _computeMultiTermFuse.combinedTake,
+    totalTake = _computeMultiTermFuse.totalTake;
+  var termsCombined = searchTerms.join(searchTermsJoin);
+  var pool = [];
+  var _iterator = _createForOfIteratorHelper(searchTerms),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var term = _step.value;
+      pool.push.apply(pool, (0, _toConsumableArray2.default)(topRankedFromQuery(search, term, tokenKey, perTermTake)));
+    }
+
+    // Combine the terms together and search as well.
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  pool.push.apply(pool, (0, _toConsumableArray2.default)(topRankedFromQuery(search, termsCombined, tokenKey, combinedTake)));
+
+  // Grab the top combinations of all queries' results.
+  return takeFirstUniqueKeys(sortByScoreAsc(pool), totalTake);
+}
+
+/**
+ * Best `take` hits for one Fuse query (ranked by score, then slice).
+ */
+function topRankedFromQuery(search, query, tokenKey, take) {
+  return sortByScoreAsc(toScoredHits(search(query), tokenKey)).slice(0, take);
+}
+function toScoredHits(fuseHits, tokenKey) {
+  return fuseHits.map(function (hit) {
+    var _hit$score;
+    return {
+      item: hit.item,
+      score: (_hit$score = hit.score) !== null && _hit$score !== void 0 ? _hit$score : Number.POSITIVE_INFINITY,
+      key: tokenKey(hit.item)
+    };
+  });
+}
+function sortByScoreAsc(hits) {
+  return (0, _toConsumableArray2.default)(hits).sort(function (a, b) {
+    return a.score - b.score;
+  });
+}
+function takeFirstUniqueKeys(sortedHits, limit) {
+  var seen = new Set();
+  var out = [];
+  var _iterator2 = _createForOfIteratorHelper(sortedHits),
+    _step2;
+  try {
+    for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+      var h = _step2.value;
+      if (seen.has(h.key)) {
+        continue;
+      }
+      seen.add(h.key);
+      out.push(h.item);
+      if (out.length >= limit) {
+        break;
+      }
+    }
+  } catch (err) {
+    _iterator2.e(err);
+  } finally {
+    _iterator2.f();
+  }
+  return out;
+}

package/dist/cjs/helpers/index.js

@@ -3,8 +3,22 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.zodToJsonSchema = exports.cleanQuery = void 0;
+exports.cleanQuery = void 0;
+Object.defineProperty(exports, "computeMultiTermFuseAllocation", {
+  enumerable: true,
+  get: function get() {
+    return _fuseMultiTerm.computeMultiTermFuseAllocation;
+  }
+});
+Object.defineProperty(exports, "mergeMultiTermFuseResults", {
+  enumerable: true,
+  get: function get() {
+    return _fuseMultiTerm.mergeMultiTermFuseResults;
+  }
+});
+exports.zodToJsonSchema = void 0;
 var _zodToJsonSchema = require("zod-to-json-schema");
+var _fuseMultiTerm = require("./fuse-multi-term");
 /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
 
 var cleanQuery = exports.cleanQuery = function cleanQuery(query) {

package/dist/cjs/index.js

@@ -16,14 +16,17 @@ var _validation = require("./helpers/validation");
 var _instructions = require("./instructions");
 var _analyzeA11y = require("./tools/analyze-a11y");
 var _getA11yGuidelines = require("./tools/get-a11y-guidelines");
+var _getAllComponents = require("./tools/get-all-components");
 var _getAllIcons = require("./tools/get-all-icons");
 var _getAllTokens = require("./tools/get-all-tokens");
-var _getComponents = require("./tools/get-components");
 var _getGuidelines = require("./tools/get-guidelines");
 var _getLintRules = require("./tools/get-lint-rules");
 var _i18nConversion = require("./tools/i18n-conversion");
 var _migrationGuides = require("./tools/migration-guides");
 var _plan = require("./tools/plan");
+var _searchComponents = require("./tools/search-components");
+var _searchIcons = require("./tools/search-icons");
+var _searchTokens = require("./tools/search-tokens");
 var _suggestA11yFixes = require("./tools/suggest-a11y-fixes");
 /* eslint-disable no-console, import/extensions */
 
@@ -62,8 +65,8 @@ var generateLogger = function generateLogger(level) {
   };
 };
 var getToolRegistry = exports.getToolRegistry = function getToolRegistry() {
-  var _baseTools;
-  var baseTools = (_baseTools = {}, (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)(_baseTools, _analyzeA11y.listAnalyzeA11yTool.name, {
+  var _ref;
+  return _ref = {}, (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)(_ref, _analyzeA11y.listAnalyzeA11yTool.name, {
     handler: _analyzeA11y.analyzeA11yTool,
     inputSchema: _analyzeA11y.analyzeA11yInputSchema,
     tool: _analyzeA11y.listAnalyzeA11yTool
@@ -75,14 +78,26 @@ var getToolRegistry = exports.getToolRegistry = function getToolRegistry() {
     handler: _getA11yGuidelines.getA11yGuidelinesTool,
     inputSchema: _getA11yGuidelines.getA11yGuidelinesInputSchema,
     tool: _getA11yGuidelines.listGetA11yGuidelinesTool
-  }), _getComponents.listGetComponentsTool.name, {
-    handler: _getComponents.getComponentsTool,
+  }), _getAllComponents.listGetAllComponentsTool.name, {
+    handler: _getAllComponents.getAllComponentsTool,
     inputSchema: null,
-    tool: _getComponents.listGetComponentsTool
+    tool: _getAllComponents.listGetAllComponentsTool
   }), _plan.listPlanTool.name, {
     handler: _plan.planTool,
     inputSchema: _plan.planInputSchema,
     tool: _plan.listPlanTool
+  }), _searchComponents.listSearchComponentsTool.name, {
+    handler: _searchComponents.searchComponentsTool,
+    inputSchema: _searchComponents.searchComponentsInputSchema,
+    tool: _searchComponents.listSearchComponentsTool
+  }), _searchIcons.listSearchIconsTool.name, {
+    handler: _searchIcons.searchIconsTool,
+    inputSchema: _searchIcons.searchIconsInputSchema,
+    tool: _searchIcons.listSearchIconsTool
+  }), _searchTokens.listSearchTokensTool.name, {
+    handler: _searchTokens.searchTokensTool,
+    inputSchema: _searchTokens.searchTokensInputSchema,
+    tool: _searchTokens.listSearchTokensTool
   }), _suggestA11yFixes.listSuggestA11yFixesTool.name, {
     handler: _suggestA11yFixes.suggestA11yFixesTool,
     inputSchema: _suggestA11yFixes.suggestA11yFixesInputSchema,
@@ -91,7 +106,7 @@ var getToolRegistry = exports.getToolRegistry = function getToolRegistry() {
     handler: _migrationGuides.migrationGuidesTool,
     inputSchema: _migrationGuides.migrationGuidesInputSchema,
     tool: _migrationGuides.listMigrationGuidesTool
-  }), _i18nConversion.listI18nConversionTool.name, {
+  }), (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)(_ref, _i18nConversion.listI18nConversionTool.name, {
     handler: _i18nConversion.i18nConversionTool,
     inputSchema: _i18nConversion.i18nConversionInputSchema,
     tool: _i18nConversion.listI18nConversionTool
@@ -103,7 +118,7 @@ var getToolRegistry = exports.getToolRegistry = function getToolRegistry() {
     handler: _getAllTokens.getAllTokensTool,
     inputSchema: null,
     tool: _getAllTokens.listGetAllTokensTool
-  }), (0, _defineProperty2.default)((0, _defineProperty2.default)(_baseTools, _getAllIcons.listGetAllIconsTool.name, {
+  }), _getAllIcons.listGetAllIconsTool.name, {
     handler: _getAllIcons.getAllIconsTool,
     inputSchema: null,
     tool: _getAllIcons.listGetAllIconsTool
@@ -111,11 +126,10 @@ var getToolRegistry = exports.getToolRegistry = function getToolRegistry() {
     handler: _getLintRules.getLintRulesTool,
     inputSchema: _getLintRules.getLintRulesInputSchema,
     tool: _getLintRules.listGetLintRulesTool
-  }));
-  return baseTools;
+  });
 };
 server.setRequestHandler(_types.ListToolsRequestSchema, /*#__PURE__*/function () {
-  var _ref = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(request, extra) {
+  var _ref2 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(request, extra) {
     var toolRegistry, tools;
     return _regenerator.default.wrap(function _callee$(_context) {
       while (1) switch (_context.prev = _context.next) {
@@ -144,13 +158,13 @@ server.setRequestHandler(_types.ListToolsRequestSchema, /*#__PURE__*/function ()
     }, _callee);
   }));
   return function (_x, _x2) {
-    return _ref.apply(this, arguments);
+    return _ref2.apply(this, arguments);
   };
 }());
 
 // Handle tool execution
 server.setRequestHandler(_types.CallToolRequestSchema, /*#__PURE__*/function () {
-  var _ref2 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2(request, extra) {
+  var _ref3 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2(request, extra) {
     var toolRegistry, toolName, toolConfig, actionSubject, toolArguments, inputValidation, result, toolRegistryForError;
     return _regenerator.default.wrap(function _callee2$(_context2) {
       while (1) switch (_context2.prev = _context2.next) {
@@ -258,7 +272,7 @@ server.setRequestHandler(_types.CallToolRequestSchema, /*#__PURE__*/function ()
     }, _callee2, null, [[6, 20]]);
   }));
   return function (_x3, _x4) {
-    return _ref2.apply(this, arguments);
+    return _ref3.apply(this, arguments);
   };
 }());
 function runServer() {

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 (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";
+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.\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/cjs/tools/analyze-a11y/index.js

@@ -17,16 +17,16 @@ var _helpers = require("../../helpers");
 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 analyzeA11yInputSchema = exports.analyzeA11yInputSchema = _zod.z.object({
-  code: _zod.z.string().describe('React component code to analyze for accessibility'),
-  componentName: _zod.z.string().describe('Name of the component being analyzed').optional(),
-  context: _zod.z.string().describe('Additional context about the component usage').optional(),
-  includePatternAnalysis: _zod.z.boolean().default(true).describe('Include pattern-based analysis in addition to axe-core').optional()
+  code: _zod.z.string().describe('Source code of a React component or JSX snippet to analyze (string content only—no file path).'),
+  componentName: _zod.z.string().optional().describe('Optional label for the component under review (for summaries and reports).'),
+  context: _zod.z.string().optional().describe('Optional: how the component is used (e.g. in a form, modal) to improve suggestions.'),
+  includePatternAnalysis: _zod.z.boolean().default(true).describe('When true (default), runs regex-based heuristics on the code string (e.g. unlabeled buttons, missing alt) in addition to other analysis.').optional()
 });
 var listAnalyzeA11yTool = exports.listAnalyzeA11yTool = {
   name: 'ads_analyze_a11y',
-  description: 'Analyze React component code for accessibility violations using axe-core and generate ADS-specific suggestions.',
+  description: "Analyzes a **string of React/JSX** code for likely accessibility issues (heuristics and/or axe-related paths) and returns hints that often **point to** `ads_suggest_a11y_fixes` or generic axe/WCAG-style context\u2014not every finding maps to a specific ADS component fix.\n\nWHEN TO USE:\nYou have component source as text and want automated checks or heuristics before or during a code review.\n\nLIMITATIONS:\n- Does not replace testing in a real browser with assistive technologies or full keyboard traversal.\n- For rendered UI, `ads_analyze_localhost_a11y` (live URL + axe) is preferable when available\u2014it is **only exposed when this MCP runs locally**, not in the remote MCP deployment.",
   annotations: {
-    title: 'Analyze Accessibility',
+    title: 'Analyze accessibility (code string)',
     readOnlyHint: true,
     destructiveHint: false,
     idempotentHint: true,
@@ -35,16 +35,16 @@ var listAnalyzeA11yTool = exports.listAnalyzeA11yTool = {
   inputSchema: (0, _helpers.zodToJsonSchema)(analyzeA11yInputSchema)
 };
 var analyzeA11yLocalhostInputSchema = exports.analyzeA11yLocalhostInputSchema = _zod.z.object({
-  url: _zod.z.string().describe('The URL to analyze for accessibility (e.g. `http://localhost:9000`)'),
-  componentName: _zod.z.string().optional().describe('Name of the component being analyzed'),
-  context: _zod.z.string().optional().describe('Additional context about the component usage'),
-  selector: _zod.z.string().optional().describe('CSS selector to target a specific element for analysis (e.g. `#my-form` or `[data-role="button"]`)')
+  url: _zod.z.string().describe('Fully qualified page URL to load (e.g. `http://localhost:9000` or a dev URL). Must be reachable from this MCP process.'),
+  componentName: _zod.z.string().optional().describe('Optional label for reporting (e.g. feature or component under test).'),
+  context: _zod.z.string().optional().describe('Optional: route, user flow, or feature context for the analyzed page.'),
+  selector: _zod.z.string().optional().describe('Optional CSS selector to scope axe analysis to a subtree (e.g. `#my-form`, `[data-testid="panel"]`). Omit to analyze the whole document.')
 });
 var listAnalyzeLocalhostA11yTool = exports.listAnalyzeLocalhostA11yTool = {
   name: 'ads_analyze_localhost_a11y',
-  description: "Analyze a live web page for accessibility violations using axe-core and generate ADS-specific suggestions.",
+  description: "Loads a **live URL** in a headless browser, runs **axe-core**, and returns violations with follow-up hints (often suggesting `ads_suggest_a11y_fixes`). Output is anchored in **axe** rule text; remediation may be generic or ADS-biased depending on the violation.\n\n**Availability:** This tool is only registered when the ADS MCP runs **on your machine** (local MCP). It is **not** available in the **remote** MCP offering\u2014use `ads_analyze_a11y` on source text there instead.\n\nWHEN TO USE:\nYou have a running app or storybook page and need automated accessibility results on **rendered** UI\u2014especially local or staging URLs.\n\nLIMITATIONS:\n- Does not replace manual testing with assistive technologies or keyboard-only navigation.\n- Requires network access to the URL from the environment running the MCP.",
   annotations: {
-    title: 'Analyze Localhost Accessibility',
+    title: 'Analyze accessibility (live URL)',
     readOnlyHint: true,
     destructiveHint: false,
     idempotentHint: true,

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

@@ -15,13 +15,13 @@ function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbol
 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 topics = Object.keys(_guidelines.accessibilityGuidelines);
 var getA11yGuidelinesInputSchema = exports.getA11yGuidelinesInputSchema = _zod.z.object({
-  topic: _zod.z.string().optional().describe('Select the topic to get the accessibility guidelines for: ' + topics.join(', '))
+  topic: _zod.z.string().optional().describe('ADS accessibility topic key. Omit to receive all topics and the full guideline bundle. Pass a valid key (see response \`availableTopics\`) or \`general\` for a focused overview when supported. Known topics: ' + topics.join(', ') + '.')
 });
 var listGetA11yGuidelinesTool = exports.listGetA11yGuidelinesTool = {
   name: 'ads_get_a11y_guidelines',
-  description: 'Get accessibility guidelines and best practices from the Atlassian Design System.',
+  description: "Returns Atlassian Design System (ADS) accessibility guidance: best practices and patterns for buttons, interactions, color contrast, forms, and other design-system topics shipped in this tool.\n\nUse this alongside the Context Engine MCP tool `get_accessibility_docs` for Atlassian-wide accessibility standards (e.g. A11YKB); this tool supplies ADS-specific component and pattern guidance.\n\nWHEN TO USE:\nYou MUST call this when generating or substantially changing a new interactive or visual user interface built with ADS, or when you need topic-specific ADS guidance (e.g. focus, forms, motion).\n\nDO NOT rely on generic web accessibility advice alone\u2014ADS conventions may differ. Use `get_accessibility_docs` for org-wide standards and this tool for ADS-topic guidance.",
   annotations: {
-    title: 'Get Accessibility Guidelines',
+    title: 'Get ADS accessibility guidelines',
     readOnlyHint: true,
     destructiveHint: false,
     idempotentHint: true,

package/dist/cjs/tools/{get-components → get-all-components}/index.js

@@ -4,7 +4,7 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.listGetComponentsTool = exports.getComponentsTool = void 0;
+exports.listGetAllComponentsTool = exports.getAllComponentsTool = void 0;
 var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
 var _zod = require("zod");
@@ -12,9 +12,9 @@ var _helpers = require("../../helpers");
 var _loadAllComponents = require("./load-all-components");
 /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
 
-var listGetComponentsTool = exports.listGetComponentsTool = {
-  name: 'ads_get_components',
-  description: "Fetch all Atlassian Design System components. Only use when `ads_search_components` does not return what you're looking for.",
+var listGetAllComponentsTool = exports.listGetAllComponentsTool = {
+  name: 'ads_get_all_components',
+  description: "Returns **every** Atlassian Design System component record as separate JSON text chunks (full catalog; large payload).\n\nWHEN TO USE:\nLast resort when `ads_plan` / `ads_search_components` is insufficient and you must enumerate all components. Prefer search for normal component picking.\n\nNo parameters.",
   annotations: {
     title: 'Get all ADS components',
     readOnlyHint: true,
@@ -24,7 +24,7 @@ var listGetComponentsTool = exports.listGetComponentsTool = {
   },
   inputSchema: (0, _helpers.zodToJsonSchema)(_zod.z.object({}))
 };
-var getComponentsTool = exports.getComponentsTool = /*#__PURE__*/function () {
+var getAllComponentsTool = exports.getAllComponentsTool = /*#__PURE__*/function () {
   var _ref = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee() {
     return _regenerator.default.wrap(function _callee$(_context) {
       while (1) switch (_context.prev = _context.next) {
@@ -45,7 +45,7 @@ var getComponentsTool = exports.getComponentsTool = /*#__PURE__*/function () {
       }
     }, _callee);
   }));
-  return function getComponentsTool() {
+  return function getAllComponentsTool() {
     return _ref.apply(this, arguments);
   };
 }();

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

@@ -14,7 +14,7 @@ var _icons = require("./icons");
 
 var listGetAllIconsTool = exports.listGetAllIconsTool = {
   name: 'ads_get_all_icons',
-  description: "Fetch all Atlassian Design System icons. Only use when `ads_search_icons` does not return what you're looking for.",
+  description: "Returns **every** ADS icon record as separate JSON text chunks (full catalog; large payload).\n\nWHEN TO USE:\nLast resort when `ads_plan` / `ads_search_icons` is insufficient and you must enumerate all icons. Prefer search for normal icon picking.\n\nNo parameters.",
   annotations: {
     title: 'Get all ADS icons',
     readOnlyHint: true,

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

@@ -15,7 +15,7 @@ var _helpers = require("../../helpers");
 var inputSchema = _zod.z.object({});
 var listGetAllTokensTool = exports.listGetAllTokensTool = {
   name: 'ads_get_all_tokens',
-  description: "Fetch all Atlassian Design System tokens. Only use when `ads_search_tokens` does not return what you're looking for.",
+  description: "Returns **every** ADS design token from bundled metadata (name, example value, usage guidelines)\u2014one JSON object per token, **very large** output.\n\nWHEN TO USE:\nLast resort when `ads_plan` / `ads_search_tokens` cannot answer the question and you need the full list (e.g. exhaustive audit). Prefer targeted search for normal development.\n\nNo parameters.",
   annotations: {
     title: 'Get all ADS tokens',
     readOnlyHint: true,

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

@@ -14,14 +14,14 @@ var _guidelinesStructuredContent = require("./guidelines-structured-content.code
 /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
 
 var getGuidelinesInputSchema = exports.getGuidelinesInputSchema = _zod.z.object({
-  terms: _zod.z.array(_zod.z.string()).default([]).describe('An array of search terms to find content guidelines by keywords or content, eg. `["messages", "empty state", "voice tone"]`. If empty or not provided, returns all guidelines.').optional(),
-  limit: _zod.z.number().default(1).describe('Maximum number of results per search term in the array (default: 1)').optional()
+  terms: _zod.z.array(_zod.z.string()).default([]).describe('Search terms matched against guideline keywords and body (fuzzy). Examples: `["empty state", "voice tone"]`, `["color tokens", "spacing"]`, `["elevation", "grid"]`. Omit or use an empty array to return **all** guidelines as Markdown.').optional(),
+  limit: _zod.z.number().default(1).describe('Max matches **per term** when `terms` is non-empty (default 1). Ignored when returning all guidelines.').optional()
 });
 var listGetGuidelinesTool = exports.listGetGuidelinesTool = {
   name: 'ads_get_guidelines',
-  description: "Get Atlassian Design System content guidelines (foundations content) with optional search functionality.\n\n- If search parameters are provided, searches for guidelines matching the criteria by keywords or content.\n- If no search parameters are provided, returns all guidelines.\n\nExample: use this tool to look up content guidance for designing messages, voice and tone, date and time, inclusive writing, or language and grammar.",
+  description: "Returns Atlassian Design System (ADS) **foundations** guidelines as Markdown: the bundled design-system-docs foundations set (not component API docs).\n\nTOPIC COVERAGE:\n- **Content & UX writing**: messaging types (empty state, error, success, warning, info, feature discovery), voice and tone, inclusive language, grammar and style, date/time copy handoff, vocabulary pointers.\n- **Visual foundations**: color (roles, accents, palette, charts, pickers), borders and radius, elevation and z-index, spacing and layout primitives (box/inline/stack), grid, iconography, logos.\n- **Design tokens**: concepts, themes, migration, using tokens in code and in Figma.\n- **Typography**: typefaces, scale, applying text styles and tokens.\n- **Accessibility overview**: building accessible apps and related foundations pages bundled here.\n\nWhen working with content, use this tool alongside the Context Engine MCP tool `get_content_standards_docs` for Atlassian-wide content standards (CDSTD/BAIT-style org guidance); this tool supplies ADS-specific foundations.\n\nWHAT YOU GET:\n- With `terms`: fuzzy search over keywords and content; concatenated Markdown for matches.\n- Without `terms` (or empty): the full guideline set as Markdown.\n\nWHEN TO USE:\nUse this when you are **building or updating a visual interface**, **writing or reviewing user-facing copy**, or need to **answer foundations questions** about ADS: content patterns, visual appearance, design tokens, typography, spacing, color, grid, motion, and related topics shipped in this bundle.\n\nIt is **not** for picking a component\u2019s props or package (use `ads_plan` / `ads_search_components`) or for interactive accessibility rules and patterns (use `ads_get_a11y_guidelines`, with Context Engine `get_accessibility_docs` for org-wide a11y standards).",
   annotations: {
-    title: 'Get ADS guidelines',
+    title: 'Get ADS guidelines (content, a11y, visual design, design tokens, typography)',
     readOnlyHint: true,
     destructiveHint: false,
     idempotentHint: true,

package/dist/cjs/tools/get-lint-rules/index.js

@@ -14,15 +14,15 @@ var _lintRulesStructuredContent = require("./lint-rules-structured-content.codeg
 /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
 
 var getLintRulesInputSchema = exports.getLintRulesInputSchema = _zod.z.object({
-  terms: _zod.z.array(_zod.z.string()).default([]).describe('An array of search terms to find lint rules by name or description, eg. `["icon-label", "xcss", "design token"]`. If empty or not provided, returns all lint rules.').optional(),
-  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 lint rules by the exact rule name match (when you know the rule name, but need more details)').optional()
+  terms: _zod.z.array(_zod.z.string()).default([]).describe('Search terms matched against rule name, description, and docs body (fuzzy unless \`exactName\` is true). Example: `["icon-label", "xcss", "design token"]`. Omit or empty: return **all** rules as JSON.').optional(),
+  limit: _zod.z.number().default(1).describe('Max matches **per term** when searching (default 1). Not used when returning all rules.').optional(),
+  exactName: _zod.z.boolean().default(false).describe('If true, resolve each term by **exact** ESLint rule name (case-insensitive). If false, fuzzy search across name, description, and content.').optional()
 });
 var listGetLintRulesTool = exports.listGetLintRulesTool = {
   name: 'ads_get_lint_rules',
-  description: "Get Atlassian Design System ESLint rule documentation (constellation) with optional search functionality.\n\n- If search parameters are provided, searches for lint rules matching the criteria.\n- If no search parameters are provided, returns all lint rules.\n\nExample: use this tool to look up documentation for rules like icon-label, ensure-proper-xcss-usage, or no-deprecated-apis.",
+  description: "Returns documentation for **Constellation** (Atlassian Design System) ESLint rules shipped with this MCP\u2014rule purpose, examples, and fixes where available.\n\nWHAT YOU GET:\n- No `terms`: JSON array of all rule payloads.\n- With `terms`: fuzzy search (or exact rule name when `exactName` is true); JSON for one or more matching rules.\n\nWHEN TO USE:\nExplaining or fixing an ESLint message from ADS rules (e.g. `icon-label`, `ensure-proper-xcss-usage`, `no-deprecated-apis`), or browsing rule docs without opening the repo. Prefer this over guessing from rule id alone.\n\nThis tool does not run ESLint; it only returns bundled documentation.",
   annotations: {
-    title: 'Get ADS lint rules',
+    title: 'Get ADS ESLint rule docs',
     readOnlyHint: true,
     destructiveHint: false,
     idempotentHint: true,

package/dist/cjs/tools/i18n-conversion/index.js

@@ -13,13 +13,13 @@ var _guide = require("./guide");
 /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
 
 var i18nConversionInputSchema = exports.i18nConversionInputSchema = _zod.z.object({
-  guide: _zod.z.enum(['hardcoded-string-to-formatmessage']).describe('The i18n conversion guide to retrieve.')
+  guide: _zod.z.enum(['hardcoded-string-to-formatmessage']).describe('Which bundled guide to return. Currently only `hardcoded-string-to-formatmessage` (JSX literals → `formatMessage` / intl patterns).')
 });
 var listI18nConversionTool = exports.listI18nConversionTool = {
   name: 'ads_i18n_conversion_guide',
-  description: "Provides comprehensive guide for converting hardcoded strings to use formatMessage from @atlassian/jira-intl or react-intl-next.\n\n**TRIGGER**: Use this tool when you encounter:\n- \"fix hardcoded string\" / \"fix hardcoded strings\" / \"fix hardcoded string in [file]\"\n- \"convert hardcoded string\" / \"convert to i18n\" / \"convert to formatMessage\"\n- \"translate string\" / \"internationalize string\" / \"i18n this string\"\n- \"use formatMessage\" / \"use FormattedMessage\" / \"wrap in formatMessage\"\n- \"literal string\" / \"fix literal string\" / \"convert literal string\"\n- ESLint errors: \"Literal string in JSX content should be internationalized. Use FormattedMessage or intl.formatMessage()\"\n- ESLint errors: \"@atlassian/i18n/no-literal-string-in-jsx\"\n- Requests to convert hardcoded strings to i18n messages\n\nThis tool helps LLM agents systematically convert hardcoded strings while respecting scope limitations and following best practices for message constants, placeholders, and descriptions.",
+  description: "Returns a **bundled** step-by-step guide for replacing hardcoded UI strings with `formatMessage` (and related patterns) using @atlassian/jira-intl or react-intl-next: message constants, placeholders, descriptions, and scope/limitations for systematic refactors.\n\nWhen working with i18n or hardcoded UI strings, use this tool alongside the Context Engine MCP tool `get_i18n_docs` for Atlassian-wide Traduki / i18n standards (message definition, extraction, pluralisation, formatting, workflow); this tool supplies the concrete hardcoded-string \u2192 `formatMessage` playbook bundled in ADS MCP.\n\nWHEN TO USE / TYPICAL TRIGGERS:\n- Refactoring JSX or TS literals to i18n; \"fix hardcoded string(s)\", \"convert hardcoded string in [file]\", \"literal string in JSX\".\n- \"Convert to i18n\", \"convert to formatMessage\", \"translate this string\", \"internationalize this string\", \"i18n this string\".\n- \"Use formatMessage\", \"use FormattedMessage\", \"wrap in formatMessage\", \"fix literal string\".\n- ESLint: `Literal string in JSX content should be internationalized. Use FormattedMessage or intl.formatMessage()`.\n- ESLint: `@atlassian/i18n/no-literal-string-in-jsx`.",
   annotations: {
-    title: 'i18n Conversion Guide',
+    title: 'i18n conversion guide',
     readOnlyHint: true,
     destructiveHint: false,
     idempotentHint: true,

package/dist/cjs/tools/migration-guides/index.js

@@ -16,12 +16,12 @@ var _registry = require("./registry");
 var migrationIds = (0, _registry.getAvailableMigrationIds)();
 var migrationDescriptions = (0, _registry.getAvailableMigrationsDescription)();
 var migrationGuidesInputSchema = exports.migrationGuidesInputSchema = _zod.z.object({
-  migration: _zod.z.enum(migrationIds).describe("The specific migration to perform.\n"),
-  description: _zod.z.enum(migrationDescriptions).describe("Description of the migration type.\n")
+  migration: _zod.z.enum(migrationIds).describe('Migration id from the registry. Must match the guide you want (see tool description list).'),
+  description: _zod.z.enum(migrationDescriptions).describe('Human-readable migration label that pairs with `migration` in the schema—choose the entry that matches the selected id.')
 });
 var listMigrationGuidesTool = exports.listMigrationGuidesTool = {
   name: 'ads_migration_guides',
-  description: "Migration guides for Atlassian Design System components.\n\n\tAvailable migrations:\n".concat((0, _registry.getAvailableMigrationsDescription)()),
+  description: "Returns a structured Atlassian Design System (ADS) **migration guide** for a known package or API migration (before/after examples, best practices, links).\n\nWHEN TO USE:\nYou are upgrading or refactoring code between ADS packages or APIs and need the official migration pattern for a specific id listed below.\n\nPass **both** `migration` and `description` using a **matching pair** from the enum (schema enforces valid combinations).\n\nAvailable migrations:\n".concat((0, _registry.getAvailableMigrationsDescription)()),
   annotations: {
     title: 'ADS Migration Guides',
     readOnlyHint: true,