wiki-graph-core 0.3.1 → 0.4.0

package/dist/archive/query/continuation-cursor.d.ts

@@ -1,61 +0,0 @@
-type ContinuationCursor = {
-    readonly archiveKey: string;
-    readonly archivePath: string;
-    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;
-} | {
-    readonly archiveKey: string;
-    readonly archivePath: string;
-    readonly backlinks?: boolean;
-    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;
-} | {
-    readonly archiveKey: string;
-    readonly archivePath: string;
-    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;
-} | {
-    readonly archiveKey: string;
-    readonly archivePath: string;
-    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;
-};
-declare function createContinuationCursor(input: ContinuationCursor): Promise<string>;
-declare function readContinuationCursor(cursorId: string): Promise<ContinuationCursor>;
-
-export { type ContinuationCursor, createContinuationCursor, readContinuationCursor };

package/dist/archive/query/continuation-cursor.js

@@ -1,363 +0,0 @@
-import { randomBytes } from "crypto";
-import { join } from "path";
-import { resolveWikiGraphCacheDirectoryPath } from "../../common/wiki-graph-dir.js";
-import { getOptionalString, getString } 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 createContinuationCursor(input) {
-  const database = await openContinuationCursorDatabase();
-  try {
-    await cleanExpiredContinuationCursors(database);
-    const now = Date.now();
-    const cursorId = await createUniqueCursorId(database);
-    await database.run(
-      `
-        INSERT INTO continuation_cursors (
-          cursor_id, archive_key, archive_path, kind, payload_json, format,
-          limit_value, created_at, expires_at, accessed_at
-        )
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-      `,
-      [
-        cursorId,
-        input.archiveKey,
-        input.archivePath,
-        input.kind,
-        JSON.stringify(createCursorPayload(input)),
-        input.format,
-        1,
-        now,
-        now + CURSOR_TTL_MS,
-        now
-      ]
-    );
-    return cursorId;
-  } finally {
-    await database.close();
-  }
-}
-async function readContinuationCursor(cursorId) {
-  const database = await openContinuationCursorDatabase();
-  try {
-    await cleanExpiredContinuationCursors(database);
-    const record = await database.queryOne(
-      `
-        SELECT archive_key, archive_path, kind, payload_json, format
-        FROM continuation_cursors
-        WHERE cursor_id = ?
-      `,
-      [cursorId],
-      (row) => ({
-        archiveKey: getString(row, "archive_key"),
-        archivePath: getString(row, "archive_path"),
-        format: parseCursorFormat(getString(row, "format")),
-        kind: getString(row, "kind"),
-        payloadJSON: getString(row, "payload_json")
-      })
-    );
-    if (record === void 0) {
-      throw new Error(
-        `Continuation cursor ${cursorId} was not found or has expired.`
-      );
-    }
-    await database.run(
-      "UPDATE continuation_cursors SET accessed_at = ? WHERE cursor_id = ?",
-      [Date.now(), cursorId]
-    );
-    return parseContinuationCursorRecord(record);
-  } finally {
-    await database.close();
-  }
-}
-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 },
-        types: input.types
-      };
-    case "search":
-      return {
-        ...input.backlinks === void 0 ? {} : { backlinks: input.backlinks },
-        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 },
-        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 },
-        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 },
-        targetUri: input.targetUri
-      };
-  }
-}
-function parseContinuationCursorRecord(record) {
-  const payload = parsePayload(record.payloadJSON);
-  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"),
-      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"),
-      cursor: getPayloadString(payload, "cursor"),
-      ...getPayloadOptionalPositiveInteger(payload, "evidenceLimit"),
-      format: record.format,
-      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,
-      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,
-      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 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 === 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.");
-}
-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 {
-  createContinuationCursor,
-  readContinuationCursor
-};
-//# sourceMappingURL=continuation-cursor.js.map

