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

package/dist/event-log/converter.js

@@ -0,0 +1,216 @@
+// 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 { getExtendedTelemetryHandler } from "../extended-handler.js";
+import { EventLogConversionError, } from "./types.js";
+import { createTraceParentContext, isValidTraceId } from "./parent-context.js";
+import { groupByStep, groupByTurn, pairLlm, pairTool, partitionUserHookRequests, } from "./grouping.js";
+import { buildAccumulatedInputMessages, buildEntryInvocation, buildExecuteToolInvocation, buildInvokeAgentInvocation, buildLlmInvocation, buildReactStepInvocation, readNanoMs, readTurnSystemInstruction, readTurnToolDefinitions, } from "./field-mapping.js";
+// Re-export EventName so callers don't need to import from types.js separately.
+export { EventName } from "./types.js";
+/**
+ * Convert a flat event log into OTel spans using the supplied handler.
+ *
+ * Span hierarchy produced per turn (matches ARMS GenAI semantic conventions):
+ *
+ *   ENTRY
+ *    └── AGENT
+ *         └── STEP (one per gen_ai.step.id)
+ *              ├── LLM (one per llm.request+llm.response pair)
+ *              └── TOOL (one per tool.call+tool.result pair)
+ *
+ * trace_id from the event log is honored — all spans of a turn inherit it via
+ * a synthetic parent SpanContext. If trace_id is missing or invalid, the SDK
+ * allocates a fresh one.
+ */
+export function convertEventLogToTrace(records, options) {
+    const strict = options?.strict === true;
+    const handler = options?.handler ?? getExtendedTelemetryHandler();
+    const warnings = [];
+    const traceIds = [];
+    let spanCount = 0;
+    if (!records || records.length === 0) {
+        return { traceIds, spanCount, warnings };
+    }
+    const turns = groupByTurn(records, warnings);
+    for (const turn of turns) {
+        const turnSpanCount = convertTurn(turn, handler, warnings, strict);
+        spanCount += turnSpanCount;
+        if (turn.traceId) {
+            traceIds.push(turn.traceId);
+        }
+    }
+    if (strict && warnings.length > 0) {
+        throw new EventLogConversionError(`Conversion failed in strict mode: ${warnings.length} issue(s). First: ${warnings[0]}`);
+    }
+    return { traceIds, spanCount, warnings };
+}
+function convertTurn(turn, handler, warnings, strict) {
+    const allRecords = turn.records;
+    if (allRecords.length === 0)
+        return 0;
+    // Time bounds use ALL records (including user-hook events) so ENTRY/AGENT
+    // span timestamps still cover the full turn even though user-hook events
+    // are removed from pairing/grouping.
+    const turnStartMs = minTime(allRecords);
+    const turnEndMs = maxTime(allRecords);
+    // Identify "user-input hook" llm.request events:
+    //   - rule: no step.id, no model, and no matching llm.response in turn
+    //   - they are merged into ENTRY/AGENT input.messages and do NOT generate
+    //     LLM spans (avoids polluting the trace with phantom "chat" spans).
+    const { userHooks, remaining } = partitionUserHookRequests(allRecords);
+    const records = remaining;
+    if (userHooks.length > 0) {
+        warnings.push(`Treated ${userHooks.length} llm.request event(s) as user-hook prompt(s), merged into ENTRY (turn ${turn.turnId ?? "(no turn.id)"})`);
+    }
+    // Construct virtual parent context to honor the trace_id.
+    let parentContext;
+    if (turn.traceId && isValidTraceId(turn.traceId)) {
+        parentContext = createTraceParentContext(turn.traceId);
+    }
+    else if (turn.traceId !== undefined) {
+        warnings.push(`Invalid trace_id "${turn.traceId}" for turn ${turn.turnId ?? "(no turn.id)"}; SDK will allocate one`);
+    }
+    // Build invocations (ENTRY/AGENT prefer user-hook events as input source).
+    const entryInv = buildEntryInvocation(records, userHooks);
+    const agentInv = buildInvokeAgentInvocation(records, userHooks);
+    handler.startEntry(entryInv, parentContext, turnStartMs);
+    const entryCtx = entryInv.contextToken ?? undefined;
+    handler.startInvokeAgent(agentInv, entryCtx, turnStartMs);
+    const agentCtx = agentInv.contextToken ?? undefined;
+    let spanCount = 2; // ENTRY + AGENT
+    // Cache turn-level system/tool fields (shared across all LLM spans).
+    const turnSysInstr = readTurnSystemInstruction(records);
+    const turnToolDefs = readTurnToolDefinitions(records);
+    // Pre-compute accumulated input messages for every LLM pair within the turn.
+    // messages_delta accumulation crosses step boundaries (it's a turn-level
+    // concept), so we collect all LLM pairs of the turn in time order first,
+    // then build a Map<request_record, InputMessage[]> for downstream lookup.
+    const accumulatedMap = buildTurnAccumulatedMessages(records);
+    const steps = groupByStep(records);
+    for (const step of steps) {
+        spanCount += convertStep(step, handler, agentCtx, turnSysInstr, turnToolDefs, accumulatedMap, warnings, strict);
+    }
+    handler.stopInvokeAgent(agentInv, turnEndMs);
+    handler.stopEntry(entryInv, turnEndMs);
+    // Capture the actual trace_id used (SDK may have allocated one).
+    if (!turn.traceId) {
+        const allocated = entryInv.span?.spanContext().traceId;
+        if (allocated && isValidTraceId(allocated)) {
+            turn.traceId = allocated;
+        }
+    }
+    return spanCount;
+}
+function convertStep(step, handler, agentCtx, turnSysInstr, turnToolDefs, accumulatedMap, warnings, _strict) {
+    const stepRecords = step.records;
+    if (stepRecords.length === 0)
+        return 0;
+    const stepStart = minTime(stepRecords);
+    const stepEnd = maxTime(stepRecords);
+    const stepInv = buildReactStepInvocation(stepRecords);
+    handler.startReactStep(stepInv, agentCtx, stepStart);
+    const stepCtx = stepInv.contextToken ?? undefined;
+    let spanCount = 1; // STEP
+    const llmPairs = pairLlm(stepRecords, warnings);
+    for (const pair of llmPairs) {
+        spanCount += convertLlmPair(pair, handler, stepCtx, turnSysInstr, turnToolDefs, accumulatedMap);
+    }
+    const toolPairs = pairTool(stepRecords, warnings);
+    for (const pair of toolPairs) {
+        spanCount += convertToolPair(pair, handler, stepCtx);
+    }
+    handler.stopReactStep(stepInv, stepEnd);
+    return spanCount;
+}
+function convertLlmPair(pair, handler, parentCtx, turnSysInstr, turnToolDefs, accumulatedMap) {
+    // Skip degenerate pair with nothing.
+    if (!pair.request && !pair.response)
+        return 0;
+    const startMs = pair.request
+        ? readNanoMs(pair.request["time_unix_nano"])
+        : readNanoMs(pair.response["time_unix_nano"]);
+    let endMs = pair.response
+        ? readNanoMs(pair.response["time_unix_nano"])
+        : startMs;
+    if (endMs < startMs)
+        endMs = startMs;
+    const accumulated = pair.request ? accumulatedMap.get(pair.request) : undefined;
+    const llmInv = buildLlmInvocation(pair, accumulated, turnSysInstr, turnToolDefs);
+    handler.startLlm(llmInv, parentCtx, startMs);
+    handler.stopLlm(llmInv, endMs);
+    return 1;
+}
+/**
+ * Collect LLM pairs across all steps of a turn (in time order) and pre-compute
+ * the accumulated inputMessages for each pair's request record.
+ *
+ * messages_delta accumulation is a turn-level concept — a later step's LLM
+ * request implicitly inherits all messages from prior steps. Pre-computing
+ * here keeps convertStep unaware of the cross-step relationship.
+ */
+function buildTurnAccumulatedMessages(turnRecords) {
+    const pairs = pairLlm(turnRecords, []);
+    // Sort by request time so cross-step order is monotonic. pairLlm already
+    // sorts within each side, but the input to it (turnRecords) is in arrival
+    // order, not strictly time order, when records have shuffled timestamps.
+    pairs.sort((a, b) => {
+        const ta = a.request ? readNanoMs(a.request["time_unix_nano"]) : 0;
+        const tb = b.request ? readNanoMs(b.request["time_unix_nano"]) : 0;
+        return ta - tb;
+    });
+    const map = new Map();
+    for (let i = 0; i < pairs.length; i++) {
+        const req = pairs[i]?.request;
+        if (!req)
+            continue;
+        map.set(req, buildAccumulatedInputMessages(pairs, i));
+    }
+    return map;
+}
+function convertToolPair(pair, handler, parentCtx) {
+    if (!pair.call && !pair.result)
+        return 0;
+    const startMs = pair.call
+        ? readNanoMs(pair.call["time_unix_nano"])
+        : readNanoMs(pair.result["time_unix_nano"]);
+    let endMs = pair.result
+        ? readNanoMs(pair.result["time_unix_nano"])
+        : startMs;
+    if (endMs < startMs)
+        endMs = startMs;
+    const toolInv = buildExecuteToolInvocation(pair);
+    handler.startExecuteTool(toolInv, parentCtx, startMs);
+    handler.stopExecuteTool(toolInv, endMs);
+    return 1;
+}
+/* ------------------------------ time helpers ----------------------------- */
+function minTime(records) {
+    let min = Number.POSITIVE_INFINITY;
+    for (const r of records) {
+        const ms = readNanoMs(r["time_unix_nano"]);
+        if (ms > 0 && ms < min)
+            min = ms;
+    }
+    return Number.isFinite(min) ? min : 0;
+}
+function maxTime(records) {
+    let max = 0;
+    for (const r of records) {
+        const ms = readNanoMs(r["time_unix_nano"]);
+        if (ms > max)
+            max = ms;
+    }
+    return max;
+}
+//# sourceMappingURL=converter.js.map

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

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

