xibecode 1.0.3 → 1.0.7

package/dist/core/tools.d.ts

@@ -1,462 +0,0 @@
-import type { Tool } from '@anthropic-ai/sdk/resources/messages';
-import { AgentMode } from './modes.js';
-import { PluginManager } from './plugins.js';
-import { MCPClientManager } from './mcp-client.js';
-import { NeuralMemory } from './memory.js';
-import { SkillManager } from './skills.js';
-import { PermissionManager, type PermissionMode } from './permissions.js';
-declare function compactCommandOutput(value: string, maxChars: number): {
-    output: string;
-    truncated: boolean;
-    originalLength: number;
-};
-/** Returned by former Playwright-backed browser tools; XibeCode does not bundle browsers. */
-export declare const NO_EMBEDDED_BROWSER_MESSAGE = "XibeCode does not bundle Playwright, Chromium, or agent-browser. Install agent-browser globally on supported OS/arch if you want it, or use your environment browser MCP / fetch_url. For Playwright E2E in a repo, add @playwright/test there and run it via run_command.";
-/**
- * Interface for tool executors
- *
- * @category Tool Execution
- * @since 0.1.0
- */
-export interface ToolExecutor {
-    /**
-     * Execute a tool with given input
-     *
-     * @param toolName - Name of the tool to execute
-     * @param input - Tool input parameters
-     * @returns Tool execution result
-     */
-    execute(toolName: string, input: any): Promise<any>;
-    /**
-     * Get all available tools
-     *
-     * @returns Array of tool definitions
-     */
-    getTools(): Tool[];
-}
-export declare const __testing: {
-    compactCommandOutput: typeof compactCommandOutput;
-};
-/**
- * Main tool executor for XibeCode agent
- *
- * Provides 95+ tools across 8 categories for autonomous coding operations:
- * - File Operations: read, write, edit, delete files
- * - Git Operations: status, diff, commit, reset
- * - Shell Commands: run commands, interactive shell
- * - Web Operations: search, fetch URLs, HTTP requests
- * - Context Operations: code search, file finding, context discovery
- * - Test Operations: run tests, get results
- * - Memory Operations: update neural memory
- * - Browser guidance: use run_command + agent-browser (no bundled browser)
- *
- * Features:
- * - Mode-based tool permissions
- * - Safety checking for dangerous operations
- * - Plugin support for custom tools
- * - MCP integration for external tools
- * - Dry-run mode for safe previews
- * - Backup system for file operations
- *
- * @example
- * ```typescript
- * const executor = new CodingToolExecutor('/project', {
- *   dryRun: false,
- *   pluginManager,
- *   memory
- * });
- *
- * executor.setMode('agent');
- *
- * // Read a file
- * const result = await executor.execute('read_file', { path: 'src/app.ts' });
- *
- * // Edit a file
- * await executor.execute('edit_file', {
- *   path: 'src/app.ts',
- *   search: 'old code',
- *   replace: 'new code'
- * });
- * ```
- *
- * @category Tool Execution
- * @since 0.1.0
- */
-export declare class CodingToolExecutor implements ToolExecutor {
-    private workingDir;
-    private contextManager;
-    private fileEditor;
-    private gitUtils;
-    private testRunner;
-    private safetyChecker;
-    private pluginManager;
-    private mcpClientManager?;
-    private memory?;
-    private skillManager;
-    private patternMiner;
-    private backgroundAgent;
-    private codeGraph;
-    private conflictSolver;
-    private swarmOrchestrator;
-    private platform;
-    private dryRun;
-    private testCommandOverride?;
-    private permissionManager;
-    /** Session-scoped tools synthesized by the agent (meta-agent). Execution is sandboxed via run_command. */
-    private dynamicTools;
-    private mcpOAuth;
-    /**
-     * Creates a new CodingToolExecutor instance
-     *
-     * Initializes all tool subsystems including file operations, git utilities,
-     * test runner, safety checker, plugin manager, and optional MCP integration.
-     *
-     * @example
-     * ```typescript
-     * // Basic usage
-     * const executor = new CodingToolExecutor('/project');
-     *
-     * // With options
-     * const executor = new CodingToolExecutor('/project', {
-     *   dryRun: true,
-     *   pluginManager: new PluginManager(),
-     *   memory: new NeuralMemory('./.xibecode/memory.json')
-     * });
-     * ```
-     *
-     * @param workingDir - Working directory for file operations (default: process.cwd())
-     * @param options - Configuration options
-     * @param options.dryRun - Enable dry-run mode (preview changes without executing)
-     * @param options.testCommandOverride - Override test command detection
-     * @param options.pluginManager - Plugin manager instance for custom tools
-     * @param options.mcpClientManager - MCP client manager for external tool integration
-     * @param options.memory - Neural memory instance for persistent learning
-     * @param options.skillManager - Skill manager for loading custom workflows
-     *
-     * @category Constructor
-     * @since 0.1.0
-     */
-    constructor(workingDir?: string, options?: {
-        dryRun?: boolean;
-        testCommandOverride?: string;
-        pluginManager?: PluginManager;
-        mcpClientManager?: MCPClientManager;
-        memory?: NeuralMemory;
-        skillManager?: SkillManager;
-        permissionManager?: PermissionManager;
-    });
-    private currentMode;
-    /**
-     * Set the current agent mode
-     *
-     * Changes the tool executor's operating mode, which affects:
-     * - Tool permissions (what tools are available)
-     * - Dry-run default (some modes preview changes by default)
-     * - Risk tolerance for operations
-     *
-     * @example
-     * ```typescript
-     * executor.setMode('plan');      // Read-only mode
-     * executor.setMode('agent');     // Full capabilities
-     * executor.setMode('security');  // Security-focused mode
-     * ```
-     *
-     * @param mode - Agent mode to switch to
-     *
-     * @category Mode Management
-     * @since 0.1.0
-     */
-    setMode(mode: AgentMode): void;
-    setPermissionMode(permissionMode: PermissionMode): void;
-    getPermissionContext(): import("./permissions.js").ToolPermissionContext;
-    /**
-     * Safely parse tool input - handles string JSON, null, undefined
-     *
-     * @param input - Raw tool input (string, object, null, or undefined)
-     * @returns Parsed input as object
-     *
-     * @internal
-     */
-    private parseInput;
-    private resolveToolCategory;
-    /**
-     * Execute a tool with given input
-     *
-     * Main tool execution pipeline that:
-     * 1. Checks tool permissions for current mode
-     * 2. Routes MCP tools to external servers
-     * 3. Routes plugin tools to plugin manager
-     * 4. Performs safety assessment for risky operations
-     * 5. Executes the tool implementation
-     * 6. Returns structured result
-     *
-     * @example
-     * ```typescript
-     * // Read a file
-     * const result = await executor.execute('read_file', {
-     *   path: 'src/app.ts'
-     * });
-     *
-     * if (result.success) {
-     *   console.log(result.content);
-     * }
-     *
-     * // Edit a file
-     * await executor.execute('edit_file', {
-     *   path: 'src/app.ts',
-     *   search: 'const old = 1;',
-     *   replace: 'const new = 2;'
-     * });
-     *
-     * // Run a command
-     * await executor.execute('run_command', {
-     *   command: 'npm test'
-     * });
-     * ```
-     *
-     * @param toolName - Name of the tool to execute (e.g., 'read_file', 'edit_file')
-     * @param input - Tool input parameters (varies by tool)
-     * @returns Tool execution result with success/error status
-     *
-     * @see {@link getTools} for list of available tools
-     * @category Tool Execution
-     * @since 0.1.0
-     */
-    execute(toolName: string, input: any): Promise<any>;
-    /**
-     * Get all available tools for the agent
-     *
-     * Returns an array of tool definitions including core tools, plugin tools,
-     * and MCP tools. Each tool includes:
-     * - name: Tool identifier
-     * - description: What the tool does (for Claude AI)
-     * - input_schema: JSON Schema for input validation
-     *
-     * Tools are grouped by category:
-     * - File Operations: read_file, write_file, edit_file, etc.
-     * - Git Operations: get_git_status, git_commit, etc.
-     * - Shell Commands: run_command, interactive_shell
-     * - Web Operations: web_search, fetch_url, http_request
-     * - Context Operations: grep_code, search_files, get_context
-     * - Test Operations: run_tests, get_test_status
-     * - Memory Operations: update_memory
-     * - Browser Operations: open_browser, browser_click, etc.
-     *
-     * @example
-     * ```typescript
-     * const tools = executor.getTools();
-     * console.log(`${tools.length} tools available`);
-     *
-     * // Find a specific tool
-     * const readFile = tools.find(t => t.name === 'read_file');
-     * console.log(readFile.description);
-     * ```
-     *
-     * @returns Array of tool definitions with schemas
-     *
-     * @category Tool Management
-     * @since 0.1.0
-     */
-    getTools(): Tool[];
-    /**
-     * Resolve relative file path to absolute path
-     *
-     * @param filePath - Relative or absolute file path
-     * @returns Absolute path resolved against working directory
-     *
-     * @internal
-     */
-    private resolvePath;
-    /**
-     * Read file contents
-     *
-     * Reads a file from the filesystem. Supports partial reading by line range
-     * to avoid token limits for large files. Always returns UTF-8 encoded text.
-     *
-     * @example
-     * ```typescript
-     * // Read entire file
-     * const result = await executor.execute('read_file', {
-     *   path: 'src/app.ts'
-     * });
-     *
-     * // Read specific line range
-     * const partial = await executor.execute('read_file', {
-     *   path: 'src/large-file.ts',
-     *   start_line: 100,
-     *   end_line: 200
-     * });
-     * ```
-     *
-     * @param filePath - Path to file (relative to working directory)
-     * @param startLine - Optional start line for partial read (1-indexed)
-     * @param endLine - Optional end line for partial read (inclusive)
-     * @returns Object with path, content, and line info
-     *
-     * @throws {FileNotFoundError} If file doesn't exist
-     * @throws {PermissionError} If file is not readable
-     *
-     * @category File Operations
-     * @mode All modes
-     * @since 0.1.0
-     */
-    private readFile;
-    private readMultipleFiles;
-    /**
-     * Write content to file
-     *
-     * Creates or overwrites a file with the given content. Automatically creates
-     * parent directories if they don't exist. Creates a backup before overwriting
-     * existing files.
-     *
-     * In dry-run mode, shows what would be written without making changes.
-     *
-     * @example
-     * ```typescript
-     * await executor.execute('write_file', {
-     *   path: 'src/new-file.ts',
-     *   content: 'export const hello = "world";'
-     * });
-     * ```
-     *
-     * @param filePath - Path to file (relative to working directory)
-     * @param content - File content to write
-     * @returns Object with success status, path, and file info
-     *
-     * @throws {PermissionError} If directory is not writable
-     *
-     * @category File Operations
-     * @mode Write modes (agent, engineer, architect)
-     * @since 0.1.0
-     */
-    private writeFile;
-    /**
-     * Edit file using search and replace
-     *
-     * Performs intelligent search-and-replace editing using the FileEditor's
-     * smart edit strategy. Searches for exact string matches and replaces them.
-     * Automatically handles multi-line strings and special characters.
-     *
-     * Creates a backup before editing. In dry-run mode, shows what would be
-     * changed without modifying the file.
-     *
-     * @example
-     * ```typescript
-     * // Replace first occurrence
-     * await executor.execute('edit_file', {
-     *   path: 'src/app.ts',
-     *   search: 'const oldValue = 1;',
-     *   replace: 'const newValue = 2;'
-     * });
-     *
-     * // Replace all occurrences
-     * await executor.execute('edit_file', {
-     *   path: 'src/app.ts',
-     *   search: 'oldName',
-     *   replace: 'newName',
-     *   all: true
-     * });
-     * ```
-     *
-     * @param filePath - Path to file (relative to working directory)
-     * @param search - Exact string to search for (can be multi-line)
-     * @param replace - Replacement string
-     * @param all - Replace all occurrences (default: false, replaces first only)
-     * @returns Object with success status, changes made, and diff
-     *
-     * @throws {FileNotFoundError} If file doesn't exist
-     * @throws {SearchNotFoundError} If search string not found
-     *
-     * @category File Operations
-     * @mode Write modes (agent, engineer, architect)
-     * @since 0.1.0
-     */
-    private editFile;
-    private editLines;
-    private verifiedEditFile;
-    private insertAtLine;
-    private listDirectory;
-    private searchFiles;
-    /**
-     * Execute a shell command
-     *
-     * Runs a command in a shell (bash on Unix, PowerShell on Windows).
-     * Captures stdout and stderr. Supports stdin input for interactive commands.
-     * Automatically times out after 120 seconds (configurable).
-     *
-     * Safety checks are performed before execution to block dangerous commands
-     * like `rm -rf /`, malicious scripts, and other high-risk operations.
-     *
-     * @example
-     * ```typescript
-     * // Run a simple command
-     * const result = await executor.execute('run_command', {
-     *   command: 'npm test'
-     * });
-     *
-     * // Run with specific working directory
-     * await executor.execute('run_command', {
-     *   command: 'ls -la',
-     *   cwd: './src'
-     * });
-     *
-     * // Run with stdin input
-     * await executor.execute('run_command', {
-     *   command: 'cat > output.txt',
-     *   input: 'Hello World'
-     * });
-     *
-     * // Run with custom timeout
-     * await executor.execute('run_command', {
-     *   command: 'npm install',
-     *   timeout: 300  // 5 minutes
-     * });
-     * ```
-     *
-     * @param command - Shell command to execute
-     * @param cwd - Working directory (default: executor's working directory)
-     * @param input - Optional stdin input for interactive commands
-     * @param timeout - Timeout in seconds (default: 120)
-     * @returns Object with stdout, stderr, exit code, and execution time
-     *
-     * @throws {SafetyError} If command is blocked by safety checker
-     * @throws {TimeoutError} If command exceeds timeout
-     *
-     * @category Shell Commands
-     * @mode Command modes (agent, engineer, debugger, tester)
-     * @risk-level High
-     * @since 0.1.0
-     */
-    private runDynamicTool;
-    private runCommand;
-    private createDirectory;
-    private deleteFile;
-    private moveFile;
-    private getContext;
-    private revertFile;
-    private lastTestResult;
-    private runTests;
-    private getTestStatus;
-    private testGenerator;
-    private getTestGenerator;
-    private generateTests;
-    private analyzeCodeForTests;
-    private getGitStatus;
-    private getGitDiffSummary;
-    private getGitChangedFiles;
-    private gitCommit;
-    private gitBlameAi;
-    private createGitCheckpoint;
-    private revertToGitCheckpoint;
-    private gitShowDiff;
-    private mcpAuth;
-    private getMCPStatus;
-    private searchSkillsSh;
-    private installSkillFromSkillsSh;
-    private grepCode;
-    private webSearch;
-    private fetchUrl;
-    private updateMemory;
-}
-export {};
-//# sourceMappingURL=tools.d.ts.map

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

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