wiki-graph-core 0.3.1 → 0.4.1

package/dist/retrieval/query/continuation-cursor/payload.js

@@ -0,0 +1,285 @@
+function createCursorPayload(input) {
+  switch (input.kind) {
+    case "collection":
+      return {
+        ...input.backlinks === void 0 ? {} : { backlinks: input.backlinks },
+        chapters: input.chapters,
+        cursor: input.cursor,
+        ...input.evidenceLimit === void 0 ? {} : { evidenceLimit: input.evidenceLimit },
+        ids: input.ids,
+        order: input.order,
+        ...input.sourceContext === void 0 ? {} : { sourceContext: input.sourceContext },
+        ...input.triplePattern === void 0 ? {} : { triplePattern: input.triplePattern },
+        indexScope: input.indexScope,
+        types: input.types
+      };
+    case "search":
+      return {
+        ...input.backlinks === void 0 ? {} : { backlinks: input.backlinks },
+        chapters: input.chapters,
+        cursor: input.cursor,
+        ...input.evidenceLimit === void 0 ? {} : { evidenceLimit: input.evidenceLimit },
+        ...input.query === void 0 ? {} : { query: input.query },
+        ...input.sourceContext === void 0 ? {} : { sourceContext: input.sourceContext },
+        ...input.triplePattern === void 0 ? {} : { triplePattern: input.triplePattern },
+        indexScope: input.indexScope,
+        types: input.types
+      };
+    case "evidence":
+      return {
+        cursor: input.cursor,
+        order: input.order,
+        ...input.query === void 0 ? {} : { query: input.query },
+        ...input.sourceContext === void 0 ? {} : { sourceContext: input.sourceContext },
+        indexScope: input.indexScope,
+        targetUri: input.targetUri
+      };
+    case "related":
+      return {
+        cursor: input.cursor,
+        ...input.evidenceLimit === void 0 ? {} : { evidenceLimit: input.evidenceLimit },
+        order: input.order,
+        ...input.query === void 0 ? {} : { query: input.query },
+        ...input.role === void 0 ? {} : { role: input.role },
+        ...input.sourceContext === void 0 ? {} : { sourceContext: input.sourceContext },
+        indexScope: input.indexScope,
+        targetUri: input.targetUri
+      };
+  }
+}
+function parseContinuationCursorRecord(record) {
+  const payload = parsePayload(record.payloadJSON);
+  const indexScope = readCursorIndexScope(payload, record);
+  if (record.kind === "collection") {
+    return {
+      archiveKey: record.archiveKey,
+      archivePath: record.archivePath,
+      ...getPayloadOptionalBoolean(payload, "backlinks"),
+      chapters: getPayloadNumberArrayOrNull(payload, "chapters"),
+      cursor: getPayloadString(payload, "cursor"),
+      ...getPayloadOptionalPositiveInteger(payload, "evidenceLimit"),
+      format: record.format,
+      ids: getPayloadStringArrayOrNull(payload, "ids"),
+      indexScope,
+      kind: "collection",
+      order: getPayloadOrder(payload),
+      ...getPayloadOptionalInteger(payload, "sourceContext", "sourceContext"),
+      ...getPayloadOptionalTriplePattern(payload),
+      types: getPayloadStringArrayOrNull(payload, "types")
+    };
+  }
+  if (record.kind === "search") {
+    return {
+      archiveKey: record.archiveKey,
+      archivePath: record.archivePath,
+      ...getPayloadOptionalBoolean(payload, "backlinks"),
+      chapters: getPayloadNumberArrayOrNull(payload, "chapters"),
+      cursor: getPayloadString(payload, "cursor"),
+      ...getPayloadOptionalPositiveInteger(payload, "evidenceLimit"),
+      format: record.format,
+      indexScope,
+      kind: "search",
+      ...getPayloadOptionalString(payload, "query"),
+      ...getPayloadOptionalInteger(payload, "sourceContext", "sourceContext"),
+      ...getPayloadOptionalTriplePattern(payload),
+      types: getPayloadStringArrayOrNull(payload, "types")
+    };
+  }
+  if (record.kind === "evidence") {
+    return {
+      archiveKey: record.archiveKey,
+      archivePath: record.archivePath,
+      cursor: getPayloadString(payload, "cursor"),
+      format: record.format,
+      indexScope,
+      kind: "evidence",
+      order: getPayloadOrder(payload),
+      ...getPayloadOptionalString(payload, "query"),
+      ...getPayloadOptionalInteger(payload, "sourceContext", "sourceContext"),
+      targetUri: getPayloadString(payload, "targetUri")
+    };
+  }
+  if (record.kind === "related") {
+    return {
+      archiveKey: record.archiveKey,
+      archivePath: record.archivePath,
+      cursor: getPayloadString(payload, "cursor"),
+      ...getPayloadOptionalPositiveInteger(payload, "evidenceLimit"),
+      format: record.format,
+      indexScope,
+      kind: "related",
+      order: getPayloadOrder(payload),
+      ...getPayloadOptionalString(payload, "query"),
+      ...getPayloadOptionalRelatedRole(payload),
+      ...getPayloadOptionalInteger(payload, "sourceContext", "sourceContext"),
+      targetUri: getPayloadString(payload, "targetUri")
+    };
+  }
+  throw new Error(`Invalid continuation cursor kind: ${record.kind}.`);
+}
+function readCursorIndexScope(payload, record) {
+  const value = payload.indexScope;
+  if (value === void 0) {
+    return {
+      archiveKey: record.archiveKey,
+      archivePath: record.archivePath,
+      kind: "archive-index"
+    };
+  }
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    throw new Error("Invalid continuation cursor payload.");
+  }
+  const indexScope = value;
+  if (indexScope.kind === "archive-index") {
+    const archiveKey = getPayloadString(indexScope, "archiveKey");
+    const archivePath = getPayloadString(indexScope, "archivePath");
+    if (archiveKey !== record.archiveKey || archivePath !== record.archivePath) {
+      throw new Error("Invalid continuation cursor payload.");
+    }
+    return {
+      archiveKey,
+      archivePath,
+      kind: "archive-index"
+    };
+  }
+  if (indexScope.kind === "library-index") {
+    const libraryId = indexScope.libraryId;
+    if (typeof libraryId === "number" && Number.isInteger(libraryId)) {
+      return { kind: "library-index", libraryId };
+    }
+  }
+  throw new Error("Invalid continuation cursor payload.");
+}
+function parsePayload(value) {
+  const parsed = JSON.parse(value);
+  if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
+    return parsed;
+  }
+  throw new Error("Invalid continuation cursor payload.");
+}
+function getPayloadString(payload, key) {
+  const value = payload[key];
+  if (typeof value === "string") {
+    return value;
+  }
+  throw new Error("Invalid continuation cursor payload.");
+}
+function getPayloadStringArrayOrNull(payload, key) {
+  const value = payload[key];
+  if (value === null) {
+    return null;
+  }
+  if (Array.isArray(value) && value.every((item) => typeof item === "string")) {
+    return value;
+  }
+  throw new Error("Invalid continuation cursor payload.");
+}
+function getPayloadOptionalString(payload, key) {
+  const value = payload[key];
+  if (value === void 0) {
+    return {};
+  }
+  if (typeof value === "string") {
+    return { query: value };
+  }
+  throw new Error("Invalid continuation cursor payload.");
+}
+function getPayloadNumberArrayOrNull(payload, key) {
+  const value = payload[key];
+  if (value === void 0 || value === null) {
+    return null;
+  }
+  if (Array.isArray(value)) {
+    const numbers = [];
+    for (const item of value) {
+      if (typeof item !== "number" || !Number.isInteger(item)) {
+        throw new Error("Invalid continuation cursor payload.");
+      }
+      numbers.push(item);
+    }
+    return numbers;
+  }
+  throw new Error("Invalid continuation cursor payload.");
+}
+function getPayloadOrder(payload) {
+  const value = payload.order;
+  if (value === "doc-asc" || value === "doc-desc") {
+    return value;
+  }
+  throw new Error("Invalid continuation cursor payload.");
+}
+function getPayloadOptionalPositiveInteger(payload, key) {
+  const value = payload[key];
+  if (value === void 0) {
+    return {};
+  }
+  if (typeof value === "number" && Number.isInteger(value) && value > 0) {
+    return { evidenceLimit: value };
+  }
+  throw new Error("Invalid continuation cursor payload.");
+}
+function getPayloadOptionalInteger(payload, key, outputKey) {
+  const value = payload[key];
+  if (value === void 0) {
+    return {};
+  }
+  if (typeof value === "number" && Number.isInteger(value) && value >= 0) {
+    return { [outputKey]: value };
+  }
+  throw new Error("Invalid continuation cursor payload.");
+}
+function getPayloadOptionalBoolean(payload, key) {
+  const value = payload[key];
+  if (value === void 0) {
+    return {};
+  }
+  if (typeof value === "boolean") {
+    return { backlinks: value };
+  }
+  throw new Error("Invalid continuation cursor payload.");
+}
+function getPayloadOptionalRelatedRole(payload) {
+  const value = payload.role;
+  if (value === void 0) {
+    return {};
+  }
+  if (value === "any" || value === "object" || value === "self" || value === "subject") {
+    return { role: value };
+  }
+  throw new Error("Invalid continuation cursor payload.");
+}
+function getPayloadOptionalTriplePattern(payload) {
+  const value = payload.triplePattern;
+  if (value === void 0) {
+    return {};
+  }
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    throw new Error("Invalid continuation cursor payload.");
+  }
+  const pattern = value;
+  const subjectQid = getOptionalPayloadStringProperty(pattern, "subjectQid");
+  const predicate = getOptionalPayloadStringProperty(pattern, "predicate");
+  const objectQid = getOptionalPayloadStringProperty(pattern, "objectQid");
+  return {
+    triplePattern: {
+      ...objectQid === void 0 ? {} : { objectQid },
+      ...predicate === void 0 ? {} : { predicate },
+      ...subjectQid === void 0 ? {} : { subjectQid }
+    }
+  };
+}
+function getOptionalPayloadStringProperty(payload, key) {
+  const value = payload[key];
+  if (value === void 0) {
+    return void 0;
+  }
+  if (typeof value === "string") {
+    return value;
+  }
+  throw new Error("Invalid continuation cursor payload.");
+}
+export {
+  createCursorPayload,
+  parseContinuationCursorRecord
+};
+//# sourceMappingURL=payload.js.map

