@bryel/semconv

npm i @bryel/semconv

OpenInference-conformant semantic-convention constants with no @arizeai dependency. Install directly only if you write a custom SpanMapper.

import {
  SemanticConventions,    // OpenInference attribute keys (LLM_MODEL_NAME, INPUT_VALUE, …)
  OpenInferenceSpanKind,  // LLM | TOOL | CHAIN | AGENT | …
  BryelConventions,       // bryel extensions (INTERACTION_ID, COST_USD, REASONING, …)
  MimeType,               // JSON | TEXT
} from "@bryel/semconv";

Each export is a frozen object of string constants (plus matching TypeScript types). Use them as attribute keys when building a mapper.

SemanticConventions

OpenInference attribute keys. The full set, pinned to the OpenInference spec:

Constant	Value
`OPENINFERENCE_SPAN_KIND`	`openinference.span.kind`
`LLM_MODEL_NAME`	`llm.model_name`
`LLM_PROVIDER`	`llm.provider`
`LLM_SYSTEM`	`llm.system`
`LLM_INVOCATION_PARAMETERS`	`llm.invocation_parameters`
`LLM_TOKEN_COUNT_PROMPT`	`llm.token_count.prompt`
`LLM_TOKEN_COUNT_COMPLETION`	`llm.token_count.completion`
`LLM_TOKEN_COUNT_TOTAL`	`llm.token_count.total`
`LLM_INPUT_MESSAGES` · `LLM_OUTPUT_MESSAGES`	`llm.input_messages` · `llm.output_messages`
`MESSAGE_ROLE` · `MESSAGE_CONTENT`	`message.role` · `message.content`
`INPUT_VALUE` · `INPUT_MIME_TYPE`	`input.value` · `input.mime_type`
`OUTPUT_VALUE` · `OUTPUT_MIME_TYPE`	`output.value` · `output.mime_type`
`TOOL_NAME` · `TOOL_DESCRIPTION` · `TOOL_PARAMETERS`	`tool.name` · `tool.description` · `tool.parameters`
`EMBEDDING_MODEL_NAME` · `EMBEDDING_TEXT`	`embedding.model_name` · `embedding.text`
`RETRIEVAL_DOCUMENTS`	`retrieval.documents`
`SESSION_ID` · `USER_ID`	`session.id` · `user.id`
`METADATA` · `TAG_TAGS`	`metadata` · `tag.tags`

OpenInferenceSpanKind

openinference.span.kind values: CHAIN, LLM, TOOL, RETRIEVER, EMBEDDING, AGENT, RERANKER, GUARDRAIL, EVALUATOR.

BryelConventions

bryel-owned bryel.* extensions, beyond the OpenInference spec:

Constant	Value
`COST_USD`	`bryel.cost.usd`
`COST_STATUS`	`bryel.cost.status`
`INTERACTION_ID`	`bryel.interaction.id`
`SIGNAL_TYPE` · `SIGNAL_VALUE`	`bryel.signal.type` · `bryel.signal.value`
`REASONING`	`bryel.reasoning`

CostStatus values: provider_reported, priced, unknown_model, no_tokens.

MimeType

TEXT (text/plain) · JSON (application/json) — used for input.mime_type / output.mime_type.

​SemanticConventions

​OpenInferenceSpanKind

​BryelConventions

​MimeType

SemanticConventions

OpenInferenceSpanKind

BryelConventions

MimeType