attocode 0.2.4 → 0.2.6

package/dist/src/integrations/tasks/work-log.js

@@ -0,0 +1,287 @@
+/**
+ * Work Log - Compaction-Resilient Structured Summary
+ *
+ * Maintains a persistent structured summary of agent work that survives
+ * context compaction. Auto-populated from tool execution results.
+ *
+ * When context is compacted, the work log is injected as a system message
+ * so the agent doesn't "forget" what it has already done (preventing
+ * re-reading files, re-searching, etc.).
+ */
+// =============================================================================
+// WORK LOG
+// =============================================================================
+export class WorkLog {
+    currentHypothesis = '';
+    filesRead = new Map(); // path → 1-line summary
+    filesModified = new Map(); // path → what changed
+    testResults = [];
+    approachesTried = [];
+    commands = [];
+    config;
+    constructor(config = {}) {
+        this.config = {
+            maxEntriesPerCategory: config.maxEntriesPerCategory ?? 30,
+            maxCompactTokens: config.maxCompactTokens ?? 1500,
+        };
+    }
+    /**
+     * Record a tool execution result into the work log.
+     * Called automatically after each tool call in agent.ts.
+     */
+    recordToolExecution(toolName, args, result) {
+        const resultStr = typeof result === 'string' ? result : '';
+        switch (toolName) {
+            case 'read_file': {
+                const filePath = String(args.path || args.file_path || '');
+                if (filePath && !this.filesRead.has(filePath)) {
+                    // Extract a brief summary from the first few lines of content
+                    const summary = this.summarizeFileContent(resultStr);
+                    this.filesRead.set(filePath, summary);
+                    this.trimMap(this.filesRead, this.config.maxEntriesPerCategory);
+                }
+                break;
+            }
+            case 'write_file':
+            case 'edit_file': {
+                const filePath = String(args.path || args.file_path || '');
+                if (filePath) {
+                    const desc = toolName === 'write_file'
+                        ? 'created/overwritten'
+                        : `edited: ${String(args.old_text || '').slice(0, 50)}...`;
+                    this.filesModified.set(filePath, desc);
+                    this.trimMap(this.filesModified, this.config.maxEntriesPerCategory);
+                }
+                break;
+            }
+            case 'bash': {
+                const cmd = String(args.command || '');
+                if (cmd) {
+                    this.commands.push(cmd.slice(0, 200));
+                    if (this.commands.length > this.config.maxEntriesPerCategory) {
+                        this.commands.shift();
+                    }
+                    // Detect test results from bash output
+                    this.parseTestResults(cmd, resultStr);
+                }
+                break;
+            }
+            case 'grep':
+            case 'glob':
+            case 'search':
+            case 'search_files':
+            case 'find_files': {
+                const pattern = String(args.pattern || args.query || '');
+                if (pattern) {
+                    const key = `search:${pattern}`;
+                    this.filesRead.set(key, `Searched for: ${pattern}`);
+                }
+                break;
+            }
+        }
+    }
+    /**
+     * Record an approach the agent tried and its outcome.
+     */
+    recordApproach(approach, outcome, detail) {
+        this.approachesTried.push({ approach, outcome, detail });
+        if (this.approachesTried.length > this.config.maxEntriesPerCategory) {
+            this.approachesTried.shift();
+        }
+    }
+    /**
+     * Set the current working hypothesis.
+     */
+    setHypothesis(hypothesis) {
+        this.currentHypothesis = hypothesis;
+    }
+    /**
+     * Generate a compact string representation (~500 tokens) for injection
+     * after context compaction.
+     */
+    toCompactString() {
+        const sections = [];
+        sections.push('[WORK LOG - What you have already done in this session]');
+        if (this.currentHypothesis) {
+            sections.push(`Hypothesis: ${this.currentHypothesis}`);
+        }
+        // Files read
+        if (this.filesRead.size > 0) {
+            const fileEntries = Array.from(this.filesRead.entries())
+                .filter(([k]) => !k.startsWith('search:'))
+                .slice(-15)
+                .map(([path, summary]) => `  ${path}: ${summary}`)
+                .join('\n');
+            if (fileEntries) {
+                sections.push(`Files read (${this.filesRead.size} total):\n${fileEntries}`);
+            }
+        }
+        // Files modified
+        if (this.filesModified.size > 0) {
+            const modEntries = Array.from(this.filesModified.entries())
+                .map(([path, desc]) => `  ${path}: ${desc}`)
+                .join('\n');
+            sections.push(`Files modified:\n${modEntries}`);
+        }
+        // Test results (most recent)
+        if (this.testResults.length > 0) {
+            const recentTests = this.testResults.slice(-5);
+            const testLines = recentTests
+                .map((t) => `  ${t.passed ? 'PASS' : 'FAIL'}: ${t.test}${t.error ? ` (${t.error.slice(0, 80)})` : ''}`)
+                .join('\n');
+            sections.push(`Test results:\n${testLines}`);
+        }
+        // Approaches tried
+        if (this.approachesTried.length > 0) {
+            const approachLines = this.approachesTried
+                .map((a) => `  [${a.outcome}] ${a.approach}${a.detail ? `: ${a.detail}` : ''}`)
+                .join('\n');
+            sections.push(`Approaches tried:\n${approachLines}`);
+        }
+        // Recent commands
+        if (this.commands.length > 0) {
+            const recentCmds = this.commands
+                .slice(-5)
+                .map((c) => `  $ ${c}`)
+                .join('\n');
+            sections.push(`Recent commands:\n${recentCmds}`);
+        }
+        sections.push('[END WORK LOG - Do NOT re-read files listed above. Continue from where you left off.]');
+        const result = sections.join('\n\n');
+        // Enforce maxCompactTokens (~4 chars per token)
+        const maxChars = this.config.maxCompactTokens * 4;
+        if (result.length > maxChars) {
+            return this.toCompactStringTruncated(maxChars);
+        }
+        return result;
+    }
+    /**
+     * Produce a truncated compact string that fits within the character budget.
+     * Keeps fewer entries per category to stay within limits.
+     */
+    toCompactStringTruncated(maxChars) {
+        const sections = [];
+        sections.push('[WORK LOG - What you have already done in this session]');
+        if (this.currentHypothesis) {
+            sections.push(`Hypothesis: ${this.currentHypothesis}`);
+        }
+        // Files modified (always included — most important)
+        if (this.filesModified.size > 0) {
+            const modEntries = Array.from(this.filesModified.entries())
+                .slice(-5)
+                .map(([path, desc]) => `  ${path}: ${desc}`)
+                .join('\n');
+            sections.push(`Files modified:\n${modEntries}`);
+        }
+        // Files read (top 5 most recent)
+        if (this.filesRead.size > 0) {
+            const fileEntries = Array.from(this.filesRead.entries())
+                .filter(([k]) => !k.startsWith('search:'))
+                .slice(-10)
+                .map(([path, summary]) => `  ${path}: ${summary}`)
+                .join('\n');
+            if (fileEntries) {
+                sections.push(`Files read (${this.filesRead.size} total, showing last 10):\n${fileEntries}`);
+            }
+        }
+        // Test results (last 3)
+        if (this.testResults.length > 0) {
+            const recentTests = this.testResults.slice(-5);
+            const testLines = recentTests
+                .map((t) => `  ${t.passed ? 'PASS' : 'FAIL'}: ${t.test}${t.error ? ` (${t.error.slice(0, 80)})` : ''}`)
+                .join('\n');
+            sections.push(`Test results:\n${testLines}`);
+        }
+        // Recent commands (last 3)
+        if (this.commands.length > 0) {
+            const recentCmds = this.commands
+                .slice(-3)
+                .map((c) => `  $ ${c}`)
+                .join('\n');
+            sections.push(`Recent commands:\n${recentCmds}`);
+        }
+        sections.push('[END WORK LOG - Do NOT re-read files listed above. Continue from where you left off.]');
+        let result = sections.join('\n\n');
+        // Hard truncation as last resort
+        if (result.length > maxChars) {
+            result = result.slice(0, maxChars - 30) + '\n\n[... WORK LOG TRUNCATED ...]';
+        }
+        return result;
+    }
+    /**
+     * Check if the work log has any content worth injecting.
+     */
+    hasContent() {
+        return (this.filesRead.size > 0 ||
+            this.filesModified.size > 0 ||
+            this.testResults.length > 0 ||
+            this.commands.length > 0);
+    }
+    /**
+     * Get basic stats about the work log.
+     */
+    getStats() {
+        return {
+            filesRead: this.filesRead.size,
+            filesModified: this.filesModified.size,
+            testResults: this.testResults.length,
+            approaches: this.approachesTried.length,
+            commands: this.commands.length,
+        };
+    }
+    /**
+     * Reset the work log.
+     */
+    reset() {
+        this.currentHypothesis = '';
+        this.filesRead.clear();
+        this.filesModified.clear();
+        this.testResults = [];
+        this.approachesTried = [];
+        this.commands = [];
+    }
+    // ---------------------------------------------------------------------------
+    // PRIVATE HELPERS
+    // ---------------------------------------------------------------------------
+    summarizeFileContent(content) {
+        if (!content)
+            return '(read)';
+        const firstLine = content.split('\n').find((l) => l.trim().length > 0) || '';
+        return firstLine.slice(0, 80) || '(read)';
+    }
+    parseTestResults(command, output) {
+        const isTestCommand = /pytest|python\s+-m\s+pytest|npm\s+test|jest/.test(command);
+        if (!isTestCommand || !output)
+            return;
+        // Parse pytest-style output: "PASSED" or "FAILED" in output
+        const passMatch = output.match(/(\d+)\s+passed/);
+        const failMatch = output.match(/(\d+)\s+failed/);
+        if (passMatch || failMatch) {
+            const passed = passMatch ? parseInt(passMatch[1], 10) : 0;
+            const failed = failMatch ? parseInt(failMatch[1], 10) : 0;
+            this.testResults.push({
+                test: command.slice(0, 100),
+                passed: failed === 0 && passed > 0,
+                error: failed > 0 ? `${failed} failed, ${passed} passed` : undefined,
+            });
+            if (this.testResults.length > this.config.maxEntriesPerCategory) {
+                this.testResults.shift();
+            }
+        }
+    }
+    trimMap(map, maxSize) {
+        if (map.size > maxSize) {
+            const keysToRemove = Array.from(map.keys()).slice(0, map.size - maxSize);
+            for (const key of keysToRemove) {
+                map.delete(key);
+            }
+        }
+    }
+}
+// =============================================================================
+// FACTORY
+// =============================================================================
+export function createWorkLog(config) {
+    return new WorkLog(config);
+}
+//# sourceMappingURL=work-log.js.map

