@tanstack/openai-base 0.10.6 → 0.10.7

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

@@ -1,6 +1,24 @@
 import { getOpenAIProviderToolMetadata, openAIProviderTool } from "./openai-provider-tool.js";
 //#region src/tools/shell-tool.ts
 /**
+* Validate skill references carried by a shell `environment`. Previously the
+* factory validated nothing, so a malformed `skill_id` surfaced as an unframed
+* provider 400. Only `skill_reference` entries carry a `skill_id`; inline and
+* local skills are shaped differently and left untouched.
+*
+* ponytail: OpenAI documents no client-checkable count cap for shell skills
+* (unlike Anthropic's 8), so we validate `skill_id` format only and do not
+* fabricate a `SkillLimitError` count limit. Add one here if OpenAI publishes a cap.
+*/
+function validateShellEnvironment(environment) {
+	const skills = environment && "skills" in environment ? environment.skills : void 0;
+	if (!skills) return;
+	for (const skill of skills) if ("skill_id" in skill) {
+		const id = skill.skill_id;
+		if (id.length < 1 || id.length > 64) throw new Error("skill_id must be between 1 and 64 characters.");
+	}
+}
+/**
 * Converts a standard Tool to OpenAI ShellTool format, preserving any
 * `environment` (container config + skills) stored in metadata.
 */