package/dist/retrieval/query/continuation-cursor/payload.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/retrieval/query/continuation-cursor/payload.ts"],"sourcesContent":["import type { ContinuationCursor, QueryIndexScope } from \"./types.js\";\n\nexport function createCursorPayload(input: ContinuationCursor): object {\n  switch (input.kind) {\n    case \"collection\":\n      return {\n        ...(input.backlinks === undefined\n          ? {}\n          : { backlinks: input.backlinks }),\n        chapters: input.chapters,\n        cursor: input.cursor,\n        ...(input.evidenceLimit === undefined\n          ? {}\n          : { evidenceLimit: input.evidenceLimit }),\n        ids: input.ids,\n        order: input.order,\n        ...(input.sourceContext === undefined\n          ? {}\n          : { sourceContext: input.sourceContext }),\n        ...(input.triplePattern === undefined\n          ? {}\n          : { triplePattern: input.triplePattern }),\n        indexScope: input.indexScope,\n        types: input.types,\n      };\n    case \"search\":\n      return {\n        ...(input.backlinks === undefined\n          ? {}\n          : { backlinks: input.backlinks }),\n        chapters: input.chapters,\n        cursor: input.cursor,\n        ...(input.evidenceLimit === undefined\n          ? {}\n          : { evidenceLimit: input.evidenceLimit }),\n        ...(input.query === undefined ? {} : { query: input.query }),\n        ...(input.sourceContext === undefined\n          ? {}\n          : { sourceContext: input.sourceContext }),\n        ...(input.triplePattern === undefined\n          ? {}\n          : { triplePattern: input.triplePattern }),\n        indexScope: input.indexScope,\n        types: input.types,\n      };\n    case \"evidence\":\n      return {\n        cursor: input.cursor,\n        order: input.order,\n        ...(input.query === undefined ? {} : { query: input.query }),\n        ...(input.sourceContext === undefined\n          ? {}\n          : { sourceContext: input.sourceContext }),\n        indexScope: input.indexScope,\n        targetUri: input.targetUri,\n      };\n    case \"related\":\n      return {\n        cursor: input.cursor,\n        ...(input.evidenceLimit === undefined\n          ? {}\n          : { evidenceLimit: input.evidenceLimit }),\n        order: input.order,\n        ...(input.query === undefined ? {} : { query: input.query }),\n        ...(input.role === undefined ? {} : { role: input.role }),\n        ...(input.sourceContext === undefined\n          ? {}\n          : { sourceContext: input.sourceContext }),\n        indexScope: input.indexScope,\n        targetUri: input.targetUri,\n      };\n  }\n}\n\nexport function parseContinuationCursorRecord(record: {\n  readonly archiveKey: string;\n  readonly archivePath: string;\n  readonly format: \"json\" | \"jsonl\" | \"text\";\n  readonly kind: string;\n  readonly payloadJSON: string;\n}): ContinuationCursor {\n  const payload = parsePayload(record.payloadJSON);\n  const indexScope = readCursorIndexScope(payload, record);\n\n  if (record.kind === \"collection\") {\n    return {\n      archiveKey: record.archiveKey,\n      archivePath: record.archivePath,\n      ...getPayloadOptionalBoolean(payload, \"backlinks\"),\n      chapters: getPayloadNumberArrayOrNull(payload, \"chapters\"),\n      cursor: getPayloadString(payload, \"cursor\"),\n      ...getPayloadOptionalPositiveInteger(payload, \"evidenceLimit\"),\n      format: record.format,\n      ids: getPayloadStringArrayOrNull(payload, \"ids\"),\n      indexScope,\n      kind: \"collection\",\n      order: getPayloadOrder(payload),\n      ...getPayloadOptionalInteger(payload, \"sourceContext\", \"sourceContext\"),\n      ...getPayloadOptionalTriplePattern(payload),\n      types: getPayloadStringArrayOrNull(payload, \"types\"),\n    };\n  }\n\n  if (record.kind === \"search\") {\n    return {\n      archiveKey: record.archiveKey,\n      archivePath: record.archivePath,\n      ...getPayloadOptionalBoolean(payload, \"backlinks\"),\n      chapters: getPayloadNumberArrayOrNull(payload, \"chapters\"),\n      cursor: getPayloadString(payload, \"cursor\"),\n      ...getPayloadOptionalPositiveInteger(payload, \"evidenceLimit\"),\n      format: record.format,\n      indexScope,\n      kind: \"search\",\n      ...getPayloadOptionalString(payload, \"query\"),\n      ...getPayloadOptionalInteger(payload, \"sourceContext\", \"sourceContext\"),\n      ...getPayloadOptionalTriplePattern(payload),\n      types: getPayloadStringArrayOrNull(payload, \"types\"),\n    };\n  }\n\n  if (record.kind === \"evidence\") {\n    return {\n      archiveKey: record.archiveKey,\n      archivePath: record.archivePath,\n      cursor: getPayloadString(payload, \"cursor\"),\n      format: record.format,\n      indexScope,\n      kind: \"evidence\",\n      order: getPayloadOrder(payload),\n      ...getPayloadOptionalString(payload, \"query\"),\n      ...getPayloadOptionalInteger(payload, \"sourceContext\", \"sourceContext\"),\n      targetUri: getPayloadString(payload, \"targetUri\"),\n    };\n  }\n\n  if (record.kind === \"related\") {\n    return {\n      archiveKey: record.archiveKey,\n      archivePath: record.archivePath,\n      cursor: getPayloadString(payload, \"cursor\"),\n      ...getPayloadOptionalPositiveInteger(payload, \"evidenceLimit\"),\n      format: record.format,\n      indexScope,\n      kind: \"related\",\n      order: getPayloadOrder(payload),\n      ...getPayloadOptionalString(payload, \"query\"),\n      ...getPayloadOptionalRelatedRole(payload),\n      ...getPayloadOptionalInteger(payload, \"sourceContext\", \"sourceContext\"),\n      targetUri: getPayloadString(payload, \"targetUri\"),\n    };\n  }\n\n  throw new Error(`Invalid continuation cursor kind: ${record.kind}.`);\n}\n\nfunction readCursorIndexScope(\n  payload: Readonly<Record<string, unknown>>,\n  record: { readonly archiveKey: string; readonly archivePath: string },\n): QueryIndexScope {\n  const value = payload.indexScope;\n\n  if (value === undefined) {\n    return {\n      archiveKey: record.archiveKey,\n      archivePath: record.archivePath,\n      kind: \"archive-index\",\n    };\n  }\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    throw new Error(\"Invalid continuation cursor payload.\");\n  }\n\n  const indexScope = value as Record<string, unknown>;\n  if (indexScope.kind === \"archive-index\") {\n    const archiveKey = getPayloadString(indexScope, \"archiveKey\");\n    const archivePath = getPayloadString(indexScope, \"archivePath\");\n    if (\n      archiveKey !== record.archiveKey ||\n      archivePath !== record.archivePath\n    ) {\n      throw new Error(\"Invalid continuation cursor payload.\");\n    }\n    return {\n      archiveKey,\n      archivePath,\n      kind: \"archive-index\",\n    };\n  }\n  if (indexScope.kind === \"library-index\") {\n    const libraryId = indexScope.libraryId;\n    if (typeof libraryId === \"number\" && Number.isInteger(libraryId)) {\n      return { kind: \"library-index\", libraryId };\n    }\n  }\n\n  throw new Error(\"Invalid continuation cursor payload.\");\n}\n\nfunction parsePayload(value: string): Record<string, unknown> {\n  const parsed: unknown = JSON.parse(value);\n\n  if (typeof parsed === \"object\" && parsed !== null && !Array.isArray(parsed)) {\n    return parsed as Record<string, unknown>;\n  }\n\n  throw new Error(\"Invalid continuation cursor payload.\");\n}\n\nfunction getPayloadString(\n  payload: Readonly<Record<string, unknown>>,\n  key: string,\n): string {\n  const value = payload[key];\n\n  if (typeof value === \"string\") {\n    return value;\n  }\n\n  throw new Error(\"Invalid continuation cursor payload.\");\n}\n\nfunction getPayloadStringArrayOrNull(\n  payload: Readonly<Record<string, unknown>>,\n  key: string,\n): readonly string[] | null {\n  const value = payload[key];\n\n  if (value === null) {\n    return null;\n  }\n  if (Array.isArray(value) && value.every((item) => typeof item === \"string\")) {\n    return value;\n  }\n\n  throw new Error(\"Invalid continuation cursor payload.\");\n}\n\nfunction getPayloadOptionalString(\n  payload: Readonly<Record<string, unknown>>,\n  key: string,\n): { readonly query?: string } {\n  const value = payload[key];\n\n  if (value === undefined) {\n    return {};\n  }\n  if (typeof value === \"string\") {\n    return { query: value };\n  }\n\n  throw new Error(\"Invalid continuation cursor payload.\");\n}\n\nfunction getPayloadNumberArrayOrNull(\n  payload: Readonly<Record<string, unknown>>,\n  key: string,\n): readonly number[] | null {\n  const value = payload[key];\n\n  if (value === undefined || value === null) {\n    return null;\n  }\n  if (Array.isArray(value)) {\n    const numbers: number[] = [];\n\n    for (const item of value) {\n      if (typeof item !== \"number\" || !Number.isInteger(item)) {\n        throw new Error(\"Invalid continuation cursor payload.\");\n      }\n      numbers.push(item);\n    }\n\n    return numbers;\n  }\n\n  throw new Error(\"Invalid continuation cursor payload.\");\n}\n\nfunction getPayloadOrder(\n  payload: Readonly<Record<string, unknown>>,\n): \"doc-asc\" | \"doc-desc\" {\n  const value = payload.order;\n\n  if (value === \"doc-asc\" || value === \"doc-desc\") {\n    return value;\n  }\n\n  throw new Error(\"Invalid continuation cursor payload.\");\n}\n\nfunction getPayloadOptionalPositiveInteger(\n  payload: Readonly<Record<string, unknown>>,\n  key: string,\n): { readonly evidenceLimit?: number } {\n  const value = payload[key];\n\n  if (value === undefined) {\n    return {};\n  }\n  if (typeof value === \"number\" && Number.isInteger(value) && value > 0) {\n    return { evidenceLimit: value };\n  }\n\n  throw new Error(\"Invalid continuation cursor payload.\");\n}\n\nfunction getPayloadOptionalInteger<K extends string>(\n  payload: Readonly<Record<string, unknown>>,\n  key: string,\n  outputKey: K,\n): { readonly [P in K]?: number } {\n  const value = payload[key];\n\n  if (value === undefined) {\n    return {};\n  }\n  if (typeof value === \"number\" && Number.isInteger(value) && value >= 0) {\n    return { [outputKey]: value } as { readonly [P in K]?: number };\n  }\n\n  throw new Error(\"Invalid continuation cursor payload.\");\n}\n\nfunction getPayloadOptionalBoolean(\n  payload: Readonly<Record<string, unknown>>,\n  key: string,\n): { readonly backlinks?: boolean } {\n  const value = payload[key];\n\n  if (value === undefined) {\n    return {};\n  }\n  if (typeof value === \"boolean\") {\n    return { backlinks: value };\n  }\n\n  throw new Error(\"Invalid continuation cursor payload.\");\n}\n\nfunction getPayloadOptionalRelatedRole(\n  payload: Readonly<Record<string, unknown>>,\n): { readonly role?: \"any\" | \"object\" | \"self\" | \"subject\" } {\n  const value = payload.role;\n\n  if (value === undefined) {\n    return {};\n  }\n  if (\n    value === \"any\" ||\n    value === \"object\" ||\n    value === \"self\" ||\n    value === \"subject\"\n  ) {\n    return { role: value };\n  }\n\n  throw new Error(\"Invalid continuation cursor payload.\");\n}\n\nfunction getPayloadOptionalTriplePattern(\n  payload: Readonly<Record<string, unknown>>,\n): {\n  readonly triplePattern?: {\n    readonly objectQid?: string;\n    readonly predicate?: string;\n    readonly subjectQid?: string;\n  };\n} {\n  const value = payload.triplePattern;\n\n  if (value === undefined) {\n    return {};\n  }\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    throw new Error(\"Invalid continuation cursor payload.\");\n  }\n\n  const pattern = value as Record<string, unknown>;\n  const subjectQid = getOptionalPayloadStringProperty(pattern, \"subjectQid\");\n  const predicate = getOptionalPayloadStringProperty(pattern, \"predicate\");\n  const objectQid = getOptionalPayloadStringProperty(pattern, \"objectQid\");\n\n  return {\n    triplePattern: {\n      ...(objectQid === undefined ? {} : { objectQid }),\n      ...(predicate === undefined ? {} : { predicate }),\n      ...(subjectQid === undefined ? {} : { subjectQid }),\n    },\n  };\n}\n\nfunction getOptionalPayloadStringProperty(\n  payload: Readonly<Record<string, unknown>>,\n  key: string,\n): string | undefined {\n  const value = payload[key];\n\n  if (value === undefined) {\n    return undefined;\n  }\n  if (typeof value === \"string\") {\n    return value;\n  }\n\n  throw new Error(\"Invalid continuation cursor payload.\");\n}\n"],"mappings":"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","names":[]}

