@swarmvaultai/engine 0.10.0 → 0.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -239,6 +239,29 @@ interface VaultConfig {
239
239
  };
240
240
  graph?: {
241
241
  communityResolution?: number;
242
+ /**
243
+ * Minimum IDF weight a similarity feature must carry to contribute to an
244
+ * inferred `semantically_similar_to` edge. Features below the floor are
245
+ * dropped entirely. Defaults to 0.5.
246
+ */
247
+ similarityIdfFloor?: number;
248
+ /**
249
+ * Hard cap on the number of inferred similarity edges emitted. Defaults
250
+ * to `min(5 * nodeCount, 20000)` so very large repos do not produce
251
+ * O(n²) similarity fan-out.
252
+ */
253
+ similarityEdgeCap?: number;
254
+ /**
255
+ * Upper bound on god-node entries surfaced in the graph report and
256
+ * tooling. Defaults to 20 for small repos and 10 for large ones.
257
+ */
258
+ godNodeLimit?: number;
259
+ /**
260
+ * Report rollup threshold: communities with fewer members than this are
261
+ * folded into the fragmented-community rollup instead of listed
262
+ * individually. Defaults to `max(3, ceil(totalCommunities / 50))`.
263
+ */
264
+ foldCommunitiesBelow?: number;
242
265
  };
243
266
  webSearch?: {
244
267
  providers: Record<string, WebSearchProviderConfig>;
@@ -259,6 +282,15 @@ interface VaultConfig {
259
282
  redaction?: RedactionSettings;
260
283
  freshness?: FreshnessConfig;
261
284
  consolidation?: ConsolidationConfig;
285
+ watch?: WatchConfig;
286
+ }
287
+ /**
288
+ * Explicit user control over which repository roots `swarmvault watch --repo` tracks.
289
+ * Absent config preserves the existing auto-discovery behavior over managed sources and manifests.
290
+ */
291
+ interface WatchConfig {
292
+ repoRoots?: string[];
293
+ excludeRepoRoots?: string[];
262
294
  }
263
295
  /**
264
296
  * Heuristic configuration for the LLM Wiki v2 consolidation tier rollup.
@@ -602,7 +634,14 @@ interface SourceRationale {
602
634
  id: string;
603
635
  text: string;
604
636
  citation: string;
605
- kind: "docstring" | "comment" | "marker";
637
+ /**
638
+ * Structural kind for code rationales (`docstring`, `comment`, `marker`) or
639
+ * the lowercased fixed-prefix marker for non-code rationales (`note`,
640
+ * `why`, `hack`, `important`, `rationale`, `todo`, `fixme`, `warning`,
641
+ * `warn`). Non-code kinds are parser-selected from markdown blockquotes /
642
+ * list items and plain-text paragraphs, never swept from whole files.
643
+ */
644
+ kind: "docstring" | "comment" | "marker" | "note" | "why" | "hack" | "important" | "rationale" | "todo" | "fixme" | "warning" | "warn";
606
645
  symbolName?: string;
607
646
  }
