traitclaw_steering/lib.rs
1//! Steering system for the `TraitClaw` AI agent framework.
2//!
3//! Provides built-in implementations of the Guard-Hint-Track triad
4//! to keep agents safe, focused, and efficient without relying on prompts.
5//!
6//! # Quick Start
7//!
8//! ```rust,no_run
9//! use traitclaw_steering::guards::ShellDenyGuard;
10//! use traitclaw_steering::hints::BudgetHint;
11//! use traitclaw_steering::trackers::AdaptiveTracker;
12//! use traitclaw_core::traits::provider::ModelTier;
13//!
14//! let shell_guard = ShellDenyGuard::default();
15//! let budget_hint = BudgetHint::at(0.75);
16//! let tracker = AdaptiveTracker::for_tier(&ModelTier::Medium);
17//! ```
18
19#![deny(missing_docs)]
20#![allow(clippy::redundant_closure)]
21
22pub mod guards;
23pub mod hints;
24pub mod steering;
25pub mod trackers;
26
27pub use steering::Steering;
28
29/// Convenience prelude — import everything at once.
30pub mod prelude {
31 pub use crate::guards::{
32 ContentFilterGuard, LoopDetectionGuard, PromptInjectionGuard, RateLimitGuard,
33 ShellDenyGuard, ToolBudgetGuard, WorkspaceBoundaryGuard,
34 };
35 pub use crate::hints::{BudgetHint, SystemPromptReminder, TeamProgressHint, TruncationHint};
36 pub use crate::steering::Steering;
37 pub use crate::trackers::AdaptiveTracker;
38}