@sovara/sdk 0.0.0-stage → 0.9.1

package/dist/runtimeClient.js

@@ -0,0 +1,287 @@
+import { createHash, randomUUID } from "node:crypto";
+import { stableJsonStringify } from "./util/stableJson.js";
+import { readDesktopPlatformSessionToken } from "./platformSession.js";
+import { compatibilityHeaders, hasFeature, raiseForCompatibilityResponse } from "./compatibility.js";
+const TRACE_WRITE_TOKEN_HEADER = "x-sovara-trace-token";
+// Serialized fields above this many UTF-8 bytes go through chunked uploads, well below the
+// body limit of common proxies, when the server advertises capture_uploads.
+const CAPTURE_UPLOAD_THRESHOLD_BYTES = 32 * 1024 * 1024;
+const UPLOAD_PART_TIMEOUT_MS = 120_000;
+export class RuntimeClientError extends Error {
+    status;
+    body;
+    detail;
+    constructor(status, body) {
+        const raw = body?.detail;
+        const detail = typeof raw === "string" && raw.trim() ? raw.trim() : undefined;
+        super(`Runtime client request failed with status ${status}${detail ? `: ${detail}` : ""}`);
+        this.status = status;
+        this.body = body;
+        this.detail = detail;
+    }
+}
+/** Internal immutable identity for writes to one registered recording. */
+export class TraceWriteCredentials {
+    traceId;
+    recordingId;
+    #traceWriteToken;
+    constructor(traceId, recordingId, traceWriteToken) {
+        this.traceId = traceId;
+        this.recordingId = recordingId;
+        this.#traceWriteToken = traceWriteToken;
+        Object.freeze(this);
+    }
+    authorizationHeaders() {
+        return { [TRACE_WRITE_TOKEN_HEADER]: this.#traceWriteToken };
+    }
+}
+function toJsonBody(payload) {
+    return stableJsonStringify(payload);
+}
+function requireStringField(payload, field) {
+    const value = payload && typeof payload === "object" ? payload[field] : undefined;
+    if (typeof value !== "string" || value.trim() === "") {
+        throw new RuntimeClientError(200, { error: "invalid_runtime_response", field });
+    }
+    return value;
+}
+function credentialsFromPayload(payload) {
+    return new TraceWriteCredentials(requireStringField(payload, "trace_id"), requireStringField(payload, "recording_id"), requireStringField(payload, "trace_write_token"));
+}
+export class RuntimeClient {
+    baseUrl;
+    fetchFn;
+    agentToken;
+    // Prepare's input upload per step, so finalize can reference it instead of re-uploading.
+    inputRefsByStep = new Map();
+    constructor(baseUrl, fetchFn, agentToken) {
+        this.baseUrl = baseUrl.replace(/\/$/, "");
+        this.agentToken = agentToken?.trim() || undefined;
+        if (fetchFn) {
+            this.fetchFn = fetchFn;
+            return;
+        }
+        const maybeOriginal = globalThis[Symbol.for("sovara.originalFetch")];
+        this.fetchFn = typeof maybeOriginal === "function" ? maybeOriginal : fetch;
+    }
+    async registerTrace(request) {
+        const payload = await this.request("/runner/register", {
+            method: "POST",
+            body: toJsonBody({
+                name: request.name,
+                trace_id: request.traceId,
+                eval_run_id: request.evalRunId,
+                project_id: request.projectId,
+                project_name: request.projectName,
+                project_root: request.projectRoot,
+                code_version: request.codeVersion,
+            }),
+        });
+        const credentials = credentialsFromPayload(payload);
+        const projectId = payload.project_id;
+        return {
+            credentials,
+            projectId: typeof projectId === "string" && projectId.trim() ? projectId : undefined,
+            appended: payload.appended === true,
+        };
+    }
+    async registerSubtrace(request) {
+        const payload = await this.request("/runner/subtrace", {
+            method: "POST",
+            body: toJsonBody({
+                name: request.name,
+                parent_trace_id: request.credentials.traceId,
+                turn_id: request.turnId,
+                lesson_scope_paths: request.lessonScopePaths ?? null,
+            }),
+        }, request.credentials);
+        const credentials = credentialsFromPayload(payload);
+        return { credentials };
+    }
+    async declareTurn(credentials, turnInput) {
+        const payload = await this.request("/runner/turns", { method: "POST", body: toJsonBody({ trace_id: credentials.traceId, turn_input: turnInput ?? null }) }, credentials);
+        if (payload.trace_id !== credentials.traceId || payload.recording_id !== credentials.recordingId) {
+            throw new RuntimeClientError(200, { error: "invalid_turn_identity" });
+        }
+        return requireStringField(payload, "turn_id");
+    }
+    async deregisterTrace(credentials) {
+        await this.request("/runner/deregister", { method: "POST", body: toJsonBody({ trace_id: credentials.traceId }) }, credentials);
+    }
+    async updateTraceLog(request) {
+        await this.request("/runner/update-log", {
+            method: "POST",
+            body: toJsonBody({
+                trace_id: request.credentials.traceId,
+                turn_id: request.turnId,
+                log_text: request.logText,
+                replace: request.replace,
+            }),
+        }, request.credentials);
+    }
+    async logMetrics(request) {
+        await this.request("/runner/log", {
+            method: "POST",
+            body: toJsonBody({ trace_id: request.credentials.traceId, turn_id: request.turnId, metrics: request.metrics }),
+        }, request.credentials);
+    }
+    async logInput(request) {
+        await this.logTraceIo({ ...request, kind: "input" });
+    }
+    async logOutput(request) {
+        await this.logTraceIo({ ...request, kind: "output" });
+    }
+    async logTraceIo(request) {
+        await this.request("/runner/trace-io", {
+            method: "POST",
+            body: toJsonBody({
+                trace_id: request.credentials.traceId,
+                turn_id: request.turnId,
+                kind: request.kind,
+                value: typeof request.value === "string"
+                    ? request.value
+                    : stableJsonStringify(request.value),
+            }),
+        }, request.credentials);
+    }
+    /** Upload bytes for one step as a chunked capture upload and return its upload ID. */
+    async uploadCapture(credentials, stepUuid, data) {
+        const created = await this.request("/internal/runner/uploads", {
+            method: "POST",
+            body: toJsonBody({
+                trace_id: credentials.traceId,
+                step_uuid: stepUuid,
+                total_size: data.length,
+                sha256: createHash("sha256").update(data).digest("hex"),
+            }),
+        }, credentials);
+        const { upload_id: uploadId, part_size: partSize, part_count: partCount } = created;
+        for (let partNumber = 0; partNumber < partCount; partNumber += 1) {
+            const part = data.subarray(partNumber * partSize, (partNumber + 1) * partSize);
+            const putPart = () => this.request(`/internal/runner/uploads/${uploadId}/parts/${partNumber}`, {
+                method: "PUT",
+                body: new Uint8Array(part.buffer, part.byteOffset, part.length),
+                headers: { "content-type": "application/octet-stream" },
+                signal: AbortSignal.timeout(UPLOAD_PART_TIMEOUT_MS),
+            }, credentials);
+            try {
+                await putPart();
+            }
+            catch (error) {
+                // The server accepts a repeated part until completion, so retry once after a network
+                // error or timeout that may have lost the acknowledgement; anything else is final.
+                const lostAck = error instanceof TypeError || (error instanceof Error && error.name === "TimeoutError");
+                if (!lostAck)
+                    throw error;
+                await putPart();
+            }
+        }
+        await this.request(`/internal/runner/uploads/${uploadId}/complete`, { method: "POST", body: toJsonBody({}) }, credentials);
+        return uploadId;
+    }
+    /** Return the `<name>_ref` or `<name>_json` body field for a serialized payload. */
+    async payloadField(credentials, name, stepUuid, text, ref) {
+        let uploadRef = ref;
+        if (uploadRef === undefined
+            && Buffer.byteLength(text, "utf8") > CAPTURE_UPLOAD_THRESHOLD_BYTES
+            && hasFeature(this.baseUrl, "capture_uploads")) {
+            uploadRef = await this.uploadCapture(credentials, stepUuid, Buffer.from(text, "utf8"));
+        }
+        return uploadRef === undefined ? { [`${name}_json`]: text } : { [`${name}_ref`]: uploadRef };
+    }
+    async prepareCall(request) {
+        const clientStepUuid = randomUUID();
+        const inputField = await this.payloadField(request.credentials, "input", clientStepUuid, request.inputJson);
+        const inputRef = inputField.input_ref;
+        const payload = await this.request("/internal/runner/llm/prepare", {
+            method: "POST",
+            body: toJsonBody({
+                trace_id: request.credentials.traceId,
+                turn_id: request.turnId,
+                ...inputField,
+                // The upload is bound to this step, so prepare must name it.
+                ...(inputRef ? { step_uuid: clientStepUuid } : {}),
+                api_type: request.apiType,
+                stack_trace: request.stackTrace,
+                prompt_bearing_suffix_json: request.promptBearingSuffixJson,
+                prepare_runtime_lessons: request.prepareRuntimeLessons ?? false,
+                lesson_scope_paths: request.lessonScopePaths ?? null,
+            }),
+        }, request.credentials);
+        const stepUuid = requireStringField(payload, "step_uuid");
+        if (inputRef && payload.prepared_input_json === undefined) {
+            this.inputRefsByStep.set(stepUuid, inputRef);
+        }
+        return {
+            stepUuid,
+            stepKind: payload.step_kind ?? null,
+            preparedInputJson: payload.prepared_input_json ?? request.inputJson,
+            suffixKeysJson: payload.suffix_keys_json ?? "[]",
+            promptBearingSuffixJson: payload.prompt_bearing_suffix_json
+                ?? request.promptBearingSuffixJson,
+            preparedRawInput: payload.prepared_raw_input ?? null,
+        };
+    }
+    async recordOutput(request) {
+        await this.finalize(request, false);
+    }
+    async recordException(request) {
+        await this.finalize(request, true);
+    }
+    async finalize(request, failed) {
+        // Kept until finalize succeeds, so a recordException fallback still reuses the upload.
+        const inputRef = this.inputRefsByStep.get(request.stepUuid);
+        const inputField = await this.payloadField(request.credentials, "input", request.stepUuid, request.inputJson, inputRef);
+        const outputField = failed || request.outputJson === undefined
+            ? {}
+            : await this.payloadField(request.credentials, "output", request.stepUuid, request.outputJson);
+        await this.request("/internal/runner/llm/finalize", {
+            method: "POST",
+            body: toJsonBody({
+                trace_id: request.credentials.traceId,
+                turn_id: request.turnId,
+                step_uuid: request.stepUuid,
+                api_type: request.apiType,
+                ...(failed ? { status: request.status ?? "error" } : {}),
+                ...inputField,
+                ...(failed
+                    ? { error_json: request.errorJson, clear_output: request.clearOutput ?? true }
+                    : outputField),
+                latency_seconds: request.latencySeconds ?? null,
+                stack_trace: request.stackTrace ?? null,
+                step_kind: request.stepKind ?? null,
+                suffix_keys_json: request.suffixKeysJson ?? "[]",
+                prompt_bearing_suffix_json: request.promptBearingSuffixJson ?? "[]",
+                lesson_metadata: request.lessonMetadata ?? null,
+            }),
+        }, request.credentials);
+        this.inputRefsByStep.delete(request.stepUuid);
+    }
+    async request(path, init, credentials) {
+        const agentToken = credentials
+            ? ""
+            : (this.agentToken
+                ?? (typeof process !== "undefined" ? process.env.SOVARA_AGENT_TOKEN?.trim() : ""));
+        const platformSession = credentials || agentToken ? "" : readDesktopPlatformSessionToken();
+        const response = await this.fetchFn(`${this.baseUrl}${path}`, {
+            ...init,
+            headers: {
+                ...compatibilityHeaders(this.baseUrl),
+                "content-type": "application/json",
+                ...(agentToken ? { "x-sovara-agent-token": agentToken } : {}),
+                ...(platformSession ? { "x-sovara-platform-session": platformSession } : {}),
+                ...(credentials ? credentials.authorizationHeaders() : {}),
+                ...(init.headers ?? {}),
+            },
+        });
+        const contentType = response.headers.get("content-type") ?? "";
+        const isJson = contentType.toLowerCase().includes("application/json");
+        const body = isJson ? await response.json() : await response.text();
+        if (!response.ok) {
+            raiseForCompatibilityResponse(response.status, body);
+            throw new RuntimeClientError(response.status, body);
+        }
+        return body;
+    }
+}
+//# sourceMappingURL=runtimeClient.js.map

package/dist/runtimeClient.js.map

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

package/dist/serverLifecycle.d.ts

@@ -0,0 +1,12 @@
+type Deps = {
+    fetchFn?: typeof fetch;
+    which?: (name: string) => string | null;
+    spawn?: (bin: string, args: string[], options?: {
+        env?: NodeJS.ProcessEnv;
+    }) => {
+        status: number | null;
+    };
+};
+export declare function ensureServerRunning(url: string, deps?: Deps): Promise<boolean>;
+export {};
+//# sourceMappingURL=serverLifecycle.d.ts.map

package/dist/serverLifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverLifecycle.d.ts","sourceRoot":"","sources":["../src/serverLifecycle.ts"],"names":[],"mappings":"AAQA,KAAK,IAAI,GAAG;IACV,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IACxC,KAAK,CAAC,EAAE,CACN,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;KAAE,KAClC;QAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CAChC,CAAC;AAyEF,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,IAAS,GACd,OAAO,CAAC,OAAO,CAAC,CAalB"}

package/dist/serverLifecycle.js

@@ -0,0 +1,77 @@
+import { spawnSync } from "node:child_process";
+import { warnOnce } from "./util/logger.js";
+import { checkCompatibility, CompatibilityError, raiseForCompatibilityResponse, } from "./compatibility.js";
+const CLI_UNREACHABLE_WARNING = "Sovara exec server is unreachable and could not be started. Install the " +
+    "Sovara CLI (https://docs.sovara-labs.com) so it can manage the local exec " +
+    "server, or set SOVARA_EXEC_SERVER_URL to a reachable server. Continuing " +
+    "without Sovara recording.";
+function defaultFetch() {
+    const maybeOriginal = globalThis[Symbol.for("sovara.originalFetch")];
+    return typeof maybeOriginal === "function"
+        ? maybeOriginal
+        : fetch;
+}
+function defaultWhich(name) {
+    const res = spawnSync(process.platform === "win32" ? "where" : "which", [name], {
+        encoding: "utf8",
+    });
+    if (res.status !== 0)
+        return null;
+    return res.stdout.split(/\r?\n/)[0]?.trim() || null;
+}
+async function isHealthy(url, fetchFn) {
+    try {
+        let response = await fetchFn(`${url}/runner/health`);
+        if (response.status === 404)
+            response = await fetchFn(`${url}/health`);
+        if (!response.ok) {
+            if (response.status === 400 || response.status === 409) {
+                raiseForCompatibilityResponse(response.status, await response.json());
+            }
+            return false;
+        }
+        const payload = (await response.json());
+        if (payload.status !== "ok" || payload.service !== "sovara-exec-server")
+            return false;
+        checkCompatibility(url, payload);
+        return true;
+    }
+    catch (error) {
+        if (error instanceof CompatibilityError)
+            throw error;
+        return false;
+    }
+}
+async function restartViaCli(url, deps) {
+    const bin = deps.which("sovara");
+    if (!bin)
+        return false;
+    try {
+        deps.spawn(bin, ["exec-server", "start"], {
+            env: { ...process.env, SOVARA_EXEC_SERVER_URL: url },
+        });
+    }
+    catch {
+        return false;
+    }
+    const deadline = Date.now() + 10_000;
+    while (Date.now() < deadline) {
+        if (await isHealthy(url, deps.fetchFn))
+            return true;
+        await new Promise((r) => setTimeout(r, 250));
+    }
+    return isHealthy(url, deps.fetchFn);
+}
+export async function ensureServerRunning(url, deps = {}) {
+    const fetchFn = deps.fetchFn ?? defaultFetch();
+    const which = deps.which ?? defaultWhich;
+    const spawn = deps.spawn ??
+        ((bin, args, options) => spawnSync(bin, args, { timeout: 25_000, env: options?.env }));
+    if (await isHealthy(url, fetchFn))
+        return true;
+    if (await restartViaCli(url, { fetchFn, which, spawn }))
+        return true;
+    warnOnce("exec-server-unreachable", CLI_UNREACHABLE_WARNING);
+    return false;
+}
+//# sourceMappingURL=serverLifecycle.js.map

package/dist/serverLifecycle.js.map

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

package/dist/toolTraceUtils.d.ts

@@ -0,0 +1,38 @@
+import { type TraceScopeClient } from "./context.js";
+import type { PrepareCallResponse, TraceWriteCredentials } from "./runtimeClient.js";
+export type PreparedToolTrace = {
+    preparedCall: PrepareCallResponse;
+    credentials: TraceWriteCredentials;
+    turnId: string | null;
+    inputJson: string;
+    startedAt: number;
+    client: TraceScopeClient;
+};
+export declare function normalizeJsonable(value: unknown): unknown;
+export declare function buildToolInputDict(args: {
+    toolName: string;
+    toolInput: unknown;
+    toolCallId: string;
+    meta?: Record<string, unknown>;
+}): Record<string, unknown>;
+export declare function buildToolSuccessOutput(args: {
+    toolName: string;
+    toolCallId: string;
+    result: unknown;
+    meta?: Record<string, unknown>;
+}): Record<string, unknown>;
+export declare function buildToolErrorOutput(args: {
+    toolName: string;
+    toolCallId: string;
+    error: unknown;
+}): Record<string, unknown>;
+export declare function shouldTraceTool(toolCallId: string | undefined): boolean;
+export declare function prepareToolTrace(args: {
+    toolName: string;
+    toolInput: unknown;
+    toolCallId: string;
+    apiType: string;
+    meta?: Record<string, unknown>;
+}): Promise<PreparedToolTrace>;
+export declare function recordPreparedToolOutput(trace: PreparedToolTrace, output: Record<string, unknown>, apiType: string): Promise<void>;
+//# sourceMappingURL=toolTraceUtils.d.ts.map

package/dist/toolTraceUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolTraceUtils.d.ts","sourceRoot":"","sources":["../src/toolTraceUtils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAIrF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,EAAE,mBAAmB,CAAC;IAClC,WAAW,EAAE,qBAAqB,CAAC;IACnC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,gBAAgB,CAAC;CAC1B,CAAC;AAuEF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEzD;AA4BD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqB1B;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmB1B;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAY1B;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEvE;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAmC7B;AAED,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/toolTraceUtils.js

@@ -0,0 +1,189 @@
+import { performance } from "node:perf_hooks";
+import { serialize } from "superjson";
+import { getCurrentTraceScope } from "./context.js";
+import { wrapForStorage } from "./payload/wrap.js";
+import { stableJsonStringify } from "./util/stableJson.js";
+import { sanitizeStackTrace } from "./util/stackTrace.js";
+function isPlainRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function fallbackString(value) {
+    try {
+        return String(value);
+    }
+    catch {
+        return "[Unserializable]";
+    }
+}
+function unserializableMarker(error) {
+    const errorType = error instanceof Error ? error.name : "Error";
+    return { _sovara_unserializable: errorType };
+}
+function sanitizeJsonValue(value, seen = new WeakSet()) {
+    if (value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+        if (typeof value === "number" && !Number.isFinite(value)) {
+            return String(value);
+        }
+        return value;
+    }
+    if (value === undefined) {
+        return null;
+    }
+    if (typeof value === "bigint" || typeof value === "symbol" || typeof value === "function") {
+        return fallbackString(value);
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => sanitizeJsonValue(item, seen));
+    }
+    const objectValue = value;
+    if (seen.has(objectValue)) {
+        return "[Circular]";
+    }
+    seen.add(objectValue);
+    try {
+        return Object.fromEntries(Object.entries(objectValue).map(([key, item]) => [key, sanitizeJsonValue(item, seen)]));
+    }
+    catch (error) {
+        return unserializableMarker(error);
+    }
+}
+function normalizeTraceValue(value) {
+    try {
+        const serialized = serialize(value);
+        const normalized = {
+            json: sanitizeJsonValue(serialized.json),
+        };
+        if (serialized.meta !== undefined) {
+            normalized.superjsonMeta = sanitizeJsonValue(serialized.meta);
+        }
+        return normalized;
+    }
+    catch (error) {
+        return { json: unserializableMarker(error) };
+    }
+}
+export function normalizeJsonable(value) {
+    return normalizeTraceValue(value).json;
+}
+function normalizedMetaRecord(meta) {
+    const normalized = normalizeTraceValue(meta ?? {});
+    return {
+        meta: isPlainRecord(normalized.json) ? normalized.json : {},
+        superjsonMeta: normalized.superjsonMeta,
+    };
+}
+function valueTypeName(value) {
+    if (value === null) {
+        return "null";
+    }
+    if (value === undefined) {
+        return "undefined";
+    }
+    if (typeof value !== "object" && typeof value !== "function") {
+        return typeof value;
+    }
+    const constructorName = value.constructor?.name;
+    return typeof constructorName === "string" && constructorName ? constructorName : typeof value;
+}
+export function buildToolInputDict(args) {
+    const normalizedInput = normalizeTraceValue(args.toolInput);
+    const payload = {
+        tool_name: args.toolName,
+        tool_call_id: args.toolCallId,
+        tool_input: normalizedInput.json,
+    };
+    const { meta, superjsonMeta } = normalizedMetaRecord(args.meta);
+    if (normalizedInput.superjsonMeta !== undefined) {
+        meta.tool_input_superjson_meta = normalizedInput.superjsonMeta;
+    }
+    if (superjsonMeta !== undefined) {
+        meta.meta_superjson_meta = superjsonMeta;
+    }
+    if (Object.keys(meta).length > 0) {
+        payload._meta = meta;
+    }
+    if (Array.isArray(normalizedInput.json) || isPlainRecord(normalizedInput.json)) {
+        payload.tool_input_json = stableJsonStringify(normalizedInput.json);
+    }
+    return payload;
+}
+export function buildToolSuccessOutput(args) {
+    const normalizedOutput = normalizeTraceValue(args.result);
+    const { meta, superjsonMeta } = normalizedMetaRecord(args.meta);
+    if (superjsonMeta !== undefined) {
+        meta.meta_superjson_meta = superjsonMeta;
+    }
+    if (normalizedOutput.superjsonMeta !== undefined) {
+        meta.tool_output_superjson_meta = normalizedOutput.superjsonMeta;
+    }
+    if (!("output_type" in meta)) {
+        meta.output_type = valueTypeName(args.result);
+    }
+    return {
+        tool_name: args.toolName,
+        tool_call_id: args.toolCallId,
+        status: "success",
+        tool_output: normalizedOutput.json,
+        _meta: meta,
+    };
+}
+export function buildToolErrorOutput(args) {
+    const error = args.error;
+    const errorType = error instanceof Error ? error.name : "Error";
+    const errorMessage = error instanceof Error ? error.message || error.name : fallbackString(error) || errorType;
+    return {
+        tool_name: args.toolName,
+        tool_call_id: args.toolCallId,
+        status: "error",
+        error_type: errorType,
+        error_message: errorMessage,
+    };
+}
+export function shouldTraceTool(toolCallId) {
+    return Boolean(toolCallId) && getCurrentTraceScope() !== undefined;
+}
+export async function prepareToolTrace(args) {
+    const scope = getCurrentTraceScope();
+    if (!scope) {
+        throw new Error("No active Sovara trace");
+    }
+    const inputJson = stableJsonStringify(wrapForStorage(buildToolInputDict({
+        toolName: args.toolName,
+        toolInput: args.toolInput,
+        toolCallId: args.toolCallId,
+        meta: args.meta,
+    }), { apiType: args.apiType, direction: "input" }));
+    const preparedCall = await scope.client.prepareCall({
+        credentials: scope.credentials,
+        turnId: scope.turnId,
+        inputJson,
+        apiType: args.apiType,
+        stackTrace: sanitizeStackTrace(new Error().stack),
+        promptBearingSuffixJson: "[]",
+        lessonScopePaths: scope.lessonScopePaths,
+    });
+    return {
+        preparedCall,
+        credentials: scope.credentials,
+        turnId: scope.turnId,
+        inputJson: preparedCall.preparedInputJson ?? inputJson,
+        startedAt: performance.now(),
+        client: scope.client,
+    };
+}
+export async function recordPreparedToolOutput(trace, output, apiType) {
+    await trace.client.recordOutput({
+        credentials: trace.credentials,
+        turnId: trace.turnId,
+        stepUuid: trace.preparedCall.stepUuid,
+        apiType,
+        inputJson: trace.inputJson,
+        outputJson: stableJsonStringify(wrapForStorage(output, { apiType, direction: "output" })),
+        latencySeconds: Math.max(0, (performance.now() - trace.startedAt) / 1000),
+        stackTrace: null,
+        stepKind: trace.preparedCall.stepKind,
+        suffixKeysJson: trace.preparedCall.suffixKeysJson ?? "[]",
+        promptBearingSuffixJson: trace.preparedCall.promptBearingSuffixJson ?? "[]",
+    });
+}
+//# sourceMappingURL=toolTraceUtils.js.map

package/dist/toolTraceUtils.js.map

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