@ai-sdk/harness 1.0.36 → 1.0.38

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @ai-sdk/harness
 
+## 1.0.38
+
+### Patch Changes
+
+- Updated dependencies [02ffdcb]
+- Updated dependencies [76cb673]
+- Updated dependencies [e808fa5]
+- Updated dependencies [33647d7]
+  - @ai-sdk/provider-utils@5.0.12
+  - ai@7.0.33
+
+## 1.0.37
+
+### Patch Changes
+
+- b460541: fix(harness): properly support client-side / host-side tools and handle unfinished turn semantics
+- 079591e: fix (harness): emit the message-level `start` part on HarnessAgent streams so `toUIMessageStream` persistence mode can inject the response message id
+- Updated dependencies [6cd7c74]
+- Updated dependencies [e35bcae]
+- Updated dependencies [a4eb3f3]
+  - ai@7.0.32
+
 ## 1.0.36
 
 ### Patch Changes

package/agent/index.ts

@@ -16,6 +16,7 @@ export type {
   HarnessAgentContinueTurnState,
   HarnessAgentLifecycleState,
   HarnessAgentPendingToolApproval,
+  HarnessAgentPendingToolResult,
   HarnessAgentPermissionMode,
   HarnessAgentPrompt,
   HarnessAgentPromptControl,
@@ -31,6 +32,10 @@ export {
   collectHarnessAgentToolApprovalContinuations,
   type HarnessAgentToolApprovalContinuation,
 } from '../src/agent/harness-agent-tool-approval-continuation';
+export {
+  collectHarnessAgentToolResultContinuations,
+  type HarnessAgentToolResultContinuation,
+} from '../src/agent/harness-agent-tool-result-continuation';
 export {
   prepareHarnessSandboxTemplate,
   prewarmHarness,

package/dist/agent/index.d.ts

@@ -366,6 +366,11 @@ type HarnessV1PendingToolApproval = {
     readonly providerExecuted?: boolean;
     readonly nativeName?: string;
 };
+type HarnessV1PendingToolResult = {
+    readonly toolCallId: string;
+    readonly toolName: string;
+    readonly input: string;
+};
 type HarnessV1LifecycleStateBase = {
     /**
      * Identifier of the harness that produced this state. Used by adapters to
@@ -408,6 +413,11 @@ type HarnessV1ContinueTurnState = HarnessV1LifecycleStateBase & {
      * without the harness framework owning storage.
      */
     readonly pendingToolApprovals?: readonly HarnessV1PendingToolApproval[];
+    /**
+     * Framework-owned client tool calls that are waiting for a caller-provided
+     * result before the underlying turn can continue.
+     */
+    readonly pendingToolResults?: readonly HarnessV1PendingToolResult[];
 };
 type HarnessV1LifecycleState = HarnessV1ResumeSessionState | HarnessV1ContinueTurnState;
 
@@ -1059,6 +1069,7 @@ type HarnessAgentLifecycleState = HarnessV1LifecycleState;
 type HarnessAgentResumeSessionState = HarnessV1ResumeSessionState;
 type HarnessAgentContinueTurnState = HarnessV1ContinueTurnState;
 type HarnessAgentPendingToolApproval = HarnessV1PendingToolApproval;
+type HarnessAgentPendingToolResult = HarnessV1PendingToolResult;
 type HarnessAgentSkill = HarnessV1Skill;
 type HarnessAgentPermissionMode = HarnessV1PermissionMode;
 
@@ -1239,11 +1250,25 @@ declare function collectHarnessAgentToolApprovalContinuations(input: {
     messages: readonly ModelMessage[];
 }): readonly HarnessAgentToolApprovalContinuation[];
 
+type HarnessAgentToolResultContinuation = {
+    readonly toolCallId: string;
+    readonly output: unknown;
+    readonly isError?: boolean;
+};
+/**
+ * Extract client-provided tool results from the trailing tool message and
+ * convert AI SDK model-output wrappers back into values a harness runtime can
+ * return from its pending host-tool invocation.
+ */
+declare function collectHarnessAgentToolResultContinuations(input: {
+    messages: readonly ModelMessage[];
+}): readonly HarnessAgentToolResultContinuation[];
+
 type HarnessAgentTurnResult<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Context> = {
     result: StreamTextResult<TOOLS, RUNTIME_CONTEXT, never>;
     done: Promise<void>;
 };
-type HarnessAgentTurnState = 'idle' | 'running' | 'awaiting-approval' | 'suspended';
+type HarnessAgentTurnState = 'idle' | 'running' | 'awaiting-approval' | 'awaiting-tool-result' | 'suspended';
 /**
  * Live harness session held by the caller.
  *
@@ -1273,6 +1298,7 @@ declare class HarnessAgentSession {
     private leasedBridgePort;
     private readonly toolApproval;
     private readonly pendingToolApprovals;
+    private readonly pendingToolResults;
     private sessionState;
     private turnState;
     private turnSequence;
@@ -1292,8 +1318,10 @@ declare class HarnessAgentSession {
         sessionWorkDir: string;
         toolApproval: HarnessAgentToolApprovalConfiguration | undefined;
         pendingToolApprovals?: readonly HarnessAgentPendingToolApproval[];
+        pendingToolResults?: readonly HarnessAgentPendingToolResult[];
         turnState?: HarnessAgentTurnState;
     });
+    hasUnfinishedTurn(): boolean;
     promptTurn<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Context>(options: {
         prompt: HarnessAgentPrompt;
         instructions: string | undefined;
@@ -1315,6 +1343,7 @@ declare class HarnessAgentSession {
         abortSignal: AbortSignal | undefined;
         telemetry: TelemetryOptions | undefined;
         toolApprovalContinuations?: readonly HarnessAgentToolApprovalContinuation[] | undefined;
+        toolResultContinuations?: readonly HarnessAgentToolResultContinuation[] | undefined;
     }): HarnessAgentTurnResult<TOOLS, RUNTIME_CONTEXT>;
     /**
      * Ask the underlying runtime to compact its context. The runtime performs
@@ -1360,14 +1389,15 @@ declare class HarnessAgentSession {
      */
     suspendTurn(): Promise<HarnessAgentContinueTurnState>;
     private getPendingToolApprovals;
-    private addPendingToolApprovals;
+    private getPendingToolResults;
+    private addPendingToolState;
     private suspendCurrentTurn;
     private toResumeStateWithContinuation;
     private requirePromptableTurn;
     private requireContinuableTurn;
     private markAwaitingApprovalIfActive;
+    private markAwaitingToolResultIfActive;
     private startTrackedTurn;
-    private trackTurnCompletion;
     private finishTrackedTurn;
     private endLocalHandle;
     private releasePortLease;
@@ -1478,6 +1508,7 @@ declare class HarnessAgent<THarness extends HarnessAgentAdapter<any> = HarnessAg
     continueGenerate(options: {
         session: HarnessAgentSession;
         toolApprovalContinuations?: readonly HarnessAgentToolApprovalContinuation[];
+        toolResultContinuations?: readonly HarnessAgentToolResultContinuation[];
         abortSignal?: AbortSignal;
     }): Promise<GenerateTextResult<HarnessAllTools<THarness, TUserTools>, RUNTIME_CONTEXT, never>>;
     /**
@@ -1491,6 +1522,7 @@ declare class HarnessAgent<THarness extends HarnessAgentAdapter<any> = HarnessAg
     continueStream(options: {
         session: HarnessAgentSession;
         toolApprovalContinuations?: readonly HarnessAgentToolApprovalContinuation[];
+        toolResultContinuations?: readonly HarnessAgentToolResultContinuation[];
         abortSignal?: AbortSignal;
     }): Promise<StreamTextResult<HarnessAllTools<THarness, TUserTools>, RUNTIME_CONTEXT, never>>;
     private _startTurn;
@@ -1628,4 +1660,4 @@ interface TraceTreeReporterOptions {
 }
 declare function createTraceTreeReporter(options?: TraceTreeReporterOptions): Telemetry;
 
-export { type FileReporter, type FileReporterOptions, HarnessAgent, type HarnessAgentAdapter, type HarnessAgentAdapterSession, type HarnessAgentBuiltinTool, type HarnessAgentBuiltinToolName, type HarnessAgentBuiltinToolUseKind, type HarnessAgentBuiltinTools, type HarnessAgentContinueTurnOptions, type HarnessAgentContinueTurnState, type HarnessAgentLifecycleState, type HarnessAgentPendingToolApproval, type HarnessAgentPermissionMode, type HarnessAgentPrompt, type HarnessAgentPromptControl, type HarnessAgentPromptTurnOptions, type HarnessAgentResumeSessionState, type HarnessAgentSandboxConfig, HarnessAgentSession, type HarnessAgentSettings, type HarnessAgentSkill, type HarnessAgentStartOptions, type HarnessAgentStreamPart, type HarnessAgentToolApprovalConfiguration, type HarnessAgentToolApprovalContinuation, type HarnessAgentToolSpec, type HarnessAllTools, HarnessCapabilityUnsupportedError, type HarnessDebugConfig, type HarnessDebugLevel, type HarnessDiagnostic, type HarnessDiagnosticConsumer, HarnessError, type PrepareSandboxForHarnessResult, type TraceTreeReporterOptions, collectHarnessAgentToolApprovalContinuations, createFileReporter, createTraceTreeReporter, prepareHarnessSandboxTemplate, prepareSandboxForHarness, prewarmHarness };
+export { type FileReporter, type FileReporterOptions, HarnessAgent, type HarnessAgentAdapter, type HarnessAgentAdapterSession, type HarnessAgentBuiltinTool, type HarnessAgentBuiltinToolName, type HarnessAgentBuiltinToolUseKind, type HarnessAgentBuiltinTools, type HarnessAgentContinueTurnOptions, type HarnessAgentContinueTurnState, type HarnessAgentLifecycleState, type HarnessAgentPendingToolApproval, type HarnessAgentPendingToolResult, type HarnessAgentPermissionMode, type HarnessAgentPrompt, type HarnessAgentPromptControl, type HarnessAgentPromptTurnOptions, type HarnessAgentResumeSessionState, type HarnessAgentSandboxConfig, HarnessAgentSession, type HarnessAgentSettings, type HarnessAgentSkill, type HarnessAgentStartOptions, type HarnessAgentStreamPart, type HarnessAgentToolApprovalConfiguration, type HarnessAgentToolApprovalContinuation, type HarnessAgentToolResultContinuation, type HarnessAgentToolSpec, type HarnessAllTools, HarnessCapabilityUnsupportedError, type HarnessDebugConfig, type HarnessDebugLevel, type HarnessDiagnostic, type HarnessDiagnosticConsumer, HarnessError, type PrepareSandboxForHarnessResult, type TraceTreeReporterOptions, collectHarnessAgentToolApprovalContinuations, collectHarnessAgentToolResultContinuations, createFileReporter, createTraceTreeReporter, prepareHarnessSandboxTemplate, prepareSandboxForHarness, prewarmHarness };