wiki-graph-core 0.3.1

package/dist/facade/knowledge-graph-build.d.ts

@@ -0,0 +1,75 @@
+import { GuaranteedRequestController } from '../guaranteed/types.js';
+import { MentionLinkRecord, MentionRecord, FragmentRecord } from '../document/types.js';
+import { Document, ReadonlyDocument } from '../document/document.js';
+import { WikipageResolveProgress, WikipageResolverOptions } from '../wikipage/types.js';
+import { WikimatchCandidate, WikimatchAcceptedMention } from '../wikimatch/types.js';
+import { MatchWikispineSentenceCandidatesOptions } from '../wikimatch/wikispine.js';
+import { ChapterDetails } from './chapter.js';
+import { BuildJobProgressReporter } from './build-queue.js';
+import '../llm/types.js';
+import 'ai';
+import 'zod';
+import '../source/meta.js';
+import '../source/toc.js';
+import '../source/types.js';
+import '../document/database.js';
+import 'sqlite3';
+import '../document/text-streams.js';
+import '../document/stores.js';
+import '../common/language.js';
+import '../common/llm-scope.js';
+import '../llm/client.js';
+import '../llm/context.js';
+import '../llm/cache.js';
+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';
+
+interface ChapterKnowledgeGraphBuildArtifact {
+    readonly chapterId: number;
+    readonly mentionLinksPath: string;
+    readonly mentionsPath: string;
+    readonly parameter: GraphBuildParameterInput;
+    readonly workspacePath: string;
+}
+interface ChapterKnowledgeGraphInputSnapshot {
+    readonly details: ChapterDetails;
+    readonly fragments: readonly FragmentRecord[];
+}
+interface GraphBuildParameterInput {
+    readonly language?: string;
+    readonly prompt: string;
+}
+interface BuildChapterKnowledgeGraphArtifactOptions {
+    readonly mentionLinks: AsyncIterable<MentionLinkRecord> | Iterable<MentionLinkRecord>;
+    readonly mentions: AsyncIterable<MentionRecord> | Iterable<MentionRecord>;
+    readonly parameter?: GraphBuildParameterInput;
+    readonly workspacePath: string;
+}
+interface GenerateChapterKnowledgeGraphArtifactOptions {
+    readonly policyPrompt: string;
+    readonly progressTracker?: Pick<BuildJobProgressReporter, "throwIfStopped" | "updatePhase">;
+    readonly request: GuaranteedRequestController;
+    readonly resolverOptions?: Omit<WikipageResolverOptions, "progress">;
+    readonly wikispine?: Pick<MatchWikispineSentenceCandidatesOptions, "command" | "dataDir" | "endpoint" | "provider">;
+    readonly workspacePath: string;
+}
+declare function generateChapterKnowledgeGraphArtifact(document: ReadonlyDocument, chapterId: number, options: GenerateChapterKnowledgeGraphArtifactOptions): Promise<ChapterKnowledgeGraphBuildArtifact>;
+declare function snapshotChapterKnowledgeGraphInput(document: ReadonlyDocument, chapterId: number): Promise<ChapterKnowledgeGraphInputSnapshot>;
+declare function generateChapterKnowledgeGraphArtifactFromSnapshot(chapterId: number, snapshot: ChapterKnowledgeGraphInputSnapshot, options: GenerateChapterKnowledgeGraphArtifactOptions): Promise<ChapterKnowledgeGraphBuildArtifact>;
+declare function buildChapterKnowledgeGraphArtifact(chapterId: number, options: BuildChapterKnowledgeGraphArtifactOptions): Promise<ChapterKnowledgeGraphBuildArtifact>;
+declare function groundWikimatchCandidates(input: {
+    readonly candidates: readonly WikimatchCandidate[];
+    readonly policyPrompt: string;
+    readonly progressTracker?: Pick<BuildJobProgressReporter, "throwIfStopped" | "updatePhase">;
+    readonly request: GuaranteedRequestController;
+    readonly text: string;
+}): Promise<readonly WikimatchAcceptedMention[]>;
+declare function createEnrichmentProgressReporter(progressTracker: Pick<BuildJobProgressReporter, "throwIfStopped" | "updatePhase">): (event: WikipageResolveProgress) => Promise<void>;
+declare function commitChapterKnowledgeGraphArtifact(document: Document, artifact: ChapterKnowledgeGraphBuildArtifact): Promise<void>;
+declare function clearChapterKnowledgeGraph(document: Document, chapterId: number): Promise<void>;
+
+export { type BuildChapterKnowledgeGraphArtifactOptions, type ChapterKnowledgeGraphBuildArtifact, type ChapterKnowledgeGraphInputSnapshot, type GenerateChapterKnowledgeGraphArtifactOptions, type GraphBuildParameterInput, buildChapterKnowledgeGraphArtifact, clearChapterKnowledgeGraph, commitChapterKnowledgeGraphArtifact, createEnrichmentProgressReporter, generateChapterKnowledgeGraphArtifact, generateChapterKnowledgeGraphArtifactFromSnapshot, groundWikimatchCandidates, snapshotChapterKnowledgeGraphInput };