@azure/ai-projects 2.2.0 → 2.3.0

package/dist/browser/tracing/attributes.js

@@ -0,0 +1,230 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { formatInputMessages, formatOutputMessages } from "./formatters.js";
+import { GEN_AI_AGENT_ID, GEN_AI_AGENT_NAME, GEN_AI_AGENT_DESCRIPTION, GEN_AI_AGENT_VERSION, GEN_AI_AGENT_TYPE, GEN_AI_AGENT_HOSTED_CPU, GEN_AI_AGENT_HOSTED_MEMORY, GEN_AI_AGENT_HOSTED_IMAGE, GEN_AI_AGENT_HOSTED_PROTOCOL, GEN_AI_AGENT_HOSTED_PROTOCOL_VERSION, GEN_AI_REQUEST_MODEL, GEN_AI_REQUEST_TEMPERATURE, GEN_AI_REQUEST_TOP_P, GEN_AI_REQUEST_REASONING_EFFORT, GEN_AI_SYSTEM_MESSAGE, GEN_AI_RESPONSE_MODEL, GEN_AI_RESPONSE_ID, GEN_AI_USAGE_INPUT_TOKENS, GEN_AI_USAGE_OUTPUT_TOKENS, GEN_AI_OPERATION_NAME, GEN_AI_PROVIDER_NAME, GEN_AI_INPUT_MESSAGES, GEN_AI_OUTPUT_MESSAGES, GEN_AI_CONVERSATION_ID, AZ_NAMESPACE, SERVER_ADDRESS, SERVER_PORT, ERROR_TYPE, AZ_NAMESPACE_VALUE, AGENTS_PROVIDER, GEN_AI_EVENT_CONTENT, GEN_AI_AGENT_WORKFLOW_EVENT, } from "./constants.js";
+/**
+ * Sets common span attributes for all traced operations.
+ */
+export function setCommonAttributes(span, operationName, endpoint) {
+    span.setAttribute(GEN_AI_OPERATION_NAME, operationName);
+    span.setAttribute(AZ_NAMESPACE, AZ_NAMESPACE_VALUE);
+    span.setAttribute(GEN_AI_PROVIDER_NAME, AGENTS_PROVIDER);
+    setServerAttributes(span, endpoint);
+}
+/**
+ * Sets server.address and server.port from a URL endpoint string.
+ */
+export function setServerAttributes(span, endpoint) {
+    try {
+        const url = new URL(endpoint);
+        span.setAttribute(SERVER_ADDRESS, url.hostname);
+        const port = url.port ? parseInt(url.port, 10) : undefined;
+        if (port && port !== 443) {
+            span.setAttribute(SERVER_PORT, port);
+        }
+    }
+    catch {
+        // If URL parsing fails, skip server attributes
+    }
+}
+/**
+ * Sets agent-related attributes on the span from an Agent response.
+ * When content recording is disabled, only IDs and types are set.
+ */
+export function setAgentAttributes(span, agent, contentRecording = false) {
+    const version = agent.versions?.latest;
+    const agentId = version?.version ? `${agent.name}:${version.version}` : agent.name;
+    span.setAttribute(GEN_AI_AGENT_ID, agentId);
+    span.setAttribute(GEN_AI_AGENT_NAME, agent.name);
+    if (version) {
+        setAgentVersionAttributes(span, version, contentRecording);
+    }
+}
+/**
+ * Sets agent version attributes on the span.
+ */
+export function setAgentVersionAttributes(span, version, contentRecording = false) {
+    const agentId = version.version ? `${version.name}:${version.version}` : version.name;
+    span.setAttribute(GEN_AI_AGENT_ID, agentId);
+    span.setAttribute(GEN_AI_AGENT_NAME, version.name);
+    span.setAttribute(GEN_AI_AGENT_VERSION, version.version);
+    span.setAttribute(GEN_AI_AGENT_TYPE, version.definition?.kind ?? "unknown");
+    if (contentRecording && version.description) {
+        span.setAttribute(GEN_AI_AGENT_DESCRIPTION, version.description);
+    }
+    setDefinitionAttributes(span, version.definition, contentRecording);
+}
+/**
+ * Sets attributes from the agent definition.
+ * Only sets content-sensitive attributes when content recording is enabled.
+ */
+export function setDefinitionAttributes(span, definition, contentRecording = false) {
+    if (!definition)
+        return;
+    span.setAttribute(GEN_AI_AGENT_TYPE, definition.kind ?? "unknown");
+    if (definition.kind === "prompt") {
+        const promptDef = definition;
+        // Always set instructions attribute; structured as [{"type":"text","content":"..."}]
+        // When content recording is off, omit the content field
+        if (contentRecording && promptDef.instructions) {
+            span.setAttribute(GEN_AI_SYSTEM_MESSAGE, JSON.stringify([{ type: "text", content: promptDef.instructions }]));
+        }
+        else {
+            span.setAttribute(GEN_AI_SYSTEM_MESSAGE, JSON.stringify([{ type: "text" }]));
+        }
+        // Model and request parameters are not content-sensitive, always set
+        span.setAttribute(GEN_AI_REQUEST_MODEL, promptDef.model);
+        if (promptDef.temperature !== undefined) {
+            span.setAttribute(GEN_AI_REQUEST_TEMPERATURE, String(promptDef.temperature));
+        }
+        if (promptDef.top_p !== undefined) {
+            span.setAttribute(GEN_AI_REQUEST_TOP_P, String(promptDef.top_p));
+        }
+        if (promptDef.reasoning?.effort) {
+            span.setAttribute(GEN_AI_REQUEST_REASONING_EFFORT, promptDef.reasoning.effort);
+        }
+    }
+    else if (definition.kind === "hosted") {
+        const hostedDef = definition;
+        if (hostedDef.cpu) {
+            span.setAttribute(GEN_AI_AGENT_HOSTED_CPU, hostedDef.cpu);
+        }
+        if (hostedDef.memory) {
+            span.setAttribute(GEN_AI_AGENT_HOSTED_MEMORY, hostedDef.memory);
+        }
+        if (hostedDef.container_configuration?.image) {
+            span.setAttribute(GEN_AI_AGENT_HOSTED_IMAGE, hostedDef.container_configuration.image);
+        }
+        const protocols = hostedDef.protocol_versions;
+        if (protocols && protocols.length > 0) {
+            span.setAttribute(GEN_AI_AGENT_HOSTED_PROTOCOL, protocols[0].protocol);
+            span.setAttribute(GEN_AI_AGENT_HOSTED_PROTOCOL_VERSION, protocols[0].version);
+        }
+    }
+    else if (definition.kind === "workflow") {
+        const workflowDef = definition;
+        const fullSpan = span;
+        const contentArray = contentRecording && workflowDef.workflow
+            ? [{ type: "workflow", content: workflowDef.workflow }]
+            : [];
+        fullSpan.addEvent(GEN_AI_AGENT_WORKFLOW_EVENT, {
+            [GEN_AI_PROVIDER_NAME]: AGENTS_PROVIDER,
+            [GEN_AI_EVENT_CONTENT]: JSON.stringify(contentArray),
+        });
+    }
+}
+/**
+ * Sets response attributes on the span from a responses.create() result.
+ */
+export function setResponseAttributes(span, response) {
+    if (response.id) {
+        span.setAttribute(GEN_AI_RESPONSE_ID, response.id);
+    }
+    if (response.model) {
+        span.setAttribute(GEN_AI_RESPONSE_MODEL, response.model);
+    }
+    if (response.usage) {
+        if (response.usage.input_tokens !== undefined) {
+            span.setAttribute(GEN_AI_USAGE_INPUT_TOKENS, response.usage.input_tokens);
+        }
+        if (response.usage.output_tokens !== undefined) {
+            span.setAttribute(GEN_AI_USAGE_OUTPUT_TOKENS, response.usage.output_tokens);
+        }
+    }
+}
+/**
+ * Sets error attributes on the span.
+ */
+export function setErrorAttributes(span, error) {
+    if (error instanceof Error) {
+        span.setAttribute(ERROR_TYPE, error.name || error.constructor?.name || "Error");
+    }
+    else {
+        span.setAttribute(ERROR_TYPE, "Error");
+    }
+}
+/**
+ * Parses an endpoint URL into server address and port.
+ */
+export function parseEndpoint(endpoint) {
+    try {
+        const url = new URL(endpoint);
+        const port = url.port ? parseInt(url.port, 10) : undefined;
+        return { serverAddress: url.hostname, serverPort: port };
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Sets common span attributes for OpenAI response tracing.
+ */
+export function setCommonSpanAttributes(span, operationName, serverAddress, serverPort, body, agentName, contentRecording = false) {
+    span.setAttribute(GEN_AI_OPERATION_NAME, operationName);
+    span.setAttribute(AZ_NAMESPACE, AZ_NAMESPACE_VALUE);
+    span.setAttribute(GEN_AI_PROVIDER_NAME, AGENTS_PROVIDER);
+    // Server attributes
+    if (serverAddress) {
+        span.setAttribute(SERVER_ADDRESS, serverAddress);
+    }
+    if (serverPort && serverPort !== 443) {
+        span.setAttribute(SERVER_PORT, serverPort);
+    }
+    // Agent name for invoke_agent operations
+    if (agentName) {
+        span.setAttribute(GEN_AI_AGENT_NAME, agentName);
+    }
+    // Conversation ID
+    const conversationId = body.conversation;
+    if (typeof conversationId === "string" && conversationId) {
+        span.setAttribute(GEN_AI_CONVERSATION_ID, conversationId);
+    }
+    // Input messages are always set (content is stripped when recording is off)
+    const inputMessages = formatInputMessages(body, contentRecording);
+    if (inputMessages) {
+        span.setAttribute(GEN_AI_INPUT_MESSAGES, inputMessages);
+    }
+    // Request attributes (not content-sensitive, always set)
+    if (body.model) {
+        span.setAttribute(GEN_AI_REQUEST_MODEL, String(body.model));
+    }
+    if (body.temperature !== undefined) {
+        span.setAttribute(GEN_AI_REQUEST_TEMPERATURE, String(body.temperature));
+    }
+    if (body.top_p !== undefined) {
+        span.setAttribute(GEN_AI_REQUEST_TOP_P, String(body.top_p));
+    }
+    // system_instructions only for non-agent (chat) operations (content-sensitive)
+    if (contentRecording) {
+        if (!agentName) {
+            if (body.instructions) {
+                span.setAttribute(GEN_AI_SYSTEM_MESSAGE, JSON.stringify([{ type: "text", content: String(body.instructions) }]));
+            }
+            else {
+                span.setAttribute(GEN_AI_SYSTEM_MESSAGE, JSON.stringify([{ type: "text" }]));
+            }
+        }
+    }
+}
+/**
+ * Sets response span attributes from an OpenAI Response object.
+ */
+export function setResponseSpanAttributes(span, response, contentRecording = false) {
+    setResponseAttributes(span, {
+        id: response.id,
+        model: typeof response.model === "string" ? response.model : undefined,
+        usage: response.usage
+            ? {
+                input_tokens: response.usage.input_tokens,
+                output_tokens: response.usage.output_tokens,
+            }
+            : undefined,
+        status: response.status ?? undefined,
+    });
+    // Output messages are always set (content is stripped when recording is off)
+    const outputMessages = formatOutputMessages(response, contentRecording);
+    if (outputMessages) {
+        span.setAttribute(GEN_AI_OUTPUT_MESSAGES, outputMessages);
+    }
+}
+//# sourceMappingURL=attributes.js.map

package/dist/browser/tracing/attributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.js","sourceRoot":"","sources":["../../../src/tracing/attributes.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { Span } from \"@opentelemetry/api\";\nimport { formatInputMessages, formatOutputMessages } from \"./formatters.js\";\nimport type { Response as OAIResponse } from \"openai/resources/responses/responses\";\n\n/**\n * Subset of Span used by attribute helpers.\n * Compatible with OTel Span interface.\n */\nexport type SpanLike = Pick<Span, \"setAttribute\" | \"setStatus\">;\nimport {\n  GEN_AI_AGENT_ID,\n  GEN_AI_AGENT_NAME,\n  GEN_AI_AGENT_DESCRIPTION,\n  GEN_AI_AGENT_VERSION,\n  GEN_AI_AGENT_TYPE,\n  GEN_AI_AGENT_HOSTED_CPU,\n  GEN_AI_AGENT_HOSTED_MEMORY,\n  GEN_AI_AGENT_HOSTED_IMAGE,\n  GEN_AI_AGENT_HOSTED_PROTOCOL,\n  GEN_AI_AGENT_HOSTED_PROTOCOL_VERSION,\n  GEN_AI_REQUEST_MODEL,\n  GEN_AI_REQUEST_TEMPERATURE,\n  GEN_AI_REQUEST_TOP_P,\n  GEN_AI_REQUEST_REASONING_EFFORT,\n  GEN_AI_SYSTEM_MESSAGE,\n  GEN_AI_RESPONSE_MODEL,\n  GEN_AI_RESPONSE_ID,\n  GEN_AI_USAGE_INPUT_TOKENS,\n  GEN_AI_USAGE_OUTPUT_TOKENS,\n  GEN_AI_OPERATION_NAME,\n  GEN_AI_PROVIDER_NAME,\n  GEN_AI_INPUT_MESSAGES,\n  GEN_AI_OUTPUT_MESSAGES,\n  GEN_AI_CONVERSATION_ID,\n  AZ_NAMESPACE,\n  SERVER_ADDRESS,\n  SERVER_PORT,\n  ERROR_TYPE,\n  AZ_NAMESPACE_VALUE,\n  AGENTS_PROVIDER,\n  GEN_AI_EVENT_CONTENT,\n  GEN_AI_AGENT_WORKFLOW_EVENT,\n} from \"./constants.js\";\nimport type {\n  Agent,\n  AgentVersion,\n  AgentDefinitionUnion,\n  PromptAgentDefinition,\n  HostedAgentDefinition,\n  WorkflowAgentDefinition,\n} from \"../models/models.js\";\n\n/**\n * Sets common span attributes for all traced operations.\n */\nexport function setCommonAttributes(span: SpanLike, operationName: string, endpoint: string): void {\n  span.setAttribute(GEN_AI_OPERATION_NAME, operationName);\n  span.setAttribute(AZ_NAMESPACE, AZ_NAMESPACE_VALUE);\n  span.setAttribute(GEN_AI_PROVIDER_NAME, AGENTS_PROVIDER);\n  setServerAttributes(span, endpoint);\n}\n\n/**\n * Sets server.address and server.port from a URL endpoint string.\n */\nexport function setServerAttributes(span: SpanLike, endpoint: string): void {\n  try {\n    const url = new URL(endpoint);\n    span.setAttribute(SERVER_ADDRESS, url.hostname);\n    const port = url.port ? parseInt(url.port, 10) : undefined;\n    if (port && port !== 443) {\n      span.setAttribute(SERVER_PORT, port);\n    }\n  } catch {\n    // If URL parsing fails, skip server attributes\n  }\n}\n\n/**\n * Sets agent-related attributes on the span from an Agent response.\n * When content recording is disabled, only IDs and types are set.\n */\nexport function setAgentAttributes(\n  span: SpanLike,\n  agent: Agent,\n  contentRecording: boolean = false,\n): void {\n  const version = agent.versions?.latest;\n  const agentId = version?.version ? `${agent.name}:${version.version}` : agent.name;\n  span.setAttribute(GEN_AI_AGENT_ID, agentId);\n  span.setAttribute(GEN_AI_AGENT_NAME, agent.name);\n\n  if (version) {\n    setAgentVersionAttributes(span, version, contentRecording);\n  }\n}\n\n/**\n * Sets agent version attributes on the span.\n */\nexport function setAgentVersionAttributes(\n  span: SpanLike,\n  version: AgentVersion,\n  contentRecording: boolean = false,\n): void {\n  const agentId = version.version ? `${version.name}:${version.version}` : version.name;\n  span.setAttribute(GEN_AI_AGENT_ID, agentId);\n  span.setAttribute(GEN_AI_AGENT_NAME, version.name);\n  span.setAttribute(GEN_AI_AGENT_VERSION, version.version);\n  span.setAttribute(GEN_AI_AGENT_TYPE, version.definition?.kind ?? \"unknown\");\n\n  if (contentRecording && version.description) {\n    span.setAttribute(GEN_AI_AGENT_DESCRIPTION, version.description);\n  }\n  setDefinitionAttributes(span, version.definition, contentRecording);\n}\n\n/**\n * Sets attributes from the agent definition.\n * Only sets content-sensitive attributes when content recording is enabled.\n */\nexport function setDefinitionAttributes(\n  span: SpanLike,\n  definition: AgentDefinitionUnion,\n  contentRecording: boolean = false,\n): void {\n  if (!definition) return;\n\n  span.setAttribute(GEN_AI_AGENT_TYPE, definition.kind ?? \"unknown\");\n\n  if (definition.kind === \"prompt\") {\n    const promptDef = definition as PromptAgentDefinition;\n    // Always set instructions attribute; structured as [{\"type\":\"text\",\"content\":\"...\"}]\n    // When content recording is off, omit the content field\n    if (contentRecording && promptDef.instructions) {\n      span.setAttribute(\n        GEN_AI_SYSTEM_MESSAGE,\n        JSON.stringify([{ type: \"text\", content: promptDef.instructions }]),\n      );\n    } else {\n      span.setAttribute(GEN_AI_SYSTEM_MESSAGE, JSON.stringify([{ type: \"text\" }]));\n    }\n    // Model and request parameters are not content-sensitive, always set\n    span.setAttribute(GEN_AI_REQUEST_MODEL, promptDef.model);\n    if (promptDef.temperature !== undefined) {\n      span.setAttribute(GEN_AI_REQUEST_TEMPERATURE, String(promptDef.temperature));\n    }\n    if (promptDef.top_p !== undefined) {\n      span.setAttribute(GEN_AI_REQUEST_TOP_P, String(promptDef.top_p));\n    }\n    if (promptDef.reasoning?.effort) {\n      span.setAttribute(GEN_AI_REQUEST_REASONING_EFFORT, promptDef.reasoning.effort);\n    }\n  } else if (definition.kind === \"hosted\") {\n    const hostedDef = definition as HostedAgentDefinition;\n    if (hostedDef.cpu) {\n      span.setAttribute(GEN_AI_AGENT_HOSTED_CPU, hostedDef.cpu);\n    }\n    if (hostedDef.memory) {\n      span.setAttribute(GEN_AI_AGENT_HOSTED_MEMORY, hostedDef.memory);\n    }\n    if (hostedDef.container_configuration?.image) {\n      span.setAttribute(GEN_AI_AGENT_HOSTED_IMAGE, hostedDef.container_configuration.image);\n    }\n    const protocols = hostedDef.protocol_versions;\n    if (protocols && protocols.length > 0) {\n      span.setAttribute(GEN_AI_AGENT_HOSTED_PROTOCOL, protocols[0]!.protocol);\n      span.setAttribute(GEN_AI_AGENT_HOSTED_PROTOCOL_VERSION, protocols[0]!.version);\n    }\n  } else if (definition.kind === \"workflow\") {\n    const workflowDef = definition as WorkflowAgentDefinition;\n    const fullSpan = span as Span;\n    const contentArray =\n      contentRecording && workflowDef.workflow\n        ? [{ type: \"workflow\", content: workflowDef.workflow }]\n        : [];\n    fullSpan.addEvent(GEN_AI_AGENT_WORKFLOW_EVENT, {\n      [GEN_AI_PROVIDER_NAME]: AGENTS_PROVIDER,\n      [GEN_AI_EVENT_CONTENT]: JSON.stringify(contentArray),\n    });\n  }\n}\n\n/**\n * Sets response attributes on the span from a responses.create() result.\n */\nexport function setResponseAttributes(\n  span: SpanLike,\n  response: {\n    id?: string;\n    model?: string;\n    usage?: { input_tokens?: number; output_tokens?: number };\n    status?: string;\n  },\n): void {\n  if (response.id) {\n    span.setAttribute(GEN_AI_RESPONSE_ID, response.id);\n  }\n  if (response.model) {\n    span.setAttribute(GEN_AI_RESPONSE_MODEL, response.model);\n  }\n  if (response.usage) {\n    if (response.usage.input_tokens !== undefined) {\n      span.setAttribute(GEN_AI_USAGE_INPUT_TOKENS, response.usage.input_tokens);\n    }\n    if (response.usage.output_tokens !== undefined) {\n      span.setAttribute(GEN_AI_USAGE_OUTPUT_TOKENS, response.usage.output_tokens);\n    }\n  }\n}\n\n/**\n * Sets error attributes on the span.\n */\nexport function setErrorAttributes(span: SpanLike, error: unknown): void {\n  if (error instanceof Error) {\n    span.setAttribute(ERROR_TYPE, error.name || error.constructor?.name || \"Error\");\n  } else {\n    span.setAttribute(ERROR_TYPE, \"Error\");\n  }\n}\n\n/**\n * Parses an endpoint URL into server address and port.\n */\nexport function parseEndpoint(endpoint: string): { serverAddress?: string; serverPort?: number } {\n  try {\n    const url = new URL(endpoint);\n    const port = url.port ? parseInt(url.port, 10) : undefined;\n    return { serverAddress: url.hostname, serverPort: port };\n  } catch {\n    return {};\n  }\n}\n\n/**\n * Sets common span attributes for OpenAI response tracing.\n */\nexport function setCommonSpanAttributes(\n  span: SpanLike,\n  operationName: string,\n  serverAddress: string | undefined,\n  serverPort: number | undefined,\n  body: Record<string, unknown>,\n  agentName?: string,\n  contentRecording: boolean = false,\n): void {\n  span.setAttribute(GEN_AI_OPERATION_NAME, operationName);\n  span.setAttribute(AZ_NAMESPACE, AZ_NAMESPACE_VALUE);\n  span.setAttribute(GEN_AI_PROVIDER_NAME, AGENTS_PROVIDER);\n\n  // Server attributes\n  if (serverAddress) {\n    span.setAttribute(SERVER_ADDRESS, serverAddress);\n  }\n  if (serverPort && serverPort !== 443) {\n    span.setAttribute(SERVER_PORT, serverPort);\n  }\n\n  // Agent name for invoke_agent operations\n  if (agentName) {\n    span.setAttribute(GEN_AI_AGENT_NAME, agentName);\n  }\n\n  // Conversation ID\n  const conversationId = body.conversation;\n  if (typeof conversationId === \"string\" && conversationId) {\n    span.setAttribute(GEN_AI_CONVERSATION_ID, conversationId);\n  }\n\n  // Input messages are always set (content is stripped when recording is off)\n  const inputMessages = formatInputMessages(body, contentRecording);\n  if (inputMessages) {\n    span.setAttribute(GEN_AI_INPUT_MESSAGES, inputMessages);\n  }\n\n  // Request attributes (not content-sensitive, always set)\n  if (body.model) {\n    span.setAttribute(GEN_AI_REQUEST_MODEL, String(body.model));\n  }\n  if (body.temperature !== undefined) {\n    span.setAttribute(GEN_AI_REQUEST_TEMPERATURE, String(body.temperature));\n  }\n  if (body.top_p !== undefined) {\n    span.setAttribute(GEN_AI_REQUEST_TOP_P, String(body.top_p));\n  }\n\n  // system_instructions only for non-agent (chat) operations (content-sensitive)\n  if (contentRecording) {\n    if (!agentName) {\n      if (body.instructions) {\n        span.setAttribute(\n          GEN_AI_SYSTEM_MESSAGE,\n          JSON.stringify([{ type: \"text\", content: String(body.instructions) }]),\n        );\n      } else {\n        span.setAttribute(GEN_AI_SYSTEM_MESSAGE, JSON.stringify([{ type: \"text\" }]));\n      }\n    }\n  }\n}\n\n/**\n * Sets response span attributes from an OpenAI Response object.\n */\nexport function setResponseSpanAttributes(\n  span: SpanLike,\n  response: OAIResponse,\n  contentRecording: boolean = false,\n): void {\n  setResponseAttributes(span, {\n    id: response.id,\n    model: typeof response.model === \"string\" ? response.model : undefined,\n    usage: response.usage\n      ? {\n          input_tokens: response.usage.input_tokens,\n          output_tokens: response.usage.output_tokens,\n        }\n      : undefined,\n    status: response.status ?? undefined,\n  });\n\n  // Output messages are always set (content is stripped when recording is off)\n  const outputMessages = formatOutputMessages(\n    response as unknown as Record<string, unknown>,\n    contentRecording,\n  );\n  if (outputMessages) {\n    span.setAttribute(GEN_AI_OUTPUT_MESSAGES, outputMessages);\n  }\n}\n"]}

package/dist/browser/tracing/configuration.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Options for configuring GenAI tracing on a specific AIProjectClient instance.
+ *
+ * Pass these under the `tracingOptions` key of AIProjectClientOptionalParams
+ * to enable GenAI tracing when the client is instantiated. Each client instance
+ * maintains its own independent tracing configuration.
+ */
+export interface GenAITracingOptions {
+    /**
+     * Acknowledge that GenAI tracing features are experimental and may change
+     * or be removed in future releases without notice.
+     * When set to `true`, tracing is enabled.
+     * When omitted, the `AZURE_EXPERIMENTAL_ENABLE_GENAI_TRACING` environment variable
+     * is checked (accepts `"true"` case-insensitive or `"1"`). Defaults to `false`.
+     */
+    experimental?: boolean;
+    /**
+     * Whether to capture message content in traces.
+     * Content includes chat messages, function call names, arguments, and return values.
+     * When set to `true` or `false`, that value is used directly.
+     * When omitted, the `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT` environment
+     * variable is checked (accepts `"true"` case-insensitive or `"1"`). Defaults to `false`.
+     */
+    contentRecording?: boolean;
+    /**
+     * Whether to inject W3C trace context headers (`traceparent`, `tracestate`)
+     * into outgoing OpenAI requests.
+     * When set to `true` or `false`, that value is used directly.
+     * When omitted, the `AZURE_TRACING_GEN_AI_ENABLE_TRACE_CONTEXT_PROPAGATION` environment
+     * variable is checked (accepts `"true"` case-insensitive or `"1"`). Defaults to `true`.
+     */
+    traceContextPropagation?: boolean;
+}
+/**
+ * Resolved tracing configuration for a specific client instance.
+ * @internal
+ */
+export interface ResolvedTracingConfig {
+    /** Whether tracing is enabled. */
+    enabled: boolean;
+    /** Whether to record content (messages, tool calls, etc.). */
+    contentRecording: boolean;
+    /** Whether to inject W3C trace context headers. */
+    traceContextPropagation: boolean;
+}
+/**
+ * Resolves tracing options into a frozen config object for the client instance.
+ * For each setting not explicitly provided, the corresponding environment variable
+ * is checked. If the env var is also not set, the default value is used.
+ *
+ * - `enabled`: defaults to `false`. Env var: `AZURE_TRACING_GEN_AI_CONTENT_RECORDING_ENABLED`
+ *   is not used for enabled — passing `tracingOptions` (even `{}`) enables tracing.
+ *   Env var `AZURE_TRACING_GEN_AI_ENABLE` (accepts `"true"` or `"1"`) enables tracing
+ *   when `tracingOptions` is not provided.
+ * - `contentRecording`: defaults to `false`. Env var: `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT`
+ * - `traceContextPropagation`: defaults to `true`. Env var: `AZURE_TRACING_GEN_AI_ENABLE_TRACE_CONTEXT_PROPAGATION`
+ * @internal
+ */
+export declare function resolveTracingConfig(options?: GenAITracingOptions): ResolvedTracingConfig;
+//# sourceMappingURL=configuration.d.ts.map

