@raindrop-ai/ai-sdk 0.3.3 → 0.3.4

package/dist/{index-B_mpeckV.d.mts → index-DCYSGvxI.d.mts}

@@ -765,6 +765,46 @@ declare function getContextManager(): ContextManager;
 declare function currentSpan(): ContextSpan;
 declare function withCurrent<R>(span: ContextSpan, callback: () => R): R;
 
+/**
+ * `ai.prompt.tools`: the tool catalog a model call was given, one JSON
+ * document per tool, in the shape the Vercel AI SDK records on its
+ * `doGenerate` / `doStream` spans. Every integration emits this attribute on
+ * its model-call spans so downstream consumers (agent replay, world builder)
+ * can read what the model could call instead of guessing from the calls it
+ * happened to make.
+ *
+ * An absent attribute means the integration could not observe the tool list;
+ * an empty array means the model had no tools. Callers who know better than
+ * the integration pass a `tools` override, which replaces the inferred list.
+ */
+declare const PROMPT_TOOLS_ATTRIBUTE = "ai.prompt.tools";
+type JsonSchema = Record<string, unknown>;
+type FunctionToolDeclaration = {
+    type: "function";
+    name: string;
+    description?: string;
+    inputSchema?: JsonSchema;
+};
+type ProviderDefinedToolDeclaration = {
+    type: "provider-defined";
+    id?: string;
+    name: string;
+    args?: Record<string, unknown>;
+};
+type ToolDeclaration = FunctionToolDeclaration | ProviderDefinedToolDeclaration;
+/**
+ * What callers hand to a `tools` override. The canonical `ToolDeclaration`
+ * shape is accepted as-is; so is any framework shape `normalizeToolDeclarations`
+ * recognizes (OpenAI, Anthropic, Bedrock, LangChain, Pi, Mastra, AI SDK).
+ */
+type ToolDeclarationInput = ToolDeclaration | {
+    name: string;
+    description?: string;
+    inputSchema?: JsonSchema;
+    parameters?: JsonSchema;
+};
+type PromptToolsOverride = ReadonlyArray<ToolDeclarationInput | unknown>;
+
 declare class EventShipper extends EventShipper$1 {
     constructor(opts: ConstructorParameters<typeof EventShipper$1>[0]);
 }
