behest 0.3.0

A Rust-native cloud agent runtime with typed tools, pluggable memory, queues, and observability.
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

#![forbid(unsafe_code)]
#![deny(missing_docs)]
#![deny(unreachable_pub)]
#![warn(rust_2018_idioms)]

//! Production-oriented building blocks for Rust-native AI agent runtimes.
//!
//! The crate currently focuses on provider-neutral chat, streaming, tool-calling,
//! and embedding contracts. Runtime integrations can implement the provider traits
//! and register them in [`provider::ProviderRegistry`].
//!
//! # Modules
//!
//! - [`config`]: Centralized configuration with file, env, and manual builder support
//! - [`runtime`]: Agent runtime kernel with streaming-first execution
//! - [`provider`]: Provider traits, request/response types, and registry
//! - [`tool`]: Runtime tool registry and execution
//! - [`context`]: Multi-adapter context factory for composing chat requests
//! - [`store`]: Persistence layer for sessions, embeddings, and artifacts
//! - [`adapt`]: Concrete provider adapters (OpenAI, Anthropic)
//! - [`error`]: Error types and result aliases
//! - [`rag`]: Retrieval-Augmented Generation context adapter (feature = `rag`)
//! - [`queue`]: External event publishing to message brokers (feature = `queue`)

pub mod adapt;
pub mod agent;
pub mod config;
pub mod context;
pub mod error;
pub mod prelude;
pub mod provider;
pub mod runtime;
pub mod store;
pub mod token;
pub mod tool;
pub mod tool_output;
pub mod tool_scope;

#[cfg(feature = "rag")]
pub mod rag;

#[cfg(feature = "queue")]
pub mod queue;

#[cfg(feature = "server")]
pub mod grpc;

pub use crate::error::{ContextError, Error, ProviderError, Result, StorageError, ToolError};
pub use crate::runtime::{
    AgentEvent, AgentRuntime, CompactionResult, CompactionService, Control, EmitRequest, EventKind,
    FileSnapshotStore, InvocationError, InvocationEvent, InvocationHandle, ModelRouter, RunId,
    RunOutput, RunRequest, RunStatus, RuntimeError, RuntimeEventBridge, RuntimeEventBridgeError,
    RuntimeEventBridgeHandle, RuntimeEventEnvelope, RuntimeEventId, RuntimeEventStore,
    RuntimeEventStoreError, RuntimeInvocation, RuntimePolicy, RuntimeRoom, RuntimeStreamAdapter,
    RuntimeStreamError, RuntimeSubscription, RuntimeSubscriptionError, RuntimeSubscriptionHub,
    SessionContext, Snapshot, SnapshotStore,
};
pub use crate::tool_output::{ToolOutputConfig, TruncationResult};