openai 7.3.0 → 7.5.0

package/lib/EventStream.mjs

@@ -1,17 +1,55 @@
 var _EventStream_instances, _EventStream_connectedPromise, _EventStream_resolveConnectedPromise, _EventStream_rejectConnectedPromise, _EventStream_endPromise, _EventStream_resolveEndPromise, _EventStream_rejectEndPromise, _EventStream_listeners, _EventStream_abortListeners, _EventStream_ended, _EventStream_errored, _EventStream_aborted, _EventStream_catchingPromiseCreated, _EventStream_removeAbortListeners, _EventStream_handleError;
 import { __classPrivateFieldGet, __classPrivateFieldSet } from "../internal/tslib.mjs";
 import { APIUserAbortError, OpenAIError } from "../error.mjs";
+function createEventQueue() {
+    let entries = [];
+    let head = 0;
+    return {
+        get length() {
+            return entries.length - head;
+        },
+        enqueue(value) {
+            entries.push(value);
+        },
+        dequeue() {
+            if (head === entries.length) {
+                return undefined;
+            }
+            const value = entries[head];
+            entries[head] = undefined;
+            head += 1;
+            if (head === entries.length) {
+                entries = [];
+                head = 0;
+            }
+            else if (head >= 1024 && head * 2 >= entries.length) {
+                entries = entries.slice(head);
+                head = 0;
+            }
+            return value;
+        },
+        clear() {
+            entries = [];
+            head = 0;
+        },
+    };
+}
+/** An abortable event stream with typed listeners, asynchronous iteration, and lifecycle state. */
 export class EventStream {
+    /** Creates an unstarted stream with independent connection and completion lifecycle promises. */
     constructor() {
         _EventStream_instances.add(this);
+        /** Controls the underlying request; aborting this controller cancels the stream. */
         this.controller = new AbortController();
         _EventStream_connectedPromise.set(this, void 0);
-        _EventStream_resolveConnectedPromise.set(this, () => { });
-        _EventStream_rejectConnectedPromise.set(this, () => { });
+        // oxlint-disable class-methods-use-this -- Deferred promise resolvers are intentionally per-instance mutable callbacks.
+        _EventStream_resolveConnectedPromise.set(this, () => undefined);
+        _EventStream_rejectConnectedPromise.set(this, () => undefined);
         _EventStream_endPromise.set(this, void 0);
-        _EventStream_resolveEndPromise.set(this, () => { });
-        _EventStream_rejectEndPromise.set(this, () => { });
-        _EventStream_listeners.set(this, {});
+        _EventStream_resolveEndPromise.set(this, () => undefined);
+        _EventStream_rejectEndPromise.set(this, () => undefined);
+        // oxlint-enable class-methods-use-this
+        _EventStream_listeners.set(this, Object.create(null));
         _EventStream_abortListeners.set(this, []);
         _EventStream_ended.set(this, false);
         _EventStream_errored.set(this, false);
@@ -29,16 +67,24 @@ export class EventStream {
         // we will manually cause an unhandled rejection error later
         // if the user hasn't registered any error listener or called
         // any promise-returning method.
-        __classPrivateFieldGet(this, _EventStream_connectedPromise, "f").catch(() => { });
-        __classPrivateFieldGet(this, _EventStream_endPromise, "f").catch(() => { });
+        __classPrivateFieldGet(this, _EventStream_connectedPromise, "f").catch(() => undefined);
+        __classPrivateFieldGet(this, _EventStream_endPromise, "f").catch(() => undefined);
     }
     _run(executor) {
         // Unfortunately if we call `executor()` immediately we get runtime errors about
         // references to `this` before the `super()` constructor call returns.
         setTimeout(() => {
+            let failed = false;
             Promise.resolve()
                 .then(executor)
+                .catch((error) => {
+                failed = true;
+                __classPrivateFieldGet(this, _EventStream_instances, "m", _EventStream_handleError).call(this, error);
+            })
                 .then(() => {
+                if (failed) {
+                    return;
+                }
                 try {
                     this._emitFinal();
                 }
@@ -47,30 +93,39 @@ export class EventStream {
                     return;
                 }
                 this._emit('end');
-            }, __classPrivateFieldGet(this, _EventStream_instances, "m", _EventStream_handleError).bind(this));
+            });
         }, 0);
     }
     _connected() {
-        if (this.ended)
+        if (this.ended) {
             return;
+        }
         __classPrivateFieldGet(this, _EventStream_resolveConnectedPromise, "f").call(this);
         this._emit('connect');
     }
