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 session;
25pub mod skills;
26pub mod tools;
27pub mod transcript;
28
29pub use agent::PlanningMode;
30pub use agent::{Agent, AgentOutcome, FinishReason, StepEvent};
31pub use agent::{PermissionDecision, PermissionHook};
32pub use compact::Compactor;
33pub use config::Config;
34pub use error::{Error, Result};
35pub use hooks::ToolTimingHook;
36pub use hooks::{Hook, HookAction, HookEvent, HookRegistry};
37pub use llm::openai::RetryPolicy;
38pub use llm::{pricing_for, Completion, LlmProvider, ModelPricing, TokenUsage, ToolCall, ToolSpec};
39#[cfg(feature = "mcp")]
40pub use mcp::{
41    discover_mcp_servers, load_mcp_config,
42    McpClient, McpPrompt, McpPromptArgument, McpPromptMessage, McpResource, McpResourceContent,
43    McpServer, McpServerConfig, McpTool, McpToolSpec, ServerCapabilities,
44};
45#[cfg(feature = "mcp")]
46pub use mcp_server::{McpServerManager, McpServerRunner};
47pub use message::{Message, Role};
48pub use session::SessionFile;
49pub use skills::{
50    discover_skills, skill_index, skills_for_injection, Skill, SkillMode, SkillParam, SkillRef,
51    SkillScript, SkillSection,
52};
53pub use tools::{Tool, ToolRegistry};
54pub use transcript::{TranscriptFile, TranscriptMeta};