@atlaskit/ads-mcp 0.20.3 → 0.20.4

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

@@ -0,0 +1,84 @@
+/* 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 { atlaskitComponents } from '../get-atlaskit-components/atlaskit-components.codegen';
+const buildComponentResult = result => {
+  return {
+    name: result.name,
+    package: result.package,
+    examples: result.examples,
+    props: result.props
+  };
+};
+export const searchAtlaskitComponentsTool = async ({
+  terms,
+  limit = 2
+}) => {
+  const searchTerms = [...new Set(terms.filter(Boolean).map(cleanQuery))];
+  if (!searchTerms.length) {
+    return {
+      content: [{
+        type: 'text',
+        text: '[]'
+      }]
+    };
+  }
+  const components = atlaskitComponents;
+  const fuse = new Fuse(components, {
+    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
+    }, {
+      name: 'contentGuidelines',
+      weight: 1
+    }, {
+      name: 'accessibilityGuidelines',
+      weight: 1
+    }, {
+      name: 'examples',
+      weight: 1
+    }],
+    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 components found for '${terms.join(', ')}'.`
+      }]
+    };
+  }
+  return {
+    content: [{
+      type: 'text',
+      text: JSON.stringify(matchedItems.map(buildComponentResult))
+    }]
+  };
+};

package/dist/es2019/tools/search-components/list-search-components-tool.js

@@ -0,0 +1,19 @@
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+import { zodToJsonSchema } from '../../helpers/zod-to-json-schema';
+import { searchComponentsInputSchema } from './search-components-input-schema';
+export const listSearchComponentsTool = {
+  name: 'ads_search_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).
+
+WHEN TO USE:
+**Selecting which ADS component to use**—package name, examples, and props—before 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,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  },
+  inputSchema: zodToJsonSchema(searchComponentsInputSchema)
+};

package/dist/es2019/tools/search-components/search-components-input-schema.js

@@ -0,0 +1,6 @@
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+import { z } from 'zod';
+export const searchComponentsInputSchema = z.object({
+  terms: z.array(z.string()).describe('Required: one or more search terms (fuzzy over name, package, category, description, keywords, examples). Example: `["button", "modal", "select"]`.'),
+  limit: z.number().default(2).describe('Max matches **per term** (default 2).').optional()
+});

package/dist/es2019/tools/search-components/{index.js → search-components-tool.js}

@@ -1,28 +1,9 @@
 /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
 
 import Fuse from 'fuse.js';
-import { z } from 'zod';
-import { cleanQuery, mergeMultiTermFuseResults, zodToJsonSchema } from '../../helpers';
+import { mergeMultiTermFuseResults } from '../../helpers';
+import { cleanQuery } from '../../helpers/clean-query';
 import { loadAllComponents } from '../get-all-components/load-all-components';
-export const searchComponentsInputSchema = z.object({
-  terms: z.array(z.string()).describe('Required: one or more search terms (fuzzy over name, package, category, description, keywords, examples). Example: `["button", "modal", "select"]`.'),
-  limit: z.number().default(2).describe('Max matches **per term** (default 2).').optional()
-});
-export const listSearchComponentsTool = {
-  name: 'ads_search_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).
-
-WHEN TO USE:
-**Selecting which ADS component to use**—package name, examples, and props—before 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,
-    destructiveHint: false,
-    idempotentHint: true,
-    openWorldHint: true
-  },
-  inputSchema: zodToJsonSchema(searchComponentsInputSchema)
-};
 const buildComponentResult = result => {
   return {
     name: result.name,

package/dist/es2019/tools/search-icons/list-search-icons-tool.js

@@ -0,0 +1,25 @@
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+import { zodToJsonSchema } from '../../helpers/zod-to-json-schema';
+import { searchIconsInputSchema } from './search-icons-input-schema';
+export const listSearchIconsTool = {
+  name: 'ads_search_icons',
+  description: `Searches the bundled Atlassian Design System **icon** catalog. Returns JSON with **componentName**, **package**, and **usage** for each match.
+
+WHEN TO USE:
+**Choosing an icon** for a control, nav item, empty state, or illustration—find \`@atlaskit/icon\` import paths and usage notes. Prefer \`ads_plan\` when you also need tokens and components together.
+
+Example:
+\`\`\`tsx
+import AddIcon from '@atlaskit/icon/core/add';
+<AddIcon label="Add work item" size="small" />
+\`\`\``,
+  annotations: {
+    title: 'Search ADS icons',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  },
+  inputSchema: zodToJsonSchema(searchIconsInputSchema)
+};

package/dist/es2019/tools/search-icons/search-icons-input-schema.js

@@ -0,0 +1,6 @@
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+import { z } from 'zod';
+export const searchIconsInputSchema = z.object({
+  terms: z.array(z.string()).describe('Required: one or more terms; fuzzy match on icon **componentName**, **iconName**, **keywords**, **categorization**, **type**, and **usage**. Example: `["search", "folder", "user"]`.'),
+  limit: z.number().default(2).describe('Max matches **per term** (default 2).').optional()
+});

package/dist/es2019/tools/search-icons/{index.js → search-icons-tool.js}

@@ -1,39 +1,14 @@
 /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
 
 import Fuse from 'fuse.js';
-import { z } from 'zod';
-import { cleanQuery, mergeMultiTermFuseResults, zodToJsonSchema } from '../../helpers';
+import { mergeMultiTermFuseResults } from '../../helpers';
+import { cleanQuery } from '../../helpers/clean-query';
 import { icons } from '../get-all-icons/icons';
-export const searchIconsInputSchema = z.object({
-  terms: z.array(z.string()).describe('Required: one or more terms; fuzzy match on icon **componentName**, **iconName**, **keywords**, **categorization**, **type**, and **usage**. Example: `["search", "folder", "user"]`.'),
-  limit: z.number().default(2).describe('Max matches **per term** (default 2).').optional()
-});
 const buildIconResult = icon => ({
   componentName: icon.componentName,
   package: icon.package,
   usage: icon.usage
 });
-export const listSearchIconsTool = {
-  name: 'ads_search_icons',
-  description: `Searches the bundled Atlassian Design System **icon** catalog. Returns JSON with **componentName**, **package**, and **usage** for each match.
-
-WHEN TO USE:
-**Choosing an icon** for a control, nav item, empty state, or illustration—find \`@atlaskit/icon\` import paths and usage notes. Prefer \`ads_plan\` when you also need tokens and components together.
-
-Example:
-\`\`\`tsx
-import AddIcon from '@atlaskit/icon/core/add';
-<AddIcon label="Add work item" size="small" />
-\`\`\``,
-  annotations: {
-    title: 'Search ADS icons',
-    readOnlyHint: true,
-    destructiveHint: false,
-    idempotentHint: true,
-    openWorldHint: true
-  },
-  inputSchema: zodToJsonSchema(searchIconsInputSchema)
-};
 export const searchIconsTool = async ({
   terms,
   limit = 2

package/dist/es2019/tools/search-tokens/list-search-tokens-tool.js

@@ -0,0 +1,25 @@
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+import { zodToJsonSchema } from '../../helpers/zod-to-json-schema';
+import { searchTokensInputSchema } from './search-tokens-input-schema';
+export const listSearchTokensTool = {
+  name: 'ads_search_tokens',
+  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).
+
+WHEN TO USE:
+**Styling or theming in code**—you need the right \`token('…')\` 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.
+
+Example:
+\`\`\`tsx
+import { token } from '@atlaskit/tokens';
+const styles = css({ color: token('color.text'), padding: token('space.100') });
+\`\`\``,
+  annotations: {
+    title: 'Search ADS tokens',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  },
+  inputSchema: zodToJsonSchema(searchTokensInputSchema)
+};

package/dist/es2019/tools/search-tokens/search-tokens-input-schema.js

@@ -0,0 +1,6 @@
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+import { z } from 'zod';
+export const searchTokensInputSchema = z.object({
+  terms: z.array(z.string()).describe('Required: one or more terms; fuzzy match on token **name**, **description**, **exampleValue**, **usageGuidelines.usage**, and **usageGuidelines.cssProperties**. Example: `["spacing", "color.text", "background"]`.'),
+  limit: z.number().default(2).describe('Max matches **per term** (default 2).').optional()
+});

package/dist/es2019/tools/search-tokens/{index.js → search-tokens-tool.js}

@@ -1,34 +1,9 @@
 /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
 
 import Fuse from 'fuse.js';
-import { z } from 'zod';
 import { tokens } from '@atlaskit/tokens/token-metadata';
-import { cleanQuery, mergeMultiTermFuseResults, zodToJsonSchema } from '../../helpers';
-export const searchTokensInputSchema = z.object({
-  terms: z.array(z.string()).describe('Required: one or more terms; fuzzy match on token **name**, **description**, **exampleValue**, **usageGuidelines.usage**, and **usageGuidelines.cssProperties**. Example: `["spacing", "color.text", "background"]`.'),
-  limit: z.number().default(2).describe('Max matches **per term** (default 2).').optional()
-});
-export const listSearchTokensTool = {
-  name: 'ads_search_tokens',
-  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).
-
-WHEN TO USE:
-**Styling or theming in code**—you need the right \`token('…')\` 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.
-
-Example:
-\`\`\`tsx
-import { token } from '@atlaskit/tokens';
-const styles = css({ color: token('color.text'), padding: token('space.100') });
-\`\`\``,
-  annotations: {
-    title: 'Search ADS tokens',
-    readOnlyHint: true,
-    destructiveHint: false,
-    idempotentHint: true,
-    openWorldHint: true
-  },
-  inputSchema: zodToJsonSchema(searchTokensInputSchema)
-};
+import { mergeMultiTermFuseResults } from '../../helpers';
+import { cleanQuery } from '../../helpers/clean-query';
 export const searchTokensTool = async ({
   terms,
   limit = 2

package/dist/es2019/tools/suggest-a11y-fixes/list-suggest-a11y-fixes-tool.js

@@ -0,0 +1,25 @@
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+import { zodToJsonSchema } from '../../helpers/zod-to-json-schema';
+import { suggestA11yFixesInputSchema } from './suggest-a11y-fixes-input-schema';
+export const listSuggestA11yFixesTool = {
+  name: 'ads_suggest_a11y_fixes',
+  description: `Suggests remediation steps for an accessibility issue described in natural language (often pasted from **axe-core**, ESLint, or review).
+
+WHAT YOU GET (varies by match):
+- **Curated hit:** ADS-biased examples and patterns from this server’s recipe map (components, tokens, common fixes).
+- **No strong match:** Generic guidance (e.g. “use ADS components”, labeling, testing)—still useful, but **not** guaranteed to be ADS-specific. May reference axe/atlassian.design resources.
+
+WHEN TO USE:
+After \`ads_analyze_a11y\` or \`ads_analyze_localhost_a11y\`, or whenever you have a violation string. For **topic-level** Atlassian Design System accessibility guidance, call \`ads_get_a11y_guidelines\` (this tool is fix-oriented, not a full guideline browse).
+
+Does not replace manual testing with assistive technologies or keyboard-only navigation.`,
+  annotations: {
+    title: 'Suggest accessibility fixes',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  },
+  inputSchema: zodToJsonSchema(suggestA11yFixesInputSchema)
+};

package/dist/es2019/tools/suggest-a11y-fixes/suggest-a11y-fixes-input-schema.js

@@ -0,0 +1,8 @@
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+import { z } from 'zod';
+export const suggestA11yFixesInputSchema = z.object({
+  violation: z.string().describe('Human-readable description of the issue (e.g. axe rule help text, "button has no accessible name", "missing alt"). Used to match curated recipes when possible; otherwise the tool falls back to generic guidance.'),
+  code: z.string().describe('Snippet of the problematic code or markup so the response can be tailored (may be shown in the output for traceability).'),
+  component: z.string().optional().describe('Optional: React component name involved (e.g. `Button`, `TextField`)—may be ADS or app-specific.'),
+  context: z.string().optional().describe('Optional: where this appears (e.g. modal, table row, page section) or constraints.')
+});

package/dist/es2019/tools/suggest-a11y-fixes/{index.js → suggest-a11y-fixes-tool.js}

@@ -1,37 +1,7 @@
 /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
 
-import { z } from 'zod';
-import { zodToJsonSchema } from '../../helpers';
 import { accessibilityFixes } from './fixes';
 import { violationKeywords } from './keywords';
-export const suggestA11yFixesInputSchema = z.object({
-  violation: z.string().describe('Human-readable description of the issue (e.g. axe rule help text, "button has no accessible name", "missing alt"). Used to match curated recipes when possible; otherwise the tool falls back to generic guidance.'),
-  code: z.string().describe('Snippet of the problematic code or markup so the response can be tailored (may be shown in the output for traceability).'),
-  component: z.string().optional().describe('Optional: React component name involved (e.g. `Button`, `TextField`)—may be ADS or app-specific.'),
-  context: z.string().optional().describe('Optional: where this appears (e.g. modal, table row, page section) or constraints.')
-});
-export const listSuggestA11yFixesTool = {
-  name: 'ads_suggest_a11y_fixes',
-  description: `Suggests remediation steps for an accessibility issue described in natural language (often pasted from **axe-core**, ESLint, or review).
-
-WHAT YOU GET (varies by match):
-- **Curated hit:** ADS-biased examples and patterns from this server’s recipe map (components, tokens, common fixes).
-- **No strong match:** Generic guidance (e.g. “use ADS components”, labeling, testing)—still useful, but **not** guaranteed to be ADS-specific. May reference axe/atlassian.design resources.
-
-WHEN TO USE:
-After \`ads_analyze_a11y\` or \`ads_analyze_localhost_a11y\`, or whenever you have a violation string. For **topic-level** Atlassian Design System accessibility guidance, call \`ads_get_a11y_guidelines\` (this tool is fix-oriented, not a full guideline browse).
-
-Does not replace manual testing with assistive technologies or keyboard-only navigation.`,
-  annotations: {
-    title: 'Suggest accessibility fixes',
-    readOnlyHint: true,
-    destructiveHint: false,
-    idempotentHint: true,
-    openWorldHint: true
-  },
-  inputSchema: zodToJsonSchema(suggestA11yFixesInputSchema)
-};
-
 // Keyword mappings for fuzzy matching - imported from keywords.ts
 // This allows flexible user input when describing accessibility violations
 

package/dist/esm/entry-points/analyze-a11y.js

@@ -0,0 +1,5 @@
+export { analyzeA11yInputSchema } from '../tools/analyze-a11y/analyze-a11y-input-schema';
+export { listAnalyzeA11yTool } from '../tools/analyze-a11y/list-analyze-a11y-tool';
+export { analyzeA11yLocalhostInputSchema } from '../tools/analyze-a11y/analyze-a11y-localhost-input-schema';
+export { listAnalyzeLocalhostA11yTool } from '../tools/analyze-a11y/list-analyze-localhost-a11y-tool';
+export { analyzeA11yTool } from '../tools/analyze-a11y/analyze-a11y-tool';

package/dist/esm/entry-points/get-a11y-guidelines.js

@@ -0,0 +1,3 @@
+export { getA11yGuidelinesInputSchema } from '../tools/get-a11y-guidelines/get-a11y-guidelines-input-schema';
+export { listGetA11yGuidelinesTool } from '../tools/get-a11y-guidelines/list-get-a11y-guidelines-tool';
+export { getA11yGuidelinesTool } from '../tools/get-a11y-guidelines/get-a11y-guidelines-tool';

package/dist/esm/entry-points/get-all-components.js

@@ -0,0 +1,2 @@
+export { listGetAllComponentsTool } from '../tools/get-all-components/list-get-all-components-tool';
+export { getAllComponentsTool } from '../tools/get-all-components/get-all-components-tool';

package/dist/esm/entry-points/get-all-icons.js

@@ -0,0 +1,2 @@
+export { listGetAllIconsTool } from '../tools/get-all-icons/list-get-all-icons-tool';
+export { getAllIconsTool } from '../tools/get-all-icons/get-all-icons-tool';

package/dist/esm/entry-points/get-all-tokens.js

@@ -0,0 +1,2 @@
+export { listGetAllTokensTool } from '../tools/get-all-tokens/list-get-all-tokens-tool';
+export { getAllTokensTool } from '../tools/get-all-tokens/get-all-tokens-tool';

package/dist/esm/entry-points/get-atlaskit-components.js

@@ -0,0 +1,2 @@
+export { listGetAtlaskitComponentsTool } from '../tools/get-atlaskit-components/list-get-atlaskit-components-tool';
+export { getAtlaskitComponentsTool } from '../tools/get-atlaskit-components/get-atlaskit-components-tool';

package/dist/esm/entry-points/get-guidelines.js

@@ -0,0 +1,3 @@
+export { listGetGuidelinesTool } from '../tools/get-guidelines/list-get-guidelines-tool';
+export { getGuidelinesTool } from '../tools/get-guidelines/get-guidelines-tool';
+export { getGuidelinesInputSchema } from '../tools/get-guidelines/get-guidelines-input-schema';

package/dist/esm/entry-points/get-lint-rules.js

@@ -0,0 +1,3 @@
+export { getLintRulesInputSchema } from '../tools/get-lint-rules/get-lint-rules-input-schema';
+export { listGetLintRulesTool } from '../tools/get-lint-rules/list-get-lint-rules-tool';
+export { getLintRulesTool } from '../tools/get-lint-rules/get-lint-rules-tool';

package/dist/esm/entry-points/i18n-conversion.js

@@ -0,0 +1,3 @@
+export { i18nConversionInputSchema } from '../tools/i18n-conversion/i18n-conversion-input-schema';
+export { listI18nConversionTool } from '../tools/i18n-conversion/list-i18n-conversion-tool';
+export { i18nConversionTool } from '../tools/i18n-conversion/i18n-conversion-tool';

package/dist/esm/entry-points/migration-guides.js

@@ -0,0 +1,3 @@
+export { migrationGuidesInputSchema } from '../tools/migration-guides/migration-guides-input-schema';
+export { listMigrationGuidesTool } from '../tools/migration-guides/list-migration-guides-tool';
+export { migrationGuidesTool } from '../tools/migration-guides/migration-guides-tool';

package/dist/esm/entry-points/plan.js

@@ -0,0 +1,3 @@
+export { planInputSchema } from '../tools/plan/plan-input-schema';
+export { listPlanTool } from '../tools/plan/list-plan-tool';
+export { planTool } from '../tools/plan/plan-tool';

package/dist/esm/entry-points/search-atlaskit-components.js

@@ -0,0 +1,3 @@
+export { searchAtlaskitComponentsInputSchema } from '../tools/search-atlaskit-components/search-atlaskit-components-input-schema';
+export { listSearchAtlaskitComponentsTool } from '../tools/search-atlaskit-components/list-search-atlaskit-components-tool';
+export { searchAtlaskitComponentsTool } from '../tools/search-atlaskit-components/search-atlaskit-components-tool';

package/dist/esm/entry-points/search-components.js

@@ -0,0 +1,3 @@
+export { searchComponentsInputSchema } from '../tools/search-components/search-components-input-schema';
+export { listSearchComponentsTool } from '../tools/search-components/list-search-components-tool';
+export { searchComponentsTool } from '../tools/search-components/search-components-tool';

package/dist/esm/entry-points/search-icons.js

@@ -0,0 +1,3 @@
+export { searchIconsInputSchema } from '../tools/search-icons/search-icons-input-schema';
+export { listSearchIconsTool } from '../tools/search-icons/list-search-icons-tool';
+export { searchIconsTool } from '../tools/search-icons/search-icons-tool';

package/dist/esm/entry-points/search-tokens.js

@@ -0,0 +1,3 @@
+export { searchTokensInputSchema } from '../tools/search-tokens/search-tokens-input-schema';
+export { listSearchTokensTool } from '../tools/search-tokens/list-search-tokens-tool';
+export { searchTokensTool } from '../tools/search-tokens/search-tokens-tool';

package/dist/esm/entry-points/suggest-a11y-fixes.js

@@ -0,0 +1,3 @@
+export { suggestA11yFixesInputSchema } from '../tools/suggest-a11y-fixes/suggest-a11y-fixes-input-schema';
+export { listSuggestA11yFixesTool } from '../tools/suggest-a11y-fixes/list-suggest-a11y-fixes-tool';
+export { suggestA11yFixesTool } from '../tools/suggest-a11y-fixes/suggest-a11y-fixes-tool';

package/dist/esm/helpers/agent.js

@@ -0,0 +1,3 @@
+/* eslint-disable no-console */
+
+export var agent = process.env.ADSMCP_AGENT || 'unknown';

