@raindrop-ai/ai-sdk 0.0.16 → 0.0.18

package/dist/index.d.mts

@@ -81,6 +81,34 @@ type EventMetadataOptions = {
  * ```
  */
 declare function eventMetadata(options: EventMetadataOptions): Record<string, string>;
+type AISDKChatRequestMessageLike = {
+    id?: string;
+    role?: string;
+    [key: string]: unknown;
+};
+type AISDKChatRequestLike = {
+    id?: string;
+    messageId?: string;
+    trigger?: string;
+    messages?: AISDKChatRequestMessageLike[];
+    [key: string]: unknown;
+};
+/**
+ * Creates stable Raindrop metadata from an AI SDK UI chat request body.
+ *
+ * This is useful for `useChat` applications that require multiple server round-trips
+ * for a single user turn, e.g. when the model triggers client-side tools.
+ *
+ * The helper derives:
+ * - `convoId` from the AI SDK chat request `id`
+ * - `eventId` from the latest user message id in `messages`
+ *
+ * Reusing the same derived `eventId` across tool handoff round-trips allows the
+ * wrapper to patch one logical event instead of creating a new event per POST.
+ */
+declare function eventMetadataFromChatRequest(options: EventMetadataOptions & {
+    request: AISDKChatRequestLike;
+}): Record<string, string>;
 type AgentCallMetadata = ReturnType<typeof eventMetadata>;
 type NormalizeUnknownAgentOptions<T> = T extends {
     options: infer CallOptions;
@@ -102,18 +130,18 @@ type AgentWithMetadata<A> = A extends {
         metadata?: AgentCallMetadata;
     }, ...Rest] : StreamArgs): StreamReturn;
 } : A;
+type AgentConstructor = abstract new (...args: any[]) => any;
+type WrapAgentExport<T extends object, K extends PropertyKey> = K extends keyof T ? T[K] extends AgentConstructor ? Omit<T, K> & {
+    [P in K]: new (...args: ConstructorParameters<T[K]>) => AgentWithMetadata<InstanceType<T[K]>>;
+} : T : T;
 /**
  * Structural wrapper type for AI SDK modules.
  *
- * - AI SDK v6: rewrites `ToolLoopAgent` constructor instance methods to accept
- *   `metadata` on `generate/stream`.
- * - AI SDK v4/v5: no `ToolLoopAgent` export, so the type is unchanged.
+ * Rewrites AI SDK agent constructor exports so their instance `generate()` and
+ * `stream()` methods accept Raindrop `metadata` while preserving original
+ * return types. Covers the current and deprecated public export names.
  */
-type WrappedAISDK<T extends object> = T extends {
-    ToolLoopAgent: abstract new (...args: any[]) => any;
-} ? Omit<T, "ToolLoopAgent"> & {
-    ToolLoopAgent: new (...args: ConstructorParameters<T["ToolLoopAgent"]>) => AgentWithMetadata<InstanceType<T["ToolLoopAgent"]>>;
-} : T;
+type WrappedAISDK<T extends object> = WrapAgentExport<WrapAgentExport<WrapAgentExport<T, "ToolLoopAgent">, "Experimental_Agent">, "Agent">;
 /**
  * Backward-compatible alias for wrapped AI SDK module types.
  *
@@ -282,4 +310,4 @@ type RaindropAISDKClient = {
 };
 declare function createRaindropAISDK(opts: RaindropAISDKOptions): RaindropAISDKClient;
 
-export { type AISDKMessage, type AgentCallMetadata, type AgentWithMetadata, type Attachment, type BuildEventPatch, ContextManager, type ContextSpan, type EventBuilder, type EventMetadataOptions, type IdentifyInput, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, type SelfDiagnosticsOptions, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type WrapAISDKOptions, type WrappedAI, type WrappedAISDK, _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, getContextManager, withCurrent };
+export { type AISDKChatRequestLike, type AISDKChatRequestMessageLike, type AISDKMessage, type AgentCallMetadata, type AgentWithMetadata, type Attachment, type BuildEventPatch, ContextManager, type ContextSpan, type EventBuilder, type EventMetadataOptions, type IdentifyInput, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, type SelfDiagnosticsOptions, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type WrapAISDKOptions, type WrappedAI, type WrappedAISDK, _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, eventMetadataFromChatRequest, getContextManager, withCurrent };

package/dist/index.d.ts

@@ -81,6 +81,34 @@ type EventMetadataOptions = {
  * ```
  */
 declare function eventMetadata(options: EventMetadataOptions): Record<string, string>;
+type AISDKChatRequestMessageLike = {
+    id?: string;
+    role?: string;
+    [key: string]: unknown;
+};
+type AISDKChatRequestLike = {
+    id?: string;
+    messageId?: string;
+    trigger?: string;
+    messages?: AISDKChatRequestMessageLike[];
+    [key: string]: unknown;
+};
+/**
+ * Creates stable Raindrop metadata from an AI SDK UI chat request body.
+ *
+ * This is useful for `useChat` applications that require multiple server round-trips
+ * for a single user turn, e.g. when the model triggers client-side tools.
+ *
+ * The helper derives:
+ * - `convoId` from the AI SDK chat request `id`
+ * - `eventId` from the latest user message id in `messages`
+ *
+ * Reusing the same derived `eventId` across tool handoff round-trips allows the
+ * wrapper to patch one logical event instead of creating a new event per POST.
+ */
+declare function eventMetadataFromChatRequest(options: EventMetadataOptions & {
+    request: AISDKChatRequestLike;
+}): Record<string, string>;
 type AgentCallMetadata = ReturnType<typeof eventMetadata>;
 type NormalizeUnknownAgentOptions<T> = T extends {
     options: infer CallOptions;
@@ -102,18 +130,18 @@ type AgentWithMetadata<A> = A extends {
         metadata?: AgentCallMetadata;
     }, ...Rest] : StreamArgs): StreamReturn;
 } : A;
