raindrop-ai 0.0.43 → 0.0.45

package/dist/{chunk-UQBASHHQ.mjs → chunk-BCJTP4MY.mjs}

@@ -1819,6 +1819,17 @@ var NonLiveInteraction = class {
   }
 };
 
+// src/tracing/nonLiveTracer.ts
+var NoOpTracer = class {
+  withSpan(_params, fn, thisArg, ...args) {
+    try {
+      return Promise.resolve(fn.apply(thisArg, args));
+    } catch (error) {
+      return Promise.reject(error);
+    }
+  }
+};
+
 // src/tracing/tracer-core.ts
 var getGlobalRegistry = () => {
   if (typeof window !== "undefined") {
@@ -1860,6 +1871,9 @@ var createTracing = (analytics, _apiUrl, _writeKey, _options, isDebug = false) =
   getActiveInteraction(eventId) {
     return new NonLiveInteraction({ eventId }, void 0, analytics);
   },
+  tracer(globalProperties) {
+    return new NoOpTracer();
+  },
   async close() {
   }
 });

package/dist/{index-CPL3oZVf.d.mts → index-gF5ZqfKW.d.mts}

@@ -21,6 +21,7 @@ interface TrackEvent {
 type BasicSignal = {
     eventId: string;
     name: "thumbs_up" | "thumbs_down" | string;
+    sentiment?: "POSITIVE" | "NEGATIVE";
     timestamp?: string;
     properties?: {
         [key: string]: any;
@@ -93,11 +94,15 @@ type TraceContextOutput = Omit<PartialAiTrackEvent, "eventId"> & {
  * @property kind - Category of the task (llm, tool, retrival, or internal)
  * @property properties - Optional key-value pairs for additional metadata
  * @property inputParameters - Optional array of input parameters for the task
+ * @property traceContent - Optional flag to control whether content is traced
+ * @property suppressTracing - Optional flag to suppress tracing for this task
  */
 interface SpanParams {
     name: string;
     properties?: Record<string, string>;
     inputParameters?: unknown[];
+    traceContent?: boolean;
+    suppressTracing?: boolean;
 }
 /**
  * Configuration for a traced tool.
@@ -304,6 +309,15 @@ type Interaction = {
      */
     finish(resultEvent: TraceContextOutput): void;
 };
+type Tracer = {
+    /**
+     * Creates a traced task that executes the provided function.
+     *
+     * @param params TaskParams object with task configuration
+     * @returns A span that can be used to record a task
+     */
+    withSpan<T>(params: SpanParams, fn: (...args: any[]) => Promise<T> | T, thisArg?: any, ...args: any[]): Promise<T>;
+};
 
 interface AnalyticsConfig {
     writeKey: string;
@@ -339,6 +353,15 @@ declare class Raindrop {
         event: string;
         userId: string;
     }): Interaction;
+    /**
+     * Returns a tracer object that can be used to create spans and tools that aren't tied to any interaction.
+     * For chat interaction use-case `begin` should be used.
+     * This is meant for batch jobs or other non-interactive use-cases where you only care about tracing and token usage.
+     *
+     * @param globalProperties - Optional global properties to be associated with all spans and tools.
+     * @returns The tracer object.
+     */
+    tracer(globalProperties?: Record<string, string>): Tracer;
     /**
      * Resumes an existing interaction.
      *
@@ -399,4 +422,4 @@ declare class Raindrop {
     close(): Promise<void>;
 }
 
-export { type Interaction as I, MAX_INGEST_SIZE_BYTES as M, type PartialAiTrackEvent as P, Raindrop as R };
+export { type Interaction as I, MAX_INGEST_SIZE_BYTES as M, type PartialAiTrackEvent as P, Raindrop as R, type Tracer as T };

package/dist/{index-CPL3oZVf.d.ts → index-gF5ZqfKW.d.ts}

@@ -21,6 +21,7 @@ interface TrackEvent {
 type BasicSignal = {
     eventId: string;
     name: "thumbs_up" | "thumbs_down" | string;
+    sentiment?: "POSITIVE" | "NEGATIVE";
     timestamp?: string;
     properties?: {
         [key: string]: any;
@@ -93,11 +94,15 @@ type TraceContextOutput = Omit<PartialAiTrackEvent, "eventId"> & {
  * @property kind - Category of the task (llm, tool, retrival, or internal)
  * @property properties - Optional key-value pairs for additional metadata
  * @property inputParameters - Optional array of input parameters for the task
+ * @property traceContent - Optional flag to control whether content is traced
+ * @property suppressTracing - Optional flag to suppress tracing for this task
  */
 interface SpanParams {
     name: string;
     properties?: Record<string, string>;
     inputParameters?: unknown[];
+    traceContent?: boolean;
+    suppressTracing?: boolean;
 }
 /**
  * Configuration for a traced tool.
@@ -304,6 +309,15 @@ type Interaction = {
      */
     finish(resultEvent: TraceContextOutput): void;
 };
+type Tracer = {
+    /**
+     * Creates a traced task that executes the provided function.
+     *
+     * @param params TaskParams object with task configuration
+     * @returns A span that can be used to record a task
+     */
+    withSpan<T>(params: SpanParams, fn: (...args: any[]) => Promise<T> | T, thisArg?: any, ...args: any[]): Promise<T>;
+};
 
 interface AnalyticsConfig {
     writeKey: string;
@@ -339,6 +353,15 @@ declare class Raindrop {
         event: string;
         userId: string;
     }): Interaction;
+    /**
+     * Returns a tracer object that can be used to create spans and tools that aren't tied to any interaction.
+     * For chat interaction use-case `begin` should be used.
+     * This is meant for batch jobs or other non-interactive use-cases where you only care about tracing and token usage.
+     *
+     * @param globalProperties - Optional global properties to be associated with all spans and tools.
+     * @returns The tracer object.
+     */
+    tracer(globalProperties?: Record<string, string>): Tracer;
     /**
      * Resumes an existing interaction.
      *
@@ -399,4 +422,4 @@ declare class Raindrop {
     close(): Promise<void>;
 }
 
-export { type Interaction as I, MAX_INGEST_SIZE_BYTES as M, type PartialAiTrackEvent as P, Raindrop as R };
+export { type Interaction as I, MAX_INGEST_SIZE_BYTES as M, type PartialAiTrackEvent as P, Raindrop as R, type Tracer as T };

package/dist/index.d.mts

@@ -1,3 +1,3 @@
-export { M as MAX_INGEST_SIZE_BYTES, R as Raindrop, R as default } from './index-CPL3oZVf.mjs';
+export { M as MAX_INGEST_SIZE_BYTES, R as Raindrop, R as default } from './index-gF5ZqfKW.mjs';
 import '@dawn/schemas/ingest';
 import '@opentelemetry/api';

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export { M as MAX_INGEST_SIZE_BYTES, R as Raindrop, R as default } from './index-CPL3oZVf.js';
+export { M as MAX_INGEST_SIZE_BYTES, R as Raindrop, R as default } from './index-gF5ZqfKW.js';
 import '@dawn/schemas/ingest';
 import '@opentelemetry/api';

package/dist/index.js

@@ -86,8 +86,9 @@ var SignalEventSchema = import_zod.z.object({
   event_id: import_zod.z.string(),
   signal_name: import_zod.z.string(),
   timestamp: import_zod.z.coerce.date().optional(),
-  properties: import_zod.z.record(import_zod.z.any()).optional(),
-  attachment_id: import_zod.z.string().optional(),
+  properties: import_zod.z.record(import_zod.z.any()).optional().nullable(),
+  attachment_id: import_zod.z.string().optional().nullable(),
+  sentiment: import_zod.z.enum(["POSITIVE", "NEGATIVE"]).optional().nullable(),
   signal_type: import_zod.z.enum(["default", "feedback", "edit", "standard"]).default("default")
 });
 var LegacyAiTrackEventSchema = TrackEventSchema.extend({
@@ -107,7 +108,7 @@ var CategorizationRequestSchema = import_zod.z.object({
 // package.json
 var package_default = {
   name: "raindrop-ai",
-  version: "0.0.43",
+  version: "0.0.45",
   main: "dist/index.js",
   module: "dist/index.mjs",
   types: "dist/index.d.ts",
@@ -370,6 +371,17 @@ var NonLiveInteraction = class {
   }
 };
 
+// src/tracing/nonLiveTracer.ts
+var NoOpTracer = class {
+  withSpan(_params, fn, thisArg, ...args) {
+    try {
+      return Promise.resolve(fn.apply(thisArg, args));
+    } catch (error) {
+      return Promise.reject(error);
+    }
+  }
+};
+
 // src/tracing/tracer-core.ts
 var getGlobalRegistry = () => {
   if (typeof window !== "undefined") {
@@ -411,6 +423,9 @@ var createTracing = (analytics, _apiUrl, _writeKey, _options, isDebug = false) =
   getActiveInteraction(eventId) {
     return new NonLiveInteraction({ eventId }, void 0, analytics);
   },
+  tracer(globalProperties) {
+    return new NoOpTracer();
+  },
   async close() {
   }
 });
@@ -508,6 +523,17 @@ var Raindrop = class {
   begin(traceContext) {
     return this._tracing.begin(traceContext);
   }
+  /**
+   * Returns a tracer object that can be used to create spans and tools that aren't tied to any interaction.
+   * For chat interaction use-case `begin` should be used.
+   * This is meant for batch jobs or other non-interactive use-cases where you only care about tracing and token usage.
+   *
+   * @param globalProperties - Optional global properties to be associated with all spans and tools.
+   * @returns The tracer object.
+   */
+  tracer(globalProperties) {
+    return this._tracing.tracer(globalProperties);
+  }
   /**
    * Resumes an existing interaction.
    *
@@ -621,6 +647,7 @@ var Raindrop = class {
         event_id: s.eventId,
         signal_name: s.name,
         timestamp: s.timestamp,
+        sentiment: s.sentiment,
         properties: {
           ...s.properties,
           ..."comment" in s ? { comment: s.comment } : {},

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import {
   tracing
-} from "./chunk-UQBASHHQ.mjs";
+} from "./chunk-BCJTP4MY.mjs";
 
 // ../schemas/src/ingest/index.ts
 import { z } from "zod";
@@ -62,8 +62,9 @@ var SignalEventSchema = z.object({
   event_id: z.string(),
   signal_name: z.string(),
   timestamp: z.coerce.date().optional(),
-  properties: z.record(z.any()).optional(),
-  attachment_id: z.string().optional(),
+  properties: z.record(z.any()).optional().nullable(),
+  attachment_id: z.string().optional().nullable(),
+  sentiment: z.enum(["POSITIVE", "NEGATIVE"]).optional().nullable(),
   signal_type: z.enum(["default", "feedback", "edit", "standard"]).default("default")
 });
 var LegacyAiTrackEventSchema = TrackEventSchema.extend({
@@ -83,7 +84,7 @@ var CategorizationRequestSchema = z.object({
 // package.json
 var package_default = {
   name: "raindrop-ai",
-  version: "0.0.43",
+  version: "0.0.45",
   main: "dist/index.js",
   module: "dist/index.mjs",
   types: "dist/index.d.ts",
@@ -314,6 +315,17 @@ var Raindrop = class {
   begin(traceContext) {
     return this._tracing.begin(traceContext);
   }
+  /**
+   * Returns a tracer object that can be used to create spans and tools that aren't tied to any interaction.
+   * For chat interaction use-case `begin` should be used.
+   * This is meant for batch jobs or other non-interactive use-cases where you only care about tracing and token usage.
+   *
+   * @param globalProperties - Optional global properties to be associated with all spans and tools.
+   * @returns The tracer object.
+   */
+  tracer(globalProperties) {
+    return this._tracing.tracer(globalProperties);
+  }
   /**
    * Resumes an existing interaction.
    *
@@ -427,6 +439,7 @@ var Raindrop = class {
         event_id: s.eventId,
         signal_name: s.name,
         timestamp: s.timestamp,
+        sentiment: s.sentiment,
         properties: {
           ...s.properties,
           ..."comment" in s ? { comment: s.comment } : {},

package/dist/tracing/index.d.mts

@@ -1,11 +1,12 @@
 import * as traceloop from '@traceloop/node-server-sdk';
-import { R as Raindrop, P as PartialAiTrackEvent, I as Interaction } from '../index-CPL3oZVf.mjs';
+import { R as Raindrop, P as PartialAiTrackEvent, I as Interaction, T as Tracer } from '../index-gF5ZqfKW.mjs';
 import '@dawn/schemas/ingest';
 import '@opentelemetry/api';
 
 declare const tracing: (analytics: Raindrop, apiUrl: string, writeKey: string, options: traceloop.InitializeOptions, isDebug?: boolean) => {
     begin(traceContext: PartialAiTrackEvent): Interaction;
     getActiveInteraction(eventId: string): Interaction;
+    tracer(globalProperties?: Record<string, string>): Tracer;
     close(): Promise<void>;
 };
 declare function initTracing(): void;

package/dist/tracing/index.d.ts

@@ -1,11 +1,12 @@
 import * as traceloop from '@traceloop/node-server-sdk';
-import { R as Raindrop, P as PartialAiTrackEvent, I as Interaction } from '../index-CPL3oZVf.js';
+import { R as Raindrop, P as PartialAiTrackEvent, I as Interaction, T as Tracer } from '../index-gF5ZqfKW.js';
 import '@dawn/schemas/ingest';
 import '@opentelemetry/api';
 
 declare const tracing: (analytics: Raindrop, apiUrl: string, writeKey: string, options: traceloop.InitializeOptions, isDebug?: boolean) => {
     begin(traceContext: PartialAiTrackEvent): Interaction;
     getActiveInteraction(eventId: string): Interaction;
+    tracer(globalProperties?: Record<string, string>): Tracer;
     close(): Promise<void>;
 };
 declare function initTracing(): void;

package/dist/tracing/index.js

@@ -147578,7 +147578,9 @@ var LiveInteraction = class {
       {
         name: taskName,
         associationProperties: properties,
-        inputParameters
+        inputParameters,
+        traceContent: params.traceContent,
+        suppressTracing: params.suppressTracing
       },
       fn,
       thisArg,
@@ -147664,6 +147666,35 @@ var LiveInteraction = class {
   }
 };
 
+// src/tracing/liveTracer.ts
+var LiveTracer = class {
+  constructor(globalProperties) {
+    this.globalProperties = globalProperties || {};
+  }
+  async withSpan(params, fn, thisArg, ...args) {
+    const taskName = typeof params === "string" ? params : params.name;
+    const properties = typeof params === "string" ? {
+      ...this.globalProperties
+    } : {
+      ...this.globalProperties,
+      ...params.properties || {}
+    };
+    const inputParameters = typeof params === "string" ? void 0 : params.inputParameters;
+    return withTask(
+      {
+        name: taskName,
+        associationProperties: properties,
+        inputParameters,
+        traceContent: params.traceContent,
+        suppressTracing: params.suppressTracing
+      },
+      fn,
+      thisArg,
+      ...args
+    );
+  }
+};
+
 // src/tracing/noOpSpan.ts
 init_esm();
 var INVALID_SPAN_CONTEXT2 = {
@@ -147841,6 +147872,9 @@ var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
       }
       return activeInteractions.get(traceId) || new NonLiveInteraction({ eventId }, void 0, analytics);
     },
+    tracer(globalProperties) {
+      return new LiveTracer(globalProperties);
+    },
     async close() {
       activeInteractions.clear();
       await forceFlush();

package/dist/tracing/index.mjs

@@ -29,7 +29,7 @@ import {
   metrics,
   propagation,
   trace
-} from "../chunk-UQBASHHQ.mjs";
+} from "../chunk-BCJTP4MY.mjs";
 
 // ../../node_modules/@opentelemetry/sdk-node/node_modules/@opentelemetry/core/build/esm/trace/suppress-tracing.js
 function suppressTracing(context2) {
@@ -145893,7 +145893,9 @@ var LiveInteraction = class {
       {
         name: taskName,
         associationProperties: properties,
-        inputParameters
+        inputParameters,
+        traceContent: params.traceContent,
+        suppressTracing: params.suppressTracing
       },
       fn,
       thisArg,
@@ -145979,6 +145981,35 @@ var LiveInteraction = class {
   }
 };
 
+// src/tracing/liveTracer.ts
+var LiveTracer = class {
+  constructor(globalProperties) {
+    this.globalProperties = globalProperties || {};
+  }
+  async withSpan(params, fn, thisArg, ...args) {
+    const taskName = typeof params === "string" ? params : params.name;
+    const properties = typeof params === "string" ? {
+      ...this.globalProperties
+    } : {
+      ...this.globalProperties,
+      ...params.properties || {}
+    };
+    const inputParameters = typeof params === "string" ? void 0 : params.inputParameters;
+    return withTask(
+      {
+        name: taskName,
+        associationProperties: properties,
+        inputParameters,
+        traceContent: params.traceContent,
+        suppressTracing: params.suppressTracing
+      },
+      fn,
+      thisArg,
+      ...args
+    );
+  }
+};
+
 // src/tracing/index.ts
 var activeInteractions = new WeakValueMap();
 function getCurrentTraceId() {
@@ -146021,6 +146052,9 @@ var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
       }
       return activeInteractions.get(traceId) || new NonLiveInteraction({ eventId }, void 0, analytics);
     },
+    tracer(globalProperties) {
+      return new LiveTracer(globalProperties);
+    },
     async close() {
       activeInteractions.clear();
       await forceFlush();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "raindrop-ai",
-  "version": "0.0.43",
+  "version": "0.0.45",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -60,4 +60,4 @@
     "dts": true,
     "clean": true
   }
-}
+}