wiki-graph-core 0.3.1 → 0.4.0

package/dist/retrieval/query/search-cache/buckets.d.ts

@@ -0,0 +1,32 @@
+import { ArchiveFindHit } from '../archive-view/types.js';
+import { SearchChunkCursorKey, SearchObjectCursorKey } from './types.js';
+import '../../../document/types.js';
+import '../../../text/source/meta.js';
+import 'zod';
+import '../../../graph/reading.js';
+import '../../../document/directory/types.js';
+import '../../../text/source/toc.js';
+import '../../../text/source/types.js';
+import '../../../document/database.js';
+import 'sqlite3';
+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 '../../../document/chapter/types.js';
+
+declare function readSearchSessionObjectBucketPage(sessionId: string, bucket: 1, after: SearchObjectCursorKey | undefined, limit: number): Promise<readonly ArchiveFindHit[]>;
+declare function readSearchSessionChunkBucketPage(sessionId: string, after: SearchChunkCursorKey | undefined, limit: number): Promise<readonly ArchiveFindHit[]>;
+
+export { readSearchSessionChunkBucketPage, readSearchSessionObjectBucketPage };

package/dist/retrieval/query/search-cache/buckets.js

@@ -0,0 +1,87 @@
+import { getNumber } from "../../../document/database.js";
+import { openSearchSessionDatabase } from "./database.js";
+import {
+  compareObjectBucketHits,
+  readSearchSessionEntityBucketRows,
+  readSearchSessionTripleBucketRows
+} from "./hits.js";
+async function readSearchSessionObjectBucketPage(sessionId, bucket, after, limit) {
+  const database = await openSearchSessionDatabase();
+  try {
+    const entityRows = await readSearchSessionEntityBucketRows(
+      database,
+      sessionId,
+      after,
+      limit + 1
+    );
+    const tripleRows = await readSearchSessionTripleBucketRows(
+      database,
+      sessionId,
+      after,
+      limit + 1
+    );
+    return [...entityRows, ...tripleRows].sort(compareObjectBucketHits).slice(0, limit + 1);
+  } finally {
+    await database.close();
+  }
+}
+async function readSearchSessionChunkBucketPage(sessionId, after, limit) {
+  const database = await openSearchSessionDatabase();
+  try {
+    return await database.queryAll(
+      `
+        SELECT
+          archive_id,
+          chunk_id,
+          result_score
+        FROM search_chunk_hits
+        WHERE session_id = ?
+          ${after === void 0 ? "" : `
+                AND (
+                  result_score < ?
+                  OR (
+                    result_score = ?
+                    AND (
+                      archive_id > ?
+                      OR (archive_id = ? AND chunk_id > ?)
+                    )
+                  )
+                )
+              `}
+        ORDER BY result_score DESC, archive_id, chunk_id
+        LIMIT ?
+      `,
+      [
+        sessionId,
+        ...after === void 0 ? [] : [
+          after.score,
+          after.score,
+          after.archiveId,
+          after.archiveId,
+          after.chunkId
+        ],
+        limit + 1
+      ],
+      (row) => {
+        const archiveId = getNumber(row, "archive_id");
+        const chunkId = getNumber(row, "chunk_id");
+        return {
+          field: "title",
+          id: `wikg://chunk/${chunkId}`,
+          ...archiveId === 0 ? {} : { archiveId },
+          score: getNumber(row, "result_score"),
+          snippet: `chunk ${chunkId}`,
+          title: `chunk ${chunkId}`,
+          type: "node"
+        };
+      }
+    );
+  } finally {
+    await database.close();
+  }
+}
+export {
+  readSearchSessionChunkBucketPage,
+  readSearchSessionObjectBucketPage
+};
+//# sourceMappingURL=buckets.js.map

