@loongsuite/otel-util-genai 0.1.0-beta.0

package/dist/event-log/grouping.js

@@ -0,0 +1,241 @@
+// Copyright The OpenTelemetry Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import { EventName, } from "./types.js";
+import { isValidTraceId } from "./parent-context.js";
+import { readNanoMs } from "./field-mapping.js";
+/**
+ * Candidate predicate for "user-input hook" llm.request events.
+ *
+ * Rule: an llm.request that has neither gen_ai.step.id nor
+ * gen_ai.request.model is a structural sign that the plugin is using
+ * llm.request to mark user-prompt submission (not a real LLM API call).
+ *
+ * This is only the structural check; the converter must also verify the
+ * event has no matching llm.response in the turn before routing it to ENTRY.
+ */
+export function isUserHookCandidate(record) {
+    return (record["event.name"] === EventName.LLM_REQUEST &&
+        !record["gen_ai.step.id"] &&
+        !record["gen_ai.request.model"]);
+}
+/**
+ * Within a turn's records, identify which llm.request events should be
+ * treated as user-hook prompts (merged into ENTRY) versus kept for normal
+ * LLM-span generation.
+ *
+ * Rule: structural candidate (no step.id, no model) AND no peer llm.response
+ * that could conceivably pair with it. A real LLM call always has step.id,
+ * so its response also has step.id. A user-hook candidate (no step.id) can
+ * only legitimately pair with a no-step llm.response — which never exists
+ * in well-formed data. So we declare the candidate user-hook iff there is
+ * no llm.response in the same turn that also lacks step.id.
+ *
+ * This avoids cross-step mispairing (where the time-ordered pairLlm could
+ * otherwise greedy-match a candidate with a later step's response).
+ */
+export function partitionUserHookRequests(turnRecords) {
+    const candidates = turnRecords.filter(isUserHookCandidate);
+    if (candidates.length === 0) {
+        return { userHooks: [], remaining: turnRecords };
+    }
+    // Are there any llm.response events that could pair with no-step candidates?
+    // A no-step response would be needed to legitimately pair with a no-step
+    // candidate. In practice none exists; this guard keeps the rule strict.
+    const noStepResponses = turnRecords.filter((r) => r["event.name"] === EventName.LLM_RESPONSE && !r["gen_ai.step.id"]);
+    // Assign candidates to user-hooks in time order until we run out of
+    // potential pair-mates. Remaining candidates are user-hooks.
+    const sortedCandidates = [...candidates].sort((a, b) => readNanoMs(a["time_unix_nano"]) - readNanoMs(b["time_unix_nano"]));
+    const userHookSet = new Set(sortedCandidates.slice(noStepResponses.length));
+    const userHooks = [];
+    const remaining = [];
+    for (const r of turnRecords) {
+        if (userHookSet.has(r))
+            userHooks.push(r);
+        else
+            remaining.push(r);
+    }
+    return { userHooks, remaining };
+}
+function getStr(record, key) {
+    const v = record[key];
+    return typeof v === "string" && v.length > 0 ? v : undefined;
+}
+function turnKey(record) {
+    const turnId = getStr(record, "gen_ai.turn.id");
+    if (turnId)
+        return `turn:${turnId}`;
+    const sessionId = getStr(record, "gen_ai.session.id");
+    if (sessionId)
+        return `session:${sessionId}`;
+    return "__no_turn__";
+}
+/**
+ * Group records by turn. Insertion order of turns is preserved (matches order
+ * the first record of each turn appears in the input).
+ *
+ * If multiple records within a turn carry different trace_id values the
+ * first valid one wins and a warning is pushed.
+ */
+export function groupByTurn(records, warnings) {
+    const map = new Map();
+    // De-dup warning keys so a turn with N misaligned records emits 1 message
+    // instead of N — real-world traffic with a buggy upstream can otherwise
+    // flood diag logs.
+    const seenWarnings = new Set();
+    for (const record of records) {
+        const key = turnKey(record);
+        let group = map.get(key);
+        if (!group) {
+            group = {
+                turnId: getStr(record, "gen_ai.turn.id"),
+                sessionId: getStr(record, "gen_ai.session.id"),
+                traceId: undefined,
+                records: [],
+            };
+            map.set(key, group);
+        }
+        group.records.push(record);
+        const candidate = record["trace_id"];
+        if (isValidTraceId(candidate)) {
+            if (group.traceId === undefined) {
+                group.traceId = candidate;
+            }
+            else if (group.traceId !== candidate) {
+                const wKey = `inconsistent:${key}:${group.traceId}:${candidate}`;
+                if (!seenWarnings.has(wKey)) {
+                    seenWarnings.add(wKey);
+                    warnings.push(`Inconsistent trace_id within turn ${group.turnId ?? "(no turn.id)"}: kept ${group.traceId}, saw ${candidate}`);
+                }
+            }
+        }
+        else if (candidate !== undefined && candidate !== null && candidate !== "") {
+            const wKey = `invalid:${key}:${String(candidate)}`;
+            if (!seenWarnings.has(wKey)) {
+                seenWarnings.add(wKey);
+                warnings.push(`Invalid trace_id "${String(candidate)}" in turn ${group.turnId ?? "(no turn.id)"}; SDK will allocate one`);
+            }
+        }
+    }
+    return [...map.values()];
+}
+/**
+ * Group records within a turn by gen_ai.step.id. Records missing step.id are
+ * placed into a synthetic "__no_step__" group, which still produces one STEP
+ * span downstream.
+ *
+ * Insertion order is preserved.
+ */
+export function groupByStep(records) {
+    const map = new Map();
+    for (const record of records) {
+        const key = getStr(record, "gen_ai.step.id") ?? "__no_step__";
+        let group = map.get(key);
+        if (!group) {
+            group = {
+                stepId: getStr(record, "gen_ai.step.id"),
+                records: [],
+            };
+            map.set(key, group);
+        }
+        group.records.push(record);
+    }
+    return [...map.values()];
+}
+/**
+ * Pair llm.request with the following llm.response within the same step.
+ *
+ * Matching rules (in order):
+ *   1. If both records share a non-empty gen_ai.response.id, prefer ID match.
+ *      (response.id appears on the response and sometimes is mirrored back to
+ *      the request by the producer.)
+ *   2. Otherwise pair each request with the next unpaired response in
+ *      time_unix_nano order.
+ *
+ * Orphan request/response records are returned as pairs with the other side
+ * undefined.
+ */
+export function pairLlm(records, warnings) {
+    const requests = records
+        .filter((r) => r["event.name"] === EventName.LLM_REQUEST)
+        .slice()
+        .sort((a, b) => readNanoMs(a["time_unix_nano"]) - readNanoMs(b["time_unix_nano"]));
+    const responses = records
+        .filter((r) => r["event.name"] === EventName.LLM_RESPONSE)
+        .slice()
+        .sort((a, b) => readNanoMs(a["time_unix_nano"]) - readNanoMs(b["time_unix_nano"]));
+    const pairs = [];
+    const consumedResponses = new Set();
+    for (const req of requests) {
+        const reqRespId = getStr(req, "gen_ai.response.id");
+        let resp;
+        if (reqRespId) {
+            resp = responses.find((r) => !consumedResponses.has(r) && getStr(r, "gen_ai.response.id") === reqRespId);
+        }
+        if (!resp) {
+            resp = responses.find((r) => !consumedResponses.has(r));
+        }
+        if (resp) {
+            consumedResponses.add(resp);
+            pairs.push({ request: req, response: resp });
+        }
+        else {
+            warnings.push(`Orphan llm.request (event.id=${getStr(req, "event.id") ?? "?"}): no matching llm.response in step`);
+            pairs.push({ request: req });
+        }
+    }
+    for (const resp of responses) {
+        if (!consumedResponses.has(resp)) {
+            warnings.push(`Orphan llm.response (event.id=${getStr(resp, "event.id") ?? "?"}): no preceding llm.request in step`);
+            pairs.push({ response: resp });
+        }
+    }
+    return pairs;
+}
+/**
+ * Pair tool.call with tool.result by gen_ai.tool.call.id. Orphans are
+ * returned with the missing side undefined.
+ */
+export function pairTool(records, warnings) {
+    const calls = records.filter((r) => r["event.name"] === EventName.TOOL_CALL);
+    const results = records.filter((r) => r["event.name"] === EventName.TOOL_RESULT);
+    const consumedResults = new Set();
+    const pairs = [];
+    for (const call of calls) {
+        const callId = getStr(call, "gen_ai.tool.call.id");
+        let result;
+        if (callId) {
+            result = results.find((r) => !consumedResults.has(r) && getStr(r, "gen_ai.tool.call.id") === callId);
+        }
+        if (!result) {
+            // Fallback: first unconsumed result without id
+            result = results.find((r) => !consumedResults.has(r));
+        }
+        if (result) {
+            consumedResults.add(result);
+            pairs.push({ call, result });
+        }
+        else {
+            warnings.push(`Orphan tool.call (tool.call.id=${callId ?? "?"}): no matching tool.result in step`);
+            pairs.push({ call });
+        }
+    }
+    for (const result of results) {
+        if (!consumedResults.has(result)) {
+            warnings.push(`Orphan tool.result (tool.call.id=${getStr(result, "gen_ai.tool.call.id") ?? "?"}): no preceding tool.call in step`);
+            pairs.push({ result });
+        }
+    }
+    return pairs;
+}
+//# sourceMappingURL=grouping.js.map

