wiki-graph-core 0.3.1 → 0.4.1

package/dist/api/import.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/import.ts"],"sourcesContent":["import type { Document } from \"../document/index.js\";\nimport { createChapterKey } from \"../document/chapter/path.js\";\nimport type { DigestProgressTracker } from \"../runtime/progress/index.js\";\nimport { AsyncSemaphore } from \"../utils/async-semaphore.js\";\nimport {\n  SerialGeneration,\n  discoverSerial,\n  type GenerateSerialOptions,\n  type SerialGenerationOptions,\n  writeSerialSource,\n} from \"../serial.js\";\nimport {\n  TOC_FILE_VERSION,\n  type BookMeta,\n  type SourceAdapter,\n  type SourceAsset,\n  type SourceDocument,\n  type SourceSection,\n  type TocFile,\n  type TocItem,\n} from \"../text/source/index.js\";\nimport type { ChapterStage } from \"./chapter/index.js\";\n\nexport interface ImportSourceOptions\n  extends\n    GenerateSerialOptions,\n    Omit<SerialGenerationOptions, \"document\" | \"llm\"> {\n  readonly adapter: SourceAdapter;\n  readonly digestProgressTracker?: DigestProgressTracker;\n  readonly document: Document;\n  readonly llm?: SerialGenerationOptions[\"llm\"];\n  readonly path: string;\n  readonly targetStage?: ImportSourceStage;\n}\n\nexport interface ImportedSource {\n  readonly cover: SourceAsset | undefined;\n  readonly meta: BookMeta;\n  readonly serials: readonly ImportedSerial[];\n  readonly toc: TocFile;\n}\n\nexport interface ImportedSerial {\n  readonly id: number;\n}\n\nexport type ImportSourceStage = ChapterStage;\n\ninterface PlannedSection {\n  readonly section: SourceSection;\n  readonly serialId: number;\n}\n\ninterface SerialIdAllocator {\n  nextSerialId: number;\n}\n\nexport async function importSource(\n  options: ImportSourceOptions,\n): Promise<ImportedSource> {\n  return await options.adapter.openSession(\n    options.path,\n    async (sourceDocument) => {\n      return await importSourceDocument(sourceDocument, options);\n    },\n  );\n}\n\nexport async function importSourceDocument(\n  sourceDocument: SourceDocument,\n  options: Omit<ImportSourceOptions, \"adapter\" | \"path\">,\n): Promise<ImportedSource> {\n  await assertImportTargetIsEmpty(options.document);\n\n  const meta = await sourceDocument.readMeta();\n  const cover = await sourceDocument.readCover();\n  const sections = await sourceDocument.readSections();\n  const plannedSections: PlannedSection[] = [];\n  const serialIdAllocator = {\n    nextSerialId: await options.document.peekNextSerialId(),\n  } satisfies SerialIdAllocator;\n  const toc = {\n    version: TOC_FILE_VERSION,\n    items: [\n      ...planTocItems({\n        existingKeys: new Set<string>(),\n        fallbackTitle: meta.title,\n        plannedSections,\n        sections,\n        serialIdAllocator,\n      }),\n    ],\n  } satisfies TocFile;\n  const targetStage = options.targetStage ?? \"summarized\";\n  const generation =\n    targetStage === \"planned\" || targetStage === \"sourced\"\n      ? undefined\n      : new SerialGeneration({\n          document: options.document,\n          llm: requireImportLLM(options.llm, targetStage),\n          ...(options.logDirPath === undefined\n            ? {}\n            : { logDirPath: options.logDirPath }),\n          ...(options.segmenter === undefined\n            ? {}\n            : { segmenter: options.segmenter }),\n        });\n\n  if (\n    options.digestProgressTracker !== undefined &&\n    targetStage !== \"planned\"\n  ) {\n    const discoveries = await discoverPlannedSections(plannedSections, {\n      ...(options.segmenter === undefined\n        ? {}\n        : { segmenter: options.segmenter }),\n    });\n\n    await options.digestProgressTracker.discoverSerials(discoveries);\n  }\n\n  const serials = await generatePlannedSerials(plannedSections, {\n    document: options.document,\n    extractionPrompt: options.extractionPrompt,\n    ...(generation === undefined ? {} : { generation }),\n    serialConcurrency: resolveSerialGenerationConcurrency(options.llm),\n    targetStage,\n    ...(options.digestProgressTracker === undefined\n      ? {}\n      : { digestProgressTracker: options.digestProgressTracker }),\n    ...(options.userLanguage === undefined\n      ? {}\n      : { userLanguage: options.userLanguage }),\n  });\n\n  await options.document.openSession(async (document) => {\n    await document.writeBookMeta(meta);\n    await document.writeToc(toc);\n\n    if (cover !== undefined) {\n      await document.writeCover(cover);\n    }\n  });\n\n  return {\n    cover,\n    meta,\n    serials,\n    toc,\n  };\n}\n\nasync function generatePlannedSerials(\n  plannedSections: readonly PlannedSection[],\n  options: {\n    readonly digestProgressTracker?: DigestProgressTracker;\n    readonly document: Document;\n    readonly extractionPrompt: string;\n    readonly generation?: SerialGeneration;\n    readonly serialConcurrency: number;\n    readonly targetStage: ImportSourceStage;\n    readonly userLanguage?: GenerateSerialOptions[\"userLanguage\"];\n  },\n): Promise<ImportedSerial[]> {\n  if (options.targetStage === \"planned\") {\n    await options.document.openSession(async (document) => {\n      for (const plannedSection of plannedSections) {\n        await document.serials.createWithId(plannedSection.serialId);\n      }\n    });\n\n    return plannedSections.map((plannedSection) => ({\n      id: plannedSection.serialId,\n    }));\n  }\n\n  const limiter = new AsyncSemaphore(options.serialConcurrency);\n  const serials = await Promise.all(\n    plannedSections.map(async (plannedSection) => {\n      return await limiter.use(async () => {\n        const context = options.document.createContext();\n\n        context.ownSerial(plannedSection.serialId);\n\n        try {\n          const serialProgressTracker =\n            options.digestProgressTracker?.createSerialTracker({\n              id: plannedSection.serialId,\n            });\n          const serial = await context.run(async () => {\n            if (options.targetStage === \"sourced\") {\n              await options.document.serials.createWithId(\n                plannedSection.serialId,\n              );\n              await writeSerialSource(\n                options.document,\n                plannedSection.serialId,\n                await plannedSection.section.open(),\n              );\n\n              return {\n                id: plannedSection.serialId,\n              } satisfies ImportedSerial;\n            }\n\n            if (options.targetStage === \"graphed\") {\n              await options.document.serials.createWithId(\n                plannedSection.serialId,\n              );\n              await writeSerialSource(\n                options.document,\n                plannedSection.serialId,\n                await plannedSection.section.open(),\n              );\n              await requireSerialGeneration(\n                options.generation,\n                options.targetStage,\n              ).buildTopologyInto(\n                plannedSection.serialId,\n                {\n                  extractionPrompt: options.extractionPrompt,\n                  ...(options.userLanguage === undefined\n                    ? {}\n                    : { userLanguage: options.userLanguage }),\n                },\n                serialProgressTracker,\n              );\n\n              return {\n                id: plannedSection.serialId,\n              } satisfies ImportedSerial;\n            }\n\n            return await requireSerialGeneration(\n              options.generation,\n              options.targetStage,\n            ).generateInto(\n              plannedSection.serialId,\n              await plannedSection.section.open(),\n              {\n                extractionPrompt: options.extractionPrompt,\n                ...(options.userLanguage === undefined\n                  ? {}\n                  : { userLanguage: options.userLanguage }),\n              },\n              serialProgressTracker,\n            );\n          });\n\n          context.complete();\n          return serial;\n        } finally {\n          await context.dispose();\n        }\n      });\n    }),\n  );\n\n  return [...serials].sort((left, right) => left.id - right.id);\n}\n\nfunction planTocItems(input: {\n  readonly existingKeys: Set<string>;\n  readonly fallbackTitle: string | null | undefined;\n  readonly plannedSections: PlannedSection[];\n  readonly sections: readonly SourceSection[];\n  readonly serialIdAllocator: SerialIdAllocator;\n}): TocItem[] {\n  return input.sections.map((section, index) =>\n    planTocItem({\n      fallbackTitle:\n        input.sections.length === 1 ? input.fallbackTitle : undefined,\n      existingKeys: input.existingKeys,\n      indexPath: [index],\n      plannedSections: input.plannedSections,\n      section,\n      serialIdAllocator: input.serialIdAllocator,\n    }),\n  );\n}\n\nfunction planTocItem(input: {\n  readonly existingKeys: Set<string>;\n  readonly fallbackTitle: string | null | undefined;\n  readonly indexPath: readonly number[];\n  readonly plannedSections: PlannedSection[];\n  readonly section: SourceSection;\n  readonly serialIdAllocator: SerialIdAllocator;\n}): TocItem {\n  const serialId = input.section.hasContent\n    ? input.serialIdAllocator.nextSerialId++\n    : undefined;\n  const children = input.section.children.map((child, index) =>\n    planTocItem({\n      existingKeys: input.existingKeys,\n      fallbackTitle: undefined,\n      indexPath: [...input.indexPath, index],\n      plannedSections: input.plannedSections,\n      section: child,\n      serialIdAllocator: input.serialIdAllocator,\n    }),\n  );\n\n  if (serialId !== undefined) {\n    input.plannedSections.push({\n      section: input.section,\n      serialId,\n    });\n  }\n\n  const title =\n    normalizeTitle(input.section.title) ?? normalizeTitle(input.fallbackTitle);\n  const key = createChapterKey(input.existingKeys);\n  input.existingKeys.add(key);\n\n  return {\n    key,\n    ...(title === undefined ? {} : { title }),\n    ...(serialId === undefined ? {} : { serialId }),\n    children,\n  };\n}\n\nfunction normalizeTitle(title: string | null | undefined): string | undefined {\n  const normalized = title?.trim();\n\n  return normalized === undefined || normalized === \"\" ? undefined : normalized;\n}\n\nasync function assertImportTargetIsEmpty(document: Document): Promise<void> {\n  const [bookMeta, cover, toc, serialIds] = await Promise.all([\n    document.readBookMeta(),\n    document.readCover(),\n    document.readToc(),\n    document.serials.listIds(),\n  ]);\n\n  if (bookMeta !== undefined) {\n    throw new Error(\"Archive metadata already exists\");\n  }\n  if (cover !== undefined) {\n    throw new Error(\"Document cover already exists\");\n  }\n  if (toc !== undefined) {\n    throw new Error(\"Document TOC already exists\");\n  }\n  if (serialIds.length > 0) {\n    throw new Error(\"Document already contains serials\");\n  }\n}\n\nasync function discoverPlannedSections(\n  plannedSections: readonly PlannedSection[],\n  options: {\n    readonly segmenter?: NonNullable<ImportSourceOptions[\"segmenter\"]>;\n  },\n): Promise<\n  readonly {\n    readonly fragments?: number;\n    readonly id: number;\n    readonly title?: string | undefined;\n    readonly words: number;\n  }[]\n> {\n  if (\n    plannedSections.every(\n      (plannedSection) => plannedSection.section.wordsCount !== undefined,\n    )\n  ) {\n    return plannedSections.map((plannedSection) => ({\n      id: plannedSection.serialId,\n      title: plannedSection.section.title?.trim() || undefined,\n      words: plannedSection.section.wordsCount ?? 0,\n    }));\n  }\n\n  const discoveries = [];\n\n  for (const plannedSection of plannedSections) {\n    discoveries.push({\n      id: plannedSection.serialId,\n      title: plannedSection.section.title?.trim() || undefined,\n      ...(await discoverSerial({\n        ...(options.segmenter === undefined\n          ? {}\n          : { segmenter: options.segmenter }),\n        stream: await plannedSection.section.open(),\n      })),\n    });\n  }\n\n  return discoveries;\n}\n\nfunction resolveSerialGenerationConcurrency(\n  llm: Pick<ImportSourceOptions, \"llm\">[\"llm\"],\n): number {\n  if (\n    typeof llm !== \"object\" ||\n    llm === null ||\n    !(\"config\" in llm) ||\n    typeof llm.config !== \"object\" ||\n    llm.config === null ||\n    !(\"concurrent\" in llm.config) ||\n    typeof llm.config.concurrent !== \"number\" ||\n    !Number.isInteger(llm.config.concurrent) ||\n    llm.config.concurrent < 1\n  ) {\n    return 1;\n  }\n\n  return llm.config.concurrent;\n}\n\nfunction requireImportLLM(\n  llm: ImportSourceOptions[\"llm\"],\n  targetStage: ImportSourceStage,\n): NonNullable<ImportSourceOptions[\"llm\"]> {\n  if (llm === undefined) {\n    throw new Error(`LLM is required to import source to ${targetStage}.`);\n  }\n\n  return llm;\n}\n\nfunction requireSerialGeneration(\n  generation: SerialGeneration | undefined,\n  targetStage: ImportSourceStage,\n): SerialGeneration {\n  if (generation === undefined) {\n    throw new Error(\n      `Internal error: serial generation is required for ${targetStage}.`,\n    );\n  }\n\n  return generation;\n}\n"],"mappings":"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","names":[]}

