@open-multi-agent/otel 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) open-multi-agent contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,144 @@
+# `@open-multi-agent/otel`
+
+Optional OpenTelemetry adapter for `@open-multi-agent/core` TraceRecord v2.
+It converts OBS-2 `TraceExporter` batches into spans on a tracer you explicitly
+provide. The package never reads, registers, or replaces the global
+`TracerProvider`.
+
+```bash
+npm install @open-multi-agent/core@^1.11.0 @open-multi-agent/otel@^0.1.0
+# Install and configure the OpenTelemetry SDK/exporter chosen by your application.
+```
+
+Core `1.11.0` is the first release containing the public TraceRecord v2,
+sink/exporter, and TraceStore APIs required by this package. Core `1.10.0` is
+not compatible.
+
+## Use an application-owned provider
+
+```ts
+import { OpenMultiAgent } from '@open-multi-agent/core'
+import { createOtelTraceSink } from '@open-multi-agent/otel'
+
+// `provider` is configured by the application with its SDK and exporter.
+const sink = createOtelTraceSink({
+  tracerProvider: provider,
+  metadata: {
+    environment: 'production',
+    release: '2026.07.15',
+    tenantId: 'opaque-tenant-id',
+  },
+})
+
+const oma = new OpenMultiAgent({ observability: { sinks: [sink] } })
+```
+
+Pass exactly one of `tracer` or `tracerProvider`. Passing neither is a clear
+configuration error: this package does not fall back to `trace.getTracer()` or
+any global provider.
+
+## Lifecycle and ownership
+
+The caller owns the tracer/provider in every mode.
+
+- `sink.forceFlush()` first flushes the OMA batching queue, then delegates to
+  `provider.forceFlush()` when a provider was supplied and implements it.
+- With a direct `tracer`, there is no provider lifecycle to delegate to, so the
+  adapter phase is a successful no-op.
+- `sink.shutdown()` does **not** shut down a caller-owned provider by default.
+  Set `shutdownOnShutdown: true` only when this adapter is the component that
+  owns the provider lifecycle.
+- Completed OTel `Span` objects are released immediately. Lightweight contexts
+  remain only until their OMA root closes; the 256 most recent root contexts
+  are retained so a same-process checkpoint restore can resolve its continuation
+  link. Shutdown ends any still-open span as incomplete and clears all adapter
+  state.
+- Provider rejection or timeout becomes the OBS-2 exporter result and sink
+  diagnostics/stats; it never changes an Agent, Task, or Run result.
+
+Use a `BatchingTraceSink` directly via `createOtelTraceExporter()` when the
+application owns batching configuration itself.
+
+For a complete no-network example with the official `InMemorySpanExporter`, see
+[`otel-provider.ts`](../core/examples/integrations/observability-v2/otel-provider.ts).
+
+### Process lifecycle
+
+- **Serverless/FaaS:** call `sink.forceFlush()` with a short invocation budget;
+  do not shut down a warm shared sink/provider per invocation.
+- **CLI:** run, force-flush the sink, shut down the sink, then shut down the
+  application-owned provider before natural process exit.
+- **Long-lived server:** stop intake and await in-flight work before the sink
+  cutoff; then force-flush/shut down the sink and finally shut down the provider.
+
+This package and core register no process signal handlers. The application owns
+that integration. Keep `shutdownOnShutdown` at its default `false` when the
+provider is shared with other instrumentation; set it to `true` only when this
+adapter is the provider owner.
+
+## Mapping
+
+The adapter creates one OTel span for each OMA `span_start`/`span_end` pair.
+An end record that arrives without a start creates a marked incomplete span so
+the self-contained OBS-2 end snapshot remains observable. Duplicates and
+orphan events are ignored with payload-free diagnostics.
+
+| OMA operation | OTel representation |
+|---|---|
+| root run | `oma.run` span (`INTERNAL`) |
+| coordinator decomposition/synthesis | OMA plan/agent/callback span, original name retained |
+| task, agent attempt, consensus, checkpoint | `INTERNAL` span, original name retained |
+| LLM | `CLIENT` span with compatible `gen_ai.*` attributes |
+| tool / delegation | `INTERNAL` span; delegated task relation is an OTel link |
+| retry / consensus verdict / stream chunks | `oma.*` events |
+| DAG / restore / synthesis consumption | OTel links with `oma.link.relation` and explicit resolution metadata |
+
+When the referenced span was observed by the same adapter, the OTel link uses
+that span's actual SDK-generated `SpanContext`, so backends can resolve it to the
+exported span. This covers DAG dependencies, delegation, synthesis consumption,
+and same-process checkpoint restore. Every link also records
+`oma.link.resolved`, `oma.link.target.trace_id`, and
+`oma.link.target.span_id`; the target IDs are the stable OMA identifiers.
+
+After a process restart, the adapter has no access to the previous provider's
+SDK-generated context because checkpoints intentionally contain only OMA IDs.
+Such a `continued_from` link remains a valid remote OTel link using the OMA IDs,
+`TraceFlags.NONE`, and `oma.link.resolved = false`. Use its target attributes
+for correlation; a backend cannot be expected to navigate it to the previously
+exported OTel span.
+
+Stable correlation attributes include `oma.schema.version = 2`,
+`oma.run.id`, `oma.run.attempt`, `oma.trace.id`, `oma.span.id`,
+`oma.record.id`, `oma.record.sequence`, and `oma.otel.mapping.version`.
+`oma.otel.gen_ai_semconv.version` records the current compatible GenAI mapping:
+`1.43.0-development`. `oma.*` remains the stable OMA contract; the GenAI
+attributes are a compatibility surface and can evolve with OpenTelemetry.
+
+`ok`, `cancelled`, `rejected`, and `skipped` map to OTel `Unset`; `error`,
+`timeout`, and `budget_exhausted` map to `Error`. The source OMA status is
+always retained as `oma.status`.
+
+The adapter maps model/provider, input/output/cache/reasoning token counts,
+tool name/error facts, cost metadata, retry fields, and TTFT. It emits no
+metrics, so no OMA high-cardinality values become metric labels.
+
+## Privacy
+
+Prompt, completion, tool arguments/results, raw payloads, credentials, and
+reasoning/chain-of-thought content are filtered by default. The adapter uses an
+explicit low-sensitivity `oma.*` allowlist rather than forwarding arbitrary
+record attributes. This includes `<thinking>` and provider reasoning content.
+Token counts remain eligible for
+export. `contentCapture` is a reserved type-level extension point whose only
+accepted value is `mode: 'disabled'`; there is intentionally no content-capture
+switch in this release. Applications that need such a feature must add an
+explicit, separately reviewed capture policy upstream of the adapter.
+
+## OTLP convenience decision
+
+This initial release deliberately has no `/otlp-http` convenience subpath.
+The application chooses and configures its own OpenTelemetry SDK and OTLP (or
+other) exporter, keeping this package's runtime surface to the OTel API and
+avoiding eager OTLP imports, global-provider configuration, and a second
+SDK/exporter version matrix. An explicit convenience subpath can be added later
+without changing the root import.

