Support new telemetry schema attribute names

[fpfp100]

Summary

• Implement A365 telemetry schema attribute name migration (new schema is now the default, env var gate removed)
• Rename gen_ai.* attributes to microsoft.* namespace
• Remove gen_ai.system constant; replace with gen_ai.provider.name
• Move gen_ai.provider.name out of base scope — set dynamically in InvokeAgentScope (from AgentDetails.providerName) and InferenceScope (from InferenceDetails.providerName)
• Add providerName field to AgentDetails interface
• Remove gen_ai.agent.type, gen_ai.execution.type, correlation.id, hiring.manager.id, gen_ai.caller.tenantid
• Remove gen_ai.caller.agent.tenantid, microsoft.a365.caller.agent.type, gen_ai.caller.agent.user.client.ip
• Remove operation.duration from span attributes
• Remove gen_ai.response.id from SDK
• Rename gen_ai.event.content to gen_ai.tool.call.result, remove duplicate GEN_AI_EVENT_CONTENT constant
• Rename gen_ai.caller.agent.upn to microsoft.a365.caller.agent.user.upn
• Fix microsoft.a365.agent.user.id to microsoft.agent.user.id
• Fix microsoft.agent.blueprint.id to microsoft.a365.agent.blueprint.id
• Move microsoft.a365.agent.blueprint.id to base scope (common across all span types per schema)
• Remove gen_ai.execution.sourceMetadata.id
• Replace operation.source with telemetry.sdk.* attributes
• Add gen_ai.agent.thought.process support on InferenceScope
• Add server.address/server.port support on InferenceScope
• Add CallerDetails to base scope class (matching .NET SDK pattern)
• Add caller agent attribute renames for A2A dimensions
• Derive TELEMETRY_SDK_VERSION_VALUE from package.json version
• Gitignore generated version.ts (matching runtime package pattern)
• Fix attribute type mismatches: emit gen_ai.usage.input_tokens/output_tokens as int, gen_ai.response.finish_reasons as string[], server.port as string

Test plan

• All 1049 tests pass
• Build succeeds for all SDK packages
• Verified POST body output for all three scope types via capture-post-body sample
• POST body validated against A365 Observability Schema — no missing attributes, no type mismatches

Generated POST Body

Full POST body captured from SDK export (click to expand)