package/dist/browser/tracing/configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../../src/tracing/configuration.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mDAAmD;IACnD,uBAAuB,EAAE,OAAO,CAAC;CAClC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,qBAAqB,CAiDzF"}

package/dist/browser/tracing/configuration.js

@@ -0,0 +1,67 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+/**
+ * Resolves tracing options into a frozen config object for the client instance.
+ * For each setting not explicitly provided, the corresponding environment variable
+ * is checked. If the env var is also not set, the default value is used.
+ *
+ * - `enabled`: defaults to `false`. Env var: `AZURE_TRACING_GEN_AI_CONTENT_RECORDING_ENABLED`
+ *   is not used for enabled — passing `tracingOptions` (even `{}`) enables tracing.
+ *   Env var `AZURE_TRACING_GEN_AI_ENABLE` (accepts `"true"` or `"1"`) enables tracing
+ *   when `tracingOptions` is not provided.
+ * - `contentRecording`: defaults to `false`. Env var: `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT`
+ * - `traceContextPropagation`: defaults to `true`. Env var: `AZURE_TRACING_GEN_AI_ENABLE_TRACE_CONTEXT_PROPAGATION`
+ * @internal
+ */
+export function resolveTracingConfig(options) {
+    // Determine if tracing is enabled — requires experimental acknowledgment
+    let experimental;
+    if (options?.experimental !== undefined) {
+        experimental = options.experimental;
+    }
+    else {
+        try {
+            const envVal = process.env.AZURE_EXPERIMENTAL_ENABLE_GENAI_TRACING;
+            experimental = !!envVal && (envVal.toLowerCase() === "true" || envVal === "1");
+        }
+        catch {
+            experimental = false;
+        }
+    }
+    const enabled = options !== undefined && experimental;
+    if (!enabled) {
+        return { enabled: false, contentRecording: false, traceContextPropagation: true };
+    }
+    // Resolve contentRecording
+    let contentRecording = false;
+    if (options?.contentRecording !== undefined) {
+        contentRecording = options.contentRecording;
+    }
+    else {
+        try {
+            const envVal = process.env.OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT;
+            contentRecording = !!envVal && (envVal.toLowerCase() === "true" || envVal === "1");
+        }
+        catch {
+            contentRecording = false;
+        }
+    }
+    // Resolve traceContextPropagation
+    let traceContextPropagation = true;
+    if (options?.traceContextPropagation !== undefined) {
+        traceContextPropagation = options.traceContextPropagation;
+    }
+    else {
+        try {
+            const envVal = process.env.AZURE_TRACING_GEN_AI_ENABLE_TRACE_CONTEXT_PROPAGATION;
+            if (envVal && (envVal.toLowerCase() === "false" || envVal === "0")) {
+                traceContextPropagation = false;
+            }
+        }
+        catch {
+            // process.env may not exist in browser environments
+        }
+    }
+    return { enabled, contentRecording, traceContextPropagation };
+}
+//# sourceMappingURL=configuration.js.map