package/dist/event-log/field-mapping.d.ts

@@ -0,0 +1,53 @@
+import { type EntryInvocation, type ExecuteToolInvocation, type InvokeAgentInvocation, type ReactStepInvocation } from "../extended-types.js";
+import { type InputMessage, type LLMInvocation, type MessagePart, type ToolDefinition } from "../types.js";
+import { type EventLogRecord, type LlmPair } from "./types.js";
+/**
+ * Read a uint64-nanosecond timestamp and return its millisecond value as
+ * understood by OTel JS SDK (which interprets startTime: number as ms).
+ *
+ * Accepts number, string (decimal), or bigint. Out-of-range values yield 0
+ * which lets the caller decide whether to warn or fall back.
+ */
+export declare function readNanoMs(value: unknown): number;
+/**
+ * Build complete input messages for an LLM invocation by walking the turn's
+ * LLM pairs in order.
+ *
+ * Priority:
+ *   1. If the matching llm.request has gen_ai.input.messages (full), use it.
+ *   2. Else accumulate gen_ai.input.messages_delta from all prior llm.request
+ *      records in the same turn (plus the current one).
+ */
+export declare function buildAccumulatedInputMessages(pairs: LlmPair[], targetPairIndex: number): InputMessage[];
+/**
+ * Build an EntryInvocation from a turn's records.
+ *
+ * @param turnRecords  records remaining after user-hook events are removed
+ * @param userHookRecords  events identified as user-input hook prompts;
+ *                         their messages_delta becomes the ENTRY input.
+ *                         If empty, falls back to the first real llm.request.
+ */
+export declare function buildEntryInvocation(turnRecords: EventLogRecord[], userHookRecords?: EventLogRecord[]): EntryInvocation;
+/** Build an InvokeAgentInvocation by aggregating turn-level metadata. */
+export declare function buildInvokeAgentInvocation(turnRecords: EventLogRecord[], userHookRecords?: EventLogRecord[]): InvokeAgentInvocation;
+/** Build a ReactStepInvocation from a step's records. */
+export declare function buildReactStepInvocation(stepRecords: EventLogRecord[]): ReactStepInvocation;
+/**
+ * Build an LLMInvocation from a paired llm.request + llm.response.
+ *
+ * Either side may be undefined (orphan event). The accumulator parameters let
+ * the caller supply complete input messages reconstructed across the turn's
+ * deltas; passing undefined falls back to reading messages off the request
+ * record alone.
+ */
+export declare function buildLlmInvocation(pair: LlmPair, accumulatedInputMessages: InputMessage[] | undefined, turnSystemInstruction: MessagePart[] | undefined, turnToolDefinitions: ToolDefinition[] | undefined): LLMInvocation;
+/** Build an ExecuteToolInvocation from a tool.call + tool.result pair. */
+export declare function buildExecuteToolInvocation(pair: {
+    call?: EventLogRecord;
+    result?: EventLogRecord;
+}): ExecuteToolInvocation;
+/** Pull system_instructions for a turn (first record carrying them). */
+export declare function readTurnSystemInstruction(turnRecords: EventLogRecord[]): MessagePart[] | undefined;
+/** Pull tool_definitions for a turn (first record carrying them). */
+export declare function readTurnToolDefinitions(turnRecords: EventLogRecord[]): ToolDefinition[] | undefined;
+//# sourceMappingURL=field-mapping.d.ts.map

