@codehz/ai 0.2.4 → 0.3.0

package/README.md

@@ -164,19 +164,14 @@ const mock = new MockAdapter({
 });
 ```
 
-公开 adapter 接口暴露稳定标识和各维度能力：
+公开 adapter 接口暴露稳定标识和流来源：
 
 ```ts
 adapter.kind; // "responses" | "messages" | "chat-completions" | ...
-adapter.capabilities.textStreaming; // "native" | "synthetic" | "none"
-adapter.capabilities.reasoningStreaming;
-adapter.capabilities.toolCallStreaming;
-adapter.capabilities.replay; // "canonical" | "opaque" | "none"
-adapter.capabilities.usage; // "stream" | "final" | "none"
-adapter.capabilities.toolResultOutcomes;
+adapter.isSyntheticStream;
 ```
 
-响应级 `backend.isSyntheticStream` 根据 `textStreaming === "synthetic"` 推导；具体响应内容仍应从
+响应级 `backend.isSyntheticStream` 使用同一标记；具体响应内容仍应从
 本次事件流、warning 和 `replay` 判断。
 
 ## Mock 后端

package/dist/index.d.mts

@@ -42,7 +42,6 @@ type ToolCallItem = {
   id: string;
   name: string;
   argumentsText: string;
-  argumentsJson?: unknown;
 };
 type ToolResultItem = {
   type: "tool_result";
@@ -234,18 +233,9 @@ type NormalizedRequest = AIRequest & {
   model: string;
   requestId: string;
 };
-type StreamingCapability = "native" | "synthetic" | "none";
-type AdapterCapabilities = {
-  readonly textStreaming: StreamingCapability;
-  readonly reasoningStreaming: StreamingCapability;
-  readonly toolCallStreaming: StreamingCapability;
-  readonly replay: "canonical" | "opaque" | "none";
-  readonly usage: "stream" | "final" | "none";
-  readonly toolResultOutcomes: ReadonlyArray<"success" | "error" | "rejected">;
-};
 interface BackendAdapter {
   readonly kind: "chat-completions" | "messages" | "responses" | "ollama" | "mock";
-  readonly capabilities: AdapterCapabilities;
+  readonly isSyntheticStream: boolean;
   stream(request: NormalizedRequest): AsyncIterable<AIStreamEvent>;
 }
 type CreateAIClientOptions = {
@@ -525,7 +515,7 @@ type StreamResult = {
 };
 declare abstract class AdapterBase implements BackendAdapter {
   abstract readonly kind: "chat-completions" | "messages" | "responses" | "ollama" | "mock";
-  abstract readonly capabilities: AdapterCapabilities;
+  abstract readonly isSyntheticStream: boolean;
   /**
    * stream 模板方法：
    * 1. 创建事件工厂，发射 response.started
@@ -618,7 +608,7 @@ type ResponsesTool = {
 };
 declare class ResponsesAdapter extends AdapterBase {
   readonly kind: "responses";
-  readonly capabilities: AdapterCapabilities;
+  readonly isSyntheticStream = false;
   private apiKey;
   private baseUrl;
   private fetchFn;
@@ -686,7 +676,7 @@ type MessagesAPITool = {
 };
 declare class MessagesAdapter extends AdapterBase {
   readonly kind: "messages";
-  readonly capabilities: AdapterCapabilities;
+  readonly isSyntheticStream = false;
   private apiKey;
   private apiVersion;
   private baseUrl;
@@ -744,7 +734,7 @@ type ChatTool = {
 };
 declare class ChatCompletionsAdapter extends AdapterBase {
   readonly kind: "chat-completions";
-  readonly capabilities: AdapterCapabilities;
+  readonly isSyntheticStream = false;
   private apiKey;
   private baseUrl;
   private fetchFn;
@@ -792,7 +782,7 @@ type OllamaTool = {
 };
 declare class OllamaAdapter extends AdapterBase {
   readonly kind: "ollama";
-  readonly capabilities: AdapterCapabilities;
+  readonly isSyntheticStream = false;
   private baseUrl;
   private apiKey;
   private fetchFn;
@@ -889,7 +879,6 @@ type MockToolCallStep = {
   id: string;
   name: string;
   argumentsText: string;
-  argumentsJson?: unknown;
   streamArguments?: boolean;
   stream?: MockTextStreamOptions | false;
 };
@@ -942,14 +931,7 @@ type MockProviderRequest = {
 declare function assertMockRequest(request: NormalizedRequest, expectation: MockRequestExpectation, context: MockHandlerContext): void;
 declare class MockAdapter extends AdapterBase {
   readonly kind: "mock";
-  readonly capabilities: {
-    readonly textStreaming: "synthetic";
-    readonly reasoningStreaming: "synthetic";
-    readonly toolCallStreaming: "synthetic";
-    readonly replay: "canonical";
-    readonly usage: "final";
-    readonly toolResultOutcomes: readonly ["success", "error", "rejected"];
-  };
+  readonly isSyntheticStream = true;
   private readonly handler;
   private readonly providerMetadata?;
   private cursor;
@@ -982,7 +964,7 @@ declare function opaqueBlock(payload: unknown): ContentBlock & {
 };
 declare function messageItem(content: ContentBlock[], overrides?: Partial<Omit<MessageItem, "type" | "content">>): MessageItem;
 declare function reasoningItem(content: ContentBlock[], visibility?: ReasoningItem["visibility"], id?: string): ReasoningItem;
-declare function toolCallItem(id: string, name: string, argumentsText: string, argumentsJson?: unknown): ToolCallItem;
+declare function toolCallItem(id: string, name: string, argumentsText: string): ToolCallItem;
 declare function toolResultItem(callId: string, toolName: string, outcome: ToolResultItem["outcome"], content: ContentBlock[]): ToolResultItem;
 declare function opaqueItem(source: OpaqueItem["source"], purpose: OpaqueItem["purpose"], payload: unknown, id?: string): OpaqueItem;
 /**
@@ -1193,27 +1175,20 @@ declare function splitLines(buffer: string, allowEOF: boolean): StreamSplitResul
 declare function splitSSEFrames(buffer: string, allowEOF: boolean): StreamSplitResult;
 //#endregion
 //#region src/helpers/request-mapper.d.ts
-type ProviderProfile = {
-  readonly kind: string;
-  readonly instructionsMode: "system_message" | "instructions_field" | "none";
-  readonly supportedBlockTypes: ReadonlyArray<ContentBlock["type"]>;
-  readonly reasoningBlockTypes: ReadonlyArray<ContentBlock["type"]>;
-  readonly capabilities: AdapterCapabilities;
-};
 declare class NormalizedRequestMapper {
-  readonly profile: ProviderProfile;
-  constructor(profile: ProviderProfile);
+  readonly kind: string;
+  constructor(kind: string);
   mapInstructions(instructions: string | InstructionBlock[]): string;
   ensureTextBlocks(blocks: ContentBlock[], field: string): ContentBlock[];
   ensureReasoningBlocks(blocks: ContentBlock[], field: string): Array<Extract<ContentBlock, {
     type: "text";
   }>>;
-  assertToolResultOutcome(outcome: ToolResultItem["outcome"]): void;
+  parseToolArguments(item: ToolCallItem): Record<string, unknown>;
   rollbackTrailingAssistantMessages<T extends {
     role: string;
   }>(messages: T[]): void;
   private ensureBlocks;
 }
 //#endregion
-export { type AIClient, AIError, AIMappingError, AIProviderError, type AIRequest, AIRequestError, type AIResponse, AIStreamError, type AIStreamEvent, AdapterAuxiliaryState, AdapterBase, type AdapterCapabilities, AuxiliaryCollector, type AuxiliaryFinalizeOptions, type AuxiliaryFinalizeResult, type AuxiliaryInfo, type BackendAdapter, type BackendTrace, type BillingInfo, type BillingPostprocessHook, type BillingSource, ChatCompletionsAdapter, type ChatCompletionsAdapterOptions, type ContentBlock, type CreateAIClientOptions, type EventFactory, type EventFactoryBackend, type EventFactoryState, type FetchFn, type IncludeSettings, IncrementalStreamParser, type InputItem, type InstructionBlock, type JsonContentBlock, type LookupResult, MAX_OPAQUE_JSON_DEPTH, MAX_OPAQUE_PAYLOAD_BYTES, type MessageCompletedEvent, type MessageDeltaEvent, type MessageItem, type MessageStartedEvent, MessagesAdapter, type MessagesAdapterOptions, MockAdapter, type MockAdapterOptions, type MockAuxiliaryStep, type MockCompleteStep, type MockErrorStep, type MockHandler, type MockHandlerContext, type MockHistoryRecord, type MockInputExpectation, type MockInterruptStep, type MockMessageStep, type MockOutputStep, type MockReasoningStep, type MockRequestExpectation, type MockStaticHandler, type MockStep, type MockTextStreamOptions, type MockThrowStep, type MockToolCallStep, type MockWarningStep, type NormalizeOptions, type NormalizedRequest, NormalizedRequestMapper, OllamaAdapter, type OllamaAdapterOptions, type OpaqueEnvelopeResult, type OpaqueItem, type OutputItem, PROVIDER_ERROR_MESSAGE_MAX_LEN, PROVIDER_ERROR_RAW_BODY_THRESHOLD, type ProviderProfile, type ReasoningCompletedEvent, type ReasoningDeltaEvent, type ReasoningItem, type ReasoningStartedEvent, type ReplayItem, type ResponseAuxiliaryEvent, type ResponseCompletedEvent, type ResponseStartedEvent, type ResponseWarningEvent, ResponsesAdapter, type ResponsesAdapterOptions, type SSEEvent, type StopReason, type StreamEventBase, type StreamParseResult, type StreamResult, type StreamSplitResult, type StreamingCapability, type SyntheticStreamOptions, type TextContentBlock, type ToolCallCompletedEvent, type ToolCallDeltaEvent, type ToolCallItem, type ToolCallStartedEvent, type ToolChoice, type ToolDefinition, type ToolResultItem, type Usage, type UsageSource, type ValidationIssue, WarningCode, aggregateEvents, assertMockRequest, assertOpaqueReplayEnvelope, assertValidRequest, blockToText, collectStream, contentBlocksToText, createAIClient, createEventFactory, emitMalformedStreamWarning, extractProviderErrorMessage, extractText, imageBlock, instructionsToText, jsonBlock, mapReasoningVisibility, mapStopReason, measureJsonDepth, messageItem, metadataSourceList, normalizeRequest, opaqueBlock, opaqueItem, parseSSEEvents, providerHttpError, reasoningItem, replayFromOutput, splitLines, splitSSEFrames, syntheticStream, textBlock, toolCallItem, toolResultItem, usageFromAnthropicMessages, usageFromChatCompletions, usageFromOllama, usageFromOpenAIResponses, validateOpaqueReplayEnvelope, validateRequest, withMockStreaming };
+export { type AIClient, AIError, AIMappingError, AIProviderError, type AIRequest, AIRequestError, type AIResponse, AIStreamError, type AIStreamEvent, AdapterAuxiliaryState, AdapterBase, AuxiliaryCollector, type AuxiliaryFinalizeOptions, type AuxiliaryFinalizeResult, type AuxiliaryInfo, type BackendAdapter, type BackendTrace, type BillingInfo, type BillingPostprocessHook, type BillingSource, ChatCompletionsAdapter, type ChatCompletionsAdapterOptions, type ContentBlock, type CreateAIClientOptions, type EventFactory, type EventFactoryBackend, type EventFactoryState, type FetchFn, type IncludeSettings, IncrementalStreamParser, type InputItem, type InstructionBlock, type JsonContentBlock, type LookupResult, MAX_OPAQUE_JSON_DEPTH, MAX_OPAQUE_PAYLOAD_BYTES, type MessageCompletedEvent, type MessageDeltaEvent, type MessageItem, type MessageStartedEvent, MessagesAdapter, type MessagesAdapterOptions, MockAdapter, type MockAdapterOptions, type MockAuxiliaryStep, type MockCompleteStep, type MockErrorStep, type MockHandler, type MockHandlerContext, type MockHistoryRecord, type MockInputExpectation, type MockInterruptStep, type MockMessageStep, type MockOutputStep, type MockReasoningStep, type MockRequestExpectation, type MockStaticHandler, type MockStep, type MockTextStreamOptions, type MockThrowStep, type MockToolCallStep, type MockWarningStep, type NormalizeOptions, type NormalizedRequest, NormalizedRequestMapper, OllamaAdapter, type OllamaAdapterOptions, type OpaqueEnvelopeResult, type OpaqueItem, type OutputItem, PROVIDER_ERROR_MESSAGE_MAX_LEN, PROVIDER_ERROR_RAW_BODY_THRESHOLD, type ReasoningCompletedEvent, type ReasoningDeltaEvent, type ReasoningItem, type ReasoningStartedEvent, type ReplayItem, type ResponseAuxiliaryEvent, type ResponseCompletedEvent, type ResponseStartedEvent, type ResponseWarningEvent, ResponsesAdapter, type ResponsesAdapterOptions, type SSEEvent, type StopReason, type StreamEventBase, type StreamParseResult, type StreamResult, type StreamSplitResult, type SyntheticStreamOptions, type TextContentBlock, type ToolCallCompletedEvent, type ToolCallDeltaEvent, type ToolCallItem, type ToolCallStartedEvent, type ToolChoice, type ToolDefinition, type ToolResultItem, type Usage, type UsageSource, type ValidationIssue, WarningCode, aggregateEvents, assertMockRequest, assertOpaqueReplayEnvelope, assertValidRequest, blockToText, collectStream, contentBlocksToText, createAIClient, createEventFactory, emitMalformedStreamWarning, extractProviderErrorMessage, extractText, imageBlock, instructionsToText, jsonBlock, mapReasoningVisibility, mapStopReason, measureJsonDepth, messageItem, metadataSourceList, normalizeRequest, opaqueBlock, opaqueItem, parseSSEEvents, providerHttpError, reasoningItem, replayFromOutput, splitLines, splitSSEFrames, syntheticStream, textBlock, toolCallItem, toolResultItem, usageFromAnthropicMessages, usageFromChatCompletions, usageFromOllama, usageFromOpenAIResponses, validateOpaqueReplayEnvelope, validateRequest, withMockStreaming };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -156,6 +156,12 @@ function validateInputItem(item, field, issues) {
 			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`);
