@l10nmonster/helpers-anthropic 3.0.0-alpha.9 → 3.1.1

package/CHANGELOG.md

@@ -1,3 +1,38 @@
+## @l10nmonster/helpers-anthropic [3.1.1](https://public-github/l10nmonster/l10nmonster/compare/@l10nmonster/helpers-anthropic@3.1.0...@l10nmonster/helpers-anthropic@3.1.1) (2025-12-23)
+
+
+### Bug Fixes
+
+* Improve type definitions and checks ([826b412](https://public-github/l10nmonster/l10nmonster/commit/826b412f0f7e761d404165a243b0c2b26c416ac1))
+
+## @l10nmonster/helpers-anthropic [3.1.1](https://public-github/l10nmonster/l10nmonster/compare/@l10nmonster/helpers-anthropic@3.1.0...@l10nmonster/helpers-anthropic@3.1.1) (2025-12-23)
+
+
+### Bug Fixes
+
+* Improve type definitions and checks ([826b412](https://public-github/l10nmonster/l10nmonster/commit/826b412f0f7e761d404165a243b0c2b26c416ac1))
+
+
+
+
+
+### Dependencies
+
+* **@l10nmonster/core:** upgraded to 3.1.1
+
+# @l10nmonster/helpers-anthropic [3.1.0](https://public-github/l10nmonster/l10nmonster/compare/@l10nmonster/helpers-anthropic@3.0.0...@l10nmonster/helpers-anthropic@3.1.0) (2025-12-20)
+
+
+### Bug Fixes
+
+* Add support for async functions for secrets ([5d9d0a9](https://public-github/l10nmonster/l10nmonster/commit/5d9d0a99f45e1f4f16a30a634bea4259b106d74a))
+* **server:** Fix cart cleanup ([9bbcab9](https://public-github/l10nmonster/l10nmonster/commit/9bbcab93e1fd20aeb09f59c828665159f091f37c))
+
+
+### Features
+
+* **providers:** Support promises for secrets ([3ac66dc](https://public-github/l10nmonster/l10nmonster/commit/3ac66dc13761f671a85f7f3b3df0539d021366dd))
+
 # Changelog
 
 All notable changes to this project will be documented in this file.

package/anthropicAgent.js

@@ -2,7 +2,7 @@ import { AnthropicVertex } from '@anthropic-ai/vertex-sdk';
 import Anthropic from '@anthropic-ai/sdk';
 import { GoogleAuth } from 'google-auth-library';
 
-import { logInfo, logWarn, providers, styleString } from '../core/index.js';
+import { logInfo, logWarn, providers, styleString } from '@l10nmonster/core';
 
 const TRANSLATION_TOOL = {
     name: 'provide_translations',
@@ -29,11 +29,11 @@ const TRANSLATION_TOOL = {
 
 /**
  * @typedef {object} AnthropicAgentOptions
- * @extends LLMTranslationProviderOptions
  * @property {Promise<string>|string} [apiKey] - The Anthropic API key (if using direct API).
  * @property {string} [vertexProject] - The VertexAI project ID.
  * @property {string} [vertexLocation] - The VertexAI datacenter location.
  * @property {number} [maxTokens] - Maximum number of output tokens (32000 by default)
+ * @property {number} [maxRetries] - Maximum number of retries (2 by default)
  */
 
 /**
@@ -52,6 +52,7 @@ export class AnthropicAgent extends providers.LLMTranslationProvider {
      * @param {AnthropicAgentOptions} options - Configuration options for the provider.
      */
     constructor({ apiKey, vertexProject, vertexLocation, maxTokens, maxRetries, ...options }) {
+        // @ts-ignore - spread loses type info but parent class handles validation
         super({...options, maxRetries: 0}); // bypass our own retry logic since Anthropic SDK has built-in support
         this.#apiKey = apiKey;
         this.#vertexProject = vertexProject;
@@ -68,8 +69,10 @@ export class AnthropicAgent extends providers.LLMTranslationProvider {
         }
         if (this.#apiKey) {
             // Direct Anthropic API
+            // @ts-ignore - apiKey can be a function or value, TypeScript doesn't narrow correctly
+            const resolvedKey = await (typeof this.#apiKey === 'function' ? this.#apiKey() : this.#apiKey);
             this.#client = new Anthropic({
-                apiKey: await (typeof this.#apiKey === 'function' ? this.#apiKey() : this.#apiKey),
+                apiKey: resolvedKey,
                 maxRetries: this.#maxRetries,
                 timeout: 15 * 60000, // 15 minutes
             });
@@ -93,7 +96,7 @@ export class AnthropicAgent extends providers.LLMTranslationProvider {
         }
     }
 
-    prepareTranslateChunkArgs({ sourceLang, targetLang, xmlTus, instructions }) {
+    prepareTranslateChunkArgs({ sourceLang, targetLang, xmlTus, jobGuid, chunkNumber, instructions }) {
         const userPrompt = this.buildUserPrompt({ sourceLang, targetLang, xmlTus, instructions });
         
         const messages = [
@@ -103,7 +106,8 @@ export class AnthropicAgent extends providers.LLMTranslationProvider {
             }
         ];
 
-        const toolConfig = this.customSchema ? {
+        const toolConfig = this.customSchema ?
+{
             tools: [{
                 name: 'provide_custom_translations',
                 description: 'Provide translations using custom schema',
@@ -119,7 +123,8 @@ export class AnthropicAgent extends providers.LLMTranslationProvider {
                 }
             }],
             tool_choice: { type: 'tool', name: 'provide_custom_translations' }
-        } : {
+        } :
+{
             tools: [TRANSLATION_TOOL],
             tool_choice: { type: 'tool', name: 'provide_translations' }
         };
@@ -130,7 +135,12 @@ export class AnthropicAgent extends providers.LLMTranslationProvider {
             temperature: this.temperature,
             system: this.systemPrompt,
             messages,
-            ...toolConfig
+            ...toolConfig,
+            sourceLang,
+            targetLang,
+            xmlTus,
+            jobGuid,
+            chunkNumber,
         };
     }
 

package/package.json

@@ -1,22 +1,23 @@
 {
-  "name": "@l10nmonster/helpers-anthropic",
-  "version": "3.0.0-alpha.9",
-  "description": "Anthropic Claude LLM provider for l10nmonster using Vertex AI",
-  "type": "module",
-  "main": "anthropicAgent.js",
-  "scripts": {
-    "test": "node --test"
-  },
-  "dependencies": {
-    "@anthropic-ai/vertex-sdk": "latest",
-    "@anthropic-ai/sdk": "latest",
-    "google-auth-library": "^10"
-  },
-  "peerDependencies": {
-    "@l10nmonster/core": "^3.0.0-alpha.0"
-  },
-  "engines": {
-    "node": ">=22.11.0"
-  },
-  "license": "MIT"
+    "name": "@l10nmonster/helpers-anthropic",
+    "version": "3.1.1",
+    "description": "Anthropic Claude LLM provider for l10nmonster using Vertex AI",
+    "type": "module",
+    "main": "anthropicAgent.js",
+    "scripts": {
+        "test": "node --test",
+        "typecheck": "tsc --noEmit"
+    },
+    "dependencies": {
+        "@anthropic-ai/vertex-sdk": "latest",
+        "@anthropic-ai/sdk": "latest",
+        "google-auth-library": "^10"
+    },
+    "peerDependencies": {
+        "@l10nmonster/core": "3.1.1"
+    },
+    "engines": {
+        "node": ">=22.11.0"
+    },
+    "license": "MIT"
 }

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "extends": "../tsconfig.base.json",
+  "include": [
+    "*.js",
+    "**/*.js"
+  ],
+  "exclude": [
+    "node_modules",
+    "**/node_modules",
+    "test/**",
+    "tests/**",
+    "**/*.test.js",
+    "**/*.spec.js",
+    "dist/**",
+    "ui/**",
+    "types/**"
+  ]
+}

package/.releaserc.json

@@ -1,31 +0,0 @@
-{
-  "branches": [
-    "main",
-    {
-      "name": "next",
-      "prerelease": "alpha"
-    },
-    {
-      "name": "beta",
-      "prerelease": "beta"
-    }
-  ],
-  "tagFormat": "@l10nmonster/helpers-anthropic@${version}",
-  "plugins": [
-    "@semantic-release/commit-analyzer",
-    "@semantic-release/release-notes-generator",
-    {
-      "path": "@semantic-release/changelog",
-      "changelogFile": "CHANGELOG.md"
-    },
-    {
-      "path": "@semantic-release/npm",
-      "npmPublish": true
-    },
-    {
-      "path": "@semantic-release/git",
-      "assets": ["CHANGELOG.md", "package.json"],
-      "message": "chore(release): @l10nmonster/helpers-anthropic@${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
-    }
-  ]
-}

package/example.js

@@ -1,65 +0,0 @@
-import { AnthropicAgent } from './index.js';
-
-// Example L10nMonster configuration using AnthropicAgent
-export const exampleConfig = {
-    translationProviders: [
-        // Direct API configuration
-        {
-            id: 'claude-direct-api',
-            provider: AnthropicAgent,
-            options: {
-                model: 'claude-3-5-sonnet-latest',
-                quality: 90,
-                temperature: 0.1,
-                maxTokens: 4096,
-                maxRetries: 3,                    // Passed to Anthropic SDK for native retry handling
-                apiKey: process.env.ANTHROPIC_API_KEY, // Set your API key
-                persona: 'You are a professional translator specializing in technical documentation and user interfaces.',
-            }
-        },
-        // Vertex AI configuration
-        {
-            id: 'claude-vertex-sonnet',
-            provider: AnthropicAgent,
-            options: {
-                model: 'claude-3-5-sonnet@20241022',
-                quality: 85,
-                temperature: 0.1,
-                maxTokens: 4096,
-                // vertexProject: 'your-gcp-project-id', // Optional, auto-detected
-                vertexLocation: 'us-central1',
-                persona: 'You are a professional translator specializing in technical documentation and user interfaces.',
-            }
-        },
-        {
-            id: 'claude-vertex-haiku',
-            provider: AnthropicAgent,
-            options: {
-                model: 'claude-3-5-haiku@20241022',
-                quality: 80,
-                temperature: 0.1,
-                maxTokens: 2048,
-                vertexLocation: 'us-central1',
-                persona: 'You are a fast and efficient translator focused on accuracy and consistency.',
-            }
-        }
-    ],
-    
-    // Example translation jobs configuration
-    jobs: [
-        {
-            id: 'ui-translation',
-            translationProvider: 'claude-direct-api',
-            instructions: 'Translate user interface strings. Keep labels concise and maintain consistent terminology.',
-        },
-        {
-            id: 'content-translation',
-            translationProvider: 'claude-vertex-haiku',
-            instructions: 'Translate general content while maintaining the original tone and style.',
-        }
-    ]
-};
-
-// Example usage
-console.log('AnthropicAgent configuration example loaded');
-console.log('Available providers:', exampleConfig.translationProviders.map(p => p.id));