Standards

OpenInference-compatible and OTLP GenAI-aligned bridge.

AgentInspect persists AgentInspect JSONL locally. Standards exports are compatibility copies for review and optional import — not a replacement persisted schema.

OpenInference (experimental)

bash

npx agent-inspect export <run-id> --format openinference --profile share

Validate fixtures:

import {
  validateOpenInferenceFixture,
  validateOpenInferenceSemanticFixture,
} from "agent-inspect/exporters";

Shape validation is compatible; semantic checks add field-level warnings for tested fixtures only.

Fixture: fixtures/standards/openinference-basic.json

The fixture's top-level version is an AgentInspect reference fixture revision, not an upstream OpenInference version.

OTLP JSON (experimental)

bash

npx agent-inspect export <run-id> --format otlp-json --profile share

GenAI attribute mapping follows OTEL_GEN_AI_SEMCONV_PIN (see exporters API). The pin lists only attributes the exporter may emit (operation name, request model, usage tokens). AgentInspect does not export gen_ai.prompt / gen_ai.completion bodies. No gRPC collector included.

Fixture: fixtures/standards/otlp-basic.json

The fixture's scope.version is an AgentInspect test-scope fixture revision, not the OTEL_GEN_AI_SEMCONV_PIN and not an upstream OpenTelemetry version.

Graduation guide

Full path from local export through review to optional customer-owned import: STANDARDS-GRADUATION.md.

That guide is the canonical source for standards known-loss boundaries, including kind degradation, bounded metadata, no chain-of-thought capture, and snapshot limitations.

Maintaining tested provenance

When the OTLP mapping changes, update OTEL_GEN_AI_SEMCONV_PIN in packages/core/src/exporters/semconv.ts and any explicit tested-version claims together.
When the OTLP reference shape changes, update its test-scope fixture revision in fixtures/standards/otlp-basic.json and any repeated fixture revision together.
When the OpenInference reference shape changes, update the top-level fixture revision in fixtures/standards/openinference-basic.json and any repeated fixture revision together. The value remains an AgentInspect fixture revision, not an upstream version.
Keep known-loss behavior canonical in STANDARDS-GRADUATION.md and update its validation alongside any intentional exporter behavior change.

Run pnpm public-truth:check and pnpm docs:check after changing these sources.

Import recipes

Vendor graduation (manual)

Review redacted exports before sharing. See SAFE-TRACE-SHARING.md.