openai 7.25.0 → 7.27.0

package/helpers/beta/agents/filesystem.d.ts

@@ -0,0 +1,17 @@
+import type { WritableStream as AgentWritableStream } from "../../../internal/shim-types.js";
+import type { StreamingFile } from "../../../internal/uploads.js";
+import type { RequestOptions } from "../../../internal/request-options.js";
+import type { Files } from "../../../resources/beta/agents/environments/files.js";
+import type { PreparedAgentFiles } from "../../../lib/beta/agents/files.js";
+/** Beta, Node.js: select an application-owned file in a stable directory for a lazy upload. */
+export declare function agentFile(path: string): Promise<StreamingFile & {
+    size: number;
+}>;
+/** Beta, Node.js: prepare explicit files from a stable application-owned directory once. */
+export declare function prepareAgentDirectory(resource: Files, directory: string, params: {
+    include: readonly string[];
+    to?: string;
+}, options?: RequestOptions): Promise<PreparedAgentFiles>;
+/** Beta, Node.js: an application-owned safe path in a stable directory, opened lazily for a download. */
+export declare function agentFileDestination(path: string): AgentWritableStream<Uint8Array>;
+//# sourceMappingURL=filesystem.d.ts.map

package/helpers/beta/agents/filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../../src/helpers/beta/agents/filesystem.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,IAAI,mBAAmB,EAAE,wCAAqC;AAM1F,OAAO,KAAK,EAAE,aAAa,EAAE,qCAAkC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,6CAA0C;AACxE,OAAO,KAAK,EAAE,KAAK,EAAE,6DAA0D;AAC/E,OAAO,KAAK,EAAE,kBAAkB,EAAE,0CAAuC;AA2EzE,+FAA+F;AAC/F,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAEvF;AAED,4FAA4F;AAC5F,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,KAAK,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE;IAAE,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,EACnD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,kBAAkB,CAAC,CAwB7B;AAED,yGAAyG;AACzG,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAAC,UAAU,CAAC,CA8DlF"}

package/helpers/beta/agents/filesystem.js