+			else try {
+				const parsed = JSON.parse(item.argumentsText);
+				if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) pushIssue(issues, `${field}.argumentsText`, "TOOL_CALL_ARGUMENTS_INVALID", `${field}.argumentsText must encode a JSON object`);
+			} catch {
+				pushIssue(issues, `${field}.argumentsText`, "TOOL_CALL_ARGUMENTS_INVALID", `${field}.argumentsText must encode a JSON object`);
+			}
 			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`);
@@ -820,13 +826,12 @@ function reasoningItem(content, visibility = "full", id) {
 		content
 	};
 }
-function toolCallItem(id, name, argumentsText, argumentsJson) {
+function toolCallItem(id, name, argumentsText) {
 	return {
 		type: "tool_call",
 		id,
 		name,
-		argumentsText,
-		argumentsJson
+		argumentsText
 	};
 }
 function toolResultItem(callId, toolName, outcome, content) {
@@ -1095,7 +1100,7 @@ var AdapterBase = class {
 			responseId: request.requestId,
 			backend: {
 				kind: this.kind,
-				isSynthetic: this.capabilities.textStreaming === "synthetic"
+				isSynthetic: this.isSyntheticStream
 			}
 		});
 		yield factory.responseStarted(request.model);
@@ -1147,7 +1152,7 @@ var AdapterBase = class {
 				requestId: request.requestId,
 				rawResponseId: result.rawResponseId,
 				adapter: this.kind,
-				isSyntheticStream: this.capabilities.textStreaming === "synthetic",
+				isSyntheticStream: this.isSyntheticStream,
 				metadataSources: result.metadataSources,
 				warnings
 			}
@@ -1566,25 +1571,25 @@ function splitSSEFrames(buffer, allowEOF) {
 //#endregion
 //#region src/helpers/request-mapper.ts
 var NormalizedRequestMapper = class {
-	profile;
-	constructor(profile) {
-		this.profile = profile;
+	kind;
+	constructor(kind) {
+		this.kind = kind;
 	}
 	mapInstructions(instructions) {
 		return typeof instructions === "string" ? instructions : contentBlocksToText(this.ensureTextBlocks(instructions, "instructions"));
 	}
 	ensureTextBlocks(blocks, field) {
-		return this.ensureBlocks(blocks, field, this.profile.supportedBlockTypes, "only text/json blocks are supported");
+		return this.ensureBlocks(blocks, field, ["text", "json"], "only text/json blocks are supported");
 	}
 	ensureReasoningBlocks(blocks, field) {
-		return this.ensureBlocks(blocks, field, this.profile.reasoningBlockTypes, "reasoning only supports text blocks");
+		return this.ensureBlocks(blocks, field, ["text"], "reasoning only supports text blocks");
 	}
-	assertToolResultOutcome(outcome) {
-		if (this.profile.capabilities.toolResultOutcomes.includes(outcome)) return;
-		const outcomes = this.profile.capabilities.toolResultOutcomes;
-		const supported = outcomes.map((value) => `"${value}"`).join(" and ");
-		const verb = outcomes.length > 1 ? "are" : "is";
-		throw new AIRequestError(`${this.profile.kind} does not preserve tool_result outcome "${outcome}"; only ${supported} ${verb} supported`, "UNSUPPORTED_TOOL_RESULT_OUTCOME");
+	parseToolArguments(item) {
+		try {
+			const parsed = JSON.parse(item.argumentsText);
+			if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) return parsed;
+		} catch {}
+		throw new AIRequestError(`${this.kind} requires tool_call argumentsText to be a valid JSON object`, "TOOL_CALL_ARGUMENTS_INVALID");
 	}
 	rollbackTrailingAssistantMessages(messages) {
 		while (messages.length > 0 && messages[messages.length - 1]?.role === "assistant") messages.pop();
@@ -1592,7 +1597,7 @@ var NormalizedRequestMapper = class {
 	ensureBlocks(blocks, field, supportedTypes, description) {
 		for (let i = 0; i < blocks.length; i++) {
 			const block = blocks[i];
-			if (block && !supportedTypes.includes(block.type)) throw new AIRequestError(`${this.profile.kind} does not support ${field}[${i}] of type "${block.type}"; ${description}`, "UNSUPPORTED_CONTENT_BLOCK");
+			if (block && !supportedTypes.includes(block.type)) throw new AIRequestError(`${this.kind} does not support ${field}[${i}] of type "${block.type}"; ${description}`, "UNSUPPORTED_CONTENT_BLOCK");
 		}
 		return blocks;
 	}
@@ -1609,21 +1614,7 @@ var NormalizedRequestMapper = class {
 *
 * 支持消息流 / reasoning 流 / tool_call 流及高保真 replay。
 */
-const profile$3 = {
-	kind: "responses",
-	instructionsMode: "instructions_field",
-	supportedBlockTypes: ["text", "json"],
-	reasoningBlockTypes: ["text"],
-	capabilities: {
-		textStreaming: "native",
-		reasoningStreaming: "native",
-		toolCallStreaming: "native",
-		replay: "opaque",
-		usage: "final",
-		toolResultOutcomes: ["success"]
-	}
-};
-const mapper$3 = new NormalizedRequestMapper(profile$3);
+const mapper$3 = new NormalizedRequestMapper("responses");
 /** 已处理或可安全忽略的 Responses SSE 类型（未知类型会 warning 一次）。 */
 const KNOWN_RESPONSES_SSE_TYPES = /* @__PURE__ */ new Set([
 	"response.output_item.added",
@@ -1632,8 +1623,6 @@ const KNOWN_RESPONSES_SSE_TYPES = /* @__PURE__ */ new Set([
 	"response.output_text.done",
 	"response.reasoning.delta",
 	"response.reasoning.done",
-	"response.tool_call.delta",
-	"response.tool_call.done",
 	"response.function_call_arguments.delta",
 	"response.function_call_arguments.done",
 	"response.content_part.added",
@@ -1669,7 +1658,7 @@ function canonicalToResponsesBlock(b) {
 }
 var ResponsesAdapter = class extends AdapterBase {
 	kind = "responses";
-	capabilities = profile$3.capabilities;
+	isSyntheticStream = false;
 	apiKey;
 	baseUrl;
 	fetchFn;
@@ -1716,7 +1705,6 @@ var ResponsesAdapter = class extends AdapterBase {
 				});
 				break;
 			case "tool_result": {
-				mapper$3.assertToolResultOutcome(item.outcome);
 				const output = mapper$3.ensureTextBlocks(item.content, `tool_result ${item.callId} content`).map(blockToText).join("\n");
 				input.push({
 					type: "function_call_output",
@@ -1814,6 +1802,7 @@ var ResponsesAdapter = class extends AdapterBase {
 		let completedEmitted = false;
 		let unknownEventsWarned = false;
 		const messageItemsWithDelta = /* @__PURE__ */ new Set();
+		const toolCallNames = /* @__PURE__ */ new Map();
 		try {
 			while (true) {
 				const { done, value } = await reader.read().catch((err) => {
@@ -1841,9 +1830,12 @@ var ResponsesAdapter = class extends AdapterBase {
 							case "reasoning":
 								yield factory.reasoningStarted(item.id, "full");
 								break;
-							case "function_call":
-								yield factory.toolCallStarted(item.id, item.name ?? "unknown");
+							case "function_call": {
+								const name = typeof item.name === "string" ? item.name : "unknown";
+								toolCallNames.set(item.id, name);
+								yield factory.toolCallStarted(item.id, name);
 								break;
+							}
 						}
 						continue;
 					}
@@ -1871,14 +1863,14 @@ var ResponsesAdapter = class extends AdapterBase {
 						output.push(reasoningItem([textBlock(data.text)], "full", data.item_id));
 						continue;
 					}
-					if (sseEvent.type === "response.tool_call.delta") {
+					if (sseEvent.type === "response.function_call_arguments.delta") {
 						const data = sseEvent.data;
-						if (data.delta.arguments) yield factory.toolCallDelta(data.item_id, { argumentsText: data.delta.arguments });
+						if (data.delta) yield factory.toolCallDelta(data.item_id, { argumentsText: data.delta });
 						continue;
 					}
-					if (sseEvent.type === "response.tool_call.done") {
+					if (sseEvent.type === "response.function_call_arguments.done") {
 						const data = sseEvent.data;
-						const tcItem = toolCallItem(data.item_id, data.name ?? "unknown", data.arguments ?? "");
+						const tcItem = toolCallItem(data.item_id, toolCallNames.get(data.item_id) ?? "unknown", data.arguments);
 						yield factory.toolCallCompleted(data.item_id);
 						output.push(tcItem);
 						continue;
@@ -1975,21 +1967,7 @@ var ResponsesAdapter = class extends AdapterBase {
 * - 高保真 replay（含 opaque continuation）
 * - 能力降级 warning
 */
-const profile$2 = {
-	kind: "messages",
-	instructionsMode: "system_message",
-	supportedBlockTypes: ["text", "json"],
-	reasoningBlockTypes: ["text"],
-	capabilities: {
-		textStreaming: "native",
-		reasoningStreaming: "native",
-		toolCallStreaming: "synthetic",
-		replay: "opaque",
-		usage: "stream",
-		toolResultOutcomes: ["success", "error"]
-	}
-};
-const mapper$2 = new NormalizedRequestMapper(profile$2);
+const mapper$2 = new NormalizedRequestMapper("messages");
 function isMessagesReplayContentBlock(value) {
 	if (!value || typeof value !== "object" || !("type" in value)) return false;
 	const block = value;
@@ -2015,10 +1993,10 @@ function assertMessagesReplayContent(content) {
 function synthesizeItemId(kind, blockIndex, responseId) {
 	return `${kind}-${blockIndex}-${responseId}`;
 }
-function parseToolUseInput(input) {
+function parseProviderToolUseInput(input) {
 	try {
 		const parsed = JSON.parse(input);
-		return parsed && typeof parsed === "object" ? parsed : {};
+		return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
 	} catch {
 		return {};
 	}
@@ -2059,7 +2037,7 @@ function buildStreamMetadata(options) {
 }
 var MessagesAdapter = class extends AdapterBase {
 	kind = "messages";
-	capabilities = profile$2.capabilities;
+	isSyntheticStream = false;
 	apiKey;
 	apiVersion;
 	baseUrl;
@@ -2098,7 +2076,7 @@ var MessagesAdapter = class extends AdapterBase {
 						type: "tool_use",
 						id: item.id,
 						name: item.name,
-						input: item.argumentsJson ?? parseToolUseInput(item.argumentsText)
+						input: mapper$2.parseToolArguments(item)
 					};
 					if (lastMsg && lastMsg.role === "assistant" && typeof lastMsg.content !== "string") lastMsg.content.push(toolBlock);
 					else messages.push({
@@ -2108,13 +2086,12 @@ var MessagesAdapter = class extends AdapterBase {
 					break;
 				}
 				case "tool_result": {
-					mapper$2.assertToolResultOutcome(item.outcome);
 					const content = mapper$2.ensureTextBlocks(item.content, `tool_result ${item.callId} content`).map(blockToText).join("\n");
 					const block = {
 						type: "tool_result",
 						tool_use_id: item.callId,
 						content,
-						is_error: item.outcome === "error"
+						is_error: item.outcome !== "success"
 					};
 					if (pendingToolResultMessage && typeof pendingToolResultMessage.content !== "string") pendingToolResultMessage.content.push(block);
 					else {
@@ -2140,7 +2117,7 @@ var MessagesAdapter = class extends AdapterBase {
 					break;
 				}
 				case "opaque": {
-					if (item.purpose !== "replay") break;
+					if (item.source !== "messages" || item.purpose !== "replay") break;
 					assertOpaqueReplayEnvelope(item.payload);
 					const payload = item.payload;
 					if (payload.role === "assistant" && "content" in payload) {
@@ -2369,7 +2346,7 @@ var MessagesAdapter = class extends AdapterBase {
 								type: "tool_use",
 								id: currentItemId,
 								name: currentToolName,
-								input: parseToolUseInput(currentArgsText || argsBuffer)
+								input: parseProviderToolUseInput(currentArgsText || argsBuffer)
 							});
 						}
 						currentItemType = null;
@@ -2454,21 +2431,7 @@ var MessagesAdapter = class extends AdapterBase {
 * - replay fidelity 依赖 provider 是否暴露可回放的 assistant turn 字段
 */
 const REASONING_FIELDS = ["reasoning_content", "reasoning"];
-const profile$1 = {
-	kind: "chat-completions",
-	instructionsMode: "system_message",
-	supportedBlockTypes: ["text", "json"],
-	reasoningBlockTypes: ["text"],
-	capabilities: {
-		textStreaming: "native",
-		reasoningStreaming: "native",
-		toolCallStreaming: "native",
-		replay: "opaque",
-		usage: "final",
-		toolResultOutcomes: ["success"]
-	}
-};
-const mapper$1 = new NormalizedRequestMapper(profile$1);
+const mapper$1 = new NormalizedRequestMapper("chat-completions");
 function extractReasoningText(value) {
 	if (typeof value === "string") return value;
 	if (Array.isArray(value)) return value.map(extractReasoningText).join("");
@@ -2545,7 +2508,7 @@ function buildAssistantReplayMessage(params) {
 }
 var ChatCompletionsAdapter = class extends AdapterBase {
 	kind = "chat-completions";
-	capabilities = profile$1.capabilities;
+	isSyntheticStream = false;
 	apiKey;
 	baseUrl;
 	fetchFn;
@@ -2590,7 +2553,6 @@ var ChatCompletionsAdapter = class extends AdapterBase {
 				break;
 			}
 			case "tool_result":
-				mapper$1.assertToolResultOutcome(item.outcome);
 				messages.push({
 					role: "tool",
 					tool_call_id: item.callId,
@@ -2605,7 +2567,7 @@ var ChatCompletionsAdapter = class extends AdapterBase {
 				});
 				break;
 			case "opaque": {
-				if (item.purpose !== "replay") break;
+				if (item.source !== "chat.completions" || item.purpose !== "replay") break;
 				assertOpaqueReplayEnvelope(item.payload);
 				const payload = item.payload;
 				if (payload.role === "assistant" && typeof payload.content === "string") messages.push({
@@ -2920,29 +2882,7 @@ var ChatCompletionsAdapter = class extends AdapterBase {
 * - tool_call 不支持逐 token 流式
 * - replay 保真度低（无 opaque continuation 机制）
 */
-const profile = {
-	kind: "ollama",
-	instructionsMode: "system_message",
-	supportedBlockTypes: ["text", "json"],
-	reasoningBlockTypes: ["text"],
-	capabilities: {
-		textStreaming: "native",
-		reasoningStreaming: "none",
-		toolCallStreaming: "synthetic",
-		replay: "opaque",
-		usage: "final",
-		toolResultOutcomes: ["success"]
-	}
-};
-const mapper = new NormalizedRequestMapper(profile);
-function parseOllamaToolArguments(item) {
-	if (item.argumentsJson && typeof item.argumentsJson === "object" && item.argumentsJson !== null) return item.argumentsJson;
-	try {
-		const parsed = JSON.parse(item.argumentsText);
-		if (parsed && typeof parsed === "object") return parsed;
-	} catch {}
-	throw new AIRequestError("ollama tool_call argumentsText must be valid JSON object when argumentsJson is absent", "TOOL_CALL_ARGUMENTS_INVALID");
-}
+const mapper = new NormalizedRequestMapper("ollama");
 function isOllamaReplayToolCalls(value) {
 	return Array.isArray(value) && value.every((entry) => {
 		if (!entry || typeof entry !== "object" || !("function" in entry)) return false;
@@ -2960,7 +2900,7 @@ function toWireOllamaToolCalls(toolCalls) {
 }
 var OllamaAdapter = class extends AdapterBase {
 	kind = "ollama";
-	capabilities = profile.capabilities;
+	isSyntheticStream = false;
 	baseUrl;
 	apiKey;
 	fetchFn;
@@ -2971,7 +2911,6 @@ var OllamaAdapter = class extends AdapterBase {
 		this.fetchFn = options.fetch ?? globalThis.fetch;
 	}
 	buildRequest(request) {
-		if (request.toolChoice && request.toolChoice !== "auto") throw new AIRequestError("ollama does not support explicit toolChoice", "UNSUPPORTED_TOOL_CHOICE");
 		const messages = [];
 		/** Local-only name → call id queue for best-effort tool_result association (not sent to Ollama). */
 		const callIdsByName = /* @__PURE__ */ new Map();
@@ -2992,7 +2931,7 @@ var OllamaAdapter = class extends AdapterBase {
 				const lastAssistant = messages.findLast((m) => m.role === "assistant");
 				const tc = { function: {
 					name: item.name,
-					arguments: parseOllamaToolArguments(item)
+					arguments: mapper.parseToolArguments(item)
 				} };
 				const queue = callIdsByName.get(item.name) ?? [];
 				queue.push(item.id);
@@ -3006,7 +2945,6 @@ var OllamaAdapter = class extends AdapterBase {
 				break;
 			}
 			case "tool_result": {
-				mapper.assertToolResultOutcome(item.outcome);
 				const queue = callIdsByName.get(item.toolName);
 				if (queue && queue.length > 0) queue.shift();
 				messages.push({
@@ -3053,7 +2991,9 @@ var OllamaAdapter = class extends AdapterBase {
 			messages,
 			stream: true
 		};
-		if (request.tools && request.tools.length > 0) body.tools = request.tools.map((t) => ({
+		const toolChoice = request.toolChoice;
+		const selectedTools = toolChoice === "none" ? [] : toolChoice && typeof toolChoice === "object" ? request.tools?.filter((tool) => tool.name === toolChoice.name) : request.tools;
+		if (selectedTools && selectedTools.length > 0) body.tools = selectedTools.map((t) => ({
 			type: "function",
 			function: {
 				name: t.name,
@@ -3071,6 +3011,7 @@ var OllamaAdapter = class extends AdapterBase {
 	async *runStream(providerRequest, factory, request) {
 		const auxiliary = this.createAuxiliaryState(request);
 		let completedEmitted = false;
+		if (request.toolChoice && request.toolChoice !== "auto") yield factory.responseWarning(request.toolChoice === "none" ? "Ollama toolChoice none was mapped by omitting tools" : `Ollama cannot force tool choice; only tool "${request.toolChoice.name}" was provided as a best-effort constraint`, WarningCode.CAPABILITY_DOWNGRADE);
 		if (request.metadata) yield factory.responseWarning("Request metadata is not supported by the Ollama adapter", "UNSUPPORTED_METADATA");
 		const headers = { "Content-Type": "application/json" };
 		if (this.apiKey) headers.Authorization = `Bearer ${this.apiKey}`;
@@ -3128,7 +3069,7 @@ var OllamaAdapter = class extends AdapterBase {
 					id: tc.id,
 					function: {
 						name: tc.name,
-						arguments: tc.argumentsJson
+						arguments: JSON.parse(tc.argumentsText)
 					}
 				}))
 			}));
@@ -3189,8 +3130,7 @@ var OllamaAdapter = class extends AdapterBase {
 						pendingToolCalls.push({
 							id: tcId,
 							name: tc.function.name,
-							argumentsText: argsText,
-							argumentsJson: tc.function.arguments
+							argumentsText: argsText
 						});
 					}
 					if (chunk.done) {
@@ -3206,7 +3146,7 @@ var OllamaAdapter = class extends AdapterBase {
 						}
 						if (pendingToolCalls.length > 0) yield factory.responseWarning(`Ollama delivered ${pendingToolCalls.length} tool call(s) as a batch; tool_call streaming is not supported`, WarningCode.TOOL_CALL_BATCHED);
 						for (const pending of pendingToolCalls) {
-							const toolCall = toolCallItem(pending.id, pending.name, pending.argumentsText, pending.argumentsJson);
+							const toolCall = toolCallItem(pending.id, pending.name, pending.argumentsText);
 							yield factory.toolCallStarted(pending.id, pending.name);
 							yield factory.toolCallDelta(pending.id, { argumentsText: pending.argumentsText });
 							yield factory.toolCallCompleted(pending.id);
@@ -3248,7 +3188,7 @@ var OllamaAdapter = class extends AdapterBase {
 			}
 			if (pendingToolCalls.length > 0) yield factory.responseWarning(`Ollama delivered ${pendingToolCalls.length} tool call(s) as a batch; tool_call streaming is not supported`, WarningCode.TOOL_CALL_BATCHED);
 			for (const pending of pendingToolCalls) {
-				const toolCall = toolCallItem(pending.id, pending.name, pending.argumentsText, pending.argumentsJson);
+				const toolCall = toolCallItem(pending.id, pending.name, pending.argumentsText);
 				yield factory.toolCallStarted(pending.id, pending.name);
 				yield factory.toolCallDelta(pending.id, { argumentsText: pending.argumentsText });
 				yield factory.toolCallCompleted(pending.id);
@@ -3289,18 +3229,7 @@ function assertMockRequest(request, expectation, context) {
 }
 var MockAdapter = class extends AdapterBase {
 	kind = "mock";
-	capabilities = {
-		textStreaming: "synthetic",
-		reasoningStreaming: "synthetic",
-		toolCallStreaming: "synthetic",
-		replay: "canonical",
-		usage: "final",
-		toolResultOutcomes: [
-			"success",
-			"error",
-			"rejected"
-		]
-	};
+	isSyntheticStream = true;
 	handler;
 	providerMetadata;
 	cursor = 0;
@@ -3508,8 +3437,7 @@ function createToolCallFromStep(step) {
 		type: "tool_call",
 		id: step.id,
 		name: step.name,
-		argumentsText: step.argumentsText,
-		argumentsJson: step.argumentsJson
+		argumentsText: step.argumentsText
 	};
 }
 function normalizeBlocks(content) {