@atlaskit/ads-mcp 0.7.2 → 0.8.0

package/dist/cjs/tools/get-components/components.js

@@ -9,7 +9,7 @@ exports.components = void 0;
  *
  * Generates TypeScript components data for AI tooling from offerings.json files
  *
- * @codegen <<SignedSource::d39d38cf9fe44e75308cd943349942d1>>
+ * @codegen <<SignedSource::1792e8b918fbdc85769f6ddf38970c58>>
  * @codegenCommand yarn workspace @af/ads-ai-tooling codegen:prototyping
  */
 
@@ -1695,7 +1695,7 @@ var components = exports.components = [{
     type: '"off" | "on"'
   }, {
     name: 'children',
-    description: 'The contents rendered inside of the form. This is a function where the props will be passed from the form. The function props you can access are `dirty`, `submitting` and `disabled`.\n You can read more about these props in [react-final form documentation](https://final-form.org/docs/final-form/types/FormState).',
+    description: 'The contents rendered inside of the form. This is a function where the props will be passed from the form. The function props you can access are `dirty`, `submitting` and `disabled`.\nYou can read more about these props in [react-final form documentation](https://final-form.org/docs/final-form/types/FormState).\n\nIf you are only spreading `formProps` onto the HTML `<form>` element and not using any of the other props (like `submitting`, etc.), `children` can be plain JSX. All of the children will be wrapped within an HTML `<form>` element that includes all necessary props, including those provided on the form component.',
     type: '(() => void) | React.ReactNode | ((args: FormChildrenArgs<FormValues>) => React.ReactNode)'
   }, {
     name: 'formProps',

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

@@ -24,7 +24,7 @@ var listGetComponentsTool = exports.listGetComponentsTool = {
 };
 var getComponentsTool = exports.getComponentsTool = /*#__PURE__*/function () {
   var _ref = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee() {
-    return _regenerator.default.wrap(function _callee$(_context) {
+    return _regenerator.default.wrap(function (_context) {
       while (1) switch (_context.prev = _context.next) {
         case 0:
           return _context.abrupt("return", {

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

@@ -37,12 +37,12 @@ var listPlanTool = exports.listPlanTool = {
 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;
-    return _regenerator.default.wrap(function _callee$(_context) {
+    return _regenerator.default.wrap(function (_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
           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;
+            _context.next = 1;
             break;
           }
           return _context.abrupt("return", {
@@ -52,7 +52,7 @@ var planTool = exports.planTool = /*#__PURE__*/function () {
               text: 'Error: At least one search type (tokens_search, icons_search, or components_search) must be provided with search terms'
             }]
           });
-        case 3:
+        case 1:
           results = {}; // Execute searches in parallel
           searchPromises = [];
           if (tokens_search !== null && tokens_search !== void 0 && tokens_search.length) {
@@ -84,9 +84,9 @@ var planTool = exports.planTool = /*#__PURE__*/function () {
           }
 
           // Wait for all searches to complete
-          _context.next = 10;
+          _context.next = 2;
           return Promise.all(searchPromises);
-        case 10:
+        case 2:
           // Helper function to safely count results
           getResultCount = function getResultCount(result) {
             var _result$content;
@@ -124,7 +124,7 @@ var planTool = exports.planTool = /*#__PURE__*/function () {
               text: JSON.stringify(consolidatedResult, null, 2)
             }]
           });
-        case 13:
+        case 3:
         case "end":
           return _context.stop();
       }

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

@@ -42,13 +42,13 @@ 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, exactNameMatches, fuse, results, uniqueResults;
-    return _regenerator.default.wrap(function _callee$(_context) {
+    return _regenerator.default.wrap(function (_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 (searchTerms.length) {
-            _context.next = 4;
+            _context.next = 1;
             break;
           }
           return _context.abrupt("return", {
@@ -58,9 +58,9 @@ var searchComponentsTool = exports.searchComponentsTool = /*#__PURE__*/function
               text: "Error: Required parameter 'terms' is missing or empty"
             }]
           });
-        case 4:
+        case 1:
           if (!exactName) {
-            _context.next = 8;
+            _context.next = 2;
             break;
           }
           // for each search term, search for the exact match
@@ -70,7 +70,7 @@ var searchComponentsTool = exports.searchComponentsTool = /*#__PURE__*/function
             });
           }).filter(Boolean);
           if (!(exactNameMatches.length > 0)) {
-            _context.next = 8;
+            _context.next = 2;
             break;
           }
           return _context.abrupt("return", {
@@ -79,7 +79,7 @@ var searchComponentsTool = exports.searchComponentsTool = /*#__PURE__*/function
               text: JSON.stringify(exactNameMatches.map(cleanComponentResult))
             }]
           });
-        case 8:
+        case 2:
           // use Fuse.js to fuzzy-search through the components
           fuse = new _fuse.default(_components.components, {
             keys: [{
@@ -113,7 +113,7 @@ var searchComponentsTool = exports.searchComponentsTool = /*#__PURE__*/function
             return fuse.search(term).slice(0, limit);
           }).flat();
           if (results.length) {
-            _context.next = 12;
+            _context.next = 3;
             break;
           }
           return _context.abrupt("return", {
@@ -125,7 +125,7 @@ var searchComponentsTool = exports.searchComponentsTool = /*#__PURE__*/function
               }).join(', '))
             }]
           });
-        case 12:
+        case 3:
           // Remove duplicates based on component name
           uniqueResults = results.filter(function (result, index, arr) {
             return arr.findIndex(function (r) {
@@ -140,7 +140,7 @@ var searchComponentsTool = exports.searchComponentsTool = /*#__PURE__*/function
               }).map(cleanComponentResult))
             }]
           });
-        case 14:
+        case 4:
         case "end":
           return _context.stop();
       }

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

@@ -50,13 +50,13 @@ var listSearchIconsTool = exports.listSearchIconsTool = {
 var searchIconsTool = exports.searchIconsTool = /*#__PURE__*/function () {
   var _ref3 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(params) {
     var terms, _params$limit, limit, _params$exactName, exactName, searchTerms, exactNameMatches, fuse, results, uniqueResults, matchedIcons;
-    return _regenerator.default.wrap(function _callee$(_context) {
+    return _regenerator.default.wrap(function (_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 (searchTerms.length) {
-            _context.next = 4;
+            _context.next = 1;
             break;
           }
           return _context.abrupt("return", {
@@ -66,9 +66,9 @@ var searchIconsTool = exports.searchIconsTool = /*#__PURE__*/function () {
               text: "Error: Required parameter 'terms' is missing or empty"
             }]
           });
-        case 4:
+        case 1:
           if (!exactName) {
-            _context.next = 8;
+            _context.next = 2;
             break;
           }
           // for each search term, search for the exact match
@@ -78,7 +78,7 @@ var searchIconsTool = exports.searchIconsTool = /*#__PURE__*/function () {
             });
           }).filter(Boolean);
           if (!(exactNameMatches.length > 0)) {
-            _context.next = 8;
+            _context.next = 2;
             break;
           }
           return _context.abrupt("return", {
@@ -87,7 +87,7 @@ var searchIconsTool = exports.searchIconsTool = /*#__PURE__*/function () {
               text: JSON.stringify(exactNameMatches)
             }]
           });
-        case 8:
+        case 2:
           // use Fuse.js to fuzzy-search through the icons
           fuse = new _fuse.default(icons, {
             keys: [{
@@ -124,7 +124,7 @@ var searchIconsTool = exports.searchIconsTool = /*#__PURE__*/function () {
             return fuse.search(term).slice(0, limit);
           }).flat();
           if (results.length) {
-            _context.next = 12;
+            _context.next = 3;
             break;
           }
           return _context.abrupt("return", {
@@ -136,7 +136,7 @@ var searchIconsTool = exports.searchIconsTool = /*#__PURE__*/function () {
               }).join(', '))
             }]
           });
-        case 12:
+        case 3:
           // Remove duplicates based on componentName
           uniqueResults = results.filter(function (result, index, arr) {
             return arr.findIndex(function (r) {
@@ -156,7 +156,7 @@ var searchIconsTool = exports.searchIconsTool = /*#__PURE__*/function () {
               text: JSON.stringify(matchedIcons)
             }]
           });
-        case 15:
+        case 4:
         case "end":
           return _context.stop();
       }

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

@@ -32,13 +32,13 @@ var listSearchTokensTool = exports.listSearchTokensTool = {
 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;
-    return _regenerator.default.wrap(function _callee$(_context) {
+    return _regenerator.default.wrap(function (_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;
+            _context.next = 1;
             break;
           }
           // for each search term, search for the exact match
@@ -48,7 +48,7 @@ var searchTokensTool = exports.searchTokensTool = /*#__PURE__*/function () {
             });
           }).filter(Boolean);
           if (!(exactNameMatches.length > 0)) {
-            _context.next = 6;
+            _context.next = 1;
             break;
           }
           return _context.abrupt("return", {
@@ -62,7 +62,7 @@ var searchTokensTool = exports.searchTokensTool = /*#__PURE__*/function () {
               }))
             }]
           });
