Merge pull request #22 from Serchinastico/remote-llms

Support for remote LLMs (OpenAI and Claude)

Author: Serchinastico

npm-shrinkwrap.json

@@ -8,63 +8,65 @@
   },
   "bugs": "https://github.com/madeja-studio/linguito/issues",
   "dependencies": {
-    "@ai-sdk/openai": "^1",
-    "@ai-sdk/openai-compatible": "^0.1.6",
+    "@ai-sdk/anthropic": "^1.2.12",
+    "@ai-sdk/openai": "^1.3.22",
+    "@ai-sdk/openai-compatible": "^0.2.14",
     "@inkjs/ui": "^2",
-    "@lingui/conf": "^5",
-    "@madeja-studio/cepillo": "^0.4.0",
-    "@oclif/core": "^4",
-    "@oclif/plugin-help": "^6",
-    "@oclif/plugin-plugins": "^5",
-    "ai": "^4",
-    "color-json": "^3",
+    "@lingui/conf": "^5.3.2",
+    "@madeja-studio/cepillo": "^0.7.1",
+    "@oclif/core": "^4.3.0",
+    "@oclif/plugin-help": "^6.2.28",
+    "@oclif/plugin-plugins": "^5.4.38",
+    "ai": "^4.3.16",
+    "color-json": "^3.0.5",
     "configstore": "^7",
-    "espree": "^10",
+    "espree": "^10.3.0",
     "gettext-parser": "^8",
-    "ink": "^5",
-    "npm-check-updates": "^17",
-    "ollama-ai-provider": "^1",
-    "react": "^18",
-    "ts-deepmerge": "^7",
-    "zod": "^3"
+    "ink": "^5.2.1",
+    "npm-check-updates": "^18.0.1",
+    "ollama-ai-provider": "^1.2.0",
+    "react": "^18.3.1",
+    "ts-deepmerge": "^7.0.3",
+    "zod": "^3.25.32"
   },
   "devDependencies": {
-    "@commitlint/config-conventional": "^19",
-    "@eslint/eslintrc": "^3",
-    "@eslint/js": "^9",
+    "@commitlint/config-conventional": "^19.8.1",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.27.0",
     "@oclif/prettier-config": "^0.2.1",
-    "@oclif/test": "^4",
-    "@release-it/conventional-changelog": "^9",
-    "@types/chai": "^5",
-    "@types/configstore": "^6",
-    "@types/espree": "^10",
-    "@types/gettext-parser": "^4",
-    "@types/node": "^22",
-    "@types/react": "^19",
-    "chai": "^5",
-    "commitlint": "^19",
-    "eslint": "^9",
-    "eslint-config-oclif": "^5",
-    "eslint-config-oclif-typescript": "^3",
-    "eslint-config-prettier": "^9",
-    "eslint-plugin-chai-friendly": "^1",
-    "eslint-plugin-perfectionist": "^4",
-    "eslint-plugin-prettier": "^5",
-    "lefthook": "^1",
-    "oclif": "^4",
-    "prettier": "^3",
-    "release-it": "^17",
-    "shx": "^0.3.4",
-    "ts-morph": "^25",
-    "tsc-alias": "^1",
-    "tsx": "^4",
-    "typescript": "^5",
-    "typescript-eslint": "^8",
-    "vitest": "^3"
+    "@oclif/test": "^4.1.13",
+    "@release-it/conventional-changelog": "^10.0.1",
+    "@types/chai": "^5.2.2",
+    "@types/configstore": "^6.0.2",
+    "@types/espree": "^10.1.0",
+    "@types/gettext-parser": "^4.0.4",
+    "@types/node": "^22.15.23",
+    "@types/react": "^19.1.6",
+    "chai": "^5.2.0",
+    "commitlint": "^19.8.1",
+    "eslint": "^9.27.0",
+    "eslint-config-oclif": "^6.0.62",
+    "eslint-config-prettier": "^10.1.5",
+    "eslint-plugin-chai-friendly": "^1.0.1",
+    "eslint-plugin-perfectionist": "^4.13.0",
+    "eslint-plugin-prettier": "^5.4.0",
+    "lefthook": "^1.11.13",
+    "oclif": "^4.17.46",
+    "prettier": "^3.5.3",
+    "release-it": "^19.0.2",
+    "shx": "^0.4.0",
+    "ts-morph": "^26.0.0",
+    "tsc-alias": "^1.8.16",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.33.0",
+    "vitest": "^3.1.4"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=18.0.0",
+    "npm": ">=9.0.0"
   },
