@microsoft/agents-a365-observability 0.1.0-preview.95 → 0.2.0-preview.3

package/dist/cjs/tracing/contracts.d.ts

@@ -1,16 +1,5 @@
-/**
- * Represents different types of agent invocations
- */
-export declare enum ExecutionType {
-    /** Direct human-to-agent invocation (e.g., through UI, API call) */
-    HumanToAgent = "HumanToAgent",
-    /** Agent-to-agent invocation (e.g., one agent calling another) */
-    Agent2Agent = "Agent2Agent",
-    /** Event-driven agent invocation (e.g., scheduled, webhook, message queue) */
-    EventToAgent = "EventToAgent",
-    /** Unknown or unspecified invocation type */
-    Unknown = "Unknown"
-}
+import type { SpanKind, TimeInput, Link } from '@opentelemetry/api';
+import type { ParentContext } from './context/trace-context-propagation';
 /**
  * Represents different roles that can invoke an agent
  */
@@ -33,39 +22,33 @@ export declare enum InferenceOperationType {
     GENERATE_CONTENT = "GenerateContent"
 }
 /**
- * Represents metadata about the source of an invocation
+ * Represents channel for an invocation
  */
-export interface SourceMetadata {
-    /** Unique identifier for the source (e.g., agent ID, user ID, system component ID) */
+export interface Channel {
+    /** Unique identifier for the channel (e.g., Teams channel ID, Slack workspace ID) */
     id?: string;
-    /** Human-readable name of the source */
+    /** Human-readable name of the channel (e.g., "Teams", "Slack", "web") */
     name?: string;
-    /** Optional icon identifier or URL for visual representation of the source */
+    /** Optional icon identifier or URL for visual representation of the channel */
     iconUri?: string;
-    /** The role of the source invoking the agent */
+    /** The role of the entity invoking through this channel */
     role?: InvocationRole;
-    /** Optional description providing additional context about the source */
+    /** Optional description or link providing additional context about the channel */
     description?: string;
 }
 /**
- * Represents a request to an agent with telemetry context
+ * Represents a request with telemetry context.
+ * Used across all scope types for channel and conversation tracking.
  */
-export interface AgentRequest {
-    /** The content of the request */
-    content?: string;
-    /** The type of invocation (how the agent was called) */
-    executionType?: ExecutionType;
+export interface Request {
+    /** The content of the request. */
+    content?: InputMessagesParam;
     /** Optional session identifier for grouping related requests */
     sessionId?: string;
-    /** Optional metadata about the source of the invocation */
-    sourceMetadata?: SourceMetadata;
-}
-/**
- * Details about a tenant
- */
-export interface TenantDetails {
-    /** The unique identifier for the tenant */
-    tenantId: string;
+    /** Optional channel for the invocation */
+    channel?: Channel;
+    /** Optional conversation identifier */
+    conversationId?: string;
 }
 /**
  * Details about an AI agent
@@ -73,12 +56,8 @@ export interface TenantDetails {
 export interface AgentDetails {
     /** The unique identifier for the AI agent */
     agentId: string;
-    /** The identifier for the conversation or session */
-    conversationId?: string;
     /** The human-readable name of the AI agent */
     agentName?: string;
-    /** Optional type of the AI agent */
-    agentType?: string;
     /** A description of the AI agent's purpose or capabilities */
     agentDescription?: string;
     /** Optional icon identifier or URL for visual representation of the agent */
@@ -87,14 +66,16 @@ export interface AgentDetails {
     platformId?: string;
     /** The agent user ID (AUID) */
     agentAUID?: string;
-    /** The agent user principal name (UPN) */
-    agentUPN?: string;
+    /** The agent email address */
+    agentEmail?: string;
     /** The agent blueprint/application ID */
     agentBlueprintId?: string;
     /** The tenant ID for the agent */
     tenantId?: string;
-    /** The client IP address for the agent user */
-    agentClientIP?: string;
+    /** The provider name (e.g., az.ai.agent365, openai, anthropic) */
+    providerName?: string;
+    /** The version of the agent (e.g., '1.0.0', '2025-05-01') */
+    agentVersion?: string;
 }
 /**
  * Details of a tool call made by an agent
@@ -102,8 +83,8 @@ export interface AgentDetails {
 export interface ToolCallDetails {
     /** The name of the tool being executed */
     toolName: string;
-    /** Tool arguments/parameters */
-    arguments?: string;
+    /** Tool arguments/parameters. Objects are serialized to JSON automatically. */
+    arguments?: Record<string, unknown> | string;
     /** The unique identifier for the tool call */
     toolCallId?: string;
     /** Optional description of the tool or its purpose */
@@ -114,22 +95,40 @@ export interface ToolCallDetails {
     endpoint?: ServiceEndpoint;
 }
 /**
- * Details about a caller
+ * Details about the human user caller.
  */
-export interface CallerDetails {
+export interface UserDetails {
     /** The unique identifier for the caller */
-    callerId?: string;
-    /** The user principal name (UPN) of the caller */
-    callerUpn?: string;
+    userId?: string;
+    /** The email address of the caller */
+    userEmail?: string;
     /** The display name of the caller */
-    callerName?: string;
-    /** The user ID of the caller */
-    callerUserId?: string;
+    userName?: string;
     /** The tenant ID of the caller */
     tenantId?: string;
     /** The client IP address for the caller */
     callerClientIp?: string;
 }
+/**
+ * Caller details for scope creation.
+ * Supports human callers, agent callers, or both (A2A with a human in the chain).
+ *
+ * **Migration note:** In v1 the name `CallerDetails` referred to human caller
+ * identity (now {@link UserDetails}). In v2 it was repurposed as a wrapper that
+ * groups both human and agent caller information.
+ *
+ * @see {@link UserDetails} — human caller identity (previously `CallerDetails`)
+ * @see CHANGELOG.md — breaking changes section for migration guidance
+ */
+export interface CallerDetails {
+    /** Optional human caller identity */
+    userDetails?: UserDetails;
+    /** Optional calling agent identity for A2A (agent-to-agent) scenarios */
+    callerAgentDetails?: AgentDetails;
+}
+/**
+ * @deprecated Use AgentDetails. EnhancedAgentDetails is now an alias of AgentDetails.
+ */
 export type EnhancedAgentDetails = AgentDetails;
 /**
  * Represents an endpoint for agent invocation
@@ -143,18 +142,14 @@ export interface ServiceEndpoint {
     protocol?: string;
 }
 /**
- * Details for invoking another agent
+ * Details for invoking agent scope.
  */
-export interface InvokeAgentDetails extends AgentDetails {
-    /** The request payload for the agent invocation */
-    request?: AgentRequest;
+export interface InvokeAgentScopeDetails {
     /** The endpoint for the agent invocation */
     endpoint?: ServiceEndpoint;
-    /** Session ID for the invocation */
-    sessionId?: string;
 }
 /**
- * Details for an inference call matching C# implementation
+ * Details for an inference call
  */
 export interface InferenceDetails {
     /** The operation name/type for the inference */
@@ -169,8 +164,10 @@ export interface InferenceDetails {
     outputTokens?: number;
     /** Array of finish reasons */
     finishReasons?: string[];
-    /** Response ID from the model provider */
-    responseId?: string;
+    /** The thought process used by the agent */
+    thoughtProcess?: string;
+    /** The endpoint for the inference call */
+    endpoint?: ServiceEndpoint;
 }
 /**
  * Details for recording the response from an inference call
@@ -187,4 +184,174 @@ export interface InferenceResponse {
     /** Number of output tokens generated */
     outputTokens?: number;
 }
+/**
+ * Represents a response containing output messages from an agent.
+ * Used with OutputScope for output message tracing.
+ * Accepts plain strings, structured OTEL OutputMessage objects, or a raw dict
+ * (treated as a tool call result per OTEL spec).
+ */
+export interface OutputResponse {
+    /** The output messages from the agent */
+    messages: ResponseMessagesParam;
+}
+/**
+ * Span configuration details for scope creation.
+ * Groups OpenTelemetry span options into a single object so the scope
+ * method signature remains stable as new options are added.
+ */
+export interface SpanDetails {
+    /** Optional parent context for cross-async-boundary tracing.
+     *  Accepts a ParentSpanRef (manual traceId/spanId) or an OTel Context
+     *  (e.g. from extractContextFromHeaders). */
+    parentContext?: ParentContext;
+    /** Optional explicit start time (ms epoch, Date, or HrTime). */
+    startTime?: TimeInput;
+    /** Optional explicit end time (ms epoch, Date, or HrTime). */
+    endTime?: TimeInput;
+    /** Optional span kind override. */
+    spanKind?: SpanKind;
+    /** Optional span links to associate with this span. */
+    spanLinks?: Link[];
+}
+/**
+ * Role of a message participant per OTEL gen-ai semantic conventions.
+ */
+export declare enum MessageRole {
+    SYSTEM = "system",
+    USER = "user",
+    ASSISTANT = "assistant",
+    TOOL = "tool"
+}
+/**
+ * Reason a model stopped generating per OTEL gen-ai semantic conventions.
+ */
+export declare enum FinishReason {
+    STOP = "stop",
+    LENGTH = "length",
+    CONTENT_FILTER = "content_filter",
+    TOOL_CALL = "tool_call",
+    ERROR = "error"
+}
+/**
+ * Media modality for blob, file, and URI parts.
+ */
+export declare enum Modality {
+    IMAGE = "image",
+    VIDEO = "video",
+    AUDIO = "audio"
+}
+/** Plain text content. */
+export interface TextPart {
+    type: 'text';
+    content: string;
+}
+/** A tool call requested by the model. */
+export interface ToolCallRequestPart {
+    type: 'tool_call';
+    name: string;
+    id?: string;
+    arguments?: Record<string, unknown> | unknown[];
+}
+/** Result of a tool call. */
+export interface ToolCallResponsePart {
+    type: 'tool_call_response';
+    id?: string;
+    response?: unknown;
+}
+/** Model reasoning / chain-of-thought content. */
+export interface ReasoningPart {
+    type: 'reasoning';
+    content: string;
+}
+/** Inline binary data (base64-encoded). */
+export interface BlobPart {
+    type: 'blob';
+    modality: Modality | string;
+    mime_type?: string;
+    content: string;
+}
+/** Reference to a pre-uploaded file. */
+export interface FilePart {
+    type: 'file';
+    modality: Modality | string;
+    mime_type?: string;
+    file_id: string;
+}
+/** External URI reference. */
+export interface UriPart {
+    type: 'uri';
+    modality: Modality | string;
+    mime_type?: string;
+    uri: string;
+}
+/** Extensible server tool call details with a type discriminator. */
+export interface GenericServerToolCall {
+    type: string;
+    [key: string]: unknown;
+}
+/** Extensible server tool call response with a type discriminator. */
+export interface GenericServerToolCallResponse {
+    type: string;
+    [key: string]: unknown;
+}
+/** Server-side tool invocation. */
+export interface ServerToolCallPart {
+    type: 'server_tool_call';
+    name: string;
+    id?: string;
+    server_tool_call: GenericServerToolCall;
+}
+/** Server-side tool response. */
+export interface ServerToolCallResponsePart {
+    type: 'server_tool_call_response';
+    id?: string;
+    server_tool_call_response: GenericServerToolCallResponse;
+}
+/** Extensible part for custom / future types. */
+export interface GenericPart {
+    type: string;
+    [key: string]: unknown;
+}
+/**
+ * Union of all message part types per OTEL gen-ai semantic conventions.
+ *
+ * Note: {@link GenericPart} acts as a catch-all for forward compatibility with
+ * custom or future part types. Because its `type` is `string` (not a literal),
+ * exhaustive `switch`/`case` on `part.type` will not produce compile-time errors
+ * for unhandled cases.
+ */
+export type MessagePart = TextPart | ToolCallRequestPart | ToolCallResponsePart | ReasoningPart | BlobPart | FilePart | UriPart | ServerToolCallPart | ServerToolCallResponsePart | GenericPart;
+/**
+ * An input message sent to a model (OTEL gen-ai semantic conventions).
+ */
+export interface ChatMessage {
+    role: MessageRole | string;
+    parts: MessagePart[];
+    name?: string;
+}
+export interface InputMessages {
+    version: typeof A365_MESSAGE_SCHEMA_VERSION;
+    messages: ChatMessage[];
+}
+/**
+ * An output message produced by a model (OTEL gen-ai semantic conventions).
+ */
+export interface OutputMessage extends ChatMessage {
+    finish_reason?: FinishReason | string;
+}
+export interface OutputMessages {
+    version: typeof A365_MESSAGE_SCHEMA_VERSION;
+    messages: OutputMessage[];
+}
+export declare const A365_MESSAGE_SCHEMA_VERSION: "0.1.0";
+/** Accepted input for `recordInputMessages`. Supports a single string, an array of strings (backward compat), or the versioned wrapper. */
+export type InputMessagesParam = string | string[] | InputMessages;
+/** Accepted input for `recordOutputMessages`. Supports a single string, an array of strings (backward compat), or the versioned wrapper. */
+export type OutputMessagesParam = string | string[] | OutputMessages;
+/**
+ * Accepted input for `OutputResponse.messages`.
+ * Supports plain strings, structured OutputMessages, or a raw dict (treated as a tool call result
+ * per OTEL spec and serialized directly via JSON.stringify).
+ */
+export type ResponseMessagesParam = OutputMessagesParam | Record<string, unknown>;
 //# sourceMappingURL=contracts.d.ts.map

package/dist/cjs/tracing/contracts.d.ts.map

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

package/dist/cjs/tracing/contracts.js

@@ -1,23 +1,8 @@
 "use strict";
-// ------------------------------------------------------------------------------
-// Copyright (c) Microsoft Corporation. All rights reserved.
-// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InferenceOperationType = exports.InvocationRole = exports.ExecutionType = void 0;
-/**
- * Represents different types of agent invocations
- */
-var ExecutionType;
-(function (ExecutionType) {
-    /** Direct human-to-agent invocation (e.g., through UI, API call) */
-    ExecutionType["HumanToAgent"] = "HumanToAgent";
-    /** Agent-to-agent invocation (e.g., one agent calling another) */
-    ExecutionType["Agent2Agent"] = "Agent2Agent";
-    /** Event-driven agent invocation (e.g., scheduled, webhook, message queue) */
-    ExecutionType["EventToAgent"] = "EventToAgent";
-    /** Unknown or unspecified invocation type */
-    ExecutionType["Unknown"] = "Unknown";
-})(ExecutionType || (exports.ExecutionType = ExecutionType = {}));
+exports.A365_MESSAGE_SCHEMA_VERSION = exports.Modality = exports.FinishReason = exports.MessageRole = exports.InferenceOperationType = exports.InvocationRole = void 0;
 /**
  * Represents different roles that can invoke an agent
  */
@@ -41,4 +26,40 @@ var InferenceOperationType;
     InferenceOperationType["TEXT_COMPLETION"] = "TextCompletion";
     InferenceOperationType["GENERATE_CONTENT"] = "GenerateContent";
 })(InferenceOperationType || (exports.InferenceOperationType = InferenceOperationType = {}));
+// ---------------------------------------------------------------------------
+// OpenTelemetry Semantic Convention – Gen-AI Message Format
+// https://opentelemetry.io/docs/specs/semconv/gen-ai/gen-ai-input-messages.json
+// https://opentelemetry.io/docs/specs/semconv/gen-ai/gen-ai-output-messages.json
+// ---------------------------------------------------------------------------
+/**
+ * Role of a message participant per OTEL gen-ai semantic conventions.
+ */
+var MessageRole;
+(function (MessageRole) {
+    MessageRole["SYSTEM"] = "system";
+    MessageRole["USER"] = "user";
+    MessageRole["ASSISTANT"] = "assistant";
+    MessageRole["TOOL"] = "tool";
+})(MessageRole || (exports.MessageRole = MessageRole = {}));
+/**
+ * Reason a model stopped generating per OTEL gen-ai semantic conventions.
+ */
+var FinishReason;
+(function (FinishReason) {
+    FinishReason["STOP"] = "stop";
+    FinishReason["LENGTH"] = "length";
+    FinishReason["CONTENT_FILTER"] = "content_filter";
+    FinishReason["TOOL_CALL"] = "tool_call";
+    FinishReason["ERROR"] = "error";
+})(FinishReason || (exports.FinishReason = FinishReason = {}));
+/**
+ * Media modality for blob, file, and URI parts.
+ */
+var Modality;
+(function (Modality) {
+    Modality["IMAGE"] = "image";
+    Modality["VIDEO"] = "video";
+    Modality["AUDIO"] = "audio";
+})(Modality || (exports.Modality = Modality = {}));
+exports.A365_MESSAGE_SCHEMA_VERSION = '0.1.0';
 //# sourceMappingURL=contracts.js.map

package/dist/cjs/tracing/contracts.js.map

@@ -1 +1 @@
-{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/tracing/contracts.ts"],"names":[],"mappings":";AAAA,iFAAiF;AACjF,4DAA4D;AAC5D,iFAAiF;;;AAEjF;;GAEG;AACH,IAAY,aAYX;AAZD,WAAY,aAAa;IACvB,oEAAoE;IACpE,8CAA6B,CAAA;IAE7B,kEAAkE;IAClE,4CAA2B,CAAA;IAE3B,8EAA8E;IAC9E,8CAA6B,CAAA;IAE7B,6CAA6C;IAC7C,oCAAmB,CAAA;AACrB,CAAC,EAZW,aAAa,6BAAb,aAAa,QAYxB;AAED;;GAEG;AACH,IAAY,cAYX;AAZD,WAAY,cAAc;IACxB,oCAAoC;IACpC,iCAAe,CAAA;IAEf,wCAAwC;IACxC,iCAAe,CAAA;IAEf,wEAAwE;IACxE,iCAAe,CAAA;IAEf,kCAAkC;IAClC,qCAAmB,CAAA;AACrB,CAAC,EAZW,cAAc,8BAAd,cAAc,QAYzB;AAED;;GAEG;AACH,IAAY,sBAIX;AAJD,WAAY,sBAAsB;IAC9B,uCAAa,CAAA;IACb,4DAAmC,CAAA;IACnC,8DAAqC,CAAA;AACzC,CAAC,EAJW,sBAAsB,sCAAtB,sBAAsB,QAIjC"}
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/tracing/contracts.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;AAMlC;;GAEG;AACH,IAAY,cAYX;AAZD,WAAY,cAAc;IACxB,oCAAoC;IACpC,iCAAe,CAAA;IAEf,wCAAwC;IACxC,iCAAe,CAAA;IAEf,wEAAwE;IACxE,iCAAe,CAAA;IAEf,kCAAkC;IAClC,qCAAmB,CAAA;AACrB,CAAC,EAZW,cAAc,8BAAd,cAAc,QAYzB;AAED;;GAEG;AACH,IAAY,sBAIX;AAJD,WAAY,sBAAsB;IAChC,uCAAa,CAAA;IACb,4DAAkC,CAAA;IAClC,8DAAoC,CAAA;AACtC,CAAC,EAJW,sBAAsB,sCAAtB,sBAAsB,QAIjC;AA4PD,8EAA8E;AAC9E,4DAA4D;AAC5D,gFAAgF;AAChF,iFAAiF;AACjF,8EAA8E;AAE9E;;GAEG;AACH,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,gCAAiB,CAAA;IACjB,4BAAa,CAAA;IACb,sCAAuB,CAAA;IACvB,4BAAa,CAAA;AACf,CAAC,EALW,WAAW,2BAAX,WAAW,QAKtB;AAED;;GAEG;AACH,IAAY,YAMX;AAND,WAAY,YAAY;IACtB,6BAAa,CAAA;IACb,iCAAiB,CAAA;IACjB,iDAAiC,CAAA;IACjC,uCAAuB,CAAA;IACvB,+BAAe,CAAA;AACjB,CAAC,EANW,YAAY,4BAAZ,YAAY,QAMvB;AAED;;GAEG;AACH,IAAY,QAIX;AAJD,WAAY,QAAQ;IAClB,2BAAe,CAAA;IACf,2BAAe,CAAA;IACf,2BAAe,CAAA;AACjB,CAAC,EAJW,QAAQ,wBAAR,QAAQ,QAInB;AAqIY,QAAA,2BAA2B,GAAG,OAAgB,CAAC"}

package/dist/cjs/tracing/exporter/Agent365Exporter.d.ts

@@ -1,22 +1,27 @@
 import { ExportResult } from '@opentelemetry/core';
 import { ReadableSpan, SpanExporter } from '@opentelemetry/sdk-trace-base';
+import { IConfigurationProvider } from '@microsoft/agents-a365-runtime';
+import type { ObservabilityConfiguration } from '../../configuration';
 import { Agent365ExporterOptions } from './Agent365ExporterOptions';
 /**
  * Observability span exporter for Agent365:
  * - Partitions spans by (tenantId, agentId)
  * - Builds OTLP-like JSON: resourceSpans -> scopeSpans -> spans
- * - POSTs per group to https://{endpoint}/maven/agent365/agents/{agentId}/traces?api-version=1
- *   or, when useS2SEndpoint is true, https://{endpoint}/maven/agent365/service/agents/{agentId}/traces?api-version=1
+ * - POSTs per group to https://{endpoint}/observability/tenants/{tenantId}/otlp/agents/{agentId}/traces?api-version=1
+ *   or, when useS2SEndpoint is true, https://{endpoint}/observabilityService/tenants/{tenantId}/otlp/agents/{agentId}/traces?api-version=1
  * - Adds Bearer token via token_resolver(agentId, tenantId)
  */
 export declare class Agent365Exporter implements SpanExporter {
     private closed;
     private readonly options;
+    private readonly configProvider?;
     /**
      * Initialize exporter with a fully constructed options instance.
-     * If tokenResolver is missing, installs cache-backed resolver.
+     * @param options Exporter options controlling batching, timeouts, token acquisition and endpoint shape.
+     * @param configProvider Optional configuration provider. When supplied, the exporter uses it for
+     *        configuration lookups (custom domain, domain override) instead of the default env-based provider.
      */
-    constructor(options: Agent365ExporterOptions);
+    constructor(options: Agent365ExporterOptions, configProvider?: IConfigurationProvider<ObservabilityConfiguration>);
     /**
      * Export spans to Agent365 service
      */

package/dist/cjs/tracing/exporter/Agent365Exporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Agent365Exporter.d.ts","sourceRoot":"","sources":["../../../../src/tracing/exporter/Agent365Exporter.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAoB,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAiB3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAuDpE;;;;;;;GAOG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IACnD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAElD;;;OAGG;gBACS,OAAO,EAAE,uBAAuB;IAW5C;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,cAAc,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAwClG;;OAEG;YACW,WAAW;IA0EzB;;OAEG;YACW,eAAe;IA4C7B;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA4C1B;;OAEG;IACH,OAAO,CAAC,OAAO;IAqFf;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAK/B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAIlC"}
+{"version":3,"file":"Agent365Exporter.d.ts","sourceRoot":"","sources":["../../../../src/tracing/exporter/Agent365Exporter.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAoB,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE3E,OAAO,EAAmB,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACzF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAetE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAuDpE;;;;;;;GAOG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IACnD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAqD;IAErF;;;;;OAKG;gBACS,OAAO,EAAE,uBAAuB,EAAE,cAAc,CAAC,EAAE,sBAAsB,CAAC,0BAA0B,CAAC;IAYjH;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,cAAc,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IA+ClG;;OAEG;YACW,WAAW;IAuEzB;;OAEG;YACW,eAAe;IA8C7B;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA4C1B;;OAEG;IACH,OAAO,CAAC,OAAO;IAqFf;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAK/B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAIlC"}