-        case 6:
+        case 1:
           // use Fuse.js to fuzzy-search for the tokens
           fuse = new _fuse.default(_tokenMetadata.tokens, {
             keys: [{
@@ -97,7 +97,7 @@ var searchTokensTool = exports.searchTokensTool = /*#__PURE__*/function () {
               text: JSON.stringify(matchedTokens)
             }]
           });
-        case 11:
+        case 2:
         case "end":
           return _context.stop();
       }

package/dist/cjs/tools/suggest-a11y-fixes/index.js

@@ -118,13 +118,13 @@ function findBestMatchingFix(violation) {
 var suggestA11yFixesTool = exports.suggestA11yFixesTool = /*#__PURE__*/function () {
   var _ref = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(params) {
     var violation, component, context, match, _match, key, fix;
-    return _regenerator.default.wrap(function _callee$(_context) {
+    return _regenerator.default.wrap(function (_context) {
       while (1) switch (_context.prev = _context.next) {
         case 0:
           violation = params.violation, component = params.component, context = params.context; // Use improved matching logic
           match = findBestMatchingFix(violation);
           if (!match) {
-            _context.next = 5;
+            _context.next = 1;
             break;
           }
           _match = (0, _slicedToArray2.default)(match, 2), key = _match[0], fix = _match[1];
@@ -142,7 +142,7 @@ var suggestA11yFixesTool = exports.suggestA11yFixesTool = /*#__PURE__*/function
               }), null, 2)
             }]
           });
-        case 5:
+        case 1:
           return _context.abrupt("return", {
             content: [{
               type: 'text',
@@ -173,7 +173,7 @@ var suggestA11yFixesTool = exports.suggestA11yFixesTool = /*#__PURE__*/function
               }, null, 2)
             }]
           });