package/dist/api/index.d.ts

@@ -0,0 +1,91 @@
+export { WikiGraph, WikiGraphLLMOptions, WikiGraphOpenSessionOptions, WikiGraphOptions, WikiGraphSourceSessionOptions, WikiGraphTextStreamSessionOptions } from './app.js';
+export { findArchiveObjects, grepArchiveObjects } from '../retrieval/query/archive-view/search/core.js';
+export { ArchiveBacklinkBucket, ArchiveBacklinks, ArchiveCollectionOptions, ArchiveCollectionResult, ArchiveCollectionType, ArchiveEvidence, ArchiveEvidenceItem, ArchiveFindEvidencePreview, ArchiveFindField, ArchiveFindFilterType, ArchiveFindHit, ArchiveFindObjectType, ArchiveFindOptions, ArchiveFindOrder, ArchiveFindPosition, ArchiveFindResult, ArchiveIndex, ArchiveLibrarySource, ArchiveListItem, ArchiveListKind, ArchiveNodeLabel, ArchiveNodeSourceFragment, ArchiveObjectType, ArchivePack, ArchivePage, ArchiveRelatedResult, ArchiveTriplePattern } from '../retrieval/query/archive-view/types.js';
+export { getChapterDetails, getChapterTree, listChapters } from '../document/chapter/query.js';
+export { CHAPTER_STAGES, ChapterDetails, ChapterEntry, ChapterStage, ChapterTree, ChapterTreeNode } from '../document/chapter/types.js';
+export { readArchivePage, readArchiveText } from '../retrieval/query/archive-view/pages.js';
+export { listAllArchiveLinks, listArchiveLinks, listRelatedArchiveObjects } from '../retrieval/query/archive-view/related/core.js';
+export { formatChapterId, formatEdgeId, formatNodeId, formatSummaryId } from '../retrieval/query/archive-view/references.js';
+export { GraphEdge, GraphEvidenceLine, GraphNeighbor, GraphNode, GraphPathStep, GraphSearchField, GraphSearchHit, GraphStatus, findGraphPath, getGraphEvidence, getGraphNode, getGraphStatus, listGraphNeighbors, listGraphNodes, searchGraphNodes } from '../graph/reading.js';
+export { rebuildArchiveSearchIndex } from '../retrieval/query/archive-view/index-state.js';
+export { getArchiveIndex, listArchiveCollection, listArchiveObjects } from '../retrieval/query/archive-view/collection.js';
+export { listArchiveEvidence } from '../retrieval/query/archive-view/evidence.js';
+export { packArchiveContext } from '../retrieval/query/archive-view/pack.js';
+export { createContinuationCursor, readContinuationCursor } from '../retrieval/query/continuation-cursor/core.js';
+export { ContinuationCursor, QueryIndexScope, QueryScope } from '../retrieval/query/continuation-cursor/types.js';
+export { deleteArchiveSearchSessions } from '../retrieval/query/search-cache/gc.js';
+export { AddBuildJobOptions, BuildJob, BuildJobConflictScope, BuildJobEvent, BuildJobExecutionContext, BuildJobListOptions, BuildJobProgressCounter, BuildJobProgressReporter, BuildJobState, BuildJobTarget, BuildJobWorkerOptions } from '../runtime/jobs/types.js';
+export { addBuildJob, assertBuildJobInputRevision, boostBuildJob, cancelBuildJob, getBuildJob, listBuildJobs, pauseBuildJob, recordBuildJobInputRevision, resolveBuildJobId, resumeBuildJob, updateBuildJobTarget } from '../runtime/jobs/jobs.js';
+export { assertNoActiveBuildJobConflicts, assertNoActiveBuildJobs } from '../runtime/jobs/conflicts.js';
+export { runBuildJobWorker } from '../runtime/jobs/worker.js';
+export { readBuildJobEvents } from '../runtime/jobs/events.js';
+export { cleanBuildJobs, runBuildQueueGc } from '../runtime/jobs/gc.js';
+export { buildChapterGraphArtifact, commitChapterGraphArtifact } from '../graph/reading-build/artifact.js';
+export { readChapterBuildInput } from '../graph/reading-build/input.js';
+export { BuildChapterGraphArtifactOptions, ChapterGraphBuildArtifact } from '../graph/reading-build/types.js';
+export { buildChapterSummaryArtifact, buildChapterSummaryArtifactFromReadingGraphObjects, buildChapterSummaryArtifactFromSnapshot, commitChapterSummaryArtifact, snapshotChapterSummaryInput } from '../text/summary-build/artifact.js';
+export { BuildChapterSummaryArtifactOptions } from '../text/summary-build/types.js';
+export { buildChapterKnowledgeGraphArtifact } from '../graph/knowledge-build/artifact.js';
+export { clearChapterKnowledgeGraph, commitChapterKnowledgeGraphArtifact } from '../graph/knowledge-build/commit.js';
+export { generateChapterKnowledgeGraphArtifact, generateChapterKnowledgeGraphArtifactFromSnapshot } from '../graph/knowledge-build/generate.js';
+export { groundWikimatchCandidates } from '../graph/knowledge-build/grounding-runner.js';
+export { createEnrichmentProgressReporter } from '../graph/knowledge-build/progress.js';
+export { snapshotChapterKnowledgeGraphInput } from '../graph/knowledge-build/snapshot.js';
+export { BuildChapterKnowledgeGraphArtifactOptions, ChapterKnowledgeGraphBuildArtifact, ChapterKnowledgeGraphInputSnapshot } from '../graph/knowledge-build/types.js';
+export { DEFAULT_EXTRACTION_PROMPT, DEFAULT_KNOWLEDGE_GRAPH_RECALL_PROMPT, resolveExtractionPrompt, resolveKnowledgeGraphRecallPrompt } from '../runtime/common/prompts.js';
+export { advanceChapterStages } from './chapter/advance.js';
+export { generateChapterGraph, generateChapterSummary } from './chapter/generate.js';
+export { addChapter, applyChapterTree, moveChapter, removeChapter, resetChapter, resolveChapterPath, resolveChapterPathReadonly, setChapterSource, setChapterSummary, setChapterTitle } from './chapter/manage.js';
+export { GenerateChapterGraphOptions, GenerateChapterSummaryOptions } from './chapter/options.js';
+export { parseChapterTreeInput } from './chapter/parse.js';
+export { AddChapterOptions, AdvanceChapterStagesOptions, AdvanceChapterStagesProgressCallback, AdvanceChapterStagesProgressEvent, AdvanceChapterStagesResult, ChapterTreeApplyResult, ChapterTreeInput, ChapterTreeInputNode, ChapterTreeMoveChange, ChapterTreeTitleChange, MoveChapterOptions } from './chapter/types.js';
+export { WikiGraphArchive } from './wiki-graph-archive.js';
+export { WikiGraphSerialEntry } from './types.js';
+export { DigestProgressEvent, SerialDiscoveryItem, SerialProgressEvent, SerialsDiscoveredEvent, WikiGraphOperation, WikiGraphProgressCallback, WikiGraphProgressEvent, WikiGraphProgressEventType } from '../runtime/progress/types.js';
+import 'ai';
+import '../runtime/common/language.js';
+import './digest.js';
+import '../text/source/meta.js';
+import 'zod';
+import '../runtime/common/llm-scope.js';
+import '../text/reader/types.js';
+import '../text/reader/attention/core.js';
+import '../text/reader/chunk-batch/types.js';
+import '../external/llm/client/core.js';
+import '../external/llm/context.js';
+import '../external/llm/cache.js';
+import '../external/llm/types.js';
+import '../document/types.js';
+import '../text/reader/segment/types.js';
+import '../document/directory/types.js';
+import '../text/source/toc.js';
+import '../text/source/types.js';
+import '../document/database.js';
+import 'sqlite3';
+import '../document/text-streams/serial.js';
+import '../document/text-streams/draft.js';
+import '../document/text-streams/types.js';
+import '../document/stores/chunk.js';
+import '../document/stores/types.js';
+import '../document/stores/fragment-group.js';
+import '../document/stores/graph-build-parameter.js';
+import '../document/stores/mention-link.js';
+import '../document/stores/mention.js';
+import '../document/stores/object-metadata.js';
+import '../document/stores/reading-edge.js';
+import '../document/stores/serial.js';
+import '../document/stores/snake/chunk.js';
+import '../document/stores/snake/core.js';
+import '../document/stores/snake/edge.js';
+import '../external/wikipage/types.js';
+import '../external/wikipage/wikimedia-client/wiki.js';
+import '../external/wikipage/fetch-log.js';
+import '../retrieval/query/archive-view/related/wikipage.js';
+import '../retrieval/search-index/search/build.js';
+import '../retrieval/search-index/search/types.js';
+import '../retrieval/query/archive-view/evidence-hydration.js';
+import '../runtime/gc/types.js';
+import '../text/serial/options.js';
+import '../external/guaranteed/types.js';
+import '../external/wikimatch/types.js';
+import '../external/wikimatch/wikispine.js';

