@microsoft/opentelemetry 1.0.2 → 1.2.0

package/dist/esm/a365/hosting/types.d.ts

@@ -9,49 +9,95 @@
  */
 /** Minimal activity shape required by hosting observability utilities. */
 export interface ActivityLike {
+    /** The activity type (e.g. `message`, `event`). */
     type?: string;
+    /** The activity name (used for event activities). */
     name?: string;
+    /** The text content of the activity. */
     text?: string;
+    /** Identifier of the channel the activity arrived on. */
     channelId?: string;
+    /** Identifier of the channel sub-channel, when applicable. */
     channelIdSubChannel?: string | unknown;
+    /** Channel-specific payload data. */
+    channelData?: unknown;
+    /** Service URL used to send replies back to the channel. */
     serviceUrl?: string;
+    /** The sender of the activity. */
     from?: {
-        id?: string;
+        /** AAD Object ID of the sender. */
         aadObjectId?: string;
+        /** Display name of the sender. */
         name?: string;
+        /** Role of the sender (e.g. `user`, `bot`). */
         role?: string;
+        /** Tenant identifier of the sender. */
         tenantId?: string;
+        /** Agentic user identifier of the sender. */
         agenticUserId?: string;
+        /** Agentic application blueprint identifier of the sender. */
         agenticAppBlueprintId?: string;
+        /** Agentic application identifier of the sender. */
         agenticAppId?: string;
     };
+    /** The recipient of the activity. */
     recipient?: {
+        /** AAD Object ID of the recipient. */
         aadObjectId?: string;
+        /** Display name of the recipient. */
         name?: string;
+        /** Role of the recipient (e.g. `user`, `bot`). */
         role?: string;
     };
+    /** The conversation the activity belongs to. */
     conversation?: {
+        /** Identifier of the conversation. */
         id?: string;
     };
+    /** Returns whether this activity represents an agentic request. */
     isAgenticRequest?: () => boolean;
+    /** Returns the agentic instance identifier, if any. */
     getAgenticInstanceId?: () => string | undefined;
+    /** Returns the agentic tenant identifier. */
     getAgenticTenantId?: () => string;
+    /** Returns the agentic user identifier. */
     getAgenticUser?: () => string;
 }
 /** Minimal turn context shape required by hosting observability utilities. */
 export interface TurnContextLike {
+    /** The activity being processed for this turn. */
     activity: ActivityLike;
+    /** Per-turn state shared between middleware. */
     turnState: Map<string, unknown>;
+    /** Registers a handler invoked before activities are sent. */
     onSendActivities?(handler: SendActivitiesHandler): void;
 }
