@cmdoss/memwal-sdk 0.6.0

package/dist/services/QueryService.d.ts

@@ -0,0 +1,182 @@
+/**
+ * QueryService - Advanced Memory Query Operations
+ *
+ * High-level query service providing sophisticated memory search capabilities
+ * similar to backend's MemoryQueryService. Combines vector search, semantic search,
+ * knowledge graph traversal, and complex filtering operations.
+ *
+ * This service coordinates between MemoryIndexService, GraphService, and other
+ * components to provide unified query capabilities.
+ */
+import { MemoryIndexService, type MemorySearchResult } from './MemoryIndexService';
+import { EmbeddingService } from './EmbeddingService';
+import { StorageService } from './StorageService';
+import { GraphService } from '../graph/GraphService';
+export interface AdvancedMemoryQuery {
+    query?: string;
+    userAddress: string;
+    queryType?: 'vector' | 'semantic' | 'keyword' | 'hybrid' | 'graph' | 'temporal' | 'analytical';
+    vector?: number[];
+    k?: number;
+    threshold?: number;
+    categories?: string[];
+    topics?: string[];
+    tags?: string[];
+    contentTypes?: string[];
+    dateRange?: {
+        start?: Date;
+        end?: Date;
+    };
+    importanceRange?: {
+        min?: number;
+        max?: number;
+    };
+    minRelevanceScore?: number;
+    graphQuery?: {
+        entityTypes?: string[];
+        relationshipTypes?: string[];
+        maxHops?: number;
+        seedEntities?: string[];
+    };
+    includeContent?: boolean;
+    includeGraph?: boolean;
+    includeAnalytics?: boolean;
+    limit?: number;
+    offset?: number;
+    boostRecent?: boolean;
+    boostImportant?: boolean;
+    diversifyResults?: boolean;
+}
+export interface QueryResult {
+    memories: MemorySearchResult[];
+    totalCount: number;
+    queryTime: number;
+    queryType: string;
+    graphResults?: {
+        entities: any[];
+        relationships: any[];
+    };
+    analytics?: {
+        categoryDistribution: Record<string, number>;
+        importanceDistribution: Record<number, number>;
+        temporalDistribution: Record<string, number>;
+        averageRelevance: number;
+    };
+    suggestions?: string[];
+}
+export interface SemanticSearchOptions {
+    expandQuery?: boolean;
+    includeRelated?: boolean;
+    semanticThreshold?: number;
+    maxExpansions?: number;
+}
+export interface AnalyticalQuery {
+    userAddress: string;
+    analysis: 'trends' | 'categories' | 'importance' | 'temporal' | 'relationships' | 'insights';
+    timeframe?: {
+        start?: Date;
+        end?: Date;
+        granularity?: 'day' | 'week' | 'month' | 'year';
+    };
+    filters?: {
+        categories?: string[];
+        importanceRange?: {
+            min?: number;
+            max?: number;
+        };
+    };
+}
+/**
+ * Advanced query service providing unified memory search capabilities
+ */
+export declare class QueryService {
+    private memoryIndexService?;
+    private embeddingService?;
+    private storageService?;
+    private graphService?;
+    constructor(memoryIndexService?: MemoryIndexService, embeddingService?: EmbeddingService, storageService?: StorageService, graphService?: GraphService);
+    /**
+     * Get QueryService statistics including EmbeddingService stats
+     */
+    getStats(): {
+        memoryIndexAvailable: boolean;
+        embeddingServiceAvailable: boolean;
+        storageAvailable: boolean;
+        graphServiceAvailable: boolean;
+        embeddingStats?: ReturnType<EmbeddingService['getStats']>;
+    };
+    /**
+     * Initialize services (can be called after construction)
+     */
+    initialize(memoryIndexService: MemoryIndexService, embeddingService: EmbeddingService, storageService?: StorageService, graphService?: GraphService): void;
+    /**
+     * Execute advanced memory query with multiple search strategies
+     */
+    query(query: AdvancedMemoryQuery): Promise<QueryResult>;
+    /**
+     * Pure vector similarity search
+     */
+    vectorSearch(query: AdvancedMemoryQuery): Promise<MemorySearchResult[]>;
+    /**
+     * Semantic search with query expansion and context understanding
+     */
+    semanticSearch(query: AdvancedMemoryQuery, options?: SemanticSearchOptions): Promise<MemorySearchResult[]>;
+    /**
+     * Keyword-based search in metadata and content
+     */
+    keywordSearch(query: AdvancedMemoryQuery): Promise<MemorySearchResult[]>;
+    /**
+     * Knowledge graph-based search
+     */
+    graphSearch(query: AdvancedMemoryQuery): Promise<{
+        memories: MemorySearchResult[];
+        graphResults: any;
+    }>;
+    /**
+     * Time-based search with temporal patterns
+     */
+    temporalSearch(query: AdvancedMemoryQuery): Promise<MemorySearchResult[]>;
+    /**
+     * Analytical search for insights and patterns
+     */
+    analyticalSearch(query: AdvancedMemoryQuery): Promise<{
+        memories: MemorySearchResult[];
+        analytics: any;
+    }>;
+    /**
+     * Hybrid search combining multiple strategies
+     */
+    hybridSearch(query: AdvancedMemoryQuery): Promise<MemorySearchResult[]>;
+    /**
+     * Execute analytical queries for insights
+     */
+    analyzeMemories(query: AnalyticalQuery): Promise<any>;
+    /**
+     * Calculate similarity between two vectors using EmbeddingService
+     */
+    private calculateSimilarity;
+    /**
+     * Find most similar memories to a query using EmbeddingService
+     */
+    private findSimilarMemories;
+    /**
+     * Batch generate embeddings for multiple texts using EmbeddingService
+     */
+    private batchEmbedTexts;
+    private postProcessResults;
+    private deduplicateResults;
+    private rerankSemanticResults;
+    private rerankHybridResults;
+    private boostRecentResults;
+    private boostImportantResults;
+    private diversifyResults;
+    private generateAnalytics;
+    private analyzeTrends;
+    private analyzeCategories;
+    private analyzeImportance;
+    private analyzeTemporal;
+    private analyzeRelationships;
+    private generateInsights;
+    private generateImportanceRecommendations;
+}
+//# sourceMappingURL=QueryService.d.ts.map

package/dist/services/QueryService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryService.d.ts","sourceRoot":"","sources":["../../src/services/QueryService.ts"],"names":[],"mappings":"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"}