@codehz/ai 0.7.0 → 0.8.0

package/README.md

@@ -25,12 +25,20 @@ type StreamWarning = { message: string; code?: WarningCode };
 
 入站 opaque 仅接受 `messages` 形（`{ messages: ChatMessage[] }`）。单条 `{ role, content }` 已 **deprecate**（有效 envelope 下未识别 shape 会被跳过，不再当完整 assistant turn 还原）。出站仍写 `messages: [assistantReplayMessage]`。
 
+opaque replay 只检查 object 和 JSON 可序列化性；客户端不再强制 1MiB/8MiB 大小或嵌套深度上限，也不会因这些通用限制丢弃 replay。实际请求大小和 provider 可接受的 payload 由 provider / transport 决定。
+
 ### 其余行为（0.6 一并落地，多为兼容增强）
 
 - HTTP adapter 错误码与 incomplete 流完成路径收敛；Chat Completions 支持 arguments-before-id 与 `function_call`/`tool_calls` 互斥 warning。
 - Aggregator 在 finalize 时从 `output` 派生 `text` / `toolCalls` / `serverTool*`；`argumentsText` 分块累积。
 - 四家厚 adapter 拆为 `map-request` / `map-stream`（对齐 `responses`）；opaque 恒尾置。
 
+### 请求校验边界
+
+`normalizeRequest` 和 `createAIClient` 不再自动运行通用 `validateRequest`。客户端只做默认值合并、`include` 归一化和 request id 生成；`temperature`、`maxOutputTokens`、tool 名称及其他 provider/model policy 交给目标 provider。adapter 仍保留构造合法 wire request 所需的 capability、shape 和 JSON object 检查。
+
+通用校验器不再从 runtime 入口导出；应用如果需要严格输入检查，应在自己的信任边界显式实现。
+
 ## 0.5.0 迁移说明（摘要）
 
 `0.5.0` 收紧了根入口公开面：`AdapterBase`、`createEventFactory`、`aggregateEvents`、`normalizeRequest`、transport / `syntheticStream` 等**不再**从 `@codehz/ai` 根导出（内部模块）。
@@ -86,7 +94,7 @@ type AIRequest = {
   tools?: ToolDefinition[]; // 客户端函数工具（由调用方执行）
   serverTools?: ServerToolDefinition[]; // Provider 托管工具（web_search / code_execution / mcp）
   toolChoice?: ToolChoice; // 客户端工具选择策略
-  temperature?: number; // 温度 (0–2)
+  temperature?: number; // provider/model-defined generation parameter
   maxOutputTokens?: number; // 最大输出 token
   reasoningLevel?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max"; // 可移植思考力度
   include?: { usage?; billing?; providerMetadata? };

package/dist/index.d.mts

@@ -227,7 +227,8 @@ declare const WarningCode: {
   readonly CONTENT_FILTER: "CONTENT_FILTER"; /** 多 choice 仅支持 index 0，其余忽略 */
   readonly MULTIPLE_CHOICES_IGNORED: "MULTIPLE_CHOICES_IGNORED"; /** MCP 审批流不被支持 */
   readonly MCP_APPROVAL_REQUIRED: "MCP_APPROVAL_REQUIRED"; /** provider 侧 response.failed 等失败 */
-  readonly PROVIDER_FAILURE: "PROVIDER_FAILURE";
+  readonly PROVIDER_FAILURE: "PROVIDER_FAILURE"; /** 出站 opaque 超限被省略（避免下一轮 accept 自产毒） */
+  readonly OPAQUE_REPLAY_OMITTED: "OPAQUE_REPLAY_OMITTED";
 };
 type WarningCodeName = (typeof WarningCode)[keyof typeof WarningCode];
 /** 与 WarningCodeName 同义；保留以兼容既有 KnownWarningCode 命名 */
@@ -835,7 +836,8 @@ type HttpAdapterOptions = {
   baseUrl?: string; /** 可注入自定义 fetch 实现（测试 / 代理） */
   fetch?: FetchFn; /** 额外请求头；后写覆盖内置鉴权 / Content-Type 等 */
   headers?: Record<string, string>; /** 额外 body 顶层字段；浅层合并，同名键可覆盖 */
-  extraBody?: Record<string, unknown>;
+  extraBody?: Record<string, unknown>; /** Deprecated compatibility option; opaque replay is not size-limited. */
+  maxOpaquePayloadBytes?: number;
 };
 type HttpAdapterDefaults = {
   baseUrl: string;
@@ -849,6 +851,8 @@ declare abstract class HttpAdapterBase extends AdapterBase {
   protected fetchFn: FetchFn;
   protected headers: Record<string, string> | undefined;
   protected extraBody: Record<string, unknown> | undefined;
+  /** Deprecated compatibility field; opaque replay is not size-limited. */
+  protected maxOpaquePayloadBytes: number;
   constructor(options: HttpAdapterOptions, defaults: HttpAdapterDefaults);
   /** 合并内置 headers 与构造期自定义 headers。 */
   protected mergeHeaders(base: Record<string, string>): Record<string, string>;
@@ -1042,9 +1046,21 @@ type MessagesAPIMessage = {
   role: "user" | "assistant";
   content: string | MessagesAPIContentBlock[];
 };
+type MessagesAPIImageMediaType = "image/jpeg" | "image/png" | "image/gif" | "image/webp";
+type MessagesAPIImageSource = {
+  type: "base64";
+  media_type: MessagesAPIImageMediaType;
+  data: string;
+} | {
+  type: "url";
+  url: string;
+};
 type MessagesAPIContentBlock = {
   type: "text";
   text: string;
+} | {
+  type: "image";
+  source: MessagesAPIImageSource;
 } | {
   type: "thinking";
   thinking: string;
@@ -1101,9 +1117,21 @@ type ChatRequest = {
   stream: true;
   n: 1;
 };
+type ChatTextPart = {
+  type: "text";
+  text: string;
+};
+type ChatImagePart = {
+  type: "image_url";
+  image_url: {
+    url: string;
+    detail?: "auto" | "low" | "high";
+  };
+};
+type ChatContentPart = ChatTextPart | ChatImagePart;
 type ChatMessage = {
   role: "system" | "user" | "assistant" | "tool";
-  content: string | null;
+  content: string | null | ChatContentPart[];
   tool_calls?: ChatToolCall[];
   tool_call_id?: string;
   name?: string;
@@ -1191,6 +1219,10 @@ type GeminiPart = {
   text?: string;
   thought?: boolean;
   thoughtSignature?: string;
+  inlineData?: {
+    mimeType: string;
+    data: string;
+  };
   functionCall?: {
     name: string;
     args?: Record<string, unknown>;