@swarmvaultai/engine 0.1.0

package/README.md

@@ -0,0 +1,5 @@
+# @swarmvaultai/engine
+
+Core library for SwarmVault.
+
+It provides the ingest, compile, query, lint, provider, search, and graph-generation primitives used by the CLI.

package/dist/index.d.ts

@@ -0,0 +1,233 @@
+import { z } from 'zod';
+
+declare const providerCapabilitySchema: z.ZodEnum<{
+    responses: "responses";
+    chat: "chat";
+    structured: "structured";
+    tools: "tools";
+    vision: "vision";
+    embeddings: "embeddings";
+    streaming: "streaming";
+    local: "local";
+}>;
+type ProviderCapability = z.infer<typeof providerCapabilitySchema>;
+declare const providerTypeSchema: z.ZodEnum<{
+    heuristic: "heuristic";
+    openai: "openai";
+    ollama: "ollama";
+    anthropic: "anthropic";
+    gemini: "gemini";
+    "openai-compatible": "openai-compatible";
+    custom: "custom";
+}>;
+type ProviderType = z.infer<typeof providerTypeSchema>;
+type PageKind = "index" | "source" | "concept" | "entity" | "output";
+type Freshness = "fresh" | "stale";
+type ClaimStatus = "extracted" | "inferred" | "conflicted" | "stale";
+type Polarity = "positive" | "negative" | "neutral";
+interface GenerationAttachment {
+    mimeType: string;
+    filePath: string;
+}
+interface GenerationRequest {
+    system?: string;
+    prompt: string;
+    attachments?: GenerationAttachment[];
+    maxOutputTokens?: number;
+}
+interface GenerationResponse {
+    text: string;
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+    };
+}
+interface ProviderAdapter {
+    readonly id: string;
+    readonly type: ProviderType;
+    readonly model: string;
+    readonly capabilities: Set<ProviderCapability>;
+    generateText(request: GenerationRequest): Promise<GenerationResponse>;
+    generateStructured<T>(request: GenerationRequest, schema: z.ZodType<T>): Promise<T>;
+}
+interface ProviderConfig {
+    type: ProviderType;
+    model: string;
+    baseUrl?: string;
+    apiKeyEnv?: string;
+    headers?: Record<string, string>;
+    module?: string;
+    capabilities?: ProviderCapability[];
+    apiStyle?: "responses" | "chat";
+}
+interface VaultConfig {
+    workspace: {
+        rawDir: string;
+        wikiDir: string;
+        stateDir: string;
+        agentDir: string;
+    };
+    providers: Record<string, ProviderConfig>;
+    tasks: {
+        compileProvider: string;
+        queryProvider: string;
+        lintProvider: string;
+        visionProvider: string;
+    };
+    viewer: {
+        port: number;
+    };
+    agents: Array<"codex" | "claude" | "cursor">;
+}
+interface ResolvedPaths {
+    rootDir: string;
+    rawDir: string;
+    wikiDir: string;
+    stateDir: string;
+    agentDir: string;
+    manifestsDir: string;
+    extractsDir: string;
+    analysesDir: string;
+    viewerDistDir: string;
+    graphPath: string;
+    searchDbPath: string;
+    compileStatePath: string;
+    configPath: string;
+}
+interface SourceManifest {
+    sourceId: string;
+    title: string;
+    originType: "file" | "url";
+    sourceKind: "markdown" | "text" | "pdf" | "image" | "html" | "binary";
+    originalPath?: string;
+    url?: string;
+    storedPath: string;
+    extractedTextPath?: string;
+    mimeType: string;
+    contentHash: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface AnalyzedTerm {
+    id: string;
+    name: string;
+    description: string;
+}
+interface SourceClaim {
+    id: string;
+    text: string;
+    confidence: number;
+    status: ClaimStatus;
+    polarity: Polarity;
+    citation: string;
+}
+interface SourceAnalysis {
+    sourceId: string;
+    sourceHash: string;
+    title: string;
+    summary: string;
+    concepts: AnalyzedTerm[];
+    entities: AnalyzedTerm[];
+    claims: SourceClaim[];
+    questions: string[];
+    producedAt: string;
+}
+interface GraphNode {
+    id: string;
+    type: "source" | "concept" | "entity";
+    label: string;
+    pageId?: string;
+    freshness?: Freshness;
+    confidence?: number;
+    sourceIds: string[];
+}
+interface GraphEdge {
+    id: string;
+    source: string;
+    target: string;
+    relation: string;
+    status: ClaimStatus;
+    confidence: number;
+    provenance: string[];
+}
+interface GraphPage {
+    id: string;
+    path: string;
+    title: string;
+    kind: PageKind;
+    sourceIds: string[];
+    nodeIds: string[];
+    freshness: Freshness;
+    confidence: number;
+    backlinks: string[];
+    sourceHashes: Record<string, string>;
+}
+interface GraphArtifact {
+    generatedAt: string;
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+    sources: SourceManifest[];
+    pages: GraphPage[];
+}
+interface CompileResult {
+    graphPath: string;
+    pageCount: number;
+    changedPages: string[];
+    sourceCount: number;
+}
+interface SearchResult {
+    pageId: string;
+    path: string;
+    title: string;
+    snippet: string;
+    rank: number;
+}
+interface QueryResult {
+    answer: string;
+    savedTo?: string;
+    citations: string[];
+}
+interface LintFinding {
+    severity: "error" | "warning" | "info";
+    code: string;
+    message: string;
+    pagePath?: string;
+}
+
+declare function defaultVaultConfig(): VaultConfig;
+declare function resolvePaths(rootDir: string, config?: VaultConfig, configPath?: string): ResolvedPaths;
+declare function loadVaultConfig(rootDir: string): Promise<{
+    config: VaultConfig;
+    paths: ResolvedPaths;
+}>;
+declare function initWorkspace(rootDir: string): Promise<{
+    config: VaultConfig;
+    paths: ResolvedPaths;
+}>;
+
+declare function ingestInput(rootDir: string, input: string): Promise<SourceManifest>;
+declare function listManifests(rootDir: string): Promise<SourceManifest[]>;
+declare function readExtractedText(rootDir: string, manifest: SourceManifest): Promise<string | undefined>;
+
+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 lintVault(rootDir: string): Promise<LintFinding[]>;
+declare function bootstrapDemo(rootDir: string, input?: string): Promise<{
+    manifestId?: string;
+    compile?: CompileResult;
+}>;
+
+declare function installAgent(rootDir: string, agent: "codex" | "claude" | "cursor"): Promise<string>;
+declare function installConfiguredAgents(rootDir: string): Promise<string[]>;
+
+declare function startGraphServer(rootDir: string, port?: number): Promise<{
+    port: number;
+    close: () => Promise<void>;
+}>;
+
+declare function createProvider(id: string, config: ProviderConfig, rootDir: string): Promise<ProviderAdapter>;
+declare function getProviderForTask(rootDir: string, task: keyof Awaited<ReturnType<typeof loadVaultConfig>>["config"]["tasks"]): Promise<ProviderAdapter>;
+declare function assertProviderCapability(provider: ProviderAdapter, capability: ProviderCapability): void;
+
+export { type AnalyzedTerm, type ClaimStatus, type CompileResult, type Freshness, type GenerationAttachment, type GenerationRequest, type GenerationResponse, type GraphArtifact, type GraphEdge, type GraphNode, type GraphPage, type LintFinding, type PageKind, type Polarity, type ProviderAdapter, type ProviderCapability, type ProviderConfig, type ProviderType, type QueryResult, type ResolvedPaths, type SearchResult, type SourceAnalysis, type SourceClaim, type SourceManifest, type VaultConfig, assertProviderCapability, bootstrapDemo, compileVault, createProvider, defaultVaultConfig, getProviderForTask, ingestInput, initVault, initWorkspace, installAgent, installConfiguredAgents, lintVault, listManifests, loadVaultConfig, providerCapabilitySchema, providerTypeSchema, queryVault, readExtractedText, resolvePaths, startGraphServer };