praval.hitl.runtime

Runtime helpers for provider tool-call HITL gating.

Classes

HITLRuntime(*, run_id, agent_name, ...[, ...])

Provider-facing runtime for tool execution with optional HITL pauses.
class praval.hitl.runtime.HITLRuntime(*, run_id, agent_name, provider_name, hitl_enabled, db_path=None, trace_id=None)[source]

Bases: object

Provider-facing runtime for tool execution with optional HITL pauses.

Parameters:

  • run_id (str)

  • agent_name (str)

  • provider_name (str)

  • hitl_enabled (bool)

  • db_path (Optional[str])

  • trace_id (Optional[str])

__init__(*, run_id, agent_name, provider_name, hitl_enabled, db_path=None, trace_id=None)[source]
Parameters:

  • run_id (str)

  • agent_name (str)

  • provider_name (str)

  • hitl_enabled (bool)

  • db_path (str | None)

  • trace_id (str | None)

execute_or_interrupt(*, tool_call_id, function_name, raw_args, available_tools, continuation_state)[source]

Execute a tool call or interrupt if policy requires approval.

Return type:

str

Parameters:

  • tool_call_id (str)

  • function_name (str)

  • raw_args (Any)

  • available_tools (List[Dict[str, Any]])

  • continuation_state (Dict[str, Any])

async execute_or_interrupt_async(*, tool_call_id, function_name, raw_args, available_tools, continuation_state)[source]

Async tool execution with the same approval interruption policy.

Return type:

Any

Parameters:

  • tool_call_id (str)

  • function_name (str)

  • raw_args (Any)

  • available_tools (List[Dict[str, Any]])

  • continuation_state (Dict[str, Any])

execute_with_decision(*, intervention, available_tools)[source]

Execute the blocked tool call using a decided intervention.

Return type:

str

Parameters:
async execute_with_decision_async(*, intervention, available_tools)[source]

Execute an approved or edited tool decision asynchronously.

Return type:

Any

Parameters: