attocode 0.1.0

package/dist/src/integrations/memory.js

@@ -0,0 +1,288 @@
+/**
+ * Lesson 23: Memory Integration
+ *
+ * Integrates the memory system (Lesson 14) into the production agent.
+ * Provides episodic, semantic, and working memory capabilities.
+ */
+// =============================================================================
+// MEMORY MANAGER
+// =============================================================================
+/**
+ * Manages different types of memory for the agent.
+ */
+export class MemoryManager {
+    episodic = new Map();
+    semantic = new Map();
+    working = [];
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Store an episodic memory (interaction history).
+     */
+    storeEpisodic(content, metadata = {}) {
+        if (!this.config.types?.episodic)
+            return '';
+        const entry = this.createEntry('episodic', content, metadata);
+        this.episodic.set(entry.id, entry);
+        return entry.id;
+    }
+    /**
+     * Store a semantic memory (facts, knowledge).
+     */
+    storeSemantic(content, metadata = {}) {
+        if (!this.config.types?.semantic)
+            return '';
+        const entry = this.createEntry('semantic', content, metadata);
+        // Check for duplicates (simple text match)
+        for (const existing of this.semantic.values()) {
+            if (existing.content === content) {
+                existing.accessCount++;
+                existing.lastAccessed = new Date();
+                return existing.id;
+            }
+        }
+        this.semantic.set(entry.id, entry);
+        return entry.id;
+    }
+    /**
+     * Update working memory (current context).
+     */
+    updateWorking(content, metadata = {}) {
+        if (!this.config.types?.working)
+            return;
+        const entry = this.createEntry('working', content, metadata);
+        // Keep working memory limited
+        this.working.push(entry);
+        if (this.working.length > 10) {
+            this.working.shift();
+        }
+    }
+    /**
+     * Clear working memory.
+     */
+    clearWorking() {
+        this.working = [];
+    }
+    /**
+     * Retrieve relevant memories.
+     */
+    retrieve(query, limit) {
+        const maxResults = limit || this.config.retrievalLimit || 10;
+        const strategy = this.config.retrievalStrategy || 'hybrid';
+        let entries = [];
+        switch (strategy) {
+            case 'recency':
+                entries = this.retrieveByRecency(query, maxResults);
+                break;
+            case 'relevance':
+                entries = this.retrieveByRelevance(query, maxResults);
+                break;
+            case 'importance':
+                entries = this.retrieveByImportance(query, maxResults);
+                break;
+            case 'hybrid':
+            default:
+                entries = this.retrieveHybrid(query, maxResults);
+                break;
+        }
+        // Update access counts
+        for (const entry of entries) {
+            entry.accessCount++;
+            entry.lastAccessed = new Date();
+        }
+        return { entries, strategy };
+    }
+    /**
+     * Get memory context as strings for prompt injection.
+     */
+    getContextStrings(query) {
+        const { entries } = this.retrieve(query);
+        return entries.map((entry) => {
+            const typeLabel = entry.type.charAt(0).toUpperCase() + entry.type.slice(1);
+            return `[${typeLabel}] ${entry.content}`;
+        });
+    }
+    /**
+     * Store a conversation turn.
+     */
+    storeConversation(messages) {
+        for (const msg of messages) {
+            if (msg.role === 'user') {
+                this.storeEpisodic(`User: ${msg.content}`, { role: 'user' });
+            }
+            else if (msg.role === 'assistant') {
+                this.storeEpisodic(`Assistant: ${msg.content}`, { role: 'assistant' });
+                // Extract potential facts for semantic memory
+                this.extractAndStoreFacts(msg.content);
+            }
+        }
+        // Update working memory with recent context
+        const recentContent = messages
+            .slice(-3)
+            .map((m) => `${m.role}: ${m.content.slice(0, 100)}`)
+            .join('\n');
+        this.updateWorking(recentContent);
+    }
+    /**
+     * Extract facts from response for semantic memory.
+     */
+    extractAndStoreFacts(content) {
+        // Simple heuristic: look for declarative statements
+        const sentences = content.split(/[.!?]+/).filter((s) => s.trim().length > 20);
+        for (const sentence of sentences) {
+            const trimmed = sentence.trim();
+            // Store sentences that look like facts
+            if (trimmed.includes(' is ') ||
+                trimmed.includes(' are ') ||
+                trimmed.includes(' was ') ||
+                trimmed.includes(' were ') ||
+                trimmed.includes(' has ') ||
+                trimmed.includes(' have ')) {
+                this.storeSemantic(trimmed, { source: 'extracted' });
+            }
+        }
+    }
+    /**
+     * Retrieve by recency.
+     */
+    retrieveByRecency(query, limit) {
+        const all = this.getAllEntries();
+        return all
+            .sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime())
+            .slice(0, limit);
+    }
+    /**
+     * Retrieve by relevance (simple text matching).
+     */
+    retrieveByRelevance(query, limit) {
+        const queryTerms = query.toLowerCase().split(/\s+/);
+        const all = this.getAllEntries();
+        const scored = all.map((entry) => {
+            const content = entry.content.toLowerCase();
+            let score = 0;
+            for (const term of queryTerms) {
+                if (content.includes(term)) {
+                    score += 1;
+                }
+            }
+            return { entry, score };
+        });
+        return scored
+            .filter((s) => s.score > 0)
+            .sort((a, b) => b.score - a.score)
+            .slice(0, limit)
+            .map((s) => s.entry);
+    }
+    /**
+     * Retrieve by importance.
+     */
+    retrieveByImportance(query, limit) {
+        const all = this.getAllEntries();
+        return all.sort((a, b) => b.importance - a.importance).slice(0, limit);
+    }
+    /**
+     * Hybrid retrieval combining strategies.
+     */
+    retrieveHybrid(query, limit) {
+        const all = this.getAllEntries();
+        const queryTerms = query.toLowerCase().split(/\s+/);
+        const now = Date.now();
+        const scored = all.map((entry) => {
+            const content = entry.content.toLowerCase();
+            // Relevance score
+            let relevance = 0;
+            for (const term of queryTerms) {
+                if (content.includes(term))
+                    relevance += 1;
+            }
+            relevance = relevance / Math.max(queryTerms.length, 1);
+            // Recency score (decay over time)
+            const ageHours = (now - entry.createdAt.getTime()) / (1000 * 60 * 60);
+            const recency = Math.exp(-ageHours / 24); // Decay over 24 hours
+            // Importance score
+            const importance = entry.importance;
+            // Access frequency bonus
+            const frequencyBonus = Math.min(entry.accessCount * 0.1, 0.5);
+            // Combined score
+            const score = relevance * 0.4 + recency * 0.3 + importance * 0.2 + frequencyBonus * 0.1;
+            return { entry, score };
+        });
+        return scored
+            .sort((a, b) => b.score - a.score)
+            .slice(0, limit)
+            .map((s) => s.entry);
+    }
+    /**
+     * Get all memory entries.
+     */
+    getAllEntries() {
+        return [
+            ...Array.from(this.episodic.values()),
+            ...Array.from(this.semantic.values()),
+            ...this.working,
+        ];
+    }
+    /**
+     * Create a memory entry.
+     */
+    createEntry(type, content, metadata) {
+        const now = new Date();
+        return {
+            id: `mem-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`,
+            type,
+            content,
+            importance: this.calculateImportance(content, type),
+            createdAt: now,
+            lastAccessed: now,
+            accessCount: 0,
+            metadata,
+        };
+    }
+    /**
+     * Calculate importance score.
+     */
+    calculateImportance(content, type) {
+        let score = 0.5;
+        // Type-based importance
+        if (type === 'semantic')
+            score += 0.2;
+        if (type === 'working')
+            score += 0.1;
+        // Content-based heuristics
+        if (content.includes('important') || content.includes('critical'))
+            score += 0.1;
+        if (content.includes('error') || content.includes('failed'))
+            score += 0.1;
+        if (content.length > 200)
+            score += 0.05;
+        return Math.min(score, 1);
+    }
+    /**
+     * Get memory statistics.
+     */
+    getStats() {
+        return {
+            episodic: this.episodic.size,
+            semantic: this.semantic.size,
+            working: this.working.length,
+            total: this.episodic.size + this.semantic.size + this.working.length,
+        };
+    }
+    /**
+     * Clear all memory.
+     */
+    clear() {
+        this.episodic.clear();
+        this.semantic.clear();
+        this.working = [];
+    }
+}
+// =============================================================================
+// FACTORY
+// =============================================================================
+export function createMemoryManager(config) {
+    return new MemoryManager(config);
+}
+//# sourceMappingURL=memory.js.map

