@robota-sdk/agent-telemetry-otel 3.0.0-beta.96 → 3.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/CHANGELOG.md +188 -2
  2. package/package.json +3 -3
package/CHANGELOG.md CHANGED
@@ -1,5 +1,191 @@
1
1
  # @robota-sdk/agent-telemetry-otel
2
2
 
3
+ ## 3.0.1
4
+ ### Patch Changes
5
+
6
+ - @robota-sdk/agent-core@3.0.1
7
+ - @robota-sdk/agent-interface-analytics@3.0.1
8
+
9
+ ## 3.0.0
10
+ ### Minor Changes
11
+
12
+ - ccf4194: `createOtelTracing({ tracer, mode, idGenerator })` records an agent run's provider calls and tool bodies
13
+ as OpenTelemetry spans on the host's tracer, under the host's span, named as `projectLivePromptTrace`
14
+ names them. Register its `plugin` once on the agent, and pass each run the `traceContext` and
15
+ `onExecutionEvent` from `startRun(parentSpanContext, { allowedOrigins, subprocessClasses })`.
16
+ `createStructuralIdGenerator()` is an `IdGenerator` for the host's `TracerProvider` so each span is
17
+ recorded under the span ID Robota sent in `traceparent`. `@opentelemetry/api` is a peer dependency.
18
+ - fef3a50: New package `@robota-sdk/agent-telemetry-otel`. `projectLivePromptTrace(batch, { mode, agentName })`
19
+ maps one live prompt trace batch onto content-free OpenTelemetry span shapes without depending on an
20
+ OpenTelemetry SDK. `mode: 'agent'` keeps Robota's `agent.*` span and attribute names; `mode: 'gen_ai'`
21
+ uses the OpenTelemetry GenAI semantic conventions (`invoke_agent`, `chat`, `execute_tool`, `gen_ai.*`
22
+ attributes, `GEN_AI_SCHEMA_URL`) and keeps Robota-only facts such as timing and outcome as `agent.*`;
23
+ `mode: 'gen_ai/dup'` emits both attribute sets under GenAI span names for a gradual migration.
24
+
25
+ `IToolBodyTraceEntry` gains an optional live-only `toolName`, which the GenAI projection uses for the
26
+ `execute_tool` span name and `gen_ai.tool.name`.
27
+ - ccff111: Live telemetry can name its metrics with the OpenTelemetry GenAI semantic conventions. With
28
+ `PRODUCT_TELEMETRY_SEMCONV` set to `gen_ai`, the metrics export the `gen_ai.client.inference.*`
29
+ duration, token-usage and per-call token histograms, `gen_ai.execute_tool.duration` and
30
+ `gen_ai.invoke_agent.*` duration and call counts, and drop only `agent.provider.input_tokens` and
31
+ `agent.provider.output_tokens`, which the GenAI usage counters replace exactly. `gen_ai/dup` exports
32
+ every `agent.*` metric and the GenAI ones. The default, `agent`, exports exactly the metrics it did
33
+ before. Provider- and tool-derived GenAI metrics are exported only when no such child was omitted, and
34
+ usage that was not received is recorded as 0 under the `unknown` modality, as the conventions specify.
35
+ The GenAI metrics carry the requested model as those conventions require, and their inference points
36
+ also take the `agent.provider.id` and `agent.model.id` labels under the same
37
+ `PRODUCT_TELEMETRY_METRIC_ATTRIBUTES` opt-ins as the `agent.*` metrics (the model only in `gen_ai/dup`),
38
+ so a provider split of token totals survives the dropped counters. `PRODUCT_TELEMETRY_SEMCONV` now applies to
39
+ traces and metrics, and is refused only when neither is exported over otlp or console. Console metrics
40
+ print the same projection.
41
+
42
+ `@robota-sdk/agent-telemetry-otel` adds `projectLivePromptMetricSamples`, which maps a live prompt trace
43
+ batch onto those GenAI metrics as plain, SDK-free samples with the recommended bucket boundaries, so
44
+ every host names and measures the same facts the same way. Its inference samples keep the label-safe
45
+ `agent.provider.id`, and `agent.model.id` in `gen_ai/dup`, as the provider span does.
46
+
47
+ ### Patch Changes
48
+
49
+ - Updated dependencies [7b6234c]
50
+ - Updated dependencies [4eea54b]
51
+ - Updated dependencies [3c81769]
52
+ - Updated dependencies [1698be4]
53
+ - Updated dependencies [d4189b9]
54
+ - Updated dependencies [9edae52]
55
+ - Updated dependencies [4078a72]
56
+ - Updated dependencies [4c73a0b]
57
+ - Updated dependencies [196a900]
58
+ - Updated dependencies [f336838]
59
+ - Updated dependencies [34e50f0]
60
+ - Updated dependencies [722e88a]
61
+ - Updated dependencies [d23c848]
62
+ - Updated dependencies [3038eb7]
63
+ - Updated dependencies [02b7452]
64
+ - Updated dependencies [e689c8e]
65
+ - Updated dependencies [ec5e477]
66
+ - Updated dependencies [c7f9203]
67
+ - Updated dependencies [be0e53c]
68
+ - Updated dependencies [8bd5fac]
69
+ - Updated dependencies [57280bf]
70
+ - Updated dependencies [5033dd9]
71
+ - Updated dependencies [18c0d5c]
72
+ - Updated dependencies [dbd888d]
73
+ - Updated dependencies [1887e54]
74
+ - Updated dependencies [9f46375]
75
+ - Updated dependencies [41cca13]
76
+ - Updated dependencies [ada3841]
77
+ - Updated dependencies [5093a30]
78
+ - Updated dependencies [94b2c87]
79
+ - Updated dependencies [3ab2eca]
80
+ - Updated dependencies [2c612ba]
81
+ - Updated dependencies [66af868]
82
+ - Updated dependencies [fef3a50]
83
+ - Updated dependencies [04a6de4]
84
+ - Updated dependencies [0ba247b]
85
+ - Updated dependencies [6f41c53]
86
+ - Updated dependencies [fec722f]
87
+ - Updated dependencies [2d3b2c0]
88
+ - Updated dependencies [4772067]
89
+ - Updated dependencies [9fbab1b]
90
+ - Updated dependencies [a009f5b]
91
+ - Updated dependencies [c207a31]
92
+ - Updated dependencies [9b4f63b]
93
+ - Updated dependencies [4f3c075]
94
+ - Updated dependencies [475e085]
95
+ - Updated dependencies [e477440]
96
+ - Updated dependencies [9dcb5da]
97
+ - Updated dependencies [a95ca85]
98
+ - Updated dependencies [b6d14ce]
99
+ - Updated dependencies [0382a51]
100
+ - Updated dependencies [93d061d]
101
+ - Updated dependencies [39554a1]
102
+ - Updated dependencies [d28430a]
103
+ - Updated dependencies [7d9cc66]
104
+ - Updated dependencies [7d9cc66]
105
+ - Updated dependencies [7d9cc66]
106
+ - Updated dependencies [df02568]
107
+ - Updated dependencies [07b627f]
108
+ - Updated dependencies [d0de5b2]
109
+ - Updated dependencies [9c6a8db]
110
+ - Updated dependencies [9c6a8db]
111
+ - Updated dependencies [dfb9b15]
112
+ - Updated dependencies [7d9cc66]
113
+ - Updated dependencies [7d9cc66]
114
+ - Updated dependencies [d6b9404]
115
+ - Updated dependencies [62663ae]
116
+ - Updated dependencies [23a30cd]
117
+ - Updated dependencies [7d9cc66]
118
+ - Updated dependencies [9814afc]
119
+ - Updated dependencies [7d9cc66]
120
+ - Updated dependencies [02053ec]
121
+ - @robota-sdk/agent-core@3.0.0
122
+ - @robota-sdk/agent-interface-analytics@3.0.0
123
+
124
+ ## 3.0.0-beta.106
125
+ ### Patch Changes
126
+
127
+ - @robota-sdk/agent-core@3.0.0-beta.106
128
+ - @robota-sdk/agent-interface-analytics@3.0.0-beta.106
129
+
130
+ ## 3.0.0-beta.105
131
+ ### Patch Changes
132
+
133
+ - @robota-sdk/agent-core@3.0.0-beta.105
134
+ - @robota-sdk/agent-interface-analytics@3.0.0-beta.105
135
+
136
+ ## 3.0.0-beta.104
137
+ ### Patch Changes
138
+
139
+ - @robota-sdk/agent-core@3.0.0-beta.104
140
+ - @robota-sdk/agent-interface-analytics@3.0.0-beta.104
141
+
142
+ ## 3.0.0-beta.103
143
+ ### Patch Changes
144
+
145
+ - Updated dependencies [6f41c53]
146
+ - @robota-sdk/agent-core@3.0.0-beta.103
147
+ - @robota-sdk/agent-interface-analytics@3.0.0-beta.103
148
+
149
+ ## 3.0.0-beta.102
150
+ ### Patch Changes
151
+
152
+ - @robota-sdk/agent-core@3.0.0-beta.102
153
+ - @robota-sdk/agent-interface-analytics@3.0.0-beta.102
154
+
155
+ ## 3.0.0-beta.101
156
+ ### Patch Changes
157
+
158
+ - Updated dependencies [62663ae]
159
+ - @robota-sdk/agent-core@3.0.0-beta.101
160
+ - @robota-sdk/agent-interface-analytics@3.0.0-beta.101
161
+
162
+ ## 3.0.0-beta.100
163
+ ### Patch Changes
164
+
165
+ - @robota-sdk/agent-core@3.0.0-beta.100
166
+ - @robota-sdk/agent-interface-analytics@3.0.0-beta.100
167
+
168
+ ## 3.0.0-beta.99
169
+ ### Patch Changes
170
+
171
+ - @robota-sdk/agent-core@3.0.0-beta.99
172
+ - @robota-sdk/agent-interface-analytics@3.0.0-beta.99
173
+
174
+ ## 3.0.0-beta.98
175
+ ### Patch Changes
176
+
177
+ - @robota-sdk/agent-core@3.0.0-beta.98
178
+ - @robota-sdk/agent-interface-analytics@3.0.0-beta.98
179
+
180
+ ## 3.0.0-beta.97
181
+ ### Patch Changes
182
+
183
+ - Updated dependencies [c207a31]
184
+ - Updated dependencies [9b4f63b]
185
+ - Updated dependencies [23a30cd]
186
+ - @robota-sdk/agent-core@3.0.0-beta.97
187
+ - @robota-sdk/agent-interface-analytics@3.0.0-beta.97
188
+
3
189
  ## 3.0.0-beta.96
