@microsoft/agents-telemetry 1.7.1 → 1.8.0-beta.34.g5d543f96c0

package/README.md

@@ -97,7 +97,7 @@ sdk.start()
 
 All built-in span categories are enabled by default. To disable one or more categories without changing code, set `AGENTS_TELEMETRY_DISABLED_SPAN_CATEGORIES` in your environment:
 
-```env
+```
 AGENTS_TELEMETRY_DISABLED_SPAN_CATEGORIES=STORAGE,AUTHORIZATION
 
 # or
@@ -183,7 +183,7 @@ For long-lived operations where you need manual control over the span lifecycle:
 ```ts
 import { SpanNames, trace } from '@microsoft/agents-telemetry'
 
-const { record, actions, end, fail } = trace({
+const { record, actions, child, end, fail } = trace({
   name: SpanNames.ADAPTER_PROCESS,
   record: { status: 'pending' },
   end: ({ span, record, duration }) => {
@@ -193,7 +193,20 @@ const { record, actions, end, fail } = trace({
 
 try {
   record({ status: 'processing' })
-  await doWork()
+  const keys = ['conversation']
+  await child(
+    {
+      name: SpanNames.STORAGE_READ,
+      record: { keys: 0 },
+      end: ({ span, record }) => {
+        span.setAttribute('storage.keys', record.keys)
+      },
+    },
+    async ({ record }) => {
+      record({ keys: 5 })
+      await storage.read(keys)
+    }
+  )
   record({ status: 'done' })
   end()
 } catch (error) {
@@ -230,6 +243,8 @@ trace(storageReadTrace, ({ record }) => {
 - Non-Error thrown values are recorded with their type name and string representation.
 - Unrecognized span names throw immediately.
 - Disabled span categories run the callback with a noop context — no telemetry is emitted.
+- Managed spans can start parented spans with `child(definition)` or `child(definition, callback)`.
+- Record updates recursively merge plain objects; arrays are copied and replaced.
 - The `end` hook receives `{ span, record, duration, error? }`.
 
 ### Using debug
@@ -268,6 +283,7 @@ When `@opentelemetry/api` is not available, the instruments are safe noops.
 - **Error recording**: Exceptions are recorded on the span with `ERROR` status
 - **Span name validation**: Unknown span names are rejected early
 - **Record tracking**: Accumulate structured data during a trace and access it in the `end` hook
+- **Managed child spans**: Start child spans from a managed trace context when a manual parent span stays open
 - **Custom actions**: Define span-scoped helper functions via the `actions` factory
 - **Category-based disabling**: Disable groups of spans via environment configuration
 - **Noop fallback**: All instrumentation calls are safe no-ops when OpenTelemetry APIs are not installed
@@ -278,13 +294,17 @@ When `@opentelemetry/api` is not available, the instruments are safe noops.
 
 ### `trace(definition)` — Managed mode
 
-Starts a span and returns a managed context with `record`, `actions`, `end`, and `fail` methods.
+Starts a span and returns a managed context with `record`, `actions`, `child`, `end`, and `fail` methods.
 
 | Parameter | Type | Description |
 |-----------|------|-------------|
 | `definition` | `TraceDefinition` | Trace definition object (see below). |
 
-Returns: `{ record, actions, end, fail }`
+Returns: `{ record, actions, child, end, fail }`
+
+### `managed.child(definition[, callback])`
+
+Starts a span parented to an open managed span. Without a callback, it returns another managed context. With a callback, the child span follows callback-mode lifecycle behavior.
 
 ### `trace(definition, callback)` — Callback mode
 

package/dist/cjs/package.json

@@ -1,7 +1,7 @@
 {
     "$schema": "https://json.schemastore.org/package.json",
     "name": "@microsoft/agents-telemetry",
-    "version": "1.7.1",
+    "version": "1.8.0-beta.34.g5d543f96c0",
     "homepage": "https://github.com/microsoft/Agents-for-js",
     "repository": {
         "type": "git",
@@ -44,8 +44,9 @@
         "@opentelemetry/api-logs": "0.214.0"
     },
     "dependencies": {
-        "@microsoft/agents-activity": "1.7.1",
-        "debug": "^4.4.3"
+        "@microsoft/agents-activity": "1.8.0-beta.34.g5d543f96c0",
+        "@noble/hashes": "1.8.0",
+        "debug": "4.4.3"
     },
     "license": "MIT",
     "files": [

package/dist/cjs/src/index.cjs

@@ -5,9 +5,11 @@
  */
 var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.metric = exports.trace = exports.debug = exports.MetricNames = exports.SpanNames = exports.redactScopes = exports.redactUrl = exports.redactString = void 0;
+exports.metric = exports.trace = exports.debug = exports.MetricNames = exports.SpanNames = exports.redactScopes = exports.redactUrl = exports.redactString = exports.redactDiagnosticObject = exports.pseudonymizeConversationId = void 0;
 const index_js_1 = require("./index.js");
 var redact_js_1 = require("./utils/redact.js");
+Object.defineProperty(exports, "pseudonymizeConversationId", { enumerable: true, get: function () { return redact_js_1.pseudonymizeConversationId; } });
+Object.defineProperty(exports, "redactDiagnosticObject", { enumerable: true, get: function () { return redact_js_1.redactDiagnosticObject; } });
 Object.defineProperty(exports, "redactString", { enumerable: true, get: function () { return redact_js_1.redactString; } });
 Object.defineProperty(exports, "redactUrl", { enumerable: true, get: function () { return redact_js_1.redactUrl; } });
 Object.defineProperty(exports, "redactScopes", { enumerable: true, get: function () { return redact_js_1.redactScopes; } });

package/dist/cjs/src/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../src/index.cts"],"names":[],"mappings":";AAAA;;;GAGG;;;;AASH,yCAAkC;AAGlC,+CAAyE;AAAhE,yGAAA,YAAY,OAAA;AAAE,sGAAA,SAAS,OAAA;AAAE,yGAAA,YAAY,OAAA;AAEjC,KAMT,IAAA,gBAAK,EAAC;IACR,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,oBAAoB,CAAS;IACjD,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,yBAAyB,CAAa;CAC3D,CAAC,EARA,iBAAS,iBACT,mBAAW,mBACX,aAAK,aACL,aAAK,aACL,cAAM,aAIN"}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../src/index.cts"],"names":[],"mappings":";AAAA;;;GAGG;;;;AASH,yCAAkC;AAGlC,+CAA6H;AAApH,uHAAA,0BAA0B,OAAA;AAAE,mHAAA,sBAAsB,OAAA;AAAE,yGAAA,YAAY,OAAA;AAAE,sGAAA,SAAS,OAAA;AAAE,yGAAA,YAAY,OAAA;AAErF,KAMT,IAAA,gBAAK,EAAC;IACR,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,oBAAoB,CAAS;IACjD,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,yBAAyB,CAAa;CAC3D,CAAC,EARA,iBAAS,iBACT,mBAAW,mBACX,aAAK,aACL,aAAK,aACL,cAAM,aAIN"}

package/dist/cjs/src/index.d.cts

@@ -3,7 +3,7 @@
  * Licensed under the MIT License.
  */
 export type { TraceDefinition } from './types.js';
-export { redactString, redactUrl, redactScopes } from './utils/redact.js';
+export { pseudonymizeConversationId, redactDiagnosticObject, redactString, redactUrl, redactScopes } from './utils/redact.js';
 export declare const SpanNames: {
     readonly ADAPTER_PROCESS: "agents.adapter.process";
     readonly ADAPTER_SEND_ACTIVITIES: "agents.adapter.send_activities";
@@ -65,11 +65,16 @@ export declare const SpanNames: {
     readonly COPILOT_SEND_ACTIVITY: "agents.copilot_client.send_activity";
     readonly COPILOT_POST_REQUEST: "agents.copilot_client.post_request";
     readonly COPILOT_CREATE_CONNECTION: "agents.copilot_client.webchat.create_connection";
+    readonly COPILOT_WEBCHAT_START_CONVERSATION: "agents.copilot_client.webchat.start_conversation";
+    readonly COPILOT_WEBCHAT_POST_ACTIVITY: "agents.copilot_client.webchat.post_activity";
+    readonly COPILOT_WEBCHAT_RECEIVE_ACTIVITY: "agents.copilot_client.webchat.receive_activity";
+    readonly COPILOT_WEBCHAT_END_CONNECTION: "agents.copilot_client.webchat.end_connection";
     readonly COPILOT_EXECUTE_STREAMING: "agents.copilot_client.execute_streaming";
     readonly COPILOT_SUBSCRIBE_ASYNC: "agents.copilot_client.subscribe_async";
     readonly NAMED_PIPE_CONNECT: "agents.named_pipe.connect";
     readonly NAMED_PIPE_DISPATCH: "agents.named_pipe.dispatch";
     readonly NAMED_PIPE_SEND: "agents.named_pipe.send";
+    readonly SLACK_API_CALL: "agents.slack.api.call";
 }, MetricNames: {
     readonly ADAPTER_PROCESS_DURATION: "agents.adapter.process.duration";
     readonly ACTIVITIES_RECEIVED: "agents.activities.received";
@@ -109,4 +114,6 @@ export declare const SpanNames: {
     readonly NAMED_PIPE_DISPATCH_ERRORS: "agents.named_pipe.dispatch.error.count";
     readonly NAMED_PIPE_SENDS: "agents.named_pipe.send.count";
     readonly NAMED_PIPE_SEND_DURATION: "agents.named_pipe.send.duration";
+    readonly SLACK_API_REQUESTS: "agents.slack.api.request.count";
+    readonly SLACK_API_REQUEST_DURATION: "agents.slack.api.request.duration";
 }, debug: (namespace: string) => import("./loggers/base.js").Logger, trace: import("./types.js").TraceFunction, metric: import("./types.js").Metric;

package/dist/cjs/src/observability/constants.d.ts

@@ -79,11 +79,16 @@ export declare const SpanNames: {
     readonly COPILOT_SEND_ACTIVITY: "agents.copilot_client.send_activity";
     readonly COPILOT_POST_REQUEST: "agents.copilot_client.post_request";
     readonly COPILOT_CREATE_CONNECTION: "agents.copilot_client.webchat.create_connection";
+    readonly COPILOT_WEBCHAT_START_CONVERSATION: "agents.copilot_client.webchat.start_conversation";
+    readonly COPILOT_WEBCHAT_POST_ACTIVITY: "agents.copilot_client.webchat.post_activity";
+    readonly COPILOT_WEBCHAT_RECEIVE_ACTIVITY: "agents.copilot_client.webchat.receive_activity";
+    readonly COPILOT_WEBCHAT_END_CONNECTION: "agents.copilot_client.webchat.end_connection";
     readonly COPILOT_EXECUTE_STREAMING: "agents.copilot_client.execute_streaming";
     readonly COPILOT_SUBSCRIBE_ASYNC: "agents.copilot_client.subscribe_async";
     readonly NAMED_PIPE_CONNECT: "agents.named_pipe.connect";
     readonly NAMED_PIPE_DISPATCH: "agents.named_pipe.dispatch";
     readonly NAMED_PIPE_SEND: "agents.named_pipe.send";
+    readonly SLACK_API_CALL: "agents.slack.api.call";
 };
 /**
  * Metric names used for telemetry in the Agents SDK.
@@ -127,4 +132,6 @@ export declare const MetricNames: {
     readonly NAMED_PIPE_DISPATCH_ERRORS: "agents.named_pipe.dispatch.error.count";
     readonly NAMED_PIPE_SENDS: "agents.named_pipe.send.count";
     readonly NAMED_PIPE_SEND_DURATION: "agents.named_pipe.send.duration";
+    readonly SLACK_API_REQUESTS: "agents.slack.api.request.count";
+    readonly SLACK_API_REQUEST_DURATION: "agents.slack.api.request.duration";
 };

package/dist/cjs/src/observability/constants.js

@@ -94,12 +94,18 @@ exports.SpanNames = {
     COPILOT_SEND_ACTIVITY: 'agents.copilot_client.send_activity',
     COPILOT_POST_REQUEST: 'agents.copilot_client.post_request',
     COPILOT_CREATE_CONNECTION: 'agents.copilot_client.webchat.create_connection',
+    COPILOT_WEBCHAT_START_CONVERSATION: 'agents.copilot_client.webchat.start_conversation',
+    COPILOT_WEBCHAT_POST_ACTIVITY: 'agents.copilot_client.webchat.post_activity',
+    COPILOT_WEBCHAT_RECEIVE_ACTIVITY: 'agents.copilot_client.webchat.receive_activity',
+    COPILOT_WEBCHAT_END_CONNECTION: 'agents.copilot_client.webchat.end_connection',
     COPILOT_EXECUTE_STREAMING: 'agents.copilot_client.execute_streaming',
     COPILOT_SUBSCRIBE_ASYNC: 'agents.copilot_client.subscribe_async',
     // Named Pipe
     NAMED_PIPE_CONNECT: 'agents.named_pipe.connect',
     NAMED_PIPE_DISPATCH: 'agents.named_pipe.dispatch',
     NAMED_PIPE_SEND: 'agents.named_pipe.send',
+    // Slack
+    SLACK_API_CALL: 'agents.slack.api.call',
 };
 /**
  * Metric names used for telemetry in the Agents SDK.
@@ -155,5 +161,8 @@ exports.MetricNames = {
     NAMED_PIPE_DISPATCH_ERRORS: 'agents.named_pipe.dispatch.error.count',
     NAMED_PIPE_SENDS: 'agents.named_pipe.send.count',
     NAMED_PIPE_SEND_DURATION: 'agents.named_pipe.send.duration',
+    // Slack
+    SLACK_API_REQUESTS: 'agents.slack.api.request.count',
+    SLACK_API_REQUEST_DURATION: 'agents.slack.api.request.duration',
 };
 //# sourceMappingURL=constants.js.map

package/dist/cjs/src/observability/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/observability/constants.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/observability/constants.ts"],"names":[],"mappings":"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"}

package/dist/cjs/src/observability/trace.js

@@ -10,6 +10,7 @@ const attempt_js_1 = require("../utils/attempt.js");
 const category_js_1 = require("./category.js");
 const constants_js_1 = require("./constants.js");
 const noop_js_1 = require("../utils/noop.js");
+const record_js_1 = require("../utils/record.js");
 const errorHelper_js_1 = require("../errorHelper.js");
 /**
  * Creates the trace helper bound to the package tracer.
@@ -22,6 +23,9 @@ function traceFactory(otel) {
     const validSpanNames = new Set(Object.values(constants_js_1.SpanNames));
     const tracer = otel.trace.getTracer('@microsoft/agents-telemetry');
     const trace = function trace(target, callback) {
+        return runTrace(target, callback);
+    };
+    function runTrace(target, callback, parentSpan) {
         if (!target) {
             throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_js_1.Errors.TraceDefinitionRequired);
         }
@@ -29,29 +33,37 @@ function traceFactory(otel) {
             throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_js_1.Errors.UnrecognizedSpanName, undefined, { spanName: target.name });
         }
         if ((0, category_js_1.isSpanDisabled)(target.name)) {
-            return (0, noop_js_1.noopContext)(callback);
-        }
-        const record = createRecord(target);
-        if (!callback) {
-            // TODO: if parent/child span connections are needed, we could expose a 'child' function that internally connects them.
-            const span = tracer.startSpan(target.name);
-            const flow = start(otel, target, span, record);
-            return {
-                record: flow.record,
-                actions: flow.actions,
-                fail: flow.fail,
-                end: flow.end
-            };
+            return callback ? (0, noop_js_1.noopContext)(callback) : (0, noop_js_1.noopContext)();
         }
-        return tracer.startActiveSpan(target.name, span => {
-            const flow = start(otel, target, span, record);
-            return (0, attempt_js_1.attempt)({
-                try: () => callback({ record: flow.record, actions: flow.actions }),
-                catch: (error) => { throw flow.fail(error); },
-                finally: flow.end
+        const execute = () => {
+            const record = createRecord(target);
+            if (!callback) {
+                const span = tracer.startSpan(target.name);
+                const flow = start(otel, target, span, record);
+                const child = ((definition, childCallback) => runTrace(definition, childCallback, span));
+                return {
+                    record: flow.record,
+                    actions: flow.actions,
+                    child,
+                    fail: flow.fail,
+                    end: flow.end
+                };
+            }
+            return tracer.startActiveSpan(target.name, span => {
+                const flow = start(otel, target, span, record);
+                return (0, attempt_js_1.attempt)({
+                    try: () => callback({ record: flow.record, actions: flow.actions }),
+                    catch: (error) => { throw flow.fail(error); },
+                    finally: flow.end
+                });
             });
-        });
-    };
+        };
+        if (!parentSpan) {
+            return execute();
+        }
+        const parentContext = otel.trace.setSpan(otel.context.active(), parentSpan);
+        return otel.context.with(parentContext, execute);
+    }
     trace.define = definition => definition;
     return trace;
 }
@@ -59,14 +71,14 @@ function traceFactory(otel) {
  * Creates the mutable record stored for a trace execution.
  *
  * @remarks
- * - Updates use `Object.assign`, so nested objects are replaced rather than deeply merged.
+ * - Plain objects are recursively merged.
+ * - Arrays are copied and replaced.
  */
 function createRecord(target) {
-    const state = target.record ? { ...target.record } : {};
+    const state = target.record ? (0, record_js_1.cloneRecordValue)(target.record) : {};
     return {
         set(values) {
-            // TODO: use deep-merge strategy for Object and Array
-            Object.assign(state, values);
+            (0, record_js_1.mergeRecordValues)(state, values);
         },
         get() {
             return state;

package/dist/cjs/src/observability/trace.js.map

@@ -1 +1 @@
-{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../../../src/observability/trace.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../../../src/observability/trace.ts"],"names":[],"mappings":"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"}

package/dist/cjs/src/types.d.ts

@@ -32,7 +32,8 @@ export type SpanName = typeof SpanNames[keyof typeof SpanNames];
  * Mutable state container used while a trace is active.
  *
  * @remarks
- * - `set()` performs a shallow merge.
+ * - `set()` recursively merges plain objects.
+ * - Arrays are copied and replaced.
  * - `get()` returns the latest snapshot stored for the span.
  */
 export interface TraceRecord<TRecord extends object> {
@@ -43,6 +44,13 @@ export interface TraceRecord<TRecord extends object> {
  * Context passed to traced callbacks.
  */
 export interface TraceContext<TRecord extends object, TActions extends object> {
+    /**
+     * Updates the record values collected for the span.
+     *
+     * @remarks
+     * - Plain objects are recursively merged.
+     * - Arrays are copied and replaced.
+     */
     record(values: Partial<TRecord>): void;
     actions: TActions;
 }
@@ -65,10 +73,18 @@ export interface TraceEndContext<TRecord extends object> {
     duration: number;
     error?: unknown;
 }
+/**
+ * Starts a child span parented to an active managed span.
+ */
+export interface TraceChildFunction {
+    <TRecord extends object, TActions extends object>(definition: TraceDefinition<TRecord, TActions>): TraceManagedContext<TRecord, TActions>;
+    <TRecord extends object, TActions extends object, TReturn>(definition: TraceDefinition<TRecord, TActions>, callback: TraceCallback<TRecord, TActions, TReturn>): TReturn;
+}
 /**
  * Handle returned when a trace is created without a callback.
  */
 export interface TraceManagedContext<TRecord extends object, TActions extends object> extends TraceContext<TRecord, TActions> {
+    child: TraceChildFunction;
     end(): void;
     fail<T extends unknown>(error: T): T;
 }

package/dist/cjs/src/utils/noop.js

@@ -36,6 +36,7 @@ function noopContext(callback) {
     const managedContext = {
         record: context.record,
         actions: context.actions,
+        child: ((_definition, callback) => noopContext(callback)),
         end: noopFn,
         fail(error) {
             return error;

package/dist/cjs/src/utils/noop.js.map

@@ -1 +1 @@
-{"version":3,"file":"noop.js","sourceRoot":"","sources":["../../../../src/utils/noop.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAkBH,gCAKC;AAOD,kCAqBC;AA/CD,MAAM,MAAM,GAAG,GAAG,EAAE,GAAE,CAAC,CAAA;AAEvB;;GAEG;AACU,QAAA,SAAS,GAAG,UAAU,MAAM,EAAE,QAAQ;IACjD,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAA;AAC9B,CAAkB,CAAA;AAElB,iBAAS,CAAC,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC,UAAU,CAAA;AAE3C;;GAEG;AACH,SAAgB,UAAU;IACxB,OAAO;QACL,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QACrC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;KACjC,CAAA;AACH,CAAC;AAOD,SAAgB,WAAW,CAA4D,QAAoD;IACzI,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAa,CAAA;IAChE,MAAM,OAAO,GAAoC;QAC/C,MAAM,EAAE,MAAM;QACd,OAAO;KACR,CAAA;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC1B,CAAC;IAED,MAAM,cAAc,GAA2C;QAC7D,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,GAAG,EAAE,MAAM;QACX,IAAI,CAAqB,KAAQ;YAC/B,OAAO,KAAK,CAAA;QACd,CAAC;KACF,CAAA;IAED,OAAO,cAAc,CAAA;AACvB,CAAC"}
+{"version":3,"file":"noop.js","sourceRoot":"","sources":["../../../../src/utils/noop.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAkBH,gCAKC;AAOD,kCAsBC;AAhDD,MAAM,MAAM,GAAG,GAAG,EAAE,GAAE,CAAC,CAAA;AAEvB;;GAEG;AACU,QAAA,SAAS,GAAG,UAAU,MAAM,EAAE,QAAQ;IACjD,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAA;AAC9B,CAAkB,CAAA;AAElB,iBAAS,CAAC,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC,UAAU,CAAA;AAE3C;;GAEG;AACH,SAAgB,UAAU;IACxB,OAAO;QACL,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QACrC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;KACjC,CAAA;AACH,CAAC;AAOD,SAAgB,WAAW,CAA4D,QAAoD;IACzI,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAa,CAAA;IAChE,MAAM,OAAO,GAAoC;QAC/C,MAAM,EAAE,MAAM;QACd,OAAO;KACR,CAAA;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC1B,CAAC;IAED,MAAM,cAAc,GAA2C;QAC7D,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAuB;QAC/E,GAAG,EAAE,MAAM;QACX,IAAI,CAAqB,KAAQ;YAC/B,OAAO,KAAK,CAAA;QACd,CAAC;KACF,CAAA;IAED,OAAO,cAAc,CAAA;AACvB,CAAC"}

package/dist/cjs/src/utils/record.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+/**
+ * Recursively merges record values into the target state.
+ *
+ * @remarks
+ * - Plain objects are recursively merged.
+ * - Arrays are copied and replaced.
+ */
+export declare function mergeRecordValues(target: Record<string, unknown>, values: Record<string, unknown>): void;
+/**
+ * Clones record values while preserving non-plain objects by reference.
+ *
+ * @remarks
+ * - Plain objects and arrays are cloned.
+ * - Non-plain objects are kept by reference.
+ */
+export declare function cloneRecordValue<T>(value: T): T;

package/dist/cjs/src/utils/record.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeRecordValues = mergeRecordValues;
+exports.cloneRecordValue = cloneRecordValue;
+/**
+ * Recursively merges record values into the target state.
+ *
+ * @remarks
+ * - Plain objects are recursively merged.
+ * - Arrays are copied and replaced.
+ */
+function mergeRecordValues(target, values) {
+    Object.entries(values).forEach(([key, value]) => {
+        const current = target[key];
+        if (isPlainObject(current) && isPlainObject(value)) {
+            const merged = { ...current };
+            mergeRecordValues(merged, value);
+            target[key] = merged;
+            return;
+        }
+        target[key] = cloneRecordValue(value);
+    });
+}
+/**
+ * Clones record values while preserving non-plain objects by reference.
+ *
+ * @remarks
+ * - Plain objects and arrays are cloned.
+ * - Non-plain objects are kept by reference.
+ */
+function cloneRecordValue(value) {
+    if (Array.isArray(value)) {
+        return value.map(item => cloneRecordValue(item));
+    }
+    if (isPlainObject(value)) {
+        const result = {};
+        Object.entries(value).forEach(([key, child]) => {
+            result[key] = cloneRecordValue(child);
+        });
+        return result;
+    }
+    return value;
+}
+/**
+ * Checks whether a value is a plain object that can be recursively merged.
+ *
+ * @remarks
+ * Arrays and class instances are not considered plain objects.
+ */
+function isPlainObject(value) {
+    if (Object.prototype.toString.call(value) !== '[object Object]') {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+//# sourceMappingURL=record.js.map

package/dist/cjs/src/utils/record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../../../../src/utils/record.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AASH,8CAaC;AASD,4CAcC;AA3CD;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAAE,MAA+B,EAAE,MAA+B;IACjG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QAC9C,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;QAE3B,IAAI,aAAa,CAAC,OAAO,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACnD,MAAM,MAAM,GAAG,EAAE,GAAG,OAAO,EAAE,CAAA;YAC7B,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;YAChC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAA;YACpB,OAAM;QACR,CAAC;QAED,MAAM,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;IACvC,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAAK,KAAQ;IAC3C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAM,CAAA;IACvD,CAAC;IAED,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,MAAM,GAA4B,EAAE,CAAA;QAC1C,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YAC7C,MAAM,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;QACvC,CAAC,CAAC,CAAA;QACF,OAAO,MAAW,CAAA;IACpB,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;GAKG;AACH,SAAS,aAAa,CAAE,KAAc;IACpC,IAAI,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,iBAAiB,EAAE,CAAC;QAChE,OAAO,KAAK,CAAA;IACd,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;IAC9C,OAAO,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,CAAA;AAC7D,CAAC"}

package/dist/cjs/src/utils/redact.d.ts

@@ -21,3 +21,18 @@ export declare function redactUrl(value: string | undefined): string | undefined
  * @returns The redacted scopes string, which includes an indication of how many scopes were redacted. If the input value is undefined, it will be returned as undefined.
  */
 export declare function redactScopes(scopes: string[] | undefined): string | undefined;
+/**
+ * Returns a stable, non-reversible identifier for diagnostic correlation.
+ * @param conversationId The conversation ID to pseudonymize.
+ * @param key Optional secret used to keep pseudonyms stable across restarts.
+ * @returns A pseudonymized conversation ID, or undefined when no ID is supplied.
+ */
+export declare function pseudonymizeConversationId(conversationId: string | undefined, key?: string): string | undefined;
+/**
+ * Creates a redacted copy of an object for diagnostic logging.
+ * Conversation IDs, activity text, and URL-valued properties are redacted while all other values are preserved.
+ * @param value The value to sanitize for diagnostics.
+ * @param diagnosticsPseudonymKey Optional secret used to keep conversation pseudonyms stable across restarts.
+ * @returns A non-mutating, redacted copy of the value.
+ */
+export declare function redactDiagnosticObject(value: unknown, diagnosticsPseudonymKey?: string): unknown;

package/dist/cjs/src/utils/redact.js

@@ -7,8 +7,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.redactString = redactString;
 exports.redactUrl = redactUrl;
 exports.redactScopes = redactScopes;
+exports.pseudonymizeConversationId = pseudonymizeConversationId;
+exports.redactDiagnosticObject = redactDiagnosticObject;
+const hmac_1 = require("@noble/hashes/hmac");
+const sha2_1 = require("@noble/hashes/sha2");
+const utils_1 = require("@noble/hashes/utils");
 const REDACTED_VALUE = '<redacted>';
 const REDACTION_PEEK_LENGTH = 2;
+let processLocalKey;
 /**
  * Redacts a string value, optionally allowing a peek at the beginning of the string for context.
  * @param value The string value to redact.
@@ -56,4 +62,60 @@ function redactScopes(scopes) {
     const count = scopes.length;
     return `${REDACTED_VALUE} (${count} ${count === 1 ? 'scope' : 'scopes'})`;
 }
+/**
+ * Returns a stable, non-reversible identifier for diagnostic correlation.
+ * @param conversationId The conversation ID to pseudonymize.
+ * @param key Optional secret used to keep pseudonyms stable across restarts.
+ * @returns A pseudonymized conversation ID, or undefined when no ID is supplied.
+ */
+function pseudonymizeConversationId(conversationId, key) {
+    if (!(conversationId === null || conversationId === void 0 ? void 0 : conversationId.trim())) {
+        return undefined;
+    }
+    const trimmedKey = key === null || key === void 0 ? void 0 : key.trim();
+    const hmacKey = trimmedKey
+        ? (0, utils_1.utf8ToBytes)(trimmedKey)
+        : (processLocalKey !== null && processLocalKey !== void 0 ? processLocalKey : (processLocalKey = createProcessLocalKey()));
+    const digest = (0, hmac_1.hmac)(sha2_1.sha256, hmacKey, (0, utils_1.utf8ToBytes)(conversationId));
+    return `cid_${(0, utils_1.bytesToHex)(digest).slice(0, 32)}`;
+}
+function createProcessLocalKey() {
+    const key = new Uint8Array(32);
+    globalThis.crypto.getRandomValues(key);
+    return key;
+}
+/**
+ * Creates a redacted copy of an object for diagnostic logging.
+ * Conversation IDs, activity text, and URL-valued properties are redacted while all other values are preserved.
+ * @param value The value to sanitize for diagnostics.
+ * @param diagnosticsPseudonymKey Optional secret used to keep conversation pseudonyms stable across restarts.
+ * @returns A non-mutating, redacted copy of the value.
+ */
+function redactDiagnosticObject(value, diagnosticsPseudonymKey) {
+    return redactValue(value, [], diagnosticsPseudonymKey);
+}
+function redactValue(value, path, diagnosticsPseudonymKey) {
+    var _a, _b;
+    if (typeof value === 'string') {
+        const propertyName = (_a = path.at(-1)) === null || _a === void 0 ? void 0 : _a.toLowerCase();
+        const parentPropertyName = (_b = path.at(-2)) === null || _b === void 0 ? void 0 : _b.toLowerCase();
+        if (propertyName === 'conversationid' || (propertyName === 'id' && parentPropertyName === 'conversation')) {
+            return pseudonymizeConversationId(value, diagnosticsPseudonymKey);
+        }
+        if (propertyName === 'text' || propertyName === 'activitytext') {
+            return redactString(value, true);
+        }
+        if ((propertyName === null || propertyName === void 0 ? void 0 : propertyName.includes('url')) || propertyName === 'uri' || propertyName === 'href') {
+            return redactUrl(value);
+        }
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map(item => redactValue(item, path, diagnosticsPseudonymKey));
+    }
+    if (value && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, redactValue(item, [...path, key], diagnosticsPseudonymKey)]));
+    }
+    return value;
+}
 //# sourceMappingURL=redact.js.map

package/dist/cjs/src/utils/redact.js.map

@@ -1 +1 @@
-{"version":3,"file":"redact.js","sourceRoot":"","sources":["../../../../src/utils/redact.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAWH,oCAQC;AAOD,8BAiBC;AAOD,oCAOC;AAvDD,MAAM,cAAc,GAAG,YAAY,CAAA;AACnC,MAAM,qBAAqB,GAAG,CAAC,CAAA;AAE/B;;;;;GAKG;AACH,SAAgB,YAAY,CAAE,KAAyB,EAAE,OAAgB,KAAK;IAC5E,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,OAAO,IAAI,IAAI,KAAK,CAAC,MAAM,GAAG,qBAAqB,GAAG,CAAC;QACrD,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,qBAAqB,CAAC,GAAG,cAAc,EAAE;QAC7D,CAAC,CAAC,cAAc,CAAA;AACpB,CAAC;AAED;;;;GAIG;AACH,SAAgB,SAAS,CAAE,KAAyB;IAClD,IAAI,CAAC,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,IAAI,EAAE,CAAA,EAAE,CAAC;QACnB,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAA;QAC1B,MAAM,YAAY,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QAE5D,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,GAAG,CAAC,MAAM,CAAA;QACnB,CAAC;QAED,OAAO,GAAG,GAAG,CAAC,MAAM,IAAI,cAAc,KAAK,YAAY,CAAC,MAAM,YAAY,CAAA;IAC5E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,cAAc,CAAA;IACvB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,YAAY,CAAE,MAA4B;IACxD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAA;IAC3B,OAAO,GAAG,cAAc,KAAK,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAA;AAC3E,CAAC"}
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../../../../src/utils/redact.ts"],"names":[],"mappings":"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"}