wiki-graph-sdk 0.7.0 → 0.8.0

package/dist/archives.d.ts

@@ -1,79 +1,51 @@
-import { BuildJobTarget, ReadonlyDocument, WikiGraphProgressCallback, File, QueryIndexScope, ParsedWikiGraphLibraryUri, ArchiveFindOptions, ArchiveFindResult, ArchiveCollectionOptions, ArchiveCollectionResult, ArchiveSourceLocatorResult, readSearchIndexCapabilityStatus, rebuildArchiveSearchIndex, ChapterEntry, ChapterDetails, IndexArtifactKind, ChapterStage, setChapterSource, setChapterTitle, ChapterTree, applyChapterTree, ChapterTreeApplyResult, ArchivePage, ArchiveRelatedResult, ArchiveEvidence, ArchivePack, BookMeta } from 'wiki-graph-core';
-import { W as WikiGraphJobRuntime } from './jobs-Dd5PMSId.js';
-import { GenerationPlanningCost, GenerationPerformanceHint } from './planning.js';
+import { ChapterEntry, IndexArtifactKind, ReadonlyDocument, WikiGraphProgressCallback, QueryIndexScope, ArchiveFindOptions, ArchiveFindResult, ArchiveCollectionOptions, ArchiveCollectionResult, ArchiveSourceLocatorResult, readSearchIndexCapabilityStatus, rebuildArchiveSearchIndex, ChapterDetails, ChapterStage, setChapterSource, setChapterTitle, ChapterTree, applyChapterTree, ChapterTreeApplyResult, ArchivePage, ArchiveRelatedResult, ArchiveEvidence, ArchivePack, BookMeta } from 'wiki-graph-core';
+import { W as WikiGraphJobRuntime } from './jobs-xIm_kshM.js';
+import { W as WikiGraphArchiveTarget } from './target-CZ7elwmj.js';
+export { a as WikiGraphArchiveOwnershipError } from './target-CZ7elwmj.js';
 
