@tanstack/ai 0.0.1 → 0.0.3

package/README.md

@@ -115,7 +115,7 @@ We're looking for TanStack AI Partners to join our mission! Partner with us to p
 
 - <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> – Tooling for JS/TS packages
 - <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> – Reactive sync client store
-- <a href="https://github.com/tanstack/devtools">TanStack Devtools</a> – Unified devtools panel
+- <a href="https://github.com/tanstack/devtools"><b>TanStack Devtools</b></a> – Unified devtools panel
 - <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> – Type‑safe form state
 - <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> – Debouncing, throttling, batching
 - <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> – Async state & caching

package/dist/esm/base-adapter.d.ts

@@ -12,6 +12,7 @@ import { AIAdapter, AIAdapterConfig, ChatOptions, DefaultMessageMetadataByModali
  * - TMessageMetadataByModality: Map from modality type to adapter-specific metadata types
  */
 export declare abstract class BaseAdapter<TChatModels extends ReadonlyArray<string> = ReadonlyArray<string>, TEmbeddingModels extends ReadonlyArray<string> = ReadonlyArray<string>, TChatProviderOptions extends Record<string, any> = Record<string, any>, TEmbeddingProviderOptions extends Record<string, any> = Record<string, any>, TModelProviderOptionsByName extends Record<string, any> = Record<string, any>, TModelInputModalitiesByName extends Record<string, ReadonlyArray<Modality>> = Record<string, ReadonlyArray<Modality>>, TMessageMetadataByModality extends {
+    text: unknown;
     image: unknown;
     audio: unknown;
     video: unknown;

package/dist/esm/base-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-adapter.js","sources":["../../src/base-adapter.ts"],"sourcesContent":["import type {\n  AIAdapter,\n  AIAdapterConfig,\n  ChatOptions,\n  DefaultMessageMetadataByModality,\n  EmbeddingOptions,\n  EmbeddingResult,\n  Modality,\n  StreamChunk,\n  SummarizationOptions,\n  SummarizationResult,\n} from './types'\n\n/**\n * Base adapter class with support for endpoint-specific models and provider options.\n *\n * Generic parameters:\n * - TChatModels: Models that support chat/text completion\n * - TEmbeddingModels: Models that support embeddings\n * - TChatProviderOptions: Provider-specific options for chat endpoint\n * - TEmbeddingProviderOptions: Provider-specific options for embedding endpoint\n * - TModelProviderOptionsByName: Provider-specific options for model by name\n * - TModelInputModalitiesByName: Map from model name to its supported input modalities\n * - TMessageMetadataByModality: Map from modality type to adapter-specific metadata types\n */\nexport abstract class BaseAdapter<\n  TChatModels extends ReadonlyArray<string> = ReadonlyArray<string>,\n  TEmbeddingModels extends ReadonlyArray<string> = ReadonlyArray<string>,\n  TChatProviderOptions extends Record<string, any> = Record<string, any>,\n  TEmbeddingProviderOptions extends Record<string, any> = Record<string, any>,\n  TModelProviderOptionsByName extends Record<string, any> = Record<string, any>,\n  TModelInputModalitiesByName extends Record<\n    string,\n    ReadonlyArray<Modality>\n  > = Record<string, ReadonlyArray<Modality>>,\n  TMessageMetadataByModality extends {\n    image: unknown\n    audio: unknown\n    video: unknown\n    document: unknown\n  } = DefaultMessageMetadataByModality,\n> implements\n    AIAdapter<\n      TChatModels,\n      TEmbeddingModels,\n      TChatProviderOptions,\n      TEmbeddingProviderOptions,\n      TModelProviderOptionsByName,\n      TModelInputModalitiesByName,\n      TMessageMetadataByModality\n    >\n{\n  abstract name: string\n  abstract models: TChatModels\n  embeddingModels?: TEmbeddingModels\n  protected config: AIAdapterConfig\n\n  // These properties are used for type inference only, never assigned at runtime\n  _providerOptions?: TChatProviderOptions\n  _chatProviderOptions?: TChatProviderOptions\n  _embeddingProviderOptions?: TEmbeddingProviderOptions\n  // Type-only map; concrete adapters should override this with a precise type\n  _modelProviderOptionsByName!: TModelProviderOptionsByName\n  // Type-only map for model input modalities; concrete adapters should override this\n  _modelInputModalitiesByName?: TModelInputModalitiesByName\n  // Type-only map for message metadata types; concrete adapters should override this\n  _messageMetadataByModality?: TMessageMetadataByModality\n\n  constructor(config: AIAdapterConfig = {}) {\n    this.config = config\n  }\n\n  abstract chatStream(options: ChatOptions): AsyncIterable<StreamChunk>\n\n  abstract summarize(\n    options: SummarizationOptions,\n  ): Promise<SummarizationResult>\n  abstract createEmbeddings(options: EmbeddingOptions): Promise<EmbeddingResult>\n\n  protected generateId(): string {\n    return `${this.name}-${Date.now()}-${Math.random()\n      .toString(36)\n      .substring(7)}`\n  }\n}\n"],"names":[],"mappings":"AAyBO,MAAe,YA0BtB;AAAA,EAiBE,YAAY,SAA0B,IAAI;AACxC,SAAK,SAAS;AAAA,EAChB;AAAA,EASU,aAAqB;AAC7B,WAAO,GAAG,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,KAAK,OAAA,EACvC,SAAS,EAAE,EACX,UAAU,CAAC,CAAC;AAAA,EACjB;AACF;"}
+{"version":3,"file":"base-adapter.js","sources":["../../src/base-adapter.ts"],"sourcesContent":["import type {\n  AIAdapter,\n  AIAdapterConfig,\n  ChatOptions,\n  DefaultMessageMetadataByModality,\n  EmbeddingOptions,\n  EmbeddingResult,\n  Modality,\n  StreamChunk,\n  SummarizationOptions,\n  SummarizationResult,\n} from './types'\n\n/**\n * Base adapter class with support for endpoint-specific models and provider options.\n *\n * Generic parameters:\n * - TChatModels: Models that support chat/text completion\n * - TEmbeddingModels: Models that support embeddings\n * - TChatProviderOptions: Provider-specific options for chat endpoint\n * - TEmbeddingProviderOptions: Provider-specific options for embedding endpoint\n * - TModelProviderOptionsByName: Provider-specific options for model by name\n * - TModelInputModalitiesByName: Map from model name to its supported input modalities\n * - TMessageMetadataByModality: Map from modality type to adapter-specific metadata types\n */\nexport abstract class BaseAdapter<\n  TChatModels extends ReadonlyArray<string> = ReadonlyArray<string>,\n  TEmbeddingModels extends ReadonlyArray<string> = ReadonlyArray<string>,\n  TChatProviderOptions extends Record<string, any> = Record<string, any>,\n  TEmbeddingProviderOptions extends Record<string, any> = Record<string, any>,\n  TModelProviderOptionsByName extends Record<string, any> = Record<string, any>,\n  TModelInputModalitiesByName extends Record<\n    string,\n    ReadonlyArray<Modality>\n  > = Record<string, ReadonlyArray<Modality>>,\n  TMessageMetadataByModality extends {\n    text: unknown\n    image: unknown\n    audio: unknown\n    video: unknown\n    document: unknown\n  } = DefaultMessageMetadataByModality,\n> implements\n    AIAdapter<\n      TChatModels,\n      TEmbeddingModels,\n      TChatProviderOptions,\n      TEmbeddingProviderOptions,\n      TModelProviderOptionsByName,\n      TModelInputModalitiesByName,\n      TMessageMetadataByModality\n    >\n{\n  abstract name: string\n  abstract models: TChatModels\n  embeddingModels?: TEmbeddingModels\n  protected config: AIAdapterConfig\n\n  // These properties are used for type inference only, never assigned at runtime\n  _providerOptions?: TChatProviderOptions\n  _chatProviderOptions?: TChatProviderOptions\n  _embeddingProviderOptions?: TEmbeddingProviderOptions\n  // Type-only map; concrete adapters should override this with a precise type\n  _modelProviderOptionsByName!: TModelProviderOptionsByName\n  // Type-only map for model input modalities; concrete adapters should override this\n  _modelInputModalitiesByName?: TModelInputModalitiesByName\n  // Type-only map for message metadata types; concrete adapters should override this\n  _messageMetadataByModality?: TMessageMetadataByModality\n\n  constructor(config: AIAdapterConfig = {}) {\n    this.config = config\n  }\n\n  abstract chatStream(options: ChatOptions): AsyncIterable<StreamChunk>\n\n  abstract summarize(\n    options: SummarizationOptions,\n  ): Promise<SummarizationResult>\n  abstract createEmbeddings(options: EmbeddingOptions): Promise<EmbeddingResult>\n\n  protected generateId(): string {\n    return `${this.name}-${Date.now()}-${Math.random()\n      .toString(36)\n      .substring(7)}`\n  }\n}\n"],"names":[],"mappings":"AAyBO,MAAe,YA2BtB;AAAA,EAiBE,YAAY,SAA0B,IAAI;AACxC,SAAK,SAAS;AAAA,EAChB;AAAA,EASU,aAAqB;AAC7B,WAAO,GAAG,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,KAAK,OAAA,EACvC,SAAS,EAAE,EACX,UAAU,CAAC,CAAC;AAAA,EACjB;AACF;"}

package/dist/esm/event-client.d.ts

@@ -277,35 +277,8 @@ export interface AIDevtoolsEventMap {
         timestamp: number;
     };
 }
-type StripPrefix<T extends string> = T extends `tanstack-ai-devtools:${infer Suffix}` ? Suffix : never;
-type EventSuffix = StripPrefix<keyof AIDevtoolsEventMap & string>;
 declare class AiEventClient extends EventClient<AIDevtoolsEventMap> {
-    private eventTarget;
     constructor();
-    /**
-     * Subscribe to events using both the parent EventClient and EventTarget API
-     * @param eventSuffix - The event name without the prefix (e.g., "stream:started")
-     * @param handler - The event handler function
-     * @param options - Optional configuration for event subscription
-     * @returns A function to unsubscribe from the event
-     */
-    on<TSuffix extends EventSuffix>(eventSuffix: TSuffix, handler: (event: {
-        type: `tanstack-ai-devtools:${TSuffix}`;
-        payload: AIDevtoolsEventMap[`tanstack-ai-devtools:${TSuffix}`];
-    }) => void, options?: {
-        withEventTarget?: boolean;
-    }): () => void;
-    /**
-     * Emit an event to both the parent EventClient and the EventTarget
-     * @param eventSuffix - The event name without the prefix (e.g., "stream:started")
-     * @param data - The event data
-     */
-    emit<TSuffix extends EventSuffix>(eventSuffix: TSuffix, data: AIDevtoolsEventMap[`tanstack-ai-devtools:${TSuffix}`]): void;
-    /**
-     * Get the underlying EventTarget for advanced use cases
-     * @returns The EventTarget instance
-     */
-    getEventTarget(): EventTarget;
 }
 declare const aiEventClient: AiEventClient;
 export { aiEventClient };

package/dist/esm/event-client.js

@@ -4,55 +4,6 @@ class AiEventClient extends EventClient {
     super({
       pluginId: "tanstack-ai-devtools"
     });
-    this.eventTarget = new EventTarget();
-  }
-  /**
-   * Subscribe to events using both the parent EventClient and EventTarget API
-   * @param eventSuffix - The event name without the prefix (e.g., "stream:started")
-   * @param handler - The event handler function
-   * @param options - Optional configuration for event subscription
-   * @returns A function to unsubscribe from the event
-   */
-  on(eventSuffix, handler, options) {
-    const parentUnsubscribe = super.on(eventSuffix, handler);
-    const withEventTarget = options?.withEventTarget ?? true;
-    let eventListener;
-    if (withEventTarget) {
-      eventListener = (event) => {
-        if (event instanceof CustomEvent) {
-          handler({
-            type: `${eventSuffix}`,
-            payload: event.detail
-          });
-        }
-      };
-      this.eventTarget.addEventListener(eventSuffix, eventListener);
-    }
-    return () => {
-      parentUnsubscribe();
-      if (withEventTarget && eventListener) {
-        this.eventTarget.removeEventListener(eventSuffix, eventListener);
-      }
-    };
-  }
-  /**
-   * Emit an event to both the parent EventClient and the EventTarget
-   * @param eventSuffix - The event name without the prefix (e.g., "stream:started")
-   * @param data - The event data
-   */
-  emit(eventSuffix, data) {
-    super.emit(eventSuffix, data);
-    const customEvent = new CustomEvent(eventSuffix, {
-      detail: data
-    });
-    this.eventTarget.dispatchEvent(customEvent);
-  }
-  /**
-   * Get the underlying EventTarget for advanced use cases
-   * @returns The EventTarget instance
-   */
-  getEventTarget() {
-    return this.eventTarget;
   }
 }
 const aiEventClient = new AiEventClient();

package/dist/esm/event-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-client.js","sources":["../../src/event-client.ts"],"sourcesContent":["import { EventClient } from '@tanstack/devtools-event-client'\n\n/**\n * Tool call states - track the lifecycle of a tool call\n * Must match @tanstack/ai-client ToolCallState\n */\ntype ToolCallState =\n  | 'awaiting-input' // Received start but no arguments yet\n  | 'input-streaming' // Partial arguments received\n  | 'input-complete' // All arguments received\n  | 'approval-requested' // Waiting for user approval\n  | 'approval-responded' // User has approved/denied\n\n/**\n * Tool result states - track the lifecycle of a tool result\n * Must match @tanstack/ai-client ToolResultState\n */\ntype ToolResultState =\n  | 'streaming' // Placeholder for future streamed output\n  | 'complete' // Result is complete\n  | 'error' // Error occurred\n\nexport interface AIDevtoolsEventMap {\n  // AI Stream events - from @tanstack/ai package\n  'tanstack-ai-devtools:stream:started': {\n    streamId: string\n    model: string\n    provider: string\n    timestamp: number\n    clientId?: string\n  }\n  'tanstack-ai-devtools:stream:chunk:content': {\n    streamId: string\n    messageId?: string\n    content: string\n    delta?: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:chunk:tool-call': {\n    streamId: string\n    messageId?: string\n    toolCallId: string\n    toolName: string\n    index: number\n    arguments: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:chunk:tool-result': {\n    streamId: string\n    messageId?: string\n    toolCallId: string\n    result: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:chunk:done': {\n    streamId: string\n    messageId?: string\n    finishReason: string | null\n    usage?: {\n      promptTokens: number\n      completionTokens: number\n      totalTokens: number\n    }\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:chunk:error': {\n    streamId: string\n    messageId?: string\n    error: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:chunk:thinking': {\n    streamId: string\n    messageId?: string\n    content: string\n    delta?: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:approval-requested': {\n    streamId: string\n    messageId?: string\n    toolCallId: string\n    toolName: string\n    input: any\n    approvalId: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:tool-input-available': {\n    streamId: string\n    messageId?: string\n    toolCallId: string\n    toolName: string\n    input: any\n    timestamp: number\n  }\n  'tanstack-ai-devtools:tool:call-completed': {\n    requestId: string\n    streamId: string\n    messageId?: string\n    toolCallId: string\n    toolName: string\n    result: any\n    duration: number\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:ended': {\n    requestId: string\n    streamId: string\n    totalChunks: number\n    duration: number\n    timestamp: number\n  }\n  'tanstack-ai-devtools:chat:started': {\n    requestId: string\n    streamId: string\n    provider: string\n    model: string\n    messageCount: number\n    hasTools: boolean\n    streaming: boolean\n    timestamp: number\n    clientId?: string\n    toolNames?: Array<string>\n    options?: Record<string, unknown>\n    providerOptions?: Record<string, unknown>\n  }\n  'tanstack-ai-devtools:chat:completed': {\n    requestId: string\n    streamId: string\n    model: string\n    content: string\n    messageId?: string\n    finishReason?: string\n    usage?: {\n      promptTokens: number\n      completionTokens: number\n      totalTokens: number\n    }\n    timestamp: number\n  }\n  'tanstack-ai-devtools:chat:iteration': {\n    requestId: string\n    streamId: string\n    iterationNumber: number\n    messageCount: number\n    toolCallCount: number\n    timestamp: number\n  }\n  'tanstack-ai-devtools:usage:tokens': {\n    requestId: string\n    streamId: string\n    model: string\n    messageId?: string\n    usage: {\n      promptTokens: number\n      completionTokens: number\n      totalTokens: number\n    }\n    timestamp: number\n  }\n\n  // Embedding events\n  'tanstack-ai-devtools:embedding:started': {\n    requestId: string\n    model: string\n    inputCount: number\n    timestamp: number\n    clientId?: string\n  }\n  'tanstack-ai-devtools:embedding:completed': {\n    requestId: string\n    model: string\n    inputCount: number\n    duration: number\n    timestamp: number\n  }\n\n  // Summarize events\n  'tanstack-ai-devtools:summarize:started': {\n    requestId: string\n    model: string\n    inputLength: number\n    timestamp: number\n    clientId?: string\n  }\n  'tanstack-ai-devtools:summarize:completed': {\n    requestId: string\n    model: string\n    inputLength: number\n    outputLength: number\n    duration: number\n    timestamp: number\n  }\n\n  // Chat Client events - from @tanstack/ai-client package\n  'tanstack-ai-devtools:client:created': {\n    clientId: string\n    initialMessageCount: number\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:message-appended': {\n    clientId: string\n    messageId: string\n    role: 'user' | 'assistant' | 'system' | 'tool'\n    contentPreview: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:message-sent': {\n    clientId: string\n    messageId: string\n    content: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:loading-changed': {\n    clientId: string\n    isLoading: boolean\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:error-changed': {\n    clientId: string\n    error: string | null\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:messages-cleared': {\n    clientId: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:reloaded': {\n    clientId: string\n    fromMessageIndex: number\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:stopped': {\n    clientId: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:tool:result-added': {\n    clientId: string\n    toolCallId: string\n    toolName: string\n    output: any\n    state: 'output-available' | 'output-error'\n    timestamp: number\n  }\n  'tanstack-ai-devtools:tool:approval-responded': {\n    clientId: string\n    approvalId: string\n    toolCallId: string\n    approved: boolean\n    timestamp: number\n  }\n  'tanstack-ai-devtools:processor:text-updated': {\n    streamId: string\n    content: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:processor:tool-call-state-changed': {\n    streamId: string\n    toolCallId: string\n    toolName: string\n    state: ToolCallState\n    arguments: any\n    timestamp: number\n  }\n  'tanstack-ai-devtools:processor:tool-result-state-changed': {\n    streamId: string\n    toolCallId: string\n    content: any\n    state: ToolResultState\n    error?: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:assistant-message-updated': {\n    clientId: string\n    messageId: string\n    content: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:tool-call-updated': {\n    clientId: string\n    messageId: string\n    toolCallId: string\n    toolName: string\n    state: ToolCallState\n    arguments: any\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:approval-requested': {\n    clientId: string\n    messageId: string\n    toolCallId: string\n    toolName: string\n    input: any\n    approvalId: string\n    timestamp: number\n  }\n}\n\n// Helper type to strip the prefix at the type level\ntype StripPrefix<T extends string> =\n  T extends `tanstack-ai-devtools:${infer Suffix}` ? Suffix : never\n\n// Get all event names without the prefix\ntype EventSuffix = StripPrefix<keyof AIDevtoolsEventMap & string>\n\nclass AiEventClient extends EventClient<AIDevtoolsEventMap> {\n  private eventTarget: EventTarget\n\n  constructor() {\n    super({\n      pluginId: 'tanstack-ai-devtools',\n    })\n    this.eventTarget = new EventTarget()\n  }\n\n  /**\n   * Subscribe to events using both the parent EventClient and EventTarget API\n   * @param eventSuffix - The event name without the prefix (e.g., \"stream:started\")\n   * @param handler - The event handler function\n   * @param options - Optional configuration for event subscription\n   * @returns A function to unsubscribe from the event\n   */\n  override on<TSuffix extends EventSuffix>(\n    eventSuffix: TSuffix,\n    handler: (event: {\n      type: `tanstack-ai-devtools:${TSuffix}`\n      payload: AIDevtoolsEventMap[`tanstack-ai-devtools:${TSuffix}`]\n    }) => void,\n    options?: { withEventTarget?: boolean },\n  ): () => void {\n    const parentUnsubscribe = super.on(eventSuffix, handler)\n\n    const withEventTarget = options?.withEventTarget ?? true\n    let eventListener: ((event: Event) => void) | undefined\n\n    if (withEventTarget) {\n      // Create a wrapper to handle CustomEvent for EventTarget\n      eventListener = (event: Event) => {\n        if (event instanceof CustomEvent) {\n          handler({\n            type: `${eventSuffix}` as `tanstack-ai-devtools:${TSuffix}`,\n            payload: event.detail,\n          })\n        }\n      }\n\n      // Add listener to EventTarget\n      this.eventTarget.addEventListener(eventSuffix, eventListener)\n    }\n\n    // Return unsubscribe function that cleans up both subscriptions\n    return () => {\n      parentUnsubscribe()\n      if (withEventTarget && eventListener) {\n        this.eventTarget.removeEventListener(eventSuffix, eventListener)\n      }\n    }\n  }\n\n  /**\n   * Emit an event to both the parent EventClient and the EventTarget\n   * @param eventSuffix - The event name without the prefix (e.g., \"stream:started\")\n   * @param data - The event data\n   */\n  override emit<TSuffix extends EventSuffix>(\n    eventSuffix: TSuffix,\n    data: AIDevtoolsEventMap[`tanstack-ai-devtools:${TSuffix}`],\n  ): void {\n    super.emit(eventSuffix, data)\n\n    // Always dispatch to EventTarget (for local listeners)\n    const customEvent = new CustomEvent(eventSuffix, {\n      detail: data,\n    })\n    this.eventTarget.dispatchEvent(customEvent)\n  }\n\n  /**\n   * Get the underlying EventTarget for advanced use cases\n   * @returns The EventTarget instance\n   */\n  getEventTarget(): EventTarget {\n    return this.eventTarget\n  }\n}\n\nconst aiEventClient = new AiEventClient()\n\nexport { aiEventClient }\n"],"names":[],"mappings":";AAiTA,MAAM,sBAAsB,YAAgC;AAAA,EAG1D,cAAc;AACZ,UAAM;AAAA,MACJ,UAAU;AAAA,IAAA,CACX;AACD,SAAK,cAAc,IAAI,YAAA;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASS,GACP,aACA,SAIA,SACY;AACZ,UAAM,oBAAoB,MAAM,GAAG,aAAa,OAAO;AAEvD,UAAM,kBAAkB,SAAS,mBAAmB;AACpD,QAAI;AAEJ,QAAI,iBAAiB;AAEnB,sBAAgB,CAAC,UAAiB;AAChC,YAAI,iBAAiB,aAAa;AAChC,kBAAQ;AAAA,YACN,MAAM,GAAG,WAAW;AAAA,YACpB,SAAS,MAAM;AAAA,UAAA,CAChB;AAAA,QACH;AAAA,MACF;AAGA,WAAK,YAAY,iBAAiB,aAAa,aAAa;AAAA,IAC9D;AAGA,WAAO,MAAM;AACX,wBAAA;AACA,UAAI,mBAAmB,eAAe;AACpC,aAAK,YAAY,oBAAoB,aAAa,aAAa;AAAA,MACjE;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOS,KACP,aACA,MACM;AACN,UAAM,KAAK,aAAa,IAAI;AAG5B,UAAM,cAAc,IAAI,YAAY,aAAa;AAAA,MAC/C,QAAQ;AAAA,IAAA,CACT;AACD,SAAK,YAAY,cAAc,WAAW;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,iBAA8B;AAC5B,WAAO,KAAK;AAAA,EACd;AACF;AAEA,MAAM,gBAAgB,IAAI,cAAA;"}
+{"version":3,"file":"event-client.js","sources":["../../src/event-client.ts"],"sourcesContent":["import { EventClient } from '@tanstack/devtools-event-client'\n\n/**\n * Tool call states - track the lifecycle of a tool call\n * Must match @tanstack/ai-client ToolCallState\n */\ntype ToolCallState =\n  | 'awaiting-input' // Received start but no arguments yet\n  | 'input-streaming' // Partial arguments received\n  | 'input-complete' // All arguments received\n  | 'approval-requested' // Waiting for user approval\n  | 'approval-responded' // User has approved/denied\n\n/**\n * Tool result states - track the lifecycle of a tool result\n * Must match @tanstack/ai-client ToolResultState\n */\ntype ToolResultState =\n  | 'streaming' // Placeholder for future streamed output\n  | 'complete' // Result is complete\n  | 'error' // Error occurred\n\nexport interface AIDevtoolsEventMap {\n  // AI Stream events - from @tanstack/ai package\n  'tanstack-ai-devtools:stream:started': {\n    streamId: string\n    model: string\n    provider: string\n    timestamp: number\n    clientId?: string\n  }\n  'tanstack-ai-devtools:stream:chunk:content': {\n    streamId: string\n    messageId?: string\n    content: string\n    delta?: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:chunk:tool-call': {\n    streamId: string\n    messageId?: string\n    toolCallId: string\n    toolName: string\n    index: number\n    arguments: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:chunk:tool-result': {\n    streamId: string\n    messageId?: string\n    toolCallId: string\n    result: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:chunk:done': {\n    streamId: string\n    messageId?: string\n    finishReason: string | null\n    usage?: {\n      promptTokens: number\n      completionTokens: number\n      totalTokens: number\n    }\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:chunk:error': {\n    streamId: string\n    messageId?: string\n    error: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:chunk:thinking': {\n    streamId: string\n    messageId?: string\n    content: string\n    delta?: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:approval-requested': {\n    streamId: string\n    messageId?: string\n    toolCallId: string\n    toolName: string\n    input: any\n    approvalId: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:tool-input-available': {\n    streamId: string\n    messageId?: string\n    toolCallId: string\n    toolName: string\n    input: any\n    timestamp: number\n  }\n  'tanstack-ai-devtools:tool:call-completed': {\n    requestId: string\n    streamId: string\n    messageId?: string\n    toolCallId: string\n    toolName: string\n    result: any\n    duration: number\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:ended': {\n    requestId: string\n    streamId: string\n    totalChunks: number\n    duration: number\n    timestamp: number\n  }\n  'tanstack-ai-devtools:chat:started': {\n    requestId: string\n    streamId: string\n    provider: string\n    model: string\n    messageCount: number\n    hasTools: boolean\n    streaming: boolean\n    timestamp: number\n    clientId?: string\n    toolNames?: Array<string>\n    options?: Record<string, unknown>\n    providerOptions?: Record<string, unknown>\n  }\n  'tanstack-ai-devtools:chat:completed': {\n    requestId: string\n    streamId: string\n    model: string\n    content: string\n    messageId?: string\n    finishReason?: string\n    usage?: {\n      promptTokens: number\n      completionTokens: number\n      totalTokens: number\n    }\n    timestamp: number\n  }\n  'tanstack-ai-devtools:chat:iteration': {\n    requestId: string\n    streamId: string\n    iterationNumber: number\n    messageCount: number\n    toolCallCount: number\n    timestamp: number\n  }\n  'tanstack-ai-devtools:usage:tokens': {\n    requestId: string\n    streamId: string\n    model: string\n    messageId?: string\n    usage: {\n      promptTokens: number\n      completionTokens: number\n      totalTokens: number\n    }\n    timestamp: number\n  }\n\n  // Embedding events\n  'tanstack-ai-devtools:embedding:started': {\n    requestId: string\n    model: string\n    inputCount: number\n    timestamp: number\n    clientId?: string\n  }\n  'tanstack-ai-devtools:embedding:completed': {\n    requestId: string\n    model: string\n    inputCount: number\n    duration: number\n    timestamp: number\n  }\n\n  // Summarize events\n  'tanstack-ai-devtools:summarize:started': {\n    requestId: string\n    model: string\n    inputLength: number\n    timestamp: number\n    clientId?: string\n  }\n  'tanstack-ai-devtools:summarize:completed': {\n    requestId: string\n    model: string\n    inputLength: number\n    outputLength: number\n    duration: number\n    timestamp: number\n  }\n\n  // Chat Client events - from @tanstack/ai-client package\n  'tanstack-ai-devtools:client:created': {\n    clientId: string\n    initialMessageCount: number\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:message-appended': {\n    clientId: string\n    messageId: string\n    role: 'user' | 'assistant' | 'system' | 'tool'\n    contentPreview: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:message-sent': {\n    clientId: string\n    messageId: string\n    content: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:loading-changed': {\n    clientId: string\n    isLoading: boolean\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:error-changed': {\n    clientId: string\n    error: string | null\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:messages-cleared': {\n    clientId: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:reloaded': {\n    clientId: string\n    fromMessageIndex: number\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:stopped': {\n    clientId: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:tool:result-added': {\n    clientId: string\n    toolCallId: string\n    toolName: string\n    output: any\n    state: 'output-available' | 'output-error'\n    timestamp: number\n  }\n  'tanstack-ai-devtools:tool:approval-responded': {\n    clientId: string\n    approvalId: string\n    toolCallId: string\n    approved: boolean\n    timestamp: number\n  }\n  'tanstack-ai-devtools:processor:text-updated': {\n    streamId: string\n    content: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:processor:tool-call-state-changed': {\n    streamId: string\n    toolCallId: string\n    toolName: string\n    state: ToolCallState\n    arguments: any\n    timestamp: number\n  }\n  'tanstack-ai-devtools:processor:tool-result-state-changed': {\n    streamId: string\n    toolCallId: string\n    content: any\n    state: ToolResultState\n    error?: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:assistant-message-updated': {\n    clientId: string\n    messageId: string\n    content: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:tool-call-updated': {\n    clientId: string\n    messageId: string\n    toolCallId: string\n    toolName: string\n    state: ToolCallState\n    arguments: any\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:approval-requested': {\n    clientId: string\n    messageId: string\n    toolCallId: string\n    toolName: string\n    input: any\n    approvalId: string\n    timestamp: number\n  }\n}\n\nclass AiEventClient extends EventClient<AIDevtoolsEventMap> {\n  constructor() {\n    super({\n      pluginId: 'tanstack-ai-devtools',\n    })\n  }\n}\n\nconst aiEventClient = new AiEventClient()\n\nexport { aiEventClient }\n"],"names":[],"mappings":";AA0SA,MAAM,sBAAsB,YAAgC;AAAA,EAC1D,cAAc;AACZ,UAAM;AAAA,MACJ,UAAU;AAAA,IAAA,CACX;AAAA,EACH;AACF;AAEA,MAAM,gBAAgB,IAAI,cAAA;"}

package/dist/esm/types.d.ts

@@ -87,12 +87,12 @@ export interface DocumentPart<TMetadata = unknown> {
  * @template TVideoMeta - Provider-specific video metadata type
  * @template TDocumentMeta - Provider-specific document metadata type
  */
-export type ContentPart<TImageMeta = unknown, TAudioMeta = unknown, TVideoMeta = unknown, TDocumentMeta = unknown> = TextPart | ImagePart<TImageMeta> | AudioPart<TAudioMeta> | VideoPart<TVideoMeta> | DocumentPart<TDocumentMeta>;
+export type ContentPart<TImageMeta = unknown, TAudioMeta = unknown, TVideoMeta = unknown, TDocumentMeta = unknown, TTextMeta = unknown> = TextPart<TTextMeta> | ImagePart<TImageMeta> | AudioPart<TAudioMeta> | VideoPart<TVideoMeta> | DocumentPart<TDocumentMeta>;
 /**
  * Helper type to filter ContentPart union to only include specific modalities.
  * Used to constrain message content based on model capabilities.
  */
-export type ContentPartForModalities<TModalities extends Modality, TImageMeta = unknown, TAudioMeta = unknown, TVideoMeta = unknown, TDocumentMeta = unknown> = Extract<ContentPart<TImageMeta, TAudioMeta, TVideoMeta, TDocumentMeta>, {
+export type ContentPartForModalities<TModalities extends Modality, TImageMeta = unknown, TAudioMeta = unknown, TVideoMeta = unknown, TDocumentMeta = unknown, TTextMeta = unknown> = Extract<ContentPart<TImageMeta, TAudioMeta, TVideoMeta, TDocumentMeta, TTextMeta>, {
     type: TModalities;
 }>;
 /**
@@ -104,7 +104,7 @@ export type ModalitiesArrayToUnion<T extends ReadonlyArray<Modality>> = T[number
  * Type for message content constrained by supported modalities.
  * When modalities is ['text', 'image'], only TextPart and ImagePart are allowed in the array.
  */
-export type ConstrainedContent<TModalities extends ReadonlyArray<Modality>, TImageMeta = unknown, TAudioMeta = unknown, TVideoMeta = unknown, TDocumentMeta = unknown> = string | null | Array<ContentPartForModalities<ModalitiesArrayToUnion<TModalities>, TImageMeta, TAudioMeta, TVideoMeta, TDocumentMeta>>;
+export type ConstrainedContent<TModalities extends ReadonlyArray<Modality>, TImageMeta = unknown, TAudioMeta = unknown, TVideoMeta = unknown, TDocumentMeta = unknown, TTextMeta = unknown> = string | null | Array<ContentPartForModalities<ModalitiesArrayToUnion<TModalities>, TImageMeta, TAudioMeta, TVideoMeta, TDocumentMeta, TTextMeta>>;
 export interface ModelMessage<TContent extends string | null | Array<ContentPart> = string | null | Array<ContentPart>> {
     role: 'user' | 'assistant' | 'tool';
     content: TContent;
@@ -115,9 +115,10 @@ export interface ModelMessage<TContent extends string | null | Array<ContentPart
 /**
  * Message parts - building blocks of UIMessage
  */
-export interface TextPart {
+export interface TextPart<TMetadata = unknown> {
     type: 'text';
     content: string;
+    metadata?: TMetadata;
 }
 export interface ToolCallPart {
     type: 'tool-call';
@@ -160,8 +161,8 @@ export interface UIMessage {
  * A ModelMessage with content constrained to only allow content parts
  * matching the specified input modalities.
  */
-export type ConstrainedModelMessage<TModalities extends ReadonlyArray<Modality>, TImageMeta = unknown, TAudioMeta = unknown, TVideoMeta = unknown, TDocumentMeta = unknown> = Omit<ModelMessage, 'content'> & {
-    content: ConstrainedContent<TModalities, TImageMeta, TAudioMeta, TVideoMeta, TDocumentMeta>;
+export type ConstrainedModelMessage<TModalities extends ReadonlyArray<Modality>, TImageMeta = unknown, TAudioMeta = unknown, TVideoMeta = unknown, TDocumentMeta = unknown, TTextMeta = unknown> = Omit<ModelMessage, 'content'> & {
+    content: ConstrainedContent<TModalities, TImageMeta, TAudioMeta, TVideoMeta, TDocumentMeta, TTextMeta>;
 };
 /**
  * Tool/Function definition for function calling.
@@ -516,6 +517,7 @@ export interface EmbeddingResult {
  * Uses unknown for all modalities.
  */
 export interface DefaultMessageMetadataByModality {
+    text: unknown;
     image: unknown;
     audio: unknown;
     video: unknown;
@@ -534,6 +536,7 @@ export interface DefaultMessageMetadataByModality {
  * - TMessageMetadataByModality: Map from modality type to adapter-specific metadata types
  */
 export interface AIAdapter<TChatModels extends ReadonlyArray<string> = ReadonlyArray<string>, TEmbeddingModels extends ReadonlyArray<string> = ReadonlyArray<string>, TChatProviderOptions extends Record<string, any> = Record<string, any>, TEmbeddingProviderOptions extends Record<string, any> = Record<string, any>, TModelProviderOptionsByName extends Record<string, any> = Record<string, any>, TModelInputModalitiesByName extends Record<string, ReadonlyArray<Modality>> = Record<string, ReadonlyArray<Modality>>, TMessageMetadataByModality extends {
+    text: unknown;
     image: unknown;
     audio: unknown;
     video: unknown;
@@ -585,11 +588,12 @@ export type ChatStreamOptionsUnion<TAdapter extends AIAdapter<any, any, any, any
      * Metadata types are also constrained based on the adapter's metadata type definitions.
      */
     messages: TModel extends keyof ModelInputModalities ? ModelInputModalities[TModel] extends ReadonlyArray<Modality> ? MessageMetadata extends {
+        text: infer TTextMeta;
         image: infer TImageMeta;
         audio: infer TAudioMeta;
         video: infer TVideoMeta;
         document: infer TDocumentMeta;
-    } ? Array<ConstrainedModelMessage<ModelInputModalities[TModel], TImageMeta, TAudioMeta, TVideoMeta, TDocumentMeta>> : Array<ConstrainedModelMessage<ModelInputModalities[TModel]>> : Array<ModelMessage> : Array<ModelMessage>;
+    } ? Array<ConstrainedModelMessage<ModelInputModalities[TModel], TImageMeta, TAudioMeta, TVideoMeta, TDocumentMeta, TTextMeta>> : Array<ConstrainedModelMessage<ModelInputModalities[TModel]>> : Array<ModelMessage> : Array<ModelMessage>;
 } : never : never : never;
 /**
  * Chat options constrained by a specific model's capabilities.
@@ -606,11 +610,12 @@ export type ChatStreamOptionsForModel<TAdapter extends AIAdapter<any, any, any,
      * Metadata types are also constrained based on the adapter's metadata type definitions.
      */
     messages: TModel extends keyof ModelInputModalities ? ModelInputModalities[TModel] extends ReadonlyArray<Modality> ? MessageMetadata extends {
+        text: infer TTextMeta;
         image: infer TImageMeta;
         audio: infer TAudioMeta;
         video: infer TVideoMeta;
         document: infer TDocumentMeta;
-    } ? Array<ConstrainedModelMessage<ModelInputModalities[TModel], TImageMeta, TAudioMeta, TVideoMeta, TDocumentMeta>> : Array<ConstrainedModelMessage<ModelInputModalities[TModel]>> : Array<ModelMessage> : Array<ModelMessage>;
+    } ? Array<ConstrainedModelMessage<ModelInputModalities[TModel], TImageMeta, TAudioMeta, TVideoMeta, TDocumentMeta, TTextMeta>> : Array<ConstrainedModelMessage<ModelInputModalities[TModel]>> : Array<ModelMessage> : Array<ModelMessage>;
 } : never;
 export type ExtractModelsFromAdapter<T> = T extends AIAdapter<infer M, any, any, any, any, any> ? M[number] : never;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Core TanStack AI library - Open source AI SDK",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -39,7 +39,7 @@
     "embeddings"
   ],
   "dependencies": {
-    "@tanstack/devtools-event-client": "^0.3.5",
+    "@tanstack/devtools-event-client": "^0.4.0",
     "partial-json": "^0.1.7"
   },
   "peerDependencies": {

package/src/base-adapter.ts

@@ -34,6 +34,7 @@ export abstract class BaseAdapter<
     ReadonlyArray<Modality>
   > = Record<string, ReadonlyArray<Modality>>,
   TMessageMetadataByModality extends {
+    text: unknown
     image: unknown
     audio: unknown
     video: unknown

package/src/event-client.ts

@@ -296,91 +296,11 @@ export interface AIDevtoolsEventMap {
   }
 }
 
-// Helper type to strip the prefix at the type level
-type StripPrefix<T extends string> =
-  T extends `tanstack-ai-devtools:${infer Suffix}` ? Suffix : never
-
-// Get all event names without the prefix
-type EventSuffix = StripPrefix<keyof AIDevtoolsEventMap & string>
-
 class AiEventClient extends EventClient<AIDevtoolsEventMap> {
-  private eventTarget: EventTarget
-
   constructor() {
     super({
       pluginId: 'tanstack-ai-devtools',
     })
-    this.eventTarget = new EventTarget()
-  }
-
-  /**
-   * Subscribe to events using both the parent EventClient and EventTarget API
-   * @param eventSuffix - The event name without the prefix (e.g., "stream:started")
-   * @param handler - The event handler function
-   * @param options - Optional configuration for event subscription
-   * @returns A function to unsubscribe from the event
-   */
-  override on<TSuffix extends EventSuffix>(
-    eventSuffix: TSuffix,
-    handler: (event: {
-      type: `tanstack-ai-devtools:${TSuffix}`
-      payload: AIDevtoolsEventMap[`tanstack-ai-devtools:${TSuffix}`]
-    }) => void,
-    options?: { withEventTarget?: boolean },
-  ): () => void {
-    const parentUnsubscribe = super.on(eventSuffix, handler)
-
-    const withEventTarget = options?.withEventTarget ?? true
-    let eventListener: ((event: Event) => void) | undefined
-
-    if (withEventTarget) {
-      // Create a wrapper to handle CustomEvent for EventTarget
-      eventListener = (event: Event) => {
-        if (event instanceof CustomEvent) {
-          handler({
-            type: `${eventSuffix}` as `tanstack-ai-devtools:${TSuffix}`,
-            payload: event.detail,
-          })
-        }
-      }
-
-      // Add listener to EventTarget
-      this.eventTarget.addEventListener(eventSuffix, eventListener)
-    }
-
-    // Return unsubscribe function that cleans up both subscriptions
-    return () => {
-      parentUnsubscribe()
-      if (withEventTarget && eventListener) {
-        this.eventTarget.removeEventListener(eventSuffix, eventListener)
-      }
-    }
-  }
-
-  /**
-   * Emit an event to both the parent EventClient and the EventTarget
-   * @param eventSuffix - The event name without the prefix (e.g., "stream:started")
-   * @param data - The event data
-   */
-  override emit<TSuffix extends EventSuffix>(
-    eventSuffix: TSuffix,
-    data: AIDevtoolsEventMap[`tanstack-ai-devtools:${TSuffix}`],
-  ): void {
-    super.emit(eventSuffix, data)
-
-    // Always dispatch to EventTarget (for local listeners)
-    const customEvent = new CustomEvent(eventSuffix, {
-      detail: data,
-    })
-    this.eventTarget.dispatchEvent(customEvent)
-  }
-
-  /**
-   * Get the underlying EventTarget for advanced use cases
-   * @returns The EventTarget instance
-   */
-  getEventTarget(): EventTarget {
-    return this.eventTarget
   }
 }
 

package/src/types.ts

@@ -104,8 +104,9 @@ export type ContentPart<
   TAudioMeta = unknown,
   TVideoMeta = unknown,
   TDocumentMeta = unknown,
+  TTextMeta = unknown,
 > =
-  | TextPart
+  | TextPart<TTextMeta>
   | ImagePart<TImageMeta>
   | AudioPart<TAudioMeta>
   | VideoPart<TVideoMeta>
@@ -121,8 +122,9 @@ export type ContentPartForModalities<
   TAudioMeta = unknown,
   TVideoMeta = unknown,
   TDocumentMeta = unknown,
+  TTextMeta = unknown,
 > = Extract<
-  ContentPart<TImageMeta, TAudioMeta, TVideoMeta, TDocumentMeta>,
+  ContentPart<TImageMeta, TAudioMeta, TVideoMeta, TDocumentMeta, TTextMeta>,
   { type: TModalities }
 >
 
@@ -143,6 +145,7 @@ export type ConstrainedContent<
   TAudioMeta = unknown,
   TVideoMeta = unknown,
   TDocumentMeta = unknown,
+  TTextMeta = unknown,
 > =
   | string
   | null
@@ -152,7 +155,8 @@ export type ConstrainedContent<
         TImageMeta,
         TAudioMeta,
         TVideoMeta,
-        TDocumentMeta
+        TDocumentMeta,
+        TTextMeta
       >
     >
 
@@ -172,9 +176,10 @@ export interface ModelMessage<
 /**
  * Message parts - building blocks of UIMessage
  */
-export interface TextPart {
+export interface TextPart<TMetadata = unknown> {
   type: 'text'
   content: string
+  metadata?: TMetadata
 }
 
 export interface ToolCallPart {
@@ -232,13 +237,15 @@ export type ConstrainedModelMessage<
   TAudioMeta = unknown,
   TVideoMeta = unknown,
   TDocumentMeta = unknown,
+  TTextMeta = unknown,
 > = Omit<ModelMessage, 'content'> & {
   content: ConstrainedContent<
     TModalities,
     TImageMeta,
     TAudioMeta,
     TVideoMeta,
-    TDocumentMeta
+    TDocumentMeta,
+    TTextMeta
   >
 }
 
@@ -655,6 +662,7 @@ export interface EmbeddingResult {
  * Uses unknown for all modalities.
  */
 export interface DefaultMessageMetadataByModality {
+  text: unknown
   image: unknown
   audio: unknown
   video: unknown
@@ -684,6 +692,7 @@ export interface AIAdapter<
     ReadonlyArray<Modality>
   > = Record<string, ReadonlyArray<Modality>>,
   TMessageMetadataByModality extends {
+    text: unknown
     image: unknown
     audio: unknown
     video: unknown
@@ -770,6 +779,7 @@ export type ChatStreamOptionsUnion<
             messages: TModel extends keyof ModelInputModalities
               ? ModelInputModalities[TModel] extends ReadonlyArray<Modality>
                 ? MessageMetadata extends {
+                    text: infer TTextMeta
                     image: infer TImageMeta
                     audio: infer TAudioMeta
                     video: infer TVideoMeta
@@ -781,7 +791,8 @@ export type ChatStreamOptionsUnion<
                         TImageMeta,
                         TAudioMeta,
                         TVideoMeta,
-                        TDocumentMeta
+                        TDocumentMeta,
+                        TTextMeta
                       >
                     >
                   : Array<ConstrainedModelMessage<ModelInputModalities[TModel]>>
@@ -827,6 +838,7 @@ export type ChatStreamOptionsForModel<
         messages: TModel extends keyof ModelInputModalities
           ? ModelInputModalities[TModel] extends ReadonlyArray<Modality>
             ? MessageMetadata extends {
+                text: infer TTextMeta
                 image: infer TImageMeta
                 audio: infer TAudioMeta
                 video: infer TVideoMeta
@@ -838,7 +850,8 @@ export type ChatStreamOptionsForModel<
                     TImageMeta,
                     TAudioMeta,
                     TVideoMeta,
-                    TDocumentMeta
+                    TDocumentMeta,
+                    TTextMeta
                   >
                 >
               : Array<ConstrainedModelMessage<ModelInputModalities[TModel]>>