package/dist/api/index.js

@@ -0,0 +1,189 @@
+import {
+  WikiGraph
+} from "./app.js";
+import {
+  findArchiveObjects,
+  formatChapterId,
+  formatEdgeId,
+  formatNodeId,
+  formatSummaryId,
+  getArchiveIndex,
+  grepArchiveObjects,
+  listArchiveCollection,
+  listArchiveEvidence,
+  listAllArchiveLinks,
+  listArchiveLinks,
+  listArchiveObjects,
+  listRelatedArchiveObjects,
+  packArchiveContext,
+  readArchivePage,
+  readArchiveText,
+  rebuildArchiveSearchIndex
+} from "../retrieval/query/index.js";
+import {
+  addBuildJob,
+  assertBuildJobInputRevision,
+  assertNoActiveBuildJobConflicts,
+  assertNoActiveBuildJobs,
+  boostBuildJob,
+  cancelBuildJob,
+  cleanBuildJobs,
+  getBuildJob,
+  listBuildJobs,
+  pauseBuildJob,
+  readBuildJobEvents,
+  recordBuildJobInputRevision,
+  resumeBuildJob,
+  resolveBuildJobId,
+  runBuildQueueGc,
+  runBuildJobWorker,
+  updateBuildJobTarget
+} from "../runtime/jobs/index.js";
+import {
+  buildChapterGraphArtifact,
+  buildChapterSummaryArtifact,
+  buildChapterSummaryArtifactFromReadingGraphObjects,
+  buildChapterSummaryArtifactFromSnapshot,
+  commitChapterGraphArtifact,
+  commitChapterSummaryArtifact,
+  readChapterBuildInput,
+  snapshotChapterSummaryInput
+} from "./chapter-build/index.js";
+import {
+  buildChapterKnowledgeGraphArtifact,
+  clearChapterKnowledgeGraph,
+  commitChapterKnowledgeGraphArtifact,
+  createEnrichmentProgressReporter,
+  generateChapterKnowledgeGraphArtifact,
+  generateChapterKnowledgeGraphArtifactFromSnapshot,
+  groundWikimatchCandidates,
+  snapshotChapterKnowledgeGraphInput
+} from "./knowledge-graph-build/index.js";
+import {
+  createContinuationCursor,
+  deleteArchiveSearchSessions,
+  readContinuationCursor
+} from "../retrieval/query/index.js";
+import {
+  DEFAULT_EXTRACTION_PROMPT,
+  DEFAULT_KNOWLEDGE_GRAPH_RECALL_PROMPT,
+  resolveExtractionPrompt,
+  resolveKnowledgeGraphRecallPrompt
+} from "./prompts.js";
+import {
+  addChapter,
+  advanceChapterStages,
+  applyChapterTree,
+  CHAPTER_STAGES,
+  generateChapterGraph,
+  generateChapterSummary,
+  getChapterDetails,
+  getChapterTree,
+  listChapters,
+  moveChapter,
+  parseChapterTreeInput,
+  removeChapter,
+  resetChapter,
+  resolveChapterPath,
+  resolveChapterPathReadonly,
+  setChapterSource,
+  setChapterSummary,
+  setChapterTitle
+} from "./chapter/index.js";
+import {
+  findGraphPath,
+  getGraphEvidence,
+  getGraphNode,
+  getGraphStatus,
+  listGraphNeighbors,
+  listGraphNodes,
+  searchGraphNodes
+} from "./graph.js";
+import { WikiGraphArchive } from "./wiki-graph-archive.js";
+export {
+  CHAPTER_STAGES,
+  DEFAULT_EXTRACTION_PROMPT,
+  DEFAULT_KNOWLEDGE_GRAPH_RECALL_PROMPT,
+  WikiGraph,
+  WikiGraphArchive,
+  addBuildJob,
+  addChapter,
+  advanceChapterStages,
+  applyChapterTree,
+  assertBuildJobInputRevision,
+  assertNoActiveBuildJobConflicts,
+  assertNoActiveBuildJobs,
+  boostBuildJob,
+  buildChapterGraphArtifact,
+  buildChapterKnowledgeGraphArtifact,
+  buildChapterSummaryArtifact,
+  buildChapterSummaryArtifactFromReadingGraphObjects,
+  buildChapterSummaryArtifactFromSnapshot,
+  cancelBuildJob,
+  cleanBuildJobs,
+  clearChapterKnowledgeGraph,
+  commitChapterGraphArtifact,
+  commitChapterKnowledgeGraphArtifact,
+  commitChapterSummaryArtifact,
+  createContinuationCursor,
+  createEnrichmentProgressReporter,
+  deleteArchiveSearchSessions,
+  findArchiveObjects,
+  findGraphPath,
+  formatChapterId,
+  formatEdgeId,
+  formatNodeId,
+  formatSummaryId,
+  generateChapterGraph,
+  generateChapterKnowledgeGraphArtifact,
+  generateChapterKnowledgeGraphArtifactFromSnapshot,
+  generateChapterSummary,
+  getArchiveIndex,
+  getBuildJob,
+  getChapterDetails,
+  getChapterTree,
+  getGraphEvidence,
+  getGraphNode,
+  getGraphStatus,
+  grepArchiveObjects,
+  groundWikimatchCandidates,
+  listAllArchiveLinks,
+  listArchiveCollection,
+  listArchiveEvidence,
+  listArchiveLinks,
+  listArchiveObjects,
+  listBuildJobs,
+  listChapters,
+  listGraphNeighbors,
+  listGraphNodes,
+  listRelatedArchiveObjects,
+  moveChapter,
+  packArchiveContext,
+  parseChapterTreeInput,
+  pauseBuildJob,
+  readArchivePage,
+  readArchiveText,
+  readBuildJobEvents,
+  readChapterBuildInput,
+  readContinuationCursor,
+  rebuildArchiveSearchIndex,
+  recordBuildJobInputRevision,
+  removeChapter,
+  resetChapter,
+  resolveBuildJobId,
+  resolveChapterPath,
+  resolveChapterPathReadonly,
+  resolveExtractionPrompt,
+  resolveKnowledgeGraphRecallPrompt,
+  resumeBuildJob,
+  runBuildJobWorker,
+  runBuildQueueGc,
+  searchGraphNodes,
+  setChapterSource,
+  setChapterSummary,
+  setChapterTitle,
+  snapshotChapterKnowledgeGraphInput,
+  snapshotChapterSummaryInput,
+  updateBuildJobTarget
+};
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/index.ts"],"sourcesContent":["export {\n  WikiGraph,\n  type DigestProgressEvent,\n  type SerialDiscoveryItem,\n  type WikiGraphOptions,\n  type WikiGraphLLMOptions,\n  type WikiGraphOpenSessionOptions,\n  type WikiGraphProgressCallback,\n  type WikiGraphProgressEvent,\n  type WikiGraphProgressEventType,\n  type WikiGraphOperation,\n  type SerialsDiscoveredEvent,\n  type SerialProgressEvent,\n  type WikiGraphSourceSessionOptions,\n  type WikiGraphTextStreamSessionOptions,\n} from \"./app.js\";\nexport {\n  findArchiveObjects,\n  formatChapterId,\n  formatEdgeId,\n  formatNodeId,\n  formatSummaryId,\n  getArchiveIndex,\n  grepArchiveObjects,\n  listArchiveCollection,\n  listArchiveEvidence,\n  listAllArchiveLinks,\n  listArchiveLinks,\n  listArchiveObjects,\n  listRelatedArchiveObjects,\n  packArchiveContext,\n  readArchivePage,\n  readArchiveText,\n  rebuildArchiveSearchIndex,\n} from \"../retrieval/query/index.js\";\nexport {\n  addBuildJob,\n  assertBuildJobInputRevision,\n  assertNoActiveBuildJobConflicts,\n  assertNoActiveBuildJobs,\n  boostBuildJob,\n  cancelBuildJob,\n  cleanBuildJobs,\n  getBuildJob,\n  listBuildJobs,\n  pauseBuildJob,\n  readBuildJobEvents,\n  recordBuildJobInputRevision,\n  resumeBuildJob,\n  resolveBuildJobId,\n  runBuildQueueGc,\n  runBuildJobWorker,\n  updateBuildJobTarget,\n} from \"../runtime/jobs/index.js\";\nexport type {\n  AddBuildJobOptions,\n  BuildJobConflictScope,\n  BuildJobExecutionContext,\n  BuildJob,\n  BuildJobEvent,\n  BuildJobListOptions,\n  BuildJobProgressCounter,\n  BuildJobProgressReporter,\n  BuildJobState,\n  BuildJobTarget,\n  BuildJobWorkerOptions,\n} from \"../runtime/jobs/index.js\";\nexport {\n  buildChapterGraphArtifact,\n  buildChapterSummaryArtifact,\n  buildChapterSummaryArtifactFromReadingGraphObjects,\n  buildChapterSummaryArtifactFromSnapshot,\n  commitChapterGraphArtifact,\n  commitChapterSummaryArtifact,\n  readChapterBuildInput,\n  snapshotChapterSummaryInput,\n} from \"./chapter-build/index.js\";\nexport {\n  buildChapterKnowledgeGraphArtifact,\n  clearChapterKnowledgeGraph,\n  commitChapterKnowledgeGraphArtifact,\n  createEnrichmentProgressReporter,\n  generateChapterKnowledgeGraphArtifact,\n  generateChapterKnowledgeGraphArtifactFromSnapshot,\n  groundWikimatchCandidates,\n  snapshotChapterKnowledgeGraphInput,\n} from \"./knowledge-graph-build/index.js\";\nexport {\n  createContinuationCursor,\n  deleteArchiveSearchSessions,\n  readContinuationCursor,\n} from \"../retrieval/query/index.js\";\nexport {\n  DEFAULT_EXTRACTION_PROMPT,\n  DEFAULT_KNOWLEDGE_GRAPH_RECALL_PROMPT,\n  resolveExtractionPrompt,\n  resolveKnowledgeGraphRecallPrompt,\n} from \"./prompts.js\";\nexport type {\n  ContinuationCursor,\n  QueryIndexScope,\n  QueryScope,\n} from \"../retrieval/query/index.js\";\nexport type {\n  BuildChapterGraphArtifactOptions,\n  BuildChapterSummaryArtifactOptions,\n  ChapterGraphBuildArtifact,\n} from \"./chapter-build/index.js\";\nexport type {\n  BuildChapterKnowledgeGraphArtifactOptions,\n  ChapterKnowledgeGraphBuildArtifact,\n  ChapterKnowledgeGraphInputSnapshot,\n} from \"./knowledge-graph-build/index.js\";\nexport {\n  addChapter,\n  advanceChapterStages,\n  applyChapterTree,\n  CHAPTER_STAGES,\n  generateChapterGraph,\n  generateChapterSummary,\n  getChapterDetails,\n  getChapterTree,\n  listChapters,\n  moveChapter,\n  parseChapterTreeInput,\n  removeChapter,\n  resetChapter,\n  resolveChapterPath,\n  resolveChapterPathReadonly,\n  setChapterSource,\n  setChapterSummary,\n  setChapterTitle,\n} from \"./chapter/index.js\";\nexport {\n  findGraphPath,\n  getGraphEvidence,\n  getGraphNode,\n  getGraphStatus,\n  listGraphNeighbors,\n  listGraphNodes,\n  searchGraphNodes,\n} from \"./graph.js\";\nexport type {\n  ArchiveBacklinkBucket,\n  ArchiveBacklinks,\n  ArchiveEvidence,\n  ArchiveEvidenceItem,\n  ArchiveFindEvidencePreview,\n  ArchiveCollectionOptions,\n  ArchiveCollectionResult,\n  ArchiveCollectionType,\n  ArchiveFindField,\n  ArchiveFindFilterType,\n  ArchiveFindHit,\n  ArchiveIndex,\n  ArchiveListItem,\n  ArchiveListKind,\n  ArchiveNodeLabel,\n  ArchiveNodeSourceFragment,\n  ArchiveFindObjectType,\n  ArchiveFindOptions,\n  ArchiveFindOrder,\n  ArchiveFindPosition,\n  ArchiveFindResult,\n  ArchiveObjectType,\n  ArchiveLibrarySource,\n  ArchivePack,\n  ArchivePage,\n  ArchiveRelatedResult,\n  ArchiveTriplePattern,\n} from \"../retrieval/query/index.js\";\nexport type {\n  AddChapterOptions,\n  AdvanceChapterStagesOptions,\n  AdvanceChapterStagesProgressCallback,\n  AdvanceChapterStagesProgressEvent,\n  AdvanceChapterStagesResult,\n  ChapterDetails,\n  ChapterEntry,\n  ChapterStage,\n  ChapterTree,\n  ChapterTreeApplyResult,\n  ChapterTreeInput,\n  ChapterTreeInputNode,\n  ChapterTreeMoveChange,\n  ChapterTreeNode,\n  ChapterTreeTitleChange,\n  GenerateChapterGraphOptions,\n  GenerateChapterSummaryOptions,\n  MoveChapterOptions,\n} from \"./chapter/index.js\";\nexport type {\n  GraphEdge,\n  GraphEvidenceLine,\n  GraphNeighbor,\n  GraphNode,\n  GraphPathStep,\n  GraphSearchField,\n  GraphSearchHit,\n  GraphStatus,\n} from \"./graph.js\";\nexport { WikiGraphArchive } from \"./wiki-graph-archive.js\";\nexport type { WikiGraphSerialEntry } from \"./types.js\";\n"],"mappings":"AAAA;AAAA,EACE;AAAA,OAcK;AACP;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,OACK;AACP;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,OACK;AAcP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAgBP;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,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AA4DP,SAAS,wBAAwB;","names":[]}

