raindrop-ai 0.0.42 → 0.0.43

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

@@ -1769,6 +1769,13 @@ var NonLiveInteraction = class {
       return Promise.reject(error);
     }
   }
+  withTool(_params, fn, thisArg, ...args) {
+    try {
+      return Promise.resolve(fn.apply(thisArg, args));
+    } catch (error) {
+      return Promise.reject(error);
+    }
+  }
   startSpan(_params) {
     return NO_OP_SPAN;
   }

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

@@ -99,6 +99,27 @@ interface SpanParams {
     properties?: Record<string, string>;
     inputParameters?: unknown[];
 }
+/**
+ * Configuration for a traced tool.
+ *
+ * Tools represent external utilities or services that are invoked during an AI interaction,
+ * such as search engines, calculators, or other specialized functions.
+ *
+ * @property name - Name of the tool for identification in traces
+ * @property version - Optional version number of the tool
+ * @property properties - Optional key-value pairs for additional metadata
+ * @property inputParameters - Optional record of input parameters for the tool
+ * @property traceContent - Optional flag to control whether content is traced
+ * @property suppressTracing - Optional flag to suppress tracing for this tool invocation
+ */
+interface ToolParams {
+    name: string;
+    version?: number;
+    properties?: Record<string, string>;
+    inputParameters?: Record<string, any>;
+    traceContent?: boolean;
+    suppressTracing?: boolean;
+}
 /**
  * Represents an active tracing interaction for tracking and analyzing AI interactions.
  *
@@ -151,6 +172,43 @@ type Interaction = {
      * @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>;
+    /**
+     * Creates a traced tool that executes the provided function.
+     *
+     * Tools represent external utilities or services that are invoked during an AI interaction.
+     * This method wraps a function call with tracing to capture the tool's inputs and outputs.
+     *
+     * @param params ToolParams object with tool configuration
+     * @param fn Function to execute within the tool trace
+     * @param thisArg Optional 'this' context for the function
+     * @param args Optional arguments to pass to the function
+     * @returns A promise that resolves with the tool execution result
+     *
+     * @example
+     * // Basic tool usage
+     * const result = await interaction.withTool(
+     *   { name: "search_tool" },
+     *   async () => {
+     *     // Call to external API or service
+     *     return "Search results";
+     *   }
+     * );
+     *
+     * @example
+     * // Basic tool usage
+     * const result = await interaction.withTool(
+     *   {
+     *     name: "calculator",
+     *     properties: { operation: "multiply" },
+     *     inputParameters: { a: 5, b: 10 }
+     *   },
+     *   async () => {
+     *     // Tool implementation
+     *     return "Result: 50";
+     *   }
+     * );
+     */
+    withTool<T>(params: ToolParams, fn: (...args: any[]) => Promise<T> | T, thisArg?: any, ...args: any[]): Promise<T>;
     /**
      * Creates a task span that can be used to manually record a task.
      *

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

@@ -99,6 +99,27 @@ interface SpanParams {
     properties?: Record<string, string>;
     inputParameters?: unknown[];
 }
+/**
+ * Configuration for a traced tool.
+ *
+ * Tools represent external utilities or services that are invoked during an AI interaction,
+ * such as search engines, calculators, or other specialized functions.
+ *
+ * @property name - Name of the tool for identification in traces
+ * @property version - Optional version number of the tool
+ * @property properties - Optional key-value pairs for additional metadata
+ * @property inputParameters - Optional record of input parameters for the tool
+ * @property traceContent - Optional flag to control whether content is traced
+ * @property suppressTracing - Optional flag to suppress tracing for this tool invocation
+ */
+interface ToolParams {
+    name: string;
+    version?: number;
+    properties?: Record<string, string>;
+    inputParameters?: Record<string, any>;
+    traceContent?: boolean;
+    suppressTracing?: boolean;
+}
 /**
  * Represents an active tracing interaction for tracking and analyzing AI interactions.
  *
@@ -151,6 +172,43 @@ type Interaction = {
      * @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>;
+    /**
+     * Creates a traced tool that executes the provided function.
+     *
+     * Tools represent external utilities or services that are invoked during an AI interaction.
+     * This method wraps a function call with tracing to capture the tool's inputs and outputs.
+     *
+     * @param params ToolParams object with tool configuration
+     * @param fn Function to execute within the tool trace
+     * @param thisArg Optional 'this' context for the function
+     * @param args Optional arguments to pass to the function
+     * @returns A promise that resolves with the tool execution result
+     *
+     * @example
+     * // Basic tool usage
+     * const result = await interaction.withTool(
+     *   { name: "search_tool" },
+     *   async () => {
+     *     // Call to external API or service
+     *     return "Search results";
+     *   }
+     * );
+     *
+     * @example
+     * // Basic tool usage
+     * const result = await interaction.withTool(
+     *   {
+     *     name: "calculator",
+     *     properties: { operation: "multiply" },
+     *     inputParameters: { a: 5, b: 10 }
+     *   },
+     *   async () => {
+     *     // Tool implementation
+     *     return "Result: 50";
+     *   }
+     * );
+     */
+    withTool<T>(params: ToolParams, fn: (...args: any[]) => Promise<T> | T, thisArg?: any, ...args: any[]): Promise<T>;
     /**
      * Creates a task span that can be used to manually record a task.
      *

package/dist/index.d.mts

@@ -1,3 +1,3 @@
-export { M as MAX_INGEST_SIZE_BYTES, R as Raindrop, R as default } from './index-SHpkmIQb.mjs';
+export { M as MAX_INGEST_SIZE_BYTES, R as Raindrop, R as default } from './index-CPL3oZVf.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-SHpkmIQb.js';
+export { M as MAX_INGEST_SIZE_BYTES, R as Raindrop, R as default } from './index-CPL3oZVf.js';
 import '@dawn/schemas/ingest';
 import '@opentelemetry/api';

package/dist/index.js

@@ -56,7 +56,7 @@ var TrackEventSchema = import_zod.z.object({
   timestamp: import_zod.z.coerce.date(),
   received_at: import_zod.z.coerce.date(),
   user_id: import_zod.z.coerce.string().min(1, "User ID cannot be empty"),
-  attachments: import_zod.z.array(AttachmentSchema).optional()
+  attachments: import_zod.z.array(AttachmentSchema).optional().nullable()
 }).strict();
 var AiDataSchema = import_zod.z.object({
   model: import_zod.z.coerce.string().optional().nullable(),
@@ -107,7 +107,7 @@ var CategorizationRequestSchema = import_zod.z.object({
 // package.json
 var package_default = {
   name: "raindrop-ai",
-  version: "0.0.42",
+  version: "0.0.43",
   main: "dist/index.js",
   module: "dist/index.mjs",
   types: "dist/index.d.ts",
@@ -320,6 +320,13 @@ var NonLiveInteraction = class {
       return Promise.reject(error);
     }
   }
+  withTool(_params, fn, thisArg, ...args) {
+    try {
+      return Promise.resolve(fn.apply(thisArg, args));
+    } catch (error) {
+      return Promise.reject(error);
+    }
+  }
   startSpan(_params) {
     return NO_OP_SPAN;
   }

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import {
   tracing
-} from "./chunk-N5Y5IKFX.mjs";
+} from "./chunk-UQBASHHQ.mjs";
 
 // ../schemas/src/ingest/index.ts
 import { z } from "zod";
@@ -32,7 +32,7 @@ var TrackEventSchema = z.object({
   timestamp: z.coerce.date(),
   received_at: z.coerce.date(),
   user_id: z.coerce.string().min(1, "User ID cannot be empty"),
-  attachments: z.array(AttachmentSchema).optional()
+  attachments: z.array(AttachmentSchema).optional().nullable()
 }).strict();
 var AiDataSchema = z.object({
   model: z.coerce.string().optional().nullable(),
@@ -83,7 +83,7 @@ var CategorizationRequestSchema = z.object({
 // package.json
 var package_default = {
   name: "raindrop-ai",
-  version: "0.0.42",
+  version: "0.0.43",
   main: "dist/index.js",
   module: "dist/index.mjs",
   types: "dist/index.d.ts",

package/dist/tracing/index.d.mts

@@ -1,5 +1,5 @@
 import * as traceloop from '@traceloop/node-server-sdk';
-import { R as Raindrop, P as PartialAiTrackEvent, I as Interaction } from '../index-SHpkmIQb.mjs';
+import { R as Raindrop, P as PartialAiTrackEvent, I as Interaction } from '../index-CPL3oZVf.mjs';
 import '@dawn/schemas/ingest';
 import '@opentelemetry/api';
 

package/dist/tracing/index.d.ts

@@ -1,5 +1,5 @@
 import * as traceloop from '@traceloop/node-server-sdk';
-import { R as Raindrop, P as PartialAiTrackEvent, I as Interaction } from '../index-SHpkmIQb.js';
+import { R as Raindrop, P as PartialAiTrackEvent, I as Interaction } from '../index-CPL3oZVf.js';
 import '@dawn/schemas/ingest';
 import '@opentelemetry/api';