@tanstack/ai 0.36.0 → 0.38.0

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":";AAoBA,SAAS,0BAA0B,IAAkC;AACnE,SAAO,GAAG,SAAS,cAAc,GAAG,SAAS;AAC/C;AAGA,SAAS,cAAc,KAAiC;AACtD,SAAO;AAAA,IACL,WAAW,IAAI;AAAA,IACf,UAAU,IAAI;AAAA,IACd,UAAU,IAAI;AAAA,IACd,WAAW,KAAK,IAAA;AAAA,EAAI;AAExB;AAMO,MAAM,iBAAqC;AAAA,EAC/B;AAAA,EACA;AAAA,EAEjB,YACE,aACA,QACA;AACA,SAAK,cAAc;AACnB,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,IAAI,gBAAyB;AAC3B,WAAO,KAAK,YAAY,SAAS;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,YACJ,KACA,QAC+B;AAC/B,QAAI,UAAU;AACd,eAAW,MAAM,KAAK,aAAa;AACjC,UAAI,GAAG,UAAU;AACf,cAAM,OAAO,0BAA0B,EAAE;AACzC,cAAM,QAAQ,KAAK,IAAA;AACnB,cAAM,SAAS,MAAM,GAAG,SAAS,KAAK,OAAO;AAC7C,cAAM,eAAe,WAAW,UAAa,WAAW;AACxD,YAAI,cAAc;AAChB,oBAAU,EAAE,GAAG,SAAS,GAAG,OAAA;AAC3B,cAAI,CAAC,MAAM;AACT,iBAAK,OAAO;AAAA,cACV,cAAc,GAAG,QAAQ,SAAS,SAAS,OAAO,KAAK,MAAM,EAAE,KAAK,GAAG,CAAC;AAAA,cACxE;AAAA,gBACE,YAAY,GAAG,QAAQ;AAAA,gBACvB,SAAS;AAAA,cAAA;AAAA,YACX;AAAA,UAEJ;AAAA,QACF;AACA,YAAI,CAAC,MAAM;AACT,gBAAM,OAAO,cAAc,GAAG;AAC9B,wBAAc,KAAK,4BAA4B;AAAA,YAC7C,GAAG;AAAA,YACH,gBAAgB,GAAG,QAAQ;AAAA,YAC3B,UAAU;AAAA,YACV,WAAW,IAAI;AAAA,YACf,UAAU,KAAK,IAAA,IAAQ;AAAA,YACvB;AAAA,UAAA,CACD;AACD,cAAI,cAAc;AAChB,0BAAc,KAAK,iCAAiC;AAAA,cAClD,GAAG;AAAA,cACH,gBAAgB,GAAG,QAAQ;AAAA,cAC3B,WAAW,IAAI;AAAA,cACf,SAAS;AAAA,YAAA,CACV;AAAA,UACH;AAAA,QACF;AAAA,MACF;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,4BACJ,KACA,QAC2C;AAC3C,QAAI,UAAU;AACd,eAAW,MAAM,KAAK,aAAa;AACjC,UAAI,GAAG,0BAA0B;AAC/B,cAAM,OAAO,0BAA0B,EAAE;AACzC,cAAM,QAAQ,KAAK,IAAA;AACnB,cAAM,SAAS,MAAM,GAAG,yBAAyB,KAAK,OAAO;AAC7D,cAAM,eAAe,WAAW,UAAa,WAAW;AACxD,YAAI,cAAc;AAChB,oBAAU,EAAE,GAAG,SAAS,GAAG,OAAA;AAC3B,cAAI,CAAC,MAAM;AACT,iBAAK,OAAO;AAAA,cACV,cAAc,GAAG,QAAQ,SAAS,SAAS,OAAO,KAAK,MAAM,EAAE,KAAK,GAAG,CAAC;AAAA,cACxE;AAAA,gBACE,YAAY,GAAG,QAAQ;AAAA,gBACvB,SAAS;AAAA,cAAA;AAAA,YACX;AAAA,UAEJ;AAAA,QACF;AACA,YAAI,CAAC,MAAM;AACT,gBAAM,OAAO,cAAc,GAAG;AAC9B,wBAAc,KAAK,4BAA4B;AAAA,YAC7C,GAAG;AAAA,YACH,gBAAgB,GAAG,QAAQ;AAAA,YAC3B,UAAU;AAAA,YACV,WAAW,IAAI;AAAA,YACf,UAAU,KAAK,IAAA,IAAQ;AAAA,YACvB;AAAA,UAAA,CACD;AACD,cAAI,cAAc;AAChB,0BAAc,KAAK,iCAAiC;AAAA,cAClD,GAAG;AAAA,cACH,gBAAgB,GAAG,QAAQ;AAAA,cAC3B,WAAW,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA,cAKf,SAAS,OAAO,YAAY,OAAO,QAAQ,MAAM,CAAC;AAAA,YAAA,CACnD;AAAA,UACH;AAAA,QACF;AAAA,MACF;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,SAAS,KAAqD;AAClE,QAAI,aAAa,eAAe,CAAC,SAAS;AACxC,WAAK,OAAO;AAAA,QACV,eAAe,IAAI;AAAA,QACnB,EAAE,YAAY,KAAA;AAAA,MAAK;AAAA,IAEvB,CAAC;AAED,eAAW,MAAM,KAAK,aAAa;AACjC,UAAI,GAAG,OAAO;AACZ,cAAM,OAAO,0BAA0B,EAAE;AACzC,cAAM,QAAQ,KAAK,IAAA;AACnB,cAAM,GAAG,MAAM,GAAG;AAClB,YAAI,CAAC,MAAM;AACT,eAAK,OAAO;AAAA,YACV,yBAAyB,GAAG,QAAQ,SAAS;AAAA,YAC7C,EAAE,YAAY,GAAG,QAAQ,WAAW,MAAM,QAAA;AAAA,UAAQ;AAEpD,wBAAc,KAAK,4BAA4B;AAAA,YAC7C,GAAG,cAAc,GAAG;AAAA,YACpB,gBAAgB,GAAG,QAAQ;AAAA,YAC3B,UAAU;AAAA,YACV,WAAW,IAAI;AAAA,YACf,UAAU,KAAK,IAAA,IAAQ;AAAA,YACvB,cAAc;AAAA,UAAA,CACf;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAEA,eAAW,MAAM,KAAK,aAAa;AACjC,iBAAW,UAAU,GAAG,YAAY,CAAA,GAAI;AACtC,YAAI,CAAC,IAAI,aAAa,IAAI,MAAM,GAAG;AACjC,gBAAM,IAAI;AAAA,YACR,eAAe,GAAG,QAAQ,SAAS,2BAC7B,OAAO,cAAc;AAAA,UAAA;AAAA,QAE/B;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,WAAW,KAAqD;AACpE,eAAW,MAAM,KAAK,aAAa;AACjC,UAAI,GAAG,SAAS;AACd,cAAM,OAAO,0BAA0B,EAAE;AACzC,cAAM,QAAQ,KAAK,IAAA;AACnB,cAAM,GAAG,QAAQ,GAAG;AACpB,YAAI,CAAC,MAAM;AACT,eAAK,OAAO;AAAA,YACV,2BAA2B,GAAG,QAAQ,SAAS;AAAA,YAC/C,EAAE,YAAY,GAAG,QAAQ,WAAW,MAAM,UAAA;AAAA,UAAU;AAEtD,wBAAc,KAAK,4BAA4B;AAAA,YAC7C,GAAG,cAAc,GAAG;AAAA,YACpB,gBAAgB,GAAG,QAAQ;AAAA,YAC3B,UAAU;AAAA,YACV,WAAW,IAAI;AAAA,YACf,UAAU,KAAK,IAAA,IAAQ;AAAA,YACvB,cAAc;AAAA,UAAA,CACf;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,WACJ,KACA,OAC6B;AAC7B,QAAI,SAA6B,CAAC,KAAK;AAEvC,eAAW,MAAM,KAAK,aAAa;AACjC,UAAI,CAAC,GAAG,QAAS;AACjB,YAAM,OAAO,0BAA0B,EAAE;AAEzC,YAAM,aAAiC,CAAA;AACvC,iBAAW,KAAK,QAAQ;AAEtB,cAAM,YAAY,EAAE;AACpB,YAAI,CAAC,MAAM;AACT,eAAK,OAAO;AAAA,YACV,2BAA2B,GAAG,QAAQ,SAAS,OAAO,SAAS;AAAA,YAC/D,EAAE,YAAY,GAAG,QAAQ,WAAW,MAAM,WAAW,IAAI,EAAA;AAAA,UAAE;AAAA,QAE/D;AACA,cAAM,SAAS,MAAM,GAAG,QAAQ,KAAK,CAAC;AACtC,YAAI,WAAW,MAAM;AAEnB,cAAI,CAAC,MAAM;AACT,iBAAK,OAAO;AAAA,cACV,2BAA2B,GAAG,QAAQ,SAAS,OAAO,SAAS;AAAA,cAC/D;AAAA,gBACE,YAAY,GAAG,QAAQ;AAAA,gBACvB,MAAM;AAAA,gBACN,SAAS;AAAA,cAAA;AAAA,YACX;AAEF,0BAAc,KAAK,gCAAgC;AAAA,cACjD,GAAG,cAAc,GAAG;AAAA,cACpB,gBAAgB,GAAG,QAAQ;AAAA,cAC3B,mBAAmB;AAAA,cACnB,aAAa;AAAA,cACb,YAAY;AAAA,YAAA,CACb;AAAA,UACH;AACA;AAAA,QACF,WAAW,WAAW,QAAW;AAE/B,qBAAW,KAAK,CAAC;AAAA,QACnB,WAAW,MAAM,QAAQ,MAAM,GAAG;AAEhC,qBAAW,KAAK,GAAG,MAAM;AACzB,cAAI,CAAC,MAAM;AACT,iBAAK,OAAO;AAAA,cACV,2BAA2B,GAAG,QAAQ,SAAS,OAAO,SAAS,SAAS,OAAO,IAAI,CAAC,MAAmB,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC;AAAA,cACxH;AAAA,gBACE,YAAY,GAAG,QAAQ;AAAA,gBACvB,MAAM;AAAA,gBACN,IAAI;AAAA,gBACJ,KAAK;AAAA,cAAA;AAAA,YACP;AAEF,0BAAc,KAAK,gCAAgC;AAAA,cACjD,GAAG,cAAc,GAAG;AAAA,cACpB,gBAAgB,GAAG,QAAQ;AAAA,cAC3B,mBAAmB;AAAA,cACnB,aAAa,OAAO;AAAA,cACpB,YAAY;AAAA,YAAA,CACb;AAAA,UACH;AAAA,QACF,OAAO;AAEL,qBAAW,KAAK,MAAM;AACtB,cAAI,CAAC,MAAM;AACT,iBAAK,OAAO;AAAA,cACV,2BAA2B,GAAG,QAAQ,SAAS,OAAO,SAAS,QAAQ,OAAO,IAAI;AAAA,cAClF;AAAA,gBACE,YAAY,GAAG,QAAQ;AAAA,gBACvB,MAAM;AAAA,gBACN,IAAI;AAAA,gBACJ,KAAK;AAAA,cAAA;AAAA,YACP;AAEF,0BAAc,KAAK,gCAAgC;AAAA,cACjD,GAAG,cAAc,GAAG;AAAA,cACpB,gBAAgB,GAAG,QAAQ;AAAA,cAC3B,mBAAmB;AAAA,cACnB,aAAa;AAAA,cACb,YAAY;AAAA,YAAA,CACb;AAAA,UACH;AAAA,QACF;AAAA,MACF;AACA,eAAS;AAAA,IACX;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,oBACJ,KACA,SACiC;AACjC,eAAW,MAAM,KAAK,aAAa;AACjC,UAAI,GAAG,kBAAkB;AACvB,cAAM,OAAO,0BAA0B,EAAE;AACzC,cAAM,QAAQ,KAAK,IAAA;AACnB,cAAM,WAAW,MAAM,GAAG,iBAAiB,KAAK,OAAO;AACvD,cAAM,eAAe,aAAa,UAAa,aAAa;AAC5D,YAAI,CAAC,MAAM;AACT,eAAK,OAAO;AAAA,YACV,oCAAoC,GAAG,QAAQ,SAAS;AAAA,YACxD,EAAE,YAAY,GAAG,QAAQ,WAAW,MAAM,mBAAA;AAAA,UAAmB;AAE/D,wBAAc,KAAK,4BAA4B;AAAA,YAC7C,GAAG,cAAc,GAAG;AAAA,YACpB,gBAAgB,GAAG,QAAQ;AAAA,YAC3B,UAAU;AAAA,YACV,WAAW,IAAI;AAAA,YACf,UAAU,KAAK,IAAA,IAAQ;AAAA,YACvB;AAAA,UAAA,CACD;AAAA,QACH;AACA,YAAI,cAAc;AAChB,iBAAO;AAAA,QACT;AAAA,MACF;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,mBACJ,KACA,MACe;AACf,eAAW,MAAM,KAAK,aAAa;AACjC,UAAI,GAAG,iBAAiB;AACtB,cAAM,OAAO,0BAA0B,EAAE;AACzC,cAAM,QAAQ,KAAK,IAAA;AACnB,cAAM,GAAG,gBAAgB,KAAK,IAAI;AAClC,YAAI,CAAC,MAAM;AACT,eAAK,OAAO;AAAA,YACV,mCAAmC,GAAG,QAAQ,SAAS;AAAA,YACvD,EAAE,YAAY,GAAG,QAAQ,WAAW,MAAM,kBAAA;AAAA,UAAkB;AAE9D,wBAAc,KAAK,4BAA4B;AAAA,YAC7C,GAAG,cAAc,GAAG;AAAA,YACpB,gBAAgB,GAAG,QAAQ;AAAA,YAC3B,UAAU;AAAA,YACV,WAAW,IAAI;AAAA,YACf,UAAU,KAAK,IAAA,IAAQ;AAAA,YACvB,cAAc;AAAA,UAAA,CACf;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,WACJ,KACA,OACe;AACf,eAAW,MAAM,KAAK,aAAa;AACjC,UAAI,GAAG,SAAS;AACd,cAAM,OAAO,0BAA0B,EAAE;AACzC,cAAM,QAAQ,KAAK,IAAA;AACnB,cAAM,GAAG,QAAQ,KAAK,KAAK;AAC3B,YAAI,CAAC,MAAM;AACT,eAAK,OAAO;AAAA,YACV,2BAA2B,GAAG,QAAQ,SAAS;AAAA,YAC/C,EAAE,YAAY,GAAG,QAAQ,WAAW,MAAM,UAAA;AAAA,UAAU;AAEtD,wBAAc,KAAK,4BAA4B;AAAA,YAC7C,GAAG,cAAc,GAAG;AAAA,YACpB,gBAAgB,GAAG,QAAQ;AAAA,YAC3B,UAAU;AAAA,YACV,WAAW,IAAI;AAAA,YACf,UAAU,KAAK,IAAA,IAAQ;AAAA,YACvB,cAAc;AAAA,UAAA,CACf;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,YACJ,KACA,MACe;AACf,eAAW,MAAM,KAAK,aAAa;AACjC,UAAI,GAAG,UAAU;AACf,cAAM,OAAO,0BAA0B,EAAE;AACzC,cAAM,QAAQ,KAAK,IAAA;AACnB,cAAM,GAAG,SAAS,KAAK,IAAI;AAC3B,YAAI,CAAC,MAAM;AACT,eAAK,OAAO;AAAA,YACV,4BAA4B,GAAG,QAAQ,SAAS;AAAA,YAChD,EAAE,YAAY,GAAG,QAAQ,WAAW,MAAM,WAAA;AAAA,UAAW;AAEvD,wBAAc,KAAK,4BAA4B;AAAA,YAC7C,GAAG,cAAc,GAAG;AAAA,YACpB,gBAAgB,GAAG,QAAQ;AAAA,YAC3B,UAAU;AAAA,YACV,WAAW,IAAI;AAAA,YACf,UAAU,KAAK,IAAA,IAAQ;AAAA,YACvB,cAAc;AAAA,UAAA,CACf;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,WACJ,KACA,MACe;AACf,eAAW,MAAM,KAAK,aAAa;AACjC,UAAI,GAAG,SAAS;AACd,cAAM,OAAO,0BAA0B,EAAE;AACzC,cAAM,QAAQ,KAAK,IAAA;AACnB,cAAM,GAAG,QAAQ,KAAK,IAAI;AAC1B,YAAI,CAAC,MAAM;AACT,eAAK,OAAO;AAAA,YACV,2BAA2B,GAAG,QAAQ,SAAS;AAAA,YAC/C,EAAE,YAAY,GAAG,QAAQ,WAAW,MAAM,UAAA;AAAA,UAAU;AAEtD,wBAAc,KAAK,4BAA4B;AAAA,YAC7C,GAAG,cAAc,GAAG;AAAA,YACpB,gBAAgB,GAAG,QAAQ;AAAA,YAC3B,UAAU;AAAA,YACV,WAAW,IAAI;AAAA,YACf,UAAU,KAAK,IAAA,IAAQ;AAAA,YACvB,cAAc;AAAA,UAAA,CACf;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,WACJ,KACA,MACe;AACf,eAAW,MAAM,KAAK,aAAa;AACjC,UAAI,GAAG,SAAS;AACd,cAAM,OAAO,0BAA0B,EAAE;AACzC,cAAM,QAAQ,KAAK,IAAA;AACnB,cAAM,GAAG,QAAQ,KAAK,IAAI;AAC1B,YAAI,CAAC,MAAM;AACT,eAAK,OAAO;AAAA,YACV,2BAA2B,GAAG,QAAQ,SAAS;AAAA,YAC/C,EAAE,YAAY,GAAG,QAAQ,WAAW,MAAM,UAAA;AAAA,UAAU;AAEtD,wBAAc,KAAK,4BAA4B;AAAA,YAC7C,GAAG,cAAc,GAAG;AAAA,YACpB,gBAAgB,GAAG,QAAQ;AAAA,YAC3B,UAAU;AAAA,YACV,WAAW,IAAI;AAAA,YACf,UAAU,KAAK,IAAA,IAAQ;AAAA,YACvB,cAAc;AAAA,UAAA,CACf;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,eACJ,KACA,MACe;AACf,eAAW,MAAM,KAAK,aAAa;AACjC,UAAI,GAAG,aAAa;AAClB,cAAM,OAAO,0BAA0B,EAAE;AACzC,cAAM,QAAQ,KAAK,IAAA;AACnB,cAAM,GAAG,YAAY,KAAK,IAAI;AAC9B,YAAI,CAAC,MAAM;AACT,eAAK,OAAO;AAAA,YACV,+BAA+B,GAAG,QAAQ,SAAS;AAAA,YACnD,EAAE,YAAY,GAAG,QAAQ,WAAW,MAAM,cAAA;AAAA,UAAc;AAE1D,wBAAc,KAAK,4BAA4B;AAAA,YAC7C,GAAG,cAAc,GAAG;AAAA,YACpB,gBAAgB,GAAG,QAAQ;AAAA,YAC3B,UAAU;AAAA,YACV,WAAW,IAAI;AAAA,YACf,UAAU,KAAK,IAAA,IAAQ;AAAA,YACvB,cAAc;AAAA,UAAA,CACf;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,uBACJ,KACA,MACe;AACf,eAAW,MAAM,KAAK,aAAa;AACjC,UAAI,GAAG,qBAAqB;AAC1B,cAAM,OAAO,0BAA0B,EAAE;AACzC,cAAM,QAAQ,KAAK,IAAA;AACnB,cAAM,GAAG,oBAAoB,KAAK,IAAI;AACtC,YAAI,CAAC,MAAM;AACT,eAAK,OAAO;AAAA,YACV,uCAAuC,GAAG,QAAQ,SAAS;AAAA,YAC3D,EAAE,YAAY,GAAG,QAAQ,WAAW,MAAM,sBAAA;AAAA,UAAsB;AAElE,wBAAc,KAAK,4BAA4B;AAAA,YAC7C,GAAG,cAAc,GAAG;AAAA,YACpB,gBAAgB,GAAG,QAAQ;AAAA,YAC3B,UAAU;AAAA,YACV,WAAW,IAAI;AAAA,YACf,UAAU,KAAK,IAAA,IAAQ;AAAA,YACvB,cAAc;AAAA,UAAA,CACf;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;"}

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

