openai 7.27.0 → 7.30.0

package/lib/beta/agents/tool-dispatcher.js

@@ -0,0 +1,185 @@
+"use strict";
+var _AgentToolDispatcher_instances, _AgentToolDispatcher_handlers, _AgentToolDispatcher_options, _AgentToolDispatcher_sessions, _AgentToolDispatcher_controller, _AgentToolDispatcher_onToolError, _AgentToolDispatcher_result, _AgentToolDispatcher_checkAbort, _AgentToolDispatcher_abortError, _AgentToolDispatcher_wait, _AgentToolDispatcher_submit;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentToolDispatcher = void 0;
+const tslib_1 = require("../../../internal/tslib.js");
+const error_1 = require("../../../core/error.js");
+const headers_1 = require("../../../internal/headers.js");
+const uuid_1 = require("../../../internal/utils/uuid.js");
+const values_1 = require("../../../internal/utils/values.js");
+const tool_output_1 = require("./tool-output.js");
+const tool_stages_1 = require("./tool-stages.js");
+function normalizedOutput(value) {
+    if (value === null) {
+        return null;
+    }
+    if (typeof value === 'string' || (Array.isArray(value) && value.every(tool_output_1.isInputContent))) {
+        return value;
+    }
+    throw new error_1.OpenAIError('Tool output must be text, content, a JSON object, or null');
+}
+// oxlint-disable-next-line anti-slop/no-object-parameters -- The public AgentToolOutput contract accepts arbitrary JSON-serializable object results.
+function toolResult(call, value) {
+    const output = (0, values_1.isObj)(value) ? JSON.stringify(value) : value;
+    // Detect unserializable callback results inside the redacted failure boundary.
+    const serialized = JSON.stringify(output);
+    if (serialized === undefined) {
+        throw new error_1.OpenAIError('Tool output must be JSON serializable');
+    }
+    return {
+        type: 'agent.session.input.tool_result',
+        turn_id: call.turn_id,
+        call_id: call.call_id,
+        success: true,
+        output: normalizedOutput(typeof output === 'string' ? output : JSON.parse(serialized)),
+    };
+}
+/** Shared local function dispatch for creation and follow-up streams. @internal */
+class AgentToolDispatcher {
+    constructor(sessions, handlers, controller, options, onToolError) {
+        _AgentToolDispatcher_instances.add(this);
+        _AgentToolDispatcher_handlers.set(this, void 0);
+        _AgentToolDispatcher_options.set(this, void 0);
+        _AgentToolDispatcher_sessions.set(this, void 0);
+        _AgentToolDispatcher_controller.set(this, void 0);
+        _AgentToolDispatcher_onToolError.set(this, void 0);
+        tslib_1.__classPrivateFieldSet(this, _AgentToolDispatcher_sessions, sessions, "f");
+        tslib_1.__classPrivateFieldSet(this, _AgentToolDispatcher_controller, controller, "f");
+        tslib_1.__classPrivateFieldSet(this, _AgentToolDispatcher_onToolError, onToolError, "f");
+        tslib_1.__classPrivateFieldSet(this, _AgentToolDispatcher_handlers, new Map(Object.entries(handlers)), "f");
+        const headers = (0, headers_1.buildHeaders)([options?.headers]);
+        headers.values.delete('idempotency-key');
+        headers.nulls.delete('idempotency-key');
+        const { idempotencyKey: _key, ...rest } = options ?? {};
+        tslib_1.__classPrivateFieldSet(this, _AgentToolDispatcher_options, { ...rest, headers, signal: controller.signal }, "f");
+    }
+    canHandle(name) {
+        return typeof tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_handlers, "f").get(name) === 'function';
+    }
+    /** Capture routing and arguments before the caller can mutate the yielded event. */
+    prepare(call, sessionID) {
+        const handler = call && tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_handlers, "f").get(call.name);
+        if (!call || typeof handler !== 'function') {
+            return;
+        }
+        if (!sessionID) {
+            throw new error_1.OpenAIError('Tool call received before the session creation event');
+        }
+        const snapshot = structuredClone(call);
+        return async () => {
+            tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_checkAbort).call(this);
+            const result = await tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_result).call(this, snapshot, handler, sessionID);
+            tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_checkAbort).call(this);
+            await tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_submit).call(this, sessionID, result);
+        };
+    }
+}
+exports.AgentToolDispatcher = AgentToolDispatcher;
+_AgentToolDispatcher_handlers = new WeakMap(), _AgentToolDispatcher_options = new WeakMap(), _AgentToolDispatcher_sessions = new WeakMap(), _AgentToolDispatcher_controller = new WeakMap(), _AgentToolDispatcher_onToolError = new WeakMap(), _AgentToolDispatcher_instances = new WeakSet(), _AgentToolDispatcher_result = async function _AgentToolDispatcher_result(call, handler, sessionID) {
+    let stage = 'arguments';
+    try {
+        const args = typeof call.arguments === 'string' ? JSON.parse(call.arguments) : call.arguments;
+        if (!(0, values_1.isObj)(args)) {
+            throw new error_1.OpenAIError('Function arguments must be a JSON object');
+        }
+        stage = 'execution';
+        // SAFETY: Arguments were parsed as JSON and checked to be a non-null non-array object before invoking the handler.
+        const arguments_ = args;
+        const output = await tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_wait).call(this, () => tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_onToolError, "f") && handler[tool_stages_1.toolStages]
+            ? handler(arguments_, (value) => {
+                stage = value;
+            })
+            : handler(arguments_));
+        stage = 'output';
+        return toolResult(call, output);
+    }
+    catch (error) {
+        tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_checkAbort).call(this);
+        if (tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_onToolError, "f")) {
+            const failure = Object.freeze({
+                error,
+                stage,
+                tool_name: call.name,
+                session_id: sessionID,
+                turn_id: call.turn_id,
+                call_id: call.call_id,
+            });
+            try {
+                await tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_wait).call(this, () => tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_onToolError, "f")?.call(this, failure));
+            }
+            catch {
+                // Observers must not prevent the original sanitized tool failure from being submitted.
+                tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_checkAbort).call(this);
+            }
+        }
+        return {
+            type: 'agent.session.input.tool_result',
+            turn_id: call.turn_id,
+            call_id: call.call_id,
+            success: false,
+            error: 'Tool handler failed.',
+        };
+    }
+}, _AgentToolDispatcher_checkAbort = function _AgentToolDispatcher_checkAbort() {
+    if (tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_controller, "f").signal.aborted) {
+        throw tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_abortError).call(this);
+    }
+}, _AgentToolDispatcher_abortError = function _AgentToolDispatcher_abortError() {
+    const error = new error_1.APIUserAbortError();
+    Object.defineProperty(error, 'cause', {
+        value: tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_controller, "f").signal.reason,
+        writable: true,
+        configurable: true,
+    });
+    return error;
+}, _AgentToolDispatcher_wait = async function _AgentToolDispatcher_wait(action) {
+    let onAbort;
+    // oxlint-disable-next-line promise/avoid-new -- Bridge the caller's AbortSignal while a handler or registration delay is pending.
+    const aborted = new Promise((_resolve, reject) => {
+        onAbort = () => reject(tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_abortError).call(this));
+        tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_controller, "f").signal.addEventListener('abort', onAbort, { once: true });
+    });
+    try {
+        tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_checkAbort).call(this);
+        // Capture synchronous throws before racing cancellation, so both promises
+        // always have rejection handlers even if the callback aborts and throws.
+        const invoke = async () => await action();
+        return await Promise.race([invoke(), aborted]);
+    }
+    finally {
+        if (onAbort) {
+            tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_controller, "f").signal.removeEventListener('abort', onAbort);
+        }
+    }
+}, _AgentToolDispatcher_submit = async function _AgentToolDispatcher_submit(sessionID, result, key = (0, uuid_1.uuid4)(), attempt = 0) {
+    tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_checkAbort).call(this);
+    try {
+        await tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_sessions, "f").events.create(sessionID, { events: [result], 'Idempotency-Key': key }, tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_options, "f"));
+    }
+    catch (error) {
+        const delay = [100, 300, 600][attempt];
+        if (delay === undefined ||
+            !(error instanceof error_1.BadRequestError) ||
+            error.code !== 'invalid_request_error' ||
+            !error.error ||
+            !('message' in error.error) ||
+            error.error.message !== `Unknown pending tool call: ${result.call_id}`) {
+            throw error;
+        }
+        let timer;
+        try {
+            await tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_wait).call(this, () => 
+            // oxlint-disable-next-line promise/avoid-new -- Own the registration timer so cancellation clears it promptly.
+            new Promise((resolve) => {
+                timer = setTimeout(resolve, delay);
+            }));
+        }
+        finally {
+            if (timer !== undefined) {
+                clearTimeout(timer);
+            }
+        }
+        await tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_submit).call(this, sessionID, result, key, attempt + 1);
+    }
+};
+//# sourceMappingURL=tool-dispatcher.js.map