package/dist/esm/helpers/clean-query.js

@@ -0,0 +1,4 @@
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+export var cleanQuery = function cleanQuery(query) {
+  return query.trim().toLowerCase().replace(/\s+/g, '');
+};

package/dist/esm/helpers/index.js

@@ -1,10 +1,3 @@
-/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
-
-import { zodToJsonSchema as zodToJsonSchemaHelper } from 'zod-to-json-schema';
 export { computeMultiTermFuseAllocation, mergeMultiTermFuseResults } from './fuse-multi-term';
-export var cleanQuery = function cleanQuery(query) {
-  return query.trim().toLowerCase().replace(/\s+/g, '');
-};
-export var zodToJsonSchema = function zodToJsonSchema(schema, options) {
-  return zodToJsonSchemaHelper(schema, options);
-};
+export { cleanQuery } from './clean-query';
+export { zodToJsonSchema } from './zod-to-json-schema';

package/dist/esm/helpers/send-operational-event.js

@@ -0,0 +1,52 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+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) { _defineProperty(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 no-console */
+
+import { agent } from './agent';
+import { configPath } from './config-path';
+import { staffId } from './staff-id';
+
+// eslint-disable-next-line import/no-extraneous-dependencies -- this uses require because not all node versions this package supports use the same import assertions/attributes
+var pkgJson = require('@atlaskit/ads-mcp/package.json');
+var version = pkgJson.version || '0.0.0-unknown';
+var analyticsClient = null;
+/**
+ * Send an operational event to analytics
+ * Wraps the analytics client and handles errors gracefully
+ * If analytics client is not available, this function is a no-op
+ */
+export function sendOperationalEvent(_ref) {
+  var action = _ref.action,
+    actionSubject = _ref.actionSubject,
+    _ref$actionSubjectId = _ref.actionSubjectId,
+    actionSubjectId = _ref$actionSubjectId === void 0 ? '' : _ref$actionSubjectId,
+    _ref$attributes = _ref.attributes,
+    attributes = _ref$attributes === void 0 ? {} : _ref$attributes;
+  // If analytics client is not available, skip analytics
+  if (!analyticsClient) {
+    return;
+  }
+  try {
+    analyticsClient.sendOperationalEvent({
+      anonymousId: 'unknown',
+      operationalEvent: {
+        action: action,
+        actionSubject: actionSubject,
+        actionSubjectId: actionSubjectId,
+        source: '@atlaskit/ads-mcp',
+        tags: ['ads-mcp'],
+        attributes: _objectSpread({
+          version: version,
+          staffId: staffId,
+          agent: agent,
+          configPath: configPath
+        }, attributes)
+      }
+    });
+  } catch (_unused) {
+    // Analytics errors should not prevent normal operation
+    // Silently fail to avoid disrupting the main functionality
+    console.error('Error sending operational event to analytics');
+  }
+}

package/dist/esm/helpers/validation.js

@@ -1,6 +1,6 @@
 /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
 
-import { zodToJsonSchema } from './index';
+import { zodToJsonSchema } from './zod-to-json-schema';
 /**
  * Validates arguments against a Zod schema and returns a discriminated union result.
  *

package/dist/esm/helpers/zod-to-json-schema.js

@@ -0,0 +1,6 @@
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+import { zodToJsonSchema as zodToJsonSchemaHelper } from 'zod-to-json-schema';
+export var zodToJsonSchema = function zodToJsonSchema(schema, options) {
+  return zodToJsonSchemaHelper(schema, options);
+};