@ai-sdk/harness 1.0.91 → 1.0.93

package/src/v1/harness-v1-lifecycle-state.ts

@@ -1,4 +1,6 @@
 import type { JSONValue } from '@ai-sdk/provider';
+import type { HarnessV1Skill } from './harness-v1-skill';
+import type { HarnessV1ToolSpec } from './harness-v1-tool-spec';
 
 export type HarnessV1PendingToolApproval = {
   readonly approvalId: string;
@@ -16,6 +18,35 @@ export type HarnessV1PendingToolResult = {
   readonly input: string;
 };
 
+/**
+ * Framework-owned settings captured when a turn begins. The same settings are
+ * passed to fresh and continued turns and persisted with unfinished-turn state
+ * so a resumed continuation cannot pick up configuration from a later turn.
+ */
+export type HarnessV1TurnSettings = {
+  /**
+   * Skills made available to the underlying runtime for this turn. Adapters
+   * must replace skills from the preceding completed turn before starting a
+   * fresh turn. Rerun-based continuations use them to reconstruct the turn.
+   */
+  readonly skills: ReadonlyArray<HarnessV1Skill>;
+
+  /**
+   * Free-form instructions for this turn. Adapters should apply them through
+   * the runtime's native system or developer instruction mechanism when
+   * supported. Rerun-based continuations use them to reconstruct the turn.
+   */
+  readonly instructions?: string;
+
+  /**
+   * Host-defined tools made available to the underlying runtime for this turn.
+   * The harness emits `tool-call` events when the runtime calls one and waits
+   * for `submitToolResult`. Rerun-based continuations use them to reconstruct
+   * the turn.
+   */
+  readonly tools: ReadonlyArray<HarnessV1ToolSpec>;
+};
+
 type HarnessV1LifecycleStateBase = {
   /**
    * Identifier of the harness that produced this state. Used by adapters to
@@ -70,6 +101,13 @@ export type HarnessV1ContinueTurnState = HarnessV1LifecycleStateBase & {
    * result before the underlying turn can continue.
    */
   readonly pendingToolResults?: readonly HarnessV1PendingToolResult[];
+
+  /**
+   * Framework-owned settings captured when the unfinished turn began. They
+   * are persisted outside adapter data so a resumed continuation cannot pick
+   * up settings prepared for a later turn.
+   */
+  readonly turnSettings?: HarnessV1TurnSettings;
 };
 
 export type HarnessV1LifecycleState =

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

@@ -8,10 +8,9 @@ import type { HarnessV1ResponseFormat } from './harness-v1-response-format';
 import type {
   HarnessV1ContinueTurnState,
   HarnessV1ResumeSessionState,
+  HarnessV1TurnSettings,
 } from './harness-v1-lifecycle-state';
-import type { HarnessV1Skill } from './harness-v1-skill';
 import type { HarnessV1StreamPart } from './harness-v1-stream-part';
-import type { HarnessV1ToolSpec } from './harness-v1-tool-spec';
 import type { HarnessV1BuiltinToolFiltering } from './harness-v1-tool-filtering';
 
 /**
@@ -22,6 +21,12 @@ import type { HarnessV1BuiltinToolFiltering } from './harness-v1-tool-filtering'
  * calling the adapter, so adapters never need to derive provider-specific paths.
  */
 export type HarnessV1StartOptions = {
+  /**
+   * Model identifier selected by the consumer. Adapters interpret this value
+   * according to the underlying harness runtime.
+   */
+  readonly model?: string;
+
   /**
    * Stable identifier for this harness session. Used as the underlying
    * resource name where the adapter has a notion of a named session
@@ -29,12 +34,6 @@ export type HarnessV1StartOptions = {
    */
   readonly sessionId: string;
 
-  /**
-   * Skills made available to the underlying runtime for the lifetime of
-   * the session. Adapters decide how to surface them.
-   */
-  readonly skills?: ReadonlyArray<HarnessV1Skill>;
-
   /**
    * Optional resume payload returned by a prior session lifecycle method. When
    * provided, the adapter should resume the existing session before accepting a
@@ -95,7 +94,7 @@ export type HarnessV1StartOptions = {
 /**
  * Options passed to `HarnessV1Session.doPromptTurn`.
  */
-export type HarnessV1PromptTurnOptions = {
+export type HarnessV1PromptTurnOptions = HarnessV1TurnSettings & {
   /**
    * Fresh input for this turn — either a plain string or a single
    * `ModelMessage`. The harness session owns its own conversation history,
@@ -109,22 +108,6 @@ export type HarnessV1PromptTurnOptions = {
    */
   readonly responseFormat?: HarnessV1ResponseFormat;
 
-  /**
-   * Host-defined tools to make available to the underlying runtime for this
-   * turn. The harness emits `tool-call` events when the runtime calls one
-   * and waits for `submitToolResult`.
-   */
-  readonly tools?: ReadonlyArray<HarnessV1ToolSpec>;
-
-  /**
-   * Free-form instructions for the session. The framework supplies the same
-   * 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;
-
   /**
    * Signal that aborts the in-flight turn. The adapter must cancel any
    * underlying work and resolve `done` (with an error if appropriate).
@@ -147,27 +130,13 @@ export type HarnessV1PromptTurnOptions = {
  * in-flight turn rather than starting a new one. It is used to continue a turn
  * that was previously suspended temporarily, e.g. by the workflow slice loop.
  */
-export type HarnessV1ContinueTurnOptions = {
+export type HarnessV1ContinueTurnOptions = HarnessV1TurnSettings & {
   /**
    * Response format of the in-flight turn. Rerun-based adapters use this when
    * reconstructing the turn; attach-based adapters may ignore it.
    */
   readonly responseFormat?: HarnessV1ResponseFormat;
 
-  /**
-   * Host-defined tools to make available for the continued turn. Same shape
-   * as `doPromptTurn`'s `tools`. An adapter that purely attaches to a live turn
-   * 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/src/v1/index.ts

@@ -1,4 +1,8 @@
 export type { HarnessV1 } from './harness-v1';
+export type {
+  HarnessV1Authentication,
+  HarnessV1AuthenticationEnvironment,
+} from './harness-authentication';
 export type { HarnessV1CredentialForwarding } from './harness-v1-credential-forwarding';
 export type {
   HarnessV1Bootstrap,
@@ -40,6 +44,7 @@ export type {
   HarnessV1PendingToolApproval,
   HarnessV1PendingToolResult,
   HarnessV1ResumeSessionState,
+  HarnessV1TurnSettings,
 } from './harness-v1-lifecycle-state';
 export type {
   HarnessV1NetworkPolicy,