@swarmvaultai/engine 0.1.5 → 0.1.7

package/dist/index.d.ts

@@ -14,6 +14,7 @@ declare const providerCapabilitySchema: z.ZodEnum<{
     embeddings: "embeddings";
     streaming: "streaming";
     local: "local";
+    image_generation: "image_generation";
 }>;
 type ProviderCapability = z.infer<typeof providerCapabilitySchema>;
 declare const providerTypeSchema: z.ZodEnum<{
@@ -26,11 +27,21 @@ declare const providerTypeSchema: z.ZodEnum<{
     custom: "custom";
 }>;
 type ProviderType = z.infer<typeof providerTypeSchema>;
-type PageKind = "index" | "source" | "concept" | "entity" | "output";
+type PageKind = "index" | "source" | "module" | "concept" | "entity" | "output" | "insight";
 type Freshness = "fresh" | "stale";
 type ClaimStatus = "extracted" | "inferred" | "conflicted" | "stale";
 type Polarity = "positive" | "negative" | "neutral";
 type OutputOrigin = "query" | "explore";
+type OutputFormat = "markdown" | "report" | "slides" | "chart" | "image";
+type OutputAssetRole = "primary" | "preview" | "manifest" | "poster";
+type PageStatus = "draft" | "candidate" | "active" | "archived";
+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";
+type CodeSymbolKind = "function" | "class" | "interface" | "type_alias" | "enum" | "variable";
+type OrchestrationRole = "research" | "audit" | "context" | "safety";
 declare const webSearchProviderTypeSchema: z.ZodEnum<{
     custom: "custom";
     "http-json": "http-json";
@@ -53,6 +64,20 @@ interface GenerationResponse {
         outputTokens?: number;
     };
 }
+interface ImageGenerationRequest {
+    prompt: string;
+    system?: string;
+    width?: number;
+    height?: number;
+    attachments?: GenerationAttachment[];
+}
+interface ImageGenerationResponse {
+    mimeType: string;
+    bytes: Uint8Array;
+    width?: number;
+    height?: number;
+    revisedPrompt?: string;
+}
 interface ProviderAdapter {
     readonly id: string;
     readonly type: ProviderType;
@@ -60,6 +85,7 @@ interface ProviderAdapter {
     readonly capabilities: Set<ProviderCapability>;
     generateText(request: GenerationRequest): Promise<GenerationResponse>;
     generateStructured<T>(request: GenerationRequest, schema: z.ZodType<T>): Promise<T>;
+    generateImage?(request: ImageGenerationRequest): Promise<ImageGenerationResponse>;
 }
 interface ProviderConfig {
     type: ProviderType;
@@ -111,11 +137,18 @@ interface VaultConfig {
         queryProvider: string;
         lintProvider: string;
         visionProvider: string;
+        imageProvider?: string;
     };
     viewer: {
         port: number;
     };
+    projects?: Record<string, {
+        roots: string[];
+        schemaPath?: string;
+    }>;
     agents: Array<"codex" | "claude" | "cursor">;
+    schedules?: Record<string, ScheduleJobConfig>;
+    orchestration?: OrchestrationConfig;
     webSearch?: {
         providers: Record<string, WebSearchProviderConfig>;
         tasks: {
@@ -130,7 +163,13 @@ interface ResolvedPaths {
     rawSourcesDir: string;
     rawAssetsDir: string;
     wikiDir: string;
+    outputsAssetsDir: string;
+    projectsDir: string;
+    candidatesDir: string;
+    candidateConceptsDir: string;
+    candidateEntitiesDir: string;
     stateDir: string;
+    schedulesDir: string;
     agentDir: string;
     inboxDir: string;
     manifestsDir: string;
@@ -141,6 +180,8 @@ interface ResolvedPaths {
     searchDbPath: string;
     compileStatePath: string;
     jobsLogPath: string;
+    sessionsDir: string;
+    approvalsDir: string;
     configPath: string;
 }
 interface SourceAttachment {
@@ -152,7 +193,8 @@ interface SourceManifest {
     sourceId: string;
     title: string;
     originType: "file" | "url";
-    sourceKind: "markdown" | "text" | "pdf" | "image" | "html" | "binary";
+    sourceKind: SourceKind;
+    language?: CodeLanguage;
     originalPath?: string;
     url?: string;
     storedPath: string;
@@ -176,6 +218,41 @@ interface SourceClaim {
     polarity: Polarity;
     citation: string;
 }
+interface CodeImport {
+    specifier: string;
+    importedSymbols: string[];
+    defaultImport?: string;
+    namespaceImport?: string;
+    isTypeOnly?: boolean;
+    isExternal: boolean;
+    reExport: boolean;
+}
+interface CodeDiagnostic {
+    code: number;
+    category: "warning" | "error" | "message" | "suggestion";
+    message: string;
+    line: number;
+    column: number;
+}
+interface CodeSymbol {
+    id: string;
+    name: string;
+    kind: CodeSymbolKind;
+    signature: string;
+    exported: boolean;
+    calls: string[];
+    extends: string[];
+    implements: string[];
+}
+interface CodeAnalysis {
+    moduleId: string;
+    language: CodeLanguage;
+    imports: CodeImport[];
+    dependencies: string[];
+    symbols: CodeSymbol[];
+    exports: string[];
+    diagnostics: CodeDiagnostic[];
+}
 interface SourceAnalysis {
     sourceId: string;
     sourceHash: string;
@@ -186,16 +263,25 @@ interface SourceAnalysis {
     entities: AnalyzedTerm[];
     claims: SourceClaim[];
     questions: string[];
+    code?: CodeAnalysis;
     producedAt: string;
 }
 interface GraphNode {
     id: string;
-    type: "source" | "concept" | "entity";
+    type: "source" | "concept" | "entity" | "module" | "symbol";
     label: string;
     pageId?: string;
     freshness?: Freshness;
     confidence?: number;
     sourceIds: string[];
+    projectIds: string[];
+    language?: CodeLanguage;
+    moduleId?: string;
+    symbolKind?: CodeSymbolKind;
+    communityId?: string;
+    degree?: number;
+    bridgeScore?: number;
+    isGodNode?: boolean;
 }
 interface GraphEdge {
     id: string;
@@ -212,8 +298,10 @@ interface GraphPage {
     title: string;
     kind: PageKind;
     sourceIds: string[];
+    projectIds: string[];
     nodeIds: string[];
     freshness: Freshness;
+    status: PageStatus;
     confidence: number;
     backlinks: string[];
     schemaHash: string;
@@ -221,21 +309,88 @@ interface GraphPage {
     relatedPageIds: string[];
     relatedNodeIds: string[];
     relatedSourceIds: string[];
+    createdAt: string;
+    updatedAt: string;
+    compiledFrom: string[];
+    managedBy: PageManager;
     origin?: OutputOrigin;
     question?: string;
+    outputFormat?: OutputFormat;
+    outputAssets?: OutputAsset[];
 }
 interface GraphArtifact {
     generatedAt: string;
     nodes: GraphNode[];
     edges: GraphEdge[];
+    communities?: Array<{
+        id: string;
+        label: string;
+        nodeIds: string[];
+    }>;
     sources: SourceManifest[];
     pages: GraphPage[];
 }
+interface ApprovalEntry {
+    pageId: string;
+    title: string;
+    kind: PageKind;
+    changeType: ApprovalChangeType;
+    status: ApprovalEntryStatus;
+    sourceIds: string[];
+    nextPath?: string;
+    previousPath?: string;
+}
+interface ApprovalManifest {
+    approvalId: string;
+    createdAt: string;
+    entries: ApprovalEntry[];
+}
+interface ApprovalSummary {
+    approvalId: string;
+    createdAt: string;
+    entryCount: number;
+    pendingCount: number;
+    acceptedCount: number;
+    rejectedCount: number;
+}
+interface ApprovalEntryDetail extends ApprovalEntry {
+    currentContent?: string;
+    stagedContent?: string;
+}
+interface ApprovalDetail extends ApprovalSummary {
+    entries: ApprovalEntryDetail[];
+}
+interface ReviewActionResult extends ApprovalSummary {
+    updatedEntries: string[];
+}
+interface CandidateRecord {
+    pageId: string;
+    title: string;
+    kind: "concept" | "entity";
+    path: string;
+    activePath: string;
+    sourceIds: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+interface CompileOptions {
+    approve?: boolean;
+}
+interface InitOptions {
+    obsidian?: boolean;
+}
 interface CompileResult {
     graphPath: string;
     pageCount: number;
     changedPages: string[];
     sourceCount: number;
+    staged: boolean;
+    approvalId?: string;
+    approvalDir?: string;
+    postPassApprovalId?: string;
+    postPassApprovalDir?: string;
+    promotedPageIds: string[];
+    candidatePageCount: number;
 }
 interface SearchResult {
     pageId: string;
@@ -243,15 +398,31 @@ interface SearchResult {
     title: string;
     snippet: string;
     rank: number;
+    kind?: PageKind;
+    status?: PageStatus;
+    projectIds: string[];
+}
+interface QueryOptions {
+    question: string;
+    save?: boolean;
+    format?: OutputFormat;
+    review?: boolean;
 }
 interface QueryResult {
     answer: string;
-    savedTo?: string;
+    savedPath?: string;
+    stagedPath?: string;
     savedPageId?: string;
     citations: string[];
     relatedPageIds: string[];
     relatedNodeIds: string[];
     relatedSourceIds: string[];
+    outputFormat: OutputFormat;
+    saved: boolean;
+    staged: boolean;
+    approvalId?: string;
+    approvalDir?: string;
+    outputAssets: OutputAsset[];
 }
 interface LintFinding {
     severity: "error" | "warning" | "info";
@@ -297,31 +468,198 @@ interface WatchController {
 }
 interface CompileState {
     generatedAt: string;
-    schemaHash: string;
+    rootSchemaHash: string;
+    projectSchemaHashes: Record<string, string>;
+    effectiveSchemaHashes: {
+        global: string;
+        projects: Record<string, string>;
+    };
+    projectConfigHash: string;
     analyses: Record<string, string>;
     sourceHashes: Record<string, string>;
+    sourceProjects: Record<string, string | null>;
     outputHashes: Record<string, string>;
+    insightHashes: Record<string, string>;
+    candidateHistory: Record<string, {
+        sourceIds: string[];
+        status: "candidate" | "active";
+    }>;
 }
 interface LintOptions {
     deep?: boolean;
     web?: boolean;
 }
+interface ExploreOptions {
+    question: string;
+    steps?: number;
+    format?: OutputFormat;
+    review?: boolean;
+}
 interface ExploreStepResult {
     step: number;
     question: string;
     answer: string;
-    savedTo: string;
+    savedPath?: string;
+    stagedPath?: string;
     savedPageId: string;
     citations: string[];
     followUpQuestions: string[];
+    outputFormat: OutputFormat;
+    outputAssets: OutputAsset[];
 }
 interface ExploreResult {
     rootQuestion: string;
-    hubPath: string;
+    hubPath?: string;
+    stagedHubPath?: string;
     hubPageId: string;
     stepCount: number;
     steps: ExploreStepResult[];
     suggestedQuestions: string[];
+    outputFormat: OutputFormat;
+    staged: boolean;
+    approvalId?: string;
+    approvalDir?: string;
+    hubAssets: OutputAsset[];
+}
+interface OutputAsset {
+    id: string;
+    role: OutputAssetRole;
+    path: string;
+    mimeType: string;
+    width?: number;
+    height?: number;
+    dataPath?: string;
+}
+interface ChartDatum {
+    label: string;
+    value: number;
+}
+interface ChartSpec {
+    kind: "bar" | "line";
+    title: string;
+    subtitle?: string;
+    xLabel?: string;
+    yLabel?: string;
+    seriesLabel?: string;
+    data: ChartDatum[];
+    notes?: string[];
+}
+interface SceneElement {
+    kind: "shape" | "label";
+    shape?: "rect" | "circle" | "line";
+    x: number;
+    y: number;
+    width?: number;
+    height?: number;
+    radius?: number;
+    text?: string;
+    fontSize?: number;
+    fill?: string;
+    stroke?: string;
+    strokeWidth?: number;
+    opacity?: number;
+}
+interface SceneSpec {
+    title: string;
+    alt: string;
+    background?: string;
+    width?: number;
+    height?: number;
+    elements: SceneElement[];
+}
+interface ScheduledCompileTask {
+    type: "compile";
+    approve?: boolean;
+}
+interface ScheduledLintTask {
+    type: "lint";
+    deep?: boolean;
+    web?: boolean;
+}
+interface ScheduledQueryTask {
+    type: "query";
+    question: string;
+    format?: OutputFormat;
+    save?: boolean;
+}
+interface ScheduledExploreTask {
+    type: "explore";
+    question: string;
+    steps?: number;
+    format?: OutputFormat;
+}
+type ScheduledTaskConfig = ScheduledCompileTask | ScheduledLintTask | ScheduledQueryTask | ScheduledExploreTask;
+interface ScheduleTriggerConfig {
+    cron?: string;
+    every?: string;
+}
+interface ScheduleJobConfig {
+    enabled?: boolean;
+    when: ScheduleTriggerConfig;
+    task: ScheduledTaskConfig;
+}
+interface ProviderRoleExecutorConfig {
+    type: "provider";
+    provider: string;
+}
+interface CommandRoleExecutorConfig {
+    type: "command";
+    command: string[];
+    cwd?: string;
+    env?: Record<string, string>;
+    timeoutMs?: number;
+}
+type RoleExecutorConfig = ProviderRoleExecutorConfig | CommandRoleExecutorConfig;
+interface OrchestrationRoleConfig {
+    executor: RoleExecutorConfig;
+}
+interface OrchestrationConfig {
+    maxParallelRoles?: number;
+    compilePostPass?: boolean;
+    roles?: Partial<Record<OrchestrationRole, OrchestrationRoleConfig>>;
+}
+interface OrchestrationFinding {
+    role: OrchestrationRole;
+    severity: "error" | "warning" | "info";
+    message: string;
+    relatedPageIds?: string[];
+    relatedSourceIds?: string[];
+    suggestedQuery?: string;
+}
+interface OrchestrationProposal {
+    path: string;
+    content: string;
+    reason: string;
+}
+interface OrchestrationRoleResult {
+    role: OrchestrationRole;
+    summary?: string;
+    findings: OrchestrationFinding[];
+    questions: string[];
+    proposals: OrchestrationProposal[];
+}
+interface ScheduleStateRecord {
+    jobId: string;
+    enabled: boolean;
+    taskType: ScheduledTaskConfig["type"];
+    nextRunAt?: string;
+    lastRunAt?: string;
+    lastStatus?: "success" | "failed";
+    lastSessionId?: string;
+    lastApprovalId?: string;
+    error?: string;
+}
+interface ScheduledRunResult {
+    jobId: string;
+    taskType: ScheduledTaskConfig["type"];
+    startedAt: string;
+    finishedAt: string;
+    success: boolean;
+    approvalId?: string;
+    error?: string;
+}
+interface ScheduleController {
+    close(): Promise<void>;
 }
 
 declare function defaultVaultConfig(): VaultConfig;
@@ -354,14 +692,29 @@ interface VaultSchema {
     path: string;
     content: string;
     hash: string;
-    isLegacyPath: boolean;
 }
+interface LoadedVaultSchemas {
+    root: VaultSchema;
+    projects: Record<string, VaultSchema>;
+    effective: {
+        global: VaultSchema;
+        projects: Record<string, VaultSchema>;
+    };
+}
+declare function loadVaultSchemas(rootDir: string): Promise<LoadedVaultSchemas>;
 declare function loadVaultSchema(rootDir: string): Promise<VaultSchema>;
 
-declare function initVault(rootDir: string): Promise<void>;
-declare function compileVault(rootDir: string): Promise<CompileResult>;
-declare function queryVault(rootDir: string, question: string, save?: boolean): Promise<QueryResult>;
-declare function exploreVault(rootDir: string, question: string, steps?: number): Promise<ExploreResult>;
+declare function listApprovals(rootDir: string): Promise<ApprovalSummary[]>;
+declare function readApproval(rootDir: string, approvalId: string): Promise<ApprovalDetail>;
+declare function acceptApproval(rootDir: string, approvalId: string, targets?: string[]): Promise<ReviewActionResult>;
+declare function rejectApproval(rootDir: string, approvalId: string, targets?: string[]): Promise<ReviewActionResult>;
+declare function listCandidates(rootDir: string): Promise<CandidateRecord[]>;
+declare function promoteCandidate(rootDir: string, target: string): Promise<CandidateRecord>;
+declare function archiveCandidate(rootDir: string, target: string): Promise<CandidateRecord>;
+declare function initVault(rootDir: string, options?: InitOptions): Promise<void>;
+declare function compileVault(rootDir: string, options?: CompileOptions): Promise<CompileResult>;
+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 listPages(rootDir: string): Promise<GraphPage[]>;
 declare function readPage(rootDir: string, relativePath: string): Promise<{
@@ -392,10 +745,15 @@ declare function startGraphServer(rootDir: string, port?: number): Promise<{
     port: number;
     close: () => Promise<void>;
 }>;
+declare function exportGraphHtml(rootDir: string, outputPath: string): Promise<string>;
+
+declare function listSchedules(rootDir: string): Promise<ScheduleStateRecord[]>;
+declare function runSchedule(rootDir: string, jobId: string): Promise<ScheduledRunResult>;
+declare function serveSchedules(rootDir: string, pollMs?: number): Promise<ScheduleController>;
 
 declare function watchVault(rootDir: string, options?: WatchOptions): Promise<WatchController>;
 
 declare function createWebSearchAdapter(id: string, config: WebSearchProviderConfig, rootDir: string): Promise<WebSearchAdapter>;
 declare function getWebSearchAdapterForTask(rootDir: string, task: "deepLintProvider"): Promise<WebSearchAdapter>;
 
-export { type AnalyzedTerm, type ClaimStatus, type CompileResult, type CompileState, type ExploreResult, type ExploreStepResult, type Freshness, type GenerationAttachment, type GenerationRequest, type GenerationResponse, type GraphArtifact, type GraphEdge, type GraphNode, type GraphPage, type InboxImportResult, type InboxImportSkip, type LintFinding, type LintOptions, type OutputOrigin, type PageKind, type Polarity, type ProviderAdapter, type ProviderCapability, type ProviderConfig, type ProviderType, type QueryResult, type ResolvedPaths, type SearchResult, type SourceAnalysis, type SourceAttachment, type SourceClaim, type SourceManifest, type VaultConfig, type WatchController, type WatchOptions, type WatchRunRecord, type WebSearchAdapter, type WebSearchProviderConfig, type WebSearchProviderType, type WebSearchResult, assertProviderCapability, bootstrapDemo, compileVault, createMcpServer, createProvider, createWebSearchAdapter, defaultVaultConfig, defaultVaultSchema, exploreVault, getProviderForTask, getWebSearchAdapterForTask, getWorkspaceInfo, importInbox, ingestInput, initVault, initWorkspace, installAgent, installConfiguredAgents, lintVault, listManifests, listPages, loadVaultConfig, loadVaultSchema, providerCapabilitySchema, providerTypeSchema, queryVault, readExtractedText, readPage, resolvePaths, searchVault, startGraphServer, startMcpServer, watchVault, webSearchProviderTypeSchema };
+export { 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 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, 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 };