import { randomUUID } from "node:crypto"; import { parseToolCallsFromContent, type ToolCall } from "./tool-call-parser"; export interface StreamUsage { prompt_tokens: number; completion_tokens: number; reasoning_tokens?: number; cache_read_tokens?: number; cache_write_tokens?: number; } export const createToolCallStream = ( reader: ReadableStreamDefaultReader, onUsage?: (usage: StreamUsage) => void, onFirstToken?: () => void ): ReadableStream => { const decoder = new TextDecoder(); const encoder = new TextEncoder(); let buffer = ""; let pendingEventLines: string[] = []; let visibleContentBuffer = ""; let toolCallsFound = false; let usageTracked = false; let thinkCarry = ""; let inThink = false; let emittedLines = 0; let downstreamClosed = false; let firstTokenTracked = false; const contentHistory = new Map(); const reasoningHistory = new Map(); const replayCursors = new Map(); const tearDownUpstream = async (): Promise => { try { await reader.cancel(); } catch { // upstream already torn down; ignore. } }; const thinkingOpenPrefixes = [" { if (!suffix.startsWith("<")) return null; const closeIndex = suffix.indexOf(">"); if (closeIndex < 0) return null; const tag = suffix.slice(0, closeIndex + 1); if (/^<(think|thinking|analysis)(?:\s+[^>]*)?>$/i.test(tag)) return { kind: "open", length: closeIndex + 1 }; if (/^<\/(think|thinking|analysis)(?:\s+[^>]*)?>$/i.test(tag)) return { kind: "close", length: closeIndex + 1 }; return null; }; const thinkingTagPrefixIsPartial = (suffix: string): boolean => { const lower = suffix.toLowerCase(); if (!lower.startsWith("<")) return false; for (const prefix of thinkingAllPrefixes) { if (prefix.startsWith(lower)) { return true; } if (lower.startsWith(prefix)) { const next = lower[prefix.length]; if (!next) return true; if ( next === ">" || next === " " || next === "/" || next === "\t" || next === "\n" || next === "\r" ) return true; } } return false; }; const isThinkingTag = (suffix: string): { kind: "open" | "close"; length: number } | null => { const match = getThinkingTagLength(suffix); if (!match) return null; return match; }; const stripToolXmlDelta = (text: string): string => { return text .replace(/[\s\S]*?<\/tool_call>/gi, "") .replace(/[\s\S]*?<\/use_mcp[\s_]*tool>/gi, ""); }; const normalizeTextDelta = ( history: Map, key: string, text: string, forceSnapshot = false ): string => { if (!text) return text; const previous = history.get(key) ?? { text: "", snapshot: forceSnapshot }; const replayCursor = replayCursors.get(key); if (replayCursor !== undefined) { const expected = previous.text.slice(replayCursor, replayCursor + text.length); if (expected === text) { const nextCursor = replayCursor + text.length; if (nextCursor >= previous.text.length) replayCursors.delete(key); else replayCursors.set(key, nextCursor); return ""; } replayCursors.delete(key); } const isCumulative = previous.text.length > 0 && text.length >= previous.text.length && text.startsWith(previous.text); const shouldSlice = forceSnapshot || previous.snapshot || isCumulative; if (shouldSlice) { history.set(key, { text, snapshot: true }); return isCumulative ? text.slice(previous.text.length) : text; } if (previous.text.length > text.length && previous.text.startsWith(text)) { replayCursors.set(key, text.length); return ""; } history.set(key, { text: previous.text + text, snapshot: false }); return text; }; const rewriteThinkDelta = ( deltaText: string, defaultToReasoning = false ): { content: string; reasoningAppend: string } => { const combined = thinkCarry + (deltaText ?? ""); const combinedLower = combined.toLowerCase(); let carryIndex = combined.length; let index = 0; let contentOut = ""; let reasoningOut = ""; while (index < carryIndex) { const remainingLower = combinedLower.slice(index); if (combined[index] === "<") { const thinkTag = isThinkingTag(remainingLower); if (thinkTag?.kind === "open") { inThink = true; index += thinkTag.length; continue; } if (thinkTag?.kind === "close") { if (!inThink) { const before = contentOut.trim(); if (before) { reasoningOut += contentOut; contentOut = ""; } } inThink = false; index += thinkTag.length; continue; } if (thinkingTagPrefixIsPartial(remainingLower)) { carryIndex = index; break; } } const ch = combined[index] ?? ""; if (inThink || defaultToReasoning) { reasoningOut += ch; } else { contentOut += ch; } index += 1; } thinkCarry = carryIndex < combined.length ? combined.slice(carryIndex) : ""; return { content: contentOut, reasoningAppend: reasoningOut, }; }; const enqueueLine = ( controller: ReadableStreamDefaultController, line: string ): void => { if (downstreamClosed) return; try { controller.enqueue(encoder.encode(`${line}\n`)); emittedLines += 1; } catch { downstreamClosed = true; void tearDownUpstream(); } }; const buildToolCallChunk = (toolCalls: ToolCall[]): string => { const payload = { id: `chatcmpl-${randomUUID().slice(0, 8)}`, choices: [ { index: 0, delta: { tool_calls: toolCalls }, finish_reason: "tool_calls", }, ], }; return `data: ${JSON.stringify(payload)}`; }; const buildFlushChunk = (payload: { content?: string; reasoning_content?: string; }): string | null => { const content = payload.content ?? ""; const reasoning = payload.reasoning_content ?? ""; if (!content && !reasoning) return null; const delta: Record = {}; if (content) delta["content"] = content; if (reasoning) delta["reasoning_content"] = reasoning; return `data: ${JSON.stringify({ id: `chatcmpl-${randomUUID().slice(0, 8)}`, choices: [{ index: 0, delta }] })}`; }; const flushThinkCarry = (controller: ReadableStreamDefaultController): void => { if (!thinkCarry) return; const tail = thinkCarry; thinkCarry = ""; const carryLooksLikeThink = thinkingTagPrefixIsPartial(tail.trim()); const chunk = inThink || carryLooksLikeThink ? buildFlushChunk({ reasoning_content: stripToolXmlDelta(tail) }) : buildFlushChunk({ content: stripToolXmlDelta(tail) }); if (chunk) enqueueLine(controller, chunk); }; const parseUsage = (data: Record): void => { if (usageTracked || !onUsage) return; const usage = data["usage"] as Record | undefined; if (usage && (usage["prompt_tokens"] || usage["completion_tokens"])) { onUsage({ prompt_tokens: usage["prompt_tokens"] ?? 0, completion_tokens: usage["completion_tokens"] ?? 0, reasoning_tokens: (usage["reasoning_tokens"] as number | undefined) ?? (usage["completion_tokens_details"] as Record | undefined)?.[ "reasoning_tokens" ] ?? 0, cache_read_tokens: (usage["prompt_tokens_details"] as Record | undefined)?.[ "cached_tokens" ] ?? 0, cache_write_tokens: 0, }); usageTracked = true; } }; const trackFirstToken = (): void => { if (firstTokenTracked) return; firstTokenTracked = true; onFirstToken?.(); }; const maybeInjectToolCalls = (controller: ReadableStreamDefaultController): void => { if (toolCallsFound || !visibleContentBuffer) return; const parsed = parseToolCallsFromContent(visibleContentBuffer); if (parsed.length > 0) { enqueueLine(controller, buildToolCallChunk(parsed)); toolCallsFound = true; } }; type ReaderResult = { done: boolean; value?: Uint8Array | undefined }; return new ReadableStream({ async start(controller): Promise { void controller; }, async pull(controller): Promise { const flushEvent = (lines: string[]): void => { if (lines.length === 0) return; const dataLines: string[] = []; const otherLines: string[] = []; for (const rawLine of lines) { const trimmedStart = rawLine.trimStart(); if (trimmedStart.startsWith("data:")) { dataLines.push(trimmedStart.slice("data:".length).trimStart()); } else if (rawLine.length > 0) { otherLines.push(rawLine); } } if (dataLines.length === 0) { for (const outLine of lines) { enqueueLine(controller, outLine); } return; } const data = dataLines.join("\n").trim(); if (data === "[DONE]") { maybeInjectToolCalls(controller); flushThinkCarry(controller); for (const outLine of otherLines) { enqueueLine(controller, outLine); } enqueueLine(controller, "data: [DONE]"); return; } let parsed: Record | null = null; try { parsed = JSON.parse(data) as Record; } catch { parsed = null; } if (!parsed) { for (const outLine of lines) { enqueueLine(controller, outLine); } return; } parseUsage(parsed); const choices = parsed["choices"]; if (Array.isArray(choices)) { for (const [choiceIndex, choice] of choices.entries()) { const choiceRecord = choice as Record; const hasDelta = choiceRecord["delta"] && typeof choiceRecord["delta"] === "object"; const delta = (hasDelta ? choiceRecord["delta"] : choiceRecord["message"]) as | Record | undefined; if (!delta) continue; const toolCalls = delta["tool_calls"]; if (Array.isArray(toolCalls) && toolCalls.length > 0) { toolCallsFound = true; trackFirstToken(); } const rawContent = typeof delta["content"] === "string" ? String(delta["content"]) : ""; const content = normalizeTextDelta( contentHistory, `${choiceIndex}:content`, rawContent, !hasDelta ); const reasoningRaw = typeof delta["reasoning_content"] === "string" ? normalizeTextDelta( reasoningHistory, `${choiceIndex}:reasoning`, String(delta["reasoning_content"]), !hasDelta ) : ""; if (content || reasoningRaw) trackFirstToken(); let reasoning = ""; let reasoningFromContent = ""; if (content) { visibleContentBuffer += content; const rewritten = rewriteThinkDelta(content, false); const cleanedContent = stripToolXmlDelta(rewritten.content); if (cleanedContent) { delta["content"] = cleanedContent; } else if ("content" in delta) { delete delta["content"]; } reasoningFromContent = rewritten.reasoningAppend; } else if (rawContent && "content" in delta) { delete delta["content"]; } if (reasoningRaw) { const rewrittenReasoning = rewriteThinkDelta(reasoningRaw, true); reasoning = rewrittenReasoning.reasoningAppend; } if (reasoningFromContent) { reasoning = `${reasoning}${reasoningFromContent}`; } if (reasoning) { delta["reasoning_content"] = stripToolXmlDelta(reasoning); } else if ("reasoning_content" in delta) { delete delta["reasoning_content"]; } } } for (const outLine of otherLines) { enqueueLine(controller, outLine); } enqueueLine(controller, `data: ${JSON.stringify(parsed)}`); }; if (downstreamClosed) { try { controller.close(); } catch { // already closed } await tearDownUpstream(); return; } const emittedBeforePull = emittedLines; try { while (!downstreamClosed && emittedLines === emittedBeforePull) { let result: ReaderResult; try { result = await reader.read(); } catch { downstreamClosed = true; try { controller.close(); } catch { // already closed } return; } if (result.done) { if (buffer) { const trailing = buffer.endsWith("\r") ? buffer.slice(0, -1) : buffer; if (trailing.length > 0) { pendingEventLines.push(trailing); } buffer = ""; } if (pendingEventLines.length > 0) { flushEvent(pendingEventLines); pendingEventLines = []; } maybeInjectToolCalls(controller); flushThinkCarry(controller); try { controller.close(); } catch { // already closed } return; } const chunk = result.value ?? new Uint8Array(); buffer += decoder.decode(chunk, { stream: true }); const lines = buffer.split("\n"); buffer = lines.pop() ?? ""; for (const line of lines) { const normalized = line.endsWith("\r") ? line.slice(0, -1) : line; if (normalized === "") { flushEvent(pendingEventLines); pendingEventLines = []; enqueueLine(controller, ""); continue; } pendingEventLines.push(normalized); } } } catch { downstreamClosed = true; await tearDownUpstream(); try { controller.close(); } catch { // already closed } } }, async cancel(): Promise { downstreamClosed = true; await tearDownUpstream(); }, }); };