-        case 6:
+        case 2:
         case "end":
           return _context.stop();
       }

package/dist/es2019/helpers/analytics.js

@@ -0,0 +1,88 @@
+/* eslint-disable no-console */
+import { userInfo } from 'node:os';
+// 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
+const pkgJson = require('@atlaskit/ads-mcp/package.json');
+const version = pkgJson.version || '0.0.0-unknown';
+
+// Get staff ID using the same logic as @repo-feature-flags-statsig
+export const staffId = process.env.STAFF_ID || process.env.USER || process.env.ATLAS_USER || userInfo().username;
+
+/**
+ * This is a user-passed value via environment to define what agent we may be running in.
+ * This could be anything, do not rely on it!
+ * @default `'unknown'`
+ */
+
+export const agent = process.env.ADSMCP_AGENT || 'unknown';
+
+/**
+ * The path to the MCP config file that is being used to run the MCP server
+ * e.g. 'mcp.json', 'jira/.cursor/mcp.json', 'platform/.vscode/mcp.json' or 'unknown'
+ * This could be anything, do not rely on it!
+ * @default `'unknown'`
+ */
+export const configPath = process.env.ADSMCP_CONFIG_PATH || 'unknown';
+
+// Check if user has opted out of analytics
+const isAnalyticsOptedOut = String(process.env.ADSMCP_ANALYTICS_OPT_OUT) === 'true' || String(process.env.ADSMCP_ANALYTICS_OPT_OUT) === '1';
+
+// Initialize analytics client with error handling
+// If analytics client fails to initialize or user has opted out, we continue without analytics
+let analyticsClient = null;
+if (!isAnalyticsOptedOut) {
+  try {
+    // Dynamic import to catch initialization errors
+    const {
+      analyticsClient: createAnalyticsClient
+    } = require('@atlassiansox/analytics-node-client');
+    analyticsClient = createAnalyticsClient({
+      env: process.env.NODE_ENV === 'development' ? 'dev' : 'prod',
+      product: 'atlaskit',
+      subproduct: 'ads-mcp',
+      flushInterval: 5000
+    });
+  } catch (error) {
+    // Analytics client not available or failed to initialize
+    // Log the error but continue without analytics
+    console.error('Could not initialize analytics client. This is normal as it is only intended to measure authenticated Atlassians');
+  }
+}
+/**
+ * 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({
+  action,
+  actionSubject,
+  actionSubjectId = '',
+  attributes = {}
+}) {
+  // If analytics client is not available, skip analytics
+  if (!analyticsClient) {
+    return;
+  }
+  try {
+    analyticsClient.sendOperationalEvent({
+      anonymousId: 'unknown',
+      operationalEvent: {
+        action,
+        actionSubject,
+        actionSubjectId,
+        source: '@atlaskit/ads-mcp',
+        tags: ['ads-mcp'],
+        attributes: {
+          version,
+          staffId,
+          agent,
+          configPath,
+          ...attributes
+        }
+      }
+    });
+  } catch (error) {
+    // 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/es2019/index.js

@@ -1,7 +1,8 @@
-/* eslint-disable import/extensions */
+/* eslint-disable no-console, import/extensions */
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { sendOperationalEvent } from './helpers/analytics';
 import { instructions } from './instructions';
 import { analyzeA11yTool, analyzeLocalhostA11yTool, listAnalyzeA11yTool, listAnalyzeLocalhostA11yTool } from './tools/analyze-a11y';
 import { getA11yGuidelinesTool, listGetA11yGuidelinesTool } from './tools/get-a11y-guidelines';
