vesper-memory 0.3.2 → 0.5.0

package/dist/memory-layers/skill-lazy-loading.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Lazy Loading for Skill Library
+ *
+ * Token-efficient skill loading system that reduces skill-related token usage by 80-90%.
+ *
+ * Strategy:
+ * 1. Inject lightweight skill summaries (~50 tokens each) in MCP context
+ * 2. Load full implementations only when explicitly invoked
+ * 3. Cache loaded skills in working memory (Redis) for session
+ *
+ * Performance targets:
+ * - Summary retrieval: <10ms
+ * - Full load: <20ms
+ * - Cache hit: <5ms
+ * - Token reduction: 80-90%
+ */
+import Database from 'better-sqlite3';
+/**
+ * Lightweight skill summary for context injection
+ *
+ * Contains minimal information needed to identify and trigger a skill.
+ * Approximately 50 tokens per summary.
+ */
+export interface SkillSummary {
+    /** Unique identifier for the skill */
+    id: string;
+    /** Short, descriptive name (e.g., "Data Analysis", "Code Review") */
+    name: string;
+    /** One-line description of what the skill does (~20 words max) */
+    summary: string;
+    /** Category for grouping (e.g., "analysis", "writing", "coding") */
+    category: string;
+    /** Trigger keywords that activate this skill (max 5) */
+    triggers: string[];
+    /** Quality score: 0-1, based on success rate and satisfaction */
+    quality_score: number;
+    /** When this skill was last successfully used */
+    last_used?: Date;
+}
+/**
+ * Full skill implementation with complete details
+ *
+ * Loaded on-demand when a skill is explicitly invoked.
+ * Contains all information needed to execute the skill.
+ */
+export interface FullSkill extends SkillSummary {
+    /** Full description with context and usage examples */
+    description: string;
+    /** Executable code or reference to implementation */
+    code?: string;
+    /** Type of code: 'inline' TypeScript or 'reference' to function */
+    code_type?: 'inline' | 'reference';
+    /** Prerequisites or required context */
+    prerequisites?: string[];
+    /** Success tracking */
+    success_count: number;
+    failure_count: number;
+    avg_user_satisfaction: number;
+    /** Dependency tracking for composition */
+    uses_skills?: string[];
+    used_by_skills?: string[];
+    /** Metadata */
+    created_from?: string;
+    created_at: Date;
+    last_modified: Date;
+    version: number;
+    notes?: string;
+}
+/**
+ * Cache entry for a loaded skill in working memory
+ */
+export interface CachedSkill {
+    skill: FullSkill;
+    loaded_at: Date;
+    access_count: number;
+    ttl: number;
+}
+/**
+ * Skill invocation detection result
+ *
+ * Determines if a query is attempting to invoke a specific skill.
+ */
+export interface InvocationDetection {
+    /** Whether a skill invocation was detected */
+    is_invocation: boolean;
+    /** The skill ID being invoked (if detected) */
+    skill_id?: string;
+    /** Confidence score: 0-1 */
+    confidence: number;
+    /** Pattern that matched (for debugging) */
+    matched_pattern?: string;
+}
+/**
+ * Lazy Loading Skill Library
+ *
+ * Extends the base SkillLibrary with lazy loading capabilities.
+ */
+export declare class LazyLoadingSkillLibrary {
+    private db;
+    private cacheKeyPrefix;
+    constructor(db: Database.Database);
+    /**
+     * Get skill summaries for context injection
+     *
+     * Returns lightweight summaries of all non-archived skills,
+     * sorted by quality score (satisfaction × success rate).
+     *
+     * @param limit - Maximum number of summaries to return (default: 20)
+     * @param category - Optional category filter
+     * @returns Array of SkillSummary objects
+     */
+    getSummaries(limit?: number, category?: string, namespace?: string): SkillSummary[];
+    /**
+     * Load full skill implementation
+     *
+     * Retrieves complete skill details for execution.
+     * Results should be cached in working memory.
+     *
+     * @param skillId - The skill ID to load
+     * @returns FullSkill object or null if not found
+     */
+    loadFull(skillId: string): FullSkill | null;
+    /**
+     * Detect if a query is attempting to invoke a specific skill
+     *
+     * Uses pattern matching to identify skill invocations:
+     * - Explicit: "use skill X", "invoke X", "run X"
+     * - Implicit: "analyze this like before", "same as last time"
+     * - By ID: References a skill ID directly
+     *
+     * @param query - The user query
+     * @param summaries - Available skill summaries for matching
+     * @returns InvocationDetection result
+     */
+    detectInvocation(query: string, summaries: SkillSummary[]): InvocationDetection;
+    /**
+     * Calculate quality score for a skill
+     *
+     * Formula: avg_satisfaction × success_rate
+     * Where success_rate = success_count / (success_count + failure_count)
+     *
+     * @param avgSatisfaction - Average user satisfaction (0-1)
+     * @param successCount - Number of successful executions
+     * @param failureCount - Number of failed executions
+     * @returns Quality score (0-1)
+     */
+    private calculateQualityScore;
+    /**
+     * Generate a one-line summary from name and description
+     *
+     * Used when summary field is not populated.
+     * Truncates description to ~20 words.
+     *
+     * @param name - Skill name
+     * @param description - Full description
+     * @returns One-line summary
+     */
+    private generateSummary;
+}
+//# sourceMappingURL=skill-lazy-loading.d.ts.map

