Enum SpawnGateError 

pub enum SpawnGateError {
    MissingCredentials {
        provider: String,
    },
    InjectionUnavailable {
        detail: String,
    },
    AmbientHomeDirNotAllowed {
        provider: String,
        dir: String,
    },
    ClaudeMdSeedFailed {
        provider: String,
        dir: String,
        error: String,
    },
    AgentDeleted {
        agent_id: String,
    },
}

Blocking spawn-gate error — layer 3 of SPEC_ACCOUNT_DELETE_DEAUTH_LAYERS_2_4_2026_07_14.md (§2.2).

Returned by the injection entry points when an oauth-class provider the agent is supposed to have credentials for (a binding exists, or the provider is the agent definition’s own CLI provider) has no resolvable account. There is no per-agent opt-out. The spawn callers surface Display verbatim in the agent pane (same error_during_execution frame other spawn failures use) — the wording is the spec’s.

Api-key-class bindings keep the historical log-and-skip behavior; this error exists only for the oauth class, where silent fallback meant the CLI would read the user’s global login (~/.claude) after an account was deleted.

Variants

MissingCredentials

The gate’s credentials verdict: no resolvable account.

Fields

provider: String

InjectionUnavailable

The injection task itself could not run to completion (task-join failure — e.g. a panic inside the blocking closure, which also poisons the Store mutex for every later call). The gate FAILS CLOSED on this: an open fallback would silently convert one panic anywhere in the store into a permanent, systemic bypass of the oauth gate (#2164). A blocked spawn is retryable and visible; a silent ambient launch is neither.

Fields

detail: String

AmbientHomeDirNotAllowed

The bound account’s SecretRef::OAuthConfigDir resolves to the provider’s own literal ambient home directory (e.g. ~/.claude) instead of an AgentMux-isolated dir. Blocked unconditionally — a real, currently-live account configured exactly this way was found in this repo’s own data (docs/status/STATUS_IDENTITY_ISOLATION_GATE_NOT_ENFORCING_2026_08_20.md §8); this variant is the enforcement that closes that gap. See docs/specs/SPEC_BLOCK_AMBIENT_HOME_DIR_IDENTITY_BINDING_2026_08_25.md.

Fields

provider: String

dir: String

ClaudeMdSeedFailed

Failed to seed the isolated Claude Code config dir’s CLAUDE.md placeholder (providers::seed_claude_md_placeholder_if_missing). Blocked rather than warn-and-continue: an isolated dir with no CLAUDE.md of its own is exactly the condition where Claude Code CLI falls through to the operator’s real ~/.claude/CLAUDE.md — continuing to spawn would launch the agent with the leak this fix exists to close. See docs/specs/SPEC_ISOLATE_HOST_CLAUDE_MD_2026_08_31.md.

Fields

provider: String

dir: String

error: String

AgentDeleted

The block names an agent that was deleted (its row is gone and the shared definition registry holds only a retired record for it). The pane survived the delete — deleted from another window, or mid-spawn — and used to spawn on the shared login with no identity at all; it is refused instead (#3577).

Fields

agent_id: String

Trait Implementations

impl Clone for SpawnGateError

fn clone(&self) -> SpawnGateError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SpawnGateError

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

Formats the value using the given formatter.

impl Display for SpawnGateError

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

Formats the value using the given formatter.

impl Eq for SpawnGateError

impl Error for SpawnGateError

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 PartialEq for SpawnGateError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for SpawnGateError