package/dist/retrieval/query/search-cache/buckets.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/retrieval/query/search-cache/buckets.ts"],"sourcesContent":["import { getNumber } from \"../../../document/database.js\";\n\nimport type { ArchiveFindHit } from \"../view.js\";\n\nimport { openSearchSessionDatabase } from \"./database.js\";\nimport {\n  compareObjectBucketHits,\n  readSearchSessionEntityBucketRows,\n  readSearchSessionTripleBucketRows,\n} from \"./hits.js\";\nimport type { SearchChunkCursorKey, SearchObjectCursorKey } from \"./types.js\";\n\nexport async function readSearchSessionObjectBucketPage(\n  sessionId: string,\n  bucket: 1,\n  after: SearchObjectCursorKey | undefined,\n  limit: number,\n): Promise<readonly ArchiveFindHit[]> {\n  const database = await openSearchSessionDatabase();\n\n  try {\n    const entityRows = await readSearchSessionEntityBucketRows(\n      database,\n      sessionId,\n      after,\n      limit + 1,\n    );\n    const tripleRows = await readSearchSessionTripleBucketRows(\n      database,\n      sessionId,\n      after,\n      limit + 1,\n    );\n\n    return [...entityRows, ...tripleRows]\n      .sort(compareObjectBucketHits)\n      .slice(0, limit + 1);\n  } finally {\n    await database.close();\n  }\n}\n\nexport async function readSearchSessionChunkBucketPage(\n  sessionId: string,\n  after: SearchChunkCursorKey | undefined,\n  limit: number,\n): Promise<readonly ArchiveFindHit[]> {\n  const database = await openSearchSessionDatabase();\n\n  try {\n    return await database.queryAll(\n      `\n        SELECT\n          archive_id,\n          chunk_id,\n          result_score\n        FROM search_chunk_hits\n        WHERE session_id = ?\n          ${\n            after === undefined\n              ? \"\"\n              : `\n                AND (\n                  result_score < ?\n                  OR (\n                    result_score = ?\n                    AND (\n                      archive_id > ?\n                      OR (archive_id = ? AND chunk_id > ?)\n                    )\n                  )\n                )\n              `\n          }\n        ORDER BY result_score DESC, archive_id, chunk_id\n        LIMIT ?\n      `,\n      [\n        sessionId,\n        ...(after === undefined\n          ? []\n          : [\n              after.score,\n              after.score,\n              after.archiveId,\n              after.archiveId,\n              after.chunkId,\n            ]),\n        limit + 1,\n      ],\n      (row) => {\n        const archiveId = getNumber(row, \"archive_id\");\n        const chunkId = getNumber(row, \"chunk_id\");\n\n        return {\n          field: \"title\",\n          id: `wikg://chunk/${chunkId}`,\n          ...(archiveId === 0 ? {} : { archiveId }),\n          score: getNumber(row, \"result_score\"),\n          snippet: `chunk ${chunkId}`,\n          title: `chunk ${chunkId}`,\n          type: \"node\",\n        };\n      },\n    );\n  } finally {\n    await database.close();\n  }\n}\n"],"mappings":"AAAA,SAAS,iBAAiB;AAI1B,SAAS,iCAAiC;AAC1C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP,eAAsB,kCACpB,WACA,QACA,OACA,OACoC;AACpC,QAAM,WAAW,MAAM,0BAA0B;AAEjD,MAAI;AACF,UAAM,aAAa,MAAM;AAAA,MACvB;AAAA,MACA;AAAA,MACA;AAAA,MACA,QAAQ;AAAA,IACV;AACA,UAAM,aAAa,MAAM;AAAA,MACvB;AAAA,MACA;AAAA,MACA;AAAA,MACA,QAAQ;AAAA,IACV;AAEA,WAAO,CAAC,GAAG,YAAY,GAAG,UAAU,EACjC,KAAK,uBAAuB,EAC5B,MAAM,GAAG,QAAQ,CAAC;AAAA,EACvB,UAAE;AACA,UAAM,SAAS,MAAM;AAAA,EACvB;AACF;AAEA,eAAsB,iCACpB,WACA,OACA,OACoC;AACpC,QAAM,WAAW,MAAM,0BAA0B;AAEjD,MAAI;AACF,WAAO,MAAM,SAAS;AAAA,MACpB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,YAQM,UAAU,SACN,KACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,eAYN;AAAA;AAAA;AAAA;AAAA,MAIJ;AAAA,QACE;AAAA,QACA,GAAI,UAAU,SACV,CAAC,IACD;AAAA,UACE,MAAM;AAAA,UACN,MAAM;AAAA,UACN,MAAM;AAAA,UACN,MAAM;AAAA,UACN,MAAM;AAAA,QACR;AAAA,QACJ,QAAQ;AAAA,MACV;AAAA,MACA,CAAC,QAAQ;AACP,cAAM,YAAY,UAAU,KAAK,YAAY;AAC7C,cAAM,UAAU,UAAU,KAAK,UAAU;AAEzC,eAAO;AAAA,UACL,OAAO;AAAA,UACP,IAAI,gBAAgB,OAAO;AAAA,UAC3B,GAAI,cAAc,IAAI,CAAC,IAAI,EAAE,UAAU;AAAA,UACvC,OAAO,UAAU,KAAK,cAAc;AAAA,UACpC,SAAS,SAAS,OAAO;AAAA,UACzB,OAAO,SAAS,OAAO;AAAA,UACvB,MAAM;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAAA,EACF,UAAE;AACA,UAAM,SAAS,MAAM;AAAA,EACvB;AACF;","names":[]}

package/dist/retrieval/query/search-cache/cursor.d.ts

@@ -0,0 +1,42 @@
+import { BucketSearchCursor } from './types.js';
+import '../archive-view/types.js';
+import '../../../document/types.js';
+import '../../../text/source/meta.js';
+import 'zod';
+import '../../../graph/reading.js';
+import '../../../document/directory/types.js';
+import '../../../text/source/toc.js';
+import '../../../text/source/types.js';
+import '../../../document/database.js';
+import 'sqlite3';
+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 '../../../document/chapter/types.js';
+
+declare function encodeSearchSessionCursor(sessionId: string, offset: number, createdAt: number): string;
+declare function encodeBucketSearchSessionCursor(sessionId: string, cursor: BucketSearchCursor, createdAt: number): string;
+declare function decodeBucketSearchSessionCursor(cursor: string): {
+    readonly createdAt: number;
+    readonly cursor: BucketSearchCursor;
+    readonly sessionId: string;
+};
+declare function decodeSearchSessionCursor(cursor: string): {
+    readonly createdAt?: number;
+    readonly offset: number;
+    readonly sessionId: string;
+};
+
+export { decodeBucketSearchSessionCursor, decodeSearchSessionCursor, encodeBucketSearchSessionCursor, encodeSearchSessionCursor };

package/dist/retrieval/query/search-cache/cursor.js

