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.
class documentation
Own only boot-time schema caches; discard them after the registry is built.
| Static Method | _prompt |
Compile only explicitly named prompt arguments. |
| Static Method | _resource |
Compile exact resources and RFC templates with safe inverse matching. |
| Method | __init__ |
Use a per-compilation cache rather than growing a process-global cache. |
| Method | _tool |
Compile typed tool schemas and statically reachable header bindings. |
| Method | primitive |
Compile one ordinary primitive and all of its immutable handler plans. |
| Method | schema |
Share one schema snapshot per type and direction inside this compilation. |
| Method | synthetic |
Describe runtime-owned catalog operations using native typed schemas. |
| Class Variable | __slots__ |
Undocumented |
| Instance Variable | cache |
Undocumented |
| Instance Variable | extensions |
Undocumented |
| Instance Variable | schemas |
Undocumented |
def _prompt(definition:
type[ Prompt], primitive: CompiledPrimitive, metadata: dict[ str, object]) -> CompiledPrimitive:
(source)
¶
Compile only explicitly named prompt arguments.
| Parameters | |
definition:type[Prompt] | Class declaration whose metadata is being inspected. |
primitive:CompiledPrimitive | Compiled tool, resource or prompt declaration. |
metadata:dict[str, object] | Metadata associated with the current operation. |
| Returns | |
CompiledPrimitive | Result of the operation described above. |
def _resource(definition:
type[ Resource], primitive: CompiledPrimitive, metadata: dict[ str, object]) -> CompiledPrimitive:
(source)
¶
Compile exact resources and RFC templates with safe inverse matching.
| Parameters | |
definition:type[Resource] | Class declaration whose metadata is being inspected. |
primitive:CompiledPrimitive | Compiled tool, resource or prompt declaration. |
metadata:dict[str, object] | Metadata associated with the current operation. |
| Returns | |
CompiledPrimitive | Result of the operation described above. |
Use a per-compilation cache rather than growing a process-global cache.
| Parameters | |
extensions:tuple[McpExtension, ...] | Value supplied for extensions. |
cache:CacheHint | Value supplied for cache. |
| Returns | |
None | Complete the documented operation without returning a value. |
def _tool(self, definition:
type[ Tool], primitive: CompiledPrimitive, metadata: dict[ str, object]) -> CompiledPrimitive:
(source)
¶
Compile typed tool schemas and statically reachable header bindings.
| Parameters | |
definition:type[Tool] | Class declaration whose metadata is being inspected. |
primitive:CompiledPrimitive | Compiled tool, resource or prompt declaration. |
metadata:dict[str, object] | Metadata associated with the current operation. |
| Returns | |
CompiledPrimitive | Result of the operation described above. |
def primitive(self, definition:
type[ Primitive], kind: type[ Primitive]) -> CompiledPrimitive:
(source)
¶
Compile one ordinary primitive and all of its immutable handler plans.
| Parameters | |
definition:type[Primitive] | Class declaration whose metadata is being inspected. |
kind:type[Primitive] | Value supplied for kind. |
| Returns | |
CompiledPrimitive | Result of the operation described above. |
def synthetic(self, name:
str, kind: Literal[ 'search', 'execute'], catalog: int) -> CompiledPrimitive:
(source)
¶
Describe runtime-owned catalog operations using native typed schemas.
| Parameters | |
name:str | Value supplied for name. |
kind:Literal['search', 'execute'] | Value supplied for kind. |
catalog:int | Value supplied for catalog. |
| Returns | |
CompiledPrimitive | Result of the operation described above. |