@alvin0/ai-agent-sdk-observability-otel 0.1.10 → 0.1.12
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.
- package/dist/index.d.ts +4 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +301 -226
- package/dist/index.js.map +1 -1
- package/package.json +3 -3
package/dist/index.d.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
import { Context, Meter, Tracer } from "@opentelemetry/api";
|
|
2
1
|
import { ObservationPort, SafeErrorRecord } from "@alvin0/ai-agent-sdk-core";
|
|
3
2
|
import { ObservationContentPolicy, ObservationProcessor } from "@alvin0/ai-agent-sdk-core/observability";
|
|
4
|
-
|
|
3
|
+
import { Context, Meter, Tracer } from "@opentelemetry/api";
|
|
4
|
+
//#region src/bridge-types.d.ts
|
|
5
5
|
declare const OTEL_SEMANTIC_CONVENTIONS_COMMIT = "5ca9052bc796ef1e497200b1d558fd87a201f335";
|
|
6
6
|
declare class OpenTelemetryBridgeError extends Error {
|
|
7
7
|
readonly name = "OpenTelemetryBridgeError";
|
|
@@ -20,7 +20,6 @@ interface OpenTelemetryBridge {
|
|
|
20
20
|
readonly processor: ObservationProcessor;
|
|
21
21
|
diagnostics(): readonly SafeErrorRecord[];
|
|
22
22
|
}
|
|
23
|
-
/** Structural log API so consumers that omit logging need not install the optional logs peer. */
|
|
24
23
|
interface OpenTelemetryLogger {
|
|
25
24
|
emit(record: OpenTelemetryLogRecord): void;
|
|
26
25
|
enabled?(options?: OpenTelemetryLogEnabledOptions): boolean;
|
|
@@ -33,6 +32,8 @@ interface OpenTelemetryLogEnabledOptions {
|
|
|
33
32
|
readonly context?: Context;
|
|
34
33
|
readonly [key: string]: unknown;
|
|
35
34
|
}
|
|
35
|
+
//#endregion
|
|
36
|
+
//#region src/bridge.d.ts
|
|
36
37
|
/** Build a mapping-only bridge around caller-owned OpenTelemetry API objects. */
|
|
37
38
|
declare function createOpenTelemetryBridge(options: OpenTelemetryBridgeOptions): OpenTelemetryBridge;
|
|
38
39
|
//#endregion
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","names":[],"sources":["../src/bridge.ts"],"mappings":";;;;
|
|
1
|
+
{"version":3,"file":"index.d.ts","names":[],"sources":["../src/bridge-types.ts","../src/bridge.ts"],"mappings":";;;;cAoBa;cAEA,iCAAiC;WAC1B;WACT;;UAGM;WACN,QAAQ;WACR,OAAO;WACP,SAAS;;WAET,UAAU;WACV,gBAAgB,OAAO;;UAGjB;WACN,UAAU;WACV,WAAW;EACpB,wBAAwB;;UAGT;EACf,KAAK,QAAQ;EACb,SAAS,UAAU;;UAGJ;WACN,UAAU;YACT;;UAGK;WACN,UAAU;YACT;;;;;iBCUI,0BAA0B,SAAS,6BAA6B"}
|
package/dist/index.js
CHANGED
|
@@ -1,22 +1,16 @@
|
|
|
1
|
-
import { ROOT_CONTEXT, SpanKind, SpanStatusCode, TraceFlags, isSpanContextValid, trace } from "@opentelemetry/api";
|
|
2
1
|
import { OBSERVATION_ERROR_CODES, deepFreeze, freezeCorrelation, isSpanId, isTraceId, safeErrorRecord } from "@alvin0/ai-agent-sdk-core";
|
|
3
2
|
import { projectLog, projectMetrics } from "@alvin0/ai-agent-sdk-core/observability";
|
|
3
|
+
import { ROOT_CONTEXT, SpanKind, SpanStatusCode, TraceFlags, isSpanContextValid, trace } from "@opentelemetry/api";
|
|
4
4
|
|
|
5
|
-
//#region src/bridge.ts
|
|
5
|
+
//#region src/bridge-types.ts
|
|
6
6
|
const OTEL_SEMANTIC_CONVENTIONS_COMMIT = "5ca9052bc796ef1e497200b1d558fd87a201f335";
|
|
7
|
-
const MAX_DIAGNOSTICS = 100;
|
|
8
|
-
const LOG_SEVERITY = Object.freeze({
|
|
9
|
-
trace: 1,
|
|
10
|
-
debug: 5,
|
|
11
|
-
info: 9,
|
|
12
|
-
warn: 13,
|
|
13
|
-
error: 17,
|
|
14
|
-
fatal: 21
|
|
15
|
-
});
|
|
16
7
|
var OpenTelemetryBridgeError = class extends Error {
|
|
17
8
|
name = "OpenTelemetryBridgeError";
|
|
18
9
|
code = OBSERVATION_ERROR_CODES.OTEL_PROVIDER_UNCONFIGURED;
|
|
19
10
|
};
|
|
11
|
+
|
|
12
|
+
//#endregion
|
|
13
|
+
//#region src/bridge-values.ts
|
|
20
14
|
function object(value) {
|
|
21
15
|
return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
|
|
22
16
|
}
|
|
@@ -29,8 +23,43 @@ function counter(value) {
|
|
|
29
23
|
function string(value) {
|
|
30
24
|
return typeof value === "string" && value.length > 0 ? value : void 0;
|
|
31
25
|
}
|
|
26
|
+
|
|
27
|
+
//#endregion
|
|
28
|
+
//#region src/bridge-usage.ts
|
|
29
|
+
function reportedUsage(event) {
|
|
30
|
+
const direct = object(event.data.reported);
|
|
31
|
+
if (direct !== void 0) return direct;
|
|
32
|
+
return object(object(event.data.usageReport)?.reported) ?? object(object(event.data.usage)?.reported);
|
|
33
|
+
}
|
|
34
|
+
function estimatedUsage(event) {
|
|
35
|
+
return object(object(event.data.usageReport)?.estimated) ?? object(object(event.data.usage)?.estimated);
|
|
36
|
+
}
|
|
37
|
+
function reportedUsageAttributes(event) {
|
|
38
|
+
const usage = reportedUsage(event);
|
|
39
|
+
if (usage === void 0) return {};
|
|
40
|
+
const uncached = counter(usage.inputTokens);
|
|
41
|
+
const cacheRead = counter(usage.cacheReadTokens);
|
|
42
|
+
const cacheWrite = counter(usage.cacheWriteTokens);
|
|
43
|
+
const output = counter(usage.outputTokens);
|
|
44
|
+
const inputParts = [
|
|
45
|
+
uncached,
|
|
46
|
+
cacheRead,
|
|
47
|
+
cacheWrite
|
|
48
|
+
].filter((value) => value !== void 0);
|
|
49
|
+
const input = inputParts.length === 0 ? void 0 : inputParts.reduce((sum, value) => sum + value, 0);
|
|
50
|
+
return {
|
|
51
|
+
...input === void 0 || !Number.isSafeInteger(input) ? {} : { "gen_ai.usage.input_tokens": input },
|
|
52
|
+
...output === void 0 ? {} : { "gen_ai.usage.output_tokens": output },
|
|
53
|
+
...cacheRead === void 0 ? {} : { "gen_ai.usage.cache_read.input_tokens": cacheRead },
|
|
54
|
+
...cacheWrite === void 0 ? {} : { "gen_ai.usage.cache_write.input_tokens": cacheWrite },
|
|
55
|
+
...counter(usage.reasoningTokens) === void 0 ? {} : { "gen_ai.usage.reasoning.output_tokens": usage.reasoningTokens }
|
|
56
|
+
};
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
//#endregion
|
|
60
|
+
//#region src/bridge-spans.ts
|
|
32
61
|
function initialSpan(input) {
|
|
33
|
-
const operation = input.name
|
|
62
|
+
const operation = operationName(input.name);
|
|
34
63
|
return {
|
|
35
64
|
name: operation ?? input.name,
|
|
36
65
|
kind: input.name === "sdk.model.call" || input.name === "sdk.provider.attempt" ? SpanKind.CLIENT : SpanKind.INTERNAL,
|
|
@@ -87,76 +116,191 @@ function applySpanEvent(state, event, allowContent) {
|
|
|
87
116
|
...statusAttributes(event)
|
|
88
117
|
};
|
|
89
118
|
if (event.correlation.conversationId !== void 0) attributes["gen_ai.conversation.id"] = event.correlation.conversationId;
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
}
|
|
102
|
-
if (allowContent) Object.assign(attributes, contentAttributes(event));
|
|
103
|
-
if (event.phase === "end") Object.assign(attributes, reportedUsageAttributes(event));
|
|
104
|
-
} else if (event.name === "sdk.provider.attempt") {
|
|
105
|
-
const provider = string(event.data.provider);
|
|
106
|
-
const model = string(event.data.model);
|
|
107
|
-
const method = string(event.data.method);
|
|
108
|
-
const origin = string(event.data.origin);
|
|
109
|
-
if (provider !== void 0) attributes["gen_ai.provider.name"] = provider;
|
|
110
|
-
if (model !== void 0) attributes["gen_ai.request.model"] = model;
|
|
111
|
-
if (method !== void 0) attributes["http.request.method"] = method;
|
|
112
|
-
if (counter(event.data.httpStatus) !== void 0) attributes["http.response.status_code"] = event.data.httpStatus;
|
|
113
|
-
if (origin !== void 0) try {
|
|
114
|
-
const url = new URL(origin);
|
|
115
|
-
attributes["server.address"] = url.hostname;
|
|
116
|
-
attributes["url.scheme"] = url.protocol.slice(0, -1);
|
|
117
|
-
if (url.port.length > 0) attributes["server.port"] = Number(url.port);
|
|
118
|
-
} catch {}
|
|
119
|
-
} else if (event.name === "sdk.tool.call") {
|
|
120
|
-
const explicitName = string(event.data.toolName);
|
|
121
|
-
const legacyName = string(event.data.name)?.replace(/^execute_tool\s+/, "");
|
|
122
|
-
const toolName = explicitName ?? legacyName;
|
|
123
|
-
if (toolName !== void 0) {
|
|
124
|
-
attributes["gen_ai.tool.name"] = toolName;
|
|
125
|
-
span.updateName(`execute_tool ${toolName}`);
|
|
126
|
-
}
|
|
127
|
-
if (event.correlation.toolCallId !== void 0) attributes["gen_ai.tool.call.id"] = event.correlation.toolCallId;
|
|
119
|
+
switch (event.name) {
|
|
120
|
+
case "sdk.agent.run":
|
|
121
|
+
applyAgentSpan(span, event, attributes);
|
|
122
|
+
break;
|
|
123
|
+
case "sdk.model.call":
|
|
124
|
+
applyModelSpan(span, event, attributes, allowContent);
|
|
125
|
+
break;
|
|
126
|
+
case "sdk.provider.attempt":
|
|
127
|
+
applyProviderSpan(event, attributes);
|
|
128
|
+
break;
|
|
129
|
+
case "sdk.tool.call": applyToolSpan(span, event, attributes);
|
|
128
130
|
}
|
|
129
131
|
span.setAttributes(attributes);
|
|
130
132
|
}
|
|
131
|
-
function
|
|
132
|
-
|
|
133
|
-
if (
|
|
134
|
-
|
|
133
|
+
function operationName(name) {
|
|
134
|
+
if (name === "sdk.agent.run") return "invoke_agent";
|
|
135
|
+
if (name === "sdk.model.call") return "chat";
|
|
136
|
+
if (name === "sdk.tool.call") return "execute_tool";
|
|
135
137
|
}
|
|
136
|
-
function
|
|
137
|
-
|
|
138
|
+
function applyAgentSpan(span, event, attributes) {
|
|
139
|
+
const agentId = string(event.data.agentId);
|
|
140
|
+
if (agentId !== void 0) attributes["gen_ai.agent.id"] = agentId;
|
|
141
|
+
span.updateName("invoke_agent");
|
|
138
142
|
}
|
|
139
|
-
function
|
|
140
|
-
const
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
const
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
143
|
+
function applyModelSpan(span, event, attributes, allowContent) {
|
|
144
|
+
const provider = string(event.data.provider);
|
|
145
|
+
const model = string(event.data.model);
|
|
146
|
+
if (provider !== void 0) attributes["gen_ai.provider.name"] = provider;
|
|
147
|
+
if (model !== void 0) {
|
|
148
|
+
attributes[event.phase === "start" ? "gen_ai.request.model" : "gen_ai.response.model"] = model;
|
|
149
|
+
span.updateName(`chat ${model}`);
|
|
150
|
+
}
|
|
151
|
+
if (allowContent) Object.assign(attributes, contentAttributes(event));
|
|
152
|
+
if (event.phase === "end") Object.assign(attributes, reportedUsageAttributes(event));
|
|
153
|
+
}
|
|
154
|
+
function applyProviderSpan(event, attributes) {
|
|
155
|
+
const provider = string(event.data.provider);
|
|
156
|
+
const model = string(event.data.model);
|
|
157
|
+
const method = string(event.data.method);
|
|
158
|
+
const origin = string(event.data.origin);
|
|
159
|
+
if (provider !== void 0) attributes["gen_ai.provider.name"] = provider;
|
|
160
|
+
if (model !== void 0) attributes["gen_ai.request.model"] = model;
|
|
161
|
+
if (method !== void 0) attributes["http.request.method"] = method;
|
|
162
|
+
if (counter(event.data.httpStatus) !== void 0) attributes["http.response.status_code"] = event.data.httpStatus;
|
|
163
|
+
if (origin !== void 0) try {
|
|
164
|
+
const url = new URL(origin);
|
|
165
|
+
attributes["server.address"] = url.hostname;
|
|
166
|
+
attributes["url.scheme"] = url.protocol.slice(0, -1);
|
|
167
|
+
if (url.port.length > 0) attributes["server.port"] = Number(url.port);
|
|
168
|
+
} catch {}
|
|
169
|
+
}
|
|
170
|
+
function applyToolSpan(span, event, attributes) {
|
|
171
|
+
const explicitName = string(event.data.toolName);
|
|
172
|
+
const legacyName = string(event.data.name)?.replace(/^execute_tool\s+/, "");
|
|
173
|
+
const toolName = explicitName ?? legacyName;
|
|
174
|
+
if (toolName !== void 0) {
|
|
175
|
+
attributes["gen_ai.tool.name"] = toolName;
|
|
176
|
+
span.updateName(`execute_tool ${toolName}`);
|
|
177
|
+
}
|
|
178
|
+
if (event.correlation.toolCallId !== void 0) attributes["gen_ai.tool.call.id"] = event.correlation.toolCallId;
|
|
179
|
+
}
|
|
180
|
+
|
|
181
|
+
//#endregion
|
|
182
|
+
//#region src/bridge-lifecycle.ts
|
|
183
|
+
const MAX_DIAGNOSTICS = 100;
|
|
184
|
+
function diagnosticRecorder(options, diagnostics) {
|
|
185
|
+
return (error) => {
|
|
186
|
+
const source = safeErrorRecord(error);
|
|
187
|
+
const safe = deepFreeze({
|
|
188
|
+
type: source.type,
|
|
189
|
+
message: source.code === OBSERVATION_ERROR_CODES.OTEL_PROVIDER_UNCONFIGURED ? "OpenTelemetry tracer provider is unconfigured or returned an invalid context" : "OpenTelemetry bridge API call failed",
|
|
190
|
+
...source.code === void 0 ? {} : { code: source.code }
|
|
191
|
+
});
|
|
192
|
+
diagnostics.push(safe);
|
|
193
|
+
if (diagnostics.length > MAX_DIAGNOSTICS) diagnostics.shift();
|
|
194
|
+
try {
|
|
195
|
+
options.onDiagnostic?.(safe);
|
|
196
|
+
} catch {}
|
|
158
197
|
};
|
|
159
198
|
}
|
|
199
|
+
function finishSpan(states, state) {
|
|
200
|
+
if (state.finished || state.endRequested === void 0) return;
|
|
201
|
+
state.finished = true;
|
|
202
|
+
states.delete(state.sdkSpanId);
|
|
203
|
+
const request = state.endRequested;
|
|
204
|
+
const success = request.status === "success";
|
|
205
|
+
let failure;
|
|
206
|
+
try {
|
|
207
|
+
state.span.setStatus({
|
|
208
|
+
code: success ? SpanStatusCode.OK : SpanStatusCode.ERROR,
|
|
209
|
+
...success ? {} : { message: request.status }
|
|
210
|
+
});
|
|
211
|
+
} catch (error) {
|
|
212
|
+
failure = error;
|
|
213
|
+
}
|
|
214
|
+
try {
|
|
215
|
+
state.span.end(new Date(request.endedAt));
|
|
216
|
+
} catch (error) {
|
|
217
|
+
failure ??= error;
|
|
218
|
+
}
|
|
219
|
+
if (failure !== void 0) throw failure;
|
|
220
|
+
}
|
|
221
|
+
function checkedSpanContext(span, input, states) {
|
|
222
|
+
let spanContext;
|
|
223
|
+
try {
|
|
224
|
+
spanContext = span.spanContext();
|
|
225
|
+
} catch (error) {
|
|
226
|
+
try {
|
|
227
|
+
span.end();
|
|
228
|
+
} catch {}
|
|
229
|
+
throw error;
|
|
230
|
+
}
|
|
231
|
+
if (!validContext(spanContext) || input.parent !== void 0 && spanContext.traceId !== input.parent.traceId || states.has(spanContext.spanId)) {
|
|
232
|
+
try {
|
|
233
|
+
span.end();
|
|
234
|
+
} catch {}
|
|
235
|
+
throw new OpenTelemetryBridgeError("supplied tracer returned an invalid or disconnected span context");
|
|
236
|
+
}
|
|
237
|
+
return spanContext;
|
|
238
|
+
}
|
|
239
|
+
function validContext(value) {
|
|
240
|
+
return isSpanContextValid(value) && isTraceId(value.traceId) && isSpanId(value.spanId) && Number.isInteger(value.traceFlags) && value.traceFlags >= 0 && value.traceFlags <= 255;
|
|
241
|
+
}
|
|
242
|
+
function makeSpanHandle(state, correlation, ctx) {
|
|
243
|
+
let ended = false;
|
|
244
|
+
return Object.freeze({
|
|
245
|
+
correlation,
|
|
246
|
+
traceparent: traceparent(state.spanContext),
|
|
247
|
+
end(status, endedAt) {
|
|
248
|
+
if (ended) return;
|
|
249
|
+
ended = true;
|
|
250
|
+
state.endRequested = {
|
|
251
|
+
status,
|
|
252
|
+
endedAt
|
|
253
|
+
};
|
|
254
|
+
if (state.terminalSeen) {
|
|
255
|
+
try {
|
|
256
|
+
finishSpan(ctx.states, state);
|
|
257
|
+
} catch (error) {
|
|
258
|
+
ctx.recordDiagnostic(error);
|
|
259
|
+
throw error;
|
|
260
|
+
}
|
|
261
|
+
return;
|
|
262
|
+
}
|
|
263
|
+
queueMicrotask(() => {
|
|
264
|
+
try {
|
|
265
|
+
finishSpan(ctx.states, state);
|
|
266
|
+
} catch (error) {
|
|
267
|
+
ctx.recordDiagnostic(error);
|
|
268
|
+
}
|
|
269
|
+
});
|
|
270
|
+
}
|
|
271
|
+
});
|
|
272
|
+
}
|
|
273
|
+
function openBridgeSpan(input, ctx) {
|
|
274
|
+
const initial = initialSpan(input);
|
|
275
|
+
const parentContext = explicitParent(input, ctx.states);
|
|
276
|
+
const span = ctx.options.tracer.startSpan(initial.name, {
|
|
277
|
+
kind: initial.kind,
|
|
278
|
+
attributes: initial.attributes,
|
|
279
|
+
startTime: new Date(input.startedAt),
|
|
280
|
+
root: input.parent === void 0
|
|
281
|
+
}, parentContext);
|
|
282
|
+
const spanContext = checkedSpanContext(span, input, ctx.states);
|
|
283
|
+
const correlation = freezeCorrelation({
|
|
284
|
+
traceId: spanContext.traceId,
|
|
285
|
+
spanId: spanContext.spanId,
|
|
286
|
+
parentSpanId: input.parent?.spanId ?? null,
|
|
287
|
+
runId: input.runId,
|
|
288
|
+
...input.correlation ?? {}
|
|
289
|
+
});
|
|
290
|
+
const state = {
|
|
291
|
+
span,
|
|
292
|
+
spanContext,
|
|
293
|
+
context: trace.setSpan(parentContext, span),
|
|
294
|
+
sdkSpanId: spanContext.spanId,
|
|
295
|
+
terminalSeen: false,
|
|
296
|
+
finished: false
|
|
297
|
+
};
|
|
298
|
+
ctx.states.set(state.sdkSpanId, state);
|
|
299
|
+
return makeSpanHandle(state, correlation, ctx);
|
|
300
|
+
}
|
|
301
|
+
|
|
302
|
+
//#endregion
|
|
303
|
+
//#region src/bridge-metrics.ts
|
|
160
304
|
function metricAttributes(event) {
|
|
161
305
|
const error = object(event.data.error);
|
|
162
306
|
return {
|
|
@@ -182,20 +326,7 @@ function recordInternalUsage(sinks, event) {
|
|
|
182
326
|
recordSemanticUsage(sinks, reported, base);
|
|
183
327
|
} else if (event.name === "sdk.agent.run") {
|
|
184
328
|
recordCounterSet(sinks.sdkTokenUsage, estimated, "estimated", base);
|
|
185
|
-
|
|
186
|
-
for (const state of [
|
|
187
|
-
"complete",
|
|
188
|
-
"partial",
|
|
189
|
-
"estimated",
|
|
190
|
-
"missing",
|
|
191
|
-
"notApplicable"
|
|
192
|
-
]) {
|
|
193
|
-
const value = counter(coverage?.[state]);
|
|
194
|
-
if (value !== void 0 && value > 0) sinks.sdkUsageCoverage.add(value, {
|
|
195
|
-
...base,
|
|
196
|
-
"ai_agent_sdk.usage.coverage": state === "notApplicable" ? "not-applicable" : state
|
|
197
|
-
});
|
|
198
|
-
}
|
|
329
|
+
recordRunCoverage(sinks, event, base);
|
|
199
330
|
}
|
|
200
331
|
}
|
|
201
332
|
function recordCounterSet(instrument, values, source, base) {
|
|
@@ -265,13 +396,7 @@ function recordMetrics(sinks, event) {
|
|
|
265
396
|
case "ai_agent_sdk.provider.retry": sinks.sdkProviderRetry.add(projection.value, attributes);
|
|
266
397
|
}
|
|
267
398
|
}
|
|
268
|
-
|
|
269
|
-
const duration = finite(event.data.durationMs);
|
|
270
|
-
if (duration !== void 0) sinks.genAiAgentDuration.record(duration / 1e3, {
|
|
271
|
-
...base,
|
|
272
|
-
"gen_ai.operation.name": "invoke_agent"
|
|
273
|
-
});
|
|
274
|
-
}
|
|
399
|
+
recordAgentDuration(sinks, event, base);
|
|
275
400
|
recordInternalUsage(sinks, event);
|
|
276
401
|
}
|
|
277
402
|
function createMetricSinks(meter) {
|
|
@@ -288,6 +413,42 @@ function createMetricSinks(meter) {
|
|
|
288
413
|
genAiToolDuration: meter.createHistogram("gen_ai.execute_tool.duration", { unit: "s" })
|
|
289
414
|
};
|
|
290
415
|
}
|
|
416
|
+
function recordRunCoverage(sinks, event, base) {
|
|
417
|
+
const coverage = object(object(event.data.usage)?.coverage);
|
|
418
|
+
for (const state of [
|
|
419
|
+
"complete",
|
|
420
|
+
"partial",
|
|
421
|
+
"estimated",
|
|
422
|
+
"missing",
|
|
423
|
+
"notApplicable"
|
|
424
|
+
]) {
|
|
425
|
+
const value = counter(coverage?.[state]);
|
|
426
|
+
if (value !== void 0 && value > 0) sinks.sdkUsageCoverage.add(value, {
|
|
427
|
+
...base,
|
|
428
|
+
"ai_agent_sdk.usage.coverage": state === "notApplicable" ? "not-applicable" : state
|
|
429
|
+
});
|
|
430
|
+
}
|
|
431
|
+
}
|
|
432
|
+
function recordAgentDuration(sinks, event, base) {
|
|
433
|
+
if (event.name === "sdk.agent.run" && event.phase === "end") {
|
|
434
|
+
const duration = finite(event.data.durationMs);
|
|
435
|
+
if (duration !== void 0) sinks.genAiAgentDuration.record(duration / 1e3, {
|
|
436
|
+
...base,
|
|
437
|
+
"gen_ai.operation.name": "invoke_agent"
|
|
438
|
+
});
|
|
439
|
+
}
|
|
440
|
+
}
|
|
441
|
+
|
|
442
|
+
//#endregion
|
|
443
|
+
//#region src/bridge-logs.ts
|
|
444
|
+
const LOG_SEVERITY = Object.freeze({
|
|
445
|
+
trace: 1,
|
|
446
|
+
debug: 5,
|
|
447
|
+
info: 9,
|
|
448
|
+
warn: 13,
|
|
449
|
+
error: 17,
|
|
450
|
+
fatal: 21
|
|
451
|
+
});
|
|
291
452
|
function logContext(event, states) {
|
|
292
453
|
const state = states.get(event.correlation.spanId);
|
|
293
454
|
if (state !== void 0) return state.context;
|
|
@@ -323,10 +484,15 @@ function emitLog(logger, event, states) {
|
|
|
323
484
|
context
|
|
324
485
|
});
|
|
325
486
|
}
|
|
326
|
-
|
|
327
|
-
|
|
487
|
+
|
|
488
|
+
//#endregion
|
|
489
|
+
//#region src/bridge.ts
|
|
490
|
+
function validateProviders(options) {
|
|
328
491
|
if (typeof options?.tracer?.startSpan !== "function") throw new TypeError("OpenTelemetry bridge requires a tracer");
|
|
329
492
|
if (typeof options?.meter?.createHistogram !== "function" || typeof options.meter.createCounter !== "function") throw new TypeError("OpenTelemetry bridge requires a meter");
|
|
493
|
+
}
|
|
494
|
+
function validateOptions(options) {
|
|
495
|
+
validateProviders(options);
|
|
330
496
|
if (![
|
|
331
497
|
"none",
|
|
332
498
|
"metadata",
|
|
@@ -334,146 +500,55 @@ function createOpenTelemetryBridge(options) {
|
|
|
334
500
|
"full"
|
|
335
501
|
].includes(options.content ?? "none")) throw new TypeError("OpenTelemetry bridge content policy is invalid");
|
|
336
502
|
if (options.logger !== void 0 && typeof options.logger.emit !== "function") throw new TypeError("OpenTelemetry bridge logger is invalid");
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
const
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
try {
|
|
350
|
-
options.onDiagnostic?.(safe);
|
|
351
|
-
} catch {}
|
|
352
|
-
};
|
|
353
|
-
const finish = (state) => {
|
|
354
|
-
if (state.finished || state.endRequested === void 0) return;
|
|
355
|
-
state.finished = true;
|
|
356
|
-
states.delete(state.sdkSpanId);
|
|
357
|
-
const request = state.endRequested;
|
|
358
|
-
const success = request.status === "success";
|
|
359
|
-
let failure;
|
|
360
|
-
try {
|
|
361
|
-
state.span.setStatus({
|
|
362
|
-
code: success ? SpanStatusCode.OK : SpanStatusCode.ERROR,
|
|
363
|
-
...success ? {} : { message: request.status }
|
|
364
|
-
});
|
|
365
|
-
} catch (error) {
|
|
366
|
-
failure = error;
|
|
367
|
-
}
|
|
368
|
-
try {
|
|
369
|
-
state.span.end(new Date(request.endedAt));
|
|
370
|
-
} catch (error) {
|
|
371
|
-
failure ??= error;
|
|
372
|
-
}
|
|
373
|
-
if (failure !== void 0) throw failure;
|
|
374
|
-
};
|
|
375
|
-
const openSpanImpl = (input) => {
|
|
376
|
-
const initial = initialSpan(input);
|
|
377
|
-
const parentContext = explicitParent(input, states);
|
|
378
|
-
const span = options.tracer.startSpan(initial.name, {
|
|
379
|
-
kind: initial.kind,
|
|
380
|
-
attributes: initial.attributes,
|
|
381
|
-
startTime: new Date(input.startedAt),
|
|
382
|
-
root: input.parent === void 0
|
|
383
|
-
}, parentContext);
|
|
384
|
-
let spanContext;
|
|
385
|
-
try {
|
|
386
|
-
spanContext = span.spanContext();
|
|
387
|
-
} catch (error) {
|
|
388
|
-
try {
|
|
389
|
-
span.end();
|
|
390
|
-
} catch {}
|
|
391
|
-
throw error;
|
|
392
|
-
}
|
|
393
|
-
if (!isSpanContextValid(spanContext) || !isTraceId(spanContext.traceId) || !isSpanId(spanContext.spanId) || !Number.isInteger(spanContext.traceFlags) || spanContext.traceFlags < 0 || spanContext.traceFlags > 255 || input.parent !== void 0 && spanContext.traceId !== input.parent.traceId || states.has(spanContext.spanId)) {
|
|
394
|
-
try {
|
|
395
|
-
span.end();
|
|
396
|
-
} catch {}
|
|
397
|
-
throw new OpenTelemetryBridgeError("supplied tracer returned an invalid or disconnected span context");
|
|
398
|
-
}
|
|
399
|
-
const correlation = freezeCorrelation({
|
|
400
|
-
traceId: spanContext.traceId,
|
|
401
|
-
spanId: spanContext.spanId,
|
|
402
|
-
parentSpanId: input.parent?.spanId ?? null,
|
|
403
|
-
runId: input.runId,
|
|
404
|
-
...input.correlation ?? {}
|
|
405
|
-
});
|
|
406
|
-
const state = {
|
|
407
|
-
span,
|
|
408
|
-
spanContext,
|
|
409
|
-
context: trace.setSpan(parentContext, span),
|
|
410
|
-
sdkSpanId: spanContext.spanId,
|
|
411
|
-
terminalSeen: false,
|
|
412
|
-
finished: false
|
|
413
|
-
};
|
|
414
|
-
states.set(state.sdkSpanId, state);
|
|
415
|
-
let ended = false;
|
|
416
|
-
return Object.freeze({
|
|
417
|
-
correlation,
|
|
418
|
-
traceparent: traceparent(spanContext),
|
|
419
|
-
end(status, endedAt) {
|
|
420
|
-
if (ended) return;
|
|
421
|
-
ended = true;
|
|
422
|
-
state.endRequested = {
|
|
423
|
-
status,
|
|
424
|
-
endedAt
|
|
425
|
-
};
|
|
426
|
-
if (state.terminalSeen) {
|
|
427
|
-
try {
|
|
428
|
-
finish(state);
|
|
429
|
-
} catch (error) {
|
|
430
|
-
recordDiagnostic(error);
|
|
431
|
-
throw error;
|
|
432
|
-
}
|
|
433
|
-
return;
|
|
434
|
-
}
|
|
435
|
-
queueMicrotask(() => {
|
|
436
|
-
try {
|
|
437
|
-
finish(state);
|
|
438
|
-
} catch (error) {
|
|
439
|
-
recordDiagnostic(error);
|
|
440
|
-
}
|
|
441
|
-
});
|
|
442
|
-
}
|
|
443
|
-
});
|
|
444
|
-
};
|
|
445
|
-
const openSpan = (input) => {
|
|
446
|
-
try {
|
|
447
|
-
return openSpanImpl(input);
|
|
448
|
-
} catch (error) {
|
|
449
|
-
recordDiagnostic(error);
|
|
450
|
-
throw error;
|
|
451
|
-
}
|
|
452
|
-
};
|
|
453
|
-
const processor = Object.freeze({
|
|
503
|
+
}
|
|
504
|
+
function transformSpan(ctx, event) {
|
|
505
|
+
const state = ctx.states.get(event.correlation.spanId);
|
|
506
|
+
if (state === void 0) return;
|
|
507
|
+
applySpanEvent(state, event, ctx.options.content === "full");
|
|
508
|
+
if (event.phase === "end") {
|
|
509
|
+
state.terminalSeen = true;
|
|
510
|
+
finishSpan(ctx.states, state);
|
|
511
|
+
} else if (event.phase === "point") state.span.addEvent(event.name, statusAttributes(event), new Date(event.occurredAt));
|
|
512
|
+
}
|
|
513
|
+
function createProcessor(ctx, sinks) {
|
|
514
|
+
return Object.freeze({
|
|
454
515
|
id: "otel",
|
|
455
516
|
transform(event) {
|
|
456
517
|
try {
|
|
457
|
-
|
|
458
|
-
if (state !== void 0) {
|
|
459
|
-
applySpanEvent(state, event, options.content === "full");
|
|
460
|
-
if (event.phase === "end") {
|
|
461
|
-
state.terminalSeen = true;
|
|
462
|
-
finish(state);
|
|
463
|
-
} else if (event.phase === "point") state.span.addEvent(event.name, statusAttributes(event), new Date(event.occurredAt));
|
|
464
|
-
}
|
|
518
|
+
transformSpan(ctx, event);
|
|
465
519
|
recordMetrics(sinks, event);
|
|
466
|
-
emitLog(options.logger, event, states);
|
|
520
|
+
emitLog(ctx.options.logger, event, ctx.states);
|
|
467
521
|
return event;
|
|
468
522
|
} catch (error) {
|
|
469
|
-
recordDiagnostic(error);
|
|
523
|
+
ctx.recordDiagnostic(error);
|
|
470
524
|
throw error;
|
|
471
525
|
}
|
|
472
526
|
}
|
|
473
527
|
});
|
|
528
|
+
}
|
|
529
|
+
/** Build a mapping-only bridge around caller-owned OpenTelemetry API objects. */
|
|
530
|
+
function createOpenTelemetryBridge(options) {
|
|
531
|
+
validateOptions(options);
|
|
532
|
+
const states = /* @__PURE__ */ new Map();
|
|
533
|
+
const diagnostics = [];
|
|
534
|
+
const recordDiagnostic = diagnosticRecorder(options, diagnostics);
|
|
535
|
+
const ctx = {
|
|
536
|
+
options,
|
|
537
|
+
states,
|
|
538
|
+
recordDiagnostic
|
|
539
|
+
};
|
|
540
|
+
const sinks = createMetricSinks(options.meter);
|
|
541
|
+
const openSpan = (input) => {
|
|
542
|
+
try {
|
|
543
|
+
return openBridgeSpan(input, ctx);
|
|
544
|
+
} catch (error) {
|
|
545
|
+
recordDiagnostic(error);
|
|
546
|
+
throw error;
|
|
547
|
+
}
|
|
548
|
+
};
|
|
474
549
|
return Object.freeze({
|
|
475
550
|
openSpan,
|
|
476
|
-
processor,
|
|
551
|
+
processor: createProcessor(ctx, sinks),
|
|
477
552
|
diagnostics: () => deepFreeze([...diagnostics])
|
|
478
553
|
});
|
|
479
554
|
}
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","names":[],"sources":["../src/bridge.ts"],"sourcesContent":["import {\n ROOT_CONTEXT,\n SpanKind,\n SpanStatusCode,\n TraceFlags,\n isSpanContextValid,\n trace,\n type Attributes,\n type Context,\n type Counter,\n type Histogram,\n type Meter,\n type Span,\n type SpanContext,\n type Tracer,\n} from '@opentelemetry/api'\nimport {\n OBSERVATION_ERROR_CODES,\n deepFreeze,\n freezeCorrelation,\n isSpanId,\n isTraceId,\n safeErrorRecord,\n type ObservationEvent,\n type ObservationPort,\n type ObservationSpan,\n type OpenObservationSpanInput,\n type OperationStatus,\n type SafeErrorRecord,\n} from '@alvin0/ai-agent-sdk-core'\nimport {\n projectLog,\n projectMetrics,\n type LogLevel,\n type ObservationContentPolicy,\n type ObservationProcessor,\n} from '@alvin0/ai-agent-sdk-core/observability'\n\nexport const OTEL_SEMANTIC_CONVENTIONS_COMMIT = '5ca9052bc796ef1e497200b1d558fd87a201f335'\n\nconst MAX_DIAGNOSTICS = 100\nconst LOG_SEVERITY: Readonly<Record<LogLevel, number>> = Object.freeze({\n trace: 1,\n debug: 5,\n info: 9,\n warn: 13,\n error: 17,\n fatal: 21,\n})\n\nexport class OpenTelemetryBridgeError extends Error {\n override readonly name = 'OpenTelemetryBridgeError'\n readonly code = OBSERVATION_ERROR_CODES.OTEL_PROVIDER_UNCONFIGURED\n}\n\nexport interface OpenTelemetryBridgeOptions {\n readonly tracer: Tracer\n readonly meter: Meter\n readonly logger?: OpenTelemetryLogger\n /** Exact prompt/completion span attributes remain disabled unless this is explicitly `full`. */\n readonly content?: ObservationContentPolicy\n readonly onDiagnostic?: (error: SafeErrorRecord) => void\n}\n\nexport interface OpenTelemetryBridge {\n readonly openSpan: ObservationPort['openSpan']\n readonly processor: ObservationProcessor\n diagnostics(): readonly SafeErrorRecord[]\n}\n\n/** Structural log API so consumers that omit logging need not install the optional logs peer. */\nexport interface OpenTelemetryLogger {\n emit(record: OpenTelemetryLogRecord): void\n enabled?(options?: OpenTelemetryLogEnabledOptions): boolean\n}\n\nexport interface OpenTelemetryLogRecord {\n readonly context?: Context\n readonly [key: string]: unknown\n}\n\nexport interface OpenTelemetryLogEnabledOptions {\n readonly context?: Context\n readonly [key: string]: unknown\n}\n\ninterface SpanState {\n readonly span: Span\n readonly context: Context\n readonly spanContext: SpanContext\n readonly sdkSpanId: string\n endRequested?: { readonly status: OperationStatus; readonly endedAt: string }\n terminalSeen: boolean\n finished: boolean\n}\n\ninterface MetricSinks {\n readonly sdkModelDuration: Histogram\n readonly sdkProviderDuration: Histogram\n readonly sdkToolDuration: Histogram\n readonly sdkTokenUsage: Counter\n readonly sdkUsageCoverage: Counter\n readonly sdkProviderRetry: Counter\n readonly genAiClientDuration: Histogram\n readonly genAiTokenUsage: Histogram\n readonly genAiAgentDuration: Histogram\n readonly genAiToolDuration: Histogram\n}\n\nfunction object(value: unknown): Readonly<Record<string, unknown>> | undefined {\n return typeof value === 'object' && value !== null && !Array.isArray(value)\n ? value as Readonly<Record<string, unknown>>\n : undefined\n}\n\nfunction finite(value: unknown): number | undefined {\n return typeof value === 'number' && Number.isFinite(value) ? value : undefined\n}\n\nfunction counter(value: unknown): number | undefined {\n return typeof value === 'number' && Number.isSafeInteger(value) && value >= 0 ? value : undefined\n}\n\nfunction string(value: unknown): string | undefined {\n return typeof value === 'string' && value.length > 0 ? value : undefined\n}\n\nfunction initialSpan(input: OpenObservationSpanInput): {\n readonly name: string\n readonly kind: SpanKind\n readonly attributes: Attributes\n} {\n const operation = input.name === 'sdk.agent.run'\n ? 'invoke_agent'\n : input.name === 'sdk.model.call'\n ? 'chat'\n : input.name === 'sdk.tool.call'\n ? 'execute_tool'\n : undefined\n return {\n name: operation ?? input.name,\n kind: input.name === 'sdk.model.call' || input.name === 'sdk.provider.attempt'\n ? SpanKind.CLIENT\n : SpanKind.INTERNAL,\n attributes: {\n 'ai_agent_sdk.operation.name': input.name,\n 'ai_agent_sdk.run.id': input.runId,\n ...operation === undefined ? {} : { 'gen_ai.operation.name': operation },\n },\n }\n}\n\nfunction explicitParent(input: OpenObservationSpanInput, states: Map<string, SpanState>): Context {\n if (input.parent === undefined) return ROOT_CONTEXT\n const owned = states.get(input.parent.spanId)\n if (owned !== undefined) return owned.context\n return trace.setSpanContext(ROOT_CONTEXT, {\n traceId: input.parent.traceId,\n spanId: input.parent.spanId,\n traceFlags: TraceFlags.SAMPLED,\n isRemote: false,\n })\n}\n\nfunction traceparent(context: SpanContext): string {\n const flags = (context.traceFlags & 0xff).toString(16).padStart(2, '0')\n return `00-${context.traceId}-${context.spanId}-${flags}`\n}\n\nfunction statusAttributes(event: ObservationEvent): Attributes {\n const status = string(event.data.status)\n const error = object(event.data.error)\n const errorType = string(error?.code) ?? string(error?.type) ?? (status === 'success' ? undefined : status)\n return {\n ...status === undefined ? {} : { 'ai_agent_sdk.operation.status': status },\n ...errorType === undefined ? {} : { 'error.type': errorType },\n }\n}\n\nfunction contentAttributes(event: ObservationEvent): Attributes {\n const input = event.data.inputMessages ?? event.data.prompt\n const output = event.data.outputMessages ?? event.data.completion ?? event.data.response\n const render = (value: unknown): string | undefined => {\n if (value === undefined) return undefined\n return typeof value === 'string' ? value : JSON.stringify(value)\n }\n const renderedInput = render(input)\n const renderedOutput = render(output)\n return {\n ...renderedInput === undefined ? {} : { 'gen_ai.input.messages': renderedInput },\n ...renderedOutput === undefined ? {} : { 'gen_ai.output.messages': renderedOutput },\n }\n}\n\nfunction applySpanEvent(state: SpanState, event: ObservationEvent, allowContent: boolean): void {\n const span = state.span\n const attributes: Attributes = {\n 'ai_agent_sdk.event.id': event.eventId,\n 'ai_agent_sdk.event.sequence': event.sequence,\n ...statusAttributes(event),\n }\n if (event.correlation.conversationId !== undefined) {\n attributes['gen_ai.conversation.id'] = event.correlation.conversationId\n }\n if (event.name === 'sdk.agent.run') {\n const agentId = string(event.data.agentId)\n if (agentId !== undefined) attributes['gen_ai.agent.id'] = agentId\n span.updateName('invoke_agent')\n } else if (event.name === 'sdk.model.call') {\n const provider = string(event.data.provider)\n const model = string(event.data.model)\n if (provider !== undefined) attributes['gen_ai.provider.name'] = provider\n if (model !== undefined) {\n attributes[event.phase === 'start' ? 'gen_ai.request.model' : 'gen_ai.response.model'] = model\n span.updateName(`chat ${model}`)\n }\n if (allowContent) Object.assign(attributes, contentAttributes(event))\n if (event.phase === 'end') Object.assign(attributes, reportedUsageAttributes(event))\n } else if (event.name === 'sdk.provider.attempt') {\n const provider = string(event.data.provider)\n const model = string(event.data.model)\n const method = string(event.data.method)\n const origin = string(event.data.origin)\n if (provider !== undefined) attributes['gen_ai.provider.name'] = provider\n if (model !== undefined) attributes['gen_ai.request.model'] = model\n if (method !== undefined) attributes['http.request.method'] = method\n if (counter(event.data.httpStatus) !== undefined) attributes['http.response.status_code'] = event.data.httpStatus as number\n if (origin !== undefined) {\n try {\n const url = new URL(origin)\n attributes['server.address'] = url.hostname\n attributes['url.scheme'] = url.protocol.slice(0, -1)\n if (url.port.length > 0) attributes['server.port'] = Number(url.port)\n } catch { /* origin was already validated upstream; omit it if a custom event is malformed */ }\n }\n } else if (event.name === 'sdk.tool.call') {\n const explicitName = string(event.data.toolName)\n const legacyName = string(event.data.name)?.replace(/^execute_tool\\s+/, '')\n const toolName = explicitName ?? legacyName\n if (toolName !== undefined) {\n attributes['gen_ai.tool.name'] = toolName\n span.updateName(`execute_tool ${toolName}`)\n }\n if (event.correlation.toolCallId !== undefined) {\n attributes['gen_ai.tool.call.id'] = event.correlation.toolCallId\n }\n }\n span.setAttributes(attributes)\n}\n\nfunction reportedUsage(event: ObservationEvent): Readonly<Record<string, unknown>> | undefined {\n const direct = object(event.data.reported)\n if (direct !== undefined) return direct\n return object(object(event.data.usageReport)?.reported) ?? object(object(event.data.usage)?.reported)\n}\n\nfunction estimatedUsage(event: ObservationEvent): Readonly<Record<string, unknown>> | undefined {\n return object(object(event.data.usageReport)?.estimated) ?? object(object(event.data.usage)?.estimated)\n}\n\nfunction reportedUsageAttributes(event: ObservationEvent): Attributes {\n const usage = reportedUsage(event)\n if (usage === undefined) return {}\n const uncached = counter(usage.inputTokens)\n const cacheRead = counter(usage.cacheReadTokens)\n const cacheWrite = counter(usage.cacheWriteTokens)\n const output = counter(usage.outputTokens)\n const inputParts = [uncached, cacheRead, cacheWrite].filter((value): value is number => value !== undefined)\n const input = inputParts.length === 0 ? undefined : inputParts.reduce((sum, value) => sum + value, 0)\n return {\n ...input === undefined || !Number.isSafeInteger(input) ? {} : { 'gen_ai.usage.input_tokens': input },\n ...output === undefined ? {} : { 'gen_ai.usage.output_tokens': output },\n ...cacheRead === undefined ? {} : { 'gen_ai.usage.cache_read.input_tokens': cacheRead },\n ...cacheWrite === undefined ? {} : { 'gen_ai.usage.cache_write.input_tokens': cacheWrite },\n ...counter(usage.reasoningTokens) === undefined\n ? {}\n : { 'gen_ai.usage.reasoning.output_tokens': usage.reasoningTokens as number },\n }\n}\n\nfunction metricAttributes(event: ObservationEvent): Attributes {\n const error = object(event.data.error)\n return {\n ...string(event.data.provider) === undefined ? {} : { 'gen_ai.provider.name': event.data.provider as string },\n ...string(event.data.operation) === undefined ? {} : { 'ai_agent_sdk.operation': event.data.operation as string },\n ...string(event.data.status) === undefined ? {} : { 'ai_agent_sdk.status': event.data.status as string },\n ...string(error?.code) === undefined ? {} : { 'error.type': error?.code as string },\n }\n}\n\nfunction recordInternalUsage(sinks: MetricSinks, event: ObservationEvent): void {\n if (event.phase !== 'end') return\n const reported = reportedUsage(event)\n const estimated = estimatedUsage(event)\n const base = metricAttributes(event)\n if (event.name === 'sdk.model.call') {\n recordCounterSet(sinks.sdkTokenUsage, reported, 'reported', base)\n recordCounterSet(sinks.sdkTokenUsage, estimated, 'estimated', base)\n const coverage = string(event.data.coverage) ?? string(object(event.data.usageReport)?.coverage)\n if (coverage !== undefined) sinks.sdkUsageCoverage.add(1, { ...base, 'ai_agent_sdk.usage.coverage': coverage })\n recordSemanticUsage(sinks, reported, base)\n } else if (event.name === 'sdk.agent.run') {\n recordCounterSet(sinks.sdkTokenUsage, estimated, 'estimated', base)\n const coverage = object(object(event.data.usage)?.coverage)\n for (const state of ['complete', 'partial', 'estimated', 'missing', 'notApplicable'] as const) {\n const value = counter(coverage?.[state])\n if (value !== undefined && value > 0) sinks.sdkUsageCoverage.add(value, {\n ...base,\n 'ai_agent_sdk.usage.coverage': state === 'notApplicable' ? 'not-applicable' : state,\n })\n }\n }\n}\n\nfunction recordCounterSet(\n instrument: Counter,\n values: Readonly<Record<string, unknown>> | undefined,\n source: 'reported' | 'estimated',\n base: Attributes,\n): void {\n if (values === undefined) return\n for (const [key, tokenType] of [\n ['inputTokens', 'input'],\n ['outputTokens', 'output'],\n ['cacheReadTokens', 'cache-read'],\n ['cacheWriteTokens', 'cache-write'],\n ['reasoningTokens', 'reasoning'],\n ] as const) {\n const value = counter(values[key])\n if (value !== undefined) instrument.add(value, {\n ...base,\n 'ai_agent_sdk.token.type': tokenType,\n 'ai_agent_sdk.usage.source': source,\n })\n }\n}\n\nfunction recordSemanticUsage(\n sinks: MetricSinks,\n values: Readonly<Record<string, unknown>> | undefined,\n base: Attributes,\n): void {\n if (values === undefined) return\n const uncached = counter(values.inputTokens)\n const cacheRead = counter(values.cacheReadTokens) ?? 0\n const cacheWrite = counter(values.cacheWriteTokens) ?? 0\n const output = counter(values.outputTokens)\n const hasInput = uncached !== undefined\n || counter(values.cacheReadTokens) !== undefined\n || counter(values.cacheWriteTokens) !== undefined\n if (hasInput) {\n const input = (uncached ?? 0) + cacheRead + cacheWrite\n if (Number.isSafeInteger(input)) sinks.genAiTokenUsage.record(input, {\n ...base,\n 'gen_ai.operation.name': 'chat',\n 'gen_ai.token.type': 'input',\n 'ai_agent_sdk.usage.source': 'reported',\n })\n }\n if (output !== undefined) sinks.genAiTokenUsage.record(output, {\n ...base,\n 'gen_ai.operation.name': 'chat',\n 'gen_ai.token.type': 'output',\n 'ai_agent_sdk.usage.source': 'reported',\n })\n}\n\nfunction recordMetrics(sinks: MetricSinks, event: ObservationEvent): void {\n const base = metricAttributes(event)\n for (const projection of projectMetrics(event)) {\n const attributes = { ...base, ...projection.attributes } as Attributes\n switch (projection.name) {\n case 'ai_agent_sdk.model.call.duration':\n sinks.sdkModelDuration.record(projection.value, attributes)\n sinks.genAiClientDuration.record(projection.value / 1_000, {\n ...base, 'gen_ai.operation.name': 'chat',\n })\n break\n case 'ai_agent_sdk.provider.attempt.duration': sinks.sdkProviderDuration.record(projection.value, attributes); break\n case 'ai_agent_sdk.tool.call.duration':\n sinks.sdkToolDuration.record(projection.value, attributes)\n sinks.genAiToolDuration.record(projection.value / 1_000, {\n ...base, 'gen_ai.operation.name': 'execute_tool',\n })\n break\n case 'ai_agent_sdk.provider.retry': sinks.sdkProviderRetry.add(projection.value, attributes); break\n // Usage is mapped from the canonical reported/estimated shapes below so\n // model, attempt, and run aggregates cannot double count one call.\n case 'ai_agent_sdk.token.usage':\n case 'ai_agent_sdk.usage.coverage': break\n }\n }\n if (event.name === 'sdk.agent.run' && event.phase === 'end') {\n const duration = finite(event.data.durationMs)\n if (duration !== undefined) sinks.genAiAgentDuration.record(duration / 1_000, {\n ...base, 'gen_ai.operation.name': 'invoke_agent',\n })\n }\n recordInternalUsage(sinks, event)\n}\n\nfunction createMetricSinks(meter: Meter): MetricSinks {\n return {\n sdkModelDuration: meter.createHistogram('ai_agent_sdk.model.call.duration', { unit: 'ms' }),\n sdkProviderDuration: meter.createHistogram('ai_agent_sdk.provider.attempt.duration', { unit: 'ms' }),\n sdkToolDuration: meter.createHistogram('ai_agent_sdk.tool.call.duration', { unit: 'ms' }),\n sdkTokenUsage: meter.createCounter('ai_agent_sdk.token.usage', { unit: '{token}' }),\n sdkUsageCoverage: meter.createCounter('ai_agent_sdk.usage.coverage', { unit: '{call}' }),\n sdkProviderRetry: meter.createCounter('ai_agent_sdk.provider.retry', { unit: '{retry}' }),\n genAiClientDuration: meter.createHistogram('gen_ai.client.operation.duration', { unit: 's' }),\n genAiTokenUsage: meter.createHistogram('gen_ai.client.token.usage', { unit: '{token}' }),\n genAiAgentDuration: meter.createHistogram('gen_ai.invoke_agent.duration', { unit: 's' }),\n genAiToolDuration: meter.createHistogram('gen_ai.execute_tool.duration', { unit: 's' }),\n }\n}\n\nfunction logContext(event: ObservationEvent, states: Map<string, SpanState>): Context {\n const state = states.get(event.correlation.spanId)\n if (state !== undefined) return state.context\n return trace.setSpanContext(ROOT_CONTEXT, {\n traceId: event.correlation.traceId,\n spanId: event.correlation.spanId,\n traceFlags: TraceFlags.SAMPLED,\n isRemote: false,\n })\n}\n\nfunction emitLog(logger: OpenTelemetryLogger | undefined, event: ObservationEvent, states: Map<string, SpanState>): void {\n if (logger === undefined) return\n const projected = projectLog(event)\n if (projected === undefined) return\n const severityNumber = LOG_SEVERITY[projected.level]\n const context = logContext(event, states)\n if (logger.enabled?.({ context, severityNumber, eventName: 'ai_agent_sdk.log' }) === false) return\n logger.emit({\n eventName: 'ai_agent_sdk.log',\n timestamp: new Date(event.occurredAt),\n severityNumber,\n severityText: projected.level.toUpperCase(),\n body: projected.message,\n attributes: {\n ...projected.fields,\n 'ai_agent_sdk.event.id': projected.eventId,\n 'ai_agent_sdk.run.id': event.correlation.runId,\n },\n context,\n })\n}\n\n/** Build a mapping-only bridge around caller-owned OpenTelemetry API objects. */\nexport function createOpenTelemetryBridge(options: OpenTelemetryBridgeOptions): OpenTelemetryBridge {\n if (typeof options?.tracer?.startSpan !== 'function') throw new TypeError('OpenTelemetry bridge requires a tracer')\n if (typeof options?.meter?.createHistogram !== 'function' || typeof options.meter.createCounter !== 'function') {\n throw new TypeError('OpenTelemetry bridge requires a meter')\n }\n if (!['none', 'metadata', 'redacted', 'full'].includes(options.content ?? 'none')) {\n throw new TypeError('OpenTelemetry bridge content policy is invalid')\n }\n if (options.logger !== undefined && typeof options.logger.emit !== 'function') {\n throw new TypeError('OpenTelemetry bridge logger is invalid')\n }\n const states = new Map<string, SpanState>()\n const diagnostics: SafeErrorRecord[] = []\n const sinks = createMetricSinks(options.meter)\n const recordDiagnostic = (error: unknown): void => {\n const source = safeErrorRecord(error)\n const safe = deepFreeze({\n type: source.type,\n message: source.code === OBSERVATION_ERROR_CODES.OTEL_PROVIDER_UNCONFIGURED\n ? 'OpenTelemetry tracer provider is unconfigured or returned an invalid context'\n : 'OpenTelemetry bridge API call failed',\n ...source.code === undefined ? {} : { code: source.code },\n })\n diagnostics.push(safe)\n if (diagnostics.length > MAX_DIAGNOSTICS) diagnostics.shift()\n try { options.onDiagnostic?.(safe) } catch { /* caller diagnostics are contained */ }\n }\n const finish = (state: SpanState): void => {\n if (state.finished || state.endRequested === undefined) return\n state.finished = true\n states.delete(state.sdkSpanId)\n const request = state.endRequested\n const success = request.status === 'success'\n let failure: unknown\n try {\n state.span.setStatus({\n code: success ? SpanStatusCode.OK : SpanStatusCode.ERROR,\n ...success ? {} : { message: request.status },\n })\n } catch (error) { failure = error }\n try { state.span.end(new Date(request.endedAt)) }\n catch (error) { failure ??= error }\n if (failure !== undefined) throw failure\n }\n const openSpanImpl = (input: OpenObservationSpanInput): ObservationSpan => {\n const initial = initialSpan(input)\n const parentContext = explicitParent(input, states)\n const span = options.tracer.startSpan(initial.name, {\n kind: initial.kind,\n attributes: initial.attributes,\n startTime: new Date(input.startedAt),\n root: input.parent === undefined,\n }, parentContext)\n let spanContext: SpanContext\n try { spanContext = span.spanContext() }\n catch (error) {\n try { span.end() } catch { /* original failure remains authoritative */ }\n throw error\n }\n if (!isSpanContextValid(spanContext) || !isTraceId(spanContext.traceId) || !isSpanId(spanContext.spanId)\n || !Number.isInteger(spanContext.traceFlags) || spanContext.traceFlags < 0 || spanContext.traceFlags > 255\n || (input.parent !== undefined && spanContext.traceId !== input.parent.traceId)\n || states.has(spanContext.spanId)) {\n try { span.end() } catch { /* invalid identity remains authoritative */ }\n const error = new OpenTelemetryBridgeError('supplied tracer returned an invalid or disconnected span context')\n throw error\n }\n const correlation = freezeCorrelation({\n traceId: spanContext.traceId,\n spanId: spanContext.spanId,\n parentSpanId: input.parent?.spanId ?? null,\n runId: input.runId,\n ...(input.correlation ?? {}),\n })\n const state: SpanState = {\n span,\n spanContext,\n context: trace.setSpan(parentContext, span),\n sdkSpanId: spanContext.spanId,\n terminalSeen: false,\n finished: false,\n }\n states.set(state.sdkSpanId, state)\n let ended = false\n return Object.freeze({\n correlation,\n traceparent: traceparent(spanContext),\n end(status: OperationStatus, endedAt: string): void {\n if (ended) return\n ended = true\n state.endRequested = { status, endedAt }\n if (state.terminalSeen) {\n try { finish(state) }\n catch (error) { recordDiagnostic(error); throw error }\n return\n }\n queueMicrotask(() => {\n try { finish(state) } catch (error) { recordDiagnostic(error) }\n })\n },\n })\n }\n const openSpan = (input: OpenObservationSpanInput): ObservationSpan => {\n try { return openSpanImpl(input) }\n catch (error) { recordDiagnostic(error); throw error }\n }\n const processor: ObservationProcessor = Object.freeze({\n id: 'otel',\n transform(event: ObservationEvent): ObservationEvent {\n try {\n const state = states.get(event.correlation.spanId)\n if (state !== undefined) {\n applySpanEvent(state, event, options.content === 'full')\n if (event.phase === 'end') {\n state.terminalSeen = true\n finish(state)\n } else if (event.phase === 'point') {\n state.span.addEvent(event.name, statusAttributes(event), new Date(event.occurredAt))\n }\n }\n recordMetrics(sinks, event)\n emitLog(options.logger, event, states)\n return event\n } catch (error) {\n recordDiagnostic(error)\n throw error\n }\n },\n })\n return Object.freeze({\n openSpan,\n processor,\n diagnostics: () => deepFreeze([...diagnostics]),\n })\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.js","names":[],"sources":["../src/bridge-types.ts","../src/bridge-values.ts","../src/bridge-usage.ts","../src/bridge-spans.ts","../src/bridge-lifecycle.ts","../src/bridge-metrics.ts","../src/bridge-logs.ts","../src/bridge.ts"],"sourcesContent":["import {\n type Context,\n type Counter,\n type Histogram,\n type Meter,\n type Span,\n type SpanContext,\n type Tracer,\n} from '@opentelemetry/api'\nimport {\n OBSERVATION_ERROR_CODES,\n type ObservationPort,\n type OperationStatus,\n type SafeErrorRecord,\n} from '@alvin0/ai-agent-sdk-core'\nimport {\n type ObservationContentPolicy,\n type ObservationProcessor,\n} from '@alvin0/ai-agent-sdk-core/observability'\n\nexport const OTEL_SEMANTIC_CONVENTIONS_COMMIT = '5ca9052bc796ef1e497200b1d558fd87a201f335'\n\nexport class OpenTelemetryBridgeError extends Error {\n override readonly name = 'OpenTelemetryBridgeError'\n readonly code = OBSERVATION_ERROR_CODES.OTEL_PROVIDER_UNCONFIGURED\n}\n\nexport interface OpenTelemetryBridgeOptions {\n readonly tracer: Tracer\n readonly meter: Meter\n readonly logger?: OpenTelemetryLogger\n /** Exact prompt/completion span attributes remain disabled unless this is explicitly `full`. */\n readonly content?: ObservationContentPolicy\n readonly onDiagnostic?: (error: SafeErrorRecord) => void\n}\n\nexport interface OpenTelemetryBridge {\n readonly openSpan: ObservationPort['openSpan']\n readonly processor: ObservationProcessor\n diagnostics(): readonly SafeErrorRecord[]\n}\n\nexport interface OpenTelemetryLogger {\n emit(record: OpenTelemetryLogRecord): void\n enabled?(options?: OpenTelemetryLogEnabledOptions): boolean\n}\n\nexport interface OpenTelemetryLogRecord {\n readonly context?: Context\n readonly [key: string]: unknown\n}\n\nexport interface OpenTelemetryLogEnabledOptions {\n readonly context?: Context\n readonly [key: string]: unknown\n}\n\nexport interface SpanState {\n readonly span: Span\n readonly context: Context\n readonly spanContext: SpanContext\n readonly sdkSpanId: string\n endRequested?: { readonly status: OperationStatus; readonly endedAt: string }\n terminalSeen: boolean\n finished: boolean\n}\n\nexport interface MetricSinks {\n readonly sdkModelDuration: Histogram\n readonly sdkProviderDuration: Histogram\n readonly sdkToolDuration: Histogram\n readonly sdkTokenUsage: Counter\n readonly sdkUsageCoverage: Counter\n readonly sdkProviderRetry: Counter\n readonly genAiClientDuration: Histogram\n readonly genAiTokenUsage: Histogram\n readonly genAiAgentDuration: Histogram\n readonly genAiToolDuration: Histogram\n}\n","export function object(value: unknown): Readonly<Record<string, unknown>> | undefined {\n return typeof value === 'object' && value !== null && !Array.isArray(value)\n ? value as Readonly<Record<string, unknown>>\n : undefined\n}\n\nexport function finite(value: unknown): number | undefined {\n return typeof value === 'number' && Number.isFinite(value) ? value : undefined\n}\n\nexport function counter(value: unknown): number | undefined {\n return typeof value === 'number' && Number.isSafeInteger(value) && value >= 0 ? value : undefined\n}\n\nexport function string(value: unknown): string | undefined {\n return typeof value === 'string' && value.length > 0 ? value : undefined\n}\n","import {\n type Attributes,\n} from '@opentelemetry/api'\nimport {\n type ObservationEvent,\n} from '@alvin0/ai-agent-sdk-core'\n\nimport { object, counter } from './bridge-values.ts'\nexport function reportedUsage(event: ObservationEvent): Readonly<Record<string, unknown>> | undefined {\n const direct = object(event.data.reported)\n if (direct !== undefined) return direct\n return object(object(event.data.usageReport)?.reported) ?? object(object(event.data.usage)?.reported)\n}\n\nexport function estimatedUsage(event: ObservationEvent): Readonly<Record<string, unknown>> | undefined {\n return object(object(event.data.usageReport)?.estimated) ?? object(object(event.data.usage)?.estimated)\n}\n\nexport function reportedUsageAttributes(event: ObservationEvent): Attributes {\n const usage = reportedUsage(event)\n if (usage === undefined) return {}\n const uncached = counter(usage.inputTokens)\n const cacheRead = counter(usage.cacheReadTokens)\n const cacheWrite = counter(usage.cacheWriteTokens)\n const output = counter(usage.outputTokens)\n const inputParts = [uncached, cacheRead, cacheWrite].filter((value): value is number => value !== undefined)\n const input = inputParts.length === 0 ? undefined : inputParts.reduce((sum, value) => sum + value, 0)\n return {\n ...input === undefined || !Number.isSafeInteger(input) ? {} : { 'gen_ai.usage.input_tokens': input },\n ...output === undefined ? {} : { 'gen_ai.usage.output_tokens': output },\n ...cacheRead === undefined ? {} : { 'gen_ai.usage.cache_read.input_tokens': cacheRead },\n ...cacheWrite === undefined ? {} : { 'gen_ai.usage.cache_write.input_tokens': cacheWrite },\n ...counter(usage.reasoningTokens) === undefined\n ? {}\n : { 'gen_ai.usage.reasoning.output_tokens': usage.reasoningTokens as number },\n }\n}\n","import {\n ROOT_CONTEXT,\n SpanKind,\n TraceFlags,\n trace,\n type Attributes,\n type Context,\n type Span,\n type SpanContext,\n} from '@opentelemetry/api'\nimport {\n type ObservationEvent,\n type OpenObservationSpanInput,\n} from '@alvin0/ai-agent-sdk-core'\n\nimport type { SpanState } from './bridge-types.ts'\nimport { object, counter, string } from './bridge-values.ts'\nimport { reportedUsageAttributes } from './bridge-usage.ts'\nexport function initialSpan(input: OpenObservationSpanInput): {\n readonly name: string\n readonly kind: SpanKind\n readonly attributes: Attributes\n} {\n const operation = operationName(input.name)\n return {\n name: operation ?? input.name,\n kind: input.name === 'sdk.model.call' || input.name === 'sdk.provider.attempt'\n ? SpanKind.CLIENT\n : SpanKind.INTERNAL,\n attributes: {\n 'ai_agent_sdk.operation.name': input.name,\n 'ai_agent_sdk.run.id': input.runId,\n ...operation === undefined ? {} : { 'gen_ai.operation.name': operation },\n },\n }\n}\n\nexport function explicitParent(input: OpenObservationSpanInput, states: Map<string, SpanState>): Context {\n if (input.parent === undefined) return ROOT_CONTEXT\n const owned = states.get(input.parent.spanId)\n if (owned !== undefined) return owned.context\n return trace.setSpanContext(ROOT_CONTEXT, {\n traceId: input.parent.traceId,\n spanId: input.parent.spanId,\n traceFlags: TraceFlags.SAMPLED,\n isRemote: false,\n })\n}\n\nexport function traceparent(context: SpanContext): string {\n const flags = (context.traceFlags & 0xff).toString(16).padStart(2, '0')\n return `00-${context.traceId}-${context.spanId}-${flags}`\n}\n\nexport function statusAttributes(event: ObservationEvent): Attributes {\n const status = string(event.data.status)\n const error = object(event.data.error)\n const errorType = string(error?.code) ?? string(error?.type) ?? (status === 'success' ? undefined : status)\n return {\n ...status === undefined ? {} : { 'ai_agent_sdk.operation.status': status },\n ...errorType === undefined ? {} : { 'error.type': errorType },\n }\n}\n\nexport function contentAttributes(event: ObservationEvent): Attributes {\n const input = event.data.inputMessages ?? event.data.prompt\n const output = event.data.outputMessages ?? event.data.completion ?? event.data.response\n const render = (value: unknown): string | undefined => {\n if (value === undefined) return undefined\n return typeof value === 'string' ? value : JSON.stringify(value)\n }\n const renderedInput = render(input)\n const renderedOutput = render(output)\n return {\n ...renderedInput === undefined ? {} : { 'gen_ai.input.messages': renderedInput },\n ...renderedOutput === undefined ? {} : { 'gen_ai.output.messages': renderedOutput },\n }\n}\n\nexport function applySpanEvent(state: SpanState, event: ObservationEvent, allowContent: boolean): void {\n const span = state.span\n const attributes: Attributes = {\n 'ai_agent_sdk.event.id': event.eventId,\n 'ai_agent_sdk.event.sequence': event.sequence,\n ...statusAttributes(event),\n }\n if (event.correlation.conversationId !== undefined) {\n attributes['gen_ai.conversation.id'] = event.correlation.conversationId\n }\n switch (event.name) {\n case 'sdk.agent.run': applyAgentSpan(span, event, attributes); break\n case 'sdk.model.call': applyModelSpan(span, event, attributes, allowContent); break\n case 'sdk.provider.attempt': applyProviderSpan(event, attributes); break\n case 'sdk.tool.call': applyToolSpan(span, event, attributes); break\n }\n span.setAttributes(attributes)\n}\n\nfunction operationName(name: string): string | undefined {\n if (name === 'sdk.agent.run') return 'invoke_agent'\n if (name === 'sdk.model.call') return 'chat'\n if (name === 'sdk.tool.call') return 'execute_tool'\n return undefined\n}\n\nfunction applyAgentSpan(span: Span, event: ObservationEvent, attributes: Attributes): void {\n const agentId = string(event.data.agentId)\n if (agentId !== undefined) attributes['gen_ai.agent.id'] = agentId\n span.updateName('invoke_agent')\n}\n\nfunction applyModelSpan(span: Span, event: ObservationEvent, attributes: Attributes, allowContent: boolean): void {\n const provider = string(event.data.provider)\n const model = string(event.data.model)\n if (provider !== undefined) attributes['gen_ai.provider.name'] = provider\n if (model !== undefined) {\n attributes[event.phase === 'start' ? 'gen_ai.request.model' : 'gen_ai.response.model'] = model\n span.updateName(`chat ${model}`)\n }\n if (allowContent) Object.assign(attributes, contentAttributes(event))\n if (event.phase === 'end') Object.assign(attributes, reportedUsageAttributes(event))\n}\n\nfunction applyProviderSpan(event: ObservationEvent, attributes: Attributes): void {\n const provider = string(event.data.provider)\n const model = string(event.data.model)\n const method = string(event.data.method)\n const origin = string(event.data.origin)\n if (provider !== undefined) attributes['gen_ai.provider.name'] = provider\n if (model !== undefined) attributes['gen_ai.request.model'] = model\n if (method !== undefined) attributes['http.request.method'] = method\n if (counter(event.data.httpStatus) !== undefined) {\n attributes['http.response.status_code'] = event.data.httpStatus as number\n }\n if (origin !== undefined) {\n try {\n const url = new URL(origin)\n attributes['server.address'] = url.hostname\n attributes['url.scheme'] = url.protocol.slice(0, -1)\n if (url.port.length > 0) attributes['server.port'] = Number(url.port)\n } catch { /* origin was already validated upstream; omit it if a custom event is malformed */ }\n }\n}\n\nfunction applyToolSpan(span: Span, event: ObservationEvent, attributes: Attributes): void {\n const explicitName = string(event.data.toolName)\n const legacyName = string(event.data.name)?.replace(/^execute_tool\\s+/, '')\n const toolName = explicitName ?? legacyName\n if (toolName !== undefined) {\n attributes['gen_ai.tool.name'] = toolName\n span.updateName(`execute_tool ${toolName}`)\n }\n if (event.correlation.toolCallId !== undefined) {\n attributes['gen_ai.tool.call.id'] = event.correlation.toolCallId\n }\n\n}\n","import {\n SpanStatusCode,\n isSpanContextValid,\n trace,\n type Span,\n type SpanContext,\n} from '@opentelemetry/api'\nimport {\n OBSERVATION_ERROR_CODES,\n deepFreeze,\n freezeCorrelation,\n isSpanId,\n isTraceId,\n safeErrorRecord,\n type ObservationSpan,\n type OpenObservationSpanInput,\n type OperationStatus,\n type SafeErrorRecord,\n} from '@alvin0/ai-agent-sdk-core'\n\nimport { OpenTelemetryBridgeError, type SpanState, type OpenTelemetryBridgeOptions } from './bridge-types.ts'\nimport { initialSpan, explicitParent, traceparent } from './bridge-spans.ts'\n\nexport interface BridgeContext {\n options: OpenTelemetryBridgeOptions\n states: Map<string, SpanState>\n recordDiagnostic: (error: unknown) => void\n}\n\nconst MAX_DIAGNOSTICS = 100\nexport function diagnosticRecorder(options: OpenTelemetryBridgeOptions, diagnostics: SafeErrorRecord[]) {\n return (error: unknown): void => {\n const source = safeErrorRecord(error)\n const safe = deepFreeze({\n type: source.type,\n message: source.code === OBSERVATION_ERROR_CODES.OTEL_PROVIDER_UNCONFIGURED\n ? 'OpenTelemetry tracer provider is unconfigured or returned an invalid context'\n : 'OpenTelemetry bridge API call failed',\n ...source.code === undefined ? {} : { code: source.code },\n })\n diagnostics.push(safe)\n if (diagnostics.length > MAX_DIAGNOSTICS) diagnostics.shift()\n try { options.onDiagnostic?.(safe) } catch { /* caller diagnostics are contained */ }\n }\n}\n\nexport function finishSpan(states: Map<string, SpanState>, state: SpanState): void {\n if (state.finished || state.endRequested === undefined) return\n state.finished = true\n states.delete(state.sdkSpanId)\n const request = state.endRequested\n const success = request.status === 'success'\n let failure: unknown\n try {\n state.span.setStatus({\n code: success ? SpanStatusCode.OK : SpanStatusCode.ERROR,\n ...success ? {} : { message: request.status },\n })\n } catch (error) { failure = error }\n try { state.span.end(new Date(request.endedAt)) }\n catch (error) { failure ??= error }\n if (failure !== undefined) throw failure\n}\n\ntype CheckedSpanContext = SpanContext & Pick<ObservationSpan['correlation'], 'traceId' | 'spanId'>\n\nfunction checkedSpanContext(\n span: Span, input: OpenObservationSpanInput, states: Map<string, SpanState>,\n): CheckedSpanContext {\n let spanContext: SpanContext\n try { spanContext = span.spanContext() }\n catch (error) {\n try { span.end() } catch { /* original failure remains authoritative */ }\n throw error\n }\n if (!validContext(spanContext) || (input.parent !== undefined && spanContext.traceId !== input.parent.traceId)\n || states.has(spanContext.spanId)) {\n try { span.end() } catch { /* invalid identity remains authoritative */ }\n throw new OpenTelemetryBridgeError('supplied tracer returned an invalid or disconnected span context')\n }\n return spanContext\n}\n\nfunction validContext(value: SpanContext): value is CheckedSpanContext {\n return isSpanContextValid(value) && isTraceId(value.traceId) && isSpanId(value.spanId)\n && Number.isInteger(value.traceFlags) && value.traceFlags >= 0 && value.traceFlags <= 255\n}\n\nfunction makeSpanHandle(\n state: SpanState, correlation: ObservationSpan['correlation'], ctx: BridgeContext,\n): ObservationSpan {\n let ended = false\n return Object.freeze({\n correlation, traceparent: traceparent(state.spanContext),\n end(status: OperationStatus, endedAt: string): void {\n if (ended) return\n ended = true\n state.endRequested = { status, endedAt }\n if (state.terminalSeen) {\n try { finishSpan(ctx.states, state) }\n catch (error) { ctx.recordDiagnostic(error); throw error }\n return\n }\n queueMicrotask(() => {\n try { finishSpan(ctx.states, state) } catch (error) { ctx.recordDiagnostic(error) }\n })\n },\n })\n}\n\nexport function openBridgeSpan(input: OpenObservationSpanInput, ctx: BridgeContext): ObservationSpan {\n const initial = initialSpan(input)\n const parentContext = explicitParent(input, ctx.states)\n const span = ctx.options.tracer.startSpan(initial.name, {\n kind: initial.kind, attributes: initial.attributes, startTime: new Date(input.startedAt),\n root: input.parent === undefined,\n }, parentContext)\n const spanContext = checkedSpanContext(span, input, ctx.states)\n const correlation = freezeCorrelation({\n traceId: spanContext.traceId, spanId: spanContext.spanId, parentSpanId: input.parent?.spanId ?? null,\n runId: input.runId, ...(input.correlation ?? {}),\n })\n const state: SpanState = { span, spanContext, context: trace.setSpan(parentContext, span),\n sdkSpanId: spanContext.spanId, terminalSeen: false, finished: false }\n ctx.states.set(state.sdkSpanId, state)\n return makeSpanHandle(state, correlation, ctx)\n}\n","import {\n type Attributes,\n type Counter,\n type Meter,\n} from '@opentelemetry/api'\nimport {\n type ObservationEvent,\n} from '@alvin0/ai-agent-sdk-core'\nimport {\n projectMetrics,\n} from '@alvin0/ai-agent-sdk-core/observability'\n\nimport type { MetricSinks } from './bridge-types.ts'\nimport { object, string, counter, finite } from './bridge-values.ts'\nimport { reportedUsage, estimatedUsage } from './bridge-usage.ts'\nexport function metricAttributes(event: ObservationEvent): Attributes {\n const error = object(event.data.error)\n return {\n ...string(event.data.provider) === undefined ? {} : { 'gen_ai.provider.name': event.data.provider as string },\n ...string(event.data.operation) === undefined ? {} : { 'ai_agent_sdk.operation': event.data.operation as string },\n ...string(event.data.status) === undefined ? {} : { 'ai_agent_sdk.status': event.data.status as string },\n ...string(error?.code) === undefined ? {} : { 'error.type': error?.code as string },\n }\n}\n\nexport function recordInternalUsage(sinks: MetricSinks, event: ObservationEvent): void {\n if (event.phase !== 'end') return\n const reported = reportedUsage(event)\n const estimated = estimatedUsage(event)\n const base = metricAttributes(event)\n if (event.name === 'sdk.model.call') {\n recordCounterSet(sinks.sdkTokenUsage, reported, 'reported', base)\n recordCounterSet(sinks.sdkTokenUsage, estimated, 'estimated', base)\n const coverage = string(event.data.coverage) ?? string(object(event.data.usageReport)?.coverage)\n if (coverage !== undefined) sinks.sdkUsageCoverage.add(1, { ...base, 'ai_agent_sdk.usage.coverage': coverage })\n recordSemanticUsage(sinks, reported, base)\n } else if (event.name === 'sdk.agent.run') {\n recordCounterSet(sinks.sdkTokenUsage, estimated, 'estimated', base)\n recordRunCoverage(sinks, event, base)\n }\n}\n\nexport function recordCounterSet(\n instrument: Counter,\n values: Readonly<Record<string, unknown>> | undefined,\n source: 'reported' | 'estimated',\n base: Attributes,\n): void {\n if (values === undefined) return\n for (const [key, tokenType] of [\n ['inputTokens', 'input'],\n ['outputTokens', 'output'],\n ['cacheReadTokens', 'cache-read'],\n ['cacheWriteTokens', 'cache-write'],\n ['reasoningTokens', 'reasoning'],\n ] as const) {\n const value = counter(values[key])\n if (value !== undefined) instrument.add(value, {\n ...base,\n 'ai_agent_sdk.token.type': tokenType,\n 'ai_agent_sdk.usage.source': source,\n })\n }\n}\n\nexport function recordSemanticUsage(\n sinks: MetricSinks,\n values: Readonly<Record<string, unknown>> | undefined,\n base: Attributes,\n): void {\n if (values === undefined) return\n const uncached = counter(values.inputTokens)\n const cacheRead = counter(values.cacheReadTokens) ?? 0\n const cacheWrite = counter(values.cacheWriteTokens) ?? 0\n const output = counter(values.outputTokens)\n const hasInput = uncached !== undefined\n || counter(values.cacheReadTokens) !== undefined\n || counter(values.cacheWriteTokens) !== undefined\n if (hasInput) {\n const input = (uncached ?? 0) + cacheRead + cacheWrite\n if (Number.isSafeInteger(input)) sinks.genAiTokenUsage.record(input, {\n ...base,\n 'gen_ai.operation.name': 'chat',\n 'gen_ai.token.type': 'input',\n 'ai_agent_sdk.usage.source': 'reported',\n })\n }\n if (output !== undefined) sinks.genAiTokenUsage.record(output, {\n ...base,\n 'gen_ai.operation.name': 'chat',\n 'gen_ai.token.type': 'output',\n 'ai_agent_sdk.usage.source': 'reported',\n })\n}\n\nexport function recordMetrics(sinks: MetricSinks, event: ObservationEvent): void {\n const base = metricAttributes(event)\n for (const projection of projectMetrics(event)) {\n const attributes = { ...base, ...projection.attributes } as Attributes\n switch (projection.name) {\n case 'ai_agent_sdk.model.call.duration':\n sinks.sdkModelDuration.record(projection.value, attributes)\n sinks.genAiClientDuration.record(projection.value / 1_000, {\n ...base, 'gen_ai.operation.name': 'chat',\n })\n break\n case 'ai_agent_sdk.provider.attempt.duration':\n sinks.sdkProviderDuration.record(projection.value, attributes); break\n case 'ai_agent_sdk.tool.call.duration':\n sinks.sdkToolDuration.record(projection.value, attributes)\n sinks.genAiToolDuration.record(projection.value / 1_000, {\n ...base, 'gen_ai.operation.name': 'execute_tool',\n })\n break\n case 'ai_agent_sdk.provider.retry': sinks.sdkProviderRetry.add(projection.value, attributes); break\n // Usage is mapped from the canonical reported/estimated shapes below so\n // model, attempt, and run aggregates cannot double count one call.\n case 'ai_agent_sdk.token.usage':\n case 'ai_agent_sdk.usage.coverage': break\n }\n }\n recordAgentDuration(sinks, event, base)\n recordInternalUsage(sinks, event)\n}\n\nexport function createMetricSinks(meter: Meter): MetricSinks {\n return {\n sdkModelDuration: meter.createHistogram('ai_agent_sdk.model.call.duration', { unit: 'ms' }),\n sdkProviderDuration: meter.createHistogram('ai_agent_sdk.provider.attempt.duration', { unit: 'ms' }),\n sdkToolDuration: meter.createHistogram('ai_agent_sdk.tool.call.duration', { unit: 'ms' }),\n sdkTokenUsage: meter.createCounter('ai_agent_sdk.token.usage', { unit: '{token}' }),\n sdkUsageCoverage: meter.createCounter('ai_agent_sdk.usage.coverage', { unit: '{call}' }),\n sdkProviderRetry: meter.createCounter('ai_agent_sdk.provider.retry', { unit: '{retry}' }),\n genAiClientDuration: meter.createHistogram('gen_ai.client.operation.duration', { unit: 's' }),\n genAiTokenUsage: meter.createHistogram('gen_ai.client.token.usage', { unit: '{token}' }),\n genAiAgentDuration: meter.createHistogram('gen_ai.invoke_agent.duration', { unit: 's' }),\n genAiToolDuration: meter.createHistogram('gen_ai.execute_tool.duration', { unit: 's' }),\n }\n}\n\nfunction recordRunCoverage(sinks: MetricSinks, event: ObservationEvent, base: Attributes) {\n const coverage = object(object(event.data.usage)?.coverage)\n for (const state of ['complete', 'partial', 'estimated', 'missing', 'notApplicable'] as const) {\n const value = counter(coverage?.[state])\n if (value !== undefined && value > 0) sinks.sdkUsageCoverage.add(value, {\n ...base,\n 'ai_agent_sdk.usage.coverage': state === 'notApplicable' ? 'not-applicable' : state,\n })\n }\n}\n\nfunction recordAgentDuration(sinks: MetricSinks, event: ObservationEvent, base: Attributes) {\n if (event.name === 'sdk.agent.run' && event.phase === 'end') {\n const duration = finite(event.data.durationMs)\n if (duration !== undefined) sinks.genAiAgentDuration.record(duration / 1_000, {\n ...base, 'gen_ai.operation.name': 'invoke_agent',\n })\n }\n}\n","import {\n ROOT_CONTEXT,\n TraceFlags,\n trace,\n type Context,\n} from '@opentelemetry/api'\nimport {\n type ObservationEvent,\n} from '@alvin0/ai-agent-sdk-core'\nimport {\n projectLog,\n type LogLevel,\n} from '@alvin0/ai-agent-sdk-core/observability'\n\nimport type { OpenTelemetryLogger, SpanState } from './bridge-types.ts'\nexport const LOG_SEVERITY: Readonly<Record<LogLevel, number>> = Object.freeze({\n trace: 1,\n debug: 5,\n info: 9,\n warn: 13,\n error: 17,\n fatal: 21,\n})\n\nexport function logContext(event: ObservationEvent, states: Map<string, SpanState>): Context {\n const state = states.get(event.correlation.spanId)\n if (state !== undefined) return state.context\n return trace.setSpanContext(ROOT_CONTEXT, {\n traceId: event.correlation.traceId,\n spanId: event.correlation.spanId,\n traceFlags: TraceFlags.SAMPLED,\n isRemote: false,\n })\n}\n\nexport function emitLog(logger: OpenTelemetryLogger | undefined, event: ObservationEvent,\n states: Map<string, SpanState>): void {\n if (logger === undefined) return\n const projected = projectLog(event)\n if (projected === undefined) return\n const severityNumber = LOG_SEVERITY[projected.level]\n const context = logContext(event, states)\n if (logger.enabled?.({ context, severityNumber, eventName: 'ai_agent_sdk.log' }) === false) return\n logger.emit({\n eventName: 'ai_agent_sdk.log',\n timestamp: new Date(event.occurredAt),\n severityNumber,\n severityText: projected.level.toUpperCase(),\n body: projected.message,\n attributes: {\n ...projected.fields,\n 'ai_agent_sdk.event.id': projected.eventId,\n 'ai_agent_sdk.run.id': event.correlation.runId,\n },\n context,\n })\n}\n","import {\n deepFreeze,\n type ObservationEvent,\n type ObservationSpan,\n type OpenObservationSpanInput,\n type SafeErrorRecord,\n} from '@alvin0/ai-agent-sdk-core'\nimport {\n type ObservationProcessor,\n} from '@alvin0/ai-agent-sdk-core/observability'\n\nimport type { OpenTelemetryBridgeOptions, OpenTelemetryBridge, SpanState, MetricSinks } from './bridge-types.ts'\nexport { OTEL_SEMANTIC_CONVENTIONS_COMMIT, OpenTelemetryBridgeError } from './bridge-types.ts'\nexport type { OpenTelemetryBridgeOptions, OpenTelemetryBridge, OpenTelemetryLogger,\n OpenTelemetryLogRecord, OpenTelemetryLogEnabledOptions } from './bridge-types.ts'\nimport { diagnosticRecorder, finishSpan, openBridgeSpan, type BridgeContext } from './bridge-lifecycle.ts'\nimport { applySpanEvent, statusAttributes } from './bridge-spans.ts'\nimport { createMetricSinks, recordMetrics } from './bridge-metrics.ts'\nimport { emitLog } from './bridge-logs.ts'\n\nfunction validateProviders(options: OpenTelemetryBridgeOptions): void {\n if (typeof options?.tracer?.startSpan !== 'function') throw new TypeError('OpenTelemetry bridge requires a tracer')\n if (typeof options?.meter?.createHistogram !== 'function' || typeof options.meter.createCounter !== 'function') {\n throw new TypeError('OpenTelemetry bridge requires a meter')\n }\n}\n\nfunction validateOptions(options: OpenTelemetryBridgeOptions): void {\n validateProviders(options)\n if (!['none', 'metadata', 'redacted', 'full'].includes(options.content ?? 'none')) {\n throw new TypeError('OpenTelemetry bridge content policy is invalid')\n }\n if (options.logger !== undefined && typeof options.logger.emit !== 'function') {\n throw new TypeError('OpenTelemetry bridge logger is invalid')\n }\n}\n\nfunction transformSpan(ctx: BridgeContext, event: ObservationEvent) {\n const state = ctx.states.get(event.correlation.spanId)\n if (state === undefined) return\n applySpanEvent(state, event, ctx.options.content === 'full')\n if (event.phase === 'end') {\n state.terminalSeen = true\n finishSpan(ctx.states, state)\n } else if (event.phase === 'point') {\n state.span.addEvent(event.name, statusAttributes(event), new Date(event.occurredAt))\n }\n}\n\nfunction createProcessor(ctx: BridgeContext, sinks: MetricSinks): ObservationProcessor {\n return Object.freeze({\n id: 'otel',\n transform(event: ObservationEvent): ObservationEvent {\n try {\n transformSpan(ctx, event)\n recordMetrics(sinks, event)\n emitLog(ctx.options.logger, event, ctx.states)\n return event\n } catch (error) { ctx.recordDiagnostic(error); throw error }\n },\n })\n}\n\n/** Build a mapping-only bridge around caller-owned OpenTelemetry API objects. */\nexport function createOpenTelemetryBridge(options: OpenTelemetryBridgeOptions): OpenTelemetryBridge {\n validateOptions(options)\n const states = new Map<string, SpanState>()\n const diagnostics: SafeErrorRecord[] = []\n const recordDiagnostic = diagnosticRecorder(options, diagnostics)\n const ctx = { options, states, recordDiagnostic }\n const sinks = createMetricSinks(options.meter)\n const openSpan = (input: OpenObservationSpanInput): ObservationSpan => {\n try { return openBridgeSpan(input, ctx) }\n catch (error) { recordDiagnostic(error); throw error }\n }\n return Object.freeze({\n openSpan, processor: createProcessor(ctx, sinks), diagnostics: () => deepFreeze([...diagnostics]),\n })\n}\n"],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
"name": "alvin0 - chaulamdinhai",
|
|
5
5
|
"email": "chaulamdinhai@gmail.com"
|
|
6
6
|
},
|
|
7
|
-
"version": "0.1.
|
|
7
|
+
"version": "0.1.12",
|
|
8
8
|
"description": "Universal OpenTelemetry API bridge for correlated ai-agent-sdk spans, metrics, and logs",
|
|
9
9
|
"license": "MIT",
|
|
10
10
|
"repository": {
|
|
@@ -38,7 +38,7 @@
|
|
|
38
38
|
"provenance": true
|
|
39
39
|
},
|
|
40
40
|
"peerDependencies": {
|
|
41
|
-
"@alvin0/ai-agent-sdk-core": "^0.1.
|
|
41
|
+
"@alvin0/ai-agent-sdk-core": "^0.1.12",
|
|
42
42
|
"@opentelemetry/api": "^1.9.1",
|
|
43
43
|
"@opentelemetry/api-logs": "^0.221.0"
|
|
44
44
|
},
|
|
@@ -48,7 +48,7 @@
|
|
|
48
48
|
}
|
|
49
49
|
},
|
|
50
50
|
"devDependencies": {
|
|
51
|
-
"@alvin0/ai-agent-sdk-core": "^0.1.
|
|
51
|
+
"@alvin0/ai-agent-sdk-core": "^0.1.12",
|
|
52
52
|
"@arethetypeswrong/cli": "0.18.5",
|
|
53
53
|
"@opentelemetry/api": "1.9.1",
|
|
54
54
|
"@opentelemetry/api-logs": "0.221.0",
|