Skip to main content

acosmi/models/
stream_meta.rs

1//! Anthropic SSE 事件的 content block 元数据解析。端口自 `models/stream-meta.ts`
2//! (其端口自 `acosmi-sdk-go/stream_meta.go`)。
3//!
4//! 把 content_block_start 中的 index / type / acosmi_ephemeral 记入 `block_type_map`,
5//! 供 delta/stop 查表回填 [`crate::models::StreamEvent`] 的 blockIndex / blockType / ephemeral。
6//!
7//! - 惰性解析:只对 3 种 content_block_* 事件解 JSON,其他事件跳过。
8//! - 单流 map:由单 SSE 扫描循环拥有,无锁;stop 后删表项,防长流累积。
9
10use std::collections::HashMap;
11
12/// SDK 为单个 content block 缓存的元数据。
13#[derive(Debug, Clone, Default)]
14pub struct BlockMeta {
15    pub r#type: String,
16    pub ephemeral: bool,
17}
18
19/// 按 Anthropic SSE 事件类型解析 `data`,更新 `block_type_map`,返回 `(index, type, ephemeral)`。
20///
21/// 仅当事件为 content_block_start / content_block_delta / content_block_stop 时返回非空 type;
22/// 其他事件返回空 type,调用方据此判别是否填充 StreamEvent 元数据字段。
23/// JSON 失败 → `(0, "", false)`(不抛,对齐 TS catch)。
24pub fn extract_anthropic_block_meta(
25    event_type: &str,
26    data: &str,
27    block_type_map: &mut HashMap<i64, BlockMeta>,
28) -> (i64, String, bool) {
29    match event_type {
30        "content_block_start" => {
31            #[derive(serde::Deserialize)]
32            struct ContentBlock {
33                #[serde(default)]
34                r#type: Option<String>,
35                #[serde(default)]
36                acosmi_ephemeral: Option<bool>,
37            }
38            #[derive(serde::Deserialize)]
39            struct Payload {
40                #[serde(default)]
41                index: Option<i64>,
42                #[serde(default)]
43                content_block: Option<ContentBlock>,
44            }
45            let payload: Payload = match serde_json::from_str(data) {
46                Ok(p) => p,
47                Err(_) => return (0, String::new(), false),
48            };
49            let index = payload.index.unwrap_or(0);
50            let cb = payload.content_block;
51            let meta = BlockMeta {
52                r#type: cb
53                    .as_ref()
54                    .and_then(|c| c.r#type.clone())
55                    .unwrap_or_default(),
56                ephemeral: cb
57                    .as_ref()
58                    .and_then(|c| c.acosmi_ephemeral)
59                    .unwrap_or(false),
60            };
61            let out = (index, meta.r#type.clone(), meta.ephemeral);
62            block_type_map.insert(index, meta);
63            out
64        }
65        "content_block_delta" => {
66            let index = parse_index(data);
67            let meta = block_type_map.get(&index);
68            (
69                index,
70                meta.map(|m| m.r#type.clone()).unwrap_or_default(),
71                meta.map(|m| m.ephemeral).unwrap_or(false),
72            )
73        }
74        "content_block_stop" => {
75            let index = parse_index(data);
76            let meta = block_type_map.remove(&index);
77            (
78                index,
79                meta.as_ref().map(|m| m.r#type.clone()).unwrap_or_default(),
80                meta.as_ref().map(|m| m.ephemeral).unwrap_or(false),
81            )
82        }
83        _ => (0, String::new(), false),
84    }
85}
86
87/// 解析 `{"index": n}` 的 index 字段;失败/缺失 → 0(对齐 TS catch + `?? 0`)。
88fn parse_index(data: &str) -> i64 {
89    #[derive(serde::Deserialize)]
90    struct Payload {
91        #[serde(default)]
92        index: Option<i64>,
93    }
94    serde_json::from_str::<Payload>(data)
95        .ok()
96        .and_then(|p| p.index)
97        .unwrap_or(0)
98}