temporalio.contrib.google_adk_agents._hitl

Human-in-the-loop helpers for Google ADK agents running in Temporal workflows.

ADK pauses a run by emitting an event that carries a special function call (adk_request_input for human-input nodes, adk_request_confirmation for tool confirmation) and resumes when a later user message answers it with a matching FunctionResponse. Inside a Temporal workflow the pause maps naturally onto a durable wait: collect the pending requests from the events yielded by runner.run_async, expose them via a query, wait for responses via workflow.wait_condition on a signal or update handler, then call runner.run_async again with the response parts.

These helpers cover the wire format only; the wait topology stays ordinary Temporal workflow code. Auth requests (adk_request_credential) are not covered: ADK exchanges the credential with network I/O inside the flow, and the exchanged secret would be recorded in workflow history. Resolve credentials worker-side instead.