package/lib/beta/agents/tool-dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-dispatcher.js","sourceRoot":"","sources":["../../../src/lib/beta/agents/tool-dispatcher.ts"],"names":[],"mappings":"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"}

package/lib/beta/agents/tool-dispatcher.mjs

@@ -0,0 +1,181 @@
+var _AgentToolDispatcher_instances, _AgentToolDispatcher_handlers, _AgentToolDispatcher_options, _AgentToolDispatcher_sessions, _AgentToolDispatcher_controller, _AgentToolDispatcher_onToolError, _AgentToolDispatcher_result, _AgentToolDispatcher_checkAbort, _AgentToolDispatcher_abortError, _AgentToolDispatcher_wait, _AgentToolDispatcher_submit;
+import { __classPrivateFieldGet, __classPrivateFieldSet } from "../../../internal/tslib.mjs";
+import { APIUserAbortError, BadRequestError, OpenAIError } from "../../../core/error.mjs";
+import { buildHeaders } from "../../../internal/headers.mjs";
+import { uuid4 } from "../../../internal/utils/uuid.mjs";
+import { isObj } from "../../../internal/utils/values.mjs";
+import { isInputContent } from "./tool-output.mjs";
+import { toolStages } from "./tool-stages.mjs";
+function normalizedOutput(value) {
+    if (value === null) {
+        return null;
+    }
+    if (typeof value === 'string' || (Array.isArray(value) && value.every(isInputContent))) {
+        return value;
+    }
+    throw new OpenAIError('Tool output must be text, content, a JSON object, or null');
+}
+// oxlint-disable-next-line anti-slop/no-object-parameters -- The public AgentToolOutput contract accepts arbitrary JSON-serializable object results.
+function toolResult(call, value) {
+    const output = isObj(value) ? JSON.stringify(value) : value;
+    // Detect unserializable callback results inside the redacted failure boundary.
+    const serialized = JSON.stringify(output);
+    if (serialized === undefined) {
+        throw new OpenAIError('Tool output must be JSON serializable');
+    }
+    return {
+        type: 'agent.session.input.tool_result',
+        turn_id: call.turn_id,
+        call_id: call.call_id,
+        success: true,
+        output: normalizedOutput(typeof output === 'string' ? output : JSON.parse(serialized)),
+    };
+}
+/** Shared local function dispatch for creation and follow-up streams. @internal */
+export class AgentToolDispatcher {
+    constructor(sessions, handlers, controller, options, onToolError) {
+        _AgentToolDispatcher_instances.add(this);
+        _AgentToolDispatcher_handlers.set(this, void 0);
+        _AgentToolDispatcher_options.set(this, void 0);
+        _AgentToolDispatcher_sessions.set(this, void 0);
+        _AgentToolDispatcher_controller.set(this, void 0);
+        _AgentToolDispatcher_onToolError.set(this, void 0);
+        __classPrivateFieldSet(this, _AgentToolDispatcher_sessions, sessions, "f");
+        __classPrivateFieldSet(this, _AgentToolDispatcher_controller, controller, "f");
+        __classPrivateFieldSet(this, _AgentToolDispatcher_onToolError, onToolError, "f");
+        __classPrivateFieldSet(this, _AgentToolDispatcher_handlers, new Map(Object.entries(handlers)), "f");
+        const headers = buildHeaders([options?.headers]);
+        headers.values.delete('idempotency-key');
+        headers.nulls.delete('idempotency-key');
+        const { idempotencyKey: _key, ...rest } = options ?? {};
+        __classPrivateFieldSet(this, _AgentToolDispatcher_options, { ...rest, headers, signal: controller.signal }, "f");
+    }
+    canHandle(name) {
+        return typeof __classPrivateFieldGet(this, _AgentToolDispatcher_handlers, "f").get(name) === 'function';
+    }
+    /** Capture routing and arguments before the caller can mutate the yielded event. */
+    prepare(call, sessionID) {
+        const handler = call && __classPrivateFieldGet(this, _AgentToolDispatcher_handlers, "f").get(call.name);
+        if (!call || typeof handler !== 'function') {
+            return;
+        }
+        if (!sessionID) {
+            throw new OpenAIError('Tool call received before the session creation event');
+        }
+        const snapshot = structuredClone(call);
+        return async () => {
+            __classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_checkAbort).call(this);
+            const result = await __classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_result).call(this, snapshot, handler, sessionID);
+            __classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_checkAbort).call(this);
+            await __classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_submit).call(this, sessionID, result);
+        };
+    }
+}
+_AgentToolDispatcher_handlers = new WeakMap(), _AgentToolDispatcher_options = new WeakMap(), _AgentToolDispatcher_sessions = new WeakMap(), _AgentToolDispatcher_controller = new WeakMap(), _AgentToolDispatcher_onToolError = new WeakMap(), _AgentToolDispatcher_instances = new WeakSet(), _AgentToolDispatcher_result = async function _AgentToolDispatcher_result(call, handler, sessionID) {
+    let stage = 'arguments';
+    try {
+        const args = typeof call.arguments === 'string' ? JSON.parse(call.arguments) : call.arguments;
+        if (!isObj(args)) {
+            throw new OpenAIError('Function arguments must be a JSON object');
+        }
+        stage = 'execution';
+        // SAFETY: Arguments were parsed as JSON and checked to be a non-null non-array object before invoking the handler.
+        const arguments_ = args;
+        const output = await __classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_wait).call(this, () => __classPrivateFieldGet(this, _AgentToolDispatcher_onToolError, "f") && handler[toolStages]
+            ? handler(arguments_, (value) => {
+                stage = value;
+            })
+            : handler(arguments_));
+        stage = 'output';
+        return toolResult(call, output);
+    }
+    catch (error) {
+        __classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_checkAbort).call(this);
+        if (__classPrivateFieldGet(this, _AgentToolDispatcher_onToolError, "f")) {
+            const failure = Object.freeze({
+                error,
+                stage,
+                tool_name: call.name,
+                session_id: sessionID,
+                turn_id: call.turn_id,
+                call_id: call.call_id,
+            });
+            try {
+                await __classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_wait).call(this, () => __classPrivateFieldGet(this, _AgentToolDispatcher_onToolError, "f")?.call(this, failure));
+            }
+            catch {
+                // Observers must not prevent the original sanitized tool failure from being submitted.
+                __classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_checkAbort).call(this);
+            }
+        }
+        return {
+            type: 'agent.session.input.tool_result',
+            turn_id: call.turn_id,
+            call_id: call.call_id,
+            success: false,
+            error: 'Tool handler failed.',
+        };
+    }
+}, _AgentToolDispatcher_checkAbort = function _AgentToolDispatcher_checkAbort() {
+    if (__classPrivateFieldGet(this, _AgentToolDispatcher_controller, "f").signal.aborted) {
+        throw __classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_abortError).call(this);
+    }
+}, _AgentToolDispatcher_abortError = function _AgentToolDispatcher_abortError() {
+    const error = new APIUserAbortError();
+    Object.defineProperty(error, 'cause', {
+        value: __classPrivateFieldGet(this, _AgentToolDispatcher_controller, "f").signal.reason,
+        writable: true,
+        configurable: true,
+    });
+    return error;
+}, _AgentToolDispatcher_wait = async function _AgentToolDispatcher_wait(action) {
+    let onAbort;
+    // oxlint-disable-next-line promise/avoid-new -- Bridge the caller's AbortSignal while a handler or registration delay is pending.
+    const aborted = new Promise((_resolve, reject) => {
+        onAbort = () => reject(__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_abortError).call(this));
+        __classPrivateFieldGet(this, _AgentToolDispatcher_controller, "f").signal.addEventListener('abort', onAbort, { once: true });
+    });
+    try {
+        __classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_checkAbort).call(this);
+        // Capture synchronous throws before racing cancellation, so both promises
+        // always have rejection handlers even if the callback aborts and throws.
+        const invoke = async () => await action();
+        return await Promise.race([invoke(), aborted]);
+    }
+    finally {
+        if (onAbort) {
+            __classPrivateFieldGet(this, _AgentToolDispatcher_controller, "f").signal.removeEventListener('abort', onAbort);
+        }
+    }
+}, _AgentToolDispatcher_submit = async function _AgentToolDispatcher_submit(sessionID, result, key = uuid4(), attempt = 0) {
+    __classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_checkAbort).call(this);
+    try {
+        await __classPrivateFieldGet(this, _AgentToolDispatcher_sessions, "f").events.create(sessionID, { events: [result], 'Idempotency-Key': key }, __classPrivateFieldGet(this, _AgentToolDispatcher_options, "f"));
+    }
+    catch (error) {
+        const delay = [100, 300, 600][attempt];
+        if (delay === undefined ||
+            !(error instanceof BadRequestError) ||
+            error.code !== 'invalid_request_error' ||
+            !error.error ||
+            !('message' in error.error) ||
+            error.error.message !== `Unknown pending tool call: ${result.call_id}`) {
+            throw error;
+        }
+        let timer;
+        try {
+            await __classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_wait).call(this, () => 
+            // oxlint-disable-next-line promise/avoid-new -- Own the registration timer so cancellation clears it promptly.
+            new Promise((resolve) => {
+                timer = setTimeout(resolve, delay);
+            }));
+        }
+        finally {
+            if (timer !== undefined) {
+                clearTimeout(timer);
+            }
+        }
+        await __classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_submit).call(this, sessionID, result, key, attempt + 1);
+    }
+};
+//# sourceMappingURL=tool-dispatcher.mjs.map

