@amaster.ai/pi-telemetry 0.1.0-beta.0 → 0.1.2-beta.0

package/dist/langfuse.js

@@ -1,7 +1,7 @@
-import { createHash, randomUUID } from "node:crypto";
-import { Langfuse } from "langfuse";
-import { NoopRuntimeEventExporter, } from "./index.js";
-const DEFAULT_LANGFUSE_BASE_URL = "https://cloud.langfuse.com";
+import { createHash, randomUUID } from 'node:crypto';
+import { Langfuse } from 'langfuse';
+import { NoopRuntimeEventExporter, } from './index.js';
+const DEFAULT_LANGFUSE_BASE_URL = 'https://cloud.langfuse.com';
 const DEFAULT_FLUSH_AT = 20;
 const DEFAULT_FLUSH_INTERVAL_MS = 5000;
 export class LangfuseSdkRuntimeEventExporter {
@@ -50,20 +50,20 @@ export class LangfuseSdkRuntimeEventExporter {
         const rootKey = chatSpanKey(event);
         const rootSpanId = langfuseSpanId(traceId, rootKey);
         switch (event.type) {
-            case "chat_turn_started": {
+            case 'chat_turn_started': {
                 const body = {
                     id: rootSpanId,
-                    name: "copilot-chat-turn",
+                    name: 'copilot-chat-turn',
                     startTime: event.createdAt,
                     input: event.details?.input,
-                    level: "DEFAULT",
+                    level: 'DEFAULT',
                     metadata: lifecycleMetadata(event),
                 };
                 const span = this.spans.get(rootKey);
                 if (span) {
                     span.update({
                         input: event.details?.input,
-                        level: "DEFAULT",
+                        level: 'DEFAULT',
                         metadata: lifecycleMetadata(event),
                     });
                 }
@@ -72,37 +72,37 @@ export class LangfuseSdkRuntimeEventExporter {
                 }
                 break;
             }
-            case "chat_turn_completed":
-            case "chat_turn_failed": {
+            case 'chat_turn_completed':
+            case 'chat_turn_failed': {
                 const output = event.details?.output ?? (event.error ? { error: event.error } : undefined);
                 this.closeSdkSubagentBatchSpans(traceId, event);
                 trace.update({
                     sessionId: event.sessionId,
-                    name: "copilot-chat-turn",
+                    name: 'copilot-chat-turn',
                     output,
                     metadata: lifecycleMetadata(event),
                 });
                 const span = this.spans.get(rootKey) ??
                     trace.span({
                         id: rootSpanId,
-                        name: "copilot-chat-turn",
+                        name: 'copilot-chat-turn',
                         startTime: event.createdAt,
                         metadata: lifecycleMetadata(event),
                     });
                 span.update({
                     output,
                     endTime: event.createdAt,
-                    level: event.error ? "ERROR" : "DEFAULT",
+                    level: event.error ? 'ERROR' : 'DEFAULT',
                     ...(event.error ? { statusMessage: event.error } : {}),
                     metadata: lifecycleMetadata(event),
                 });
                 this.spans.delete(rootKey);
                 break;
             }
-            case "chat_turn_steered":
-            case "chat_turn_steer_delivered":
-            case "chat_turn_followup_queued":
-            case "chat_turn_followup_delivered": {
+            case 'chat_turn_steered':
+            case 'chat_turn_steer_delivered':
+            case 'chat_turn_followup_queued':
+            case 'chat_turn_followup_delivered': {
                 const output = event.details?.output ?? chatInputLifecycleOutput(event);
                 this.getSdkSpanParent(trace, rootKey).span({
                     id: langfuseSpanId(traceId, chatInputSpanKey(event)),
@@ -111,28 +111,28 @@ export class LangfuseSdkRuntimeEventExporter {
                     endTime: event.createdAt,
                     input: event.details?.input,
                     output,
-                    level: "DEFAULT",
+                    level: 'DEFAULT',
                     metadata: lifecycleMetadata(event),
                 });
                 break;
             }
-            case "subagent_spawned":
-            case "subagent_started": {
+            case 'subagent_spawned':
+            case 'subagent_started': {
                 const key = subagentSpanKey(event);
                 const rootSpan = this.ensureSdkRootSpan(trace, rootKey, event);
                 const body = {
                     id: langfuseSpanId(traceId, key),
-                    name: "subagent",
+                    name: 'subagent',
                     startTime: event.createdAt,
                     input: event.details?.input,
-                    level: "DEFAULT",
+                    level: 'DEFAULT',
                     metadata: lifecycleMetadata(event),
                 };
                 const span = this.spans.get(key);
                 if (span) {
                     span.update({
                         input: event.details?.input,
-                        level: "DEFAULT",
+                        level: 'DEFAULT',
                         metadata: lifecycleMetadata(event),
                     });
                 }
@@ -141,23 +141,23 @@ export class LangfuseSdkRuntimeEventExporter {
                 }
                 break;
             }
-            case "subagent_completed":
-            case "subagent_failed":
-            case "subagent_cancelled": {
+            case 'subagent_completed':
+            case 'subagent_failed':
+            case 'subagent_cancelled': {
                 const key = subagentSpanKey(event);
                 const output = event.details?.output ?? (event.error ? { error: event.error } : undefined);
                 const rootSpan = this.ensureSdkRootSpan(trace, rootKey, event);
                 const span = this.spans.get(key) ??
                     this.getSdkSubagentParent(trace, rootKey, event).span({
                         id: langfuseSpanId(traceId, key),
-                        name: "subagent",
+                        name: 'subagent',
                         startTime: event.createdAt,
                         metadata: lifecycleMetadata(event),
                     });
                 span.update({
                     output,
                     endTime: event.createdAt,
-                    level: event.error ? "ERROR" : "DEFAULT",
+                    level: event.error ? 'ERROR' : 'DEFAULT',
                     ...(event.error ? { statusMessage: event.error } : {}),
                     metadata: lifecycleMetadata(event),
                 });
@@ -175,20 +175,20 @@ export class LangfuseSdkRuntimeEventExporter {
         const parent = this.getSdkEventParent(trace, rootKey, event);
         const key = toolSpanKey(event);
         const id = langfuseSpanId(traceId, key);
-        if (event.status === "started") {
+        if (event.status === 'started') {
             const body = {
                 id,
                 name: toolObservationName(event),
                 startTime: event.createdAt,
                 input: event.args ? { args: event.args } : undefined,
-                level: "DEFAULT",
+                level: 'DEFAULT',
                 metadata: toolMetadata(event),
             };
             const span = this.spans.get(key);
             if (span) {
                 span.update({
                     input: event.args ? { args: event.args } : undefined,
-                    level: "DEFAULT",
+                    level: 'DEFAULT',
                     metadata: toolMetadata(event),
                 });
             }
@@ -208,7 +208,7 @@ export class LangfuseSdkRuntimeEventExporter {
         span.update({
             output,
             endTime: event.createdAt,
-            level: event.error ? "ERROR" : "DEFAULT",
+            level: event.error ? 'ERROR' : 'DEFAULT',
             ...(event.error ? { statusMessage: event.error } : {}),
             metadata: toolMetadata(event),
         });
@@ -221,7 +221,7 @@ export class LangfuseSdkRuntimeEventExporter {
         const parent = this.getSdkEventParent(trace, rootKey, event);
         const key = llmGenerationKey(event);
         const id = langfuseSpanId(traceId, key);
-        if (event.status === "started") {
+        if (event.status === 'started') {
             const body = {
                 id,
                 name: llmGenerationObservationName(event),
@@ -257,9 +257,11 @@ export class LangfuseSdkRuntimeEventExporter {
         generation.update({
             output: event.output ?? (event.error ? { error: event.error } : undefined),
             endTime: event.createdAt,
-            level: event.error ? "ERROR" : "DEFAULT",
+            level: event.error ? 'ERROR' : 'DEFAULT',
             ...(event.error ? { statusMessage: event.error } : {}),
-            ...(event.usage ? { usage: toLangfuseUsage(event.usage), usageDetails: toLangfuseUsageDetails(event.usage) } : {}),
+            ...(event.usage
+                ? { usage: toLangfuseUsage(event.usage), usageDetails: toLangfuseUsageDetails(event.usage) }
+                : {}),
             model: event.model.model,
             modelParameters: {
                 provider: event.model.provider,
@@ -278,7 +280,7 @@ export class LangfuseSdkRuntimeEventExporter {
         const trace = this.client.trace({
             id: langfuseTraceId(traceId),
             sessionId: event.sessionId,
-            name: "copilot-chat-turn",
+            name: 'copilot-chat-turn',
             timestamp: event.createdAt,
             input: !isToolEvent(event) && !isLlmGenerationEvent(event) ? event.details?.input : undefined,
             metadata: isToolEvent(event)
@@ -310,10 +312,10 @@ export class LangfuseSdkRuntimeEventExporter {
             }
             const batchSpan = rootSpan.span({
                 id: langfuseSpanId(requireTraceId(event.traceId), batchKey),
-                name: "subagent fan-out",
+                name: 'subagent fan-out',
                 startTime: event.createdAt,
                 input: event.details?.input,
-                level: "DEFAULT",
+                level: 'DEFAULT',
                 metadata: lifecycleMetadata(event),
             });
             this.spans.set(batchKey, batchSpan);
@@ -330,7 +332,7 @@ export class LangfuseSdkRuntimeEventExporter {
             }
             span.update({
                 endTime: event.createdAt,
-                level: event.error ? "ERROR" : "DEFAULT",
+                level: event.error ? 'ERROR' : 'DEFAULT',
                 ...(event.error ? { statusMessage: event.error } : {}),
                 metadata: lifecycleMetadata(event),
             });
@@ -345,7 +347,7 @@ export class LangfuseSdkRuntimeEventExporter {
         const traceId = requireTraceId(event.traceId);
         const span = trace.span({
             id: langfuseSpanId(traceId, rootKey),
-            name: "copilot-chat-turn",
+            name: 'copilot-chat-turn',
             startTime: event.createdAt,
             metadata: isToolEvent(event)
                 ? toolMetadata(event)
@@ -367,16 +369,18 @@ export class LangfuseHttpRuntimeEventExporter {
     flushing;
     constructor(config, fetchImpl) {
         this.config = config;
-        this.endpoint = `${config.baseUrl.replace(/\/+$/, "")}/api/public/ingestion`;
-        this.authHeader = `Basic ${Buffer.from(`${config.publicKey}:${config.secretKey}`).toString("base64")}`;
-        this.fetchImpl = fetchImpl ?? (async (input, init) => {
-            const response = await fetch(input, init);
-            return {
-                ok: response.ok,
-                status: response.status,
-                text: () => response.text(),
-            };
-        });
+        this.endpoint = `${config.baseUrl.replace(/\/+$/, '')}/api/public/ingestion`;
+        this.authHeader = `Basic ${Buffer.from(`${config.publicKey}:${config.secretKey}`).toString('base64')}`;
+        this.fetchImpl =
+            fetchImpl ??
+                (async (input, init) => {
+                    const response = await fetch(input, init);
+                    return {
+                        ok: response.ok,
+                        status: response.status,
+                        text: () => response.text(),
+                    };
+                });
     }
     async publish(event) {
         const redactedEvent = applyTelemetryRedaction(this.config, event);
@@ -432,17 +436,17 @@ export class LangfuseHttpRuntimeEventExporter {
     }
     async sendBatch(batch) {
         const response = await this.fetchImpl(this.endpoint, {
-            method: "POST",
+            method: 'POST',
             headers: {
                 authorization: this.authHeader,
-                "content-type": "application/json",
-                "x-langfuse-ingestion-version": "4",
+                'content-type': 'application/json',
+                'x-langfuse-ingestion-version': '4',
             },
             body: JSON.stringify({ batch }),
         });
         if (!response.ok) {
-            const text = await response.text().catch(() => "");
-            throw new Error(`Langfuse ingestion failed with ${response.status}${text ? `: ${text}` : ""}`);
+            const text = await response.text().catch(() => '');
+            throw new Error(`Langfuse ingestion failed with ${response.status}${text ? `: ${text}` : ''}`);
         }
     }
 }
@@ -457,14 +461,16 @@ export class OtelRuntimeEventExporter {
     constructor(config, fetchImpl) {
         this.config = config;
         this.endpoint = normalizeOtelTracesEndpoint(config.endpoint);
-        this.fetchImpl = fetchImpl ?? (async (input, init) => {
-            const response = await fetch(input, init);
-            return {
-                ok: response.ok,
-                status: response.status,
-                text: () => response.text(),
-            };
-        });
+        this.fetchImpl =
+            fetchImpl ??
+                (async (input, init) => {
+                    const response = await fetch(input, init);
+                    return {
+                        ok: response.ok,
+                        status: response.status,
+                        text: () => response.text(),
+                    };
+                });
     }
     async publish(event) {
         const redactedEvent = applyTelemetryRedaction(this.config, event);
@@ -521,16 +527,16 @@ export class OtelRuntimeEventExporter {
     }
     async sendSpans(spans) {
         const response = await this.fetchImpl(this.endpoint, {
-            method: "POST",
+            method: 'POST',
             headers: {
-                "content-type": "application/json",
+                'content-type': 'application/json',
                 ...(this.config.headers ?? {}),
             },
             body: JSON.stringify(toOtelTracePayload(spans, this.config)),
         });
         if (!response.ok) {
-            const text = await response.text().catch(() => "");
-            throw new Error(`${this.config.errorLabel ?? "OTEL export"} failed with ${response.status}${text ? `: ${text}` : ""}`);
+            const text = await response.text().catch(() => '');
+            throw new Error(`${this.config.errorLabel ?? 'OTEL export'} failed with ${response.status}${text ? `: ${text}` : ''}`);
         }
     }
 }
@@ -539,29 +545,59 @@ export function createRuntimeEventExporterFromEnv(env) {
     if (!config.enabled) {
         return new NoopRuntimeEventExporter();
     }
-    if (config.transport === "sdk") {
+    if (config.transport === 'sdk') {
         return new LangfuseSdkRuntimeEventExporter(config);
     }
     return new LangfuseHttpRuntimeEventExporter(config);
 }
+export function createLangfuseExporter(telemetryConfig) {
+    const config = resolveLangfuseExporterConfig(telemetryConfig);
+    if (!config.enabled) {
+        return new NoopRuntimeEventExporter();
+    }
+    if (config.transport === 'sdk') {
+        return new LangfuseSdkRuntimeEventExporter(config);
+    }
+    return new LangfuseHttpRuntimeEventExporter(config);
+}
+export function resolveLangfuseExporterConfig(telemetryConfig) {
+    const lf = telemetryConfig.langfuse;
+    const publicKey = lf?.publicKey ?? '';
+    const secretKey = lf?.secretKey ?? '';
+    const credentialsPresent = Boolean(publicKey && secretKey);
+    const requestedTransport = lf?.transport;
+    const transport = requestedTransport ?? (credentialsPresent ? 'sdk' : 'ingestion');
+    return {
+        enabled: Boolean(lf?.enabled && credentialsPresent),
+        transport,
+        publicKey,
+        secretKey,
+        baseUrl: lf?.baseUrl ?? DEFAULT_LANGFUSE_BASE_URL,
+        flushAt: lf?.flushAt ?? DEFAULT_FLUSH_AT,
+        flushIntervalMs: lf?.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS,
+        serviceName: telemetryConfig.serviceName ?? 'pi-server',
+        ...(telemetryConfig.serviceVersion ? { serviceVersion: telemetryConfig.serviceVersion } : {}),
+        includePayloads: telemetryConfig.includePayloads ?? true,
+    };
+}
 export function resolveLangfuseConfig(env) {
     const enabled = parseBoolean(env.LANGFUSE_ENABLED);
     const publicKey = trim(env.LANGFUSE_PUBLIC_KEY);
     const secretKey = trim(env.LANGFUSE_SECRET_KEY);
     const baseUrl = trim(env.LANGFUSE_BASE_URL) ?? DEFAULT_LANGFUSE_BASE_URL;
     const requestedTransport = parseLangfuseTransport(env.LANGFUSE_TRANSPORT);
-    const transport = requestedTransport ?? (publicKey && secretKey ? "sdk" : "ingestion");
+    const transport = requestedTransport ?? (publicKey && secretKey ? 'sdk' : 'ingestion');
     const credentialsPresent = Boolean(publicKey && secretKey);
     const serviceVersion = trim(env.TELEMETRY_SERVICE_VERSION);
     return {
         enabled: Boolean(enabled && credentialsPresent),
         transport,
-        publicKey: publicKey ?? "",
-        secretKey: secretKey ?? "",
+        publicKey: publicKey ?? '',
+        secretKey: secretKey ?? '',
         baseUrl,
         flushAt: parsePositiveInteger(env.LANGFUSE_FLUSH_AT, DEFAULT_FLUSH_AT),
         flushIntervalMs: parsePositiveInteger(env.LANGFUSE_FLUSH_INTERVAL_MS, DEFAULT_FLUSH_INTERVAL_MS),
-        serviceName: trim(env.TELEMETRY_SERVICE_NAME ?? env.OTEL_SERVICE_NAME) ?? "pi-server",
+        serviceName: trim(env.TELEMETRY_SERVICE_NAME ?? env.OTEL_SERVICE_NAME) ?? 'pi-server',
         ...(serviceVersion ? { serviceVersion } : {}),
         includePayloads: parseBooleanWithDefault(env.TELEMETRY_INCLUDE_PAYLOADS ?? env.LANGFUSE_INCLUDE_PAYLOADS, true),
     };
@@ -581,31 +617,35 @@ export function mapRuntimeEventToLangfuse(event) {
 function mapLifecycleEventToLangfuse(event) {
     const traceId = requireTraceId(event.traceId);
     switch (event.type) {
-        case "chat_turn_started":
-            return [ingestionEvent("trace-create", event.createdAt, {
+        case 'chat_turn_started':
+            return [
+                ingestionEvent('trace-create', event.createdAt, {
                     id: langfuseTraceId(traceId),
                     sessionId: event.sessionId,
-                    name: "copilot-chat-turn",
+                    name: 'copilot-chat-turn',
                     timestamp: event.createdAt,
                     input: event.details?.input,
                     metadata: lifecycleMetadata(event),
-                })];
-        case "chat_turn_completed":
-        case "chat_turn_failed": {
+                }),
+            ];
+        case 'chat_turn_completed':
+        case 'chat_turn_failed': {
             const output = event.details?.output ?? (event.error ? { error: event.error } : undefined);
-            return [ingestionEvent("trace-update", event.createdAt, {
+            return [
+                ingestionEvent('trace-update', event.createdAt, {
                     id: langfuseTraceId(traceId),
                     ...(output !== undefined ? { output } : {}),
                     metadata: lifecycleMetadata(event),
-                })];
+                }),
+            ];
         }
-        case "chat_turn_steered":
-        case "chat_turn_steer_delivered":
-        case "chat_turn_followup_queued":
-        case "chat_turn_followup_delivered": {
+        case 'chat_turn_steered':
+        case 'chat_turn_steer_delivered':
+        case 'chat_turn_followup_queued':
+        case 'chat_turn_followup_delivered': {
             const spanId = langfuseSpanId(traceId, chatInputSpanKey(event));
             return [
-                ingestionEvent("span-create", event.createdAt, {
+                ingestionEvent('span-create', event.createdAt, {
                     id: spanId,
                     traceId: langfuseTraceId(traceId),
                     parentObservationId: langfuseSpanId(traceId, chatSpanKey(event)),
@@ -614,7 +654,7 @@ function mapLifecycleEventToLangfuse(event) {
                     input: event.details?.input,
                     metadata: lifecycleMetadata(event),
                 }),
-                ingestionEvent("span-update", event.createdAt, {
+                ingestionEvent('span-update', event.createdAt, {
                     id: spanId,
                     traceId: langfuseTraceId(traceId),
                     endTime: event.createdAt,
@@ -623,43 +663,45 @@ function mapLifecycleEventToLangfuse(event) {
                 }),
             ];
         }
-        case "subagent_spawned":
-        case "subagent_started": {
+        case 'subagent_spawned':
+        case 'subagent_started': {
             const batchKey = subagentBatchSpanKey(event);
             return [
                 ...(batchKey
                     ? [
-                        ingestionEvent("span-create", event.createdAt, {
+                        ingestionEvent('span-create', event.createdAt, {
                             id: langfuseSpanId(traceId, batchKey),
                             traceId: langfuseTraceId(traceId),
                             parentObservationId: langfuseSpanId(traceId, chatSpanKey(event)),
-                            name: "subagent fan-out",
+                            name: 'subagent fan-out',
                             startTime: event.createdAt,
                             input: event.details?.input,
                             metadata: lifecycleMetadata(event),
                         }),
                     ]
                     : []),
-                ingestionEvent("span-create", event.createdAt, {
+                ingestionEvent('span-create', event.createdAt, {
                     id: langfuseSpanId(traceId, subagentSpanKey(event)),
                     traceId: langfuseTraceId(traceId),
                     parentObservationId: langfuseSpanId(traceId, batchKey ?? subagentSpawnToolSpanKey(event) ?? chatSpanKey(event)),
-                    name: "subagent",
+                    name: 'subagent',
                     startTime: event.createdAt,
                     metadata: lifecycleMetadata(event),
                 }),
             ];
         }
-        case "subagent_completed":
-        case "subagent_failed":
-        case "subagent_cancelled":
-            return [ingestionEvent("span-update", event.createdAt, {
+        case 'subagent_completed':
+        case 'subagent_failed':
+        case 'subagent_cancelled':
+            return [
+                ingestionEvent('span-update', event.createdAt, {
                     id: langfuseSpanId(traceId, subagentSpanKey(event)),
                     traceId: langfuseTraceId(traceId),
                     endTime: event.createdAt,
                     metadata: lifecycleMetadata(event),
                     ...(event.error ? { output: { error: event.error } } : {}),
-                })];
+                }),
+            ];
         default:
             return assertNever(event.type);
     }
@@ -668,8 +710,8 @@ function mapToolEventToLangfuse(event) {
     const traceId = requireTraceId(event.traceId);
     const spanId = langfuseSpanId(traceId, `tool:${event.sessionId}:${event.toolCallId}:${event.toolName}`);
     const parentObservationId = langfuseParentObservationId(traceId, event);
-    if (event.status === "started") {
-        return ingestionEvent("span-create", event.createdAt, {
+    if (event.status === 'started') {
+        return ingestionEvent('span-create', event.createdAt, {
             id: spanId,
             traceId: langfuseTraceId(traceId),
             parentObservationId,
@@ -679,7 +721,7 @@ function mapToolEventToLangfuse(event) {
             metadata: toolMetadata(event),
         });
     }
-    return ingestionEvent("span-update", event.createdAt, {
+    return ingestionEvent('span-update', event.createdAt, {
         id: spanId,
         traceId: langfuseTraceId(traceId),
         endTime: event.createdAt,
@@ -691,8 +733,8 @@ function mapLlmGenerationEventToLangfuse(event) {
     const traceId = requireTraceId(event.traceId);
     const id = langfuseSpanId(traceId, llmGenerationKey(event));
     const parentObservationId = langfuseParentObservationId(traceId, event);
-    if (event.status === "started") {
-        return ingestionEvent("generation-create", event.createdAt, {
+    if (event.status === 'started') {
+        return ingestionEvent('generation-create', event.createdAt, {
             id,
             traceId: langfuseTraceId(traceId),
             parentObservationId,
@@ -707,14 +749,16 @@ function mapLlmGenerationEventToLangfuse(event) {
             metadata: llmGenerationMetadata(event),
         });
     }
-    return ingestionEvent("generation-update", event.createdAt, {
+    return ingestionEvent('generation-update', event.createdAt, {
         id,
         traceId: langfuseTraceId(traceId),
         endTime: event.createdAt,
         output: event.output ?? (event.error ? { error: event.error } : undefined),
-        level: event.error ? "ERROR" : "DEFAULT",
+        level: event.error ? 'ERROR' : 'DEFAULT',
         ...(event.error ? { statusMessage: event.error } : {}),
-        ...(event.usage ? { usage: toLangfuseUsage(event.usage), usageDetails: toLangfuseUsageDetails(event.usage) } : {}),
+        ...(event.usage
+            ? { usage: toLangfuseUsage(event.usage), usageDetails: toLangfuseUsageDetails(event.usage) }
+            : {}),
         model: event.model.model,
         modelParameters: {
             provider: event.model.provider,
@@ -739,32 +783,32 @@ function mapLifecycleEventToOtelSpans(event, pendingStarts) {
     const rootKey = chatSpanKey(event);
     const rootSpanId = langfuseSpanId(traceId, rootKey);
     switch (event.type) {
-        case "chat_turn_started":
+        case 'chat_turn_started':
             pendingStarts.set(rootKey, {
                 traceId: langfuseTraceId(traceId),
                 spanId: rootSpanId,
-                name: "copilot-chat-turn",
+                name: 'copilot-chat-turn',
                 startTime: event.createdAt,
                 attributes: {
                     ...lifecycleMetadata(event),
-                    ...langfuseObservationAttributes({ input: event.details?.input, level: "DEFAULT" }),
+                    ...langfuseObservationAttributes({ input: event.details?.input, level: 'DEFAULT' }),
                     ...langfuseTraceAttributes({ input: event.details?.input }),
                 },
             });
             return [];
-        case "chat_turn_completed":
-        case "chat_turn_failed":
+        case 'chat_turn_completed':
+        case 'chat_turn_failed':
             return [
                 completeOtelSpan(pendingStarts, rootKey, {
                     traceId: langfuseTraceId(traceId),
                     spanId: rootSpanId,
-                    name: "copilot-chat-turn",
+                    name: 'copilot-chat-turn',
                     startTime: event.createdAt,
                     attributes: {
                         ...lifecycleMetadata(event),
                         ...langfuseObservationAttributes({
                             output: event.details?.output ?? (event.error ? { error: event.error } : undefined),
-                            level: event.error ? "ERROR" : "DEFAULT",
+                            level: event.error ? 'ERROR' : 'DEFAULT',
                         }),
                         ...langfuseTraceAttributes({
                             output: event.details?.output ?? (event.error ? { error: event.error } : undefined),
@@ -772,10 +816,10 @@ function mapLifecycleEventToOtelSpans(event, pendingStarts) {
                     },
                 }, event.createdAt, event.error),
             ];
-        case "chat_turn_steered":
-        case "chat_turn_steer_delivered":
-        case "chat_turn_followup_queued":
-        case "chat_turn_followup_delivered":
+        case 'chat_turn_steered':
+        case 'chat_turn_steer_delivered':
+        case 'chat_turn_followup_queued':
+        case 'chat_turn_followup_delivered':
             return [
                 {
                     traceId: langfuseTraceId(traceId),
@@ -789,43 +833,43 @@ function mapLifecycleEventToOtelSpans(event, pendingStarts) {
                         ...langfuseObservationAttributes({
                             input: event.details?.input,
                             output: event.details?.output ?? chatInputLifecycleOutput(event),
-                            level: "DEFAULT",
+                            level: 'DEFAULT',
                         }),
                     },
                 },
             ];
-        case "subagent_spawned":
-        case "subagent_started": {
+        case 'subagent_spawned':
+        case 'subagent_started': {
             const key = subagentSpanKey(event);
             pendingStarts.set(key, {
                 traceId: langfuseTraceId(traceId),
                 spanId: langfuseSpanId(traceId, key),
                 parentSpanId: langfuseSpanId(traceId, subagentSpawnToolSpanKey(event) ?? rootKey),
-                name: "subagent",
+                name: 'subagent',
                 startTime: event.createdAt,
                 attributes: {
                     ...lifecycleMetadata(event),
-                    ...langfuseObservationAttributes({ input: event.details?.input, level: "DEFAULT" }),
+                    ...langfuseObservationAttributes({ input: event.details?.input, level: 'DEFAULT' }),
                 },
             });
             return [];
         }
-        case "subagent_completed":
-        case "subagent_failed":
-        case "subagent_cancelled": {
+        case 'subagent_completed':
+        case 'subagent_failed':
+        case 'subagent_cancelled': {
             const key = subagentSpanKey(event);
             return [
                 completeOtelSpan(pendingStarts, key, {
                     traceId: langfuseTraceId(traceId),
                     spanId: langfuseSpanId(traceId, key),
                     parentSpanId: langfuseSpanId(traceId, subagentSpawnToolSpanKey(event) ?? rootKey),
-                    name: "subagent",
+                    name: 'subagent',
                     startTime: event.createdAt,
                     attributes: {
                         ...lifecycleMetadata(event),
                         ...langfuseObservationAttributes({
                             output: event.details?.output ?? (event.error ? { error: event.error } : undefined),
-                            level: event.error ? "ERROR" : "DEFAULT",
+                            level: event.error ? 'ERROR' : 'DEFAULT',
                         }),
                     },
                 }, event.createdAt, event.error),
@@ -848,17 +892,17 @@ function mapToolEventToOtelSpans(event, pendingStarts) {
             ...toolMetadata(event),
             ...langfuseObservationAttributes({
                 output: event.error ? { error: event.error } : event.details,
-                level: event.error ? "ERROR" : "DEFAULT",
+                level: event.error ? 'ERROR' : 'DEFAULT',
             }),
         },
     };
-    if (event.status === "started") {
+    if (event.status === 'started') {
         pendingStarts.set(key, {
             ...fallbackStart,
             attributes: {
                 ...fallbackStart.attributes,
                 ...(event.args ? { args: event.args } : {}),
-                ...langfuseObservationAttributes({ input: event.args, level: "DEFAULT" }),
+                ...langfuseObservationAttributes({ input: event.args, level: 'DEFAULT' }),
             },
         });
         return [];
@@ -876,23 +920,23 @@ function mapLlmGenerationEventToOtelSpans(event, pendingStarts) {
         startTime: event.createdAt,
         attributes: {
             ...llmGenerationMetadata(event),
-            "langfuse.observation.type": "generation",
+            'langfuse.observation.type': 'generation',
             model: event.model.model,
             provider: event.model.provider,
             ...(event.model.thinkingLevel ? { thinkingLevel: event.model.thinkingLevel } : {}),
             ...langfuseObservationAttributes({
                 output: event.output ?? (event.error ? { error: event.error } : undefined),
-                level: event.error ? "ERROR" : "DEFAULT",
+                level: event.error ? 'ERROR' : 'DEFAULT',
             }),
             ...(event.usage ? flattenUsageAttributes(event.usage) : {}),
         },
     };
-    if (event.status === "started") {
+    if (event.status === 'started') {
         pendingStarts.set(key, {
             ...fallbackStart,
             attributes: {
                 ...fallbackStart.attributes,
-                ...langfuseObservationAttributes({ input: event.input, level: "DEFAULT" }),
+                ...langfuseObservationAttributes({ input: event.input, level: 'DEFAULT' }),
             },
         });
         return [];
@@ -914,33 +958,37 @@ function completeOtelSpan(pendingStarts, key, fallbackStart, endTime, error) {
 }
 function langfuseObservationAttributes(input) {
     return {
-        "langfuse.observation.type": "span",
+        'langfuse.observation.type': 'span',
         ...(input.input !== undefined
             ? {
-                "langfuse.observation.input": toLangfuseObservationPayload(input.input),
-                "input.value": toLangfuseObservationPayload(input.input),
+                'langfuse.observation.input': toLangfuseObservationPayload(input.input),
+                'input.value': toLangfuseObservationPayload(input.input),
             }
             : {}),
         ...(input.output !== undefined
             ? {
-                "langfuse.observation.output": toLangfuseObservationPayload(input.output),
-                "output.value": toLangfuseObservationPayload(input.output),
+                'langfuse.observation.output': toLangfuseObservationPayload(input.output),
+                'output.value': toLangfuseObservationPayload(input.output),
             }
             : {}),
-        ...(input.level ? { "langfuse.observation.level": input.level } : {}),
+        ...(input.level ? { 'langfuse.observation.level': input.level } : {}),
     };
 }
 function langfuseTraceAttributes(input) {
     return {
-        ...(input.input !== undefined ? { "langfuse.trace.input": toLangfuseTracePayload(input.input) } : {}),
-        ...(input.output !== undefined ? { "langfuse.trace.output": toLangfuseTracePayload(input.output) } : {}),
+        ...(input.input !== undefined
+            ? { 'langfuse.trace.input': toLangfuseTracePayload(input.input) }
+            : {}),
+        ...(input.output !== undefined
+            ? { 'langfuse.trace.output': toLangfuseTracePayload(input.output) }
+            : {}),
     };
 }
 function toLangfuseObservationPayload(value) {
     return JSON.stringify(value);
 }
 function toLangfuseTracePayload(value) {
-    return typeof value === "string" ? value : JSON.stringify(value);
+    return typeof value === 'string' ? value : JSON.stringify(value);
 }
 function chatSpanKey(event) {
     const sessionId = event.parentSessionId ?? event.sessionId;
@@ -954,7 +1002,7 @@ function subagentSpanKey(event) {
     return `subagent:${event.runId ?? event.childSessionId ?? event.id}`;
 }
 function subagentBatchSpanKey(event) {
-    const batchId = event.spawnBatchId ?? stringFromJsonObject(event.details, "spawnBatchId");
+    const batchId = event.spawnBatchId ?? stringFromJsonObject(event.details, 'spawnBatchId');
     return event.traceId && batchId ? `subagent-batch:${event.traceId}:${batchId}` : undefined;
 }
 function telemetryEventSubagentSpanKey(event) {
@@ -983,23 +1031,25 @@ function toolObservationName(event) {
 }
 function chatInputObservationName(event) {
     const prefix = chatInputObservationPrefix(event.type);
-    const input = typeof event.details?.input === "string" ? truncateObservationSummary(event.details.input) : undefined;
+    const input = typeof event.details?.input === 'string'
+        ? truncateObservationSummary(event.details.input)
+        : undefined;
     return input ? `${prefix} [${input}]` : prefix;
 }
 function chatInputObservationPrefix(type) {
-    if (type === "chat_turn_steered") {
-        return "chat-steer";
+    if (type === 'chat_turn_steered') {
+        return 'chat-steer';
     }
-    if (type === "chat_turn_steer_delivered") {
-        return "chat-steer-delivered";
+    if (type === 'chat_turn_steer_delivered') {
+        return 'chat-steer-delivered';
     }
-    if (type === "chat_turn_followup_delivered") {
-        return "chat-followup-delivered";
+    if (type === 'chat_turn_followup_delivered') {
+        return 'chat-followup-delivered';
     }
-    return "chat-followup";
+    return 'chat-followup';
 }
 function chatInputLifecycleOutput(event) {
-    return event.type === "chat_turn_steer_delivered" || event.type === "chat_turn_followup_delivered"
+    return event.type === 'chat_turn_steer_delivered' || event.type === 'chat_turn_followup_delivered'
         ? { delivered: true, turnMode: event.details?.turnMode }
         : { accepted: true, turnMode: event.details?.turnMode };
 }
@@ -1007,59 +1057,59 @@ function summarizeToolArgsForName(toolName, args) {
     if (!args) {
         return undefined;
     }
-    const pathValue = stringArg(args, "path") ?? stringArg(args, "filePath") ?? stringArg(args, "absolutePath");
+    const pathValue = stringArg(args, 'path') ?? stringArg(args, 'filePath') ?? stringArg(args, 'absolutePath');
     if (pathValue) {
         return truncateObservationSummary(pathValue);
     }
-    const command = stringArg(args, "command");
+    const command = stringArg(args, 'command');
     if (command) {
         return truncateObservationSummary(command);
     }
-    const query = stringArg(args, "query");
+    const query = stringArg(args, 'query');
     if (query) {
         return truncateObservationSummary(query);
     }
-    const task = stringArg(args, "task");
-    if (task && toolName === "sessions_spawn") {
+    const task = stringArg(args, 'task');
+    if (task && toolName === 'sessions_spawn') {
         return truncateObservationSummary(task);
     }
-    const code = stringArg(args, "code");
+    const code = stringArg(args, 'code');
     if (code) {
         return truncateObservationSummary(code);
     }
-    const name = stringArg(args, "name");
-    if (name && toolName.startsWith("mcp_")) {
+    const name = stringArg(args, 'name');
+    if (name && toolName.startsWith('mcp_')) {
         return truncateObservationSummary(name);
     }
     return undefined;
 }
 function llmGenerationObservationName(event) {
-    return `llm-generation [${event.runId || event.childSessionId ? "subagent" : "main"}] [${summarizeLlmGenerationInputForName(event.input)}]`;
+    return `llm-generation [${event.runId || event.childSessionId ? 'subagent' : 'main'}] [${summarizeLlmGenerationInputForName(event.input)}]`;
 }
 function summarizeLlmGenerationInputForName(input) {
-    if (typeof input === "string") {
+    if (typeof input === 'string') {
         return truncateObservationSummary(input);
     }
-    if (input && typeof input === "object" && !Array.isArray(input)) {
+    if (input && typeof input === 'object' && !Array.isArray(input)) {
         const continuation = input.continuation === true;
-        const index = typeof input.llmGenerationIndex === "number" ? input.llmGenerationIndex : undefined;
-        const toolResults = typeof input.previousToolResultCount === "number" ? input.previousToolResultCount : undefined;
+        const index = typeof input.llmGenerationIndex === 'number' ? input.llmGenerationIndex : undefined;
+        const toolResults = typeof input.previousToolResultCount === 'number' ? input.previousToolResultCount : undefined;
         if (continuation) {
-            return truncateObservationSummary(`continuation${index !== undefined ? ` #${index}` : ""}${toolResults !== undefined ? ` after ${toolResults} tool result(s)` : ""}`);
+            return truncateObservationSummary(`continuation${index !== undefined ? ` #${index}` : ''}${toolResults !== undefined ? ` after ${toolResults} tool result(s)` : ''}`);
         }
     }
-    return "request";
+    return 'request';
 }
 function stringArg(args, key) {
     const value = args[key];
-    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
 }
 function stringFromJsonObject(value, key) {
     const field = value?.[key];
-    return typeof field === "string" && field.trim() ? field.trim() : undefined;
+    return typeof field === 'string' && field.trim() ? field.trim() : undefined;
 }
 function truncateObservationSummary(value, maxLength = 90) {
-    const normalized = value.replace(/\s+/g, " ").trim();
+    const normalized = value.replace(/\s+/g, ' ').trim();
     return normalized.length > maxLength ? `${normalized.slice(0, maxLength - 1)}…` : normalized;
 }
 function ensureEndAfterStart(startTime, endTime) {
@@ -1071,14 +1121,16 @@ function toOtelTracePayload(spans, config) {
             {
                 resource: {
                     attributes: [
-                        otelAttribute("service.name", config.serviceName ?? "pi-server"),
-                        ...(config.serviceVersion ? [otelAttribute("service.version", config.serviceVersion)] : []),
-                        otelAttribute("telemetry.sdk.name", "@amaster.ai/pi-telemetry"),
+                        otelAttribute('service.name', config.serviceName ?? 'pi-server'),
+                        ...(config.serviceVersion
+                            ? [otelAttribute('service.version', config.serviceVersion)]
+                            : []),
+                        otelAttribute('telemetry.sdk.name', '@amaster.ai/pi-telemetry'),
                     ],
                 },
                 scopeSpans: [
                     {
-                        scope: { name: "@amaster.ai/pi-telemetry", version: "0.1.0" },
+                        scope: { name: '@amaster.ai/pi-telemetry', version: '0.1.0' },
                         spans: spans.map(toOtelSpanPayload),
                     },
                 ],
@@ -1105,13 +1157,13 @@ function otelAttribute(key, value) {
     return { key, value: otelAttributeValue(value) };
 }
 function otelAttributeValue(value) {
-    if (typeof value === "boolean") {
+    if (typeof value === 'boolean') {
         return { boolValue: value };
     }
-    if (typeof value === "number") {
+    if (typeof value === 'number') {
         return Number.isInteger(value) ? { intValue: String(value) } : { doubleValue: value };
     }
-    if (typeof value === "string") {
+    if (typeof value === 'string') {
         return { stringValue: value };
     }
     return { stringValue: JSON.stringify(value) };
@@ -1121,13 +1173,13 @@ function toUnixNano(iso) {
     return String(BigInt(Number.isFinite(millis) ? millis : Date.now()) * 1000000n);
 }
 function normalizeOtelTracesEndpoint(endpoint) {
-    return endpoint.endsWith("/v1/traces") ? endpoint : `${endpoint.replace(/\/+$/, "")}/v1/traces`;
+    return endpoint.endsWith('/v1/traces') ? endpoint : `${endpoint.replace(/\/+$/, '')}/v1/traces`;
 }
 function shortCorrelationId(value) {
     if (!value) {
         return undefined;
     }
-    const normalized = value.startsWith("trace:") ? value.slice("trace:".length) : value;
+    const normalized = value.startsWith('trace:') ? value.slice('trace:'.length) : value;
     const uuid = normalized.match(/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/i)?.[0];
     if (uuid) {
         return uuid.slice(0, 8);
@@ -1141,11 +1193,14 @@ function compactSessionId(value) {
     if (!value) {
         return undefined;
     }
-    const [root, ...subagents] = value.split(":subagent:");
+    const [root, ...subagents] = value.split(':subagent:');
     if (subagents.length === 0) {
         return value;
     }
-    return [root, ...subagents.map((sessionId) => `sub:${shortCorrelationId(sessionId) ?? sessionId}`)].join("/");
+    return [
+        root,
+        ...subagents.map((sessionId) => `sub:${shortCorrelationId(sessionId) ?? sessionId}`),
+    ].join('/');
 }
 function lineageMetadata(event) {
     const sessionId = compactSessionId(event.sessionId);
@@ -1202,7 +1257,7 @@ function toLangfuseUsage(usage) {
         ...(usage.input !== undefined ? { input: usage.input } : {}),
         ...(usage.output !== undefined ? { output: usage.output } : {}),
         ...(usage.totalTokens !== undefined ? { total: usage.totalTokens } : {}),
-        unit: "TOKENS",
+        unit: 'TOKENS',
         ...(usage.cost?.input !== undefined ? { inputCost: usage.cost.input } : {}),
         ...(usage.cost?.output !== undefined ? { outputCost: usage.cost.output } : {}),
         ...(usage.cost?.total !== undefined ? { totalCost: usage.cost.total } : {}),
@@ -1219,12 +1274,12 @@ function toLangfuseUsageDetails(usage) {
 }
 function flattenUsageAttributes(usage) {
     return {
-        ...(usage.input !== undefined ? { "usage.input": usage.input } : {}),
-        ...(usage.output !== undefined ? { "usage.output": usage.output } : {}),
-        ...(usage.cacheRead !== undefined ? { "usage.cache_read": usage.cacheRead } : {}),
-        ...(usage.cacheWrite !== undefined ? { "usage.cache_write": usage.cacheWrite } : {}),
-        ...(usage.totalTokens !== undefined ? { "usage.total_tokens": usage.totalTokens } : {}),
-        ...(usage.cost?.total !== undefined ? { "usage.cost.total": usage.cost.total } : {}),
+        ...(usage.input !== undefined ? { 'usage.input': usage.input } : {}),
+        ...(usage.output !== undefined ? { 'usage.output': usage.output } : {}),
+        ...(usage.cacheRead !== undefined ? { 'usage.cache_read': usage.cacheRead } : {}),
+        ...(usage.cacheWrite !== undefined ? { 'usage.cache_write': usage.cacheWrite } : {}),
+        ...(usage.totalTokens !== undefined ? { 'usage.total_tokens': usage.totalTokens } : {}),
+        ...(usage.cost?.total !== undefined ? { 'usage.cost.total': usage.cost.total } : {}),
     };
 }
 function ingestionEvent(type, timestamp, body) {
@@ -1242,7 +1297,7 @@ function langfuseSpanId(traceId, key) {
     return stableHex(`span:${traceId}:${key}`, 16);
 }
 function stableHex(input, length) {
-    return createHash("sha256").update(input).digest("hex").slice(0, length);
+    return createHash('sha256').update(input).digest('hex').slice(0, length);
 }
 function applyTelemetryRedaction(config, event) {
     const redacted = config.redactEvent ? config.redactEvent(event) : event;
@@ -1274,13 +1329,13 @@ function redactJsonObjectPayload(input) {
     return rest;
 }
 function isToolEvent(event) {
-    return "toolCallId" in event;
+    return 'toolCallId' in event;
 }
 function isLlmGenerationEvent(event) {
-    return "llmGenerationId" in event;
+    return 'llmGenerationId' in event;
 }
 function parseBoolean(value) {
-    return value === "1" || value === "true" || value === "TRUE" || value === "yes";
+    return value === '1' || value === 'true' || value === 'TRUE' || value === 'yes';
 }
 function parseBooleanWithDefault(value, fallback) {
     if (value === undefined) {
@@ -1290,7 +1345,7 @@ function parseBooleanWithDefault(value, fallback) {
 }
 function parseLangfuseTransport(value) {
     const normalized = value?.trim().toLowerCase();
-    return normalized === "sdk" || normalized === "ingestion" ? normalized : undefined;
+    return normalized === 'sdk' || normalized === 'ingestion' ? normalized : undefined;
 }
 function parsePositiveInteger(value, fallback) {
     const parsed = Number(value);
@@ -1305,7 +1360,7 @@ function assertNever(value) {
 }
 function requireTraceId(traceId) {
     if (!traceId) {
-        throw new Error("Telemetry event is missing traceId");
+        throw new Error('Telemetry event is missing traceId');
     }
     return traceId;
 }