@smazzinni/sdk 0.4.1

package/dist/cjs/index.js

@@ -0,0 +1,50 @@
+"use strict";
+// ReplayAI TypeScript SDK — public entry point.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.redactOptional = exports.redactText = exports.estimateStepCost = exports.estimateCost = exports.getLastFlushResult = exports.flushSession = exports.ReplaySession = exports.currentSession = exports.resetConfig = exports.getConfig = exports.configure = exports.recordStepSync = exports.recordStep = exports.withTrace = exports.trace = exports.VERSION = void 0;
+const config_js_1 = require("./config.js");
+Object.defineProperty(exports, "configure", { enumerable: true, get: function () { return config_js_1.configure; } });
+Object.defineProperty(exports, "getConfig", { enumerable: true, get: function () { return config_js_1.getConfig; } });
+Object.defineProperty(exports, "resetConfig", { enumerable: true, get: function () { return config_js_1.resetConfig; } });
+const context_js_1 = require("./context.js");
+Object.defineProperty(exports, "currentSession", { enumerable: true, get: function () { return context_js_1.currentSession; } });
+Object.defineProperty(exports, "trace", { enumerable: true, get: function () { return context_js_1.trace; } });
+Object.defineProperty(exports, "withTrace", { enumerable: true, get: function () { return context_js_1.withTrace; } });
+const steps_js_1 = require("./steps.js");
+Object.defineProperty(exports, "recordStep", { enumerable: true, get: function () { return steps_js_1.recordStep; } });
+Object.defineProperty(exports, "recordStepSync", { enumerable: true, get: function () { return steps_js_1.recordStepSync; } });
+const session_js_1 = require("./session.js");
+Object.defineProperty(exports, "ReplaySession", { enumerable: true, get: function () { return session_js_1.ReplaySession; } });
+const store_js_1 = require("./store.js");
+Object.defineProperty(exports, "flushSession", { enumerable: true, get: function () { return store_js_1.flushSession; } });
+Object.defineProperty(exports, "getLastFlushResult", { enumerable: true, get: function () { return store_js_1.getLastFlushResult; } });
+const cost_js_1 = require("./cost.js");
+Object.defineProperty(exports, "estimateCost", { enumerable: true, get: function () { return cost_js_1.estimateCost; } });
+Object.defineProperty(exports, "estimateStepCost", { enumerable: true, get: function () { return cost_js_1.estimateStepCost; } });
+const redact_js_1 = require("./redact.js");
+Object.defineProperty(exports, "redactText", { enumerable: true, get: function () { return redact_js_1.redactText; } });
+Object.defineProperty(exports, "redactOptional", { enumerable: true, get: function () { return redact_js_1.redactOptional; } });
+/** SDK version. */
+exports.VERSION = "0.4.1";
+// Default export is a namespace object — handy for CJS consumers and as a
+// single `import replayai from "@replayai/sdk"` import.
+const replayai = {
+    VERSION: exports.VERSION,
+    trace: context_js_1.trace,
+    withTrace: context_js_1.withTrace,
+    recordStep: steps_js_1.recordStep,
+    recordStepSync: steps_js_1.recordStepSync,
+    configure: config_js_1.configure,
+    getConfig: config_js_1.getConfig,
+    resetConfig: config_js_1.resetConfig,
+    currentSession: context_js_1.currentSession,
+    ReplaySession: session_js_1.ReplaySession,
+    flushSession: store_js_1.flushSession,
+    getLastFlushResult: store_js_1.getLastFlushResult,
+    estimateCost: cost_js_1.estimateCost,
+    estimateStepCost: cost_js_1.estimateStepCost,
+    redactText: redact_js_1.redactText,
+    redactOptional: redact_js_1.redactOptional,
+};
+exports.default = replayai;
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,gDAAgD;;;AAEhD,2CAAgE;AAgC9D,0FAhCO,qBAAS,OAgCP;AACT,0FAjCkB,qBAAS,OAiClB;AACT,4FAlC6B,uBAAW,OAkC7B;AAjCb,6CAAgE;AAkC9D,+FAlCO,2BAAc,OAkCP;AAPd,sFA3BuB,kBAAK,OA2BvB;AACL,0FA5B8B,sBAAS,OA4B9B;AA3BX,yCAAwD;AA4BtD,2FA5BO,qBAAU,OA4BP;AACV,+FA7BmB,yBAAc,OA6BnB;AA5BhB,6CAA6C;AAiC3C,8FAjCO,0BAAa,OAiCP;AAhCf,yCAA8D;AAiC5D,6FAjCO,uBAAY,OAiCP;AACZ,mGAlCqB,6BAAkB,OAkCrB;AAjCpB,uCAA2D;AAkCzD,6FAlCO,sBAAY,OAkCP;AACZ,iGAnCqB,0BAAgB,OAmCrB;AAlClB,2CAAyD;AAmCvD,2FAnCO,sBAAU,OAmCP;AACV,+FApCmB,0BAAc,OAoCnB;AAlBhB,mBAAmB;AACN,QAAA,OAAO,GAAG,OAAO,CAAC;AAqC/B,0EAA0E;AAC1E,wDAAwD;AACxD,MAAM,QAAQ,GAAG;IACf,OAAO,EAAP,eAAO;IACP,KAAK,EAAL,kBAAK;IACL,SAAS,EAAT,sBAAS;IACT,UAAU,EAAV,qBAAU;IACV,cAAc,EAAd,yBAAc;IACd,SAAS,EAAT,qBAAS;IACT,SAAS,EAAT,qBAAS;IACT,WAAW,EAAX,uBAAW;IACX,cAAc,EAAd,2BAAc;IACd,aAAa,EAAb,0BAAa;IACb,YAAY,EAAZ,uBAAY;IACZ,kBAAkB,EAAlB,6BAAkB;IAClB,YAAY,EAAZ,sBAAY;IACZ,gBAAgB,EAAhB,0BAAgB;IAChB,UAAU,EAAV,sBAAU;IACV,cAAc,EAAd,0BAAc;CACf,CAAC;AAEF,kBAAe,QAAQ,CAAC"}

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/cjs/redact.d.ts

