feat(semantic-conventions-genai): add GenAI semantic conventions package - #7014
Draft
wolfgangcodes wants to merge 1 commit into
Draft
feat(semantic-conventions-genai): add GenAI semantic conventions package#7014wolfgangcodes wants to merge 1 commit into
wolfgangcodes wants to merge 1 commit into
Conversation
GenAI semantic conventions moved out of open-telemetry/semantic-conventions
into their own repository so they can be versioned independently. Core semconv
v1.44.0 keeps only 60 GenAI attributes, all deprecated, so the eventual v1.44.0
bump removes roughly 55 live ATTR_GEN_AI_* exports from
'@opentelemetry/semantic-conventions/incubating'. This package is where those
consumers land.
Adds:
- 'scripts/semconv-genai/', a weaver codegen pipeline modelled on
'scripts/semconv/'. The GenAI registry uses the 'definition/2' file format,
so it needs 'registry generate --v2', the 'semconv_*' JQ helpers need
'"v2": true', attributes carry '.key' rather than '.name', and metrics carry
'.name' rather than '.metric_name'. Weaver resolves the registry's dependency
on core semconv by cloning it, so the container also needs a writable HOME
and network access. Pinned to weaver v0.25.1, matching the GenAI spec repo's
'versions.env', and to a commit on the registry's 'main' branch since it has
no tags or releases yet.
- 'semantic-conventions-genai/', a new package exposing stable and incubating
entry-points the same way '@opentelemetry/semantic-conventions' does. Its
version tracks the GenAI registry's own schema version.
Every GenAI convention is currently in development, so the stable target emits
files with no exports. The templates emit an 'export {};' guard in that case so
the files remain valid ES modules; it disappears once GenAI conventions begin
to stabilize.
The core semconv dependency is '^1.43.0' rather than the '^1.44.0' the registry
manifest resolves against, because 1.44.0 is not published or in flight in this
repository yet. It should rise alongside the core bump.
The independent release train is left to a follow-up, mirroring how open-telemetry#4690 landed
weaver codegen and open-telemetry#4904 separately split semconv into its own release train.
Refs: open-telemetry#6783
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Signed-off-by: Wolfgang Therrien <wolfgang@wolfgangcodes.com>
One or more co-authors of this pull request were not found. You must specify co-authors in commit message trailer via: Supported
Alternatively, if the co-author should not be included, remove the Please update your commit message(s) by doing |
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## main #7014 +/- ##
=======================================
Coverage 95.02% 95.02%
=======================================
Files 409 409
Lines 14298 14304 +6
Branches 3277 3276 -1
=======================================
+ Hits 13587 13593 +6
Misses 711 711 🚀 New features to boost your workflow:
|
Pull request dashboard statusWaiting on the author · refreshed 2026-08-20 17:37 UTC Move out of draft to request review. Status above doesn't look right?
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
GenAI semantic conventions moved out of open-telemetry/semantic-conventions into their own repository so they can be versioned independently. Core semconv v1.44.0 keeps only 60 GenAI attributes, all deprecated, so the eventual v1.44.0 bump removes roughly 55 live ATTR_GEN_AI_* exports from '@opentelemetry/semantic-conventions/incubating'. This package is where those consumers land.
Adds:
Every GenAI convention is currently in development, so the stable target emits files with no exports. The templates emit an 'export {};' guard in that case so the files remain valid ES modules; it disappears once GenAI conventions begin to stabilize.
The core semconv dependency is '^1.43.0' rather than the '^1.44.0' the registry manifest resolves against, because 1.44.0 is not published or in flight in this repository yet. It should rise alongside the core bump.
The independent release train is left to a follow-up, mirroring how #4690 landed weaver codegen and #4904 separately split semconv into its own release train.
Refs: #6783
Which problem is this PR solving?
Please include a summary of the change and which issue is fixed. Please also include relevant motivation and context. List any dependencies that are required for this change.
Fixes # (issue)
Short description of the changes
Type of change
Please delete options that are not relevant.
How Has This Been Tested?
Please describe the tests that you ran to verify your changes. Provide instructions so we can reproduce. Please also list any relevant details for your test configuration
Checklist: