@microsoft/agents-a365-observability 0.1.0-preview.30

package/dist/esm/tracing/middleware/BaggageBuilder.js

@@ -0,0 +1,292 @@
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+import { propagation, context as otelContext } from '@opentelemetry/api';
+import { OpenTelemetryConstants } from '../constants';
+/**
+ * Per request baggage builder for OpenTelemetry context propagation.
+ *
+ * This class provides a fluent API for setting baggage values that will be
+ * propagated in the OpenTelemetry context.
+ *
+ * @example
+ * ```typescript
+ * const scope = new BaggageBuilder()
+ *   .tenantId("tenant-123")
+ *   .agentId("agent-456")
+ *   .correlationId("corr-789")
+ *   .build();
+ *
+ * scope.enter();
+ * // Baggage is set in this context
+ * // ... do work ...
+ * scope.exit();
+ * // Baggage is restored after exiting the context
+ * ```
+ */
+export class BaggageBuilder {
+    constructor() {
+        this.pairs = new Map();
+    }
+    /**
+     * Set the operation source baggage value.
+     * @param value The operation source value
+     * @returns Self for method chaining
+     */
+    operationSource(value) {
+        this.set(OpenTelemetryConstants.OPERATION_SOURCE_KEY, value);
+        return this;
+    }
+    /**
+     * Set the tenant ID baggage value.
+     * @param value The tenant ID
+     * @returns Self for method chaining
+     */
+    tenantId(value) {
+        this.set(OpenTelemetryConstants.TENANT_ID_KEY, value);
+        return this;
+    }
+    /**
+     * Set the agent ID baggage value.
+     * @param value The agent ID
+     * @returns Self for method chaining
+     */
+    agentId(value) {
+        this.set(OpenTelemetryConstants.GEN_AI_AGENT_ID_KEY, value);
+        return this;
+    }
+    /**
+     * Set the agent AUID baggage value.
+     * @param value The agent AUID
+     * @returns Self for method chaining
+     */
+    agentAuid(value) {
+        this.set(OpenTelemetryConstants.GEN_AI_AGENT_AUID_KEY, value);
+        return this;
+    }
+    /**
+     * Set the agent UPN baggage value.
+     * @param value The agent UPN
+     * @returns Self for method chaining
+     */
+    agentUpn(value) {
+        this.set(OpenTelemetryConstants.GEN_AI_AGENT_UPN_KEY, value);
+        return this;
+    }
+    /**
+     * Set the agent blueprint ID baggage value.
+     * @param value The agent blueprint ID
+     * @returns Self for method chaining
+     */
+    agentBlueprintId(value) {
+        this.set(OpenTelemetryConstants.GEN_AI_AGENT_BLUEPRINT_ID_KEY, value);
+        return this;
+    }
+    /**
+     * Set the correlation ID baggage value.
+     * @param value The correlation ID
+     * @returns Self for method chaining
+     */
+    correlationId(value) {
+        this.set(OpenTelemetryConstants.CORRELATION_ID_KEY, value);
+        return this;
+    }
+    /**
+     * Set the caller ID baggage value.
+     * @param value The caller ID
+     * @returns Self for method chaining
+     */
+    callerId(value) {
+        this.set(OpenTelemetryConstants.GEN_AI_CALLER_ID_KEY, value);
+        return this;
+    }
+    /**
+     * Set the hiring manager ID baggage value.
+     * @param value The hiring manager ID
+     * @returns Self for method chaining
+     */
+    hiringManagerId(value) {
+        this.set(OpenTelemetryConstants.HIRING_MANAGER_ID_KEY, value);
+        return this;
+    }
+    /**
+     * Set the agent name baggage value.
+     * @param value The agent name
+     * @returns Self for method chaining
+     */
+    agentName(value) {
+        this.set(OpenTelemetryConstants.GEN_AI_AGENT_NAME_KEY, value);
+        return this;
+    }
+    /**
+     * Set the agent description baggage value.
+     * @param value The agent description
+     * @returns Self for method chaining
+     */
+    agentDescription(value) {
+        this.set(OpenTelemetryConstants.GEN_AI_AGENT_DESCRIPTION_KEY, value);
+        return this;
+    }
+    /**
+     * Set the caller name baggage value.
+     * @param value The caller name
+     * @returns Self for method chaining
+     */
+    callerName(value) {
+        this.set(OpenTelemetryConstants.GEN_AI_CALLER_NAME_KEY, value);
+        return this;
+    }
+    /**
+     * Set the caller UPN baggage value.
+     * @param value The caller UPN
+     * @returns Self for method chaining
+     */
+    callerUpn(value) {
+        this.set(OpenTelemetryConstants.GEN_AI_CALLER_UPN_KEY, value);
+        return this;
+    }
+    /**
+     * Set the conversation ID baggage value.
+     * @param value The conversation ID
+     * @returns Self for method chaining
+     */
+    conversationId(value) {
+        this.set(OpenTelemetryConstants.GEN_AI_CONVERSATION_ID_KEY, value);
+        return this;
+    }
+    /**
+     * Set the conversation item link baggage value.
+     * @param value The conversation item link
+     * @returns Self for method chaining
+     */
+    conversationItemLink(value) {
+        this.set(OpenTelemetryConstants.GEN_AI_CONVERSATION_ITEM_LINK_KEY, value);
+        return this;
+    }
+    /**
+     * Set the execution source metadata ID (e.g., channel ID).
+     * @param value The source metadata ID
+     * @returns Self for method chaining
+     */
+    sourceMetadataId(value) {
+        this.set(OpenTelemetryConstants.GEN_AI_EXECUTION_SOURCE_ID_KEY, value);
+        return this;
+    }
+    /**
+     * Set the execution source metadata name (e.g., channel name).
+     * @param value The source metadata name
+     * @returns Self for method chaining
+     */
+    sourceMetadataName(value) {
+        this.set(OpenTelemetryConstants.GEN_AI_EXECUTION_SOURCE_NAME_KEY, value);
+        return this;
+    }
+    /**
+     * Set the execution source metadata description (e.g., channel description).
+     * @param value The source metadata description
+     * @returns Self for method chaining
+     */
+    sourceMetadataDescription(value) {
+        this.set(OpenTelemetryConstants.GEN_AI_EXECUTION_SOURCE_DESCRIPTION_KEY, value);
+        return this;
+    }
+    /**
+     * Set multiple baggage pairs from a dictionary or iterable.
+     * @param pairs Dictionary or iterable of key-value pairs
+     * @returns Self for method chaining
+     */
+    setPairs(pairs) {
+        if (!pairs) {
+            return this;
+        }
+        let entries;
+        if (Symbol.iterator in Object(pairs)) {
+            entries = pairs;
+        }
+        else {
+            entries = Object.entries(pairs);
+        }
+        for (const [key, value] of entries) {
+            if (value !== null && value !== undefined) {
+                this.set(key, String(value));
+            }
+        }
+        return this;
+    }
+    /**
+     * Apply the collected baggage to the current context.
+     * @returns A context manager that restores the previous baggage on exit
+     */
+    build() {
+        return new BaggageScope(this.pairs);
+    }
+    /**
+     * Add a baggage key/value if the value is not null or whitespace.
+     * @param key The baggage key
+     * @param value The baggage value
+     */
+    set(key, value) {
+        if (value !== null && value !== undefined) {
+            const trimmed = value.trim();
+            if (trimmed) {
+                this.pairs.set(key, trimmed);
+            }
+        }
+    }
+    /**
+     * Convenience method to begin a request baggage scope with common fields.
+     * @param tenantId The tenant ID
+     * @param agentId The agent ID
+     * @param correlationId The correlation ID
+     * @returns A context manager that restores the previous baggage on exit
+     */
+    static setRequestContext(tenantId, agentId, correlationId) {
+        return new BaggageBuilder()
+            .tenantId(tenantId)
+            .agentId(agentId)
+            .correlationId(correlationId)
+            .build();
+    }
+}
+/**
+ * Context manager for baggage scope.
+ *
+ * This class manages the lifecycle of baggage values, setting them on enter
+ * and restoring the previous context on exit.
+ */
+export class BaggageScope {
+    constructor(pairs) {
+        // 1. Start from current active context
+        const currentCtx = otelContext.active();
+        // 2. Build merged baggage
+        let bag = propagation.getBaggage(currentCtx) ?? propagation.createBaggage({});
+        for (const [key, value] of pairs.entries()) {
+            if (value && value.trim()) {
+                bag = bag.setEntry(key, { value });
+            }
+        }
+        // 3. Create a new context that carries that baggage
+        this.contextWithBaggage = propagation.setBaggage(currentCtx, bag);
+    }
+    /**
+     * Execute a synchronous function under this baggage scope.
+     * Automatically restores previous context afterward.
+     */
+    run(fn) {
+        return otelContext.with(this.contextWithBaggage, fn);
+    }
+    /**
+     * Dispose is a no-op because OpenTelemetry JS automatically restores
+     * the previous context after `context.with()` completes.
+     */
+    [Symbol.dispose]() {
+        // Nothing to detach manually; context restoration happens automatically.
+    }
+    /**
+     * Manual cleanup alternative if caller isn't using `using`.
+     */
+    dispose() {
+        this[Symbol.dispose]();
+    }
+}
+//# sourceMappingURL=BaggageBuilder.js.map

