@ai-sdk/harness-claude-code 1.0.137 → 1.0.138

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/harness-claude-code",
-  "version": "1.0.137",
+  "version": "1.0.138",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -26,8 +26,9 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/harness": "1.0.133",
-    "@ai-sdk/provider-utils": "5.0.51",
+    "@ai-sdk/harness": "1.0.134",
+    "@ai-sdk/provider": "4.0.20",
+    "@ai-sdk/provider-utils": "5.0.52",
     "ws": "^8.21.0"
   },
   "peerDependencies": {
@@ -39,7 +40,7 @@
     "@types/node": "22.19.19",
     "@types/ws": "^8.5.13",
     "@vercel/ai-tsconfig": "0.0.0",
-    "tsup": "^8.5.1",
+    "tsdown": "^0.23.0",
     "typescript": "5.8.3",
     "zod": "3.25.76"
   },
@@ -65,9 +66,9 @@
     "claude-code"
   ],
   "scripts": {
-    "build": "pnpm clean && tsup --tsconfig tsconfig.build.json && pnpm copy-bridge-assets",
-    "build:watch": "pnpm clean && tsup --watch",
-    "clean": "del-cli dist *.tsbuildinfo",
+    "build": "pnpm clean && tsdown && pnpm copy-bridge-assets",
+    "build:watch": "pnpm clean && tsdown --watch",
+    "clean": "del-cli *.tsbuildinfo",
     "copy-bridge-assets": "node -e \"import('node:fs/promises').then(async fs => { await fs.copyFile('src/bridge/package.json', 'dist/bridge/package.json'); await fs.copyFile('src/bridge/pnpm-lock.yaml', 'dist/bridge/pnpm-lock.yaml'); await fs.copyFile('src/bridge/pnpm-workspace.yaml', 'dist/bridge/pnpm-workspace.yaml'); })\"",
     "type-check": "tsc --build",
     "test": "pnpm test:node",

package/src/bridge/create-emit-stream-event.ts

@@ -22,6 +22,9 @@ export type ClaudeMessage = {
     type?: string;
     index?: number;
     usage?: Record<string, unknown>;
+    message?: {
+      usage?: Record<string, unknown>;
+    };
     content_block?: {
       type?: string;
       id?: string;
@@ -76,6 +79,7 @@ export type ClaudeStreamEventState = {
   pendingStepAssistantUsage: Record<string, unknown> | undefined;
   pendingStepDeltaUsage: Record<string, unknown> | undefined;
   pendingStepUsage: Record<string, unknown> | undefined;
+  pendingResponseUsage: Record<string, unknown> | undefined;
   stepOpen: boolean;
   /*
    * Tool-use ids that originated from the MCP server hosting user-supplied
@@ -103,6 +107,7 @@ export function createClaudeStreamEventState(): ClaudeStreamEventState {
     pendingStepAssistantUsage: undefined,
     pendingStepDeltaUsage: undefined,
     pendingStepUsage: undefined,
+    pendingResponseUsage: undefined,
     stepOpen: false,
     mcpToolUseIds: new Set(),
     externalMcpToolUseIds: new Set(),
@@ -113,6 +118,13 @@ export function createClaudeStreamEventState(): ClaudeStreamEventState {
 
 const UNRECOVERABLE_API_RETRY_STATUSES = new Set([401, 403, 404]);
 const HOST_TOOL_PREFIX = 'mcp__harness-tools__';
+const RAW_TASK_MESSAGE_SUBTYPES = new Set([
+  'background_tasks_changed',
+  'task_started',
+  'task_progress',
+  'task_updated',
+  'task_notification',
+]);
 
 export function isExternalMcpTool(nativeName: string): boolean {
   return (
@@ -215,16 +227,28 @@ export function createEmitStreamEvent({
       return;
     }
 
+    if (
+      type === 'tool_progress' ||
+      (type === 'system' &&
+        msg.subtype != null &&
+        RAW_TASK_MESSAGE_SUBTYPES.has(msg.subtype))
+    ) {
+      emit({ type: 'raw', rawValue: msg });
+      return;
+    }
+
     // Messages emitted by a Task-tool subagent carry the parent tool-use id.
-    // They belong to the subagent stream and must not affect the parent step,
-    // including partial stream events that arrive before assistant messages.
+    // Forward them for correlation and nested rendering, but do not map them
+    // into regular stream parts or let them affect the parent step.
     if (msg.parent_tool_use_id != null) {
+      emit({ type: 'raw', rawValue: msg });
       return;
     }
 
     if (type === 'stream_event') {
       handleStreamEvent({
         event: msg.event,
+        message: msg,
         state,
         send: emit,
         toCommonName,
@@ -414,20 +438,31 @@ function formatApiRetryWarning(msg: ClaudeMessage): string {
 
 function handleStreamEvent({
   event,
+  message,
   state,
   send,
   toCommonName,
 }: {
   event: ClaudeMessage['event'] | undefined;
+  message: ClaudeMessage;
   state: ClaudeStreamEventState;
   send: Emit;
   toCommonName: (nativeName: string) => string;
 }): void {
   if (!event) return;
 
+  if (event.type === 'message_start') {
+    state.pendingResponseUsage = toUsageRecord(event.message?.usage);
+    return;
+  }
+
   if (event.type === 'message_delta') {
     const usage = toUsageRecord(event.usage);
     if (usage) {
+      state.pendingResponseUsage = mergeNonNullUsage(
+        state.pendingResponseUsage,
+        usage,
+      );
       state.pendingStepDeltaUsage = mergeNonNullUsage(
         state.pendingStepDeltaUsage,
         usage,
@@ -437,6 +472,18 @@ function handleStreamEvent({
     return;
   }
 
+  if (event.type === 'message_stop') {
+    send({
+      type: 'raw',
+      rawValue: {
+        ...message,
+        usage: state.pendingResponseUsage ?? {},
+      },
+    });
+    state.pendingResponseUsage = undefined;
+    return;
+  }
+
   if (typeof event.index !== 'number') return;
   const index = event.index;
   const partialBlocks = state.partialBlocks;

package/src/bridge/index.ts

@@ -19,7 +19,7 @@ import { argv, env as procEnv, stdout } from 'node:process';
 /*
  * CONSTRAINT — the third-party imports below are NEVER bundled into the
  * compiled `bridge/index.mjs`. They are declared `external` in
- * tsup.config.ts and resolved at runtime from the node_modules that this
+ * tsdown.config.ts and resolved at runtime from the node_modules that this
  * bridge installs *inside the sandbox* from `src/bridge/package.json` (and
  * its pinned `pnpm-lock.yaml`). That bridge package.json — NOT this host
  * package — is the single source of truth for these packages and their
@@ -30,7 +30,7 @@ import { argv, env as procEnv, stdout } from 'node:process';
  * in sync, or the bridge will either get the dependency bundled in or fail
  * to resolve it in the sandbox:
  *   1. the import statement below,
- *   2. the `external` array in tsup.config.ts, and
+ *   2. the `external` array in tsdown.config.ts, and
  *   3. the dependency entry in `src/bridge/package.json`.
  */
 import * as claudeAgentSdk from '@anthropic-ai/claude-agent-sdk';
@@ -484,6 +484,12 @@ async function runTurn(start: StartMessage, turn: BridgeTurn): Promise<void> {
     options: {
       ...(start.model ? { model: start.model } : {}),
       ...(start.maxTurns !== undefined ? { maxTurns: start.maxTurns } : {}),
+      ...(start.agentProgressSummaries !== undefined
+        ? { agentProgressSummaries: start.agentProgressSummaries }
+        : {}),
+      ...(start.forwardSubagentText !== undefined
+        ? { forwardSubagentText: start.forwardSubagentText }
+        : {}),
       ...(start.env !== undefined ? { env: { ...procEnv, ...start.env } } : {}),
       ...(skillsOption ? { skills: skillsOption } : {}),
       ...(nativeTools !== undefined ? { tools: nativeTools } : {}),

package/src/claude-code-bridge-protocol.ts

@@ -35,6 +35,8 @@ export const startMessageSchema = harnessV1BridgeStartBaseSchema.extend({
   thinking: thinkingSchema,
   effort: z.enum(['low', 'medium', 'high', 'xhigh', 'max']).optional(),
   maxTurns: z.number().optional(),
+  agentProgressSummaries: z.boolean().optional(),
+  forwardSubagentText: z.boolean().optional(),
   env: z.record(z.string(), z.string()).optional(),
   skills: z.array(z.string()).optional(),
   mcpServers: z.record(z.string(), z.unknown()).optional(),

package/src/claude-code-harness.ts

@@ -102,6 +102,16 @@ export type ClaudeCodeHarnessSettings = {
    * back to the caller. Unset means the CLI's default.
    */
   readonly maxTurns?: number;
+  /**
+   * Enables periodic AI-generated progress summaries for running subagents.
+   * The summaries are forwarded in raw `task_progress` stream parts.
+   */
+  readonly agentProgressSummaries?: boolean;
+  /**
+   * Forwards subagent text and thinking messages in addition to tool activity.
+   * Subagent messages are exposed as raw stream parts.
+   */
+  readonly forwardSubagentText?: boolean;
   /**
    * Environment variables for the Claude Code process. These values are
    * merged over the sandbox bridge process environment.
@@ -1036,6 +1046,8 @@ export function createClaudeCode(
             // sandbox is left running, stopped, or destroyed.
             proc: undefined,
             maxTurns: settings.maxTurns,
+            agentProgressSummaries: settings.agentProgressSummaries,
+            forwardSubagentText: settings.forwardSubagentText,
             env: sandboxClaudeEnvironment,
             thinking,
             effort: settings.effort,
@@ -1197,6 +1209,8 @@ export function createClaudeCode(
         finishListenerAttachment,
         proc,
         maxTurns: settings.maxTurns,
+        agentProgressSummaries: settings.agentProgressSummaries,
+        forwardSubagentText: settings.forwardSubagentText,
         env: sandboxClaudeEnvironment,
         thinking,
         effort: settings.effort,
@@ -1513,6 +1527,8 @@ function createSession({
   finishListenerAttachment,
   proc,
   maxTurns,
+  agentProgressSummaries,
+  forwardSubagentText,
   env,
   thinking,
   effort,
@@ -1538,6 +1554,8 @@ function createSession({
   /** Undefined on `attach` — the live bridge was spawned by another process. */
   proc: Experimental_SandboxProcess | undefined;
   maxTurns: number | undefined;
+  agentProgressSummaries: boolean | undefined;
+  forwardSubagentText: boolean | undefined;
   env: Readonly<Record<string, string>> | undefined;
   thinking: ClaudeCodeThinkingConfig;
   effort: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | undefined;
@@ -1811,6 +1829,10 @@ function createSession({
           : {}),
         model: promptOpts.model,
         maxTurns,
+        ...(agentProgressSummaries !== undefined
+          ? { agentProgressSummaries }
+          : {}),
+        ...(forwardSubagentText !== undefined ? { forwardSubagentText } : {}),
         ...(env !== undefined ? { env } : {}),
         thinking,
         ...(effort !== undefined ? { effort } : {}),
@@ -1875,6 +1897,10 @@ function createSession({
             : {}),
           model: continueOpts.model,
           maxTurns,
+          ...(agentProgressSummaries !== undefined
+            ? { agentProgressSummaries }
+            : {}),
+          ...(forwardSubagentText !== undefined ? { forwardSubagentText } : {}),
           ...(env !== undefined ? { env } : {}),
           thinking,
           ...(effort !== undefined ? { effort } : {}),

package/src/index.ts

@@ -12,3 +12,4 @@ export { VERSION } from './version';
 export type { ClaudeCodeHarnessSettings } from './claude-code-harness';
 export type { ClaudeCodeAuthenticationMode } from './claude-code-auth';
 export type { ClaudeCodeThinkingConfig } from './claude-code-thinking';
+export type { JSONObject } from '@ai-sdk/provider';