@@ -22,19 +23,48 @@ const server = new Server({
 }, {
   instructions,
   capabilities: {
+    // logging: {}, // NOTE: We do not have logging enabled as it's not implemented consistently in MCP specs
     // Tools are defined in the handlers below.
     tools: {}
   }
 });
-server.setRequestHandler(ListToolsRequestSchema, async () => {
+const generateLogger = level => (...args) => {
+  // NOTE: We do not have logging enabled as it's not implemented consistently in MCP specs
+  // server.sendLoggingMessage({
+  // 	level,
+  // 	data: args,
+  // });
+
+  // Log to console if ADSMCP_DEBUG is set to true
+  // using console.error since the only one that works for logging is `stderr`
+  // using console.log / other console.fn that use `stdout` will cause an error
+  // ref: https://www.mcpevals.io/blog/debugging-mcp-servers-tips-and-best-practices
+  if (String(process.env.ADSMCP_DEBUG) === 'true') {
+    console.error(`[ads-mcp.custom-logging][${level}]`, ...args);
+  }
+};
+server.setRequestHandler(ListToolsRequestSchema, async (request, extra) => {
+  const tools = [listAnalyzeA11yTool, listAnalyzeLocalhostA11yTool, listGetA11yGuidelinesTool, listGetAllIconsTool, listGetAllTokensTool, listGetComponentsTool, listPlanTool,
+  // NOTE: These are disabled as `ads_plan` should cover everything more performantly.
+  // When these are enabled, they result in token usage to describe them, even if never used.
+  // listSearchComponentsTool,
+  // listSearchIconsTool,
+  // listSearchTokensTool,
+  listSuggestA11yFixesTool];
+
+  // Track list tools request
+  sendOperationalEvent({
+    action: 'listed',
+    actionSubject: 'ads.mcp.listTools',
+    attributes: {
+      toolsCount: tools.length,
+      // Number of available tools
+      request,
+      extra
+    }
+  });
   return {
-    tools: [listAnalyzeA11yTool, listAnalyzeLocalhostA11yTool, listGetA11yGuidelinesTool, listGetAllIconsTool, listGetAllTokensTool, listGetComponentsTool, listPlanTool,
-    // NOTE: These are disabled as `ads_plan` should cover everything more performantly.
-    // When these are enabled, they result in token usage to describe them, even if never used.
-    // listSearchComponentsTool,
-    // listSearchIconsTool,
-    // listSearchTokensTool,
-    listSuggestA11yFixesTool]
+    tools
   };
 });
 const callTools = {
@@ -54,17 +84,90 @@ const callTools = {
 };
 
 // Handle tool execution
-server.setRequestHandler(CallToolRequestSchema, async request => {
-  const tool = callTools[request.params.name];
+server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
+  const toolName = request.params.name;
+  const tool = callTools[toolName];
+  const actionSubject = `ads.mcp.callTool`;
+
+  // Track call tool request
+  sendOperationalEvent({
+    action: 'called',
+    actionSubject,
+    actionSubjectId: toolName,
+    attributes: {
+      toolName,
+      request,
+      extra
+    }
+  });
   if (tool) {
-    return tool(request.params.arguments);
+    try {
+      const result = await tool(request.params.arguments);
+      // Track successful tool execution
+      sendOperationalEvent({
+        action: 'succeeded',
+        actionSubject,
+        actionSubjectId: toolName,
+        attributes: {
+          toolName,
+          request,
+          extra
+        }
+      });
+      return result;
+    } catch (error) {
+      // Track tool execution error
+      sendOperationalEvent({
+        action: 'failed',
+        actionSubject,
+        actionSubjectId: toolName,
+        attributes: {
+          toolName,
+          request,
+          extra,
+          errorMessage: error instanceof Error ? error.message : 'Unknown error'
+        }
+      });
+
+      /* Throwing an MCP error will cause the MCP server to return an error response to the client.
+      We don't use console.error here:
+      - when used alone, without the throw new McpError, it causes "Client error for command...", which will loop back to this catch
+      */
+      throw new McpError(-32000, `Failed to execute '${toolName}' tool: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
   }
-  throw new Error(`Tool '${request.params.name}' not found, only the following tools are available: ${Object.keys(callTools).join(', ')}`);
+
+  // Track tool not found error
+  sendOperationalEvent({
+    action: 'notFound',
+    actionSubject,
+    actionSubjectId: toolName,
+    attributes: {
+      toolName,
+      request,
+      extra
+    }
+  });
+  console.error(`Tool '${request.params.name}' not found, only the following tools are available: ${Object.keys(callTools).join(', ')}`);
+  return;
 });
 async function runServer() {
+  /**
+   * We force all logging to go through the MCP server to avoid breaking the MCP.
+   */
+  console.log = generateLogger('info');
+  console.debug = generateLogger('debug');
+  console.warn = generateLogger('warning');
+
+  // Track server initialization
+  sendOperationalEvent({
+    action: 'initialized',
+    actionSubject: 'ads.mcp.initialize'
+  });
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }
 runServer().catch(error => {
-  throw new Error(`Invalid input to ads-mcp: ${JSON.stringify(error.errors)}`);
+  const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+  console.error(`Invalid input to ads-mcp: ${errorMessage}`);
 });

package/dist/es2019/tools/get-components/components.js

@@ -3,7 +3,7 @@
  *
  * Generates TypeScript components data for AI tooling from offerings.json files
  *
- * @codegen <<SignedSource::d39d38cf9fe44e75308cd943349942d1>>
+ * @codegen <<SignedSource::1792e8b918fbdc85769f6ddf38970c58>>
  * @codegenCommand yarn workspace @af/ads-ai-tooling codegen:prototyping
  */
 
@@ -1689,7 +1689,7 @@ export const components = [{
     type: '"off" | "on"'
   }, {
     name: 'children',
-    description: 'The contents rendered inside of the form. This is a function where the props will be passed from the form. The function props you can access are `dirty`, `submitting` and `disabled`.\n You can read more about these props in [react-final form documentation](https://final-form.org/docs/final-form/types/FormState).',
+    description: 'The contents rendered inside of the form. This is a function where the props will be passed from the form. The function props you can access are `dirty`, `submitting` and `disabled`.\nYou can read more about these props in [react-final form documentation](https://final-form.org/docs/final-form/types/FormState).\n\nIf you are only spreading `formProps` onto the HTML `<form>` element and not using any of the other props (like `submitting`, etc.), `children` can be plain JSX. All of the children will be wrapped within an HTML `<form>` element that includes all necessary props, including those provided on the form component.',
     type: '(() => void) | React.ReactNode | ((args: FormChildrenArgs<FormValues>) => React.ReactNode)'
   }, {
     name: 'formProps',

package/dist/esm/helpers/analytics.js

@@ -0,0 +1,90 @@
+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 { userInfo } from 'node:os';
+// 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';
+
+// Get staff ID using the same logic as @repo-feature-flags-statsig
+export var staffId = process.env.STAFF_ID || process.env.USER || process.env.ATLAS_USER || userInfo().username;
+
+/**
+ * This is a user-passed value via environment to define what agent we may be running in.
+ * This could be anything, do not rely on it!
+ * @default `'unknown'`
+ */
+
+export var agent = process.env.ADSMCP_AGENT || 'unknown';
+
+/**
+ * The path to the MCP config file that is being used to run the MCP server
+ * e.g. 'mcp.json', 'jira/.cursor/mcp.json', 'platform/.vscode/mcp.json' or 'unknown'
+ * This could be anything, do not rely on it!
+ * @default `'unknown'`
+ */
+export var configPath = process.env.ADSMCP_CONFIG_PATH || 'unknown';
+
+// Check if user has opted out of analytics
+var isAnalyticsOptedOut = String(process.env.ADSMCP_ANALYTICS_OPT_OUT) === 'true' || String(process.env.ADSMCP_ANALYTICS_OPT_OUT) === '1';
+
+// Initialize analytics client with error handling
+// If analytics client fails to initialize or user has opted out, we continue without analytics
+var analyticsClient = null;
+if (!isAnalyticsOptedOut) {
+  try {
+    // Dynamic import to catch initialization errors
+    var _require = require('@atlassiansox/analytics-node-client'),
+      createAnalyticsClient = _require.analyticsClient;
+    analyticsClient = createAnalyticsClient({
+      env: process.env.NODE_ENV === 'development' ? 'dev' : 'prod',
+      product: 'atlaskit',
+      subproduct: 'ads-mcp',
+      flushInterval: 5000
+    });
+  } catch (error) {
+    // Analytics client not available or failed to initialize
+    // Log the error but continue without analytics
+    console.error('Could not initialize analytics client. This is normal as it is only intended to measure authenticated Atlassians');
+  }
+}
+/**
+ * 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 (error) {
+    // Analytics errors should not prevent normal operation
+    // Silently fail to avoid disrupting the main functionality
+    console.error('Error sending operational event to analytics');
+  }
+}