@edictum/otel

OpenTelemetry integration for Edictum rule enforcement.

Part of Edictum — runtime rule enforcement for AI agent tool calls.

Install

pnpm add @edictum/otel @edictum/core @opentelemetry/api

Usage

import { GovernanceTelemetry } from '@edictum/otel'

const telemetry = new GovernanceTelemetry()
const span = telemetry.startToolSpan(envelope)
// ... run pipeline ...
telemetry.setSpanOk(span) // or setSpanError(span, reason)

For automatic no-op fallback when OTel isn't installed:

import { createTelemetry } from '@edictum/otel'

const telemetry = await createTelemetry()
// Returns GovernanceTelemetry if @opentelemetry/api is available, NoOpTelemetry otherwise

API

• GovernanceTelemetry — emits rule-enforcement spans and counters (requires @opentelemetry/api)
• NoOpTelemetry, NoOpSpan — no-op fallback when OTel isn't installed
• createTelemetry() — async factory with runtime detection
• hasOtel(), hasOtelAsync() — check if @opentelemetry/api is available
• configureOtel(options) — setup helper for common OTel configurations

Links

• Full documentation
• GitHub
• All packages