@@ -0,0 +1,84 @@
+function encodeSearchSessionCursor(sessionId, offset, createdAt) {
+  return Buffer.from(
+    JSON.stringify({ createdAt, offset, sessionId, v: 3 })
+  ).toString("base64url");
+}
+function encodeBucketSearchSessionCursor(sessionId, cursor, createdAt) {
+  return Buffer.from(
+    JSON.stringify({ createdAt, cursor, sessionId, v: 4 })
+  ).toString("base64url");
+}
+function decodeBucketSearchSessionCursor(cursor) {
+  try {
+    const parsed = JSON.parse(
+      Buffer.from(cursor, "base64url").toString("utf8")
+    );
+    if (typeof parsed === "object" && parsed !== null && "createdAt" in parsed && "cursor" in parsed && "sessionId" in parsed && "v" in parsed && parsed.v === 4 && typeof parsed.createdAt === "number" && Number.isInteger(parsed.createdAt) && parsed.createdAt >= 0 && typeof parsed.sessionId === "string" && parsed.sessionId !== "" && isBucketSearchCursor(parsed.cursor)) {
+      return {
+        createdAt: parsed.createdAt,
+        cursor: parsed.cursor,
+        sessionId: parsed.sessionId
+      };
+    }
+  } catch {
+    throw new Error("Invalid search cursor.");
+  }
+  throw new Error("Invalid search cursor.");
+}
+function decodeSearchSessionCursor(cursor) {
+  try {
+    const parsed = JSON.parse(
+      Buffer.from(cursor, "base64url").toString("utf8")
+    );
+    if (typeof parsed === "object" && parsed !== null && "offset" in parsed && "sessionId" in parsed && "createdAt" in parsed && "v" in parsed && parsed.v === 3 && typeof parsed.sessionId === "string" && parsed.sessionId !== "" && typeof parsed.createdAt === "number" && Number.isInteger(parsed.createdAt) && parsed.createdAt >= 0 && typeof parsed.offset === "number" && Number.isInteger(parsed.offset) && parsed.offset >= 0) {
+      return {
+        createdAt: parsed.createdAt,
+        offset: parsed.offset,
+        sessionId: parsed.sessionId
+      };
+    }
+    if (typeof parsed === "object" && parsed !== null && "offset" in parsed && "sessionId" in parsed && "v" in parsed && parsed.v === 2 && typeof parsed.sessionId === "string" && parsed.sessionId !== "" && typeof parsed.offset === "number" && Number.isInteger(parsed.offset) && parsed.offset >= 0) {
+      return { offset: parsed.offset, sessionId: parsed.sessionId };
+    }
+  } catch {
+    throw new Error("Invalid search cursor.");
+  }
+  throw new Error("Invalid search cursor.");
+}
+function isBucketSearchCursor(value) {
+  if (typeof value !== "object" || value === null || !("bucket" in value)) {
+    return false;
+  }
+  const cursor = value;
+  switch (cursor.bucket) {
+    case 0:
+      return cursor.key === void 0 || isChapterTitleCursorKey(cursor.key);
+    case 1:
+      return cursor.key === void 0 || isObjectCursorKey(cursor.key);
+    case 2:
+      return cursor.key === void 0 || isChunkCursorKey(cursor.key);
+    case 3:
+      return cursor.key === void 0 || isTextCursorKey(cursor.key);
+    default:
+      return false;
+  }
+}
+function isChapterTitleCursorKey(value) {
+  return typeof value === "object" && value !== null && typeof value.archiveId === "number" && typeof value.chapterId === "number" && typeof value.score === "number";
+}
+function isObjectCursorKey(value) {
+  return typeof value === "object" && value !== null && typeof value.archiveId === "number" && typeof value.id === "string" && (value.kind === "entity" || value.kind === "triple") && typeof value.score === "number";
+}
+function isChunkCursorKey(value) {
+  return typeof value === "object" && value !== null && typeof value.archiveId === "number" && typeof value.chunkId === "number" && typeof value.score === "number";
+}
+function isTextCursorKey(value) {
+  return typeof value === "object" && value !== null && typeof value.archiveId === "number" && typeof value.chapterId === "number" && typeof value.kind === "number" && typeof value.rank === "number" && typeof value.sentenceIndex === "number";
+}
+export {
+  decodeBucketSearchSessionCursor,
+  decodeSearchSessionCursor,
+  encodeBucketSearchSessionCursor,
+  encodeSearchSessionCursor
+};
+//# sourceMappingURL=cursor.js.map