package/dist/src/integrations/tasks/work-log.js.map

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

package/dist/src/integrations/utilities/capabilities.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Capabilities Registry
+ *
+ * Unified view of all agent capabilities: tools, skills, agents, MCP tools, and commands.
+ * Enables discovery through /powers command and semantic search.
+ */
+import type { ToolDefinition } from '../../types.js';
+import type { SkillManager } from '../skills/skills.js';
+import type { AgentRegistry } from '../agents/agent-registry.js';
+import type { MCPClient } from '../mcp/mcp-client.js';
+/**
+ * Capability types in the system.
+ */
+export type CapabilityType = 'tool' | 'skill' | 'agent' | 'mcp_tool' | 'command';
+/**
+ * A capability represents any action the agent can perform.
+ */
+export interface Capability {
+    /** Unique identifier (e.g., "tool:read_file", "skill:review") */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Type of capability */
+    type: CapabilityType;
+    /** Human-readable description */
+    description: string;
+    /** Whether this capability is currently active/available */
+    active: boolean;
+    /** Source of the capability (e.g., "built-in", "mcp:github", "skills/review.md") */
+    source: string;
+    /** Tags for discovery */
+    tags: string[];
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Search result with relevance score.
+ */
+export interface CapabilitySearchResult {
+    capability: Capability;
+    score: number;
+    matches: string[];
+}
+/**
+ * Counts by capability type.
+ */
+export interface CapabilityCounts {
+    total: number;
+    active: number;
+}
+/**
+ * Command definition for discovery.
+ */
+export interface CommandDefinition {
+    name: string;
+    description: string;
+    category?: string;
+    aliases?: string[];
+}
+/**
+ * Registry event types.
+ */
+export type CapabilitiesEvent = {
+    type: 'capability.added';
+    capability: Capability;
+} | {
+    type: 'capability.removed';
+    id: string;
+} | {
+    type: 'capability.updated';
+    capability: Capability;
+} | {
+    type: 'registry.refreshed';
+    counts: Record<CapabilityType, CapabilityCounts>;
+};
+export type CapabilitiesEventListener = (event: CapabilitiesEvent) => void;
+/**
+ * Unified registry for all agent capabilities.
+ */
+export declare class CapabilitiesRegistry {
+    private capabilities;
+    private eventListeners;
+    private toolRegistry?;
+    private skillManager?;
+    private agentRegistry?;
+    private mcpClient?;
+    /**
+     * Register the tool registry as a capability source.
+     */
+    registerToolRegistry(registry: {
+        getTools(): ToolDefinition[];
+    }): void;
+    /**
+     * Register the skill manager as a capability source.
+     */
+    registerSkillManager(manager: SkillManager): void;
+    /**
+     * Register the agent registry as a capability source.
+     */
+    registerAgentRegistry(registry: AgentRegistry): void;
+    /**
+     * Register the MCP client as a capability source.
+     */
+    registerMCPClient(client: MCPClient): void;
+    /**
+     * Refresh all capabilities from registered sources.
+     */
+    refresh(): void;
+    private refreshTools;
+    private refreshSkills;
+    private refreshAgents;
+    private refreshMCPTools;
+    private refreshCommands;
+    /**
+     * Extract tags from description text.
+     */
+    private extractTags;
+    /**
+     * Get all capabilities.
+     */
+    getAll(): Capability[];
+    /**
+     * Get capabilities by type.
+     */
+    getByType(type: CapabilityType): Capability[];
+    /**
+     * Search capabilities by query.
+     */
+    search(query: string): CapabilitySearchResult[];
+    /**
+     * Get counts by type.
+     */
+    getCounts(): Record<CapabilityType, CapabilityCounts>;
+    /**
+     * Get a specific capability by ID.
+     */
+    get(id: string): Capability | undefined;
+    /**
+     * Subscribe to registry events.
+     */
+    subscribe(listener: CapabilitiesEventListener): () => void;
+    private emit;
+}
+/**
+ * Create a capabilities registry.
+ */
+export declare function createCapabilitiesRegistry(): CapabilitiesRegistry;
+/**
+ * Format capabilities summary for display.
+ */
+export declare function formatCapabilitiesSummary(counts: Record<CapabilityType, CapabilityCounts>): string;
+/**
+ * Format capabilities list for a specific type.
+ */
+export declare function formatCapabilitiesList(capabilities: Capability[], type: CapabilityType): string;
+/**
+ * Format search results for display.
+ */
+export declare function formatSearchResults(results: CapabilitySearchResult[], limit?: number): string;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/src/integrations/utilities/capabilities.d.ts.map

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