rd-mini 0.1.0

package/dist/transport.js

@@ -0,0 +1,288 @@
+/**
+ * HTTP Transport for Raindrop
+ * Fire-and-forget with buffering and retry
+ */
+export class Transport {
+    config;
+    queue = [];
+    flushTimeout = null;
+    FLUSH_INTERVAL = 1000; // 1 second
+    MAX_QUEUE_SIZE = 100;
+    MAX_RETRIES = 3;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Send a trace event (fire-and-forget)
+     */
+    sendTrace(trace) {
+        if (this.config.disabled)
+            return;
+        this.enqueue({
+            type: 'trace',
+            data: this.formatTrace(trace),
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Send feedback/signal event
+     */
+    sendFeedback(traceId, feedback) {
+        if (this.config.disabled)
+            return;
+        this.enqueue({
+            type: 'feedback',
+            data: {
+                event_id: traceId,
+                signal_name: feedback.type || (feedback.score !== undefined && feedback.score >= 0.5 ? 'positive' : 'negative'),
+                sentiment: feedback.score !== undefined
+                    ? (feedback.score >= 0.5 ? 'POSITIVE' : 'NEGATIVE')
+                    : (feedback.type === 'thumbs_up' ? 'POSITIVE' : 'NEGATIVE'),
+                signal_type: feedback.signalType || 'default',
+                timestamp: feedback.timestamp || new Date().toISOString(),
+                ...(feedback.attachmentId && { attachment_id: feedback.attachmentId }),
+                properties: {
+                    score: feedback.score,
+                    comment: feedback.comment,
+                    ...feedback.properties,
+                },
+            },
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Send user identification
+     */
+    sendIdentify(userId, traits) {
+        if (this.config.disabled)
+            return;
+        this.enqueue({
+            type: 'identify',
+            data: {
+                user_id: userId,
+                traits,
+            },
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Send an interaction with nested spans
+     */
+    sendInteraction(interaction) {
+        if (this.config.disabled)
+            return;
+        this.enqueue({
+            type: 'interaction',
+            data: this.formatInteraction(interaction),
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Format interaction data for API
+     */
+    formatInteraction(interaction) {
+        // Convert spans to attachments for now (until we have proper nested trace support)
+        const spanAttachments = interaction.spans.map(span => ({
+            type: 'code',
+            name: `${span.type}:${span.name}`,
+            value: JSON.stringify({
+                spanId: span.spanId,
+                input: span.input,
+                output: span.output,
+                latencyMs: span.latencyMs,
+                error: span.error,
+                properties: span.properties,
+            }),
+            role: 'output',
+            language: 'json',
+        }));
+        // Combine user attachments with span attachments
+        const allAttachments = [
+            ...(interaction.attachments || []),
+            ...spanAttachments,
+        ];
+        return {
+            event_id: interaction.interactionId,
+            user_id: interaction.userId,
+            event: interaction.event,
+            timestamp: new Date(interaction.startTime).toISOString(),
+            properties: {
+                latency_ms: interaction.latencyMs,
+                span_count: interaction.spans.length,
+                ...(interaction.error && { error: interaction.error }),
+                ...interaction.properties,
+            },
+            ai_data: {
+                input: interaction.input,
+                output: interaction.output,
+                convo_id: interaction.conversationId,
+            },
+            ...(allAttachments.length > 0 && { attachments: allAttachments }),
+        };
+    }
+    /**
+     * Format trace data for API
+     */
+    formatTrace(trace) {
+        return {
+            event_id: trace.traceId,
+            user_id: trace.userId,
+            event: 'ai_interaction',
+            timestamp: new Date(trace.startTime).toISOString(),
+            properties: {
+                provider: trace.provider,
+                conversation_id: trace.conversationId,
+                latency_ms: trace.latencyMs,
+                // Token usage
+                ...(trace.tokens && {
+                    input_tokens: trace.tokens.input,
+                    output_tokens: trace.tokens.output,
+                    total_tokens: trace.tokens.total,
+                }),
+                // Error info
+                ...(trace.error && { error: trace.error }),
+                ...trace.properties,
+            },
+            ai_data: {
+                model: trace.model,
+                input: typeof trace.input === 'string' ? trace.input : JSON.stringify(trace.input),
+                output: trace.output ? (typeof trace.output === 'string' ? trace.output : JSON.stringify(trace.output)) : undefined,
+                convo_id: trace.conversationId,
+            },
+            // Include tool calls if present
+            ...(trace.toolCalls && trace.toolCalls.length > 0 && {
+                attachments: trace.toolCalls.map(tc => ({
+                    type: 'code',
+                    name: `tool:${tc.name}`,
+                    value: JSON.stringify({ arguments: tc.arguments, result: tc.result }),
+                    role: 'output',
+                    language: 'json',
+                })),
+            }),
+        };
+    }
+    /**
+     * Enqueue an event for sending
+     */
+    enqueue(event) {
+        this.queue.push(event);
+        if (this.config.debug) {
+            console.log('[raindrop] Queued event:', event.type, event.data);
+        }
+        // Flush if queue is full
+        if (this.queue.length >= this.MAX_QUEUE_SIZE) {
+            this.flush();
+            return;
+        }
+        // Schedule flush
+        if (!this.flushTimeout) {
+            this.flushTimeout = setTimeout(() => this.flush(), this.FLUSH_INTERVAL);
+        }
+    }
+    /**
+     * Flush all queued events
+     */
+    async flush() {
+        if (this.flushTimeout) {
+            clearTimeout(this.flushTimeout);
+            this.flushTimeout = null;
+        }
+        if (this.queue.length === 0)
+            return;
+        const events = [...this.queue];
+        this.queue = [];
+        // Group by type for batch sending
+        const traces = events.filter(e => e.type === 'trace').map(e => e.data);
+        const interactions = events.filter(e => e.type === 'interaction').map(e => e.data);
+        const feedbacks = events.filter(e => e.type === 'feedback').map(e => e.data);
+        const identifies = events.filter(e => e.type === 'identify').map(e => e.data);
+        // Send in parallel, fire-and-forget
+        const promises = [];
+        // Combine traces and interactions - both go to /events/track
+        const allTraces = [...traces, ...interactions];
+        if (allTraces.length > 0) {
+            promises.push(this.sendBatch('/events/track', allTraces));
+        }
+        if (feedbacks.length > 0) {
+            promises.push(this.sendBatch('/signals/track', feedbacks));
+        }
+        for (const identify of identifies) {
+            promises.push(this.sendSingle('/users/identify', identify));
+        }
+        // Wait but don't throw
+        await Promise.allSettled(promises);
+    }
+    /**
+     * Send a batch of events
+     */
+    async sendBatch(endpoint, data, retries = 0) {
+        try {
+            const response = await fetch(`${this.config.baseUrl}/v1${endpoint}`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${this.config.apiKey}`,
+                },
+                body: JSON.stringify(data),
+            });
+            if (!response.ok && retries < this.MAX_RETRIES) {
+                if (this.config.debug) {
+                    console.warn(`[raindrop] Request failed (${response.status}), retrying...`);
+                }
+                await this.delay(Math.pow(2, retries) * 100);
+                return this.sendBatch(endpoint, data, retries + 1);
+            }
+            if (this.config.debug && response.ok) {
+                console.log(`[raindrop] Sent ${data.length} events to ${endpoint}`);
+            }
+        }
+        catch (error) {
+            if (retries < this.MAX_RETRIES) {
+                await this.delay(Math.pow(2, retries) * 100);
+                return this.sendBatch(endpoint, data, retries + 1);
+            }
+            if (this.config.debug) {
+                console.warn('[raindrop] Failed to send events:', error);
+            }
+            // Fire-and-forget: swallow the error
+        }
+    }
+    /**
+     * Send a single event
+     */
+    async sendSingle(endpoint, data, retries = 0) {
+        try {
+            const response = await fetch(`${this.config.baseUrl}/v1${endpoint}`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${this.config.apiKey}`,
+                },
+                body: JSON.stringify(data),
+            });
+            if (!response.ok && retries < this.MAX_RETRIES) {
+                await this.delay(Math.pow(2, retries) * 100);
+                return this.sendSingle(endpoint, data, retries + 1);
+            }
+        }
+        catch (error) {
+            if (retries < this.MAX_RETRIES) {
+                await this.delay(Math.pow(2, retries) * 100);
+                return this.sendSingle(endpoint, data, retries + 1);
+            }
+            if (this.config.debug) {
+                console.warn('[raindrop] Failed to send event:', error);
+            }
+        }
+    }
+    delay(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    /**
+     * Close transport and flush remaining events
+     */
+    async close() {
+        await this.flush();
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Raindrop SDK Types
+ */
+export interface RaindropConfig {
+    /** Your Raindrop API key */
+    apiKey: string;
+    /** Base URL for API (default: https://api.raindrop.ai) */
+    baseUrl?: string;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Disable all tracking (useful for tests) */
+    disabled?: boolean;
+}
+export interface UserTraits {
+    name?: string;
+    email?: string;
+    plan?: string;
+    [key: string]: unknown;
+}
+export interface TraceData {
+    traceId: string;
+    provider: 'openai' | 'anthropic' | 'ai-sdk' | 'unknown';
+    model: string;
+    input: unknown;
+    output?: unknown;
+    startTime: number;
+    endTime?: number;
+    latencyMs?: number;
+    tokens?: {
+        input?: number;
+        output?: number;
+        total?: number;
+    };
+    toolCalls?: ToolCall[];
+    userId?: string;
+    conversationId?: string;
+    error?: string;
+    properties?: Record<string, unknown>;
+}
+export interface ToolCall {
+    id: string;
+    name: string;
+    arguments: unknown;
+    result?: unknown;
+}
+export interface FeedbackOptions {
+    /** Score from 0 to 1, or use type for categorical */
+    score?: number;
+    /** Categorical feedback type */
+    type?: 'thumbs_up' | 'thumbs_down';
+    /** Optional comment */
+    comment?: string;
+    /** Signal type: default, feedback, edit, or standard */
+    signalType?: 'default' | 'feedback' | 'edit' | 'standard';
+    /** Reference to a specific attachment */
+    attachmentId?: string;
+    /** ISO timestamp (auto-generated if not provided) */
+    timestamp?: string;
+    /** Additional properties */
+    properties?: Record<string, unknown>;
+}
+export interface RaindropRequestOptions {
+    /** Override user ID for this request */
+    userId?: string;
+    /** Conversation ID for threading */
+    conversationId?: string;
+    /** Custom trace ID (generated if not provided) */
+    traceId?: string;
+    /** Additional properties */
+    properties?: Record<string, unknown>;
+}
+/**
+ * Extended response type that includes _traceId
+ */
+export type WithTraceId<T> = T & {
+    _traceId: string;
+};
+/**
+ * Provider detection result
+ */
+export type ProviderType = 'openai' | 'anthropic' | 'ai-sdk' | 'unknown';
+/**
+ * Interaction options for withInteraction()
+ */
+export interface InteractionOptions {
+    /** User ID for this interaction */
+    userId?: string;
+    /** Event name (e.g., "rag_query", "chat_message") */
+    event?: string;
+    /** Input to the interaction (user's query) */
+    input?: string;
+    /** Conversation ID for threading */
+    conversationId?: string;
+    /** Additional properties */
+    properties?: Record<string, unknown>;
+}
+/**
+ * Tool wrapper options
+ */
+export interface WrapToolOptions {
+    /** Version number for the tool */
+    version?: number;
+    /** Additional properties */
+    properties?: Record<string, unknown>;
+}
+/**
+ * Internal context for tracking interaction state
+ */
+export interface InteractionContext {
+    interactionId: string;
+    userId?: string;
+    conversationId?: string;
+    startTime: number;
+    input?: string;
+    output?: string;
+    model?: string;
+    event?: string;
+    properties?: Record<string, unknown>;
+    attachments?: Attachment[];
+    spans: SpanData[];
+}
+/**
+ * Attachment types for events
+ */
+export interface Attachment {
+    type: 'code' | 'text' | 'image' | 'iframe';
+    name?: string;
+    value: string;
+    role: 'input' | 'output';
+    language?: string;
+}
+/**
+ * Options for begin() method
+ */
+export interface BeginOptions {
+    /** Custom event ID (generated if not provided) */
+    eventId?: string;
+    /** User ID for this interaction */
+    userId?: string;
+    /** Event name (e.g., "rag_query", "chat_message") */
+    event?: string;
+    /** Input to the interaction (user's query) */
+    input?: string;
+    /** AI model being used */
+    model?: string;
+    /** Conversation ID for threading */
+    conversationId?: string;
+    /** Additional properties */
+    properties?: Record<string, unknown>;
+    /** Initial attachments */
+    attachments?: Attachment[];
+}
+/**
+ * Options for finish() method
+ */
+export interface FinishOptions {
+    /** The final output of the interaction */
+    output?: string;
+    /** Additional properties to merge */
+    properties?: Record<string, unknown>;
+    /** Additional attachments to add */
+    attachments?: Attachment[];
+}
+/**
+ * Span data for tools and tasks
+ */
+export interface SpanData {
+    spanId: string;
+    parentId?: string;
+    name: string;
+    type: 'tool' | 'ai';
+    startTime: number;
+    endTime?: number;
+    latencyMs?: number;
+    input?: unknown;
+    output?: unknown;
+    error?: string;
+    properties?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,cAAc;IAC7B,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,IAAI,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC;IACnC,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,UAAU,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC;IAC1D,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,sBAAsB;IACrC,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,0BAA0B;IAC1B,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,oCAAoC;IACpC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Raindrop SDK Types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/wrappers/ai-sdk.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Vercel AI SDK Wrapper
+ * Wraps AI SDK model providers to auto-capture all calls
+ */
+import type { TraceData, RaindropRequestOptions, InteractionContext } from '../types.js';
+type LanguageModel = {
+    modelId: string;
+    provider: string;
+    doGenerate?: (options: unknown) => Promise<unknown>;
+    doStream?: (options: unknown) => Promise<unknown>;
+    [key: string]: unknown;
+};
+export interface AISDKWrapperContext {
+    generateTraceId: () => string;
+    sendTrace: (trace: TraceData) => void;
+    getUserId: () => string | undefined;
+    getInteractionContext: () => InteractionContext | undefined;
+    debug: boolean;
+}
+/**
+ * Wrap a Vercel AI SDK model to auto-trace calls
+ *
+ * Usage:
+ *   const model = raindrop.wrap(openai('gpt-4o'));
+ *   const result = await generateText({ model, prompt: '...' });
+ */
+export declare function wrapAISDKModel<T extends LanguageModel>(model: T, context: AISDKWrapperContext, defaultOptions?: RaindropRequestOptions): T & {
+    _raindropContext: AISDKWrapperContext;
+    _raindropOptions?: RaindropRequestOptions;
+};
+export {};
+//# sourceMappingURL=ai-sdk.d.ts.map

package/dist/wrappers/ai-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-sdk.d.ts","sourceRoot":"","sources":["../../src/wrappers/ai-sdk.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,sBAAsB,EAAE,kBAAkB,EAAY,MAAM,aAAa,CAAC;AAGnG,KAAK,aAAa,GAAG;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,MAAM,MAAM,CAAC;IAC9B,SAAS,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACtC,SAAS,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACpC,qBAAqB,EAAE,MAAM,kBAAkB,GAAG,SAAS,CAAC;IAC5D,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,aAAa,EACpD,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,mBAAmB,EAC5B,cAAc,CAAC,EAAE,sBAAsB,GACtC,CAAC,GAAG;IAAE,gBAAgB,EAAE,mBAAmB,CAAC;IAAC,gBAAgB,CAAC,EAAE,sBAAsB,CAAA;CAAE,CAiT1F"}