package/dist/exporter.d.ts

@@ -0,0 +1,84 @@
+import type { Tracer, TracerProvider } from '@opentelemetry/api';
+import { type BatchingTraceSinkOptions, type ExportResult, type TraceExporter, type TraceRecord, type TraceSink } from '@open-multi-agent/core';
+export type OTelDiagnosticCode = 'span_start_failed' | 'duplicate_span_start' | 'orphan_event' | 'span_event_failed' | 'duplicate_span_end' | 'incomplete_span' | 'span_end_failed' | 'force_flush_failed' | 'force_flush_timeout' | 'shutdown_skipped' | 'shutdown_failed' | 'shutdown_timeout';
+export interface OTelDiagnostic {
+    readonly code: OTelDiagnosticCode;
+    readonly message: string;
+}
+export interface OTelTracerProvider extends TracerProvider {
+    forceFlush?(): Promise<void>;
+    shutdown?(): Promise<void>;
+}
+export interface OTelTraceExporterOptions {
+    /** Use an application-owned tracer directly. It is never globally registered or shut down. */
+    readonly tracer?: Tracer;
+    /**
+     * Use an application-owned provider to create the adapter tracer. Its
+     * forceFlush is delegated when available; shutdown remains opt-in.
+     */
+    readonly tracerProvider?: OTelTracerProvider;
+    readonly instrumentationName?: string;
+    readonly instrumentationVersion?: string;
+    /** Optional low-sensitivity metadata, added only when callers provide it. */
+    readonly metadata?: OTelMetadata;
+    /**
+     * Reserved for a separately reviewed future capture policy. This release only
+     * accepts the disabled value and never exports content-bearing fields.
+     */
+    readonly contentCapture?: OTelContentCaptureExtension;
+    /** Opt in to calling shutdown on the supplied provider. Defaults to false. */
+    readonly shutdownOnShutdown?: boolean;
+    /** Receives payload-free adapter diagnostics. */
+    readonly onDiagnostic?: (diagnostic: OTelDiagnostic) => void;
+}
+export interface OTelMetadata {
+    readonly environment?: string;
+    readonly release?: string;
+    readonly tenantId?: string;
+    readonly requestId?: string;
+}
+export interface OTelContentCaptureExtension {
+    readonly mode?: 'disabled';
+}
+export interface OTelTraceSinkOptions extends OTelTraceExporterOptions {
+    readonly batching?: BatchingTraceSinkOptions;
+}
+/**
+ * Adapts OMA TraceRecord v2 to an application-owned OpenTelemetry tracer.
+ * It deliberately does not configure or replace OpenTelemetry's global provider.
+ */
+export declare class OTelTraceExporter implements TraceExporter {
+    private readonly options;
+    private readonly tracer;
+    private readonly provider?;
+    private readonly openSpans;
+    private readonly spanContexts;
+    private readonly traceSpanKeys;
+    private readonly recentRootContexts;
+    private readonly shutdownOnShutdown;
+    private readonly metadata;
+    constructor(options: OTelTraceExporterOptions);
+    export(records: readonly TraceRecord[], _signal: AbortSignal): Promise<ExportResult>;
+    forceFlush(signal: AbortSignal): Promise<ExportResult>;
+    shutdown(signal: AbortSignal): Promise<ExportResult>;
+    private accept;
+    private start;
+    private event;
+    private end;
+    private createSpan;
+    private safeEventAttributes;
+    private addEndLinks;
+    private mapLink;
+    private registerSpanContext;
+    private rememberRootContext;
+    private finalizeTrace;
+    private finalizeAllOpenSpans;
+    private finalizeIncompleteSpan;
+    private delegateLifecycle;
+    private diagnostic;
+}
+/** Build an OBS-2 TraceSink around the OTel adapter without adding OTel to core. */
+export declare function createOtelTraceSink(options: OTelTraceSinkOptions): TraceSink;
+/** Convenience factory for callers that want to provide the adapter to their own BatchingTraceSink. */
+export declare function createOtelTraceExporter(options: OTelTraceExporterOptions): OTelTraceExporter;
+//# sourceMappingURL=exporter.d.ts.map

