ORIONIS API REFERENCE

THE ORIONIS API

Build with clarity.

Explore the building blocks of an async-first Python framework. Every module, class, and method — connected, searchable, and ready to build with.

module documentation

Adapt MCP failure observation without invoking protocol presentation.

Async Function report Observe an MCP failure without constructing a protocol response.
async def report(exception: BaseException, app: IContainer, *, transport: str = 'in-process', phase: str = 'execution', operation: str | None = None, correlation_id: str | int | None = None, expected: bool = False): (source)

Observe an MCP failure without constructing a protocol response.

Ignore task cancellation, keyboard interrupts, process exits, and generator closure. Application runtimes report only after activation; compatible embedding containers fall back to their unified exception handler.

Parameters
exception:BaseExceptionFailure to observe unless it is an ignored control-flow exception.
app:orionis.container.contracts.container.IContainerApplication or embedding container supplying the failure handler.
transport:str, optionalTransport name attached to failure metadata.
phase:str, optionalMCP lifecycle or execution phase associated with the failure.
operation:str or None, optionalProtocol method or operation name, when available.
correlation_id:str | int | None, optionalRequest identifier converted to a string when present.
expected:bool, optionalWhether the failure is an expected protocol outcome.
Returns
NoneFinish available failure observation without encoding a protocol reply.