package/dist/retrieval/query/search-cache/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/retrieval/query/search-cache/cursor.ts"],"sourcesContent":["import type {\n  BucketSearchCursor,\n  SearchChapterTitleCursorKey,\n  SearchChunkCursorKey,\n  SearchObjectCursorKey,\n  SearchTextCursorKey,\n} from \"./types.js\";\n\nexport function encodeSearchSessionCursor(\n  sessionId: string,\n  offset: number,\n  createdAt: number,\n): string {\n  return Buffer.from(\n    JSON.stringify({ createdAt, offset, sessionId, v: 3 }),\n  ).toString(\"base64url\");\n}\n\nexport function encodeBucketSearchSessionCursor(\n  sessionId: string,\n  cursor: BucketSearchCursor,\n  createdAt: number,\n): string {\n  return Buffer.from(\n    JSON.stringify({ createdAt, cursor, sessionId, v: 4 }),\n  ).toString(\"base64url\");\n}\n\nexport function decodeBucketSearchSessionCursor(cursor: string): {\n  readonly createdAt: number;\n  readonly cursor: BucketSearchCursor;\n  readonly sessionId: string;\n} {\n  try {\n    const parsed: unknown = JSON.parse(\n      Buffer.from(cursor, \"base64url\").toString(\"utf8\"),\n    );\n\n    if (\n      typeof parsed === \"object\" &&\n      parsed !== null &&\n      \"createdAt\" in parsed &&\n      \"cursor\" in parsed &&\n      \"sessionId\" in parsed &&\n      \"v\" in parsed &&\n      parsed.v === 4 &&\n      typeof parsed.createdAt === \"number\" &&\n      Number.isInteger(parsed.createdAt) &&\n      parsed.createdAt >= 0 &&\n      typeof parsed.sessionId === \"string\" &&\n      parsed.sessionId !== \"\" &&\n      isBucketSearchCursor(parsed.cursor)\n    ) {\n      return {\n        createdAt: parsed.createdAt,\n        cursor: parsed.cursor,\n        sessionId: parsed.sessionId,\n      };\n    }\n  } catch {\n    throw new Error(\"Invalid search cursor.\");\n  }\n\n  throw new Error(\"Invalid search cursor.\");\n}\n\nexport function decodeSearchSessionCursor(cursor: string): {\n  readonly createdAt?: number;\n  readonly offset: number;\n  readonly sessionId: string;\n} {\n  try {\n    const parsed: unknown = JSON.parse(\n      Buffer.from(cursor, \"base64url\").toString(\"utf8\"),\n    );\n\n    if (\n      typeof parsed === \"object\" &&\n      parsed !== null &&\n      \"offset\" in parsed &&\n      \"sessionId\" in parsed &&\n      \"createdAt\" in parsed &&\n      \"v\" in parsed &&\n      parsed.v === 3 &&\n      typeof parsed.sessionId === \"string\" &&\n      parsed.sessionId !== \"\" &&\n      typeof parsed.createdAt === \"number\" &&\n      Number.isInteger(parsed.createdAt) &&\n      parsed.createdAt >= 0 &&\n      typeof parsed.offset === \"number\" &&\n      Number.isInteger(parsed.offset) &&\n      parsed.offset >= 0\n    ) {\n      return {\n        createdAt: parsed.createdAt,\n        offset: parsed.offset,\n        sessionId: parsed.sessionId,\n      };\n    }\n    if (\n      typeof parsed === \"object\" &&\n      parsed !== null &&\n      \"offset\" in parsed &&\n      \"sessionId\" in parsed &&\n      \"v\" in parsed &&\n      parsed.v === 2 &&\n      typeof parsed.sessionId === \"string\" &&\n      parsed.sessionId !== \"\" &&\n      typeof parsed.offset === \"number\" &&\n      Number.isInteger(parsed.offset) &&\n      parsed.offset >= 0\n    ) {\n      return { offset: parsed.offset, sessionId: parsed.sessionId };\n    }\n  } catch {\n    throw new Error(\"Invalid search cursor.\");\n  }\n\n  throw new Error(\"Invalid search cursor.\");\n}\n\nfunction isBucketSearchCursor(value: unknown): value is BucketSearchCursor {\n  if (typeof value !== \"object\" || value === null || !(\"bucket\" in value)) {\n    return false;\n  }\n  const cursor = value as { readonly bucket: unknown; readonly key?: unknown };\n\n  switch (cursor.bucket) {\n    case 0:\n      return cursor.key === undefined || isChapterTitleCursorKey(cursor.key);\n    case 1:\n      return cursor.key === undefined || isObjectCursorKey(cursor.key);\n    case 2:\n      return cursor.key === undefined || isChunkCursorKey(cursor.key);\n    case 3:\n      return cursor.key === undefined || isTextCursorKey(cursor.key);\n    default:\n      return false;\n  }\n}\n\nfunction isChapterTitleCursorKey(\n  value: unknown,\n): value is SearchChapterTitleCursorKey {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    typeof (value as SearchChapterTitleCursorKey).archiveId === \"number\" &&\n    typeof (value as SearchChapterTitleCursorKey).chapterId === \"number\" &&\n    typeof (value as SearchChapterTitleCursorKey).score === \"number\"\n  );\n}\n\nfunction isObjectCursorKey(value: unknown): value is SearchObjectCursorKey {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    typeof (value as SearchObjectCursorKey).archiveId === \"number\" &&\n    typeof (value as SearchObjectCursorKey).id === \"string\" &&\n    ((value as SearchObjectCursorKey).kind === \"entity\" ||\n      (value as SearchObjectCursorKey).kind === \"triple\") &&\n    typeof (value as SearchObjectCursorKey).score === \"number\"\n  );\n}\n\nfunction isChunkCursorKey(value: unknown): value is SearchChunkCursorKey {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    typeof (value as SearchChunkCursorKey).archiveId === \"number\" &&\n    typeof (value as SearchChunkCursorKey).chunkId === \"number\" &&\n    typeof (value as SearchChunkCursorKey).score === \"number\"\n  );\n}\n\nfunction isTextCursorKey(value: unknown): value is SearchTextCursorKey {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    typeof (value as SearchTextCursorKey).archiveId === \"number\" &&\n    typeof (value as SearchTextCursorKey).chapterId === \"number\" &&\n    typeof (value as SearchTextCursorKey).kind === \"number\" &&\n    typeof (value as SearchTextCursorKey).rank === \"number\" &&\n    typeof (value as SearchTextCursorKey).sentenceIndex === \"number\"\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/retrieval/query/search-cache/database.d.ts

@@ -0,0 +1,7 @@
+import { Database } from '../../../document/database.js';
+import 'sqlite3';
+
+declare function openSearchSessionDatabase(): Promise<Database>;
+declare function getSearchSessionDatabasePath(): string;
+
+export { getSearchSessionDatabasePath, openSearchSessionDatabase };