package/dist/esm/tracing/middleware/BaggageBuilder.js.map

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

package/dist/esm/tracing/processors/SpanProcessor.d.ts

@@ -0,0 +1,30 @@
+import { Context, Span } from '@opentelemetry/api';
+import { SpanProcessor as BaseSpanProcessor } from '@opentelemetry/sdk-trace-base';
+import { ReadableSpan } from '@opentelemetry/sdk-trace-base';
+/**
+ * Span processor that propagates baggage key/value pairs to span attributes.
+ *
+ * This processor copies baggage entries onto spans based on the operation type.
+ * For invoke_agent operations, it applies both generic and invoke-agent-specific attributes.
+ * For other operations, it applies only generic attributes.
+ */
+export declare class SpanProcessor implements BaseSpanProcessor {
+    /**
+     * Called when a span is started.
+     * Copies relevant baggage entries to span attributes.
+     */
+    onStart(span: Span, parentContext?: Context): void;
+    /**
+     * Called when a span is ended.
+     */
+    onEnd(_span: ReadableSpan): void;
+    /**
+     * Shutdown the processor.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Force flush the processor.
+     */
+    forceFlush(): Promise<void>;
+}
+//# sourceMappingURL=SpanProcessor.d.ts.map

package/dist/esm/tracing/processors/SpanProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpanProcessor.d.ts","sourceRoot":"","sources":["../../../../src/tracing/processors/SpanProcessor.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAe,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAI7D;;;;;;GAMG;AACH,qBAAa,aAAc,YAAW,iBAAiB;IACrD;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,IAAI;IAkElD;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAIhC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC"}

