@llmops/app 0.6.3-beta.1 → 0.6.5

package/dist/index.cjs

@@ -59,6 +59,8 @@ let hono_cors = require("hono/cors");
 let node_crypto = require("node:crypto");
 let __llmops_gateway = require("@llmops/gateway");
 __llmops_gateway = __toESM(__llmops_gateway);
+let protobufjs = require("protobufjs");
+protobufjs = __toESM(protobufjs);
 let node_process = require("node:process");
 let __llmops_core_db = require("@llmops/core/db");
 let better_auth = require("better-auth");
@@ -18287,6 +18289,7 @@ function createTraceBatchWriter(deps, config$1 = {}) {
 		const batch = queue;
 		queue = [];
 		try {
+			__llmops_core.logger.info(`[TraceBatchWriter] Flushing ${batch.length} items`);
 			log(`[TraceBatchWriter] Flushing ${batch.length} items`);
 			const traceMap = /* @__PURE__ */ new Map();
 			for (const item of batch) {
@@ -18320,6 +18323,7 @@ function createTraceBatchWriter(deps, config$1 = {}) {
 			if (allSpans.length > 0) await deps.batchInsertSpans(allSpans);
 			const allEvents = batch.flatMap((item) => item.events ?? []);
 			if (allEvents.length > 0) await deps.batchInsertSpanEvents(allEvents);
+			__llmops_core.logger.info(`[TraceBatchWriter] Flushed ${traceMap.size} traces, ${allSpans.length} spans, ${allEvents.length} events`);
 			log(`[TraceBatchWriter] Flushed ${traceMap.size} traces, ${allSpans.length} spans, ${allEvents.length} events`);
 		} catch (error$47) {
 			const errorMsg = error$47 instanceof Error ? error$47.message : String(error$47);
@@ -18808,6 +18812,317 @@ app$4.use("*", (0, hono_pretty_json.prettyJSON)()).get("/health", async (c) => {
 });
 var genai_default = app$4;
 
+//#endregion
+//#region src/server/handlers/otlp/decode.ts
+/**
+* OTLP Protobuf Decoder
+*
+* Decodes binary protobuf ExportTraceServiceRequest into the same JSON
+* structure the OTLP handler already expects. Uses an embedded protobufjs
+* JSON descriptor — no .proto files needed at runtime.
+*/
+const protoDescriptor = { nested: {
+	ExportTraceServiceRequest: { fields: { resourceSpans: {
+		rule: "repeated",
+		type: "ResourceSpans",
+		id: 1
+	} } },
+	ResourceSpans: { fields: {
+		resource: {
+			type: "Resource",
+			id: 1
+		},
+		scopeSpans: {
+			rule: "repeated",
+			type: "ScopeSpans",
+			id: 2
+		},
+		instrumentationLibrarySpans: {
+			rule: "repeated",
+			type: "ScopeSpans",
+			id: 1e3
+		}
+	} },
+	Resource: { fields: { attributes: {
+		rule: "repeated",
+		type: "KeyValue",
+		id: 1
+	} } },
+	ScopeSpans: { fields: {
+		scope: {
+			type: "InstrumentationScope",
+			id: 1
+		},
+		spans: {
+			rule: "repeated",
+			type: "Span",
+			id: 2
+		}
+	} },
+	InstrumentationScope: { fields: {
+		name: {
+			type: "string",
+			id: 1
+		},
+		version: {
+			type: "string",
+			id: 2
+		}
+	} },
+	Span: { fields: {
+		traceId: {
+			type: "bytes",
+			id: 1
+		},
+		spanId: {
+			type: "bytes",
+			id: 2
+		},
+		traceState: {
+			type: "string",
+			id: 3
+		},
+		parentSpanId: {
+			type: "bytes",
+			id: 4
+		},
+		name: {
+			type: "string",
+			id: 5
+		},
+		kind: {
+			type: "SpanKind",
+			id: 6
+		},
+		startTimeUnixNano: {
+			type: "fixed64",
+			id: 7
+		},
+		endTimeUnixNano: {
+			type: "fixed64",
+			id: 8
+		},
+		attributes: {
+			rule: "repeated",
+			type: "KeyValue",
+			id: 9
+		},
+		events: {
+			rule: "repeated",
+			type: "SpanEvent",
+			id: 10
+		},
+		status: {
+			type: "Status",
+			id: 15
+		}
+	} },
+	SpanKind: { values: {
+		SPAN_KIND_UNSPECIFIED: 0,
+		SPAN_KIND_INTERNAL: 1,
+		SPAN_KIND_SERVER: 2,
+		SPAN_KIND_CLIENT: 3,
+		SPAN_KIND_PRODUCER: 4,
+		SPAN_KIND_CONSUMER: 5
+	} },
+	SpanEvent: { fields: {
+		timeUnixNano: {
+			type: "fixed64",
+			id: 1
+		},
+		name: {
+			type: "string",
+			id: 2
+		},
+		attributes: {
+			rule: "repeated",
+			type: "KeyValue",
+			id: 3
+		}
+	} },
+	Status: { fields: {
+		message: {
+			type: "string",
+			id: 2
+		},
+		code: {
+			type: "StatusCode",
+			id: 3
+		}
+	} },
+	StatusCode: { values: {
+		STATUS_CODE_UNSET: 0,
+		STATUS_CODE_OK: 1,
+		STATUS_CODE_ERROR: 2
+	} },
+	KeyValue: { fields: {
+		key: {
+			type: "string",
+			id: 1
+		},
+		value: {
+			type: "AnyValue",
+			id: 2
+		}
+	} },
+	AnyValue: {
+		fields: {
+			stringValue: {
+				type: "string",
+				id: 1
+			},
+			boolValue: {
+				type: "bool",
+				id: 2
+			},
+			intValue: {
+				type: "int64",
+				id: 3
+			},
+			doubleValue: {
+				type: "double",
+				id: 4
+			},
+			arrayValue: {
+				type: "ArrayValue",
+				id: 5
+			},
+			kvlistValue: {
+				type: "KeyValueList",
+				id: 6
+			},
+			bytesValue: {
+				type: "bytes",
+				id: 7
+			}
+		},
+		oneofs: { value: { oneof: [
+			"stringValue",
+			"boolValue",
+			"intValue",
+			"doubleValue",
+			"arrayValue",
+			"kvlistValue",
+			"bytesValue"
+		] } }
+	},
+	ArrayValue: { fields: { values: {
+		rule: "repeated",
+		type: "AnyValue",
+		id: 1
+	} } },
+	KeyValueList: { fields: { values: {
+		rule: "repeated",
+		type: "KeyValue",
+		id: 1
+	} } }
+} };
+let _root = null;
+let _RequestType = null;
+function getRequestType() {
+	if (!_RequestType) {
+		_root = protobufjs.default.Root.fromJSON(protoDescriptor);
+		_RequestType = _root.lookupType("ExportTraceServiceRequest");
+	}
+	return _RequestType;
+}
+function bytesToHex(bytes) {
+	return Buffer.from(bytes).toString("hex");
+}
+function isZeroBytes(bytes) {
+	for (let i = 0; i < bytes.length; i++) if (bytes[i] !== 0) return false;
+	return true;
+}
+/**
+* Convert a protobufjs Long / number / string to a nanosecond string.
+* protobufjs decodes fixed64 as Long when longs are not forced to number.
+*/
+function toNanoString(val) {
+	if (val == null) return "0";
+	if (typeof val === "object" && val !== null && "toString" in val) return val.toString();
+	return String(val);
+}
+/**
+* Normalise an AnyValue from decoded protobuf into the OTLP JSON shape.
+*/
+function normaliseAnyValue(av) {
+	const out = {};
+	if (av.stringValue !== void 0 && av.stringValue !== "") out.stringValue = av.stringValue;
+	if (av.boolValue !== void 0 && av.boolValue !== false) out.boolValue = av.boolValue;
+	if (av.intValue !== void 0) {
+		const v = av.intValue;
+		out.intValue = typeof v === "object" && v !== null && "toNumber" in v ? v.toNumber() : Number(v);
+	}
+	if (av.doubleValue !== void 0 && av.doubleValue !== 0) out.doubleValue = av.doubleValue;
+	if (av.arrayValue !== void 0 && av.arrayValue !== null) out.arrayValue = { values: (av.arrayValue.values ?? []).map((v) => normaliseAnyValue(v)) };
+	if (av.kvlistValue !== void 0 && av.kvlistValue !== null) out.kvlistValue = { values: (av.kvlistValue.values ?? []).map((kv) => normaliseKeyValue(kv)) };
+	if (av.bytesValue !== void 0) out.bytesValue = bytesToHex(av.bytesValue);
+	return out;
+}
+function normaliseKeyValue(kv) {
+	return {
+		key: kv.key,
+		value: normaliseAnyValue(kv.value ?? {})
+	};
+}
+/**
+* Decode an OTLP protobuf-encoded ExportTraceServiceRequest binary into
+* the same JSON structure the handler expects.
+*
+* - bytes fields (trace_id, span_id, parent_span_id) → hex strings
+* - fixed64 nano timestamps → string (for nanoToDate())
+* - Long intValue → number
+* - deprecated instrumentationLibrarySpans merged into scopeSpans
+*/
+function decodeOtlpProtobuf(buffer) {
+	return { resourceSpans: (getRequestType().decode(buffer).resourceSpans ?? []).map((rs) => {
+		const rawResource = rs.resource;
+		return {
+			resource: rawResource ? { attributes: (rawResource.attributes ?? []).map(normaliseKeyValue) } : void 0,
+			scopeSpans: [...rs.scopeSpans ?? [], ...rs.instrumentationLibrarySpans ?? []].map((ss) => {
+				const rawScope = ss.scope;
+				const spans = (ss.spans ?? []).map((s) => {
+					const traceIdBytes = s.traceId;
+					const spanIdBytes = s.spanId;
+					const parentSpanIdBytes = s.parentSpanId;
+					const traceId = traceIdBytes ? bytesToHex(traceIdBytes) : "";
+					const spanId = spanIdBytes ? bytesToHex(spanIdBytes) : "";
+					const parentSpanId = parentSpanIdBytes && parentSpanIdBytes.length > 0 && !isZeroBytes(parentSpanIdBytes) ? bytesToHex(parentSpanIdBytes) : void 0;
+					const attributes = (s.attributes ?? []).map(normaliseKeyValue);
+					const events = (s.events ?? []).map((e) => ({
+						name: e.name ?? "",
+						timeUnixNano: toNanoString(e.timeUnixNano),
+						attributes: (e.attributes ?? []).map(normaliseKeyValue)
+					}));
+					const rawStatus = s.status;
+					return {
+						traceId,
+						spanId,
+						parentSpanId,
+						name: s.name ?? "",
+						kind: s.kind,
+						startTimeUnixNano: toNanoString(s.startTimeUnixNano),
+						endTimeUnixNano: s.endTimeUnixNano ? toNanoString(s.endTimeUnixNano) : void 0,
+						attributes,
+						events: events.length > 0 ? events : void 0,
+						status: rawStatus ? {
+							code: rawStatus.code,
+							message: rawStatus.message
+						} : void 0
+					};
+				});
+				return {
+					scope: rawScope ? {
+						name: rawScope.name,
+						version: rawScope.version
+					} : void 0,
+					spans
+				};
+			})
+		};
+	}) };
+}
+
 //#endregion
 //#region src/server/handlers/otlp/index.ts
 /**
@@ -18876,9 +19191,10 @@ function extractTypedFields(attrs) {
 const pricingProvider = (0, __llmops_core.getDefaultPricingProvider)();
 /**
 * OTLP ingestion endpoint
-* Accepts OTLP JSON (ExportTraceServiceRequest) format
+* Accepts OTLP JSON and Protobuf (ExportTraceServiceRequest) formats
 */
 const app$3 = new hono.Hono().post("/v1/traces", async (c) => {
+	__llmops_core.logger.info(`[OTLP] POST /v1/traces hit — url: ${c.req.url}`);
 	const authHeader = c.req.header("authorization");
 	if (!authHeader) return c.json({ error: "Authorization header required" }, 401);
 	const match = authHeader.match(/^Bearer\s+(.+)$/i);
@@ -18886,11 +19202,20 @@ const app$3 = new hono.Hono().post("/v1/traces", async (c) => {
 	const envSec = match[1].trim();
 	c.set("envSec", envSec);
 	let body;
+	const contentType = c.req.header("content-type") ?? "";
+	__llmops_core.logger.info(`[OTLP] Received request — Content-Type: ${contentType}`);
 	try {
-		body = await c.req.json();
-	} catch {
-		return c.json({ error: "Invalid JSON body" }, 400);
-	}
+		if (contentType.includes("application/x-protobuf") || contentType.includes("application/protobuf")) {
+			const buffer = await c.req.arrayBuffer();
+			__llmops_core.logger.info(`[OTLP] Protobuf body size: ${buffer.byteLength} bytes`);
+			body = decodeOtlpProtobuf(new Uint8Array(buffer));
+		} else body = await c.req.json();
+	} catch (e) {
+		const msg = e instanceof Error ? e.message : String(e);
+		__llmops_core.logger.error(`[OTLP] Failed to parse request body: ${msg}`);
+		return c.json({ error: "Invalid request body" }, 400);
+	}
+	__llmops_core.logger.info(`[OTLP] Parsed body — resourceSpans count: ${body.resourceSpans?.length ?? 0}`);
 	if (!body.resourceSpans || !Array.isArray(body.resourceSpans)) return c.json({ error: "Missing resourceSpans" }, 400);
 	const db = c.get("db");
 	if (!db) return c.json({ error: "Database not configured" }, 503);
@@ -18903,82 +19228,90 @@ const app$3 = new hono.Hono().post("/v1/traces", async (c) => {
 	try {
 		for (const resourceSpan of body.resourceSpans) {
 			const resourceAttrs = attributesToRecord(resourceSpan.resource?.attributes);
-			for (const scopeSpan of resourceSpan.scopeSpans) for (const otlpSpan of scopeSpan.spans) {
-				const allAttrs = {
-					...resourceAttrs,
-					...attributesToRecord(otlpSpan.attributes)
-				};
-				const typed = extractTypedFields(allAttrs);
-				const startTime = nanoToDate(otlpSpan.startTimeUnixNano);
-				const endTime = otlpSpan.endTimeUnixNano ? nanoToDate(otlpSpan.endTimeUnixNano) : null;
-				const durationMs = endTime ? endTime.getTime() - startTime.getTime() : null;
-				const spanStatus = otlpSpan.status?.code ?? 0;
-				const traceStatus = spanStatus === 2 ? "error" : spanStatus === 1 ? "ok" : "unset";
-				let cost = 0;
-				if (typed.provider && typed.model && (typed.promptTokens > 0 || typed.completionTokens > 0)) try {
-					const pricing = await pricingProvider.getModelPricing(typed.provider, typed.model);
-					if (pricing) cost = (0, __llmops_core.calculateCacheAwareCost)({
+			__llmops_core.logger.info(`[OTLP] resourceSpan — scopeSpans count: ${resourceSpan.scopeSpans?.length ?? 0}, resource attrs: ${JSON.stringify(resourceAttrs)}`);
+			for (const scopeSpan of resourceSpan.scopeSpans) {
+				__llmops_core.logger.info(`[OTLP]   scopeSpan — scope: ${scopeSpan.scope?.name ?? "<none>"}, spans count: ${scopeSpan.spans?.length ?? 0}`);
+				for (const otlpSpan of scopeSpan.spans) {
+					__llmops_core.logger.info(`[OTLP]     raw span — traceId: ${otlpSpan.traceId}, spanId: ${otlpSpan.spanId}, parentSpanId: ${otlpSpan.parentSpanId ?? "null"}, name: ${otlpSpan.name}, startTimeUnixNano: ${otlpSpan.startTimeUnixNano}, endTimeUnixNano: ${otlpSpan.endTimeUnixNano ?? "null"}`);
+					const allAttrs = {
+						...resourceAttrs,
+						...attributesToRecord(otlpSpan.attributes)
+					};
+					const typed = extractTypedFields(allAttrs);
+					const startTime = nanoToDate(otlpSpan.startTimeUnixNano);
+					const endTime = otlpSpan.endTimeUnixNano ? nanoToDate(otlpSpan.endTimeUnixNano) : null;
+					const durationMs = endTime ? endTime.getTime() - startTime.getTime() : null;
+					const spanStatus = otlpSpan.status?.code ?? 0;
+					const traceStatus = spanStatus === 2 ? "error" : spanStatus === 1 ? "ok" : "unset";
+					let cost = 0;
+					if (typed.provider && typed.model && (typed.promptTokens > 0 || typed.completionTokens > 0)) try {
+						const pricing = await pricingProvider.getModelPricing(typed.provider, typed.model);
+						if (pricing) cost = (0, __llmops_core.calculateCacheAwareCost)({
+							promptTokens: typed.promptTokens,
+							completionTokens: typed.completionTokens
+						}, pricing, typed.provider).totalCost;
+					} catch (e) {
+						__llmops_core.logger.info(`[OTLP] Failed to calculate cost for ${typed.provider}/${typed.model}: ${e instanceof Error ? e.message : String(e)}`);
+					}
+					const spanData = {
+						traceId: otlpSpan.traceId,
+						spanId: otlpSpan.spanId,
+						parentSpanId: otlpSpan.parentSpanId || null,
+						name: otlpSpan.name,
+						kind: otlpSpan.kind ?? 1,
+						status: spanStatus,
+						statusMessage: otlpSpan.status?.message ?? null,
+						startTime,
+						endTime,
+						durationMs,
+						provider: typed.provider,
+						model: typed.model,
 						promptTokens: typed.promptTokens,
-						completionTokens: typed.completionTokens
-					}, pricing, typed.provider).totalCost;
-				} catch (e) {
-					__llmops_core.logger.debug(`[OTLP] Failed to calculate cost for ${typed.provider}/${typed.model}: ${e instanceof Error ? e.message : String(e)}`);
+						completionTokens: typed.completionTokens,
+						totalTokens: typed.totalTokens,
+						cost,
+						source: "otlp",
+						input: typed.input,
+						output: typed.output,
+						attributes: allAttrs
+					};
+					const spanEvents = (otlpSpan.events ?? []).map((event) => ({
+						traceId: otlpSpan.traceId,
+						spanId: otlpSpan.spanId,
+						name: event.name,
+						timestamp: nanoToDate(event.timeUnixNano),
+						attributes: attributesToRecord(event.attributes)
+					}));
+					const traceData = {
+						traceId: otlpSpan.traceId,
+						name: !otlpSpan.parentSpanId ? otlpSpan.name : null,
+						sessionId: allAttrs["gen_ai.conversation.id"] ?? null,
+						userId: null,
+						status: traceStatus,
+						startTime,
+						endTime,
+						durationMs,
+						spanCount: 1,
+						totalInputTokens: typed.promptTokens,
+						totalOutputTokens: typed.completionTokens,
+						totalTokens: typed.totalTokens,
+						totalCost: cost,
+						tags: {},
+						metadata: {}
+					};
+					__llmops_core.logger.info(`[OTLP]     spanData — traceId: ${spanData.traceId}, spanId: ${spanData.spanId}, parentSpanId: ${spanData.parentSpanId ?? "null"}, name: ${spanData.name}, source: ${spanData.source}, startTime: ${spanData.startTime.toISOString()}, endTime: ${spanData.endTime?.toISOString() ?? "null"}, durationMs: ${spanData.durationMs}`);
+					__llmops_core.logger.info(`[OTLP]     traceData — traceId: ${traceData.traceId}, name: ${traceData.name ?? "null"}, status: ${traceData.status}, spanCount: ${traceData.spanCount}`);
+					const item = {
+						span: spanData,
+						events: spanEvents.length > 0 ? spanEvents : void 0,
+						trace: traceData
+					};
+					traceBatchWriter.enqueue(item);
+					spanCount++;
 				}
-				const spanData = {
-					traceId: otlpSpan.traceId,
-					spanId: otlpSpan.spanId,
-					parentSpanId: otlpSpan.parentSpanId || null,
-					name: otlpSpan.name,
-					kind: otlpSpan.kind ?? 1,
-					status: spanStatus,
-					statusMessage: otlpSpan.status?.message ?? null,
-					startTime,
-					endTime,
-					durationMs,
-					provider: typed.provider,
-					model: typed.model,
-					promptTokens: typed.promptTokens,
-					completionTokens: typed.completionTokens,
-					totalTokens: typed.totalTokens,
-					cost,
-					source: "otlp",
-					input: typed.input,
-					output: typed.output,
-					attributes: allAttrs
-				};
-				const spanEvents = (otlpSpan.events ?? []).map((event) => ({
-					traceId: otlpSpan.traceId,
-					spanId: otlpSpan.spanId,
-					name: event.name,
-					timestamp: nanoToDate(event.timeUnixNano),
-					attributes: attributesToRecord(event.attributes)
-				}));
-				const traceData = {
-					traceId: otlpSpan.traceId,
-					name: !otlpSpan.parentSpanId ? otlpSpan.name : null,
-					sessionId: allAttrs["gen_ai.conversation.id"] ?? null,
-					userId: null,
-					status: traceStatus,
-					startTime,
-					endTime,
-					durationMs,
-					spanCount: 1,
-					totalInputTokens: typed.promptTokens,
-					totalOutputTokens: typed.completionTokens,
-					totalTokens: typed.totalTokens,
-					totalCost: cost,
-					tags: {},
-					metadata: {}
-				};
-				const item = {
-					span: spanData,
-					events: spanEvents.length > 0 ? spanEvents : void 0,
-					trace: traceData
-				};
-				traceBatchWriter.enqueue(item);
-				spanCount++;
 			}
 		}
+		__llmops_core.logger.info(`[OTLP] Enqueued ${spanCount} spans total`);
 		return c.json({ partialSuccess: {} });
 	} catch (error$47) {
 		const msg = error$47 instanceof Error ? error$47.message : String(error$47);

package/dist/index.mjs

@@ -14,6 +14,7 @@ import { prettyJSON } from "hono/pretty-json";
 import { cors } from "hono/cors";
 import { randomBytes, randomUUID } from "node:crypto";
 import gateway from "@llmops/gateway";
+import protobuf from "protobufjs";
 import { env } from "node:process";
 import { createDatabaseFromConnection, detectDatabaseType } from "@llmops/core/db";
 import { betterAuth } from "better-auth";
@@ -18259,6 +18260,7 @@ function createTraceBatchWriter(deps, config$1 = {}) {
 		const batch = queue;
 		queue = [];
 		try {
+			logger.info(`[TraceBatchWriter] Flushing ${batch.length} items`);
 			log(`[TraceBatchWriter] Flushing ${batch.length} items`);
 			const traceMap = /* @__PURE__ */ new Map();
 			for (const item of batch) {
@@ -18292,6 +18294,7 @@ function createTraceBatchWriter(deps, config$1 = {}) {
 			if (allSpans.length > 0) await deps.batchInsertSpans(allSpans);
 			const allEvents = batch.flatMap((item) => item.events ?? []);
 			if (allEvents.length > 0) await deps.batchInsertSpanEvents(allEvents);
+			logger.info(`[TraceBatchWriter] Flushed ${traceMap.size} traces, ${allSpans.length} spans, ${allEvents.length} events`);
 			log(`[TraceBatchWriter] Flushed ${traceMap.size} traces, ${allSpans.length} spans, ${allEvents.length} events`);
 		} catch (error$47) {
 			const errorMsg = error$47 instanceof Error ? error$47.message : String(error$47);
@@ -18780,6 +18783,317 @@ app$4.use("*", prettyJSON()).get("/health", async (c) => {
 });
 var genai_default = app$4;
 
+//#endregion
+//#region src/server/handlers/otlp/decode.ts
+/**
+* OTLP Protobuf Decoder
+*
+* Decodes binary protobuf ExportTraceServiceRequest into the same JSON
+* structure the OTLP handler already expects. Uses an embedded protobufjs
+* JSON descriptor — no .proto files needed at runtime.
+*/
+const protoDescriptor = { nested: {
+	ExportTraceServiceRequest: { fields: { resourceSpans: {
+		rule: "repeated",
+		type: "ResourceSpans",
+		id: 1
+	} } },
+	ResourceSpans: { fields: {
+		resource: {
+			type: "Resource",
+			id: 1
+		},
+		scopeSpans: {
+			rule: "repeated",
+			type: "ScopeSpans",
+			id: 2
+		},
+		instrumentationLibrarySpans: {
+			rule: "repeated",
+			type: "ScopeSpans",
+			id: 1e3
+		}
+	} },
+	Resource: { fields: { attributes: {
+		rule: "repeated",
+		type: "KeyValue",
+		id: 1
+	} } },
+	ScopeSpans: { fields: {
+		scope: {
+			type: "InstrumentationScope",
+			id: 1
+		},
+		spans: {
+			rule: "repeated",
+			type: "Span",
+			id: 2
+		}
+	} },
+	InstrumentationScope: { fields: {
+		name: {
+			type: "string",
+			id: 1
+		},
+		version: {
+			type: "string",
+			id: 2
+		}
+	} },
+	Span: { fields: {
+		traceId: {
+			type: "bytes",
+			id: 1
+		},
+		spanId: {
+			type: "bytes",
+			id: 2
+		},
+		traceState: {
+			type: "string",
+			id: 3
+		},
+		parentSpanId: {
+			type: "bytes",
+			id: 4
+		},
+		name: {
+			type: "string",
+			id: 5
+		},
+		kind: {
+			type: "SpanKind",
+			id: 6
+		},
+		startTimeUnixNano: {
+			type: "fixed64",
+			id: 7
+		},
+		endTimeUnixNano: {
+			type: "fixed64",
+			id: 8
+		},
+		attributes: {
+			rule: "repeated",
+			type: "KeyValue",
+			id: 9
+		},
+		events: {
+			rule: "repeated",
+			type: "SpanEvent",
+			id: 10
+		},
+		status: {
+			type: "Status",
+			id: 15
+		}
+	} },
+	SpanKind: { values: {
+		SPAN_KIND_UNSPECIFIED: 0,
+		SPAN_KIND_INTERNAL: 1,
+		SPAN_KIND_SERVER: 2,
+		SPAN_KIND_CLIENT: 3,
+		SPAN_KIND_PRODUCER: 4,
+		SPAN_KIND_CONSUMER: 5
+	} },
+	SpanEvent: { fields: {
+		timeUnixNano: {
+			type: "fixed64",
+			id: 1
+		},
+		name: {
+			type: "string",
+			id: 2
+		},
+		attributes: {
+			rule: "repeated",
+			type: "KeyValue",
+			id: 3
+		}
+	} },
+	Status: { fields: {
+		message: {
+			type: "string",
+			id: 2
+		},
+		code: {
+			type: "StatusCode",
+			id: 3
+		}
+	} },
+	StatusCode: { values: {
+		STATUS_CODE_UNSET: 0,
+		STATUS_CODE_OK: 1,
+		STATUS_CODE_ERROR: 2
+	} },
+	KeyValue: { fields: {
+		key: {
+			type: "string",
+			id: 1
+		},
+		value: {
+			type: "AnyValue",
+			id: 2
+		}
+	} },
+	AnyValue: {
+		fields: {
+			stringValue: {
+				type: "string",
+				id: 1
+			},
+			boolValue: {
+				type: "bool",
+				id: 2
+			},
+			intValue: {
+				type: "int64",
+				id: 3
+			},
+			doubleValue: {
+				type: "double",
+				id: 4
+			},
+			arrayValue: {
+				type: "ArrayValue",
+				id: 5
+			},
+			kvlistValue: {
+				type: "KeyValueList",
+				id: 6
+			},
+			bytesValue: {
+				type: "bytes",
+				id: 7
+			}
+		},
+		oneofs: { value: { oneof: [
+			"stringValue",
+			"boolValue",
+			"intValue",
+			"doubleValue",
+			"arrayValue",
+			"kvlistValue",
+			"bytesValue"
+		] } }
+	},
+	ArrayValue: { fields: { values: {
+		rule: "repeated",
+		type: "AnyValue",
+		id: 1
+	} } },
+	KeyValueList: { fields: { values: {
+		rule: "repeated",
+		type: "KeyValue",
+		id: 1
+	} } }
+} };
+let _root = null;
+let _RequestType = null;
+function getRequestType() {
+	if (!_RequestType) {
+		_root = protobuf.Root.fromJSON(protoDescriptor);
+		_RequestType = _root.lookupType("ExportTraceServiceRequest");
+	}
+	return _RequestType;
+}
+function bytesToHex(bytes) {
+	return Buffer.from(bytes).toString("hex");
+}
+function isZeroBytes(bytes) {
+	for (let i = 0; i < bytes.length; i++) if (bytes[i] !== 0) return false;
+	return true;
+}
+/**
+* Convert a protobufjs Long / number / string to a nanosecond string.
+* protobufjs decodes fixed64 as Long when longs are not forced to number.
+*/
+function toNanoString(val) {
+	if (val == null) return "0";
+	if (typeof val === "object" && val !== null && "toString" in val) return val.toString();
+	return String(val);
+}
+/**
+* Normalise an AnyValue from decoded protobuf into the OTLP JSON shape.
+*/
+function normaliseAnyValue(av) {
+	const out = {};
+	if (av.stringValue !== void 0 && av.stringValue !== "") out.stringValue = av.stringValue;
+	if (av.boolValue !== void 0 && av.boolValue !== false) out.boolValue = av.boolValue;
+	if (av.intValue !== void 0) {
+		const v = av.intValue;
+		out.intValue = typeof v === "object" && v !== null && "toNumber" in v ? v.toNumber() : Number(v);
+	}
+	if (av.doubleValue !== void 0 && av.doubleValue !== 0) out.doubleValue = av.doubleValue;
+	if (av.arrayValue !== void 0 && av.arrayValue !== null) out.arrayValue = { values: (av.arrayValue.values ?? []).map((v) => normaliseAnyValue(v)) };
+	if (av.kvlistValue !== void 0 && av.kvlistValue !== null) out.kvlistValue = { values: (av.kvlistValue.values ?? []).map((kv) => normaliseKeyValue(kv)) };
+	if (av.bytesValue !== void 0) out.bytesValue = bytesToHex(av.bytesValue);
+	return out;
+}
+function normaliseKeyValue(kv) {
+	return {
+		key: kv.key,
+		value: normaliseAnyValue(kv.value ?? {})
+	};
+}
+/**
+* Decode an OTLP protobuf-encoded ExportTraceServiceRequest binary into
+* the same JSON structure the handler expects.
+*
+* - bytes fields (trace_id, span_id, parent_span_id) → hex strings
+* - fixed64 nano timestamps → string (for nanoToDate())
+* - Long intValue → number
+* - deprecated instrumentationLibrarySpans merged into scopeSpans
+*/
+function decodeOtlpProtobuf(buffer) {
+	return { resourceSpans: (getRequestType().decode(buffer).resourceSpans ?? []).map((rs) => {
+		const rawResource = rs.resource;
+		return {
+			resource: rawResource ? { attributes: (rawResource.attributes ?? []).map(normaliseKeyValue) } : void 0,
+			scopeSpans: [...rs.scopeSpans ?? [], ...rs.instrumentationLibrarySpans ?? []].map((ss) => {
+				const rawScope = ss.scope;
+				const spans = (ss.spans ?? []).map((s) => {
+					const traceIdBytes = s.traceId;
+					const spanIdBytes = s.spanId;
+					const parentSpanIdBytes = s.parentSpanId;
+					const traceId = traceIdBytes ? bytesToHex(traceIdBytes) : "";
+					const spanId = spanIdBytes ? bytesToHex(spanIdBytes) : "";
+					const parentSpanId = parentSpanIdBytes && parentSpanIdBytes.length > 0 && !isZeroBytes(parentSpanIdBytes) ? bytesToHex(parentSpanIdBytes) : void 0;
+					const attributes = (s.attributes ?? []).map(normaliseKeyValue);
+					const events = (s.events ?? []).map((e) => ({
+						name: e.name ?? "",
+						timeUnixNano: toNanoString(e.timeUnixNano),
+						attributes: (e.attributes ?? []).map(normaliseKeyValue)
+					}));
+					const rawStatus = s.status;
+					return {
+						traceId,
+						spanId,
+						parentSpanId,
+						name: s.name ?? "",
+						kind: s.kind,
+						startTimeUnixNano: toNanoString(s.startTimeUnixNano),
+						endTimeUnixNano: s.endTimeUnixNano ? toNanoString(s.endTimeUnixNano) : void 0,
+						attributes,
+						events: events.length > 0 ? events : void 0,
+						status: rawStatus ? {
+							code: rawStatus.code,
+							message: rawStatus.message
+						} : void 0
+					};
+				});
+				return {
+					scope: rawScope ? {
+						name: rawScope.name,
+						version: rawScope.version
+					} : void 0,
+					spans
+				};
+			})
+		};
+	}) };
+}
+
 //#endregion
 //#region src/server/handlers/otlp/index.ts
 /**
@@ -18848,9 +19162,10 @@ function extractTypedFields(attrs) {
 const pricingProvider = getDefaultPricingProvider();
 /**
 * OTLP ingestion endpoint
-* Accepts OTLP JSON (ExportTraceServiceRequest) format
+* Accepts OTLP JSON and Protobuf (ExportTraceServiceRequest) formats
 */
 const app$3 = new Hono().post("/v1/traces", async (c) => {
+	logger.info(`[OTLP] POST /v1/traces hit — url: ${c.req.url}`);
 	const authHeader = c.req.header("authorization");
 	if (!authHeader) return c.json({ error: "Authorization header required" }, 401);
 	const match = authHeader.match(/^Bearer\s+(.+)$/i);
@@ -18858,11 +19173,20 @@ const app$3 = new Hono().post("/v1/traces", async (c) => {
 	const envSec = match[1].trim();
 	c.set("envSec", envSec);
 	let body;
+	const contentType = c.req.header("content-type") ?? "";
+	logger.info(`[OTLP] Received request — Content-Type: ${contentType}`);
 	try {
-		body = await c.req.json();
-	} catch {
-		return c.json({ error: "Invalid JSON body" }, 400);
-	}
+		if (contentType.includes("application/x-protobuf") || contentType.includes("application/protobuf")) {
+			const buffer = await c.req.arrayBuffer();
+			logger.info(`[OTLP] Protobuf body size: ${buffer.byteLength} bytes`);
+			body = decodeOtlpProtobuf(new Uint8Array(buffer));
+		} else body = await c.req.json();
+	} catch (e) {
+		const msg = e instanceof Error ? e.message : String(e);
+		logger.error(`[OTLP] Failed to parse request body: ${msg}`);
+		return c.json({ error: "Invalid request body" }, 400);
+	}
+	logger.info(`[OTLP] Parsed body — resourceSpans count: ${body.resourceSpans?.length ?? 0}`);
 	if (!body.resourceSpans || !Array.isArray(body.resourceSpans)) return c.json({ error: "Missing resourceSpans" }, 400);
 	const db = c.get("db");
 	if (!db) return c.json({ error: "Database not configured" }, 503);
@@ -18875,82 +19199,90 @@ const app$3 = new Hono().post("/v1/traces", async (c) => {
 	try {
 		for (const resourceSpan of body.resourceSpans) {
 			const resourceAttrs = attributesToRecord(resourceSpan.resource?.attributes);
-			for (const scopeSpan of resourceSpan.scopeSpans) for (const otlpSpan of scopeSpan.spans) {
-				const allAttrs = {
-					...resourceAttrs,
-					...attributesToRecord(otlpSpan.attributes)
-				};
-				const typed = extractTypedFields(allAttrs);
-				const startTime = nanoToDate(otlpSpan.startTimeUnixNano);
-				const endTime = otlpSpan.endTimeUnixNano ? nanoToDate(otlpSpan.endTimeUnixNano) : null;
-				const durationMs = endTime ? endTime.getTime() - startTime.getTime() : null;
-				const spanStatus = otlpSpan.status?.code ?? 0;
-				const traceStatus = spanStatus === 2 ? "error" : spanStatus === 1 ? "ok" : "unset";
-				let cost = 0;
-				if (typed.provider && typed.model && (typed.promptTokens > 0 || typed.completionTokens > 0)) try {
-					const pricing = await pricingProvider.getModelPricing(typed.provider, typed.model);
-					if (pricing) cost = calculateCacheAwareCost({
+			logger.info(`[OTLP] resourceSpan — scopeSpans count: ${resourceSpan.scopeSpans?.length ?? 0}, resource attrs: ${JSON.stringify(resourceAttrs)}`);
+			for (const scopeSpan of resourceSpan.scopeSpans) {
+				logger.info(`[OTLP]   scopeSpan — scope: ${scopeSpan.scope?.name ?? "<none>"}, spans count: ${scopeSpan.spans?.length ?? 0}`);
+				for (const otlpSpan of scopeSpan.spans) {
+					logger.info(`[OTLP]     raw span — traceId: ${otlpSpan.traceId}, spanId: ${otlpSpan.spanId}, parentSpanId: ${otlpSpan.parentSpanId ?? "null"}, name: ${otlpSpan.name}, startTimeUnixNano: ${otlpSpan.startTimeUnixNano}, endTimeUnixNano: ${otlpSpan.endTimeUnixNano ?? "null"}`);
+					const allAttrs = {
+						...resourceAttrs,
+						...attributesToRecord(otlpSpan.attributes)
+					};
+					const typed = extractTypedFields(allAttrs);
+					const startTime = nanoToDate(otlpSpan.startTimeUnixNano);
+					const endTime = otlpSpan.endTimeUnixNano ? nanoToDate(otlpSpan.endTimeUnixNano) : null;
+					const durationMs = endTime ? endTime.getTime() - startTime.getTime() : null;
+					const spanStatus = otlpSpan.status?.code ?? 0;
+					const traceStatus = spanStatus === 2 ? "error" : spanStatus === 1 ? "ok" : "unset";
+					let cost = 0;
+					if (typed.provider && typed.model && (typed.promptTokens > 0 || typed.completionTokens > 0)) try {
+						const pricing = await pricingProvider.getModelPricing(typed.provider, typed.model);
+						if (pricing) cost = calculateCacheAwareCost({
+							promptTokens: typed.promptTokens,
+							completionTokens: typed.completionTokens
+						}, pricing, typed.provider).totalCost;
+					} catch (e) {
+						logger.info(`[OTLP] Failed to calculate cost for ${typed.provider}/${typed.model}: ${e instanceof Error ? e.message : String(e)}`);
+					}
+					const spanData = {
+						traceId: otlpSpan.traceId,
+						spanId: otlpSpan.spanId,
+						parentSpanId: otlpSpan.parentSpanId || null,
+						name: otlpSpan.name,
+						kind: otlpSpan.kind ?? 1,
+						status: spanStatus,
+						statusMessage: otlpSpan.status?.message ?? null,
+						startTime,
+						endTime,
+						durationMs,
+						provider: typed.provider,
+						model: typed.model,
 						promptTokens: typed.promptTokens,
-						completionTokens: typed.completionTokens
-					}, pricing, typed.provider).totalCost;
-				} catch (e) {
-					logger.debug(`[OTLP] Failed to calculate cost for ${typed.provider}/${typed.model}: ${e instanceof Error ? e.message : String(e)}`);
+						completionTokens: typed.completionTokens,
+						totalTokens: typed.totalTokens,
+						cost,
+						source: "otlp",
+						input: typed.input,
+						output: typed.output,
+						attributes: allAttrs
+					};
+					const spanEvents = (otlpSpan.events ?? []).map((event) => ({
+						traceId: otlpSpan.traceId,
+						spanId: otlpSpan.spanId,
+						name: event.name,
+						timestamp: nanoToDate(event.timeUnixNano),
+						attributes: attributesToRecord(event.attributes)
+					}));
+					const traceData = {
+						traceId: otlpSpan.traceId,
+						name: !otlpSpan.parentSpanId ? otlpSpan.name : null,
+						sessionId: allAttrs["gen_ai.conversation.id"] ?? null,
+						userId: null,
+						status: traceStatus,
+						startTime,
+						endTime,
+						durationMs,
+						spanCount: 1,
+						totalInputTokens: typed.promptTokens,
+						totalOutputTokens: typed.completionTokens,
+						totalTokens: typed.totalTokens,
+						totalCost: cost,
+						tags: {},
+						metadata: {}
+					};
+					logger.info(`[OTLP]     spanData — traceId: ${spanData.traceId}, spanId: ${spanData.spanId}, parentSpanId: ${spanData.parentSpanId ?? "null"}, name: ${spanData.name}, source: ${spanData.source}, startTime: ${spanData.startTime.toISOString()}, endTime: ${spanData.endTime?.toISOString() ?? "null"}, durationMs: ${spanData.durationMs}`);
+					logger.info(`[OTLP]     traceData — traceId: ${traceData.traceId}, name: ${traceData.name ?? "null"}, status: ${traceData.status}, spanCount: ${traceData.spanCount}`);
+					const item = {
+						span: spanData,
+						events: spanEvents.length > 0 ? spanEvents : void 0,
+						trace: traceData
+					};
+					traceBatchWriter.enqueue(item);
+					spanCount++;
 				}
-				const spanData = {
-					traceId: otlpSpan.traceId,
-					spanId: otlpSpan.spanId,
-					parentSpanId: otlpSpan.parentSpanId || null,
-					name: otlpSpan.name,
-					kind: otlpSpan.kind ?? 1,
-					status: spanStatus,
-					statusMessage: otlpSpan.status?.message ?? null,
-					startTime,
-					endTime,
-					durationMs,
-					provider: typed.provider,
-					model: typed.model,
-					promptTokens: typed.promptTokens,
-					completionTokens: typed.completionTokens,
-					totalTokens: typed.totalTokens,
-					cost,
-					source: "otlp",
-					input: typed.input,
-					output: typed.output,
-					attributes: allAttrs
-				};
-				const spanEvents = (otlpSpan.events ?? []).map((event) => ({
-					traceId: otlpSpan.traceId,
-					spanId: otlpSpan.spanId,
-					name: event.name,
-					timestamp: nanoToDate(event.timeUnixNano),
-					attributes: attributesToRecord(event.attributes)
-				}));
-				const traceData = {
-					traceId: otlpSpan.traceId,
-					name: !otlpSpan.parentSpanId ? otlpSpan.name : null,
-					sessionId: allAttrs["gen_ai.conversation.id"] ?? null,
-					userId: null,
-					status: traceStatus,
-					startTime,
-					endTime,
-					durationMs,
-					spanCount: 1,
-					totalInputTokens: typed.promptTokens,
-					totalOutputTokens: typed.completionTokens,
-					totalTokens: typed.totalTokens,
-					totalCost: cost,
-					tags: {},
-					metadata: {}
-				};
-				const item = {
-					span: spanData,
-					events: spanEvents.length > 0 ? spanEvents : void 0,
-					trace: traceData
-				};
-				traceBatchWriter.enqueue(item);
-				spanCount++;
 			}
 		}
+		logger.info(`[OTLP] Enqueued ${spanCount} spans total`);
 		return c.json({ partialSuccess: {} });
 	} catch (error$47) {
 		const msg = error$47 instanceof Error ? error$47.message : String(error$47);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llmops/app",
-  "version": "0.6.3-beta.1",
+  "version": "0.6.5",
   "description": "LLMOps application with server and client",
   "type": "module",
   "license": "Apache-2.0",
@@ -72,12 +72,13 @@
     "motion": "^12.23.25",
     "nunjucks": "^3.2.4",
     "openai": "^6.10.0",
+    "protobufjs": "^8.0.0",
     "react-aria-components": "^1.13.0",
     "react-hook-form": "^7.68.0",
     "recharts": "^3.6.0",
     "uuid": "^13.0.0",
-    "@llmops/core": "^0.6.3-beta.1",
-    "@llmops/gateway": "^0.6.3-beta.1"
+    "@llmops/core": "^0.6.5",
+    "@llmops/gateway": "^0.6.5"
   },
   "peerDependencies": {
     "react": "^19.2.1",