@soulcraft/brainy 3.22.0 → 3.23.0

package/dist/conversation/types.d.ts

@@ -1,231 +0,0 @@
-/**
- * Conversation Types for Infinite Agent Memory
- *
- * Production-ready type definitions for storing and retrieving
- * conversation history with semantic search and context management.
- */
-/**
- * Role of the message sender
- */
-export type MessageRole = 'user' | 'assistant' | 'system' | 'tool';
-/**
- * Problem-solving phase for tracking agent's progress
- */
-export type ProblemSolvingPhase = 'understanding' | 'analysis' | 'planning' | 'implementation' | 'testing' | 'debugging' | 'refinement' | 'completed';
-/**
- * Metadata for a conversation message
- */
-export interface ConversationMessageMetadata {
-    role: MessageRole;
-    conversationId: string;
-    sessionId?: string;
-    timestamp: number;
-    problemSolvingPhase?: ProblemSolvingPhase;
-    confidence?: number;
-    tokensUsed?: number;
-    tokensTotal?: number;
-    artifacts?: string[];
-    toolsUsed?: string[];
-    references?: string[];
-    tags?: string[];
-    priority?: number;
-    archived?: boolean;
-    [key: string]: any;
-}
-/**
- * A conversation message with all metadata
- */
-export interface ConversationMessage {
-    id: string;
-    content: string;
-    role: MessageRole;
-    metadata: ConversationMessageMetadata;
-    embedding?: number[];
-    createdAt: number;
-    updatedAt: number;
-}
-/**
- * Conversation thread metadata
- */
-export interface ConversationThreadMetadata {
-    conversationId: string;
-    sessionId?: string;
-    title?: string;
-    summary?: string;
-    startTime: number;
-    endTime?: number;
-    messageCount: number;
-    totalTokens: number;
-    participants: string[];
-    tags?: string[];
-    archived?: boolean;
-    [key: string]: any;
-}
-/**
- * A conversation thread (collection of messages)
- */
-export interface ConversationThread {
-    id: string;
-    metadata: ConversationThreadMetadata;
-    messages: ConversationMessage[];
-    artifacts?: string[];
-}
-/**
- * Options for retrieving relevant context
- */
-export interface ContextRetrievalOptions {
-    query?: string;
-    conversationId?: string;
-    sessionId?: string;
-    role?: MessageRole | MessageRole[];
-    phase?: ProblemSolvingPhase | ProblemSolvingPhase[];
-    tags?: string[];
-    minConfidence?: number;
-    timeRange?: {
-        start?: number;
-        end?: number;
-    };
-    limit?: number;
-    maxTokens?: number;
-    relevanceThreshold?: number;
-    weights?: {
-        semantic?: number;
-        temporal?: number;
-        graph?: number;
-    };
-    includeArtifacts?: boolean;
-    includeSimilarConversations?: boolean;
-    deduplicateClusters?: boolean;
-}
-/**
- * Ranked context message with relevance score
- */
-export interface RankedMessage extends ConversationMessage {
-    relevanceScore: number;
-    semanticScore?: number;
-    temporalScore?: number;
-    graphScore?: number;
-    explanation?: string;
-}
-/**
- * Retrieved context result
- */
-export interface ConversationContext {
-    messages: RankedMessage[];
-    artifacts?: Array<{
-        path: string;
-        id: string;
-        content?: string;
-        summary?: string;
-    }>;
-    similarConversations?: Array<{
-        id: string;
-        title?: string;
-        summary?: string;
-        relevance: number;
-        messageCount: number;
-    }>;
-    totalTokens: number;
-    metadata: {
-        queryTime: number;
-        messagesConsidered: number;
-        conversationsSearched: number;
-    };
-}
-/**
- * Options for saving messages
- */
-export interface SaveMessageOptions {
-    conversationId?: string;
-    sessionId?: string;
-    phase?: ProblemSolvingPhase;
-    confidence?: number;
-    artifacts?: string[];
-    toolsUsed?: string[];
-    tags?: string[];
-    linkToPrevious?: string;
-    metadata?: Record<string, any>;
-}
-/**
- * Options for conversation search
- */
-export interface ConversationSearchOptions {
-    query: string;
-    limit?: number;
-    role?: MessageRole | MessageRole[];
-    conversationId?: string;
-    sessionId?: string;
-    timeRange?: {
-        start?: number;
-        end?: number;
-    };
-    includeMetadata?: boolean;
-    includeContent?: boolean;
-}
-/**
- * Search result for conversations
- */
-export interface ConversationSearchResult {
-    message: ConversationMessage;
-    score: number;
-    conversationId: string;
-    snippet?: string;
-}
-/**
- * Theme discovered via clustering
- */
-export interface ConversationTheme {
-    id: string;
-    label: string;
-    messages: string[];
-    centroid: number[];
-    coherence: number;
-    keywords?: string[];
-}
-/**
- * Options for artifact storage
- */
-export interface ArtifactOptions {
-    conversationId: string;
-    messageId?: string;
-    type?: 'code' | 'config' | 'data' | 'document' | 'other';
-    language?: string;
-    description?: string;
-    metadata?: Record<string, any>;
-}
-/**
- * Statistics about conversations
- */
-export interface ConversationStats {
-    totalConversations: number;
-    totalMessages: number;
-    totalTokens: number;
-    averageMessagesPerConversation: number;
-    averageTokensPerMessage: number;
-    oldestMessage: number;
-    newestMessage: number;
-    phases: Record<ProblemSolvingPhase, number>;
-    roles: Record<MessageRole, number>;
-}
-/**
- * Compaction strategy options
- */
-export interface CompactionOptions {
-    conversationId: string;
-    strategy?: 'cluster-based' | 'importance-based' | 'hybrid';
-    keepRatio?: number;
-    minImportance?: number;
-    preservePhases?: ProblemSolvingPhase[];
-    preserveRecent?: number;
-}
-/**
- * Result of compaction operation
- */
-export interface CompactionResult {
-    originalCount: number;
-    compactedCount: number;
-    removedCount: number;
-    tokensFreed: number;
-    preservedMessageIds: string[];
-    summaryMessageId?: string;
-}

