@respan/tracing 1.0.45

package/dist/utils/client.d.ts

@@ -0,0 +1,168 @@
+import { SpanStatusCode, Tracer } from "@opentelemetry/api";
+/**
+ * Options for updating a span
+ */
+export interface UpdateSpanOptions {
+    /** New name for the span */
+    name?: string;
+    /** Custom attributes to add to the span */
+    attributes?: Record<string, any>;
+    /** Status to set on the span */
+    status?: {
+        code: SpanStatusCode;
+        message?: string;
+    };
+    /** Respan-specific parameters */
+    respanParams?: {
+        /** Customer identifier for grouping traces by user */
+        customerIdentifier?: string;
+        /** Trace group identifier for organizing traces */
+        traceGroupIdentifier?: string;
+        /** Additional metadata */
+        metadata?: Record<string, any>;
+    };
+}
+/**
+ * Respan client interface for span management and tracing operations.
+ *
+ * This client provides methods to:
+ * - Get current trace and span IDs
+ * - Update span attributes and Respan parameters
+ * - Add events and record exceptions
+ * - Create manual spans
+ * - Control span buffering
+ *
+ * @example
+ * ```typescript
+ * import { getClient } from '@respan/tracing';
+ *
+ * const client = getClient();
+ * const traceId = client.getCurrentTraceId();
+ *
+ * client.updateCurrentSpan({
+ *   respanParams: {
+ *     customerIdentifier: 'user-123',
+ *     traceGroupIdentifier: 'experiment-456'
+ *   }
+ * });
+ * ```
+ */
+export interface RespanClient {
+    /**
+     * Get the current trace ID
+     * @returns The current trace ID or undefined if no active span
+     */
+    getCurrentTraceId(): string | undefined;
+    /**
+     * Get the current span ID
+     * @returns The current span ID or undefined if no active span
+     */
+    getCurrentSpanId(): string | undefined;
+    /**
+     * Get the OpenTelemetry tracer for manual span creation
+     * @returns The tracer instance
+     */
+    getTracer(): Tracer;
+    /**
+     * Update the current span with new attributes, name, status, or Respan parameters
+     * @param options - Options for updating the span
+     *
+     * @example
+     * ```typescript
+     * client.updateCurrentSpan({
+     *   name: 'updated_name',
+     *   attributes: { 'custom.field': 'value' },
+     *   respanParams: {
+     *     customerIdentifier: 'user-123',
+     *     traceGroupIdentifier: 'experiment-456',
+     *     metadata: { version: '1.0' }
+     *   }
+     * });
+     * ```
+     */
+    updateCurrentSpan(options: UpdateSpanOptions): void;
+    /**
+     * Add an event to the current span
+     * @param name - Event name
+     * @param attributes - Optional event attributes
+     *
+     * @example
+     * ```typescript
+     * client.addEvent('validation_started', { record_count: 100 });
+     * ```
+     */
+    addEvent(name: string, attributes?: Record<string, any>): void;
+    /**
+     * Record an exception on the current span
+     * @param exception - The exception to record
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   // ... some code
+     * } catch (error) {
+     *   client.recordException(error as Error);
+     *   throw error;
+     * }
+     * ```
+     */
+    recordException(exception: Error): void;
+    /**
+     * Check if the current span is recording
+     * @returns True if the span is recording, false otherwise
+     */
+    isRecording(): boolean;
+    /**
+     * Force flush all pending spans
+     * @returns Promise that resolves when flush is complete
+     */
+    flush(): Promise<void>;
+}
+/**
+ * Get the Respan client instance for span management.
+ *
+ * This function returns a singleton client that provides methods to:
+ * - Get current trace and span IDs
+ * - Update spans with custom attributes and Respan parameters
+ * - Add events and record exceptions
+ * - Access the tracer for manual span creation
+ *
+ * @returns The Respan client instance
+ *
+ * @example
+ * ```typescript
+ * import { getClient } from '@respan/tracing';
+ *
+ * const client = getClient();
+ *
+ * // Get current trace information
+ * const traceId = client.getCurrentTraceId();
+ * const spanId = client.getCurrentSpanId();
+ *
+ * // Update span with Respan parameters
+ * client.updateCurrentSpan({
+ *   respanParams: {
+ *     customerIdentifier: 'user-123',
+ *     traceGroupIdentifier: 'data-processing-pipeline',
+ *     metadata: {
+ *       version: '1.0',
+ *       environment: 'production'
+ *     }
+ *   }
+ * });
+ *
+ * // Add event to track progress
+ * client.addEvent('validation_started', {
+ *   record_count: 100
+ * });
+ *
+ * // Record exception
+ * try {
+ *   // ... some code
+ * } catch (error) {
+ *   client.recordException(error as Error);
+ *   throw error;
+ * }
+ * ```
+ */
+export declare function getClient(): RespanClient;

