@azure/ai-projects 2.4.0 → 2.5.0

package/dist/react-native/tracing/agentTracing.d.ts

@@ -0,0 +1,16 @@
+import type { Agent, AgentVersion } from "../models/models.js";
+import type { ResolvedTracingConfig } from "./configuration.js";
+/**
+ * Wraps an agent-create operation with tracing. When tracing is disabled,
+ * the operation is executed directly. When enabled, a span is created and
+ * the operation runs inside runInSpanContext so child spans (e.g. HTTP)
+ * are correctly parented.
+ * @internal
+ */
+export declare function traceAgentCreate(name: string, endpoint: string, tracingConfig: ResolvedTracingConfig | undefined, operation: () => Promise<Agent>): Promise<Agent>;
+/**
+ * Wraps an agent-version-create operation with tracing.
+ * @internal
+ */
+export declare function traceAgentVersionCreate(agentName: string, endpoint: string, tracingConfig: ResolvedTracingConfig | undefined, operation: () => Promise<AgentVersion>): Promise<AgentVersion>;
+//# sourceMappingURL=agentTracing.d.ts.map

package/dist/react-native/tracing/agentTracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentTracing.d.ts","sourceRoot":"","sources":["../../../src/tracing/agentTracing.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAUhE;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,qBAAqB,GAAG,SAAS,EAChD,SAAS,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,GAC9B,OAAO,CAAC,KAAK,CAAC,CAoBhB;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,qBAAqB,GAAG,SAAS,EAChD,SAAS,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,GACrC,OAAO,CAAC,YAAY,CAAC,CAoBvB"}

package/dist/react-native/tracing/agentTracing.js

@@ -0,0 +1,61 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { startSpan, runInSpanContext, SpanStatusCode } from "./tracingClient.js";
+import { setCommonAttributes, setAgentAttributes, setAgentVersionAttributes, setErrorAttributes, } from "./attributes.js";
+import { OperationName } from "./constants.js";
+/**
+ * Wraps an agent-create operation with tracing. When tracing is disabled,
+ * the operation is executed directly. When enabled, a span is created and
+ * the operation runs inside runInSpanContext so child spans (e.g. HTTP)
+ * are correctly parented.
+ * @internal
+ */
+export async function traceAgentCreate(name, endpoint, tracingConfig, operation) {
+    if (!tracingConfig?.enabled) {
+        return operation();
+    }
+    const { span, ctx } = startSpan(`${OperationName.CREATE_AGENT} ${name}`);
+    try {
+        setCommonAttributes(span, OperationName.CREATE_AGENT, endpoint);
+        const agent = await runInSpanContext(ctx, operation);
+        setAgentAttributes(span, agent, tracingConfig.contentRecording);
+        span.end();
+        return agent;
+    }
+    catch (error) {
+        setErrorAttributes(span, error);
+        span.setStatus({
+            code: SpanStatusCode.ERROR,
+            message: error instanceof Error ? error.name : "Error",
+        });
+        span.end();
+        throw error;
+    }
+}
+/**
+ * Wraps an agent-version-create operation with tracing.
+ * @internal
+ */
+export async function traceAgentVersionCreate(agentName, endpoint, tracingConfig, operation) {
+    if (!tracingConfig?.enabled) {
+        return operation();
+    }
+    const { span, ctx } = startSpan(`${OperationName.CREATE_AGENT} ${agentName}`);
+    try {
+        setCommonAttributes(span, OperationName.CREATE_AGENT, endpoint);
+        const version = await runInSpanContext(ctx, operation);
+        setAgentVersionAttributes(span, version, tracingConfig.contentRecording);
+        span.end();
+        return version;
+    }
+    catch (error) {
+        setErrorAttributes(span, error);
+        span.setStatus({
+            code: SpanStatusCode.ERROR,
+            message: error instanceof Error ? error.name : "Error",
+        });
+        span.end();
+        throw error;
+    }
+}
+//# sourceMappingURL=agentTracing.js.map

