explainthisrepo 0.9.2 → 0.9.4

package/dist/init.js

@@ -5,7 +5,8 @@ import { writeConfig } from "./config.js";
 const PROVIDERS = {
     "1": "gemini",
     "2": "openai",
-    "3": "ollama"
+    "3": "ollama",
+    "4": "anthropic",
 };
 export async function runInit() {
     const err = process.stderr;
@@ -42,6 +43,7 @@ async function promptProvider() {
     err.write("  1) Gemini\n");
     err.write("  2) OpenAI\n");
     err.write("  3) Ollama (local)\n");
+    err.write("  4) Anthropic\n");
     const choice = (await prompt("> ")).trim();
     const provider = PROVIDERS[choice];
     if (!provider) {
@@ -76,6 +78,13 @@ async function promptProviderConfig(provider) {
             host
         };
     }
+    if (provider === "anthropic") {
+        const key = (await promptHidden("Anthropic API key: ")).trim();
+        if (!key) {
+            throw new Error("API key cannot be empty");
+        }
+        return { api_key: key };
+    }
     throw new Error(`Unsupported provider: ${provider}`);
 }
 function prompt(label) {

package/dist/providers/anthropic.d.ts

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

package/dist/providers/anthropic.js

@@ -0,0 +1,68 @@
+import { LLMProviderError } from "./base.js";
+const DEFAULT_MODEL = "claude-3-5-sonnet-20241022";
+export class AnthropicProvider {
+    name = "anthropic";
+    apiKey;
+    model;
+    client = null;
+    constructor(config = {}) {
+        this.apiKey = config.api_key ?? "";
+        this.model = config.model ?? DEFAULT_MODEL;
+        this.validateConfig();
+    }
+    validateConfig() {
+        if (!this.apiKey || !this.apiKey.trim()) {
+            throw new LLMProviderError("Anthropic provider requires an API key.\n" +
+                "Run `explainthisrepo init` or set providers.anthropic.api_key.");
+        }
+    }
+    getClient() {
+        if (this.client) {
+            return this.client;
+        }
+        try {
+            const { default: Anthropic } = require("@anthropic-ai/sdk");
+            this.client = new Anthropic({ apiKey: this.apiKey });
+            return this.client;
+        }
+        catch (err) {
+            throw new LLMProviderError("Anthropic support is not installed.\n" +
+                "Install it with:\n" +
+                '  npm install @anthropic-ai/sdk');
+        }
+    }
+    async generate(prompt) {
+        const client = this.getClient();
+        let response;
+        try {
+            response = await client.messages.create({
+                model: this.model,
+                max_tokens: 1024,
+                messages: [
+                    { role: "user", content: prompt }
+                ]
+            });
+        }
+        catch (err) {
+            const message = err?.message ? String(err.message) : String(err);
+            throw new LLMProviderError(`Anthropic request failed: ${message}`);
+        }
+        let text = null;
+        try {
+            text = response?.content?.[0]?.text ?? null;
+        }
+        catch {
+            text = null;
+        }
+        if (!text || !text.trim()) {
+            throw new LLMProviderError("Anthropic returned no text");
+        }
+        return text.trim();
+    }
+    async doctor() {
+        return [
+            `ANTHROPIC_API_KEY set: ${Boolean(this.apiKey)}`,
+            `model: ${this.model}`,
+        ];
+    }
+}

package/dist/providers/ollama.js

@@ -1,16 +1,19 @@
 import { LLMProviderError } from "./base.js";
-const DEFAULT_MODEL = "llama3";
 const DEFAULT_HOST = "http://localhost:11434";
 export class OllamaProvider {
     name = "ollama";
     model;
     host;
     constructor(config = {}) {
-        this.model = config.model ?? DEFAULT_MODEL;
+        this.model = config.model;
         this.host = (config.host ?? DEFAULT_HOST).replace(/\/$/, "");
         this.validateConfig();
     }
     validateConfig() {
+        if (!this.model || !String(this.model).trim()) {
+            throw new LLMProviderError("Ollama provider requires a model.\n" +
+                "Set providers.ollama.model (e.g. llama3, gemma3:4b, glm-5:cloud).");
+        }
         if (!this.host.startsWith("http")) {
             throw new LLMProviderError("Ollama host must be a valid URL (e.g. http://localhost:11434)");
         }
@@ -28,8 +31,8 @@ export class OllamaProvider {
                 results.push(`Ollama server responded with ${res.status}`);
             }
         }
-        catch {
-            results.push("Ollama server not reachable");
+        catch (err) {
+            results.push(`Ollama server not reachable: ${String(err?.message ?? err)}`);
         }
         results.push(`model: ${this.model}`);
         results.push(`host: ${this.host}`);
@@ -42,32 +45,38 @@ export class OllamaProvider {
             prompt,
             stream: false
         };
+        let res;
         try {
-            const res = await fetch(url, {
+            res = await fetch(url, {
                 method: "POST",
                 headers: {
                     "Content-Type": "application/json"
                 },
                 body: JSON.stringify(payload)
             });
-            if (!res.ok) {
-                throw new LLMProviderError(`Ollama server responded with ${res.status}`);
-            }
-            const data = await res.json();
-            const text = data?.response ?? "";
-            if (!text.trim()) {
-                throw new LLMProviderError("Ollama returned no text");
-            }
-            return text.trim();
         }
         catch (err) {
-            const message = err?.message ? String(err.message) : String(err);
             throw new LLMProviderError([
                 "Failed to connect to Ollama.",
                 "Ensure Ollama is running locally.",
                 "Start it with: ollama serve",
-                `Error: ${message}`
+                `Error: ${String(err?.message ?? err)}`
             ].join("\n"));
         }
+        if (!res.ok) {
+            throw new LLMProviderError(`Ollama HTTP error: ${res.status}`);
+        }
+        let data;
+        try {
+            data = await res.json();
+        }
+        catch {
+            throw new LLMProviderError("Invalid response from Ollama");
+        }
+        const text = data?.response;
+        if (!text || !String(text).trim()) {
+            throw new LLMProviderError("Ollama returned no text");
+        }
+        return String(text).trim();
     }
 }

package/dist/providers/registry.js

@@ -3,10 +3,12 @@ import { LLMProviderError } from "./base.js";
 import { GeminiProvider } from "./gemini.js";
 import { OpenAIProvider } from "./openai.js";
 import { OllamaProvider } from "./ollama.js";
+import { AnthropicProvider } from "./anthropic.js";
 const PROVIDER_REGISTRY = {
     gemini: GeminiProvider,
     openai: OpenAIProvider,
     ollama: OllamaProvider,
+    anthropic: AnthropicProvider,
 };
 export function listProviders() {
     return Object.keys(PROVIDER_REGISTRY);

package/package.json

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