@@ -0,0 +1,12 @@
+export declare const REDACTED = "[REDACTED]";
+/**
+ * Redact secrets from any value, returning a string.
+ *
+ * Non-string inputs are first stringified (JSON for objects) so nested
+ * secrets are scanned too. Each configured regex pattern is applied in
+ * order; matches are replaced with `[REDACTED]`.
+ */
+export declare function redactText(value: unknown): string;
+/** Redact an optional string. `null`/`undefined` pass through unchanged. */
+export declare function redactOptional(value: string | null | undefined): string | null;
+//# sourceMappingURL=redact.d.ts.map

package/dist/cjs/redact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../src/redact.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,QAAQ,eAAe,CAAC;AAsBrC;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAejD;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAG9E"}

package/dist/cjs/redact.js

@@ -0,0 +1,64 @@
+"use strict";
+// ReplayAI TypeScript SDK — redaction.
+// Secrets are scrubbed from step input/output before they're persisted.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REDACTED = void 0;
+exports.redactText = redactText;
+exports.redactOptional = redactOptional;
+const config_js_1 = require("./config.js");
+exports.REDACTED = "[REDACTED]";
+function stringify(value) {
+    if (value === null || value === undefined)
+        return "";
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") {
+        return String(value);
+    }
+    if (typeof value === "object") {
+        try {
+            return JSON.stringify(value);
+        }
+        catch {
+            try {
+                return String(value);
+            }
+            catch {
+                return "[unserializable]";
+            }
+        }
+    }
+    return String(value);
+}
+/**
+ * Redact secrets from any value, returning a string.
+ *
+ * Non-string inputs are first stringified (JSON for objects) so nested
+ * secrets are scanned too. Each configured regex pattern is applied in
+ * order; matches are replaced with `[REDACTED]`.
+ */
+function redactText(value) {
+    let text = stringify(value);
+    if (!text)
+        return "";
+    const cfg = (0, config_js_1.getConfig)();
+    for (const re of cfg.redactPatterns) {
+        // Each call needs a fresh lastIndex since these regexes have the `g` flag.
+        re.lastIndex = 0;
+        try {
+            text = text.replace(re, exports.REDACTED);
+        }
+        catch {
+            // Malformed user-supplied patterns shouldn't crash the agent.
+            continue;
+        }
+    }
+    return text;
+}
+/** Redact an optional string. `null`/`undefined` pass through unchanged. */
+function redactOptional(value) {
+    if (value === null || value === undefined)
+        return null;
+    return redactText(value);
+}
+//# sourceMappingURL=redact.js.map

