vtcode-core 0.103.1

/// Centralized error messages for tool operations
///
/// This module provides consistent, reusable error messages across all tool implementations
/// to ensure uniformity in user-facing error reporting.
/// File operation error messages
pub mod file_ops {
    pub const FILE_NOT_FOUND: &str = "File not found";
    pub const FILE_NOT_ACCESSIBLE: &str = "File is not accessible from the workspace";
    pub const INVALID_PATH: &str = "Invalid file path";
    pub const PATH_TRAVERSAL_ATTEMPT: &str = "Path traversal outside workspace not allowed";
    pub const PERMISSION_DENIED: &str = "Permission denied";
    pub const IS_DIRECTORY: &str = "Path points to a directory, not a file";
    pub const FILE_TOO_LARGE: &str = "File is too large to read";
    pub const ENCODING_ERROR: &str = "Failed to decode file (invalid UTF-8)";
    pub const IO_ERROR: &str = "Input/output error";
    pub const DIRECTORY_NOT_FOUND: &str = "Directory not found";
}

/// Command execution error messages
pub mod command_ops {
    pub const COMMAND_NOT_FOUND: &str = "Command not found";
    pub const COMMAND_BLOCKED: &str = "Command is not allowed for security reasons";
    pub const INVALID_COMMAND: &str = "Invalid command format";
    pub const COMMAND_TIMEOUT: &str = "Command execution timed out";
    pub const COMMAND_FAILED: &str = "Command execution failed";
    pub const EMPTY_COMMAND: &str = "Command cannot be empty";
    pub const SESSION_NOT_FOUND: &str = "PTY session not found";
    pub const SESSION_ALREADY_EXISTS: &str = "PTY session already exists";
    pub const SESSION_CLOSED: &str = "PTY session is closed";
}

/// Network operation error messages
pub mod network_ops {
    pub const URL_BLOCKED: &str = "URL is blocked for security reasons";
    pub const URL_INVALID: &str = "Invalid URL format";
    pub const CONNECTION_FAILED: &str = "Failed to connect to URL";
    pub const TIMEOUT: &str = "Network request timed out";
    pub const HTTP_ERROR: &str = "HTTP error";
    pub const SSL_ERROR: &str = "SSL/TLS certificate verification failed";
}

/// Code execution error messages
pub mod code_ops {
    pub const INVALID_LANGUAGE: &str = "Unsupported programming language";
    pub const EXECUTION_FAILED: &str = "Code execution failed";
    pub const EXECUTION_TIMEOUT: &str = "Code execution timed out";
    pub const OUTPUT_TOO_LARGE: &str = "Output is too large to return";
    pub const RUNTIME_ERROR: &str = "Runtime error";
}

/// Validation error messages
pub mod validation {
    pub const REQUIRED_PARAMETER_MISSING: &str = "Required parameter is missing";
    pub const INVALID_PARAMETER_TYPE: &str = "Invalid parameter type";
    pub const INVALID_PARAMETER_VALUE: &str = "Invalid parameter value";
    pub const PARAMETER_OUT_OF_RANGE: &str = "Parameter value is out of allowed range";
}

/// Tool system error messages
pub mod tool_system {
    pub const TOOL_NOT_FOUND: &str = "Tool not found";
    pub const TOOL_NOT_AVAILABLE: &str = "Tool is not available in this context";
    pub const TOOL_EXECUTION_DENIED: &str = "Tool execution is denied by policy";
    pub const TOOL_EXECUTION_REQUIRES_CONFIRMATION: &str =
        "Tool execution requires user confirmation";
    pub const INTERNAL_ERROR: &str = "Internal tool system error";

    /// Get error message for a specific error type - returns static reference
    pub fn get_error_message(error_type: &str) -> &'static str {
        match error_type {
            "not_found" => TOOL_NOT_FOUND,
            "not_available" => TOOL_NOT_AVAILABLE,
            "execution_denied" => TOOL_EXECUTION_DENIED,
            "requires_confirmation" => TOOL_EXECUTION_REQUIRES_CONFIRMATION,
            "internal_error" => INTERNAL_ERROR,
            _ => INTERNAL_ERROR,
        }
    }
}

/// Shared execution guidance messages for agent/runloop/tool registry.
pub mod agent_execution {
    /// Marker used when plan mode blocks a mutating tool call.
    pub const PLAN_MODE_DENIED_CONTEXT: &str = "tool denied by plan mode";
    /// Prefix for loop detection failures.
    pub const LOOP_DETECTION_PREFIX: &str = "LOOP DETECTION";
    /// Canonical action-required line for loop detection blocks.
    pub const LOOP_RETRY_BLOCKED_LINE: &str = "ACTION REQUIRED: DO NOT retry this tool call. The tool execution has been prevented to avoid infinite loops.";

