agentlib-core 0.1.0

Core runtime and foundational traits for the AgentLib framework
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

# agentlib-core

The foundational crate for the AgentLib framework. It defines the core traits, types, and runtime logic required to build and execute AI agents.

## Core Components

- **AgentInstance**: The primary runtime for an agent, managing state, tools, and middleware.
- **Traits**:
    - `Agent`: Define the identity and tool registration for your agent.
    - `ModelProvider`: Interface for integrating any LLM.
    - `MemoryProvider`: Interface for persistent or ephemeral conversation storage.
    - `ReasoningEngine`: Abstraction for different thinking strategies.
    - `Tool`: Contract for extending agent capabilities.
- **Middleware System**: Intercept and modify execution at different scopes (Run, Step, Tool).

## Usage

```rust
use agentlib_core::{create_agent, Agent};
use std::sync::Arc;

struct MyAgent;
impl Agent for MyAgent {
    fn name(&self) -> &str { "core-agent" }
    fn register_tools(self: Arc<Self>, _registry: &mut agentlib_core::ToolRegistry) {}
}

let agent = create_agent(MyAgent);
```

## Features

- Type-safe execution context.
- Modular provider-based architecture.
- Built-in token usage tracking.
- Context-aware tool execution.