-/** Handler for intercepting outgoing activities. */
+/**
+ * Handler for intercepting outgoing activities.
+ *
+ * @param ctx The current turn context.
+ * @param activities The activities about to be sent.
+ * @param sendNext Invokes the next handler in the chain and returns its results.
+ * @returns The results of sending the activities.
+ */
 export type SendActivitiesHandler = (ctx: TurnContextLike, activities: ActivityLike[], sendNext: () => Promise<unknown[]>) => Promise<unknown[]>;
 /** Middleware interface compatible with agents-hosting adapters. */
 export interface MiddlewareLike {
+    /**
+     * Processes a turn and invokes the next middleware.
+     *
+     * @param context The current turn context.
+     * @param next Invokes the next middleware in the pipeline.
+     */
     onTurn(context: TurnContextLike, next: () => Promise<void>): Promise<void>;
 }
 /** Minimal adapter contract for registering hosting middleware. */
 export interface HostingAdapterLike {
+    /**
+     * Registers one or more middleware with the adapter.
+     *
+     * @param middlewares The middleware to register.
+     */
     use(...middlewares: Array<MiddlewareLike>): void;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/esm/a365/hosting/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/a365/hosting/types.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE;QACL,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,SAAS,CAAC,EAAE;QACV,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,YAAY,CAAC,EAAE;QACb,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,CAAC;IACF,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC;IACjC,oBAAoB,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAChD,kBAAkB,CAAC,EAAE,MAAM,MAAM,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,MAAM,CAAC;CAC/B;AAED,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,gBAAgB,CAAC,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACzD;AAED,oDAAoD;AACpD,MAAM,MAAM,qBAAqB,GAAG,CAClC,GAAG,EAAE,eAAe,EACpB,UAAU,EAAE,YAAY,EAAE,EAC1B,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,KAC/B,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;AAExB,oEAAoE;AACpE,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5E;AAED,mEAAmE;AACnE,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,GAAG,WAAW,EAAE,KAAK,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;CAClD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/a365/hosting/types.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,mBAAmB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC,qCAAqC;IACrC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,IAAI,CAAC,EAAE;QACL,mCAAmC;QACnC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,kCAAkC;QAClC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,+CAA+C;QAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,uCAAuC;QACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,6CAA6C;QAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,8DAA8D;QAC9D,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,oDAAoD;QACpD,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,qCAAqC;IACrC,SAAS,CAAC,EAAE;QACV,sCAAsC;QACtC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,qCAAqC;QACrC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,kDAAkD;QAClD,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,gDAAgD;IAChD,YAAY,CAAC,EAAE;QACb,sCAAsC;QACtC,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,CAAC;IACF,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC;IACjC,uDAAuD;IACvD,oBAAoB,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAChD,6CAA6C;IAC7C,kBAAkB,CAAC,EAAE,MAAM,MAAM,CAAC;IAClC,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,MAAM,CAAC;CAC/B;AAED,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,QAAQ,EAAE,YAAY,CAAC;IACvB,gDAAgD;IAChD,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,8DAA8D;IAC9D,gBAAgB,CAAC,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACzD;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAClC,GAAG,EAAE,eAAe,EACpB,UAAU,EAAE,YAAY,EAAE,EAC1B,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,KAC/B,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;AAExB,oEAAoE;AACpE,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5E;AAED,mEAAmE;AACnE,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,GAAG,CAAC,GAAG,WAAW,EAAE,KAAK,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;CAClD"}

package/dist/esm/a365/index.d.ts

@@ -2,17 +2,17 @@ export { A365Configuration, A365_ENV_VARS } from "./configuration/index.js";
 export type { A365Options, ClusterCategory, ILogger } from "./configuration/index.js";
 export { configureA365Logger, getA365Logger } from "./logging.js";
 export { Agent365Exporter } from "./exporter/index.js";
-export type { Agent365ExporterOptions, TokenResolver } from "./exporter/index.js";
+export type { Agent365ExporterOptions, TokenResolver, ContextualTokenResolver, AgentIdentity, TokenResolverContext, } from "./exporter/index.js";
 export { ResolvedExporterOptions } from "./exporter/index.js";
-export { OpenTelemetryScope, InvokeAgentScope, ExecuteToolScope, InferenceScope, OutputScope, } from "./scopes/index.js";
+export { OpenTelemetryScope, InvokeAgentScope, ExecuteToolScope, InferenceScope, OutputScope, ApplyGuardrailScope, } from "./scopes/index.js";
 export { OpenTelemetryConstants } from "./constants.js";
-export { MessageRole, FinishReason, Modality, InvocationRole, InferenceOperationType, A365_MESSAGE_SCHEMA_VERSION, } from "./contracts.js";
-export type { ChatMessage, InputMessages, OutputMessage, OutputMessages, InputMessagesParam, OutputMessagesParam, ResponseMessagesParam, MessagePart, TextPart, ToolCallRequestPart, ToolCallResponsePart, ReasoningPart, AgentDetails, UserDetails, CallerDetails, Request, Channel, ServiceEndpoint, InvokeAgentScopeDetails, ToolCallDetails, InferenceDetails, InferenceResponse, OutputResponse, SpanDetails, ParentSpanRef, ParentContext, } from "./contracts.js";
+export { MessageRole, FinishReason, Modality, InvocationRole, InferenceOperationType, DEFAULT_FINISH_REASON, GuardrailDecisionType, GuardrailRiskSeverity, GuardrailTargetType, } from "./contracts.js";
+export type { ChatMessage, InputMessages, OutputMessage, OutputMessages, InputMessagesParam, OutputMessagesParam, ResponseMessagesParam, MessagePart, TextPart, ToolCallRequestPart, ToolCallResponsePart, ReasoningPart, AgentDetails, UserDetails, CallerDetails, Request, Channel, ServiceEndpoint, InvokeAgentScopeDetails, ToolCallDetails, InferenceDetails, InferenceResponse, OutputResponse, SpanDetails, ParentSpanRef, ParentContext, GuardrailDetails, GuardrailFinding, } from "./contracts.js";
 export { isParentSpanRef, createContextWithParentSpanRef, runWithParentSpanRef, injectContextToHeaders, extractContextFromHeaders, runWithExtractedTraceContext, } from "./context.js";
 export type { HeadersCarrier } from "./context.js";
 export { BaggageBuilder, BaggageScope } from "./middleware/index.js";
 export { A365SpanProcessor, GENERIC_ATTRIBUTES, INVOKE_AGENT_ATTRIBUTES, } from "./processors/index.js";
 export { runWithExportToken, updateExportToken, getExportToken } from "./context/tokenContext.js";
-export { BaggageBuilderUtils, ScopeUtils, getCallerBaggagePairs, getTargetAgentBaggagePairs, getTenantIdPair, getChannelBaggagePairs, getConversationIdAndItemLinkPairs, resolveEmbodiedAgentIds, BaggageMiddleware, OutputLoggingMiddleware, A365_PARENT_SPAN_KEY, A365_AUTH_TOKEN_KEY, ObservabilityHostingManager, AgenticTokenCache, AgenticTokenCacheInstance, configureA365Hosting, } from "./hosting/index.js";
+export { BaggageBuilderUtils, ScopeUtils, getCallerBaggagePairs, getTargetAgentBaggagePairs, getTenantIdPair, getChannelBaggagePairs, getConversationIdAndItemLinkPairs, resolveEmbodiedAgentIds, resolveSubChannel, BaggageMiddleware, OutputLoggingMiddleware, A365_PARENT_SPAN_KEY, A365_AUTH_TOKEN_KEY, ObservabilityHostingManager, AgenticTokenCache, AgenticTokenCacheInstance, configureA365Hosting, } from "./hosting/index.js";
 export type { ObservabilityHostingOptions, AuthorizationLike, AgenticTokenCacheOptions, HostingAdapterLike, TurnContextLike, ActivityLike, MiddlewareLike, SendActivitiesHandler, } from "./hosting/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/a365/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/a365/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC5E,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAEtF,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAG9D,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAGxD,OAAO,EACL,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,WAAW,EACX,aAAa,EACb,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,WAAW,EACX,QAAQ,EACR,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,WAAW,EACX,aAAa,EACb,OAAO,EACP,OAAO,EACP,eAAe,EACf,uBAAuB,EACvB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,aAAa,EACb,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,eAAe,EACf,8BAA8B,EAC9B,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGrE,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGlG,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,qBAAqB,EACrB,0BAA0B,EAC1B,eAAe,EACf,sBAAsB,EACtB,iCAAiC,EACjC,uBAAuB,EACvB,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,2BAA2B,EAC3B,iBAAiB,EACjB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,2BAA2B,EAC3B,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,qBAAqB,GACtB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/a365/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC5E,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAEtF,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EACV,uBAAuB,EACvB,aAAa,EACb,uBAAuB,EACvB,aAAa,EACb,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAG9D,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAGxD,OAAO,EACL,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,WAAW,EACX,aAAa,EACb,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,WAAW,EACX,QAAQ,EACR,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,WAAW,EACX,aAAa,EACb,OAAO,EACP,OAAO,EACP,eAAe,EACf,uBAAuB,EACvB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,eAAe,EACf,8BAA8B,EAC9B,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGrE,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGlG,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,qBAAqB,EACrB,0BAA0B,EAC1B,eAAe,EACf,sBAAsB,EACtB,iCAAiC,EACjC,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,2BAA2B,EAC3B,iBAAiB,EACjB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,2BAA2B,EAC3B,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,qBAAqB,GACtB,MAAM,oBAAoB,CAAC"}

