orkajs 1.0.0

package/dist/chunk-DWFNM3KU.js

@@ -0,0 +1,204 @@
+// src/workflow/steps.ts
+function plan(options = {}) {
+  return {
+    name: "plan",
+    async execute(ctx) {
+      const startTime = Date.now();
+      const prompt = options.prompt ?? `Analyze the following request and create a brief plan to answer it. Be concise.
+
+Request: ${ctx.input}`;
+      const result = await ctx.llm.generate(prompt, {
+        temperature: 0.3,
+        maxTokens: 512,
+        systemPrompt: "You are a planning assistant. Create concise, actionable plans."
+      });
+      ctx.output = result.content;
+      ctx.metadata.plan = result.content;
+      ctx.history.push({
+        stepName: "plan",
+        output: result.content,
+        latencyMs: Date.now() - startTime,
+        usage: {
+          promptTokens: result.usage.promptTokens,
+          completionTokens: result.usage.completionTokens,
+          totalTokens: result.usage.totalTokens
+        }
+      });
+      return ctx;
+    }
+  };
+}
+function retrieve(knowledgeName, options = {}) {
+  return {
+    name: "retrieve",
+    async execute(ctx) {
+      const startTime = Date.now();
+      if (!ctx.knowledge) {
+        throw new Error("Knowledge module not available in workflow context");
+      }
+      const query = ctx.metadata.plan ?? ctx.input;
+      const results = await ctx.knowledge.search(knowledgeName, query, {
+        topK: options.topK ?? 5,
+        minScore: options.minScore
+      });
+      ctx.context = results.map((r) => ({
+        content: r.content ?? "",
+        score: r.score,
+        metadata: r.metadata
+      }));
+      const contextText = ctx.context.map((c) => c.content).join("\n---\n");
+      ctx.output = contextText;
+      ctx.metadata.retrievedCount = results.length;
+      ctx.history.push({
+        stepName: "retrieve",
+        output: `Retrieved ${results.length} documents`,
+        latencyMs: Date.now() - startTime,
+        metadata: { documentCount: results.length }
+      });
+      return ctx;
+    }
+  };
+}
+function generate(options = {}) {
+  return {
+    name: "generate",
+    async execute(ctx) {
+      const startTime = Date.now();
+      let prompt = ctx.input;
+      if (ctx.context.length > 0) {
+        const contextText = ctx.context.map((c) => c.content).join("\n\n---\n\n");
+        prompt = `Context information:
+---
+${contextText}
+---
+
+Based on the context above, please answer:
+${ctx.input}`;
+      }
+      const result = await ctx.llm.generate(prompt, {
+        temperature: options.temperature ?? 0.7,
+        maxTokens: options.maxTokens ?? 1024,
+        systemPrompt: options.systemPrompt ?? "You are a helpful assistant. Answer based on the provided context. Do not make up information."
+      });
+      ctx.output = result.content;
+      ctx.history.push({
+        stepName: "generate",
+        output: result.content,
+        latencyMs: Date.now() - startTime,
+        usage: {
+          promptTokens: result.usage.promptTokens,
+          completionTokens: result.usage.completionTokens,
+          totalTokens: result.usage.totalTokens
+        }
+      });
+      return ctx;
+    }
+  };
+}
+function verify(options = {}) {
+  return {
+    name: "verify",
+    async execute(ctx) {
+      const startTime = Date.now();
+      const lastOutput = ctx.output;
+      const criteriaText = options.criteria?.length ? options.criteria.map((c, i) => `${i + 1}. ${c}`).join("\n") : "1. The answer is relevant to the question\n2. The answer is based on provided context\n3. The answer does not contain hallucinated information";
+      const contextText = ctx.context.length > 0 ? `
+Context:
+${ctx.context.map((c) => c.content).join("\n---\n")}` : "";
+      const prompt = `You are a quality verification judge. Evaluate the following answer.
+
+Question: ${ctx.input}
+${contextText}
+Answer: ${lastOutput}
+
+Criteria:
+${criteriaText}
+
+Respond in this exact JSON format:
+{"pass": true/false, "score": 0.0-1.0, "issues": ["issue1", "issue2"]}`;
+      const result = await ctx.llm.generate(prompt, {
+        temperature: 0,
+        maxTokens: 256,
+        systemPrompt: "You are a strict quality judge. Respond only with valid JSON."
+      });
+      let verification;
+      try {
+        const jsonMatch = result.content.match(/\{[\s\S]*\}/);
+        verification = JSON.parse(jsonMatch?.[0] ?? result.content);
+      } catch {
+        verification = { pass: true, score: 0.5, issues: ["Could not parse verification result"] };
+      }
+      ctx.metadata.verification = verification;
+      ctx.history.push({
+        stepName: "verify",
+        output: JSON.stringify(verification),
+        latencyMs: Date.now() - startTime,
+        usage: {
+          promptTokens: result.usage.promptTokens,
+          completionTokens: result.usage.completionTokens,
+          totalTokens: result.usage.totalTokens
+        },
+        metadata: verification
+      });
+      return ctx;
+    }
+  };
+}
+function improve(options = {}) {
+  return {
+    name: "improve",
+    async execute(ctx) {
+      const startTime = Date.now();
+      const verification = ctx.metadata.verification;
+      if (!verification || verification.pass) {
+        ctx.history.push({
+          stepName: "improve",
+          output: "No improvement needed",
+          latencyMs: Date.now() - startTime
+        });
+        return ctx;
+      }
+      const maxIter = options.maxIterations ?? 1;
+      let currentOutput = ctx.output;
+      for (let i = 0; i < maxIter; i++) {
+        const issues = verification.issues?.join("\n- ") ?? "Quality issues detected";
+        const contextText = ctx.context.length > 0 ? `
+Context:
+${ctx.context.map((c) => c.content).join("\n---\n")}` : "";
+        const prompt = `The following answer has quality issues that need to be fixed.
+
+Question: ${ctx.input}
+${contextText}
+Current answer: ${currentOutput}
+
+Issues to fix:
+- ${issues}
+
+Please provide an improved answer that addresses all the issues. Only output the improved answer, nothing else.`;
+        const result = await ctx.llm.generate(prompt, {
+          temperature: 0.3,
+          maxTokens: 1024,
+          systemPrompt: "You are a helpful assistant. Improve the answer based on the feedback."
+        });
+        currentOutput = result.content;
+      }
+      ctx.output = currentOutput;
+      ctx.history.push({
+        stepName: "improve",
+        output: currentOutput,
+        latencyMs: Date.now() - startTime
+      });
+      return ctx;
+    }
+  };
+}
+function custom(name, fn) {
+  return {
+    name,
+    execute: fn
+  };
+}
+
+export { custom, generate, improve, plan, retrieve, verify };
+//# sourceMappingURL=chunk-DWFNM3KU.js.map
+//# sourceMappingURL=chunk-DWFNM3KU.js.map