package/dist/event-log/grouping.js.map

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

package/dist/event-log/index.d.ts

@@ -0,0 +1,5 @@
+export { convertEventLogToTrace } from "./converter.js";
+export { convertEventLogToReadableSpans, type ReadableSpansResult, } from "./readable-spans.js";
+export { EventName, EventLogConversionError, type EventLogRecord, type EventNameValue, type ConvertOptions, type ConvertResult, } from "./types.js";
+export { isValidTraceId, createTraceParentContext } from "./parent-context.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/event-log/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/event-log/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EACL,8BAA8B,EAC9B,KAAK,mBAAmB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,SAAS,EACT,uBAAuB,EACvB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/event-log/index.js

@@ -0,0 +1,18 @@
+// Copyright The OpenTelemetry Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+export { convertEventLogToTrace } from "./converter.js";
+export { convertEventLogToReadableSpans, } from "./readable-spans.js";
+export { EventName, EventLogConversionError, } from "./types.js";
+export { isValidTraceId, createTraceParentContext } from "./parent-context.js";
+//# sourceMappingURL=index.js.map

package/dist/event-log/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/event-log/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EACL,8BAA8B,GAE/B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,SAAS,EACT,uBAAuB,GAKxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/event-log/parent-context.d.ts

@@ -0,0 +1,14 @@
+import { type Context } from "@opentelemetry/api";
+/** True if value is a valid lowercase 32-hex trace_id and not all zeros. */
+export declare function isValidTraceId(value: unknown): value is string;
+/**
+ * Build a non-recording parent Context that carries the given trace_id so any
+ * child span created with this context inherits the same trace_id.
+ *
+ * The synthetic parent spanId is arbitrary — ENTRY spans use this as their
+ * parentSpanId, but ARMS/OTel consumers do not look it up (it has no
+ * corresponding real span). isRemote=true marks the parent as external, which
+ * is the correct semantic when reconstructing spans from out-of-band events.
+ */
+export declare function createTraceParentContext(traceId: string): Context;
+//# sourceMappingURL=parent-context.d.ts.map