package/lib/beta/agents/tool-dispatcher.mjs.map

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

package/lib/beta/agents/tool-error.d.mts

@@ -0,0 +1,13 @@
+/**
+ * Beta diagnostic for logging or monitoring failures from local `toolHandlers`.
+ * The original error is local only; API and transport failures propagate separately.
+ */
+export interface AgentToolError {
+    readonly error: unknown;
+    readonly tool_name: string;
+    readonly session_id: string;
+    readonly turn_id: string;
+    readonly call_id: string;
+    readonly stage: 'arguments' | 'execution' | 'output';
+}
+//# sourceMappingURL=tool-error.d.mts.map

package/lib/beta/agents/tool-error.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-error.d.mts","sourceRoot":"","sources":["../../../src/lib/beta/agents/tool-error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;CACtD"}

package/lib/beta/agents/tool-error.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Beta diagnostic for logging or monitoring failures from local `toolHandlers`.
+ * The original error is local only; API and transport failures propagate separately.
+ */
+export interface AgentToolError {
+    readonly error: unknown;
+    readonly tool_name: string;
+    readonly session_id: string;
+    readonly turn_id: string;
+    readonly call_id: string;
+    readonly stage: 'arguments' | 'execution' | 'output';
+}
+//# sourceMappingURL=tool-error.d.ts.map

