openai 7.26.0 → 7.27.0

package/lib/beta/agents/files.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentFileUploadError = void 0;
+exports.validateAgentFilePath = validateAgentFilePath;
+exports.prepareAgentFiles = prepareAgentFiles;
+exports.uploadAgentFile = uploadAgentFile;
+const error_1 = require("../../../core/error.js");
+const headers_1 = require("../../../internal/headers.js");
+/** Beta: uploaded file IDs remain available after partial preparation or staging failure. */
+class AgentFileUploadError extends error_1.OpenAIError {
+    constructor(uploadedFiles, cause) {
+        super('Agent file preparation or staging failed; uploaded files remain caller-owned.');
+        this.name = 'AgentFileUploadError';
+        this.uploadedFiles = uploadedFiles;
+        Object.defineProperty(this, 'cause', { value: cause, configurable: true });
+    }
+}
+exports.AgentFileUploadError = AgentFileUploadError;
+/** @internal */
+function validateAgentFilePath(path) {
+    const parts = path.split('/');
+    const root = parts[2] ?? '';
+    if (!path.startsWith('/workspace/') ||
+        path.includes('\\') ||
+        path.includes('\0') ||
+        parts.slice(1).some((part) => part === '' || part === '.' || part === '..') ||
+        root === '.codex' ||
+        root === '.managed-agents' ||
+        root.startsWith('.managed-agents-') ||
+        path === '/workspace/outputs') {
+        throw new error_1.OpenAIError('Agent files require a non-reserved absolute file path inside /workspace');
+    }
+}
+function preflight(files, options) {
+    const entries = Object.entries(files);
+    const headers = (0, headers_1.buildHeaders)([options.headers]);
+    if (entries.length > 1 &&
+        (headers.values.has('idempotency-key') ||
+            (!headers.nulls.has('idempotency-key') && options?.idempotencyKey !== undefined))) {
+        throw new error_1.OpenAIError('Do not reuse an Idempotency-Key across multiple file uploads');
+    }
+    const paths = new Set(entries.map(([path]) => path));
+    for (const [path] of entries) {
+        validateAgentFilePath(path);
+        for (let slash = path.lastIndexOf('/'); slash > 0; slash = path.lastIndexOf('/', slash - 1)) {
+            if (paths.has(path.slice(0, slash))) {
+                throw new error_1.OpenAIError('Agent file destinations conflict');
+            }
+        }
+    }
+    return entries;
+}
+/** @internal */
+async function prepareAgentFiles(client, files, options) {
+    const requestOptions = { ...options };
+    // Internal SDK read: capture effective headers once, including defaults and explicit omissions.
+    const headers = (0, headers_1.buildHeaders)([client['_options'].defaultHeaders, requestOptions.headers]);
+    requestOptions.headers = headers;
+    const entries = preflight(files, requestOptions);
+    if (entries.length > 1) {
+        // Keep a later mutation of client defaults from adding one key to this entire batch.
+        headers.nulls.add('idempotency-key');
+    }
+    const prepared = { files: [], uploadedFiles: [] };
+    try {
+        for (const [path, file] of entries) {
+            // oxlint-disable-next-line no-await-in-loop -- Stop on the first failure and expose precisely the uploads already created.
+            const uploaded = await client.files.create({ file, purpose: 'user_data' }, requestOptions);
+            prepared.uploadedFiles.push(uploaded);
+            prepared.files.push({ type: 'file_id', file_id: uploaded.id, path });
+        }
+        return prepared;
+    }
+    catch (error) {
+        throw new AgentFileUploadError(prepared.uploadedFiles, error);
+    }
+}
+/** @internal */
+async function uploadAgentFile(client, resource, environmentID, params, options) {
+    const prepared = await prepareAgentFiles(client, { [params.path]: params.file }, options);
+    const [reference] = prepared.files;
+    const [uploadedFile] = prepared.uploadedFiles;
+    if (!reference || !uploadedFile) {
+        throw new error_1.OpenAIError('Missing prepared agent file');
+    }
+    try {
+        return { uploadedFile, environmentFile: await resource.create(environmentID, reference, options) };
+    }
+    catch (error) {
+        throw new AgentFileUploadError(prepared.uploadedFiles, error);
+    }
+}
+//# sourceMappingURL=files.js.map

package/lib/beta/agents/files.js.map

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

package/lib/beta/agents/files.mjs

