caliban-provider 0.3.0

Provider-neutral message IR and trait for the caliban agent harness — internal crate for the caliban binary; no API stability, pin exact versions
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

//! Capability discovery types.

use serde::{Deserialize, Serialize};

/// The full set of capabilities offered by a model/provider combination.
// The many boolean fields are intentional; each represents a distinct yes/no capability.
#[allow(clippy::struct_excessive_bools)]
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
pub struct Capabilities {
    /// Maximum number of input tokens supported.
    pub max_input_tokens: u32,
    /// Maximum number of output tokens supported.
    pub max_output_tokens: u32,
    /// Whether the model accepts image inputs.
    pub vision: bool,
    /// The level of tool-use support.
    pub tool_use: ToolUseCapability,
    /// Whether extended thinking is supported.
    pub thinking: bool,
    /// The level of prompt-caching support.
    pub prompt_caching: PromptCachingCapability,
    /// Whether structured JSON output mode is supported.
    pub json_mode: bool,
    /// Whether token streaming is supported.
    pub streaming: bool,
    /// Whether stop sequences are supported.
    pub stop_sequences: bool,
    /// Whether top-k sampling is supported.
    pub top_k: bool,
    /// How system prompts are passed to this model.
    pub system_prompt: SystemPromptCapability,
    /// Whether the provider returns a structured refusal field.
    pub refusal_field: bool,
}

/// Level of tool-use support.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum ToolUseCapability {
    /// Tool use is not supported.
    None,
    /// A single tool call per turn.
    Basic,
    /// Multiple parallel tool calls per turn.
    ParallelCalls,
}

/// Level of prompt-caching support.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
#[serde(tag = "kind", rename_all = "snake_case")]
pub enum PromptCachingCapability {
    /// No prompt caching.
    None,
    /// The provider caches automatically without explicit markers.
    Automatic,
    /// The caller must mark breakpoints; carries the maximum number.
    Explicit {
        /// Maximum number of cache breakpoints allowed.
        max_breakpoints: u32,
    },
}

/// How the model/provider expects system prompts to be passed.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum SystemPromptCapability {
    /// Provider has a dedicated top-level `system` field.
    SeparateField,
    /// System prompts are passed as a message with `role: "system"`.
    SystemRole,
    /// System prompts are passed as a message with `role: "developer"`.
    DeveloperRole,
}

/// Metadata for a single model variant.
#[derive(Debug, Clone, PartialEq, Eq, Hash, Serialize, Deserialize)]
pub struct ModelInfo {
    /// Caliban-internal model identifier.
    pub id: String,
    /// The model identifier used in API requests.
    pub native_id: String,
    /// Human-readable display name.
    pub display_name: String,
    /// The capabilities of this model.
    pub capabilities: Capabilities,
}