+  "packageManager": "npm@11.4.1",
   "files": [
     "/bin",
     "/dist",

package.json

@@ -1,7 +1,8 @@
+import {Args} from '@oclif/core'
+
 import BaseCommand from '@/lib/command/base.js'
 import {ConfigParser} from '@/lib/lingui/parser.js'
 import {Translations} from '@/lib/lingui/translations.js'
-import {Args} from '@oclif/core'
 
 const SEPARATOR = '\n\t• '
 

src/commands/check.ts

@@ -1,8 +1,9 @@
+import {Args, Flags} from '@oclif/core'
+import cj from 'color-json'
+
 import BaseCommand from '@/lib/command/base.js'
 import {ConfigKeyPath} from '@/lib/common/types.js'
 import {ConfigManager} from '@/lib/config/config-manager.js'
-import {Args, Flags} from '@oclif/core'
-import cj from 'color-json'
 
 export default class Get extends BaseCommand {
   static args = {

src/commands/config/get.ts

@@ -1,9 +1,10 @@
+import Configstore from 'configstore'
+import fs from 'node:fs/promises'
+
 import BaseCommand from '@/lib/command/base.js'
 import {Config as ConfigType, emptyConfig} from '@/lib/common/types.js'
 import {EditConfig} from '@/lib/ui/config/EditConfig.js'
 import {render} from '@/lib/ui/render.js'
-import Configstore from 'configstore'
-import fs from 'node:fs/promises'
 
 export default class Config extends BaseCommand {
   static description = `Opens an interactive session to view, update, and save the configuration settings for Linguito. This includes options such as provider and model preferences.`

src/commands/config/index.ts

@@ -1,7 +1,8 @@
+import {Args} from '@oclif/core'
+
 import BaseCommand from '@/lib/command/base.js'
 import {ConfigKeyPath} from '@/lib/common/types.js'
 import {ConfigManager} from '@/lib/config/config-manager.js'
-import {Args} from '@oclif/core'
 
 export default class Set extends BaseCommand {
   static args = {

src/commands/config/set.ts

@@ -1,3 +1,5 @@
+import {Args, Flags} from '@oclif/core'
+
 import BaseCommand from '@/lib/command/base.js'
 import {invariant} from '@/lib/command/invariant.js'
 import {ConfigManager} from '@/lib/config/config-manager.js'
@@ -6,7 +8,6 @@ import {Translations} from '@/lib/lingui/translations.js'
 import {Llm} from '@/lib/llm/llm.js'
 import {render} from '@/lib/ui/render.js'
 import {AskForTranslations} from '@/lib/ui/translate/AskForTranslations.js'
-import {Args, Flags} from '@oclif/core'
 
 export default class Translate extends BaseCommand {
   static args = {

src/commands/translate.ts

@@ -1,8 +1,9 @@
-import {canReadFile, isFile} from '@/lib/fs/fs.js'
 import {Command} from '@oclif/core'
 import {CommandError} from '@oclif/core/interfaces'
 import path from 'node:path'
 
+import {canReadFile, isFile} from '@/lib/fs/fs.js'
+
 import {invariant, INVARIANT_ERROR_PREFIX, InvariantErrorCode, invariantErrorMessage} from './invariant.js'
 
 export default abstract class BaseCommand extends Command {

src/lib/command/base.ts

@@ -3,15 +3,21 @@ export const INVARIANT_ERROR_PREFIX: string = 'Invariant failed::'
 export type InvariantErrorCode =
   | 'internal_error'
   | 'invalid_translate_options'
+  | 'llm:config:no_api_key'
+  | 'llm:config:no_provider'
   | 'llm:no_models_found'
   | 'missing_lingui_config_file'
   | 'unknown_catalog_file_format'
 
 export const invariantErrorMessage: Record<InvariantErrorCode, string> = {
-  internal_error: 'Internal error. Please report this in the GitHub repository including as much context as possible.',
+  internal_error: 'Internal error. Please report this in the GitHub repository including as much context as possible',
   invalid_translate_options:
-    "Invalid options passed to 'translate' function. Both interactive and llm options can't be false at the same time.",
-  'llm:no_models_found': 'No models loaded in your LLM',
+    "Invalid options passed to 'translate' function. Both interactive and llm options can't be false or missing at the same time",
+  'llm:config:no_api_key':
+    'No API key found in Linguito configuration. Please configure an API key using the "config" command',
+  'llm:config:no_provider':
+    'Provider missing from Linguito configuration. Please configure a provider using the "config" command',
+  'llm:no_models_found': 'No models loaded in your LLM service',
   missing_lingui_config_file: 'lingui.config.js does not exist or is not readable',
   unknown_catalog_file_format: 'Translation files must be in a known format. Currently supported formats are: po',
 }

src/lib/command/invariant.ts

@@ -0,0 +1,6 @@
+/**
+ * A function that checks if the provided string is non-empty and returns the trimmed string.
+ * If the string is empty or undefined, it returns undefined.
+ */
+export const nonEmptyStringOrUndefined = (str?: string): string | undefined =>
+  str && str.trim().length > 0 ? str : undefined