agentic-qe 2.7.4 → 2.8.0

package/dist/edge/p2p/sharing/PatternIndex.d.ts

@@ -0,0 +1,168 @@
+/**
+ * Pattern Index with Vector Similarity Search
+ *
+ * In-memory index of shared patterns with efficient vector similarity search
+ * using cosine distance. Includes LRU eviction, deduplication, and versioning.
+ *
+ * @module edge/p2p/sharing/PatternIndex
+ * @version 1.0.0
+ */
+import type { SharedPattern, PatternQuery, PatternMatch, PatternSearchResults, PatternIndexConfig, PatternIndexStats, PatternConflict, VectorClock, PatternSummary } from './types';
+import { PatternCategory } from './types';
+import type { SharingEventHandler } from './types';
+/**
+ * In-memory pattern index with vector similarity search
+ *
+ * @example
+ * ```typescript
+ * const index = new PatternIndex({ maxPatterns: 1000 });
+ *
+ * // Add patterns
+ * await index.add(pattern);
+ *
+ * // Search by embedding
+ * const matches = await index.search({
+ *   embedding: queryVector,
+ *   similarityThreshold: 0.7,
+ *   limit: 10,
+ * });
+ *
+ * // Get by ID
+ * const pattern = index.get('pattern-id');
+ * ```
+ */
+export declare class PatternIndex {
+    private patterns;
+    private contentHashes;
+    private embeddings;
+    private config;
+    private eventHandlers;
+    private lastUpdated;
+    constructor(config?: Partial<PatternIndexConfig>);
+    /**
+     * Add a pattern to the index
+     */
+    add(pattern: SharedPattern): SharedPattern | null;
+    /**
+     * Get a pattern by ID
+     */
+    get(id: string): SharedPattern | undefined;
+    /**
+     * Update a pattern
+     */
+    update(id: string, updates: Partial<SharedPattern>): SharedPattern | undefined;
+    /**
+     * Remove a pattern by ID
+     */
+    remove(id: string): boolean;
+    /**
+     * Check if pattern exists
+     */
+    has(id: string): boolean;
+    /**
+     * Clear all patterns
+     */
+    clear(): void;
+    /**
+     * Search patterns by query
+     */
+    search(query: PatternQuery): PatternSearchResults;
+    /**
+     * Find similar patterns by embedding
+     */
+    findSimilar(embedding: Float32Array | number[], limit?: number, threshold?: number): PatternMatch[];
+    /**
+     * Find pattern by content hash (deduplication)
+     */
+    findByContentHash(hash: string): string | undefined;
+    /**
+     * Find patterns by category
+     */
+    findByCategory(category: PatternCategory): SharedPattern[];
+    /**
+     * Find patterns by domain
+     */
+    findByDomain(domain: string): SharedPattern[];
+    /**
+     * Find patterns by tags
+     */
+    findByTags(tags: string[]): SharedPattern[];
+    /**
+     * Check if a pattern version conflicts with existing
+     */
+    checkConflict(pattern: SharedPattern): PatternConflict | null;
+    /**
+     * Compare two vector clocks
+     * Returns: 'before', 'after', 'equal', 'concurrent'
+     */
+    compareVectorClocks(a: VectorClock, b: VectorClock): 'before' | 'after' | 'equal' | 'concurrent';
+    /**
+     * Increment vector clock for local agent
+     */
+    incrementClock(clock: VectorClock, agentId: string): VectorClock;
+    /**
+     * Merge two vector clocks
+     */
+    mergeClock(a: VectorClock, b: VectorClock): VectorClock;
+    /**
+     * Remove expired patterns
+     */
+    cleanupExpired(): number;
+    /**
+     * Get all pattern IDs
+     */
+    getAllIds(): string[];
+    /**
+     * Get all patterns
+     */
+    getAll(): SharedPattern[];
+    /**
+     * Get pattern summaries
+     */
+    getSummaries(): PatternSummary[];
+    /**
+     * Get index statistics
+     */
+    getStats(): PatternIndexStats;
+    /**
+     * Get current size
+     */
+    get size(): number;
+    /**
+     * Subscribe to events
+     */
+    on(handler: SharingEventHandler): void;
+    /**
+     * Unsubscribe from events
+     */
+    off(handler: SharingEventHandler): void;
+    /**
+     * Emit an event
+     */
+    private emit;
+    /**
+     * Normalize embedding to Float32Array
+     */
+    private normalizeEmbedding;
+    /**
+     * Calculate cosine similarity
+     */
+    private cosineSimilarity;
+    /**
+     * Check if pattern matches query filters
+     */
+    private matchesFilters;
+    /**
+     * Simple text matching score
+     */
+    private textMatch;
+    /**
+     * Generate match reason string
+     */
+    private generateMatchReason;
+}
+/**
+ * Create a new pattern index
+ */
+export declare function createPatternIndex(config?: Partial<PatternIndexConfig>): PatternIndex;
+//# sourceMappingURL=PatternIndex.d.ts.map

package/dist/edge/p2p/sharing/PatternIndex.d.ts.map

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