-interface WikiGraphArchiveInspectImprovement {
-    readonly kind: "add-source" | "build" | "sync-index";
-    readonly missingChapters?: number;
-    readonly missingWords?: number;
-    readonly planning?: GenerationPlanningCost;
-    readonly recommendation: string;
-    readonly task?: BuildJobTarget;
-    readonly title: string;
-}
-interface WikiGraphArchiveInspectCoverage {
-    readonly coveredChapters: number;
-    readonly coveredWords: number;
-    readonly percent: string;
-    readonly totalChapters: number;
-    readonly totalWords: number;
-}
-interface WikiGraphArchiveInspectChapterReference {
-    readonly chapterId: number;
-    readonly locatedUri: string;
-    readonly title: string | null;
-    readonly uri: string;
+interface WikiGraphArchiveIndexArtifactInspection {
+    readonly current: boolean;
+    readonly exists: boolean;
+    readonly kind: IndexArtifactKind;
+    readonly sourceRevision?: number;
 }
-interface WikiGraphArchiveInspectReport {
-    readonly archiveUri: string;
-    readonly uri: string;
-    readonly scope: {
-        readonly chapterId?: number;
-        readonly type: "archive" | "chapter";
-    };
-    readonly content: {
-        readonly chapters: {
-            readonly content: number;
-            readonly planned: number;
-            readonly total: number;
+interface WikiGraphArchiveChapterInspection {
+    readonly capabilities: {
+        readonly knowledgeGraph: {
+            readonly completed: boolean;
+        };
+        readonly readingGraph: {
+            readonly completed: boolean;
+        };
+        readonly readingSummary: {
+            readonly completed: boolean;
         };
-        readonly sourceWords: number;
-        readonly summaryWords: number;
     };
+    readonly chapter: ChapterEntry;
+    readonly indexes: {
+        readonly fts: WikiGraphArchiveIndexArtifactInspection;
+        readonly sourceEmbedding: WikiGraphArchiveIndexArtifactInspection;
+        readonly summaryEmbedding: WikiGraphArchiveIndexArtifactInspection;
+    };
+    readonly revision: number;
+    readonly summaryWords: number;
+}
+interface WikiGraphArchiveInspection {
+    readonly archiveUri: string;
+    readonly chapters: readonly WikiGraphArchiveChapterInspection[];
     readonly localIndexCache: {
-        readonly blockedBy?: "missing-search-artifacts";
         readonly current: boolean;
-        readonly impact?: string;
-        readonly resource?: string;
-        readonly status: "blocked" | "current" | "missing-or-outdated";
-        readonly syncAvailable: boolean;
-    };
-    readonly coverage: {
-        readonly ftsIndexArtifact: WikiGraphArchiveInspectCoverage;
-        readonly knowledgeGraph: WikiGraphArchiveInspectCoverage;
-        readonly readingGraph: WikiGraphArchiveInspectCoverage;
-        readonly summary: WikiGraphArchiveInspectCoverage;
-        readonly summaryEmbeddingIndexArtifact: WikiGraphArchiveInspectCoverage;
-        readonly sourceEmbeddingIndexArtifact: WikiGraphArchiveInspectCoverage;
-    };
-    readonly query: {
-        readonly ready: boolean;
     };
-    readonly searchArtifacts: {
-        readonly blockedChapters: readonly WikiGraphArchiveInspectChapterReference[];
-        readonly ready: boolean;
-        readonly resource?: string;
-        readonly status: "incomplete" | "ready";
+    readonly scope: {
+        readonly chapterId?: number;
+        readonly type: "archive" | "chapter";
     };
-    readonly retrievalGuidance: readonly string[];
-    readonly improvements: readonly WikiGraphArchiveInspectImprovement[];
-    readonly performanceHints: readonly GenerationPerformanceHint[];
-    readonly summaryCoverageNote: string;
+    readonly uri: string;
 }
-declare function createWikiGraphArchiveInspectReport(document: ReadonlyDocument, options: {
+declare function inspectWikiGraphArchive(document: ReadonlyDocument, options: {
     readonly archiveUri: string;
     readonly chapterId?: number;
-}): Promise<WikiGraphArchiveInspectReport>;
+}): Promise<WikiGraphArchiveInspection>;
 
 interface WikiGraphOperationOptions {
     readonly signal?: AbortSignal;
@@ -83,16 +55,6 @@ type SearchIndexProgressEvent = Parameters<NonNullable<Parameters<typeof rebuild
 type WikiGraphChapterResetStage = Exclude<ChapterStage, "summarized">;
 type WikiGraphChapterSourceOptions = NonNullable<Parameters<typeof setChapterSource>[3]>;
 type WikiGraphChapterTreeInput = Parameters<typeof applyChapterTree>[1];
-interface WikiGraphArchiveLocation {
-    readonly archiveFile: File;
-    readonly archiveKey: string;
-    readonly archivePath: string;
-    readonly indexScope: QueryIndexScope;
-    readonly libraryArchiveTarget?: ParsedWikiGraphLibraryUri;
-    readonly libraryDirtyTarget?: ParsedWikiGraphLibraryUri;
-    readonly locatedUri: string;
-    readonly publicArchiveUri?: string;
-}
 interface WikiGraphArchiveCreateOptions extends WikiGraphOperationOptions {
     readonly importPath?: string;
     readonly onProgress?: WikiGraphProgressCallback;
@@ -186,19 +148,20 @@ declare class WikiGraphArchiveManager {
     #private;
     constructor(runtime: WikiGraphJobRuntime);
     create(options: WikiGraphArchiveCreateOptions): Promise<WikiGraphArchiveCreateResult>;
-    open(uriOrPath: string, options?: WikiGraphOperationOptions): Promise<WikiGraphArchiveHandle>;
+    open(target: WikiGraphArchiveTarget, options?: WikiGraphOperationOptions): Promise<WikiGraphArchiveHandle>;
 }
 declare class WikiGraphArchiveHandle {
     #private;
-    constructor(runtime: WikiGraphJobRuntime, location: WikiGraphArchiveLocation);
+    constructor(runtime: WikiGraphJobRuntime, location: unknown);
     get archiveKey(): string;
     get indexScope(): QueryIndexScope;
     get locatedUri(): string;
     get objectUri(): string;
     get path(): string;
+    get target(): WikiGraphArchiveTarget;
     inspect(options?: WikiGraphOperationOptions & {
         readonly chapterId?: number;
-    }): Promise<WikiGraphArchiveInspectReport>;
+    }): Promise<WikiGraphArchiveInspection>;
     search(query: string, options?: WikiGraphArchiveSearchOptions): Promise<ArchiveFindResult>;
     list(options?: WikiGraphArchiveListOptions): Promise<ArchiveCollectionResult | ArchiveSourceLocatorResult>;
     ensureSearchIndex(options?: WikiGraphArchiveScopeOptions & WikiGraphOperationOptions): Promise<void>;
@@ -244,6 +207,5 @@ declare class WikiGraphArchiveHandle {
     clearMetadata(objectPath: string, options?: WikiGraphArchiveWriteOptions): Promise<Readonly<Record<string, unknown>>>;
     resolveScope(options?: WikiGraphArchiveScopeOptions & WikiGraphOperationOptions): Promise<WikiGraphArchiveScope | undefined>;
 }
-declare function resolveWikiGraphArchiveLocation(uriOrPath: string): Promise<WikiGraphArchiveLocation>;
 
-export { type WikiGraphArchiveCover, type WikiGraphArchiveCreateOptions, type WikiGraphArchiveCreateResult, type WikiGraphArchiveEvidenceOptions, WikiGraphArchiveExistsError, WikiGraphArchiveHandle, type WikiGraphArchiveIndexStatus, type WikiGraphArchiveIndexSyncOptions, type WikiGraphArchiveInspectChapterReference, type WikiGraphArchiveInspectCoverage, type WikiGraphArchiveInspectImprovement, type WikiGraphArchiveInspectReport, type WikiGraphArchiveListOptions, type WikiGraphArchiveLocation, WikiGraphArchiveManager, type WikiGraphArchivePageOptions, type WikiGraphArchiveRelatedOptions, type WikiGraphArchiveScope, type WikiGraphArchiveScopeOptions, type WikiGraphArchiveSearchOptions, type WikiGraphArchiveWriteOptions, type WikiGraphChapterArtifactStatus, type WikiGraphChapterMoveOptions, type WikiGraphChapterResetStage, type WikiGraphChapterSourceOptions, type WikiGraphChapterTreeInput, type WikiGraphOperationOptions, createWikiGraphArchiveInspectReport, resolveWikiGraphArchiveLocation };
+export { type WikiGraphArchiveChapterInspection, type WikiGraphArchiveCover, type WikiGraphArchiveCreateOptions, type WikiGraphArchiveCreateResult, type WikiGraphArchiveEvidenceOptions, WikiGraphArchiveExistsError, WikiGraphArchiveHandle, type WikiGraphArchiveIndexArtifactInspection, type WikiGraphArchiveIndexStatus, type WikiGraphArchiveIndexSyncOptions, type WikiGraphArchiveInspection, type WikiGraphArchiveListOptions, WikiGraphArchiveManager, type WikiGraphArchivePageOptions, type WikiGraphArchiveRelatedOptions, type WikiGraphArchiveScope, type WikiGraphArchiveScopeOptions, type WikiGraphArchiveSearchOptions, WikiGraphArchiveTarget, type WikiGraphArchiveWriteOptions, type WikiGraphChapterArtifactStatus, type WikiGraphChapterMoveOptions, type WikiGraphChapterResetStage, type WikiGraphChapterSourceOptions, type WikiGraphChapterTreeInput, type WikiGraphOperationOptions, inspectWikiGraphArchive };