package/dist/exporter.d.ts.map

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

package/dist/exporter.js

@@ -0,0 +1,321 @@
+import { ROOT_CONTEXT, SpanStatusCode, trace } from '@opentelemetry/api';
+import { BatchingTraceSink, } from '@open-multi-agent/core';
+import { baseAttributes, mapLink, mapOmaAttributes, mapSpanKind, mapStatus, spanAttributes, } from './mapping.js';
+import { PACKAGE_VERSION } from './version.js';
+const MAX_RECENT_ROOT_CONTEXTS = 256;
+function spanKey(traceId, spanId) {
+    return `${traceId}/${spanId}`;
+}
+function linkKey(link) {
+    return `${link.traceId}/${link.spanId}/${link.relation}`;
+}
+function lifecycleResult(status, code) {
+    return { status, exported: 0, ...(code ? { code } : {}) };
+}
+const ACCEPT_FAILURES = {
+    span_start: {
+        diagnostic: 'span_start_failed',
+        message: 'The OpenTelemetry tracer rejected an OMA span_start record.',
+        code: 'OTEL_SPAN_START_FAILED',
+    },
+    span_event: {
+        diagnostic: 'span_event_failed',
+        message: 'The OpenTelemetry tracer rejected an OMA span_event record.',
+        code: 'OTEL_SPAN_EVENT_FAILED',
+    },
+    span_end: {
+        diagnostic: 'span_end_failed',
+        message: 'The OpenTelemetry tracer rejected an OMA span_end record.',
+        code: 'OTEL_SPAN_END_FAILED',
+    },
+};
+/**
+ * Adapts OMA TraceRecord v2 to an application-owned OpenTelemetry tracer.
+ * It deliberately does not configure or replace OpenTelemetry's global provider.
+ */
+export class OTelTraceExporter {
+    options;
+    tracer;
+    provider;
+    openSpans = new Map();
+    spanContexts = new Map();
+    traceSpanKeys = new Map();
+    recentRootContexts = new Map();
+    shutdownOnShutdown;
+    metadata;
+    constructor(options) {
+        this.options = options;
+        if ((options.tracer === undefined) === (options.tracerProvider === undefined)) {
+            throw new TypeError('Provide exactly one of tracer or tracerProvider; global OpenTelemetry state is never used.');
+        }
+        if (options.contentCapture?.mode !== undefined && options.contentCapture.mode !== 'disabled') {
+            throw new TypeError('Content capture is not implemented by @open-multi-agent/otel.');
+        }
+        this.provider = options.tracerProvider;
+        this.tracer = options.tracer ?? options.tracerProvider.getTracer(options.instrumentationName ?? '@open-multi-agent/otel', options.instrumentationVersion ?? PACKAGE_VERSION);
+        this.shutdownOnShutdown = options.shutdownOnShutdown ?? false;
+        this.metadata = {
+            ...(options.metadata?.environment ? {
+                'oma.environment': options.metadata.environment,
+                'deployment.environment.name': options.metadata.environment,
+            } : {}),
+            ...(options.metadata?.release ? {
+                'oma.release': options.metadata.release,
+                'service.version': options.metadata.release,
+            } : {}),
+            ...(options.metadata?.tenantId ? { 'oma.tenant.id': options.metadata.tenantId } : {}),
+            ...(options.metadata?.requestId ? { 'oma.request.id': options.metadata.requestId } : {}),
+        };
+    }
+    export(records, _signal) {
+        let exported = 0;
+        for (const record of records) {
+            try {
+                this.accept(record);
+                exported++;
+            }
+            catch {
+                const failure = ACCEPT_FAILURES[record.recordType];
+                this.diagnostic(failure.diagnostic, failure.message);
+                return Promise.resolve({ status: 'failure', exported, code: failure.code });
+            }
+        }
+        return Promise.resolve({ status: 'success', exported });
+    }
+    async forceFlush(signal) {
+        if (!this.provider?.forceFlush)
+            return lifecycleResult('success');
+        return this.delegateLifecycle(this.provider.forceFlush.bind(this.provider), signal, 'force_flush');
+    }
+    async shutdown(signal) {
+        this.finalizeAllOpenSpans(Date.now());
+        this.spanContexts.clear();
+        this.traceSpanKeys.clear();
+        this.recentRootContexts.clear();
+        if (!this.shutdownOnShutdown || !this.provider?.shutdown) {
+            this.diagnostic('shutdown_skipped', 'Provider shutdown was skipped because the adapter does not own the provider.');
+            return lifecycleResult('success');
+        }
+        return this.delegateLifecycle(this.provider.shutdown.bind(this.provider), signal, 'shutdown');
+    }
+    accept(record) {
+        if (record.recordType === 'span_start') {
+            this.start(record);
+            return;
+        }
+        if (record.recordType === 'span_event') {
+            this.event(record);
+            return;
+        }
+        this.end(record);
+    }
+    start(record) {
+        const key = spanKey(record.traceId, record.spanId);
+        if (this.openSpans.has(key) || this.spanContexts.has(key) || this.recentRootContexts.has(key)) {
+            this.diagnostic('duplicate_span_start', 'Duplicate OMA span_start record ignored.');
+            return;
+        }
+        const span = this.createSpan(record);
+        this.registerSpanContext(record.traceId, key, span.spanContext());
+        this.openSpans.set(key, {
+            span,
+            startUnixMs: record.startUnixMs,
+            linkKeys: new Set(record.links?.map(linkKey)),
+        });
+    }
+    event(record) {
+        const entry = this.openSpans.get(spanKey(record.traceId, record.spanId));
+        if (!entry) {
+            this.diagnostic('orphan_event', 'OMA span_event arrived without an open OTel span and was ignored.');
+            return;
+        }
+        const attributes = {
+            ...baseAttributes(record),
+            ...this.metadata,
+            ...this.safeEventAttributes(record),
+            'oma.event.name': record.name,
+        };
+        entry.span.addEvent(`oma.${record.name}`, attributes, record.timestampUnixMs);
+        if (record.name === 'first_chunk') {
+            const ttftSeconds = Math.max(0, record.timestampUnixMs - entry.startUnixMs) / 1_000;
+            entry.span.setAttribute('gen_ai.response.time_to_first_chunk', ttftSeconds);
+            entry.span.setAttribute('oma.ttft.ms', ttftSeconds * 1_000);
+        }
+    }
+    end(record) {
+        const key = spanKey(record.traceId, record.spanId);
+        let entry = this.openSpans.get(key);
+        if (!entry && (this.spanContexts.has(key) || this.recentRootContexts.has(key))) {
+            this.diagnostic('duplicate_span_end', 'Duplicate OMA span_end record ignored.');
+            return;
+        }
+        if (!entry) {
+            this.diagnostic('incomplete_span', 'OMA span_end arrived without span_start; a synthetic OTel span was created.');
+            const span = this.createSpan(record, true);
+            this.registerSpanContext(record.traceId, key, span.spanContext());
+            entry = {
+                span,
+                startUnixMs: record.startUnixMs,
+                linkKeys: new Set(record.links?.map(linkKey)),
+            };
+            this.openSpans.set(key, entry);
+        }
+        entry.span.setAttributes({
+            ...spanAttributes(record),
+            ...this.metadata,
+            'oma.status': record.status.code,
+        });
+        this.addEndLinks(entry, record.links);
+        entry.span.setStatus(mapStatus(record.status));
+        if (record.error) {
+            const errorAttributes = {
+                'error.type': record.error.code ?? record.error.kind,
+                'oma.error.kind': record.error.kind,
+                ...(record.error.code ? { 'oma.error.code': record.error.code } : {}),
+                ...(record.error.name ? { 'oma.error.name': record.error.name } : {}),
+                ...(record.error.retryable !== undefined ? { 'oma.error.retryable': record.error.retryable } : {}),
+                ...(record.error.httpStatus !== undefined ? { 'oma.error.http_status': record.error.httpStatus } : {}),
+                ...(record.error.provider ? { 'oma.error.provider': record.error.provider } : {}),
+                ...(record.error.attempt !== undefined ? { 'oma.error.attempt': record.error.attempt } : {}),
+            };
+            entry.span.setAttributes(errorAttributes);
+            entry.span.addEvent('exception', errorAttributes, record.endUnixMs);
+        }
+        entry.span.end(record.endUnixMs);
+        this.openSpans.delete(key);
+        if (record.kind === 'run') {
+            const rootContext = this.spanContexts.get(key);
+            if (rootContext)
+                this.rememberRootContext(key, rootContext);
+            this.finalizeTrace(record.traceId, record.endUnixMs);
+        }
+    }
+    createSpan(record, incomplete = false) {
+        const parent = record.parentSpanId
+            ? this.spanContexts.get(spanKey(record.traceId, record.parentSpanId))
+            : undefined;
+        // Root spans must not parent under whatever application span happens to be
+        // active at export time; batching makes that ambient context arbitrary.
+        const parentContext = parent ? trace.setSpanContext(ROOT_CONTEXT, parent) : ROOT_CONTEXT;
+        const attributes = {
+            ...spanAttributes(record),
+            ...this.metadata,
+            ...(incomplete ? { 'oma.record.incomplete': true } : {}),
+        };
+        const span = this.tracer.startSpan(record.name, {
+            kind: mapSpanKind(record.kind),
+            attributes,
+            links: record.links?.map((link) => this.mapLink(link)),
+            startTime: record.startUnixMs,
+        }, parentContext);
+        return span;
+    }
+    safeEventAttributes(record) {
+        return mapOmaAttributes(record.attributes);
+    }
+    addEndLinks(entry, links) {
+        for (const link of links ?? []) {
+            const key = linkKey(link);
+            if (entry.linkKeys.has(key))
+                continue;
+            entry.span.addLink(this.mapLink(link));
+            entry.linkKeys.add(key);
+        }
+    }
+    mapLink(link) {
+        const key = spanKey(link.traceId, link.spanId);
+        return mapLink(link, this.spanContexts.get(key) ?? this.recentRootContexts.get(key));
+    }
+    registerSpanContext(traceId, key, spanContext) {
+        this.spanContexts.set(key, spanContext);
+        let keys = this.traceSpanKeys.get(traceId);
+        if (!keys) {
+            keys = new Set();
+            this.traceSpanKeys.set(traceId, keys);
+        }
+        keys.add(key);
+    }
+    rememberRootContext(key, spanContext) {
+        this.recentRootContexts.delete(key);
+        this.recentRootContexts.set(key, spanContext);
+        while (this.recentRootContexts.size > MAX_RECENT_ROOT_CONTEXTS) {
+            const oldest = this.recentRootContexts.keys().next().value;
+            if (oldest === undefined)
+                break;
+            this.recentRootContexts.delete(oldest);
+        }
+    }
+    finalizeTrace(traceId, endUnixMs) {
+        const keys = this.traceSpanKeys.get(traceId);
+        if (!keys)
+            return;
+        for (const key of keys) {
+            const entry = this.openSpans.get(key);
+            if (entry)
+                this.finalizeIncompleteSpan(key, entry, endUnixMs);
+            this.spanContexts.delete(key);
+        }
+        this.traceSpanKeys.delete(traceId);
+    }
+    finalizeAllOpenSpans(endUnixMs) {
+        for (const [key, entry] of this.openSpans) {
+            this.finalizeIncompleteSpan(key, entry, endUnixMs);
+        }
+        this.openSpans.clear();
+    }
+    finalizeIncompleteSpan(key, entry, endUnixMs) {
+        this.diagnostic('incomplete_span', 'OMA trace closed without span_end; the open OTel span was ended as incomplete.');
+        try {
+            entry.span.setAttribute('oma.record.incomplete', true);
+            entry.span.setStatus({ code: SpanStatusCode.UNSET });
+            entry.span.end(endUnixMs);
+        }
+        catch {
+            this.diagnostic('span_end_failed', 'The OpenTelemetry tracer rejected cleanup of an incomplete OMA span.');
+        }
+        finally {
+            this.openSpans.delete(key);
+        }
+    }
+    async delegateLifecycle(action, signal, operation) {
+        if (signal.aborted) {
+            this.diagnostic(`${operation}_timeout`, `OpenTelemetry ${operation} timed out.`);
+            return lifecycleResult('failure', `OTEL_${operation.toUpperCase()}_TIMEOUT`);
+        }
+        const actionResult = Promise.resolve().then(action).then(() => ({ kind: 'success' }), () => ({ kind: 'failure' }));
+        let removeAbortListener;
+        const timeout = new Promise((resolve) => {
+            const onAbort = () => resolve({ kind: 'timeout' });
+            signal.addEventListener('abort', onAbort, { once: true });
+            removeAbortListener = () => signal.removeEventListener('abort', onAbort);
+        });
+        const outcome = await Promise.race([actionResult, timeout]);
+        removeAbortListener?.();
+        if (outcome.kind === 'success')
+            return lifecycleResult('success');
+        if (outcome.kind === 'timeout') {
+            this.diagnostic(`${operation}_timeout`, `OpenTelemetry ${operation} timed out.`);
+            return lifecycleResult('failure', `OTEL_${operation.toUpperCase()}_TIMEOUT`);
+        }
+        this.diagnostic(`${operation}_failed`, `OpenTelemetry ${operation} failed.`);
+        return lifecycleResult('failure', `OTEL_${operation.toUpperCase()}_FAILED`);
+    }
+    diagnostic(code, message) {
+        try {
+            this.options.onDiagnostic?.({ code, message });
+        }
+        catch {
+            // Diagnostics are best effort and must never alter OMA execution.
+        }
+    }
+}
+/** Build an OBS-2 TraceSink around the OTel adapter without adding OTel to core. */
+export function createOtelTraceSink(options) {
+    const { batching, ...exporterOptions } = options;
+    return new BatchingTraceSink(new OTelTraceExporter(exporterOptions), batching);
+}
+/** Convenience factory for callers that want to provide the adapter to their own BatchingTraceSink. */
+export function createOtelTraceExporter(options) {
+    return new OTelTraceExporter(options);
+}
+//# sourceMappingURL=exporter.js.map