package/dist/archive/query/continuation-cursor.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/archive/query/continuation-cursor.ts"],"sourcesContent":["import { randomBytes } from \"crypto\";\nimport { join } from \"path\";\n\nimport { resolveWikiGraphCacheDirectoryPath } from \"../../common/wiki-graph-dir.js\";\nimport { getOptionalString, getString } from \"../../document/database.js\";\nimport { openSharedStateDatabase } from \"../../document/index.js\";\nimport type { Database } from \"../../document/index.js\";\n\nexport type ContinuationCursor =\n  | {\n      readonly archiveKey: string;\n      readonly archivePath: string;\n      readonly backlinks?: boolean;\n      readonly chapters: readonly number[] | null;\n      readonly cursor: string;\n      readonly evidenceLimit?: number;\n      readonly format: \"json\" | \"jsonl\" | \"text\";\n      readonly ids: readonly string[] | null;\n      readonly kind: \"collection\";\n      readonly order: \"doc-asc\" | \"doc-desc\";\n      readonly sourceContext?: number;\n      readonly triplePattern?: {\n        readonly objectQid?: string;\n        readonly predicate?: string;\n        readonly subjectQid?: string;\n      };\n      readonly types: readonly string[] | null;\n    }\n  | {\n      readonly archiveKey: string;\n      readonly archivePath: string;\n      readonly backlinks?: boolean;\n      readonly cursor: string;\n      readonly evidenceLimit?: number;\n      readonly format: \"json\" | \"jsonl\" | \"text\";\n      readonly kind: \"search\";\n      readonly query?: string;\n      readonly sourceContext?: number;\n      readonly triplePattern?: {\n        readonly objectQid?: string;\n        readonly predicate?: string;\n        readonly subjectQid?: string;\n      };\n      readonly types: readonly string[] | null;\n    }\n  | {\n      readonly archiveKey: string;\n      readonly archivePath: string;\n      readonly cursor: string;\n      readonly format: \"json\" | \"jsonl\" | \"text\";\n      readonly kind: \"evidence\";\n      readonly order: \"doc-asc\" | \"doc-desc\";\n      readonly query?: string;\n      readonly sourceContext?: number;\n      readonly targetUri: string;\n    }\n  | {\n      readonly archiveKey: string;\n      readonly archivePath: string;\n      readonly cursor: string;\n      readonly evidenceLimit?: number;\n      readonly format: \"json\" | \"jsonl\" | \"text\";\n      readonly kind: \"related\";\n      readonly order: \"doc-asc\" | \"doc-desc\";\n      readonly query?: string;\n      readonly role?: \"any\" | \"object\" | \"self\" | \"subject\";\n      readonly sourceContext?: number;\n      readonly targetUri: string;\n    };\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\nconst CURSOR_TTL_MS = 7 * 24 * 60 * 60 * 1000;\n\nexport async function createContinuationCursor(\n  input: ContinuationCursor,\n): Promise<string> {\n  const database = await openContinuationCursorDatabase();\n\n  try {\n    await cleanExpiredContinuationCursors(database);\n\n    const now = Date.now();\n    const cursorId = await createUniqueCursorId(database);\n\n    await database.run(\n      `\n        INSERT INTO continuation_cursors (\n          cursor_id, archive_key, archive_path, kind, payload_json, format,\n          limit_value, created_at, expires_at, accessed_at\n        )\n        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)\n      `,\n      [\n        cursorId,\n        input.archiveKey,\n        input.archivePath,\n        input.kind,\n        JSON.stringify(createCursorPayload(input)),\n        input.format,\n        1,\n        now,\n        now + CURSOR_TTL_MS,\n        now,\n      ],\n    );\n\n    return cursorId;\n  } finally {\n    await database.close();\n  }\n}\n\nexport async function readContinuationCursor(\n  cursorId: string,\n): Promise<ContinuationCursor> {\n  const database = await openContinuationCursorDatabase();\n\n  try {\n    await cleanExpiredContinuationCursors(database);\n\n    const record = await database.queryOne(\n      `\n        SELECT archive_key, archive_path, kind, payload_json, format\n        FROM continuation_cursors\n        WHERE cursor_id = ?\n      `,\n      [cursorId],\n      (row) => ({\n        archiveKey: getString(row, \"archive_key\"),\n        archivePath: getString(row, \"archive_path\"),\n        format: parseCursorFormat(getString(row, \"format\")),\n        kind: getString(row, \"kind\"),\n        payloadJSON: getString(row, \"payload_json\"),\n      }),\n    );\n\n    if (record === undefined) {\n      throw new Error(\n        `Continuation cursor ${cursorId} was not found or has expired.`,\n      );\n    }\n\n    await database.run(\n      \"UPDATE continuation_cursors SET accessed_at = ? WHERE cursor_id = ?\",\n      [Date.now(), cursorId],\n    );\n\n    return parseContinuationCursorRecord(record);\n  } finally {\n    await database.close();\n  }\n}\n\nfunction 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        types: input.types,\n      };\n    case \"search\":\n      return {\n        ...(input.backlinks === undefined\n          ? {}\n          : { backlinks: input.backlinks }),\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        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        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        targetUri: input.targetUri,\n      };\n  }\n}\n\nfunction 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\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      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      cursor: getPayloadString(payload, \"cursor\"),\n      ...getPayloadOptionalPositiveInteger(payload, \"evidenceLimit\"),\n      format: record.format,\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      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      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 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 === 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\nasync function createUniqueCursorId(database: Database): 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\nasync 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\nasync 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\nfunction 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,mBAAmB,iBAAiB;AAC7C,SAAS,+BAA+B;AAiExC,MAAM,iCAAiC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAkBvC,MAAM,gBAAgB,IAAI,KAAK,KAAK,KAAK;AAEzC,eAAsB,yBACpB,OACiB;AACjB,QAAM,WAAW,MAAM,+BAA+B;AAEtD,MAAI;AACF,UAAM,gCAAgC,QAAQ;AAE9C,UAAM,MAAM,KAAK,IAAI;AACrB,UAAM,WAAW,MAAM,qBAAqB,QAAQ;AAEpD,UAAM,SAAS;AAAA,MACb;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAOA;AAAA,QACE;AAAA,QACA,MAAM;AAAA,QACN,MAAM;AAAA,QACN,MAAM;AAAA,QACN,KAAK,UAAU,oBAAoB,KAAK,CAAC;AAAA,QACzC,MAAM;AAAA,QACN;AAAA,QACA;AAAA,QACA,MAAM;AAAA,QACN;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,EACT,UAAE;AACA,UAAM,SAAS,MAAM;AAAA,EACvB;AACF;AAEA,eAAsB,uBACpB,UAC6B;AAC7B,QAAM,WAAW,MAAM,+BAA+B;AAEtD,MAAI;AACF,UAAM,gCAAgC,QAAQ;AAE9C,UAAM,SAAS,MAAM,SAAS;AAAA,MAC5B;AAAA;AAAA;AAAA;AAAA;AAAA,MAKA,CAAC,QAAQ;AAAA,MACT,CAAC,SAAS;AAAA,QACR,YAAY,UAAU,KAAK,aAAa;AAAA,QACxC,aAAa,UAAU,KAAK,cAAc;AAAA,QAC1C,QAAQ,kBAAkB,UAAU,KAAK,QAAQ,CAAC;AAAA,QAClD,MAAM,UAAU,KAAK,MAAM;AAAA,QAC3B,aAAa,UAAU,KAAK,cAAc;AAAA,MAC5C;AAAA,IACF;AAEA,QAAI,WAAW,QAAW;AACxB,YAAM,IAAI;AAAA,QACR,uBAAuB,QAAQ;AAAA,MACjC;AAAA,IACF;AAEA,UAAM,SAAS;AAAA,MACb;AAAA,MACA,CAAC,KAAK,IAAI,GAAG,QAAQ;AAAA,IACvB;AAEA,WAAO,8BAA8B,MAAM;AAAA,EAC7C,UAAE;AACA,UAAM,SAAS,MAAM;AAAA,EACvB;AACF;AAEA,SAAS,oBAAoB,OAAmC;AAC9D,UAAQ,MAAM,MAAM;AAAA,IAClB,KAAK;AACH,aAAO;AAAA,QACL,GAAI,MAAM,cAAc,SACpB,CAAC,IACD,EAAE,WAAW,MAAM,UAAU;AAAA,QACjC,UAAU,MAAM;AAAA,QAChB,QAAQ,MAAM;AAAA,QACd,GAAI,MAAM,kBAAkB,SACxB,CAAC,IACD,EAAE,eAAe,MAAM,cAAc;AAAA,QACzC,KAAK,MAAM;AAAA,QACX,OAAO,MAAM;AAAA,QACb,GAAI,MAAM,kBAAkB,SACxB,CAAC,IACD,EAAE,eAAe,MAAM,cAAc;AAAA,QACzC,GAAI,MAAM,kBAAkB,SACxB,CAAC,IACD,EAAE,eAAe,MAAM,cAAc;AAAA,QACzC,OAAO,MAAM;AAAA,MACf;AAAA,IACF,KAAK;AACH,aAAO;AAAA,QACL,GAAI,MAAM,cAAc,SACpB,CAAC,IACD,EAAE,WAAW,MAAM,UAAU;AAAA,QACjC,QAAQ,MAAM;AAAA,QACd,GAAI,MAAM,kBAAkB,SACxB,CAAC,IACD,EAAE,eAAe,MAAM,cAAc;AAAA,QACzC,GAAI,MAAM,UAAU,SAAY,CAAC,IAAI,EAAE,OAAO,MAAM,MAAM;AAAA,QAC1D,GAAI,MAAM,kBAAkB,SACxB,CAAC,IACD,EAAE,eAAe,MAAM,cAAc;AAAA,QACzC,GAAI,MAAM,kBAAkB,SACxB,CAAC,IACD,EAAE,eAAe,MAAM,cAAc;AAAA,QACzC,OAAO,MAAM;AAAA,MACf;AAAA,IACF,KAAK;AACH,aAAO;AAAA,QACL,QAAQ,MAAM;AAAA,QACd,OAAO,MAAM;AAAA,QACb,GAAI,MAAM,UAAU,SAAY,CAAC,IAAI,EAAE,OAAO,MAAM,MAAM;AAAA,QAC1D,GAAI,MAAM,kBAAkB,SACxB,CAAC,IACD,EAAE,eAAe,MAAM,cAAc;AAAA,QACzC,WAAW,MAAM;AAAA,MACnB;AAAA,IACF,KAAK;AACH,aAAO;AAAA,QACL,QAAQ,MAAM;AAAA,QACd,GAAI,MAAM,kBAAkB,SACxB,CAAC,IACD,EAAE,eAAe,MAAM,cAAc;AAAA,QACzC,OAAO,MAAM;AAAA,QACb,GAAI,MAAM,UAAU,SAAY,CAAC,IAAI,EAAE,OAAO,MAAM,MAAM;AAAA,QAC1D,GAAI,MAAM,SAAS,SAAY,CAAC,IAAI,EAAE,MAAM,MAAM,KAAK;AAAA,QACvD,GAAI,MAAM,kBAAkB,SACxB,CAAC,IACD,EAAE,eAAe,MAAM,cAAc;AAAA,QACzC,WAAW,MAAM;AAAA,MACnB;AAAA,EACJ;AACF;AAEA,SAAS,8BAA8B,QAMhB;AACrB,QAAM,UAAU,aAAa,OAAO,WAAW;AAE/C,MAAI,OAAO,SAAS,cAAc;AAChC,WAAO;AAAA,MACL,YAAY,OAAO;AAAA,MACnB,aAAa,OAAO;AAAA,MACpB,GAAG,0BAA0B,SAAS,WAAW;AAAA,MACjD,UAAU,4BAA4B,SAAS,UAAU;AAAA,MACzD,QAAQ,iBAAiB,SAAS,QAAQ;AAAA,MAC1C,GAAG,kCAAkC,SAAS,eAAe;AAAA,MAC7D,QAAQ,OAAO;AAAA,MACf,KAAK,4BAA4B,SAAS,KAAK;AAAA,MAC/C,MAAM;AAAA,MACN,OAAO,gBAAgB,OAAO;AAAA,MAC9B,GAAG,0BAA0B,SAAS,iBAAiB,eAAe;AAAA,MACtE,GAAG,gCAAgC,OAAO;AAAA,MAC1C,OAAO,4BAA4B,SAAS,OAAO;AAAA,IACrD;AAAA,EACF;AAEA,MAAI,OAAO,SAAS,UAAU;AAC5B,WAAO;AAAA,MACL,YAAY,OAAO;AAAA,MACnB,aAAa,OAAO;AAAA,MACpB,GAAG,0BAA0B,SAAS,WAAW;AAAA,MACjD,QAAQ,iBAAiB,SAAS,QAAQ;AAAA,MAC1C,GAAG,kCAAkC,SAAS,eAAe;AAAA,MAC7D,QAAQ,OAAO;AAAA,MACf,MAAM;AAAA,MACN,GAAG,yBAAyB,SAAS,OAAO;AAAA,MAC5C,GAAG,0BAA0B,SAAS,iBAAiB,eAAe;AAAA,MACtE,GAAG,gCAAgC,OAAO;AAAA,MAC1C,OAAO,4BAA4B,SAAS,OAAO;AAAA,IACrD;AAAA,EACF;AAEA,MAAI,OAAO,SAAS,YAAY;AAC9B,WAAO;AAAA,MACL,YAAY,OAAO;AAAA,MACnB,aAAa,OAAO;AAAA,MACpB,QAAQ,iBAAiB,SAAS,QAAQ;AAAA,MAC1C,QAAQ,OAAO;AAAA,MACf,MAAM;AAAA,MACN,OAAO,gBAAgB,OAAO;AAAA,MAC9B,GAAG,yBAAyB,SAAS,OAAO;AAAA,MAC5C,GAAG,0BAA0B,SAAS,iBAAiB,eAAe;AAAA,MACtE,WAAW,iBAAiB,SAAS,WAAW;AAAA,IAClD;AAAA,EACF;AAEA,MAAI,OAAO,SAAS,WAAW;AAC7B,WAAO;AAAA,MACL,YAAY,OAAO;AAAA,MACnB,aAAa,OAAO;AAAA,MACpB,QAAQ,iBAAiB,SAAS,QAAQ;AAAA,MAC1C,GAAG,kCAAkC,SAAS,eAAe;AAAA,MAC7D,QAAQ,OAAO;AAAA,MACf,MAAM;AAAA,MACN,OAAO,gBAAgB,OAAO;AAAA,MAC9B,GAAG,yBAAyB,SAAS,OAAO;AAAA,MAC5C,GAAG,8BAA8B,OAAO;AAAA,MACxC,GAAG,0BAA0B,SAAS,iBAAiB,eAAe;AAAA,MACtE,WAAW,iBAAiB,SAAS,WAAW;AAAA,IAClD;AAAA,EACF;AAEA,QAAM,IAAI,MAAM,qCAAqC,OAAO,IAAI,GAAG;AACrE;AAEA,SAAS,aAAa,OAAwC;AAC5D,QAAM,SAAkB,KAAK,MAAM,KAAK;AAExC,MAAI,OAAO,WAAW,YAAY,WAAW,QAAQ,CAAC,MAAM,QAAQ,MAAM,GAAG;AAC3E,WAAO;AAAA,EACT;AAEA,QAAM,IAAI,MAAM,sCAAsC;AACxD;AAEA,SAAS,iBACP,SACA,KACQ;AACR,QAAM,QAAQ,QAAQ,GAAG;AAEzB,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO;AAAA,EACT;AAEA,QAAM,IAAI,MAAM,sCAAsC;AACxD;AAEA,SAAS,4BACP,SACA,KAC0B;AAC1B,QAAM,QAAQ,QAAQ,GAAG;AAEzB,MAAI,UAAU,MAAM;AAClB,WAAO;AAAA,EACT;AACA,MAAI,MAAM,QAAQ,KAAK,KAAK,MAAM,MAAM,CAAC,SAAS,OAAO,SAAS,QAAQ,GAAG;AAC3E,WAAO;AAAA,EACT;AAEA,QAAM,IAAI,MAAM,sCAAsC;AACxD;AAEA,SAAS,yBACP,SACA,KAC6B;AAC7B,QAAM,QAAQ,QAAQ,GAAG;AAEzB,MAAI,UAAU,QAAW;AACvB,WAAO,CAAC;AAAA,EACV;AACA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,EAAE,OAAO,MAAM;AAAA,EACxB;AAEA,QAAM,IAAI,MAAM,sCAAsC;AACxD;AAEA,SAAS,4BACP,SACA,KAC0B;AAC1B,QAAM,QAAQ,QAAQ,GAAG;AAEzB,MAAI,UAAU,MAAM;AAClB,WAAO;AAAA,EACT;AACA,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,UAAM,UAAoB,CAAC;AAE3B,eAAW,QAAQ,OAAO;AACxB,UAAI,OAAO,SAAS,YAAY,CAAC,OAAO,UAAU,IAAI,GAAG;AACvD,cAAM,IAAI,MAAM,sCAAsC;AAAA,MACxD;AACA,cAAQ,KAAK,IAAI;AAAA,IACnB;AAEA,WAAO;AAAA,EACT;AAEA,QAAM,IAAI,MAAM,sCAAsC;AACxD;AAEA,SAAS,gBACP,SACwB;AACxB,QAAM,QAAQ,QAAQ;AAEtB,MAAI,UAAU,aAAa,UAAU,YAAY;AAC/C,WAAO;AAAA,EACT;AAEA,QAAM,IAAI,MAAM,sCAAsC;AACxD;AAEA,SAAS,kCACP,SACA,KACqC;AACrC,QAAM,QAAQ,QAAQ,GAAG;AAEzB,MAAI,UAAU,QAAW;AACvB,WAAO,CAAC;AAAA,EACV;AACA,MAAI,OAAO,UAAU,YAAY,OAAO,UAAU,KAAK,KAAK,QAAQ,GAAG;AACrE,WAAO,EAAE,eAAe,MAAM;AAAA,EAChC;AAEA,QAAM,IAAI,MAAM,sCAAsC;AACxD;AAEA,SAAS,0BACP,SACA,KACA,WACgC;AAChC,QAAM,QAAQ,QAAQ,GAAG;AAEzB,MAAI,UAAU,QAAW;AACvB,WAAO,CAAC;AAAA,EACV;AACA,MAAI,OAAO,UAAU,YAAY,OAAO,UAAU,KAAK,KAAK,SAAS,GAAG;AACtE,WAAO,EAAE,CAAC,SAAS,GAAG,MAAM;AAAA,EAC9B;AAEA,QAAM,IAAI,MAAM,sCAAsC;AACxD;AAEA,SAAS,0BACP,SACA,KACkC;AAClC,QAAM,QAAQ,QAAQ,GAAG;AAEzB,MAAI,UAAU,QAAW;AACvB,WAAO,CAAC;AAAA,EACV;AACA,MAAI,OAAO,UAAU,WAAW;AAC9B,WAAO,EAAE,WAAW,MAAM;AAAA,EAC5B;AAEA,QAAM,IAAI,MAAM,sCAAsC;AACxD;AAEA,SAAS,8BACP,SAC2D;AAC3D,QAAM,QAAQ,QAAQ;AAEtB,MAAI,UAAU,QAAW;AACvB,WAAO,CAAC;AAAA,EACV;AACA,MACE,UAAU,SACV,UAAU,YACV,UAAU,UACV,UAAU,WACV;AACA,WAAO,EAAE,MAAM,MAAM;AAAA,EACvB;AAEA,QAAM,IAAI,MAAM,sCAAsC;AACxD;AAEA,SAAS,gCACP,SAOA;AACA,QAAM,QAAQ,QAAQ;AAEtB,MAAI,UAAU,QAAW;AACvB,WAAO,CAAC;AAAA,EACV;AACA,MAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,GAAG;AACvE,UAAM,IAAI,MAAM,sCAAsC;AAAA,EACxD;AAEA,QAAM,UAAU;AAChB,QAAM,aAAa,iCAAiC,SAAS,YAAY;AACzE,QAAM,YAAY,iCAAiC,SAAS,WAAW;AACvE,QAAM,YAAY,iCAAiC,SAAS,WAAW;AAEvE,SAAO;AAAA,IACL,eAAe;AAAA,MACb,GAAI,cAAc,SAAY,CAAC,IAAI,EAAE,UAAU;AAAA,MAC/C,GAAI,cAAc,SAAY,CAAC,IAAI,EAAE,UAAU;AAAA,MAC/C,GAAI,eAAe,SAAY,CAAC,IAAI,EAAE,WAAW;AAAA,IACnD;AAAA,EACF;AACF;AAEA,SAAS,iCACP,SACA,KACoB;AACpB,QAAM,QAAQ,QAAQ,GAAG;AAEzB,MAAI,UAAU,QAAW;AACvB,WAAO;AAAA,EACT;AACA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO;AAAA,EACT;AAEA,QAAM,IAAI,MAAM,sCAAsC;AACxD;AAEA,eAAe,qBAAqB,UAAqC;AACvE,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,eAAe,gCACb,UACe;AACf,QAAM,SAAS,IAAI,yDAAyD;AAAA,IAC1E,KAAK,IAAI;AAAA,EACX,CAAC;AACH;AAEA,eAAe,iCAAoD;AACjE,SAAO,MAAM;AAAA,IACX,KAAK,kCAAkC,GAAG,6BAA6B;AAAA,IACvE;AAAA,EACF;AACF;AAEA,SAAS,oCAA4C;AACnD,SAAO,mCAAmC;AAC5C;AAEA,SAAS,kBAAkB,OAA0C;AACnE,MAAI,UAAU,UAAU,UAAU,WAAW,UAAU,QAAQ;AAC7D,WAAO;AAAA,EACT;AAEA,QAAM,IAAI,MAAM,uCAAuC,KAAK,GAAG;AACjE;","names":[]}

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

