nduka 1.0.0

package/dist/llm/audit.js

@@ -0,0 +1,281 @@
+/**
+ * Missing Areas 1-10 from next_step_d.md
+ *
+ * Tool Calling, Structured Output, Context Window, Token Accounting,
+ * Rate Limiting, Multi-Modal, WhatsApp Edge Features, Disaster Recovery,
+ * Database Scaling, Observability
+ */
+import { createHash } from 'node:crypto';
+// ─── Missing Area #1: Tool Calling Validation ────────────────────────────────
+export function validateToolCall(toolCall) {
+    const issues = [];
+    if (!toolCall.name)
+        issues.push('missing name');
+    if (!toolCall.arguments)
+        issues.push('missing arguments');
+    return {
+        id: 'MA1-TOOL-001',
+        area: 'Tool Calling',
+        description: 'Valid tool call structure validation',
+        severity: 'P0',
+        status: issues.length === 0 ? 'pass' : 'fail',
+        details: issues.length > 0 ? issues.join(', ') : 'Valid tool call',
+    };
+}
+export function validateToolExecution(result) {
+    return {
+        id: 'MA1-TOOL-002',
+        area: 'Tool Calling',
+        description: 'Tool execution result injection safety',
+        severity: 'P0',
+        status: result !== undefined ? 'pass' : 'fail',
+        details: 'Tool result must be defined before injection into memory',
+    };
+}
+// ─── Missing Area #2: Structured Output Validation ──────────────────────────
+export function validateStructuredOutput(raw, schema) {
+    try {
+        const parsed = JSON.parse(raw);
+        const missing = Object.keys(schema).filter((k) => !(k in parsed));
+        const extra = Object.keys(parsed).filter((k) => !(k in schema));
+        return {
+            id: 'MA2-STRUCT-001',
+            area: 'Structured Output',
+            description: 'JSON schema adherence validation',
+            severity: 'P0',
+            status: missing.length === 0 ? 'pass' : 'fail',
+            details: missing.length > 0
+                ? `Missing fields: ${missing.join(', ')}`
+                : extra.length > 0
+                    ? `Extra fields (accepted): ${extra.join(', ')}`
+                    : 'Schema valid',
+            remediation: missing.length > 0 ? 'Repair or request retry' : undefined,
+        };
+    }
+    catch {
+        return {
+            id: 'MA2-STRUCT-001',
+            area: 'Structured Output',
+            description: 'JSON parse failure recovery',
+            severity: 'P0',
+            status: 'fail',
+            details: 'Invalid JSON — must attempt repair or fallback',
+            remediation: 'Apply JSON repair strategy or retry with stricter prompt',
+        };
+    }
+}
+// ─── Missing Area #3: Context Window Exhaustion ─────────────────────────────
+export function validateContextWindow(messageCount, totalTokens, providerLimit) {
+    const exceeded = totalTokens > providerLimit * 0.9; // 90% threshold
+    return {
+        id: 'MA3-CTX-001',
+        area: 'Context Window',
+        description: `Context window limit check (${messageCount} msgs, ${totalTokens}/${providerLimit} tokens)`,
+        severity: 'P0',
+        status: exceeded ? 'fail' : 'pass',
+        details: exceeded
+            ? `Oversized context: ${totalTokens}/${providerLimit} tokens`
+            : `Context within limits: ${totalTokens}/${providerLimit} tokens`,
+        remediation: exceeded ? 'Trim oldest messages or summarize' : undefined,
+    };
+}
+export function validateTokenAccounting(providerReported, systemRecorded) {
+    const mismatch = providerReported.inputTokens !== systemRecorded.inputTokens ||
+        providerReported.outputTokens !== systemRecorded.outputTokens;
+    return {
+        id: 'MA4-TOKEN-001',
+        area: 'Token Accounting',
+        description: 'Provider-reported vs system-recorded token match',
+        severity: 'P1',
+        status: mismatch ? 'fail' : 'pass',
+        details: mismatch
+            ? `Mismatch: provider=${providerReported.inputTokens}/${providerReported.outputTokens}, system=${systemRecorded.inputTokens}/${systemRecorded.outputTokens}`
+            : 'Tokens match between provider and system',
+    };
+}
+// ─── Missing Area #5: Rate Limiting Storms ───────────────────────────────────
+export class AccountRateLimiter {
+    userCounters = new Map();
+    tenantCounters = new Map();
+    maxPerUserPerMin;
+    maxPerTenantPerMin;
+    constructor(maxPerUserPerMin = 10, maxPerTenantPerMin = 100) {
+        this.maxPerUserPerMin = maxPerUserPerMin;
+        this.maxPerTenantPerMin = maxPerTenantPerMin;
+    }
+    checkRateLimit(userId, tenantId) {
+        const now = Date.now();
+        const windowMs = 60_000;
+        // Per-user check
+        let userCounter = this.userCounters.get(userId);
+        if (!userCounter || now - userCounter.windowStart > windowMs) {
+            userCounter = { count: 0, windowStart: now };
+            this.userCounters.set(userId, userCounter);
+        }
+        userCounter.count++;
+        // Per-tenant check
+        let tenantCounter = this.tenantCounters.get(tenantId);
+        if (!tenantCounter || now - tenantCounter.windowStart > windowMs) {
+            tenantCounter = { count: 0, windowStart: now };
+            this.tenantCounters.set(tenantId, tenantCounter);
+        }
+        tenantCounter.count++;
+        const userExceeded = userCounter.count > this.maxPerUserPerMin;
+        const tenantExceeded = tenantCounter.count > this.maxPerTenantPerMin;
+        return {
+            id: 'MA5-RATE-001',
+            area: 'Rate Limiting',
+            description: `Rate check: user=${userId}, tenant=${tenantId}`,
+            severity: 'P0',
+            status: userExceeded || tenantExceeded ? 'fail' : 'pass',
+            details: userExceeded
+                ? `User rate exceeded (${userCounter.count}/${this.maxPerUserPerMin})`
+                : tenantExceeded
+                    ? `Tenant rate exceeded (${tenantCounter.count}/${this.maxPerTenantPerMin})`
+                    : `OK: user=${userCounter.count}, tenant=${tenantCounter.count}`,
+        };
+    }
+}
+export function validateMultiModalInput(content, attachments) {
+    const issues = [];
+    if (attachments.length > 20) {
+        issues.push(`Too many attachments (${attachments.length} > 20)`);
+    }
+    for (const att of attachments) {
+        if (att.sizeBytes > 100 * 1024 * 1024) {
+            issues.push(`${att.type} exceeds 100MB: ${att.sizeBytes} bytes`);
+        }
+        if (!att.mimeType.includes('/')) {
+            issues.push(`Invalid MIME type for ${att.type}: ${att.mimeType}`);
+        }
+    }
+    return {
+        id: 'MA6-MULTI-001',
+        area: 'Multi-Modal',
+        description: `Multi-modal validation: ${attachments.length} attachments`,
+        severity: 'P0',
+        status: issues.length === 0 ? 'pass' : 'fail',
+        details: issues.length > 0 ? issues.join('; ') : 'All attachments valid',
+    };
+}
+// ─── Missing Area #7: WhatsApp Edge Features ────────────────────────────────
+export const WHATSAPP_EDGE_FEATURES = [
+    'polls', 'poll_updates', 'disappearing_messages', 'archived_chats',
+    'muted_chats', 'community_groups', 'linked_devices', 'broadcast_lists',
+    'newsletters', 'business_accounts', 'payment_messages', 'catalog_messages',
+    'order_messages', 'template_messages', 'interactive_messages',
+];
+export function detectWhatsAppEdgeFeature(eventType) {
+    const isEdgeFeature = WHATSAPP_EDGE_FEATURES.some((f) => eventType.toLowerCase().includes(f));
+    return {
+        id: 'MA7-EDGE-001',
+        area: 'WhatsApp Edge Features',
+        description: `Edge feature detection: ${eventType}`,
+        severity: isEdgeFeature ? 'P0' : 'P2',
+        status: 'pass',
+        details: isEdgeFeature
+            ? `Edge feature "${eventType}" detected — must be explicitly handled`
+            : `Standard event: ${eventType}`,
+        remediation: isEdgeFeature ? `Add explicit handler for ${eventType}` : undefined,
+    };
+}
+export function validateRestorePoint(checkpoint, currentState) {
+    const hashMatch = checkpoint.hash === currentState.hash;
+    const sizeDrift = Math.abs(checkpoint.sizeBytes - currentState.sizeBytes);
+    return {
+        id: 'MA8-DR-001',
+        area: 'Disaster Recovery',
+        description: `Restore validation for ${checkpoint.type}`,
+        severity: 'P0',
+        status: hashMatch ? 'pass' : 'fail',
+        details: hashMatch
+            ? `Restore valid: hash matches, size drift=${sizeDrift} bytes`
+            : `Restore FAILED: hash mismatch`,
+        remediation: !hashMatch ? 'Re-run restore from earlier checkpoint' : undefined,
+    };
+}
+// ─── Missing Area #9: Database Scaling ──────────────────────────────────────
+export function validateDatabaseScaling(rowCount, queryLatencyMs, targetLatencyMs) {
+    const withinBudget = queryLatencyMs <= targetLatencyMs;
+    return {
+        id: 'MA9-DB-001',
+        area: 'Database Scaling',
+        description: `Scale check: ${rowCount.toLocaleString()} rows, ${queryLatencyMs}ms query`,
+        severity: 'P0',
+        status: withinBudget ? 'pass' : 'fail',
+        details: withinBudget
+            ? `Query latency OK: ${queryLatencyMs}ms ≤ ${targetLatencyMs}ms`
+            : `Query too slow: ${queryLatencyMs}ms > ${targetLatencyMs}ms with ${rowCount.toLocaleString()} rows`,
+        remediation: !withinBudget ? 'Add index or partition table' : undefined,
+    };
+}
+// ─── Missing Area #10: Observability Completeness ───────────────────────────
+export const REQUIRED_METRICS = [
+    'message_throughput', 'provider_throughput', 'provider_failures',
+    'queue_depth', 'token_usage', 'cost_by_provider', 'reconnect_count',
+    'duplicate_detection', 'media_failures', 'ai_failures',
+    'session_health', 'listener_count', 'heap_used_mb', 'event_lag_ms',
+];
+export function validateObservability(availableMetrics) {
+    const missing = REQUIRED_METRICS.filter((m) => !availableMetrics.includes(m));
+    const coverage = ((REQUIRED_METRICS.length - missing.length) / REQUIRED_METRICS.length) * 100;
+    return {
+        id: 'MA10-OBS-001',
+        area: 'Observability',
+        description: `Metrics coverage: ${coverage.toFixed(0)}%`,
+        severity: coverage < 80 ? 'P0' : coverage < 95 ? 'P1' : 'P2',
+        status: coverage >= 80 ? 'pass' : 'fail',
+        details: missing.length > 0
+            ? `Missing metrics: ${missing.join(', ')}`
+            : 'All required metrics available',
+        remediation: missing.length > 0 ? `Add: ${missing.join(', ')}` : undefined,
+    };
+}
+// ─── Full Audit Report ───────────────────────────────────────────────────────
+export function runFullAudit() {
+    const findings = [];
+    // MA1: Tool Calling
+    findings.push(validateToolCall({ name: 'get_weather', arguments: { city: 'London' } }));
+    findings.push(validateToolCall({}));
+    findings.push(validateToolExecution('success'));
+    // MA2: Structured Output
+    findings.push(validateStructuredOutput('{"name":"John","age":30}', { name: 'string', age: 'number' }));
+    findings.push(validateStructuredOutput('invalid json', {}));
+    // MA3: Context Window
+    findings.push(validateContextWindow(100, 8000, 128000));
+    findings.push(validateContextWindow(5000, 130000, 128000));
+    // MA4: Token Accounting
+    findings.push(validateTokenAccounting({ inputTokens: 100, outputTokens: 50, cachedTokens: 0, reasoningTokens: 0, totalCost: 0.001, provider: 'openrouter', model: 'test', timestamp: Date.now() }, { inputTokens: 100, outputTokens: 50, cachedTokens: 0, reasoningTokens: 0, totalCost: 0.001, provider: 'openrouter', model: 'test', timestamp: Date.now() }));
+    // MA5: Rate Limiting
+    const rateLimiter = new AccountRateLimiter(10, 100);
+    findings.push(rateLimiter.checkRateLimit('user1', 'tenant1'));
+    // MA6: Multi-Modal
+    findings.push(validateMultiModalInput('What is in this image?', [
+        { type: 'image', mimeType: 'image/jpeg', sizeBytes: 50000 },
+        { type: 'pdf', mimeType: 'application/pdf', sizeBytes: 2000000 },
+    ]));
+    // MA7: Edge Features
+    findings.push(detectWhatsAppEdgeFeature('message.upsert'));
+    findings.push(detectWhatsAppEdgeFeature('poll_update'));
+    findings.push(detectWhatsAppEdgeFeature('newsletter_update'));
+    // MA8: Disaster Recovery
+    const checkpointHash = createHash('sha256').update('checkpoint').digest('hex');
+    findings.push(validateRestorePoint({ id: 'cp1', type: 'sessions', timestamp: Date.now(), hash: checkpointHash, sizeBytes: 1024 }, { hash: checkpointHash, sizeBytes: 1024 }));
+    // MA9: Database Scaling
+    findings.push(validateDatabaseScaling(1000000, 15, 50));
+    findings.push(validateDatabaseScaling(100000000, 500, 50));
+    // MA10: Observability
+    findings.push(validateObservability([
+        'message_throughput', 'provider_throughput', 'queue_depth', 'token_usage',
+        'cost_by_provider', 'reconnect_count', 'session_health', 'heap_used_mb',
+        'event_lag_ms', 'duplicate_detection', 'media_failures', 'ai_failures',
+    ]));
+    // Summary
+    const p0 = findings.filter((f) => f.severity === 'P0').length;
+    const p1 = findings.filter((f) => f.severity === 'P1').length;
+    const p2 = findings.filter((f) => f.severity === 'P2').length;
+    const pass = findings.filter((f) => f.status === 'pass').length;
+    const fail = findings.filter((f) => f.status === 'fail').length;
+    return { findings, summary: { p0, p1, p2, pass, fail } };
+}
+//# sourceMappingURL=audit.js.map