package/dist/esm/tracing/processors/SpanProcessor.js

@@ -0,0 +1,94 @@
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+import { propagation } from '@opentelemetry/api';
+import { OpenTelemetryConstants } from '../constants';
+import { GENERIC_ATTRIBUTES, INVOKE_AGENT_ATTRIBUTES } from './util';
+/**
+ * Span processor that propagates baggage key/value pairs to span attributes.
+ *
+ * This processor copies baggage entries onto spans based on the operation type.
+ * For invoke_agent operations, it applies both generic and invoke-agent-specific attributes.
+ * For other operations, it applies only generic attributes.
+ */
+export class SpanProcessor {
+    /**
+     * Called when a span is started.
+     * Copies relevant baggage entries to span attributes.
+     */
+    onStart(span, parentContext) {
+        const ctx = parentContext;
+        if (!ctx) {
+            return;
+        }
+        // Get existing span attributes
+        const existingAttrs = new Set();
+        try {
+            const spanRecord = span;
+            if (spanRecord.attributes) {
+                Object.keys(spanRecord.attributes).forEach(key => existingAttrs.add(key));
+            }
+        }
+        catch {
+            // Ignore errors accessing span attributes
+        }
+        // Get all baggage entries
+        const baggage = propagation.getBaggage(ctx);
+        if (!baggage) {
+            return;
+        }
+        const baggageMap = new Map();
+        baggage.getAllEntries().forEach(([key, entry]) => {
+            if (entry.value) {
+                baggageMap.set(key, entry.value);
+            }
+        });
+        // Determine if this is an invoke_agent operation
+        const operationName = baggageMap.get(OpenTelemetryConstants.GEN_AI_OPERATION_NAME_KEY) ||
+            span.attributes?.[OpenTelemetryConstants.GEN_AI_OPERATION_NAME_KEY];
+        const spanName = span.name || '';
+        const isInvokeAgent = operationName === OpenTelemetryConstants.INVOKE_AGENT_OPERATION_NAME ||
+            spanName.startsWith(OpenTelemetryConstants.INVOKE_AGENT_OPERATION_NAME);
+        // Build target key set
+        const targetKeys = new Set(GENERIC_ATTRIBUTES);
+        if (isInvokeAgent) {
+            INVOKE_AGENT_ATTRIBUTES.forEach(key => targetKeys.add(key));
+        }
+        // Copy baggage to span attributes
+        for (const key of targetKeys) {
+            // Skip if attribute already exists
+            if (existingAttrs.has(key)) {
+                continue;
+            }
+            const value = baggageMap.get(key);
+            if (!value) {
+                continue;
+            }
+            try {
+                span.setAttribute(key, value);
+            }
+            catch {
+                // Ignore errors setting attributes
+            }
+        }
+    }
+    /**
+     * Called when a span is ended.
+     */
+    onEnd(_span) {
+        // No-op for this processor
+    }
+    /**
+     * Shutdown the processor.
+     */
+    async shutdown() {
+        // No-op for this processor
+    }
+    /**
+     * Force flush the processor.
+     */
+    async forceFlush() {
+        // No-op for this processor
+    }
+}
+//# sourceMappingURL=SpanProcessor.js.map

