Enum UntrustedRefusal 

#[non_exhaustive]
pub enum UntrustedRefusal {
    NotAllowed {
        builtin: Option<BuiltinServer>,
    },
    WorkspaceExecutable {
        executable: PathBuf,
    },
    UnresolvedExecutable {
        command: ServerCommand,
    },
    AutoSelectionTarget {
        executable: ServerCommand,
        cause: InvalidAutoSelection,
    },
    WorkspaceHome {
        variable: HomeVariable,
        home: PathBuf,
    },
    EmptyHome {
        variable: HomeVariable,
    },
    UnknownHome,
    WorkspaceTsserver {
        tsserver: PathBuf,
    },
    ProjectLauncher {
        command: ServerCommand,
        cause: LauncherRefusal,
    },
    WorkspaceExecutableArgument {
        index: usize,
        executable: PathBuf,
    },
    UnreadableWorkspaceArgument {
        index: usize,
        path: PathBuf,
    },
    UnresolvedWrappedProgram {
        program: EchoedPath,
    },
    WrappedProgramPathContainsEquals {
        program: EchoedPath,
    },
    UnpinnedTypescriptLauncher {
        command: ServerCommand,
    },
    NonUtf8Path {
        what: ResolvedItem,
        path: PathBuf,
    },
    BlankResolvedPath {
        what: ResolvedItem,
    },
    NulInResolvedPath {
        what: ResolvedItem,
    },
    NoSafeWorkingDirectory,
    EnvTooLarge {
        error: EnvTooLarge,
    },
}

Why untrusted-workspace mode refused to start a server.

Examples

use mcpls_core::config::BuiltinServer;
use mcpls_core::error::UntrustedRefusal;

let refusal = UntrustedRefusal::NotAllowed {
    builtin: Some(BuiltinServer::RustAnalyzer),
};
assert!(refusal.to_string().contains("Cargo build scripts"));

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

NotAllowed

The server was not named with --allow-server.

Fields

builtin: Option<BuiltinServer>

The built-in server this is, whose workspace-code class is named in the message; None for a custom server.

WorkspaceExecutable

The server’s executable lies inside the workspace. Naming the server does not consent to running a binary the workspace supplies.

Fields

executable: PathBuf

The canonical path of the executable.

UnresolvedExecutable

The executable was not found on a search path outside the workspace, so untrusted mode cannot tell what would run.

Fields

command: ServerCommand

The configured command.

AutoSelectionTarget

The auto-selected TypeScript command resolved to an executable that is not typescript-language-server (a PATH entry symlinked to another program), so it cannot be hardened without dropping the tsserver pin.

Fields

executable: ServerCommand

The resolved executable the command would have been replaced with.

cause: InvalidAutoSelection

Why the selection cannot follow the resolved executable.

WorkspaceHome

The login home directory is unknown and the inherited HOME lies inside the workspace, where rustup, cargo and npm would read their configuration from.

Fields

variable: HomeVariable

The variable that names the home directory.

home: PathBuf

The path the server would inherit, inside the workspace.

EmptyHome

The login home directory is unknown and a home variable is empty, so tools resolve it against the working directory, which is the checkout.

Fields

variable: HomeVariable

The variable that is empty.

UnknownHome

The login home directory is unknown and HOME is not set, so tools would resolve ~ against the working directory, which is the checkout.

WorkspaceTsserver

The tsserver the TypeScript server would use lies inside the workspace.

Fields

tsserver: PathBuf

The canonical path of the tsserver.

ProjectLauncher

The configured command is a launcher that chooses the server from files in the workspace (a package runner, task runner or toolchain wrapper), so what would run is under the workspace’s control.

Fields

command: ServerCommand

The configured command.

cause: LauncherRefusal

What about the launch the analysis refused.

WorkspaceExecutableArgument

An argument of the configured command names an executable file inside the workspace, which whatever launcher precedes it would start.

Fields

index: usize

The position of the argument in the configured args.

executable: PathBuf

The canonical path of the executable.

UnreadableWorkspaceArgument

An argument of the configured command lies inside the workspace and cannot be read, so untrusted mode cannot tell whether it is an executable.

Fields

index: usize

The position of the argument in the configured args.

path: PathBuf

The path the argument names, lexically normalized.

UnresolvedWrappedProgram

A program an exec wrapper or env starts was not found on a search path outside the workspace, so untrusted mode cannot tell what would run.

Fields

program: EchoedPath

The wrapped program, as configured.

WrappedProgramPathContainsEquals

The vetted path of a program that env starts contains =, which env would read as an assignment, so it cannot be passed on unchanged.

Fields

program: EchoedPath

The wrapped program, as configured.

UnpinnedTypescriptLauncher

The configured command starts the TypeScript server through a launcher that untrusted mode cannot pin to a binary outside the workspace.

Fields

command: ServerCommand

The configured command.

NonUtf8Path

A resolved path is not valid UTF-8, so untrusted mode cannot pass it on unchanged.

Fields

what: ResolvedItem

What the path belongs to.

path: PathBuf

The path, as resolved.

BlankResolvedPath

A resolved path is blank, so there is nothing to start.

Fields

what: ResolvedItem

What the path belongs to.

NulInResolvedPath

A resolved path contains a NUL, which the operating system cannot pass in a path or environment variable.

Fields

what: ResolvedItem

What the path belongs to.

NoSafeWorkingDirectory

No directory outside the workspace is available for the server to start in.

EnvTooLarge

The variables untrusted mode sets for the server do not fit in its env table.

Fields

error: EnvTooLarge

Which limit the table would be over.

Trait Implementations

impl Clone for UntrustedRefusal

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for UntrustedRefusal

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

Formats the value using the given formatter.

impl Display for UntrustedRefusal

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

Formats the value using the given formatter.

impl Eq for UntrustedRefusal

impl PartialEq for UntrustedRefusal

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for UntrustedRefusal