{
  "resourceSpans": [
    {
      "resource": {
        "attributes": {
          "host.name": "pefan4-0",
          "host.arch": "amd64",
          "host.id": "3dc679db-f652-4002-98b7-5e05e5071507",
          "process.pid": 29332,
          "process.runtime.version": "20.18.3",
          "process.runtime.name": "nodejs",
          "process.runtime.description": "Node.js",
          "process.owner": "pefan",
          "service.name": "TypeScript Sample Agent-1.0.0"
        }
      },
      "scopeSpans": [
        {
          "scope": {
            "name": "Agent365Sdk"
          },
          "spans": [
            {
              "traceId": "74ddd591d5b1558b6929b790856f6873",
              "spanId": "d8dae84064b39ebd",
              "name": "invoke_agent ComplianceAssistant",
              "kind": "CLIENT",
              "attributes": {
                "gen_ai.operation.name": "invoke_agent",
                "gen_ai.provider.name": "openai",
                "telemetry.sdk.name": "A365ObservabilitySDK",
                "telemetry.sdk.language": "nodejs",
                "telemetry.sdk.version": "0.0.0-placeholder",
                "microsoft.tenant.id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
                "microsoft.session.id": "session-abc-123",
                "gen_ai.conversation.id": "conv-001-xyz",
                "microsoft.conversation.item.link": "https://teams.microsoft.com/l/message/conv-001-xyz/msg-42",
                "gen_ai.agent.id": "30ed5699-b157-4e87-bb45-9b0cfb13b8e5",
                "gen_ai.agent.name": "ComplianceAssistant",
                "gen_ai.agent.description": "Helps with compliance queries and policy documents",
                "microsoft.session.description": "Initial onboarding session",
                "microsoft.agent.user.upn": "compliance-agent@contoso.com",
                "microsoft.agent.user.id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
                "microsoft.a365.agent.platform.id": "platform-agent-001",
                "service.name": "TypeScript Sample Agent",
                "microsoft.caller.id": "c8a7b6d5-e4f3-2110-9876-543210fedcba",
                "microsoft.caller.name": "Jane Smith",
                "microsoft.caller.upn": "jane.smith@contoso.com",
                "client.address": "10.0.0.42",
                "microsoft.channel.name": "msteams",
                "microsoft.channel.link": "https://teams.microsoft.com/l/channel/general",
                "microsoft.a365.caller.agent.platform.id": "caller-platform-001",
                "microsoft.a365.agent.blueprint.id": "bp-9f8e7d6c-5b4a-3210-fedc-ba0987654321",
                "server.address": "agent365.contoso.com",
                "server.port": "8443",
                "microsoft.a365.caller.agent.name": "OrchestratorAgent",
                "microsoft.a365.caller.agent.id": "caller-agent-1a2b3c4d",
                "microsoft.a365.caller.agent.blueprint.id": "bp-caller-0001",
                "microsoft.a365.caller.agent.user.id": "a1234567-b890-cdef-1234-567890abcdef",
                "microsoft.a365.caller.agent.user.upn": "orchestrator@contoso.com",
                "gen_ai.input.messages": "What are the data retention policies for GDPR compliance?",
                "gen_ai.output.messages": "Based on GDPR Article 5(1)(e)..."
              },
              "status": { "code": "UNSET", "message": "" }
            },
            {
              "traceId": "74ddd591d5b1558b6929b790856f6873",
              "spanId": "2d4fcf82d15dc2f2",
              "parentSpanId": "d8dae84064b39ebd",
              "name": "Chat gpt-4o",
              "kind": "CLIENT",
              "attributes": {
                "gen_ai.operation.name": "Chat",
                "gen_ai.provider.name": "openai",
                "telemetry.sdk.name": "A365ObservabilitySDK",
                "telemetry.sdk.language": "nodejs",
                "telemetry.sdk.version": "0.0.0-placeholder",
                "microsoft.tenant.id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
                "microsoft.session.id": "session-abc-123",
                "gen_ai.conversation.id": "conv-001-xyz",
                "microsoft.conversation.item.link": "https://teams.microsoft.com/l/message/conv-001-xyz/msg-42",
                "gen_ai.agent.id": "30ed5699-b157-4e87-bb45-9b0cfb13b8e5",
                "gen_ai.agent.name": "ComplianceAssistant",
                "gen_ai.agent.description": "Helps with compliance queries and policy documents",
                "microsoft.session.description": "Initial onboarding session",
                "microsoft.agent.user.upn": "compliance-agent@contoso.com",
                "microsoft.agent.user.id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
                "microsoft.a365.agent.platform.id": "platform-agent-001",
                "service.name": "TypeScript Sample Agent",
                "microsoft.caller.id": "c8a7b6d5-e4f3-2110-9876-543210fedcba",
                "microsoft.caller.name": "Jane Smith",
                "microsoft.caller.upn": "jane.smith@contoso.com",
                "client.address": "10.0.0.42",
                "microsoft.channel.name": "msteams",
                "microsoft.channel.link": "https://teams.microsoft.com/l/channel/general",
                "microsoft.a365.agent.blueprint.id": "bp-9f8e7d6c-5b4a-3210-fedc-ba0987654321",
                "gen_ai.request.model": "gpt-4o",
                "gen_ai.usage.input_tokens": 152,
                "gen_ai.usage.output_tokens": 287,
                "gen_ai.response.finish_reasons": ["stop"],
                "microsoft.a365.agent.thought.process": "Analyzing GDPR data retention query...",
                "server.address": "api.openai.com",
                "server.port": "8080",
                "gen_ai.input.messages": "System: You are a compliance assistant.\nUser: What are the data retention policies for GDPR compliance?",
                "gen_ai.output.messages": "Based on GDPR Article 5(1)(e)..."
              },
              "status": { "code": "UNSET", "message": "" }
            },
            {
              "traceId": "74ddd591d5b1558b6929b790856f6873",
              "spanId": "789b0f09a411741b",
              "parentSpanId": "d8dae84064b39ebd",
              "name": "execute_tool search-policy-documents",
              "kind": "INTERNAL",
              "attributes": {
                "gen_ai.operation.name": "execute_tool",
                "telemetry.sdk.name": "A365ObservabilitySDK",
                "telemetry.sdk.language": "nodejs",
                "telemetry.sdk.version": "0.0.0-placeholder",
                "microsoft.tenant.id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
                "microsoft.session.id": "session-abc-123",
                "gen_ai.conversation.id": "conv-001-xyz",
                "microsoft.conversation.item.link": "https://teams.microsoft.com/l/message/conv-001-xyz/msg-42",
                "gen_ai.agent.id": "30ed5699-b157-4e87-bb45-9b0cfb13b8e5",
                "gen_ai.agent.name": "ComplianceAssistant",
                "gen_ai.agent.description": "Helps with compliance queries and policy documents",
                "microsoft.session.description": "Initial onboarding session",
                "microsoft.agent.user.upn": "compliance-agent@contoso.com",
                "microsoft.agent.user.id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
                "microsoft.a365.agent.platform.id": "platform-agent-001",
                "service.name": "TypeScript Sample Agent",
                "microsoft.caller.id": "c8a7b6d5-e4f3-2110-9876-543210fedcba",
                "microsoft.caller.name": "Jane Smith",
                "microsoft.caller.upn": "jane.smith@contoso.com",
                "client.address": "10.0.0.42",
                "microsoft.channel.name": "msteams",
                "microsoft.channel.link": "https://teams.microsoft.com/l/channel/general",
                "microsoft.a365.agent.blueprint.id": "bp-9f8e7d6c-5b4a-3210-fedc-ba0987654321",
                "gen_ai.tool.name": "search-policy-documents",
                "gen_ai.tool.call.arguments": "{\"query\":\"GDPR data retention\",...}",
                "gen_ai.tool.type": "function",
                "gen_ai.tool.call.id": "call_abc123",
                "gen_ai.tool.description": "Searches internal policy document repository...",
                "server.address": "policy-search.contoso.com",
                "server.port": "8080",
                "gen_ai.tool.call.result": "{\"results\":[...]}"
              },
              "status": { "code": "UNSET", "message": "" }
            }
          ]
        }
      ]
    }
  ]
}