package/dist/event-log/parent-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parent-context.d.ts","sourceRoot":"","sources":["../../src/event-log/parent-context.ts"],"names":[],"mappings":"AAcA,OAAO,EAIL,KAAK,OAAO,EAEb,MAAM,oBAAoB,CAAC;AAK5B,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAK9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAQjE"}

package/dist/event-log/parent-context.js

@@ -0,0 +1,45 @@
+// Copyright The OpenTelemetry Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import { ROOT_CONTEXT, TraceFlags, trace, } from "@opentelemetry/api";
+const TRACE_ID_REGEX = /^[0-9a-f]{32}$/;
+const ALL_ZERO_TRACE_ID = "0".repeat(32);
+/** True if value is a valid lowercase 32-hex trace_id and not all zeros. */
+export function isValidTraceId(value) {
+    if (typeof value !== "string")
+        return false;
+    if (!TRACE_ID_REGEX.test(value))
+        return false;
+    if (value === ALL_ZERO_TRACE_ID)
+        return false;
+    return true;
+}
+/**
+ * Build a non-recording parent Context that carries the given trace_id so any
+ * child span created with this context inherits the same trace_id.
+ *
+ * The synthetic parent spanId is arbitrary — ENTRY spans use this as their
+ * parentSpanId, but ARMS/OTel consumers do not look it up (it has no
+ * corresponding real span). isRemote=true marks the parent as external, which
+ * is the correct semantic when reconstructing spans from out-of-band events.
+ */
+export function createTraceParentContext(traceId) {
+    const spanContext = {
+        traceId,
+        spanId: "0".repeat(15) + "1", // any valid non-zero 16-hex
+        traceFlags: TraceFlags.SAMPLED,
+        isRemote: true,
+    };
+    return trace.setSpan(ROOT_CONTEXT, trace.wrapSpanContext(spanContext));
+}
+//# sourceMappingURL=parent-context.js.map