package/dist/chunk-DWFNM3KU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/workflow/steps.ts"],"names":[],"mappings":"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","file":"chunk-DWFNM3KU.js","sourcesContent":["import type { WorkflowStep, WorkflowContext } from './types.js';\n\nexport function plan(options: { prompt?: string } = {}): WorkflowStep {\n  return {\n    name: 'plan',\n    async execute(ctx: WorkflowContext): Promise<WorkflowContext> {\n      const startTime = Date.now();\n      const prompt = options.prompt ?? \n        `Analyze the following request and create a brief plan to answer it. Be concise.\\n\\nRequest: ${ctx.input}`;\n\n      const result = await ctx.llm.generate(prompt, {\n        temperature: 0.3,\n        maxTokens: 512,\n        systemPrompt: 'You are a planning assistant. Create concise, actionable plans.',\n      });\n\n      ctx.output = result.content;\n      ctx.metadata.plan = result.content;\n      ctx.history.push({\n        stepName: 'plan',\n        output: result.content,\n        latencyMs: Date.now() - startTime,\n        usage: {\n          promptTokens: result.usage.promptTokens,\n          completionTokens: result.usage.completionTokens,\n          totalTokens: result.usage.totalTokens,\n        },\n      });\n\n      return ctx;\n    },\n  };\n}\n\nexport function retrieve(knowledgeName: string, options: { topK?: number; minScore?: number } = {}): WorkflowStep {\n  return {\n    name: 'retrieve',\n    async execute(ctx: WorkflowContext): Promise<WorkflowContext> {\n      const startTime = Date.now();\n\n      if (!ctx.knowledge) {\n        throw new Error('Knowledge module not available in workflow context');\n      }\n\n      const query = ctx.metadata.plan as string ?? ctx.input;\n      const results = await ctx.knowledge.search(knowledgeName, query, {\n        topK: options.topK ?? 5,\n        minScore: options.minScore,\n      });\n\n      ctx.context = results.map(r => ({\n        content: r.content ?? '',\n        score: r.score,\n        metadata: r.metadata,\n      }));\n\n      const contextText = ctx.context.map(c => c.content).join('\\n---\\n');\n      ctx.output = contextText;\n      ctx.metadata.retrievedCount = results.length;\n\n      ctx.history.push({\n        stepName: 'retrieve',\n        output: `Retrieved ${results.length} documents`,\n        latencyMs: Date.now() - startTime,\n        metadata: { documentCount: results.length },\n      });\n\n      return ctx;\n    },\n  };\n}\n\nexport function generate(options: { systemPrompt?: string; temperature?: number; maxTokens?: number } = {}): WorkflowStep {\n  return {\n    name: 'generate',\n    async execute(ctx: WorkflowContext): Promise<WorkflowContext> {\n      const startTime = Date.now();\n\n      let prompt = ctx.input;\n      if (ctx.context.length > 0) {\n        const contextText = ctx.context.map(c => c.content).join('\\n\\n---\\n\\n');\n        prompt = `Context information:\\n---\\n${contextText}\\n---\\n\\nBased on the context above, please answer:\\n${ctx.input}`;\n      }\n\n      const result = await ctx.llm.generate(prompt, {\n        temperature: options.temperature ?? 0.7,\n        maxTokens: options.maxTokens ?? 1024,\n        systemPrompt: options.systemPrompt ?? 'You are a helpful assistant. Answer based on the provided context. Do not make up information.',\n      });\n\n      ctx.output = result.content;\n      ctx.history.push({\n        stepName: 'generate',\n        output: result.content,\n        latencyMs: Date.now() - startTime,\n        usage: {\n          promptTokens: result.usage.promptTokens,\n          completionTokens: result.usage.completionTokens,\n          totalTokens: result.usage.totalTokens,\n        },\n      });\n\n      return ctx;\n    },\n  };\n}\n\nexport function verify(options: { criteria?: string[] } = {}): WorkflowStep {\n  return {\n    name: 'verify',\n    async execute(ctx: WorkflowContext): Promise<WorkflowContext> {\n      const startTime = Date.now();\n      const lastOutput = ctx.output;\n\n      const criteriaText = options.criteria?.length\n        ? options.criteria.map((c, i) => `${i + 1}. ${c}`).join('\\n')\n        : '1. The answer is relevant to the question\\n2. The answer is based on provided context\\n3. The answer does not contain hallucinated information';\n\n      const contextText = ctx.context.length > 0\n        ? `\\nContext:\\n${ctx.context.map(c => c.content).join('\\n---\\n')}`\n        : '';\n\n      const prompt = `You are a quality verification judge. Evaluate the following answer.\n\nQuestion: ${ctx.input}\n${contextText}\nAnswer: ${lastOutput}\n\nCriteria:\n${criteriaText}\n\nRespond in this exact JSON format:\n{\"pass\": true/false, \"score\": 0.0-1.0, \"issues\": [\"issue1\", \"issue2\"]}`;\n\n      const result = await ctx.llm.generate(prompt, {\n        temperature: 0,\n        maxTokens: 256,\n        systemPrompt: 'You are a strict quality judge. Respond only with valid JSON.',\n      });\n\n      let verification: { pass: boolean; score: number; issues: string[] };\n      try {\n        const jsonMatch = result.content.match(/\\{[\\s\\S]*\\}/);\n        verification = JSON.parse(jsonMatch?.[0] ?? result.content);\n      } catch {\n        verification = { pass: true, score: 0.5, issues: ['Could not parse verification result'] };\n      }\n\n      ctx.metadata.verification = verification;\n      ctx.history.push({\n        stepName: 'verify',\n        output: JSON.stringify(verification),\n        latencyMs: Date.now() - startTime,\n        usage: {\n          promptTokens: result.usage.promptTokens,\n          completionTokens: result.usage.completionTokens,\n          totalTokens: result.usage.totalTokens,\n        },\n        metadata: verification,\n      });\n\n      return ctx;\n    },\n  };\n}\n\nexport function improve(options: { maxIterations?: number } = {}): WorkflowStep {\n  return {\n    name: 'improve',\n    async execute(ctx: WorkflowContext): Promise<WorkflowContext> {\n      const startTime = Date.now();\n      const verification = ctx.metadata.verification as { pass: boolean; score: number; issues: string[] } | undefined;\n\n      if (!verification || verification.pass) {\n        ctx.history.push({\n          stepName: 'improve',\n          output: 'No improvement needed',\n          latencyMs: Date.now() - startTime,\n        });\n        return ctx;\n      }\n\n      const maxIter = options.maxIterations ?? 1;\n      let currentOutput = ctx.output;\n\n      for (let i = 0; i < maxIter; i++) {\n        const issues = verification.issues?.join('\\n- ') ?? 'Quality issues detected';\n        const contextText = ctx.context.length > 0\n          ? `\\nContext:\\n${ctx.context.map(c => c.content).join('\\n---\\n')}`\n          : '';\n\n        const prompt = `The following answer has quality issues that need to be fixed.\n\nQuestion: ${ctx.input}\n${contextText}\nCurrent answer: ${currentOutput}\n\nIssues to fix:\n- ${issues}\n\nPlease provide an improved answer that addresses all the issues. Only output the improved answer, nothing else.`;\n\n        const result = await ctx.llm.generate(prompt, {\n          temperature: 0.3,\n          maxTokens: 1024,\n          systemPrompt: 'You are a helpful assistant. Improve the answer based on the feedback.',\n        });\n\n        currentOutput = result.content;\n      }\n\n      ctx.output = currentOutput;\n      ctx.history.push({\n        stepName: 'improve',\n        output: currentOutput,\n        latencyMs: Date.now() - startTime,\n      });\n\n      return ctx;\n    },\n  };\n}\n\nexport function custom(name: string, fn: (ctx: WorkflowContext) => Promise<WorkflowContext>): WorkflowStep {\n  return {\n    name,\n    execute: fn,\n  };\n}\n"]}

