@tanstack/ai 0.6.3 → 0.8.0

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

@@ -1,5 +1,6 @@
 import { AnyTextAdapter } from './adapter.js';
 import { ConstrainedModelMessage, InferSchemaType, SchemaInput, StreamChunk, TextOptions } from '../../types.js';
+import { ChatMiddleware } from './middleware/types.js';
 /** The adapter kind this activity handles */
 export declare const kind: "text";
 /**
@@ -78,6 +79,25 @@ export interface TextActivityOptions<TAdapter extends AnyTextAdapter, TSchema ex
      * ```
      */
     stream?: TStream;
+    /**
+     * Optional middleware array for observing/transforming chat behavior.
+     * Middleware hooks are called in array order. See {@link ChatMiddleware} for available hooks.
+     *
+     * @example
+     * ```ts
+     * const stream = chat({
+     *   adapter: openaiText('gpt-4o'),
+     *   messages: [...],
+     *   middleware: [loggingMiddleware, redactionMiddleware],
+     * })
+     * ```
+     */
+    middleware?: Array<ChatMiddleware>;
+    /**
+     * Opaque user-provided context value passed to middleware hooks.
+     * Can be used to pass request-scoped data (e.g., user ID, request context).
+     */
+    context?: unknown;
 }
 /**
  * Create typed options for the chat() function without executing.