openinference-instrumentation-agentminds

OpenInference auto-instrumentation for the agentminds Python SDK. When attached, every call to agentminds.capture_message, agentminds.capture_exception, and agentminds.init emits an OpenTelemetry span carrying the canonical OpenInference attribute namespace plus an agentminds.* extension namespace for ARP-specific fields.

ARP §8.4 — 5-layer identity compliance: AgentMinds becomes OpenInference-instrumented when this package is installed.

Install

pip install openinference-instrumentation-agentminds

Use

from openinference_instrumentation_agentminds import AgentMindsInstrumentor

# Attach to your existing OTel SDK setup
AgentMindsInstrumentor().instrument()

# From here, agentminds calls produce spans automatically:
import agentminds
agentminds.init(dsn="https://pk_yoursite_xxx@api.agentminds.dev/yoursite")
# ↑ emits span: name="agentminds.init", kind=CHAIN

agentminds.capture_message("p95 climbed", level="warning")
# ↑ emits span: name="agentminds.capture_message",
#               openinference.span.kind="CHAIN",
#               agentminds.event.level="warning"

Span attributes

Why an extension package vs auto-instrumentation in agentminds itself?

• Optional. Most agentminds users don't run an OTel SDK. Bundling this into the main package would force the dep on everyone.
• Apache-2.0. OpenInference attribute names are spec-text only (Apache-2.0). This wrapper uses them; the main SDK doesn't have to inherit the licensing surface.
• Phoenix isolation. Per ARP REJECT list (deepdive Section 5), AgentMinds explicitly does NOT take a runtime dependency on Arize Phoenix (ELv2 + US patent claims). This package depends only on the Apache-2.0 OpenTelemetry stack.

Compatibility

• Python ≥ 3.9
• agentminds ≥ 0.4.2
• opentelemetry-api ≥ 1.20

License

Apache-2.0.

Spec references

• ARP v1.2 spec: https://github.com/agentmindsdev/profile
• OpenInference v1 attributes: https://github.com/Arize-ai/openinference
• OTel GenAI semconv: https://opentelemetry.io/docs/specs/semconv/gen-ai/