Skip to main content

recursive/
lib.rs

1//! Recursive: a minimal, orthogonal, self-improving coding agent kernel.
2//!
3//! The kernel is intentionally tiny:
4//!   - `Message` is the only data primitive shared across the system.
5//!   - `LlmProvider` abstracts model backends (HTTP, mock, future local...).
6//!   - `Tool` abstracts side effects the model can request.
7//!   - `Agent` is a thin loop that wires them together.
8//!
9//! Everything else is opt-in. New capabilities are added by implementing
10//! `Tool` or `LlmProvider`, never by editing the loop.
11
12pub mod agent;
13pub mod compact;
14pub mod config;
15pub mod config_file;
16pub mod error;
17pub mod hooks;
18pub mod llm;
19#[cfg(feature = "mcp")]
20pub mod mcp;
21#[cfg(feature = "mcp")]
22pub mod mcp_server;
23pub mod message;
24pub mod runner;
25pub mod session;
26pub mod skills;
27pub mod tools;
28pub mod transcript;
29
30pub use agent::PlanningMode;
31pub use agent::{Agent, AgentOutcome, FinishReason, StepEvent};
32pub use agent::{PermissionDecision, PermissionHook};
33pub use compact::Compactor;
34pub use config::Config;
35pub use error::{Error, Result};
36pub use hooks::ToolTimingHook;
37pub use hooks::{Hook, HookAction, HookEvent, HookRegistry};
38pub use llm::openai::RetryPolicy;
39pub use llm::{pricing_for, Completion, LlmProvider, ModelPricing, TokenUsage, ToolCall, ToolSpec};
40#[cfg(feature = "mcp")]
41pub use mcp::{
42    discover_mcp_servers, load_mcp_config, McpClient, McpPrompt, McpPromptArgument,
43    McpPromptMessage, McpResource, McpResourceContent, McpServer, McpServerConfig, McpTool,
44    McpToolSpec, ServerCapabilities,
45};
46#[cfg(feature = "mcp")]
47pub use mcp_server::{McpServerManager, McpServerRunner};
48pub use message::{Message, Role};
49pub use runner::AgentRunner;
50pub use session::SessionFile;
51pub use skills::{
52    discover_skills, skill_index, skills_for_injection, Skill, SkillMode, SkillParam, SkillRef,
53    SkillScript, SkillSection,
54};
55pub use tools::{Tool, ToolRegistry};
56pub use transcript::{TranscriptFile, TranscriptMeta};