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

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

@@ -7,6 +7,7 @@ import { attempt } from '../utils/attempt.js';
 import { isSpanDisabled } from './category.js';
 import { SpanNames } from './constants.js';
 import { noopContext } from '../utils/noop.js';
+import { cloneRecordValue, mergeRecordValues } from '../utils/record.js';
 import { Errors } from '../errorHelper.js';
 /**
  * Creates the trace helper bound to the package tracer.
@@ -19,6 +20,9 @@ export function traceFactory(otel) {
     const validSpanNames = new Set(Object.values(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 ExceptionHelper.generateException(Error, Errors.TraceDefinitionRequired);
         }
@@ -26,29 +30,37 @@ export function traceFactory(otel) {
             throw ExceptionHelper.generateException(Error, Errors.UnrecognizedSpanName, undefined, { spanName: target.name });
         }
         if (isSpanDisabled(target.name)) {
-            return 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 ? noopContext(callback) : noopContext();
         }
-        return tracer.startActiveSpan(target.name, span => {
-            const flow = start(otel, target, span, record);
-            return 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 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;
 }
@@ -56,14 +68,14 @@ export 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 ? cloneRecordValue(target.record) : {};
     return {
         set(values) {
-            // TODO: use deep-merge strategy for Object and Array
-            Object.assign(state, values);
+            mergeRecordValues(state, values);
         },
         get() {
             return state;

package/dist/esm/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/esm/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/esm/src/utils/noop.js

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

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

@@ -1 +1 @@
-{"version":3,"file":"noop.js","sourceRoot":"","sources":["../../../../src/utils/noop.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,MAAM,GAAG,GAAG,EAAE,GAAE,CAAC,CAAA;AAEvB;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,MAAM,EAAE,QAAQ;IACjD,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAA;AAC9B,CAAkB,CAAA;AAElB,SAAS,CAAC,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC,UAAU,CAAA;AAE3C;;GAEG;AACH,MAAM,UAAU,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,MAAM,UAAU,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;AAIH,MAAM,MAAM,GAAG,GAAG,EAAE,GAAE,CAAC,CAAA;AAEvB;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,MAAM,EAAE,QAAQ;IACjD,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAA;AAC9B,CAAkB,CAAA;AAElB,SAAS,CAAC,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC,UAAU,CAAA;AAE3C;;GAEG;AACH,MAAM,UAAU,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,MAAM,UAAU,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/esm/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/esm/src/utils/record.js

@@ -0,0 +1,57 @@
+/**
+ * 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 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.
+ */
+export 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/esm/src/utils/record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../../../../src/utils/record.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,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,MAAM,UAAU,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/esm/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/esm/src/utils/redact.js

@@ -2,8 +2,12 @@
  * Copyright (c) Microsoft Corporation. All rights reserved.
  * Licensed under the MIT License.
  */
+import { hmac } from '@noble/hashes/hmac';
+import { sha256 } from '@noble/hashes/sha2';
+import { bytesToHex, utf8ToBytes } from '@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.
@@ -51,4 +55,60 @@ export 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.
+ */
+export 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
+        ? utf8ToBytes(trimmedKey)
+        : (processLocalKey !== null && processLocalKey !== void 0 ? processLocalKey : (processLocalKey = createProcessLocalKey()));
+    const digest = hmac(sha256, hmacKey, utf8ToBytes(conversationId));
+    return `cid_${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.
+ */
+export 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/esm/src/utils/redact.js.map

@@ -1 +1 @@
-{"version":3,"file":"redact.js","sourceRoot":"","sources":["../../../../src/utils/redact.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,cAAc,GAAG,YAAY,CAAA;AACnC,MAAM,qBAAqB,GAAG,CAAC,CAAA;AAE/B;;;;;GAKG;AACH,MAAM,UAAU,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,MAAM,UAAU,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,MAAM,UAAU,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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"}