@ai-sdk/harness 1.0.128 → 1.0.129

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @ai-sdk/harness
 
+## 1.0.129
+
+### Patch Changes
+
+- e5aeb11: feat(harness): allow setting `HarnessAgent`'s `workDir` to "." to use the sandbox's default working directory
+- d99d6dc: fix(harness): forward configured runtime context to callbacks and telemetry
+- Updated dependencies [33e94ba]
+- Updated dependencies [34d869e]
+- Updated dependencies [e3605f6]
+- Updated dependencies [def4df8]
+- Updated dependencies [525efc5]
+  - ai@7.0.119
+  - @ai-sdk/provider-utils@5.0.50
+  - @ai-sdk/provider@4.0.19
+
 ## 1.0.128
 
 ### Patch Changes

package/dist/agent/index.d.ts

@@ -1259,8 +1259,9 @@ type HarnessAgentToolApprovalConfiguration = Readonly<Record<string, ToolApprova
 type HarnessAgentSandboxConfig = {
     /**
      * Optional fixed working directory for all sessions, relative to the
-     * sandbox's default working directory. When omitted, sessions keep the
-     * existing `<harnessId>-<sessionId>` work directory.
+     * sandbox's default working directory. Use `'.'` to use the default
+     * working directory itself. When omitted, sessions keep the existing
+     * `<harnessId>-<sessionId>` work directory.
      */
     readonly workDir?: string;
     /**
@@ -1354,6 +1355,11 @@ type HarnessAgentSettings<THarness extends HarnessAgentAdapter<any> = HarnessAge
      * `prepareCall` can replace it for each new turn.
      */
     readonly toolsContext?: InferToolSetContext<TUserTools>;
+    /**
+     * Runtime context passed to lifecycle callbacks and telemetry.
+     * `prepareCall` can replace it for each new turn.
+     */
+    readonly runtimeContext?: RUNTIME_CONTEXT;
     /**
      * Skills made available to the underlying runtime. Each adapter decides how
      * to surface skills. `prepareCall` can replace them between completed turns.
@@ -1393,9 +1399,9 @@ type HarnessAgentSettings<THarness extends HarnessAgentAdapter<any> = HarnessAge
      * })
      * ```
      */
-    readonly prepareCall?: (options: Omit<AgentCallParameters<CALL_OPTIONS, HarnessAllTools<THarness, TUserTools>, RUNTIME_CONTEXT>, 'abortSignal' | 'timeout' | 'onStart' | 'experimental_onStart' | 'onStepStart' | 'experimental_onStepStart' | 'onToolExecutionStart' | 'experimental_onToolCallStart' | 'onToolExecutionEnd' | 'experimental_onToolCallFinish' | 'onStepEnd' | 'onStepFinish' | 'onEnd' | 'onFinish' | 'experimental_sandbox'> & Pick<HarnessAgentSettings<THarness, TUserTools, RUNTIME_CONTEXT, NoInfer<OUTPUT>, CALL_OPTIONS>, 'model' | 'skills' | 'instructions' | 'tools'> & {
+    readonly prepareCall?: (options: Omit<AgentCallParameters<CALL_OPTIONS, HarnessAllTools<THarness, TUserTools>, RUNTIME_CONTEXT>, 'abortSignal' | 'timeout' | 'onStart' | 'experimental_onStart' | 'onStepStart' | 'experimental_onStepStart' | 'onToolExecutionStart' | 'experimental_onToolCallStart' | 'onToolExecutionEnd' | 'experimental_onToolCallFinish' | 'onStepEnd' | 'onStepFinish' | 'onEnd' | 'onFinish' | 'experimental_sandbox'> & Pick<HarnessAgentSettings<THarness, TUserTools, RUNTIME_CONTEXT, NoInfer<OUTPUT>, CALL_OPTIONS>, 'model' | 'skills' | 'instructions' | 'tools' | 'runtimeContext'> & {
         toolsContext: InferToolSetContext<TUserTools>;
-    }) => MaybePromiseLike<Pick<HarnessAgentSettings<THarness, TUserTools, RUNTIME_CONTEXT, NoInfer<OUTPUT>, CALL_OPTIONS>, 'model' | 'skills' | 'instructions' | 'tools'> & {
+    }) => MaybePromiseLike<Pick<HarnessAgentSettings<THarness, TUserTools, RUNTIME_CONTEXT, NoInfer<OUTPUT>, CALL_OPTIONS>, 'model' | 'skills' | 'instructions' | 'tools' | 'runtimeContext'> & {
         toolsContext: InferToolSetContext<TUserTools>;
     } & Omit<Prompt, 'system' | 'instructions' | 'allowSystemInMessages'>>;
     /**
@@ -1549,6 +1555,7 @@ declare class HarnessAgentSession {
     private activeTurnSettings;
     private persistedTurnSettings;
     private readonly resumedToolsContext;
+    private readonly resumedRuntimeContext;
     /**
      * Whether this session was created from `resumeFrom` or `continueFrom`.
      * Captured at construction so it survives lifecycle cleanup.
@@ -1566,6 +1573,7 @@ declare class HarnessAgentSession {
         pendingToolResults?: readonly HarnessAgentPendingToolResult[];
         turnSettings?: HarnessV1TurnSettings;
         resumedToolsContext?: Record<string, Context | undefined>;
+        resumedRuntimeContext?: Context;
         turnState?: HarnessAgentTurnState;
     });
     hasUnfinishedTurn(): boolean;
@@ -1783,6 +1791,12 @@ declare class HarnessAgent<THarness extends HarnessAgentAdapter<any> = HarnessAg
          * non-serializable host objects.
          */
         toolsContext?: ToolsContextSettings<TUserTools>['toolsContext'];
+        /**
+         * Rebinds host-only runtime context for an unfinished turn resumed with
+         * `continueFrom` (directly or through `resumeFrom`). Runtime context is
+         * not serialized into lifecycle state.
+         */
+        runtimeContext?: RUNTIME_CONTEXT;
         /**
          * Existing sandbox session to run the harness in. When provided, the
          * caller retains ownership of the sandbox lifecycle.

package/dist/agent/index.js

@@ -1223,7 +1223,7 @@ function stripDeep(value, workDir) {
 }
 
 // src/agent/internal/turn-telemetry.ts
-import { createTelemetryDispatcher } from "ai/internal";
+import { createRestrictedTelemetryDispatcher } from "ai/internal";
 async function notify(event, ...callbacks) {
   await Promise.allSettled(
     callbacks.map(async (callback) => {
@@ -1232,7 +1232,11 @@ async function notify(event, ...callbacks) {
   );
 }
 function createTurnLifecycle(options) {
-  const telemetry = options.telemetry == null ? {} : createTelemetryDispatcher({ telemetry: options.telemetry });
+  const telemetry = options.telemetry == null ? {} : createRestrictedTelemetryDispatcher({
+    telemetry: options.telemetry,
+    includeRuntimeContext: options.telemetry.includeRuntimeContext,
+    includeToolsContext: options.telemetry.includeToolsContext
+  });
   const provider = `harness:${options.harnessId}`;
   let modelId = options.modelId ?? "";
   let started = false;
@@ -2777,6 +2781,7 @@ var HarnessAgentSession = class {
     }
     this.persistedTurnSettings = options.turnSettings;
     this.resumedToolsContext = options.resumedToolsContext;
+    this.resumedRuntimeContext = options.resumedRuntimeContext;
     this.turnState = options.turnState ?? (this.pendingToolApprovals.size > 0 ? "awaiting-approval" : this.pendingToolResults.size > 0 ? "awaiting-tool-result" : "idle");
     this.isResume = options.underlyingSession.isResume;
   }
@@ -2818,6 +2823,7 @@ var HarnessAgentSession = class {
       persisted: this.persistedTurnSettings,
       tools: options.tools,
       toolsContext: options.toolsContext,
+      runtimeContext: options.runtimeContext,
       activeTools: options.activeTools,
       builtinToolFiltering: options.builtinToolFiltering
     };
@@ -2893,6 +2899,7 @@ var HarnessAgentSession = class {
       instructions: options.instructions,
       tools: options.tools,
       toolsContext: options.toolsContext,
+      runtimeContext: options.runtimeContext,
       activeTools: options.activeTools,
       toolSpecs: options.toolSpecs,
       builtinToolFiltering: options.builtinToolFiltering
@@ -2914,7 +2921,7 @@ var HarnessAgentSession = class {
         builtinToolFiltering: turnSettings.builtinToolFiltering,
         sandboxSession: getRestrictedSandboxSession(sandboxSession),
         sessionWorkDir: this.sessionWorkDir,
-        runtimeContext: options.runtimeContext,
+        runtimeContext: turnSettings.runtimeContext,
         abortSignal: options.abortSignal,
         responseFormat: options.responseFormat,
         output: options.output,
@@ -3296,6 +3303,7 @@ var HarnessAgentSession = class {
       persisted,
       tools: options.tools,
       toolsContext: this.resumedToolsContext ?? options.toolsContext,
+      runtimeContext: this.resumedRuntimeContext ?? options.runtimeContext,
       activeTools,
       builtinToolFiltering: options.builtinToolFiltering
     };
@@ -3620,7 +3628,7 @@ function normalizeSandboxWorkDir(workDir) {
     throw new Error("HarnessAgent: `sandboxConfig.workDir` must be relative.");
   }
   const normalized = posix6.normalize(workDir);
-  if (normalized === "." || normalized === ".." || normalized.startsWith("../")) {
+  if ((normalized === "." || normalized === "./") && workDir !== "." || normalized === ".." || normalized.startsWith("../")) {
     throw new Error(
       "HarnessAgent: `sandboxConfig.workDir` must stay inside the sandbox default working directory."
     );
@@ -4310,6 +4318,7 @@ var HarnessAgent = class {
         pendingToolResults: effectiveContinueFrom?.pendingToolResults,
         turnSettings: effectiveContinueFrom?.turnSettings,
         resumedToolsContext: options?.toolsContext,
+        resumedRuntimeContext: options?.runtimeContext,
         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) {
@@ -4322,8 +4331,8 @@ var HarnessAgent = class {
   }
   async generate(options) {
     const continueTurnInput = this._resolveContinueTurnInput(options);
-    const runtimeContext = {};
-    const { result, done } = continueTurnInput == null ? await this._startPromptTurn({ options, runtimeContext }) : await this._startContinueTurn({
+    const runtimeContext = this.settings.runtimeContext ?? {};
+    const { result, done } = continueTurnInput == null ? await this._startPromptTurn({ options }) : await this._startContinueTurn({
       session: options.session,
       turnInput: continueTurnInput,
       runtimeContext,
@@ -4334,8 +4343,8 @@ var HarnessAgent = class {
   }
   async stream(options) {
     const continueTurnInput = this._resolveContinueTurnInput(options);
-    const runtimeContext = {};
-    const { result, ready } = continueTurnInput == null ? await this._startPromptTurn({ options, runtimeContext }) : await this._startContinueTurn({
+    const runtimeContext = this.settings.runtimeContext ?? {};
+    const { result, ready } = continueTurnInput == null ? await this._startPromptTurn({ options }) : await this._startContinueTurn({
       session: options.session,
       turnInput: continueTurnInput,
       runtimeContext,
@@ -4350,7 +4359,7 @@ var HarnessAgent = class {
    * consuming a turn that crossed a process boundary.
    */
   async continueGenerate(options) {
-    const runtimeContext = {};
+    const runtimeContext = this.settings.runtimeContext ?? {};
     const { result, done } = await this._startContinueTurn({
       session: options.session,
       turnInput: {
@@ -4372,7 +4381,7 @@ var HarnessAgent = class {
    * follows from how the adapter resumed the session.
    */
   async continueStream(options) {
-    const runtimeContext = {};
+    const runtimeContext = this.settings.runtimeContext ?? {};
     const { result, ready } = await this._startContinueTurn({
       session: options.session,
       turnInput: {
@@ -4402,7 +4411,7 @@ var HarnessAgent = class {
     return input.options.session.promptTurn({
       ...this._buildTurnOptions({
         turnSettings: turnInput,
-        runtimeContext: input.runtimeContext,
+        runtimeContext: turnInput.runtimeContext,
         abortSignal: input.options.abortSignal,
         responseFormat,
         callbacks: this._resolveLifecycleCallbacks(input.options)
@@ -4548,6 +4557,7 @@ var HarnessAgent = class {
       skills: this.settings.skills,
       instructions: this.settings.instructions,
       tools: this.settings.tools,
+      runtimeContext: this.settings.runtimeContext,
       toolsContext: this.settings.toolsContext ?? {},
       ...promptOptions
     };
@@ -4561,6 +4571,7 @@ var HarnessAgent = class {
     }
     return {
       prompt: this._resolvePromptTurnInput(preparedCallArgs),
+      runtimeContext: preparedCallArgs.runtimeContext ?? {},
       ...this._prepareTurnSettings({
         model: preparedCallArgs.model,
         skills: preparedCallArgs.skills,