package/dist/react-native/tracing/agentTracing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentTracing.js","sourceRoot":"","sources":["../../../src/tracing/agentTracing.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAIlC,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAY,EACZ,QAAgB,EAChB,aAAgD,EAChD,SAA+B;IAE/B,IAAI,CAAC,aAAa,EAAE,OAAO,EAAE,CAAC;QAC5B,OAAO,SAAS,EAAE,CAAC;IACrB,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,aAAa,CAAC,YAAY,IAAI,IAAI,EAAE,CAAC,CAAC;IACzE,IAAI,CAAC;QACH,mBAAmB,CAAC,IAAI,EAAE,aAAa,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAChE,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACrD,kBAAkB,CAAC,IAAI,EAAE,KAAK,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;QAChE,IAAI,CAAC,GAAG,EAAE,CAAC;QACX,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAChC,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,cAAc,CAAC,KAAK;YAC1B,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO;SACvD,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,EAAE,CAAC;QACX,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,SAAiB,EACjB,QAAgB,EAChB,aAAgD,EAChD,SAAsC;IAEtC,IAAI,CAAC,aAAa,EAAE,OAAO,EAAE,CAAC;QAC5B,OAAO,SAAS,EAAE,CAAC;IACrB,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,aAAa,CAAC,YAAY,IAAI,SAAS,EAAE,CAAC,CAAC;IAC9E,IAAI,CAAC;QACH,mBAAmB,CAAC,IAAI,EAAE,aAAa,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACvD,yBAAyB,CAAC,IAAI,EAAE,OAAO,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;QACzE,IAAI,CAAC,GAAG,EAAE,CAAC;QACX,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAChC,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,cAAc,CAAC,KAAK;YAC1B,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO;SACvD,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,EAAE,CAAC;QACX,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { Agent, AgentVersion } from \"../models/models.js\";\nimport type { ResolvedTracingConfig } from \"./configuration.js\";\nimport { startSpan, runInSpanContext, SpanStatusCode } from \"./tracingClient.js\";\nimport {\n  setCommonAttributes,\n  setAgentAttributes,\n  setAgentVersionAttributes,\n  setErrorAttributes,\n} from \"./attributes.js\";\nimport { OperationName } from \"./constants.js\";\n\n/**\n * Wraps an agent-create operation with tracing. When tracing is disabled,\n * the operation is executed directly. When enabled, a span is created and\n * the operation runs inside runInSpanContext so child spans (e.g. HTTP)\n * are correctly parented.\n * @internal\n */\nexport async function traceAgentCreate(\n  name: string,\n  endpoint: string,\n  tracingConfig: ResolvedTracingConfig | undefined,\n  operation: () => Promise<Agent>,\n): Promise<Agent> {\n  if (!tracingConfig?.enabled) {\n    return operation();\n  }\n  const { span, ctx } = startSpan(`${OperationName.CREATE_AGENT} ${name}`);\n  try {\n    setCommonAttributes(span, OperationName.CREATE_AGENT, endpoint);\n    const agent = await runInSpanContext(ctx, operation);\n    setAgentAttributes(span, agent, tracingConfig.contentRecording);\n    span.end();\n    return agent;\n  } catch (error) {\n    setErrorAttributes(span, error);\n    span.setStatus({\n      code: SpanStatusCode.ERROR,\n      message: error instanceof Error ? error.name : \"Error\",\n    });\n    span.end();\n    throw error;\n  }\n}\n\n/**\n * Wraps an agent-version-create operation with tracing.\n * @internal\n */\nexport async function traceAgentVersionCreate(\n  agentName: string,\n  endpoint: string,\n  tracingConfig: ResolvedTracingConfig | undefined,\n  operation: () => Promise<AgentVersion>,\n): Promise<AgentVersion> {\n  if (!tracingConfig?.enabled) {\n    return operation();\n  }\n  const { span, ctx } = startSpan(`${OperationName.CREATE_AGENT} ${agentName}`);\n  try {\n    setCommonAttributes(span, OperationName.CREATE_AGENT, endpoint);\n    const version = await runInSpanContext(ctx, operation);\n    setAgentVersionAttributes(span, version, tracingConfig.contentRecording);\n    span.end();\n    return version;\n  } catch (error) {\n    setErrorAttributes(span, error);\n    span.setStatus({\n      code: SpanStatusCode.ERROR,\n      message: error instanceof Error ? error.name : \"Error\",\n    });\n    span.end();\n    throw error;\n  }\n}\n"]}