package/lib/beta/agents/tool-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-error.d.ts","sourceRoot":"","sources":["../../../src/lib/beta/agents/tool-error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;CACtD"}

package/lib/beta/agents/tool-error.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=tool-error.js.map

package/lib/beta/agents/tool-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-error.js","sourceRoot":"","sources":["../../../src/lib/beta/agents/tool-error.ts"],"names":[],"mappings":""}

package/lib/beta/agents/tool-error.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tool-error.mjs.map

package/lib/beta/agents/tool-error.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-error.mjs","sourceRoot":"","sources":["../../../src/lib/beta/agents/tool-error.ts"],"names":[],"mappings":""}

package/lib/beta/agents/tool-stages.d.mts

@@ -0,0 +1,12 @@
+import type { AgentToolHandler } from "../../agents/agent-session-stream.mjs";
+import type { AgentToolError } from "./tool-error.mjs";
+/** @internal */
+export declare const toolStages: unique symbol;
+/**
+ * Marks handlers that accept stage updates, including across ESM/CJS imports.
+ * @internal
+ */
+export type StagedToolHandler = ((arguments_: Parameters<AgentToolHandler>[0], setStage?: (stage: AgentToolError['stage']) => void) => ReturnType<AgentToolHandler>) & {
+    [toolStages]?: true;
+};
+//# sourceMappingURL=tool-stages.d.mts.map

