@ai-sdk/harness 1.0.124 → 1.0.127

package/dist/agent/index.js

@@ -521,7 +521,7 @@ var HarnessStreamTextResult = class {
     ]) {
       try {
         dp.reject(error);
-      } catch (e) {
+      } catch {
       }
     }
   }
@@ -644,11 +644,10 @@ var HarnessStreamTextResult = class {
     );
   }
   get elementStream() {
-    var _a4, _b4, _c;
-    const transform = (_a4 = this.outputSpecification) == null ? void 0 : _a4.createElementStreamTransform();
+    const transform = this.outputSpecification?.createElementStreamTransform();
     if (transform == null) {
       throw notSupportedYet(
-        `element streams in ${(_c = (_b4 = this.outputSpecification) == null ? void 0 : _b4.name) != null ? _c : "text"} mode`
+        `element streams in ${this.outputSpecification?.name ?? "text"} mode`
       );
     }
     return createAsyncIterableStream(
@@ -807,7 +806,6 @@ function createOutputTransformStream(output) {
   };
   return new TransformStream({
     async transform(chunk, controller) {
-      var _a4;
       if (chunk.type === "finish-step" && textChunk.length > 0) {
         publishTextChunk({ controller });
       }
@@ -834,7 +832,7 @@ function createOutputTransformStream(output) {
       }
       text += chunk.text;
       textChunk += chunk.text;
-      textProviderMetadata = (_a4 = chunk.providerMetadata) != null ? _a4 : textProviderMetadata;
+      textProviderMetadata = chunk.providerMetadata ?? textProviderMetadata;
       if (chunk.text.length === 0 && chunk.providerMetadata != null) {
         controller.enqueue({ part: chunk, partialOutput: void 0 });
         return;
@@ -880,7 +878,6 @@ function getOwn(obj, key) {
 // src/agent/internal/translate-stream-part.ts
 import { generateId } from "@ai-sdk/provider-utils";
 function translateStreamPart(event, options = {}) {
-  var _a4, _b4;
   switch (event.type) {
     case "stream-start":
       return [];
@@ -943,7 +940,7 @@ function translateStreamPart(event, options = {}) {
     case "tool-approval-request":
       return [];
     case "tool-result":
-      if (event.isError === true && ((_b4 = (_a4 = options.isProviderExecuted) == null ? void 0 : _a4.call(options, event.toolCallId)) != null ? _b4 : true)) {
+      if (event.isError === true && (options.isProviderExecuted?.(event.toolCallId) ?? true)) {
         return [
           {
             type: "tool-error",
@@ -1042,7 +1039,6 @@ function createToolInputWorkDirStripper({
 }) {
   const stateByToolCallId = /* @__PURE__ */ new Map();
   return (part) => {
-    var _a4;
     if (sessionWorkDir.length === 0) return [part];
     if (part.type === "tool-input-start") {
       stateByToolCallId.set(part.id, {
@@ -1052,7 +1048,7 @@ function createToolInputWorkDirStripper({
       return [part];
     }
     if (part.type === "tool-input-delta") {
-      const state2 = (_a4 = stateByToolCallId.get(part.id)) != null ? _a4 : {
+      const state2 = stateByToolCallId.get(part.id) ?? {
         pending: "",
         precedingCharacter: void 0
       };
@@ -1231,15 +1227,14 @@ import { createTelemetryDispatcher } from "ai/internal";
 async function notify(event, ...callbacks) {
   await Promise.allSettled(
     callbacks.map(async (callback) => {
-      await (callback == null ? void 0 : callback(event));
+      await callback?.(event);
     })
   );
 }
 function createTurnLifecycle(options) {
-  var _a4;
   const telemetry = options.telemetry == null ? {} : createTelemetryDispatcher({ telemetry: options.telemetry });
   const provider = `harness:${options.harnessId}`;
-  let modelId = (_a4 = options.modelId) != null ? _a4 : "";
+  let modelId = options.modelId ?? "";
   let started = false;
   let stepOpen = false;
   let stepNumber = 0;
@@ -1381,7 +1376,6 @@ function createTurnLifecycle(options) {
       );
     },
     async stepEnd(step) {
-      var _a5, _b4, _c;
       if (!stepOpen) return;
       completedSteps.push(step);
       const telemetryStepEndEvent = Object.assign(/* @__PURE__ */ Object.create(null), {
@@ -1412,8 +1406,8 @@ function createTurnLifecycle(options) {
         dynamicToolResults: step.dynamicToolResults
       });
       await Promise.allSettled([
-        (_b4 = (_a5 = options.callbacks).onStepEnd) == null ? void 0 : _b4.call(_a5, step),
-        (_c = telemetry.onStepEnd) == null ? void 0 : _c.call(telemetry, telemetryStepEndEvent)
+        options.callbacks.onStepEnd?.(step),
+        telemetry.onStepEnd?.(telemetryStepEndEvent)
       ]);
       stepOpen = false;
       stepNumber += 1;
@@ -1445,10 +1439,7 @@ function createTurnLifecycle(options) {
         rawFinishReason: finalStep.rawFinishReason,
         usage,
         totalUsage: usage,
-        warnings: steps.flatMap((step) => {
-          var _a5;
-          return (_a5 = step.warnings) != null ? _a5 : [];
-        }),
+        warnings: steps.flatMap((step) => step.warnings ?? []),
         request: finalStep.request,
         response: finalStep.response,
         providerMetadata: finalStep.providerMetadata,
@@ -1471,11 +1462,10 @@ function createTurnLifecycle(options) {
       });
     },
     async error(error) {
-      var _a5;
       if (ended) return;
       if (!started) await start();
       ended = true;
-      await ((_a5 = telemetry.onError) == null ? void 0 : _a5.call(telemetry, error));
+      await telemetry.onError?.(error);
     }
   };
 }
@@ -1483,16 +1473,14 @@ function createTurnLifecycle(options) {
 // src/agent/internal/permission-mode.ts
 var DEFAULT_PERMISSION_MODE = "allow-all";
 function resolvePermissionMode(input) {
-  var _a4;
-  return (_a4 = input.permissionMode) != null ? _a4 : DEFAULT_PERMISSION_MODE;
+  return input.permissionMode ?? DEFAULT_PERMISSION_MODE;
 }
 function permissionModeNeedsBuiltinSupport(input) {
   return input.permissionMode !== "allow-all";
 }
 function resolveCustomToolApproval(input) {
-  var _a4;
   const status = normalizeToolApprovalStatus({
-    status: (_a4 = input.toolApproval) == null ? void 0 : _a4[input.toolName]
+    status: input.toolApproval?.[input.toolName]
   });
   switch (status.type) {
     case "not-applicable":
@@ -1518,24 +1506,23 @@ function stringifyUnknown(value) {
   if (typeof value === "string") return value;
   try {
     return JSON.stringify(value);
-  } catch (e) {
+  } catch {
     return String(value);
   }
 }
 function formatBridgeError(error) {
-  var _a4, _b4;
   if (error instanceof Error) {
-    return (_a4 = error.stack) != null ? _a4 : `${error.name}: ${error.message}`;
+    return error.stack ?? `${error.name}: ${error.message}`;
   }
   if (isSerializedError(error)) {
-    return (_b4 = error.stack) != null ? _b4 : `${error.name ? `${error.name}: ` : ""}${error.message}`;
+    return error.stack ?? `${error.name ? `${error.name}: ` : ""}${error.message}`;
   }
   return stringifyUnknown(error);
 }
 function writeToStderr(line) {
   try {
     process.stderr.write(line);
-  } catch (e) {
+  } catch {
   }
 }
 function logBridgeError({
@@ -1564,9 +1551,8 @@ var sandboxChannelEventCheckpointSymbol = /* @__PURE__ */ Symbol.for(
   "vercel.ai.harness.sandboxChannelEventCheckpoint"
 );
 function pinSandboxChannelEventCheckpoint(event) {
-  var _a4;
   if (event == null || typeof event !== "object") return void 0;
-  return (_a4 = event[sandboxChannelEventCheckpointSymbol]) == null ? void 0 : _a4.pin();
+  return event[sandboxChannelEventCheckpointSymbol]?.pin();
 }
 
 // src/agent/internal/run-prompt.ts
@@ -1591,29 +1577,28 @@ function unwrapToolResultOutput(toolResult) {
   }
 }
 function runPrompt(input) {
-  var _a4, _b4, _c, _d, _e, _f, _g, _h, _i, _j;
   const callId = generateId2();
-  const toolsContext = (_a4 = input.toolsContext) != null ? _a4 : {};
+  const toolsContext = input.toolsContext ?? {};
   const result = new HarnessStreamTextResult({
     tools: input.tools,
     runtimeContext: input.runtimeContext,
     toolsContext,
     harnessId: input.harness.harnessId,
     callId,
-    modelId: (_b4 = input.model) != null ? _b4 : "",
+    modelId: input.model ?? "",
     output: input.output
   });
-  const pendingToolApprovals = (_c = input.pendingToolApprovals) != null ? _c : [];
-  const pendingToolResults = (_d = input.pendingToolResults) != null ? _d : [];
-  const onPendingToolApproval = (_e = input.onPendingToolApproval) != null ? _e : (() => {
+  const pendingToolApprovals = input.pendingToolApprovals ?? [];
+  const pendingToolResults = input.pendingToolResults ?? [];
+  const onPendingToolApproval = input.onPendingToolApproval ?? (() => {
   });
-  const onToolApprovalSettled = (_f = input.onToolApprovalSettled) != null ? _f : (() => {
+  const onToolApprovalSettled = input.onToolApprovalSettled ?? (() => {
   });
-  const onPendingToolResult = (_g = input.onPendingToolResult) != null ? _g : (() => {
+  const onPendingToolResult = input.onPendingToolResult ?? (() => {
   });
-  const onToolResultSettled = (_h = input.onToolResultSettled) != null ? _h : (() => {
+  const onToolResultSettled = input.onToolResultSettled ?? (() => {
   });
-  const activeTools = (_i = input.activeTools) != null ? _i : input.tools;
+  const activeTools = input.activeTools ?? input.tools;
   const activeToolNames = Object.keys(input.tools).filter(
     (toolName) => Object.prototype.hasOwnProperty.call(activeTools, toolName) || Object.prototype.hasOwnProperty.call(
       input.harness.builtinTools,
@@ -1626,7 +1611,7 @@ function runPrompt(input) {
   const lifecycle = createTurnLifecycle({
     callId,
     telemetry: input.telemetry,
-    callbacks: (_j = input.callbacks) != null ? _j : {},
+    callbacks: input.callbacks ?? {},
     harnessId: input.harness.harnessId,
     modelId: input.model,
     instructions: input.instructions,
@@ -1639,11 +1624,10 @@ function runPrompt(input) {
     output: input.output
   });
   const settleFailure = (err) => {
-    var _a5, _b5, _c2;
-    if (!((_a5 = input.isTurnSuspending) == null ? void 0 : _a5.call(input))) {
-      (_b5 = input.onTurnFailed) == null ? void 0 : _b5.call(input);
+    if (!input.isTurnSuspending?.()) {
+      input.onTurnFailed?.();
     }
-    if ((_c2 = input.abortSignal) == null ? void 0 : _c2.aborted) {
+    if (input.abortSignal?.aborted) {
       result.abort({
         error: err,
         ...input.abortSignal.reason !== void 0 ? { reason: getErrorMessage(input.abortSignal.reason) } : {}
@@ -1653,23 +1637,18 @@ function runPrompt(input) {
     result.fail(err);
   };
   const done = (async () => {
-    var _a5, _b5, _c2, _d2, _e2, _f2, _g2, _h2, _i2, _j2, _k, _l, _m, _n, _o;
     let bridge;
     try {
       bridge = await toHarnessStream({
-        invoke: input.mode === "continue" ? (emit) => {
-          var _a6;
-          return input.session.doContinueTurn({
-            model: input.model,
-            skills: (_a6 = input.skills) != null ? _a6 : [],
-            responseFormat: input.responseFormat,
-            tools: input.toolSpecs,
-            instructions: input.instructions,
-            abortSignal: input.abortSignal,
-            emit
-          });
-        } : (emit) => {
-          var _a6;
+        invoke: input.mode === "continue" ? (emit) => input.session.doContinueTurn({
+          model: input.model,
+          skills: input.skills ?? [],
+          responseFormat: input.responseFormat,
+          tools: input.toolSpecs,
+          instructions: input.instructions,
+          abortSignal: input.abortSignal,
+          emit
+        }) : (emit) => {
           if (input.prompt == null) {
             throw new Error(
               'runPrompt: `prompt` is required for mode "prompt".'
@@ -1678,7 +1657,7 @@ function runPrompt(input) {
           return input.session.doPromptTurn({
             prompt: input.prompt,
             model: input.model,
-            skills: (_a6 = input.skills) != null ? _a6 : [],
+            skills: input.skills ?? [],
             responseFormat: input.responseFormat,
             tools: input.toolSpecs,
             instructions: input.instructions,
@@ -1699,7 +1678,7 @@ function runPrompt(input) {
       return;
     }
     const { stream, control } = bridge;
-    (_a5 = input.onPromptControlAvailable) == null ? void 0 : _a5.call(input, control);
+    input.onPromptControlAvailable?.(control);
     const reader = stream.getReader();
     const stripToolInputWorkDir = createToolInputWorkDirStripper({
       sessionWorkDir: input.sessionWorkDir
@@ -1719,7 +1698,7 @@ function runPrompt(input) {
       pendingToolApprovals.map((approval) => [approval.toolCallId, approval])
     );
     const continuationsByApprovalId = new Map(
-      ((_b5 = input.toolApprovalContinuations) != null ? _b5 : []).map((continuation) => [
+      (input.toolApprovalContinuations ?? []).map((continuation) => [
         continuation.approvalId,
         continuation
       ])
@@ -1731,7 +1710,7 @@ function runPrompt(input) {
       ])
     );
     const continuationsByToolCallId = new Map(
-      ((_c2 = input.toolResultContinuations) != null ? _c2 : []).map((continuation) => [
+      (input.toolResultContinuations ?? []).map((continuation) => [
         continuation.toolCallId,
         continuation
       ])
@@ -1760,8 +1739,7 @@ function runPrompt(input) {
       }
     };
     const releasePendingStopBoundary = () => {
-      var _a6;
-      (_a6 = pendingStopBoundary == null ? void 0 : pendingStopBoundary.releaseCheckpoint) == null ? void 0 : _a6.call(pendingStopBoundary);
+      pendingStopBoundary?.releaseCheckpoint?.();
       pendingStopBoundary = void 0;
     };
     let stepText = "";
@@ -1772,7 +1750,6 @@ function runPrompt(input) {
     let bufferedToolOutcomes = [];
     const toolExecutions = /* @__PURE__ */ new Map();
     const publishToolExecutions = async () => {
-      var _a6;
       for (const execution of toolExecutions.values()) {
         if (execution.toolOutput == null) continue;
         await lifecycle.toolExecutionStart({
@@ -1781,7 +1758,7 @@ function runPrompt(input) {
         await lifecycle.toolExecutionEnd({
           toolCall: execution.toolCall,
           toolOutput: execution.toolOutput,
-          toolExecutionMs: (_a6 = execution.toolExecutionMs) != null ? _a6 : 0
+          toolExecutionMs: execution.toolExecutionMs ?? 0
         });
       }
       for (const publish of bufferedToolOutcomes) publish();
@@ -1896,8 +1873,7 @@ function runPrompt(input) {
       });
     };
     const recordPendingToolResult = (options) => {
-      var _a6;
-      const pendingResult = (_a6 = pendingResultsByToolCallId.get(options.toolCall.toolCallId)) != null ? _a6 : {
+      const pendingResult = pendingResultsByToolCallId.get(options.toolCall.toolCallId) ?? {
         toolCallId: options.toolCall.toolCallId,
         toolName: options.toolCall.toolName,
         input: options.toolCall.input,
@@ -1936,11 +1912,10 @@ function runPrompt(input) {
       });
     };
     const submitToolResult = async (submission) => {
-      var _a6, _b6, _c3;
-      if (!((_a6 = input.isTurnSuspending) == null ? void 0 : _a6.call(input))) {
+      if (!input.isTurnSuspending?.()) {
         return control.submitToolResult(submission);
       }
-      const toolCall = (_c3 = (_b6 = rawToolCallsByToolCallId.get(submission.toolCallId)) != null ? _b6 : pendingResultsByToolCallId.get(submission.toolCallId)) != null ? _c3 : pendingToolApprovals.find(
+      const toolCall = rawToolCallsByToolCallId.get(submission.toolCallId) ?? pendingResultsByToolCallId.get(submission.toolCallId) ?? pendingToolApprovals.find(
         (approval) => approval.toolCallId === submission.toolCallId
       );
       if (toolCall == null) {
@@ -1984,8 +1959,7 @@ function runPrompt(input) {
       pendingResultsByToolCallId.delete(pendingResult.toolCallId);
     };
     const processPendingApprovalContinuation = async (approval, continuation) => {
-      var _a6;
-      const rawToolCall = (_a6 = approval.kind === "builtin" ? rawToolCallsByToolCallId.get(approval.toolCallId) : void 0) != null ? _a6 : {
+      const rawToolCall = (approval.kind === "builtin" ? rawToolCallsByToolCallId.get(approval.toolCallId) : void 0) ?? {
         type: "tool-call",
         toolCallId: approval.toolCallId,
         toolName: approval.toolName,
@@ -2165,7 +2139,7 @@ function runPrompt(input) {
               (condition) => condition({ steps: completedSteps })
             )
           )).some(Boolean)) {
-            await ((_d2 = input.onStopConditionMet) == null ? void 0 : _d2.call(input));
+            await input.onStopConditionMet?.();
             const { usage } = pendingStopBoundary;
             releasePendingStopBoundary();
             await lifecycle.end({
@@ -2179,7 +2153,7 @@ function runPrompt(input) {
           }
         }
         if (value.type === "stream-start") {
-          const modelId = (_e2 = value.modelId) != null ? _e2 : input.model;
+          const modelId = value.modelId ?? input.model;
           if (modelId != null) result.setModelId(modelId);
           await lifecycle.start(modelId);
         }
@@ -2223,7 +2197,7 @@ function runPrompt(input) {
           const rawToolCall = rawToolCallsByToolCallId.get(
             displayValue.toolCallId
           );
-          const toolName = (_f2 = rawToolCall == null ? void 0 : rawToolCall.toolName) != null ? _f2 : toolCall.toolName;
+          const toolName = rawToolCall?.toolName ?? toolCall.toolName;
           if (!isHarnessV1BuiltinToolIncluded({
             toolName,
             toolFiltering: input.builtinToolFiltering
@@ -2246,7 +2220,7 @@ function runPrompt(input) {
         if (value.type === "error" && displayValue.type === "error") {
           await waitForOutstandingHostToolExecutions();
           await lifecycle.error(value.error);
-          if (!((_g2 = input.abortSignal) == null ? void 0 : _g2.aborted)) {
+          if (!input.abortSignal?.aborted) {
             logBridgeError({
               harnessId: input.harness.harnessId,
               sessionId: input.session.sessionId,
@@ -2295,7 +2269,7 @@ function runPrompt(input) {
         }
         if (value.type === "tool-call") {
           observedStepToolCallCount += 1;
-          expectedStepToolCallCount != null ? expectedStepToolCallCount : expectedStepToolCallCount = value.stepToolCallCount;
+          expectedStepToolCallCount ??= value.stepToolCallCount;
           const toolCall = toolCallsByToolCallId.get(value.toolCallId);
           if (toolCall != null) {
             stepToolCalls.push(toolCall);
@@ -2317,7 +2291,7 @@ function runPrompt(input) {
               output: value.result
             };
           }
-          if (((_h2 = rawToolCallsByToolCallId.get(value.toolCallId)) == null ? void 0 : _h2.providerExecuted) === true && (execution == null ? void 0 : execution.toolOutput) != null) {
+          if (rawToolCallsByToolCallId.get(value.toolCallId)?.providerExecuted === true && execution?.toolOutput != null) {
             stepProviderToolResults.push(
               execution.toolOutput
             );
@@ -2331,14 +2305,14 @@ function runPrompt(input) {
             );
           }
           const rawToolCall = rawToolCallsByToolCallId.get(value.toolCallId);
-          const pendingApproval = (_k = pendingApprovalsByApprovalId.get(value.approvalId)) != null ? _k : {
+          const pendingApproval = pendingApprovalsByApprovalId.get(value.approvalId) ?? {
             approvalId: value.approvalId,
             toolCallId: value.toolCallId,
             toolName: toolCall.toolName,
-            input: (_i2 = rawToolCall == null ? void 0 : rawToolCall.input) != null ? _i2 : JSON.stringify(toolCall.input),
+            input: rawToolCall?.input ?? JSON.stringify(toolCall.input),
             kind: "builtin",
-            providerExecuted: (_j2 = rawToolCall == null ? void 0 : rawToolCall.providerExecuted) != null ? _j2 : true,
-            ...(rawToolCall == null ? void 0 : rawToolCall.nativeName) !== void 0 ? { nativeName: rawToolCall.nativeName } : {}
+            providerExecuted: rawToolCall?.providerExecuted ?? true,
+            ...rawToolCall?.nativeName !== void 0 ? { nativeName: rawToolCall.nativeName } : {}
           };
           pendingApprovalsByApprovalId.set(
             pendingApproval.approvalId,
@@ -2492,7 +2466,7 @@ function runPrompt(input) {
             }
             continue;
           }
-          const pendingApproval = (_l = pendingApprovalsByToolCallId.get(toolCall.toolCallId)) != null ? _l : customToolApprovalDecision.type === "request" ? {
+          const pendingApproval = pendingApprovalsByToolCallId.get(toolCall.toolCallId) ?? (customToolApprovalDecision.type === "request" ? {
             approvalId: generateId2(),
             toolCallId: toolCall.toolCallId,
             toolName: toolCall.toolName,
@@ -2500,7 +2474,7 @@ function runPrompt(input) {
             kind: "custom",
             providerExecuted: false,
             ...toolCall.nativeName !== void 0 ? { nativeName: toolCall.nativeName } : {}
-          } : void 0;
+          } : void 0);
           if (pendingApproval != null) {
             pendingApprovalsByApprovalId.set(
               pendingApproval.approvalId,
@@ -2603,16 +2577,16 @@ function runPrompt(input) {
         }
       }
       await waitForOutstandingHostToolExecutions();
-      const isTurnSuspending = ((_m = input.isTurnSuspending) == null ? void 0 : _m.call(input)) === true;
+      const isTurnSuspending = input.isTurnSuspending?.() === true;
       if (isTurnSuspending) {
         await publishToolExecutions();
         if (finalFinish == null) {
           result.discardCurrentStepContent();
         }
       } else if (finalFinish != null) {
-        (_n = input.onTurnFinished) == null ? void 0 : _n.call(input);
+        input.onTurnFinished?.();
       } else {
-        (_o = input.onTurnFailed) == null ? void 0 : _o.call(input);
+        input.onTurnFailed?.();
       }
       await result.finish(
         finalFinish ? {
@@ -2624,7 +2598,7 @@ function runPrompt(input) {
     } catch (err) {
       try {
         await waitForOutstandingHostToolExecutions();
-      } catch (e) {
+      } catch {
       }
       await lifecycle.error(err);
       logBridgeError({
@@ -2788,23 +2762,22 @@ var HarnessAgentSession = class {
     this.sessionState = "active";
     this.turnSequence = 0;
     this.activeTurnSequence = 0;
-    var _a4, _b4, _c, _d;
     this.sessionId = options.sessionId;
     this.harness = options.harness;
     this.underlyingSession = options.underlyingSession;
     this.sandboxSession = options.sandboxSession;
-    this.ownsSandboxLifecycle = (_a4 = options.ownsSandboxLifecycle) != null ? _a4 : true;
+    this.ownsSandboxLifecycle = options.ownsSandboxLifecycle ?? true;
     this.sessionWorkDir = options.sessionWorkDir;
     this.toolApproval = options.toolApproval;
-    for (const approval of (_b4 = options.pendingToolApprovals) != null ? _b4 : []) {
+    for (const approval of options.pendingToolApprovals ?? []) {
       this.pendingToolApprovals.set(approval.approvalId, approval);
     }
-    for (const pendingResult of (_c = options.pendingToolResults) != null ? _c : []) {
+    for (const pendingResult of options.pendingToolResults ?? []) {
       this.pendingToolResults.set(pendingResult.toolCallId, pendingResult);
     }
     this.persistedTurnSettings = options.turnSettings;
     this.resumedToolsContext = options.resumedToolsContext;
-    this.turnState = (_d = options.turnState) != null ? _d : this.pendingToolApprovals.size > 0 ? "awaiting-approval" : this.pendingToolResults.size > 0 ? "awaiting-tool-result" : "idle";
+    this.turnState = options.turnState ?? (this.pendingToolApprovals.size > 0 ? "awaiting-approval" : this.pendingToolResults.size > 0 ? "awaiting-tool-result" : "idle");
     this.isResume = options.underlyingSession.isResume;
   }
   /**
@@ -3171,9 +3144,8 @@ var HarnessAgentSession = class {
     };
   }
   async suspendCurrentTurn(options) {
-    var _a4;
     this.clearActivePromptControl();
-    (_a4 = this.suspendedTurnState) != null ? _a4 : this.suspendedTurnState = (async () => {
+    this.suspendedTurnState ??= (async () => {
       const raw = await options.session.doSuspendTurn();
       const validated = await validateLifecycleStateData({
         harness: this.harness,
@@ -3265,14 +3237,14 @@ var HarnessAgentSession = class {
   }
   setPromptControl(options) {
     const activePromptControl = this.activePromptControl;
-    if (this.sessionState !== "active" || this.turnState !== "running" || this.activeTurnSequence !== options.turnId || (activePromptControl == null ? void 0 : activePromptControl.turnId) !== options.turnId) {
+    if (this.sessionState !== "active" || this.turnState !== "running" || this.activeTurnSequence !== options.turnId || activePromptControl?.turnId !== options.turnId) {
       return;
     }
     this.settleActivePromptControl(options.control);
   }
   async waitForPromptControl(options) {
     const activePromptControl = this.activePromptControl;
-    if ((activePromptControl == null ? void 0 : activePromptControl.turnId) !== options.turnId) return;
+    if (activePromptControl?.turnId !== options.turnId) return;
     await activePromptControl.promise;
   }
   settleActivePromptControl(control) {
@@ -3300,11 +3272,10 @@ var HarnessAgentSession = class {
     this.turnState = "idle";
   }
   resolveActiveTurnSettings(options) {
-    var _a4, _b4;
     if (this.activeTurnSettings != null) {
       return this.activeTurnSettings;
     }
-    const persisted = (_a4 = this.persistedTurnSettings) != null ? _a4 : {
+    const persisted = this.persistedTurnSettings ?? {
       ...options.model == null ? {} : { model: options.model },
       skills: options.skills,
       ...options.instructions == null ? {} : { instructions: options.instructions },
@@ -3324,7 +3295,7 @@ var HarnessAgentSession = class {
     this.activeTurnSettings = {
       persisted,
       tools: options.tools,
-      toolsContext: (_b4 = this.resumedToolsContext) != null ? _b4 : options.toolsContext,
+      toolsContext: this.resumedToolsContext ?? options.toolsContext,
       activeTools,
       builtinToolFiltering: options.builtinToolFiltering
     };
@@ -3349,7 +3320,7 @@ var HarnessAgentSession = class {
 // src/agent/harness-agent-tool-approval-continuation.ts
 function collectHarnessAgentToolApprovalContinuations(input) {
   const lastMessage = input.messages.at(-1);
-  if ((lastMessage == null ? void 0 : lastMessage.role) !== "tool") return [];
+  if (lastMessage?.role !== "tool") return [];
   const toolCallIds = /* @__PURE__ */ new Set();
   const approvalRequestsByApprovalId = /* @__PURE__ */ new Map();
   for (const message of input.messages) {
@@ -3393,7 +3364,7 @@ function collectHarnessAgentToolApprovalContinuations(input) {
 // src/agent/harness-agent-tool-result-continuation.ts
 function collectHarnessAgentToolResultContinuations(input) {
   const lastMessage = input.messages.at(-1);
-  if ((lastMessage == null ? void 0 : lastMessage.role) !== "tool") return [];
+  if (lastMessage?.role !== "tool") return [];
   return lastMessage.content.filter((part) => part.type === "tool-result");
 }
 
@@ -3518,7 +3489,7 @@ function resolveBootstrapPath({
 }
 
 // src/agent/internal/sandbox-bootstrap.ts
-import { posix as posix5 } from "path";
+import { posix as posix6 } from "path";
 
 // src/utils/resolve-sandbox-default-working-directory.ts
 import { posix as posix4 } from "path";
@@ -3566,6 +3537,59 @@ async function resolveSandboxHomeDir({
   return homeDir;
 }
 
+// src/agent/internal/on-bootstrap-marker.ts
+import { posix as posix5 } from "path";
+async function onBootstrapMarkerPath({
+  session,
+  bootstrapHash,
+  abortSignal
+}) {
+  const digest = new Uint8Array(
+    await crypto.subtle.digest(
+      "SHA-256",
+      new TextEncoder().encode(bootstrapHash)
+    )
+  );
+  const filename = Array.from(
+    digest,
+    (byte) => byte.toString(16).padStart(2, "0")
+  ).join("");
+  return posix5.join(
+    harnessStateDirectoryPath({
+      sandboxHomeDir: await resolveSandboxHomeDir({
+        sandbox: session,
+        abortSignal
+      })
+    }),
+    ".on-bootstrap",
+    `${filename}.ok`
+  );
+}
+async function hasOnBootstrapMarker(options) {
+  return await options.session.readTextFile({
+    path: await onBootstrapMarkerPath(options),
+    abortSignal: options.abortSignal
+  }) !== null;
+}
+async function writeOnBootstrapMarker(options) {
+  const path2 = await onBootstrapMarkerPath(options);
+  const result = await options.session.run({
+    command: 'mkdir -p "$MARKER_DIR"',
+    env: { MARKER_DIR: posix5.dirname(path2) },
+    abortSignal: options.abortSignal
+  });
+  if (result.exitCode !== 0) {
+    throw new Error(
+      `Failed to create onBootstrap marker directory: ${result.stderr || result.stdout}`
+    );
+  }
+  await options.session.writeTextFile({
+    path: path2,
+    content: "",
+    abortSignal: options.abortSignal
+  });
+}
+
 // src/agent/internal/sandbox-bootstrap.ts
 var SANDBOX_BOOTSTRAP_IDENTITY_VERSION = 1;
 function validateSandboxBootstrapSettings(settings) {
@@ -3592,10 +3616,10 @@ function normalizeSandboxWorkDir(workDir) {
       "HarnessAgent: `sandboxConfig.workDir` must use POSIX path separators."
     );
   }
-  if (posix5.isAbsolute(workDir)) {
+  if (posix6.isAbsolute(workDir)) {
     throw new Error("HarnessAgent: `sandboxConfig.workDir` must be relative.");
   }
-  const normalized = posix5.normalize(workDir);
+  const normalized = posix6.normalize(workDir);
   if (normalized === "." || normalized === ".." || normalized.startsWith("../")) {
     throw new Error(
       "HarnessAgent: `sandboxConfig.workDir` must stay inside the sandbox default working directory."
@@ -3611,7 +3635,7 @@ function resolveSessionWorkDir({
 }) {
   return joinSandboxPath({
     base: defaultWorkingDirectory,
-    path: workDir != null ? workDir : `${encodeHarnessPathSegment(harnessId)}-${encodeHarnessPathSegment(sessionId)}`
+    path: workDir ?? `${encodeHarnessPathSegment(harnessId)}-${encodeHarnessPathSegment(sessionId)}`
   });
 }
 async function createSandboxBootstrapPlan({
@@ -3639,6 +3663,7 @@ async function createSandboxBootstrapPlan({
         recipeIdentity,
         workDir,
         onBootstrap: settings.onBootstrap,
+        bootstrapHash: settings.bootstrapHash,
         abortSignal: opts.abortSignal
       })
     } : {}
@@ -3650,6 +3675,8 @@ async function runSandboxBootstrap({
   recipeIdentity,
   workDir,
   onBootstrap,
+  bootstrapHash,
+  skipOnBootstrapIfMarked = false,
   defaultWorkingDirectory,
   abortSignal
 }) {
@@ -3674,7 +3701,9 @@ async function runSandboxBootstrap({
     });
   }
   if (onBootstrap == null) return;
-  const resolvedDefaultWorkingDirectory = defaultWorkingDirectory != null ? defaultWorkingDirectory : await resolveSandboxDefaultWorkingDirectory({
+  if (skipOnBootstrapIfMarked && bootstrapHash != null && await hasOnBootstrapMarker({ session, bootstrapHash, abortSignal }))
+    return;
+  const resolvedDefaultWorkingDirectory = defaultWorkingDirectory ?? await resolveSandboxDefaultWorkingDirectory({
     sandboxSession: session,
     abortSignal
   });
@@ -3688,6 +3717,9 @@ async function runSandboxBootstrap({
     abortSignal
   });
   await onBootstrap({ session, workDir: bootstrapWorkDir, abortSignal });
+  if (bootstrapHash != null) {
+    await writeOnBootstrapMarker({ session, bootstrapHash, abortSignal });
+  }
 }
 async function ensureSandboxDirectory({
   session,
@@ -3717,9 +3749,9 @@ async function hashSandboxBootstrapIdentity({
     chunks.push(encoder.encode("\0"));
   };
   pushString(String(SANDBOX_BOOTSTRAP_IDENTITY_VERSION));
-  pushString(recipeIdentity != null ? recipeIdentity : "");
-  pushString(bootstrapHash != null ? bootstrapHash : "");
-  pushString(workDir != null ? workDir : "");
+  pushString(recipeIdentity ?? "");
+  pushString(bootstrapHash ?? "");
+  pushString(workDir ?? "");
   const totalLength = chunks.reduce((sum, chunk) => sum + chunk.length, 0);
   const buffer = new Uint8Array(totalLength);
   let offset = 0;
@@ -3739,7 +3771,7 @@ function joinSandboxPath({
   base,
   path: path2
 }) {
-  return posix5.join(base, path2);
+  return posix6.join(base, path2);
 }
 
 // src/agent/internal/resolve-observability.ts
@@ -3751,10 +3783,9 @@ function parseList(value) {
   return items.length > 0 ? items : void 0;
 }
 function resolveDebugConfig(debug, env = process.env) {
-  var _a4, _b4, _c, _d;
-  const enabled = (_b4 = debug == null ? void 0 : debug.enabled) != null ? _b4 : ENV_TRUTHY.has(((_a4 = env.HARNESS_DEBUG) != null ? _a4 : "").toLowerCase());
-  const level = (_d = (_c = debug == null ? void 0 : debug.level) != null ? _c : env.HARNESS_DEBUG_LEVEL) != null ? _d : "debug";
-  const subsystems = (debug == null ? void 0 : debug.subsystems) ? [...debug.subsystems] : parseList(env.HARNESS_DEBUG_SUBSYSTEMS);
+  const enabled = debug?.enabled ?? ENV_TRUTHY.has((env.HARNESS_DEBUG ?? "").toLowerCase());
+  const level = debug?.level ?? env.HARNESS_DEBUG_LEVEL ?? "debug";
+  const subsystems = debug?.subsystems ? [...debug.subsystems] : parseList(env.HARNESS_DEBUG_SUBSYSTEMS);
   return { enabled, level, subsystems };
 }
 function toHarnessDiagnostic(d) {
@@ -3772,36 +3803,33 @@ function toHarnessDiagnostic(d) {
   };
 }
 function formatForStderr(d) {
-  var _a4;
   const parts = [`[harness:${d.level}]`, d.subsystem, d.message].filter(
     Boolean
   );
   let line = parts.join(" ");
   if (d.error) {
-    line += ` (${(_a4 = d.error.name) != null ? _a4 : "Error"}: ${d.error.message})`;
+    line += ` (${d.error.name ?? "Error"}: ${d.error.message})`;
   }
   return `${line}
 `;
 }
 function buildObservability(options) {
-  var _a4;
   const resolved = resolveDebugConfig(options.settings.debug);
   if (!resolved.enabled) return void 0;
   const onLog = options.settings.onLog;
-  const integrations = ((_a4 = options.settings.telemetry) == null ? void 0 : _a4.integrations) ? asArray(options.settings.telemetry.integrations) : [];
+  const integrations = options.settings.telemetry?.integrations ? asArray(options.settings.telemetry.integrations) : [];
   const diagnosticConsumers = integrations.filter(
     (integration) => typeof integration.ingestDiagnostic === "function"
   );
   const report = (emitted) => {
-    var _a5;
     const diagnostic = toHarnessDiagnostic(emitted);
     try {
       process.stderr.write(formatForStderr(diagnostic));
-    } catch (e) {
+    } catch {
     }
-    onLog == null ? void 0 : onLog(diagnostic);
+    onLog?.(diagnostic);
     for (const consumer of diagnosticConsumers) {
-      (_a5 = consumer.ingestDiagnostic) == null ? void 0 : _a5.call(consumer, diagnostic);
+      consumer.ingestDiagnostic?.(diagnostic);
     }
   };
   return {
@@ -3826,7 +3854,7 @@ function resolveHarnessAgentToolFiltering(input) {
   const activeTools = dedupeToolNames({ toolNames: input.activeTools });
   const inactiveTools = dedupeToolNames({ toolNames: input.inactiveTools });
   validateToolNames({
-    requestedToolNames: activeTools != null ? activeTools : inactiveTools,
+    requestedToolNames: activeTools ?? inactiveTools,
     availableToolNames: allToolNames
   });
   const userToolNames = Object.keys(input.userTools);
@@ -3874,11 +3902,115 @@ function filterToolSet(input) {
   );
 }
 
+// src/agent/internal/prepared-sandbox-identity.ts
+var PREPARED_SANDBOX_IDENTITY_VERSION = 1;
+async function resolvePreparedSandboxIdentity({
+  recipeIdentities,
+  bootstrapHash,
+  workDir
+}) {
+  const entries = Object.entries(recipeIdentities).sort(
+    ([a], [b]) => a.localeCompare(b)
+  );
+  if (entries.length === 0 && bootstrapHash == null) return void 0;
+  const encoder = new TextEncoder();
+  const chunks = [];
+  const pushString = (value) => {
+    chunks.push(encoder.encode(value));
+    chunks.push(encoder.encode("\0"));
+  };
+  pushString(String(PREPARED_SANDBOX_IDENTITY_VERSION));
+  pushString(workDir ?? "");
+  pushString(bootstrapHash ?? "");
+  for (const [harnessId, identity] of entries) {
+    pushString(harnessId);
+    pushString(identity);
+  }
+  const buffer = new Uint8Array(
+    chunks.reduce((sum, chunk) => sum + chunk.length, 0)
+  );
+  let offset = 0;
+  for (const chunk of chunks) {
+    buffer.set(chunk, offset);
+    offset += chunk.length;
+  }
+  const digest = new Uint8Array(await crypto.subtle.digest("SHA-256", buffer));
+  return Array.from(
+    digest.slice(0, 8),
+    (byte) => byte.toString(16).padStart(2, "0")
+  ).join("");
+}
+
+// src/agent/create-harness-sandbox-template.ts
+async function createHarnessSandboxTemplate(options) {
+  if (options.harnesses.length === 0) {
+    throw new Error(
+      "createHarnessSandboxTemplate: at least one harness must be provided."
+    );
+  }
+  const settings = options.sandboxConfig ?? {};
+  validateSandboxBootstrapSettings(settings);
+  const workDir = settings.workDir == null ? void 0 : normalizeSandboxWorkDir(settings.workDir);
+  const harnesses = [
+    ...new Map(
+      options.harnesses.map((harness) => [harness.harnessId, harness])
+    ).values()
+  ].sort((a, b) => a.harnessId.localeCompare(b.harnessId));
+  const recipes = await Promise.all(
+    harnesses.map(async (harness) => {
+      const recipe = await harness.getBootstrap?.({});
+      return recipe == null ? void 0 : {
+        recipe,
+        identity: await hashHarnessBootstrap(recipe)
+      };
+    })
+  );
+  const recipeIdentities = {};
+  for (let index = 0; index < harnesses.length; index++) {
+    const entry = recipes[index];
+    if (entry != null)
+      recipeIdentities[harnesses[index].harnessId] = entry.identity;
+  }
+  const identity = await resolvePreparedSandboxIdentity({
+    recipeIdentities,
+    bootstrapHash: settings.bootstrapHash,
+    workDir
+  });
+  if (identity == null) return void 0;
+  return {
+    identity,
+    prepare: async ({ session, abortSignal }) => {
+      for (const entry of recipes) {
+        if (entry != null) {
+          await runSandboxBootstrap({
+            session,
+            recipe: entry.recipe,
+            recipeIdentity: entry.identity,
+            abortSignal
+          });
+        }
+      }
+      await runSandboxBootstrap({
+        session,
+        workDir,
+        onBootstrap: settings.onBootstrap,
+        bootstrapHash: settings.bootstrapHash,
+        skipOnBootstrapIfMarked: true,
+        abortSignal
+      });
+    }
+  };
+}
+
 // src/agent/harness-agent.ts
 var HarnessAgent = class {
   constructor(settings) {
     this.version = "agent-v1";
-    var _a4, _b4;
+    if (settings.sandbox != null) {
+      console.warn(
+        "HarnessAgent: `sandbox` is deprecated. Supply `sandboxSession` to createSession() instead."
+      );
+    }
     const sandboxConfig = resolveSandboxConfig(settings);
     validateSandboxBootstrapSettings(sandboxConfig);
     this.settings = settings;
@@ -3890,7 +4022,7 @@ var HarnessAgent = class {
       "user-agent",
       "x-client-app"
     ]);
-    const forbiddenHeader = Object.keys((_a4 = settings.headers) != null ? _a4 : {}).map((name4) => name4.toLowerCase()).find((name4) => forbiddenHeaders.has(name4));
+    const forbiddenHeader = Object.keys(settings.headers ?? {}).map((name4) => name4.toLowerCase()).find((name4) => forbiddenHeaders.has(name4));
     if (forbiddenHeader != null) {
       throw new Error(
         `HarnessAgent: \`headers\` must not include the managed header \`${forbiddenHeader}\`.`
@@ -3899,7 +4031,7 @@ var HarnessAgent = class {
     const headers = normalizeHeaders(settings.headers);
     this.headers = Object.keys(headers).length === 0 ? void 0 : headers;
     this.id = settings.id;
-    const userTools = (_b4 = settings.tools) != null ? _b4 : {};
+    const userTools = settings.tools ?? {};
     assertNoReservedQuestionTool({
       harness: settings.harness,
       userTools
@@ -3937,6 +4069,12 @@ var HarnessAgent = class {
   get hasOutput() {
     return this.settings.output != null;
   }
+  getSandboxTemplate() {
+    return createHarnessSandboxTemplate({
+      harnesses: [this.settings.harness],
+      sandboxConfig: this.sandboxConfig
+    });
+  }
   /**
    * Start a fresh session, or resume from state previously returned by
    * `session.detach()` or `session.stop()`. The returned
@@ -3945,12 +4083,11 @@ var HarnessAgent = class {
    * `session.destroy()`.
    */
   async createSession(options) {
-    var _a4, _b4, _c;
-    const sessionId = (_a4 = options == null ? void 0 : options.sessionId) != null ? _a4 : generateId3();
-    const resumeFrom = options == null ? void 0 : options.resumeFrom;
-    const continueFrom = options == null ? void 0 : options.continueFrom;
-    const providedSandboxSession = options == null ? void 0 : options.sandboxSession;
-    const abortSignal = options == null ? void 0 : options.abortSignal;
+    const sessionId = options?.sessionId ?? generateId3();
+    const resumeFrom = options?.resumeFrom;
+    const continueFrom = options?.continueFrom;
+    const providedSandboxSession = options?.sandboxSession;
+    const abortSignal = options?.abortSignal;
     const harness = this.settings.harness;
     const sandboxProvider = this.settings.sandbox;
     const ownsSandboxLifecycle = providedSandboxSession == null;
@@ -3975,8 +4112,8 @@ var HarnessAgent = class {
         expectedType: "continue-turn"
       });
     }
-    const effectiveContinueFrom = validatedContinueFrom != null ? validatedContinueFrom : validatedResumeFrom == null ? void 0 : validatedResumeFrom.continueFrom;
-    if ((options == null ? void 0 : options.toolsContext) != null && effectiveContinueFrom == null) {
+    const effectiveContinueFrom = validatedContinueFrom ?? validatedResumeFrom?.continueFrom;
+    if (options?.toolsContext != null && effectiveContinueFrom == null) {
       throw new Error(
         "HarnessAgent.createSession: `toolsContext` can only rebind an unfinished turn from `continueFrom` or `resumeFrom`."
       );
@@ -3997,7 +4134,7 @@ var HarnessAgent = class {
         sessionId,
         workDir: this.sandboxConfig.workDir
       });
-      const recipe = await ((_b4 = harness.getBootstrap) == null ? void 0 : _b4.call(harness, { abortSignal }));
+      const recipe = await harness.getBootstrap?.({ abortSignal });
       if (recipe != null) {
         const recipeIdentity = await hashHarnessBootstrap(recipe);
         try {
@@ -4029,7 +4166,7 @@ var HarnessAgent = class {
           "HarnessAgent.createSession: configure `sandbox` on HarnessAgent or pass `sandboxSession` to createSession()."
         );
       }
-      const recipe = await ((_c = harness.getBootstrap) == null ? void 0 : _c.call(harness, { abortSignal }));
+      const recipe = await harness.getBootstrap?.({ abortSignal });
       if (isResumedSession) {
         if (sandboxProvider.resumeSession == null) {
           throw new HarnessCapabilityUnsupportedError({
@@ -4118,6 +4255,14 @@ var HarnessAgent = class {
       }
     }
     try {
+      await runSandboxBootstrap({
+        session: getRestrictedSandboxSession(sandboxSession),
+        workDir: this.sandboxConfig.workDir,
+        onBootstrap: this.sandboxConfig.onBootstrap,
+        bootstrapHash: this.sandboxConfig.bootstrapHash,
+        skipOnBootstrapIfMarked: true,
+        abortSignal
+      });
       await ensureSandboxDirectory({
         session: sandboxSession,
         workDir: sessionWorkDir,
@@ -4161,10 +4306,10 @@ var HarnessAgent = class {
         ownsSandboxLifecycle,
         sessionWorkDir,
         toolApproval: this.settings.toolApproval,
-        pendingToolApprovals: effectiveContinueFrom == null ? void 0 : effectiveContinueFrom.pendingToolApprovals,
-        pendingToolResults: effectiveContinueFrom == null ? void 0 : effectiveContinueFrom.pendingToolResults,
-        turnSettings: effectiveContinueFrom == null ? void 0 : effectiveContinueFrom.turnSettings,
-        resumedToolsContext: options == null ? void 0 : options.toolsContext,
+        pendingToolApprovals: effectiveContinueFrom?.pendingToolApprovals,
+        pendingToolResults: effectiveContinueFrom?.pendingToolResults,
+        turnSettings: effectiveContinueFrom?.turnSettings,
+        resumedToolsContext: options?.toolsContext,
         turnState: effectiveContinueFrom == null ? "idle" : effectiveContinueFrom.pendingToolApprovals != null && effectiveContinueFrom.pendingToolApprovals.length > 0 ? "awaiting-approval" : effectiveContinueFrom.pendingToolResults != null && effectiveContinueFrom.pendingToolResults.length > 0 ? "awaiting-tool-result" : "suspended"
       });
     } catch (error) {
@@ -4205,13 +4350,12 @@ var HarnessAgent = class {
    * consuming a turn that crossed a process boundary.
    */
   async continueGenerate(options) {
-    var _a4, _b4;
     const runtimeContext = {};
     const { result, done } = await this._startContinueTurn({
       session: options.session,
       turnInput: {
-        toolApprovalContinuations: (_a4 = options.toolApprovalContinuations) != null ? _a4 : [],
-        toolResultContinuations: (_b4 = options.toolResultContinuations) != null ? _b4 : []
+        toolApprovalContinuations: options.toolApprovalContinuations ?? [],
+        toolResultContinuations: options.toolResultContinuations ?? []
       },
       runtimeContext,
       abortSignal: options.abortSignal
@@ -4228,13 +4372,12 @@ var HarnessAgent = class {
    * follows from how the adapter resumed the session.
    */
   async continueStream(options) {
-    var _a4, _b4;
     const runtimeContext = {};
     const { result, ready } = await this._startContinueTurn({
       session: options.session,
       turnInput: {
-        toolApprovalContinuations: (_a4 = options.toolApprovalContinuations) != null ? _a4 : [],
-        toolResultContinuations: (_b4 = options.toolResultContinuations) != null ? _b4 : []
+        toolApprovalContinuations: options.toolApprovalContinuations ?? [],
+        toolResultContinuations: options.toolResultContinuations ?? []
       },
       runtimeContext,
       abortSignal: options.abortSignal
@@ -4302,31 +4445,30 @@ var HarnessAgent = class {
     };
   }
   _resolveLifecycleCallbacks(call) {
-    var _a4, _b4, _c, _d, _e, _f;
     return {
       onStart: mergeCallbacks(
         this.settings.onStart,
-        (_a4 = call == null ? void 0 : call.onStart) != null ? _a4 : call == null ? void 0 : call.experimental_onStart
+        call?.onStart ?? call?.experimental_onStart
       ),
       onStepStart: mergeCallbacks(
         this.settings.onStepStart,
-        (_b4 = call == null ? void 0 : call.onStepStart) != null ? _b4 : call == null ? void 0 : call.experimental_onStepStart
+        call?.onStepStart ?? call?.experimental_onStepStart
       ),
       onLanguageModelCallStart: this.settings.onLanguageModelCallStart,
       onLanguageModelCallEnd: this.settings.onLanguageModelCallEnd,
       onToolExecutionStart: mergeCallbacks(
         this.settings.onToolExecutionStart,
-        (_c = call == null ? void 0 : call.onToolExecutionStart) != null ? _c : call == null ? void 0 : call.experimental_onToolCallStart
+        call?.onToolExecutionStart ?? call?.experimental_onToolCallStart
       ),
       onToolExecutionEnd: mergeCallbacks(
         this.settings.onToolExecutionEnd,
-        (_d = call == null ? void 0 : call.onToolExecutionEnd) != null ? _d : call == null ? void 0 : call.experimental_onToolCallFinish
+        call?.onToolExecutionEnd ?? call?.experimental_onToolCallFinish
       ),
       onStepEnd: mergeCallbacks(
         this.settings.onStepEnd,
-        (_e = call == null ? void 0 : call.onStepEnd) != null ? _e : call == null ? void 0 : call.onStepFinish
+        call?.onStepEnd ?? call?.onStepFinish
       ),
-      onEnd: mergeCallbacks(this.settings.onEnd, (_f = call == null ? void 0 : call.onEnd) != null ? _f : call == null ? void 0 : call.onFinish)
+      onEnd: mergeCallbacks(this.settings.onEnd, call?.onEnd ?? call?.onFinish)
     };
   }
   _resolveContinueTurnInput(options) {
@@ -4361,7 +4503,7 @@ var HarnessAgent = class {
     if (Array.isArray(messages)) {
       for (let i = messages.length - 1; i >= 0; i--) {
         const message = messages[i];
-        if ((message == null ? void 0 : message.role) === "user") return message;
+        if (message?.role === "user") return message;
       }
       throw new Error(
         'HarnessAgent: messages must contain at least one `role: "user"` entry.'
@@ -4370,7 +4512,6 @@ var HarnessAgent = class {
     throw new Error("HarnessAgent: either `prompt` or `messages` is required.");
   }
   async _preparePromptTurnInput(options) {
-    var _a4, _b4, _c, _d;
     let callOptions = options;
     if (this.settings.callOptionsSchema != null && options.options !== void 0) {
       const validatedOptions = await validateTypes({
@@ -4407,13 +4548,12 @@ var HarnessAgent = class {
       skills: this.settings.skills,
       instructions: this.settings.instructions,
       tools: this.settings.tools,
-      toolsContext: (_a4 = this.settings.toolsContext) != null ? _a4 : {},
+      toolsContext: this.settings.toolsContext ?? {},
       ...promptOptions
     };
-    const preparedCallArgs = (_d = await ((_c = (_b4 = this.settings).prepareCall) == null ? void 0 : _c.call(
-      _b4,
+    const preparedCallArgs = await this.settings.prepareCall?.(
       baseCallArgs
-    ))) != null ? _d : baseCallArgs;
+    ) ?? baseCallArgs;
     if (this._resolveContinueTurnInput(preparedCallArgs) != null) {
       throw new Error(
         "HarnessAgent.prepareCall must return a fresh user prompt, not a tool continuation."
@@ -4431,7 +4571,6 @@ var HarnessAgent = class {
     };
   }
   _prepareContinueTurnInput(options) {
-    var _a4, _b4;
     return {
       ...this._prepareTurnSettings({
         model: this.settings.model,
@@ -4440,13 +4579,12 @@ var HarnessAgent = class {
         tools: this.settings.tools,
         toolsContext: this.settings.toolsContext
       }),
-      toolApprovalContinuations: (_a4 = options.toolApprovalContinuations) != null ? _a4 : [],
-      toolResultContinuations: (_b4 = options.toolResultContinuations) != null ? _b4 : []
+      toolApprovalContinuations: options.toolApprovalContinuations ?? [],
+      toolResultContinuations: options.toolResultContinuations ?? []
     };
   }
   _prepareTurnSettings(options) {
-    var _a4, _b4, _c, _d;
-    const userTools = (_a4 = options.tools) != null ? _a4 : {};
+    const userTools = options.tools ?? {};
     assertNoReservedQuestionTool({
       harness: this.settings.harness,
       userTools
@@ -4464,10 +4602,10 @@ var HarnessAgent = class {
     });
     return {
       model: options.model,
-      skills: (_b4 = options.skills) != null ? _b4 : [],
-      instructions: typeof options.instructions === "string" ? options.instructions : (_c = options.instructions) == null ? void 0 : _c.content,
+      skills: options.skills ?? [],
+      instructions: typeof options.instructions === "string" ? options.instructions : options.instructions?.content,
       tools,
-      toolsContext: (_d = options.toolsContext) != null ? _d : {},
+      toolsContext: options.toolsContext ?? {},
       activeTools: toolFiltering.activeUserTools,
       toolSpecs: this._toToolSpecs(toolFiltering.activeUserTools),
       builtinToolFiltering: toolFiltering.builtinToolFiltering
@@ -4490,7 +4628,7 @@ var HarnessAgent = class {
           inputSchema = asSchema(
             t.inputSchema
           ).jsonSchema;
-        } catch (e) {
+        } catch {
         }
       }
       specs.push({ name: name4, description: t.description, inputSchema });
@@ -4507,8 +4645,7 @@ var HarnessAgent = class {
     return new HarnessGenerateTextResult({ steps, usage, responseMessages, output });
   }
   async _resolveResponseFormat() {
-    var _a4;
-    const responseFormat = await ((_a4 = this.settings.output) == null ? void 0 : _a4.responseFormat);
+    const responseFormat = await this.settings.output?.responseFormat;
     if (responseFormat == null || responseFormat.type === "text") {
       return responseFormat == null ? void 0 : { type: "text" };
     }
@@ -4577,10 +4714,7 @@ var HarnessGenerateTextResult = class {
     return this.finalStep.rawFinishReason;
   }
   get warnings() {
-    return this.steps.flatMap((step) => {
-      var _a4;
-      return (_a4 = step.warnings) != null ? _a4 : [];
-    });
+    return this.steps.flatMap((step) => step.warnings ?? []);
   }
   get reasoning() {
     return this.finalStep.content.filter(
@@ -4604,7 +4738,6 @@ var HarnessGenerateTextResult = class {
   }
 };
 function resolveSandboxConfig(settings) {
-  var _a4;
   if (settings.onSandboxSession != null) {
     console.warn(
       "HarnessAgent: `onSandboxSession` is deprecated. Use `sandboxConfig.onSession` instead."
@@ -4612,7 +4745,7 @@ function resolveSandboxConfig(settings) {
   }
   return {
     ...settings.sandboxConfig,
-    ...((_a4 = settings.sandboxConfig) == null ? void 0 : _a4.onSession) == null && settings.onSandboxSession != null ? { onSession: settings.onSandboxSession } : {}
+    ...settings.sandboxConfig?.onSession == null && settings.onSandboxSession != null ? { onSession: settings.onSandboxSession } : {}
   };
 }
 async function cleanupAfterStartFailure(input) {
@@ -4625,8 +4758,10 @@ async function cleanupAfterStartFailure(input) {
 
 // src/agent/prepare-harness-sandbox-template.ts
 async function prepareHarnessSandboxTemplate(options) {
-  var _a4;
-  const sandboxConfig = (_a4 = options.sandboxConfig) != null ? _a4 : {};
+  console.warn(
+    "prepareHarnessSandboxTemplate (prewarmHarness) is deprecated. Use createHarnessSandboxTemplate and a sandbox session creator instead."
+  );
+  const sandboxConfig = options.sandboxConfig ?? {};
   validateSandboxBootstrapSettings(sandboxConfig);
   const { harness, sandboxProvider, abortSignal } = options;
   let recipe;
@@ -4671,10 +4806,11 @@ async function prepareHarnessSandboxTemplate(options) {
 var prewarmHarness = prepareHarnessSandboxTemplate;
 
 // src/agent/prepare-sandbox-for-harness.ts
-var PREPARED_SANDBOX_IDENTITY_VERSION = 1;
 async function prepareSandboxForHarness(options) {
-  var _a4, _b4;
-  const sandboxConfig = (_a4 = options.sandboxConfig) != null ? _a4 : {};
+  console.warn(
+    "prepareSandboxForHarness is deprecated. Use createHarnessSandboxTemplate and template.prepare instead."
+  );
+  const sandboxConfig = options.sandboxConfig ?? {};
   validateSandboxBootstrapSettings(sandboxConfig);
   if (options.harnesses.length === 0) {
     throw new Error(
@@ -4691,16 +4827,16 @@ async function prepareSandboxForHarness(options) {
   const skippedHarnessIds = [];
   let stateDirectory;
   for (const harness of harnesses) {
-    const recipe = await ((_b4 = harness.getBootstrap) == null ? void 0 : _b4.call(harness, {
+    const recipe = await harness.getBootstrap?.({
       abortSignal: options.abortSignal
-    }));
+    });
     if (recipe == null) {
       skippedHarnessIds.push(harness.harnessId);
       continue;
     }
     const recipeIdentity = await hashHarnessBootstrap(recipe);
     recipeIdentities[harness.harnessId] = recipeIdentity;
-    stateDirectory != null ? stateDirectory : stateDirectory = harnessStateDirectoryPath({
+    stateDirectory ??= harnessStateDirectoryPath({
       sandboxHomeDir: await resolveSandboxHomeDir({
         sandbox: options.session,
         abortSignal: options.abortSignal
@@ -4722,6 +4858,7 @@ async function prepareSandboxForHarness(options) {
       session: options.session,
       workDir,
       onBootstrap: sandboxConfig.onBootstrap,
+      bootstrapHash: sandboxConfig.bootstrapHash,
       defaultWorkingDirectory,
       abortSignal: options.abortSignal
     });
@@ -4737,45 +4874,6 @@ async function prepareSandboxForHarness(options) {
     skippedHarnessIds
   };
 }
-async function resolvePreparedSandboxIdentity({
-  recipeIdentities,
-  bootstrapHash,
-  workDir
-}) {
-  const entries = Object.entries(recipeIdentities).sort(
-    ([a], [b]) => a.localeCompare(b)
-  );
-  if (entries.length === 0 && bootstrapHash == null) {
-    return void 0;
-  }
-  const encoder = new TextEncoder();
-  const chunks = [];
-  const pushString = (value) => {
-    chunks.push(encoder.encode(value));
-    chunks.push(encoder.encode("\0"));
-  };
-  pushString(String(PREPARED_SANDBOX_IDENTITY_VERSION));
-  pushString(workDir != null ? workDir : "");
-  pushString(bootstrapHash != null ? bootstrapHash : "");
-  for (const [harnessId, identity] of entries) {
-    pushString(harnessId);
-    pushString(identity);
-  }
-  const totalLength = chunks.reduce((sum, chunk) => sum + chunk.length, 0);
-  const buffer = new Uint8Array(totalLength);
-  let offset = 0;
-  for (const chunk of chunks) {
-    buffer.set(chunk, offset);
-    offset += chunk.length;
-  }
-  const digest = await crypto.subtle.digest("SHA-256", buffer);
-  const bytes = new Uint8Array(digest);
-  let hex = "";
-  for (let i = 0; i < 8; i++) {
-    hex += bytes[i].toString(16).padStart(2, "0");
-  }
-  return hex;
-}
 
 // src/errors/harness-sandbox-authentication-error.ts
 import { AISDKError as AISDKError3 } from "@ai-sdk/provider";
@@ -4811,10 +4909,9 @@ function getHarnessErrorMessage(error) {
 // src/agent/observability/file-reporter.ts
 import { appendFileSync, mkdirSync } from "fs";
 function createFileReporter(options) {
-  var _a4, _b4;
-  const fileName = (_a4 = options.fileName) != null ? _a4 : "events.jsonl";
+  const fileName = options.fileName ?? "events.jsonl";
   const path2 = `${options.dir}/${fileName}`;
-  const failOnly = (_b4 = options.failOnly) != null ? _b4 : false;
+  const failOnly = options.failOnly ?? false;
   const turns = /* @__PURE__ */ new Map();
   let lastOpenCallId;
   let dirReady = false;
@@ -4827,7 +4924,7 @@ function createFileReporter(options) {
     return bucket;
   };
   const record = (callId, rec) => {
-    const id = callId != null ? callId : lastOpenCallId;
+    const id = callId ?? lastOpenCallId;
     if (id == null) {
       flushLines([rec]);
       return;
@@ -4842,7 +4939,7 @@ function createFileReporter(options) {
         dirReady = true;
       }
       appendFileSync(path2, lines.map((l) => JSON.stringify(l)).join("\n") + "\n");
-    } catch (e) {
+    } catch {
     }
   };
   const finishTurn = (callId) => {
@@ -4913,14 +5010,13 @@ function createFileReporter(options) {
       });
     },
     onEnd(event) {
-      var _a5;
       const e = event;
       record(e.callId, {
         ts: Date.now(),
         kind: "turn-finish",
         callId: e.callId,
         finishReason: e.finishReason,
-        usage: (_a5 = e.totalUsage) != null ? _a5 : e.usage
+        usage: e.totalUsage ?? e.usage
       });
       finishTurn(e.callId);
     },
@@ -4947,8 +5043,7 @@ function createFileReporter(options) {
 
 // src/agent/observability/trace-tree-reporter.ts
 function createTraceTreeReporter(options = {}) {
-  var _a4;
-  const write = (_a4 = options.write) != null ? _a4 : ((chunk) => void process.stderr.write(chunk));
+  const write = options.write ?? ((chunk) => void process.stderr.write(chunk));
   const turns = /* @__PURE__ */ new Map();
   const render = (node, depth) => {
     const indent = "  ".repeat(depth);
@@ -4960,11 +5055,10 @@ function createTraceTreeReporter(options = {}) {
   };
   return {
     onStart(event) {
-      var _a5;
       const e = event;
       turns.set(e.callId, {
         root: {
-          label: `${(_a5 = e.operationId) != null ? _a5 : "turn"}${e.modelId ? ` ${e.modelId}` : ""}`,
+          label: `${e.operationId ?? "turn"}${e.modelId ? ` ${e.modelId}` : ""}`,
           startMs: Date.now(),
           children: []
         },
@@ -4972,12 +5066,11 @@ function createTraceTreeReporter(options = {}) {
       });
     },
     onStepStart(event) {
-      var _a5;
       const e = event;
       const turn = turns.get(e.callId);
       if (!turn) return;
       const step = {
-        label: `step ${((_a5 = e.stepNumber) != null ? _a5 : turn.root.children.length) + 1}`,
+        label: `step ${(e.stepNumber ?? turn.root.children.length) + 1}`,
         startMs: Date.now(),
         children: []
       };
@@ -4985,10 +5078,9 @@ function createTraceTreeReporter(options = {}) {
       turn.root.children.push(step);
     },
     onToolExecutionStart(event) {
-      var _a5;
       const e = event;
       const turn = turns.get(e.callId);
-      const parent = (_a5 = turn == null ? void 0 : turn.step) != null ? _a5 : turn == null ? void 0 : turn.root;
+      const parent = turn?.step ?? turn?.root;
       if (!turn || !parent) return;
       const node = {
         label: `tool ${e.toolCall.toolName}`,
@@ -4999,9 +5091,8 @@ function createTraceTreeReporter(options = {}) {
       parent.children.push(node);
     },
     onToolExecutionEnd(event) {
-      var _a5;
       const e = event;
-      const node = (_a5 = turns.get(e.callId)) == null ? void 0 : _a5.tools.get(e.toolCall.toolCallId);
+      const node = turns.get(e.callId)?.tools.get(e.toolCall.toolCallId);
       if (!node) return;
       node.endMs = Date.now();
       if (e.toolOutput.type === "error") node.label += " [error]";
@@ -5009,7 +5100,7 @@ function createTraceTreeReporter(options = {}) {
     onStepFinish(event) {
       const e = event;
       const turn = turns.get(e.callId);
-      if (turn == null ? void 0 : turn.step) {
+      if (turn?.step) {
         turn.step.endMs = Date.now();
         turn.step = void 0;
       }
@@ -5023,7 +5114,7 @@ function createTraceTreeReporter(options = {}) {
       try {
         write(`
 ${render(turn.root, 0)}`);
-      } catch (e2) {
+      } catch {
       }
     }
   };
@@ -5037,6 +5128,7 @@ export {
   collectHarnessAgentToolApprovalContinuations,
   collectHarnessAgentToolResultContinuations,
   createFileReporter,
+  createHarnessSandboxTemplate,
   createTraceTreeReporter,
   getHarnessErrorMessage,
   prepareHarnessSandboxTemplate,