@@ -0,0 +1,86 @@
+import { OpenAIError } from "../../../core/error.mjs";
+import { buildHeaders } from "../../../internal/headers.mjs";
+/** Beta: uploaded file IDs remain available after partial preparation or staging failure. */
+export class AgentFileUploadError extends OpenAIError {
+    constructor(uploadedFiles, cause) {
+        super('Agent file preparation or staging failed; uploaded files remain caller-owned.');
+        this.name = 'AgentFileUploadError';
+        this.uploadedFiles = uploadedFiles;
+        Object.defineProperty(this, 'cause', { value: cause, configurable: true });
+    }
+}
+/** @internal */
+export function validateAgentFilePath(path) {
+    const parts = path.split('/');
+    const root = parts[2] ?? '';
+    if (!path.startsWith('/workspace/') ||
+        path.includes('\\') ||
+        path.includes('\0') ||
+        parts.slice(1).some((part) => part === '' || part === '.' || part === '..') ||
+        root === '.codex' ||
+        root === '.managed-agents' ||
+        root.startsWith('.managed-agents-') ||
+        path === '/workspace/outputs') {
+        throw new OpenAIError('Agent files require a non-reserved absolute file path inside /workspace');
+    }
+}
+function preflight(files, options) {
+    const entries = Object.entries(files);
+    const headers = buildHeaders([options.headers]);
+    if (entries.length > 1 &&
+        (headers.values.has('idempotency-key') ||
+            (!headers.nulls.has('idempotency-key') && options?.idempotencyKey !== undefined))) {
+        throw new OpenAIError('Do not reuse an Idempotency-Key across multiple file uploads');
+    }
+    const paths = new Set(entries.map(([path]) => path));
+    for (const [path] of entries) {
+        validateAgentFilePath(path);
+        for (let slash = path.lastIndexOf('/'); slash > 0; slash = path.lastIndexOf('/', slash - 1)) {
+            if (paths.has(path.slice(0, slash))) {
+                throw new OpenAIError('Agent file destinations conflict');
+            }
+        }
+    }
+    return entries;
+}
+/** @internal */
+export async function prepareAgentFiles(client, files, options) {
+    const requestOptions = { ...options };
+    // Internal SDK read: capture effective headers once, including defaults and explicit omissions.
+    const headers = buildHeaders([client['_options'].defaultHeaders, requestOptions.headers]);
+    requestOptions.headers = headers;
+    const entries = preflight(files, requestOptions);
+    if (entries.length > 1) {
+        // Keep a later mutation of client defaults from adding one key to this entire batch.
+        headers.nulls.add('idempotency-key');
+    }
+    const prepared = { files: [], uploadedFiles: [] };
+    try {
+        for (const [path, file] of entries) {
+            // oxlint-disable-next-line no-await-in-loop -- Stop on the first failure and expose precisely the uploads already created.
+            const uploaded = await client.files.create({ file, purpose: 'user_data' }, requestOptions);
+            prepared.uploadedFiles.push(uploaded);
+            prepared.files.push({ type: 'file_id', file_id: uploaded.id, path });
+        }
+        return prepared;
+    }
+    catch (error) {
+        throw new AgentFileUploadError(prepared.uploadedFiles, error);
+    }
+}
+/** @internal */
+export async function uploadAgentFile(client, resource, environmentID, params, options) {
+    const prepared = await prepareAgentFiles(client, { [params.path]: params.file }, options);
+    const [reference] = prepared.files;
+    const [uploadedFile] = prepared.uploadedFiles;
+    if (!reference || !uploadedFile) {
+        throw new OpenAIError('Missing prepared agent file');
+    }
+    try {
+        return { uploadedFile, environmentFile: await resource.create(environmentID, reference, options) };
+    }
+    catch (error) {
+        throw new AgentFileUploadError(prepared.uploadedFiles, error);
+    }
+}
+//# sourceMappingURL=files.mjs.map

package/lib/beta/agents/files.mjs.map

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

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

@@ -0,0 +1,9 @@
+import type { CursorPage } from "../../../core/pagination.mjs";
+/** Retain server cursor metadata for legacy Agents items with nullable IDs.
+ * @internal
+ * @yields {T} Each item in server order, failing if pagination cannot advance.
+ */
+export declare function agentItems<T extends {
+    id?: string | null;
+}>(load: (after: string | undefined) => PromiseLike<CursorPage<T>>): AsyncGenerator<T, void, undefined>;
+//# sourceMappingURL=pages.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pages.d.mts","sourceRoot":"","sources":["../../../src/lib/beta/agents/pages.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,qCAAiC;AAG3D;;;GAGG;AACH,wBAAuB,UAAU,CAAC,CAAC,SAAS;IAAE,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAChE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAC9D,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAqBpC"}

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

@@ -0,0 +1,9 @@
+import type { CursorPage } from "../../../core/pagination.js";
+/** Retain server cursor metadata for legacy Agents items with nullable IDs.
+ * @internal
+ * @yields {T} Each item in server order, failing if pagination cannot advance.
+ */
+export declare function agentItems<T extends {
+    id?: string | null;
+}>(load: (after: string | undefined) => PromiseLike<CursorPage<T>>): AsyncGenerator<T, void, undefined>;
+//# sourceMappingURL=pages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../../src/lib/beta/agents/pages.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,oCAAiC;AAG3D;;;GAGG;AACH,wBAAuB,UAAU,CAAC,CAAC,SAAS;IAAE,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAChE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAC9D,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAqBpC"}