package/dist/utils/client.js

@@ -0,0 +1,151 @@
+import { trace, SpanStatusCode } from "@opentelemetry/api";
+/**
+ * Implementation of the Respan client
+ */
+class RespanClientImpl {
+    tracerName = "@respan/tracing";
+    getCurrentTraceId() {
+        const currentSpan = trace.getActiveSpan();
+        if (!currentSpan) {
+            return undefined;
+        }
+        const spanContext = currentSpan.spanContext();
+        return spanContext.traceId;
+    }
+    getCurrentSpanId() {
+        const currentSpan = trace.getActiveSpan();
+        if (!currentSpan) {
+            return undefined;
+        }
+        const spanContext = currentSpan.spanContext();
+        return spanContext.spanId;
+    }
+    getTracer() {
+        return trace.getTracer(this.tracerName);
+    }
+    updateCurrentSpan(options) {
+        const currentSpan = trace.getActiveSpan();
+        if (!currentSpan) {
+            console.warn("[Respan] No active span to update");
+            return;
+        }
+        // Update span name
+        if (options.name) {
+            currentSpan.updateName(options.name);
+        }
+        // Update attributes
+        if (options.attributes) {
+            for (const [key, value] of Object.entries(options.attributes)) {
+                currentSpan.setAttribute(key, value);
+            }
+        }
+        // Update status
+        if (options.status) {
+            currentSpan.setStatus(options.status);
+        }
+        // Update Respan-specific parameters
+        if (options.respanParams) {
+            const { customerIdentifier, traceGroupIdentifier, metadata } = options.respanParams;
+            if (customerIdentifier) {
+                currentSpan.setAttribute("respan.customer_identifier", customerIdentifier);
+            }
+            if (traceGroupIdentifier) {
+                currentSpan.setAttribute("respan.trace_group_identifier", traceGroupIdentifier);
+            }
+            if (metadata) {
+                // Flatten metadata into attributes with respan.metadata prefix
+                for (const [key, value] of Object.entries(metadata)) {
+                    currentSpan.setAttribute(`respan.metadata.${key}`, value);
+                }
+            }
+        }
+    }
+    addEvent(name, attributes) {
+        const currentSpan = trace.getActiveSpan();
+        if (!currentSpan) {
+            console.warn("[Respan] No active span to add event to");
+            return;
+        }
+        currentSpan.addEvent(name, attributes);
+    }
+    recordException(exception) {
+        const currentSpan = trace.getActiveSpan();
+        if (!currentSpan) {
+            console.warn("[Respan] No active span to record exception on");
+            return;
+        }
+        currentSpan.recordException(exception);
+        currentSpan.setStatus({
+            code: SpanStatusCode.ERROR,
+            message: exception.message,
+        });
+    }
+    isRecording() {
+        const currentSpan = trace.getActiveSpan();
+        if (!currentSpan) {
+            return false;
+        }
+        return currentSpan.isRecording();
+    }
+    async flush() {
+        // Import forceFlush from tracing utils
+        const { forceFlush } = await import("./tracing.js");
+        await forceFlush();
+    }
+}
+// Singleton instance
+let _clientInstance;
+/**
+ * Get the Respan client instance for span management.
+ *
+ * This function returns a singleton client that provides methods to:
+ * - Get current trace and span IDs
+ * - Update spans with custom attributes and Respan parameters
+ * - Add events and record exceptions
+ * - Access the tracer for manual span creation
+ *
+ * @returns The Respan client instance
+ *
+ * @example
+ * ```typescript
+ * import { getClient } from '@respan/tracing';
+ *
+ * const client = getClient();
+ *
+ * // Get current trace information
+ * const traceId = client.getCurrentTraceId();
+ * const spanId = client.getCurrentSpanId();
+ *
+ * // Update span with Respan parameters
+ * client.updateCurrentSpan({
+ *   respanParams: {
+ *     customerIdentifier: 'user-123',
+ *     traceGroupIdentifier: 'data-processing-pipeline',
+ *     metadata: {
+ *       version: '1.0',
+ *       environment: 'production'
+ *     }
+ *   }
+ * });
+ *
+ * // Add event to track progress
+ * client.addEvent('validation_started', {
+ *   record_count: 100
+ * });
+ *
+ * // Record exception
+ * try {
+ *   // ... some code
+ * } catch (error) {
+ *   client.recordException(error as Error);
+ *   throw error;
+ * }
+ * ```
+ */
+export function getClient() {
+    if (!_clientInstance) {
+        _clientInstance = new RespanClientImpl();
+    }
+    return _clientInstance;
+}
+//# sourceMappingURL=client.js.map

