adk_dart 0.1.2

Core Dart port of Agent Development Kit (ADK) runtime primitives.

adk_dart

adk_dart is a Dart implementation of the Agent Development Kit (ADK).

Current Scope (v0.1.0)

Implemented core runtime layers:

• Agent runtime: BaseAgent, LlmAgent (Agent alias), Context, InvocationContext
• Runner runtime: Runner, InMemoryRunner
• Session runtime: BaseSessionService, InMemorySessionService, session state prefixes (app:, user:, temp:)
• Event model: Event, EventActions, final-response detection
• LLM model abstraction: BaseLlm, LlmRequest, LlmResponse, LLMRegistry
• Tool runtime: BaseTool, FunctionTool, BaseToolset, tool-callback execution path
• LLM flow: BaseLlmFlow, SingleFlow, AutoFlow, function-call orchestration

This release focuses on core runtime behavior. Full feature parity is still in progress.

Install

Add the main package:

dart pub add adk_dart

If you want a shorter import path, add adk instead:

dart pub add adk

Quick Start

import 'package:adk_dart/adk_dart.dart';

class EchoModel extends BaseLlm {
  EchoModel() : super(model: 'echo');

  @override
  Stream<LlmResponse> generateContent(
    LlmRequest request, {
    bool stream = false,
  }) async* {
    yield LlmResponse(content: Content.modelText('echo response'));
  }
}

Future<void> main() async {
  final Agent agent = Agent(name: 'root_agent', model: EchoModel());
  final InMemoryRunner runner = InMemoryRunner(agent: agent);

  final Session session = await runner.sessionService.createSession(
    appName: runner.appName,
    userId: 'user_1',
    sessionId: 'session_1',
  );

  await for (final Event event in runner.runAsync(
    userId: 'user_1',
    sessionId: session.id,
    newMessage: Content.userText('hello'),
  )) {
    print(event.content?.parts.first.text);
  }
}

CLI

adk_dart exposes an adk executable with create, run, and web.

For global use:

dart pub global activate adk_dart
adk --help

For local development in this repository:

dart pub get
dart pub global activate --source path .
adk create my_agent
adk run my_agent
adk web --port 8000 my_agent

adk web --port 8000 starts a development chat UI at http://127.0.0.1:8000.

ADK Web in this repository is intended for development and debugging, not production deployments.

Package Layout

• adk_dart: source-of-truth implementation package
• packages/adk: shorter import package (import 'package:adk/adk.dart';)

Publish order:

1. Publish adk_dart.
2. Publish packages/adk.

Progress Tracking

Current progress is tracked in python_parity_status.md.

Test

dart test
dart analyze

Roadmap

Planned next parity layers:

• Plugins and callback parity hardening
• Live/Bidi execution path (run_live semantics)
• App-level compaction/resumability edge cases
• Additional built-in tools and model integrations
• A2A, evaluation, telemetry, memory, artifact backends