@atlaskit/ads-mcp 0.12.0 → 0.13.1

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @atlaskit/ads-mcp
 
+## 0.13.1
+
+### Patch Changes
+
+- Updated dependencies
+
+## 0.13.0
+
+### Minor Changes
+
+- [`1fa31caed8915`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/1fa31caed8915) -
+  Add mcp for i18n hardcoded string conversion
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 0.12.0
 
 ### Minor Changes

package/dist/cjs/index.js

@@ -22,6 +22,7 @@ var _getAllTokens = require("./tools/get-all-tokens");
 var _getComponents = require("./tools/get-components");
 var _getIcons = require("./tools/get-icons");
 var _getTokens = require("./tools/get-tokens");
+var _i18nConversion = require("./tools/i18n-conversion");
 var _migrationGuides = require("./tools/migration-guides");
 var _plan = require("./tools/plan");
 var _suggestA11yFixes = require("./tools/suggest-a11y-fixes");
@@ -62,7 +63,7 @@ var generateLogger = function generateLogger(level) {
   };
 };
 var getToolRegistry = exports.getToolRegistry = function getToolRegistry() {
-  var baseTools = (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)({}, _analyzeA11y.listAnalyzeA11yTool.name, {
+  var 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)({}, _analyzeA11y.listAnalyzeA11yTool.name, {
     handler: _analyzeA11y.analyzeA11yTool,
     inputSchema: _analyzeA11y.analyzeA11yInputSchema,
     tool: _analyzeA11y.listAnalyzeA11yTool
@@ -90,6 +91,10 @@ var getToolRegistry = exports.getToolRegistry = function getToolRegistry() {
     handler: _migrationGuides.migrationGuidesTool,
     inputSchema: _migrationGuides.migrationGuidesInputSchema,
     tool: _migrationGuides.listMigrationGuidesTool
+  }), _i18nConversion.listI18nConversionTool.name, {
+    handler: _i18nConversion.i18nConversionTool,
+    inputSchema: _i18nConversion.i18nConversionInputSchema,
+    tool: _i18nConversion.listI18nConversionTool
   });
 
   // Conditionally add token and icon tools based on feature flag

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

@@ -0,0 +1,52 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.i18nConversionGuide = void 0;
+/**
+ * i18n Conversion Guide - Converting hardcoded strings to use formatMessage
+ */
+
+var i18nConversionGuide = exports.i18nConversionGuide = {
+  id: 'hardcoded-string-to-formatmessage',
+  title: 'Hardcoded String to formatMessage Conversion Guide',
+  description: 'Comprehensive guide for converting hardcoded strings to use formatMessage from @atlassian/jira-intl or react-intl-next',
+  purpose: 'This guide instructs LLM agents to convert hardcoded strings to use formatMessage. The import source depends on the file path: use @atlassian/jira-intl for Jira files (path contains "jira"), and react-intl-next for any non-Jira files. The goal is to find all hardcoded strings in JSX and convert them to internationalized messages.',
+  scope: "**CRITICAL SCOPE**: This process should **ONLY** focus on converting hardcoded strings (literal strings in JSX, eslint-disable comments for no-literal-string-in-jsx, etc.) to use formatMessage. Do NOT modify pre-existing messages that were already in the codebase, even if they have poor descriptions, incorrect placeholder names, or other quality issues. Only convert NEW hardcoded strings.\n\n**PATH SCOPE LIMITATION**: If a specific file, package name, or path is provided, **ONLY** find and convert hardcoded strings within that specified path. Do NOT modify files outside the provided scope.\n\n**CRITICAL: FIX ALL VIOLATIONS IN FILE**: When a specific file is mentioned (even with line numbers like `@file.tsx:139-142`), you MUST find and fix **ALL** @atlassian/i18n/no-literal-string-in-jsx violations in that entire file, not just the specific lines mentioned. Scan the entire file for hardcoded strings and convert them all. The line numbers are just a reference point - the goal is to fix all i18n violations in the provided file.\n\n**CRITICAL: STRING FILTERING**: When finding eslint-disable comments, you MUST examine the actual string content. Only convert strings that contain **user-facing English text**. Many English strings are technical/non-user-facing and should NOT be converted (e.g., product names like \"Jira\", URLs like \"https://example.com\", technical IDs, symbols). Use the ESLint ignore patterns to identify which English strings to skip - strings matching ignore patterns should be LEFT AS-IS with their eslint-disable comments intact.",
+  implementationChecklist: ['Create message constants using defineMessage (singular) at the top of the file - use defineMessage for each individual message, NOT defineMessages', 'Import: Use "@atlassian/jira-intl" for Jira files (with eslint-disable) or "react-intl-next" for non-Jira files', '**CRITICAL: i18n ID Format**: For files in `/next/packages/`, i18n ids MUST start with the package name (with dashes). Format: `{package-name}.{component-or-feature}.{message-key}`. Example: For package `comment-extension-handlers`, use `comment-extension-handlers.legacy-content-modal.close-button`. For package `rovo-ai-search`, use `rovo-ai-search.view-profile-text` or `rovo-ai-search.knowledge-cards.copy-email-address`.', '**CRITICAL: ai-non-final Suffix**: ALL new message IDs MUST end with `.ai-non-final` suffix. This applies to ALL newly created messages, regardless of whether existing messages in the file have this suffix. Format: `{message-key}.ai-non-final`. Example: `applinks.administration.list.applinks-table.system-label.ai-non-final`. This suffix indicates the message is AI-generated and may need review before finalization.', 'Add useIntl hook: const { formatMessage } = useIntl();', 'Replace hardcoded strings with formatMessage(messageKey)', 'Add descriptions (40+ chars, unique from defaultMessage) and descriptive placeholder names', 'Remove eslint-disable for no-literal-string-in-jsx ONLY after converting', '**VERIFICATION**: To verify all hardcoded strings are fixed, search for `@atlassian/i18n/no-literal-string-in-jsx` in the file. Do NOT run eslint - just search for the eslint-disable comments. If no matches are found, all hardcoded strings have been converted.'],
+  patterns: [{
+    title: 'Button Text and Action Labels',
+    description: 'Converting hardcoded button text with variables',
+    before: "<Button style={styles} onClick={onClearVersion}>\n  Exit {description.join(' ')}\n</Button>",
+    after: "// eslint-disable-next-line jira/deprecations/ban-identifiers\nimport { useIntl, defineMessage } from '@atlassian/jira-intl';\n\n// eslint-disable-next-line jira/deprecations/ban-identifiers\nconst exitButton = defineMessage({\n  id: 'rovo-ai-search.exit-button.ai-non-final',\n  defaultMessage: 'Exit {version}',\n  description: 'The text is shown as a button when the user needs to exit the version view. The placeholder {version} will be substituted with the version name. Used in the version header to return to the main view.',\n});\n\nexport function MyComponent() {\n  const { formatMessage } = useIntl();\n\n  return (\n    <Button style={styles} onClick={onClearVersion}>\n      {formatMessage(exitButton, { version: description.join(' ') })}\n    </Button>\n  );\n}",
+    explanation: 'Convert button text with variables to use placeholders in the message. Use descriptive placeholder names that match the variable context.'
+  }, {
+    title: 'Loading States and Status Messages',
+    description: 'Converting hardcoded loading and status messages',
+    before: "return <Box>Loading...</Box>;",
+    after: "// eslint-disable-next-line jira/deprecations/ban-identifiers\nimport { useIntl, defineMessage } from '@atlassian/jira-intl';\n\n// eslint-disable-next-line jira/deprecations/ban-identifiers\nconst loading = defineMessage({\n  id: 'rovo-ai-search.loading.ai-non-final',\n  defaultMessage: 'Loading...',\n  description: 'The text is shown as a loading indicator when work item data is being fetched from the server. Appears in the work item tab to inform users that content is loading.',\n});\n\nexport function MyComponent() {\n  const { formatMessage } = useIntl();\n\n  return (\n    <Box>\n      {formatMessage(loading)}\n    </Box>\n  );\n}",
+    explanation: 'Convert simple hardcoded status messages to use defineMessage (singular). Use defineMessage for each individual message, NOT defineMessages. Ensure descriptions explain when and where the message appears.'
+  }, {
+    title: 'Partial String Translation (Prefixes and Labels)',
+    description: 'Translating only part of a string while preserving UI structure',
+    before: "<Box xcss={styles}>\n  <span>Status: {selectedOptions[0]?.label}</span>\n  {selectedOptions.length > 1 && (\n    <Badge appearance=\"primary\" max={99}>\n      +{selectedOptions.length - 1}\n    </Badge>\n  )}\n</Box>",
+    after: "// eslint-disable-next-line jira/deprecations/ban-identifiers\nimport { useIntl, defineMessage } from '@atlassian/jira-intl';\n\n// eslint-disable-next-line jira/deprecations/ban-identifiers\nconst statusLabel = defineMessage({\n  id: 'filter.status-label.ai-non-final',\n  defaultMessage: 'Status: {status}',\n  description: 'The text is shown as a button label prefix for the status filter. The placeholder {status} will be substituted with the selected status label. Appears in the filter button to show the current filter state.',\n});\n\nexport function MyComponent() {\n  const { formatMessage } = useIntl();\n\n  return (\n    <Box xcss={styles}>\n      <span>\n        {formatMessage(statusLabel, {\n          status: selectedOptions[0]?.label,\n        })}\n      </span>\n      {selectedOptions.length > 1 && (\n        <Badge appearance=\"primary\" max={99}>\n          +{selectedOptions.length - 1}\n        </Badge>\n      )}\n    </Box>\n  );\n}",
+    explanation: 'When only part of a string needs translation (like a prefix "Status: " or label), create a message with a placeholder for the dynamic part. Preserve the existing UI structure (components, conditional rendering, etc.) and only translate the literal string portion.'
+  }, {
+    title: 'Dynamic Text Content',
+    description: 'Converting conditional hardcoded strings',
+    before: "<Text>{state.hasMore ? 'Show more' : 'Show less'}</Text>",
+    after: "// eslint-disable-next-line jira/deprecations/ban-identifiers\nimport { useIntl, defineMessage } from '@atlassian/jira-intl';\n\n// eslint-disable-next-line jira/deprecations/ban-identifiers\nconst showMore = defineMessage({\n  id: 'work-item.comments.show-more.ai-non-final',\n  defaultMessage: 'Show more',\n  description: 'The text is shown as a button when there are more items available to display. Used in the comments section footer to expand and show additional content.',\n});\n\n// eslint-disable-next-line jira/deprecations/ban-identifiers\nconst showLess = defineMessage({\n  id: 'work-item.comments.show-less.ai-non-final',\n  defaultMessage: 'Show less',\n  description: 'The text is shown as a button when the user wants to collapse the expanded view. Used in the comments section footer to hide additional content.',\n});\n\nexport function MyComponent() {\n  const { formatMessage } = useIntl();\n\n  return (\n    <Text>\n      {state.hasMore\n        ? formatMessage(showMore)\n        : formatMessage(showLess)}\n    </Text>\n  );\n}",
+    explanation: 'Create separate message constants for each conditional string. Use descriptive names that reflect the context.'
+  }, {
+    title: 'ICU Format for Numeric Values',
+    description: 'Converting numeric placeholders to ICU plural format',
+    before: "const moreMessage = `+ ${count} more`;",
+    after: "// eslint-disable-next-line jira/deprecations/ban-identifiers\nimport { useIntl, defineMessage } from '@atlassian/jira-intl';\n\n// eslint-disable-next-line jira/deprecations/ban-identifiers\nconst moreProjectsMessage = defineMessage({\n  id: 'app.more-projects.ai-non-final',\n  defaultMessage: '{count, plural, one {+ # more} other {+ # more}}',\n  description: 'The text is shown when there are additional projects available. The placeholder {count} will be substituted with the number of remaining projects. Uses ICU plural format for proper localization.',\n});\n\nexport function MyComponent() {\n  const { formatMessage } = useIntl();\n  const count = 5;\n\n  return (\n    <Text>\n      {formatMessage(moreProjectsMessage, { count })}\n    </Text>\n  );\n}",
+    explanation: 'Use ICU plural format for numeric values that may need pluralization. The # symbol represents the numeric value in ICU format.'
+  }],
+  bestPractices: ['Only convert NEW hardcoded strings - do NOT modify pre-existing messages', '**CRITICAL: Use defineMessage (singular)** - Always use defineMessage for each individual message, NOT defineMessages (plural). Each message should be defined separately: `const messageKey = defineMessage({ ... })`', '**CRITICAL: Always use .ai-non-final suffix** - ALL new message IDs MUST end with `.ai-non-final`. This applies even if existing messages in the file don\'t have this suffix. Format: `{message-key}.ai-non-final`. This indicates the message is AI-generated and may need review.', 'Use descriptive names (userNameLabel not label) and placeholders (userName not value)', 'Add descriptions (40+ chars, unique from defaultMessage)', 'Use ICU plural format for numeric values: {count, plural, one {...} other {...}}', 'Place message constants at top of file, use formatMessage consistently', 'Convert arrow functions to body form if needed for hooks'],
+  commonPitfalls: ['**CRITICAL**: Converting/removing eslint-disable for strings matching ignore patterns - technical/non-user-facing strings should remain hardcoded', '**CRITICAL: Invalid i18n ID format** - For files in `/next/packages/`, must follow `{package-name}.{component-or-feature}.{message-key}`. Common errors: (1) Not starting with package name (with dashes), (2) Missing component/feature segment, (3) Wrong message key format (must be kebab-case, not camelCase). Example correct: `comment-extension-handlers.legacy-content-modal.close-button`.', '**CRITICAL: Missing .ai-non-final suffix** - ALL new message IDs MUST end with `.ai-non-final`. This applies even if existing messages in the file don\'t have this suffix. Example: `applinks.administration.list.applinks-table.system-label.ai-non-final`. Do NOT omit this suffix even when existing messages don\'t have it.', '**CRITICAL: Using defineMessages instead of defineMessage** - Always use defineMessage (singular) for individual messages, NOT defineMessages (plural). Each message should be defined separately using defineMessage.', 'Using wrong import path - "jira" path needs @atlassian/jira-intl (with eslint-disable), others use react-intl-next', 'Adding eslint-disable for defineMessage in non-Jira files or forgetting it in Jira files', 'Missing useIntl hook, generic placeholder names, or descriptions < 40 chars', 'Modifying pre-existing messages or working outside specified path scope'],
+  additionalResources: ['ESLint rule @atlassian/i18n/no-literal-string-in-jsx defines ignore patterns for technical strings (URLs, product names, symbols, etc.)']
+};

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

@@ -0,0 +1,48 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.listI18nConversionTool = exports.i18nConversionTool = exports.i18nConversionInputSchema = void 0;
+var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
+var _zod = require("zod");
+var _helpers = require("../../helpers");
+var _guide = require("./guide");
+var i18nConversionInputSchema = exports.i18nConversionInputSchema = _zod.z.object({
+  guide: _zod.z.enum(['hardcoded-string-to-formatmessage']).describe('The i18n conversion guide to retrieve.')
+});
+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.",
+  annotations: {
+    title: 'i18n Conversion Guide',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false
+  },
+  inputSchema: (0, _helpers.zodToJsonSchema)(i18nConversionInputSchema)
+};
+var i18nConversionTool = exports.i18nConversionTool = /*#__PURE__*/function () {
+  var _ref = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(_params) {
+    return _regenerator.default.wrap(function _callee$(_context) {
+      while (1) switch (_context.prev = _context.next) {
+        case 0:
+          return _context.abrupt("return", {
+            content: [{
+              type: 'text',
+              text: JSON.stringify(_guide.i18nConversionGuide, null, 2)
+            }]
+          });
+        case 1:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee);
+  }));
+  return function i18nConversionTool(_x) {
+    return _ref.apply(this, arguments);
+  };
+}();

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

@@ -0,0 +1 @@
+"use strict";

package/dist/es2019/index.js

@@ -13,6 +13,7 @@ import { getAllTokensTool, listGetAllTokensTool } from './tools/get-all-tokens';
 import { getComponentsTool, listGetComponentsTool } from './tools/get-components';
 import { getIconsInputSchema, getIconsTool, listGetIconsTool } from './tools/get-icons';
 import { getTokensInputSchema, getTokensTool, listGetTokensTool } from './tools/get-tokens';
+import { i18nConversionInputSchema, i18nConversionTool, listI18nConversionTool } from './tools/i18n-conversion';
 import { listMigrationGuidesTool, migrationGuidesInputSchema, migrationGuidesTool } from './tools/migration-guides';
 import { listPlanTool, planInputSchema, planTool } from './tools/plan';
 import { listSuggestA11yFixesTool, suggestA11yFixesInputSchema, suggestA11yFixesTool } from './tools/suggest-a11y-fixes';
@@ -98,6 +99,11 @@ export const getToolRegistry = () => {
       handler: migrationGuidesTool,
       inputSchema: migrationGuidesInputSchema,
       tool: listMigrationGuidesTool
+    },
+    [listI18nConversionTool.name]: {
+      handler: i18nConversionTool,
+      inputSchema: i18nConversionInputSchema,
+      tool: listI18nConversionTool
     }
   };
 