@@ -1118,6 +1158,11 @@ type RaindropTelemetryIntegrationOptions = {
     debug?: boolean;
     /** See {@link SubagentApiOptions.settledEventIds}. */
     settledEventIds?: Set<string>;
+    /**
+     * Overrides the tool catalog recorded as `ai.prompt.tools` on every model
+     * span (replaces the step's tools; `[]` records an empty catalog).
+     */
+    tools?: PromptToolsOverride;
     context?: {
         userId?: string;
         eventId?: string;
@@ -1135,6 +1180,7 @@ declare class RaindropTelemetryIntegration implements TelemetryIntegration {
     private readonly subagentWrapping;
     private readonly debug;
     private readonly defaultContext;
+    private readonly promptTools;
     private readonly callStates;
     /**
      * Per-tool-call snapshot of the parent-tool ALS context taken right
@@ -1804,6 +1850,12 @@ type WrapAISDKOptions = {
      * Default: false (uses Proxy wrapping for backward compatibility).
      */
     nativeTelemetry?: boolean;
+    /**
+     * Overrides the tool catalog recorded as `ai.prompt.tools` on every model
+     * span, replacing the tools the AI SDK hands the model. `[]` records an
+     * explicitly empty catalog.
+     */
+    tools?: PromptToolsOverride;
 };
 /**
  * Opaque handle for a trace span. Pass as `parent` when creating child spans.
@@ -1900,6 +1952,7 @@ type RaindropAISDKClient = {
     createTelemetryIntegration(contextOrOptions?: RaindropTelemetryIntegrationOptions["context"] | {
         context?: RaindropTelemetryIntegrationOptions["context"];
         subagentWrapping?: boolean;
+        tools?: PromptToolsOverride;
     }): RaindropTelemetryIntegration;
     /**
      * Detached sub-agent hand-offs: record a sub-agent that runs in another
@@ -2013,6 +2066,11 @@ type RaindropTelemetryOptions = RaindropAISDKOptions & {
      * spans nest correctly. Enabled by default.
      */
     subagentWrapping?: boolean;
+    /**
+     * Overrides the tool catalog recorded as `ai.prompt.tools` on every model
+     * span. Use when the integration cannot see the tools the model was given.
+     */
+    tools?: PromptToolsOverride;
 };
 /**
  * One-line factory for the AI SDK v7 `registerTelemetry` DX.
@@ -2047,4 +2105,4 @@ type RaindropTelemetryOptions = RaindropAISDKOptions & {
  */
 declare function raindrop(options?: RaindropTelemetryOptions): RaindropTelemetryIntegration;
 
-export { type SubagentRun as $, type AISDKChatRequestLike as A, type BuildEventPatch as B, type CarrierHeaders as C, DEFAULT_MAX_TEXT_FIELD_CHARS as D, type EndSpanArgs as E, type FeatureFlagValue as F, type RaindropTelemetryOptions as G, HANDOFF_ATTRIBUTE_PREFIXES as H, type IdentifyInput as I, SUBAGENT_AGENT_ROLE as J, SUBAGENT_CANCELLED_OUTPUT as K, type SelfDiagnosticsOptions as L, type SelfDiagnosticsSignalDefinition as M, type SelfDiagnosticsSignalDefinitions as N, type OtlpAnyValue as O, type ParentToolContext as P, type SelfDiagnosticsTool as Q, REDACTED_PLACEHOLDER as R, SUBAGENT_ABORTED_OUTPUT as S, type SelfDiagnosticsToolInput as T, type SelfDiagnosticsToolOptions as U, type SelfDiagnosticsToolResult as V, type StartSpanArgs as W, SubagentApi as X, type SubagentDispatch as Y, type SubagentDispatchOptions as Z, type SubagentResumeOptions as _, type AISDKChatRequestMessageLike as a, type SubagentRunMetadata as a0, TOOL_EVENTS_ALLOW as a1, TRUNCATION_MARKER as a2, type TraceCarrier as a3, type TraceSpan as a4, type TransformSpanHook as a5, type WrapAISDKOptions as a6, type WrappedAI as a7, type WrappedAISDK as a8, _resetParentToolContextStorage as a9, _resetRaindropCallMetadataStorage as aa, _resetWarnedMissingUserId as ab, boundedStringify as ac, capText as ad, clearParentToolContext as ae, createRaindropAISDK as af, currentSpan as ag, defaultTransformSpan as ah, enterParentToolContext as ai, eventMetadata as aj, eventMetadataFromChatRequest as ak, fromHeaders as al, getContextManager as am, getCurrentParentToolContext as an, getCurrentRaindropCallMetadata as ao, normalizeFeatureFlags as ap, raindrop as aq, readRaindropCallMetadataFromArgs as ar, redactJsonAttributeValue as as, redactSecretsInObject as at, resetUnresolvedCarrierWarning as au, runWithParentToolContext as av, runWithRaindropCallMetadata as aw, toHeaders as ax, toLangSmithHeaders as ay, withCurrent as az, type AISDKMessage as b, type AgentCallMetadata as c, type AgentWithMetadata as d, type Attachment as e, ContextManager as f, type ContextSpan as g, type CreateSpanArgs as h, DEFAULT_REDACT_ATTRIBUTE_KEYS as i, DEFAULT_SECRET_KEY_NAMES as j, DETACHED_MODE as k, type DetachedChildLink as l, type DetachedDispatch as m, type EventBuilder as n, type EventMetadataOptions as o, type FeatureFlags as p, HANDOFF_ATTRIBUTE_SUFFIXES as q, HANDOFF_TERMINAL_CANCELLED as r, HANDOFF_TERMINAL_PROPERTY_KEY as s, type OtlpSpan as t, type RaindropAISDKClient as u, type RaindropAISDKContext as v, type RaindropAISDKOptions as w, type RaindropCallMetadata as x, RaindropTelemetryIntegration as y, type RaindropTelemetryIntegrationOptions as z };
+export { type SubagentDispatchOptions as $, type AISDKChatRequestLike as A, type BuildEventPatch as B, type CarrierHeaders as C, DEFAULT_MAX_TEXT_FIELD_CHARS as D, type EndSpanArgs as E, type FeatureFlagValue as F, RaindropTelemetryIntegration as G, HANDOFF_ATTRIBUTE_PREFIXES as H, type IdentifyInput as I, type RaindropTelemetryIntegrationOptions as J, type RaindropTelemetryOptions as K, SUBAGENT_AGENT_ROLE as L, SUBAGENT_CANCELLED_OUTPUT as M, type SelfDiagnosticsOptions as N, type OtlpAnyValue as O, PROMPT_TOOLS_ATTRIBUTE as P, type SelfDiagnosticsSignalDefinition as Q, REDACTED_PLACEHOLDER as R, SUBAGENT_ABORTED_OUTPUT as S, type SelfDiagnosticsSignalDefinitions as T, type SelfDiagnosticsTool as U, type SelfDiagnosticsToolInput as V, type SelfDiagnosticsToolOptions as W, type SelfDiagnosticsToolResult as X, type StartSpanArgs as Y, SubagentApi as Z, type SubagentDispatch as _, type AISDKChatRequestMessageLike as a, type SubagentResumeOptions as a0, type SubagentRun as a1, type SubagentRunMetadata as a2, TOOL_EVENTS_ALLOW as a3, TRUNCATION_MARKER as a4, type ToolDeclaration as a5, type TraceCarrier as a6, type TraceSpan as a7, type TransformSpanHook as a8, type WrapAISDKOptions as a9, toHeaders as aA, toLangSmithHeaders as aB, withCurrent as aC, type WrappedAI as aa, type WrappedAISDK as ab, _resetParentToolContextStorage as ac, _resetRaindropCallMetadataStorage as ad, _resetWarnedMissingUserId as ae, boundedStringify as af, capText as ag, clearParentToolContext as ah, createRaindropAISDK as ai, currentSpan as aj, defaultTransformSpan as ak, enterParentToolContext as al, eventMetadata as am, eventMetadataFromChatRequest as an, fromHeaders as ao, getContextManager as ap, getCurrentParentToolContext as aq, getCurrentRaindropCallMetadata as ar, normalizeFeatureFlags as as, raindrop as at, readRaindropCallMetadataFromArgs as au, redactJsonAttributeValue as av, redactSecretsInObject as aw, resetUnresolvedCarrierWarning as ax, runWithParentToolContext as ay, runWithRaindropCallMetadata as az, type AISDKMessage as b, type AgentCallMetadata as c, type AgentWithMetadata as d, type Attachment as e, ContextManager as f, type ContextSpan as g, type CreateSpanArgs as h, DEFAULT_REDACT_ATTRIBUTE_KEYS as i, DEFAULT_SECRET_KEY_NAMES as j, DETACHED_MODE as k, type DetachedChildLink as l, type DetachedDispatch as m, type EventBuilder as n, type EventMetadataOptions as o, type FeatureFlags as p, HANDOFF_ATTRIBUTE_SUFFIXES as q, HANDOFF_TERMINAL_CANCELLED as r, HANDOFF_TERMINAL_PROPERTY_KEY as s, type OtlpSpan as t, type ParentToolContext as u, type PromptToolsOverride as v, type RaindropAISDKClient as w, type RaindropAISDKContext as x, type RaindropAISDKOptions as y, type RaindropCallMetadata as z };

package/dist/{index-B_mpeckV.d.ts → index-DCYSGvxI.d.ts}

@@ -765,6 +765,46 @@ declare function getContextManager(): ContextManager;
 declare function currentSpan(): ContextSpan;
 declare function withCurrent<R>(span: ContextSpan, callback: () => R): R;
 
+/**
+ * `ai.prompt.tools`: the tool catalog a model call was given, one JSON
+ * document per tool, in the shape the Vercel AI SDK records on its
+ * `doGenerate` / `doStream` spans. Every integration emits this attribute on
+ * its model-call spans so downstream consumers (agent replay, world builder)
+ * can read what the model could call instead of guessing from the calls it
+ * happened to make.
+ *
+ * An absent attribute means the integration could not observe the tool list;
+ * an empty array means the model had no tools. Callers who know better than
+ * the integration pass a `tools` override, which replaces the inferred list.
+ */
+declare const PROMPT_TOOLS_ATTRIBUTE = "ai.prompt.tools";
+type JsonSchema = Record<string, unknown>;
+type FunctionToolDeclaration = {
+    type: "function";
+    name: string;
+    description?: string;
+    inputSchema?: JsonSchema;
+};
+type ProviderDefinedToolDeclaration = {
+    type: "provider-defined";
+    id?: string;
+    name: string;
+    args?: Record<string, unknown>;
+};
+type ToolDeclaration = FunctionToolDeclaration | ProviderDefinedToolDeclaration;
+/**
+ * What callers hand to a `tools` override. The canonical `ToolDeclaration`
+ * shape is accepted as-is; so is any framework shape `normalizeToolDeclarations`
+ * recognizes (OpenAI, Anthropic, Bedrock, LangChain, Pi, Mastra, AI SDK).
+ */
+type ToolDeclarationInput = ToolDeclaration | {
+    name: string;
+    description?: string;
+    inputSchema?: JsonSchema;
+    parameters?: JsonSchema;
+};
+type PromptToolsOverride = ReadonlyArray<ToolDeclarationInput | unknown>;
+
 declare class EventShipper extends EventShipper$1 {
     constructor(opts: ConstructorParameters<typeof EventShipper$1>[0]);
 }
@@ -1118,6 +1158,11 @@ type RaindropTelemetryIntegrationOptions = {
     debug?: boolean;
     /** See {@link SubagentApiOptions.settledEventIds}. */
     settledEventIds?: Set<string>;
+    /**
+     * Overrides the tool catalog recorded as `ai.prompt.tools` on every model
+     * span (replaces the step's tools; `[]` records an empty catalog).
+     */
+    tools?: PromptToolsOverride;
     context?: {
         userId?: string;
         eventId?: string;
@@ -1135,6 +1180,7 @@ declare class RaindropTelemetryIntegration implements TelemetryIntegration {
     private readonly subagentWrapping;
     private readonly debug;
     private readonly defaultContext;
+    private readonly promptTools;
     private readonly callStates;
     /**
      * Per-tool-call snapshot of the parent-tool ALS context taken right
@@ -1804,6 +1850,12 @@ type WrapAISDKOptions = {
      * Default: false (uses Proxy wrapping for backward compatibility).
      */
     nativeTelemetry?: boolean;
+    /**
+     * Overrides the tool catalog recorded as `ai.prompt.tools` on every model
+     * span, replacing the tools the AI SDK hands the model. `[]` records an
+     * explicitly empty catalog.
+     */
+    tools?: PromptToolsOverride;
 };
 /**
  * Opaque handle for a trace span. Pass as `parent` when creating child spans.
@@ -1900,6 +1952,7 @@ type RaindropAISDKClient = {
     createTelemetryIntegration(contextOrOptions?: RaindropTelemetryIntegrationOptions["context"] | {
         context?: RaindropTelemetryIntegrationOptions["context"];
         subagentWrapping?: boolean;
+        tools?: PromptToolsOverride;
     }): RaindropTelemetryIntegration;
     /**
      * Detached sub-agent hand-offs: record a sub-agent that runs in another
@@ -2013,6 +2066,11 @@ type RaindropTelemetryOptions = RaindropAISDKOptions & {
      * spans nest correctly. Enabled by default.
      */
     subagentWrapping?: boolean;
+    /**
+     * Overrides the tool catalog recorded as `ai.prompt.tools` on every model
+     * span. Use when the integration cannot see the tools the model was given.
+     */
+    tools?: PromptToolsOverride;
 };
 /**
  * One-line factory for the AI SDK v7 `registerTelemetry` DX.
@@ -2047,4 +2105,4 @@ type RaindropTelemetryOptions = RaindropAISDKOptions & {
  */
 declare function raindrop(options?: RaindropTelemetryOptions): RaindropTelemetryIntegration;
 
-export { type SubagentRun as $, type AISDKChatRequestLike as A, type BuildEventPatch as B, type CarrierHeaders as C, DEFAULT_MAX_TEXT_FIELD_CHARS as D, type EndSpanArgs as E, type FeatureFlagValue as F, type RaindropTelemetryOptions as G, HANDOFF_ATTRIBUTE_PREFIXES as H, type IdentifyInput as I, SUBAGENT_AGENT_ROLE as J, SUBAGENT_CANCELLED_OUTPUT as K, type SelfDiagnosticsOptions as L, type SelfDiagnosticsSignalDefinition as M, type SelfDiagnosticsSignalDefinitions as N, type OtlpAnyValue as O, type ParentToolContext as P, type SelfDiagnosticsTool as Q, REDACTED_PLACEHOLDER as R, SUBAGENT_ABORTED_OUTPUT as S, type SelfDiagnosticsToolInput as T, type SelfDiagnosticsToolOptions as U, type SelfDiagnosticsToolResult as V, type StartSpanArgs as W, SubagentApi as X, type SubagentDispatch as Y, type SubagentDispatchOptions as Z, type SubagentResumeOptions as _, type AISDKChatRequestMessageLike as a, type SubagentRunMetadata as a0, TOOL_EVENTS_ALLOW as a1, TRUNCATION_MARKER as a2, type TraceCarrier as a3, type TraceSpan as a4, type TransformSpanHook as a5, type WrapAISDKOptions as a6, type WrappedAI as a7, type WrappedAISDK as a8, _resetParentToolContextStorage as a9, _resetRaindropCallMetadataStorage as aa, _resetWarnedMissingUserId as ab, boundedStringify as ac, capText as ad, clearParentToolContext as ae, createRaindropAISDK as af, currentSpan as ag, defaultTransformSpan as ah, enterParentToolContext as ai, eventMetadata as aj, eventMetadataFromChatRequest as ak, fromHeaders as al, getContextManager as am, getCurrentParentToolContext as an, getCurrentRaindropCallMetadata as ao, normalizeFeatureFlags as ap, raindrop as aq, readRaindropCallMetadataFromArgs as ar, redactJsonAttributeValue as as, redactSecretsInObject as at, resetUnresolvedCarrierWarning as au, runWithParentToolContext as av, runWithRaindropCallMetadata as aw, toHeaders as ax, toLangSmithHeaders as ay, withCurrent as az, type AISDKMessage as b, type AgentCallMetadata as c, type AgentWithMetadata as d, type Attachment as e, ContextManager as f, type ContextSpan as g, type CreateSpanArgs as h, DEFAULT_REDACT_ATTRIBUTE_KEYS as i, DEFAULT_SECRET_KEY_NAMES as j, DETACHED_MODE as k, type DetachedChildLink as l, type DetachedDispatch as m, type EventBuilder as n, type EventMetadataOptions as o, type FeatureFlags as p, HANDOFF_ATTRIBUTE_SUFFIXES as q, HANDOFF_TERMINAL_CANCELLED as r, HANDOFF_TERMINAL_PROPERTY_KEY as s, type OtlpSpan as t, type RaindropAISDKClient as u, type RaindropAISDKContext as v, type RaindropAISDKOptions as w, type RaindropCallMetadata as x, RaindropTelemetryIntegration as y, type RaindropTelemetryIntegrationOptions as z };
+export { type SubagentDispatchOptions as $, type AISDKChatRequestLike as A, type BuildEventPatch as B, type CarrierHeaders as C, DEFAULT_MAX_TEXT_FIELD_CHARS as D, type EndSpanArgs as E, type FeatureFlagValue as F, RaindropTelemetryIntegration as G, HANDOFF_ATTRIBUTE_PREFIXES as H, type IdentifyInput as I, type RaindropTelemetryIntegrationOptions as J, type RaindropTelemetryOptions as K, SUBAGENT_AGENT_ROLE as L, SUBAGENT_CANCELLED_OUTPUT as M, type SelfDiagnosticsOptions as N, type OtlpAnyValue as O, PROMPT_TOOLS_ATTRIBUTE as P, type SelfDiagnosticsSignalDefinition as Q, REDACTED_PLACEHOLDER as R, SUBAGENT_ABORTED_OUTPUT as S, type SelfDiagnosticsSignalDefinitions as T, type SelfDiagnosticsTool as U, type SelfDiagnosticsToolInput as V, type SelfDiagnosticsToolOptions as W, type SelfDiagnosticsToolResult as X, type StartSpanArgs as Y, SubagentApi as Z, type SubagentDispatch as _, type AISDKChatRequestMessageLike as a, type SubagentResumeOptions as a0, type SubagentRun as a1, type SubagentRunMetadata as a2, TOOL_EVENTS_ALLOW as a3, TRUNCATION_MARKER as a4, type ToolDeclaration as a5, type TraceCarrier as a6, type TraceSpan as a7, type TransformSpanHook as a8, type WrapAISDKOptions as a9, toHeaders as aA, toLangSmithHeaders as aB, withCurrent as aC, type WrappedAI as aa, type WrappedAISDK as ab, _resetParentToolContextStorage as ac, _resetRaindropCallMetadataStorage as ad, _resetWarnedMissingUserId as ae, boundedStringify as af, capText as ag, clearParentToolContext as ah, createRaindropAISDK as ai, currentSpan as aj, defaultTransformSpan as ak, enterParentToolContext as al, eventMetadata as am, eventMetadataFromChatRequest as an, fromHeaders as ao, getContextManager as ap, getCurrentParentToolContext as aq, getCurrentRaindropCallMetadata as ar, normalizeFeatureFlags as as, raindrop as at, readRaindropCallMetadataFromArgs as au, redactJsonAttributeValue as av, redactSecretsInObject as aw, resetUnresolvedCarrierWarning as ax, runWithParentToolContext as ay, runWithRaindropCallMetadata as az, type AISDKMessage as b, type AgentCallMetadata as c, type AgentWithMetadata as d, type Attachment as e, ContextManager as f, type ContextSpan as g, type CreateSpanArgs as h, DEFAULT_REDACT_ATTRIBUTE_KEYS as i, DEFAULT_SECRET_KEY_NAMES as j, DETACHED_MODE as k, type DetachedChildLink as l, type DetachedDispatch as m, type EventBuilder as n, type EventMetadataOptions as o, type FeatureFlags as p, HANDOFF_ATTRIBUTE_SUFFIXES as q, HANDOFF_TERMINAL_CANCELLED as r, HANDOFF_TERMINAL_PROPERTY_KEY as s, type OtlpSpan as t, type ParentToolContext as u, type PromptToolsOverride as v, type RaindropAISDKClient as w, type RaindropAISDKContext as x, type RaindropAISDKOptions as y, type RaindropCallMetadata as z };

package/dist/index.browser.d.mts

@@ -765,6 +765,46 @@ declare function getContextManager(): ContextManager;
 declare function currentSpan(): ContextSpan;
 declare function withCurrent<R>(span: ContextSpan, callback: () => R): R;
 
+/**
+ * `ai.prompt.tools`: the tool catalog a model call was given, one JSON
+ * document per tool, in the shape the Vercel AI SDK records on its
+ * `doGenerate` / `doStream` spans. Every integration emits this attribute on
+ * its model-call spans so downstream consumers (agent replay, world builder)
+ * can read what the model could call instead of guessing from the calls it
+ * happened to make.
+ *
+ * An absent attribute means the integration could not observe the tool list;
+ * an empty array means the model had no tools. Callers who know better than
+ * the integration pass a `tools` override, which replaces the inferred list.
+ */
+declare const PROMPT_TOOLS_ATTRIBUTE = "ai.prompt.tools";
+type JsonSchema = Record<string, unknown>;
+type FunctionToolDeclaration = {
+    type: "function";
+    name: string;
+    description?: string;
+    inputSchema?: JsonSchema;
+};
+type ProviderDefinedToolDeclaration = {
+    type: "provider-defined";
+    id?: string;
+    name: string;
+    args?: Record<string, unknown>;
+};
+type ToolDeclaration = FunctionToolDeclaration | ProviderDefinedToolDeclaration;
+/**
+ * What callers hand to a `tools` override. The canonical `ToolDeclaration`
+ * shape is accepted as-is; so is any framework shape `normalizeToolDeclarations`
+ * recognizes (OpenAI, Anthropic, Bedrock, LangChain, Pi, Mastra, AI SDK).
+ */
+type ToolDeclarationInput = ToolDeclaration | {
+    name: string;
+    description?: string;
+    inputSchema?: JsonSchema;
+    parameters?: JsonSchema;
+};
+type PromptToolsOverride = ReadonlyArray<ToolDeclarationInput | unknown>;
+
 declare class EventShipper extends EventShipper$1 {
     constructor(opts: ConstructorParameters<typeof EventShipper$1>[0]);
 }
@@ -1118,6 +1158,11 @@ type RaindropTelemetryIntegrationOptions = {
     debug?: boolean;
     /** See {@link SubagentApiOptions.settledEventIds}. */
     settledEventIds?: Set<string>;
+    /**
+     * Overrides the tool catalog recorded as `ai.prompt.tools` on every model
+     * span (replaces the step's tools; `[]` records an empty catalog).
+     */
+    tools?: PromptToolsOverride;
     context?: {
         userId?: string;
         eventId?: string;
@@ -1135,6 +1180,7 @@ declare class RaindropTelemetryIntegration implements TelemetryIntegration {
     private readonly subagentWrapping;
     private readonly debug;
     private readonly defaultContext;
+    private readonly promptTools;
     private readonly callStates;
     /**
      * Per-tool-call snapshot of the parent-tool ALS context taken right
@@ -1804,6 +1850,12 @@ type WrapAISDKOptions = {
      * Default: false (uses Proxy wrapping for backward compatibility).
      */
     nativeTelemetry?: boolean;
+    /**
+     * Overrides the tool catalog recorded as `ai.prompt.tools` on every model
+     * span, replacing the tools the AI SDK hands the model. `[]` records an
+     * explicitly empty catalog.
+     */
+    tools?: PromptToolsOverride;
 };
 /**
  * Opaque handle for a trace span. Pass as `parent` when creating child spans.
@@ -1900,6 +1952,7 @@ type RaindropAISDKClient = {
     createTelemetryIntegration(contextOrOptions?: RaindropTelemetryIntegrationOptions["context"] | {
         context?: RaindropTelemetryIntegrationOptions["context"];
         subagentWrapping?: boolean;
+        tools?: PromptToolsOverride;
     }): RaindropTelemetryIntegration;
     /**
      * Detached sub-agent hand-offs: record a sub-agent that runs in another
@@ -2013,6 +2066,11 @@ type RaindropTelemetryOptions = RaindropAISDKOptions & {
      * spans nest correctly. Enabled by default.
      */
     subagentWrapping?: boolean;
+    /**
+     * Overrides the tool catalog recorded as `ai.prompt.tools` on every model
+     * span. Use when the integration cannot see the tools the model was given.
+     */
+    tools?: PromptToolsOverride;
 };
 /**
  * One-line factory for the AI SDK v7 `registerTelemetry` DX.
@@ -2047,4 +2105,4 @@ type RaindropTelemetryOptions = RaindropAISDKOptions & {
  */
 declare function raindrop(options?: RaindropTelemetryOptions): RaindropTelemetryIntegration;
 
-export { type AISDKChatRequestLike, type AISDKChatRequestMessageLike, type AISDKMessage, type AgentCallMetadata, type AgentWithMetadata, type Attachment, type BuildEventPatch, type CarrierHeaders, ContextManager, type ContextSpan, type CreateSpanArgs, DEFAULT_MAX_TEXT_FIELD_CHARS, DEFAULT_REDACT_ATTRIBUTE_KEYS, DEFAULT_SECRET_KEY_NAMES, DETACHED_MODE, type DetachedChildLink, type DetachedDispatch, type EndSpanArgs, type EventBuilder, type EventMetadataOptions, type FeatureFlagValue, type FeatureFlags, HANDOFF_ATTRIBUTE_PREFIXES, HANDOFF_ATTRIBUTE_SUFFIXES, HANDOFF_TERMINAL_CANCELLED, HANDOFF_TERMINAL_PROPERTY_KEY, type IdentifyInput, type OtlpAnyValue, type OtlpSpan, type ParentToolContext, REDACTED_PLACEHOLDER, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, type RaindropCallMetadata, RaindropTelemetryIntegration, type RaindropTelemetryIntegrationOptions, type RaindropTelemetryOptions, SUBAGENT_ABORTED_OUTPUT, SUBAGENT_AGENT_ROLE, SUBAGENT_CANCELLED_OUTPUT, type SelfDiagnosticsOptions, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type SelfDiagnosticsTool, type SelfDiagnosticsToolInput, type SelfDiagnosticsToolOptions, type SelfDiagnosticsToolResult, type StartSpanArgs, SubagentApi, type SubagentDispatch, type SubagentDispatchOptions, type SubagentResumeOptions, type SubagentRun, type SubagentRunMetadata, TOOL_EVENTS_ALLOW, TRUNCATION_MARKER, type TraceCarrier, type TraceSpan, type TransformSpanHook, type WrapAISDKOptions, type WrappedAI, type WrappedAISDK, _resetParentToolContextStorage, _resetRaindropCallMetadataStorage, _resetWarnedMissingUserId, boundedStringify, capText, clearParentToolContext, createRaindropAISDK, currentSpan, defaultTransformSpan, enterParentToolContext, eventMetadata, eventMetadataFromChatRequest, fromHeaders, getContextManager, getCurrentParentToolContext, getCurrentRaindropCallMetadata, normalizeFeatureFlags, raindrop, readRaindropCallMetadataFromArgs, redactJsonAttributeValue, redactSecretsInObject, resetUnresolvedCarrierWarning, runWithParentToolContext, runWithRaindropCallMetadata, toHeaders, toLangSmithHeaders, withCurrent };
+export { type AISDKChatRequestLike, type AISDKChatRequestMessageLike, type AISDKMessage, type AgentCallMetadata, type AgentWithMetadata, type Attachment, type BuildEventPatch, type CarrierHeaders, ContextManager, type ContextSpan, type CreateSpanArgs, DEFAULT_MAX_TEXT_FIELD_CHARS, DEFAULT_REDACT_ATTRIBUTE_KEYS, DEFAULT_SECRET_KEY_NAMES, DETACHED_MODE, type DetachedChildLink, type DetachedDispatch, type EndSpanArgs, type EventBuilder, type EventMetadataOptions, type FeatureFlagValue, type FeatureFlags, HANDOFF_ATTRIBUTE_PREFIXES, HANDOFF_ATTRIBUTE_SUFFIXES, HANDOFF_TERMINAL_CANCELLED, HANDOFF_TERMINAL_PROPERTY_KEY, type IdentifyInput, type OtlpAnyValue, type OtlpSpan, PROMPT_TOOLS_ATTRIBUTE, type ParentToolContext, type PromptToolsOverride, REDACTED_PLACEHOLDER, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, type RaindropCallMetadata, RaindropTelemetryIntegration, type RaindropTelemetryIntegrationOptions, type RaindropTelemetryOptions, SUBAGENT_ABORTED_OUTPUT, SUBAGENT_AGENT_ROLE, SUBAGENT_CANCELLED_OUTPUT, type SelfDiagnosticsOptions, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type SelfDiagnosticsTool, type SelfDiagnosticsToolInput, type SelfDiagnosticsToolOptions, type SelfDiagnosticsToolResult, type StartSpanArgs, SubagentApi, type SubagentDispatch, type SubagentDispatchOptions, type SubagentResumeOptions, type SubagentRun, type SubagentRunMetadata, TOOL_EVENTS_ALLOW, TRUNCATION_MARKER, type ToolDeclaration, type TraceCarrier, type TraceSpan, type TransformSpanHook, type WrapAISDKOptions, type WrappedAI, type WrappedAISDK, _resetParentToolContextStorage, _resetRaindropCallMetadataStorage, _resetWarnedMissingUserId, boundedStringify, capText, clearParentToolContext, createRaindropAISDK, currentSpan, defaultTransformSpan, enterParentToolContext, eventMetadata, eventMetadataFromChatRequest, fromHeaders, getContextManager, getCurrentParentToolContext, getCurrentRaindropCallMetadata, normalizeFeatureFlags, raindrop, readRaindropCallMetadataFromArgs, redactJsonAttributeValue, redactSecretsInObject, resetUnresolvedCarrierWarning, runWithParentToolContext, runWithRaindropCallMetadata, toHeaders, toLangSmithHeaders, withCurrent };

package/dist/index.browser.d.ts

@@ -765,6 +765,46 @@ declare function getContextManager(): ContextManager;
 declare function currentSpan(): ContextSpan;
 declare function withCurrent<R>(span: ContextSpan, callback: () => R): R;
 
+/**
+ * `ai.prompt.tools`: the tool catalog a model call was given, one JSON
+ * document per tool, in the shape the Vercel AI SDK records on its
+ * `doGenerate` / `doStream` spans. Every integration emits this attribute on
+ * its model-call spans so downstream consumers (agent replay, world builder)
+ * can read what the model could call instead of guessing from the calls it
+ * happened to make.
+ *
+ * An absent attribute means the integration could not observe the tool list;
+ * an empty array means the model had no tools. Callers who know better than
+ * the integration pass a `tools` override, which replaces the inferred list.
+ */
+declare const PROMPT_TOOLS_ATTRIBUTE = "ai.prompt.tools";
+type JsonSchema = Record<string, unknown>;
+type FunctionToolDeclaration = {
+    type: "function";
+    name: string;
+    description?: string;
+    inputSchema?: JsonSchema;
+};
+type ProviderDefinedToolDeclaration = {
+    type: "provider-defined";
+    id?: string;
+    name: string;
+    args?: Record<string, unknown>;
+};
+type ToolDeclaration = FunctionToolDeclaration | ProviderDefinedToolDeclaration;
+/**
+ * What callers hand to a `tools` override. The canonical `ToolDeclaration`
+ * shape is accepted as-is; so is any framework shape `normalizeToolDeclarations`
+ * recognizes (OpenAI, Anthropic, Bedrock, LangChain, Pi, Mastra, AI SDK).
+ */
+type ToolDeclarationInput = ToolDeclaration | {
+    name: string;
+    description?: string;
+    inputSchema?: JsonSchema;
+    parameters?: JsonSchema;
+};
+type PromptToolsOverride = ReadonlyArray<ToolDeclarationInput | unknown>;
+
 declare class EventShipper extends EventShipper$1 {
     constructor(opts: ConstructorParameters<typeof EventShipper$1>[0]);
 }
@@ -1118,6 +1158,11 @@ type RaindropTelemetryIntegrationOptions = {
     debug?: boolean;
     /** See {@link SubagentApiOptions.settledEventIds}. */
     settledEventIds?: Set<string>;
+    /**
+     * Overrides the tool catalog recorded as `ai.prompt.tools` on every model
+     * span (replaces the step's tools; `[]` records an empty catalog).
+     */
+    tools?: PromptToolsOverride;
     context?: {
         userId?: string;
         eventId?: string;
@@ -1135,6 +1180,7 @@ declare class RaindropTelemetryIntegration implements TelemetryIntegration {
     private readonly subagentWrapping;
     private readonly debug;
     private readonly defaultContext;
+    private readonly promptTools;
     private readonly callStates;
     /**
      * Per-tool-call snapshot of the parent-tool ALS context taken right
@@ -1804,6 +1850,12 @@ type WrapAISDKOptions = {
      * Default: false (uses Proxy wrapping for backward compatibility).
      */
     nativeTelemetry?: boolean;
+    /**
+     * Overrides the tool catalog recorded as `ai.prompt.tools` on every model
+     * span, replacing the tools the AI SDK hands the model. `[]` records an
+     * explicitly empty catalog.
+     */
+    tools?: PromptToolsOverride;
 };
 /**
  * Opaque handle for a trace span. Pass as `parent` when creating child spans.
@@ -1900,6 +1952,7 @@ type RaindropAISDKClient = {
     createTelemetryIntegration(contextOrOptions?: RaindropTelemetryIntegrationOptions["context"] | {
         context?: RaindropTelemetryIntegrationOptions["context"];
         subagentWrapping?: boolean;
+        tools?: PromptToolsOverride;
     }): RaindropTelemetryIntegration;
     /**
      * Detached sub-agent hand-offs: record a sub-agent that runs in another
@@ -2013,6 +2066,11 @@ type RaindropTelemetryOptions = RaindropAISDKOptions & {
      * spans nest correctly. Enabled by default.
      */
     subagentWrapping?: boolean;
+    /**
+     * Overrides the tool catalog recorded as `ai.prompt.tools` on every model
+     * span. Use when the integration cannot see the tools the model was given.
+     */
+    tools?: PromptToolsOverride;
 };
 /**
  * One-line factory for the AI SDK v7 `registerTelemetry` DX.
@@ -2047,4 +2105,4 @@ type RaindropTelemetryOptions = RaindropAISDKOptions & {
  */
 declare function raindrop(options?: RaindropTelemetryOptions): RaindropTelemetryIntegration;
 
-export { type AISDKChatRequestLike, type AISDKChatRequestMessageLike, type AISDKMessage, type AgentCallMetadata, type AgentWithMetadata, type Attachment, type BuildEventPatch, type CarrierHeaders, ContextManager, type ContextSpan, type CreateSpanArgs, DEFAULT_MAX_TEXT_FIELD_CHARS, DEFAULT_REDACT_ATTRIBUTE_KEYS, DEFAULT_SECRET_KEY_NAMES, DETACHED_MODE, type DetachedChildLink, type DetachedDispatch, type EndSpanArgs, type EventBuilder, type EventMetadataOptions, type FeatureFlagValue, type FeatureFlags, HANDOFF_ATTRIBUTE_PREFIXES, HANDOFF_ATTRIBUTE_SUFFIXES, HANDOFF_TERMINAL_CANCELLED, HANDOFF_TERMINAL_PROPERTY_KEY, type IdentifyInput, type OtlpAnyValue, type OtlpSpan, type ParentToolContext, REDACTED_PLACEHOLDER, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, type RaindropCallMetadata, RaindropTelemetryIntegration, type RaindropTelemetryIntegrationOptions, type RaindropTelemetryOptions, SUBAGENT_ABORTED_OUTPUT, SUBAGENT_AGENT_ROLE, SUBAGENT_CANCELLED_OUTPUT, type SelfDiagnosticsOptions, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type SelfDiagnosticsTool, type SelfDiagnosticsToolInput, type SelfDiagnosticsToolOptions, type SelfDiagnosticsToolResult, type StartSpanArgs, SubagentApi, type SubagentDispatch, type SubagentDispatchOptions, type SubagentResumeOptions, type SubagentRun, type SubagentRunMetadata, TOOL_EVENTS_ALLOW, TRUNCATION_MARKER, type TraceCarrier, type TraceSpan, type TransformSpanHook, type WrapAISDKOptions, type WrappedAI, type WrappedAISDK, _resetParentToolContextStorage, _resetRaindropCallMetadataStorage, _resetWarnedMissingUserId, boundedStringify, capText, clearParentToolContext, createRaindropAISDK, currentSpan, defaultTransformSpan, enterParentToolContext, eventMetadata, eventMetadataFromChatRequest, fromHeaders, getContextManager, getCurrentParentToolContext, getCurrentRaindropCallMetadata, normalizeFeatureFlags, raindrop, readRaindropCallMetadataFromArgs, redactJsonAttributeValue, redactSecretsInObject, resetUnresolvedCarrierWarning, runWithParentToolContext, runWithRaindropCallMetadata, toHeaders, toLangSmithHeaders, withCurrent };
+export { type AISDKChatRequestLike, type AISDKChatRequestMessageLike, type AISDKMessage, type AgentCallMetadata, type AgentWithMetadata, type Attachment, type BuildEventPatch, type CarrierHeaders, ContextManager, type ContextSpan, type CreateSpanArgs, DEFAULT_MAX_TEXT_FIELD_CHARS, DEFAULT_REDACT_ATTRIBUTE_KEYS, DEFAULT_SECRET_KEY_NAMES, DETACHED_MODE, type DetachedChildLink, type DetachedDispatch, type EndSpanArgs, type EventBuilder, type EventMetadataOptions, type FeatureFlagValue, type FeatureFlags, HANDOFF_ATTRIBUTE_PREFIXES, HANDOFF_ATTRIBUTE_SUFFIXES, HANDOFF_TERMINAL_CANCELLED, HANDOFF_TERMINAL_PROPERTY_KEY, type IdentifyInput, type OtlpAnyValue, type OtlpSpan, PROMPT_TOOLS_ATTRIBUTE, type ParentToolContext, type PromptToolsOverride, REDACTED_PLACEHOLDER, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, type RaindropCallMetadata, RaindropTelemetryIntegration, type RaindropTelemetryIntegrationOptions, type RaindropTelemetryOptions, SUBAGENT_ABORTED_OUTPUT, SUBAGENT_AGENT_ROLE, SUBAGENT_CANCELLED_OUTPUT, type SelfDiagnosticsOptions, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type SelfDiagnosticsTool, type SelfDiagnosticsToolInput, type SelfDiagnosticsToolOptions, type SelfDiagnosticsToolResult, type StartSpanArgs, SubagentApi, type SubagentDispatch, type SubagentDispatchOptions, type SubagentResumeOptions, type SubagentRun, type SubagentRunMetadata, TOOL_EVENTS_ALLOW, TRUNCATION_MARKER, type ToolDeclaration, type TraceCarrier, type TraceSpan, type TransformSpanHook, type WrapAISDKOptions, type WrappedAI, type WrappedAISDK, _resetParentToolContextStorage, _resetRaindropCallMetadataStorage, _resetWarnedMissingUserId, boundedStringify, capText, clearParentToolContext, createRaindropAISDK, currentSpan, defaultTransformSpan, enterParentToolContext, eventMetadata, eventMetadataFromChatRequest, fromHeaders, getContextManager, getCurrentParentToolContext, getCurrentRaindropCallMetadata, normalizeFeatureFlags, raindrop, readRaindropCallMetadataFromArgs, redactJsonAttributeValue, redactSecretsInObject, resetUnresolvedCarrierWarning, runWithParentToolContext, runWithRaindropCallMetadata, toHeaders, toLangSmithHeaders, withCurrent };