Enum PathfinderError 

pub enum PathfinderError {
    FileNotFound {
        path: PathBuf,
    },
    SymbolNotFound {
        semantic_path: String,
        did_you_mean: Vec<String>,
    },
    InvalidSemanticPath {
        input: String,
        issue: String,
    },
    AmbiguousSymbol {
        semantic_path: String,
        matches: Vec<String>,
    },
    NoLspAvailable {
        language: String,
    },
    LspError {
        message: String,
    },
    IoError {
        message: String,
    },
    LspTimeout {
        timeout_ms: u64,
    },
    AccessDenied {
        path: PathBuf,
        tier: SandboxTier,
    },
    ParseError {
        path: PathBuf,
        reason: String,
    },
    UnsupportedLanguage {
        path: PathBuf,
    },
    TokenBudgetExceeded {
        used: usize,
        budget: usize,
    },
    PathTraversal {
        path: PathBuf,
        workspace_root: PathBuf,
    },
}

A standardized error type for Pathfinder operations.

Variants

FileNotFound

File path doesn’t exist.

Fields

path: PathBuf

Path to the missing file.

SymbolNotFound

Semantic path doesn’t resolve.

Fields

semantic_path: String

The semantic path that wasn’t found.

did_you_mean: Vec<String>

Similar symbol names suggested by the system (Levenshtein distance).

InvalidSemanticPath

Semantic path is malformed or missing required ‘::’ separator.

Fields

input: String

The invalid input string.

issue: String

Description of what makes it invalid.

AmbiguousSymbol

Multiple matches for a semantic path.

Fields

semantic_path: String

The ambiguous semantic path.

matches: Vec<String>

All matching symbol paths.

NoLspAvailable

No language server available for this file type.

Fields

language: String

LspError

Language server crashed or returned an error.

Fields

message: String

IoError

A generic I/O error occurred.

Fields

message: String

LspTimeout

LSP didn’t respond within timeout.

Fields

timeout_ms: u64

AccessDenied

File is in the sandbox deny-list.

Fields

path: PathBuf

tier: SandboxTier

ParseError

Tree-sitter couldn’t parse the file.

Fields

path: PathBuf

reason: String

UnsupportedLanguage

The language of the semantic path’s file is not supported.

Fields

path: PathBuf

TokenBudgetExceeded

Response would exceed max_tokens.

Fields

used: usize

budget: usize

PathTraversal

Path traversal detected in resolve_strict.

Fields

path: PathBuf

workspace_root: PathBuf

Implementations

impl PathfinderError

pub const fn error_code(&self) -> &'static str

Returns the MCP-facing error code string.

pub fn hint(&self) -> Option<String>

Returns an actionable hint for the agent to self-correct without additional round-trips.

SYMBOL_NOT_FOUND hints are dynamic and built from the did_you_mean suggestions. All other hints are static strings referencing specific Pathfinder tools.

pub fn to_error_response(&self) -> ErrorResponse

Serialize to the standard MCP error JSON format.

Trait Implementations

impl Debug for PathfinderError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for PathfinderError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for PathfinderError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.