package/dist/esm/a365/index.js

@@ -5,11 +5,11 @@ export { configureA365Logger, getA365Logger } from "./logging.js";
 export { Agent365Exporter } from "./exporter/index.js";
 export { ResolvedExporterOptions } from "./exporter/index.js";
 // ── Scopes (manual telemetry API) ───────────────────────────────────────────
-export { OpenTelemetryScope, InvokeAgentScope, ExecuteToolScope, InferenceScope, OutputScope, } from "./scopes/index.js";
+export { OpenTelemetryScope, InvokeAgentScope, ExecuteToolScope, InferenceScope, OutputScope, ApplyGuardrailScope, } from "./scopes/index.js";
 // ── Constants ───────────────────────────────────────────────────────────────
 export { OpenTelemetryConstants } from "./constants.js";
 // ── Contracts (types & enums) ───────────────────────────────────────────────
-export { MessageRole, FinishReason, Modality, InvocationRole, InferenceOperationType, A365_MESSAGE_SCHEMA_VERSION, } from "./contracts.js";
+export { MessageRole, FinishReason, Modality, InvocationRole, InferenceOperationType, DEFAULT_FINISH_REASON, GuardrailDecisionType, GuardrailRiskSeverity, GuardrailTargetType, } from "./contracts.js";
 // ── Context propagation ─────────────────────────────────────────────────────
 export { isParentSpanRef, createContextWithParentSpanRef, runWithParentSpanRef, injectContextToHeaders, extractContextFromHeaders, runWithExtractedTraceContext, } from "./context.js";
 // ── Middleware (BaggageBuilder) ──────────────────────────────────────────────