package/dist/memory-layers/skill-lazy-loading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-lazy-loading.d.ts","sourceRoot":"","sources":["../../src/memory-layers/skill-lazy-loading.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IAEX,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IAEb,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAEhB,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IAEjB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,iEAAiE;IACjE,aAAa,EAAE,MAAM,CAAC;IAEtB,iDAAiD;IACjD,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAU,SAAQ,YAAY;IAC7C,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IAEpB,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,mEAAmE;IACnE,SAAS,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IAEnC,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB,uBAAuB;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,MAAM,CAAC;IAE9B,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B,eAAe;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,IAAI,CAAC;IACjB,aAAa,EAAE,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,aAAa,EAAE,OAAO,CAAC;IAEvB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IAEnB,2CAA2C;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,cAAc,CAA0B;gBAEpC,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAIjC;;;;;;;;;OASG;IACH,YAAY,CAAC,KAAK,GAAE,MAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,GAAE,MAAkB,GAAG,YAAY,EAAE;IAoDlG;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAwC3C;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,mBAAmB;IAoF/E;;;;;;;;;;OAUG;IACH,OAAO,CAAC,qBAAqB;IAgB7B;;;;;;;;;OASG;IACH,OAAO,CAAC,eAAe;CAexB"}

package/dist/memory-layers/skill-lazy-loading.js

