loopctl 0.1.0

A trait-based framework for building agent loops with pluggable LLM clients, tools, and memory
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

//! Engine module — the core agentic loop that ties all components together.
//!
//! The [`BareLoop`] is the framework's default implementation of an agent
//! execution loop. It orchestrates:
//!
//! 1. **Initialize** — Set up the conversation with system prompt
//! 2. **Stream** — Send messages to the LLM API and accumulate the response
//! 3. **Tool dispatch** — Execute tool calls requested by the model
//! 4. **Feedback** — Feed tool results back into the conversation
//! 5. **Loop** — Repeat until the model stops or max turns is reached
//! 6. **Finalize** — Produce a [`SessionResult`](crate::engine::loop_core::SessionResult)
//!
//! # Example
//!
//! ```rust,ignore
//! use loopctl::engine::BareLoop;
//! use loopctl::tool::ToolRegistry;
//! use loopctl::api::ApiClient;
//! use loopctl::config::LoopConfig;
//!
//! let agent = BareLoop::new(client, registry, config);
//! let result = agent.run("Write a hello world program").await?;
//! ```

mod bare;
pub mod loop_core;

pub use bare::*;