package/dist/api/knowledge-graph-build/index.d.ts

@@ -0,0 +1,40 @@
+export { buildChapterKnowledgeGraphArtifact } from '../../graph/knowledge-build/artifact.js';
+export { clearChapterKnowledgeGraph, commitChapterKnowledgeGraphArtifact } from '../../graph/knowledge-build/commit.js';
+export { generateChapterKnowledgeGraphArtifact, generateChapterKnowledgeGraphArtifactFromSnapshot } from '../../graph/knowledge-build/generate.js';
+export { groundWikimatchCandidates } from '../../graph/knowledge-build/grounding-runner.js';
+export { createEnrichmentProgressReporter } from '../../graph/knowledge-build/progress.js';
+export { snapshotChapterKnowledgeGraphInput } from '../../graph/knowledge-build/snapshot.js';
+export { BuildChapterKnowledgeGraphArtifactOptions, ChapterKnowledgeGraphBuildArtifact, ChapterKnowledgeGraphInputSnapshot, GenerateChapterKnowledgeGraphArtifactOptions, GraphBuildParameterInput, KnowledgeGraphProgressTracker } from '../../graph/knowledge-build/types.js';
+import '../../document/types.js';
+import '../../external/guaranteed/types.js';
+import '../../external/llm/types.js';
+import 'ai';
+import 'zod';
+import '../../external/wikipage/types.js';
+import '../../external/wikipage/wikimedia-client/wiki.js';
+import '../../external/wikipage/fetch-log.js';
+import '../../external/wikimatch/wikispine.js';
+import '../../external/wikimatch/types.js';
+import '../../runtime/jobs/types.js';
+import '../../document/chapter/types.js';
+import '../../document/directory/types.js';
+import '../../text/source/meta.js';
+import '../../text/source/toc.js';
+import '../../text/source/types.js';
+import '../../document/database.js';
+import 'sqlite3';
+import '../../document/text-streams/serial.js';
+import '../../document/text-streams/draft.js';
+import '../../document/text-streams/types.js';
+import '../../document/stores/chunk.js';
+import '../../document/stores/types.js';
+import '../../document/stores/fragment-group.js';
+import '../../document/stores/graph-build-parameter.js';
+import '../../document/stores/mention-link.js';
+import '../../document/stores/mention.js';
+import '../../document/stores/object-metadata.js';
+import '../../document/stores/reading-edge.js';
+import '../../document/stores/serial.js';
+import '../../document/stores/snake/chunk.js';
+import '../../document/stores/snake/core.js';
+import '../../document/stores/snake/edge.js';

