@anvia/core 1.0.4 → 1.0.8

package/README.md

@@ -20,6 +20,18 @@ adapter on the same release channel.
 pnpm add @anvia/core@rc
 ```
 
+### Bun
+
+Bun 1.3.14 is the currently tested and supported runtime baseline. Install Core on the same
+release channel as the rest of your Anvia packages:
+
+```sh
+bun add @anvia/core@rc
+```
+
+The repository itself remains a pnpm workspace; Bun support applies to applications consuming the
+published package.
+
 See the repository's [1.0 release policy](../../docs/releases/v1.md) for channel and support
 details.
 
@@ -380,9 +392,11 @@ new Agent({
 Without `session`, the same Agent is stateless. Pass `{ messages }` when the caller already owns a
 complete transcript; transcripts cannot be combined with persisted sessions.
 
-Compaction is an explicit Agent policy over a store capability. The adapter persists the summary as
-an ordinary system message with `metadata.anvia.memoryCompaction`, so `load()` and inspectors expose
-exactly what future runs receive:
+Compaction is an explicit Agent policy over a store capability. The store preserves the canonical
+message history for `load()` and inspectors, and persists one latest compaction checkpoint
+separately. Future model calls receive the checkpoint summary (a system message tagged with
+`metadata.anvia.memoryCompaction`) plus the unsummarized tail, not the individual messages already
+covered by that summary:
 
 ```ts
 import { createSummaryMemoryCompactor } from "@anvia/core/memory";
@@ -451,9 +465,10 @@ if (result.type === "compacted") {
 }
 ```
 
-The automatic trigger is a threshold, not a hard storage limit. Summary-provider retries belong to
-the compactor; full snapshot-to-replacement conflict retries are separately opt-in. A streamed
-`memory_compaction` event is emitted only after the store atomically commits the replacement.
+The automatic trigger is a threshold, not a hard storage limit. Omitting `compaction` keeps the
+full canonical history model-facing. Summary-provider retries belong to the compactor; full
+snapshot-to-checkpoint conflict retries are separately opt-in. A streamed `memory_compaction`
+event is emitted only after the store atomically commits the checkpoint.
 
 ## Structured Extraction
 
@@ -539,19 +554,12 @@ enabled.
 
 ## Documents
 
-Applications own file discovery, file reads, source metadata, and per-file error policy. Core only
-provides deterministic in-memory chunking and scoped PDF text extraction:
-
-PDF extraction uses the optional `pdfjs-dist` peer dependency. Install it in applications that call
-`extractPdfText`:
-
-```sh
-pnpm add pdfjs-dist
-```
+Applications own file discovery, file reads, document parsing, source metadata, and per-file error
+policy. Core only provides deterministic in-memory text chunking:
 
 ```ts
 import { readFile } from "node:fs/promises";