🤖 Generated with Claude Code

[Copilot]

Pull request overview

This PR adds support for a new telemetry attribute schema (gated behind A365_USE_NEW_TELEMETRY_SCHEMA) in the observability SDK by renaming/selectively emitting span/baggage attributes and introducing caller metadata propagation into base scopes.

Changes:

• Add CallerDetails support in OpenTelemetryScope and plumb it through ExecuteToolScope, InferenceScope, and InvokeAgentScope.
• Gate/adjust exported attributes for the new schema (e.g., removing some legacy dimensions; switching to telemetry.sdk.* attributes).
• Extend inference telemetry with thoughtProcess and add/expand unit tests around caller tagging.

Reviewed changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
tests/observability/core/scopes.test.ts	Adds assertions that caller tags are applied for ExecuteTool/Inference scopes.
packages/agents-a365-observability/src/tracing/scopes/OpenTelemetryScope.ts	Adds callerDetails param and applies caller tags in the base scope.
packages/agents-a365-observability/src/tracing/scopes/InvokeAgentScope.ts	Routes callerDetails into base scope; handles InvokeAgent-only attrs in new schema.
packages/agents-a365-observability/src/tracing/scopes/InferenceScope.ts	Plumbs callerDetails; adds gen_ai.agent.thought.process tagging.
packages/agents-a365-observability/src/tracing/scopes/ExecuteToolScope.ts	Plumbs callerDetails into scope creation.
packages/agents-a365-observability/src/tracing/processors/util.ts	Gates which baggage keys are copied into span attrs depending on schema.
packages/agents-a365-observability/src/tracing/processors/SpanProcessor.ts	Switches from operation.source to telemetry.sdk.* attributes under new schema.
packages/agents-a365-observability/src/tracing/middleware/BaggageBuilder.ts	Stops emitting correlation/hiring-manager baggage keys in new schema.
packages/agents-a365-observability/src/tracing/contracts.ts	Adds InferenceDetails.thoughtProcess.
packages/agents-a365-observability/src/tracing/constants.ts	Introduces schema flag and conditional key renames/new constants.

[Copilot]

Pull request overview

Copilot reviewed 13 out of 13 changed files in this pull request and generated 1 comment.

[Copilot]

Pull request overview

Copilot reviewed 17 out of 17 changed files in this pull request and generated 2 comments.

[Copilot]