package/lib/beta/agents/pages.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentItems = agentItems;
+const error_1 = require("../../../core/error.js");
+const values_1 = require("../../../internal/utils/values.js");
+/** Retain server cursor metadata for legacy Agents items with nullable IDs.
+ * @internal
+ * @yields {T} Each item in server order, failing if pagination cannot advance.
+ */
+async function* agentItems(load) {
+    let after;
+    while (true) {
+        // oxlint-disable-next-line no-await-in-loop -- Each page determines the next cursor.
+        const page = await load(after);
+        yield* page.data;
+        if (!page.has_more) {
+            return;
+        }
+        // Internal SDK read: CursorPage keeps raw metadata but does not expose last_id.
+        // oxlint-disable-next-line prefer-destructuring -- Bracket access intentionally reads a protected internal field.
+        const body = page['body'];
+        // oxlint-disable-next-line unicorn/prefer-at -- Keep published source compatible with ES2020 declarations.
+        const last = page.data[page.data.length - 1];
+        // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Validate only the opaque cursor from response metadata.
+        const cursor = (0, values_1.isObj)(body) && typeof body['last_id'] === 'string' ? body['last_id'] : last?.id;
+        if (!cursor || cursor === after) {
+            throw new error_1.OpenAIError('Agent pagination cannot advance to the next page');
+        }
+        after = cursor;
+    }
+}
+//# sourceMappingURL=pages.js.map

package/lib/beta/agents/pages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.js","sourceRoot":"","sources":["../../../src/lib/beta/agents/pages.ts"],"names":[],"mappings":";;AAQA,gCAuBC;AA/BD,kDAAkD;AAElD,8DAAuD;AAEvD;;;GAGG;AACI,KAAK,SAAS,CAAC,CAAC,UAAU,CAC/B,IAA+D;IAE/D,IAAI,KAAyB,CAAC;IAC9B,OAAO,IAAI,EAAE,CAAC;QACZ,qFAAqF;QACrF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/B,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QACD,gFAAgF;QAChF,kHAAkH;QAClH,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,2GAA2G;QAC3G,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC7C,kHAAkH;QAClH,MAAM,MAAM,GAAG,IAAA,cAAK,EAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC/F,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YAChC,MAAM,IAAI,mBAAW,CAAC,kDAAkD,CAAC,CAAC;QAC5E,CAAC;QACD,KAAK,GAAG,MAAM,CAAC;IACjB,CAAC;AACH,CAAC"}

package/lib/beta/agents/pages.mjs

@@ -0,0 +1,29 @@
+import { OpenAIError } from "../../../core/error.mjs";
+import { isObj } from "../../../internal/utils/values.mjs";
+/** Retain server cursor metadata for legacy Agents items with nullable IDs.
+ * @internal
+ * @yields {T} Each item in server order, failing if pagination cannot advance.
+ */
+export async function* agentItems(load) {
+    let after;
+    while (true) {
+        // oxlint-disable-next-line no-await-in-loop -- Each page determines the next cursor.
+        const page = await load(after);
+        yield* page.data;
+        if (!page.has_more) {
+            return;
+        }
+        // Internal SDK read: CursorPage keeps raw metadata but does not expose last_id.
+        // oxlint-disable-next-line prefer-destructuring -- Bracket access intentionally reads a protected internal field.
+        const body = page['body'];
+        // oxlint-disable-next-line unicorn/prefer-at -- Keep published source compatible with ES2020 declarations.
+        const last = page.data[page.data.length - 1];
+        // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Validate only the opaque cursor from response metadata.
+        const cursor = isObj(body) && typeof body['last_id'] === 'string' ? body['last_id'] : last?.id;
+        if (!cursor || cursor === after) {
+            throw new OpenAIError('Agent pagination cannot advance to the next page');
+        }
+        after = cursor;
+    }
+}
+//# sourceMappingURL=pages.mjs.map

package/lib/beta/agents/pages.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.mjs","sourceRoot":"","sources":["../../../src/lib/beta/agents/pages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAElD,OAAO,EAAE,KAAK,EAAE,2CAAuC;AAEvD;;;GAGG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,UAAU,CAC/B,IAA+D;IAE/D,IAAI,KAAyB,CAAC;IAC9B,OAAO,IAAI,EAAE,CAAC;QACZ,qFAAqF;QACrF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/B,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QACD,gFAAgF;QAChF,kHAAkH;QAClH,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,2GAA2G;QAC3G,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC7C,kHAAkH;QAClH,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC/F,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YAChC,MAAM,IAAI,WAAW,CAAC,kDAAkD,CAAC,CAAC;QAC5E,CAAC;QACD,KAAK,GAAG,MAAM,CAAC;IACjB,CAAC;AACH,CAAC"}

package/lib/beta/agents/result-artifacts.d.mts

