attocode 0.1.0

package/dist/src/tools/standard.js

@@ -0,0 +1,113 @@
+/**
+ * Lesson 8: Tool Re-exports and Schema Conversion
+ *
+ * Re-exports tools from Lesson 3 and provides conversion utilities
+ * for OpenRouter's native tool use format.
+ */
+import { ToolRegistry, defineTool } from './registry.js';
+import { readFileTool, writeFileTool, editFileTool, listFilesTool } from './file.js';
+import { bashTool, grepTool, globTool } from './bash.js';
+// =============================================================================
+// RE-EXPORTS
+// =============================================================================
+export { 
+// Registry
+ToolRegistry, defineTool, 
+// File tools
+readFileTool, writeFileTool, editFileTool, listFilesTool, 
+// Bash tools
+bashTool, grepTool, globTool, };
+// =============================================================================
+// SCHEMA CONVERSION
+// =============================================================================
+/**
+ * ═══════════════════════════════════════════════════════════════════════════
+ * Converting Tool Schemas: Anthropic vs OpenAI Format
+ * ═══════════════════════════════════════════════════════════════════════════
+ *
+ * Anthropic format (what Lesson 3 uses):
+ *   { name, description, input_schema: { type: 'object', properties, required } }
+ *
+ * OpenAI/OpenRouter format (what native tool use needs):
+ *   { type: 'function', function: { name, description, parameters: {...} } }
+ *
+ * The actual schema structure is similar - it's just wrapped differently.
+ * This conversion enables native tool calling instead of JSON text parsing.
+ * ═══════════════════════════════════════════════════════════════════════════
+ */
+/**
+ * Convert a single ToolDescription to OpenRouter format.
+ */
+export function toOpenRouterSchema(tool) {
+    return {
+        type: 'function',
+        function: {
+            name: tool.name,
+            description: tool.description,
+            // Type assertion needed because JSONSchema is a stricter type
+            parameters: tool.input_schema,
+        },
+    };
+}
+/**
+ * Convert multiple tool descriptions to OpenRouter format.
+ */
+export function toOpenRouterSchemas(tools) {
+    return tools.map(toOpenRouterSchema);
+}
+// =============================================================================
+// PRESET REGISTRY
+// =============================================================================
+/**
+ * Create a pre-configured tool registry with all standard tools.
+ *
+ * @param permissionMode - How to handle dangerous operations
+ * @returns Configured ToolRegistry with all tools registered
+ *
+ * @example
+ * ```typescript
+ * const registry = createStandardRegistry('interactive');
+ * const result = await registry.execute('read_file', { path: 'README.md' });
+ * ```
+ */
+export function createStandardRegistry(permissionMode = 'interactive') {
+    const registry = new ToolRegistry(permissionMode);
+    // File operations
+    registry.register(readFileTool);
+    registry.register(writeFileTool);
+    registry.register(editFileTool);
+    registry.register(listFilesTool);
+    // Bash operations
+    registry.register(bashTool);
+    registry.register(grepTool);
+    registry.register(globTool);
+    return registry;
+}
+/**
+ * Get OpenRouter-compatible tool schemas for all standard tools.
+ */
+export function getStandardToolSchemas() {
+    const registry = createStandardRegistry('yolo'); // Mode doesn't matter for schemas
+    return toOpenRouterSchemas(registry.getDescriptions());
+}
+// =============================================================================
+// TOOL SUMMARY (for documentation/logging)
+// =============================================================================
+/**
+ * Get a human-readable summary of available tools.
+ */
+export function getToolsSummary() {
+    const tools = [
+        { name: 'read_file', desc: 'Read file contents', safe: true },
+        { name: 'write_file', desc: 'Create/overwrite files', safe: false },
+        { name: 'edit_file', desc: 'Make surgical edits (find & replace)', safe: false },
+        { name: 'list_files', desc: 'List directory contents', safe: true },
+        { name: 'bash', desc: 'Execute shell commands', safe: false },
+        { name: 'grep', desc: 'Search for patterns in files', safe: true },
+        { name: 'glob', desc: 'Find files by pattern', safe: true },
+    ];
+    return tools
+        .map(t => `  • ${t.name}: ${t.desc}${t.safe ? '' : ' ⚠️'}`)
+        .join('\n');
+}
+//# sourceMappingURL=standard.js.map

package/dist/src/tools/standard.js.map

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

