Skip to main content

capo_agent/
lib.rs

1//! # capo-agent
2//!
3//! Library crate for the Capo coding agent. See the design spec at
4//! `docs/superpowers/specs/2026-04-23-capo-design.md`.
5//!
6//! ## Imports
7//!
8//! Prefer the crate-root re-exports for stable protocol types:
9//!
10//! ```ignore
11//! use capo_agent::{App, AppBuilder, UiEvent, Command, UiToolResult, ProgressChunk};
12//! ```
13//!
14//! Submodule paths (`capo_agent::events::UiEvent`, `capo_agent::tools::ToolCtx`)
15//! are available but considered semver-unstable within 0.x; prefer the
16//! re-exports above.
17
18#![forbid(unsafe_code)]
19
20pub mod agent;
21pub mod app;
22pub mod auth;
23pub mod config;
24pub mod context_files;
25pub mod error;
26pub mod events;
27pub mod extensions;
28pub mod llm;
29pub mod mcp;
30pub mod model;
31pub mod paths;
32pub mod permissions;
33pub mod protocol;
34pub mod session;
35pub mod settings;
36pub mod skills;
37#[cfg(feature = "test-support")]
38pub mod test_support;
39pub mod tools;
40pub mod user_message;
41
42pub use app::{App, AppBuilder};
43pub use auth::{load as load_auth, save_with_mode as save_auth, Auth, ProviderAuth};
44pub use config::Config;
45pub use context_files::{assemble_system_prompt, load_project_context_files, ContextFile};
46pub use error::{AppError, Result};
47pub use events::{
48    Command, PermissionChoice, PermissionResolution, ProgressChunk, UiEvent, UiToolResult,
49};
50pub use extensions::{
51    load_extensions_manifest, Action as ExtensionAction, Event as ExtensionEvent,
52    EventName as ExtensionEventName, ExtensionDiagnostic, ExtensionEntry, ExtensionRegistry,
53    RegisteredExtension,
54};
55pub use mcp::{McpConfig, McpServerConfig};
56pub use model::ModelId;
57pub use motosan_agent_loop::{BranchNode, BranchTree, EntryId, Message, Role};
58pub use paths::agent_dir;
59pub use permissions::{Decision, NoOpPermissionGate, PermissionGate, PermissionRequest};
60pub use session::{encode_cwd, hydrate_read_files, SessionId, SessionLookup, SessionPaths};
61pub use settings::{
62    CliOverrides, LlmProviderKind, LoggingSettings, ModelSettings, SessionSettings, Settings,
63    UiSettings,
64};
65pub use skills::{
66    load_all as load_skills, load_from_dir as load_skills_from_dir, LoadSkillsResult, Skill,
67    SkillDiagnostic, SkillSource,
68};
69pub use user_message::{Attachment, AttachmentError, AttachmentErrorKind, UserMessage};