@codehz/ai 0.4.3 → 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

@@ -1795,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";
@@ -1820,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
 				});
@@ -1867,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;
@@ -1882,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",
@@ -1920,8 +1938,12 @@ 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) {
@@ -1967,8 +1989,10 @@ var ResponsesAdapter = class extends AdapterBase {
 						}
 						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;
 						}
 					}
@@ -2057,13 +2081,15 @@ var ResponsesAdapter = class extends AdapterBase {
 				}
 				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;
 				}
@@ -2097,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,