@@ -19,5 +19,5 @@ export { A365SpanProcessor, GENERIC_ATTRIBUTES, INVOKE_AGENT_ATTRIBUTES, } from
 // ── Token context ───────────────────────────────────────────────────────────
 export { runWithExportToken, updateExportToken, getExportToken } from "./context/tokenContext.js";
 // ── Hosting utilities ───────────────────────────────────────────────────────
-export { BaggageBuilderUtils, ScopeUtils, getCallerBaggagePairs, getTargetAgentBaggagePairs, getTenantIdPair, getChannelBaggagePairs, getConversationIdAndItemLinkPairs, resolveEmbodiedAgentIds, BaggageMiddleware, OutputLoggingMiddleware, A365_PARENT_SPAN_KEY, A365_AUTH_TOKEN_KEY, ObservabilityHostingManager, AgenticTokenCache, AgenticTokenCacheInstance, configureA365Hosting, } from "./hosting/index.js";
+export { BaggageBuilderUtils, ScopeUtils, getCallerBaggagePairs, getTargetAgentBaggagePairs, getTenantIdPair, getChannelBaggagePairs, getConversationIdAndItemLinkPairs, resolveEmbodiedAgentIds, resolveSubChannel, BaggageMiddleware, OutputLoggingMiddleware, A365_PARENT_SPAN_KEY, A365_AUTH_TOKEN_KEY, ObservabilityHostingManager, AgenticTokenCache, AgenticTokenCacheInstance, configureA365Hosting, } from "./hosting/index.js";
 //# sourceMappingURL=index.js.map

package/dist/esm/a365/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/a365/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG5E,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,+EAA+E;AAC/E,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAE3B,+EAA+E;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAExD,+EAA+E;AAC/E,OAAO,EACL,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC;AA8BxB,+EAA+E;AAC/E,OAAO,EACL,eAAe,EACf,8BAA8B,EAC9B,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,cAAc,CAAC;AAGtB,gFAAgF;AAChF,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErE,+EAA+E;AAC/E,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAE/B,+EAA+E;AAC/E,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAElG,+EAA+E;AAC/E,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,qBAAqB,EACrB,0BAA0B,EAC1B,eAAe,EACf,sBAAsB,EACtB,iCAAiC,EACjC,uBAAuB,EACvB,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,2BAA2B,EAC3B,iBAAiB,EACjB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/a365/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG5E,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAQvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,+EAA+E;AAC/E,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,+EAA+E;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAExD,+EAA+E;AAC/E,OAAO,EACL,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAgCxB,+EAA+E;AAC/E,OAAO,EACL,eAAe,EACf,8BAA8B,EAC9B,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,cAAc,CAAC;AAGtB,gFAAgF;AAChF,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErE,+EAA+E;AAC/E,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAE/B,+EAA+E;AAC/E,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAElG,+EAA+E;AAC/E,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,qBAAqB,EACrB,0BAA0B,EAC1B,eAAe,EACf,sBAAsB,EACtB,iCAAiC,EACjC,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,2BAA2B,EAC3B,iBAAiB,EACjB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC"}

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

@@ -5,28 +5,33 @@
  */
 import type { ChatMessage, OutputMessage, InputMessages, OutputMessages, InputMessagesParam, OutputMessagesParam } from "./contracts.js";
 /**
- * Type guard that returns `true` when the input is a versioned wrapper
+ * Type guard that returns `true` when the input is a structured 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. */
+/**
+ * Converts plain output strings into OTEL output messages.
+ * `finish_reason` defaults to `"stop"` per OTel spec.
+ */
 export declare function toOutputMessages(messages: string[]): OutputMessage[];
 /**
- * Normalizes an `InputMessagesParam` to a versioned `InputMessages` wrapper.
+ * Normalizes an `InputMessagesParam` to an `InputMessages` instance.
  * - `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.
+ * Normalizes an `OutputMessagesParam` to an `OutputMessages` instance.
  * - `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.
+ * Serializes a message wrapper to JSON.
+ *
+ * The output is a plain JSON array per OTel gen-ai semantic conventions: `[{...}, ...]`.
  *
  * The try/catch ensures telemetry recording is non-throwing even when
  * message parts contain non-JSON-serializable values.

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

@@ -1 +1 @@
-{"version":3,"file":"message-utils.d.ts","sourceRoot":"","sources":["../../../src/a365/message-utils.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AAGxB;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,kBAAkB,GAAG,mBAAmB,GAC9C,KAAK,IAAI,aAAa,GAAG,cAAc,CAQzC;AAED,6DAA6D;AAC7D,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAKjE;AAED,+DAA+D;AAC/D,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;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,GAAG,MAAM,CAmBjF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAkBhG"}
+{"version":3,"file":"message-utils.d.ts","sourceRoot":"","sources":["../../../src/a365/message-utils.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AAGxB;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,kBAAkB,GAAG,mBAAmB,GAC9C,KAAK,IAAI,aAAa,GAAG,cAAc,CAQzC;AAED,6DAA6D;AAC7D,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAKjE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,CAMpE;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,CAgBjF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAkBhG"}

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

@@ -1,16 +1,16 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
-import { MessageRole, A365_MESSAGE_SCHEMA_VERSION } from "./contracts.js";
+import { MessageRole, DEFAULT_FINISH_REASON } from "./contracts.js";
 /**
- * Type guard that returns `true` when the input is a versioned wrapper
+ * Type guard that returns `true` when the input is a structured wrapper
  * object (`InputMessages` or `OutputMessages`).
  */
 export function isWrappedMessages(input) {
     return (!Array.isArray(input) &&
         typeof input === "object" &&
         input !== null &&
-        "version" in input &&
-        "messages" in input);
+        "messages" in input &&
+        Array.isArray(input.messages));
 }
 /** Converts plain input strings into OTEL input messages. */
 export function toInputMessages(messages) {
@@ -19,62 +19,65 @@ export function toInputMessages(messages) {
         parts: [{ type: "text", content }],
     }));
 }
