Skip to main content

Crate gemini_adk_fluent_rs

Crate gemini_adk_fluent_rs 

Source
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

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 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 via gemini_genai_rs
  • gemini-adk-rs (L1): Agent runtime, tools, sessions — re-exported via gemini_adk_rs
  • gemini-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 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.