@amplitude/ai 0.1.0

package/dist/core/tracking.js

@@ -0,0 +1,469 @@
+import { ValidationError } from "../exceptions.js";
+import { getLogger } from "../utils/logger.js";
+import { inferModelTier } from "../utils/model-tiers.js";
+import { EVENT_AI_RESPONSE, EVENT_EMBEDDING, EVENT_SCORE, EVENT_SESSION_END, EVENT_SESSION_ENRICHMENT, EVENT_SPAN, EVENT_TOOL_CALL, EVENT_USER_MESSAGE, MAX_SERIALIZED_LENGTH, PROP_ABANDONMENT_TURN, PROP_AGENT_CHAIN, PROP_AGENT_ID, PROP_AGENT_VERSION, PROP_ATTACHMENTS, PROP_ATTACHMENT_COUNT, PROP_ATTACHMENT_TYPES, PROP_CACHE_CREATION_TOKENS, PROP_CACHE_READ_TOKENS, PROP_COMMENT, PROP_COMPONENT_TYPE, PROP_CONTEXT, PROP_COST_USD, PROP_CUSTOMER_ORG_ID, PROP_EDITED_MESSAGE_ID, PROP_EMBEDDING_DIMENSIONS, PROP_ENRICHMENTS, PROP_ENV, PROP_ERROR_MESSAGE, PROP_EVALUATION_SOURCE, PROP_FINISH_REASON, PROP_HAS_ATTACHMENTS, PROP_HAS_REASONING, PROP_IDLE_TIMEOUT_MINUTES, PROP_INPUT_STATE, PROP_INPUT_TOKENS, PROP_INVOCATION_ID, PROP_IS_EDIT, PROP_IS_ERROR, PROP_IS_REGENERATION, PROP_IS_STREAMING, PROP_LATENCY_MS, PROP_LOCALE, PROP_MAX_OUTPUT_TOKENS, PROP_MESSAGE_ID, PROP_MESSAGE_LABELS, PROP_MESSAGE_LABEL_MAP, PROP_MODEL_NAME, PROP_MODEL_TIER, PROP_OUTPUT_STATE, PROP_OUTPUT_TOKENS, PROP_PARENT_AGENT_ID, PROP_PARENT_MESSAGE_ID, PROP_PARENT_SPAN_ID, PROP_PROMPT_ID, PROP_PROVIDER, PROP_QUALITY_SCORE, PROP_REASONING_CONTENT, PROP_REASONING_TOKENS, PROP_REQUEST_COMPLEXITY, PROP_ROOT_AGENT_NAME, PROP_RUNTIME, PROP_SCORE_NAME, PROP_SCORE_VALUE, PROP_SDK_VERSION, PROP_SENTIMENT_SCORE, PROP_SESSION_ID, PROP_SESSION_REPLAY_ID, PROP_SPAN_ID, PROP_SPAN_KIND, PROP_SPAN_NAME, PROP_SYSTEM_PROMPT, PROP_SYSTEM_PROMPT_LENGTH, PROP_TARGET_ID, PROP_TARGET_TYPE, PROP_TASK_FAILURE_REASON, PROP_TASK_FAILURE_TYPE, PROP_TEMPERATURE, PROP_TOOL_CALLS, PROP_TOOL_INPUT, PROP_TOOL_NAME, PROP_TOOL_OUTPUT, PROP_TOOL_SUCCESS, PROP_TOP_P, PROP_TOTAL_ATTACHMENT_SIZE, PROP_TOTAL_TOKENS, PROP_TRACE_ID, PROP_TTFB_MS, PROP_TURN_ID, PROP_WAS_CACHED, PROP_WAS_COPIED, SDK_RUNTIME, SDK_VERSION } from "./constants.js";
+import { PrivacyConfig, getTextFromLlmMessage, sanitizeStructuredContent } from "./privacy.js";
+import { randomUUID } from "node:crypto";
+
+//#region src/core/tracking.ts
+function validateRequiredStr(value, fieldName) {
+	if (typeof value !== "string" || !value) throw new ValidationError(`${fieldName} must be a non-empty string, got ${String(value)}`);
+}
+function validateNonNegative(value, fieldName) {
+	if (typeof value === "number" && value < 0) throw new ValidationError(`${fieldName} must be >= 0, got ${value}`);
+}
+function validateNumeric(value, fieldName) {
+	if (typeof value !== "number") throw new ValidationError(`${fieldName} must be numeric, got ${typeof value}`);
+}
+function serializeToJsonString(value, maxLength = MAX_SERIALIZED_LENGTH) {
+	let serialized;
+	try {
+		serialized = JSON.stringify(value);
+	} catch {
+		serialized = String(value);
+	}
+	if (serialized.length > maxLength) {
+		const truncateAt = Math.max(0, maxLength - 14);
+		return `${serialized.slice(0, truncateAt)}...[truncated]`;
+	}
+	return serialized;
+}
+function withSdkManagedProperties(eventProperties, managedProperties) {
+	return {
+		...eventProperties ?? {},
+		...managedProperties
+	};
+}
+function trackUserMessage(opts) {
+	const pc = opts.privacyConfig ?? new PrivacyConfig();
+	if (pc.validate) {
+		validateRequiredStr(opts.userId, "userId");
+		validateRequiredStr(opts.sessionId, "sessionId");
+	}
+	const messageId = opts.messageId || randomUUID();
+	const contentData = pc.sanitizeContent(opts.messageContent);
+	const properties = withSdkManagedProperties(opts.eventProperties, {
+		[PROP_TURN_ID]: opts.turnId ?? 1,
+		[PROP_MESSAGE_ID]: messageId,
+		[PROP_COMPONENT_TYPE]: "user_input",
+		[PROP_SDK_VERSION]: SDK_VERSION,
+		[PROP_RUNTIME]: SDK_RUNTIME
+	});
+	if (opts.sessionId) properties[PROP_SESSION_ID] = opts.sessionId;
+	if (opts.traceId) properties[PROP_TRACE_ID] = opts.traceId;
+	if (opts.conversationId && !opts.sessionId) properties[PROP_SESSION_ID] = opts.conversationId;
+	if (opts.env) properties[PROP_ENV] = opts.env;
+	if (opts.locale) properties[PROP_LOCALE] = opts.locale;
+	if (opts.agentId) properties[PROP_AGENT_ID] = opts.agentId;
+	if (opts.parentAgentId) properties[PROP_PARENT_AGENT_ID] = opts.parentAgentId;
+	if (opts.customerOrgId) properties[PROP_CUSTOMER_ORG_ID] = opts.customerOrgId;
+	if (opts.agentVersion) properties[PROP_AGENT_VERSION] = opts.agentVersion;
+	if (opts.context) properties[PROP_CONTEXT] = serializeToJsonString(opts.context);
+	if (opts.isRegeneration) properties[PROP_IS_REGENERATION] = true;
+	if (opts.isEdit) properties[PROP_IS_EDIT] = true;
+	if (opts.editedMessageId) properties[PROP_EDITED_MESSAGE_ID] = opts.editedMessageId;
+	if (opts.attachments?.length) {
+		properties[PROP_HAS_ATTACHMENTS] = true;
+		properties[PROP_ATTACHMENT_COUNT] = opts.attachments.length;
+		properties[PROP_ATTACHMENT_TYPES] = [...new Set(opts.attachments.map((a) => String(a.type ?? "unknown")))];
+		const totalSize = opts.attachments.reduce((sum, a) => sum + (typeof a.size_bytes === "number" ? a.size_bytes : 0), 0);
+		if (totalSize > 0) properties[PROP_TOTAL_ATTACHMENT_SIZE] = totalSize;
+		properties[PROP_ATTACHMENTS] = serializeToJsonString(opts.attachments);
+	}
+	if (opts.labels?.length) properties[PROP_MESSAGE_LABELS] = serializeToJsonString(opts.labels.map((lbl) => lbl.toDict()));
+	Object.assign(properties, contentData);
+	const event = {
+		event_type: EVENT_USER_MESSAGE,
+		user_id: opts.userId,
+		event_properties: properties
+	};
+	if (opts.userProperties) event.user_properties = opts.userProperties;
+	if (opts.groups) event.groups = opts.groups;
+	try {
+		opts.amplitude.track(event);
+		getLogger(opts.amplitude).debug(`Tracked ${EVENT_USER_MESSAGE} for user ${opts.userId}`);
+	} catch (e) {
+		getLogger(opts.amplitude).error(`Failed to track ${EVENT_USER_MESSAGE}: ${e}`);
+	}
+	return messageId;
+}
+function trackAiMessage(opts) {
+	const pc = opts.privacyConfig ?? new PrivacyConfig();
+	if (pc.validate) {
+		validateRequiredStr(opts.userId, "userId");
+		validateRequiredStr(opts.modelName, "model");
+		validateNonNegative(opts.latencyMs, "latencyMs");
+	}
+	const messageId = opts.messageId || randomUUID();
+	const contentData = pc.sanitizeContent(opts.responseContent);
+	const properties = withSdkManagedProperties(opts.eventProperties, {
+		[PROP_TURN_ID]: opts.turnId ?? 2,
+		[PROP_MESSAGE_ID]: messageId,
+		[PROP_MODEL_NAME]: opts.modelName,
+		[PROP_PROVIDER]: opts.provider,
+		[PROP_LATENCY_MS]: opts.latencyMs,
+		[PROP_IS_ERROR]: opts.isError ?? false,
+		[PROP_COMPONENT_TYPE]: "llm",
+		[PROP_SDK_VERSION]: SDK_VERSION,
+		[PROP_RUNTIME]: SDK_RUNTIME
+	});
+	if (opts.sessionId) properties[PROP_SESSION_ID] = opts.sessionId;
+	if (opts.traceId) properties[PROP_TRACE_ID] = opts.traceId;
+	if (opts.conversationId && !opts.sessionId) properties[PROP_SESSION_ID] = opts.conversationId;
+	if (opts.env) properties[PROP_ENV] = opts.env;
+	if (opts.locale) properties[PROP_LOCALE] = opts.locale;
+	if (opts.agentId) properties[PROP_AGENT_ID] = opts.agentId;
+	if (opts.parentAgentId) properties[PROP_PARENT_AGENT_ID] = opts.parentAgentId;
+	if (opts.customerOrgId) properties[PROP_CUSTOMER_ORG_ID] = opts.customerOrgId;
+	if (opts.agentVersion) properties[PROP_AGENT_VERSION] = opts.agentVersion;
+	if (opts.context) properties[PROP_CONTEXT] = serializeToJsonString(opts.context);
+	if (opts.spanKind) properties[PROP_SPAN_KIND] = opts.spanKind;
+	if (opts.wasCopied) properties[PROP_WAS_COPIED] = true;
+	if (opts.wasCached) properties[PROP_WAS_CACHED] = true;
+	if (opts.modelTier != null) properties[PROP_MODEL_TIER] = opts.modelTier;
+	else properties[PROP_MODEL_TIER] = inferModelTier(opts.modelName);
+	Object.assign(properties, contentData);
+	if (opts.inputTokens != null) properties[PROP_INPUT_TOKENS] = opts.inputTokens;
+	if (opts.outputTokens != null) properties[PROP_OUTPUT_TOKENS] = opts.outputTokens;
+	if (opts.totalTokens != null) properties[PROP_TOTAL_TOKENS] = opts.totalTokens;
+	if (opts.reasoningTokens != null) properties[PROP_REASONING_TOKENS] = opts.reasoningTokens;
+	if (opts.cacheReadInputTokens != null) properties[PROP_CACHE_READ_TOKENS] = opts.cacheReadInputTokens;
+	if (opts.cacheCreationInputTokens != null) properties[PROP_CACHE_CREATION_TOKENS] = opts.cacheCreationInputTokens;
+	if (opts.totalCostUsd != null) properties[PROP_COST_USD] = opts.totalCostUsd;
+	if (opts.providerTtfbMs != null) properties[PROP_TTFB_MS] = opts.providerTtfbMs;
+	if (opts.finishReason != null) properties[PROP_FINISH_REASON] = opts.finishReason;
+	if (opts.errorMessage != null) properties[PROP_ERROR_MESSAGE] = opts.errorMessage;
+	if (opts.toolCalls != null) properties[PROP_TOOL_CALLS] = serializeToJsonString(opts.toolCalls);
+	const reasoningProps = pc.sanitizeReasoningContent(opts.reasoningContent ?? null, opts.reasoningTokens);
+	Object.assign(properties, reasoningProps);
+	const systemPromptProps = pc.sanitizeSystemPrompt(opts.systemPrompt ?? null);
+	Object.assign(properties, systemPromptProps);
+	if (opts.temperature != null) properties[PROP_TEMPERATURE] = opts.temperature;
+	if (opts.maxOutputTokens != null) properties[PROP_MAX_OUTPUT_TOKENS] = opts.maxOutputTokens;
+	if (opts.topP != null) properties[PROP_TOP_P] = opts.topP;
+	if (opts.isStreaming != null) properties[PROP_IS_STREAMING] = opts.isStreaming;
+	if (opts.promptId != null) properties[PROP_PROMPT_ID] = opts.promptId;
+	if (opts.attachments?.length) {
+		properties[PROP_HAS_ATTACHMENTS] = true;
+		properties[PROP_ATTACHMENT_COUNT] = opts.attachments.length;
+		properties[PROP_ATTACHMENT_TYPES] = [...new Set(opts.attachments.map((a) => String(a.type ?? "unknown")))];
+		const totalSize = opts.attachments.reduce((sum, a) => sum + (typeof a.size_bytes === "number" ? a.size_bytes : 0), 0);
+		if (totalSize > 0) properties[PROP_TOTAL_ATTACHMENT_SIZE] = totalSize;
+		properties[PROP_ATTACHMENTS] = serializeToJsonString(opts.attachments);
+	}
+	if (opts.labels?.length) properties[PROP_MESSAGE_LABELS] = serializeToJsonString(opts.labels.map((lbl) => lbl.toDict()));
+	const event = {
+		event_type: EVENT_AI_RESPONSE,
+		user_id: opts.userId,
+		event_properties: properties
+	};
+	if (opts.userProperties) event.user_properties = opts.userProperties;
+	if (opts.groups) event.groups = opts.groups;
+	try {
+		opts.amplitude.track(event);
+		getLogger(opts.amplitude).debug(`Tracked ${EVENT_AI_RESPONSE} for user ${opts.userId}`);
+	} catch (e) {
+		getLogger(opts.amplitude).error(`Failed to track ${EVENT_AI_RESPONSE}: ${e}`);
+	}
+	return messageId;
+}
+function trackToolCall(opts) {
+	const pc = opts.privacyConfig ?? new PrivacyConfig();
+	if (pc.validate) {
+		validateRequiredStr(opts.userId, "userId");
+		validateRequiredStr(opts.toolName, "toolName");
+		validateNonNegative(opts.latencyMs, "latencyMs");
+	}
+	const invocationId = opts.invocationId || randomUUID();
+	const properties = withSdkManagedProperties(opts.eventProperties, {
+		[PROP_TURN_ID]: opts.turnId ?? 1,
+		[PROP_INVOCATION_ID]: invocationId,
+		[PROP_TOOL_NAME]: opts.toolName,
+		[PROP_TOOL_SUCCESS]: opts.success,
+		[PROP_IS_ERROR]: !opts.success,
+		[PROP_LATENCY_MS]: opts.latencyMs,
+		[PROP_COMPONENT_TYPE]: "tool",
+		[PROP_SDK_VERSION]: SDK_VERSION,
+		[PROP_RUNTIME]: SDK_RUNTIME
+	});
+	if (opts.sessionId) properties[PROP_SESSION_ID] = opts.sessionId;
+	if (opts.traceId) properties[PROP_TRACE_ID] = opts.traceId;
+	if (opts.conversationId && !opts.sessionId) properties[PROP_SESSION_ID] = opts.conversationId;
+	if (opts.parentMessageId) properties[PROP_PARENT_MESSAGE_ID] = opts.parentMessageId;
+	if (opts.agentId) properties[PROP_AGENT_ID] = opts.agentId;
+	if (opts.parentAgentId) properties[PROP_PARENT_AGENT_ID] = opts.parentAgentId;
+	if (opts.customerOrgId) properties[PROP_CUSTOMER_ORG_ID] = opts.customerOrgId;
+	if (opts.agentVersion) properties[PROP_AGENT_VERSION] = opts.agentVersion;
+	if (opts.context) properties[PROP_CONTEXT] = serializeToJsonString(opts.context);
+	if (opts.errorMessage) properties[PROP_ERROR_MESSAGE] = opts.errorMessage;
+	if (opts.env) properties[PROP_ENV] = opts.env;
+	if (opts.locale) properties[PROP_LOCALE] = opts.locale;
+	if (opts.spanKind) properties[PROP_SPAN_KIND] = opts.spanKind;
+	let effectiveMode = pc.contentMode;
+	if (effectiveMode == null) effectiveMode = pc.privacyMode ? "metadata_only" : "full";
+	if (opts.toolInput != null && effectiveMode === "full") properties[PROP_TOOL_INPUT] = serializeToJsonString(sanitizeStructuredContent(opts.toolInput, pc.redactPii));
+	if (opts.toolOutput != null && effectiveMode === "full") properties[PROP_TOOL_OUTPUT] = serializeToJsonString(sanitizeStructuredContent(opts.toolOutput, pc.redactPii));
+	const event = {
+		event_type: EVENT_TOOL_CALL,
+		user_id: opts.userId,
+		event_properties: properties
+	};
+	if (opts.userProperties) event.user_properties = opts.userProperties;
+	if (opts.groups) event.groups = opts.groups;
+	try {
+		opts.amplitude.track(event);
+		getLogger(opts.amplitude).debug(`Tracked ${EVENT_TOOL_CALL} for user ${opts.userId}`);
+	} catch (e) {
+		getLogger(opts.amplitude).error(`Failed to track ${EVENT_TOOL_CALL}: ${e}`);
+	}
+	return invocationId;
+}
+function trackConversation(opts) {
+	const effectiveSessionId = opts.sessionId ?? opts.conversationId ?? randomUUID();
+	let turnId = 1;
+	for (const message of opts.messages) {
+		const role = String(message.role ?? "");
+		const content = String(message.content ?? "");
+		if (role === "user") trackUserMessage({
+			amplitude: opts.amplitude,
+			userId: opts.userId,
+			messageContent: content,
+			sessionId: effectiveSessionId,
+			turnId,
+			agentId: opts.agentId,
+			parentAgentId: opts.parentAgentId,
+			customerOrgId: opts.customerOrgId,
+			agentVersion: opts.agentVersion,
+			context: opts.context,
+			env: opts.env,
+			eventProperties: opts.eventProperties,
+			userProperties: opts.userProperties,
+			groups: opts.groups,
+			privacyConfig: opts.privacyConfig
+		});
+		else if (role === "assistant" || role === "ai") trackAiMessage({
+			amplitude: opts.amplitude,
+			userId: opts.userId,
+			modelName: String(message.model ?? "unknown"),
+			provider: String(message.provider ?? "unknown"),
+			responseContent: content,
+			latencyMs: Number(message.latency_ms ?? 0),
+			sessionId: effectiveSessionId,
+			turnId,
+			inputTokens: message.input_tokens,
+			outputTokens: message.output_tokens,
+			totalTokens: message.total_tokens,
+			totalCostUsd: message.total_cost_usd,
+			agentId: opts.agentId,
+			parentAgentId: opts.parentAgentId,
+			customerOrgId: opts.customerOrgId,
+			agentVersion: opts.agentVersion,
+			context: opts.context,
+			env: opts.env,
+			eventProperties: opts.eventProperties,
+			userProperties: opts.userProperties,
+			groups: opts.groups,
+			privacyConfig: opts.privacyConfig
+		});
+		turnId++;
+	}
+}
+function trackEmbedding(opts) {
+	if ((opts.privacyConfig ?? new PrivacyConfig()).validate) {
+		validateRequiredStr(opts.userId, "userId");
+		validateNonNegative(opts.latencyMs, "latencyMs");
+	}
+	const spanId = randomUUID();
+	const properties = withSdkManagedProperties(opts.eventProperties, {
+		[PROP_SPAN_ID]: spanId,
+		[PROP_MODEL_NAME]: opts.model,
+		[PROP_PROVIDER]: opts.provider,
+		[PROP_LATENCY_MS]: opts.latencyMs,
+		[PROP_COMPONENT_TYPE]: "embedding",
+		[PROP_SDK_VERSION]: SDK_VERSION,
+		[PROP_RUNTIME]: SDK_RUNTIME
+	});
+	if (opts.sessionId) properties[PROP_SESSION_ID] = opts.sessionId;
+	if (opts.traceId != null) properties[PROP_TRACE_ID] = opts.traceId;
+	if (opts.turnId != null) properties[PROP_TURN_ID] = opts.turnId;
+	if (opts.inputTokens != null) properties[PROP_INPUT_TOKENS] = opts.inputTokens;
+	if (opts.dimensions != null) properties[PROP_EMBEDDING_DIMENSIONS] = opts.dimensions;
+	if (opts.totalCostUsd != null) properties[PROP_COST_USD] = opts.totalCostUsd;
+	if (opts.agentId) properties[PROP_AGENT_ID] = opts.agentId;
+	if (opts.parentAgentId) properties[PROP_PARENT_AGENT_ID] = opts.parentAgentId;
+	if (opts.customerOrgId) properties[PROP_CUSTOMER_ORG_ID] = opts.customerOrgId;
+	if (opts.agentVersion) properties[PROP_AGENT_VERSION] = opts.agentVersion;
+	if (opts.context) properties[PROP_CONTEXT] = serializeToJsonString(opts.context);
+	if (opts.env) properties[PROP_ENV] = opts.env;
+	const event = {
+		event_type: EVENT_EMBEDDING,
+		user_id: opts.userId,
+		event_properties: properties
+	};
+	if (opts.groups) event.groups = opts.groups;
+	try {
+		opts.amplitude.track(event);
+		getLogger(opts.amplitude).debug(`Tracked ${EVENT_EMBEDDING} for user ${opts.userId}`);
+	} catch (e) {
+		getLogger(opts.amplitude).error(`Failed to track ${EVENT_EMBEDDING}: ${e}`);
+	}
+	return spanId;
+}
+function trackSpan(opts) {
+	const pc = opts.privacyConfig ?? new PrivacyConfig();
+	if (pc.validate) {
+		validateRequiredStr(opts.userId, "userId");
+		validateNonNegative(opts.latencyMs, "latencyMs");
+	}
+	const spanId = randomUUID();
+	const properties = withSdkManagedProperties(opts.eventProperties, {
+		[PROP_SPAN_ID]: spanId,
+		[PROP_SPAN_NAME]: opts.spanName,
+		[PROP_TRACE_ID]: opts.traceId,
+		[PROP_LATENCY_MS]: opts.latencyMs,
+		[PROP_IS_ERROR]: opts.isError ?? false,
+		[PROP_SDK_VERSION]: SDK_VERSION,
+		[PROP_RUNTIME]: SDK_RUNTIME
+	});
+	if (opts.sessionId) properties[PROP_SESSION_ID] = opts.sessionId;
+	if (opts.turnId != null) properties[PROP_TURN_ID] = opts.turnId;
+	if (opts.parentSpanId) properties[PROP_PARENT_SPAN_ID] = opts.parentSpanId;
+	if (opts.errorMessage) properties[PROP_ERROR_MESSAGE] = opts.errorMessage;
+	if (opts.agentId) properties[PROP_AGENT_ID] = opts.agentId;
+	if (opts.parentAgentId) properties[PROP_PARENT_AGENT_ID] = opts.parentAgentId;
+	if (opts.customerOrgId) properties[PROP_CUSTOMER_ORG_ID] = opts.customerOrgId;
+	if (opts.agentVersion) properties[PROP_AGENT_VERSION] = opts.agentVersion;
+	if (opts.context) properties[PROP_CONTEXT] = serializeToJsonString(opts.context);
+	if (opts.env) properties[PROP_ENV] = opts.env;
+	let effectiveMode = pc.contentMode;
+	if (effectiveMode == null) effectiveMode = pc.privacyMode ? "metadata_only" : "full";
+	if (opts.inputState != null && effectiveMode === "full") properties[PROP_INPUT_STATE] = serializeToJsonString(sanitizeStructuredContent(opts.inputState, pc.redactPii));
+	if (opts.outputState != null && effectiveMode === "full") properties[PROP_OUTPUT_STATE] = serializeToJsonString(sanitizeStructuredContent(opts.outputState, pc.redactPii));
+	const event = {
+		event_type: EVENT_SPAN,
+		user_id: opts.userId,
+		event_properties: properties
+	};
+	if (opts.groups) event.groups = opts.groups;
+	try {
+		opts.amplitude.track(event);
+		getLogger(opts.amplitude).debug(`Tracked ${EVENT_SPAN} for user ${opts.userId}`);
+	} catch (e) {
+		getLogger(opts.amplitude).error(`Failed to track ${EVENT_SPAN}: ${e}`);
+	}
+	return spanId;
+}
+function trackSessionEnd(opts) {
+	if ((opts.privacyConfig ?? new PrivacyConfig()).validate) {
+		validateRequiredStr(opts.userId, "userId");
+		validateRequiredStr(opts.sessionId, "sessionId");
+	}
+	const properties = withSdkManagedProperties(opts.eventProperties, {
+		[PROP_SESSION_ID]: opts.sessionId,
+		[PROP_SDK_VERSION]: SDK_VERSION,
+		[PROP_RUNTIME]: SDK_RUNTIME
+	});
+	if (opts.traceId != null) properties[PROP_TRACE_ID] = opts.traceId;
+	if (opts.turnId != null) properties[PROP_TURN_ID] = opts.turnId;
+	if (opts.agentId) properties[PROP_AGENT_ID] = opts.agentId;
+	if (opts.parentAgentId) properties[PROP_PARENT_AGENT_ID] = opts.parentAgentId;
+	if (opts.customerOrgId) properties[PROP_CUSTOMER_ORG_ID] = opts.customerOrgId;
+	if (opts.agentVersion) properties[PROP_AGENT_VERSION] = opts.agentVersion;
+	if (opts.context) properties[PROP_CONTEXT] = serializeToJsonString(opts.context);
+	if (opts.env) properties[PROP_ENV] = opts.env;
+	if (opts.abandonmentTurn != null) properties[PROP_ABANDONMENT_TURN] = opts.abandonmentTurn;
+	if (opts.idleTimeoutMinutes != null) properties[PROP_IDLE_TIMEOUT_MINUTES] = opts.idleTimeoutMinutes;
+	if (opts.enrichments != null) properties[PROP_ENRICHMENTS] = serializeToJsonString(typeof opts.enrichments.toDict === "function" ? opts.enrichments.toDict() : opts.enrichments);
+	const event = {
+		event_type: EVENT_SESSION_END,
+		user_id: opts.userId,
+		event_properties: properties
+	};
+	if (opts.groups) event.groups = opts.groups;
+	try {
+		opts.amplitude.track(event);
+		getLogger(opts.amplitude).debug(`Tracked ${EVENT_SESSION_END} for user ${opts.userId}`);
+	} catch (e) {
+		getLogger(opts.amplitude).error(`Failed to track ${EVENT_SESSION_END}: ${e}`);
+	}
+}
+function trackSessionEnrichment(opts) {
+	if ((opts.privacyConfig ?? new PrivacyConfig()).validate) {
+		validateRequiredStr(opts.userId, "userId");
+		validateRequiredStr(opts.sessionId, "sessionId");
+	}
+	const properties = withSdkManagedProperties(opts.eventProperties, {
+		[PROP_SESSION_ID]: opts.sessionId,
+		[PROP_SDK_VERSION]: SDK_VERSION,
+		[PROP_RUNTIME]: SDK_RUNTIME
+	});
+	if (opts.traceId != null) properties[PROP_TRACE_ID] = opts.traceId;
+	if (opts.turnId != null) properties[PROP_TURN_ID] = opts.turnId;
+	if (opts.agentId) properties[PROP_AGENT_ID] = opts.agentId;
+	if (opts.parentAgentId) properties[PROP_PARENT_AGENT_ID] = opts.parentAgentId;
+	if (opts.customerOrgId) properties[PROP_CUSTOMER_ORG_ID] = opts.customerOrgId;
+	if (opts.agentVersion) properties[PROP_AGENT_VERSION] = opts.agentVersion;
+	if (opts.context) properties[PROP_CONTEXT] = serializeToJsonString(opts.context);
+	if (opts.env) properties[PROP_ENV] = opts.env;
+	properties[PROP_ENRICHMENTS] = serializeToJsonString(typeof opts.enrichments.toDict === "function" ? opts.enrichments.toDict() : opts.enrichments);
+	const event = {
+		event_type: EVENT_SESSION_ENRICHMENT,
+		user_id: opts.userId,
+		event_properties: properties
+	};
+	if (opts.groups) event.groups = opts.groups;
+	try {
+		opts.amplitude.track(event);
+		getLogger(opts.amplitude).debug(`Tracked ${EVENT_SESSION_ENRICHMENT} for user ${opts.userId}`);
+	} catch (e) {
+		getLogger(opts.amplitude).error(`Failed to track ${EVENT_SESSION_ENRICHMENT}: ${e}`);
+	}
+}
+function trackScore(opts) {
+	const pc = opts.privacyConfig ?? new PrivacyConfig();
+	if (pc.validate) {
+		validateRequiredStr(opts.userId, "userId");
+		validateNumeric(opts.value, "value");
+	}
+	const properties = withSdkManagedProperties(opts.eventProperties, {
+		[PROP_SCORE_NAME]: opts.name,
+		[PROP_SCORE_VALUE]: opts.value,
+		[PROP_TARGET_ID]: opts.targetId,
+		[PROP_TARGET_TYPE]: opts.targetType ?? "message",
+		[PROP_EVALUATION_SOURCE]: opts.source ?? "user",
+		[PROP_SDK_VERSION]: SDK_VERSION,
+		[PROP_RUNTIME]: SDK_RUNTIME
+	});
+	if (opts.sessionId) properties[PROP_SESSION_ID] = opts.sessionId;
+	if (opts.traceId != null) properties[PROP_TRACE_ID] = opts.traceId;
+	if (opts.turnId != null) properties[PROP_TURN_ID] = opts.turnId;
+	if (opts.agentId) properties[PROP_AGENT_ID] = opts.agentId;
+	if (opts.parentAgentId) properties[PROP_PARENT_AGENT_ID] = opts.parentAgentId;
+	if (opts.customerOrgId) properties[PROP_CUSTOMER_ORG_ID] = opts.customerOrgId;
+	if (opts.agentVersion) properties[PROP_AGENT_VERSION] = opts.agentVersion;
+	if (opts.context) properties[PROP_CONTEXT] = serializeToJsonString(opts.context);
+	if (opts.env) properties[PROP_ENV] = opts.env;
+	if (opts.comment != null) {
+		const commentData = pc.sanitizeContent(opts.comment);
+		if ("$llm_message" in commentData) {
+			const msg = commentData.$llm_message;
+			properties[PROP_COMMENT] = getTextFromLlmMessage(msg);
+		}
+	}
+	const event = {
+		event_type: EVENT_SCORE,
+		user_id: opts.userId,
+		event_properties: properties
+	};
+	if (opts.groups) event.groups = opts.groups;
+	try {
+		opts.amplitude.track(event);
+		getLogger(opts.amplitude).debug(`Tracked ${EVENT_SCORE} for user ${opts.userId}`);
+	} catch (e) {
+		getLogger(opts.amplitude).error(`Failed to track ${EVENT_SCORE}: ${e}`);
+	}
+}
+
+//#endregion
+export { EVENT_AI_RESPONSE, EVENT_EMBEDDING, EVENT_SCORE, EVENT_SESSION_END, EVENT_SESSION_ENRICHMENT, EVENT_SPAN, EVENT_TOOL_CALL, EVENT_USER_MESSAGE, MAX_SERIALIZED_LENGTH, PROP_ABANDONMENT_TURN, PROP_AGENT_CHAIN, PROP_AGENT_ID, PROP_AGENT_VERSION, PROP_ATTACHMENTS, PROP_ATTACHMENT_COUNT, PROP_ATTACHMENT_TYPES, PROP_CACHE_CREATION_TOKENS, PROP_CACHE_READ_TOKENS, PROP_COMMENT, PROP_COMPONENT_TYPE, PROP_CONTEXT, PROP_COST_USD, PROP_CUSTOMER_ORG_ID, PROP_EDITED_MESSAGE_ID, PROP_EMBEDDING_DIMENSIONS, PROP_ENRICHMENTS, PROP_ENV, PROP_ERROR_MESSAGE, PROP_EVALUATION_SOURCE, PROP_FINISH_REASON, PROP_HAS_ATTACHMENTS, PROP_HAS_REASONING, PROP_IDLE_TIMEOUT_MINUTES, PROP_INPUT_STATE, PROP_INPUT_TOKENS, PROP_INVOCATION_ID, PROP_IS_EDIT, PROP_IS_ERROR, PROP_IS_REGENERATION, PROP_IS_STREAMING, PROP_LATENCY_MS, PROP_LOCALE, PROP_MAX_OUTPUT_TOKENS, PROP_MESSAGE_ID, PROP_MESSAGE_LABELS, PROP_MESSAGE_LABEL_MAP, PROP_MODEL_NAME, PROP_MODEL_TIER, PROP_OUTPUT_STATE, PROP_OUTPUT_TOKENS, PROP_PARENT_AGENT_ID, PROP_PARENT_MESSAGE_ID, PROP_PARENT_SPAN_ID, PROP_PROMPT_ID, PROP_PROVIDER, PROP_QUALITY_SCORE, PROP_REASONING_CONTENT, PROP_REASONING_TOKENS, PROP_REQUEST_COMPLEXITY, PROP_ROOT_AGENT_NAME, PROP_RUNTIME, PROP_SCORE_NAME, PROP_SCORE_VALUE, PROP_SDK_VERSION, PROP_SENTIMENT_SCORE, PROP_SESSION_ID, PROP_SESSION_REPLAY_ID, PROP_SPAN_ID, PROP_SPAN_KIND, PROP_SPAN_NAME, PROP_SYSTEM_PROMPT, PROP_SYSTEM_PROMPT_LENGTH, PROP_TARGET_ID, PROP_TARGET_TYPE, PROP_TASK_FAILURE_REASON, PROP_TASK_FAILURE_TYPE, PROP_TEMPERATURE, PROP_TOOL_CALLS, PROP_TOOL_INPUT, PROP_TOOL_NAME, PROP_TOOL_OUTPUT, PROP_TOOL_SUCCESS, PROP_TOP_P, PROP_TOTAL_ATTACHMENT_SIZE, PROP_TOTAL_TOKENS, PROP_TRACE_ID, PROP_TTFB_MS, PROP_TURN_ID, PROP_WAS_CACHED, PROP_WAS_COPIED, SDK_RUNTIME, SDK_VERSION, serializeToJsonString, trackAiMessage, trackConversation, trackEmbedding, trackScore, trackSessionEnd, trackSessionEnrichment, trackSpan, trackToolCall, trackUserMessage };
+//# sourceMappingURL=tracking.js.map