package/dist/llm/audit.js.map

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

package/dist/llm/base-provider.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Abstract LLM Provider
+ *
+ * Base class implementing common patterns: retry, timeout, streaming,
+ * tool calling, structured output. Provider implementations override
+ * the provider-specific serialization.
+ */
+import type { LLMRequest, LLMResponse, StreamChunk, ProviderConfig, ProviderHealth, ProviderCapabilities, Message } from './types.js';
+import { LLMError } from './types.js';
+export declare abstract class BaseLLMProvider {
+    protected config: ProviderConfig;
+    protected health: ProviderHealth;
+    protected capabilities: ProviderCapabilities;
+    constructor(config: ProviderConfig, capabilities: ProviderCapabilities);
+    /** Get provider name */
+    get name(): string;
+    /** Get current health status */
+    getHealth(): ProviderHealth;
+    /** Check if provider is healthy */
+    isHealthy(): boolean;
+    /** Get capabilities */
+    getCapabilities(): ProviderCapabilities;
+    /**
+     * Send a completion request with retry, timeout, and error handling.
+     */
+    complete(request: LLMRequest): Promise<LLMResponse>;
+    /**
+     * Stream a completion response.
+     */
+    stream(request: LLMRequest): AsyncGenerator<StreamChunk>;
+    /** Build the provider-specific HTTP request. */
+    protected abstract makeRequest(request: LLMRequest, startTime: number): Promise<LLMResponse>;
+    /** Build the provider-specific streaming request. */
+    protected abstract makeStreamRequest(request: LLMRequest, timeoutMs: number): AsyncGenerator<StreamChunk>;
+    /** Convert unified Message[] to provider-specific format. */
+    protected abstract serializeMessages(messages: Message[]): unknown;
+    /** Convert provider-specific response to unified LLMResponse. */
+    protected abstract deserializeResponse(raw: unknown, startTime: number): LLMResponse;
+    protected withTimeout<T>(promise: Promise<T>, timeoutMs: number): Promise<T>;
+    protected recordSuccess(latencyMs: number): void;
+    protected recordFailure(): void;
+    protected isNonRetryable(error: Error): boolean;
+    protected normalizeError(error: Error): LLMError;
+    protected delay(ms: number): Promise<void>;
+}
+//# sourceMappingURL=base-provider.d.ts.map

