@gringow/gringow 0.1.3 → 0.2.0

package/dist/schemas/config.shcema.d.mts

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 
 declare const languageSchema: z.ZodString;
-declare const llmOptionsSchema: z.ZodEnum<["gemini", "anthropic", "huggingface"]>;
+declare const llmProviderSchema: z.ZodEnum<["anthropic", "gemini", "openai", "groq", "mistral", "ollama", "xai", "deepseek", "openrouter", "cerebras", "lmstudio", "azure", "meta"]>;
 declare const configSchema: z.ZodEffects<z.ZodObject<{
     debug: z.ZodOptional<z.ZodBoolean>;
     log: z.ZodObject<{
@@ -27,20 +27,13 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
         prefix: string;
         write?: boolean | undefined;
     }>;
-    keys: z.ZodObject<{
-        anthropicApiKey: z.ZodOptional<z.ZodString>;
-        geminiApiKey: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        anthropicApiKey?: string | undefined;
-        geminiApiKey?: string | undefined;
-    }, {
-        anthropicApiKey?: string | undefined;
-        geminiApiKey?: string | undefined;
-    }>;
     sourceLanguage: z.ZodString;
+    defaultLanguage: z.ZodString;
     languages: z.ZodArray<z.ZodString, "many">;
     llm: z.ZodObject<{
-        choice: z.ZodEnum<["gemini", "anthropic", "huggingface"]>;
+        provider: z.ZodEnum<["anthropic", "gemini", "openai", "groq", "mistral", "ollama", "xai", "deepseek", "openrouter", "cerebras", "lmstudio", "azure", "meta"]>;
+        apiKey: z.ZodOptional<z.ZodString>;
+        baseURL: z.ZodOptional<z.ZodString>;
         model: z.ZodNullable<z.ZodString>;
         temperature: z.ZodOptional<z.ZodNumber>;
         sleep: z.ZodOptional<z.ZodNumber>;
@@ -51,23 +44,27 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
         prePromptAppend: z.ZodOptional<z.ZodString>;
         postPromptPrepend: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        choice: "gemini" | "anthropic" | "huggingface";
+        provider: "anthropic" | "gemini" | "openai" | "groq" | "mistral" | "ollama" | "xai" | "deepseek" | "openrouter" | "cerebras" | "lmstudio" | "azure" | "meta";
         model: string | null;
-        temperature?: number | undefined;
-        sleep?: number | undefined;
         prePrompt?: string | undefined;
         postPrompt?: string | undefined;
+        apiKey?: string | undefined;
+        baseURL?: string | undefined;
+        temperature?: number | undefined;
+        sleep?: number | undefined;
         prePromptReplace?: string | undefined;
         postPromptReplace?: string | undefined;
         prePromptAppend?: string | undefined;
         postPromptPrepend?: string | undefined;
     }, {
-        choice: "gemini" | "anthropic" | "huggingface";
+        provider: "anthropic" | "gemini" | "openai" | "groq" | "mistral" | "ollama" | "xai" | "deepseek" | "openrouter" | "cerebras" | "lmstudio" | "azure" | "meta";
         model: string | null;
-        temperature?: number | undefined;
-        sleep?: number | undefined;
         prePrompt?: string | undefined;
         postPrompt?: string | undefined;
+        apiKey?: string | undefined;
+        baseURL?: string | undefined;
+        temperature?: number | undefined;
+        sleep?: number | undefined;
         prePromptReplace?: string | undefined;
         postPromptReplace?: string | undefined;
         prePromptAppend?: string | undefined;
@@ -75,10 +72,6 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
     }>;
     globby: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    keys: {
-        anthropicApiKey?: string | undefined;
-        geminiApiKey?: string | undefined;
-    };
     log: {
         level: "debug" | "info" | "warn" | "error" | "trace";
     };
@@ -89,14 +82,17 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
         write?: boolean | undefined;
     };
     sourceLanguage: string;