@@ -0,0 +1,19 @@
+import type { WritableStream } from "../../../internal/shim-types.mjs";
+import type { RequestOptions } from "../../../internal/request-options.mjs";
+import type { Artifacts, SessionArtifact } from "../../../resources/beta/agents/sessions/artifacts.mjs";
+import type { AgentTurnResult } from "./agent-turn-result.mjs";
+/** Beta: artifacts from the exact session and turn represented by a result. */
+export declare class AgentResultArtifacts {
+    #private;
+    constructor(resource: Artifacts, result: AgentTurnResult);
+    /** Find one immutable artifact by its exact hosted path, across all pages. */
+    retrieve(path: string, options?: RequestOptions): Promise<SessionArtifact>;
+    /** Return the native binary response for this result's exact artifact path. */
+    content(path: string, options?: RequestOptions): Promise<Response>;
+    /** Stream bytes to a caller-chosen destination; the hosted path never selects a local path. */
+    download(params: {
+        path: string;
+        to: WritableStream<Uint8Array>;
+    }, options?: RequestOptions): Promise<SessionArtifact>;
+}
+//# sourceMappingURL=result-artifacts.d.mts.map

package/lib/beta/agents/result-artifacts.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-artifacts.d.mts","sourceRoot":"","sources":["../../../src/lib/beta/agents/result-artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,yCAAqC;AAGnE,OAAO,KAAK,EAAE,cAAc,EAAE,8CAA0C;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,8DAA0D;AACpG,OAAO,KAAK,EAAE,eAAe,EAAE,gCAA4B;AAE3D,+EAA+E;AAC/E,qBAAa,oBAAoB;;gBAInB,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe;IAMxD,8EAA8E;IACxE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IA0BhF,+EAA+E;IACzE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKxE,+FAA+F;IACzF,QAAQ,CACZ,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,cAAc,CAAC,UAAU,CAAC,CAAA;KAAE,EACxD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,eAAe,CAAC;CAoB5B"}

package/lib/beta/agents/result-artifacts.d.ts

@@ -0,0 +1,19 @@
+import type { WritableStream } from "../../../internal/shim-types.js";
+import type { RequestOptions } from "../../../internal/request-options.js";
+import type { Artifacts, SessionArtifact } from "../../../resources/beta/agents/sessions/artifacts.js";
+import type { AgentTurnResult } from "./agent-turn-result.js";
+/** Beta: artifacts from the exact session and turn represented by a result. */
+export declare class AgentResultArtifacts {
+    #private;
+    constructor(resource: Artifacts, result: AgentTurnResult);
+    /** Find one immutable artifact by its exact hosted path, across all pages. */
+    retrieve(path: string, options?: RequestOptions): Promise<SessionArtifact>;
+    /** Return the native binary response for this result's exact artifact path. */
+    content(path: string, options?: RequestOptions): Promise<Response>;
+    /** Stream bytes to a caller-chosen destination; the hosted path never selects a local path. */
+    download(params: {
+        path: string;
+        to: WritableStream<Uint8Array>;
+    }, options?: RequestOptions): Promise<SessionArtifact>;
+}
+//# sourceMappingURL=result-artifacts.d.ts.map

package/lib/beta/agents/result-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-artifacts.d.ts","sourceRoot":"","sources":["../../../src/lib/beta/agents/result-artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,wCAAqC;AAGnE,OAAO,KAAK,EAAE,cAAc,EAAE,6CAA0C;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,6DAA0D;AACpG,OAAO,KAAK,EAAE,eAAe,EAAE,+BAA4B;AAE3D,+EAA+E;AAC/E,qBAAa,oBAAoB;;gBAInB,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe;IAMxD,8EAA8E;IACxE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IA0BhF,+EAA+E;IACzE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKxE,+FAA+F;IACzF,QAAQ,CACZ,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,cAAc,CAAC,UAAU,CAAC,CAAA;KAAE,EACxD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,eAAe,CAAC;CAoB5B"}

package/lib/beta/agents/result-artifacts.js

