@codehz/ai 0.7.0 → 0.8.0

package/dist/index.mjs

@@ -74,7 +74,9 @@ const WarningCode = {
 	/** MCP 审批流不被支持 */
 	MCP_APPROVAL_REQUIRED: "MCP_APPROVAL_REQUIRED",
 	/** provider 侧 response.failed 等失败 */
-	PROVIDER_FAILURE: "PROVIDER_FAILURE"
+	PROVIDER_FAILURE: "PROVIDER_FAILURE",
+	/** 出站 opaque 超限被省略（避免下一轮 accept 自产毒） */
+	OPAQUE_REPLAY_OMITTED: "OPAQUE_REPLAY_OMITTED"
 };
 /**
 * 去重键：以 message 为主（与旧 string[] 行为一致）。
@@ -90,6 +92,60 @@ function supportsContextCompress(adapter) {
 	return typeof adapter.compress === "function";
 }
 //#endregion
+//#region src/runtime/normalize.ts
+const DEFAULT_INCLUDE = {
+	usage: "best_effort",
+	billing: "best_effort",
+	providerMetadata: "best_effort"
+};
+/**
+* 归一化请求：
+* 1. 合并 defaults
+* 2. 填充 include 默认值
+* 3. 生成 requestId
+* 4. 返回 provider 映射所需的归一化请求
+*/
+function normalizeRequest(request, options) {
+	const { model, defaults } = options;
+	return {
+		...defaults,
+		...request,
+		include: {
+			...DEFAULT_INCLUDE,
+			...defaults?.include,
+			...request.include
+		},
+		model,
+		requestId: crypto.randomUUID()
+	};
+}
+//#endregion
+//#region src/runtime/client.ts
+function createAIClient(options) {
+	const { adapter, model, defaults, signal: defaultSignal } = options;
+	return { stream(request) {
+		const signal = mergeAbortSignals(defaultSignal, request.signal);
+		const normalized = normalizeRequest({
+			...request,
+			signal
+		}, {
+			model,
+			defaults
+		});
+		return adapter.stream(normalized);
+	} };
+}
+/**
+* 合并多个 AbortSignal：任一 signal abort 即触发。
+* 如果没有 signal 需要合并则返回 undefined。
+*/
+function mergeAbortSignals(...signals) {
+	const valid = signals.filter((s) => s != null);
+	if (valid.length === 0) return void 0;
+	if (valid.length === 1) return valid[0];
+	return AbortSignal.any(valid);
+}
+//#endregion
 //#region src/runtime/errors.ts
 var AIError = class extends Error {
 	code;
@@ -163,369 +219,6 @@ var AIRecoverableError = class extends AIError {
 	}
 };
 //#endregion
