@atlaskit/ads-mcp 0.9.1 → 0.10.1

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

@@ -0,0 +1,126 @@
+import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
+import _regeneratorRuntime from "@babel/runtime/regenerator";
+import Fuse from 'fuse.js';
+import { z } from 'zod';
+import { cleanQuery, zodToJsonSchema } from '../../helpers';
+import { iconStructuredContent } from './icon-structured-content.codegen';
+export var getIconsInputSchema = z.object({
+  terms: z.array(z.string()).default([]).describe('An array of search terms to find icons by name, keywords, or categorization, eg. `["search", "folder", "user"]`. If empty or not provided, returns all icons.').optional(),
+  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()
+});
+export var listGetIconsTool = {
+  name: 'ads_get_icons',
+  description: "Get Atlassian Design System icons with optional search functionality.\n\n- If search parameters are provided, searches for icons matching the criteria.\n- If no search parameters are provided, returns all icons.\n\nExample icon usage:\n```tsx\nimport AddIcon from '@atlaskit/icon/core/add';\n<AddIcon label=\"Add work item\" size=\"small\" />\n```",
+  annotations: {
+    title: 'Get ADS icons',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  },
+  inputSchema: zodToJsonSchema(getIconsInputSchema)
+};
+export var getIconsTool = /*#__PURE__*/function () {
+  var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(params) {
+    var _params$terms, terms, _params$limit, limit, _params$exactName, exactName, searchTerms, iconDocs, allIconsMarkdown, exactNameMatches, _formattedIcons, fuse, results, uniqueResults, matchedIcons, formattedIcons;
+    return _regeneratorRuntime.wrap(function _callee$(_context) {
+      while (1) switch (_context.prev = _context.next) {
+        case 0:
+          _params$terms = params.terms, terms = _params$terms === void 0 ? [] : _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);
+          iconDocs = iconStructuredContent.filter(function (icon) {
+            return icon.status === 'published';
+          }); // If no search terms provided, return all icons formatted as Markdown
+          if (!(searchTerms.length === 0)) {
+            _context.next = 6;
+            break;
+          }
+          allIconsMarkdown = iconDocs.map(function (icon) {
+            return icon.content;
+          }).join('\n\n');
+          return _context.abrupt("return", {
+            content: [{
+              type: 'text',
+              text: allIconsMarkdown
+            }]
+          });
+        case 6:
+          if (!exactName) {
+            _context.next = 10;
+            break;
+          }
+          // for each search term, search for the exact match
+          exactNameMatches = searchTerms.map(function (term) {
+            return iconDocs.find(function (icon) {
+              return icon.componentName.toLowerCase() === term.toLowerCase();
+            });
+          }).filter(function (icon) {
+            return icon !== undefined;
+          }); // Return exact matches if found, or empty result if exactName is true
+          _formattedIcons = exactNameMatches.map(function (icon) {
+            return icon.content;
+          }).join('\n\n');
+          return _context.abrupt("return", {
+            content: [{
+              type: 'text',
+              text: _formattedIcons
+            }]
+          });
+        case 10:
+          // use Fuse.js to fuzzy-search for the icons
+          fuse = new Fuse(iconDocs, {
+            keys: [{
+              name: 'componentName',
+              weight: 3
+            }, {
+              name: 'keywords',
+              weight: 2
+            }, {
+              name: 'categorization',
+              weight: 1
+            }, {
+              name: 'usage',
+              weight: 1
+            }],
+            threshold: 0.4
+          });
+          results = searchTerms.map(function (term) {
+            // always search exact match from the icons
+            var exactNameMatch = iconDocs.find(function (icon) {
+              return icon.componentName.toLowerCase() === term.toLowerCase();
+            });
+            if (exactNameMatch) {
+              return [{
+                item: exactNameMatch
+              }];
+            }
+            return fuse.search(term).slice(0, limit);
+          }).flat(); // 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 result.item;
+          });
+          formattedIcons = matchedIcons.map(function (icon) {
+            return icon.content;
+          }).join('\n\n');
+          return _context.abrupt("return", {
+            content: [{
+              type: 'text',
+              text: formattedIcons
+            }]
+          });
+        case 16:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee);
+  }));
+  return function getIconsTool(_x) {
+    return _ref.apply(this, arguments);
+  };
+}();

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

@@ -2,23 +2,8 @@ import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
 import _regeneratorRuntime from "@babel/runtime/regenerator";
 import Fuse from 'fuse.js';
 import { z } from 'zod';
-import { zodToJsonSchema } from 'zod-to-json-schema';
-import { tokens } from '@atlaskit/tokens/token-metadata';
-import { cleanQuery } from '../../helpers';
-import { tokenToMarkdown } from '../../structured-content/formatters/token';
-// Transform Token[] from token-metadata to TokenSchema[] format
-function transformTokensToSchemas() {
-  return tokens.map(function (token) {
-    var _token$exampleValue;
-    return {
-      contentType: 'token',
-      name: token.name,
-      path: token.path,
-      description: token.description,
-      exampleValue: String((_token$exampleValue = token.exampleValue) !== null && _token$exampleValue !== void 0 ? _token$exampleValue : '')
-    };
-  });
-}
+import { cleanQuery, zodToJsonSchema } from '../../helpers';
+import { tokenStructuredContent } from './token-structured-content.codegen';
 export var getTokensInputSchema = z.object({
   terms: z.array(z.string()).default([]).describe('An array of search terms to find tokens by name or description, eg. `["spacing", "inverted text", "background primary"]`. If empty or not provided, returns all tokens.').optional(),
   limit: z.number().default(1).describe('Maximum number of results per search term in the array (default: 1)').optional(),
@@ -44,12 +29,14 @@ export var getTokensTool = /*#__PURE__*/function () {
         case 0:
           _params$terms = params.terms, terms = _params$terms === void 0 ? [] : _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);
-          tokenDocs = transformTokensToSchemas(); // If no search terms provided, return all tokens formatted as Markdown
+          tokenDocs = tokenStructuredContent; // If no search terms provided, return all tokens formatted as Markdown
           if (!(searchTerms.length === 0)) {
             _context.next = 6;
             break;
           }
-          allTokensMarkdown = tokenDocs.map(tokenToMarkdown).join('\n\n');
+          allTokensMarkdown = tokenDocs.map(function (token) {
+            return token.content;
+          }).join('\n\n');
           return _context.abrupt("return", {
             content: [{
               type: 'text',
@@ -66,12 +53,16 @@ export var getTokensTool = /*#__PURE__*/function () {
             return tokenDocs.find(function (token) {
               return token.name.toLowerCase() === term.toLowerCase();
             });
-          }).filter(Boolean);
+          }).filter(function (token) {
+            return token !== undefined;
+          });
           if (!(exactNameMatches.length > 0)) {
             _context.next = 11;
             break;
           }
-          _formattedTokens = exactNameMatches.map(tokenToMarkdown).join('\n\n');
+          _formattedTokens = exactNameMatches.map(function (token) {
+            return token.content;
+          }).join('\n\n');
           return _context.abrupt("return", {
             content: [{
               type: 'text',
@@ -104,7 +95,9 @@ export var getTokensTool = /*#__PURE__*/function () {
           matchedTokens = uniqueResults.map(function (result) {
             return result.item;
           });
-          formattedTokens = matchedTokens.map(tokenToMarkdown).join('\n\n');
+          formattedTokens = matchedTokens.map(function (token) {
+            return token.content;
+          }).join('\n\n');
           return _context.abrupt("return", {
             content: [{
               type: 'text',