@@ -0,0 +1,20 @@
+import { CapabilityHandle } from './capabilities.js';
+import { ChatMiddleware } from './types.js';
+/**
+ * A middleware whose `requires`/`provides` tuple types are captured precisely
+ * (via `const` inference) for the array coverage check and the builder.
+ */
+export interface DefinedChatMiddleware<TContext, TRequires extends ReadonlyArray<CapabilityHandle>, TProvides extends ReadonlyArray<CapabilityHandle>> extends ChatMiddleware<TContext> {
+    requires?: TRequires;
+    provides?: TProvides;
+}
+/**
+ * Identity helper for authoring middleware with precise capability inference.
+ * Returns the middleware unchanged at runtime; only sharpens its type so the
+ * `chat()` array coverage check and `createChatMiddleware` builder can read the
+ * exact `requires`/`provides`.
+ */
+export declare function defineChatMiddleware<TContext = unknown, const TRequires extends ReadonlyArray<CapabilityHandle> = readonly [], const TProvides extends ReadonlyArray<CapabilityHandle> = readonly []>(middleware: ChatMiddleware<TContext> & {
+    requires?: TRequires;
+    provides?: TProvides;
+}): DefinedChatMiddleware<TContext, TRequires, TProvides>;

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

@@ -0,0 +1,7 @@
+function defineChatMiddleware(middleware) {
+  return middleware;
+}
+export {
+  defineChatMiddleware
+};
+//# sourceMappingURL=define.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sources":["../../../../../src/activities/chat/middleware/define.ts"],"sourcesContent":["import type { CapabilityHandle } from './capabilities'\nimport type { ChatMiddleware } from './types'\n\n/**\n * A middleware whose `requires`/`provides` tuple types are captured precisely\n * (via `const` inference) for the array coverage check and the builder.\n */\nexport interface DefinedChatMiddleware<\n  TContext,\n  TRequires extends ReadonlyArray<CapabilityHandle>,\n  TProvides extends ReadonlyArray<CapabilityHandle>,\n> extends ChatMiddleware<TContext> {\n  requires?: TRequires\n  provides?: TProvides\n}\n\n/**\n * Identity helper for authoring middleware with precise capability inference.\n * Returns the middleware unchanged at runtime; only sharpens its type so the\n * `chat()` array coverage check and `createChatMiddleware` builder can read the\n * exact `requires`/`provides`.\n */\nexport function defineChatMiddleware<\n  TContext = unknown,\n  const TRequires extends ReadonlyArray<CapabilityHandle> = readonly [],\n  const TProvides extends ReadonlyArray<CapabilityHandle> = readonly [],\n>(\n  middleware: ChatMiddleware<TContext> & {\n    requires?: TRequires\n    provides?: TProvides\n  },\n): DefinedChatMiddleware<TContext, TRequires, TProvides> {\n  return middleware\n}\n"],"names":[],"mappings":"AAsBO,SAAS,qBAKd,YAIuD;AACvD,SAAO;AACT;"}

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

@@ -0,0 +1,10 @@
+export type { ChatMiddleware, ChatMiddlewareContext, ChatMiddlewarePhase, ChatMiddlewareConfig, StructuredOutputMiddlewareConfig, ToolCallHookContext, BeforeToolCallDecision, AfterToolCallInfo, IterationInfo, ToolPhaseCompleteInfo, UsageInfo, FinishInfo, AbortInfo, ErrorInfo, } from './types.js';
+export { MiddlewareRunner } from './compose.js';
+export { createCapability, CapabilityRegistry } from './capabilities.js';
+export type { Capability, CapabilityHandle, CapabilityContext, CapabilityGetter, CapabilityProvider, CapabilityGetOptions, } from './capabilities.js';
+export { defineChatMiddleware } from './define.js';
+export type { DefinedChatMiddleware } from './define.js';
+export { createChatMiddleware } from './builder.js';
+export type { ChatMiddlewareBuilder, MissingCapabilities, NamesOf, } from './builder.js';
+export { validateCapabilities } from './validate.js';
+export type { AnyChatMiddleware } from './types.js';