package/dist/conversation/types.js

@@ -1,8 +0,0 @@
-/**
- * Conversation Types for Infinite Agent Memory
- *
- * Production-ready type definitions for storing and retrieving
- * conversation history with semantic search and context management.
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/mcp/conversationTools.d.ts

@@ -1,88 +0,0 @@
-/**
- * MCP Conversation Tools
- *
- * Exposes ConversationManager functionality through MCP for Claude Code integration.
- * Provides 6 tools for infinite agent memory.
- *
- * REAL IMPLEMENTATION - Uses ConversationManager which uses real Brainy APIs
- */
-import { MCPResponse, MCPToolExecutionRequest, MCPTool } from '../types/mcpTypes.js';
-import { Brainy } from '../brainy.js';
-/**
- * MCP Conversation Toolset
- *
- * Provides conversation and context management tools for AI agents
- */
-export declare class MCPConversationToolset {
-    private brain;
-    private conversationManager;
-    private initialized;
-    /**
-     * Create MCP Conversation Toolset
-     * @param brain Brainy instance
-     */
-    constructor(brain: Brainy);
-    /**
-     * Initialize the toolset
-     */
-    init(): Promise<void>;
-    /**
-     * Handle MCP tool execution request
-     * @param request MCP tool execution request
-     * @returns MCP response
-     */
-    handleRequest(request: MCPToolExecutionRequest): Promise<MCPResponse>;
-    /**
-     * Get available conversation tools
-     * @returns Array of MCP tool definitions
-     */
-    getAvailableTools(): Promise<MCPTool[]>;
-    /**
-     * Handle save_message tool
-     * REAL: Uses ConversationManager.saveMessage()
-     */
-    private handleSaveMessage;
-    /**
-     * Handle get_context tool
-     * REAL: Uses ConversationManager.getRelevantContext()
-     */
-    private handleGetContext;
-    /**
-     * Handle search tool
-     * REAL: Uses ConversationManager.searchMessages()
-     */
-    private handleSearch;
-    /**
-     * Handle get_thread tool
-     * REAL: Uses ConversationManager.getConversationThread()
-     */
-    private handleGetThread;
-    /**
-     * Handle save_artifact tool
-     * REAL: Uses ConversationManager.saveArtifact()
-     */
-    private handleSaveArtifact;
-    /**
-     * Handle find_similar tool
-     * REAL: Uses ConversationManager.findSimilarConversations()
-     */
-    private handleFindSimilar;
-    /**
-     * Create success response
-     */
-    private createSuccessResponse;
-    /**
-     * Create error response
-     */
-    private createErrorResponse;
-    /**
-     * Generate request ID
-     */
-    generateRequestId(): string;
-}
-/**
- * Create MCP conversation toolset
- * @param brain Brainy instance
- * @returns MCPConversationToolset instance
- */
-export declare function createConversationToolset(brain: Brainy): MCPConversationToolset;