package/dist/utils/client.js.map

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

package/dist/utils/context.d.ts

@@ -0,0 +1,28 @@
+import { Context } from "@opentelemetry/api";
+/**
+ * Context Keys: Type-safe identifiers for storing values in OpenTelemetry context
+ *
+ * Why context keys are needed:
+ * 1. Type safety - prevents runtime errors from typos in key names
+ * 2. Namespace isolation - prevents key collisions between different libraries
+ * 3. Hierarchical data flow - allows parent spans to pass data to child spans
+ * 4. Cross-cutting concerns - enables data to flow across async boundaries
+ */
+export declare const WORKFLOW_NAME_KEY: symbol;
+export declare const ENTITY_NAME_KEY: symbol;
+export declare const ASSOCIATION_PROPERTIES_KEY: symbol;
+/**
+ * Retrieves the current entity path from the active context.
+ * This builds the hierarchical path like "workflow.task.subtask".
+ *
+ * @param ctx - The context to read from (defaults to current active context)
+ * @returns The entity path string or undefined if not set
+ */
+export declare const getEntityPath: (ctx?: Context) => string | undefined;
+/**
+ * Determines whether trace content (input/output data) should be captured.
+ * This can be controlled via environment variable for security/privacy.
+ *
+ * @returns true if traces should include content, false otherwise
+ */
+export declare const shouldSendTraces: () => boolean;

package/dist/utils/context.js

@@ -0,0 +1,44 @@
+import { context, createContextKey } from "@opentelemetry/api";
+import { SpanAttributes } from "@traceloop/ai-semantic-conventions";
+/**
+ * Context Keys: Type-safe identifiers for storing values in OpenTelemetry context
+ *
+ * Why context keys are needed:
+ * 1. Type safety - prevents runtime errors from typos in key names
+ * 2. Namespace isolation - prevents key collisions between different libraries
+ * 3. Hierarchical data flow - allows parent spans to pass data to child spans
+ * 4. Cross-cutting concerns - enables data to flow across async boundaries
+ */
+// Stores the name of the current workflow (top-level operation)
+export const WORKFLOW_NAME_KEY = createContextKey(SpanAttributes.TRACELOOP_WORKFLOW_NAME);
+// Stores the hierarchical path of the current entity (e.g., "workflow.task.subtask")
+export const ENTITY_NAME_KEY = createContextKey(SpanAttributes.TRACELOOP_ENTITY_NAME);
+// Stores custom properties for associating related spans
+export const ASSOCIATION_PROPERTIES_KEY = createContextKey(SpanAttributes.TRACELOOP_ASSOCIATION_PROPERTIES);
+/**
+ * Retrieves the current entity path from the active context.
+ * This builds the hierarchical path like "workflow.task.subtask".
+ *
+ * @param ctx - The context to read from (defaults to current active context)
+ * @returns The entity path string or undefined if not set
+ */
+export const getEntityPath = (ctx = context.active()) => {
+    // First check for full entity name (set by TOOL/TASK spans)
+    const entityName = ctx.getValue(ENTITY_NAME_KEY);
+    if (entityName) {
+        return entityName;
+    }
+    // Fall back to workflow name (set by WORKFLOW/AGENT spans)
+    const workflowName = ctx.getValue(WORKFLOW_NAME_KEY);
+    return workflowName;
+};
+/**
+ * Determines whether trace content (input/output data) should be captured.
+ * This can be controlled via environment variable for security/privacy.
+ *
+ * @returns true if traces should include content, false otherwise
+ */
+export const shouldSendTraces = () => {
+    return process.env.RESPAN_TRACE_CONTENT !== "false";
+};
+//# sourceMappingURL=context.js.map

