mnemosyne-core 2.0.2 → 2.1.0

package/dist/sdk/index.d.mts

@@ -1,63 +1,104 @@
 /**
- * SDK shared types — mirror of core types with runtime-safe defaults.
+ * SDK shared types — mirror of server responses with runtime-safe defaults.
  */
-interface Atom {
+interface Project {
     id: string;
     name: string;
-    assistant_id: string;
-    content_type: "text" | "image" | "audio" | "file";
-    content: string;
-    embedding_type?: 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;
-    created_at: string;
-    updated_at: string;
+    parent_id: string | null;
+    title: string;
+    summary: string | null;
+    type: string;
+    icon: string;
+    color: string | null;
+    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;
+    state: {
+        lock: {
+            assistantId: string;
+            reason: string;
+        } | null;
+        queue: any[];
+        blockCount: number;
+        lastActivity: number;
+    };
 }
 interface Block {
     id: string;
     atom_id: string;
-    block_type: "content" | "file" | "export" | "import";
-    content: string;
-    file_path?: string;
-    file_original_name?: string;
-    file_type?: string;
-    source_type?: string;
-    created_at: string;
+    type: string;
+    content: string | null;
+    order_index: number;
+    created_at: number;
+    updated_at: number;
+    metadata: Record<string, any>;
 }
-interface Project {
+interface Bond {
     id: string;
-    name: string;
-    description?: string;
-    created_at: string;
+    source_id: string;
+    target_id: string;
+    label: string;
+    color: string | null;
+    created_at: number;
 }
 interface Assistant {
     id: string;
     name: string;
-    role?: string;
-    model?: string;
-    system_prompt?: string;
-    created_at: string;
-}
-interface Bond {
-    id: string;
-    source_id: string;
-    target_id: string;
-    bond_type: "related" | "child" | "parent" | "reference";
-    strength: number;
-    created_at: string;
+    role: string;
+    permissions: Record<string, any>;
+    status: string;
+    provider: string | null;
+    connected_at: number;
+    last_seen: number;
+    metadata: Record<string, any>;
 }
 interface SearchResult {
-    atoms: Array<Atom & {
+    query: string;
+    semantic: boolean;
+    count: number;
+    results: Array<Atom & {
         similarity?: number;
         score?: number;
     }>;
-    time: number;
-    total: number;
 }
 interface HealthStatus {
     status: "ok" | "degraded" | "error";
     version: string;
     database: string;
     uptime: number;
+    counts: Record<string, number>;
+}
+interface CheckoutResult {
+    success: boolean;
+    queuePosition?: number;
+}
+interface QueueStatus {
+    atomId: string;
+    queue: Array<{
+        id: string;
+        assistant_id: string;
+        requested_at: number;
+        priority: number;
+        status: string;
+        reason: string | null;
+    }>;
 }
 
 interface ClientOptions {
@@ -72,20 +113,90 @@ declare class MnemosyneClient {
     constructor(options: ClientOptions);
     private request;
     health(): Promise<HealthStatus>;
-    listProjects(): Promise<Project[]>;
-    getProject(id: string): Promise<Project>;
-    createProject(data: Omit<Project, "id" | "created_at">): Promise<Project>;
-    deleteProject(id: string): Promise<void>;
-    listAtoms(projectId?: string): Promise<Atom[]>;
-    getAtom(id: string): Promise<Atom>;
-    createAtom(data: Omit<Atom, "id" | "created_at" | "updated_at">): Promise<Atom>;
-    updateAtom(id: string, data: Partial<Omit<Atom, "id" | "created_at">>): Promise<Atom>;
-    deleteAtom(id: string): Promise<void>;
+    listProjects(): Promise<{
+        projects: Project[];
+    }>;
+    getProject(id: string): Promise<{
+        project: Project;
+    }>;
+    createProject(data: {
+        name: string;
+        description?: string;
+    }): Promise<{
+        success: boolean;
+        project: Project;
+    }>;
+    deleteProject(id: string): Promise<{
+        success: boolean;
+    }>;
+    listAtoms(projectId?: string): Promise<{
+        atoms: Atom[];
+    }>;
+    getAtom(id: string): Promise<{
+        atom: Atom;
+        children: any[];
+        blocks: Block[];
+        bonds: Bond[];
+    }>;
+    createAtom(data: {
+        project_id: string;
+        title: string;
+        type?: string;
+        parent_id?: string | null;
+        tags?: string[];
+        template?: string;
+        status?: string;
+        auto_path?: string;
+        path_overridden?: boolean;
+    }): Promise<{
+        atom: Atom;
+    }>;
+    updateAtom(id: string, data: {
+        title?: string;
+        summary?: string;
+        tags?: string[];
+        status?: string;
+        auto_path?: string;
+        path_overridden?: boolean;
+        parent_id?: string | null;
+    }): Promise<{
+        atom: Atom;
+    }>;
+    deleteAtom(id: string): Promise<{
+        success: boolean;
+    }>;
     getBlocks(atomId: string): Promise<Block[]>;
-    createBlock(atomId: string, data: Omit<Block, "id" | "atom_id" | "created_at">): Promise<Block>;
-    listBonds(): Promise<Bond[]>;
-    createBond(data: Omit<Bond, "id" | "created_at">): Promise<Bond>;
-    deleteBond(id: string): Promise<void>;
+    createBlock(atomId: string, data: {
+        type: string;
+        content: string;
+        tags?: string[];
+    }): Promise<{
+        block: Block;
+    }>;
+    updateBlock(id: string, data: {
+        content?: string;
+        type?: string;
+        metadata?: Record<string, any>;
+    }): Promise<{
+        block: Block;
+    }>;
+    deleteBlock(id: string): Promise<{
+        success: boolean;
+    }>;
+    listBonds(atomId?: string): Promise<Bond[] | {
+        outgoing: Bond[];
+        incoming: Bond[];
+    }>;
+    createBond(atomId: string, data: {
+        target_id: string;
+        label?: string;
+        color?: string;
+    }): Promise<{
+        bond: Bond;
+    }>;
+    deleteBond(id: string): Promise<{
+        success: boolean;
+    }>;
     searchSemantic(query: string, options?: {
         projectId?: string;
         limit?: number;
@@ -94,9 +205,50 @@ declare class MnemosyneClient {
         projectId?: string;
         limit?: number;
     }): Promise<SearchResult>;
-    listAssistants(): Promise<Assistant[]>;
-    getAssistant(id: string): Promise<Assistant>;
-    createAssistant(data: Omit<Assistant, "id" | "created_at">): Promise<Assistant>;
+    searchKeyword(query: string, options?: {
+        projectId?: string;
+        limit?: number;
+    }): Promise<SearchResult>;
+    listAssistants(): Promise<{
+        assistants: Assistant[];
+    }>;
+    getAssistant(id: string): Promise<{
+        assistant: Assistant;
+    }>;
+    createAssistant(data: {
+        id?: string;
+        name: string;
+        role: string;
+        capabilities?: string[];
+        description?: string;
+        provider?: string;
+        instructions?: string;
+        config?: Record<string, any>;
+    }): Promise<{
+        success: boolean;
+        token: string;
+        assistant: Assistant;
+    }>;
+    updateAssistant(id: string, data: {
+        name?: string;
+        role?: string;
+        description?: string;
+        provider?: string;
+        instructions?: string;
+        config?: Record<string, any>;
+        capabilities?: string[];
+        status?: string;
+    }): Promise<{
+        assistant: Assistant;
+    }>;
+    deleteAssistant(id: string): Promise<{
+        success: boolean;
+    }>;
+    checkoutAtom(atomId: string, mode?: "exclusive" | "shared", reason?: string): Promise<CheckoutResult>;
+    releaseCheckout(atomId: string): Promise<{
+        success: boolean;
+    }>;
+    getQueueStatus(atomId: string): Promise<QueueStatus>;
 }
 
 export { type Assistant, type Atom, type Block, type Bond, type HealthStatus, MnemosyneClient, type Project, type SearchResult };

package/dist/sdk/index.d.ts

@@ -1,63 +1,104 @@
 /**
- * SDK shared types — mirror of core types with runtime-safe defaults.
+ * SDK shared types — mirror of server responses with runtime-safe defaults.
  */
-interface Atom {
+interface Project {
     id: string;
     name: string;
-    assistant_id: string;
-    content_type: "text" | "image" | "audio" | "file";
-    content: string;
-    embedding_type?: 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;
-    created_at: string;
-    updated_at: string;
+    parent_id: string | null;
+    title: string;
+    summary: string | null;
+    type: string;
+    icon: string;
+    color: string | null;
+    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;
+    state: {
+        lock: {
+            assistantId: string;
+            reason: string;
+        } | null;
+        queue: any[];
+        blockCount: number;
+        lastActivity: number;
+    };
 }
 interface Block {
     id: string;
     atom_id: string;
-    block_type: "content" | "file" | "export" | "import";
-    content: string;
-    file_path?: string;
-    file_original_name?: string;
-    file_type?: string;
-    source_type?: string;
-    created_at: string;
+    type: string;
+    content: string | null;
+    order_index: number;
+    created_at: number;
+    updated_at: number;
+    metadata: Record<string, any>;
 }
-interface Project {
+interface Bond {
     id: string;
-    name: string;
-    description?: string;
-    created_at: string;
+    source_id: string;
+    target_id: string;
+    label: string;
+    color: string | null;
+    created_at: number;
 }
 interface Assistant {
     id: string;
     name: string;
-    role?: string;
-    model?: string;
-    system_prompt?: string;
-    created_at: string;
-}
-interface Bond {
-    id: string;
-    source_id: string;
-    target_id: string;
-    bond_type: "related" | "child" | "parent" | "reference";
-    strength: number;
-    created_at: string;
+    role: string;
+    permissions: Record<string, any>;
+    status: string;
+    provider: string | null;
+    connected_at: number;
+    last_seen: number;
+    metadata: Record<string, any>;
 }
 interface SearchResult {
-    atoms: Array<Atom & {
+    query: string;
+    semantic: boolean;
+    count: number;
+    results: Array<Atom & {
         similarity?: number;
         score?: number;
     }>;
-    time: number;
-    total: number;
 }
 interface HealthStatus {
     status: "ok" | "degraded" | "error";
     version: string;
     database: string;
     uptime: number;
+    counts: Record<string, number>;
+}
+interface CheckoutResult {
+    success: boolean;
+    queuePosition?: number;
+}
+interface QueueStatus {
+    atomId: string;
+    queue: Array<{
+        id: string;
+        assistant_id: string;
+        requested_at: number;
+        priority: number;
+        status: string;
+        reason: string | null;
+    }>;
 }
 
 interface ClientOptions {
@@ -72,20 +113,90 @@ declare class MnemosyneClient {
     constructor(options: ClientOptions);
     private request;
     health(): Promise<HealthStatus>;
-    listProjects(): Promise<Project[]>;
-    getProject(id: string): Promise<Project>;
-    createProject(data: Omit<Project, "id" | "created_at">): Promise<Project>;
-    deleteProject(id: string): Promise<void>;
-    listAtoms(projectId?: string): Promise<Atom[]>;
-    getAtom(id: string): Promise<Atom>;
-    createAtom(data: Omit<Atom, "id" | "created_at" | "updated_at">): Promise<Atom>;
-    updateAtom(id: string, data: Partial<Omit<Atom, "id" | "created_at">>): Promise<Atom>;
-    deleteAtom(id: string): Promise<void>;
+    listProjects(): Promise<{
+        projects: Project[];
+    }>;
+    getProject(id: string): Promise<{
+        project: Project;
+    }>;
+    createProject(data: {
+        name: string;
+        description?: string;
+    }): Promise<{
+        success: boolean;
+        project: Project;
+    }>;
+    deleteProject(id: string): Promise<{
+        success: boolean;
+    }>;
+    listAtoms(projectId?: string): Promise<{
+        atoms: Atom[];
+    }>;
+    getAtom(id: string): Promise<{
+        atom: Atom;
+        children: any[];
+        blocks: Block[];
+        bonds: Bond[];
+    }>;
+    createAtom(data: {
+        project_id: string;
+        title: string;
+        type?: string;
+        parent_id?: string | null;
+        tags?: string[];
+        template?: string;
+        status?: string;
+        auto_path?: string;
+        path_overridden?: boolean;
+    }): Promise<{
+        atom: Atom;
+    }>;
+    updateAtom(id: string, data: {
+        title?: string;
+        summary?: string;
+        tags?: string[];
+        status?: string;
+        auto_path?: string;
+        path_overridden?: boolean;
+        parent_id?: string | null;
+    }): Promise<{
+        atom: Atom;
+    }>;
+    deleteAtom(id: string): Promise<{
+        success: boolean;
+    }>;
     getBlocks(atomId: string): Promise<Block[]>;
-    createBlock(atomId: string, data: Omit<Block, "id" | "atom_id" | "created_at">): Promise<Block>;
-    listBonds(): Promise<Bond[]>;
-    createBond(data: Omit<Bond, "id" | "created_at">): Promise<Bond>;
-    deleteBond(id: string): Promise<void>;
+    createBlock(atomId: string, data: {
+        type: string;
+        content: string;
+        tags?: string[];
+    }): Promise<{
+        block: Block;
+    }>;
+    updateBlock(id: string, data: {
+        content?: string;
+        type?: string;
+        metadata?: Record<string, any>;
+    }): Promise<{
+        block: Block;
+    }>;
+    deleteBlock(id: string): Promise<{
+        success: boolean;
+    }>;
+    listBonds(atomId?: string): Promise<Bond[] | {
+        outgoing: Bond[];
+        incoming: Bond[];
+    }>;
+    createBond(atomId: string, data: {
+        target_id: string;
+        label?: string;
+        color?: string;
+    }): Promise<{
+        bond: Bond;
+    }>;
+    deleteBond(id: string): Promise<{
+        success: boolean;
+    }>;
     searchSemantic(query: string, options?: {
         projectId?: string;
         limit?: number;
@@ -94,9 +205,50 @@ declare class MnemosyneClient {
         projectId?: string;
         limit?: number;
     }): Promise<SearchResult>;
-    listAssistants(): Promise<Assistant[]>;
-    getAssistant(id: string): Promise<Assistant>;
-    createAssistant(data: Omit<Assistant, "id" | "created_at">): Promise<Assistant>;
+    searchKeyword(query: string, options?: {
+        projectId?: string;
+        limit?: number;
+    }): Promise<SearchResult>;
+    listAssistants(): Promise<{
+        assistants: Assistant[];
+    }>;
+    getAssistant(id: string): Promise<{
+        assistant: Assistant;
+    }>;
+    createAssistant(data: {
+        id?: string;
+        name: string;
+        role: string;
+        capabilities?: string[];
+        description?: string;
+        provider?: string;
+        instructions?: string;
+        config?: Record<string, any>;
+    }): Promise<{
+        success: boolean;
+        token: string;
+        assistant: Assistant;
+    }>;
+    updateAssistant(id: string, data: {
+        name?: string;
+        role?: string;
+        description?: string;
+        provider?: string;
+        instructions?: string;
+        config?: Record<string, any>;
+        capabilities?: string[];
+        status?: string;
+    }): Promise<{
+        assistant: Assistant;
+    }>;
+    deleteAssistant(id: string): Promise<{
+        success: boolean;
+    }>;
+    checkoutAtom(atomId: string, mode?: "exclusive" | "shared", reason?: string): Promise<CheckoutResult>;
+    releaseCheckout(atomId: string): Promise<{
+        success: boolean;
+    }>;
+    getQueueStatus(atomId: string): Promise<QueueStatus>;
 }
 
 export { type Assistant, type Atom, type Block, type Bond, type HealthStatus, MnemosyneClient, type Project, type SearchResult };