package/dist/chunk-DXJ5DNZP.cjs

@@ -0,0 +1,58 @@
+'use strict';
+
+// src/splitters/token-text-splitter.ts
+var TokenTextSplitter = class {
+  chunkSize;
+  chunkOverlap;
+  tokensPerChar;
+  constructor(options = {}) {
+    this.chunkSize = options.chunkSize ?? 500;
+    this.chunkOverlap = options.chunkOverlap ?? 50;
+    this.tokensPerChar = options.estimatedTokensPerChar ?? 0.25;
+    if (this.chunkOverlap >= this.chunkSize) {
+      throw new Error("chunkOverlap must be less than chunkSize");
+    }
+  }
+  split(text) {
+    const charChunkSize = Math.floor(this.chunkSize / this.tokensPerChar);
+    const charOverlap = Math.floor(this.chunkOverlap / this.tokensPerChar);
+    const chunks = [];
+    let start = 0;
+    while (start < text.length) {
+      let end = Math.min(start + charChunkSize, text.length);
+      if (end < text.length) {
+        const lastSpace = text.lastIndexOf(" ", end);
+        if (lastSpace > start) {
+          end = lastSpace;
+        }
+      }
+      const chunk = text.slice(start, end).trim();
+      if (chunk) {
+        chunks.push(chunk);
+      }
+      start = end - charOverlap;
+      if (start >= text.length) break;
+    }
+    return chunks;
+  }
+  splitDocuments(documents) {
+    const chunks = [];
+    for (const doc of documents) {
+      const textChunks = this.split(doc.content);
+      for (let i = 0; i < textChunks.length; i++) {
+        chunks.push({
+          id: `${doc.id}_chunk_${i}`,
+          content: textChunks[i],
+          documentId: doc.id,
+          index: i,
+          metadata: { ...doc.metadata }
+        });
+      }
+    }
+    return chunks;
+  }
+};
+
+exports.TokenTextSplitter = TokenTextSplitter;
+//# sourceMappingURL=chunk-DXJ5DNZP.cjs.map
+//# sourceMappingURL=chunk-DXJ5DNZP.cjs.map

