import { protocolFailure } from './protocols.mjs'; const object = value => value && typeof value === 'object' && !Array.isArray(value); const fail = message => { throw protocolFailure('Messages 流:' + message); }; // Each block and the whole message must close before any tool becomes dispatchable. export function messagesStream(config = {}) { let message = null, active = null, deltaSeen = false, stopped = false, text = '', toolCount = 0; const blocks = []; return { consume(event) { if (event.type === 'ping') return; if (stopped) fail('终结后新增了事件。'); if (event.type === 'message_start') { const start = event.message; if (message || start?.type !== 'message' || start.role !== 'assistant' || typeof start.id !== 'string' || !start.id || !Array.isArray(start.content) || start.content.length || start.stop_reason != null) fail('创建事件重复或消息身份/内容无效。'); message = structuredClone(start); } else if (!message) fail('事件缺少原 message_start。'); else if (event.type === 'content_block_start') { if (deltaSeen || active !== null || !Number.isSafeInteger(event.index) || event.index !== blocks.length || config.executionMode !== 'unrestricted' && blocks.length >= 128) fail('内容块索引重复、逆序或上个块未完成。'); const block = event.content_block; if (!object(block) || !['text', 'tool_use', 'thinking', 'redacted_thinking'].includes(block.type)) fail('未接入的内容块类型。'); if (block.type === 'text' && typeof block.text !== 'string' || block.type === 'tool_use' && (!object(block.input) || typeof block.id !== 'string' || !block.id || typeof block.name !== 'string' || !block.name) || block.type === 'thinking' && (typeof block.thinking !== 'string' || block.signature !== undefined && typeof block.signature !== 'string') || block.type === 'redacted_thinking' && typeof block.data !== 'string') fail('初始内容块格式无效。'); if (block.type === 'tool_use' && (++toolCount > 12 && config.executionMode !== 'unrestricted' || blocks.some(item => item.block.id === block.id))) fail('工具数量超限或身份重复。'); // Thinking signatures normally arrive in a later signature_delta. // Final protocol normalization still requires a complete signature. const initial = structuredClone(block); if (initial.type === 'thinking') initial.signature ??= ''; blocks.push({ block: initial, json: '', jsonSeen: false, closed: false }); active = event.index; if (block.type === 'text') text += block.text; } else if (event.type === 'content_block_delta') { if (active === null || event.index !== active || deltaSeen || !object(event.delta)) fail('内容片段缺少所属未完成块。'); const entry = blocks[active], block = entry.block, delta = event.delta; if (block.type === 'text' && delta.type === 'text_delta' && typeof delta.text === 'string') { block.text += delta.text; text += delta.text; } else if (block.type === 'text' && delta.type === 'citations_delta' && object(delta.citation)) (block.citations ??= []).push(structuredClone(delta.citation)); else if (block.type === 'tool_use' && delta.type === 'input_json_delta' && typeof delta.partial_json === 'string') { if (Object.keys(block.input).length) fail('工具初始 input 与增量参数同时存在。'); entry.jsonSeen = true; entry.json += delta.partial_json; } else if (block.type === 'thinking' && delta.type === 'thinking_delta' && typeof delta.thinking === 'string') block.thinking += delta.thinking; else if (block.type === 'thinking' && delta.type === 'signature_delta' && typeof delta.signature === 'string') block.signature += delta.signature; else fail('增量类型与原内容块不一致或尚未接入。'); } else if (event.type === 'content_block_stop') { if (active === null || event.index !== active || deltaSeen) fail('块终结缺少所属原内容。'); const entry = blocks[active]; if (entry.jsonSeen) { try { entry.block.input = JSON.parse(entry.json); } catch { fail('工具参数不是完整 JSON。'); } if (!object(entry.block.input)) fail('工具参数必须是对象。'); } entry.closed = true; active = null; } else if (event.type === 'message_delta') { if (active !== null || !object(event.delta) || !object(event.usage)) fail('消息终结前内容块未完成或 delta/usage 无效。'); const reason = event.delta.stop_reason; if (deltaSeen && reason != null && reason !== message.stop_reason) fail('消息停止原因发生变化。'); if (reason != null) { message.stop_reason = reason; deltaSeen = true; } message.stop_sequence = event.delta.stop_sequence ?? message.stop_sequence; message.usage ??= {}; for (const [key, value] of Object.entries(event.usage)) if (value !== null && value !== undefined) { if (['input_tokens', 'output_tokens', 'cache_creation_input_tokens', 'cache_read_input_tokens'].includes(key) && (!Number.isSafeInteger(value) || value < 0 || typeof message.usage[key] === 'number' && value < message.usage[key])) fail('累计用量无效或倒退。'); message.usage[key] = structuredClone(value); } } else if (event.type === 'message_stop') { if (!deltaSeen || active !== null || blocks.some(entry => !entry.closed)) fail('缺少完整块或停止原因。'); stopped = true; message.content = blocks.map(entry => entry.block); } else fail('未接入的事件类型 ' + String(event.type).slice(0, 100) + '。'); }, get text() { return text; }, get tools() { return toolCount; }, get usage() { return message?.usage ?? null; }, get stopped() { return stopped; }, finish() { if (!stopped) throw protocolFailure('Messages 流断开或缺少 message_stop,工具未执行。', 'stream_interrupted'); return message; }, }; }