experimental-ash 0.2.0-alpha.2 → 0.2.0-alpha.21

package/dist/src/harness/messages.js

@@ -1,22 +1,22 @@
 /**
- * Merges two queued turn inputs into one.
+ * Merges two queued deliver payloads into one.
  *
- * Used by the execution layer to coalesce follow-up inputs that arrived while
- * a turn was in progress, so the next harness turn sees one consolidated
+ * Used by the execution layer to coalesce follow-up deliveries that arrived
+ * while a turn was in progress, so the next runtime turn sees one consolidated
  * payload.
  */
 export function coalesceTurnInputs(a, b) {
-    const inputResults = coalesceInputResults({
-        a: a.inputResults,
-        b: b.inputResults,
+    const inputResponses = coalesceInputResponses({
+        a: a.inputResponses,
+        b: b.inputResponses,
     });
     const message = coalesceMessageText({
         a: a.message,
         b: b.message,
     });
     const nextInput = {};
-    if (inputResults !== undefined) {
-        nextInput.inputResults = inputResults;
+    if (inputResponses !== undefined) {
+        nextInput.inputResponses = inputResponses;
     }
     if (message !== undefined) {
         nextInput.message = message;
@@ -24,20 +24,23 @@ export function coalesceTurnInputs(a, b) {
     return nextInput;
 }
 /**
- * Extracts the concatenated assistant text from model response messages.
+ * Extracts the final visible assistant text from model response messages.
  *
- * Prefers text extracted from the message content parts. Falls back to the
- * raw `text` property from the AI SDK result when no content text is found.
- * Returns `null` when neither source contains text.
+ * Prefers text extracted from the last assistant message that contains visible
+ * text. Falls back to the raw `text` property from the AI SDK result when no
+ * assistant message contains text. Returns `null` when neither source contains
+ * text.
  */
 export function resolveAssistantStepText(messages, fallback) {
-    const text = messages
-        .filter((message) => message.role === "assistant")
-        .map((message) => extractMessageText(message))
-        .filter((value) => value.length > 0)
-        .join("");
-    if (text.length > 0) {
-        return text;
+    for (let index = messages.length - 1; index >= 0; index -= 1) {
+        const message = messages[index];
+        if (message?.role !== "assistant") {
+            continue;
+        }
+        const text = extractMessageText(message);
+        if (text.length > 0) {
+            return text;
+        }
     }
     if (fallback !== undefined && fallback.length > 0) {
         return fallback;
@@ -62,7 +65,7 @@ function extractMessageText(message) {
     })
         .join("");
 }
-function coalesceInputResults(input) {
+function coalesceInputResponses(input) {
     const a = input.a ?? [];
     const b = input.b ?? [];
     if (a.length === 0 && b.length === 0) {

package/dist/src/harness/messages.js.map

@@ -1 +1 @@
-{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../../src/harness/messages.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../../src/harness/messages.ts"],"names":[],"mappings":"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"}

package/dist/src/harness/provider-tools.d.ts

@@ -9,8 +9,8 @@ type WebSearchBackend = "anthropic" | "gateway" | "google" | "openai";
  *
  * - OpenAI models (gateway or BYO): native OpenAI search
  * - Anthropic models (gateway or BYO): native Anthropic search
- * - Google models (gateway or BYO): native Google search grounding
- * - Other models on AI Gateway: Perplexity search via gateway
+ * - Direct/BYO Google models: native Google search grounding
+ * - Other models on AI Gateway (including `google/...`): Perplexity search via gateway
  * - Other BYO models: not available (returns `null`)
  */
 export declare function resolveWebSearchBackend(modelRef: RuntimeModelReference): WebSearchBackend | null;

package/dist/src/harness/provider-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider-tools.d.ts","sourceRoot":"","sources":["../../../src/harness/provider-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAElC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E;;GAEG;AACH,KAAK,gBAAgB,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEtE;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,gBAAgB,GAAG,IAAI,CAoBhG;AAED;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAmB1B"}
+{"version":3,"file":"provider-tools.d.ts","sourceRoot":"","sources":["../../../src/harness/provider-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAElC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E;;GAEG;AACH,KAAK,gBAAgB,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEtE;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,gBAAgB,GAAG,IAAI,CAoBhG;AAED;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAuB1B"}

package/dist/src/harness/provider-tools.js

@@ -3,8 +3,8 @@
  *
  * - OpenAI models (gateway or BYO): native OpenAI search
  * - Anthropic models (gateway or BYO): native Anthropic search
- * - Google models (gateway or BYO): native Google search grounding
- * - Other models on AI Gateway: Perplexity search via gateway
+ * - Direct/BYO Google models: native Google search grounding
+ * - Other models on AI Gateway (including `google/...`): Perplexity search via gateway
  * - Other BYO models: not available (returns `null`)
  */
 export function resolveWebSearchBackend(modelRef) {
@@ -38,7 +38,11 @@ export async function resolveWebSearchProviderTool(backend) {
         }
         case "anthropic": {
             const { anthropic } = await import("@ai-sdk/anthropic");
-            return anthropic.tools.webSearch_20260209();
+            // `webSearch_20260209()` in @ai-sdk/anthropic@3.0.68 adds the
+            // `code-execution-web-tools-2026-02-09` beta header, which Anthropic
+            // currently rejects. Keep Anthropic web search working by using the
+            // stable tool version until the upstream helper is fixed.
+            return anthropic.tools.webSearch_20250305();
         }
         case "google": {
             const { google } = await import("@ai-sdk/google");

package/dist/src/harness/provider-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider-tools.js","sourceRoot":"","sources":["../../../src/harness/provider-tools.ts"],"names":[],"mappings":"AASA;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAA+B;IACrE,MAAM,UAAU,GAAG,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAEnD,IAAI,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAChE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,UAAU,KAAK,WAAW,IAAI,UAAU,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACtE,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACrC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,OAAyB;IAEzB,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;YAClD,OAAO,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAoB,CAAC;QACvD,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;YACxD,OAAO,SAAS,CAAC,KAAK,CAAC,kBAAkB,EAAqB,CAAC;QACjE,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;YAClD,OAAO,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAoB,CAAC;QAC1D,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YACvC,OAAO,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAqB,CAAC;QAC7D,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"provider-tools.js","sourceRoot":"","sources":["../../../src/harness/provider-tools.ts"],"names":[],"mappings":"AASA;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAA+B;IACrE,MAAM,UAAU,GAAG,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAEnD,IAAI,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAChE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,UAAU,KAAK,WAAW,IAAI,UAAU,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACtE,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACrC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,OAAyB;IAEzB,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;YAClD,OAAO,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAoB,CAAC;QACvD,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;YACxD,8DAA8D;YAC9D,qEAAqE;YACrE,oEAAoE;YACpE,0DAA0D;YAC1D,OAAO,SAAS,CAAC,KAAK,CAAC,kBAAkB,EAAqB,CAAC;QACjE,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;YAClD,OAAO,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAoB,CAAC;QAC1D,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YACvC,OAAO,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAqB,CAAC;QAC7D,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/harness/step-hooks.d.ts

@@ -0,0 +1,77 @@
+import type { LanguageModel, PrepareStepFunction, StepResult, ToolSet } from "ai";
+import type { HarnessEmissionState } from "./emission.js";
+import { type AnthropicCacheMarker, type PromptCachePath } from "./prompt-cache.js";
+import type { HarnessEmitFn, HarnessSession, ToolLoopHarnessConfig } from "./types.js";
+/**
+ * The subset of `StepResult` that the harness reads after a step completes.
+ *
+ * Used by both the streaming (`onStepFinish` callback) and non-streaming
+ * (`generateText` result) code paths.
+ */
+export type HarnessStepResult = Pick<StepResult<ToolSet>, "content" | "finishReason" | "response" | "text" | "toolCalls" | "toolResults" | "usage">;
+/**
+ * Input for {@link buildStepHooks}.
+ */
+export interface StepHooksInput {
+    readonly cachePath: PromptCachePath;
+    readonly emit?: HarnessEmitFn;
+    readonly emissionState: HarnessEmissionState;
+    readonly marker: AnthropicCacheMarker | undefined;
+    readonly model: LanguageModel;
+    readonly onCompaction?: ToolLoopHarnessConfig["onCompaction"];
+    readonly resolveModel: ToolLoopHarnessConfig["resolveModel"];
+    readonly session: HarnessSession;
+}
+/**
+ * Composable hooks returned by {@link buildStepHooks}.
+ */
+export interface StepHooks {
+    /**
+     * Returns the session, which may have been updated by compaction inside
+     * `prepareStep`. Call after the agent finishes.
+     */
+    readonly getSession: () => HarnessSession;
+    /**
+     * `ToolLoopAgent` `onStepFinish` callback.
+     *
+     * Emits `actions.requested`, `action.result`, and `step.completed` events
+     * from the captured step result.
+     */
+    readonly onStepFinish: (step: StepResult<ToolSet>) => Promise<void>;
+    /**
+     * `ToolLoopAgent` `prepareStep` callback.
+     *
+     * Handles, in order:
+     * 1. `step.started` emission
+     * 2. Compaction (if needed)
+     * 3. Anthropic message cache markers
+     * 4. Gateway provider options
+     */
+    readonly prepareStep: PrepareStepFunction<ToolSet>;
+    /**
+     * Promise that resolves when `onStepFinish` has completed.
+     *
+     * Await this after consuming the stream to ensure all step events
+     * have been emitted before proceeding to post-step handling.
+     */
+    readonly stepResult: Promise<HarnessStepResult>;
+}
+/**
+ * Builds composable `prepareStep` and `onStepFinish` closures that
+ * own all step-internal work: emission, compaction, and prompt caching.
+ *
+ * The harness passes these hooks to `ToolLoopAgent` and reads the
+ * results via `getSession()` and `stepResult` after the agent finishes.
+ */
+export declare function buildStepHooks(input: StepHooksInput): StepHooks;
+/**
+ * Emits `actions.requested`, `action.result`, and `step.completed` events
+ * from a captured step result.
+ *
+ * Tool calls and results that match `excludedActionToolNames` or belong to
+ * tool-approval requests are filtered out of the emitted events.
+ */
+export declare function emitStepActions(emitFn: HarnessEmitFn, state: HarnessEmissionState, step: HarnessStepResult, options: {
+    readonly excludedActionToolNames: ReadonlySet<string>;
+}): Promise<void>;
+//# sourceMappingURL=step-hooks.d.ts.map

package/dist/src/harness/step-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-hooks.d.ts","sourceRoot":"","sources":["../../../src/harness/step-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,aAAa,EAEb,mBAAmB,EACnB,UAAU,EACV,OAAO,EAGR,MAAM,IAAI,CAAC;AAeZ,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAG1D,OAAO,EACL,KAAK,oBAAoB,EAGzB,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAMvF;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,UAAU,CAAC,OAAO,CAAC,EACnB,SAAS,GAAG,cAAc,GAAG,UAAU,GAAG,MAAM,GAAG,WAAW,GAAG,aAAa,GAAG,OAAO,CACzF,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,oBAAoB,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,qBAAqB,CAAC,cAAc,CAAC,CAAC;IAC9D,QAAQ,CAAC,YAAY,EAAE,qBAAqB,CAAC,cAAc,CAAC,CAAC;IAC7D,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,cAAc,CAAC;IAE1C;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpE;;;;;;;;OAQG;IACH,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAEnD;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACjD;AAMD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAwG/D;AAMD;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,oBAAoB,EAC3B,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE;IACP,QAAQ,CAAC,uBAAuB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACvD,GACA,OAAO,CAAC,IAAI,CAAC,CA8Df"}

package/dist/src/harness/step-hooks.js

@@ -0,0 +1,192 @@
+import { createActionResultEvent, createActionsRequestedEvent, createCompactionCompletedEvent, createCompactionRequestedEvent, createStepCompletedEvent, } from "../protocol/message.js";
+import { compactMessages, getInputTokenCount, resolveCompactionModel, shouldCompact, } from "./compaction.js";
+import { emitStepStarted, normalizeAssistantStepFinishReason } from "./emission.js";
+import { extractToolApprovalInputRequests } from "./input-extraction.js";
+import { applyConversationCacheControl, mergeGatewayAutoCaching, } from "./prompt-cache.js";
+// ---------------------------------------------------------------------------
+// Builder
+// ---------------------------------------------------------------------------
+/**
+ * Builds composable `prepareStep` and `onStepFinish` closures that
+ * own all step-internal work: emission, compaction, and prompt caching.
+ *
+ * The harness passes these hooks to `ToolLoopAgent` and reads the
+ * results via `getSession()` and `stepResult` after the agent finishes.
+ */
+export function buildStepHooks(input) {
+    let session = input.session;
+    const emit = input.emit;
+    let resolveStep;
+    const stepResult = new Promise((resolve) => {
+        resolveStep = resolve;
+    });
+    // -------------------------------------------------------------------------
+    // prepareStep
+    // -------------------------------------------------------------------------
+    const prepareStep = async ({ messages }) => {
+        let processed = [...messages];
+        // 1. step.started
+        if (emit) {
+            await emitStepStarted(emit, input.emissionState);
+        }
+        // 2. Compaction
+        if (shouldCompact(processed, session.compaction)) {
+            const compaction = await resolveCompactionModel({
+                compactionModelReference: session.agent.compactionModelReference,
+                model: input.model,
+                modelReference: session.agent.modelReference,
+                resolveModel: input.resolveModel,
+            });
+            if (emit) {
+                await emit(createCompactionRequestedEvent({
+                    modelId: formatModelId(compaction.model),
+                    sequence: input.emissionState.sequence,
+                    sessionId: session.sessionId,
+                    thresholdPercent: 0,
+                    turnId: input.emissionState.turnId,
+                    usageInputTokens: getInputTokenCount(processed, session.compaction),
+                }));
+            }
+            processed = await compactMessages(processed, compaction.model, session.compaction, compaction.providerOptions);
+            if (input.onCompaction) {
+                const compacted = await input.onCompaction(session);
+                session = compacted.session;
+                for (const msg of compacted.messages) {
+                    processed.push(msg);
+                }
+            }
+            if (emit) {
+                await emit(createCompactionCompletedEvent({
+                    lastCompactionIndex: 0,
+                    modelId: formatModelId(compaction.model),
+                    sequence: input.emissionState.sequence,
+                    sessionId: session.sessionId,
+                    turnId: input.emissionState.turnId,
+                }));
+            }
+        }
+        // 3. Anthropic message cache markers
+        if (input.cachePath.kind === "anthropic-direct" && input.marker) {
+            processed = applyConversationCacheControl(processed, input.marker);
+        }
+        // 4. Gateway provider options
+        const stepResult = {
+            messages: processed,
+        };
+        if (input.cachePath.kind === "gateway-auto") {
+            stepResult.providerOptions = mergeGatewayAutoCaching(session.agent.modelReference.providerOptions);
+        }
+        return stepResult;
+    };
+    // -------------------------------------------------------------------------
+    // onStepFinish
+    // -------------------------------------------------------------------------
+    const onStepFinish = async (step) => {
+        resolveStep(step);
+    };
+    return {
+        getSession: () => session,
+        onStepFinish,
+        prepareStep,
+        stepResult,
+    };
+}
+// ---------------------------------------------------------------------------
+// Step action emission
+// ---------------------------------------------------------------------------
+/**
+ * Emits `actions.requested`, `action.result`, and `step.completed` events
+ * from a captured step result.
+ *
+ * Tool calls and results that match `excludedActionToolNames` or belong to
+ * tool-approval requests are filtered out of the emitted events.
+ */
+export async function emitStepActions(emitFn, state, step, options) {
+    const excludedCallIds = new Set(extractToolApprovalInputRequests({
+        content: (step.content ?? []),
+    }).map((request) => request.action.callId));
+    const isExcluded = (toolCallId, toolName) => excludedCallIds.has(toolCallId) || options.excludedActionToolNames.has(toolName);
+    // actions.requested
+    const actions = step.toolCalls
+        .filter((tc) => !isExcluded(tc.toolCallId, tc.toolName))
+        .map((tc) => ({
+        callId: tc.toolCallId,
+        input: tc.input,
+        kind: "tool-call",
+        toolName: tc.toolName,
+    }));
+    if (actions.length > 0) {
+        await emitFn(createActionsRequestedEvent({
+            actions,
+            sequence: state.sequence,
+            stepIndex: state.stepIndex,
+            turnId: state.turnId,
+        }));
+    }
+    // action.result for each tool result
+    for (const tr of step.toolResults) {
+        if (isExcluded(tr.toolCallId, tr.toolName)) {
+            continue;
+        }
+        await emitFn(createActionResultEvent({
+            result: {
+                callId: tr.toolCallId,
+                kind: "tool-result",
+                output: serializeActionOutput(tr.output),
+                toolName: tr.toolName,
+            },
+            sequence: state.sequence,
+            stepIndex: state.stepIndex,
+            turnId: state.turnId,
+        }));
+    }
+    // step.completed
+    await emitFn(createStepCompletedEvent({
+        finishReason: normalizeAssistantStepFinishReason(step.finishReason),
+        sequence: state.sequence,
+        stepIndex: state.stepIndex,
+        turnId: state.turnId,
+        usage: extractStepUsage(step.usage),
+    }));
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function formatModelId(model) {
+    if (typeof model === "string") {
+        return model;
+    }
+    return `${model.provider}/${model.modelId}`;
+}
+function serializeActionOutput(value) {
+    if (typeof value === "string") {
+        return value;
+    }
+    if (value instanceof Error) {
+        return value.message;
+    }
+    const serialized = JSON.stringify(value);
+    return serialized === undefined ? String(value) : serialized;
+}
+/**
+ * Projects the AI SDK's `LanguageModelUsage` into the flat `step.completed`
+ * event usage shape. Returns `undefined` when the SDK reports no usage.
+ */
+function extractStepUsage(usage) {
+    if (usage === undefined) {
+        return undefined;
+    }
+    const result = {};
+    if (usage.inputTokens !== undefined)
+        result.inputTokens = usage.inputTokens;
+    if (usage.outputTokens !== undefined)
+        result.outputTokens = usage.outputTokens;
+    if (usage.inputTokenDetails?.cacheReadTokens !== undefined) {
+        result.cacheReadTokens = usage.inputTokenDetails.cacheReadTokens;
+    }
+    if (usage.inputTokenDetails?.cacheWriteTokens !== undefined) {
+        result.cacheWriteTokens = usage.inputTokenDetails.cacheWriteTokens;
+    }
+    return Object.keys(result).length > 0 ? result : undefined;
+}
+//# sourceMappingURL=step-hooks.js.map

package/dist/src/harness/step-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-hooks.js","sourceRoot":"","sources":["../../../src/harness/step-hooks.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,8BAA8B,EAC9B,8BAA8B,EAC9B,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,eAAe,EAAE,kCAAkC,EAAE,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,gCAAgC,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAEL,6BAA6B,EAC7B,uBAAuB,GAExB,MAAM,mBAAmB,CAAC;AA0E3B,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,KAAqB;IAClD,IAAI,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IAExB,IAAI,WAA8C,CAAC;IACnD,MAAM,UAAU,GAAG,IAAI,OAAO,CAAoB,CAAC,OAAO,EAAE,EAAE;QAC5D,WAAW,GAAG,OAAO,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,4EAA4E;IAC5E,cAAc;IACd,4EAA4E;IAE5E,MAAM,WAAW,GAAiC,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QACvE,IAAI,SAAS,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;QAE9B,kBAAkB;QAClB,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;QACnD,CAAC;QAED,gBAAgB;QAChB,IAAI,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACjD,MAAM,UAAU,GAAG,MAAM,sBAAsB,CAAC;gBAC9C,wBAAwB,EAAE,OAAO,CAAC,KAAK,CAAC,wBAAwB;gBAChE,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,cAAc,EAAE,OAAO,CAAC,KAAK,CAAC,cAAc;gBAC5C,YAAY,EAAE,KAAK,CAAC,YAAY;aACjC,CAAC,CAAC;YAEH,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,IAAI,CACR,8BAA8B,CAAC;oBAC7B,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC;oBACxC,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAC,QAAQ;oBACtC,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,gBAAgB,EAAE,CAAC;oBACnB,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,MAAM;oBAClC,gBAAgB,EAAE,kBAAkB,CAAC,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC;iBACpE,CAAC,CACH,CAAC;YACJ,CAAC;YAED,SAAS,GAAG,MAAM,eAAe,CAC/B,SAAS,EACT,UAAU,CAAC,KAAK,EAChB,OAAO,CAAC,UAAU,EAClB,UAAU,CAAC,eAAe,CAC3B,CAAC;YAEF,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;gBACvB,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;gBACpD,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC;gBAC5B,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;oBACrC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACtB,CAAC;YACH,CAAC;YAED,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,IAAI,CACR,8BAA8B,CAAC;oBAC7B,mBAAmB,EAAE,CAAC;oBACtB,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC;oBACxC,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAC,QAAQ;oBACtC,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,MAAM;iBACnC,CAAC,CACH,CAAC;YACJ,CAAC;QACH,CAAC;QAED,qCAAqC;QACrC,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,KAAK,kBAAkB,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YAChE,SAAS,GAAG,6BAA6B,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACrE,CAAC;QAED,8BAA8B;QAC9B,MAAM,UAAU,GAAmE;YACjF,QAAQ,EAAE,SAAS;SACpB,CAAC;QAEF,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAC5C,UAAU,CAAC,eAAe,GAAG,uBAAuB,CAClD,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,eAAe,CACK,CAAC;QACtD,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;IAEF,4EAA4E;IAC5E,eAAe;IACf,4EAA4E;IAE5E,MAAM,YAAY,GAAG,KAAK,EAAE,IAAyB,EAAiB,EAAE;QACtE,WAAW,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC,CAAC;IAEF,OAAO;QACL,UAAU,EAAE,GAAG,EAAE,CAAC,OAAO;QACzB,YAAY;QACZ,WAAW;QACX,UAAU;KACX,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAqB,EACrB,KAA2B,EAC3B,IAAuB,EACvB,OAEC;IAED,MAAM,eAAe,GAAG,IAAI,GAAG,CAC7B,gCAAgC,CAAC;QAC/B,OAAO,EAAE,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAA2B;KACxD,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAC3C,CAAC;IAEF,MAAM,UAAU,GAAG,CAAC,UAAkB,EAAE,QAAgB,EAAW,EAAE,CACnE,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,uBAAuB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAEnF,oBAAoB;IACpB,MAAM,OAAO,GAAI,IAAI,CAAC,SAAsC;SACzD,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC;SACvD,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACZ,MAAM,EAAE,EAAE,CAAC,UAAU;QACrB,KAAK,EAAE,EAAE,CAAC,KAAmB;QAC7B,IAAI,EAAE,WAAoB;QAC1B,QAAQ,EAAE,EAAE,CAAC,QAAQ;KACtB,CAAC,CAAC,CAAC;IAEN,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,MAAM,CACV,2BAA2B,CAAC;YAC1B,OAAO;YACP,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC,CACH,CAAC;IACJ,CAAC;IAED,qCAAqC;IACrC,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,WAAyC,EAAE,CAAC;QAChE,IAAI,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3C,SAAS;QACX,CAAC;QAED,MAAM,MAAM,CACV,uBAAuB,CAAC;YACtB,MAAM,EAAE;gBACN,MAAM,EAAE,EAAE,CAAC,UAAU;gBACrB,IAAI,EAAE,aAAsB;gBAC5B,MAAM,EAAE,qBAAqB,CAAC,EAAE,CAAC,MAAM,CAAC;gBACxC,QAAQ,EAAE,EAAE,CAAC,QAAQ;aACtB;YACD,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC,CACH,CAAC;IACJ,CAAC;IAED,iBAAiB;IACjB,MAAM,MAAM,CACV,wBAAwB,CAAC;QACvB,YAAY,EAAE,kCAAkC,CAAC,IAAI,CAAC,YAAY,CAAC;QACnE,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC;KACpC,CAAC,CACH,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,aAAa,CAAC,KAAoB;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;AAC9C,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACzC,OAAO,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;AAC/D,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,KAAqC;IAQ7D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAKR,EAAE,CAAC;IAEP,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;QAAE,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IAC5E,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS;QAAE,MAAM,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;IAC/E,IAAI,KAAK,CAAC,iBAAiB,EAAE,eAAe,KAAK,SAAS,EAAE,CAAC;QAC3D,MAAM,CAAC,eAAe,GAAG,KAAK,CAAC,iBAAiB,CAAC,eAAe,CAAC;IACnE,CAAC;IACD,IAAI,KAAK,CAAC,iBAAiB,EAAE,gBAAgB,KAAK,SAAS,EAAE,CAAC;QAC5D,MAAM,CAAC,gBAAgB,GAAG,KAAK,CAAC,iBAAiB,CAAC,gBAAgB,CAAC;IACrE,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7D,CAAC"}

package/dist/src/harness/tool-loop.d.ts

@@ -8,8 +8,10 @@ import type { StepFn, ToolLoopHarnessConfig } from "./types.js";
  * and let the agent execute any tool calls. Returns the updated session and a
  * `next` instruction telling the runtime what to do.
  *
- * When an `emit` callback is provided via config, the harness emits the full
- * lifecycle event sequence at the appropriate points during execution.
+ * Step-internal work (step.started emission, compaction, prompt caching,
+ * action emission, step.completed) is delegated to `ToolLoopAgent` hooks
+ * via {@link buildStepHooks}. The harness itself owns only turn-level
+ * bookends, input resolution, and the continuation decision.
  */
 export declare function createToolLoopHarness(config: ToolLoopHarnessConfig): StepFn;
 //# sourceMappingURL=tool-loop.d.ts.map

package/dist/src/harness/tool-loop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-loop.d.ts","sourceRoot":"","sources":["../../../src/harness/tool-loop.ts"],"names":[],"mappings":"AAuDA,OAAO,KAAK,EAEV,MAAM,EAGN,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CA0P3E"}
+{"version":3,"file":"tool-loop.d.ts","sourceRoot":"","sources":["../../../src/harness/tool-loop.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAEV,MAAM,EAGN,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAqH3E"}