vigthoria-cli 1.0.0

package/dist/utils/tools.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Vigthoria CLI Tools - Agentic Tool System
+ *
+ * This module provides Claude Code-like autonomous tool execution.
+ * Tools can be called by the AI to perform actions.
+ *
+ * Enhanced with:
+ * - Risk-based permission system
+ * - Automatic retry logic with exponential backoff
+ * - Undo functionality for file operations
+ * - Detailed error messages with suggestions
+ *
+ * @version 1.1.0
+ * @author Vigthoria Labs
+ */
+import { Logger } from './logger.js';
+export type RiskLevel = 'low' | 'medium' | 'high' | 'critical';
+export interface ToolResult {
+    success: boolean;
+    output?: string;
+    error?: string;
+    suggestion?: string;
+    canRetry?: boolean;
+    undoable?: boolean;
+    metadata?: {
+        [key: string]: any;
+    };
+}
+export interface ToolCall {
+    tool: string;
+    args: Record<string, string>;
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: {
+        name: string;
+        description: string;
+        required: boolean;
+    }[];
+    requiresPermission: boolean;
+    dangerous: boolean;
+    riskLevel: RiskLevel;
+    category: 'read' | 'write' | 'execute' | 'search';
+}
+interface UndoOperation {
+    id: string;
+    tool: string;
+    timestamp: number;
+    filePath?: string;
+    originalContent?: string | null;
+    description: string;
+}
+export declare enum ToolErrorType {
+    FILE_NOT_FOUND = "FILE_NOT_FOUND",
+    PERMISSION_DENIED = "PERMISSION_DENIED",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    TIMEOUT = "TIMEOUT",
+    INVALID_ARGS = "INVALID_ARGS",
+    EXECUTION_FAILED = "EXECUTION_FAILED",
+    USER_CANCELLED = "USER_CANCELLED"
+}
+export declare class AgenticTools {
+    private logger;
+    private cwd;
+    private permissionCallback;
+    private autoApprove;
+    private undoStack;
+    private maxUndoStack;
+    private retryConfig;
+    constructor(logger: Logger, cwd: string, permissionCallback: (action: string) => Promise<boolean>, autoApprove?: boolean);
+    /**
+     * Get the undo stack for inspection
+     */
+    getUndoStack(): UndoOperation[];
+    /**
+     * Undo the last file operation
+     */
+    undo(): Promise<ToolResult>;
+    /**
+     * List of available tools - similar to Claude Code
+     * Enhanced with risk levels and categories
+     */
+    static getToolDefinitions(): ToolDefinition[];
+    /**
+     * Execute a tool call with enhanced error handling and retry logic
+     */
+    execute(call: ToolCall): Promise<ToolResult>;
+    /**
+     * Execute tool with automatic retry for transient failures
+     */
+    private executeWithRetry;
+    /**
+     * Execute the actual tool operation
+     */
+    private executeTool;
+    /**
+     * Check if an error is retryable
+     */
+    private isRetryableError;
+    /**
+     * Validate tool parameters
+     */
+    private validateParameters;
+    /**
+     * Create a standardized error result
+     */
+    private createErrorResult;
+    /**
+     * Enhanced permission request with risk visualization
+     */
+    private formatPermissionRequest;
+    private sleep;
+    /**
+     * Read file with enhanced error handling and suggestions
+     */
+    private readFile;
+    /**
+     * Write file with undo support
+     */
+    private writeFile;
+    /**
+     * Edit file with undo support and helpful error messages
+     */
+    private editFile;
+    /**
+     * Execute bash command with enhanced error handling
+     */
+    private bash;
+    private grep;
+    private listDir;
+    private glob;
+    private git;
+    private resolvePath;
+    /**
+     * Parse tool calls from AI response (Claude Code format)
+     */
+    static parseToolCalls(text: string): ToolCall[];
+    /**
+     * Get tools formatted for AI system prompt
+     */
+    static getToolsForPrompt(): string;
+}
+export {};
+//# sourceMappingURL=tools.d.ts.map

package/dist/utils/tools.d.ts.map

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