wiki-graph-sdk 0.7.0 → 0.7.1

package/dist/index.cjs

@@ -36,18 +36,18 @@ __export(src_exports, {
   DEFAULT_GENERATION_JOB_CONCURRENCY: () => DEFAULT_GENERATION_JOB_CONCURRENCY,
   DEFAULT_GENERATION_REQUEST_CONCURRENCY: () => DEFAULT_GENERATION_REQUEST_CONCURRENCY,
   DEFAULT_KNOWLEDGE_GRAPH_RECALL_PROMPT: () => import_wiki_graph_core8.DEFAULT_KNOWLEDGE_GRAPH_RECALL_PROMPT,
-  LLMPaymentRequiredError: () => import_wiki_graph_core16.LLMPaymentRequiredError,
+  LLMPaymentRequiredError: () => import_wiki_graph_core17.LLMPaymentRequiredError,
   LOCAL_CONFIG_SECTIONS: () => LOCAL_CONFIG_SECTIONS,
   NodeDirectory: () => NodeDirectory,
   NodeFile: () => NodeFile,
-  WIKI_GRAPH_URI_PREFIX: () => import_wiki_graph_core16.WIKI_GRAPH_URI_PREFIX,
+  WIKI_GRAPH_URI_PREFIX: () => import_wiki_graph_core17.WIKI_GRAPH_URI_PREFIX,
   WikiGraphArchiveExistsError: () => WikiGraphArchiveExistsError,
   WikiGraphArchiveHandle: () => WikiGraphArchiveHandle,
   WikiGraphArchiveManager: () => WikiGraphArchiveManager,
   WikiGraphConfigManager: () => WikiGraphConfigManager,
   WikiGraphContinuationManager: () => WikiGraphContinuationManager,
   WikiGraphConversionManager: () => WikiGraphConversionManager,
-  WikiGraphError: () => import_wiki_graph_core16.WikiGraphError,
+  WikiGraphError: () => import_wiki_graph_core17.WikiGraphError,
   WikiGraphJob: () => WikiGraphJob,
   WikiGraphJobManager: () => WikiGraphJobManager,
   WikiGraphLibrary: () => WikiGraphLibrary,
@@ -68,35 +68,35 @@ __export(src_exports, {
   embedQueryText: () => embedQueryText,
   embedQueryTextWithLocalConfig: () => embedQueryTextWithLocalConfig,
   ensureNodeWikiGraphPlatform: () => ensureNodeWikiGraphPlatform,
-  formatError: () => import_wiki_graph_core16.formatError,
+  formatError: () => import_wiki_graph_core17.formatError,
   formatGenerationPlanningDuration: () => formatGenerationPlanningDuration,
   formatGenerationPlanningModel: () => formatGenerationPlanningModel,
-  formatLocatedChapterResourceUri: () => import_wiki_graph_core16.formatLocatedChapterResourceUri,
-  formatLocatedChapterSourceCollectionUri: () => import_wiki_graph_core16.formatLocatedChapterSourceCollectionUri,
-  formatLocatedChapterUri: () => import_wiki_graph_core16.formatLocatedChapterUri,
-  formatLocatedWikiGraphUri: () => import_wiki_graph_core16.formatLocatedWikiGraphUri,
-  formatWikiGraphCommandUri: () => import_wiki_graph_core16.formatWikiGraphCommandUri,
-  formatWikiGraphLibraryUri: () => import_wiki_graph_core16.formatWikiGraphLibraryUri,
+  formatLocatedChapterResourceUri: () => import_wiki_graph_core17.formatLocatedChapterResourceUri,
+  formatLocatedChapterSourceCollectionUri: () => import_wiki_graph_core17.formatLocatedChapterSourceCollectionUri,
+  formatLocatedChapterUri: () => import_wiki_graph_core17.formatLocatedChapterUri,
+  formatLocatedWikiGraphUri: () => import_wiki_graph_core17.formatLocatedWikiGraphUri,
+  formatWikiGraphCommandUri: () => import_wiki_graph_core17.formatWikiGraphCommandUri,
+  formatWikiGraphLibraryUri: () => import_wiki_graph_core17.formatWikiGraphLibraryUri,
   getNodeResourcePath: () => getNodeResourcePath,
   getWikiGraphSDKRuntimeContext: () => getWikiGraphSDKRuntimeContext,
   getWikiGraphSDKStateDir: () => getWikiGraphSDKStateDir,
   installNodeWikiGraphPlatform: () => installNodeWikiGraphPlatform,
-  isSourceLocatorScopeUri: () => import_wiki_graph_core16.isSourceLocatorScopeUri,
-  isWikiGraphLibraryUri: () => import_wiki_graph_core16.isWikiGraphLibraryUri,
+  isSourceLocatorScopeUri: () => import_wiki_graph_core17.isSourceLocatorScopeUri,
+  isWikiGraphLibraryUri: () => import_wiki_graph_core17.isWikiGraphLibraryUri,
   loadRequiredStageConfig: () => loadRequiredStageConfig,
   loadWikiGraphRuntimeConfig: () => loadWikiGraphRuntimeConfig,
   maskLocalConfigSection: () => maskLocalConfigSection,
   nodeWikiGraphPlatform: () => nodeWikiGraphPlatform,
   nodeWikispineCommandRunner: () => nodeWikispineCommandRunner,
   normalizeLocalConfigKey: () => normalizeLocalConfigKey,
-  parseChapterPath: () => import_wiki_graph_core16.parseChapterPath,
-  parseChapterTreeInput: () => import_wiki_graph_core16.parseChapterTreeInput,
-  parseChapterUriPath: () => import_wiki_graph_core16.parseChapterUriPath,
+  parseChapterPath: () => import_wiki_graph_core17.parseChapterPath,
+  parseChapterTreeInput: () => import_wiki_graph_core17.parseChapterTreeInput,
+  parseChapterUriPath: () => import_wiki_graph_core17.parseChapterUriPath,
   parseLocalConfigSection: () => parseLocalConfigSection,
-  parseLocatedWikiGraphUri: () => import_wiki_graph_core16.parseLocatedWikiGraphUri,
-  parseSourceTextJsonl: () => import_wiki_graph_core16.parseSourceTextJsonl,
-  parseWikiGraphLibraryUri: () => import_wiki_graph_core16.parseWikiGraphLibraryUri,
-  parseWikiGraphUriSyntax: () => import_wiki_graph_core16.parseWikiGraphUriSyntax,
+  parseLocatedWikiGraphUri: () => import_wiki_graph_core17.parseLocatedWikiGraphUri,
+  parseSourceTextJsonl: () => import_wiki_graph_core17.parseSourceTextJsonl,
+  parseWikiGraphLibraryUri: () => import_wiki_graph_core17.parseWikiGraphLibraryUri,
+  parseWikiGraphUriSyntax: () => import_wiki_graph_core17.parseWikiGraphUriSyntax,
   planGenerationTask: () => planGenerationTask,
   putLocalConfigValue: () => putLocalConfigValue,
   readLocalConfigSection: () => readLocalConfigSection,
@@ -117,15 +117,18 @@ __export(src_exports, {
 module.exports = __toCommonJS(src_exports);
 
 // src/archive/archive.ts
-var import_crypto = require("crypto");
+var import_crypto2 = require("crypto");
 var import_promises3 = require("fs/promises");
 var import_os3 = require("os");
-var import_path3 = require("path");
+var import_path4 = require("path");
 var import_stream = require("stream");
 var import_wiki_graph_core5 = require("wiki-graph-core");
 
 // src/conversions.ts
+var import_crypto = require("crypto");
+var import_fs = require("fs");
 var import_promises2 = require("fs/promises");
+var import_path3 = require("path");
 var import_wiki_graph_core2 = require("wiki-graph-core");
 
 // src/llm.ts
@@ -1462,6 +1465,9 @@ var WikiGraphConversionManager = class {
     if (options.targetStage !== void 0 && options.output.format !== "wikg") {
       throw new Error("targetStage is only supported for wikg output.");
     }
+    if (options.output.format === "pcex") {
+      throw new Error("pcex is supported only as a conversion input.");
+    }
     if (options.targetStage !== void 0 && options.input.format === "wikg") {
       throw new Error(
         "targetStage is only supported when creating a wikg archive."
@@ -1480,7 +1486,13 @@ var WikiGraphConversionManager = class {
       options.digestDirectory,
       requiresDigest
     );
+    let chapterCount;
     const write = async (archive) => {
+      if (requiresDigest) await options.onSourceImported?.();
+      if (typeof archive.readToc === "function") {
+        const toc = await archive.readToc();
+        chapterCount = toc === void 0 ? void 0 : countTocChapters(toc.items);
+      }
       await writeArchive(archive, options.output.path, options.output.format);
     };
     if (options.input.format === "wikg") {
@@ -1513,16 +1525,28 @@ var WikiGraphConversionManager = class {
       };
       if (options.input.format === "epub") {
         await app.digestEpubSession(digestOptions, write);
+      } else if (options.input.format === "pcex") {
+        await app.digestPcexSession(
+          {
+            ...digestOptions,
+            pdfDigest: options.input.sourcePdf.digest,
+            ...options.input.sourcePdf.name === void 0 ? {} : { pdfName: options.input.sourcePdf.name }
+          },
+          write
+        );
       } else if (options.input.format === "markdown") {
         await app.digestMarkdownSession(digestOptions, write);
       } else {
         await app.digestTxtSession(digestOptions, write);
       }
     }
+    const sourceArtifact = await resolveSourceArtifact(options.input);
     return {
+      ...chapterCount === void 0 ? {} : { chapterCount },
       inputFormat: options.input.format,
       outputFormat: options.output.format,
-      outputPath: options.output.path
+      outputPath: options.output.path,
+      ...sourceArtifact === void 0 ? {} : { sourceArtifact }
     };
   }
 };
@@ -1538,8 +1562,48 @@ async function writeArchive(archive, path, format) {
   const file = new NodeFile(resolveWikiGraphRuntimePath(path));
   if (format === "epub") await archive.exportEpub(file);
   else if (format === "wikg") await archive.saveAs(file);
+  else if (format === "pcex") throw new Error("pcex output is not supported.");
   else await archive.exportText(file);
 }
+async function resolveSourceArtifact(input) {
+  if (!("path" in input) || input.format === "wikg") return void 0;
+  if (input.format === "pcex") {
+    return {
+      digest: input.sourcePdf.digest.trim().toLowerCase(),
+      mediaType: "application/pdf",
+      ...input.sourcePdf.name === void 0 ? {} : { name: input.sourcePdf.name }
+    };
+  }
+  if (input.format !== "epub") return void 0;
+  const path = resolveWikiGraphRuntimePath(input.path);
+  const hash = (0, import_crypto.createHash)("sha256");
+  try {
+    for await (const chunk of (0, import_fs.createReadStream)(path)) {
+      hash.update(chunk);
+    }
+  } catch (error) {
+    if (isNodeErrorCode(error, "ENOENT")) return void 0;
+    throw error;
+  }
+  return {
+    digest: hash.digest("hex"),
+    mediaType: "application/epub+zip",
+    name: (0, import_path3.basename)(path)
+  };
+}
+function isNodeErrorCode(error, code) {
+  return typeof error === "object" && error !== null && "code" in error && error.code === code;
+}
+function countTocChapters(items) {
+  let count = 0;
+  for (const item of items) {
+    if (item.serialId !== void 0) count += 1;
+    count += countTocChapters(
+      item.children
+    );
+  }
+  return count;
+}
 
 // src/query-runtime.ts
 var import_wiki_graph_core3 = require("wiki-graph-core");
@@ -2247,9 +2311,9 @@ var WikiGraphArchiveManager = class {
       if (options.replace !== true && await nodePathExists(path)) {
         throw new WikiGraphArchiveExistsError(path);
       }
-      const outputPath = (0, import_path3.join)(
-        (0, import_path3.dirname)(path),
-        `.${(0, import_path3.basename)(path)}.${(0, import_crypto.randomUUID)()}.tmp.wikg`
+      const outputPath = (0, import_path4.join)(
+        (0, import_path4.dirname)(path),
+        `.${(0, import_path4.basename)(path)}.${(0, import_crypto2.randomUUID)()}.tmp.wikg`
       );
       try {
         if (options.importPath === void 0) {
@@ -2892,7 +2956,7 @@ function createPathLocation(path) {
 }
 async function createEmptyArchiveFile(path) {
   const directoryPath = await (0, import_promises3.mkdtemp)(
-    (0, import_path3.join)((0, import_os3.tmpdir)(), "wikigraph-archive-write-")
+    (0, import_path4.join)((0, import_os3.tmpdir)(), "wikigraph-archive-write-")
   );
   try {
     const directory = new NodeDirectory(directoryPath);
@@ -3479,7 +3543,7 @@ function createLibraryQueryPayload(context) {
 }
 
 // src/default-worker.ts
-var import_wiki_graph_core11 = require("wiki-graph-core");
+var import_wiki_graph_core12 = require("wiki-graph-core");
 var import_worker3 = require("wiki-graph-core/worker");
 
 // src/stage.ts
@@ -3514,6 +3578,7 @@ async function loadRequiredStageConfig(options) {
 
 // src/worker.ts
 var import_worker = require("wiki-graph-core/worker");
+var import_wiki_graph_core11 = require("wiki-graph-core");
 var import_worker2 = require("wiki-graph-core/worker");
 async function runBuildJobWorker(options) {
   installNodeWikiGraphPlatform();
@@ -3530,7 +3595,7 @@ async function runWikiGraphQueueWorker(options = {}) {
   await runBuildJobWorker({
     concurrency: config.concurrent?.job ?? DEFAULT_GENERATION_JOB_CONCURRENCY,
     executeJob: async (job, reporter, context) => {
-      await (0, import_wiki_graph_core11.withLoggingContext)(
+      await (0, import_wiki_graph_core12.withLoggingContext)(
         { logDirectory: job.log, operation: "build-job" },
         async () => await executeBuildJob(job, reporter, context)
       );
@@ -3553,7 +3618,7 @@ async function executeBuildJob(job, reporter, context) {
       let stage = await readChapterStage(job);
       if (stage === "sourced") {
         await executeStep(job, "reading-graph", execution, reporter, context, {
-          ...execution.extractionPrompt === void 0 ? {} : { extractionPrompt: execution.extractionPrompt }
+          ...execution.extractionPrompt === void 0 ? {} : { prompt: execution.extractionPrompt }
         });
         stage = await readChapterStage(job);
       }
@@ -3586,8 +3651,8 @@ async function executeBuildJob(job, reporter, context) {
       }
     }
     await executeStep(job, job.target, execution, reporter, context, {
-      ...job.target === "reading-graph" ? { extractionPrompt: execution.extractionPrompt } : {},
-      ...job.target === "knowledge-graph" ? { policyPrompt: execution.knowledgeGraphPrompt } : {}
+      ...job.target === "reading-graph" ? { prompt: execution.extractionPrompt } : {},
+      ...job.target === "knowledge-graph" ? { prompt: execution.knowledgeGraphPrompt } : {}
     });
   } finally {
     await execution.close();
@@ -3602,9 +3667,9 @@ async function executeStep(job, kind, execution, reporter, context, inputOptions
   const stepWorkspace = await resetStepWorkspace(job.workspace, kind);
   const inputFile = await stepWorkspace.createFile("input.jsonl");
   const outputWorkspace = await stepWorkspace.createDirectory("output");
-  const revision = await new import_wiki_graph_core11.WikiGraphArchiveFile(job.archive).readDocument(
+  const revision = await new import_wiki_graph_core12.WikiGraphArchiveFile(job.archive).readDocument(
     async (document) => {
-      await (0, import_wiki_graph_core11.getChapterDetails)(document, job.chapterId);
+      await (0, import_wiki_graph_core12.getChapterDetails)(document, job.chapterId);
       return await (0, import_worker3.writeChapterJobInputFile)(
         document,
         job.chapterId,
@@ -3614,7 +3679,7 @@ async function executeStep(job, kind, execution, reporter, context, inputOptions
       );
     }
   );
-  await (0, import_wiki_graph_core11.recordBuildJobInputRevision)({
+  await (0, import_wiki_graph_core12.recordBuildJobInputRevision)({
     currentRevision: revision,
     jobId: job.jobId,
     ownerId: requireRunningJobOwnerId(job)
@@ -3644,8 +3709,8 @@ async function executeStep(job, kind, execution, reporter, context, inputOptions
     total: 1,
     unit: "item"
   });
-  await new import_wiki_graph_core11.WikiGraphArchiveFile(job.archive).write(async (document) => {
-    assertJobStillRunning(await (0, import_wiki_graph_core11.getBuildJob)(job.jobId));
+  await new import_wiki_graph_core12.WikiGraphArchiveFile(job.archive).write(async (document) => {
+    assertJobStillRunning(await (0, import_wiki_graph_core12.getBuildJob)(job.jobId));
     await (0, import_worker3.applyChapterJobArtifactFile)(
       document,
       job.chapterId,
@@ -3661,7 +3726,7 @@ async function executeStep(job, kind, execution, reporter, context, inputOptions
     unit: "item"
   });
   await reporter.stepCompleted(kind);
-  assertJobStillRunning(await (0, import_wiki_graph_core11.getBuildJob)(job.jobId));
+  assertJobStillRunning(await (0, import_wiki_graph_core12.getBuildJob)(job.jobId));
 }
 async function openJobExecutor(job, config, signal, reporter) {
   const generation = !job.target.startsWith("index-");
@@ -3680,13 +3745,13 @@ async function openJobExecutor(job, config, signal, reporter) {
   const request = llm === void 0 ? void 0 : async (messages, index, maxRetries) => await llm.request(messages, {
     retryIndex: index,
     retryMax: maxRetries,
-    scope: import_wiki_graph_core11.WikiGraphScope.ReaderExtraction,
+    scope: import_wiki_graph_core12.WikiGraphScope.ReaderExtraction,
     signal
   });
   if (request !== void 0 && llm !== void 0) {
     request.lazy = async (operation) => await llm.request(async () => await operation(request));
   }
-  const wikimediaResolver = job.target !== "knowledge-graph" ? void 0 : await (0, import_wiki_graph_core11.openWikimediaResolver)(
+  const wikimediaResolver = job.target !== "knowledge-graph" ? void 0 : await (0, import_wiki_graph_core12.openWikimediaResolver)(
     config.wikimedia === void 0 ? {
       kind: "local",
       llmRequest: requireValue(
@@ -3729,12 +3794,12 @@ async function resetStepWorkspace(workspace, kind) {
   return await workspace.createDirectory(name);
 }
 async function readChapterStage(job) {
-  return await new import_wiki_graph_core11.WikiGraphArchiveFile(job.archive).readDocument(
-    async (document) => (await (0, import_wiki_graph_core11.getChapterDetails)(document, job.chapterId)).stage
+  return await new import_wiki_graph_core12.WikiGraphArchiveFile(job.archive).readDocument(
+    async (document) => (await (0, import_wiki_graph_core12.getChapterDetails)(document, job.chapterId)).stage
   );
 }
 async function assertCurrentFtsArtifact(job) {
-  await new import_wiki_graph_core11.WikiGraphArchiveFile(job.archive).readDocument(async (document) => {
+  await new import_wiki_graph_core12.WikiGraphArchiveFile(job.archive).readDocument(async (document) => {
     const revision = await document.serials.getRevision(job.chapterId);
     const artifact = await document.indexArtifacts.get(job.chapterId, "fts");
     if (artifact?.sourceRevision !== revision) {
@@ -3833,27 +3898,27 @@ function normalizeOptionalPath(path) {
 }
 
 // src/jobs.ts
-var import_wiki_graph_core12 = require("wiki-graph-core");
+var import_wiki_graph_core13 = require("wiki-graph-core");
 var TERMINAL_STATES = /* @__PURE__ */ new Set(["canceled", "failed", "succeeded"]);
 var TERMINAL_EVENT_GRACE_READS = 3;
 var CORE_BUILD_JOB_BACKEND = {
-  add: async (options) => await (0, import_wiki_graph_core12.addBuildJob)(options),
-  boost: async (jobId) => await (0, import_wiki_graph_core12.boostBuildJob)(jobId),
-  cancel: async (jobId) => await (0, import_wiki_graph_core12.cancelBuildJob)(jobId),
-  get: async (jobId) => await (0, import_wiki_graph_core12.getBuildJob)(jobId),
-  list: async (options) => await (0, import_wiki_graph_core12.listBuildJobs)(options),
-  pause: async (jobId) => await (0, import_wiki_graph_core12.pauseBuildJob)(jobId),
+  add: async (options) => await (0, import_wiki_graph_core13.addBuildJob)(options),
+  boost: async (jobId) => await (0, import_wiki_graph_core13.boostBuildJob)(jobId),
+  cancel: async (jobId) => await (0, import_wiki_graph_core13.cancelBuildJob)(jobId),
+  get: async (jobId) => await (0, import_wiki_graph_core13.getBuildJob)(jobId),
+  list: async (options) => await (0, import_wiki_graph_core13.listBuildJobs)(options),
+  pause: async (jobId) => await (0, import_wiki_graph_core13.pauseBuildJob)(jobId),
   readEventChunk: async (job, cursor) => await readIncrementalBuildJobEvents(job, cursor),
-  readEvents: async (job) => await (0, import_wiki_graph_core12.readBuildJobEvents)(job),
-  resume: async (jobId) => await (0, import_wiki_graph_core12.resumeBuildJob)(jobId),
-  setTarget: async (jobId, target) => await (0, import_wiki_graph_core12.updateBuildJobTarget)(jobId, target)
+  readEvents: async (job) => await (0, import_wiki_graph_core13.readBuildJobEvents)(job),
+  resume: async (jobId) => await (0, import_wiki_graph_core13.resumeBuildJob)(jobId),
+  setTarget: async (jobId, target) => await (0, import_wiki_graph_core13.updateBuildJobTarget)(jobId, target)
 };
 async function readIncrementalBuildJobEvents(job, cursor) {
   let reader;
   try {
     reader = await job.events.openReader();
   } catch {
-    return { cursor, events: await (0, import_wiki_graph_core12.readBuildJobEvents)(job) };
+    return { cursor, events: await (0, import_wiki_graph_core13.readBuildJobEvents)(job) };
   }
   try {
     const offset = cursor <= reader.size ? cursor : 0;
@@ -3886,7 +3951,7 @@ var WikiGraphJobManager = class {
     return this.#createHandle(job);
   }
   async clean() {
-    return await this.#runtime.run(async () => await (0, import_wiki_graph_core12.cleanBuildJobs)());
+    return await this.#runtime.run(async () => await (0, import_wiki_graph_core13.cleanBuildJobs)());
   }
   async get(jobId) {
     return this.#createHandle(
@@ -3895,7 +3960,7 @@ var WikiGraphJobManager = class {
   }
   async resolveId(reference) {
     return await this.#runtime.run(
-      async () => await (0, import_wiki_graph_core12.resolveBuildJobId)(reference)
+      async () => await (0, import_wiki_graph_core13.resolveBuildJobId)(reference)
     );
   }
   async list(options = {}) {
@@ -3923,9 +3988,9 @@ var WikiGraphJobManager = class {
       const entries = (await Promise.all(
         [...jobsByArchive].map(async ([archivePath, archiveJobs]) => {
           try {
-            const chapters = await new import_wiki_graph_core12.WikiGraphArchiveFile(
+            const chapters = await new import_wiki_graph_core13.WikiGraphArchiveFile(
               new NodeFile(archivePath)
-            ).readDocument(async (document) => await (0, import_wiki_graph_core12.listChapters)(document));
+            ).readDocument(async (document) => await (0, import_wiki_graph_core13.listChapters)(document));
             const chaptersById = new Map(
               chapters.map((chapter) => [chapter.chapterId, chapter])
             );
@@ -3935,7 +4000,7 @@ var WikiGraphJobManager = class {
                 [
                   job.jobId,
                   {
-                    locatedUri: (0, import_wiki_graph_core12.formatLocatedChapterUri)(
+                    locatedUri: (0, import_wiki_graph_core13.formatLocatedChapterUri)(
                       archivePath,
                       chapter.path
                     ),
@@ -3962,10 +4027,10 @@ var WikiGraphJobManager = class {
       const target = options.target ?? "reading-summary";
       await validateQueueTargetConfig(target, options.llmJSON);
       const selectedExplicitly = options.chapterId !== void 0 || options.chapterIds !== void 0 || options.chapterPath !== void 0 || options.depth !== void 0;
-      const candidates = await new import_wiki_graph_core12.WikiGraphArchiveFile(
+      const candidates = await new import_wiki_graph_core13.WikiGraphArchiveFile(
         location.archiveFile
       ).readDocument(async (document) => {
-        const chapters = await (0, import_wiki_graph_core12.listChapters)(document);
+        const chapters = await (0, import_wiki_graph_core13.listChapters)(document);
         const selected = await selectQueueChapters(document, chapters, options);
         const checked = await Promise.all(
           selected.map(async (chapter) => ({
@@ -4023,10 +4088,10 @@ var WikiGraphJobManager = class {
       const target = options.target ?? "reading-summary";
       await validateQueueTargetConfig(target, options.llmJSON);
       const selectedExplicitly = options.chapterId !== void 0 || options.chapterIds !== void 0 || options.chapterPath !== void 0 || options.depth !== void 0;
-      const candidates = await new import_wiki_graph_core12.WikiGraphArchiveFile(
+      const candidates = await new import_wiki_graph_core13.WikiGraphArchiveFile(
         location.archiveFile
       ).readDocument(async (document) => {
-        const chapters = await (0, import_wiki_graph_core12.listChapters)(document);
+        const chapters = await (0, import_wiki_graph_core13.listChapters)(document);
         const selected = await selectQueueChapters(document, chapters, options);
         return await Promise.all(
           selected.map(async (chapter) => ({
@@ -4200,7 +4265,7 @@ async function selectQueueChapters(document, chapters, options) {
   if (options.chapterPath === void 0) {
     return options.depth === void 0 ? chapters : chapters.filter((chapter) => chapter.depth <= options.depth);
   }
-  const rootId = await (0, import_wiki_graph_core12.resolveChapterPathReadonly)(
+  const rootId = await (0, import_wiki_graph_core13.resolveChapterPathReadonly)(
     document,
     options.chapterPath
   );
@@ -4294,7 +4359,7 @@ function forwardAbort(source, target) {
 }
 
 // src/libraries.ts
-var import_wiki_graph_core13 = require("wiki-graph-core");
+var import_wiki_graph_core14 = require("wiki-graph-core");
 var import_promises4 = require("fs/promises");
 var WikiGraphLibraryManager = class {
   #runtime;
@@ -4305,20 +4370,20 @@ var WikiGraphLibraryManager = class {
     const record = await this.#runtime.run(async () => {
       const path = resolveWikiGraphRuntimePath(folder);
       await (0, import_promises4.mkdir)(path);
-      return await (0, import_wiki_graph_core13.createWikiGraphLibrary)({ folder: new NodeDirectory(path) });
+      return await (0, import_wiki_graph_core14.createWikiGraphLibrary)({ folder: new NodeDirectory(path) });
     });
     return new WikiGraphLibrary(this.#runtime, record);
   }
-  async get(uri = (0, import_wiki_graph_core13.formatWikiGraphLibraryUri)()) {
+  async get(uri = (0, import_wiki_graph_core14.formatWikiGraphLibraryUri)()) {
     const target = requireLibraryTarget(uri);
     const record = await this.#runtime.run(
-      async () => await (0, import_wiki_graph_core13.resolveWikiGraphLibrary)(target)
+      async () => await (0, import_wiki_graph_core14.resolveWikiGraphLibrary)(target)
     );
     return new WikiGraphLibrary(this.#runtime, record);
   }
   async addArchive(options) {
     return await this.#runtime.run(
-      async () => await (0, import_wiki_graph_core13.addWikiGraphLibraryArchive)({
+      async () => await (0, import_wiki_graph_core14.addWikiGraphLibraryArchive)({
         inputFile: new NodeFile(
           resolveWikiGraphRuntimePath(options.inputPath)
         ),
@@ -4329,12 +4394,12 @@ var WikiGraphLibraryManager = class {
   }
   async assertCurrent(target) {
     await this.#runtime.run(
-      async () => await (0, import_wiki_graph_core13.assertWikiGraphLibrarySchemaCurrent)(requireLibraryTarget(target))
+      async () => await (0, import_wiki_graph_core14.assertWikiGraphLibrarySchemaCurrent)(requireLibraryTarget(target))
     );
   }
   async rebind(target, folder) {
     return await this.#runtime.run(
-      async () => await (0, import_wiki_graph_core13.rebindWikiGraphLibrary)({
+      async () => await (0, import_wiki_graph_core14.rebindWikiGraphLibrary)({
         folder: new NodeDirectory(resolveWikiGraphRuntimePath(folder)),
         target: requireLibraryTarget(target)
       })
@@ -4342,22 +4407,22 @@ var WikiGraphLibraryManager = class {
   }
   async remove(target) {
     return await this.#runtime.run(
-      async () => await (0, import_wiki_graph_core13.removeWikiGraphLibrary)(requireLibraryTarget(target))
+      async () => await (0, import_wiki_graph_core14.removeWikiGraphLibrary)(requireLibraryTarget(target))
     );
   }
   async scan(target) {
     return await this.#runtime.run(
-      async () => await (0, import_wiki_graph_core13.scanWikiGraphLibrary)(requireLibraryTarget(target))
+      async () => await (0, import_wiki_graph_core14.scanWikiGraphLibrary)(requireLibraryTarget(target))
     );
   }
   async getArchive(target) {
     return await this.#runtime.run(
-      async () => await (0, import_wiki_graph_core13.getWikiGraphLibraryArchive)(requireLibraryTarget(target))
+      async () => await (0, import_wiki_graph_core14.getWikiGraphLibraryArchive)(requireLibraryTarget(target))
     );
   }
   async moveArchive(options) {
     return await this.#runtime.run(
-      async () => await (0, import_wiki_graph_core13.moveWikiGraphLibraryArchive)({
+      async () => await (0, import_wiki_graph_core14.moveWikiGraphLibraryArchive)({
         target: requireLibraryTarget(options.target),
         to: options.to
       })
@@ -4365,19 +4430,19 @@ var WikiGraphLibraryManager = class {
   }
   async removeArchive(target) {
     return await this.#runtime.run(
-      async () => await (0, import_wiki_graph_core13.removeWikiGraphLibraryArchive)({
+      async () => await (0, import_wiki_graph_core14.removeWikiGraphLibraryArchive)({
         target: requireLibraryTarget(target)
       })
     );
   }
   async indexState(target) {
     return await this.#runtime.run(
-      async () => await (0, import_wiki_graph_core13.readWikiGraphLibraryIndexState)(requireLibraryTarget(target))
+      async () => await (0, import_wiki_graph_core14.readWikiGraphLibraryIndexState)(requireLibraryTarget(target))
     );
   }
   async rebuildIndex(target, onProgress) {
     return await this.#runtime.run(
-      async () => await (0, import_wiki_graph_core13.rebuildWikiGraphLibraryIndex)(
+      async () => await (0, import_wiki_graph_core14.rebuildWikiGraphLibraryIndex)(
         requireLibraryTarget(target),
         onProgress
       )
@@ -4385,17 +4450,17 @@ var WikiGraphLibraryManager = class {
   }
   async cleanIndex(target) {
     return await this.#runtime.run(
-      async () => await (0, import_wiki_graph_core13.cleanWikiGraphLibraryIndex)(requireLibraryTarget(target))
+      async () => await (0, import_wiki_graph_core14.cleanWikiGraphLibraryIndex)(requireLibraryTarget(target))
     );
   }
   async getMetadata(target) {
     return await this.#runtime.run(
-      async () => await (0, import_wiki_graph_core13.getWikiGraphLibraryMetadata)(requireLibraryTarget(target))
+      async () => await (0, import_wiki_graph_core14.getWikiGraphLibraryMetadata)(requireLibraryTarget(target))
     );
   }
   async replaceMetadata(target, value) {
     return await this.#runtime.run(
-      async () => await (0, import_wiki_graph_core13.replaceWikiGraphLibraryMetadata)(
+      async () => await (0, import_wiki_graph_core14.replaceWikiGraphLibraryMetadata)(
         requireLibraryTarget(target),
         value
       )
@@ -4403,7 +4468,7 @@ var WikiGraphLibraryManager = class {
   }
   async putMetadata(target, key, value) {
     return await this.#runtime.run(
-      async () => await (0, import_wiki_graph_core13.putWikiGraphLibraryMetadata)(
+      async () => await (0, import_wiki_graph_core14.putWikiGraphLibraryMetadata)(
         requireLibraryTarget(target),
         key,
         value
@@ -4412,7 +4477,7 @@ var WikiGraphLibraryManager = class {
   }
   async deleteMetadata(target, key) {
     return await this.#runtime.run(
-      async () => await (0, import_wiki_graph_core13.deleteWikiGraphLibraryMetadataKey)(
+      async () => await (0, import_wiki_graph_core14.deleteWikiGraphLibraryMetadataKey)(
         requireLibraryTarget(target),
         key
       )
@@ -4420,13 +4485,13 @@ var WikiGraphLibraryManager = class {
   }
   async clearMetadata(target) {
     return await this.#runtime.run(
-      async () => await (0, import_wiki_graph_core13.clearWikiGraphLibraryMetadata)(requireLibraryTarget(target))
+      async () => await (0, import_wiki_graph_core14.clearWikiGraphLibraryMetadata)(requireLibraryTarget(target))
     );
   }
   async search(target, query, options = {}) {
     return await this.#runtime.run(async () => {
       const embeddingProvider = await createConfiguredEmbeddingProvider();
-      return await (0, import_wiki_graph_core13.findWikiGraphLibraryObjects)(
+      return await (0, import_wiki_graph_core14.findWikiGraphLibraryObjects)(
         requireLibraryTarget(target),
         query,
         {
@@ -4439,7 +4504,7 @@ var WikiGraphLibraryManager = class {
   async searchArchiveMembers(target, query, options = {}) {
     return await this.#runtime.run(async () => {
       const embeddingProvider = await createConfiguredEmbeddingProvider();
-      return await (0, import_wiki_graph_core13.findWikiGraphLibraryArchiveMembers)(
+      return await (0, import_wiki_graph_core14.findWikiGraphLibraryArchiveMembers)(
         requireLibraryTarget(target),
         query,
         {
@@ -4451,7 +4516,7 @@ var WikiGraphLibraryManager = class {
   }
   async objects(target, options = {}) {
     return await this.#runtime.run(
-      async () => await (0, import_wiki_graph_core13.listWikiGraphLibraryObjects)(
+      async () => await (0, import_wiki_graph_core14.listWikiGraphLibraryObjects)(
         requireLibraryTarget(target),
         options
       )
@@ -4459,7 +4524,7 @@ var WikiGraphLibraryManager = class {
   }
   async archiveMembers(target, options = {}) {
     return await this.#runtime.run(
-      async () => await (0, import_wiki_graph_core13.listWikiGraphLibraryArchiveMembers)(
+      async () => await (0, import_wiki_graph_core14.listWikiGraphLibraryArchiveMembers)(
         requireLibraryTarget(target),
         options
       )
@@ -4469,7 +4534,7 @@ var WikiGraphLibraryManager = class {
     return await this.#runtime.run(
       async () => await withConfiguredWikimediaResolver(
         objectUri,
-        async (wikimediaOptions) => await (0, import_wiki_graph_core13.readWikiGraphLibraryPage)(
+        async (wikimediaOptions) => await (0, import_wiki_graph_core14.readWikiGraphLibraryPage)(
           requireLibraryTarget(target),
           objectUri,
           { ...options, ...wikimediaOptions }
@@ -4479,7 +4544,7 @@ var WikiGraphLibraryManager = class {
   }
   async related(target, objectUri, options = {}) {
     return await this.#runtime.run(
-      async () => await (0, import_wiki_graph_core13.listRelatedWikiGraphLibraryObjects)(
+      async () => await (0, import_wiki_graph_core14.listRelatedWikiGraphLibraryObjects)(
         requireLibraryTarget(target),
         objectUri,
         options
@@ -4488,7 +4553,7 @@ var WikiGraphLibraryManager = class {
   }
   async evidence(target, objectUri, options = {}) {
     return await this.#runtime.run(
-      async () => await (0, import_wiki_graph_core13.listWikiGraphLibraryEvidence)(
+      async () => await (0, import_wiki_graph_core14.listWikiGraphLibraryEvidence)(
         requireLibraryTarget(target),
         objectUri,
         options
@@ -4497,7 +4562,7 @@ var WikiGraphLibraryManager = class {
   }
   async pack(target, objectUri, budget = 5e3) {
     return await this.#runtime.run(
-      async () => await (0, import_wiki_graph_core13.packWikiGraphLibraryContext)(
+      async () => await (0, import_wiki_graph_core14.packWikiGraphLibraryContext)(
         requireLibraryTarget(target),
         objectUri,
         budget
@@ -4506,7 +4571,7 @@ var WikiGraphLibraryManager = class {
   }
   async list() {
     const records = await this.#runtime.run(
-      async () => await (0, import_wiki_graph_core13.listWikiGraphLibraries)()
+      async () => await (0, import_wiki_graph_core14.listWikiGraphLibraries)()
     );
     return records.map((record) => new WikiGraphLibrary(this.#runtime, record));
   }
@@ -4522,32 +4587,32 @@ var WikiGraphLibrary = class {
     return this.#record;
   }
   get uri() {
-    return (0, import_wiki_graph_core13.formatWikiGraphLibraryUri)(
+    return (0, import_wiki_graph_core14.formatWikiGraphLibraryUri)(
       this.#record.isDefault ? void 0 : this.#record.publicId
     );
   }
   async archives() {
     const target = requireLibraryTarget(this.uri);
     return await this.#runtime.run(
-      async () => await (0, import_wiki_graph_core13.listWikiGraphLibraryArchives)(target)
+      async () => await (0, import_wiki_graph_core14.listWikiGraphLibraryArchives)(target)
     );
   }
   async scan() {
     const target = requireLibraryTarget(this.uri);
     return await this.#runtime.run(
-      async () => await (0, import_wiki_graph_core13.scanWikiGraphLibrary)(target)
+      async () => await (0, import_wiki_graph_core14.scanWikiGraphLibrary)(target)
     );
   }
   async remove() {
     const target = requireLibraryTarget(this.uri);
     return await this.#runtime.run(
-      async () => await (0, import_wiki_graph_core13.removeWikiGraphLibrary)(target)
+      async () => await (0, import_wiki_graph_core14.removeWikiGraphLibrary)(target)
     );
   }
 };
 function requireLibraryTarget(value) {
   if (typeof value !== "string") return value;
-  const target = (0, import_wiki_graph_core13.parseWikiGraphLibraryUri)(value);
+  const target = (0, import_wiki_graph_core14.parseWikiGraphLibraryUri)(value);
   if (target === void 0) {
     throw new TypeError(`Invalid Wiki Graph library URI: ${value}`);
   }
@@ -4555,8 +4620,8 @@ function requireLibraryTarget(value) {
 }
 
 // src/maintenance.ts
-var import_wiki_graph_core14 = require("wiki-graph-core");
-var import_path4 = require("path");
+var import_wiki_graph_core15 = require("wiki-graph-core");
+var import_path5 = require("path");
 var WikiGraphMaintenanceManager = class {
   #runtime;
   constructor(runtime) {
@@ -4566,22 +4631,22 @@ var WikiGraphMaintenanceManager = class {
     return await this.#runtime.run(
       async () => {
         if (target.kind === "home") {
-          return await (0, import_wiki_graph_core14.upgradeWikiGraphMaintenanceTarget)({ kind: "home" });
+          return await (0, import_wiki_graph_core15.upgradeWikiGraphMaintenanceTarget)({ kind: "home" });
         }
         if (target.kind === "library") {
-          const parsed = (0, import_wiki_graph_core14.parseWikiGraphLibraryUri)(target.uri);
+          const parsed = (0, import_wiki_graph_core15.parseWikiGraphLibraryUri)(target.uri);
           if (parsed === void 0 || parsed.kind === "archive") {
             throw new Error(
               `Invalid Wiki Graph library upgrade target: ${target.uri}`
             );
           }
-          return await (0, import_wiki_graph_core14.upgradeWikiGraphMaintenanceTarget)({
+          return await (0, import_wiki_graph_core15.upgradeWikiGraphMaintenanceTarget)({
             kind: "library",
             target: parsed
           });
         }
         const path = resolveWikiGraphRuntimePath(target.path);
-        return await (0, import_wiki_graph_core14.upgradeWikiGraphMaintenanceTarget)({
+        return await (0, import_wiki_graph_core15.upgradeWikiGraphMaintenanceTarget)({
           file: new NodeFile(path),
           kind: "archive"
         });
@@ -4594,9 +4659,9 @@ var WikiGraphMaintenanceManager = class {
     return await this.#runtime.run(async () => {
       const resolvedInputPath = resolveWikiGraphRuntimePath(inputPath);
       const resolvedOutputPath = resolveWikiGraphRuntimePath(outputPath);
-      await (0, import_wiki_graph_core14.migrateLegacySdpubToWikg)(
+      await (0, import_wiki_graph_core15.migrateLegacySdpubToWikg)(
         new NodeFile(resolvedInputPath),
-        new NodeFile(resolvedOutputPath, (0, import_path4.basename)(resolvedOutputPath))
+        new NodeFile(resolvedOutputPath, (0, import_path5.basename)(resolvedOutputPath))
       );
       return {
         inputPath: resolvedInputPath,
@@ -4610,7 +4675,7 @@ function defaultWikgOutputPath(inputPath) {
 }
 
 // src/sdk.ts
-var import_wiki_graph_core15 = require("wiki-graph-core");
+var import_wiki_graph_core16 = require("wiki-graph-core");
 var WikiGraphSDK = class {
   #context;
   #homeReady;
@@ -4641,7 +4706,7 @@ var WikiGraphSDK = class {
     throwIfAborted(signal);
     const runWithContext = async () => await withWikiGraphSDKRuntimeContext(this.#context, async () => {
       if (options.skipHomeBootstrap !== true) {
-        this.#homeReady ??= (0, import_wiki_graph_core15.ensureWikiGraphHomeSchemaCurrent)().catch(
+        this.#homeReady ??= (0, import_wiki_graph_core16.ensureWikiGraphHomeSchemaCurrent)().catch(
           (error) => {
             this.#homeReady = void 0;
             throw error;
@@ -4671,7 +4736,7 @@ function createWikiGraphSDK(options = {}) {
 }
 
 // src/index.ts
-var import_wiki_graph_core16 = require("wiki-graph-core");
+var import_wiki_graph_core17 = require("wiki-graph-core");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DANGEROUS_RUNTIME_ENV_NAMES,