package/dist/event-log/parent-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parent-context.js","sourceRoot":"","sources":["../../src/event-log/parent-context.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,OAAO,EACL,YAAY,EACZ,UAAU,EACV,KAAK,GAGN,MAAM,oBAAoB,CAAC;AAE5B,MAAM,cAAc,GAAG,gBAAgB,CAAC;AACxC,MAAM,iBAAiB,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEzC,4EAA4E;AAC5E,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9C,IAAI,KAAK,KAAK,iBAAiB;QAAE,OAAO,KAAK,CAAC;IAC9C,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAe;IACtD,MAAM,WAAW,GAAgB;QAC/B,OAAO;QACP,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,4BAA4B;QAC1D,UAAU,EAAE,UAAU,CAAC,OAAO;QAC9B,QAAQ,EAAE,IAAI;KACf,CAAC;IACF,OAAO,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC;AACzE,CAAC"}

package/dist/event-log/readable-spans.d.ts

@@ -0,0 +1,36 @@
+import type { ReadableSpan } from "@opentelemetry/sdk-trace-base";
+import type { ConvertOptions, EventLogRecord } from "./types.js";
+export interface ReadableSpansResult {
+    /** Finished spans ready to feed into OTLPTraceExporter.export(). */
+    spans: ReadableSpan[];
+    /** trace_id per turn (in input order). */
+    traceIds: string[];
+    /** Non-fatal issues collected during conversion (always returned, never thrown unless strict). */
+    warnings: string[];
+}
+/**
+ * High-level helper that converts an event log into a flat list of
+ * {@link ReadableSpan}s ready to be fed into an OTLPTraceExporter.
+ *
+ * Internally this wires a private BasicTracerProvider + InMemorySpanExporter,
+ * runs {@link convertEventLogToTrace}, flushes, and returns the captured
+ * spans. The provider is **never** registered globally — it lives only for
+ * the duration of this call.
+ *
+ * Use this when:
+ *   - You want a pure function-style API that yields ReadableSpan[] data,
+ *     e.g. inside a pilot/exporter that owns its own OTLPTraceExporter.
+ *   - You don't have an existing handler / TracerProvider to share.
+ *
+ * Use {@link convertEventLogToTrace} directly instead when:
+ *   - You already have a long-lived ExtendedTelemetryHandler bound to a
+ *     real production TracerProvider (e.g. inside a plugin's hook process).
+ *   - You want the spans to flow through BatchSpanProcessor → OTLP exporter
+ *     in the standard plugin pattern.
+ *
+ * @requires `@opentelemetry/sdk-trace-base` must be available at runtime in
+ *           the consumer's `node_modules` (it is loaded via dynamic import).
+ *           This package declares it as an optional peer dep.
+ */
+export declare function convertEventLogToReadableSpans(records: EventLogRecord[], options?: Omit<ConvertOptions, "handler">): Promise<ReadableSpansResult>;
+//# sourceMappingURL=readable-spans.d.ts.map

package/dist/event-log/readable-spans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readable-spans.d.ts","sourceRoot":"","sources":["../../src/event-log/readable-spans.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAGlE,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjE,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,kGAAkG;IAClG,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,cAAc,EAAE,EACzB,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GACxC,OAAO,CAAC,mBAAmB,CAAC,CAmC9B"}

package/dist/event-log/readable-spans.js

