@microsoft/agents-a365-observability 0.1.0-preview.123 → 0.1.0-preview.124

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

@@ -1,7 +1,5 @@
-import { TimeInput } from '@opentelemetry/api';
 import { OpenTelemetryScope } from './OpenTelemetryScope';
-import { AgentDetails, TenantDetails, CallerDetails, OutputResponse, Channel } from '../contracts';
-import { ParentContext } from '../context/trace-context-propagation';
+import { AgentDetails, UserDetails, OutputResponse, Request, SpanDetails } from '../contracts';
 /**
  * Provides OpenTelemetry tracing scope for output message tracing with parent span linking.
  */
@@ -10,19 +8,15 @@ export declare class OutputScope extends OpenTelemetryScope {
     private _outputMessagesDirty;
     /**
      * Creates and starts a new scope for output message tracing.
+     *
+     * @param request Request payload (channel, conversationId, content, sessionId).
      * @param response The response containing initial output messages.
-     * @param agentDetails The details of the agent producing the output.
-     * @param tenantDetails The tenant details.
-     * @param callerDetails Optional caller identity details (id, upn, name, client ip).
-     * @param conversationId Optional conversation identifier.
-     * @param channel Optional channel metadata; only `name` and `description` are used for tagging.
-     * @param parentContext Optional parent context for cross-async-boundary tracing.
-     *   Accepts a ParentSpanRef (manual traceId/spanId) or an OTel Context (e.g. from extractTraceContext).
-     * @param startTime Optional explicit start time (ms epoch, Date, or HrTime).
-     * @param endTime Optional explicit end time (ms epoch, Date, or HrTime).
+     * @param agentDetails The agent producing the output. Tenant ID is derived from `agentDetails.tenantId`.
+     * @param userDetails Optional human caller identity details.
+     * @param spanDetails Optional span configuration (parentContext, startTime, endTime).
      * @returns A new OutputScope instance.
      */
-    static start(response: OutputResponse, agentDetails: AgentDetails, tenantDetails: TenantDetails, callerDetails?: CallerDetails, conversationId?: string, channel?: Pick<Channel, "name" | "description">, parentContext?: ParentContext, startTime?: TimeInput, endTime?: TimeInput): OutputScope;
+    static start(request: Request, response: OutputResponse, agentDetails: AgentDetails, userDetails?: UserDetails, spanDetails?: SpanDetails): OutputScope;
     private constructor();
     /**
      * Records the output messages for telemetry tracking.

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

@@ -1 +1 @@
-{"version":3,"file":"OutputScope.d.ts","sourceRoot":"","sources":["../../../../src/tracing/scopes/OutputScope.ts"],"names":[],"mappings":"AAGA,OAAO,EAAY,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACnG,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAGrE;;GAEG;AACH,qBAAa,WAAY,SAAQ,kBAAkB;IACjD,OAAO,CAAC,eAAe,CAAW;IAClC,OAAO,CAAC,oBAAoB,CAAS;IAErC;;;;;;;;;;;;;OAaG;WACW,KAAK,CACjB,QAAQ,EAAE,cAAc,EACxB,YAAY,EAAE,YAAY,EAC1B,aAAa,EAAE,aAAa,EAC5B,aAAa,CAAC,EAAE,aAAa,EAC7B,cAAc,CAAC,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAAC,EAC/C,aAAa,CAAC,EAAE,aAAa,EAC7B,SAAS,CAAC,EAAE,SAAS,EACrB,OAAO,CAAC,EAAE,SAAS,GAClB,WAAW;IAId,OAAO;IAyCP;;;;;OAKG;IACI,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAKrC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;IAUxB,OAAO,IAAI,IAAI;CAGhC"}
+{"version":3,"file":"OutputScope.d.ts","sourceRoot":"","sources":["../../../../src/tracing/scopes/OutputScope.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG/F;;GAEG;AACH,qBAAa,WAAY,SAAQ,kBAAkB;IACjD,OAAO,CAAC,eAAe,CAAW;IAClC,OAAO,CAAC,oBAAoB,CAAS;IAErC;;;;;;;;;OASG;WACW,KAAK,CACjB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,cAAc,EACxB,YAAY,EAAE,YAAY,EAC1B,WAAW,CAAC,EAAE,WAAW,EACzB,WAAW,CAAC,EAAE,WAAW,GACxB,WAAW;IAId,OAAO;IAyCP;;;;;OAKG;IACI,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAKrC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;IAUxB,OAAO,IAAI,IAAI;CAGhC"}

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

@@ -9,34 +9,34 @@ import { OpenTelemetryConstants } from '../constants';
 export class OutputScope extends OpenTelemetryScope {
     /**
      * Creates and starts a new scope for output message tracing.
+     *
+     * @param request Request payload (channel, conversationId, content, sessionId).
      * @param response The response containing initial output messages.
-     * @param agentDetails The details of the agent producing the output.
-     * @param tenantDetails The tenant details.
-     * @param callerDetails Optional caller identity details (id, upn, name, client ip).
-     * @param conversationId Optional conversation identifier.
-     * @param channel Optional channel metadata; only `name` and `description` are used for tagging.
-     * @param parentContext Optional parent context for cross-async-boundary tracing.
-     *   Accepts a ParentSpanRef (manual traceId/spanId) or an OTel Context (e.g. from extractTraceContext).
-     * @param startTime Optional explicit start time (ms epoch, Date, or HrTime).
-     * @param endTime Optional explicit end time (ms epoch, Date, or HrTime).
+     * @param agentDetails The agent producing the output. Tenant ID is derived from `agentDetails.tenantId`.
+     * @param userDetails Optional human caller identity details.
+     * @param spanDetails Optional span configuration (parentContext, startTime, endTime).
      * @returns A new OutputScope instance.
      */
-    static start(response, agentDetails, tenantDetails, callerDetails, conversationId, channel, parentContext, startTime, endTime) {
-        return new OutputScope(response, agentDetails, tenantDetails, callerDetails, conversationId, channel, parentContext, startTime, endTime);
+    static start(request, response, agentDetails, userDetails, spanDetails) {
+        return new OutputScope(request, response, agentDetails, userDetails, spanDetails);
     }
-    constructor(response, agentDetails, tenantDetails, callerDetails, conversationId, channel, parentContext, startTime, endTime) {
+    constructor(request, response, agentDetails, userDetails, spanDetails) {
+        // Validate tenantId is present (required for telemetry)
+        if (!agentDetails.tenantId) {
+            throw new Error('OutputScope: tenantId is required on agentDetails');
+        }
         super(SpanKind.CLIENT, OpenTelemetryConstants.OUTPUT_MESSAGES_OPERATION_NAME, agentDetails.agentName
             ? `${OpenTelemetryConstants.OUTPUT_MESSAGES_OPERATION_NAME} ${agentDetails.agentName}`
-            : `${OpenTelemetryConstants.OUTPUT_MESSAGES_OPERATION_NAME} ${agentDetails.agentId}`, agentDetails, tenantDetails, parentContext, startTime, endTime, callerDetails);
+            : `${OpenTelemetryConstants.OUTPUT_MESSAGES_OPERATION_NAME} ${agentDetails.agentId}`, agentDetails, spanDetails?.parentContext, spanDetails?.startTime, spanDetails?.endTime, userDetails);
         this._outputMessagesDirty = false;
         // Initialize accumulated messages list from the response
         this._outputMessages = [...response.messages];
         // Set initial output messages attribute
         this.setTagMaybe(OpenTelemetryConstants.GEN_AI_OUTPUT_MESSAGES_KEY, JSON.stringify(this._outputMessages));
         // Set conversation and channel
-        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_CONVERSATION_ID_KEY, conversationId);
-        this.setTagMaybe(OpenTelemetryConstants.CHANNEL_NAME_KEY, channel?.name);
-        this.setTagMaybe(OpenTelemetryConstants.CHANNEL_LINK_KEY, channel?.description);
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_CONVERSATION_ID_KEY, request.conversationId);
+        this.setTagMaybe(OpenTelemetryConstants.CHANNEL_NAME_KEY, request.channel?.name);
+        this.setTagMaybe(OpenTelemetryConstants.CHANNEL_LINK_KEY, request.channel?.description);
     }
     /**
      * Records the output messages for telemetry tracking.

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

@@ -1 +1 @@
-{"version":3,"file":"OutputScope.js","sourceRoot":"","sources":["../../../../src/tracing/scopes/OutputScope.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAAE,QAAQ,EAAa,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEtD;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,kBAAkB;IAIjD;;;;;;;;;;;;;OAaG;IACI,MAAM,CAAC,KAAK,CACjB,QAAwB,EACxB,YAA0B,EAC1B,aAA4B,EAC5B,aAA6B,EAC7B,cAAuB,EACvB,OAA+C,EAC/C,aAA6B,EAC7B,SAAqB,EACrB,OAAmB;QAEnB,OAAO,IAAI,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAC3I,CAAC;IAED,YACE,QAAwB,EACxB,YAA0B,EAC1B,aAA4B,EAC5B,aAA6B,EAC7B,cAAuB,EACvB,OAA+C,EAC/C,aAA6B,EAC7B,SAAqB,EACrB,OAAmB;QAEnB,KAAK,CACH,QAAQ,CAAC,MAAM,EACf,sBAAsB,CAAC,8BAA8B,EACrD,YAAY,CAAC,SAAS;YACpB,CAAC,CAAC,GAAG,sBAAsB,CAAC,8BAA8B,IAAI,YAAY,CAAC,SAAS,EAAE;YACtF,CAAC,CAAC,GAAG,sBAAsB,CAAC,8BAA8B,IAAI,YAAY,CAAC,OAAO,EAAE,EACtF,YAAY,EACZ,aAAa,EACb,aAAa,EACb,SAAS,EACT,OAAO,EACP,aAAa,CACd,CAAC;QArDI,yBAAoB,GAAG,KAAK,CAAC;QAuDnC,yDAAyD;QACzD,IAAI,CAAC,eAAe,GAAG,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAE9C,wCAAwC;QACxC,IAAI,CAAC,WAAW,CACd,sBAAsB,CAAC,0BAA0B,EACjD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,eAAe,CAAC,CACrC,CAAC;QAEF,+BAA+B;QAC/B,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,0BAA0B,EAAE,cAAc,CAAC,CAAC;QACpF,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,gBAAgB,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACzE,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,gBAAgB,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IAElF,CAAC;IAED;;;;;OAKG;IACI,oBAAoB,CAAC,QAAkB;QAC5C,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;QACvC,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC;IACnC,CAAC;IAEe,CAAC,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC9B,IAAI,CAAC,WAAW,CACd,sBAAsB,CAAC,0BAA0B,EACjD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,eAAe,CAAC,CACrC,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1B,CAAC;IAEe,OAAO;QACrB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;IACzB,CAAC;CACF"}
+{"version":3,"file":"OutputScope.js","sourceRoot":"","sources":["../../../../src/tracing/scopes/OutputScope.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,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,WAAY,SAAQ,kBAAkB;IAIjD;;;;;;;;;OASG;IACI,MAAM,CAAC,KAAK,CACjB,OAAgB,EAChB,QAAwB,EACxB,YAA0B,EAC1B,WAAyB,EACzB,WAAyB;QAEzB,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;IACpF,CAAC;IAED,YACE,OAAgB,EAChB,QAAwB,EACxB,YAA0B,EAC1B,WAAyB,EACzB,WAAyB;QAEzB,wDAAwD;QACxD,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QAED,KAAK,CACH,QAAQ,CAAC,MAAM,EACf,sBAAsB,CAAC,8BAA8B,EACrD,YAAY,CAAC,SAAS;YACpB,CAAC,CAAC,GAAG,sBAAsB,CAAC,8BAA8B,IAAI,YAAY,CAAC,SAAS,EAAE;YACtF,CAAC,CAAC,GAAG,sBAAsB,CAAC,8BAA8B,IAAI,YAAY,CAAC,OAAO,EAAE,EACtF,YAAY,EACZ,WAAW,EAAE,aAAa,EAC1B,WAAW,EAAE,SAAS,EACtB,WAAW,EAAE,OAAO,EACpB,WAAW,CACZ,CAAC;QA7CI,yBAAoB,GAAG,KAAK,CAAC;QA+CnC,yDAAyD;QACzD,IAAI,CAAC,eAAe,GAAG,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAE9C,wCAAwC;QACxC,IAAI,CAAC,WAAW,CACd,sBAAsB,CAAC,0BAA0B,EACjD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,eAAe,CAAC,CACrC,CAAC;QAEF,+BAA+B;QAC/B,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,0BAA0B,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;QAC5F,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,gBAAgB,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACjF,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,gBAAgB,EAAE,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAE1F,CAAC;IAED;;;;;OAKG;IACI,oBAAoB,CAAC,QAAkB;QAC5C,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;QACvC,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC;IACnC,CAAC;IAEe,CAAC,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC9B,IAAI,CAAC,WAAW,CACd,sBAAsB,CAAC,0BAA0B,EACjD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,eAAe,CAAC,CACrC,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1B,CAAC;IAEe,OAAO;QACrB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;IACzB,CAAC;CACF"}

package/dist/esm/version.d.ts

@@ -1,2 +1,2 @@
-export declare const LIB_VERSION = "0.1.0-preview.123";
+export declare const LIB_VERSION = "0.1.0-preview.124";
 //# sourceMappingURL=version.d.ts.map

package/dist/esm/version.js

@@ -1,2 +1,2 @@
-export const LIB_VERSION = "0.1.0-preview.123";
+export const LIB_VERSION = "0.1.0-preview.124";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@microsoft/agents-a365-observability",
-  "version": "0.1.0-preview.123",
+  "version": "0.1.0-preview.124",
   "description": "OpenTelemetry tracing and monitoring SDK for AI agents built with TypeScript/Node.js",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -23,7 +23,7 @@
     "directory": "packages/agents-a365-observability"
   },
   "dependencies": {
-    "@microsoft/agents-a365-runtime": "0.1.0-preview.123",
+    "@microsoft/agents-a365-runtime": "0.1.0-preview.124",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/exporter-trace-otlp-http": "^0.213.0",
     "@opentelemetry/instrumentation": "^0.213.0",