@oai404iao/pi-codex-minimal-tools 1.4.0 → 2.0.0

package/src/providers/openai-responses-shared.ts

@@ -1,1463 +1,7 @@
-import { calculateCost, type Api, type AssistantMessage, type Context, type Model, type Tool, type Usage } from "@earendil-works/pi-ai";
-import type { ResponseCreateParamsStreaming, ResponseInput, ResponseStreamEvent, Tool as OpenAITool } from "openai/resources/responses/responses.js";
-import type { AssistantMessageEventStream } from "@earendil-works/pi-ai";
-
-type MessageRole = Context["messages"][number]["role"];
-type Message = Context["messages"][number];
-
-interface ImageGenerationCallItem {
-	type: "image_generation_call";
-	id: string;
-	status: string;
-	result: string | null;
-	revised_prompt?: string;
-}
-
-interface ImageGenerationCallBlock {
-	type: "image_generation_call";
-	item: ImageGenerationCallItem;
-}
-
-export interface ReplayableWebSearchCallItem {
-	type: "web_search_call";
-	id: string;
-	status: "completed";
-	action: Record<string, unknown>;
-	results?: Array<Record<string, unknown>>;
-}
-
-export interface CitationSource {
-	url: string;
-	title?: string;
-}
-
-export interface WebSearchCitationSource extends CitationSource {
-	refId: string;
-}
-
-type ReplayableResponseMessageContent =
-	| { type: "output_text"; text: string; annotations: Array<Record<string, unknown>> }
-	| { type: "refusal"; refusal: string };
-
-interface ReplayableResponseMessageItem {
-	type: "message";
-	id: string;
-	role: "assistant";
-	status: "completed";
-	content: ReplayableResponseMessageContent[];
-	phase?: TextSignaturePhase;
-}
-
-type InternalAssistantContent = Extract<Message, { role: "assistant" }>["content"][number] | ImageGenerationCallBlock;
-
-export interface OpenAIResponsesStreamOptions {
-	serviceTier?: ResponseCreateParamsStreaming["service_tier"];
-	resolveServiceTier?: (
-		responseServiceTier: ResponseCreateParamsStreaming["service_tier"] | undefined,
-		requestServiceTier: ResponseCreateParamsStreaming["service_tier"] | undefined,
-	) => ResponseCreateParamsStreaming["service_tier"] | undefined;
-	applyServiceTierPricing?: (usage: Usage, serviceTier: ResponseCreateParamsStreaming["service_tier"] | undefined) => void;
-	webSearchCitationSources?: ReadonlyArray<WebSearchCitationSource>;
-	historicalCitationSources?: ReadonlyArray<CitationSource>;
-}
-
-type TextSignaturePhase = "commentary" | "final_answer";
-export const WEB_SEARCH_ACTIVITY_TEXT_SIGNATURE_PREFIX = "pi:web-search-activity:";
-const LEAKED_CITATION_PROTOCOL = /cite[^]+|【\d+†source】/i;
-
-interface ConvertResponsesMessagesOptions {
-	includeSystemPrompt?: boolean;
-}
-
-interface ConvertResponsesToolsOptions {
-	strict?: boolean | null;
-}
-
-function shortHash(str: string): string {
-	let h1 = 0xdeadbeef;
-	let h2 = 0x41c6ce57;
-	for (let i = 0; i < str.length; i++) {
-		const ch = str.charCodeAt(i);
-		h1 = Math.imul(h1 ^ ch, 2654435761);
-		h2 = Math.imul(h2 ^ ch, 1597334677);
-	}
-	h1 = Math.imul(h1 ^ (h1 >>> 16), 2246822507) ^ Math.imul(h2 ^ (h2 >>> 13), 3266489909);
-	h2 = Math.imul(h2 ^ (h2 >>> 16), 2246822507) ^ Math.imul(h1 ^ (h1 >>> 13), 3266489909);
-	return (h2 >>> 0).toString(36) + (h1 >>> 0).toString(36);
-}
-
-function parseStreamingJson(partialJson: string): Record<string, unknown> {
-	if (!partialJson || partialJson.trim() === "") return {};
-	try {
-		return JSON.parse(partialJson) as Record<string, unknown>;
-	} catch {
-		return {};
-	}
-}
-
-function sanitizeSurrogates(text: string): string {
-	return text.replace(/[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/g, "");
-}
-
-function localToolName(namespace: unknown, name: string): string {
-	if (typeof namespace !== "string" || namespace === "" || namespace === "functions") return name;
-	if (namespace === "web" && name === "run") return "web_search";
-	if (namespace === "image_gen" && name === "imagegen") return "image_generation";
-	return name;
-}
-
-const TOOL_NAMESPACE_SIGNATURE_PREFIX = "pi:codex-tool-namespace:";
-
-function encodeToolNamespaceSignature(namespace: unknown, name: string): string | undefined {
-	if (typeof namespace !== "string" || !namespace) return undefined;
-	return `${TOOL_NAMESPACE_SIGNATURE_PREFIX}${JSON.stringify({ namespace, name })}`;
-}
-
-function wireToolIdentity(
-	name: string,
-	thoughtSignature: string | undefined,
-): { name: string; namespace?: string } {
-	if (!thoughtSignature?.startsWith(TOOL_NAMESPACE_SIGNATURE_PREFIX)) return { name };
-	try {
-		const value = JSON.parse(thoughtSignature.slice(TOOL_NAMESPACE_SIGNATURE_PREFIX.length)) as {
-			namespace?: unknown;
-			name?: unknown;
-		};
-		if (typeof value.namespace === "string" && value.namespace && typeof value.name === "string" && value.name) {
-			return { namespace: value.namespace, name: value.name };
-		}
-	} catch {
-		// Ignore malformed local metadata and replay the Pi-visible tool name.
-	}
-	return { name };
-}
-
-function cloneJsonRecord(value: unknown): Record<string, unknown> | undefined {
-	if (!value || typeof value !== "object" || Array.isArray(value)) return undefined;
-	try {
-		const cloned = JSON.parse(JSON.stringify(value)) as unknown;
-		return cloned && typeof cloned === "object" && !Array.isArray(cloned)
-			? cloned as Record<string, unknown>
-			: undefined;
-	} catch {
-		return undefined;
-	}
-}
-
-function sanitizeWebSearchCallItem(item: unknown): ReplayableWebSearchCallItem | undefined {
-	if (!item || typeof item !== "object") return undefined;
-	const candidate = item as Record<string, unknown>;
-	if (candidate.type !== "web_search_call") return undefined;
-	if (typeof candidate.id !== "string" || candidate.id === "") return undefined;
-	if (candidate.status !== "completed") return undefined;
-	const action = cloneJsonRecord(candidate.action);
-	if (!action) return undefined;
-	const results = Array.isArray(candidate.results)
-		? candidate.results.map(cloneJsonRecord).filter((result): result is Record<string, unknown> => !!result)
-		: undefined;
-
-	return {
-		type: "web_search_call",
-		id: candidate.id,
-		status: "completed",
-		action,
-		...(results ? { results } : {}),
-	};
-}
-
-function sanitizeResponseMessageItem(item: unknown): ReplayableResponseMessageItem | undefined {
-	if (!item || typeof item !== "object") return undefined;
-	const candidate = item as Record<string, unknown>;
-	if (candidate.type !== "message") return undefined;
-	if (typeof candidate.id !== "string" || candidate.id === "") return undefined;
-	const rawContent = Array.isArray(candidate.content) ? candidate.content : [];
-	const content: ReplayableResponseMessageContent[] = [];
-	for (const rawPart of rawContent) {
-		if (!rawPart || typeof rawPart !== "object") continue;
-		const part = rawPart as Record<string, unknown>;
-		if (part.type === "output_text" && typeof part.text === "string") {
-			const annotations = Array.isArray(part.annotations)
-				? part.annotations.map(cloneJsonRecord).filter((annotation): annotation is Record<string, unknown> => !!annotation)
-				: [];
-			content.push({ type: "output_text", text: part.text, annotations });
-		} else if (part.type === "refusal" && typeof part.refusal === "string") {
-			content.push({ type: "refusal", refusal: part.refusal });
-		}
-	}
-	const phase = candidate.phase === "commentary" || candidate.phase === "final_answer"
-		? candidate.phase
-		: undefined;
-	return {
-		type: "message",
-		id: candidate.id,
-		role: "assistant",
-		status: "completed",
-		content,
-		...(phase ? { phase } : {}),
-	};
-}
-
-function isImageGenerationCallBlock(block: InternalAssistantContent): block is ImageGenerationCallBlock {
-	return block.type === "image_generation_call" && block.item?.type === "image_generation_call";
-}
-
-function sanitizeImageGenerationCallItem(item: unknown): ImageGenerationCallItem | undefined {
-	if (!item || typeof item !== "object") return undefined;
-	const candidate = item as Record<string, unknown>;
-	if (candidate.type !== "image_generation_call") return undefined;
-	if (typeof candidate.id !== "string" || candidate.id === "") return undefined;
-	if (typeof candidate.status !== "string" || candidate.status === "") return undefined;
-	if (!(typeof candidate.result === "string" || candidate.result === null)) return undefined;
-
-	return {
-		type: "image_generation_call",
-		id: candidate.id,
-		status: candidate.status,
-		result: candidate.result,
-		...(typeof candidate.revised_prompt === "string" ? { revised_prompt: candidate.revised_prompt } : {}),
-	};
-}
-
-const NON_VISION_USER_IMAGE_PLACEHOLDER = "(image omitted: model does not support images)";
-const NON_VISION_TOOL_IMAGE_PLACEHOLDER = "(tool image omitted: model does not support images)";
-
-function replaceImagesWithPlaceholder(
-	content: Extract<Message, { role: "user" }> extends { content: infer T } ? Exclude<T, string> : never,
-	placeholder: string,
-) {
-	const result: Array<{ type: "text"; text: string } | { type: "image"; data: string; mimeType: string }> = [];
-	let previousWasPlaceholder = false;
-	for (const block of content) {
-		if (block.type === "image") {
-			if (!previousWasPlaceholder) {
-				result.push({ type: "text", text: placeholder });
-			}
-			previousWasPlaceholder = true;
-			continue;
-		}
-		result.push(block);
-		previousWasPlaceholder = block.text === placeholder;
-	}
-	return result;
-}
-
-function downgradeUnsupportedImages(messages: Context["messages"], model: Model<Api>): Context["messages"] {
-	if (model.input.includes("image")) return messages;
-	return messages.map((msg) => {
-		if (msg.role === "user" && Array.isArray(msg.content)) {
-			return { ...msg, content: replaceImagesWithPlaceholder(msg.content, NON_VISION_USER_IMAGE_PLACEHOLDER) };
-		}
-		if (msg.role === "toolResult") {
-			return { ...msg, content: replaceImagesWithPlaceholder(msg.content, NON_VISION_TOOL_IMAGE_PLACEHOLDER) };
-		}
-		return msg;
-	});
-}
-
-function transformMessages(
-	messages: Context["messages"],
-	model: Model<Api>,
-	normalizeToolCallId?: (id: string, targetModel: Model<Api>, source: Extract<Message, { role: "assistant" }>) => string,
-): Context["messages"] {
-	const toolCallIdMap = new Map<string, string>();
-	const imageAwareMessages = downgradeUnsupportedImages(messages, model);
-	const transformed = imageAwareMessages.map((msg) => {
-		if (msg.role === "user") return msg;
-		if (msg.role === "toolResult") {
-			const normalizedId = toolCallIdMap.get(msg.toolCallId);
-			return normalizedId && normalizedId !== msg.toolCallId ? { ...msg, toolCallId: normalizedId } : msg;
-		}
-		if (msg.role === "assistant") {
-			const assistantMsg = msg;
-			const isSameModel =
-				assistantMsg.provider === model.provider && assistantMsg.api === model.api && assistantMsg.model === model.id;
-			const transformedContent = (assistantMsg.content as InternalAssistantContent[]).flatMap((block) => {
-				if (isImageGenerationCallBlock(block)) return block;
-				if (block.type === "thinking") {
-					if (block.redacted) return isSameModel ? block : [];
-					if (isSameModel && block.thinkingSignature) return block;
-					if (!block.thinking || block.thinking.trim() === "") return [];
-					return isSameModel ? block : { type: "text" as const, text: block.thinking };
-				}
-				if (block.type === "text") {
-					if (isWebSearchActivityTextSignature(block.textSignature)) return block;
-					return isSameModel ? block : { type: "text" as const, text: block.text };
-				}
-				if (block.type === "toolCall") {
-					let normalizedToolCall = block;
-					if (!isSameModel && block.thoughtSignature) {
-						normalizedToolCall = { ...block };
-						delete normalizedToolCall.thoughtSignature;
-					}
-					if (!isSameModel && normalizeToolCallId) {
-						const normalizedId = normalizeToolCallId(block.id, model, assistantMsg);
-						if (normalizedId !== block.id) {
-							toolCallIdMap.set(block.id, normalizedId);
-							normalizedToolCall = { ...normalizedToolCall, id: normalizedId };
-						}
-					}
-					return normalizedToolCall;
-				}
-				return block;
-			});
-			return { ...assistantMsg, content: transformedContent as Extract<Message, { role: "assistant" }>["content"] };
-		}
-		return msg;
-	});
-
-	const result: Context["messages"] = [];
-	let pendingToolCalls: Array<Extract<Extract<Message, { role: "assistant" }>["content"][number], { type: "toolCall" }>> = [];
-	let existingToolResultIds = new Set<string>();
-
-	const insertSyntheticToolResults = () => {
-		if (pendingToolCalls.length === 0) return;
-		for (const toolCall of pendingToolCalls) {
-			if (!existingToolResultIds.has(toolCall.id)) {
-				result.push({
-					role: "toolResult",
-					toolCallId: toolCall.id,
-					toolName: toolCall.name,
-					content: [{ type: "text", text: "No result provided" }],
-					isError: true,
-					timestamp: Date.now(),
-				});
-			}
-		}
-		pendingToolCalls = [];
-		existingToolResultIds = new Set();
-	};
-
-	for (const msg of transformed) {
-		if (msg.role === "assistant") {
-			insertSyntheticToolResults();
-			if (msg.stopReason === "error" || msg.stopReason === "aborted") continue;
-			const toolCalls = msg.content.filter((block) => block.type === "toolCall");
-			if (toolCalls.length > 0) {
-				pendingToolCalls = toolCalls;
-				existingToolResultIds = new Set();
-			}
-			result.push(msg);
-			continue;
-		}
-		if (msg.role === "toolResult") {
-			existingToolResultIds.add(msg.toolCallId);
-			result.push(msg);
-			continue;
-		}
-		if (msg.role === "user") {
-			insertSyntheticToolResults();
-			result.push(msg);
-			continue;
-		}
-		result.push(msg);
-	}
-
-	insertSyntheticToolResults();
-
-	return result;
-}
-
-function encodeTextSignatureV1(id: string, phase?: string): string {
-	const payload: { v: 1; id: string; phase?: string } = { v: 1, id };
-	if (phase) payload.phase = phase;
-	return JSON.stringify(payload);
-}
-
-function encodeTextSignature(item: unknown, renderedText?: string): string {
-	let replayItem = sanitizeResponseMessageItem(item);
-	if (!replayItem) {
-		const candidate = item && typeof item === "object" ? item as Record<string, unknown> : undefined;
-		return encodeTextSignatureV1(
-			typeof candidate?.id === "string" ? candidate.id : "msg_unknown",
-			typeof candidate?.phase === "string" ? candidate.phase : undefined,
-		);
-	}
-	const rawText = replayItem.content
-		.map((part) => part.type === "output_text" ? part.text : part.refusal)
-		.join("");
-	if (
-		renderedText !== undefined
-		&& renderedText !== rawText
-		&& replayItem.content.every((part) => part.type === "output_text")
-		&& LEAKED_CITATION_PROTOCOL.test(rawText)
-	) {
-		replayItem = {
-			...replayItem,
-			content: [{ type: "output_text", text: renderedText, annotations: [] }],
-		};
-	}
-	return JSON.stringify({ v: 2, item: replayItem });
-}
-
-function parseTextSignature(signature: string | undefined): {
-	id: string;
-	phase?: TextSignaturePhase;
-	item?: ReplayableResponseMessageItem;
-} | undefined {
-	if (!signature) return undefined;
-	if (signature.startsWith("{")) {
-		try {
-			const parsed = JSON.parse(signature) as {
-				v?: number;
-				id?: string;
-				phase?: TextSignaturePhase | string;
-				item?: unknown;
-			};
-			if (parsed.v === 2) {
-				const item = sanitizeResponseMessageItem(parsed.item);
-				if (item) {
-					return {
-						id: item.id,
-						...(item.phase ? { phase: item.phase } : {}),
-						item,
-					};
-				}
-			}
-			if (parsed.v === 1 && typeof parsed.id === "string") {
-				return parsed.phase === "commentary" || parsed.phase === "final_answer"
-					? { id: parsed.id, phase: parsed.phase }
-					: { id: parsed.id };
-			}
-		} catch {
-			// Fall through to legacy plain-string handling.
-		}
-	}
-	return { id: signature };
-}
-
-export function isWebSearchActivityTextSignature(signature: string | undefined): boolean {
-	return signature?.startsWith(WEB_SEARCH_ACTIVITY_TEXT_SIGNATURE_PREFIX) === true;
-}
-
-export function encodeWebSearchActivityTextSignature(callId: string, item?: unknown): string {
-	const replayItem = sanitizeWebSearchCallItem(item);
-	if (!replayItem || replayItem.id !== callId) {
-		return `${WEB_SEARCH_ACTIVITY_TEXT_SIGNATURE_PREFIX}${callId}`;
-	}
-	return `${WEB_SEARCH_ACTIVITY_TEXT_SIGNATURE_PREFIX}${callId}:${JSON.stringify({ v: 2, item: replayItem })}`;
-}
-
-export function decodeWebSearchActivityTextSignature(signature: string | undefined): ReplayableWebSearchCallItem | undefined {
-	if (!isWebSearchActivityTextSignature(signature)) return undefined;
-	const payload = signature!.slice(WEB_SEARCH_ACTIVITY_TEXT_SIGNATURE_PREFIX.length);
-	const separator = payload.indexOf(":");
-	if (separator < 1) return undefined;
-	const callId = payload.slice(0, separator);
-	try {
-		const parsed = JSON.parse(payload.slice(separator + 1)) as { v?: number; item?: unknown };
-		if (parsed.v !== 2) return undefined;
-		const item = sanitizeWebSearchCallItem(parsed.item);
-		return item?.id === callId ? item : undefined;
-	} catch {
-		return undefined;
-	}
-}
-
-const INTERNAL_CITATION_MARKER = /cite([^]+)/;
-const INTERNAL_CITATION_REF = /^turn\d+[a-z][a-z0-9_-]*\d+$/i;
-
-function citationRefsFromResult(result: Record<string, unknown>): string[] {
-	const refs = new Set<string>();
-	for (const key of ["ref_id", "reference_id", "id"]) {
-		const value = result[key];
-		if (typeof value === "string" && INTERNAL_CITATION_REF.test(value)) refs.add(value);
-	}
-	if (typeof result.snippet === "string") {
-		const marker = INTERNAL_CITATION_MARKER.exec(result.snippet.slice(0, 2048));
-		for (const ref of marker?.[1]?.split("") ?? []) {
-			const trimmed = ref.trim();
-			if (INTERNAL_CITATION_REF.test(trimmed)) refs.add(trimmed);
-		}
-	}
-	return [...refs];
-}
-
-export function extractWebSearchCitationSources(item: unknown): WebSearchCitationSource[] {
-	const replayItem = sanitizeWebSearchCallItem(item);
-	if (!replayItem) return [];
-	const actionResults = Array.isArray(replayItem.action.results)
-		? replayItem.action.results.map(cloneJsonRecord).filter((result): result is Record<string, unknown> => !!result)
-		: [];
-	const results = [...(replayItem.results ?? []), ...actionResults];
-	const sources: WebSearchCitationSource[] = [];
-	const seen = new Set<string>();
-	for (const result of results) {
-		const url = typeof result.url === "string" && result.url.trim() ? result.url.trim() : undefined;
-		if (!url) continue;
-		const title = typeof result.title === "string" && result.title.trim() ? result.title.trim() : undefined;
-		for (const refId of citationRefsFromResult(result)) {
-			const key = `${refId}\n${url}`;
-			if (seen.has(key)) continue;
-			seen.add(key);
-			sources.push({ refId, url, ...(title ? { title } : {}) });
-		}
-	}
-	return sources;
-}
-
-export function collectWebSearchCitationSources<TApi extends Api>(
-	model: Model<TApi>,
-	context: Context,
-): WebSearchCitationSource[] {
-	const byRef = new Map<string, WebSearchCitationSource>();
-	for (const message of context.messages) {
-		if (message.role !== "assistant") continue;
-		if (message.provider !== model.provider || message.api !== model.api || message.model !== model.id) continue;
-		for (const block of message.content as InternalAssistantContent[]) {
-			if (block.type !== "text") continue;
-			const item = decodeWebSearchActivityTextSignature(block.textSignature);
-			if (!item) continue;
-			for (const source of extractWebSearchCitationSources(item)) byRef.set(source.refId, source);
-		}
-	}
-	return [...byRef.values()];
-}
-
-export function collectHistoricalCitationSources<TApi extends Api>(
-	model: Model<TApi>,
-	context: Context,
-): CitationSource[] {
-	let latestSources: CitationSource[] = [];
-	for (const message of context.messages) {
-		if (message.role !== "assistant") continue;
-		if (message.provider !== model.provider || message.api !== model.api || message.model !== model.id) continue;
-		const messageSources: CitationSource[] = [];
-		const seenUrls = new Set<string>();
-		const pushSource = (source: CitationSource): void => {
-			if (!source.url || seenUrls.has(source.url)) return;
-			seenUrls.add(source.url);
-			messageSources.push(source);
-		};
-		for (const block of message.content as InternalAssistantContent[]) {
-			if (block.type !== "text" || isWebSearchActivityTextSignature(block.textSignature)) continue;
-			const markdownLinkPattern = /\[([^\]\n]+)\]\((https?:\/\/[^)\s]+)\)/g;
-			for (const match of block.text.matchAll(markdownLinkPattern)) {
-				pushSource({ title: match[1], url: match[2] });
-			}
-			const replayItem = parseTextSignature(block.textSignature)?.item;
-			for (const part of replayItem?.content ?? []) {
-				if (part.type !== "output_text") continue;
-				for (const annotation of part.annotations) {
-					const url = annotation.type === "url_citation" && typeof annotation.url === "string"
-						? annotation.url.trim()
-						: "";
-					const title = typeof annotation.title === "string" && annotation.title.trim()
-						? annotation.title.trim()
-						: undefined;
-					if (url) pushSource({ url, ...(title ? { title } : {}) });
-				}
-			}
-		}
-		if (messageSources.length > 0) latestSources = messageSources;
-	}
-	return latestSources;
-}
-
-export function convertResponsesMessages<TApi extends Api>(
-	model: Model<TApi>,
-	context: Context,
-	allowedToolCallProviders: ReadonlySet<string>,
-	options?: ConvertResponsesMessagesOptions,
-): ResponseInput {
-	const messages: ResponseInput = [];
-	const normalizeIdPart = (part: string) => {
-		const sanitized = part.replace(/[^a-zA-Z0-9_-]/g, "_");
-		const normalized = sanitized.length > 64 ? sanitized.slice(0, 64) : sanitized;
-		return normalized.replace(/_+$/, "");
-	};
-	const buildForeignResponsesItemId = (itemId: string, prefix: "fc_" | "ctc_") => {
-		const normalized = `${prefix}${shortHash(itemId)}`;
-		return normalized.length > 64 ? normalized.slice(0, 64) : normalized;
-	};
-	const normalizeToolCallId = (id: string, _targetModel: Model<TApi>, source: Extract<Message, { role: "assistant" }>) => {
-		if (!allowedToolCallProviders.has(model.provider)) return normalizeIdPart(id);
-		if (!id.includes("|")) return normalizeIdPart(id);
-		const [callId, itemId] = id.split("|");
-		const normalizedCallId = normalizeIdPart(callId);
-		const isForeignToolCall = source.provider !== model.provider || source.api !== model.api;
-		const itemPrefix = itemId?.startsWith("ctc_") ? "ctc_" : "fc_";
-		let normalizedItemId = isForeignToolCall ? buildForeignResponsesItemId(itemId ?? "", itemPrefix) : normalizeIdPart(itemId ?? "");
-		if (!normalizedItemId.startsWith(itemPrefix)) normalizedItemId = normalizeIdPart(`${itemPrefix}${normalizedItemId}`);
-		return `${normalizedCallId}|${normalizedItemId}`;
-	};
-
-	const transformedMessages = transformMessages(context.messages, model as Model<Api>, normalizeToolCallId as never);
-	const includeSystemPrompt = options?.includeSystemPrompt ?? true;
-	if (includeSystemPrompt && context.systemPrompt) {
-		messages.push({ role: model.reasoning ? "developer" : "system", content: sanitizeSurrogates(context.systemPrompt) });
-	}
-
-	let msgIndex = 0;
-	for (const msg of transformedMessages) {
-		if (msg.role === "user") {
-			if (typeof msg.content === "string") {
-				messages.push({ role: "user", content: [{ type: "input_text", text: sanitizeSurrogates(msg.content) }] });
-			} else {
-				const content = msg.content.map((item) =>
-					item.type === "text"
-						? { type: "input_text" as const, text: sanitizeSurrogates(item.text) }
-						: { type: "input_image" as const, detail: "auto" as const, image_url: `data:${item.mimeType};base64,${item.data}` },
-				);
-				if (content.length > 0) messages.push({ role: "user", content });
-			}
-		} else if (msg.role === "assistant") {
-			const output: ResponseInput = [];
-			const isSameModel = msg.model === model.id && msg.provider === model.provider && msg.api === model.api;
-			const isDifferentModel = msg.model !== model.id && msg.provider === model.provider && msg.api === model.api;
-			let assistantBlockIndex = 0;
-			for (const block of msg.content as InternalAssistantContent[]) {
-				if (isImageGenerationCallBlock(block)) {
-					const imageGenerationCall = sanitizeImageGenerationCallItem(block.item);
-					if (imageGenerationCall) output.push(imageGenerationCall as ResponseInput[number]);
-				} else if (block.type === "thinking") {
-					if (block.thinkingSignature) output.push(JSON.parse(block.thinkingSignature));
-				} else if (block.type === "text") {
-					if (isWebSearchActivityTextSignature(block.textSignature)) {
-						const webSearchItem = isSameModel
-							? decodeWebSearchActivityTextSignature(block.textSignature)
-							: undefined;
-						if (webSearchItem) output.push(webSearchItem as unknown as ResponseInput[number]);
-						continue;
-					}
-					const parsedSignature = parseTextSignature(block.textSignature);
-					if (isSameModel && parsedSignature?.item) {
-						output.push(parsedSignature.item as ResponseInput[number]);
-						assistantBlockIndex++;
-						continue;
-					}
-					let msgId = parsedSignature?.id ?? `msg_${msgIndex}_${assistantBlockIndex}`;
-					if (msgId.length > 64) msgId = `msg_${shortHash(msgId)}`;
-					output.push({
-						type: "message",
-						role: "assistant",
-						content: [{ type: "output_text", text: sanitizeSurrogates(block.text), annotations: [] }],
-						status: "completed",
-						id: msgId,
-						...(parsedSignature?.phase ? { phase: parsedSignature.phase } : {}),
-					});
-					assistantBlockIndex++;
-				} else if (block.type === "toolCall") {
-					const [callId, itemIdRaw] = block.id.split("|");
-					const custom = itemIdRaw?.startsWith("ctc_") === true;
-					let itemId: string | undefined = itemIdRaw;
-					if (isDifferentModel && (itemId?.startsWith("fc_") || itemId?.startsWith("ctc_"))) itemId = undefined;
-					const wireIdentity = wireToolIdentity(block.name, block.thoughtSignature);
-					if (custom) {
-						output.push({
-							type: "custom_tool_call",
-							...(itemId ? { id: itemId } : {}),
-							call_id: callId,
-							name: wireIdentity.name,
-							...(wireIdentity.namespace ? { namespace: wireIdentity.namespace } : {}),
-							input: typeof block.arguments.input === "string" ? block.arguments.input : "",
-						} as ResponseInput[number]);
-					} else {
-						output.push({
-							type: "function_call",
-							...(itemId ? { id: itemId } : {}),
-							call_id: callId,
-							name: wireIdentity.name,
-							...(wireIdentity.namespace ? { namespace: wireIdentity.namespace } : {}),
-							arguments: JSON.stringify(block.arguments),
-						} as ResponseInput[number]);
-					}
-				}
-			}
-			if (output.length > 0) messages.push(...output);
-		} else if (msg.role === "toolResult") {
-			const textResult = msg.content.filter((c) => c.type === "text").map((c) => c.text).join("\n");
-			const hasImages = msg.content.some((c) => c.type === "image");
-			const hasText = textResult.length > 0;
-			const [callId, itemId] = msg.toolCallId.split("|");
-			const supportsToolResultImages = hasImages && model.input.includes("image");
-			let originalCallUsesContentItems = false;
-			for (let index = msgIndex - 1; index >= 0; index--) {
-				const previous = context.messages[index];
-				if (previous?.role !== "assistant") continue;
-				const originalCall = previous.content.find((block) =>
-					block.type === "toolCall" && block.id.split("|")[0] === callId);
-				if (originalCall?.type === "toolCall") {
-					originalCallUsesContentItems = wireToolIdentity(
-						originalCall.name,
-						originalCall.thoughtSignature,
-					).namespace === "web";
-					break;
-				}
-			}
-			const usesContentItems = supportsToolResultImages || originalCallUsesContentItems;
-			const output = usesContentItems
-				? [
-						...(hasText ? [{ type: "input_text" as const, text: sanitizeSurrogates(textResult) }] : []),
-						...(supportsToolResultImages
-							? msg.content
-									.filter((block) => block.type === "image")
-									.map((block) => ({
-										type: "input_image" as const,
-										detail: "auto" as const,
-										image_url: `data:${block.mimeType};base64,${block.data}`,
-									}))
-							: []),
-						...(!hasText && !supportsToolResultImages
-							? [{ type: "input_text" as const, text: "(see attached image)" }]
-							: []),
-					]
-				: sanitizeSurrogates(hasText ? textResult : "(see attached image)");
-			messages.push({
-				type: itemId?.startsWith("ctc_") ? "custom_tool_call_output" : "function_call_output",
-				call_id: callId,
-				output,
-			} as ResponseInput[number]);
-		}
-		msgIndex++;
-	}
-
-	return messages;
-}
-
-export function convertResponsesTools(tools: Tool[], options?: ConvertResponsesToolsOptions): OpenAITool[] {
-	const strict = options?.strict === undefined ? false : options.strict;
-	return tools.map((tool) => ({
-		type: "function",
-		name: tool.name,
-		description: tool.description,
-		parameters: tool.parameters as unknown as Record<string, unknown>,
-		strict,
-	}));
-}
-
-interface MarkdownCodeRange {
-	start: number;
-	end: number;
-}
-
-function characterRunLength(text: string, index: number, character: string): number {
-	let end = index;
-	while (end < text.length && text[end] === character) end++;
-	return end - index;
-}
-
-function isFencePosition(text: string, index: number): boolean {
-	const lineStart = text.lastIndexOf("\n", index - 1) + 1;
-	return /^ {0,3}$/.test(text.slice(lineStart, index));
-}
-
-function markdownCodeRanges(text: string): MarkdownCodeRange[] {
-	const ranges: MarkdownCodeRange[] = [];
-	let fence: { character: "`" | "~"; length: number; start: number } | undefined;
-	let index = 0;
-	while (index < text.length) {
-		const character = text[index];
-		if (fence) {
-			if (character === fence.character && isFencePosition(text, index)) {
-				const runLength = characterRunLength(text, index, character);
-				if (runLength >= fence.length) {
-					ranges.push({ start: fence.start, end: index + runLength });
-					fence = undefined;
-					index += runLength;
-					continue;
-				}
-			}
-			index++;
-			continue;
-		}
-
-		if ((character === "`" || character === "~") && isFencePosition(text, index)) {
-			const runLength = characterRunLength(text, index, character);
-			if (runLength >= 3) {
-				fence = { character, length: runLength, start: index };
-				index += runLength;
-				continue;
-			}
-		}
-
-		if (character === "`") {
-			const runLength = characterRunLength(text, index, character);
-			const delimiter = character.repeat(runLength);
-			const close = text.indexOf(delimiter, index + runLength);
-			if (close < 0) {
-				ranges.push({ start: index, end: text.length });
-				break;
-			}
-			ranges.push({ start: index, end: close + runLength });
-			index = close + runLength;
-			continue;
-		}
-		index++;
-	}
-	if (fence) ranges.push({ start: fence.start, end: text.length });
-	return ranges;
-}
-
-function isInsideMarkdownCode(index: number, ranges: MarkdownCodeRange[]): boolean {
-	return ranges.some((range) => index >= range.start && index < range.end);
-}
-
-function trailingCitationFragmentStart(text: string, ranges: MarkdownCodeRange[]): number | undefined {
-	const opener = "cite";
-	const openIndex = text.lastIndexOf("cite");
-	if (openIndex >= 0 && text.indexOf("", openIndex) < 0 && !isInsideMarkdownCode(openIndex, ranges)) {
-		return openIndex;
-	}
-	for (let length = Math.min(opener.length - 1, text.length); length > 0; length--) {
-		if (!text.endsWith(opener.slice(0, length))) continue;
-		const start = text.length - length;
-		if (!isInsideMarkdownCode(start, ranges)) return start;
-	}
-	return undefined;
-}
-
-function trailingIndexedSourceFragmentStart(text: string, ranges: MarkdownCodeRange[]): number | undefined {
-	const openIndex = text.lastIndexOf("【");
-	if (openIndex < 0 || text.indexOf("】", openIndex) >= 0 || isInsideMarkdownCode(openIndex, ranges)) {
-		return undefined;
-	}
-	const fragment = text.slice(openIndex);
-	const match = /^【\d*(?:†([a-z]*))?$/i.exec(fragment);
-	if (!match) return undefined;
-	const sourceFragment = match[1]?.toLowerCase() ?? "";
-	return "source".startsWith(sourceFragment) ? openIndex : undefined;
-}
-
-export async function processResponsesStream<TApi extends Api>(
-	openaiStream: AsyncIterable<ResponseStreamEvent>,
-	output: AssistantMessage,
-	stream: AssistantMessageEventStream,
-	model: Model<TApi>,
-	options?: OpenAIResponsesStreamOptions,
-): Promise<void> {
-	const blocks = output.content;
-	const blockIndex = () => blocks.length - 1;
-	type ThinkingBlock = Extract<AssistantMessage["content"][number], { type: "thinking" }>;
-	type TextBlock = Extract<AssistantMessage["content"][number], { type: "text" }>;
-	type ToolCallBlock = Extract<AssistantMessage["content"][number], { type: "toolCall" }> & { partialJson?: string; partialInput?: string };
-
-	type ReasoningState = {
-		kind: "reasoning";
-		blockIndex: number;
-		block: ThinkingBlock;
-		summaryParts: Map<number, { text: string }>;
-	};
-	type MessagePartState = { type: "output_text" | "refusal"; text: string; annotations?: unknown[] };
-	type MessageState = {
-		kind: "message";
-		blockIndex: number;
-		block: TextBlock;
-		parts: Map<number, MessagePartState>;
-	};
-	type FunctionCallState = {
-		kind: "function_call";
-		blockIndex: number;
-		block: ToolCallBlock;
-	};
-	type CustomToolCallState = {
-		kind: "custom_tool_call";
-		blockIndex: number;
-		block: ToolCallBlock;
-		itemId: string;
-		sourceItemId?: string;
-		callId: string;
-		input: string;
-	};
-	type OutputState = ReasoningState | MessageState | FunctionCallState | CustomToolCallState;
-
-	let sawTerminalResponseEvent = false;
-	const outputStates = new Map<number, OutputState>();
-	const imageGenerationCallIds = new Set<string>();
-	const nativeCompactionSignatures = new Set<string>();
-	const webSearchCitationSources = new Map<string, WebSearchCitationSource>();
-	for (const source of options?.webSearchCitationSources ?? []) {
-		if (source.refId && source.url) webSearchCitationSources.set(source.refId, source);
-	}
-	const registerWebSearchCitationSources = (item: unknown): void => {
-		for (const source of extractWebSearchCitationSources(item)) {
-			webSearchCitationSources.set(source.refId, source);
-		}
-	};
-	const historicalCitationSources = [...(options?.historicalCitationSources ?? [])];
-	const responseOutputIndexByBlock = new WeakMap<object, number>();
-	const pushResponseBlock = <T extends InternalAssistantContent>(block: T, outputIndex: number): T => {
-		(output.content as InternalAssistantContent[]).push(block);
-		responseOutputIndexByBlock.set(block as object, outputIndex);
-		return block;
-	};
-	const normalizeResponseBlockOrder = (): void => {
-		const content = output.content as InternalAssistantContent[];
-		const slots: number[] = [];
-		const indexedBlocks: Array<{ block: InternalAssistantContent; outputIndex: number; sequence: number }> = [];
-		for (let index = 0; index < content.length; index++) {
-			const block = content[index]!;
-			const outputIndex = responseOutputIndexByBlock.get(block as object);
-			if (outputIndex === undefined) continue;
-			slots.push(index);
-			indexedBlocks.push({ block, outputIndex, sequence: indexedBlocks.length });
-		}
-		indexedBlocks.sort((a, b) => a.outputIndex - b.outputIndex || a.sequence - b.sequence);
-		for (let index = 0; index < slots.length; index++) {
-			content[slots[index]!] = indexedBlocks[index]!.block;
-		}
-	};
-	const customItemId = (itemId: string | undefined, callId: string): string =>
-		itemId?.startsWith("ctc_") ? itemId : `ctc_${shortHash(itemId || callId)}`;
-	const findCustomToolCallState = (event: { output_index?: number; item_id?: string; call_id?: string }): CustomToolCallState | undefined => {
-		const indexed = typeof event.output_index === "number" ? outputStates.get(event.output_index) : undefined;
-		if (indexed?.kind === "custom_tool_call") return indexed;
-		for (const state of outputStates.values()) {
-			if (state.kind !== "custom_tool_call") continue;
-			if (event.item_id && (event.item_id === state.itemId || event.item_id === state.sourceItemId)) return state;
-			if (event.call_id && event.call_id === state.callId) return state;
-		}
-		return undefined;
-	};
-
-	const appendImageGenerationCall = (item: unknown, outputIndex: number): void => {
-		const imageGenerationCall = sanitizeImageGenerationCallItem(item);
-		if (!imageGenerationCall || imageGenerationCallIds.has(imageGenerationCall.id)) return;
-		imageGenerationCallIds.add(imageGenerationCall.id);
-		pushResponseBlock({
-			type: "image_generation_call",
-			item: imageGenerationCall,
-		}, outputIndex);
-	};
-	const appendNativeCompaction = (item: unknown, outputIndex: number): void => {
-		if (!item || typeof item !== "object") return;
-		const type = (item as { type?: unknown }).type;
-		if (type !== "compaction" && type !== "context_compaction") return;
-		const signature = JSON.stringify(item);
-		if (nativeCompactionSignatures.has(signature)) return;
-		nativeCompactionSignatures.add(signature);
-		pushResponseBlock({
-			type: "thinking",
-			thinking: "",
-			thinkingSignature: signature,
-			redacted: true,
-		} as AssistantMessage["content"][number], outputIndex);
-	};
-
-	const renderReasoningSummary = (summaryParts: Map<number, { text: string }>): string =>
-		Array.from(summaryParts.entries())
-			.sort(([a], [b]) => a - b)
-			.map(([, part]) => part.text)
-			.join("\n\n");
-
-	const annotationUrl = (annotation: unknown): string | undefined => {
-		const candidate = annotation && typeof annotation === "object" ? annotation as Record<string, unknown> : undefined;
-		return candidate?.type === "url_citation" && typeof candidate.url === "string" && candidate.url.trim() ? candidate.url.trim() : undefined;
-	};
-	const annotationTitle = (annotation: unknown): string | undefined => {
-		const candidate = annotation && typeof annotation === "object" ? annotation as Record<string, unknown> : undefined;
-		return typeof candidate?.title === "string" && candidate.title.trim() ? candidate.title.trim() : undefined;
-	};
-	const markdownLinkText = (value: string): string => value.replace(/\\/g, "\\\\").replace(/]/g, "\\]").replace(/\n+/g, " ");
-	const markdownLinkUrl = (value: string): string => value.replace(/[)\s]/g, (char) => encodeURIComponent(char));
-	const containsMarkdownLink = (value: string): boolean => /\[[^\]\n]+\]\([^) \n]+\)/.test(value);
-	const citationSourceLabel = (source: CitationSource): string => {
-		try {
-			const hostname = new URL(source.url).hostname.replace(/^www\./, "");
-			if (hostname) return hostname;
-		} catch {
-			// Fall back to the result title or URL.
-		}
-		return source.title ?? source.url;
-	};
-	const citationSourceMarkdown = (source: CitationSource): string =>
-		`[${markdownLinkText(citationSourceLabel(source))}](${markdownLinkUrl(source.url)})`;
-	const renderInternalCitationMarkers = (text: string): string => {
-		const initialCodeRanges = markdownCodeRanges(text);
-		const fragmentStart = trailingCitationFragmentStart(text, initialCodeRanges);
-		const visibleText = fragmentStart === undefined ? text : text.slice(0, fragmentStart);
-		const codeRanges = fragmentStart === undefined ? initialCodeRanges : markdownCodeRanges(visibleText);
-		const markerPattern = new RegExp(INTERNAL_CITATION_MARKER.source, "g");
-		let cursor = 0;
-		let rendered = "";
-		for (const match of visibleText.matchAll(markerPattern)) {
-			const start = match.index ?? 0;
-			if (isInsideMarkdownCode(start, codeRanges)) continue;
-			rendered += visibleText.slice(cursor, start);
-			const seenUrls = new Set<string>();
-			const links: string[] = [];
-			for (const rawRef of match[1]?.split("") ?? []) {
-				const source = webSearchCitationSources.get(rawRef.trim());
-				if (!source || seenUrls.has(source.url)) continue;
-				seenUrls.add(source.url);
-				links.push(citationSourceMarkdown(source));
-			}
-			rendered += links.length > 0 ? `(${links.join(", ")})` : "";
-			cursor = start + match[0].length;
-		}
-		if (cursor === 0) return visibleText;
-		return rendered + visibleText.slice(cursor);
-	};
-	const renderIndexedSourceMarkers = (text: string): string => {
-		const initialCodeRanges = markdownCodeRanges(text);
-		const fragmentStart = trailingIndexedSourceFragmentStart(text, initialCodeRanges);
-		const visibleText = fragmentStart === undefined ? text : text.slice(0, fragmentStart);
-		const codeRanges = fragmentStart === undefined ? initialCodeRanges : markdownCodeRanges(visibleText);
-		const markerPattern = /【(\d+)†source】/gi;
-		let cursor = 0;
-		let rendered = "";
-		for (const match of visibleText.matchAll(markerPattern)) {
-			const start = match.index ?? 0;
-			if (isInsideMarkdownCode(start, codeRanges)) continue;
-			rendered += visibleText.slice(cursor, start);
-			const followingText = visibleText.slice(start + match[0].length);
-			const alreadyLinked = /^\s*(?:\(\s*)?\[[^\]\n]+\]\(https?:\/\/[^)\s]+\)/.test(followingText);
-			const sourceIndex = Number.parseInt(match[1] ?? "", 10);
-			const source = Number.isInteger(sourceIndex) ? historicalCitationSources[sourceIndex] : undefined;
-			rendered += alreadyLinked || !source ? "" : `(${citationSourceMarkdown(source)})`;
-			cursor = start + match[0].length;
-		}
-		if (cursor === 0) return visibleText;
-		return rendered + visibleText.slice(cursor);
-	};
-	const sourceMarkdown = (annotations: unknown[], citedUrls: Set<string>): string => {
-		const seen = new Set<string>();
-		const links: string[] = [];
-		for (const annotation of annotations) {
-			const url = annotationUrl(annotation);
-			if (!url || citedUrls.has(url) || seen.has(url)) continue;
-			seen.add(url);
-			links.push(`[${markdownLinkText(annotationTitle(annotation) ?? url)}](${markdownLinkUrl(url)})`);
-		}
-		return links.length > 0 ? `\n\nSources: ${links.join(", ")}` : "";
-	};
-	const renderOutputTextPart = (part: MessagePartState): string => {
-		const annotations = part.annotations ?? [];
-		if (part.type !== "output_text" || annotations.length === 0) return part.text;
-		const spans = annotations
-			.map((annotation) => {
-				const candidate = annotation && typeof annotation === "object" ? annotation as Record<string, unknown> : undefined;
-				const url = annotationUrl(annotation);
-				const start = candidate?.start_index;
-				const end = candidate?.end_index;
-				return typeof start === "number" && typeof end === "number" && url && Number.isInteger(start) && Number.isInteger(end) && start >= 0 && end > start && end <= part.text.length
-					? { start, end, url }
-					: undefined;
-			})
-			.filter((span): span is { start: number; end: number; url: string } => !!span)
-			.sort((a, b) => a.start - b.start || a.end - b.end);
-		const citedUrls = new Set<string>();
-		let cursor = 0;
-		let rendered = "";
-		for (const span of spans) {
-			if (span.start < cursor) continue;
-			rendered += part.text.slice(cursor, span.start);
-			const label = part.text.slice(span.start, span.end);
-			rendered += containsMarkdownLink(label)
-				? label
-				: `[${markdownLinkText(label)}](${markdownLinkUrl(span.url)})`;
-			citedUrls.add(span.url);
-			cursor = span.end;
-		}
-		if (cursor === 0) return part.text + sourceMarkdown(annotations, citedUrls);
-		rendered += part.text.slice(cursor);
-		return rendered + sourceMarkdown(annotations, citedUrls);
-	};
-	const renderMessageText = (parts: Map<number, MessagePartState>, citations = false): string =>
-		Array.from(parts.entries())
-			.sort(([a], [b]) => a - b)
-			.map(([, part]) => {
-				const text = citations ? renderOutputTextPart(part) : part.text;
-				return part.type === "output_text"
-					? renderIndexedSourceMarkers(renderInternalCitationMarkers(text))
-					: text;
-			})
-			.join("");
-
-	const emitAppendedDelta = (
-		eventType: "thinking_delta" | "text_delta",
-		contentIndex: number,
-		previous: string,
-		next: string,
-	) => {
-		if (next.startsWith(previous)) {
-			const delta = next.slice(previous.length);
-			if (delta.length > 0) {
-				stream.push({ type: eventType, contentIndex, delta, partial: output });
-			}
-		}
-	};
-
-	for await (const event of openaiStream) {
-		if (event.type === "response.created") {
-			output.responseId = event.response.id;
-		} else if (event.type === "response.output_item.added") {
-			const item = event.item;
-			const customItem = item as unknown as { type?: string; id?: string; call_id?: string; name?: string; namespace?: string; input?: string };
-			if (item.type === "reasoning") {
-				const currentBlock: ThinkingBlock = pushResponseBlock(
-					{ type: "thinking", thinking: "" },
-					event.output_index,
-				);
-				outputStates.set(event.output_index, {
-					kind: "reasoning",
-					blockIndex: blockIndex(),
-					block: currentBlock,
-					summaryParts: new Map(),
-				});
-				stream.push({ type: "thinking_start", contentIndex: blockIndex(), partial: output });
-			} else if (item.type === "message") {
-				const currentBlock: TextBlock = pushResponseBlock(
-					{ type: "text", text: "" },
-					event.output_index,
-				);
-				outputStates.set(event.output_index, {
-					kind: "message",
-					blockIndex: blockIndex(),
-					block: currentBlock,
-					parts: new Map(),
-				});
-				stream.push({ type: "text_start", contentIndex: blockIndex(), partial: output });
-			} else if (item.type === "function_call") {
-				const namespace = (item as { namespace?: unknown }).namespace;
-				const thoughtSignature = encodeToolNamespaceSignature(namespace, item.name);
-				const currentBlock: ToolCallBlock = {
-					type: "toolCall",
-					id: `${item.call_id}|${item.id}`,
-					name: localToolName(namespace, item.name),
-					arguments: {},
-					...(thoughtSignature ? { thoughtSignature } : {}),
-					partialJson: item.arguments || "",
-				};
-				pushResponseBlock(currentBlock, event.output_index);
-				outputStates.set(event.output_index, {
-					kind: "function_call",
-					blockIndex: blockIndex(),
-					block: currentBlock,
-				});
-				stream.push({ type: "toolcall_start", contentIndex: blockIndex(), partial: output });
-			} else if (customItem.type === "custom_tool_call" && customItem.call_id && customItem.name) {
-				const itemId = customItemId(customItem.id, customItem.call_id);
-				const input = customItem.input ?? "";
-				const thoughtSignature = encodeToolNamespaceSignature(customItem.namespace, customItem.name);
-				const currentBlock: ToolCallBlock = {
-					type: "toolCall",
-					id: `${customItem.call_id}|${itemId}`,
-					name: localToolName(customItem.namespace, customItem.name),
-					arguments: { input },
-					...(thoughtSignature ? { thoughtSignature } : {}),
-					partialInput: input,
-				};
-				pushResponseBlock(currentBlock, event.output_index);
-				outputStates.set(event.output_index, {
-					kind: "custom_tool_call",
-					blockIndex: blockIndex(),
-					block: currentBlock,
-					itemId,
-					sourceItemId: customItem.id,
-					callId: customItem.call_id,
-					input,
-				});
-				stream.push({ type: "toolcall_start", contentIndex: blockIndex(), partial: output });
-			}
-		} else if (event.type === "response.reasoning_summary_part.added") {
-			const state = outputStates.get(event.output_index);
-			if (state?.kind === "reasoning") {
-				state.summaryParts.set(event.summary_index, { text: event.part.text });
-			}
-		} else if (event.type === "response.reasoning_summary_text.delta") {
-			const state = outputStates.get(event.output_index);
-			if (state?.kind === "reasoning") {
-				const summaryPart = state.summaryParts.get(event.summary_index) ?? { text: "" };
-				summaryPart.text += event.delta;
-				state.summaryParts.set(event.summary_index, summaryPart);
-				const previousThinking = state.block.thinking;
-				const nextThinking = renderReasoningSummary(state.summaryParts);
-				state.block.thinking = nextThinking;
-				emitAppendedDelta("thinking_delta", state.blockIndex, previousThinking, nextThinking);
-			}
-		} else if (event.type === "response.reasoning_summary_part.done") {
-			const state = outputStates.get(event.output_index);
-			if (state?.kind === "reasoning") {
-				state.summaryParts.set(event.summary_index, { text: event.part.text });
-				state.block.thinking = renderReasoningSummary(state.summaryParts);
-			}
-		} else if (event.type === "response.reasoning_text.delta") {
-			const state = outputStates.get(event.output_index);
-			if (state?.kind === "reasoning") {
-				state.block.thinking += event.delta;
-				stream.push({ type: "thinking_delta", contentIndex: state.blockIndex, delta: event.delta, partial: output });
-			}
-		} else if (event.type === "response.content_part.added") {
-			const state = outputStates.get(event.output_index);
-			if (state?.kind === "message" && (event.part.type === "output_text" || event.part.type === "refusal")) {
-				const annotations = event.part.type === "output_text" && Array.isArray((event.part as { annotations?: unknown }).annotations)
-					? (event.part as { annotations: unknown[] }).annotations
-					: undefined;
-				state.parts.set(event.content_index, {
-					type: event.part.type,
-					text: event.part.type === "output_text" ? event.part.text : event.part.refusal,
-					...(annotations ? { annotations } : {}),
-				});
-			}
-		} else if ((event as { type?: string }).type === "response.output_text.annotation.added") {
-			const annotationEvent = event as unknown as { output_index: number; content_index: number; annotation?: unknown };
-			const state = outputStates.get(annotationEvent.output_index);
-			if (state?.kind === "message") {
-				const messagePart = state.parts.get(annotationEvent.content_index) ?? { type: "output_text" as const, text: "", annotations: [] };
-				if (messagePart.type === "output_text" && annotationEvent.annotation) {
-					messagePart.annotations = [...(messagePart.annotations ?? []), annotationEvent.annotation];
-					state.parts.set(annotationEvent.content_index, messagePart);
-				}
-			}
-		} else if (event.type === "response.output_text.delta") {
-			const state = outputStates.get(event.output_index);
-			if (state?.kind === "message") {
-				const messagePart = state.parts.get(event.content_index) ?? { type: "output_text" as const, text: "" };
-				if (messagePart.type === "output_text") {
-					messagePart.text += event.delta;
-					state.parts.set(event.content_index, messagePart);
-					const previousText = state.block.text;
-					const nextText = renderMessageText(state.parts);
-					state.block.text = nextText;
-					emitAppendedDelta("text_delta", state.blockIndex, previousText, nextText);
-				}
-			}
-		} else if (event.type === "response.refusal.delta") {
-			const state = outputStates.get(event.output_index);
-			if (state?.kind === "message") {
-				const messagePart = state.parts.get(event.content_index) ?? { type: "refusal" as const, text: "" };
-				if (messagePart.type === "refusal") {
-					messagePart.text += event.delta;
-					state.parts.set(event.content_index, messagePart);
-					const previousText = state.block.text;
-					const nextText = renderMessageText(state.parts);
-					state.block.text = nextText;
-					emitAppendedDelta("text_delta", state.blockIndex, previousText, nextText);
-				}
-			}
-		} else if ((event as { type?: string }).type === "response.custom_tool_call_input.delta") {
-			const customEvent = event as unknown as { output_index?: number; item_id?: string; call_id?: string; delta?: string };
-			const state = findCustomToolCallState(customEvent);
-			if (state && typeof customEvent.delta === "string") {
-				state.input += customEvent.delta;
-				state.block.partialInput = state.input;
-				state.block.arguments = { input: state.input };
-				stream.push({ type: "toolcall_delta", contentIndex: state.blockIndex, delta: customEvent.delta, partial: output });
-			}
-		} else if (event.type === "response.function_call_arguments.delta") {
-			const state = outputStates.get(event.output_index);
-			if (state?.kind === "function_call") {
-				state.block.partialJson = (state.block.partialJson ?? "") + event.delta;
-				state.block.arguments = parseStreamingJson(state.block.partialJson ?? "");
-				stream.push({ type: "toolcall_delta", contentIndex: state.blockIndex, delta: event.delta, partial: output });
-			}
-		} else if (event.type === "response.function_call_arguments.done") {
-			const state = outputStates.get(event.output_index);
-			if (state?.kind === "function_call") {
-				const previousPartialJson = state.block.partialJson ?? "";
-				state.block.partialJson = event.arguments;
-				state.block.arguments = parseStreamingJson(state.block.partialJson ?? "");
-				if (event.arguments.startsWith(previousPartialJson)) {
-					const delta = event.arguments.slice(previousPartialJson.length);
-					if (delta.length > 0) {
-						stream.push({ type: "toolcall_delta", contentIndex: state.blockIndex, delta, partial: output });
-					}
-				}
-			}
-		} else if (event.type === "response.output_item.done") {
-			const item = event.item;
-			const customItem = item as unknown as { type?: string; id?: string; call_id?: string; name?: string; namespace?: string; input?: string };
-			if (item.type === "reasoning") {
-				let state = outputStates.get(event.output_index);
-				if (!state || state.kind !== "reasoning") {
-					const currentBlock: ThinkingBlock = pushResponseBlock(
-						{ type: "thinking", thinking: "" },
-						event.output_index,
-					);
-					state = { kind: "reasoning", blockIndex: blockIndex(), block: currentBlock, summaryParts: new Map() };
-					outputStates.set(event.output_index, state);
-				}
-				const summaryText = item.summary?.map((summary) => summary.text).join("\n\n") || "";
-				const contentText = (item as { content?: Array<{ text?: string }> }).content?.map((content) => content.text ?? "").filter(Boolean).join("\n\n") || "";
-				state.block.thinking = summaryText || contentText || state.block.thinking;
-				state.block.thinkingSignature = JSON.stringify(item);
-				stream.push({ type: "thinking_end", contentIndex: state.blockIndex, content: state.block.thinking, partial: output });
-				outputStates.delete(event.output_index);
-			} else if (item.type === "message") {
-				let state = outputStates.get(event.output_index);
-				if (!state || state.kind !== "message") {
-					const currentBlock: TextBlock = pushResponseBlock(
-						{ type: "text", text: "" },
-						event.output_index,
-					);
-					state = { kind: "message", blockIndex: blockIndex(), block: currentBlock, parts: new Map() };
-					outputStates.set(event.output_index, state);
-				}
-				// Null-tolerant like the reasoning branch above: OpenAI-compatible streams
-				// (e.g. vLLM) can emit an empty message item with content: null before a
-				// function_call. Without the guard, item.content.map throws and the stream
-				// aborts, silently dropping the tool call (earendil-works/pi#5819).
-				const finalContent = item.content ?? [];
-				if (finalContent.length > 0) {
-					state.parts.clear();
-					for (let contentIndex = 0; contentIndex < finalContent.length; contentIndex++) {
-						const content = finalContent[contentIndex]!;
-						const annotations = content.type === "output_text" && Array.isArray((content as { annotations?: unknown }).annotations)
-							? (content as { annotations: unknown[] }).annotations
-							: undefined;
-						state.parts.set(contentIndex, {
-							type: content.type === "output_text" ? "output_text" : "refusal",
-							text: content.type === "output_text" ? content.text : content.refusal,
-							...(annotations ? { annotations } : {}),
-						});
-					}
-				}
-				state.block.text = renderMessageText(state.parts, true);
-				state.block.textSignature = encodeTextSignature(item, state.block.text);
-				stream.push({ type: "text_end", contentIndex: state.blockIndex, content: state.block.text, partial: output });
-				outputStates.delete(event.output_index);
-			} else if (item.type === "function_call") {
-				const state = outputStates.get(event.output_index);
-				const namespace = (item as { namespace?: unknown }).namespace;
-				const thoughtSignature = encodeToolNamespaceSignature(namespace, item.name);
-				const args = state?.kind === "function_call" && state.block.partialJson
-					? parseStreamingJson(state.block.partialJson)
-					: parseStreamingJson(item.arguments || "{}");
-				const toolCall = state?.kind === "function_call"
-					? (() => {
-						state.block.arguments = args;
-						state.block.name = localToolName(namespace, item.name);
-						if (thoughtSignature) state.block.thoughtSignature = thoughtSignature;
-						delete state.block.partialJson;
-						return state.block;
-					})()
-					: (() => {
-						const fallbackToolCall: ToolCallBlock = {
-							type: "toolCall",
-							id: `${item.call_id}|${item.id}`,
-							name: localToolName((item as { namespace?: unknown }).namespace, item.name),
-							arguments: args,
-							...(thoughtSignature ? { thoughtSignature } : {}),
-						};
-						pushResponseBlock(fallbackToolCall, event.output_index);
-						return fallbackToolCall;
-					})();
-				const toolCallIndex = state?.kind === "function_call" ? state.blockIndex : blockIndex();
-				stream.push({ type: "toolcall_end", contentIndex: toolCallIndex, toolCall, partial: output });
-				outputStates.delete(event.output_index);
-			} else if (customItem.type === "custom_tool_call" && customItem.call_id && customItem.name) {
-				const state = findCustomToolCallState({
-					output_index: event.output_index,
-					item_id: customItem.id,
-					call_id: customItem.call_id,
-				});
-				const input = typeof customItem.input === "string" ? customItem.input : state?.input ?? "";
-				const thoughtSignature = encodeToolNamespaceSignature(customItem.namespace, customItem.name);
-				const toolCall = state
-					? (() => {
-						state.input = input;
-						state.block.name = localToolName(customItem.namespace, customItem.name);
-						state.block.arguments = { input };
-						if (thoughtSignature) state.block.thoughtSignature = thoughtSignature;
-						delete state.block.partialInput;
-						return state.block;
-					})()
-					: (() => {
-						const fallbackToolCall: ToolCallBlock = {
-							type: "toolCall",
-							id: `${customItem.call_id}|${customItemId(customItem.id, customItem.call_id)}`,
-							name: localToolName(customItem.namespace, customItem.name),
-							arguments: { input },
-							...(thoughtSignature ? { thoughtSignature } : {}),
-						};
-						pushResponseBlock(fallbackToolCall, event.output_index);
-						return fallbackToolCall;
-					})();
-				const toolCallIndex = state?.blockIndex ?? blockIndex();
-				stream.push({ type: "toolcall_end", contentIndex: toolCallIndex, toolCall, partial: output });
-				outputStates.delete(event.output_index);
-			} else if (item.type === "web_search_call") {
-				registerWebSearchCitationSources(item);
-				outputStates.delete(event.output_index);
-			} else if (item.type === "image_generation_call") {
-				appendImageGenerationCall(item, event.output_index);
-				outputStates.delete(event.output_index);
-			} else if (
-				(item as { type?: unknown }).type === "compaction"
-				|| (item as { type?: unknown }).type === "context_compaction"
-			) {
-				appendNativeCompaction(item, event.output_index);
-				outputStates.delete(event.output_index);
-			}
-		} else if (event.type === "response.completed" || event.type === "response.incomplete") {
-			sawTerminalResponseEvent = true;
-			const response = event.response;
-			const finalOutput = Array.isArray((response as { output?: unknown } | undefined)?.output)
-				? ((response as unknown as { output: unknown[] }).output)
-				: [];
-			for (let outputIndex = 0; outputIndex < finalOutput.length; outputIndex++) {
-				const item = finalOutput[outputIndex];
-				if ((item as { type?: unknown } | undefined)?.type === "web_search_call") {
-					registerWebSearchCitationSources(item);
-				}
-				if ((item as { type?: unknown } | undefined)?.type === "image_generation_call") {
-					appendImageGenerationCall(item, outputIndex);
-				}
-				appendNativeCompaction(item, outputIndex);
-			}
-			// Some Responses-compatible transports only include compaction in the
-			// terminal output array. Preserve its authoritative output_index instead
-			// of appending it after an already-streamed tool call.
-			normalizeResponseBlockOrder();
-			if (response?.id) output.responseId = response.id;
-			if (response?.usage) {
-				const cachedTokens = response.usage.input_tokens_details?.cached_tokens || 0;
-				const reasoningTokens = (response.usage as { output_tokens_details?: { reasoning_tokens?: number } }).output_tokens_details?.reasoning_tokens || 0;
-				output.usage = {
-					input: (response.usage.input_tokens || 0) - cachedTokens,
-					output: response.usage.output_tokens || 0,
-					cacheRead: cachedTokens,
-					cacheWrite: 0,
-					totalTokens: response.usage.total_tokens || 0,
-					cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
-				};
-				(output.usage as Usage & { reasoning?: number }).reasoning = reasoningTokens;
-			}
-			calculateCost(model, output.usage);
-			if (options?.applyServiceTierPricing) {
-				const serviceTier = options.resolveServiceTier
-					? options.resolveServiceTier(response?.service_tier, options.serviceTier)
-					: (response?.service_tier ?? options.serviceTier);
-				options.applyServiceTierPricing(output.usage, serviceTier);
-			}
-			output.stopReason = mapStopReason(response?.status);
-			if (output.content.some((block) => block.type === "toolCall") && output.stopReason === "stop") {
-				output.stopReason = "toolUse";
-			}
-		} else if (event.type === "error") {
-			const details = [event.code, event.message].filter(Boolean).join(": ");
-			throw new Error(details || "Unknown error");
-		} else if (event.type === "response.failed") {
-			sawTerminalResponseEvent = true;
-			const error = event.response?.error;
-			const details = (event.response as { incomplete_details?: { reason?: string } } | undefined)?.incomplete_details;
-			const msg = error
-				? `${error.code || "unknown"}: ${error.message || "no message"}`
-				: details?.reason
-					? `incomplete: ${details.reason}`
-					: "Unknown error (no error details in response)";
-			throw new Error(msg);
-		}
-	}
-	if (!sawTerminalResponseEvent) {
-		throw new Error("OpenAI Responses stream ended before a terminal response event");
-	}
-}
-
-function mapStopReason(status: string | undefined): AssistantMessage["stopReason"] {
-	if (!status) return "stop";
-	switch (status) {
-		case "completed":
-			return "stop";
-		case "incomplete":
-			return "length";
-		case "failed":
-		case "cancelled":
-			return "error";
-		case "in_progress":
-		case "queued":
-			return "stop";
-		default:
-			throw new Error(`Unhandled stop reason: ${status}`);
-	}
-}
+// Compatibility facade. Implementations must import their owning modules directly.
+export { collectHistoricalCitationSources, collectWebSearchCitationSources, extractWebSearchCitationSources } from "@oai404iao/pi-codex-runtime/internal/providers/responses/citations";
+export { convertResponsesMessages } from "@oai404iao/pi-codex-runtime/internal/providers/responses/messages";
+export { WEB_SEARCH_ACTIVITY_TEXT_SIGNATURE_PREFIX, decodeWebSearchActivityTextSignature, encodeWebSearchActivityTextSignature, isWebSearchActivityTextSignature } from "@oai404iao/pi-codex-runtime/internal/providers/responses/signatures";
+export { processResponsesStream } from "@oai404iao/pi-codex-runtime/internal/providers/responses/stream";
+export { convertResponsesTools } from "@oai404iao/pi-codex-runtime/internal/providers/responses/tools";
+export type { CitationSource, OpenAIResponsesStreamOptions, ReplayableWebSearchCallItem, WebSearchCitationSource } from "@oai404iao/pi-codex-runtime/internal/providers/responses/types";