@@ -0,0 +1,73 @@
+// Copyright The OpenTelemetry Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import { ExtendedTelemetryHandler } from "../extended-handler.js";
+import { convertEventLogToTrace } from "./converter.js";
+/**
+ * High-level helper that converts an event log into a flat list of
+ * {@link ReadableSpan}s ready to be fed into an OTLPTraceExporter.
+ *
+ * Internally this wires a private BasicTracerProvider + InMemorySpanExporter,
+ * runs {@link convertEventLogToTrace}, flushes, and returns the captured
+ * spans. The provider is **never** registered globally — it lives only for
+ * the duration of this call.
+ *
+ * Use this when:
+ *   - You want a pure function-style API that yields ReadableSpan[] data,
+ *     e.g. inside a pilot/exporter that owns its own OTLPTraceExporter.
+ *   - You don't have an existing handler / TracerProvider to share.
+ *
+ * Use {@link convertEventLogToTrace} directly instead when:
+ *   - You already have a long-lived ExtendedTelemetryHandler bound to a
+ *     real production TracerProvider (e.g. inside a plugin's hook process).
+ *   - You want the spans to flow through BatchSpanProcessor → OTLP exporter
+ *     in the standard plugin pattern.
+ *
+ * @requires `@opentelemetry/sdk-trace-base` must be available at runtime in
+ *           the consumer's `node_modules` (it is loaded via dynamic import).
+ *           This package declares it as an optional peer dep.
+ */
+export async function convertEventLogToReadableSpans(records, options) {
+    if (!records || records.length === 0) {
+        return { spans: [], traceIds: [], warnings: [] };
+    }
+    let mod;
+    try {
+        mod = await import("@opentelemetry/sdk-trace-base");
+    }
+    catch {
+        throw new Error("convertEventLogToReadableSpans requires @opentelemetry/sdk-trace-base. " +
+            "Install it in the consumer package (npm install @opentelemetry/sdk-trace-base).");
+    }
+    const { BasicTracerProvider, InMemorySpanExporter, SimpleSpanProcessor } = mod;
+    const exporter = new InMemorySpanExporter();
+    const provider = new BasicTracerProvider({
+        spanProcessors: [new SimpleSpanProcessor(exporter)],
+    });
+    const handler = new ExtendedTelemetryHandler({ tracerProvider: provider });
+    try {
+        const result = convertEventLogToTrace(records, { ...options, handler });
+        await provider.forceFlush();
+        const spans = exporter.getFinishedSpans();
+        return {
+            spans,
+            traceIds: result.traceIds,
+            warnings: result.warnings,
+        };
+    }
+    finally {
+        // Best-effort cleanup; ignore shutdown errors to avoid masking real failures.
+        await provider.shutdown().catch(() => undefined);
+    }
+}
+//# sourceMappingURL=readable-spans.js.map

package/dist/event-log/readable-spans.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readable-spans.js","sourceRoot":"","sources":["../../src/event-log/readable-spans.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAGjC,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAYxD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,OAAyB,EACzB,OAAyC;IAEzC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IACnD,CAAC;IAED,IAAI,GAAmD,CAAC;IACxD,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,MAAM,CAAC,+BAA+B,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,yEAAyE;YACvE,iFAAiF,CACpF,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,GAAG,GAAG,CAAC;IAC/E,MAAM,QAAQ,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC5C,MAAM,QAAQ,GAAG,IAAI,mBAAmB,CAAC;QACvC,cAAc,EAAE,CAAC,IAAI,mBAAmB,CAAC,QAAQ,CAAC,CAAC;KACpD,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,IAAI,wBAAwB,CAAC,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC,CAAC;IAE3E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,sBAAsB,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QACxE,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,QAAQ,CAAC,gBAAgB,EAAE,CAAC;QAC1C,OAAO;YACL,KAAK;YACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,8EAA8E;QAC9E,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC;AACH,CAAC"}

package/dist/event-log/types.d.ts