package/dist/esm/tracing/processors/SpanProcessor.js.map

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

package/dist/esm/tracing/processors/util.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generic / common tracing attributes applied to all spans
+ */
+export declare const GENERIC_ATTRIBUTES: readonly string[];
+/**
+ * Invoke Agent-specific attributes
+ */
+export declare const INVOKE_AGENT_ATTRIBUTES: readonly string[];
+//# sourceMappingURL=util.d.ts.map

package/dist/esm/tracing/processors/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../../src/tracing/processors/util.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAe/C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAmBpD,CAAC"}

package/dist/esm/tracing/processors/util.js

@@ -0,0 +1,47 @@
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+import { OpenTelemetryConstants as consts } from '../constants';
+/**
+ * Generic / common tracing attributes applied to all spans
+ */
+export const GENERIC_ATTRIBUTES = [
+    consts.TENANT_ID_KEY,
+    consts.CUSTOM_PARENT_SPAN_ID_KEY,
+    consts.CUSTOM_SPAN_NAME_KEY,
+    consts.CORRELATION_ID_KEY,
+    consts.GEN_AI_CONVERSATION_ID_KEY,
+    consts.GEN_AI_CONVERSATION_ITEM_LINK_KEY,
+    consts.GEN_AI_OPERATION_NAME_KEY,
+    consts.GEN_AI_AGENT_ID_KEY,
+    consts.GEN_AI_AGENT_NAME_KEY,
+    consts.GEN_AI_AGENT_DESCRIPTION_KEY,
+    consts.GEN_AI_AGENT_USER_ID_KEY,
+    consts.GEN_AI_AGENT_UPN_KEY,
+    consts.GEN_AI_AGENT_BLUEPRINT_ID_KEY,
+    consts.GEN_AI_AGENT_AUID_KEY,
+];
+/**
+ * Invoke Agent-specific attributes
+ */
+export const INVOKE_AGENT_ATTRIBUTES = [
+    // Caller / Invoker attributes
+    consts.GEN_AI_CALLER_ID_KEY,
+    consts.GEN_AI_CALLER_NAME_KEY,
+    consts.GEN_AI_CALLER_UPN_KEY,
+    consts.GEN_AI_CALLER_USER_ID_KEY,
+    consts.GEN_AI_CALLER_TENANT_ID_KEY,
+    // Caller Agent (A2A) attributes
+    consts.GEN_AI_CALLER_AGENT_ID_KEY,
+    consts.GEN_AI_CALLER_AGENT_NAME_KEY,
+    consts.GEN_AI_CALLER_AGENT_USER_ID_KEY,
+    consts.GEN_AI_CALLER_AGENT_UPN_KEY,
+    consts.GEN_AI_CALLER_AGENT_TENANT_ID_KEY,
+    consts.GEN_AI_CALLER_AGENT_APPLICATION_ID_KEY,
+    // Execution context
+    consts.GEN_AI_EXECUTION_TYPE_KEY,
+    consts.GEN_AI_EXECUTION_SOURCE_ID_KEY,
+    consts.GEN_AI_EXECUTION_SOURCE_NAME_KEY,
+    consts.GEN_AI_EXECUTION_SOURCE_DESCRIPTION_KEY,
+];
+//# sourceMappingURL=util.js.map