Pull request overview

Copilot reviewed 16 out of 16 changed files in this pull request and generated 3 comments.

[Copilot]

Pull request overview

Copilot reviewed 16 out of 16 changed files in this pull request and generated 1 comment.

[nikhilNava]

Thanks for putting this together, can you post the generated post body by the SDK for easy review?
Also please share the post body with Akhil and Jason to help with service implementation

[Copilot]

Pull request overview

Copilot reviewed 21 out of 21 changed files in this pull request and generated 4 comments.

Comments suppressed due to low confidence (1)

packages/agents-a365-observability/package.json:16

• The new prebuild script generates src/version.ts, but nothing in this package’s lifecycle ensures it exists before the repo’s ts-jest test run (which imports package src/ directly via moduleNameMapper). Consider adding a lifecycle hook (prepare/postinstall) or at least a pretest script to generate src/version.ts so clean checkouts can run tests without requiring a manual build first.

    "prebuild": "node -p \"'export const LIB_VERSION = ' + JSON.stringify(require('./package.json').version) + ';'\" > src/version.ts",
    "build:cjs": "npx tsc --project tsconfig.cjs.json",
    "build:esm": "npx tsc --project tsconfig.esm.json",
    "build": "npm run build:cjs && npm run build:esm",
    "build:watch": "npx tsc --watch",
    "clean": "npx rimraf dist",
    "test": "jest --passWithNoTests",
    "test:watch": "jest --watch",

[fpfp100]

Thanks for putting this together, can you post the generated post body by the SDK for easy review? Also please share the post body with Akhil and Jason to help with service implementation

post body is added to the description section.

[Copilot]

Pull request overview

Copilot reviewed 23 out of 23 changed files in this pull request and generated 6 comments.

[Copilot]

This function no longer includes a tenant ID baggage pair (the GEN_AI_CALLER_TENANT_ID_KEY entry was removed), but the JSDoc above still says it returns pairs for caller identity and tenant. Update the JSDoc to match, or re-add the tenant pair if it’s still required by the schema/back-end.

[nikhilNava]

rename to channelName and channelLinks ?

[fpfp100]

This is not schema change. Will create a separated PR once this one is in.

[nikhilNava]

This method can be removed as it doesnt do much. developer will have to use other setters anyway

[fpfp100]

It is also used in dotnet.

[nikhilNava]

rename to channel

[fpfp100]

This is not schema change and will be in a separated PR as mentioned above.

[nikhilNava]

is there a reason to drop the conversion?
the service has it as a string
https://microsoft.ghe.com/bic/mvn-mavenservice/blob/76531733d8ba1e3d15de30a7eb5f8d43e4027c25/src/MVN/Kairo/Observability/Sentinel/SentinelIngestion/SentinelModels.cs#L570

[fpfp100]

according to https://opentelemetry.io/docs/specs/semconv/registry/attributes/gen-ai/, the type should be int. This matches with the latest schema.

[nikhilNava]

provider name refers to model provider provider name like anthropic, meta, openai

[nikhilNava]

maybe we need to come up with constants for those

[fpfp100]

removed. new field is introduced in agentscope

[Copilot]

Pull request overview

Copilot reviewed 23 out of 23 changed files in this pull request and generated 7 comments.

[Copilot]

Pull request overview

Copilot reviewed 28 out of 28 changed files in this pull request and generated 2 comments.

[Copilot]

Pull request overview

Copilot reviewed 28 out of 28 changed files in this pull request and generated no new comments.

Comments suppressed due to low confidence (1)

packages/agents-a365-observability-hosting/src/utils/TurnContextUtils.ts:27

• if (!turnContext|| !turnContext.activity?.from) is missing whitespace around the || operator (and has a trailing space before {). This is likely to violate the repo's formatting/lint rules and should be fixed to keep CI lint clean.

  if (!turnContext|| !turnContext.activity?.from) { 
    return [];

[Copilot]

Pull request overview

Copilot reviewed 28 out of 28 changed files in this pull request and generated 4 comments.

[Copilot]

This assertion covers only GEN_AI_CALLER_CLIENT_IP_KEY now, but the test setup above still builds a callerAgentDetails object with the removed agentClientIP field (cast via as any). Since caller-agent client IP is no longer emitted, please remove that unused field from the test data to avoid confusion about what is expected to be tagged.