package/dist/api/knowledge-graph-build/index.js

@@ -0,0 +1,2 @@
+export * from "../../graph/knowledge-build/index.js";
+//# sourceMappingURL=index.js.map

package/dist/api/knowledge-graph-build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/api/knowledge-graph-build/index.ts"],"sourcesContent":["export * from \"../../graph/knowledge-build/index.js\";\n"],"mappings":"AAAA,cAAc;","names":[]}

package/dist/api/knowledge-graph-build/types.d.ts

@@ -0,0 +1,13 @@
+export { BuildChapterKnowledgeGraphArtifactOptions, ChapterKnowledgeGraphBuildArtifact, ChapterKnowledgeGraphInputSnapshot, GenerateChapterKnowledgeGraphArtifactOptions, GraphBuildParameterInput, KnowledgeGraphProgressTracker } from '../../graph/knowledge-build/types.js';
+import '../../document/types.js';
+import '../../external/guaranteed/types.js';
+import '../../external/llm/types.js';
+import 'ai';
+import 'zod';
+import '../../external/wikipage/types.js';
+import '../../external/wikipage/wikimedia-client/wiki.js';
+import '../../external/wikipage/fetch-log.js';
+import '../../external/wikimatch/wikispine.js';
+import '../../external/wikimatch/types.js';
+import '../../runtime/jobs/types.js';
+import '../../document/chapter/types.js';

