openai 7.26.0 → 7.28.0

package/CHANGELOG.md

@@ -1,10 +1,26 @@
 # Changelog
 
+## [7.28.0](https://github.com/openai/openai-node/compare/v7.27.0...v7.28.0) (2026-10-02)
+
+
+### Features
+
+* **api:** add custom voice creation and agent session events ([#2858](https://github.com/openai/openai-node/issues/2858)) ([11b9283](https://github.com/openai/openai-node/commit/11b9283f2a22737e273ccc1593d01af5cf584a0b))
+
+## [7.27.0](https://github.com/openai/openai-node/compare/v7.26.0...v7.27.0) (2026-10-01)
+
+
+### Features
+
+* **agents:** prepare hosted files and download result artifacts ([#2855](https://github.com/openai/openai-node/issues/2855)) ([7b5a9e0](https://github.com/openai/openai-node/commit/7b5a9e0113ead1b35d43cbd86a2869481fce7e22))
+
 ## [7.26.0](https://github.com/openai/openai-node/compare/v7.25.0...v7.26.0) (2026-10-01)
 
 
 ### Features
 
+* collect final output from beta Agents streams ([#2850](https://github.com/openai/openai-node/issues/2850)) ([71d2412](https://github.com/openai/openai-node/commit/71d24120c4cc4e5897a767f16d25f2804fa4ad7c))
+* **agents:** [1/n] parse typed output from agent streams ([#2853](https://github.com/openai/openai-node/issues/2853)) ([95b197b](https://github.com/openai/openai-node/commit/95b197b6b35c84bb7da322c3e5eb9adf1d1f79e7))
 * **api:** Add agent session trace listing ([#2845](https://github.com/openai/openai-node/issues/2845)) ([c6dd4c7](https://github.com/openai/openai-node/commit/c6dd4c75d0c864ad2f7e7c9df9a10310fd34fe44))
 * **beta:** bind typed application functions to Agents tools ([#2852](https://github.com/openai/openai-node/issues/2852)) ([6198ba0](https://github.com/openai/openai-node/commit/6198ba0d659084e34f540e9e8fa6c9ef86306ba1))
 

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

@@ -0,0 +1,17 @@
+import type { WritableStream as AgentWritableStream } from "../../../internal/shim-types.mjs";
+import type { StreamingFile } from "../../../internal/uploads.mjs";
+import type { RequestOptions } from "../../../internal/request-options.mjs";
+import type { Files } from "../../../resources/beta/agents/environments/files.mjs";
+import type { PreparedAgentFiles } from "../../../lib/beta/agents/files.mjs";
+/** 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.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.mts","sourceRoot":"","sources":["../../../src/helpers/beta/agents/filesystem.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,IAAI,mBAAmB,EAAE,yCAAqC;AAM1F,OAAO,KAAK,EAAE,aAAa,EAAE,sCAAkC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,8CAA0C;AACxE,OAAO,KAAK,EAAE,KAAK,EAAE,8DAA0D;AAC/E,OAAO,KAAK,EAAE,kBAAkB,EAAE,2CAAuC;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.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/internal/shim-types.d.mts

@@ -14,4 +14,13 @@ type _ConditionalNodeReadableStream<R = any> = typeof globalThis extends {
 } ? never : _NodeReadableStream<R>;
 type _ReadableStream<R = any> = NeverToAny<([0] extends [1 & _DOMReadableStream<R>] ? never : _DOMReadableStream<R>) | ([0] extends [1 & _ConditionalNodeReadableStream<R>] ? never : _ConditionalNodeReadableStream<R>)>;
 export type { _ReadableStream as ReadableStream };
+/** @ts-ignore */
+type _DOMWritableStream<R = any> = globalThis.WritableStream<R>;
+/** @ts-ignore */
+type _NodeWritableStream<R = any> = import('stream/web').WritableStream<R>;
+type _ConditionalNodeWritableStream<R = any> = typeof globalThis extends {
+    WritableStream: any;
+} ? never : _NodeWritableStream<R>;
+type _WritableStream<R = any> = NeverToAny<([0] extends [1 & _DOMWritableStream<R>] ? never : _DOMWritableStream<R>) | ([0] extends [1 & _ConditionalNodeWritableStream<R>] ? never : _ConditionalNodeWritableStream<R>)>;
+export type { _WritableStream as WritableStream };
 //# sourceMappingURL=shim-types.d.mts.map

package/internal/shim-types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"shim-types.d.mts","sourceRoot":"","sources":["../src/internal/shim-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC;AAE/C,iBAAiB;AACjB,KAAK,kBAAkB,CAAC,CAAC,GAAG,GAAG,IAAI,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;AAEhE,iBAAiB;AACjB,KAAK,mBAAmB,CAAC,CAAC,GAAG,GAAG,IAAI,OAAO,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;AAE3E,KAAK,8BAA8B,CAAC,CAAC,GAAG,GAAG,IAAI,OAAO,UAAU,SAAS;IAAE,cAAc,EAAE,GAAG,CAAA;CAAE,GAC5F,KAAK,GACL,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAE3B,KAAK,eAAe,CAAC,CAAC,GAAG,GAAG,IAAI,UAAU,CACtC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,GACzE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,8BAA8B,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,8BAA8B,CAAC,CAAC,CAAC,CAAC,CACpG,CAAC;AAEF,YAAY,EAAE,eAAe,IAAI,cAAc,EAAE,CAAC"}
+{"version":3,"file":"shim-types.d.mts","sourceRoot":"","sources":["../src/internal/shim-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC;AAE/C,iBAAiB;AACjB,KAAK,kBAAkB,CAAC,CAAC,GAAG,GAAG,IAAI,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;AAEhE,iBAAiB;AACjB,KAAK,mBAAmB,CAAC,CAAC,GAAG,GAAG,IAAI,OAAO,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;AAE3E,KAAK,8BAA8B,CAAC,CAAC,GAAG,GAAG,IAAI,OAAO,UAAU,SAAS;IAAE,cAAc,EAAE,GAAG,CAAA;CAAE,GAC5F,KAAK,GACL,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAE3B,KAAK,eAAe,CAAC,CAAC,GAAG,GAAG,IAAI,UAAU,CACtC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,GACzE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,8BAA8B,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,8BAA8B,CAAC,CAAC,CAAC,CAAC,CACpG,CAAC;AAEF,YAAY,EAAE,eAAe,IAAI,cAAc,EAAE,CAAC;AAElD,iBAAiB;AACjB,KAAK,kBAAkB,CAAC,CAAC,GAAG,GAAG,IAAI,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;AAEhE,iBAAiB;AACjB,KAAK,mBAAmB,CAAC,CAAC,GAAG,GAAG,IAAI,OAAO,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;AAE3E,KAAK,8BAA8B,CAAC,CAAC,GAAG,GAAG,IAAI,OAAO,UAAU,SAAS;IAAE,cAAc,EAAE,GAAG,CAAA;CAAE,GAC5F,KAAK,GACL,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAE3B,KAAK,eAAe,CAAC,CAAC,GAAG,GAAG,IAAI,UAAU,CACtC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,GACzE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,8BAA8B,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,8BAA8B,CAAC,CAAC,CAAC,CAAC,CACpG,CAAC;AAEF,YAAY,EAAE,eAAe,IAAI,cAAc,EAAE,CAAC"}

package/internal/shim-types.d.ts

@@ -14,4 +14,13 @@ type _ConditionalNodeReadableStream<R = any> = typeof globalThis extends {
 } ? never : _NodeReadableStream<R>;
 type _ReadableStream<R = any> = NeverToAny<([0] extends [1 & _DOMReadableStream<R>] ? never : _DOMReadableStream<R>) | ([0] extends [1 & _ConditionalNodeReadableStream<R>] ? never : _ConditionalNodeReadableStream<R>)>;
 export type { _ReadableStream as ReadableStream };
+/** @ts-ignore */
+type _DOMWritableStream<R = any> = globalThis.WritableStream<R>;
+/** @ts-ignore */
+type _NodeWritableStream<R = any> = import('stream/web').WritableStream<R>;
+type _ConditionalNodeWritableStream<R = any> = typeof globalThis extends {
+    WritableStream: any;
+} ? never : _NodeWritableStream<R>;
+type _WritableStream<R = any> = NeverToAny<([0] extends [1 & _DOMWritableStream<R>] ? never : _DOMWritableStream<R>) | ([0] extends [1 & _ConditionalNodeWritableStream<R>] ? never : _ConditionalNodeWritableStream<R>)>;
+export type { _WritableStream as WritableStream };
 //# sourceMappingURL=shim-types.d.ts.map

package/internal/shim-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shim-types.d.ts","sourceRoot":"","sources":["../src/internal/shim-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC;AAE/C,iBAAiB;AACjB,KAAK,kBAAkB,CAAC,CAAC,GAAG,GAAG,IAAI,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;AAEhE,iBAAiB;AACjB,KAAK,mBAAmB,CAAC,CAAC,GAAG,GAAG,IAAI,OAAO,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;AAE3E,KAAK,8BAA8B,CAAC,CAAC,GAAG,GAAG,IAAI,OAAO,UAAU,SAAS;IAAE,cAAc,EAAE,GAAG,CAAA;CAAE,GAC5F,KAAK,GACL,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAE3B,KAAK,eAAe,CAAC,CAAC,GAAG,GAAG,IAAI,UAAU,CACtC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,GACzE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,8BAA8B,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,8BAA8B,CAAC,CAAC,CAAC,CAAC,CACpG,CAAC;AAEF,YAAY,EAAE,eAAe,IAAI,cAAc,EAAE,CAAC"}
+{"version":3,"file":"shim-types.d.ts","sourceRoot":"","sources":["../src/internal/shim-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC;AAE/C,iBAAiB;AACjB,KAAK,kBAAkB,CAAC,CAAC,GAAG,GAAG,IAAI,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;AAEhE,iBAAiB;AACjB,KAAK,mBAAmB,CAAC,CAAC,GAAG,GAAG,IAAI,OAAO,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;AAE3E,KAAK,8BAA8B,CAAC,CAAC,GAAG,GAAG,IAAI,OAAO,UAAU,SAAS;IAAE,cAAc,EAAE,GAAG,CAAA;CAAE,GAC5F,KAAK,GACL,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAE3B,KAAK,eAAe,CAAC,CAAC,GAAG,GAAG,IAAI,UAAU,CACtC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,GACzE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,8BAA8B,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,8BAA8B,CAAC,CAAC,CAAC,CAAC,CACpG,CAAC;AAEF,YAAY,EAAE,eAAe,IAAI,cAAc,EAAE,CAAC;AAElD,iBAAiB;AACjB,KAAK,kBAAkB,CAAC,CAAC,GAAG,GAAG,IAAI,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;AAEhE,iBAAiB;AACjB,KAAK,mBAAmB,CAAC,CAAC,GAAG,GAAG,IAAI,OAAO,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;AAE3E,KAAK,8BAA8B,CAAC,CAAC,GAAG,GAAG,IAAI,OAAO,UAAU,SAAS;IAAE,cAAc,EAAE,GAAG,CAAA;CAAE,GAC5F,KAAK,GACL,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAE3B,KAAK,eAAe,CAAC,CAAC,GAAG,GAAG,IAAI,UAAU,CACtC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,GACzE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,8BAA8B,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,8BAA8B,CAAC,CAAC,CAAC,CAAC,CACpG,CAAC;AAEF,YAAY,EAAE,eAAe,IAAI,cAAc,EAAE,CAAC"}

package/internal/tslib.js

@@ -6,6 +6,7 @@ exports.__classPrivateFieldGet = __classPrivateFieldGet;
 exports.__exportStar = __exportStar;
 exports.__importStar = __importStar;
 exports.__classPrivateFieldIn = __classPrivateFieldIn;
+exports.__importDefault = __importDefault;
 function __classPrivateFieldSet(receiver, state, value, kind, f) {
     if (kind === "m")
         throw new TypeError("Private method is not writable");
@@ -85,3 +86,6 @@ function __classPrivateFieldIn(state, receiver) {
         throw new TypeError("Cannot use 'in' operator on non-object");
     return typeof state === "function" ? receiver === state : state.has(receiver);
 }
+function __importDefault(mod) {
+    return mod && mod.__esModule ? mod : { default: mod };
+}

package/lib/beta/agents/files.d.mts

@@ -0,0 +1,33 @@
+import type { OpenAI } from "../../../client.mjs";
+import { OpenAIError } from "../../../core/error.mjs";
+import type { RequestOptions } from "../../../internal/request-options.mjs";
+import type { Uploadable } from "../../../internal/uploads.mjs";
+import type { FileObject } from "../../../resources/files.mjs";
+import type { EnvironmentFile, FileCreateParams, Files } from "../../../resources/beta/agents/environments/files.mjs";
+/** Beta: file references ready for a hosted environment, plus caller-owned uploads. */
+export interface PreparedAgentFiles {
+    files: Extract<FileCreateParams, {
+        type: 'file_id';
+    }>[];
+    uploadedFiles: FileObject[];
+}
+/** Beta: uploaded file IDs remain available after partial preparation or staging failure. */
+export declare class AgentFileUploadError extends OpenAIError {
+    readonly name = "AgentFileUploadError";
+    readonly cause: unknown;
+    readonly uploadedFiles: FileObject[];
+    constructor(uploadedFiles: FileObject[], cause: unknown);
+}
+/** @internal */
+export declare function validateAgentFilePath(path: string): void;
+/** @internal */
+export declare function prepareAgentFiles(client: OpenAI, files: Record<string, Uploadable>, options?: RequestOptions): Promise<PreparedAgentFiles>;
+/** @internal */
+export declare function uploadAgentFile(client: OpenAI, resource: Files, environmentID: string, params: {
+    file: Uploadable;
+    path: string;
+}, options?: RequestOptions): Promise<{
+    uploadedFile: FileObject;
+    environmentFile: EnvironmentFile;
+}>;
+//# sourceMappingURL=files.d.mts.map

package/lib/beta/agents/files.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.mts","sourceRoot":"","sources":["../../../src/lib/beta/agents/files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,4BAAwB;AAC9C,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,8CAA0C;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,sCAAkC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,qCAAiC;AAC3D,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,KAAK,EACN,8DAA0D;AAE3D,uFAAuF;AACvF,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,CAAC,gBAAgB,EAAE;QAAE,IAAI,EAAE,SAAS,CAAA;KAAE,CAAC,EAAE,CAAC;IACxD,aAAa,EAAE,UAAU,EAAE,CAAC;CAC7B;AAED,6FAA6F;AAC7F,qBAAa,oBAAqB,SAAQ,WAAW;IACnD,SAAkB,IAAI,0BAA0B;IAChD,SAAiB,KAAK,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,UAAU,EAAE,CAAC;gBACzB,aAAa,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,OAAO;CAKxD;AAED,gBAAgB;AAChB,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAexD;AAwBD,gBAAgB;AAChB,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EACjC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,kBAAkB,CAAC,CAsB7B;AAED,gBAAgB;AAChB,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,KAAK,EACf,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAC1C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;IAAE,YAAY,EAAE,UAAU,CAAC;IAAC,eAAe,EAAE,eAAe,CAAA;CAAE,CAAC,CAYzE"}

package/lib/beta/agents/files.d.ts

@@ -0,0 +1,33 @@
+import type { OpenAI } from "../../../client.js";
+import { OpenAIError } from "../../../core/error.js";
+import type { RequestOptions } from "../../../internal/request-options.js";
+import type { Uploadable } from "../../../internal/uploads.js";
+import type { FileObject } from "../../../resources/files.js";
+import type { EnvironmentFile, FileCreateParams, Files } from "../../../resources/beta/agents/environments/files.js";
+/** Beta: file references ready for a hosted environment, plus caller-owned uploads. */
+export interface PreparedAgentFiles {
+    files: Extract<FileCreateParams, {
+        type: 'file_id';
+    }>[];
+    uploadedFiles: FileObject[];
+}
+/** Beta: uploaded file IDs remain available after partial preparation or staging failure. */
+export declare class AgentFileUploadError extends OpenAIError {
+    readonly name = "AgentFileUploadError";
+    readonly cause: unknown;
+    readonly uploadedFiles: FileObject[];
+    constructor(uploadedFiles: FileObject[], cause: unknown);
+}
+/** @internal */
+export declare function validateAgentFilePath(path: string): void;
+/** @internal */
+export declare function prepareAgentFiles(client: OpenAI, files: Record<string, Uploadable>, options?: RequestOptions): Promise<PreparedAgentFiles>;
+/** @internal */
+export declare function uploadAgentFile(client: OpenAI, resource: Files, environmentID: string, params: {
+    file: Uploadable;
+    path: string;
+}, options?: RequestOptions): Promise<{
+    uploadedFile: FileObject;
+    environmentFile: EnvironmentFile;
+}>;
+//# sourceMappingURL=files.d.ts.map

package/lib/beta/agents/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../../src/lib/beta/agents/files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,2BAAwB;AAC9C,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,6CAA0C;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,qCAAkC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,oCAAiC;AAC3D,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,KAAK,EACN,6DAA0D;AAE3D,uFAAuF;AACvF,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,CAAC,gBAAgB,EAAE;QAAE,IAAI,EAAE,SAAS,CAAA;KAAE,CAAC,EAAE,CAAC;IACxD,aAAa,EAAE,UAAU,EAAE,CAAC;CAC7B;AAED,6FAA6F;AAC7F,qBAAa,oBAAqB,SAAQ,WAAW;IACnD,SAAkB,IAAI,0BAA0B;IAChD,SAAiB,KAAK,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,UAAU,EAAE,CAAC;gBACzB,aAAa,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,OAAO;CAKxD;AAED,gBAAgB;AAChB,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAexD;AAwBD,gBAAgB;AAChB,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EACjC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,kBAAkB,CAAC,CAsB7B;AAED,gBAAgB;AAChB,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,KAAK,EACf,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAC1C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;IAAE,YAAY,EAAE,UAAU,CAAC;IAAC,eAAe,EAAE,eAAe,CAAA;CAAE,CAAC,CAYzE"}