-/** Converts plain output strings into OTEL output messages. */
+/**
+ * Converts plain output strings into OTEL output messages.
+ * `finish_reason` defaults to `"stop"` per OTel spec.
+ */
 export function toOutputMessages(messages) {
     return messages.map((content) => ({
         role: MessageRole.ASSISTANT,
         parts: [{ type: "text", content }],
+        finish_reason: DEFAULT_FINISH_REASON,
     }));
 }
 /**
- * Normalizes an `InputMessagesParam` to a versioned `InputMessages` wrapper.
+ * Normalizes an `InputMessagesParam` to an `InputMessages` instance.
  * - `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 { messages: toInputMessages(arr) };
     }
     return param;
 }
 /**
- * Normalizes an `OutputMessagesParam` to a versioned `OutputMessages` wrapper.
+ * Normalizes an `OutputMessagesParam` to an `OutputMessages` instance.
  * - `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 { messages: toOutputMessages(arr) };
     }
     return param;
 }
 /**
- * Serializes a versioned message wrapper to JSON.
+ * Serializes a message wrapper to JSON.
+ *
+ * The output is a plain JSON array per OTel gen-ai semantic conventions: `[{...}, ...]`.
  *
  * The try/catch ensures telemetry recording is non-throwing even when
  * message parts contain non-JSON-serializable values.
  */
 export function serializeMessages(wrapper) {
     try {
-        return JSON.stringify(wrapper);
+        return JSON.stringify(wrapper.messages);
     }
     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"}]`,
-                        },
-                    ],
-                },
-            ],
-        });
+        return JSON.stringify([
+            {
+                role: MessageRole.SYSTEM,
+                parts: [
+                    {
+                        type: "text",
+                        content: `[serialization failed: ${wrapper.messages.length} ${wrapper.messages.length === 1 ? "message" : "messages"}]`,
+                    },
+                ],
+            },
+        ]);
     }
 }
 /**

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

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

package/dist/esm/a365/processors/A365SpanProcessor.d.ts

@@ -20,6 +20,9 @@ export declare class A365SpanProcessor implements BaseSpanProcessor {
     /**
      * Called when a span is started.
      * Copies relevant baggage entries to span attributes.
+     * Only GenAI spans are processed (those with a known `gen_ai.operation.name`
+     * span attribute: invoke_agent, execute_tool, chat, output_messages);
+     * all other spans pass through unmodified.
      */
     onStart(span: Span, parentContext?: Context): void;
     /** Called when a span is ended. */