package/dist/exporter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { OMA_OTEL_MAPPING_VERSION, OMA_SCHEMA_VERSION, OTEL_GENAI_SEMCONV_VERSION, addGenAiAttributes, isSafeOmaAttribute, mapLink, mapOmaAttributes, mapSpanKind, mapStatus, } from './mapping.js';
+export { createOtelTraceExporter, createOtelTraceSink, OTelTraceExporter, } from './exporter.js';
+export type { OTelDiagnostic, OTelDiagnosticCode, OTelContentCaptureExtension, OTelMetadata, OTelTraceExporterOptions, OTelTraceSinkOptions, OTelTracerProvider, } from './exporter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,EAClB,OAAO,EACP,gBAAgB,EAChB,WAAW,EACX,SAAS,GACV,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,eAAe,CAAA;AACtB,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,2BAA2B,EAC3B,YAAY,EACZ,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,eAAe,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { OMA_OTEL_MAPPING_VERSION, OMA_SCHEMA_VERSION, OTEL_GENAI_SEMCONV_VERSION, addGenAiAttributes, isSafeOmaAttribute, mapLink, mapOmaAttributes, mapSpanKind, mapStatus, } from './mapping.js';
+export { createOtelTraceExporter, createOtelTraceSink, OTelTraceExporter, } from './exporter.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,EAClB,OAAO,EACP,gBAAgB,EAChB,WAAW,EACX,SAAS,GACV,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,eAAe,CAAA"}

