@raindrop-ai/wizard 0.0.3 → 0.0.4

package/dist/src/docs/vercel-ai-sdk.mdx

@@ -234,25 +234,26 @@ If you need full manual control over attachments, set `autoAttachment: false` in
   `context` in `wrap()` is optional and useful for defaults. If both are
   present, call-time `eventMetadata()` wins.
 
-  ```typescript
-  const { generateText } = raindrop.wrap(ai, {
-    context: {
-      userId, // Fallback defaults
-      properties: {
-        wizardSession: '__WIZARD_SESSION_UUID__', // REQUIRED
-      },
-    },
-  });
-
-  await generateText({
-    model,
-    prompt,
-    experimental_telemetry: {
-      isEnabled: true,
-      metadata: eventMetadata({ userId: actualUserId }),
+```typescript
+const { generateText } = raindrop.wrap(ai, {
+  context: {
+    userId, // Fallback defaults
+    properties: {
+      wizardSession: '__WIZARD_SESSION_UUID__', // REQUIRED
     },
-  });
-  ```
+  },
+});
+
+await generateText({
+  model,
+  prompt,
+  experimental_telemetry: {
+    isEnabled: true,
+    metadata: eventMetadata({ userId: actualUserId }),
+  },
+});
+```
+
 </Info>
 
 ---
@@ -431,14 +432,32 @@ const person = await result.object;
 ## ToolLoopAgent
 
 <Info>Requires AI SDK v6 or later.</Info>
+ToolLoopAgent is wrapped automatically. Both `generate()` and `stream()` trace tool
+calls with their arguments and results. Pass per-call context via the top-level `metadata`
+parameter.
+
+### Typescript
+
+`raindrop.wrap(ai)` changes the `ToolLoopAgent` method signatures to accept
+top-level `metadata`, so typing against `ai.ToolLoopAgent` can cause TypeScript
+errors. If you define your own agent type, wrap the AI SDK type with
+`AgentWithMetadata` so `metadata` is still accepted on `generate()` and
+`stream()`:
 
-ToolLoopAgent is wrapped automatically. Both `generate()` and `stream()` trace
-tool calls with their arguments and results.
+```typescript
+import * as ai from 'ai';
+import type { ToolSet } from 'ai';
+import type { AgentWithMetadata } from '@raindrop-ai/ai-sdk';
+
+export type YourToolLoopAgent = AgentWithMetadata<
+  ai.ToolLoopAgent<unknown, ToolSet, any>
+>;
+```
 
 ### generate
 
 ```typescript
-import { ToolLoopAgent, tool } from 'ai';
+import * as ai from 'ai';
 import { openai } from '@ai-sdk/openai';
 import { z } from 'zod';
 import { createRaindropAISDK, eventMetadata } from '@raindrop-ai/ai-sdk';
@@ -447,15 +466,9 @@ const raindrop = createRaindropAISDK({
   writeKey: process.env.RAINDROP_WRITE_KEY!,
 });
 
-const { ToolLoopAgent } = raindrop.wrap(ai, {
-  context: {
-    properties: {
-      wizardSession: '__WIZARD_SESSION_UUID__', // REQUIRED
-    },
-  },
-});
+const wrapped = raindrop.wrap(ai);
 
-const weatherTool = tool({
+const weatherTool = ai.tool({
   description: 'Get current weather',
   parameters: z.object({ city: z.string() }),
   execute: async ({ city }) => {
@@ -470,14 +483,11 @@ const agent = new ToolLoopAgent({
 });
 
 const result = await agent.generate({
-  prompt: "What's the weather in Tokyo?",
-  experimental_telemetry: {
-    isEnabled: true,
-    metadata: eventMetadata({
-      userId,
-      eventName,
-    }),
-  },
+  prompt,
+  metadata: eventMetadata({
+    userId,
+    eventName,
+  }),
 });
 ```
 
@@ -487,14 +497,11 @@ const result = await agent.generate({
 import { eventMetadata } from '@raindrop-ai/ai-sdk';
 
 const result = await agent.stream({
-  prompt: "What's the weather in Tokyo?",
-  experimental_telemetry: {
-    isEnabled: true,
-    metadata: eventMetadata({
-      userId,
-      eventName,
-    }),
-  },
+  prompt,
+  metadata: eventMetadata({
+    userId,
+    eventName,
+  }),
 });
 
 for await (const chunk of result.textStream) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raindrop-ai/wizard",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "type": "module",
   "homepage": "https://github.com/raindrop/wizard",
   "repository": "https://github.com/raindrop/wizard",