@@ -0,0 +1,247 @@
+/**
+ * Lazy Loading for Skill Library
+ *
+ * Token-efficient skill loading system that reduces skill-related token usage by 80-90%.
+ *
+ * Strategy:
+ * 1. Inject lightweight skill summaries (~50 tokens each) in MCP context
+ * 2. Load full implementations only when explicitly invoked
+ * 3. Cache loaded skills in working memory (Redis) for session
+ *
+ * Performance targets:
+ * - Summary retrieval: <10ms
+ * - Full load: <20ms
+ * - Cache hit: <5ms
+ * - Token reduction: 80-90%
+ */
+/**
+ * Lazy Loading Skill Library
+ *
+ * Extends the base SkillLibrary with lazy loading capabilities.
+ */
+export class LazyLoadingSkillLibrary {
+    db;
+    cacheKeyPrefix = 'skill:cache:';
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Get skill summaries for context injection
+     *
+     * Returns lightweight summaries of all non-archived skills,
+     * sorted by quality score (satisfaction × success rate).
+     *
+     * @param limit - Maximum number of summaries to return (default: 20)
+     * @param category - Optional category filter
+     * @returns Array of SkillSummary objects
+     */
+    getSummaries(limit = 20, category, namespace = 'default') {
+        let query = `
+      SELECT
+        id,
+        name,
+        summary,
+        category,
+        triggers,
+        success_count,
+        failure_count,
+        avg_user_satisfaction,
+        last_used
+      FROM skills
+      WHERE is_archived = 0 AND namespace = ?
+    `;
+        const params = [namespace];
+        if (category) {
+            query += ' AND category = ?';
+            params.push(category);
+        }
+        // Calculate quality score as: avg_satisfaction × success_rate
+        // Where success_rate = success_count / (success_count + failure_count)
+        query += `
+      ORDER BY
+        (avg_user_satisfaction * (CAST(success_count AS REAL) / NULLIF(success_count + failure_count, 0))) DESC,
+        avg_user_satisfaction DESC,
+        success_count DESC
+      LIMIT ?
+    `;
+        params.push(limit);
+        const stmt = this.db.prepare(query);
+        const rows = stmt.all(...params);
+        return rows.map(row => ({
+            id: row.id,
+            name: row.name,
+            summary: row.summary || this.generateSummary(row.name, row.description),
+            category: row.category,
+            triggers: JSON.parse(row.triggers || '[]'),
+            quality_score: this.calculateQualityScore(row.avg_user_satisfaction, row.success_count, row.failure_count),
+            last_used: row.last_used ? new Date(row.last_used) : undefined,
+        }));
+    }
+    /**
+     * Load full skill implementation
+     *
+     * Retrieves complete skill details for execution.
+     * Results should be cached in working memory.
+     *
+     * @param skillId - The skill ID to load
+     * @returns FullSkill object or null if not found
+     */
+    loadFull(skillId) {
+        const stmt = this.db.prepare(`
+      SELECT * FROM skills WHERE id = ? AND is_archived = 0
+    `);
+        const row = stmt.get(skillId);
+        if (!row) {
+            return null;
+        }
+        return {
+            id: row.id,
+            name: row.name,
+            summary: row.summary || this.generateSummary(row.name, row.description),
+            description: row.description,
+            category: row.category,
+            triggers: JSON.parse(row.triggers || '[]'),
+            code: row.code,
+            code_type: row.code_type,
+            prerequisites: row.prerequisites ? JSON.parse(row.prerequisites) : undefined,
+            quality_score: this.calculateQualityScore(row.avg_user_satisfaction, row.success_count, row.failure_count),
+            success_count: row.success_count,
+            failure_count: row.failure_count,
+            avg_user_satisfaction: row.avg_user_satisfaction,
+            uses_skills: row.uses_skills ? JSON.parse(row.uses_skills) : undefined,
+            used_by_skills: row.used_by_skills ? JSON.parse(row.used_by_skills) : undefined,
+            created_from: row.created_from,
+            created_at: new Date(row.created_at),
+            last_modified: new Date(row.last_modified),
+            last_used: row.last_used ? new Date(row.last_used) : undefined,
+            version: row.version,
+            notes: row.notes,
+        };
+    }
+    /**
+     * Detect if a query is attempting to invoke a specific skill
+     *
+     * Uses pattern matching to identify skill invocations:
+     * - Explicit: "use skill X", "invoke X", "run X"
+     * - Implicit: "analyze this like before", "same as last time"
+     * - By ID: References a skill ID directly
+     *
+     * @param query - The user query
+     * @param summaries - Available skill summaries for matching
+     * @returns InvocationDetection result
+     */
+    detectInvocation(query, summaries) {
+        const normalizedQuery = query.toLowerCase().trim();
+        // Pattern 1: Explicit invocation by name
+        // "use skill Data Analysis", "invoke Code Review"
+        const explicitPattern = /\b(use|invoke|run|execute)\s+(skill\s+)?(.+)/i;
+        const explicitMatch = normalizedQuery.match(explicitPattern);
+        if (explicitMatch) {
+            const skillName = explicitMatch[3].trim();
+            const matchingSkill = summaries.find(s => s.name.toLowerCase() === skillName);
+            if (matchingSkill) {
+                return {
+                    is_invocation: true,
+                    skill_id: matchingSkill.id,
+                    confidence: 0.95,
+                    matched_pattern: 'explicit_name',
+                };
+            }
+        }
+        // Pattern 2: Implicit invocation by trigger
+        // "analyze this dataset", "review this code"
+        for (const skill of summaries) {
+            for (const trigger of skill.triggers) {
+                if (normalizedQuery.includes(trigger.toLowerCase())) {
+                    return {
+                        is_invocation: true,
+                        skill_id: skill.id,
+                        confidence: 0.75,
+                        matched_pattern: `trigger:${trigger}`,
+                    };
+                }
+            }
+        }
+        // Pattern 3: Reference to previous skill
+        // "like before", "same as last time", "same way"
+        const referencePattern = /\b(like before|same as|same way|as before|previously)\b/i;
+        if (referencePattern.test(normalizedQuery)) {
+            // Return most recently used skill
+            const recentSkill = summaries
+                .filter(s => s.last_used)
+                .sort((a, b) => (b.last_used?.getTime() || 0) - (a.last_used?.getTime() || 0))[0];
+            if (recentSkill) {
+                return {
+                    is_invocation: true,
+                    skill_id: recentSkill.id,
+                    confidence: 0.8,
+                    matched_pattern: 'reference_previous',
+                };
+            }
+        }
+        // Pattern 4: Skill ID reference
+        // "skill_12345", direct ID in query
+        const idPattern = /skill_[a-z0-9]+/i;
+        const idMatch = normalizedQuery.match(idPattern);
+        if (idMatch) {
+            const skillId = idMatch[0];
+            const matchingSkill = summaries.find(s => s.id === skillId);
+            if (matchingSkill) {
+                return {
+                    is_invocation: true,
+                    skill_id: skillId,
+                    confidence: 1.0,
+                    matched_pattern: 'skill_id',
+                };
+            }
+        }
+        // No invocation detected
+        return {
+            is_invocation: false,
+            confidence: 0.0,
+        };
+    }
+    /**
+     * Calculate quality score for a skill
+     *
+     * Formula: avg_satisfaction × success_rate
+     * Where success_rate = success_count / (success_count + failure_count)
+     *
+     * @param avgSatisfaction - Average user satisfaction (0-1)
+     * @param successCount - Number of successful executions
+     * @param failureCount - Number of failed executions
+     * @returns Quality score (0-1)
+     */
+    calculateQualityScore(avgSatisfaction, successCount, failureCount) {
+        const totalExecutions = successCount + failureCount;
+        if (totalExecutions === 0) {
+            // No executions yet, return base satisfaction
+            return avgSatisfaction * 0.5; // Penalize untested skills
+        }
+        const successRate = successCount / totalExecutions;
+        return avgSatisfaction * successRate;
+    }
+    /**
+     * Generate a one-line summary from name and description
+     *
+     * Used when summary field is not populated.
+     * Truncates description to ~20 words.
+     *
+     * @param name - Skill name
+     * @param description - Full description
+     * @returns One-line summary
+     */
+    generateSummary(name, description) {
+        if (!description) {
+            return name;
+        }
+        // Take first sentence or first 20 words, whichever is shorter
+        const firstSentence = description.split(/[.!?]/)[0].trim();
+        const words = firstSentence.split(/\s+/);
+        if (words.length <= 20) {
+            return firstSentence;
+        }
+        return words.slice(0, 20).join(' ') + '...';
+    }
+}
+//# sourceMappingURL=skill-lazy-loading.js.map

