@tanstack/openai-base 0.8.6 → 0.8.8

package/dist/esm/tools/function-tool.d.ts

@@ -13,5 +13,11 @@ export type FunctionTool = FunctionToolConfig;
  * - additionalProperties: false
  *
  * This enables strict mode for all tools automatically.
+ *
+ * Some tool schemas (e.g. MCP server tools that use `oneOf`, `$ref`, or
+ * `$defs`) cannot be expressed under OpenAI's strict Structured Outputs
+ * subset. For those we fall back to a non-strict tool definition — stripping
+ * only the formats OpenAI rejects — so the tool is still usable instead of
+ * failing the request with a 400 "Invalid schema" error.
  */
 export declare function convertFunctionToolToAdapterFormat(tool: Tool): FunctionToolConfig;

package/dist/esm/tools/function-tool.js

@@ -1,10 +1,19 @@
-import { makeStructuredOutputCompatible } from "../utils/schema-converter.js";
+import { isStrictModeCompatible, stripUnsupportedFormats, makeStructuredOutputCompatible } from "../utils/schema-converter.js";
 function convertFunctionToolToAdapterFormat(tool) {
   const inputSchema = tool.inputSchema ?? {
     type: "object",
     properties: {},
     required: []
   };
+  if (!isStrictModeCompatible(inputSchema)) {
+    return {
+      type: "function",
+      name: tool.name,
+      description: tool.description,
+      parameters: stripUnsupportedFormats(inputSchema),
+      strict: false
+    };
+  }
   const jsonSchema = makeStructuredOutputCompatible(
     inputSchema,
     inputSchema.required || []

package/dist/esm/tools/function-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"function-tool.js","sources":["../../../src/tools/function-tool.ts"],"sourcesContent":["import { makeStructuredOutputCompatible } from '../utils/schema-converter'\nimport type { FunctionTool as FunctionToolConfig } from 'openai/resources/responses/responses'\nimport type { JSONSchema, Tool } from '@tanstack/ai'\n\nexport type { FunctionToolConfig }\n\n/** @deprecated Renamed to `FunctionToolConfig`. Will be removed in a future release. */\nexport type FunctionTool = FunctionToolConfig\n\n/**\n * Converts a standard Tool to OpenAI FunctionTool format.\n *\n * Tool schemas are already converted to JSON Schema in the ai layer.\n * We apply OpenAI-specific transformations for strict mode:\n * - All properties in required array\n * - Optional fields made nullable\n * - additionalProperties: false\n *\n * This enables strict mode for all tools automatically.\n */\nexport function convertFunctionToolToAdapterFormat(\n  tool: Tool,\n): FunctionToolConfig {\n  const inputSchema = (tool.inputSchema ?? {\n    type: 'object',\n    properties: {},\n    required: [],\n  }) as JSONSchema\n\n  const jsonSchema = makeStructuredOutputCompatible(\n    inputSchema,\n    inputSchema.required || [],\n  )\n\n  jsonSchema.additionalProperties = false\n\n  return {\n    type: 'function',\n    name: tool.name,\n    description: tool.description,\n    parameters: jsonSchema,\n    strict: true,\n  } satisfies FunctionToolConfig\n}\n"],"names":[],"mappings":";AAoBO,SAAS,mCACd,MACoB;AACpB,QAAM,cAAe,KAAK,eAAe;AAAA,IACvC,MAAM;AAAA,IACN,YAAY,CAAA;AAAA,IACZ,UAAU,CAAA;AAAA,EAAC;AAGb,QAAM,aAAa;AAAA,IACjB;AAAA,IACA,YAAY,YAAY,CAAA;AAAA,EAAC;AAG3B,aAAW,uBAAuB;AAElC,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM,KAAK;AAAA,IACX,aAAa,KAAK;AAAA,IAClB,YAAY;AAAA,IACZ,QAAQ;AAAA,EAAA;AAEZ;"}
+{"version":3,"file":"function-tool.js","sources":["../../../src/tools/function-tool.ts"],"sourcesContent":["import {\n  isStrictModeCompatible,\n  makeStructuredOutputCompatible,\n  stripUnsupportedFormats,\n} from '../utils/schema-converter'\nimport type { FunctionTool as FunctionToolConfig } from 'openai/resources/responses/responses'\nimport type { JSONSchema, Tool } from '@tanstack/ai'\n\nexport type { FunctionToolConfig }\n\n/** @deprecated Renamed to `FunctionToolConfig`. Will be removed in a future release. */\nexport type FunctionTool = FunctionToolConfig\n\n/**\n * Converts a standard Tool to OpenAI FunctionTool format.\n *\n * Tool schemas are already converted to JSON Schema in the ai layer.\n * We apply OpenAI-specific transformations for strict mode:\n * - All properties in required array\n * - Optional fields made nullable\n * - additionalProperties: false\n *\n * This enables strict mode for all tools automatically.\n *\n * Some tool schemas (e.g. MCP server tools that use `oneOf`, `$ref`, or\n * `$defs`) cannot be expressed under OpenAI's strict Structured Outputs\n * subset. For those we fall back to a non-strict tool definition — stripping\n * only the formats OpenAI rejects — so the tool is still usable instead of\n * failing the request with a 400 \"Invalid schema\" error.\n */\nexport function convertFunctionToolToAdapterFormat(\n  tool: Tool,\n): FunctionToolConfig {\n  const inputSchema = (tool.inputSchema ?? {\n    type: 'object',\n    properties: {},\n    required: [],\n  }) as JSONSchema\n\n  if (!isStrictModeCompatible(inputSchema)) {\n    return {\n      type: 'function',\n      name: tool.name,\n      description: tool.description,\n      parameters: stripUnsupportedFormats(inputSchema),\n      strict: false,\n    } satisfies FunctionToolConfig\n  }\n\n  const jsonSchema = makeStructuredOutputCompatible(\n    inputSchema,\n    inputSchema.required || [],\n  )\n\n  jsonSchema.additionalProperties = false\n\n  return {\n    type: 'function',\n    name: tool.name,\n    description: tool.description,\n    parameters: jsonSchema,\n    strict: true,\n  } satisfies FunctionToolConfig\n}\n"],"names":[],"mappings":";AA8BO,SAAS,mCACd,MACoB;AACpB,QAAM,cAAe,KAAK,eAAe;AAAA,IACvC,MAAM;AAAA,IACN,YAAY,CAAA;AAAA,IACZ,UAAU,CAAA;AAAA,EAAC;AAGb,MAAI,CAAC,uBAAuB,WAAW,GAAG;AACxC,WAAO;AAAA,MACL,MAAM;AAAA,MACN,MAAM,KAAK;AAAA,MACX,aAAa,KAAK;AAAA,MAClB,YAAY,wBAAwB,WAAW;AAAA,MAC/C,QAAQ;AAAA,IAAA;AAAA,EAEZ;AAEA,QAAM,aAAa;AAAA,IACjB;AAAA,IACA,YAAY,YAAY,CAAA;AAAA,EAAC;AAG3B,aAAW,uBAAuB;AAElC,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM,KAAK;AAAA,IACX,aAAa,KAAK;AAAA,IAClB,YAAY;AAAA,IACZ,QAAQ;AAAA,EAAA;AAEZ;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/openai-base",
-  "version": "0.8.6",
+  "version": "0.8.8",
   "description": "Shared OpenAI SDK base adapters for TanStack AI providers using Chat Completions and Responses APIs.",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -47,13 +47,13 @@
     "@tanstack/ai-utils": "0.2.2"
   },
   "peerDependencies": {
-    "@tanstack/ai": "^0.32.0"
+    "@tanstack/ai": "^0.33.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "4.0.14",
     "vite": "^7.3.3",
     "zod": "^4.2.0",
-    "@tanstack/ai": "0.32.0"
+    "@tanstack/ai": "0.33.0"
   },
   "scripts": {
     "build": "vite build",

package/src/tools/function-tool.ts

@@ -1,4 +1,8 @@
-import { makeStructuredOutputCompatible } from '../utils/schema-converter'
+import {
+  isStrictModeCompatible,
+  makeStructuredOutputCompatible,
+  stripUnsupportedFormats,
+} from '../utils/schema-converter'
 import type { FunctionTool as FunctionToolConfig } from 'openai/resources/responses/responses'
 import type { JSONSchema, Tool } from '@tanstack/ai'
 
@@ -17,6 +21,12 @@ export type FunctionTool = FunctionToolConfig
  * - additionalProperties: false
  *
  * This enables strict mode for all tools automatically.
+ *
+ * Some tool schemas (e.g. MCP server tools that use `oneOf`, `$ref`, or
+ * `$defs`) cannot be expressed under OpenAI's strict Structured Outputs
+ * subset. For those we fall back to a non-strict tool definition — stripping
+ * only the formats OpenAI rejects — so the tool is still usable instead of
+ * failing the request with a 400 "Invalid schema" error.
  */
 export function convertFunctionToolToAdapterFormat(
   tool: Tool,
@@ -27,6 +37,16 @@ export function convertFunctionToolToAdapterFormat(
     required: [],
   }) as JSONSchema
 
+  if (!isStrictModeCompatible(inputSchema)) {
+    return {
+      type: 'function',
+      name: tool.name,
+      description: tool.description,
+      parameters: stripUnsupportedFormats(inputSchema),
+      strict: false,
+    } satisfies FunctionToolConfig
+  }
+
   const jsonSchema = makeStructuredOutputCompatible(
     inputSchema,
     inputSchema.required || [],