Skip to main content

Crate adk_rs_fluent

Crate adk_rs_fluent 

Source
Expand description

§adk-rs-fluent

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 rs_adk (agent runtime) and rs_genai (wire protocol).

§Module Organization

ModulePurpose
builderCopy-on-write immutable AgentBuilder for declarative agent configuration
composeS·C·T·P·M·A operator algebra for composing agent primitives
liveLive session handle — callback-driven full-duplex event handling
live_buildersBuilder types for live session configuration
operatorsOperator combinators for composing agents
patternsPre-built composition patterns for common use cases
testingTest utilities and mock helpers

§Quick Start

use adk_rs_fluent::prelude::*;

let agent = AgentBuilder::new("my-agent")
    .model(GeminiModel::Gemini2_0Flash)
    .instruction("You are a helpful assistant.")
    .build();

§Relationship to Other Crates

  • rs-genai (L0): Wire protocol, transport, types — re-exported via rs_genai
  • rs-adk (L1): Agent runtime, tools, sessions — re-exported via rs_adk
  • adk-rs-fluent (L2): This crate — ergonomic builder API and composition

Re-exports§

pub use rs_adk;
pub use rs_genai;

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 Live API.
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 move closures, reducing Arc/clone boilerplate.