package/dist/retrieval/query/continuation-cursor/store.d.ts

@@ -0,0 +1,10 @@
+import { Database } from '../../../document/database.js';
+import 'sqlite3';
+
+declare const CURSOR_TTL_MS: number;
+declare function createUniqueCursorId(database: Database): Promise<string>;
+declare function cleanExpiredContinuationCursors(database: Database): Promise<void>;
+declare function openContinuationCursorDatabase(): Promise<Database>;
+declare function parseCursorFormat(value: string): "json" | "jsonl" | "text";
+
+export { CURSOR_TTL_MS, cleanExpiredContinuationCursors, createUniqueCursorId, openContinuationCursorDatabase, parseCursorFormat };

package/dist/retrieval/query/continuation-cursor/store.js

@@ -0,0 +1,65 @@
+import { randomBytes } from "crypto";
+import { join } from "path";
+import { resolveWikiGraphCacheDirectoryPath } from "../../../runtime/common/wiki-graph/dir.js";
+import { getOptionalString } from "../../../document/database.js";
+import { openSharedStateDatabase } from "../../../document/index.js";
+const CONTINUATION_CURSOR_SCHEMA_SQL = `
+CREATE TABLE IF NOT EXISTS continuation_cursors (
+  cursor_id TEXT PRIMARY KEY,
+  archive_key TEXT NOT NULL,
+  archive_path TEXT NOT NULL,
+  kind TEXT NOT NULL,
+  payload_json TEXT NOT NULL,
+  format TEXT NOT NULL,
+  limit_value INTEGER NOT NULL,
+  created_at INTEGER NOT NULL,
+  expires_at INTEGER NOT NULL,
+  accessed_at INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_continuation_cursors_expires
+ON continuation_cursors(expires_at);
+`;
+const CURSOR_TTL_MS = 7 * 24 * 60 * 60 * 1e3;
+async function createUniqueCursorId(database) {
+  for (let attempt = 0; attempt < 10; attempt += 1) {
+    const cursorId = `c_${randomBytes(6).toString("base64url")}`;
+    const existing = await database.queryOne(
+      "SELECT cursor_id FROM continuation_cursors WHERE cursor_id = ?",
+      [cursorId],
+      (row) => getOptionalString(row, "cursor_id")
+    );
+    if (existing === void 0) {
+      return cursorId;
+    }
+  }
+  throw new Error("Failed to create a unique continuation cursor.");
+}
+async function cleanExpiredContinuationCursors(database) {
+  await database.run("DELETE FROM continuation_cursors WHERE expires_at < ?", [
+    Date.now()
+  ]);
+}
+async function openContinuationCursorDatabase() {
+  return await openSharedStateDatabase(
+    join(getContinuationStateDirectoryPath(), "continuation-cursors.sqlite"),
+    CONTINUATION_CURSOR_SCHEMA_SQL
+  );
+}
+function getContinuationStateDirectoryPath() {
+  return resolveWikiGraphCacheDirectoryPath();
+}
+function parseCursorFormat(value) {
+  if (value === "json" || value === "jsonl" || value === "text") {
+    return value;
+  }
+  throw new Error(`Invalid continuation cursor format: ${value}.`);
+}
+export {
+  CURSOR_TTL_MS,
+  cleanExpiredContinuationCursors,
+  createUniqueCursorId,
+  openContinuationCursorDatabase,
+  parseCursorFormat
+};
+//# sourceMappingURL=store.js.map

