@raindrop-ai/strands

Raindrop integration for Strands Agents. Automatically captures agent invocations, model calls, tool usage, and token metrics via the Strands hook system.

Installation

npm install @raindrop-ai/strands @strands-agents/sdk

@strands-agents/sdk is a required peer dependency.

Usage

import { Agent } from "@strands-agents/sdk";
import { createRaindropStrandsAgents } from "@raindrop-ai/strands";

const raindrop = createRaindropStrandsAgents({
  writeKey: process.env.RAINDROP_WRITE_KEY,
  userId: "user_123",
  convoId: "session_456",
});

const agent = new Agent({
  model: "us.amazon.nova-lite-v1:0",
  systemPrompt: "You are a helpful assistant.",
});

raindrop.handler.registerHooks(agent);

const result = await agent("What is the capital of France?");
console.log(result);

await raindrop.shutdown();

Omitting writeKey disables telemetry shipping (a warning is logged) but does not crash your application.

API

createRaindropStrandsAgents(options)

Returns a client with:

• handler — RaindropCallbackHandler instance to register on agents
• events.patch(), events.finish(), events.addAttachments(), events.setProperties() — manual event lifecycle
• users.identify() — associate user traits
• signals.track() — track feedback signals
• flush() — flush pending telemetry
• shutdown() — flush and release resources

License

MIT