orionis.mcp.invoker.McpInvoker

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.

Explore modules View classes

class documentation

class McpInvoker: (source)

Constructor: McpInvoker.compile(definition, method, payload_type, argument_names, ...)

View In Hierarchy

A reusable unbound handler plan; payloads never become keyword mappings.

Class Method	`compile`	Resolve annotations and classify all parameters once during boot.
Static Method	`_clientValue`	Read only parameters explicitly declared as client-controlled input.
Async Static Method	`_value`	Resolve the trusted source chosen at compile time.
Async Method	`invoke`	Inject trusted context/services while preserving generator results.
Class Variable	`function`	Undocumented
Class Variable	`parameters`	Undocumented
Class Variable	`receiver`	Undocumented

@classmethod

def compile(cls, definition: type, method: str, payload_type: object = None, *, argument_names: tuple[str, ...] = (), uri_names: tuple[str, ...] = ()) -> McpInvoker: (source) ¶

Resolve annotations and classify all parameters once during boot.

Parameters
definition:`type`	Class declaration whose metadata is being inspected.
method:`str`	Value supplied for `method`.
payload_type:`object`	Value supplied for `payload_type`.
argument_names:`tuple[str, ...]`	Value supplied for `argument_names`.
uri_names:`tuple[str, ...]`	Value supplied for `uri_names`.

Returns
`McpInvoker`	Result of the operation described above.

@staticmethod

def _clientValue(parameter: _Parameter, request: McpRequest, payload: object) -> object: (source) ¶

Read only parameters explicitly declared as client-controlled input.

Parameters
parameter:`_Parameter`	Value supplied for `parameter`.
request:`McpRequest`	Current request and its trusted execution context.
payload:`object`	Input payload supplied for conversion or processing.

Returns
`object`	Result of the operation described above.

@staticmethod

async def _value(parameter: _Parameter, app: IContainer, request: McpRequest, payload: object) -> object: (source) ¶

Resolve the trusted source chosen at compile time.

Parameters
parameter:`_Parameter`	Value supplied for `parameter`.
app:`IContainer`	Application container supplying configuration and dependencies.
request:`McpRequest`	Current request and its trusted execution context.
payload:`object`	Input payload supplied for conversion or processing.

Returns
`object`	Result of the operation described above.

async def invoke(self, instance: object, app: IContainer, request: McpRequest, payload: object = msgspec.UNSET) -> object: (source) ¶

Inject trusted context/services while preserving generator results.

Parameters
instance:`object`	Instance supplying values or receiving the invocation.
app:`IContainer`	Application container supplying configuration and dependencies.
request:`McpRequest`	Current request and its trusted execution context.
payload:`object`	Input payload supplied for conversion or processing.

Returns
`object`	Result of the operation described above.

function: Callable[..., object] = (source) ¶

Undocumented

parameters: tuple[_Parameter, ...] = (source) ¶

Undocumented

receiver: Literal['instance', 'class', 'none'] = (source) ¶

Undocumented