package/dist/react-native/tracing/configuration.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../../src/tracing/configuration.ts"],"names":[],"mappings":"AAKA;;;;;;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,CAyDzF"}

package/dist/react-native/tracing/configuration.js

@@ -1,5 +1,6 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
+import { logger } from "../logger.js";
 /**
  * Resolves tracing options into a frozen config object for the client instance.
  * For each setting not explicitly provided, the corresponding environment variable
@@ -24,7 +25,8 @@ export function resolveTracingConfig(options) {
             const envVal = process.env.AZURE_EXPERIMENTAL_ENABLE_GENAI_TRACING;
             experimental = !!envVal && (envVal.toLowerCase() === "true" || envVal === "1");
         }
-        catch {
+        catch (e) {
+            logger.verbose(`Unable to read AZURE_EXPERIMENTAL_ENABLE_GENAI_TRACING env var, tracing disabled: ${e}`);
             experimental = false;
         }
     }
@@ -42,7 +44,8 @@ export function resolveTracingConfig(options) {
             const envVal = process.env.OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT;
             contentRecording = !!envVal && (envVal.toLowerCase() === "true" || envVal === "1");
         }
-        catch {
+        catch (e) {
+            logger.verbose(`Unable to read OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT env var: ${e}`);
             contentRecording = false;
         }
     }
@@ -58,8 +61,8 @@ export function resolveTracingConfig(options) {
                 traceContextPropagation = false;
             }
         }
-        catch {
-            // process.env may not exist in browser environments
+        catch (e) {
+            logger.verbose(`Unable to read AZURE_TRACING_GEN_AI_ENABLE_TRACE_CONTEXT_PROPAGATION env var: ${e}`);
         }
     }
     return { enabled, contentRecording, traceContextPropagation };

package/dist/react-native/tracing/configuration.js.map

@@ -1 +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"]}
+{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../../../src/tracing/configuration.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAiDtC;;;;;;;;;;;;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,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,CAAC,OAAO,CACZ,qFAAqF,CAAC,EAAE,CACzF,CAAC;YACF,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,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,CAAC,OAAO,CACZ,8EAA8E,CAAC,EAAE,CAClF,CAAC;YACF,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,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,CAAC,OAAO,CACZ,iFAAiF,CAAC,EAAE,CACrF,CAAC;QACJ,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\nimport { logger } from \"../logger.js\";\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 (e) {\n      logger.verbose(\n        `Unable to read AZURE_EXPERIMENTAL_ENABLE_GENAI_TRACING env var, tracing disabled: ${e}`,\n      );\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 (e) {\n      logger.verbose(\n        `Unable to read OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT env var: ${e}`,\n      );\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 (e) {\n      logger.verbose(\n        `Unable to read AZURE_TRACING_GEN_AI_ENABLE_TRACE_CONTEXT_PROPAGATION env var: ${e}`,\n      );\n    }\n  }\n\n  return { enabled, contentRecording, traceContextPropagation };\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure/ai-projects",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "Azure AI Projects client library.",
   "engines": {
     "node": ">=22.0.0"
@@ -83,8 +83,8 @@
     "@azure-tools/test-credential": "^2.1.2",
     "@azure-tools/test-recorder": "^4.1.1",
     "@azure/dev-tool": "^1.0.0",
-    "@azure-tools/test-utils-vitest": "^2.0.1",
-    "@azure/eslint-plugin-azure-sdk": "^3.0.0"
+    "@azure/eslint-plugin-azure-sdk": "^3.0.0",
+    "@azure-tools/test-utils-vitest": "^2.0.1"
   },
   "exports": {
     "./package.json": "./package.json",