test: add optional sandbox storage mount integrations (#1229)

Author: seratch

.agents/skills/integration-tests/SKILL.md

@@ -22,10 +22,11 @@ Run integration tests that require a local npm registry by starting `pnpm local-
 Run this exact sequence in the main process and capture the output:
 
 ```bash
-pnpm i && pnpm build:ci && pnpm local-npm:reset && pnpm local-npm:publish && pnpm test:integration
+pnpm i && pnpm build:ci && pnpm local-npm:reset && pnpm local-npm:publish && OPENAI_AGENTS_RUN_STORAGE_MOUNT_INTEGRATION=1 pnpm test:integration
 ```
 
 - Use `pnpm build:ci` here so the skill validates the same serialized build path that GitHub Actions now uses, while still running the normal `prebuild` and `postbuild` lifecycle steps.
+- Run `pnpm test:integration` with `OPENAI_AGENTS_RUN_STORAGE_MOUNT_INTEGRATION=1` so the optional sandbox storage mount coverage runs by default when this skill is used. This enables the local Azurite and MinIO smoke tests without changing the repository's plain `pnpm test:integration` default.
 
 - Return the full success/failure outcome and a concise summary of the results.
 - Always capture the stdout/stderr from `pnpm test:integration` and include it in the final response (trim obvious noise if extremely long) inside a fenced code block.

integration-tests/README.md

@@ -13,6 +13,7 @@ It is intentionally not part of the `pnpm` workspace and instead installs the pa
 - Run `pnpm exec playwright install` to install playwright
 - `pnpm test:integration` will create temporary `integration-tests/cloudflare-workers/worker/.dev.vars` and `integration-tests/vite-react/.env` files from `OPENAI_API_KEY` and restore any pre-existing files during cleanup
 - Integration test fixture subprocesses run with `NODE_ENV=development` so real-model SDK examples keep the normal server-runtime tracing behavior even though Vitest itself runs with `NODE_ENV=test`
+- Optional sandbox storage mount coverage requires Docker with FUSE support and is skipped unless `OPENAI_AGENTS_RUN_STORAGE_MOUNT_INTEGRATION=1` is set. It starts local Azurite and MinIO containers and removes them after the test.
 
 2. **Local npm registry**
 

integration-tests/node.test.ts

@@ -74,4 +74,28 @@ describe('Node.js', () => {
       );
     },
   );
+
+  test(
+    'sandbox storage mounts should run against local emulators',
+    { timeout: 300_000 },
+    async (context) => {
+      if (process.env.OPENAI_AGENTS_RUN_STORAGE_MOUNT_INTEGRATION !== '1') {
+        context.skip();
+      }
+
+      try {
+        await execa`docker info`;
+      } catch {
+        context.skip();
+      }
+
+      const { stdout } = await execa`npm run start:sandbox:storage-mounts`;
+      expect(stdout).toContain(
+        '[STORAGE_MOUNT_RESPONSE]azure:ok[/STORAGE_MOUNT_RESPONSE]',
+      );
+      expect(stdout).toContain(
+        '[STORAGE_MOUNT_RESPONSE]s3:ok[/STORAGE_MOUNT_RESPONSE]',
+      );
+    },
+  );
 });

integration-tests/node/package.json

@@ -7,7 +7,8 @@
     "start:aisdk:cjs": "node aisdk.cjs",
     "start:codex": "node --no-experimental-require-module codex.mjs",
     "start:sandbox:unix-local": "node --no-experimental-require-module sandbox-unix-local.mjs",
-    "start:sandbox:docker": "node --no-experimental-require-module sandbox-docker.mjs"
+    "start:sandbox:docker": "node --no-experimental-require-module sandbox-docker.mjs",
+    "start:sandbox:storage-mounts": "node --no-experimental-require-module sandbox-storage-mounts.mjs"
   },
   "dependencies": {
     "@openai/agents": "latest",

integration-tests/node/sandbox-storage-mounts.Dockerfile

@@ -0,0 +1,5 @@
+FROM node:22-bookworm-slim
+
+RUN apt-get update \
+  && apt-get install -y --no-install-recommends ca-certificates fuse3 rclone \
+  && rm -rf /var/lib/apt/lists/*