4
190
  ### Patch Changes
5
191
 
@@ -30,7 +216,7 @@
30
216
  uses the OpenTelemetry GenAI semantic conventions (`invoke_agent`, `chat`, `execute_tool`, `gen_ai.*`
31
217
  attributes, `GEN_AI_SCHEMA_URL`) and keeps Robota-only facts such as timing and outcome as `agent.*`;
32
218
  `mode: 'gen_ai/dup'` emits both attribute sets under GenAI span names for a gradual migration.
33
-
219
+
34
220
  `IToolBodyTraceEntry` gains an optional live-only `toolName`, which the GenAI projection uses for the
35
221
  `execute_tool` span name and `gen_ai.tool.name`.
36
222
  - ccff111: Live telemetry can name its metrics with the OpenTelemetry GenAI semantic conventions. With
@@ -47,7 +233,7 @@
47
233
  so a provider split of token totals survives the dropped counters. `PRODUCT_TELEMETRY_SEMCONV` now applies to
48
234
  traces and metrics, and is refused only when neither is exported over otlp or console. Console metrics
49
235
  print the same projection.
50
-
236
+
51
237
  `@robota-sdk/agent-telemetry-otel` adds `projectLivePromptMetricSamples`, which maps a live prompt trace
52
238
  batch onto those GenAI metrics as plain, SDK-free samples with the recommended bucket boundaries, so
53
239
  every host names and measures the same facts the same way. Its inference samples keep the label-safe
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@robota-sdk/agent-telemetry-otel",
3
- "version": "3.0.0-beta.96",
3
+ "version": "3.0.1",
4
4
  "description": "OpenTelemetry tracing and metrics for Robota agents: content-free span projection of live prompt traces, a run observer and GenAI metric samples, with agent.* or GenAI semantic-convention names",
5
5
  "type": "module",
6
6
  "main": "dist/node/index.js",
@@ -40,8 +40,8 @@
40
40
  "CHANGELOG.md"
41
41
  ],
42
42
  "dependencies": {
43
- "@robota-sdk/agent-core": "3.0.0-beta.96",
44
- "@robota-sdk/agent-interface-analytics": "3.0.0-beta.96"
43
+ "@robota-sdk/agent-core": "3.0.1",
44
+ "@robota-sdk/agent-interface-analytics": "3.0.1"
45
45
  },
46
46
  "devDependencies": {
47
47
  "@opentelemetry/api": "^1.9.1",