package/dist/api/llm-sampling.d.ts

@@ -0,0 +1,11 @@
+import { WikiGraphScope } from '../runtime/common/llm-scope.js';
+import { TemperatureSetting, SamplingScopeConfig } from '../external/llm/types.js';
+import 'ai';
+
+type WikiGraphSamplingConfig = SamplingScopeConfig<WikiGraphScope>;
+declare function createDefaultWikiGraphSampling(input?: {
+    readonly temperature?: TemperatureSetting;
+    readonly topP?: TemperatureSetting;
+}): WikiGraphSamplingConfig;
+
+export { type WikiGraphSamplingConfig, createDefaultWikiGraphSampling };

package/dist/api/llm-sampling.js

@@ -0,0 +1,58 @@
+import { WikiGraphScope } from "../runtime/common/llm-scope.js";
+const DEFAULT_WIKI_GRAPH_SAMPLING = Object.freeze({
+  [WikiGraphScope.EditorCompress]: Object.freeze({
+    temperature: 0.7,
+    topP: 0.9
+  }),
+  [WikiGraphScope.EditorReview]: Object.freeze({
+    temperature: [0.3, 0.95],
+    topP: [0.4, 0.8]
+  }),
+  [WikiGraphScope.EditorReviewGuide]: Object.freeze({
+    temperature: 0.4,
+    topP: 0.6
+  }),
+  [WikiGraphScope.ReaderChoice]: Object.freeze({
+    temperature: [0.3, 0.95],
+    topP: [0.4, 0.8]
+  }),
+  [WikiGraphScope.ReaderExtraction]: Object.freeze({
+    temperature: [0.3, 0.95],
+    topP: [0.4, 0.8]
+  })
+});
+function createDefaultWikiGraphSampling(input = {}) {
+  return Object.freeze({
+    [WikiGraphScope.EditorCompress]: applySamplingOverrides(
+      DEFAULT_WIKI_GRAPH_SAMPLING[WikiGraphScope.EditorCompress],
+      input
+    ),
+    [WikiGraphScope.EditorReview]: applySamplingOverrides(
+      DEFAULT_WIKI_GRAPH_SAMPLING[WikiGraphScope.EditorReview],
+      input
+    ),
+    [WikiGraphScope.EditorReviewGuide]: applySamplingOverrides(
+      DEFAULT_WIKI_GRAPH_SAMPLING[WikiGraphScope.EditorReviewGuide],
+      input
+    ),
+    [WikiGraphScope.ReaderChoice]: applySamplingOverrides(
+      DEFAULT_WIKI_GRAPH_SAMPLING[WikiGraphScope.ReaderChoice],
+      input
+    ),
+    [WikiGraphScope.ReaderExtraction]: applySamplingOverrides(
+      DEFAULT_WIKI_GRAPH_SAMPLING[WikiGraphScope.ReaderExtraction],
+      input
+    )
+  });
+}
+function applySamplingOverrides(profile, input) {
+  return Object.freeze({
+    ...profile,
+    ...input.temperature === void 0 ? {} : { temperature: input.temperature },
+    ...input.topP === void 0 ? {} : { topP: input.topP }
+  });
+}
+export {
+  createDefaultWikiGraphSampling
+};
+//# sourceMappingURL=llm-sampling.js.map