package/dist/esm/tracing/processors/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../../../src/tracing/processors/util.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,4DAA4D;AAC5D,iFAAiF;AAEjF,OAAO,EAAE,sBAAsB,IAAI,MAAM,EAAE,MAAM,cAAc,CAAC;AAEhE;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAsB;IACnD,MAAM,CAAC,aAAa;IACpB,MAAM,CAAC,yBAAyB;IAChC,MAAM,CAAC,oBAAoB;IAC3B,MAAM,CAAC,kBAAkB;IACzB,MAAM,CAAC,0BAA0B;IACjC,MAAM,CAAC,iCAAiC;IACxC,MAAM,CAAC,yBAAyB;IAChC,MAAM,CAAC,mBAAmB;IAC1B,MAAM,CAAC,qBAAqB;IAC5B,MAAM,CAAC,4BAA4B;IACnC,MAAM,CAAC,wBAAwB;IAC/B,MAAM,CAAC,oBAAoB;IAC3B,MAAM,CAAC,6BAA6B;IACpC,MAAM,CAAC,qBAAqB;CAC7B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAsB;IACxD,8BAA8B;IAC9B,MAAM,CAAC,oBAAoB;IAC3B,MAAM,CAAC,sBAAsB;IAC7B,MAAM,CAAC,qBAAqB;IAC5B,MAAM,CAAC,yBAAyB;IAChC,MAAM,CAAC,2BAA2B;IAClC,gCAAgC;IAChC,MAAM,CAAC,0BAA0B;IACjC,MAAM,CAAC,4BAA4B;IACnC,MAAM,CAAC,+BAA+B;IACtC,MAAM,CAAC,2BAA2B;IAClC,MAAM,CAAC,iCAAiC;IACxC,MAAM,CAAC,sCAAsC;IAC7C,oBAAoB;IACpB,MAAM,CAAC,yBAAyB;IAChC,MAAM,CAAC,8BAA8B;IACrC,MAAM,CAAC,gCAAgC;IACvC,MAAM,CAAC,uCAAuC;CAC/C,CAAC"}

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

@@ -0,0 +1,22 @@
+import { OpenTelemetryScope } from './OpenTelemetryScope';
+import { ToolCallDetails, AgentDetails, TenantDetails } from '../contracts';
+/**
+ * Provides OpenTelemetry tracing scope for AI tool execution operations.
+ */
+export declare class ExecuteToolScope extends OpenTelemetryScope {
+    /**
+     * Creates and starts a new scope for tool execution tracing.
+     * @param details The tool call details
+     * @param agentDetails The agent details
+     * @param tenantDetails The tenant details
+     * @returns A new ExecuteToolScope instance.
+     */
+    static start(details: ToolCallDetails, agentDetails: AgentDetails, tenantDetails: TenantDetails): ExecuteToolScope;
+    private constructor();
+    /**
+     * Records response information for telemetry tracking.
+     * @param response The tool execution response
+     */
+    recordResponse(response: string): void;
+}
+//# sourceMappingURL=ExecuteToolScope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ExecuteToolScope.d.ts","sourceRoot":"","sources":["../../../../src/tracing/scopes/ExecuteToolScope.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG5E;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,kBAAkB;IACtD;;;;;;OAMG;WACW,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,GAAG,gBAAgB;IAIzH,OAAO;IA6BP;;;OAGG;IACI,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAG9C"}

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

