wasm-agent 0.2.0

A ReAct and native tool-calling agent loop with no I/O, for WASM, edge workers and plugins: parse model replies, dispatch tools, keep history
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

// SPDX-License-Identifier: MIT
use thiserror::Error;

/// All errors that can occur in the wasm-agent ReAct loop.
#[derive(Debug, Error, Clone)]
#[non_exhaustive]
pub enum AgentError {
    /// The agent ran the maximum number of iterations without producing a final answer.
    #[error("Max iterations ({0}) reached without final answer")]
    MaxIterationsExceeded(u32),
    /// A tool was requested that does not exist in the registry.
    #[error("Tool '{name}' not found in registry")]
    ToolNotFound {
        /// Tool name.
        name: String,
    },
    /// A tool was found but its execution failed.
    #[error("Tool '{name}' execution failed: {reason}")]
    ToolFailed {
        /// Tool name.
        name: String,
        /// What went wrong.
        reason: String,
    },
    /// The LLM response could not be parsed as a valid ReAct step.
    #[error("Parse error in ReAct step: {0}")]
    ParseError(String),
    /// The agent exceeded its wall-clock time budget.
    #[error("Timeout: agent exceeded {timeout_ms}ms budget")]
    Timeout {
        /// The time budget in milliseconds.
        timeout_ms: u64,
    },
    /// The conversation history exceeded its token budget.
    #[error("History overflow: {size} tokens exceeds context limit {limit}")]
    HistoryOverflow {
        /// Tokens the history would have had.
        size: usize,
        /// The token limit.
        limit: usize,
    },
    /// A value could not be serialized.
    #[error("Serialization error: {0}")]
    Serialization(String),
    /// A tool was registered with an invalid signature.
    #[error("Invalid tool signature: {0}")]
    InvalidToolSignature(String),
}