Enum WinxError 

pub enum WinxError {
    ShellInitializationError(String),
    WorkspacePathError(String),
    BashStateLockError(String),
    BashStateNotInitialized,
    CommandExecutionError(String),
    NoActiveCommand(String),
    BackgroundSessionNotFound(String),
    EmptyInteractiveInput {
        action: String,
    },
    InteractiveTargetNotRunning(String),
    ArgumentParseError(String),
    FileAccessError {
        path: PathBuf,
        message: String,
    },
    FileNotFound {
        path: PathBuf,
    },
    FileReadRequired {
        path: PathBuf,
        reason: ReadRequirement,
        ranges: Vec<String>,
        message: String,
    },
    FileChangedAfterEdit {
        path: PathBuf,
        message: String,
    },
    UndoCheckpointNotFound {
        path: PathBuf,
    },
    UndoExpired {
        path: PathBuf,
        undo_id: String,
    },
    UndoOutOfOrder {
        path: PathBuf,
        undo_id: String,
        latest_undo_id: String,
    },
    FileOperationDenied {
        path: PathBuf,
        message: String,
    },
    ConcurrentFileModification {
        path: PathBuf,
        attempts: usize,
    },
    FileRevisionMismatch {
        path: PathBuf,
        expected: String,
        actual: String,
    },
    PathSecurityError {
        path: PathBuf,
        message: String,
    },
    TemporaryArtifactPolicy {
        path: PathBuf,
        temporary_artifact_dir: PathBuf,
        message: String,
    },
    TemporaryArtifactBudgetExceeded {
        temporary_artifact_dir: PathBuf,
        total_bytes: u64,
        max_total_bytes: u64,
        session_bytes: u64,
        max_session_bytes: u64,
        session_files: usize,
        max_session_files: usize,
        largest_file_bytes: u64,
        max_file_bytes: u64,
    },
    InvalidWaitPolicyForAction {
        wait_policy: String,
        action: String,
    },
    DerivedCodeMapBudget {
        path: PathBuf,
        temporary_artifact_dir: PathBuf,
        calls_used: usize,
        calls_limit: usize,
        unique_files_used: usize,
        unique_files_limit: usize,
        message: String,
    },
    CommandNotAllowed(String),
    ThreadIdMismatch(String),
    WorkspaceBindingRequired {
        thread_id: String,
    },
    WorkspaceThreadMismatch {
        thread_id: String,
        workspace_root: PathBuf,
    },
    WorkspaceBindingMismatch {
        thread_id: String,
        requested_workspace: PathBuf,
        bound_workspace: PathBuf,
    },
    WorkspaceChangeRequiresNewSession {
        workspace_root: PathBuf,
    },
    DeserializationError(String),
    SerializationError(String),
    SearchReplaceSyntaxError(String),
    SearchBlockNotFound(String),
    SearchBlockAmbiguous {
        block_content: String,
        match_count: usize,
        suggestions: Vec<String>,
    },
    MultiFilePlanError {
        index: usize,
        path: PathBuf,
        source: Box<WinxError>,
    },
    EditContextError {
        path: PathBuf,
        source: Box<WinxError>,
    },
    IndexedEditError {
        index: usize,
        path: PathBuf,
        mode: String,
        source: Box<WinxError>,
    },
    SearchReplaceSyntaxErrorDetailed {
        message: String,
        line_number: Option<usize>,
        block_type: Option<String>,
        suggestions: Vec<String>,
    },
    JsonParseError(String),
    FileTooLarge {
        path: PathBuf,
        size: u64,
        max_size: u64,
    },
    FileWriteError {
        path: PathBuf,
        message: String,
    },
    DataLoadingError(String),
    ParameterValidationError {
        field: String,
        message: String,
    },
    MissingParameterError {
        field: String,
        message: String,
    },
    NullValueError {
        field: String,
    },
    RecoverableSuggestionError {
        message: String,
        suggestion: String,
    },
    ContextSaveError(String),
    CommandTimeout {
        command: String,
        timeout_seconds: u64,
    },
    InteractiveCommandDetected {
        command: String,
    },
    CommandAlreadyRunning {
        current_command: String,
        duration_seconds: f64,
    },
    ProcessCleanupError {
        message: String,
    },
    BufferOverflow {
        size: usize,
        max_size: usize,
    },
    SessionRecoveryError {
        message: String,
    },
    ResourceAllocationError {
        message: String,
    },
    IoError(Error),
    ConfigurationError(String),
    ParseError(String),
    InvalidInput(String),
    FileError(String),
}

Errors that can occur in the Winx application

Variants

ShellInitializationError(String)

Error when initializing the shell

WorkspacePathError(String)

Error when operating on a workspace path

BashStateLockError(String)

Error when locking the bash state

BashStateNotInitialized

Error when the bash state is not initialized

CommandExecutionError(String)

Error when a command fails for an internal execution reason.

NoActiveCommand(String)

A status/input action targeted a shell with no running command.

BackgroundSessionNotFound(String)

A background command identifier is unknown or has already exited.

EmptyInteractiveInput

An interactive input action was supplied without any payload.

Fields

action: String

InteractiveTargetNotRunning(String)

Interactive bytes were sent to an idle shell instead of a running program.

ArgumentParseError(String)

Error when parsing arguments

FileAccessError

Error when trying to access a file or directory

Fields

path: PathBuf

message: String

FileNotFound

A requested path does not exist.

Fields

path: PathBuf

FileReadRequired

The edit guard requires a fresh or broader read before mutation.

Fields

path: PathBuf

reason: ReadRequirement

ranges: Vec<String>

message: String

FileChangedAfterEdit

An undo/edit postcondition no longer matches the on-disk file.