package/dist/chunk-DXJ5DNZP.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/splitters/token-text-splitter.ts"],"names":[],"mappings":";;;AAGO,IAAM,oBAAN,MAAgD;AAAA,EAC7C,SAAA;AAAA,EACA,YAAA;AAAA,EACA,aAAA;AAAA,EAER,WAAA,CAAY,OAAA,GAAoC,EAAC,EAAG;AAClD,IAAA,IAAA,CAAK,SAAA,GAAY,QAAQ,SAAA,IAAa,GAAA;AACtC,IAAA,IAAA,CAAK,YAAA,GAAe,QAAQ,YAAA,IAAgB,EAAA;AAC5C,IAAA,IAAA,CAAK,aAAA,GAAgB,QAAQ,sBAAA,IAA0B,IAAA;AAEvD,IAAA,IAAI,IAAA,CAAK,YAAA,IAAgB,IAAA,CAAK,SAAA,EAAW;AACvC,MAAA,MAAM,IAAI,MAAM,0CAA0C,CAAA;AAAA,IAC5D;AAAA,EACF;AAAA,EAEA,MAAM,IAAA,EAAwB;AAC5B,IAAA,MAAM,gBAAgB,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,SAAA,GAAY,KAAK,aAAa,CAAA;AACpE,IAAA,MAAM,cAAc,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,YAAA,GAAe,KAAK,aAAa,CAAA;AAErE,IAAA,MAAM,SAAmB,EAAC;AAC1B,IAAA,IAAI,KAAA,GAAQ,CAAA;AAEZ,IAAA,OAAO,KAAA,GAAQ,KAAK,MAAA,EAAQ;AAC1B,MAAA,IAAI,MAAM,IAAA,CAAK,GAAA,CAAI,KAAA,GAAQ,aAAA,EAAe,KAAK,MAAM,CAAA;AAErD,MAAA,IAAI,GAAA,GAAM,KAAK,MAAA,EAAQ;AACrB,QAAA,MAAM,SAAA,GAAY,IAAA,CAAK,WAAA,CAAY,GAAA,EAAK,GAAG,CAAA;AAC3C,QAAA,IAAI,YAAY,KAAA,EAAO;AACrB,UAAA,GAAA,GAAM,SAAA;AAAA,QACR;AAAA,MACF;AAEA,MAAA,MAAM,QAAQ,IAAA,CAAK,KAAA,CAAM,KAAA,EAAO,GAAG,EAAE,IAAA,EAAK;AAC1C,MAAA,IAAI,KAAA,EAAO;AACT,QAAA,MAAA,CAAO,KAAK,KAAK,CAAA;AAAA,MACnB;AAEA,MAAA,KAAA,GAAQ,GAAA,GAAM,WAAA;AACd,MAAA,IAAI,KAAA,IAAS,KAAK,MAAA,EAAQ;AAAA,IAC5B;AAEA,IAAA,OAAO,MAAA;AAAA,EACT;AAAA,EAEA,eAAe,SAAA,EAAgC;AAC7C,IAAA,MAAM,SAAkB,EAAC;AAEzB,IAAA,KAAA,MAAW,OAAO,SAAA,EAAW;AAC3B,MAAA,MAAM,UAAA,GAAa,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,OAAO,CAAA;AAEzC,MAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,UAAA,CAAW,QAAQ,CAAA,EAAA,EAAK;AAC1C,QAAA,MAAA,CAAO,IAAA,CAAK;AAAA,UACV,EAAA,EAAI,CAAA,EAAG,GAAA,CAAI,EAAE,UAAU,CAAC,CAAA,CAAA;AAAA,UACxB,OAAA,EAAS,WAAW,CAAC,CAAA;AAAA,UACrB,YAAY,GAAA,CAAI,EAAA;AAAA,UAChB,KAAA,EAAO,CAAA;AAAA,UACP,QAAA,EAAU,EAAE,GAAG,GAAA,CAAI,QAAA;AAAS,SAC7B,CAAA;AAAA,MACH;AAAA,IACF;AAEA,IAAA,OAAO,MAAA;AAAA,EACT;AACF","file":"chunk-DXJ5DNZP.cjs","sourcesContent":["import type { Document, Chunk } from '../types/index.js';\nimport type { TextSplitter, TokenTextSplitterOptions } from './types.js';\n\nexport class TokenTextSplitter implements TextSplitter {\n  private chunkSize: number;\n  private chunkOverlap: number;\n  private tokensPerChar: number;\n\n  constructor(options: TokenTextSplitterOptions = {}) {\n    this.chunkSize = options.chunkSize ?? 500;\n    this.chunkOverlap = options.chunkOverlap ?? 50;\n    this.tokensPerChar = options.estimatedTokensPerChar ?? 0.25;\n\n    if (this.chunkOverlap >= this.chunkSize) {\n      throw new Error('chunkOverlap must be less than chunkSize');\n    }\n  }\n\n  split(text: string): string[] {\n    const charChunkSize = Math.floor(this.chunkSize / this.tokensPerChar);\n    const charOverlap = Math.floor(this.chunkOverlap / this.tokensPerChar);\n\n    const chunks: string[] = [];\n    let start = 0;\n\n    while (start < text.length) {\n      let end = Math.min(start + charChunkSize, text.length);\n\n      if (end < text.length) {\n        const lastSpace = text.lastIndexOf(' ', end);\n        if (lastSpace > start) {\n          end = lastSpace;\n        }\n      }\n\n      const chunk = text.slice(start, end).trim();\n      if (chunk) {\n        chunks.push(chunk);\n      }\n\n      start = end - charOverlap;\n      if (start >= text.length) break;\n    }\n\n    return chunks;\n  }\n\n  splitDocuments(documents: Document[]): Chunk[] {\n    const chunks: Chunk[] = [];\n\n    for (const doc of documents) {\n      const textChunks = this.split(doc.content);\n\n      for (let i = 0; i < textChunks.length; i++) {\n        chunks.push({\n          id: `${doc.id}_chunk_${i}`,\n          content: textChunks[i],\n          documentId: doc.id,\n          index: i,\n          metadata: { ...doc.metadata },\n        });\n      }\n    }\n\n    return chunks;\n  }\n}\n"]}

package/dist/chunk-E4VE4C7Q.js

@@ -0,0 +1,63 @@
+// src/retrievers/parent-document-retriever.ts
+var ParentDocumentRetriever = class {
+  vectorDB;
+  llm;
+  childTopK;
+  parentTopK;
+  minScore;
+  constructor(options) {
+    this.vectorDB = options.vectorDB;
+    this.llm = options.llm;
+    this.childTopK = options.childTopK ?? 10;
+    this.parentTopK = options.parentTopK ?? 3;
+    this.minScore = options.minScore;
+  }
+  async retrieve(query, collection) {
+    const [embedding] = await this.llm.embed([query]);
+    const childResults = await this.vectorDB.search(collection, embedding, {
+      topK: this.childTopK,
+      minScore: this.minScore
+    });
+    if (childResults.length === 0) return [];
+    const parentMap = /* @__PURE__ */ new Map();
+    for (const child of childResults) {
+      const parentId = child.metadata?.parentId ?? child.metadata?.documentId ?? child.id;
+      const existing = parentMap.get(parentId);
+      if (existing) {
+        existing.children.push(child);
+        existing.bestScore = Math.max(existing.bestScore, child.score);
+      } else {
+        parentMap.set(parentId, {
+          children: [child],
+          bestScore: child.score
+        });
+      }
+    }
+    const sortedParents = Array.from(parentMap.entries()).sort(([, a], [, b]) => b.bestScore - a.bestScore).slice(0, this.parentTopK);
+    const results = [];
+    for (const [parentId, { children, bestScore }] of sortedParents) {
+      const sortedChildren = children.sort((a, b) => {
+        const indexA = a.metadata?.chunkIndex ?? 0;
+        const indexB = b.metadata?.chunkIndex ?? 0;
+        return indexA - indexB;
+      });
+      const parentContent = sortedChildren[0]?.metadata?.parentContent;
+      const content = parentContent ? parentContent : sortedChildren.map((c) => c.content ?? "").join("\n\n");
+      results.push({
+        id: parentId,
+        score: bestScore,
+        content,
+        metadata: {
+          ...sortedChildren[0]?.metadata,
+          childCount: children.length,
+          retrieverType: "parent-document"
+        }
+      });
+    }
+    return results;
+  }
+};
+
+export { ParentDocumentRetriever };
+//# sourceMappingURL=chunk-E4VE4C7Q.js.map
+//# sourceMappingURL=chunk-E4VE4C7Q.js.map

