@mastra/schema-compat 1.1.3 → 1.2.0

package/dist/_types/@internal_ai-v6/dist/index.d.ts

@@ -229,10 +229,30 @@ CALL_OPTIONS
      * Timeout in milliseconds. Can be specified as a number or as an object with `totalMs`.
      */
     timeout?: TimeoutConfiguration;
+    /**
+     * Callback that is called when the agent operation begins, before any LLM calls.
+     */
+    experimental_onStart?: ToolLoopAgentOnStartCallback<TOOLS>;
+    /**
+     * Callback that is called when a step (LLM call) begins, before the provider is called.
+     */
+    experimental_onStepStart?: ToolLoopAgentOnStepStartCallback<TOOLS>;
+    /**
+     * Callback that is called before each tool execution begins.
+     */
+    experimental_onToolCallStart?: ToolLoopAgentOnToolCallStartCallback<TOOLS>;
+    /**
+     * Callback that is called after each tool execution completes.
+     */
+    experimental_onToolCallFinish?: ToolLoopAgentOnToolCallFinishCallback<TOOLS>;
     /**
      * Callback that is called when each step (LLM call) is finished, including intermediate steps.
      */
     onStepFinish?: ToolLoopAgentOnStepFinishCallback<TOOLS>;
+    /**
+     * Callback that is called when all steps are finished and the response is complete.
+     */
+    onFinish?: ToolLoopAgentOnFinishCallback<TOOLS>;
 };
 
 /**
@@ -473,7 +493,9 @@ declare namespace _ai_sdk_provider_utils {
         resolve,
         safeParseJSON,
         safeValidateTypes,
+        stripFileExtension,
         tool,
+        validateDownloadUrl,
         validateTypes,
         withUserAgentSuffix,
         withoutTrailingSlash,
@@ -595,6 +617,23 @@ declare type BaseToolCall = {
     providerMetadata?: ProviderMetadata;
 };
 
+/**
+ * Wraps a telemetry integration with bound methods.
+ * Use this when creating class-based integrations to ensure methods
+ * work correctly when passed as callbacks.
+ */
+export declare function bindTelemetryIntegration(integration: TelemetryIntegration): TelemetryIntegration;
+
+/**
+ * Common model information used across callback events.
+ */
+declare interface CallbackModelInfo {
+    /** The provider identifier (e.g., 'openai', 'anthropic'). */
+    readonly provider: string;
+    /** The specific model identifier (e.g., 'gpt-4o'). */
+    readonly modelId: string;
+}
+
 export declare function callCompletionApi({ api, prompt, credentials, headers, body, streamProtocol, setCompletion, setLoading, setError, setAbortController, onFinish, onError, fetch, }: {
     api: string;
     prompt: string;
@@ -1229,7 +1268,7 @@ export declare function createTextStreamResponse({ status, statusText, headers,
  * @param tools - Tools that were passed to the language model.
  * @param providerToolNames - Maps the provider tool ids to the provider tool names.
  */
-declare function createToolNameMapping({ tools, providerToolNames, }: {
+declare function createToolNameMapping({ tools, providerToolNames, resolveProviderToolName, }: {
     /**
      * Tools that were passed to the language model.
      */
@@ -1238,6 +1277,11 @@ declare function createToolNameMapping({ tools, providerToolNames, }: {
      * Maps the provider tool ids to the provider tool names.
      */
     providerToolNames: Record<`${string}.${string}`, string>;
+    /**
+     * Optional resolver for provider tool names that cannot be represented as
+     * static id -> name mappings (e.g. dynamic provider names).
+     */
+    resolveProviderToolName?: (tool: LanguageModelV3ProviderTool) => string | undefined;
 }): ToolNameMapping;
 
 export declare type CreateUIMessage<UI_MESSAGE extends UIMessage> = Omit<UI_MESSAGE, 'id' | 'role'> & {
@@ -2746,13 +2790,13 @@ declare interface GatewayCreditsResponse {
     totalUsed: string;
 }
 
-declare type GatewayEmbeddingModelId = 'alibaba/qwen3-embedding-0.6b' | 'alibaba/qwen3-embedding-4b' | 'alibaba/qwen3-embedding-8b' | 'amazon/titan-embed-text-v2' | 'cohere/embed-v4.0' | 'google/gemini-embedding-001' | 'google/text-embedding-005' | 'google/text-multilingual-embedding-002' | 'mistral/codestral-embed' | 'mistral/mistral-embed' | 'openai/text-embedding-3-large' | 'openai/text-embedding-3-small' | 'openai/text-embedding-ada-002' | 'voyage/voyage-3-large' | 'voyage/voyage-3.5' | 'voyage/voyage-3.5-lite' | 'voyage/voyage-code-2' | 'voyage/voyage-code-3' | 'voyage/voyage-finance-2' | 'voyage/voyage-law-2' | (string & {});
+declare type GatewayEmbeddingModelId = 'alibaba/qwen3-embedding-0.6b' | 'alibaba/qwen3-embedding-4b' | 'alibaba/qwen3-embedding-8b' | 'amazon/titan-embed-text-v2' | 'cohere/embed-v4.0' | 'google/gemini-embedding-001' | 'google/text-embedding-005' | 'google/text-multilingual-embedding-002' | 'mistral/codestral-embed' | 'mistral/mistral-embed' | 'openai/text-embedding-3-large' | 'openai/text-embedding-3-small' | 'openai/text-embedding-ada-002' | 'voyage/voyage-3-large' | 'voyage/voyage-3.5' | 'voyage/voyage-3.5-lite' | 'voyage/voyage-4' | 'voyage/voyage-4-large' | 'voyage/voyage-4-lite' | 'voyage/voyage-code-2' | 'voyage/voyage-code-3' | 'voyage/voyage-finance-2' | 'voyage/voyage-law-2' | (string & {});
 
 declare interface GatewayFetchMetadataResponse {
     models: GatewayLanguageModelEntry[];
 }
 
-declare type GatewayImageModelId = 'bfl/flux-kontext-max' | 'bfl/flux-kontext-pro' | 'bfl/flux-pro-1.0-fill' | 'bfl/flux-pro-1.1' | 'bfl/flux-pro-1.1-ultra' | 'google/imagen-4.0-fast-generate-001' | 'google/imagen-4.0-generate-001' | 'google/imagen-4.0-ultra-generate-001' | 'recraft/recraft-v2' | 'recraft/recraft-v3' | 'recraft/recraft-v4' | 'recraft/recraft-v4-pro' | 'xai/grok-imagine-image' | 'xai/grok-imagine-image-pro' | (string & {});
+declare type GatewayImageModelId = 'bfl/flux-kontext-max' | 'bfl/flux-kontext-pro' | 'bfl/flux-pro-1.0-fill' | 'bfl/flux-pro-1.1' | 'bfl/flux-pro-1.1-ultra' | 'google/imagen-4.0-fast-generate-001' | 'google/imagen-4.0-generate-001' | 'google/imagen-4.0-ultra-generate-001' | 'openai/gpt-image-1' | 'openai/gpt-image-1-mini' | 'openai/gpt-image-1.5' | 'recraft/recraft-v2' | 'recraft/recraft-v3' | 'recraft/recraft-v4' | 'recraft/recraft-v4-pro' | 'xai/grok-imagine-image' | 'xai/grok-imagine-image-pro' | (string & {});
 
 declare interface GatewayLanguageModelEntry {
     /**
@@ -2803,7 +2847,7 @@ declare interface GatewayLanguageModelEntry {
 
 declare type GatewayLanguageModelSpecification = Pick<LanguageModelV3, 'specificationVersion' | 'provider' | 'modelId'>;
 
-export declare type GatewayModelId = 'alibaba/qwen-3-14b' | 'alibaba/qwen-3-235b' | 'alibaba/qwen-3-30b' | 'alibaba/qwen-3-32b' | 'alibaba/qwen3-235b-a22b-thinking' | 'alibaba/qwen3-coder' | 'alibaba/qwen3-coder-30b-a3b' | 'alibaba/qwen3-coder-next' | 'alibaba/qwen3-coder-plus' | 'alibaba/qwen3-max' | 'alibaba/qwen3-max-preview' | 'alibaba/qwen3-max-thinking' | 'alibaba/qwen3-next-80b-a3b-instruct' | 'alibaba/qwen3-next-80b-a3b-thinking' | 'alibaba/qwen3-vl-instruct' | 'alibaba/qwen3-vl-thinking' | 'alibaba/qwen3.5-plus' | 'amazon/nova-2-lite' | 'amazon/nova-lite' | 'amazon/nova-micro' | 'amazon/nova-pro' | 'anthropic/claude-3-haiku' | 'anthropic/claude-3-opus' | 'anthropic/claude-3.5-haiku' | 'anthropic/claude-3.5-sonnet' | 'anthropic/claude-3.5-sonnet-20240620' | 'anthropic/claude-3.7-sonnet' | 'anthropic/claude-haiku-4.5' | 'anthropic/claude-opus-4' | 'anthropic/claude-opus-4.1' | 'anthropic/claude-opus-4.5' | 'anthropic/claude-opus-4.6' | 'anthropic/claude-sonnet-4' | 'anthropic/claude-sonnet-4.5' | 'anthropic/claude-sonnet-4.6' | 'arcee-ai/trinity-large-preview' | 'arcee-ai/trinity-mini' | 'bytedance/seed-1.6' | 'bytedance/seed-1.8' | 'cohere/command-a' | 'deepseek/deepseek-r1' | 'deepseek/deepseek-v3' | 'deepseek/deepseek-v3.1' | 'deepseek/deepseek-v3.1-terminus' | 'deepseek/deepseek-v3.2' | 'deepseek/deepseek-v3.2-thinking' | 'google/gemini-2.0-flash' | 'google/gemini-2.0-flash-lite' | 'google/gemini-2.5-flash' | 'google/gemini-2.5-flash-image' | 'google/gemini-2.5-flash-lite' | 'google/gemini-2.5-flash-lite-preview-09-2025' | 'google/gemini-2.5-flash-preview-09-2025' | 'google/gemini-2.5-pro' | 'google/gemini-3-flash' | 'google/gemini-3-pro-image' | 'google/gemini-3-pro-preview' | 'google/gemini-3.1-pro-preview' | 'inception/mercury-coder-small' | 'kwaipilot/kat-coder-pro-v1' | 'meituan/longcat-flash-chat' | 'meituan/longcat-flash-thinking' | 'meta/llama-3.1-70b' | 'meta/llama-3.1-8b' | 'meta/llama-3.2-11b' | 'meta/llama-3.2-1b' | 'meta/llama-3.2-3b' | 'meta/llama-3.2-90b' | 'meta/llama-3.3-70b' | 'meta/llama-4-maverick' | 'meta/llama-4-scout' | 'minimax/minimax-m2' | 'minimax/minimax-m2.1' | 'minimax/minimax-m2.1-lightning' | 'minimax/minimax-m2.5' | 'mistral/codestral' | 'mistral/devstral-2' | 'mistral/devstral-small' | 'mistral/devstral-small-2' | 'mistral/magistral-medium' | 'mistral/magistral-small' | 'mistral/ministral-14b' | 'mistral/ministral-3b' | 'mistral/ministral-8b' | 'mistral/mistral-large-3' | 'mistral/mistral-medium' | 'mistral/mistral-nemo' | 'mistral/mistral-small' | 'mistral/mixtral-8x22b-instruct' | 'mistral/pixtral-12b' | 'mistral/pixtral-large' | 'moonshotai/kimi-k2' | 'moonshotai/kimi-k2-0905' | 'moonshotai/kimi-k2-thinking' | 'moonshotai/kimi-k2-thinking-turbo' | 'moonshotai/kimi-k2-turbo' | 'moonshotai/kimi-k2.5' | 'morph/morph-v3-fast' | 'morph/morph-v3-large' | 'nvidia/nemotron-3-nano-30b-a3b' | 'nvidia/nemotron-nano-12b-v2-vl' | 'nvidia/nemotron-nano-9b-v2' | 'openai/codex-mini' | 'openai/gpt-3.5-turbo' | 'openai/gpt-3.5-turbo-instruct' | 'openai/gpt-4-turbo' | 'openai/gpt-4.1' | 'openai/gpt-4.1-mini' | 'openai/gpt-4.1-nano' | 'openai/gpt-4o' | 'openai/gpt-4o-mini' | 'openai/gpt-4o-mini-search-preview' | 'openai/gpt-5' | 'openai/gpt-5-chat' | 'openai/gpt-5-codex' | 'openai/gpt-5-mini' | 'openai/gpt-5-nano' | 'openai/gpt-5-pro' | 'openai/gpt-5.1-codex' | 'openai/gpt-5.1-codex-max' | 'openai/gpt-5.1-codex-mini' | 'openai/gpt-5.1-instant' | 'openai/gpt-5.1-thinking' | 'openai/gpt-5.2' | 'openai/gpt-5.2-chat' | 'openai/gpt-5.2-codex' | 'openai/gpt-5.2-pro' | 'openai/gpt-oss-120b' | 'openai/gpt-oss-20b' | 'openai/gpt-oss-safeguard-20b' | 'openai/o1' | 'openai/o3' | 'openai/o3-deep-research' | 'openai/o3-mini' | 'openai/o3-pro' | 'openai/o4-mini' | 'perplexity/sonar' | 'perplexity/sonar-pro' | 'perplexity/sonar-reasoning' | 'perplexity/sonar-reasoning-pro' | 'prime-intellect/intellect-3' | 'vercel/v0-1.0-md' | 'vercel/v0-1.5-md' | 'xai/grok-2-vision' | 'xai/grok-3' | 'xai/grok-3-fast' | 'xai/grok-3-mini' | 'xai/grok-3-mini-fast' | 'xai/grok-4' | 'xai/grok-4-fast-non-reasoning' | 'xai/grok-4-fast-reasoning' | 'xai/grok-4.1-fast-non-reasoning' | 'xai/grok-4.1-fast-reasoning' | 'xai/grok-code-fast-1' | 'xiaomi/mimo-v2-flash' | 'zai/glm-4.5' | 'zai/glm-4.5-air' | 'zai/glm-4.5v' | 'zai/glm-4.6' | 'zai/glm-4.6v' | 'zai/glm-4.6v-flash' | 'zai/glm-4.7' | 'zai/glm-4.7-flashx' | 'zai/glm-5' | (string & {});
+export declare type GatewayModelId = 'alibaba/qwen-3-14b' | 'alibaba/qwen-3-235b' | 'alibaba/qwen-3-30b' | 'alibaba/qwen-3-32b' | 'alibaba/qwen3-235b-a22b-thinking' | 'alibaba/qwen3-coder' | 'alibaba/qwen3-coder-30b-a3b' | 'alibaba/qwen3-coder-next' | 'alibaba/qwen3-coder-plus' | 'alibaba/qwen3-max' | 'alibaba/qwen3-max-preview' | 'alibaba/qwen3-max-thinking' | 'alibaba/qwen3-next-80b-a3b-instruct' | 'alibaba/qwen3-next-80b-a3b-thinking' | 'alibaba/qwen3-vl-instruct' | 'alibaba/qwen3-vl-thinking' | 'alibaba/qwen3.5-flash' | 'alibaba/qwen3.5-plus' | 'amazon/nova-2-lite' | 'amazon/nova-lite' | 'amazon/nova-micro' | 'amazon/nova-pro' | 'anthropic/claude-3-haiku' | 'anthropic/claude-3-opus' | 'anthropic/claude-3.5-haiku' | 'anthropic/claude-3.5-sonnet' | 'anthropic/claude-3.5-sonnet-20240620' | 'anthropic/claude-3.7-sonnet' | 'anthropic/claude-haiku-4.5' | 'anthropic/claude-opus-4' | 'anthropic/claude-opus-4.1' | 'anthropic/claude-opus-4.5' | 'anthropic/claude-opus-4.6' | 'anthropic/claude-sonnet-4' | 'anthropic/claude-sonnet-4.5' | 'anthropic/claude-sonnet-4.6' | 'arcee-ai/trinity-large-preview' | 'arcee-ai/trinity-mini' | 'bytedance/seed-1.6' | 'bytedance/seed-1.8' | 'cohere/command-a' | 'deepseek/deepseek-r1' | 'deepseek/deepseek-v3' | 'deepseek/deepseek-v3.1' | 'deepseek/deepseek-v3.1-terminus' | 'deepseek/deepseek-v3.2' | 'deepseek/deepseek-v3.2-thinking' | 'google/gemini-2.0-flash' | 'google/gemini-2.0-flash-lite' | 'google/gemini-2.5-flash' | 'google/gemini-2.5-flash-image' | 'google/gemini-2.5-flash-lite' | 'google/gemini-2.5-flash-lite-preview-09-2025' | 'google/gemini-2.5-flash-preview-09-2025' | 'google/gemini-2.5-pro' | 'google/gemini-3-flash' | 'google/gemini-3-pro-image' | 'google/gemini-3-pro-preview' | 'google/gemini-3.1-flash-image-preview' | 'google/gemini-3.1-flash-lite-preview' | 'google/gemini-3.1-pro-preview' | 'inception/mercury-coder-small' | 'kwaipilot/kat-coder-pro-v1' | 'meituan/longcat-flash-chat' | 'meituan/longcat-flash-thinking' | 'meta/llama-3.1-70b' | 'meta/llama-3.1-8b' | 'meta/llama-3.2-11b' | 'meta/llama-3.2-1b' | 'meta/llama-3.2-3b' | 'meta/llama-3.2-90b' | 'meta/llama-3.3-70b' | 'meta/llama-4-maverick' | 'meta/llama-4-scout' | 'minimax/minimax-m2' | 'minimax/minimax-m2.1' | 'minimax/minimax-m2.1-lightning' | 'minimax/minimax-m2.5' | 'mistral/codestral' | 'mistral/devstral-2' | 'mistral/devstral-small' | 'mistral/devstral-small-2' | 'mistral/magistral-medium' | 'mistral/magistral-small' | 'mistral/ministral-14b' | 'mistral/ministral-3b' | 'mistral/ministral-8b' | 'mistral/mistral-large-3' | 'mistral/mistral-medium' | 'mistral/mistral-nemo' | 'mistral/mistral-small' | 'mistral/mixtral-8x22b-instruct' | 'mistral/pixtral-12b' | 'mistral/pixtral-large' | 'moonshotai/kimi-k2' | 'moonshotai/kimi-k2-0905' | 'moonshotai/kimi-k2-thinking' | 'moonshotai/kimi-k2-thinking-turbo' | 'moonshotai/kimi-k2-turbo' | 'moonshotai/kimi-k2.5' | 'morph/morph-v3-fast' | 'morph/morph-v3-large' | 'nvidia/nemotron-3-nano-30b-a3b' | 'nvidia/nemotron-nano-12b-v2-vl' | 'nvidia/nemotron-nano-9b-v2' | 'openai/codex-mini' | 'openai/gpt-3.5-turbo' | 'openai/gpt-3.5-turbo-instruct' | 'openai/gpt-4-turbo' | 'openai/gpt-4.1' | 'openai/gpt-4.1-mini' | 'openai/gpt-4.1-nano' | 'openai/gpt-4o' | 'openai/gpt-4o-mini' | 'openai/gpt-4o-mini-search-preview' | 'openai/gpt-5' | 'openai/gpt-5-chat' | 'openai/gpt-5-codex' | 'openai/gpt-5-mini' | 'openai/gpt-5-nano' | 'openai/gpt-5-pro' | 'openai/gpt-5.1-codex' | 'openai/gpt-5.1-codex-max' | 'openai/gpt-5.1-codex-mini' | 'openai/gpt-5.1-instant' | 'openai/gpt-5.1-thinking' | 'openai/gpt-5.2' | 'openai/gpt-5.2-chat' | 'openai/gpt-5.2-codex' | 'openai/gpt-5.2-pro' | 'openai/gpt-5.3-chat' | 'openai/gpt-5.3-codex' | 'openai/gpt-oss-120b' | 'openai/gpt-oss-20b' | 'openai/gpt-oss-safeguard-20b' | 'openai/o1' | 'openai/o3' | 'openai/o3-deep-research' | 'openai/o3-mini' | 'openai/o3-pro' | 'openai/o4-mini' | 'perplexity/sonar' | 'perplexity/sonar-pro' | 'perplexity/sonar-reasoning' | 'perplexity/sonar-reasoning-pro' | 'prime-intellect/intellect-3' | 'vercel/v0-1.0-md' | 'vercel/v0-1.5-md' | 'xai/grok-2-vision' | 'xai/grok-3' | 'xai/grok-3-fast' | 'xai/grok-3-mini' | 'xai/grok-3-mini-fast' | 'xai/grok-4' | 'xai/grok-4-fast-non-reasoning' | 'xai/grok-4-fast-reasoning' | 'xai/grok-4.1-fast-non-reasoning' | 'xai/grok-4.1-fast-reasoning' | 'xai/grok-code-fast-1' | 'xiaomi/mimo-v2-flash' | 'zai/glm-4.5' | 'zai/glm-4.5-air' | 'zai/glm-4.5v' | 'zai/glm-4.6' | 'zai/glm-4.6v' | 'zai/glm-4.6v-flash' | 'zai/glm-4.7' | 'zai/glm-4.7-flashx' | 'zai/glm-5' | (string & {});
 
 declare interface GatewayProvider extends ProviderV3 {
     (modelId: GatewayModelId): LanguageModelV3;
@@ -2904,7 +2948,7 @@ declare const gatewayTools: {
     perplexitySearch: (config?: PerplexitySearchConfig) => ReturnType<typeof perplexitySearchToolFactory>;
 };
 
-declare type GatewayVideoModelId = 'alibaba/wan-v2.5-t2v-preview' | 'alibaba/wan-v2.6-i2v' | 'alibaba/wan-v2.6-i2v-flash' | 'alibaba/wan-v2.6-r2v' | 'alibaba/wan-v2.6-r2v-flash' | 'alibaba/wan-v2.6-t2v' | 'google/veo-3.0-fast-generate-001' | 'google/veo-3.0-generate-001' | 'google/veo-3.1-fast-generate-001' | 'google/veo-3.1-generate-001' | 'klingai/kling-v2.5-turbo-i2v' | 'klingai/kling-v2.5-turbo-t2v' | 'klingai/kling-v2.6-i2v' | 'klingai/kling-v2.6-t2v' | 'klingai/kling-v3.0-i2v' | 'klingai/kling-v3.0-t2v' | 'xai/grok-imagine-video' | (string & {});
+declare type GatewayVideoModelId = 'alibaba/wan-v2.5-t2v-preview' | 'alibaba/wan-v2.6-i2v' | 'alibaba/wan-v2.6-i2v-flash' | 'alibaba/wan-v2.6-r2v' | 'alibaba/wan-v2.6-r2v-flash' | 'alibaba/wan-v2.6-t2v' | 'bytedance/seedance-v1.0-lite-i2v' | 'bytedance/seedance-v1.0-lite-t2v' | 'bytedance/seedance-v1.0-pro' | 'bytedance/seedance-v1.0-pro-fast' | 'bytedance/seedance-v1.5-pro' | 'google/veo-3.0-fast-generate-001' | 'google/veo-3.0-generate-001' | 'google/veo-3.1-fast-generate-001' | 'google/veo-3.1-generate-001' | 'klingai/kling-v2.5-turbo-i2v' | 'klingai/kling-v2.5-turbo-t2v' | 'klingai/kling-v2.6-i2v' | 'klingai/kling-v2.6-motion-control' | 'klingai/kling-v2.6-t2v' | 'klingai/kling-v3.0-i2v' | 'klingai/kling-v3.0-t2v' | 'xai/grok-imagine-video' | (string & {});
 
 /**
  * A generated audio file.
@@ -3419,6 +3463,14 @@ export declare function generateText<TOOLS extends ToolSet, OUTPUT extends Outpu
     };
 }): Promise<GenerateTextResult<TOOLS, OUTPUT>>;
 
+/**
+ * Include settings for generateText (requestBody and responseBody).
+ */
+declare type GenerateTextIncludeSettings = {
+    requestBody?: boolean;
+    responseBody?: boolean;
+};
+
 /**
  * Callback that is set using the `onFinish` option.
  *
@@ -3427,55 +3479,8 @@ export declare function generateText<TOOLS extends ToolSet, OUTPUT extends Outpu
  * aggregated data from all steps.
  *
  * @param event - The final result along with aggregated step data.
- *
- * Inherited from StepResult (reflects the final step):
- * @param event.content - Array of content parts from the final step.
- * @param event.text - The generated text from the final step.
- * @param event.reasoning - Array of reasoning parts from the final step.
- * @param event.reasoningText - Combined reasoning text from the final step.
- * @param event.files - Array of generated files from the final step.
- * @param event.sources - Array of sources from the final step.
- * @param event.toolCalls - Array of tool calls from the final step.
- * @param event.toolResults - Array of tool results from the final step.
- * @param event.finishReason - Finish reason from the final step.
- * @param event.usage - Token usage from the final step only.
- * @param event.warnings - Warnings from the final step.
- * @param event.request - Request metadata from the final step.
- * @param event.response - Response metadata from the final step.
- * @param event.providerMetadata - Provider metadata from the final step.
- *
- * Additional properties:
- * @param event.steps - Array containing results from all steps in the generation.
- * @param event.totalUsage - Aggregated token usage across all steps.
- * @param event.experimental_context - The final state of the user-defined context object.
- * @param event.functionId - Identifier from telemetry settings for grouping related operations.
- * @param event.metadata - Additional metadata from telemetry settings.
- */
-export declare type GenerateTextOnFinishCallback<TOOLS extends ToolSet> = (event: StepResult<TOOLS> & {
-    /**
-     * Array containing results from all steps in the generation.
-     */
-    readonly steps: StepResult<TOOLS>[];
-    /**
-     * Aggregated token usage across all steps.
-     * This is the sum of the usage from each individual step.
-     */
-    readonly totalUsage: LanguageModelUsage;
-    /**
-     * The final state of the user-defined context object.
-     * This reflects any modifications made during the generation lifecycle
-     * via `prepareStep` or tool execution.
-     *
-     * Experimental (can break in patch releases).
-     *
-     * @default undefined
-     */
-    experimental_context: unknown;
-    /** Identifier from telemetry settings for grouping related operations. */
-    readonly functionId: string | undefined;
-    /** Additional metadata from telemetry settings. */
-    readonly metadata: Record<string, unknown> | undefined;
-}) => PromiseLike<void> | void;
+ */
+export declare type GenerateTextOnFinishCallback<TOOLS extends ToolSet> = (event: OnFinishEvent<TOOLS>) => PromiseLike<void> | void;
 
 /**
  * Callback that is set using the `experimental_onStart` option.
@@ -3486,80 +3491,7 @@ export declare type GenerateTextOnFinishCallback<TOOLS extends ToolSet> = (event
  *
  * @param event - The event object containing generation configuration.
  */
-export declare type GenerateTextOnStartCallback<TOOLS extends ToolSet = ToolSet, OUTPUT extends Output_2 = Output_2> = (event: {
-    /** The model being used for generation. */
-    readonly model: {
-        /** The provider identifier (e.g., 'openai', 'anthropic'). */
-        readonly provider: string;
-        /** The specific model identifier (e.g., 'gpt-4o'). */
-        readonly modelId: string;
-    };
-    /** The system message(s) provided to the model. */
-    readonly system: string | SystemModelMessage | Array<SystemModelMessage> | undefined;
-    /** The prompt string or array of messages if using the prompt option. */
-    readonly prompt: string | Array<ModelMessage> | undefined;
-    /** The messages array if using the messages option. */
-    readonly messages: Array<ModelMessage> | undefined;
-    /** The tools available for this generation. */
-    readonly tools: TOOLS | undefined;
-    /** The tool choice strategy for this generation. */
-    readonly toolChoice: ToolChoice<NoInfer<TOOLS>> | undefined;
-    /** Limits which tools are available for the model to call. */
-    readonly activeTools: Array<keyof TOOLS> | undefined;
-    /** Maximum number of tokens to generate. */
-    readonly maxOutputTokens: number | undefined;
-    /** Sampling temperature for generation. */
-    readonly temperature: number | undefined;
-    /** Top-p (nucleus) sampling parameter. */
-    readonly topP: number | undefined;
-    /** Top-k sampling parameter. */
-    readonly topK: number | undefined;
-    /** Presence penalty for generation. */
-    readonly presencePenalty: number | undefined;
-    /** Frequency penalty for generation. */
-    readonly frequencyPenalty: number | undefined;
-    /** Sequences that will stop generation. */
-    readonly stopSequences: string[] | undefined;
-    /** Random seed for reproducible generation. */
-    readonly seed: number | undefined;
-    /** Maximum number of retries for failed requests. */
-    readonly maxRetries: number;
-    /**
-     * Timeout configuration for the generation.
-     * Can be a number (milliseconds) or an object with totalMs, stepMs, chunkMs.
-     */
-    readonly timeout: TimeoutConfiguration | undefined;
-    /** Additional HTTP headers sent with the request. */
-    readonly headers: Record<string, string | undefined> | undefined;
-    /** Additional provider-specific options. */
-    readonly providerOptions: ProviderOptions | undefined;
-    /**
-     * Condition(s) for stopping the generation.
-     * When the condition is an array, any of the conditions can be met to stop.
-     */
-    readonly stopWhen: StopCondition<TOOLS> | Array<StopCondition<TOOLS>> | undefined;
-    /** The output specification for structured outputs, if configured. */
-    readonly output: OUTPUT | undefined;
-    /** Abort signal for cancelling the operation. */
-    readonly abortSignal: AbortSignal | undefined;
-    /**
-     * Settings for controlling what data is included in step results.
-     * `requestBody` and `responseBody` control whether these are retained.
-     */
-    readonly include: {
-        requestBody?: boolean;
-        responseBody?: boolean;
-    } | undefined;
-    /** Identifier from telemetry settings for grouping related operations. */
-    readonly functionId: string | undefined;
-    /** Additional metadata passed to the generation. */
-    readonly metadata: Record<string, unknown> | undefined;
-    /**
-     * User-defined context object that flows through the entire generation lifecycle.
-     * Can be accessed and modified in `prepareStep` and tool `execute` functions.
-     */
-    readonly experimental_context: unknown;
-}) => PromiseLike<void> | void;
+export declare type GenerateTextOnStartCallback<TOOLS extends ToolSet = ToolSet, OUTPUT extends Output_2 = Output_2> = (event: OnStartEvent<TOOLS, OUTPUT, GenerateTextIncludeSettings>) => PromiseLike<void> | void;
 
 /**
  * Callback that is set using the `onStepFinish` option.
@@ -3569,7 +3501,7 @@ export declare type GenerateTextOnStartCallback<TOOLS extends ToolSet = ToolSet,
  *
  * @param stepResult - The result of the step.
  */
-export declare type GenerateTextOnStepFinishCallback<TOOLS extends ToolSet> = (stepResult: StepResult<TOOLS>) => Promise<void> | void;
+export declare type GenerateTextOnStepFinishCallback<TOOLS extends ToolSet> = (event: OnStepFinishEvent<TOOLS>) => Promise<void> | void;
 
 /**
  * Callback that is set using the `experimental_onStepStart` option.
@@ -3580,68 +3512,7 @@ export declare type GenerateTextOnStepFinishCallback<TOOLS extends ToolSet> = (s
  *
  * @param event - The event object containing step configuration.
  */
-export declare type GenerateTextOnStepStartCallback<TOOLS extends ToolSet = ToolSet, OUTPUT extends Output_2 = Output_2> = (event: {
-    /** Zero-based index of the current step. */
-    readonly stepNumber: number;
-    /** The model being used for this step. */
-    readonly model: {
-        /** The provider identifier. */
-        readonly provider: string;
-        /** The specific model identifier. */
-        readonly modelId: string;
-    };
-    /**
-     * The system message for this step.
-     */
-    readonly system: string | SystemModelMessage | Array<SystemModelMessage> | undefined;
-    /**
-     * The messages that will be sent to the model for this step.
-     * Uses the user-facing `ModelMessage` format.
-     * May be overridden by prepareStep.
-     */
-    readonly messages: Array<ModelMessage>;
-    /** The tools available for this generation. */
-    readonly tools: TOOLS | undefined;
-    /** The tool choice configuration for this step. */
-    readonly toolChoice: LanguageModelV3ToolChoice | undefined;
-    /** Limits which tools are available for this step. */
-    readonly activeTools: Array<keyof TOOLS> | undefined;
-    /** Array of results from previous steps (empty for first step). */
-    readonly steps: ReadonlyArray<StepResult<TOOLS>>;
-    /** Additional provider-specific options for this step. */
-    readonly providerOptions: ProviderOptions | undefined;
-    /**
-     * Timeout configuration for the generation.
-     * Can be a number (milliseconds) or an object with totalMs, stepMs, chunkMs.
-     */
-    readonly timeout: TimeoutConfiguration | undefined;
-    /** Additional HTTP headers sent with the request. */
-    readonly headers: Record<string, string | undefined> | undefined;
-    /**
-     * Condition(s) for stopping the generation.
-     * When the condition is an array, any of the conditions can be met to stop.
-     */
-    readonly stopWhen: StopCondition<TOOLS> | Array<StopCondition<TOOLS>> | undefined;
-    /** The output specification for structured outputs, if configured. */
-    readonly output: OUTPUT | undefined;
-    /** Abort signal for cancelling the operation. */
-    readonly abortSignal: AbortSignal | undefined;
-    /**
-     * Settings for controlling what data is included in step results.
-     */
-    readonly include: {
-        requestBody?: boolean;
-        responseBody?: boolean;
-    } | undefined;
-    /** Identifier from telemetry settings for grouping related operations. */
-    readonly functionId: string | undefined;
-    /** Additional metadata from telemetry settings. */
-    readonly metadata: Record<string, unknown> | undefined;
-    /**
-     * User-defined context object. May be updated from `prepareStep` between steps.
-     */
-    readonly experimental_context: unknown;
-}) => PromiseLike<void> | void;
+export declare type GenerateTextOnStepStartCallback<TOOLS extends ToolSet = ToolSet, OUTPUT extends Output_2 = Output_2> = (event: OnStepStartEvent<TOOLS, OUTPUT, GenerateTextIncludeSettings>) => PromiseLike<void> | void;
 
 /**
  * Callback that is set using the `experimental_onToolCallFinish` option.
@@ -3654,56 +3525,8 @@ export declare type GenerateTextOnStepStartCallback<TOOLS extends ToolSet = Tool
  * - When `success: false`: `error` contains the error, `output` is never present.
  *
  * @param event - The event object containing tool call result information.
- * @param event.stepNumber - Zero-based index of the current step where this tool call occurred.
- * @param event.model - Information about the model being used (provider and modelId).
- * @param event.toolCall - The full tool call object containing toolName, toolCallId, input, and metadata.
- * @param event.messages - The conversation messages available at tool execution time.
- * @param event.abortSignal - Signal for cancelling the operation.
- * @param event.durationMs - Execution time of the tool call in milliseconds.
- * @param event.functionId - Identifier from telemetry settings for grouping related operations.
- * @param event.metadata - Additional metadata from telemetry settings.
- * @param event.experimental_context - User-defined context object flowing through the generation.
- * @param event.success - Discriminator indicating whether the tool call succeeded.
- * @param event.output - The tool's return value (only present when `success: true`).
- * @param event.error - The error that occurred (only present when `success: false`).
- */
-export declare type GenerateTextOnToolCallFinishCallback<TOOLS extends ToolSet = ToolSet> = (event: {
-    /** Zero-based index of the current step where this tool call occurred. May be undefined in streaming contexts. */
-    readonly stepNumber: number | undefined;
-    /** Information about the model being used. May be undefined in streaming contexts. */
-    readonly model: {
-        /** The provider of the model. */
-        readonly provider: string;
-        /** The ID of the model. */
-        readonly modelId: string;
-    } | undefined;
-    /** The full tool call object. */
-    readonly toolCall: TypedToolCall<TOOLS>;
-    /** The conversation messages available at tool execution time. */
-    readonly messages: Array<ModelMessage>;
-    /** Signal for cancelling the operation. */
-    readonly abortSignal: AbortSignal | undefined;
-    /** Execution time of the tool call in milliseconds. */
-    readonly durationMs: number;
-    /** Identifier from telemetry settings for grouping related operations. */
-    readonly functionId: string | undefined;
-    /** Additional metadata from telemetry settings. */
-    readonly metadata: Record<string, unknown> | undefined;
-    /** User-defined context object flowing through the generation. */
-    readonly experimental_context: unknown;
-} & ({
-    /** Indicates the tool call succeeded. */
-    readonly success: true;
-    /** The tool's return value. */
-    readonly output: unknown;
-    readonly error?: never;
-} | {
-    /** Indicates the tool call failed. */
-    readonly success: false;
-    readonly output?: never;
-    /** The error that occurred during tool execution. */
-    readonly error: unknown;
-})) => PromiseLike<void> | void;
+ */
+export declare type GenerateTextOnToolCallFinishCallback<TOOLS extends ToolSet = ToolSet> = (event: OnToolCallFinishEvent<TOOLS>) => PromiseLike<void> | void;
 
 /**
  * Callback that is set using the `experimental_onToolCallStart` option.
@@ -3712,38 +3535,8 @@ export declare type GenerateTextOnToolCallFinishCallback<TOOLS extends ToolSet =
  * Use this for logging tool invocations, tracking tool usage, or pre-execution validation.
  *
  * @param event - The event object containing tool call information.
- * @param event.stepNumber - Zero-based index of the current step where this tool call occurs.
- * @param event.model - Information about the model being used (provider and modelId).
- * @param event.toolCall - The full tool call object containing toolName, toolCallId, input, and metadata.
- * @param event.messages - The conversation messages available at tool execution time.
- * @param event.abortSignal - Signal for cancelling the operation.
- * @param event.functionId - Identifier from telemetry settings for grouping related operations.
- * @param event.metadata - Additional metadata from telemetry settings.
- * @param event.experimental_context - User-defined context object flowing through the generation.
- */
-export declare type GenerateTextOnToolCallStartCallback<TOOLS extends ToolSet = ToolSet> = (event: {
-    /** Zero-based index of the current step where this tool call occurs. May be undefined in streaming contexts. */
-    readonly stepNumber: number | undefined;
-    /** Information about the model being used. May be undefined in streaming contexts. */
-    readonly model: {
-        /** The provider of the model. */
-        readonly provider: string;
-        /** The ID of the model. */
-        readonly modelId: string;
-    } | undefined;
-    /** The full tool call object. */
-    readonly toolCall: TypedToolCall<TOOLS>;
-    /** The conversation messages available at tool execution time. */
-    readonly messages: Array<ModelMessage>;
-    /** Signal for cancelling the operation. */
-    readonly abortSignal: AbortSignal | undefined;
-    /** Identifier from telemetry settings for grouping related operations. */
-    readonly functionId: string | undefined;
-    /** Additional metadata from telemetry settings. */
-    readonly metadata: Record<string, unknown> | undefined;
-    /** User-defined context object flowing through the generation. */
-    readonly experimental_context: unknown;
-}) => PromiseLike<void> | void;
+ */
+export declare type GenerateTextOnToolCallStartCallback<TOOLS extends ToolSet = ToolSet> = (event: OnToolCallStartEvent<TOOLS>) => PromiseLike<void> | void;
 
 /**
  * The result of a `generateText` call.
@@ -7096,6 +6889,11 @@ declare interface Link {
     droppedAttributesCount?: number;
 }
 
+/**
+ * A callback function that can be used to notify listeners.
+ */
+declare type Listener<EVENT> = (event: EVENT) => PromiseLike<void> | void;
+
 declare function loadApiKey({ apiKey, environmentVariableName, apiKeyParameterName, description, }: {
     apiKey: string | undefined;
     environmentVariableName: string;
@@ -7415,22 +7213,256 @@ export declare type ObjectStreamPart<PARTIAL> = {
     providerMetadata?: ProviderMetadata;
 };
 
-export declare namespace Output {
-    export {
-        output_Output as Output,
-        output_array as array,
-        output_choice as choice,
-        output_json as json,
-        output_object as object,
-        output_text as text,
-    };
-}
-
-declare interface Output_2<OUTPUT = any, PARTIAL = any, ELEMENT = any> {
+/**
+ * Event passed to the `onFinish` callback.
+ *
+ * Called when the entire generation completes (all steps finished).
+ * Includes the final step's result along with aggregated data from all steps.
+ */
+export declare type OnFinishEvent<TOOLS extends ToolSet = ToolSet> = StepResult<TOOLS> & {
+    /** Array containing results from all steps in the generation. */
+    readonly steps: StepResult<TOOLS>[];
+    /** Aggregated token usage across all steps. */
+    readonly totalUsage: LanguageModelUsage;
     /**
-     * The name of the output mode.
+     * The final state of the user-defined context object.
+     *
+     * Experimental (can break in patch releases).
+     *
+     * @default undefined
      */
-    name: string;
+    experimental_context: unknown;
+    /** Identifier from telemetry settings for grouping related operations. */
+    readonly functionId: string | undefined;
+    /** Additional metadata from telemetry settings. */
+    readonly metadata: Record<string, unknown> | undefined;
+};
+
+/**
+ * Event passed to the `onStart` callback.
+ *
+ * Called when the generation operation begins, before any LLM calls.
+ */
+export declare interface OnStartEvent<TOOLS extends ToolSet = ToolSet, OUTPUT extends Output_2 = Output_2, INCLUDE = {
+    requestBody?: boolean;
+    responseBody?: boolean;
+}> {
+    /** The model being used for generation. */
+    readonly model: CallbackModelInfo;
+    /** The system message(s) provided to the model. */
+    readonly system: string | SystemModelMessage | Array<SystemModelMessage> | undefined;
+    /** The prompt string or array of messages if using the prompt option. */
+    readonly prompt: string | Array<ModelMessage> | undefined;
+    /** The messages array if using the messages option. */
+    readonly messages: Array<ModelMessage> | undefined;
+    /** The tools available for this generation. */
+    readonly tools: TOOLS | undefined;
+    /** The tool choice strategy for this generation. */
+    readonly toolChoice: ToolChoice<NoInfer<TOOLS>> | undefined;
+    /** Limits which tools are available for the model to call. */
+    readonly activeTools: Array<keyof TOOLS> | undefined;
+    /** Maximum number of tokens to generate. */
+    readonly maxOutputTokens: number | undefined;
+    /** Sampling temperature for generation. */
+    readonly temperature: number | undefined;
+    /** Top-p (nucleus) sampling parameter. */
+    readonly topP: number | undefined;
+    /** Top-k sampling parameter. */
+    readonly topK: number | undefined;
+    /** Presence penalty for generation. */
+    readonly presencePenalty: number | undefined;
+    /** Frequency penalty for generation. */
+    readonly frequencyPenalty: number | undefined;
+    /** Sequences that will stop generation. */
+    readonly stopSequences: string[] | undefined;
+    /** Random seed for reproducible generation. */
+    readonly seed: number | undefined;
+    /** Maximum number of retries for failed requests. */
+    readonly maxRetries: number;
+    /**
+     * Timeout configuration for the generation.
+     * Can be a number (milliseconds) or an object with totalMs, stepMs, chunkMs.
+     */
+    readonly timeout: TimeoutConfiguration | undefined;
+    /** Additional HTTP headers sent with the request. */
+    readonly headers: Record<string, string | undefined> | undefined;
+    /** Additional provider-specific options. */
+    readonly providerOptions: ProviderOptions | undefined;
+    /**
+     * Condition(s) for stopping the generation.
+     * When the condition is an array, any of the conditions can be met to stop.
+     */
+    readonly stopWhen: StopCondition<TOOLS> | Array<StopCondition<TOOLS>> | undefined;
+    /** The output specification for structured outputs, if configured. */
+    readonly output: OUTPUT | undefined;
+    /** Abort signal for cancelling the operation. */
+    readonly abortSignal: AbortSignal | undefined;
+    /**
+     * Settings for controlling what data is included in step results.
+     */
+    readonly include: INCLUDE | undefined;
+    /** Identifier from telemetry settings for grouping related operations. */
+    readonly functionId: string | undefined;
+    /** Additional metadata passed to the generation. */
+    readonly metadata: Record<string, unknown> | undefined;
+    /**
+     * User-defined context object that flows through the entire generation lifecycle.
+     * Can be accessed and modified in `prepareStep` and tool `execute` functions.
+     */
+    readonly experimental_context: unknown;
+}
+
+/**
+ * Event passed to the `onStepFinish` callback.
+ *
+ * Called when a step (LLM call) completes.
+ * This is simply the StepResult for that step.
+ */
+export declare type OnStepFinishEvent<TOOLS extends ToolSet = ToolSet> = StepResult<TOOLS>;
+
+/**
+ * Event passed to the `onStepStart` callback.
+ *
+ * Called when a step (LLM call) begins, before the provider is called.
+ * Each step represents a single LLM invocation.
+ */
+export declare interface OnStepStartEvent<TOOLS extends ToolSet = ToolSet, OUTPUT extends Output_2 = Output_2, INCLUDE = {
+    requestBody?: boolean;
+    responseBody?: boolean;
+}> {
+    /** Zero-based index of the current step. */
+    readonly stepNumber: number;
+    /** The model being used for this step. */
+    readonly model: CallbackModelInfo;
+    /**
+     * The system message for this step.
+     */
+    readonly system: string | SystemModelMessage | Array<SystemModelMessage> | undefined;
+    /**
+     * The messages that will be sent to the model for this step.
+     * Uses the user-facing `ModelMessage` format.
+     * May be overridden by prepareStep.
+     */
+    readonly messages: Array<ModelMessage>;
+    /** The tools available for this generation. */
+    readonly tools: TOOLS | undefined;
+    /** The tool choice configuration for this step. */
+    readonly toolChoice: LanguageModelV3ToolChoice | undefined;
+    /** Limits which tools are available for this step. */
+    readonly activeTools: Array<keyof TOOLS> | undefined;
+    /** Array of results from previous steps (empty for first step). */
+    readonly steps: ReadonlyArray<StepResult<TOOLS>>;
+    /** Additional provider-specific options for this step. */
+    readonly providerOptions: ProviderOptions | undefined;
+    /**
+     * Timeout configuration for the generation.
+     * Can be a number (milliseconds) or an object with totalMs, stepMs, chunkMs.
+     */
+    readonly timeout: TimeoutConfiguration | undefined;
+    /** Additional HTTP headers sent with the request. */
+    readonly headers: Record<string, string | undefined> | undefined;
+    /**
+     * Condition(s) for stopping the generation.
+     * When the condition is an array, any of the conditions can be met to stop.
+     */
+    readonly stopWhen: StopCondition<TOOLS> | Array<StopCondition<TOOLS>> | undefined;
+    /** The output specification for structured outputs, if configured. */
+    readonly output: OUTPUT | undefined;
+    /** Abort signal for cancelling the operation. */
+    readonly abortSignal: AbortSignal | undefined;
+    /**
+     * Settings for controlling what data is included in step results.
+     */
+    readonly include: INCLUDE | undefined;
+    /** Identifier from telemetry settings for grouping related operations. */
+    readonly functionId: string | undefined;
+    /** Additional metadata from telemetry settings. */
+    readonly metadata: Record<string, unknown> | undefined;
+    /**
+     * User-defined context object. May be updated from `prepareStep` between steps.
+     */
+    readonly experimental_context: unknown;
+}
+
+/**
+ * Event passed to the `onToolCallFinish` callback.
+ *
+ * Called when a tool execution completes, either successfully or with an error.
+ * Uses a discriminated union on the `success` field.
+ */
+export declare type OnToolCallFinishEvent<TOOLS extends ToolSet = ToolSet> = {
+    /** Zero-based index of the current step where this tool call occurred. */
+    readonly stepNumber: number | undefined;
+    /** The model being used for this step. */
+    readonly model: CallbackModelInfo | undefined;
+    /** The full tool call object. */
+    readonly toolCall: TypedToolCall<TOOLS>;
+    /** The conversation messages available at tool execution time. */
+    readonly messages: Array<ModelMessage>;
+    /** Signal for cancelling the operation. */
+    readonly abortSignal: AbortSignal | undefined;
+    /** Execution time of the tool call in milliseconds. */
+    readonly durationMs: number;
+    /** Identifier from telemetry settings for grouping related operations. */
+    readonly functionId: string | undefined;
+    /** Additional metadata from telemetry settings. */
+    readonly metadata: Record<string, unknown> | undefined;
+    /** User-defined context object flowing through the generation. */
+    readonly experimental_context: unknown;
+} & ({
+    /** Indicates the tool call succeeded. */
+    readonly success: true;
+    /** The tool's return value. */
+    readonly output: unknown;
+    readonly error?: never;
+} | {
+    /** Indicates the tool call failed. */
+    readonly success: false;
+    readonly output?: never;
+    /** The error that occurred during tool execution. */
+    readonly error: unknown;
+});
+
+/**
+ * Event passed to the `onToolCallStart` callback.
+ *
+ * Called when a tool execution begins, before the tool's `execute` function is invoked.
+ */
+export declare interface OnToolCallStartEvent<TOOLS extends ToolSet = ToolSet> {
+    /** Zero-based index of the current step where this tool call occurs. */
+    readonly stepNumber: number | undefined;
+    /** The model being used for this step. */
+    readonly model: CallbackModelInfo | undefined;
+    /** The full tool call object. */
+    readonly toolCall: TypedToolCall<TOOLS>;
+    /** The conversation messages available at tool execution time. */
+    readonly messages: Array<ModelMessage>;
+    /** Signal for cancelling the operation. */
+    readonly abortSignal: AbortSignal | undefined;
+    /** Identifier from telemetry settings for grouping related operations. */
+    readonly functionId: string | undefined;
+    /** Additional metadata from telemetry settings. */
+    readonly metadata: Record<string, unknown> | undefined;
+    /** User-defined context object flowing through the generation. */
+    readonly experimental_context: unknown;
+}
+
+export declare namespace Output {
+    export {
+        output_Output as Output,
+        output_array as array,
+        output_choice as choice,
+        output_json as json,
+        output_object as object,
+        output_text as text,
+    };
+}
+
+declare interface Output_2<OUTPUT = any, PARTIAL = any, ELEMENT = any> {
+    /**
+     * The name of the output mode.
+     */
+    name: string;
     /**
      * The response format to use for the model.
      */
@@ -8403,6 +8435,11 @@ export declare type ReasoningUIPart = {
     providerMetadata?: ProviderMetadata;
 };
 
+/**
+ * Registers a telemetry integration globally.
+ */
+export declare function registerTelemetryIntegration(integration: TelemetryIntegration): void;
+
 /**
  * Removes entries from a record where the value is null or undefined.
  * @param record - The input object whose entries may be null or undefined.
@@ -9008,6 +9045,7 @@ declare type SingleRequestTextStreamPart<TOOLS extends ToolSet> = {
 } & Source) | {
     type: 'file';
     file: GeneratedFile;
+    providerMetadata?: ProviderMetadata;
 } | ({
     type: 'tool-call';
 } & TypedToolCall<TOOLS>) | ({
@@ -9015,9 +9053,6 @@ declare type SingleRequestTextStreamPart<TOOLS extends ToolSet> = {
 } & TypedToolResult<TOOLS>) | ({
     type: 'tool-error';
 } & TypedToolError<TOOLS>) | {
-    type: 'file';
-    file: GeneratedFile;
-} | {
     type: 'stream-start';
     warnings: SharedV3Warning[];
 } | {
@@ -10270,7 +10305,7 @@ declare interface StreamOptions {
  * @returns
  * A result object for accessing different stream types and additional information.
  */
-export declare function streamText<TOOLS extends ToolSet, OUTPUT extends Output_2 = Output_2<string, string, never>>({ model, tools, toolChoice, system, prompt, messages, maxRetries, abortSignal, timeout, headers, stopWhen, experimental_output, output, experimental_telemetry: telemetry, prepareStep, providerOptions, experimental_activeTools, activeTools, experimental_repairToolCall: repairToolCall, experimental_transform: transform, experimental_download: download, includeRawChunks, onChunk, onError, onFinish, onAbort, onStepFinish, experimental_context, experimental_include: include, _internal: { now, generateId }, ...settings }: CallSettings & Prompt & {
+export declare function streamText<TOOLS extends ToolSet, OUTPUT extends Output_2 = Output_2<string, string, never>>({ model, tools, toolChoice, system, prompt, messages, maxRetries, abortSignal, timeout, headers, stopWhen, experimental_output, output, experimental_telemetry: telemetry, prepareStep, providerOptions, experimental_activeTools, activeTools, experimental_repairToolCall: repairToolCall, experimental_transform: transform, experimental_download: download, includeRawChunks, onChunk, onError, onFinish, onAbort, onStepFinish, experimental_onStart: onStart, experimental_onStepStart: onStepStart, experimental_onToolCallStart: onToolCallStart, experimental_onToolCallFinish: onToolCallFinish, experimental_context, experimental_include: include, _internal: { now, generateId }, ...settings }: CallSettings & Prompt & {
     /**
      * The language model to use.
      */
@@ -10377,6 +10412,24 @@ export declare function streamText<TOOLS extends ToolSet, OUTPUT extends Output_
      * Callback that is called when each step (LLM call) is finished, including intermediate steps.
      */
     onStepFinish?: StreamTextOnStepFinishCallback<TOOLS>;
+    /**
+     * Callback that is called when the streamText operation begins,
+     * before any LLM calls are made.
+     */
+    experimental_onStart?: StreamTextOnStartCallback<NoInfer<TOOLS>, OUTPUT>;
+    /**
+     * Callback that is called when a step (LLM call) begins,
+     * before the provider is called.
+     */
+    experimental_onStepStart?: StreamTextOnStepStartCallback<NoInfer<TOOLS>, OUTPUT>;
+    /**
+     * Callback that is called right before a tool's execute function runs.
+     */
+    experimental_onToolCallStart?: StreamTextOnToolCallStartCallback<NoInfer<TOOLS>>;
+    /**
+     * Callback that is called right after a tool's execute function completes (or errors).
+     */
+    experimental_onToolCallFinish?: StreamTextOnToolCallFinishCallback<NoInfer<TOOLS>>;
     /**
      * Context that is passed into tool execution.
      *
@@ -10409,6 +10462,13 @@ export declare function streamText<TOOLS extends ToolSet, OUTPUT extends Output_
     };
 }): StreamTextResult<TOOLS, OUTPUT>;
 
+/**
+ * Include settings for streamText (requestBody only).
+ */
+declare type StreamTextIncludeSettings = {
+    requestBody?: boolean;
+};
+
 /**
  * Callback that is set using the `onAbort` option.
  *
@@ -10446,31 +10506,40 @@ export declare type StreamTextOnErrorCallback = (event: {
  *
  * @param event - The event that is passed to the callback.
  */
-export declare type StreamTextOnFinishCallback<TOOLS extends ToolSet> = (event: StepResult<TOOLS> & {
-    /**
-     * Details for all steps.
-     */
-    readonly steps: StepResult<TOOLS>[];
-    /**
-     * Total usage for all steps. This is the sum of the usage of all steps.
-     */
-    readonly totalUsage: LanguageModelUsage;
-    /**
-     * Context that is passed into tool execution.
-     *
-     * Experimental (can break in patch releases).
-     *
-     * @default undefined
-     */
-    experimental_context: unknown;
-}) => PromiseLike<void> | void;
+export declare type StreamTextOnFinishCallback<TOOLS extends ToolSet> = (event: OnFinishEvent<TOOLS>) => PromiseLike<void> | void;
+
+/**
+ * Callback that is set using the `experimental_onStart` option.
+ *
+ * Called when the streamText operation begins, before any LLM calls.
+ * Use this callback for logging, analytics, or initializing state at the
+ * start of a generation.
+ *
+ * @param event - The event object containing generation configuration.
+ */
+export declare type StreamTextOnStartCallback<TOOLS extends ToolSet = ToolSet, OUTPUT extends Output_2 = Output_2> = (event: OnStartEvent<TOOLS, OUTPUT, StreamTextIncludeSettings>) => PromiseLike<void> | void;
 
 /**
  * Callback that is set using the `onStepFinish` option.
  *
  * @param stepResult - The result of the step.
  */
-export declare type StreamTextOnStepFinishCallback<TOOLS extends ToolSet> = (stepResult: StepResult<TOOLS>) => PromiseLike<void> | void;
+export declare type StreamTextOnStepFinishCallback<TOOLS extends ToolSet> = (event: OnStepFinishEvent<TOOLS>) => PromiseLike<void> | void;
+
+/**
+ * Callback that is set using the `experimental_onStepStart` option.
+ *
+ * Called when a step (LLM call) begins, before the provider is called.
+ * Each step represents a single LLM invocation. Multiple steps occur when
+ * using tool calls (the model may be called multiple times in a loop).
+ *
+ * @param event - The event object containing step configuration.
+ */
+export declare type StreamTextOnStepStartCallback<TOOLS extends ToolSet = ToolSet, OUTPUT extends Output_2 = Output_2> = (event: OnStepStartEvent<TOOLS, OUTPUT, StreamTextIncludeSettings>) => PromiseLike<void> | void;
+
+export declare type StreamTextOnToolCallFinishCallback<TOOLS extends ToolSet = ToolSet> = (event: OnToolCallFinishEvent<TOOLS>) => PromiseLike<void> | void;
+
+export declare type StreamTextOnToolCallStartCallback<TOOLS extends ToolSet = ToolSet> = (event: OnToolCallStartEvent<TOOLS>) => PromiseLike<void> | void;
 
 /**
  * A result object for accessing different stream types and additional information.
@@ -10701,6 +10770,16 @@ export declare type StreamTextTransform<TOOLS extends ToolSet> = (options: {
     stopStream: () => void;
 }) => TransformStream<TextStreamPart<TOOLS>, TextStreamPart<TOOLS>>;
 
+/**
+ * Strips file extension segments from a filename.
+ *
+ * Examples:
+ * - "report.pdf" -> "report"
+ * - "archive.tar.gz" -> "archive"
+ * - "filename" -> "filename"
+ */
+declare function stripFileExtension(filename: string): string;
+
 declare const symbol$1: unique symbol;
 
 declare const symbol$1_2: unique symbol;
@@ -10791,6 +10870,19 @@ export declare type SystemModelMessage = {
 
 export declare const systemModelMessageSchema: z.ZodType<SystemModelMessage>;
 
+/**
+ * Implement this interface to create custom telemetry integrations.
+ * Methods can be sync or return a PromiseLike.
+ */
+export declare interface TelemetryIntegration {
+    onStart?: Listener<OnStartEvent<ToolSet, Output_2>>;
+    onStepStart?: Listener<OnStepStartEvent<ToolSet, Output_2>>;
+    onToolCallStart?: Listener<OnToolCallStartEvent<ToolSet>>;
+    onToolCallFinish?: Listener<OnToolCallFinishEvent<ToolSet>>;
+    onStepFinish?: Listener<OnStepFinishEvent<ToolSet>>;
+    onFinish?: Listener<OnFinishEvent<ToolSet>>;
+}
+
 /**
  * Telemetry configuration.
  */
@@ -10825,6 +10917,13 @@ export declare type TelemetrySettings = {
      * A custom tracer to use for the telemetry data.
      */
     tracer?: Tracer;
+    /**
+     * Per-call telemetry integrations that receive lifecycle events during generation.
+     *
+     * These integrations run after any globally registered integrations
+     * (see `registerTelemetryIntegration`).
+     */
+    integrations?: TelemetryIntegration | TelemetryIntegration[];
 };
 
 /**
@@ -10897,6 +10996,7 @@ export declare type TextStreamPart<TOOLS extends ToolSet> = {
 } & Source) | {
     type: 'file';
     file: GeneratedFile;
+    providerMetadata?: ProviderMetadata;
 } | ({
     type: 'tool-call';
 } & TypedToolCall<TOOLS>) | ({
@@ -11353,49 +11453,30 @@ declare class ToolLoopAgent<CALL_OPTIONS = never, TOOLS extends ToolSet = {}, OU
      */
     get tools(): TOOLS;
     private prepareCall;
-    private mergeOnStepFinishCallbacks;
+    private mergeCallbacks;
     /**
      * Generates an output from the agent (non-streaming).
      */
-    generate({ abortSignal, timeout, onStepFinish, ...options }: AgentCallParameters<CALL_OPTIONS, TOOLS>): Promise<GenerateTextResult<TOOLS, OUTPUT>>;
+    generate({ abortSignal, timeout, experimental_onStart, experimental_onStepStart, experimental_onToolCallStart, experimental_onToolCallFinish, onStepFinish, onFinish, ...options }: AgentCallParameters<CALL_OPTIONS, TOOLS>): Promise<GenerateTextResult<TOOLS, OUTPUT>>;
     /**
      * Streams an output from the agent (streaming).
      */
-    stream({ abortSignal, timeout, experimental_transform, onStepFinish, ...options }: AgentStreamParameters<CALL_OPTIONS, TOOLS>): Promise<StreamTextResult<TOOLS, OUTPUT>>;
+    stream({ abortSignal, timeout, experimental_transform, experimental_onStart, experimental_onStepStart, experimental_onToolCallStart, experimental_onToolCallFinish, onStepFinish, onFinish, ...options }: AgentStreamParameters<CALL_OPTIONS, TOOLS>): Promise<StreamTextResult<TOOLS, OUTPUT>>;
 }
 export { ToolLoopAgent as Experimental_Agent }
 export { ToolLoopAgent }
 
-/**
- * Callback that is set using the `onFinish` option.
- *
- * @param event - The event that is passed to the callback.
- */
-export declare type ToolLoopAgentOnFinishCallback<TOOLS extends ToolSet = {}> = (event: StepResult<TOOLS> & {
-    /**
-     * Details for all steps.
-     */
-    readonly steps: StepResult<TOOLS>[];
-    /**
-     * Total usage for all steps. This is the sum of the usage of all steps.
-     */
-    readonly totalUsage: LanguageModelUsage;
-    /**
-     * Context that is passed into tool execution.
-     *
-     * Experimental (can break in patch releases).
-     *
-     * @default undefined
-     */
-    experimental_context: unknown;
-}) => PromiseLike<void> | void;
+export declare type ToolLoopAgentOnFinishCallback<TOOLS extends ToolSet = {}> = (event: OnFinishEvent<TOOLS>) => PromiseLike<void> | void;
 
-/**
- * Callback that is set using the `onStepFinish` option.
- *
- * @param stepResult - The result of the step.
- */
-export declare type ToolLoopAgentOnStepFinishCallback<TOOLS extends ToolSet = {}> = (stepResult: StepResult<TOOLS>) => Promise<void> | void;
+export declare type ToolLoopAgentOnStartCallback<TOOLS extends ToolSet = ToolSet, OUTPUT extends Output_2 = Output_2> = (event: OnStartEvent<TOOLS, OUTPUT>) => PromiseLike<void> | void;
+
+export declare type ToolLoopAgentOnStepFinishCallback<TOOLS extends ToolSet = {}> = (stepResult: OnStepFinishEvent<TOOLS>) => Promise<void> | void;
+
+export declare type ToolLoopAgentOnStepStartCallback<TOOLS extends ToolSet = ToolSet, OUTPUT extends Output_2 = Output_2> = (event: OnStepStartEvent<TOOLS, OUTPUT>) => PromiseLike<void> | void;
+
+export declare type ToolLoopAgentOnToolCallFinishCallback<TOOLS extends ToolSet = ToolSet> = (event: OnToolCallFinishEvent<TOOLS>) => PromiseLike<void> | void;
+
+export declare type ToolLoopAgentOnToolCallStartCallback<TOOLS extends ToolSet = ToolSet> = (event: OnToolCallStartEvent<TOOLS>) => PromiseLike<void> | void;
 
 /**
  * Configuration options for an agent.
@@ -11451,6 +11532,22 @@ declare type ToolLoopAgentSettings<CALL_OPTIONS = never, TOOLS extends ToolSet =
      * A function that attempts to repair a tool call that failed to parse.
      */
     experimental_repairToolCall?: ToolCallRepairFunction<NoInfer<TOOLS>>;
+    /**
+     * Callback that is called when the agent operation begins, before any LLM calls.
+     */
+    experimental_onStart?: ToolLoopAgentOnStartCallback<NoInfer<TOOLS>, OUTPUT>;
+    /**
+     * Callback that is called when a step (LLM call) begins, before the provider is called.
+     */
+    experimental_onStepStart?: ToolLoopAgentOnStepStartCallback<NoInfer<TOOLS>, OUTPUT>;
+    /**
+     * Callback that is called before each tool execution begins.
+     */
+    experimental_onToolCallStart?: ToolLoopAgentOnToolCallStartCallback<NoInfer<TOOLS>>;
+    /**
+     * Callback that is called after each tool execution completes.
+     */
+    experimental_onToolCallFinish?: ToolLoopAgentOnToolCallFinishCallback<NoInfer<TOOLS>>;
     /**
      * Callback that is called when each step (LLM call) is finished, including intermediate steps.
      */
@@ -12944,6 +13041,15 @@ export declare type UserModelMessage = {
 
 export declare const userModelMessageSchema: z.ZodType<UserModelMessage>;
 
+/**
+ * Validates that a URL is safe to download from, blocking private/internal addresses
+ * to prevent SSRF attacks.
+ *
+ * @param url - The URL string to validate.
+ * @throws DownloadError if the URL is unsafe.
+ */
+declare function validateDownloadUrl(url: string): void;
+
 /**
  * Validates the types of an unknown object using a schema and
  * return a strongly-typed object.
@@ -13383,5 +13489,5 @@ export declare function zodSchema<OBJECT>(zodSchema: z4.core.$ZodType<OBJECT, an
 }): Schema<OBJECT>;
 
 export { }
-export { GatewayProviderSettings as GatewayProviderSettings, GatewayProvider as GatewayProvider, LazySchema as LazySchema, ZodSchema as ZodSchema, StandardSchema as StandardSchema, ValidationResult as ValidationResult, ParseResult as ParseResult, ProviderOptions as ProviderOptions, ReasoningPart as ReasoningPart, ToolOutputProperties as ToolOutputProperties, ToolResultOutput as ToolResultOutput, ToolNeedsApprovalFunction as ToolNeedsApprovalFunction, TypeValidationContext as TypeValidationContext, JSONSchema7Version as JSONSchema7Version, JSONSchema7Definition as JSONSchema7Definition, JSONSchema7TypeName as JSONSchema7TypeName, JSONSchema7Type as JSONSchema7Type, EmbeddingModelV2 as EmbeddingModelV2, EmbeddingModelV3Embedding as EmbeddingModelV3Embedding, EmbeddingModelV3Middleware as EmbeddingModelV3Middleware, ImageModelV2 as ImageModelV2, ImageModelV3ProviderMetadata as ImageModelV3ProviderMetadata, ImageModelV2ProviderMetadata as ImageModelV2ProviderMetadata, ImageModelV3Middleware as ImageModelV3Middleware, GlobalProviderModelId as GlobalProviderModelId, LanguageModelV2 as LanguageModelV2, SharedV3Warning as SharedV3Warning, LanguageModelV3Middleware as LanguageModelV3Middleware, SharedV3ProviderMetadata as SharedV3ProviderMetadata, SpeechModelV2 as SpeechModelV2, TranscriptionModelV2 as TranscriptionModelV2, ImageModelV3Usage as ImageModelV3Usage, BaseToolCall as BaseToolCall, Source as Source, DeepPartialInternal as DeepPartialInternal, AttributeValue as AttributeValue, Tracer as Tracer, LanguageModelV3ToolCall as LanguageModelV3ToolCall, LanguageModelV3ToolChoice as LanguageModelV3ToolChoice, ValueOf as ValueOf, asUITool as asUITool, _ai_sdk_provider_utils as _ai_sdk_provider_utils, _ai_sdk_provider as _ai_sdk_provider, DataUIMessageChunk as DataUIMessageChunk, InferElementOutput as InferElementOutput, ConsumeStreamOptions as ConsumeStreamOptions, StreamTextOnAbortCallback as StreamTextOnAbortCallback, ResponseMessage as ResponseMessage, Output_2 as Output_2, MaybePromiseLike as MaybePromiseLike, InferAgentTools as InferAgentTools, UIMessageStreamResponseInit as UIMessageStreamResponseInit, getOriginalFetch as getOriginalFetch, InferUIMessageToolCall as InferUIMessageToolCall, UIDataTypesToSchemas as UIDataTypesToSchemas, InferUIMessageData as InferUIMessageData, InferUIMessageMetadata as InferUIMessageMetadata, InferUIMessageTools as InferUIMessageTools, Resolvable as Resolvable, FetchFunction as FetchFunction, SingleRequestTextStreamPart as SingleRequestTextStreamPart, RetryErrorReason as RetryErrorReason, GenerateImagePrompt as GenerateImagePrompt, JSONValue_2 as JSONValue_2, Job as Job, StreamObjectOnErrorCallback as StreamObjectOnErrorCallback, VideoModelResponseMetadata as VideoModelResponseMetadata, VideoModelProviderMetadata as VideoModelProviderMetadata, VideoModel as VideoModel, EmbeddingModelV3CallOptions as EmbeddingModelV3CallOptions, LanguageModelV3CallOptions as LanguageModelV3CallOptions, JSONObject as JSONObject, LanguageModelV3 as LanguageModelV3, EmbeddingModelV3 as EmbeddingModelV3, ImageModelV3 as ImageModelV3, TranscriptionModelV3 as TranscriptionModelV3, SpeechModelV3 as SpeechModelV3, RerankingModelV3 as RerankingModelV3, VideoModelV3 as VideoModelV3, ProviderV2 as ProviderV2, ExtractModelId as ExtractModelId, ExtractLiteralUnion as ExtractLiteralUnion, ProviderV3 as ProviderV3 };
+export { GatewayProviderSettings as GatewayProviderSettings, GatewayProvider as GatewayProvider, LazySchema as LazySchema, ZodSchema as ZodSchema, StandardSchema as StandardSchema, ValidationResult as ValidationResult, ParseResult as ParseResult, ProviderOptions as ProviderOptions, ReasoningPart as ReasoningPart, ToolOutputProperties as ToolOutputProperties, ToolResultOutput as ToolResultOutput, ToolNeedsApprovalFunction as ToolNeedsApprovalFunction, TypeValidationContext as TypeValidationContext, JSONSchema7Version as JSONSchema7Version, JSONSchema7Definition as JSONSchema7Definition, JSONSchema7TypeName as JSONSchema7TypeName, JSONSchema7Type as JSONSchema7Type, EmbeddingModelV2 as EmbeddingModelV2, EmbeddingModelV3Embedding as EmbeddingModelV3Embedding, EmbeddingModelV3Middleware as EmbeddingModelV3Middleware, ImageModelV2 as ImageModelV2, ImageModelV3ProviderMetadata as ImageModelV3ProviderMetadata, ImageModelV2ProviderMetadata as ImageModelV2ProviderMetadata, ImageModelV3Middleware as ImageModelV3Middleware, GlobalProviderModelId as GlobalProviderModelId, LanguageModelV2 as LanguageModelV2, SharedV3Warning as SharedV3Warning, LanguageModelV3Middleware as LanguageModelV3Middleware, SharedV3ProviderMetadata as SharedV3ProviderMetadata, SpeechModelV2 as SpeechModelV2, TranscriptionModelV2 as TranscriptionModelV2, ImageModelV3Usage as ImageModelV3Usage, BaseToolCall as BaseToolCall, Source as Source, DeepPartialInternal as DeepPartialInternal, CallbackModelInfo as CallbackModelInfo, LanguageModelV3ToolChoice as LanguageModelV3ToolChoice, Listener as Listener, AttributeValue as AttributeValue, Tracer as Tracer, LanguageModelV3ToolCall as LanguageModelV3ToolCall, GenerateTextIncludeSettings as GenerateTextIncludeSettings, ValueOf as ValueOf, asUITool as asUITool, _ai_sdk_provider_utils as _ai_sdk_provider_utils, _ai_sdk_provider as _ai_sdk_provider, DataUIMessageChunk as DataUIMessageChunk, InferElementOutput as InferElementOutput, ConsumeStreamOptions as ConsumeStreamOptions, StreamTextIncludeSettings as StreamTextIncludeSettings, StreamTextOnAbortCallback as StreamTextOnAbortCallback, ResponseMessage as ResponseMessage, MaybePromiseLike as MaybePromiseLike, Output_2 as Output_2, InferAgentTools as InferAgentTools, UIMessageStreamResponseInit as UIMessageStreamResponseInit, getOriginalFetch as getOriginalFetch, InferUIMessageToolCall as InferUIMessageToolCall, UIDataTypesToSchemas as UIDataTypesToSchemas, InferUIMessageData as InferUIMessageData, InferUIMessageMetadata as InferUIMessageMetadata, InferUIMessageTools as InferUIMessageTools, Resolvable as Resolvable, FetchFunction as FetchFunction, SingleRequestTextStreamPart as SingleRequestTextStreamPart, RetryErrorReason as RetryErrorReason, GenerateImagePrompt as GenerateImagePrompt, JSONValue_2 as JSONValue_2, Job as Job, StreamObjectOnErrorCallback as StreamObjectOnErrorCallback, VideoModelResponseMetadata as VideoModelResponseMetadata, VideoModelProviderMetadata as VideoModelProviderMetadata, VideoModel as VideoModel, EmbeddingModelV3CallOptions as EmbeddingModelV3CallOptions, LanguageModelV3CallOptions as LanguageModelV3CallOptions, JSONObject as JSONObject, LanguageModelV3 as LanguageModelV3, EmbeddingModelV3 as EmbeddingModelV3, ImageModelV3 as ImageModelV3, TranscriptionModelV3 as TranscriptionModelV3, SpeechModelV3 as SpeechModelV3, RerankingModelV3 as RerankingModelV3, VideoModelV3 as VideoModelV3, ProviderV2 as ProviderV2, ExtractModelId as ExtractModelId, ExtractLiteralUnion as ExtractLiteralUnion, ProviderV3 as ProviderV3 };
 export { schemaSymbol, symbol$1, symbol$1_2, symbol$2, symbol$2_2, symbol$3, symbol$3_2, symbol$4, symbol$4_2, symbol$5, symbol$5_2, symbol$6, symbol$6_2, symbol$7, symbol$7_2, symbol$8, symbol$8_2, symbol$9, symbol$9_2, symbol$a, symbol$a_2, symbol$b, symbol$b_2, symbol$c, symbol$c_2, symbol$d, symbol$d_2, symbol$e, symbol$f, symbol$g, symbol$h, symbol$i, symbol$j, symbol, symbol_2, symbol_3 };