@@ -0,0 +1,67 @@
+"use strict";
+var _AgentResultArtifacts_resource, _AgentResultArtifacts_sessionID, _AgentResultArtifacts_turnID;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentResultArtifacts = void 0;
+const tslib_1 = require("../../../internal/tslib.js");
+const pages_1 = require("./pages.js");
+const error_1 = require("../../../core/error.js");
+/** Beta: artifacts from the exact session and turn represented by a result. */
+class AgentResultArtifacts {
+    constructor(resource, result) {
+        _AgentResultArtifacts_resource.set(this, void 0);
+        _AgentResultArtifacts_sessionID.set(this, void 0);
+        _AgentResultArtifacts_turnID.set(this, void 0);
+        tslib_1.__classPrivateFieldSet(this, _AgentResultArtifacts_resource, resource, "f");
+        tslib_1.__classPrivateFieldSet(this, _AgentResultArtifacts_sessionID, result.session_id, "f");
+        tslib_1.__classPrivateFieldSet(this, _AgentResultArtifacts_turnID, result.turn_id, "f");
+    }
+    /** Find one immutable artifact by its exact hosted path, across all pages. */
+    async retrieve(path, options) {
+        let selected;
+        for await (const artifact of (0, pages_1.agentItems)((after) => tslib_1.__classPrivateFieldGet(this, _AgentResultArtifacts_resource, "f").list(tslib_1.__classPrivateFieldGet(this, _AgentResultArtifacts_sessionID, "f"), {}, { ...options, query: { ...options?.query, after, environment_id: undefined } }))) {
+            if (artifact.session_id === tslib_1.__classPrivateFieldGet(this, _AgentResultArtifacts_sessionID, "f") &&
+                artifact.turn_id === tslib_1.__classPrivateFieldGet(this, _AgentResultArtifacts_turnID, "f") &&
+                artifact.path === path) {
+                if (selected) {
+                    throw new error_1.OpenAIError('Multiple artifacts match this result and path');
+                }
+                selected = artifact;
+            }
+        }
+        if (!selected) {
+            throw new error_1.OpenAIError('No artifact matches this result and path');
+        }
+        return selected;
+    }
+    /** Return the native binary response for this result's exact artifact path. */
+    async content(path, options) {
+        const artifact = await this.retrieve(path, options);
+        return tslib_1.__classPrivateFieldGet(this, _AgentResultArtifacts_resource, "f").content(artifact.id, { session_id: tslib_1.__classPrivateFieldGet(this, _AgentResultArtifacts_sessionID, "f") }, options);
+    }
+    /** Stream bytes to a caller-chosen destination; the hosted path never selects a local path. */
+    async download(params, options) {
+        const { path, to } = params;
+        const artifact = await this.retrieve(path, options);
+        const response = await tslib_1.__classPrivateFieldGet(this, _AgentResultArtifacts_resource, "f").content(artifact.id, { session_id: tslib_1.__classPrivateFieldGet(this, _AgentResultArtifacts_sessionID, "f") }, options);
+        if (!response.body) {
+            throw new error_1.OpenAIError('Artifact response has no content stream');
+        }
+        try {
+            await response.body.pipeTo(to, options?.signal ? { signal: options.signal } : {});
+        }
+        catch (error) {
+            // pipeTo can reject before acquiring a reader, for example when the destination is locked.
+            try {
+                await response.body.cancel();
+            }
+            catch {
+                /* already cancelled or owned by pipeTo */
+            }
+            throw error;
+        }
+        return artifact;
+    }
+}
+exports.AgentResultArtifacts = AgentResultArtifacts;
+_AgentResultArtifacts_resource = new WeakMap(), _AgentResultArtifacts_sessionID = new WeakMap(), _AgentResultArtifacts_turnID = new WeakMap();
+//# sourceMappingURL=result-artifacts.js.map

package/lib/beta/agents/result-artifacts.js.map

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

package/lib/beta/agents/result-artifacts.mjs

@@ -0,0 +1,63 @@
+var _AgentResultArtifacts_resource, _AgentResultArtifacts_sessionID, _AgentResultArtifacts_turnID;
+import { __classPrivateFieldGet, __classPrivateFieldSet } from "../../../internal/tslib.mjs";
+import { agentItems } from "./pages.mjs";
+import { OpenAIError } from "../../../core/error.mjs";
+/** Beta: artifacts from the exact session and turn represented by a result. */
+export class AgentResultArtifacts {
+    constructor(resource, result) {
+        _AgentResultArtifacts_resource.set(this, void 0);
+        _AgentResultArtifacts_sessionID.set(this, void 0);
+        _AgentResultArtifacts_turnID.set(this, void 0);
+        __classPrivateFieldSet(this, _AgentResultArtifacts_resource, resource, "f");
+        __classPrivateFieldSet(this, _AgentResultArtifacts_sessionID, result.session_id, "f");
+        __classPrivateFieldSet(this, _AgentResultArtifacts_turnID, result.turn_id, "f");
+    }
+    /** Find one immutable artifact by its exact hosted path, across all pages. */
+    async retrieve(path, options) {
+        let selected;
+        for await (const artifact of agentItems((after) => __classPrivateFieldGet(this, _AgentResultArtifacts_resource, "f").list(__classPrivateFieldGet(this, _AgentResultArtifacts_sessionID, "f"), {}, { ...options, query: { ...options?.query, after, environment_id: undefined } }))) {
+            if (artifact.session_id === __classPrivateFieldGet(this, _AgentResultArtifacts_sessionID, "f") &&
+                artifact.turn_id === __classPrivateFieldGet(this, _AgentResultArtifacts_turnID, "f") &&
+                artifact.path === path) {
+                if (selected) {
+                    throw new OpenAIError('Multiple artifacts match this result and path');
+                }
+                selected = artifact;
+            }
+        }
+        if (!selected) {
+            throw new OpenAIError('No artifact matches this result and path');
+        }
+        return selected;
+    }
+    /** Return the native binary response for this result's exact artifact path. */
+    async content(path, options) {
+        const artifact = await this.retrieve(path, options);
+        return __classPrivateFieldGet(this, _AgentResultArtifacts_resource, "f").content(artifact.id, { session_id: __classPrivateFieldGet(this, _AgentResultArtifacts_sessionID, "f") }, options);
+    }
+    /** Stream bytes to a caller-chosen destination; the hosted path never selects a local path. */
+    async download(params, options) {
+        const { path, to } = params;
+        const artifact = await this.retrieve(path, options);
+        const response = await __classPrivateFieldGet(this, _AgentResultArtifacts_resource, "f").content(artifact.id, { session_id: __classPrivateFieldGet(this, _AgentResultArtifacts_sessionID, "f") }, options);
+        if (!response.body) {
+            throw new OpenAIError('Artifact response has no content stream');
+        }
+        try {
+            await response.body.pipeTo(to, options?.signal ? { signal: options.signal } : {});
+        }
+        catch (error) {
+            // pipeTo can reject before acquiring a reader, for example when the destination is locked.
+            try {
+                await response.body.cancel();
+            }
+            catch {
+                /* already cancelled or owned by pipeTo */
+            }
+            throw error;
+        }
+        return artifact;
+    }
+}
+_AgentResultArtifacts_resource = new WeakMap(), _AgentResultArtifacts_sessionID = new WeakMap(), _AgentResultArtifacts_turnID = new WeakMap();
+//# sourceMappingURL=result-artifacts.mjs.map