package/dist/cjs/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../../src/redact.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,wEAAwE;;;AAiCxE,gCAeC;AAGD,wCAGC;AApDD,2CAAwC;AAE3B,QAAA,QAAQ,GAAG,YAAY,CAAC;AAErC,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACzF,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC;gBACH,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,kBAAkB,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,UAAU,CAAC,KAAc;IACvC,IAAI,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,GAAG,GAAG,IAAA,qBAAS,GAAE,CAAC;IACxB,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,cAAc,EAAE,CAAC;QACpC,2EAA2E;QAC3E,EAAE,CAAC,SAAS,GAAG,CAAC,CAAC;QACjB,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,gBAAQ,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,8DAA8D;YAC9D,SAAS;QACX,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,4EAA4E;AAC5E,SAAgB,cAAc,CAAC,KAAgC;IAC7D,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACvD,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC"}

package/dist/cjs/session.d.ts

@@ -0,0 +1,32 @@
+import type { ExportLang, ReplaySessionOptions, RunOptions, Trace } from "./types.js";
+/**
+ * ReplaySession — load a previously-recorded session from the API and either
+ * re-run it (returning a `Trace`) or export it as a pytest/jest test.
+ *
+ * ```ts
+ * const replay = new ReplaySession("ses_8fa1", { liveLlm: false });
+ * replay.mock("issue_refund", JSON.stringify({ refund_id: "ref_3391" }));
+ * const trace = await replay.run({ agent: "support-agent-v3", framework: "LangChain" });
+ * console.log(trace.stepCount, trace.status);
+ * const code = await replay.export("pytest");
+ * ```
+ */
+export declare class ReplaySession {
+    readonly sessionId: string;
+    readonly liveLlm: boolean;
+    /** fnName → canned response (JSON string). */
+    readonly mocks: Record<string, string>;
+    constructor(sessionId: string, opts?: ReplaySessionOptions);
+    /** Register a canned response for a mocked function call. */
+    mock(fnName: string, response: string | object): void;
+    /**
+     * Fetch the session and return a `Trace` view of it.
+     *
+     * The `agent`/`framework` opts are accepted for API parity with the Python
+     * SDK; the session's stored agent/framework take precedence.
+     */
+    run(opts: RunOptions): Promise<Trace>;
+    /** Fetch the session exported as a pytest or jest test source string. */
+    export(lang?: ExportLang): Promise<string>;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/cjs/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,UAAU,EACV,oBAAoB,EACpB,UAAU,EAGV,KAAK,EACN,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;GAWG;AACH,qBAAa,aAAa;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;gBAEhC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,oBAAoB;IAK1D,6DAA6D;IAC7D,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIrD;;;;;OAKG;IACG,GAAG,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC;IAwB3C,yEAAyE;IACnE,MAAM,CAAC,IAAI,GAAE,UAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;CAG3D"}

package/dist/cjs/session.js

@@ -0,0 +1,65 @@
+"use strict";
+// ReplayAI TypeScript SDK — ReplaySession: replay a recorded session and
+// export it as a test. Wraps GET /api/sessions/:id and /export.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReplaySession = void 0;
+const store_js_1 = require("./store.js");
+/**
+ * ReplaySession — load a previously-recorded session from the API and either
+ * re-run it (returning a `Trace`) or export it as a pytest/jest test.
+ *
+ * ```ts
+ * const replay = new ReplaySession("ses_8fa1", { liveLlm: false });
+ * replay.mock("issue_refund", JSON.stringify({ refund_id: "ref_3391" }));
+ * const trace = await replay.run({ agent: "support-agent-v3", framework: "LangChain" });
+ * console.log(trace.stepCount, trace.status);
+ * const code = await replay.export("pytest");
+ * ```
+ */
+class ReplaySession {
+    sessionId;
+    liveLlm;
+    /** fnName → canned response (JSON string). */
+    mocks = {};
+    constructor(sessionId, opts) {
+        this.sessionId = sessionId;
+        this.liveLlm = opts?.liveLlm ?? false;
+    }
+    /** Register a canned response for a mocked function call. */
+    mock(fnName, response) {
+        this.mocks[fnName] = typeof response === "string" ? response : JSON.stringify(response);
+    }
+    /**
+     * Fetch the session and return a `Trace` view of it.
+     *
+     * The `agent`/`framework` opts are accepted for API parity with the Python
+     * SDK; the session's stored agent/framework take precedence.
+     */
+    async run(opts) {
+        const result = await (0, store_js_1.fetchSession)(this.sessionId);
+        if (!result.ok) {
+            throw new Error(`ReplaySession.run: GET /api/sessions/${this.sessionId} → ${result.status} ${result.body}`);
+        }
+        const payload = result.session;
+        const session = payload.session;
+        if (!session) {
+            throw new Error(`ReplaySession.run: API response missing \`session\` field`);
+        }
+        const steps = session.steps ?? [];
+        return {
+            stepCount: steps.length ?? session.stepCount ?? 0,
+            status: session.status,
+            steps,
+            durationMs: session.durationMs,
+            tokenTotal: session.tokenTotal,
+            costUsd: session.costUsd,
+            sessionId: session.id,
+        };
+    }
+    /** Fetch the session exported as a pytest or jest test source string. */
+    async export(lang = "pytest") {
+        return (0, store_js_1.fetchExport)(this.sessionId, lang);
+    }
+}
+exports.ReplaySession = ReplaySession;
+//# sourceMappingURL=session.js.map

package/dist/cjs/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":";AAAA,yEAAyE;AACzE,gEAAgE;;;AAEhE,yCAAuD;AAWvD;;;;;;;;;;;GAWG;AACH,MAAa,aAAa;IACf,SAAS,CAAS;IAClB,OAAO,CAAU;IAC1B,8CAA8C;IACrC,KAAK,GAA2B,EAAE,CAAC;IAE5C,YAAY,SAAiB,EAAE,IAA2B;QACxD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,KAAK,CAAC;IACxC,CAAC;IAED,6DAA6D;IAC7D,IAAI,CAAC,MAAc,EAAE,QAAyB;QAC5C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC1F,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,IAAgB;QACxB,MAAM,MAAM,GAAG,MAAM,IAAA,uBAAY,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,wCAAwC,IAAI,CAAC,SAAS,MAAM,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAC3F,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAqC,CAAC;QAC7D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;QAC/E,CAAC;QACD,MAAM,KAAK,GAAkB,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QACjD,OAAO;YACL,SAAS,EAAE,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC,SAAS,IAAI,CAAC;YACjD,MAAM,EAAE,OAAO,CAAC,MAAuB;YACvC,KAAK;YACL,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,SAAS,EAAE,OAAO,CAAC,EAAE;SACtB,CAAC;IACJ,CAAC;IAED,yEAAyE;IACzE,KAAK,CAAC,MAAM,CAAC,OAAmB,QAAQ;QACtC,OAAO,IAAA,sBAAW,EAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;CACF;AAlDD,sCAkDC"}

package/dist/cjs/steps.d.ts

@@ -0,0 +1,12 @@
+import type { RecordStepInput } from "./types.js";
+/**
+ * Record a step into the current trace session.
+ *
+ * No-op when called outside a `withTrace()`/`trace()` context (unless strict
+ * mode is on, in which case it warns). Inputs and outputs are redacted with
+ * the configured patterns before persistence.
+ */
+export declare function recordStep(input: RecordStepInput): Promise<void>;
+/** Sync variant — same as `recordStep()` but without the await ceremony. */
+export declare function recordStepSync(input: RecordStepInput): void;
+//# sourceMappingURL=steps.d.ts.map

package/dist/cjs/steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../../src/steps.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAqC,MAAM,YAAY,CAAC;AAerF;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAetE;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAe3D"}

package/dist/cjs/steps.js

@@ -0,0 +1,60 @@
+"use strict";
+// ReplayAI TypeScript SDK — manual step recording.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recordStep = recordStep;
+exports.recordStepSync = recordStepSync;
+const context_js_1 = require("./context.js");
+const redact_js_1 = require("./redact.js");
+const VALID_TYPES = ["llm_call", "tool_call", "retrieval", "decision", "error"];
+const VALID_STATUSES = ["success", "failed", "running", "warning"];
+function coerceType(v) {
+    if (v && VALID_TYPES.includes(v))
+        return v;
+    return "llm_call";
+}
+function coerceStatus(v) {
+    if (v && VALID_STATUSES.includes(v))
+        return v;
+    return "success";
+}
+/**
+ * Record a step into the current trace session.
+ *
+ * No-op when called outside a `withTrace()`/`trace()` context (unless strict
+ * mode is on, in which case it warns). Inputs and outputs are redacted with
+ * the configured patterns before persistence.
+ */
+async function recordStep(input) {
+    const step = {
+        type: coerceType(input.type),
+        name: input.name,
+        model: input.model ?? null,
+        tokensIn: input.tokensIn ?? 0,
+        tokensOut: input.tokensOut ?? 0,
+        input: (0, redact_js_1.redactText)(input.input),
+        output: (0, redact_js_1.redactText)(input.output),
+        status: coerceStatus(input.status),
+        t: input.t ?? input.offsetMs,
+        offsetMs: input.offsetMs ?? input.t,
+        durationMs: input.durationMs ?? 0,
+    };
+    (0, context_js_1.appendStep)(step);
+}
+/** Sync variant — same as `recordStep()` but without the await ceremony. */
+function recordStepSync(input) {
+    const step = {
+        type: coerceType(input.type),
+        name: input.name,
+        model: input.model ?? null,
+        tokensIn: input.tokensIn ?? 0,
+        tokensOut: input.tokensOut ?? 0,
+        input: (0, redact_js_1.redactText)(input.input),
+        output: (0, redact_js_1.redactText)(input.output),
+        status: coerceStatus(input.status),
+        t: input.t ?? input.offsetMs,
+        offsetMs: input.offsetMs ?? input.t,
+        durationMs: input.durationMs ?? 0,
+    };
+    (0, context_js_1.appendStep)(step);
+}
+//# sourceMappingURL=steps.js.map

package/dist/cjs/steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.js","sourceRoot":"","sources":["../../src/steps.ts"],"names":[],"mappings":";AAAA,mDAAmD;;AA0BnD,gCAeC;AAGD,wCAeC;AAzDD,6CAA0C;AAC1C,2CAAyC;AAGzC,MAAM,WAAW,GAAe,CAAC,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;AAC5F,MAAM,cAAc,GAAiB,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AAEjF,SAAS,UAAU,CAAC,CAAqB;IACvC,IAAI,CAAC,IAAK,WAAwB,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,CAAa,CAAC;IACrE,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,YAAY,CAAC,CAAqB;IACzC,IAAI,CAAC,IAAK,cAA2B,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,CAAe,CAAC;IAC1E,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,UAAU,CAAC,KAAsB;IACrD,MAAM,IAAI,GAAgB;QACxB,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;QAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI;QAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC;QAC7B,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,CAAC;QAC/B,KAAK,EAAE,IAAA,sBAAU,EAAC,KAAK,CAAC,KAAK,CAAC;QAC9B,MAAM,EAAE,IAAA,sBAAU,EAAC,KAAK,CAAC,MAAM,CAAC;QAChC,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC;QAClC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,QAAQ;QAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,CAAC;QACnC,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,CAAC;KAClC,CAAC;IACF,IAAA,uBAAU,EAAC,IAAI,CAAC,CAAC;AACnB,CAAC;AAED,4EAA4E;AAC5E,SAAgB,cAAc,CAAC,KAAsB;IACnD,MAAM,IAAI,GAAgB;QACxB,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;QAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI;QAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC;QAC7B,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,CAAC;QAC/B,KAAK,EAAE,IAAA,sBAAU,EAAC,KAAK,CAAC,KAAK,CAAC;QAC9B,MAAM,EAAE,IAAA,sBAAU,EAAC,KAAK,CAAC,MAAM,CAAC;QAChC,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC;QAClC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,QAAQ;QAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,CAAC;QACnC,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,CAAC;KAClC,CAAC;IACF,IAAA,uBAAU,EAAC,IAAI,CAAC,CAAC;AACnB,CAAC"}

package/dist/cjs/store.d.ts

@@ -0,0 +1,38 @@
+import type { SessionStatus, SessionStep } from "./types.js";
+export interface FlushPayload {
+    /** Local correlation id (UUIDv4); the API assigns the canonical id. */
+    sessionId: string;
+    name: string;
+    agent: string;
+    project?: string;
+    framework: string;
+    tags: string[];
+    startedAt: Date;
+    durationMs: number;
+    status: SessionStatus;
+    tokenTotal: number;
+    costUsd: number;
+    steps: SessionStep[];
+}
+export interface FlushResult {
+    ok: boolean;
+    sessionId?: string;
+    url?: string;
+    error?: string;
+}
+export declare function getLastFlushResult(): FlushResult | null;
+export declare function _resetLastFlushResult(): void;
+/** POST a recorded session to `${apiUrl}/api/sessions`. */
+export declare function flushSession(payload: FlushPayload): Promise<FlushResult>;
+/** GET `/api/sessions/${id}` — used by `ReplaySession.run()`. */
+export declare function fetchSession(sessionId: string): Promise<{
+    ok: true;
+    session: unknown;
+} | {
+    ok: false;
+    status: number;
+    body: string;
+}>;
+/** GET `/api/sessions/${id}/export?lang=...` — used by `ReplaySession.export()`. */
+export declare function fetchExport(sessionId: string, lang: "pytest" | "jest"): Promise<string>;
+//# sourceMappingURL=store.d.ts.map

package/dist/cjs/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/store.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,WAAW,YAAY;IAC3B,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAOD,wBAAgB,kBAAkB,IAAI,WAAW,GAAG,IAAI,CAEvD;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AA8BD,2DAA2D;AAC3D,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA2C9E;AAED,iEAAiE;AACjE,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAYvF;AAED,oFAAoF;AACpF,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,QAAQ,GAAG,MAAM,GACtB,OAAO,CAAC,MAAM,CAAC,CAajB"}

package/dist/cjs/store.js

@@ -0,0 +1,125 @@
+"use strict";
+// ReplayAI TypeScript SDK — store.
+// POSTs a recorded session to the ReplayAI API. Swallows errors in non-strict
+// mode so instrumented agents never break.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLastFlushResult = getLastFlushResult;
+exports._resetLastFlushResult = _resetLastFlushResult;
+exports.flushSession = flushSession;
+exports.fetchSession = fetchSession;
+exports.fetchExport = fetchExport;
+const config_js_1 = require("./config.js");
+// Module-level record of the most recent flush. Used by demos / callers that
+// want the URL after `withTrace` completes (the documented `withTrace`
+// signature returns the wrapped fn's value, not the session info).
+let lastFlushResult = null;
+function getLastFlushResult() {
+    return lastFlushResult;
+}
+function _resetLastFlushResult() {
+    lastFlushResult = null;
+}
+function buildBody(payload) {
+    return {
+        projectSlug: payload.project,
+        name: payload.name,
+        agent: payload.agent,
+        framework: payload.framework,
+        status: payload.status,
+        startedAt: payload.startedAt.toISOString(),
+        durationMs: payload.durationMs,
+        tokenTotal: payload.tokenTotal,
+        costUsd: payload.costUsd,
+        tags: payload.tags,
+        steps: payload.steps.map((s) => ({
+            type: s.type,
+            name: s.name,
+            t: s.t ?? s.offsetMs ?? 0,
+            offsetMs: s.offsetMs ?? s.t ?? 0,
+            durationMs: s.durationMs ?? 0,
+            status: s.status,
+            model: s.model ?? undefined,
+            tokensIn: s.tokensIn ?? undefined,
+            tokensOut: s.tokensOut ?? undefined,
+            input: s.input ?? "",
+            output: s.output ?? "",
+        })),
+    };
+}
+/** POST a recorded session to `${apiUrl}/api/sessions`. */
+async function flushSession(payload) {
+    const cfg = (0, config_js_1.getConfig)();
+    const url = `${cfg.apiUrl}/api/sessions`;
+    const body = buildBody(payload);
+    const headers = {
+        "content-type": "application/json",
+        "user-agent": `@replayai/sdk ts/0.4.1`,
+    };
+    if (cfg.token)
+        headers.authorization = `Bearer ${cfg.token}`;
+    try {
+        const res = await fetch(url, {
+            method: "POST",
+            headers,
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => "");
+            const msg = `ReplayAI flush failed: ${res.status} ${res.statusText}${text ? ` — ${text}` : ""}`;
+            if (cfg.strict)
+                throw new Error(msg);
+            console.warn(`[replayai] ${msg}`);
+            const result = { ok: false, error: msg };
+            lastFlushResult = result;
+            return result;
+        }
+        const json = (await res.json());
+        const sid = json.session?.id;
+        const result = {
+            ok: true,
+            sessionId: sid,
+            url: sid ? `${cfg.dashboardUrl}/?s=${sid}` : undefined,
+        };
+        lastFlushResult = result;
+        return result;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (cfg.strict)
+            throw err;
+        console.warn(`[replayai] flush error: ${msg}`);
+        const result = { ok: false, error: msg };
+        lastFlushResult = result;
+        return result;
+    }
+}
+/** GET `/api/sessions/${id}` — used by `ReplaySession.run()`. */
+async function fetchSession(sessionId) {
+    const cfg = (0, config_js_1.getConfig)();
+    const url = `${cfg.apiUrl}/api/sessions/${encodeURIComponent(sessionId)}`;
+    const headers = {};
+    if (cfg.token)
+        headers.authorization = `Bearer ${cfg.token}`;
+    const res = await fetch(url, { headers });
+    if (!res.ok) {
+        const body = await res.text().catch(() => "");
+        return { ok: false, status: res.status, body };
+    }
+    const json = await res.json();
+    return { ok: true, session: json };
+}
+/** GET `/api/sessions/${id}/export?lang=...` — used by `ReplaySession.export()`. */
+async function fetchExport(sessionId, lang) {
+    const cfg = (0, config_js_1.getConfig)();
+    const url = `${cfg.apiUrl}/api/sessions/${encodeURIComponent(sessionId)}/export?lang=${encodeURIComponent(lang)}`;
+    const headers = {};
+    if (cfg.token)
+        headers.authorization = `Bearer ${cfg.token}`;
+    const res = await fetch(url, { headers });
+    if (!res.ok) {
+        const body = await res.text().catch(() => "");
+        throw new Error(`ReplaySession.export: GET ${url} → ${res.status} ${res.statusText}${body ? ` — ${body}` : ""}`);
+    }
+    return await res.text();
+}
+//# sourceMappingURL=store.js.map

package/dist/cjs/store.js.map

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

package/dist/cjs/types.d.ts

@@ -0,0 +1,124 @@
+export type StepType = "llm_call" | "tool_call" | "retrieval" | "decision" | "error";
+export type StepStatus = "success" | "failed" | "running" | "warning";
+export type SessionStatus = "success" | "failed" | "running";
+/** A single recorded step inside a session. Mirrors the API's SessionStep. */
+export interface SessionStep {
+    id?: string;
+    type: StepType;
+    name: string;
+    /** ms offset from session start (alias of offsetMs) */
+    t?: number;
+    offsetMs?: number;
+    durationMs?: number;
+    status: StepStatus;
+    model?: string | null;
+    tokensIn?: number | null;
+    tokensOut?: number | null;
+    input?: string;
+    output?: string;
+}
+/** A full agent session as returned by the API. */
+export interface AgentSession {
+    id: string;
+    projectId?: string;
+    name: string;
+    agent: string;
+    framework: string;
+    status: SessionStatus;
+    startedAt: string;
+    durationMs: number;
+    tokenTotal: number;
+    costUsd: number;
+    tags: string[];
+    steps: SessionStep[];
+    /** Present on list responses. */
+    stepCount?: number;
+    /** Present when joined with project on the detail endpoint. */
+    project?: AgentProject;
+}
+export interface AgentProject {
+    id: string;
+    name: string;
+    slug: string;
+    framework: string;
+    description?: string | null;
+    createdAt: string;
+    sessionCount?: number;
+}
+/** Options accepted by `trace()` and `withTrace()`. */
+export interface TraceOptions {
+    /** Project slug or id. Falls back to REPLAYAI_PROJECT env var. */
+    project?: string;
+    tags?: string[];
+    framework?: string;
+    startedAt?: Date;
+    /** Agent name (defaults to the trace name). */
+    agent?: string;
+    /** Per-call override of the sample rate (0.0–1.0). */
+    sampleRate?: number;
+}
+/** Lightweight view of a recorded/replayed trace. */
+export interface Trace {
+    stepCount: number;
+    status: SessionStatus;
+    steps: SessionStep[];
+    durationMs?: number;
+    tokenTotal?: number;
+    costUsd?: number;
+    sessionId?: string;
+    sessionUrl?: string;
+}
+export interface ReplaySessionOptions {
+    liveLlm?: boolean;
+}
+export interface RunOptions {
+    agent: string;
+    framework?: string;
+}
+export interface RecordStepInput {
+    type?: StepType;
+    name: string;
+    model?: string | null;
+    tokensIn?: number;
+    tokensOut?: number;
+    input?: unknown;
+    output?: unknown;
+    status?: StepStatus;
+    /** ms offset from session start; inferred if omitted. */
+    offsetMs?: number;
+    /** alias for offsetMs */
+    t?: number;
+    durationMs?: number;
+}
+export interface ConfigOptions {
+    project?: string;
+    token?: string;
+    storage?: "local" | "cloud" | "both";
+    storagePath?: string;
+    apiUrl?: string;
+    dashboardUrl?: string;
+    sampleRate?: number;
+    strict?: boolean;
+    redactPatterns?: Array<string | RegExp>;
+}
+/**
+ * Internal representation of a session being recorded. Populated by
+ * `withTrace()`/`trace()` and flushed by `store.flushSession()`.
+ */
+export interface InternalSession {
+    id: string;
+    name: string;
+    agent: string;
+    project?: string;
+    framework: string;
+    tags: string[];
+    startedAt: Date;
+    /** wall-clock ms captured on enter — used for offset inference */
+    __startMs: number;
+    steps: SessionStep[];
+    status: SessionStatus;
+    error?: unknown;
+    endAt?: Date;
+}
+export type ExportLang = "pytest" | "jest";
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/types.d.ts.map

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