Add session description baggage support

packages/agents-a365-observability/src/tracing/constants.ts

@@ -42,6 +42,7 @@ export class OpenTelemetryConstants {
   public static readonly GEN_AI_AGENT_ID_KEY = 'gen_ai.agent.id';
   public static readonly GEN_AI_AGENT_NAME_KEY = 'gen_ai.agent.name';
   public static readonly GEN_AI_AGENT_DESCRIPTION_KEY = 'gen_ai.agent.description';
+  public static readonly GEN_AI_SESSION_DESCRIPTION_KEY = 'gen_ai.session.description';
   public static readonly GEN_AI_CONVERSATION_ID_KEY = 'gen_ai.conversation.id';
   public static readonly GEN_AI_CONVERSATION_ITEM_LINK_KEY = 'gen_ai.conversation.item.link';
   public static readonly GEN_AI_TOKEN_TYPE_KEY = 'gen_ai.token.type';

packages/agents-a365-observability/src/tracing/middleware/BaggageBuilder.ts

@@ -149,6 +149,16 @@ export class BaggageBuilder {
     return this;
   }
 
+  /**
+   * Set the session description baggage value.
+   * @param value The session description
+   * @returns Self for method chaining
+   */
+  sessionDescription(value: string | null | undefined): BaggageBuilder {
+    this.set(OpenTelemetryConstants.GEN_AI_SESSION_DESCRIPTION_KEY, value);
+    return this;
+  }
+
   /**
    * Set the caller name baggage value.
    * @param value The caller name
@@ -224,14 +234,14 @@ export class BaggageBuilder {
    * @param pairs Dictionary or iterable of key-value pairs
    * @returns Self for method chaining
    */
-  setPairs(pairs: Record<string, any> | Iterable<[string, any]> | null | undefined): BaggageBuilder {
+  setPairs(pairs: Record<string, unknown> | Iterable<[string, unknown]> | null | undefined): BaggageBuilder {
     if (!pairs) {
       return this;
     }
 
-    let entries: Iterable<[string, any]>;
+    let entries: Iterable<[string, unknown]>;
     if (Symbol.iterator in Object(pairs)) {
-      entries = pairs as Iterable<[string, any]>;
+      entries = pairs as Iterable<[string, unknown]>;
     } else {
       entries = Object.entries(pairs);
     }

packages/agents-a365-observability/src/tracing/processors/util.ts

@@ -19,6 +19,7 @@ export const GENERIC_ATTRIBUTES: readonly string[] = [
   consts.GEN_AI_AGENT_ID_KEY,
   consts.GEN_AI_AGENT_NAME_KEY,
   consts.GEN_AI_AGENT_DESCRIPTION_KEY,
+  consts.GEN_AI_SESSION_DESCRIPTION_KEY,
   consts.GEN_AI_AGENT_USER_ID_KEY,
   consts.GEN_AI_AGENT_UPN_KEY,
   consts.GEN_AI_AGENT_BLUEPRINT_ID_KEY,

tests-agent/basic-agent-sdk-sample/src/agent.ts

@@ -61,6 +61,7 @@ agentApplication.onActivity(
       .agentId(agentInfo.agentId)
       .correlationId("7ff6dca0-917c-4bb0-b31a-794e533d8aad")
       .agentName(agentInfo.agentName)
+      .sessionDescription('Initial onboarding session')
       .conversationId(context.activity.conversation?.id)
       .callerId(context.activity.from?.aadObjectId)
       .callerUpn(context.activity.from?.id)

tests/observability/core/BaggageBuilder.test.ts

@@ -140,9 +140,11 @@ describe('BaggageBuilder', () => {
         .agentId('agent-456')
         .correlationId('corr-789')
         .sessionId('session-0001')
+        .sessionDescription('My session desc')
         .build();
       const bag = propagation.getBaggage((scope as any).contextWithBaggage);
       expect(bag?.getEntry(OpenTelemetryConstants.SESSION_ID_KEY)?.value).toBe('session-0001');
+      expect(bag?.getEntry(OpenTelemetryConstants.GEN_AI_SESSION_DESCRIPTION_KEY)?.value).toBe('My session desc');
     });
 
     it('should omit empty sessionId value', () => {
@@ -152,8 +154,15 @@ describe('BaggageBuilder', () => {
       const bag = propagation.getBaggage((scope as any).contextWithBaggage);
       expect(bag?.getEntry(OpenTelemetryConstants.SESSION_ID_KEY)).toBeUndefined();
     });
-  });
 
+     it('should omit null sessionDescription value', () => {
+      const scope = new BaggageBuilder()
+        .sessionDescription(null)
+        .build();
+      const bag = propagation.getBaggage((scope as any).contextWithBaggage);
+      expect(bag?.getEntry(OpenTelemetryConstants.GEN_AI_SESSION_DESCRIPTION_KEY)).toBeUndefined();
+    });
+  });
 });
 
 describe('BaggageScope', () => {

tests/observability/core/SpanProcessor.test.ts

@@ -68,6 +68,19 @@ describe('SpanProcessor', () => {
       expect(attrs[OpenTelemetryConstants.SESSION_ID_KEY]).toBe('session-abc');
     });
 
+    it('should copy sessionDescription from baggage to span', () => {
+      let baggage = propagation.createBaggage();
+      baggage = baggage.setEntry(OpenTelemetryConstants.GEN_AI_SESSION_DESCRIPTION_KEY, { value: 'Test session description' });
+
+      const ctx = propagation.setBaggage(context.active(), baggage);
+      const tracer = provider.getTracer('test');
+      const testSpan = tracer.startSpan('test-span', { kind: SpanKind.CLIENT }, ctx as any);
+      testSpan.end();
+
+      const attrs = (testSpan as any)._attributes ?? (testSpan as any).attributes ?? {};
+      expect(attrs[OpenTelemetryConstants.GEN_AI_SESSION_DESCRIPTION_KEY]).toBe('Test session description');
+    });
+
     it('should copy invoke agent attributes for invoke_agent operations', () => {
       // Set baggage with invoke agent specific fields
       const baggageEntries = {