ai 7.0.0-beta.186 → 7.0.0-beta.187

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # ai
 
+## 7.0.0-beta.187
+
+### Patch Changes
+
+- Updated dependencies [77cc1af]
+  - @ai-sdk/gateway@4.0.0-beta.114
+
 ## 7.0.0-beta.186
 
 ### Patch Changes

package/dist/index.js

@@ -1089,7 +1089,7 @@ import {
 } from "@ai-sdk/provider-utils";
 
 // src/version.ts
-var VERSION = true ? "7.0.0-beta.186" : "0.0.0-test";
+var VERSION = true ? "7.0.0-beta.187" : "0.0.0-test";
 
 // src/util/download/download.ts
 var download = async ({

package/dist/internal/index.js

@@ -83,7 +83,7 @@ import {
 } from "@ai-sdk/provider-utils";
 
 // src/version.ts
-var VERSION = true ? "7.0.0-beta.186" : "0.0.0-test";
+var VERSION = true ? "7.0.0-beta.187" : "0.0.0-test";
 
 // src/util/download/download.ts
 var download = async ({

package/docs/03-ai-sdk-harnesses/02-harness-agent.mdx

@@ -7,7 +7,7 @@ description: Create and run AI SDK HarnessAgent sessions.
 
 `HarnessAgent` is an AI SDK `Agent` implementation backed by a harness adapter.
 It gives you `generate()` and `stream()` methods that return AI SDK-compatible
-results while an preconfigured harness powers these results.
+results while a preconfigured harness powers these results.
 
 ## Installation
 
@@ -213,8 +213,17 @@ the continued turn and return a `GenerateTextResult`.
 
 ## Prepare the Sandbox
 
-Use `onSandboxSession` to prepare files, install lightweight utilities, or write
-configuration before the harness starts:
+Use `sandboxConfig` to prepare the sandbox before the harness starts.
+
+`sandboxConfig.onBootstrap` runs during sandbox template creation, after the
+harness adapter's own bootstrap and before snapshot-capable providers publish a
+snapshot. Use it for expensive setup that should be reused by future sessions.
+When you provide `onBootstrap`, also provide `bootstrapHash`; change the hash
+whenever the bootstrap output should invalidate the reusable snapshot.
+
+`sandboxConfig.onSession` runs after each sandbox session is acquired and its
+working directory exists, including resumed sessions. Use it for per-session
+files or lightweight configuration.
 
 ```ts
 const agent = new HarnessAgent({
@@ -223,17 +232,34 @@ const agent = new HarnessAgent({
     runtime: 'node24',
     ports: [4000],
   }),
-  onSandboxSession: async ({ session, sessionWorkDir, abortSignal }) => {
-    await session.writeTextFile({
-      path: `${sessionWorkDir}/README.md`,
-      content: 'Session notes for the harness.',
-      abortSignal,
-    });
+  sandboxConfig: {
+    workDir: 'repo',
+    bootstrapHash: 'ripgrep-v1',
+    onBootstrap: async ({ session, abortSignal }) => {
+      const result = await session.run({
+        command:
+          'command -v rg >/dev/null || (apt-get update && apt-get install -y ripgrep)',
+        abortSignal,
+      });
+      if (result.exitCode !== 0) {
+        throw new Error(`Failed to install ripgrep: ${result.stderr}`);
+      }
+    },
+    onSession: async ({ session, sessionWorkDir, abortSignal }) => {
+      await session.writeTextFile({
+        path: `${sessionWorkDir}/README.md`,
+        content: 'Session notes for the harness.',
+        abortSignal,
+      });
+    },
   },
 });
 ```
 
-This hook runs for fresh and resumed sessions. Keep it idempotent.
+`workDir` is optional. When provided, it must be relative to the sandbox's
+default working directory and is used as the session working directory. When
+omitted, regular sessions use the default `<harnessId>-<sessionId>` directory,
+while `onBootstrap` receives the sandbox's default working directory.
 
 ## Settings
 
@@ -247,7 +273,7 @@ This hook runs for fresh and resumed sessions. Keep it idempotent.
 - `skills`: instruction bundles surfaced by the adapter.
 - `permissionMode`: built-in tool permission mode.
 - `toolApproval`: approval status map for host-executed tools.
-- `onSandboxSession`: sandbox preparation hook.
+- `sandboxConfig`: sandbox working-directory and lifecycle hook configuration.
 - `telemetry`, `debug`, and `onLog`: observability and diagnostics.
 
 Adapter-specific settings belong on the adapter factory, for example

package/docs/03-ai-sdk-harnesses/03-tools.mdx

@@ -164,11 +164,8 @@ In direct agent code, pass the approval response as `messages` on the next
 
 ## Built-in Approval Support
 
-Not every adapter can pause built-in tool calls for approval:
-
-- Claude Code supports built-in approval requests.
-- Pi supports built-in approval requests.
-- Codex currently does not; use `permissionMode: 'allow-all'`.
+Most adapters can pause built-in tool calls for approval. Adapters that do not
+support it will error if an unsupported tool approval mode is specified.
 
 Host-executed tool approvals are handled by `HarnessAgent`, so they work across
 adapters.

package/docs/03-ai-sdk-harnesses/05-harness-adapters.mdx

@@ -16,6 +16,7 @@ The AI SDK includes the following harness adapters:
 
 - [Claude Code](/providers/ai-sdk-harnesses/claude-code) (`@ai-sdk/harness-claude-code`)
 - [Codex](/providers/ai-sdk-harnesses/codex) (`@ai-sdk/harness-codex`)
+- [OpenCode](/providers/ai-sdk-harnesses/opencode) (`@ai-sdk/harness-opencode`)
 - [Pi](/providers/ai-sdk-harnesses/pi) (`@ai-sdk/harness-pi`)
 
 ### Coming Soon
@@ -24,7 +25,6 @@ The AI SDK includes the following harness adapters:
 - DeepAgents (`@ai-sdk/harness-deepagents`)
 - Goose (`@ai-sdk/harness-goose`)
 - Mastra (`@ai-sdk/harness-mastra`)
-- OpenCode (`@ai-sdk/harness-opencode`)
 
 ## Adapter Capabilities
 
@@ -32,4 +32,5 @@ The AI SDK includes the following harness adapters:
 | ------------------------------------------------------ | ---------------- | ------------------- | ------------------- | ---------------------- |
 | [Claude Code](/providers/ai-sdk-harnesses/claude-code) | Sandbox bridge   | <Check size={18} /> | <Check size={18} /> | <Check size={18} />    |
 | [Codex](/providers/ai-sdk-harnesses/codex)             | Sandbox bridge   | <Check size={18} /> | <Check size={18} /> | <Cross size={18} />    |
+| [OpenCode](/providers/ai-sdk-harnesses/opencode)       | Sandbox bridge   | <Check size={18} /> | <Check size={18} /> | <Check size={18} />    |
 | [Pi](/providers/ai-sdk-harnesses/pi)                   | Host process     | <Check size={18} /> | <Check size={18} /> | <Check size={18} />    |

package/docs/03-ai-sdk-harnesses/index.mdx

@@ -35,8 +35,7 @@ running established agent harnesses such as Claude Code, Codex, and Pi.
     },
     {
       title: 'Harness Adapters',
-      description:
-        'Choose from the implemented Claude Code, Codex, and Pi harness adapters.',
+      description: 'Learn about the available harness adapters.',
       href: '/docs/ai-sdk-harnesses/harness-adapters',
     },
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai",
-  "version": "7.0.0-beta.186",
+  "version": "7.0.0-beta.187",
   "type": "module",
   "description": "AI SDK by Vercel - build apps like ChatGPT, Claude, Gemini, and more with a single interface for any model using the Vercel AI Gateway or go direct to OpenAI, Anthropic, Google, or any other model provider.",
   "license": "Apache-2.0",
@@ -42,7 +42,7 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/gateway": "4.0.0-beta.113",
+    "@ai-sdk/gateway": "4.0.0-beta.114",
     "@ai-sdk/provider": "4.0.0-beta.20",
     "@ai-sdk/provider-utils": "5.0.0-beta.50"
   },