brazen 0.0.2

A stateless, swiss-army-knife adapter for every LLM provider and protocol.
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

//! The per-content-block projection of the Anthropic request (§2.5): one canonical
//! `Content` → one wire ContentBlockParam, the image-source shape, and the
//! text/image-only `tool_result.content` slot. `super::encode` projects each
//! message's content through [`content_block`]; the shared `slot_err` is the parent's.

use serde_json::{json, Value};

use crate::canonical::{CanonicalError, Content, ImageSource};

use super::slot_err;

/// One `Content` → one wire ContentBlockParam (§2.5). `Ok(None)` drops a block
/// that cannot be replayed (a signature-less `Thinking`, CR-2).
pub(super) fn content_block(c: &Content) -> Result<Option<Value>, CanonicalError> {
    Ok(Some(match c {
        Content::Text(t) => json!({"type": "text", "text": t}),
        Content::Image { source } => json!({"type": "image", "source": image_source(source)}),
        Content::ToolUse { id, name, input } => {
            json!({"type": "tool_use", "id": id, "name": name, "input": input})
        }
        Content::ToolResult {
            tool_use_id,
            content,
            is_error,
        } => {
            let mut v = json!({
                "type": "tool_result",
                "tool_use_id": tool_use_id,
                "content": tool_result_content(content)?,
            });
            if *is_error {
                v["is_error"] = json!(true); // omitted when false
            }
            v
        }
        Content::Thinking {
            text,
            signature: Some(sig),
        } => json!({"type": "thinking", "thinking": text, "signature": sig}),
        Content::Thinking {
            signature: None, ..
        } => return Ok(None),
        Content::RedactedThinking { data } => json!({"type": "redacted_thinking", "data": data}),
    }))
}

fn image_source(s: &ImageSource) -> Value {
    match s {
        ImageSource::Base64 { media_type, data } => {
            json!({"type": "base64", "media_type": media_type, "data": data})
        }
        ImageSource::Url { url } => json!({"type": "url", "url": url}),
    }
}

/// `tool_result.content` (§2.5): a text/image-only slot — any other nested
/// `Content` is unrepresentable and rejects with `ParseInput`.
fn tool_result_content(content: &[Content]) -> Result<Value, CanonicalError> {
    let mut blocks = Vec::new();
    for c in content {
        match c {
            Content::Text(t) => blocks.push(json!({"type": "text", "text": t})),
            Content::Image { source } => {
                blocks.push(json!({"type": "image", "source": image_source(source)}))
            }
            _ => return Err(slot_err("tool_result")),
        }
    }
    Ok(Value::Array(blocks))
}