package/dist/llm/base-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-provider.d.ts","sourceRoot":"","sources":["../../src/llm/base-provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,OAAO,EACR,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,QAAQ,EAKT,MAAM,YAAY,CAAC;AAIpB,8BAAsB,eAAe;IACnC,SAAS,CAAC,MAAM,EAAE,cAAc,CAAC;IACjC,SAAS,CAAC,MAAM,EAAE,cAAc,CAAC;IACjC,SAAS,CAAC,YAAY,EAAE,oBAAoB,CAAC;gBAEjC,MAAM,EAAE,cAAc,EAAE,YAAY,EAAE,oBAAoB;IAgBtE,wBAAwB;IACxB,IAAI,IAAI,IAAI,MAAM,CAA6B;IAE/C,gCAAgC;IAChC,SAAS,IAAI,cAAc;IAE3B,mCAAmC;IACnC,SAAS,IAAI,OAAO;IAEpB,uBAAuB;IACvB,eAAe,IAAI,oBAAoB;IAIvC;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAkCzD;;OAEG;IACI,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,cAAc,CAAC,WAAW,CAAC;IAoC/D,gDAAgD;IAChD,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAE5F,qDAAqD;IACrD,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAClC,OAAO,EAAE,UAAU,EACnB,SAAS,EAAE,MAAM,GAChB,cAAc,CAAC,WAAW,CAAC;IAE9B,6DAA6D;IAC7D,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO;IAElE,iEAAiE;IACjE,SAAS,CAAC,QAAQ,CAAC,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW;cAIpE,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAYlF,SAAS,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAahD,SAAS,CAAC,aAAa,IAAI,IAAI;IAgB/B,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAO/C,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ;IAoBhD,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG3C"}

