Crate gemini_adk_fluent_rs 

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 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.

agents

Agent builders, the agent trait, and the operator/pattern combinators.

builder

AgentBuilder — copy-on-write immutable builder for fluent agent construction.

compose

Composition modules – S, C, P, M, T, A, E, G.

conversation

The conversation compiler (Phase 1 MVP).

flow

Governed-conversation flow primitives: Flow, Step, Guard, FlowMonitor.

flow_macros

Typed graph macros — compile-time-checked names for flow authoring.

live

Live — Fluent builder for callback-driven Gemini Live sessions.

live_builders

Sub-builders for the fluent Live API.

llm

LLM abstraction: params, requests/responses, and the registry.

motifs

Conversational motifs — a standard library of high-confidence flow fragments.

operators

Operator algebra for agent composition.

patterns

Pre-built patterns — common multi-agent workflows.

policy

Policy aspects — reusable, cross-cutting governance attached to a whole conversation rather than scattered across stages.

prelude

The kernel prelude — the ~40 types a typical application touches.

simulation

Model-free conversation simulation.

state

Concurrent typed state: State, PrefixedState, StateKey, prefix scopes.

testing

Testing utilities — mock backends, agent harnesses, contract validation.

text

Text-agent runtime and combinators (carved out of the kernel prelude).

tools

Tool definitions, dispatch, toolsets, the confirmation flow, and frames.

wire

L0 wire-protocol types for raw WebSocket access.

Macros

let_clone

Clone multiple bindings for use in move closures, reducing Arc/clone boilerplate.

voice_flow

Generate a module of compile-time-checked flow name constants.