@@ -18,6 +36,7 @@ function convertShellToolToAdapterFormat(tool) {
 * re-wrap this in their own package.
 */
 function shellTool(config = {}) {
+	validateShellEnvironment(config.environment);
 	return openAIProviderTool({
 		name: "shell",
 		description: "Execute shell commands",

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

@@ -1 +1 @@
-{"version":3,"file":"shell-tool.js","names":[],"sources":["../../../src/tools/shell-tool.ts"],"sourcesContent":["import {\n  getOpenAIProviderToolMetadata,\n  openAIProviderTool,\n} from './openai-provider-tool'\nimport type { FunctionShellTool as ShellToolConfig } from 'openai/resources/responses/responses'\nimport type { Tool } from '@tanstack/ai'\n\nexport type { ShellToolConfig }\n\n/** @deprecated Renamed to `ShellToolConfig`. Will be removed in a future release. */\nexport type ShellTool = ShellToolConfig\n\n/**\n * Config accepted by {@link shellTool}. `environment` mirrors the OpenAI\n * Responses API shell tool environment (e.g. `container_auto` + `skills`).\n * Typed via indexed access so it tracks the installed SDK without naming the\n * union members directly.\n */\nexport interface ShellToolFactoryConfig {\n  environment?: NonNullable<ShellToolConfig['environment']>\n}\n\n/**\n * Converts a standard Tool to OpenAI ShellTool format, preserving any\n * `environment` (container config + skills) stored in metadata.\n */\nexport function convertShellToolToAdapterFormat(tool: Tool): ShellToolConfig {\n  const metadata = (getOpenAIProviderToolMetadata(tool) ??\n    {}) as ShellToolFactoryConfig\n  return {\n    type: 'shell',\n    ...(metadata.environment !== undefined && {\n      environment: metadata.environment,\n    }),\n  }\n}\n\n/**\n * Creates a standard Tool from ShellTool parameters.\n *\n * Base (non-branded) factory. Providers that need branded return types should\n * re-wrap this in their own package.\n */\nexport function shellTool(config: ShellToolFactoryConfig = {}): Tool {\n  return openAIProviderTool(\n    {\n      name: 'shell',\n      description: 'Execute shell commands',\n      metadata: {\n        ...(config.environment !== undefined && {\n          environment: config.environment,\n        }),\n      },\n    },\n    'shell',\n  )\n}\n"],"mappings":";;;;;;AA0BA,SAAgB,gCAAgC,MAA6B;CAC3E,MAAM,WAAY,8BAA8B,IAAI,KAClD,CAAC;CACH,OAAO;EACL,MAAM;EACN,GAAI,SAAS,gBAAgB,KAAA,KAAa,EACxC,aAAa,SAAS,YACxB;CACF;AACF;;;;;;;AAQA,SAAgB,UAAU,SAAiC,CAAC,GAAS;CACnE,OAAO,mBACL;EACE,MAAM;EACN,aAAa;EACb,UAAU,EACR,GAAI,OAAO,gBAAgB,KAAA,KAAa,EACtC,aAAa,OAAO,YACtB,EACF;CACF,GACA,OACF;AACF"}
+{"version":3,"file":"shell-tool.js","names":[],"sources":["../../../src/tools/shell-tool.ts"],"sourcesContent":["import {\n  getOpenAIProviderToolMetadata,\n  openAIProviderTool,\n} from './openai-provider-tool'\nimport type { FunctionShellTool as ShellToolConfig } from 'openai/resources/responses/responses'\nimport type { Tool } from '@tanstack/ai'\n\nexport type { ShellToolConfig }\n\n/** @deprecated Renamed to `ShellToolConfig`. Will be removed in a future release. */\nexport type ShellTool = ShellToolConfig\n\n/**\n * Config accepted by {@link shellTool}. `environment` mirrors the OpenAI\n * Responses API shell tool environment (e.g. `container_auto` + `skills`).\n * Typed via indexed access so it tracks the installed SDK without naming the\n * union members directly.\n */\nexport interface ShellToolFactoryConfig {\n  environment?: NonNullable<ShellToolConfig['environment']>\n}\n\n/**\n * Validate skill references carried by a shell `environment`. Previously the\n * factory validated nothing, so a malformed `skill_id` surfaced as an unframed\n * provider 400. Only `skill_reference` entries carry a `skill_id`; inline and\n * local skills are shaped differently and left untouched.\n *\n * ponytail: OpenAI documents no client-checkable count cap for shell skills\n * (unlike Anthropic's 8), so we validate `skill_id` format only and do not\n * fabricate a `SkillLimitError` count limit. Add one here if OpenAI publishes a cap.\n */\nfunction validateShellEnvironment(\n  environment: ShellToolFactoryConfig['environment'],\n): void {\n  const skills =\n    environment && 'skills' in environment ? environment.skills : undefined\n  if (!skills) return\n  for (const skill of skills) {\n    if ('skill_id' in skill) {\n      const id = skill.skill_id\n      if (id.length < 1 || id.length > 64) {\n        throw new Error('skill_id must be between 1 and 64 characters.')\n      }\n    }\n  }\n}\n\n/**\n * Converts a standard Tool to OpenAI ShellTool format, preserving any\n * `environment` (container config + skills) stored in metadata.\n */\nexport function convertShellToolToAdapterFormat(tool: Tool): ShellToolConfig {\n  const metadata = (getOpenAIProviderToolMetadata(tool) ??\n    {}) as ShellToolFactoryConfig\n  return {\n    type: 'shell',\n    ...(metadata.environment !== undefined && {\n      environment: metadata.environment,\n    }),\n  }\n}\n\n/**\n * Creates a standard Tool from ShellTool parameters.\n *\n * Base (non-branded) factory. Providers that need branded return types should\n * re-wrap this in their own package.\n */\nexport function shellTool(config: ShellToolFactoryConfig = {}): Tool {\n  validateShellEnvironment(config.environment)\n  return openAIProviderTool(\n    {\n      name: 'shell',\n      description: 'Execute shell commands',\n      metadata: {\n        ...(config.environment !== undefined && {\n          environment: config.environment,\n        }),\n      },\n    },\n    'shell',\n  )\n}\n"],"mappings":";;;;;;;;;;;;AAgCA,SAAS,yBACP,aACM;CACN,MAAM,SACJ,eAAe,YAAY,cAAc,YAAY,SAAS,KAAA;CAChE,IAAI,CAAC,QAAQ;CACb,KAAK,MAAM,SAAS,QAClB,IAAI,cAAc,OAAO;EACvB,MAAM,KAAK,MAAM;EACjB,IAAI,GAAG,SAAS,KAAK,GAAG,SAAS,IAC/B,MAAM,IAAI,MAAM,+CAA+C;CAEnE;AAEJ;;;;;AAMA,SAAgB,gCAAgC,MAA6B;CAC3E,MAAM,WAAY,8BAA8B,IAAI,KAClD,CAAC;CACH,OAAO;EACL,MAAM;EACN,GAAI,SAAS,gBAAgB,KAAA,KAAa,EACxC,aAAa,SAAS,YACxB;CACF;AACF;;;;;;;AAQA,SAAgB,UAAU,SAAiC,CAAC,GAAS;CACnE,yBAAyB,OAAO,WAAW;CAC3C,OAAO,mBACL;EACE,MAAM;EACN,aAAa;EACb,UAAU,EACR,GAAI,OAAO,gBAAgB,KAAA,KAAa,EACtC,aAAa,OAAO,YACtB,EACF;CACF,GACA,OACF;AACF"}

package/dist/esm/utils/schema-converter.d.ts

@@ -37,7 +37,7 @@ export declare function makeStructuredOutputCompatibleWithMap(schema: Record<str
  * sent with `strict: false`. Two ways that happens:
  *
  * 1. It uses a JSON-Schema keyword outside OpenAI's strict subset anywhere in
- *    the tree (`oneOf`/`allOf`/`not`/`$ref`/`$defs`).
+ *    the tree (`oneOf`/`allOf`/`not`/`prefixItems`/`$ref`/`$defs`).
  * 2. It contains a *typeless* schema node — a property/items/anyOf entry with
  *    no `type` (nor `enum`/`const`/combinator), e.g. the `{}` that `z.any()`
  *    produces. Strict mode rejects typeless schemas.

package/dist/esm/utils/schema-converter.js

@@ -74,6 +74,8 @@ function makeStructuredOutputCompatibleWithMap(schema, originalRequired) {
 * emit these.
 *
 * - `oneOf` / `allOf` / `not` — combinator keywords strict mode rejects
+* - `prefixItems` — 2020-12 tuple keyword. openai-node's strict transform
+*   rejects it, so we send those tools with `strict: false` instead
 * - `$ref` / `$defs` / `definitions` — references and definition pools whose
 *   object subschemas escape the `additionalProperties: false` normalization
 *   strict mode requires
@@ -82,6 +84,7 @@ var STRICT_UNSUPPORTED_KEYWORDS = [
 	"oneOf",
 	"allOf",
 	"not",
+	"prefixItems",
 	"$ref",
 	"$defs",
 	"definitions"
@@ -109,7 +112,7 @@ var TYPE_INDICATOR_KEYWORDS = [
 * sent with `strict: false`. Two ways that happens:
 *
 * 1. It uses a JSON-Schema keyword outside OpenAI's strict subset anywhere in
-*    the tree (`oneOf`/`allOf`/`not`/`$ref`/`$defs`).
+*    the tree (`oneOf`/`allOf`/`not`/`prefixItems`/`$ref`/`$defs`).
 * 2. It contains a *typeless* schema node — a property/items/anyOf entry with
 *    no `type` (nor `enum`/`const`/combinator), e.g. the `{}` that `z.any()`
 *    produces. Strict mode rejects typeless schemas.
@@ -224,13 +227,10 @@ function coerceStrictSchema(schema, originalRequired) {
 				prop = nested.schema;
 				childMap = nested.nullWideningMap;
 				hasUntrackableAnyOfWidening ||= nested.hasUntrackableAnyOfWidening;
-			} else if (isSchemaObject(prop) && prop.type === "array" && prop.items) {
-				const nested = coerceStrictSchema(prop.items, prop.items.required || []);
-				prop = {
-					...prop,
-					items: nested.schema
-				};
-				childMap = nested.nullWideningMap ? { items: nested.nullWideningMap } : void 0;
+			} else if (isSchemaObject(prop) && prop.type === "array") {
+				const nested = coerceStrictSchema(prop, []);
+				prop = nested.schema;
+				childMap = nested.nullWideningMap;
 				hasUntrackableAnyOfWidening ||= nested.hasUntrackableAnyOfWidening;
 			} else if (isSchemaObject(prop) && prop.anyOf) {
 				const nested = coerceStrictSchema(prop, prop.required || []);
@@ -277,10 +277,25 @@ function coerceStrictSchema(schema, originalRequired) {
 		if (Object.keys(propertyMaps).length > 0) nullWideningMap.properties = propertyMaps;
 	}
 	if (result.type === "array" && result.items) {
-		const nested = coerceStrictSchema(result.items, result.items.required || []);
-		result.items = nested.schema;
-		if (nested.nullWideningMap) nullWideningMap.items = nested.nullWideningMap;
-		hasUntrackableAnyOfWidening ||= nested.hasUntrackableAnyOfWidening;
+		if (Array.isArray(result.items)) {
+			const itemMaps = [];
+			result.items = result.items.map((item) => {
+				if (!isSchemaObject(item)) {
+					itemMaps.push({});
+					return item;
+				}
+				const nested = coerceStrictSchema(item, item.required || []);
+				itemMaps.push(nested.nullWideningMap ?? {});
+				hasUntrackableAnyOfWidening ||= nested.hasUntrackableAnyOfWidening;
+				return nested.schema;
+			});
+			if (itemMaps.some((map) => Object.keys(map).length > 0)) nullWideningMap.items = itemMaps;
+		} else {
+			const nested = coerceStrictSchema(result.items, result.items.required || []);
+			result.items = nested.schema;
+			if (nested.nullWideningMap) nullWideningMap.items = nested.nullWideningMap;
+			hasUntrackableAnyOfWidening ||= nested.hasUntrackableAnyOfWidening;
+		}
 	}
 	if (result.anyOf && Array.isArray(result.anyOf)) {
 		const variants = result.anyOf.map((variant) => coerceStrictSchema(variant, variant.required || []));

package/dist/esm/utils/schema-converter.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema-converter.js","names":[],"sources":["../../../src/utils/schema-converter.ts"],"sourcesContent":["import type { NullWideningMap } from '@tanstack/ai-utils'\n\n/**\n * String `format` values accepted by OpenAI's strict Structured Outputs subset.\n * Any other format (e.g. \"uri\", \"uri-reference\", \"regex\") causes the API to\n * reject the whole request with `400 ... '<format>' is not a valid format`.\n * MCP servers and hand-written tools routinely declare such formats, so we strip\n * the unsupported ones before sending. See:\n * https://platform.openai.com/docs/guides/structured-outputs#supported-properties\n */\nconst SUPPORTED_STRING_FORMATS = new Set([\n  'date-time',\n  'time',\n  'date',\n  'duration',\n  'email',\n  'hostname',\n  'ipv4',\n  'ipv6',\n  'uuid',\n])\n\n/**\n * Recursively drop JSON-Schema `format` keywords whose value isn't in OpenAI's\n * strict-mode allowlist. Pure — returns a fresh tree and never mutates `node`,\n * so the caller's original tool definition is left intact.\n *\n * A property *named* `format` always has a schema (object/boolean) value, never\n * a bare string, so it is preserved and recursed into; only the `format`\n * *keyword* (whose value is a string) is subject to removal.\n */\nexport function stripUnsupportedFormats(node: any): any {\n  if (Array.isArray(node)) return node.map(stripUnsupportedFormats)\n  if (node === null || typeof node !== 'object') return node\n\n  const out: Record<string, any> = {}\n  for (const [key, value] of Object.entries(node)) {\n    if (\n      key === 'format' &&\n      typeof value === 'string' &&\n      !SUPPORTED_STRING_FORMATS.has(value)\n    ) {\n      continue\n    }\n    out[key] = stripUnsupportedFormats(value)\n  }\n  return out\n}\n\n/**\n * Transform a JSON schema to be compatible with OpenAI's structured output requirements.\n * OpenAI requires:\n * - All properties must be in the `required` array\n * - Optional fields should have null added to their type union\n * - additionalProperties must be false for objects\n * - String `format` keywords must be from a fixed allowlist (others are stripped)\n *\n * @param schema - JSON schema to transform\n * @param originalRequired - Original required array (to know which fields were optional)\n * @returns Transformed schema compatible with OpenAI structured output\n */\nexport function makeStructuredOutputCompatible(\n  schema: Record<string, any>,\n  originalRequired?: Array<string>,\n): Record<string, any> {\n  return makeStructuredOutputCompatibleWithMap(schema, originalRequired).schema\n}\n\nexport interface StructuredOutputCompatibility {\n  schema: Record<string, any>\n  nullWideningMap: NullWideningMap | undefined\n}\n\ninterface CoercedStrictSchema extends StructuredOutputCompatibility {\n  hasUntrackableAnyOfWidening: boolean\n}\n\n/**\n * Strict-schema conversion plus an exact map of the nullability introduced by\n * that conversion. Consumers can pass provider output through\n * `undoNullWidening` before validating it against the original schema.\n */\nexport function makeStructuredOutputCompatibleWithMap(\n  schema: Record<string, any>,\n  originalRequired?: Array<string>,\n): StructuredOutputCompatibility {\n  const { schema: strictSchema, nullWideningMap } = coerceStrictSchema(\n    schema,\n    originalRequired,\n  )\n  return {\n    schema: stripUnsupportedFormats(strictSchema),\n    nullWideningMap,\n  }\n}\n\n/**\n * JSON-Schema keywords outside OpenAI's strict Structured Outputs subset. A\n * schema using any of these can't be coerced into a strict-valid shape, and\n * sending it with `strict: true` makes the API reject the ENTIRE request\n * (e.g. `400 Invalid schema ... 'additionalProperties' is required to be ...`).\n * Tools with such schemas are emitted with `strict: false` instead (see the\n * tool converters) so they remain callable. MCP servers (e.g. Notion) routinely\n * emit these.\n *\n * - `oneOf` / `allOf` / `not` — combinator keywords strict mode rejects\n * - `$ref` / `$defs` / `definitions` — references and definition pools whose\n *   object subschemas escape the `additionalProperties: false` normalization\n *   strict mode requires\n */\nconst STRICT_UNSUPPORTED_KEYWORDS: ReadonlyArray<string> = [\n  'oneOf',\n  'allOf',\n  'not',\n  '$ref',\n  '$defs',\n  'definitions',\n]\n\n/**\n * Keys that give a schema node a resolvable type under OpenAI's strict subset.\n * A schema-position node carrying none of these is *typeless* (e.g. the empty\n * `{}` that `z.any()` / `z.unknown()` emit). Strict mode requires every schema\n * to declare a type, so a typeless node 400s the whole request — such tools\n * must be sent with `strict: false` instead. (`oneOf`/`allOf`/`$ref` count as\n * type indicators here even though they're independently strict-unsupported;\n * the keyword check below already rejects them.)\n */\nconst TYPE_INDICATOR_KEYWORDS: ReadonlyArray<string> = [\n  'type',\n  'enum',\n  'const',\n  'anyOf',\n  'oneOf',\n  'allOf',\n  '$ref',\n]\n\n/**\n * Returns `false` when `schema` cannot be made strict-compatible and must be\n * sent with `strict: false`. Two ways that happens:\n *\n * 1. It uses a JSON-Schema keyword outside OpenAI's strict subset anywhere in\n *    the tree (`oneOf`/`allOf`/`not`/`$ref`/`$defs`).\n * 2. It contains a *typeless* schema node — a property/items/anyOf entry with\n *    no `type` (nor `enum`/`const`/combinator), e.g. the `{}` that `z.any()`\n *    produces. Strict mode rejects typeless schemas.\n * 3. It contains an open object schema. OpenAI strict mode requires objects to\n *    set `additionalProperties: false`, which would change the semantics of a\n *    free-form map rather than merely normalizing it.\n * 4. An `anyOf` variant itself needs null widening. The inverse map is\n *    intentionally schema-blind, so it cannot select a variant without risking\n *    removal of a genuine nullable value accepted by another variant.\n *\n * Conservative by design: for (1) keywords are matched as object keys, so a\n * property literally named e.g. `oneOf` also trips it. That only costs that one\n * tool its strict mode, which is strictly safer than a false \"compatible\"\n * verdict that 400s the whole request.\n */\nexport function isStrictModeCompatible(schema: unknown): boolean {\n  return (\n    !containsStrictUnsupportedKeyword(schema) &&\n    !containsTypelessSchema(schema) &&\n    !containsOpenObject(schema) &&\n    !containsUntrackableAnyOfWidening(schema)\n  )\n}\n\n/**\n * Reports strict conversions whose synthesized nulls cannot be represented by\n * the schema-blind inverse map. Optional `anyOf` wrappers remain supported:\n * only widening introduced inside one of their variants triggers fallback.\n */\nfunction containsUntrackableAnyOfWidening(schema: unknown): boolean {\n  if (schema === null || typeof schema !== 'object' || Array.isArray(schema)) {\n    return false\n  }\n  return coerceStrictSchema(schema as Record<string, any>)\n    .hasUntrackableAnyOfWidening\n}\n\n/**\n * Reports object schemas that cannot be closed without changing their input\n * semantics. Objects with `properties` and no explicit\n * `additionalProperties` are safe because `coerceStrictSchema` closes them.\n */\nfunction containsOpenObject(node: unknown): boolean {\n  if (Array.isArray(node)) {\n    return node.some(containsOpenObject)\n  }\n  if (node === null || typeof node !== 'object') return false\n\n  const schema = node as Record<string, unknown>\n  const type = schema['type']\n  const isObjectSchema =\n    type === 'object' || (Array.isArray(type) && type.includes('object'))\n\n  if (isObjectSchema) {\n    if (\n      'additionalProperties' in schema &&\n      schema['additionalProperties'] !== false\n    ) {\n      return true\n    }\n\n    const properties = schema['properties']\n    const hasProperties =\n      properties !== null &&\n      typeof properties === 'object' &&\n      !Array.isArray(properties)\n    if (!hasProperties && schema['additionalProperties'] !== false) {\n      return true\n    }\n  }\n\n  return Object.values(schema).some(containsOpenObject)\n}\n\nfunction containsStrictUnsupportedKeyword(node: unknown): boolean {\n  if (Array.isArray(node)) {\n    return node.some(containsStrictUnsupportedKeyword)\n  }\n  if (node === null || typeof node !== 'object') return false\n  for (const [key, value] of Object.entries(node)) {\n    if (STRICT_UNSUPPORTED_KEYWORDS.includes(key)) return true\n    if (containsStrictUnsupportedKeyword(value)) return true\n  }\n  return false\n}\n\n/** A schema-position node that declares no type and so 400s strict mode. */\nfunction isTypelessSchema(node: unknown): boolean {\n  if (node === null || typeof node !== 'object' || Array.isArray(node)) {\n    // JSON Schema permits bare boolean nodes; malformed inputs may contain\n    // other primitives. OpenAI's strict subset requires a declared type, so\n    // preserve the containing tool by sending it in non-strict mode.\n    return true\n  }\n  return !TYPE_INDICATOR_KEYWORDS.some((key) => key in node)\n}\n\n/**\n * Walks the genuine schema positions (property values, `items`, `anyOf`\n * variants) and reports whether any is typeless. Unlike the keyword walk this\n * must respect structure: an empty `{}` is only a problem at a schema position,\n * not e.g. an empty `properties` map.\n */\nfunction containsTypelessSchema(node: unknown): boolean {\n  if (node === null || typeof node !== 'object' || Array.isArray(node)) {\n    return false\n  }\n  const schema = node as Record<string, any>\n\n  const children: Array<unknown> = []\n  if (schema.properties && typeof schema.properties === 'object') {\n    children.push(...Object.values(schema.properties))\n  }\n  if (schema.items !== undefined) {\n    children.push(\n      ...(Array.isArray(schema.items) ? schema.items : [schema.items]),\n    )\n  }\n  if (Array.isArray(schema.anyOf)) {\n    children.push(...schema.anyOf)\n  }\n\n  return children.some(\n    (child) => isTypelessSchema(child) || containsTypelessSchema(child),\n  )\n}\n\n/**\n * Strict-mode structural rewrite (required widening, nullability,\n * additionalProperties). Kept private so the public entry point can apply the\n * format-stripping pass exactly once over the fully-rewritten tree.\n */\nfunction pruneMap(map: NullWideningMap): NullWideningMap | undefined {\n  return Object.keys(map).length > 0 ? map : undefined\n}\n\nfunction isSchemaObject(schema: unknown): schema is Record<string, any> {\n  return typeof schema === 'object' && schema !== null && !Array.isArray(schema)\n}\n\n/** Whether every active JSON Schema constraint at this node admits null. */\nfunction acceptsNull(schema: unknown): boolean {\n  if (schema === true) return true\n  if (!isSchemaObject(schema)) return false\n\n  if ('const' in schema && schema.const !== null) return false\n  if (Array.isArray(schema.enum) && !schema.enum.includes(null)) return false\n\n  if (typeof schema.type === 'string' && schema.type !== 'null') return false\n  if (Array.isArray(schema.type) && !schema.type.includes('null')) return false\n\n  if (\n    Array.isArray(schema.anyOf) &&\n    !schema.anyOf.some((variant: unknown) => acceptsNull(variant))\n  ) {\n    return false\n  }\n\n  return true\n}\n\nfunction coerceStrictSchema(\n  schema: Record<string, any>,\n  originalRequired?: Array<string>,\n): CoercedStrictSchema {\n  const result = { ...schema }\n  const nullWideningMap: NullWideningMap = {}\n  let hasUntrackableAnyOfWidening = false\n  const required =\n    originalRequired ??\n    (Array.isArray(result['required']) ? result['required'] : [])\n\n  if (result.type === 'object' && result.properties) {\n    const properties = { ...result.properties }\n    const allPropertyNames = Object.keys(properties)\n    const propertyMaps: Record<string, NullWideningMap> = {}\n\n    for (const propName of allPropertyNames) {\n      let prop = properties[propName]\n      const wasOptional = !required.includes(propName)\n      let childMap: NullWideningMap | undefined\n      let widenedHere = false\n\n      // Step 1: Recurse into nested structures\n      if (isSchemaObject(prop) && prop.type === 'object' && prop.properties) {\n        const nested = coerceStrictSchema(prop, prop.required || [])\n        prop = nested.schema\n        childMap = nested.nullWideningMap\n        hasUntrackableAnyOfWidening ||= nested.hasUntrackableAnyOfWidening\n      } else if (isSchemaObject(prop) && prop.type === 'array' && prop.items) {\n        const nested = coerceStrictSchema(prop.items, prop.items.required || [])\n        prop = {\n          ...prop,\n          items: nested.schema,\n        }\n        childMap = nested.nullWideningMap\n          ? { items: nested.nullWideningMap }\n          : undefined\n        hasUntrackableAnyOfWidening ||= nested.hasUntrackableAnyOfWidening\n      } else if (isSchemaObject(prop) && prop.anyOf) {\n        const nested = coerceStrictSchema(prop, prop.required || [])\n        prop = nested.schema\n        childMap = nested.nullWideningMap\n        hasUntrackableAnyOfWidening ||= nested.hasUntrackableAnyOfWidening\n      } else if (isSchemaObject(prop) && prop.oneOf) {\n        throw new Error(\n          'oneOf is not supported in OpenAI structured output schemas. Check the supported outputs here: https://platform.openai.com/docs/guides/structured-outputs#supported-types',\n        )\n      }\n\n      // Step 2: Apply null-widening for optional properties (after recursion)\n      if (wasOptional) {\n        const originallyAcceptedNull = acceptsNull(prop)\n\n        // `type: [..., 'null']` alone does not make null valid when an enum or\n        // const still excludes it; strict decoding would be forced to emit the\n        // original literal instead of the synthetic omission marker.\n        if (isSchemaObject(prop) && 'const' in prop && prop.const !== null) {\n          const { const: constValue, ...withoutConst } = prop\n          prop = { ...withoutConst, enum: [constValue, null] }\n        } else if (\n          isSchemaObject(prop) &&\n          Array.isArray(prop.enum) &&\n          !prop.enum.includes(null)\n        ) {\n          prop = { ...prop, enum: [...prop.enum, null] }\n        }\n\n        if (isSchemaObject(prop) && prop.anyOf) {\n          // A genuine null branch can use type, enum, or const. Only add a\n          // provider omission marker when the original union rejected null.\n          if (!acceptsNull(prop)) {\n            prop = { ...prop, anyOf: [...prop.anyOf, { type: 'null' }] }\n          }\n        } else if (\n          isSchemaObject(prop) &&\n          prop.type &&\n          !Array.isArray(prop.type)\n        ) {\n          prop = { ...prop, type: [prop.type, 'null'] }\n        } else if (\n          isSchemaObject(prop) &&\n          Array.isArray(prop.type) &&\n          !prop.type.includes('null')\n        ) {\n          prop = { ...prop, type: [...prop.type, 'null'] }\n        }\n\n        widenedHere = !originallyAcceptedNull && acceptsNull(prop)\n      }\n\n      properties[propName] = prop\n      if (childMap || widenedHere) {\n        propertyMaps[propName] = {\n          ...(childMap ?? {}),\n          ...(widenedHere ? { widened: true } : {}),\n        }\n      }\n    }\n\n    result.properties = properties\n    result.required = allPropertyNames\n    result.additionalProperties = false\n    if (Object.keys(propertyMaps).length > 0) {\n      nullWideningMap.properties = propertyMaps\n    }\n  }\n\n  if (result.type === 'array' && result.items) {\n    const nested = coerceStrictSchema(result.items, result.items.required || [])\n    result.items = nested.schema\n    if (nested.nullWideningMap) {\n      nullWideningMap.items = nested.nullWideningMap\n    }\n    hasUntrackableAnyOfWidening ||= nested.hasUntrackableAnyOfWidening\n  }\n\n  if (result.anyOf && Array.isArray(result.anyOf)) {\n    const variants = result.anyOf.map((variant) =>\n      coerceStrictSchema(variant, variant.required || []),\n    )\n    result.anyOf = variants.map((variant) => variant.schema)\n    hasUntrackableAnyOfWidening ||= variants.some(\n      (variant) =>\n        variant.nullWideningMap !== undefined ||\n        variant.hasUntrackableAnyOfWidening,\n    )\n  }\n\n  if (result.oneOf) {\n    throw new Error(\n      'oneOf is not supported in OpenAI structured output schemas. Check the supported outputs here: https://platform.openai.com/docs/guides/structured-outputs#supported-types',\n    )\n  }\n\n  return {\n    schema: result,\n    nullWideningMap: pruneMap(nullWideningMap),\n    hasUntrackableAnyOfWidening,\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"schema-converter.js","names":[],"sources":["../../../src/utils/schema-converter.ts"],"sourcesContent":["import type { NullWideningMap } from '@tanstack/ai-utils'\n\n/**\n * String `format` values accepted by OpenAI's strict Structured Outputs subset.\n * Any other format (e.g. \"uri\", \"uri-reference\", \"regex\") causes the API to\n * reject the whole request with `400 ... '<format>' is not a valid format`.\n * MCP servers and hand-written tools routinely declare such formats, so we strip\n * the unsupported ones before sending. See:\n * https://platform.openai.com/docs/guides/structured-outputs#supported-properties\n */\nconst SUPPORTED_STRING_FORMATS = new Set([\n  'date-time',\n  'time',\n  'date',\n  'duration',\n  'email',\n  'hostname',\n  'ipv4',\n  'ipv6',\n  'uuid',\n])\n\n/**\n * Recursively drop JSON-Schema `format` keywords whose value isn't in OpenAI's\n * strict-mode allowlist. Pure — returns a fresh tree and never mutates `node`,\n * so the caller's original tool definition is left intact.\n *\n * A property *named* `format` always has a schema (object/boolean) value, never\n * a bare string, so it is preserved and recursed into; only the `format`\n * *keyword* (whose value is a string) is subject to removal.\n */\nexport function stripUnsupportedFormats(node: any): any {\n  if (Array.isArray(node)) return node.map(stripUnsupportedFormats)\n  if (node === null || typeof node !== 'object') return node\n\n  const out: Record<string, any> = {}\n  for (const [key, value] of Object.entries(node)) {\n    if (\n      key === 'format' &&\n      typeof value === 'string' &&\n      !SUPPORTED_STRING_FORMATS.has(value)\n    ) {\n      continue\n    }\n    out[key] = stripUnsupportedFormats(value)\n  }\n  return out\n}\n\n/**\n * Transform a JSON schema to be compatible with OpenAI's structured output requirements.\n * OpenAI requires:\n * - All properties must be in the `required` array\n * - Optional fields should have null added to their type union\n * - additionalProperties must be false for objects\n * - String `format` keywords must be from a fixed allowlist (others are stripped)\n *\n * @param schema - JSON schema to transform\n * @param originalRequired - Original required array (to know which fields were optional)\n * @returns Transformed schema compatible with OpenAI structured output\n */\nexport function makeStructuredOutputCompatible(\n  schema: Record<string, any>,\n  originalRequired?: Array<string>,\n): Record<string, any> {\n  return makeStructuredOutputCompatibleWithMap(schema, originalRequired).schema\n}\n\nexport interface StructuredOutputCompatibility {\n  schema: Record<string, any>\n  nullWideningMap: NullWideningMap | undefined\n}\n\ninterface CoercedStrictSchema extends StructuredOutputCompatibility {\n  hasUntrackableAnyOfWidening: boolean\n}\n\n/**\n * Strict-schema conversion plus an exact map of the nullability introduced by\n * that conversion. Consumers can pass provider output through\n * `undoNullWidening` before validating it against the original schema.\n */\nexport function makeStructuredOutputCompatibleWithMap(\n  schema: Record<string, any>,\n  originalRequired?: Array<string>,\n): StructuredOutputCompatibility {\n  const { schema: strictSchema, nullWideningMap } = coerceStrictSchema(\n    schema,\n    originalRequired,\n  )\n  return {\n    schema: stripUnsupportedFormats(strictSchema),\n    nullWideningMap,\n  }\n}\n\n/**\n * JSON-Schema keywords outside OpenAI's strict Structured Outputs subset. A\n * schema using any of these can't be coerced into a strict-valid shape, and\n * sending it with `strict: true` makes the API reject the ENTIRE request\n * (e.g. `400 Invalid schema ... 'additionalProperties' is required to be ...`).\n * Tools with such schemas are emitted with `strict: false` instead (see the\n * tool converters) so they remain callable. MCP servers (e.g. Notion) routinely\n * emit these.\n *\n * - `oneOf` / `allOf` / `not` — combinator keywords strict mode rejects\n * - `prefixItems` — 2020-12 tuple keyword. openai-node's strict transform\n *   rejects it, so we send those tools with `strict: false` instead\n * - `$ref` / `$defs` / `definitions` — references and definition pools whose\n *   object subschemas escape the `additionalProperties: false` normalization\n *   strict mode requires\n */\nconst STRICT_UNSUPPORTED_KEYWORDS: ReadonlyArray<string> = [\n  'oneOf',\n  'allOf',\n  'not',\n  'prefixItems',\n  '$ref',\n  '$defs',\n  'definitions',\n]\n\n/**\n * Keys that give a schema node a resolvable type under OpenAI's strict subset.\n * A schema-position node carrying none of these is *typeless* (e.g. the empty\n * `{}` that `z.any()` / `z.unknown()` emit). Strict mode requires every schema\n * to declare a type, so a typeless node 400s the whole request — such tools\n * must be sent with `strict: false` instead. (`oneOf`/`allOf`/`$ref` count as\n * type indicators here even though they're independently strict-unsupported;\n * the keyword check below already rejects them.)\n */\nconst TYPE_INDICATOR_KEYWORDS: ReadonlyArray<string> = [\n  'type',\n  'enum',\n  'const',\n  'anyOf',\n  'oneOf',\n  'allOf',\n  '$ref',\n]\n\n/**\n * Returns `false` when `schema` cannot be made strict-compatible and must be\n * sent with `strict: false`. Two ways that happens:\n *\n * 1. It uses a JSON-Schema keyword outside OpenAI's strict subset anywhere in\n *    the tree (`oneOf`/`allOf`/`not`/`prefixItems`/`$ref`/`$defs`).\n * 2. It contains a *typeless* schema node — a property/items/anyOf entry with\n *    no `type` (nor `enum`/`const`/combinator), e.g. the `{}` that `z.any()`\n *    produces. Strict mode rejects typeless schemas.\n * 3. It contains an open object schema. OpenAI strict mode requires objects to\n *    set `additionalProperties: false`, which would change the semantics of a\n *    free-form map rather than merely normalizing it.\n * 4. An `anyOf` variant itself needs null widening. The inverse map is\n *    intentionally schema-blind, so it cannot select a variant without risking\n *    removal of a genuine nullable value accepted by another variant.\n *\n * Conservative by design: for (1) keywords are matched as object keys, so a\n * property literally named e.g. `oneOf` also trips it. That only costs that one\n * tool its strict mode, which is strictly safer than a false \"compatible\"\n * verdict that 400s the whole request.\n */\nexport function isStrictModeCompatible(schema: unknown): boolean {\n  return (\n    !containsStrictUnsupportedKeyword(schema) &&\n    !containsTypelessSchema(schema) &&\n    !containsOpenObject(schema) &&\n    !containsUntrackableAnyOfWidening(schema)\n  )\n}\n\n/**\n * Reports strict conversions whose synthesized nulls cannot be represented by\n * the schema-blind inverse map. Optional `anyOf` wrappers remain supported:\n * only widening introduced inside one of their variants triggers fallback.\n */\nfunction containsUntrackableAnyOfWidening(schema: unknown): boolean {\n  if (schema === null || typeof schema !== 'object' || Array.isArray(schema)) {\n    return false\n  }\n  return coerceStrictSchema(schema as Record<string, any>)\n    .hasUntrackableAnyOfWidening\n}\n\n/**\n * Reports object schemas that cannot be closed without changing their input\n * semantics. Objects with `properties` and no explicit\n * `additionalProperties` are safe because `coerceStrictSchema` closes them.\n */\nfunction containsOpenObject(node: unknown): boolean {\n  if (Array.isArray(node)) {\n    return node.some(containsOpenObject)\n  }\n  if (node === null || typeof node !== 'object') return false\n\n  const schema = node as Record<string, unknown>\n  const type = schema['type']\n  const isObjectSchema =\n    type === 'object' || (Array.isArray(type) && type.includes('object'))\n\n  if (isObjectSchema) {\n    if (\n      'additionalProperties' in schema &&\n      schema['additionalProperties'] !== false\n    ) {\n      return true\n    }\n\n    const properties = schema['properties']\n    const hasProperties =\n      properties !== null &&\n      typeof properties === 'object' &&\n      !Array.isArray(properties)\n    if (!hasProperties && schema['additionalProperties'] !== false) {\n      return true\n    }\n  }\n\n  return Object.values(schema).some(containsOpenObject)\n}\n\nfunction containsStrictUnsupportedKeyword(node: unknown): boolean {\n  if (Array.isArray(node)) {\n    return node.some(containsStrictUnsupportedKeyword)\n  }\n  if (node === null || typeof node !== 'object') return false\n  for (const [key, value] of Object.entries(node)) {\n    if (STRICT_UNSUPPORTED_KEYWORDS.includes(key)) return true\n    if (containsStrictUnsupportedKeyword(value)) return true\n  }\n  return false\n}\n\n/** A schema-position node that declares no type and so 400s strict mode. */\nfunction isTypelessSchema(node: unknown): boolean {\n  if (node === null || typeof node !== 'object' || Array.isArray(node)) {\n    // JSON Schema permits bare boolean nodes; malformed inputs may contain\n    // other primitives. OpenAI's strict subset requires a declared type, so\n    // preserve the containing tool by sending it in non-strict mode.\n    return true\n  }\n  return !TYPE_INDICATOR_KEYWORDS.some((key) => key in node)\n}\n\n/**\n * Walks the genuine schema positions (property values, `items`, `anyOf`\n * variants) and reports whether any is typeless. Unlike the keyword walk this\n * must respect structure: an empty `{}` is only a problem at a schema position,\n * not e.g. an empty `properties` map.\n */\nfunction containsTypelessSchema(node: unknown): boolean {\n  if (node === null || typeof node !== 'object' || Array.isArray(node)) {\n    return false\n  }\n  const schema = node as Record<string, any>\n\n  const children: Array<unknown> = []\n  if (schema.properties && typeof schema.properties === 'object') {\n    children.push(...Object.values(schema.properties))\n  }\n  if (schema.items !== undefined) {\n    children.push(\n      ...(Array.isArray(schema.items) ? schema.items : [schema.items]),\n    )\n  }\n  if (Array.isArray(schema.anyOf)) {\n    children.push(...schema.anyOf)\n  }\n\n  return children.some(\n    (child) => isTypelessSchema(child) || containsTypelessSchema(child),\n  )\n}\n\n/**\n * Strict-mode structural rewrite (required widening, nullability,\n * additionalProperties). Kept private so the public entry point can apply the\n * format-stripping pass exactly once over the fully-rewritten tree.\n */\nfunction pruneMap(map: NullWideningMap): NullWideningMap | undefined {\n  return Object.keys(map).length > 0 ? map : undefined\n}\n\nfunction isSchemaObject(schema: unknown): schema is Record<string, any> {\n  return typeof schema === 'object' && schema !== null && !Array.isArray(schema)\n}\n\n/** Whether every active JSON Schema constraint at this node admits null. */\nfunction acceptsNull(schema: unknown): boolean {\n  if (schema === true) return true\n  if (!isSchemaObject(schema)) return false\n\n  if ('const' in schema && schema.const !== null) return false\n  if (Array.isArray(schema.enum) && !schema.enum.includes(null)) return false\n\n  if (typeof schema.type === 'string' && schema.type !== 'null') return false\n  if (Array.isArray(schema.type) && !schema.type.includes('null')) return false\n\n  if (\n    Array.isArray(schema.anyOf) &&\n    !schema.anyOf.some((variant: unknown) => acceptsNull(variant))\n  ) {\n    return false\n  }\n\n  return true\n}\n\nfunction coerceStrictSchema(\n  schema: Record<string, any>,\n  originalRequired?: Array<string>,\n): CoercedStrictSchema {\n  const result = { ...schema }\n  const nullWideningMap: NullWideningMap = {}\n  let hasUntrackableAnyOfWidening = false\n  const required =\n    originalRequired ??\n    (Array.isArray(result['required']) ? result['required'] : [])\n\n  if (result.type === 'object' && result.properties) {\n    const properties = { ...result.properties }\n    const allPropertyNames = Object.keys(properties)\n    const propertyMaps: Record<string, NullWideningMap> = {}\n\n    for (const propName of allPropertyNames) {\n      let prop = properties[propName]\n      const wasOptional = !required.includes(propName)\n      let childMap: NullWideningMap | undefined\n      let widenedHere = false\n\n      // Step 1: Recurse into nested structures\n      if (isSchemaObject(prop) && prop.type === 'object' && prop.properties) {\n        const nested = coerceStrictSchema(prop, prop.required || [])\n        prop = nested.schema\n        childMap = nested.nullWideningMap\n        hasUntrackableAnyOfWidening ||= nested.hasUntrackableAnyOfWidening\n      } else if (isSchemaObject(prop) && prop.type === 'array') {\n        const nested = coerceStrictSchema(prop, [])\n        prop = nested.schema\n        childMap = nested.nullWideningMap\n        hasUntrackableAnyOfWidening ||= nested.hasUntrackableAnyOfWidening\n      } else if (isSchemaObject(prop) && prop.anyOf) {\n        const nested = coerceStrictSchema(prop, prop.required || [])\n        prop = nested.schema\n        childMap = nested.nullWideningMap\n        hasUntrackableAnyOfWidening ||= nested.hasUntrackableAnyOfWidening\n      } else if (isSchemaObject(prop) && prop.oneOf) {\n        throw new Error(\n          'oneOf is not supported in OpenAI structured output schemas. Check the supported outputs here: https://platform.openai.com/docs/guides/structured-outputs#supported-types',\n        )\n      }\n\n      // Step 2: Apply null-widening for optional properties (after recursion)\n      if (wasOptional) {\n        const originallyAcceptedNull = acceptsNull(prop)\n\n        // `type: [..., 'null']` alone does not make null valid when an enum or\n        // const still excludes it; strict decoding would be forced to emit the\n        // original literal instead of the synthetic omission marker.\n        if (isSchemaObject(prop) && 'const' in prop && prop.const !== null) {\n          const { const: constValue, ...withoutConst } = prop\n          prop = { ...withoutConst, enum: [constValue, null] }\n        } else if (\n          isSchemaObject(prop) &&\n          Array.isArray(prop.enum) &&\n          !prop.enum.includes(null)\n        ) {\n          prop = { ...prop, enum: [...prop.enum, null] }\n        }\n\n        if (isSchemaObject(prop) && prop.anyOf) {\n          // A genuine null branch can use type, enum, or const. Only add a\n          // provider omission marker when the original union rejected null.\n          if (!acceptsNull(prop)) {\n            prop = { ...prop, anyOf: [...prop.anyOf, { type: 'null' }] }\n          }\n        } else if (\n          isSchemaObject(prop) &&\n          prop.type &&\n          !Array.isArray(prop.type)\n        ) {\n          prop = { ...prop, type: [prop.type, 'null'] }\n        } else if (\n          isSchemaObject(prop) &&\n          Array.isArray(prop.type) &&\n          !prop.type.includes('null')\n        ) {\n          prop = { ...prop, type: [...prop.type, 'null'] }\n        }\n\n        widenedHere = !originallyAcceptedNull && acceptsNull(prop)\n      }\n\n      properties[propName] = prop\n      if (childMap || widenedHere) {\n        propertyMaps[propName] = {\n          ...(childMap ?? {}),\n          ...(widenedHere ? { widened: true } : {}),\n        }\n      }\n    }\n\n    result.properties = properties\n    result.required = allPropertyNames\n    result.additionalProperties = false\n    if (Object.keys(propertyMaps).length > 0) {\n      nullWideningMap.properties = propertyMaps\n    }\n  }\n\n  if (result.type === 'array' && result.items) {\n    if (Array.isArray(result.items)) {\n      const itemMaps: Array<NullWideningMap> = []\n      result.items = result.items.map((item) => {\n        if (!isSchemaObject(item)) {\n          itemMaps.push({})\n          return item\n        }\n        const nested = coerceStrictSchema(item, item.required || [])\n        itemMaps.push(nested.nullWideningMap ?? {})\n        hasUntrackableAnyOfWidening ||= nested.hasUntrackableAnyOfWidening\n        return nested.schema\n      })\n      if (itemMaps.some((map) => Object.keys(map).length > 0)) {\n        nullWideningMap.items = itemMaps\n      }\n    } else {\n      const nested = coerceStrictSchema(\n        result.items,\n        result.items.required || [],\n      )\n      result.items = nested.schema\n      if (nested.nullWideningMap) {\n        nullWideningMap.items = nested.nullWideningMap\n      }\n      hasUntrackableAnyOfWidening ||= nested.hasUntrackableAnyOfWidening\n    }\n  }\n\n  if (result.anyOf && Array.isArray(result.anyOf)) {\n    const variants = result.anyOf.map((variant) =>\n      coerceStrictSchema(variant, variant.required || []),\n    )\n    result.anyOf = variants.map((variant) => variant.schema)\n    hasUntrackableAnyOfWidening ||= variants.some(\n      (variant) =>\n        variant.nullWideningMap !== undefined ||\n        variant.hasUntrackableAnyOfWidening,\n    )\n  }\n\n  if (result.oneOf) {\n    throw new Error(\n      'oneOf is not supported in OpenAI structured output schemas. Check the supported outputs here: https://platform.openai.com/docs/guides/structured-outputs#supported-types',\n    )\n  }\n\n  return {\n    schema: result,\n    nullWideningMap: pruneMap(nullWideningMap),\n    hasUntrackableAnyOfWidening,\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/openai-base",
-  "version": "0.10.6",
+  "version": "0.10.7",
   "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.4.0"
   },
   "peerDependencies": {
-    "@tanstack/ai": "^0.50.0"
+    "@tanstack/ai": "^0.51.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "4.1.10",
     "vite": "^8.2.1",
     "zod": "^4.2.0",
-    "@tanstack/ai": "0.50.0"
+    "@tanstack/ai": "0.51.0"
   },
   "scripts": {
     "build": "vite build",

package/src/adapters/chat-completions-tool-converter.test.ts

@@ -17,6 +17,27 @@ describe('chat-completions tool converter', () => {
     expect(out.function.strict).toBe(false)
     expect(out.function.parameters).toEqual(booleanSchemaTool.inputSchema)
   })
+
+  it('keeps draft-07 tuple items as an array in strict mode', () => {
+    const out = convertFunctionToolToChatCompletionsFormat(bboxTupleTool)
+
+    expect(out.function.strict).toBe(true)
+    expect(out.function.parameters).toMatchObject({
+      properties: {
+        bbox: {
+          type: 'array',
+          items: bboxItems,
+        },
+      },
+    })
+  })
+
+  it('falls back from strict mode when prefixItems is present', () => {
+    const out = convertFunctionToolToChatCompletionsFormat(prefixItemsTool)
+
+    expect(out.function.strict).toBe(false)
+    expect(out.function.parameters).toEqual(prefixItemsTool.inputSchema)
+  })
 })
 
 const booleanSchemaInput = {
@@ -32,6 +53,43 @@ const booleanSchemaTool = {
   inputSchema: booleanSchemaInput,
 } satisfies Tool
 
+const bboxItems = [
+  { type: 'number', minimum: -180 },
+  { type: 'number', minimum: -90 },
+  { type: 'number', maximum: 180 },
+  { type: 'number', maximum: 90 },
+]
+
+const bboxTupleTool: Tool = {
+  name: 'set_bbox',
+  description: 'Set a bounding box',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      bbox: {
+        type: 'array',
+        items: bboxItems,
+      },
+    },
+    required: ['bbox'],
+  },
+}
+
+const prefixItemsTool: Tool = {
+  name: 'set_pair',
+  description: 'Set a prefix-item pair',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      pair: {
+        type: 'array',
+        prefixItems: [{ type: 'string' }, { type: 'number' }],
+      },
+    },
+    required: ['pair'],
+  },
+}
+
 const anyOfOptionalVariantTool: Tool = {
   name: 'store_variant',
   description: 'Store a union variant',

package/src/tools/shell-tool.ts

@@ -20,6 +20,32 @@ export interface ShellToolFactoryConfig {
   environment?: NonNullable<ShellToolConfig['environment']>
 }
 
+/**
+ * Validate skill references carried by a shell `environment`. Previously the
+ * factory validated nothing, so a malformed `skill_id` surfaced as an unframed
+ * provider 400. Only `skill_reference` entries carry a `skill_id`; inline and
+ * local skills are shaped differently and left untouched.
+ *
+ * ponytail: OpenAI documents no client-checkable count cap for shell skills
+ * (unlike Anthropic's 8), so we validate `skill_id` format only and do not
+ * fabricate a `SkillLimitError` count limit. Add one here if OpenAI publishes a cap.
+ */
+function validateShellEnvironment(
+  environment: ShellToolFactoryConfig['environment'],
+): void {
+  const skills =
+    environment && 'skills' in environment ? environment.skills : undefined
+  if (!skills) return
+  for (const skill of skills) {
+    if ('skill_id' in skill) {
+      const id = skill.skill_id
+      if (id.length < 1 || id.length > 64) {
+        throw new Error('skill_id must be between 1 and 64 characters.')
+      }
+    }
+  }
+}
+
 /**
  * Converts a standard Tool to OpenAI ShellTool format, preserving any
  * `environment` (container config + skills) stored in metadata.
@@ -42,6 +68,7 @@ export function convertShellToolToAdapterFormat(tool: Tool): ShellToolConfig {
  * re-wrap this in their own package.
  */
 export function shellTool(config: ShellToolFactoryConfig = {}): Tool {
+  validateShellEnvironment(config.environment)
   return openAIProviderTool(
     {
       name: 'shell',

package/src/utils/schema-converter.ts

@@ -104,6 +104,8 @@ export function makeStructuredOutputCompatibleWithMap(
  * emit these.
  *
  * - `oneOf` / `allOf` / `not` — combinator keywords strict mode rejects
+ * - `prefixItems` — 2020-12 tuple keyword. openai-node's strict transform
+ *   rejects it, so we send those tools with `strict: false` instead
  * - `$ref` / `$defs` / `definitions` — references and definition pools whose
  *   object subschemas escape the `additionalProperties: false` normalization
  *   strict mode requires
@@ -112,6 +114,7 @@ const STRICT_UNSUPPORTED_KEYWORDS: ReadonlyArray<string> = [
   'oneOf',
   'allOf',
   'not',
+  'prefixItems',
   '$ref',
   '$defs',
   'definitions',
@@ -141,7 +144,7 @@ const TYPE_INDICATOR_KEYWORDS: ReadonlyArray<string> = [
  * sent with `strict: false`. Two ways that happens:
  *
  * 1. It uses a JSON-Schema keyword outside OpenAI's strict subset anywhere in
- *    the tree (`oneOf`/`allOf`/`not`/`$ref`/`$defs`).
+ *    the tree (`oneOf`/`allOf`/`not`/`prefixItems`/`$ref`/`$defs`).
  * 2. It contains a *typeless* schema node — a property/items/anyOf entry with
  *    no `type` (nor `enum`/`const`/combinator), e.g. the `{}` that `z.any()`
  *    produces. Strict mode rejects typeless schemas.
@@ -331,15 +334,10 @@ function coerceStrictSchema(
         prop = nested.schema
         childMap = nested.nullWideningMap
         hasUntrackableAnyOfWidening ||= nested.hasUntrackableAnyOfWidening
-      } else if (isSchemaObject(prop) && prop.type === 'array' && prop.items) {
-        const nested = coerceStrictSchema(prop.items, prop.items.required || [])
-        prop = {
-          ...prop,
-          items: nested.schema,
-        }
+      } else if (isSchemaObject(prop) && prop.type === 'array') {
+        const nested = coerceStrictSchema(prop, [])
+        prop = nested.schema
         childMap = nested.nullWideningMap
-          ? { items: nested.nullWideningMap }
-          : undefined
         hasUntrackableAnyOfWidening ||= nested.hasUntrackableAnyOfWidening
       } else if (isSchemaObject(prop) && prop.anyOf) {
         const nested = coerceStrictSchema(prop, prop.required || [])
@@ -411,12 +409,32 @@ function coerceStrictSchema(
   }
 
   if (result.type === 'array' && result.items) {
-    const nested = coerceStrictSchema(result.items, result.items.required || [])
-    result.items = nested.schema
-    if (nested.nullWideningMap) {
-      nullWideningMap.items = nested.nullWideningMap
+    if (Array.isArray(result.items)) {
+      const itemMaps: Array<NullWideningMap> = []
+      result.items = result.items.map((item) => {
+        if (!isSchemaObject(item)) {
+          itemMaps.push({})
+          return item
+        }
+        const nested = coerceStrictSchema(item, item.required || [])
+        itemMaps.push(nested.nullWideningMap ?? {})
+        hasUntrackableAnyOfWidening ||= nested.hasUntrackableAnyOfWidening
+        return nested.schema
+      })
+      if (itemMaps.some((map) => Object.keys(map).length > 0)) {
+        nullWideningMap.items = itemMaps
+      }
+    } else {
+      const nested = coerceStrictSchema(
+        result.items,
+        result.items.required || [],
+      )
+      result.items = nested.schema
+      if (nested.nullWideningMap) {
+        nullWideningMap.items = nested.nullWideningMap
+      }
+      hasUntrackableAnyOfWidening ||= nested.hasUntrackableAnyOfWidening
     }
-    hasUntrackableAnyOfWidening ||= nested.hasUntrackableAnyOfWidening
   }
 
   if (result.anyOf && Array.isArray(result.anyOf)) {