retrace-sdk 0.13.3 → 0.14.0

package/dist/config.d.ts

@@ -32,6 +32,10 @@ export interface Config {
      *  the fail-closed timeout verdict. 0 = trip immediately. (The auto path is synchronous, so the
      *  poll runs in the background and a denial/timeout trips the NEXT span.) */
     enforcementHoldWaitSeconds: number;
+    /** Environment indicator sent with every trace as `metadata.environment`. Set to "sandbox" to
+     *  record into the auto-expiring sandbox data-namespace instead of production (the server also
+     *  accepts an `X-Retrace-Environment` header). Env: RETRACE_ENVIRONMENT. */
+    environment: string | undefined;
 }
 export declare function configure(opts: Partial<Config>): Config;
 export declare function requireApiKey(): string;

package/dist/config.js

@@ -13,6 +13,7 @@ const config = {
     maxUsdPerRun: process.env.RETRACE_MAX_USD_PER_RUN ? parseFloat(process.env.RETRACE_MAX_USD_PER_RUN) : undefined,
     serverEnforcement: ["true", "1", "yes"].includes((process.env.RETRACE_SERVER_ENFORCEMENT || "").toLowerCase()),
     enforcementHoldWaitSeconds: process.env.RETRACE_ENFORCEMENT_HOLD_WAIT_SECONDS ? parseInt(process.env.RETRACE_ENFORCEMENT_HOLD_WAIT_SECONDS, 10) : 0,
+    environment: process.env.RETRACE_ENVIRONMENT || undefined,
 };
 config.wsUrl = config.baseUrl.replace("https://", "wss://").replace("http://", "ws://");
 export function configure(opts) {

package/dist/telemetry.js

@@ -14,7 +14,7 @@ import { getConfig } from "./config.js";
 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";
+const SDK_VERSION = "0.14.0";
 function enabled() {
     return !DISABLED.has((process.env.RETRACE_TELEMETRY ?? "1").trim().toLowerCase());
 }

package/dist/trace.js

@@ -1,4 +1,5 @@
 import { genId, nowIso, utcNow } from "./utils.js";
+import { getConfig } from "./config.js";
 export var SpanType;
 (function (SpanType) {
     SpanType["LLM_CALL"] = "llm_call";
@@ -106,5 +107,13 @@ export class TraceBuilder {
     setProjectId(id) { this.data.project_id = id; }
     setSessionId(id) { this.data.session_id = id; }
     setMetadata(m) { this.data.metadata = m; }
-    toDict() { return this.data; }
+    toDict() {
+        // Tag the run's environment (e.g. "sandbox") from config as metadata.environment so the server
+        // routes it to the matching data-namespace. Explicit per-trace metadata.environment always wins.
+        const env = getConfig().environment;
+        if (env && !(this.data.metadata && "environment" in this.data.metadata)) {
+            this.data.metadata = { ...(this.data.metadata || {}), environment: env };
+        }
+        return this.data;
+    }
 }

package/package.json

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