@assistant-ui/react-google-adk

Google ADK (Agent Development Kit) integration for @assistant-ui/react. Connects ADK JS agents to the assistant-ui runtime with streaming, tool calls, multi-agent support, tool confirmations, auth flows, and session-state management.

Installation

npm install @assistant-ui/react @assistant-ui/react-google-adk @google/adk

Usage

The recommended setup proxies through your own API route:

// app/api/adk/route.ts
import { createAdkApiRoute } from "@assistant-ui/react-google-adk/server";
import { runner } from "./agent";
import { requireUser } from "./auth"; // Your authentication helper

export const POST = createAdkApiRoute({
  runner,
  userId: async (req) => (await requireUser(req)).id,
  sessionId: (_req, clientSessionId) => {
    if (!clientSessionId) throw new Error("Missing ADK session ID");
    return clientSessionId;
  },
});

createAdkStream sends its initialized thread ID to the route. Resolve userId from authentication before accepting that identifier; a client-sent session ID is not proof that the caller owns the session. The route creates a missing ADK session before the first run when the runner exposes appName and sessionService.

// client component
import { useAdkRuntime, createAdkStream } from "@assistant-ui/react-google-adk";

const runtime = useAdkRuntime({
  stream: createAdkStream({ api: "/api/adk" }),
});

Or connect directly to an ADK server with createAdkSessionAdapter; see the docs for the full setup and option reference.

See also

• @assistant-ui/react-langgraph for LangGraph SDK agents.
• @assistant-ui/react-ag-ui for the AG-UI protocol.

Full reference for client hooks (useAdkAgentInfo, useAdkSessionState, useAdkToolConfirmations, useAdkAuthRequests, etc.), server exports, and direct mode at assistant-ui.com/docs/runtimes/google-adk.