@@ -1,29 +0,0 @@
-export { A as ArchiveBacklinkBucket, a as ArchiveBacklinks, b as ArchiveCollectionOptions, c as ArchiveCollectionResult, d as ArchiveCollectionType, e as ArchiveEvidence, f as ArchiveEvidenceItem, g as ArchiveFindEvidencePreview, h as ArchiveFindField, i as ArchiveFindFilterType, j as ArchiveFindHit, k as ArchiveFindObjectType, l as ArchiveFindOptions, m as ArchiveFindOrder, n as ArchiveFindPosition, o as ArchiveFindResult, p as ArchiveIndex, r as ArchiveListItem, s as ArchiveListKind, t as ArchiveNodeLabel, u as ArchiveNodeSourceFragment, v as ArchiveObjectType, w as ArchivePack, x as ArchivePage, y as ArchiveRelatedResult, z as ArchiveTriplePattern, O as clearDirtyArchiveSearchIndex, P as createArchiveSearchIndexFingerprint, U as findArchiveObjects, V as formatChapterId, W as formatEdgeId, X as formatNodeId, Y as formatSummaryId, Z as getArchiveIndex, _ as grepArchiveObjects, $ as isArchiveSearchIndexCurrent, a1 as listAllArchiveLinks, a2 as listArchiveCollection, a3 as listArchiveEvidence, a4 as listArchiveLinks, a5 as listArchiveObjects, a6 as listRelatedArchiveObjects, a7 as packArchiveContext, aa as readArchivePage, ab as readArchiveSearchIndexStatus, ac as readArchiveText, af as rebuildArchiveSearchIndex } from '../../index-B8NNnQ8P.js';
-export { ContinuationCursor, createContinuationCursor, readContinuationCursor } from './continuation-cursor.js';
-export { SearchSessionDescriptor, SearchSessionInput, SearchSessionPage, createSearchSession, deleteArchiveSearchSessions, readCachedSearchSessionPage, runSearchCacheGc } from './search-cache.js';
-import '../../document/database.js';
-import 'sqlite3';
-import '../../document/document.js';
-import '../../source/meta.js';
-import 'zod';
-import '../../source/toc.js';
-import '../../source/types.js';
-import '../../document/text-streams.js';
-import '../../document/types.js';
-import '../../document/stores.js';
-import '../../wikipage/types.js';
-import '../../facade/graph.js';
-import '../../facade/chapter.js';
-import '../../common/language.js';
-import '../../common/llm-scope.js';
-import '../../llm/client.js';
-import '../../llm/context.js';
-import '../../llm/cache.js';
-import '../../llm/types.js';
-import 'ai';
-import '../../reader/types.js';
-import '../../reader/attention/attention.js';
-import '../../reader/chunk-batch/types.js';
-import '../../reader/segment/types.js';
-import '../../serial.js';
-import '../../gc/types.js';