package/dist/api/llm-sampling.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/llm-sampling.ts"],"sourcesContent":["import { WikiGraphScope } from \"../runtime/common/llm-scope.js\";\nimport type {\n  SamplingProfile,\n  SamplingScopeConfig,\n  TemperatureSetting,\n} from \"../external/llm/index.js\";\n\nexport type WikiGraphSamplingConfig = SamplingScopeConfig<WikiGraphScope>;\n\nconst DEFAULT_WIKI_GRAPH_SAMPLING = Object.freeze({\n  [WikiGraphScope.EditorCompress]: Object.freeze({\n    temperature: 0.7,\n    topP: 0.9,\n  }),\n  [WikiGraphScope.EditorReview]: Object.freeze({\n    temperature: [0.3, 0.95] as const,\n    topP: [0.4, 0.8] as const,\n  }),\n  [WikiGraphScope.EditorReviewGuide]: Object.freeze({\n    temperature: 0.4,\n    topP: 0.6,\n  }),\n  [WikiGraphScope.ReaderChoice]: Object.freeze({\n    temperature: [0.3, 0.95] as const,\n    topP: [0.4, 0.8] as const,\n  }),\n  [WikiGraphScope.ReaderExtraction]: Object.freeze({\n    temperature: [0.3, 0.95] as const,\n    topP: [0.4, 0.8] as const,\n  }),\n} satisfies WikiGraphSamplingConfig);\n\nexport function createDefaultWikiGraphSampling(\n  input: {\n    readonly temperature?: TemperatureSetting;\n    readonly topP?: TemperatureSetting;\n  } = {},\n): WikiGraphSamplingConfig {\n  return Object.freeze({\n    [WikiGraphScope.EditorCompress]: applySamplingOverrides(\n      DEFAULT_WIKI_GRAPH_SAMPLING[WikiGraphScope.EditorCompress],\n      input,\n    ),\n    [WikiGraphScope.EditorReview]: applySamplingOverrides(\n      DEFAULT_WIKI_GRAPH_SAMPLING[WikiGraphScope.EditorReview],\n      input,\n    ),\n    [WikiGraphScope.EditorReviewGuide]: applySamplingOverrides(\n      DEFAULT_WIKI_GRAPH_SAMPLING[WikiGraphScope.EditorReviewGuide],\n      input,\n    ),\n    [WikiGraphScope.ReaderChoice]: applySamplingOverrides(\n      DEFAULT_WIKI_GRAPH_SAMPLING[WikiGraphScope.ReaderChoice],\n      input,\n    ),\n    [WikiGraphScope.ReaderExtraction]: applySamplingOverrides(\n      DEFAULT_WIKI_GRAPH_SAMPLING[WikiGraphScope.ReaderExtraction],\n      input,\n    ),\n  } satisfies WikiGraphSamplingConfig);\n}\n\nfunction applySamplingOverrides(\n  profile: SamplingProfile,\n  input: {\n    readonly temperature?: TemperatureSetting;\n    readonly topP?: TemperatureSetting;\n  },\n): SamplingProfile {\n  return Object.freeze({\n    ...profile,\n    ...(input.temperature === undefined\n      ? {}\n      : { temperature: input.temperature }),\n    ...(input.topP === undefined ? {} : { topP: input.topP }),\n  });\n}\n"],"mappings":"AAAA,SAAS,sBAAsB;AAS/B,MAAM,8BAA8B,OAAO,OAAO;AAAA,EAChD,CAAC,eAAe,cAAc,GAAG,OAAO,OAAO;AAAA,IAC7C,aAAa;AAAA,IACb,MAAM;AAAA,EACR,CAAC;AAAA,EACD,CAAC,eAAe,YAAY,GAAG,OAAO,OAAO;AAAA,IAC3C,aAAa,CAAC,KAAK,IAAI;AAAA,IACvB,MAAM,CAAC,KAAK,GAAG;AAAA,EACjB,CAAC;AAAA,EACD,CAAC,eAAe,iBAAiB,GAAG,OAAO,OAAO;AAAA,IAChD,aAAa;AAAA,IACb,MAAM;AAAA,EACR,CAAC;AAAA,EACD,CAAC,eAAe,YAAY,GAAG,OAAO,OAAO;AAAA,IAC3C,aAAa,CAAC,KAAK,IAAI;AAAA,IACvB,MAAM,CAAC,KAAK,GAAG;AAAA,EACjB,CAAC;AAAA,EACD,CAAC,eAAe,gBAAgB,GAAG,OAAO,OAAO;AAAA,IAC/C,aAAa,CAAC,KAAK,IAAI;AAAA,IACvB,MAAM,CAAC,KAAK,GAAG;AAAA,EACjB,CAAC;AACH,CAAmC;AAE5B,SAAS,+BACd,QAGI,CAAC,GACoB;AACzB,SAAO,OAAO,OAAO;AAAA,IACnB,CAAC,eAAe,cAAc,GAAG;AAAA,MAC/B,4BAA4B,eAAe,cAAc;AAAA,MACzD;AAAA,IACF;AAAA,IACA,CAAC,eAAe,YAAY,GAAG;AAAA,MAC7B,4BAA4B,eAAe,YAAY;AAAA,MACvD;AAAA,IACF;AAAA,IACA,CAAC,eAAe,iBAAiB,GAAG;AAAA,MAClC,4BAA4B,eAAe,iBAAiB;AAAA,MAC5D;AAAA,IACF;AAAA,IACA,CAAC,eAAe,YAAY,GAAG;AAAA,MAC7B,4BAA4B,eAAe,YAAY;AAAA,MACvD;AAAA,IACF;AAAA,IACA,CAAC,eAAe,gBAAgB,GAAG;AAAA,MACjC,4BAA4B,eAAe,gBAAgB;AAAA,MAC3D;AAAA,IACF;AAAA,EACF,CAAmC;AACrC;AAEA,SAAS,uBACP,SACA,OAIiB;AACjB,SAAO,OAAO,OAAO;AAAA,IACnB,GAAG;AAAA,IACH,GAAI,MAAM,gBAAgB,SACtB,CAAC,IACD,EAAE,aAAa,MAAM,YAAY;AAAA,IACrC,GAAI,MAAM,SAAS,SAAY,CAAC,IAAI,EAAE,MAAM,MAAM,KAAK;AAAA,EACzD,CAAC;AACH;","names":[]}

