aquin.sdk._runtime Namespace Reference

Classes
class	AquinError

Functions
dict[str, Any]	build_ctx (*, str|None model_id=None, dict[str, Any]|None extra_state=None)
str	prepare_compute (*, str|None model_id=None)
dict[str, Any]	invoke (str tool_name, dict[str, Any]|None args=None, *, str|None command=None, bool needs_model=True, str|None model_id=None, bool raise_on_error=True)
Any	invoke_direct (Any fn, *Any args, str|None command=None, str|None tool_name=None, bool track=True, **Any kwargs)

Function Documentation

build_ctx()

dict[str, Any] build_ctx	(	*	,
		str | None	model_id = None,
		dict[str, Any] | None	extra_state = None )

Build the tool context dict expected by bridge / registry / daemon.

Definition at line 26 of file _runtime.py.

Referenced by invoke().

invoke()

dict[str, Any] invoke	(	str	tool_name,
		dict[str, Any] | None	args = None,
		*	,
		str | None	command = None,
		bool	needs_model = True,
		str | None	model_id = None,
		bool	raise_on_error = True )

Run a named compute tool through the same dispatch path as the CLI.

Parameters
----------
tool_name:
    Bridge / registry tool id (e.g. ``run_consistency_eval``).
args:
    Tool arguments (snake or camelCase accepted by most handlers).
command:
    Optional CLI-style label for local command tracking.
needs_model:
    If True, ensure a model is loaded / daemon-ready.
model_id:
    Override active model for this call.
raise_on_error:
    If True, raise :class:`AquinError` when the result has ``error``.

Definition at line 95 of file _runtime.py.

References build_ctx(), and prepare_compute().

invoke_direct()

Any invoke_direct	(	Any	fn,
		*Any	args,
		str | None	command = None,
		str | None	tool_name = None,
		bool	track = True,
		**Any	kwargs )

Call a compute function directly (for paths that skip the tool registry).

Definition at line 162 of file _runtime.py.

prepare_compute()

str prepare_compute	(	*	,
		str | None	model_id = None )

Ensure loader shim + local server; return resolved active model id.

Definition at line 78 of file _runtime.py.

Referenced by invoke().