@atlaskit/ads-mcp 1.0.0 → 1.2.0

package/dist/es2019/tools/search-atlaskit-hooks/search-atlaskit-hooks-tool.js

@@ -0,0 +1,79 @@
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+import Fuse from 'fuse.js';
+import { cleanQuery, mergeMultiTermFuseResults } from '../../helpers';
+import { atlaskitHooks } from '../get-atlaskit-hooks/atlaskit-hooks.codegen';
+const buildHookResult = result => {
+  return {
+    name: result.name,
+    package: result.package,
+    description: result.description,
+    usageGuidelines: result.usageGuidelines,
+    keywords: result.keywords,
+    category: result.category,
+    parameters: result.parameters,
+    returns: result.returns
+  };
+};
+export const searchAtlaskitHooksTool = async ({
+  terms,
+  limit = 2
+}) => {
+  const searchTerms = [...new Set(terms.filter(Boolean).map(cleanQuery))];
+  if (!searchTerms.length) {
+    return {
+      content: [{
+        type: 'text',
+        text: '[]'
+      }]
+    };
+  }
+  const hooks = atlaskitHooks;
+  const fuse = new Fuse(hooks, {
+    keys: [{
+      name: 'name',
+      weight: 5
+    }, {
+      name: 'package',
+      weight: 3
+    }, {
+      name: 'category',
+      weight: 2
+    }, {
+      name: 'description',
+      weight: 2
+    }, {
+      name: 'keywords',
+      weight: 2
+    }, {
+      name: 'usageGuidelines',
+      weight: 2
+    }],
+    threshold: 0.4,
+    distance: 80,
+    minMatchCharLength: 3,
+    ignoreFieldNorm: true,
+    includeScore: true
+  });
+  const matchedItems = mergeMultiTermFuseResults({
+    searchTerms,
+    limit,
+    search: query => fuse.search(query, {
+      limit: limit * searchTerms.length
+    })
+  });
+  if (!matchedItems.length) {
+    return {
+      content: [{
+        type: 'text',
+        text: `Error: No Atlaskit hooks found for '${terms.join(', ')}'.`
+      }]
+    };
+  }
+  return {
+    content: [{
+      type: 'text',
+      text: JSON.stringify(matchedItems.map(buildHookResult))
+    }]
+  };
+};

package/dist/es2019/tools/search-atlaskit-utilities/list-search-atlaskit-utilities-tool.js

@@ -0,0 +1,19 @@
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+import { zodToJsonSchema } from '../../helpers';
+import { searchAtlaskitUtilitiesInputSchema } from './search-atlaskit-utilities-input-schema';
+export const listSearchAtlaskitUtilitiesTool = {
+  name: 'atlaskit_search_utilities',
+  description: `Search for atlaskit utilities (functions, constants, types) by name, package, category, description, or keywords.
+
+WHEN TO USE:
+Use this when you want to find a utility but don't know its exact name or package.`,
+  annotations: {
+    title: 'Search Atlaskit utilities',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  },
+  inputSchema: zodToJsonSchema(searchAtlaskitUtilitiesInputSchema)
+};

package/dist/es2019/tools/search-atlaskit-utilities/search-atlaskit-utilities-input-schema.js

@@ -0,0 +1,5 @@
+import { z } from 'zod';
+export const searchAtlaskitUtilitiesInputSchema = z.object({
+  terms: z.array(z.string()).describe('Required: one or more search terms (fuzzy over name, package, category, description, keywords, usageGuidelines). Example: `["debounce", "a11y", "storage"]`.'),
+  limit: z.number().default(2).describe('Max matches **per term** (default 2).').optional()
+});

package/dist/es2019/tools/search-atlaskit-utilities/search-atlaskit-utilities-tool.js

@@ -0,0 +1,81 @@
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+import Fuse from 'fuse.js';
+import { cleanQuery, mergeMultiTermFuseResults } from '../../helpers';
+import { atlaskitUtilities } from '../get-atlaskit-utilities/atlaskit-utilities.codegen';
+const buildUtilityResult = result => {
+  return {
+    name: result.name,
+    package: result.package,
+    description: result.description,
+    usageGuidelines: result.usageGuidelines,
+    keywords: result.keywords,
+    category: result.category,
+    kind: result.kind,
+    ...(result.kind === 'function' ? {
+      signature: result.signature
+    } : {})
+  };
+};
+export const searchAtlaskitUtilitiesTool = async ({
+  terms,
+  limit = 2
+}) => {
+  const searchTerms = [...new Set(terms.filter(Boolean).map(cleanQuery))];
+  if (!searchTerms.length) {
+    return {
+      content: [{
+        type: 'text',
+        text: '[]'
+      }]
+    };
+  }
+  const utilities = atlaskitUtilities;
+  const fuse = new Fuse(utilities, {
+    keys: [{
+      name: 'name',
+      weight: 5
+    }, {
+      name: 'package',
+      weight: 3
+    }, {
+      name: 'category',
+      weight: 2
+    }, {
+      name: 'description',
+      weight: 2
+    }, {
+      name: 'keywords',
+      weight: 2
+    }, {
+      name: 'usageGuidelines',
+      weight: 2
+    }],
+    threshold: 0.4,
+    distance: 80,
+    minMatchCharLength: 3,
+    ignoreFieldNorm: true,
+    includeScore: true
+  });
+  const matchedItems = mergeMultiTermFuseResults({
+    searchTerms,
+    limit,
+    search: query => fuse.search(query, {
+      limit: limit * searchTerms.length
+    })
+  });
+  if (!matchedItems.length) {
+    return {
+      content: [{
+        type: 'text',
+        text: `Error: No Atlaskit utilities found for '${terms.join(', ')}'.`
+      }]
+    };
+  }
+  return {
+    content: [{
+      type: 'text',
+      text: JSON.stringify(matchedItems.map(buildUtilityResult))
+    }]
+  };
+};

