mnemosyne-core 2.0.0

package/dist/Store-N3j0Vaj6.d.ts

@@ -0,0 +1,320 @@
+import Database from 'better-sqlite3';
+
+type PermissionLevel = "none" | "view" | "suggest" | "edit" | "create" | "admin";
+type Action = "create" | "read" | "write" | "update" | "delete" | "lock" | "manage_queue" | "force_release" | "peek" | "export" | "import" | "suggest";
+type AssistantRole = "owner" | "admin" | "manager" | "lead" | "developer" | "worker" | "reviewer" | "observer" | "bot" | "guest";
+interface Project {
+    id: string;
+    name: string;
+    description: string | null;
+    icon: string;
+    color: string;
+    created_at: number;
+    updated_at: number;
+    owner: string;
+    metadata: Record<string, any>;
+}
+interface Atom {
+    id: string;
+    project_id: string;
+    parent_id: string | null;
+    title: string;
+    summary: string | null;
+    icon: string;
+    color: string | null;
+    x: number | null;
+    y: number | null;
+    created_at: number;
+    updated_at: number;
+    version: number;
+    locked_by: string | null;
+    locked_at: number | null;
+    locked_reason: string | null;
+    owner: string;
+    status: string;
+    metadata: Record<string, any>;
+    auto_path?: string;
+    path_overridden?: boolean;
+    status_updated_at?: number;
+    block_count?: number;
+    bond_count?: number;
+    template_id?: string | null;
+    embedding_status?: string | null;
+}
+interface Block {
+    id: string;
+    atom_id: string;
+    type: string;
+    content: string | null;
+    order_index: number;
+    created_at: number;
+    updated_at: number;
+    metadata: Record<string, any>;
+}
+interface Bond {
+    id: string;
+    source_id: string;
+    target_id: string;
+    label: string;
+    color: string | null;
+    created_at: number;
+}
+interface Assistant {
+    id: string;
+    name: string;
+    role: AssistantRole;
+    permissions: Record<string, any>;
+    status: string;
+    provider: string | null;
+    connected_at: number;
+    last_seen: number;
+    metadata: Record<string, any>;
+}
+interface QueueEntry {
+    id: string;
+    atom_id: string;
+    assistant_id: string;
+    requested_at: number;
+    priority: number;
+    status: string;
+    reason: string | null;
+}
+interface EventLogEntry {
+    id: string;
+    timestamp: number;
+    event_type: string;
+    project_id: string | null;
+    atom_id: string | null;
+    block_id: string | null;
+    bond_id: string | null;
+    actor: string;
+    actor_type: string;
+    diff: string | null;
+    trigger: string | null;
+    metadata: Record<string, any>;
+}
+interface Config {
+    server: {
+        port: number;
+        host: string;
+        version: string;
+    };
+    database: {
+        path: string;
+        wal_mode: boolean;
+        vec_extension_path: string;
+    };
+    storage: {
+        files_dir: string;
+        max_file_size_mb: number;
+        backups_dir: string;
+        backup_interval_hours: number;
+        max_backups: number;
+    };
+    limits: {
+        max_atoms_per_project: number;
+        rate_limit_requests: number;
+        rate_limit_window_ms: number;
+    };
+    embeddings: {
+        model: string;
+        dimension: number;
+        max_text_length: number;
+    };
+    features: {
+        mcp_enabled: boolean;
+        auto_index_enabled: boolean;
+        file_processing_enabled: boolean;
+    };
+    index: {
+        debounce_ms: number;
+    };
+    search: {
+        semantic_weight: number;
+        fts_weight: number;
+    };
+    bonds: {
+        default_type: string;
+    };
+}
+
+/**
+ * Mnemosyne Store Engine
+ * SQLite-backed replacement for the in-memory JSON system.
+ *
+ * Naming:
+ *   Project  (was Memory)   → projects table
+ *   Atom     → atoms table
+ *   Block    → blocks table
+ *   Bond     (new)          → bonds table
+ *   Assistant (was Agent)   → assistants table
+ */
+
+declare class EventEmitter {
+    private listeners;
+    on(event: string, cb: (...args: any[]) => void): void;
+    emit(event: string, ...args: any[]): void;
+}
+declare class Store extends EventEmitter {
+    private db;
+    config: Config;
+    vecEnabled: boolean;
+    private backupInterval;
+    private dbPath;
+    private backupDir;
+    private backupIntervalMs;
+    private maxBackups;
+    constructor(db: Database.Database, config: Config, vecEnabled?: boolean);
+    shutdown(): void;
+    private ensureBackup;
+    private stmt;
+    private tx;
+    private now;
+    private parseMeta;
+    private logEvent;
+    can(role: AssistantRole, action: Action, atomId?: string, assistantId?: string): boolean;
+    private levelAllowsAction;
+    setAtomPermission(atomId: string, assistantId: string, level: PermissionLevel, grantedBy?: string): void;
+    getAtomPermission(atomId: string, assistantId: string): {
+        id: string;
+        atom_id: string;
+        assistant_id: string;
+        level: PermissionLevel;
+        granted_by: string | null;
+        granted_at: number;
+    } | undefined;
+    getAtomPermissions(atomId: string): any[];
+    removeAtomPermission(atomId: string, assistantId: string): boolean;
+    resolvePermission(atomId: string, assistantId: string): PermissionLevel;
+    createProject(name: string, description?: string): Project;
+    getProject(id: string): Project | undefined;
+    getProjectByName(name: string): Project | undefined;
+    getProjects(): Project[];
+    createAtom(projectId: string, title: string, type: string, createdBy: string, opts?: {
+        parentId?: string;
+        summary?: string;
+        tags?: string[];
+        path_overridden?: boolean;
+        auto_path?: string;
+        template?: string;
+        status?: string;
+    }): Atom;
+    getAtom(id: string): Atom | undefined;
+    getAtomsByProject(projectId: string): Atom[];
+    getAtomChildren(atomId: string): Atom[];
+    updateAtomParent(id: string, parentId: string | null, updatedBy: string): Atom | null;
+    updateAtom(id: string, fields: {
+        title?: string;
+        summary?: string;
+        tags?: string[];
+        status?: string;
+        auto_path?: string;
+        path_overridden?: boolean;
+    }, updatedBy: string): Atom | null;
+    deleteAtom(id: string, deletedBy: string): boolean;
+    createBlock(atomId: string, type: string, content: string, createdBy: string, opts?: {
+        order?: number;
+        tags?: string[];
+    }): Block;
+    getBlock(id: string): Block | undefined;
+    getBlocksByAtom(atomId: string): Block[];
+    updateBlock(id: string, content: string, updatedBy: string): Block | null;
+    deleteBlock(id: string, deletedBy: string): boolean;
+    createBond(sourceId: string, targetId: string, label: string, color?: string): Bond;
+    getBond(id: string): Bond | undefined;
+    getBondsByAtom(atomId: string): {
+        outgoing: Bond[];
+        incoming: Bond[];
+    };
+    updateBond(id: string, fields: {
+        label?: string;
+        color?: string;
+    }): Bond | null;
+    deleteBond(id: string): boolean;
+    checkout(atomId: string, assistantId: string, mode: "exclusive" | "shared", reason: string): {
+        success: boolean;
+        queuePosition?: number;
+    };
+    releaseCheckout(atomId: string, assistantId: string): boolean;
+    forceRelease(atomId: string, _by: string): boolean;
+    getQueueStatus(atomId: string): {
+        atomId: string;
+        queue: QueueEntry[];
+    } | undefined;
+    grantQueueItem(atomId: string, queueEntryId: string): boolean;
+    rejectQueueItem(atomId: string, queueEntryId: string): boolean;
+    bumpQueueItem(atomId: string, queueEntryId: string): boolean;
+    registerAssistant(a: {
+        id?: string;
+        name: string;
+        role: AssistantRole;
+        capabilities?: string[];
+        description?: string;
+        provider?: string;
+        instructions?: string;
+        config?: Record<string, any>;
+    }): Assistant;
+    updateAssistant(id: string, fields: {
+        name?: string;
+        role?: AssistantRole;
+        description?: string;
+        provider?: string;
+        instructions?: string;
+        config?: Record<string, any>;
+        capabilities?: string[];
+        status?: string;
+    }): Assistant | null;
+    deleteAssistant(id: string): boolean;
+    getAssistant(id: string): Assistant | undefined;
+    getAllAssistants(): Assistant[];
+    heartbeat(id: string): void;
+    search(projectId: string, q: string, limit: number): any[];
+    embedAtom(atomId: string): Promise<void>;
+    searchSemantic(projectId: string, queryEmbedding: number[], limit: number): any[];
+    searchHybrid(projectId: string, q: string, queryEmbedding: number[], limit: number): any[];
+    private embedQueue;
+    scheduleEmbed(atomId: string, priority?: 2): void;
+    importMnemosyneZip(zipBuffer: Buffer, importedBy: string): {
+        success: boolean;
+        atomsRestored: number;
+        error?: string;
+    };
+    importMarkdown(mdText: string, projectId: string, createdBy: string, opts?: {
+        title?: string;
+    }): {
+        success: boolean;
+        atomId?: string;
+        bondsCreated?: number;
+        error?: string;
+    };
+    private cascadePathChange;
+    private indexTimers;
+    private indexAtomTimers;
+    scheduleProjectIndexUpdate(projectId: string): void;
+    scheduleProjectIndexAtomUpdate(projectId: string): void;
+    regenerateProjectIndex(projectId: string): void;
+    getProjectIndexAtom(projectId: string): Atom | undefined;
+    private getOrCreateProjectIndexAtom;
+    regenerateProjectIndexAtom(projectId: string): void;
+    getGraph(projectId: string): {
+        atoms: Atom[];
+        bonds: Bond[];
+    };
+    createAttachment(fileHash: string, fileName: string, fileSize: number, mimeType: string): any;
+    getAttachmentByHash(fileHash: string): any | undefined;
+    processFileBlock(atomId: string, blockContent: string): Promise<void>;
+    getAtomHistory(atomId: string): any[];
+    exportSnapshot(): any;
+    importSnapshot(snapshot: any, importedBy: string): void;
+    getEvents(since: number, projectId?: string, limit?: number): EventLogEntry[];
+    getEventsByAtom(atomId: string, limit?: number): EventLogEntry[];
+    getStats(): {
+        projects: number;
+        atoms: number;
+        blocks: number;
+        bonds: number;
+        assistants: number;
+    };
+}
+
+export { type Atom as A, type Config as C, type Project as P, Store as S };

package/dist/cli/index.d.mts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Mnemosyne CLI
+ * npx mnemosyne <command>
+ */
+declare function runCli(argv?: string[]): void;
+
+export { runCli };

package/dist/cli/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Mnemosyne CLI
+ * npx mnemosyne <command>
+ */
+declare function runCli(argv?: string[]): void;
+
+export { runCli };