package/lib/beta/agents/result-artifacts.mjs.map

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

package/package.json

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

package/resources/beta/agents/environments/files.d.mts

@@ -1,8 +1,20 @@
+import { type PreparedAgentFiles } from "../../../../lib/beta/agents/files.mjs";
+import type { Uploadable } from "../../../../internal/uploads.mjs";
 import { APIResource } from "../../../../core/resource.mjs";
 import { APIPromise } from "../../../../core/api-promise.mjs";
 import { PagePromise, TokenPage, type TokenPageParams } from "../../../../core/pagination.mjs";
 import { RequestOptions } from "../../../../internal/request-options.mjs";
 export declare class Files extends APIResource {
+    /** Beta: prepare initial hosted file references; uploaded Files API objects remain caller-owned. */
+    prepare(files: Record<string, Uploadable>, options?: RequestOptions): Promise<PreparedAgentFiles>;
+    /** Beta: upload one local file and stage its reference in a live environment. */
+    upload(environmentID: string, params: {
+        file: Uploadable;
+        path: string;
+    }, options?: RequestOptions): Promise<{
+        uploadedFile: import("../../../index.mjs").FileObject;
+        environmentFile: EnvironmentFile;
+    }>;
     /**
      * Copies inline bytes or a Files API file into a connected execution environment.
      * See

package/resources/beta/agents/environments/files.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"files.d.mts","sourceRoot":"","sources":["../../../../src/resources/beta/agents/environments/files.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,sCAAkC;AACxD,OAAO,EAAE,UAAU,EAAE,yCAAqC;AAC1D,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,wCAAoC;AAE3F,OAAO,EAAE,cAAc,EAAE,iDAA6C;AAUtE,qBAAa,KAAM,SAAQ,WAAW;IACpC;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CACJ,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,gBAAgB,EACtB,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,eAAe,CAAC;IAY9B;;;;;;;;;;;;;;OAcG;IACH,IAAI,CACF,aAAa,EAAE,MAAM,EACrB,KAAK,GAAE,cAAc,GAAG,IAAI,GAAG,SAAc,EAC7C,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,oBAAoB,EAAE,eAAe,CAAC;CAYtD;AAED,MAAM,MAAM,oBAAoB,GAAG,SAAS,CAAC,eAAe,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,MAAM,EAAE,wBAAwB,CAAC;IAEjC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,gBAAgB,GACxB,gBAAgB,CAAC,gCAAgC,GACjD,gBAAgB,CAAC,gCAAgC,CAAC;AAEtD,MAAM,CAAC,OAAO,WAAW,gBAAgB,CAAC;IACxC,UAAiB,gCAAgC;QAC/C;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,IAAI,EAAE,SAAS,CAAC;KACjB;IAED,UAAiB,gCAAgC;QAC/C;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,IAAI,EAAE,QAAQ,CAAC;KAChB;CACF;AAED,MAAM,WAAW,cAAe,SAAQ,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC;IACpE;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAEvB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EACL,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,cAAc,IAAI,cAAc,GACtC,CAAC;CACH"}
+{"version":3,"file":"files.d.mts","sourceRoot":"","sources":["../../../../src/resources/beta/agents/environments/files.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,kBAAkB,EACxB,8CAA0C;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,yCAAqC;AAC/D,OAAO,EAAE,WAAW,EAAE,sCAAkC;AACxD,OAAO,EAAE,UAAU,EAAE,yCAAqC;AAC1D,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,wCAAoC;AAE3F,OAAO,EAAE,cAAc,EAAE,iDAA6C;AAUtE,qBAAa,KAAM,SAAQ,WAAW;IACpC,oGAAoG;IACpG,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIjG,iFAAiF;IACjF,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,OAAO,CAAC,EAAE,cAAc;;;;IAIlG;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CACJ,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,gBAAgB,EACtB,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,eAAe,CAAC;IAY9B;;;;;;;;;;;;;;OAcG;IACH,IAAI,CACF,aAAa,EAAE,MAAM,EACrB,KAAK,GAAE,cAAc,GAAG,IAAI,GAAG,SAAc,EAC7C,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,oBAAoB,EAAE,eAAe,CAAC;CAYtD;AAED,MAAM,MAAM,oBAAoB,GAAG,SAAS,CAAC,eAAe,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,MAAM,EAAE,wBAAwB,CAAC;IAEjC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,gBAAgB,GACxB,gBAAgB,CAAC,gCAAgC,GACjD,gBAAgB,CAAC,gCAAgC,CAAC;AAEtD,MAAM,CAAC,OAAO,WAAW,gBAAgB,CAAC;IACxC,UAAiB,gCAAgC;QAC/C;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,IAAI,EAAE,SAAS,CAAC;KACjB;IAED,UAAiB,gCAAgC;QAC/C;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,IAAI,EAAE,QAAQ,CAAC;KAChB;CACF;AAED,MAAM,WAAW,cAAe,SAAQ,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC;IACpE;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAEvB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EACL,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,cAAc,IAAI,cAAc,GACtC,CAAC;CACH"}

package/resources/beta/agents/environments/files.d.ts

@@ -1,8 +1,20 @@
+import { type PreparedAgentFiles } from "../../../../lib/beta/agents/files.js";
+import type { Uploadable } from "../../../../internal/uploads.js";
 import { APIResource } from "../../../../core/resource.js";
 import { APIPromise } from "../../../../core/api-promise.js";
 import { PagePromise, TokenPage, type TokenPageParams } from "../../../../core/pagination.js";
 import { RequestOptions } from "../../../../internal/request-options.js";
 export declare class Files extends APIResource {
+    /** Beta: prepare initial hosted file references; uploaded Files API objects remain caller-owned. */
+    prepare(files: Record<string, Uploadable>, options?: RequestOptions): Promise<PreparedAgentFiles>;
+    /** Beta: upload one local file and stage its reference in a live environment. */
+    upload(environmentID: string, params: {
+        file: Uploadable;
+        path: string;
+    }, options?: RequestOptions): Promise<{
+        uploadedFile: import("../../../index.js").FileObject;
+        environmentFile: EnvironmentFile;
+    }>;
     /**
      * Copies inline bytes or a Files API file into a connected execution environment.
      * See

package/resources/beta/agents/environments/files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../../../src/resources/beta/agents/environments/files.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,qCAAkC;AACxD,OAAO,EAAE,UAAU,EAAE,wCAAqC;AAC1D,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,uCAAoC;AAE3F,OAAO,EAAE,cAAc,EAAE,gDAA6C;AAUtE,qBAAa,KAAM,SAAQ,WAAW;IACpC;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CACJ,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,gBAAgB,EACtB,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,eAAe,CAAC;IAY9B;;;;;;;;;;;;;;OAcG;IACH,IAAI,CACF,aAAa,EAAE,MAAM,EACrB,KAAK,GAAE,cAAc,GAAG,IAAI,GAAG,SAAc,EAC7C,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,oBAAoB,EAAE,eAAe,CAAC;CAYtD;AAED,MAAM,MAAM,oBAAoB,GAAG,SAAS,CAAC,eAAe,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,MAAM,EAAE,wBAAwB,CAAC;IAEjC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,gBAAgB,GACxB,gBAAgB,CAAC,gCAAgC,GACjD,gBAAgB,CAAC,gCAAgC,CAAC;AAEtD,MAAM,CAAC,OAAO,WAAW,gBAAgB,CAAC;IACxC,UAAiB,gCAAgC;QAC/C;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,IAAI,EAAE,SAAS,CAAC;KACjB;IAED,UAAiB,gCAAgC;QAC/C;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,IAAI,EAAE,QAAQ,CAAC;KAChB;CACF;AAED,MAAM,WAAW,cAAe,SAAQ,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC;IACpE;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAEvB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EACL,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,cAAc,IAAI,cAAc,GACtC,CAAC;CACH"}
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../../../src/resources/beta/agents/environments/files.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,kBAAkB,EACxB,6CAA0C;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,wCAAqC;AAC/D,OAAO,EAAE,WAAW,EAAE,qCAAkC;AACxD,OAAO,EAAE,UAAU,EAAE,wCAAqC;AAC1D,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,uCAAoC;AAE3F,OAAO,EAAE,cAAc,EAAE,gDAA6C;AAUtE,qBAAa,KAAM,SAAQ,WAAW;IACpC,oGAAoG;IACpG,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIjG,iFAAiF;IACjF,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,OAAO,CAAC,EAAE,cAAc;;;;IAIlG;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CACJ,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,gBAAgB,EACtB,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,eAAe,CAAC;IAY9B;;;;;;;;;;;;;;OAcG;IACH,IAAI,CACF,aAAa,EAAE,MAAM,EACrB,KAAK,GAAE,cAAc,GAAG,IAAI,GAAG,SAAc,EAC7C,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,oBAAoB,EAAE,eAAe,CAAC;CAYtD;AAED,MAAM,MAAM,oBAAoB,GAAG,SAAS,CAAC,eAAe,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,MAAM,EAAE,wBAAwB,CAAC;IAEjC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,gBAAgB,GACxB,gBAAgB,CAAC,gCAAgC,GACjD,gBAAgB,CAAC,gCAAgC,CAAC;AAEtD,MAAM,CAAC,OAAO,WAAW,gBAAgB,CAAC;IACxC,UAAiB,gCAAgC;QAC/C;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,IAAI,EAAE,SAAS,CAAC;KACjB;IAED,UAAiB,gCAAgC;QAC/C;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,IAAI,EAAE,QAAQ,CAAC;KAChB;CACF;AAED,MAAM,WAAW,cAAe,SAAQ,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC;IACpE;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAEvB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EACL,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,cAAc,IAAI,cAAc,GACtC,CAAC;CACH"}

package/resources/beta/agents/environments/files.js

@@ -2,6 +2,7 @@
 // File generated from our OpenAPI spec by Castiron. See CONTRIBUTING.md for details.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Files = void 0;
+const files_1 = require("../../../../lib/beta/agents/files.js");
 const resource_1 = require("../../../../core/resource.js");
 const pagination_1 = require("../../../../core/pagination.js");
 const headers_1 = require("../../../../internal/headers.js");
@@ -10,6 +11,14 @@ function resolveResourceRequestOptions(options, buildOptions) {
     return Promise.resolve(options).then(buildOptions);
 }
 class Files extends resource_1.APIResource {
+    /** Beta: prepare initial hosted file references; uploaded Files API objects remain caller-owned. */
+    prepare(files, options) {
+        return (0, files_1.prepareAgentFiles)(this._client, files, options);
+    }
+    /** Beta: upload one local file and stage its reference in a live environment. */
+    upload(environmentID, params, options) {
+        return (0, files_1.uploadAgentFile)(this._client, this, environmentID, params, options);
+    }
     /**
      * Copies inline bytes or a Files API file into a connected execution environment.
      * See

package/resources/beta/agents/environments/files.js.map

@@ -1 +1 @@
-{"version":3,"file":"files.js","sourceRoot":"","sources":["../../../../src/resources/beta/agents/environments/files.ts"],"names":[],"mappings":";AAAA,qFAAqF;;;AAErF,2DAAwD;AAExD,+DAA2F;AAC3F,6DAA4D;AAE5D,6DAAuD;AAEvD,SAAS,6BAA6B,CACpC,OAAmC,EACnC,YAA+F;IAE/F,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AACrD,CAAC;AAED,MAAa,KAAM,SAAQ,sBAAW;IACpC;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CACJ,aAAqB,EACrB,IAAsB,EACtB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CACtB,IAAA,WAAI,EAAA,wBAAwB,aAAa,QAAQ,EACjD,6BAA6B,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACnD,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,aAAa,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACzE,UAAU,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;SACjC,CAAC,CAAC,CACJ,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,IAAI,CACF,aAAqB,EACrB,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,IAAA,WAAI,EAAA,wBAAwB,aAAa,QAAQ,EACjD,CAAA,sBAA0B,CAAA,EAC1B,6BAA6B,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACnD,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,aAAa,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACzE,UAAU,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;SACjC,CAAC,CAAC,CACJ,CAAC;IACJ,CAAC;CACF;AAlED,sBAkEC"}
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../../../src/resources/beta/agents/environments/files.ts"],"names":[],"mappings":";AAAA,qFAAqF;;;AAErF,gEAI2C;AAE3C,2DAAwD;AAExD,+DAA2F;AAC3F,6DAA4D;AAE5D,6DAAuD;AAEvD,SAAS,6BAA6B,CACpC,OAAmC,EACnC,YAA+F;IAE/F,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AACrD,CAAC;AAED,MAAa,KAAM,SAAQ,sBAAW;IACpC,oGAAoG;IACpG,OAAO,CAAC,KAAiC,EAAE,OAAwB;QACjE,OAAO,IAAA,yBAAiB,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAED,iFAAiF;IACjF,MAAM,CAAC,aAAqB,EAAE,MAA0C,EAAE,OAAwB;QAChG,OAAO,IAAA,uBAAe,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CACJ,aAAqB,EACrB,IAAsB,EACtB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CACtB,IAAA,WAAI,EAAA,wBAAwB,aAAa,QAAQ,EACjD,6BAA6B,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACnD,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,aAAa,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACzE,UAAU,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;SACjC,CAAC,CAAC,CACJ,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,IAAI,CACF,aAAqB,EACrB,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,IAAA,WAAI,EAAA,wBAAwB,aAAa,QAAQ,EACjD,CAAA,sBAA0B,CAAA,EAC1B,6BAA6B,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACnD,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,aAAa,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACzE,UAAU,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;SACjC,CAAC,CAAC,CACJ,CAAC;IACJ,CAAC;CACF;AA5ED,sBA4EC"}