package/dist/core/tracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking.js","names":["serialized: string","properties: Record<string, unknown>","event: AmplitudeEvent"],"sources":["../../src/core/tracking.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { ValidationError } from '../exceptions.js';\nimport type {\n  AmplitudeEvent,\n  AmplitudeLike,\n  Attachment,\n  ToolCallShape,\n} from '../types.js';\nimport { getLogger } from '../utils/logger.js';\nimport { inferModelTier } from '../utils/model-tiers.js';\nimport {\n  EVENT_AI_RESPONSE,\n  EVENT_EMBEDDING,\n  EVENT_SCORE,\n  EVENT_SESSION_END,\n  EVENT_SESSION_ENRICHMENT,\n  EVENT_SPAN,\n  EVENT_TOOL_CALL,\n  EVENT_USER_MESSAGE,\n  MAX_SERIALIZED_LENGTH,\n  PROP_ABANDONMENT_TURN,\n  PROP_AGENT_ID,\n  PROP_AGENT_VERSION,\n  PROP_ATTACHMENT_COUNT,\n  PROP_ATTACHMENT_TYPES,\n  PROP_ATTACHMENTS,\n  PROP_CACHE_CREATION_TOKENS,\n  PROP_CACHE_READ_TOKENS,\n  PROP_COMMENT,\n  PROP_COMPONENT_TYPE,\n  PROP_CONTEXT,\n  PROP_COST_USD,\n  PROP_CUSTOMER_ORG_ID,\n  PROP_EDITED_MESSAGE_ID,\n  PROP_EMBEDDING_DIMENSIONS,\n  PROP_ENRICHMENTS,\n  PROP_ENV,\n  PROP_ERROR_MESSAGE,\n  PROP_EVALUATION_SOURCE,\n  PROP_FINISH_REASON,\n  PROP_HAS_ATTACHMENTS,\n  PROP_IDLE_TIMEOUT_MINUTES,\n  PROP_INPUT_STATE,\n  PROP_INPUT_TOKENS,\n  PROP_INVOCATION_ID,\n  PROP_IS_EDIT,\n  PROP_IS_ERROR,\n  PROP_IS_REGENERATION,\n  PROP_IS_STREAMING,\n  PROP_LATENCY_MS,\n  PROP_LOCALE,\n  PROP_MAX_OUTPUT_TOKENS,\n  PROP_MESSAGE_ID,\n  PROP_MESSAGE_LABELS,\n  PROP_MODEL_NAME,\n  PROP_MODEL_TIER,\n  PROP_OUTPUT_STATE,\n  PROP_OUTPUT_TOKENS,\n  PROP_PARENT_AGENT_ID,\n  PROP_PARENT_MESSAGE_ID,\n  PROP_PARENT_SPAN_ID,\n  PROP_PROMPT_ID,\n  PROP_PROVIDER,\n  PROP_REASONING_TOKENS,\n  PROP_RUNTIME,\n  PROP_SCORE_NAME,\n  PROP_SCORE_VALUE,\n  PROP_SDK_VERSION,\n  PROP_SESSION_ID,\n  PROP_SPAN_ID,\n  PROP_SPAN_KIND,\n  PROP_SPAN_NAME,\n  PROP_TARGET_ID,\n  PROP_TARGET_TYPE,\n  PROP_TEMPERATURE,\n  PROP_TOOL_CALLS,\n  PROP_TOOL_INPUT,\n  PROP_TOOL_NAME,\n  PROP_TOOL_OUTPUT,\n  PROP_TOOL_SUCCESS,\n  PROP_TOP_P,\n  PROP_TOTAL_ATTACHMENT_SIZE,\n  PROP_TOTAL_TOKENS,\n  PROP_TRACE_ID,\n  PROP_TTFB_MS,\n  PROP_TURN_ID,\n  PROP_WAS_CACHED,\n  PROP_WAS_COPIED,\n  SDK_RUNTIME,\n  SDK_VERSION,\n} from './constants.js';\nimport type { MessageLabel, SessionEnrichments } from './enrichments.js';\nimport {\n  getTextFromLlmMessage,\n  PrivacyConfig,\n  sanitizeStructuredContent,\n} from './privacy.js';\n\n// Re-export constants and SDK_VERSION for public API\nexport * from './constants.js';\n\nfunction validateRequiredStr(value: unknown, fieldName: string): void {\n  if (typeof value !== 'string' || !value) {\n    throw new ValidationError(\n      `${fieldName} must be a non-empty string, got ${String(value)}`,\n    );\n  }\n}\n\nfunction validateNonNegative(value: unknown, fieldName: string): void {\n  if (typeof value === 'number' && value < 0) {\n    throw new ValidationError(`${fieldName} must be >= 0, got ${value}`);\n  }\n}\n\nfunction validateNumeric(value: unknown, fieldName: string): void {\n  if (typeof value !== 'number') {\n    throw new ValidationError(\n      `${fieldName} must be numeric, got ${typeof value}`,\n    );\n  }\n}\n\nexport function serializeToJsonString(\n  value: unknown,\n  maxLength = MAX_SERIALIZED_LENGTH,\n): string {\n  let serialized: string;\n  try {\n    serialized = JSON.stringify(value);\n  } catch {\n    serialized = String(value);\n  }\n\n  if (serialized.length > maxLength) {\n    const truncateAt = Math.max(0, maxLength - 14);\n    return `${serialized.slice(0, truncateAt)}...[truncated]`;\n  }\n  return serialized;\n}\n\nfunction withSdkManagedProperties(\n  eventProperties: Record<string, unknown> | null | undefined,\n  managedProperties: Record<string, unknown>,\n): Record<string, unknown> {\n  // SDK-managed keys must win over caller-provided eventProperties.\n  return { ...(eventProperties ?? {}), ...managedProperties };\n}\n\n// --------------------------------------------------------\n// track_user_message\n// --------------------------------------------------------\n\nexport interface TrackUserMessageOptions {\n  amplitude: AmplitudeLike;\n  userId: string;\n  messageContent: string;\n  sessionId?: string | null;\n  traceId?: string | null;\n  turnId?: number;\n  messageId?: string | null;\n  conversationId?: string | null;\n  env?: string | null;\n  locale?: string | null;\n  agentId?: string | null;\n  parentAgentId?: string | null;\n  customerOrgId?: string | null;\n  agentVersion?: string | null;\n  context?: Record<string, unknown> | null;\n  isRegeneration?: boolean;\n  isEdit?: boolean;\n  editedMessageId?: string | null;\n  attachments?: Attachment[] | null;\n  labels?: MessageLabel[] | null;\n  eventProperties?: Record<string, unknown> | null;\n  userProperties?: Record<string, unknown> | null;\n  groups?: Record<string, unknown> | null;\n  privacyConfig?: PrivacyConfig | null;\n}\n\nexport function trackUserMessage(opts: TrackUserMessageOptions): string {\n  const pc = opts.privacyConfig ?? new PrivacyConfig();\n  if (pc.validate) {\n    validateRequiredStr(opts.userId, 'userId');\n    validateRequiredStr(opts.sessionId, 'sessionId');\n  }\n\n  const messageId = opts.messageId || randomUUID();\n  const contentData = pc.sanitizeContent(opts.messageContent);\n\n  const properties: Record<string, unknown> = withSdkManagedProperties(\n    opts.eventProperties,\n    {\n      [PROP_TURN_ID]: opts.turnId ?? 1,\n      [PROP_MESSAGE_ID]: messageId,\n      [PROP_COMPONENT_TYPE]: 'user_input',\n      [PROP_SDK_VERSION]: SDK_VERSION,\n      [PROP_RUNTIME]: SDK_RUNTIME,\n    },\n  );\n\n  if (opts.sessionId) properties[PROP_SESSION_ID] = opts.sessionId;\n  if (opts.traceId) properties[PROP_TRACE_ID] = opts.traceId;\n  if (opts.conversationId && !opts.sessionId)\n    properties[PROP_SESSION_ID] = opts.conversationId;\n  if (opts.env) properties[PROP_ENV] = opts.env;\n  if (opts.locale) properties[PROP_LOCALE] = opts.locale;\n  if (opts.agentId) properties[PROP_AGENT_ID] = opts.agentId;\n  if (opts.parentAgentId) properties[PROP_PARENT_AGENT_ID] = opts.parentAgentId;\n  if (opts.customerOrgId) properties[PROP_CUSTOMER_ORG_ID] = opts.customerOrgId;\n  if (opts.agentVersion) properties[PROP_AGENT_VERSION] = opts.agentVersion;\n  if (opts.context)\n    properties[PROP_CONTEXT] = serializeToJsonString(opts.context);\n\n  if (opts.isRegeneration) properties[PROP_IS_REGENERATION] = true;\n  if (opts.isEdit) properties[PROP_IS_EDIT] = true;\n  if (opts.editedMessageId)\n    properties[PROP_EDITED_MESSAGE_ID] = opts.editedMessageId;\n\n  if (opts.attachments?.length) {\n    properties[PROP_HAS_ATTACHMENTS] = true;\n    properties[PROP_ATTACHMENT_COUNT] = opts.attachments.length;\n    const types = [\n      ...new Set(opts.attachments.map((a) => String(a.type ?? 'unknown'))),\n    ];\n    properties[PROP_ATTACHMENT_TYPES] = types;\n    const totalSize = opts.attachments.reduce(\n      (sum, a) => sum + (typeof a.size_bytes === 'number' ? a.size_bytes : 0),\n      0,\n    );\n    if (totalSize > 0) properties[PROP_TOTAL_ATTACHMENT_SIZE] = totalSize;\n    properties[PROP_ATTACHMENTS] = serializeToJsonString(opts.attachments);\n  }\n\n  if (opts.labels?.length) {\n    properties[PROP_MESSAGE_LABELS] = serializeToJsonString(\n      opts.labels.map((lbl) => lbl.toDict()),\n    );\n  }\n\n  Object.assign(properties, contentData);\n\n  const event: AmplitudeEvent = {\n    event_type: EVENT_USER_MESSAGE,\n    user_id: opts.userId,\n    event_properties: properties,\n  };\n  if (opts.userProperties) event.user_properties = opts.userProperties;\n  if (opts.groups) event.groups = opts.groups;\n\n  try {\n    opts.amplitude.track(event);\n    getLogger(opts.amplitude).debug(\n      `Tracked ${EVENT_USER_MESSAGE} for user ${opts.userId}`,\n    );\n  } catch (e) {\n    getLogger(opts.amplitude).error(\n      `Failed to track ${EVENT_USER_MESSAGE}: ${e}`,\n    );\n  }\n\n  return messageId;\n}\n\n// --------------------------------------------------------\n// track_ai_message\n// --------------------------------------------------------\n\nexport interface TrackAiMessageOptions {\n  amplitude: AmplitudeLike;\n  userId: string;\n  modelName: string;\n  provider: string;\n  responseContent: string;\n  latencyMs: number;\n  sessionId?: string | null;\n  traceId?: string | null;\n  turnId?: number;\n  messageId?: string | null;\n  conversationId?: string | null;\n  inputTokens?: number | null;\n  outputTokens?: number | null;\n  totalTokens?: number | null;\n  reasoningTokens?: number | null;\n  cacheReadInputTokens?: number | null;\n  cacheCreationInputTokens?: number | null;\n  totalCostUsd?: number | null;\n  providerTtfbMs?: number | null;\n  isError?: boolean;\n  errorMessage?: string | null;\n  finishReason?: string | null;\n  toolCalls?: Array<ToolCallShape | Record<string, unknown>> | null;\n  reasoningContent?: string | null;\n  systemPrompt?: string | null;\n  temperature?: number | null;\n  maxOutputTokens?: number | null;\n  topP?: number | null;\n  isStreaming?: boolean | null;\n  promptId?: string | null;\n  wasCopied?: boolean;\n  wasCached?: boolean;\n  modelTier?: string | null;\n  attachments?: Attachment[] | null;\n  labels?: MessageLabel[] | null;\n  env?: string | null;\n  locale?: string | null;\n  agentId?: string | null;\n  parentAgentId?: string | null;\n  customerOrgId?: string | null;\n  agentVersion?: string | null;\n  context?: Record<string, unknown> | null;\n  spanKind?: string | null;\n  eventProperties?: Record<string, unknown> | null;\n  userProperties?: Record<string, unknown> | null;\n  groups?: Record<string, unknown> | null;\n  privacyConfig?: PrivacyConfig | null;\n}\n\nexport function trackAiMessage(opts: TrackAiMessageOptions): string {\n  const pc = opts.privacyConfig ?? new PrivacyConfig();\n  if (pc.validate) {\n    validateRequiredStr(opts.userId, 'userId');\n    validateRequiredStr(opts.modelName, 'model');\n    validateNonNegative(opts.latencyMs, 'latencyMs');\n  }\n\n  const messageId = opts.messageId || randomUUID();\n  const contentData = pc.sanitizeContent(opts.responseContent);\n\n  const properties: Record<string, unknown> = withSdkManagedProperties(\n    opts.eventProperties,\n    {\n      [PROP_TURN_ID]: opts.turnId ?? 2,\n      [PROP_MESSAGE_ID]: messageId,\n      [PROP_MODEL_NAME]: opts.modelName,\n      [PROP_PROVIDER]: opts.provider,\n      [PROP_LATENCY_MS]: opts.latencyMs,\n      [PROP_IS_ERROR]: opts.isError ?? false,\n      [PROP_COMPONENT_TYPE]: 'llm',\n      [PROP_SDK_VERSION]: SDK_VERSION,\n      [PROP_RUNTIME]: SDK_RUNTIME,\n    },\n  );\n\n  if (opts.sessionId) properties[PROP_SESSION_ID] = opts.sessionId;\n  if (opts.traceId) properties[PROP_TRACE_ID] = opts.traceId;\n  if (opts.conversationId && !opts.sessionId)\n    properties[PROP_SESSION_ID] = opts.conversationId;\n  if (opts.env) properties[PROP_ENV] = opts.env;\n  if (opts.locale) properties[PROP_LOCALE] = opts.locale;\n  if (opts.agentId) properties[PROP_AGENT_ID] = opts.agentId;\n  if (opts.parentAgentId) properties[PROP_PARENT_AGENT_ID] = opts.parentAgentId;\n  if (opts.customerOrgId) properties[PROP_CUSTOMER_ORG_ID] = opts.customerOrgId;\n  if (opts.agentVersion) properties[PROP_AGENT_VERSION] = opts.agentVersion;\n  if (opts.context)\n    properties[PROP_CONTEXT] = serializeToJsonString(opts.context);\n  if (opts.spanKind) properties[PROP_SPAN_KIND] = opts.spanKind;\n\n  if (opts.wasCopied) properties[PROP_WAS_COPIED] = true;\n  if (opts.wasCached) properties[PROP_WAS_CACHED] = true;\n\n  // Model tier (user override or auto-inferred)\n  if (opts.modelTier != null) {\n    properties[PROP_MODEL_TIER] = opts.modelTier;\n  } else {\n    properties[PROP_MODEL_TIER] = inferModelTier(opts.modelName);\n  }\n\n  Object.assign(properties, contentData);\n\n  // Token usage\n  if (opts.inputTokens != null)\n    properties[PROP_INPUT_TOKENS] = opts.inputTokens;\n  if (opts.outputTokens != null)\n    properties[PROP_OUTPUT_TOKENS] = opts.outputTokens;\n  if (opts.totalTokens != null)\n    properties[PROP_TOTAL_TOKENS] = opts.totalTokens;\n  if (opts.reasoningTokens != null)\n    properties[PROP_REASONING_TOKENS] = opts.reasoningTokens;\n  if (opts.cacheReadInputTokens != null)\n    properties[PROP_CACHE_READ_TOKENS] = opts.cacheReadInputTokens;\n  if (opts.cacheCreationInputTokens != null)\n    properties[PROP_CACHE_CREATION_TOKENS] = opts.cacheCreationInputTokens;\n\n  if (opts.totalCostUsd != null) properties[PROP_COST_USD] = opts.totalCostUsd;\n  if (opts.providerTtfbMs != null)\n    properties[PROP_TTFB_MS] = opts.providerTtfbMs;\n  if (opts.finishReason != null)\n    properties[PROP_FINISH_REASON] = opts.finishReason;\n  if (opts.errorMessage != null)\n    properties[PROP_ERROR_MESSAGE] = opts.errorMessage;\n  if (opts.toolCalls != null)\n    properties[PROP_TOOL_CALLS] = serializeToJsonString(opts.toolCalls);\n\n  // Reasoning content\n  const reasoningProps = pc.sanitizeReasoningContent(\n    opts.reasoningContent ?? null,\n    opts.reasoningTokens,\n  );\n  Object.assign(properties, reasoningProps);\n\n  // System prompt\n  const systemPromptProps = pc.sanitizeSystemPrompt(opts.systemPrompt ?? null);\n  Object.assign(properties, systemPromptProps);\n\n  if (opts.temperature != null) properties[PROP_TEMPERATURE] = opts.temperature;\n  if (opts.maxOutputTokens != null)\n    properties[PROP_MAX_OUTPUT_TOKENS] = opts.maxOutputTokens;\n  if (opts.topP != null) properties[PROP_TOP_P] = opts.topP;\n  if (opts.isStreaming != null)\n    properties[PROP_IS_STREAMING] = opts.isStreaming;\n  if (opts.promptId != null) properties[PROP_PROMPT_ID] = opts.promptId;\n\n  if (opts.attachments?.length) {\n    properties[PROP_HAS_ATTACHMENTS] = true;\n    properties[PROP_ATTACHMENT_COUNT] = opts.attachments.length;\n    const types = [\n      ...new Set(opts.attachments.map((a) => String(a.type ?? 'unknown'))),\n    ];\n    properties[PROP_ATTACHMENT_TYPES] = types;\n    const totalSize = opts.attachments.reduce(\n      (sum, a) => sum + (typeof a.size_bytes === 'number' ? a.size_bytes : 0),\n      0,\n    );\n    if (totalSize > 0) properties[PROP_TOTAL_ATTACHMENT_SIZE] = totalSize;\n    properties[PROP_ATTACHMENTS] = serializeToJsonString(opts.attachments);\n  }\n\n  if (opts.labels?.length) {\n    properties[PROP_MESSAGE_LABELS] = serializeToJsonString(\n      opts.labels.map((lbl) => lbl.toDict()),\n    );\n  }\n\n  const event: AmplitudeEvent = {\n    event_type: EVENT_AI_RESPONSE,\n    user_id: opts.userId,\n    event_properties: properties,\n  };\n  if (opts.userProperties) event.user_properties = opts.userProperties;\n  if (opts.groups) event.groups = opts.groups;\n\n  try {\n    opts.amplitude.track(event);\n    getLogger(opts.amplitude).debug(\n      `Tracked ${EVENT_AI_RESPONSE} for user ${opts.userId}`,\n    );\n  } catch (e) {\n    getLogger(opts.amplitude).error(\n      `Failed to track ${EVENT_AI_RESPONSE}: ${e}`,\n    );\n  }\n\n  return messageId;\n}\n\n// --------------------------------------------------------\n// track_tool_call\n// --------------------------------------------------------\n\nexport interface TrackToolCallOptions {\n  amplitude: AmplitudeLike;\n  userId: string;\n  toolName: string;\n  success: boolean;\n  latencyMs: number;\n  sessionId?: string | null;\n  traceId?: string | null;\n  turnId?: number;\n  toolInput?: unknown;\n  toolOutput?: unknown;\n  invocationId?: string | null;\n  conversationId?: string | null;\n  parentMessageId?: string | null;\n  agentId?: string | null;\n  parentAgentId?: string | null;\n  customerOrgId?: string | null;\n  agentVersion?: string | null;\n  context?: Record<string, unknown> | null;\n  errorMessage?: string | null;\n  env?: string | null;\n  locale?: string | null;\n  spanKind?: string | null;\n  eventProperties?: Record<string, unknown> | null;\n  userProperties?: Record<string, unknown> | null;\n  groups?: Record<string, unknown> | null;\n  privacyConfig?: PrivacyConfig | null;\n}\n\nexport function trackToolCall(opts: TrackToolCallOptions): string {\n  const pc = opts.privacyConfig ?? new PrivacyConfig();\n  if (pc.validate) {\n    validateRequiredStr(opts.userId, 'userId');\n    validateRequiredStr(opts.toolName, 'toolName');\n    validateNonNegative(opts.latencyMs, 'latencyMs');\n  }\n\n  const invocationId = opts.invocationId || randomUUID();\n\n  const properties: Record<string, unknown> = withSdkManagedProperties(\n    opts.eventProperties,\n    {\n      [PROP_TURN_ID]: opts.turnId ?? 1,\n      [PROP_INVOCATION_ID]: invocationId,\n      [PROP_TOOL_NAME]: opts.toolName,\n      [PROP_TOOL_SUCCESS]: opts.success,\n      [PROP_IS_ERROR]: !opts.success,\n      [PROP_LATENCY_MS]: opts.latencyMs,\n      [PROP_COMPONENT_TYPE]: 'tool',\n      [PROP_SDK_VERSION]: SDK_VERSION,\n      [PROP_RUNTIME]: SDK_RUNTIME,\n    },\n  );\n\n  if (opts.sessionId) properties[PROP_SESSION_ID] = opts.sessionId;\n  if (opts.traceId) properties[PROP_TRACE_ID] = opts.traceId;\n  if (opts.conversationId && !opts.sessionId)\n    properties[PROP_SESSION_ID] = opts.conversationId;\n  if (opts.parentMessageId)\n    properties[PROP_PARENT_MESSAGE_ID] = opts.parentMessageId;\n  if (opts.agentId) properties[PROP_AGENT_ID] = opts.agentId;\n  if (opts.parentAgentId) properties[PROP_PARENT_AGENT_ID] = opts.parentAgentId;\n  if (opts.customerOrgId) properties[PROP_CUSTOMER_ORG_ID] = opts.customerOrgId;\n  if (opts.agentVersion) properties[PROP_AGENT_VERSION] = opts.agentVersion;\n  if (opts.context)\n    properties[PROP_CONTEXT] = serializeToJsonString(opts.context);\n  if (opts.errorMessage) properties[PROP_ERROR_MESSAGE] = opts.errorMessage;\n  if (opts.env) properties[PROP_ENV] = opts.env;\n  if (opts.locale) properties[PROP_LOCALE] = opts.locale;\n  if (opts.spanKind) properties[PROP_SPAN_KIND] = opts.spanKind;\n\n  let effectiveMode = pc.contentMode;\n  if (effectiveMode == null)\n    effectiveMode = pc.privacyMode ? 'metadata_only' : 'full';\n\n  if (opts.toolInput != null && effectiveMode === 'full') {\n    const sanitized = sanitizeStructuredContent(opts.toolInput, pc.redactPii);\n    properties[PROP_TOOL_INPUT] = serializeToJsonString(sanitized);\n  }\n\n  if (opts.toolOutput != null && effectiveMode === 'full') {\n    const sanitized = sanitizeStructuredContent(opts.toolOutput, pc.redactPii);\n    properties[PROP_TOOL_OUTPUT] = serializeToJsonString(sanitized);\n  }\n\n  const event: AmplitudeEvent = {\n    event_type: EVENT_TOOL_CALL,\n    user_id: opts.userId,\n    event_properties: properties,\n  };\n  if (opts.userProperties) event.user_properties = opts.userProperties;\n  if (opts.groups) event.groups = opts.groups;\n\n  try {\n    opts.amplitude.track(event);\n    getLogger(opts.amplitude).debug(\n      `Tracked ${EVENT_TOOL_CALL} for user ${opts.userId}`,\n    );\n  } catch (e) {\n    getLogger(opts.amplitude).error(`Failed to track ${EVENT_TOOL_CALL}: ${e}`);\n  }\n\n  return invocationId;\n}\n\n// --------------------------------------------------------\n// track_conversation\n// --------------------------------------------------------\n\nexport interface TrackConversationOptions {\n  amplitude: AmplitudeLike;\n  userId: string;\n  messages: Array<Record<string, unknown>>;\n  sessionId?: string | null;\n  conversationId?: string | null;\n  agentId?: string | null;\n  parentAgentId?: string | null;\n  customerOrgId?: string | null;\n  agentVersion?: string | null;\n  context?: Record<string, unknown> | null;\n  env?: string | null;\n  eventProperties?: Record<string, unknown> | null;\n  userProperties?: Record<string, unknown> | null;\n  groups?: Record<string, unknown> | null;\n  privacyConfig?: PrivacyConfig | null;\n}\n\nexport function trackConversation(opts: TrackConversationOptions): void {\n  const effectiveSessionId =\n    opts.sessionId ?? opts.conversationId ?? randomUUID();\n  let turnId = 1;\n\n  for (const message of opts.messages) {\n    const role = String(message.role ?? '');\n    const content = String(message.content ?? '');\n\n    if (role === 'user') {\n      trackUserMessage({\n        amplitude: opts.amplitude,\n        userId: opts.userId,\n        messageContent: content,\n        sessionId: effectiveSessionId,\n        turnId,\n        agentId: opts.agentId,\n        parentAgentId: opts.parentAgentId,\n        customerOrgId: opts.customerOrgId,\n        agentVersion: opts.agentVersion,\n        context: opts.context,\n        env: opts.env,\n        eventProperties: opts.eventProperties,\n        userProperties: opts.userProperties,\n        groups: opts.groups,\n        privacyConfig: opts.privacyConfig,\n      });\n    } else if (role === 'assistant' || role === 'ai') {\n      trackAiMessage({\n        amplitude: opts.amplitude,\n        userId: opts.userId,\n        modelName: String(message.model ?? 'unknown'),\n        provider: String(message.provider ?? 'unknown'),\n        responseContent: content,\n        latencyMs: Number(message.latency_ms ?? 0),\n        sessionId: effectiveSessionId,\n        turnId,\n        inputTokens: message.input_tokens as number | undefined,\n        outputTokens: message.output_tokens as number | undefined,\n        totalTokens: message.total_tokens as number | undefined,\n        totalCostUsd: message.total_cost_usd as number | undefined,\n        agentId: opts.agentId,\n        parentAgentId: opts.parentAgentId,\n        customerOrgId: opts.customerOrgId,\n        agentVersion: opts.agentVersion,\n        context: opts.context,\n        env: opts.env,\n        eventProperties: opts.eventProperties,\n        userProperties: opts.userProperties,\n        groups: opts.groups,\n        privacyConfig: opts.privacyConfig,\n      });\n    }\n\n    turnId++;\n  }\n}\n\n// --------------------------------------------------------\n// track_embedding\n// --------------------------------------------------------\n\nexport interface TrackEmbeddingOptions {\n  amplitude: AmplitudeLike;\n  userId: string;\n  model: string;\n  provider: string;\n  latencyMs: number;\n  inputTokens?: number | null;\n  dimensions?: number | null;\n  totalCostUsd?: number | null;\n  sessionId?: string | null;\n  traceId?: string | null;\n  turnId?: number | null;\n  agentId?: string | null;\n  parentAgentId?: string | null;\n  customerOrgId?: string | null;\n  agentVersion?: string | null;\n  context?: Record<string, unknown> | null;\n  env?: string | null;\n  eventProperties?: Record<string, unknown> | null;\n  groups?: Record<string, unknown> | null;\n  privacyConfig?: PrivacyConfig | null;\n}\n\nexport function trackEmbedding(opts: TrackEmbeddingOptions): string {\n  const pc = opts.privacyConfig ?? new PrivacyConfig();\n  if (pc.validate) {\n    validateRequiredStr(opts.userId, 'userId');\n    validateNonNegative(opts.latencyMs, 'latencyMs');\n  }\n\n  const spanId = randomUUID();\n\n  const properties: Record<string, unknown> = withSdkManagedProperties(\n    opts.eventProperties,\n    {\n      [PROP_SPAN_ID]: spanId,\n      [PROP_MODEL_NAME]: opts.model,\n      [PROP_PROVIDER]: opts.provider,\n      [PROP_LATENCY_MS]: opts.latencyMs,\n      [PROP_COMPONENT_TYPE]: 'embedding',\n      [PROP_SDK_VERSION]: SDK_VERSION,\n      [PROP_RUNTIME]: SDK_RUNTIME,\n    },\n  );\n\n  if (opts.sessionId) properties[PROP_SESSION_ID] = opts.sessionId;\n  if (opts.traceId != null) properties[PROP_TRACE_ID] = opts.traceId;\n  if (opts.turnId != null) properties[PROP_TURN_ID] = opts.turnId;\n  if (opts.inputTokens != null)\n    properties[PROP_INPUT_TOKENS] = opts.inputTokens;\n  if (opts.dimensions != null)\n    properties[PROP_EMBEDDING_DIMENSIONS] = opts.dimensions;\n  if (opts.totalCostUsd != null) properties[PROP_COST_USD] = opts.totalCostUsd;\n  if (opts.agentId) properties[PROP_AGENT_ID] = opts.agentId;\n  if (opts.parentAgentId) properties[PROP_PARENT_AGENT_ID] = opts.parentAgentId;\n  if (opts.customerOrgId) properties[PROP_CUSTOMER_ORG_ID] = opts.customerOrgId;\n  if (opts.agentVersion) properties[PROP_AGENT_VERSION] = opts.agentVersion;\n  if (opts.context)\n    properties[PROP_CONTEXT] = serializeToJsonString(opts.context);\n  if (opts.env) properties[PROP_ENV] = opts.env;\n\n  const event: AmplitudeEvent = {\n    event_type: EVENT_EMBEDDING,\n    user_id: opts.userId,\n    event_properties: properties,\n  };\n  if (opts.groups) event.groups = opts.groups;\n\n  try {\n    opts.amplitude.track(event);\n    getLogger(opts.amplitude).debug(\n      `Tracked ${EVENT_EMBEDDING} for user ${opts.userId}`,\n    );\n  } catch (e) {\n    getLogger(opts.amplitude).error(`Failed to track ${EVENT_EMBEDDING}: ${e}`);\n  }\n\n  return spanId;\n}\n\n// --------------------------------------------------------\n// track_span\n// --------------------------------------------------------\n\nexport interface TrackSpanOptions {\n  amplitude: AmplitudeLike;\n  userId: string;\n  spanName: string;\n  traceId: string;\n  latencyMs: number;\n  inputState?: Record<string, unknown> | null;\n  outputState?: Record<string, unknown> | null;\n  parentSpanId?: string | null;\n  isError?: boolean;\n  errorMessage?: string | null;\n  sessionId?: string | null;\n  turnId?: number | null;\n  agentId?: string | null;\n  parentAgentId?: string | null;\n  customerOrgId?: string | null;\n  agentVersion?: string | null;\n  context?: Record<string, unknown> | null;\n  env?: string | null;\n  eventProperties?: Record<string, unknown> | null;\n  groups?: Record<string, unknown> | null;\n  privacyConfig?: PrivacyConfig | null;\n}\n\nexport function trackSpan(opts: TrackSpanOptions): string {\n  const pc = opts.privacyConfig ?? new PrivacyConfig();\n  if (pc.validate) {\n    validateRequiredStr(opts.userId, 'userId');\n    validateNonNegative(opts.latencyMs, 'latencyMs');\n  }\n\n  const spanId = randomUUID();\n\n  const properties: Record<string, unknown> = withSdkManagedProperties(\n    opts.eventProperties,\n    {\n      [PROP_SPAN_ID]: spanId,\n      [PROP_SPAN_NAME]: opts.spanName,\n      [PROP_TRACE_ID]: opts.traceId,\n      [PROP_LATENCY_MS]: opts.latencyMs,\n      [PROP_IS_ERROR]: opts.isError ?? false,\n      [PROP_SDK_VERSION]: SDK_VERSION,\n      [PROP_RUNTIME]: SDK_RUNTIME,\n    },\n  );\n\n  if (opts.sessionId) properties[PROP_SESSION_ID] = opts.sessionId;\n  if (opts.turnId != null) properties[PROP_TURN_ID] = opts.turnId;\n  if (opts.parentSpanId) properties[PROP_PARENT_SPAN_ID] = opts.parentSpanId;\n  if (opts.errorMessage) properties[PROP_ERROR_MESSAGE] = opts.errorMessage;\n  if (opts.agentId) properties[PROP_AGENT_ID] = opts.agentId;\n  if (opts.parentAgentId) properties[PROP_PARENT_AGENT_ID] = opts.parentAgentId;\n  if (opts.customerOrgId) properties[PROP_CUSTOMER_ORG_ID] = opts.customerOrgId;\n  if (opts.agentVersion) properties[PROP_AGENT_VERSION] = opts.agentVersion;\n  if (opts.context)\n    properties[PROP_CONTEXT] = serializeToJsonString(opts.context);\n  if (opts.env) properties[PROP_ENV] = opts.env;\n\n  let effectiveMode = pc.contentMode;\n  if (effectiveMode == null)\n    effectiveMode = pc.privacyMode ? 'metadata_only' : 'full';\n\n  if (opts.inputState != null && effectiveMode === 'full') {\n    const sanitized = sanitizeStructuredContent(opts.inputState, pc.redactPii);\n    properties[PROP_INPUT_STATE] = serializeToJsonString(sanitized);\n  }\n\n  if (opts.outputState != null && effectiveMode === 'full') {\n    const sanitized = sanitizeStructuredContent(opts.outputState, pc.redactPii);\n    properties[PROP_OUTPUT_STATE] = serializeToJsonString(sanitized);\n  }\n\n  const event: AmplitudeEvent = {\n    event_type: EVENT_SPAN,\n    user_id: opts.userId,\n    event_properties: properties,\n  };\n  if (opts.groups) event.groups = opts.groups;\n\n  try {\n    opts.amplitude.track(event);\n    getLogger(opts.amplitude).debug(\n      `Tracked ${EVENT_SPAN} for user ${opts.userId}`,\n    );\n  } catch (e) {\n    getLogger(opts.amplitude).error(`Failed to track ${EVENT_SPAN}: ${e}`);\n  }\n\n  return spanId;\n}\n\n// --------------------------------------------------------\n// track_session_end\n// --------------------------------------------------------\n\nexport interface TrackSessionEndOptions {\n  amplitude: AmplitudeLike;\n  userId: string;\n  sessionId: string;\n  enrichments?: SessionEnrichments | null;\n  traceId?: string | null;\n  turnId?: number | null;\n  agentId?: string | null;\n  parentAgentId?: string | null;\n  customerOrgId?: string | null;\n  agentVersion?: string | null;\n  context?: Record<string, unknown> | null;\n  env?: string | null;\n  abandonmentTurn?: number | null;\n  idleTimeoutMinutes?: number | null;\n  eventProperties?: Record<string, unknown> | null;\n  groups?: Record<string, unknown> | null;\n  privacyConfig?: PrivacyConfig | null;\n}\n\nexport function trackSessionEnd(opts: TrackSessionEndOptions): void {\n  const pc = opts.privacyConfig ?? new PrivacyConfig();\n  if (pc.validate) {\n    validateRequiredStr(opts.userId, 'userId');\n    validateRequiredStr(opts.sessionId, 'sessionId');\n  }\n\n  const properties: Record<string, unknown> = withSdkManagedProperties(\n    opts.eventProperties,\n    {\n      [PROP_SESSION_ID]: opts.sessionId,\n      [PROP_SDK_VERSION]: SDK_VERSION,\n      [PROP_RUNTIME]: SDK_RUNTIME,\n    },\n  );\n\n  if (opts.traceId != null) properties[PROP_TRACE_ID] = opts.traceId;\n  if (opts.turnId != null) properties[PROP_TURN_ID] = opts.turnId;\n  if (opts.agentId) properties[PROP_AGENT_ID] = opts.agentId;\n  if (opts.parentAgentId) properties[PROP_PARENT_AGENT_ID] = opts.parentAgentId;\n  if (opts.customerOrgId) properties[PROP_CUSTOMER_ORG_ID] = opts.customerOrgId;\n  if (opts.agentVersion) properties[PROP_AGENT_VERSION] = opts.agentVersion;\n  if (opts.context)\n    properties[PROP_CONTEXT] = serializeToJsonString(opts.context);\n  if (opts.env) properties[PROP_ENV] = opts.env;\n  if (opts.abandonmentTurn != null)\n    properties[PROP_ABANDONMENT_TURN] = opts.abandonmentTurn;\n  if (opts.idleTimeoutMinutes != null)\n    properties[PROP_IDLE_TIMEOUT_MINUTES] = opts.idleTimeoutMinutes;\n\n  if (opts.enrichments != null) {\n    const enrichmentDict =\n      typeof opts.enrichments.toDict === 'function'\n        ? opts.enrichments.toDict()\n        : opts.enrichments;\n    properties[PROP_ENRICHMENTS] = serializeToJsonString(enrichmentDict);\n  }\n\n  const event: AmplitudeEvent = {\n    event_type: EVENT_SESSION_END,\n    user_id: opts.userId,\n    event_properties: properties,\n  };\n  if (opts.groups) event.groups = opts.groups;\n\n  try {\n    opts.amplitude.track(event);\n    getLogger(opts.amplitude).debug(\n      `Tracked ${EVENT_SESSION_END} for user ${opts.userId}`,\n    );\n  } catch (e) {\n    getLogger(opts.amplitude).error(\n      `Failed to track ${EVENT_SESSION_END}: ${e}`,\n    );\n  }\n}\n\n// --------------------------------------------------------\n// track_session_enrichment\n// --------------------------------------------------------\n\nexport interface TrackSessionEnrichmentOptions {\n  amplitude: AmplitudeLike;\n  userId: string;\n  sessionId: string;\n  enrichments: SessionEnrichments;\n  traceId?: string | null;\n  turnId?: number | null;\n  agentId?: string | null;\n  parentAgentId?: string | null;\n  customerOrgId?: string | null;\n  agentVersion?: string | null;\n  context?: Record<string, unknown> | null;\n  env?: string | null;\n  eventProperties?: Record<string, unknown> | null;\n  groups?: Record<string, unknown> | null;\n  privacyConfig?: PrivacyConfig | null;\n}\n\nexport function trackSessionEnrichment(\n  opts: TrackSessionEnrichmentOptions,\n): void {\n  const pc = opts.privacyConfig ?? new PrivacyConfig();\n  if (pc.validate) {\n    validateRequiredStr(opts.userId, 'userId');\n    validateRequiredStr(opts.sessionId, 'sessionId');\n  }\n\n  const properties: Record<string, unknown> = withSdkManagedProperties(\n    opts.eventProperties,\n    {\n      [PROP_SESSION_ID]: opts.sessionId,\n      [PROP_SDK_VERSION]: SDK_VERSION,\n      [PROP_RUNTIME]: SDK_RUNTIME,\n    },\n  );\n\n  if (opts.traceId != null) properties[PROP_TRACE_ID] = opts.traceId;\n  if (opts.turnId != null) properties[PROP_TURN_ID] = opts.turnId;\n  if (opts.agentId) properties[PROP_AGENT_ID] = opts.agentId;\n  if (opts.parentAgentId) properties[PROP_PARENT_AGENT_ID] = opts.parentAgentId;\n  if (opts.customerOrgId) properties[PROP_CUSTOMER_ORG_ID] = opts.customerOrgId;\n  if (opts.agentVersion) properties[PROP_AGENT_VERSION] = opts.agentVersion;\n  if (opts.context)\n    properties[PROP_CONTEXT] = serializeToJsonString(opts.context);\n  if (opts.env) properties[PROP_ENV] = opts.env;\n\n  const enrichmentDict =\n    typeof opts.enrichments.toDict === 'function'\n      ? opts.enrichments.toDict()\n      : opts.enrichments;\n  properties[PROP_ENRICHMENTS] = serializeToJsonString(enrichmentDict);\n\n  const event: AmplitudeEvent = {\n    event_type: EVENT_SESSION_ENRICHMENT,\n    user_id: opts.userId,\n    event_properties: properties,\n  };\n  if (opts.groups) event.groups = opts.groups;\n\n  try {\n    opts.amplitude.track(event);\n    getLogger(opts.amplitude).debug(\n      `Tracked ${EVENT_SESSION_ENRICHMENT} for user ${opts.userId}`,\n    );\n  } catch (e) {\n    getLogger(opts.amplitude).error(\n      `Failed to track ${EVENT_SESSION_ENRICHMENT}: ${e}`,\n    );\n  }\n}\n\n// --------------------------------------------------------\n// track_score\n// --------------------------------------------------------\n\nexport interface TrackScoreOptions {\n  amplitude: AmplitudeLike;\n  userId: string;\n  name: string;\n  value: number;\n  targetId: string;\n  targetType?: string;\n  source?: string;\n  comment?: string | null;\n  sessionId?: string | null;\n  traceId?: string | null;\n  turnId?: number | null;\n  agentId?: string | null;\n  parentAgentId?: string | null;\n  customerOrgId?: string | null;\n  agentVersion?: string | null;\n  context?: Record<string, unknown> | null;\n  env?: string | null;\n  eventProperties?: Record<string, unknown> | null;\n  groups?: Record<string, unknown> | null;\n  privacyConfig?: PrivacyConfig | null;\n}\n\nexport function trackScore(opts: TrackScoreOptions): void {\n  const pc = opts.privacyConfig ?? new PrivacyConfig();\n  if (pc.validate) {\n    validateRequiredStr(opts.userId, 'userId');\n    validateNumeric(opts.value, 'value');\n  }\n\n  const properties: Record<string, unknown> = withSdkManagedProperties(\n    opts.eventProperties,\n    {\n      [PROP_SCORE_NAME]: opts.name,\n      [PROP_SCORE_VALUE]: opts.value,\n      [PROP_TARGET_ID]: opts.targetId,\n      [PROP_TARGET_TYPE]: opts.targetType ?? 'message',\n      [PROP_EVALUATION_SOURCE]: opts.source ?? 'user',\n      [PROP_SDK_VERSION]: SDK_VERSION,\n      [PROP_RUNTIME]: SDK_RUNTIME,\n    },\n  );\n\n  if (opts.sessionId) properties[PROP_SESSION_ID] = opts.sessionId;\n  if (opts.traceId != null) properties[PROP_TRACE_ID] = opts.traceId;\n  if (opts.turnId != null) properties[PROP_TURN_ID] = opts.turnId;\n  if (opts.agentId) properties[PROP_AGENT_ID] = opts.agentId;\n  if (opts.parentAgentId) properties[PROP_PARENT_AGENT_ID] = opts.parentAgentId;\n  if (opts.customerOrgId) properties[PROP_CUSTOMER_ORG_ID] = opts.customerOrgId;\n  if (opts.agentVersion) properties[PROP_AGENT_VERSION] = opts.agentVersion;\n  if (opts.context)\n    properties[PROP_CONTEXT] = serializeToJsonString(opts.context);\n  if (opts.env) properties[PROP_ENV] = opts.env;\n\n  // Comment respects content_mode\n  if (opts.comment != null) {\n    const commentData = pc.sanitizeContent(opts.comment);\n    if ('$llm_message' in commentData) {\n      const msg = commentData.$llm_message as Record<string, unknown>;\n      properties[PROP_COMMENT] = getTextFromLlmMessage(msg);\n    }\n  }\n\n  const event: AmplitudeEvent = {\n    event_type: EVENT_SCORE,\n    user_id: opts.userId,\n    event_properties: properties,\n  };\n  if (opts.groups) event.groups = opts.groups;\n\n  try {\n    opts.amplitude.track(event);\n    getLogger(opts.amplitude).debug(\n      `Tracked ${EVENT_SCORE} for user ${opts.userId}`,\n    );\n  } catch (e) {\n    getLogger(opts.amplitude).error(`Failed to track ${EVENT_SCORE}: ${e}`);\n  }\n}\n"],"mappings":"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"}