retrace-sdk 0.13.1 → 0.13.3

package/README.md

@@ -15,7 +15,7 @@ Requires Node.js 20+. ESM-only package.
 ```typescript
 import { configure, trace } from "retrace-sdk";
 
-configure({ apiKey: "rt_live_..." }); // Get your key at retrace.yashbogam.me/settings
+configure({ apiKey: "rt_..." }); // Get your key at retraceai.tech/settings
 
 const myAgent = trace(async (prompt: string) => {
   const response = await openai.chat.completions.create({
@@ -44,8 +44,8 @@ No extra setup needed. Install the provider SDK alongside `retrace-sdk`.
 import { configure } from "retrace-sdk";
 
 configure({
-  apiKey: "rt_live_...",           // or RETRACE_API_KEY env var
-  baseUrl: "https://api-retrace.yashbogam.me",
+  apiKey: "rt_...",           // or RETRACE_API_KEY env var
+  baseUrl: "https://api.retraceai.tech",
   projectId: "...",                 // or RETRACE_PROJECT_ID env var
 });
 ```
@@ -74,7 +74,7 @@ Mark a function as resumable to enable full cascade replay from the dashboard:
 ```typescript
 import { configure, trace } from "retrace-sdk";
 
-configure({ apiKey: "rt_live_..." });
+configure({ apiKey: "rt_..." });
 
 const myAgent = trace(async (prompt: string) => {
   const plan = await planner(prompt);
@@ -101,7 +101,7 @@ Hard ceilings that stop a runaway agent before the next call. Local limits are e
 import { configure, RetraceEnforcementError } from "retrace-sdk";
 
 configure({
-  apiKey: "rt_live_...",
+  apiKey: "rt_...",
   maxStepsPerRun: 50,
   maxUsdPerRun: 2.0,
   serverEnforcement: true, // optional: also consult server policies
@@ -141,7 +141,7 @@ writeGoldenCassette("golden.json", { recorder });
 ## Sampling
 
 ```typescript
