Expand description
§gemini-adk-fluent-rs
Fluent developer experience layer for the Gemini Live agent stack.
This is the highest-level crate in the workspace, providing a builder API,
operator algebra, and composition modules that sit on top of
gemini_adk_rs (agent runtime) and gemini_genai_rs (wire protocol).
§Module Organization
| Module | Purpose |
|---|---|
builder | Copy-on-write immutable AgentBuilder for declarative agent configuration |
compose | S·C·T·P·M·A operator algebra for composing agent primitives |
live | Live session handle — callback-driven full-duplex event handling |
live_builders | Builder types for live session configuration |
operators | Operator combinators for composing agents |
patterns | Pre-built composition patterns for common use cases |
testing | Test utilities and mock helpers |
§Quick Start
ⓘ
use gemini_adk_fluent_rs::prelude::*;
let agent = AgentBuilder::new("my-agent")
.model(GeminiModel::Gemini2_0Flash)
.instruction("You are a helpful assistant.")
.build();§Relationship to Other Crates
gemini-live(L0): Wire protocol, transport, types — re-exported viagemini_genai_rsgemini-adk-rs(L1): Agent runtime, tools, sessions — re-exported viagemini_adk_rsgemini-adk-fluent-rs(L2): This crate — ergonomic builder API and composition
Re-exports§
pub use gemini_adk_rs;pub use gemini_genai_rs;
Modules§
- a2a
- A2A — Agent-to-Agent protocol builders.
- builder
- AgentBuilder — copy-on-write immutable builder for fluent agent construction.
- compose
- Composition modules – S, C, P, M, T, A, E, G.
- live
Live— Fluent builder for callback-driven Gemini Live sessions.- live_
builders - Sub-builders for the fluent
LiveAPI. - operators
- Operator algebra for agent composition.
- patterns
- Pre-built patterns — common multi-agent workflows.
- prelude
- Convenience re-exports for common types across all layers.
- testing
- Testing utilities — mock backends, agent harnesses, contract validation.
Macros§
- let_
clone - Clone multiple bindings for use in
moveclosures, reducing Arc/clone boilerplate.