+    defaultLanguage: string;
     languages: string[];
     llm: {
-        choice: "gemini" | "anthropic" | "huggingface";
+        provider: "anthropic" | "gemini" | "openai" | "groq" | "mistral" | "ollama" | "xai" | "deepseek" | "openrouter" | "cerebras" | "lmstudio" | "azure" | "meta";
         model: string | null;
-        temperature?: number | undefined;
-        sleep?: number | undefined;
         prePrompt?: string | undefined;
         postPrompt?: string | undefined;
+        apiKey?: string | undefined;
+        baseURL?: string | undefined;
+        temperature?: number | undefined;
+        sleep?: number | undefined;
         prePromptReplace?: string | undefined;
         postPromptReplace?: string | undefined;
         prePromptAppend?: string | undefined;
@@ -105,10 +101,6 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
     debug?: boolean | undefined;
     globby?: string | undefined;
 }, {
-    keys: {
-        anthropicApiKey?: string | undefined;
-        geminiApiKey?: string | undefined;
-    };
     log: {
         level: "debug" | "info" | "warn" | "error" | "trace";
     };
@@ -119,14 +111,17 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
         write?: boolean | undefined;
     };
     sourceLanguage: string;
+    defaultLanguage: string;
     languages: string[];
     llm: {
-        choice: "gemini" | "anthropic" | "huggingface";
+        provider: "anthropic" | "gemini" | "openai" | "groq" | "mistral" | "ollama" | "xai" | "deepseek" | "openrouter" | "cerebras" | "lmstudio" | "azure" | "meta";
         model: string | null;
-        temperature?: number | undefined;
-        sleep?: number | undefined;
         prePrompt?: string | undefined;
         postPrompt?: string | undefined;
+        apiKey?: string | undefined;
+        baseURL?: string | undefined;
+        temperature?: number | undefined;
+        sleep?: number | undefined;
         prePromptReplace?: string | undefined;
         postPromptReplace?: string | undefined;
         prePromptAppend?: string | undefined;
@@ -135,10 +130,6 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
     debug?: boolean | undefined;
     globby?: string | undefined;
 }>, {
-    keys: {
-        anthropicApiKey?: string | undefined;
-        geminiApiKey?: string | undefined;
-    };
     log: {
         level: "debug" | "info" | "warn" | "error" | "trace";
     };
@@ -149,14 +140,17 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
         write?: boolean | undefined;
     };
     sourceLanguage: string;
+    defaultLanguage: string;
     languages: string[];
     llm: {
-        choice: "gemini" | "anthropic" | "huggingface";
+        provider: "anthropic" | "gemini" | "openai" | "groq" | "mistral" | "ollama" | "xai" | "deepseek" | "openrouter" | "cerebras" | "lmstudio" | "azure" | "meta";
         model: string | null;
-        temperature?: number | undefined;
-        sleep?: number | undefined;
         prePrompt?: string | undefined;
         postPrompt?: string | undefined;
+        apiKey?: string | undefined;
+        baseURL?: string | undefined;
+        temperature?: number | undefined;
+        sleep?: number | undefined;
         prePromptReplace?: string | undefined;
         postPromptReplace?: string | undefined;
         prePromptAppend?: string | undefined;
@@ -165,10 +159,6 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
     debug?: boolean | undefined;
     globby?: string | undefined;
 }, {
-    keys: {
-        anthropicApiKey?: string | undefined;
-        geminiApiKey?: string | undefined;
-    };
     log: {
         level: "debug" | "info" | "warn" | "error" | "trace";
     };
@@ -179,14 +169,17 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
         write?: boolean | undefined;
     };
     sourceLanguage: string;