Fields

path: PathBuf

message: String

UndoCheckpointNotFound

No in-session undo checkpoint exists for the requested file.

Fields

path: PathBuf

UndoExpired

An opaque in-memory undo checkpoint was evicted or lost on restart.

Fields

path: PathBuf

undo_id: String

UndoOutOfOrder

A receipt-bound undo may only consume the newest checkpoint for a file.

Fields

path: PathBuf

undo_id: String

latest_undo_id: String

FileOperationDenied

A file operation was rejected by an explicit policy or OS permission.

Fields

path: PathBuf

message: String

ConcurrentFileModification

A live file changed repeatedly while Winx was taking a bounded snapshot.

Fields

path: PathBuf

attempts: usize

FileRevisionMismatch

A compare-and-swap edit targeted a different file revision.

Fields

path: PathBuf

expected: String

actual: String

PathSecurityError

Security error - path traversal or symlink escape attempt

Fields

path: PathBuf

message: String

TemporaryArtifactPolicy

A model-owned helper violated the managed .winx/tmp/<session> contract.

Fields

path: PathBuf

temporary_artifact_dir: PathBuf

message: String

TemporaryArtifactBudgetExceeded

Bash created dynamic helpers that could not be projected safely before execution and the active managed session is now over budget.

Fields

temporary_artifact_dir: PathBuf

total_bytes: u64

max_total_bytes: u64

session_bytes: u64

max_session_bytes: u64

session_files: usize

max_session_files: usize

largest_file_bytes: u64

max_file_bytes: u64

InvalidWaitPolicyForAction

A valid delivery policy was paired with an action it cannot represent.

Fields

wait_policy: String

action: String

DerivedCodeMapBudget

Syntax navigation over derived helpers exceeded its bounded session budget.

Fields

path: PathBuf

temporary_artifact_dir: PathBuf

calls_used: usize

calls_limit: usize

unique_files_used: usize

unique_files_limit: usize

message: String

CommandNotAllowed(String)

Error when a command is not allowed in the current mode

ThreadIdMismatch(String)

Error when chat IDs don’t match

WorkspaceBindingRequired

A remote stateful call omitted the explicit workspace half of its session binding.

Fields

thread_id: String

WorkspaceThreadMismatch

The supplied workspace and thread cannot belong to the same affinity key, so executing the request could select another project’s shell.

Fields

thread_id: String

workspace_root: PathBuf

WorkspaceBindingMismatch

The requested binding disagrees with the workspace stored in the selected durable session.

Fields

thread_id: String

requested_workspace: PathBuf

bound_workspace: PathBuf

WorkspaceChangeRequiresNewSession

Remote sessions never change project identity in place. A new first call gives the target workspace its own coherent session binding.

Fields

workspace_root: PathBuf

DeserializationError(String)

Error when deserializing data

SerializationError(String)

Error when serializing data

SearchReplaceSyntaxError(String)

Error in the search/replace format

SearchBlockNotFound(String)

Error when search block is not found in content

SearchBlockAmbiguous

Error when search block matches multiple locations (WCGW-style)

Fields

block_content: String

match_count: usize

suggestions: Vec<String>

MultiFilePlanError

Path-aware context for a planning failure in an atomic multi-file edit. The boxed source preserves the original recovery class instead of flattening it into an argument/string error.

Fields

index: usize

path: PathBuf

source: Box<WinxError>

EditContextError

Path context for a single-file edit without changing its historical display text. Recovery consumes the typed path instead of re-parsing the public request shape.

Fields

path: PathBuf

source: Box<WinxError>

IndexedEditError

Neutral path/index context for the unified batch planner. Legacy MultiFileEdit retains its historical error wording separately.

Fields

index: usize

path: PathBuf

mode: String

source: Box<WinxError>

SearchReplaceSyntaxErrorDetailed

Enhanced search/replace syntax error with detailed context

Fields

message: String

line_number: Option<usize>

block_type: Option<String>

suggestions: Vec<String>

JsonParseError(String)

Error when JSON parsing fails

FileTooLarge

Error when a file is too large for operation

Fields

path: PathBuf

size: u64

max_size: u64

FileWriteError

Error when writing to a file

Fields

path: PathBuf

message: String

DataLoadingError(String)

Error loading data

ParameterValidationError

Parameter validation error

Fields

field: String

message: String

MissingParameterError

Required parameter missing error

Fields

field: String

message: String

NullValueError

Null or undefined value error

Fields

field: String

RecoverableSuggestionError

Recovery suggestion error with potential solutions

Fields

message: String

suggestion: String

ContextSaveError(String)

Context save error

CommandTimeout

Command timeout error

Fields

command: String

timeout_seconds: u64

InteractiveCommandDetected

Interactive command detected error

Fields

command: String

CommandAlreadyRunning

Command already running error

Fields

current_command: String

duration_seconds: f64

ProcessCleanupError

Process cleanup error

Fields

message: String

BufferOverflow

Buffer overflow error

Fields

size: usize

max_size: usize

SessionRecoveryError

Session recovery error

Fields

message: String

ResourceAllocationError

Resource allocation error

Fields

message: String

IoError(Error)

IO error

ConfigurationError(String)

Configuration error

ParseError(String)

Parse error for responses

InvalidInput(String)

Invalid input error

FileError(String)

File error for file operations

Trait Implementations

impl Debug for WinxError

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

Formats the value using the given formatter.

impl Display for WinxError

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

Formats the value using the given formatter.

impl Error for WinxError

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.

impl From<Error> for WinxError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for WinxError

Conversion from anyhow::Error to WinxError

fn from(error: Error) -> Self

Converts to this type from the input type.