@swarmvaultai/engine 0.1.17 → 0.1.19

package/dist/index.d.ts

@@ -39,9 +39,10 @@ declare const agentTypeSchema: z.ZodEnum<{
     opencode: "opencode";
 }>;
 type AgentType = z.infer<typeof agentTypeSchema>;
-type PageKind = "index" | "source" | "module" | "concept" | "entity" | "output" | "insight";
+type PageKind = "index" | "source" | "module" | "concept" | "entity" | "output" | "insight" | "graph_report" | "community_summary";
 type Freshness = "fresh" | "stale";
 type ClaimStatus = "extracted" | "inferred" | "conflicted" | "stale";
+type EvidenceClass = "extracted" | "inferred" | "ambiguous";
 type Polarity = "positive" | "negative" | "neutral";
 type OutputOrigin = "query" | "explore";
 type OutputFormat = "markdown" | "report" | "slides" | "chart" | "image";
@@ -51,8 +52,8 @@ 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 CodeLanguage = "javascript" | "jsx" | "typescript" | "tsx" | "python" | "go" | "rust" | "java";
-type CodeSymbolKind = "function" | "class" | "interface" | "type_alias" | "enum" | "variable";
+type CodeLanguage = "javascript" | "jsx" | "typescript" | "tsx" | "python" | "go" | "rust" | "java" | "csharp" | "c" | "cpp" | "php";
+type CodeSymbolKind = "function" | "class" | "interface" | "type_alias" | "enum" | "variable" | "struct" | "trait";
 type OrchestrationRole = "research" | "audit" | "context" | "safety";
 declare const webSearchProviderTypeSchema: z.ZodEnum<{
     custom: "custom";
@@ -191,6 +192,7 @@ interface ResolvedPaths {
     graphPath: string;
     searchDbPath: string;
     compileStatePath: string;
+    codeIndexPath: string;
     jobsLogPath: string;
     sessionsDir: string;
     approvalsDir: string;
@@ -204,6 +206,23 @@ interface SourceAttachment {
 interface IngestOptions {
     includeAssets?: boolean;
     maxAssetSize?: number;
+    repoRoot?: string;
+    include?: string[];
+    exclude?: string[];
+    maxFiles?: number;
+    gitignore?: boolean;
+}
+interface DirectoryIngestSkip {
+    path: string;
+    reason: string;
+}
+interface DirectoryIngestResult {
+    inputDir: string;
+    repoRoot: string;
+    scannedCount: number;
+    imported: SourceManifest[];
+    updated: SourceManifest[];
+    skipped: DirectoryIngestSkip[];
 }
 interface SourceManifest {
     sourceId: string;
@@ -212,6 +231,7 @@ interface SourceManifest {
     sourceKind: SourceKind;
     language?: CodeLanguage;
     originalPath?: string;
+    repoRelativePath?: string;
     url?: string;
     storedPath: string;
     extractedTextPath?: string;
@@ -242,6 +262,8 @@ interface CodeImport {
     isTypeOnly?: boolean;
     isExternal: boolean;
     reExport: boolean;
+    resolvedSourceId?: string;
+    resolvedRepoPath?: string;
 }
 interface CodeDiagnostic {
     code: number;
@@ -263,13 +285,37 @@ interface CodeSymbol {
 interface CodeAnalysis {
     moduleId: string;
     language: CodeLanguage;
+    moduleName?: string;
+    namespace?: string;
     imports: CodeImport[];
     dependencies: string[];
     symbols: CodeSymbol[];
     exports: string[];
     diagnostics: CodeDiagnostic[];
 }
+interface SourceRationale {
+    id: string;
+    text: string;
+    citation: string;
+    kind: "docstring" | "comment" | "marker";
+    symbolName?: string;
+}
+interface CodeIndexEntry {
+    sourceId: string;
+    moduleId: string;
+    language: CodeLanguage;
+    repoRelativePath?: string;
+    originalPath?: string;
+    moduleName?: string;
+    namespace?: string;
+    aliases: string[];
+}
+interface CodeIndexArtifact {
+    generatedAt: string;
+    entries: CodeIndexEntry[];
+}
 interface SourceAnalysis {
+    analysisVersion: number;
     sourceId: string;
     sourceHash: string;
     schemaHash: string;
@@ -279,12 +325,13 @@ interface SourceAnalysis {
     entities: AnalyzedTerm[];
     claims: SourceClaim[];
     questions: string[];
+    rationales: SourceRationale[];
     code?: CodeAnalysis;
     producedAt: string;
 }
 interface GraphNode {
     id: string;
-    type: "source" | "concept" | "entity" | "module" | "symbol";
+    type: "source" | "concept" | "entity" | "module" | "symbol" | "rationale";
     label: string;
     pageId?: string;
     freshness?: Freshness;
@@ -305,6 +352,7 @@ interface GraphEdge {
     target: string;
     relation: string;
     status: ClaimStatus;
+    evidenceClass: EvidenceClass;
     confidence: number;
     provenance: string[];
 }
@@ -346,6 +394,56 @@ interface GraphArtifact {
     sources: SourceManifest[];
     pages: GraphPage[];
 }
+interface GraphQueryMatch {
+    type: "node" | "page";
+    id: string;
+    label: string;
+    score: number;
+}
+interface GraphQueryResult {
+    question: string;
+    traversal: "bfs" | "dfs";
+    seedNodeIds: string[];
+    seedPageIds: string[];
+    visitedNodeIds: string[];
+    visitedEdgeIds: string[];
+    pageIds: string[];
+    communities: string[];
+    summary: string;
+    matches: GraphQueryMatch[];
+}
+interface GraphPathResult {
+    from: string;
+    to: string;
+    resolvedFromNodeId?: string;
+    resolvedToNodeId?: string;
+    found: boolean;
+    nodeIds: string[];
+    edgeIds: string[];
+    pageIds: string[];
+    summary: string;
+}
+interface GraphExplainNeighbor {
+    nodeId: string;
+    label: string;
+    type: GraphNode["type"];
+    pageId?: string;
+    relation: string;
+    direction: "incoming" | "outgoing";
+    confidence: number;
+    evidenceClass: EvidenceClass;
+}
+interface GraphExplainResult {
+    target: string;
+    node: GraphNode;
+    page?: GraphPage;
+    community?: {
+        id: string;
+        label: string;
+    };
+    neighbors: GraphExplainNeighbor[];
+    summary: string;
+}
 interface ApprovalEntry {
     pageId: string;
     title: string;
@@ -694,6 +792,7 @@ declare function initWorkspace(rootDir: string): Promise<{
 }>;
 
 declare function ingestInput(rootDir: string, input: string, options?: IngestOptions): Promise<SourceManifest>;
+declare function ingestDirectory(rootDir: string, inputDir: string, options?: IngestOptions): Promise<DirectoryIngestResult>;
 declare function importInbox(rootDir: string, inputDir?: string): Promise<InboxImportResult>;
 declare function listManifests(rootDir: string): Promise<SourceManifest[]>;
 declare function readExtractedText(rootDir: string, manifest: SourceManifest): Promise<string | undefined>;
@@ -739,6 +838,13 @@ declare function compileVault(rootDir: string, options?: CompileOptions): Promis
 declare function queryVault(rootDir: string, options: QueryOptions): Promise<QueryResult>;
 declare function exploreVault(rootDir: string, options: ExploreOptions): Promise<ExploreResult>;
 declare function searchVault(rootDir: string, query: string, limit?: number): Promise<SearchResult[]>;
+declare function queryGraphVault(rootDir: string, question: string, options?: {
+    traversal?: "bfs" | "dfs";
+    budget?: number;
+}): Promise<GraphQueryResult>;
+declare function pathGraphVault(rootDir: string, from: string, to: string): Promise<GraphPathResult>;
+declare function explainGraphVault(rootDir: string, target: string): Promise<GraphExplainResult>;
+declare function listGodNodes(rootDir: string, limit?: number): Promise<GraphNode[]>;
 declare function listPages(rootDir: string): Promise<GraphPage[]>;
 declare function readPage(rootDir: string, relativePath: string): Promise<{
     path: string;
@@ -775,4 +881,4 @@ declare function watchVault(rootDir: string, options?: WatchOptions): Promise<Wa
 declare function createWebSearchAdapter(id: string, config: WebSearchProviderConfig, rootDir: string): Promise<WebSearchAdapter>;
 declare function getWebSearchAdapterForTask(rootDir: string, task: "deepLintProvider"): Promise<WebSearchAdapter>;
 
-export { type AgentType, type AnalyzedTerm, type ApprovalChangeType, type ApprovalDetail, type ApprovalEntry, type ApprovalEntryDetail, type ApprovalEntryStatus, type ApprovalManifest, type ApprovalSummary, type CandidateRecord, type ChartDatum, type ChartSpec, type ClaimStatus, type CodeAnalysis, type CodeDiagnostic, type CodeImport, type CodeLanguage, type CodeSymbol, type CodeSymbolKind, type CommandRoleExecutorConfig, type CompileOptions, type CompileResult, type CompileState, type ExploreOptions, type ExploreResult, type ExploreStepResult, type Freshness, type GenerationAttachment, type GenerationRequest, type GenerationResponse, type GraphArtifact, type GraphEdge, type GraphNode, type GraphPage, type ImageGenerationRequest, type ImageGenerationResponse, type InboxImportResult, type InboxImportSkip, type IngestOptions, type InitOptions, 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 Polarity, type ProviderAdapter, type ProviderCapability, type ProviderConfig, type ProviderRoleExecutorConfig, type ProviderType, type QueryOptions, type QueryResult, 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 SourceKind, type SourceManifest, type VaultConfig, type WatchController, type WatchOptions, type WatchRunRecord, type WebSearchAdapter, type WebSearchProviderConfig, type WebSearchProviderType, type WebSearchResult, acceptApproval, agentTypeSchema, archiveCandidate, assertProviderCapability, bootstrapDemo, compileVault, createMcpServer, createProvider, createWebSearchAdapter, defaultVaultConfig, defaultVaultSchema, exploreVault, exportGraphHtml, getProviderForTask, getWebSearchAdapterForTask, getWorkspaceInfo, importInbox, ingestInput, initVault, initWorkspace, installAgent, installConfiguredAgents, lintVault, listApprovals, listCandidates, listManifests, listPages, listSchedules, loadVaultConfig, loadVaultSchema, loadVaultSchemas, promoteCandidate, providerCapabilitySchema, providerTypeSchema, queryVault, readApproval, readExtractedText, readPage, rejectApproval, resolvePaths, runSchedule, searchVault, serveSchedules, startGraphServer, startMcpServer, watchVault, webSearchProviderTypeSchema };
+export { type AgentType, type AnalyzedTerm, type ApprovalChangeType, type ApprovalDetail, type ApprovalEntry, type ApprovalEntryDetail, type ApprovalEntryStatus, type ApprovalManifest, type ApprovalSummary, 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 Freshness, type GenerationAttachment, type GenerationRequest, type GenerationResponse, type GraphArtifact, type GraphEdge, type GraphExplainNeighbor, type GraphExplainResult, type GraphNode, type GraphPage, type GraphPathResult, type GraphQueryMatch, type GraphQueryResult, type ImageGenerationRequest, type ImageGenerationResponse, type InboxImportResult, type InboxImportSkip, type IngestOptions, type InitOptions, 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 Polarity, type ProviderAdapter, type ProviderCapability, type ProviderConfig, type ProviderRoleExecutorConfig, type ProviderType, type QueryOptions, type QueryResult, 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 SourceKind, type SourceManifest, type SourceRationale, type VaultConfig, type WatchController, type WatchOptions, type WatchRunRecord, type WebSearchAdapter, type WebSearchProviderConfig, type WebSearchProviderType, type WebSearchResult, acceptApproval, agentTypeSchema, archiveCandidate, assertProviderCapability, bootstrapDemo, compileVault, createMcpServer, createProvider, createWebSearchAdapter, defaultVaultConfig, defaultVaultSchema, explainGraphVault, exploreVault, exportGraphHtml, getProviderForTask, getWebSearchAdapterForTask, getWorkspaceInfo, importInbox, ingestDirectory, ingestInput, initVault, initWorkspace, installAgent, installConfiguredAgents, lintVault, listApprovals, listCandidates, listGodNodes, listManifests, listPages, listSchedules, loadVaultConfig, loadVaultSchema, loadVaultSchemas, pathGraphVault, promoteCandidate, providerCapabilitySchema, providerTypeSchema, queryGraphVault, queryVault, readApproval, readExtractedText, readPage, rejectApproval, resolvePaths, runSchedule, searchVault, serveSchedules, startGraphServer, startMcpServer, watchVault, webSearchProviderTypeSchema };