package/dist/src/integrations/memory.js.map

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

package/dist/src/integrations/multi-agent.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Lesson 25: Multi-Agent Integration
+ *
+ * Integrates multi-agent coordination (from Lesson 17) into
+ * the production agent. Enables team-based execution with
+ * consensus and role-based task distribution.
+ */
+import type { LLMProvider, ToolDefinition } from '../types.js';
+/**
+ * Agent role definition.
+ */
+export interface AgentRole {
+    name: string;
+    description: string;
+    systemPrompt: string;
+    capabilities: string[];
+    authority: number;
+    model?: string;
+}
+/**
+ * Multi-agent team configuration.
+ */
+export interface TeamConfig {
+    roles: AgentRole[];
+    consensusStrategy: ConsensusStrategy;
+    communicationMode: 'broadcast' | 'directed';
+    coordinatorRole?: string;
+}
+export type ConsensusStrategy = 'voting' | 'authority' | 'unanimous' | 'first-complete';
+/**
+ * Task for team execution.
+ */
+export interface TeamTask {
+    id: string;
+    goal: string;
+    context?: string;
+    requiredCapabilities?: string[];
+    deadline?: Date;
+}
+/**
+ * Individual agent result.
+ */
+export interface AgentTaskResult {
+    agentId: string;
+    role: string;
+    success: boolean;
+    output: string;
+    artifacts?: Artifact[];
+    confidence?: number;
+}
+export interface Artifact {
+    type: string;
+    name: string;
+    content: string;
+}
+/**
+ * Team execution result.
+ */
+export interface TeamResult {
+    success: boolean;
+    task: TeamTask;
+    agentResults: AgentTaskResult[];
+    consensus?: Decision;
+    coordinator: string;
+    duration: number;
+}
+export interface Decision {
+    agreed: boolean;
+    result: string;
+    votes: Map<string, boolean>;
+    dissent: string[];
+}
+/**
+ * Multi-agent events.
+ */
+export type MultiAgentEvent = {
+    type: 'team.start';
+    task: TeamTask;
+} | {
+    type: 'agent.spawn';
+    agentId: string;
+    role: string;
+} | {
+    type: 'agent.working';
+    agentId: string;
+    status: string;
+} | {
+    type: 'agent.complete';
+    agentId: string;
+    result: AgentTaskResult;
+} | {
+    type: 'consensus.start';
+    strategy: ConsensusStrategy;
+} | {
+    type: 'consensus.vote';
+    agentId: string;
+    vote: boolean;
+} | {
+    type: 'consensus.reached';
+    decision: Decision;
+} | {
+    type: 'team.complete';
+    result: TeamResult;
+};
+export type MultiAgentEventListener = (event: MultiAgentEvent) => void;
+/**
+ * MultiAgentManager coordinates team-based task execution.
+ */
+export declare class MultiAgentManager {
+    private roles;
+    private provider;
+    private tools;
+    private listeners;
+    constructor(provider: LLMProvider, tools: ToolDefinition[], initialRoles?: AgentRole[]);
+    /**
+     * Register an agent role.
+     */
+    registerRole(role: AgentRole): void;
+    /**
+     * Get all registered roles.
+     */
+    getRoles(): AgentRole[];
+    /**
+     * Find roles with specific capability.
+     */
+    findRolesWithCapability(capability: string): AgentRole[];
+    /**
+     * Execute task with a team.
+     */
+    runWithTeam(task: TeamTask, config: TeamConfig): Promise<TeamResult>;
+    /**
+     * Subscribe to events.
+     */
+    on(listener: MultiAgentEventListener): () => void;
+    private emit;
+    private selectCoordinator;
+    private selectAgents;
+    private runAgents;
+    private runSingleAgent;
+    private buildConsensus;
+}
+/**
+ * Create a multi-agent manager.
+ */
+export declare function createMultiAgentManager(provider: LLMProvider, tools: ToolDefinition[], roles?: AgentRole[]): MultiAgentManager;
+export declare const CODER_ROLE: AgentRole;
+export declare const REVIEWER_ROLE: AgentRole;
+export declare const ARCHITECT_ROLE: AgentRole;
+export declare const RESEARCHER_ROLE: AgentRole;
+//# sourceMappingURL=multi-agent.d.ts.map

package/dist/src/integrations/multi-agent.d.ts.map

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