package/dist/archive/query/index.js

@@ -1,63 +0,0 @@
-import {
-  findArchiveObjects,
-  formatChapterId,
-  formatEdgeId,
-  formatNodeId,
-  formatSummaryId,
-  getArchiveIndex,
-  grepArchiveObjects,
-  createArchiveSearchIndexFingerprint,
-  clearDirtyArchiveSearchIndex,
-  isArchiveSearchIndexCurrent,
-  readArchiveSearchIndexStatus,
-  listAllArchiveLinks,
-  listArchiveCollection,
-  listArchiveEvidence,
-  listArchiveLinks,
-  listArchiveObjects,
-  listRelatedArchiveObjects,
-  packArchiveContext,
-  readArchivePage,
-  readArchiveText,
-  rebuildArchiveSearchIndex
-} from "./archive-view.js";
-import {
-  createContinuationCursor,
-  readContinuationCursor
-} from "./continuation-cursor.js";
-import {
-  createSearchSession,
-  deleteArchiveSearchSessions,
-  readCachedSearchSessionPage,
-  runSearchCacheGc
-} from "./search-cache.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/archive/query/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/archive/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 \"./archive-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  ArchiveListItem,\n  ArchiveListKind,\n  ArchiveNodeLabel,\n  ArchiveNodeSourceFragment,\n  ArchiveObjectType,\n  ArchivePack,\n  ArchivePage,\n  ArchiveRelatedResult,\n  ArchiveTriplePattern,\n} from \"./archive-view.js\";\nexport {\n  createContinuationCursor,\n  readContinuationCursor,\n} from \"./continuation-cursor.js\";\nexport type { ContinuationCursor } from \"./continuation-cursor.js\";\nexport {\n  createSearchSession,\n  deleteArchiveSearchSessions,\n  readCachedSearchSessionPage,\n  runSearchCacheGc,\n} from \"./search-cache.js\";\nexport type {\n  SearchSessionDescriptor,\n  SearchSessionInput,\n  SearchSessionPage,\n} from \"./search-cache.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;AA6BP;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

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

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/archive/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":[]}