package/dist/mapping.d.ts

@@ -0,0 +1,25 @@
+import { SpanKind as OTelSpanKind } from '@opentelemetry/api';
+import type { Attributes, Link, SpanContext, SpanStatus } from '@opentelemetry/api';
+import type { RunStatus, SpanEndRecord, SpanKind, SpanStartRecord, TraceAttributeValue, TraceLink, TraceRecordBase } from '@open-multi-agent/core';
+/** Version of OMA's stable TraceRecord-to-OTel mapping. */
+export declare const OMA_OTEL_MAPPING_VERSION = "1.0.0";
+/**
+ * The GenAI conventions are development-status and deliberately remain a
+ * compatibility mapping rather than part of OMA's stable public schema.
+ */
+export declare const OTEL_GENAI_SEMCONV_VERSION = "1.43.0-development";
+export declare const OMA_SCHEMA_VERSION = 2;
+/** OMA content is never exported by this package; only an explicit safe metadata allowlist crosses the boundary. */
+export declare function isSafeOmaAttribute(key: string): boolean;
+export declare function mapOmaAttributes(attributes: Readonly<Record<string, TraceAttributeValue>>): Attributes;
+/** Add a bounded compatibility subset of the current GenAI semantic conventions. */
+export declare function addGenAiAttributes(kind: SpanKind, attributes: Attributes): void;
+export declare function mapSpanKind(kind: SpanKind): OTelSpanKind;
+/** Keep successful OMA instrumentation spans Unset, per the OTel Trace API guidance. */
+export declare function mapStatus(status: RunStatus): SpanStatus;
+export declare function mapLink(link: TraceLink, resolvedContext?: SpanContext): Link;
+export declare function baseAttributes(record: TraceRecordBase & {
+    readonly recordType: string;
+}): Attributes;
+export declare function spanAttributes(record: SpanStartRecord | SpanEndRecord): Attributes;
+//# sourceMappingURL=mapping.d.ts.map

