codex_app_server_sdk.errors¶
errors
¶
CodexError
¶
Bases: Exception
Base exception for the codex-app-server-sdk package.
CodexProtocolError
¶
Bases: CodexError
Raised when JSON-RPC or app-server protocol reports an error.
__init__(message, *, code=None, data=None)
¶
Create a protocol error.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
message
|
str
|
Human-readable description. |
required |
code
|
int | None
|
Optional JSON-RPC error code. |
None
|
data
|
Any
|
Optional protocol-provided error payload. |
None
|
CodexTimeoutError
¶
Bases: CodexError
Raised when a request or turn wait exceeds its timeout policy.
CodexTransportError
¶
Bases: CodexError
Raised when the underlying transport fails or disconnects unexpectedly.
CodexTurnInactiveError
¶
Bases: CodexTimeoutError
Raised when a running turn emits no matching events for too long.
Attributes:
| Name | Type | Description |
|---|---|---|
continuation |
Opaque token used to resume the same running turn. |
|
idle_seconds |
Resolved inactivity timeout that triggered this exception. |
__init__(message, *, continuation, idle_seconds)
¶
Create a turn inactivity timeout error.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
message
|
str
|
Human-readable timeout description. |
required |
continuation
|
ChatContinuation
|
Continuation token for resuming interrupted wait. |
required |
idle_seconds
|
float
|
Timeout value in seconds that was exceeded. |
required |