@@ -0,0 +1,78 @@
+import type { ExtendedTelemetryHandler } from "../extended-handler.js";
+/**
+ * Event log record as defined by loongsuite-pilot/docs/ai_event_schema.md.
+ *
+ * Intentionally typed as a loose key/value map so that schema evolution (new
+ * fields, removed fields) does not break TypeScript compilation of the
+ * converter. Field access is centralized in field-mapping.ts.
+ */
+export type EventLogRecord = Record<string, unknown>;
+/** Enum of supported event.name values (subset of pilot schema we handle). */
+export declare const EventName: {
+    readonly LLM_REQUEST: "llm.request";
+    readonly LLM_RESPONSE: "llm.response";
+    readonly TOOL_CALL: "tool.call";
+    readonly TOOL_RESULT: "tool.result";
+    readonly SKILL_USE: "skill.use";
+    readonly TOOL_APPROVE: "tool.approve";
+    readonly OTHER: "other";
+};
+export type EventNameValue = (typeof EventName)[keyof typeof EventName];
+/** Options accepted by convertEventLogToTrace. */
+export interface ConvertOptions {
+    /**
+     * Handler used to create spans. If omitted the default singleton from
+     * getExtendedTelemetryHandler() is used.
+     */
+    handler?: ExtendedTelemetryHandler;
+    /**
+     * When true any conversion problem (orphan events, malformed JSON, invalid
+     * timestamps) throws EventLogConversionError instead of being collected as
+     * a warning. Default false.
+     */
+    strict?: boolean;
+}
+/** Result of a conversion. */
+export interface ConvertResult {
+    /** trace_id per turn (in input order). */
+    traceIds: string[];
+    /** Total number of spans created (ENTRY+AGENT+STEP+LLM+TOOL). */
+    spanCount: number;
+    /** Non-fatal issues encountered when strict=false. */
+    warnings: string[];
+}
+/** Thrown in strict mode when conversion cannot proceed. */
+export declare class EventLogConversionError extends Error {
+    readonly eventId?: string | undefined;
+    readonly eventName?: string | undefined;
+    constructor(message: string, eventId?: string | undefined, eventName?: string | undefined);
+}
+/**
+ * Internal grouping result: records grouped by turn.
+ *
+ * traceId is the value read from records (validated 32-hex). May be undefined
+ * if no record in the turn carried a valid trace_id — in that case the SDK
+ * will allocate one.
+ */
+export interface TurnGroup {
+    turnId: string | undefined;
+    sessionId: string | undefined;
+    traceId: string | undefined;
+    records: EventLogRecord[];
+}
+/** Internal grouping result: records within one step of a turn. */
+export interface StepGroup {
+    stepId: string | undefined;
+    records: EventLogRecord[];
+}
+/** A matched llm.request + llm.response pair (either side may be missing). */
+export interface LlmPair {
+    request?: EventLogRecord;
+    response?: EventLogRecord;
+}
+/** A matched tool.call + tool.result pair (either side may be missing). */
+export interface ToolPair {
+    call?: EventLogRecord;
+    result?: EventLogRecord;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/event-log/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/event-log/types.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAEvE;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD,8EAA8E;AAC9E,eAAO,MAAM,SAAS;;;;;;;;CAQZ,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAExE,kDAAkD;AAClD,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,OAAO,CAAC,EAAE,wBAAwB,CAAC;IACnC;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,8BAA8B;AAC9B,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,4DAA4D;AAC5D,qBAAa,uBAAwB,SAAQ,KAAK;aAG9B,OAAO,CAAC,EAAE,MAAM;aAChB,SAAS,CAAC,EAAE,MAAM;gBAFlC,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,MAAM,YAAA,EAChB,SAAS,CAAC,EAAE,MAAM,YAAA;CAKrC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,mEAAmE;AACnE,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,8EAA8E;AAC9E,MAAM,WAAW,OAAO;IACtB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,2EAA2E;AAC3E,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB"}

package/dist/event-log/types.js

@@ -0,0 +1,35 @@
+// Copyright The OpenTelemetry Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+/** Enum of supported event.name values (subset of pilot schema we handle). */
+export const EventName = {
+    LLM_REQUEST: "llm.request",
+    LLM_RESPONSE: "llm.response",
+    TOOL_CALL: "tool.call",
+    TOOL_RESULT: "tool.result",
+    SKILL_USE: "skill.use",
+    TOOL_APPROVE: "tool.approve",
+    OTHER: "other",
+};
+/** Thrown in strict mode when conversion cannot proceed. */
+export class EventLogConversionError extends Error {
+    eventId;
+    eventName;
+    constructor(message, eventId, eventName) {
+        super(message);
+        this.eventId = eventId;
+        this.eventName = eventName;
+        this.name = "EventLogConversionError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/event-log/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/event-log/types.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAajC,8EAA8E;AAC9E,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,WAAW,EAAE,aAAa;IAC1B,YAAY,EAAE,cAAc;IAC5B,SAAS,EAAE,WAAW;IACtB,WAAW,EAAE,aAAa;IAC1B,SAAS,EAAE,WAAW;IACtB,YAAY,EAAE,cAAc;IAC5B,KAAK,EAAE,OAAO;CACN,CAAC;AA6BX,4DAA4D;AAC5D,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAG9B;IACA;IAHlB,YACE,OAAe,EACC,OAAgB,EAChB,SAAkB;QAElC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,YAAO,GAAP,OAAO,CAAS;QAChB,cAAS,GAAT,SAAS,CAAS;QAGlC,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF"}

package/dist/extended-environment-variables.d.ts

@@ -0,0 +1,12 @@
+export declare const OTEL_INSTRUMENTATION_GENAI_MESSAGE_CONTENT_MAX_LENGTH = "OTEL_INSTRUMENTATION_GENAI_MESSAGE_CONTENT_MAX_LENGTH";
+export declare const OTEL_INSTRUMENTATION_GENAI_MESSAGE_CONTENT_CAPTURE_STRATEGY = "OTEL_INSTRUMENTATION_GENAI_MESSAGE_CONTENT_CAPTURE_STRATEGY";
+export declare const OTEL_INSTRUMENTATION_GENAI_MULTIMODAL_STORAGE_BASE_PATH = "OTEL_INSTRUMENTATION_GENAI_MULTIMODAL_STORAGE_BASE_PATH";
+export declare const OTEL_INSTRUMENTATION_GENAI_MULTIMODAL_UPLOAD_MODE = "OTEL_INSTRUMENTATION_GENAI_MULTIMODAL_UPLOAD_MODE";
+export declare const OTEL_INSTRUMENTATION_GENAI_MULTIMODAL_DOWNLOAD_ENABLED = "OTEL_INSTRUMENTATION_GENAI_MULTIMODAL_DOWNLOAD_ENABLED";
+export declare const OTEL_INSTRUMENTATION_GENAI_MULTIMODAL_DOWNLOAD_SSL_VERIFY = "OTEL_INSTRUMENTATION_GENAI_MULTIMODAL_DOWNLOAD_SSL_VERIFY";
+export declare const OTEL_INSTRUMENTATION_GENAI_MULTIMODAL_AUDIO_CONVERSION_ENABLED = "OTEL_INSTRUMENTATION_GENAI_MULTIMODAL_AUDIO_CONVERSION_ENABLED";
+export declare const OTEL_INSTRUMENTATION_GENAI_MULTIMODAL_LOCAL_FILE_ENABLED = "OTEL_INSTRUMENTATION_GENAI_MULTIMODAL_LOCAL_FILE_ENABLED";
+export declare const OTEL_INSTRUMENTATION_GENAI_MULTIMODAL_ALLOWED_ROOT_PATHS = "OTEL_INSTRUMENTATION_GENAI_MULTIMODAL_ALLOWED_ROOT_PATHS";
+export declare const OTEL_INSTRUMENTATION_GENAI_MULTIMODAL_UPLOADER = "OTEL_INSTRUMENTATION_GENAI_MULTIMODAL_UPLOADER";
+export declare const OTEL_INSTRUMENTATION_GENAI_MULTIMODAL_PRE_UPLOADER = "OTEL_INSTRUMENTATION_GENAI_MULTIMODAL_PRE_UPLOADER";
+//# sourceMappingURL=extended-environment-variables.d.ts.map

package/dist/extended-environment-variables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extended-environment-variables.d.ts","sourceRoot":"","sources":["../src/extended-environment-variables.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,qDAAqD,0DACT,CAAC;AAC1D,eAAO,MAAM,2DAA2D,gEACT,CAAC;AAChE,eAAO,MAAM,uDAAuD,4DACT,CAAC;AAC5D,eAAO,MAAM,iDAAiD,sDACT,CAAC;AACtD,eAAO,MAAM,sDAAsD,2DACT,CAAC;AAC3D,eAAO,MAAM,yDAAyD,8DACT,CAAC;AAC9D,eAAO,MAAM,8DAA8D,mEACT,CAAC;AACnE,eAAO,MAAM,wDAAwD,6DACT,CAAC;AAC7D,eAAO,MAAM,wDAAwD,6DACT,CAAC;AAC7D,eAAO,MAAM,8CAA8C,mDACT,CAAC;AACnD,eAAO,MAAM,kDAAkD,uDACT,CAAC"}