wiki-graph 0.3.0 → 0.4.0

package/dist/index.d.ts

@@ -1,842 +1,36 @@
-import * as Sqlite3Namespace from 'sqlite3';
-import { ModelMessage, LanguageModel } from 'ai';
-import { z } from 'zod';
-
-declare enum Language {
-    Arabic = "Arabic",
-    Danish = "Danish",
-    Dutch = "Dutch",
-    English = "English",
-    Finnish = "Finnish",
-    French = "French",
-    German = "German",
-    Hindi = "Hindi",
-    Indonesian = "Indonesian",
-    Italian = "Italian",
-    Japanese = "Japanese",
-    Korean = "Korean",
-    Norwegian = "Norwegian",
-    Polish = "Polish",
-    Portuguese = "Portuguese",
-    Russian = "Russian",
-    SimplifiedChinese = "Simplified Chinese",
-    Spanish = "Spanish",
-    Swedish = "Swedish",
-    Thai = "Thai",
-    TraditionalChinese = "Traditional Chinese",
-    Turkish = "Turkish",
-    Vietnamese = "Vietnamese"
-}
-declare enum LanguageCode {
-    Arabic = "ar",
-    Chinese = "zh",
-    Danish = "da",
-    Dutch = "nl",
-    English = "en",
-    Finnish = "fi",
-    French = "fr",
-    German = "de",
-    Hindi = "hi",
-    Indonesian = "id",
-    Italian = "it",
-    Japanese = "ja",
-    Korean = "ko",
-    Norwegian = "no",
-    Polish = "pl",
-    Portuguese = "pt",
-    Russian = "ru",
-    Spanish = "es",
-    Swedish = "sv",
-    Thai = "th",
-    Turkish = "tr",
-    Vietnamese = "vi"
-}
-declare function getLanguageCode(language: Language): LanguageCode;
-declare function formatLanguageForPrompt(code: LanguageCode): Language;
-declare function normalizeLanguageCode(language: Language | string | null | undefined): LanguageCode | undefined;
-declare function getWikipageLanguageCode(language: Language | string | null | undefined): "en" | "zh" | undefined;
-
-declare const SPINE_DIGEST_CONTEXT_VERSION = 1;
-declare const TASK_STATUS_VERSION = 1;
-type SpineDigestTaskType = "source-to-graph" | "source-graph-to-summary";
-interface SpineDigestTaskIdentity {
-    readonly normalizedSource: string;
-    readonly parameters: unknown;
-    readonly taskType: SpineDigestTaskType;
-    readonly version?: number;
-}
-interface SpineDigestTaskContextOptions {
-    readonly rootDirPath: string;
-}
-interface TaskStatus {
-    readonly completedAt?: string | undefined;
-    readonly startedAt: string;
-    readonly status: "running" | "succeeded";
-    readonly version: typeof TASK_STATUS_VERSION;
-}
-declare class SpineDigestTaskContext {
-    #private;
-    constructor(options: SpineDigestTaskContextOptions);
-    createTask(identity: SpineDigestTaskIdentity): SpineDigestTask;
-    runTask<T>(identity: SpineDigestTaskIdentity, operation: (task: SpineDigestTask) => Promise<T> | T): Promise<T>;
-}
-declare class SpineDigestTask {
-    #private;
-    constructor(id: string, path: string);
-    get artifactDirPath(): string;
-    get id(): string;
-    get path(): string;
-    readStatus(): Promise<TaskStatus | undefined>;
-    run<T>(operation: (task: SpineDigestTask) => Promise<T> | T): Promise<T>;
-    remove(): Promise<void>;
-}
-declare function createSpineDigestTaskId(identity: SpineDigestTaskIdentity): string;
-
-type LLMessage = ModelMessage;
-
-declare class LLMPaymentRequiredError extends Error {
-    readonly isRetryable = false;
-    readonly statusCode = 402;
-    constructor(message?: string, options?: ErrorOptions);
-}
-
-type SqliteDatabase = Sqlite3Namespace.Database;
-type SqlBindValue = Buffer | Uint8Array | number | string | null;
-type SqlBindParams = readonly SqlBindValue[];
-type SqlRowValue = SqlBindValue;
-type SqlRow = Record<string, SqlRowValue>;
-declare class Database {
-    #private;
-    constructor(database: SqliteDatabase, options?: {
-        readonly onWrite?: () => void;
-    });
-    static open(databasePath: string, schemaSql?: string, options?: {
-        readonly onWrite?: () => void;
-        readonly readonly?: boolean;
-    }): Promise<Database>;
-    static initialize(databasePath: string, schemaSql: string): Promise<void>;
-    queryAll<T>(sql: string, params: SqlBindParams | undefined, mapRow: (row: SqlRow) => T): Promise<T[]>;
-    queryOne<T>(sql: string, params: SqlBindParams | undefined, mapRow: (row: SqlRow) => T): Promise<T | undefined>;
-    run(sql: string, params?: SqlBindParams): Promise<void>;
-    transaction<T>(operation: () => Promise<T> | T): Promise<T>;
-    flush(): Promise<void>;
-    close(): Promise<void>;
-    getLastInsertRowId(): Promise<number>;
-}
-
-declare enum ChunkRetention {
-    Verbatim = "verbatim",
-    Detailed = "detailed",
-    Focused = "focused",
-    Relevant = "relevant"
-}
-declare enum ChunkImportance {
-    Critical = "critical",
-    Important = "important",
-    Helpful = "helpful"
-}
-type SentenceId = readonly [chapterId: number, sentenceIndex: number];
-interface SentenceRecord {
-    readonly text: string;
-    readonly wordsCount: number;
-}
-interface FragmentRecord {
-    readonly serialId: number;
-    readonly fragmentId: number;
-    readonly summary: string;
-    readonly sentences: readonly SentenceRecord[];
-}
-interface SerialRecord {
-    readonly documentOrder: number;
-    readonly knowledgeGraphReady: boolean;
-    readonly knowledgeGraphParameterHash?: string;
-    readonly id: number;
-    readonly revision: number;
-    readonly topologyParameterHash?: string;
-    readonly topologyReady: boolean;
-}
-interface GraphBuildParameterRecord {
-    readonly createdAt: string;
-    readonly hash: string;
-    readonly language?: string;
-    readonly prompt: string;
-}
-interface ChunkRecord {
-    readonly id: number;
-    readonly generation: number;
-    readonly sentenceId: SentenceId;
-    readonly label: string;
-    readonly content: string;
-    readonly sentenceIds: readonly SentenceId[];
-    readonly retention?: ChunkRetention;
-    readonly importance?: ChunkImportance;
-    readonly wordsCount: number;
-    readonly weight: number;
-}
-interface ReadingEdgeRecord {
-    readonly fromId: number;
-    readonly toId: number;
-    readonly strength?: string;
-    readonly weight: number;
-}
-interface MentionRecord {
-    readonly id: string;
-    readonly chapterId: number;
-    readonly fragmentId?: number;
-    readonly sentenceIndex?: number;
-    readonly rangeStart: number;
-    readonly rangeEnd: number;
-    readonly surface: string;
-    readonly qid: string;
-    readonly confidence?: number;
-    readonly note?: string;
-}
-interface MentionLinkRecord {
-    readonly id: string;
-    readonly sourceMentionId: string;
-    readonly targetMentionId: string;
-    readonly predicate: string;
-    readonly evidenceSentenceIds: readonly SentenceId[];
-    readonly confidence?: number;
-    readonly note?: string;
-}
-interface SnakeRecord {
-    readonly id: number;
-    readonly serialId: number;
-    readonly groupId: number;
-    readonly localSnakeId: number;
-    readonly size: number;
-    readonly firstLabel: string;
-    readonly lastLabel: string;
-    readonly wordsCount: number;
-    readonly weight: number;
-}
-interface SnakeChunkRecord {
-    readonly snakeId: number;
-    readonly chunkId: number;
-    readonly position: number;
-}
-interface SnakeEdgeRecord {
-    readonly fromSnakeId: number;
-    readonly toSnakeId: number;
-    readonly weight: number;
-}
-interface SentenceGroupRecord {
-    readonly serialId: number;
-    readonly groupId: number;
-    readonly startSentenceIndex: number;
-    readonly endSentenceIndex: number;
-    readonly fragmentId?: number;
-}
-
-interface ReadonlySerialTextStream {
-    getFragment(fragmentId: number): Promise<FragmentRecord>;
-    getSentence?(sentenceIndex: number): Promise<SentenceRecord>;
-    listSentencesInRange?(startSentenceIndex: number, endSentenceIndex: number): Promise<readonly SentenceRecord[]>;
-    listFragmentIds(): Promise<readonly number[]>;
-    listSentences?(): Promise<readonly SentenceRecord[]>;
-    readText?(): Promise<string | undefined>;
-    readTextInRange?(startSentenceIndex: number, endSentenceIndex: number): Promise<string | undefined>;
-    readonly path: string;
-    readonly serialId: number;
-}
-
-declare const bookMetaSchema: z.ZodObject<{
-    version: z.ZodLiteral<1>;
-    sourceFormat: z.ZodEnum<{
-        epub: "epub";
-        pdf: "pdf";
-        txt: "txt";
-        markdown: "markdown";
-    }>;
-    title: z.ZodNullable<z.ZodString>;
-    authors: z.ZodArray<z.ZodString>;
-    language: z.ZodNullable<z.ZodString>;
-    identifier: z.ZodNullable<z.ZodString>;
-    publisher: z.ZodNullable<z.ZodString>;
-    publishedAt: z.ZodNullable<z.ZodString>;
-    description: z.ZodNullable<z.ZodString>;
-}, z.core.$strip>;
-type BookMeta = z.infer<typeof bookMetaSchema>;
-
-interface TocItem {
-    readonly title?: string | null | undefined;
-    readonly serialId?: number | undefined;
-    readonly children: readonly TocItem[];
-}
-declare const tocFileSchema: z.ZodObject<{
-    version: z.ZodLiteral<1>;
-    items: z.ZodArray<z.ZodType<TocItem, unknown, z.core.$ZodTypeInternals<TocItem, unknown>>>;
-}, z.core.$strip>;
-type TocFile = z.infer<typeof tocFileSchema>;
-
-interface SourceAsset {
-    readonly path: string;
-    readonly mediaType: string;
-    readonly data: Uint8Array;
-}
-
-interface ReadonlySerialStore {
-    getById(serialId: number): Promise<SerialRecord | undefined>;
-    getRevision(serialId: number): Promise<number>;
-    getRevisions(serialIds: readonly number[]): Promise<ReadonlyMap<number, number>>;
-    getMaxId(): Promise<number>;
-    getChaptersRevision(): Promise<number>;
-    listIds(): Promise<number[]>;
-    listDocumentOrders(): Promise<ReadonlyMap<number, number>>;
-}
-interface ReadonlyGraphBuildParameterStore {
-    getByHash(hash: string): Promise<GraphBuildParameterRecord | undefined>;
-}
-interface ReadonlyChunkStore {
-    countAll(): Promise<number>;
-    getById(chunkId: number): Promise<ChunkRecord | undefined>;
-    listAll(): Promise<ChunkRecord[]>;
-    listBySentenceStartIndexes(serialId: number, sentenceStartIndexes: readonly number[]): Promise<ChunkRecord[]>;
-    listBySentenceRange(serialId: number, startSentenceIndex: number, endSentenceIndex: number): Promise<ChunkRecord[]>;
-    listBySerial(serialId: number): Promise<ChunkRecord[]>;
-    getMaxId(): Promise<number>;
-    listFragmentPairs(): Promise<ReadonlyArray<readonly [number, number]>>;
-}
-interface ReadonlyReadingEdgeStore {
-    countAll(): Promise<number>;
-    listAll(): Promise<ReadingEdgeRecord[]>;
-    listBySerial(serialId: number): Promise<ReadingEdgeRecord[]>;
-    listIncoming(chunkId: number): Promise<ReadingEdgeRecord[]>;
-    listOutgoing(chunkId: number): Promise<ReadingEdgeRecord[]>;
-}
-interface ReadonlyMentionStore {
-    getById(mentionId: string): Promise<MentionRecord | undefined>;
-    listAll(): Promise<MentionRecord[]>;
-    listBySurfaceTerms(terms: readonly string[]): Promise<MentionRecord[]>;
-    listBySurfaces(surfaces: readonly string[]): Promise<MentionRecord[]>;
-    listByQid(qid: string): Promise<MentionRecord[]>;
-    listByChapter(chapterId: number): Promise<MentionRecord[]>;
-}
-interface ReadonlyMentionLinkStore {
-    getById(linkId: string): Promise<MentionLinkRecord | undefined>;
-    listByTriple(input: {
-        readonly objectQid: string;
-        readonly predicate: string;
-        readonly subjectQid: string;
-    }): Promise<MentionLinkRecord[]>;
-    listByChapter(chapterId: number): Promise<MentionLinkRecord[]>;
-}
-interface ReadonlySnakeStore {
-    getById(snakeId: number): Promise<SnakeRecord | undefined>;
-    listIdsByGroup(serialId: number, groupId: number): Promise<number[]>;
-    listBySerial(serialId: number): Promise<SnakeRecord[]>;
-}
-interface ReadonlySnakeChunkStore {
-    listChunkIds(snakeId: number): Promise<number[]>;
-    listBySnake(snakeId: number): Promise<SnakeChunkRecord[]>;
-}
-interface ReadonlySnakeEdgeStore {
-    listIncoming(snakeId: number): Promise<SnakeEdgeRecord[]>;
-    listOutgoing(snakeId: number): Promise<SnakeEdgeRecord[]>;
-    listWithin(snakeIds: readonly number[]): Promise<SnakeEdgeRecord[]>;
-    listBySerial(serialId: number): Promise<SnakeEdgeRecord[]>;
-}
-interface ReadonlyFragmentGroupStore {
-    listBySerial(serialId: number): Promise<SentenceGroupRecord[]>;
-    listSerialIds(): Promise<number[]>;
-    listGroupIdsForSerial(serialId: number): Promise<number[]>;
-}
-interface ReadonlyObjectMetadataStore {
-    getMap(objectPath: string): Promise<Readonly<Record<string, unknown>>>;
-}
-
-interface ReadonlyDocument {
-    readonly chunks: ReadonlyChunkStore;
-    readonly fragmentGroups: ReadonlyFragmentGroupStore;
-    readonly graphBuildParameters: ReadonlyGraphBuildParameterStore;
-    readonly readingEdges: ReadonlyReadingEdgeStore;
-    readonly mentionLinks: ReadonlyMentionLinkStore;
-    readonly mentions: ReadonlyMentionStore;
-    readonly metadata: ReadonlyObjectMetadataStore;
-    readonly serials: ReadonlySerialStore;
-    readonly snakeChunks: ReadonlySnakeChunkStore;
-    readonly snakeEdges: ReadonlySnakeEdgeStore;
-    readonly snakes: ReadonlySnakeStore;
-    getSentence(sentenceId: SentenceId): Promise<string>;
-    getSerialFragments(serialId: number): ReadonlySerialTextStream;
-    getSummaryFragments(serialId: number): ReadonlySerialTextStream;
-    openSession<T>(operation: (document: ReadonlyDocument) => Promise<T> | T): Promise<T>;
-    readDatabase<T>(operation: (database: Database) => Promise<T> | T): Promise<T>;
-    readSearchIndexDatabase<T>(operation: (database: Database) => Promise<T> | T): Promise<T>;
-    readBookMeta(): Promise<BookMeta | undefined>;
-    readCover(): Promise<SourceAsset | undefined>;
-    readSummary(serialId: number): Promise<string | undefined>;
-    readToc(): Promise<TocFile | undefined>;
-    release(): Promise<void>;
-}
-
-declare const EVIDENCE_SELECTION_PROMPT_FRAGMENT: string;
-declare const EVIDENCE_SELECTION_JSON_SHAPE: readonly [{
-    readonly quote: "exact short source quote copied from the selected sentence";
-    readonly sentence_id: "sentence id from the source context, such as S1";
-}];
-declare function formatEvidenceSelectionChoicePrompt(input: {
-    readonly evidenceLabel: string;
-    readonly generatedEvidence: unknown;
-    readonly candidates: readonly {
-        readonly nextText: string;
-        readonly occurrenceId: string;
-        readonly prevText: string;
-        readonly score: number;
-        readonly text: string;
-    }[];
-}): string;
-
-type EvidenceQuoteMatchStrategy = "empty" | "exact" | "normalized_exact" | "normalized_substring" | "fuzzy_window";
-interface EvidenceQuoteScore {
-    readonly exactRaw: boolean;
-    readonly exactNormalized: boolean;
-    readonly exactSubstring: boolean;
-    readonly matchEnd: number;
-    readonly matchStart: number;
-    readonly normalizedQuote: string;
-    readonly normalizedSentence: string;
-    readonly score: number;
-    readonly strategy: EvidenceQuoteMatchStrategy;
-}
-declare function normalizeEvidenceDisplayText(text: string): string;
-declare function normalizeEvidenceText(text: string): string;
-declare function scoreEvidenceQuote(input: {
-    readonly quote: string;
-    readonly sentence: string;
-}): EvidenceQuoteScore;
-
-type EvidenceSentenceId = readonly [number, number];
-interface EvidenceSelectionSentence {
-    readonly id: string;
-    readonly sentenceId: EvidenceSentenceId;
-    readonly text: string;
-}
-interface EvidenceSelection {
-    readonly quote?: string;
-    readonly sentence_id?: string;
-}
-type EvidenceSelectionList = EvidenceSelection | readonly EvidenceSelection[];
-interface EvidenceSelectionCandidate {
-    readonly exactNormalized: boolean;
-    readonly exactRaw: boolean;
-    readonly exactSubstring: boolean;
-    readonly index: number;
-    readonly nextText: string;
-    readonly occurrenceId: string;
-    readonly prevText: string;
-    readonly score: number;
-    readonly sentence: EvidenceSelectionSentence;
-    readonly strategy: string;
-}
-interface EvidenceSelectionResolution {
-    readonly candidate: EvidenceSelectionCandidate;
-    readonly confidence: number;
-    readonly sentenceIds: readonly EvidenceSentenceId[];
-    readonly strategy: string;
-}
-interface EvidenceSelectionFailure {
-    readonly candidates: readonly EvidenceSelectionCandidate[];
-    readonly code: "ambiguous" | "invalid" | "low_confidence" | "missing_sentence" | "none";
-    readonly message: string;
-}
-
-declare function resolveEvidenceSelection(input: {
-    readonly evidence: EvidenceSelection;
-    readonly sentences: readonly EvidenceSelectionSentence[];
-}): readonly [
-    resolution: EvidenceSelectionResolution | undefined,
-    failure: EvidenceSelectionFailure | undefined
-];
-declare function resolveEvidenceSelectionList(input: {
-    readonly evidence: EvidenceSelectionList;
-    readonly sentences: readonly EvidenceSelectionSentence[];
-}): readonly [
-    resolution: EvidenceSelectionResolution | undefined,
-    failure: EvidenceSelectionFailure | undefined
-];
-declare function rankEvidenceQuote(quote: string, sentences: readonly EvidenceSelectionSentence[]): EvidenceSelectionCandidate[];
-
-interface WikipageResolverOptions {
-    readonly cacheDatabasePath?: string;
-    readonly concurrency?: number;
-    readonly fetch?: typeof fetch;
-    readonly language?: string;
-    readonly maxBatchSize?: number;
-    readonly minRequestIntervalMs?: number;
-    readonly normalizer?: DisambiguationProfileNormalizer;
-    readonly progress?: WikipageResolveProgressReporter;
-    readonly retryBaseDelayMs?: number;
-    readonly retryTimes?: number;
-    readonly userAgent?: string;
-    readonly wiki?: string;
-}
-type WikipageResolveProgressDetail = "disambiguation-page" | "entity" | "linked-page" | "page" | "qid";
-interface WikipageResolveProgress {
-    readonly detail: WikipageResolveProgressDetail;
-    readonly done: number;
-    readonly total: number;
-}
-type WikipageResolveProgressReporter = (event: WikipageResolveProgress) => Promise<void> | void;
-interface QidResolution {
-    readonly description?: string;
-    readonly disambiguation?: DisambiguationExpansion;
-    readonly disambiguationPages?: readonly DisambiguationPageText[];
-    readonly isDisambiguation: boolean;
-    readonly label?: string;
-    readonly qid: string;
-    readonly sitelink?: WikipageSitelink;
-    readonly sitelinks?: readonly WikipageSitelink[];
-}
-interface WikipageSitelink {
-    readonly title: string;
-    readonly wiki: string;
-}
-interface DisambiguationExpansion {
-    readonly checkedAt: string;
-    readonly disambiguationQid: string;
-    readonly linkedQids: readonly DisambiguationLinkedQid[];
-    readonly pages: readonly DisambiguationPageText[];
-    readonly profile?: DisambiguationProfile;
-}
-interface DisambiguationPageText {
-    readonly linkedQids: readonly DisambiguationLinkedQid[];
-    readonly pageId?: number;
-    readonly text: string;
-    readonly title: string;
-    readonly wiki: "enwiki" | "zhwiki";
-}
-interface DisambiguationLinkedQid {
-    readonly qid: string;
-    readonly title: string;
-}
-interface CachedQidRecord {
-    readonly checkedAt: string;
-    readonly description?: string;
-    readonly label?: string;
-    readonly qid: string;
-    readonly sitelinks: readonly CachedPageRecord[];
-    readonly updatedAt: string;
-}
-interface CachedDisambiguationRecord {
-    readonly checkedAt: string;
-    readonly disambiguationQid: string;
-    readonly pages: readonly DisambiguationPageText[];
-    readonly profile?: DisambiguationProfile;
-}
-interface CachedPageRecord {
-    readonly isDisambiguation: boolean;
-    readonly pageId?: number;
-    readonly title: string;
-    readonly wiki: "enwiki" | "zhwiki";
-}
-type DisambiguationMeaningPriority = "other" | "primary" | "secondary";
-interface DisambiguationProfile {
-    readonly meanings: readonly DisambiguationProfileMeaning[];
-    readonly sourceQid: string;
-    readonly surface?: string;
-}
-interface DisambiguationProfileMeaning {
-    readonly category?: string;
-    readonly information: string;
-    readonly name: string;
-    readonly priority: DisambiguationMeaningPriority;
-    readonly qid: string;
-}
-type DisambiguationProfileNormalizer = (input: DisambiguationProfileNormalizerInput) => Promise<DisambiguationProfile>;
-interface DisambiguationProfileNormalizerInput {
-    readonly pageQidLinks: readonly DisambiguationLinkedQid[];
-    readonly pages: readonly DisambiguationPageText[];
-    readonly sourceQid: string;
-    readonly surface?: string;
-}
-
-declare class WikipageCache {
-    #private;
-    constructor(database: Database);
-    static open(path?: string): Promise<WikipageCache>;
-    close(): Promise<void>;
-    getQids(qids: readonly string[], language: string): Promise<ReadonlyMap<string, CachedQidRecord>>;
-    putQids(records: readonly CachedQidRecord[], language: string): Promise<void>;
-    getDisambiguations(qids: readonly string[], wiki: string): Promise<ReadonlyMap<string, CachedDisambiguationRecord>>;
-    putDisambiguations(records: readonly CachedDisambiguationRecord[], wiki: string): Promise<void>;
-}
-
-type GuaranteedRequest = (messages: readonly LLMessage[], index: number, maxRetries: number) => Promise<string | undefined>;
-
-interface CreateDisambiguationProfileNormalizerOptions {
-    readonly maxMeanings?: number;
-    readonly maxRetries?: number;
-    readonly request: GuaranteedRequest;
-}
-declare function createDisambiguationProfileNormalizer(options: CreateDisambiguationProfileNormalizerOptions): DisambiguationProfileNormalizer;
-
-interface RateLimiterOptions {
-    readonly concurrency: number;
-    readonly minRequestIntervalMs: number;
-}
-declare class RateLimiter {
-    #private;
-    constructor(options: RateLimiterOptions);
-    use<T>(operation: () => Promise<T>): Promise<T>;
-    blockFor(ms: number): void;
-}
-declare function parseRetryAfterMs(value: string | null): number | undefined;
-
-type SupportedWiki = "enwiki" | "zhwiki";
-interface WikimediaClientOptions {
-    readonly concurrency: number;
-    readonly fetch?: typeof fetch;
-    readonly language: string;
-    readonly minRequestIntervalMs: number;
-    readonly retryBaseDelayMs: number;
-    readonly retryTimes: number;
-    readonly userAgent?: string;
-    readonly wiki: string;
-}
-interface WikidataEntityInfo {
-    readonly description?: string;
-    readonly label?: string;
-    readonly qid: string;
-    readonly sitelinks: readonly WikidataSitelinkInfo[];
-}
-interface WikidataSitelinkInfo {
-    readonly title: string;
-    readonly wiki: SupportedWiki;
-}
-interface WikiPageInfo {
-    readonly isDisambiguation: boolean;
-    readonly pageId?: number;
-    readonly title: string;
-    readonly wiki: SupportedWiki;
-    readonly wikibaseItem?: string;
-}
-interface ParsedDisambiguationPage {
-    readonly linkedTitles: readonly string[];
-    readonly pageId?: number;
-    readonly text: string;
-    readonly title: string;
-    readonly wiki: SupportedWiki;
-}
-declare class WikimediaClient {
-    #private;
-    constructor(options: WikimediaClientOptions);
-    getEntities(qids: readonly string[]): Promise<ReadonlyMap<string, WikidataEntityInfo>>;
-    getPagesByTitles(titles: readonly string[], wiki?: SupportedWiki): Promise<ReadonlyMap<string, WikiPageInfo>>;
-    parseDisambiguationPage(title: string, wiki: SupportedWiki): Promise<ParsedDisambiguationPage>;
-}
-
-declare class WikipageResolver {
-    #private;
-    constructor(input: {
-        readonly cache: WikipageCache;
-        readonly client: WikimediaClient;
-        readonly language: string;
-        readonly maxBatchSize: number;
-        readonly normalizer: DisambiguationProfileNormalizer | undefined;
-        readonly ownsCache: boolean;
-        readonly progress: WikipageResolveProgressReporter | undefined;
-        readonly wiki: string;
-    });
-    static open(options?: WikipageResolverOptions): Promise<WikipageResolver>;
-    close(): Promise<void>;
-    resolveQids(qids: readonly string[]): Promise<readonly QidResolution[]>;
-}
-
-interface WikimatchCandidate {
-    readonly hasMoreOptions?: boolean;
-    readonly id: string;
-    readonly qidOptions: readonly WikimatchQidOption[];
-    readonly range: WikimatchTextRange;
-    readonly surface: string;
-}
-interface WikimatchQidOption {
-    readonly description?: string;
-    readonly disambiguation?: DisambiguationExpansion;
-    readonly isDisambiguation?: boolean;
-    readonly label?: string;
-    readonly qid: string;
-}
-interface WikimatchTextRange {
-    readonly end: number;
-    readonly start: number;
-}
-interface WikimatchWindow {
-    readonly baseOffset: number;
-    readonly candidates: readonly WikimatchCandidate[];
-    readonly groups: readonly WikimatchConflictGroup[];
-    readonly text: string;
-}
-interface WikimatchConflictGroup {
-    readonly candidateIds: readonly string[];
-    readonly id: string;
-    readonly range: WikimatchTextRange;
-}
-interface BuildWikimatchWindowsOptions {
-    readonly candidates: readonly WikimatchCandidate[];
-    readonly contextWords: number;
-    readonly optionBudget: number;
-    readonly text: string;
-}
-type WikimatchPolicyDecision = "continue" | "never_recall" | "recall" | "skip_this_time";
-interface WikimatchPolicyJudgeInput {
-    readonly candidates: readonly WikimatchCandidate[];
-    readonly policyPrompt: string;
-    readonly window: WikimatchWindow;
-}
-interface WikimatchPolicyJudgeResult {
-    readonly continuations: readonly WikimatchPolicyContinuation[];
-    readonly fallback?: WikimatchPolicyFallback;
-    readonly mentions: readonly WikimatchAcceptedMention[];
-    readonly policyUpdates: readonly WikimatchPolicyUpdate[];
-}
-interface WikimatchAcceptedMention {
-    readonly candidateId: string;
-    readonly confidence?: number;
-    readonly qid: string;
-    readonly range: WikimatchTextRange;
-    readonly note?: string;
-    readonly surface: string;
-}
-interface WikimatchPolicyUpdate {
-    readonly candidateId: string;
-    readonly decision: Exclude<WikimatchPolicyDecision, "recall" | "continue">;
-    readonly note?: string;
-    readonly qid?: string;
-    readonly surface: string;
-}
-interface WikimatchPolicyContinuation {
-    readonly candidateIds: readonly string[];
-    readonly groupId: string;
-}
-interface WikimatchPolicyFallback {
-    readonly issues: readonly string[];
-    readonly reason: "guaranteed_json_failed";
-}
-interface WikimatchPolicyDecisionOutput {
-    readonly candidateId: string;
-    readonly confidence?: number;
-    readonly decision: WikimatchPolicyDecision;
-    readonly qid?: string;
-}
-interface WikimatchPolicyGroupOutput {
-    readonly decisions: readonly WikimatchPolicyDecisionOutput[];
-    readonly groupId: string;
-}
-interface WikimatchPolicyResponse {
-    readonly groups: readonly WikimatchPolicyGroupOutput[];
-}
-
-interface JudgeWikimatchPolicyOptions extends WikimatchPolicyJudgeInput {
-    readonly maxRetries?: number;
-    readonly request: GuaranteedRequest;
-}
-declare function judgeWikimatchPolicy(options: JudgeWikimatchPolicyOptions): Promise<WikimatchPolicyJudgeResult>;
-declare function parsePolicyResponse(candidates: readonly WikimatchCandidate[], response: WikimatchPolicyResponse, groups?: readonly WikimatchConflictGroup[]): WikimatchPolicyJudgeResult;
-declare function validatePolicyResponse(candidates: readonly WikimatchCandidate[], response: WikimatchPolicyResponse, groups?: readonly WikimatchConflictGroup[]): readonly string[];
-
-declare function buildWikimatchWindows(options: BuildWikimatchWindowsOptions): readonly WikimatchWindow[];
-
-type SpineDigestOperation = "digest-epub" | "digest-markdown" | "digest-text-stream" | "digest-txt";
-interface SerialDiscoveryItem {
-    readonly id: number;
-    readonly fragments?: number | undefined;
-    readonly title?: string | undefined;
-    readonly words: number;
-}
-interface SerialsDiscoveredEvent {
-    readonly type: "serials-discovered";
-    readonly available: boolean;
-    readonly serials: readonly SerialDiscoveryItem[];
-}
-interface SerialProgressEvent {
-    readonly type: "serial-progress";
-    readonly id: number;
-    readonly completedWords: number;
-    readonly completedFragments: number;
-}
-interface DigestProgressEvent {
-    readonly type: "digest-progress";
-    readonly completedWords: number;
-    readonly totalWords: number;
-}
-type SpineDigestProgressEventType = SpineDigestProgressEvent["type"];
-type SpineDigestProgressEvent = SerialsDiscoveredEvent | SerialProgressEvent | DigestProgressEvent;
-type SpineDigestProgressCallback = (event: SpineDigestProgressEvent) => void | Promise<void>;
-
-declare const CHAPTER_STAGES: readonly ["planned", "sourced", "graphed", "summarized"];
-type ChapterStage = (typeof CHAPTER_STAGES)[number];
-
-interface SpineDigestSerialEntry {
-    readonly fragmentCount: number;
-    readonly serialId: number;
-    readonly title: string | null;
-    readonly tocPath: readonly string[];
-}
-
-declare class SpineDigest {
-    #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 SpineDigestSerialEntry[]>;
-    readSerialSummary(serialId: number): Promise<string>;
-    saveAs(path: string): Promise<void>;
-}
-
-interface DigestDocumentSessionOptions {
-    readonly documentDirPath?: string;
-}
-
-interface SpineDigestLLMOptions {
-    readonly cacheDirPath?: string;
-    readonly concurrent?: number;
-    readonly logDirPath?: string;
-    readonly model: LanguageModel;
-    readonly retryIntervalSeconds?: number;
-    readonly retryTimes?: number;
-    readonly stream?: boolean;
-    readonly temperature?: number | readonly number[];
-    readonly timeout?: number;
-    readonly topP?: number | readonly number[];
-}
-interface SpineDigestAppOptions {
-    readonly debugLogDirPath?: string;
-    readonly llm?: LanguageModel | SpineDigestLLMOptions;
-    readonly verbose?: boolean;
-}
-type SpineDigestOpenSessionOptions = DigestDocumentSessionOptions;
-interface SpineDigestSourceSessionOptions extends DigestDocumentSessionOptions {
-    readonly extractionPrompt?: string;
-    readonly onProgress?: SpineDigestProgressCallback;
-    readonly path: string;
-    readonly targetStage?: ChapterStage;
-    readonly userLanguage?: Language;
-}
-interface SpineDigestTextStreamSessionOptions extends DigestDocumentSessionOptions {
-    readonly bookLanguage?: string | null;
-    readonly extractionPrompt?: string;
-    readonly onProgress?: SpineDigestProgressCallback;
-    readonly sourceFormat?: "markdown" | "txt";
-    readonly stream: AsyncIterable<string> | Iterable<string>;
-    readonly targetStage?: ChapterStage;
-    readonly title?: string | null;
-    readonly userLanguage?: Language;
-}
-declare class SpineDigestApp {
-    #private;
-    constructor(options: SpineDigestAppOptions);
-    digestEpubSession<T>(options: SpineDigestSourceSessionOptions, operation: (digest: SpineDigest) => Promise<T> | T): Promise<T>;
-    digestMarkdownSession<T>(options: SpineDigestSourceSessionOptions, operation: (digest: SpineDigest) => Promise<T> | T): Promise<T>;
-    digestTextStreamSession<T>(options: SpineDigestTextStreamSessionOptions, operation: (digest: SpineDigest) => Promise<T> | T): Promise<T>;
-    digestTxtSession<T>(options: SpineDigestSourceSessionOptions, operation: (digest: SpineDigest) => Promise<T> | T): Promise<T>;
-    openSession<T>(path: string, operation: (digest: SpineDigest) => Promise<T> | T, options?: SpineDigestOpenSessionOptions): Promise<T>;
-}
-
-export { type BuildWikimatchWindowsOptions, type CachedDisambiguationRecord, type CachedPageRecord, type CachedQidRecord, type DigestProgressEvent, type DisambiguationExpansion, type DisambiguationLinkedQid, type DisambiguationMeaningPriority, type DisambiguationPageText, type DisambiguationProfile, type DisambiguationProfileMeaning, type DisambiguationProfileNormalizer, type DisambiguationProfileNormalizerInput, EVIDENCE_SELECTION_JSON_SHAPE, EVIDENCE_SELECTION_PROMPT_FRAGMENT, type EvidenceQuoteMatchStrategy, type EvidenceQuoteScore, type EvidenceSelection, type EvidenceSelectionCandidate, type EvidenceSelectionFailure, type EvidenceSelectionList, type EvidenceSelectionResolution, type EvidenceSelectionSentence, type EvidenceSentenceId, type JudgeWikimatchPolicyOptions, LLMPaymentRequiredError, Language, LanguageCode, type QidResolution, RateLimiter, SPINE_DIGEST_CONTEXT_VERSION, type SerialDiscoveryItem, type SerialProgressEvent, type SerialsDiscoveredEvent, SpineDigest, SpineDigestApp, type SpineDigestAppOptions, type SpineDigestLLMOptions, type SpineDigestOpenSessionOptions, type SpineDigestOperation, type SpineDigestProgressCallback, type SpineDigestProgressEvent, type SpineDigestProgressEventType, type SpineDigestSerialEntry, type SpineDigestSourceSessionOptions, SpineDigestTask, SpineDigestTaskContext, type SpineDigestTaskContextOptions, type SpineDigestTaskIdentity, type SpineDigestTaskType, type SpineDigestTextStreamSessionOptions, type WikimatchAcceptedMention, type WikimatchCandidate, type WikimatchConflictGroup, type WikimatchPolicyDecision, type WikimatchPolicyDecisionOutput, type WikimatchPolicyFallback, type WikimatchPolicyJudgeInput, type WikimatchPolicyJudgeResult, type WikimatchPolicyResponse, type WikimatchPolicyUpdate, type WikimatchQidOption, type WikimatchTextRange, type WikimatchWindow, WikimediaClient, WikipageCache, WikipageResolver, type WikipageResolverOptions, type WikipageSitelink, buildWikimatchWindows, createDisambiguationProfileNormalizer, createSpineDigestTaskId, formatEvidenceSelectionChoicePrompt, formatLanguageForPrompt, getLanguageCode, getWikipageLanguageCode, judgeWikimatchPolicy, normalizeEvidenceDisplayText, normalizeEvidenceText, normalizeLanguageCode, parsePolicyResponse, parseRetryAfterMs, rankEvidenceQuote, resolveEvidenceSelection, resolveEvidenceSelectionList, scoreEvidenceQuote, validatePolicyResponse };
+export * from 'wiki-graph-core';
+
+interface RunWikiGraphCLIInput {
+    /**
+     * CLI arguments without the executable name. For example, `["--help"]`
+     * simulates `wg --help`.
+     */
+    readonly argv?: readonly string[] | undefined;
+    readonly cwd?: string | undefined;
+    readonly devProjectRoot?: string | undefined;
+    readonly env?: NodeJS.ProcessEnv | undefined;
+    readonly signal?: AbortSignal | undefined;
+    readonly stateDir?: string | undefined;
+    readonly stderr?: NodeJS.WritableStream | undefined;
+    readonly stderrIsTTY?: boolean | undefined;
+    readonly stdin?: NodeJS.ReadableStream | Uint8Array | string | undefined;
+    readonly stdinIsTTY?: boolean | undefined;
+    readonly stdout?: NodeJS.WritableStream | undefined;
+    readonly stdoutIsTTY?: boolean | undefined;
+}
+interface RunWikiGraphCLIResult {
+    readonly exitCode: number;
+}
+interface RunWikiGraphCLICapturedResult extends RunWikiGraphCLIResult {
+    readonly stderr: string;
+    readonly stdout: string;
+}
+interface WikiGraphCLI {
+    run(argv?: readonly string[], overrides?: RunWikiGraphCLIInput): Promise<RunWikiGraphCLIResult>;
+    runCaptured(argv?: readonly string[], overrides?: RunWikiGraphCLIInput): Promise<RunWikiGraphCLICapturedResult>;
+}
+declare function runWikiGraphCLI(input?: RunWikiGraphCLIInput): Promise<RunWikiGraphCLIResult>;
+declare function runWikiGraphCLICaptured(input?: RunWikiGraphCLIInput): Promise<RunWikiGraphCLICapturedResult>;
+declare function createWikiGraphCLI(defaults?: RunWikiGraphCLIInput): WikiGraphCLI;
+
+export { type RunWikiGraphCLICapturedResult, type RunWikiGraphCLIInput, type RunWikiGraphCLIResult, type WikiGraphCLI, createWikiGraphCLI, runWikiGraphCLI, runWikiGraphCLICaptured };