package/dist/es2019/tools/i18n-conversion/guide.js

@@ -0,0 +1,170 @@
+/**
+ * i18n Conversion Guide - Converting hardcoded strings to use formatMessage
+ */
+
+export const i18nConversionGuide = {
+  id: 'hardcoded-string-to-formatmessage',
+  title: 'Hardcoded String to formatMessage Conversion Guide',
+  description: 'Comprehensive guide for converting hardcoded strings to use formatMessage from @atlassian/jira-intl or react-intl-next',
+  purpose: 'This guide instructs LLM agents to convert hardcoded strings to use formatMessage. The import source depends on the file path: use @atlassian/jira-intl for Jira files (path contains "jira"), and react-intl-next for any non-Jira files. The goal is to find all hardcoded strings in JSX and convert them to internationalized messages.',
+  scope: `**CRITICAL SCOPE**: This process should **ONLY** focus on converting hardcoded strings (literal strings in JSX, eslint-disable comments for no-literal-string-in-jsx, etc.) to use formatMessage. Do NOT modify pre-existing messages that were already in the codebase, even if they have poor descriptions, incorrect placeholder names, or other quality issues. Only convert NEW hardcoded strings.
+
+**PATH SCOPE LIMITATION**: If a specific file, package name, or path is provided, **ONLY** find and convert hardcoded strings within that specified path. Do NOT modify files outside the provided scope.
+
+**CRITICAL: FIX ALL VIOLATIONS IN FILE**: When a specific file is mentioned (even with line numbers like \`@file.tsx:139-142\`), you MUST find and fix **ALL** @atlassian/i18n/no-literal-string-in-jsx violations in that entire file, not just the specific lines mentioned. Scan the entire file for hardcoded strings and convert them all. The line numbers are just a reference point - the goal is to fix all i18n violations in the provided file.
+
+**CRITICAL: STRING FILTERING**: When finding eslint-disable comments, you MUST examine the actual string content. Only convert strings that contain **user-facing English text**. Many English strings are technical/non-user-facing and should NOT be converted (e.g., product names like "Jira", URLs like "https://example.com", technical IDs, symbols). Use the ESLint ignore patterns to identify which English strings to skip - strings matching ignore patterns should be LEFT AS-IS with their eslint-disable comments intact.`,
+  implementationChecklist: ['Create message constants using defineMessage (singular) at the top of the file - use defineMessage for each individual message, NOT defineMessages', 'Import: Use "@atlassian/jira-intl" for Jira files (with eslint-disable) or "react-intl-next" for non-Jira files', '**CRITICAL: i18n ID Format**: For files in `/next/packages/`, i18n ids MUST start with the package name (with dashes). Format: `{package-name}.{component-or-feature}.{message-key}`. Example: For package `comment-extension-handlers`, use `comment-extension-handlers.legacy-content-modal.close-button`. For package `rovo-ai-search`, use `rovo-ai-search.view-profile-text` or `rovo-ai-search.knowledge-cards.copy-email-address`.', '**CRITICAL: ai-non-final Suffix**: ALL new message IDs MUST end with `.ai-non-final` suffix. This applies to ALL newly created messages, regardless of whether existing messages in the file have this suffix. Format: `{message-key}.ai-non-final`. Example: `applinks.administration.list.applinks-table.system-label.ai-non-final`. This suffix indicates the message is AI-generated and may need review before finalization.', 'Add useIntl hook: const { formatMessage } = useIntl();', 'Replace hardcoded strings with formatMessage(messageKey)', 'Add descriptions (40+ chars, unique from defaultMessage) and descriptive placeholder names', 'Remove eslint-disable for no-literal-string-in-jsx ONLY after converting', '**VERIFICATION**: To verify all hardcoded strings are fixed, search for `@atlassian/i18n/no-literal-string-in-jsx` in the file. Do NOT run eslint - just search for the eslint-disable comments. If no matches are found, all hardcoded strings have been converted.'],
+  patterns: [{
+    title: 'Button Text and Action Labels',
+    description: 'Converting hardcoded button text with variables',
+    before: `<Button style={styles} onClick={onClearVersion}>
+  Exit {description.join(' ')}
+</Button>`,
+    after: `// eslint-disable-next-line jira/deprecations/ban-identifiers
+import { useIntl, defineMessage } from '@atlassian/jira-intl';
+
+// eslint-disable-next-line jira/deprecations/ban-identifiers
+const exitButton = defineMessage({
+  id: 'rovo-ai-search.exit-button.ai-non-final',
+  defaultMessage: 'Exit {version}',
+  description: 'The text is shown as a button when the user needs to exit the version view. The placeholder {version} will be substituted with the version name. Used in the version header to return to the main view.',
+});
+
+export function MyComponent() {
+  const { formatMessage } = useIntl();
+
+  return (
+    <Button style={styles} onClick={onClearVersion}>
+      {formatMessage(exitButton, { version: description.join(' ') })}
+    </Button>
+  );
+}`,
+    explanation: 'Convert button text with variables to use placeholders in the message. Use descriptive placeholder names that match the variable context.'
+  }, {
+    title: 'Loading States and Status Messages',
+    description: 'Converting hardcoded loading and status messages',
+    before: `return <Box>Loading...</Box>;`,
+    after: `// eslint-disable-next-line jira/deprecations/ban-identifiers
+import { useIntl, defineMessage } from '@atlassian/jira-intl';
+
+// eslint-disable-next-line jira/deprecations/ban-identifiers
+const loading = defineMessage({
+  id: 'rovo-ai-search.loading.ai-non-final',
+  defaultMessage: 'Loading...',
+  description: 'The text is shown as a loading indicator when work item data is being fetched from the server. Appears in the work item tab to inform users that content is loading.',
+});
+
+export function MyComponent() {
+  const { formatMessage } = useIntl();
+
+  return (
+    <Box>
+      {formatMessage(loading)}
+    </Box>
+  );
+}`,
+    explanation: 'Convert simple hardcoded status messages to use defineMessage (singular). Use defineMessage for each individual message, NOT defineMessages. Ensure descriptions explain when and where the message appears.'
+  }, {
+    title: 'Partial String Translation (Prefixes and Labels)',
+    description: 'Translating only part of a string while preserving UI structure',
+    before: `<Box xcss={styles}>
+  <span>Status: {selectedOptions[0]?.label}</span>
+  {selectedOptions.length > 1 && (
+    <Badge appearance="primary" max={99}>
+      +{selectedOptions.length - 1}
+    </Badge>
+  )}
+</Box>`,
+    after: `// eslint-disable-next-line jira/deprecations/ban-identifiers
+import { useIntl, defineMessage } from '@atlassian/jira-intl';
+
+// eslint-disable-next-line jira/deprecations/ban-identifiers
+const statusLabel = defineMessage({
+  id: 'filter.status-label.ai-non-final',
+  defaultMessage: 'Status: {status}',
+  description: 'The text is shown as a button label prefix for the status filter. The placeholder {status} will be substituted with the selected status label. Appears in the filter button to show the current filter state.',
+});
+
+export function MyComponent() {
+  const { formatMessage } = useIntl();
+
+  return (
+    <Box xcss={styles}>
+      <span>
+        {formatMessage(statusLabel, {
+          status: selectedOptions[0]?.label,
+        })}
+      </span>
+      {selectedOptions.length > 1 && (
+        <Badge appearance="primary" max={99}>
+          +{selectedOptions.length - 1}
+        </Badge>
+      )}
+    </Box>
+  );
+}`,
+    explanation: 'When only part of a string needs translation (like a prefix "Status: " or label), create a message with a placeholder for the dynamic part. Preserve the existing UI structure (components, conditional rendering, etc.) and only translate the literal string portion.'
+  }, {
+    title: 'Dynamic Text Content',
+    description: 'Converting conditional hardcoded strings',
+    before: `<Text>{state.hasMore ? 'Show more' : 'Show less'}</Text>`,
+    after: `// eslint-disable-next-line jira/deprecations/ban-identifiers
+import { useIntl, defineMessage } from '@atlassian/jira-intl';
+
+// eslint-disable-next-line jira/deprecations/ban-identifiers
+const showMore = defineMessage({
+  id: 'work-item.comments.show-more.ai-non-final',
+  defaultMessage: 'Show more',
+  description: 'The text is shown as a button when there are more items available to display. Used in the comments section footer to expand and show additional content.',
+});
+
+// eslint-disable-next-line jira/deprecations/ban-identifiers
+const showLess = defineMessage({
+  id: 'work-item.comments.show-less.ai-non-final',
+  defaultMessage: 'Show less',
+  description: 'The text is shown as a button when the user wants to collapse the expanded view. Used in the comments section footer to hide additional content.',
+});
+
+export function MyComponent() {
+  const { formatMessage } = useIntl();
+
+  return (
+    <Text>
+      {state.hasMore
+        ? formatMessage(showMore)
+        : formatMessage(showLess)}
+    </Text>
+  );
+}`,
+    explanation: 'Create separate message constants for each conditional string. Use descriptive names that reflect the context.'
+  }, {
+    title: 'ICU Format for Numeric Values',
+    description: 'Converting numeric placeholders to ICU plural format',
+    before: `const moreMessage = \`+ \${count} more\`;`,
+    after: `// eslint-disable-next-line jira/deprecations/ban-identifiers
+import { useIntl, defineMessage } from '@atlassian/jira-intl';
+
+// eslint-disable-next-line jira/deprecations/ban-identifiers
+const moreProjectsMessage = defineMessage({
+  id: 'app.more-projects.ai-non-final',
+  defaultMessage: '{count, plural, one {+ # more} other {+ # more}}',
+  description: 'The text is shown when there are additional projects available. The placeholder {count} will be substituted with the number of remaining projects. Uses ICU plural format for proper localization.',
+});
+
+export function MyComponent() {
+  const { formatMessage } = useIntl();
+  const count = 5;
+
+  return (
+    <Text>
+      {formatMessage(moreProjectsMessage, { count })}
+    </Text>
+  );
+}`,
+    explanation: 'Use ICU plural format for numeric values that may need pluralization. The # symbol represents the numeric value in ICU format.'
+  }],
+  bestPractices: ['Only convert NEW hardcoded strings - do NOT modify pre-existing messages', '**CRITICAL: Use defineMessage (singular)** - Always use defineMessage for each individual message, NOT defineMessages (plural). Each message should be defined separately: `const messageKey = defineMessage({ ... })`', '**CRITICAL: Always use .ai-non-final suffix** - ALL new message IDs MUST end with `.ai-non-final`. This applies even if existing messages in the file don\'t have this suffix. Format: `{message-key}.ai-non-final`. This indicates the message is AI-generated and may need review.', 'Use descriptive names (userNameLabel not label) and placeholders (userName not value)', 'Add descriptions (40+ chars, unique from defaultMessage)', 'Use ICU plural format for numeric values: {count, plural, one {...} other {...}}', 'Place message constants at top of file, use formatMessage consistently', 'Convert arrow functions to body form if needed for hooks'],
+  commonPitfalls: ['**CRITICAL**: Converting/removing eslint-disable for strings matching ignore patterns - technical/non-user-facing strings should remain hardcoded', '**CRITICAL: Invalid i18n ID format** - For files in `/next/packages/`, must follow `{package-name}.{component-or-feature}.{message-key}`. Common errors: (1) Not starting with package name (with dashes), (2) Missing component/feature segment, (3) Wrong message key format (must be kebab-case, not camelCase). Example correct: `comment-extension-handlers.legacy-content-modal.close-button`.', '**CRITICAL: Missing .ai-non-final suffix** - ALL new message IDs MUST end with `.ai-non-final`. This applies even if existing messages in the file don\'t have this suffix. Example: `applinks.administration.list.applinks-table.system-label.ai-non-final`. Do NOT omit this suffix even when existing messages don\'t have it.', '**CRITICAL: Using defineMessages instead of defineMessage** - Always use defineMessage (singular) for individual messages, NOT defineMessages (plural). Each message should be defined separately using defineMessage.', 'Using wrong import path - "jira" path needs @atlassian/jira-intl (with eslint-disable), others use react-intl-next', 'Adding eslint-disable for defineMessage in non-Jira files or forgetting it in Jira files', 'Missing useIntl hook, generic placeholder names, or descriptions < 40 chars', 'Modifying pre-existing messages or working outside specified path scope'],
+  additionalResources: ['ESLint rule @atlassian/i18n/no-literal-string-in-jsx defines ignore patterns for technical strings (URLs, product names, symbols, etc.)']
+};

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

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+import { zodToJsonSchema } from '../../helpers';
+import { i18nConversionGuide } from './guide';
+export const i18nConversionInputSchema = z.object({
+  guide: z.enum(['hardcoded-string-to-formatmessage']).describe('The i18n conversion guide to retrieve.')
+});
+export const 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.
+
+**TRIGGER**: Use this tool when you encounter:
+- "fix hardcoded string" / "fix hardcoded strings" / "fix hardcoded string in [file]"
+- "convert hardcoded string" / "convert to i18n" / "convert to formatMessage"
+- "translate string" / "internationalize string" / "i18n this string"
+- "use formatMessage" / "use FormattedMessage" / "wrap in formatMessage"
+- "literal string" / "fix literal string" / "convert literal string"
+- ESLint errors: "Literal string in JSX content should be internationalized. Use FormattedMessage or intl.formatMessage()"
+- ESLint errors: "@atlassian/i18n/no-literal-string-in-jsx"
+- Requests to convert hardcoded strings to i18n messages
+
+This tool helps LLM agents systematically convert hardcoded strings while respecting scope limitations and following best practices for message constants, placeholders, and descriptions.`,
+  annotations: {
+    title: 'i18n Conversion Guide',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false
+  },
+  inputSchema: zodToJsonSchema(i18nConversionInputSchema)
+};
+export const i18nConversionTool = async _params => {
+  return {
+    content: [{
+      type: 'text',
+      text: JSON.stringify(i18nConversionGuide, null, 2)
+    }]
+  };
+};

package/dist/esm/index.js

@@ -16,6 +16,7 @@ import { getAllTokensTool, listGetAllTokensTool } from './tools/get-all-tokens';
 import { getComponentsTool, listGetComponentsTool } from './tools/get-components';
 import { getIconsInputSchema, getIconsTool, listGetIconsTool } from './tools/get-icons';
 import { getTokensInputSchema, getTokensTool, listGetTokensTool } from './tools/get-tokens';
+import { i18nConversionInputSchema, i18nConversionTool, listI18nConversionTool } from './tools/i18n-conversion';
 import { listMigrationGuidesTool, migrationGuidesInputSchema, migrationGuidesTool } from './tools/migration-guides';
 import { listPlanTool, planInputSchema, planTool } from './tools/plan';
 import { listSuggestA11yFixesTool, suggestA11yFixesInputSchema, suggestA11yFixesTool } from './tools/suggest-a11y-fixes';
@@ -55,7 +56,7 @@ var generateLogger = function generateLogger(level) {
   };
 };
 export var getToolRegistry = function getToolRegistry() {
-  var baseTools = _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({}, listAnalyzeA11yTool.name, {
+  var baseTools = _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({}, listAnalyzeA11yTool.name, {
     handler: analyzeA11yTool,
     inputSchema: analyzeA11yInputSchema,
     tool: listAnalyzeA11yTool
@@ -83,6 +84,10 @@ export var getToolRegistry = function getToolRegistry() {
     handler: migrationGuidesTool,
     inputSchema: migrationGuidesInputSchema,
     tool: listMigrationGuidesTool
+  }), listI18nConversionTool.name, {
+    handler: i18nConversionTool,
+    inputSchema: i18nConversionInputSchema,
+    tool: listI18nConversionTool
   });
 
   // Conditionally add token and icon tools based on feature flag

package/dist/esm/tools/i18n-conversion/guide.js

@@ -0,0 +1,46 @@
+/**
+ * i18n Conversion Guide - Converting hardcoded strings to use formatMessage
+ */
+
+export var i18nConversionGuide = {
+  id: 'hardcoded-string-to-formatmessage',
+  title: 'Hardcoded String to formatMessage Conversion Guide',
+  description: 'Comprehensive guide for converting hardcoded strings to use formatMessage from @atlassian/jira-intl or react-intl-next',
+  purpose: 'This guide instructs LLM agents to convert hardcoded strings to use formatMessage. The import source depends on the file path: use @atlassian/jira-intl for Jira files (path contains "jira"), and react-intl-next for any non-Jira files. The goal is to find all hardcoded strings in JSX and convert them to internationalized messages.',
+  scope: "**CRITICAL SCOPE**: This process should **ONLY** focus on converting hardcoded strings (literal strings in JSX, eslint-disable comments for no-literal-string-in-jsx, etc.) to use formatMessage. Do NOT modify pre-existing messages that were already in the codebase, even if they have poor descriptions, incorrect placeholder names, or other quality issues. Only convert NEW hardcoded strings.\n\n**PATH SCOPE LIMITATION**: If a specific file, package name, or path is provided, **ONLY** find and convert hardcoded strings within that specified path. Do NOT modify files outside the provided scope.\n\n**CRITICAL: FIX ALL VIOLATIONS IN FILE**: When a specific file is mentioned (even with line numbers like `@file.tsx:139-142`), you MUST find and fix **ALL** @atlassian/i18n/no-literal-string-in-jsx violations in that entire file, not just the specific lines mentioned. Scan the entire file for hardcoded strings and convert them all. The line numbers are just a reference point - the goal is to fix all i18n violations in the provided file.\n\n**CRITICAL: STRING FILTERING**: When finding eslint-disable comments, you MUST examine the actual string content. Only convert strings that contain **user-facing English text**. Many English strings are technical/non-user-facing and should NOT be converted (e.g., product names like \"Jira\", URLs like \"https://example.com\", technical IDs, symbols). Use the ESLint ignore patterns to identify which English strings to skip - strings matching ignore patterns should be LEFT AS-IS with their eslint-disable comments intact.",
+  implementationChecklist: ['Create message constants using defineMessage (singular) at the top of the file - use defineMessage for each individual message, NOT defineMessages', 'Import: Use "@atlassian/jira-intl" for Jira files (with eslint-disable) or "react-intl-next" for non-Jira files', '**CRITICAL: i18n ID Format**: For files in `/next/packages/`, i18n ids MUST start with the package name (with dashes). Format: `{package-name}.{component-or-feature}.{message-key}`. Example: For package `comment-extension-handlers`, use `comment-extension-handlers.legacy-content-modal.close-button`. For package `rovo-ai-search`, use `rovo-ai-search.view-profile-text` or `rovo-ai-search.knowledge-cards.copy-email-address`.', '**CRITICAL: ai-non-final Suffix**: ALL new message IDs MUST end with `.ai-non-final` suffix. This applies to ALL newly created messages, regardless of whether existing messages in the file have this suffix. Format: `{message-key}.ai-non-final`. Example: `applinks.administration.list.applinks-table.system-label.ai-non-final`. This suffix indicates the message is AI-generated and may need review before finalization.', 'Add useIntl hook: const { formatMessage } = useIntl();', 'Replace hardcoded strings with formatMessage(messageKey)', 'Add descriptions (40+ chars, unique from defaultMessage) and descriptive placeholder names', 'Remove eslint-disable for no-literal-string-in-jsx ONLY after converting', '**VERIFICATION**: To verify all hardcoded strings are fixed, search for `@atlassian/i18n/no-literal-string-in-jsx` in the file. Do NOT run eslint - just search for the eslint-disable comments. If no matches are found, all hardcoded strings have been converted.'],
+  patterns: [{
+    title: 'Button Text and Action Labels',
+    description: 'Converting hardcoded button text with variables',
+    before: "<Button style={styles} onClick={onClearVersion}>\n  Exit {description.join(' ')}\n</Button>",
+    after: "// eslint-disable-next-line jira/deprecations/ban-identifiers\nimport { useIntl, defineMessage } from '@atlassian/jira-intl';\n\n// eslint-disable-next-line jira/deprecations/ban-identifiers\nconst exitButton = defineMessage({\n  id: 'rovo-ai-search.exit-button.ai-non-final',\n  defaultMessage: 'Exit {version}',\n  description: 'The text is shown as a button when the user needs to exit the version view. The placeholder {version} will be substituted with the version name. Used in the version header to return to the main view.',\n});\n\nexport function MyComponent() {\n  const { formatMessage } = useIntl();\n\n  return (\n    <Button style={styles} onClick={onClearVersion}>\n      {formatMessage(exitButton, { version: description.join(' ') })}\n    </Button>\n  );\n}",
+    explanation: 'Convert button text with variables to use placeholders in the message. Use descriptive placeholder names that match the variable context.'
+  }, {
+    title: 'Loading States and Status Messages',
+    description: 'Converting hardcoded loading and status messages',
+    before: "return <Box>Loading...</Box>;",
+    after: "// eslint-disable-next-line jira/deprecations/ban-identifiers\nimport { useIntl, defineMessage } from '@atlassian/jira-intl';\n\n// eslint-disable-next-line jira/deprecations/ban-identifiers\nconst loading = defineMessage({\n  id: 'rovo-ai-search.loading.ai-non-final',\n  defaultMessage: 'Loading...',\n  description: 'The text is shown as a loading indicator when work item data is being fetched from the server. Appears in the work item tab to inform users that content is loading.',\n});\n\nexport function MyComponent() {\n  const { formatMessage } = useIntl();\n\n  return (\n    <Box>\n      {formatMessage(loading)}\n    </Box>\n  );\n}",
+    explanation: 'Convert simple hardcoded status messages to use defineMessage (singular). Use defineMessage for each individual message, NOT defineMessages. Ensure descriptions explain when and where the message appears.'
+  }, {
+    title: 'Partial String Translation (Prefixes and Labels)',
+    description: 'Translating only part of a string while preserving UI structure',
+    before: "<Box xcss={styles}>\n  <span>Status: {selectedOptions[0]?.label}</span>\n  {selectedOptions.length > 1 && (\n    <Badge appearance=\"primary\" max={99}>\n      +{selectedOptions.length - 1}\n    </Badge>\n  )}\n</Box>",
+    after: "// eslint-disable-next-line jira/deprecations/ban-identifiers\nimport { useIntl, defineMessage } from '@atlassian/jira-intl';\n\n// eslint-disable-next-line jira/deprecations/ban-identifiers\nconst statusLabel = defineMessage({\n  id: 'filter.status-label.ai-non-final',\n  defaultMessage: 'Status: {status}',\n  description: 'The text is shown as a button label prefix for the status filter. The placeholder {status} will be substituted with the selected status label. Appears in the filter button to show the current filter state.',\n});\n\nexport function MyComponent() {\n  const { formatMessage } = useIntl();\n\n  return (\n    <Box xcss={styles}>\n      <span>\n        {formatMessage(statusLabel, {\n          status: selectedOptions[0]?.label,\n        })}\n      </span>\n      {selectedOptions.length > 1 && (\n        <Badge appearance=\"primary\" max={99}>\n          +{selectedOptions.length - 1}\n        </Badge>\n      )}\n    </Box>\n  );\n}",
+    explanation: 'When only part of a string needs translation (like a prefix "Status: " or label), create a message with a placeholder for the dynamic part. Preserve the existing UI structure (components, conditional rendering, etc.) and only translate the literal string portion.'
+  }, {
+    title: 'Dynamic Text Content',
+    description: 'Converting conditional hardcoded strings',
+    before: "<Text>{state.hasMore ? 'Show more' : 'Show less'}</Text>",
+    after: "// eslint-disable-next-line jira/deprecations/ban-identifiers\nimport { useIntl, defineMessage } from '@atlassian/jira-intl';\n\n// eslint-disable-next-line jira/deprecations/ban-identifiers\nconst showMore = defineMessage({\n  id: 'work-item.comments.show-more.ai-non-final',\n  defaultMessage: 'Show more',\n  description: 'The text is shown as a button when there are more items available to display. Used in the comments section footer to expand and show additional content.',\n});\n\n// eslint-disable-next-line jira/deprecations/ban-identifiers\nconst showLess = defineMessage({\n  id: 'work-item.comments.show-less.ai-non-final',\n  defaultMessage: 'Show less',\n  description: 'The text is shown as a button when the user wants to collapse the expanded view. Used in the comments section footer to hide additional content.',\n});\n\nexport function MyComponent() {\n  const { formatMessage } = useIntl();\n\n  return (\n    <Text>\n      {state.hasMore\n        ? formatMessage(showMore)\n        : formatMessage(showLess)}\n    </Text>\n  );\n}",
+    explanation: 'Create separate message constants for each conditional string. Use descriptive names that reflect the context.'
+  }, {
+    title: 'ICU Format for Numeric Values',
+    description: 'Converting numeric placeholders to ICU plural format',
+    before: "const moreMessage = `+ ${count} more`;",
+    after: "// eslint-disable-next-line jira/deprecations/ban-identifiers\nimport { useIntl, defineMessage } from '@atlassian/jira-intl';\n\n// eslint-disable-next-line jira/deprecations/ban-identifiers\nconst moreProjectsMessage = defineMessage({\n  id: 'app.more-projects.ai-non-final',\n  defaultMessage: '{count, plural, one {+ # more} other {+ # more}}',\n  description: 'The text is shown when there are additional projects available. The placeholder {count} will be substituted with the number of remaining projects. Uses ICU plural format for proper localization.',\n});\n\nexport function MyComponent() {\n  const { formatMessage } = useIntl();\n  const count = 5;\n\n  return (\n    <Text>\n      {formatMessage(moreProjectsMessage, { count })}\n    </Text>\n  );\n}",
+    explanation: 'Use ICU plural format for numeric values that may need pluralization. The # symbol represents the numeric value in ICU format.'
+  }],
+  bestPractices: ['Only convert NEW hardcoded strings - do NOT modify pre-existing messages', '**CRITICAL: Use defineMessage (singular)** - Always use defineMessage for each individual message, NOT defineMessages (plural). Each message should be defined separately: `const messageKey = defineMessage({ ... })`', '**CRITICAL: Always use .ai-non-final suffix** - ALL new message IDs MUST end with `.ai-non-final`. This applies even if existing messages in the file don\'t have this suffix. Format: `{message-key}.ai-non-final`. This indicates the message is AI-generated and may need review.', 'Use descriptive names (userNameLabel not label) and placeholders (userName not value)', 'Add descriptions (40+ chars, unique from defaultMessage)', 'Use ICU plural format for numeric values: {count, plural, one {...} other {...}}', 'Place message constants at top of file, use formatMessage consistently', 'Convert arrow functions to body form if needed for hooks'],
+  commonPitfalls: ['**CRITICAL**: Converting/removing eslint-disable for strings matching ignore patterns - technical/non-user-facing strings should remain hardcoded', '**CRITICAL: Invalid i18n ID format** - For files in `/next/packages/`, must follow `{package-name}.{component-or-feature}.{message-key}`. Common errors: (1) Not starting with package name (with dashes), (2) Missing component/feature segment, (3) Wrong message key format (must be kebab-case, not camelCase). Example correct: `comment-extension-handlers.legacy-content-modal.close-button`.', '**CRITICAL: Missing .ai-non-final suffix** - ALL new message IDs MUST end with `.ai-non-final`. This applies even if existing messages in the file don\'t have this suffix. Example: `applinks.administration.list.applinks-table.system-label.ai-non-final`. Do NOT omit this suffix even when existing messages don\'t have it.', '**CRITICAL: Using defineMessages instead of defineMessage** - Always use defineMessage (singular) for individual messages, NOT defineMessages (plural). Each message should be defined separately using defineMessage.', 'Using wrong import path - "jira" path needs @atlassian/jira-intl (with eslint-disable), others use react-intl-next', 'Adding eslint-disable for defineMessage in non-Jira files or forgetting it in Jira files', 'Missing useIntl hook, generic placeholder names, or descriptions < 40 chars', 'Modifying pre-existing messages or working outside specified path scope'],
+  additionalResources: ['ESLint rule @atlassian/i18n/no-literal-string-in-jsx defines ignore patterns for technical strings (URLs, product names, symbols, etc.)']
+};

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

@@ -0,0 +1,41 @@
+import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
+import _regeneratorRuntime from "@babel/runtime/regenerator";
+import { z } from 'zod';
+import { zodToJsonSchema } from '../../helpers';
+import { i18nConversionGuide } from './guide';
+export var i18nConversionInputSchema = z.object({
+  guide: z.enum(['hardcoded-string-to-formatmessage']).describe('The i18n conversion guide to retrieve.')
+});
+export var 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.",
+  annotations: {
+    title: 'i18n Conversion Guide',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false
+  },
+  inputSchema: zodToJsonSchema(i18nConversionInputSchema)
+};
+export var i18nConversionTool = /*#__PURE__*/function () {
+  var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(_params) {
+    return _regeneratorRuntime.wrap(function _callee$(_context) {
+      while (1) switch (_context.prev = _context.next) {
+        case 0:
+          return _context.abrupt("return", {
+            content: [{
+              type: 'text',
+              text: JSON.stringify(i18nConversionGuide, null, 2)
+            }]
+          });
+        case 1:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee);
+  }));
+  return function i18nConversionTool(_x) {
+    return _ref.apply(this, arguments);
+  };
+}();

package/dist/types/tools/i18n-conversion/guide.d.ts

@@ -0,0 +1,5 @@
+/**
+ * i18n Conversion Guide - Converting hardcoded strings to use formatMessage
+ */
+import type { ConversionGuide } from './types';
+export declare const i18nConversionGuide: ConversionGuide;

package/dist/types/tools/i18n-conversion/index.d.ts

@@ -0,0 +1,16 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types';
+import { z } from 'zod';
+export declare const i18nConversionInputSchema: z.ZodObject<{
+    guide: z.ZodEnum<["hardcoded-string-to-formatmessage"]>;
+}, "strip", z.ZodTypeAny, {
+    guide: "hardcoded-string-to-formatmessage";
+}, {
+    guide: "hardcoded-string-to-formatmessage";
+}>;
+export declare const listI18nConversionTool: Tool;
+export declare const i18nConversionTool: (_params: z.infer<typeof i18nConversionInputSchema>) => Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;

package/dist/types/tools/i18n-conversion/types.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Types for the i18n conversion tool
+ */
+export interface ConversionPattern {
+    title: string;
+    description: string;
+    before: string;
+    after: string;
+    explanation: string;
+}
+export interface ConversionGuide {
+    id: string;
+    title: string;
+    description: string;
+    purpose: string;
+    scope: string;
+    implementationChecklist: string[];
+    patterns: ConversionPattern[];
+    bestPractices: string[];
+    commonPitfalls: string[];
+    additionalResources: string | string[];
+}

package/dist/types/tools/plan/index.d.ts

@@ -7,15 +7,15 @@ export declare const planInputSchema: z.ZodObject<{
     limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
     exactName: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
 }, "strip", z.ZodTypeAny, {
-    components: string[];
     tokens: string[];
     icons: string[];
+    components: string[];
     limit?: number | undefined;
     exactName?: boolean | undefined;
 }, {
-    components: string[];
     tokens: string[];
     icons: string[];
+    components: string[];
     limit?: number | undefined;
     exactName?: boolean | undefined;
 }>;

package/dist/types-ts4.5/tools/i18n-conversion/guide.d.ts

@@ -0,0 +1,5 @@
+/**
+ * i18n Conversion Guide - Converting hardcoded strings to use formatMessage
+ */
+import type { ConversionGuide } from './types';
+export declare const i18nConversionGuide: ConversionGuide;

package/dist/types-ts4.5/tools/i18n-conversion/index.d.ts

@@ -0,0 +1,18 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types';
+import { z } from 'zod';
+export declare const i18nConversionInputSchema: z.ZodObject<{
+    guide: z.ZodEnum<[
+        "hardcoded-string-to-formatmessage"
+    ]>;
+}, "strip", z.ZodTypeAny, {
+    guide: "hardcoded-string-to-formatmessage";
+}, {
+    guide: "hardcoded-string-to-formatmessage";
+}>;
+export declare const listI18nConversionTool: Tool;
+export declare const i18nConversionTool: (_params: z.infer<typeof i18nConversionInputSchema>) => Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;

package/dist/types-ts4.5/tools/i18n-conversion/types.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Types for the i18n conversion tool
+ */
+export interface ConversionPattern {
+    title: string;
+    description: string;
+    before: string;
+    after: string;
+    explanation: string;
+}
+export interface ConversionGuide {
+    id: string;
+    title: string;
+    description: string;
+    purpose: string;
+    scope: string;
+    implementationChecklist: string[];
+    patterns: ConversionPattern[];
+    bestPractices: string[];
+    commonPitfalls: string[];
+    additionalResources: string | string[];
+}

package/dist/types-ts4.5/tools/plan/index.d.ts

@@ -7,15 +7,15 @@ export declare const planInputSchema: z.ZodObject<{
     limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
     exactName: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
 }, "strip", z.ZodTypeAny, {
-    components: string[];
     tokens: string[];
     icons: string[];
+    components: string[];
     limit?: number | undefined;
     exactName?: boolean | undefined;
 }, {
-    components: string[];
     tokens: string[];
     icons: string[];
+    components: string[];
     limit?: number | undefined;
     exactName?: boolean | undefined;
 }>;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/ads-mcp",
-	"version": "0.12.0",
+	"version": "0.13.1",
 	"description": "The official Atlassian Design System MCP server to develop apps and user interfaces matching the Atlassian style.",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -34,9 +34,9 @@
 		}
 	},
 	"dependencies": {
-		"@atlaskit/icon": "^29.2.0",
+		"@atlaskit/icon": "^29.3.0",
 		"@atlaskit/platform-feature-flags": "^1.1.0",
-		"@atlaskit/tokens": "^8.6.0",
+		"@atlaskit/tokens": "^9.0.0",
 		"@axe-core/playwright": "^4.8.0",
 		"@axe-core/puppeteer": "^4.7.3",
 		"@babel/runtime": "^7.0.0",