@ai-sdk/harness 1.0.19 → 1.0.21

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @ai-sdk/harness
 
+## 1.0.21
+
+### Patch Changes
+
+- Updated dependencies [ac306ed]
+  - @ai-sdk/provider-utils@5.0.6
+  - ai@7.0.18
+
+## 1.0.20
+
+### Patch Changes
+
+- b7aa06a: fix(harness): include step numbers on harness step-end telemetry events.
+  - ai@7.0.17
+
 ## 1.0.19
 
 ### Patch Changes

package/agent/index.ts

@@ -34,7 +34,7 @@ export {
 export {
   prepareHarnessSandboxTemplate,
   prewarmHarness,
-} from '../src/agent/prewarm';
+} from '../src/agent/prepare-harness-sandbox-template';
 export {
   prepareSandboxForHarness,
   type PrepareSandboxForHarnessResult,

package/dist/agent/index.d.ts

@@ -1529,6 +1529,23 @@ type PrepareSandboxForHarnessResult = {
     readonly recipeIdentities: Record<string, string>;
     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.
+ */
 declare function prepareSandboxForHarness(options: {
     readonly session: Experimental_SandboxSession;
     readonly harnesses: ReadonlyArray<HarnessAgentAdapter>;

package/dist/agent/index.js

@@ -1020,6 +1020,7 @@ function createTurnTelemetry(opts) {
         dispatcher,
         cast({
           callId,
+          stepNumber,
           finishReason: info.finishReason,
           usage: info.usage,
           providerMetadata: info.providerMetadata,
@@ -1093,6 +1094,7 @@ function createTurnTelemetry(opts) {
           dispatcher,
           cast({
             callId,
+            stepNumber,
             finishReason: info.finishReason,
             usage: info.usage,
             providerMetadata: void 0,
@@ -3051,7 +3053,7 @@ async function cleanupAfterStartFailure(input) {
   }
 }
 
-// src/agent/prewarm.ts
+// src/agent/prepare-harness-sandbox-template.ts
 async function prepareHarnessSandboxTemplate(options) {
   var _a3, _b3, _c;
   const sandboxConfig = (_a3 = options.sandboxConfig) != null ? _a3 : {};