attocode 0.1.0

package/dist/src/integrations/multi-agent.js

@@ -0,0 +1,306 @@
+/**
+ * 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.
+ */
+// =============================================================================
+// MULTI-AGENT MANAGER
+// =============================================================================
+/**
+ * MultiAgentManager coordinates team-based task execution.
+ */
+export class MultiAgentManager {
+    roles = new Map();
+    provider;
+    tools;
+    listeners = [];
+    constructor(provider, tools, initialRoles) {
+        this.provider = provider;
+        this.tools = tools;
+        if (initialRoles) {
+            for (const role of initialRoles) {
+                this.roles.set(role.name, role);
+            }
+        }
+    }
+    /**
+     * Register an agent role.
+     */
+    registerRole(role) {
+        this.roles.set(role.name, role);
+    }
+    /**
+     * Get all registered roles.
+     */
+    getRoles() {
+        return Array.from(this.roles.values());
+    }
+    /**
+     * Find roles with specific capability.
+     */
+    findRolesWithCapability(capability) {
+        return this.getRoles().filter(r => r.capabilities.includes(capability));
+    }
+    /**
+     * Execute task with a team.
+     */
+    async runWithTeam(task, config) {
+        const startTime = Date.now();
+        this.emit({ type: 'team.start', task });
+        // Select coordinator (highest authority or specified)
+        const coordinator = this.selectCoordinator(config);
+        // Select agents for task based on capabilities
+        const selectedRoles = this.selectAgents(task, config);
+        // Spawn agents and run in parallel
+        const agentResults = await this.runAgents(task, selectedRoles);
+        // Build consensus if multiple agents
+        let consensus;
+        if (agentResults.length > 1) {
+            consensus = await this.buildConsensus(agentResults, config.consensusStrategy);
+        }
+        const result = {
+            success: consensus ? consensus.agreed : agentResults[0]?.success ?? false,
+            task,
+            agentResults,
+            consensus,
+            coordinator: coordinator.name,
+            duration: Date.now() - startTime,
+        };
+        this.emit({ type: 'team.complete', result });
+        return result;
+    }
+    /**
+     * Subscribe to events.
+     */
+    on(listener) {
+        this.listeners.push(listener);
+        return () => {
+            const idx = this.listeners.indexOf(listener);
+            if (idx >= 0)
+                this.listeners.splice(idx, 1);
+        };
+    }
+    // -------------------------------------------------------------------------
+    // PRIVATE METHODS
+    // -------------------------------------------------------------------------
+    emit(event) {
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch {
+                // Ignore listener errors
+            }
+        }
+    }
+    selectCoordinator(config) {
+        if (config.coordinatorRole) {
+            const role = this.roles.get(config.coordinatorRole);
+            if (role)
+                return role;
+        }
+        // Default to highest authority
+        return config.roles.reduce((max, role) => role.authority > max.authority ? role : max);
+    }
+    selectAgents(task, config) {
+        if (!task.requiredCapabilities || task.requiredCapabilities.length === 0) {
+            return config.roles;
+        }
+        // Select roles that have at least one required capability
+        return config.roles.filter(role => task.requiredCapabilities.some(cap => role.capabilities.includes(cap)));
+    }
+    async runAgents(task, roles) {
+        const results = [];
+        // Run agents in parallel
+        const promises = roles.map(async (role, idx) => {
+            const agentId = `agent-${idx}-${role.name}`;
+            this.emit({ type: 'agent.spawn', agentId, role: role.name });
+            try {
+                const result = await this.runSingleAgent(agentId, role, task);
+                this.emit({ type: 'agent.complete', agentId, result });
+                return result;
+            }
+            catch (error) {
+                const errorResult = {
+                    agentId,
+                    role: role.name,
+                    success: false,
+                    output: `Error: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                };
+                this.emit({ type: 'agent.complete', agentId, result: errorResult });
+                return errorResult;
+            }
+        });
+        results.push(...await Promise.all(promises));
+        return results;
+    }
+    async runSingleAgent(agentId, role, task) {
+        this.emit({ type: 'agent.working', agentId, status: 'thinking' });
+        const messages = [
+            { role: 'system', content: role.systemPrompt },
+            {
+                role: 'user',
+                content: `Task: ${task.goal}\n${task.context ? `\nContext: ${task.context}` : ''}`,
+            },
+        ];
+        const response = await this.provider.chat(messages, {
+            model: role.model,
+            tools: this.tools,
+        });
+        return {
+            agentId,
+            role: role.name,
+            success: true,
+            output: response.content,
+            confidence: 0.8, // Could be extracted from response
+        };
+    }
+    async buildConsensus(results, strategy) {
+        this.emit({ type: 'consensus.start', strategy });
+        const votes = new Map();
+        const dissent = [];
+        switch (strategy) {
+            case 'voting': {
+                // Simple majority voting
+                for (const result of results) {
+                    const vote = result.success && (result.confidence ?? 0.5) > 0.5;
+                    votes.set(result.agentId, vote);
+                    this.emit({ type: 'consensus.vote', agentId: result.agentId, vote });
+                    if (!vote) {
+                        dissent.push(`${result.role}: ${result.output.slice(0, 100)}`);
+                    }
+                }
+                const yesVotes = Array.from(votes.values()).filter(v => v).length;
+                const agreed = yesVotes > results.length / 2;
+                const decision = {
+                    agreed,
+                    result: agreed
+                        ? results.find(r => r.success)?.output ?? ''
+                        : 'No consensus reached',
+                    votes,
+                    dissent,
+                };
+                this.emit({ type: 'consensus.reached', decision });
+                return decision;
+            }
+            case 'authority': {
+                // Highest authority wins
+                const sorted = [...results].sort((a, b) => {
+                    const roleA = this.roles.get(a.role);
+                    const roleB = this.roles.get(b.role);
+                    return (roleB?.authority ?? 0) - (roleA?.authority ?? 0);
+                });
+                for (const result of results) {
+                    const vote = result === sorted[0];
+                    votes.set(result.agentId, vote);
+                }
+                const decision = {
+                    agreed: sorted[0]?.success ?? false,
+                    result: sorted[0]?.output ?? 'No result',
+                    votes,
+                    dissent,
+                };
+                this.emit({ type: 'consensus.reached', decision });
+                return decision;
+            }
+            case 'unanimous': {
+                // All must agree
+                const allSuccess = results.every(r => r.success);
+                for (const result of results) {
+                    votes.set(result.agentId, result.success);
+                    if (!result.success) {
+                        dissent.push(`${result.role}: ${result.output.slice(0, 100)}`);
+                    }
+                }
+                const decision = {
+                    agreed: allSuccess,
+                    result: allSuccess
+                        ? results[0]?.output ?? ''
+                        : 'Unanimous agreement not reached',
+                    votes,
+                    dissent,
+                };
+                this.emit({ type: 'consensus.reached', decision });
+                return decision;
+            }
+            case 'first-complete': {
+                // First successful result wins
+                const first = results.find(r => r.success);
+                for (const result of results) {
+                    votes.set(result.agentId, result === first);
+                }
+                const decision = {
+                    agreed: !!first,
+                    result: first?.output ?? 'No successful result',
+                    votes,
+                    dissent: [],
+                };
+                this.emit({ type: 'consensus.reached', decision });
+                return decision;
+            }
+        }
+    }
+}
+// =============================================================================
+// FACTORY
+// =============================================================================
+/**
+ * Create a multi-agent manager.
+ */
+export function createMultiAgentManager(provider, tools, roles) {
+    return new MultiAgentManager(provider, tools, roles);
+}
+// =============================================================================
+// BUILT-IN ROLES
+// =============================================================================
+export const CODER_ROLE = {
+    name: 'coder',
+    description: 'Expert software developer',
+    systemPrompt: `You are an expert software developer.
+Focus on:
+- Writing clean, maintainable code
+- Following best practices
+- Considering edge cases
+- Writing tests when appropriate`,
+    capabilities: ['code', 'debug', 'refactor', 'test'],
+    authority: 5,
+};
+export const REVIEWER_ROLE = {
+    name: 'reviewer',
+    description: 'Code reviewer focused on quality',
+    systemPrompt: `You are a code reviewer.
+Focus on:
+- Security vulnerabilities
+- Performance issues
+- Code style and consistency
+- Potential bugs`,
+    capabilities: ['review', 'analyze', 'security'],
+    authority: 6,
+};
+export const ARCHITECT_ROLE = {
+    name: 'architect',
+    description: 'System architect',
+    systemPrompt: `You are a system architect.
+Focus on:
+- Overall system design
+- Scalability considerations
+- Technology choices
+- Integration patterns`,
+    capabilities: ['design', 'architect', 'plan'],
+    authority: 8,
+};
+export const RESEARCHER_ROLE = {
+    name: 'researcher',
+    description: 'Technical researcher',
+    systemPrompt: `You are a technical researcher.
+Focus on:
+- Finding relevant information
+- Evaluating solutions
+- Understanding trade-offs
+- Synthesizing knowledge`,
+    capabilities: ['research', 'analyze', 'evaluate'],
+    authority: 4,
+};
+//# sourceMappingURL=multi-agent.js.map

package/dist/src/integrations/multi-agent.js.map

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

package/dist/src/integrations/observability.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Lesson 23: Observability Integration
+ *
+ * Integrates observability (Lesson 19) into the production agent.
+ * Provides tracing, metrics, and structured logging.
+ */
+import type { ObservabilityConfig, AgentMetrics } from '../types.js';
+/**
+ * Distributed tracing implementation.
+ */
+export declare class Tracer {
+    private spans;
+    private currentTraceId;
+    private spanStack;
+    private config;
+    private exporter;
+    constructor(config: NonNullable<ObservabilityConfig['tracing']>);
+    /**
+     * Start a new trace.
+     */
+    startTrace(name: string): string;
+    /**
+     * Start a new span.
+     */
+    startSpan(name: string, options?: {
+        isRoot?: boolean;
+        attributes?: Record<string, unknown>;
+    }): string;
+    /**
+     * End a span.
+     */
+    endSpan(spanId?: string): void;
+    /**
+     * Add an event to the current span.
+     */
+    addEvent(name: string, attributes?: Record<string, unknown>): void;
+    /**
+     * Set attribute on current span.
+     */
+    setAttribute(key: string, value: unknown): void;
+    /**
+     * Record an error on the current span.
+     */
+    recordError(error: Error): void;
+    /**
+     * End trace and export spans.
+     */
+    endTrace(): Promise<void>;
+    /**
+     * Get current trace ID.
+     */
+    getTraceId(): string | null;
+    /**
+     * Execute function with span.
+     */
+    withSpan<T>(name: string, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Create default exporter.
+     */
+    private createDefaultExporter;
+    /**
+     * Print span tree to console.
+     */
+    private printSpanTree;
+    /**
+     * Generate unique ID.
+     */
+    private generateId;
+}
+/**
+ * Collects and aggregates metrics.
+ */
+export declare class MetricsCollector {
+    private config;
+    private counters;
+    private gauges;
+    private histograms;
+    constructor(config: NonNullable<ObservabilityConfig['metrics']>);
+    /**
+     * Increment a counter.
+     */
+    increment(name: string, value?: number): void;
+    /**
+     * Set a gauge value.
+     */
+    setGauge(name: string, value: number): void;
+    /**
+     * Record a histogram value.
+     */
+    recordHistogram(name: string, value: number): void;
+    /**
+     * Record LLM call metrics.
+     */
+    recordLLMCall(inputTokens: number, outputTokens: number, durationMs: number, model: string, actualCost?: number): void;
+    /**
+     * Record tool call metrics.
+     */
+    recordToolCall(tool: string, durationMs: number, success: boolean): void;
+    /**
+     * Get aggregated metrics.
+     */
+    getMetrics(): AgentMetrics;
+    /**
+     * Get average from histogram.
+     */
+    private getAverageHistogram;
+    /**
+     * Estimate cost based on model using OpenRouter pricing cache.
+     */
+    private estimateCost;
+    /**
+     * Reset all metrics.
+     */
+    reset(): void;
+}
+/**
+ * Structured logger.
+ */
+export declare class Logger {
+    private config;
+    private context;
+    constructor(config: NonNullable<ObservabilityConfig['logging']>);
+    /**
+     * Set context that will be included in all logs.
+     */
+    setContext(context: Record<string, unknown>): void;
+    /**
+     * Log at debug level.
+     */
+    debug(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Log at info level.
+     */
+    info(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Log at warn level.
+     */
+    warn(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Log at error level.
+     */
+    error(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Internal log method.
+     */
+    private log;
+    /**
+     * Check if should log at level.
+     */
+    private shouldLog;
+}
+/**
+ * Combined observability manager.
+ */
+export declare class ObservabilityManager {
+    tracer: Tracer | null;
+    metrics: MetricsCollector | null;
+    logger: Logger | null;
+    constructor(config: ObservabilityConfig);
+}
+export declare function createObservabilityManager(config: ObservabilityConfig): ObservabilityManager;
+//# sourceMappingURL=observability.d.ts.map

package/dist/src/integrations/observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../../../src/integrations/observability.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAsB,YAAY,EAAE,MAAM,aAAa,CAAC;AAOzF;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,MAAM,CAA8C;IAC5D,OAAO,CAAC,QAAQ,CAAe;gBAEnB,MAAM,EAAE,WAAW,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAK/D;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAShC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAO,GAAG,MAAM;IAwBzG;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAiB9B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAclE;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAU/C;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAa/B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB/B;;OAEG;IACH,UAAU,IAAI,MAAM,GAAG,IAAI;IAI3B;;OAEG;IACG,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAejE;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAU7B;;OAEG;IACH,OAAO,CAAC,aAAa;IAyBrB;;OAEG;IACH,OAAO,CAAC,UAAU;CAGnB;AAMD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAA8C;IAC5D,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,UAAU,CAAoC;gBAE1C,MAAM,EAAE,WAAW,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAI/D;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,IAAI;IAKxC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAI3C;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAMlD;;OAEG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAoBtH;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IASxE;;OAEG;IACH,UAAU,IAAI,YAAY;IAY1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACH,KAAK,IAAI,IAAI;CAKd;AAMD;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAA8C;IAC5D,OAAO,CAAC,OAAO,CAA+B;gBAElC,MAAM,EAAE,WAAW,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAI/D;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIlD;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D;;OAEG;IACH,OAAO,CAAC,GAAG;IAmBX;;OAEG;IACH,OAAO,CAAC,SAAS;CAKlB;AAMD;;GAEG;AACH,qBAAa,oBAAoB;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC7B,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IACxC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;gBAExB,MAAM,EAAE,mBAAmB;CAaxC;AAgBD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,mBAAmB,GAAG,oBAAoB,CAE5F"}