deepseek-coder-agent-cli 1.0.0

package/dist/core/embeddingProviders.js

@@ -0,0 +1,241 @@
+/**
+ * Embedding Providers - Pluggable vector embedding backends
+ *
+ * Supports:
+ * - Simple (built-in, no dependencies)
+ * - OpenAI text-embedding-3-small/large
+ * - Ollama local embeddings
+ * - Custom providers via interface
+ */
+export class OpenAIEmbeddingProvider {
+    name = 'openai';
+    dimension;
+    apiKey;
+    model;
+    baseUrl;
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.model = config.model || 'text-embedding-3-small';
+        this.baseUrl = config.baseUrl || 'https://api.openai.com/v1';
+        // Set dimension based on model
+        switch (this.model) {
+            case 'text-embedding-3-large':
+                this.dimension = 3072;
+                break;
+            case 'text-embedding-ada-002':
+                this.dimension = 1536;
+                break;
+            case 'text-embedding-3-small':
+            default:
+                this.dimension = 1536;
+                break;
+        }
+    }
+    async embed(text) {
+        const response = await fetch(`${this.baseUrl}/embeddings`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({
+                model: this.model,
+                input: text,
+            }),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`OpenAI embedding failed: ${response.status} ${error}`);
+        }
+        const data = await response.json();
+        return data.data[0]?.embedding || [];
+    }
+}
+export class OllamaEmbeddingProvider {
+    name = 'ollama';
+    dimension = 4096; // Default for most Ollama models
+    model;
+    baseUrl;
+    constructor(config = {}) {
+        this.model = config.model || 'nomic-embed-text';
+        this.baseUrl = config.baseUrl || 'http://localhost:11434';
+    }
+    async embed(text) {
+        const response = await fetch(`${this.baseUrl}/api/embeddings`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                model: this.model,
+                prompt: text,
+            }),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Ollama embedding failed: ${response.status} ${error}`);
+        }
+        const data = await response.json();
+        return data.embedding || [];
+    }
+}
+export class DeepSeekEmbeddingProvider {
+    name = 'deepseek';
+    dimension = 1024;
+    apiKey;
+    baseUrl;
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.baseUrl = config.baseUrl || 'https://api.deepseek.com/v1';
+    }
+    async embed(text) {
+        // DeepSeek uses OpenAI-compatible API
+        const response = await fetch(`${this.baseUrl}/embeddings`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({
+                model: 'deepseek-embedding',
+                input: text,
+            }),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`DeepSeek embedding failed: ${response.status} ${error}`);
+        }
+        const data = await response.json();
+        return data.data[0]?.embedding || [];
+    }
+}
+// ============================================================================
+// CACHED EMBEDDING PROVIDER WRAPPER
+// ============================================================================
+export class CachedEmbeddingProvider {
+    name;
+    dimension;
+    provider;
+    cache = new Map();
+    maxCacheSize;
+    constructor(provider, maxCacheSize = 10000) {
+        this.provider = provider;
+        this.name = `cached-${provider.name}`;
+        this.dimension = provider.dimension;
+        this.maxCacheSize = maxCacheSize;
+    }
+    async embed(text) {
+        // Check cache first
+        const cached = this.cache.get(text);
+        if (cached) {
+            return cached;
+        }
+        // Generate embedding
+        const embedding = await this.provider.embed(text);
+        // Cache result
+        if (this.cache.size >= this.maxCacheSize) {
+            // Remove oldest entry (first key)
+            const firstKey = this.cache.keys().next().value;
+            if (firstKey)
+                this.cache.delete(firstKey);
+        }
+        this.cache.set(text, embedding);
+        return embedding;
+    }
+    clearCache() {
+        this.cache.clear();
+    }
+    getCacheStats() {
+        return {
+            size: this.cache.size,
+            maxSize: this.maxCacheSize,
+        };
+    }
+}
+/**
+ * Create an embedding provider based on configuration
+ */
+export function createEmbeddingProvider(options) {
+    let provider;
+    switch (options.type) {
+        case 'openai':
+            if (!options.apiKey) {
+                throw new Error('OpenAI embedding provider requires apiKey');
+            }
+            provider = new OpenAIEmbeddingProvider({
+                apiKey: options.apiKey,
+                model: options.model,
+                baseUrl: options.baseUrl,
+            });
+            break;
+        case 'ollama':
+            provider = new OllamaEmbeddingProvider({
+                model: options.model,
+                baseUrl: options.baseUrl,
+            });
+            break;
+        case 'deepseek':
+            if (!options.apiKey) {
+                throw new Error('DeepSeek embedding provider requires apiKey');
+            }
+            provider = new DeepSeekEmbeddingProvider({
+                apiKey: options.apiKey,
+                baseUrl: options.baseUrl,
+            });
+            break;
+        case 'simple':
+        default:
+            // Simple provider is built into episodicMemory.ts
+            // Return a placeholder that will use the default
+            return {
+                name: 'simple',
+                dimension: 256,
+                embed: async (text) => {
+                    // This is a simplified version - the real one is in episodicMemory.ts
+                    const tokens = text.toLowerCase().replace(/[^a-z0-9\s]/g, ' ').split(/\s+/).filter(t => t.length > 2);
+                    const vector = new Array(256).fill(0);
+                    for (const token of tokens) {
+                        let hash = 0;
+                        for (let i = 0; i < token.length; i++) {
+                            hash = ((hash << 5) - hash) + token.charCodeAt(i);
+                            hash = hash & hash;
+                        }
+                        vector[Math.abs(hash) % 256] += 1;
+                    }
+                    const mag = Math.sqrt(vector.reduce((s, v) => s + v * v, 0));
+                    return mag > 0 ? vector.map(v => v / mag) : vector;
+                },
+            };
+    }
+    // Wrap with cache if requested
+    if (options.useCache) {
+        return new CachedEmbeddingProvider(provider, options.maxCacheSize);
+    }
+    return provider;
+}
+/**
+ * Auto-detect best available embedding provider
+ */
+export function autoDetectEmbeddingProvider() {
+    // Check for API keys in environment
+    const openaiKey = process.env['OPENAI_API_KEY'];
+    const deepseekKey = process.env['DEEPSEEK_API_KEY'];
+    if (openaiKey) {
+        return createEmbeddingProvider({
+            type: 'openai',
+            apiKey: openaiKey,
+            useCache: true,
+        });
+    }
+    if (deepseekKey) {
+        return createEmbeddingProvider({
+            type: 'deepseek',
+            apiKey: deepseekKey,
+            useCache: true,
+        });
+    }
+    // Try Ollama (local)
+    // Could add a ping check here, but for now just use simple
+    return createEmbeddingProvider({ type: 'simple' });
+}
+//# sourceMappingURL=embeddingProviders.js.map

package/dist/core/embeddingProviders.js.map

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

package/dist/core/episodicMemory.d.ts

@@ -0,0 +1,259 @@
+/**
+ * Episodic Memory System - Cross-session pattern learning with semantic indexing
+ *
+ * Features:
+ * 1. Episode detection and boundary marking
+ * 2. Semantic indexing via vector embeddings (pluggable providers)
+ * 3. Cross-session pattern learning and retrieval
+ * 4. Task-specific memory with temporal decay
+ * 5. Memory consolidation and pruning
+ *
+ * Storage: ~/.agi/episodic-memory/
+ *   - episodes.json     (episode metadata index)
+ *   - embeddings.bin    (vector embeddings cache)
+ *   - patterns.json     (learned patterns)
+ */
+export interface Episode {
+    id: string;
+    sessionId: string;
+    startTime: number;
+    endTime: number;
+    /** User's original intent/prompt that started this episode */
+    intent: string;
+    /** Category of work performed */
+    category: EpisodeCategory;
+    /** Tools used during this episode */
+    toolsUsed: string[];
+    /** Key files touched */
+    filesModified: string[];
+    /** Whether the episode was successful */
+    success: boolean;
+    /** Summary of what was accomplished */
+    summary: string;
+    /** Tags for semantic grouping */
+    tags: string[];
+    /** Embedding vector for semantic search (optional) */
+    embedding?: number[];
+    /** Parent episode if this is a sub-task */
+    parentId?: string;
+    /** Retrieval count for popularity weighting */
+    retrievalCount: number;
+    /** Last time this episode was retrieved */
+    lastRetrieved: number;
+}
+export type EpisodeCategory = 'bug_fix' | 'feature_add' | 'refactor' | 'test_write' | 'documentation' | 'analysis' | 'configuration' | 'debugging' | 'optimization' | 'migration' | 'unknown';
+export interface LearnedApproach {
+    id: string;
+    /** Pattern that triggers this approach (normalized) */
+    triggerPattern: string;
+    /** Keywords for fast matching */
+    keywords: string[];
+    /** Step-by-step approach that worked */
+    approach: string[];
+    /** Tools typically used */
+    tools: string[];
+    /** Success rate (0-1) */
+    successRate: number;
+    /** Number of times this approach was used */
+    useCount: number;
+    /** Episode IDs that contributed to this pattern */
+    sourceEpisodes: string[];
+    /** Embedding for semantic matching */
+    embedding?: number[];
+    /** Last update timestamp */
+    updatedAt: number;
+}
+export interface MemoryQuery {
+    /** Natural language query */
+    query: string;
+    /** Filter by category */
+    category?: EpisodeCategory;
+    /** Filter by tags */
+    tags?: string[];
+    /** Filter by time range (ms since epoch) */
+    since?: number;
+    /** Filter by success status */
+    successOnly?: boolean;
+    /** Maximum results */
+    limit?: number;
+    /** Minimum similarity threshold (0-1) */
+    minSimilarity?: number;
+}
+export interface MemorySearchResult {
+    episode: Episode;
+    similarity: number;
+    matchReason: string;
+}
+export interface EmbeddingProvider {
+    /** Generate embedding vector for text */
+    embed(text: string): Promise<number[]>;
+    /** Dimension of embedding vectors */
+    dimension: number;
+    /** Provider name for tracking */
+    name: string;
+}
+export interface EpisodicMemoryConfig {
+    /** Maximum episodes to keep */
+    maxEpisodes: number;
+    /** Maximum learned approaches to keep */
+    maxApproaches: number;
+    /** Temporal decay factor (0-1, lower = faster decay) */
+    decayFactor: number;
+    /** Minimum similarity for semantic search (0-1) */
+    minSimilarity: number;
+    /** Enable embedding-based search */
+    useEmbeddings: boolean;
+    /** Embedding provider (optional) */
+    embeddingProvider?: EmbeddingProvider;
+    /** Storage directory */
+    storageDir: string;
+}
+/**
+ * Optimization profile for task-specific settings.
+ * Used to configure RL tournament behavior, validation, and execution strategies
+ * based on learned patterns from successful episodes.
+ */
+export interface OptimizationProfile {
+    id: string;
+    /** Category this profile applies to */
+    category: EpisodeCategory;
+    /** Policy name for human reference */
+    policyName: string;
+    /** Preferred upgrade mode for this category */
+    preferredMode: 'single-continuous' | 'dual-rl-continuous' | 'dual-rl-tournament';
+    /** Whether to use git worktrees for isolation */
+    useGitWorktrees: boolean;
+    /** Custom reward weights for RL tournament */
+    rewardWeights: {
+        executionSuccess: number;
+        testsPassed: number;
+        staticAnalysis: number;
+        codeQuality: number;
+        blastRadius: number;
+        selfAssessment: number;
+        speedBonus: number;
+    };
+    /** Tools that perform well for this category */
+    preferredTools: string[];
+    /** Success rate threshold for auto-approval */
+    autoApprovalThreshold: number;
+    /** Number of successful executions */
+    successCount: number;
+    /** Number of failed executions */
+    failureCount: number;
+    /** Last update timestamp */
+    updatedAt: number;
+}
+export declare class EpisodicMemory {
+    private config;
+    private episodes;
+    private approaches;
+    private optimizationProfiles;
+    private embeddingProvider;
+    private dirty;
+    private currentEpisode;
+    private episodeToolsUsed;
+    private episodeFilesModified;
+    constructor(config?: Partial<EpisodicMemoryConfig>);
+    /**
+     * Start recording a new episode
+     */
+    startEpisode(intent: string, sessionId: string, category?: EpisodeCategory): string;
+    /**
+     * Record tool usage within current episode
+     */
+    recordToolUse(toolName: string): void;
+    /**
+     * Record file modification within current episode
+     */
+    recordFileModification(filePath: string): void;
+    /**
+     * End current episode and save to memory
+     */
+    endEpisode(success: boolean, summary: string): Promise<Episode | null>;
+    /**
+     * Abort current episode without saving
+     */
+    abortEpisode(): void;
+    /**
+     * Search for similar past episodes
+     */
+    search(query: MemoryQuery): Promise<MemorySearchResult[]>;
+    /**
+     * Get learned approach for a task
+     */
+    getApproach(intent: string): Promise<LearnedApproach | null>;
+    /**
+     * Get recent episodes for context
+     */
+    getRecentEpisodes(limit?: number, sessionId?: string): Episode[];
+    /**
+     * Learn patterns from a successful episode
+     */
+    private learnFromEpisode;
+    /**
+     * Record approach failure to update success rate
+     */
+    recordApproachFailure(approachId: string): void;
+    private generateId;
+    private inferCategory;
+    private extractTags;
+    private extractKeywords;
+    private cosineSimilarity;
+    private keywordSimilarity;
+    /**
+     * Get or create an optimization profile for a category.
+     * Used by the RL tournament system to get task-specific settings.
+     */
+    getOptimizationProfile(category: EpisodeCategory, policyName?: string): OptimizationProfile;
+    /**
+     * Update optimization profile based on episode outcome.
+     * Called after an episode completes to adjust learned settings.
+     */
+    updateOptimizationProfile(category: EpisodeCategory, success: boolean, options?: {
+        toolsUsed?: string[];
+        mode?: 'single-continuous' | 'dual-rl-continuous' | 'dual-rl-tournament';
+        usedGitWorktrees?: boolean;
+    }): void;
+    /**
+     * Get reward weights for a category, adjusted based on learned patterns.
+     */
+    getRewardWeights(category: EpisodeCategory): OptimizationProfile['rewardWeights'];
+    /**
+     * Update reward weights based on tournament outcomes.
+     * Adjusts weights to favor signals that correlated with successful outcomes.
+     */
+    adjustRewardWeights(category: EpisodeCategory, winningSignals: Partial<OptimizationProfile['rewardWeights']>, success: boolean): void;
+    /**
+     * Get all optimization profiles for inspection.
+     */
+    getAllOptimizationProfiles(): OptimizationProfile[];
+    private inferPreferredMode;
+    private inferPreferredTools;
+    private pruneEpisodes;
+    private pruneApproaches;
+    private load;
+    save(): void;
+    getStats(): {
+        totalEpisodes: number;
+        successfulEpisodes: number;
+        totalApproaches: number;
+        totalProfiles: number;
+        categoryCounts: Record<string, number>;
+        topTags: string[];
+        profileSummary: {
+            category: string;
+            successRate: number;
+            preferredMode: string;
+        }[];
+    };
+}
+/**
+ * Get or create the default episodic memory instance
+ */
+export declare function getEpisodicMemory(config?: Partial<EpisodicMemoryConfig>): EpisodicMemory;
+/**
+ * Create a new episodic memory instance with custom config
+ */
+export declare function createEpisodicMemory(config?: Partial<EpisodicMemoryConfig>): EpisodicMemory;
+//# sourceMappingURL=episodicMemory.d.ts.map

package/dist/core/episodicMemory.d.ts.map

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