package/dist/mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../src/mapping.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,IAAI,YAAY,EAGzB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAEV,UAAU,EACV,IAAI,EACJ,WAAW,EACX,UAAU,EACX,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,QAAQ,EACR,eAAe,EACf,mBAAmB,EACnB,SAAS,EACT,eAAe,EAChB,MAAM,wBAAwB,CAAA;AAE/B,2DAA2D;AAC3D,eAAO,MAAM,wBAAwB,UAAU,CAAA;AAE/C;;;GAGG;AACH,eAAO,MAAM,0BAA0B,uBAAuB,CAAA;AAE9D,eAAO,MAAM,kBAAkB,IAAI,CAAA;AAuDnC,oHAAoH;AACpH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAKvD;AAED,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,GACxD,UAAU,CAMZ;AAkBD,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI,CA8B/E;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAExD;AAED,wFAAwF;AACxF,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,CAgBvD;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,eAAe,CAAC,EAAE,WAAW,GAAG,IAAI,CAkB5E;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,CAcpG;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,aAAa,GAAG,UAAU,CAQlF"}

package/dist/mapping.js

@@ -0,0 +1,198 @@
+import { SpanKind as OTelSpanKind, SpanStatusCode, TraceFlags, } from '@opentelemetry/api';
+/** Version of OMA's stable TraceRecord-to-OTel mapping. */
+export const OMA_OTEL_MAPPING_VERSION = '1.0.0';
+/**
+ * The GenAI conventions are development-status and deliberately remain a
+ * compatibility mapping rather than part of OMA's stable public schema.
+ */
+export const OTEL_GENAI_SEMCONV_VERSION = '1.43.0-development';
+export const OMA_SCHEMA_VERSION = 2;
+const CONTENT_ATTRIBUTE = /(^|[._-])(prompt|completion|content|message|messages|argument|arguments|result|results|reasoning|thinking|payload)($|[._-])/i;
+const SECRET_ATTRIBUTE = /(^|[._-])(authorization|cookie|set_cookie|api[_-]?key|password|passwd|secret|access[_-]?token|refresh[_-]?token|private[_-]?key)($|[._-])/i;
+const SAFE_OMA_ATTRIBUTES = new Set([
+    'oma.agent.attempt',
+    'oma.agent.name',
+    'oma.agent.tool_calls',
+    'oma.agent.turns',
+    'oma.approval.approved',
+    'oma.callback.name',
+    'oma.checkpoint.mode',
+    'oma.consensus.accepted',
+    'oma.consensus.round',
+    'oma.consensus.rounds',
+    'oma.consensus.scope',
+    'oma.consensus.verdict',
+    'oma.cost.amount',
+    'oma.cost.currency',
+    'oma.cost.price_version',
+    'oma.cost.source',
+    'oma.environment',
+    'oma.llm.model',
+    'oma.llm.provider',
+    'oma.llm.response_model',
+    'oma.llm.turn',
+    'oma.model',
+    'oma.phase',
+    'oma.plan.approved',
+    'oma.plan.task_count',
+    'oma.provider',
+    'oma.release',
+    'oma.request.id',
+    'oma.retry.attempt',
+    'oma.retry.delay_ms',
+    'oma.retry.max_attempts',
+    'oma.status',
+    'oma.stream.type',
+    'oma.task.id',
+    'oma.task.retries',
+    'oma.tenant.id',
+    'oma.tool.is_error',
+    'oma.tool.name',
+    'oma.ttft.ms',
+]);
+function toAttributeValue(value) {
+    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean')
+        return value;
+    return [...value];
+}
+function isTokenUsageAttribute(key) {
+    return key.startsWith('oma.usage.') && (key.endsWith('_tokens') || key.endsWith('.tokens'));
+}
+/** OMA content is never exported by this package; only an explicit safe metadata allowlist crosses the boundary. */
+export function isSafeOmaAttribute(key) {
+    if (!key.startsWith('oma.'))
+        return false;
+    if (isTokenUsageAttribute(key))
+        return true;
+    if (CONTENT_ATTRIBUTE.test(key) || SECRET_ATTRIBUTE.test(key))
+        return false;
+    return SAFE_OMA_ATTRIBUTES.has(key);
+}
+export function mapOmaAttributes(attributes) {
+    const mapped = {};
+    for (const [key, value] of Object.entries(attributes)) {
+        if (isSafeOmaAttribute(key))
+            mapped[key] = toAttributeValue(value);
+    }
+    return mapped;
+}
+function readNumber(attributes, ...keys) {
+    for (const key of keys) {
+        const value = attributes[key];
+        if (typeof value === 'number' && Number.isFinite(value))
+            return value;
+    }
+    return undefined;
+}
+function readString(attributes, ...keys) {
+    for (const key of keys) {
+        const value = attributes[key];
+        if (typeof value === 'string' && value.length > 0)
+            return value;
+    }
+    return undefined;
+}
+/** Add a bounded compatibility subset of the current GenAI semantic conventions. */
+export function addGenAiAttributes(kind, attributes) {
+    if (kind === 'llm')
+        attributes['gen_ai.operation.name'] = 'chat';
+    if (kind === 'agent')
+        attributes['gen_ai.operation.name'] = 'invoke_agent';
+    if (kind === 'tool')
+        attributes['gen_ai.operation.name'] = 'execute_tool';
+    const provider = readString(attributes, 'oma.llm.provider', 'oma.provider', 'oma.error.provider');
+    if (provider !== undefined)
+        attributes['gen_ai.provider.name'] = provider;
+    const model = readString(attributes, 'oma.llm.model', 'oma.model');
+    if (model !== undefined)
+        attributes['gen_ai.request.model'] = model;
+    const responseModel = readString(attributes, 'oma.llm.response_model', 'oma.response.model');
+    if (responseModel !== undefined)
+        attributes['gen_ai.response.model'] = responseModel;
+    const inputTokens = readNumber(attributes, 'oma.usage.input_tokens');
+    if (inputTokens !== undefined)
+        attributes['gen_ai.usage.input_tokens'] = inputTokens;
+    const outputTokens = readNumber(attributes, 'oma.usage.output_tokens');
+    if (outputTokens !== undefined)
+        attributes['gen_ai.usage.output_tokens'] = outputTokens;
+    const cacheRead = readNumber(attributes, 'oma.usage.cache_read_input_tokens', 'oma.usage.cache_read.input_tokens');
+    if (cacheRead !== undefined)
+        attributes['gen_ai.usage.cache_read.input_tokens'] = cacheRead;
+    const cacheCreation = readNumber(attributes, 'oma.usage.cache_creation_input_tokens', 'oma.usage.cache_creation.input_tokens');
+    if (cacheCreation !== undefined)
+        attributes['gen_ai.usage.cache_creation.input_tokens'] = cacheCreation;
+    const reasoningTokens = readNumber(attributes, 'oma.usage.reasoning_output_tokens', 'oma.usage.reasoning.output_tokens');
+    if (reasoningTokens !== undefined)
+        attributes['gen_ai.usage.reasoning.output_tokens'] = reasoningTokens;
+    const toolName = readString(attributes, 'oma.tool.name');
+    if (toolName !== undefined && kind === 'tool')
+        attributes['gen_ai.tool.name'] = toolName;
+    const ttftMs = readNumber(attributes, 'oma.ttft.ms');
+    if (ttftMs !== undefined)
+        attributes['gen_ai.response.time_to_first_chunk'] = ttftMs / 1_000;
+}
+export function mapSpanKind(kind) {
+    return kind === 'llm' ? OTelSpanKind.CLIENT : OTelSpanKind.INTERNAL;
+}
+/** Keep successful OMA instrumentation spans Unset, per the OTel Trace API guidance. */
+export function mapStatus(status) {
+    switch (status.code) {
+        case 'error':
+        case 'timeout':
+        case 'budget_exhausted':
+            return {
+                code: SpanStatusCode.ERROR,
+                ...(status.message ? { message: 'oma.' + status.code } : {}),
+            };
+        case 'ok':
+        case 'cancelled':
+        case 'rejected':
+        case 'skipped':
+            return { code: SpanStatusCode.UNSET };
+    }
+    return { code: SpanStatusCode.UNSET };
+}
+export function mapLink(link, resolvedContext) {
+    const resolved = resolvedContext !== undefined;
+    const context = resolvedContext ?? {
+        traceId: link.traceId,
+        spanId: link.spanId,
+        traceFlags: TraceFlags.NONE,
+        isRemote: true,
+    };
+    return {
+        context,
+        attributes: {
+            'oma.link.relation': link.relation,
+            'oma.link.resolved': resolved,
+            'oma.link.target.trace_id': link.traceId,
+            'oma.link.target.span_id': link.spanId,
+            ...mapOmaAttributes(link.attributes ?? {}),
+        },
+    };
+}
+export function baseAttributes(record) {
+    return {
+        'oma.schema.version': OMA_SCHEMA_VERSION,
+        'oma.otel.mapping.version': OMA_OTEL_MAPPING_VERSION,
+        'oma.otel.gen_ai_semconv.version': OTEL_GENAI_SEMCONV_VERSION,
+        'oma.record.id': record.recordId,
+        'oma.record.sequence': record.sequence,
+        'oma.record.type': record.recordType,
+        'oma.run.id': record.runId,
+        'oma.run.attempt': record.attempt,
+        'oma.trace.id': record.traceId,
+        'oma.span.id': record.spanId,
+        ...(record.parentSpanId ? { 'oma.parent_span.id': record.parentSpanId } : {}),
+    };
+}
+export function spanAttributes(record) {
+    const attributes = {
+        ...baseAttributes(record),
+        'oma.span.kind': record.kind,
+        ...mapOmaAttributes(record.attributes),
+    };
+    addGenAiAttributes(record.kind, attributes);
+    return attributes;
+}
+//# sourceMappingURL=mapping.js.map