+type AgentConstructor = abstract new (...args: any[]) => any;
+type WrapAgentExport<T extends object, K extends PropertyKey> = K extends keyof T ? T[K] extends AgentConstructor ? Omit<T, K> & {
+    [P in K]: new (...args: ConstructorParameters<T[K]>) => AgentWithMetadata<InstanceType<T[K]>>;
+} : T : T;
 /**
  * Structural wrapper type for AI SDK modules.
  *
- * - AI SDK v6: rewrites `ToolLoopAgent` constructor instance methods to accept
- *   `metadata` on `generate/stream`.
- * - AI SDK v4/v5: no `ToolLoopAgent` export, so the type is unchanged.
+ * Rewrites AI SDK agent constructor exports so their instance `generate()` and
+ * `stream()` methods accept Raindrop `metadata` while preserving original
+ * return types. Covers the current and deprecated public export names.
  */
-type WrappedAISDK<T extends object> = T extends {
-    ToolLoopAgent: abstract new (...args: any[]) => any;
-} ? Omit<T, "ToolLoopAgent"> & {
-    ToolLoopAgent: new (...args: ConstructorParameters<T["ToolLoopAgent"]>) => AgentWithMetadata<InstanceType<T["ToolLoopAgent"]>>;
-} : T;
+type WrappedAISDK<T extends object> = WrapAgentExport<WrapAgentExport<WrapAgentExport<T, "ToolLoopAgent">, "Experimental_Agent">, "Agent">;
 /**
  * Backward-compatible alias for wrapped AI SDK module types.
  *
@@ -282,4 +310,4 @@ type RaindropAISDKClient = {
 };
 declare function createRaindropAISDK(opts: RaindropAISDKOptions): RaindropAISDKClient;
 
-export { type AISDKMessage, type AgentCallMetadata, type AgentWithMetadata, type Attachment, type BuildEventPatch, ContextManager, type ContextSpan, type EventBuilder, type EventMetadataOptions, type IdentifyInput, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, type SelfDiagnosticsOptions, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type WrapAISDKOptions, type WrappedAI, type WrappedAISDK, _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, getContextManager, withCurrent };
+export { type AISDKChatRequestLike, type AISDKChatRequestMessageLike, type AISDKMessage, type AgentCallMetadata, type AgentWithMetadata, type Attachment, type BuildEventPatch, ContextManager, type ContextSpan, type EventBuilder, type EventMetadataOptions, type IdentifyInput, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, type SelfDiagnosticsOptions, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type WrapAISDKOptions, type WrappedAI, type WrappedAISDK, _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, eventMetadataFromChatRequest, getContextManager, withCurrent };