-import { chunkText, extractPdfText } from "@anvia/core/documents";
+import { chunkText } from "@anvia/core/documents";
 
 const text = await readFile("guide.txt", "utf8");
 const chunks = chunkText({
@@ -561,19 +569,12 @@ const chunks = chunkText({
   overlap: 100,
   separators: ["\n\n", "\n", " "],
 });
-
-const { pages } = await extractPdfText({
-  data: new Uint8Array(await readFile("guide.pdf")),
-  abortSignal,
-});
 ```
 
 Use `strategy: "fixed"` for deterministic sliding windows. Recursive chunking requires an explicit
 separator order and falls back to fixed-size splitting when none of those separators can divide an
 oversized section. Chunk offsets use JavaScript string indices and always identify the exact source
-slice. PDF pages are one-based, and the parser task is disposed before extraction settles.
-If parsing or abort handling fails together with parser cleanup, extraction rejects with an
-`AggregateError` containing the operation failure first and the cleanup failure second.
+slice.
 
 For the common vector ingestion path, embed and upsert raw text with one call:
 
@@ -648,6 +649,158 @@ Import `McpClient` and `McpClientGroup` from `@anvia/mcp`, connect them, and pas
 `servers` to `new Agent({ mcpServers })`. See the `@anvia/mcp` README for transport configuration,
 connection ownership, URL safety, and cleanup.
 
+## Evaluations
+
+Import evaluation APIs from `@anvia/core/evals`. A suite contains cases, a target, and one or more
+metrics. Required metric failures make a case fail; infrastructure or evaluation errors produce an
+`invalid` outcome.
+
+```ts
+import { contains, exactMatch, runEvalSuite } from "@anvia/core/evals";
+
+const result = await runEvalSuite({
+  name: "support answers",
+  cases: [
+    {
+      id: "refund-window",
+      input: "When can I request a refund?",
+      expected: "Refunds are available for 30 days.",
+    },
+  ],
+  target: async (input) => answerSupportQuestion(input),
+  metrics: [exactMatch(), contains({ expected: "30 days" })],
+});
+
+console.log(result.cases);
+console.log(result.results[0]?.scores.exact_match);
+```
+
+`runEvalSuite` infers the case input, target output, expected value, metric names, and score types.
+Metrics that implicitly read `case.expected`, `case.context`, or `case.retrievalContext` require
+those fields at compile time. Supplying an explicit metric value or selector removes the matching
+case requirement.
+
+### Built-in metrics
+
+Deterministic metrics do not call a model:
+
+- `exactMatch`, `contains`, `notContains`, `containsAll`, and `containsAny`
+- `matches`, `doesNotMatch`, `maxLength`, and `requiredFields`
+- `semanticSimilarity`, which uses an embedding model
+
+Judge metrics call a completion model and record their evaluation token usage:
+
+- `llmJudge` and `llmScore`
+- `answerRelevancy`, `promptAlignment`, `jsonCorrectness`, and `summarization`
+- `hallucination`, `faithfulness`, and `abstention`
+- `gEval`, `turnRelevancy`, and `knowledgeRetention`
+
+Numeric thresholds use values from `0` through `1`. `strictMode` requires a perfect higher-is-better
+score or a zero lower-is-better score. Judge metrics default to including a final explanation;
+setting `includeReason: false` saves that extra judge call when the explanation is unnecessary.
+
+### Typed custom metrics
+
+Use `createEvalTypes` to bind input, output, and expected types once when defining multiple custom
+metrics:
+
+```ts
+import { createEvalTypes, EvalOutcome } from "@anvia/core/evals";
+
+const supportEvals = createEvalTypes<string, { answer: string }, string>();
+
+const noHandoff = supportEvals.defineMetric({
+  name: "no_handoff",
+  dataType: "BOOLEAN",
+  evaluate: ({ output, signal }) =>
+    signal.aborted || output.answer.includes("contact support")
+      ? EvalOutcome.fail(false)
+      : EvalOutcome.pass(true),
+});
+```
+
+Custom metrics return `EvalOutcome.pass`, `EvalOutcome.fail`, or `EvalOutcome.invalid`. Thrown metric
+errors are converted to structured invalid outcomes containing the error kind and original error.
+
+### Execution controls
+
+Evaluation targets receive an optional third argument containing the case `AbortSignal`.
+
+```ts
+const result = await runEvalSuite({
+  // cases, target, and metrics...
+  name: "release gate",
+  cases,
+  target: async (input, testCase, context) =>
+    generateAnswer(input, { signal: context?.signal, metadata: testCase.metadata }),
+  metrics,
+  targetConcurrency: 4,
+  metricConcurrency: 2,
+  caseTimeoutMs: 30_000,
+  signal: deploymentSignal,
+  failFast: true,
+  caseIds: ["refund-window", "billing-owner"],
+  shard: { index: 0, count: 4 },
+  onProgress(event) {
+    console.log(event.type);
+  },
+});
+```
+
+- `concurrency` remains the shorthand for both target and metric concurrency.
+- `targetConcurrency` and `metricConcurrency` can limit them independently.
+- `caseTimeoutMs` covers the target and its metrics. Cooperative targets and metrics should observe
+  the supplied signal; the runner still stops awaiting work that ignores it.
+- Aborting the suite-level `signal` stops scheduling cases and rejects the run with the abort reason.
+- `caseIds`, `caseFilter`, and `shard` select cases before execution.
+- `failFast` throws `EvalFailFastError` after the first completed required failure or invalid case.
+- `onProgress` receives case, target, metric, and case-completion events.
+
+Use `selectEvalCaseIds(previousResult)` to select failed and invalid cases for a rerun.
+
+### Results, usage, and failures
+
+Every case result includes `targetStatus`, target and total durations, per-case usage and optional
+cost. Every metric result includes its duration, optional cost, outcome, and reporter errors. A
+successful target that returns `undefined` has `targetStatus: "succeeded"` and retains its `output`
+property, so it is distinct from a failed target.
+
+The suite aggregates metric totals, case totals, target and evaluation usage, costs, duration, and
+all reporter errors. Invalid outcomes may include these `kind` values: `target`, `metric`,
+`configuration`, `provider`, or `timeout`.
+
+### CI output and expectations
+
+`runEvalCli` prints a result and can set `process.exitCode`. Exit code `1` means a required metric
+failed; `2` means a required metric was invalid. Use `defineEvalExpectations` with a defined suite to
+type-check case and metric names.
+
+```ts
+import { defineEvalExpectations, defineEvalSuite, exactMatch, runEvalCli } from "@anvia/core/evals";
+
+const suite = defineEvalSuite({
+  name: "release gate",
+  cases: [{ id: "refund", input: "refund", expected: "30 days" }],
+  target: async () => "30 days",
+  metrics: [exactMatch({ name: "correct" })],
+});
+
+await runEvalCli({
+  ...suite,
+  expectations: defineEvalExpectations(suite, {
+    outcomes: { refund: { correct: "pass" } },
+  }),
+  exitCode: true,
+  maxValueLength: 2_000,
+  redact: (value, context) => (context.kind === "input" ? "[redacted]" : value),
+});
+```
+
+Use `formatEvalResult` for pure pretty or JSON formatting without writing to stdout. Both
+`formatEvalResult` and `runEvalCli` support value truncation and redaction. JSON output otherwise
+contains cases, outputs, metadata, and error details, so redact sensitive data before writing it to
+shared CI logs.
+
 ## Public Areas
 
 - `agent`: typed Agent runtime, retries, and stream events
@@ -664,7 +817,7 @@ connection ownership, URL safety, and cleanup.
 - `skills`: local skill loading
 - `observability`: observer interfaces for runs, generations, and tool calls
 - `evals`: evaluation helpers and reporters
-- `documents`: in-memory text chunking and PDF text extraction
+- `documents`: deterministic in-memory text chunking
 - `speech-generation`, `image-generation`, `transcription`: provider-neutral media interfaces
 
 ## Development

package/dist/agent/index.d.ts

@@ -1,16 +1,16 @@
 export { M as ModelCallOptions } from '../model-call-options-CZkSw_xN.js';
 export { R as RetryContext, a as RetryOptions, b as RetrySetting } from '../retry-CjvSlKGW.js';
-export { A as Agent, a as AgentContextInput, b as AgentMemory, c as AgentMemoryOptions, d as AgentOptions, e as AgentToolInput, f as AgentToolOptions, C as CreateHybridVectorContextOptions, g as CreateVectorContextOptions, V as VectorContext, h as VectorContextBaseOptions, i as createVectorContext, j as isVectorContext } from '../agent-fvQIBLBk.js';
+export { A as Agent, a as AgentContextInput, b as AgentMemory, c as AgentMemoryOptions, d as AgentOptions, e as AgentToolInput, f as AgentToolOptions, C as CreateHybridVectorContextOptions, g as CreateVectorContextOptions, V as VectorContext, h as VectorContextBaseOptions, i as createVectorContext, j as isVectorContext } from '../agent-B-3jCRmI.js';
 import { M as Message, U as Usage, C as CompletionFinishReason } from '../types-DgvozfPc.js';
-import { A as AgentBlockedOutcome, g as AgentInteractionOutcome } from '../types-ChH_bdtR.js';
-export { a as AgentChildStreamEvent, b as AgentDeltaEvent, c as AgentErrorEvent, d as AgentErrorStreamEvent, e as AgentFinishEvent, f as AgentInput, h as AgentLifecycle, i as AgentMemoryCompactionEvent, j as AgentMemoryCompactionOptions, k as AgentOutcome, l as AgentPrompt, m as AgentResponse, n as AgentRunOptions, o as AgentRunSettings, p as AgentStartEvent, q as AgentSteerInput, r as AgentSteerReceipt, s as AgentStepFinishEvent, t as AgentStream, u as AgentStreamEvent, v as AgentToolCallDeltaEvent, w as AgentToolFinishEvent, x as AgentToolStartEvent } from '../types-ChH_bdtR.js';
+import { A as AgentBlockedOutcome, g as AgentInteractionOutcome } from '../types-DL7wX6hJ.js';
+export { a as AgentChildStreamEvent, b as AgentDeltaEvent, c as AgentErrorEvent, d as AgentErrorStreamEvent, e as AgentFinishEvent, f as AgentInput, h as AgentLifecycle, i as AgentMemoryCompactionEvent, j as AgentMemoryCompactionOptions, k as AgentOutcome, l as AgentPrompt, m as AgentResponse, n as AgentRunOptions, o as AgentRunSettings, p as AgentStartEvent, q as AgentSteerInput, r as AgentSteerReceipt, s as AgentStepFinishEvent, t as AgentStream, u as AgentStreamEvent, v as AgentToolCallDeltaEvent, w as AgentToolFinishEvent, x as AgentToolStartEvent } from '../types-DL7wX6hJ.js';
 import '../zod-schema-C7F4clpm.js';
 import 'zod';
 import '../types-DhkodEft.js';
 import '../type-utils-CtHVDRn_.js';
 import '../types-DjqRHeAi.js';
 import '../tool-BpqpoRSE.js';
-import '../types-CSYt7-It.js';
+import '../types-DmzRCbU5.js';
 import '../middleware-kcF8AusP.js';
 import './interactions/index.js';
 import '../types-DC1U1XwW.js';

package/dist/agent/index.js

@@ -2,16 +2,16 @@ import {
   Agent,
   createVectorContext,
   isVectorContext
-} from "../chunk-NMVCGWQY.js";
+} from "../chunk-HNRNTFMQ.js";
 import "../chunk-OJBFDBLG.js";
 import "../chunk-J6LVLV6P.js";
 import "../chunk-XMVOBX43.js";
 import "../chunk-34EDX4ZL.js";
 import "../chunk-KSKST3KP.js";
 import "../chunk-YK4WAAS4.js";
-import "../chunk-OIB3URVG.js";
-import "../chunk-LZD36ZAP.js";
-import "../chunk-4EWTDOLR.js";
+import "../chunk-2QZJTG2E.js";
+import "../chunk-XC3LVC4K.js";
+import "../chunk-XEVOC433.js";
 import {
   AgentRunBlockedError,
   AgentRunCancelledError,

package/dist/{agent-fvQIBLBk.d.ts → agent-B-3jCRmI.d.ts}

@@ -3,8 +3,8 @@ import { D as Document, c as CompletionModel, P as ProviderTool, J as JsonObject
 import { Z as ZodSchema } from './zod-schema-C7F4clpm.js';
 import { d as GuardrailPolicyInput, c as GuardrailPolicy } from './types-DhkodEft.js';
 import { a as McpServer } from './types-DjqRHeAi.js';
-import { E as MemoryStore, z as MemorySavePolicy, F as MemoryTokenCounter, n as MemoryCompactor, d as MemoryCompactionConflictRetryOptions, y as MemoryOptions, k as MemoryCompactionResult } from './types-CSYt7-It.js';
-import { h as AgentLifecycle, F as AgentObservabilityOptions, n as AgentRunOptions, k as AgentOutcome, o as AgentRunSettings, t as AgentStream, j as AgentMemoryCompactionOptions } from './types-ChH_bdtR.js';
+import { E as MemoryStore, z as MemorySavePolicy, F as MemoryTokenCounter, n as MemoryCompactor, d as MemoryCompactionConflictRetryOptions, y as MemoryOptions, k as MemoryCompactionResult } from './types-DmzRCbU5.js';
+import { h as AgentLifecycle, F as AgentObservabilityOptions, n as AgentRunOptions, k as AgentOutcome, o as AgentRunSettings, t as AgentStream, j as AgentMemoryCompactionOptions } from './types-DL7wX6hJ.js';
 import { A as AgentMiddleware } from './middleware-kcF8AusP.js';
 import { A as AnyTool, T as Tool, c as ToolCallContext, N as NormalizedToolOutput } from './tool-BpqpoRSE.js';
 import { AgentContinuation, AgentInteractionResponse } from './agent/interactions/index.js';

package/dist/{chunk-OIB3URVG.js → chunk-2QZJTG2E.js}

@@ -4,7 +4,7 @@ import {
   assertPositiveSearchLimit,
   createTool,
   retrieveDocuments
-} from "./chunk-LZD36ZAP.js";
+} from "./chunk-XC3LVC4K.js";
 import {
   embedDocuments
 } from "./chunk-K5L7R7XM.js";
@@ -168,4 +168,4 @@ export {
   createMiddleware,
   createThinkTool
 };
-//# sourceMappingURL=chunk-OIB3URVG.js.map
+//# sourceMappingURL=chunk-2QZJTG2E.js.map

package/dist/{chunk-NMVCGWQY.js → chunk-HNRNTFMQ.js}

@@ -23,7 +23,7 @@ import {
 import {
   isQuestionTool,
   isToolIndex
-} from "./chunk-OIB3URVG.js";
+} from "./chunk-2QZJTG2E.js";
 import {
   ToolNotFoundError,
   ToolOutput,
@@ -38,7 +38,7 @@ import {
   retrieveDocuments,
   toolMayRequireApproval,
   toolResultContentToText
-} from "./chunk-LZD36ZAP.js";
+} from "./chunk-XC3LVC4K.js";
 import {
   AgentRunBlockedError,
   AgentRunCancelledError,
@@ -4772,4 +4772,4 @@ export {
   markResolvedAgentOptions,
   Agent
 };
-//# sourceMappingURL=chunk-NMVCGWQY.js.map
+//# sourceMappingURL=chunk-HNRNTFMQ.js.map

package/dist/{chunk-LZD36ZAP.js → chunk-XC3LVC4K.js}

@@ -1,6 +1,6 @@
 import {
   chunkTextDocuments
-} from "./chunk-4EWTDOLR.js";
+} from "./chunk-XEVOC433.js";
 import {
   cosineSimilarity,
   embedDocuments,
@@ -86,7 +86,7 @@ var ToolJsonError = class extends Error {
 };
 
 // src/tool/tool.ts
-var richToolOutput = /* @__PURE__ */ Symbol("anvia.tool-output.content");
+var richToolOutput = /* @__PURE__ */ Symbol.for("anvia.tool-output.content");
 var ToolResultSerializationError = class extends TypeError {
   constructor(output) {
     super("Tool output must be a string, a strict JSON value, or ToolOutput.content(...).");
@@ -135,7 +135,8 @@ function toolResultContentToText(content) {
   return content.map((item) => item.type === "text" ? item.text : `[file:${item.mediaType}]`).join("\n");
 }
 function isRichToolOutput(value) {
-  return typeof value === "object" && value !== null && richToolOutput in value;
+  if (typeof value !== "object" || value === null) return false;
+  return Object.getOwnPropertyDescriptor(value, richToolOutput)?.value === true;
 }
 function parseToolArgs(args) {
   const value = JSON.parse(args);
@@ -749,4 +750,4 @@ export {
   InMemoryVectorStore,
   createVectorSearchTool
 };
-//# sourceMappingURL=chunk-LZD36ZAP.js.map
+//# sourceMappingURL=chunk-XC3LVC4K.js.map

package/dist/chunk-XC3LVC4K.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vector-store/index.ts","../src/internal/vector-search-options.ts","../src/internal/agent-runtime/approval-requirement.ts","../src/tool/errors.ts","../src/tool/tool.ts","../src/internal/agent-runtime/prepared-tool-call.ts","../src/tool/create-tool.ts","../src/vector-store/filter.ts","../src/vector-store/lsh.ts","../src/vector-store/retrieve.ts","../src/vector-store/ingest.ts"],"sourcesContent":["import { z } from \"zod\";\nimport {\n  cosineSimilarity,\n  type EmbeddedDocument,\n  type Embedding,\n  type VectorMetadata,\n} from \"../embeddings\";\nimport { assertFiniteMinScore, assertPositiveSearchLimit } from \"../internal/vector-search-options\";\nimport { createTool } from \"../tool/create-tool\";\nimport type { Tool } from \"../tool/tool\";\nimport { matchesVectorFilter } from \"./filter\";\nimport { LshIndex } from \"./lsh\";\nimport { retrieveDocuments } from \"./retrieve\";\nimport type {\n  IndexStrategy,\n  VectorInspectItem,\n  VectorInspectPage,\n  VectorInspectRequest,\n  VectorSearchRequest,\n  VectorSearchResult,\n  VectorSearchToolOptions,\n  VectorStore,\n  VectorStoreUpsertOptions,\n} from \"./types\";\n\nexport { matchesVectorFilter, vectorFilter } from \"./filter\";\nexport * from \"./ingest\";\nexport { retrieveDocuments } from \"./retrieve\";\nexport type * from \"./types\";\n\ntype StoredDocument<T, Metadata extends VectorMetadata> = EmbeddedDocument<T, Metadata>;\n\nexport type InMemoryVectorStoreOptions = {\n  dimensions?: number | undefined;\n  index?: IndexStrategy | undefined;\n};\n\nexport type InMemoryVectorStoreFromDocumentsOptions<\n  T,\n  Metadata extends VectorMetadata = VectorMetadata,\n> = InMemoryVectorStoreOptions & {\n  documents: Array<EmbeddedDocument<T, Metadata>>;\n};\n\nexport class InMemoryVectorStore<\n  T,\n  Metadata extends VectorMetadata = VectorMetadata,\n> implements VectorStore<T, Metadata> {\n  private readonly documents = new Map<string, StoredDocument<T, Metadata>>();\n  private readonly indexStrategy: IndexStrategy;\n  private lshIndex: LshIndex | undefined;\n  private embeddingDimension: number | undefined;\n\n  constructor(options: InMemoryVectorStoreOptions = {}) {\n    this.indexStrategy = options.index ?? { type: \"bruteForce\" };\n    if (\n      options.dimensions !== undefined &&\n      (!Number.isSafeInteger(options.dimensions) || options.dimensions < 1)\n    ) {\n      throw new RangeError(\"Vector dimensions must be a positive safe integer.\");\n    }\n    this.embeddingDimension = options.dimensions;\n  }\n\n  static fromDocuments<T, Metadata extends VectorMetadata = VectorMetadata>(\n    options: InMemoryVectorStoreFromDocumentsOptions<T, Metadata>,\n  ): InMemoryVectorStore<T, Metadata> {\n    const store = new InMemoryVectorStore<T, Metadata>(options);\n    store.replaceDocuments(options.documents);\n    return store;\n  }\n\n  async ensure(): Promise<void> {}\n  async validate(): Promise<void> {}\n\n  async upsert(options: VectorStoreUpsertOptions<T, Metadata>): Promise<void> {\n    this.replaceDocuments(options.documents);\n  }\n\n  get(options: { id: string }): StoredDocument<T, Metadata> | undefined {\n    return this.documents.get(options.id);\n  }\n\n  values(): Array<StoredDocument<T, Metadata>> {\n    return [...this.documents.values()];\n  }\n\n  len(): number {\n    return this.documents.size;\n  }\n\n  isEmpty(): boolean {\n    return this.documents.size === 0;\n  }\n\n  async search(request: VectorSearchRequest): Promise<Array<VectorSearchResult<T, Metadata>>> {\n    throwIfAborted(request.abortSignal);\n    assertPositiveSearchLimit(request.topK);\n    assertFiniteMinScore(request.minScore);\n    const queryEmbedding: Embedding = { document: \"\", vector: request.vector };\n    const results = this.candidates(queryEmbedding)\n      .filter((document) => matchesVectorFilter(document.metadata, request.filter))\n      .flatMap((document) => {\n        const score = bestScore(queryEmbedding, document.embeddings);\n        if (score === undefined || (request.minScore !== undefined && score < request.minScore)) {\n          return [];\n        }\n        let result: VectorSearchResult<T, Metadata> = {\n          score,\n          id: document.id,\n          document: document.document,\n        };\n        if (document.metadata !== undefined) {\n          result = { ...result, metadata: document.metadata };\n        }\n        return [result];\n      })\n      .sort((left, right) => right.score - left.score)\n      .slice(0, request.topK);\n    throwIfAborted(request.abortSignal);\n    return results;\n  }\n\n  async inspect(request: VectorInspectRequest): Promise<VectorInspectPage<T, Metadata>> {\n    throwIfAborted(request.abortSignal);\n    const limit = assertPositiveSearchLimit(request.limit);\n    const start = Math.max(0, Math.trunc(Number(request.cursor ?? \"0\")));\n    const documents = this.values().filter((document) =>\n      matchesVectorFilter(document.metadata, request.filter),\n    );\n    const page = documents.slice(start, start + limit);\n    const nextOffset = start + page.length;\n    const result: VectorInspectPage<T, Metadata> = {\n      items: page.map((document): VectorInspectItem<T, Metadata> => {\n        let item: VectorInspectItem<T, Metadata> = {\n          id: document.id,\n          document: document.document,\n        };\n        if (document.metadata !== undefined) {\n          item = { ...item, metadata: document.metadata };\n        }\n        return item;\n      }),\n      totalCount: documents.length,\n    };\n    if (nextOffset < documents.length) result.nextCursor = String(nextOffset);\n    throwIfAborted(request.abortSignal);\n    return result;\n  }\n\n  private replaceDocuments(documents: Array<EmbeddedDocument<T, Metadata>>): void {\n    const ids = new Set<string>();\n    for (const document of documents) {\n      if (ids.has(document.id)) throw new TypeError(`Duplicate vector document id: ${document.id}`);\n      ids.add(document.id);\n      if (document.embeddings.length === 0) {\n        throw new TypeError(`Vector document ${document.id} must contain at least one embedding.`);\n      }\n      for (const embedding of document.embeddings)\n        assertFiniteVector(embedding.vector, document.id);\n    }\n    this.validateDocumentDimensions(documents);\n    for (const document of documents) this.documents.set(document.id, document);\n    this.rebuildLshIndex();\n  }\n\n  private candidates(queryEmbedding: Embedding): Array<StoredDocument<T, Metadata>> {\n    this.validateQueryDimension(queryEmbedding);\n    if (this.indexStrategy.type !== \"lsh\" || this.lshIndex === undefined) return this.values();\n    const candidateIds = this.lshIndex.query(queryEmbedding.vector);\n    if (candidateIds.size === 0) return this.values();\n    return [...candidateIds].flatMap((id) => {\n      const document = this.documents.get(id);\n      return document === undefined ? [] : [document];\n    });\n  }\n\n  private rebuildLshIndex(): void {\n    if (this.indexStrategy.type !== \"lsh\") {\n      this.lshIndex = undefined;\n      return;\n    }\n    const firstEmbedding = this.values().flatMap((document) => document.embeddings)[0];\n    if (firstEmbedding === undefined) {\n      this.lshIndex = undefined;\n      return;\n    }\n    const index = new LshIndex(firstEmbedding.vector.length, this.indexStrategy);\n    for (const document of this.documents.values()) {\n      for (const embedding of document.embeddings) index.insert(document.id, embedding.vector);\n    }\n    this.lshIndex = index;\n  }\n\n  private validateDocumentDimensions(documents: Array<EmbeddedDocument<T, Metadata>>): void {\n    let dimension = this.embeddingDimension;\n    for (const document of documents) {\n      for (const embedding of document.embeddings) {\n        dimension = validateEmbeddingDimension(dimension, embedding, document.id);\n      }\n    }\n    this.embeddingDimension = dimension;\n  }\n\n  private validateQueryDimension(queryEmbedding: Embedding): void {\n    if (this.embeddingDimension !== undefined) {\n      validateEmbeddingDimension(this.embeddingDimension, queryEmbedding, \"query\");\n    }\n  }\n}\n\nfunction throwIfAborted(signal: AbortSignal | undefined): void {\n  if (signal?.aborted) {\n    const error = new Error(\"The operation was aborted.\");\n    error.name = \"AbortError\";\n    throw error;\n  }\n}\n\nexport function createVectorSearchTool<T, Metadata extends VectorMetadata>(\n  options: VectorSearchToolOptions<T, Metadata>,\n): Tool<{ query: string; topK?: number }, Array<VectorSearchResult<T, Metadata>>> {\n  const configuredTopK = assertPositiveSearchLimit(options.topK ?? 5);\n  assertFiniteMinScore(options.minScore);\n  return createTool({\n    name: options.name,\n    description:\n      options.description ?? \"Search a vector store for documents relevant to the provided query.\",\n    inputSchema: z.object({\n      query: z.string().min(1).describe(\"The query string to search for relevant documents.\"),\n      topK: z.number().int().positive().optional().describe(\"The maximum number of results.\"),\n    }),\n    outputSchema: z.array(\n      z.object({\n        score: z.number(),\n        id: z.string(),\n        document: z.any(),\n        metadata: z\n          .record(z.string(), z.union([z.string(), z.number(), z.boolean(), z.null()]))\n          .optional(),\n      }),\n    ),\n    execute: ({ query, topK }, context) => {\n      const request = {\n        query,\n        topK: topK ?? configuredTopK,\n        minScore: options.minScore,\n        filter: options.filter,\n        retries: options.retries,\n        abortSignal: context.abortSignal,\n      };\n      return \"models\" in options && options.models !== undefined\n        ? retrieveDocuments({\n            ...request,\n            store: options.store,\n            models: options.models,\n            fusion: options.fusion,\n          })\n        : retrieveDocuments({ ...request, store: options.store, model: options.model });\n    },\n  }) as Tool<{ query: string; topK?: number }, Array<VectorSearchResult<T, Metadata>>>;\n}\n\nfunction bestScore(queryEmbedding: Embedding, embeddings: Embedding[]): number | undefined {\n  let best: number | undefined;\n  for (const embedding of embeddings) {\n    const score = cosineSimilarity(queryEmbedding.vector, embedding.vector);\n    best = best === undefined ? score : Math.max(best, score);\n  }\n  return best;\n}\n\nfunction validateEmbeddingDimension(\n  expectedDimension: number | undefined,\n  embedding: Embedding,\n  id: string,\n): number {\n  assertFiniteVector(embedding.vector, id);\n  if (expectedDimension === undefined) return embedding.vector.length;\n  if (embedding.vector.length !== expectedDimension) {\n    throw new Error(\n      `Vector dimension mismatch: expected ${expectedDimension} dimensions but received ${embedding.vector.length} for ${id}`,\n    );\n  }\n  return expectedDimension;\n}\n\nfunction assertFiniteVector(vector: number[], id: string): void {\n  if (vector.length === 0) throw new TypeError(`Vector for ${id} must not be empty.`);\n  if (!vector.every(Number.isFinite)) {\n    throw new TypeError(`Vector for ${id} must contain only finite numbers.`);\n  }\n}\n","export function assertPositiveSearchLimit(value: number, name = \"topK\"): number {\n  if (!Number.isSafeInteger(value) || value <= 0) {\n    throw new RangeError(`${name} must be a positive safe integer.`);\n  }\n  return value;\n}\n\nexport function assertFiniteMinScore(\n  value: number | undefined,\n  name = \"minScore\",\n): number | undefined {\n  if (value !== undefined && !Number.isFinite(value)) {\n    throw new RangeError(`${name} must be a finite number.`);\n  }\n  return value;\n}\n","import type { ToolApprovalRequirement } from \"../../tool/tool\";\n\nexport function toolMayRequireApproval(requirement: unknown): boolean {\n  return requirement !== undefined && requirement !== false;\n}\n\nexport function assertToolApprovalRequirement(\n  requirement: unknown,\n  options: { allowFunction: boolean },\n): asserts requirement is boolean | ToolApprovalRequirement | ((...args: never[]) => unknown) {\n  if (typeof requirement === \"boolean\") {\n    return;\n  }\n  if (options.allowFunction && typeof requirement === \"function\") {\n    return;\n  }\n  if (typeof requirement !== \"object\" || requirement === null || Array.isArray(requirement)) {\n    throw new TypeError(\n      'Tool \"requiresApproval\" must be a boolean, a function, or an object with an optional string reason.',\n    );\n  }\n  const reason = (requirement as { reason?: unknown }).reason;\n  if (reason !== undefined && typeof reason !== \"string\") {\n    throw new TypeError('Tool \"requiresApproval.reason\" must be a string.');\n  }\n}\n","export class ToolCallError extends Error {\n  constructor(\n    message: string,\n    readonly cause?: unknown,\n  ) {\n    super(message);\n    this.name = \"ToolCallError\";\n  }\n}\n\nexport class ToolNotFoundError extends Error {\n  constructor(readonly toolName: string) {\n    super(`Tool not found: ${toolName}`);\n    this.name = \"ToolNotFoundError\";\n  }\n}\n\nexport class ToolJsonError extends Error {\n  constructor(\n    message: string,\n    readonly cause?: unknown,\n  ) {\n    super(message);\n    this.name = \"ToolJsonError\";\n  }\n}\n","import { isJsonValue } from \"../completion/json\";\nimport { parseMessage } from \"../completion/message-schema\";\nimport type {\n  JsonObject,\n  JsonValue,\n  ToolDefinition,\n  ToolResultContentPart,\n  ToolResultOutput,\n} from \"../completion/types\";\n\nexport type ToolApprovalRunContext = {\n  agentId: string;\n  runId: string;\n  sessionId?: string;\n  metadata?: JsonObject;\n};\n\nexport type ToolApprovalContext<Args = unknown> = {\n  toolName: string;\n  args: Args;\n  rawArgs: string;\n  toolCallId: string;\n  callId?: string;\n  internalCallId: string;\n  run: ToolApprovalRunContext;\n};\n\nexport type ToolApprovalRequirement = {\n  reason?: string | undefined;\n};\n\nexport type ToolRequiresApproval<Args = unknown> =\n  | boolean\n  | ToolApprovalRequirement\n  | ((\n      args: Args,\n      context: ToolApprovalContext<Args>,\n    ) => boolean | ToolApprovalRequirement | Promise<boolean | ToolApprovalRequirement>);\n\nexport type ToolCallStreamEvent = {\n  agentId: string;\n  agentName?: string | undefined;\n  event: unknown;\n};\n\nexport type ToolCallContext = {\n  emitStreamEvent?(event: ToolCallStreamEvent): void | Promise<void>;\n  abortSignal?: AbortSignal | undefined;\n};\n\nexport interface Tool<Args = unknown, Output = unknown> {\n  readonly name: string;\n  readonly requiresApproval?: ToolRequiresApproval<Args>;\n  definition(prompt: string): ToolDefinition | Promise<ToolDefinition>;\n  call(args: Args, context?: ToolCallContext): Output | Promise<Output>;\n  parseInput?(args: JsonValue): Args;\n}\n\nexport type AnyTool = Omit<Tool<unknown, unknown>, \"requiresApproval\"> & {\n  readonly requiresApproval?: unknown;\n};\n\nconst richToolOutput: unique symbol = Symbol.for(\"anvia.tool-output.content\");\n\nexport type RichToolOutput = Readonly<{\n  [richToolOutput]: true;\n  content: readonly ToolResultContentPart[];\n}>;\n\nexport type NormalizedToolOutput = ToolResultOutput;\n\nexport class ToolResultSerializationError extends TypeError {\n  constructor(readonly output: unknown) {\n    super(\"Tool output must be a string, a strict JSON value, or ToolOutput.content(...).\");\n    this.name = \"ToolResultSerializationError\";\n  }\n}\n\nexport const ToolOutput = {\n  content(content: readonly ToolResultContentPart[]): RichToolOutput {\n    return { [richToolOutput]: true, content };\n  },\n};\n\nexport function normalizeToolResultOutput(output: unknown): NormalizedToolOutput {\n  if (typeof output === \"string\") {\n    return { type: \"text\", value: output };\n  }\n  if (isRichToolOutput(output)) {\n    try {\n      const message = parseMessage({\n        role: \"tool\",\n        content: [\n          {\n            type: \"tool-result\",\n            toolCallId: \"validation\",\n            toolName: \"validation\",\n            output: { type: \"content\", value: output.content },\n          },\n        ],\n      });\n      if (message.role !== \"tool\") throw new TypeError(\"Unexpected message role\");\n      const result = message.content[0];\n      if (result?.type !== \"tool-result\") throw new TypeError(\"Unexpected tool result part\");\n      if (result?.output.type !== \"content\") throw new TypeError(\"Unexpected tool output\");\n      return result.output;\n    } catch {\n      throw new ToolResultSerializationError(output);\n    }\n  }\n  if (isJsonValue(output)) {\n    return { type: \"json\", value: output };\n  }\n  throw new ToolResultSerializationError(output);\n}\n\nexport function toolResultContentToText(content: readonly ToolResultContentPart[]): string {\n  return content\n    .map((item) => (item.type === \"text\" ? item.text : `[file:${item.mediaType}]`))\n    .join(\"\\n\");\n}\n\nfunction isRichToolOutput(value: unknown): value is RichToolOutput {\n  if (typeof value !== \"object\" || value === null) return false;\n  return Object.getOwnPropertyDescriptor(value, richToolOutput)?.value === true;\n}\n\nexport function parseToolArgs(args: string): JsonValue {\n  const value: unknown = JSON.parse(args);\n  if (!isJsonValue(value)) {\n    throw new TypeError(\"Tool arguments must be a JSON value.\");\n  }\n  return value;\n}\n","import { ToolCallError, ToolJsonError } from \"../../tool/errors\";\nimport {\n  type AnyTool,\n  type NormalizedToolOutput,\n  normalizeToolResultOutput,\n  parseToolArgs,\n  type ToolCallContext,\n} from \"../../tool/tool\";\n\nconst preparedToolInputSymbol = Symbol(\"preparedToolInput\");\nconst preparedToolOwnerSymbol = Symbol(\"preparedToolOwner\");\n\nexport type PreparedToolCall = {\n  input: unknown;\n  call(context: ToolCallContext): Promise<NormalizedToolOutput>;\n};\n\ntype PreparedToolCallContext = ToolCallContext & {\n  [preparedToolInputSymbol]?: { owner: object; input: unknown };\n};\n\ntype ToolWithPreparedOwner = AnyTool & {\n  [preparedToolOwnerSymbol]?: object;\n};\n\nexport function attachPreparedToolOwner<T extends AnyTool>(tool: T, owner: object): T {\n  Object.defineProperty(tool, preparedToolOwnerSymbol, {\n    configurable: false,\n    enumerable: true,\n    value: owner,\n    writable: false,\n  });\n  return tool;\n}\n\nexport function preparedToolInput(\n  context: ToolCallContext | undefined,\n  owner: object,\n): { input: unknown } | undefined {\n  if (context === undefined || !(preparedToolInputSymbol in context)) {\n    return undefined;\n  }\n  const prepared = (context as PreparedToolCallContext)[preparedToolInputSymbol];\n  return prepared?.owner === owner ? { input: prepared.input } : undefined;\n}\n\nexport function withoutPreparedToolInput(context: ToolCallContext): ToolCallContext {\n  if (!(preparedToolInputSymbol in context)) {\n    return context;\n  }\n  const { [preparedToolInputSymbol]: _prepared, ...publicContext } =\n    context as PreparedToolCallContext;\n  return publicContext;\n}\n\nexport function prepareToolCall(tool: AnyTool, args: string): PreparedToolCall {\n  let rawInput: ReturnType<typeof parseToolArgs>;\n  try {\n    rawInput = parseToolArgs(args);\n  } catch (error) {\n    throw new ToolJsonError(`Invalid JSON arguments for tool ${tool.name}`, error);\n  }\n\n  let input: unknown;\n  try {\n    input = tool.parseInput === undefined ? rawInput : tool.parseInput(rawInput);\n  } catch (error) {\n    throw asToolCallError(tool.name, error);\n  }\n\n  return prepareToolCallFromInput(tool, input);\n}\n\nexport function prepareToolCallFromInput(tool: AnyTool, input: unknown): PreparedToolCall {\n  return {\n    input,\n    async call(context) {\n      try {\n        const owner = (tool as ToolWithPreparedOwner)[preparedToolOwnerSymbol];\n        return normalizeToolResultOutput(\n          await tool.call(\n            input,\n            owner === undefined ? context : withPreparedToolInput(context, owner, input),\n          ),\n        );\n      } catch (error) {\n        throw asToolCallError(tool.name, error);\n      }\n    },\n  };\n}\n\nfunction withPreparedToolInput(\n  context: ToolCallContext,\n  owner: object,\n  input: unknown,\n): ToolCallContext {\n  const preparedContext: PreparedToolCallContext = { ...context };\n  Object.defineProperty(preparedContext, preparedToolInputSymbol, {\n    configurable: false,\n    enumerable: true,\n    value: { owner, input },\n    writable: false,\n  });\n  return preparedContext;\n}\n\nfunction asToolCallError(toolName: string, error: unknown): ToolCallError {\n  if (error instanceof ToolCallError) {\n    return error;\n  }\n  return error instanceof Error\n    ? new ToolCallError(error.message, error)\n    : new ToolCallError(`Tool ${toolName} failed`, error);\n}\n","import type { z } from \"zod\";\nimport { assertToolApprovalRequirement } from \"../internal/agent-runtime/approval-requirement\";\nimport {\n  attachPreparedToolOwner,\n  preparedToolInput,\n  withoutPreparedToolInput,\n} from \"../internal/agent-runtime/prepared-tool-call\";\nimport { toProviderJsonSchema, type ZodSchema } from \"../schema/zod-schema\";\nimport type { Tool, ToolCallContext, ToolRequiresApproval } from \"./tool\";\n\nexport type CreateToolOptions<\n  InputSchema extends ZodSchema,\n  OutputSchema extends ZodSchema | undefined = undefined,\n  Output = unknown,\n> = {\n  name: string;\n  description: string;\n  inputSchema: InputSchema;\n  outputSchema?: OutputSchema;\n  requiresApproval?: ToolRequiresApproval<z.output<InputSchema>>;\n  execute(\n    args: z.output<InputSchema>,\n    context: ToolCallContext,\n  ): OutputSchema extends ZodSchema\n    ? z.input<OutputSchema> | Promise<z.input<OutputSchema>>\n    : Output | Promise<Output>;\n};\n\ntype CreateToolOutput<\n  OutputSchema extends ZodSchema | undefined,\n  Output,\n> = OutputSchema extends ZodSchema ? z.output<OutputSchema> : Output;\n\nexport function createTool<InputSchema extends ZodSchema, Output = unknown>(\n  options: CreateToolOptions<InputSchema, undefined, Output> & { outputSchema?: undefined },\n): Tool<z.output<InputSchema>, Output>;\n\nexport function createTool<InputSchema extends ZodSchema, OutputSchema extends ZodSchema>(\n  options: CreateToolOptions<InputSchema, OutputSchema>,\n): Tool<z.output<InputSchema>, z.output<OutputSchema>>;\n\nexport function createTool<\n  InputSchema extends ZodSchema,\n  OutputSchema extends ZodSchema | undefined = undefined,\n  Output = unknown,\n>(\n  options: CreateToolOptions<InputSchema, OutputSchema, Output>,\n): Tool<z.output<InputSchema>, CreateToolOutput<OutputSchema, Output>> {\n  const { name, description, inputSchema, outputSchema, execute } = options;\n  const requiresApproval = snapshotApprovalRequirement(options.requiresApproval);\n  if (requiresApproval !== undefined) {\n    assertToolApprovalRequirement(requiresApproval, { allowFunction: true });\n  }\n  const parameters = toProviderJsonSchema(inputSchema);\n  const preparedInputOwner = {};\n  const definition = () => ({\n    name,\n    description,\n    parameters: globalThis.structuredClone(parameters),\n  });\n  const call = async (\n    args: z.output<InputSchema>,\n    context: ToolCallContext = {},\n  ): Promise<CreateToolOutput<OutputSchema, Output>> => {\n    const prepared = preparedToolInput(context, preparedInputOwner);\n    const parsedArgs =\n      prepared === undefined ? inputSchema.parse(args) : (prepared.input as z.output<InputSchema>);\n    const executionContext = prepared === undefined ? context : withoutPreparedToolInput(context);\n    const result = await execute(parsedArgs, executionContext);\n    return (outputSchema === undefined ? result : outputSchema.parse(result)) as CreateToolOutput<\n      OutputSchema,\n      Output\n    >;\n  };\n  const parseInput = (args: unknown): z.output<InputSchema> => inputSchema.parse(args);\n\n  const tool: Tool<z.output<InputSchema>, CreateToolOutput<OutputSchema, Output>> = {\n    name,\n    definition,\n    call,\n    parseInput,\n  };\n  if (requiresApproval !== undefined) {\n    Object.defineProperty(tool, \"requiresApproval\", {\n      configurable: false,\n      enumerable: true,\n      value: requiresApproval,\n      writable: false,\n    });\n  }\n  return attachPreparedToolOwner(tool, preparedInputOwner);\n}\n\nfunction snapshotApprovalRequirement<Args>(\n  requirement: ToolRequiresApproval<Args> | undefined,\n): ToolRequiresApproval<Args> | undefined {\n  return typeof requirement === \"object\" && requirement !== null\n    ? Object.freeze({ ...requirement })\n    : requirement;\n}\n","import type { VectorMetadata, VectorMetadataValue } from \"../embeddings\";\nimport type { VectorFilter } from \"./types\";\n\nexport type { VectorFilter } from \"./types\";\n\nexport const vectorFilter = {\n  eq(key: string, value: VectorMetadataValue): VectorFilter {\n    return { type: \"eq\", key, value };\n  },\n  gt(key: string, value: VectorMetadataValue): VectorFilter {\n    return { type: \"gt\", key, value };\n  },\n  lt(key: string, value: VectorMetadataValue): VectorFilter {\n    return { type: \"lt\", key, value };\n  },\n  and(left: VectorFilter, right: VectorFilter): VectorFilter {\n    return { type: \"and\", filters: [left, right] };\n  },\n  or(left: VectorFilter, right: VectorFilter): VectorFilter {\n    return { type: \"or\", filters: [left, right] };\n  },\n};\n\nexport function matchesVectorFilter(\n  metadata: VectorMetadata | undefined,\n  filter: VectorFilter | undefined,\n): boolean {\n  if (filter === undefined) {\n    return true;\n  }\n  if (metadata === undefined) {\n    return false;\n  }\n\n  switch (filter.type) {\n    case \"eq\":\n      return metadata[filter.key] === filter.value;\n    case \"gt\":\n      return compare(metadata[filter.key], filter.value) > 0;\n    case \"lt\":\n      return compare(metadata[filter.key], filter.value) < 0;\n    case \"and\":\n      return (\n        matchesVectorFilter(metadata, filter.filters[0]) &&\n        matchesVectorFilter(metadata, filter.filters[1])\n      );\n    case \"or\":\n      return (\n        matchesVectorFilter(metadata, filter.filters[0]) ||\n        matchesVectorFilter(metadata, filter.filters[1])\n      );\n  }\n}\n\nfunction compare(left: VectorMetadataValue | undefined, right: VectorMetadataValue): number {\n  if (typeof left === \"number\" && typeof right === \"number\") {\n    return left - right;\n  }\n  if (typeof left === \"string\" && typeof right === \"string\") {\n    return left.localeCompare(right);\n  }\n  if (typeof left === \"boolean\" && typeof right === \"boolean\") {\n    return Number(left) - Number(right);\n  }\n  return 0;\n}\n","import type { LshOptions } from \"./types\";\n\nexport type { LshOptions } from \"./types\";\n\nexport class LshIndex {\n  private readonly hyperplanes: number[][];\n  private readonly tables: Array<Map<string, Set<string>>>;\n\n  constructor(\n    dimensions: number,\n    private readonly options: LshOptions,\n  ) {\n    const rng = seededRandom(options.seed ?? 42);\n    this.hyperplanes = [];\n    for (let index = 0; index < options.numTables * options.numHyperplanes; index += 1) {\n      const plane = Array.from({ length: dimensions }, () => rng() * 2 - 1);\n      const norm = Math.sqrt(plane.reduce((sum, value) => sum + value ** 2, 0));\n      this.hyperplanes.push(norm === 0 ? plane : plane.map((value) => value / norm));\n    }\n    this.tables = Array.from({ length: options.numTables }, () => new Map());\n  }\n\n  insert(id: string, vector: number[]): void {\n    for (let table = 0; table < this.options.numTables; table += 1) {\n      const hash = this.hash(vector, table);\n      const bucket = this.tables[table]?.get(hash) ?? new Set<string>();\n      bucket.add(id);\n      this.tables[table]?.set(hash, bucket);\n    }\n  }\n\n  query(vector: number[]): Set<string> {\n    const candidates = new Set<string>();\n    for (let table = 0; table < this.options.numTables; table += 1) {\n      const hash = this.hash(vector, table);\n      for (const id of this.tables[table]?.get(hash) ?? []) {\n        candidates.add(id);\n      }\n    }\n    return candidates;\n  }\n\n  private hash(vector: number[], table: number): string {\n    let hash = \"\";\n    const start = table * this.options.numHyperplanes;\n    for (let offset = 0; offset < this.options.numHyperplanes; offset += 1) {\n      const plane = this.hyperplanes[start + offset] as number[];\n      const dot = vector.reduce((sum, value, index) => sum + value * (plane[index] ?? 0), 0);\n      hash += dot >= 0 ? \"1\" : \"0\";\n    }\n    return hash;\n  }\n}\n\nfunction seededRandom(seed: number): () => number {\n  let state = seed >>> 0;\n  return () => {\n    state = (state * 1664525 + 1013904223) >>> 0;\n    return state / 0x100000000;\n  };\n}\n","import { embedSparseQuery, embedText, type VectorMetadata } from \"../embeddings\";\nimport { throwIfAborted } from \"../internal/abort\";\nimport { assertFiniteMinScore, assertPositiveSearchLimit } from \"../internal/vector-search-options\";\nimport { type ResolvedRetryOptions, resolveRetryOptions, runWithRetries } from \"../retry\";\nimport type {\n  RetrieveDocumentsOptions,\n  RetrieveHybridDocumentsOptions,\n  VectorSearchResult,\n} from \"./types\";\n\nexport function retrieveDocuments<T, Metadata extends VectorMetadata = VectorMetadata>(\n  options: RetrieveDocumentsOptions<T, Metadata>,\n): Promise<Array<VectorSearchResult<T, Metadata>>>;\nexport function retrieveDocuments<T, Metadata extends VectorMetadata = VectorMetadata>(\n  options: RetrieveHybridDocumentsOptions<T, Metadata>,\n): Promise<Array<VectorSearchResult<T, Metadata>>>;\nexport async function retrieveDocuments<T, Metadata extends VectorMetadata = VectorMetadata>(\n  options: RetrieveDocumentsOptions<T, Metadata> | RetrieveHybridDocumentsOptions<T, Metadata>,\n): Promise<Array<VectorSearchResult<T, Metadata>>> {\n  assertPositiveSearchLimit(options.topK);\n  assertFiniteMinScore(options.minScore);\n  throwIfAborted(options.abortSignal);\n  const retries = resolveRetries(options.retries);\n  const search = (operation: () => Promise<Array<VectorSearchResult<T, Metadata>>>) =>\n    runWithRetries(operation, retries, {\n      streaming: false,\n      abortSignal: options.abortSignal,\n    });\n\n  if (\"model\" in options && options.model !== undefined) {\n    const { embedding } = await embedText({\n      model: options.model,\n      text: options.query,\n      retries: options.retries,\n      abortSignal: options.abortSignal,\n    });\n    return deduplicateResults(\n      await search(() =>\n        options.store.search({\n          vector: embedding.vector,\n          topK: options.topK,\n          minScore: options.minScore,\n          filter: options.filter,\n          abortSignal: options.abortSignal,\n        }),\n      ),\n    );\n  }\n\n  const [{ embedding: dense }, { embedding: sparse }] = await Promise.all([\n    embedText({\n      model: options.models.dense,\n      text: options.query,\n      retries: options.retries,\n      abortSignal: options.abortSignal,\n    }),\n    embedSparseQuery({\n      model: options.models.sparse,\n      query: options.query,\n      retries: options.retries,\n      abortSignal: options.abortSignal,\n    }),\n  ]);\n  return deduplicateResults(\n    await search(() =>\n      options.store.searchHybrid({\n        vector: dense.vector,\n        sparseVector: sparse.vector,\n        fusion: options.fusion,\n        topK: options.topK,\n        minScore: options.minScore,\n        filter: options.filter,\n        abortSignal: options.abortSignal,\n      }),\n    ),\n  );\n}\n\nfunction deduplicateResults<T, Metadata extends VectorMetadata>(\n  results: Array<VectorSearchResult<T, Metadata>>,\n): Array<VectorSearchResult<T, Metadata>> {\n  const bestById = new Map<string, VectorSearchResult<T, Metadata>>();\n  for (const result of results) {\n    const current = bestById.get(result.id);\n    if (current === undefined || result.score > current.score) bestById.set(result.id, result);\n  }\n  return [...bestById.values()].sort((left, right) => right.score - left.score);\n}\n\nfunction resolveRetries(\n  setting: RetrieveDocumentsOptions<unknown>[\"retries\"],\n): ResolvedRetryOptions | undefined {\n  return setting === undefined || setting === false ? undefined : resolveRetryOptions(setting);\n}\n","import type { JsonObject } from \"../completion\";\nimport {\n  chunkTextDocuments,\n  type TextDocument,\n  type TextDocumentChunk,\n  type TextDocumentChunkingOptions,\n} from \"../documents\";\nimport {\n  embedDocuments,\n  type EmbeddedDocument,\n  type EmbeddingModel,\n  type VectorMetadata,\n  type VectorMetadataValue,\n} from \"../embeddings\";\nimport type { RetrySetting } from \"../retry\";\nimport type { VectorStore } from \"./types\";\n\nexport type IngestVectorDocumentsOptions<Metadata extends VectorMetadata = VectorMetadata> =\n  Readonly<{\n    store: VectorStore<TextDocument<Metadata>, Metadata>;\n    documents: readonly TextDocument<Metadata>[];\n    embeddingModel: EmbeddingModel;\n    chunking?: TextDocumentChunkingOptions | undefined;\n    retries?: RetrySetting | undefined;\n    concurrency?: number | undefined;\n    providerOptions?: JsonObject | undefined;\n    abortSignal?: AbortSignal | undefined;\n  }>;\n\nexport type IngestVectorTextOptions<Metadata extends VectorMetadata = VectorMetadata> = Omit<\n  IngestVectorDocumentsOptions<Metadata>,\n  \"documents\"\n> &\n  Readonly<{ document: TextDocument<Metadata> }>;\n\nexport type IngestVectorDocumentsResult<Metadata extends VectorMetadata = VectorMetadata> =\n  Readonly<{\n    documents: readonly EmbeddedDocument<TextDocument<Metadata>, Metadata>[];\n  }>;\n\nexport async function ingestVectorText<Metadata extends VectorMetadata = VectorMetadata>(\n  options: IngestVectorTextOptions<Metadata>,\n): Promise<IngestVectorDocumentsResult<Metadata>> {\n  return ingestVectorDocuments({\n    store: options.store,\n    documents: [options.document],\n    embeddingModel: options.embeddingModel,\n    chunking: options.chunking,\n    retries: options.retries,\n    concurrency: options.concurrency,\n    providerOptions: options.providerOptions,\n    abortSignal: options.abortSignal,\n  });\n}\n\nexport async function ingestVectorDocuments<Metadata extends VectorMetadata = VectorMetadata>(\n  options: IngestVectorDocumentsOptions<Metadata>,\n): Promise<IngestVectorDocumentsResult<Metadata>> {\n  for (const document of options.documents) {\n    validateVectorMetadata(document.metadata, document.id);\n  }\n  const chunks = chunkTextDocuments({\n    documents: options.documents,\n    chunking: options.chunking,\n  });\n  const chunksByDocument = groupChunksByDocument(chunks);\n  const embedded = await embedDocuments({\n    model: options.embeddingModel,\n    documents: [...options.documents],\n    id: (document) => document.id,\n    content: (document) => {\n      const documentChunks = chunksByDocument.get(document.id);\n      if (documentChunks === undefined) {\n        throw new TypeError(`Text document ${document.id} has no chunks`);\n      }\n      return documentChunks.map((chunk) => chunk.text);\n    },\n    metadata: (document) => document.metadata,\n    retries: options.retries,\n    concurrency: options.concurrency,\n    abortSignal: options.abortSignal,\n  });\n  await options.store.upsert({\n    documents: embedded.documents,\n    providerOptions: options.providerOptions,\n  });\n  return { documents: embedded.documents };\n}\n\nfunction validateVectorMetadata(metadata: VectorMetadata | undefined, documentId: string): void {\n  if (metadata === undefined) {\n    return;\n  }\n  if (typeof metadata !== \"object\" || metadata === null || Array.isArray(metadata)) {\n    throw new TypeError(`Text document ${documentId} metadata must be an object`);\n  }\n  for (const [key, value] of Object.entries(metadata)) {\n    validateVectorMetadataValue(value, `Text document ${documentId} metadata.${key}`);\n  }\n}\n\nfunction validateVectorMetadataValue(value: VectorMetadataValue, label: string): void {\n  if (value === null || typeof value === \"string\" || typeof value === \"boolean\") {\n    return;\n  }\n  if (typeof value !== \"number\" || !Number.isFinite(value)) {\n    throw new TypeError(`${label} must be a finite vector metadata value`);\n  }\n  if (Number.isInteger(value) && !Number.isSafeInteger(value)) {\n    throw new TypeError(`${label} must be a safe integer`);\n  }\n}\n\nfunction groupChunksByDocument<Metadata>(\n  chunks: readonly TextDocumentChunk<Metadata>[],\n): ReadonlyMap<string, readonly TextDocumentChunk<Metadata>[]> {\n  const grouped = new Map<string, TextDocumentChunk<Metadata>[]>();\n  for (const chunk of chunks) {\n    const documentChunks = grouped.get(chunk.documentId);\n    if (documentChunks === undefined) {\n      grouped.set(chunk.documentId, [chunk]);\n    } else {\n      documentChunks.push(chunk);\n    }\n  }\n  return grouped;\n}\n"],"mappings":"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","names":["throwIfAborted"]}