package/dist/llm/base-provider.js

@@ -0,0 +1,158 @@
+import { LLMError, ProviderUnavailableError, RateLimitError, InsufficientCreditsError, TimeoutError, } from './types.js';
+// ─── Abstract Provider ───────────────────────────────────────────────────────
+export class BaseLLMProvider {
+    config;
+    health;
+    capabilities;
+    constructor(config, capabilities) {
+        this.config = config;
+        this.capabilities = capabilities;
+        this.health = {
+            provider: config.name,
+            healthy: true,
+            lastCheck: new Date(),
+            latencyMs: 0,
+            errorRate: 0,
+            consecutiveFailures: 0,
+            consecutiveSuccesses: 0,
+            totalRequests: 0,
+            totalFailures: 0,
+        };
+    }
+    /** Get provider name */
+    get name() { return this.config.name; }
+    /** Get current health status */
+    getHealth() { return { ...this.health }; }
+    /** Check if provider is healthy */
+    isHealthy() { return this.health.healthy; }
+    /** Get capabilities */
+    getCapabilities() { return { ...this.capabilities }; }
+    // ─── Core API ────────────────────────────────────────────────────────────
+    /**
+     * Send a completion request with retry, timeout, and error handling.
+     */
+    async complete(request) {
+        const startTime = Date.now();
+        let lastError = null;
+        for (let attempt = 0; attempt < this.config.maxRetries; attempt++) {
+            try {
+                const timeoutMs = request.timeoutMs || this.config.timeoutMs;
+                const response = await this.withTimeout(this.makeRequest(request, startTime), timeoutMs);
+                // Success — update health
+                this.recordSuccess(response.latencyMs);
+                return response;
+            }
+            catch (err) {
+                lastError = err;
+                if (this.isNonRetryable(err)) {
+                    this.recordFailure();
+                    throw this.normalizeError(err);
+                }
+                if (attempt < this.config.maxRetries - 1) {
+                    const delay = this.config.retryDelayMs * Math.pow(2, attempt);
+                    await this.delay(delay);
+                }
+            }
+        }
+        this.recordFailure();
+        throw this.normalizeError(lastError || new Error('Unknown error'));
+    }
+    /**
+     * Stream a completion response.
+     */
+    async *stream(request) {
+        if (!this.capabilities.supportsStreaming) {
+            // Fallback: non-streaming, yield complete response as single chunk
+            const response = await this.complete(request);
+            yield { content: response.content || '', toolCalls: [], finishReason: 'stop' };
+            return;
+        }
+        const startTime = Date.now();
+        for (let attempt = 0; attempt < this.config.maxRetries; attempt++) {
+            try {
+                const timeoutMs = request.timeoutMs || this.config.timeoutMs;
+                let streamed = false;
+                for await (const chunk of this.makeStreamRequest(request, timeoutMs)) {
+                    streamed = true;
+                    yield chunk;
+                }
+                if (streamed) {
+                    this.recordSuccess(Date.now() - startTime);
+                    return;
+                }
+            }
+            catch (err) {
+                if (this.isNonRetryable(err) || attempt >= this.config.maxRetries - 1) {
+                    this.recordFailure();
+                    throw this.normalizeError(err);
+                }
+                const delay = this.config.retryDelayMs * Math.pow(2, attempt);
+                await this.delay(delay);
+            }
+        }
+    }
+    // ─── Helpers ─────────────────────────────────────────────────────────────
+    async withTimeout(promise, timeoutMs) {
+        return Promise.race([
+            promise,
+            new Promise((_, reject) => setTimeout(() => reject(new TimeoutError(this.config.name, timeoutMs)), timeoutMs)),
+        ]);
+    }
+    recordSuccess(latencyMs) {
+        this.health.healthy = true;
+        this.health.latencyMs = latencyMs;
+        this.health.lastCheck = new Date();
+        this.health.consecutiveSuccesses++;
+        this.health.consecutiveFailures = 0;
+        this.health.totalRequests++;
+        this.health.errorRate =
+            this.health.totalRequests > 0
+                ? this.health.totalFailures / this.health.totalRequests
+                : 0;
+    }
+    recordFailure() {
+        this.health.consecutiveFailures++;
+        this.health.consecutiveSuccesses = 0;
+        this.health.totalRequests++;
+        this.health.totalFailures++;
+        this.health.errorRate =
+            this.health.totalRequests > 0
+                ? this.health.totalFailures / this.health.totalRequests
+                : 0;
+        // Circuit breaker: mark unhealthy after threshold failures
+        if (this.health.consecutiveFailures >= 3) {
+            this.health.healthy = false;
+        }
+    }
+    isNonRetryable(error) {
+        if (error instanceof InsufficientCreditsError)
+            return true;
+        if (error instanceof LLMError && error.statusCode === 401)
+            return true;
+        if (error instanceof LLMError && error.statusCode === 403)
+            return true;
+        return false;
+    }
+    normalizeError(error) {
+        if (error instanceof LLMError)
+            return error;
+        const msg = error.message.toLowerCase();
+        if (msg.includes('429') || msg.includes('rate limit') || msg.includes('too many')) {
+            return new RateLimitError(this.config.name);
+        }
+        if (msg.includes('402') || msg.includes('insufficient') || msg.includes('credit') || msg.includes('quota')) {
+            return new InsufficientCreditsError(this.config.name);
+        }
+        if (msg.includes('502') || msg.includes('503') || msg.includes('unavailable') || msg.includes('overloaded')) {
+            return new ProviderUnavailableError(this.config.name, 503);
+        }
+        if (msg.includes('timeout') || msg.includes('timed out')) {
+            return new TimeoutError(this.config.name, this.config.timeoutMs);
+        }
+        return new LLMError(error.message, this.config.name);
+    }
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=base-provider.js.map

package/dist/llm/base-provider.js.map

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

package/dist/llm/config.d.ts

@@ -0,0 +1,32 @@
+import type { ProviderConfig, ProviderName, RouterConfig } from './types.js';
+export declare function isProviderConfigured(name: ProviderName): boolean;
+export declare function configuredProviderStatus(): Record<string, boolean>;
+export declare function getProviderConfig(name: ProviderName): ProviderConfig;
+export declare function getOpenRouterConfig(): ProviderConfig;
+export declare function getKilocodeConfig(): ProviderConfig;
+export declare function getOpenAIConfig(): ProviderConfig;
+export declare function getAnthropicConfig(): ProviderConfig;
+export declare function getGeminiConfig(): ProviderConfig;
+export declare function getOllamaConfig(): ProviderConfig;
+export declare const KILOCODE_API_KEY: string;
+export declare const OPENAI_API_KEY: string;
+export declare const ANTHROPIC_API_KEY: string;
+export declare const GEMINI_API_KEY: string;
+export declare const OPENROUTER_API_KEY: string;
+export declare const GROQ_API_KEY: string;
+export declare const OPENAI_MODEL: string;
+export declare const ANTHROPIC_MODEL: string;
+export declare const OLLAMA_MODEL: string;
+export declare function getDefaultRouterConfig(): RouterConfig;
+export declare function getFreeTierRouterConfig(): RouterConfig;
+export declare function checkApiKeys(): {
+    openrouter: boolean;
+    kilocode: boolean;
+    openai: boolean;
+    anthropic: boolean;
+    gemini: boolean;
+    ollama: boolean;
+    groq: boolean;
+    providers: Record<string, boolean>;
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/llm/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/llm/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAmD7E,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAOhE;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIlE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,CAEpE;AAED,wBAAgB,mBAAmB,IAAI,cAAc,CAEpD;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAElD;AAED,wBAAgB,eAAe,IAAI,cAAc,CAEhD;AAED,wBAAgB,kBAAkB,IAAI,cAAc,CAEnD;AAED,wBAAgB,eAAe,IAAI,cAAc,CAEhD;AAED,wBAAgB,eAAe,IAAI,cAAc,CAEhD;AAED,eAAO,MAAM,gBAAgB,QAAsD,CAAC;AACpF,eAAO,MAAM,cAAc,QAAsD,CAAC;AAClF,eAAO,MAAM,iBAAiB,QAAyD,CAAC;AACxF,eAAO,MAAM,cAAc,QAAsD,CAAC;AAClF,eAAO,MAAM,kBAAkB,QAA0D,CAAC;AAC1F,eAAO,MAAM,YAAY,QAAkC,CAAC;AAE5D,eAAO,MAAM,YAAY,QAAiC,CAAC;AAC3D,eAAO,MAAM,eAAe,QAAoC,CAAC;AACjE,eAAO,MAAM,YAAY,QAAiC,CAAC;AAqB3D,wBAAgB,sBAAsB,IAAI,YAAY,CAErD;AAED,wBAAgB,uBAAuB,IAAI,YAAY,CAEtD;AAED,wBAAgB,YAAY,IAAI;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAYA"}