@opencow-ai/opencow-agent-sdk 0.4.4 → 0.4.6

package/dist/lib/schemaSanitizer.d.ts

@@ -40,3 +40,46 @@ export declare function splitTypeArrayToAnyOf(schema: Record<string, unknown>):
  * keywords while keeping enum/const cleanup defensive for imperfect MCP schemas.
  */
 export declare function sanitizeSchemaForOpenAICompat(schema: unknown): Record<string, unknown>;
+/**
+ * 「Anthropic 工具 schema → 严格 / Gemini 安全 schema」的统一规整入口。
+ *
+ * 历史上 chat_completions 路径（openai shim 的 normalizeSchemaForOpenAI）与 Responses
+ * 路径（codex shim 的 enforceStrictSchema）各自维护了一份几乎相同的递归实现，Gemini
+ * 适配（issue #79/#77、Vertex 400）需要在两处手工同步——典型的「两份会逐渐发散的拷贝」。
+ * 这里收敛为单一数据源：递归骨架只此一份，两条路径的差异通过 options 显式表达。
+ *
+ * 组合的原子能力：
+ *   - {@link sanitizeSchemaForOpenAICompat}：剥离 provider 不接受的关键字、清洗 enum/const
+ *   - {@link splitTypeArrayToAnyOf}（仅 gemini）：type 数组 → {type, nullable:true}
+ *   - {@link makeSchemaNullable}：strict 下被强制 required 的「原本可选」字段标可空
+ */
+export interface StrictifyJsonSchemaOptions {
+    /**
+     * 目标为 Gemini/Vertex。拆 type 数组、可空字段用 nullable:true 而非 type:[T,"null"]
+     * （Gemini strict 唯一接受的可空写法）。默认 false（OpenAI/Codex/DeepSeek/Kimi…）。
+     */
+    gemini?: boolean;
+    /**
+     * strict 结构化输出（默认 true）：每个属性强制并入 required、对象补
+     * additionalProperties:false、顶层「原本可选」字段标可空。设 false（如
+     * CLAUDE_CODE_USE_GEMINI 原生路径）则保留原始 required、不强制 additionalProperties、
+     * 不加可空。
+     */
+    strict?: boolean;
+    /**
+     * 删除 `format:"uri"`（Codex Responses 拒绝该 format，URL 校验留在工具层）。默认 false。
+     */
+    stripUriFormat?: boolean;
+    /**
+     * 丢弃「规整后退化为空对象」的属性（strict 下 OpenAI/Codex 会静默剥离其 schema、再因
+     * 残留 required 报 mismatch；典型如 z.record() / AskUserQuestion.answers）。默认 false。
+     */
+    dropEmptyObjectProperties?: boolean;
+    /**
+     * 对「`type:"object"` 但无 properties 键」的对象也补 additionalProperties:false +
+     * required:[]（Codex Responses 要求每个对象都严格闭合）。chat 路径保持原样，避免改变
+     * 自由对象（freeform object）字段的既有行为。默认 false。
+     */
+    normalizeBareObjects?: boolean;
+}
+export declare function strictifyJsonSchema(schema: unknown, options?: StrictifyJsonSchemaOptions): Record<string, unknown>;

package/dist/lib/toolInputNullCoercion.d.ts

@@ -3,18 +3,21 @@ import type { z } from 'zod/v4';
  * 解析工具入参，并对 strict provider 把可选字段强制为 nullable 后模型回传的 `null`
  * 做兜底还原。
  *
- * 背景：OpenAI/Codex strict 模式要求每个属性都出现在 `required`，可选字段会被
+ * 背景：OpenAI/Codex/DeepSeek 等 strict 模式要求每个属性都出现在 `required`，可选字段会被
  * `makeSchemaNullable` 标成可空（见 lib/schemaSanitizer.ts），模型遂用 `null` 表达
  * 「未提供」。但工具的 Zod inputSchema 多用 `.optional()`（不接受 `null`），若直接
  * `safeParse` 会得到 InputValidationError —— 这正是「① 让 wire schema 可空」必须搭配的
  * 入参侧兜底（issue #79/#77）。
  *
- * 策略：先按原始 schema 解析；仅当「解析失败 且 顶层含 null 值」时，去掉这些 null 键
- * 再解析一次，且只有重试成功才采用重试结果。由此：
+ * 策略：先按原始 schema 解析；仅当「解析失败 且 入参任意层级含 null」时，递归去掉这些
+ * null 属性再解析一次，且只有重试成功才采用重试结果。由此：
  *   - 真正接受 null 的 `.nullable()` 字段：原始即可解析 → 不触发重试 → `null` 保留；
  *   - 与 null 无关的真实校验错误：去 null 后仍失败 → 返回原始错误，不掩盖；
  *   - 可选非空字段被强制塞入的 `null`：去掉后变缺省，`.optional()` 通过。
  *
- * 仅处理顶层 null，与 `makeSchemaNullable` 仅顶层可空的范围对齐。
+ * 递归处理嵌套对象与数组元素——`human_form_input` 这类工具的可选字段藏在
+ * `variables[].min_value` 等数组元素内部，模型对不适用的字段（如文本框的数值范围）
+ * 习惯性回传 `null`，只剥顶层会漏掉它们、导致整个阻塞工具因校验失败被跳过（handler
+ * 不执行、不阻塞，对话直接溜到下一轮）。
  */
 export declare function safeParseToolInputWithNullCoercion<T extends z.ZodType>(schema: T, input: unknown): ReturnType<T['safeParse']>;

package/dist/providers/codex/shim.d.ts

@@ -115,7 +115,7 @@ export declare function convertToolsToResponsesTools(tools: Array<{
     input_schema?: Record<string, unknown>;
     type?: string;
     [k: string]: unknown;
-}>): ResponsesTool[];
+}>, model?: string): ResponsesTool[];
 export declare function performCodexRequest(options: {
     request: ResolvedProviderRequest;
     credentials: ResolvedCodexCredentials;

package/dist/providers/openai/schema.d.ts

@@ -1 +1 @@
-export { sanitizeSchemaForOpenAICompat, makeSchemaNullable, } from '../../lib/schemaSanitizer.js';
+export { sanitizeSchemaForOpenAICompat, makeSchemaNullable, splitTypeArrayToAnyOf, strictifyJsonSchema, } from '../../lib/schemaSanitizer.js';

package/dist/providers/openai/wire.d.ts

@@ -1,4 +1,4 @@
-import { type AnthropicStreamEvent } from '../../providers/openai/shim.js';
+import type { AnthropicStreamEvent } from '../../providers/codex/shim.js';
 import type { NormalizedRequest, NormalizedResponse, StreamEvent } from '../types.js';
 export interface OpenAIWireContext {
     /**