package/dist/retrieval/query/continuation-cursor/store.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/retrieval/query/continuation-cursor/store.ts"],"sourcesContent":["import { randomBytes } from \"crypto\";\nimport { join } from \"path\";\n\nimport { resolveWikiGraphCacheDirectoryPath } from \"../../../runtime/common/wiki-graph/dir.js\";\nimport { getOptionalString } from \"../../../document/database.js\";\nimport { openSharedStateDatabase } from \"../../../document/index.js\";\nimport type { Database } from \"../../../document/index.js\";\n\nconst CONTINUATION_CURSOR_SCHEMA_SQL = `\nCREATE TABLE IF NOT EXISTS continuation_cursors (\n  cursor_id TEXT PRIMARY KEY,\n  archive_key TEXT NOT NULL,\n  archive_path TEXT NOT NULL,\n  kind TEXT NOT NULL,\n  payload_json TEXT NOT NULL,\n  format TEXT NOT NULL,\n  limit_value INTEGER NOT NULL,\n  created_at INTEGER NOT NULL,\n  expires_at INTEGER NOT NULL,\n  accessed_at INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_continuation_cursors_expires\nON continuation_cursors(expires_at);\n`;\n\nexport const CURSOR_TTL_MS = 7 * 24 * 60 * 60 * 1000;\nexport async function createUniqueCursorId(\n  database: Database,\n): Promise<string> {\n  for (let attempt = 0; attempt < 10; attempt += 1) {\n    const cursorId = `c_${randomBytes(6).toString(\"base64url\")}`;\n    const existing = await database.queryOne(\n      \"SELECT cursor_id FROM continuation_cursors WHERE cursor_id = ?\",\n      [cursorId],\n      (row) => getOptionalString(row, \"cursor_id\"),\n    );\n\n    if (existing === undefined) {\n      return cursorId;\n    }\n  }\n\n  throw new Error(\"Failed to create a unique continuation cursor.\");\n}\n\nexport async function cleanExpiredContinuationCursors(\n  database: Database,\n): Promise<void> {\n  await database.run(\"DELETE FROM continuation_cursors WHERE expires_at < ?\", [\n    Date.now(),\n  ]);\n}\n\nexport async function openContinuationCursorDatabase(): Promise<Database> {\n  return await openSharedStateDatabase(\n    join(getContinuationStateDirectoryPath(), \"continuation-cursors.sqlite\"),\n    CONTINUATION_CURSOR_SCHEMA_SQL,\n  );\n}\n\nfunction getContinuationStateDirectoryPath(): string {\n  return resolveWikiGraphCacheDirectoryPath();\n}\n\nexport function parseCursorFormat(value: string): \"json\" | \"jsonl\" | \"text\" {\n  if (value === \"json\" || value === \"jsonl\" || value === \"text\") {\n    return value;\n  }\n\n  throw new Error(`Invalid continuation cursor format: ${value}.`);\n}\n"],"mappings":"AAAA,SAAS,mBAAmB;AAC5B,SAAS,YAAY;AAErB,SAAS,0CAA0C;AACnD,SAAS,yBAAyB;AAClC,SAAS,+BAA+B;AAGxC,MAAM,iCAAiC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAkBhC,MAAM,gBAAgB,IAAI,KAAK,KAAK,KAAK;AAChD,eAAsB,qBACpB,UACiB;AACjB,WAAS,UAAU,GAAG,UAAU,IAAI,WAAW,GAAG;AAChD,UAAM,WAAW,KAAK,YAAY,CAAC,EAAE,SAAS,WAAW,CAAC;AAC1D,UAAM,WAAW,MAAM,SAAS;AAAA,MAC9B;AAAA,MACA,CAAC,QAAQ;AAAA,MACT,CAAC,QAAQ,kBAAkB,KAAK,WAAW;AAAA,IAC7C;AAEA,QAAI,aAAa,QAAW;AAC1B,aAAO;AAAA,IACT;AAAA,EACF;AAEA,QAAM,IAAI,MAAM,gDAAgD;AAClE;AAEA,eAAsB,gCACpB,UACe;AACf,QAAM,SAAS,IAAI,yDAAyD;AAAA,IAC1E,KAAK,IAAI;AAAA,EACX,CAAC;AACH;AAEA,eAAsB,iCAAoD;AACxE,SAAO,MAAM;AAAA,IACX,KAAK,kCAAkC,GAAG,6BAA6B;AAAA,IACvE;AAAA,EACF;AACF;AAEA,SAAS,oCAA4C;AACnD,SAAO,mCAAmC;AAC5C;AAEO,SAAS,kBAAkB,OAA0C;AAC1E,MAAI,UAAU,UAAU,UAAU,WAAW,UAAU,QAAQ;AAC7D,WAAO;AAAA,EACT;AAEA,QAAM,IAAI,MAAM,uCAAuC,KAAK,GAAG;AACjE;","names":[]}