package/dist/retrieval/query/search-cache/database.js

@@ -0,0 +1,47 @@
+import { join } from "path";
+import { rm } from "fs/promises";
+import { resolveWikiGraphCacheDirectoryPath } from "../../../runtime/common/wiki-graph/dir.js";
+import { openSharedStateDatabase } from "../../../document/index.js";
+import { SEARCH_SESSION_SCHEMA_SQL } from "./schema.js";
+let currentSearchSessionSchemaPath;
+async function openSearchSessionDatabase() {
+  const path = getSearchSessionDatabasePath();
+  const database = await openSharedStateDatabase(
+    path,
+    SEARCH_SESSION_SCHEMA_SQL
+  );
+  if (currentSearchSessionSchemaPath === path) {
+    return database;
+  }
+  if (await isSearchSessionSchemaCurrent(database)) {
+    currentSearchSessionSchemaPath = path;
+    return database;
+  }
+  await database.close();
+  await rm(path, { force: true });
+  await rm(`${path}.initialized`, { force: true });
+  currentSearchSessionSchemaPath = path;
+  return await openSharedStateDatabase(path, SEARCH_SESSION_SCHEMA_SQL);
+}
+function getSearchSessionDatabasePath() {
+  return join(getSearchSessionStateDirectoryPath(), "search-sessions.sqlite");
+}
+function getSearchSessionStateDirectoryPath() {
+  return resolveWikiGraphCacheDirectoryPath();
+}
+async function isSearchSessionSchemaCurrent(database) {
+  return await hasColumn(database, "search_entity_hits", "archive_id") && await hasColumn(database, "search_chunk_hits", "archive_id") && await hasColumn(database, "search_triple_hits", "archive_id") && await hasColumn(database, "search_evidence_hit_events", "archive_id");
+}
+async function hasColumn(database, table, column) {
+  const rows = await database.queryAll(
+    `PRAGMA table_info(${table})`,
+    void 0,
+    (row) => String(row.name)
+  );
+  return rows.includes(column);
+}
+export {
+  getSearchSessionDatabasePath,
+  openSearchSessionDatabase
+};
+//# sourceMappingURL=database.js.map

package/dist/retrieval/query/search-cache/database.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/retrieval/query/search-cache/database.ts"],"sourcesContent":["import { join } from \"path\";\nimport { rm } from \"fs/promises\";\n\nimport { resolveWikiGraphCacheDirectoryPath } from \"../../../runtime/common/wiki-graph/dir.js\";\nimport { openSharedStateDatabase } from \"../../../document/index.js\";\nimport type { Database } from \"../../../document/index.js\";\n\nimport { SEARCH_SESSION_SCHEMA_SQL } from \"./schema.js\";\n\nlet currentSearchSessionSchemaPath: string | undefined;\n\nexport async function openSearchSessionDatabase(): Promise<Database> {\n  const path = getSearchSessionDatabasePath();\n  const database = await openSharedStateDatabase(\n    path,\n    SEARCH_SESSION_SCHEMA_SQL,\n  );\n\n  if (currentSearchSessionSchemaPath === path) {\n    return database;\n  }\n\n  if (await isSearchSessionSchemaCurrent(database)) {\n    currentSearchSessionSchemaPath = path;\n    return database;\n  }\n\n  await database.close();\n  await rm(path, { force: true });\n  await rm(`${path}.initialized`, { force: true });\n\n  currentSearchSessionSchemaPath = path;\n  return await openSharedStateDatabase(path, SEARCH_SESSION_SCHEMA_SQL);\n}\n\nexport function getSearchSessionDatabasePath(): string {\n  return join(getSearchSessionStateDirectoryPath(), \"search-sessions.sqlite\");\n}\n\nfunction getSearchSessionStateDirectoryPath(): string {\n  return resolveWikiGraphCacheDirectoryPath();\n}\n\nasync function isSearchSessionSchemaCurrent(\n  database: Database,\n): Promise<boolean> {\n  return (\n    (await hasColumn(database, \"search_entity_hits\", \"archive_id\")) &&\n    (await hasColumn(database, \"search_chunk_hits\", \"archive_id\")) &&\n    (await hasColumn(database, \"search_triple_hits\", \"archive_id\")) &&\n    (await hasColumn(database, \"search_evidence_hit_events\", \"archive_id\"))\n  );\n}\n\nasync function hasColumn(\n  database: Database,\n  table: string,\n  column: string,\n): Promise<boolean> {\n  const rows = await database.queryAll(\n    `PRAGMA table_info(${table})`,\n    undefined,\n    (row) => String(row.name),\n  );\n\n  return rows.includes(column);\n}\n"],"mappings":"AAAA,SAAS,YAAY;AACrB,SAAS,UAAU;AAEnB,SAAS,0CAA0C;AACnD,SAAS,+BAA+B;AAGxC,SAAS,iCAAiC;AAE1C,IAAI;AAEJ,eAAsB,4BAA+C;AACnE,QAAM,OAAO,6BAA6B;AAC1C,QAAM,WAAW,MAAM;AAAA,IACrB;AAAA,IACA;AAAA,EACF;AAEA,MAAI,mCAAmC,MAAM;AAC3C,WAAO;AAAA,EACT;AAEA,MAAI,MAAM,6BAA6B,QAAQ,GAAG;AAChD,qCAAiC;AACjC,WAAO;AAAA,EACT;AAEA,QAAM,SAAS,MAAM;AACrB,QAAM,GAAG,MAAM,EAAE,OAAO,KAAK,CAAC;AAC9B,QAAM,GAAG,GAAG,IAAI,gBAAgB,EAAE,OAAO,KAAK,CAAC;AAE/C,mCAAiC;AACjC,SAAO,MAAM,wBAAwB,MAAM,yBAAyB;AACtE;AAEO,SAAS,+BAAuC;AACrD,SAAO,KAAK,mCAAmC,GAAG,wBAAwB;AAC5E;AAEA,SAAS,qCAA6C;AACpD,SAAO,mCAAmC;AAC5C;AAEA,eAAe,6BACb,UACkB;AAClB,SACG,MAAM,UAAU,UAAU,sBAAsB,YAAY,KAC5D,MAAM,UAAU,UAAU,qBAAqB,YAAY,KAC3D,MAAM,UAAU,UAAU,sBAAsB,YAAY,KAC5D,MAAM,UAAU,UAAU,8BAA8B,YAAY;AAEzE;AAEA,eAAe,UACb,UACA,OACA,QACkB;AAClB,QAAM,OAAO,MAAM,SAAS;AAAA,IAC1B,qBAAqB,KAAK;AAAA,IAC1B;AAAA,IACA,CAAC,QAAQ,OAAO,IAAI,IAAI;AAAA,EAC1B;AAEA,SAAO,KAAK,SAAS,MAAM;AAC7B;","names":[]}

package/dist/retrieval/query/search-cache/gc.d.ts

@@ -0,0 +1,6 @@
+import { GcContext, GcJobResult } from '../../../runtime/gc/types.js';
+
+declare function deleteArchiveSearchSessions(archiveKey: string): Promise<void>;
+declare function runSearchCacheGc(context: GcContext): Promise<GcJobResult>;
+
+export { deleteArchiveSearchSessions, runSearchCacheGc };

package/dist/retrieval/query/search-cache/gc.js

@@ -0,0 +1,110 @@
+import { stat } from "fs/promises";
+import { getNumber, getString } from "../../../document/database.js";
+import { isNodeError } from "../../../utils/node-error.js";
+import {
+  getSearchSessionDatabasePath,
+  openSearchSessionDatabase
+} from "./database.js";
+import { SEARCH_SESSION_MAX_COUNT } from "./schema.js";
+import { deleteSearchSession, deleteUnusedPredicates } from "./store.js";
+async function deleteArchiveSearchSessions(archiveKey) {
+  const database = await openSearchSessionDatabase();
+  try {
+    const sessionIds = await database.queryAll(
+      `
+        SELECT session_id
+        FROM search_sessions
+        WHERE archive_key = ?
+      `,
+      [archiveKey],
+      (row) => getString(row, "session_id")
+    );
+    await database.transaction(async () => {
+      for (const sessionId of sessionIds) {
+        await deleteSearchSession(database, sessionId);
+      }
+      await deleteUnusedPredicates(database);
+    });
+  } finally {
+    await database.close();
+  }
+}
+async function runSearchCacheGc(context) {
+  const databasePath = getSearchSessionDatabasePath();
+  const beforeBytes = await readFileSize(databasePath);
+  const database = await openSearchSessionDatabase();
+  try {
+    const scanned = await database.queryOne(
+      "SELECT COUNT(*) AS count FROM search_sessions",
+      void 0,
+      (row) => getNumber(row, "count")
+    );
+    const expiredSessionIds = context.force ? await listAllSearchSessionIds(database) : await listExpiredSearchSessionIds(database, context.now);
+    const prunedSessionIds = context.force ? [] : await listPrunedSearchSessionIds(database);
+    const sessionIds = [
+      .../* @__PURE__ */ new Set([...expiredSessionIds, ...prunedSessionIds])
+    ].sort();
+    if (!context.dryRun && sessionIds.length > 0) {
+      await database.transaction(async () => {
+        for (const sessionId of sessionIds) {
+          await deleteSearchSession(database, sessionId);
+        }
+        await deleteUnusedPredicates(database);
+      });
+      await database.run("VACUUM");
+    }
+    const afterBytes = await readFileSize(databasePath);
+    return {
+      freedBytes: Math.max(0, beforeBytes - afterBytes),
+      removed: sessionIds.length,
+      scanned: scanned ?? 0
+    };
+  } finally {
+    await database.close();
+  }
+}
+async function listExpiredSearchSessionIds(database, now) {
+  return await database.queryAll(
+    `
+      SELECT session_id
+      FROM search_sessions
+      WHERE expires_at < ?
+    `,
+    [now],
+    (row) => getString(row, "session_id")
+  );
+}
+async function listAllSearchSessionIds(database) {
+  return await database.queryAll(
+    "SELECT session_id FROM search_sessions",
+    void 0,
+    (row) => getString(row, "session_id")
+  );
+}
+async function listPrunedSearchSessionIds(database) {
+  return await database.queryAll(
+    `
+      SELECT session_id
+      FROM search_sessions
+      ORDER BY accessed_at DESC, created_at DESC, session_id
+      LIMIT -1 OFFSET ?
+    `,
+    [SEARCH_SESSION_MAX_COUNT],
+    (row) => getString(row, "session_id")
+  );
+}
+async function readFileSize(path) {
+  try {
+    return (await stat(path)).size;
+  } catch (error) {
+    if (isNodeError(error) && error.code === "ENOENT") {
+      return 0;
+    }
+    throw error;
+  }
+}
+export {
+  deleteArchiveSearchSessions,
+  runSearchCacheGc
+};
+//# sourceMappingURL=gc.js.map

