adk-core

Core traits and types for Rust Agent Development Kit (ADK-Rust) agents, tools, sessions, and events.

Overview

adk-core provides the foundational abstractions for the Rust Agent Development Kit (ADK-Rust). It defines the core traits and types that all other ADK crates build upon, including:

Agent trait - The fundamental abstraction for all agents
Tool traits - For extending agents with custom capabilities
Session/State - For managing conversation context
Event system - For streaming agent responses
Error types - Unified error handling

This crate is model-agnostic and contains no LLM-specific code.

Installation

[dependencies]
adk-core = "0.1"

Or use the meta-crate for all components:

[dependencies]
adk-rust = "0.1"

Core Traits

Agent

use adk_core::{Agent, InvocationContext, EventStream};

#[async_trait]
pub trait Agent: Send + Sync {
    fn name(&self) -> &str;
    fn description(&self) -> Option<&str>;
    async fn run(&self, ctx: Arc<dyn InvocationContext>) -> Result<EventStream>;
}

Tool

use adk_core::{Tool, ToolContext};

#[async_trait]
pub trait Tool: Send + Sync {
    fn name(&self) -> &str;
    fn description(&self) -> &str;
    async fn execute(&self, ctx: Arc<dyn ToolContext>, args: Value) -> Result<Value>;
}

Key Types

Event - Represents agent response events (text, tool calls, etc.)
Content / Part - Message content structures
Session / State - Conversation state management
InvocationContext - Execution context for agents
AdkError / Result - Error handling

Features

Zero runtime dependencies on specific LLM providers
Async-first design with async-trait
Streaming support via EventStream
Flexible state management with typed prefixes

Related Crates

adk-rust - Meta-crate with all components
adk-agent - Agent implementations
adk-tool - Tool implementations
adk-model - LLM integrations

License

Apache-2.0

Part of ADK-Rust

This crate is part of the ADK-Rust framework for building AI agents in Rust.

adk-core 0.1.6