package/dist/retrieval/query/continuation-cursor/types.d.ts

@@ -0,0 +1,72 @@
+type QueryScope = {
+    readonly kind: "archive";
+    readonly archiveId: number;
+} | {
+    readonly kind: "library";
+    readonly libraryId: number;
+};
+type QueryIndexScope = {
+    readonly kind: "archive-index";
+    readonly archivePath: string;
+    readonly archiveKey: string;
+} | {
+    readonly kind: "library-index";
+    readonly libraryId: number;
+};
+type ContinuationCursorBase = {
+    readonly archiveKey: string;
+    readonly archivePath: string;
+    readonly indexScope: QueryIndexScope;
+};
+type ContinuationCursor = (ContinuationCursorBase & {
+    readonly backlinks?: boolean;
+    readonly chapters: readonly number[] | null;
+    readonly cursor: string;
+    readonly evidenceLimit?: number;
+    readonly format: "json" | "jsonl" | "text";
+    readonly ids: readonly string[] | null;
+    readonly kind: "collection";
+    readonly order: "doc-asc" | "doc-desc";
+    readonly sourceContext?: number;
+    readonly triplePattern?: {
+        readonly objectQid?: string;
+        readonly predicate?: string;
+        readonly subjectQid?: string;
+    };
+    readonly types: readonly string[] | null;
+}) | (ContinuationCursorBase & {
+    readonly backlinks?: boolean;
+    readonly chapters?: readonly number[] | null;
+    readonly cursor: string;
+    readonly evidenceLimit?: number;
+    readonly format: "json" | "jsonl" | "text";
+    readonly kind: "search";
+    readonly query?: string;
+    readonly sourceContext?: number;
+    readonly triplePattern?: {
+        readonly objectQid?: string;
+        readonly predicate?: string;
+        readonly subjectQid?: string;
+    };
+    readonly types: readonly string[] | null;
+}) | (ContinuationCursorBase & {
+    readonly cursor: string;
+    readonly format: "json" | "jsonl" | "text";
+    readonly kind: "evidence";
+    readonly order: "doc-asc" | "doc-desc";
+    readonly query?: string;
+    readonly sourceContext?: number;
+    readonly targetUri: string;
+}) | (ContinuationCursorBase & {
+    readonly cursor: string;
+    readonly evidenceLimit?: number;
+    readonly format: "json" | "jsonl" | "text";
+    readonly kind: "related";
+    readonly order: "doc-asc" | "doc-desc";
+    readonly query?: string;
+    readonly role?: "any" | "object" | "self" | "subject";
+    readonly sourceContext?: number;
+    readonly targetUri: string;
+});
+
+export type { ContinuationCursor, QueryIndexScope, QueryScope };

