Resolve the root process of an Agent Config composition handle.

-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.

Stop new admission and wait a bounded time for active owners.

-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.

Coarse process liveness for container/platform probes.

Dependency-aware readiness; false while admission is draining.

Return a deterministic, JSON-safe graph descriptor without executable callbacks, credentials, state, or tool arguments.

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.

Render a compiled graph as DOT or Mermaid text.

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.

Return the session service and owned artifact/memory service options selected by the application runtime profile.

Spawn a new agent.

Materialize and spawn a compiled Agent Config composition using the operator-owned registry snapshot that produced it.

Materialize against an explicit sealed registry or snapshot.

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 first message is an unsequenced input-format configuration frame and must not be acknowledged. Its 16000 or 24000 Hz rate is derived inside the bridge from trusted Live-session status; callers cannot override it. 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.

Stop every process owned by an Agent Config composition.

Detach and stop an owner-bound Live voice bridge.