@microsoft/agents-a365-observability 0.1.0-preview.126 → 0.1.0-preview.128

package/dist/esm/tracing/exporter/utils.js

@@ -1,8 +1,8 @@
-// ------------------------------------------------------------------------------
-// Copyright (c) Microsoft Corporation. All rights reserved.
-// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
 import { SpanKind, SpanStatusCode } from '@opentelemetry/api';
 import { OpenTelemetryConstants } from '../constants';
+import { A365_MESSAGE_SCHEMA_VERSION, MessageRole } from '../contracts';
 import logger from '../../utils/logging';
 import { ExporterEventNames } from './ExporterEventNames';
 import { defaultObservabilityConfigurationProvider, defaultPerRequestSpanProcessorConfigurationProvider } from '../../configuration';
@@ -156,4 +156,327 @@ export function parseIdentityKey(key) {
     const [tenantId, agentId] = key.split(':');
     return { tenantId, agentId };
 }
+// ---------------------------------------------------------------------------
+// Span truncation
+// ---------------------------------------------------------------------------
+/** Maximum allowed span size in bytes (250KB). @internal */
+export const MAX_SPAN_SIZE_BYTES = 250 * 1024;
+const BLOB_SENTINEL = '[blob truncated]';
+const JSON_SENTINEL = '[truncated]';
+const TRUNCATED_SUFFIX = '… [truncated]';
+const TRUNCATED_SUFFIX_BYTES = Buffer.byteLength(TRUNCATED_SUFFIX, 'utf8');
+const OVERLIMIT_SENTINEL = '[overlimit]';
+/**
+ * Build a versioned message wrapper indicating the original messages were dropped
+ * because the span exceeded the size limit.
+ */
+function serializeOverflowSentinel(totalMessages) {
+    return JSON.stringify({
+        version: A365_MESSAGE_SCHEMA_VERSION,
+        messages: [
+            {
+                role: MessageRole.SYSTEM,
+                parts: [
+                    {
+                        type: 'text',
+                        content: `[truncated: ${totalMessages} ${totalMessages === 1 ? 'message' : 'messages'} exceeded limit]`
+                    }
+                ]
+            }
+        ]
+    });
+}
+/** Strings shorter than this (in UTF-8 bytes) are not worth truncating. */
+const MIN_SHRINKABLE_STRING_BYTES = 50;
+const MESSAGE_ATTR_KEYS = new Set([
+    OpenTelemetryConstants.GEN_AI_INPUT_MESSAGES_KEY,
+    OpenTelemetryConstants.GEN_AI_OUTPUT_MESSAGES_KEY,
+]);
+/**
+ * Trim a string by a target UTF-8 byte budget while preserving whole code points.
+ */
+function trimString(value, bytesToShed) {
+    const currentBytes = Buffer.byteLength(value, 'utf8');
+    const targetTotalBytes = Math.max(TRUNCATED_SUFFIX_BYTES, currentBytes - Math.max(1, bytesToShed));
+    const targetContentBytes = targetTotalBytes - TRUNCATED_SUFFIX_BYTES;
+    if (targetContentBytes <= 0) {
+        return TRUNCATED_SUFFIX;
+    }
+    let consumedBytes = 0;
+    let endIndex = 0;
+    for (const codePoint of value) {
+        const codePointBytes = Buffer.byteLength(codePoint, 'utf8');
+        if (consumedBytes + codePointBytes > targetContentBytes) {
+            break;
+        }
+        consumedBytes += codePointBytes;
+        endIndex += codePoint.length; // length in UTF-16 code units (handles surrogates)
+    }
+    return value.slice(0, endIndex) + TRUNCATED_SUFFIX;
+}
+function getSerializedSize(value) {
+    return Buffer.byteLength(JSON.stringify(value), 'utf8');
+}
+function createBlobShrinkAction(part, sourceKey) {
+    const partType = part.type;
+    if (partType === 'blob' && typeof part.content === 'string') {
+        const contentSize = Buffer.byteLength(part.content, 'utf8');
+        if (contentSize <= 0 || part.content === BLOB_SENTINEL) {
+            return undefined;
+        }
+        const action = {
+            contentBytes: contentSize,
+            sourceKey,
+            apply() {
+                part.content = BLOB_SENTINEL;
+                action.contentBytes = 0;
+            }
+        };
+        return action;
+    }
+    return undefined;
+}
+/**
+ * Collect all shrink candidates from message parts and direct string attributes.
+ * Blobs, text, reasoning, json-field, and plain-string actions are all collected
+ * uniformly. When a message attribute contains non-JSON content it falls through
+ * to regular string trimming.
+ */
+function collectShrinkActions(attributes, parsedMessages) {
+    const actions = [];
+    for (const key of Object.keys(attributes)) {
+        let handledAsMessage = false;
+        if (MESSAGE_ATTR_KEYS.has(key)) {
+            // Parse and cache the message wrapper if not already done
+            if (!parsedMessages.has(key) && typeof attributes[key] === 'string') {
+                try {
+                    const parsed = JSON.parse(attributes[key]);
+                    if (parsed && typeof parsed === 'object' && typeof parsed.version === 'string' && Array.isArray(parsed.messages)) {
+                        parsedMessages.set(key, parsed);
+                    }
+                }
+                catch {
+                    // Not valid JSON — will fall through to string trim
+                }
+            }
+            if (parsedMessages.has(key)) {
+                handledAsMessage = true;
+                const wrapper = parsedMessages.get(key);
+                for (const message of wrapper.messages) {
+                    if (!Array.isArray(message.parts))
+                        continue;
+                    for (const part of message.parts) {
+                        const partType = part.type;
+                        // Blob content → sentinel (one-shot)
+                        const blobAction = createBlobShrinkAction(part, key);
+                        if (blobAction) {
+                            actions.push(blobAction);
+                            continue;
+                        }
+                        // Tool/server JSON payload fields → sentinel (one-shot)
+                        const jsonField = partType === 'tool_call' ? 'arguments'
+                            : partType === 'tool_call_response' ? 'response'
+                                : partType === 'server_tool_call' ? 'server_tool_call'
+                                    : partType === 'server_tool_call_response' ? 'server_tool_call_response'
+                                        : undefined;
+                        if (jsonField && part[jsonField] !== undefined && part[jsonField] !== JSON_SENTINEL) {
+                            let fieldSize;
+                            try {
+                                fieldSize = Buffer.byteLength(JSON.stringify(part[jsonField]), 'utf8');
+                            }
+                            catch {
+                                fieldSize = 0;
+                            }
+                            if (fieldSize > 0) {
+                                const action = {
+                                    contentBytes: fieldSize,
+                                    sourceKey: key,
+                                    apply() {
+                                        part[jsonField] = JSON_SENTINEL;
+                                        action.contentBytes = 0;
+                                    }
+                                };
+                                actions.push(action);
+                            }
+                            continue;
+                        }
+                        // Text/reasoning content → trim (re-shrinkable)
+                        if ((partType === 'text' || partType === 'reasoning') && typeof part.content === 'string') {
+                            const contentSize = Buffer.byteLength(part.content, 'utf8');
+                            if (contentSize > MIN_SHRINKABLE_STRING_BYTES) {
+                                const action = {
+                                    contentBytes: contentSize,
+                                    sourceKey: key,
+                                    apply(bytesToShed) {
+                                        const cur = Buffer.byteLength(part.content, 'utf8');
+                                        if (cur > TRUNCATED_SUFFIX_BYTES) {
+                                            part.content = trimString(part.content, bytesToShed);
+                                            action.contentBytes = Buffer.byteLength(part.content, 'utf8');
+                                        }
+                                    }
+                                };
+                                actions.push(action);
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        // Non-versioned string attribute → generate shrink action
+        if (!handledAsMessage && typeof attributes[key] === 'string') {
+            const valueSize = Buffer.byteLength(attributes[key], 'utf8');
+            if (valueSize > MIN_SHRINKABLE_STRING_BYTES) {
+                // Message key with raw dict JSON → one-shot sentinel replacement (preserves JSON integrity)
+                // Other strings → incremental trim
+                let isRawJson = false;
+                if (MESSAGE_ATTR_KEYS.has(key)) {
+                    try {
+                        const p = JSON.parse(attributes[key]);
+                        isRawJson = p && typeof p === 'object';
+                    }
+                    catch { /* not JSON */ }
+                }
+                const action = isRawJson
+                    ? {
+                        contentBytes: valueSize,
+                        apply() {
+                            attributes[key] = OVERLIMIT_SENTINEL;
+                            action.contentBytes = Buffer.byteLength(OVERLIMIT_SENTINEL, 'utf8');
+                        }
+                    }
+                    : {
+                        contentBytes: valueSize,
+                        apply(bytesToShed) {
+                            const cur = Buffer.byteLength(attributes[key], 'utf8');
+                            if (cur > TRUNCATED_SUFFIX_BYTES) {
+                                attributes[key] = trimString(attributes[key], bytesToShed);
+                                action.contentBytes = Buffer.byteLength(attributes[key], 'utf8');
+                            }
+                        }
+                    };
+                actions.push(action);
+            }
+        }
+    }
+    return actions;
+}
+function flushParsedMessages(attributes, parsedMessages) {
+    for (const [key, wrapper] of parsedMessages) {
+        try {
+            attributes[key] = JSON.stringify(wrapper);
+        }
+        catch {
+            // Leave the previous string value intact if serialization fails.
+        }
+    }
+}
+function flushParsedMessage(attributes, parsedMessages, key) {
+    const wrapper = parsedMessages.get(key);
+    if (wrapper) {
+        try {
+            attributes[key] = JSON.stringify(wrapper);
+        }
+        catch {
+            // Leave the previous string value intact if serialization fails.
+        }
+    }
+}
+function runShrinkPhase(span, attributes, parsedMessages, currentSize) {
+    let nextSize = currentSize;
+    const actions = collectShrinkActions(attributes, parsedMessages);
+    while (actions.length > 0 && nextSize > MAX_SPAN_SIZE_BYTES) {
+        // Pick the action with the largest contentBytes (accounts for updated sizes)
+        let maxIdx = 0;
+        for (let j = 1; j < actions.length; j++) {
+            if (actions[j].contentBytes > actions[maxIdx].contentBytes)
+                maxIdx = j;
+        }
+        const excess = nextSize - MAX_SPAN_SIZE_BYTES;
+        const previousSize = nextSize;
+        const action = actions[maxIdx];
+        action.apply(excess);
+        // Flush only the modified message attribute instead of all parsed messages
+        if (action.sourceKey) {
+            flushParsedMessage(attributes, parsedMessages, action.sourceKey);
+        }
+        nextSize = getSerializedSize(span);
+        if (nextSize >= previousSize) {
+            // Action had no effect — remove it
+            actions.splice(maxIdx, 1);
+        }
+        else if (action.contentBytes <= MIN_SHRINKABLE_STRING_BYTES) {
+            // Exhausted (one-shot or fully trimmed) — remove it
+            actions.splice(maxIdx, 1);
+        }
+    }
+    // Final flush to ensure all modified message attributes are written back
+    flushParsedMessages(attributes, parsedMessages);
+    return nextSize;
+}
+/**
+ * Truncate span attributes if the serialized span exceeds MAX_SPAN_SIZE_BYTES.
+ *
+ * Phase 1: iteratively shrink all fields (blobs, text, json, strings) by size
+ *          priority, remeasuring after each step.
+ * Phase 2 (fallback): replace remaining string attributes with overlimit sentinel.
+ */
+export function truncateSpan(spanDict) {
+    try {
+        let currentSize = getSerializedSize(spanDict);
+        if (currentSize <= MAX_SPAN_SIZE_BYTES)
+            return spanDict;
+        logger.warn(`[Agent365Exporter] Span size (${currentSize} bytes) exceeds limit (${MAX_SPAN_SIZE_BYTES} bytes). Shrinking attributes.`);
+        const truncated = { ...spanDict };
+        if (truncated.attributes)
+            truncated.attributes = { ...truncated.attributes };
+        const attributes = truncated.attributes;
+        if (!attributes)
+            return truncated;
+        const parsedMessages = new Map();
+        // Phase 1: iteratively shrink all fields by size priority
+        currentSize = runShrinkPhase(truncated, attributes, parsedMessages, currentSize);
+        if (currentSize > MAX_SPAN_SIZE_BYTES) {
+            // Phase 2 (fallback): replace all string attributes with overlimit sentinel, largest first.
+            // Message attributes get a structured sentinel preserving the original message count.
+            const stringKeys = Object.keys(attributes)
+                .filter(k => typeof attributes[k] === 'string' && attributes[k] !== OVERLIMIT_SENTINEL)
+                .sort((a, b) => Buffer.byteLength(attributes[b], 'utf8') - Buffer.byteLength(attributes[a], 'utf8'));
+            for (const key of stringKeys) {
+                if (currentSize <= MAX_SPAN_SIZE_BYTES)
+                    break;
+                if (MESSAGE_ATTR_KEYS.has(key)) {
+                    let messageCount = 0;
+                    const cached = parsedMessages.get(key);
+                    if (cached) {
+                        messageCount = cached.messages.length;
+                    }
+                    else if (typeof attributes[key] === 'string') {
+                        // Attempt to derive count from current attribute value
+                        try {
+                            const parsed = JSON.parse(attributes[key]);
+                            if (parsed && typeof parsed === 'object' && typeof parsed.version === 'string' && Array.isArray(parsed.messages)) {
+                                messageCount = parsed.messages.length;
+                            }
+                        }
+                        catch { /* not valid JSON — count stays 0 */ }
+                    }
+                    attributes[key] = serializeOverflowSentinel(messageCount);
+                    parsedMessages.delete(key);
+                }
+                else {
+                    attributes[key] = OVERLIMIT_SENTINEL;
+                }
+                currentSize = getSerializedSize(truncated);
+            }
+        }
+        if (currentSize > MAX_SPAN_SIZE_BYTES) {
+            logger.warn(`[Agent365Exporter] Span still ${currentSize} bytes after exhausting all shrink actions (limit: ${MAX_SPAN_SIZE_BYTES}).`);
+        }
+        return truncated;
+    }
+    catch (e) {
+        logger.error(`[Agent365Exporter] Error during span truncation: ${e}`);
+        return spanDict;
+    }
+}
 //# sourceMappingURL=utils.js.map

package/dist/esm/tracing/exporter/utils.js.map

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

package/dist/esm/tracing/message-utils.d.ts

@@ -0,0 +1,36 @@
+import { ChatMessage, OutputMessage, InputMessages, OutputMessages, InputMessagesParam, OutputMessagesParam } from './contracts';
+/**
+ * Type guard that returns `true` when the input is a versioned wrapper
+ * object (`InputMessages` or `OutputMessages`).
+ */
+export declare function isWrappedMessages(input: InputMessagesParam | OutputMessagesParam): input is InputMessages | OutputMessages;
+/**
+ * Converts plain input strings into OTEL input messages.
+ */
+export declare function toInputMessages(messages: string[]): ChatMessage[];
+/**
+ * Converts plain output strings into OTEL output messages.
+ */
+export declare function toOutputMessages(messages: string[]): OutputMessage[];
+/**
+ * Normalizes an `InputMessagesParam` to a versioned `InputMessages` wrapper.
+ * - `string` / `string[]` → converted to `ChatMessage[]` and wrapped
+ * - `InputMessages` → returned as-is
+ */
+export declare function normalizeInputMessages(param: InputMessagesParam): InputMessages;
+/**
+ * Normalizes an `OutputMessagesParam` to a versioned `OutputMessages` wrapper.
+ * - `string` / `string[]` → converted to `OutputMessage[]` and wrapped
+ * - `OutputMessages` → returned as-is
+ */
+export declare function normalizeOutputMessages(param: OutputMessagesParam): OutputMessages;
+/**
+ * Serializes a versioned message wrapper to JSON.
+ *
+ * The output is the full wrapper object: `{"version":"0.1.0","messages":[...]}`.
+ *
+ * The try/catch ensures telemetry recording is non-throwing even when
+ * message parts contain non-JSON-serializable values (e.g. BigInt, circular refs).
+ */
+export declare function serializeMessages(wrapper: InputMessages | OutputMessages): string;
+//# sourceMappingURL=message-utils.d.ts.map

package/dist/esm/tracing/message-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-utils.d.ts","sourceRoot":"","sources":["../../../src/tracing/message-utils.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,WAAW,EACX,aAAa,EAEb,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EAEpB,MAAM,aAAa,CAAC;AAErB;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,kBAAkB,GAAG,mBAAmB,GAAG,KAAK,IAAI,aAAa,GAAG,cAAc,CAE1H;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAKjE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,CAKpE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAM/E;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc,CAMlF;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,GAAG,MAAM,CAmBjF"}

package/dist/esm/tracing/message-utils.js

@@ -0,0 +1,82 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { MessageRole, A365_MESSAGE_SCHEMA_VERSION } from './contracts';
+/**
+ * Type guard that returns `true` when the input is a versioned wrapper
+ * object (`InputMessages` or `OutputMessages`).
+ */
+export function isWrappedMessages(input) {
+    return !Array.isArray(input) && typeof input === 'object' && input !== null && 'version' in input && 'messages' in input;
+}
+/**
+ * Converts plain input strings into OTEL input messages.
+ */
+export function toInputMessages(messages) {
+    return messages.map((content) => ({
+        role: MessageRole.USER,
+        parts: [{ type: 'text', content }]
+    }));
+}
+/**
+ * Converts plain output strings into OTEL output messages.
+ */
+export function toOutputMessages(messages) {
+    return messages.map((content) => ({
+        role: MessageRole.ASSISTANT,
+        parts: [{ type: 'text', content }]
+    }));
+}
+/**
+ * Normalizes an `InputMessagesParam` to a versioned `InputMessages` wrapper.
+ * - `string` / `string[]` → converted to `ChatMessage[]` and wrapped
+ * - `InputMessages` → returned as-is
+ */
+export function normalizeInputMessages(param) {
+    if (typeof param === 'string' || Array.isArray(param)) {
+        const arr = typeof param === 'string' ? [param] : param;
+        return { version: A365_MESSAGE_SCHEMA_VERSION, messages: toInputMessages(arr) };
+    }
+    return param;
+}
+/**
+ * Normalizes an `OutputMessagesParam` to a versioned `OutputMessages` wrapper.
+ * - `string` / `string[]` → converted to `OutputMessage[]` and wrapped
+ * - `OutputMessages` → returned as-is
+ */
+export function normalizeOutputMessages(param) {
+    if (typeof param === 'string' || Array.isArray(param)) {
+        const arr = typeof param === 'string' ? [param] : param;
+        return { version: A365_MESSAGE_SCHEMA_VERSION, messages: toOutputMessages(arr) };
+    }
+    return param;
+}
+/**
+ * Serializes a versioned message wrapper to JSON.
+ *
+ * The output is the full wrapper object: `{"version":"0.1.0","messages":[...]}`.
+ *
+ * The try/catch ensures telemetry recording is non-throwing even when
+ * message parts contain non-JSON-serializable values (e.g. BigInt, circular refs).
+ */
+export function serializeMessages(wrapper) {
+    try {
+        return JSON.stringify(wrapper);
+    }
+    catch {
+        return JSON.stringify({
+            version: A365_MESSAGE_SCHEMA_VERSION,
+            messages: [
+                {
+                    role: MessageRole.SYSTEM,
+                    parts: [
+                        {
+                            type: 'text',
+                            content: `[serialization failed: ${wrapper.messages.length} ${wrapper.messages.length === 1 ? 'message' : 'messages'}]`
+                        }
+                    ]
+                }
+            ]
+        });
+    }
+}
+//# sourceMappingURL=message-utils.js.map

package/dist/esm/tracing/message-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-utils.js","sourceRoot":"","sources":["../../../src/tracing/message-utils.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAGL,WAAW,EAKX,2BAA2B,EAC5B,MAAM,aAAa,CAAC;AAErB;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAA+C;IAC/E,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,SAAS,IAAI,KAAK,IAAI,UAAU,IAAI,KAAK,CAAC;AAC3H,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAkB;IAChD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAChC,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,OAAO,EAAE,CAAC;KAC5C,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAkB;IACjD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAChC,IAAI,EAAE,WAAW,CAAC,SAAS;QAC3B,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,OAAO,EAAE,CAAC;KAC5C,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAyB;IAC9D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACxD,OAAO,EAAE,OAAO,EAAE,2BAA2B,EAAE,QAAQ,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;IAClF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAA0B;IAChE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACxD,OAAO,EAAE,OAAO,EAAE,2BAA2B,EAAE,QAAQ,EAAE,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;IACnF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAuC;IACvE,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,OAAO,EAAE,2BAA2B;YACpC,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,WAAW,CAAC,MAAM;oBACxB,KAAK,EAAE;wBACL;4BACE,IAAI,EAAE,MAAM;4BACZ,OAAO,EAAE,0BAA0B,OAAO,CAAC,QAAQ,CAAC,MAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,GAAG;yBACxH;qBACF;iBACF;aACF;SACF,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/esm/tracing/scopes/ExecuteToolScope.d.ts

@@ -11,15 +11,15 @@ export declare class ExecuteToolScope extends OpenTelemetryScope {
      * @param details The tool call details (name, type, args, call id, etc.).
      * @param agentDetails The agent executing the tool. Tenant ID is derived from `agentDetails.tenantId`.
      * @param userDetails Optional human caller identity.
-     * @param spanDetails Optional span configuration (parentContext, startTime, endTime, spanLinks). Any provided spanKind is ignored; ExecuteToolScope always uses SpanKind.INTERNAL.
+     * @param spanDetails Optional span configuration (parentContext, startTime, endTime, spanLinks, spanKind). Defaults to SpanKind.INTERNAL.
      * @returns A new ExecuteToolScope instance.
      */
     static start(request: Request, details: ToolCallDetails, agentDetails: AgentDetails, userDetails?: UserDetails, spanDetails?: SpanDetails): ExecuteToolScope;
     private constructor();
     /**
      * Records response information for telemetry tracking.
-     * @param response The tool execution response
+     * @param response The tool execution response. Objects are serialized to JSON automatically.
      */
-    recordResponse(response: string): void;
+    recordResponse(response: Record<string, unknown> | string): void;
 }
 //# sourceMappingURL=ExecuteToolScope.d.ts.map

package/dist/esm/tracing/scopes/ExecuteToolScope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExecuteToolScope.d.ts","sourceRoot":"","sources":["../../../../src/tracing/scopes/ExecuteToolScope.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EACL,eAAe,EACf,YAAY,EACZ,WAAW,EACX,OAAO,EACP,WAAW,EACZ,MAAM,cAAc,CAAC;AAGtB;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,kBAAkB;IACtD;;;;;;;;;OASG;WACW,KAAK,CACjB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,eAAe,EACxB,YAAY,EAAE,YAAY,EAC1B,WAAW,CAAC,EAAE,WAAW,EACzB,WAAW,CAAC,EAAE,WAAW,GACxB,gBAAgB;IAInB,OAAO;IA8CP;;;OAGG;IACI,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAG9C"}
+{"version":3,"file":"ExecuteToolScope.d.ts","sourceRoot":"","sources":["../../../../src/tracing/scopes/ExecuteToolScope.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EACL,eAAe,EACf,YAAY,EACZ,WAAW,EACX,OAAO,EACP,WAAW,EACZ,MAAM,cAAc,CAAC;AAItB;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,kBAAkB;IACtD;;;;;;;;;OASG;WACW,KAAK,CACjB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,eAAe,EACxB,YAAY,EAAE,YAAY,EAC1B,WAAW,CAAC,EAAE,WAAW,EACzB,WAAW,CAAC,EAAE,WAAW,GACxB,gBAAgB;IAInB,OAAO;IAiDP;;;OAGG;IACI,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI;CAMxE"}

package/dist/esm/tracing/scopes/ExecuteToolScope.js

@@ -3,6 +3,7 @@
 import { SpanKind } from '@opentelemetry/api';
 import { OpenTelemetryScope } from './OpenTelemetryScope';
 import { OpenTelemetryConstants } from '../constants';
+import { safeSerializeToJson } from '../util';
 /**
  * Provides OpenTelemetry tracing scope for AI tool execution operations.
  */
@@ -14,7 +15,7 @@ export class ExecuteToolScope extends OpenTelemetryScope {
      * @param details The tool call details (name, type, args, call id, etc.).
      * @param agentDetails The agent executing the tool. Tenant ID is derived from `agentDetails.tenantId`.
      * @param userDetails Optional human caller identity.
-     * @param spanDetails Optional span configuration (parentContext, startTime, endTime, spanLinks). Any provided spanKind is ignored; ExecuteToolScope always uses SpanKind.INTERNAL.
+     * @param spanDetails Optional span configuration (parentContext, startTime, endTime, spanLinks, spanKind). Defaults to SpanKind.INTERNAL.
      * @returns A new ExecuteToolScope instance.
      */
     static start(request, details, agentDetails, userDetails, spanDetails) {
@@ -25,13 +26,13 @@ export class ExecuteToolScope extends OpenTelemetryScope {
         if (!agentDetails.tenantId) {
             throw new Error('ExecuteToolScope: tenantId is required on agentDetails');
         }
-        // spanKind for ExecuteToolScope is always INTERNAL
-        const resolvedSpanDetails = { ...spanDetails, spanKind: SpanKind.INTERNAL };
+        // Default to INTERNAL; allow caller override via spanDetails
+        const resolvedSpanDetails = { spanKind: SpanKind.INTERNAL, ...spanDetails };
         super(OpenTelemetryConstants.EXECUTE_TOOL_OPERATION_NAME, `${OpenTelemetryConstants.EXECUTE_TOOL_OPERATION_NAME} ${details.toolName}`, agentDetails, resolvedSpanDetails, userDetails);
         // Destructure the details object
         const { toolName, arguments: args, toolCallId, description, toolType, endpoint } = details;
         this.setTagMaybe(OpenTelemetryConstants.GEN_AI_TOOL_NAME_KEY, toolName);
-        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_TOOL_ARGS_KEY, args);
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_TOOL_ARGS_KEY, args != null ? safeSerializeToJson(args, 'arguments') : undefined);
         this.setTagMaybe(OpenTelemetryConstants.GEN_AI_TOOL_TYPE_KEY, toolType);
         this.setTagMaybe(OpenTelemetryConstants.GEN_AI_TOOL_CALL_ID_KEY, toolCallId);
         this.setTagMaybe(OpenTelemetryConstants.GEN_AI_TOOL_DESCRIPTION_KEY, description);
@@ -49,10 +50,10 @@ export class ExecuteToolScope extends OpenTelemetryScope {
     }
     /**
      * Records response information for telemetry tracking.
-     * @param response The tool execution response
+     * @param response The tool execution response. Objects are serialized to JSON automatically.
      */
     recordResponse(response) {
-        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_TOOL_CALL_RESULT_KEY, response);
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_TOOL_CALL_RESULT_KEY, safeSerializeToJson(response, 'result'));
     }
 }
 //# sourceMappingURL=ExecuteToolScope.js.map

package/dist/esm/tracing/scopes/ExecuteToolScope.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExecuteToolScope.js","sourceRoot":"","sources":["../../../../src/tracing/scopes/ExecuteToolScope.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAQ1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEtD;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,kBAAkB;IACtD;;;;;;;;;OASG;IACI,MAAM,CAAC,KAAK,CACjB,OAAgB,EAChB,OAAwB,EACxB,YAA0B,EAC1B,WAAyB,EACzB,WAAyB;QAEzB,OAAO,IAAI,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;IACxF,CAAC;IAED,YACE,OAAgB,EAChB,OAAwB,EACxB,YAA0B,EAC1B,WAAyB,EACzB,WAAyB;QAEzB,wDAAwD;QACxD,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QAED,mDAAmD;QACnD,MAAM,mBAAmB,GAAgB,EAAE,GAAG,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAEzF,KAAK,CACH,sBAAsB,CAAC,2BAA2B,EAClD,GAAG,sBAAsB,CAAC,2BAA2B,IAAI,OAAO,CAAC,QAAQ,EAAE,EAC3E,YAAY,EACZ,mBAAmB,EACnB,WAAW,CACZ,CAAC;QAEF,iCAAiC;QACjC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;QAE3F,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;QACxE,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;QACpE,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;QACxE,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,uBAAuB,EAAE,UAAU,CAAC,CAAC;QAC7E,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,2BAA2B,EAAE,WAAW,CAAC,CAAC;QAClF,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,0BAA0B,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;QAC5F,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,gBAAgB,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACjF,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,gBAAgB,EAAE,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAExF,uCAAuC;QACvC,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,kBAAkB,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;YAE3E,oEAAoE;YACpE,IAAI,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;gBAC3C,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,eAAe,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,cAAc,CAAC,QAAgB;QACpC,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,2BAA2B,EAAE,QAAQ,CAAC,CAAC;IACjF,CAAC;CACF"}
+{"version":3,"file":"ExecuteToolScope.js","sourceRoot":"","sources":["../../../../src/tracing/scopes/ExecuteToolScope.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAQ1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE9C;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,kBAAkB;IACtD;;;;;;;;;OASG;IACI,MAAM,CAAC,KAAK,CACjB,OAAgB,EAChB,OAAwB,EACxB,YAA0B,EAC1B,WAAyB,EACzB,WAAyB;QAEzB,OAAO,IAAI,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;IACxF,CAAC;IAED,YACE,OAAgB,EAChB,OAAwB,EACxB,YAA0B,EAC1B,WAAyB,EACzB,WAAyB;QAEzB,wDAAwD;QACxD,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QAED,6DAA6D;QAC7D,MAAM,mBAAmB,GAAgB,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,GAAG,WAAW,EAAE,CAAC;QAEzF,KAAK,CACH,sBAAsB,CAAC,2BAA2B,EAClD,GAAG,sBAAsB,CAAC,2BAA2B,IAAI,OAAO,CAAC,QAAQ,EAAE,EAC3E,YAAY,EACZ,mBAAmB,EACnB,WAAW,CACZ,CAAC;QAEF,iCAAiC;QACjC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;QAE3F,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;QACxE,IAAI,CAAC,WAAW,CACd,sBAAsB,CAAC,oBAAoB,EAC3C,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAClE,CAAC;QACF,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;QACxE,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,uBAAuB,EAAE,UAAU,CAAC,CAAC;QAC7E,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,2BAA2B,EAAE,WAAW,CAAC,CAAC;QAClF,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,0BAA0B,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;QAC5F,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,gBAAgB,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACjF,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,gBAAgB,EAAE,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAExF,uCAAuC;QACvC,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,kBAAkB,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;YAE3E,oEAAoE;YACpE,IAAI,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;gBAC3C,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,eAAe,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,cAAc,CAAC,QAA0C;QAC9D,IAAI,CAAC,WAAW,CACd,sBAAsB,CAAC,2BAA2B,EAClD,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CACxC,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/tracing/scopes/InferenceScope.d.ts

@@ -1,5 +1,5 @@
 import { OpenTelemetryScope } from './OpenTelemetryScope';
-import { InferenceDetails, AgentDetails, UserDetails, Request, SpanDetails } from '../contracts';
+import { InferenceDetails, AgentDetails, UserDetails, Request, SpanDetails, InputMessagesParam, OutputMessagesParam } from '../contracts';
 /**
  * Provides OpenTelemetry tracing scope for generative AI inference operations.
  */
@@ -16,16 +16,6 @@ export declare class InferenceScope extends OpenTelemetryScope {
      */
     static start(request: Request, details: InferenceDetails, agentDetails: AgentDetails, userDetails?: UserDetails, spanDetails?: SpanDetails): InferenceScope;
     private constructor();
-    /**
-     * Records the input messages for telemetry tracking.
-     * @param messages Array of input messages
-     */
-    recordInputMessages(messages: string[]): void;
-    /**
-     * Records the output messages for telemetry tracking.
-     * @param messages Array of output messages
-     */
-    recordOutputMessages(messages: string[]): void;
     /**
      * Records the number of input tokens for telemetry tracking.
      * @param inputTokens Number of input tokens
@@ -41,5 +31,17 @@ export declare class InferenceScope extends OpenTelemetryScope {
      * @param finishReasons Array of finish reasons
      */
     recordFinishReasons(finishReasons: string[]): void;
+    /**
+     * Records the input messages for telemetry tracking.
+     * Accepts plain strings (auto-wrapped as OTEL ChatMessage with role `user`) or a versioned InputMessages wrapper.
+     * @param messages Array of input message strings or an InputMessages wrapper
+     */
+    recordInputMessages(messages: InputMessagesParam): void;
+    /**
+     * Records the output messages for telemetry tracking.
+     * Accepts plain strings (auto-wrapped as OTEL OutputMessage with role `assistant`) or a versioned OutputMessages wrapper.
+     * @param messages Array of output message strings or an OutputMessages wrapper
+     */
+    recordOutputMessages(messages: OutputMessagesParam): void;
 }
 //# sourceMappingURL=InferenceScope.d.ts.map

package/dist/esm/tracing/scopes/InferenceScope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InferenceScope.d.ts","sourceRoot":"","sources":["../../../../src/tracing/scopes/InferenceScope.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,OAAO,EACP,WAAW,EACZ,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,qBAAa,cAAe,SAAQ,kBAAkB;IACpD;;;;;;;;;OASG;WACW,KAAK,CACjB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,gBAAgB,EACzB,YAAY,EAAE,YAAY,EAC1B,WAAW,CAAC,EAAE,WAAW,EACzB,WAAW,CAAC,EAAE,WAAW,GACxB,cAAc;IAIjB,OAAO;IA6CP;;;OAGG;IACI,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAIpD;;;OAGG;IACI,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAIrD;;;OAGG;IACI,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAInD;;;OAGG;IACI,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAIrD;;;OAGG;IACI,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,IAAI;CAM1D"}
+{"version":3,"file":"InferenceScope.d.ts","sourceRoot":"","sources":["../../../../src/tracing/scopes/InferenceScope.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,OAAO,EACP,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,qBAAa,cAAe,SAAQ,kBAAkB;IACpD;;;;;;;;;OASG;WACW,KAAK,CACjB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,gBAAgB,EACzB,YAAY,EAAE,YAAY,EAC1B,WAAW,CAAC,EAAE,WAAW,EACzB,WAAW,CAAC,EAAE,WAAW,GACxB,cAAc;IAIjB,OAAO;IA6CP;;;OAGG;IACI,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAInD;;;OAGG;IACI,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAIrD;;;OAGG;IACI,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,IAAI;IAMzD;;;;OAIG;IACa,mBAAmB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAIvE;;;;OAIG;IACa,oBAAoB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;CAG1E"}