package/dist/retrieval/query/continuation-cursor/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/retrieval/query/continuation-cursor/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/retrieval/query/index.d.ts

@@ -0,0 +1,47 @@
+export { findArchiveObjects, grepArchiveObjects } from './archive-view/search/core.js';
+export { ArchiveBacklinkBucket, ArchiveBacklinks, ArchiveCollectionOptions, ArchiveCollectionResult, ArchiveCollectionType, ArchiveEvidence, ArchiveEvidenceItem, ArchiveFindEvidencePreview, ArchiveFindField, ArchiveFindFilterType, ArchiveFindHit, ArchiveFindObjectType, ArchiveFindOptions, ArchiveFindOrder, ArchiveFindPosition, ArchiveFindResult, ArchiveIndex, ArchiveLibrarySource, ArchiveListItem, ArchiveListKind, ArchiveNodeLabel, ArchiveNodeSourceFragment, ArchiveObjectType, ArchivePack, ArchivePage, ArchiveRelatedResult, ArchiveTriplePattern } from './archive-view/types.js';
+export { SearchSessionDescriptor, SearchSessionInput, SearchSessionPage } from './search-cache/types.js';
+export { readArchivePage, readArchiveText } from './archive-view/pages.js';
+export { listAllArchiveLinks, listArchiveLinks, listRelatedArchiveObjects } from './archive-view/related/core.js';
+export { formatChapterId, formatEdgeId, formatNodeId, formatSummaryId } from './archive-view/references.js';
+export { clearDirtyArchiveSearchIndex, createArchiveSearchIndexFingerprint, isArchiveSearchIndexCurrent, readArchiveSearchIndexStatus, rebuildArchiveSearchIndex } from './archive-view/index-state.js';
+export { getArchiveIndex, listArchiveCollection, listArchiveObjects } from './archive-view/collection.js';
+export { listArchiveEvidence } from './archive-view/evidence.js';
+export { packArchiveContext } from './archive-view/pack.js';
+export { createContinuationCursor, readContinuationCursor } from './continuation-cursor/core.js';
+export { ContinuationCursor, QueryIndexScope, QueryScope } from './continuation-cursor/types.js';
+export { deleteArchiveSearchSessions, runSearchCacheGc } from './search-cache/gc.js';
+export { createSearchSession, readCachedSearchSessionPage } from './search-cache/sessions.js';
+import '../../document/directory/types.js';
+import '../../text/source/meta.js';
+import 'zod';
+import '../../text/source/toc.js';
+import '../../text/source/types.js';
+import '../../document/database.js';
+import 'sqlite3';
+import '../../document/types.js';
+import '../../document/text-streams/serial.js';
+import '../../document/text-streams/draft.js';
+import '../../document/text-streams/types.js';
+import '../../document/stores/chunk.js';
+import '../../document/stores/types.js';
+import '../../document/stores/fragment-group.js';
+import '../../document/stores/graph-build-parameter.js';
+import '../../document/stores/mention-link.js';
+import '../../document/stores/mention.js';
+import '../../document/stores/object-metadata.js';
+import '../../document/stores/reading-edge.js';
+import '../../document/stores/serial.js';
+import '../../document/stores/snake/chunk.js';
+import '../../document/stores/snake/core.js';
+import '../../document/stores/snake/edge.js';
+import '../../graph/reading.js';
+import '../../document/chapter/types.js';
+import '../../external/wikipage/types.js';
+import '../../external/wikipage/wikimedia-client/wiki.js';
+import '../../external/wikipage/fetch-log.js';
+import './archive-view/related/wikipage.js';
+import '../search-index/search/build.js';
+import '../search-index/search/types.js';
+import './archive-view/evidence-hydration.js';
+import '../../runtime/gc/types.js';