@@ -0,0 +1,168 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentFile = agentFile;
+exports.prepareAgentDirectory = prepareAgentDirectory;
+exports.agentFileDestination = agentFileDestination;
+const tslib_1 = require("../../../internal/tslib.js");
+const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
+const error_1 = require("../../../core/error.js");
+const uploads_1 = require("../../../internal/uploads.js");
+async function checkedPath(path, boundary) {
+    const absolute = node_path_1.default.resolve(path);
+    const root = boundary ?? node_path_1.default.dirname(absolute);
+    let current = root;
+    let selected;
+    for (const component of node_path_1.default.relative(root, absolute).split(node_path_1.default.sep)) {
+        current = node_path_1.default.join(current, component);
+        // oxlint-disable-next-line no-await-in-loop -- Check each ancestor before following the next path component.
+        const info = await (0, promises_1.lstat)(current);
+        selected = info;
+        if (info.isSymbolicLink()) {
+            throw new error_1.OpenAIError('Agent file sources cannot contain symbolic links');
+        }
+    }
+    const resolved = await (0, promises_1.realpath)(absolute);
+    const info = await (0, promises_1.lstat)(resolved);
+    const relative = boundary ? node_path_1.default.relative(boundary, resolved) : '';
+    if (!selected ||
+        selected.dev !== info.dev ||
+        selected.ino !== info.ino ||
+        selected.size !== info.size ||
+        (boundary &&
+            (relative === '..' || relative.startsWith(`..${node_path_1.default.sep}`) || node_path_1.default.isAbsolute(relative)))) {
+        throw new error_1.OpenAIError('Selected agent file changed while resolving its path');
+    }
+    return { path: resolved, info: selected };
+}
+function selectedAgentFile({ path: absolute, info, }) {
+    if (!info.isFile()) {
+        throw new error_1.OpenAIError('Agent file sources must be regular files');
+    }
+    async function* bytes() {
+        // oxlint-disable-next-line no-bitwise -- Combine native filesystem open flags.
+        const handle = await (0, promises_1.open)(absolute, node_fs_1.constants.O_RDONLY | node_fs_1.constants.O_NOFOLLOW);
+        try {
+            const current = await handle.stat();
+            if (!current.isFile() ||
+                current.dev !== info.dev ||
+                current.ino !== info.ino ||
+                current.size !== info.size) {
+                throw new error_1.OpenAIError('Selected agent file changed before upload');
+            }
+            let received = 0;
+            if (info.size > 0) {
+                for await (const chunk of handle.createReadStream({ autoClose: false, end: info.size - 1 })) {
+                    received += chunk.length;
+                    yield chunk;
+                }
+            }
+            const finalInfo = await handle.stat();
+            if (received !== info.size || finalInfo.size !== info.size) {
+                throw new error_1.OpenAIError('Selected agent file changed while uploading');
+            }
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    return Object.assign((0, uploads_1.toStreamingFile)({ [Symbol.asyncIterator]: bytes }, node_path_1.default.basename(absolute)), {
+        size: info.size,
+    });
+}
+/** Beta, Node.js: select an application-owned file in a stable directory for a lazy upload. */
+async function agentFile(path) {
+    return selectedAgentFile(await checkedPath(path));
+}
+/** Beta, Node.js: prepare explicit files from a stable application-owned directory once. */
+async function prepareAgentDirectory(resource, directory, params, options) {
+    const include = [...params.include];
+    const destination = params.to ?? '/workspace';
+    const { path: root, info: rootInfo } = await checkedPath(directory);
+    if (!rootInfo.isDirectory()) {
+        throw new error_1.OpenAIError('Expected a directory');
+    }
+    const selected = {};
+    const seen = new Set();
+    for (const relative of include) {
+        if (relative.includes('\\') ||
+            relative.includes('\0') ||
+            relative.split('/').some((part) => part === '' || part === '.' || part === '..') ||
+            seen.has(relative)) {
+            throw new error_1.OpenAIError('Directory selections must be unique relative file paths');
+        }
+        seen.add(relative);
+        // oxlint-disable-next-line no-await-in-loop -- Prepare each explicitly selected source before any upload begins.
+        const source = await checkedPath(node_path_1.default.join(root, relative), root);
+        selected[`${destination}/${relative}`] = selectedAgentFile(source);
+    }
+    return resource.prepare(selected, options);
+}
+/** Beta, Node.js: an application-owned safe path in a stable directory, opened lazily for a download. */
+function agentFileDestination(path) {
+    const absolute = node_path_1.default.resolve(path);
+    let handle;
+    const close = async () => {
+        await handle?.close();
+        handle = undefined;
+    };
+    const file = async () => {
+        if (handle) {
+            return handle;
+        }
+        let expected;
+        try {
+            expected = await (0, promises_1.lstat)(absolute);
+        }
+        catch (error) {
+            if (!(error instanceof Error && 'code' in error && error.code === 'ENOENT')) {
+                throw error;
+            }
+        }
+        if (expected && !expected.isFile()) {
+            throw new error_1.OpenAIError('Agent artifact destinations must be regular files');
+        }
+        // Never truncate before verifying the opened entry. Exclusive creation also rejects dangling links.
+        /* oxlint-disable no-bitwise -- Combine native flags; identity validation also covers Windows. */
+        const flags = node_fs_1.constants.O_WRONLY |
+            (node_fs_1.constants.O_NOFOLLOW ?? 0) |
+            (node_fs_1.constants.O_NONBLOCK ?? 0) |
+            (expected ? 0 : node_fs_1.constants.O_CREAT | node_fs_1.constants.O_EXCL);
+        /* oxlint-enable no-bitwise */
+        const opened = await (0, promises_1.open)(absolute, flags);
+        try {
+            const current = await opened.stat();
+            if (!current.isFile() || (expected && (current.dev !== expected.dev || current.ino !== expected.ino))) {
+                throw new error_1.OpenAIError('Agent artifact destination changed before opening');
+            }
+            await opened.truncate(0);
+            handle = opened;
+            return handle;
+        }
+        catch (error) {
+            await opened.close();
+            throw error;
+        }
+    };
+    return new WritableStream({
+        async write(chunk) {
+            try {
+                const target = await file();
+                await target.writeFile(chunk);
+            }
+            catch (error) {
+                await close();
+                throw error;
+            }
+        },
+        async close() {
+            await file();
+            await close();
+        },
+        async abort() {
+            await close();
+        },
+    });
+}
+//# sourceMappingURL=filesystem.js.map

package/helpers/beta/agents/filesystem.js.map

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

package/helpers/beta/agents/filesystem.mjs

@@ -0,0 +1,162 @@
+import { constants } from 'node:fs';
+import { lstat, open, realpath } from 'node:fs/promises';
+import nodePath from 'node:path';
+import { OpenAIError } from "../../../core/error.mjs";
+import { toStreamingFile } from "../../../internal/uploads.mjs";
+async function checkedPath(path, boundary) {
+    const absolute = nodePath.resolve(path);
+    const root = boundary ?? nodePath.dirname(absolute);
+    let current = root;
+    let selected;
+    for (const component of nodePath.relative(root, absolute).split(nodePath.sep)) {
+        current = nodePath.join(current, component);
+        // oxlint-disable-next-line no-await-in-loop -- Check each ancestor before following the next path component.
+        const info = await lstat(current);
+        selected = info;
+        if (info.isSymbolicLink()) {
+            throw new OpenAIError('Agent file sources cannot contain symbolic links');
+        }
+    }
+    const resolved = await realpath(absolute);
+    const info = await lstat(resolved);
+    const relative = boundary ? nodePath.relative(boundary, resolved) : '';
+    if (!selected ||
+        selected.dev !== info.dev ||
+        selected.ino !== info.ino ||
+        selected.size !== info.size ||
+        (boundary &&
+            (relative === '..' || relative.startsWith(`..${nodePath.sep}`) || nodePath.isAbsolute(relative)))) {
+        throw new OpenAIError('Selected agent file changed while resolving its path');
+    }
+    return { path: resolved, info: selected };
+}
+function selectedAgentFile({ path: absolute, info, }) {
+    if (!info.isFile()) {
+        throw new OpenAIError('Agent file sources must be regular files');
+    }
+    async function* bytes() {
+        // oxlint-disable-next-line no-bitwise -- Combine native filesystem open flags.
+        const handle = await open(absolute, constants.O_RDONLY | constants.O_NOFOLLOW);
+        try {
+            const current = await handle.stat();
+            if (!current.isFile() ||
+                current.dev !== info.dev ||
+                current.ino !== info.ino ||
+                current.size !== info.size) {
+                throw new OpenAIError('Selected agent file changed before upload');
+            }
+            let received = 0;
+            if (info.size > 0) {
+                for await (const chunk of handle.createReadStream({ autoClose: false, end: info.size - 1 })) {
+                    received += chunk.length;
+                    yield chunk;
+                }
+            }
+            const finalInfo = await handle.stat();
+            if (received !== info.size || finalInfo.size !== info.size) {
+                throw new OpenAIError('Selected agent file changed while uploading');
+            }
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    return Object.assign(toStreamingFile({ [Symbol.asyncIterator]: bytes }, nodePath.basename(absolute)), {
+        size: info.size,
+    });
+}
+/** Beta, Node.js: select an application-owned file in a stable directory for a lazy upload. */
+export async function agentFile(path) {
+    return selectedAgentFile(await checkedPath(path));
+}
+/** Beta, Node.js: prepare explicit files from a stable application-owned directory once. */
+export async function prepareAgentDirectory(resource, directory, params, options) {
+    const include = [...params.include];
+    const destination = params.to ?? '/workspace';
+    const { path: root, info: rootInfo } = await checkedPath(directory);
+    if (!rootInfo.isDirectory()) {
+        throw new OpenAIError('Expected a directory');
+    }
+    const selected = {};
+    const seen = new Set();
+    for (const relative of include) {
+        if (relative.includes('\\') ||
+            relative.includes('\0') ||
+            relative.split('/').some((part) => part === '' || part === '.' || part === '..') ||
+            seen.has(relative)) {
+            throw new OpenAIError('Directory selections must be unique relative file paths');
+        }
+        seen.add(relative);
+        // oxlint-disable-next-line no-await-in-loop -- Prepare each explicitly selected source before any upload begins.
+        const source = await checkedPath(nodePath.join(root, relative), root);
+        selected[`${destination}/${relative}`] = selectedAgentFile(source);
+    }
+    return resource.prepare(selected, options);
+}
+/** Beta, Node.js: an application-owned safe path in a stable directory, opened lazily for a download. */
+export function agentFileDestination(path) {
+    const absolute = nodePath.resolve(path);
+    let handle;
+    const close = async () => {
+        await handle?.close();
+        handle = undefined;
+    };
+    const file = async () => {
+        if (handle) {
+            return handle;
+        }
+        let expected;
+        try {
+            expected = await lstat(absolute);
+        }
+        catch (error) {
+            if (!(error instanceof Error && 'code' in error && error.code === 'ENOENT')) {
+                throw error;
+            }
+        }
+        if (expected && !expected.isFile()) {
+            throw new OpenAIError('Agent artifact destinations must be regular files');
+        }
+        // Never truncate before verifying the opened entry. Exclusive creation also rejects dangling links.
+        /* oxlint-disable no-bitwise -- Combine native flags; identity validation also covers Windows. */
+        const flags = constants.O_WRONLY |
+            (constants.O_NOFOLLOW ?? 0) |
+            (constants.O_NONBLOCK ?? 0) |
+            (expected ? 0 : constants.O_CREAT | constants.O_EXCL);
+        /* oxlint-enable no-bitwise */
+        const opened = await open(absolute, flags);
+        try {
+            const current = await opened.stat();
+            if (!current.isFile() || (expected && (current.dev !== expected.dev || current.ino !== expected.ino))) {
+                throw new OpenAIError('Agent artifact destination changed before opening');
+            }
+            await opened.truncate(0);
+            handle = opened;
+            return handle;
+        }
+        catch (error) {
+            await opened.close();
+            throw error;
+        }
+    };
+    return new WritableStream({
+        async write(chunk) {
+            try {
+                const target = await file();
+                await target.writeFile(chunk);
+            }
+            catch (error) {
+                await close();
+                throw error;
+            }
+        },
+        async close() {
+            await file();
+            await close();
+        },
+        async abort() {
+            await close();
+        },
+    });
+}
+//# sourceMappingURL=filesystem.mjs.map

package/helpers/beta/agents/filesystem.mjs.map

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

package/helpers/beta/agents/standard-schema.d.mts

@@ -0,0 +1,7 @@
+import { standardTextFormat } from "../../standard-schema.mjs";
+import type { JSONSchema } from "../../../lib/jsonschema.mjs";
+/** Beta: bind a synchronous Standard Schema validator to Agents output. */
+export declare function standardAgentTextFormat<S extends Parameters<typeof standardTextFormat>[0]>(schema: S, jsonSchema?: JSONSchema): import("../../../lib/beta/agents/output-format-types.mjs").AgentOutputFormat<[NonNullable<S["~standard"]["types"]>] extends [never] ? unknown : NonNullable<S["~standard"]["types"]> extends {
+    readonly output: infer Output;
+} ? Output : unknown>;
+//# sourceMappingURL=standard-schema.d.mts.map

package/helpers/beta/agents/standard-schema.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-schema.d.mts","sourceRoot":"","sources":["../../../src/helpers/beta/agents/standard-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,kCAA8B;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,oCAAgC;AAG1D,2EAA2E;AAC3E,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAC,EACxF,MAAM,EAAE,CAAC,EACT,UAAU,CAAC,EAAE,UAAU;;sBAKxB"}

package/helpers/beta/agents/standard-schema.d.ts

@@ -0,0 +1,7 @@
+import { standardTextFormat } from "../../standard-schema.js";
+import type { JSONSchema } from "../../../lib/jsonschema.js";
+/** Beta: bind a synchronous Standard Schema validator to Agents output. */
+export declare function standardAgentTextFormat<S extends Parameters<typeof standardTextFormat>[0]>(schema: S, jsonSchema?: JSONSchema): import("../../../lib/beta/agents/output-format-types.js").AgentOutputFormat<[NonNullable<S["~standard"]["types"]>] extends [never] ? unknown : NonNullable<S["~standard"]["types"]> extends {
+    readonly output: infer Output;
+} ? Output : unknown>;
+//# sourceMappingURL=standard-schema.d.ts.map

package/helpers/beta/agents/standard-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-schema.d.ts","sourceRoot":"","sources":["../../../src/helpers/beta/agents/standard-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,iCAA8B;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,mCAAgC;AAG1D,2EAA2E;AAC3E,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAC,EACxF,MAAM,EAAE,CAAC,EACT,UAAU,CAAC,EAAE,UAAU;;sBAKxB"}

package/helpers/beta/agents/standard-schema.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.standardAgentTextFormat = standardAgentTextFormat;
+const standard_schema_1 = require("../../standard-schema.js");
+const output_format_1 = require("../../../lib/beta/agents/output-format.js");
+/** Beta: bind a synchronous Standard Schema validator to Agents output. */
+function standardAgentTextFormat(schema, jsonSchema) {
+    const format = (0, standard_schema_1.standardTextFormat)(schema, 'agent_output', { schema: jsonSchema });
+    // SAFETY: The native Responses helper owns Standard Schema conversion and validation.
+    return (0, output_format_1.agentOutputFormat)(format.schema, format.$parseRaw);
+}
+//# sourceMappingURL=standard-schema.js.map

package/helpers/beta/agents/standard-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-schema.js","sourceRoot":"","sources":["../../../src/helpers/beta/agents/standard-schema.ts"],"names":[],"mappings":";;AAKA,0DAOC;AAZD,8DAA2D;AAE3D,6EAA2E;AAE3E,2EAA2E;AAC3E,SAAgB,uBAAuB,CACrC,MAAS,EACT,UAAuB;IAEvB,MAAM,MAAM,GAAG,IAAA,oCAAkB,EAAC,MAAM,EAAE,cAAc,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IAClF,sFAAsF;IACtF,OAAO,IAAA,iCAAiB,EAAC,MAAM,CAAC,MAAoB,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;AAC1E,CAAC"}

package/helpers/beta/agents/standard-schema.mjs

@@ -0,0 +1,9 @@
+import { standardTextFormat } from "../../standard-schema.mjs";
+import { agentOutputFormat } from "../../../lib/beta/agents/output-format.mjs";
+/** Beta: bind a synchronous Standard Schema validator to Agents output. */
+export function standardAgentTextFormat(schema, jsonSchema) {
+    const format = standardTextFormat(schema, 'agent_output', { schema: jsonSchema });
+    // SAFETY: The native Responses helper owns Standard Schema conversion and validation.
+    return agentOutputFormat(format.schema, format.$parseRaw);
+}
+//# sourceMappingURL=standard-schema.mjs.map

package/helpers/beta/agents/standard-schema.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-schema.mjs","sourceRoot":"","sources":["../../../src/helpers/beta/agents/standard-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,kCAA8B;AAE3D,OAAO,EAAE,iBAAiB,EAAE,mDAA+C;AAE3E,2EAA2E;AAC3E,MAAM,UAAU,uBAAuB,CACrC,MAAS,EACT,UAAuB;IAEvB,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IAClF,sFAAsF;IACtF,OAAO,iBAAiB,CAAC,MAAM,CAAC,MAAoB,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;AAC1E,CAAC"}

package/helpers/beta/agents/zod.d.mts

@@ -0,0 +1,10 @@
+import { zodTextFormat } from "../../zod.mjs";
+/** Beta: bind a Zod v3/v4/Mini schema to an Agents text format and completed result. */
+export declare function zodAgentTextFormat<S extends Parameters<typeof zodTextFormat>[0]>(schema: S): import("../../../lib/beta/agents/output-format-types.mjs").AgentOutputFormat<S extends {
+    _output: infer Output;
+} ? Output : S extends {
+    _zod: {
+        output: infer Output_1;
+    };
+} ? Output_1 : never>;
+//# sourceMappingURL=zod.d.mts.map

package/helpers/beta/agents/zod.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.d.mts","sourceRoot":"","sources":["../../../src/helpers/beta/agents/zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,sBAAkB;AAI1C,wFAAwF;AACxF,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;;;;;;sBAI1F"}

package/helpers/beta/agents/zod.d.ts

@@ -0,0 +1,10 @@
+import { zodTextFormat } from "../../zod.js";
+/** Beta: bind a Zod v3/v4/Mini schema to an Agents text format and completed result. */
+export declare function zodAgentTextFormat<S extends Parameters<typeof zodTextFormat>[0]>(schema: S): import("../../../lib/beta/agents/output-format-types.js").AgentOutputFormat<S extends {
+    _output: infer Output;
+} ? Output : S extends {
+    _zod: {
+        output: infer Output_1;
+    };
+} ? Output_1 : never>;
+//# sourceMappingURL=zod.d.ts.map

package/helpers/beta/agents/zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../../../src/helpers/beta/agents/zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,qBAAkB;AAI1C,wFAAwF;AACxF,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;;;;;;sBAI1F"}

package/helpers/beta/agents/zod.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.zodAgentTextFormat = zodAgentTextFormat;
+const zod_1 = require("../../zod.js");
+const output_format_1 = require("../../../lib/beta/agents/output-format.js");
+/** Beta: bind a Zod v3/v4/Mini schema to an Agents text format and completed result. */
+function zodAgentTextFormat(schema) {
+    const format = (0, zod_1.zodTextFormat)(schema, 'agent_output');
+    // SAFETY: The native Responses helper owns Zod schema conversion and validation.
+    return (0, output_format_1.agentOutputFormat)(format.schema, format.$parseRaw);
+}
+//# sourceMappingURL=zod.js.map

package/helpers/beta/agents/zod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.js","sourceRoot":"","sources":["../../../src/helpers/beta/agents/zod.ts"],"names":[],"mappings":";;AAKA,gDAIC;AATD,sCAA0C;AAE1C,6EAA2E;AAE3E,wFAAwF;AACxF,SAAgB,kBAAkB,CAAgD,MAAS;IACzF,MAAM,MAAM,GAAG,IAAA,mBAAa,EAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACrD,iFAAiF;IACjF,OAAO,IAAA,iCAAiB,EAAC,MAAM,CAAC,MAAoB,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;AAC1E,CAAC"}

package/helpers/beta/agents/zod.mjs

@@ -0,0 +1,9 @@
+import { zodTextFormat } from "../../zod.mjs";
+import { agentOutputFormat } from "../../../lib/beta/agents/output-format.mjs";
+/** Beta: bind a Zod v3/v4/Mini schema to an Agents text format and completed result. */
+export function zodAgentTextFormat(schema) {
+    const format = zodTextFormat(schema, 'agent_output');
+    // SAFETY: The native Responses helper owns Zod schema conversion and validation.
+    return agentOutputFormat(format.schema, format.$parseRaw);
+}
+//# sourceMappingURL=zod.mjs.map

package/helpers/beta/agents/zod.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.mjs","sourceRoot":"","sources":["../../../src/helpers/beta/agents/zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,sBAAkB;AAE1C,OAAO,EAAE,iBAAiB,EAAE,mDAA+C;AAE3E,wFAAwF;AACxF,MAAM,UAAU,kBAAkB,CAAgD,MAAS;IACzF,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACrD,iFAAiF;IACjF,OAAO,iBAAiB,CAAC,MAAM,CAAC,MAAoB,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;AAC1E,CAAC"}

package/internal/realtime-credentials.d.mts

@@ -1,4 +1,23 @@
 import type { OpenAI } from "../client.mjs";
+export interface DeferredAPIKeyCache {
+    client: Pick<OpenAI, 'apiKey'>;
+    providerKey?: string;
+    commit: () => string | null;
+}
+interface RealtimeAPIKeyCacheContext {
+    run: <T>(cache: DeferredAPIKeyCache | undefined, operation: () => T) => T;
+    getStore: () => DeferredAPIKeyCache | undefined;
+}
+declare const realtimeCacheContext: unique symbol;
+type CredentialClient = Pick<OpenAI, 'apiKey'> & {
+    [realtimeCacheContext]?: RealtimeAPIKeyCacheContext;
+};
+/** Installs the Node transport's invocation context without loading Node in the base client. @internal */
+export declare function setRealtimeAPIKeyCacheContext(context: RealtimeAPIKeyCacheContext): void;
+/** Reserves a deferred commit when the base hook is entered for this invocation. @internal */
+export declare function getDeferredRealtimeAPIKeyCache(client: CredentialClient): DeferredAPIKeyCache | undefined;
+/** Applies the Bedrock getter's validation when a captured credential does not enter the cache. @internal */
+export declare function validateCapturedAPIKey(client: Pick<OpenAI, 'apiKey'>, credential: string | null): string | null;
 /** Selects a captured credential without treating an explicit null as absent. @internal */
 export declare function getRealtimeAPIKey(client: Pick<OpenAI, 'apiKey'> | undefined, captured: string | null | undefined): string | null | undefined;
 /**
@@ -8,8 +27,10 @@ export declare function getRealtimeAPIKey(client: Pick<OpenAI, 'apiKey'> | undef
  * synchronizing concurrent credential updates.
  * @internal
  */
-export declare function resolveRealtimeAPIKey(client: Pick<OpenAI, 'apiKey' | '_callApiKey'>): Promise<{
+export declare function resolveRealtimeAPIKey(client: CredentialClient & Pick<OpenAI, '_callApiKey'>, deferCache?: boolean): Promise<{
     apiKey: string | null;
     isProvider: boolean;
+    commit: () => string | null;
 }>;
+export {};
 //# sourceMappingURL=realtime-credentials.d.mts.map

package/internal/realtime-credentials.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"realtime-credentials.d.mts","sourceRoot":"","sources":["../src/internal/realtime-credentials.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,sBAAkB;AAExC,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,SAAS,EAC1C,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAClC,MAAM,GAAG,IAAI,GAAG,SAAS,CAE3B;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,GAAG,aAAa,CAAC,GAAG,OAAO,CAAC;IACnG,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC,CAMD"}
+{"version":3,"file":"realtime-credentials.d.mts","sourceRoot":"","sources":["../src/internal/realtime-credentials.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,sBAAkB;AAIxC,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CAC7B;AACD,UAAU,0BAA0B;IAClC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,mBAAmB,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1E,QAAQ,EAAE,MAAM,mBAAmB,GAAG,SAAS,CAAC;CACjD;AAED,QAAA,MAAM,oBAAoB,eAAkD,CAAC;AAC7E,KAAK,gBAAgB,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG;IAC/C,CAAC,oBAAoB,CAAC,CAAC,EAAE,0BAA0B,CAAC;CACrD,CAAC;AAGF,0GAA0G;AAC1G,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAEvF;AAED,8FAA8F;AAC9F,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,gBAAgB,GAAG,mBAAmB,GAAG,SAAS,CAGxG;AAED,6GAA6G;AAC7G,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,EAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,GACxB,MAAM,GAAG,IAAI,CAKf;AAED,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,SAAS,EAC1C,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAClC,MAAM,GAAG,IAAI,GAAG,SAAS,CAE3B;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,EACtD,UAAU,UAAQ,GACjB,OAAO,CAAC;IACT,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CAC7B,CAAC,CA4BD"}

package/internal/realtime-credentials.d.ts

@@ -1,4 +1,23 @@
 import type { OpenAI } from "../client.js";
+export interface DeferredAPIKeyCache {
+    client: Pick<OpenAI, 'apiKey'>;
+    providerKey?: string;
+    commit: () => string | null;
+}
+interface RealtimeAPIKeyCacheContext {
+    run: <T>(cache: DeferredAPIKeyCache | undefined, operation: () => T) => T;
+    getStore: () => DeferredAPIKeyCache | undefined;
+}
+declare const realtimeCacheContext: unique symbol;
+type CredentialClient = Pick<OpenAI, 'apiKey'> & {
+    [realtimeCacheContext]?: RealtimeAPIKeyCacheContext;
+};
+/** Installs the Node transport's invocation context without loading Node in the base client. @internal */
+export declare function setRealtimeAPIKeyCacheContext(context: RealtimeAPIKeyCacheContext): void;
+/** Reserves a deferred commit when the base hook is entered for this invocation. @internal */
+export declare function getDeferredRealtimeAPIKeyCache(client: CredentialClient): DeferredAPIKeyCache | undefined;
+/** Applies the Bedrock getter's validation when a captured credential does not enter the cache. @internal */
+export declare function validateCapturedAPIKey(client: Pick<OpenAI, 'apiKey'>, credential: string | null): string | null;
 /** Selects a captured credential without treating an explicit null as absent. @internal */
 export declare function getRealtimeAPIKey(client: Pick<OpenAI, 'apiKey'> | undefined, captured: string | null | undefined): string | null | undefined;
 /**
@@ -8,8 +27,10 @@ export declare function getRealtimeAPIKey(client: Pick<OpenAI, 'apiKey'> | undef
  * synchronizing concurrent credential updates.
  * @internal
  */
-export declare function resolveRealtimeAPIKey(client: Pick<OpenAI, 'apiKey' | '_callApiKey'>): Promise<{
+export declare function resolveRealtimeAPIKey(client: CredentialClient & Pick<OpenAI, '_callApiKey'>, deferCache?: boolean): Promise<{
     apiKey: string | null;
     isProvider: boolean;
+    commit: () => string | null;
 }>;
+export {};
 //# sourceMappingURL=realtime-credentials.d.ts.map

package/internal/realtime-credentials.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"realtime-credentials.d.ts","sourceRoot":"","sources":["../src/internal/realtime-credentials.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,qBAAkB;AAExC,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,SAAS,EAC1C,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAClC,MAAM,GAAG,IAAI,GAAG,SAAS,CAE3B;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,GAAG,aAAa,CAAC,GAAG,OAAO,CAAC;IACnG,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC,CAMD"}
+{"version":3,"file":"realtime-credentials.d.ts","sourceRoot":"","sources":["../src/internal/realtime-credentials.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,qBAAkB;AAIxC,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CAC7B;AACD,UAAU,0BAA0B;IAClC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,mBAAmB,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1E,QAAQ,EAAE,MAAM,mBAAmB,GAAG,SAAS,CAAC;CACjD;AAED,QAAA,MAAM,oBAAoB,eAAkD,CAAC;AAC7E,KAAK,gBAAgB,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG;IAC/C,CAAC,oBAAoB,CAAC,CAAC,EAAE,0BAA0B,CAAC;CACrD,CAAC;AAGF,0GAA0G;AAC1G,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAEvF;AAED,8FAA8F;AAC9F,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,gBAAgB,GAAG,mBAAmB,GAAG,SAAS,CAGxG;AAED,6GAA6G;AAC7G,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,EAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,GACxB,MAAM,GAAG,IAAI,CAKf;AAED,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,SAAS,EAC1C,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAClC,MAAM,GAAG,IAAI,GAAG,SAAS,CAE3B;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,EACtD,UAAU,UAAQ,GACjB,OAAO,CAAC;IACT,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CAC7B,CAAC,CA4BD"}