package/dist/mapping.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The published package version, used as the default tracer
+ * instrumentationVersion. A guard test asserts it matches package.json, so
+ * bumping the package without bumping this constant fails CI.
+ */
+export declare const PACKAGE_VERSION = "0.1.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,eAAe,UAAU,CAAA"}

package/dist/version.js

@@ -0,0 +1,7 @@
+/**
+ * The published package version, used as the default tracer
+ * instrumentationVersion. A guard test asserts it matches package.json, so
+ * bumping the package without bumping this constant fails CI.
+ */
+export const PACKAGE_VERSION = '0.1.0';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAA"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@open-multi-agent/otel",
+  "version": "0.1.0",
+  "description": "Optional OpenTelemetry adapter for @open-multi-agent/core TraceRecord v2.",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit -p tsconfig.lint.json",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "open-telemetry",
+    "opentelemetry",
+    "observability",
+    "multi-agent",
+    "llm"
+  ],
+  "author": {
+    "name": "open-multi-agent",
+    "url": "https://github.com/open-multi-agent"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/open-multi-agent/open-multi-agent.git",
+    "directory": "packages/otel"
+  },
+  "homepage": "https://github.com/open-multi-agent/open-multi-agent#readme",
+  "bugs": {
+    "url": "https://github.com/open-multi-agent/open-multi-agent/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@open-multi-agent/core": "^1.11.0"
+  },
+  "peerDependencies": {
+    "@opentelemetry/api": "^1.9.0"
+  },
+  "devDependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/sdk-trace-base": "^2.9.0",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  }
+}