@raindrop-ai/ai-sdk 0.0.31 → 0.0.32

package/dist/{index-IMe7ZUXV.d.ts → index-CwK0GdEe.d.ts}

@@ -462,6 +462,7 @@ declare class RaindropTelemetryIntegration implements TelemetryIntegration {
     onLanguageModelCallStart: (_event: any) => void;
     onLanguageModelCallEnd: (_event: any) => void;
     onChunk: (event: any) => void;
+    private emitProviderExecutedToolSpans;
     onStepFinish: (event: any) => void;
     onEmbedStart: (event: any) => void;
     onEmbedFinish: (event: any) => void;
@@ -893,6 +894,38 @@ type SelfDiagnosticsOptions = {
      */
     toolName?: string;
 };
+type SelfDiagnosticsToolOptions = Omit<SelfDiagnosticsOptions, "enabled"> & {
+    /** Fixed Raindrop event ID to attach diagnostic signals to. */
+    eventId?: string;
+    /** Dynamic event ID resolver, useful when one tool instance serves many runs. */
+    getEventId?: () => string | undefined;
+    /** Behavior when no event ID can be resolved. Default: "warn" */
+    onMissingEventId?: "warn" | "ignore" | "throw";
+};
+type SelfDiagnosticsToolInput = {
+    category: string;
+    detail: string;
+};
+type SelfDiagnosticsToolResult = {
+    acknowledged: true;
+    category: string;
+} | {
+    acknowledged: false;
+    category: string;
+    reason: "missing_event_id";
+};
+type SelfDiagnosticsTool = {
+    name: string;
+    description: string;
+    /**
+     * AI SDK v4 tool schema. This is the same cross-version schema object as
+     * `inputSchema`; both fields are exposed so the tool works on AI SDK v4-v7.
+     */
+    parameters: any;
+    /** AI SDK v5+ tool schema. */
+    inputSchema: any;
+    execute(input: SelfDiagnosticsToolInput): Promise<SelfDiagnosticsToolResult>;
+};
 type WrapAISDKOptions = {
     context: RaindropAISDKContext | ((info: {
         operation: string;
@@ -977,6 +1010,14 @@ type EventPatch = {
 };
 type RaindropAISDKClient = {
     wrap<T extends object>(aiSDK: T, options?: WrapAISDKOptions): WrappedAISDK<T>;
+    /**
+     * Create a standalone AI SDK self-diagnostics tool.
+     *
+     * The tool automatically uses the active Raindrop event while executing
+     * under `createTelemetryIntegration()` with tracing enabled. Pass `eventId`
+     * or `getEventId` when no active trace context is available.
+     */
+    createSelfDiagnosticsTool(options?: SelfDiagnosticsToolOptions): SelfDiagnosticsTool;
     /**
      * Create a TelemetryIntegration instance for direct registration with AI SDK v7+.
      * Use with `registerTelemetryIntegration()` from the `ai` package.
@@ -1062,4 +1103,4 @@ type RaindropAISDKClient = {
 };
 declare function createRaindropAISDK(opts: RaindropAISDKOptions): RaindropAISDKClient;
 
-export { withCurrent as $, type AISDKChatRequestLike as A, type BuildEventPatch as B, ContextManager as C, DEFAULT_REDACT_ATTRIBUTE_KEYS as D, type EndSpanArgs as E, createRaindropAISDK as F, currentSpan as G, defaultTransformSpan as H, type IdentifyInput as I, enterParentToolContext as J, eventMetadata as K, eventMetadataFromChatRequest as L, getContextManager as M, getCurrentParentToolContext as N, type OtlpAnyValue as O, type ParentToolContext as P, getCurrentRaindropCallMetadata as Q, REDACTED_PLACEHOLDER as R, type SelfDiagnosticsOptions as S, type TraceSpan as T, readRaindropCallMetadataFromArgs as U, redactJsonAttributeValue as V, type WrapAISDKOptions as W, redactSecretsInObject as X, runWithParentToolContext as Y, runWithRaindropCallMetadata as Z, _resetParentToolContextStorage as _, type AISDKChatRequestMessageLike as a, type AISDKMessage as b, type AgentCallMetadata as c, type AgentWithMetadata as d, type Attachment as e, type ContextSpan as f, type CreateSpanArgs as g, DEFAULT_SECRET_KEY_NAMES as h, type EventBuilder as i, type EventMetadataOptions as j, type OtlpSpan as k, type RaindropAISDKClient as l, type RaindropAISDKContext as m, type RaindropAISDKOptions as n, type RaindropCallMetadata as o, RaindropTelemetryIntegration as p, type RaindropTelemetryIntegrationOptions as q, type SelfDiagnosticsSignalDefinition as r, type SelfDiagnosticsSignalDefinitions as s, type StartSpanArgs as t, type TransformSpanHook as u, type WrappedAI as v, type WrappedAISDK as w, _resetRaindropCallMetadataStorage as x, _resetWarnedMissingUserId as y, clearParentToolContext as z };
+export { redactJsonAttributeValue as $, type AISDKChatRequestLike as A, type BuildEventPatch as B, ContextManager as C, DEFAULT_REDACT_ATTRIBUTE_KEYS as D, type EndSpanArgs as E, type WrappedAISDK as F, _resetRaindropCallMetadataStorage as G, _resetWarnedMissingUserId as H, type IdentifyInput as I, clearParentToolContext as J, createRaindropAISDK as K, currentSpan as L, defaultTransformSpan as M, enterParentToolContext as N, type OtlpAnyValue as O, type ParentToolContext as P, eventMetadata as Q, REDACTED_PLACEHOLDER as R, type SelfDiagnosticsOptions as S, type TraceSpan as T, eventMetadataFromChatRequest as U, getContextManager as V, type WrapAISDKOptions as W, getCurrentParentToolContext as X, getCurrentRaindropCallMetadata as Y, readRaindropCallMetadataFromArgs as Z, _resetParentToolContextStorage as _, type AISDKChatRequestMessageLike as a, redactSecretsInObject as a0, runWithParentToolContext as a1, runWithRaindropCallMetadata as a2, withCurrent as a3, type AISDKMessage as b, type AgentCallMetadata as c, type AgentWithMetadata as d, type Attachment as e, type ContextSpan as f, type CreateSpanArgs as g, DEFAULT_SECRET_KEY_NAMES as h, type EventBuilder as i, type EventMetadataOptions as j, type OtlpSpan as k, type RaindropAISDKClient as l, type RaindropAISDKContext as m, type RaindropAISDKOptions as n, type RaindropCallMetadata as o, RaindropTelemetryIntegration as p, type RaindropTelemetryIntegrationOptions as q, type SelfDiagnosticsSignalDefinition as r, type SelfDiagnosticsSignalDefinitions as s, type SelfDiagnosticsTool as t, type SelfDiagnosticsToolInput as u, type SelfDiagnosticsToolOptions as v, type SelfDiagnosticsToolResult as w, type StartSpanArgs as x, type TransformSpanHook as y, type WrappedAI as z };

package/dist/index.browser.d.mts

@@ -462,6 +462,7 @@ declare class RaindropTelemetryIntegration implements TelemetryIntegration {
     onLanguageModelCallStart: (_event: any) => void;
     onLanguageModelCallEnd: (_event: any) => void;
     onChunk: (event: any) => void;
+    private emitProviderExecutedToolSpans;
     onStepFinish: (event: any) => void;
     onEmbedStart: (event: any) => void;
     onEmbedFinish: (event: any) => void;
@@ -893,6 +894,38 @@ type SelfDiagnosticsOptions = {
      */
     toolName?: string;
 };
+type SelfDiagnosticsToolOptions = Omit<SelfDiagnosticsOptions, "enabled"> & {
+    /** Fixed Raindrop event ID to attach diagnostic signals to. */
+    eventId?: string;
+    /** Dynamic event ID resolver, useful when one tool instance serves many runs. */
+    getEventId?: () => string | undefined;
+    /** Behavior when no event ID can be resolved. Default: "warn" */
+    onMissingEventId?: "warn" | "ignore" | "throw";
+};
+type SelfDiagnosticsToolInput = {
+    category: string;
+    detail: string;
+};
+type SelfDiagnosticsToolResult = {
+    acknowledged: true;
+    category: string;
+} | {
+    acknowledged: false;
+    category: string;
+    reason: "missing_event_id";
+};
+type SelfDiagnosticsTool = {
+    name: string;
+    description: string;
+    /**
+     * AI SDK v4 tool schema. This is the same cross-version schema object as
+     * `inputSchema`; both fields are exposed so the tool works on AI SDK v4-v7.
+     */
+    parameters: any;
+    /** AI SDK v5+ tool schema. */
+    inputSchema: any;
+    execute(input: SelfDiagnosticsToolInput): Promise<SelfDiagnosticsToolResult>;
+};
 type WrapAISDKOptions = {
     context: RaindropAISDKContext | ((info: {
         operation: string;
@@ -977,6 +1010,14 @@ type EventPatch = {
 };
 type RaindropAISDKClient = {
     wrap<T extends object>(aiSDK: T, options?: WrapAISDKOptions): WrappedAISDK<T>;
+    /**
+     * Create a standalone AI SDK self-diagnostics tool.
+     *
+     * The tool automatically uses the active Raindrop event while executing
+     * under `createTelemetryIntegration()` with tracing enabled. Pass `eventId`
+     * or `getEventId` when no active trace context is available.
+     */
+    createSelfDiagnosticsTool(options?: SelfDiagnosticsToolOptions): SelfDiagnosticsTool;
     /**
      * Create a TelemetryIntegration instance for direct registration with AI SDK v7+.
      * Use with `registerTelemetryIntegration()` from the `ai` package.
@@ -1062,4 +1103,4 @@ type RaindropAISDKClient = {
 };
 declare function createRaindropAISDK(opts: RaindropAISDKOptions): RaindropAISDKClient;
 
-export { type AISDKChatRequestLike, type AISDKChatRequestMessageLike, type AISDKMessage, type AgentCallMetadata, type AgentWithMetadata, type Attachment, type BuildEventPatch, ContextManager, type ContextSpan, type CreateSpanArgs, DEFAULT_REDACT_ATTRIBUTE_KEYS, DEFAULT_SECRET_KEY_NAMES, type EndSpanArgs, type EventBuilder, type EventMetadataOptions, type IdentifyInput, type OtlpAnyValue, type OtlpSpan, type ParentToolContext, REDACTED_PLACEHOLDER, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, type RaindropCallMetadata, RaindropTelemetryIntegration, type RaindropTelemetryIntegrationOptions, type SelfDiagnosticsOptions, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type StartSpanArgs, type TraceSpan, type TransformSpanHook, type WrapAISDKOptions, type WrappedAI, type WrappedAISDK, _resetParentToolContextStorage, _resetRaindropCallMetadataStorage, _resetWarnedMissingUserId, clearParentToolContext, createRaindropAISDK, currentSpan, defaultTransformSpan, enterParentToolContext, eventMetadata, eventMetadataFromChatRequest, getContextManager, getCurrentParentToolContext, getCurrentRaindropCallMetadata, readRaindropCallMetadataFromArgs, redactJsonAttributeValue, redactSecretsInObject, runWithParentToolContext, runWithRaindropCallMetadata, withCurrent };
+export { type AISDKChatRequestLike, type AISDKChatRequestMessageLike, type AISDKMessage, type AgentCallMetadata, type AgentWithMetadata, type Attachment, type BuildEventPatch, ContextManager, type ContextSpan, type CreateSpanArgs, DEFAULT_REDACT_ATTRIBUTE_KEYS, DEFAULT_SECRET_KEY_NAMES, type EndSpanArgs, type EventBuilder, type EventMetadataOptions, type IdentifyInput, type OtlpAnyValue, type OtlpSpan, type ParentToolContext, REDACTED_PLACEHOLDER, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, type RaindropCallMetadata, RaindropTelemetryIntegration, type RaindropTelemetryIntegrationOptions, type SelfDiagnosticsOptions, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type SelfDiagnosticsTool, type SelfDiagnosticsToolInput, type SelfDiagnosticsToolOptions, type SelfDiagnosticsToolResult, type StartSpanArgs, type TraceSpan, type TransformSpanHook, type WrapAISDKOptions, type WrappedAI, type WrappedAISDK, _resetParentToolContextStorage, _resetRaindropCallMetadataStorage, _resetWarnedMissingUserId, clearParentToolContext, createRaindropAISDK, currentSpan, defaultTransformSpan, enterParentToolContext, eventMetadata, eventMetadataFromChatRequest, getContextManager, getCurrentParentToolContext, getCurrentRaindropCallMetadata, readRaindropCallMetadataFromArgs, redactJsonAttributeValue, redactSecretsInObject, runWithParentToolContext, runWithRaindropCallMetadata, withCurrent };

package/dist/index.browser.d.ts

@@ -462,6 +462,7 @@ declare class RaindropTelemetryIntegration implements TelemetryIntegration {
     onLanguageModelCallStart: (_event: any) => void;
     onLanguageModelCallEnd: (_event: any) => void;
     onChunk: (event: any) => void;
+    private emitProviderExecutedToolSpans;
     onStepFinish: (event: any) => void;
     onEmbedStart: (event: any) => void;
     onEmbedFinish: (event: any) => void;
@@ -893,6 +894,38 @@ type SelfDiagnosticsOptions = {
      */
     toolName?: string;
 };
+type SelfDiagnosticsToolOptions = Omit<SelfDiagnosticsOptions, "enabled"> & {
+    /** Fixed Raindrop event ID to attach diagnostic signals to. */
+    eventId?: string;
+    /** Dynamic event ID resolver, useful when one tool instance serves many runs. */
+    getEventId?: () => string | undefined;
+    /** Behavior when no event ID can be resolved. Default: "warn" */
+    onMissingEventId?: "warn" | "ignore" | "throw";
+};
+type SelfDiagnosticsToolInput = {
+    category: string;
+    detail: string;
+};
+type SelfDiagnosticsToolResult = {
+    acknowledged: true;
+    category: string;
+} | {
+    acknowledged: false;
+    category: string;
+    reason: "missing_event_id";
+};
+type SelfDiagnosticsTool = {
+    name: string;
+    description: string;
+    /**
+     * AI SDK v4 tool schema. This is the same cross-version schema object as
+     * `inputSchema`; both fields are exposed so the tool works on AI SDK v4-v7.
+     */
+    parameters: any;
+    /** AI SDK v5+ tool schema. */
+    inputSchema: any;
+    execute(input: SelfDiagnosticsToolInput): Promise<SelfDiagnosticsToolResult>;
+};
 type WrapAISDKOptions = {
     context: RaindropAISDKContext | ((info: {
         operation: string;
@@ -977,6 +1010,14 @@ type EventPatch = {
 };
 type RaindropAISDKClient = {
     wrap<T extends object>(aiSDK: T, options?: WrapAISDKOptions): WrappedAISDK<T>;
+    /**
+     * Create a standalone AI SDK self-diagnostics tool.
+     *
+     * The tool automatically uses the active Raindrop event while executing
+     * under `createTelemetryIntegration()` with tracing enabled. Pass `eventId`
+     * or `getEventId` when no active trace context is available.
+     */
+    createSelfDiagnosticsTool(options?: SelfDiagnosticsToolOptions): SelfDiagnosticsTool;
     /**
      * Create a TelemetryIntegration instance for direct registration with AI SDK v7+.
      * Use with `registerTelemetryIntegration()` from the `ai` package.
@@ -1062,4 +1103,4 @@ type RaindropAISDKClient = {
 };
 declare function createRaindropAISDK(opts: RaindropAISDKOptions): RaindropAISDKClient;
 
-export { type AISDKChatRequestLike, type AISDKChatRequestMessageLike, type AISDKMessage, type AgentCallMetadata, type AgentWithMetadata, type Attachment, type BuildEventPatch, ContextManager, type ContextSpan, type CreateSpanArgs, DEFAULT_REDACT_ATTRIBUTE_KEYS, DEFAULT_SECRET_KEY_NAMES, type EndSpanArgs, type EventBuilder, type EventMetadataOptions, type IdentifyInput, type OtlpAnyValue, type OtlpSpan, type ParentToolContext, REDACTED_PLACEHOLDER, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, type RaindropCallMetadata, RaindropTelemetryIntegration, type RaindropTelemetryIntegrationOptions, type SelfDiagnosticsOptions, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type StartSpanArgs, type TraceSpan, type TransformSpanHook, type WrapAISDKOptions, type WrappedAI, type WrappedAISDK, _resetParentToolContextStorage, _resetRaindropCallMetadataStorage, _resetWarnedMissingUserId, clearParentToolContext, createRaindropAISDK, currentSpan, defaultTransformSpan, enterParentToolContext, eventMetadata, eventMetadataFromChatRequest, getContextManager, getCurrentParentToolContext, getCurrentRaindropCallMetadata, readRaindropCallMetadataFromArgs, redactJsonAttributeValue, redactSecretsInObject, runWithParentToolContext, runWithRaindropCallMetadata, withCurrent };
+export { type AISDKChatRequestLike, type AISDKChatRequestMessageLike, type AISDKMessage, type AgentCallMetadata, type AgentWithMetadata, type Attachment, type BuildEventPatch, ContextManager, type ContextSpan, type CreateSpanArgs, DEFAULT_REDACT_ATTRIBUTE_KEYS, DEFAULT_SECRET_KEY_NAMES, type EndSpanArgs, type EventBuilder, type EventMetadataOptions, type IdentifyInput, type OtlpAnyValue, type OtlpSpan, type ParentToolContext, REDACTED_PLACEHOLDER, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, type RaindropCallMetadata, RaindropTelemetryIntegration, type RaindropTelemetryIntegrationOptions, type SelfDiagnosticsOptions, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type SelfDiagnosticsTool, type SelfDiagnosticsToolInput, type SelfDiagnosticsToolOptions, type SelfDiagnosticsToolResult, type StartSpanArgs, type TraceSpan, type TransformSpanHook, type WrapAISDKOptions, type WrappedAI, type WrappedAISDK, _resetParentToolContextStorage, _resetRaindropCallMetadataStorage, _resetWarnedMissingUserId, clearParentToolContext, createRaindropAISDK, currentSpan, defaultTransformSpan, enterParentToolContext, eventMetadata, eventMetadataFromChatRequest, getContextManager, getCurrentParentToolContext, getCurrentRaindropCallMetadata, readRaindropCallMetadataFromArgs, redactJsonAttributeValue, redactSecretsInObject, runWithParentToolContext, runWithRaindropCallMetadata, withCurrent };