pawan-core 0.4.4

Pawan (पवन) — Core library: agent, tools, config, healing
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
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124

//! # Pawan (पवन) - Self-Healing CLI Coding Agent
//!
//! Core library for the Pawan coding agent. Provides:
//!
//! - **Agent**: Tool-calling loop engine with multi-provider LLM support
//! - **Tools**: File operations, bash execution, git, search
//! - **Healing**: Automatic detection and repair of compilation errors, test failures, warnings
//! - **Config**: TOML-based configuration with provider/model management
//!
//! ## Architecture
//!
//! - `pawan-core` (this crate): Library with zero dirmacs dependencies
//! - `pawan-cli`: Binary with TUI and CLI interface
//!
//! ## Quick Start
//!
//! ```bash
//! pawan                    # Interactive TUI mode
//! pawan heal               # Auto-fix compilation issues
//! pawan task "description" # Execute a coding task
//! pawan run "prompt"       # Headless single-prompt execution
//! ```

pub mod agent;
pub mod bootstrap;
pub mod compaction;
pub mod config;
pub mod coordinator;
pub mod credentials;
pub mod eruka_bridge;
pub mod handoff;
pub mod init;
pub mod healing;
pub mod skill_distillation;
pub mod skills;
pub mod tasks;
pub mod tools;

pub use agent::PawanAgent;
pub use agent::{AgentEvent, FinishReason, TokenUsageInfo};
pub use config::PawanConfig;

/// Error types for Pawan
///
/// Represents all possible error conditions that can occur in Pawan operations.
#[derive(Debug, thiserror::Error)]
pub enum PawanError {
    /// I/O error
    ///
    /// Represents errors related to file operations, network operations, or other I/O.
    #[error("IO error: {0}")]
    Io(#[from] std::io::Error),

    /// Configuration error
    ///
    /// Represents errors in Pawan configuration, such as invalid settings or missing required values.
    #[error("Configuration error: {0}")]
    Config(String),

    /// Tool execution error
    ///
    /// Represents errors that occur when executing tools (file operations, bash commands, etc.).
    #[error("Tool execution error: {0}")]
    Tool(String),

    /// Agent error
    ///
    /// Represents errors in the agent's logic or execution flow.
    #[error("Agent error: {0}")]
    Agent(String),

    /// LLM error
    ///
    /// Represents errors from the language model backend or API.
    #[error("LLM error: {0}")]
    Llm(String),

    /// Git error
    ///
    /// Represents errors from Git operations.
    #[error("Git error: {0}")]
    Git(String),

    /// Parse error
    ///
    /// Represents errors in parsing JSON, TOML, or other structured data.
    #[error("Parse error: {0}")]
    Parse(String),

    /// Timeout error
    ///
    /// Represents errors when an operation exceeds its time limit.
    #[error("Timeout: {0}")]
    Timeout(String),

    /// Not found error
    ///
    /// Represents errors when a requested resource (file, tool, etc.) is not found.
    #[error("Not found: {0}")]
    NotFound(String),
}

/// Result type alias for Pawan operations
///
/// A convenience type alias that represents the result of Pawan operations,
/// where success contains the desired value and failure contains a PawanError.
pub type Result<T> = std::result::Result<T, PawanError>;

/// Version information
pub const VERSION: &str = env!("CARGO_PKG_VERSION");

/// Default model for coding tasks (Mistral Small 4 119B MoE via NVIDIA NIM)
/// Default model — Qwen3.5 122B (S tier, 383ms, solid tool calling).
/// Override via pawan.toml or PAWAN_MODEL env var.
pub const DEFAULT_MODEL: &str = "qwen/qwen3.5-122b-a10b";

/// Default NVIDIA API URL
pub const DEFAULT_NVIDIA_API_URL: &str = "https://integrate.api.nvidia.com/v1";

/// Maximum iterations for tool calling loops
pub const MAX_TOOL_ITERATIONS: usize = 50;

/// Default timeout for bash commands (in seconds)
pub const DEFAULT_BASH_TIMEOUT: u64 = 120;