lazlo-ai 1.0.0

package/dist/providers/openai.js

@@ -0,0 +1,228 @@
+/**
+ * OpenAI Provider
+ *
+ * Direct API access to OpenAI models. No massive SDKs, just axios calls.
+ */
+import axios from 'axios';
+import { logger } from '../utils/logger.js';
+import { calculateCost } from '../utils/pricing.js';
+// ============================================================================
+// Circuit Breaker
+// ============================================================================
+class CircuitBreaker {
+    failMax;
+    resetTimeout;
+    failures = 0;
+    lastFailure = 0;
+    state = 'closed';
+    constructor(failMax = 5, resetTimeout = 60000) {
+        this.failMax = failMax;
+        this.resetTimeout = resetTimeout;
+    }
+    async execute(fn) {
+        if (this.state === 'open') {
+            if (Date.now() - this.lastFailure > this.resetTimeout) {
+                this.state = 'half-open';
+            }
+            else {
+                throw new Error('Circuit breaker open');
+            }
+        }
+        try {
+            const result = await fn();
+            if (this.state === 'half-open') {
+                this.state = 'closed';
+                this.failures = 0;
+            }
+            return result;
+        }
+        catch (error) {
+            this.failures++;
+            this.lastFailure = Date.now();
+            if (this.failures >= this.failMax) {
+                this.state = 'open';
+            }
+            throw error;
+        }
+    }
+}
+const openAICircuitBreaker = new CircuitBreaker();
+// ============================================================================
+// Helper Functions
+// ============================================================================
+function isRetryableError(error) {
+    if (axios.isAxiosError(error)) {
+        const status = error.response?.status;
+        return status === undefined || status === 429 || status >= 500;
+    }
+    return true;
+}
+function parseResponseFormat(format) {
+    if (!format)
+        return undefined;
+    if (format.type === 'json_schema' && format.json_schema) {
+        return {
+            type: 'json_schema',
+            json_schema: {
+                name: format.json_schema.name,
+                schema: format.json_schema.schema,
+                strict: format.json_schema.strict ?? true,
+            },
+        };
+    }
+    return { type: format.type };
+}
+// Simple rate limiting
+let lastRequestTime = 0;
+const MIN_REQUEST_INTERVAL = 100; // ms between requests
+async function rateLimit() {
+    const now = Date.now();
+    const elapsed = now - lastRequestTime;
+    if (elapsed < MIN_REQUEST_INTERVAL) {
+        await new Promise(resolve => setTimeout(resolve, MIN_REQUEST_INTERVAL - elapsed));
+    }
+    lastRequestTime = Date.now();
+}
+// ============================================================================
+// OpenAI Provider
+// ============================================================================
+export class OpenAI {
+    supportsTools = true;
+    supportsStructuredOutput = true;
+    client;
+    defaultModel;
+    constructor(apiKey, defaultModel = 'gpt-4o', options = {}) {
+        const key = apiKey ?? (typeof process !== 'undefined' ? process.env?.OPENAI_API_KEY : undefined);
+        if (!key) {
+            throw new Error('OPENAI_API_KEY is required');
+        }
+        this.defaultModel = defaultModel;
+        this.client = axios.create({
+            baseURL: options.baseURL ?? 'https://api.openai.com/v1',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${key}`,
+            },
+            timeout: options.timeout ?? 120000,
+        });
+        logger.info(`OpenAI Provider ready. Default Model: ${this.defaultModel}`);
+    }
+    preparePayload(model, messages, options = {}) {
+        const payload = {
+            model,
+            messages,
+        };
+        if (options.tools) {
+            payload.tools = options.tools;
+        }
+        if (options.responseFormat) {
+            payload.response_format = parseResponseFormat(options.responseFormat);
+        }
+        if (options.temperature !== undefined)
+            payload.temperature = options.temperature;
+        if (options.maxTokens !== undefined)
+            payload.max_tokens = options.maxTokens;
+        if (options.topP !== undefined)
+            payload.top_p = options.topP;
+        if (options.stop !== undefined)
+            payload.stop = options.stop;
+        if (options.stream !== undefined)
+            payload.stream = options.stream;
+        return payload;
+    }
+    async invoke(messages, options = {}) {
+        const model = options.model ?? this.defaultModel;
+        // Handle string input
+        const formattedMessages = typeof messages === 'string'
+            ? [{ role: 'user', content: messages }]
+            : messages;
+        // Convert stop to array if needed
+        const stop = options.stop
+            ? (Array.isArray(options.stop) ? options.stop : [options.stop])
+            : undefined;
+        const payload = this.preparePayload(model, formattedMessages, {
+            ...options,
+            stop,
+        });
+        return openAICircuitBreaker.execute(async () => {
+            await rateLimit();
+            try {
+                const response = await this.client.post('/chat/completions', payload);
+                const data = response.data;
+                if (!data.choices?.length) {
+                    throw new Error('Empty response from OpenAI');
+                }
+                const choice = data.choices[0];
+                const usage = data.usage ?? {};
+                const result = {
+                    content: choice.message?.content ?? '',
+                    tool_calls: choice.message?.tool_calls,
+                    usage: {
+                        prompt_tokens: usage.prompt_tokens ?? 0,
+                        completion_tokens: usage.completion_tokens ?? 0,
+                        total_tokens: usage.total_tokens ?? 0,
+                    },
+                    model: model,
+                    finish_reason: choice.finish_reason,
+                };
+                logger.debug(`OpenAI: ${usage.total_tokens ?? 0} tokens, $${calculateCost(model, usage.prompt_tokens ?? 0, usage.completion_tokens ?? 0).toFixed(6)}`);
+                return result;
+            }
+            catch (error) {
+                if (axios.isAxiosError(error)) {
+                    logger.error(`OpenAI API error: ${error.message}`);
+                }
+                throw error;
+            }
+        });
+    }
+    async *stream(messages, options = {}) {
+        const model = options.model ?? this.defaultModel;
+        const formattedMessages = typeof messages === 'string'
+            ? [{ role: 'user', content: messages }]
+            : messages;
+        const payload = this.preparePayload(model, formattedMessages, { ...options, stream: true });
+        const response = await this.client.post('/chat/completions', payload, {
+            responseType: 'stream',
+        });
+        for await (const chunk of response.data) {
+            const lines = chunk.toString().split('\n').filter((line) => line.trim() !== '');
+            for (const line of lines) {
+                if (line.startsWith('data: ')) {
+                    const data = line.slice(6);
+                    if (data === '[DONE]') {
+                        return;
+                    }
+                    try {
+                        const parsed = JSON.parse(data);
+                        const delta = parsed.choices?.[0]?.delta?.content;
+                        if (delta) {
+                            yield {
+                                delta,
+                                finish_reason: parsed.choices[0]?.finish_reason,
+                                index: parsed.choices[0]?.index,
+                            };
+                        }
+                    }
+                    catch {
+                        // Skip malformed JSON
+                    }
+                }
+            }
+        }
+    }
+    close() {
+        logger.info('OpenAI client closed.');
+    }
+    // Alias for compatibility - async version calls the same implementation
+    async ainvoke(messages, options) {
+        return this.invoke(messages, options);
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+export function createOpenAI(apiKey, defaultModel) {
+    return new OpenAI(apiKey, defaultModel);
+}
+//# sourceMappingURL=openai.js.map

package/dist/providers/openai.js.map

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

package/dist/retrievers/index.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Retrievers
+ *
+ * Base interfaces for document retrieval
+ */
+export interface BaseRetriever {
+    getRelevantDocuments(query: string): Promise<Document[]>;
+}
+export interface Document {
+    pageContent: string;
+    metadata: Record<string, unknown>;
+}
+export interface VectorStore {
+    similaritySearch(query: string, k?: number): Promise<Document[]>;
+    similaritySearchWithScore(query: string, k?: number): Promise<[Document, number][]>;
+    addDocuments(documents: Document[]): Promise<void>;
+}
+/**
+ * Contextual Compression Retriever
+ *
+ * Compresses retrieved documents based on query context
+ */
+export declare class ContextualCompressionRetriever implements BaseRetriever {
+    private baseRetriever;
+    private compressor?;
+    constructor(options: {
+        baseRetriever: BaseRetriever;
+        compressor?: (doc: Document, query: string) => Promise<Document>;
+    });
+    getRelevantDocuments(query: string): Promise<Document[]>;
+}
+/**
+ * Parent Document Retriever
+ *
+ * Retrieves full parent documents from embedded chunks
+ */
+export declare class ParentDocumentRetriever implements BaseRetriever {
+    private childRetriever;
+    private idKey;
+    private parentDocuments;
+    constructor(options: {
+        childRetriever: BaseRetriever;
+        idKey?: string;
+    });
+    /**
+     * Add parent documents
+     */
+    addParentDocuments(documents: Document[]): void;
+    getRelevantDocuments(query: string): Promise<Document[]>;
+}
+/**
+ * Ensemble Retriever
+ *
+ * Combines multiple retrievers with weighted scoring
+ */
+export declare class EnsembleRetriever implements BaseRetriever {
+    private retrievers;
+    constructor(retrievers: {
+        retriever: BaseRetriever;
+        weight: number;
+    }[]);
+    getRelevantDocuments(query: string): Promise<Document[]>;
+}
+/**
+ * Create a vector store retriever
+ */
+export declare function createVectorStoreRetriever(vectorStore: VectorStore, options?: {
+    k?: number;
+    filter?: (doc: Document) => boolean;
+}): BaseRetriever;
+//# sourceMappingURL=index.d.ts.map

package/dist/retrievers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/retrievers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,WAAW,aAAa;IAC5B,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,WAAW;IAC1B,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjE,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IACpF,YAAY,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD;AAED;;;;GAIG;AACH,qBAAa,8BAA+B,YAAW,aAAa;IAClE,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,UAAU,CAAC,CAAsD;gBAE7D,OAAO,EAAE;QACnB,aAAa,EAAE,aAAa,CAAC;QAC7B,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;KAClE;IAKK,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;CAgB/D;AAED;;;;GAIG;AACH,qBAAa,uBAAwB,YAAW,aAAa;IAC3D,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,eAAe,CAAoC;gBAE/C,OAAO,EAAE;QACnB,cAAc,EAAE,aAAa,CAAC;QAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB;IAKD;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAI;IAOzC,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;CAuB/D;AAED;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,UAAU,CAAiD;gBAEvD,UAAU,EAAE;QAAE,SAAS,EAAE,aAAa,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE;IAIhE,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;CAgC/D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,WAAW,EACxB,OAAO,GAAE;IACP,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,OAAO,CAAC;CAChC,GACL,aAAa,CAcf"}

package/dist/retrievers/index.js

@@ -0,0 +1,130 @@
+/**
+ * Retrievers
+ *
+ * Base interfaces for document retrieval
+ */
+import { logger } from '../utils/logger.js';
+/**
+ * Contextual Compression Retriever
+ *
+ * Compresses retrieved documents based on query context
+ */
+export class ContextualCompressionRetriever {
+    baseRetriever;
+    compressor;
+    constructor(options) {
+        this.baseRetriever = options.baseRetriever;
+        this.compressor = options.compressor;
+    }
+    async getRelevantDocuments(query) {
+        const docs = await this.baseRetriever.getRelevantDocuments(query);
+        if (!this.compressor) {
+            return docs;
+        }
+        // Compress each document
+        const compressed = [];
+        for (const doc of docs) {
+            const compressedDoc = await this.compressor(doc, query);
+            compressed.push(compressedDoc);
+        }
+        return compressed;
+    }
+}
+/**
+ * Parent Document Retriever
+ *
+ * Retrieves full parent documents from embedded chunks
+ */
+export class ParentDocumentRetriever {
+    childRetriever;
+    idKey;
+    parentDocuments = new Map();
+    constructor(options) {
+        this.childRetriever = options.childRetriever;
+        this.idKey = options.idKey || 'parent_id';
+    }
+    /**
+     * Add parent documents
+     */
+    addParentDocuments(documents) {
+        for (const doc of documents) {
+            const id = doc.metadata[this.idKey] || crypto.randomUUID();
+            this.parentDocuments.set(id, doc);
+        }
+    }
+    async getRelevantDocuments(query) {
+        const childDocs = await this.childRetriever.getRelevantDocuments(query);
+        // Get unique parent IDs
+        const parentIds = new Set();
+        for (const doc of childDocs) {
+            const parentId = doc.metadata[this.idKey];
+            if (parentId) {
+                parentIds.add(parentId);
+            }
+        }
+        // Return parent documents
+        const parents = [];
+        for (const id of parentIds) {
+            const parent = this.parentDocuments.get(id);
+            if (parent) {
+                parents.push(parent);
+            }
+        }
+        return parents.length > 0 ? parents : childDocs;
+    }
+}
+/**
+ * Ensemble Retriever
+ *
+ * Combines multiple retrievers with weighted scoring
+ */
+export class EnsembleRetriever {
+    retrievers;
+    constructor(retrievers) {
+        this.retrievers = retrievers;
+    }
+    async getRelevantDocuments(query) {
+        const allDocs = new Map();
+        // Fetch from all retrievers
+        for (const { retriever, weight } of this.retrievers) {
+            try {
+                const docs = await retriever.getRelevantDocuments(query);
+                for (let i = 0; i < docs.length; i++) {
+                    const doc = docs[i];
+                    const key = `${doc.pageContent.slice(0, 50)}`;
+                    const score = weight * (docs.length - i) / docs.length;
+                    if (allDocs.has(key)) {
+                        allDocs.get(key).score += score;
+                    }
+                    else {
+                        allDocs.set(key, { doc, score });
+                    }
+                }
+            }
+            catch (error) {
+                logger.warn(`[EnsembleRetriever] Error from retriever: ${error}`);
+            }
+        }
+        // Sort by score and return
+        const sorted = Array.from(allDocs.values())
+            .sort((a, b) => b.score - a.score)
+            .map(({ doc }) => doc);
+        return sorted;
+    }
+}
+/**
+ * Create a vector store retriever
+ */
+export function createVectorStoreRetriever(vectorStore, options = {}) {
+    const k = options.k || 4;
+    return {
+        async getRelevantDocuments(query) {
+            let docs = await vectorStore.similaritySearch(query, k);
+            if (options.filter) {
+                docs = docs.filter(options.filter);
+            }
+            return docs;
+        }
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/retrievers/index.js.map

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

package/dist/router/smartrouter.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Smart Router - Route prompts to fast or smart models based on complexity
+ */
+import { BaseChatModel } from '../core/types.js';
+export interface RouterOptions {
+    fast: BaseChatModel;
+    smart: BaseChatModel;
+    threshold?: number;
+    classifierLLM?: BaseChatModel;
+}
+export declare class SmartRouter {
+    private fast;
+    private smart;
+    private threshold;
+    private classifierLLM?;
+    private fastCalls;
+    private smartCalls;
+    constructor(options: RouterOptions);
+    private classify;
+    invoke(prompt: string, options?: {
+        model?: string;
+        temperature?: number;
+    }): Promise<{
+        content: string;
+        model: string;
+    }>;
+    ainvoke(prompt: string, options?: {
+        model?: string;
+        temperature?: number;
+    }): Promise<{
+        content: string;
+        model: string;
+    }>;
+    printStats(): void;
+}
+//# sourceMappingURL=smartrouter.d.ts.map

package/dist/router/smartrouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smartrouter.d.ts","sourceRoot":"","sources":["../../src/router/smartrouter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAW,MAAM,kBAAkB,CAAC;AAqE1D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAK;gBAEX,OAAO,EAAE,aAAa;YASpB,QAAQ;IA4BhB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QACrC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAgBzC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QACtC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAI/C,UAAU,IAAI,IAAI;CAoBnB"}

package/dist/router/smartrouter.js

@@ -0,0 +1,132 @@
+/**
+ * Smart Router - Route prompts to fast or smart models based on complexity
+ */
+import { logger } from '../utils/logger.js';
+// ============================================================================
+// Complexity Signals
+// ============================================================================
+const COMPLEX_SIGNALS = [
+    'explain', 'compare', 'analyze', 'design', 'implement', 'prove',
+    'write code', 'refactor', 'debug', 'architecture', 'difference between',
+    'step by step', 'tradeoffs', 'evaluate', 'research', 'synthesize',
+    'multi-step', 'complex', 'detailed', 'comprehensive', 'why does',
+    'algorithm', 'system', 'distributed', 'optimize', 'refactor',
+];
+const SIMPLE_SIGNALS = [
+    'what is', 'who is', 'when did', 'where is', 'define',
+    'list', 'how many', 'translate', 'convert', 'yes or no',
+    'true or false', 'capital', 'president', 'date of',
+];
+// ============================================================================
+// Heuristic Complexity Calculation
+// ============================================================================
+function heuristicComplexity(prompt) {
+    const text = prompt.toLowerCase();
+    let score = 0.0;
+    // Word count factor
+    const wordCount = text.split(/\s+/).length;
+    if (wordCount > 100) {
+        score += 0.3;
+    }
+    else if (wordCount > 40) {
+        score += 0.15;
+    }
+    // Question count
+    const questionCount = (text.match(/\?/g) || []).length;
+    score += Math.min(questionCount * 0.1, 0.2);
+    // Complex signals
+    for (const signal of COMPLEX_SIGNALS) {
+        if (text.includes(signal)) {
+            score += 0.15;
+            break;
+        }
+    }
+    // Simple signals (reduce complexity)
+    for (const signal of SIMPLE_SIGNALS) {
+        if (text.includes(signal)) {
+            score -= 0.15;
+            break;
+        }
+    }
+    // Code detection
+    if (/```|def |function |class |import |const |let |var /.test(text)) {
+        score += 0.25;
+    }
+    return Math.max(0.0, Math.min(1.0, score));
+}
+export class SmartRouter {
+    fast;
+    smart;
+    threshold;
+    classifierLLM;
+    fastCalls = 0;
+    smartCalls = 0;
+    constructor(options) {
+        this.fast = options.fast;
+        this.smart = options.smart;
+        this.threshold = options.threshold ?? 0.5;
+        this.classifierLLM = options.classifierLLM;
+        logger.info(`SmartRouter ready. Threshold: ${this.threshold}. Classifier: ${this.classifierLLM ? 'LLM' : 'heuristic'}`);
+    }
+    async classify(prompt) {
+        if (!this.classifierLLM) {
+            return heuristicComplexity(prompt);
+        }
+        // Use LLM classifier
+        const classificationPrompt = `Rate the complexity of the following task on a scale of 0.0 to 1.0.
+0.0 = trivial fact lookup. 1.0 = requires deep reasoning, code writing, or multi-step analysis.
+Output ONLY a single decimal number, nothing else.
+
+Task: ${prompt}`;
+        try {
+            const response = await this.classifierLLM.invoke([
+                { role: 'user', content: classificationPrompt }
+            ]);
+            const match = response.content.match(/[0-9]*\.?[0-9]+/);
+            if (match) {
+                return parseFloat(match[0]);
+            }
+        }
+        catch (error) {
+            logger.warn(`SmartRouter classifier failed: ${error}. Using heuristic.`);
+        }
+        return heuristicComplexity(prompt);
+    }
+    async invoke(prompt, options) {
+        const score = await this.classify(prompt);
+        if (score >= this.threshold) {
+            logger.info(`[SmartRouter] Complexity=${score.toFixed(2)} → SMART model`);
+            this.smartCalls++;
+            const response = await this.smart.invoke([{ role: 'user', content: prompt }], options);
+            return { content: response.content, model: this.smart.defaultModel ?? 'smart' };
+        }
+        else {
+            logger.info(`[SmartRouter] Complexity=${score.toFixed(2)} → FAST model`);
+            this.fastCalls++;
+            const response = await this.fast.invoke([{ role: 'user', content: prompt }], options);
+            return { content: response.content, model: this.fast.defaultModel ?? 'fast' };
+        }
+    }
+    async ainvoke(prompt, options) {
+        return this.invoke(prompt, options);
+    }
+    printStats() {
+        const total = this.fastCalls + this.smartCalls;
+        if (total === 0) {
+            console.log('No calls routed yet.');
+            return;
+        }
+        const fastPct = (this.fastCalls / total * 100).toFixed(1);
+        const smartPct = (this.smartCalls / total * 100).toFixed(1);
+        console.log(`
+${'='.repeat(50)}
+  Lazlo SmartRouter Stats
+${'='.repeat(50)}
+  Total calls  : ${total}
+  Fast model   : ${this.fastCalls} (${fastPct}%)
+  Smart model  : ${this.smartCalls} (${smartPct}%)
+${'='.repeat(50)}
+`);
+    }
+}
+//# sourceMappingURL=smartrouter.js.map

package/dist/router/smartrouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smartrouter.js","sourceRoot":"","sources":["../../src/router/smartrouter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,MAAM,eAAe,GAAG;IACtB,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO;IAC/D,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,oBAAoB;IACvE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY;IACjE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU;IAChE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU;CAC7D,CAAC;AAEF,MAAM,cAAc,GAAG;IACrB,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ;IACrD,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW;IACvD,eAAe,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS;CACnD,CAAC;AAEF,+EAA+E;AAC/E,mCAAmC;AACnC,+EAA+E;AAE/E,SAAS,mBAAmB,CAAC,MAAc;IACzC,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAClC,IAAI,KAAK,GAAG,GAAG,CAAC;IAEhB,oBAAoB;IACpB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,SAAS,GAAG,GAAG,EAAE,CAAC;QACpB,KAAK,IAAI,GAAG,CAAC;IACf,CAAC;SAAM,IAAI,SAAS,GAAG,EAAE,EAAE,CAAC;QAC1B,KAAK,IAAI,IAAI,CAAC;IAChB,CAAC;IAED,iBAAiB;IACjB,MAAM,aAAa,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACvD,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,aAAa,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC;IAE5C,kBAAkB;IAClB,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,KAAK,IAAI,IAAI,CAAC;YACd,MAAM;QACR,CAAC;IACH,CAAC;IAED,qCAAqC;IACrC,KAAK,MAAM,MAAM,IAAI,cAAc,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,KAAK,IAAI,IAAI,CAAC;YACd,MAAM;QACR,CAAC;IACH,CAAC;IAED,iBAAiB;IACjB,IAAI,oDAAoD,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACpE,KAAK,IAAI,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC;AAaD,MAAM,OAAO,WAAW;IACd,IAAI,CAAgB;IACpB,KAAK,CAAgB;IACrB,SAAS,CAAS;IAClB,aAAa,CAAiB;IAC9B,SAAS,GAAG,CAAC,CAAC;IACd,UAAU,GAAG,CAAC,CAAC;IAEvB,YAAY,OAAsB;QAChC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,GAAG,CAAC;QAC1C,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAE3C,MAAM,CAAC,IAAI,CAAC,iCAAiC,IAAI,CAAC,SAAS,iBAAiB,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1H,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,MAAc;QACnC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;QAED,qBAAqB;QACrB,MAAM,oBAAoB,GAAG;;;;QAIzB,MAAM,EAAE,CAAC;QAEb,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC;gBAC/C,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,EAAE;aAChD,CAAC,CAAC;YAEH,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;YACxD,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,kCAAkC,KAAK,oBAAoB,CAAC,CAAC;QAC3E,CAAC;QAED,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,OAG5B;QACC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAE1C,IAAI,KAAK,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,4BAA4B,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;YAC1E,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;YACvF,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAG,IAAI,CAAC,KAAa,CAAC,YAAY,IAAI,OAAO,EAAE,CAAC;QAC3F,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,4BAA4B,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;YACzE,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;YACtF,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAG,IAAI,CAAC,IAAY,CAAC,YAAY,IAAI,MAAM,EAAE,CAAC;QACzF,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAc,EAAE,OAG7B;QACC,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,UAAU;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC;QAC/C,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;YACpC,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,SAAS,GAAG,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,UAAU,GAAG,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAE5D,OAAO,CAAC,GAAG,CAAC;EACd,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;;EAEd,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;mBACG,KAAK;mBACL,IAAI,CAAC,SAAS,KAAK,OAAO;mBAC1B,IAAI,CAAC,UAAU,KAAK,QAAQ;EAC7C,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;CACf,CAAC,CAAC;IACD,CAAC;CACF"}

package/dist/text_splitters/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Text Splitters - Split documents into chunks
+ */
+import { Document } from '../core/types.js';
+export interface TextSplitterOptions {
+    separator?: string;
+    chunkSize?: number;
+    chunkOverlap?: number;
+}
+export declare class CharacterTextSplitter {
+    private separator;
+    private chunkSize;
+    private chunkOverlap;
+    constructor(options?: TextSplitterOptions);
+    splitText(text: string): string[];
+    splitDocuments(documents: Document[]): Document[];
+}
+export declare class RecursiveCharacterTextSplitter extends CharacterTextSplitter {
+    private separators;
+    constructor(options?: TextSplitterOptions & {
+        separators?: string[];
+    });
+    splitText(text: string): string[];
+    private forceSplit;
+}
+export declare function createCharacterSplitter(options?: TextSplitterOptions): CharacterTextSplitter;
+export declare function createRecursiveSplitter(options?: TextSplitterOptions): RecursiveCharacterTextSplitter;
+//# sourceMappingURL=index.d.ts.map