-configure({ apiKey: "rt_live_...", sampleRate: 0.1 }); // Record 10% of traces
+configure({ apiKey: "rt_...", sampleRate: 0.1 }); // Record 10% of traces
 ```
 
 ## Changelog
@@ -183,6 +183,6 @@ configure({ apiKey: "rt_live_...", sampleRate: 0.1 }); // Record 10% of traces
 
 ## Links
 
-- [Documentation](https://retrace.yashbogam.me/docs)
+- [Documentation](https://retraceai.tech/docs)
 - [GitHub](https://github.com/yash1511-bogam/retrace)
 - [npm](https://www.npmjs.com/package/retrace-sdk)

package/dist/config.js

@@ -1,6 +1,6 @@
 const config = {
     apiKey: process.env.RETRACE_API_KEY || "",
-    baseUrl: process.env.RETRACE_BASE_URL || "https://api-retrace.yashbogam.me",
+    baseUrl: process.env.RETRACE_BASE_URL || "https://api.retraceai.tech",
     wsUrl: "",
     projectId: process.env.RETRACE_PROJECT_ID || undefined,
     enabled: !["false", "0"].includes((process.env.RETRACE_ENABLED || "true").toLowerCase()),
@@ -16,8 +16,8 @@ const config = {
 };
 config.wsUrl = config.baseUrl.replace("https://", "wss://").replace("http://", "ws://");
 export function configure(opts) {
-    if (opts.apiKey && !opts.apiKey.startsWith("rt_live_")) {
-        throw new Error("Invalid Retrace API key. Keys must start with 'rt_live_'. Get yours at https://retrace.yashbogam.me/settings");
+    if (opts.apiKey && (!opts.apiKey.startsWith("rt_") || opts.apiKey.startsWith("rt_live_") || opts.apiKey.startsWith("rt_test_"))) {
+        throw new Error("Invalid Retrace API key. Keys must start with 'rt_'. Get yours at https://retraceai.tech/settings");
     }
     Object.assign(config, opts);
     if (opts.baseUrl && !opts.wsUrl) {
@@ -30,11 +30,12 @@ export function configure(opts) {
     if (config.enabled) {
         void import("./interceptors/install.js").then((m) => m.ensureInterceptorsInstalled()).catch(() => { });
     }
+    void import("./telemetry.js").then((m) => m.track("configure")).catch(() => { });
     return config;
 }
 export function requireApiKey() {
     if (!config.apiKey) {
-        throw new Error("Retrace API key required. Call configure({ apiKey: 'rt_live_...' }) or set RETRACE_API_KEY. Get yours at https://retrace.yashbogam.me/settings");
+        throw new Error("Retrace API key required. Call configure({ apiKey: 'rt_...' }) or set RETRACE_API_KEY. Get yours at https://retraceai.tech/settings");
     }
     return config.apiKey;
 }

package/dist/errors.js

@@ -5,7 +5,7 @@ export class RetraceAuthError extends RetraceError {
     constructor(message = "Invalid or missing API key") { super(message); this.name = "RetraceAuthError"; }
 }
 export class RetraceCreditsExhaustedError extends RetraceError {
-    constructor(message = "Monthly trace limit reached. Upgrade at retrace.yashbogam.me/pricing") { super(message); this.name = "RetraceCreditsExhaustedError"; }
+    constructor(message = "Monthly trace limit reached. Upgrade at retraceai.tech/pricing") { super(message); this.name = "RetraceCreditsExhaustedError"; }
 }
 export class RetraceConnectionError extends RetraceError {
     constructor(message = "Failed to connect to Retrace API") { super(message); this.name = "RetraceConnectionError"; }

package/dist/telemetry.d.ts

@@ -0,0 +1 @@
+export declare function track(event: string, fields?: Record<string, string | number | boolean>): void;

package/dist/telemetry.js

@@ -0,0 +1,51 @@
+/**
+ * Anonymous, opt-out diagnostic telemetry.
+ *
+ * Sends NO user code, API keys, prompts, responses, or personal information — only the SDK version,
+ * the runtime/OS family, an anonymous per-process id, and event/error *categories* — to the Retrace
+ * API's internal log ingest (forwarded to the centralized logging platform under
+ * service="sdk-typescript"). Fire-and-forget; never blocks, never throws.
+ *
+ * Disable entirely with RETRACE_TELEMETRY=0 (also accepts false/no/off).
+ */
+import os from "node:os";
+import { getConfig } from "./config.js";
+// Per-process random id — anonymous, not linked to any account, user, or machine identity.
+const ANON_ID = Math.random().toString(16).slice(2, 18);
+const DISABLED = new Set(["0", "false", "no", "off"]);
+// Keep in sync with package.json version.
+const SDK_VERSION = "0.13.3";
+function enabled() {
+    return !DISABLED.has((process.env.RETRACE_TELEMETRY ?? "1").trim().toLowerCase());
+}
+export function track(event, fields = {}) {
+    if (!enabled())
+        return;
+    try {
+        const base = (getConfig().baseUrl || "https://api.retraceai.tech").replace(/\/$/, "");
+        const body = JSON.stringify({
+            service: "sdk-typescript",
+            events: [
+                {
+                    level: "info",
+                    message: `sdk-typescript ${event}`,
+                    event,
+                    sdk_version: SDK_VERSION,
+                    node: process.version,
+                    os: os.platform(),
+                    anon_id: ANON_ID,
+                    ...fields,
+                },
+            ],
+        });
+        // Fire-and-forget; never block or throw.
+        void fetch(`${base}/api/v1/internal/logs`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body,
+        }).catch(() => { });
+    }
+    catch {
+        /* telemetry must never affect the user's program */
+    }
+}

package/dist/transport.js

@@ -3,7 +3,7 @@ import { getConfig } from "./config.js";
 import { classifyServerSignal } from "./errors.js";
 // Client identifier sent on every request so the backend can attribute SDK usage/version.
 // Keep in sync with package.json on release.
-const CLIENT_ID = "typescript-sdk/0.13.1";
+const CLIENT_ID = "typescript-sdk/0.13.2";
 export class WSTransport {
     ws = null;
     connected = false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "retrace-sdk",
-  "version": "0.13.1",
+  "version": "0.13.3",
   "description": "The execution replay engine for AI agents. Record, replay, fork, and share agent executions.",
   "type": "module",
   "main": "dist/index.js",
@@ -31,7 +31,7 @@
     "url": "https://github.com/yash1511-bogam/retrace-sdk",
     "directory": "packages/sdk-typescript"
   },
-  "homepage": "https://retrace.yashbogam.me/docs/sdk-typescript",
+  "homepage": "https://retraceai.tech/docs/sdk-typescript",
   "keywords": [
     "ai",
     "agent",