@tanstack/ai 0.11.1 → 0.13.0

package/dist/esm/activities/chat/adapter.d.ts

@@ -10,7 +10,12 @@ export interface TextAdapterConfig {
     headers?: Record<string, string>;
 }
 /**
- * Options for structured output generation
+ * Options for structured output generation.
+ *
+ * The internal logger is threaded through `chatOptions.logger` (inherited from
+ * `TextOptions`). Adapter implementations must call `logger.request()` before
+ * SDK calls, `logger.provider()` for each chunk received, and `logger.errors()`
+ * in catch blocks.
  */
 export interface StructuredOutputOptions<TProviderOptions extends object> {
     /** Text options for the request */
@@ -38,8 +43,9 @@ export interface StructuredOutputResult<T = unknown> {
  * - TProviderOptions: Provider-specific options for this model (already resolved)
  * - TInputModalities: Supported input modalities for this model (already resolved)
  * - TMessageMetadata: Metadata types for content parts (already resolved)
+ * - TToolCapabilities: Tuple of tool-kind strings supported by this model, resolved from `supports.tools`
  */
-export interface TextAdapter<TModel extends string, TProviderOptions extends Record<string, any>, TInputModalities extends ReadonlyArray<Modality>, TMessageMetadataByModality extends DefaultMessageMetadataByModality> {
+export interface TextAdapter<TModel extends string, TProviderOptions extends Record<string, any>, TInputModalities extends ReadonlyArray<Modality>, TMessageMetadataByModality extends DefaultMessageMetadataByModality, TToolCapabilities extends ReadonlyArray<string> = ReadonlyArray<string>> {
     /** Discriminator for adapter kind */
     readonly kind: 'text';
     /** Provider name identifier (e.g., 'openai', 'anthropic') */
@@ -53,6 +59,7 @@ export interface TextAdapter<TModel extends string, TProviderOptions extends Rec
         providerOptions: TProviderOptions;
         inputModalities: TInputModalities;
         messageMetadataByModality: TMessageMetadataByModality;
+        toolCapabilities: TToolCapabilities;
     };
     /**
      * Stream text completions from the model
@@ -72,14 +79,14 @@ export interface TextAdapter<TModel extends string, TProviderOptions extends Rec
  * A TextAdapter with any/unknown type parameters.
  * Useful as a constraint in generic functions and interfaces.
  */
-export type AnyTextAdapter = TextAdapter<any, any, any, any>;
+export type AnyTextAdapter = TextAdapter<any, any, any, any, any>;
 /**
  * Abstract base class for text adapters.
  * Extend this class to implement a text adapter for a specific provider.
  *
  * Generic parameters match TextAdapter - all pre-resolved by the provider function.
  */
-export declare abstract class BaseTextAdapter<TModel extends string, TProviderOptions extends Record<string, any>, TInputModalities extends ReadonlyArray<Modality>, TMessageMetadataByModality extends DefaultMessageMetadataByModality> implements TextAdapter<TModel, TProviderOptions, TInputModalities, TMessageMetadataByModality> {
+export declare abstract class BaseTextAdapter<TModel extends string, TProviderOptions extends Record<string, any>, TInputModalities extends ReadonlyArray<Modality>, TMessageMetadataByModality extends DefaultMessageMetadataByModality, TToolCapabilities extends ReadonlyArray<string> = ReadonlyArray<string>> implements TextAdapter<TModel, TProviderOptions, TInputModalities, TMessageMetadataByModality, TToolCapabilities> {
     readonly kind: "text";
     abstract readonly name: string;
     readonly model: TModel;
@@ -87,6 +94,7 @@ export declare abstract class BaseTextAdapter<TModel extends string, TProviderOp
         providerOptions: TProviderOptions;
         inputModalities: TInputModalities;
         messageMetadataByModality: TMessageMetadataByModality;
+        toolCapabilities: TToolCapabilities;
     };
     protected config: TextAdapterConfig;
     constructor(config: TextAdapterConfig | undefined, model: TModel);

package/dist/esm/activities/chat/adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.js","sources":["../../../../src/activities/chat/adapter.ts"],"sourcesContent":["import type {\n  DefaultMessageMetadataByModality,\n  JSONSchema,\n  Modality,\n  StreamChunk,\n  TextOptions,\n} from '../../types'\n\n/**\n * Configuration for adapter instances\n */\nexport interface TextAdapterConfig {\n  apiKey?: string\n  baseUrl?: string\n  timeout?: number\n  maxRetries?: number\n  headers?: Record<string, string>\n}\n\n/**\n * Options for structured output generation\n */\nexport interface StructuredOutputOptions<TProviderOptions extends object> {\n  /** Text options for the request */\n  chatOptions: TextOptions<TProviderOptions>\n  /** JSON Schema for structured output - already converted from Zod in the ai layer */\n  outputSchema: JSONSchema\n}\n\n/**\n * Result from structured output generation\n */\nexport interface StructuredOutputResult<T = unknown> {\n  /** The parsed data conforming to the schema */\n  data: T\n  /** The raw text response from the model before parsing */\n  rawText: string\n}\n\n/**\n * Text adapter interface with pre-resolved generics.\n *\n * An adapter is created by a provider function: `provider('model')` → `adapter`\n * All type resolution happens at the provider call site, not in this interface.\n *\n * Generic parameters:\n * - TModel: The specific model name (e.g., 'gpt-4o')\n * - TProviderOptions: Provider-specific options for this model (already resolved)\n * - TInputModalities: Supported input modalities for this model (already resolved)\n * - TMessageMetadata: Metadata types for content parts (already resolved)\n */\nexport interface TextAdapter<\n  TModel extends string,\n  TProviderOptions extends Record<string, any>,\n  TInputModalities extends ReadonlyArray<Modality>,\n  TMessageMetadataByModality extends DefaultMessageMetadataByModality,\n> {\n  /** Discriminator for adapter kind */\n  readonly kind: 'text'\n  /** Provider name identifier (e.g., 'openai', 'anthropic') */\n  readonly name: string\n  /** The model this adapter is configured for */\n  readonly model: TModel\n\n  /**\n   * @internal Type-only properties for inference. Not assigned at runtime.\n   */\n  '~types': {\n    providerOptions: TProviderOptions\n    inputModalities: TInputModalities\n    messageMetadataByModality: TMessageMetadataByModality\n  }\n\n  /**\n   * Stream text completions from the model\n   */\n  chatStream: (\n    options: TextOptions<TProviderOptions>,\n  ) => AsyncIterable<StreamChunk>\n\n  /**\n   * Generate structured output using the provider's native structured output API.\n   * This method uses stream: false and sends the JSON schema to the provider\n   * to ensure the response conforms to the expected structure.\n   *\n   * @param options - Structured output options containing chat options and JSON schema\n   * @returns Promise with the raw data (validation is done in the chat function)\n   */\n  structuredOutput: (\n    options: StructuredOutputOptions<TProviderOptions>,\n  ) => Promise<StructuredOutputResult<unknown>>\n}\n\n/**\n * A TextAdapter with any/unknown type parameters.\n * Useful as a constraint in generic functions and interfaces.\n */\nexport type AnyTextAdapter = TextAdapter<any, any, any, any>\n\n/**\n * Abstract base class for text adapters.\n * Extend this class to implement a text adapter for a specific provider.\n *\n * Generic parameters match TextAdapter - all pre-resolved by the provider function.\n */\nexport abstract class BaseTextAdapter<\n  TModel extends string,\n  TProviderOptions extends Record<string, any>,\n  TInputModalities extends ReadonlyArray<Modality>,\n  TMessageMetadataByModality extends DefaultMessageMetadataByModality,\n> implements TextAdapter<\n  TModel,\n  TProviderOptions,\n  TInputModalities,\n  TMessageMetadataByModality\n> {\n  readonly kind = 'text' as const\n  abstract readonly name: string\n  readonly model: TModel\n\n  // Type-only property - never assigned at runtime\n  declare '~types': {\n    providerOptions: TProviderOptions\n    inputModalities: TInputModalities\n    messageMetadataByModality: TMessageMetadataByModality\n  }\n\n  protected config: TextAdapterConfig\n\n  constructor(config: TextAdapterConfig = {}, model: TModel) {\n    this.config = config\n    this.model = model\n  }\n\n  abstract chatStream(\n    options: TextOptions<TProviderOptions>,\n  ): AsyncIterable<StreamChunk>\n\n  /**\n   * Generate structured output using the provider's native structured output API.\n   * Concrete implementations should override this to use provider-specific structured output.\n   */\n  abstract structuredOutput(\n    options: StructuredOutputOptions<TProviderOptions>,\n  ): Promise<StructuredOutputResult<unknown>>\n\n  protected generateId(): string {\n    return `${this.name}-${Date.now()}-${Math.random().toString(36).substring(7)}`\n  }\n}\n"],"names":[],"mappings":"AAyGO,MAAe,gBAUpB;AAAA,EAcA,YAAY,SAA4B,CAAA,GAAI,OAAe;AAb3D,SAAS,OAAO;AAcd,SAAK,SAAS;AACd,SAAK,QAAQ;AAAA,EACf;AAAA,EAcU,aAAqB;AAC7B,WAAO,GAAG,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,KAAK,OAAA,EAAS,SAAS,EAAE,EAAE,UAAU,CAAC,CAAC;AAAA,EAC9E;AACF;"}
+{"version":3,"file":"adapter.js","sources":["../../../../src/activities/chat/adapter.ts"],"sourcesContent":["import type {\n  DefaultMessageMetadataByModality,\n  JSONSchema,\n  Modality,\n  StreamChunk,\n  TextOptions,\n} from '../../types'\n\n/**\n * Configuration for adapter instances\n */\nexport interface TextAdapterConfig {\n  apiKey?: string\n  baseUrl?: string\n  timeout?: number\n  maxRetries?: number\n  headers?: Record<string, string>\n}\n\n/**\n * Options for structured output generation.\n *\n * The internal logger is threaded through `chatOptions.logger` (inherited from\n * `TextOptions`). Adapter implementations must call `logger.request()` before\n * SDK calls, `logger.provider()` for each chunk received, and `logger.errors()`\n * in catch blocks.\n */\nexport interface StructuredOutputOptions<TProviderOptions extends object> {\n  /** Text options for the request */\n  chatOptions: TextOptions<TProviderOptions>\n  /** JSON Schema for structured output - already converted from Zod in the ai layer */\n  outputSchema: JSONSchema\n}\n\n/**\n * Result from structured output generation\n */\nexport interface StructuredOutputResult<T = unknown> {\n  /** The parsed data conforming to the schema */\n  data: T\n  /** The raw text response from the model before parsing */\n  rawText: string\n}\n\n/**\n * Text adapter interface with pre-resolved generics.\n *\n * An adapter is created by a provider function: `provider('model')` → `adapter`\n * All type resolution happens at the provider call site, not in this interface.\n *\n * Generic parameters:\n * - TModel: The specific model name (e.g., 'gpt-4o')\n * - TProviderOptions: Provider-specific options for this model (already resolved)\n * - TInputModalities: Supported input modalities for this model (already resolved)\n * - TMessageMetadata: Metadata types for content parts (already resolved)\n * - TToolCapabilities: Tuple of tool-kind strings supported by this model, resolved from `supports.tools`\n */\nexport interface TextAdapter<\n  TModel extends string,\n  TProviderOptions extends Record<string, any>,\n  TInputModalities extends ReadonlyArray<Modality>,\n  TMessageMetadataByModality extends DefaultMessageMetadataByModality,\n  TToolCapabilities extends ReadonlyArray<string> = ReadonlyArray<string>,\n> {\n  /** Discriminator for adapter kind */\n  readonly kind: 'text'\n  /** Provider name identifier (e.g., 'openai', 'anthropic') */\n  readonly name: string\n  /** The model this adapter is configured for */\n  readonly model: TModel\n\n  /**\n   * @internal Type-only properties for inference. Not assigned at runtime.\n   */\n  '~types': {\n    providerOptions: TProviderOptions\n    inputModalities: TInputModalities\n    messageMetadataByModality: TMessageMetadataByModality\n    toolCapabilities: TToolCapabilities\n  }\n\n  /**\n   * Stream text completions from the model\n   */\n  chatStream: (\n    options: TextOptions<TProviderOptions>,\n  ) => AsyncIterable<StreamChunk>\n\n  /**\n   * Generate structured output using the provider's native structured output API.\n   * This method uses stream: false and sends the JSON schema to the provider\n   * to ensure the response conforms to the expected structure.\n   *\n   * @param options - Structured output options containing chat options and JSON schema\n   * @returns Promise with the raw data (validation is done in the chat function)\n   */\n  structuredOutput: (\n    options: StructuredOutputOptions<TProviderOptions>,\n  ) => Promise<StructuredOutputResult<unknown>>\n}\n\n/**\n * A TextAdapter with any/unknown type parameters.\n * Useful as a constraint in generic functions and interfaces.\n */\nexport type AnyTextAdapter = TextAdapter<any, any, any, any, any>\n\n/**\n * Abstract base class for text adapters.\n * Extend this class to implement a text adapter for a specific provider.\n *\n * Generic parameters match TextAdapter - all pre-resolved by the provider function.\n */\nexport abstract class BaseTextAdapter<\n  TModel extends string,\n  TProviderOptions extends Record<string, any>,\n  TInputModalities extends ReadonlyArray<Modality>,\n  TMessageMetadataByModality extends DefaultMessageMetadataByModality,\n  TToolCapabilities extends ReadonlyArray<string> = ReadonlyArray<string>,\n> implements TextAdapter<\n  TModel,\n  TProviderOptions,\n  TInputModalities,\n  TMessageMetadataByModality,\n  TToolCapabilities\n> {\n  readonly kind = 'text' as const\n  abstract readonly name: string\n  readonly model: TModel\n\n  // Type-only property - never assigned at runtime\n  declare '~types': {\n    providerOptions: TProviderOptions\n    inputModalities: TInputModalities\n    messageMetadataByModality: TMessageMetadataByModality\n    toolCapabilities: TToolCapabilities\n  }\n\n  protected config: TextAdapterConfig\n\n  constructor(config: TextAdapterConfig = {}, model: TModel) {\n    this.config = config\n    this.model = model\n  }\n\n  abstract chatStream(\n    options: TextOptions<TProviderOptions>,\n  ): AsyncIterable<StreamChunk>\n\n  /**\n   * Generate structured output using the provider's native structured output API.\n   * Concrete implementations should override this to use provider-specific structured output.\n   */\n  abstract structuredOutput(\n    options: StructuredOutputOptions<TProviderOptions>,\n  ): Promise<StructuredOutputResult<unknown>>\n\n  protected generateId(): string {\n    return `${this.name}-${Date.now()}-${Math.random().toString(36).substring(7)}`\n  }\n}\n"],"names":[],"mappings":"AAiHO,MAAe,gBAYpB;AAAA,EAeA,YAAY,SAA4B,CAAA,GAAI,OAAe;AAd3D,SAAS,OAAO;AAed,SAAK,SAAS;AACd,SAAK,QAAQ;AAAA,EACf;AAAA,EAcU,aAAqB;AAC7B,WAAO,GAAG,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,KAAK,OAAA,EAAS,SAAS,EAAE,EAAE,UAAU,CAAC,CAAC;AAAA,EAC9E;AACF;"}

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

@@ -1,6 +1,8 @@
 import { AnyTextAdapter } from './adapter.js';
-import { ConstrainedModelMessage, InferSchemaType, SchemaInput, StreamChunk, TextOptions } from '../../types.js';
+import { ConstrainedModelMessage, InferSchemaType, SchemaInput, StreamChunk, TextOptions, Tool } from '../../types.js';
 import { ChatMiddleware } from './middleware/types.js';
+import { DebugOption } from '../../logger/types.js';
+import { ProviderTool } from '../../tools/provider-tool.js';
 /** The adapter kind this activity handles */
 export declare const kind: "text";
 /**
@@ -21,8 +23,19 @@ export interface TextActivityOptions<TAdapter extends AnyTextAdapter, TSchema ex
     }>>;
     /** System prompts to prepend to the conversation */
     systemPrompts?: TextOptions['systemPrompts'];
-    /** Tools for function calling (auto-executed when called) */
-    tools?: TextOptions['tools'];
+    /**
+     * Tools for function calling (auto-executed when called).
+     *
+     * Accepts two shapes:
+     *  - User-defined tools via `toolDefinition()` — plain `Tool`, always assignable.
+     *  - Provider tools from `@tanstack/ai-<provider>/tools` (e.g. `webSearchTool`)
+     *    — branded and type-checked against the selected model's
+     *    `supports.tools` list. Passing an unsupported tool produces a
+     *    compile-time error on the array element.
+     */
+    tools?: Array<(Tool & {
+        readonly '~toolKind'?: never;
+    }) | ProviderTool<string, TAdapter['~types']['toolCapabilities'][number]>>;
     /** Controls the randomness of the output. Higher values make output more random. Range: [0.0, 2.0] */
     temperature?: TextOptions['temperature'];
     /** Nucleus sampling parameter. The model considers tokens with topP probability mass. */
@@ -102,6 +115,13 @@ export interface TextActivityOptions<TAdapter extends AnyTextAdapter, TSchema ex
      * Can be used to pass request-scoped data (e.g., user ID, request context).
      */
     context?: unknown;
+    /**
+     * Enable debug logging. Pass `true` to enable all categories with the default
+     * console logger, `false` to silence everything, or a `DebugConfig` object for
+     * granular control and/or a custom `Logger`. Defaults to `undefined`, which
+     * means only the `errors` category is active.
+     */
+    debug?: DebugOption;
 }
 /**
  * Create typed options for the chat() function without executing.

package/dist/esm/activities/chat/index.js

@@ -1,6 +1,7 @@
 import { devtoolsMiddleware } from "@tanstack/ai-event-client";
 import { stripToSpecMiddleware } from "../../strip-to-spec-middleware.js";
 import { streamToText } from "../../stream-to-response.js";
+import { resolveDebugOption } from "../../logger/resolve.js";
 import { LazyToolManager } from "./tools/lazy-tool-manager.js";
 import { ToolCallManager, MiddlewareAbortError, executeToolCalls } from "./tools/tool-calls.js";
 import { convertSchemaToJsonSchema, isStandardSchema, parseWithStandardSchema } from "./tools/schema-converter.js";
@@ -12,7 +13,7 @@ function createChatOptions(options) {
   return options;
 }
 class TextEngine {
-  constructor(config) {
+  constructor(config, logger) {
     this.iterationCount = 0;
     this.lastFinishReason = null;
     this.streamStartTime = 0;
@@ -25,6 +26,7 @@ class TextEngine {
     this.cyclePhase = "processText";
     this.deferredPromises = [];
     this.terminalHookCalled = false;
+    this.logger = logger;
     this.adapter = config.adapter;
     this.params = config.params;
     this.systemPrompts = config.params.systemPrompts || [];
@@ -55,7 +57,7 @@ class TextEngine {
       ...config.middleware || [],
       stripToSpecMiddleware()
     ];
-    this.middlewareRunner = new MiddlewareRunner(allMiddleware);
+    this.middlewareRunner = new MiddlewareRunner(allMiddleware, logger);
     this.middlewareAbortController = new AbortController();
     this.middlewareCtx = {
       requestId: this.requestId,
@@ -104,6 +106,9 @@ class TextEngine {
   }
   async *run() {
     this.beforeRun();
+    this.logger.agentLoop("run started", {
+      conversationId: this.middlewareCtx.conversationId
+    });
     try {
       this.middlewareCtx.phase = "init";
       const initialConfig = this.buildMiddlewareConfig();
@@ -121,6 +126,9 @@ class TextEngine {
         if (this.earlyTermination || this.isCancelled()) {
           return;
         }
+        this.logger.agentLoop(`iteration=${this.middlewareCtx.iteration}`, {
+          iteration: this.middlewareCtx.iteration
+        });
         await this.beginCycle();
         if (this.cyclePhase === "processText") {
           this.middlewareCtx.phase = "beforeModel";
@@ -137,6 +145,9 @@ class TextEngine {
         }
         this.endCycle();
       } while (this.shouldContinue());
+      this.logger.agentLoop("run finished", {
+        finishReason: this.lastFinishReason
+      });
       if (!this.terminalHookCalled && this.toolPhase !== "wait") {
         this.terminalHookCalled = true;
         await this.middlewareRunner.runOnFinish(this.middlewareCtx, {
@@ -156,6 +167,10 @@ class TextEngine {
             duration: Date.now() - this.streamStartTime
           });
         } else {
+          this.logger.errors("chat run failed", {
+            error,
+            conversationId: this.middlewareCtx.conversationId
+          });
           await this.middlewareRunner.runOnError(this.middlewareCtx, {
             error,
             duration: Date.now() - this.streamStartTime
@@ -224,6 +239,16 @@ class TextEngine {
       outputSchema: tool.outputSchema ? convertSchemaToJsonSchema(tool.outputSchema) : void 0
     }));
     this.middlewareCtx.phase = "modelStream";
+    const providerName = this.adapter.provider ?? this.adapter.name;
+    this.logger.request(
+      `activity=chat provider=${providerName} model=${this.params.model} messages=${this.messages.length} tools=${this.tools.length} stream=true`,
+      {
+        provider: providerName,
+        model: this.params.model,
+        messageCount: this.messages.length,
+        toolCount: this.tools.length
+      }
+    );
     for await (const chunk of this.adapter.chatStream({
       model: this.params.model,
       messages: this.messages,
@@ -235,6 +260,7 @@ class TextEngine {
       request: this.effectiveRequest,
       modelOptions,
       systemPrompts: this.systemPrompts,
+      logger: this.logger,
       threadId: this.threadId,
       runId: this.runIdOverride
     })) {
@@ -248,6 +274,7 @@ class TextEngine {
         chunk
       );
       for (const outputChunk of outputChunks) {
+        this.logger.output(`type=${outputChunk.type}`, { chunk: outputChunk });
         yield outputChunk;
         this.middlewareCtx.chunkIndex++;
       }
@@ -357,6 +384,10 @@ class TextEngine {
       (eventName, data) => this.createCustomEventChunk(eventName, data),
       {
         onBeforeToolCall: async (toolCall, tool, args) => {
+          this.logger.tools(`phase=before name=${toolCall.function.name}`, {
+            name: toolCall.function.name,
+            args
+          });
           const hookCtx = {
             toolCall,
             tool,
@@ -370,6 +401,10 @@ class TextEngine {
           );
         },
         onAfterToolCall: async (info) => {
+          this.logger.tools(`phase=after name=${info.toolName}`, {
+            name: info.toolName,
+            result: info.result
+          });
           await this.middlewareRunner.runOnAfterToolCall(
             this.middlewareCtx,
             info
@@ -480,6 +515,10 @@ class TextEngine {
       (eventName, data) => this.createCustomEventChunk(eventName, data),
       {
         onBeforeToolCall: async (toolCall, tool, args) => {
+          this.logger.tools(`phase=before name=${toolCall.function.name}`, {
+            name: toolCall.function.name,
+            args
+          });
           const hookCtx = {
             toolCall,
             tool,
@@ -493,6 +532,10 @@ class TextEngine {
           );
         },
         onAfterToolCall: async (info) => {
+          this.logger.tools(`phase=after name=${info.toolName}`, {
+            name: info.toolName,
+            result: info.result
+          });
           await this.middlewareRunner.runOnAfterToolCall(
             this.middlewareCtx,
             info
@@ -846,14 +889,18 @@ function chat(options) {
   );
 }
 async function* runStreamingText(options) {
-  const { adapter, middleware, context, ...textOptions } = options;
+  const { adapter, middleware, context, debug, ...textOptions } = options;
   const model = adapter.model;
-  const engine = new TextEngine({
-    adapter,
-    params: { ...textOptions, model },
-    middleware,
-    context
-  });
+  const logger = resolveDebugOption(debug);
+  const engine = new TextEngine(
+    {
+      adapter,
+      params: { ...textOptions, model, logger },
+      middleware,
+      context
+    },
+    logger
+  );
   for await (const chunk of engine.run()) {
     yield chunk;
   }
@@ -865,17 +912,21 @@ function runNonStreamingText(options) {
   return streamToText(stream);
 }
 async function runAgenticStructuredOutput(options) {
-  const { adapter, outputSchema, middleware, context, ...textOptions } = options;
+  const { adapter, outputSchema, middleware, context, debug, ...textOptions } = options;
   const model = adapter.model;
+  const logger = resolveDebugOption(debug);
   if (!outputSchema) {
     throw new Error("outputSchema is required for structured output");
   }
-  const engine = new TextEngine({
-    adapter,
-    params: { ...textOptions, model },
-    middleware,
-    context
-  });
+  const engine = new TextEngine(
+    {
+      adapter,
+      params: { ...textOptions, model, logger },
+      middleware,
+      context
+    },
+    logger
+  );
   for await (const _chunk of engine.run()) {
   }
   const finalMessages = engine.getMessages();
@@ -888,11 +939,21 @@ async function runAgenticStructuredOutput(options) {
   if (!jsonSchema) {
     throw new Error("Failed to convert output schema to JSON Schema");
   }
+  const providerName = adapter.provider ?? adapter.name;
+  logger.request(
+    `activity=chat-structured provider=${providerName} model=${model} messages=${finalMessages.length}`,
+    {
+      provider: providerName,
+      model,
+      messageCount: finalMessages.length
+    }
+  );
   const result = await adapter.structuredOutput({
     chatOptions: {
       ...structuredTextOptions,
       model,
-      messages: finalMessages
+      messages: finalMessages,
+      logger
     },
     outputSchema: jsonSchema
   });