@microsoft/agents-telemetry 1.9.1 → 1.10.0-beta.14.ge6d1defc27
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/README.md +3 -1
- package/dist/cjs/package.json +4 -4
- package/dist/cjs/src/observability/trace.js +3 -1
- package/dist/cjs/src/observability/trace.js.map +1 -1
- package/dist/cjs/src/types.d.ts +11 -0
- package/dist/cjs/src/utils/redact.js +596 -103
- package/dist/cjs/src/utils/redact.js.map +7 -1
- package/dist/cjs/tsconfig.tsbuildinfo +1 -1
- package/dist/esm/src/observability/trace.js +3 -1
- package/dist/esm/src/observability/trace.js.map +1 -1
- package/dist/esm/src/types.d.ts +11 -0
- package/dist/esm/src/utils/redact.js +3 -3
- package/dist/esm/src/utils/redact.js.map +1 -1
- package/dist/esm/tsconfig.esm.tsbuildinfo +1 -1
- package/package.json +4 -4
package/README.md
CHANGED
|
@@ -11,7 +11,7 @@ The package exports:
|
|
|
11
11
|
- `metric` — histogram and counter creation via the OpenTelemetry Meter API
|
|
12
12
|
- `SpanNames` / `MetricNames` — stable name constants for observability across the SDK
|
|
13
13
|
|
|
14
|
-
This package supports both ESM and CommonJS consumers and requires Node.js
|
|
14
|
+
This package supports both ESM and CommonJS consumers and requires Node.js 22 or later.
|
|
15
15
|
|
|
16
16
|
---
|
|
17
17
|
|
|
@@ -176,6 +176,8 @@ This section covers internal APIs used to instrument SDK components. If you are
|
|
|
176
176
|
|
|
177
177
|
Although this package is published, it primarily serves as a shared telemetry layer for other Agents SDK packages. Some exported TypeScript types intentionally depend on OpenTelemetry packages even though runtime behavior still supports noop fallback when those optional peer dependencies are not installed.
|
|
178
178
|
|
|
179
|
+
The `build:esm` command also bundles the ESM-only `@noble/hashes` dependency into the CommonJS redaction module. Run the complete `npm run build` before consuming the package; TypeScript compilation alone does not produce the final CommonJS artifact. This preserves Node.js 22.0+ and browser support without requiring Node's `require(esm)` feature.
|
|
180
|
+
|
|
179
181
|
### Using trace
|
|
180
182
|
|
|
181
183
|
Use `trace` to create validated spans. Every definition requires a `name` from `SpanNames`, a `record` object for tracking state, and an `end` hook called when the span finishes.
|
package/dist/cjs/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://json.schemastore.org/package.json",
|
|
3
3
|
"name": "@microsoft/agents-telemetry",
|
|
4
|
-
"version": "1.
|
|
4
|
+
"version": "1.10.0-beta.14.ge6d1defc27",
|
|
5
5
|
"homepage": "https://github.com/microsoft/Agents-for-js",
|
|
6
6
|
"repository": {
|
|
7
7
|
"type": "git",
|
|
@@ -44,8 +44,8 @@
|
|
|
44
44
|
"@opentelemetry/api-logs": "0.214.0"
|
|
45
45
|
},
|
|
46
46
|
"dependencies": {
|
|
47
|
-
"@microsoft/agents-activity": "1.
|
|
48
|
-
"@noble/hashes": "
|
|
47
|
+
"@microsoft/agents-activity": "1.10.0-beta.14.ge6d1defc27",
|
|
48
|
+
"@noble/hashes": "2.4.0",
|
|
49
49
|
"debug": "4.4.3"
|
|
50
50
|
},
|
|
51
51
|
"license": "MIT",
|
|
@@ -70,6 +70,6 @@
|
|
|
70
70
|
"./package.json": "./package.json"
|
|
71
71
|
},
|
|
72
72
|
"engines": {
|
|
73
|
-
"node": ">=
|
|
73
|
+
"node": ">=22.0.0"
|
|
74
74
|
}
|
|
75
75
|
}
|
|
@@ -53,7 +53,9 @@ function traceFactory(otel) {
|
|
|
53
53
|
const flow = start(otel, target, span, record);
|
|
54
54
|
return (0, attempt_js_1.attempt)({
|
|
55
55
|
try: () => callback({ record: flow.record, actions: flow.actions }),
|
|
56
|
-
catch: (error) => {
|
|
56
|
+
catch: (error) => {
|
|
57
|
+
throw flow.fail(error);
|
|
58
|
+
},
|
|
57
59
|
finally: flow.end
|
|
58
60
|
});
|
|
59
61
|
});
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../../../src/observability/trace.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAWH,gEAA4D;AAC5D,oDAA6C;AAC7C,+CAA8C;AAC9C,iDAA0C;AAC1C,8CAA8C;AAC9C,kDAAwE;AACxE,sDAA0C;AAE1C;;;;;;GAMG;AACH,sBAA8B,IAAU;IACtC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,wBAAS,CAAC,CAAC,CAAA;IACxD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAA;IAElE,MAAM,KAAK,GAAG,SAAS,KAAK,CAAE,MAAM,EAAE,QAAQ;QAC5C,OAAO,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IACnC,CAAkB,CAAA;IAElB,SAAS,QAAQ,CACf,MAA6C,EAC7C,QAA2C,EAC3C,UAAiB;QAEjB,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,iCAAe,CAAC,iBAAiB,CAAC,KAAK,EAAE,uBAAM,CAAC,uBAAuB,CAAC,CAAA;QAChF,CAAC;QAED,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,MAAM,iCAAe,CAAC,iBAAiB,CAAC,KAAK,EAAE,uBAAM,CAAC,oBAAoB,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;QACnH,CAAC;QAED,IAAI,IAAA,4BAAc,EAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAA,qBAAW,EAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAA,qBAAW,GAAE,CAAA;QACzD,CAAC;QAED,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAA;YAEnC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;gBAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;gBAC9C,MAAM,KAAK,GAAG,CAAC,CAAC,UAAU,EAAE,aAAa,EAAE,EAAE,CAC3C,QAAQ,CAAC,UAAU,EAAE,aAAa,EAAE,IAAI,CAAC,CAAuB,CAAA;gBAElE,OAAO;oBACL,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,KAAK;oBACL,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,GAAG,EAAE,IAAI,CAAC,GAAG;iBACd,CAAA;YACH,CAAC;YAED,OAAO,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE;gBAChD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;gBAC9C,OAAO,IAAA,oBAAO,EAAC;oBACb,GAAG,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;oBACnE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,
|
|
1
|
+
{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../../../src/observability/trace.ts"],"names":[],"mappings":"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"}
|
package/dist/cjs/src/types.d.ts
CHANGED
|
@@ -99,7 +99,18 @@ export interface TraceManagedContext<TRecord extends object, TActions extends ob
|
|
|
99
99
|
export interface TraceDefinition<TRecord extends object = Record<string, never>, TActions extends object = Record<string, Function>> {
|
|
100
100
|
name: SpanName;
|
|
101
101
|
record: TRecord;
|
|
102
|
+
/**
|
|
103
|
+
* Creates actions that can enrich the active span.
|
|
104
|
+
*
|
|
105
|
+
* @param context The active trace actions context.
|
|
106
|
+
* @returns The actions available while the span is active.
|
|
107
|
+
*/
|
|
102
108
|
actions?(context: TraceActionsContext): TActions;
|
|
109
|
+
/**
|
|
110
|
+
* Finalizes the span with its collected record, duration, and error state.
|
|
111
|
+
*
|
|
112
|
+
* @param context The context available when the span ends.
|
|
113
|
+
*/
|
|
103
114
|
end(context: TraceEndContext<TRecord>): void;
|
|
104
115
|
}
|
|
105
116
|
/**
|