@openai/agents-core 0.1.11 → 0.2.1

package/dist/utils/smartString.js

@@ -1,16 +1,24 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.toSmartString = toSmartString;
+const BYTE_PREVIEW_LIMIT = 20;
 function toSmartString(value) {
     if (value === null || value === undefined) {
         return String(value);
     }
-    else if (typeof value === 'string') {
+    if (isArrayBufferLike(value)) {
+        return formatByteArray(new Uint8Array(value));
+    }
+    if (isArrayBufferView(value)) {
+        const view = value;
+        return formatByteArray(new Uint8Array(view.buffer, view.byteOffset, view.byteLength));
+    }
+    if (typeof value === 'string') {
         return value;
     }
-    else if (typeof value === 'object') {
+    if (typeof value === 'object') {
         try {
-            return JSON.stringify(value);
+            return JSON.stringify(value, smartStringReplacer);
         }
         catch (_e) {
             return '[object with circular references]';
@@ -18,4 +26,49 @@ function toSmartString(value) {
     }
     return String(value);
 }
+function isArrayBufferLike(value) {
+    if (value instanceof ArrayBuffer) {
+        return true;
+    }
+    const sharedArrayBufferCtor = globalThis.SharedArrayBuffer;
+    return Boolean(sharedArrayBufferCtor && value instanceof sharedArrayBufferCtor);
+}
+function isArrayBufferView(value) {
+    return typeof ArrayBuffer !== 'undefined' && ArrayBuffer.isView(value);
+}
+function isSerializedBufferSnapshot(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        value.type === 'Buffer' &&
+        Array.isArray(value.data));
+}
+function formatByteArray(bytes) {
+    if (bytes.length === 0) {
+        return '[byte array (0 bytes)]';
+    }
+    const previewLength = Math.min(bytes.length, BYTE_PREVIEW_LIMIT);
+    const previewParts = [];
+    for (let i = 0; i < previewLength; i++) {
+        previewParts.push(formatByte(bytes[i]));
+    }
+    const ellipsis = bytes.length > BYTE_PREVIEW_LIMIT ? ' …' : '';
+    const preview = previewParts.join(' ');
+    return `[byte array ${preview}${ellipsis} (${bytes.length} bytes)]`;
+}
+function formatByte(byte) {
+    return `0x${byte.toString(16).padStart(2, '0')}`;
+}
+function smartStringReplacer(_key, nestedValue) {
+    if (isArrayBufferLike(nestedValue)) {
+        return formatByteArray(new Uint8Array(nestedValue));
+    }
+    if (isArrayBufferView(nestedValue)) {
+        const view = nestedValue;
+        return formatByteArray(new Uint8Array(view.buffer, view.byteOffset, view.byteLength));
+    }
+    if (isSerializedBufferSnapshot(nestedValue)) {
+        return formatByteArray(Uint8Array.from(nestedValue.data));
+    }
+    return nestedValue;
+}
 //# sourceMappingURL=smartString.js.map

package/dist/utils/smartString.js.map

@@ -1 +1 @@
-{"version":3,"file":"smartString.js","sourceRoot":"","sources":["../../src/utils/smartString.ts"],"names":[],"mappings":";;AAAA,sCAaC;AAbD,SAAgB,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC;IACf,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,EAAE,EAAE,CAAC;YACZ,OAAO,mCAAmC,CAAC;QAC7C,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}
+{"version":3,"file":"smartString.js","sourceRoot":"","sources":["../../src/utils/smartString.ts"],"names":[],"mappings":"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"}

package/dist/utils/smartString.mjs

@@ -1,13 +1,21 @@
+const BYTE_PREVIEW_LIMIT = 20;
 export function toSmartString(value) {
     if (value === null || value === undefined) {
         return String(value);
     }
-    else if (typeof value === 'string') {
+    if (isArrayBufferLike(value)) {
+        return formatByteArray(new Uint8Array(value));
+    }
+    if (isArrayBufferView(value)) {
+        const view = value;
+        return formatByteArray(new Uint8Array(view.buffer, view.byteOffset, view.byteLength));
+    }
+    if (typeof value === 'string') {
         return value;
     }
-    else if (typeof value === 'object') {
+    if (typeof value === 'object') {
         try {
-            return JSON.stringify(value);
+            return JSON.stringify(value, smartStringReplacer);
         }
         catch (_e) {
             return '[object with circular references]';
@@ -15,4 +23,49 @@ export function toSmartString(value) {
     }
     return String(value);
 }
+function isArrayBufferLike(value) {
+    if (value instanceof ArrayBuffer) {
+        return true;
+    }
+    const sharedArrayBufferCtor = globalThis.SharedArrayBuffer;
+    return Boolean(sharedArrayBufferCtor && value instanceof sharedArrayBufferCtor);
+}
+function isArrayBufferView(value) {
+    return typeof ArrayBuffer !== 'undefined' && ArrayBuffer.isView(value);
+}
+function isSerializedBufferSnapshot(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        value.type === 'Buffer' &&
+        Array.isArray(value.data));
+}
+function formatByteArray(bytes) {
+    if (bytes.length === 0) {
+        return '[byte array (0 bytes)]';
+    }
+    const previewLength = Math.min(bytes.length, BYTE_PREVIEW_LIMIT);
+    const previewParts = [];
+    for (let i = 0; i < previewLength; i++) {
+        previewParts.push(formatByte(bytes[i]));
+    }
+    const ellipsis = bytes.length > BYTE_PREVIEW_LIMIT ? ' …' : '';
+    const preview = previewParts.join(' ');
+    return `[byte array ${preview}${ellipsis} (${bytes.length} bytes)]`;
+}
+function formatByte(byte) {
+    return `0x${byte.toString(16).padStart(2, '0')}`;
+}
+function smartStringReplacer(_key, nestedValue) {
+    if (isArrayBufferLike(nestedValue)) {
+        return formatByteArray(new Uint8Array(nestedValue));
+    }
+    if (isArrayBufferView(nestedValue)) {
+        const view = nestedValue;
+        return formatByteArray(new Uint8Array(view.buffer, view.byteOffset, view.byteLength));
+    }
+    if (isSerializedBufferSnapshot(nestedValue)) {
+        return formatByteArray(Uint8Array.from(nestedValue.data));
+    }
+    return nestedValue;
+}
 //# sourceMappingURL=smartString.mjs.map

package/dist/utils/smartString.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"smartString.mjs","sourceRoot":"","sources":["../../src/utils/smartString.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC;IACf,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,EAAE,EAAE,CAAC;YACZ,OAAO,mCAAmC,CAAC;QAC7C,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}
+{"version":3,"file":"smartString.mjs","sourceRoot":"","sources":["../../src/utils/smartString.ts"],"names":[],"mappings":"AAAA,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAE9B,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,eAAe,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,KAAwB,CAAC;QACtC,OAAO,eAAe,CACpB,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAC9D,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,EAAE,EAAE,CAAC;YACZ,OAAO,mCAAmC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,qBAAqB,GACzB,UAGD,CAAC,iBAAiB,CAAC;IAEpB,OAAO,OAAO,CACZ,qBAAqB,IAAI,KAAK,YAAY,qBAAqB,CAChE,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,OAAO,OAAO,WAAW,KAAK,WAAW,IAAI,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzE,CAAC;AAED,SAAS,0BAA0B,CACjC,KAAc;IAEd,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAA4B,CAAC,IAAI,KAAK,QAAQ;QAC/C,KAAK,CAAC,OAAO,CAAE,KAA4B,CAAC,IAAI,CAAC,CAClD,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAAiB;IACxC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,wBAAwB,CAAC;IAClC,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACjE,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,GAAG,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEvC,OAAO,eAAe,OAAO,GAAG,QAAQ,KAAK,KAAK,CAAC,MAAM,UAAU,CAAC;AACtE,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,KAAK,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACnD,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY,EAAE,WAAoB;IAC7D,IAAI,iBAAiB,CAAC,WAAW,CAAC,EAAE,CAAC;QACnC,OAAO,eAAe,CAAC,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,iBAAiB,CAAC,WAAW,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,WAA8B,CAAC;QAC5C,OAAO,eAAe,CACpB,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAC9D,CAAC;IACJ,CAAC;IAED,IAAI,0BAA0B,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5C,OAAO,eAAe,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/utils/tools.js

@@ -6,6 +6,17 @@ exports.convertAgentOutputTypeToSerializable = convertAgentOutputTypeToSerializa
 const zod_1 = require("openai/helpers/zod");
 const errors_1 = require("../errors.js");
 const typeGuards_1 = require("./typeGuards.js");
+const zodJsonSchemaCompat_1 = require("./zodJsonSchemaCompat.js");
+const zodCompat_1 = require("./zodCompat.js");
+const zodResponsesFunctionCompat = zod_1.zodResponsesFunction;
+// The `.schema` payload is all we need, so a lightweight signature keeps the compiler happy.
+const zodTextFormatCompat = zod_1.zodTextFormat;
+// openai/helpers/zod cannot emit strict schemas for every Zod runtime
+// (notably Zod v4), so we delegate to a small local converter living in
+// zodJsonSchemaCompat.ts whenever its output is missing the required JSON Schema bits.
+function buildJsonSchemaFromZod(inputType) {
+    return (0, zodJsonSchemaCompat_1.zodJsonSchemaCompat)(inputType);
+}
 /**
  * Convert a string to a function tool name by replacing spaces with underscores and
  * non-alphanumeric characters with underscores.
@@ -34,16 +45,38 @@ function toFunctionToolName(name) {
 function getSchemaAndParserFromInputType(inputType, name) {
     const parser = (input) => JSON.parse(input);
     if ((0, typeGuards_1.isZodObject)(inputType)) {
-        const formattedFunction = (0, zod_1.zodResponsesFunction)({
-            name,
-            parameters: inputType,
-            function: () => { }, // empty function here to satisfy the OpenAI helper
-            description: '',
-        });
-        return {
-            schema: formattedFunction.parameters,
-            parser: formattedFunction.$parseRaw,
+        const useFallback = (originalError) => {
+            const fallbackSchema = buildJsonSchemaFromZod(inputType);
+            if (fallbackSchema) {
+                return {
+                    schema: fallbackSchema,
+                    parser: (rawInput) => inputType.parse(JSON.parse(rawInput)),
+                };
+            }
+            const errorMessage = originalError instanceof Error
+                ? ` Upstream helper error: ${originalError.message}`
+                : '';
+            throw new errors_1.UserError(`Unable to convert the provided Zod schema to JSON Schema. Ensure that the \`zod\` package is available at runtime or provide a JSON schema object instead.${errorMessage}`);
         };
+        let formattedFunction;
+        try {
+            formattedFunction = zodResponsesFunctionCompat({
+                name,
+                parameters: (0, zodCompat_1.asZodType)(inputType),
+                function: () => { }, // empty function here to satisfy the OpenAI helper
+                description: '',
+            });
+        }
+        catch (error) {
+            return useFallback(error);
+        }
+        if ((0, zodJsonSchemaCompat_1.hasJsonSchemaObjectShape)(formattedFunction.parameters)) {
+            return {
+                schema: formattedFunction.parameters,
+                parser: formattedFunction.$parseRaw,
+            };
+        }
+        return useFallback();
     }
     else if (typeof inputType === 'object' && inputType !== null) {
         return {
@@ -61,13 +94,37 @@ function convertAgentOutputTypeToSerializable(outputType) {
         return 'text';
     }
     if ((0, typeGuards_1.isZodObject)(outputType)) {
-        const output = (0, zod_1.zodTextFormat)(outputType, 'output');
-        return {
-            type: output.type,
-            name: output.name,
-            strict: output.strict || false,
-            schema: output.schema,
+        const useFallback = (existing, originalError) => {
+            const fallbackSchema = buildJsonSchemaFromZod(outputType);
+            if (fallbackSchema) {
+                return {
+                    type: existing?.type ?? 'json_schema',
+                    name: existing?.name ?? 'output',
+                    strict: existing?.strict ?? false,
+                    schema: fallbackSchema,
+                };
+            }
+            const errorMessage = originalError instanceof Error
+                ? ` Upstream helper error: ${originalError.message}`
+                : '';
+            throw new errors_1.UserError(`Unable to convert the provided Zod schema to JSON Schema. Ensure that the \`zod\` package is available at runtime or provide a JSON schema object instead.${errorMessage}`);
         };
+        let output;
+        try {
+            output = zodTextFormatCompat((0, zodCompat_1.asZodType)(outputType), 'output');
+        }
+        catch (error) {
+            return useFallback(undefined, error);
+        }
+        if ((0, zodJsonSchemaCompat_1.hasJsonSchemaObjectShape)(output.schema)) {
+            return {
+                type: output.type,
+                name: output.name,
+                strict: output.strict || false,
+                schema: output.schema,
+            };
+        }
+        return useFallback(output);
     }
     return outputType;
 }

package/dist/utils/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/utils/tools.ts"],"names":[],"mappings":";;AAiBA,gDAaC;AAUD,0EA6BC;AAKD,oFAkBC;AA5FD,4CAAyE;AACzE,yCAAsC;AAGtC,gDAA2C;AAO3C;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAC,IAAY;IAC7C,kCAAkC;IAClC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEhC,uDAAuD;IACvD,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;IAE1C,+BAA+B;IAC/B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,IAAwB,CAAC;AAClC,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,+BAA+B,CAC7C,SAAY,EACZ,IAAY;IAKZ,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEpD,IAAI,IAAA,wBAAW,EAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,MAAM,iBAAiB,GAAG,IAAA,0BAAoB,EAAC;YAC7C,IAAI;YACJ,UAAU,EAAE,SAAS;YACrB,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,mDAAmD;YACvE,WAAW,EAAE,EAAE;SAChB,CAAC,CAAC;QAEH,OAAO;YACL,MAAM,EAAE,iBAAiB,CAAC,UAAmC;YAC7D,MAAM,EAAE,iBAAiB,CAAC,SAAS;SACpC,CAAC;IACJ,CAAC;SAAM,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QAC/D,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,MAAM;SACP,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,kBAAS,CAAC,sDAAsD,CAAC,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,SAAgB,oCAAoC,CAClD,UAA2B;IAE3B,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,IAAA,wBAAW,EAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAA,mBAAa,EAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACnD,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,KAAK;YAC9B,MAAM,EAAE,MAAM,CAAC,MAA+B;SAC/C,CAAC;IACJ,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/utils/tools.ts"],"names":[],"mappings":"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"}

package/dist/utils/tools.mjs

@@ -1,6 +1,17 @@
 import { zodResponsesFunction, zodTextFormat } from 'openai/helpers/zod';
 import { UserError } from "../errors.mjs";
 import { isZodObject } from "./typeGuards.mjs";
+import { zodJsonSchemaCompat, hasJsonSchemaObjectShape, } from "./zodJsonSchemaCompat.mjs";
+import { asZodType } from "./zodCompat.mjs";
+const zodResponsesFunctionCompat = zodResponsesFunction;
+// The `.schema` payload is all we need, so a lightweight signature keeps the compiler happy.
+const zodTextFormatCompat = zodTextFormat;
+// openai/helpers/zod cannot emit strict schemas for every Zod runtime
+// (notably Zod v4), so we delegate to a small local converter living in
+// zodJsonSchemaCompat.ts whenever its output is missing the required JSON Schema bits.
+function buildJsonSchemaFromZod(inputType) {
+    return zodJsonSchemaCompat(inputType);
+}
 /**
  * Convert a string to a function tool name by replacing spaces with underscores and
  * non-alphanumeric characters with underscores.
@@ -29,16 +40,38 @@ export function toFunctionToolName(name) {
 export function getSchemaAndParserFromInputType(inputType, name) {
     const parser = (input) => JSON.parse(input);
     if (isZodObject(inputType)) {
-        const formattedFunction = zodResponsesFunction({
-            name,
-            parameters: inputType,
-            function: () => { }, // empty function here to satisfy the OpenAI helper
-            description: '',
-        });
-        return {
-            schema: formattedFunction.parameters,
-            parser: formattedFunction.$parseRaw,
+        const useFallback = (originalError) => {
+            const fallbackSchema = buildJsonSchemaFromZod(inputType);
+            if (fallbackSchema) {
+                return {
+                    schema: fallbackSchema,
+                    parser: (rawInput) => inputType.parse(JSON.parse(rawInput)),
+                };
+            }
+            const errorMessage = originalError instanceof Error
+                ? ` Upstream helper error: ${originalError.message}`
+                : '';
+            throw new UserError(`Unable to convert the provided Zod schema to JSON Schema. Ensure that the \`zod\` package is available at runtime or provide a JSON schema object instead.${errorMessage}`);
         };
+        let formattedFunction;
+        try {
+            formattedFunction = zodResponsesFunctionCompat({
+                name,
+                parameters: asZodType(inputType),
+                function: () => { }, // empty function here to satisfy the OpenAI helper
+                description: '',
+            });
+        }
+        catch (error) {
+            return useFallback(error);
+        }
+        if (hasJsonSchemaObjectShape(formattedFunction.parameters)) {
+            return {
+                schema: formattedFunction.parameters,
+                parser: formattedFunction.$parseRaw,
+            };
+        }
+        return useFallback();
     }
     else if (typeof inputType === 'object' && inputType !== null) {
         return {
@@ -56,13 +89,37 @@ export function convertAgentOutputTypeToSerializable(outputType) {
         return 'text';
     }
     if (isZodObject(outputType)) {
-        const output = zodTextFormat(outputType, 'output');
-        return {
-            type: output.type,
-            name: output.name,
-            strict: output.strict || false,
-            schema: output.schema,
+        const useFallback = (existing, originalError) => {
+            const fallbackSchema = buildJsonSchemaFromZod(outputType);
+            if (fallbackSchema) {
+                return {
+                    type: existing?.type ?? 'json_schema',
+                    name: existing?.name ?? 'output',
+                    strict: existing?.strict ?? false,
+                    schema: fallbackSchema,
+                };
+            }
+            const errorMessage = originalError instanceof Error
+                ? ` Upstream helper error: ${originalError.message}`
+                : '';
+            throw new UserError(`Unable to convert the provided Zod schema to JSON Schema. Ensure that the \`zod\` package is available at runtime or provide a JSON schema object instead.${errorMessage}`);
         };
+        let output;
+        try {
+            output = zodTextFormatCompat(asZodType(outputType), 'output');
+        }
+        catch (error) {
+            return useFallback(undefined, error);
+        }
+        if (hasJsonSchemaObjectShape(output.schema)) {
+            return {
+                type: output.type,
+                name: output.name,
+                strict: output.strict || false,
+                schema: output.schema,
+            };
+        }
+        return useFallback(output);
     }
     return outputType;
 }

package/dist/utils/tools.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"tools.mjs","sourceRoot":"","sources":["../../src/utils/tools.ts"],"names":[],"mappings":"OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,oBAAoB;OACjE,EAAE,SAAS,EAAE;OAGb,EAAE,WAAW,EAAE;AAOtB;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,kCAAkC;IAClC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEhC,uDAAuD;IACvD,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;IAE1C,+BAA+B;IAC/B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,IAAwB,CAAC;AAClC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,+BAA+B,CAC7C,SAAY,EACZ,IAAY;IAKZ,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEpD,IAAI,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,MAAM,iBAAiB,GAAG,oBAAoB,CAAC;YAC7C,IAAI;YACJ,UAAU,EAAE,SAAS;YACrB,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,mDAAmD;YACvE,WAAW,EAAE,EAAE;SAChB,CAAC,CAAC;QAEH,OAAO;YACL,MAAM,EAAE,iBAAiB,CAAC,UAAmC;YAC7D,MAAM,EAAE,iBAAiB,CAAC,SAAS;SACpC,CAAC;IACJ,CAAC;SAAM,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QAC/D,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,MAAM;SACP,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,SAAS,CAAC,sDAAsD,CAAC,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oCAAoC,CAClD,UAA2B;IAE3B,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACnD,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,KAAK;YAC9B,MAAM,EAAE,MAAM,CAAC,MAA+B;SAC/C,CAAC;IACJ,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}
+{"version":3,"file":"tools.mjs","sourceRoot":"","sources":["../../src/utils/tools.ts"],"names":[],"mappings":"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"}

package/dist/utils/typeGuards.d.ts

@@ -1,11 +1,11 @@
-import type { ZodObject } from 'zod';
+import type { ZodObjectLike } from './zodCompat';
 /**
  * Verifies that an input is a ZodObject without needing to have Zod at runtime since it's an
  * optional dependency.
  * @param input
  * @returns
  */
-export declare function isZodObject(input: unknown): input is ZodObject<any>;
+export declare function isZodObject(input: unknown): input is ZodObjectLike;
 /**
  * Verifies that an input is an object with an `input` property.
  * @param input

package/dist/utils/typeGuards.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isZodObject = isZodObject;
 exports.isAgentToolInput = isAgentToolInput;
+const zodCompat_1 = require("./zodCompat.js");
 /**
  * Verifies that an input is a ZodObject without needing to have Zod at runtime since it's an
  * optional dependency.
@@ -9,13 +10,12 @@ exports.isAgentToolInput = isAgentToolInput;
  * @returns
  */
 function isZodObject(input) {
-    return (typeof input === 'object' &&
-        input !== null &&
-        '_def' in input &&
-        typeof input._def === 'object' &&
-        input._def !== null &&
-        'typeName' in input._def &&
-        input._def.typeName === 'ZodObject');
+    const definition = (0, zodCompat_1.readZodDefinition)(input);
+    if (!definition) {
+        return false;
+    }
+    const type = (0, zodCompat_1.readZodType)(input);
+    return type === 'object';
 }
 /**
  * Verifies that an input is an object with an `input` property.

package/dist/utils/typeGuards.js.map

@@ -1 +1 @@
-{"version":3,"file":"typeGuards.js","sourceRoot":"","sources":["../../src/utils/typeGuards.ts"],"names":[],"mappings":";;AASA,kCAUC;AAOD,4CASC;AAjCD;;;;;GAKG;AAEH,SAAgB,WAAW,CAAC,KAAc;IACxC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,KAAK,CAAC,IAAI,KAAK,IAAI;QACnB,UAAU,IAAI,KAAK,CAAC,IAAI;QACxB,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,WAAW,CACpC,CAAC;AACJ,CAAC;AACD;;;;GAIG;AAEH,SAAgB,gBAAgB,CAAC,KAAc;IAG7C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAO,IAAI,KAAK;QAChB,OAAQ,KAAa,CAAC,KAAK,KAAK,QAAQ,CACzC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"typeGuards.js","sourceRoot":"","sources":["../../src/utils/typeGuards.ts"],"names":[],"mappings":";;AASA,kCAQC;AAOD,4CASC;AAhCD,8CAA6D;AAE7D;;;;;GAKG;AACH,SAAgB,WAAW,CAAC,KAAc;IACxC,MAAM,UAAU,GAAG,IAAA,6BAAiB,EAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,IAAI,GAAG,IAAA,uBAAW,EAAC,KAAK,CAAC,CAAC;IAChC,OAAO,IAAI,KAAK,QAAQ,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,KAAc;IAG7C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAO,IAAI,KAAK;QAChB,OAAQ,KAAa,CAAC,KAAK,KAAK,QAAQ,CACzC,CAAC;AACJ,CAAC"}

package/dist/utils/typeGuards.mjs

@@ -1,3 +1,4 @@
+import { readZodDefinition, readZodType } from "./zodCompat.mjs";
 /**
  * Verifies that an input is a ZodObject without needing to have Zod at runtime since it's an
  * optional dependency.
@@ -5,13 +6,12 @@
  * @returns
  */
 export function isZodObject(input) {
-    return (typeof input === 'object' &&
-        input !== null &&
-        '_def' in input &&
-        typeof input._def === 'object' &&
-        input._def !== null &&
-        'typeName' in input._def &&
-        input._def.typeName === 'ZodObject');
+    const definition = readZodDefinition(input);
+    if (!definition) {
+        return false;
+    }
+    const type = readZodType(input);
+    return type === 'object';
 }
 /**
  * Verifies that an input is an object with an `input` property.

package/dist/utils/typeGuards.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"typeGuards.mjs","sourceRoot":"","sources":["../../src/utils/typeGuards.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,KAAK,CAAC,IAAI,KAAK,IAAI;QACnB,UAAU,IAAI,KAAK,CAAC,IAAI;QACxB,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,WAAW,CACpC,CAAC;AACJ,CAAC;AACD;;;;GAIG;AAEH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAG7C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAO,IAAI,KAAK;QAChB,OAAQ,KAAa,CAAC,KAAK,KAAK,QAAQ,CACzC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"typeGuards.mjs","sourceRoot":"","sources":["../../src/utils/typeGuards.ts"],"names":[],"mappings":"OACO,EAAE,iBAAiB,EAAE,WAAW,EAAE;AAEzC;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAChC,OAAO,IAAI,KAAK,QAAQ,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAG7C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAO,IAAI,KAAK;QAChB,OAAQ,KAAa,CAAC,KAAK,KAAK,QAAQ,CACzC,CAAC;AACJ,CAAC"}

package/dist/utils/zodCompat.d.ts

@@ -0,0 +1,13 @@
+import type { ZodObject as ZodObjectV3, ZodTypeAny } from 'zod';
+import type { ZodObject as ZodObjectV4, ZodType as ZodTypeV4 } from 'zod/v4';
+type ZodDefinition = Record<string, unknown> | undefined;
+type ZodTypeV4Any = ZodTypeV4<any, any, any>;
+export type ZodTypeLike = ZodTypeAny | ZodTypeV4Any;
+export type ZodObjectLike = ZodObjectV3<any, any, any, any, any> | ZodObjectV4<any, any>;
+export declare function asZodType(schema: ZodTypeLike): ZodTypeAny;
+export declare function readZodDefinition(input: unknown): ZodDefinition;
+export declare function readZodType(input: unknown): string | undefined;
+export type ZodInfer<T extends ZodTypeLike> = T extends {
+    _output: infer Output;
+} ? Output : never;
+export {};

package/dist/utils/zodCompat.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asZodType = asZodType;
+exports.readZodDefinition = readZodDefinition;
+exports.readZodType = readZodType;
+function asZodType(schema) {
+    return schema;
+}
+function readZodDefinition(input) {
+    if (typeof input !== 'object' || input === null) {
+        return undefined;
+    }
+    const candidate = input;
+    return candidate._zod?.def || candidate._def || candidate.def;
+}
+function readZodType(input) {
+    const def = readZodDefinition(input);
+    if (!def) {
+        return undefined;
+    }
+    const rawType = (typeof def.typeName === 'string' && def.typeName) ||
+        (typeof def.type === 'string' && def.type);
+    if (typeof rawType !== 'string') {
+        return undefined;
+    }
+    const lower = rawType.toLowerCase();
+    return lower.startsWith('zod') ? lower.slice(3) : lower;
+}
+//# sourceMappingURL=zodCompat.js.map

package/dist/utils/zodCompat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zodCompat.js","sourceRoot":"","sources":["../../src/utils/zodCompat.ts"],"names":[],"mappings":";;AAkBA,8BAEC;AAED,8CAOC;AAED,kCAgBC;AA7BD,SAAgB,SAAS,CAAC,MAAmB;IAC3C,OAAO,MAA+B,CAAC;AACzC,CAAC;AAED,SAAgB,iBAAiB,CAAC,KAAc;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,SAAS,GAAG,KAAgB,CAAC;IACnC,OAAO,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,GAAG,CAAC;AAChE,CAAC;AAED,SAAgB,WAAW,CAAC,KAAc;IACxC,MAAM,GAAG,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GACX,CAAC,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,CAAC;QAClD,CAAC,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IAE7C,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,OAAO,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAC1D,CAAC"}

package/dist/utils/zodCompat.mjs

@@ -0,0 +1,24 @@
+export function asZodType(schema) {
+    return schema;
+}
+export function readZodDefinition(input) {
+    if (typeof input !== 'object' || input === null) {
+        return undefined;
+    }
+    const candidate = input;
+    return candidate._zod?.def || candidate._def || candidate.def;
+}
+export function readZodType(input) {
+    const def = readZodDefinition(input);
+    if (!def) {
+        return undefined;
+    }
+    const rawType = (typeof def.typeName === 'string' && def.typeName) ||
+        (typeof def.type === 'string' && def.type);
+    if (typeof rawType !== 'string') {
+        return undefined;
+    }
+    const lower = rawType.toLowerCase();
+    return lower.startsWith('zod') ? lower.slice(3) : lower;
+}
+//# sourceMappingURL=zodCompat.mjs.map

package/dist/utils/zodCompat.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"zodCompat.mjs","sourceRoot":"","sources":["../../src/utils/zodCompat.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,SAAS,CAAC,MAAmB;IAC3C,OAAO,MAA+B,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,SAAS,GAAG,KAAgB,CAAC;IACnC,OAAO,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,GAAG,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,MAAM,GAAG,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GACX,CAAC,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,CAAC;QAClD,CAAC,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IAE7C,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,OAAO,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAC1D,CAAC"}

package/dist/utils/zodJsonSchemaCompat.d.ts

@@ -0,0 +1,29 @@
+import type { JsonObjectSchema, JsonSchemaDefinitionEntry } from '../types';
+import type { ZodObjectLike } from './zodCompat';
+/**
+ * The JSON-schema helpers in openai/helpers/zod only emit complete schemas for
+ * a subset of Zod constructs. In particular, Zod v4 (and several decorators in v3)
+ * omit `type`, `properties`, or `required` metadata, which breaks tool execution
+ * when a user relies on automatic schema extraction.
+ *
+ * This module provides a minimal, type-directed fallback converter that inspects
+ * Zod internals and synthesises the missing JSON Schema bits on demand. The
+ * converter only covers the constructs we actively depend on (objects, optionals,
+ * unions, tuples, records, sets, etc.); anything more exotic simply returns
+ * `undefined`, signalling to the caller that it should surface a user error.
+ *
+ * The implementation is intentionally explicit: helper functions isolate each
+ * Zod shape, making the behaviour both testable and easier to trim back if the
+ * upstream helper gains first-class support. See zodJsonSchemaCompat.test.ts for
+ * the regression cases we guarantee.
+ */
+type LooseJsonObjectSchema = {
+    type: 'object';
+    properties: Record<string, JsonSchemaDefinitionEntry>;
+    required?: string[];
+    additionalProperties?: boolean;
+    $schema?: string;
+};
+export declare function hasJsonSchemaObjectShape(value: unknown): value is LooseJsonObjectSchema;
+export declare function zodJsonSchemaCompat(input: ZodObjectLike): JsonObjectSchema<any> | undefined;
+export {};