package/dist/retrieval/query/search-cache/gc.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/retrieval/query/search-cache/gc.ts"],"sourcesContent":["import { stat } from \"fs/promises\";\n\nimport { getNumber, getString } from \"../../../document/database.js\";\nimport type { Database } from \"../../../document/index.js\";\nimport type { GcContext, GcJobResult } from \"../../../runtime/gc/index.js\";\nimport { isNodeError } from \"../../../utils/node-error.js\";\n\nimport {\n  getSearchSessionDatabasePath,\n  openSearchSessionDatabase,\n} from \"./database.js\";\nimport { SEARCH_SESSION_MAX_COUNT } from \"./schema.js\";\nimport { deleteSearchSession, deleteUnusedPredicates } from \"./store.js\";\n\nexport async function deleteArchiveSearchSessions(\n  archiveKey: string,\n): Promise<void> {\n  const database = await openSearchSessionDatabase();\n\n  try {\n    const sessionIds = await database.queryAll(\n      `\n        SELECT session_id\n        FROM search_sessions\n        WHERE archive_key = ?\n      `,\n      [archiveKey],\n      (row) => getString(row, \"session_id\"),\n    );\n\n    await database.transaction(async () => {\n      for (const sessionId of sessionIds) {\n        await deleteSearchSession(database, sessionId);\n      }\n      await deleteUnusedPredicates(database);\n    });\n  } finally {\n    await database.close();\n  }\n}\n\nexport async function runSearchCacheGc(\n  context: GcContext,\n): Promise<GcJobResult> {\n  const databasePath = getSearchSessionDatabasePath();\n  const beforeBytes = await readFileSize(databasePath);\n  const database = await openSearchSessionDatabase();\n\n  try {\n    const scanned = await database.queryOne(\n      \"SELECT COUNT(*) AS count FROM search_sessions\",\n      undefined,\n      (row) => getNumber(row, \"count\"),\n    );\n    const expiredSessionIds = context.force\n      ? await listAllSearchSessionIds(database)\n      : await listExpiredSearchSessionIds(database, context.now);\n    const prunedSessionIds = context.force\n      ? []\n      : await listPrunedSearchSessionIds(database);\n    const sessionIds = [\n      ...new Set([...expiredSessionIds, ...prunedSessionIds]),\n    ].sort();\n\n    if (!context.dryRun && sessionIds.length > 0) {\n      await database.transaction(async () => {\n        for (const sessionId of sessionIds) {\n          await deleteSearchSession(database, sessionId);\n        }\n        await deleteUnusedPredicates(database);\n      });\n      await database.run(\"VACUUM\");\n    }\n\n    const afterBytes = await readFileSize(databasePath);\n\n    return {\n      freedBytes: Math.max(0, beforeBytes - afterBytes),\n      removed: sessionIds.length,\n      scanned: scanned ?? 0,\n    };\n  } finally {\n    await database.close();\n  }\n}\n\nasync function listExpiredSearchSessionIds(\n  database: Database,\n  now: number,\n): Promise<string[]> {\n  return await database.queryAll(\n    `\n      SELECT session_id\n      FROM search_sessions\n      WHERE expires_at < ?\n    `,\n    [now],\n    (row) => getString(row, \"session_id\"),\n  );\n}\n\nasync function listAllSearchSessionIds(database: Database): Promise<string[]> {\n  return await database.queryAll(\n    \"SELECT session_id FROM search_sessions\",\n    undefined,\n    (row) => getString(row, \"session_id\"),\n  );\n}\n\nasync function listPrunedSearchSessionIds(\n  database: Database,\n): Promise<string[]> {\n  return await database.queryAll(\n    `\n      SELECT session_id\n      FROM search_sessions\n      ORDER BY accessed_at DESC, created_at DESC, session_id\n      LIMIT -1 OFFSET ?\n    `,\n    [SEARCH_SESSION_MAX_COUNT],\n    (row) => getString(row, \"session_id\"),\n  );\n}\n\nasync function readFileSize(path: string): Promise<number> {\n  try {\n    return (await stat(path)).size;\n  } catch (error) {\n    if (isNodeError(error) && error.code === \"ENOENT\") {\n      return 0;\n    }\n\n    throw error;\n  }\n}\n"],"mappings":"AAAA,SAAS,YAAY;AAErB,SAAS,WAAW,iBAAiB;AAGrC,SAAS,mBAAmB;AAE5B;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,gCAAgC;AACzC,SAAS,qBAAqB,8BAA8B;AAE5D,eAAsB,4BACpB,YACe;AACf,QAAM,WAAW,MAAM,0BAA0B;AAEjD,MAAI;AACF,UAAM,aAAa,MAAM,SAAS;AAAA,MAChC;AAAA;AAAA;AAAA;AAAA;AAAA,MAKA,CAAC,UAAU;AAAA,MACX,CAAC,QAAQ,UAAU,KAAK,YAAY;AAAA,IACtC;AAEA,UAAM,SAAS,YAAY,YAAY;AACrC,iBAAW,aAAa,YAAY;AAClC,cAAM,oBAAoB,UAAU,SAAS;AAAA,MAC/C;AACA,YAAM,uBAAuB,QAAQ;AAAA,IACvC,CAAC;AAAA,EACH,UAAE;AACA,UAAM,SAAS,MAAM;AAAA,EACvB;AACF;AAEA,eAAsB,iBACpB,SACsB;AACtB,QAAM,eAAe,6BAA6B;AAClD,QAAM,cAAc,MAAM,aAAa,YAAY;AACnD,QAAM,WAAW,MAAM,0BAA0B;AAEjD,MAAI;AACF,UAAM,UAAU,MAAM,SAAS;AAAA,MAC7B;AAAA,MACA;AAAA,MACA,CAAC,QAAQ,UAAU,KAAK,OAAO;AAAA,IACjC;AACA,UAAM,oBAAoB,QAAQ,QAC9B,MAAM,wBAAwB,QAAQ,IACtC,MAAM,4BAA4B,UAAU,QAAQ,GAAG;AAC3D,UAAM,mBAAmB,QAAQ,QAC7B,CAAC,IACD,MAAM,2BAA2B,QAAQ;AAC7C,UAAM,aAAa;AAAA,MACjB,GAAG,oBAAI,IAAI,CAAC,GAAG,mBAAmB,GAAG,gBAAgB,CAAC;AAAA,IACxD,EAAE,KAAK;AAEP,QAAI,CAAC,QAAQ,UAAU,WAAW,SAAS,GAAG;AAC5C,YAAM,SAAS,YAAY,YAAY;AACrC,mBAAW,aAAa,YAAY;AAClC,gBAAM,oBAAoB,UAAU,SAAS;AAAA,QAC/C;AACA,cAAM,uBAAuB,QAAQ;AAAA,MACvC,CAAC;AACD,YAAM,SAAS,IAAI,QAAQ;AAAA,IAC7B;AAEA,UAAM,aAAa,MAAM,aAAa,YAAY;AAElD,WAAO;AAAA,MACL,YAAY,KAAK,IAAI,GAAG,cAAc,UAAU;AAAA,MAChD,SAAS,WAAW;AAAA,MACpB,SAAS,WAAW;AAAA,IACtB;AAAA,EACF,UAAE;AACA,UAAM,SAAS,MAAM;AAAA,EACvB;AACF;AAEA,eAAe,4BACb,UACA,KACmB;AACnB,SAAO,MAAM,SAAS;AAAA,IACpB;AAAA;AAAA;AAAA;AAAA;AAAA,IAKA,CAAC,GAAG;AAAA,IACJ,CAAC,QAAQ,UAAU,KAAK,YAAY;AAAA,EACtC;AACF;AAEA,eAAe,wBAAwB,UAAuC;AAC5E,SAAO,MAAM,SAAS;AAAA,IACpB;AAAA,IACA;AAAA,IACA,CAAC,QAAQ,UAAU,KAAK,YAAY;AAAA,EACtC;AACF;AAEA,eAAe,2BACb,UACmB;AACnB,SAAO,MAAM,SAAS;AAAA,IACpB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMA,CAAC,wBAAwB;AAAA,IACzB,CAAC,QAAQ,UAAU,KAAK,YAAY;AAAA,EACtC;AACF;AAEA,eAAe,aAAa,MAA+B;AACzD,MAAI;AACF,YAAQ,MAAM,KAAK,IAAI,GAAG;AAAA,EAC5B,SAAS,OAAO;AACd,QAAI,YAAY,KAAK,KAAK,MAAM,SAAS,UAAU;AACjD,aAAO;AAAA,IACT;AAEA,UAAM;AAAA,EACR;AACF;","names":[]}

