openai 7.26.0 → 7.27.0

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

@@ -1,4 +1,5 @@
 // File generated from our OpenAPI spec by Castiron. See CONTRIBUTING.md for details.
+import { prepareAgentFiles, uploadAgentFile, } from "../../../../lib/beta/agents/files.mjs";
 import { APIResource } from "../../../../core/resource.mjs";
 import { TokenPage } from "../../../../core/pagination.mjs";
 import { buildHeaders } from "../../../../internal/headers.mjs";
@@ -7,6 +8,14 @@ function resolveResourceRequestOptions(options, buildOptions) {
     return Promise.resolve(options).then(buildOptions);
 }
 export class Files extends APIResource {
+    /** Beta: prepare initial hosted file references; uploaded Files API objects remain caller-owned. */
+    prepare(files, options) {
+        return prepareAgentFiles(this._client, files, options);
+    }
+    /** Beta: upload one local file and stage its reference in a live environment. */
+    upload(environmentID, params, options) {
+        return 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.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"files.mjs","sourceRoot":"","sources":["../../../../src/resources/beta/agents/environments/files.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,OAAO,EAAE,WAAW,EAAE,sCAAkC;AAExD,OAAO,EAAe,SAAS,EAAwB,wCAAoC;AAC3F,OAAO,EAAE,YAAY,EAAE,yCAAqC;AAE5D,OAAO,EAAE,IAAI,EAAE,4CAAwC;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,MAAM,OAAO,KAAM,SAAQ,WAAW;IACpC;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CACJ,aAAqB,EACrB,IAAsB,EACtB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CACtB,IAAI,CAAA,wBAAwB,aAAa,QAAQ,EACjD,6BAA6B,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACnD,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,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,IAAI,CAAA,wBAAwB,aAAa,QAAQ,EACjD,CAAA,SAA0B,CAAA,EAC1B,6BAA6B,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACnD,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,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"}
+{"version":3,"file":"files.mjs","sourceRoot":"","sources":["../../../../src/resources/beta/agents/environments/files.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,OAAO,EACL,iBAAiB,EACjB,eAAe,GAEhB,8CAA0C;AAE3C,OAAO,EAAE,WAAW,EAAE,sCAAkC;AAExD,OAAO,EAAe,SAAS,EAAwB,wCAAoC;AAC3F,OAAO,EAAE,YAAY,EAAE,yCAAqC;AAE5D,OAAO,EAAE,IAAI,EAAE,4CAAwC;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,MAAM,OAAO,KAAM,SAAQ,WAAW;IACpC,oGAAoG;IACpG,OAAO,CAAC,KAAiC,EAAE,OAAwB;QACjE,OAAO,iBAAiB,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAED,iFAAiF;IACjF,MAAM,CAAC,aAAqB,EAAE,MAA0C,EAAE,OAAwB;QAChG,OAAO,eAAe,CAAC,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,IAAI,CAAA,wBAAwB,aAAa,QAAQ,EACjD,6BAA6B,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACnD,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,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,IAAI,CAAA,wBAAwB,aAAa,QAAQ,EACjD,CAAA,SAA0B,CAAA,EAC1B,6BAA6B,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACnD,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,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"}

package/resources/beta/agents/sessions/artifacts.d.mts

@@ -1,8 +1,12 @@
+import { AgentResultArtifacts } from "../../../../lib/beta/agents/result-artifacts.mjs";
+import type { AgentTurnResult } from "../../../../lib/beta/agents/agent-turn-result.mjs";
 import { APIResource } from "../../../../core/resource.mjs";
 import { APIPromise } from "../../../../core/api-promise.mjs";
 import { CursorPage, type CursorPageParams, PagePromise } from "../../../../core/pagination.mjs";
 import { RequestOptions } from "../../../../internal/request-options.mjs";
 export declare class Artifacts extends APIResource {
+    /** Beta: bind artifact lookup and downloads to a completed result's exact session and turn. */
+    forResult(result: AgentTurnResult): AgentResultArtifacts;
     /**
      * Retrieves immutable metadata for one durable session artifact. See
      * [session artifacts](https://developers.openai.com/api/docs/guides/agents-api/environments/files#openai-hosted-artifacts).

package/resources/beta/agents/sessions/artifacts.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"artifacts.d.mts","sourceRoot":"","sources":["../../../../src/resources/beta/agents/sessions/artifacts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"artifacts.d.mts","sourceRoot":"","sources":["../../../../src/resources/beta/agents/sessions/artifacts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,yDAAqD;AACpF,OAAO,KAAK,EAAE,eAAe,EAAE,0DAAsD;AACrF,OAAO,EAAE,WAAW,EAAE,sCAAkC;AACxD,OAAO,EAAE,UAAU,EAAE,yCAAqC;AAC1D,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,WAAW,EAAE,wCAAoC;AAE7F,OAAO,EAAE,cAAc,EAAE,iDAA6C;AAqHtE,qBAAa,SAAU,SAAQ,WAAW;IACxC,+FAA+F;IAC/F,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,oBAAoB;IAIxD;;;;;;;;;;;;OAYG;IACH,QAAQ,CACN,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,eAAe,CAAC;IAY9B;;;;;;;;;;;;;OAaG;IACH,IAAI,CACF,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EACF,CAAC,kBAAkB,GACjB,CACI;SAEI,CAAC,IACG,QAAQ,GACR,MAAM,GACN,OAAO,GACP,MAAM,GACN,SAAS,GACT,YAAY,GACZ,QAAQ,GACR,SAAS,GACT,WAAW,GACX,cAAc,GACd,QAAQ,GACR,gBAAgB,GAChB,gBAAgB,GAChB,YAAY,GACZ,iBAAiB,GACjB,kBAAkB,GAClB,eAAe,GACf,YAAY,GACZ,uBAAuB,CAC5B,CAAC,EAAE,KAAK;KACV,GACD,IAAI,GACJ,SAAS,CACZ,CAAC,GACJ,IAAI,GACJ,SAAS,EACb,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,oBAAoB,EAAE,eAAe,CAAC;IACrD,IAAI,CACF,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;SACP,CAAC,IAAI,SAAS,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,gBAAgB,GAAG,OAAO,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;KACxG,GAAG;SAEA,CAAC,IACG,QAAQ,GACR,MAAM,GACN,MAAM,GACN,QAAQ,GACR,WAAW,GACX,cAAc,GACd,gBAAgB,GAChB,YAAY,GACZ,iBAAiB,GACjB,kBAAkB,GAClB,eAAe,GACf,YAAY,GACZ,uBAAuB,CAC5B,CAAC,EAAE,KAAK;KACV,GACA,WAAW,CAAC,oBAAoB,EAAE,eAAe,CAAC;IAqDrD;;;;;;;;;;;;;OAaG;IACH,MAAM,CACJ,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,sBAAsB,CAAC;IAYrC;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC;CAe3G;AAED,MAAM,MAAM,oBAAoB,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;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;IAEnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,gCAAgC,CAAC;CAC1C;AAED,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,OAAO,CAAC;IACnF;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,OAAO,EACL,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,qBAAqB,IAAI,qBAAqB,GACpD,CAAC;CACH"}

package/resources/beta/agents/sessions/artifacts.d.ts

@@ -1,8 +1,12 @@
+import { AgentResultArtifacts } from "../../../../lib/beta/agents/result-artifacts.js";
+import type { AgentTurnResult } from "../../../../lib/beta/agents/agent-turn-result.js";
 import { APIResource } from "../../../../core/resource.js";
 import { APIPromise } from "../../../../core/api-promise.js";
 import { CursorPage, type CursorPageParams, PagePromise } from "../../../../core/pagination.js";
 import { RequestOptions } from "../../../../internal/request-options.js";
 export declare class Artifacts extends APIResource {
+    /** Beta: bind artifact lookup and downloads to a completed result's exact session and turn. */
+    forResult(result: AgentTurnResult): AgentResultArtifacts;
     /**
      * Retrieves immutable metadata for one durable session artifact. See
      * [session artifacts](https://developers.openai.com/api/docs/guides/agents-api/environments/files#openai-hosted-artifacts).

package/resources/beta/agents/sessions/artifacts.d.ts.map

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

package/resources/beta/agents/sessions/artifacts.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.Artifacts = void 0;
+const result_artifacts_1 = require("../../../../lib/beta/agents/result-artifacts.js");
 const resource_1 = require("../../../../core/resource.js");
 const pagination_1 = require("../../../../core/pagination.js");
 const headers_1 = require("../../../../internal/headers.js");
@@ -62,6 +63,10 @@ function normalizeRequestOptionsForQuery(value, queryKeys, options) {
     }));
 }
 class Artifacts extends resource_1.APIResource {
+    /** Beta: bind artifact lookup and downloads to a completed result's exact session and turn. */
+    forResult(result) {
+        return new result_artifacts_1.AgentResultArtifacts(this, result);
+    }
     /**
      * Retrieves immutable metadata for one durable session artifact. See
      * [session artifacts](https://developers.openai.com/api/docs/guides/agents-api/environments/files#openai-hosted-artifacts).

package/resources/beta/agents/sessions/artifacts.js.map

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

package/resources/beta/agents/sessions/artifacts.mjs

@@ -1,4 +1,5 @@
 // File generated from our OpenAPI spec by Castiron. See CONTRIBUTING.md for details.
+import { AgentResultArtifacts } from "../../../../lib/beta/agents/result-artifacts.mjs";
 import { APIResource } from "../../../../core/resource.mjs";
 import { CursorPage } from "../../../../core/pagination.mjs";
 import { buildHeaders } from "../../../../internal/headers.mjs";
@@ -59,6 +60,10 @@ function normalizeRequestOptionsForQuery(value, queryKeys, options) {
     }));
 }
 export class Artifacts extends APIResource {
+    /** Beta: bind artifact lookup and downloads to a completed result's exact session and turn. */
+    forResult(result) {
+        return new AgentResultArtifacts(this, result);
+    }
     /**
      * Retrieves immutable metadata for one durable session artifact. See
      * [session artifacts](https://developers.openai.com/api/docs/guides/agents-api/environments/files#openai-hosted-artifacts).

package/resources/beta/agents/sessions/artifacts.mjs.map

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

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

@@ -0,0 +1,187 @@
+import { constants } from 'node:fs';
+import type { Stats } from 'node:fs';
+import type { WritableStream as AgentWritableStream } from '../../../internal/shim-types';
+import { lstat, open, realpath } from 'node:fs/promises';
+import type { FileHandle } from 'node:fs/promises';
+import nodePath from 'node:path';
+import { OpenAIError } from '../../../core/error';
+import { toStreamingFile } from '../../../internal/uploads';
+import type { StreamingFile } from '../../../internal/uploads';
+import type { RequestOptions } from '../../../internal/request-options';
+import type { Files } from '../../../resources/beta/agents/environments/files';
+import type { PreparedAgentFiles } from '../../../lib/beta/agents/files';
+
+async function checkedPath(path: string, boundary?: string): Promise<{ path: string; info: Stats }> {
+  const absolute = nodePath.resolve(path);
+  const root = boundary ?? nodePath.dirname(absolute);
+  let current = root;
+  let selected: Stats | undefined;
+  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,
+}: {
+  path: string;
+  info: Stats;
+}): StreamingFile & { size: number } {
+  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: string): Promise<StreamingFile & { size: number }> {
+  return selectedAgentFile(await checkedPath(path));
+}
+
+/** Beta, Node.js: prepare explicit files from a stable application-owned directory once. */
+export async function prepareAgentDirectory(
+  resource: Files,
+  directory: string,
+  params: { include: readonly string[]; to?: string },
+  options?: RequestOptions,
+): Promise<PreparedAgentFiles> {
+  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: Record<string, StreamingFile & { size: number }> = {};
+  const seen = new Set<string>();
+  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: string): AgentWritableStream<Uint8Array> {
+  const absolute = nodePath.resolve(path);
+  let handle: FileHandle | undefined;
+  const close = async () => {
+    await handle?.close();
+    handle = undefined;
+  };
+  const file = async () => {
+    if (handle) {
+      return handle;
+    }
+    let expected: Stats | undefined;
+    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<Uint8Array>({
+    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();
+    },
+  });
+}

package/src/internal/shim-types.ts

@@ -23,3 +23,20 @@ type _ReadableStream<R = any> = NeverToAny<
 >;
 
 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 };

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

@@ -0,0 +1,119 @@
+import type { OpenAI } from '../../../client';
+import { OpenAIError } from '../../../core/error';
+import { buildHeaders } from '../../../internal/headers';
+import type { RequestOptions } from '../../../internal/request-options';
+import type { Uploadable } from '../../../internal/uploads';
+import type { FileObject } from '../../../resources/files';
+import type {
+  EnvironmentFile,
+  FileCreateParams,
+  Files,
+} from '../../../resources/beta/agents/environments/files';
+
+/** 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 class AgentFileUploadError extends OpenAIError {
+  override readonly name = 'AgentFileUploadError';
+  declare readonly cause: unknown;
+  readonly uploadedFiles: FileObject[];
+  constructor(uploadedFiles: FileObject[], cause: unknown) {
+    super('Agent file preparation or staging failed; uploaded files remain caller-owned.');
+    this.uploadedFiles = uploadedFiles;
+    Object.defineProperty(this, 'cause', { value: cause, configurable: true });
+  }
+}
+
+/** @internal */
+export function validateAgentFilePath(path: string): void {
+  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: Record<string, Uploadable>, options: RequestOptions): [string, Uploadable][] {
+  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: OpenAI,
+  files: Record<string, Uploadable>,
+  options?: RequestOptions,
+): Promise<PreparedAgentFiles> {
+  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: PreparedAgentFiles = { 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: OpenAI,
+  resource: Files,
+  environmentID: string,
+  params: { file: Uploadable; path: string },
+  options?: RequestOptions,
+): Promise<{ uploadedFile: FileObject; environmentFile: EnvironmentFile }> {
+  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);
+  }
+}

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

@@ -0,0 +1,32 @@
+import { OpenAIError } from '../../../core/error';
+import type { CursorPage } from '../../../core/pagination';
+import { isObj } from '../../../internal/utils/values';
+
+/** 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<T extends { id?: string | null }>(
+  load: (after: string | undefined) => PromiseLike<CursorPage<T>>,
+): AsyncGenerator<T, void, undefined> {
+  let after: string | undefined;
+  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;
+  }
+}

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

@@ -0,0 +1,76 @@
+import type { WritableStream } from '../../../internal/shim-types';
+import { agentItems } from './pages';
+import { OpenAIError } from '../../../core/error';
+import type { RequestOptions } from '../../../internal/request-options';
+import type { Artifacts, SessionArtifact } from '../../../resources/beta/agents/sessions/artifacts';
+import type { AgentTurnResult } from './agent-turn-result';
+
+/** Beta: artifacts from the exact session and turn represented by a result. */
+export class AgentResultArtifacts {
+  readonly #resource: Artifacts;
+  readonly #sessionID: string;
+  readonly #turnID: string;
+  constructor(resource: Artifacts, result: AgentTurnResult) {
+    this.#resource = resource;
+    this.#sessionID = result.session_id;
+    this.#turnID = result.turn_id;
+  }
+
+  /** Find one immutable artifact by its exact hosted path, across all pages. */
+  async retrieve(path: string, options?: RequestOptions): Promise<SessionArtifact> {
+    let selected: SessionArtifact | undefined;
+    for await (const artifact of agentItems((after) =>
+      this.#resource.list(
+        this.#sessionID,
+        {},
+        { ...options, query: { ...options?.query, after, environment_id: undefined } },
+      ),
+    )) {
+      if (
+        artifact.session_id === this.#sessionID &&
+        artifact.turn_id === this.#turnID &&
+        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: string, options?: RequestOptions): Promise<Response> {
+    const artifact = await this.retrieve(path, options);
+    return this.#resource.content(artifact.id, { session_id: this.#sessionID }, options);
+  }
+
+  /** Stream bytes to a caller-chosen destination; the hosted path never selects a local path. */
+  async download(
+    params: { path: string; to: WritableStream<Uint8Array> },
+    options?: RequestOptions,
+  ): Promise<SessionArtifact> {
+    const { path, to } = params;
+    const artifact = await this.retrieve(path, options);
+    const response = await this.#resource.content(artifact.id, { session_id: this.#sessionID }, 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;
+  }
+}

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

@@ -1,5 +1,11 @@
 // File generated from our OpenAPI spec by Castiron. See CONTRIBUTING.md for details.
 
+import {
+  prepareAgentFiles,
+  uploadAgentFile,
+  type PreparedAgentFiles,
+} from '../../../../lib/beta/agents/files';
+import type { Uploadable } from '../../../../internal/uploads';
 import { APIResource } from '../../../../core/resource';
 import { APIPromise } from '../../../../core/api-promise';
 import { PagePromise, TokenPage, type TokenPageParams } from '../../../../core/pagination';
@@ -15,6 +21,16 @@ function resolveResourceRequestOptions(
 }
 
 export 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> {
+    return prepareAgentFiles(this._client, files, options);
+  }
+
+  /** Beta: upload one local file and stage its reference in a live environment. */
+  upload(environmentID: string, params: { file: Uploadable; path: string }, options?: RequestOptions) {
+    return uploadAgentFile(this._client, this, environmentID, params, options);
+  }
+
   /**
    * Copies inline bytes or a Files API file into a connected execution environment.
    * See