retrace-sdk 0.1.7 → 0.2.0

package/README.md

@@ -45,7 +45,7 @@ import { configure } from "retrace-sdk";
 
 configure({
   apiKey: "rt_live_...",           // or RETRACE_API_KEY env var
-  baseUrl: "https://api.retrace.yashbogam.me",
+  baseUrl: "https://api-retrace.yashbogam.me",
   projectId: "...",                 // or RETRACE_PROJECT_ID env var
 });
 ```

package/dist/config.d.ts

@@ -4,6 +4,7 @@ export interface Config {
     wsUrl: string;
     projectId: string | undefined;
     enabled: boolean;
+    sampleRate: number;
 }
 export declare function configure(opts: Partial<Config>): Config;
 export declare function requireApiKey(): string;

package/dist/config.js

@@ -4,6 +4,7 @@ const config = {
     wsUrl: "",
     projectId: process.env.RETRACE_PROJECT_ID || undefined,
     enabled: !["false", "0"].includes((process.env.RETRACE_ENABLED || "true").toLowerCase()),
+    sampleRate: parseFloat(process.env.RETRACE_SAMPLE_RATE || "1"),
 };
 config.wsUrl = config.baseUrl.replace("https://", "wss://").replace("http://", "ws://");
 export function configure(opts) {

package/dist/recorder.js

@@ -94,16 +94,17 @@ export class TraceRecorder {
 }
 export function record(opts) {
     const cfg = getConfig();
-    if (!cfg.enabled) {
-        // Return a no-op recorder
-        return new TraceRecorder(opts);
+    if (!cfg.enabled || Math.random() > cfg.sampleRate) {
+        // Return a no-op proxy that doesn't require API key or connect
+        const noop = {};
+        return new Proxy(noop, { get: (_t, prop) => typeof prop === "string" ? (() => noop) : undefined });
     }
     return new TraceRecorder(opts);
 }
 export function trace(fn, opts) {
     const cfg = getConfig();
     return (...args) => {
-        if (!cfg.enabled)
+        if (!cfg.enabled || Math.random() > cfg.sampleRate)
             return fn(...args);
         const recorder = new TraceRecorder({
             name: opts?.name || fn.name || "anonymous",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "retrace-sdk",
-  "version": "0.1.7",
+  "version": "0.2.0",
   "description": "The execution replay engine for AI agents. Record, replay, fork, and share agent executions.",
   "type": "module",
   "main": "dist/index.js",
@@ -16,7 +16,7 @@
   "author": "Yash Bogam",
   "repository": {
     "type": "git",
-    "url": "https://github.com/yash1511-bogam/retrace",
+    "url": "https://github.com/yash1511-bogam/retrace-sdk",
     "directory": "packages/sdk-typescript"
   },
   "homepage": "https://retrace.yashbogam.me/docs/sdk-typescript",