nduka 1.0.0

package/dist/llm/router.js

@@ -0,0 +1,167 @@
+import { LLMError, RateLimitError, TimeoutError } from './types.js';
+import { OpenAICompatibleProvider } from './providers/openai-compat.js';
+function createProvider(config) {
+    const capabilities = {
+        supportsStreaming: config.supportsStreaming ?? true,
+        supportsTools: config.supportsTools ?? true,
+        supportsVision: config.supportsVision ?? false,
+        supportsJSON: config.supportsJSON ?? true,
+        maxContextTokens: config.maxContextTokens ?? 128_000,
+        maxOutputTokens: config.maxOutputTokens ?? 16_384,
+    };
+    return new OpenAICompatibleProvider(config, capabilities);
+}
+export class ProviderRouter {
+    providers = new Map();
+    config;
+    circuitBreakers = new Map();
+    roundRobinIndex = 0;
+    constructor(config) {
+        this.config = config;
+        for (const providerConfig of config.providers) {
+            const provider = createProvider(providerConfig);
+            this.providers.set(providerConfig.name, provider);
+            this.circuitBreakers.set(providerConfig.name, { failures: 0, openedAt: null });
+        }
+    }
+    /** Send a completion request using normal fallback ordering. */
+    async complete(request) {
+        const orderedProviders = this.getOrderedProviders();
+        for (const provider of orderedProviders) {
+            if (!this.isProviderAvailable(provider.name))
+                continue;
+            try {
+                const response = await provider.complete(request);
+                this.recordProviderSuccess(provider.name);
+                return response;
+            }
+            catch (err) {
+                this.recordProviderFailure(provider.name, err);
+            }
+        }
+        throw new LLMError('All providers unavailable', this.defaultErrorProvider(), 503, true);
+    }
+    /** Send a completion request to one explicit provider. */
+    async completeForProvider(providerName, request) {
+        const provider = this.providers.get(providerName);
+        if (!provider) {
+            throw new LLMError(`Provider not configured: ${providerName}`, providerName, 503, true);
+        }
+        if (!this.isProviderAvailable(providerName)) {
+            throw new LLMError(`Provider unavailable: ${providerName}`, providerName, 503, true);
+        }
+        try {
+            const response = await provider.complete(request);
+            this.recordProviderSuccess(providerName);
+            return response;
+        }
+        catch (err) {
+            this.recordProviderFailure(providerName, err);
+            throw err;
+        }
+    }
+    async *stream(request) {
+        const orderedProviders = this.getOrderedProviders();
+        for (const provider of orderedProviders) {
+            if (!this.isProviderAvailable(provider.name))
+                continue;
+            try {
+                for await (const chunk of provider.stream(request)) {
+                    yield chunk;
+                }
+                this.recordProviderSuccess(provider.name);
+                return;
+            }
+            catch (err) {
+                this.recordProviderFailure(provider.name, err);
+            }
+        }
+        throw new LLMError('All providers unavailable for streaming', this.defaultErrorProvider(), 503, true);
+    }
+    getAllHealth() {
+        const health = new Map();
+        for (const [name, provider] of this.providers) {
+            health.set(name, provider.getHealth());
+        }
+        return health;
+    }
+    getHealthiestProvider() {
+        const ordered = this.getOrderedProviders();
+        return ordered.length > 0 ? ordered[0].name : null;
+    }
+    hasHealthyProvider() {
+        for (const [name] of this.providers) {
+            if (this.isProviderAvailable(name))
+                return true;
+        }
+        return false;
+    }
+    defaultErrorProvider() {
+        return this.config.fallbackChain[0] || this.config.providers[0]?.name || 'unconfigured';
+    }
+    getOrderedProviders() {
+        const strategy = this.config.strategy;
+        const all = Array.from(this.providers.values());
+        switch (strategy) {
+            case 'lowest_latency':
+                return all.sort((a, b) => a.getHealth().latencyMs - b.getHealth().latencyMs);
+            case 'healthiest':
+                return all.sort((a, b) => a.getHealth().consecutiveFailures - b.getHealth().consecutiveFailures);
+            case 'fallback': {
+                const ordered = [];
+                for (const name of this.config.fallbackChain) {
+                    const provider = this.providers.get(name);
+                    if (provider)
+                        ordered.push(provider);
+                }
+                for (const [name, provider] of this.providers) {
+                    if (!this.config.fallbackChain.includes(name))
+                        ordered.push(provider);
+                }
+                return ordered;
+            }
+            case 'round_robin':
+            default:
+                this.roundRobinIndex = all.length > 0 ? (this.roundRobinIndex + 1) % all.length : 0;
+                return [...all.slice(this.roundRobinIndex), ...all.slice(0, this.roundRobinIndex)];
+        }
+    }
+    isProviderAvailable(name) {
+        const breaker = this.circuitBreakers.get(name);
+        if (!breaker)
+            return false;
+        if (breaker.openedAt) {
+            const elapsed = Date.now() - breaker.openedAt;
+            if (elapsed < this.config.circuitBreakerResetMs)
+                return false;
+            breaker.failures = 0;
+            breaker.openedAt = null;
+        }
+        const provider = this.providers.get(name);
+        if (!provider)
+            return false;
+        return provider.isHealthy();
+    }
+    recordProviderSuccess(name) {
+        const breaker = this.circuitBreakers.get(name);
+        if (breaker) {
+            breaker.failures = 0;
+            breaker.openedAt = null;
+        }
+    }
+    recordProviderFailure(name, error) {
+        if (error instanceof RateLimitError)
+            return;
+        if (error instanceof TimeoutError && this.config.circuitBreakerThreshold > 3)
+            return;
+        const breaker = this.circuitBreakers.get(name);
+        if (!breaker)
+            return;
+        breaker.failures++;
+        if (breaker.failures >= this.config.circuitBreakerThreshold) {
+            breaker.openedAt = Date.now();
+            console.warn(`[ProviderRouter] Circuit breaker opened for ${name} after ${breaker.failures} failures`);
+        }
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/llm/router.js.map

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

package/dist/llm/safety.d.ts

@@ -0,0 +1,15 @@
+import type { AIResponse } from '../llm/engine.js';
+export declare function validateToolCall(tool: {
+    name?: string;
+    arguments?: Record<string, unknown>;
+}): {
+    valid: boolean;
+    error?: string;
+};
+export declare function safeExecute<T>(fn: () => Promise<T>, timeoutMs?: number): Promise<{
+    result?: T;
+    error?: string;
+    timedOut: boolean;
+}>;
+export declare function safeAIExecute(generate: () => Promise<AIResponse>, fallbackText: string, timeoutMs?: number): Promise<AIResponse>;
+//# sourceMappingURL=safety.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"safety.d.ts","sourceRoot":"","sources":["../../src/llm/safety.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQnD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAcjI;AAED,wBAAsB,WAAW,CAAC,CAAC,EACjC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,SAAS,SAAS,GACjB,OAAO,CAAC;IAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAW5D;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,EACnC,YAAY,EAAE,MAAM,EACpB,SAAS,SAAS,GACjB,OAAO,CAAC,UAAU,CAAC,CAcrB"}

package/dist/llm/safety.js

@@ -0,0 +1,48 @@
+const TOOL_SCHEMAS = {
+    web_search: { required: ['query'] },
+    news_search: { required: ['query'] },
+    url_fetch: { required: ['url'] },
+};
+export function validateToolCall(tool) {
+    if (!tool?.name)
+        return { valid: false, error: 'Missing tool name' };
+    if (!tool?.arguments)
+        return { valid: false, error: 'Missing tool arguments' };
+    const schema = TOOL_SCHEMAS[tool.name];
+    if (!schema)
+        return { valid: false, error: `Unknown tool: ${tool.name}` };
+    for (const field of schema.required) {
+        if (!(field in tool.arguments)) {
+            return { valid: false, error: `Missing required field: ${field}` };
+        }
+    }
+    return { valid: true };
+}
+export async function safeExecute(fn, timeoutMs = 15_000) {
+    try {
+        const result = await Promise.race([
+            fn(),
+            new Promise((_, reject) => setTimeout(() => reject(new Error('TIMEOUT')), timeoutMs)),
+        ]);
+        return { result, timedOut: false };
+    }
+    catch (err) {
+        const msg = err.message;
+        return { error: msg, timedOut: msg === 'TIMEOUT' };
+    }
+}
+export async function safeAIExecute(generate, fallbackText, timeoutMs = 20_000) {
+    const { result, timedOut, error } = await safeExecute(generate, timeoutMs);
+    if (result)
+        return result;
+    return {
+        text: timedOut ? fallbackText : `Sorry, I'm having trouble: ${error}`,
+        model: 'fallback',
+        provider: 'none',
+        latencyMs: timeoutMs,
+        tokensUsed: 0,
+        promptTokens: 0,
+        completionTokens: 0,
+    };
+}
+//# sourceMappingURL=safety.js.map

package/dist/llm/safety.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safety.js","sourceRoot":"","sources":["../../src/llm/safety.ts"],"names":[],"mappings":"AAEA,MAAM,YAAY,GAA2C;IAC3D,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE;IACnC,WAAW,EAAE,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE;IACpC,SAAS,EAAE,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE;CACjC,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,IAA4D;IAC3F,IAAI,CAAC,IAAI,EAAE,IAAI;QAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;IACrE,IAAI,CAAC,IAAI,EAAE,SAAS;QAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC;IAE/E,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;IAE1E,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpC,IAAI,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,2BAA2B,KAAK,EAAE,EAAE,CAAC;QACrE,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,EAAoB,EACpB,SAAS,GAAG,MAAM;IAElB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;YAChC,EAAE,EAAE;YACJ,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;SAC7F,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAI,GAAa,CAAC,OAAO,CAAC;QACnC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,KAAK,SAAS,EAAE,CAAC;IACrD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAmC,EACnC,YAAoB,EACpB,SAAS,GAAG,MAAM;IAElB,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAE3E,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,8BAA8B,KAAK,EAAE;QACrE,KAAK,EAAE,UAAU;QACjB,QAAQ,EAAE,MAAM;QAChB,SAAS,EAAE,SAAS;QACpB,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,CAAC;QACf,gBAAgB,EAAE,CAAC;KACpB,CAAC;AACJ,CAAC"}

package/dist/llm/search-planner.d.ts

@@ -0,0 +1,4 @@
+import type { WebResult } from '../tools/crunchtrova.js';
+export declare function buildWebSearchQueries(primaryQuery: string): string[];
+export declare function webResultsContainRequestedDetail(query: string, results: WebResult[]): boolean;
+//# sourceMappingURL=search-planner.d.ts.map

package/dist/llm/search-planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-planner.d.ts","sourceRoot":"","sources":["../../src/llm/search-planner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AA2BzD,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBpE;AAMD,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,OAAO,CAU7F"}

package/dist/llm/search-planner.js

@@ -0,0 +1,49 @@
+function normalize(text) {
+    return text.replace(/\s+/g, ' ').trim();
+}
+function withoutIsoDate(text) {
+    return normalize(text.replace(/\b20\d{2}-\d{2}-\d{2}\b/g, ' '));
+}
+function contentWords(text) {
+    const stop = new Set(['what', 'when', 'where', 'which', 'who', 'whos', 'whose', 'the', 'and', 'that', 'this', 'with', 'from', 'into', 'about', 'have', 'been', 'will', 'would', 'could', 'should', 'time', 'times', 'tell', 'show', 'help', 'check', 'online', 'current', 'present', 'latest', 'official', 'source']);
+    return text.toLowerCase().replace(/[^a-z0-9\s]/g, ' ').split(/\s+/).filter((w) => w.length > 2 && !stop.has(w));
+}
+function looksLikeEventTimingQuery(query) {
+    return /\b(schedule|scheduled|fixture|fixtures|match|matches|kickoff|kick-off|score|scores|tonight|today|time|timing|timings)\b/i.test(query);
+}
+function looksLikeCurrentRoleQuery(query) {
+    return /\b(current|present|now|office|in office|took office|assumed office|tenure|role|leader|head of|ceo|chair|chairman|president|minister|governor|mayor)\b/i.test(query);
+}
+function mentionsTimezone(query) {
+    return /\b(uae|gst|utc|gmt|est|edt|pst|pdt|cet|cest|local time|timezone|time zone)\b/i.test(query);
+}
+export function buildWebSearchQueries(primaryQuery) {
+    const base = normalize(primaryQuery);
+    const root = withoutIsoDate(base);
+    const queries = [base];
+    if (looksLikeEventTimingQuery(base)) {
+        queries.push(normalize(`${root} fixtures schedule kickoff times official`));
+        queries.push(normalize(`${root} ${mentionsTimezone(base) ? 'timezone kickoff official' : 'local time kickoff official'}`));
+    }
+    if (looksLikeCurrentRoleQuery(base)) {
+        queries.push(normalize(`${root} official biography assumed office`));
+        queries.push(normalize(`${root} official source tenure office`));
+    }
+    return Array.from(new Set(queries.filter(Boolean))).slice(0, 3);
+}
+function resultText(result) {
+    return [result.title, result.snippet, result.content, result.source].filter(Boolean).join(' ');
+}
+export function webResultsContainRequestedDetail(query, results) {
+    if (results.length === 0)
+        return false;
+    const joined = results.map(resultText).join('\n');
+    const lower = joined.toLowerCase();
+    if (looksLikeEventTimingQuery(query) && !/\b\d{1,2}:\d{2}\b|\b\d{1,2}\s?(am|pm)\b|\bkick\s?off\b|\buae\b|\bgst\b|\butc\b/i.test(joined))
+        return false;
+    if (looksLikeCurrentRoleQuery(query) && !/\boffice\b|\bserved\b|\bassumed\b|\binaugurat|\bsince\b|\bterm\b/i.test(joined))
+        return false;
+    const terms = contentWords(query).slice(0, 6);
+    return terms.length === 0 || terms.some((term) => lower.includes(term));
+}
+//# sourceMappingURL=search-planner.js.map

package/dist/llm/search-planner.js.map

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

package/dist/llm/task-router.d.ts

@@ -0,0 +1,19 @@
+import type { ProviderName } from './types.js';
+export type ModelTask = string;
+export interface TaskModelTarget {
+    task: ModelTask;
+    provider: ProviderName;
+    model: string;
+    source: 'env' | 'default' | 'fallback';
+    requiresVision: boolean;
+    fallbackProvider?: ProviderName;
+    fallbackModel?: string;
+}
+export declare class TaskModelRouter {
+    tasks(): ModelTask[];
+    getExplicitTarget(task: ModelTask, model: string, provider?: ProviderName): TaskModelTarget;
+    getTarget(task: ModelTask): TaskModelTarget;
+    formatStatus(): string;
+    isTask(value: string): value is ModelTask;
+}
+//# sourceMappingURL=task-router.d.ts.map

package/dist/llm/task-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-router.d.ts","sourceRoot":"","sources":["../../src/llm/task-router.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,GAAG,SAAS,GAAG,UAAU,CAAC;IACvC,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,YAAY,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAMD,qBAAa,eAAe;IAC1B,KAAK,IAAI,SAAS,EAAE;IAIpB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,eAAe;IAgB3F,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,eAAe;IAgC3C,YAAY,IAAI,MAAM;IAgBtB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,SAAS;CAG1C"}

package/dist/llm/task-router.js

@@ -0,0 +1,70 @@
+import { isProviderConfigured } from './config.js';
+import { envValue, loadEnvFile, loadLlmSettings, taskSetting } from './model-settings.js';
+function configuredTasks() {
+    return Object.keys(loadLlmSettings().tasks).sort();
+}
+export class TaskModelRouter {
+    tasks() {
+        return configuredTasks();
+    }
+    getExplicitTarget(task, model, provider) {
+        const setting = taskSetting(task);
+        const resolvedProvider = provider || setting.provider;
+        if (!resolvedProvider)
+            throw new Error(`Explicit model override for ${task} requires a provider.`);
+        if (!model)
+            throw new Error(`Explicit model override for ${task} requires a model.`);
+        return {
+            task,
+            provider: resolvedProvider,
+            model,
+            source: 'env',
+            requiresVision: Boolean(setting.requiresVision),
+        };
+    }
+    getTarget(task) {
+        const setting = taskSetting(task);
+        const env = loadEnvFile();
+        const providerOverride = envValue(env, setting.providerEnv);
+        const modelOverride = envValue(env, setting.modelEnv);
+        const fallbackProviderOverride = envValue(env, setting.fallbackProviderEnv);
+        const fallbackModelOverride = envValue(env, setting.fallbackModelEnv);
+        const provider = providerOverride || setting.provider;
+        const model = modelOverride || setting.model;
+        const fallbackProvider = fallbackProviderOverride || setting.fallbackProvider;
+        const fallbackModel = fallbackModelOverride || setting.fallbackModel;
+        if (!provider)
+            throw new Error(`Missing provider for task ${task} in LLM settings.`);
+        if (!model)
+            throw new Error(`Missing model for task ${task} in LLM settings.`);
+        const fallback = fallbackProvider && fallbackModel && isProviderConfigured(fallbackProvider)
+            ? { fallbackProvider, fallbackModel }
+            : {};
+        return {
+            task,
+            provider,
+            model,
+            source: providerOverride || modelOverride ? 'env' : 'default',
+            requiresVision: Boolean(setting.requiresVision),
+            ...fallback,
+        };
+    }
+    formatStatus() {
+        return [
+            '🧠 *Task Model Router*',
+            '',
+            ...this.tasks().map((task) => {
+                const target = this.getTarget(task);
+                const vision = target.requiresVision ? ' vision' : '';
+                const fallback = target.fallbackProvider && target.fallbackModel
+                    ? ` fallback ${target.fallbackProvider}/${target.fallbackModel}`
+                    : '';
+                return `• ${task}: ${target.provider}/${target.model} (${target.source}${vision})${fallback}`;
+            }),
+        ].join('\n');
+    }
+    isTask(value) {
+        return this.tasks().includes(value);
+    }
+}
+//# sourceMappingURL=task-router.js.map

package/dist/llm/task-router.js.map

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

package/dist/llm/types.d.ts

@@ -0,0 +1,161 @@
+/**
+ * LLM Provider — Unified Types
+ *
+ * Defines the common interface for LLM providers, including OpenAI-compatible
+ * providers configured in config/llm.settings.json.
+ */
+export type Role = 'system' | 'user' | 'assistant' | 'tool';
+export interface TextContent {
+    type: 'text';
+    text: string;
+}
+export interface ImageContent {
+    type: 'image';
+    mimeType: string;
+    data: string;
+}
+export type MessageContent = string | null | (TextContent | ImageContent)[];
+export interface Message {
+    role: Role;
+    content: MessageContent;
+    name?: string;
+    toolCallId?: string;
+    toolCalls?: ToolCall[];
+}
+export interface ToolParameter {
+    type: string;
+    description?: string;
+    properties?: Record<string, ToolParameter>;
+    required?: string[];
+    enum?: string[];
+    items?: ToolParameter;
+    additionalProperties?: boolean | ToolParameter;
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: ToolParameter;
+}
+export interface ToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+export interface ToolResult {
+    toolCallId: string;
+    content: string;
+}
+export interface LLMResponse {
+    id: string;
+    model: string;
+    provider: string;
+    content: string | null;
+    toolCalls: ToolCall[];
+    finishReason: 'stop' | 'length' | 'tool_calls' | 'error' | 'timeout';
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    latencyMs: number;
+    timestamp: number;
+}
+export interface StreamChunk {
+    content: string;
+    toolCalls: Partial<ToolCall>[];
+    finishReason: string | null;
+}
+export type LLMJsonSchema = Record<string, unknown>;
+export type LLMResponseFormat = {
+    type: 'json_object' | 'text';
+} | {
+    type: 'json_schema';
+    name: string;
+    schema: LLMJsonSchema;
+    strict?: boolean;
+};
+export interface LLMRequest {
+    messages: Message[];
+    model?: string;
+    provider?: ProviderName;
+    maxTokens?: number;
+    temperature?: number;
+    topP?: number;
+    tools?: ToolDefinition[];
+    toolChoice?: 'auto' | 'none' | {
+        name: string;
+    };
+    responseFormat?: LLMResponseFormat;
+    stop?: string[];
+    stream?: boolean;
+    timeoutMs?: number;
+    suppressThinking?: boolean;
+}
+export type ProviderName = string;
+export interface ProviderConfig {
+    name: ProviderName;
+    apiKey?: string;
+    baseURL?: string;
+    defaultModel: string;
+    models: string[];
+    timeoutMs: number;
+    maxRetries: number;
+    retryDelayMs: number;
+    supportsStreaming?: boolean;
+    supportsTools?: boolean;
+    supportsVision?: boolean;
+    supportsJSON?: boolean;
+    maxContextTokens?: number;
+    maxOutputTokens?: number;
+    responseFormatJsonSchemaProviders?: string[];
+    suppressReasoningByDefault?: boolean;
+    referer?: string;
+}
+export interface ProviderHealth {
+    provider: ProviderName;
+    healthy: boolean;
+    lastCheck: Date;
+    latencyMs: number;
+    errorRate: number;
+    consecutiveFailures: number;
+    consecutiveSuccesses: number;
+    totalRequests: number;
+    totalFailures: number;
+}
+export interface ProviderCapabilities {
+    supportsStreaming: boolean;
+    supportsTools: boolean;
+    supportsVision: boolean;
+    supportsJSON: boolean;
+    maxContextTokens: number;
+    maxOutputTokens: number;
+}
+export type RoutingStrategy = 'round_robin' | 'lowest_latency' | 'healthiest' | 'fallback';
+export interface RouterConfig {
+    strategy: RoutingStrategy;
+    providers: ProviderConfig[];
+    fallbackChain: ProviderName[];
+    healthCheckIntervalMs: number;
+    circuitBreakerThreshold: number;
+    circuitBreakerResetMs: number;
+}
+export declare class LLMError extends Error {
+    provider: ProviderName;
+    statusCode?: number;
+    retryable: boolean;
+    constructor(message: string, provider: ProviderName, statusCode?: number, retryable?: boolean);
+}
+export declare class ProviderUnavailableError extends LLMError {
+    constructor(provider: ProviderName, statusCode?: number);
+}
+export declare class RateLimitError extends LLMError {
+    retryAfterMs?: number;
+    constructor(provider: ProviderName, retryAfterMs?: number);
+}
+export declare class InsufficientCreditsError extends LLMError {
+    constructor(provider: ProviderName);
+}
+export declare class TimeoutError extends LLMError {
+    constructor(provider: ProviderName, timeoutMs: number);
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/llm/types.js

@@ -0,0 +1,45 @@
+/**
+ * LLM Provider — Unified Types
+ *
+ * Defines the common interface for LLM providers, including OpenAI-compatible
+ * providers configured in config/llm.settings.json.
+ */
+export class LLMError extends Error {
+    provider;
+    statusCode;
+    retryable;
+    constructor(message, provider, statusCode, retryable = false) {
+        super(message);
+        this.name = 'LLMError';
+        this.provider = provider;
+        this.statusCode = statusCode;
+        this.retryable = retryable;
+    }
+}
+export class ProviderUnavailableError extends LLMError {
+    constructor(provider, statusCode) {
+        super(`Provider ${provider} unavailable (${statusCode})`, provider, statusCode, true);
+        this.name = 'ProviderUnavailableError';
+    }
+}
+export class RateLimitError extends LLMError {
+    retryAfterMs;
+    constructor(provider, retryAfterMs) {
+        super(`Provider ${provider} rate limited`, provider, 429, true);
+        this.name = 'RateLimitError';
+        this.retryAfterMs = retryAfterMs;
+    }
+}
+export class InsufficientCreditsError extends LLMError {
+    constructor(provider) {
+        super(`Provider ${provider} insufficient credits`, provider, 402, false);
+        this.name = 'InsufficientCreditsError';
+    }
+}
+export class TimeoutError extends LLMError {
+    constructor(provider, timeoutMs) {
+        super(`Provider ${provider} timed out after ${timeoutMs}ms`, provider, undefined, true);
+        this.name = 'TimeoutError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/llm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/llm/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwJH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAe;IACvB,UAAU,CAAU;IACpB,SAAS,CAAU;IAEnB,YAAY,OAAe,EAAE,QAAsB,EAAE,UAAmB,EAAE,SAAS,GAAG,KAAK;QACzF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,QAAQ;IACpD,YAAY,QAAsB,EAAE,UAAmB;QACrD,KAAK,CAAC,YAAY,QAAQ,iBAAiB,UAAU,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;QACtF,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,QAAQ;IAC1C,YAAY,CAAU;IAEtB,YAAY,QAAsB,EAAE,YAAqB;QACvD,KAAK,CAAC,YAAY,QAAQ,eAAe,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAChE,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,QAAQ;IACpD,YAAY,QAAsB;QAChC,KAAK,CAAC,YAAY,QAAQ,uBAAuB,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QACzE,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,QAAQ;IACxC,YAAY,QAAsB,EAAE,SAAiB;QACnD,KAAK,CAAC,YAAY,QAAQ,oBAAoB,SAAS,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;QACxF,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF"}