orkajs 1.0.0

package/dist/chunk-DI2UCZBJ.js

@@ -0,0 +1,195 @@
+// src/graph/graph-workflow.ts
+var GraphWorkflow = class {
+  config;
+  nodes;
+  adjacency;
+  llm;
+  vectorDB;
+  knowledge;
+  constructor(config, llm, vectorDB, knowledge) {
+    this.config = config;
+    this.llm = llm;
+    this.vectorDB = vectorDB;
+    this.knowledge = knowledge;
+    this.nodes = new Map(config.nodes.map((n) => [n.id, n]));
+    this.adjacency = /* @__PURE__ */ new Map();
+    for (const edge of config.edges) {
+      if (!this.adjacency.has(edge.from)) {
+        this.adjacency.set(edge.from, []);
+      }
+      this.adjacency.get(edge.from).push({ to: edge.to, label: edge.label });
+    }
+    this.validate();
+  }
+  async run(input) {
+    const startTime = Date.now();
+    const inputStr = typeof input === "string" ? input : input.input;
+    const inputMetadata = typeof input === "string" ? {} : input.metadata ?? {};
+    let ctx = {
+      input: inputStr,
+      output: "",
+      nodeOutputs: {},
+      context: [],
+      metadata: { ...inputMetadata },
+      llm: this.llm,
+      vectorDB: this.vectorDB,
+      knowledge: this.knowledge
+    };
+    const nodeResults = [];
+    const path = [];
+    const maxIterations = this.config.maxIterations ?? 50;
+    let iterations = 0;
+    const startNode = this.findStartNode();
+    let currentNodeId = startNode;
+    while (currentNodeId !== void 0 && iterations < maxIterations) {
+      iterations++;
+      const node = this.nodes.get(currentNodeId);
+      if (!node) throw new Error(`Node "${currentNodeId}" not found`);
+      path.push(currentNodeId);
+      if (node.type === "end") {
+        break;
+      }
+      const nodeStart = Date.now();
+      try {
+        if (node.type === "parallel" && node.parallelNodes) {
+          ctx = await this.executeParallel(node.parallelNodes, ctx);
+          nodeResults.push({
+            nodeId: currentNodeId,
+            type: "parallel",
+            output: `Executed ${node.parallelNodes.length} nodes in parallel`,
+            latencyMs: Date.now() - nodeStart
+          });
+        } else if (node.type === "action" && node.execute) {
+          ctx = await node.execute(ctx);
+          ctx.nodeOutputs[currentNodeId] = ctx.output;
+          nodeResults.push({
+            nodeId: currentNodeId,
+            type: "action",
+            output: ctx.output,
+            latencyMs: Date.now() - nodeStart
+          });
+        } else if (node.type === "condition" && node.condition) {
+          const branch = node.condition(ctx);
+          nodeResults.push({
+            nodeId: currentNodeId,
+            type: "condition",
+            output: `Branch: ${branch}`,
+            latencyMs: Date.now() - nodeStart,
+            metadata: { branch }
+          });
+          const condEdges = this.adjacency.get(currentNodeId) ?? [];
+          const matchedEdge = condEdges.find((e) => e.label === branch);
+          if (matchedEdge) {
+            currentNodeId = matchedEdge.to;
+            if (this.config.onNodeComplete) {
+              this.config.onNodeComplete(node.id, ctx);
+            }
+            continue;
+          }
+        } else if (node.type === "start") {
+          nodeResults.push({
+            nodeId: currentNodeId,
+            type: "start",
+            output: inputStr,
+            latencyMs: Date.now() - nodeStart
+          });
+        }
+        if (this.config.onNodeComplete) {
+          this.config.onNodeComplete(node.id, ctx);
+        }
+      } catch (error) {
+        if (this.config.onError) {
+          this.config.onError(error, currentNodeId);
+        }
+        throw new Error(`Graph node "${currentNodeId}" failed: ${error.message}`);
+      }
+      const nextEdges = this.adjacency.get(currentNodeId) ?? [];
+      if (nextEdges.length === 0) {
+        break;
+      }
+      currentNodeId = nextEdges[0].to;
+    }
+    if (iterations >= maxIterations) {
+      throw new Error(`Graph workflow "${this.config.name}" exceeded max iterations (${maxIterations})`);
+    }
+    return {
+      name: this.config.name,
+      input: inputStr,
+      output: ctx.output,
+      nodeResults,
+      path,
+      totalLatencyMs: Date.now() - startTime,
+      metadata: ctx.metadata
+    };
+  }
+  async executeParallel(nodeIds, ctx) {
+    const results = await Promise.all(
+      nodeIds.map(async (nodeId) => {
+        const node = this.nodes.get(nodeId);
+        if (!node || !node.execute) {
+          throw new Error(`Parallel node "${nodeId}" not found or has no execute function`);
+        }
+        const clonedCtx = {
+          ...ctx,
+          nodeOutputs: { ...ctx.nodeOutputs },
+          metadata: { ...ctx.metadata }
+        };
+        const result = await node.execute(clonedCtx);
+        return { nodeId, output: result.output, ctx: result };
+      })
+    );
+    for (const result of results) {
+      ctx.nodeOutputs[result.nodeId] = result.output;
+    }
+    ctx.output = results.map((r) => r.output).join("\n\n");
+    return ctx;
+  }
+  findStartNode() {
+    const startNode = this.config.nodes.find((n) => n.type === "start");
+    if (startNode) return startNode.id;
+    const targetNodes = new Set(this.config.edges.map((e) => e.to));
+    const sourceOnly = this.config.nodes.find((n) => !targetNodes.has(n.id));
+    if (sourceOnly) return sourceOnly.id;
+    return this.config.nodes[0].id;
+  }
+  validate() {
+    for (const edge of this.config.edges) {
+      if (!this.nodes.has(edge.from)) {
+        throw new Error(`Edge references unknown node "${edge.from}"`);
+      }
+      if (!this.nodes.has(edge.to)) {
+        throw new Error(`Edge references unknown node "${edge.to}"`);
+      }
+    }
+  }
+  getNodes() {
+    return [...this.nodes.values()];
+  }
+  getEdges() {
+    const edges = [];
+    for (const [from, targets] of this.adjacency.entries()) {
+      for (const target of targets) {
+        edges.push({ from, to: target.to, label: target.label });
+      }
+    }
+    return edges;
+  }
+  toMermaid() {
+    let mermaid = "graph TD\n";
+    for (const node of this.nodes.values()) {
+      const shape = node.type === "condition" ? `{${node.id}}` : node.type === "start" ? `((${node.id}))` : node.type === "end" ? `((${node.id}))` : `[${node.id}]`;
+      mermaid += `  ${node.id}${shape}
+`;
+    }
+    for (const edge of this.config.edges) {
+      const label = edge.label ? `|${edge.label}|` : "";
+      mermaid += `  ${edge.from} -->${label} ${edge.to}
+`;
+    }
+    return mermaid;
+  }
+};
+
+export { GraphWorkflow };
+//# sourceMappingURL=chunk-DI2UCZBJ.js.map
+//# sourceMappingURL=chunk-DI2UCZBJ.js.map

package/dist/chunk-DI2UCZBJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/graph/graph-workflow.ts"],"names":[],"mappings":"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","file":"chunk-DI2UCZBJ.js","sourcesContent":["import type { LLMAdapter, VectorDBAdapter } from '../types/index.js';\nimport type { Knowledge } from '../core/knowledge.js';\nimport type { \n  GraphConfig, \n  GraphContext, \n  GraphNode, \n  GraphResult, \n  GraphNodeResult \n} from './types.js';\n\nexport class GraphWorkflow {\n  private config: GraphConfig;\n  private nodes: Map<string, GraphNode>;\n  private adjacency: Map<string, Array<{ to: string; label?: string }>>;\n  private llm: LLMAdapter;\n  private vectorDB?: VectorDBAdapter;\n  private knowledge?: Knowledge;\n\n  constructor(\n    config: GraphConfig,\n    llm: LLMAdapter,\n    vectorDB?: VectorDBAdapter,\n    knowledge?: Knowledge,\n  ) {\n    this.config = config;\n    this.llm = llm;\n    this.vectorDB = vectorDB;\n    this.knowledge = knowledge;\n\n    this.nodes = new Map(config.nodes.map(n => [n.id, n]));\n    this.adjacency = new Map();\n\n    for (const edge of config.edges) {\n      if (!this.adjacency.has(edge.from)) {\n        this.adjacency.set(edge.from, []);\n      }\n      this.adjacency.get(edge.from)!.push({ to: edge.to, label: edge.label });\n    }\n\n    this.validate();\n  }\n\n  async run(input: string | { input: string; metadata?: Record<string, unknown> }): Promise<GraphResult> {\n    const startTime = Date.now();\n    const inputStr = typeof input === 'string' ? input : input.input;\n    const inputMetadata = typeof input === 'string' ? {} : (input.metadata ?? {});\n\n    let ctx: GraphContext = {\n      input: inputStr,\n      output: '',\n      nodeOutputs: {},\n      context: [],\n      metadata: { ...inputMetadata },\n      llm: this.llm,\n      vectorDB: this.vectorDB,\n      knowledge: this.knowledge,\n    };\n\n    const nodeResults: GraphNodeResult[] = [];\n    const path: string[] = [];\n    const maxIterations = this.config.maxIterations ?? 50;\n    let iterations = 0;\n\n    const startNode = this.findStartNode();\n    let currentNodeId: string | undefined = startNode;\n\n    while (currentNodeId !== undefined && iterations < maxIterations) {\n      iterations++;\n      const node = this.nodes.get(currentNodeId);\n      if (!node) throw new Error(`Node \"${currentNodeId}\" not found`);\n\n      path.push(currentNodeId);\n\n      if (node.type === 'end') {\n        break;\n      }\n\n      const nodeStart = Date.now();\n\n      try {\n        if (node.type === 'parallel' && node.parallelNodes) {\n          ctx = await this.executeParallel(node.parallelNodes, ctx);\n          nodeResults.push({\n            nodeId: currentNodeId,\n            type: 'parallel',\n            output: `Executed ${node.parallelNodes.length} nodes in parallel`,\n            latencyMs: Date.now() - nodeStart,\n          });\n        } else if (node.type === 'action' && node.execute) {\n          ctx = await node.execute(ctx);\n          ctx.nodeOutputs[currentNodeId] = ctx.output;\n          nodeResults.push({\n            nodeId: currentNodeId,\n            type: 'action',\n            output: ctx.output,\n            latencyMs: Date.now() - nodeStart,\n          });\n        } else if (node.type === 'condition' && node.condition) {\n          const branch = node.condition(ctx);\n          nodeResults.push({\n            nodeId: currentNodeId,\n            type: 'condition',\n            output: `Branch: ${branch}`,\n            latencyMs: Date.now() - nodeStart,\n            metadata: { branch },\n          });\n\n          const condEdges: Array<{ to: string; label?: string }> = this.adjacency.get(currentNodeId) ?? [];\n          const matchedEdge: { to: string; label?: string } | undefined = condEdges.find((e: { to: string; label?: string }) => e.label === branch);\n          if (matchedEdge) {\n            currentNodeId = matchedEdge.to;\n            if (this.config.onNodeComplete) {\n              this.config.onNodeComplete(node.id, ctx);\n            }\n            continue;\n          }\n        } else if (node.type === 'start') {\n          nodeResults.push({\n            nodeId: currentNodeId,\n            type: 'start',\n            output: inputStr,\n            latencyMs: Date.now() - nodeStart,\n          });\n        }\n\n        if (this.config.onNodeComplete) {\n          this.config.onNodeComplete(node.id, ctx);\n        }\n      } catch (error) {\n        if (this.config.onError) {\n          this.config.onError(error as Error, currentNodeId);\n        }\n        throw new Error(`Graph node \"${currentNodeId}\" failed: ${(error as Error).message}`);\n      }\n\n      const nextEdges: Array<{ to: string; label?: string }> = this.adjacency.get(currentNodeId) ?? [];\n      if (nextEdges.length === 0) {\n        break;\n      }\n      currentNodeId = nextEdges[0].to;\n    }\n\n    if (iterations >= maxIterations) {\n      throw new Error(`Graph workflow \"${this.config.name}\" exceeded max iterations (${maxIterations})`);\n    }\n\n    return {\n      name: this.config.name,\n      input: inputStr,\n      output: ctx.output,\n      nodeResults,\n      path,\n      totalLatencyMs: Date.now() - startTime,\n      metadata: ctx.metadata,\n    };\n  }\n\n  private async executeParallel(nodeIds: string[], ctx: GraphContext): Promise<GraphContext> {\n    const results = await Promise.all(\n      nodeIds.map(async (nodeId) => {\n        const node = this.nodes.get(nodeId);\n        if (!node || !node.execute) {\n          throw new Error(`Parallel node \"${nodeId}\" not found or has no execute function`);\n        }\n        const clonedCtx: GraphContext = {\n          ...ctx,\n          nodeOutputs: { ...ctx.nodeOutputs },\n          metadata: { ...ctx.metadata },\n        };\n        const result = await node.execute(clonedCtx);\n        return { nodeId, output: result.output, ctx: result };\n      })\n    );\n\n    for (const result of results) {\n      ctx.nodeOutputs[result.nodeId] = result.output;\n    }\n    ctx.output = results.map(r => r.output).join('\\n\\n');\n\n    return ctx;\n  }\n\n  private findStartNode(): string {\n    const startNode = this.config.nodes.find(n => n.type === 'start');\n    if (startNode) return startNode.id;\n\n    const targetNodes = new Set(this.config.edges.map(e => e.to));\n    const sourceOnly = this.config.nodes.find(n => !targetNodes.has(n.id));\n    if (sourceOnly) return sourceOnly.id;\n\n    return this.config.nodes[0].id;\n  }\n\n  private validate(): void {\n    for (const edge of this.config.edges) {\n      if (!this.nodes.has(edge.from)) {\n        throw new Error(`Edge references unknown node \"${edge.from}\"`);\n      }\n      if (!this.nodes.has(edge.to)) {\n        throw new Error(`Edge references unknown node \"${edge.to}\"`);\n      }\n    }\n  }\n\n  getNodes(): GraphNode[] {\n    return [...this.nodes.values()];\n  }\n\n  getEdges(): Array<{ from: string; to: string; label?: string }> {\n    const edges: Array<{ from: string; to: string; label?: string }> = [];\n    for (const [from, targets] of this.adjacency.entries()) {\n      for (const target of targets) {\n        edges.push({ from, to: target.to, label: target.label });\n      }\n    }\n    return edges;\n  }\n\n  toMermaid(): string {\n    let mermaid = 'graph TD\\n';\n    for (const node of this.nodes.values()) {\n      const shape = node.type === 'condition' ? `{${node.id}}` :\n                    node.type === 'start' ? `((${node.id}))` :\n                    node.type === 'end' ? `((${node.id}))` :\n                    `[${node.id}]`;\n      mermaid += `  ${node.id}${shape}\\n`;\n    }\n    for (const edge of this.config.edges) {\n      const label = edge.label ? `|${edge.label}|` : '';\n      mermaid += `  ${edge.from} -->${label} ${edge.to}\\n`;\n    }\n    return mermaid;\n  }\n}\n"]}

package/dist/chunk-DQKAPJQH.cjs

@@ -0,0 +1,57 @@
+'use strict';
+
+// 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);
+  }
+};
+
+exports.CachedEmbeddings = CachedEmbeddings;
+//# sourceMappingURL=chunk-DQKAPJQH.cjs.map
+//# sourceMappingURL=chunk-DQKAPJQH.cjs.map

package/dist/chunk-DQKAPJQH.cjs.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-DQKAPJQH.cjs","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"]}

package/dist/chunk-DSOJ45F4.js

@@ -0,0 +1,53 @@
+import { RecursiveCharacterTextSplitter } from './chunk-UVMJ5QSD.js';
+
+// src/splitters/markdown-text-splitter.ts
+var MARKDOWN_SEPARATORS = [
+  "\n## ",
+  // H2
+  "\n### ",
+  // H3
+  "\n#### ",
+  // H4
+  "\n##### ",
+  // H5
+  "\n###### ",
+  // H6
+  "\n```\n",
+  // Code blocks
+  "\n---\n",
+  // Horizontal rules
+  "\n***\n",
+  // Horizontal rules
+  "\n\n",
+  // Double newline (paragraphs)
+  "\n",
+  // Single newline
+  ". ",
+  // Sentences
+  " ",
+  // Words
+  ""
+  // Characters
+];
+var MarkdownTextSplitter = class {
+  splitter;
+  constructor(options = {}) {
+    this.splitter = new RecursiveCharacterTextSplitter({
+      chunkSize: options.chunkSize ?? 1e3,
+      chunkOverlap: options.chunkOverlap ?? 200,
+      separators: MARKDOWN_SEPARATORS,
+      keepSeparator: true,
+      trimWhitespace: options.trimWhitespace ?? true
+    });
+  }
+  split(text) {
+    return this.splitter.split(text);
+  }
+  splitDocuments(documents) {
+    return this.splitter.splitDocuments(documents);
+  }
+};
+
+export { MarkdownTextSplitter };
+//# sourceMappingURL=chunk-DSOJ45F4.js.map
+//# sourceMappingURL=chunk-DSOJ45F4.js.map

package/dist/chunk-DSOJ45F4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/splitters/markdown-text-splitter.ts"],"names":[],"mappings":";;;AAIA,IAAM,mBAAA,GAAsB;AAAA,EAC1B,OAAA;AAAA;AAAA,EACA,QAAA;AAAA;AAAA,EACA,SAAA;AAAA;AAAA,EACA,UAAA;AAAA;AAAA,EACA,WAAA;AAAA;AAAA,EACA,SAAA;AAAA;AAAA,EACA,SAAA;AAAA;AAAA,EACA,SAAA;AAAA;AAAA,EACA,MAAA;AAAA;AAAA,EACA,IAAA;AAAA;AAAA,EACA,IAAA;AAAA;AAAA,EACA,GAAA;AAAA;AAAA,EACA;AAAA;AACF,CAAA;AAEO,IAAM,uBAAN,MAAmD;AAAA,EAChD,QAAA;AAAA,EAER,WAAA,CAAY,OAAA,GAAuC,EAAC,EAAG;AACrD,IAAA,IAAA,CAAK,QAAA,GAAW,IAAI,8BAAA,CAA+B;AAAA,MACjD,SAAA,EAAW,QAAQ,SAAA,IAAa,GAAA;AAAA,MAChC,YAAA,EAAc,QAAQ,YAAA,IAAgB,GAAA;AAAA,MACtC,UAAA,EAAY,mBAAA;AAAA,MACZ,aAAA,EAAe,IAAA;AAAA,MACf,cAAA,EAAgB,QAAQ,cAAA,IAAkB;AAAA,KAC3C,CAAA;AAAA,EACH;AAAA,EAEA,MAAM,IAAA,EAAwB;AAC5B,IAAA,OAAO,IAAA,CAAK,QAAA,CAAS,KAAA,CAAM,IAAI,CAAA;AAAA,EACjC;AAAA,EAEA,eAAe,SAAA,EAAgC;AAC7C,IAAA,OAAO,IAAA,CAAK,QAAA,CAAS,cAAA,CAAe,SAAS,CAAA;AAAA,EAC/C;AACF","file":"chunk-DSOJ45F4.js","sourcesContent":["import type { Document, Chunk } from '../types/index.js';\nimport type { TextSplitter, MarkdownTextSplitterOptions } from './types.js';\nimport { RecursiveCharacterTextSplitter } from './recursive-character-text-splitter.js';\n\nconst MARKDOWN_SEPARATORS = [\n  '\\n## ',     // H2\n  '\\n### ',    // H3\n  '\\n#### ',   // H4\n  '\\n##### ',  // H5\n  '\\n###### ', // H6\n  '\\n```\\n',   // Code blocks\n  '\\n---\\n',   // Horizontal rules\n  '\\n***\\n',   // Horizontal rules\n  '\\n\\n',      // Double newline (paragraphs)\n  '\\n',        // Single newline\n  '. ',        // Sentences\n  ' ',         // Words\n  '',          // Characters\n];\n\nexport class MarkdownTextSplitter implements TextSplitter {\n  private splitter: RecursiveCharacterTextSplitter;\n\n  constructor(options: MarkdownTextSplitterOptions = {}) {\n    this.splitter = new RecursiveCharacterTextSplitter({\n      chunkSize: options.chunkSize ?? 1000,\n      chunkOverlap: options.chunkOverlap ?? 200,\n      separators: MARKDOWN_SEPARATORS,\n      keepSeparator: true,\n      trimWhitespace: options.trimWhitespace ?? true,\n    });\n  }\n\n  split(text: string): string[] {\n    return this.splitter.split(text);\n  }\n\n  splitDocuments(documents: Document[]): Chunk[] {\n    return this.splitter.splitDocuments(documents);\n  }\n}\n"]}

package/dist/chunk-DUN3CUY5.cjs

@@ -0,0 +1,105 @@
+'use strict';
+
+// src/chains/conversational-retrieval-chain.ts
+var ConversationalRetrievalChain = class {
+  llm;
+  retriever;
+  collection;
+  systemPrompt;
+  returnSources;
+  maxHistoryLength;
+  condenseQuestionPrompt;
+  chatHistory = [];
+  constructor(options) {
+    this.llm = options.llm;
+    this.retriever = options.retriever;
+    this.collection = options.collection;
+    this.returnSources = options.returnSources ?? true;
+    this.maxHistoryLength = options.maxHistoryLength ?? 10;
+    this.systemPrompt = options.systemPrompt ?? "You are a helpful assistant. Answer the question based on the provided context and conversation history. If the context does not contain enough information, say so clearly.";
+    this.condenseQuestionPrompt = options.condenseQuestionPrompt ?? `Given the following conversation history and a follow-up question, rephrase the follow-up question to be a standalone question that captures the full context.
+
+Chat History:
+{{history}}
+
+Follow-up Question: {{question}}
+
+Standalone Question:`;
+  }
+  async call(question) {
+    const steps = [];
+    let standaloneQuestion = question;
+    if (this.chatHistory.length > 0) {
+      const condenseStart = Date.now();
+      standaloneQuestion = await this.condenseQuestion(question);
+      steps.push({
+        name: "condense_question",
+        input: question,
+        output: standaloneQuestion,
+        latencyMs: Date.now() - condenseStart
+      });
+    }
+    const retrieveStart = Date.now();
+    const sources = await this.retriever.retrieve(standaloneQuestion, this.collection);
+    steps.push({
+      name: "retrieve",
+      input: standaloneQuestion,
+      output: `Found ${sources.length} relevant documents`,
+      latencyMs: Date.now() - retrieveStart
+    });
+    const context = sources.map((s) => s.content ?? "").filter((c) => c.length > 0).join("\n---\n");
+    const recentHistory = this.chatHistory.slice(-this.maxHistoryLength);
+    const historyStr = recentHistory.map((h) => `${h.role === "user" ? "Human" : "Assistant"}: ${h.content}`).join("\n");
+    const prompt = `Context:
+${context}
+
+${historyStr ? `Conversation History:
+${historyStr}
+
+` : ""}Question: ${question}
+
+Answer:`;
+    const generateStart = Date.now();
+    const result = await this.llm.generate(prompt, {
+      systemPrompt: this.systemPrompt,
+      temperature: 0.3
+    });
+    steps.push({
+      name: "generate",
+      input: prompt.slice(0, 200) + "...",
+      output: result.content.slice(0, 200),
+      latencyMs: Date.now() - generateStart
+    });
+    this.chatHistory.push({ role: "user", content: question });
+    this.chatHistory.push({ role: "assistant", content: result.content });
+    if (this.chatHistory.length > this.maxHistoryLength * 2) {
+      this.chatHistory = this.chatHistory.slice(-this.maxHistoryLength * 2);
+    }
+    return {
+      answer: result.content,
+      sources: this.returnSources ? sources : void 0,
+      intermediateSteps: steps,
+      usage: result.usage
+    };
+  }
+  getChatHistory() {
+    return [...this.chatHistory];
+  }
+  clearHistory() {
+    this.chatHistory = [];
+  }
+  async condenseQuestion(question) {
+    const recentHistory = this.chatHistory.slice(-this.maxHistoryLength);
+    const historyStr = recentHistory.map((h) => `${h.role === "user" ? "Human" : "Assistant"}: ${h.content}`).join("\n");
+    const prompt = this.condenseQuestionPrompt.replace("{{history}}", historyStr).replace("{{question}}", question);
+    const result = await this.llm.generate(prompt, {
+      temperature: 0,
+      maxTokens: 256
+    });
+    return result.content.trim() || question;
+  }
+};
+
+exports.ConversationalRetrievalChain = ConversationalRetrievalChain;
+//# sourceMappingURL=chunk-DUN3CUY5.cjs.map
+//# sourceMappingURL=chunk-DUN3CUY5.cjs.map

package/dist/chunk-DUN3CUY5.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/chains/conversational-retrieval-chain.ts"],"names":[],"mappings":"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","file":"chunk-DUN3CUY5.cjs","sourcesContent":["import type { Retriever } from '../retrievers/types.js';\nimport type { LLMAdapter } from '../types/index.js';\nimport type { ChainResult, ConversationalRetrievalChainOptions, ChatHistoryEntry } from './types.js';\n\nexport class ConversationalRetrievalChain {\n  private llm: LLMAdapter;\n  private retriever: Retriever;\n  private collection: string;\n  private systemPrompt: string;\n  private returnSources: boolean;\n  private maxHistoryLength: number;\n  private condenseQuestionPrompt: string;\n  private chatHistory: ChatHistoryEntry[] = [];\n\n  constructor(options: ConversationalRetrievalChainOptions) {\n    this.llm = options.llm;\n    this.retriever = options.retriever;\n    this.collection = options.collection;\n    this.returnSources = options.returnSources ?? true;\n    this.maxHistoryLength = options.maxHistoryLength ?? 10;\n    this.systemPrompt = options.systemPrompt ??\n      'You are a helpful assistant. Answer the question based on the provided context and conversation history. If the context does not contain enough information, say so clearly.';\n    this.condenseQuestionPrompt = options.condenseQuestionPrompt ??\n      `Given the following conversation history and a follow-up question, rephrase the follow-up question to be a standalone question that captures the full context.\n\nChat History:\n{{history}}\n\nFollow-up Question: {{question}}\n\nStandalone Question:`;\n  }\n\n  async call(question: string): Promise<ChainResult> {\n    const steps: ChainResult['intermediateSteps'] = [];\n\n    // Step 1: Condense question with chat history\n    let standaloneQuestion = question;\n\n    if (this.chatHistory.length > 0) {\n      const condenseStart = Date.now();\n      standaloneQuestion = await this.condenseQuestion(question);\n      steps.push({\n        name: 'condense_question',\n        input: question,\n        output: standaloneQuestion,\n        latencyMs: Date.now() - condenseStart,\n      });\n    }\n\n    // Step 2: Retrieve relevant documents\n    const retrieveStart = Date.now();\n    const sources = await this.retriever.retrieve(standaloneQuestion, this.collection);\n    steps.push({\n      name: 'retrieve',\n      input: standaloneQuestion,\n      output: `Found ${sources.length} relevant documents`,\n      latencyMs: Date.now() - retrieveStart,\n    });\n\n    // Step 3: Build context\n    const context = sources\n      .map(s => s.content ?? '')\n      .filter(c => c.length > 0)\n      .join('\\n---\\n');\n\n    // Step 4: Build conversation history string\n    const recentHistory = this.chatHistory.slice(-this.maxHistoryLength);\n    const historyStr = recentHistory\n      .map(h => `${h.role === 'user' ? 'Human' : 'Assistant'}: ${h.content}`)\n      .join('\\n');\n\n    // Step 5: Generate answer\n    const prompt = `Context:\\n${context}\\n\\n${historyStr ? `Conversation History:\\n${historyStr}\\n\\n` : ''}Question: ${question}\\n\\nAnswer:`;\n\n    const generateStart = Date.now();\n    const result = await this.llm.generate(prompt, {\n      systemPrompt: this.systemPrompt,\n      temperature: 0.3,\n    });\n    steps.push({\n      name: 'generate',\n      input: prompt.slice(0, 200) + '...',\n      output: result.content.slice(0, 200),\n      latencyMs: Date.now() - generateStart,\n    });\n\n    // Step 6: Update chat history\n    this.chatHistory.push({ role: 'user', content: question });\n    this.chatHistory.push({ role: 'assistant', content: result.content });\n\n    // Trim history if too long\n    if (this.chatHistory.length > this.maxHistoryLength * 2) {\n      this.chatHistory = this.chatHistory.slice(-this.maxHistoryLength * 2);\n    }\n\n    return {\n      answer: result.content,\n      sources: this.returnSources ? sources : undefined,\n      intermediateSteps: steps,\n      usage: result.usage,\n    };\n  }\n\n  getChatHistory(): ChatHistoryEntry[] {\n    return [...this.chatHistory];\n  }\n\n  clearHistory(): void {\n    this.chatHistory = [];\n  }\n\n  private async condenseQuestion(question: string): Promise<string> {\n    const recentHistory = this.chatHistory.slice(-this.maxHistoryLength);\n    const historyStr = recentHistory\n      .map(h => `${h.role === 'user' ? 'Human' : 'Assistant'}: ${h.content}`)\n      .join('\\n');\n\n    const prompt = this.condenseQuestionPrompt\n      .replace('{{history}}', historyStr)\n      .replace('{{question}}', question);\n\n    const result = await this.llm.generate(prompt, {\n      temperature: 0,\n      maxTokens: 256,\n    });\n\n    return result.content.trim() || question;\n  }\n}\n"]}