Skip to main content

ZeroRuntimeError

Base for everything this SDK raises on its own behalf. Catch it to handle any ZeroRuntime failure without naming each one. Errors the language raises — TypeError for a bad argument, RangeError for one out of bounds — are left as themselves rather than wrapped.

Constructor

string
default:"''"

SessionRejected

The ZeroRuntime refused to create the session.

Constructor

string
default:"''"
object
default:"{}"

ProviderUnavailable

A provider in the pipeline could not be reached or would not serve. Usually a missing or rejected vendor key, or a model the account is not entitled to. A fallback on the same slot is what keeps this from ending the call.

Constructor

string
default:"''"

ZeroRuntimeUnreachable

The runtime could not be reached, or did not answer in time. A transport failure rather than a refusal: nothing was decided about the session, so retrying is reasonable.

Constructor

string
default:"''"

ToolTimeout

A function_tool did not return before its deadline. The turn continues without the tool’s answer. A tool that calls out to a slow API wants its own timeout, so it can say something useful instead of being cut off.

Constructor

string
default:"''"

AgentState

Where the agent is in a turn — listening, thinking, speaking, or on its way in or out of the call.

UserState

What the caller is doing, as the runtime reports it.

ChatRole

Who a message in the conversation came from. A plain string works anywhere one of these is accepted — the members are strings — so 'user' and ChatRole.USER are interchangeable.