package/lib/beta/agents/tool-stages.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-stages.d.mts","sourceRoot":"","sources":["../../../src/lib/beta/agents/tool-stages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,8CAA0C;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,yBAAqB;AAEnD,gBAAgB;AAChB,eAAO,MAAM,UAAU,eAA8C,CAAC;AAEtE;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAC/B,UAAU,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAC3C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,IAAI,KAChD,UAAU,CAAC,gBAAgB,CAAC,CAAC,GAAG;IAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC"}

package/lib/beta/agents/tool-stages.d.ts

@@ -0,0 +1,12 @@
+import type { AgentToolHandler } from "../../agents/agent-session-stream.js";
+import type { AgentToolError } from "./tool-error.js";
+/** @internal */
+export declare const toolStages: unique symbol;
+/**
+ * Marks handlers that accept stage updates, including across ESM/CJS imports.
+ * @internal
+ */
+export type StagedToolHandler = ((arguments_: Parameters<AgentToolHandler>[0], setStage?: (stage: AgentToolError['stage']) => void) => ReturnType<AgentToolHandler>) & {
+    [toolStages]?: true;
+};
+//# sourceMappingURL=tool-stages.d.ts.map

package/lib/beta/agents/tool-stages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-stages.d.ts","sourceRoot":"","sources":["../../../src/lib/beta/agents/tool-stages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,6CAA0C;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,wBAAqB;AAEnD,gBAAgB;AAChB,eAAO,MAAM,UAAU,eAA8C,CAAC;AAEtE;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAC/B,UAAU,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAC3C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,IAAI,KAChD,UAAU,CAAC,gBAAgB,CAAC,CAAC,GAAG;IAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC"}