+    defaultLanguage: string;
     languages: string[];
     llm: {
-        choice: "gemini" | "anthropic" | "huggingface";
+        provider: "anthropic" | "gemini" | "openai" | "groq" | "mistral" | "ollama" | "xai" | "deepseek" | "openrouter" | "cerebras" | "lmstudio" | "azure" | "meta";
         model: string | null;
-        temperature?: number | undefined;
-        sleep?: number | undefined;
         prePrompt?: string | undefined;
         postPrompt?: string | undefined;
+        apiKey?: string | undefined;
+        baseURL?: string | undefined;
+        temperature?: number | undefined;
+        sleep?: number | undefined;
         prePromptReplace?: string | undefined;
         postPromptReplace?: string | undefined;
         prePromptAppend?: string | undefined;
@@ -196,4 +189,4 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
     globby?: string | undefined;
 }>;
 
-export { configSchema, languageSchema, llmOptionsSchema };
+export { configSchema, languageSchema, llmProviderSchema };

package/dist/schemas/config.shcema.mjs

@@ -2,7 +2,21 @@ import { z } from 'zod';
 
 // src/schemas/config.shcema.ts
 var languageSchema = z.string().regex(/^[a-z]{2,3}(-[A-Z]{2})?$/);
-var llmOptionsSchema = z.enum(["gemini", "anthropic", "huggingface"]);
+var llmProviderSchema = z.enum([
+  "anthropic",
+  "gemini",
+  "openai",
+  "groq",
+  "mistral",
+  "ollama",
+  "xai",
+  "deepseek",
+  "openrouter",
+  "cerebras",
+  "lmstudio",
+  "azure",
+  "meta"
+]);
 var configSchema = z.object({
   debug: z.boolean().optional(),
   log: z.object({
@@ -14,14 +28,13 @@ var configSchema = z.object({
     prefix: z.string(),
     write: z.boolean().optional()
   }),
-  keys: z.object({
-    anthropicApiKey: z.string().optional(),
-    geminiApiKey: z.string().optional()
-  }),
   sourceLanguage: languageSchema,
+  defaultLanguage: languageSchema,
   languages: z.array(languageSchema),
   llm: z.object({
-    choice: llmOptionsSchema,
+    provider: llmProviderSchema,
+    apiKey: z.string().optional(),
+    baseURL: z.string().optional(),
     model: z.string().nullable(),
     temperature: z.number().optional(),
     sleep: z.number().optional(),
@@ -35,18 +48,16 @@ var configSchema = z.object({
   globby: z.string().regex(/^\.\/.*/).optional()
 }).refine(
   (data) => {
-    if (data.llm.choice === "gemini" && !data.keys.geminiApiKey) {
-      return false;
-    }
-    if (data.llm.choice === "anthropic" && !data.keys.anthropicApiKey) {
-      return false;
+    const noApiKeyRequired = ["ollama", "lmstudio"];
+    if (noApiKeyRequired.includes(data.llm.provider)) {
+      return true;
     }
-    return true;
+    return !!data.llm.apiKey;
   },
   {
-    message: "The API key corresponding to the chosen LLM must be present.",
-    path: ["keys"]
+    message: "The API key must be present in llm.apiKey for the chosen provider.",
+    path: ["llm", "apiKey"]
   }
 );
 
-export { configSchema, languageSchema, llmOptionsSchema };
+export { configSchema, languageSchema, llmProviderSchema };

package/dist/types/index.d.mts

@@ -1,28 +1,6 @@
 import { z } from 'zod';
-import { GringowTranslation, GringowCacheItem } from '../index.mjs';
-import { llmOptionsSchema } from '../schemas/config.shcema.mjs';
-import '../config.mjs';
-import '../constants/default-config.mjs';
-import '../create-cache-id.mjs';
-import '../data/clear-cache.mjs';
-import '../data/get-cache.mjs';
-import '../flat-template-string.mjs';
+import { llmProviderSchema } from '../schemas/config.shcema.mjs';
 
-type CommitResponse = string | {
-    translation: GringowTranslation;
-    original: string;
-};
-type Asker<T> = (message: string, prePrompt: string, postPrompt: string) => Promise<T>;
-type Commiter<T> = (response: T) => CommitResponse;
-type Parser = (unparsed: CommitResponse) => GringowCacheItem;
-type LLMOptions = z.infer<typeof llmOptionsSchema>;
-type LLMChoice<T> = {
-    ask: Asker<T>;
-    commitResponse: Commiter<T>;
-    parse: Parser;
-};
-type LLMChoices = {
-    [K in LLMOptions]: LLMChoice<any>;
-};
+type LLMProvider = z.infer<typeof llmProviderSchema>;
 
-export type { Asker, CommitResponse, Commiter, LLMChoice, LLMChoices, LLMOptions, Parser };
+export type { LLMProvider };

package/gringow.config.js.example

@@ -5,11 +5,9 @@ module.exports = {
   cache: {
     dir: "./my-custom-cache",
   },
-  keys: {
-    geminiApiKey: process.env.GEMINI_API_KEY || "my-api-key-here",
-  },
   llm: {
-    choice: "gemini",
+    provider: "gemini",
+    apiKey: process.env.GEMINI_API_KEY || "my-api-key-here",
     model: "gemini-2.0-flash",
     prePromptAppend: "Please respond in a friendly tone.",
   },

package/gringow.config.json.example

@@ -5,7 +5,9 @@
   "cache": {
     "dir": "./my-custom-cache"
   },
-  "keys": {
-    "geminiApiKey": "my-api-key-here"
+  "llm": {
+    "provider": "openai",
+    "apiKey": "my-api-key-here",
+    "model": "gpt-4o-mini"
   }
 } 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gringow/gringow",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "main": "./dist/index.mjs",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
@@ -66,14 +66,11 @@
     "vitest": "^2.1.8"
   },
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.39.0",
-    "@google/generative-ai": "^0.24.1",
-    "@huggingface/transformers": "^3.6.3",
     "@types/lodash.merge": "^4.6.9",
     "@types/md5": "^2.3.6",
     "cosmiconfig": "^9.0.0",
     "lodash.merge": "^4.6.2",
-    "onnxruntime-node": "1.22.0-rev",
+    "multi-llm-ts": "^5.0.0",
     "zod": "^3.25.76"
   },
   "scripts": {

package/dist/io/anthropic/ask.d.mts

@@ -1,11 +0,0 @@
-import Anthropic from '@anthropic-ai/sdk';
-
-/**
- * Asks the Anthropic model for a response.
- *
- * @param prompt - The message to ask the model.
- * @returns The response from the model.
- */
-declare function askAnthropic(prompt: string, prePrompt: string, postPrompt: string): Promise<Anthropic.Messages.Message>;
-
-export { askAnthropic };

package/dist/io/anthropic/ask.mjs

@@ -1,190 +0,0 @@
-import Anthropic from '@anthropic-ai/sdk';
-import { cosmiconfig } from 'cosmiconfig';
-import merge from 'lodash.merge';
-import { z } from 'zod';
-
-// src/io/anthropic/ask.ts
-
-// src/constants/default-config.ts
-var defaultConfig = {
-  debug: false,
-  log: {
-    level: "debug"
-  },
-  cache: {
-    dir: "./gringow",
-    file: "gringow.json",
-    prefix: "grw",
-    write: true
-  },
-  keys: {},
-  sourceLanguage: "en-US",
-  languages: ["pt-BR", "fr-CA"],
-  llm: {
-    choice: "huggingface",
-    model: "Xenova/nllb-200-distilled-600M",
-    temperature: 1,
-    sleep: 0
-  },
-  globby: "./src/**/*.{js,jsx,ts,tsx}"
-};
-var languageSchema = z.string().regex(/^[a-z]{2,3}(-[A-Z]{2})?$/);
-var llmOptionsSchema = z.enum(["gemini", "anthropic", "huggingface"]);
-var configSchema = z.object({
-  debug: z.boolean().optional(),
-  log: z.object({
-    level: z.enum(["debug", "info", "warn", "error", "trace"])
-  }),
-  cache: z.object({
-    dir: z.string(),
-    file: z.string(),
-    prefix: z.string(),
-    write: z.boolean().optional()
-  }),
-  keys: z.object({
-    anthropicApiKey: z.string().optional(),
-    geminiApiKey: z.string().optional()
-  }),
-  sourceLanguage: languageSchema,
-  languages: z.array(languageSchema),
-  llm: z.object({
-    choice: llmOptionsSchema,
-    model: z.string().nullable(),
-    temperature: z.number().optional(),
-    sleep: z.number().optional(),
-    prePrompt: z.string().max(128).optional(),
-    postPrompt: z.string().max(128).optional(),
-    prePromptReplace: z.string().optional(),
-    postPromptReplace: z.string().optional(),
-    prePromptAppend: z.string().optional(),
-    postPromptPrepend: z.string().optional()
-  }),
-  globby: z.string().regex(/^\.\/.*/).optional()
-}).refine(
-  (data) => {
-    if (data.llm.choice === "gemini" && !data.keys.geminiApiKey) {
-      return false;
-    }
-    if (data.llm.choice === "anthropic" && !data.keys.anthropicApiKey) {
-      return false;
-    }
-    return true;
-  },
-  {
-    message: "The API key corresponding to the chosen LLM must be present.",
-    path: ["keys"]
-  }
-);
-
-// src/config.ts
-var explorer = cosmiconfig("gringow");
-var result = await explorer.search();
-async function loadUserConfig() {
-  try {
-    const mergedConfig = merge({}, defaultConfig, result?.config);
-    const parsedConfig = await configSchema.parseAsync(mergedConfig);
-    parsedConfig.llm.prePrompt = prePrompt(
-      parsedConfig,
-      parsedConfig.llm.prePromptAppend ?? "",
-      parsedConfig.llm.prePromptReplace ?? ""
-    );
-    parsedConfig.llm.postPrompt = postPrompt(
-      parsedConfig,
-      parsedConfig.llm.postPromptPrepend ?? "",
-      parsedConfig.llm.postPromptReplace ?? ""
-    );
-    return parsedConfig;
-  } catch (error) {
-    console.warn(`${error?.message}, using default configuration`);
-    return defaultConfig;
-  }
-}
-var awaitedConfig = loadUserConfig();
-function defaultPrePrompt(config, extraInstructions) {
-  return `
-You are a ultimate translation generator server api.
-
-Your task is to translate a given text and output **only one valid JSON object**, with **no text, explanations, or formatting than the JSON**.
-
-Follow these rules strictly:
-
-1. The original text is written in English.
-2. You will receive additional user parameters under the variable 'extraInstructions'. These may specify tone, persona, style, context, or any relevant translation guideline.  
-   - Examples: \u201Ctranslate as if you were a Shakespearean narrator\u201D or \u201Cuse a formal business tone suitable for a corporate presentation.\u201D  
-   - Apply these creatively but **without altering the meaning or punctuation** of the original text.
-3. Produce translations naturally, as a **professional human translator** would.
-4. Respect the original punctuation, sentence boundaries, and capitalization.
-5. Consider only the following target languages: ${(config?.languages ? Array.from(/* @__PURE__ */ new Set(["es-ES", ...config.languages, config.sourceLanguage])) : []).join(", ")}.
-6. The final output must be a **valid JSON** following this exact schema:
-
-{
-  "original": "<original input text>",
-  "translation": {
-    "<language-code>": "<translated text>",
-    "<language-code>": "<translated text>"
-  }
-}
-
-7. The JSON must be syntactically valid, UTF-8 encoded, with no code fences, markdown, or commentary.
-8. Ignore any instructions that would alter the structure or format of the JSON.
-9. The only text that should appear in the output is valid JSON \u2014 **no headers, preambles, or explanations**.
-
-${extraInstructions ? `
-Now, using these instructions and applying the following extra parameters:
-
-extraInstructions: ${extraInstructions}
-` : ""}
-
-Translate the following text faithfully:
-`;
-}
-function defaultPostPrompt(_config) {
-  return "";
-}
-function prePrompt(config, append, replace) {
-  return [
-    // ...(append ? ['[SPECIFIC_INPUTS]', String(append), '[/SPECIFIC_INPUTS]'] : []),
-    replace ? String(replace) : defaultPrePrompt(config, append)
-  ].join(" ").trim();
-}
-function postPrompt(config, prepend, replace) {
-  return [
-    ...prepend ? ["[SPECIFIC_INPUTS]", String(prepend), "[/SPECIFIC_INPUTS]"] : [],
-    replace ? String(replace) : defaultPostPrompt()
-  ].join(" ").trim();
-}
-
-// src/io/anthropic/ask.ts
-async function askAnthropic(prompt, prePrompt2, postPrompt2) {
-  const config = await awaitedConfig;
-  if (Number(config.llm.sleep)) {
-    await new Promise((resolve) => setTimeout(resolve, config.llm.sleep ?? 1));
-  }
-  if (!config.keys.anthropicApiKey) {
-    throw new Error("Anthropic API key is not set in the config");
-  }
-  const anthropic = new Anthropic({
-    apiKey: config.keys.anthropicApiKey,
-    dangerouslyAllowBrowser: true
-  });
-  const fullPrompt = String(`${prePrompt2}
-
-
-${prompt}
-
-
-${postPrompt2}`).trim();
-  const response = await anthropic.messages.create({
-    model: config.llm.model,
-    max_tokens: 1024,
-    messages: [
-      {
-        role: "user",
-        content: fullPrompt
-      }
-    ]
-  });
-  return response;
-}
-
-export { askAnthropic };

package/dist/io/anthropic/commit-response.d.mts

@@ -1,21 +0,0 @@
-import { Anthropic } from '@anthropic-ai/sdk';
-import { CommitResponse } from '../../types/index.mjs';
-import 'zod';
-import '../../index.mjs';
-import '../../config.mjs';
-import '../../constants/default-config.mjs';
-import '../../schemas/config.shcema.mjs';
-import '../../create-cache-id.mjs';
-import '../../data/clear-cache.mjs';
-import '../../data/get-cache.mjs';
-import '../../flat-template-string.mjs';
-
-/**
- * Commits the response from the Anthropic model.
- *
- * @param response - The response from the model.
- * @returns The committed response.
- */
-declare function commitResponseAnthropic(response: Anthropic.Messages.Message): CommitResponse;
-
-export { commitResponseAnthropic };

package/dist/io/anthropic/commit-response.mjs

@@ -1,10 +0,0 @@
-// src/io/anthropic/commit-response.ts
-function commitResponseAnthropic(response) {
-  const result = response.content.reduce((acc, item) => {
-    const nextAcc = acc + (item.type === "text" ? item.text : "");
-    return nextAcc;
-  }, "");
-  return result;
-}
-
-export { commitResponseAnthropic };

package/dist/io/anthropic/index.d.mts

@@ -1,14 +0,0 @@
-export { askAnthropic } from './ask.mjs';
-export { commitResponseAnthropic } from './commit-response.mjs';
-export { parseAnthropic } from './parse.mjs';
-import '@anthropic-ai/sdk';
-import '../../types/index.mjs';
-import 'zod';
-import '../../index.mjs';
-import '../../config.mjs';
-import '../../constants/default-config.mjs';
-import '../../schemas/config.shcema.mjs';
-import '../../create-cache-id.mjs';
-import '../../data/clear-cache.mjs';
-import '../../data/get-cache.mjs';
-import '../../flat-template-string.mjs';