explainthisrepo 0.9.4 → 0.9.6

package/dist/init.js

@@ -7,6 +7,8 @@ const PROVIDERS = {
     "2": "openai",
     "3": "ollama",
     "4": "anthropic",
+    "5": "groq",
+    "6": "openrouter",
 };
 export async function runInit() {
     const err = process.stderr;
@@ -18,7 +20,7 @@ export async function runInit() {
             "[llm]",
             `provider = "${provider}"`,
             "",
-            `[providers.${provider}]`
+            `[providers.${provider}]`,
         ];
         for (const [k, v] of Object.entries(providerConfig)) {
             lines.push(`${k} = "${v}"`);
@@ -43,7 +45,9 @@ async function promptProvider() {
     err.write("  1) Gemini\n");
     err.write("  2) OpenAI\n");
     err.write("  3) Ollama (local)\n");
-    err.write("  4) Anthropic\n");
+    err.write("  4) Anthropic (Claude)\n");
+    err.write("  5) Groq\n");
+    err.write("  6) OpenRouter\n");
     const choice = (await prompt("> ")).trim();
     const provider = PROVIDERS[choice];
     if (!provider) {
@@ -54,36 +58,87 @@ async function promptProvider() {
 async function promptProviderConfig(provider) {
     if (provider === "gemini") {
         const key = (await promptHidden("Gemini API key: ")).trim();
-        if (!key) {
+        if (!key)
             throw new Error("API key cannot be empty");
-        }
         return { api_key: key };
     }
     if (provider === "openai") {
         const key = (await promptHidden("OpenAI API key: ")).trim();
-        if (!key) {
+        if (!key)
+            throw new Error("API key cannot be empty");
+        return { api_key: key };
+    }
+    if (provider === "anthropic") {
+        const key = (await promptHidden("Anthropic (Claude) API key: ")).trim();
+        if (!key)
             throw new Error("API key cannot be empty");
-        }
         return { api_key: key };
     }
     if (provider === "ollama") {
-        const model = (await prompt("Ollama model (e.g. llama3, glm-5:cloud): ")).trim();
-        if (!model) {
+        const model = (await prompt("Ollama model (e.g. llama3, glm-5:cloud, gemma3:4b): ")).trim();
+        if (!model)
             throw new Error("Model cannot be empty");
-        }
-        const host = (await prompt("Ollama host [http://localhost:11434]: ")).trim()
-            || "http://localhost:11434";
+        const host = (await prompt("Ollama host [http://localhost:11434]: ")).trim() ||
+            "http://localhost:11434";
+        return { model, host };
+    }
+    if (provider === "groq") {
+        const key = (await promptHidden("Groq API key: ")).trim();
+        if (!key)
+            throw new Error("API key cannot be empty");
+        const err = process.stderr;
+        err.write(chalk.bold("Select Groq model:\n"));
+        err.write("  1) llama3-70b-8192\n");
+        err.write("  2) mixtral-8x7b\n");
+        err.write("  3) deepseek-r1-distill-llama-70b\n");
+        const choice = (await prompt("> ")).trim();
+        const modelMap = {
+            "1": "llama3-70b-8192",
+            "2": "mixtral-8x7b",
+            "3": "deepseek-r1-distill-llama-70b",
+        };
+        const model = modelMap[choice];
+        if (!model)
+            throw new Error("Invalid model selection");
         return {
+            api_key: key,
             model,
-            host
         };
     }
-    if (provider === "anthropic") {
-        const key = (await promptHidden("Anthropic API key: ")).trim();
-        if (!key) {
+    if (provider === "openrouter") {
+        const key = (await promptHidden("OpenRouter API key: ")).trim();
+        if (!key)
             throw new Error("API key cannot be empty");
+        const err = process.stderr;
+        err.write(chalk.bold("Select OpenRouter model:\n"));
+        err.write("  1) openai/gpt-4o (balanced)\n");
+        err.write("  2) anthropic/claude-3.5-sonnet (reasoning)\n");
+        err.write("  3) meta-llama/llama-3-70b-instruct (open)\n");
+        err.write("  4) deepseek/deepseek-chat (cheap/fast)\n");
+        err.write("  5) Enter model manually\n");
+        const choice = (await prompt("> ")).trim();
+        const modelMap = {
+            "1": "openai/gpt-4o",
+            "2": "anthropic/claude-3.5-sonnet",
+            "3": "meta-llama/llama-3-70b-instruct",
+            "4": "deepseek/deepseek-chat",
+        };
+        let model;
+        if (choice === "5") {
+            model = (await prompt("Enter model (provider/model): ")).trim();
         }
-        return { api_key: key };
+        else {
+            model = modelMap[choice];
+            if (!model)
+                throw new Error("Invalid model selection");
+        }
+        if (!model || !model.trim()) {
+            throw new Error("Model cannot be empty");
+        }
+        return {
+            api_key: key,
+            model,
+        };
     }
     throw new Error(`Unsupported provider: ${provider}`);
 }
@@ -91,7 +146,7 @@ function prompt(label) {
     const rl = readline.createInterface({
         input: process.stdin,
         output: process.stderr,
-        terminal: true
+        terminal: true,
     });
     return new Promise((resolve) => {
         rl.question(label, (answer) => {
@@ -107,7 +162,7 @@ function promptHidden(label) {
         const rl = readline.createInterface({
             input: process.stdin,
             output: undefined,
-            terminal: true
+            terminal: true,
         });
         rl._writeToOutput = () => { };
         rl.question("", (answer) => {

package/dist/providers/groq.d.ts

@@ -0,0 +1,17 @@
+import { LLMProvider } from "./base.js";
+type GroqConfig = {
+    api_key?: string;
+    model?: string;
+};
+export declare class GroqProvider implements LLMProvider {
+    name: string;
+    private apiKey;
+    private model;
+    private client;
+    constructor(config?: GroqConfig);
+    validateConfig(): void;
+    private getClient;
+    generate(prompt: string): Promise<string>;
+    doctor(): Promise<string[]>;
+}
+export {};

package/dist/providers/groq.js

@@ -0,0 +1,70 @@
+import { LLMProviderError } from "./base.js";
+export class GroqProvider {
+    name = "groq";
+    apiKey;
+    model;
+    client = null;
+    constructor(config = {}) {
+        this.apiKey = config.api_key ?? "";
+        this.model = config.model;
+        this.validateConfig();
+    }
+    validateConfig() {
+        if (!this.apiKey || !this.apiKey.trim()) {
+            throw new LLMProviderError("Groq provider requires an API key.\n" +
+                "Run `explainthisrepo init` or set providers.groq.api_key.");
+        }
+        if (!this.model || !String(this.model).trim()) {
+            throw new LLMProviderError("Groq provider requires a model.\n" +
+                "Set providers.groq.model (e.g. llama3-70b-8192, mixtral-8x7b, deepseek-r1-distill-llama-70b).");
+        }
+    }
+    getClient() {
+        if (this.client) {
+            return this.client;
+        }
+        try {
+            const Groq = require("groq");
+            this.client = new Groq({ apiKey: this.apiKey });
+            return this.client;
+        }
+        catch {
+            throw new LLMProviderError("Groq support is not installed.\n" +
+                "Install it with:\n" +
+                "  npm install groq");
+        }
+    }
+    async generate(prompt) {
+        const client = this.getClient();
+        let response;
+        try {
+            response = await client.chat.completions.create({
+                model: this.model,
+                messages: [
+                    { role: "user", content: prompt }
+                ]
+            });
+        }
+        catch (err) {
+            const message = err?.message ? String(err.message) : String(err);
+            throw new LLMProviderError(`Groq request failed: ${message}`);
+        }
+        let text = null;
+        try {
+            text = response?.choices?.[0]?.message?.content ?? null;
+        }
+        catch {
+            text = null;
+        }
+        if (!text || !text.trim()) {
+            throw new LLMProviderError("Groq returned no text");
+        }
+        return text.trim();
+    }
+    async doctor() {
+        return [
+            `GROQ_API_KEY set: ${Boolean(this.apiKey)}`,
+            `model: ${this.model}`,
+        ];
+    }
+}

package/dist/providers/index.d.ts

@@ -0,0 +1 @@
+export { LLMProvider, LLMProviderError } from "./base.js";

package/dist/providers/index.js

@@ -0,0 +1 @@
+export { LLMProviderError } from "./base.js";

package/dist/providers/openrouter.d.ts

@@ -0,0 +1,17 @@
+import { LLMProvider } from "./base.js";
+type OpenRouterConfig = {
+    api_key?: string;
+    model?: string;
+};
+export declare class OpenRouterProvider implements LLMProvider {
+    name: string;
+    private apiKey;
+    private model;
+    private client;
+    constructor(config?: OpenRouterConfig);
+    validateConfig(): void;
+    private getClient;
+    generate(prompt: string): Promise<string>;
+    doctor(): Promise<string[]>;
+}
+export {};

package/dist/providers/openrouter.js

@@ -0,0 +1,72 @@
+import { LLMProviderError } from "./base.js";
+const BASE_URL = "https://openrouter.ai/api/v1";
+export class OpenRouterProvider {
+    name = "openrouter";
+    apiKey;
+    model;
+    client = null;
+    constructor(config = {}) {
+        this.apiKey = config.api_key ?? "";
+        this.model = config.model;
+        this.validateConfig();
+    }
+    validateConfig() {
+        if (!this.apiKey || !this.apiKey.trim()) {
+            throw new LLMProviderError("OpenRouter provider requires an API key.\n" +
+                "Run `explainthisrepo init` or set providers.openrouter.api_key.");
+        }
+        if (!this.model || !String(this.model).trim()) {
+            throw new LLMProviderError("OpenRouter provider requires a model.\n" +
+                "Set providers.openrouter.model (e.g. openai/gpt-4o, deepseek/deepseek-chat).");
+        }
+    }
+    getClient() {
+        if (this.client) {
+            return this.client;
+        }
+        try {
+            const { OpenAI } = require("openai");
+            this.client = new OpenAI({
+                apiKey: this.apiKey,
+                baseURL: BASE_URL,
+            });
+            return this.client;
+        }
+        catch {
+            throw new LLMProviderError("OpenRouter support is not installed.\n" +
+                "Install it with:\n" +
+                "  npm install openai");
+        }
+    }
+    async generate(prompt) {
+        const client = this.getClient();
+        let response;
+        try {
+            response = await client.chat.completions.create({
+                model: this.model,
+                messages: [{ role: "user", content: prompt }],
+            });
+        }
+        catch (err) {
+            const message = err?.message ? String(err.message) : String(err);
+            throw new LLMProviderError(`OpenRouter request failed: ${message}`);
+        }
+        let text = null;
+        try {
+            text = response?.choices?.[0]?.message?.content ?? null;
+        }
+        catch {
+            text = null;
+        }
+        if (!text || !text.trim()) {
+            throw new LLMProviderError("OpenRouter returned no text");
+        }
+        return text.trim();
+    }
+    async doctor() {
+        return [
+            `OPENROUTER_API_KEY set: ${Boolean(this.apiKey)}`,
+            `model: ${this.model}`,
+        ];
+    }
+}

package/dist/providers/registry.js

@@ -4,11 +4,13 @@ import { GeminiProvider } from "./gemini.js";
 import { OpenAIProvider } from "./openai.js";
 import { OllamaProvider } from "./ollama.js";
 import { AnthropicProvider } from "./anthropic.js";
+import { OpenRouterProvider } from "./openrouter.js";
 const PROVIDER_REGISTRY = {
     gemini: GeminiProvider,
     openai: OpenAIProvider,
     ollama: OllamaProvider,
     anthropic: AnthropicProvider,
+    openrouter: OpenRouterProvider,
 };
 export function listProviders() {
     return Object.keys(PROVIDER_REGISTRY);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "explainthisrepo",
-  "version": "0.9.4",
+  "version": "0.9.6",
   "description": "The fastest way to understand any codebase in plain English. Not blind AI summarization",
   "license": "MIT",
   "type": "module",