@i18n-agent/mcp-client 1.9.2 → 1.9.5

package/mcp-client.js

@@ -5,7 +5,7 @@
  * Integrates with Claude Code CLI to provide translation capabilities
  */
 
-const MCP_CLIENT_VERSION = '1.9.2';
+const MCP_CLIENT_VERSION = '1.9.5';
 
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
@@ -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) {
@@ -1828,8 +1841,6 @@ async function handleDownloadTranslations(args) {
       parsedResult = result;
     }
 
-    // Detect storage type and handle accordingly
-    const storageType = parsedResult.storageType || 'local';
     const outputDir = `/tmp/i18n-translations-${jobId}`;
 
     // Create output directory
@@ -1839,8 +1850,8 @@ async function handleDownloadTranslations(args) {
 
     const filesWritten = [];
 
-    if (storageType === 's3' && parsedResult.downloadUrls) {
-      // Case 1: S3 Storage - download files from presigned URLs
+    if (parsedResult.downloadUrls && Object.keys(parsedResult.downloadUrls).length > 0) {
+      // Download files from S3 presigned URLs
       console.error(`📥 Downloading ${Object.keys(parsedResult.downloadUrls).length} translation files from S3...`);
 
       for (const [language, downloadUrl] of Object.entries(parsedResult.downloadUrls)) {
@@ -1896,10 +1907,10 @@ async function handleDownloadTranslations(args) {
       }
     } else {
       // No valid download method found
-      throw new Error(`No translations available. Storage type: ${storageType}. Expected either downloadUrls (S3) or translations (raw content).`);
+      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,10 +1919,10 @@ async function handleDownloadTranslations(args) {
           jobId,
           outputDirectory: outputDir,
           filesWritten,
-          storageType,
           fileName: parsedResult.fileName,
           targetLanguages: parsedResult.targetLanguages,
-          message: `✅ ${storageType === 's3' ? 'Downloaded' : 'Wrote'} ${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)
       }]
     };
@@ -2172,7 +2183,7 @@ async function handleParallelDocumentUpload(args) {
     return {
       content: [{
         type: 'text',
-        text: `✅ Parallel Document Upload Successful\n\n` +
+        text: `✅ Translation Upload Successful\n\n` +
               `📂 Namespace: ${finalNamespace}\n` +
               `📄 Source: ${sourceFilePath ? path.basename(sourceFilePath) : 'source content'}\n` +
               `📄 Target: ${targetFilePath ? path.basename(targetFilePath) : 'target content'}\n` +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@i18n-agent/mcp-client",
-  "version": "1.9.2",
+  "version": "1.9.5",
   "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": {