@xandout/libra-harness 0.1.8

package/dist/extras/extensions/otel/extension.json

@@ -0,0 +1,7 @@
+{
+  "name": "otel",
+  "description": "OpenTelemetry observability — creates spans across the agent turn lifecycle (agent.turn → llm.request → tool.<name>). Uses @opentelemetry/api; host must register a tracer provider.",
+  "enabled": true,
+  "priority": 200,
+  "configKeys": ["tracer", "tracerName", "serviceName", "recordToolArgs", "maxResultLength"]
+}

package/dist/extras/extensions/otel/extension.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=extension.test.d.ts.map

package/dist/extras/extensions/otel/extension.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.test.d.ts","sourceRoot":"","sources":["../../../../src/extras/extensions/otel/extension.test.ts"],"names":[],"mappings":""}

package/dist/extras/extensions/otel/extension.test.js

@@ -0,0 +1,399 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { SpanStatusCode } from '@opentelemetry/api';
+import { Agent } from '../../../agent.js';
+import { createOtelExtension } from './index.js';
+function createInMemoryTracer() {
+    const spans = [];
+    let counter = 0;
+    function makeSpan(name, parentSpanId) {
+        const span = {
+            name,
+            attributes: {},
+            status: { code: SpanStatusCode.UNSET },
+            events: [],
+            parentSpanId,
+            spanId: `span_${counter++}`,
+            ended: false,
+            startTime: performance.now(),
+            endTime: 0,
+        };
+        spans.push(span);
+        const spanApi = {
+            spanContext: () => ({
+                traceId: 'test-trace',
+                spanId: span.spanId,
+                traceFlags: 1,
+                isRemote: false,
+            }),
+            setAttribute(key, value) {
+                span.attributes[key] = value;
+                return spanApi;
+            },
+            setAttributes(attrs) {
+                Object.assign(span.attributes, attrs);
+                return spanApi;
+            },
+            addEvent(name, attributes) {
+                span.events.push({ name, attributes });
+                return spanApi;
+            },
+            setStatus(status) {
+                span.status = status;
+                return spanApi;
+            },
+            end() {
+                span.ended = true;
+                span.endTime = performance.now();
+            },
+            isRecording() {
+                return !span.ended;
+            },
+            recordException(exception) {
+                const msg = typeof exception === 'string' ? exception : exception.message;
+                span.events.push({ name: 'exception', attributes: { 'exception.message': msg } });
+            },
+            updateName(name) {
+                span.name = name;
+                return spanApi;
+            },
+            addLink: () => spanApi,
+            addLinks: () => spanApi,
+        };
+        // Store the spanId on the Span object so the tracer can find the
+        // parent when creating child spans.
+        spanApi._spanId = span.spanId;
+        return spanApi;
+    }
+    const tracer = {
+        spans,
+        startSpan(name, _options, ctx) {
+            // Extract parent spanId from context.
+            const parentSpan = ctx ? ctx._activeSpan : undefined;
+            const parentSpanId = parentSpan?._spanId;
+            const span = makeSpan(name, parentSpanId);
+            // Store on context for child spans — but since we're using a
+            // simplified context, we stash it on the returned span.
+            span._activeSpan = span;
+            return span;
+        },
+        startActiveSpan(name, fn) {
+            const span = makeSpan(name);
+            return fn(span);
+        },
+    };
+    return tracer;
+}
+// ── Mock model ─────────────────────────────────────────────────────
+function mockModel(responses = [{ message: { role: 'assistant', content: 'ok' }, finishReason: 'stop' }]) {
+    let callCount = 0;
+    return {
+        async generate(req) {
+            const resp = responses[Math.min(callCount, responses.length - 1)];
+            callCount++;
+            if (typeof resp === 'function')
+                return resp(req);
+            return resp;
+        },
+    };
+}
+// ── Test setup ─────────────────────────────────────────────────────
+let tracer;
+beforeEach(() => {
+    tracer = createInMemoryTracer();
+});
+// Helper to find spans by name.
+function findSpans(name) {
+    return tracer.spans.filter((s) => s.name === name);
+}
+function findSpan(name) {
+    const spans = findSpans(name);
+    if (spans.length === 0)
+        throw new Error(`No span named "${name}" found`);
+    if (spans.length > 1)
+        throw new Error(`Multiple spans named "${name}" found`);
+    return spans[0];
+}
+// ── Tests ──────────────────────────────────────────────────────────
+describe('otel extension', () => {
+    it('creates a root span for each turn', async () => {
+        const ext = createOtelExtension({ tracer });
+        const agent = new Agent({ model: mockModel() });
+        agent.use(ext);
+        await agent.run({ message: 'hello' });
+        const rootSpan = findSpan('agent.turn');
+        expect(rootSpan.ended).toBe(true);
+        expect(rootSpan.attributes['libra.turn.finish_reason']).toBe('stop');
+        expect(rootSpan.attributes['libra.turn.iterations']).toBe(1);
+    });
+    it('records turn duration and message length', async () => {
+        const ext = createOtelExtension({ tracer });
+        const agent = new Agent({ model: mockModel() });
+        agent.use(ext);
+        await agent.run({ message: 'hello world' });
+        const span = findSpan('agent.turn');
+        expect(span.attributes['libra.turn.message_length']).toBe(11);
+        expect(span.attributes['libra.turn.duration_ms']).toBeDefined();
+        expect(typeof span.attributes['libra.turn.duration_ms']).toBe('number');
+    });
+    it('creates LLM child spans', async () => {
+        const ext = createOtelExtension({ tracer });
+        const agent = new Agent({ model: mockModel() });
+        agent.use(ext);
+        await agent.run({ message: 'hi' });
+        const llmSpan = findSpan('llm.request');
+        expect(llmSpan.ended).toBe(true);
+        expect(llmSpan.attributes['libra.llm.message_count']).toBe(1);
+        expect(llmSpan.attributes['libra.llm.has_tool_calls']).toBe(false);
+    });
+    it('records token usage on LLM spans', async () => {
+        const model = mockModel([{
+                message: { role: 'assistant', content: 'reply' },
+                finishReason: 'stop',
+                usage: {
+                    promptTokens: 100,
+                    completionTokens: 20,
+                    cachedPromptTokens: 50,
+                    reasoningTokens: 5,
+                },
+            }]);
+        const ext = createOtelExtension({ tracer });
+        const agent = new Agent({ model: model });
+        agent.use(ext);
+        await agent.run({ message: 'hi' });
+        const llmSpan = findSpan('llm.request');
+        expect(llmSpan.attributes['libra.llm.prompt_tokens']).toBe(100);
+        expect(llmSpan.attributes['libra.llm.completion_tokens']).toBe(20);
+        expect(llmSpan.attributes['libra.llm.cached_prompt_tokens']).toBe(50);
+        expect(llmSpan.attributes['libra.llm.reasoning_tokens']).toBe(5);
+    });
+    it('creates tool child spans for tool calls', async () => {
+        const tool = {
+            name: 'echo',
+            description: 'Echo tool',
+            parameters: { type: 'object', properties: {} },
+            async execute() {
+                return { toolCallId: '', content: 'echoed' };
+            },
+        };
+        const model = mockModel([
+            {
+                message: {
+                    role: 'assistant',
+                    content: '',
+                    toolCalls: [{ id: 'tc1', name: 'echo', arguments: '{}' }],
+                },
+                finishReason: 'tool_calls',
+            },
+            { message: { role: 'assistant', content: 'done' }, finishReason: 'stop' },
+        ]);
+        const ext = createOtelExtension({ tracer });
+        const agent = new Agent({ model: model, tools: [tool] });
+        agent.use(ext);
+        await agent.run({ message: 'call echo' });
+        const toolSpan = findSpan('tool.echo');
+        expect(toolSpan.ended).toBe(true);
+        expect(toolSpan.attributes['libra.tool.name']).toBe('echo');
+        expect(toolSpan.attributes['libra.tool.is_error']).toBe(false);
+    });
+    it('marks error tool calls with ERROR status', async () => {
+        const tool = {
+            name: 'fail',
+            description: 'Always fails',
+            parameters: { type: 'object', properties: {} },
+            async execute() {
+                return { toolCallId: '', content: 'Something went wrong', isError: true };
+            },
+        };
+        const model = mockModel([
+            {
+                message: {
+                    role: 'assistant',
+                    content: '',
+                    toolCalls: [{ id: 'tc1', name: 'fail', arguments: '{}' }],
+                },
+                finishReason: 'tool_calls',
+            },
+            { message: { role: 'assistant', content: 'sorry' }, finishReason: 'stop' },
+        ]);
+        const ext = createOtelExtension({ tracer });
+        const agent = new Agent({ model: model, tools: [tool] });
+        agent.use(ext);
+        await agent.run({ message: 'call fail' });
+        const toolSpan = findSpan('tool.fail');
+        expect(toolSpan.attributes['libra.tool.is_error']).toBe(true);
+        expect(toolSpan.status.code).toBe(SpanStatusCode.ERROR);
+    });
+    it('records tool result as a span event', async () => {
+        const tool = {
+            name: 'echo',
+            description: 'Echo',
+            parameters: { type: 'object', properties: {} },
+            async execute() {
+                return { toolCallId: '', content: 'hello result' };
+            },
+        };
+        const model = mockModel([
+            {
+                message: {
+                    role: 'assistant',
+                    content: '',
+                    toolCalls: [{ id: 'tc1', name: 'echo', arguments: '{}' }],
+                },
+                finishReason: 'tool_calls',
+            },
+            { message: { role: 'assistant', content: 'done' }, finishReason: 'stop' },
+        ]);
+        const ext = createOtelExtension({ tracer, maxResultLength: 100 });
+        const agent = new Agent({ model: model, tools: [tool] });
+        agent.use(ext);
+        await agent.run({ message: 'call echo' });
+        const toolSpan = findSpan('tool.echo');
+        const resultEvent = toolSpan.events.find((e) => e.name === 'tool.result');
+        expect(resultEvent).toBeDefined();
+        expect(resultEvent.attributes?.['libra.tool.result']).toBe('hello result');
+    });
+    it('records exceptions on error', async () => {
+        const model = {
+            async generate() {
+                throw new Error('model exploded');
+            },
+        };
+        const ext = createOtelExtension({ tracer });
+        const agent = new Agent({ model: model, errorPolicy: 'fallback' });
+        agent.use(ext);
+        await agent.run({ message: 'hi' });
+        const rootSpan = findSpan('agent.turn');
+        const exceptionEvent = rootSpan.events.find((e) => e.name === 'exception');
+        expect(exceptionEvent).toBeDefined();
+        expect(exceptionEvent.attributes?.['exception.message']).toBe('model exploded');
+        expect(rootSpan.status.code).toBe(SpanStatusCode.ERROR);
+    });
+    it('sets serviceName attribute when configured', async () => {
+        const ext = createOtelExtension({ tracer, serviceName: 'slack-bot' });
+        const agent = new Agent({ model: mockModel() });
+        agent.use(ext);
+        await agent.run({ message: 'hi' });
+        const rootSpan = findSpan('agent.turn');
+        expect(rootSpan.attributes['libra.service']).toBe('slack-bot');
+    });
+    it('records tool args when recordToolArgs is enabled', async () => {
+        const tool = {
+            name: 'echo',
+            description: 'Echo',
+            parameters: { type: 'object', properties: { text: { type: 'string' } } },
+            async execute(args) {
+                return { toolCallId: '', content: args.text };
+            },
+        };
+        const model = mockModel([
+            {
+                message: {
+                    role: 'assistant',
+                    content: '',
+                    toolCalls: [{ id: 'tc1', name: 'echo', arguments: '{"text":"hello"}' }],
+                },
+                finishReason: 'tool_calls',
+            },
+            { message: { role: 'assistant', content: 'done' }, finishReason: 'stop' },
+        ]);
+        const ext = createOtelExtension({ tracer, recordToolArgs: true });
+        const agent = new Agent({ model: model, tools: [tool] });
+        agent.use(ext);
+        await agent.run({ message: 'call echo' });
+        const toolSpan = findSpan('tool.echo');
+        expect(toolSpan.attributes['libra.tool.args']).toBe('{"text":"hello"}');
+    });
+    it('creates multiple LLM spans for multi-iteration turns', async () => {
+        const tool = {
+            name: 'echo',
+            description: 'Echo',
+            parameters: { type: 'object', properties: {} },
+            async execute() {
+                return { toolCallId: '', content: 'echoed' };
+            },
+        };
+        const model = mockModel([
+            {
+                message: {
+                    role: 'assistant',
+                    content: '',
+                    toolCalls: [{ id: 'tc1', name: 'echo', arguments: '{}' }],
+                },
+                finishReason: 'tool_calls',
+            },
+            { message: { role: 'assistant', content: 'final' }, finishReason: 'stop' },
+        ]);
+        const ext = createOtelExtension({ tracer });
+        const agent = new Agent({ model: model, tools: [tool] });
+        agent.use(ext);
+        await agent.run({ message: 'call echo then respond' });
+        const llmSpans = findSpans('llm.request');
+        expect(llmSpans).toHaveLength(2);
+        const rootSpan = findSpan('agent.turn');
+        expect(rootSpan.attributes['libra.turn.iterations']).toBe(2);
+        expect(rootSpan.attributes['libra.turn.tool_calls']).toBe(1);
+    });
+    it('is a no-op when no tracer provider is registered', async () => {
+        // Don't pass a tracer — use the global (which has no provider registered).
+        // Should not throw.
+        const ext = createOtelExtension();
+        const agent = new Agent({ model: mockModel() });
+        agent.use(ext);
+        const result = await agent.run({ message: 'hi' });
+        expect(result.finishReason).toBe('stop');
+    });
+    it('uses high priority so spans start before other extensions', () => {
+        const ext = createOtelExtension({ tracer });
+        expect(ext.priority).toBe(200);
+    });
+    it('records sessionId from metadata by default', async () => {
+        const ext = createOtelExtension({ tracer });
+        const agent = new Agent({ model: mockModel() });
+        agent.use(ext);
+        await agent.run({ message: 'hi', metadata: { sessionId: 'slack_C123' } });
+        const rootSpan = findSpan('agent.turn');
+        expect(rootSpan.attributes['libra.turn.sessionId']).toBe('slack_C123');
+    });
+    it('records nested metadata keys via dot notation', async () => {
+        const ext = createOtelExtension({
+            tracer,
+            metadataKeys: ['sessionId', 'slack.channelId', 'slack.userId'],
+        });
+        const agent = new Agent({ model: mockModel() });
+        agent.use(ext);
+        await agent.run({
+            message: 'hi',
+            metadata: {
+                sessionId: 'slack_C123',
+                slack: {
+                    channelId: 'C12345678',
+                    userId: 'U87654321',
+                },
+            },
+        });
+        const rootSpan = findSpan('agent.turn');
+        expect(rootSpan.attributes['libra.turn.sessionId']).toBe('slack_C123');
+        expect(rootSpan.attributes['libra.turn.slack.channelId']).toBe('C12345678');
+        expect(rootSpan.attributes['libra.turn.slack.userId']).toBe('U87654321');
+    });
+    it('skips metadata keys that are objects or missing', async () => {
+        const ext = createOtelExtension({
+            tracer,
+            metadataKeys: ['sessionId', 'slack', 'missing.key'],
+        });
+        const agent = new Agent({ model: mockModel() });
+        agent.use(ext);
+        await agent.run({
+            message: 'hi',
+            metadata: {
+                sessionId: 's1',
+                slack: { channelId: 'C1' }, // object — should be skipped
+            },
+        });
+        const rootSpan = findSpan('agent.turn');
+        expect(rootSpan.attributes['libra.turn.sessionId']).toBe('s1');
+        expect(rootSpan.attributes['libra.turn.slack']).toBeUndefined();
+        expect(rootSpan.attributes['libra.turn.missing.key']).toBeUndefined();
+    });
+});
+//# sourceMappingURL=extension.test.js.map

