@tanstack/ai 0.36.0 → 0.37.0

package/dist/esm/activities/chat/middleware/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sources":["../../../../../src/activities/chat/middleware/capabilities.ts"],"sourcesContent":["/** Options accepted by a capability getter. */\nexport interface CapabilityGetOptions {\n  /** When true, return undefined instead of throwing if the capability is absent. */\n  optional?: boolean\n}\n\n/**\n * The minimal context shape a capability accessor needs. The full\n * `ChatMiddlewareContext` satisfies this (it has `capabilities`), so accessors\n * accept any middleware context without referencing `any`.\n */\nexport interface CapabilityContext {\n  capabilities: CapabilityRegistry\n}\n\n/** Reads a capability value off a context. Overloaded so the flag narrows the return. */\nexport interface CapabilityGetter<TValue> {\n  (ctx: CapabilityContext): TValue\n  (ctx: CapabilityContext, opts: { optional: true }): TValue | undefined\n}\n\n/** Writes a capability value onto a context. */\nexport type CapabilityProvider<TValue> = (\n  ctx: CapabilityContext,\n  value: TValue,\n) => void\n\n/**\n * A capability handle. It is BOTH a `[get, provide]` tuple (array-destructurable)\n * AND the identity used in middleware `requires`/`provides` declarations.\n *\n * Runtime identity is this object's reference. The `capabilityName` literal is\n * used for diagnostics and COMPILE-TIME tracking only — capability names MUST be\n * unique across an app or the type-level coverage check conflates them.\n */\nexport type Capability<\n  TValue = unknown,\n  TName extends string = string,\n> = readonly [\n  get: CapabilityGetter<TValue>,\n  provide: CapabilityProvider<TValue>,\n] & {\n  readonly capabilityName: TName\n  /** @internal Presence check for the post-setup assertion. */\n  has: (ctx: CapabilityContext) => boolean\n}\n\n/**\n * A capability handle with permissive value/name — for use as a constraint in\n * `requires`/`provides` arrays. Concentrates `any` in one named alias (same\n * convention as `AnyTextAdapter`/`AnyTool`); needed so `Capability<SpecificT>`\n * is assignable to the handle-array element type.\n */\nexport type CapabilityHandle = Capability<any, string>\n\n/**\n * Per-request bookkeeping: which capabilities were provided, plus the\n * duplicate-provide notification. Capability VALUES live in per-capability\n * WeakMaps (see `createCapability`), not here — this only tracks presence.\n */\nexport class CapabilityRegistry {\n  private readonly provided = new Set<CapabilityHandle>()\n  private onDuplicate?: (name: string) => void\n\n  /** Register a callback fired when a handle is provided more than once. */\n  setOnDuplicate(cb: (name: string) => void): void {\n    this.onDuplicate = cb\n  }\n\n  /** Record that `handle` was provided; fire the duplicate callback on repeats. */\n  markProvided(handle: CapabilityHandle): void {\n    if (this.provided.has(handle)) this.onDuplicate?.(handle.capabilityName)\n    this.provided.add(handle)\n  }\n\n  has(handle: CapabilityHandle): boolean {\n    return this.provided.has(handle)\n  }\n}\n\n/**\n * Create a capability. Returns a hybrid handle that destructures to\n * `[get, provide]` and is itself the identity for `requires`/`provides`.\n *\n * Curried so the value type is supplied explicitly while the name literal is\n * INFERRED from the argument: `createCapability<T>()('name')`. (A single call\n * `createCapability<T>('name')` cannot work — supplying `T` explicitly stops\n * TypeScript inferring the name, collapsing it to `string` and defeating the\n * compile-time coverage check that keys on the literal name.)\n *\n * @example Provider + consumer middleware\n * ```ts\n * const counterCapability = createCapability<{ value: number }>()('counter')\n * const [getCounter, provideCounter] = counterCapability\n *\n * const withCounter = defineChatMiddleware({\n *   name: 'counter',\n *   provides: [counterCapability],\n *   setup(ctx) { provideCounter(ctx, { value: 0 }) },\n * })\n *\n * const readsCounter = defineChatMiddleware({\n *   name: 'reads-counter',\n *   requires: [counterCapability],\n *   onChunk(ctx) { getCounter(ctx).value++ },\n * })\n *\n * chat({ adapter, messages, middleware: [withCounter, readsCounter] })\n * ```\n *\n * @remarks Capability `name`s must be unique across your app: compile-time\n * coverage tracking keys on the name literal (runtime keys on reference).\n */\nexport function createCapability<TValue = unknown>(): <\n  const TName extends string,\n>(\n  name: TName,\n) => Capability<TValue, TName> {\n  return <const TName extends string>(\n    name: TName,\n  ): Capability<TValue, TName> => {\n    // Each capability owns a typed WeakMap keyed by the context object. Because\n    // the value type is TValue, reads are typed with no assertion.\n    const values = new WeakMap<CapabilityContext, TValue>()\n\n    function get(ctx: CapabilityContext): TValue\n    function get(\n      ctx: CapabilityContext,\n      opts: { optional: true },\n    ): TValue | undefined\n    function get(\n      ctx: CapabilityContext,\n      opts?: CapabilityGetOptions,\n    ): TValue | undefined {\n      if (!values.has(ctx)) {\n        if (opts?.optional) return undefined\n        throw new Error(\n          `Capability \"${name}\" was requested but never provided. Ensure a ` +\n            `middleware provides it in setup(), ordered before this consumer.`,\n        )\n      }\n      return values.get(ctx)\n    }\n\n    const provide: CapabilityProvider<TValue> = (ctx, value) => {\n      values.set(ctx, value)\n      ctx.capabilities.markProvided(handle)\n    }\n\n    const pair: readonly [\n      CapabilityGetter<TValue>,\n      CapabilityProvider<TValue>,\n    ] = [get, provide]\n    // Object.assign's return type is the intersection of the tuple and the\n    // props, which IS Capability<TValue, TName> — no cast needed.\n    const handle = Object.assign(pair, {\n      capabilityName: name,\n      has: (ctx: CapabilityContext) => values.has(ctx),\n    })\n    return handle\n  }\n}\n"],"names":[],"mappings":"AA4DO,MAAM,mBAAmB;AAAA,EACb,+BAAe,IAAA;AAAA,EACxB;AAAA;AAAA,EAGR,eAAe,IAAkC;AAC/C,SAAK,cAAc;AAAA,EACrB;AAAA;AAAA,EAGA,aAAa,QAAgC;AAC3C,QAAI,KAAK,SAAS,IAAI,MAAM,EAAG,MAAK,cAAc,OAAO,cAAc;AACvE,SAAK,SAAS,IAAI,MAAM;AAAA,EAC1B;AAAA,EAEA,IAAI,QAAmC;AACrC,WAAO,KAAK,SAAS,IAAI,MAAM;AAAA,EACjC;AACF;AAmCO,SAAS,mBAIe;AAC7B,SAAO,CACL,SAC8B;AAG9B,UAAM,6BAAa,QAAA;AAOnB,aAAS,IACP,KACA,MACoB;AACpB,UAAI,CAAC,OAAO,IAAI,GAAG,GAAG;AACpB,YAAI,MAAM,SAAU,QAAO;AAC3B,cAAM,IAAI;AAAA,UACR,eAAe,IAAI;AAAA,QAAA;AAAA,MAGvB;AACA,aAAO,OAAO,IAAI,GAAG;AAAA,IACvB;AAEA,UAAM,UAAsC,CAAC,KAAK,UAAU;AAC1D,aAAO,IAAI,KAAK,KAAK;AACrB,UAAI,aAAa,aAAa,MAAM;AAAA,IACtC;AAEA,UAAM,OAGF,CAAC,KAAK,OAAO;AAGjB,UAAM,SAAS,OAAO,OAAO,MAAM;AAAA,MACjC,gBAAgB;AAAA,MAChB,KAAK,CAAC,QAA2B,OAAO,IAAI,GAAG;AAAA,IAAA,CAChD;AACD,WAAO;AAAA,EACT;AACF;"}

package/dist/esm/activities/chat/middleware/compose.d.ts

@@ -0,0 +1,87 @@
+import { StreamChunk } from '../../../types.js';
+import { InternalLogger } from '../../../logger/internal-logger.js';
+import { AbortInfo, AfterToolCallInfo, BeforeToolCallDecision, ChatMiddleware, ChatMiddlewareConfig, ChatMiddlewareContext, ErrorInfo, FinishInfo, IterationInfo, StructuredOutputMiddlewareConfig, ToolCallHookContext, ToolPhaseCompleteInfo, UsageInfo } from './types.js';
+/**
+ * Internal middleware runner that manages composed execution of middleware hooks.
+ * Created once per chat() invocation.
+ */
+export declare class MiddlewareRunner<TContext = unknown> {
+    private readonly middlewares;
+    private readonly logger;
+    constructor(middlewares: ReadonlyArray<ChatMiddleware<TContext>>, logger: InternalLogger);
+    get hasMiddleware(): boolean;
+    /**
+     * Pipe config through all middleware onConfig hooks in order.
+     * Each middleware receives the merged config from previous middleware.
+     * Partial returns are shallow-merged with the current config.
+     */
+    runOnConfig(ctx: ChatMiddlewareContext<TContext>, config: ChatMiddlewareConfig): Promise<ChatMiddlewareConfig>;
+    /**
+     * Pipe config through all middleware onStructuredOutputConfig hooks in order.
+     * Each middleware receives the merged config from previous middleware.
+     * Partial returns are shallow-merged with the current config.
+     *
+     * Called once at the structured-output boundary, before runOnConfig at the
+     * same boundary (which receives a ChatMiddlewareConfig view, no outputSchema).
+     */
+    runOnStructuredOutputConfig(ctx: ChatMiddlewareContext<TContext>, config: StructuredOutputMiddlewareConfig): Promise<StructuredOutputMiddlewareConfig>;
+    /**
+     * Run all `setup` hooks in array order, then assert every declared `provides`
+     * capability was actually provided. Wires the last-wins duplicate-provide
+     * warning into the registry. Runs before init `onConfig`.
+     *
+     * Takes the full `ChatMiddlewareContext` — the same stable context the engine
+     * threads through every other hook — because it both forwards `ctx` to each
+     * `setup` hook and emits instrumentation events from it.
+     */
+    runSetup(ctx: ChatMiddlewareContext<TContext>): Promise<void>;
+    /**
+     * Call onStart on all middleware in order.
+     */
+    runOnStart(ctx: ChatMiddlewareContext<TContext>): Promise<void>;
+    /**
+     * Pipe a single chunk through all middleware onChunk hooks in order.
+     * Returns the resulting chunks (0..N) to yield to the consumer.
+     *
+     * - void: pass through unchanged
+     * - chunk: replace with this chunk
+     * - chunk[]: expand to multiple chunks
+     * - null: drop the chunk entirely
+     */
+    runOnChunk(ctx: ChatMiddlewareContext<TContext>, chunk: StreamChunk): Promise<Array<StreamChunk>>;
+    /**
+     * Run onBeforeToolCall through middleware in order.
+     * Returns the first non-void decision, or undefined to continue normally.
+     */
+    runOnBeforeToolCall(ctx: ChatMiddlewareContext<TContext>, hookCtx: ToolCallHookContext): Promise<BeforeToolCallDecision>;
+    /**
+     * Run onAfterToolCall on all middleware in order.
+     */
+    runOnAfterToolCall(ctx: ChatMiddlewareContext<TContext>, info: AfterToolCallInfo): Promise<void>;
+    /**
+     * Run onUsage on all middleware in order.
+     */
+    runOnUsage(ctx: ChatMiddlewareContext<TContext>, usage: UsageInfo): Promise<void>;
+    /**
+     * Run onFinish on all middleware in order.
+     */
+    runOnFinish(ctx: ChatMiddlewareContext<TContext>, info: FinishInfo): Promise<void>;
+    /**
+     * Run onAbort on all middleware in order.
+     */
+    runOnAbort(ctx: ChatMiddlewareContext<TContext>, info: AbortInfo): Promise<void>;
+    /**
+     * Run onError on all middleware in order.
+     */
+    runOnError(ctx: ChatMiddlewareContext<TContext>, info: ErrorInfo): Promise<void>;
+    /**
+     * Run onIteration on all middleware in order.
+     * Called at the start of each agent loop iteration.
+     */
+    runOnIteration(ctx: ChatMiddlewareContext<TContext>, info: IterationInfo): Promise<void>;
+    /**
+     * Run onToolPhaseComplete on all middleware in order.
+     * Called after all tool calls in an iteration have been processed.
+     */
+    runOnToolPhaseComplete(ctx: ChatMiddlewareContext<TContext>, info: ToolPhaseCompleteInfo): Promise<void>;
+}

package/dist/esm/activities/chat/middleware/compose.js

@@ -0,0 +1,510 @@
+import { aiEventClient } from "@tanstack/ai-event-client";
+function shouldSkipInstrumentation(mw) {
+  return mw.name === "devtools" || mw.name === "strip-to-spec";
+}
+function instrumentCtx(ctx) {
+  return {
+    requestId: ctx.requestId,
+    streamId: ctx.streamId,
+    clientId: ctx.threadId,
+    timestamp: Date.now()
+  };
+}
+class MiddlewareRunner {
+  middlewares;
+  logger;
+  constructor(middlewares, logger) {
+    this.middlewares = middlewares;
+    this.logger = logger;
+  }
+  get hasMiddleware() {
+    return this.middlewares.length > 0;
+  }
+  /**
+   * Pipe config through all middleware onConfig hooks in order.
+   * Each middleware receives the merged config from previous middleware.
+   * Partial returns are shallow-merged with the current config.
+   */
+  async runOnConfig(ctx, config) {
+    let current = config;
+    for (const mw of this.middlewares) {
+      if (mw.onConfig) {
+        const skip = shouldSkipInstrumentation(mw);
+        const start = Date.now();
+        const result = await mw.onConfig(ctx, current);
+        const hasTransform = result !== void 0 && result !== null;
+        if (hasTransform) {
+          current = { ...current, ...result };
+          if (!skip) {
+            this.logger.config(
+              `middleware=${mw.name ?? "unnamed"} keys=${Object.keys(result).join(",")}`,
+              {
+                middleware: mw.name ?? "unnamed",
+                changes: result
+              }
+            );
+          }
+        }
+        if (!skip) {
+          const base = instrumentCtx(ctx);
+          aiEventClient.emit("middleware:hook:executed", {
+            ...base,
+            middlewareName: mw.name || "unnamed",
+            hookName: "onConfig",
+            iteration: ctx.iteration,
+            duration: Date.now() - start,
+            hasTransform
+          });
+          if (hasTransform) {
+            aiEventClient.emit("middleware:config:transformed", {
+              ...base,
+              middlewareName: mw.name || "unnamed",
+              iteration: ctx.iteration,
+              changes: result
+            });
+          }
+        }
+      }
+    }
+    return current;
+  }
+  /**
+   * Pipe config through all middleware onStructuredOutputConfig hooks in order.
+   * Each middleware receives the merged config from previous middleware.
+   * Partial returns are shallow-merged with the current config.
+   *
+   * Called once at the structured-output boundary, before runOnConfig at the
+   * same boundary (which receives a ChatMiddlewareConfig view, no outputSchema).
+   */
+  async runOnStructuredOutputConfig(ctx, config) {
+    let current = config;
+    for (const mw of this.middlewares) {
+      if (mw.onStructuredOutputConfig) {
+        const skip = shouldSkipInstrumentation(mw);
+        const start = Date.now();
+        const result = await mw.onStructuredOutputConfig(ctx, current);
+        const hasTransform = result !== void 0 && result !== null;
+        if (hasTransform) {
+          current = { ...current, ...result };
+          if (!skip) {
+            this.logger.config(
+              `middleware=${mw.name ?? "unnamed"} keys=${Object.keys(result).join(",")}`,
+              {
+                middleware: mw.name ?? "unnamed",
+                changes: result
+              }
+            );
+          }
+        }
+        if (!skip) {
+          const base = instrumentCtx(ctx);
+          aiEventClient.emit("middleware:hook:executed", {
+            ...base,
+            middlewareName: mw.name || "unnamed",
+            hookName: "onStructuredOutputConfig",
+            iteration: ctx.iteration,
+            duration: Date.now() - start,
+            hasTransform
+          });
+          if (hasTransform) {
+            aiEventClient.emit("middleware:config:transformed", {
+              ...base,
+              middlewareName: mw.name || "unnamed",
+              iteration: ctx.iteration,
+              // `result` is `Partial<StructuredOutputMiddlewareConfig>` —
+              // Object.fromEntries(Object.entries(result)) yields the
+              // structural `Record<string, unknown>` the event emitter wants
+              // without an `as` cast.
+              changes: Object.fromEntries(Object.entries(result))
+            });
+          }
+        }
+      }
+    }
+    return current;
+  }
+  /**
+   * Run all `setup` hooks in array order, then assert every declared `provides`
+   * capability was actually provided. Wires the last-wins duplicate-provide
+   * warning into the registry. Runs before init `onConfig`.
+   *
+   * Takes the full `ChatMiddlewareContext` — the same stable context the engine
+   * threads through every other hook — because it both forwards `ctx` to each
+   * `setup` hook and emits instrumentation events from it.
+   */
+  async runSetup(ctx) {
+    ctx.capabilities.setOnDuplicate((name) => {
+      this.logger.warn(
+        `capability "${name}" was provided more than once; last provider wins`,
+        { capability: name }
+      );
+    });
+    for (const mw of this.middlewares) {
+      if (mw.setup) {
+        const skip = shouldSkipInstrumentation(mw);
+        const start = Date.now();
+        await mw.setup(ctx);
+        if (!skip) {
+          this.logger.middleware(
+            `hook=setup middleware=${mw.name ?? "unnamed"}`,
+            { middleware: mw.name ?? "unnamed", hook: "setup" }
+          );
+          aiEventClient.emit("middleware:hook:executed", {
+            ...instrumentCtx(ctx),
+            middlewareName: mw.name || "unnamed",
+            hookName: "setup",
+            iteration: ctx.iteration,
+            duration: Date.now() - start,
+            hasTransform: false
+          });
+        }
+      }
+    }
+    for (const mw of this.middlewares) {
+      for (const handle of mw.provides ?? []) {
+        if (!ctx.capabilities.has(handle)) {
+          throw new Error(
+            `Middleware "${mw.name ?? "unnamed"}" declares it provides "${handle.capabilityName}" but never called provide() in setup().`
+          );
+        }
+      }
+    }
+  }
+  /**
+   * Call onStart on all middleware in order.
+   */
+  async runOnStart(ctx) {
+    for (const mw of this.middlewares) {
+      if (mw.onStart) {
+        const skip = shouldSkipInstrumentation(mw);
+        const start = Date.now();
+        await mw.onStart(ctx);
+        if (!skip) {
+          this.logger.middleware(
+            `hook=onStart middleware=${mw.name ?? "unnamed"}`,
+            { middleware: mw.name ?? "unnamed", hook: "onStart" }
+          );
+          aiEventClient.emit("middleware:hook:executed", {
+            ...instrumentCtx(ctx),
+            middlewareName: mw.name || "unnamed",
+            hookName: "onStart",
+            iteration: ctx.iteration,
+            duration: Date.now() - start,
+            hasTransform: false
+          });
+        }
+      }
+    }
+  }
+  /**
+   * Pipe a single chunk through all middleware onChunk hooks in order.
+   * Returns the resulting chunks (0..N) to yield to the consumer.
+   *
+   * - void: pass through unchanged
+   * - chunk: replace with this chunk
+   * - chunk[]: expand to multiple chunks
+   * - null: drop the chunk entirely
+   */
+  async runOnChunk(ctx, chunk) {
+    let chunks = [chunk];
+    for (const mw of this.middlewares) {
+      if (!mw.onChunk) continue;
+      const skip = shouldSkipInstrumentation(mw);
+      const nextChunks = [];
+      for (const c of chunks) {
+        const chunkType = c.type;
+        if (!skip) {
+          this.logger.middleware(
+            `hook=onChunk middleware=${mw.name ?? "unnamed"} in=${chunkType}`,
+            { middleware: mw.name ?? "unnamed", hook: "onChunk", in: c }
+          );
+        }
+        const result = await mw.onChunk(ctx, c);
+        if (result === null) {
+          if (!skip) {
+            this.logger.middleware(
+              `hook=onChunk middleware=${mw.name ?? "unnamed"} in=${chunkType} out=<dropped>`,
+              {
+                middleware: mw.name ?? "unnamed",
+                hook: "onChunk",
+                dropped: true
+              }
+            );
+            aiEventClient.emit("middleware:chunk:transformed", {
+              ...instrumentCtx(ctx),
+              middlewareName: mw.name || "unnamed",
+              originalChunkType: chunkType,
+              resultCount: 0,
+              wasDropped: true
+            });
+          }
+          continue;
+        } else if (result === void 0) {
+          nextChunks.push(c);
+        } else if (Array.isArray(result)) {
+          nextChunks.push(...result);
+          if (!skip) {
+            this.logger.middleware(
+              `hook=onChunk middleware=${mw.name ?? "unnamed"} in=${chunkType} out=[${result.map((r) => r.type).join(",")}]`,
+              {
+                middleware: mw.name ?? "unnamed",
+                hook: "onChunk",
+                in: c,
+                out: result
+              }
+            );
+            aiEventClient.emit("middleware:chunk:transformed", {
+              ...instrumentCtx(ctx),
+              middlewareName: mw.name || "unnamed",
+              originalChunkType: chunkType,
+              resultCount: result.length,
+              wasDropped: false
+            });
+          }
+        } else {
+          nextChunks.push(result);
+          if (!skip) {
+            this.logger.middleware(
+              `hook=onChunk middleware=${mw.name ?? "unnamed"} in=${chunkType} out=${result.type}`,
+              {
+                middleware: mw.name ?? "unnamed",
+                hook: "onChunk",
+                in: c,
+                out: result
+              }
+            );
+            aiEventClient.emit("middleware:chunk:transformed", {
+              ...instrumentCtx(ctx),
+              middlewareName: mw.name || "unnamed",
+              originalChunkType: chunkType,
+              resultCount: 1,
+              wasDropped: false
+            });
+          }
+        }
+      }
+      chunks = nextChunks;
+    }
+    return chunks;
+  }
+  /**
+   * Run onBeforeToolCall through middleware in order.
+   * Returns the first non-void decision, or undefined to continue normally.
+   */
+  async runOnBeforeToolCall(ctx, hookCtx) {
+    for (const mw of this.middlewares) {
+      if (mw.onBeforeToolCall) {
+        const skip = shouldSkipInstrumentation(mw);
+        const start = Date.now();
+        const decision = await mw.onBeforeToolCall(ctx, hookCtx);
+        const hasTransform = decision !== void 0 && decision !== null;
+        if (!skip) {
+          this.logger.middleware(
+            `hook=onBeforeToolCall middleware=${mw.name ?? "unnamed"}`,
+            { middleware: mw.name ?? "unnamed", hook: "onBeforeToolCall" }
+          );
+          aiEventClient.emit("middleware:hook:executed", {
+            ...instrumentCtx(ctx),
+            middlewareName: mw.name || "unnamed",
+            hookName: "onBeforeToolCall",
+            iteration: ctx.iteration,
+            duration: Date.now() - start,
+            hasTransform
+          });
+        }
+        if (hasTransform) {
+          return decision;
+        }
+      }
+    }
+    return void 0;
+  }
+  /**
+   * Run onAfterToolCall on all middleware in order.
+   */
+  async runOnAfterToolCall(ctx, info) {
+    for (const mw of this.middlewares) {
+      if (mw.onAfterToolCall) {
+        const skip = shouldSkipInstrumentation(mw);
+        const start = Date.now();
+        await mw.onAfterToolCall(ctx, info);
+        if (!skip) {
+          this.logger.middleware(
+            `hook=onAfterToolCall middleware=${mw.name ?? "unnamed"}`,
+            { middleware: mw.name ?? "unnamed", hook: "onAfterToolCall" }
+          );
+          aiEventClient.emit("middleware:hook:executed", {
+            ...instrumentCtx(ctx),
+            middlewareName: mw.name || "unnamed",
+            hookName: "onAfterToolCall",
+            iteration: ctx.iteration,
+            duration: Date.now() - start,
+            hasTransform: false
+          });
+        }
+      }
+    }
+  }
+  /**
+   * Run onUsage on all middleware in order.
+   */
+  async runOnUsage(ctx, usage) {
+    for (const mw of this.middlewares) {
+      if (mw.onUsage) {
+        const skip = shouldSkipInstrumentation(mw);
+        const start = Date.now();
+        await mw.onUsage(ctx, usage);
+        if (!skip) {
+          this.logger.middleware(
+            `hook=onUsage middleware=${mw.name ?? "unnamed"}`,
+            { middleware: mw.name ?? "unnamed", hook: "onUsage" }
+          );
+          aiEventClient.emit("middleware:hook:executed", {
+            ...instrumentCtx(ctx),
+            middlewareName: mw.name || "unnamed",
+            hookName: "onUsage",
+            iteration: ctx.iteration,
+            duration: Date.now() - start,
+            hasTransform: false
+          });
+        }
+      }
+    }
+  }
+  /**
+   * Run onFinish on all middleware in order.
+   */
+  async runOnFinish(ctx, info) {
+    for (const mw of this.middlewares) {
+      if (mw.onFinish) {
+        const skip = shouldSkipInstrumentation(mw);
+        const start = Date.now();
+        await mw.onFinish(ctx, info);
+        if (!skip) {
+          this.logger.middleware(
+            `hook=onFinish middleware=${mw.name ?? "unnamed"}`,
+            { middleware: mw.name ?? "unnamed", hook: "onFinish" }
+          );
+          aiEventClient.emit("middleware:hook:executed", {
+            ...instrumentCtx(ctx),
+            middlewareName: mw.name || "unnamed",
+            hookName: "onFinish",
+            iteration: ctx.iteration,
+            duration: Date.now() - start,
+            hasTransform: false
+          });
+        }
+      }
+    }
+  }
+  /**
+   * Run onAbort on all middleware in order.
+   */
+  async runOnAbort(ctx, info) {
+    for (const mw of this.middlewares) {
+      if (mw.onAbort) {
+        const skip = shouldSkipInstrumentation(mw);
+        const start = Date.now();
+        await mw.onAbort(ctx, info);
+        if (!skip) {
+          this.logger.middleware(
+            `hook=onAbort middleware=${mw.name ?? "unnamed"}`,
+            { middleware: mw.name ?? "unnamed", hook: "onAbort" }
+          );
+          aiEventClient.emit("middleware:hook:executed", {
+            ...instrumentCtx(ctx),
+            middlewareName: mw.name || "unnamed",
+            hookName: "onAbort",
+            iteration: ctx.iteration,
+            duration: Date.now() - start,
+            hasTransform: false
+          });
+        }
+      }
+    }
+  }
+  /**
+   * Run onError on all middleware in order.
+   */
+  async runOnError(ctx, info) {
+    for (const mw of this.middlewares) {
+      if (mw.onError) {
+        const skip = shouldSkipInstrumentation(mw);
+        const start = Date.now();
+        await mw.onError(ctx, info);
+        if (!skip) {
+          this.logger.middleware(
+            `hook=onError middleware=${mw.name ?? "unnamed"}`,
+            { middleware: mw.name ?? "unnamed", hook: "onError" }
+          );
+          aiEventClient.emit("middleware:hook:executed", {
+            ...instrumentCtx(ctx),
+            middlewareName: mw.name || "unnamed",
+            hookName: "onError",
+            iteration: ctx.iteration,
+            duration: Date.now() - start,
+            hasTransform: false
+          });
+        }
+      }
+    }
+  }
+  /**
+   * Run onIteration on all middleware in order.
+   * Called at the start of each agent loop iteration.
+   */
+  async runOnIteration(ctx, info) {
+    for (const mw of this.middlewares) {
+      if (mw.onIteration) {
+        const skip = shouldSkipInstrumentation(mw);
+        const start = Date.now();
+        await mw.onIteration(ctx, info);
+        if (!skip) {
+          this.logger.middleware(
+            `hook=onIteration middleware=${mw.name ?? "unnamed"}`,
+            { middleware: mw.name ?? "unnamed", hook: "onIteration" }
+          );
+          aiEventClient.emit("middleware:hook:executed", {
+            ...instrumentCtx(ctx),
+            middlewareName: mw.name || "unnamed",
+            hookName: "onIteration",
+            iteration: ctx.iteration,
+            duration: Date.now() - start,
+            hasTransform: false
+          });
+        }
+      }
+    }
+  }
+  /**
+   * Run onToolPhaseComplete on all middleware in order.
+   * Called after all tool calls in an iteration have been processed.
+   */
+  async runOnToolPhaseComplete(ctx, info) {
+    for (const mw of this.middlewares) {
+      if (mw.onToolPhaseComplete) {
+        const skip = shouldSkipInstrumentation(mw);
+        const start = Date.now();
+        await mw.onToolPhaseComplete(ctx, info);
+        if (!skip) {
+          this.logger.middleware(
+            `hook=onToolPhaseComplete middleware=${mw.name ?? "unnamed"}`,
+            { middleware: mw.name ?? "unnamed", hook: "onToolPhaseComplete" }
+          );
+          aiEventClient.emit("middleware:hook:executed", {
+            ...instrumentCtx(ctx),
+            middlewareName: mw.name || "unnamed",
+            hookName: "onToolPhaseComplete",
+            iteration: ctx.iteration,
+            duration: Date.now() - start,
+            hasTransform: false
+          });
+        }
+      }
+    }
+  }
+}
+export {
+  MiddlewareRunner
+};
+//# sourceMappingURL=compose.js.map

package/dist/esm/activities/chat/middleware/compose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.js","sources":["../../../../../src/activities/chat/middleware/compose.ts"],"sourcesContent":["import { aiEventClient } from '@tanstack/ai-event-client'\nimport type { StreamChunk } from '../../../types'\nimport type { InternalLogger } from '../../../logger/internal-logger'\nimport type {\n  AbortInfo,\n  AfterToolCallInfo,\n  BeforeToolCallDecision,\n  ChatMiddleware,\n  ChatMiddlewareConfig,\n  ChatMiddlewareContext,\n  ErrorInfo,\n  FinishInfo,\n  IterationInfo,\n  StructuredOutputMiddlewareConfig,\n  ToolCallHookContext,\n  ToolPhaseCompleteInfo,\n  UsageInfo,\n} from './types'\n\n/** Check if a middleware should be skipped for instrumentation events. */\nfunction shouldSkipInstrumentation(mw: ChatMiddleware<any>): boolean {\n  return mw.name === 'devtools' || mw.name === 'strip-to-spec'\n}\n\n/** Build the base context for middleware instrumentation events. */\nfunction instrumentCtx(ctx: ChatMiddlewareContext<any>) {\n  return {\n    requestId: ctx.requestId,\n    streamId: ctx.streamId,\n    clientId: ctx.threadId,\n    timestamp: Date.now(),\n  }\n}\n\n/**\n * Internal middleware runner that manages composed execution of middleware hooks.\n * Created once per chat() invocation.\n */\nexport class MiddlewareRunner<TContext = unknown> {\n  private readonly middlewares: ReadonlyArray<ChatMiddleware<TContext>>\n  private readonly logger: InternalLogger\n\n  constructor(\n    middlewares: ReadonlyArray<ChatMiddleware<TContext>>,\n    logger: InternalLogger,\n  ) {\n    this.middlewares = middlewares\n    this.logger = logger\n  }\n\n  get hasMiddleware(): boolean {\n    return this.middlewares.length > 0\n  }\n\n  /**\n   * Pipe config through all middleware onConfig hooks in order.\n   * Each middleware receives the merged config from previous middleware.\n   * Partial returns are shallow-merged with the current config.\n   */\n  async runOnConfig(\n    ctx: ChatMiddlewareContext<TContext>,\n    config: ChatMiddlewareConfig,\n  ): Promise<ChatMiddlewareConfig> {\n    let current = config\n    for (const mw of this.middlewares) {\n      if (mw.onConfig) {\n        const skip = shouldSkipInstrumentation(mw)\n        const start = Date.now()\n        const result = await mw.onConfig(ctx, current)\n        const hasTransform = result !== undefined && result !== null\n        if (hasTransform) {\n          current = { ...current, ...result }\n          if (!skip) {\n            this.logger.config(\n              `middleware=${mw.name ?? 'unnamed'} keys=${Object.keys(result).join(',')}`,\n              {\n                middleware: mw.name ?? 'unnamed',\n                changes: result,\n              },\n            )\n          }\n        }\n        if (!skip) {\n          const base = instrumentCtx(ctx)\n          aiEventClient.emit('middleware:hook:executed', {\n            ...base,\n            middlewareName: mw.name || 'unnamed',\n            hookName: 'onConfig',\n            iteration: ctx.iteration,\n            duration: Date.now() - start,\n            hasTransform,\n          })\n          if (hasTransform) {\n            aiEventClient.emit('middleware:config:transformed', {\n              ...base,\n              middlewareName: mw.name || 'unnamed',\n              iteration: ctx.iteration,\n              changes: result,\n            })\n          }\n        }\n      }\n    }\n    return current\n  }\n\n  /**\n   * Pipe config through all middleware onStructuredOutputConfig hooks in order.\n   * Each middleware receives the merged config from previous middleware.\n   * Partial returns are shallow-merged with the current config.\n   *\n   * Called once at the structured-output boundary, before runOnConfig at the\n   * same boundary (which receives a ChatMiddlewareConfig view, no outputSchema).\n   */\n  async runOnStructuredOutputConfig(\n    ctx: ChatMiddlewareContext<TContext>,\n    config: StructuredOutputMiddlewareConfig,\n  ): Promise<StructuredOutputMiddlewareConfig> {\n    let current = config\n    for (const mw of this.middlewares) {\n      if (mw.onStructuredOutputConfig) {\n        const skip = shouldSkipInstrumentation(mw)\n        const start = Date.now()\n        const result = await mw.onStructuredOutputConfig(ctx, current)\n        const hasTransform = result !== undefined && result !== null\n        if (hasTransform) {\n          current = { ...current, ...result }\n          if (!skip) {\n            this.logger.config(\n              `middleware=${mw.name ?? 'unnamed'} keys=${Object.keys(result).join(',')}`,\n              {\n                middleware: mw.name ?? 'unnamed',\n                changes: result,\n              },\n            )\n          }\n        }\n        if (!skip) {\n          const base = instrumentCtx(ctx)\n          aiEventClient.emit('middleware:hook:executed', {\n            ...base,\n            middlewareName: mw.name || 'unnamed',\n            hookName: 'onStructuredOutputConfig',\n            iteration: ctx.iteration,\n            duration: Date.now() - start,\n            hasTransform,\n          })\n          if (hasTransform) {\n            aiEventClient.emit('middleware:config:transformed', {\n              ...base,\n              middlewareName: mw.name || 'unnamed',\n              iteration: ctx.iteration,\n              // `result` is `Partial<StructuredOutputMiddlewareConfig>` —\n              // Object.fromEntries(Object.entries(result)) yields the\n              // structural `Record<string, unknown>` the event emitter wants\n              // without an `as` cast.\n              changes: Object.fromEntries(Object.entries(result)),\n            })\n          }\n        }\n      }\n    }\n    return current\n  }\n\n  /**\n   * Run all `setup` hooks in array order, then assert every declared `provides`\n   * capability was actually provided. Wires the last-wins duplicate-provide\n   * warning into the registry. Runs before init `onConfig`.\n   *\n   * Takes the full `ChatMiddlewareContext` — the same stable context the engine\n   * threads through every other hook — because it both forwards `ctx` to each\n   * `setup` hook and emits instrumentation events from it.\n   */\n  async runSetup(ctx: ChatMiddlewareContext<TContext>): Promise<void> {\n    ctx.capabilities.setOnDuplicate((name) => {\n      this.logger.warn(\n        `capability \"${name}\" was provided more than once; last provider wins`,\n        { capability: name },\n      )\n    })\n\n    for (const mw of this.middlewares) {\n      if (mw.setup) {\n        const skip = shouldSkipInstrumentation(mw)\n        const start = Date.now()\n        await mw.setup(ctx)\n        if (!skip) {\n          this.logger.middleware(\n            `hook=setup middleware=${mw.name ?? 'unnamed'}`,\n            { middleware: mw.name ?? 'unnamed', hook: 'setup' },\n          )\n          aiEventClient.emit('middleware:hook:executed', {\n            ...instrumentCtx(ctx),\n            middlewareName: mw.name || 'unnamed',\n            hookName: 'setup',\n            iteration: ctx.iteration,\n            duration: Date.now() - start,\n            hasTransform: false,\n          })\n        }\n      }\n    }\n\n    for (const mw of this.middlewares) {\n      for (const handle of mw.provides ?? []) {\n        if (!ctx.capabilities.has(handle)) {\n          throw new Error(\n            `Middleware \"${mw.name ?? 'unnamed'}\" declares it provides ` +\n              `\"${handle.capabilityName}\" but never called provide() in setup().`,\n          )\n        }\n      }\n    }\n  }\n\n  /**\n   * Call onStart on all middleware in order.\n   */\n  async runOnStart(ctx: ChatMiddlewareContext<TContext>): Promise<void> {\n    for (const mw of this.middlewares) {\n      if (mw.onStart) {\n        const skip = shouldSkipInstrumentation(mw)\n        const start = Date.now()\n        await mw.onStart(ctx)\n        if (!skip) {\n          this.logger.middleware(\n            `hook=onStart middleware=${mw.name ?? 'unnamed'}`,\n            { middleware: mw.name ?? 'unnamed', hook: 'onStart' },\n          )\n          aiEventClient.emit('middleware:hook:executed', {\n            ...instrumentCtx(ctx),\n            middlewareName: mw.name || 'unnamed',\n            hookName: 'onStart',\n            iteration: ctx.iteration,\n            duration: Date.now() - start,\n            hasTransform: false,\n          })\n        }\n      }\n    }\n  }\n\n  /**\n   * Pipe a single chunk through all middleware onChunk hooks in order.\n   * Returns the resulting chunks (0..N) to yield to the consumer.\n   *\n   * - void: pass through unchanged\n   * - chunk: replace with this chunk\n   * - chunk[]: expand to multiple chunks\n   * - null: drop the chunk entirely\n   */\n  async runOnChunk(\n    ctx: ChatMiddlewareContext<TContext>,\n    chunk: StreamChunk,\n  ): Promise<Array<StreamChunk>> {\n    let chunks: Array<StreamChunk> = [chunk]\n\n    for (const mw of this.middlewares) {\n      if (!mw.onChunk) continue\n      const skip = shouldSkipInstrumentation(mw)\n\n      const nextChunks: Array<StreamChunk> = []\n      for (const c of chunks) {\n        // Cast: @ag-ui/core Zod passthrough types prevent direct `.type` access\n        const chunkType = c.type\n        if (!skip) {\n          this.logger.middleware(\n            `hook=onChunk middleware=${mw.name ?? 'unnamed'} in=${chunkType}`,\n            { middleware: mw.name ?? 'unnamed', hook: 'onChunk', in: c },\n          )\n        }\n        const result = await mw.onChunk(ctx, c)\n        if (result === null) {\n          // Drop this chunk\n          if (!skip) {\n            this.logger.middleware(\n              `hook=onChunk middleware=${mw.name ?? 'unnamed'} in=${chunkType} out=<dropped>`,\n              {\n                middleware: mw.name ?? 'unnamed',\n                hook: 'onChunk',\n                dropped: true,\n              },\n            )\n            aiEventClient.emit('middleware:chunk:transformed', {\n              ...instrumentCtx(ctx),\n              middlewareName: mw.name || 'unnamed',\n              originalChunkType: chunkType,\n              resultCount: 0,\n              wasDropped: true,\n            })\n          }\n          continue\n        } else if (result === undefined) {\n          // Pass through — no instrumentation for pass-throughs\n          nextChunks.push(c)\n        } else if (Array.isArray(result)) {\n          // Expand\n          nextChunks.push(...result)\n          if (!skip) {\n            this.logger.middleware(\n              `hook=onChunk middleware=${mw.name ?? 'unnamed'} in=${chunkType} out=[${result.map((r: StreamChunk) => r.type).join(',')}]`,\n              {\n                middleware: mw.name ?? 'unnamed',\n                hook: 'onChunk',\n                in: c,\n                out: result,\n              },\n            )\n            aiEventClient.emit('middleware:chunk:transformed', {\n              ...instrumentCtx(ctx),\n              middlewareName: mw.name || 'unnamed',\n              originalChunkType: chunkType,\n              resultCount: result.length,\n              wasDropped: false,\n            })\n          }\n        } else {\n          // Replace\n          nextChunks.push(result)\n          if (!skip) {\n            this.logger.middleware(\n              `hook=onChunk middleware=${mw.name ?? 'unnamed'} in=${chunkType} out=${result.type}`,\n              {\n                middleware: mw.name ?? 'unnamed',\n                hook: 'onChunk',\n                in: c,\n                out: result,\n              },\n            )\n            aiEventClient.emit('middleware:chunk:transformed', {\n              ...instrumentCtx(ctx),\n              middlewareName: mw.name || 'unnamed',\n              originalChunkType: chunkType,\n              resultCount: 1,\n              wasDropped: false,\n            })\n          }\n        }\n      }\n      chunks = nextChunks\n    }\n\n    return chunks\n  }\n\n  /**\n   * Run onBeforeToolCall through middleware in order.\n   * Returns the first non-void decision, or undefined to continue normally.\n   */\n  async runOnBeforeToolCall(\n    ctx: ChatMiddlewareContext<TContext>,\n    hookCtx: ToolCallHookContext,\n  ): Promise<BeforeToolCallDecision> {\n    for (const mw of this.middlewares) {\n      if (mw.onBeforeToolCall) {\n        const skip = shouldSkipInstrumentation(mw)\n        const start = Date.now()\n        const decision = await mw.onBeforeToolCall(ctx, hookCtx)\n        const hasTransform = decision !== undefined && decision !== null\n        if (!skip) {\n          this.logger.middleware(\n            `hook=onBeforeToolCall middleware=${mw.name ?? 'unnamed'}`,\n            { middleware: mw.name ?? 'unnamed', hook: 'onBeforeToolCall' },\n          )\n          aiEventClient.emit('middleware:hook:executed', {\n            ...instrumentCtx(ctx),\n            middlewareName: mw.name || 'unnamed',\n            hookName: 'onBeforeToolCall',\n            iteration: ctx.iteration,\n            duration: Date.now() - start,\n            hasTransform,\n          })\n        }\n        if (hasTransform) {\n          return decision\n        }\n      }\n    }\n    return undefined\n  }\n\n  /**\n   * Run onAfterToolCall on all middleware in order.\n   */\n  async runOnAfterToolCall(\n    ctx: ChatMiddlewareContext<TContext>,\n    info: AfterToolCallInfo,\n  ): Promise<void> {\n    for (const mw of this.middlewares) {\n      if (mw.onAfterToolCall) {\n        const skip = shouldSkipInstrumentation(mw)\n        const start = Date.now()\n        await mw.onAfterToolCall(ctx, info)\n        if (!skip) {\n          this.logger.middleware(\n            `hook=onAfterToolCall middleware=${mw.name ?? 'unnamed'}`,\n            { middleware: mw.name ?? 'unnamed', hook: 'onAfterToolCall' },\n          )\n          aiEventClient.emit('middleware:hook:executed', {\n            ...instrumentCtx(ctx),\n            middlewareName: mw.name || 'unnamed',\n            hookName: 'onAfterToolCall',\n            iteration: ctx.iteration,\n            duration: Date.now() - start,\n            hasTransform: false,\n          })\n        }\n      }\n    }\n  }\n\n  /**\n   * Run onUsage on all middleware in order.\n   */\n  async runOnUsage(\n    ctx: ChatMiddlewareContext<TContext>,\n    usage: UsageInfo,\n  ): Promise<void> {\n    for (const mw of this.middlewares) {\n      if (mw.onUsage) {\n        const skip = shouldSkipInstrumentation(mw)\n        const start = Date.now()\n        await mw.onUsage(ctx, usage)\n        if (!skip) {\n          this.logger.middleware(\n            `hook=onUsage middleware=${mw.name ?? 'unnamed'}`,\n            { middleware: mw.name ?? 'unnamed', hook: 'onUsage' },\n          )\n          aiEventClient.emit('middleware:hook:executed', {\n            ...instrumentCtx(ctx),\n            middlewareName: mw.name || 'unnamed',\n            hookName: 'onUsage',\n            iteration: ctx.iteration,\n            duration: Date.now() - start,\n            hasTransform: false,\n          })\n        }\n      }\n    }\n  }\n\n  /**\n   * Run onFinish on all middleware in order.\n   */\n  async runOnFinish(\n    ctx: ChatMiddlewareContext<TContext>,\n    info: FinishInfo,\n  ): Promise<void> {\n    for (const mw of this.middlewares) {\n      if (mw.onFinish) {\n        const skip = shouldSkipInstrumentation(mw)\n        const start = Date.now()\n        await mw.onFinish(ctx, info)\n        if (!skip) {\n          this.logger.middleware(\n            `hook=onFinish middleware=${mw.name ?? 'unnamed'}`,\n            { middleware: mw.name ?? 'unnamed', hook: 'onFinish' },\n          )\n          aiEventClient.emit('middleware:hook:executed', {\n            ...instrumentCtx(ctx),\n            middlewareName: mw.name || 'unnamed',\n            hookName: 'onFinish',\n            iteration: ctx.iteration,\n            duration: Date.now() - start,\n            hasTransform: false,\n          })\n        }\n      }\n    }\n  }\n\n  /**\n   * Run onAbort on all middleware in order.\n   */\n  async runOnAbort(\n    ctx: ChatMiddlewareContext<TContext>,\n    info: AbortInfo,\n  ): Promise<void> {\n    for (const mw of this.middlewares) {\n      if (mw.onAbort) {\n        const skip = shouldSkipInstrumentation(mw)\n        const start = Date.now()\n        await mw.onAbort(ctx, info)\n        if (!skip) {\n          this.logger.middleware(\n            `hook=onAbort middleware=${mw.name ?? 'unnamed'}`,\n            { middleware: mw.name ?? 'unnamed', hook: 'onAbort' },\n          )\n          aiEventClient.emit('middleware:hook:executed', {\n            ...instrumentCtx(ctx),\n            middlewareName: mw.name || 'unnamed',\n            hookName: 'onAbort',\n            iteration: ctx.iteration,\n            duration: Date.now() - start,\n            hasTransform: false,\n          })\n        }\n      }\n    }\n  }\n\n  /**\n   * Run onError on all middleware in order.\n   */\n  async runOnError(\n    ctx: ChatMiddlewareContext<TContext>,\n    info: ErrorInfo,\n  ): Promise<void> {\n    for (const mw of this.middlewares) {\n      if (mw.onError) {\n        const skip = shouldSkipInstrumentation(mw)\n        const start = Date.now()\n        await mw.onError(ctx, info)\n        if (!skip) {\n          this.logger.middleware(\n            `hook=onError middleware=${mw.name ?? 'unnamed'}`,\n            { middleware: mw.name ?? 'unnamed', hook: 'onError' },\n          )\n          aiEventClient.emit('middleware:hook:executed', {\n            ...instrumentCtx(ctx),\n            middlewareName: mw.name || 'unnamed',\n            hookName: 'onError',\n            iteration: ctx.iteration,\n            duration: Date.now() - start,\n            hasTransform: false,\n          })\n        }\n      }\n    }\n  }\n\n  /**\n   * Run onIteration on all middleware in order.\n   * Called at the start of each agent loop iteration.\n   */\n  async runOnIteration(\n    ctx: ChatMiddlewareContext<TContext>,\n    info: IterationInfo,\n  ): Promise<void> {\n    for (const mw of this.middlewares) {\n      if (mw.onIteration) {\n        const skip = shouldSkipInstrumentation(mw)\n        const start = Date.now()\n        await mw.onIteration(ctx, info)\n        if (!skip) {\n          this.logger.middleware(\n            `hook=onIteration middleware=${mw.name ?? 'unnamed'}`,\n            { middleware: mw.name ?? 'unnamed', hook: 'onIteration' },\n          )\n          aiEventClient.emit('middleware:hook:executed', {\n            ...instrumentCtx(ctx),\n            middlewareName: mw.name || 'unnamed',\n            hookName: 'onIteration',\n            iteration: ctx.iteration,\n            duration: Date.now() - start,\n            hasTransform: false,\n          })\n        }\n      }\n    }\n  }\n\n  /**\n   * Run onToolPhaseComplete on all middleware in order.\n   * Called after all tool calls in an iteration have been processed.\n   */\n  async runOnToolPhaseComplete(\n    ctx: ChatMiddlewareContext<TContext>,\n    info: ToolPhaseCompleteInfo,\n  ): Promise<void> {\n    for (const mw of this.middlewares) {\n      if (mw.onToolPhaseComplete) {\n        const skip = shouldSkipInstrumentation(mw)\n        const start = Date.now()\n        await mw.onToolPhaseComplete(ctx, info)\n        if (!skip) {\n          this.logger.middleware(\n            `hook=onToolPhaseComplete middleware=${mw.name ?? 'unnamed'}`,\n            { middleware: mw.name ?? 'unnamed', hook: 'onToolPhaseComplete' },\n          )\n          aiEventClient.emit('middleware:hook:executed', {\n            ...instrumentCtx(ctx),\n            middlewareName: mw.name || 'unnamed',\n            hookName: 'onToolPhaseComplete',\n            iteration: ctx.iteration,\n            duration: Date.now() - start,\n            hasTransform: false,\n          })\n        }\n      }\n    }\n  }\n}\n"],"names":[],"mappings":"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"}