wiki-graph-sdk 0.8.0 → 0.8.1

package/dist/index.d.ts

@@ -4,22 +4,23 @@ import { W as WikiGraphArchiveTarget } from './target-CZ7elwmj.js';
 export { a as WikiGraphArchiveOwnershipError } from './target-CZ7elwmj.js';
 import { LocalConfigSection, LocalConfigObject } from './local-config.js';
 export { LOCAL_CONFIG_SECTIONS, clearLocalConfigSection, deleteLocalConfigValue, maskLocalConfigSection, normalizeLocalConfigKey, parseLocalConfigSection, putLocalConfigValue, readLocalConfigSection, replaceLocalConfigSection, validateLocalConfigSection } from './local-config.js';
-import { W as WikiGraphJobRuntime, a as WikiGraphJobManager } from './jobs-xIm_kshM.js';
-export { b as WikiGraphJob, c as WikiGraphJobBackend, d as WikiGraphJobChapterReference, e as WikiGraphJobCreateOptions, f as WikiGraphJobEnqueueOptions, g as WikiGraphJobEnqueuePlan, h as WikiGraphJobEnqueueResult, i as WikiGraphJobEventListener, j as WikiGraphJobEventsOptions, k as WikiGraphJobListOptions, l as WikiGraphJobSnapshot, m as WikiGraphJobSubscriptionOptions } from './jobs-xIm_kshM.js';
-import { ContinuationCursor, QueryIndexScope, ArchiveSourceLocatorResult, ArchiveCollectionResult, ArchiveFindResult, ArchiveEvidence, ArchiveRelatedResult, WikiGraphLibraryRecord, WikiGraphLibraryArchiveRecord, ParsedWikiGraphLibraryUri, WikiGraphLibraryIndexState, rebuildWikiGraphLibraryIndex, ArchiveFindOptions, ArchiveCollectionOptions, readWikiGraphLibraryPage, ArchivePage, listRelatedWikiGraphLibraryObjects, listWikiGraphLibraryEvidence, ArchivePack } from 'wiki-graph-core';
+import { W as WikiGraphJobRuntime, a as WikiGraphJobManager } from './jobs-CRK-DZ40.js';
+export { b as WikiGraphJob, c as WikiGraphJobBackend, d as WikiGraphJobChapterReference, e as WikiGraphJobCreateOptions, f as WikiGraphJobEnqueueOptions, g as WikiGraphJobEnqueuePlan, h as WikiGraphJobEnqueueResult, i as WikiGraphJobEventListener, j as WikiGraphJobEventsOptions, k as WikiGraphJobListOptions, l as WikiGraphJobSnapshot, m as WikiGraphJobSubscriptionOptions } from './jobs-CRK-DZ40.js';
+import { ContinuationCursor, QueryIndexScope, SearchIndexQueryMode, ArchiveSourceLocatorResult, ArchiveCollectionResult, ArchiveFindResult, ArchiveEvidence, ArchiveRelatedResult, WikiGraphLibraryRecord, WikiGraphLibraryArchiveRecord, ParsedWikiGraphLibraryUri, listWikiGraphLibraryEvidence, WikiGraphLibraryIndexState, rebuildWikiGraphLibraryIndex, ArchiveFindOptions, ArchiveCollectionOptions, readWikiGraphLibraryPage, ArchivePage, listRelatedWikiGraphLibraryObjects, ArchivePack } from 'wiki-graph-core';
 export { ArchiveBacklinkBucket, ArchiveBacklinks, ArchiveCollectionOptions, ArchiveCollectionResult, ArchiveEvidence, ArchiveEvidenceItem, ArchiveFindEvidencePreview, ArchiveFindHit, ArchiveFindOptions, ArchiveFindResult, ArchiveListItem, ArchivePack, ArchivePage, ArchiveRelatedResult, ArchiveSourceLocator, ArchiveSourceLocatorResult, ArchiveTriplePattern, BookMeta, BuildJobEvent, BuildJobProgressCounter, BuildJobTarget, ChapterDetails, ChapterEntry, ChapterStage, ChapterTree, ChapterTreeApplyResult, ContinuationCursor, DEFAULT_EXTRACTION_PROMPT, DEFAULT_KNOWLEDGE_GRAPH_RECALL_PROMPT, IndexArtifactKind, LLMPaymentRequiredError, LocatedWikiGraphUri, ParsedWikiGraphLibraryUri, QueryIndexScope, SearchIndexEmbeddingProvider, SourceArtifactInput, WIKI_GRAPH_URI_PREFIX, WikiGraphError, WikiGraphLLMOptions, WikiGraphLibraryIndexState, WikiGraphMaintenanceUpgradeResult, WikiGraphProgressCallback, WikiGraphProgressEvent, WikispineProvider, formatError, formatLocatedChapterResourceUri, formatLocatedChapterSourceCollectionUri, formatLocatedChapterUri, formatLocatedWikiGraphUri, formatWikiGraphCommandUri, formatWikiGraphLibraryUri, isSourceLocatorScopeUri, isWikiGraphLibraryUri, parseChapterPath, parseChapterTreeInput, parseChapterUriPath, parseLocatedWikiGraphUri, parseSourceTextJsonl, parseWikiGraphLibraryUri, parseWikiGraphUriSyntax, resolveExtractionPrompt, resolveKnowledgeGraphRecallPrompt } from 'wiki-graph-core';
 import { WikiGraphConversionManager } from './conversions.js';
 export { WikiGraphConversionFormat, WikiGraphConversionInput, WikiGraphConversionOptions, WikiGraphConversionResult, WikiGraphSourceFormat } from './conversions.js';
 export { WikiGraphQueueWorkerOptions, requireKnowledgeGraphWikispineConfig, runWikiGraphQueueWorker } from './default-worker.js';
 export { DANGEROUS_RUNTIME_ENV_NAMES, WikiGraphEntryEnvPolicy, WikiGraphEntryRuntimeContext, WikiGraphEntryRuntimeOptions, createEntryRuntimeContext } from './entry-context.js';
