wiki-graph-core 0.3.1

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

@@ -0,0 +1,61 @@
+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

@@ -0,0 +1,363 @@
+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

@@ -0,0 +1 @@
+{"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":"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","names":[]}

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

@@ -0,0 +1,29 @@
+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

@@ -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 "./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

@@ -0,0 +1 @@
+{"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.d.ts

@@ -0,0 +1,22 @@
+interface LexicalQuery {
+    readonly phrases: readonly string[];
+    readonly terms: readonly string[];
+}
+interface LexicalScore {
+    readonly matchCount: number;
+    readonly matchedTerms: readonly string[];
+    readonly missingTerms: readonly string[];
+    readonly score: number;
+    readonly snippetNeedle: string;
+}
+declare function createLexicalQuery(query: string): LexicalQuery | undefined;
+declare function listLexicalQueryCandidateTerms(query: string): readonly string[];
+declare function scoreLexicalText(value: string, query: LexicalQuery): LexicalScore | undefined;
+declare function createMentionLexicalHits<T extends {
+    readonly surface: string;
+}>(mentions: readonly T[], query: LexicalQuery): readonly {
+    readonly match: LexicalScore;
+    readonly mention: T;
+}[];
+
+export { type LexicalQuery, type LexicalScore, createLexicalQuery, createMentionLexicalHits, listLexicalQueryCandidateTerms, scoreLexicalText };