package/dist/event-log/field-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-mapping.d.ts","sourceRoot":"","sources":["../../src/event-log/field-mapping.ts"],"names":[],"mappings":"AAcA,OAAO,EAKL,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,WAAW,EAEhB,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAa,KAAK,cAAc,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AA4B1E;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAiBjD;AAyED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,EAAE,EAChB,eAAe,EAAE,MAAM,GACtB,YAAY,EAAE,CAiBhB;AA6BD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,cAAc,EAAE,EAC7B,eAAe,GAAE,cAAc,EAAO,GACrC,eAAe,CA4BjB;AAED,yEAAyE;AACzE,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,cAAc,EAAE,EAC7B,eAAe,GAAE,cAAc,EAAO,GACrC,qBAAqB,CA0EvB;AAED,yDAAyD;AACzD,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,cAAc,EAAE,GAC5B,mBAAmB,CAkCrB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,OAAO,EACb,wBAAwB,EAAE,YAAY,EAAE,GAAG,SAAS,EACpD,qBAAqB,EAAE,WAAW,EAAE,GAAG,SAAS,EAChD,mBAAmB,EAAE,cAAc,EAAE,GAAG,SAAS,GAChD,aAAa,CA8Cf;AAED,0EAA0E;AAC1E,wBAAgB,0BAA0B,CACxC,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,cAAc,CAAC;IAAC,MAAM,CAAC,EAAE,cAAc,CAAA;CAAE,GACvD,qBAAqB,CAUvB;AAID,wEAAwE;AACxE,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,cAAc,EAAE,GAC5B,WAAW,EAAE,GAAG,SAAS,CAI3B;AAED,qEAAqE;AACrE,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,cAAc,EAAE,GAC5B,cAAc,EAAE,GAAG,SAAS,CAI9B"}