package/dist/esm/a365/processors/A365SpanProcessor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"A365SpanProcessor.d.ts","sourceRoot":"","sources":["../../../../src/a365/processors/A365SpanProcessor.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EACV,aAAa,IAAI,iBAAiB,EAClC,YAAY,EACb,MAAM,+BAA+B,CAAC;AAIvC;;;;;;GAMG;AACH,qBAAa,iBAAkB,YAAW,iBAAiB;IACzD;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,IAAI;IAyFlD,mCAAmC;IACnC,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAIhC,8BAA8B;IACxB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,iCAAiC;IAC3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC"}
+{"version":3,"file":"A365SpanProcessor.d.ts","sourceRoot":"","sources":["../../../../src/a365/processors/A365SpanProcessor.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EACV,aAAa,IAAI,iBAAiB,EAClC,YAAY,EACb,MAAM,+BAA+B,CAAC;AAKvC;;;;;;GAMG;AACH,qBAAa,iBAAkB,YAAW,iBAAiB;IACzD;;;;;;OAMG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,IAAI;IA8FlD,mCAAmC;IACnC,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAIhC,8BAA8B;IACxB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,iCAAiC;IAC3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC"}

package/dist/esm/a365/processors/A365SpanProcessor.js

@@ -2,6 +2,7 @@
 // Licensed under the MIT License.
 import { propagation } from "@opentelemetry/api";
 import { OpenTelemetryConstants } from "../constants.js";
+import { GEN_AI_OPERATION_NAMES } from "../exporter/utils.js";
 import { GENERIC_ATTRIBUTES, INVOKE_AGENT_ATTRIBUTES } from "./util.js";
 /**
  * Copies relevant baggage entries to span attributes on span start.
@@ -14,6 +15,9 @@ export class A365SpanProcessor {
     /**
      * Called when a span is started.
      * Copies relevant baggage entries to span attributes.
+     * Only GenAI spans are processed (those with a known `gen_ai.operation.name`
+     * span attribute: invoke_agent, execute_tool, chat, output_messages);
+     * all other spans pass through unmodified.
      */
     onStart(span, parentContext) {
         const ctx = parentContext;
@@ -37,6 +41,13 @@ export class A365SpanProcessor {
         if (!baggage) {
             return;
         }
+        // Only process GenAI spans — those with a known gen_ai.operation.name
+        // span attribute (invoke_agent, execute_tool, chat, output_messages).
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const operationNameAttr = span.attributes?.[OpenTelemetryConstants.GEN_AI_OPERATION_NAME_KEY];
+        if (!GEN_AI_OPERATION_NAMES.has(operationNameAttr)) {
+            return;
+        }
         const baggageMap = new Map();
         baggage.getAllEntries().forEach(([key, entry]) => {
             if (entry.value) {
@@ -44,12 +55,9 @@ export class A365SpanProcessor {
             }
         });
         // Determine if this is an invoke_agent operation
-        const operationName = baggageMap.get(OpenTelemetryConstants.GEN_AI_OPERATION_NAME_KEY) ||
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            span.attributes?.[OpenTelemetryConstants.GEN_AI_OPERATION_NAME_KEY];
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const spanName = span.name || "";
-        const isInvokeAgent = operationName === OpenTelemetryConstants.INVOKE_AGENT_OPERATION_NAME ||
+        const isInvokeAgent = operationNameAttr === OpenTelemetryConstants.INVOKE_AGENT_OPERATION_NAME ||
             spanName.startsWith(OpenTelemetryConstants.INVOKE_AGENT_OPERATION_NAME);
         // Build target key set
         const targetKeys = new Set(GENERIC_ATTRIBUTES);

package/dist/esm/a365/processors/A365SpanProcessor.js.map

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

package/dist/esm/a365/scopes/ApplyGuardrailScope.d.ts

@@ -0,0 +1,45 @@
+import { OpenTelemetryScope } from "./OpenTelemetryScope.js";
+import type { GuardrailDetails, GuardrailFinding, AgentDetails, UserDetails, Request, SpanDetails } from "../contracts.js";
+import { GuardrailDecisionType } from "../contracts.js";
+/**
+ * Provides OpenTelemetry tracing scope for security guardrail evaluation operations.
+ *
+ * Describes a security guardian evaluation. Multiple guardian spans MAY exist under a single
+ * operation span if multiple guardians are chained.
+ *
+ * Guardian spans SHOULD be children of the operation span they are protecting
+ * (e.g., inference or execute_tool spans).
+ */
+export declare class ApplyGuardrailScope extends OpenTelemetryScope {
+    /**
+     * Creates and starts a new scope for guardrail evaluation tracing.
+     *
+     * @param details Details of the guardrail evaluation (target, decision, guardian info, policy).
+     * @param agentDetails Information about the agent being guarded.
+     * @param request Optional request details for conversation context.
+     * @param userDetails Optional human user details.
+     * @param spanDetails Optional span configuration (parent context, timing, kind, span links).
+     * @returns A new ApplyGuardrailScope instance.
+     */
+    static start(details: GuardrailDetails, agentDetails: AgentDetails, request?: Request, userDetails?: UserDetails, spanDetails?: SpanDetails): ApplyGuardrailScope;
+    private constructor();
+    /**
+     * Records an updated decision on the guardrail span.
+     * Use this when the guardrail decision is determined after span creation.
+     * @param decisionType The decision type made by the guardian.
+     * @param reason Optional human-readable explanation for the decision.
+     */
+    recordDecision(decisionType: GuardrailDecisionType, reason?: string): void;
+    /**
+     * Records the output content value for the guardrail evaluation (opt-in).
+     * @param outputValue The output content after guardrail processing.
+     */
+    recordContentOutput(outputValue: string): void;
+    /**
+     * Records a security finding event on the current span.
+     * Multiple findings may be recorded per guardrail evaluation.
+     * @param finding The security finding to record.
+     */
+    recordFinding(finding: GuardrailFinding): void;
+}
+//# sourceMappingURL=ApplyGuardrailScope.d.ts.map

package/dist/esm/a365/scopes/ApplyGuardrailScope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApplyGuardrailScope.d.ts","sourceRoot":"","sources":["../../../../src/a365/scopes/ApplyGuardrailScope.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,OAAO,EACP,WAAW,EACZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAExD;;;;;;;;GAQG;AACH,qBAAa,mBAAoB,SAAQ,kBAAkB;IACzD;;;;;;;;;OASG;WACW,KAAK,CACjB,OAAO,EAAE,gBAAgB,EACzB,YAAY,EAAE,YAAY,EAC1B,OAAO,CAAC,EAAE,OAAO,EACjB,WAAW,CAAC,EAAE,WAAW,EACzB,WAAW,CAAC,EAAE,WAAW,GACxB,mBAAmB;IAItB,OAAO;IAmFP;;;;;OAKG;IACI,cAAc,CAAC,YAAY,EAAE,qBAAqB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAKjF;;;OAGG;IACI,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAIrD;;;;OAIG;IACI,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;CAgCtD"}

package/dist/esm/a365/scopes/ApplyGuardrailScope.js

@@ -0,0 +1,128 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { SpanKind } from "@opentelemetry/api";
+import { OpenTelemetryScope } from "./OpenTelemetryScope.js";
+import { OpenTelemetryConstants } from "../constants.js";
+/**
+ * Provides OpenTelemetry tracing scope for security guardrail evaluation operations.
+ *
+ * Describes a security guardian evaluation. Multiple guardian spans MAY exist under a single
+ * operation span if multiple guardians are chained.
+ *
+ * Guardian spans SHOULD be children of the operation span they are protecting
+ * (e.g., inference or execute_tool spans).
+ */
+export class ApplyGuardrailScope extends OpenTelemetryScope {
+    /**
+     * Creates and starts a new scope for guardrail evaluation tracing.
+     *
+     * @param details Details of the guardrail evaluation (target, decision, guardian info, policy).
+     * @param agentDetails Information about the agent being guarded.
+     * @param request Optional request details for conversation context.
+     * @param userDetails Optional human user details.
+     * @param spanDetails Optional span configuration (parent context, timing, kind, span links).
+     * @returns A new ApplyGuardrailScope instance.
+     */
+    static start(details, agentDetails, request, userDetails, spanDetails) {
+        return new ApplyGuardrailScope(details, agentDetails, request, userDetails, spanDetails);
+    }
+    constructor(details, agentDetails, request, userDetails, spanDetails) {
+        // Validate tenantId is present (required for telemetry)
+        if (!agentDetails.tenantId) {
+            throw new Error("ApplyGuardrailScope: tenantId is required on agentDetails");
+        }
+        // Default to INTERNAL; allow caller override via spanDetails
+        const resolvedSpanDetails = { spanKind: SpanKind.INTERNAL, ...spanDetails };
+        const spanName = details.guardianName
+            ? `${OpenTelemetryConstants.APPLY_GUARDRAIL_OPERATION_NAME} ${details.guardianName} ${details.targetType}`
+            : `${OpenTelemetryConstants.APPLY_GUARDRAIL_OPERATION_NAME} ${details.targetType}`;
+        super(OpenTelemetryConstants.APPLY_GUARDRAIL_OPERATION_NAME, spanName, agentDetails, resolvedSpanDetails, userDetails);
+        // Required attributes
+        this.setTagMaybe(OpenTelemetryConstants.SECURITY_DECISION_TYPE_KEY, details.decisionType);
+        this.setTagMaybe(OpenTelemetryConstants.SECURITY_TARGET_TYPE_KEY, details.targetType);
+        // Guardian attributes
+        this.setTagMaybe(OpenTelemetryConstants.GUARDIAN_ID_KEY, details.guardianId);
+        this.setTagMaybe(OpenTelemetryConstants.GUARDIAN_NAME_KEY, details.guardianName);
+        this.setTagMaybe(OpenTelemetryConstants.GUARDIAN_PROVIDER_NAME_KEY, details.guardianProviderName);
+        this.setTagMaybe(OpenTelemetryConstants.GUARDIAN_VERSION_KEY, details.guardianVersion);
+        // Target attributes
+        this.setTagMaybe(OpenTelemetryConstants.SECURITY_TARGET_ID_KEY, details.targetId);
+        // Decision attributes
+        this.setTagMaybe(OpenTelemetryConstants.SECURITY_DECISION_REASON_KEY, details.decisionReason);
+        this.setTagMaybe(OpenTelemetryConstants.SECURITY_DECISION_CODE_KEY, details.decisionCode);
+        // Policy attributes
+        this.setTagMaybe(OpenTelemetryConstants.SECURITY_POLICY_ID_KEY, details.policyId);
+        this.setTagMaybe(OpenTelemetryConstants.SECURITY_POLICY_NAME_KEY, details.policyName);
+        this.setTagMaybe(OpenTelemetryConstants.SECURITY_POLICY_VERSION_KEY, details.policyVersion);
+        // Content attributes
+        this.setTagMaybe(OpenTelemetryConstants.SECURITY_CONTENT_INPUT_HASH_KEY, details.contentInputHash);
+        if (details.contentModified != null) {
+            this.setTagMaybe(OpenTelemetryConstants.SECURITY_CONTENT_MODIFIED_KEY, details.contentModified);
+        }
+        // Correlation attributes
+        this.setTagMaybe(OpenTelemetryConstants.SECURITY_EXTERNAL_EVENT_ID_KEY, details.externalEventId);
+        // Request context
+        if (request) {
+            if (typeof request.content === "string") {
+                this.setTagMaybe(OpenTelemetryConstants.SECURITY_CONTENT_INPUT_VALUE_KEY, request.content);
+            }
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_CONVERSATION_ID_KEY, request.conversationId);
+            if (request.channel) {
+                this.setTagMaybe(OpenTelemetryConstants.CHANNEL_NAME_KEY, request.channel.name);
+                this.setTagMaybe(OpenTelemetryConstants.CHANNEL_LINK_KEY, request.channel.description);
+            }
+        }
+    }
+    /**
+     * Records an updated decision on the guardrail span.
+     * Use this when the guardrail decision is determined after span creation.
+     * @param decisionType The decision type made by the guardian.
+     * @param reason Optional human-readable explanation for the decision.
+     */
+    recordDecision(decisionType, reason) {
+        this.setTagMaybe(OpenTelemetryConstants.SECURITY_DECISION_TYPE_KEY, decisionType);
+        this.setTagMaybe(OpenTelemetryConstants.SECURITY_DECISION_REASON_KEY, reason);
+    }
+    /**
+     * Records the output content value for the guardrail evaluation (opt-in).
+     * @param outputValue The output content after guardrail processing.
+     */
+    recordContentOutput(outputValue) {
+        this.setTagMaybe(OpenTelemetryConstants.SECURITY_CONTENT_OUTPUT_VALUE_KEY, outputValue);
+    }
+    /**
+     * Records a security finding event on the current span.
+     * Multiple findings may be recorded per guardrail evaluation.
+     * @param finding The security finding to record.
+     */
+    recordFinding(finding) {
+        if (!finding) {
+            throw new Error("ApplyGuardrailScope.recordFinding: finding is required");
+        }
+        const attributes = {
+            [OpenTelemetryConstants.SECURITY_RISK_CATEGORY_KEY]: finding.riskCategory,
+            [OpenTelemetryConstants.SECURITY_RISK_SEVERITY_KEY]: finding.riskSeverity,
+        };
+        if (finding.policyDecisionType != null) {
+            attributes[OpenTelemetryConstants.SECURITY_POLICY_DECISION_TYPE_KEY] =
+                finding.policyDecisionType;
+        }
+        if (finding.policyId != null) {
+            attributes[OpenTelemetryConstants.SECURITY_POLICY_ID_KEY] = finding.policyId;
+        }
+        if (finding.policyName != null) {
+            attributes[OpenTelemetryConstants.SECURITY_POLICY_NAME_KEY] = finding.policyName;
+        }
+        if (finding.policyVersion != null) {
+            attributes[OpenTelemetryConstants.SECURITY_POLICY_VERSION_KEY] = finding.policyVersion;
+        }
+        if (finding.riskScore != null) {
+            attributes[OpenTelemetryConstants.SECURITY_RISK_SCORE_KEY] = finding.riskScore;
+        }
+        if (finding.riskMetadata != null) {
+            attributes[OpenTelemetryConstants.SECURITY_RISK_METADATA_KEY] = finding.riskMetadata;
+        }
+        this.addEvent(OpenTelemetryConstants.SECURITY_FINDING_EVENT_NAME, attributes);
+    }
+}
+//# sourceMappingURL=ApplyGuardrailScope.js.map

package/dist/esm/a365/scopes/ApplyGuardrailScope.js.map

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