package/dist/src/tools/types.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Lesson 3: Tool System Types
+ *
+ * Type definitions for the tool registry and permission system.
+ */
+import { z } from 'zod';
+/**
+ * Schema for a tool parameter.
+ * Uses Zod for runtime validation.
+ */
+export type ParameterSchema = z.ZodTypeAny;
+/**
+ * Tool definition that includes schema and metadata.
+ */
+export interface ToolDefinition<TInput extends z.ZodTypeAny = z.ZodTypeAny> {
+    /** Unique identifier */
+    name: string;
+    /** Human-readable description (shown to LLM) */
+    description: string;
+    /** Input parameter schema */
+    parameters: TInput;
+    /** Danger level for permission checking */
+    dangerLevel: DangerLevel;
+    /** Execute the tool */
+    execute: (input: z.infer<TInput>) => Promise<ToolResult>;
+}
+/**
+ * Result of tool execution.
+ */
+export interface ToolResult {
+    success: boolean;
+    output: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Danger levels for tools and operations.
+ */
+export type DangerLevel = 'safe' | 'moderate' | 'dangerous' | 'critical';
+/**
+ * Permission modes.
+ */
+export type PermissionMode = 'strict' | 'interactive' | 'auto-safe' | 'yolo';
+/**
+ * Request for permission to perform an operation.
+ */
+export interface PermissionRequest {
+    tool: string;
+    operation: string;
+    target: string;
+    dangerLevel: DangerLevel;
+    context?: string;
+}
+/**
+ * Response to a permission request.
+ */
+export interface PermissionResponse {
+    granted: boolean;
+    reason?: string;
+    remember?: boolean;
+}
+/**
+ * Interface for permission checkers.
+ */
+export interface PermissionChecker {
+    check(request: PermissionRequest): Promise<PermissionResponse>;
+}
+/**
+ * JSON Schema representation for LLM tool descriptions.
+ */
+export interface JSONSchema {
+    type: 'object';
+    properties: Record<string, JSONSchemaProperty>;
+    required?: string[];
+}
+export interface JSONSchemaProperty {
+    type: string;
+    description?: string;
+    enum?: string[];
+    items?: JSONSchemaProperty;
+    properties?: Record<string, JSONSchemaProperty>;
+}
+/**
+ * Tool description in format suitable for LLM APIs.
+ */
+export interface ToolDescription {
+    name: string;
+    description: string;
+    input_schema: JSONSchema;
+}
+/**
+ * Options for tool execution.
+ */
+export interface ExecuteOptions {
+    /** Permission mode to use */
+    permissionMode?: PermissionMode;
+    /** Working directory for file operations */
+    cwd?: string;
+    /** Timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Events emitted during tool execution.
+ */
+export type ToolEvent = {
+    type: 'start';
+    tool: string;
+    input: unknown;
+} | {
+    type: 'permission_requested';
+    request: PermissionRequest;
+} | {
+    type: 'permission_granted';
+    request: PermissionRequest;
+} | {
+    type: 'permission_denied';
+    request: PermissionRequest;
+    reason: string;
+} | {
+    type: 'executing';
+    tool: string;
+} | {
+    type: 'complete';
+    tool: string;
+    result: ToolResult;
+} | {
+    type: 'error';
+    tool: string;
+    error: Error;
+};
+/**
+ * Listener for tool events.
+ */
+export type ToolEventListener = (event: ToolEvent) => void;
+/**
+ * Patterns that indicate dangerous operations.
+ */
+export interface DangerPattern {
+    pattern: RegExp;
+    level: DangerLevel;
+    description: string;
+}
+/**
+ * Default dangerous patterns for bash commands.
+ */
+export declare const DANGEROUS_PATTERNS: DangerPattern[];
+//# sourceMappingURL=types.d.ts.map

package/dist/src/tools/types.d.ts.map

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

package/dist/src/tools/types.js

@@ -0,0 +1,28 @@
+/**
+ * Lesson 3: Tool System Types
+ *
+ * Type definitions for the tool registry and permission system.
+ */
+/**
+ * Default dangerous patterns for bash commands.
+ */
+export const DANGEROUS_PATTERNS = [
+    // Critical - system operations
+    { pattern: /\bsudo\b/, level: 'critical', description: 'Superuser command' },
+    { pattern: /\bsu\b/, level: 'critical', description: 'Switch user' },
+    { pattern: /\bchmod\s+[0-7]*7/, level: 'critical', description: 'World-writable permission' },
+    { pattern: /\bchown\b/, level: 'critical', description: 'Change ownership' },
+    // Dangerous - destructive operations
+    { pattern: /\brm\s+(-[rf]+\s+)*\//, level: 'dangerous', description: 'Remove from root' },
+    { pattern: /\brm\s+-rf\b/, level: 'dangerous', description: 'Recursive force delete' },
+    { pattern: />\s*\/dev\/(?!null)/, level: 'dangerous', description: 'Write to device (excludes /dev/null)' },
+    { pattern: /\bdd\b.*if=/, level: 'dangerous', description: 'Low-level disk operation' },
+    { pattern: /\bmkfs\b/, level: 'dangerous', description: 'Format filesystem' },
+    { pattern: /\bkill\s+-9\b/, level: 'dangerous', description: 'Force kill process' },
+    // Moderate - network and potentially harmful
+    { pattern: /\bcurl\b.*\|\s*(ba)?sh/, level: 'dangerous', description: 'Pipe URL to shell' },
+    { pattern: /\bwget\b.*\|\s*(ba)?sh/, level: 'dangerous', description: 'Pipe URL to shell' },
+    { pattern: /\bnpm\s+install\s+-g\b/, level: 'moderate', description: 'Global npm install' },
+    { pattern: /\bpip\s+install\b/, level: 'moderate', description: 'Python package install' },
+];
+//# sourceMappingURL=types.js.map

package/dist/src/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0KH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAoB;IACjD,+BAA+B;IAC/B,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,mBAAmB,EAAE;IAC5E,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE;IACpE,EAAE,OAAO,EAAE,mBAAmB,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,2BAA2B,EAAE;IAC7F,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAE;IAE5E,qCAAqC;IACrC,EAAE,OAAO,EAAE,uBAAuB,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,kBAAkB,EAAE;IACzF,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,wBAAwB,EAAE;IACtF,EAAE,OAAO,EAAE,qBAAqB,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,sCAAsC,EAAE;IAC3G,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,0BAA0B,EAAE;IACvF,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,mBAAmB,EAAE;IAC7E,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,oBAAoB,EAAE;IAEnF,6CAA6C;IAC7C,EAAE,OAAO,EAAE,wBAAwB,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,mBAAmB,EAAE;IAC3F,EAAE,OAAO,EAAE,wBAAwB,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,mBAAmB,EAAE;IAC3F,EAAE,OAAO,EAAE,wBAAwB,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,oBAAoB,EAAE;IAC3F,EAAE,OAAO,EAAE,mBAAmB,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,wBAAwB,EAAE;CAC3F,CAAC"}

package/dist/src/tools/undo.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Undo Tools
+ *
+ * Tools for undoing file changes and viewing file history.
+ * These tools use the FileChangeTracker to provide undo capability
+ * for file operations within an agent session.
+ *
+ * @example
+ * ```typescript
+ * import { undoTools } from './tools/undo.js';
+ *
+ * // Register undo tools with agent
+ * for (const tool of undoTools) {
+ *   registry.register(tool);
+ * }
+ * ```
+ */
+import { z } from 'zod';
+import type { ToolDefinition, ToolResult, DangerLevel } from './types.js';
+import type { FileChangeTracker } from '../integrations/file-change-tracker.js';
+/**
+ * Context passed to tool execution that provides access to agent features.
+ */
+export interface ToolExecutionContext {
+    /** Reference to the agent (if available) */
+    agent?: {
+        getFileChangeTracker?: () => FileChangeTracker | null;
+    };
+}
+/**
+ * Extended tool definition that accepts execution context.
+ */
+export interface ContextAwareToolDefinition<TInput extends z.ZodTypeAny = z.ZodTypeAny> {
+    /** Unique identifier */
+    name: string;
+    /** Human-readable description (shown to LLM) */
+    description: string;
+    /** Input parameter schema */
+    parameters: TInput;
+    /** Danger level for permission checking */
+    dangerLevel: DangerLevel;
+    /** Execute the tool with context */
+    execute: (input: z.infer<TInput>, context?: ToolExecutionContext) => Promise<ToolResult>;
+}
+/**
+ * Tool to undo the last change to a specific file.
+ */
+export declare const undoFileChangeTool: ContextAwareToolDefinition;
+/**
+ * Tool to show change history for a file.
+ */
+export declare const showFileHistoryTool: ContextAwareToolDefinition;
+/**
+ * Tool to show session change summary.
+ */
+export declare const showSessionChangesTool: ContextAwareToolDefinition;
+/**
+ * All undo-related tools.
+ *
+ * These tools require the agent to pass a ToolExecutionContext
+ * that provides access to the FileChangeTracker via
+ * context.agent.getFileChangeTracker().
+ */
+export declare const undoTools: ContextAwareToolDefinition[];
+/**
+ * Cast undo tools to standard ToolDefinition format.
+ * Use this when registering with a registry that doesn't support context.
+ * Note: The tools will return "tracking not enabled" if context is not passed.
+ */
+export declare const undoToolsAsStandard: ToolDefinition[];
+//# sourceMappingURL=undo.d.ts.map

package/dist/src/tools/undo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"undo.d.ts","sourceRoot":"","sources":["../../../src/tools/undo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAMhF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,4CAA4C;IAC5C,KAAK,CAAC,EAAE;QACN,oBAAoB,CAAC,EAAE,MAAM,iBAAiB,GAAG,IAAI,CAAC;KACvD,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B,CAAC,MAAM,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU;IACpF,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,WAAW,EAAE,WAAW,CAAC;IACzB,oCAAoC;IACpC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,oBAAoB,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CAC1F;AAMD;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,0BAmBhC,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,0BA0BjC,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,0BAyBpC,CAAC;AAMF;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,EAAE,0BAA0B,EAIjD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,cAAc,EAA6C,CAAC"}

package/dist/src/tools/undo.js

@@ -0,0 +1,123 @@
+/**
+ * Undo Tools
+ *
+ * Tools for undoing file changes and viewing file history.
+ * These tools use the FileChangeTracker to provide undo capability
+ * for file operations within an agent session.
+ *
+ * @example
+ * ```typescript
+ * import { undoTools } from './tools/undo.js';
+ *
+ * // Register undo tools with agent
+ * for (const tool of undoTools) {
+ *   registry.register(tool);
+ * }
+ * ```
+ */
+import { z } from 'zod';
+// =============================================================================
+// UNDO FILE CHANGE TOOL
+// =============================================================================
+/**
+ * Tool to undo the last change to a specific file.
+ */
+export const undoFileChangeTool = {
+    name: 'undo_file_change',
+    description: 'Undo the last change to a specific file, restoring its previous content',
+    parameters: z.object({
+        path: z.string().describe('The file path to undo changes for'),
+    }),
+    dangerLevel: 'moderate',
+    execute: async (args, context) => {
+        const tracker = context?.agent?.getFileChangeTracker?.();
+        if (!tracker) {
+            return { success: false, output: 'File change tracking is not enabled' };
+        }
+        const result = await tracker.undoLastChange(args.path);
+        return {
+            success: result.success,
+            output: result.message,
+        };
+    },
+};
+// =============================================================================
+// SHOW FILE HISTORY TOOL
+// =============================================================================
+/**
+ * Tool to show change history for a file.
+ */
+export const showFileHistoryTool = {
+    name: 'show_file_history',
+    description: 'Show the change history for a file in this session',
+    parameters: z.object({
+        path: z.string().describe('The file path to show history for'),
+    }),
+    dangerLevel: 'safe',
+    execute: async (args, context) => {
+        const tracker = context?.agent?.getFileChangeTracker?.();
+        if (!tracker) {
+            return { success: false, output: 'File change tracking is not enabled' };
+        }
+        const history = tracker.getFileHistory(args.path);
+        if (history.length === 0) {
+            return { success: true, output: `No changes recorded for ${args.path}` };
+        }
+        const formatted = history.map((change, i) => `${i + 1}. [${change.operation}] Turn ${change.turnNumber} - ${change.createdAt}` +
+            `\n   Before: ${change.bytesBefore} bytes, After: ${change.bytesAfter} bytes` +
+            (change.isUndone ? ' (UNDONE)' : '')).join('\n');
+        return { success: true, output: `File history for ${args.path}:\n${formatted}` };
+    },
+};
+// =============================================================================
+// SHOW SESSION CHANGES TOOL
+// =============================================================================
+/**
+ * Tool to show session change summary.
+ */
+export const showSessionChangesTool = {
+    name: 'show_session_changes',
+    description: 'Show a summary of all file changes in this session',
+    parameters: z.object({}),
+    dangerLevel: 'safe',
+    execute: async (_args, context) => {
+        const tracker = context?.agent?.getFileChangeTracker?.();
+        if (!tracker) {
+            return { success: false, output: 'File change tracking is not enabled' };
+        }
+        const summary = tracker.getSessionChangeSummary();
+        const output = [
+            `Session Change Summary:`,
+            `  Total changes: ${summary.totalChanges}`,
+            `  Files modified: ${summary.filesModified.length}`,
+            `  Creates: ${summary.byOperation.create}`,
+            `  Writes: ${summary.byOperation.write}`,
+            `  Edits: ${summary.byOperation.edit}`,
+            `  Deletes: ${summary.byOperation.delete}`,
+            `  Undone: ${summary.undoneChanges}`,
+        ].join('\n');
+        return { success: true, output };
+    },
+};
+// =============================================================================
+// EXPORTS
+// =============================================================================
+/**
+ * All undo-related tools.
+ *
+ * These tools require the agent to pass a ToolExecutionContext
+ * that provides access to the FileChangeTracker via
+ * context.agent.getFileChangeTracker().
+ */
+export const undoTools = [
+    undoFileChangeTool,
+    showFileHistoryTool,
+    showSessionChangesTool,
+];
+/**
+ * Cast undo tools to standard ToolDefinition format.
+ * Use this when registering with a registry that doesn't support context.
+ * Note: The tools will return "tracking not enabled" if context is not passed.
+ */
+export const undoToolsAsStandard = undoTools;
+//# sourceMappingURL=undo.js.map

package/dist/src/tools/undo.js.map

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