@raindrop-ai/ai-sdk 0.3.2 → 0.3.3

package/README.md

@@ -71,6 +71,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`,