@ai-sdk/harness 1.0.128 → 1.0.130

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/harness",
-  "version": "1.0.128",
+  "version": "1.0.130",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -44,9 +44,9 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/provider": "4.0.18",
-    "@ai-sdk/provider-utils": "5.0.49",
-    "ai": "7.0.118"
+    "@ai-sdk/provider": "4.0.19",
+    "@ai-sdk/provider-utils": "5.0.50",
+    "ai": "7.0.120"
   },
   "peerDependencies": {
     "ws": "^8.21.0",
@@ -58,7 +58,7 @@
     }
   },
   "devDependencies": {
-    "@ai-sdk/otel": "1.0.118",
+    "@ai-sdk/otel": "1.0.120",
     "@opentelemetry/sdk-trace-base": "2.7.1",
     "@types/node": "22.19.19",
     "@types/ws": "^8.5.13",

package/src/agent/harness-agent-session.ts

@@ -67,6 +67,7 @@ type ActiveTurnSettings = {
   readonly persisted: HarnessV1TurnSettings;
   readonly tools: ToolSet;
   readonly toolsContext: Record<string, Context | undefined>;
+  readonly runtimeContext: Context;
   readonly activeTools: ToolSet;
   readonly builtinToolFiltering: HarnessV1BuiltinToolFiltering | undefined;
 };
@@ -124,6 +125,7 @@ export class HarnessAgentSession {
   private readonly resumedToolsContext:
     | Record<string, Context | undefined>
     | undefined;
+  private readonly resumedRuntimeContext: Context | undefined;
 
   /**
    * Whether this session was created from `resumeFrom` or `continueFrom`.
@@ -143,6 +145,7 @@ export class HarnessAgentSession {
     pendingToolResults?: readonly HarnessAgentPendingToolResult[];
     turnSettings?: HarnessV1TurnSettings;
     resumedToolsContext?: Record<string, Context | undefined>;
+    resumedRuntimeContext?: Context;
     turnState?: HarnessAgentTurnState;
   }) {
     this.sessionId = options.sessionId;
@@ -160,6 +163,7 @@ export class HarnessAgentSession {
     }
     this.persistedTurnSettings = options.turnSettings;
     this.resumedToolsContext = options.resumedToolsContext;
+    this.resumedRuntimeContext = options.resumedRuntimeContext;
     this.turnState =
       options.turnState ??
       (this.pendingToolApprovals.size > 0
@@ -234,6 +238,7 @@ export class HarnessAgentSession {
       persisted: this.persistedTurnSettings,
       tools: options.tools,
       toolsContext: options.toolsContext,
+      runtimeContext: options.runtimeContext,
       activeTools: options.activeTools,
       builtinToolFiltering: options.builtinToolFiltering,
     };
@@ -334,6 +339,7 @@ export class HarnessAgentSession {
       instructions: options.instructions,
       tools: options.tools,
       toolsContext: options.toolsContext,
+      runtimeContext: options.runtimeContext,
       activeTools: options.activeTools,
       toolSpecs: options.toolSpecs,
       builtinToolFiltering: options.builtinToolFiltering,
@@ -355,7 +361,7 @@ export class HarnessAgentSession {
         builtinToolFiltering: turnSettings.builtinToolFiltering,
         sandboxSession: getRestrictedSandboxSession(sandboxSession),
         sessionWorkDir: this.sessionWorkDir,
-        runtimeContext: options.runtimeContext,
+        runtimeContext: turnSettings.runtimeContext as RUNTIME_CONTEXT,
         abortSignal: options.abortSignal,
         responseFormat: options.responseFormat,
         output: options.output,
@@ -792,6 +798,7 @@ export class HarnessAgentSession {
     instructions: string | undefined;
     tools: ToolSet;
     toolsContext: Record<string, Context | undefined>;
+    runtimeContext: Context;
     activeTools: ToolSet;
     toolSpecs: HarnessAgentToolSpec[];
     builtinToolFiltering: HarnessV1BuiltinToolFiltering | undefined;
@@ -826,6 +833,7 @@ export class HarnessAgentSession {
       persisted,
       tools: options.tools,
       toolsContext: this.resumedToolsContext ?? options.toolsContext,
+      runtimeContext: this.resumedRuntimeContext ?? options.runtimeContext,
       activeTools,
       builtinToolFiltering: options.builtinToolFiltering,
     };

package/src/agent/harness-agent-settings.ts

@@ -45,8 +45,9 @@ export type HarnessAgentToolApprovalConfiguration = Readonly<
 export 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;
 
@@ -159,6 +160,12 @@ export type HarnessAgentSettings<
    */
   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.
@@ -233,7 +240,7 @@ export type HarnessAgentSettings<
           NoInfer<OUTPUT>,
           CALL_OPTIONS
         >,
-        'model' | 'skills' | 'instructions' | 'tools'
+        'model' | 'skills' | 'instructions' | 'tools' | 'runtimeContext'
       > & {
         toolsContext: InferToolSetContext<TUserTools>;
       },
@@ -246,7 +253,7 @@ export type HarnessAgentSettings<
         NoInfer<OUTPUT>,
         CALL_OPTIONS
       >,
-      'model' | 'skills' | 'instructions' | 'tools'
+      'model' | 'skills' | 'instructions' | 'tools' | 'runtimeContext'
     > & {
       toolsContext: InferToolSetContext<TUserTools>;
     } & Omit<Prompt, 'system' | 'instructions' | 'allowSystemInMessages'>

package/src/agent/harness-agent.ts

@@ -114,8 +114,10 @@ type PreparedHarnessAgentTurnSettings<
 type PreparedHarnessAgentPromptTurnInput<
   THarness extends HarnessAgentAdapter<any>,
   TUserTools extends ToolSet,
+  RUNTIME_CONTEXT extends Context,
 > = PreparedHarnessAgentTurnSettings<THarness, TUserTools> & {
   prompt: HarnessAgentPrompt;
+  runtimeContext: RUNTIME_CONTEXT;
 };
 
 type PreparedHarnessAgentContinueTurnInput<
@@ -340,6 +342,12 @@ export class HarnessAgent<
      * 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.
@@ -611,6 +619,7 @@ export class HarnessAgent<
         pendingToolResults: effectiveContinueFrom?.pendingToolResults,
         turnSettings: effectiveContinueFrom?.turnSettings,
         resumedToolsContext: options?.toolsContext,
+        resumedRuntimeContext: options?.runtimeContext,
         turnState:
           effectiveContinueFrom == null
             ? 'idle'
@@ -646,10 +655,11 @@ export class HarnessAgent<
     >
   > {
     const continueTurnInput = this._resolveContinueTurnInput(options);
-    const runtimeContext = {} as RUNTIME_CONTEXT;
+    const runtimeContext =
+      this.settings.runtimeContext ?? ({} as RUNTIME_CONTEXT);
     const { result, done } =
       continueTurnInput == null
-        ? await this._startPromptTurn({ options, runtimeContext })
+        ? await this._startPromptTurn({ options })
         : await this._startContinueTurn({
             session: options.session,
             turnInput: continueTurnInput,
@@ -675,10 +685,11 @@ export class HarnessAgent<
     >
   > {
     const continueTurnInput = this._resolveContinueTurnInput(options);
-    const runtimeContext = {} as RUNTIME_CONTEXT;
+    const runtimeContext =
+      this.settings.runtimeContext ?? ({} as RUNTIME_CONTEXT);
     const { result, ready } =
       continueTurnInput == null
-        ? await this._startPromptTurn({ options, runtimeContext })
+        ? await this._startPromptTurn({ options })
         : await this._startContinueTurn({
             session: options.session,
             turnInput: continueTurnInput,
@@ -706,7 +717,8 @@ export class HarnessAgent<
       OUTPUT
     >
   > {
-    const runtimeContext = {} as RUNTIME_CONTEXT;
+    const runtimeContext =
+      this.settings.runtimeContext ?? ({} as RUNTIME_CONTEXT);
     const { result, done } = await this._startContinueTurn({
       session: options.session,
       turnInput: {
@@ -740,7 +752,8 @@ export class HarnessAgent<
       OUTPUT
     >
   > {
-    const runtimeContext = {} as RUNTIME_CONTEXT;
+    const runtimeContext =
+      this.settings.runtimeContext ?? ({} as RUNTIME_CONTEXT);
     const { result, ready } = await this._startContinueTurn({
       session: options.session,
       turnInput: {
@@ -777,7 +790,6 @@ export class HarnessAgent<
       RUNTIME_CONTEXT
     > &
       HarnessAgentCallExtensions;
-    runtimeContext: RUNTIME_CONTEXT;
   }): Promise<
     HarnessAgentTurnResult<THarness, TUserTools, RUNTIME_CONTEXT, OUTPUT>
   > {
@@ -791,7 +803,7 @@ export class HarnessAgent<
     >({
       ...this._buildTurnOptions({
         turnSettings: turnInput,
-        runtimeContext: input.runtimeContext,
+        runtimeContext: turnInput.runtimeContext,
         abortSignal: input.options.abortSignal,
         responseFormat,
         callbacks: this._resolveLifecycleCallbacks(input.options),
@@ -960,7 +972,9 @@ export class HarnessAgent<
       RUNTIME_CONTEXT
     > &
       HarnessAgentCallExtensions,
-  ): Promise<PreparedHarnessAgentPromptTurnInput<THarness, TUserTools>> {
+  ): Promise<
+    PreparedHarnessAgentPromptTurnInput<THarness, TUserTools, RUNTIME_CONTEXT>
+  > {
     let callOptions = options;
     if (
       this.settings.callOptionsSchema != null &&
@@ -1002,6 +1016,7 @@ export class HarnessAgent<
       skills: this.settings.skills,
       instructions: this.settings.instructions,
       tools: this.settings.tools,
+      runtimeContext: this.settings.runtimeContext,
       toolsContext:
         this.settings.toolsContext ?? ({} as InferToolSetContext<TUserTools>),
       ...promptOptions,
@@ -1028,6 +1043,8 @@ export class HarnessAgent<
 
     return {
       prompt: this._resolvePromptTurnInput(preparedCallArgs),
+      runtimeContext:
+        preparedCallArgs.runtimeContext ?? ({} as RUNTIME_CONTEXT),
       ...this._prepareTurnSettings({
         model: preparedCallArgs.model,
         skills: preparedCallArgs.skills,

package/src/agent/internal/sandbox-bootstrap.ts

@@ -60,7 +60,7 @@ export function normalizeSandboxWorkDir(workDir: string): string {
 
   const normalized = posix.normalize(workDir);
   if (
-    normalized === '.' ||
+    ((normalized === '.' || normalized === './') && workDir !== '.') ||
     normalized === '..' ||
     normalized.startsWith('../')
   ) {

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

@@ -4,7 +4,7 @@ import type {
   ModelMessage,
   ToolSet,
 } from '@ai-sdk/provider-utils';
-import { createTelemetryDispatcher } from 'ai/internal';
+import { createRestrictedTelemetryDispatcher } from 'ai/internal';
 import type {
   ContentPart,
   GenerateTextOnEndCallback,
@@ -42,7 +42,7 @@ export type HarnessAgentLifecycleCallbacks<
   onEnd?: GenerateTextOnEndCallback<TOOLS, RUNTIME_CONTEXT>;
 };
 
-type Dispatcher = ReturnType<typeof createTelemetryDispatcher>;
+type Dispatcher = ReturnType<typeof createRestrictedTelemetryDispatcher>;
 
 export interface TurnLifecycle<
   TOOLS extends ToolSet,
@@ -107,7 +107,11 @@ export function createTurnLifecycle<
   const telemetry =
     options.telemetry == null
       ? ({} as Dispatcher)
-      : createTelemetryDispatcher({ telemetry: options.telemetry });
+      : createRestrictedTelemetryDispatcher<TOOLS, RUNTIME_CONTEXT, OUTPUT>({
+          telemetry: options.telemetry,
+          includeRuntimeContext: options.telemetry.includeRuntimeContext,
+          includeToolsContext: options.telemetry.includeToolsContext,
+        });
   const provider = `harness:${options.harnessId}`;
   let modelId = options.modelId ?? '';
   let started = false;