+    /** Whether the stream has finished successfully, failed, or been aborted. */
     get ended() {
         return __classPrivateFieldGet(this, _EventStream_ended, "f");
     }
+    /** Whether an error or user cancellation has been observed. */
     get errored() {
         return __classPrivateFieldGet(this, _EventStream_errored, "f");
     }
+    /** Whether the stream ended because its request was cancelled. */
     get aborted() {
         return __classPrivateFieldGet(this, _EventStream_aborted, "f");
     }
+    /**
+     * Cancels the underlying request; {@link done} and {@link events} observe cancellation.
+     * Promises returned by {@link emitted} for other events may remain pending.
+     */
     abort() {
         this.controller.abort();
     }
     _listenForAbort(signal) {
-        if (!signal || this.ended)
+        if (!signal || this.ended) {
             return;
+        }
         if (signal.aborted) {
             this.controller.abort();
             return;
@@ -84,10 +139,11 @@ export class EventStream {
      * No checks are made to see if the listener has already been added. Multiple calls passing
      * the same combination of event and listener will result in the listener being added, and
      * called, multiple times.
-     * @returns this ChatCompletionStream, so that calls can be chained
+     * @returns This stream, so that listener registration calls can be chained.
      */
     on(event, listener) {
-        const listeners = __classPrivateFieldGet(this, _EventStream_listeners, "f")[event] || (__classPrivateFieldGet(this, _EventStream_listeners, "f")[event] = []);
+        var _a;
+        const listeners = ((_a = __classPrivateFieldGet(this, _EventStream_listeners, "f"))[event] || (_a[event] = []));
         listeners.push({ listener });
         return this;
     }
@@ -96,33 +152,38 @@ export class EventStream {
      * off() will remove, at most, one instance of a listener from the listener array. If any single
      * listener has been added multiple times to the listener array for the specified event, then
      * off() must be called multiple times to remove each instance.
-     * @returns this ChatCompletionStream, so that calls can be chained
+     * @returns This stream, so that listener registration calls can be chained.
      */
     off(event, listener) {
         const listeners = __classPrivateFieldGet(this, _EventStream_listeners, "f")[event];
-        if (!listeners)
+        if (!listeners) {
             return this;
+        }
         const index = listeners.findIndex((l) => l.listener === listener);
-        if (index >= 0)
+        if (index !== -1) {
             listeners.splice(index, 1);
+        }
         return this;
     }
     /**
      * Adds a one-time listener function for the event. The next time the event is triggered,
      * this listener is removed and then invoked.
-     * @returns this ChatCompletionStream, so that calls can be chained
+     * @returns This stream, so that listener registration calls can be chained.
      */
     once(event, listener) {
-        const listeners = __classPrivateFieldGet(this, _EventStream_listeners, "f")[event] || (__classPrivateFieldGet(this, _EventStream_listeners, "f")[event] = []);
+        var _a;
+        const listeners = ((_a = __classPrivateFieldGet(this, _EventStream_listeners, "f"))[event] || (_a[event] = []));
         listeners.push({ listener, once: true });
         return this;
     }
     /**
      * This is similar to `.once()`, but returns a Promise that resolves the next time
      * the event is triggered, instead of calling a listener callback.
-     * @returns a Promise that resolves the next time given event is triggered,
-     * or rejects if an error is emitted.  (If you request the 'error' event,
-     * returns a promise that resolves with the error).
+     * Events without arguments resolve to `undefined`, single-argument events resolve
+     * to that argument, and events with multiple arguments resolve to an argument tuple.
+     *
+     * @returns A promise for the next event, or a rejection if an error occurs first.
+     * Requesting the `error` event resolves with the emitted error instead.
      *
      * Example:
      *
@@ -131,9 +192,20 @@ export class EventStream {
     emitted(event) {
         return new Promise((resolve, reject) => {
             __classPrivateFieldSet(this, _EventStream_catchingPromiseCreated, true, "f");
-            if (event !== 'error')
-                this.once('error', reject);
-            this.once(event, resolve);
+            const onError = (error) => {
+                this.off(event, onEvent);
+                reject(error);
+            };
+            const onEvent = (...values) => {
+                if (event !== 'error') {
+                    this.off('error', onError);
+                }
+                resolve((values.length > 1 ? values : values[0]));
+            };
+            if (event !== 'error') {
+                this.once('error', onError);
+            }
+            this.once(event, onEvent);
         });
     }
     /**
@@ -149,46 +221,73 @@ export class EventStream {
      *   }
      */
     events(event) {
-        const pushQueue = [];
-        const readQueue = [];
+        return this._createIterator((push) => {
+            const onEvent = (...args) => push(args);
+            this.on(event, onEvent);
+            return () => this.off(event, onEvent);
+        }, {
+            // When iterating the 'error' or 'abort' event itself, yield it as a
+            // value instead of rejecting the iterator.
+            rejectOnError: event !== 'error',
+            rejectOnAbort: event !== 'abort',
+        });
+    }
+    /**
+     * Shared buffered async-iterator adapter over this stream's events.
+     *
+     * `attach` registers the producer listener(s) with the given `push` and
+     * returns a cleanup function that removes them. Termination is handled
+     * here: the iterator ends when the stream ends, listeners are removed on
+     * end/return, and a terminal error is retained until buffered values have
+     * drained so it is surfaced even when no reader was waiting when it fired.
+     */
+    _createIterator(attach, { rejectOnError = true, rejectOnAbort = true, onReturn, } = {}) {
+        const pushQueue = createEventQueue();
+        const readQueue = createEventQueue();
         let ended = this.ended;
         let failure;
         let failureDelivered = false;
+        let detach = () => undefined;
         const doneResult = () => ({ value: undefined, done: true });
         const finishReaders = () => {
             while (readQueue.length) {
-                readQueue.shift().resolve(doneResult());
+                readQueue.dequeue().resolve(doneResult());
             }
         };
         const rejectReader = () => {
-            if (!failure || failureDelivered || !readQueue.length)
+            if (!failure || failureDelivered || !readQueue.length) {
                 return;
+            }
             failureDelivered = true;
-            readQueue.shift().reject(failure);
+            readQueue.dequeue().reject(failure);
         };
         const cleanup = () => {
-            this.off(event, onEvent);
+            detach();
             this.off('end', onEnd);
-            if (event !== 'error')
+            if (rejectOnError) {
                 this.off('error', onFailure);
-            if (event !== 'abort')
+            }
+            if (rejectOnAbort) {
                 this.off('abort', onFailure);
+            }
         };
-        const onEvent = (...args) => {
-            if (ended)
+        const push = (value) => {
+            if (ended) {
                 return;
-            const reader = readQueue.shift();
+            }
+            const reader = readQueue.dequeue();
             if (reader) {
-                reader.resolve({ value: args, done: false });
+                reader.resolve({ value, done: false });
             }
             else {
-                pushQueue.push(args);
+                pushQueue.enqueue(value);
             }
         };
         const onFailure = (error) => {
             failure = error;
-            if (!pushQueue.length)
+            if (!pushQueue.length) {
                 rejectReader();
+            }
         };
         const onEnd = () => {
             ended = true;
@@ -199,33 +298,44 @@ export class EventStream {
             }
         };
         if (!ended) {
-            this.on(event, onEvent);
+            detach = attach(push);
             this.on('end', onEnd);
-            if (event !== 'error')
+            if (rejectOnError) {
                 this.on('error', onFailure);
-            if (event !== 'abort')
+            }
+            if (rejectOnAbort) {
                 this.on('abort', onFailure);
+            }
         }
         return {
             next: () => {
-                const value = pushQueue.shift();
-                if (value)
-                    return Promise.resolve({ value, done: false });
+                if (pushQueue.length) {
+                    return Promise.resolve({ value: pushQueue.dequeue(), done: false });
+                }
                 if (failure && !failureDelivered) {
                     failureDelivered = true;
                     return Promise.reject(failure);
                 }
-                if (ended)
+                if (ended) {
                     return Promise.resolve(doneResult());
+                }
                 return new Promise((resolve, reject) => {
-                    readQueue.push({ resolve, reject });
+                    readQueue.enqueue({ resolve, reject });
                 });
             },
             return: () => {
                 ended = true;
-                pushQueue.length = 0;
+                pushQueue.clear();
                 cleanup();
                 finishReaders();
+                if (onReturn) {
+                    // The consumer explicitly ended iteration, so any failure the
+                    // onReturn callback triggers (e.g. aborting the stream) is
+                    // self-inflicted; mark the stream's terminal promise as handled so
+                    // it does not surface as an unhandled rejection.
+                    void this.done().catch(() => undefined);
+                    onReturn();
+                }
                 return Promise.resolve(doneResult());
             },
             [Symbol.asyncIterator]() {
@@ -233,10 +343,16 @@ export class EventStream {
             },
         };
     }
+    /** Resolves when the stream ends successfully or rejects when it fails or is aborted. */
     async done() {
         __classPrivateFieldSet(this, _EventStream_catchingPromiseCreated, true, "f");
         await __classPrivateFieldGet(this, _EventStream_endPromise, "f");
     }
+    /** Returns whether an event currently has one or more registered listeners. */
+    _hasListeners(event) {
+        return Boolean(__classPrivateFieldGet(this, _EventStream_listeners, "f")[event]?.length);
+    }
+    /** Dispatches a stream event and performs the associated lifecycle transitions. */
     _emit(event, ...args) {
         // make sure we don't emit any events after end
         if (__classPrivateFieldGet(this, _EventStream_ended, "f")) {
@@ -250,7 +366,9 @@ export class EventStream {
         const listeners = __classPrivateFieldGet(this, _EventStream_listeners, "f")[event];
         if (listeners) {
             __classPrivateFieldGet(this, _EventStream_listeners, "f")[event] = listeners.filter((l) => !l.once);
-            listeners.forEach(({ listener }) => listener(...args));
+            for (const { listener } of listeners) {
+                listener(...args);
+            }
         }
         if (event === 'abort') {
             const error = args[0];
@@ -279,7 +397,10 @@ export class EventStream {
             this._emit('end');
         }
     }
-    _emitFinal() { }
+    // oxlint-disable-next-line class-methods-use-this -- Subclasses override this instance hook.
+    _emitFinal() {
+        // Hook for subclasses.
+    }
 }
 _EventStream_connectedPromise = new WeakMap(), _EventStream_resolveConnectedPromise = new WeakMap(), _EventStream_rejectConnectedPromise = new WeakMap(), _EventStream_endPromise = new WeakMap(), _EventStream_resolveEndPromise = new WeakMap(), _EventStream_rejectEndPromise = new WeakMap(), _EventStream_listeners = new WeakMap(), _EventStream_abortListeners = new WeakMap(), _EventStream_ended = new WeakMap(), _EventStream_errored = new WeakMap(), _EventStream_aborted = new WeakMap(), _EventStream_catchingPromiseCreated = new WeakMap(), _EventStream_instances = new WeakSet(), _EventStream_removeAbortListeners = function _EventStream_removeAbortListeners() {
     for (const { signal, listener } of __classPrivateFieldGet(this, _EventStream_abortListeners, "f").splice(0)) {

package/lib/EventStream.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"EventStream.mjs","sourceRoot":"","sources":["../src/lib/EventStream.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"EventStream.mjs","sourceRoot":"","sources":["../src/lib/EventStream.ts"],"names":[],"mappings":"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"}

package/lib/ResponsesParser.d.mts

@@ -1,36 +1,83 @@
 import type { ChatCompletionTool } from "../resources/chat/completions.mjs";
-import { ResponseTextConfig, type FunctionTool, type ParsedResponse, type Response, type ResponseCreateParamsBase, type ResponseCreateParamsNonStreaming, type ResponseFunctionToolCall, type Tool } from "../resources/responses/responses.mjs";
-import { type AutoParseableTextFormat } from "../lib/parser.mjs";
-export type ParseableToolsParams = Array<Tool> | ChatCompletionTool | null;
+import type { FunctionTool, ParsedResponse, Response, ResponseCreateParamsBase, ResponseCreateParamsNonStreaming, ResponseFormatTextJSONSchemaConfig, ResponseFunctionToolCall, ResponseTextConfig, Tool } from "../resources/responses/responses.mjs";
+import type { AutoParseableTextFormat } from "../lib/parser.mjs";
+/** Response tools, a compatible chat completion tool, or no tools. */
+export type ParseableToolsParams = Tool[] | ChatCompletionTool | null;
+/** Response-creation parameters that may include tools recognized by parsing helpers. */
 export type ResponseCreateParamsWithTools = ResponseCreateParamsBase & {
+    /** Tools available to the model while producing the response. */
     tools?: ParseableToolsParams;
 };
+/** Request fields that can select a plain-text or structured Responses API output format. */
 type TextConfigParams = {
+    /** Optional text output configuration, including its structured JSON format. */
     text?: ResponseTextConfig;
 };
-export type ExtractParsedContentFromParams<Params extends TextConfigParams> = NonNullable<Params['text']>['format'] extends AutoParseableTextFormat<infer P> ? P : null;
+/** Infers parsed output for each member of a possibly optional text-format union. */
+type ParsedTextFormat<Format> = [Format] extends [never] ? null : Format extends AutoParseableTextFormat<infer ParsedT> ? ParsedT : Format extends ResponseFormatTextJSONSchemaConfig ? unknown : null;
+/**
+ * Resolves the type of `output_parsed` / `content[].parsed` for the given params.
+ *
+ * This must stay in sync with `isParseableResponseFormat()` and
+ * `parseResponseFormatContent()`: formats built by an SDK helper carry their parsed
+ * type in the brand, while a raw `{ type: 'json_schema' }` format is parsed with
+ * `JSON.parse()` and so can only be described as `unknown`.
+ */
+export type ExtractParsedContentFromParams<Params extends TextConfigParams> = ParsedTextFormat<NonNullable<Params['text']>['format']>;
+/**
+ * Adds parsed-output fields to a response, invoking parsers only when its request
+ * includes an auto-parseable text format or strict function tool.
+ */
 export declare function maybeParseResponse<Params extends ResponseCreateParamsBase | null, ParsedT = Params extends null ? null : ExtractParsedContentFromParams<NonNullable<Params>>>(response: Response, params: Params): ParsedResponse<ParsedT>;
+/**
+ * Parses completed response text and strict function-tool arguments.
+ *
+ * Incomplete or nonterminal responses keep their parsed values as `null`, and
+ * `output_parsed` returns the first successfully parsed output-text item.
+ */
 export declare function parseResponse<Params extends ResponseCreateParamsBase, ParsedT = ExtractParsedContentFromParams<Params>>(response: Response, params: Params): ParsedResponse<ParsedT>;
+/** Returns whether the request includes an auto-parseable text format or strict function tool. */
 export declare function hasAutoParseableInput(params: ResponseCreateParamsWithTools): boolean;
+/** Type-level details used to infer a Responses API function tool's parser and callback. */
 type ToolOptions = {
+    /** Model-visible function name used to match generated tool calls. */
     name: string;
+    /** Parsed argument value accepted by the optional execution callback. */
     arguments: any;
+    /** Optional callback metadata associated with the parsed function tool. */
     function?: ((args: any) => any) | undefined;
 };
-export type AutoParseableResponseTool<OptionsT extends ToolOptions, HasFunction = OptionsT['function'] extends Function ? true : false> = FunctionTool & {
+/** A Responses API function tool with an argument parser and optional executable callback. */
+export type AutoParseableResponseTool<OptionsT extends ToolOptions, HasFunction = OptionsT['function'] extends (...args: never[]) => unknown ? true : false> = FunctionTool & {
+    /** Type-only marker for parsed tool arguments; this property does not exist at runtime. */
     __arguments: OptionsT['arguments'];
+    /** Type-only marker for the function name; this property does not exist at runtime. */
     __name: OptionsT['name'];
+    /** Non-enumerable SDK marker identifying a tool with an attached argument parser. */
     $brand: 'auto-parseable-tool';
+    /** Optional callback available to helpers that execute parsed function tools. */
     $callback: ((args: OptionsT['arguments']) => any) | undefined;
+    /** Parses the raw JSON argument string into the function's typed argument value. */
     $parseRaw(args: string): OptionsT['arguments'];
 };
+/** Copies a Responses API function tool and attaches non-enumerable parser and callback metadata. */
 export declare function makeParseableResponseTool<OptionsT extends ToolOptions>(tool: FunctionTool, { parser, callback, }: {
+    /** Converts the raw JSON argument string into the function's typed argument value. */
     parser: (content: string) => OptionsT['arguments'];
+    /** Optional callback available to helpers that execute the parsed function. */
     callback: ((args: any) => any) | undefined;
 }): AutoParseableResponseTool<OptionsT['arguments']>;
+/** Returns whether a Responses API tool carries the SDK's argument-parser marker. */
 export declare function isAutoParsableTool(tool: any): tool is AutoParseableResponseTool<any>;
+/** Returns whether a response function call matches a strict or auto-parseable request tool. */
 export declare function shouldParseToolCall(params: ResponseCreateParamsNonStreaming | null | undefined, toolCall: ResponseFunctionToolCall): boolean;
+/**
+ * Validates that compatible chat completion tools can be automatically parsed.
+ *
+ * @throws {OpenAIError} If a tool is not a function or is missing `strict: true`.
+ */
 export declare function validateInputTools(tools: ChatCompletionTool[] | undefined): void;
+/** Replaces `output_text` with the concatenated text from every response output message. */
 export declare function addOutputText(rsp: Response): void;
 export {};
 //# sourceMappingURL=ResponsesParser.d.mts.map

package/lib/ResponsesParser.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"ResponsesParser.d.mts","sourceRoot":"","sources":["../src/lib/ResponsesParser.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ResponsesParser.d.mts","sourceRoot":"","sources":["../src/lib/ResponsesParser.ts"],"names":[],"mappings":"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"}

package/lib/ResponsesParser.d.ts

@@ -1,36 +1,83 @@
 import type { ChatCompletionTool } from "../resources/chat/completions.js";
-import { ResponseTextConfig, type FunctionTool, type ParsedResponse, type Response, type ResponseCreateParamsBase, type ResponseCreateParamsNonStreaming, type ResponseFunctionToolCall, type Tool } from "../resources/responses/responses.js";
-import { type AutoParseableTextFormat } from "../lib/parser.js";
-export type ParseableToolsParams = Array<Tool> | ChatCompletionTool | null;
+import type { FunctionTool, ParsedResponse, Response, ResponseCreateParamsBase, ResponseCreateParamsNonStreaming, ResponseFormatTextJSONSchemaConfig, ResponseFunctionToolCall, ResponseTextConfig, Tool } from "../resources/responses/responses.js";
+import type { AutoParseableTextFormat } from "../lib/parser.js";
+/** Response tools, a compatible chat completion tool, or no tools. */
+export type ParseableToolsParams = Tool[] | ChatCompletionTool | null;
+/** Response-creation parameters that may include tools recognized by parsing helpers. */
 export type ResponseCreateParamsWithTools = ResponseCreateParamsBase & {
+    /** Tools available to the model while producing the response. */
     tools?: ParseableToolsParams;
 };
+/** Request fields that can select a plain-text or structured Responses API output format. */
 type TextConfigParams = {
+    /** Optional text output configuration, including its structured JSON format. */
     text?: ResponseTextConfig;
 };
-export type ExtractParsedContentFromParams<Params extends TextConfigParams> = NonNullable<Params['text']>['format'] extends AutoParseableTextFormat<infer P> ? P : null;
+/** Infers parsed output for each member of a possibly optional text-format union. */
+type ParsedTextFormat<Format> = [Format] extends [never] ? null : Format extends AutoParseableTextFormat<infer ParsedT> ? ParsedT : Format extends ResponseFormatTextJSONSchemaConfig ? unknown : null;
+/**
+ * Resolves the type of `output_parsed` / `content[].parsed` for the given params.
+ *
+ * This must stay in sync with `isParseableResponseFormat()` and
+ * `parseResponseFormatContent()`: formats built by an SDK helper carry their parsed
+ * type in the brand, while a raw `{ type: 'json_schema' }` format is parsed with
+ * `JSON.parse()` and so can only be described as `unknown`.
+ */
+export type ExtractParsedContentFromParams<Params extends TextConfigParams> = ParsedTextFormat<NonNullable<Params['text']>['format']>;
+/**
+ * Adds parsed-output fields to a response, invoking parsers only when its request
+ * includes an auto-parseable text format or strict function tool.
+ */
 export declare function maybeParseResponse<Params extends ResponseCreateParamsBase | null, ParsedT = Params extends null ? null : ExtractParsedContentFromParams<NonNullable<Params>>>(response: Response, params: Params): ParsedResponse<ParsedT>;
+/**
+ * Parses completed response text and strict function-tool arguments.
+ *
+ * Incomplete or nonterminal responses keep their parsed values as `null`, and
+ * `output_parsed` returns the first successfully parsed output-text item.
+ */
 export declare function parseResponse<Params extends ResponseCreateParamsBase, ParsedT = ExtractParsedContentFromParams<Params>>(response: Response, params: Params): ParsedResponse<ParsedT>;
+/** Returns whether the request includes an auto-parseable text format or strict function tool. */
 export declare function hasAutoParseableInput(params: ResponseCreateParamsWithTools): boolean;
+/** Type-level details used to infer a Responses API function tool's parser and callback. */
 type ToolOptions = {
+    /** Model-visible function name used to match generated tool calls. */
     name: string;
+    /** Parsed argument value accepted by the optional execution callback. */
     arguments: any;
+    /** Optional callback metadata associated with the parsed function tool. */
     function?: ((args: any) => any) | undefined;
 };
-export type AutoParseableResponseTool<OptionsT extends ToolOptions, HasFunction = OptionsT['function'] extends Function ? true : false> = FunctionTool & {
+/** A Responses API function tool with an argument parser and optional executable callback. */
+export type AutoParseableResponseTool<OptionsT extends ToolOptions, HasFunction = OptionsT['function'] extends (...args: never[]) => unknown ? true : false> = FunctionTool & {
+    /** Type-only marker for parsed tool arguments; this property does not exist at runtime. */
     __arguments: OptionsT['arguments'];
+    /** Type-only marker for the function name; this property does not exist at runtime. */
     __name: OptionsT['name'];
+    /** Non-enumerable SDK marker identifying a tool with an attached argument parser. */
     $brand: 'auto-parseable-tool';
+    /** Optional callback available to helpers that execute parsed function tools. */
     $callback: ((args: OptionsT['arguments']) => any) | undefined;
+    /** Parses the raw JSON argument string into the function's typed argument value. */
     $parseRaw(args: string): OptionsT['arguments'];
 };
+/** Copies a Responses API function tool and attaches non-enumerable parser and callback metadata. */
 export declare function makeParseableResponseTool<OptionsT extends ToolOptions>(tool: FunctionTool, { parser, callback, }: {
+    /** Converts the raw JSON argument string into the function's typed argument value. */
     parser: (content: string) => OptionsT['arguments'];
+    /** Optional callback available to helpers that execute the parsed function. */
     callback: ((args: any) => any) | undefined;
 }): AutoParseableResponseTool<OptionsT['arguments']>;
+/** Returns whether a Responses API tool carries the SDK's argument-parser marker. */
 export declare function isAutoParsableTool(tool: any): tool is AutoParseableResponseTool<any>;
+/** Returns whether a response function call matches a strict or auto-parseable request tool. */
 export declare function shouldParseToolCall(params: ResponseCreateParamsNonStreaming | null | undefined, toolCall: ResponseFunctionToolCall): boolean;
+/**
+ * Validates that compatible chat completion tools can be automatically parsed.
+ *
+ * @throws {OpenAIError} If a tool is not a function or is missing `strict: true`.
+ */
 export declare function validateInputTools(tools: ChatCompletionTool[] | undefined): void;
+/** Replaces `output_text` with the concatenated text from every response output message. */
 export declare function addOutputText(rsp: Response): void;
 export {};
 //# sourceMappingURL=ResponsesParser.d.ts.map