package/dist/esm/index.js

@@ -25,6 +25,10 @@ import { getAllTokensTool } from './tools/get-all-tokens/get-all-tokens-tool';
 import { listGetAllTokensTool } from './tools/get-all-tokens/list-get-all-tokens-tool';
 import { getAtlaskitComponentsTool } from './tools/get-atlaskit-components/get-atlaskit-components-tool';
 import { listGetAtlaskitComponentsTool } from './tools/get-atlaskit-components/list-get-atlaskit-components-tool';
+import { getAtlaskitHooksTool } from './tools/get-atlaskit-hooks/get-atlaskit-hooks-tool';
+import { listGetAtlaskitHooksTool } from './tools/get-atlaskit-hooks/list-get-atlaskit-hooks-tool';
+import { getAtlaskitUtilitiesTool } from './tools/get-atlaskit-utilities/get-atlaskit-utilities-tool';
+import { listGetAtlaskitUtilitiesTool } from './tools/get-atlaskit-utilities/list-get-atlaskit-utilities-tool';
 import { getGuidelinesInputSchema } from './tools/get-guidelines/get-guidelines-input-schema';
 import { getGuidelinesTool } from './tools/get-guidelines/get-guidelines-tool';
 import { listGetGuidelinesTool } from './tools/get-guidelines/list-get-guidelines-tool';
@@ -43,6 +47,12 @@ import { planTool } from './tools/plan/plan-tool';
 import { listSearchAtlaskitComponentsTool } from './tools/search-atlaskit-components/list-search-atlaskit-components-tool';
 import { searchAtlaskitComponentsInputSchema } from './tools/search-atlaskit-components/search-atlaskit-components-input-schema';
 import { searchAtlaskitComponentsTool } from './tools/search-atlaskit-components/search-atlaskit-components-tool';
+import { listSearchAtlaskitHooksTool } from './tools/search-atlaskit-hooks/list-search-atlaskit-hooks-tool';
+import { searchAtlaskitHooksInputSchema } from './tools/search-atlaskit-hooks/search-atlaskit-hooks-input-schema';
+import { searchAtlaskitHooksTool } from './tools/search-atlaskit-hooks/search-atlaskit-hooks-tool';
+import { listSearchAtlaskitUtilitiesTool } from './tools/search-atlaskit-utilities/list-search-atlaskit-utilities-tool';
+import { searchAtlaskitUtilitiesInputSchema } from './tools/search-atlaskit-utilities/search-atlaskit-utilities-input-schema';
+import { searchAtlaskitUtilitiesTool } from './tools/search-atlaskit-utilities/search-atlaskit-utilities-tool';
 import { listSearchComponentsTool } from './tools/search-components/list-search-components-tool';
 import { searchComponentsInputSchema } from './tools/search-components/search-components-input-schema';
 import { searchComponentsTool } from './tools/search-components/search-components-tool';
@@ -132,7 +142,7 @@ export var getToolRegistry = function getToolRegistry() {
     handler: migrationGuidesTool,
     inputSchema: migrationGuidesInputSchema,
     tool: listMigrationGuidesTool
-  }), _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_registry, listI18nConversionTool.name, {
+  }), _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_registry, listI18nConversionTool.name, {
     handler: i18nConversionTool,
     inputSchema: i18nConversionInputSchema,
     tool: listI18nConversionTool
@@ -160,6 +170,22 @@ export var getToolRegistry = function getToolRegistry() {
     handler: searchAtlaskitComponentsTool,
     inputSchema: searchAtlaskitComponentsInputSchema,
     tool: listSearchAtlaskitComponentsTool
+  }), listGetAtlaskitUtilitiesTool.name, {
+    handler: getAtlaskitUtilitiesTool,
+    inputSchema: null,
+    tool: listGetAtlaskitUtilitiesTool
+  }), listSearchAtlaskitUtilitiesTool.name, {
+    handler: searchAtlaskitUtilitiesTool,
+    inputSchema: searchAtlaskitUtilitiesInputSchema,
+    tool: listSearchAtlaskitUtilitiesTool
+  }), listGetAtlaskitHooksTool.name, {
+    handler: getAtlaskitHooksTool,
+    inputSchema: null,
+    tool: listGetAtlaskitHooksTool
+  }), _defineProperty(_registry, listSearchAtlaskitHooksTool.name, {
+    handler: searchAtlaskitHooksTool,
+    inputSchema: searchAtlaskitHooksInputSchema,
+    tool: listSearchAtlaskitHooksTool
   }));
   return registry;
 };