package/dist/retrieval/query/index.js

@@ -0,0 +1,63 @@
+import {
+  findArchiveObjects,
+  formatChapterId,
+  formatEdgeId,
+  formatNodeId,
+  formatSummaryId,
+  getArchiveIndex,
+  grepArchiveObjects,
+  createArchiveSearchIndexFingerprint,
+  clearDirtyArchiveSearchIndex,
+  isArchiveSearchIndexCurrent,
+  readArchiveSearchIndexStatus,
+  listAllArchiveLinks,
+  listArchiveCollection,
+  listArchiveEvidence,
+  listArchiveLinks,
+  listArchiveObjects,
+  listRelatedArchiveObjects,
+  packArchiveContext,
+  readArchivePage,
+  readArchiveText,
+  rebuildArchiveSearchIndex
+} from "./view.js";
+import {
+  createContinuationCursor,
+  readContinuationCursor
+} from "./continuation-cursor/index.js";
+import {
+  createSearchSession,
+  deleteArchiveSearchSessions,
+  readCachedSearchSessionPage,
+  runSearchCacheGc
+} from "./search-cache/index.js";
+export {
+  clearDirtyArchiveSearchIndex,
+  createArchiveSearchIndexFingerprint,
+  createContinuationCursor,
+  createSearchSession,
+  deleteArchiveSearchSessions,
+  findArchiveObjects,
+  formatChapterId,
+  formatEdgeId,
+  formatNodeId,
+  formatSummaryId,
+  getArchiveIndex,
+  grepArchiveObjects,
+  isArchiveSearchIndexCurrent,
+  listAllArchiveLinks,
+  listArchiveCollection,
+  listArchiveEvidence,
+  listArchiveLinks,
+  listArchiveObjects,
+  listRelatedArchiveObjects,
+  packArchiveContext,
+  readArchivePage,
+  readArchiveSearchIndexStatus,
+  readArchiveText,
+  readCachedSearchSessionPage,
+  readContinuationCursor,
+  rebuildArchiveSearchIndex,
+  runSearchCacheGc
+};
+//# sourceMappingURL=index.js.map

package/dist/retrieval/query/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/retrieval/query/index.ts"],"sourcesContent":["export {\n  findArchiveObjects,\n  formatChapterId,\n  formatEdgeId,\n  formatNodeId,\n  formatSummaryId,\n  getArchiveIndex,\n  grepArchiveObjects,\n  createArchiveSearchIndexFingerprint,\n  clearDirtyArchiveSearchIndex,\n  isArchiveSearchIndexCurrent,\n  readArchiveSearchIndexStatus,\n  listAllArchiveLinks,\n  listArchiveCollection,\n  listArchiveEvidence,\n  listArchiveLinks,\n  listArchiveObjects,\n  listRelatedArchiveObjects,\n  packArchiveContext,\n  readArchivePage,\n  readArchiveText,\n  rebuildArchiveSearchIndex,\n} from \"./view.js\";\nexport type {\n  ArchiveBacklinkBucket,\n  ArchiveBacklinks,\n  ArchiveCollectionOptions,\n  ArchiveCollectionResult,\n  ArchiveCollectionType,\n  ArchiveEvidence,\n  ArchiveEvidenceItem,\n  ArchiveFindEvidencePreview,\n  ArchiveFindField,\n  ArchiveFindFilterType,\n  ArchiveFindHit,\n  ArchiveFindObjectType,\n  ArchiveFindOptions,\n  ArchiveFindOrder,\n  ArchiveFindPosition,\n  ArchiveFindResult,\n  ArchiveIndex,\n  ArchiveLibrarySource,\n  ArchiveListItem,\n  ArchiveListKind,\n  ArchiveNodeLabel,\n  ArchiveNodeSourceFragment,\n  ArchiveObjectType,\n  ArchivePack,\n  ArchivePage,\n  ArchiveRelatedResult,\n  ArchiveTriplePattern,\n} from \"./view.js\";\nexport {\n  createContinuationCursor,\n  readContinuationCursor,\n} from \"./continuation-cursor/index.js\";\nexport type {\n  ContinuationCursor,\n  QueryIndexScope,\n  QueryScope,\n} from \"./continuation-cursor/index.js\";\nexport {\n  createSearchSession,\n  deleteArchiveSearchSessions,\n  readCachedSearchSessionPage,\n  runSearchCacheGc,\n} from \"./search-cache/index.js\";\nexport type {\n  SearchSessionDescriptor,\n  SearchSessionInput,\n  SearchSessionPage,\n} from \"./search-cache/index.js\";\n"],"mappings":"AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AA8BP;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAMP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