package/dist/utils/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/utils/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAW,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE;;;;;;;;GAQG;AAEH,gEAAgE;AAChE,MAAM,CAAC,MAAM,iBAAiB,GAAG,gBAAgB,CAC/C,cAAc,CAAC,uBAAuB,CACvC,CAAC;AAEF,qFAAqF;AACrF,MAAM,CAAC,MAAM,eAAe,GAAG,gBAAgB,CAC7C,cAAc,CAAC,qBAAqB,CACrC,CAAC;AAEF,yDAAyD;AACzD,MAAM,CAAC,MAAM,0BAA0B,GAAG,gBAAgB,CACxD,cAAc,CAAC,gCAAgC,CAChD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,EAAsB,EAAE;IAC1E,4DAA4D;IAC5D,MAAM,UAAU,GAAG,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAuB,CAAC;IACvE,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,2DAA2D;IAC3D,MAAM,YAAY,GAAG,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAuB,CAAC;IAC3E,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAY,EAAE;IAC5C,OAAO,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,OAAO,CAAC;AACtD,CAAC,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./context.js";
+export * from "./span.js";
+export { startTracing, forceFlush, _resolveBaseURL } from "./tracing.js";
+export * from "./client.js";
+export * from "./spanBuffer.js";

package/dist/utils/index.js

@@ -0,0 +1,8 @@
+export * from "./context.js";
+export * from "./span.js";
+// Export tracing utils but avoid naming conflicts
+export { startTracing, forceFlush, _resolveBaseURL } from "./tracing.js";
+// Export client and span buffer
+export * from "./client.js";
+export * from "./spanBuffer.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAE1B,kDAAkD;AAClD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEzE,gCAAgC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}

package/dist/utils/span.d.ts

@@ -0,0 +1,65 @@
+import { Tracer, Span, SpanStatusCode } from "@opentelemetry/api";
+/**
+ * Gets the singleton tracer instance.
+ * The tracer is responsible for creating and managing spans.
+ *
+ * @returns The global tracer instance
+ */
+export declare const getTracer: () => Tracer;
+/**
+ * Gets the currently active span from the context.
+ * This is the span that's currently being executed.
+ *
+ * @returns The active span or undefined if no span is active
+ */
+export declare const getCurrentSpan: () => Span | undefined;
+/**
+ * Update the current active span with new information.
+ * This is the JavaScript equivalent of the Python update_current_span method.
+ *
+ * @param options - Configuration object for updating the span
+ * @returns True if the span was updated successfully, False otherwise
+ */
+export declare const updateCurrentSpan: (options?: {
+    respanParams?: Record<string, any>;
+    attributes?: Record<string, string | number | boolean>;
+    status?: SpanStatusCode;
+    statusDescription?: string;
+    name?: string;
+}) => boolean;
+/**
+ * Adds an event to the currently active span.
+ * Events are timestamped messages that provide additional context.
+ *
+ * @param name - Name of the event
+ * @param attributes - Optional attributes for the event
+ * @returns true if event was added, false if no active span
+ */
+export declare const addSpanEvent: (name: string, attributes?: Record<string, string | number | boolean>) => boolean;
+/**
+ * Records an exception in the currently active span.
+ * This is useful for capturing errors that don't necessarily end the span.
+ *
+ * @param exception - The error/exception to record
+ * @returns true if exception was recorded, false if no active span
+ */
+export declare const recordSpanException: (exception: Error) => boolean;
+/**
+ * Sets the status of the currently active span.
+ * This indicates whether the operation succeeded or failed.
+ *
+ * @param status - The status to set (OK or ERROR)
+ * @param message - Optional message describing the status
+ * @returns true if status was set, false if no active span
+ */
+export declare const setSpanStatus: (status: "OK" | "ERROR", message?: string) => boolean;
+/**
+ * Creates a manual span for custom tracing.
+ * This is useful when you need to trace operations that aren't wrapped by withEntity.
+ *
+ * @param name - Name of the span
+ * @param fn - Function to execute within the span
+ * @param attributes - Optional attributes for the span
+ * @returns The result of the function
+ */
+export declare const withManualSpan: <T>(name: string, fn: (span: import("@opentelemetry/api").Span) => T, attributes?: Record<string, string | number | boolean>) => T;