package/dist/extras/extensions/otel/extension.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.test.js","sourceRoot":"","sources":["../../../../src/extras/extensions/otel/extension.test.ts"],"names":[],"mappings":"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"}

package/dist/extras/extensions/otel/index.d.ts

@@ -0,0 +1,4 @@
+export { default as createOtelExtension } from './extension.js';
+export type { OtelExtensionConfig } from './extension.js';
+export { JsonlSpanExporter } from './jsonl-span-exporter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/extras/extensions/otel/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/extras/extensions/otel/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAChE,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/extras/extensions/otel/index.js

@@ -0,0 +1,3 @@
+export { default as createOtelExtension } from './extension.js';
+export { JsonlSpanExporter } from './jsonl-span-exporter.js';
+//# sourceMappingURL=index.js.map

package/dist/extras/extensions/otel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/extras/extensions/otel/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAEhE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/extras/extensions/otel/jsonl-span-exporter.d.ts

@@ -0,0 +1,60 @@
+import type { SpanExporter, ReadableSpan } from '@opentelemetry/sdk-trace-base';
+/**
+ * A JSONL span exporter for OpenTelemetry.
+ *
+ * Appends each ended span as one JSON line to a `.jsonl` file — same
+ * append-only pattern as disk-session. Each line is a self-contained
+ * record with the span name, attributes, timing, status, and events.
+ *
+ * The file is structured so it can be read line-by-line for analytics
+ * (no need to parse the whole file into memory).
+ *
+ * ## Record format
+ *
+ * ```json
+ * {
+ *   "traceId": "abc123...",
+ *   "spanId": "span_0",
+ *   "parentSpanId": "span_1",
+ *   "name": "agent.turn",
+ *   "kind": 0,
+ *   "startTime": 1234567890.123,
+ *   "endTime": 1234567890.456,
+ *   "durationMs": 333,
+ *   "attributes": { "libra.turn.finish_reason": "stop", ... },
+ *   "status": { "code": 1 },
+ *   "events": [{ "name": "tool.result", "attributes": {...}, "time": ... }],
+ *   "resource": { "service.name": "my-agent" },
+ *   "scope": "libra"
+ * }
+ * ```
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import { JsonlSpanExporter } from '@xandout/libra-harness/extras/otel';
+ * import { NodeSDK } from '@opentelemetry/sdk-node';
+ *
+ * const sdk = new NodeSDK({
+ *   serviceName: 'my-agent',
+ *   traceExporter: new JsonlSpanExporter('./traces/traces.jsonl'),
+ * });
+ * sdk.start();
+ * ```
+ *
+ * No external infrastructure required — just a file path. Good for
+ * local development and single-process deployments. For multi-process
+ * or dashboard scenarios, use the OTLP exporter instead.
+ */
+export declare class JsonlSpanExporter implements SpanExporter {
+    private readonly filePath;
+    private isShutdown;
+    constructor(filePath: string);
+    export(spans: ReadableSpan[], resultCallback: (result: {
+        code: number;
+    }) => void): void;
+    shutdown(): Promise<void>;
+    forceFlush(): Promise<void>;
+    private serialize;
+}
+//# sourceMappingURL=jsonl-span-exporter.d.ts.map

