@ai-sdk/harness 1.0.65 → 1.0.66

package/dist/index.d.ts

@@ -820,10 +820,10 @@ type HarnessV1PromptTurnOptions = {
     readonly tools?: ReadonlyArray<HarnessV1ToolSpec>;
     /**
      * Free-form instructions for the session. The framework supplies the same
-     * value on every turn; the adapter is responsible for applying it once, by
-     * prepending it to the first user message of a fresh (non-resumed) session.
-     * On a resumed session the adapter must not re-apply it — the original first
-     * message already carried it and lives in the runtime's persisted history.
+     * value on every turn. Adapters should append it to the runtime's native
+     * system or developer prompt when supported. Otherwise, they should prepend
+     * it to the first user message of a fresh session and rely on the runtime's
+     * persisted history when resuming.
      */
     readonly instructions?: string;
     /**
@@ -853,6 +853,12 @@ type HarnessV1ContinueTurnOptions = {
      * may ignore them; an adapter that re-drives the turn (rerun) needs them.
      */
     readonly tools?: ReadonlyArray<HarnessV1ToolSpec>;
+    /**
+     * Free-form session instructions. An adapter that re-drives the runtime may
+     * need these to reconstruct its native system or developer prompt. An
+     * adapter that attaches to a live turn may ignore them.
+     */
+    readonly instructions?: string;
     /**
      * Signal that aborts the continued turn. The adapter must cancel any
      * underlying work and resolve `done` (with an error if appropriate).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/harness",
-  "version": "1.0.65",
+  "version": "1.0.66",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -46,7 +46,7 @@
   "dependencies": {
     "@ai-sdk/provider": "4.0.7",
     "@ai-sdk/provider-utils": "5.0.26",
-    "ai": "7.0.59"
+    "ai": "7.0.60"
   },
   "peerDependencies": {
     "ws": "^8.21.0",
@@ -65,7 +65,7 @@
     "typescript": "5.8.3",
     "ws": "^8.21.0",
     "zod": "3.25.76",
-    "@ai-sdk/otel": "1.0.59",
+    "@ai-sdk/otel": "1.0.60",
     "@vercel/ai-tsconfig": "0.0.0"
   },
   "engines": {

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

@@ -132,9 +132,9 @@ export type HarnessAgentSettings<
   readonly skills?: ReadonlyArray<HarnessAgentSkill>;
 
   /**
-   * Instructions for the underlying agent runtime. Adapters prepend this to
-   * the first user message of a fresh session, once — it is not re-applied on
-   * later turns or when resuming a previously ended session.
+   * Instructions for the underlying agent runtime. Adapters append this to a
+   * native system or developer prompt when supported. Otherwise, they prepend
+   * it to the first user message of a fresh session.
    */
   readonly instructions?: string;
 

package/src/agent/internal/run-prompt.ts

@@ -72,7 +72,7 @@ export function runPrompt<
   /**
    * Turn entry point. `'prompt'` (default) starts a new turn from `prompt`;
    * `'continue'` continues the in-flight turn via `doContinueTurn` and ignores
-   * `prompt`/`instructions`.
+   * `prompt`.
    */
   mode?: 'prompt' | 'continue';
   /** Required for `mode: 'prompt'`; absent for `mode: 'continue'`. */
@@ -173,6 +173,7 @@ export function runPrompt<
             ? emit =>
                 input.session.doContinueTurn({
                   tools: input.toolSpecs,
+                  instructions: input.instructions,
                   abortSignal: input.abortSignal,
                   emit,
                 })

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

@@ -112,10 +112,10 @@ export type HarnessV1PromptTurnOptions = {
 
   /**
    * Free-form instructions for the session. The framework supplies the same
-   * value on every turn; the adapter is responsible for applying it once, by
-   * prepending it to the first user message of a fresh (non-resumed) session.
-   * On a resumed session the adapter must not re-apply it — the original first
-   * message already carried it and lives in the runtime's persisted history.
+   * value on every turn. Adapters should append it to the runtime's native
+   * system or developer prompt when supported. Otherwise, they should prepend
+   * it to the first user message of a fresh session and rely on the runtime's
+   * persisted history when resuming.
    */
   readonly instructions?: string;
 
@@ -149,6 +149,13 @@ export type HarnessV1ContinueTurnOptions = {
    */
   readonly tools?: ReadonlyArray<HarnessV1ToolSpec>;
 
+  /**
+   * Free-form session instructions. An adapter that re-drives the runtime may
+   * need these to reconstruct its native system or developer prompt. An
+   * adapter that attaches to a live turn may ignore them.
+   */
+  readonly instructions?: string;
+
   /**
    * Signal that aborts the continued turn. The adapter must cancel any
    * underlying work and resolve `done` (with an error if appropriate).