608
647
  interface CodeIndexEntry {
@@ -656,6 +695,11 @@ interface GraphNode {
656
695
  degree?: number;
657
696
  bridgeScore?: number;
658
697
  isGodNode?: boolean;
698
+ /**
699
+ * Human-readable explanation of why this node was flagged as a god-node
700
+ * (high-degree hub). Populated for god nodes only. Deterministic.
701
+ */
702
+ surpriseReason?: string;
659
703
  tags?: string[];
660
704
  }
661
705
  /**
@@ -1049,6 +1093,7 @@ interface WatchOptions {
1049
1093
  debounceMs?: number;
1050
1094
  repo?: boolean;
1051
1095
  codeOnly?: boolean;
1096
+ overrideRoots?: string[];
1052
1097
  }
1053
1098
  interface PendingSemanticRefreshEntry {
1054
1099
  id: string;
@@ -1382,6 +1427,27 @@ interface BenchmarkSummary {
1382
1427
  avgReduction: number;
1383
1428
  reductionRatio: number;
1384
1429
  }
1430
+ /**
1431
+ * Per-source-class slice of a benchmark run. The graph-guided tokens are
1432
+ * computed against the same traversal seeds that produced the corpus-wide
1433
+ * numbers, then narrowed to nodes/edges/pages whose `sourceClass` matches
1434
+ * this class. The naive tokens come from manifests whose
1435
+ * {@link SourceManifest.sourceClass} matches this class. Empty classes are
1436
+ * represented as zeroed entries rather than being omitted so downstream
1437
+ * consumers never have to branch on `undefined`.
1438
+ */
1439
+ interface BenchmarkByClassEntry {
1440
+ sourceClass: SourceClass;
1441
+ sourceCount: number;
1442
+ pageCount: number;
1443
+ nodeCount: number;
1444
+ godNodeCount: number;
1445
+ corpusWords: number;
1446
+ corpusTokens: number;
1447
+ finalContextTokens: number;
1448
+ reductionRatio: number;
1449
+ perQuestion: BenchmarkQuestionResult[];
1450
+ }
1385
1451
  interface BenchmarkArtifact {
1386
1452
  generatedAt: string;
1387
1453
  graphHash: string;
@@ -1394,6 +1460,7 @@ interface BenchmarkArtifact {
1394
1460
  sampleQuestions: string[];
1395
1461
  perQuestion: BenchmarkQuestionResult[];
1396
1462
  summary: BenchmarkSummary;
1463
+ byClass: Record<SourceClass, BenchmarkByClassEntry>;
1397
1464
  }
1398
1465
  interface EmbeddingCacheEntry {
1399
1466
  itemId: string;
@@ -1439,6 +1506,21 @@ interface GraphReportArtifact {
1439
1506
  stale: boolean;
1440
1507
  summary: BenchmarkSummary;
1441
1508
  questionCount: number;
1509
+ /**
1510
+ * Compact per-source-class mirror of the benchmark summary. Populated
1511
+ * from {@link BenchmarkArtifact.byClass} whenever the benchmark artifact
1512
+ * is available at report build time. Kept optional so older benchmark
1513
+ * files without a `byClass` field still produce a valid report.
1514
+ */
1515
+ byClass?: Record<SourceClass, {
1516
+ sourceCount: number;
1517
+ pageCount: number;
1518
+ nodeCount: number;
1519
+ godNodeCount: number;
1520
+ finalContextTokens: number;
1521
+ naiveCorpusTokens: number;
1522
+ reductionRatio: number;
1523
+ }>;
1442
1524
  };
1443
1525
  godNodes: Array<{
1444
1526
  nodeId: string;
@@ -1446,6 +1528,12 @@ interface GraphReportArtifact {
1446
1528
  pageId?: string;
1447
1529
  degree?: number;
1448
1530
  bridgeScore?: number;
1531
+ /**
1532
+ * Deterministic one-line explanation of why the node is surfaced as a
1533
+ * god-node — e.g. "degree 42 across 7 communities" or
1534
+ * "degree 38 (2.1σ above mean)". Omitted when no degree signal exists.
1535
+ */
1536
+ surpriseReason?: string;
1449
1537
  }>;
1450
1538
  bridgeNodes: Array<{
1451
1539
  nodeId: string;
@@ -1787,6 +1875,61 @@ declare function runDecayPass(input: {
1787
1875
  markedStale: string[];
1788
1876
  }>;
1789
1877
 
1878
+ /**
1879
+ * Viewer-only hub node synthesized from a group-pattern hyperedge. Hubs are
1880
+ * never written back to `state/graph.json` — callers can treat them as
1881
+ * transient UI scaffolding that turns a single `GraphHyperedge` into a tiny
1882
+ * star of pairwise edges that Cytoscape (or vis.js) can render natively.
1883
+ */
1884
+ type SynthesizedHubNode = {
1885
+ id: string;
1886
+ hyperedgeId: string;
1887
+ label: string;
1888
+ relation: string;
1889
+ participantIds: string[];
1890
+ confidence: number;
1891
+ evidenceClass: string;
1892
+ why: string;
1893
+ };
1894
+ /**
1895
+ * Viewer-only edge that connects a synthesized hub to one of the hyperedge
1896
+ * participants. IDs are stable across renders so Cytoscape can reuse them and
1897
+ * tests can assert their presence.
1898
+ */
1899
+ type SynthesizedHubEdge = {
1900
+ id: string;
1901
+ hyperedgeId: string;
1902
+ source: string;
1903
+ target: string;
1904
+ relation: string;
1905
+ confidence: number;
1906
+ evidenceClass: string;
1907
+ };
1908
+ type SynthesizedHyperedgeHubs = {
1909
+ hubNodes: SynthesizedHubNode[];
1910
+ hubEdges: SynthesizedHubEdge[];
1911
+ };
1912
+ type MinimalHyperedge = {
1913
+ id: string;
1914
+ label: string;
1915
+ relation: string;
1916
+ nodeIds: string[];
1917
+ confidence?: number;
1918
+ evidenceClass?: string;
1919
+ why?: string;
1920
+ };
1921
+ type MinimalNode = {
1922
+ id: string;
1923
+ };
1924
+ /**
1925
+ * Turn every group-pattern hyperedge with `>= 2` participants into a star:
1926
+ * one synthetic hub node plus a pairwise edge to each participant. Degenerate
1927
+ * hyperedges (zero or one participant) are skipped because a hub with no
1928
+ * "group" to anchor is noisy and contributes nothing to the layout. Nothing
1929
+ * here mutates `state/graph.json`; the caller layers hubs on top of the real
1930
+ * graph for rendering only.
1931
+ */
1932
+ declare function synthesizeHyperedgeHubs(hyperedges: ReadonlyArray<MinimalHyperedge>, nodes: ReadonlyArray<MinimalNode>): SynthesizedHyperedgeHubs;
1790
1933
  declare function exportGraphFormat(rootDir: string, format: Exclude<GraphExportFormat, "html" | "report" | "obsidian" | "canvas">, outputPath: string): Promise<GraphExportResult>;
1791
1934
  declare function exportGraphReportHtml(rootDir: string, outputPath: string): Promise<GraphExportResult>;
1792
1935
  declare function exportObsidianVault(rootDir: string, outputDir: string): Promise<GraphExportResult>;
@@ -1833,6 +1976,49 @@ declare function importInbox(rootDir: string, inputDir?: string): Promise<InboxI
1833
1976
  declare function listManifests(rootDir: string): Promise<SourceManifest[]>;
1834
1977
  declare function readExtractedText(rootDir: string, manifest: SourceManifest): Promise<string | undefined>;
1835
1978
 
1979
+ /**
1980
+ * Effective tuning thresholds for graph output. These knobs keep report and
1981
+ * similarity surfaces readable on large repositories while preserving
1982
+ * friendly defaults on small ones. Every caller that picks a graph limit
1983
+ * should route through {@link resolveLargeRepoDefaults} so user-provided
1984
+ * overrides stay authoritative and defaults adjust automatically based on
1985
+ * node count.
1986
+ */
1987
+ interface ResolvedLargeRepoDefaults {
1988
+ /** Upper bound on god-node entries surfaced in the report/tooling. */
1989
+ godNodeLimit: number;
1990
+ /**
1991
+ * Community rollup threshold: any community with fewer than this many
1992
+ * members is folded into the rollup summary in the report. Defaults to
1993
+ * `max(3, ceil(totalCommunities / 50))` when `totalCommunities` is
1994
+ * provided, otherwise to 3.
1995
+ */
1996
+ foldCommunitiesBelow: number;
1997
+ /**
1998
+ * Hard cap on the number of inferred similarity edges emitted per graph.
1999
+ * Prevents degenerate O(n²) fan-out on very large repos.
2000
+ */
2001
+ similarityEdgeCap: number;
2002
+ /**
2003
+ * Minimum IDF weight a similarity feature must carry to contribute to an
2004
+ * edge score. Features below the floor are dropped entirely.
2005
+ */
2006
+ similarityIdfFloor: number;
2007
+ }
2008
+ /** Node count at which tighter defaults begin firing. */
2009
+ declare const LARGE_REPO_NODE_THRESHOLD = 1000;
2010
+ /**
2011
+ * Resolve effective numeric thresholds for a graph of `nodeCount` nodes.
2012
+ * User-configured values on `config.graph` always win — defaults only fire
2013
+ * when the caller has left the knob unset. Pass `totalCommunities` when the
2014
+ * community rollup threshold needs to scale with the community count.
2015
+ */
2016
+ declare function resolveLargeRepoDefaults(input: {
2017
+ nodeCount: number;
2018
+ totalCommunities?: number;
2019
+ config?: VaultConfig | null;
2020
+ }): ResolvedLargeRepoDefaults;
2021
+
1836
2022
  declare function createMcpServer(rootDir: string): Promise<McpServer>;
1837
2023
  declare function startMcpServer(rootDir: string, stdin?: Readable, stdout?: Writable): Promise<{
1838
2024
  close: () => Promise<void>;
@@ -2110,6 +2296,35 @@ type WatchCycleResult = {
2110
2296
  changedPages: string[];
2111
2297
  lintFindingCount?: number;
2112
2298
  };
2299
+ /**
2300
+ * Compute the effective list of repository roots that `swarmvault watch --repo` should track.
2301
+ * Resolution order (highest wins):
2302
+ * 1. `options.overrideRoots` (CLI `--root <path>`) — used verbatim, config and discovery skipped.
2303
+ * 2. Explicit `config.watch.repoRoots` — skips auto-discovery but still honors `excludeRepoRoots`.
2304
+ * 3. Auto-discovery via `listTrackedRepoRoots` — preserves pre-0.11 behavior.
2305
+ * `config.watch.excludeRepoRoots` always applies as a deny list (unless `overrideRoots` is set).
2306
+ */
2307
+ declare function resolveWatchedRepoRoots(rootDir: string, options?: {
2308
+ overrideRoots?: string[];
2309
+ config?: VaultConfig;
2310
+ }): Promise<string[]>;
2311
+ /**
2312
+ * Public helper mirroring `resolveWatchedRepoRoots` for CLI and MCP callers that only need the
2313
+ * final list without the full watch cycle machinery.
2314
+ */
2315
+ declare function listWatchedRoots(rootDir: string, options?: {
2316
+ overrideRoots?: string[];
2317
+ }): Promise<string[]>;
2318
+ /**
2319
+ * Add a repo root to the persisted `watch.repoRoots` list in `swarmvault.config.json`.
2320
+ * Returns the resolved absolute path that was added (or already present). Dedupes on resolved path.
2321
+ */
2322
+ declare function addWatchedRoot(rootDir: string, candidate: string): Promise<string>;
2323
+ /**
2324
+ * Remove a repo root from the persisted `watch.repoRoots` list. Missing path is a no-op.
2325
+ * Returns `true` when the path was removed, `false` when it was absent.
2326
+ */
2327
+ declare function removeWatchedRoot(rootDir: string, candidate: string): Promise<boolean>;
2113
2328
  declare function runWatchCycle(rootDir: string, options?: WatchOptions): Promise<WatchCycleResult>;
2114
2329
  declare function watchVault(rootDir: string, options?: WatchOptions): Promise<WatchController>;
2115
2330
  declare function getWatchStatus(rootDir: string): Promise<WatchStatusResult>;
@@ -2118,4 +2333,4 @@ declare function createWebSearchAdapter(id: string, config: WebSearchProviderCon
2118
2333
  type WebSearchTaskId = "deepLintProvider" | "queryProvider" | "exploreProvider";
2119
2334
  declare function getWebSearchAdapterForTask(rootDir: string, task: WebSearchTaskId): Promise<WebSearchAdapter>;
2120
2335
 
2121
- export { type AddOptions, type AddResult, type AgentType, type AnalyzedTerm, type ApprovalBundleType, type ApprovalChangeType, type ApprovalDetail, type ApprovalDiffHunk, type ApprovalDiffLine, type ApprovalEntry, type ApprovalEntryDetail, type ApprovalEntryLabel, type ApprovalEntryStatus, type ApprovalFrontmatterChange, type ApprovalManifest, type ApprovalStructuredDiff, type ApprovalSummary, type AudioTranscriptionRequest, type AudioTranscriptionResponse, type BenchmarkArtifact, type BenchmarkOptions, type BenchmarkQuestionResult, type BenchmarkSummary, type BlastRadiusResult, type CandidatePromotionConfig, 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 ConsolidationConfig, type ConsolidationPromotion, type ConsolidationResult, DEFAULT_CONSOLIDATION_CONFIG, DEFAULT_HALF_LIFE_DAYS, DEFAULT_HALF_LIFE_DAYS_BY_SOURCE_CLASS, DEFAULT_PROMOTION_CONFIG, DEFAULT_REDACTION_PATTERNS, DEFAULT_STALE_THRESHOLD, type DirectoryIngestFailure, type DirectoryIngestResult, type DirectoryIngestSkip, type EmbeddingCacheArtifact, type EmbeddingCacheEntry, type EvidenceClass, type ExploreOptions, type ExploreResult, type ExploreStepResult, type ExtractionClaim, type ExtractionKind, type ExtractionTerm, type Freshness, type FreshnessConfig, type GenerationAttachment, type GenerationRequest, type GenerationResponse, type GitHookStatus, type GraphArtifact, type GraphDiffResult, type GraphEdge, type GraphExplainNeighbor, type GraphExplainResult, type GraphExportFormat, type GraphExportResult, type GraphHyperedge, type GraphNode, type GraphPage, type GraphPathResult, type GraphPushCounts, type GraphPushNeo4jOptions, type GraphPushResult, type GraphQueryMatch, type GraphQueryResult, type GraphReportArtifact, type GuidedSessionMode, type GuidedSourceSessionAnswers, type GuidedSourceSessionQuestion, type GuidedSourceSessionRecord, type GuidedSourceSessionStatus, type ImageGenerationRequest, type ImageGenerationResponse, type ImageVisionExtraction, type InboxImportResult, type InboxImportSkip, type IngestOptions, type InitOptions, type InputIngestResult, type InstallAgentOptions, type InstallAgentResult, type LintFinding, type LintOptions, type ManagedSourceAddOptions, type ManagedSourceAddResult, type ManagedSourceDeleteResult, type ManagedSourceKind, type ManagedSourceRecord, type ManagedSourceReloadOptions, type ManagedSourceReloadResult, type ManagedSourceStatus, type ManagedSourceSyncCounts, type ManagedSourcesArtifact, type MemoryTier, type Neo4jGraphSinkConfig, 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 PromotionDecision, type PromotionGateKind, type PromotionGateResult, type PromotionSession, type ProviderAdapter, type ProviderCapability, type ProviderConfig, type ProviderRoleExecutorConfig, type ProviderType, type QueryOptions, type QueryResult, type RedactionMatchSummary, type RedactionPatternConfig, type RedactionSettings, type RedactionSummary, type RepoSyncResult, type ResolvedPaths, type ReviewActionResult, type RoleExecutorConfig, type SceneElement, type SceneSpec, type ScheduleController, type ScheduleJobConfig, type ScheduleStateRecord, type ScheduleTriggerConfig, type ScheduledCompileTask, type ScheduledConsolidateTask, type ScheduledExploreTask, type ScheduledLintTask, type ScheduledQueryTask, type ScheduledRunResult, type ScheduledTaskConfig, type SearchResult, type SourceAnalysis, type SourceAttachment, type SourceCaptureType, type SourceClaim, type SourceClass, type SourceExtractionArtifact, type SourceGuideResult, type SourceKind, type SourceManifest, type SourceRationale, type SourceReviewResult, type VaultConfig, type VaultDashboardPack, type VaultProfileConfig, type VaultProfilePreset, type WatchController, type WatchOptions, type WatchRepoSyncResult, type WatchRunRecord, type WatchStatusResult, type WebSearchAdapter, type WebSearchProviderConfig, type WebSearchProviderType, type WebSearchResult, acceptApproval, addInput, addManagedSource, agentTypeSchema, applyDecayToPages, archiveCandidate, assertProviderCapability, autoCommitWikiChanges, benchmarkVault, blastRadius, blastRadiusVault, bootstrapDemo, buildConfiguredRedactor, buildRedactor, compileVault, computeDecayScore, consolidateVault, createMcpServer, createProvider, createSupersessionEdge, createWebSearchAdapter, defaultVaultConfig, defaultVaultSchema, deleteManagedSource, estimatePageTokens, estimateTokens, evaluateCandidateForPromotion, explainGraphVault, exploreVault, exportGraphFormat, exportGraphHtml, exportGraphReportHtml, exportObsidianCanvas, exportObsidianVault, getGitHookStatus, getProviderForTask, getWatchStatus, getWebSearchAdapterForTask, getWorkspaceInfo, graphDiff, guideManagedSource, guideSourceScope, importInbox, ingestDirectory, ingestInput, ingestInputDetailed, initVault, initWorkspace, installAgent, installConfiguredAgents, installGitHooks, lintVault, listApprovals, listCandidates, listGodNodes, listGraphHyperedges, listManagedSourceRecords, listManifests, listPages, listSchedules, listTrackedRepoRoots, loadVaultConfig, loadVaultSchema, loadVaultSchemas, markSuperseded, pathGraphVault, persistDecayFrontmatter, previewCandidatePromotions, promoteCandidate, providerCapabilitySchema, providerTypeSchema, pushGraphNeo4j, queryGraphVault, queryVault, readApproval, readExtractedText, readGraphReport, readPage, rejectApproval, reloadManagedSources, resetDecay, resolveConsolidationConfig, resolveDecayConfig, resolvePaths, resolveRedactionPatterns, resumeSourceSession, reviewManagedSource, reviewSourceScope, runAutoPromotion, runConsolidation, runDecayPass, runSchedule, runWatchCycle, searchVault, serveSchedules, stageGeneratedOutputPages, startGraphServer, startMcpServer, syncTrackedRepos, syncTrackedReposForWatch, trimToTokenBudget, uninstallGitHooks, watchVault, webSearchProviderTypeSchema };
2336
+ export { type AddOptions, type AddResult, type AgentType, type AnalyzedTerm, type ApprovalBundleType, type ApprovalChangeType, type ApprovalDetail, type ApprovalDiffHunk, type ApprovalDiffLine, type ApprovalEntry, type ApprovalEntryDetail, type ApprovalEntryLabel, type ApprovalEntryStatus, type ApprovalFrontmatterChange, type ApprovalManifest, type ApprovalStructuredDiff, type ApprovalSummary, type AudioTranscriptionRequest, type AudioTranscriptionResponse, type BenchmarkArtifact, type BenchmarkByClassEntry, type BenchmarkOptions, type BenchmarkQuestionResult, type BenchmarkSummary, type BlastRadiusResult, type CandidatePromotionConfig, 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 ConsolidationConfig, type ConsolidationPromotion, type ConsolidationResult, DEFAULT_CONSOLIDATION_CONFIG, DEFAULT_HALF_LIFE_DAYS, DEFAULT_HALF_LIFE_DAYS_BY_SOURCE_CLASS, DEFAULT_PROMOTION_CONFIG, DEFAULT_REDACTION_PATTERNS, DEFAULT_STALE_THRESHOLD, type DirectoryIngestFailure, type DirectoryIngestResult, type DirectoryIngestSkip, type EmbeddingCacheArtifact, type EmbeddingCacheEntry, type EvidenceClass, type ExploreOptions, type ExploreResult, type ExploreStepResult, type ExtractionClaim, type ExtractionKind, type ExtractionTerm, type Freshness, type FreshnessConfig, type GenerationAttachment, type GenerationRequest, type GenerationResponse, type GitHookStatus, type GraphArtifact, type GraphDiffResult, type GraphEdge, type GraphExplainNeighbor, type GraphExplainResult, type GraphExportFormat, type GraphExportResult, type GraphHyperedge, type GraphNode, type GraphPage, type GraphPathResult, type GraphPushCounts, type GraphPushNeo4jOptions, type GraphPushResult, type GraphQueryMatch, type GraphQueryResult, type GraphReportArtifact, type GuidedSessionMode, type GuidedSourceSessionAnswers, type GuidedSourceSessionQuestion, type GuidedSourceSessionRecord, type GuidedSourceSessionStatus, type ImageGenerationRequest, type ImageGenerationResponse, type ImageVisionExtraction, type InboxImportResult, type InboxImportSkip, type IngestOptions, type InitOptions, type InputIngestResult, type InstallAgentOptions, type InstallAgentResult, LARGE_REPO_NODE_THRESHOLD, type LintFinding, type LintOptions, type ManagedSourceAddOptions, type ManagedSourceAddResult, type ManagedSourceDeleteResult, type ManagedSourceKind, type ManagedSourceRecord, type ManagedSourceReloadOptions, type ManagedSourceReloadResult, type ManagedSourceStatus, type ManagedSourceSyncCounts, type ManagedSourcesArtifact, type MemoryTier, type Neo4jGraphSinkConfig, 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 PromotionDecision, type PromotionGateKind, type PromotionGateResult, type PromotionSession, type ProviderAdapter, type ProviderCapability, type ProviderConfig, type ProviderRoleExecutorConfig, type ProviderType, type QueryOptions, type QueryResult, type RedactionMatchSummary, type RedactionPatternConfig, type RedactionSettings, type RedactionSummary, type RepoSyncResult, type ResolvedLargeRepoDefaults, type ResolvedPaths, type ReviewActionResult, type RoleExecutorConfig, type SceneElement, type SceneSpec, type ScheduleController, type ScheduleJobConfig, type ScheduleStateRecord, type ScheduleTriggerConfig, type ScheduledCompileTask, type ScheduledConsolidateTask, type ScheduledExploreTask, type ScheduledLintTask, type ScheduledQueryTask, type ScheduledRunResult, type ScheduledTaskConfig, type SearchResult, type SourceAnalysis, type SourceAttachment, type SourceCaptureType, type SourceClaim, type SourceClass, type SourceExtractionArtifact, type SourceGuideResult, type SourceKind, type SourceManifest, type SourceRationale, type SourceReviewResult, type SynthesizedHubEdge, type SynthesizedHubNode, type SynthesizedHyperedgeHubs, type VaultConfig, type VaultDashboardPack, type VaultProfileConfig, type VaultProfilePreset, type WatchConfig, type WatchController, type WatchOptions, type WatchRepoSyncResult, type WatchRunRecord, type WatchStatusResult, type WebSearchAdapter, type WebSearchProviderConfig, type WebSearchProviderType, type WebSearchResult, acceptApproval, addInput, addManagedSource, addWatchedRoot, agentTypeSchema, applyDecayToPages, archiveCandidate, assertProviderCapability, autoCommitWikiChanges, benchmarkVault, blastRadius, blastRadiusVault, bootstrapDemo, buildConfiguredRedactor, buildRedactor, compileVault, computeDecayScore, consolidateVault, createMcpServer, createProvider, createSupersessionEdge, createWebSearchAdapter, defaultVaultConfig, defaultVaultSchema, deleteManagedSource, estimatePageTokens, estimateTokens, evaluateCandidateForPromotion, explainGraphVault, exploreVault, exportGraphFormat, exportGraphHtml, exportGraphReportHtml, exportObsidianCanvas, exportObsidianVault, getGitHookStatus, getProviderForTask, getWatchStatus, getWebSearchAdapterForTask, getWorkspaceInfo, graphDiff, guideManagedSource, guideSourceScope, importInbox, ingestDirectory, ingestInput, ingestInputDetailed, initVault, initWorkspace, installAgent, installConfiguredAgents, installGitHooks, lintVault, listApprovals, listCandidates, listGodNodes, listGraphHyperedges, listManagedSourceRecords, listManifests, listPages, listSchedules, listTrackedRepoRoots, listWatchedRoots, loadVaultConfig, loadVaultSchema, loadVaultSchemas, markSuperseded, pathGraphVault, persistDecayFrontmatter, previewCandidatePromotions, promoteCandidate, providerCapabilitySchema, providerTypeSchema, pushGraphNeo4j, queryGraphVault, queryVault, readApproval, readExtractedText, readGraphReport, readPage, rejectApproval, reloadManagedSources, removeWatchedRoot, resetDecay, resolveConsolidationConfig, resolveDecayConfig, resolveLargeRepoDefaults, resolvePaths, resolveRedactionPatterns, resolveWatchedRepoRoots, resumeSourceSession, reviewManagedSource, reviewSourceScope, runAutoPromotion, runConsolidation, runDecayPass, runSchedule, runWatchCycle, searchVault, serveSchedules, stageGeneratedOutputPages, startGraphServer, startMcpServer, syncTrackedRepos, syncTrackedReposForWatch, synthesizeHyperedgeHubs, trimToTokenBudget, uninstallGitHooks, watchVault, webSearchProviderTypeSchema };