@swarmvaultai/engine 3.14.2 → 3.16.0

package/dist/index.d.ts

@@ -59,9 +59,11 @@ declare const agentTypeSchema: z.ZodEnum<{
     cortex: "cortex";
     crush: "crush";
     deepagents: "deepagents";
+    devin: "devin";
     firebender: "firebender";
     iflow: "iflow";
     junie: "junie";
+    kilo: "kilo";
     "kilo-code": "kilo-code";
     kimi: "kimi";
     kode: "kode";
@@ -105,7 +107,7 @@ type ContextPackItemKind = "page" | "node" | "edge" | "hyperedge";
 type AgentMemoryTaskStatus = "active" | "blocked" | "completed" | "archived";
 type AgentMemoryResumeFormat = "markdown" | "json" | "llms";
 type OutputAssetRole = "primary" | "preview" | "manifest" | "poster";
-type GraphExportFormat = "html" | "html-standalone" | "report" | "svg" | "graphml" | "cypher" | "json" | "obsidian" | "canvas";
+type GraphExportFormat = "html" | "html-standalone" | "report" | "svg" | "graphml" | "cypher" | "json" | "callflow" | "obsidian" | "canvas";
 type PageStatus = "draft" | "candidate" | "active" | "blocked" | "completed" | "archived";
 type PageManager = "system" | "human";
 type ApprovalEntryStatus = "pending" | "accepted" | "rejected";
@@ -540,6 +542,11 @@ interface IngestOptions {
      * redaction entirely for this run.
      */
     redact?: boolean;
+    /**
+     * Emit bounded human progress to stderr for interactive CLI runs. Defaults
+     * to false so JSON, MCP, watch, and library callers stay quiet.
+     */
+    progress?: boolean;
 }
 interface DirectoryIngestSkip {
     path: string;
@@ -1014,6 +1021,17 @@ interface GraphPathResult {
     pageIds: string[];
     summary: string;
 }
+interface GraphCycle {
+    nodeIds: string[];
+    labels: string[];
+    edgeIds: string[];
+    relations: string[];
+}
+interface GraphCycleResult {
+    cycles: GraphCycle[];
+    limit: number;
+    summary: string;
+}
 interface GraphExplainNeighbor {
     nodeId: string;
     label: string;
@@ -1332,6 +1350,7 @@ interface InitOptions {
     obsidian?: boolean;
     profile?: string;
     lite?: boolean;
+    installAgentRules?: boolean;
 }
 interface CompileResult {
     graphPath: string;
@@ -1666,6 +1685,7 @@ interface WatchController {
 }
 interface InstallAgentOptions {
     hook?: boolean;
+    scope?: "project" | "user";
 }
 interface InstallAgentResult {
     agent: AgentType;
@@ -1673,6 +1693,53 @@ interface InstallAgentResult {
     targets: string[];
     warnings?: string[];
 }
+interface AgentInstallTargetStatus {
+    path: string;
+    exists: boolean;
+}
+interface AgentInstallStatus {
+    agent: AgentType;
+    scope: "project" | "user";
+    hook: boolean;
+    installed: boolean;
+    target: string;
+    targets: AgentInstallTargetStatus[];
+}
+type ProviderTaskKey = keyof VaultConfig["tasks"];
+interface ProviderConfigEntry {
+    id: string;
+    type: ProviderType;
+    model: string;
+    baseUrl?: string;
+    apiKeyEnv?: string;
+    capabilities: ProviderCapability[];
+    assignedTasks: ProviderTaskKey[];
+    provider: ProviderConfig;
+}
+interface ProviderConfigAddOptions {
+    rootDir: string;
+    providerId: string;
+    provider: ProviderConfig;
+    tasks?: ProviderTaskKey[];
+}
+interface ProviderConfigAddResult {
+    providerId: string;
+    configPath: string;
+    added: boolean;
+    updated: boolean;
+    updatedTasks: ProviderTaskKey[];
+}
+interface ProviderConfigRemoveOptions {
+    rootDir: string;
+    providerId: string;
+    fallbackProviderId?: string;
+}
+interface ProviderConfigRemoveResult {
+    providerId: string;
+    configPath: string;
+    removed: boolean;
+    updatedTasks: ProviderTaskKey[];
+}
 interface ManagedSourceAddOptions {
     compile?: boolean;
     brief?: boolean;
@@ -2281,6 +2348,7 @@ interface ScheduleController {
 }
 
 declare function installAgent(rootDir: string, agent: AgentType, options?: InstallAgentOptions): Promise<InstallAgentResult>;
+declare function getAgentInstallStatus(rootDir: string, agent: AgentType, options?: InstallAgentOptions): Promise<AgentInstallStatus>;
 declare function installConfiguredAgents(rootDir: string): Promise<InstallAgentResult[]>;
 
 declare function exportAiPack(rootDir: string, options?: AiExportOptions): Promise<AiExportResult>;
@@ -2580,6 +2648,11 @@ declare function validateGraphArtifact(graph: GraphArtifact, options?: {
     strict?: boolean;
 }): GraphValidationResult;
 declare function graphDiff(oldGraph: GraphArtifact, newGraph: GraphArtifact): GraphDiffResult;
+declare function findGraphCycles(graph: GraphArtifact, options?: {
+    relations?: string[];
+    limit?: number;
+    maxDepth?: number;
+}): GraphCycleResult;
 /**
  * Compute the blast radius of changing a file/module by tracing reverse import
  * edges via BFS. Returns all modules that transitively depend on the target.
@@ -2756,6 +2829,11 @@ declare function runMigration(rootDir: string, options?: {
     dryRun?: boolean;
 }): Promise<MigrationResult>;
 
+declare function addProviderConfig(options: ProviderConfigAddOptions): Promise<ProviderConfigAddResult>;
+declare function listProviderConfigEntries(rootDir: string): Promise<ProviderConfigEntry[]>;
+declare function getProviderConfigEntry(rootDir: string, providerId: string): Promise<ProviderConfigEntry | null>;
+declare function removeProviderConfig(options: ProviderConfigRemoveOptions): Promise<ProviderConfigRemoveResult>;
+
 declare abstract class BaseProviderAdapter implements ProviderAdapter {
     readonly id: string;
     readonly type: ProviderType;
@@ -3258,4 +3336,4 @@ declare function createWebSearchAdapter(id: string, config: WebSearchProviderCon
 type WebSearchTaskId = "deepLintProvider" | "queryProvider" | "exploreProvider";
 declare function getWebSearchAdapterForTask(rootDir: string, task: WebSearchTaskId): Promise<WebSearchAdapter>;
 
-export { ALL_MIGRATIONS, type AddOptions, type AddResult, type AgentMemoryDecision, type AgentMemoryNote, type AgentMemoryResumeFormat, type AgentMemoryTask, type AgentMemoryTaskResult, type AgentMemoryTaskStatus, type AgentMemoryTaskSummary, type AgentType, type AiExportFile, type AiExportOptions, type AiExportResult, 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 AskChatOptions, type AskChatResult, type AudioTranscriptionRequest, type AudioTranscriptionResponse, type BenchmarkArtifact, type BenchmarkByClassEntry, type BenchmarkOptions, type BenchmarkQuestionResult, type BenchmarkSummary, type BlastRadiusResult, type BuildContextPackOptions, type BuildContextPackResult, type CandidatePromotionConfig, type CandidateRecord, type ChartDatum, type ChartSpec, type ClaimStatus, type CodeAnalysis, type CodeDiagnostic, type CodeImport, type CodeIndexArtifact, type CodeIndexEntry, type CodeLanguage, type CodeRelation, type CodeSymbol, type CodeSymbolKind, type CommandRoleExecutorConfig, type CompileOptions, type CompileResult, type CompileState, type ConsolidationConfig, type ConsolidationPromotion, type ConsolidationResult, type ContextPack, type ContextPackFormat, type ContextPackItem, type ContextPackItemKind, type ContextPackOmittedItem, type ContextPackSummary, DEFAULT_CONSOLIDATION_CONFIG, DEFAULT_HALF_LIFE_DAYS, DEFAULT_HALF_LIFE_DAYS_BY_SOURCE_CLASS, DEFAULT_PROMOTION_CONFIG, DEFAULT_REDACTION_PATTERNS, DEFAULT_STALE_THRESHOLD, type DegradationOutcome, 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 FinishMemoryTaskOptions, type Freshness, type FreshnessConfig, type GenerationAttachment, type GenerationRequest, type GenerationResponse, type GitHookStatus, type GraphArtifact, type GraphClusterRefreshResult, type GraphCommunityResult, 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 GraphQueryFilterStats, type GraphQueryFilters, type GraphQueryMatch, type GraphQueryRelationGroup, type GraphQueryResult, type GraphReportArtifact, type GraphShareArtifact, type GraphShareBundleFile, type GraphShrinkDimension, type GraphShrinkGuardResult, type GraphStatsResult, type GraphStatusChange, type GraphStatusResult, type GraphValidationIssue, type GraphValidationResult, type GraphValidationSeverity, 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, LOCAL_WHISPER_MODEL_SIZES, type LintFinding, type LintOptions, type LocalWhisperAdapterOptions, type LocalWhisperBinaryDiscovery, LocalWhisperProviderAdapter, type LocalWhisperSetupStatus, type ManagedSourceAddOptions, type ManagedSourceAddResult, type ManagedSourceDeleteResult, type ManagedSourceKind, type ManagedSourceRecord, type ManagedSourceReloadOptions, type ManagedSourceReloadResult, type ManagedSourceStatus, type ManagedSourceSyncCounts, type ManagedSourcesArtifact, type MemoryTier, type MigrationPlan, type MigrationResult, type MigrationStep, type Neo4jGraphSinkConfig, OPENAI_COMPATIBLE_CAPABILITY_MATRIX, type OpenAiCompatiblePresetId, 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 ProviderPresetCapability, type ProviderRegistrationOptions, type ProviderRegistrationResult, type ProviderRoleExecutorConfig, type ProviderType, type QueryOptions, type QueryResult, type RedactionMatchSummary, type RedactionPatternConfig, type RedactionSettings, type RedactionSummary, type RepoSyncResult, type ResolvedLargeRepoDefaults, type ResolvedPaths, type ResumeMemoryTaskOptions, type ResumeMemoryTaskResult, type RetrievalConfig, type RetrievalDoctorResult, type RetrievalManifest, type RetrievalStatus, type ReviewActionResult, type RoleExecutorConfig, SWARMVAULT_OUT_ENV, 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 StartMemoryTaskOptions, type SynthesizedHubEdge, type SynthesizedHubNode, type SynthesizedHyperedgeHubs, type UpdateMemoryTaskOptions, type VaultChatSession, type VaultChatSessionSummary, type VaultChatTurn, type VaultConfig, type VaultDashboardPack, type VaultDoctorAction, type VaultDoctorCheck, type VaultDoctorCounts, type VaultDoctorRecommendation, type VaultDoctorRecommendationPriority, type VaultDoctorReport, type VaultDoctorSafeAction, type VaultDoctorStatus, type VaultProfileConfig, type VaultProfilePreset, type VaultVersionRecord, type WatchConfig, type WatchController, type WatchOptions, type WatchRepoSyncResult, type WatchRunRecord, type WatchStatusResult, type WebSearchAdapter, type WebSearchProviderConfig, type WebSearchProviderType, type WebSearchResult, type WhisperRunResult, type WhisperRunner, acceptApproval, addInput, addManagedSource, addWatchedRoot, agentTypeSchema, applyDecayToPages, archiveCandidate, askChatSession, assertProviderCapability, autoCommitWikiChanges, benchmarkVault, blastRadius, blastRadiusVault, bootstrapDemo, buildConfiguredRedactor, buildContextPack, buildGraphShareArtifact, buildGraphTree, buildMemoryGraphElements, buildRedactor, checkTrackedRepoChanges, compileVault, computeDecayScore, consolidateVault, createMcpServer, createProvider, createSupersessionEdge, createWebSearchAdapter, defaultVaultConfig, defaultVaultSchema, deleteChatSession, deleteContextPack, deleteManagedSource, detectVaultVersion, discoverLocalWhisperBinary, doctorRetrieval, doctorVault, downloadWhisperModel, ensureMemoryLedger, estimatePageTokens, estimateTokens, evaluateCandidateForPromotion, evaluateGraphShrinkGuard, expectedModelPath, explainGraphVault, exploreVault, exportAiPack, exportGraphFormat, exportGraphHtml, exportGraphReportHtml, exportGraphTree, exportObsidianCanvas, exportObsidianVault, finishMemoryTask, getGitHookStatus, getGraphCommunityVault, getGraphStatus, getProviderForTask, getRetrievalStatus, getWatchStatus, getWebSearchAdapterForTask, getWorkspaceInfo, graphDiff, graphStats, graphStatsVault, guideManagedSource, guideSourceScope, importInbox, ingestDirectory, ingestInput, ingestInputDetailed, initVault, initWorkspace, installAgent, installConfiguredAgents, installGitHooks, lintVault, listApprovals, listCandidates, listChatSessions, listContextPacks, listGodNodes, listGraphHyperedges, listManagedSourceRecords, listManifests, listMemoryTasks, listPages, listSchedules, listTrackedRepoRoots, listWatchedRoots, loadMemoryTaskPages, loadVaultConfig, loadVaultSchema, loadVaultSchemas, lookupPresetCapabilities, markSuperseded, memoryTaskHashes, mergeGraphFiles, modelDownloadUrl, pathGraphVault, persistDecayFrontmatter, planMigration, previewCandidatePromotions, projectGraphAfterRemovals, promoteCandidate, providerCapabilitySchema, providerTypeSchema, pushGraphNeo4j, queryGraphVault, queryVault, readApproval, readChatSession, readContextPack, readExtractedText, readGraphReport, readMemoryTask, readPage, rebuildRetrievalIndex, refreshGraphClusters, registerLocalWhisperProvider, rejectApproval, reloadManagedSources, removeWatchedRoot, renderContextPackLlms, renderContextPackMarkdown, renderGraphShareBundleFiles, renderGraphShareMarkdown, renderGraphSharePreviewHtml, renderGraphShareSvg, renderGraphTreeHtml, renderMemoryTaskMarkdown, resetDecay, resolveArtifactRootDir, resolveConsolidationConfig, resolveDecayConfig, resolveLargeRepoDefaults, resolvePaths, resolveRedactionPatterns, resolveRetrievalConfig, resolveWatchedRepoRoots, resumeMemoryTask, resumeSourceSession, reviewManagedSource, reviewSourceScope, runAutoPromotion, runConsolidation, runDecayPass, runMigration, runSchedule, runWatchCycle, searchVault, serveSchedules, stageGeneratedOutputPages, startGraphServer, startMcpServer, startMemoryTask, summarizeLocalWhisperSetup, syncTrackedRepos, syncTrackedReposForWatch, synthesizeHyperedgeHubs, trimToTokenBudget, uninstallGitHooks, updateMemoryTask, validateGraphArtifact, validateGraphVault, watchVault, webSearchProviderTypeSchema, withCapabilityFallback, writeRetrievalManifest };
+export { ALL_MIGRATIONS, type AddOptions, type AddResult, type AgentInstallStatus, type AgentInstallTargetStatus, type AgentMemoryDecision, type AgentMemoryNote, type AgentMemoryResumeFormat, type AgentMemoryTask, type AgentMemoryTaskResult, type AgentMemoryTaskStatus, type AgentMemoryTaskSummary, type AgentType, type AiExportFile, type AiExportOptions, type AiExportResult, 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 AskChatOptions, type AskChatResult, type AudioTranscriptionRequest, type AudioTranscriptionResponse, type BenchmarkArtifact, type BenchmarkByClassEntry, type BenchmarkOptions, type BenchmarkQuestionResult, type BenchmarkSummary, type BlastRadiusResult, type BuildContextPackOptions, type BuildContextPackResult, type CandidatePromotionConfig, type CandidateRecord, type ChartDatum, type ChartSpec, type ClaimStatus, type CodeAnalysis, type CodeDiagnostic, type CodeImport, type CodeIndexArtifact, type CodeIndexEntry, type CodeLanguage, type CodeRelation, type CodeSymbol, type CodeSymbolKind, type CommandRoleExecutorConfig, type CompileOptions, type CompileResult, type CompileState, type ConsolidationConfig, type ConsolidationPromotion, type ConsolidationResult, type ContextPack, type ContextPackFormat, type ContextPackItem, type ContextPackItemKind, type ContextPackOmittedItem, type ContextPackSummary, DEFAULT_CONSOLIDATION_CONFIG, DEFAULT_HALF_LIFE_DAYS, DEFAULT_HALF_LIFE_DAYS_BY_SOURCE_CLASS, DEFAULT_PROMOTION_CONFIG, DEFAULT_REDACTION_PATTERNS, DEFAULT_STALE_THRESHOLD, type DegradationOutcome, 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 FinishMemoryTaskOptions, type Freshness, type FreshnessConfig, type GenerationAttachment, type GenerationRequest, type GenerationResponse, type GitHookStatus, type GraphArtifact, type GraphClusterRefreshResult, type GraphCommunityResult, type GraphCycle, type GraphCycleResult, 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 GraphQueryFilterStats, type GraphQueryFilters, type GraphQueryMatch, type GraphQueryRelationGroup, type GraphQueryResult, type GraphReportArtifact, type GraphShareArtifact, type GraphShareBundleFile, type GraphShrinkDimension, type GraphShrinkGuardResult, type GraphStatsResult, type GraphStatusChange, type GraphStatusResult, type GraphValidationIssue, type GraphValidationResult, type GraphValidationSeverity, 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, LOCAL_WHISPER_MODEL_SIZES, type LintFinding, type LintOptions, type LocalWhisperAdapterOptions, type LocalWhisperBinaryDiscovery, LocalWhisperProviderAdapter, type LocalWhisperSetupStatus, type ManagedSourceAddOptions, type ManagedSourceAddResult, type ManagedSourceDeleteResult, type ManagedSourceKind, type ManagedSourceRecord, type ManagedSourceReloadOptions, type ManagedSourceReloadResult, type ManagedSourceStatus, type ManagedSourceSyncCounts, type ManagedSourcesArtifact, type MemoryTier, type MigrationPlan, type MigrationResult, type MigrationStep, type Neo4jGraphSinkConfig, OPENAI_COMPATIBLE_CAPABILITY_MATRIX, type OpenAiCompatiblePresetId, 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 ProviderConfigAddOptions, type ProviderConfigAddResult, type ProviderConfigEntry, type ProviderConfigRemoveOptions, type ProviderConfigRemoveResult, type ProviderPresetCapability, type ProviderRegistrationOptions, type ProviderRegistrationResult, type ProviderRoleExecutorConfig, type ProviderTaskKey, type ProviderType, type QueryOptions, type QueryResult, type RedactionMatchSummary, type RedactionPatternConfig, type RedactionSettings, type RedactionSummary, type RepoSyncResult, type ResolvedLargeRepoDefaults, type ResolvedPaths, type ResumeMemoryTaskOptions, type ResumeMemoryTaskResult, type RetrievalConfig, type RetrievalDoctorResult, type RetrievalManifest, type RetrievalStatus, type ReviewActionResult, type RoleExecutorConfig, SWARMVAULT_OUT_ENV, 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 StartMemoryTaskOptions, type SynthesizedHubEdge, type SynthesizedHubNode, type SynthesizedHyperedgeHubs, type UpdateMemoryTaskOptions, type VaultChatSession, type VaultChatSessionSummary, type VaultChatTurn, type VaultConfig, type VaultDashboardPack, type VaultDoctorAction, type VaultDoctorCheck, type VaultDoctorCounts, type VaultDoctorRecommendation, type VaultDoctorRecommendationPriority, type VaultDoctorReport, type VaultDoctorSafeAction, type VaultDoctorStatus, type VaultProfileConfig, type VaultProfilePreset, type VaultVersionRecord, type WatchConfig, type WatchController, type WatchOptions, type WatchRepoSyncResult, type WatchRunRecord, type WatchStatusResult, type WebSearchAdapter, type WebSearchProviderConfig, type WebSearchProviderType, type WebSearchResult, type WhisperRunResult, type WhisperRunner, acceptApproval, addInput, addManagedSource, addProviderConfig, addWatchedRoot, agentTypeSchema, applyDecayToPages, archiveCandidate, askChatSession, assertProviderCapability, autoCommitWikiChanges, benchmarkVault, blastRadius, blastRadiusVault, bootstrapDemo, buildConfiguredRedactor, buildContextPack, buildGraphShareArtifact, buildGraphTree, buildMemoryGraphElements, buildRedactor, checkTrackedRepoChanges, compileVault, computeDecayScore, consolidateVault, createMcpServer, createProvider, createSupersessionEdge, createWebSearchAdapter, defaultVaultConfig, defaultVaultSchema, deleteChatSession, deleteContextPack, deleteManagedSource, detectVaultVersion, discoverLocalWhisperBinary, doctorRetrieval, doctorVault, downloadWhisperModel, ensureMemoryLedger, estimatePageTokens, estimateTokens, evaluateCandidateForPromotion, evaluateGraphShrinkGuard, expectedModelPath, explainGraphVault, exploreVault, exportAiPack, exportGraphFormat, exportGraphHtml, exportGraphReportHtml, exportGraphTree, exportObsidianCanvas, exportObsidianVault, findGraphCycles, finishMemoryTask, getAgentInstallStatus, getGitHookStatus, getGraphCommunityVault, getGraphStatus, getProviderConfigEntry, getProviderForTask, getRetrievalStatus, getWatchStatus, getWebSearchAdapterForTask, getWorkspaceInfo, graphDiff, graphStats, graphStatsVault, guideManagedSource, guideSourceScope, importInbox, ingestDirectory, ingestInput, ingestInputDetailed, initVault, initWorkspace, installAgent, installConfiguredAgents, installGitHooks, lintVault, listApprovals, listCandidates, listChatSessions, listContextPacks, listGodNodes, listGraphHyperedges, listManagedSourceRecords, listManifests, listMemoryTasks, listPages, listProviderConfigEntries, listSchedules, listTrackedRepoRoots, listWatchedRoots, loadMemoryTaskPages, loadVaultConfig, loadVaultSchema, loadVaultSchemas, lookupPresetCapabilities, markSuperseded, memoryTaskHashes, mergeGraphFiles, modelDownloadUrl, pathGraphVault, persistDecayFrontmatter, planMigration, previewCandidatePromotions, projectGraphAfterRemovals, promoteCandidate, providerCapabilitySchema, providerTypeSchema, pushGraphNeo4j, queryGraphVault, queryVault, readApproval, readChatSession, readContextPack, readExtractedText, readGraphReport, readMemoryTask, readPage, rebuildRetrievalIndex, refreshGraphClusters, registerLocalWhisperProvider, rejectApproval, reloadManagedSources, removeProviderConfig, removeWatchedRoot, renderContextPackLlms, renderContextPackMarkdown, renderGraphShareBundleFiles, renderGraphShareMarkdown, renderGraphSharePreviewHtml, renderGraphShareSvg, renderGraphTreeHtml, renderMemoryTaskMarkdown, resetDecay, resolveArtifactRootDir, resolveConsolidationConfig, resolveDecayConfig, resolveLargeRepoDefaults, resolvePaths, resolveRedactionPatterns, resolveRetrievalConfig, resolveWatchedRepoRoots, resumeMemoryTask, resumeSourceSession, reviewManagedSource, reviewSourceScope, runAutoPromotion, runConsolidation, runDecayPass, runMigration, runSchedule, runWatchCycle, searchVault, serveSchedules, stageGeneratedOutputPages, startGraphServer, startMcpServer, startMemoryTask, summarizeLocalWhisperSetup, syncTrackedRepos, syncTrackedReposForWatch, synthesizeHyperedgeHubs, trimToTokenBudget, uninstallGitHooks, updateMemoryTask, validateGraphArtifact, validateGraphVault, watchVault, webSearchProviderTypeSchema, withCapabilityFallback, writeRetrievalManifest };

package/dist/index.js

@@ -37,8 +37,10 @@ import {
   evaluateCandidateForPromotion,
   explainGraphVault,
   exploreVault,
+  findGraphCycles,
   findLatestGuidedSourceSessionByScope,
   finishMemoryTask,
+  getAgentInstallStatus,
   getGraphCommunityVault,
   getRetrievalStatus,
   getWebSearchAdapterForTask,
@@ -128,7 +130,7 @@ import {
   writeGuidedSourceSession,
   writeRetrievalManifest,
   writeWatchStatusArtifact
-} from "./chunk-RN56HUXA.js";
+} from "./chunk-TQIIJVVG.js";
 import {
   LocalWhisperProviderAdapter,
   SWARMVAULT_OUT_ENV,
@@ -145,6 +147,8 @@ import {
   listFilesRecursive,
   loadVaultConfig,
   normalizeWhitespace,
+  providerCapabilitySchema,
+  providerTypeSchema,
   readJsonFile,
   resolveArtifactRootDir,
   resolvePaths,
@@ -155,7 +159,7 @@ import {
   truncate,
   uniqueBy,
   writeJsonFile
-} from "./chunk-H3CDZYRE.js";
+} from "./chunk-NON6BVEI.js";
 import {
   estimatePageTokens,
   estimateTokens,
@@ -2842,6 +2846,71 @@ function renderJson(graph) {
   };
   return JSON.stringify(payload, null, 2);
 }
+function renderCallflowHtml(graph) {
+  const nodes = graphNodeById(graph);
+  const rows = [...graph.edges].filter((edge) => nodes.has(edge.source) && nodes.has(edge.target)).sort((left, right) => {
+    const leftSource = nodes.get(left.source)?.label ?? left.source;
+    const rightSource = nodes.get(right.source)?.label ?? right.source;
+    const leftTarget = nodes.get(left.target)?.label ?? left.target;
+    const rightTarget = nodes.get(right.target)?.label ?? right.target;
+    return leftSource.localeCompare(rightSource) || leftTarget.localeCompare(rightTarget) || left.relation.localeCompare(right.relation) || left.id.localeCompare(right.id);
+  }).map((edge) => {
+    const source = nodes.get(edge.source);
+    const target = nodes.get(edge.target);
+    return [
+      "<tr>",
+      `<td><span class="node-type">${xmlEscape(source?.type ?? "node")}</span>${xmlEscape(source?.label ?? edge.source)}<small>${xmlEscape(edge.source)}</small></td>`,
+      `<td class="relation">${xmlEscape(edge.relation)}</td>`,
+      `<td><span class="node-type">${xmlEscape(target?.type ?? "node")}</span>${xmlEscape(target?.label ?? edge.target)}<small>${xmlEscape(edge.target)}</small></td>`,
+      `<td>${xmlEscape(edge.evidenceClass)}</td>`,
+      `<td>${edge.confidence.toFixed(2)}</td>`,
+      "</tr>"
+    ].join("");
+  }).join("\n");
+  return `<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>SwarmVault Callflow</title>
+  <style>
+    :root { color-scheme: light dark; font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; }
+    body { margin: 0; background: #f8fafc; color: #0f172a; }
+    main { max-width: 1180px; margin: 0 auto; padding: 32px 20px 48px; }
+    h1 { margin: 0 0 6px; font-size: 28px; letter-spacing: 0; }
+    p { margin: 0 0 24px; color: #475569; }
+    table { width: 100%; border-collapse: collapse; background: #fff; border: 1px solid #dbe3ee; }
+    th, td { padding: 10px 12px; border-bottom: 1px solid #e2e8f0; text-align: left; vertical-align: top; }
+    th { background: #eaf0f7; font-size: 12px; text-transform: uppercase; color: #334155; }
+    small { display: block; margin-top: 3px; color: #64748b; font-size: 11px; word-break: break-all; }
+    .relation { font-weight: 700; color: #0f766e; white-space: nowrap; }
+    .node-type { display: inline-block; min-width: 54px; margin-right: 8px; color: #475569; font-size: 11px; text-transform: uppercase; }
+    @media (prefers-color-scheme: dark) {
+      body { background: #020617; color: #e2e8f0; }
+      p, small, .node-type { color: #94a3b8; }
+      table { background: #0f172a; border-color: #334155; }
+      th { background: #1e293b; color: #cbd5e1; }
+      th, td { border-color: #1e293b; }
+      .relation { color: #5eead4; }
+    }
+  </style>
+</head>
+<body>
+  <main>
+    <h1>SwarmVault Callflow</h1>
+    <p>${graph.nodes.length} nodes, ${graph.edges.length} directed relationships, generated ${xmlEscape(graph.generatedAt)}.</p>
+    <table>
+      <thead>
+        <tr><th>Source</th><th>Relation</th><th>Target</th><th>Evidence</th><th>Confidence</th></tr>
+      </thead>
+      <tbody>
+${rows || '<tr><td colspan="5">No directed relationships found.</td></tr>'}
+      </tbody>
+    </table>
+  </main>
+</body>
+</html>`;
+}
 function renderHtmlStandalone(graph) {
   const communities = sortedCommunities(graph);
   const cappedNodes = [...graph.nodes].sort((a, b) => (b.degree ?? 0) - (a.degree ?? 0)).slice(0, 5e3);
@@ -3772,7 +3841,7 @@ async function writeGraphExport(outputPath, content) {
 }
 async function exportGraphFormat(rootDir, format, outputPath) {
   const graph = await loadGraph(rootDir);
-  const rendered = format === "html-standalone" ? renderHtmlStandalone(graph) : format === "json" ? renderJson(graph) : format === "svg" ? renderSvg(graph) : format === "graphml" ? renderGraphMl(graph) : renderCypher(graph);
+  const rendered = format === "html-standalone" ? renderHtmlStandalone(graph) : format === "json" ? renderJson(graph) : format === "callflow" ? renderCallflowHtml(graph) : format === "svg" ? renderSvg(graph) : format === "graphml" ? renderGraphMl(graph) : renderCypher(graph);
   const resolvedPath = await writeGraphExport(outputPath, rendered);
   return { format, outputPath: resolvedPath };
 }
@@ -5441,7 +5510,7 @@ import path12 from "path";
 import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
-var SERVER_VERSION = "3.14.2";
+var SERVER_VERSION = "3.16.0";
 var codeLanguageSchema = z.enum([
   "javascript",
   "jsx",
@@ -6359,6 +6428,137 @@ function asTextResource(uri, text) {
   };
 }
 
+// src/providers/config-store.ts
+var PROVIDER_TASK_KEYS = [
+  "compileProvider",
+  "queryProvider",
+  "lintProvider",
+  "visionProvider",
+  "imageProvider",
+  "embeddingProvider",
+  "audioProvider"
+];
+async function loadRawConfig(rootDir) {
+  await initWorkspace(rootDir);
+  const { paths } = await loadVaultConfig(rootDir);
+  const raw = await readJsonFile(paths.configPath) ?? defaultVaultConfig();
+  return { configPath: paths.configPath, raw };
+}
+function ensureProviders(raw) {
+  if (!raw.providers || typeof raw.providers !== "object" || Array.isArray(raw.providers)) {
+    raw.providers = {};
+  }
+  return raw.providers;
+}
+function ensureTasks(raw) {
+  if (!raw.tasks || typeof raw.tasks !== "object" || Array.isArray(raw.tasks)) {
+    raw.tasks = {};
+  }
+  return raw.tasks;
+}
+function normalizeProvider(provider) {
+  providerTypeSchema.parse(provider.type);
+  if (!provider.model.trim()) {
+    throw new Error("Provider model cannot be empty.");
+  }
+  const rawProvider = provider;
+  if (typeof rawProvider.apiKey === "string") {
+    throw new Error("Provider configs must reference secrets through apiKeyEnv, not literal apiKey values.");
+  }
+  return JSON.parse(
+    JSON.stringify({
+      ...provider,
+      model: provider.model.trim(),
+      capabilities: provider.capabilities?.map((capability) => providerCapabilitySchema.parse(capability))
+    })
+  );
+}
+function assignedTasks(raw, providerId) {
+  const tasks = ensureTasks(raw);
+  return PROVIDER_TASK_KEYS.filter((taskKey) => tasks[taskKey] === providerId);
+}
+function toEntry(raw, id, provider) {
+  return {
+    id,
+    type: provider.type,
+    model: provider.model,
+    baseUrl: provider.baseUrl,
+    apiKeyEnv: provider.apiKeyEnv,
+    capabilities: provider.capabilities ?? [],
+    assignedTasks: assignedTasks(raw, id),
+    provider
+  };
+}
+function assertTaskKeys(tasks) {
+  const requested = tasks ?? [];
+  const valid = new Set(PROVIDER_TASK_KEYS);
+  for (const task of requested) {
+    if (!valid.has(task)) {
+      throw new Error(`Unknown provider task ${String(task)}.`);
+    }
+  }
+  return [...new Set(requested)];
+}
+async function addProviderConfig(options) {
+  const { configPath, raw } = await loadRawConfig(options.rootDir);
+  const providers = ensureProviders(raw);
+  const tasks = ensureTasks(raw);
+  const provider = normalizeProvider(options.provider);
+  const existing = providers[options.providerId];
+  const added = !existing;
+  const updated = !added && JSON.stringify(existing) !== JSON.stringify(provider);
+  providers[options.providerId] = provider;
+  const updatedTasks = assertTaskKeys(options.tasks);
+  for (const taskKey of updatedTasks) {
+    tasks[taskKey] = options.providerId;
+  }
+  await writeJsonFile(configPath, raw);
+  return {
+    providerId: options.providerId,
+    configPath,
+    added,
+    updated,
+    updatedTasks
+  };
+}
+async function listProviderConfigEntries(rootDir) {
+  const { raw } = await loadRawConfig(rootDir);
+  const providers = ensureProviders(raw);
+  return Object.entries(providers).map(([id, provider]) => toEntry(raw, id, provider)).sort((left, right) => left.id.localeCompare(right.id));
+}
+async function getProviderConfigEntry(rootDir, providerId) {
+  const { raw } = await loadRawConfig(rootDir);
+  const providers = ensureProviders(raw);
+  const provider = providers[providerId];
+  return provider ? toEntry(raw, providerId, provider) : null;
+}
+async function removeProviderConfig(options) {
+  const { configPath, raw } = await loadRawConfig(options.rootDir);
+  const providers = ensureProviders(raw);
+  const tasks = ensureTasks(raw);
+  const removed = Boolean(providers[options.providerId]);
+  delete providers[options.providerId];
+  const fallbackProviderId = options.fallbackProviderId ?? (providers.local ? "local" : Object.keys(providers).sort((left, right) => left.localeCompare(right))[0]);
+  const updatedTasks = [];
+  for (const taskKey of PROVIDER_TASK_KEYS) {
+    if (tasks[taskKey] === options.providerId) {
+      if (!fallbackProviderId) {
+        delete tasks[taskKey];
+      } else {
+        tasks[taskKey] = fallbackProviderId;
+      }
+      updatedTasks.push(taskKey);
+    }
+  }
+  await writeJsonFile(configPath, raw);
+  return {
+    providerId: options.providerId,
+    configPath,
+    removed,
+    updatedTasks
+  };
+}
+
 // src/providers/local-whisper-setup.ts
 import { createWriteStream, constants as fsConstants } from "fs";
 import fs11 from "fs/promises";
@@ -9548,6 +9748,7 @@ export {
   acceptApproval,
   addInput,
   addManagedSource,
+  addProviderConfig,
   addWatchedRoot,
   applyDecayToPages,
   archiveCandidate,
@@ -9597,10 +9798,13 @@ export {
   exportGraphTree,
   exportObsidianCanvas,
   exportObsidianVault,
+  findGraphCycles,
   finishMemoryTask,
+  getAgentInstallStatus,
   getGitHookStatus,
   getGraphCommunityVault,
   getGraphStatus,
+  getProviderConfigEntry,
   getProviderForTask,
   getRetrievalStatus,
   getWatchStatus,
@@ -9631,6 +9835,7 @@ export {
   listManifests,
   listMemoryTasks,
   listPages,
+  listProviderConfigEntries,
   listSchedules,
   listTrackedRepoRoots,
   listWatchedRoots,
@@ -9664,6 +9869,7 @@ export {
   registerLocalWhisperProvider,
   rejectApproval,
   reloadManagedSources,
+  removeProviderConfig,
   removeWatchedRoot,
   renderContextPackLlms,
   renderContextPackMarkdown,

package/dist/memory-4BDKH4Y2.js

@@ -0,0 +1,32 @@
+import {
+  buildMemoryGraphElements,
+  ensureMemoryLedger,
+  estimateMemoryTaskTokens,
+  finishMemoryTask,
+  listMemoryTasks,
+  loadMemoryTaskPages,
+  memoryTaskHashes,
+  memoryTaskPageRecord,
+  readMemoryTask,
+  renderMemoryTaskMarkdown,
+  resumeMemoryTask,
+  startMemoryTask,
+  updateMemoryTask
+} from "./chunk-TQIIJVVG.js";
+import "./chunk-NON6BVEI.js";
+import "./chunk-NAIERP4C.js";
+export {
+  buildMemoryGraphElements,
+  ensureMemoryLedger,
+  estimateMemoryTaskTokens,
+  finishMemoryTask,
+  listMemoryTasks,
+  loadMemoryTaskPages,
+  memoryTaskHashes,
+  memoryTaskPageRecord,
+  readMemoryTask,
+  renderMemoryTaskMarkdown,
+  resumeMemoryTask,
+  startMemoryTask,
+  updateMemoryTask
+};

package/dist/memory-PK55JUKG.js

@@ -0,0 +1,32 @@
+import {
+  buildMemoryGraphElements,
+  ensureMemoryLedger,
+  estimateMemoryTaskTokens,
+  finishMemoryTask,
+  listMemoryTasks,
+  loadMemoryTaskPages,
+  memoryTaskHashes,
+  memoryTaskPageRecord,
+  readMemoryTask,
+  renderMemoryTaskMarkdown,
+  resumeMemoryTask,
+  startMemoryTask,
+  updateMemoryTask
+} from "./chunk-JJDJF2P3.js";
+import "./chunk-NUWZUYE7.js";
+import "./chunk-NAIERP4C.js";
+export {
+  buildMemoryGraphElements,
+  ensureMemoryLedger,
+  estimateMemoryTaskTokens,
+  finishMemoryTask,
+  listMemoryTasks,
+  loadMemoryTaskPages,
+  memoryTaskHashes,
+  memoryTaskPageRecord,
+  readMemoryTask,
+  renderMemoryTaskMarkdown,
+  resumeMemoryTask,
+  startMemoryTask,
+  updateMemoryTask
+};

package/dist/memory-QCVKS3H4.js

@@ -0,0 +1,32 @@
+import {
+  buildMemoryGraphElements,
+  ensureMemoryLedger,
+  estimateMemoryTaskTokens,
+  finishMemoryTask,
+  listMemoryTasks,
+  loadMemoryTaskPages,
+  memoryTaskHashes,
+  memoryTaskPageRecord,
+  readMemoryTask,
+  renderMemoryTaskMarkdown,
+  resumeMemoryTask,
+  startMemoryTask,
+  updateMemoryTask
+} from "./chunk-L7DKPPV4.js";
+import "./chunk-NON6BVEI.js";
+import "./chunk-NAIERP4C.js";
+export {
+  buildMemoryGraphElements,
+  ensureMemoryLedger,
+  estimateMemoryTaskTokens,
+  finishMemoryTask,
+  listMemoryTasks,
+  loadMemoryTaskPages,
+  memoryTaskHashes,
+  memoryTaskPageRecord,
+  readMemoryTask,
+  renderMemoryTaskMarkdown,
+  resumeMemoryTask,
+  startMemoryTask,
+  updateMemoryTask
+};

package/dist/registry-ILDEBNCW.js

@@ -0,0 +1,12 @@
+import {
+  assertProviderCapability,
+  createProvider,
+  getProviderForTask,
+  getResolvedPaths
+} from "./chunk-NUWZUYE7.js";
+export {
+  assertProviderCapability,
+  createProvider,
+  getProviderForTask,
+  getResolvedPaths
+};

package/dist/registry-ZZ6NESFD.js

@@ -0,0 +1,12 @@
+import {
+  assertProviderCapability,
+  createProvider,
+  getProviderForTask,
+  getResolvedPaths
+} from "./chunk-NON6BVEI.js";
+export {
+  assertProviderCapability,
+  createProvider,
+  getProviderForTask,
+  getResolvedPaths
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmvaultai/engine",
-  "version": "3.14.2",
+  "version": "3.16.0",
   "description": "Core engine for SwarmVault: ingest, compile, query, lint, and provider abstractions.",
   "type": "module",
   "main": "dist/index.js",