package/dist/browser/tracing/configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../../../src/tracing/configuration.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAiDlC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA6B;IAChE,yEAAyE;IACzE,IAAI,YAAqB,CAAC;IAC1B,IAAI,OAAO,EAAE,YAAY,KAAK,SAAS,EAAE,CAAC;QACxC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IACtC,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC;YACnE,YAAY,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,MAAM,IAAI,MAAM,KAAK,GAAG,CAAC,CAAC;QACjF,CAAC;QAAC,MAAM,CAAC;YACP,YAAY,GAAG,KAAK,CAAC;QACvB,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,KAAK,SAAS,IAAI,YAAY,CAAC;IAEtD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,uBAAuB,EAAE,IAAI,EAAE,CAAC;IACpF,CAAC;IAED,2BAA2B;IAC3B,IAAI,gBAAgB,GAAG,KAAK,CAAC;IAC7B,IAAI,OAAO,EAAE,gBAAgB,KAAK,SAAS,EAAE,CAAC;QAC5C,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAC9C,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC;YAC9E,gBAAgB,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,MAAM,IAAI,MAAM,KAAK,GAAG,CAAC,CAAC;QACrF,CAAC;QAAC,MAAM,CAAC;YACP,gBAAgB,GAAG,KAAK,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,kCAAkC;IAClC,IAAI,uBAAuB,GAAG,IAAI,CAAC;IACnC,IAAI,OAAO,EAAE,uBAAuB,KAAK,SAAS,EAAE,CAAC;QACnD,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAC5D,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC;YACjF,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,OAAO,IAAI,MAAM,KAAK,GAAG,CAAC,EAAE,CAAC;gBACnE,uBAAuB,GAAG,KAAK,CAAC;YAClC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,oDAAoD;QACtD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,CAAC;AAChE,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\n/**\n * Options for configuring GenAI tracing on a specific AIProjectClient instance.\n *\n * Pass these under the `tracingOptions` key of AIProjectClientOptionalParams\n * to enable GenAI tracing when the client is instantiated. Each client instance\n * maintains its own independent tracing configuration.\n */\nexport interface GenAITracingOptions {\n  /**\n   * Acknowledge that GenAI tracing features are experimental and may change\n   * or be removed in future releases without notice.\n   * When set to `true`, tracing is enabled.\n   * When omitted, the `AZURE_EXPERIMENTAL_ENABLE_GENAI_TRACING` environment variable\n   * is checked (accepts `\"true\"` case-insensitive or `\"1\"`). Defaults to `false`.\n   */\n  experimental?: boolean;\n  /**\n   * Whether to capture message content in traces.\n   * Content includes chat messages, function call names, arguments, and return values.\n   * When set to `true` or `false`, that value is used directly.\n   * When omitted, the `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT` environment\n   * variable is checked (accepts `\"true\"` case-insensitive or `\"1\"`). Defaults to `false`.\n   */\n  contentRecording?: boolean;\n  /**\n   * Whether to inject W3C trace context headers (`traceparent`, `tracestate`)\n   * into outgoing OpenAI requests.\n   * When set to `true` or `false`, that value is used directly.\n   * When omitted, the `AZURE_TRACING_GEN_AI_ENABLE_TRACE_CONTEXT_PROPAGATION` environment\n   * variable is checked (accepts `\"true\"` case-insensitive or `\"1\"`). Defaults to `true`.\n   */\n  traceContextPropagation?: boolean;\n}\n\n/**\n * Resolved tracing configuration for a specific client instance.\n * @internal\n */\nexport interface ResolvedTracingConfig {\n  /** Whether tracing is enabled. */\n  enabled: boolean;\n  /** Whether to record content (messages, tool calls, etc.). */\n  contentRecording: boolean;\n  /** Whether to inject W3C trace context headers. */\n  traceContextPropagation: boolean;\n}\n\n/**\n * Resolves tracing options into a frozen config object for the client instance.\n * For each setting not explicitly provided, the corresponding environment variable\n * is checked. If the env var is also not set, the default value is used.\n *\n * - `enabled`: defaults to `false`. Env var: `AZURE_TRACING_GEN_AI_CONTENT_RECORDING_ENABLED`\n *   is not used for enabled — passing `tracingOptions` (even `{}`) enables tracing.\n *   Env var `AZURE_TRACING_GEN_AI_ENABLE` (accepts `\"true\"` or `\"1\"`) enables tracing\n *   when `tracingOptions` is not provided.\n * - `contentRecording`: defaults to `false`. Env var: `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT`\n * - `traceContextPropagation`: defaults to `true`. Env var: `AZURE_TRACING_GEN_AI_ENABLE_TRACE_CONTEXT_PROPAGATION`\n * @internal\n */\nexport function resolveTracingConfig(options?: GenAITracingOptions): ResolvedTracingConfig {\n  // Determine if tracing is enabled — requires experimental acknowledgment\n  let experimental: boolean;\n  if (options?.experimental !== undefined) {\n    experimental = options.experimental;\n  } else {\n    try {\n      const envVal = process.env.AZURE_EXPERIMENTAL_ENABLE_GENAI_TRACING;\n      experimental = !!envVal && (envVal.toLowerCase() === \"true\" || envVal === \"1\");\n    } catch {\n      experimental = false;\n    }\n  }\n\n  const enabled = options !== undefined && experimental;\n\n  if (!enabled) {\n    return { enabled: false, contentRecording: false, traceContextPropagation: true };\n  }\n\n  // Resolve contentRecording\n  let contentRecording = false;\n  if (options?.contentRecording !== undefined) {\n    contentRecording = options.contentRecording;\n  } else {\n    try {\n      const envVal = process.env.OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT;\n      contentRecording = !!envVal && (envVal.toLowerCase() === \"true\" || envVal === \"1\");\n    } catch {\n      contentRecording = false;\n    }\n  }\n\n  // Resolve traceContextPropagation\n  let traceContextPropagation = true;\n  if (options?.traceContextPropagation !== undefined) {\n    traceContextPropagation = options.traceContextPropagation;\n  } else {\n    try {\n      const envVal = process.env.AZURE_TRACING_GEN_AI_ENABLE_TRACE_CONTEXT_PROPAGATION;\n      if (envVal && (envVal.toLowerCase() === \"false\" || envVal === \"0\")) {\n        traceContextPropagation = false;\n      }\n    } catch {\n      // process.env may not exist in browser environments\n    }\n  }\n\n  return { enabled, contentRecording, traceContextPropagation };\n}\n"]}

package/dist/browser/tracing/constants.d.ts

@@ -0,0 +1,55 @@
+export declare const GEN_AI_AGENT_ID = "gen_ai.agent.id";
+export declare const GEN_AI_AGENT_NAME = "gen_ai.agent.name";
+export declare const GEN_AI_AGENT_DESCRIPTION = "gen_ai.agent.description";
+export declare const GEN_AI_AGENT_VERSION = "gen_ai.agent.version";
+export declare const GEN_AI_AGENT_TYPE = "gen_ai.agent.type";
+export declare const GEN_AI_AGENT_HOSTED_CPU = "gen_ai.agent.hosted.cpu";
+export declare const GEN_AI_AGENT_HOSTED_MEMORY = "gen_ai.agent.hosted.memory";
+export declare const GEN_AI_AGENT_HOSTED_IMAGE = "gen_ai.agent.hosted.image";
+export declare const GEN_AI_AGENT_HOSTED_PROTOCOL = "gen_ai.agent.hosted.protocol";
+export declare const GEN_AI_AGENT_HOSTED_PROTOCOL_VERSION = "gen_ai.agent.hosted.protocol_version";
+export declare const GEN_AI_OPERATION_NAME = "gen_ai.operation.name";
+export declare const GEN_AI_SYSTEM = "gen_ai.system";
+export declare const GEN_AI_PROVIDER_NAME = "gen_ai.provider.name";
+export declare const GEN_AI_REQUEST_MODEL = "gen_ai.request.model";
+export declare const GEN_AI_REQUEST_TEMPERATURE = "gen_ai.request.temperature";
+export declare const GEN_AI_REQUEST_TOP_P = "gen_ai.request.top_p";
+export declare const GEN_AI_REQUEST_MAX_INPUT_TOKENS = "gen_ai.request.max_input_tokens";
+export declare const GEN_AI_REQUEST_MAX_OUTPUT_TOKENS = "gen_ai.request.max_output_tokens";
+export declare const GEN_AI_REQUEST_RESPONSE_FORMAT = "gen_ai.request.response_format";
+export declare const GEN_AI_REQUEST_REASONING_EFFORT = "gen_ai.request.reasoning.effort";
+export declare const GEN_AI_REQUEST_REASONING_SUMMARY = "gen_ai.request.reasoning.summary";
+export declare const GEN_AI_REQUEST_TOOLS = "gen_ai.request.tools";
+export declare const GEN_AI_RESPONSE_MODEL = "gen_ai.response.model";
+export declare const GEN_AI_RESPONSE_ID = "gen_ai.response.id";
+export declare const GEN_AI_RESPONSE_FINISH_REASONS = "gen_ai.response.finish_reasons";
+export declare const GEN_AI_USAGE_INPUT_TOKENS = "gen_ai.usage.input_tokens";
+export declare const GEN_AI_USAGE_OUTPUT_TOKENS = "gen_ai.usage.output_tokens";
+export declare const GEN_AI_TOOL_NAME = "gen_ai.tool.name";
+export declare const GEN_AI_TOOL_CALL_ID = "gen_ai.tool.call.id";
+export declare const GEN_AI_CONVERSATION_ID = "gen_ai.conversation.id";
+export declare const GEN_AI_SYSTEM_MESSAGE = "gen_ai.system_instructions";
+export declare const GEN_AI_INPUT_MESSAGES = "gen_ai.input.messages";
+export declare const GEN_AI_OUTPUT_MESSAGES = "gen_ai.output.messages";
+export declare const SERVER_ADDRESS = "server.address";
+export declare const SERVER_PORT = "server.port";
+export declare const AZ_NAMESPACE = "az.namespace";
+export declare const ERROR_TYPE = "error.type";
+export declare const GEN_AI_EVENT_CONTENT = "gen_ai.event.content";
+export declare const GEN_AI_WORKFLOW_ACTION_EVENT = "gen_ai.workflow.action";
+export declare const GEN_AI_AGENT_WORKFLOW_EVENT = "gen_ai.agent.workflow";
+export declare const AZ_AI_AGENT_SYSTEM = "az.ai.agents";
+export declare const AZ_NAMESPACE_VALUE = "Microsoft.CognitiveServices";
+export declare const AGENTS_PROVIDER = "microsoft.foundry";
+export declare const OperationName: {
+    readonly CREATE_AGENT: "create_agent";
+    readonly INVOKE_AGENT: "invoke_agent";
+    readonly CHAT: "chat";
+    readonly CREATE_CONVERSATION: "create_conversation";
+};
+export declare const GEN_AI_CLIENT_OPERATION_DURATION = "gen_ai.client.operation.duration";
+export declare const GEN_AI_CLIENT_TOKEN_USAGE = "gen_ai.client.token.usage";
+export declare const GEN_AI_INPUT_MESSAGE_EVENT = "gen_ai.input.messages";
+export declare const GEN_AI_OUTPUT_MESSAGE_EVENT = "gen_ai.output.messages";
+export declare const GEN_AI_SYSTEM_INSTRUCTION_EVENT = "gen_ai.system.instructions";
+//# sourceMappingURL=constants.d.ts.map

package/dist/browser/tracing/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/tracing/constants.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,eAAe,oBAAoB,CAAC;AACjD,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AACrD,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AACnE,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAC3D,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAGrD,eAAO,MAAM,uBAAuB,4BAA4B,CAAC;AACjE,eAAO,MAAM,0BAA0B,+BAA+B,CAAC;AACvE,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AACrE,eAAO,MAAM,4BAA4B,iCAAiC,CAAC;AAC3E,eAAO,MAAM,oCAAoC,yCAAyC,CAAC;AAG3F,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAC7D,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAC7C,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAG3D,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAC3D,eAAO,MAAM,0BAA0B,+BAA+B,CAAC;AACvE,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAC3D,eAAO,MAAM,+BAA+B,oCAAoC,CAAC;AACjF,eAAO,MAAM,gCAAgC,qCAAqC,CAAC;AACnF,eAAO,MAAM,8BAA8B,mCAAmC,CAAC;AAC/E,eAAO,MAAM,+BAA+B,oCAAoC,CAAC;AACjF,eAAO,MAAM,gCAAgC,qCAAqC,CAAC;AACnF,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAG3D,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAC7D,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AACvD,eAAO,MAAM,8BAA8B,mCAAmC,CAAC;AAG/E,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AACrE,eAAO,MAAM,0BAA0B,+BAA+B,CAAC;AAGvE,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AACnD,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAGzD,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAG/D,eAAO,MAAM,qBAAqB,+BAA+B,CAAC;AAClE,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAC7D,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAG/D,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAC/C,eAAO,MAAM,WAAW,gBAAgB,CAAC;AAGzC,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAG3C,eAAO,MAAM,UAAU,eAAe,CAAC;AAGvC,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAC3D,eAAO,MAAM,4BAA4B,2BAA2B,CAAC;AACrE,eAAO,MAAM,2BAA2B,0BAA0B,CAAC;AAInE,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AACjD,eAAO,MAAM,kBAAkB,gCAAgC,CAAC;AAChE,eAAO,MAAM,eAAe,sBAAsB,CAAC;AAInD,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC;AAIX,eAAO,MAAM,gCAAgC,qCAAqC,CAAC;AACnF,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AAIrE,eAAO,MAAM,0BAA0B,0BAA0B,CAAC;AAClE,eAAO,MAAM,2BAA2B,2BAA2B,CAAC;AACpE,eAAO,MAAM,+BAA+B,+BAA+B,CAAC"}

package/dist/browser/tracing/constants.js

@@ -0,0 +1,75 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+// --- GenAI Semantic Convention Attributes ---
+// Agent
+export const GEN_AI_AGENT_ID = "gen_ai.agent.id";
+export const GEN_AI_AGENT_NAME = "gen_ai.agent.name";
+export const GEN_AI_AGENT_DESCRIPTION = "gen_ai.agent.description";
+export const GEN_AI_AGENT_VERSION = "gen_ai.agent.version";
+export const GEN_AI_AGENT_TYPE = "gen_ai.agent.type";
+// Hosted agent
+export const GEN_AI_AGENT_HOSTED_CPU = "gen_ai.agent.hosted.cpu";
+export const GEN_AI_AGENT_HOSTED_MEMORY = "gen_ai.agent.hosted.memory";
+export const GEN_AI_AGENT_HOSTED_IMAGE = "gen_ai.agent.hosted.image";
+export const GEN_AI_AGENT_HOSTED_PROTOCOL = "gen_ai.agent.hosted.protocol";
+export const GEN_AI_AGENT_HOSTED_PROTOCOL_VERSION = "gen_ai.agent.hosted.protocol_version";
+// Operation
+export const GEN_AI_OPERATION_NAME = "gen_ai.operation.name";
+export const GEN_AI_SYSTEM = "gen_ai.system";
+export const GEN_AI_PROVIDER_NAME = "gen_ai.provider.name";
+// Request (LLM model)
+export const GEN_AI_REQUEST_MODEL = "gen_ai.request.model";
+export const GEN_AI_REQUEST_TEMPERATURE = "gen_ai.request.temperature";
+export const GEN_AI_REQUEST_TOP_P = "gen_ai.request.top_p";
+export const GEN_AI_REQUEST_MAX_INPUT_TOKENS = "gen_ai.request.max_input_tokens";
+export const GEN_AI_REQUEST_MAX_OUTPUT_TOKENS = "gen_ai.request.max_output_tokens";
+export const GEN_AI_REQUEST_RESPONSE_FORMAT = "gen_ai.request.response_format";
+export const GEN_AI_REQUEST_REASONING_EFFORT = "gen_ai.request.reasoning.effort";
+export const GEN_AI_REQUEST_REASONING_SUMMARY = "gen_ai.request.reasoning.summary";
+export const GEN_AI_REQUEST_TOOLS = "gen_ai.request.tools";
+// Response
+export const GEN_AI_RESPONSE_MODEL = "gen_ai.response.model";
+export const GEN_AI_RESPONSE_ID = "gen_ai.response.id";
+export const GEN_AI_RESPONSE_FINISH_REASONS = "gen_ai.response.finish_reasons";
+// Usage
+export const GEN_AI_USAGE_INPUT_TOKENS = "gen_ai.usage.input_tokens";
+export const GEN_AI_USAGE_OUTPUT_TOKENS = "gen_ai.usage.output_tokens";
+// Tool
+export const GEN_AI_TOOL_NAME = "gen_ai.tool.name";
+export const GEN_AI_TOOL_CALL_ID = "gen_ai.tool.call.id";
+// Conversation
+export const GEN_AI_CONVERSATION_ID = "gen_ai.conversation.id";
+// Messages (content recording)
+export const GEN_AI_SYSTEM_MESSAGE = "gen_ai.system_instructions";
+export const GEN_AI_INPUT_MESSAGES = "gen_ai.input.messages";
+export const GEN_AI_OUTPUT_MESSAGES = "gen_ai.output.messages";
+// Server
+export const SERVER_ADDRESS = "server.address";
+export const SERVER_PORT = "server.port";
+// Azure
+export const AZ_NAMESPACE = "az.namespace";
+// Error
+export const ERROR_TYPE = "error.type";
+// Events
+export const GEN_AI_EVENT_CONTENT = "gen_ai.event.content";
+export const GEN_AI_WORKFLOW_ACTION_EVENT = "gen_ai.workflow.action";
+export const GEN_AI_AGENT_WORKFLOW_EVENT = "gen_ai.agent.workflow";
+// --- Constant Values ---
+export const AZ_AI_AGENT_SYSTEM = "az.ai.agents";
+export const AZ_NAMESPACE_VALUE = "Microsoft.CognitiveServices";
+export const AGENTS_PROVIDER = "microsoft.foundry";
+// --- Operation Names ---
+export const OperationName = {
+    CREATE_AGENT: "create_agent",
+    INVOKE_AGENT: "invoke_agent",
+    CHAT: "chat",
+    CREATE_CONVERSATION: "create_conversation",
+};
+// --- Metric Names ---
+export const GEN_AI_CLIENT_OPERATION_DURATION = "gen_ai.client.operation.duration";
+export const GEN_AI_CLIENT_TOKEN_USAGE = "gen_ai.client.token.usage";
+// --- Event Names ---
+export const GEN_AI_INPUT_MESSAGE_EVENT = "gen_ai.input.messages";
+export const GEN_AI_OUTPUT_MESSAGE_EVENT = "gen_ai.output.messages";
+export const GEN_AI_SYSTEM_INSTRUCTION_EVENT = "gen_ai.system.instructions";
+//# sourceMappingURL=constants.js.map

package/dist/browser/tracing/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/tracing/constants.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\n// --- GenAI Semantic Convention Attributes ---\n\n// Agent\nexport const GEN_AI_AGENT_ID = \"gen_ai.agent.id\";\nexport const GEN_AI_AGENT_NAME = \"gen_ai.agent.name\";\nexport const GEN_AI_AGENT_DESCRIPTION = \"gen_ai.agent.description\";\nexport const GEN_AI_AGENT_VERSION = \"gen_ai.agent.version\";\nexport const GEN_AI_AGENT_TYPE = \"gen_ai.agent.type\";\n\n// Hosted agent\nexport const GEN_AI_AGENT_HOSTED_CPU = \"gen_ai.agent.hosted.cpu\";\nexport const GEN_AI_AGENT_HOSTED_MEMORY = \"gen_ai.agent.hosted.memory\";\nexport const GEN_AI_AGENT_HOSTED_IMAGE = \"gen_ai.agent.hosted.image\";\nexport const GEN_AI_AGENT_HOSTED_PROTOCOL = \"gen_ai.agent.hosted.protocol\";\nexport const GEN_AI_AGENT_HOSTED_PROTOCOL_VERSION = \"gen_ai.agent.hosted.protocol_version\";\n\n// Operation\nexport const GEN_AI_OPERATION_NAME = \"gen_ai.operation.name\";\nexport const GEN_AI_SYSTEM = \"gen_ai.system\";\nexport const GEN_AI_PROVIDER_NAME = \"gen_ai.provider.name\";\n\n// Request (LLM model)\nexport const GEN_AI_REQUEST_MODEL = \"gen_ai.request.model\";\nexport const GEN_AI_REQUEST_TEMPERATURE = \"gen_ai.request.temperature\";\nexport const GEN_AI_REQUEST_TOP_P = \"gen_ai.request.top_p\";\nexport const GEN_AI_REQUEST_MAX_INPUT_TOKENS = \"gen_ai.request.max_input_tokens\";\nexport const GEN_AI_REQUEST_MAX_OUTPUT_TOKENS = \"gen_ai.request.max_output_tokens\";\nexport const GEN_AI_REQUEST_RESPONSE_FORMAT = \"gen_ai.request.response_format\";\nexport const GEN_AI_REQUEST_REASONING_EFFORT = \"gen_ai.request.reasoning.effort\";\nexport const GEN_AI_REQUEST_REASONING_SUMMARY = \"gen_ai.request.reasoning.summary\";\nexport const GEN_AI_REQUEST_TOOLS = \"gen_ai.request.tools\";\n\n// Response\nexport const GEN_AI_RESPONSE_MODEL = \"gen_ai.response.model\";\nexport const GEN_AI_RESPONSE_ID = \"gen_ai.response.id\";\nexport const GEN_AI_RESPONSE_FINISH_REASONS = \"gen_ai.response.finish_reasons\";\n\n// Usage\nexport const GEN_AI_USAGE_INPUT_TOKENS = \"gen_ai.usage.input_tokens\";\nexport const GEN_AI_USAGE_OUTPUT_TOKENS = \"gen_ai.usage.output_tokens\";\n\n// Tool\nexport const GEN_AI_TOOL_NAME = \"gen_ai.tool.name\";\nexport const GEN_AI_TOOL_CALL_ID = \"gen_ai.tool.call.id\";\n\n// Conversation\nexport const GEN_AI_CONVERSATION_ID = \"gen_ai.conversation.id\";\n\n// Messages (content recording)\nexport const GEN_AI_SYSTEM_MESSAGE = \"gen_ai.system_instructions\";\nexport const GEN_AI_INPUT_MESSAGES = \"gen_ai.input.messages\";\nexport const GEN_AI_OUTPUT_MESSAGES = \"gen_ai.output.messages\";\n\n// Server\nexport const SERVER_ADDRESS = \"server.address\";\nexport const SERVER_PORT = \"server.port\";\n\n// Azure\nexport const AZ_NAMESPACE = \"az.namespace\";\n\n// Error\nexport const ERROR_TYPE = \"error.type\";\n\n// Events\nexport const GEN_AI_EVENT_CONTENT = \"gen_ai.event.content\";\nexport const GEN_AI_WORKFLOW_ACTION_EVENT = \"gen_ai.workflow.action\";\nexport const GEN_AI_AGENT_WORKFLOW_EVENT = \"gen_ai.agent.workflow\";\n\n// --- Constant Values ---\n\nexport const AZ_AI_AGENT_SYSTEM = \"az.ai.agents\";\nexport const AZ_NAMESPACE_VALUE = \"Microsoft.CognitiveServices\";\nexport const AGENTS_PROVIDER = \"microsoft.foundry\";\n\n// --- Operation Names ---\n\nexport const OperationName = {\n  CREATE_AGENT: \"create_agent\",\n  INVOKE_AGENT: \"invoke_agent\",\n  CHAT: \"chat\",\n  CREATE_CONVERSATION: \"create_conversation\",\n} as const;\n\n// --- Metric Names ---\n\nexport const GEN_AI_CLIENT_OPERATION_DURATION = \"gen_ai.client.operation.duration\";\nexport const GEN_AI_CLIENT_TOKEN_USAGE = \"gen_ai.client.token.usage\";\n\n// --- Event Names ---\n\nexport const GEN_AI_INPUT_MESSAGE_EVENT = \"gen_ai.input.messages\";\nexport const GEN_AI_OUTPUT_MESSAGE_EVENT = \"gen_ai.output.messages\";\nexport const GEN_AI_SYSTEM_INSTRUCTION_EVENT = \"gen_ai.system.instructions\";\n"]}

package/dist/browser/tracing/formatters.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Formats input messages from a responses.create() body for span attributes.
+ * When content recording is disabled, content fields are omitted.
+ */
+export declare function formatInputMessages(body: Record<string, unknown>, contentRecording?: boolean): string | undefined;
+/**
+ * Formats output messages from a responses.create() result for span attributes.
+ * When content recording is disabled, only IDs and types are included.
+ */
+export declare function formatOutputMessages(response: Record<string, unknown>, contentRecording?: boolean): string | undefined;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/browser/tracing/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../../src/tracing/formatters.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,gBAAgB,GAAE,OAAe,GAChC,MAAM,GAAG,SAAS,CAsEpB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,gBAAgB,GAAE,OAAe,GAChC,MAAM,GAAG,SAAS,CAqDpB"}