feat(otel): add the telemetry semantic-conventions registry (Weaver)

.changeset/telemetry-conventions-registry.md

@@ -0,0 +1,6 @@
+---
+"github.com/livekit/protocol": patch
+"@livekit/protocol": patch
+---
+
+Add the telemetry semantic-conventions registry under `otel/`

.gitattributes

@@ -1,2 +1,3 @@
 packages/js/src/gen/* linguist-generated
 gen_*.* linguist-generated
+otel/gen/** linguist-generated

.github/workflows/generate.yaml

@@ -65,9 +65,23 @@ jobs:
         run: |
           pnpm --filter @livekit/protocol run generate:proto
 
+      # Only the telemetry conventions in otel/ need weaver; the protobuf and JS generation
+      # above do not. Pinned like otel.yaml, which checks the registry. A failure in this step
+      # or the next leaves otel/gen as it was and never blocks the protobuf and JS commit
+      # below; otel.yaml's freshness check fails while otel/gen is stale.
+      - name: Set up weaver
+        continue-on-error: true
+        uses: open-telemetry/weaver/.github/actions/setup-weaver@51a5bf95bdbb2e20fb6e16638e6bbe7dde911e93 # v0.28.0
+        with:
+          version: "0.28.0"
+
+      - name: Generate the telemetry conventions
+        continue-on-error: true
+        run: go tool mage otel
+
       - name: Add changes
         uses: EndBug/add-and-commit@645ecc0dd0a57f4d86d26c0aa5fc42c0a856fbca # v11.0.0
         with:
-          add: '["livekit", "replay", "rpc", "infra", "packages/javascript/src/gen"]'
+          add: '["livekit", "replay", "rpc", "infra", "packages/javascript/src/gen", "otel/gen"]'
           default_author: github_actions
           message: generated protobuf

.github/workflows/otel.yaml

@@ -0,0 +1,69 @@
+# Copyright 2026 LiveKit, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+name: Telemetry conventions
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main]
+    paths: ["otel/**", ".github/workflows/otel.yaml"]
+  pull_request:
+    branches: [main]
+    paths: ["otel/**", ".github/workflows/otel.yaml"]
+
+permissions:
+  contents: read # Checks only read the checkout
+
+jobs:
+  weaver:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+
+      - name: Set up weaver
+        uses: open-telemetry/weaver/.github/actions/setup-weaver@51a5bf95bdbb2e20fb6e16638e6bbe7dde911e93 # v0.28.0
+        with:
+          version: "0.28.0"
+
+      - name: Check the registry
+        run: otel/check.sh
+
+      - name: Policy negatives fail with their named finding
+        run: otel/tests/negatives.sh
+
+      # The Generate workflow regenerates otel/gen on every push to a branch and commits any
+      # change, as it does for the protobuf code. That commit is pushed with the workflow
+      # token and does not run these checks by itself (GitHub can ask a maintainer to approve
+      # that run); push again to run them. This check fails a commit whose otel/gen is stale,
+      # also when a fresh run deletes an output: `git add --all` stages the deletion, and the
+      # diff compares the index with the commit.
+      - name: Generated outputs are current
+        run: |
+          otel/tests/generate.sh
+          otel/generate.sh
+          git add --all otel/gen
+          git diff --cached --exit-code -- otel/gen
+
+      - name: Generated outputs compile
+        run: |
+          rustc --edition 2021 --crate-type lib -D warnings -D missing_docs otel/gen/rust/semconv.rs --out-dir "$RUNNER_TEMP"
+          npx --yes -p typescript@5.9.3 tsc --strict --noEmit --target es2020 otel/gen/ts/semconv.ts
+          python3 -I -W error otel/gen/python/semconv.py
+
+      - name: Codegen escapes literals (round-trip through rustc, tsc and python3)
+        run: otel/tests/codegen.sh
+
+      - name: Live-check the smoke sample
+        run: otel/tests/live-check.sh

magefile.go

@@ -259,6 +259,13 @@ func Proto() error {
 	return nil
 }
 
+// regenerate the telemetry conventions in otel/gen (needs weaver, see otel/README.md)
+func Otel() error {
+	cmd := exec.Command("otel/generate.sh")
+	connectStd(cmd)
+	return cmd.Run()
+}
+
 // run tests
 func Test() error {
 	cmd := exec.Command("go", "test", "-race", "./...")