@i18n-agent/mcp-client 1.7.6 → 1.7.8

package/mcp-client.js

@@ -5,7 +5,7 @@
  * Integrates with Claude Code CLI to provide translation capabilities
  */
 
-const MCP_CLIENT_VERSION = '1.7.6';
+const MCP_CLIENT_VERSION = '1.7.8';
 
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
@@ -218,6 +218,34 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           required: ['jobId'],
         },
       },
+      {
+        name: 'resume_translation',
+        description: 'Resume a failed or interrupted async translation job from its last checkpoint. This allows you to continue processing from where it stopped instead of starting over.',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            jobId: {
+              type: 'string',
+              description: 'The job ID of the translation job to resume',
+            },
+          },
+          required: ['jobId'],
+        },
+      },
+      {
+        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.',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            jobId: {
+              type: 'string',
+              description: 'The job ID of the completed translation',
+            },
+          },
+          required: ['jobId'],
+        },
+      },
     ],
   };
 });
@@ -248,7 +276,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       
       case 'check_translation_status':
         return await handleCheckTranslationStatus(args);
-      
+
+      case 'resume_translation':
+        return await handleResumeTranslation(args);
+
+      case 'download_translations':
+        return await handleDownloadTranslations(args);
+
       default:
         throw new McpError(
           ErrorCode.MethodNotFound,
@@ -630,7 +664,26 @@ async function handleTranslateFile(args) {
 
   // Check if this is a large file that might need async processing
   const isLargeFile = content.length > 50000; // > 50KB
-  
+
+  // Build arguments object, filtering out undefined values (they get stripped by JSON.stringify)
+  const requestArgs = {
+    apiKey: API_KEY,
+    filePath,
+    fileContent: content,
+    fileType,
+    sourceLanguage,
+    targetAudience,
+    industry,
+    preserveKeys,
+    outputFormat
+  };
+
+  // Add optional parameters only if defined
+  if (targetLanguage !== undefined) requestArgs.targetLanguage = targetLanguage;
+  if (targetLanguages !== undefined) requestArgs.targetLanguages = targetLanguages;
+  if (region !== undefined) requestArgs.region = region;
+  if (context !== undefined) requestArgs.context = context;
+
   // Use MCP JSON-RPC protocol for translate_file
   const mcpRequest = {
     jsonrpc: '2.0',
@@ -638,21 +691,7 @@ async function handleTranslateFile(args) {
     method: 'tools/call',
     params: {
       name: 'translate_file',
-      arguments: {
-        apiKey: API_KEY,
-        filePath,
-        fileContent: content,
-        fileType,
-        targetLanguage,
-        targetLanguages,
-        sourceLanguage,
-        targetAudience,
-        industry,
-        region,
-        context,
-        preserveKeys,
-        outputFormat
-      }
+      arguments: requestArgs
     }
   };
 
@@ -1315,11 +1354,11 @@ function getCodeBlockLanguage(fileType) {
 // Handler for checking translation status
 async function handleCheckTranslationStatus(args) {
   const { jobId } = args;
-  
+
   if (!jobId) {
     throw new Error('jobId is required');
   }
-  
+
   const mcpRequest = {
     jsonrpc: '2.0',
     id: Date.now(),
@@ -1329,41 +1368,145 @@ async function handleCheckTranslationStatus(args) {
       arguments: { jobId }
     }
   };
-  
+
   try {
     const response = await axios.post(MCP_SERVER_URL, mcpRequest, {
       headers: { 'Content-Type': 'application/json' },
       timeout: 30000
     });
-    
+
     if (response.data.error) {
       throw new Error(`Translation status error: ${response.data.error.message || response.data.error}`);
     }
-    
+
     return response.data.result;
   } catch (error) {
     console.error('Check translation status error:', error);
-    
+
     // Handle 503 service unavailable
     if (error.response?.status === 503) {
       throw new Error(`i18n-agent encountered unexpected problem, and we are working on it, try again later.`);
     }
-    
+
     // Handle 404 not found
     if (error.response?.status === 404) {
       throw new Error(`Translation job ${jobId} not found. The job may have expired or the ID is incorrect.`);
     }
-    
+
     // Handle timeout
     if (error.code === 'ECONNABORTED') {
       throw new Error(`Status check timed out. The service may be experiencing high load. Please try again.`);
     }
-    
+
     // Generic error
     throw new Error(`Unable to check translation status: ${error.message}`);
   }
 }
 
+// Handler for resuming translation jobs
+async function handleResumeTranslation(args) {
+  const { jobId } = args;
+
+  if (!jobId) {
+    throw new Error('jobId is required');
+  }
+
+  const mcpRequest = {
+    jsonrpc: '2.0',
+    id: Date.now(),
+    method: 'tools/call',
+    params: {
+      name: 'resume_translation',
+      arguments: { jobId }
+    }
+  };
+
+  try {
+    const response = await axios.post(MCP_SERVER_URL, mcpRequest, {
+      headers: { 'Content-Type': 'application/json' },
+      timeout: 30000
+    });
+
+    if (response.data.error) {
+      throw new Error(`Resume translation error: ${response.data.error.message || response.data.error}`);
+    }
+
+    return response.data.result;
+  } catch (error) {
+    console.error('Resume translation error:', error);
+
+    // Handle 503 service unavailable
+    if (error.response?.status === 503) {
+      throw new Error(`i18n-agent encountered unexpected problem, and we are working on it, try again later.`);
+    }
+
+    // Handle 404 not found
+    if (error.response?.status === 404) {
+      throw new Error(`Translation job ${jobId} not found. The job may have expired or the ID is incorrect.`);
+    }
+
+    // Handle timeout
+    if (error.code === 'ECONNABORTED') {
+      throw new Error(`Resume request timed out. The service may be experiencing high load. Please try again.`);
+    }
+
+    // Generic error
+    throw new Error(`Unable to resume translation: ${error.message}`);
+  }
+}
+
+// Handler for downloading completed translations
+async function handleDownloadTranslations(args) {
+  const { jobId } = args;
+
+  if (!jobId) {
+    throw new Error('jobId is required');
+  }
+
+  const mcpRequest = {
+    jsonrpc: '2.0',
+    id: Date.now(),
+    method: 'tools/call',
+    params: {
+      name: 'download_translations',
+      arguments: { jobId }
+    }
+  };
+
+  try {
+    const response = await axios.post(MCP_SERVER_URL, mcpRequest, {
+      headers: { 'Content-Type': 'application/json' },
+      timeout: 30000
+    });
+
+    if (response.data.error) {
+      throw new Error(`Download translations error: ${response.data.error.message || response.data.error}`);
+    }
+
+    return response.data.result;
+  } catch (error) {
+    console.error('Download translations error:', error);
+
+    // Handle 503 service unavailable
+    if (error.response?.status === 503) {
+      throw new Error(`i18n-agent encountered unexpected problem, and we are working on it, try again later.`);
+    }
+
+    // Handle 404 not found
+    if (error.response?.status === 404) {
+      throw new Error(`Translation job ${jobId} not found. The job may have expired or the ID is incorrect.`);
+    }
+
+    // Handle timeout
+    if (error.code === 'ECONNABORTED') {
+      throw new Error(`Download request timed out. The service may be experiencing high load. Please try again.`);
+    }
+
+    // Generic error
+    throw new Error(`Unable to download translations: ${error.message}`);
+  }
+}
+
 // Start the server
 async function main() {
   const transport = new StdioServerTransport();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@i18n-agent/mcp-client",
-  "version": "1.7.6",
+  "version": "1.7.8",
   "description": "MCP client for i18n-agent translation service with async job support and enhanced progress tracking - supports Claude, Cursor, VS Code, and other AI IDEs",
   "main": "mcp-client.js",
   "bin": {