-//#region src/runtime/validation.ts
-const MESSAGE_ROLES = /* @__PURE__ */ new Set(["user", "assistant"]);
-const REASONING_VISIBILITIES = /* @__PURE__ */ new Set([
-	"full",
-	"summary",
-	"redacted",
-	"opaque"
-]);
-const TOOL_RESULT_OUTCOMES = /* @__PURE__ */ new Set([
-	"success",
-	"error",
-	"rejected"
-]);
-const INCLUDE_MODES = /* @__PURE__ */ new Set(["off", "best_effort"]);
-function isRecord(value) {
-	return typeof value === "object" && value !== null;
-}
-function pushIssue(issues, field, code, message) {
-	issues.push({
-		field,
-		code,
-		message
-	});
-}
-function validateContentBlock(block, field, issues) {
-	if (!isRecord(block) || typeof block.type !== "string") {
-		pushIssue(issues, field, "CONTENT_BLOCK_INVALID", `${field} must be a valid ContentBlock`);
-		return;
-	}
-	switch (block.type) {
-		case "text":
-			if (typeof block.text !== "string") pushIssue(issues, field, "CONTENT_BLOCK_INVALID", `${field}.text must be a string`);
-			return;
-		case "json":
-			if (!("json" in block)) pushIssue(issues, field, "CONTENT_BLOCK_INVALID", `${field}.json must be present`);
-			return;
-		case "image":
-			if (typeof block.imageUrl !== "string" || block.imageUrl.length === 0) pushIssue(issues, field, "CONTENT_BLOCK_INVALID", `${field}.imageUrl must be a non-empty string`);
-			return;
-		case "binary_ref":
-			if (typeof block.ref !== "string" || block.ref.length === 0) pushIssue(issues, field, "CONTENT_BLOCK_INVALID", `${field}.ref must be a non-empty string`);
-			return;
-		case "opaque":
-			if (!("payload" in block)) pushIssue(issues, field, "CONTENT_BLOCK_INVALID", `${field}.payload must be present`);
-			return;
-		default: pushIssue(issues, field, "CONTENT_BLOCK_INVALID", `${field}.type "${block.type}" is not supported`);
-	}
-}
-function validateContentArray(content, field, issues, code) {
-	if (!Array.isArray(content)) {
-		pushIssue(issues, field, code, `${field} must be a ContentBlock[]`);
-		return;
-	}
-	for (let i = 0; i < content.length; i++) validateContentBlock(content[i], `${field}[${i}]`, issues);
-}
-function validateInstructionArray(content, field, issues) {
-	if (!Array.isArray(content)) {
-		pushIssue(issues, field, "INSTRUCTIONS_INVALID", `${field} must be an InstructionBlock[]`);
-		return;
-	}
-	for (let i = 0; i < content.length; i++) {
-		const block = content[i];
-		const blockField = `${field}[${i}]`;
-		validateContentBlock(block, blockField, issues);
-		if (!isRecord(block) || typeof block.type !== "string") continue;
-		if (block.type !== "text" && block.type !== "json") pushIssue(issues, blockField, "INSTRUCTIONS_INVALID", `${blockField} only supports text/json blocks`);
-	}
-}
-function validateInputItem(item, field, issues) {
-	if (!isRecord(item)) {
-		pushIssue(issues, field, "INPUT_INVALID_ITEM", `${field} must be a valid InputItem`);
-		return;
-	}
-	if (typeof item.type !== "string") {
-		pushIssue(issues, field, "INPUT_ITEM_UNKNOWN_TYPE", `${field}.type must be a supported InputItem type`);
-		return;
-	}
-	switch (item.type) {
-		case "message":
-			if (typeof item.role !== "string" || !MESSAGE_ROLES.has(item.role)) pushIssue(issues, `${field}.role`, "MESSAGE_ROLE_INVALID", `${field}.role must be a valid message role`);
-			validateContentArray(item.content, `${field}.content`, issues, "MESSAGE_CONTENT_INVALID");
-			return;
-		case "reasoning":
-			if (typeof item.visibility !== "string" || !REASONING_VISIBILITIES.has(item.visibility)) pushIssue(issues, `${field}.visibility`, "REASONING_VISIBILITY_INVALID", `${field}.visibility must be a valid reasoning visibility`);
-			validateContentArray(item.content, `${field}.content`, issues, "REASONING_CONTENT_INVALID");
-			return;
-		case "server_tool_call":
-			if (typeof item.id !== "string" || item.id.length === 0) pushIssue(issues, `${field}.id`, "SERVER_TOOL_CALL_INVALID", `${field}.id must be a non-empty string`);
-			if (typeof item.tool !== "string" || item.tool.length === 0) pushIssue(issues, `${field}.tool`, "SERVER_TOOL_CALL_INVALID", `${field}.tool must be a non-empty string`);
-			if (item.argumentsText !== void 0 && typeof item.argumentsText !== "string") pushIssue(issues, `${field}.argumentsText`, "SERVER_TOOL_CALL_INVALID", `${field}.argumentsText must be a string`);
-			return;
-		case "server_tool_result":
-			if (typeof item.callId !== "string" || item.callId.length === 0) pushIssue(issues, `${field}.callId`, "SERVER_TOOL_RESULT_INVALID", `${field}.callId must be a non-empty string`);
-			if (typeof item.tool !== "string" || item.tool.length === 0) pushIssue(issues, `${field}.tool`, "SERVER_TOOL_RESULT_INVALID", `${field}.tool must be a non-empty string`);
-			if (item.outcome !== "success" && item.outcome !== "error") pushIssue(issues, `${field}.outcome`, "SERVER_TOOL_RESULT_INVALID", `${field}.outcome must be success or error`);
-			validateContentArray(item.content, `${field}.content`, issues, "SERVER_TOOL_RESULT_INVALID");
-			return;
-		case "server_tool_discovery":
-			if (typeof item.id !== "string" || item.id.length === 0) pushIssue(issues, `${field}.id`, "SERVER_TOOL_DISCOVERY_INVALID", `${field}.id must be a non-empty string`);
-			if (item.tool !== "mcp") pushIssue(issues, `${field}.tool`, "SERVER_TOOL_DISCOVERY_INVALID", `${field}.tool must be "mcp"`);
-			if (typeof item.serverLabel !== "string" || item.serverLabel.length === 0) pushIssue(issues, `${field}.serverLabel`, "SERVER_TOOL_DISCOVERY_INVALID", `${field}.serverLabel must be a non-empty string`);
-			if (!Array.isArray(item.tools)) pushIssue(issues, `${field}.tools`, "SERVER_TOOL_DISCOVERY_INVALID", `${field}.tools must be an array`);
-			return;
-		case "tool_call":
-			if (typeof item.id !== "string" || item.id.length === 0) pushIssue(issues, `${field}.id`, "TOOL_CALL_ID_INVALID", `${field}.id must be a non-empty string`);
-			if (typeof item.name !== "string" || item.name.length === 0) pushIssue(issues, `${field}.name`, "TOOL_CALL_NAME_INVALID", `${field}.name must be a non-empty string`);
-			if (typeof item.argumentsText !== "string") pushIssue(issues, `${field}.argumentsText`, "TOOL_CALL_ARGUMENTS_INVALID", `${field}.argumentsText must be a string`);
-			return;
-		case "tool_result":
-			if (typeof item.callId !== "string" || item.callId.length === 0) pushIssue(issues, `${field}.callId`, "TOOL_RESULT_CALL_ID_INVALID", `${field}.callId must be a non-empty string`);
-			if (typeof item.toolName !== "string" || item.toolName.length === 0) pushIssue(issues, `${field}.toolName`, "TOOL_RESULT_NAME_INVALID", `${field}.toolName must be a non-empty string`);
-			if (typeof item.outcome !== "string" || !TOOL_RESULT_OUTCOMES.has(item.outcome)) pushIssue(issues, `${field}.outcome`, "TOOL_RESULT_OUTCOME_INVALID", `${field}.outcome must be success, error, or rejected`);
-			validateContentArray(item.content, `${field}.content`, issues, "TOOL_RESULT_CONTENT_INVALID");
-			return;
-		case "opaque":
-			if (typeof item.source !== "string" || item.source.length === 0) pushIssue(issues, `${field}.source`, "OPAQUE_SOURCE_INVALID", `${field}.source must be a non-empty string`);
-			if (typeof item.purpose !== "string" || item.purpose.length === 0) pushIssue(issues, `${field}.purpose`, "OPAQUE_PURPOSE_INVALID", `${field}.purpose must be a non-empty string`);
-			return;
-		default: pushIssue(issues, `${field}.type`, "INPUT_ITEM_UNKNOWN_TYPE", `${field}.type "${item.type}" is not supported`);
-	}
-}
-function validateTools(tools, issues) {
-	if (tools === void 0) return;
-	if (!Array.isArray(tools)) {
-		pushIssue(issues, "tools", "TOOLS_INVALID", "tools must be an array");
-		return;
-	}
-	const seenNames = /* @__PURE__ */ new Set();
-	for (let i = 0; i < tools.length; i++) {
-		const tool = tools[i];
-		const field = `tools[${i}]`;
-		if (!isRecord(tool)) {
-			pushIssue(issues, field, "TOOL_INVALID", `${field} must be a valid ToolDefinition`);
-			continue;
-		}
-		if (typeof tool.name !== "string" || tool.name.length === 0) pushIssue(issues, `${field}.name`, "TOOL_NAME_INVALID", `${field}.name must be a non-empty string`);
-		else {
-			if (seenNames.has(tool.name)) pushIssue(issues, `${field}.name`, "TOOLS_DUPLICATE_NAME", `tool name "${tool.name}" is duplicated`);
-			seenNames.add(tool.name);
-		}
-		if (tool.description !== void 0 && typeof tool.description !== "string") pushIssue(issues, `${field}.description`, "TOOL_DESCRIPTION_INVALID", `${field}.description must be a string`);
-		if (!isRecord(tool.inputSchema)) pushIssue(issues, `${field}.inputSchema`, "TOOL_INPUT_SCHEMA_INVALID", `${field}.inputSchema must be an object`);
-	}
-}
-const SEARCH_CONTEXT_SIZES = /* @__PURE__ */ new Set([
-	"low",
-	"medium",
-	"high"
-]);
-const CODE_MEMORY_LIMITS = /* @__PURE__ */ new Set([
-	"1g",
-	"4g",
-	"16g",
-	"64g"
-]);
-function validateStringArrayField(value, field, code, issues) {
-	if (!Array.isArray(value)) {
-		pushIssue(issues, field, code, `${field} must be a string array`);
-		return;
-	}
-	for (let i = 0; i < value.length; i++) if (typeof value[i] !== "string" || value[i].length === 0) pushIssue(issues, `${field}[${i}]`, code, `${field}[${i}] must be a non-empty string`);
-}
-function validateServerTools(serverTools, issues) {
-	if (serverTools === void 0) return;
-	if (!Array.isArray(serverTools)) {
-		pushIssue(issues, "serverTools", "SERVER_TOOLS_INVALID", "serverTools must be an array");
-		return;
-	}
-	for (let i = 0; i < serverTools.length; i++) {
-		const tool = serverTools[i];
-		const field = `serverTools[${i}]`;
-		if (!isRecord(tool) || typeof tool.type !== "string") {
-			pushIssue(issues, field, "SERVER_TOOL_INVALID", `${field} must be a valid ServerToolDefinition`);
-			continue;
-		}
-		switch (tool.type) {
-			case "web_search":
-				if (tool.allowedDomains !== void 0 && tool.blockedDomains !== void 0) pushIssue(issues, field, "SERVER_TOOL_WEB_SEARCH_DOMAINS_CONFLICT", `${field} cannot set both allowedDomains and blockedDomains`);
-				if (tool.allowedDomains !== void 0) validateStringArrayField(tool.allowedDomains, `${field}.allowedDomains`, "SERVER_TOOL_INVALID", issues);
-				if (tool.blockedDomains !== void 0) validateStringArrayField(tool.blockedDomains, `${field}.blockedDomains`, "SERVER_TOOL_INVALID", issues);
-				if (tool.searchContextSize !== void 0) {
-					if (typeof tool.searchContextSize !== "string" || !SEARCH_CONTEXT_SIZES.has(tool.searchContextSize)) pushIssue(issues, `${field}.searchContextSize`, "SERVER_TOOL_INVALID", `${field}.searchContextSize must be low, medium, or high`);
-				}
-				if (tool.userLocation !== void 0) if (!isRecord(tool.userLocation) || tool.userLocation.type !== "approximate") pushIssue(issues, `${field}.userLocation`, "SERVER_TOOL_INVALID", `${field}.userLocation must be { type: "approximate", ... }`);
-				else for (const key of [
-					"country",
-					"city",
-					"region",
-					"timezone"
-				]) {
-					const value = tool.userLocation[key];
-					if (value !== void 0 && typeof value !== "string") pushIssue(issues, `${field}.userLocation.${key}`, "SERVER_TOOL_INVALID", `${field}.userLocation.${key} must be a string`);
-				}
-				break;
-			case "code_execution":
-				if (tool.container !== void 0) if (!isRecord(tool.container) || tool.container.type !== "auto") pushIssue(issues, `${field}.container`, "SERVER_TOOL_INVALID", `${field}.container must be { type: "auto", ... }`);
-				else {
-					if (tool.container.memoryLimit !== void 0) {
-						if (typeof tool.container.memoryLimit !== "string" || !CODE_MEMORY_LIMITS.has(tool.container.memoryLimit)) pushIssue(issues, `${field}.container.memoryLimit`, "SERVER_TOOL_INVALID", `${field}.container.memoryLimit must be 1g, 4g, 16g, or 64g`);
-					}
-					if (tool.container.fileIds !== void 0) validateStringArrayField(tool.container.fileIds, `${field}.container.fileIds`, "SERVER_TOOL_INVALID", issues);
-				}
-				break;
-			case "mcp":
-				if (typeof tool.serverLabel !== "string" || tool.serverLabel.length === 0) pushIssue(issues, `${field}.serverLabel`, "SERVER_TOOL_INVALID", `${field}.serverLabel must be a non-empty string`);
-				if (typeof tool.serverUrl !== "string" || tool.serverUrl.length === 0) pushIssue(issues, `${field}.serverUrl`, "SERVER_TOOL_INVALID", `${field}.serverUrl must be a non-empty string`);
-				if (tool.serverDescription !== void 0 && typeof tool.serverDescription !== "string") pushIssue(issues, `${field}.serverDescription`, "SERVER_TOOL_INVALID", `${field}.serverDescription must be a string`);
-				if (tool.authorization !== void 0 && typeof tool.authorization !== "string") pushIssue(issues, `${field}.authorization`, "SERVER_TOOL_INVALID", `${field}.authorization must be a string`);
-				if (tool.allowedTools !== void 0) validateStringArrayField(tool.allowedTools, `${field}.allowedTools`, "SERVER_TOOL_INVALID", issues);
-				if (tool.requireApproval !== "never") pushIssue(issues, `${field}.requireApproval`, "SERVER_TOOL_MCP_APPROVAL_UNSUPPORTED", `${field}.requireApproval must be "never" in this version`);
-				break;
-			default: pushIssue(issues, `${field}.type`, "SERVER_TOOL_TYPE_UNSUPPORTED", `${field}.type "${tool.type}" is not supported`);
-		}
-	}
-}
-function validateToolChoice(toolChoice, issues) {
-	if (toolChoice === void 0) return;
-	if (toolChoice === "auto" || toolChoice === "none") return;
-	if (!isRecord(toolChoice) || toolChoice.type !== "tool" || typeof toolChoice.name !== "string" || toolChoice.name.length === 0) pushIssue(issues, "toolChoice", "TOOL_CHOICE_INVALID", "toolChoice must be auto, none, or { type: \"tool\", name }");
-}
-/** Validate include settings, appending issues to the given array. */
-function validateInclude(include, issues) {
-	if (!isRecord(include)) {
-		pushIssue(issues, "include", "INCLUDE_INVALID", "include must be an object");
-		return;
-	}
-	if (include.usage !== void 0 && (typeof include.usage !== "string" || !INCLUDE_MODES.has(include.usage))) pushIssue(issues, "include.usage", "INCLUDE_USAGE_INVALID", "include.usage must be off or best_effort");
-	if (include.billing !== void 0 && (typeof include.billing !== "string" || !INCLUDE_MODES.has(include.billing))) pushIssue(issues, "include.billing", "INCLUDE_BILLING_INVALID", "include.billing must be off or best_effort");
-	if (include.providerMetadata !== void 0 && (typeof include.providerMetadata !== "string" || !INCLUDE_MODES.has(include.providerMetadata))) pushIssue(issues, "include.providerMetadata", "INCLUDE_PROVIDER_METADATA_INVALID", "include.providerMetadata must be off or best_effort");
-}
-/**
-* 校验 AIRequest，返回校验问题列表。
-* 空数组表示无问题。
-*/
-function validateRequest(request) {
-	const issues = [];
-	if (request.instructions !== void 0) if (typeof request.instructions === "string") {} else if (Array.isArray(request.instructions)) validateInstructionArray(request.instructions, "instructions", issues);
-	else pushIssue(issues, "instructions", "INSTRUCTIONS_INVALID", "instructions must be a string or InstructionBlock[]");
-	if (!Array.isArray(request.input) || request.input.length === 0) pushIssue(issues, "input", "INPUT_EMPTY", "input must be a non-empty array");
-	if (Array.isArray(request.input)) for (let i = 0; i < request.input.length; i++) validateInputItem(request.input[i], `input[${i}]`, issues);
-	if (request.temperature !== void 0) {
-		if (typeof request.temperature !== "number" || !Number.isFinite(request.temperature)) issues.push({
-			field: "temperature",
-			code: "TEMPERATURE_NOT_NUMBER",
-			message: "temperature must be a number"
-		});
-		else if (request.temperature < 0 || request.temperature > 2) issues.push({
-			field: "temperature",
-			code: "TEMPERATURE_OUT_OF_RANGE",
-			message: "temperature must be between 0 and 2"
-		});
-	}
-	if (request.maxOutputTokens !== void 0) {
-		if (typeof request.maxOutputTokens !== "number" || !Number.isFinite(request.maxOutputTokens)) issues.push({
-			field: "maxOutputTokens",
-			code: "MAX_OUTPUT_TOKENS_NOT_NUMBER",
-			message: "maxOutputTokens must be a number"
-		});
-		else if (!Number.isInteger(request.maxOutputTokens) || request.maxOutputTokens < 1) issues.push({
-			field: "maxOutputTokens",
-			code: "MAX_OUTPUT_TOKENS_INVALID",
-			message: "maxOutputTokens must be a positive integer"
-		});
-	}
-	if (request.reasoningLevel !== void 0) {
-		if (typeof request.reasoningLevel !== "string" || !REASONING_LEVEL_SET.has(request.reasoningLevel)) pushIssue(issues, "reasoningLevel", "REASONING_LEVEL_INVALID", "reasoningLevel must be one of: none, minimal, low, medium, high, xhigh, max");
-	}
-	if (request.include !== void 0) validateInclude(request.include, issues);
-	if (request.metadata !== void 0) {
-		if (!isRecord(request.metadata)) pushIssue(issues, "metadata", "METADATA_INVALID", "metadata must be an object");
-		else for (const [key, value] of Object.entries(request.metadata)) if (typeof value !== "string") pushIssue(issues, `metadata.${key}`, "METADATA_VALUE_INVALID", `metadata.${key} must be a string`);
-	}
-	validateTools(request.tools, issues);
-	validateServerTools(request.serverTools, issues);
-	validateToolChoice(request.toolChoice, issues);
-	if (request.toolChoice && typeof request.toolChoice === "object" && "type" in request.toolChoice && request.toolChoice.type === "tool") {
-		const chosenName = request.toolChoice.name;
-		if (!request.tools || request.tools.length === 0) issues.push({
-			field: "toolChoice",
-			code: "TOOL_CHOICE_NO_TOOLS",
-			message: `toolChoice specifies tool "${chosenName}" but no tools are defined`
-		});
-		else if (!request.tools.some((t) => t.name === chosenName)) issues.push({
-			field: "toolChoice",
-			code: "TOOL_CHOICE_UNKNOWN_TOOL",
-			message: `toolChoice specifies tool "${chosenName}" which is not in tools array`
-		});
-	}
-	return issues;
-}
-/**
-* 校验请求并抛出首个问题。
-* 适用于客户端入口的快速失败检查。
-*/
-function assertValidRequest(request) {
-	const issues = validateRequest(request);
-	const first = issues[0];
-	if (first) throw new AIRequestError(first.message, first.code, issues);
-}
-//#endregion
-//#region src/runtime/normalize.ts
-const DEFAULT_INCLUDE = {
-	usage: "best_effort",
-	billing: "best_effort",
-	providerMetadata: "best_effort"
-};
-/**
-* 归一化请求：
-* 1. 合并 defaults
-* 2. 填充 include 默认值
-* 3. 生成 requestId
-* 4. 校验请求合法性
-*/
-function normalizeRequest(request, options) {
-	const { model, defaults } = options;
-	const earlyIncludeIssues = [];
-	if (request.include !== void 0) validateInclude(request.include, earlyIncludeIssues);
-	if (defaults?.include !== void 0) validateInclude(defaults.include, earlyIncludeIssues);
-	const firstIncludeIssue = earlyIncludeIssues[0];
-	if (firstIncludeIssue) throw new AIRequestError(firstIncludeIssue.message, firstIncludeIssue.code, earlyIncludeIssues);
-	const merged = {
-		...defaults,
-		...request,
-		include: {
-			...DEFAULT_INCLUDE,
-			...defaults?.include,
-			...request.include
-		}
-	};
-	assertValidRequest(merged);
-	return {
-		...merged,
-		model,
-		requestId: crypto.randomUUID()
-	};
-}
-//#endregion
-//#region src/runtime/client.ts
-function createAIClient(options) {
-	const { adapter, model, defaults, signal: defaultSignal } = options;
-	return { stream(request) {
-		const signal = mergeAbortSignals(defaultSignal, request.signal);
-		const normalized = normalizeRequest({
-			...request,
-			signal
-		}, {
-			model,
-			defaults
-		});
-		return adapter.stream(normalized);
-	} };
-}
-/**
-* 合并多个 AbortSignal：任一 signal abort 即触发。
-* 如果没有 signal 需要合并则返回 undefined。
-*/
-function mergeAbortSignals(...signals) {
-	const valid = signals.filter((s) => s != null);
-	if (valid.length === 0) return void 0;
-	if (valid.length === 1) return valid[0];
-	return AbortSignal.any(valid);
-}
-//#endregion
 //#region src/canonical/content.ts
 function textBlock(text) {
 	return {
@@ -1553,61 +1246,32 @@ function applyExtraBody(body, extraBody) {
 		...extraBody
 	};
 }
-//#endregion
-//#region src/provider/security.ts
-/**
-* Adapter 边界安全辅助
-*
-* - opaque replay 入站 envelope（大小 / 深度）
-* - provider HTTP 错误 body 出站脱敏
-*/
-const MAX_OPAQUE_PAYLOAD_BYTES = 65536;
-/** 测量 JSON 值嵌套深度（对象/数组）；循环引用按已访问节点深度计。 */
-function measureJsonDepth(value, seen = /* @__PURE__ */ new WeakSet()) {
-	if (value === null || typeof value !== "object") return 0;
-	if (seen.has(value)) return 0;
-	seen.add(value);
-	let maxChild = 0;
-	if (Array.isArray(value)) for (const item of value) maxChild = Math.max(maxChild, measureJsonDepth(item, seen));
-	else for (const key of Object.keys(value)) maxChild = Math.max(maxChild, measureJsonDepth(value[key], seen));
-	return 1 + maxChild;
-}
-/**
-* Opaque replay 通用 envelope：必须是 object、体积 ≤ 64KB、深度 ≤ 8。
-* 不校验 adapter 专用字段形状。
-*/
-function validateOpaqueReplayEnvelope(payload) {
+Number.POSITIVE_INFINITY;
+Number.POSITIVE_INFINITY;
+Number.POSITIVE_INFINITY;
+Number.POSITIVE_INFINITY;
+/** Opaque payload 必须是 object 且可被 JSON 序列化；不限制大小或深度。 */
+function validateOpaqueReplayEnvelope(payload, _options) {
 	if (typeof payload !== "object" || payload === null) return {
 		ok: false,
 		reason: "payload must be an object"
 	};
-	let raw;
 	try {
-		raw = JSON.stringify(payload);
+		if (JSON.stringify(payload) === void 0) return {
+			ok: false,
+			reason: "payload is not JSON-serializable"
+		};
 	} catch {
 		return {
 			ok: false,
 			reason: "payload is not JSON-serializable"
 		};
 	}
-	if (raw === void 0) return {
-		ok: false,
-		reason: "payload is not JSON-serializable"
-	};
-	if (raw.length > 65536) return {
-		ok: false,
-		reason: `opaque payload exceeds max size (${raw.length} > ${MAX_OPAQUE_PAYLOAD_BYTES})`
-	};
-	const depth = measureJsonDepth(payload);
-	if (depth > 8) return {
-		ok: false,
-		reason: `opaque payload nesting depth (${depth}) exceeds max (8)`
-	};
 	return { ok: true };
 }
-/** envelope 失败时抛 AIRequestError。 */
-function assertOpaqueReplayEnvelope(payload) {
-	const result = validateOpaqueReplayEnvelope(payload);
+/** envelope 失败时抛 AIRequestError（入站 accept 路径）。 */
+function assertOpaqueReplayEnvelope(payload, options) {
+	const result = validateOpaqueReplayEnvelope(payload, options);
 	if (!result.ok) throw new AIRequestError(`Invalid opaque replay payload: ${result.reason}`, "INVALID_OPAQUE_REPLAY");
 }
 /**
@@ -1838,6 +1502,8 @@ var HttpAdapterBase = class extends AdapterBase {
 	fetchFn;
 	headers;
 	extraBody;
+	/** Deprecated compatibility field; opaque replay is not size-limited. */
+	maxOpaquePayloadBytes;
 	constructor(options, defaults) {
 		super();
 		this.apiKey = options.apiKey;
@@ -1845,6 +1511,7 @@ var HttpAdapterBase = class extends AdapterBase {
 		this.fetchFn = options.fetch ?? globalThis.fetch;
 		this.headers = options.headers;
 		this.extraBody = options.extraBody;
+		this.maxOpaquePayloadBytes = options.maxOpaquePayloadBytes ?? Number.POSITIVE_INFINITY;
 	}
 	/** 合并内置 headers 与构造期自定义 headers。 */
 	mergeHeaders(base) {
@@ -2130,14 +1797,17 @@ function createNdjsonLineParser(isValid) {
 //#region src/provider/finalize-stream-turn.ts
 /**
 * 收敛 incomplete / finish 后的 replay + complete 路径。
-* adapter 负责构造 opaque payload；本 helper 统一拼接 replay 并 complete。
+* adapter 负责构造 opaque payload；本 helper 负责拼接 replay 并 complete。
+* opaque payload 不在客户端库内截断或施加大小 / 深度限制。
 */
 /**
 * 从 item session 生成 canonical replay，可选追加 opaque 尾项，再 yield session.complete。
+* 超限 opaque 会被丢弃并 yield `OPAQUE_REPLAY_OMITTED` warning。
 */
 async function* finalizeStreamTurn(session, items, options = {}) {
 	const replay = [...replayFromOutput(items.completedItems())];
-	if (options.opaque) replay.push(options.opaque);
+	let opaque = options.opaque ?? null;
+	if (opaque) replay.push(opaque);
 	yield* session.complete({
 		replay,
 		stopReason: options.stopReason,
@@ -2163,7 +1833,7 @@ const OPAQUE_SOURCE = {
 * Opaque replay 统一协议（入站薄层）
 *
 * 过滤：仅 `source === expectedSource` 且 `purpose === "replay"` 才处理，否则忽略。
-* envelope：object / ≤64KB / depth≤8；失败抛 AIRequestError / INVALID_OPAQUE_REPLAY。
+* envelope：object / ≤limit（默认 1MiB，硬顶 8MiB）/ depth≤8；失败抛 AIRequestError / INVALID_OPAQUE_REPLAY。
 * 写入 wire 尾部 assistant/model turn 前：先 rollbackTrailing*，再 append（responses 续写 id 除外）。
 * 已知 shape 非法 → 抛 INVALID_OPAQUE_REPLAY；未知 shape → 静默跳过。
 */
@@ -2171,9 +1841,9 @@ const OPAQUE_SOURCE = {
 * 接受本 adapter 的 opaque replay payload。
 * source/purpose 不匹配返回 null；匹配则 assert envelope 后返回 payload object。
 */
-function acceptOpaqueReplay(item, expectedSource) {
+function acceptOpaqueReplay(item, expectedSource, options) {
 	if (item.source !== expectedSource || item.purpose !== "replay") return null;
-	assertOpaqueReplayEnvelope(item.payload);
+	assertOpaqueReplayEnvelope(item.payload, options);
 	return item.payload;
 }
 //#endregion
@@ -2398,7 +2068,7 @@ function mapServerTools(serverTools) {
 *
 * 同时服务 stream（/responses）与 compress（/responses/compact）。
 */
-const mapper$8 = new NormalizedRequestMapper("responses");
+const mapper$7 = new NormalizedRequestMapper("responses");
 /** compact replay opaque：整份 wire output window 保真回传 */
 const RESPONSES_COMPACTED_WINDOW_KIND = "compacted_window";
 function isReplayCanonicalInput(item) {
@@ -2411,12 +2081,38 @@ 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$8.textFromBlocks(blocks, field);
+/**
+* EasyInputMessage content：
+* - 非 user：继续 text/json → string
+* - user 且含 image：input_text / input_image parts（不发 detail）
+* - user 纯 text/json：仍发 string，避免无谓 shape churn
+*/
+function mapResponsesMessageContent(role, blocks, field) {
+	if (role !== "user") return mapper$7.textFromBlocks(blocks, field);
+	mapper$7.ensureBlocks(blocks, field, [
+		"text",
+		"json",
+		"image"
+	], "only text/json/image blocks are supported");
+	if (!blocks.some((block) => block.type === "image")) return mapper$7.textFromBlocks(blocks, field);
+	return blocks.map((block) => {
+		if (block.type === "text") return {
+			type: "input_text",
+			text: block.text
+		};
+		if (block.type === "json") return {
+			type: "input_text",
+			text: JSON.stringify(block.json)
+		};
+		if (block.type === "image") return {
+			type: "input_image",
+			image_url: block.imageUrl
+		};
+		throw new AIRequestError(`${mapper$7.kind} does not support ${field} block of type "${block.type}"; only text/json/image blocks are supported`, "UNSUPPORTED_CONTENT_BLOCK");
+	});
 }
 function mapReasoningInput(item, index) {
-	const text = mapper$8.textFromBlocks(mapper$8.ensureReasoningBlocks(item.content, "reasoning content"), "reasoning content");
+	const text = mapper$7.textFromBlocks(mapper$7.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",
@@ -2465,7 +2161,7 @@ function appendCompactedWindow(input, payload) {
 * stream / compact 共享的 input + instructions + opaque 续写映射。
 * compact 不附带 tools / stream 等生成字段。
 */
-function mapResponsesCore(request) {
+function mapResponsesCore(request, options) {
 	const input = [];
 	let previousResponseId;
 	let usedCompactedWindow = false;
@@ -2475,7 +2171,7 @@ function mapResponsesCore(request) {
 			input.push({
 				type: "message",
 				role: item.role,
-				content: messageContentAsString(item.content, `input message (${item.role}) content`)
+				content: mapResponsesMessageContent(item.role, item.content, `input message (${item.role}) content`)
 			});
 			break;
 		case "reasoning":
@@ -2490,7 +2186,7 @@ function mapResponsesCore(request) {
 			});
 			break;
 		case "tool_result": {
-			const output = mapper$8.textFromBlocks(item.content, `tool_result ${item.callId} content`);
+			const output = mapper$7.textFromBlocks(item.content, `tool_result ${item.callId} content`);
 			input.push({
 				type: "function_call_output",
 				call_id: item.callId,
@@ -2499,7 +2195,7 @@ function mapResponsesCore(request) {
 			break;
 		}
 		case "opaque": {
-			const payload = acceptOpaqueReplay(item, OPAQUE_SOURCE.RESPONSES);
+			const payload = acceptOpaqueReplay(item, OPAQUE_SOURCE.RESPONSES, { maxBytes: options?.maxOpaquePayloadBytes });
 			if (!payload) break;
 			if (payload.kind === "compacted_window") {
 				assertOptionalIdFields(payload);
@@ -2526,12 +2222,12 @@ function mapResponsesCore(request) {
 		usedCompactedWindow
 	};
 	if (previousResponseId && !usedCompactedWindow) mapped.previousResponseId = previousResponseId;
-	if (request.instructions) mapped.instructions = mapper$8.mapInstructions(request.instructions);
+	if (request.instructions) mapped.instructions = mapper$7.mapInstructions(request.instructions);
 	return mapped;
 }
 /** 构建 Responses 流式请求体；调用方再 `withExtraBody` 合并构造期扩展字段。 */
-function buildResponsesRequest(request) {
-	const core = mapResponsesCore(request);
+function buildResponsesRequest(request, options) {
+	const core = mapResponsesCore(request, options);
 	const body = {
 		model: request.model,
 		input: core.input,
@@ -2539,7 +2235,7 @@ function buildResponsesRequest(request) {
 	};
 	if (core.previousResponseId) body.previous_response_id = core.previousResponseId;
 	if (core.instructions) body.instructions = core.instructions;
-	const functionTools = mapper$8.mapToolsIfPresent(request.tools, (t) => ({
+	const functionTools = mapper$7.mapToolsIfPresent(request.tools, (t) => ({
 		type: "function",
 		name: t.name,
 		description: t.description,
@@ -2548,7 +2244,7 @@ function buildResponsesRequest(request) {
 	const serverTools = mapServerTools(request.serverTools);
 	const tools = [...functionTools, ...serverTools];
 	if (tools.length > 0) body.tools = tools;
-	body.tool_choice = mapper$8.mapToolChoice(request.toolChoice, {
+	body.tool_choice = mapper$7.mapToolChoice(request.toolChoice, {
 		auto: "auto",
 		none: "none",
 		tool: (name) => ({
@@ -2566,10 +2262,10 @@ function buildResponsesRequest(request) {
 * 构建 Responses compact 请求体（POST /responses/compact）。
 * 仅映射 model / input / instructions / previous_response_id；无 stream / tools。
 */
-function buildResponsesCompactRequest(request) {
+function buildResponsesCompactRequest(request, options) {
 	if (!request.model || typeof request.model !== "string" || request.model.length === 0) throw new AIRequestError("compress requires a non-empty model", "INPUT_EMPTY");
 	if (!Array.isArray(request.input) || request.input.length === 0) throw new AIRequestError("compress requires a non-empty input", "INPUT_EMPTY");
-	const core = mapResponsesCore(request);
+	const core = mapResponsesCore(request, options);
 	const body = {
 		model: request.model,
 		input: core.input
@@ -3321,7 +3017,7 @@ var ResponsesAdapter = class extends HttpAdapterBase {
 		super(options, { baseUrl: "https://api.openai.com/v1" });
 	}
 	buildRequest(request) {
-		return this.withExtraBody(buildResponsesRequest(request));
+		return this.withExtraBody(buildResponsesRequest(request, { maxOpaquePayloadBytes: this.maxOpaquePayloadBytes }));
 	}
 	/**
 	* 原生上下文压缩：POST /responses/compact。
@@ -3329,7 +3025,7 @@ var ResponsesAdapter = class extends HttpAdapterBase {
 	*/
 	async compress(request) {
 		request.signal?.throwIfAborted();
-		const body = this.withExtraBody(buildResponsesCompactRequest(request));
+		const body = this.withExtraBody(buildResponsesCompactRequest(request, { maxOpaquePayloadBytes: this.maxOpaquePayloadBytes }));
 		const { data } = await postProviderJson({
 			fetchFn: this.fetchFn,
 			url: `${this.baseUrl}/responses/compact`,
@@ -3346,6 +3042,7 @@ var ResponsesAdapter = class extends HttpAdapterBase {
 			output: data.output
 		};
 		if (typeof data.id === "string" && data.id.length > 0 && data.id.length <= 256) payload.id = data.id;
+		assertOpaqueReplayEnvelope(payload, { maxBytes: this.maxOpaquePayloadBytes });
 		const result = { replay: [opaqueItem(OPAQUE_SOURCE.RESPONSES, "replay", payload)] };
 		if (data.usage) {
 			const usage = usageFromOpenAIResponses(data.usage);
@@ -3394,21 +3091,62 @@ var ResponsesAdapter = class extends HttpAdapterBase {
 			}) : null,
 			stopReason,
 			rawResponseId,
+			factory,
+			maxOpaquePayloadBytes: this.maxOpaquePayloadBytes,
 			onDuplicate: "silent"
 		});
 	}
 };
+const SUPPORTED_IMAGE_MEDIA_TYPE_SET = /* @__PURE__ */ new Set([
+	"image/jpeg",
+	"image/png",
+	"image/gif",
+	"image/webp"
+]);
+/** True when imageUrl is an http(s) URL with a non-empty host. */
+function isHttpOrHttpsUrl(imageUrl) {
+	try {
+		const url = new URL(imageUrl);
+		return (url.protocol === "http:" || url.protocol === "https:") && url.host.length > 0;
+	} catch {
+		return false;
+	}
+}
+/**
+* Parse `data:image/(jpeg|png|gif|webp);base64,<data>`.
+* Rejects other media types, non-base64 data URLs, and empty payloads.
+* Does not accept whitespace inside the base64 payload.
+*/
+function parseImageDataUrl(imageUrl) {
+	const match = /^data:([^;,]+);base64,([A-Za-z0-9+/]+={0,2})$/i.exec(imageUrl);
+	if (!match) return null;
+	const mediaType = match[1]?.trim().toLowerCase();
+	const data = match[2];
+	if (!mediaType || !data || !SUPPORTED_IMAGE_MEDIA_TYPE_SET.has(mediaType)) return null;
+	return {
+		mediaType,
+		data
+	};
+}
 //#endregion
 //#region src/adapters/messages/map-request.ts
 /**
 * MessagesAdapter — request 映射
 */
-const mapper$7 = new NormalizedRequestMapper("messages");
+const mapper$6 = new NormalizedRequestMapper("messages");
 function isMessagesReplayContentBlock(value) {
 	if (!value || typeof value !== "object" || !("type" in value)) return false;
 	const block = value;
 	switch (block.type) {
 		case "text": return typeof block.text === "string";
+		case "image": {
+			const source = block.source;
+			if (!source || typeof source !== "object") return false;
+			const imageSource = source;
+			if (imageSource.type === "url") return typeof imageSource.url === "string" && imageSource.url.length > 0;
+			if (imageSource.type === "base64") return typeof imageSource.media_type === "string" && typeof imageSource.data === "string" && imageSource.data.length > 0 && (imageSource.media_type === "image/jpeg" || imageSource.media_type === "image/png" || imageSource.media_type === "image/gif" || imageSource.media_type === "image/webp");
+			return false;
+		}
 		case "thinking": return typeof block.thinking === "string" && (block.signature === void 0 || typeof block.signature === "string");
 		case "redacted_thinking": return typeof block.data === "string";
 		case "tool_use": return typeof block.id === "string" && typeof block.name === "string" && !!block.input && typeof block.input === "object" && !Array.isArray(block.input);
@@ -3425,7 +3163,26 @@ function assertMessagesReplayContent(content) {
 	if (!Array.isArray(content)) throw new AIRequestError("Invalid opaque replay payload: content must be an array", "INVALID_OPAQUE_REPLAY");
 	for (let i = 0; i < content.length; i++) if (!isMessagesReplayContentBlock(content[i])) throw new AIRequestError(`Invalid opaque replay payload: content[${i}] is not a valid Messages content block`, "INVALID_OPAQUE_REPLAY");
 }
-function canonicalToMessagesBlock(b) {
+function mapMessagesImageBlock(imageUrl, field) {
+	const dataUrl = parseImageDataUrl(imageUrl);
+	if (dataUrl) return {
+		type: "image",
+		source: {
+			type: "base64",
+			media_type: dataUrl.mediaType,
+			data: dataUrl.data
+		}
+	};
+	if (isHttpOrHttpsUrl(imageUrl)) return {
+		type: "image",
+		source: {
+			type: "url",
+			url: imageUrl
+		}
+	};
+	throw new AIRequestError(`messages cannot map ${field} imageUrl without a http(s) URL or data:image/(jpeg|png|gif|webp);base64,... payload`, "UNSUPPORTED_CONTENT_BLOCK");
+}
+function canonicalToMessagesBlock(b, field = "canonical mapping") {
 	if (b.type === "text") return {
 		type: "text",
 		text: b.text
@@ -3434,27 +3191,48 @@ function canonicalToMessagesBlock(b) {
 		type: "text",
 		text: JSON.stringify(b.json)
 	};
-	throw new AIRequestError(`messages does not support content block type "${b.type}" in canonical mapping`, "UNSUPPORTED_CONTENT_BLOCK");
-}
-function buildMessagesRequest(request) {
-	mapper$7.assertNoServerTools(request.serverTools);
+	if (b.type === "image") return mapMessagesImageBlock(b.imageUrl, field);
+	throw new AIRequestError(`messages does not support content block type "${b.type}" in ${field}`, "UNSUPPORTED_CONTENT_BLOCK");
+}
+function mapMessagesUserContent(blocks, field) {
+	mapper$6.ensureBlocks(blocks, field, [
+		"text",
+		"json",
+		"image"
+	], "only text/json/image blocks are supported");
+	if (!blocks.some((block) => block.type === "image")) {
+		const supportedContent = mapper$6.ensureTextBlocks(blocks, field);
+		if (supportedContent.length === 1 && supportedContent[0]?.type === "text") return supportedContent[0].text;
+		return supportedContent.map((block) => canonicalToMessagesBlock(block, field));
+	}
+	return blocks.map((block) => canonicalToMessagesBlock(block, field));
+}
+function buildMessagesRequest(request, options) {
+	mapper$6.assertNoServerTools(request.serverTools);
 	const messages = [];
 	let systemPrompt;
 	let pendingToolResultMessage;
-	if (request.instructions) systemPrompt = mapper$7.mapInstructions(request.instructions);
+	if (request.instructions) systemPrompt = mapper$6.mapInstructions(request.instructions);
 	for (const item of request.input) {
 		if (item.type !== "tool_result") pendingToolResultMessage = void 0;
 		switch (item.type) {
 			case "message": {
-				const role = item.role === "user" ? "user" : "assistant";
-				const supportedContent = mapper$7.ensureTextBlocks(item.content, `input message (${item.role}) content`);
+				const field = `input message (${item.role}) content`;
+				if (item.role === "user") {
+					messages.push({
+						role: "user",
+						content: mapMessagesUserContent(item.content, field)
+					});
+					break;
+				}
+				const supportedContent = mapper$6.ensureTextBlocks(item.content, field);
 				if (supportedContent.length === 1 && supportedContent[0]?.type === "text") messages.push({
-					role,
+					role: "assistant",
 					content: supportedContent[0].text
 				});
 				else messages.push({
-					role,
-					content: supportedContent.map(canonicalToMessagesBlock)
+					role: "assistant",
+					content: supportedContent.map((block) => canonicalToMessagesBlock(block, field))
 				});
 				break;
 			}
@@ -3464,7 +3242,7 @@ function buildMessagesRequest(request) {
 					type: "tool_use",
 					id: item.id,
 					name: item.name,
-					input: mapper$7.parseToolArguments(item)
+					input: mapper$6.parseToolArguments(item)
 				};
 				if (lastMsg && lastMsg.role === "assistant" && typeof lastMsg.content !== "string") lastMsg.content.push(toolBlock);
 				else messages.push({
@@ -3474,7 +3252,7 @@ function buildMessagesRequest(request) {
 				break;
 			}
 			case "tool_result": {
-				const content = mapper$7.textFromBlocks(item.content, `tool_result ${item.callId} content`);
+				const content = mapper$6.textFromBlocks(item.content, `tool_result ${item.callId} content`);
 				const block = {
 					type: "tool_result",
 					tool_use_id: item.callId,
@@ -3494,7 +3272,7 @@ function buildMessagesRequest(request) {
 			case "reasoning": {
 				const block = {
 					type: "thinking",
-					thinking: contentBlocksToText(mapper$7.ensureReasoningBlocks(item.content, "reasoning content"))
+					thinking: contentBlocksToText(mapper$6.ensureReasoningBlocks(item.content, "reasoning content"))
 				};
 				const lastMsg = messages[messages.length - 1];
 				if (lastMsg && lastMsg.role === "assistant" && typeof lastMsg.content !== "string") lastMsg.content.push(block);
@@ -3505,11 +3283,11 @@ function buildMessagesRequest(request) {
 				break;
 			}
 			case "opaque": {
-				const payload = acceptOpaqueReplay(item, OPAQUE_SOURCE.MESSAGES);
+				const payload = acceptOpaqueReplay(item, OPAQUE_SOURCE.MESSAGES, { maxBytes: options?.maxOpaquePayloadBytes });
 				if (!payload) break;
 				if (payload.role === "assistant" && "content" in payload) {
 					assertMessagesReplayContent(payload.content);
-					mapper$7.rollbackTrailingAssistantMessages(messages);
+					mapper$6.rollbackTrailingAssistantMessages(messages);
 					messages.push({
 						role: "assistant",
 						content: payload.content
@@ -3526,12 +3304,12 @@ function buildMessagesRequest(request) {
 		stream: true
 	};
 	if (systemPrompt) body.system = systemPrompt;
-	body.tools = mapper$7.mapToolsIfPresent(request.tools, (t) => ({
+	body.tools = mapper$6.mapToolsIfPresent(request.tools, (t) => ({
 		name: t.name,
 		description: t.description,
 		input_schema: t.inputSchema
 	}));
-	body.tool_choice = mapper$7.mapToolChoice(request.toolChoice, {
+	body.tool_choice = mapper$6.mapToolChoice(request.toolChoice, {
 		auto: { type: "auto" },
 		none: { type: "none" },
 		tool: (name) => ({
@@ -3743,6 +3521,8 @@ async function* mapMessagesStream(host, providerRequest, factory, request) {
 		}) : null,
 		stopReason: stopReason ? mapStopReason(stopReason) : void 0,
 		rawResponseId,
+		factory,
+		maxOpaquePayloadBytes: host.maxOpaquePayloadBytes,
 		onDuplicate: "silent"
 	});
 }
@@ -3762,7 +3542,7 @@ var MessagesAdapter = class extends HttpAdapterBase {
 		this.apiVersion = options.apiVersion ?? "2023-06-01";
 	}
 	buildRequest(request) {
-		return this.withExtraBody(buildMessagesRequest(request));
+		return this.withExtraBody(buildMessagesRequest(request, { maxOpaquePayloadBytes: this.maxOpaquePayloadBytes }));
 	}
 	async *runStream(providerRequest, factory, request) {
 		yield* mapMessagesStream({
@@ -3770,7 +3550,8 @@ var MessagesAdapter = class extends HttpAdapterBase {
 			baseUrl: this.baseUrl,
 			apiKey: this.apiKey,
 			mergeHeaders: this.mergeHeaders.bind(this),
-			apiVersion: this.apiVersion
+			apiVersion: this.apiVersion,
+			maxOpaquePayloadBytes: this.maxOpaquePayloadBytes
 		}, providerRequest, factory, request);
 	}
 };
@@ -3794,7 +3575,51 @@ const REASONING_FIELDS = ["reasoning_content", "reasoning"];
 /**
 * ChatCompletionsAdapter — request 映射
 */
-const mapper$5 = new NormalizedRequestMapper("chat-completions");
+const mapper$4 = new NormalizedRequestMapper("chat-completions");
+function extractReasoningText(value) {
+	if (typeof value === "string") return value;
+	if (Array.isArray(value)) return value.map(extractReasoningText).join("");
+	if (value && typeof value === "object") {
+		const record = value;
+		for (const key of [
+			"text",
+			"content",
+			"reasoning",
+			"reasoning_content",
+			"thinking",
+			"value"
+		]) {
+			const nested = extractReasoningText(record[key]);
+			if (nested) return nested;
+		}
+	}
+	return "";
+}
+function extractReasoningDeltas(delta) {
+	const deltas = [];
+	for (const field of REASONING_FIELDS) {
+		const text = extractReasoningText(delta[field]);
+		if (text) deltas.push({
+			field,
+			text
+		});
+	}
+	return deltas;
+}
+function isChatReplayContentPart(value) {
+	if (!value || typeof value !== "object") return false;
+	const part = value;
+	if (part.type === "text") return typeof part.text === "string";
+	if (part.type === "image_url") {
+		const imageUrl = part.image_url;
+		if (!imageUrl || typeof imageUrl !== "object") return false;
+		const image = imageUrl;
+		if (typeof image.url !== "string") return false;
+		if (image.detail !== void 0 && image.detail !== "auto" && image.detail !== "low" && image.detail !== "high") return false;
+		return true;
+	}
+	return false;
+}
 function isChatReplayToolCall(value) {
 	if (!value || typeof value !== "object") return false;
 	const entry = value;
@@ -3809,7 +3634,8 @@ function isChatReplayMessage(value) {
 	const msg = value;
 	const role = msg.role;
 	if (role !== "system" && role !== "user" && role !== "assistant" && role !== "tool") return false;
-	if (!(msg.content === null || typeof msg.content === "string")) return false;
+	const content = msg.content;
+	if (!(content === null || typeof content === "string" || Array.isArray(content) && content.every(isChatReplayContentPart))) return false;
 	if (msg.tool_calls !== void 0) {
 		if (!Array.isArray(msg.tool_calls) || !msg.tool_calls.every(isChatReplayToolCall)) return false;
 	}
@@ -3821,20 +3647,64 @@ function assertChatReplayMessages(messages, field) {
 	if (!Array.isArray(messages)) throw new AIRequestError(`Invalid opaque replay payload: ${field} must be an array`, "INVALID_OPAQUE_REPLAY");
 	for (let i = 0; i < messages.length; i++) if (!isChatReplayMessage(messages[i])) throw new AIRequestError(`Invalid opaque replay payload: ${field}[${i}] is not a valid chat message`, "INVALID_OPAQUE_REPLAY");
 }
-function buildChatCompletionsRequest(request) {
-	mapper$5.assertNoServerTools(request.serverTools);
+function buildAssistantReplayMessage(params) {
+	const { content, reasoningByField, toolCalls } = params;
+	if (!content && reasoningByField.size === 0 && toolCalls.length === 0) return null;
+	const replayMessage = {
+		role: "assistant",
+		content: content || null
+	};
+	for (const [field, text] of reasoningByField) replayMessage[field] = text;
+	if (toolCalls.length > 0) replayMessage.tool_calls = toolCalls.map((toolCall) => ({
+		id: toolCall.id,
+		type: "function",
+		function: {
+			name: toolCall.name,
+			arguments: toolCall.args
+		}
+	}));
+	return replayMessage;
+}
+function mapChatUserContent(blocks, field) {
+	mapper$4.ensureBlocks(blocks, field, [
+		"text",
+		"json",
+		"image"
+	], "only text/json/image blocks are supported");
+	if (!blocks.some((block) => block.type === "image")) return contentBlocksToText(blocks) || null;
+	return blocks.map((block) => {
+		if (block.type === "text") return {
+			type: "text",
+			text: block.text
+		};
+		if (block.type === "json") return {
+			type: "text",
+			text: JSON.stringify(block.json)
+		};
+		if (block.type === "image") return {
+			type: "image_url",
+			image_url: { url: block.imageUrl }
+		};
+		throw new AIRequestError(`${mapper$4.kind} does not support ${field} block of type "${block.type}"; only text/json/image blocks are supported`, "UNSUPPORTED_CONTENT_BLOCK");
+	});
+}
+function mapChatMessageContent(role, blocks, field) {
+	if (role === "user") return mapChatUserContent(blocks, field);
+	return mapper$4.textFromBlocks(blocks, field) || null;
+}
+function buildChatCompletionsRequest(request, options) {
+	mapper$4.assertNoServerTools(request.serverTools);
 	const messages = [];
 	if (request.instructions) messages.push({
 		role: "system",
-		content: mapper$5.mapInstructions(request.instructions)
+		content: mapper$4.mapInstructions(request.instructions)
 	});
 	for (const item of request.input) switch (item.type) {
 		case "message": {
 			const role = item.role;
-			const text = mapper$5.textFromBlocks(item.content, `input message (${item.role}) content`);
 			messages.push({
 				role,
-				content: text || null
+				content: mapChatMessageContent(role, item.content, `input message (${item.role}) content`)
 			});
 			break;
 		}
@@ -3861,21 +3731,21 @@ function buildChatCompletionsRequest(request) {
 				role: "tool",
 				tool_call_id: item.callId,
 				name: item.toolName,
-				content: mapper$5.textFromBlocks(item.content, `tool_result ${item.callId} content`)
+				content: mapper$4.textFromBlocks(item.content, `tool_result ${item.callId} content`)
 			});
 			break;
 		case "reasoning":
 			messages.push({
 				role: "assistant",
-				content: mapper$5.textFromBlocks(item.content, "reasoning content")
+				content: mapper$4.textFromBlocks(item.content, "reasoning content")
 			});
 			break;
 		case "opaque": {
-			const payload = acceptOpaqueReplay(item, OPAQUE_SOURCE.CHAT_COMPLETIONS);
+			const payload = acceptOpaqueReplay(item, OPAQUE_SOURCE.CHAT_COMPLETIONS, { maxBytes: options?.maxOpaquePayloadBytes });
 			if (!payload) break;
 			if ("messages" in payload) {
 				assertChatReplayMessages(payload.messages, "messages");
-				mapper$5.rollbackTrailingAssistantMessages(messages);
+				mapper$4.rollbackTrailingAssistantMessages(messages);
 				for (const m of payload.messages) messages.push(m);
 			}
 			break;
@@ -3887,8 +3757,8 @@ function buildChatCompletionsRequest(request) {
 		stream: true,
 		n: 1
 	};
-	body.tools = mapper$5.mapToolsIfPresent(request.tools, mapOpenAiFunctionTool);
-	body.tool_choice = mapper$5.mapToolChoice(request.toolChoice, {
+	body.tools = mapper$4.mapToolsIfPresent(request.tools, mapOpenAiFunctionTool);
+	body.tool_choice = mapper$4.mapToolChoice(request.toolChoice, {
 		auto: "auto",
 		none: "none",
 		tool: (name) => ({
@@ -3902,55 +3772,11 @@ function buildChatCompletionsRequest(request) {
 	if (request.reasoningLevel !== void 0) body.reasoning_effort = mapChatCompletionsReasoningEffort(request.reasoningLevel);
 	return body;
 }
-new NormalizedRequestMapper("chat-completions");
-function extractReasoningText(value) {
-	if (typeof value === "string") return value;
-	if (Array.isArray(value)) return value.map(extractReasoningText).join("");
-	if (value && typeof value === "object") {
-		const record = value;
-		for (const key of [
-			"text",
-			"content",
-			"reasoning",
-			"reasoning_content",
-			"thinking",
-			"value"
-		]) {
-			const nested = extractReasoningText(record[key]);
-			if (nested) return nested;
-		}
-	}
-	return "";
-}
-function extractReasoningDeltas(delta) {
-	const deltas = [];
-	for (const field of REASONING_FIELDS) {
-		const text = extractReasoningText(delta[field]);
-		if (text) deltas.push({
-			field,
-			text
-		});
-	}
-	return deltas;
-}
-function buildAssistantReplayMessage(params) {
-	const { content, reasoningByField, toolCalls } = params;
-	if (!content && reasoningByField.size === 0 && toolCalls.length === 0) return null;
-	const replayMessage = {
-		role: "assistant",
-		content: content || null
-	};
-	for (const [field, text] of reasoningByField) replayMessage[field] = text;
-	if (toolCalls.length > 0) replayMessage.tool_calls = toolCalls.map((toolCall) => ({
-		id: toolCall.id,
-		type: "function",
-		function: {
-			name: toolCall.name,
-			arguments: toolCall.args
-		}
-	}));
-	return replayMessage;
-}
+//#endregion
+//#region src/adapters/chat-completions/map-stream.ts
+/**
+* ChatCompletionsAdapter — stream 映射
+*/
 async function* mapChatCompletionsStream(host, providerRequest, factory, request) {
 	const session = host.beginJsonStream(factory, request);
 	const { auxiliary, gate } = session;
@@ -4019,6 +3845,8 @@ async function* mapChatCompletionsStream(host, providerRequest, factory, request
 		yield* finalizeStreamTurn(session, items, {
 			stopReason,
 			rawResponseId,
+			factory,
+			maxOpaquePayloadBytes: host.maxOpaquePayloadBytes,
 			opaque: assistantReplayMessage ? opaqueItem(OPAQUE_SOURCE.CHAT_COMPLETIONS, "replay", {
 				replaceCanonical: true,
 				messages: [assistantReplayMessage]
@@ -4171,14 +3999,15 @@ var ChatCompletionsAdapter = class extends HttpAdapterBase {
 		super(options, { baseUrl: "https://api.openai.com/v1" });
 	}
 	buildRequest(request) {
-		return this.withExtraBody(buildChatCompletionsRequest(request));
+		return this.withExtraBody(buildChatCompletionsRequest(request, { maxOpaquePayloadBytes: this.maxOpaquePayloadBytes }));
 	}
 	async *runStream(providerRequest, factory, request) {
 		yield* mapChatCompletionsStream({
 			beginJsonStream: this.beginJsonStream.bind(this),
 			baseUrl: this.baseUrl,
 			apiKey: this.apiKey,
-			mergeHeaders: this.mergeHeaders.bind(this)
+			mergeHeaders: this.mergeHeaders.bind(this),
+			maxOpaquePayloadBytes: this.maxOpaquePayloadBytes
 		}, providerRequest, factory, request);
 	}
 };
@@ -4203,7 +4032,32 @@ function toWireOllamaToolCalls(toolCalls) {
 		arguments: tc.function.arguments
 	} }));
 }
-function buildOllamaRequest(request) {
+function mapOllamaImageData(imageUrl, field) {
+	const dataUrl = parseImageDataUrl(imageUrl);
+	if (!dataUrl) throw new AIRequestError(`ollama cannot map ${field} imageUrl without fetching; only data:image/(jpeg|png|gif|webp);base64,... is supported`, "UNSUPPORTED_CONTENT_BLOCK");
+	return dataUrl.data;
+}
+function mapOllamaUserMessage(blocks, field) {
+	mapper$3.ensureBlocks(blocks, field, [
+		"text",
+		"json",
+		"image"
+	], "only text/json/image blocks are supported");
+	const images = [];
+	const textBlocks = [];
+	for (const block of blocks) {
+		if (block.type === "image") {
+			images.push(mapOllamaImageData(block.imageUrl, field));
+			continue;
+		}
+		textBlocks.push(block);
+	}
+	return {
+		content: contentBlocksToText(textBlocks),
+		...images.length > 0 ? { images } : {}
+	};
+}
+function buildOllamaRequest(request, options) {
 	mapper$3.assertNoServerTools(request.serverTools);
 	const messages = [];
 	/** Local-only name → call id queue for best-effort tool_result association (not sent to Ollama). */
@@ -4214,10 +4068,17 @@ function buildOllamaRequest(request) {
 	});
 	for (const item of request.input) switch (item.type) {
 		case "message": {
-			const role = item.role;
+			const field = `input message (${item.role}) content`;
+			if (item.role === "user") {
+				messages.push({
+					role: "user",
+					...mapOllamaUserMessage(item.content, field)
+				});
+				break;
+			}
 			messages.push({
-				role,
-				content: mapper$3.textFromBlocks(item.content, `input message (${item.role}) content`)
+				role: item.role,
+				content: mapper$3.textFromBlocks(item.content, field)
 			});
 			break;
 		}
@@ -4254,7 +4115,7 @@ function buildOllamaRequest(request) {
 			});
 			break;
 		case "opaque": {
-			const payload = acceptOpaqueReplay(item, OPAQUE_SOURCE.OLLAMA);
+			const payload = acceptOpaqueReplay(item, OPAQUE_SOURCE.OLLAMA, { maxBytes: options?.maxOpaquePayloadBytes });
 			if (!payload) break;
 			if (payload.role === "assistant" && typeof payload.content === "string") {
 				mapper$3.rollbackTrailingAssistantMessages(messages);
@@ -4339,6 +4200,8 @@ async function* mapOllamaStream(host, providerRequest, factory, request) {
 		yield* finalizeStreamTurn(session, items, {
 			stopReason,
 			rawResponseId,
+			factory,
+			maxOpaquePayloadBytes: host.maxOpaquePayloadBytes,
 			opaque: accumulatedContent || pendingToolCalls.length > 0 ? opaqueItem(OPAQUE_SOURCE.OLLAMA, "replay", {
 				role: "assistant",
 				content: accumulatedContent,
@@ -4417,14 +4280,15 @@ var OllamaAdapter = class extends HttpAdapterBase {
 		super(options, { baseUrl: "http://localhost:11434" });
 	}
 	buildRequest(request) {
-		return this.withExtraBody(buildOllamaRequest(request));
+		return this.withExtraBody(buildOllamaRequest(request, { maxOpaquePayloadBytes: this.maxOpaquePayloadBytes }));
 	}
 	async *runStream(providerRequest, factory, request) {
 		yield* mapOllamaStream({
 			beginJsonStream: this.beginJsonStream.bind(this),
 			baseUrl: this.baseUrl,
 			apiKey: this.apiKey,
-			mergeHeaders: this.mergeHeaders.bind(this)
+			mergeHeaders: this.mergeHeaders.bind(this),
+			maxOpaquePayloadBytes: this.maxOpaquePayloadBytes
 		}, providerRequest, factory, request);
 	}
 };
@@ -4458,6 +4322,14 @@ function appendPart(contents, role, part) {
 		parts: [part]
 	});
 }
+function mapGeminiImagePart(imageUrl, field) {
+	const dataUrl = parseImageDataUrl(imageUrl);
+	if (!dataUrl) throw new AIRequestError(`gemini cannot map ${field} imageUrl without fetching; only data:image/(jpeg|png|gif|webp);base64,... is supported`, "UNSUPPORTED_CONTENT_BLOCK");
+	return { inlineData: {
+		mimeType: dataUrl.mediaType,
+		data: dataUrl.data
+	} };
+}
 function textPartsFromBlocks(blocks, field) {
 	return mapper$1.ensureTextBlocks(blocks, field).map((block) => {
 		if (block.type === "text") return { text: block.text };
@@ -4465,6 +4337,20 @@ function textPartsFromBlocks(blocks, field) {
 		throw new AIRequestError(`gemini does not support content block type "${block.type}" in ${field}`, "UNSUPPORTED_CONTENT_BLOCK");
 	});
 }
+function partsFromUserBlocks(blocks, field) {
+	mapper$1.ensureBlocks(blocks, field, [
+		"text",
+		"json",
+		"image"
+	], "only text/json/image blocks are supported");
+	if (!blocks.some((block) => block.type === "image")) return textPartsFromBlocks(blocks, field);
+	return blocks.map((block) => {
+		if (block.type === "text") return { text: block.text };
+		if (block.type === "json") return { text: JSON.stringify(block.json) };
+		if (block.type === "image") return mapGeminiImagePart(block.imageUrl, field);
+		throw new AIRequestError(`gemini does not support content block type "${block.type}" in ${field}`, "UNSUPPORTED_CONTENT_BLOCK");
+	});
+}
 function clonePart$1(part) {
 	return { ...part };
 }
@@ -4474,15 +4360,17 @@ function cloneContent(content) {
 		parts: content.parts.map(clonePart$1)
 	};
 }
-function buildGeminiRequest(request) {
+function buildGeminiRequest(request, options) {
 	mapper$1.assertNoServerTools(request.serverTools);
 	const contents = [];
 	let systemInstruction;
 	if (request.instructions) systemInstruction = { parts: [{ text: mapper$1.mapInstructions(request.instructions) }] };
 	for (const item of request.input) switch (item.type) {
 		case "message": {
+			const field = `input message (${item.role}) content`;
 			const role = item.role === "assistant" ? "model" : "user";
-			for (const part of textPartsFromBlocks(item.content, `input message (${item.role}) content`)) appendPart(contents, role, part);
+			const parts = item.role === "user" ? partsFromUserBlocks(item.content, field) : textPartsFromBlocks(item.content, field);
+			for (const part of parts) appendPart(contents, role, part);
 			break;
 		}
 		case "tool_call":
@@ -4515,7 +4403,7 @@ function buildGeminiRequest(request) {
 			});
 			break;
 		case "opaque": {
-			const payload = acceptOpaqueReplay(item, OPAQUE_SOURCE.GEMINI);
+			const payload = acceptOpaqueReplay(item, OPAQUE_SOURCE.GEMINI, { maxBytes: options?.maxOpaquePayloadBytes });
 			if (!payload) break;
 			if (payload.replaceCanonical === true && "content" in payload) {
 				assertGeminiReplayContent(payload.content, "content");
@@ -4628,6 +4516,8 @@ async function* mapGeminiStream(host, providerRequest, factory, request) {
 		yield* finalizeStreamTurn(session, items, {
 			stopReason: reason,
 			rawResponseId,
+			factory,
+			maxOpaquePayloadBytes: host.maxOpaquePayloadBytes,
 			opaque: replayParts.length > 0 ? opaqueItem(OPAQUE_SOURCE.GEMINI, "replay", {
 				replaceCanonical: true,
 				content: {
@@ -4713,14 +4603,15 @@ var GeminiAdapter = class extends HttpAdapterBase {
 		super(options, { baseUrl: "https://generativelanguage.googleapis.com/v1beta" });
 	}
 	buildRequest(request) {
-		return this.withExtraBody(buildGeminiRequest(request));
+		return this.withExtraBody(buildGeminiRequest(request, { maxOpaquePayloadBytes: this.maxOpaquePayloadBytes }));
 	}
 	async *runStream(providerRequest, factory, request) {
 		yield* mapGeminiStream({
 			beginJsonStream: this.beginJsonStream.bind(this),
 			baseUrl: this.baseUrl,
 			apiKey: this.apiKey,
-			mergeHeaders: this.mergeHeaders.bind(this)
+			mergeHeaders: this.mergeHeaders.bind(this),
+			maxOpaquePayloadBytes: this.maxOpaquePayloadBytes
 		}, providerRequest, factory, request);
 	}
 };