-export { QueryEmbeddingResult, WikiGraphEmbeddingConfig, WikiGraphEmbeddingProvider, buildSearchIndexEmbeddingProvider, embedQueryText, embedQueryTextWithLocalConfig, readWikiGraphEmbeddingConfig } from './embedding.js';
+export { QueryEmbeddingResult, WikiGraphEmbeddingConfig, WikiGraphEmbeddingProviderName, buildSearchIndexEmbeddingProvider, embedQueryText, embedQueryTextWithLocalConfig, readWikiGraphEmbeddingConfig } from './embedding.js';
 export { buildWikiGraphLLMOptions } from './llm.js';
 import { WikiGraphMaintenanceManager } from './maintenance.js';
 export { WikiGraphLegacyMigrationResult, WikiGraphMaintenanceTarget } from './maintenance.js';
 export { NodeDirectory, NodeFile, createNodeTemplateEnvironment, createNodeWikiGraphStorage, ensureNodeWikiGraphPlatform, getNodeResourcePath, installNodeWikiGraphPlatform, nodeWikiGraphPlatform, withNodeWikiGraphStorage, writeNodeFileHandle } from './node-platform.js';
 export { DEFAULT_GENERATION_JOB_CONCURRENCY, DEFAULT_GENERATION_REQUEST_CONCURRENCY, GenerationConcurrency, GenerationPerformanceHint, GenerationPlanningCost, createGenerationPerformanceHints, formatGenerationPlanningDuration, formatGenerationPlanningModel, planGenerationTask } from './planning.js';
-export { HostedProviderScope, WikiGraphProvider, WikiGraphRuntimeConfig, loadWikiGraphRuntimeConfig, resolveHostedProviderEndpoint, resolveWikispineConfig } from './runtime-config.js';
-export { createStageLLM, loadRequiredStageConfig } from './stage.js';
+import { W as WikiGraphSDKProviders } from './stage-BnWI3Rqt.js';
+export { a as WikiGraphEmbeddingProvider, b as WikiGraphLLMMessage, c as WikiGraphLLMProvider, d as WikiGraphLLMProviderEvent, e as WikiGraphLLMProviderOptions, f as createStageLLM, l as loadRequiredStageConfig, r as resolveWikiGraphLLMJSON } from './stage-BnWI3Rqt.js';
+export { HostedProviderScope, WikiGraphLLMConfig, WikiGraphProvider, WikiGraphRuntimeConfig, loadWikiGraphRuntimeConfig, resolveHostedProviderEndpoint, resolveWikispineConfig } from './runtime-config.js';
 export { nodeWikispineCommandRunner } from './wikispine.js';
 import 'zod';
 import 'node:fs/promises';