@@ -0,0 +1,47 @@
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+import { SpanKind } from '@opentelemetry/api';
+import { OpenTelemetryScope } from './OpenTelemetryScope';
+import { OpenTelemetryConstants } from '../constants';
+/**
+ * Provides OpenTelemetry tracing scope for AI tool execution operations.
+ */
+export class ExecuteToolScope extends OpenTelemetryScope {
+    /**
+     * Creates and starts a new scope for tool execution tracing.
+     * @param details The tool call details
+     * @param agentDetails The agent details
+     * @param tenantDetails The tenant details
+     * @returns A new ExecuteToolScope instance.
+     */
+    static start(details, agentDetails, tenantDetails) {
+        return new ExecuteToolScope(details, agentDetails, tenantDetails);
+    }
+    constructor(details, agentDetails, tenantDetails) {
+        super(SpanKind.INTERNAL, OpenTelemetryConstants.EXECUTE_TOOL_OPERATION_NAME, `${OpenTelemetryConstants.EXECUTE_TOOL_OPERATION_NAME} ${details.toolName}`, agentDetails, tenantDetails);
+        // Destructure the details object to match C# pattern
+        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_TYPE_KEY, toolType);
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_TOOL_CALL_ID_KEY, toolCallId);
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_TOOL_DESCRIPTION_KEY, description);
+        // Set endpoint information if provided
+        if (endpoint) {
+            this.setTagMaybe(OpenTelemetryConstants.SERVER_ADDRESS_KEY, endpoint.host);
+            // Only record port if it is different from 443 (default HTTPS port)
+            if (endpoint.port && endpoint.port !== 443) {
+                this.setTagMaybe(OpenTelemetryConstants.SERVER_PORT_KEY, endpoint.port);
+            }
+        }
+    }
+    /**
+     * Records response information for telemetry tracking.
+     * @param response The tool execution response
+     */
+    recordResponse(response) {
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_EVENT_CONTENT, response);
+    }
+}
+//# sourceMappingURL=ExecuteToolScope.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ExecuteToolScope.js","sourceRoot":"","sources":["../../../../src/tracing/scopes/ExecuteToolScope.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,4DAA4D;AAC5D,iFAAiF;AAEjF,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEtD;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,kBAAkB;IACtD;;;;;;OAMG;IACI,MAAM,CAAC,KAAK,CAAC,OAAwB,EAAE,YAA0B,EAAE,aAA4B;QACpG,OAAO,IAAI,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;IACpE,CAAC;IAED,YAAoB,OAAwB,EAAE,YAA0B,EAAE,aAA4B;QACpG,KAAK,CACH,QAAQ,CAAC,QAAQ,EACjB,sBAAsB,CAAC,2BAA2B,EAClD,GAAG,sBAAsB,CAAC,2BAA2B,IAAI,OAAO,CAAC,QAAQ,EAAE,EAC3E,YAAY,EACZ,aAAa,CACd,CAAC;QAEF,qDAAqD;QACrD,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;QAElF,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,oBAAoB,EAAE,QAAQ,CAAC,CAAC;IAC1E,CAAC;CACF"}

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

@@ -0,0 +1,47 @@
+import { OpenTelemetryScope } from './OpenTelemetryScope';
+import { InferenceDetails, AgentDetails, TenantDetails } from '../contracts';
+/**
+ * Provides OpenTelemetry tracing scope for generative AI inference operations.
+ */
+export declare class InferenceScope extends OpenTelemetryScope {
+    /**
+     * Creates and starts a new scope for inference tracing.
+     * @param details The inference call details
+     * @param agentDetails The agent details
+     * @param tenantDetails The tenant details
+     * @returns A new InferenceScope instance
+     */
+    static start(details: InferenceDetails, agentDetails: AgentDetails, tenantDetails: TenantDetails): 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
+     */
+    recordInputTokens(inputTokens: number): void;
+    /**
+     * Records the number of output tokens for telemetry tracking.
+     * @param outputTokens Number of output tokens
+     */
+    recordOutputTokens(outputTokens: number): void;
+    /**
+     * Records the response id for telemetry tracking.
+     * @param responseId The response ID
+     */
+    recordResponseId(responseId: string): void;
+    /**
+     * Records the finish reasons for telemetry tracking.
+     * @param finishReasons Array of finish reasons
+     */
+    recordFinishReasons(finishReasons: string[]): void;
+}
+//# sourceMappingURL=InferenceScope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"InferenceScope.d.ts","sourceRoot":"","sources":["../../../../src/tracing/scopes/InferenceScope.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACd,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,qBAAa,cAAe,SAAQ,kBAAkB;IACpD;;;;;;OAMG;WACW,KAAK,CAAC,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,GAAG,cAAc;IAIxH,OAAO;IAmBP;;;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,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAMjD;;;OAGG;IACI,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,IAAI;CAM1D"}