@robota-sdk/agent-telemetry-otel 3.0.0-beta.99 → 3.0.2

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