Skip to main content

acosmi/models/adapters/
mod.rs

1//! 双格式 adapter 路由。端口自 `models/adapters/index.ts`
2//! (其端口自 `acosmi-sdk-go/adapter.go` v0.19.0)。
3//!
4//! SDK 层按上游托管模型元数据选路:
5//!   preferred_format == "anthropic" → AnthropicAdapter → POST /managed-models/:id/anthropic
6//!   preferred_format == "openai"    → OpenAIAdapter    → POST /managed-models/:id/chat
7//!
8//! SDK 只负责:格式路由 + 请求结构转换 + 响应结构转换。
9//! 厂商特定协议差异(endpoint/auth/region/字段裁剪)由 Nexus Gateway Profile 处理。
10//!
11//! ## 红线(双产品消费)
12//! AnthropicAdapter + OpenAIAdapter 等地位,不可合并/降级。
13//!
14//! ## Rust 设计
15//! TS `ProviderAdapter` interface 有恰两个**无状态**实现,Rust 用 `enum Adapter`
16//! (`Anthropic` / `OpenAI`)+ `impl` 方法,比 `Box<dyn>` 干净且零分配。
17//! 方法签名 1:1 对齐 TS:`format` / `endpoint_suffix` / `build_request_body`(返回
18//! `serde_json::Map<String,Value>` = TS `Record`)/ `parse_response`(→ `ChatResponse`)/
19//! `parse_stream_line`(→ `(StreamEvent, bool /*done*/)`)。
20
21pub mod anthropic;
22pub mod openai;
23
24use super::types::{ChatRequest, ChatResponse, ManagedModel, ModelCapabilities, StreamEvent};
25use crate::shared::errors::Result;
26use serde_json::{Map, Value};
27
28/// 标识请求格式。对齐 TS `enum ProviderFormat { Anthropic=0, OpenAI=1 }`。
29#[derive(Debug, Clone, Copy, PartialEq, Eq)]
30#[repr(i32)]
31pub enum ProviderFormat {
32    /// Anthropic 原生格式。
33    Anthropic = 0,
34    /// OpenAI 兼容格式。
35    OpenAI = 1,
36}
37
38/// 将 ChatRequest 转换为特定格式的 adapter。两个无状态实现的 enum 等价 TS
39/// `ProviderAdapter` interface 的两个 class。
40#[derive(Debug, Clone, Copy, PartialEq, Eq)]
41pub enum Adapter {
42    /// Anthropic 原生格式 adapter。
43    Anthropic,
44    /// OpenAI 兼容格式 adapter(所有非 Anthropic 厂商)。
45    OpenAI,
46}
47
48impl Adapter {
49    /// 此 adapter 使用的请求格式。
50    pub fn format(&self) -> ProviderFormat {
51        match self {
52            Adapter::Anthropic => ProviderFormat::Anthropic,
53            Adapter::OpenAI => ProviderFormat::OpenAI,
54        }
55    }
56
57    /// API 路径后缀。Anthropic: `/anthropic`,OpenAI: `/chat`。
58    pub fn endpoint_suffix(&self) -> &'static str {
59        match self {
60            Adapter::Anthropic => "/anthropic",
61            Adapter::OpenAI => "/chat",
62        }
63    }
64
65    /// 将 ChatRequest 转换为 HTTP body(`serde_json::Map` → JSON)。`caps` 用于条件化字段注入。
66    pub fn build_request_body(
67        &self,
68        caps: &ModelCapabilities,
69        req: &ChatRequest,
70    ) -> Map<String, Value> {
71        match self {
72            Adapter::Anthropic => anthropic::build_request_body(caps, req),
73            Adapter::OpenAI => openai::build_request_body(caps, req),
74        }
75    }
76
77    /// 解析同步响应 body 为 [`ChatResponse`]。
78    pub fn parse_response(&self, body: &[u8]) -> Result<ChatResponse> {
79        match self {
80            Adapter::Anthropic => anthropic::parse_response(body),
81            Adapter::OpenAI => openai::parse_response(body),
82        }
83    }
84
85    /// 解析一行 SSE data 为 [`StreamEvent`]。返回 `(event, done)`;
86    /// `done=true` 表示流结束(`[DONE]` 或 message_stop)。
87    pub fn parse_stream_line(&self, event_type: &str, data: &str) -> Result<(StreamEvent, bool)> {
88        match self {
89            Adapter::Anthropic => Ok(anthropic::parse_stream_line(event_type, data)),
90            Adapter::OpenAI => openai::parse_stream_line(event_type, data),
91        }
92    }
93}
94
95/// 根据 provider 返回对应的 adapter(v0.5.0 遗留 API,向后兼容)。
96/// 新代码应使用 [`get_adapter_for_model`]。
97///
98/// `anthropic` / `acosmi` → AnthropicAdapter;其他 → OpenAIAdapter。
99pub fn get_adapter(provider: &str) -> Adapter {
100    match provider.to_lowercase().as_str() {
101        "anthropic" | "acosmi" => Adapter::Anthropic,
102        _ => Adapter::OpenAI,
103    }
104}
105
106/// 按 [`ManagedModel`] 的 `preferred_format` / `supported_formats` 选择 adapter。
107///
108/// 决策顺序(逐字对齐 `adapters/index.ts`):
109///  1. `preferred_format` 非空 **且** 该格式在 `supported_formats` 内(或 `supported_formats`
110///     未声明)→ 按其值返回(anthropic | openai)。
111///  2. `supported_formats` 含 "anthropic" → AnthropicAdapter。
112///  3. `supported_formats` 含 "openai" → OpenAIAdapter。
113///  4. 两字段均空(旧上游)→ 回落 provider 名硬编码(原 `get_adapter` 行为)。
114///
115/// 格式一致性护栏:`preferred_format` 仅在确被 `supported_formats` 收录时才采信,
116/// 防止上游元数据漂移把 SDK 路由到模型并不支持的格式端点。
117///
118/// # Examples
119///
120/// ```
121/// use acosmi::{get_adapter_for_model, Adapter, ManagedModel};
122///
123/// let m = ManagedModel { preferred_format: Some("openai".into()), ..Default::default() };
124/// assert_eq!(get_adapter_for_model(&m), Adapter::OpenAI);
125/// ```
126pub fn get_adapter_for_model(m: &ManagedModel) -> Adapter {
127    let mut has_anthropic = false;
128    let mut has_openai = false;
129    if let Some(formats) = &m.supported_formats {
130        for f in formats {
131            match f.trim().to_lowercase().as_str() {
132                "anthropic" => has_anthropic = true,
133                "openai" => has_openai = true,
134                _ => {}
135            }
136        }
137    }
138    let declared = has_anthropic || has_openai;
139
140    let pref = m
141        .preferred_format
142        .as_deref()
143        .unwrap_or("")
144        .trim()
145        .to_lowercase();
146    // preferred_format 仅在确被 supported_formats 收录(或未声明)时采信。
147    match pref.as_str() {
148        "anthropic" if !declared || has_anthropic => return Adapter::Anthropic,
149        "openai" if !declared || has_openai => return Adapter::OpenAI,
150        _ => {}
151    }
152
153    if has_anthropic {
154        return Adapter::Anthropic;
155    }
156    if has_openai {
157        return Adapter::OpenAI;
158    }
159
160    // 旧上游未填字段:回落到 provider 名硬编码(向后兼容)。
161    get_adapter(&m.provider.to_lowercase())
162}
163
164#[cfg(test)]
165mod tests {
166    use super::*;
167
168    fn model(
169        provider: &str,
170        supported: Option<Vec<&str>>,
171        preferred: Option<&str>,
172    ) -> ManagedModel {
173        ManagedModel {
174            provider: provider.to_string(),
175            supported_formats: supported.map(|v| v.iter().map(|s| s.to_string()).collect()),
176            preferred_format: preferred.map(|s| s.to_string()),
177            ..Default::default()
178        }
179    }
180
181    #[test]
182    fn route_preferred_anthropic_supported() {
183        let m = model(
184            "deepseek",
185            Some(vec!["anthropic", "openai"]),
186            Some("anthropic"),
187        );
188        assert_eq!(get_adapter_for_model(&m), Adapter::Anthropic);
189    }
190
191    #[test]
192    fn route_preferred_conflicts_supported_falls_through() {
193        // 护栏:preferred=anthropic 但 supported=[openai] → 不采信 preferred,回落 hasOpenAI。
194        let m = model("acosmi", Some(vec!["openai"]), Some("anthropic"));
195        assert_eq!(get_adapter_for_model(&m), Adapter::OpenAI);
196    }
197
198    #[test]
199    fn route_preferred_openai_conflicts_falls_through() {
200        let m = model("anthropic", Some(vec!["anthropic"]), Some("openai"));
201        assert_eq!(get_adapter_for_model(&m), Adapter::Anthropic);
202    }
203
204    #[test]
205    fn route_preferred_when_supported_undeclared_is_trusted() {
206        // supported_formats 未声明 → preferred 被采信。
207        let m = model("deepseek", None, Some("anthropic"));
208        assert_eq!(get_adapter_for_model(&m), Adapter::Anthropic);
209    }
210
211    #[test]
212    fn route_supported_only_anthropic() {
213        let m = model("deepseek", Some(vec!["anthropic"]), None);
214        assert_eq!(get_adapter_for_model(&m), Adapter::Anthropic);
215    }
216
217    #[test]
218    fn route_fallback_to_provider_name() {
219        // 两字段均空 → provider 名硬编码。
220        assert_eq!(
221            get_adapter_for_model(&model("anthropic", None, None)),
222            Adapter::Anthropic
223        );
224        assert_eq!(
225            get_adapter_for_model(&model("acosmi", None, None)),
226            Adapter::Anthropic
227        );
228        assert_eq!(
229            get_adapter_for_model(&model("deepseek", None, None)),
230            Adapter::OpenAI
231        );
232    }
233
234    #[test]
235    fn endpoint_suffix_and_format() {
236        assert_eq!(Adapter::Anthropic.endpoint_suffix(), "/anthropic");
237        assert_eq!(Adapter::OpenAI.endpoint_suffix(), "/chat");
238        assert_eq!(Adapter::Anthropic.format(), ProviderFormat::Anthropic);
239        assert_eq!(Adapter::OpenAI.format(), ProviderFormat::OpenAI);
240    }
241}