nucel-agent-core 0.1.2

Core traits and types for Nucel agent-sdk — provider-agnostic AI coding agent abstraction
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

# nucel-agent-core

Core traits and types for [Nucel Agent SDK](https://github.com/nucel-dev/agent-sdk) — provider-agnostic AI coding agent abstraction.

## What's in this crate

- **`AgentExecutor` trait** — `spawn()`, `resume()`, `capabilities()`, `availability()`
- **`AgentSession`** — follow-up queries, cost tracking, cleanup
- **Types** — `AgentCost`, `AgentResponse`, `AgentError`, `ExecutorType`, `PermissionMode`, `SpawnConfig`

## Usage

This crate is not used directly — import `nucel-agent-sdk` instead:

```toml
[dependencies]
nucel-agent-sdk = "0.1"
```

```rust
use nucel_agent_sdk::{AgentExecutor, ClaudeCodeExecutor, SpawnConfig};

let executor = ClaudeCodeExecutor::new();
let session = executor.spawn(
    std::path::Path::new("/my/repo"),
    "Fix the failing tests",
    &SpawnConfig {
        model: Some("claude-opus-4-6".into()),
        budget_usd: Some(5.0),
        ..Default::default()
    },
).await?;

let resp = session.query("Did CI pass?").await?;
println!("{}", resp.content);

let cost = session.total_cost().await?;
println!("Total: ${:.4}", cost.total_usd);
```

## Supported Providers

| Provider | Crate | CLI/Server |
|----------|-------|------------|
| Claude Code | `nucel-agent-claude-code` | `claude` CLI |
| Codex | `nucel-agent-codex` | `codex` CLI |
| OpenCode | `nucel-agent-opencode` | `opencode serve` |

## License

Apache-2.0