package/dist/chunk-E4VE4C7Q.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/retrievers/parent-document-retriever.ts"],"names":[],"mappings":"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","file":"chunk-E4VE4C7Q.js","sourcesContent":["import type { VectorSearchResult, LLMAdapter, VectorDBAdapter } from '../types/index.js';\nimport type { Retriever, ParentDocumentRetrieverOptions } from './types.js';\n\nexport class ParentDocumentRetriever implements Retriever {\n  private vectorDB: VectorDBAdapter;\n  private llm: LLMAdapter;\n  private childTopK: number;\n  private parentTopK: number;\n  private minScore?: number;\n\n  constructor(options: ParentDocumentRetrieverOptions) {\n    this.vectorDB = options.vectorDB;\n    this.llm = options.llm;\n    this.childTopK = options.childTopK ?? 10;\n    this.parentTopK = options.parentTopK ?? 3;\n    this.minScore = options.minScore;\n  }\n\n  async retrieve(query: string, collection: string): Promise<VectorSearchResult[]> {\n    const [embedding] = await this.llm.embed([query]);\n\n    // Step 1: Search for child chunks (small, precise)\n    const childResults = await this.vectorDB.search(collection, embedding, {\n      topK: this.childTopK,\n      minScore: this.minScore,\n    });\n\n    if (childResults.length === 0) return [];\n\n    // Step 2: Group by parent document ID\n    const parentMap = new Map<string, {\n      children: VectorSearchResult[];\n      bestScore: number;\n    }>();\n\n    for (const child of childResults) {\n      const parentId = (child.metadata?.parentId as string) ?? (child.metadata?.documentId as string) ?? child.id;\n\n      const existing = parentMap.get(parentId);\n      if (existing) {\n        existing.children.push(child);\n        existing.bestScore = Math.max(existing.bestScore, child.score);\n      } else {\n        parentMap.set(parentId, {\n          children: [child],\n          bestScore: child.score,\n        });\n      }\n    }\n\n    // Step 3: Sort parents by best child score and take top N\n    const sortedParents = Array.from(parentMap.entries())\n      .sort(([, a], [, b]) => b.bestScore - a.bestScore)\n      .slice(0, this.parentTopK);\n\n    // Step 4: Reconstruct parent context from children\n    const results: VectorSearchResult[] = [];\n\n    for (const [parentId, { children, bestScore }] of sortedParents) {\n      // Sort children by their index/position within the parent\n      const sortedChildren = children.sort((a, b) => {\n        const indexA = (a.metadata?.chunkIndex as number) ?? 0;\n        const indexB = (b.metadata?.chunkIndex as number) ?? 0;\n        return indexA - indexB;\n      });\n\n      // If parent content is stored in metadata, use it\n      const parentContent = sortedChildren[0]?.metadata?.parentContent as string | undefined;\n\n      const content = parentContent\n        ? parentContent\n        : sortedChildren.map(c => c.content ?? '').join('\\n\\n');\n\n      results.push({\n        id: parentId,\n        score: bestScore,\n        content,\n        metadata: {\n          ...sortedChildren[0]?.metadata,\n          childCount: children.length,\n          retrieverType: 'parent-document',\n        },\n      });\n    }\n\n    return results;\n  }\n}\n"]}

package/dist/chunk-EAMPIWJ6.js

@@ -0,0 +1,122 @@
+import { builtinMetrics } from './chunk-GZQAPKRD.js';
+
+// src/evaluation/evaluator.ts
+var Evaluator = class {
+  orka;
+  llm;
+  constructor(orka, llm) {
+    this.orka = orka;
+    this.llm = llm;
+  }
+  async evaluate(options) {
+    const {
+      dataset,
+      metrics = ["relevance", "faithfulness"],
+      concurrency = 1,
+      onResult
+    } = options;
+    const resolvedMetrics = this.resolveMetrics(metrics);
+    const results = [];
+    const batches = this.chunk(dataset, concurrency);
+    for (const batch of batches) {
+      const batchResults = await Promise.all(
+        batch.map(async (evalCase) => {
+          const startTime = Date.now();
+          const askResult = await this.orka.ask({
+            knowledge: evalCase.knowledge,
+            question: evalCase.input,
+            includeContext: true
+          });
+          const contextTexts = askResult.context?.map((c) => c.content) ?? evalCase.context ?? [];
+          const metricResults = [];
+          for (const metricFn of resolvedMetrics) {
+            const metricResult = await metricFn({
+              input: evalCase.input,
+              output: askResult.answer,
+              expectedOutput: evalCase.expectedOutput,
+              context: contextTexts,
+              llm: this.llm
+            });
+            metricResults.push(metricResult);
+          }
+          const costMetric = metricResults.find((m) => m.name === "cost");
+          if (costMetric) {
+            costMetric.score = askResult.usage.totalTokens;
+            costMetric.details = {
+              promptTokens: askResult.usage.promptTokens,
+              completionTokens: askResult.usage.completionTokens,
+              totalTokens: askResult.usage.totalTokens
+            };
+          }
+          const evalResult = {
+            input: evalCase.input,
+            output: askResult.answer,
+            expectedOutput: evalCase.expectedOutput,
+            metrics: metricResults,
+            latencyMs: Date.now() - startTime,
+            usage: {
+              promptTokens: askResult.usage.promptTokens,
+              completionTokens: askResult.usage.completionTokens,
+              totalTokens: askResult.usage.totalTokens
+            }
+          };
+          return evalResult;
+        })
+      );
+      for (const result of batchResults) {
+        results.push(result);
+        if (onResult) {
+          onResult(result, results.length - 1);
+        }
+      }
+    }
+    return this.buildSummary(results);
+  }
+  resolveMetrics(metrics) {
+    return metrics.map((m) => {
+      if (typeof m === "function") return m;
+      const builtin = builtinMetrics[m];
+      if (!builtin) {
+        throw new Error(`Unknown metric: "${m}". Available: ${Object.keys(builtinMetrics).join(", ")}`);
+      }
+      return builtin;
+    });
+  }
+  buildSummary(results) {
+    const metricsMap = {};
+    for (const result of results) {
+      for (const metric of result.metrics) {
+        if (!metricsMap[metric.name]) {
+          metricsMap[metric.name] = [];
+        }
+        metricsMap[metric.name].push(metric.score);
+      }
+    }
+    const metricsSummary = {};
+    for (const [name, scores] of Object.entries(metricsMap)) {
+      metricsSummary[name] = {
+        average: scores.reduce((a, b) => a + b, 0) / scores.length,
+        min: Math.min(...scores),
+        max: Math.max(...scores)
+      };
+    }
+    return {
+      totalCases: results.length,
+      averageLatencyMs: results.reduce((a, b) => a + b.latencyMs, 0) / results.length,
+      totalTokens: results.reduce((a, b) => a + b.usage.totalTokens, 0),
+      metrics: metricsSummary,
+      results
+    };
+  }
+  chunk(arr, size) {
+    const chunks = [];
+    for (let i = 0; i < arr.length; i += size) {
+      chunks.push(arr.slice(i, i + size));
+    }
+    return chunks;
+  }
+};
+
+export { Evaluator };
+//# sourceMappingURL=chunk-EAMPIWJ6.js.map
+//# sourceMappingURL=chunk-EAMPIWJ6.js.map

package/dist/chunk-EAMPIWJ6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/evaluation/evaluator.ts"],"names":[],"mappings":"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","file":"chunk-EAMPIWJ6.js","sourcesContent":["import type { LLMAdapter } from '../types/index.js';\nimport type { Orka } from '../core/orka.js';\nimport type { \n  EvalCase, \n  EvalResult, \n  EvalSummary, \n  MetricFn, \n  MetricResult \n} from './metrics.js';\nimport { builtinMetrics } from './metrics.js';\n\nexport interface EvaluateOptions {\n  dataset: EvalCase[];\n  metrics?: (string | MetricFn)[];\n  concurrency?: number;\n  onResult?: (result: EvalResult, index: number) => void;\n}\n\nexport class Evaluator {\n  private orka: Orka;\n  private llm: LLMAdapter;\n\n  constructor(orka: Orka, llm: LLMAdapter) {\n    this.orka = orka;\n    this.llm = llm;\n  }\n\n  async evaluate(options: EvaluateOptions): Promise<EvalSummary> {\n    const { \n      dataset, \n      metrics = ['relevance', 'faithfulness'],\n      concurrency = 1,\n      onResult,\n    } = options;\n\n    const resolvedMetrics = this.resolveMetrics(metrics);\n    const results: EvalResult[] = [];\n\n    const batches = this.chunk(dataset, concurrency);\n\n    for (const batch of batches) {\n      const batchResults = await Promise.all(\n        batch.map(async (evalCase) => {\n          const startTime = Date.now();\n\n          const askResult = await this.orka.ask({\n            knowledge: evalCase.knowledge,\n            question: evalCase.input,\n            includeContext: true,\n          });\n\n          const contextTexts = askResult.context?.map(c => c.content) ?? evalCase.context ?? [];\n\n          const metricResults: MetricResult[] = [];\n          for (const metricFn of resolvedMetrics) {\n            const metricResult = await metricFn({\n              input: evalCase.input,\n              output: askResult.answer,\n              expectedOutput: evalCase.expectedOutput,\n              context: contextTexts,\n              llm: this.llm,\n            });\n            metricResults.push(metricResult);\n          }\n\n          const costMetric = metricResults.find(m => m.name === 'cost');\n          if (costMetric) {\n            costMetric.score = askResult.usage.totalTokens;\n            costMetric.details = {\n              promptTokens: askResult.usage.promptTokens,\n              completionTokens: askResult.usage.completionTokens,\n              totalTokens: askResult.usage.totalTokens,\n            };\n          }\n\n          const evalResult: EvalResult = {\n            input: evalCase.input,\n            output: askResult.answer,\n            expectedOutput: evalCase.expectedOutput,\n            metrics: metricResults,\n            latencyMs: Date.now() - startTime,\n            usage: {\n              promptTokens: askResult.usage.promptTokens,\n              completionTokens: askResult.usage.completionTokens,\n              totalTokens: askResult.usage.totalTokens,\n            },\n          };\n\n          return evalResult;\n        })\n      );\n\n      for (const result of batchResults) {\n        results.push(result);\n        if (onResult) {\n          onResult(result, results.length - 1);\n        }\n      }\n    }\n\n    return this.buildSummary(results);\n  }\n\n  private resolveMetrics(metrics: (string | MetricFn)[]): MetricFn[] {\n    return metrics.map(m => {\n      if (typeof m === 'function') return m;\n      const builtin = builtinMetrics[m];\n      if (!builtin) {\n        throw new Error(`Unknown metric: \"${m}\". Available: ${Object.keys(builtinMetrics).join(', ')}`);\n      }\n      return builtin;\n    });\n  }\n\n  private buildSummary(results: EvalResult[]): EvalSummary {\n    const metricsMap: Record<string, number[]> = {};\n\n    for (const result of results) {\n      for (const metric of result.metrics) {\n        if (!metricsMap[metric.name]) {\n          metricsMap[metric.name] = [];\n        }\n        metricsMap[metric.name].push(metric.score);\n      }\n    }\n\n    const metricsSummary: Record<string, { average: number; min: number; max: number }> = {};\n    for (const [name, scores] of Object.entries(metricsMap)) {\n      metricsSummary[name] = {\n        average: scores.reduce((a, b) => a + b, 0) / scores.length,\n        min: Math.min(...scores),\n        max: Math.max(...scores),\n      };\n    }\n\n    return {\n      totalCases: results.length,\n      averageLatencyMs: results.reduce((a, b) => a + b.latencyMs, 0) / results.length,\n      totalTokens: results.reduce((a, b) => a + b.usage.totalTokens, 0),\n      metrics: metricsSummary,\n      results,\n    };\n  }\n\n  private chunk<T>(arr: T[], size: number): T[][] {\n    const chunks: T[][] = [];\n    for (let i = 0; i < arr.length; i += size) {\n      chunks.push(arr.slice(i, i + size));\n    }\n    return chunks;\n  }\n}\n"]}

package/dist/chunk-EDDKTQDL.js

@@ -0,0 +1,56 @@
+// src/splitters/token-text-splitter.ts
+var TokenTextSplitter = class {
+  chunkSize;
+  chunkOverlap;
+  tokensPerChar;
+  constructor(options = {}) {
+    this.chunkSize = options.chunkSize ?? 500;
+    this.chunkOverlap = options.chunkOverlap ?? 50;
+    this.tokensPerChar = options.estimatedTokensPerChar ?? 0.25;
+    if (this.chunkOverlap >= this.chunkSize) {
+      throw new Error("chunkOverlap must be less than chunkSize");
+    }
+  }
+  split(text) {
+    const charChunkSize = Math.floor(this.chunkSize / this.tokensPerChar);
+    const charOverlap = Math.floor(this.chunkOverlap / this.tokensPerChar);
+    const chunks = [];
+    let start = 0;
+    while (start < text.length) {
+      let end = Math.min(start + charChunkSize, text.length);
+      if (end < text.length) {
+        const lastSpace = text.lastIndexOf(" ", end);
+        if (lastSpace > start) {
+          end = lastSpace;
+        }
+      }
+      const chunk = text.slice(start, end).trim();
+      if (chunk) {
+        chunks.push(chunk);
+      }
+      start = end - charOverlap;
+      if (start >= text.length) break;
+    }
+    return chunks;
+  }
+  splitDocuments(documents) {
+    const chunks = [];
+    for (const doc of documents) {
+      const textChunks = this.split(doc.content);
+      for (let i = 0; i < textChunks.length; i++) {
+        chunks.push({
+          id: `${doc.id}_chunk_${i}`,
+          content: textChunks[i],
+          documentId: doc.id,
+          index: i,
+          metadata: { ...doc.metadata }
+        });
+      }
+    }
+    return chunks;
+  }
+};
+
+export { TokenTextSplitter };
+//# sourceMappingURL=chunk-EDDKTQDL.js.map
+//# sourceMappingURL=chunk-EDDKTQDL.js.map

package/dist/chunk-EDDKTQDL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/splitters/token-text-splitter.ts"],"names":[],"mappings":";AAGO,IAAM,oBAAN,MAAgD;AAAA,EAC7C,SAAA;AAAA,EACA,YAAA;AAAA,EACA,aAAA;AAAA,EAER,WAAA,CAAY,OAAA,GAAoC,EAAC,EAAG;AAClD,IAAA,IAAA,CAAK,SAAA,GAAY,QAAQ,SAAA,IAAa,GAAA;AACtC,IAAA,IAAA,CAAK,YAAA,GAAe,QAAQ,YAAA,IAAgB,EAAA;AAC5C,IAAA,IAAA,CAAK,aAAA,GAAgB,QAAQ,sBAAA,IAA0B,IAAA;AAEvD,IAAA,IAAI,IAAA,CAAK,YAAA,IAAgB,IAAA,CAAK,SAAA,EAAW;AACvC,MAAA,MAAM,IAAI,MAAM,0CAA0C,CAAA;AAAA,IAC5D;AAAA,EACF;AAAA,EAEA,MAAM,IAAA,EAAwB;AAC5B,IAAA,MAAM,gBAAgB,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,SAAA,GAAY,KAAK,aAAa,CAAA;AACpE,IAAA,MAAM,cAAc,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,YAAA,GAAe,KAAK,aAAa,CAAA;AAErE,IAAA,MAAM,SAAmB,EAAC;AAC1B,IAAA,IAAI,KAAA,GAAQ,CAAA;AAEZ,IAAA,OAAO,KAAA,GAAQ,KAAK,MAAA,EAAQ;AAC1B,MAAA,IAAI,MAAM,IAAA,CAAK,GAAA,CAAI,KAAA,GAAQ,aAAA,EAAe,KAAK,MAAM,CAAA;AAErD,MAAA,IAAI,GAAA,GAAM,KAAK,MAAA,EAAQ;AACrB,QAAA,MAAM,SAAA,GAAY,IAAA,CAAK,WAAA,CAAY,GAAA,EAAK,GAAG,CAAA;AAC3C,QAAA,IAAI,YAAY,KAAA,EAAO;AACrB,UAAA,GAAA,GAAM,SAAA;AAAA,QACR;AAAA,MACF;AAEA,MAAA,MAAM,QAAQ,IAAA,CAAK,KAAA,CAAM,KAAA,EAAO,GAAG,EAAE,IAAA,EAAK;AAC1C,MAAA,IAAI,KAAA,EAAO;AACT,QAAA,MAAA,CAAO,KAAK,KAAK,CAAA;AAAA,MACnB;AAEA,MAAA,KAAA,GAAQ,GAAA,GAAM,WAAA;AACd,MAAA,IAAI,KAAA,IAAS,KAAK,MAAA,EAAQ;AAAA,IAC5B;AAEA,IAAA,OAAO,MAAA;AAAA,EACT;AAAA,EAEA,eAAe,SAAA,EAAgC;AAC7C,IAAA,MAAM,SAAkB,EAAC;AAEzB,IAAA,KAAA,MAAW,OAAO,SAAA,EAAW;AAC3B,MAAA,MAAM,UAAA,GAAa,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,OAAO,CAAA;AAEzC,MAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,UAAA,CAAW,QAAQ,CAAA,EAAA,EAAK;AAC1C,QAAA,MAAA,CAAO,IAAA,CAAK;AAAA,UACV,EAAA,EAAI,CAAA,EAAG,GAAA,CAAI,EAAE,UAAU,CAAC,CAAA,CAAA;AAAA,UACxB,OAAA,EAAS,WAAW,CAAC,CAAA;AAAA,UACrB,YAAY,GAAA,CAAI,EAAA;AAAA,UAChB,KAAA,EAAO,CAAA;AAAA,UACP,QAAA,EAAU,EAAE,GAAG,GAAA,CAAI,QAAA;AAAS,SAC7B,CAAA;AAAA,MACH;AAAA,IACF;AAEA,IAAA,OAAO,MAAA;AAAA,EACT;AACF","file":"chunk-EDDKTQDL.js","sourcesContent":["import type { Document, Chunk } from '../types/index.js';\nimport type { TextSplitter, TokenTextSplitterOptions } from './types.js';\n\nexport class TokenTextSplitter implements TextSplitter {\n  private chunkSize: number;\n  private chunkOverlap: number;\n  private tokensPerChar: number;\n\n  constructor(options: TokenTextSplitterOptions = {}) {\n    this.chunkSize = options.chunkSize ?? 500;\n    this.chunkOverlap = options.chunkOverlap ?? 50;\n    this.tokensPerChar = options.estimatedTokensPerChar ?? 0.25;\n\n    if (this.chunkOverlap >= this.chunkSize) {\n      throw new Error('chunkOverlap must be less than chunkSize');\n    }\n  }\n\n  split(text: string): string[] {\n    const charChunkSize = Math.floor(this.chunkSize / this.tokensPerChar);\n    const charOverlap = Math.floor(this.chunkOverlap / this.tokensPerChar);\n\n    const chunks: string[] = [];\n    let start = 0;\n\n    while (start < text.length) {\n      let end = Math.min(start + charChunkSize, text.length);\n\n      if (end < text.length) {\n        const lastSpace = text.lastIndexOf(' ', end);\n        if (lastSpace > start) {\n          end = lastSpace;\n        }\n      }\n\n      const chunk = text.slice(start, end).trim();\n      if (chunk) {\n        chunks.push(chunk);\n      }\n\n      start = end - charOverlap;\n      if (start >= text.length) break;\n    }\n\n    return chunks;\n  }\n\n  splitDocuments(documents: Document[]): Chunk[] {\n    const chunks: Chunk[] = [];\n\n    for (const doc of documents) {\n      const textChunks = this.split(doc.content);\n\n      for (let i = 0; i < textChunks.length; i++) {\n        chunks.push({\n          id: `${doc.id}_chunk_${i}`,\n          content: textChunks[i],\n          documentId: doc.id,\n          index: i,\n          metadata: { ...doc.metadata },\n        });\n      }\n    }\n\n    return chunks;\n  }\n}\n"]}

package/dist/chunk-EEZO2BKZ.cjs

@@ -0,0 +1,29 @@
+'use strict';
+
+// src/parsers/list-parser.ts
+var ListParser = class {
+  separator;
+  trim;
+  constructor(options = {}) {
+    this.separator = options.separator ?? "\n";
+    this.trim = options.trim ?? true;
+  }
+  parse(text) {
+    let items = text.split(this.separator);
+    if (this.trim) {
+      items = items.map((item) => item.trim());
+    }
+    items = items.map((item) => item.replace(/^[-*•]\s+/, "").replace(/^\d+[.)]\s+/, ""));
+    return items.filter((item) => item.length > 0);
+  }
+  getFormatInstructions() {
+    if (this.separator === "\n") {
+      return `Your response must be a list of items, one per line. Do not include bullet points, numbers, or other prefixes.`;
+    }
+    return `Your response must be a list of items separated by "${this.separator}".`;
+  }
+};
+
+exports.ListParser = ListParser;
+//# sourceMappingURL=chunk-EEZO2BKZ.cjs.map
+//# sourceMappingURL=chunk-EEZO2BKZ.cjs.map

package/dist/chunk-EEZO2BKZ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/parsers/list-parser.ts"],"names":[],"mappings":";;;AAEO,IAAM,aAAN,MAAmD;AAAA,EAChD,SAAA;AAAA,EACA,IAAA;AAAA,EAER,WAAA,CAAY,OAAA,GAA6B,EAAC,EAAG;AAC3C,IAAA,IAAA,CAAK,SAAA,GAAY,QAAQ,SAAA,IAAa,IAAA;AACtC,IAAA,IAAA,CAAK,IAAA,GAAO,QAAQ,IAAA,IAAQ,IAAA;AAAA,EAC9B;AAAA,EAEA,MAAM,IAAA,EAAwB;AAC5B,IAAA,IAAI,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,SAAS,CAAA;AAErC,IAAA,IAAI,KAAK,IAAA,EAAM;AACb,MAAA,KAAA,GAAQ,KAAA,CAAM,GAAA,CAAI,CAAA,IAAA,KAAQ,IAAA,CAAK,MAAM,CAAA;AAAA,IACvC;AAGA,IAAA,KAAA,GAAQ,KAAA,CAAM,GAAA,CAAI,CAAA,IAAA,KAAQ,IAAA,CAAK,OAAA,CAAQ,WAAA,EAAa,EAAE,CAAA,CAAE,OAAA,CAAQ,aAAA,EAAe,EAAE,CAAC,CAAA;AAElF,IAAA,OAAO,KAAA,CAAM,MAAA,CAAO,CAAA,IAAA,KAAQ,IAAA,CAAK,SAAS,CAAC,CAAA;AAAA,EAC7C;AAAA,EAEA,qBAAA,GAAgC;AAC9B,IAAA,IAAI,IAAA,CAAK,cAAc,IAAA,EAAM;AAC3B,MAAA,OAAO,CAAA,8GAAA,CAAA;AAAA,IACT;AACA,IAAA,OAAO,CAAA,oDAAA,EAAuD,KAAK,SAAS,CAAA,EAAA,CAAA;AAAA,EAC9E;AACF","file":"chunk-EEZO2BKZ.cjs","sourcesContent":["import type { OutputParser, ListParserOptions } from './types.js';\n\nexport class ListParser implements OutputParser<string[]> {\n  private separator: string;\n  private trim: boolean;\n\n  constructor(options: ListParserOptions = {}) {\n    this.separator = options.separator ?? '\\n';\n    this.trim = options.trim ?? true;\n  }\n\n  parse(text: string): string[] {\n    let items = text.split(this.separator);\n\n    if (this.trim) {\n      items = items.map(item => item.trim());\n    }\n\n    // Remove common list prefixes (-, *, 1., etc.)\n    items = items.map(item => item.replace(/^[-*•]\\s+/, '').replace(/^\\d+[.)]\\s+/, ''));\n\n    return items.filter(item => item.length > 0);\n  }\n\n  getFormatInstructions(): string {\n    if (this.separator === '\\n') {\n      return `Your response must be a list of items, one per line. Do not include bullet points, numbers, or other prefixes.`;\n    }\n    return `Your response must be a list of items separated by \"${this.separator}\".`;\n  }\n}\n"]}