orkajs 1.0.0

package/dist/chunk-M7MVFPKB.cjs

@@ -0,0 +1,201 @@
+'use strict';
+
+// src/chains/qa-chain.ts
+var QAChain = class {
+  llm;
+  retriever;
+  collection;
+  systemPrompt;
+  returnSources;
+  strategy;
+  maxSourceTokens;
+  constructor(options) {
+    this.llm = options.llm;
+    this.retriever = options.retriever;
+    this.collection = options.collection;
+    this.returnSources = options.returnSources ?? true;
+    this.strategy = options.strategy ?? "stuff";
+    this.maxSourceTokens = options.maxSourceTokens ?? 3e3;
+    this.systemPrompt = options.systemPrompt ?? "You are a helpful assistant. Answer the question based ONLY on the provided documents. Cite specific parts of the documents when possible. If the documents do not contain the answer, say so.";
+  }
+  async call(question) {
+    const steps = [];
+    const retrieveStart = Date.now();
+    const sources = await this.retriever.retrieve(question, this.collection);
+    steps.push({
+      name: "retrieve",
+      input: question,
+      output: `Found ${sources.length} documents`,
+      latencyMs: Date.now() - retrieveStart
+    });
+    if (sources.length === 0) {
+      return {
+        answer: "No relevant documents found to answer this question.",
+        sources: [],
+        intermediateSteps: steps
+      };
+    }
+    let answer;
+    let usage = { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
+    switch (this.strategy) {
+      case "stuff":
+        ({ answer, usage } = await this.stuffQA(question, sources, steps));
+        break;
+      case "map-reduce":
+        ({ answer, usage } = await this.mapReduceQA(question, sources, steps));
+        break;
+      case "refine":
+        ({ answer, usage } = await this.refineQA(question, sources, steps));
+        break;
+    }
+    return {
+      answer,
+      sources: this.returnSources ? sources : void 0,
+      intermediateSteps: steps,
+      usage
+    };
+  }
+  async stuffQA(question, sources, steps) {
+    let context = "";
+    let tokenEstimate = 0;
+    for (const source of sources) {
+      const text = source.content ?? "";
+      const est = Math.ceil(text.length / 4);
+      if (tokenEstimate + est > this.maxSourceTokens) break;
+      context += `[Document ${source.id}]:
+${text}
+
+`;
+      tokenEstimate += est;
+    }
+    const prompt = `Documents:
+${context}
+Question: ${question}
+
+Provide a detailed answer based on the documents above:`;
+    const start = Date.now();
+    const result = await this.llm.generate(prompt, {
+      systemPrompt: this.systemPrompt,
+      temperature: 0.3
+    });
+    steps.push({
+      name: "stuff_answer",
+      input: `${sources.length} docs, question: ${question}`,
+      output: result.content.slice(0, 200),
+      latencyMs: Date.now() - start
+    });
+    return { answer: result.content, usage: result.usage };
+  }
+  async mapReduceQA(question, sources, steps) {
+    const totalUsage = { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
+    const partialAnswers = [];
+    for (let i = 0; i < sources.length; i++) {
+      const text = sources[i].content ?? "";
+      if (!text) continue;
+      const prompt = `Document:
+${text}
+
+Question: ${question}
+
+Extract any information from this document that is relevant to answering the question:`;
+      const start = Date.now();
+      const result = await this.llm.generate(prompt, {
+        systemPrompt: "Extract relevant information concisely.",
+        temperature: 0,
+        maxTokens: 512
+      });
+      partialAnswers.push(result.content);
+      totalUsage.promptTokens += result.usage.promptTokens;
+      totalUsage.completionTokens += result.usage.completionTokens;
+      totalUsage.totalTokens += result.usage.totalTokens;
+      steps.push({
+        name: `map_doc_${i}`,
+        input: text.slice(0, 100) + "...",
+        output: result.content.slice(0, 100),
+        latencyMs: Date.now() - start
+      });
+    }
+    const combined = partialAnswers.join("\n\n");
+    const reducePrompt = `Based on the following extracted information, provide a comprehensive answer to the question.
+
+Extracted Information:
+${combined}
+
+Question: ${question}
+
+Answer:`;
+    const reduceStart = Date.now();
+    const finalResult = await this.llm.generate(reducePrompt, {
+      systemPrompt: this.systemPrompt,
+      temperature: 0.3
+    });
+    totalUsage.promptTokens += finalResult.usage.promptTokens;
+    totalUsage.completionTokens += finalResult.usage.completionTokens;
+    totalUsage.totalTokens += finalResult.usage.totalTokens;
+    steps.push({
+      name: "reduce_answer",
+      input: `${partialAnswers.length} partial answers`,
+      output: finalResult.content.slice(0, 200),
+      latencyMs: Date.now() - reduceStart
+    });
+    return { answer: finalResult.content, usage: totalUsage };
+  }
+  async refineQA(question, sources, steps) {
+    const totalUsage = { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
+    const firstText = sources[0]?.content ?? "";
+    const initialPrompt = `Document:
+${firstText}
+
+Question: ${question}
+
+Answer based on this document:`;
+    const initialStart = Date.now();
+    const initialResult = await this.llm.generate(initialPrompt, {
+      systemPrompt: this.systemPrompt,
+      temperature: 0.3
+    });
+    let currentAnswer = initialResult.content;
+    totalUsage.promptTokens += initialResult.usage.promptTokens;
+    totalUsage.completionTokens += initialResult.usage.completionTokens;
+    totalUsage.totalTokens += initialResult.usage.totalTokens;
+    steps.push({
+      name: "initial_answer",
+      input: firstText.slice(0, 100) + "...",
+      output: currentAnswer.slice(0, 100),
+      latencyMs: Date.now() - initialStart
+    });
+    for (let i = 1; i < sources.length; i++) {
+      const text = sources[i].content ?? "";
+      if (!text) continue;
+      const refinePrompt = `Existing answer:
+${currentAnswer}
+
+New document:
+${text}
+
+Question: ${question}
+
+Refine the existing answer using the new document. If the new document adds relevant information, incorporate it. If not, keep the existing answer:`;
+      const refineStart = Date.now();
+      const refineResult = await this.llm.generate(refinePrompt, {
+        systemPrompt: this.systemPrompt,
+        temperature: 0.3
+      });
+      currentAnswer = refineResult.content;
+      totalUsage.promptTokens += refineResult.usage.promptTokens;
+      totalUsage.completionTokens += refineResult.usage.completionTokens;
+      totalUsage.totalTokens += refineResult.usage.totalTokens;
+      steps.push({
+        name: `refine_${i}`,
+        input: text.slice(0, 100) + "...",
+        output: currentAnswer.slice(0, 100),
+        latencyMs: Date.now() - refineStart
+      });
+    }
+    return { answer: currentAnswer, usage: totalUsage };
+  }
+};
+
+exports.QAChain = QAChain;
+//# sourceMappingURL=chunk-M7MVFPKB.cjs.map
+//# sourceMappingURL=chunk-M7MVFPKB.cjs.map

package/dist/chunk-M7MVFPKB.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/chains/qa-chain.ts"],"names":[],"mappings":"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","file":"chunk-M7MVFPKB.cjs","sourcesContent":["import type { Retriever } from '../retrievers/types.js';\nimport type { LLMAdapter, VectorSearchResult } from '../types/index.js';\nimport type { ChainResult, QAChainOptions } from './types.js';\n\nexport class QAChain {\n  private llm: LLMAdapter;\n  private retriever: Retriever;\n  private collection: string;\n  private systemPrompt: string;\n  private returnSources: boolean;\n  private strategy: 'stuff' | 'map-reduce' | 'refine';\n  private maxSourceTokens: number;\n\n  constructor(options: QAChainOptions) {\n    this.llm = options.llm;\n    this.retriever = options.retriever;\n    this.collection = options.collection;\n    this.returnSources = options.returnSources ?? true;\n    this.strategy = options.strategy ?? 'stuff';\n    this.maxSourceTokens = options.maxSourceTokens ?? 3000;\n    this.systemPrompt = options.systemPrompt ??\n      'You are a helpful assistant. Answer the question based ONLY on the provided documents. Cite specific parts of the documents when possible. If the documents do not contain the answer, say so.';\n  }\n\n  async call(question: string): Promise<ChainResult> {\n    const steps: ChainResult['intermediateSteps'] = [];\n\n    // Step 1: Retrieve\n    const retrieveStart = Date.now();\n    const sources = await this.retriever.retrieve(question, this.collection);\n    steps.push({\n      name: 'retrieve',\n      input: question,\n      output: `Found ${sources.length} documents`,\n      latencyMs: Date.now() - retrieveStart,\n    });\n\n    if (sources.length === 0) {\n      return {\n        answer: 'No relevant documents found to answer this question.',\n        sources: [],\n        intermediateSteps: steps,\n      };\n    }\n\n    // Step 2: Answer based on strategy\n    let answer: string;\n    let usage = { promptTokens: 0, completionTokens: 0, totalTokens: 0 };\n\n    switch (this.strategy) {\n      case 'stuff':\n        ({ answer, usage } = await this.stuffQA(question, sources, steps));\n        break;\n      case 'map-reduce':\n        ({ answer, usage } = await this.mapReduceQA(question, sources, steps));\n        break;\n      case 'refine':\n        ({ answer, usage } = await this.refineQA(question, sources, steps));\n        break;\n    }\n\n    return {\n      answer,\n      sources: this.returnSources ? sources : undefined,\n      intermediateSteps: steps,\n      usage,\n    };\n  }\n\n  private async stuffQA(\n    question: string,\n    sources: VectorSearchResult[],\n    steps: ChainResult['intermediateSteps']\n  ): Promise<{ answer: string; usage: ChainResult['usage'] & Record<string, number> }> {\n    let context = '';\n    let tokenEstimate = 0;\n\n    for (const source of sources) {\n      const text = source.content ?? '';\n      const est = Math.ceil(text.length / 4);\n      if (tokenEstimate + est > this.maxSourceTokens) break;\n      context += `[Document ${source.id}]:\\n${text}\\n\\n`;\n      tokenEstimate += est;\n    }\n\n    const prompt = `Documents:\\n${context}\\nQuestion: ${question}\\n\\nProvide a detailed answer based on the documents above:`;\n\n    const start = Date.now();\n    const result = await this.llm.generate(prompt, {\n      systemPrompt: this.systemPrompt,\n      temperature: 0.3,\n    });\n    steps!.push({\n      name: 'stuff_answer',\n      input: `${sources.length} docs, question: ${question}`,\n      output: result.content.slice(0, 200),\n      latencyMs: Date.now() - start,\n    });\n\n    return { answer: result.content, usage: result.usage };\n  }\n\n  private async mapReduceQA(\n    question: string,\n    sources: VectorSearchResult[],\n    steps: ChainResult['intermediateSteps']\n  ): Promise<{ answer: string; usage: ChainResult['usage'] & Record<string, number> }> {\n    const totalUsage = { promptTokens: 0, completionTokens: 0, totalTokens: 0 };\n\n    // Map: extract relevant info from each document\n    const partialAnswers: string[] = [];\n\n    for (let i = 0; i < sources.length; i++) {\n      const text = sources[i].content ?? '';\n      if (!text) continue;\n\n      const prompt = `Document:\\n${text}\\n\\nQuestion: ${question}\\n\\nExtract any information from this document that is relevant to answering the question:`;\n\n      const start = Date.now();\n      const result = await this.llm.generate(prompt, {\n        systemPrompt: 'Extract relevant information concisely.',\n        temperature: 0,\n        maxTokens: 512,\n      });\n\n      partialAnswers.push(result.content);\n      totalUsage.promptTokens += result.usage.promptTokens;\n      totalUsage.completionTokens += result.usage.completionTokens;\n      totalUsage.totalTokens += result.usage.totalTokens;\n\n      steps!.push({\n        name: `map_doc_${i}`,\n        input: text.slice(0, 100) + '...',\n        output: result.content.slice(0, 100),\n        latencyMs: Date.now() - start,\n      });\n    }\n\n    // Reduce: combine partial answers\n    const combined = partialAnswers.join('\\n\\n');\n    const reducePrompt = `Based on the following extracted information, provide a comprehensive answer to the question.\\n\\nExtracted Information:\\n${combined}\\n\\nQuestion: ${question}\\n\\nAnswer:`;\n\n    const reduceStart = Date.now();\n    const finalResult = await this.llm.generate(reducePrompt, {\n      systemPrompt: this.systemPrompt,\n      temperature: 0.3,\n    });\n\n    totalUsage.promptTokens += finalResult.usage.promptTokens;\n    totalUsage.completionTokens += finalResult.usage.completionTokens;\n    totalUsage.totalTokens += finalResult.usage.totalTokens;\n\n    steps!.push({\n      name: 'reduce_answer',\n      input: `${partialAnswers.length} partial answers`,\n      output: finalResult.content.slice(0, 200),\n      latencyMs: Date.now() - reduceStart,\n    });\n\n    return { answer: finalResult.content, usage: totalUsage };\n  }\n\n  private async refineQA(\n    question: string,\n    sources: VectorSearchResult[],\n    steps: ChainResult['intermediateSteps']\n  ): Promise<{ answer: string; usage: ChainResult['usage'] & Record<string, number> }> {\n    const totalUsage = { promptTokens: 0, completionTokens: 0, totalTokens: 0 };\n\n    // Initial answer from first document\n    const firstText = sources[0]?.content ?? '';\n    const initialPrompt = `Document:\\n${firstText}\\n\\nQuestion: ${question}\\n\\nAnswer based on this document:`;\n\n    const initialStart = Date.now();\n    const initialResult = await this.llm.generate(initialPrompt, {\n      systemPrompt: this.systemPrompt,\n      temperature: 0.3,\n    });\n\n    let currentAnswer = initialResult.content;\n    totalUsage.promptTokens += initialResult.usage.promptTokens;\n    totalUsage.completionTokens += initialResult.usage.completionTokens;\n    totalUsage.totalTokens += initialResult.usage.totalTokens;\n\n    steps!.push({\n      name: 'initial_answer',\n      input: firstText.slice(0, 100) + '...',\n      output: currentAnswer.slice(0, 100),\n      latencyMs: Date.now() - initialStart,\n    });\n\n    // Refine with each subsequent document\n    for (let i = 1; i < sources.length; i++) {\n      const text = sources[i].content ?? '';\n      if (!text) continue;\n\n      const refinePrompt = `Existing answer:\\n${currentAnswer}\\n\\nNew document:\\n${text}\\n\\nQuestion: ${question}\\n\\nRefine the existing answer using the new document. If the new document adds relevant information, incorporate it. If not, keep the existing answer:`;\n\n      const refineStart = Date.now();\n      const refineResult = await this.llm.generate(refinePrompt, {\n        systemPrompt: this.systemPrompt,\n        temperature: 0.3,\n      });\n\n      currentAnswer = refineResult.content;\n      totalUsage.promptTokens += refineResult.usage.promptTokens;\n      totalUsage.completionTokens += refineResult.usage.completionTokens;\n      totalUsage.totalTokens += refineResult.usage.totalTokens;\n\n      steps!.push({\n        name: `refine_${i}`,\n        input: text.slice(0, 100) + '...',\n        output: currentAnswer.slice(0, 100),\n        latencyMs: Date.now() - refineStart,\n      });\n    }\n\n    return { answer: currentAnswer, usage: totalUsage };\n  }\n}\n"]}

package/dist/chunk-MEX4HRX3.js

@@ -0,0 +1,183 @@
+import { chunkDocuments } from './chunk-H7RWKHQR.js';
+import { generateId } from './chunk-T3WBONBO.js';
+
+// src/core/knowledge.ts
+var Knowledge = class {
+  llm;
+  vectorDB;
+  defaults;
+  collections = /* @__PURE__ */ new Map();
+  constructor(llm, vectorDB, defaults = {}) {
+    this.llm = llm;
+    this.vectorDB = vectorDB;
+    this.defaults = defaults;
+  }
+  async create(options) {
+    const {
+      name,
+      source,
+      chunkSize = this.defaults.chunkSize ?? 1e3,
+      chunkOverlap = this.defaults.chunkOverlap ?? 200,
+      metadata = {}
+    } = options;
+    const documents = await this.sourceToDocuments(source, metadata);
+    const chunks = chunkDocuments(documents, { chunkSize, chunkOverlap });
+    if (chunks.length === 0) {
+      throw new Error("No content to index");
+    }
+    const embeddings = await this.llm.embed(chunks.map((c) => c.content));
+    const dimension = embeddings[0].length;
+    await this.vectorDB.createCollection(name, { dimension, metric: "cosine" });
+    this.collections.set(name, { dimension });
+    const vectors = chunks.map((chunk, i) => ({
+      id: chunk.id,
+      vector: embeddings[i],
+      content: chunk.content,
+      metadata: {
+        ...chunk.metadata,
+        documentId: chunk.documentId,
+        chunkIndex: chunk.index
+      }
+    }));
+    const batchSize = 100;
+    for (let i = 0; i < vectors.length; i += batchSize) {
+      await this.vectorDB.upsert(name, vectors.slice(i, i + batchSize));
+    }
+    return {
+      name,
+      documentCount: documents.length,
+      chunkCount: chunks.length
+    };
+  }
+  async add(name, source, options = {}) {
+    const {
+      chunkSize = this.defaults.chunkSize ?? 1e3,
+      chunkOverlap = this.defaults.chunkOverlap ?? 200,
+      metadata = {}
+    } = options;
+    const documents = await this.sourceToDocuments(source, metadata);
+    const chunks = chunkDocuments(documents, { chunkSize, chunkOverlap });
+    if (chunks.length === 0) {
+      return { addedChunks: 0 };
+    }
+    const embeddings = await this.llm.embed(chunks.map((c) => c.content));
+    const vectors = chunks.map((chunk, i) => ({
+      id: chunk.id,
+      vector: embeddings[i],
+      content: chunk.content,
+      metadata: {
+        ...chunk.metadata,
+        documentId: chunk.documentId,
+        chunkIndex: chunk.index
+      }
+    }));
+    const batchSize = 100;
+    for (let i = 0; i < vectors.length; i += batchSize) {
+      await this.vectorDB.upsert(name, vectors.slice(i, i + batchSize));
+    }
+    return { addedChunks: chunks.length };
+  }
+  async search(name, query, options = {}) {
+    const { topK = this.defaults.topK ?? 5, minScore } = options;
+    const [queryEmbedding] = await this.llm.embed([query]);
+    return this.vectorDB.search(name, queryEmbedding, { topK, minScore });
+  }
+  async delete(name) {
+    await this.vectorDB.deleteCollection(name);
+    this.collections.delete(name);
+  }
+  async sourceToDocuments(source, baseMetadata) {
+    if (typeof source === "string") {
+      return [{
+        id: generateId(),
+        content: source,
+        metadata: baseMetadata
+      }];
+    }
+    if (Array.isArray(source)) {
+      if (source.length === 0) return [];
+      if (typeof source[0] === "string") {
+        return source.map((text) => ({
+          id: generateId(),
+          content: text,
+          metadata: baseMetadata
+        }));
+      }
+      return source.map((item) => ({
+        id: generateId(),
+        content: item.text,
+        metadata: { ...baseMetadata, ...item.metadata }
+      }));
+    }
+    if ("path" in source) {
+      const fs = await import('fs/promises');
+      const path = await import('path');
+      const stat = await fs.stat(source.path);
+      if (stat.isFile()) {
+        const content = await fs.readFile(source.path, "utf-8");
+        return [{
+          id: generateId(),
+          content,
+          metadata: { ...baseMetadata, sourcePath: source.path }
+        }];
+      }
+      if (stat.isDirectory()) {
+        const files = await fs.readdir(source.path);
+        const documents = [];
+        for (const file of files) {
+          const filePath = path.join(source.path, file);
+          const fileStat = await fs.stat(filePath);
+          if (fileStat.isFile() && this.isTextFile(file)) {
+            const content = await fs.readFile(filePath, "utf-8");
+            documents.push({
+              id: generateId(),
+              content,
+              metadata: { ...baseMetadata, sourcePath: filePath, fileName: file }
+            });
+          }
+        }
+        return documents;
+      }
+    }
+    if ("url" in source) {
+      const parsedUrl = new URL(source.url);
+      if (!["http:", "https:"].includes(parsedUrl.protocol)) {
+        throw new Error(`Unsupported URL protocol: ${parsedUrl.protocol}. Only http and https are allowed.`);
+      }
+      const controller = new AbortController();
+      const timeout = setTimeout(() => controller.abort(), 3e4);
+      try {
+        const response = await fetch(source.url, { signal: controller.signal });
+        if (!response.ok) {
+          throw new Error(`Failed to fetch URL: ${response.status} ${response.statusText}`);
+        }
+        const contentLength = response.headers.get("content-length");
+        if (contentLength && parseInt(contentLength) > 5e7) {
+          throw new Error("URL content exceeds 50MB limit");
+        }
+        const content = await response.text();
+        return [{
+          id: generateId(),
+          content,
+          metadata: { ...baseMetadata, sourceUrl: source.url }
+        }];
+      } catch (error) {
+        if (error.name === "AbortError") {
+          throw new Error(`URL fetch timed out after 30s: ${source.url}`);
+        }
+        throw error;
+      } finally {
+        clearTimeout(timeout);
+      }
+    }
+    throw new Error("Invalid source format");
+  }
+  isTextFile(filename) {
+    const textExtensions = [".txt", ".md", ".json", ".csv", ".html", ".xml", ".yaml", ".yml", ".js", ".ts", ".py", ".java", ".c", ".cpp", ".h", ".css", ".scss", ".sql"];
+    return textExtensions.some((ext) => filename.toLowerCase().endsWith(ext));
+  }
+};
+
+export { Knowledge };
+//# sourceMappingURL=chunk-MEX4HRX3.js.map
+//# sourceMappingURL=chunk-MEX4HRX3.js.map

package/dist/chunk-MEX4HRX3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/knowledge.ts"],"names":[],"mappings":"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","file":"chunk-MEX4HRX3.js","sourcesContent":["import type { \n  LLMAdapter, \n  VectorDBAdapter, \n  KnowledgeCreateOptions, \n  KnowledgeSource,\n  Document,\n  VectorSearchResult,\n  OrkaDefaults\n} from '../types/index.js';\nimport { chunkDocuments } from './chunker.js';\nimport { generateId } from '../utils/id.js';\n\nexport class Knowledge {\n  private llm: LLMAdapter;\n  private vectorDB: VectorDBAdapter;\n  private defaults: OrkaDefaults;\n  private collections: Map<string, { dimension: number }> = new Map();\n\n  constructor(llm: LLMAdapter, vectorDB: VectorDBAdapter, defaults: OrkaDefaults = {}) {\n    this.llm = llm;\n    this.vectorDB = vectorDB;\n    this.defaults = defaults;\n  }\n\n  async create(options: KnowledgeCreateOptions): Promise<{ name: string; documentCount: number; chunkCount: number }> {\n    const { \n      name, \n      source, \n      chunkSize = this.defaults.chunkSize ?? 1000,\n      chunkOverlap = this.defaults.chunkOverlap ?? 200,\n      metadata = {}\n    } = options;\n\n    const documents = await this.sourceToDocuments(source, metadata);\n    const chunks = chunkDocuments(documents, { chunkSize, chunkOverlap });\n\n    if (chunks.length === 0) {\n      throw new Error('No content to index');\n    }\n\n    const embeddings = await this.llm.embed(chunks.map(c => c.content));\n    const dimension = embeddings[0].length;\n\n    await this.vectorDB.createCollection(name, { dimension, metric: 'cosine' });\n    this.collections.set(name, { dimension });\n\n    const vectors = chunks.map((chunk, i) => ({\n      id: chunk.id,\n      vector: embeddings[i],\n      content: chunk.content,\n      metadata: {\n        ...chunk.metadata,\n        documentId: chunk.documentId,\n        chunkIndex: chunk.index,\n      },\n    }));\n\n    const batchSize = 100;\n    for (let i = 0; i < vectors.length; i += batchSize) {\n      await this.vectorDB.upsert(name, vectors.slice(i, i + batchSize));\n    }\n\n    return {\n      name,\n      documentCount: documents.length,\n      chunkCount: chunks.length,\n    };\n  }\n\n  async add(name: string, source: KnowledgeSource, options: { chunkSize?: number; chunkOverlap?: number; metadata?: Record<string, unknown> } = {}): Promise<{ addedChunks: number }> {\n    const { \n      chunkSize = this.defaults.chunkSize ?? 1000,\n      chunkOverlap = this.defaults.chunkOverlap ?? 200,\n      metadata = {}\n    } = options;\n\n    const documents = await this.sourceToDocuments(source, metadata);\n    const chunks = chunkDocuments(documents, { chunkSize, chunkOverlap });\n\n    if (chunks.length === 0) {\n      return { addedChunks: 0 };\n    }\n\n    const embeddings = await this.llm.embed(chunks.map(c => c.content));\n\n    const vectors = chunks.map((chunk, i) => ({\n      id: chunk.id,\n      vector: embeddings[i],\n      content: chunk.content,\n      metadata: {\n        ...chunk.metadata,\n        documentId: chunk.documentId,\n        chunkIndex: chunk.index,\n      },\n    }));\n\n    const batchSize = 100;\n    for (let i = 0; i < vectors.length; i += batchSize) {\n      await this.vectorDB.upsert(name, vectors.slice(i, i + batchSize));\n    }\n\n    return { addedChunks: chunks.length };\n  }\n\n  async search(name: string, query: string, options: { topK?: number; minScore?: number } = {}): Promise<VectorSearchResult[]> {\n    const { topK = this.defaults.topK ?? 5, minScore } = options;\n\n    const [queryEmbedding] = await this.llm.embed([query]);\n    \n    return this.vectorDB.search(name, queryEmbedding, { topK, minScore });\n  }\n\n  async delete(name: string): Promise<void> {\n    await this.vectorDB.deleteCollection(name);\n    this.collections.delete(name);\n  }\n\n  private async sourceToDocuments(source: KnowledgeSource, baseMetadata: Record<string, unknown>): Promise<Document[]> {\n    if (typeof source === 'string') {\n      return [{\n        id: generateId(),\n        content: source,\n        metadata: baseMetadata,\n      }];\n    }\n\n    if (Array.isArray(source)) {\n      if (source.length === 0) return [];\n      \n      if (typeof source[0] === 'string') {\n        return (source as string[]).map(text => ({\n          id: generateId(),\n          content: text,\n          metadata: baseMetadata,\n        }));\n      }\n\n      return (source as { text: string; metadata?: Record<string, unknown> }[]).map(item => ({\n        id: generateId(),\n        content: item.text,\n        metadata: { ...baseMetadata, ...item.metadata },\n      }));\n    }\n\n    if ('path' in source) {\n      const fs = await import('fs/promises');\n      const path = await import('path');\n      const stat = await fs.stat(source.path);\n      \n      if (stat.isFile()) {\n        const content = await fs.readFile(source.path, 'utf-8');\n        return [{\n          id: generateId(),\n          content,\n          metadata: { ...baseMetadata, sourcePath: source.path },\n        }];\n      }\n      \n      if (stat.isDirectory()) {\n        const files = await fs.readdir(source.path);\n        const documents: Document[] = [];\n        \n        for (const file of files) {\n          const filePath = path.join(source.path, file);\n          const fileStat = await fs.stat(filePath);\n          \n          if (fileStat.isFile() && this.isTextFile(file)) {\n            const content = await fs.readFile(filePath, 'utf-8');\n            documents.push({\n              id: generateId(),\n              content,\n              metadata: { ...baseMetadata, sourcePath: filePath, fileName: file },\n            });\n          }\n        }\n        \n        return documents;\n      }\n    }\n\n    if ('url' in source) {\n      const parsedUrl = new URL(source.url);\n      if (!['http:', 'https:'].includes(parsedUrl.protocol)) {\n        throw new Error(`Unsupported URL protocol: ${parsedUrl.protocol}. Only http and https are allowed.`);\n      }\n\n      const controller = new AbortController();\n      const timeout = setTimeout(() => controller.abort(), 30_000);\n\n      try {\n        const response = await fetch(source.url, { signal: controller.signal });\n\n        if (!response.ok) {\n          throw new Error(`Failed to fetch URL: ${response.status} ${response.statusText}`);\n        }\n\n        const contentLength = response.headers.get('content-length');\n        if (contentLength && parseInt(contentLength) > 50_000_000) {\n          throw new Error('URL content exceeds 50MB limit');\n        }\n\n        const content = await response.text();\n        return [{\n          id: generateId(),\n          content,\n          metadata: { ...baseMetadata, sourceUrl: source.url },\n        }];\n      } catch (error) {\n        if ((error as Error).name === 'AbortError') {\n          throw new Error(`URL fetch timed out after 30s: ${source.url}`);\n        }\n        throw error;\n      } finally {\n        clearTimeout(timeout);\n      }\n    }\n\n    throw new Error('Invalid source format');\n  }\n\n  private isTextFile(filename: string): boolean {\n    const textExtensions = ['.txt', '.md', '.json', '.csv', '.html', '.xml', '.yaml', '.yml', '.js', '.ts', '.py', '.java', '.c', '.cpp', '.h', '.css', '.scss', '.sql'];\n    return textExtensions.some(ext => filename.toLowerCase().endsWith(ext));\n  }\n}\n"]}

package/dist/chunk-MNBS3X7K.js

@@ -0,0 +1,33 @@
+// src/orchestration/router.ts
+var RouterLLM = class {
+  name = "router";
+  routes;
+  defaultAdapter;
+  constructor(config) {
+    this.routes = config.routes;
+    this.defaultAdapter = config.defaultAdapter;
+  }
+  async generate(prompt, options) {
+    const adapter = this.resolve(prompt, options);
+    const result = await adapter.generate(prompt, options);
+    return {
+      ...result,
+      model: `${adapter.name}/${result.model}`
+    };
+  }
+  async embed(texts) {
+    return this.defaultAdapter.embed(texts);
+  }
+  resolve(prompt, options) {
+    for (const route of this.routes) {
+      if (route.condition(prompt, options)) {
+        return route.adapter;
+      }
+    }
+    return this.defaultAdapter;
+  }
+};
+
+export { RouterLLM };
+//# sourceMappingURL=chunk-MNBS3X7K.js.map
+//# sourceMappingURL=chunk-MNBS3X7K.js.map

package/dist/chunk-MNBS3X7K.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/orchestration/router.ts"],"names":[],"mappings":";AAGO,IAAM,YAAN,MAAsC;AAAA,EAClC,IAAA,GAAO,QAAA;AAAA,EACR,MAAA;AAAA,EACA,cAAA;AAAA,EAER,YAAY,MAAA,EAAsB;AAChC,IAAA,IAAA,CAAK,SAAS,MAAA,CAAO,MAAA;AACrB,IAAA,IAAA,CAAK,iBAAiB,MAAA,CAAO,cAAA;AAAA,EAC/B;AAAA,EAEA,MAAM,QAAA,CAAS,MAAA,EAAgB,OAAA,EAAkD;AAC/E,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,OAAA,CAAQ,MAAA,EAAQ,OAAO,CAAA;AAC5C,IAAA,MAAM,MAAA,GAAS,MAAM,OAAA,CAAQ,QAAA,CAAS,QAAQ,OAAO,CAAA;AACrD,IAAA,OAAO;AAAA,MACL,GAAG,MAAA;AAAA,MACH,OAAO,CAAA,EAAG,OAAA,CAAQ,IAAI,CAAA,CAAA,EAAI,OAAO,KAAK,CAAA;AAAA,KACxC;AAAA,EACF;AAAA,EAEA,MAAM,MAAM,KAAA,EAA+C;AACzD,IAAA,OAAO,IAAA,CAAK,cAAA,CAAe,KAAA,CAAM,KAAK,CAAA;AAAA,EACxC;AAAA,EAEQ,OAAA,CAAQ,QAAgB,OAAA,EAA0C;AACxE,IAAA,KAAA,MAAW,KAAA,IAAS,KAAK,MAAA,EAAQ;AAC/B,MAAA,IAAI,KAAA,CAAM,SAAA,CAAU,MAAA,EAAQ,OAAO,CAAA,EAAG;AACpC,QAAA,OAAO,KAAA,CAAM,OAAA;AAAA,MACf;AAAA,IACF;AACA,IAAA,OAAO,IAAA,CAAK,cAAA;AAAA,EACd;AACF","file":"chunk-MNBS3X7K.js","sourcesContent":["import type { LLMAdapter, LLMGenerateOptions, LLMResult } from '../types/index.js';\nimport type { RouterConfig } from './types.js';\n\nexport class RouterLLM implements LLMAdapter {\n  readonly name = 'router';\n  private routes: RouterConfig['routes'];\n  private defaultAdapter: LLMAdapter;\n\n  constructor(config: RouterConfig) {\n    this.routes = config.routes;\n    this.defaultAdapter = config.defaultAdapter;\n  }\n\n  async generate(prompt: string, options?: LLMGenerateOptions): Promise<LLMResult> {\n    const adapter = this.resolve(prompt, options);\n    const result = await adapter.generate(prompt, options);\n    return {\n      ...result,\n      model: `${adapter.name}/${result.model}`,\n    };\n  }\n\n  async embed(texts: string | string[]): Promise<number[][]> {\n    return this.defaultAdapter.embed(texts);\n  }\n\n  private resolve(prompt: string, options?: LLMGenerateOptions): LLMAdapter {\n    for (const route of this.routes) {\n      if (route.condition(prompt, options)) {\n        return route.adapter;\n      }\n    }\n    return this.defaultAdapter;\n  }\n}\n"]}

package/dist/chunk-MO6VDGU4.js

@@ -0,0 +1,55 @@
+// src/cache/cached-embeddings.ts
+var CachedEmbeddings = class {
+  llm;
+  cache;
+  ttlMs;
+  hashFn;
+  constructor(llm, cache, options = {}) {
+    this.llm = llm;
+    this.cache = cache;
+    this.ttlMs = options.ttlMs;
+    this.hashFn = options.hashFn ?? this.defaultHash;
+  }
+  async embed(texts) {
+    const input = Array.isArray(texts) ? texts : [texts];
+    const results = new Array(input.length).fill(null);
+    const uncachedIndices = [];
+    const uncachedTexts = [];
+    for (let i = 0; i < input.length; i++) {
+      const cacheKey = `emb:${this.hashFn(input[i])}`;
+      const cached = await this.cache.get(cacheKey);
+      if (cached) {
+        results[i] = cached;
+      } else {
+        uncachedIndices.push(i);
+        uncachedTexts.push(input[i]);
+      }
+    }
+    if (uncachedTexts.length > 0) {
+      const embeddings = await this.llm.embed(uncachedTexts);
+      for (let j = 0; j < uncachedTexts.length; j++) {
+        const idx = uncachedIndices[j];
+        results[idx] = embeddings[j];
+        const cacheKey = `emb:${this.hashFn(uncachedTexts[j])}`;
+        await this.cache.set(cacheKey, embeddings[j], this.ttlMs);
+      }
+    }
+    return results;
+  }
+  async clearCache() {
+    await this.cache.clear();
+  }
+  defaultHash(text) {
+    let hash = 0;
+    for (let i = 0; i < text.length; i++) {
+      const char = text.charCodeAt(i);
+      hash = (hash << 5) - hash + char;
+      hash |= 0;
+    }
+    return Math.abs(hash).toString(36);
+  }
+};
+
+export { CachedEmbeddings };
+//# sourceMappingURL=chunk-MO6VDGU4.js.map
+//# sourceMappingURL=chunk-MO6VDGU4.js.map

package/dist/chunk-MO6VDGU4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cache/cached-embeddings.ts"],"names":[],"mappings":";AAGO,IAAM,mBAAN,MAAuB;AAAA,EACpB,GAAA;AAAA,EACA,KAAA;AAAA,EACA,KAAA;AAAA,EACA,MAAA;AAAA,EAER,WAAA,CAAY,GAAA,EAAiB,KAAA,EAAmB,OAAA,GAAiC,EAAC,EAAG;AACnF,IAAA,IAAA,CAAK,GAAA,GAAM,GAAA;AACX,IAAA,IAAA,CAAK,KAAA,GAAQ,KAAA;AACb,IAAA,IAAA,CAAK,QAAQ,OAAA,CAAQ,KAAA;AACrB,IAAA,IAAA,CAAK,MAAA,GAAS,OAAA,CAAQ,MAAA,IAAU,IAAA,CAAK,WAAA;AAAA,EACvC;AAAA,EAEA,MAAM,MAAM,KAAA,EAA+C;AACzD,IAAA,MAAM,QAAQ,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,GAAI,KAAA,GAAQ,CAAC,KAAK,CAAA;AACnD,IAAA,MAAM,UAA+B,IAAI,KAAA,CAAM,MAAM,MAAM,CAAA,CAAE,KAAK,IAAI,CAAA;AACtE,IAAA,MAAM,kBAA4B,EAAC;AACnC,IAAA,MAAM,gBAA0B,EAAC;AAGjC,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,KAAA,CAAM,QAAQ,CAAA,EAAA,EAAK;AACrC,MAAA,MAAM,WAAW,CAAA,IAAA,EAAO,IAAA,CAAK,OAAO,KAAA,CAAM,CAAC,CAAC,CAAC,CAAA,CAAA;AAC7C,MAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,KAAA,CAAM,IAAc,QAAQ,CAAA;AACtD,MAAA,IAAI,MAAA,EAAQ;AACV,QAAA,OAAA,CAAQ,CAAC,CAAA,GAAI,MAAA;AAAA,MACf,CAAA,MAAO;AACL,QAAA,eAAA,CAAgB,KAAK,CAAC,CAAA;AACtB,QAAA,aAAA,CAAc,IAAA,CAAK,KAAA,CAAM,CAAC,CAAC,CAAA;AAAA,MAC7B;AAAA,IACF;AAGA,IAAA,IAAI,aAAA,CAAc,SAAS,CAAA,EAAG;AAC5B,MAAA,MAAM,UAAA,GAAa,MAAM,IAAA,CAAK,GAAA,CAAI,MAAM,aAAa,CAAA;AAErD,MAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,aAAA,CAAc,QAAQ,CAAA,EAAA,EAAK;AAC7C,QAAA,MAAM,GAAA,GAAM,gBAAgB,CAAC,CAAA;AAC7B,QAAA,OAAA,CAAQ,GAAG,CAAA,GAAI,UAAA,CAAW,CAAC,CAAA;AAG3B,QAAA,MAAM,WAAW,CAAA,IAAA,EAAO,IAAA,CAAK,OAAO,aAAA,CAAc,CAAC,CAAC,CAAC,CAAA,CAAA;AACrD,QAAA,MAAM,IAAA,CAAK,MAAM,GAAA,CAAI,QAAA,EAAU,WAAW,CAAC,CAAA,EAAG,KAAK,KAAK,CAAA;AAAA,MAC1D;AAAA,IACF;AAEA,IAAA,OAAO,OAAA;AAAA,EACT;AAAA,EAEA,MAAM,UAAA,GAA4B;AAChC,IAAA,MAAM,IAAA,CAAK,MAAM,KAAA,EAAM;AAAA,EACzB;AAAA,EAEQ,YAAY,IAAA,EAAsB;AACxC,IAAA,IAAI,IAAA,GAAO,CAAA;AACX,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,IAAA,CAAK,QAAQ,CAAA,EAAA,EAAK;AACpC,MAAA,MAAM,IAAA,GAAO,IAAA,CAAK,UAAA,CAAW,CAAC,CAAA;AAC9B,MAAA,IAAA,GAAA,CAAS,IAAA,IAAQ,KAAK,IAAA,GAAQ,IAAA;AAC9B,MAAA,IAAA,IAAQ,CAAA;AAAA,IACV;AACA,IAAA,OAAO,IAAA,CAAK,GAAA,CAAI,IAAI,CAAA,CAAE,SAAS,EAAE,CAAA;AAAA,EACnC;AACF","file":"chunk-MO6VDGU4.js","sourcesContent":["import type { LLMAdapter } from '../types/index.js';\nimport type { CacheStore, EmbeddingCacheOptions } from './types.js';\n\nexport class CachedEmbeddings {\n  private llm: LLMAdapter;\n  private cache: CacheStore;\n  private ttlMs?: number;\n  private hashFn: (text: string) => string;\n\n  constructor(llm: LLMAdapter, cache: CacheStore, options: EmbeddingCacheOptions = {}) {\n    this.llm = llm;\n    this.cache = cache;\n    this.ttlMs = options.ttlMs;\n    this.hashFn = options.hashFn ?? this.defaultHash;\n  }\n\n  async embed(texts: string | string[]): Promise<number[][]> {\n    const input = Array.isArray(texts) ? texts : [texts];\n    const results: (number[] | null)[] = new Array(input.length).fill(null);\n    const uncachedIndices: number[] = [];\n    const uncachedTexts: string[] = [];\n\n    // Check cache for each text\n    for (let i = 0; i < input.length; i++) {\n      const cacheKey = `emb:${this.hashFn(input[i])}`;\n      const cached = await this.cache.get<number[]>(cacheKey);\n      if (cached) {\n        results[i] = cached;\n      } else {\n        uncachedIndices.push(i);\n        uncachedTexts.push(input[i]);\n      }\n    }\n\n    // Embed uncached texts in batch\n    if (uncachedTexts.length > 0) {\n      const embeddings = await this.llm.embed(uncachedTexts);\n\n      for (let j = 0; j < uncachedTexts.length; j++) {\n        const idx = uncachedIndices[j];\n        results[idx] = embeddings[j];\n\n        // Cache the result\n        const cacheKey = `emb:${this.hashFn(uncachedTexts[j])}`;\n        await this.cache.set(cacheKey, embeddings[j], this.ttlMs);\n      }\n    }\n\n    return results as number[][];\n  }\n\n  async clearCache(): Promise<void> {\n    await this.cache.clear();\n  }\n\n  private defaultHash(text: string): string {\n    let hash = 0;\n    for (let i = 0; i < text.length; i++) {\n      const char = text.charCodeAt(i);\n      hash = ((hash << 5) - hash) + char;\n      hash |= 0;\n    }\n    return Math.abs(hash).toString(36);\n  }\n}\n"]}