package/dist/extras/extensions/otel/jsonl-span-exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-span-exporter.d.ts","sourceRoot":"","sources":["../../../../src/extras/extensions/otel/jsonl-span-exporter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,UAAU,CAAS;IAE3B,YAAY,QAAQ,EAAE,MAAM,EAM3B;IAED,MAAM,CACJ,KAAK,EAAE,YAAY,EAAE,EACrB,cAAc,EAAE,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GACjD,IAAI,CAcN;IAEK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAE9B;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAEhC;IAED,OAAO,CAAC,SAAS;CAuDlB"}

package/dist/extras/extensions/otel/jsonl-span-exporter.js

@@ -0,0 +1,134 @@
+import { appendFileSync, mkdirSync, existsSync } from 'node:fs';
+import { dirname } from 'node:path';
+/**
+ * A JSONL span exporter for OpenTelemetry.
+ *
+ * Appends each ended span as one JSON line to a `.jsonl` file — same
+ * append-only pattern as disk-session. Each line is a self-contained
+ * record with the span name, attributes, timing, status, and events.
+ *
+ * The file is structured so it can be read line-by-line for analytics
+ * (no need to parse the whole file into memory).
+ *
+ * ## Record format
+ *
+ * ```json
+ * {
+ *   "traceId": "abc123...",
+ *   "spanId": "span_0",
+ *   "parentSpanId": "span_1",
+ *   "name": "agent.turn",
+ *   "kind": 0,
+ *   "startTime": 1234567890.123,
+ *   "endTime": 1234567890.456,
+ *   "durationMs": 333,
+ *   "attributes": { "libra.turn.finish_reason": "stop", ... },
+ *   "status": { "code": 1 },
+ *   "events": [{ "name": "tool.result", "attributes": {...}, "time": ... }],
+ *   "resource": { "service.name": "my-agent" },
+ *   "scope": "libra"
+ * }
+ * ```
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import { JsonlSpanExporter } from '@xandout/libra-harness/extras/otel';
+ * import { NodeSDK } from '@opentelemetry/sdk-node';
+ *
+ * const sdk = new NodeSDK({
+ *   serviceName: 'my-agent',
+ *   traceExporter: new JsonlSpanExporter('./traces/traces.jsonl'),
+ * });
+ * sdk.start();
+ * ```
+ *
+ * No external infrastructure required — just a file path. Good for
+ * local development and single-process deployments. For multi-process
+ * or dashboard scenarios, use the OTLP exporter instead.
+ */
+export class JsonlSpanExporter {
+    filePath;
+    isShutdown = false;
+    constructor(filePath) {
+        this.filePath = filePath;
+        const dir = dirname(filePath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+    }
+    export(spans, resultCallback) {
+        if (this.isShutdown) {
+            resultCallback({ code: 1 }); // FAILURE
+            return;
+        }
+        try {
+            const lines = spans.map((span) => JSON.stringify(this.serialize(span))).join('\n') + '\n';
+            appendFileSync(this.filePath, lines);
+            resultCallback({ code: 0 }); // SUCCESS
+        }
+        catch (err) {
+            console.error('[otel/jsonl] export failed:', err);
+            resultCallback({ code: 1 }); // FAILURE
+        }
+    }
+    async shutdown() {
+        this.isShutdown = true;
+    }
+    async forceFlush() {
+        // Writes are synchronous — nothing to flush.
+    }
+    serialize(span) {
+        const ctx = span.spanContext();
+        const parent = span.parentSpanContext;
+        // Convert HrTime [seconds, nanos] to ms.
+        const durationMs = span.duration
+            ? Math.round(span.duration[0] * 1000 + span.duration[1] / 1_000_000)
+            : 0;
+        // Convert start/end HrTime to epoch seconds (float).
+        const startTime = span.startTime
+            ? span.startTime[0] + span.startTime[1] / 1_000_000_000
+            : 0;
+        const endTime = span.endTime
+            ? span.endTime[0] + span.endTime[1] / 1_000_000_000
+            : 0;
+        // Serialize events (TimedEvent[]).
+        const events = span.events?.map((e) => ({
+            name: e.name,
+            attributes: e.attributes ?? {},
+            time: e.time ? e.time[0] + e.time[1] / 1_000_000_000 : 0,
+        })) ?? [];
+        // Serialize resource attributes.
+        const resource = {};
+        try {
+            const attrs = span.resource.attributes;
+            if (attrs && typeof attrs.forEach === 'function') {
+                attrs.forEach((value, key) => {
+                    resource[key] = value;
+                });
+            }
+            else if (attrs) {
+                Object.assign(resource, attrs);
+            }
+        }
+        catch {
+            // Resource may not have attributes — skip.
+        }
+        return {
+            traceId: ctx.traceId,
+            spanId: ctx.spanId,
+            parentSpanId: parent?.spanId,
+            name: span.name,
+            kind: span.kind,
+            startTime,
+            endTime,
+            durationMs,
+            attributes: span.attributes ?? {},
+            status: span.status,
+            events,
+            resource,
+            scope: span.instrumentationScope?.name ?? '',
+        };
+    }
+}
+//# sourceMappingURL=jsonl-span-exporter.js.map