@soulcraft/brainy 3.21.0 → 3.23.0

package/dist/conversation/conversationManager.d.ts

@@ -1,176 +0,0 @@
-/**
- * ConversationManager - Infinite Agent Memory
- *
- * Production-ready conversation and context management for AI agents.
- * Built on Brainy's existing infrastructure: Triple Intelligence, Neural API, VFS.
- *
- * REAL IMPLEMENTATION - No stubs, no mocks, no TODOs
- */
-import { Brainy } from '../brainy.js';
-import { MessageRole, ConversationThread, ConversationContext, SaveMessageOptions, ContextRetrievalOptions, ConversationSearchOptions, ConversationSearchResult, ConversationTheme, ArtifactOptions, ConversationStats } from './types.js';
-/**
- * ConversationManager - High-level API for conversation operations
- *
- * Uses existing Brainy infrastructure:
- * - brain.add() for messages
- * - brain.relate() for threading
- * - brain.find() with Triple Intelligence for context
- * - brain.neural for clustering and similarity
- * - brain.vfs() for artifacts
- */
-export declare class ConversationManager {
-    private brain;
-    private initialized;
-    private _vfs;
-    /**
-     * Create a ConversationManager instance
-     * @param brain Brainy instance to use
-     */
-    constructor(brain: Brainy);
-    /**
-     * Initialize the conversation manager
-     * Lazy initialization pattern - only called when first used
-     */
-    init(): Promise<void>;
-    /**
-     * Save a message to the conversation history
-     *
-     * Uses: brain.add() with NounType.Message
-     * Real implementation - stores message with embedding
-     *
-     * @param content Message content
-     * @param role Message role (user, assistant, system, tool)
-     * @param options Save options (conversationId, metadata, etc.)
-     * @returns Message ID
-     */
-    saveMessage(content: string, role: MessageRole, options?: SaveMessageOptions): Promise<string>;
-    /**
-     * Link two messages in temporal sequence
-     *
-     * Uses: brain.relate() with VerbType.Precedes
-     * Real implementation - creates graph relationship
-     *
-     * @param prevMessageId ID of previous message
-     * @param nextMessageId ID of next message
-     * @returns Relationship ID
-     */
-    linkMessages(prevMessageId: string, nextMessageId: string): Promise<string>;
-    /**
-     * Get a full conversation thread
-     *
-     * Uses: brain.getNoun() and brain.getConnections()
-     * Real implementation - traverses graph relationships
-     *
-     * @param conversationId Conversation ID
-     * @param options Options (includeArtifacts, etc.)
-     * @returns Complete conversation thread
-     */
-    getConversationThread(conversationId: string, options?: {
-        includeArtifacts?: boolean;
-    }): Promise<ConversationThread>;
-    /**
-     * Get relevant context for a query
-     *
-     * Uses: brain.find() with Triple Intelligence
-     * Real implementation - semantic + temporal + graph ranking
-     *
-     * @param query Query string or context options
-     * @param options Retrieval options
-     * @returns Ranked context messages with artifacts
-     */
-    getRelevantContext(query: string | ContextRetrievalOptions, options?: ContextRetrievalOptions): Promise<ConversationContext>;
-    /**
-     * Search messages semantically
-     *
-     * Uses: brain.find() with semantic search
-     * Real implementation - vector similarity search
-     *
-     * @param options Search options
-     * @returns Search results with scores
-     */
-    searchMessages(options: ConversationSearchOptions): Promise<ConversationSearchResult[]>;
-    /**
-     * Find similar conversations using Neural API
-     *
-     * Uses: brain.neural.neighbors()
-     * Real implementation - semantic similarity with embeddings
-     *
-     * @param conversationId Conversation ID to find similar to
-     * @param limit Maximum number of similar conversations
-     * @param threshold Minimum similarity threshold
-     * @returns Similar conversations with relevance scores
-     */
-    findSimilarConversations(conversationId: string, limit?: number, threshold?: number): Promise<Array<{
-        id: string;
-        relevance: number;
-        metadata?: any;
-    }>>;
-    /**
-     * Get conversation themes via clustering
-     *
-     * Uses: brain.neural.clusters()
-     * Real implementation - semantic clustering
-     *
-     * @param conversationId Conversation ID
-     * @returns Discovered themes
-     */
-    getConversationThemes(conversationId: string): Promise<ConversationTheme[]>;
-    /**
-     * Save an artifact (code, file, etc.) to VFS
-     *
-     * Uses: brain.vfs()
-     * Real implementation - stores in virtual filesystem
-     *
-     * @param path VFS path
-     * @param content File content
-     * @param options Artifact options
-     * @returns Artifact entity ID
-     */
-    saveArtifact(path: string, content: string | Buffer, options: ArtifactOptions): Promise<string>;
-    /**
-     * Get conversation statistics
-     *
-     * Uses: brain.find() with aggregations
-     * Real implementation - queries and aggregates data
-     *
-     * @param conversationId Optional conversation ID to filter
-     * @returns Conversation statistics
-     */
-    getConversationStats(conversationId?: string): Promise<ConversationStats>;
-    /**
-     * Delete a message
-     *
-     * Uses: brain.deleteNoun()
-     * Real implementation - removes from graph
-     *
-     * @param messageId Message ID to delete
-     */
-    deleteMessage(messageId: string): Promise<void>;
-    /**
-     * Export conversation to JSON
-     *
-     * Uses: getConversationThread()
-     * Real implementation - serializes conversation
-     *
-     * @param conversationId Conversation ID
-     * @returns JSON-serializable conversation object
-     */
-    exportConversation(conversationId: string): Promise<any>;
-    /**
-     * Import conversation from JSON
-     *
-     * Uses: saveMessage() and linkMessages()
-     * Real implementation - recreates conversation
-     *
-     * @param data Exported conversation data
-     * @returns New conversation ID
-     */
-    importConversation(data: any): Promise<string>;
-}
-/**
- * Create a ConversationManager instance
- *
- * @param brain Brainy instance
- * @returns ConversationManager instance
- */
-export declare function createConversationManager(brain: Brainy): ConversationManager;