@raindrop-ai/ai-sdk 0.3.2 → 0.3.4

package/README.md

@@ -55,6 +55,28 @@ await raindrop.users.identify({
 await raindrop.flush();
 ```
 
+## Tool catalog capture
+
+Every model-call span (`ai.generateText.doGenerate`, `ai.streamText.doStream`, ...)
+records the tools the model was given as `ai.prompt.tools`: one JSON document per
+tool with `name`, `description` and the JSON Schema as `inputSchema` (Zod and other
+framework schemas are converted through the AI SDK's own `asSchema`). Provider-defined
+tools (`openai.web_search`, ...) keep their `id` / `args` and get no invented schema.
+This works on both the `wrap()` Proxy path and the v7 native telemetry path and is
+gated by `recordInputs`, like `ai.prompt.messages`.
+
+| Option | Type | Default | Description |
+| --- | --- | --- | --- |
+| `tools` | `ToolDeclaration[]` | - | 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. |
+
+```ts
+// wrap() path
+const { generateText } = raindrop.wrap(ai, { context: { userId }, tools: myToolCatalog });
+// v7 native telemetry path
+registerTelemetry(raindrop({ writeKey, tools: myToolCatalog }));
+registerTelemetry(client.createTelemetryIntegration({ context: { userId }, tools: [] }));
+```
+
 ## Projects
 
 If your org has multiple projects, route events to a specific one by passing its
@@ -71,6 +93,32 @@ This sets the `X-Raindrop-Project-Id` header on every event and trace. Omit it
 (or pass `"default"`) to use your org's default **Production** project — the
 existing behavior. Single-project orgs need nothing new.
 
+## Application Git identity
+
+Each client reports the application commit SHA when it can determine one. In Node.js, local Git discovery runs in the background and never delays or fails application calls. Browser and edge builds do not import Node Git/filesystem APIs. Automatic branch discovery is off by default.
+
+```ts
+const raindrop = createRaindropAISDK({
+  writeKey: process.env.RAINDROP_WRITE_KEY!,
+  appGit: {
+    commitSha: "0123456789abcdef0123456789abcdef01234567",
+    commitDirty: false,
+    branch: "main",
+    detectBranch: true,
+    sourceDirectory: "/path/to/application",
+  },
+});
+
+const withoutGit = createRaindropAISDK({
+  writeKey: process.env.RAINDROP_WRITE_KEY!,
+  appGit: false,
+});
+```
+
+`commitSha`, `commitDirty`, and `branch` are explicit overrides. `detectBranch` opts into automatic branch lookup, `sourceDirectory` selects the application repository, and `autoDetect: false` disables automatic sources while retaining explicit values.
+
+Integration authors combining this client with another telemetry exporter can pass the same core `appGitContext` to both feeds. The injected context takes precedence over `appGit`; stop every feed that shares it before calling `shutdown()`, which disposes the context. Disposal is idempotent.
+
 ## Payload size limits
 
 Text fields (event input/output, tool/LLM span payloads such as `ai.prompt`,