package/dist/memory-layers/skill-lazy-loading.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-lazy-loading.js","sourceRoot":"","sources":["../../src/memory-layers/skill-lazy-loading.ts"],"names":[],"mappings":"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"}

package/dist/memory-layers/skill-library.d.ts

@@ -2,8 +2,12 @@
  * Skill Library - v3.0 Voyager-Style Implementation
  *
  * Procedural memory: reusable patterns learned from conversations.
+ * Includes RelationalSkillLibrary for geometric embeddings and analogical reasoning.
+ * Enhanced with lazy loading support for token efficiency.
  */
 import Database from 'better-sqlite3';
+import { EmbeddingClient } from '../embeddings/client.js';
+import { SkillSummary, FullSkill, InvocationDetection } from './skill-lazy-loading.js';
 export interface Skill {
     id: string;
     name: string;
@@ -13,13 +17,138 @@ export interface Skill {
     successCount: number;
     failureCount: number;
     avgSatisfaction: number;
+    embedding?: number[];
+    similarity?: number;
 }
+export interface SkillRelationship {
+    id: string;
+    skillId1: string;
+    skillId2: string;
+    relationshipType: string;
+    coOccurrenceCount: number;
+    relationalVector?: number[];
+    createdAt: Date;
+    lastUpdated: Date;
+}
+export interface SkillWithScore extends Skill {
+    fusedScore?: number;
+    analogyScore?: number;
+}
+export type { SkillSummary, FullSkill, InvocationDetection };
 export declare class SkillLibrary {
     private db;
+    private lazyLoader;
     constructor(db: Database.Database);
-    addSkill(skill: Omit<Skill, 'id' | 'successCount' | 'failureCount' | 'avgSatisfaction'>): string;
-    search(query: string, limit?: number): Skill[];
-    recordSuccess(skillId: string, satisfaction: number): void;
-    recordFailure(skillId: string): void;
+    addSkill(skill: Omit<Skill, 'id' | 'successCount' | 'failureCount' | 'avgSatisfaction'>, namespace?: string): string;
+    search(query: string, limit?: number, namespace?: string): Skill[];
+    recordSuccess(skillId: string, satisfaction: number, _namespace?: string): void;
+    recordFailure(skillId: string, _namespace?: string): void;
+    /**
+     * Get database instance for subclasses
+     */
+    protected getDb(): Database.Database;
+    /**
+     * Get skill summaries for lazy loading context injection
+     *
+     * Returns lightweight summaries (~50 tokens each) instead of full skills.
+     * This reduces token usage by 80-90% for skill-related context.
+     *
+     * @param limit - Maximum number of summaries (default: 20)
+     * @param category - Optional category filter
+     * @returns Array of SkillSummary objects
+     */
+    getSummaries(limit?: number, category?: string, namespace?: string): SkillSummary[];
+    /**
+     * Load full skill implementation on-demand
+     *
+     * Used when a skill is explicitly invoked and full details are needed.
+     * Results should be cached in working memory to avoid repeated loads.
+     *
+     * @param skillId - The skill ID to load
+     * @returns FullSkill object or null if not found
+     */
+    loadFull(skillId: string, _namespace?: string): FullSkill | null;
+    /**
+     * Detect if a query is attempting to invoke a specific skill
+     *
+     * Uses pattern matching to identify skill invocations.
+     *
+     * @param query - The user query
+     * @returns InvocationDetection result with skill ID if detected
+     */
+    detectInvocation(query: string, namespace?: string): InvocationDetection;
+    /**
+     * Update last_used timestamp for a skill
+     *
+     * Called when a skill is successfully executed.
+     *
+     * @param skillId - The skill ID
+     */
+    updateLastUsed(skillId: string): void;
+}
+/**
+ * RelationalSkillLibrary - Extended skill library with geometric embeddings
+ * and analogical reasoning capabilities.
+ *
+ * Features:
+ * - Skill embeddings for semantic similarity search
+ * - Co-occurrence tracking between skills
+ * - Relational vectors for analogical reasoning
+ * - Hybrid search combining trigger-based and embedding-based results
+ */
+export declare class RelationalSkillLibrary extends SkillLibrary {
+    private embeddingClient?;
+    constructor(db: Database.Database, embeddingClient?: EmbeddingClient);
+    /**
+     * Construct pattern text from skill properties for embedding generation.
+     * Combines name, description, category, and triggers into a single text
+     * that captures the skill's semantic meaning.
+     */
+    constructPatternText(skill: Omit<Skill, 'id' | 'successCount' | 'failureCount' | 'avgSatisfaction'>): string;
+    /**
+     * Add a skill with automatic embedding generation.
+     * Falls back to adding without embedding if embedding service unavailable.
+     */
+    addSkillWithEmbedding(skill: Omit<Skill, 'id' | 'successCount' | 'failureCount' | 'avgSatisfaction'>): Promise<string>;
+    /**
+     * Generate embeddings for all skills that don't have one.
+     * Useful for migrating existing skills or after embedding service comes back online.
+     */
+    generateMissingEmbeddings(): Promise<number>;
+    /**
+     * Calculate cosine similarity between two embedding vectors.
+     * Returns value between -1 and 1, where 1 is identical.
+     */
+    cosineSimilarity(a: number[], b: number[]): number;
+    /**
+     * Search skills by embedding similarity (geometric search).
+     * Uses cosine similarity to find semantically similar skills.
+     */
+    searchByEmbedding(query: string, limit?: number): Promise<Skill[]>;
+    /**
+     * Hybrid search combining trigger-based and embedding-based search.
+     * Uses Reciprocal Rank Fusion (RRF) with k=60 to combine results.
+     */
+    hybridSearch(query: string, limit?: number): Promise<SkillWithScore[]>;
+    /**
+     * Record co-occurrence between two skills.
+     * Used to track which skills are often used together.
+     * Normalizes skill pair order for consistency.
+     */
+    recordCoOccurrence(skillId1: string, skillId2: string): Promise<void>;
+    /**
+     * Compute relational vectors for skill relationships that meet the threshold.
+     * Relational vector = embedding(skill2) - embedding(skill1)
+     * Used for analogical reasoning.
+     */
+    computeRelationalVectors(minCoOccurrenceCount?: number): Promise<number>;
+    /**
+     * Find analogous skills using relational vectors.
+     * Query: "What is to sourceB as targetA is to sourceA?"
+     *
+     * Uses the relationship between sourceA and targetA to find
+     * a similar relationship starting from sourceB.
+     */
+    analogicalSearch(sourceA: string, targetA: string, sourceB: string, limit?: number): Promise<SkillWithScore[]>;
 }
 //# sourceMappingURL=skill-library.d.ts.map

package/dist/memory-layers/skill-library.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-library.d.ts","sourceRoot":"","sources":["../../src/memory-layers/skill-library.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAAoB;gBAElB,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAIjC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,cAAc,GAAG,cAAc,GAAG,iBAAiB,CAAC,GAAG,MAAM;IAiBhG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,KAAK,EAAE;IAkCjD,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAY1D,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAGrC"}
+{"version":3,"file":"skill-library.d.ts","sourceRoot":"","sources":["../../src/memory-layers/skill-library.ts"],"names":[],"mappings":"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"}