@opencow-ai/opencow-agent-sdk 0.4.2 → 0.4.3

package/dist/cli.mjs

@@ -84200,6 +84200,22 @@ function sanitizeTypeField(record2) {
     record2.type = filtered;
   }
 }
+function makeSchemaNullable(schema) {
+  if ("enum" in schema || "const" in schema)
+    return schema;
+  const raw = schema.type;
+  if (typeof raw === "string") {
+    if (raw === "null")
+      return schema;
+    return { ...schema, type: [raw, "null"] };
+  }
+  if (Array.isArray(raw)) {
+    if (raw.includes("null"))
+      return schema;
+    return { ...schema, type: [...raw, "null"] };
+  }
+  return schema;
+}
 function sanitizeSchemaForOpenAICompat(schema) {
   const stripped = stripSchemaKeywords(schema, OPENAI_INCOMPATIBLE_SCHEMA_KEYWORDS);
   if (!isSchemaRecord(stripped)) {
@@ -84516,7 +84532,7 @@ function convertAnthropicMessagesToResponsesInput(messages) {
   }
   return items.filter((item) => item.type !== "message" || item.content.length > 0);
 }
-function enforceStrictSchema(schema) {
+function enforceStrictSchema(schema, topLevel = true) {
   const record2 = sanitizeSchemaForOpenAICompat(schema);
   if (record2.format === "uri") {
     delete record2.format;
@@ -84525,10 +84541,10 @@ function enforceStrictSchema(schema) {
     record2.additionalProperties = false;
     if (record2.properties && typeof record2.properties === "object" && !Array.isArray(record2.properties)) {
       const props = record2.properties;
-      const allKeys = Object.keys(props);
+      const originalRequired = Array.isArray(record2.required) ? record2.required.filter((key) => typeof key === "string") : [];
       const enforcedProps = {};
       for (const [key, value] of Object.entries(props)) {
-        const strictValue = enforceStrictSchema(value);
+        const strictValue = enforceStrictSchema(value, false);
         if (strictValue && typeof strictValue === "object" && strictValue.type === "object" && strictValue.additionalProperties === false && (!strictValue.properties || Object.keys(strictValue.properties).length === 0)) {
           continue;
         }
@@ -84536,20 +84552,27 @@ function enforceStrictSchema(schema) {
       }
       record2.properties = enforcedProps;
       record2.required = Object.keys(enforcedProps);
+      if (topLevel) {
+        for (const key of Object.keys(enforcedProps)) {
+          if (!originalRequired.includes(key)) {
+            enforcedProps[key] = makeSchemaNullable(enforcedProps[key]);
+          }
+        }
+      }
     } else {
       record2.required = [];
     }
   }
   if ("items" in record2) {
     if (Array.isArray(record2.items)) {
-      record2.items = record2.items.map((item) => enforceStrictSchema(item));
+      record2.items = record2.items.map((item) => enforceStrictSchema(item, false));
     } else {
-      record2.items = enforceStrictSchema(record2.items);
+      record2.items = enforceStrictSchema(record2.items, false);
     }
   }
   for (const key of ["anyOf", "oneOf", "allOf"]) {
     if (key in record2 && Array.isArray(record2[key])) {
-      record2[key] = record2[key].map((item) => enforceStrictSchema(item));
+      record2[key] = record2[key].map((item) => enforceStrictSchema(item, false));
     }
   }
   return record2;
@@ -85241,34 +85264,41 @@ function convertMessages(messages, system) {
   }
   return result;
 }
-function normalizeSchemaForOpenAI(schema, strict = true) {
+function normalizeSchemaForOpenAI(schema, strict = true, topLevel = true) {
   const record2 = sanitizeSchemaForOpenAICompat(schema);
   if (record2.type === "object" && record2.properties) {
     const properties = record2.properties;
     const existingRequired = Array.isArray(record2.required) ? record2.required : [];
     const normalizedProps = {};
     for (const [key, value] of Object.entries(properties)) {
-      normalizedProps[key] = normalizeSchemaForOpenAI(value, strict);
+      normalizedProps[key] = normalizeSchemaForOpenAI(value, strict, false);
     }
     record2.properties = normalizedProps;
     if (strict) {
       const allKeys = Object.keys(normalizedProps);
       record2.required = Array.from(new Set([...existingRequired, ...allKeys]));
       record2.additionalProperties = false;
+      if (topLevel) {
+        for (const key of allKeys) {
+          if (!existingRequired.includes(key)) {
+            normalizedProps[key] = makeSchemaNullable(normalizedProps[key]);
+          }
+        }
+      }
     } else {
       record2.required = existingRequired.filter((k) => (k in normalizedProps));
     }
   }
   if ("items" in record2) {
     if (Array.isArray(record2.items)) {
-      record2.items = record2.items.map((item) => normalizeSchemaForOpenAI(item, strict));
+      record2.items = record2.items.map((item) => normalizeSchemaForOpenAI(item, strict, false));
     } else {
-      record2.items = normalizeSchemaForOpenAI(record2.items, strict);
+      record2.items = normalizeSchemaForOpenAI(record2.items, strict, false);
     }
   }
   for (const key of ["anyOf", "oneOf", "allOf"]) {
     if (key in record2 && Array.isArray(record2[key])) {
-      record2[key] = record2[key].map((item) => normalizeSchemaForOpenAI(item, strict));
+      record2[key] = record2[key].map((item) => normalizeSchemaForOpenAI(item, strict, false));
     }
   }
   return record2;
@@ -94171,7 +94201,7 @@ function printStartupScreen() {
   const sLen = ` ● ${sL}    Ready — type /help to begin`.length;
   out.push(boxRow(sRow, W2, sLen));
   out.push(`${rgb(...BORDER)}╚${"═".repeat(W2 - 2)}╝${RESET}`);
-  out.push(`  ${DIM}${rgb(...DIMCOL)}opencow ${RESET}${rgb(...ACCENT)}v${"0.4.2"}${RESET}`);
+  out.push(`  ${DIM}${rgb(...DIMCOL)}opencow ${RESET}${rgb(...ACCENT)}v${"0.4.3"}${RESET}`);
   out.push("");
   process.stdout.write(out.join(`
 `) + `
@@ -120565,7 +120595,7 @@ var init_FileReadTool = __esm(() => {
     },
     renderToolUseErrorMessage,
     async validateInput({ file_path, pages }, toolUseContext) {
-      if (pages !== undefined) {
+      if (typeof pages === "string" && pages.trim() !== "") {
         const parsed = parsePDFPageRange(pages);
         if (!parsed) {
           return {
@@ -120614,7 +120644,8 @@ var init_FileReadTool = __esm(() => {
       }
       return { result: true };
     },
-    async call({ file_path, offset = 1, limit = undefined, pages }, context3, _canUseTool, parentMessage) {
+    async call({ file_path, offset = 1, limit = undefined, pages: rawPages }, context3, _canUseTool, parentMessage) {
+      const pages = typeof rawPages === "string" && rawPages.trim() !== "" ? rawPages : undefined;
       const { readFileState, fileReadingLimits } = context3;
       const defaults2 = getDefaultFileReadingLimits();
       const maxSizeBytes = fileReadingLimits?.maxSizeBytes ?? defaults2.maxSizeBytes;
@@ -239449,6 +239480,30 @@ var init_permissionLogging = __esm(() => {
   CODE_EDITING_TOOLS = ["Edit", "Write", "NotebookEdit"];
 });
 
+// src/lib/toolInputNullCoercion.ts
+function omitNullProps(input) {
+  const out = {};
+  for (const [key, value] of Object.entries(input)) {
+    if (value !== null)
+      out[key] = value;
+  }
+  return out;
+}
+function safeParseToolInputWithNullCoercion(schema, input) {
+  const first = schema.safeParse(input);
+  if (first.success)
+    return first;
+  if (input === null || typeof input !== "object" || Array.isArray(input)) {
+    return first;
+  }
+  const record3 = input;
+  const hasNull = Object.values(record3).some((value) => value === null);
+  if (!hasNull)
+    return first;
+  const retry = schema.safeParse(omitNullProps(record3));
+  return retry.success ? retry : first;
+}
+
 // src/constants/tools.ts
 var ALL_AGENT_DISALLOWED_TOOLS, CUSTOM_AGENT_DISALLOWED_TOOLS, ASYNC_AGENT_ALLOWED_TOOLS, IN_PROCESS_TEAMMATE_ALLOWED_TOOLS, COORDINATOR_MODE_ALLOWED_TOOLS;
 var init_tools = __esm(() => {
@@ -240552,7 +240607,7 @@ function streamedCheckPermissionsAndCallTool(tool, toolUseID, input, toolUseCont
   return stream4;
 }
 async function checkPermissionsAndCallTool(tool, toolUseID, input, toolUseContext, canUseTool, assistantMessage, messageId, requestId, mcpServerType, mcpServerBaseUrl, onToolProgress) {
-  const parsedInput = tool.inputSchema.safeParse(input);
+  const parsedInput = safeParseToolInputWithNullCoercion(tool.inputSchema, input);
   if (!parsedInput.success) {
     let errorContent = formatZodValidationError(tool.name, parsedInput.error);
     const schemaHint = buildSchemaNotSentHint(tool, toolUseContext.messages, toolUseContext.options.tools);
@@ -243937,7 +243992,7 @@ function getAnthropicEnvMetadata() {
 function getBuildAgeMinutes() {
   if (false)
     ;
-  const buildTime = new Date("2026-05-19T14:04:55.374Z").getTime();
+  const buildTime = new Date("2026-05-25T12:12:24.294Z").getTime();
   if (isNaN(buildTime))
     return;
   return Math.floor((Date.now() - buildTime) / 60000);
@@ -479076,7 +479131,7 @@ function buildPrimarySection() {
   }, undefined, false, undefined, this);
   return [{
     label: "Version",
-    value: "0.4.2"
+    value: "0.4.3"
   }, {
     label: "Session name",
     value: nameValue
@@ -535394,7 +535449,7 @@ var init_bridge_kick = __esm(() => {
 var call58 = async () => {
   return {
     type: "text",
-    value: `${"99.0.0"} (built ${"2026-05-19T14:04:55.374Z"})`
+    value: `${"99.0.0"} (built ${"2026-05-25T12:12:24.294Z"})`
   };
 }, version2, version_default;
 var init_version = __esm(() => {
@@ -557504,7 +557559,7 @@ function WelcomeV2() {
             dimColor: true,
             children: [
               "v",
-              "0.4.2",
+              "0.4.3",
               " "
             ]
           }, undefined, true, undefined, this)
@@ -557704,7 +557759,7 @@ function WelcomeV2() {
           dimColor: true,
           children: [
             "v",
-            "0.4.2",
+            "0.4.3",
             " "
           ]
         }, undefined, true, undefined, this)
@@ -557930,7 +557985,7 @@ function AppleTerminalWelcomeV2(t0) {
         dimColor: true,
         children: [
           "v",
-          "0.4.2",
+          "0.4.3",
           " "
         ]
       }, undefined, true, undefined, this);
@@ -558184,7 +558239,7 @@ function AppleTerminalWelcomeV2(t0) {
       dimColor: true,
       children: [
         "v",
-        "0.4.2",
+        "0.4.3",
         " "
       ]
     }, undefined, true, undefined, this);
@@ -579030,7 +579085,7 @@ Usage: claude --remote "your task description"`, () => gracefulShutdown(1));
         pendingHookMessages
       }, renderAndRun);
     }
-  }).version("0.4.2 (OpenCow)", "-v, --version", "Output the version number");
+  }).version("0.4.3 (OpenCow)", "-v, --version", "Output the version number");
   program2.option("-w, --worktree [name]", "Create a new git worktree for this session (optionally specify a name)");
   program2.option("--tmux", "Create a tmux session for the worktree (requires --worktree). Uses iTerm2 native panes when available; use --tmux=classic for traditional tmux.");
   if (canUserConfigureAdvisor()) {
@@ -579676,7 +579731,7 @@ if (false) {}
 async function main2() {
   const args = process.argv.slice(2);
   if (args.length === 1 && (args[0] === "--version" || args[0] === "-v" || args[0] === "-V")) {
-    console.log(`${"0.4.2"} (OpenCow)`);
+    console.log(`${"0.4.3"} (OpenCow)`);
     return;
   }
   if (args.includes("--provider")) {
@@ -579794,4 +579849,4 @@ async function main2() {
 }
 main2();
 
-//# debugId=04CA1BD278A0566564756E2164756E21
+//# debugId=29A0EB81D23B627164756E2164756E21

package/dist/client.js

@@ -94949,6 +94949,22 @@ function sanitizeTypeField(record3) {
     record3.type = filtered;
   }
 }
+function makeSchemaNullable(schema) {
+  if ("enum" in schema || "const" in schema)
+    return schema;
+  const raw = schema.type;
+  if (typeof raw === "string") {
+    if (raw === "null")
+      return schema;
+    return { ...schema, type: [raw, "null"] };
+  }
+  if (Array.isArray(raw)) {
+    if (raw.includes("null"))
+      return schema;
+    return { ...schema, type: [...raw, "null"] };
+  }
+  return schema;
+}
 function sanitizeSchemaForOpenAICompat(schema) {
   const stripped = stripSchemaKeywords(schema, OPENAI_INCOMPATIBLE_SCHEMA_KEYWORDS);
   if (!isSchemaRecord(stripped)) {
@@ -95265,7 +95281,7 @@ function convertAnthropicMessagesToResponsesInput(messages) {
   }
   return items.filter((item) => item.type !== "message" || item.content.length > 0);
 }
-function enforceStrictSchema(schema) {
+function enforceStrictSchema(schema, topLevel = true) {
   const record3 = sanitizeSchemaForOpenAICompat(schema);
   if (record3.format === "uri") {
     delete record3.format;
@@ -95274,10 +95290,10 @@ function enforceStrictSchema(schema) {
     record3.additionalProperties = false;
     if (record3.properties && typeof record3.properties === "object" && !Array.isArray(record3.properties)) {
       const props = record3.properties;
-      const allKeys = Object.keys(props);
+      const originalRequired = Array.isArray(record3.required) ? record3.required.filter((key) => typeof key === "string") : [];
       const enforcedProps = {};
       for (const [key, value] of Object.entries(props)) {
-        const strictValue = enforceStrictSchema(value);
+        const strictValue = enforceStrictSchema(value, false);
         if (strictValue && typeof strictValue === "object" && strictValue.type === "object" && strictValue.additionalProperties === false && (!strictValue.properties || Object.keys(strictValue.properties).length === 0)) {
           continue;
         }
@@ -95285,20 +95301,27 @@ function enforceStrictSchema(schema) {
       }
       record3.properties = enforcedProps;
       record3.required = Object.keys(enforcedProps);
+      if (topLevel) {
+        for (const key of Object.keys(enforcedProps)) {
+          if (!originalRequired.includes(key)) {
+            enforcedProps[key] = makeSchemaNullable(enforcedProps[key]);
+          }
+        }
+      }
     } else {
       record3.required = [];
     }
   }
   if ("items" in record3) {
     if (Array.isArray(record3.items)) {
-      record3.items = record3.items.map((item) => enforceStrictSchema(item));
+      record3.items = record3.items.map((item) => enforceStrictSchema(item, false));
     } else {
-      record3.items = enforceStrictSchema(record3.items);
+      record3.items = enforceStrictSchema(record3.items, false);
     }
   }
   for (const key of ["anyOf", "oneOf", "allOf"]) {
     if (key in record3 && Array.isArray(record3[key])) {
-      record3[key] = record3[key].map((item) => enforceStrictSchema(item));
+      record3[key] = record3[key].map((item) => enforceStrictSchema(item, false));
     }
   }
   return record3;
@@ -96065,34 +96088,41 @@ function convertMessages(messages, system) {
   }
   return result;
 }
-function normalizeSchemaForOpenAI(schema, strict = true) {
+function normalizeSchemaForOpenAI(schema, strict = true, topLevel = true) {
   const record3 = sanitizeSchemaForOpenAICompat(schema);
   if (record3.type === "object" && record3.properties) {
     const properties = record3.properties;
     const existingRequired = Array.isArray(record3.required) ? record3.required : [];
     const normalizedProps = {};
     for (const [key, value] of Object.entries(properties)) {
-      normalizedProps[key] = normalizeSchemaForOpenAI(value, strict);
+      normalizedProps[key] = normalizeSchemaForOpenAI(value, strict, false);
     }
     record3.properties = normalizedProps;
     if (strict) {
       const allKeys = Object.keys(normalizedProps);
       record3.required = Array.from(new Set([...existingRequired, ...allKeys]));
       record3.additionalProperties = false;
+      if (topLevel) {
+        for (const key of allKeys) {
+          if (!existingRequired.includes(key)) {
+            normalizedProps[key] = makeSchemaNullable(normalizedProps[key]);
+          }
+        }
+      }
     } else {
       record3.required = existingRequired.filter((k) => (k in normalizedProps));
     }
   }
   if ("items" in record3) {
     if (Array.isArray(record3.items)) {
-      record3.items = record3.items.map((item) => normalizeSchemaForOpenAI(item, strict));
+      record3.items = record3.items.map((item) => normalizeSchemaForOpenAI(item, strict, false));
     } else {
-      record3.items = normalizeSchemaForOpenAI(record3.items, strict);
+      record3.items = normalizeSchemaForOpenAI(record3.items, strict, false);
     }
   }
   for (const key of ["anyOf", "oneOf", "allOf"]) {
     if (key in record3 && Array.isArray(record3[key])) {
-      record3[key] = record3[key].map((item) => normalizeSchemaForOpenAI(item, strict));
+      record3[key] = record3[key].map((item) => normalizeSchemaForOpenAI(item, strict, false));
     }
   }
   return record3;
@@ -223607,6 +223637,30 @@ var init_permissionLogging = __esm(() => {
   CODE_EDITING_TOOLS = ["Edit", "Write", "NotebookEdit"];
 });
 
+// src/lib/toolInputNullCoercion.ts
+function omitNullProps(input) {
+  const out = {};
+  for (const [key, value] of Object.entries(input)) {
+    if (value !== null)
+      out[key] = value;
+  }
+  return out;
+}
+function safeParseToolInputWithNullCoercion(schema, input) {
+  const first = schema.safeParse(input);
+  if (first.success)
+    return first;
+  if (input === null || typeof input !== "object" || Array.isArray(input)) {
+    return first;
+  }
+  const record3 = input;
+  const hasNull = Object.values(record3).some((value) => value === null);
+  if (!hasNull)
+    return first;
+  const retry = schema.safeParse(omitNullProps(record3));
+  return retry.success ? retry : first;
+}
+
 // src/constants/tools.ts
 var ALL_AGENT_DISALLOWED_TOOLS, CUSTOM_AGENT_DISALLOWED_TOOLS, ASYNC_AGENT_ALLOWED_TOOLS, IN_PROCESS_TEAMMATE_ALLOWED_TOOLS, COORDINATOR_MODE_ALLOWED_TOOLS;
 var init_tools = __esm(() => {
@@ -279452,7 +279506,7 @@ function streamedCheckPermissionsAndCallTool(tool, toolUseID, input, toolUseCont
   return stream4;
 }
 async function checkPermissionsAndCallTool(tool, toolUseID, input, toolUseContext, canUseTool, assistantMessage, messageId, requestId, mcpServerType, mcpServerBaseUrl, onToolProgress) {
-  const parsedInput = tool.inputSchema.safeParse(input);
+  const parsedInput = safeParseToolInputWithNullCoercion(tool.inputSchema, input);
   if (!parsedInput.success) {
     let errorContent = formatZodValidationError(tool.name, parsedInput.error);
     const schemaHint = buildSchemaNotSentHint(tool, toolUseContext.messages, toolUseContext.options.tools);
@@ -282034,7 +282088,7 @@ function getAnthropicEnvMetadata() {
 function getBuildAgeMinutes() {
   if (false)
     ;
-  const buildTime = new Date("2026-05-19T14:04:55.374Z").getTime();
+  const buildTime = new Date("2026-05-25T12:12:24.294Z").getTime();
   if (isNaN(buildTime))
     return;
   return Math.floor((Date.now() - buildTime) / 60000);
@@ -285786,7 +285840,7 @@ var init_FileReadTool = __esm(() => {
     },
     renderToolUseErrorMessage: renderToolUseErrorMessage9,
     async validateInput({ file_path, pages }, toolUseContext) {
-      if (pages !== undefined) {
+      if (typeof pages === "string" && pages.trim() !== "") {
         const parsed = parsePDFPageRange(pages);
         if (!parsed) {
           return {
@@ -285835,7 +285889,8 @@ var init_FileReadTool = __esm(() => {
       }
       return { result: true };
     },
-    async call({ file_path, offset = 1, limit = undefined, pages }, context4, _canUseTool, parentMessage) {
+    async call({ file_path, offset = 1, limit = undefined, pages: rawPages }, context4, _canUseTool, parentMessage) {
+      const pages = typeof rawPages === "string" && rawPages.trim() !== "" ? rawPages : undefined;
       const { readFileState, fileReadingLimits } = context4;
       const defaults2 = getDefaultFileReadingLimits();
       const maxSizeBytes = fileReadingLimits?.maxSizeBytes ?? defaults2.maxSizeBytes;
@@ -335213,4 +335268,4 @@ export {
   AbortError2 as AbortError
 };
 
-//# debugId=003768B505C730B064756E2164756E21
+//# debugId=5554484DB05DB0BC64756E2164756E21

package/dist/lib/schemaSanitizer.d.ts

@@ -1,3 +1,18 @@
+/**
+ * 把一个属性 schema 标记为「可空」。用于 OpenAI/Codex strict 模式下被强制列入
+ * `required` 的「原本可选」字段：strict 模式要求每个属性都出现在 `required`，
+ * 否则 400。这会逼模型给本应省略的可选字段编造一个占位值（典型即空串 `""`），
+ * 下游再因这个空值报错（issue #79：Read 的 `pages: ""` → Invalid pages parameter；
+ * issue #77：gpt 用 read 工具频繁出错）。让字段可空后，模型可以用 `null` 明确表达
+ * 「未提供」，再由入参解析层把 `null` 还原为缺省。
+ *
+ * 仅处理能安全增补的形态，限制 blast radius：
+ *   - 具名 `type`（string/number/...）→ 追加 `"null"`
+ *   - `type` 数组 → 追加 `"null"`
+ * 带 `enum`/`const` 的字段保持不动（避免 type 允许 null 而枚举/常量不含 null 的
+ * 自相矛盾）；仅含 anyOf/oneOf 等组合子或无明确 `type` 的字段也保持不动（零回归）。
+ */
+export declare function makeSchemaNullable(schema: Record<string, unknown>): Record<string, unknown>;
 /**
  * Sanitize JSON Schema into a shape OpenAI-compatible providers and Codex
  * strict-mode tooling are more likely to accept. This strips provider-rejected

package/dist/lib/toolInputNullCoercion.d.ts

@@ -0,0 +1,20 @@
+import type { z } from 'zod/v4';
+/**
+ * 解析工具入参，并对 strict provider 把可选字段强制为 nullable 后模型回传的 `null`
+ * 做兜底还原。
+ *
+ * 背景：OpenAI/Codex strict 模式要求每个属性都出现在 `required`，可选字段会被
+ * `makeSchemaNullable` 标成可空（见 lib/schemaSanitizer.ts），模型遂用 `null` 表达
+ * 「未提供」。但工具的 Zod inputSchema 多用 `.optional()`（不接受 `null`），若直接
+ * `safeParse` 会得到 InputValidationError —— 这正是「① 让 wire schema 可空」必须搭配的
+ * 入参侧兜底（issue #79/#77）。
+ *
+ * 策略：先按原始 schema 解析；仅当「解析失败 且 顶层含 null 值」时，去掉这些 null 键
+ * 再解析一次，且只有重试成功才采用重试结果。由此：
+ *   - 真正接受 null 的 `.nullable()` 字段：原始即可解析 → 不触发重试 → `null` 保留；
+ *   - 与 null 无关的真实校验错误：去 null 后仍失败 → 返回原始错误，不掩盖；
+ *   - 可选非空字段被强制塞入的 `null`：去掉后变缺省，`.optional()` 通过。
+ *
+ * 仅处理顶层 null，与 `makeSchemaNullable` 仅顶层可空的范围对齐。
+ */
+export declare function safeParseToolInputWithNullCoercion<T extends z.ZodType>(schema: T, input: unknown): ReturnType<T['safeParse']>;

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

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

package/dist/sdk.js

@@ -94949,6 +94949,22 @@ function sanitizeTypeField(record3) {
     record3.type = filtered;
   }
 }
+function makeSchemaNullable(schema) {
+  if ("enum" in schema || "const" in schema)
+    return schema;
+  const raw = schema.type;
+  if (typeof raw === "string") {
+    if (raw === "null")
+      return schema;
+    return { ...schema, type: [raw, "null"] };
+  }
+  if (Array.isArray(raw)) {
+    if (raw.includes("null"))
+      return schema;
+    return { ...schema, type: [...raw, "null"] };
+  }
+  return schema;
+}
 function sanitizeSchemaForOpenAICompat(schema) {
   const stripped = stripSchemaKeywords(schema, OPENAI_INCOMPATIBLE_SCHEMA_KEYWORDS);
   if (!isSchemaRecord(stripped)) {
@@ -95265,7 +95281,7 @@ function convertAnthropicMessagesToResponsesInput(messages) {
   }
   return items.filter((item) => item.type !== "message" || item.content.length > 0);
 }
-function enforceStrictSchema(schema) {
+function enforceStrictSchema(schema, topLevel = true) {
   const record3 = sanitizeSchemaForOpenAICompat(schema);
   if (record3.format === "uri") {
     delete record3.format;
@@ -95274,10 +95290,10 @@ function enforceStrictSchema(schema) {
     record3.additionalProperties = false;
     if (record3.properties && typeof record3.properties === "object" && !Array.isArray(record3.properties)) {
       const props = record3.properties;
-      const allKeys = Object.keys(props);
+      const originalRequired = Array.isArray(record3.required) ? record3.required.filter((key) => typeof key === "string") : [];
       const enforcedProps = {};
       for (const [key, value] of Object.entries(props)) {
-        const strictValue = enforceStrictSchema(value);
+        const strictValue = enforceStrictSchema(value, false);
         if (strictValue && typeof strictValue === "object" && strictValue.type === "object" && strictValue.additionalProperties === false && (!strictValue.properties || Object.keys(strictValue.properties).length === 0)) {
           continue;
         }
@@ -95285,20 +95301,27 @@ function enforceStrictSchema(schema) {
       }
       record3.properties = enforcedProps;
       record3.required = Object.keys(enforcedProps);
+      if (topLevel) {
+        for (const key of Object.keys(enforcedProps)) {
+          if (!originalRequired.includes(key)) {
+            enforcedProps[key] = makeSchemaNullable(enforcedProps[key]);
+          }
+        }
+      }
     } else {
       record3.required = [];
     }
   }
   if ("items" in record3) {
     if (Array.isArray(record3.items)) {
-      record3.items = record3.items.map((item) => enforceStrictSchema(item));
+      record3.items = record3.items.map((item) => enforceStrictSchema(item, false));
     } else {
-      record3.items = enforceStrictSchema(record3.items);
+      record3.items = enforceStrictSchema(record3.items, false);
     }
   }
   for (const key of ["anyOf", "oneOf", "allOf"]) {
     if (key in record3 && Array.isArray(record3[key])) {
-      record3[key] = record3[key].map((item) => enforceStrictSchema(item));
+      record3[key] = record3[key].map((item) => enforceStrictSchema(item, false));
     }
   }
   return record3;
@@ -96065,34 +96088,41 @@ function convertMessages(messages, system) {
   }
   return result;
 }
-function normalizeSchemaForOpenAI(schema, strict = true) {
+function normalizeSchemaForOpenAI(schema, strict = true, topLevel = true) {
   const record3 = sanitizeSchemaForOpenAICompat(schema);
   if (record3.type === "object" && record3.properties) {
     const properties = record3.properties;
     const existingRequired = Array.isArray(record3.required) ? record3.required : [];
     const normalizedProps = {};
     for (const [key, value] of Object.entries(properties)) {
-      normalizedProps[key] = normalizeSchemaForOpenAI(value, strict);
+      normalizedProps[key] = normalizeSchemaForOpenAI(value, strict, false);
     }
     record3.properties = normalizedProps;
     if (strict) {
       const allKeys = Object.keys(normalizedProps);
       record3.required = Array.from(new Set([...existingRequired, ...allKeys]));
       record3.additionalProperties = false;
+      if (topLevel) {
+        for (const key of allKeys) {
+          if (!existingRequired.includes(key)) {
+            normalizedProps[key] = makeSchemaNullable(normalizedProps[key]);
+          }
+        }
+      }
     } else {
       record3.required = existingRequired.filter((k) => (k in normalizedProps));
     }
   }
   if ("items" in record3) {
     if (Array.isArray(record3.items)) {
-      record3.items = record3.items.map((item) => normalizeSchemaForOpenAI(item, strict));
+      record3.items = record3.items.map((item) => normalizeSchemaForOpenAI(item, strict, false));
     } else {
-      record3.items = normalizeSchemaForOpenAI(record3.items, strict);
+      record3.items = normalizeSchemaForOpenAI(record3.items, strict, false);
     }
   }
   for (const key of ["anyOf", "oneOf", "allOf"]) {
     if (key in record3 && Array.isArray(record3[key])) {
-      record3[key] = record3[key].map((item) => normalizeSchemaForOpenAI(item, strict));
+      record3[key] = record3[key].map((item) => normalizeSchemaForOpenAI(item, strict, false));
     }
   }
   return record3;
@@ -223607,6 +223637,30 @@ var init_permissionLogging = __esm(() => {
   CODE_EDITING_TOOLS = ["Edit", "Write", "NotebookEdit"];
 });
 
+// src/lib/toolInputNullCoercion.ts
+function omitNullProps(input) {
+  const out = {};
+  for (const [key, value] of Object.entries(input)) {
+    if (value !== null)
+      out[key] = value;
+  }
+  return out;
+}
+function safeParseToolInputWithNullCoercion(schema, input) {
+  const first = schema.safeParse(input);
+  if (first.success)
+    return first;
+  if (input === null || typeof input !== "object" || Array.isArray(input)) {
+    return first;
+  }
+  const record3 = input;
+  const hasNull = Object.values(record3).some((value) => value === null);
+  if (!hasNull)
+    return first;
+  const retry = schema.safeParse(omitNullProps(record3));
+  return retry.success ? retry : first;
+}
+
 // src/constants/tools.ts
 var ALL_AGENT_DISALLOWED_TOOLS, CUSTOM_AGENT_DISALLOWED_TOOLS, ASYNC_AGENT_ALLOWED_TOOLS, IN_PROCESS_TEAMMATE_ALLOWED_TOOLS, COORDINATOR_MODE_ALLOWED_TOOLS;
 var init_tools = __esm(() => {
@@ -279452,7 +279506,7 @@ function streamedCheckPermissionsAndCallTool(tool, toolUseID, input, toolUseCont
   return stream4;
 }
 async function checkPermissionsAndCallTool(tool, toolUseID, input, toolUseContext, canUseTool, assistantMessage, messageId, requestId, mcpServerType, mcpServerBaseUrl, onToolProgress) {
-  const parsedInput = tool.inputSchema.safeParse(input);
+  const parsedInput = safeParseToolInputWithNullCoercion(tool.inputSchema, input);
   if (!parsedInput.success) {
     let errorContent = formatZodValidationError(tool.name, parsedInput.error);
     const schemaHint = buildSchemaNotSentHint(tool, toolUseContext.messages, toolUseContext.options.tools);
@@ -282034,7 +282088,7 @@ function getAnthropicEnvMetadata() {
 function getBuildAgeMinutes() {
   if (false)
     ;
-  const buildTime = new Date("2026-05-19T14:04:55.374Z").getTime();
+  const buildTime = new Date("2026-05-25T12:12:24.294Z").getTime();
   if (isNaN(buildTime))
     return;
   return Math.floor((Date.now() - buildTime) / 60000);
@@ -285786,7 +285840,7 @@ var init_FileReadTool = __esm(() => {
     },
     renderToolUseErrorMessage: renderToolUseErrorMessage9,
     async validateInput({ file_path, pages }, toolUseContext) {
-      if (pages !== undefined) {
+      if (typeof pages === "string" && pages.trim() !== "") {
         const parsed = parsePDFPageRange(pages);
         if (!parsed) {
           return {
@@ -285835,7 +285889,8 @@ var init_FileReadTool = __esm(() => {
       }
       return { result: true };
     },
-    async call({ file_path, offset = 1, limit = undefined, pages }, context4, _canUseTool, parentMessage) {
+    async call({ file_path, offset = 1, limit = undefined, pages: rawPages }, context4, _canUseTool, parentMessage) {
+      const pages = typeof rawPages === "string" && rawPages.trim() !== "" ? rawPages : undefined;
       const { readFileState, fileReadingLimits } = context4;
       const defaults2 = getDefaultFileReadingLimits();
       const maxSizeBytes = fileReadingLimits?.maxSizeBytes ?? defaults2.maxSizeBytes;
@@ -335213,4 +335268,4 @@ export {
   AbortError2 as AbortError
 };
 
-//# debugId=5D257F90247BA0D364756E2164756E21
+//# debugId=532222AFD20CE11464756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opencow-ai/opencow-agent-sdk",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "Claude Code opened to any LLM — OpenAI, Gemini, DeepSeek, Ollama, and 200+ models",
   "type": "module",
   "main": "./dist/sdk.js",