Skip to content
GkTs

Google ADK (TypeScript)

TypeScript edition of the Google Agent Development Kit — LlmAgent, Zod-typed tools, runners, graph workflows, MCP and A2A for Node.js and the browser.

The TypeScript edition of Google ADK. LlmAgent, Zod-typed function tools, a Runner with session, memory and artifact services, plugins, graph Workflows with human-in-the-loop pauses, MCP and A2A, with ESM, CommonJS and browser builds.

Install

Terminal window
npm install @google/adk zod
npm install -D @google/adk-devtools

Version

v2.4.0 (checked 2026-11-19)

Best for

Gemini agents in Node.js backends and full-stack TypeScript apps.

Agents do not run themselves; a Runner drives them. InMemoryRunner wires in in-memory services, and runEphemeral runs one turn without keeping the session.

import {FunctionTool, InMemoryRunner, LlmAgent, isFinalResponse, stringifyContent} from '@google/adk';
import {z} from 'zod';
const getWeather = new FunctionTool({
name: 'get_weather',
description: 'Returns the current weather for a city.',
parameters: z.object({city: z.string().describe('City name')}),
execute: async ({city}) => ({city, forecast: 'sunny', tempC: 21}),
});
export const rootAgent = new LlmAgent({
name: 'assistant',
model: 'gemini-3.8-flash',
instruction: 'You are a helpful assistant. Use get_weather for weather questions.',
tools: [getWeather],
});
const runner = new InMemoryRunner({agent: rootAgent, appName: 'demo'});
for await (const event of runner.runEphemeral({
userId: 'u1',
newMessage: {role: 'user', parts: [{text: 'What is the weather in Leeds?'}]},
})) {
if (isFinalResponse(event)) {
console.log(stringifyContent(event));
}
}

Set GOOGLE_GENAI_API_KEY (GOOGLE_API_KEY and GEMINI_API_KEY also work), or use Vertex AI with GOOGLE_GENAI_USE_ENTERPRISE=1 plus GOOGLE_CLOUD_PROJECT and GOOGLE_CLOUD_LOCATION. The file uses top-level await, so the package needs "type": "module". With rootAgent exported, npx adk run agent.ts chats with it in the terminal and npx adk web opens the dev UI.

The 2.0.0 release (August 2026) introduced graph orchestration and made a few breaking changes:

  • Workflow, FunctionNode, JoinNode, Edge and START arrive; Workflow is still marked experimental. A bare Workflow can be the root of a Runner or App.
  • BaseAgent now extends BaseNode, so agents inherit rerunOnResume, retryConfig, timeout and the schema fields. A subclass that declares a field of the same name now collides with the inherited one.
  • SequentialAgent, ParallelAgent and LoopAgent log a one-time deprecation warning; they still work.
  • LLMAgentWrapper is removed — pass an agent to an edge directly.
  • InvocationContext.agent is optional; inside an agent, use requireAgent(ctx).
  • FunctionTool gained requireConfirmation for human approval, and Runner.runLive arrived for live sessions.

Later 2.x releases added planners (BuiltInPlanner, PlanReActPlanner), ContainerCodeExecutor, Runner.autoCreateSession (opt-in), DebugLoggingPlugin and ToolCallIntegrityPlugin, alongside parity work with the Python kit. Release notes are in the adk-js changelog.


DateVersionChanges
2026-11-022.4.0Re-verified against the npm release: AgentToolConfig.skipSummarization is still stored but unused, and Workflow is still experimental.
2026-10-24currentAdded the comprehensive guide and production guide; the tools, sessions, multi-agent and workflow examples moved there. Noted that the npm adk command needs @google/adk-devtools installed.
2026-10-21currentAdded tools, sessions, multi-agent and workflow examples, each type-checked with tsc --strict and run against a stub model. Dropped the unsupported Node.js version claim.
2026-10-212.3.0Re-verified against the current npm release. Replaced the minimal example, which called a non-existent agent.run(), with a type-checked InMemoryRunner.runEphemeral example; added the 2.x changes; version now read from the site’s version data.
2026-04-211.0.0Bumped to installed v1.0.0 GA after npm introspection; LLMAgent → LlmAgent (matches Python casing).
2026-04-210.6.1Index redesigned with language-selector style.
April 4, 20260.6.1Active development release.

Other languages: Python · Go.