autotel-devtools 20.0.1 → 21.0.0

package/README.md

@@ -214,6 +214,7 @@ AUTOTEL_MAX_METRIC_COUNT=50000   # Max metrics to keep (default: 100)
 AUTOTEL_DEVTOOLS_PORT=4318       # Server port (default: 4318)
 AUTOTEL_DEVTOOLS_HOST=127.0.0.1  # Bind host (default: 127.0.0.1)
 AUTOTEL_DEVTOOLS_TITLE="My App"  # Dashboard title (optional)
+AUTOTEL_DEVTOOLS_SOURCE_ROOT=.   # Root GET /source may read (default: cwd on a loopback bind, else off; `false` disables)
 ```
 
 ### CLI Options

package/dist/cli.cjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-const require_http = require('./http-j-oBI6r6.cjs');
-const require_listen = require('./listen-DGzVi7DE.cjs');
+const require_http = require('./http-CXSzX4ee.cjs');
+const require_listen = require('./listen-CEJ3nYJf.cjs');
 let node_http = require("node:http");
 let node_fs = require("node:fs");
 let node_path = require("node:path");
@@ -79,9 +79,11 @@ async function startReceiver(options) {
 		host: options.host,
 		verbose: true
 	});
+	const sourceRoot = require_http.resolveSourceRoot(process.env.AUTOTEL_DEVTOOLS_SOURCE_ROOT, process.cwd(), loopbackOnly);
 	require_http.attachDevtoolsRoutes(httpServer, wsServer, {
 		loopbackOnly,
-		title: options.title
+		title: options.title,
+		sourceRoot
 	});
 	const listeners = require_listen.listenLoopbackDualStack({
 		primary: httpServer,
@@ -89,7 +91,8 @@ async function startReceiver(options) {
 		host: options.host,
 		attachSecondary: (s) => require_http.attachDevtoolsRoutes(s, wsServer, {
 			loopbackOnly,
-			title: options.title
+			title: options.title,
+			sourceRoot
 		})
 	});
 	const { addresses, warnings, port: boundPort } = await listeners.ready;

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { d as DevtoolsServer, i as probePortHolder, p as hostHeaderIsLoopback, t as attachDevtoolsRoutes } from "./http-uVPjDDld.js";
-import { t as listenLoopbackDualStack } from "./listen-NVMbBWHw.js";
+import { a as probePortHolder, f as DevtoolsServer, m as hostHeaderIsLoopback, r as resolveSourceRoot, t as attachDevtoolsRoutes } from "./http-CNZMrnzv.js";
+import { t as listenLoopbackDualStack } from "./listen-DBfsfcdd.js";
 import { createServer } from "node:http";
 import { readFileSync } from "node:fs";
 import { dirname, resolve } from "node:path";
@@ -79,9 +79,11 @@ async function startReceiver(options) {
 		host: options.host,
 		verbose: true
 	});
+	const sourceRoot = resolveSourceRoot(process.env.AUTOTEL_DEVTOOLS_SOURCE_ROOT, process.cwd(), loopbackOnly);
 	attachDevtoolsRoutes(httpServer, wsServer, {
 		loopbackOnly,
-		title: options.title
+		title: options.title,
+		sourceRoot
 	});
 	const listeners = listenLoopbackDualStack({
 		primary: httpServer,
@@ -89,7 +91,8 @@ async function startReceiver(options) {
 		host: options.host,
 		attachSecondary: (s) => attachDevtoolsRoutes(s, wsServer, {
 			loopbackOnly,
-			title: options.title
+			title: options.title,
+			sourceRoot
 		})
 	});
 	const { addresses, warnings, port: boundPort } = await listeners.ready;

package/dist/{error-aggregator-CGgWr2OH.d.cts → error-aggregator-D8VKciLY.d.ts}

@@ -1,5 +1,15 @@
-import { a as ErrorGroup, o as ErrorOccurrence, u as TraceData } from "./exporter-CEKKJTci.cjs";
+import { a as ErrorGroup, o as ErrorOccurrence, u as TraceData } from "./exporter-Due9Rd4s.js";
 //#region src/server/error-aggregator.d.ts
+/** How many errors the aggregator is holding, and what they are. */
+interface ErrorStats {
+  totalGroups: number;
+  totalErrors: number;
+  recentErrors: number;
+  topErrorTypes: Array<{
+    type: string;
+    count: number;
+  }>;
+}
 interface ErrorAggregatorOptions {
   /**
    * Maximum number of error groups to track (default: 100)
@@ -96,15 +106,7 @@ declare class ErrorAggregator {
   /**
    * Get error statistics
    */
-  getStats(): {
-    totalGroups: number;
-    totalErrors: number;
-    recentErrors: number;
-    topErrorTypes: Array<{
-      type: string;
-      count: number;
-    }>;
-  };
+  getStats(): ErrorStats;
   /**
    * Clear all error groups
    */

package/dist/{error-aggregator-DufjI2IG.d.ts → error-aggregator-DCEKMOm3.d.cts}

@@ -1,5 +1,15 @@
-import { a as ErrorGroup, o as ErrorOccurrence, u as TraceData } from "./exporter-BJwufQwg.js";
+import { a as ErrorGroup, o as ErrorOccurrence, u as TraceData } from "./exporter-Dt4kx128.cjs";
 //#region src/server/error-aggregator.d.ts
+/** How many errors the aggregator is holding, and what they are. */
+interface ErrorStats {
+  totalGroups: number;
+  totalErrors: number;
+  recentErrors: number;
+  topErrorTypes: Array<{
+    type: string;
+    count: number;
+  }>;
+}
 interface ErrorAggregatorOptions {
   /**
    * Maximum number of error groups to track (default: 100)
@@ -96,15 +106,7 @@ declare class ErrorAggregator {
   /**
    * Get error statistics
    */
-  getStats(): {
-    totalGroups: number;
-    totalErrors: number;
-    recentErrors: number;
-    topErrorTypes: Array<{
-      type: string;
-      count: number;
-    }>;
-  };
+  getStats(): ErrorStats;
   /**
    * Clear all error groups
    */

package/dist/{exporter-CEKKJTci.d.cts → exporter-Dt4kx128.d.cts}

@@ -1,3 +1,4 @@
+import { n as SpanAttributes } from "./types-DHDvZnnn.cjs";
 import { Server } from "node:http";
 import { AgentRawEvent, AgentSession, OtelMetricRecord } from "autotel-agents";
 import { ReadableSpan, SpanExporter } from "@opentelemetry/sdk-trace-base";
@@ -12,7 +13,7 @@ interface SpanData {
   startTime: number;
   endTime: number;
   duration: number;
-  attributes: Record<string, any>;
+  attributes: SpanAttributes;
   status: {
     code: 'OK' | 'ERROR' | 'UNSET';
     message?: string;
@@ -20,12 +21,12 @@ interface SpanData {
   events?: Array<{
     name: string;
     timestamp: number;
-    attributes?: Record<string, any>;
+    attributes?: SpanAttributes;
   }>;
   links?: Array<{
     traceId: string;
     spanId: string;
-    attributes?: Record<string, any>;
+    attributes?: SpanAttributes;
   }>;
   scope?: {
     name?: string;
@@ -61,14 +62,14 @@ interface LogData {
   severityNumber?: number;
   body: string | Record<string, unknown>;
   timestamp: number;
-  attributes?: Record<string, unknown>;
+  attributes?: SpanAttributes;
   resource?: Record<string, unknown>;
 }
 interface MetricData {
   type: 'event' | 'funnel' | 'outcome' | 'value';
   name: string;
   value?: number;
-  attributes: Record<string, any>;
+  attributes: SpanAttributes;
   timestamp: number;
   traceId?: string;
 }
@@ -83,7 +84,7 @@ interface ErrorGroup {
   affectedTraces: string[];
   affectedSpans: string[];
   service?: string;
-  attributes?: Record<string, unknown>;
+  attributes?: SpanAttributes;
 }
 interface ErrorOccurrence {
   traceId: string;
@@ -95,8 +96,15 @@ interface ErrorOccurrence {
     type: string;
     message: string;
     stackTrace?: string;
+    /**
+     * Grouping key the emitting SDK already decided on (`exception.fingerprint`,
+     * written by autotel's `exceptionFingerprint()` enricher). When present the
+     * aggregator groups by it instead of re-deriving one from the stack string,
+     * so this tab agrees with every other backend receiving the same spans.
+     */
+    fingerprint?: string;
   };
-  attributes?: Record<string, unknown>;
+  attributes?: SpanAttributes;
 }
 interface DevtoolsData {
   traces: TraceData[];

package/dist/{exporter-BJwufQwg.d.ts → exporter-Due9Rd4s.d.ts}

@@ -1,3 +1,4 @@
+import { n as SpanAttributes } from "./types-DHDvZnnn.js";
 import { Server } from "node:http";
 import { AgentRawEvent, AgentSession, OtelMetricRecord } from "autotel-agents";
 import { ExportResult } from "@opentelemetry/core";
@@ -12,7 +13,7 @@ interface SpanData {
   startTime: number;
   endTime: number;
   duration: number;
-  attributes: Record<string, any>;
+  attributes: SpanAttributes;
   status: {
     code: 'OK' | 'ERROR' | 'UNSET';
     message?: string;
@@ -20,12 +21,12 @@ interface SpanData {
   events?: Array<{
     name: string;
     timestamp: number;
-    attributes?: Record<string, any>;
+    attributes?: SpanAttributes;
   }>;
   links?: Array<{
     traceId: string;
     spanId: string;
-    attributes?: Record<string, any>;
+    attributes?: SpanAttributes;
   }>;
   scope?: {
     name?: string;
@@ -61,14 +62,14 @@ interface LogData {
   severityNumber?: number;
   body: string | Record<string, unknown>;
   timestamp: number;
-  attributes?: Record<string, unknown>;
+  attributes?: SpanAttributes;
   resource?: Record<string, unknown>;
 }
 interface MetricData {
   type: 'event' | 'funnel' | 'outcome' | 'value';
   name: string;
   value?: number;
-  attributes: Record<string, any>;
+  attributes: SpanAttributes;
   timestamp: number;
   traceId?: string;
 }
@@ -83,7 +84,7 @@ interface ErrorGroup {
   affectedTraces: string[];
   affectedSpans: string[];
   service?: string;
-  attributes?: Record<string, unknown>;
+  attributes?: SpanAttributes;
 }
 interface ErrorOccurrence {
   traceId: string;
@@ -95,8 +96,15 @@ interface ErrorOccurrence {
     type: string;
     message: string;
     stackTrace?: string;
+    /**
+     * Grouping key the emitting SDK already decided on (`exception.fingerprint`,
+     * written by autotel's `exceptionFingerprint()` enricher). When present the
+     * aggregator groups by it instead of re-deriving one from the stack string,
+     * so this tab agrees with every other backend receiving the same spans.
+     */
+    fingerprint?: string;
   };
-  attributes?: Record<string, unknown>;
+  attributes?: SpanAttributes;
 }
 interface DevtoolsData {
   traces: TraceData[];

package/dist/genai/index.cjs

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_json_fields = require('../json-fields-DZFlNqT2.cjs');
 
 //#region src/widget/genai/detect.ts
 const GENAI_MARKERS = [
@@ -150,25 +151,6 @@ function priceCall(inputs) {
 
 //#endregion
 //#region src/widget/genai/normalize.ts
-function str(v) {
-	return typeof v === "string" ? v : void 0;
-}
-function num(v) {
-	if (typeof v === "number") return v;
-	if (typeof v === "string" && v !== "") {
-		const n = Number(v);
-		return Number.isFinite(n) ? n : void 0;
-	}
-}
-function strArray(v) {
-	if (Array.isArray(v) && v.every((x) => typeof x === "string")) return v;
-	if (typeof v === "string") return [v];
-}
-function bool(v) {
-	if (typeof v === "boolean") return v;
-	if (v === "true") return true;
-	if (v === "false") return false;
-}
 function parseJson(v) {
 	if (v == null) return void 0;
 	if (typeof v === "object") return v;
@@ -221,9 +203,10 @@ function normalizeMessageParts(raw) {
 			value: p
 		};
 	});
-	if (typeof raw.content === "string") return [{
+	const legacyText = require_json_fields.asString(raw.content);
+	if (legacyText !== void 0) return [{
 		kind: "text",
-		text: raw.content
+		text: legacyText
 	}];
 	if (raw.content != null) return [{
 		kind: "json",
@@ -232,7 +215,8 @@ function normalizeMessageParts(raw) {
 	return [];
 }
 function unwrapToolResult(payload) {
-	return payload && typeof payload === "object" && "value" in payload ? payload.value : payload;
+	const wrapper = require_json_fields.asObject(payload);
+	return wrapper && "value" in wrapper ? wrapper.value : payload;
 }
 function classifyAiSdkPart(part) {
 	if (part.type === "tool-call") return {
@@ -346,8 +330,9 @@ function messagesFromEvents(events) {
 	for (const ev of events) {
 		const attrs = ev.attributes ?? {};
 		if (ev.name === "gen_ai.choice") {
-			const message = parseJson(attrs.message) ?? attrs.message;
-			const finishReason = str(attrs.finish_reason);
+			const unparsedMessage = attrs.message;
+			const message = parseJson(attrs.message) ?? unparsedMessage;
+			const finishReason = require_json_fields.asString(attrs.finish_reason);
 			if (message) {
 				const normalized = normalizeMessage(message);
 				if (finishReason) normalized.finishReason = finishReason;
@@ -359,12 +344,13 @@ function messagesFromEvents(events) {
 		if (!m) continue;
 		const role = m[1];
 		const content = attrs.content;
-		const parsed = typeof content === "string" ? parseJson(content) ?? content : content;
+		const contentText = require_json_fields.asString(content);
+		const parsed = contentText === void 0 ? content : parseJson(contentText) ?? contentText;
 		out.push(normalizeMessage({
 			role,
 			content: parsed,
 			tool_calls: parseJson(attrs.tool_calls),
-			tool_call_id: str(attrs.id) ?? str(attrs.tool_call_id)
+			tool_call_id: require_json_fields.asString(attrs.id) ?? require_json_fields.asString(attrs.tool_call_id)
 		}));
 	}
 	return out;
@@ -372,7 +358,7 @@ function messagesFromEvents(events) {
 function readToolDefinitions(attrs) {
 	const raw = parseJson(attrs["gen_ai.tool.definitions"] ?? attrs["gen_ai.orchestrator.agent.definitions"]);
 	if (!Array.isArray(raw)) return void 0;
-	return raw.filter((d) => typeof d.name === "string").map((d) => ({
+	return raw.filter((d) => require_json_fields.asString(d.name) !== void 0).map((d) => ({
 		name: d.name,
 		description: d.description,
 		type: d.type,
@@ -381,18 +367,18 @@ function readToolDefinitions(attrs) {
 }
 function readUsage(attrs) {
 	return {
-		inputTokens: num(attrs["gen_ai.usage.input_tokens"]) ?? num(attrs["gen_ai.usage.prompt_tokens"]) ?? num(attrs["llm.usage.prompt_tokens"]) ?? num(attrs["ai.usage.inputTokens"]),
-		outputTokens: num(attrs["gen_ai.usage.output_tokens"]) ?? num(attrs["gen_ai.usage.completion_tokens"]) ?? num(attrs["llm.usage.completion_tokens"]) ?? num(attrs["ai.usage.outputTokens"]),
-		reasoningOutputTokens: num(attrs["gen_ai.usage.reasoning.output_tokens"]),
-		cacheReadInputTokens: num(attrs["gen_ai.usage.cache_read.input_tokens"]),
-		cacheCreationInputTokens: num(attrs["gen_ai.usage.cache_creation.input_tokens"])
+		inputTokens: require_json_fields.asNumber(attrs["gen_ai.usage.input_tokens"]) ?? require_json_fields.asNumber(attrs["gen_ai.usage.prompt_tokens"]) ?? require_json_fields.asNumber(attrs["llm.usage.prompt_tokens"]) ?? require_json_fields.asNumber(attrs["ai.usage.inputTokens"]),
+		outputTokens: require_json_fields.asNumber(attrs["gen_ai.usage.output_tokens"]) ?? require_json_fields.asNumber(attrs["gen_ai.usage.completion_tokens"]) ?? require_json_fields.asNumber(attrs["llm.usage.completion_tokens"]) ?? require_json_fields.asNumber(attrs["ai.usage.outputTokens"]),
+		reasoningOutputTokens: require_json_fields.asNumber(attrs["gen_ai.usage.reasoning.output_tokens"]),
+		cacheReadInputTokens: require_json_fields.asNumber(attrs["gen_ai.usage.cache_read.input_tokens"]),
+		cacheCreationInputTokens: require_json_fields.asNumber(attrs["gen_ai.usage.cache_creation.input_tokens"])
 	};
 }
 function readStreaming(attrs) {
-	const timeToFirstChunkS = num(attrs["gen_ai.response.time_to_first_chunk"]);
-	const timeToFinishS = num(attrs["gen_ai.response.time_to_finish"]);
-	const outputTokensPerSecond = num(attrs["gen_ai.response.output_tokens_per_second"]);
-	const timePerOutputChunkS = num(attrs["gen_ai.response.time_per_output_chunk"]);
+	const timeToFirstChunkS = require_json_fields.asNumber(attrs["gen_ai.response.time_to_first_chunk"]);
+	const timeToFinishS = require_json_fields.asNumber(attrs["gen_ai.response.time_to_finish"]);
+	const outputTokensPerSecond = require_json_fields.asNumber(attrs["gen_ai.response.output_tokens_per_second"]);
+	const timePerOutputChunkS = require_json_fields.asNumber(attrs["gen_ai.response.time_per_output_chunk"]);
 	if (timeToFirstChunkS === void 0 && timeToFinishS === void 0 && outputTokensPerSecond === void 0 && timePerOutputChunkS === void 0) return;
 	return {
 		timeToFirstChunkS,
@@ -402,12 +388,12 @@ function readStreaming(attrs) {
 	};
 }
 function readSession(attrs) {
-	const costUsd = num(attrs["gen_ai.session.cost.usd"]);
-	const inputTokens = num(attrs["gen_ai.session.input_tokens"]);
-	const outputTokens = num(attrs["gen_ai.session.output_tokens"]);
-	const stepCount = num(attrs["gen_ai.session.step.count"]);
-	const toolCallCount = num(attrs["gen_ai.session.tool_call.count"]);
-	const errorCount = num(attrs["gen_ai.session.error.count"]);
+	const costUsd = require_json_fields.asNumber(attrs["gen_ai.session.cost.usd"]);
+	const inputTokens = require_json_fields.asNumber(attrs["gen_ai.session.input_tokens"]);
+	const outputTokens = require_json_fields.asNumber(attrs["gen_ai.session.output_tokens"]);
+	const stepCount = require_json_fields.asNumber(attrs["gen_ai.session.step.count"]);
+	const toolCallCount = require_json_fields.asNumber(attrs["gen_ai.session.tool_call.count"]);
+	const errorCount = require_json_fields.asNumber(attrs["gen_ai.session.error.count"]);
 	if (costUsd === void 0 && inputTokens === void 0 && outputTokens === void 0 && stepCount === void 0 && toolCallCount === void 0 && errorCount === void 0) return;
 	return {
 		costUsd,
@@ -419,18 +405,18 @@ function readSession(attrs) {
 	};
 }
 function readGuardDetails(a, defaultAction) {
-	const rule = str(a["gen_ai.guard.rule"]);
+	const rule = require_json_fields.asString(a["gen_ai.guard.rule"]);
 	if (!rule) return void 0;
 	return {
 		rule,
-		action: str(a["gen_ai.guard.action"]) ?? defaultAction,
-		message: str(a["gen_ai.guard.message"]),
-		observed: num(a["gen_ai.guard.observed"]),
-		limit: num(a["gen_ai.guard.limit"])
+		action: require_json_fields.asString(a["gen_ai.guard.action"]) ?? defaultAction,
+		message: require_json_fields.asString(a["gen_ai.guard.message"]),
+		observed: require_json_fields.asNumber(a["gen_ai.guard.observed"]),
+		limit: require_json_fields.asNumber(a["gen_ai.guard.limit"])
 	};
 }
 function readGuardAndWarnings(attrs, events) {
-	const stopped = bool(attrs["gen_ai.guard.stopped"]);
+	const stopped = require_json_fields.asBoolean(attrs["gen_ai.guard.stopped"]);
 	const warnings = [];
 	let guard = readGuardDetails(attrs);
 	const apply = (next) => {
@@ -539,17 +525,17 @@ const KNOWN_TOP_LEVEL_KEYS = /* @__PURE__ */ new Set([
 ]);
 function toGenAiSpan(span) {
 	const attrs = span.attributes ?? {};
-	const provider = normalizeProviderName(str(attrs["gen_ai.provider.name"]) ?? str(attrs["gen_ai.system"]) ?? str(attrs["ai.model.provider"]) ?? "unknown");
-	const operation = str(attrs["gen_ai.operation.name"]) ?? "chat";
-	const requestModel = str(attrs["gen_ai.request.model"]) ?? str(attrs["llm.request.model"]) ?? str(attrs["model_name"]) ?? str(attrs["ai.model.id"]) ?? "unknown";
-	const responseModel = str(attrs["gen_ai.response.model"]) ?? str(attrs["llm.response.model"]) ?? str(attrs["ai.response.model"]);
+	const provider = normalizeProviderName(require_json_fields.asString(attrs["gen_ai.provider.name"]) ?? require_json_fields.asString(attrs["gen_ai.system"]) ?? require_json_fields.asString(attrs["ai.model.provider"]) ?? "unknown");
+	const operation = require_json_fields.asString(attrs["gen_ai.operation.name"]) ?? "chat";
+	const requestModel = require_json_fields.asString(attrs["gen_ai.request.model"]) ?? require_json_fields.asString(attrs["llm.request.model"]) ?? require_json_fields.asString(attrs["model_name"]) ?? require_json_fields.asString(attrs["ai.model.id"]) ?? "unknown";
+	const responseModel = require_json_fields.asString(attrs["gen_ai.response.model"]) ?? require_json_fields.asString(attrs["llm.response.model"]) ?? require_json_fields.asString(attrs["ai.response.model"]);
 	const inputMessages = readMessagesAttribute(attrs, "gen_ai.input.messages") ?? [];
 	const outputMessages = readMessagesAttribute(attrs, "gen_ai.output.messages") ?? [];
 	let systemInstructions = [];
 	const rawSystem = parseJson(attrs["gen_ai.system_instructions"]);
 	if (Array.isArray(rawSystem) && rawSystem.length > 0) {
-		const first = rawSystem[0];
-		if (first && typeof first === "object" && "role" in first) systemInstructions = rawSystem.map((m) => normalizeMessage(m));
+		const first = require_json_fields.asObject(rawSystem[0]);
+		if (first && "role" in first) systemInstructions = rawSystem.map((m) => normalizeMessage(m));
 		else systemInstructions = [{
 			role: "system",
 			parts: rawSystem.map((p) => p.type === "text" || p.content !== void 0 ? {
@@ -566,8 +552,8 @@ function toGenAiSpan(span) {
 		...inputMessages,
 		...outputMessages
 	] : messagesFromEvents(span.events);
-	const inputRef = str(attrs["gen_ai.input.messages.ref"]);
-	const outputRef = str(attrs["gen_ai.output.messages.ref"]);
+	const inputRef = require_json_fields.asString(attrs["gen_ai.input.messages.ref"]);
+	const outputRef = require_json_fields.asString(attrs["gen_ai.output.messages.ref"]);
 	const hasInputContent = messages.some((m) => m.role === "system" || m.role === "user");
 	const hasOutputContent = messages.some((m) => m.role === "assistant");
 	if (inputRef && !hasInputContent) messages.push({
@@ -610,14 +596,14 @@ function toGenAiSpan(span) {
 			}
 		}
 		const aiResponseToolCalls = parseJson(attrs["ai.response.toolCalls"]);
-		const assistantToolCalls = Array.isArray(aiResponseToolCalls) ? aiResponseToolCalls.filter((c) => typeof c.toolName === "string").map((c) => ({
+		const assistantToolCalls = Array.isArray(aiResponseToolCalls) ? aiResponseToolCalls.filter((c) => require_json_fields.asString(c.toolName) !== void 0).map((c) => ({
 			id: c.toolCallId,
 			name: c.toolName,
 			arguments: parseJson(c.input ?? c.args) ?? c.input ?? c.args ?? {}
 		})) : void 0;
-		const aiResponseText = str(attrs["ai.response.text"]);
+		const aiResponseText = require_json_fields.asString(attrs["ai.response.text"]);
 		if (aiResponseText || assistantToolCalls && assistantToolCalls.length > 0) {
-			const finishReason = strArray(attrs["gen_ai.response.finish_reasons"])?.[0] ?? str(attrs["ai.response.finishReason"]);
+			const finishReason = require_json_fields.asStringArray(attrs["gen_ai.response.finish_reasons"])?.[0] ?? require_json_fields.asString(attrs["ai.response.finishReason"]);
 			const msg = normalizeMessage({
 				role: "assistant",
 				content: aiResponseText ?? ""
@@ -634,7 +620,7 @@ function toGenAiSpan(span) {
 	if (messages.length === 0) {
 		const legacy = [];
 		for (let i = 0; i < 32; i++) {
-			const role = str(attrs[`gen_ai.prompt.${i}.role`]) ?? str(attrs[`llm.prompts.${i}.role`]);
+			const role = require_json_fields.asString(attrs[`gen_ai.prompt.${i}.role`]) ?? require_json_fields.asString(attrs[`llm.prompts.${i}.role`]);
 			const content = attrs[`gen_ai.prompt.${i}.content`] ?? attrs[`llm.prompts.${i}.content`];
 			if (!role) break;
 			legacy.push(normalizeMessage({
@@ -643,9 +629,9 @@ function toGenAiSpan(span) {
 			}));
 		}
 		for (let i = 0; i < 32; i++) {
-			const role = str(attrs[`gen_ai.completion.${i}.role`]) ?? str(attrs[`llm.completions.${i}.role`]);
+			const role = require_json_fields.asString(attrs[`gen_ai.completion.${i}.role`]) ?? require_json_fields.asString(attrs[`llm.completions.${i}.role`]);
 			const content = attrs[`gen_ai.completion.${i}.content`] ?? attrs[`llm.completions.${i}.content`];
-			const finishReason = str(attrs[`gen_ai.completion.${i}.finish_reason`]);
+			const finishReason = require_json_fields.asString(attrs[`gen_ai.completion.${i}.finish_reason`]);
 			if (!role) break;
 			const msg = normalizeMessage({
 				role,
@@ -692,7 +678,7 @@ function toGenAiSpan(span) {
 		cacheReadInputTokens: usage.cacheReadInputTokens,
 		cacheCreationInputTokens: usage.cacheCreationInputTokens
 	});
-	const reportedCost = num(attrs["gen_ai.usage.cost.usd"]);
+	const reportedCost = require_json_fields.asNumber(attrs["gen_ai.usage.cost.usd"]);
 	const cost = reportedCost !== void 0 ? {
 		currency: "USD",
 		input: tableCost?.input ?? 0,
@@ -705,34 +691,34 @@ function toGenAiSpan(span) {
 	const streaming = readStreaming(attrs);
 	const session = readSession(attrs);
 	const { guard, warnings } = readGuardAndWarnings(attrs, span.events);
-	const finishReasons = strArray(attrs["gen_ai.response.finish_reasons"]);
-	const agentName = str(attrs["gen_ai.agent.name"]);
-	const agentId = str(attrs["gen_ai.agent.id"]);
-	const agentDescription = str(attrs["gen_ai.agent.description"]);
-	const toolName = str(attrs["gen_ai.tool.name"]);
-	const toolCallId = str(attrs["gen_ai.tool.call.id"]);
-	const handoffFrom = str(attrs["gen_ai.handoff.from_agent"]);
-	const handoffTo = str(attrs["gen_ai.handoff.to_agent"]);
-	const guardrailName = str(attrs["gen_ai.guardrail.name"]);
-	const guardrailTriggered = bool(attrs["gen_ai.guardrail.triggered"]);
-	const evalName = str(attrs["gen_ai.evaluation.name"]);
-	const evalScoreValue = num(attrs["gen_ai.evaluation.score.value"]);
-	const evalScoreLabel = str(attrs["gen_ai.evaluation.score.label"]);
-	const evalExplanation = str(attrs["gen_ai.evaluation.explanation"]);
-	const audioIn = str(attrs["gen_ai.audio.input.format"]);
-	const audioOut = str(attrs["gen_ai.audio.output.format"]);
-	const speechVoice = str(attrs["gen_ai.speech.voice"]);
-	const speechInputText = str(attrs["gen_ai.speech.input_text"]);
-	const transcriptionText = str(attrs["gen_ai.transcription.text"]);
-	const embeddingDims = num(attrs["gen_ai.embeddings.dimension.count"]);
-	const consentOutcome = str(attrs["agent.consent.outcome"]);
-	const policyDecision = str(attrs["policy.decision"]);
-	const injectionVerdict = str(attrs["mcp.security.injection.verdict"]);
-	const actionRiskClass = str(attrs["agent.action.risk_class"]);
-	const inputProvenance = str(attrs["agent.input.provenance"]);
-	const planStepIndex = num(attrs["agent.plan.step_index"]);
-	const securityEvent = str(attrs["security.event"]);
-	const guardStoppedAttr = bool(attrs["gen_ai.guard.stopped"]);
+	const finishReasons = require_json_fields.asStringArray(attrs["gen_ai.response.finish_reasons"]);
+	const agentName = require_json_fields.asString(attrs["gen_ai.agent.name"]);
+	const agentId = require_json_fields.asString(attrs["gen_ai.agent.id"]);
+	const agentDescription = require_json_fields.asString(attrs["gen_ai.agent.description"]);
+	const toolName = require_json_fields.asString(attrs["gen_ai.tool.name"]);
+	const toolCallId = require_json_fields.asString(attrs["gen_ai.tool.call.id"]);
+	const handoffFrom = require_json_fields.asString(attrs["gen_ai.handoff.from_agent"]);
+	const handoffTo = require_json_fields.asString(attrs["gen_ai.handoff.to_agent"]);
+	const guardrailName = require_json_fields.asString(attrs["gen_ai.guardrail.name"]);
+	const guardrailTriggered = require_json_fields.asBoolean(attrs["gen_ai.guardrail.triggered"]);
+	const evalName = require_json_fields.asString(attrs["gen_ai.evaluation.name"]);
+	const evalScoreValue = require_json_fields.asNumber(attrs["gen_ai.evaluation.score.value"]);
+	const evalScoreLabel = require_json_fields.asString(attrs["gen_ai.evaluation.score.label"]);
+	const evalExplanation = require_json_fields.asString(attrs["gen_ai.evaluation.explanation"]);
+	const audioIn = require_json_fields.asString(attrs["gen_ai.audio.input.format"]);
+	const audioOut = require_json_fields.asString(attrs["gen_ai.audio.output.format"]);
+	const speechVoice = require_json_fields.asString(attrs["gen_ai.speech.voice"]);
+	const speechInputText = require_json_fields.asString(attrs["gen_ai.speech.input_text"]);
+	const transcriptionText = require_json_fields.asString(attrs["gen_ai.transcription.text"]);
+	const embeddingDims = require_json_fields.asNumber(attrs["gen_ai.embeddings.dimension.count"]);
+	const consentOutcome = require_json_fields.asString(attrs["agent.consent.outcome"]);
+	const policyDecision = require_json_fields.asString(attrs["policy.decision"]);
+	const injectionVerdict = require_json_fields.asString(attrs["mcp.security.injection.verdict"]);
+	const actionRiskClass = require_json_fields.asString(attrs["agent.action.risk_class"]);
+	const inputProvenance = require_json_fields.asString(attrs["agent.input.provenance"]);
+	const planStepIndex = require_json_fields.asNumber(attrs["agent.plan.step_index"]);
+	const securityEvent = require_json_fields.asString(attrs["security.event"]);
+	const guardStoppedAttr = require_json_fields.asBoolean(attrs["gen_ai.guard.stopped"]);
 	const agentSecurity = consentOutcome || policyDecision || injectionVerdict || actionRiskClass || inputProvenance || planStepIndex !== void 0 || securityEvent || guardStoppedAttr !== void 0 || guard?.stopped ? {
 		...consentOutcome && { consentOutcome },
 		...policyDecision && { policyDecision },
@@ -764,15 +750,15 @@ function toGenAiSpan(span) {
 		requestModel,
 		responseModel,
 		params: {
-			temperature: num(attrs["gen_ai.request.temperature"]),
-			topP: num(attrs["gen_ai.request.top_p"]),
-			topK: num(attrs["gen_ai.request.top_k"]),
-			maxTokens: num(attrs["gen_ai.request.max_tokens"]),
-			stopSequences: strArray(attrs["gen_ai.request.stop_sequences"]),
-			seed: num(attrs["gen_ai.request.seed"]),
-			frequencyPenalty: num(attrs["gen_ai.request.frequency_penalty"]),
-			presencePenalty: num(attrs["gen_ai.request.presence_penalty"]),
-			choiceCount: num(attrs["gen_ai.request.choice.count"])
+			temperature: require_json_fields.asNumber(attrs["gen_ai.request.temperature"]),
+			topP: require_json_fields.asNumber(attrs["gen_ai.request.top_p"]),
+			topK: require_json_fields.asNumber(attrs["gen_ai.request.top_k"]),
+			maxTokens: require_json_fields.asNumber(attrs["gen_ai.request.max_tokens"]),
+			stopSequences: require_json_fields.asStringArray(attrs["gen_ai.request.stop_sequences"]),
+			seed: require_json_fields.asNumber(attrs["gen_ai.request.seed"]),
+			frequencyPenalty: require_json_fields.asNumber(attrs["gen_ai.request.frequency_penalty"]),
+			presencePenalty: require_json_fields.asNumber(attrs["gen_ai.request.presence_penalty"]),
+			choiceCount: require_json_fields.asNumber(attrs["gen_ai.request.choice.count"])
 		},
 		messages,
 		toolDefinitions: readToolDefinitions(attrs),
@@ -784,7 +770,7 @@ function toGenAiSpan(span) {
 		session,
 		warnings,
 		finishReasons,
-		responseId: str(attrs["gen_ai.response.id"]),
+		responseId: require_json_fields.asString(attrs["gen_ai.response.id"]),
 		agent: agentId || agentName || agentDescription ? {
 			id: agentId,
 			name: agentName,
@@ -802,7 +788,7 @@ function toGenAiSpan(span) {
 			name: guardrailName,
 			triggered: guardrailTriggered
 		} : void 0,
-		conversationId: str(attrs["gen_ai.conversation.id"]),
+		conversationId: require_json_fields.asString(attrs["gen_ai.conversation.id"]),
 		agentSecurity,
 		evaluation: evalName || evalScoreValue !== void 0 || evalScoreLabel || evalExplanation ? {
 			name: evalName,
@@ -819,12 +805,12 @@ function toGenAiSpan(span) {
 			embeddingDimensions: embeddingDims
 		} : void 0,
 		extras: {
-			openaiServiceTier: str(attrs["gen_ai.openai.request.service_tier"]) || str(attrs["gen_ai.openai.response.service_tier"]) || str(attrs["openai.request.service_tier"]) || str(attrs["openai.response.service_tier"]) ? {
-				request: str(attrs["gen_ai.openai.request.service_tier"]) ?? str(attrs["openai.request.service_tier"]),
-				response: str(attrs["gen_ai.openai.response.service_tier"]) ?? str(attrs["openai.response.service_tier"])
+			openaiServiceTier: require_json_fields.asString(attrs["gen_ai.openai.request.service_tier"]) || require_json_fields.asString(attrs["gen_ai.openai.response.service_tier"]) || require_json_fields.asString(attrs["openai.request.service_tier"]) || require_json_fields.asString(attrs["openai.response.service_tier"]) ? {
+				request: require_json_fields.asString(attrs["gen_ai.openai.request.service_tier"]) ?? require_json_fields.asString(attrs["openai.request.service_tier"]),
+				response: require_json_fields.asString(attrs["gen_ai.openai.response.service_tier"]) ?? require_json_fields.asString(attrs["openai.response.service_tier"])
 			} : void 0,
-			openaiSystemFingerprint: str(attrs["gen_ai.openai.response.system_fingerprint"]) ?? str(attrs["openai.response.system_fingerprint"]),
-			openaiResponseFormat: str(attrs["gen_ai.openai.request.response_format"]) ?? str(attrs["openai.request.response_format"]),
+			openaiSystemFingerprint: require_json_fields.asString(attrs["gen_ai.openai.response.system_fingerprint"]) ?? require_json_fields.asString(attrs["openai.response.system_fingerprint"]),
+			openaiResponseFormat: require_json_fields.asString(attrs["gen_ai.openai.request.response_format"]) ?? require_json_fields.asString(attrs["openai.request.response_format"]),
 			raw
 		}
 	};