@codehz/ai 0.4.2 → 0.4.4

package/dist/index.d.mts

@@ -564,49 +564,72 @@ type ResponsesAPIRequest = {
   };
   metadata?: Record<string, string>;
   temperature?: number;
-  max_output_tokens?: number;
+  max_output_tokens?: number; /** 服务端多轮续写；opaque replay 的 response id 映射到此字段，而非 item_reference */
+  previous_response_id?: string;
   stream: true;
 };
-type ResponsesInputItem = {
+/** EasyInputMessage：content 可为 string，或 input_* content parts */
+type ResponsesEasyMessage = {
   type: "message";
-  role: "user" | "assistant";
-  content: string;
+  role: "user" | "assistant" | "system" | "developer";
+  content: string | ResponsesInputContentPart[];
+};
+type ResponsesInputContentPart = {
+  type: "input_text";
+  text: string;
 } | {
-  type: "message";
-  role: "assistant";
-  content: ResponsesContentBlock[];
+  type: "input_image";
+  image_url: string;
+  detail?: "auto" | "low" | "high";
 } | {
+  type: "input_file";
+  file_url?: string;
+  file_id?: string;
+  filename?: string;
+};
+/** function_call：call_id 必填；id 是可选的 item id */
+type ResponsesFunctionCall = {
   type: "function_call";
-  id: string;
+  call_id: string;
   name: string;
   arguments: string;
-  call_id?: string;
-} | {
+  id?: string;
+  status?: "in_progress" | "completed" | "incomplete";
+};
+type ResponsesFunctionCallOutput = {
   type: "function_call_output";
   call_id: string;
   output: string;
-} | {
+  id?: string;
+  status?: "in_progress" | "completed" | "incomplete";
+};
+/** reasoning：id + summary/content/encrypted_content，不是任意 content blocks */
+type ResponsesReasoningInput = {
   type: "reasoning";
-  content: ResponsesContentBlock[];
-} | {
-  type: "item_reference";
   id: string;
+  summary: Array<{
+    type: "summary_text";
+    text: string;
+  }>;
+  content?: Array<{
+    type: "reasoning_text";
+    text: string;
+  }>;
+  encrypted_content?: string | null;
+  status?: "in_progress" | "completed" | "incomplete";
 };
-type ResponsesContentBlock = {
-  type: "text";
-  text: string;
-} | {
-  type: "reasoning";
-  text: string;
-} | {
-  type: "refusal";
-  refusal: string;
+/** 引用既有 item（不是 response id） */
+type ResponsesItemReference = {
+  type: "item_reference";
+  id: string;
 };
+type ResponsesInputItem = ResponsesEasyMessage | ResponsesFunctionCall | ResponsesFunctionCallOutput | ResponsesReasoningInput | ResponsesItemReference;
 type ResponsesTool = {
   type: "function";
   name: string;
   description?: string;
   parameters: Record<string, unknown>;
+  strict?: boolean | null;
 };
 declare class ResponsesAdapter extends AdapterBase {
   readonly kind: "responses";

package/dist/index.mjs

@@ -1732,6 +1732,12 @@ const KNOWN_RESPONSES_SSE_TYPES = /* @__PURE__ */ new Set([
 	"response.output_text.done",
 	"response.reasoning.delta",
 	"response.reasoning.done",
+	"response.reasoning_summary_part.added",
+	"response.reasoning_summary_part.done",
+	"response.reasoning_summary_text.delta",
+	"response.reasoning_summary_text.done",
+	"response.reasoning_text.delta",
+	"response.reasoning_text.done",
 	"response.function_call_arguments.delta",
 	"response.function_call_arguments.done",
 	"response.content_part.added",
@@ -1740,11 +1746,46 @@ const KNOWN_RESPONSES_SSE_TYPES = /* @__PURE__ */ new Set([
 	"response.refusal.done",
 	"response.in_progress",
 	"response.created",
+	"response.queued",
 	"response.completed",
 	"response.failed",
 	"response.incomplete",
 	"error"
 ]);
+function createReasoningState(visibility = "summary") {
+	return {
+		visibility,
+		hasDelta: false,
+		doneTexts: [],
+		completed: false
+	};
+}
+function extractReasoningFromOutputItem(item) {
+	const contentTexts = [];
+	if (Array.isArray(item.content)) {
+		for (const part of item.content) if (part && typeof part === "object" && part.type === "reasoning_text" && typeof part.text === "string") contentTexts.push(part.text);
+	}
+	const summaryTexts = [];
+	if (Array.isArray(item.summary)) {
+		for (const part of item.summary) if (part && typeof part === "object" && part.type === "summary_text" && typeof part.text === "string") summaryTexts.push(part.text);
+	}
+	if (contentTexts.length > 0) return {
+		text: contentTexts.join("\n"),
+		visibility: "full"
+	};
+	if (summaryTexts.length > 0) return {
+		text: summaryTexts.join("\n"),
+		visibility: "summary"
+	};
+	if (typeof item.encrypted_content === "string" && item.encrypted_content.length > 0) return {
+		text: "",
+		visibility: "opaque"
+	};
+	return {
+		text: "",
+		visibility: "summary"
+	};
+}
 function isReplayCanonicalInput(item) {
 	return item.type === "message" && item.role === "assistant" || item.type === "reasoning" || item.type === "function_call";
 }
@@ -1754,16 +1795,40 @@ function hasReplayCanonicalInput(input) {
 function extractFailureMessage(response) {
 	return response.error?.message ?? response.failure?.message ?? "unknown";
 }
-function canonicalToResponsesBlock(b) {
-	if (b.type === "text") return {
-		type: "text",
-		text: b.text
+function readNonEmptyString(value, maxLen = 256) {
+	if (typeof value !== "string" || value.length === 0 || value.length > maxLen) return void 0;
+	return value;
+}
+/** 将 canonical text/json blocks 压成 EasyInputMessage 的 string content。 */
+function messageContentAsString(blocks, field) {
+	return mapper$3.textFromBlocks(blocks, field);
+}
+function mapReasoningInput(item, index) {
+	const text = mapper$3.textFromBlocks(mapper$3.ensureReasoningBlocks(item.content, "reasoning content"), "reasoning content");
+	const id = item.id && item.id.length > 0 ? item.id : `reasoning_replay_${index}`;
+	if (item.visibility === "full") return {
+		type: "reasoning",
+		id,
+		summary: [],
+		content: text ? [{
+			type: "reasoning_text",
+			text
+		}] : void 0
 	};
-	if (b.type === "json") return {
-		type: "text",
-		text: JSON.stringify(b.json)
+	return {
+		type: "reasoning",
+		id,
+		summary: text ? [{
+			type: "summary_text",
+			text
+		}] : []
+	};
+}
+function extractOpaqueContinuationId(payload) {
+	return {
+		previousResponseId: readNonEmptyString(payload.previous_response_id) ?? (typeof payload.item_id === "string" ? void 0 : readNonEmptyString(payload.id)),
+		itemReferenceId: readNonEmptyString(payload.item_id)
 	};
-	throw new AIRequestError(`responses does not support content block type "${b.type}" in canonical mapping`, "UNSUPPORTED_CONTENT_BLOCK");
 }
 var ResponsesAdapter = class extends AdapterBase {
 	kind = "responses";
@@ -1779,36 +1844,23 @@ var ResponsesAdapter = class extends AdapterBase {
 	}
 	buildRequest(request) {
 		const input = [];
+		let previousResponseId;
+		let reasoningIndex = 0;
 		for (const item of request.input) switch (item.type) {
 			case "message":
-				if (item.role === "assistant") {
-					const blocks = mapper$3.ensureTextBlocks(item.content, `assistant message (${item.role}) content`).map(canonicalToResponsesBlock);
-					input.push({
-						type: "message",
-						role: item.role,
-						content: blocks
-					});
-				} else input.push({
+				input.push({
 					type: "message",
 					role: item.role,
-					content: mapper$3.textFromBlocks(item.content, `input message (${item.role}) content`)
+					content: messageContentAsString(item.content, `input message (${item.role}) content`)
 				});
 				break;
-			case "reasoning": {
-				const blocks = mapper$3.ensureReasoningBlocks(item.content, "reasoning content").map((b) => ({
-					type: "reasoning",
-					text: b.text
-				}));
-				input.push({
-					type: "reasoning",
-					content: blocks
-				});
+			case "reasoning":
+				input.push(mapReasoningInput(item, reasoningIndex++));
 				break;
-			}
 			case "tool_call":
 				input.push({
 					type: "function_call",
-					id: item.id,
+					call_id: item.id,
 					name: item.name,
 					arguments: item.argumentsText
 				});
@@ -1826,11 +1878,17 @@ var ResponsesAdapter = class extends AdapterBase {
 				if (item.source !== "responses" || item.purpose !== "replay") break;
 				assertOpaqueReplayEnvelope(item.payload);
 				const payload = item.payload;
-				if ("id" in payload) {
-					if (typeof payload.id !== "string" || payload.id.length === 0 || payload.id.length > 256) throw new AIRequestError("Invalid opaque replay payload: id must be a non-empty string (max 256)", "INVALID_OPAQUE_REPLAY");
-					if (!hasReplayCanonicalInput(input)) input.push({
+				for (const key of [
+					"id",
+					"previous_response_id",
+					"item_id"
+				]) if (key in payload && (typeof payload[key] !== "string" || payload[key].length === 0 || payload[key].length > 256)) throw new AIRequestError(`Invalid opaque replay payload: ${key} must be a non-empty string (max 256)`, "INVALID_OPAQUE_REPLAY");
+				const { previousResponseId: prevId, itemReferenceId } = extractOpaqueContinuationId(payload);
+				if (!hasReplayCanonicalInput(input)) {
+					if (prevId && !previousResponseId) previousResponseId = prevId;
+					else if (itemReferenceId) input.push({
 						type: "item_reference",
-						id: payload.id
+						id: itemReferenceId
 					});
 				}
 				break;
@@ -1841,6 +1899,7 @@ var ResponsesAdapter = class extends AdapterBase {
 			input,
 			stream: true
 		};
+		if (previousResponseId) body.previous_response_id = previousResponseId;
 		if (request.instructions) body.instructions = mapper$3.mapInstructions(request.instructions);
 		body.tools = mapper$3.mapToolsIfPresent(request.tools, (t) => ({
 			type: "function",
@@ -1879,7 +1938,28 @@ var ResponsesAdapter = class extends AdapterBase {
 		let completedResponse;
 		let unknownEventsWarned = false;
 		const messageItemsWithDelta = /* @__PURE__ */ new Set();
+		/** item_id → function name */
 		const toolCallNames = /* @__PURE__ */ new Map();
+		/** item_id → call_id（canonical ToolCallItem.id / function_call_output.call_id） */
+		const toolCallIds = /* @__PURE__ */ new Map();
+		const reasoningStates = /* @__PURE__ */ new Map();
+		const resolveToolCallId = (itemId) => toolCallIds.get(itemId) ?? itemId;
+		const ensureReasoningState = (itemId, visibility = "summary") => {
+			let state = reasoningStates.get(itemId);
+			if (!state) {
+				state = createReasoningState(visibility);
+				reasoningStates.set(itemId, state);
+			}
+			return state;
+		};
+		const completeReasoning = function* (itemId, text, visibility) {
+			const state = ensureReasoningState(itemId, visibility);
+			if (state.completed) return;
+			state.completed = true;
+			state.visibility = visibility;
+			yield factory.reasoningCompleted(itemId);
+			output.push(reasoningItem(text ? [textBlock(text)] : [], visibility, itemId));
+		};
 		for await (const batch of iterateProviderStreamBatches({
 			reader,
 			parser,
@@ -1901,18 +1981,33 @@ var ResponsesAdapter = class extends AdapterBase {
 						case "message":
 							yield factory.messageStarted(item.id);
 							break;
-						case "reasoning":
-							yield factory.reasoningStarted(item.id, "full");
+						case "reasoning": {
+							const visibility = extractReasoningFromOutputItem(item).visibility;
+							ensureReasoningState(item.id, visibility);
+							yield factory.reasoningStarted(item.id, visibility);
 							break;
+						}
 						case "function_call": {
 							const name = typeof item.name === "string" ? item.name : "unknown";
+							const callId = typeof item.call_id === "string" && item.call_id.length > 0 ? item.call_id : item.id;
 							toolCallNames.set(item.id, name);
-							yield factory.toolCallStarted(item.id, name);
+							toolCallIds.set(item.id, callId);
+							yield factory.toolCallStarted(callId, name);
 							break;
 						}
 					}
 					continue;
 				}
+				if (sseEvent.type === "response.output_item.done") {
+					const item = sseEvent.data.item;
+					if (item.type === "reasoning") {
+						const extracted = extractReasoningFromOutputItem(item);
+						const state = ensureReasoningState(item.id, extracted.visibility);
+						const text = extracted.text || (state.doneTexts.length > 0 ? state.doneTexts.join("\n") : "");
+						yield* completeReasoning(item.id, text, extracted.visibility || state.visibility);
+					}
+					continue;
+				}
 				if (sseEvent.type === "response.output_text.delta") {
 					const data = sseEvent.data;
 					yield factory.messageDelta(data.item_id, textBlock(data.delta));
@@ -1926,26 +2021,75 @@ var ResponsesAdapter = class extends AdapterBase {
 					output.push(messageItem([textBlock(data.text)], { id: data.item_id }));
 					continue;
 				}
+				if (sseEvent.type === "response.reasoning_summary_text.delta") {
+					const data = sseEvent.data;
+					const state = ensureReasoningState(data.item_id, "summary");
+					if (state.visibility === "opaque") state.visibility = "summary";
+					if (data.delta) {
+						state.hasDelta = true;
+						yield factory.reasoningDelta(data.item_id, textBlock(data.delta));
+					}
+					continue;
+				}
+				if (sseEvent.type === "response.reasoning_summary_text.done") {
+					const data = sseEvent.data;
+					const state = ensureReasoningState(data.item_id, "summary");
+					if (state.visibility === "opaque") state.visibility = "summary";
+					if (!state.hasDelta && data.text) {
+						state.doneTexts.push(data.text);
+						yield factory.reasoningDelta(data.item_id, textBlock(data.text));
+					} else if (data.text) state.doneTexts.push(data.text);
+					continue;
+				}
+				if (sseEvent.type === "response.reasoning_text.delta") {
+					const data = sseEvent.data;
+					const state = ensureReasoningState(data.item_id, "full");
+					state.visibility = "full";
+					if (data.delta) {
+						state.hasDelta = true;
+						yield factory.reasoningDelta(data.item_id, textBlock(data.delta));
+					}
+					continue;
+				}
+				if (sseEvent.type === "response.reasoning_text.done") {
+					const data = sseEvent.data;
+					const state = ensureReasoningState(data.item_id, "full");
+					state.visibility = "full";
+					if (!state.hasDelta && data.text) {
+						state.doneTexts.push(data.text);
+						yield factory.reasoningDelta(data.item_id, textBlock(data.text));
+					} else if (data.text) state.doneTexts.push(data.text);
+					continue;
+				}
+				if (sseEvent.type === "response.reasoning_summary_part.added" || sseEvent.type === "response.reasoning_summary_part.done") continue;
 				if (sseEvent.type === "response.reasoning.delta") {
 					const data = sseEvent.data;
-					yield factory.reasoningDelta(data.item_id, textBlock(data.delta));
+					const state = ensureReasoningState(data.item_id, "full");
+					state.visibility = "full";
+					if (data.delta) {
+						state.hasDelta = true;
+						yield factory.reasoningDelta(data.item_id, textBlock(data.delta));
+					}
 					continue;
 				}
 				if (sseEvent.type === "response.reasoning.done") {
 					const data = sseEvent.data;
-					yield factory.reasoningCompleted(data.item_id);
-					output.push(reasoningItem([textBlock(data.text)], "full", data.item_id));
+					const state = ensureReasoningState(data.item_id, "full");
+					if (!state.hasDelta && data.text) yield factory.reasoningDelta(data.item_id, textBlock(data.text));
+					yield* completeReasoning(data.item_id, data.text ?? state.doneTexts.join("\n"), "full");
 					continue;
 				}
 				if (sseEvent.type === "response.function_call_arguments.delta") {
 					const data = sseEvent.data;
-					if (data.delta) yield factory.toolCallDelta(data.item_id, { argumentsText: data.delta });
+					if (data.delta) yield factory.toolCallDelta(resolveToolCallId(data.item_id), { argumentsText: data.delta });
 					continue;
 				}
 				if (sseEvent.type === "response.function_call_arguments.done") {
 					const data = sseEvent.data;
-					const tcItem = toolCallItem(data.item_id, toolCallNames.get(data.item_id) ?? "unknown", data.arguments);
-					yield factory.toolCallCompleted(data.item_id);
+					const callId = resolveToolCallId(data.item_id);
+					if (!toolCallIds.has(data.item_id)) toolCallIds.set(data.item_id, callId);
+					const tcItem = toolCallItem(callId, toolCallNames.get(data.item_id) ?? "unknown", data.arguments);
+					yield factory.toolCallCompleted(callId);
 					output.push(tcItem);
 					continue;
 				}
@@ -1956,6 +2100,14 @@ var ResponsesAdapter = class extends AdapterBase {
 						continue;
 					}
 					completedResponse = data.response;
+					if (Array.isArray(data.response.output)) for (const item of data.response.output) {
+						if (item?.type !== "reasoning" || !item.id) continue;
+						const state = reasoningStates.get(item.id);
+						if (state?.completed) continue;
+						const extracted = extractReasoningFromOutputItem(item);
+						const text = extracted.text || (state && state.doneTexts.length > 0 ? state.doneTexts.join("\n") : "");
+						if (state || reasoningStates.has(item.id)) yield* completeReasoning(item.id, text, extracted.visibility);
+					}
 					if (sseEvent.type === "response.failed") yield factory.responseWarning(`Response failed: ${extractFailureMessage(data.response)}`, "PROVIDER_FAILURE");
 					continue;
 				}
@@ -1971,7 +2123,10 @@ var ResponsesAdapter = class extends AdapterBase {
 			if (completedResponse.usage) auxiliary.recordUsage(usageFromOpenAIResponses(completedResponse.usage), "final", completedResponse.usage);
 		}
 		const replay = [...replayFromOutput(output)];
-		if (completedResponse?.id) replay.push(opaqueItem("responses", "replay", { id: completedResponse.id }));
+		if (completedResponse?.id) replay.push(opaqueItem("responses", "replay", {
+			id: completedResponse.id,
+			previous_response_id: completedResponse.id
+		}));
 		const stopReason = completedResponse ? this.inferStopReason(completedResponse) : void 0;
 		if (gate.tryComplete()) yield* this.emitStreamCompleted(factory, request, auxiliary, {
 			output,