@@ -76,6 +77,7 @@ interface WikiGraphContinuationContext {
     readonly libraryQuery?: "archive-members" | "objects";
     readonly order?: "doc-asc" | "doc-desc";
     readonly query?: string;
+    readonly queryMode?: SearchIndexQueryMode;
     readonly role?: "any" | "object" | "self" | "subject" | undefined;
     readonly skipUnindexed?: boolean;
     readonly sourceContext?: number;
@@ -127,6 +129,8 @@ declare class WikiGraphContinuationManager {
 
 type WikiGraphLibraryTarget = ParsedWikiGraphLibraryUri | string;
 type WikiGraphLibrarySearchOptions = Omit<ArchiveFindOptions, "embeddingProvider">;
+type WikiGraphLibraryRelatedOptions = Omit<NonNullable<Parameters<typeof listRelatedWikiGraphLibraryObjects>[2]>, "embeddingProvider">;
+type WikiGraphLibraryEvidenceOptions = Omit<NonNullable<Parameters<typeof listWikiGraphLibraryEvidence>[2]>, "embeddingProvider">;
 type WikiGraphLibraryPageOptions = Omit<Parameters<typeof readWikiGraphLibraryPage>[2], "wikimediaResolver"> & {
     readonly signal?: AbortSignal;
 };
@@ -143,6 +147,15 @@ interface WikiGraphLibraryReplaceArchiveOptions {
     readonly inputPath: string;
     readonly target: WikiGraphLibraryTarget;
 }
+interface WikiGraphLibraryArchiveContent {
+    readonly mediaType: "application/vnd.wiki-graph.archive";
+    readonly size: number;
+    readonly stream: AsyncIterable<Uint8Array>;
+    readonly uri: string;
+}
+interface WikiGraphLibraryArchiveReadOptions {
+    readonly signal?: AbortSignal;
+}
 interface WikiGraphLibrarySnapshot extends Omit<WikiGraphLibraryRecord, "folder" | "staging"> {
     readonly folderPath: string;
 }
@@ -162,6 +175,7 @@ declare class WikiGraphLibraryManager {
     remove(target: WikiGraphLibraryTarget): Promise<WikiGraphLibrarySnapshot>;
     scan(target: WikiGraphLibraryTarget): Promise<WikiGraphLibraryScanSnapshot>;
     getArchive(target: WikiGraphLibraryTarget): Promise<WikiGraphLibraryArchiveSnapshot>;
+    readArchive<T>(target: WikiGraphLibraryTarget, consume: (content: WikiGraphLibraryArchiveContent) => Promise<T> | T, options?: WikiGraphLibraryArchiveReadOptions): Promise<T>;
     moveArchive(options: WikiGraphLibraryMoveArchiveOptions): Promise<WikiGraphLibraryArchiveSnapshot>;
     removeArchive(target: WikiGraphLibraryTarget): Promise<WikiGraphLibraryArchiveSnapshot>;
     replaceArchive(options: WikiGraphLibraryReplaceArchiveOptions): Promise<WikiGraphLibraryArchiveSnapshot>;
@@ -178,8 +192,8 @@ declare class WikiGraphLibraryManager {
     objects(target: WikiGraphLibraryTarget, options?: ArchiveCollectionOptions): Promise<ArchiveCollectionResult>;
     archiveMembers(target: WikiGraphLibraryTarget, options?: ArchiveCollectionOptions): Promise<ArchiveCollectionResult>;
     page(target: WikiGraphLibraryTarget, objectUri: string, options?: WikiGraphLibraryPageOptions): Promise<ArchivePage>;
-    related(target: WikiGraphLibraryTarget, objectUri: string, options?: Parameters<typeof listRelatedWikiGraphLibraryObjects>[2]): Promise<ArchiveRelatedResult>;
-    evidence(target: WikiGraphLibraryTarget, objectUri: string, options?: Parameters<typeof listWikiGraphLibraryEvidence>[2]): Promise<ArchiveEvidence>;
+    related(target: WikiGraphLibraryTarget, objectUri: string, options?: WikiGraphLibraryRelatedOptions): Promise<ArchiveRelatedResult>;
+    evidence(target: WikiGraphLibraryTarget, objectUri: string, options?: WikiGraphLibraryEvidenceOptions): Promise<ArchiveEvidence>;
     pack(target: WikiGraphLibraryTarget, objectUri: string, budget?: number): Promise<ArchivePack>;
     list(): Promise<readonly WikiGraphLibrary[]>;
 }
@@ -198,16 +212,19 @@ interface WikiGraphSDKRuntimeContext {
     readonly cwd: string;
     readonly env: NodeJS.ProcessEnv;
     readonly envPolicy: WikiGraphSDKEnvPolicy;
+    readonly providers?: WikiGraphSDKProviders;
     readonly stateDir?: string | undefined;
 }
 declare function withWikiGraphSDKRuntimeContext<T>(context: WikiGraphSDKRuntimeContext, operation: () => Promise<T> | T): Promise<T>;
 declare function getWikiGraphSDKRuntimeContext(): WikiGraphSDKRuntimeContext;
 declare function getWikiGraphSDKStateDir(): string | undefined;
+declare function getWikiGraphSDKProviders(): WikiGraphSDKProviders;
 
 interface WikiGraphSDKOptions {
     readonly cwd?: string;
     readonly env?: NodeJS.ProcessEnv;
     readonly envPolicy?: WikiGraphSDKEnvPolicy;
+    readonly providers?: WikiGraphSDKProviders;
     readonly stateDir?: string;
 }
 declare class WikiGraphSDK implements WikiGraphJobRuntime {
@@ -227,4 +244,4 @@ declare class WikiGraphSDK implements WikiGraphJobRuntime {
 }
 declare function createWikiGraphSDK(options?: WikiGraphSDKOptions): WikiGraphSDK;
 
-export { LocalConfigObject, LocalConfigSection, WikiGraphArchiveManager, WikiGraphArchiveTarget, WikiGraphConfigManager, type WikiGraphContinuationContext, WikiGraphContinuationManager, type WikiGraphContinuationOptions, type WikiGraphContinuationPage, WikiGraphConversionManager, WikiGraphJobManager, WikiGraphJobRuntime, WikiGraphLibrary, type WikiGraphLibraryAddArchiveOptions, type WikiGraphLibraryArchiveSnapshot, WikiGraphLibraryManager, type WikiGraphLibraryMoveArchiveOptions, type WikiGraphLibraryPageOptions, type WikiGraphLibraryReplaceArchiveOptions, type WikiGraphLibraryScanSnapshot, type WikiGraphLibrarySearchOptions, type WikiGraphLibrarySnapshot, type WikiGraphLibraryTarget, WikiGraphMaintenanceManager, type WikiGraphProviderTestResult, WikiGraphSDK, type WikiGraphSDKEnvPolicy, type WikiGraphSDKOptions, type WikiGraphSDKRuntimeContext, createWikiGraphSDK, getWikiGraphSDKRuntimeContext, getWikiGraphSDKStateDir, withWikiGraphSDKRuntimeContext };
+export { LocalConfigObject, LocalConfigSection, WikiGraphArchiveManager, WikiGraphArchiveTarget, WikiGraphConfigManager, type WikiGraphContinuationContext, WikiGraphContinuationManager, type WikiGraphContinuationOptions, type WikiGraphContinuationPage, WikiGraphConversionManager, WikiGraphJobManager, WikiGraphJobRuntime, WikiGraphLibrary, type WikiGraphLibraryAddArchiveOptions, type WikiGraphLibraryArchiveContent, type WikiGraphLibraryArchiveReadOptions, type WikiGraphLibraryArchiveSnapshot, type WikiGraphLibraryEvidenceOptions, WikiGraphLibraryManager, type WikiGraphLibraryMoveArchiveOptions, type WikiGraphLibraryPageOptions, type WikiGraphLibraryRelatedOptions, type WikiGraphLibraryReplaceArchiveOptions, type WikiGraphLibraryScanSnapshot, type WikiGraphLibrarySearchOptions, type WikiGraphLibrarySnapshot, type WikiGraphLibraryTarget, WikiGraphMaintenanceManager, type WikiGraphProviderTestResult, WikiGraphSDK, type WikiGraphSDKEnvPolicy, type WikiGraphSDKOptions, WikiGraphSDKProviders, type WikiGraphSDKRuntimeContext, createWikiGraphSDK, getWikiGraphSDKProviders, getWikiGraphSDKRuntimeContext, getWikiGraphSDKStateDir, withWikiGraphSDKRuntimeContext };