retrace-sdk 0.2.2 → 0.3.0

package/README.md

@@ -101,6 +101,12 @@ configure({ apiKey: "rt_live_...", sampleRate: 0.1 }); // Record 10% of traces
 
 ## Changelog
 
+### 0.3.0
+
+- **Sessions** — `sessionId` option in `TraceRecorder` and `trace()` to group multi-turn conversations
+- **Multi-Agent** — `setAgentId()` on `SpanBuilder` for cross-agent tracing
+- **Guardrail support** — SDK respects HALT commands from server-side guardrail policies
+
 ### 0.2.2
 
 - **Fixed** — OpenAI interceptor no longer creates dummy client instance to find prototype

package/dist/recorder.d.ts

@@ -3,6 +3,7 @@ export interface RecordOptions {
     name?: string;
     input?: unknown;
     metadata?: Record<string, unknown>;
+    sessionId?: string;
 }
 export declare class TraceRecorder {
     private builder;

package/dist/recorder.js

@@ -18,6 +18,8 @@ export class TraceRecorder {
             this.builder.setProjectId(cfg.projectId);
         if (opts?.metadata)
             this.builder.setMetadata(opts.metadata);
+        if (opts?.sessionId)
+            this.builder.setSessionId(opts.sessionId);
         if (opts?.name || opts?.input) {
             this.builder.start(opts.name, opts.input);
         }
@@ -95,9 +97,16 @@ export class TraceRecorder {
 export function record(opts) {
     const cfg = getConfig();
     if (!cfg.enabled || Math.random() > cfg.sampleRate) {
-        // Return a no-op proxy that doesn't require API key or connect
+        // Return a no-op that silently swallows all method calls
+        const methods = new Set(["start", "end", "startSpan", "endSpan", "addSpan"]);
         const noop = {};
-        return new Proxy(noop, { get: (_t, prop) => typeof prop === "string" ? (() => noop) : undefined });
+        return new Proxy(noop, {
+            get: (_t, prop) => {
+                if (typeof prop === "string" && methods.has(prop))
+                    return () => noop;
+                return undefined;
+            },
+        });
     }
     return new TraceRecorder(opts);
 }

package/dist/trace.d.ts

@@ -26,6 +26,7 @@ export interface SpanData {
     cost?: number;
     duration_ms?: number;
     metadata?: Record<string, unknown>;
+    agent_id?: string;
     started_at: string;
     ended_at?: string;
     error?: string;
@@ -40,6 +41,7 @@ export interface TraceData {
     total_cost: number;
     total_duration_ms: number;
     metadata?: Record<string, unknown>;
+    session_id?: string;
     started_at: string;
     ended_at?: string;
     spans?: SpanData[];
@@ -55,6 +57,7 @@ export declare class SpanBuilder {
     setParentId(id: string): this;
     setTraceId(id: string): this;
     setMetadata(m: Record<string, unknown>): this;
+    setAgentId(id: string): this;
     start(): this;
     end(output?: unknown, error?: string): SpanData;
     get id(): string;
@@ -69,6 +72,7 @@ export declare class TraceBuilder {
     addSpan(span: SpanData): void;
     get id(): string;
     setProjectId(id: string): void;
+    setSessionId(id: string): void;
     setMetadata(m: Record<string, unknown>): void;
     toDict(): TraceData;
 }

package/dist/trace.js

@@ -27,6 +27,7 @@ export class SpanBuilder {
     setParentId(id) { this.data.parent_id = id; return this; }
     setTraceId(id) { this.data.trace_id = id; return this; }
     setMetadata(m) { this.data.metadata = m; return this; }
+    setAgentId(id) { this.data.agent_id = id; return this; }
     start() {
         this._startTime = utcNow();
         this.data.started_at = this._startTime.toISOString();
@@ -88,6 +89,7 @@ export class TraceBuilder {
     }
     get id() { return this.data.id; }
     setProjectId(id) { this.data.project_id = id; }
+    setSessionId(id) { this.data.session_id = id; }
     setMetadata(m) { this.data.metadata = m; }
     toDict() { return this.data; }
 }

package/dist/transport.js

@@ -48,7 +48,7 @@ export class WSTransport {
             this.connected = false;
             this.ws = null;
             if (!this.closed) {
-                setTimeout(() => this.reconnect(), this.backoff);
+                setTimeout(() => this.reconnect(), this.backoff * (0.5 + Math.random() * 0.5));
                 this.backoff = Math.min(this.backoff * 2, 30000);
             }
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "retrace-sdk",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "The execution replay engine for AI agents. Record, replay, fork, and share agent executions.",
   "type": "module",
   "main": "dist/index.js",