nucel-agent-claude-code 0.2.0

Claude Code provider for Nucel agent-sdk — subprocess wrapper for claude CLI
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

//! Extended protocol tests for Claude Code.

use nucel_agent_claude_code::ClaudeCodeExecutor;
use nucel_agent_core::*;
use std::path::Path;

#[test]
fn claude_executor_type() {
    assert_eq!(
        ClaudeCodeExecutor::new().executor_type(),
        ExecutorType::ClaudeCode
    );
}

#[test]
fn claude_executor_with_api_key() {
    let exec = ClaudeCodeExecutor::with_api_key("sk-ant-test");
    assert_eq!(exec.executor_type(), ExecutorType::ClaudeCode);
}

#[test]
fn claude_capabilities() {
    let caps = ClaudeCodeExecutor::new().capabilities();
    assert!(caps.autonomous_mode);
    assert!(caps.token_usage);
    assert!(caps.mcp_support);
    assert!(caps.session_resume, "Claude Code supports --resume flag");
    assert!(!caps.structured_output);
}

#[test]
fn claude_availability_checks_cli() {
    let avail = ClaudeCodeExecutor::new().availability();
    // Either available or has a reason about the CLI
    if !avail.available {
        assert!(avail.reason.unwrap().contains("claude"));
    }
}

#[test]
fn claude_accepts_new_permission_modes_without_panic() {
    // Regression: ensure new core variants compile against the claude-code
    // executor without exhaustive-match breakage.
    for mode in [
        PermissionMode::Prompt,
        PermissionMode::AcceptEdits,
        PermissionMode::BypassPermissions,
        PermissionMode::RejectAll,
        PermissionMode::DontAsk,
        PermissionMode::Auto,
    ] {
        let cfg = SpawnConfig {
            permission_mode: Some(mode),
            ..Default::default()
        };
        // We're not actually spawning — just exercising the config plumbing.
        assert_eq!(cfg.permission_mode, Some(mode));
    }
}

#[tokio::test]
async fn claude_spawn_returns_cli_not_found_when_missing() {
    // If `claude` CLI is missing we should get a CliNotFound error rather
    // than panicking — this also guards against silently swallowing the
    // not-found io::ErrorKind.
    if ClaudeCodeExecutor::new().availability().available {
        // CLI is present on this machine; skip the negative assertion.
        return;
    }
    let exec = ClaudeCodeExecutor::new();
    let result = exec
        .spawn(
            Path::new("/tmp"),
            "test",
            &SpawnConfig {
                budget_usd: Some(1.0),
                ..Default::default()
            },
        )
        .await;
    assert!(result.is_err());
    let err = result.unwrap_err();
    assert!(
        matches!(err, AgentError::CliNotFound { .. }),
        "expected CliNotFound, got: {err}"
    );
}

#[test]
fn claude_capabilities_advertise_streaming_hooks_caching_thinking() {
    let caps = ClaudeCodeExecutor::new().capabilities();
    assert!(caps.streaming, "Claude Code should advertise streaming");
    assert!(caps.hooks, "Claude Code should advertise hooks");
    assert!(caps.prompt_caching, "Claude Code should advertise prompt_caching");
    assert!(caps.extended_thinking, "Claude Code should advertise extended_thinking");
}

#[test]
fn claude_accepts_hook_config_and_thinking_budget_in_spawn_config() {
    let cfg = SpawnConfig {
        hook_config: Some(HookConfig {
            pre_tool_use: Some(HookHandler::new("/bin/echo pre").with_matcher("Bash")),
            ..Default::default()
        }),
        cache_breakpoints: vec![CachePoint::ephemeral("system")],
        thinking_budget: Some(8_192),
        ..Default::default()
    };
    // Just exercising the config plumbing without spawning.
    assert!(cfg.hook_config.is_some());
    assert_eq!(cfg.cache_breakpoints.len(), 1);
    assert_eq!(cfg.thinking_budget, Some(8_192));
}