@swarmvaultai/engine 0.1.22 → 0.1.24

package/dist/index.d.ts

@@ -53,6 +53,7 @@ type PageManager = "system" | "human";
 type ApprovalEntryStatus = "pending" | "accepted" | "rejected";
 type ApprovalChangeType = "create" | "update" | "delete" | "promote";
 type SourceKind = "markdown" | "text" | "pdf" | "image" | "html" | "binary" | "code";
+type SourceCaptureType = "arxiv" | "doi" | "tweet" | "article" | "url";
 type CodeLanguage = "javascript" | "jsx" | "typescript" | "tsx" | "python" | "go" | "rust" | "java" | "csharp" | "c" | "cpp" | "php" | "ruby" | "powershell";
 type CodeSymbolKind = "function" | "class" | "interface" | "type_alias" | "enum" | "variable" | "struct" | "trait";
 type OrchestrationRole = "research" | "audit" | "context" | "safety";
@@ -163,6 +164,11 @@ interface VaultConfig {
     agents: AgentType[];
     schedules?: Record<string, ScheduleJobConfig>;
     orchestration?: OrchestrationConfig;
+    benchmark?: {
+        enabled?: boolean;
+        questions?: string[];
+        maxQuestions?: number;
+    };
     webSearch?: {
         providers: Record<string, WebSearchProviderConfig>;
         tasks: {
@@ -265,6 +271,7 @@ interface SourceManifest {
     title: string;
     originType: "file" | "url";
     sourceKind: SourceKind;
+    sourceType?: SourceCaptureType;
     language?: CodeLanguage;
     originalPath?: string;
     repoRelativePath?: string;
@@ -394,12 +401,24 @@ interface GraphEdge {
     evidenceClass: EvidenceClass;
     confidence: number;
     provenance: string[];
+    similarityReasons?: Array<"shared_concept" | "shared_entity" | "shared_tag" | "shared_symbol" | "shared_rationale_theme" | "shared_source_type">;
+}
+interface GraphHyperedge {
+    id: string;
+    label: string;
+    relation: "participate_in" | "implement" | "form";
+    nodeIds: string[];
+    evidenceClass: EvidenceClass;
+    confidence: number;
+    sourcePageIds: string[];
+    why: string;
 }
 interface GraphPage {
     id: string;
     path: string;
     title: string;
     kind: PageKind;
+    sourceType?: SourceCaptureType;
     sourceIds: string[];
     projectIds: string[];
     nodeIds: string[];
@@ -425,6 +444,7 @@ interface GraphArtifact {
     generatedAt: string;
     nodes: GraphNode[];
     edges: GraphEdge[];
+    hyperedges: GraphHyperedge[];
     communities?: Array<{
         id: string;
         label: string;
@@ -434,7 +454,7 @@ interface GraphArtifact {
     pages: GraphPage[];
 }
 interface GraphQueryMatch {
-    type: "node" | "page";
+    type: "node" | "page" | "hyperedge";
     id: string;
     label: string;
     score: number;
@@ -446,6 +466,7 @@ interface GraphQueryResult {
     seedPageIds: string[];
     visitedNodeIds: string[];
     visitedEdgeIds: string[];
+    hyperedgeIds: string[];
     pageIds: string[];
     communities: string[];
     summary: string;
@@ -481,6 +502,7 @@ interface GraphExplainResult {
         label: string;
     };
     neighbors: GraphExplainNeighbor[];
+    hyperedges: GraphHyperedge[];
     summary: string;
 }
 interface ApprovalEntry {
@@ -554,6 +576,7 @@ interface SearchResult {
     kind?: PageKind;
     status?: PageStatus;
     projectIds: string[];
+    sourceType?: SourceCaptureType;
 }
 interface QueryOptions {
     question: string;
@@ -771,7 +794,7 @@ interface AddOptions extends IngestOptions {
     contributor?: string;
 }
 interface AddResult {
-    captureType: "arxiv" | "tweet" | "url";
+    captureType: SourceCaptureType;
     manifest: SourceManifest;
     normalizedUrl: string;
     title: string;
@@ -782,10 +805,20 @@ interface BenchmarkQuestionResult {
     queryTokens: number;
     reduction: number;
     visitedNodeIds: string[];
+    visitedEdgeIds: string[];
     pageIds: string[];
 }
+interface BenchmarkSummary {
+    questionCount: number;
+    uniqueVisitedNodes: number;
+    finalContextTokens: number;
+    naiveCorpusTokens: number;
+    avgReduction: number;
+    reductionRatio: number;
+}
 interface BenchmarkArtifact {
     generatedAt: string;
+    graphHash: string;
     corpusWords: number;
     corpusTokens: number;
     nodes: number;
@@ -794,9 +827,81 @@ interface BenchmarkArtifact {
     reductionRatio: number;
     sampleQuestions: string[];
     perQuestion: BenchmarkQuestionResult[];
+    questionResults: BenchmarkQuestionResult[];
+    summary: BenchmarkSummary;
 }
 interface BenchmarkOptions {
     questions?: string[];
+    maxQuestions?: number;
+}
+interface GraphReportArtifact {
+    generatedAt: string;
+    graphHash: string;
+    overview: {
+        nodes: number;
+        edges: number;
+        pages: number;
+        communities: number;
+    };
+    benchmark?: {
+        generatedAt: string;
+        stale: boolean;
+        summary: BenchmarkSummary;
+        questionCount: number;
+    };
+    godNodes: Array<{
+        nodeId: string;
+        label: string;
+        pageId?: string;
+        degree?: number;
+        bridgeScore?: number;
+    }>;
+    bridgeNodes: Array<{
+        nodeId: string;
+        label: string;
+        pageId?: string;
+        degree?: number;
+        bridgeScore?: number;
+    }>;
+    thinCommunities: Array<{
+        id: string;
+        label: string;
+        nodeCount: number;
+        pageId?: string;
+        path?: string;
+        title?: string;
+    }>;
+    surprisingConnections: Array<{
+        id: string;
+        sourceNodeId: string;
+        sourceLabel: string;
+        targetNodeId: string;
+        targetLabel: string;
+        relation: string;
+        evidenceClass: EvidenceClass;
+        confidence: number;
+        pathNodeIds: string[];
+        pathEdgeIds: string[];
+        pathRelations: string[];
+        pathEvidenceClasses: EvidenceClass[];
+        pathSummary: string;
+        why: string;
+        explanation: string;
+    }>;
+    groupPatterns: GraphHyperedge[];
+    suggestedQuestions: string[];
+    communityPages: Array<{
+        id: string;
+        path: string;
+        title: string;
+    }>;
+    recentResearchSources: Array<{
+        pageId: string;
+        path: string;
+        title: string;
+        sourceType: SourceCaptureType;
+        updatedAt: string;
+    }>;
 }
 interface ScheduledCompileTask {
     type: "compile";
@@ -972,6 +1077,8 @@ declare function queryGraphVault(rootDir: string, question: string, options?: {
 declare function benchmarkVault(rootDir: string, options?: BenchmarkOptions): Promise<BenchmarkArtifact>;
 declare function pathGraphVault(rootDir: string, from: string, to: string): Promise<GraphPathResult>;
 declare function explainGraphVault(rootDir: string, target: string): Promise<GraphExplainResult>;
+declare function listGraphHyperedges(rootDir: string, target?: string, limit?: number): Promise<GraphHyperedge[]>;
+declare function readGraphReport(rootDir: string): Promise<GraphReportArtifact | null>;
 declare function listGodNodes(rootDir: string, limit?: number): Promise<GraphNode[]>;
 declare function listPages(rootDir: string): Promise<GraphPage[]>;
 declare function readPage(rootDir: string, relativePath: string): Promise<{
@@ -1025,4 +1132,4 @@ declare function getWatchStatus(rootDir: string): Promise<WatchStatusResult>;
 declare function createWebSearchAdapter(id: string, config: WebSearchProviderConfig, rootDir: string): Promise<WebSearchAdapter>;
 declare function getWebSearchAdapterForTask(rootDir: string, task: "deepLintProvider"): Promise<WebSearchAdapter>;
 
-export { type AddOptions, type AddResult, type AgentType, type AnalyzedTerm, type ApprovalChangeType, type ApprovalDetail, type ApprovalEntry, type ApprovalEntryDetail, type ApprovalEntryStatus, type ApprovalManifest, type ApprovalSummary, type BenchmarkArtifact, type BenchmarkOptions, type BenchmarkQuestionResult, type CandidateRecord, type ChartDatum, type ChartSpec, type ClaimStatus, type CodeAnalysis, type CodeDiagnostic, type CodeImport, type CodeIndexArtifact, type CodeIndexEntry, type CodeLanguage, type CodeSymbol, type CodeSymbolKind, type CommandRoleExecutorConfig, type CompileOptions, type CompileResult, type CompileState, type DirectoryIngestResult, type DirectoryIngestSkip, type EvidenceClass, type ExploreOptions, type ExploreResult, type ExploreStepResult, type ExtractionClaim, type ExtractionKind, type ExtractionTerm, type Freshness, type GenerationAttachment, type GenerationRequest, type GenerationResponse, type GitHookStatus, type GraphArtifact, type GraphEdge, type GraphExplainNeighbor, type GraphExplainResult, type GraphExportFormat, type GraphExportResult, type GraphNode, type GraphPage, type GraphPathResult, type GraphQueryMatch, type GraphQueryResult, type ImageGenerationRequest, type ImageGenerationResponse, type ImageVisionExtraction, type InboxImportResult, type InboxImportSkip, type IngestOptions, type InitOptions, type InstallAgentOptions, type LintFinding, type LintOptions, type OrchestrationConfig, type OrchestrationFinding, type OrchestrationProposal, type OrchestrationRole, type OrchestrationRoleConfig, type OrchestrationRoleResult, type OutputAsset, type OutputAssetRole, type OutputFormat, type OutputOrigin, type PageKind, type PageManager, type PageStatus, type PendingSemanticRefreshEntry, type Polarity, type ProviderAdapter, type ProviderCapability, type ProviderConfig, type ProviderRoleExecutorConfig, type ProviderType, type QueryOptions, type QueryResult, type RepoSyncResult, type ResolvedPaths, type ReviewActionResult, type RoleExecutorConfig, type SceneElement, type SceneSpec, type ScheduleController, type ScheduleJobConfig, type ScheduleStateRecord, type ScheduleTriggerConfig, type ScheduledCompileTask, type ScheduledExploreTask, type ScheduledLintTask, type ScheduledQueryTask, type ScheduledRunResult, type ScheduledTaskConfig, type SearchResult, type SourceAnalysis, type SourceAttachment, type SourceClaim, type SourceExtractionArtifact, type SourceKind, type SourceManifest, type SourceRationale, type VaultConfig, type WatchController, type WatchOptions, type WatchRepoSyncResult, type WatchRunRecord, type WatchStatusResult, type WebSearchAdapter, type WebSearchProviderConfig, type WebSearchProviderType, type WebSearchResult, acceptApproval, addInput, agentTypeSchema, archiveCandidate, assertProviderCapability, benchmarkVault, bootstrapDemo, compileVault, createMcpServer, createProvider, createWebSearchAdapter, defaultVaultConfig, defaultVaultSchema, explainGraphVault, exploreVault, exportGraphFormat, exportGraphHtml, getGitHookStatus, getProviderForTask, getWatchStatus, getWebSearchAdapterForTask, getWorkspaceInfo, importInbox, ingestDirectory, ingestInput, initVault, initWorkspace, installAgent, installConfiguredAgents, installGitHooks, lintVault, listApprovals, listCandidates, listGodNodes, listManifests, listPages, listSchedules, listTrackedRepoRoots, loadVaultConfig, loadVaultSchema, loadVaultSchemas, pathGraphVault, promoteCandidate, providerCapabilitySchema, providerTypeSchema, queryGraphVault, queryVault, readApproval, readExtractedText, readPage, rejectApproval, resolvePaths, runSchedule, runWatchCycle, searchVault, serveSchedules, startGraphServer, startMcpServer, syncTrackedRepos, syncTrackedReposForWatch, uninstallGitHooks, watchVault, webSearchProviderTypeSchema };
+export { type AddOptions, type AddResult, type AgentType, type AnalyzedTerm, type ApprovalChangeType, type ApprovalDetail, type ApprovalEntry, type ApprovalEntryDetail, type ApprovalEntryStatus, type ApprovalManifest, type ApprovalSummary, type BenchmarkArtifact, type BenchmarkOptions, type BenchmarkQuestionResult, type BenchmarkSummary, type CandidateRecord, type ChartDatum, type ChartSpec, type ClaimStatus, type CodeAnalysis, type CodeDiagnostic, type CodeImport, type CodeIndexArtifact, type CodeIndexEntry, type CodeLanguage, type CodeSymbol, type CodeSymbolKind, type CommandRoleExecutorConfig, type CompileOptions, type CompileResult, type CompileState, type DirectoryIngestResult, type DirectoryIngestSkip, type EvidenceClass, type ExploreOptions, type ExploreResult, type ExploreStepResult, type ExtractionClaim, type ExtractionKind, type ExtractionTerm, type Freshness, type GenerationAttachment, type GenerationRequest, type GenerationResponse, type GitHookStatus, type GraphArtifact, type GraphEdge, type GraphExplainNeighbor, type GraphExplainResult, type GraphExportFormat, type GraphExportResult, type GraphHyperedge, type GraphNode, type GraphPage, type GraphPathResult, type GraphQueryMatch, type GraphQueryResult, type GraphReportArtifact, type ImageGenerationRequest, type ImageGenerationResponse, type ImageVisionExtraction, type InboxImportResult, type InboxImportSkip, type IngestOptions, type InitOptions, type InstallAgentOptions, type LintFinding, type LintOptions, type OrchestrationConfig, type OrchestrationFinding, type OrchestrationProposal, type OrchestrationRole, type OrchestrationRoleConfig, type OrchestrationRoleResult, type OutputAsset, type OutputAssetRole, type OutputFormat, type OutputOrigin, type PageKind, type PageManager, type PageStatus, type PendingSemanticRefreshEntry, type Polarity, type ProviderAdapter, type ProviderCapability, type ProviderConfig, type ProviderRoleExecutorConfig, type ProviderType, type QueryOptions, type QueryResult, type RepoSyncResult, type ResolvedPaths, type ReviewActionResult, type RoleExecutorConfig, type SceneElement, type SceneSpec, type ScheduleController, type ScheduleJobConfig, type ScheduleStateRecord, type ScheduleTriggerConfig, type ScheduledCompileTask, type ScheduledExploreTask, type ScheduledLintTask, type ScheduledQueryTask, type ScheduledRunResult, type ScheduledTaskConfig, type SearchResult, type SourceAnalysis, type SourceAttachment, type SourceCaptureType, type SourceClaim, type SourceExtractionArtifact, type SourceKind, type SourceManifest, type SourceRationale, type VaultConfig, type WatchController, type WatchOptions, type WatchRepoSyncResult, type WatchRunRecord, type WatchStatusResult, type WebSearchAdapter, type WebSearchProviderConfig, type WebSearchProviderType, type WebSearchResult, acceptApproval, addInput, agentTypeSchema, archiveCandidate, assertProviderCapability, benchmarkVault, bootstrapDemo, compileVault, createMcpServer, createProvider, createWebSearchAdapter, defaultVaultConfig, defaultVaultSchema, explainGraphVault, exploreVault, exportGraphFormat, exportGraphHtml, getGitHookStatus, getProviderForTask, getWatchStatus, getWebSearchAdapterForTask, getWorkspaceInfo, importInbox, ingestDirectory, ingestInput, initVault, initWorkspace, installAgent, installConfiguredAgents, installGitHooks, lintVault, listApprovals, listCandidates, listGodNodes, listGraphHyperedges, listManifests, listPages, listSchedules, listTrackedRepoRoots, loadVaultConfig, loadVaultSchema, loadVaultSchemas, pathGraphVault, promoteCandidate, providerCapabilitySchema, providerTypeSchema, queryGraphVault, queryVault, readApproval, readExtractedText, readGraphReport, readPage, rejectApproval, resolvePaths, runSchedule, runWatchCycle, searchVault, serveSchedules, startGraphServer, startMcpServer, syncTrackedRepos, syncTrackedReposForWatch, uninstallGitHooks, watchVault, webSearchProviderTypeSchema };