package/dist/retrieval/query/lexical-search.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/retrieval/query/lexical-search.ts"],"sourcesContent":["export interface LexicalQuery {\n  readonly phrases: readonly string[];\n  readonly terms: readonly string[];\n}\n\nexport interface LexicalScore {\n  readonly matchCount: number;\n  readonly matchedTerms: readonly string[];\n  readonly missingTerms: readonly string[];\n  readonly score: number;\n  readonly snippetNeedle: string;\n}\n\nconst HAN_RE = /\\p{Script=Han}/u;\nconst LATIN_TOKEN_RE = /[\\p{Script=Latin}\\p{Number}]+/gu;\nconst PHRASE_WEIGHT = 2;\nconst TERM_WEIGHT = 1;\n\nexport function createLexicalQuery(query: string): LexicalQuery | undefined {\n  const normalizedQuery = query.trim();\n\n  if (normalizedQuery === \"\") {\n    return undefined;\n  }\n\n  const phraseTerms = splitQueryPhrases(normalizedQuery);\n  const characterTerms = [...normalizedQuery]\n    .filter((character) => HAN_RE.test(character))\n    .map((character) => character.toLowerCase());\n  const latinTerms = normalizeLatinTokens(normalizedQuery);\n  const terms = dedupeStrings([\n    ...phraseTerms,\n    ...latinTerms,\n    ...characterTerms,\n  ]);\n\n  if (terms.length === 0) {\n    return undefined;\n  }\n\n  return {\n    phrases: phraseTerms,\n    terms,\n  };\n}\n\nexport function listLexicalQueryCandidateTerms(\n  query: string,\n): readonly string[] {\n  const normalizedQuery = query.trim();\n\n  return dedupeStrings([\n    ...splitQueryPhrases(normalizedQuery),\n    ...normalizeLatinTokens(normalizedQuery),\n    ...[...normalizedQuery]\n      .filter((character) => HAN_RE.test(character))\n      .map((character) => character.toLowerCase()),\n  ]);\n}\n\nexport function scoreLexicalText(\n  value: string,\n  query: LexicalQuery,\n): LexicalScore | undefined {\n  const normalizedText = value.toLowerCase();\n  const matchedTerms: string[] = [];\n  const missingTerms: string[] = [];\n  let score = 0;\n\n  for (const phrase of query.phrases) {\n    const normalizedPhrase = phrase.toLowerCase();\n\n    if (normalizedText.includes(normalizedPhrase)) {\n      matchedTerms.push(phrase);\n      score +=\n        PHRASE_WEIGHT + countOccurrences(normalizedText, normalizedPhrase);\n    } else if (!missingTerms.includes(phrase)) {\n      missingTerms.push(phrase);\n    }\n  }\n\n  const latinTokens = new Set(normalizeLatinTokens(value));\n\n  for (const term of query.terms) {\n    if (matchedTerms.includes(term)) {\n      continue;\n    }\n\n    const isHan = [...term].every((character) => HAN_RE.test(character));\n    const matched = isHan\n      ? normalizedText.includes(term)\n      : latinTokens.has(term.toLowerCase());\n\n    if (matched) {\n      matchedTerms.push(term);\n      score += TERM_WEIGHT;\n    } else if (!missingTerms.includes(term)) {\n      missingTerms.push(term);\n    }\n  }\n\n  if (matchedTerms.length === 0 || score <= 0) {\n    return undefined;\n  }\n\n  score += calculateCoverageBonus(matchedTerms, query);\n  score += calculateProximityBonus(normalizedText, matchedTerms);\n\n  return {\n    matchCount: matchedTerms.length,\n    matchedTerms: dedupeStrings(matchedTerms),\n    missingTerms: dedupeStrings(missingTerms).filter(\n      (term) => !matchedTerms.includes(term),\n    ),\n    score,\n    snippetNeedle: selectSnippetNeedle(matchedTerms),\n  };\n}\n\nexport function createMentionLexicalHits<\n  T extends { readonly surface: string },\n>(\n  mentions: readonly T[],\n  query: LexicalQuery,\n): readonly {\n  readonly match: LexicalScore;\n  readonly mention: T;\n}[] {\n  return mentions\n    .map((mention) => {\n      const match = scoreLexicalText(mention.surface, query);\n\n      return match === undefined ? undefined : { match, mention };\n    })\n    .filter(isDefined);\n}\n\nfunction splitQueryPhrases(query: string): readonly string[] {\n  return dedupeStrings(\n    query\n      .split(/\\s+/u)\n      .map((part) => part.trim())\n      .filter((part) => part.length > 1),\n  );\n}\n\nfunction normalizeLatinTokens(value: string): readonly string[] {\n  return [...value.toLowerCase().matchAll(LATIN_TOKEN_RE)].map(\n    (match) => match[0],\n  );\n}\n\nfunction countOccurrences(value: string, needle: string): number {\n  if (needle === \"\") {\n    return 0;\n  }\n\n  let count = 0;\n  let index = value.indexOf(needle);\n\n  while (index >= 0) {\n    count += 1;\n    index = value.indexOf(needle, index + needle.length);\n  }\n\n  return count;\n}\n\nfunction calculateCoverageBonus(\n  matchedTerms: readonly string[],\n  query: LexicalQuery,\n): number {\n  const total = query.terms.length;\n\n  if (total === 0) {\n    return 0;\n  }\n\n  return matchedTerms.length / total;\n}\n\nfunction calculateProximityBonus(\n  normalizedText: string,\n  matchedTerms: readonly string[],\n): number {\n  const positions = matchedTerms\n    .map((term) => normalizedText.indexOf(term.toLowerCase()))\n    .filter((position) => position >= 0)\n    .sort((left, right) => left - right);\n\n  if (positions.length < 2) {\n    return 0;\n  }\n\n  const span = positions.at(-1)! - positions[0]!;\n\n  return span <= 80 ? 1 : span <= 240 ? 0.5 : 0;\n}\n\nfunction selectSnippetNeedle(matchedTerms: readonly string[]): string {\n  return [...matchedTerms].sort(\n    (left, right) => right.length - left.length,\n  )[0]!;\n}\n\nfunction dedupeStrings(values: readonly string[]): readonly string[] {\n  return [...new Set(values.filter((value) => value !== \"\"))];\n}\n\nfunction isDefined<T>(value: T | undefined): value is T {\n  return value !== undefined;\n}\n"],"mappings":"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","names":[]}