Enum SdkError 

pub enum SdkError {
    Agent(AgentError),
    Build(String),
    Config(String),
    ProviderInit(String),
    StoreInit(String),
    SkillInit(String),
    McpServerStart {
        server_id: String,
        source: McpError,
    },
    SessionNotFound(String),
    SessionLoad(String),
    SessionSave(String),
    NoPendingQuestion,
    InvalidResponse(String),
    Unsupported(String),
    Io(Error),
}

Errors surfaced by the bamboo_sdk facade.

Variants

Agent(AgentError)

A run/resume of the underlying agent loop failed. Wraps the runtime’s own typed error so ? composes across Agent::run* and the newer facade methods in a function returning Result<_, SdkError>.

Build(String)

AgentBuilder::build() failed — the wrapped engine builder rejected an incomplete or inconsistent dependency set (e.g. a required dependency was never supplied).

Config(String)

with_defaults_for_data_dir failed to read/parse config.json.

ProviderInit(String)

with_defaults_for_data_dir failed to construct the configured LLM provider — commonly a missing/invalid API key. See AgentBuilder::api_key and AgentBuilder::provider_name.

StoreInit(String)

with_defaults_for_data_dir failed to open the session store at the given data directory.

SkillInit(String)

with_defaults_for_data_dir failed to initialize the skill manager.

McpServerStart

An MCP server failed to start (see AgentBuilder::mcp_server).

Fields

server_id: String

source: McpError

SessionNotFound(String)

The requested session does not exist.

SessionLoad(String)

Loading a session from storage failed.

SessionSave(String)

Persisting a session failed.

NoPendingQuestion

Agent::answer was called on a session with no pending question / approval to respond to.

InvalidResponse(String)

The response passed to Agent::answer did not match one of the pending question’s fixed options (and it does not allow a custom response).

Unsupported(String)

A capability that requires with_defaults_for_data_dir (e.g. session listing, which needs the concrete session-index handle) was called on an Agent assembled from manually-injected dependencies.

Io(Error)

Underlying I/O failure (session store reads/writes, etc).

Trait Implementations

impl Debug for SdkError

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

Formats the value using the given formatter.

impl Display for SdkError

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

Formats the value using the given formatter.

impl Error for SdkError

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<AgentError> for SdkError

fn from(source: AgentError) -> SdkError

Converts to this type from the input type.

impl From<Error> for SdkError

fn from(source: Error) -> SdkError

Converts to this type from the input type.

impl From<RespondError> for SdkError

fn from(error: RespondError) -> SdkError

Converts to this type from the input type.

impl From<SessionLoadError> for SdkError

fn from(error: SessionLoadError) -> SdkError

Converts to this type from the input type.

impl From<SessionSaveError> for SdkError

fn from(error: SessionSaveError) -> SdkError

Converts to this type from the input type.