@ai-sdk/harness 1.0.18 → 1.0.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/harness",
-  "version": "1.0.18",
+  "version": "1.0.20",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -46,7 +46,7 @@
   "dependencies": {
     "@ai-sdk/provider": "4.0.2",
     "@ai-sdk/provider-utils": "5.0.5",
-    "ai": "7.0.15"
+    "ai": "7.0.17"
   },
   "peerDependencies": {
     "ws": "^8.21.0",

package/src/agent/internal/turn-telemetry.ts

@@ -241,6 +241,7 @@ export function createTurnTelemetry(opts: {
       dispatcher.onStepEnd?.(
         cast<'onStepEnd'>({
           callId,
+          stepNumber,
           finishReason: info.finishReason,
           usage: info.usage,
           providerMetadata: info.providerMetadata,
@@ -313,6 +314,7 @@ export function createTurnTelemetry(opts: {
         dispatcher.onStepEnd?.(
           cast<'onStepEnd'>({
             callId,
+            stepNumber,
             finishReason: info.finishReason,
             usage: info.usage,
             providerMetadata: undefined,

package/src/agent/prepare-sandbox-for-harness.ts

@@ -19,6 +19,23 @@ export type PrepareSandboxForHarnessResult = {
   readonly skippedHarnessIds: ReadonlyArray<string>;
 };
 
+/**
+ * Apply one or more harness bootstrap recipes to an existing sandbox session.
+ *
+ * Use this when a sandbox provider or caller wants to prepare a reusable
+ * sandbox template, image, or snapshot before creating live harness sessions.
+ *
+ * The function writes each adapter's bridge/bootstrap files, runs its install
+ * commands, and then returns a deterministic identity derived from the applied
+ * recipes and optional sandbox bootstrap configuration. Providers can use that
+ * identity as the cache key for the prepared artifact.
+ *
+ * This function only mutates the supplied sandbox; the caller is responsible for
+ * committing, snapshotting, or otherwise persisting that modified filesystem.
+ * When a later `HarnessAgent` session uses a sandbox created from the persisted
+ * artifact, the adapter recomputes the same recipe identity and the existing
+ * bootstrap marker makes the bootstrap logic a no-op.
+ */
 export async function prepareSandboxForHarness(options: {
   readonly session: SandboxSession;
   readonly harnesses: ReadonlyArray<HarnessAgentAdapter>;