package/lib/beta/agents/tool-stages.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolStages = void 0;
+/** @internal */
+exports.toolStages = Symbol.for('openai.beta.agents.toolStages');
+//# sourceMappingURL=tool-stages.js.map

package/lib/beta/agents/tool-stages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-stages.js","sourceRoot":"","sources":["../../../src/lib/beta/agents/tool-stages.ts"],"names":[],"mappings":";;;AAGA,gBAAgB;AACH,QAAA,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC"}

package/lib/beta/agents/tool-stages.mjs

@@ -0,0 +1,3 @@
+/** @internal */
+export const toolStages = Symbol.for('openai.beta.agents.toolStages');
+//# sourceMappingURL=tool-stages.mjs.map

package/lib/beta/agents/tool-stages.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-stages.mjs","sourceRoot":"","sources":["../../../src/lib/beta/agents/tool-stages.ts"],"names":[],"mappings":"AAGA,gBAAgB;AAChB,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC"}

package/lib/chat-completions/streaming.d.mts

@@ -0,0 +1,11 @@
+import type { Stream } from "../../core/streaming.mjs";
+import type { ChatCompletionChunk } from "../../resources/chat/completions/completions.mjs";
+/** Wire chunks can omit the finish reason, including the final audio expiry update. */
+export type ChatCompletionWireChunk = Omit<ChatCompletionChunk, 'choices'> & {
+    choices: (Omit<ChatCompletionChunk.Choice, 'finish_reason'> & {
+        finish_reason?: ChatCompletionChunk.Choice['finish_reason'];
+    })[];
+};
+export declare function normalizeChatCompletionChunk(chunk: ChatCompletionWireChunk): ChatCompletionChunk;
+export declare function normalizeChatCompletionStream(stream: Stream<ChatCompletionWireChunk>): Stream<ChatCompletionChunk>;
+//# sourceMappingURL=streaming.d.mts.map

