@npm7381/agent-doc-generator 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Marcelo Adán
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,75 @@
+# agent-doc-generator
+
+Genera documentación JSDoc automática usando IA.
+
+## Instalación
+
+```bash
+# Global
+npm install -g agent-doc-generator
+
+# O sin instalar
+npx agent-doc-generator --path ./src
+```
+
+## Uso
+
+```bash
+agent-doc-generator --path ./src                        # documentación de todo src/
+agent-doc-generator --path ./src/utils.ts               # un solo archivo
+agent-doc-generator --path ./src --split                # un DOCS.md por archivo
+agent-doc-generator --path ./src --format html          # salida HTML
+agent-doc-generator --path ./src --extensions .ts,.prisma  # solo archivos .ts y .prisma
+agent-doc-generator --path ./src --dry-run              # preview sin escribir
+agent-doc-generator --path ./src --verbose              # logs detallados
+```
+
+## Proveedores
+
+| Provider | Modelo Default | Auth | Notas |
+|----------|---------------|------|-------|
+| gemini | `gemini-2.5-flash` | `GEMINI_API_KEY` | Free tier disponible |
+| openai | `gpt-4o` | `OPENAI_API_KEY` | GPT-4o, GPT-4o-mini |
+| anthropic | `claude-sonnet-4-20250514` | `ANTHROPIC_API_KEY` | Claude |
+| deepseek | `deepseek-chat` | `DEEPSEEK_API_KEY` | El más barato |
+| ollama | modelo instalado | Sin key | Local, gratis, privacidad |
+
+**Auto-detección**: Si no especificas `--provider`, detecta automáticamente qué tienes configurado (keys en `.env` o Ollama corriendo).
+
+## Flags
+
+| Flag | Descripción | Default |
+|------|-------------|---------|
+| `--path` | Archivo o carpeta a procesar | (requerido) |
+| `--provider` | `gemini` \| `openai` \| `anthropic` \| `deepseek` \| `ollama` | auto-detectado |
+| `--model` | Modelo a usar | según provider |
+| `--base-url` | URL del servidor (Ollama) | `http://localhost:11434` |
+| `--api-key` | API key (opcional para Ollama) | .env |
+| `--max-chars` | Límite de chars por archivo | 15000 |
+| `--output` | Carpeta/archivo de salida | junto al archivo |
+| `--extensions` | Extensiones a procesar (CSV: `.ts,.prisma`) | todas |
+| `--split` | Un archivo por cada fuente | false |
+| `--format` | Formato de salida `terminal` \| `markdown` \| `html` \| `pdf` | terminal |
+| `--dry-run` | Solo preview, no escribir | false |
+| `--verbose` | Logs detallados | false |
+
+## Features
+
+- **Modo single** (default): genera un único `DOCS.md`
+- **Modo split** (`--split`): genera `.docs.md` por cada fuente
+- **Cache**: hash MD5 para no regenerar archivos sin cambios
+- **Auto-detección**: detecta provider disponible al iniciar
+- **Resiliencia**: 3 reintentos con backoff ante errores de API
+- **Truncado**: archivos > `--max-chars` se recortan con aviso
+- **Filtro por extensión**: `--extensions .ts,.prisma` para limitar tipos de archivo
+
+## Requisitos
+
+- Node.js >= 18
+- Un proveedor de IA configurado (API key o Ollama local)
+
+## Licencia
+
+MIT
+
+Parte de [AI Agent Toolkit](https://github.com/MarceloAdan73/ai-agent-toolkit).

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,299 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import dotenv from 'dotenv';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import ora from 'ora';
+import { collectFiles, readFile, writeDocFile, writeSingleDocFile, shouldSkipContent } from './src/fileProcessor.js';
+import { createAIClient, generateDocumentation, extractDocContent } from './src/docGenerator.js';
+import { loadCache, saveCache, computeFileHash, isFileCached, updateCache } from './src/cache.js';
+import { detectProvider, loadConfig, saveConfig, printDetectionResult } from './src/providerDetector.js';
+import { loadConfigFile, mergeConfig } from './src/configLoader.js';
+import { generateHtmlFromContent } from './src/htmlFormatter.js';
+import { generatePdfFromContent } from './src/pdfFormatter.js';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+dotenv.config({ path: path.join(__dirname, '.env') });
+const program = new Command();
+program
+    .name('agent-doc-generator')
+    .description('AI-powered documentation generator')
+    .version('2.1.0')
+    .requiredOption('--path <path>', 'Path to file or directory to document')
+    .option('--model <model>', 'AI model to use (auto-detected if not set)')
+    .option('--provider <provider>', 'AI provider: gemini | openai | anthropic | deepseek | ollama')
+    .option('--base-url <url>', 'Base URL for Ollama provider')
+    .option('--api-key <key>', 'API key (optional for Ollama)')
+    .option('--max-chars <n>', 'Maximum characters per file (default: 15000)', (val) => parseInt(val, 10))
+    .option('--output <dir>', 'Output directory for documentation files')
+    .option('--format <format>', 'Output format: markdown | html | pdf', 'markdown')
+    .option('--split', 'Generate one .docs.md file per source file (default: single DOCS.md)')
+    .option('--dry-run', 'Preview what would be generated without writing files')
+    .option('--extensions <extensions>', 'File extensions to process (comma-separated, e.g. .ts,.prisma)')
+    .option('--verbose', 'Show detailed logs')
+    .parse(process.argv);
+const options = program.opts();
+const rcConfig = loadConfigFile(process.cwd());
+async function resolveProvider() {
+    if (options.provider) {
+        return {
+            provider: options.provider,
+            model: options.model ?? getDefaultModelForProvider(options.provider),
+            apiKey: options.apiKey,
+            baseUrl: options.baseUrl,
+        };
+    }
+    if (rcConfig?.provider) {
+        return {
+            provider: rcConfig.provider,
+            model: options.model ?? rcConfig.model ?? getDefaultModelForProvider(rcConfig.provider),
+            baseUrl: options.baseUrl ?? rcConfig.baseUrl,
+        };
+    }
+    const projectRoot = process.cwd();
+    const savedConfig = loadConfig(projectRoot);
+    if (savedConfig) {
+        return {
+            provider: savedConfig.provider,
+            model: options.model ?? savedConfig.model,
+            baseUrl: savedConfig.baseUrl,
+        };
+    }
+    const detected = await detectProvider({ projectRoot });
+    if (detected) {
+        saveConfig(projectRoot, detected);
+        return {
+            provider: detected.provider,
+            model: options.model ?? detected.model,
+            baseUrl: detected.baseUrl,
+        };
+    }
+    return { provider: 'gemini', model: options.model ?? 'gemini-2.5-flash' };
+}
+function getDefaultModelForProvider(provider) {
+    const defaults = {
+        gemini: 'gemini-2.5-flash',
+        openai: 'gpt-4o',
+        anthropic: 'claude-sonnet-4-20250514',
+        deepseek: 'deepseek-chat',
+        ollama: 'llama3',
+    };
+    return defaults[provider] ?? 'gemini-2.5-flash';
+}
+function getApiKeyForProvider(provider) {
+    const envKeyMap = {
+        gemini: 'GEMINI_API_KEY',
+        openai: 'OPENAI_API_KEY',
+        anthropic: 'ANTHROPIC_API_KEY',
+        deepseek: 'DEEPSEEK_API_KEY',
+    };
+    const envKey = envKeyMap[provider];
+    return envKey ? process.env[envKey] : undefined;
+}
+async function main() {
+    const verbose = mergeConfig(options.verbose, rcConfig?.verbose, false);
+    const dryRun = mergeConfig(options.dryRun, rcConfig?.dryRun, false);
+    const splitMode = mergeConfig(options.split, rcConfig?.split, false);
+    const maxChars = mergeConfig(options.maxChars, rcConfig?.maxChars, 15000);
+    console.log('=== Agent Doc Generator v2.1.0 ===\n');
+    if (dryRun) {
+        console.log('[DRY-RUN] Modo preview activo - no se escribirán archivos\n');
+    }
+    const scanSpinner = ora('🔍 Resolviendo provider...').start();
+    const resolved = await resolveProvider();
+    const apiKey = options.apiKey || getApiKeyForProvider(resolved.provider);
+    scanSpinner.succeed(`Provider: ${resolved.provider} | Model: ${resolved.model}`);
+    const ai = createAIClient({
+        provider: resolved.provider,
+        apiKey,
+        baseUrl: resolved.baseUrl,
+        model: resolved.model,
+        verbose,
+    });
+    if (!ai) {
+        printDetectionResult(null, verbose);
+        process.exit(1);
+    }
+    if (verbose) {
+        console.log(`[INFO] Provider: ${resolved.provider}`);
+        console.log(`[INFO] Modelo: ${resolved.model}`);
+        console.log(`[INFO] Max chars: ${maxChars}`);
+        console.log(`[INFO] Modo: ${splitMode ? 'split (archivo por archivo)' : 'single (DOCS.md único)'}`);
+    }
+    const extensions = options.extensions
+        ? options.extensions.split(',').map((e) => e.trim())
+        : rcConfig?.extensions;
+    const filesSpinner = ora('🔍 Escaneando archivos...').start();
+    const files = collectFiles(options.path, verbose, extensions);
+    if (files.length === 0) {
+        filesSpinner.warn('No se encontraron archivos soportados para procesar.');
+        process.exit(0);
+    }
+    filesSpinner.succeed(`Encontrados ${files.length} archivo(s) para procesar.`);
+    const projectRoot = process.cwd();
+    const cache = loadCache(projectRoot);
+    let cacheHits = 0;
+    const docEntries = [];
+    let succeeded = 0;
+    let failed = 0;
+    let skipped = 0;
+    for (let i = 0; i < files.length; i++) {
+        const filePath = files[i];
+        const relativePath = path.relative(projectRoot, filePath);
+        const fileSpinner = ora({ text: `[${i + 1}/${files.length}] ${relativePath}`, spinner: 'dots' }).start();
+        try {
+            const fileData = readFile(filePath);
+            if (!fileData || shouldSkipContent(fileData.content)) {
+                fileSpinner.warn(`Saltado (archivo vacío o no procesable)`);
+                skipped++;
+                continue;
+            }
+            const currentHash = computeFileHash(filePath);
+            if (isFileCached(filePath, cache, currentHash)) {
+                const cachedEntry = cache[filePath];
+                fileSpinner.info(`[${i + 1}/${files.length}] ${relativePath} → Cache hit`);
+                if (splitMode) {
+                    if (cachedEntry?.docPath) {
+                        succeeded++;
+                        cacheHits++;
+                    }
+                }
+                else if (cachedEntry?.content) {
+                    docEntries.push({
+                        relativePath,
+                        filePath,
+                        content: cachedEntry.content,
+                        summary: cachedEntry.content.split('\n').slice(0, 3).join(' ').replace(/\/\*[\s\S]*?\*\//, '').trim().slice(0, 200),
+                    });
+                    succeeded++;
+                    cacheHits++;
+                }
+                continue;
+            }
+            if (verbose) {
+                fileSpinner.text = `[${i + 1}/${files.length}] ${relativePath} - Generando documentación...`;
+            }
+            const docRaw = await generateDocumentation(ai, filePath, fileData.content, verbose, resolved.model, maxChars);
+            if (docRaw) {
+                const docContent = extractDocContent(docRaw);
+                if (dryRun) {
+                    const preview = docContent.split('\n').slice(0, 5).join('\n');
+                    fileSpinner.succeed(`[${i + 1}/${files.length}] ${relativePath} → [DRY-RUN] Preview:\n    ${preview.replace(/\n/g, '\n    ')}`);
+                    succeeded++;
+                }
+                else {
+                    if (splitMode) {
+                        const outputDir = mergeConfig(options.output ? path.resolve(options.output) : undefined, rcConfig?.output, undefined);
+                        const docFilePath = writeDocFile(filePath, docContent, outputDir);
+                        if (docFilePath) {
+                            const docRelative = path.relative(projectRoot, docFilePath);
+                            fileSpinner.succeed(`[${i + 1}/${files.length}] ${relativePath} → ${docRelative}`);
+                            updateCache(filePath, docFilePath, currentHash, cache);
+                            succeeded++;
+                        }
+                        else {
+                            fileSpinner.fail(`[${i + 1}/${files.length}] ${relativePath} - Error al escribir doc`);
+                            failed++;
+                        }
+                    }
+                    else {
+                        fileSpinner.succeed(`[${i + 1}/${files.length}] ${relativePath} → [DOC]`);
+                        docEntries.push({
+                            relativePath,
+                            filePath,
+                            content: docContent,
+                            summary: docContent.split('\n').slice(0, 3).join(' ').replace(/\/\*[\s\S]*?\*\//, '').trim().slice(0, 200),
+                        });
+                        updateCache(filePath, '', currentHash, cache, docContent);
+                        succeeded++;
+                    }
+                }
+            }
+            else {
+                fileSpinner.fail(`[${i + 1}/${files.length}] ${relativePath} - No se pudo generar documentación`);
+                failed++;
+            }
+        }
+        catch (err) {
+            const error = err;
+            fileSpinner.fail(`[${i + 1}/${files.length}] ${relativePath} - Error inesperado`);
+            if (verbose) {
+                console.error(`    ${error.message}`);
+            }
+            failed++;
+        }
+    }
+    if (!dryRun && !splitMode && docEntries.length > 0) {
+        const format = mergeConfig(options.format, rcConfig?.format, 'markdown');
+        const targetDir = resolveTargetDir(options.path, options.output);
+        if (format === 'html') {
+            const writeSpinner = ora('📄 Escribiendo DOCS.html...').start();
+            const htmlPath = path.join(targetDir, 'DOCS.html');
+            const content = buildSingleDocContent(docEntries);
+            const html = generateHtmlFromContent(content, 'Documentación del Proyecto', 'Agent Doc Generator');
+            fs.writeFileSync(htmlPath, html, 'utf-8');
+            writeSpinner.succeed(`Documentación HTML generada: ${path.relative(projectRoot, htmlPath)}`);
+        }
+        else if (format === 'pdf') {
+            const writeSpinner = ora('📄 Escribiendo DOCS.pdf...').start();
+            const pdfPath = path.join(targetDir, 'DOCS.pdf');
+            const content = buildSingleDocContent(docEntries);
+            await generatePdfFromContent(content, pdfPath, 'Documentación del Proyecto', 'Agent Doc Generator');
+            writeSpinner.succeed(`Documentación PDF generada: ${path.relative(projectRoot, pdfPath)}`);
+        }
+        else {
+            const writeSpinner = ora('📄 Escribiendo DOCS.md...').start();
+            const docPath = writeSingleDocFile(targetDir, docEntries);
+            if (docPath) {
+                const docRelative = path.relative(projectRoot, docPath);
+                writeSpinner.succeed(`Documentación generada: ${docRelative}`);
+            }
+            else {
+                writeSpinner.fail('Error al escribir DOCS.md');
+            }
+        }
+    }
+    if (!dryRun) {
+        saveCache(projectRoot, cache);
+    }
+    console.log('\n=== Resumen ===');
+    console.log(`  Total:    ${files.length}`);
+    console.log(`  ✅ OK:    ${succeeded}`);
+    console.log(`  ⚠️  Skip:   ${skipped}`);
+    console.log(`  ❌ Error:  ${failed}`);
+    if (cacheHits > 0) {
+        console.log(`  💾 Cache:  ${cacheHits}`);
+    }
+    console.log('');
+    if (failed > 0) {
+        process.exit(1);
+    }
+}
+main().catch((err) => {
+    const error = err;
+    console.error(`[FATAL] Error inesperado: ${error.message}`);
+    process.exit(1);
+});
+function resolveTargetDir(targetPath, output) {
+    const resolvedOutput = output ?? rcConfig?.output;
+    if (resolvedOutput)
+        return path.resolve(resolvedOutput);
+    const resolved = path.resolve(targetPath);
+    try {
+        return fs.statSync(resolved).isDirectory() ? resolved : path.dirname(resolved);
+    }
+    catch {
+        return resolved;
+    }
+}
+function buildSingleDocContent(entries) {
+    const lines = ['# Documentación del Proyecto', '', `Generado: ${new Date().toLocaleDateString('es-AR')}`, '', '---', ''];
+    for (const entry of entries) {
+        lines.push(`## ${entry.relativePath}`, '');
+        lines.push(entry.content);
+        lines.push('');
+        lines.push('---', '');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}

package/dist/src/aiClient.d.ts

@@ -0,0 +1,38 @@
+export interface AIClient {
+    generate(prompt: string, model: string): Promise<string | null>;
+}
+export interface CreateAIClientOptions {
+    provider?: string;
+    apiKey?: string;
+    baseUrl?: string;
+    model?: string;
+    verbose?: boolean;
+}
+export declare class GeminiClient implements AIClient {
+    private ai;
+    constructor(apiKey: string);
+    generate(prompt: string, model: string): Promise<string | null>;
+}
+export declare class OpenAIClient implements AIClient {
+    private apiKey;
+    constructor(apiKey: string);
+    generate(prompt: string, model: string): Promise<string | null>;
+}
+export declare class AnthropicClient implements AIClient {
+    private apiKey;
+    constructor(apiKey: string);
+    generate(prompt: string, model: string): Promise<string | null>;
+}
+export declare class DeepSeekClient implements AIClient {
+    private apiKey;
+    constructor(apiKey: string);
+    generate(prompt: string, model: string): Promise<string | null>;
+}
+export declare class OllamaClient implements AIClient {
+    private baseUrl;
+    private apiKey?;
+    constructor(baseUrl: string, apiKey?: string);
+    generate(prompt: string, model: string): Promise<string | null>;
+}
+export declare function createAIClient(options?: CreateAIClientOptions): AIClient | null;
+//# sourceMappingURL=aiClient.d.ts.map

package/dist/src/aiClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiClient.d.ts","sourceRoot":"","sources":["../../src/aiClient.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAKD,qBAAa,YAAa,YAAW,QAAQ;IAC3C,OAAO,CAAC,EAAE,CAAc;gBAEZ,MAAM,EAAE,MAAM;IAIpB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAItE;AAED,qBAAa,YAAa,YAAW,QAAQ;IAC3C,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;IAIpB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAwBtE;AAED,qBAAa,eAAgB,YAAW,QAAQ;IAC9C,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;IAIpB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAyBtE;AAED,qBAAa,cAAe,YAAW,QAAQ;IAC7C,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;IAIpB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAwBtE;AAED,qBAAa,YAAa,YAAW,QAAQ;IAC3C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAC,CAAS;gBAEZ,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAKtC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAyBtE;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,QAAQ,GAAG,IAAI,CA8DnF"}

package/dist/src/aiClient.js

@@ -0,0 +1,180 @@
+import { GoogleGenAI } from '@google/genai';
+const PLACEHOLDER_KEY = 'your_gemini_api_key_here';
+const DEFAULT_LOCAL_BASE_URL = 'http://localhost:11434';
+export class GeminiClient {
+    ai;
+    constructor(apiKey) {
+        this.ai = new GoogleGenAI({ apiKey });
+    }
+    async generate(prompt, model) {
+        const result = await this.ai.models.generateContent({ model, contents: prompt });
+        return result.text ?? null;
+    }
+}
+export class OpenAIClient {
+    apiKey;
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+    }
+    async generate(prompt, model) {
+        const res = await fetch('https://api.openai.com/v1/chat/completions', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({
+                model,
+                messages: [{ role: 'user', content: prompt }],
+                stream: false,
+            }),
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => '');
+            throw new Error(`OpenAI API error ${res.status}: ${body}`);
+        }
+        const data = (await res.json());
+        return data?.choices?.[0]?.message?.content ?? null;
+    }
+}
+export class AnthropicClient {
+    apiKey;
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+    }
+    async generate(prompt, model) {
+        const res = await fetch('https://api.anthropic.com/v1/messages', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-api-key': this.apiKey,
+                'anthropic-version': '2023-06-01',
+            },
+            body: JSON.stringify({
+                model,
+                messages: [{ role: 'user', content: prompt }],
+                max_tokens: 8096,
+            }),
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => '');
+            throw new Error(`Anthropic API error ${res.status}: ${body}`);
+        }
+        const data = (await res.json());
+        return data?.content?.[0]?.text ?? null;
+    }
+}
+export class DeepSeekClient {
+    apiKey;
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+    }
+    async generate(prompt, model) {
+        const res = await fetch('https://api.deepseek.com/v1/chat/completions', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({
+                model,
+                messages: [{ role: 'user', content: prompt }],
+                stream: false,
+            }),
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => '');
+            throw new Error(`DeepSeek API error ${res.status}: ${body}`);
+        }
+        const data = (await res.json());
+        return data?.choices?.[0]?.message?.content ?? null;
+    }
+}
+export class OllamaClient {
+    baseUrl;
+    apiKey;
+    constructor(baseUrl, apiKey) {
+        this.baseUrl = baseUrl.replace(/\/+$/, '');
+        this.apiKey = apiKey;
+    }
+    async generate(prompt, model) {
+        const url = `${this.baseUrl}/api/chat`;
+        const headers = { 'Content-Type': 'application/json' };
+        if (this.apiKey)
+            headers['Authorization'] = `Bearer ${this.apiKey}`;
+        const res = await fetch(url, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify({
+                model,
+                messages: [{ role: 'user', content: prompt }],
+                stream: false,
+            }),
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => '');
+            throw new Error(`Ollama API error ${res.status}: ${body}`);
+        }
+        const data = (await res.json());
+        return data?.message?.content ?? null;
+    }
+}
+export function createAIClient(options = {}) {
+    const provider = options.provider ?? 'gemini';
+    switch (provider) {
+        case 'gemini': {
+            const apiKey = options.apiKey;
+            if (!apiKey || apiKey === PLACEHOLDER_KEY) {
+                console.error('[ERROR] GEMINI_API_KEY is not set or is invalid.');
+                console.error('  Create a .env file with: GEMINI_API_KEY=your_key');
+                console.error('  Get key at: https://aistudio.google.com/apikey');
+                console.error('  Or use: --provider openai | anthropic | deepseek | ollama');
+                return null;
+            }
+            try {
+                return new GeminiClient(apiKey);
+            }
+            catch (err) {
+                const error = err;
+                console.error(`[ERROR] Failed to initialize Gemini client: ${error.message}`);
+                return null;
+            }
+        }
+        case 'openai': {
+            const apiKey = options.apiKey;
+            if (!apiKey) {
+                console.error('[ERROR] OPENAI_API_KEY is not set.');
+                console.error('  Create a .env file with: OPENAI_API_KEY=sk-...');
+                return null;
+            }
+            return new OpenAIClient(apiKey);
+        }
+        case 'anthropic': {
+            const apiKey = options.apiKey;
+            if (!apiKey) {
+                console.error('[ERROR] ANTHROPIC_API_KEY is not set.');
+                console.error('  Create a .env file with: ANTHROPIC_API_KEY=sk-ant-...');
+                return null;
+            }
+            return new AnthropicClient(apiKey);
+        }
+        case 'deepseek': {
+            const apiKey = options.apiKey;
+            if (!apiKey) {
+                console.error('[ERROR] DEEPSEEK_API_KEY is not set.');
+                console.error('  Create a .env file with: DEEPSEEK_API_KEY=sk-...');
+                return null;
+            }
+            return new DeepSeekClient(apiKey);
+        }
+        case 'ollama': {
+            const baseUrl = options.baseUrl ?? DEFAULT_LOCAL_BASE_URL;
+            return new OllamaClient(baseUrl, options.apiKey);
+        }
+        default:
+            console.error(`[ERROR] Unknown provider: "${provider}"`);
+            console.error('  Valid providers: gemini, openai, anthropic, deepseek, ollama');
+            return null;
+    }
+}
+//# sourceMappingURL=aiClient.js.map

package/dist/src/aiClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiClient.js","sourceRoot":"","sources":["../../src/aiClient.ts"],"names":[],"mappings":"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"}