tkach 0.5.0

Provider-independent Rust agent runtime — streaming, reasoning summaries, prompt caching, and per-call approval gating.
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
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

//! # tkach
//!
//! A provider-independent agent runtime for Rust with built-in tools.
//!
//! The agent is stateless — callers own the message history and pass
//! it in on every call.
//!
//! ## Quick Start
//!
//! ```ignore
//! use tkach::{Agent, CancellationToken, Message, providers::Anthropic, tools};
//!
//! #[tokio::main]
//! async fn main() -> anyhow::Result<()> {
//!     let agent = Agent::builder()
//!         .provider(Anthropic::from_env())
//!         .model(tkach::model::claude::SONNET)
//!         .system("You are a helpful coding assistant.")
//!         .tools(tools::defaults())
//!         .build()?;
//!
//!     let mut history = vec![Message::user_text(
//!         "What files are in the current directory?",
//!     )];
//!     let result = agent.run(history.clone(), CancellationToken::new()).await?;
//!     history.extend(result.new_messages);
//!     println!("{}", result.text);
//!     Ok(())
//! }
//! ```

pub mod agent;
pub mod approval;
pub mod error;
pub mod executor;
pub mod guard;
pub mod handle;
pub mod message;
pub mod mode;
pub mod model;
pub mod policy;
pub mod prompt_policy;
pub mod provider;
pub mod providers;
pub mod steering;
pub mod stream;
pub mod tool;
pub mod tools;
pub mod user_input;

// Re-export core types at the crate root for convenience.
pub use agent::{Agent, AgentBuilder, AgentResult, AgentStream, BuildError};
pub use approval::{ApprovalDecision, ApprovalHandler, AutoApprove};
pub use error::{AgentError, ProviderError, ToolError};
pub use executor::{
    AllowAll, ConcurrencyConfig, ToolCall, ToolConcurrency, ToolExecutor, ToolPolicy, ToolRegistry,
};
pub use guard::{
    AgentSnapshot, ContinuationGuard, GuardDecision, GuardError, GuardEscape, GuardId, GuardTrigger,
};
pub use handle::AgentHandle;
pub use message::{
    CacheControl, CacheTtl, Content, Message, Role, StopReason, ThinkingMetadata, ThinkingProvider,
    Usage,
};
pub use mode::{
    AcceptEditsMode, AgentMode, DefaultMode, ModeAuthority, ModeDecision, ModeError, PlanMode,
};
pub use policy::{AllowList, IntersectPolicy};
pub use prompt_policy::{
    IntentMatcher, PolicyError, PolicyId, PolicyMetadata, PolicyScope, PolicyTrigger,
    PolicyTriggerMetadata, PromptPolicy,
};
pub use provider::{
    LlmProvider, Request, Response, SystemBlock, ThinkingConfig, ThinkingEffort, ToolDefinition,
};
pub use steering::{
    InterruptError, InterruptOutcome, InterruptReason, InterruptTarget, IntoQueueContent,
    SteerError, TurnId,
};
pub use stream::{ProviderEventStream, StreamEvent};
pub use tokio_util::sync::CancellationToken;
pub use tool::{Tool, ToolClass, ToolContext, ToolOutput};
pub use user_input::{
    Answer, AskUserError, BridgeError, Question, QuestionOption, QuestionSet, UserInputBridge,
    UserInputResponse,
};