package/lib/chat-completions/streaming.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.mts","sourceRoot":"","sources":["../../src/lib/chat-completions/streaming.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,iCAA6B;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,yDAAqD;AAExF,uFAAuF;AACvF,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC,GAAG;IAC3E,OAAO,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG;QAC5D,aAAa,CAAC,EAAE,mBAAmB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;KAC7D,CAAC,EAAE,CAAC;CACN,CAAC;AAEF,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,uBAAuB,GAAG,mBAAmB,CAUhG;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,CAAC,uBAAuB,CAAC,GACtC,MAAM,CAAC,mBAAmB,CAAC,CAU7B"}

package/lib/chat-completions/streaming.d.ts

@@ -0,0 +1,11 @@
+import type { Stream } from "../../core/streaming.js";
+import type { ChatCompletionChunk } from "../../resources/chat/completions/completions.js";
+/** Wire chunks can omit the finish reason, including the final audio expiry update. */
+export type ChatCompletionWireChunk = Omit<ChatCompletionChunk, 'choices'> & {
+    choices: (Omit<ChatCompletionChunk.Choice, 'finish_reason'> & {
+        finish_reason?: ChatCompletionChunk.Choice['finish_reason'];
+    })[];
+};
+export declare function normalizeChatCompletionChunk(chunk: ChatCompletionWireChunk): ChatCompletionChunk;
+export declare function normalizeChatCompletionStream(stream: Stream<ChatCompletionWireChunk>): Stream<ChatCompletionChunk>;
+//# sourceMappingURL=streaming.d.ts.map

package/lib/chat-completions/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../src/lib/chat-completions/streaming.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,gCAA6B;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,wDAAqD;AAExF,uFAAuF;AACvF,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC,GAAG;IAC3E,OAAO,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG;QAC5D,aAAa,CAAC,EAAE,mBAAmB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;KAC7D,CAAC,EAAE,CAAC;CACN,CAAC;AAEF,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,uBAAuB,GAAG,mBAAmB,CAUhG;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,CAAC,uBAAuB,CAAC,GACtC,MAAM,CAAC,mBAAmB,CAAC,CAU7B"}

