@smazzinni/sdk 0.4.1

package/dist/session.js

@@ -0,0 +1,61 @@
+// ReplayAI TypeScript SDK — ReplaySession: replay a recorded session and
+// export it as a test. Wraps GET /api/sessions/:id and /export.
+import { fetchExport, fetchSession } from "./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");
+ * ```
+ */
+export 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 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 fetchExport(this.sessionId, lang);
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,gEAAgE;AAEhE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAWvD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,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,YAAY,CAAC,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,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/dist/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/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/steps.js

@@ -0,0 +1,56 @@
+// ReplayAI TypeScript SDK — manual step recording.
+import { appendStep } from "./context.js";
+import { redactText } from "./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.
+ */
+export 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: redactText(input.input),
+        output: redactText(input.output),
+        status: coerceStatus(input.status),
+        t: input.t ?? input.offsetMs,
+        offsetMs: input.offsetMs ?? input.t,
+        durationMs: input.durationMs ?? 0,
+    };
+    appendStep(step);
+}
+/** Sync variant — same as `recordStep()` but without the await ceremony. */
+export 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: redactText(input.input),
+        output: redactText(input.output),
+        status: coerceStatus(input.status),
+        t: input.t ?? input.offsetMs,
+        offsetMs: input.offsetMs ?? input.t,
+        durationMs: input.durationMs ?? 0,
+    };
+    appendStep(step);
+}
+//# sourceMappingURL=steps.js.map

package/dist/steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.js","sourceRoot":"","sources":["../src/steps.ts"],"names":[],"mappings":"AAAA,mDAAmD;AAEnD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;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;AACH,MAAM,CAAC,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,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC;QAC9B,MAAM,EAAE,UAAU,CAAC,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,UAAU,CAAC,IAAI,CAAC,CAAC;AACnB,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,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,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC;QAC9B,MAAM,EAAE,UAAU,CAAC,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,UAAU,CAAC,IAAI,CAAC,CAAC;AACnB,CAAC"}

package/dist/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/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/store.js

@@ -0,0 +1,118 @@
+// ReplayAI TypeScript SDK — store.
+// POSTs a recorded session to the ReplayAI API. Swallows errors in non-strict
+// mode so instrumented agents never break.
+import { getConfig } from "./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;
+export function getLastFlushResult() {
+    return lastFlushResult;
+}
+export 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`. */
+export async function flushSession(payload) {
+    const cfg = 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()`. */
+export async function fetchSession(sessionId) {
+    const cfg = 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()`. */
+export async function fetchExport(sessionId, lang) {
+    const cfg = 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/store.js.map

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

package/dist/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/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,5 @@
+// ReplayAI TypeScript SDK — shared types.
+// Mirrors the API shape defined in src/app/api/sessions/route.ts and
+// src/lib/replay-data.ts so what the SDK POSTs matches what the API expects.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,qEAAqE;AACrE,6EAA6E"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@smazzinni/sdk",
+  "version": "0.4.1",
+  "description": "TypeScript SDK for ReplayAI \u2014 instrument JS/TS agents, record sessions, replay & export tests.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsc -p tsconfig.esm.json && tsc -p tsconfig.cjs.json && node -e \"require('fs').mkdirSync('dist/cjs',{recursive:true});require('fs').writeFileSync('dist/cjs/package.json','{\\\"type\\\":\\\"commonjs\\\"}\\n')\"",
+    "prepublishOnly": "bun run build",
+    "version-check": "node -e \"console.log(require('./dist/cjs/index.js').VERSION)\"",
+    "quickstart": "bun examples/quickstart.ts"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "typescript": "^5.5.4"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "replayai",
+    "ai",
+    "agents",
+    "observability",
+    "testing",
+    "llm",
+    "tracing"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/smazzinni/replayai.git",
+    "directory": "sdks/typescript"
+  }
+}