@i18n-agent/mcp-client 1.9.3 → 1.9.6

package/mcp-client.js

@@ -5,7 +5,7 @@
  * Integrates with Claude Code CLI to provide translation capabilities
  */
 
-const MCP_CLIENT_VERSION = '1.9.3';
+const MCP_CLIENT_VERSION = '1.9.6';
 
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
@@ -144,7 +144,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'translate_file',
-        description: 'Translate file content while preserving structure and format. Supports single or multi-language translation via targetLanguages parameter (string for single, array for multiple). Supports JSON, YAML, XML, CSV, TXT, MD, and other text files. Always returns a jobId for async processing - use check_translation_status to monitor progress and download_translations to get results. Set pseudoTranslation=true for testing i18n implementations without AI cost. TOKEN-SAVING TIP: After receiving the jobId, run check_translation_status in background (using run_in_background parameter) to avoid blocking the conversation and reduce token usage from repeated status polling.',
+        description: 'Translate file content while preserving structure and format. Supports single or multi-language translation via targetLanguages parameter (string for single, array for multiple). Supports JSON, YAML, XML, CSV, TXT, MD, and other text files. Always returns a jobId for async processing - use check_translation_status to monitor progress and download_translations to get results. Set pseudoTranslation=true for testing i18n implementations without AI cost. TOKEN-SAVING TIP: After receiving the jobId, use the Task tool with run_in_background=true to spawn an agent that monitors the job via check_translation_status, rather than polling directly in the conversation.',
         inputSchema: {
           type: 'object',
           properties: {
@@ -362,7 +362,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'download_translations',
-        description: 'Download completed translations by writing them to /tmp/i18n-translations-{jobId}/. Returns metadata with file paths instead of large translation content to avoid token bloat. Consumer can then read or copy files as needed.',
+        description: 'Download completed translations to /tmp/i18n-translations-{jobId}/. Returns file paths and action_required field. IMPORTANT: After downloading, copy each {lang}.json file to the correct locale folder matching the source file structure (e.g., if source was locales/en/messages.json, copy to locales/{lang}/messages.json).',
         inputSchema: {
           type: 'object',
           properties: {
@@ -966,22 +966,35 @@ async function handleTranslateFile(args) {
 
     // Check if we got an async job response
     const result = response.data.result;
-    
+
     if (result && result.content && result.content[0]) {
       const textContent = result.content[0].text;
-      
+
       // Try to parse as JSON to check for job ID
       try {
         const parsed = JSON.parse(textContent);
-        if (parsed.status === 'processing' && parsed.jobId) {
-          // Async job started - poll for status
-          return await pollTranslationJob(parsed.jobId, parsed.estimatedTime);
+
+        // Check for queued/processing status - return with prominent background monitoring instruction
+        // DO NOT auto-poll here - let the consumer handle monitoring in background to save tokens
+        if ((parsed.status === 'queued' || parsed.status === 'processing') && parsed.jobId) {
+          return {
+            content: [{
+              type: 'text',
+              text: JSON.stringify({
+                status: parsed.status,
+                jobId: parsed.jobId,
+                message: `⚠️ IMPORTANT: Monitor this job in background to avoid token waste from polling.\n\nDo NOT poll check_translation_status in a loop. Use async/background execution instead.`,
+                estimatedTime: parsed.estimatedTime,
+                fileSize: parsed.fileSize
+              }, null, 2)
+            }]
+          };
         }
       } catch {
         // Not JSON or not an async response, return as-is
       }
     }
-    
+
     return result;
     
   } catch (error) {
@@ -1897,7 +1910,7 @@ async function handleDownloadTranslations(args) {
       throw new Error(`No translations available. Expected downloadUrls in response.`);
     }
 
-    // Return success with file paths
+    // Return success with file paths and instructions for consumer
     return {
       content: [{
         type: 'text',
@@ -1908,7 +1921,8 @@ async function handleDownloadTranslations(args) {
           filesWritten,
           fileName: parsedResult.fileName,
           targetLanguages: parsedResult.targetLanguages,
-          message: `✅ Downloaded ${filesWritten.length} translation files to ${outputDir}`
+          message: `✅ Downloaded ${filesWritten.length} translation files to ${outputDir}`,
+          action_required: `Copy each translated file to its correct locale folder. Common patterns: locales/{lang}/${parsedResult.fileName || 'file.json'}, locales/{lang}.json, or {filename}.{lang}.json. Match the source file's directory structure.`
         }, null, 2)
       }]
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@i18n-agent/mcp-client",
-  "version": "1.9.3",
+  "version": "1.9.6",
   "description": "🌍 i18n-agent MCP Client - 48 languages, AI-powered translation for Claude, Claude Code, Cursor, VS Code, Codex. Get API key at https://app.i18nagent.ai",
   "main": "mcp-client.js",
   "bin": {