package/dist/retrieval/query/search-cache/hits.d.ts

@@ -0,0 +1,42 @@
+import { Database, SqlBindValue } from '../../../document/database.js';
+import { ArchiveFindHit } from '../archive-view/types.js';
+import { SearchEvidenceHitEventInput, SearchObjectCursorKey, SearchChunkHitInput, SearchEntityHitInput, SearchTripleHitInput } from './types.js';
+import 'sqlite3';
+import '../../../document/types.js';
+import '../../../text/source/meta.js';
+import 'zod';
+import '../../../graph/reading.js';
+import '../../../document/directory/types.js';
+import '../../../text/source/toc.js';
+import '../../../text/source/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 '../../../document/chapter/types.js';
+
+declare function insertSearchEvidenceHitEvent(database: Database, sessionId: string, event: SearchEvidenceHitEventInput): Promise<void>;
+declare function upsertSearchEntityHit(database: Database, sessionId: string, hit: SearchEntityHitInput): Promise<void>;
+declare function upsertSearchTripleHit(database: Database, sessionId: string, hit: SearchTripleHitInput): Promise<void>;
+declare function upsertSearchChunkHit(database: Database, sessionId: string, hit: SearchChunkHitInput): Promise<void>;
+declare function readEntitySearchEvidenceMentions(sessionId: string, mentionIds: readonly string[], limit: number): Promise<readonly {
+    readonly mentionId: string;
+    readonly score: number;
+}[]>;
+declare function mapEntitySearchObjectRow(row: Record<string, SqlBindValue>): ArchiveFindHit;
+declare function readSearchSessionEntityBucketRows(database: Database, sessionId: string, after: SearchObjectCursorKey | undefined, limit: number): Promise<readonly ArchiveFindHit[]>;
+declare function readSearchSessionTripleBucketRows(database: Database, sessionId: string, after: SearchObjectCursorKey | undefined, limit: number): Promise<readonly ArchiveFindHit[]>;
+declare function compareObjectBucketHits(left: ArchiveFindHit, right: ArchiveFindHit): number;
+
+export { compareObjectBucketHits, insertSearchEvidenceHitEvent, mapEntitySearchObjectRow, readEntitySearchEvidenceMentions, readSearchSessionEntityBucketRows, readSearchSessionTripleBucketRows, upsertSearchChunkHit, upsertSearchEntityHit, upsertSearchTripleHit };