package/lib/chat-completions/streaming.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeChatCompletionChunk = normalizeChatCompletionChunk;
+exports.normalizeChatCompletionStream = normalizeChatCompletionStream;
+function normalizeChatCompletionChunk(chunk) {
+    if (!Array.isArray(chunk?.choices)) {
+        // SAFETY: This is an opaque provider record, with no choices to normalize.
+        // Preserve the existing SSE pass-through; the SDK does not validate these records.
+        return chunk;
+    }
+    return {
+        ...chunk,
+        choices: chunk.choices.map((choice) => ({ ...choice, finish_reason: choice.finish_reason ?? null })),
+    };
+}
+function normalizeChatCompletionStream(stream) {
+    const iterator = stream[Symbol.asyncIterator].bind(stream);
+    stream[Symbol.asyncIterator] = async function* normalizedChunks() {
+        const source = { [Symbol.asyncIterator]: iterator };
+        for await (const chunk of source) {
+            yield normalizeChatCompletionChunk(chunk);
+        }
+    };
+    // SAFETY: The installed iterator normalizes every wire chunk before exposing it.
+    return stream;
+}
+//# sourceMappingURL=streaming.js.map

package/lib/chat-completions/streaming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.js","sourceRoot":"","sources":["../../src/lib/chat-completions/streaming.ts"],"names":[],"mappings":";;AAUA,oEAUC;AAED,sEAYC;AAxBD,SAAgB,4BAA4B,CAAC,KAA8B;IACzE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;QACnC,2EAA2E;QAC3E,mFAAmF;QACnF,OAAO,KAA4B,CAAC;IACtC,CAAC;IACD,OAAO;QACL,GAAG,KAAK;QACR,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,IAAI,EAAE,CAAC,CAAC;KACrG,CAAC;AACJ,CAAC;AAED,SAAgB,6BAA6B,CAC3C,MAAuC;IAEvC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3D,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,gBAAgB;QAC7D,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,CAAC;QACpD,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACjC,MAAM,4BAA4B,CAAC,KAAK,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC,CAAC;IACF,iFAAiF;IACjF,OAAO,MAAqC,CAAC;AAC/C,CAAC"}

package/lib/chat-completions/streaming.mjs

@@ -0,0 +1,23 @@
+export function normalizeChatCompletionChunk(chunk) {
+    if (!Array.isArray(chunk?.choices)) {
+        // SAFETY: This is an opaque provider record, with no choices to normalize.
+        // Preserve the existing SSE pass-through; the SDK does not validate these records.
+        return chunk;
+    }
+    return {
+        ...chunk,
+        choices: chunk.choices.map((choice) => ({ ...choice, finish_reason: choice.finish_reason ?? null })),
+    };
+}
+export function normalizeChatCompletionStream(stream) {
+    const iterator = stream[Symbol.asyncIterator].bind(stream);
+    stream[Symbol.asyncIterator] = async function* normalizedChunks() {
+        const source = { [Symbol.asyncIterator]: iterator };
+        for await (const chunk of source) {
+            yield normalizeChatCompletionChunk(chunk);
+        }
+    };
+    // SAFETY: The installed iterator normalizes every wire chunk before exposing it.
+    return stream;
+}
+//# sourceMappingURL=streaming.mjs.map

package/lib/chat-completions/streaming.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.mjs","sourceRoot":"","sources":["../../src/lib/chat-completions/streaming.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,4BAA4B,CAAC,KAA8B;IACzE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;QACnC,2EAA2E;QAC3E,mFAAmF;QACnF,OAAO,KAA4B,CAAC;IACtC,CAAC;IACD,OAAO;QACL,GAAG,KAAK;QACR,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,IAAI,EAAE,CAAC,CAAC;KACrG,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,MAAuC;IAEvC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3D,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,gBAAgB;QAC7D,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,CAAC;QACpD,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACjC,MAAM,4BAA4B,CAAC,KAAK,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC,CAAC;IACF,iFAAiF;IACjF,OAAO,MAAqC,CAAC;AAC/C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openai",
-  "version": "7.27.0",
+  "version": "7.30.0",
   "description": "The official TypeScript library for the OpenAI API",
   "author": "OpenAI <support@openai.com>",
   "types": "./index.d.ts",