package/dist/api/prompts.d.ts

@@ -0,0 +1 @@
+export { DEFAULT_EXTRACTION_PROMPT, DEFAULT_KNOWLEDGE_GRAPH_RECALL_PROMPT, resolveExtractionPrompt, resolveKnowledgeGraphRecallPrompt } from '../runtime/common/prompts.js';

package/dist/api/prompts.js

@@ -0,0 +1,2 @@
+export * from "../runtime/common/prompts.js";
+//# sourceMappingURL=prompts.js.map

package/dist/api/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/prompts.ts"],"sourcesContent":["export * from \"../runtime/common/prompts.js\";\n"],"mappings":"AAAA,cAAc;","names":[]}

package/dist/api/wiki-graph-archive.d.ts

@@ -0,0 +1,42 @@
+import { BookMeta } from '../text/source/meta.js';
+import { TocFile } from '../text/source/toc.js';
+import { SourceAsset } from '../text/source/types.js';
+import { ReadonlyDocument } from '../document/directory/types.js';
+import { ChapterStage } from '../document/chapter/types.js';
+import { WikiGraphSerialEntry } from './types.js';
+import 'zod';
+import '../document/database.js';
+import 'sqlite3';
+import '../document/types.js';
+import '../document/text-streams/serial.js';
+import '../document/text-streams/draft.js';
+import '../document/text-streams/types.js';
+import '../document/stores/chunk.js';
+import '../document/stores/types.js';
+import '../document/stores/fragment-group.js';
+import '../document/stores/graph-build-parameter.js';
+import '../document/stores/mention-link.js';
+import '../document/stores/mention.js';
+import '../document/stores/object-metadata.js';
+import '../document/stores/reading-edge.js';
+import '../document/stores/serial.js';
+import '../document/stores/snake/chunk.js';
+import '../document/stores/snake/core.js';
+import '../document/stores/snake/edge.js';
+
+declare class WikiGraphArchive {
+    #private;
+    constructor(document: ReadonlyDocument, documentDirectoryPath: string);
+    exportEpub(path: string): Promise<void>;
+    exportText(path: string): Promise<void>;
+    readCover(): Promise<SourceAsset | undefined>;
+    readMeta(): Promise<BookMeta | undefined>;
+    readToc(): Promise<TocFile | undefined>;
+    readArchiveFormatVersion(): Promise<number>;
+    readChapterStage(serialId: number): Promise<ChapterStage>;
+    listSerials(): Promise<readonly WikiGraphSerialEntry[]>;
+    readSerialSummary(serialId: number): Promise<string>;
+    saveAs(path: string): Promise<void>;
+}
+
+export { WikiGraphArchive };