Agent Development Kit (ADK) for TypeScript is an open-source framework created by IQ AI for the development, orchestration, and deployment of intelligent AI agents. It provides a TypeScript-first toolkit for building a range of AI systems, from simple question-and-answer bots to complex multi-agent architectures capable of performing real-world tasks, with a focus on type safety and modularity [1] [3].
The Agent Development Kit (ADK) for TypeScript is a framework that enables developers to construct multi-agent AI systems. Inspired by Google's Python ADK, it adapts the architecture for the TypeScript ecosystem, focusing on type safety, modularity, and developer experience. The kit supports hierarchical agents, integrates various tools, manages memory, and handles real-time streaming. Its role encompasses the building, orchestration, and deployment of AI agents [2] [4]. Launched on July 17, 2025, ADK for TypeScript supports developers in building AI agents [1].
ADK for TypeScript functions as a toolkit for creating diverse AI applications. Its design considers developer experience, offering features like autocompletion and type safety inherent to TypeScript. The framework's modular architecture allows for composition of agents, attachment of various tools, and integration with multiple large language models (LLMs) [1]. It is designed to scale from prototypes to production deployments, incorporating functionalities such as session management, persistent memory, and OpenTelemetry support for tracing and performance monitoring [2].
ADK for TypeScript is built around several core features that support its use for developers. These features contribute to its capability to support AI agent development.
The AgentBuilder
API provides an interface for the creation of AI agents, aiming to reduce boilerplate code. This API allows developers to set up agents, supporting both simple agent instantiations and the construction of multi-agent workflows. Common patterns can be implemented, and the API is designed for gradual complexity, allowing developers to start simple and add features as needed. It is designed to scale with varying project needs, from basic agents to intricate systems [2] [4].
The framework offers compatibility with a range of large language models (LLMs) through a unified interface. This allows developers to switch between different models such as OpenAI's GPT series, Google Gemini, Anthropic Claude, and Mistral, providing options in model selection based on specific application requirements. The system is powered by the Vercel AI SDK, and its provider-agnostic foundation supports developers in using various ecosystems [1] [4].
ADK for TypeScript features a modular architecture that enables developers to compose agents and integrate various tools. Developers can compose multiple agents, equip them with custom tools, and orchestrate workflows. Agents can be equipped with ready-to-use tools or custom-built functionalities. Tool integration is facilitated via the Model Context Protocol (MCP), which supports tooling, function integration, and automatic schema generation, allowing connection to a range of MCP servers in the market or the creation of custom ones. This modularity provides developers with options in designing and extending their AI systems [2] [4].
The kit includes features for stateful memory and session management, allowing agents to maintain context and state across multiple interactions or sessions. This is for building AI assistants and autonomous agents that require persistent knowledge and continuity in their operations. Built-in session management and memory services are designed for enterprise deployment, supporting reliability and scalability [1] [4].
ADK for TypeScript incorporates OpenTelemetry support for tracing and performance evaluation. This allows developers to debug agent behavior, monitor performance metrics, and gain insights into the execution flow of multi-agent systems. The tracing capabilities support optimizing agent performance and reliability in production environments. Additionally, it includes a built-in evaluation system to assess agent performance by testing final responses and execution trajectories [1] [4].
Agents are the central abstraction in ADK for TypeScript. They are designed to encapsulate AI models, instructions, tools, and coordination logic, creating autonomous programs that can interpret instructions and execute complex tasks [4].
ADK for TypeScript offers several types of agents, each suited for different use cases, allowing developers to build sophisticated systems by combining them [4].
These agent types provide a flexible foundation for building a wide range of AI applications [4].
The selection of an agent type depends on the specific requirements of the task. The framework provides a guide for choosing the most appropriate agent for a given scenario [4].
This guidance helps developers architect more effective and efficient AI systems [4].
ADK for TypeScript provides support for orchestrating multi-agent workflows. It allows for the coordination of teams of agents to handle tasks and processes. The framework supports various orchestration logics, including sequential, parallel, and LLM-driven routing, enabling developers to design collaborative workflows where specialized agent chains can work together to achieve a common goal [2]. This capability is for building AI systems that can manage multi-step tasks.
ADK-TS integrates with Coinbase's x402 protocol, an open standard designed to facilitate on-chain crypto payments for AI agents and other digital services. This integration enables developers to build agents that can automatically charge for their services and pay for API calls using crypto micropayments, creating a foundation for autonomous, monetized AI economies [6].
The x402 protocol is based on the HTTP 402 Payment Required status code. The process involves a server responding to a request for a paid resource with a 402 error, which specifies the cost, currency (e.g., USDC), and destination address. The client then makes the payment on-chain and retries the request, including cryptographic proof of payment in the X-PAYMENT
header. The server verifies this proof and grants access to the resource. This system supports instant, global micropayments, which are often impractical with traditional payment methods like credit cards [6].
To demonstrate this capability, IQ AI released the ADK-TS x402 agent template. This starter project provides developers with a complete setup for building AI agents with native crypto payment functionality. The template is structured into three key components that work together [6]:
A key architectural feature of the template is the separation of concerns: pricing and payment logic reside on the server, not within the agent's code. This allows developers to update pricing without needing to redeploy the agents and keeps the agent's logic focused on its core tasks. The template runs on the Base Sepolia testnet, allowing for experimentation without real funds [6].
This integration of ADK-TS intelligence with x402 economics supports the development of new models for AI, such as pay-per-API call services, marketplaces where agents transact with each other, and decentralized agent economies where agents can earn and spend autonomously [6].
ADK-TS integrates with the NEAR Protocol to enable the creation of autonomous AI agents that can securely execute transactions on-chain without human intervention. This is achieved through a collaboration with NEAR Shade Agents, which combine AI intelligence with secure blockchain execution [7].
The integration pairs the AI capabilities of ADK-TS with the blockchain execution framework of NEAR Shade Agents. In this architecture, ADK-TS is responsible for the agent's intelligence, allowing it to monitor conditions, analyze data, and make decisions. NEAR Shade Agents handle the secure execution of blockchain transactions [7].
A key challenge in AI-blockchain integration is securely managing private keys for transaction signing. NEAR Shade Agents address this using Account Abstraction and Trusted Execution Environments (TEEs). Each AI agent is assigned its own NEAR account with private keys stored securely within a TEE, which provides hardware-level protection. This setup allows the agent to sign transactions autonomously. Furthermore, through NEAR's Chain Signatures technology, these agents can sign transactions not only on the NEAR blockchain but also on other chains like Ethereum and Bitcoin, enabling cross-chain operations [7].
To facilitate development, a dedicated ADK-TS template, the "Shade Agent" template, is available. This template provides a practical example of an AI agent that monitors Ethereum market sentiment by analyzing Reddit headlines, fetches real-time price data from CoinGecko, and autonomously signs and broadcasts a transaction to update an on-chain oracle contract. The template includes pre-configured REST API endpoints for managing and interacting with the agent, allowing developers to monitor its NEAR and Ethereum accounts and trigger its transaction-signing process [7].
For developers working within the Web3 ecosystem, ADK for TypeScript offers support for integrating with blockchain and decentralized finance (DeFi) applications. This enables AI agents to interact with on-chain data and protocols.
These capabilities are supported by a suite of specialized Model Context Protocol (MCP) servers developed by IQ AI, designed to extend the capabilities of ADK TypeScript agents by providing integration with various external services and data sources.
Specific on-chain functionalities include:
IQ AI has developed a collection of specialized Model Context Protocol (MCP) servers to enhance and extend the capabilities of ADK TypeScript agents. These servers provide integration with various external services and data sources. The available servers include:
This suite of servers enables developers to build agents with a wide range of on-chain and off-chain capabilities [4].
The ADK-TS Command Line Interface (@iqai/adk-cli
) is a toolkit for AI agent development, testing, and deployment. It is built with TypeScript and NestJS and provides a development environment that covers the entire lifecycle from project creation to production deployment. The CLI is noted as an experimental feature, and its APIs may change in future releases [5].
The ADK-TS CLI includes a range of features designed to support professional AI agent development [5].
.gitignore
rules and allowing for path filtering.