-spec await_planning(planning_ref()) -> {ok, adk_planning_runtime:result()} | {error, term()}.

Await a planning result without an additional caller timeout.

-spec await_planning(planning_ref(), timeout()) -> {ok, adk_planning_runtime:result()} | {error, term()}.

Await a planning result for at most Timeout milliseconds.

-spec cancel_planning(planning_ref()) -> ok | {error, term()}.

Cancel planning with the default user_cancelled reason.

-spec cancel_planning(planning_ref(), term()) -> ok | {error, term()}.

Cancel planning with an application-supplied reason.

Validate and compile a declarative workflow specification.

Asynchronously delegate a task to an agent (fire and forget).

Asynchronously delegate a task to an agent and receive a message when done.

Asynchronously delegate and correlate the reply with Ref.

Execute one fresh-history invocation in an explicit runtime context. Reusing an agent PID through this API never reads or mutates prompt/2's compatibility conversation history.

Submit one complete version-1 client binary frame synchronously. Synchronous calls preserve existing Live ingress backpressure.

Synchronously prompt an agent.

Resume a durable workflow by invocation ID after coordinator or application failure.

-spec run_planning(adk_planner:descriptor(), adk_plan_executor:descriptor(), term(), map()) ->
                      {ok, adk_planning_runtime:result()} | {error, term()}.

Run a trusted planner and executor synchronously with default limits.

-spec run_planning(adk_planner:descriptor(), adk_plan_executor:descriptor(), term(), map(), map()) ->
                      {ok, adk_planning_runtime:result()} | {error, term()}.

Run explicit planning synchronously with bounded runtime options.

Run a compiled workflow synchronously to one terminal outcome.

Spawn a new agent.

Start one independently supervised bidirectional Live session. Principal is checked on every subsequent operation and is never returned in status/events. Provider credentials stay inside the session transport.

Start an owner-bound binary bridge for a server-owned Live session.

The owner receives only strict binary messages shaped as {adk_live_voice_frame, BridgePid, Frame}. Forwarded Live event credit is released only when the owner submits the exact v1 ACK frame through live_voice_frame/2. The Live session must already be active. The bridge terminates when OwnerPid terminates. A provider reconnect invalidates and terminates the bridge independently of subscriber event credit; an input racing that transition is rejected by the same continuity boundary. An adapter must detach capture and create a fresh bridge only after the session resumes.

-spec start_planning(adk_planner:descriptor(), adk_plan_executor:descriptor(), term(), map()) ->
                        {ok, planning_ref()} | {error, term()}.

Start owner-bound explicit planning with default limits.

-spec start_planning(adk_planner:descriptor(), adk_plan_executor:descriptor(), term(), map(), map()) ->
                        {ok, planning_ref()} | {error, term()}.

Start owner-bound explicit planning with bounded runtime options.

Start an independently supervised workflow coordinator.

Start a durably checkpointed workflow and return its stable invocation ID together with the current supervised coordinator pid.

Stop an agent gracefully so its name can be reused.

Detach and stop an owner-bound Live voice bridge.