    /// Build the canonical plan-mode denial message.
    pub fn plan_mode_denial_message(tool_name: &str) -> String {
        format!(
            "Tool '{}' execution failed: tool denied by plan mode\n\n\
             ACTION REQUIRED: You are in Plan Mode (read-only). To start implementation:\n\
             1. Call `exit_plan_mode` tool to show the user your plan for approval\n\
             2. Wait for user to confirm (they will see the Implementation Blueprint)\n\
             3. After approval, mutating tools will be enabled\n\n\
             Fallback if automatic Plan->Edit switching keeps failing: manually switch using `/plan off` or `/mode` (or `Shift+Tab`/`Alt+M` in interactive mode).",
            tool_name
        )
    }

    /// Build the canonical loop-detection block message.
    pub fn loop_detection_block_message(
        tool_name: &str,
        repeat_count: u64,
        original_error: Option<&str>,
    ) -> String {
        let mut message = format!(
            "{}: Tool '{}' has been called {} times with identical parameters and is now blocked.\n\n\
             {}\n\n\
             If you need the result from this tool:\n\
             1. Check if you already have the result from a previous successful call in your conversation history\n\
             2. If not available, use a different approach or modify your request",
            LOOP_DETECTION_PREFIX, tool_name, repeat_count, LOOP_RETRY_BLOCKED_LINE
        );

        if let Some(error) = original_error {
            message.push_str("\n\nOriginal error: ");
            message.push_str(error);
        }

        message
    }

    /// Check whether an error string corresponds to plan mode denial.
    pub fn is_plan_mode_denial(error: &str) -> bool {
        error.contains(PLAN_MODE_DENIED_CONTEXT)
    }
}

/// Patch operation error messages
pub mod patch_ops {
    pub const PATCH_INVALID: &str = "Invalid patch format";
    pub const PATCH_CONFLICT: &str = "Patch application conflicts with file content";
    pub const PATCH_NO_MATCHES: &str = "Patch has no matching hunks in file";
    pub const PATCH_PARTIAL_APPLY: &str = "Patch applied with conflicts";
}

/// Skill management error messages
pub mod skill_ops {
    pub const SKILL_NOT_FOUND: &str = "Skill not found";
    pub const SKILL_ALREADY_EXISTS: &str = "Skill already exists";
    pub const INVALID_SKILL_FORMAT: &str = "Invalid skill format";
    pub const SKILL_SAVE_FAILED: &str = "Failed to save skill";
    pub const SKILL_LOAD_FAILED: &str = "Failed to load skill";
}

/// Diagnostic tool error messages
pub mod diagnostics {
    pub const NO_ERRORS_RECORDED: &str = "No errors recorded in session";
    pub const INVALID_SCOPE: &str = "Invalid error scope";
    pub const AGENT_STATE_UNAVAILABLE: &str = "Agent state is not available for inspection";
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_error_messages_are_not_empty() {
        assert!(!file_ops::FILE_NOT_FOUND.is_empty());
        assert!(!command_ops::COMMAND_NOT_FOUND.is_empty());
        assert!(!network_ops::URL_BLOCKED.is_empty());
        assert!(!code_ops::EXECUTION_FAILED.is_empty());
        assert!(!validation::REQUIRED_PARAMETER_MISSING.is_empty());
        assert!(!tool_system::TOOL_NOT_FOUND.is_empty());
        assert!(!agent_execution::PLAN_MODE_DENIED_CONTEXT.is_empty());
        assert!(!agent_execution::LOOP_RETRY_BLOCKED_LINE.is_empty());
        assert!(!patch_ops::PATCH_INVALID.is_empty());
        assert!(!skill_ops::SKILL_NOT_FOUND.is_empty());
        assert!(!diagnostics::NO_ERRORS_RECORDED.is_empty());
    }

    #[test]
    fn test_agent_execution_message_helpers() {
        let plan_mode_msg = agent_execution::plan_mode_denial_message("write_file");
        assert!(agent_execution::is_plan_mode_denial(&plan_mode_msg));
        assert!(plan_mode_msg.contains("exit_plan_mode"));
        assert!(plan_mode_msg.contains("/plan off"));
        assert!(plan_mode_msg.contains("/mode"));
        assert!(plan_mode_msg.contains("Shift+Tab"));
        assert!(!plan_mode_msg.contains("DO NOT retry this tool or use /plan off"));

        let loop_msg =
            agent_execution::loop_detection_block_message("read_file", 3, Some("base error"));
        assert!(loop_msg.contains("LOOP DETECTION"));
        assert!(loop_msg.contains("DO NOT retry"));
        assert!(loop_msg.contains("Original error: base error"));
    }
}