@azure/ai-projects 2.8.0 → 2.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +73 -5
- package/dist/browser/aiProjectClient.d.ts.map +1 -1
- package/dist/browser/aiProjectClient.js +1 -1
- package/dist/browser/aiProjectClient.js.map +1 -1
- package/dist/browser/classic/beta/agents/index.d.ts +2 -1
- package/dist/browser/classic/beta/agents/index.d.ts.map +1 -1
- package/dist/browser/classic/beta/agents/index.js +3 -2
- package/dist/browser/classic/beta/agents/index.js.map +1 -1
- package/dist/browser/classic/beta/index.d.ts +2 -1
- package/dist/browser/classic/beta/index.d.ts.map +1 -1
- package/dist/browser/classic/beta/index.js +3 -3
- package/dist/browser/classic/beta/index.js.map +1 -1
- package/dist/browser/classic/beta/voiceAgents/conversations/index.d.ts +2 -1
- package/dist/browser/classic/beta/voiceAgents/conversations/index.d.ts.map +1 -1
- package/dist/browser/classic/beta/voiceAgents/conversations/index.js +5 -4
- package/dist/browser/classic/beta/voiceAgents/conversations/index.js.map +1 -1
- package/dist/browser/classic/beta/voiceAgents/index.d.ts +3 -2
- package/dist/browser/classic/beta/voiceAgents/index.d.ts.map +1 -1
- package/dist/browser/classic/beta/voiceAgents/index.js +5 -5
- package/dist/browser/classic/beta/voiceAgents/index.js.map +1 -1
- package/dist/browser/classic/beta/voiceAgents/telephony/index.d.ts +2 -1
- package/dist/browser/classic/beta/voiceAgents/telephony/index.d.ts.map +1 -1
- package/dist/browser/classic/beta/voiceAgents/telephony/index.js +16 -11
- package/dist/browser/classic/beta/voiceAgents/telephony/index.js.map +1 -1
- package/dist/browser/constants.d.ts +1 -1
- package/dist/browser/constants.js +1 -1
- package/dist/browser/constants.js.map +1 -1
- package/dist/browser/index.d.ts +1 -1
- package/dist/browser/index.d.ts.map +1 -1
- package/dist/browser/index.js.map +1 -1
- package/dist/browser/models/index.d.ts +1 -1
- package/dist/browser/models/index.d.ts.map +1 -1
- package/dist/browser/models/index.js.map +1 -1
- package/dist/browser/models/models.d.ts +203 -158
- package/dist/browser/models/models.d.ts.map +1 -1
- package/dist/browser/models/models.js +129 -120
- package/dist/browser/models/models.js.map +1 -1
- package/dist/browser/package.json +1 -1
- package/dist/browser/realtime/voiceAgentRealtimeClient.d.ts +3 -0
- package/dist/browser/realtime/voiceAgentRealtimeClient.d.ts.map +1 -1
- package/dist/browser/realtime/voiceAgentRealtimeClient.js +39 -8
- package/dist/browser/realtime/voiceAgentRealtimeClient.js.map +1 -1
- package/dist/browser/tracing/configuration.d.ts +3 -5
- package/dist/browser/tracing/configuration.d.ts.map +1 -1
- package/dist/browser/tracing/configuration.js +8 -6
- package/dist/browser/tracing/configuration.js.map +1 -1
- package/dist/browser/tracing/tracingClient.d.ts +1 -1
- package/dist/browser/tracing/tracingClient.d.ts.map +1 -1
- package/dist/browser/tracing/tracingClient.js +2 -2
- package/dist/browser/tracing/tracingClient.js.map +1 -1
- package/dist/browser/tracing/voiceAgentTracing.d.ts +63 -0
- package/dist/browser/tracing/voiceAgentTracing.d.ts.map +1 -0
- package/dist/browser/tracing/voiceAgentTracing.js +740 -0
- package/dist/browser/tracing/voiceAgentTracing.js.map +1 -0
- package/dist/commonjs/aiProjectClient.d.ts.map +1 -1
- package/dist/commonjs/aiProjectClient.js +2 -1
- package/dist/commonjs/aiProjectClient.js.map +2 -2
- package/dist/commonjs/classic/beta/agents/index.d.ts +2 -1
- package/dist/commonjs/classic/beta/agents/index.d.ts.map +1 -1
- package/dist/commonjs/classic/beta/agents/index.js +9 -2
- package/dist/commonjs/classic/beta/agents/index.js.map +2 -2
- package/dist/commonjs/classic/beta/index.d.ts +2 -1
- package/dist/commonjs/classic/beta/index.d.ts.map +1 -1
- package/dist/commonjs/classic/beta/index.js +9 -3
- package/dist/commonjs/classic/beta/index.js.map +2 -2
- package/dist/commonjs/classic/beta/voiceAgents/conversations/index.d.ts +2 -1
- package/dist/commonjs/classic/beta/voiceAgents/conversations/index.d.ts.map +1 -1
- package/dist/commonjs/classic/beta/voiceAgents/conversations/index.js +10 -4
- package/dist/commonjs/classic/beta/voiceAgents/conversations/index.js.map +2 -2
- package/dist/commonjs/classic/beta/voiceAgents/index.d.ts +3 -2
- package/dist/commonjs/classic/beta/voiceAgents/index.d.ts.map +1 -1
- package/dist/commonjs/classic/beta/voiceAgents/index.js +4 -4
- package/dist/commonjs/classic/beta/voiceAgents/index.js.map +2 -2
- package/dist/commonjs/classic/beta/voiceAgents/telephony/index.d.ts +2 -1
- package/dist/commonjs/classic/beta/voiceAgents/telephony/index.d.ts.map +1 -1
- package/dist/commonjs/classic/beta/voiceAgents/telephony/index.js +33 -11
- package/dist/commonjs/classic/beta/voiceAgents/telephony/index.js.map +2 -2
- package/dist/commonjs/constants.d.ts +1 -1
- package/dist/commonjs/constants.js +1 -1
- package/dist/commonjs/constants.js.map +1 -1
- package/dist/commonjs/index.d.ts +1 -1
- package/dist/commonjs/index.d.ts.map +1 -1
- package/dist/commonjs/index.js.map +1 -1
- package/dist/commonjs/models/index.d.ts +1 -1
- package/dist/commonjs/models/index.d.ts.map +1 -1
- package/dist/commonjs/models/index.js.map +1 -1
- package/dist/commonjs/models/models.d.ts +203 -158
- package/dist/commonjs/models/models.d.ts.map +1 -1
- package/dist/commonjs/models/models.js +145 -106
- package/dist/commonjs/models/models.js.map +2 -2
- package/dist/commonjs/package.json +1 -1
- package/dist/commonjs/realtime/voiceAgentRealtimeClient.d.ts +3 -0
- package/dist/commonjs/realtime/voiceAgentRealtimeClient.d.ts.map +1 -1
- package/dist/commonjs/realtime/voiceAgentRealtimeClient.js +45 -17
- package/dist/commonjs/realtime/voiceAgentRealtimeClient.js.map +2 -2
- package/dist/commonjs/tracing/configuration.d.ts +3 -5
- package/dist/commonjs/tracing/configuration.d.ts.map +1 -1
- package/dist/commonjs/tracing/configuration.js +5 -1
- package/dist/commonjs/tracing/configuration.js.map +2 -2
- package/dist/commonjs/tracing/tracingClient.d.ts +1 -1
- package/dist/commonjs/tracing/tracingClient.d.ts.map +1 -1
- package/dist/commonjs/tracing/tracingClient.js +2 -2
- package/dist/commonjs/tracing/tracingClient.js.map +2 -2
- package/dist/commonjs/tracing/voiceAgentTracing.d.ts +63 -0
- package/dist/commonjs/tracing/voiceAgentTracing.d.ts.map +1 -0
- package/dist/commonjs/tracing/voiceAgentTracing.js +705 -0
- package/dist/commonjs/tracing/voiceAgentTracing.js.map +7 -0
- package/dist/commonjs/tsdoc-metadata.json +1 -1
- package/dist/esm/aiProjectClient.d.ts.map +1 -1
- package/dist/esm/aiProjectClient.js +1 -1
- package/dist/esm/aiProjectClient.js.map +1 -1
- package/dist/esm/classic/beta/agents/index.d.ts +2 -1
- package/dist/esm/classic/beta/agents/index.d.ts.map +1 -1
- package/dist/esm/classic/beta/agents/index.js +3 -2
- package/dist/esm/classic/beta/agents/index.js.map +1 -1
- package/dist/esm/classic/beta/index.d.ts +2 -1
- package/dist/esm/classic/beta/index.d.ts.map +1 -1
- package/dist/esm/classic/beta/index.js +3 -3
- package/dist/esm/classic/beta/index.js.map +1 -1
- package/dist/esm/classic/beta/voiceAgents/conversations/index.d.ts +2 -1
- package/dist/esm/classic/beta/voiceAgents/conversations/index.d.ts.map +1 -1
- package/dist/esm/classic/beta/voiceAgents/conversations/index.js +5 -4
- package/dist/esm/classic/beta/voiceAgents/conversations/index.js.map +1 -1
- package/dist/esm/classic/beta/voiceAgents/index.d.ts +3 -2
- package/dist/esm/classic/beta/voiceAgents/index.d.ts.map +1 -1
- package/dist/esm/classic/beta/voiceAgents/index.js +5 -5
- package/dist/esm/classic/beta/voiceAgents/index.js.map +1 -1
- package/dist/esm/classic/beta/voiceAgents/telephony/index.d.ts +2 -1
- package/dist/esm/classic/beta/voiceAgents/telephony/index.d.ts.map +1 -1
- package/dist/esm/classic/beta/voiceAgents/telephony/index.js +16 -11
- package/dist/esm/classic/beta/voiceAgents/telephony/index.js.map +1 -1
- package/dist/esm/constants.d.ts +1 -1
- package/dist/esm/constants.js +1 -1
- package/dist/esm/constants.js.map +1 -1
- package/dist/esm/index.d.ts +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/models/index.d.ts +1 -1
- package/dist/esm/models/index.d.ts.map +1 -1
- package/dist/esm/models/index.js.map +1 -1
- package/dist/esm/models/models.d.ts +203 -158
- package/dist/esm/models/models.d.ts.map +1 -1
- package/dist/esm/models/models.js +129 -120
- package/dist/esm/models/models.js.map +1 -1
- package/dist/esm/package.json +1 -1
- package/dist/esm/realtime/voiceAgentRealtimeClient.d.ts +3 -0
- package/dist/esm/realtime/voiceAgentRealtimeClient.d.ts.map +1 -1
- package/dist/esm/realtime/voiceAgentRealtimeClient.js +39 -8
- package/dist/esm/realtime/voiceAgentRealtimeClient.js.map +1 -1
- package/dist/esm/tracing/configuration.d.ts +3 -5
- package/dist/esm/tracing/configuration.d.ts.map +1 -1
- package/dist/esm/tracing/configuration.js +8 -6
- package/dist/esm/tracing/configuration.js.map +1 -1
- package/dist/esm/tracing/tracingClient.d.ts +1 -1
- package/dist/esm/tracing/tracingClient.d.ts.map +1 -1
- package/dist/esm/tracing/tracingClient.js +2 -2
- package/dist/esm/tracing/tracingClient.js.map +1 -1
- package/dist/esm/tracing/voiceAgentTracing.d.ts +63 -0
- package/dist/esm/tracing/voiceAgentTracing.d.ts.map +1 -0
- package/dist/esm/tracing/voiceAgentTracing.js +740 -0
- package/dist/esm/tracing/voiceAgentTracing.js.map +1 -0
- package/dist/react-native/aiProjectClient.d.ts.map +1 -1
- package/dist/react-native/aiProjectClient.js +1 -1
- package/dist/react-native/aiProjectClient.js.map +1 -1
- package/dist/react-native/classic/beta/agents/index.d.ts +2 -1
- package/dist/react-native/classic/beta/agents/index.d.ts.map +1 -1
- package/dist/react-native/classic/beta/agents/index.js +3 -2
- package/dist/react-native/classic/beta/agents/index.js.map +1 -1
- package/dist/react-native/classic/beta/index.d.ts +2 -1
- package/dist/react-native/classic/beta/index.d.ts.map +1 -1
- package/dist/react-native/classic/beta/index.js +3 -3
- package/dist/react-native/classic/beta/index.js.map +1 -1
- package/dist/react-native/classic/beta/voiceAgents/conversations/index.d.ts +2 -1
- package/dist/react-native/classic/beta/voiceAgents/conversations/index.d.ts.map +1 -1
- package/dist/react-native/classic/beta/voiceAgents/conversations/index.js +5 -4
- package/dist/react-native/classic/beta/voiceAgents/conversations/index.js.map +1 -1
- package/dist/react-native/classic/beta/voiceAgents/index.d.ts +3 -2
- package/dist/react-native/classic/beta/voiceAgents/index.d.ts.map +1 -1
- package/dist/react-native/classic/beta/voiceAgents/index.js +5 -5
- package/dist/react-native/classic/beta/voiceAgents/index.js.map +1 -1
- package/dist/react-native/classic/beta/voiceAgents/telephony/index.d.ts +2 -1
- package/dist/react-native/classic/beta/voiceAgents/telephony/index.d.ts.map +1 -1
- package/dist/react-native/classic/beta/voiceAgents/telephony/index.js +16 -11
- package/dist/react-native/classic/beta/voiceAgents/telephony/index.js.map +1 -1
- package/dist/react-native/constants.d.ts +1 -1
- package/dist/react-native/constants.js +1 -1
- package/dist/react-native/constants.js.map +1 -1
- package/dist/react-native/index.d.ts +1 -1
- package/dist/react-native/index.d.ts.map +1 -1
- package/dist/react-native/index.js.map +1 -1
- package/dist/react-native/models/index.d.ts +1 -1
- package/dist/react-native/models/index.d.ts.map +1 -1
- package/dist/react-native/models/index.js.map +1 -1
- package/dist/react-native/models/models.d.ts +203 -158
- package/dist/react-native/models/models.d.ts.map +1 -1
- package/dist/react-native/models/models.js +129 -120
- package/dist/react-native/models/models.js.map +1 -1
- package/dist/react-native/package.json +1 -1
- package/dist/react-native/realtime/voiceAgentRealtimeClient.d.ts +3 -0
- package/dist/react-native/realtime/voiceAgentRealtimeClient.d.ts.map +1 -1
- package/dist/react-native/realtime/voiceAgentRealtimeClient.js +39 -8
- package/dist/react-native/realtime/voiceAgentRealtimeClient.js.map +1 -1
- package/dist/react-native/tracing/configuration.d.ts +3 -5
- package/dist/react-native/tracing/configuration.d.ts.map +1 -1
- package/dist/react-native/tracing/configuration.js +8 -6
- package/dist/react-native/tracing/configuration.js.map +1 -1
- package/dist/react-native/tracing/tracingClient.d.ts +1 -1
- package/dist/react-native/tracing/tracingClient.d.ts.map +1 -1
- package/dist/react-native/tracing/tracingClient.js +2 -2
- package/dist/react-native/tracing/tracingClient.js.map +1 -1
- package/dist/react-native/tracing/voiceAgentTracing.d.ts +63 -0
- package/dist/react-native/tracing/voiceAgentTracing.d.ts.map +1 -0
- package/dist/react-native/tracing/voiceAgentTracing.js +740 -0
- package/dist/react-native/tracing/voiceAgentTracing.js.map +1 -0
- package/package.json +6 -6
|
@@ -4,6 +4,7 @@ import type { OperationOptions } from "@azure-rest/core-client";
|
|
|
4
4
|
import type { VoiceAgentClientEvent, VoiceAgentResponseCreateParams, VoiceAgentSessionUpdateConfig, VoiceAgentTransport } from "../models/models.js";
|
|
5
5
|
import type { VoiceAgentRealtimeEvent } from "./events.js";
|
|
6
6
|
import type { VoiceAgentWebSocketFactory } from "./webSocketTransportLike.js";
|
|
7
|
+
import type { ResolvedTracingConfig } from "../tracing/configuration.js";
|
|
7
8
|
/** Known values of {@link VoiceAgentConnectionState} reported by a voice-agent realtime connection. */
|
|
8
9
|
export declare const KnownVoiceAgentConnectionState: {
|
|
9
10
|
readonly Disconnected: "disconnected";
|
|
@@ -164,4 +165,6 @@ export declare class VoiceAgentRealtimeClient {
|
|
|
164
165
|
/** Establishes a WebSocket connection to a managed voice agent. */
|
|
165
166
|
connect(agentName: string, options?: VoiceAgentRealtimeClientConnectOptions): Promise<VoiceAgentConnection>;
|
|
166
167
|
}
|
|
168
|
+
/** Creates the project's realtime client using its already-resolved tracing settings. @internal */
|
|
169
|
+
export declare function createVoiceAgentRealtimeClient(endpoint: string, credential: TokenCredential, options: VoiceAgentRealtimeClientOptions | undefined, tracingConfig: ResolvedTracingConfig | undefined): VoiceAgentRealtimeClient;
|
|
167
170
|
//# sourceMappingURL=voiceAgentRealtimeClient.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"voiceAgentRealtimeClient.d.ts","sourceRoot":"","sources":["../../../src/realtime/voiceAgentRealtimeClient.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,OAAO,KAAK,EAEV,qBAAqB,EACrB,8BAA8B,EAC9B,6BAA6B,EAC7B,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAS7B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,KAAK,EACV,0BAA0B,EAE3B,MAAM,6BAA6B,CAAC;
|
|
1
|
+
{"version":3,"file":"voiceAgentRealtimeClient.d.ts","sourceRoot":"","sources":["../../../src/realtime/voiceAgentRealtimeClient.ts"],"names":[],"mappings":"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"}
|
|
@@ -6,6 +6,9 @@ import { logger } from "../logger.js";
|
|
|
6
6
|
import { AsyncQueue } from "./asyncQueue.js";
|
|
7
7
|
import { VoiceAgentAuthenticationError, VoiceAgentConnectionError, VoiceAgentProtocolError, } from "./errors.js";
|
|
8
8
|
import { deserializeVoiceAgentServerEvent, serializeVoiceAgentClientEvent } from "./protocol.js";
|
|
9
|
+
import { VoiceAgentRealtimeTracing } from "../tracing/voiceAgentTracing.js";
|
|
10
|
+
// Project-owned configuration stays private; the standalone constructor/options are unchanged.
|
|
11
|
+
const projectTracingConfigs = new WeakMap();
|
|
9
12
|
const defaultCredentialScope = "https://ai.azure.com/.default";
|
|
10
13
|
const voiceAgentsPreview = "VoiceAgents=V1Preview";
|
|
11
14
|
const reservedQueryParameters = new Set([
|
|
@@ -61,13 +64,30 @@ export class VoiceAgentRealtimeClient {
|
|
|
61
64
|
const serializedStructuredInputs = options.structuredInputs
|
|
62
65
|
? JSON.stringify(options.structuredInputs)
|
|
63
66
|
: undefined;
|
|
64
|
-
const
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
67
|
+
const tracingConfig = projectTracingConfigs.get(this);
|
|
68
|
+
const tracing = tracingConfig?.enabled
|
|
69
|
+
? new VoiceAgentRealtimeTracing(this.endpoint, tracingConfig, options.transport)
|
|
70
|
+
: undefined;
|
|
71
|
+
try {
|
|
72
|
+
const factory = this.options.webSocketFactory ??
|
|
73
|
+
(await import("../webSocketTransport.js")).createDefaultVoiceAgentWebSocketFactory();
|
|
74
|
+
const connection = new VoiceAgentConnectionImpl(url, agentName, this.credential, this.options, options, serializedStructuredInputs, factory, tracing);
|
|
75
|
+
await connection.open();
|
|
76
|
+
return connection;
|
|
77
|
+
}
|
|
78
|
+
catch (error) {
|
|
79
|
+
tracing?.close(undefined, false, error);
|
|
80
|
+
throw error;
|
|
81
|
+
}
|
|
69
82
|
}
|
|
70
83
|
}
|
|
84
|
+
/** Creates the project's realtime client using its already-resolved tracing settings. @internal */
|
|
85
|
+
export function createVoiceAgentRealtimeClient(endpoint, credential, options, tracingConfig) {
|
|
86
|
+
const client = new VoiceAgentRealtimeClient(endpoint, credential, options);
|
|
87
|
+
if (tracingConfig)
|
|
88
|
+
projectTracingConfigs.set(client, tracingConfig);
|
|
89
|
+
return client;
|
|
90
|
+
}
|
|
71
91
|
class VoiceAgentConnectionImpl {
|
|
72
92
|
url;
|
|
73
93
|
agentName;
|
|
@@ -75,6 +95,7 @@ class VoiceAgentConnectionImpl {
|
|
|
75
95
|
clientOptions;
|
|
76
96
|
connectOptions;
|
|
77
97
|
serializedStructuredInputs;
|
|
98
|
+
tracing;
|
|
78
99
|
events;
|
|
79
100
|
transport;
|
|
80
101
|
closePromise;
|
|
@@ -82,13 +103,14 @@ class VoiceAgentConnectionImpl {
|
|
|
82
103
|
currentState = KnownVoiceAgentConnectionState.Disconnected;
|
|
83
104
|
iteratorStarted = false;
|
|
84
105
|
finished = false;
|
|
85
|
-
constructor(url, agentName, credential, clientOptions, connectOptions, serializedStructuredInputs, factory) {
|
|
106
|
+
constructor(url, agentName, credential, clientOptions, connectOptions, serializedStructuredInputs, factory, tracing) {
|
|
86
107
|
this.url = url;
|
|
87
108
|
this.agentName = agentName;
|
|
88
109
|
this.credential = credential;
|
|
89
110
|
this.clientOptions = clientOptions;
|
|
90
111
|
this.connectOptions = connectOptions;
|
|
91
112
|
this.serializedStructuredInputs = serializedStructuredInputs;
|
|
113
|
+
this.tracing = tracing;
|
|
92
114
|
this.events = new AsyncQueue(10_000, {
|
|
93
115
|
onOverflow: (error) => this.handleEventQueueOverflow(error),
|
|
94
116
|
});
|
|
@@ -140,6 +162,7 @@ class VoiceAgentConnectionImpl {
|
|
|
140
162
|
connectionTimeoutInMs: this.connectOptions.connectionTimeoutInMs ?? this.clientOptions.connectionTimeoutInMs,
|
|
141
163
|
abortSignal: this.connectOptions.abortSignal,
|
|
142
164
|
});
|
|
165
|
+
this.tracing?.opened();
|
|
143
166
|
this.setState(KnownVoiceAgentConnectionState.Connected);
|
|
144
167
|
logger.info("Connected to voice agent", { agentName: this.agentName });
|
|
145
168
|
}
|
|
@@ -159,10 +182,15 @@ class VoiceAgentConnectionImpl {
|
|
|
159
182
|
if (options.abortSignal?.aborted) {
|
|
160
183
|
throw new VoiceAgentConnectionError("Send operation was cancelled.", "operationCancelled");
|
|
161
184
|
}
|
|
185
|
+
let reservation = undefined;
|
|
162
186
|
try {
|
|
163
|
-
|
|
187
|
+
const serialized = serializeVoiceAgentClientEvent(event);
|
|
188
|
+
reservation = this.tracing?.reserveSend(event);
|
|
189
|
+
await this.transport.send(serialized, options.abortSignal);
|
|
190
|
+
this.tracing?.sent(event, reservation);
|
|
164
191
|
}
|
|
165
192
|
catch (error) {
|
|
193
|
+
this.tracing?.sendFailed(error, reservation);
|
|
166
194
|
if (error instanceof VoiceAgentProtocolError) {
|
|
167
195
|
throw error;
|
|
168
196
|
}
|
|
@@ -264,7 +292,9 @@ class VoiceAgentConnectionImpl {
|
|
|
264
292
|
}
|
|
265
293
|
handleMessage(data) {
|
|
266
294
|
try {
|
|
267
|
-
|
|
295
|
+
const event = deserializeVoiceAgentServerEvent(data);
|
|
296
|
+
this.tracing?.received(event);
|
|
297
|
+
this.events.enqueue(event);
|
|
268
298
|
}
|
|
269
299
|
catch (error) {
|
|
270
300
|
const protocolError = error instanceof VoiceAgentProtocolError
|
|
@@ -309,6 +339,7 @@ class VoiceAgentConnectionImpl {
|
|
|
309
339
|
return;
|
|
310
340
|
}
|
|
311
341
|
this.finished = true;
|
|
342
|
+
this.tracing?.close(code, wasClean, error);
|
|
312
343
|
if (error) {
|
|
313
344
|
this.events.fail(error);
|
|
314
345
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"voiceAgentRealtimeClient.js","sourceRoot":"","sources":["../../../src/realtime/voiceAgentRealtimeClient.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { AbortSignalLike } from \"@azure/abort-controller\";\nimport type { TokenCredential } from \"@azure/core-auth\";\nimport type { OperationOptions } from \"@azure-rest/core-client\";\nimport { uint8ArrayToString } from \"@azure/core-util\";\nimport { SDK_VERSION } from \"../constants.js\";\nimport type {\n RealtimeConversationItemUnion,\n VoiceAgentClientEvent,\n VoiceAgentResponseCreateParams,\n VoiceAgentSessionUpdateConfig,\n VoiceAgentTransport,\n} from \"../models/models.js\";\nimport { logger } from \"../logger.js\";\nimport { AsyncQueue } from \"./asyncQueue.js\";\nimport {\n VoiceAgentAuthenticationError,\n VoiceAgentConnectionError,\n VoiceAgentProtocolError,\n} from \"./errors.js\";\nimport { deserializeVoiceAgentServerEvent, serializeVoiceAgentClientEvent } from \"./protocol.js\";\nimport type { VoiceAgentRealtimeEvent } from \"./events.js\";\nimport type {\n VoiceAgentWebSocketFactory,\n VoiceAgentWebSocketTransport,\n} from \"./webSocketTransportLike.js\";\n\nconst defaultCredentialScope = \"https://ai.azure.com/.default\";\nconst voiceAgentsPreview = \"VoiceAgents=V1Preview\";\nconst reservedQueryParameters = new Set([\n \"api-version\",\n \"agent_session_id\",\n \"store\",\n \"transport\",\n \"x-agent-version-override\",\n \"x-ms-client-sdk\",\n \"authorization\",\n \"api-key\",\n \"foundry_features\",\n \"foundry-features\",\n \"client-request-id\",\n \"x-ms-client-request-id\",\n \"structured_input\",\n \"structured_inputs\",\n \"x-ms-voice-structured-inputs\",\n]);\n\n/** Known values of {@link VoiceAgentConnectionState} reported by a voice-agent realtime connection. */\nexport const KnownVoiceAgentConnectionState = {\n Disconnected: \"disconnected\",\n Connecting: \"connecting\",\n Connected: \"connected\",\n Closing: \"closing\",\n} as const;\n\n/** Connection states reported by a voice-agent realtime connection. */\nexport type VoiceAgentConnectionState =\n (typeof KnownVoiceAgentConnectionState)[keyof typeof KnownVoiceAgentConnectionState];\n\n/** Called when a voice-agent connection changes state. */\nexport type VoiceAgentConnectionStateChangedHandler = (\n state: VoiceAgentConnectionState,\n previousState: VoiceAgentConnectionState,\n) => void;\n\n/** Options for the Voice Agents realtime client. */\nexport interface VoiceAgentRealtimeClientOptions {\n /** Microsoft Entra scopes used to acquire a WebSocket access token. */\n credentialScopes?: string | string[];\n /** Default connection timeout in milliseconds. */\n connectionTimeoutInMs?: number;\n /** API version sent during the WebSocket upgrade. */\n apiVersion?: string;\n /** Prefix added to the SDK user-agent value in Node.js. */\n userAgentPrefix?: string;\n /**\n * Overrides the transport used to establish the realtime WebSocket connection. Defaults to the\n * platform transport (`ws` in Node.js, the browser's native `WebSocket` in browsers/React Native).\n * Provide a custom factory to customize connection establishment.\n */\n webSocketFactory?: VoiceAgentWebSocketFactory;\n}\n\n/** Options for connecting the realtime client to a voice agent. */\nexport interface VoiceAgentRealtimeClientConnectOptions extends OperationOptions {\n /** Identifier used to correlate the voice session. */\n agentSessionId?: string;\n /** Overrides whether the conversation created by this session is persisted. */\n store?: boolean;\n /** Selects a specific immutable agent version. */\n agentVersionOverride?: string;\n /**\n * Selects the transport used for the realtime connection. Defaults to `\"websocket\"`. Set to\n * `\"webrtc\"` to negotiate a WebRTC peer connection instead; the caller is responsible for\n * completing the SDP offer/answer exchange using the `rtc.call.sdp.create` and\n * `rtc.call.sdp.created` events (see {@link VoiceAgentRealtimeEvent}).\n */\n transport?: VoiceAgentTransport;\n /**\n * Values used to render the agent's structured prompt inputs.\n * Serialized when `connect()` is called, before authentication.\n */\n structuredInputs?: Record<string, unknown>;\n /**\n * Additional query parameters for this connection's WebSocket upgrade URL.\n * Provide a plain object, including a null-prototype object.\n * Values override matching endpoint query parameters; `undefined` removes a parameter.\n * Values are URL-encoded automatically. Numbers must be finite.\n * SDK-managed parameters, authentication parameters, and names starting with `h-` are\n * reserved (case-insensitively) and cause a `TypeError`. Use the corresponding typed\n * options for session, version, storage, transport, and structured prompt inputs instead.\n * Both `structured_input` and `structured_inputs` are reserved.\n * Do not include secrets: query parameters can appear in server or proxy logs.\n */\n query?: Readonly<Record<string, string | number | boolean | undefined>>;\n /** Overrides the client connection timeout in milliseconds. */\n connectionTimeoutInMs?: number;\n /** Cancels the connection attempt. */\n abortSignal?: AbortSignalLike;\n /** Receives connection-state transitions. */\n onConnectionStateChange?: VoiceAgentConnectionStateChangedHandler;\n}\n\n/** Result supplied when a voice-agent connection closes. */\nexport interface VoiceAgentCloseResult {\n /** WebSocket close code. */\n code: number;\n /** WebSocket close reason. */\n reason: string;\n /** Whether the peer completed a normal WebSocket close handshake. */\n wasClean: boolean;\n /** Transport or protocol error associated with the close, if any. */\n error?: Error;\n}\n\n/** Options shared by realtime send operations. */\nexport interface VoiceAgentSendOptions extends OperationOptions {}\n\n/** Options shared by operations that build a protocol event on the caller's behalf. */\nexport interface VoiceAgentEventOptions extends VoiceAgentSendOptions {\n /** Client-generated event identifier. */\n eventId?: string;\n}\n\n/** Options shared by operations that add a conversation item and, by default, request a response. */\nexport interface VoiceAgentSendItemOptions extends VoiceAgentEventOptions {\n /** Whether to request a response after adding the item. Defaults to true. */\n createResponse?: boolean;\n}\n\n/** Options for sending text input. */\nexport interface VoiceAgentSendTextOptions extends VoiceAgentSendItemOptions {\n /** Item after which the new text item is inserted. */\n previousItemId?: string;\n}\n\n/** Options for returning a function result. */\nexport interface VoiceAgentSendToolOutputOptions extends VoiceAgentSendItemOptions {}\n\n/** Options for updating the live session. */\nexport interface VoiceAgentSessionUpdateOptions extends VoiceAgentEventOptions {}\n\n/** Options for creating a response. */\nexport interface VoiceAgentResponseOptions extends VoiceAgentEventOptions {\n /** Response-specific configuration. */\n response?: VoiceAgentResponseCreateParams;\n}\n\n/** Options for cancelling a response. */\nexport interface VoiceAgentCancelResponseOptions extends VoiceAgentEventOptions {\n /** Specific response to cancel. The active default-conversation response is used when omitted. */\n responseId?: string;\n}\n\n/**\n * A connected, bidirectional voice-agent stream.\n *\n * Supports exactly one `for await` iteration over server events; a second attempt throws.\n * Exiting the loop early (`break`, `return`, or an uncaught error in the loop body) closes\n * the connection as a side effect.\n * Unrecognized server event types are delivered as {@link VoiceAgentUnknownEvent} without\n * interrupting the stream. Malformed events still fail the iteration with a protocol error.\n */\nexport interface VoiceAgentConnection extends AsyncIterable<VoiceAgentRealtimeEvent> {\n /** Current connection state. */\n readonly state: VoiceAgentConnectionState;\n /** Resolves once the connection is closed. */\n readonly closed: Promise<VoiceAgentCloseResult>;\n /** Sends any generated client protocol event. */\n sendEvent(event: VoiceAgentClientEvent, options?: VoiceAgentSendOptions): Promise<void>;\n /** Updates supported live-session settings. */\n configureSession(\n session: VoiceAgentSessionUpdateConfig,\n options?: VoiceAgentSessionUpdateOptions,\n ): Promise<void>;\n /** Adds a user text item and, by default, requests a response. */\n sendText(text: string, options?: VoiceAgentSendTextOptions): Promise<void>;\n /** Appends base64-encoded audio bytes to the input buffer. */\n sendAudio(audio: Uint8Array | ArrayBuffer, options?: VoiceAgentEventOptions): Promise<void>;\n /** Commits buffered input audio. */\n commitAudio(options?: VoiceAgentEventOptions): Promise<void>;\n /** Clears buffered input audio. */\n clearInputAudio(options?: VoiceAgentEventOptions): Promise<void>;\n /** Clears pending output audio at the service. */\n clearOutputAudio(options?: VoiceAgentEventOptions): Promise<void>;\n /** Returns a client-executed function result to the agent. */\n sendToolOutput(\n callId: string,\n output: string,\n options?: VoiceAgentSendToolOutputOptions,\n ): Promise<void>;\n /** Requests a new response. */\n requestResponse(options?: VoiceAgentResponseOptions): Promise<void>;\n /** Cancels an in-progress response. */\n cancelResponse(options?: VoiceAgentCancelResponseOptions): Promise<void>;\n /** Gracefully closes the WebSocket connection. */\n close(code?: number, reason?: string): Promise<void>;\n /** Releases the connection. Equivalent to close(). */\n dispose(): Promise<void>;\n}\n\n/** Client for establishing realtime sessions with managed Foundry voice agents. */\nexport class VoiceAgentRealtimeClient {\n private readonly endpoint: string;\n private readonly credential: TokenCredential;\n private readonly options: Required<\n Pick<VoiceAgentRealtimeClientOptions, \"connectionTimeoutInMs\" | \"apiVersion\">\n > &\n VoiceAgentRealtimeClientOptions;\n\n public constructor(\n endpoint: string,\n credential: TokenCredential,\n options: VoiceAgentRealtimeClientOptions = {},\n ) {\n // Endpoint validation (https-only) is deferred to connect() so that merely constructing an\n // AIProjectClient (which eagerly creates this client) doesn't reject callers who intentionally\n // use an insecure local endpoint for the REST surface and never touch realtime connections.\n if (!endpoint.trim()) {\n throw new TypeError(\"endpoint must not be empty.\");\n }\n this.endpoint = endpoint;\n this.credential = credential;\n this.options = {\n ...options,\n connectionTimeoutInMs: options.connectionTimeoutInMs ?? 30_000,\n apiVersion: options.apiVersion ?? \"v1\",\n };\n }\n\n /** Establishes a WebSocket connection to a managed voice agent. */\n public async connect(\n agentName: string,\n options: VoiceAgentRealtimeClientConnectOptions = {},\n ): Promise<VoiceAgentConnection> {\n if (!agentName.trim()) {\n throw new TypeError(\"agentName must not be empty.\");\n }\n const url = buildWebSocketUrl(\n normalizeEndpoint(this.endpoint),\n agentName,\n this.options.apiVersion,\n options,\n );\n const serializedStructuredInputs = options.structuredInputs\n ? JSON.stringify(options.structuredInputs)\n : undefined;\n const factory =\n this.options.webSocketFactory ??\n (await import(\"#platform/webSocketTransport\")).createDefaultVoiceAgentWebSocketFactory();\n const connection = new VoiceAgentConnectionImpl(\n url,\n agentName,\n this.credential,\n this.options,\n options,\n serializedStructuredInputs,\n factory,\n );\n await connection.open();\n return connection;\n }\n}\n\nclass VoiceAgentConnectionImpl implements VoiceAgentConnection {\n private readonly events: AsyncQueue<VoiceAgentRealtimeEvent>;\n private readonly transport: VoiceAgentWebSocketTransport;\n private readonly closePromise: Promise<VoiceAgentCloseResult>;\n private resolveClose!: (result: VoiceAgentCloseResult) => void;\n private currentState: VoiceAgentConnectionState = KnownVoiceAgentConnectionState.Disconnected;\n private iteratorStarted = false;\n private finished = false;\n\n public constructor(\n private readonly url: string,\n private readonly agentName: string,\n private readonly credential: TokenCredential,\n private readonly clientOptions: VoiceAgentRealtimeClientOptions & {\n connectionTimeoutInMs: number;\n apiVersion: string;\n },\n private readonly connectOptions: VoiceAgentRealtimeClientConnectOptions,\n private readonly serializedStructuredInputs: string | undefined,\n factory: VoiceAgentWebSocketFactory,\n ) {\n this.events = new AsyncQueue<VoiceAgentRealtimeEvent>(10_000, {\n onOverflow: (error) => this.handleEventQueueOverflow(error),\n });\n this.transport = factory.create();\n this.closePromise = new Promise<VoiceAgentCloseResult>((resolve) => {\n this.resolveClose = resolve;\n });\n this.transport.setHandlers({\n onMessage: (data) => this.handleMessage(data),\n onClose: (code, reason, wasClean) => this.handleClose(code, reason, wasClean),\n onError: (error) => this.handleTransportError(error),\n });\n }\n\n public get state(): VoiceAgentConnectionState {\n return this.currentState;\n }\n\n public get closed(): Promise<VoiceAgentCloseResult> {\n return this.closePromise;\n }\n\n public async open(): Promise<void> {\n this.setState(KnownVoiceAgentConnectionState.Connecting);\n let token: string;\n try {\n const accessToken = await this.credential.getToken(\n this.clientOptions.credentialScopes ?? defaultCredentialScope,\n { abortSignal: this.connectOptions.abortSignal },\n );\n if (!accessToken) {\n throw new VoiceAgentAuthenticationError(\"The credential returned no access token.\");\n }\n token = accessToken.token;\n } catch (error) {\n if (this.connectOptions.abortSignal?.aborted) {\n const cancelledError = new VoiceAgentConnectionError(\n \"Voice-agent connection was cancelled.\",\n \"operationCancelled\",\n { cause: error },\n );\n this.finish(1006, cancelledError.message, false, cancelledError);\n throw cancelledError;\n }\n const authenticationError =\n error instanceof VoiceAgentAuthenticationError\n ? error\n : new VoiceAgentAuthenticationError(\"Failed to acquire a Voice Agents access token.\", {\n cause: error,\n });\n this.finish(1006, authenticationError.message, false, authenticationError);\n throw authenticationError;\n }\n\n try {\n await this.transport.connect({\n url: this.url,\n protocols: [\"realtime\"],\n headers: buildHeaders(token, this.clientOptions, this.serializedStructuredInputs),\n connectionTimeoutInMs:\n this.connectOptions.connectionTimeoutInMs ?? this.clientOptions.connectionTimeoutInMs,\n abortSignal: this.connectOptions.abortSignal,\n });\n this.setState(KnownVoiceAgentConnectionState.Connected);\n logger.info(\"Connected to voice agent\", { agentName: this.agentName });\n } catch (error) {\n const cancelled = this.connectOptions.abortSignal?.aborted === true;\n const connectionError = new VoiceAgentConnectionError(\n cancelled\n ? \"Voice-agent connection was cancelled.\"\n : \"Failed to connect to the voice agent.\",\n cancelled ? \"operationCancelled\" : \"connectionFailed\",\n { cause: error },\n );\n this.finish(1006, connectionError.message, false, connectionError);\n throw connectionError;\n }\n }\n\n public async sendEvent(\n event: VoiceAgentClientEvent,\n options: VoiceAgentSendOptions = {},\n ): Promise<void> {\n if (this.state !== KnownVoiceAgentConnectionState.Connected) {\n throw new VoiceAgentConnectionError(\n `Cannot send while the connection is ${this.state}.`,\n \"invalidState\",\n );\n }\n if (options.abortSignal?.aborted) {\n throw new VoiceAgentConnectionError(\"Send operation was cancelled.\", \"operationCancelled\");\n }\n\n try {\n await this.transport.send(serializeVoiceAgentClientEvent(event), options.abortSignal);\n } catch (error) {\n if (error instanceof VoiceAgentProtocolError) {\n throw error;\n }\n throw new VoiceAgentConnectionError(\"Failed to send a voice-agent event.\", \"sendFailed\", {\n cause: error,\n });\n }\n }\n\n public configureSession(\n session: VoiceAgentSessionUpdateConfig,\n options: VoiceAgentSessionUpdateOptions = {},\n ): Promise<void> {\n return this.sendEvent({ type: \"session.update\", event_id: options.eventId, session }, options);\n }\n\n public async sendText(text: string, options: VoiceAgentSendTextOptions = {}): Promise<void> {\n await this.sendEvent(\n {\n type: \"conversation.item.create\",\n event_id: options.eventId,\n previous_item_id: options.previousItemId,\n // `RealtimeConversationItemUnion` no longer enumerates a \"message\" item in the generated\n // models, but the wire protocol still accepts this shape; see the TypeSpec regeneration\n // report for details.\n item: {\n type: \"message\",\n role: \"user\",\n content: [{ type: \"input_text\", text }],\n } as unknown as RealtimeConversationItemUnion,\n },\n options,\n );\n if (options.createResponse !== false) {\n await this.requestResponse({ abortSignal: options.abortSignal });\n }\n }\n\n public sendAudio(\n audio: Uint8Array | ArrayBuffer,\n options: VoiceAgentEventOptions = {},\n ): Promise<void> {\n const bytes = audio instanceof Uint8Array ? audio : new Uint8Array(audio);\n return this.sendEvent(\n {\n type: \"input_audio_buffer.append\",\n event_id: options.eventId,\n audio: uint8ArrayToString(bytes, \"base64\"),\n },\n options,\n );\n }\n\n public commitAudio(options: VoiceAgentEventOptions = {}): Promise<void> {\n return this.sendEvent(\n { type: \"input_audio_buffer.commit\", event_id: options.eventId },\n options,\n );\n }\n\n public clearInputAudio(options: VoiceAgentEventOptions = {}): Promise<void> {\n return this.sendEvent({ type: \"input_audio_buffer.clear\", event_id: options.eventId }, options);\n }\n\n public clearOutputAudio(options: VoiceAgentEventOptions = {}): Promise<void> {\n return this.sendEvent(\n { type: \"output_audio_buffer.clear\", event_id: options.eventId },\n options,\n );\n }\n\n public async sendToolOutput(\n callId: string,\n output: string,\n options: VoiceAgentSendToolOutputOptions = {},\n ): Promise<void> {\n await this.sendEvent(\n {\n type: \"conversation.item.create\",\n event_id: options.eventId,\n item: { type: \"function_call_output\", call_id: callId, output },\n },\n options,\n );\n if (options.createResponse !== false) {\n await this.requestResponse({ abortSignal: options.abortSignal });\n }\n }\n\n public requestResponse(options: VoiceAgentResponseOptions = {}): Promise<void> {\n return this.sendEvent(\n { type: \"response.create\", event_id: options.eventId, response: options.response },\n options,\n );\n }\n\n public cancelResponse(options: VoiceAgentCancelResponseOptions = {}): Promise<void> {\n return this.sendEvent(\n { type: \"response.cancel\", event_id: options.eventId, response_id: options.responseId },\n options,\n );\n }\n\n public async close(\n code = 1000,\n reason = \"Client closed the voice-agent connection.\",\n ): Promise<void> {\n if (\n this.state === KnownVoiceAgentConnectionState.Disconnected ||\n this.state === KnownVoiceAgentConnectionState.Closing\n ) {\n await this.closed;\n return;\n }\n this.setState(KnownVoiceAgentConnectionState.Closing);\n try {\n await this.transport.close(code, reason);\n } finally {\n this.finish(code, reason, false);\n }\n }\n\n public dispose(): Promise<void> {\n return this.close();\n }\n\n public async *[Symbol.asyncIterator](): AsyncIterator<VoiceAgentRealtimeEvent> {\n if (this.iteratorStarted) {\n throw new VoiceAgentConnectionError(\n \"A voice-agent connection supports one active event iterator.\",\n \"invalidState\",\n );\n }\n this.iteratorStarted = true;\n try {\n while (true) {\n const result = await this.events.next();\n if (result.done) {\n return;\n }\n yield result.value;\n }\n } finally {\n if (this.state === KnownVoiceAgentConnectionState.Connected) {\n await this.close();\n }\n }\n }\n\n private handleMessage(data: string | ArrayBuffer): void {\n try {\n this.events.enqueue(deserializeVoiceAgentServerEvent(data));\n } catch (error) {\n const protocolError =\n error instanceof VoiceAgentProtocolError\n ? error\n : new VoiceAgentProtocolError(\"Failed to process a voice-agent event.\", { cause: error });\n // finish() closes the transport itself, so no additional close is needed here.\n this.finish(1002, protocolError.message, false, protocolError);\n }\n }\n\n private handleEventQueueOverflow(cause: Error): void {\n if (this.finished) {\n return;\n }\n const error = new VoiceAgentConnectionError(cause.message, \"connectionClosed\", {\n cause,\n });\n this.finish(1006, error.message, false, error);\n }\n\n private handleClose(code: number, reason: string, wasClean: boolean): void {\n if (this.finished) {\n return;\n }\n if (wasClean || this.state === KnownVoiceAgentConnectionState.Closing) {\n this.finish(code, reason, wasClean);\n } else {\n const error = new VoiceAgentConnectionError(\n `Voice-agent connection closed unexpectedly (${code}${reason ? `: ${reason}` : \"\"}).`,\n \"connectionClosed\",\n { closeCode: code },\n );\n this.finish(code, reason, false, error);\n }\n }\n\n private handleTransportError(cause: Error): void {\n if (this.finished) {\n return;\n }\n const error = new VoiceAgentConnectionError(\n \"Voice-agent WebSocket transport failed.\",\n \"connectionClosed\",\n {\n cause,\n },\n );\n this.finish(1006, cause.message, false, error);\n }\n\n private finish(code: number, reason: string, wasClean: boolean, error?: Error): void {\n if (this.finished) {\n return;\n }\n this.finished = true;\n if (error) {\n this.events.fail(error);\n } else {\n this.events.close();\n }\n this.setState(KnownVoiceAgentConnectionState.Disconnected);\n this.resolveClose({ code, reason, wasClean, error });\n logger.info(\"Voice-agent connection closed\", { code, reason, wasClean });\n // Ensure the socket never outlives the connection, even on paths that never closed it\n // themselves. Not awaited: finish() is synchronous because its callers are.\n void this.closeTransportQuietly(code, reason);\n }\n\n /**\n * Closes the transport, logging rather than rejecting: this is best-effort cleanup running after\n * the connection has already settled. A no-op if the transport is already closed.\n */\n private async closeTransportQuietly(code: number, reason: string): Promise<void> {\n try {\n await this.transport.close(code, reason);\n } catch (error) {\n logger.warning(\"Failed to close the voice-agent transport\", { error });\n }\n }\n\n private setState(state: VoiceAgentConnectionState): void {\n if (state === this.currentState) {\n return;\n }\n const previousState = this.currentState;\n this.currentState = state;\n try {\n this.connectOptions.onConnectionStateChange?.(state, previousState);\n } catch (error) {\n // A throwing caller callback must never interrupt connection lifecycle/cleanup.\n logger.warning(\"onConnectionStateChange callback threw an error\", { error });\n }\n }\n}\n\nfunction normalizeEndpoint(endpoint: string): string {\n const normalized = endpoint.trim();\n if (!normalized) {\n throw new TypeError(\"endpoint must not be empty.\");\n }\n const url = new URL(normalized.includes(\"://\") ? normalized : `https://${normalized}`);\n if (url.protocol !== \"https:\") {\n throw new TypeError(\n \"endpoint must use https; a plaintext endpoint would send the bearer token over an unencrypted connection.\",\n );\n }\n return url.toString();\n}\n\nfunction buildWebSocketUrl(\n endpoint: string,\n agentName: string,\n apiVersion: string,\n options: VoiceAgentRealtimeClientConnectOptions,\n): string {\n const url = new URL(endpoint);\n url.protocol = \"wss:\";\n url.pathname = `${url.pathname.replace(/\\/+$/, \"\")}/agents/${encodeURIComponent(agentName)}/endpoint/protocols/voice`;\n if (\n options.query !== undefined &&\n (options.query === null ||\n typeof options.query !== \"object\" ||\n ![Object.prototype, null].includes(Object.getPrototypeOf(options.query)))\n ) {\n throw new TypeError(\"query must be a record of query parameters.\");\n }\n for (const [name, value] of Object.entries(options.query ?? {})) {\n const normalizedName = name.toLowerCase();\n if (reservedQueryParameters.has(normalizedName) || normalizedName.startsWith(\"h-\")) {\n throw new TypeError(`Query parameter \"${name}\" is reserved; use the SDK's typed options.`);\n }\n if (value === undefined) {\n url.searchParams.delete(name);\n } else if (\n typeof value === \"string\" ||\n typeof value === \"boolean\" ||\n (typeof value === \"number\" && Number.isFinite(value))\n ) {\n url.searchParams.set(name, String(value));\n } else {\n throw new TypeError(\n `Query parameter \"${name}\" must be a string, boolean, finite number, or undefined.`,\n );\n }\n }\n url.searchParams.set(\"api-version\", apiVersion);\n url.searchParams.set(\"x-ms-client-sdk\", `azsdk-js-ai-projects/${SDK_VERSION}`);\n if (options.agentSessionId) {\n url.searchParams.set(\"agent_session_id\", options.agentSessionId);\n }\n if (options.store !== undefined) {\n url.searchParams.set(\"store\", String(options.store));\n }\n if (options.agentVersionOverride) {\n url.searchParams.set(\"x-agent-version-override\", options.agentVersionOverride);\n }\n if (options.transport) {\n url.searchParams.set(\"transport\", options.transport);\n }\n return url.toString();\n}\n\nfunction buildHeaders(\n token: string,\n clientOptions: VoiceAgentRealtimeClientOptions,\n serializedStructuredInputs: string | undefined,\n): Record<string, string> {\n const sdkUserAgent = `azsdk-js-ai-projects/${SDK_VERSION}`;\n const headers: Record<string, string> = {\n authorization: `Bearer ${token}`,\n \"foundry-features\": voiceAgentsPreview,\n \"x-ms-client-request-id\": createRequestId(),\n \"x-ms-client-sdk\": sdkUserAgent,\n \"user-agent\": clientOptions.userAgentPrefix\n ? `${clientOptions.userAgentPrefix} ${sdkUserAgent}`\n : sdkUserAgent,\n };\n if (serializedStructuredInputs !== undefined) {\n headers[\"x-ms-voice-structured-inputs\"] = serializedStructuredInputs;\n }\n return headers;\n}\n\nfunction createRequestId(): string {\n return (\n globalThis.crypto?.randomUUID?.() ?? `${Date.now()}-${Math.random().toString(36).slice(2)}`\n );\n}\n"]}
|
|
1
|
+
{"version":3,"file":"voiceAgentRealtimeClient.js","sourceRoot":"","sources":["../../../src/realtime/voiceAgentRealtimeClient.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAKlC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAQ9C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gCAAgC,EAAE,8BAA8B,EAAE,MAAM,eAAe,CAAC;AAOjG,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAE5E,+FAA+F;AAC/F,MAAM,qBAAqB,GAAG,IAAI,OAAO,EAAmD,CAAC;AAE7F,MAAM,sBAAsB,GAAG,+BAA+B,CAAC;AAC/D,MAAM,kBAAkB,GAAG,uBAAuB,CAAC;AACnD,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC;IACtC,aAAa;IACb,kBAAkB;IAClB,OAAO;IACP,WAAW;IACX,0BAA0B;IAC1B,iBAAiB;IACjB,eAAe;IACf,SAAS;IACT,kBAAkB;IAClB,kBAAkB;IAClB,mBAAmB;IACnB,wBAAwB;IACxB,kBAAkB;IAClB,mBAAmB;IACnB,8BAA8B;CAC/B,CAAC,CAAC;AAEH,uGAAuG;AACvG,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,YAAY,EAAE,cAAc;IAC5B,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;CACV,CAAC;AAwKX,mFAAmF;AACnF,MAAM,OAAO,wBAAwB;IAClB,QAAQ,CAAS;IACjB,UAAU,CAAkB;IAC5B,OAAO,CAGU;IAElC,YACE,QAAgB,EAChB,UAA2B,EAC3B,UAA2C,EAAE;QAE7C,2FAA2F;QAC3F,+FAA+F;QAC/F,4FAA4F;QAC5F,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;YACrB,MAAM,IAAI,SAAS,CAAC,6BAA6B,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG;YACb,GAAG,OAAO;YACV,qBAAqB,EAAE,OAAO,CAAC,qBAAqB,IAAI,MAAM;YAC9D,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;SACvC,CAAC;IACJ,CAAC;IAED,mEAAmE;IAC5D,KAAK,CAAC,OAAO,CAClB,SAAiB,EACjB,UAAkD,EAAE;QAEpD,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC;YACtB,MAAM,IAAI,SAAS,CAAC,8BAA8B,CAAC,CAAC;QACtD,CAAC;QACD,MAAM,GAAG,GAAG,iBAAiB,CAC3B,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAChC,SAAS,EACT,IAAI,CAAC,OAAO,CAAC,UAAU,EACvB,OAAO,CACR,CAAC;QACF,MAAM,0BAA0B,GAAG,OAAO,CAAC,gBAAgB;YACzD,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,gBAAgB,CAAC;YAC1C,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,aAAa,GAAG,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,aAAa,EAAE,OAAO;YACpC,CAAC,CAAC,IAAI,yBAAyB,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,CAAC,SAAS,CAAC;YAChF,CAAC,CAAC,SAAS,CAAC;QACd,IAAI,CAAC;YACH,MAAM,OAAO,GACX,IAAI,CAAC,OAAO,CAAC,gBAAgB;gBAC7B,CAAC,MAAM,MAAM,CAAC,8BAA8B,CAAC,CAAC,CAAC,uCAAuC,EAAE,CAAC;YAC3F,MAAM,UAAU,GAAG,IAAI,wBAAwB,CAC7C,GAAG,EACH,SAAS,EACT,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,OAAO,EACZ,OAAO,EACP,0BAA0B,EAC1B,OAAO,EACP,OAAO,CACR,CAAC;YACF,MAAM,UAAU,CAAC,IAAI,EAAE,CAAC;YACxB,OAAO,UAAU,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YACxC,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF;AAED,mGAAmG;AACnG,MAAM,UAAU,8BAA8B,CAC5C,QAAgB,EAChB,UAA2B,EAC3B,OAAoD,EACpD,aAAgD;IAEhD,MAAM,MAAM,GAAG,IAAI,wBAAwB,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAC3E,IAAI,aAAa;QAAE,qBAAqB,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACpE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,wBAAwB;IAUT;IACA;IACA;IACA;IAIA;IACA;IAEA;IAnBF,MAAM,CAAsC;IAC5C,SAAS,CAA+B;IACxC,YAAY,CAAiC;IACtD,YAAY,CAA2C;IACvD,YAAY,GAA8B,8BAA8B,CAAC,YAAY,CAAC;IACtF,eAAe,GAAG,KAAK,CAAC;IACxB,QAAQ,GAAG,KAAK,CAAC;IAEzB,YACmB,GAAW,EACX,SAAiB,EACjB,UAA2B,EAC3B,aAGhB,EACgB,cAAsD,EACtD,0BAA8C,EAC/D,OAAmC,EAClB,OAAmC;QAVnC,QAAG,GAAH,GAAG,CAAQ;QACX,cAAS,GAAT,SAAS,CAAQ;QACjB,eAAU,GAAV,UAAU,CAAiB;QAC3B,kBAAa,GAAb,aAAa,CAG7B;QACgB,mBAAc,GAAd,cAAc,CAAwC;QACtD,+BAA0B,GAA1B,0BAA0B,CAAoB;QAE9C,YAAO,GAAP,OAAO,CAA4B;QAEpD,IAAI,CAAC,MAAM,GAAG,IAAI,UAAU,CAA0B,MAAM,EAAE;YAC5D,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC;SAC5D,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAClC,IAAI,CAAC,YAAY,GAAG,IAAI,OAAO,CAAwB,CAAC,OAAO,EAAE,EAAE;YACjE,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;QAC9B,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;YACzB,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;YAC7C,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC;YAC7E,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC;SACrD,CAAC,CAAC;IACL,CAAC;IAED,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAEM,KAAK,CAAC,IAAI;QACf,IAAI,CAAC,QAAQ,CAAC,8BAA8B,CAAC,UAAU,CAAC,CAAC;QACzD,IAAI,KAAa,CAAC;QAClB,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAChD,IAAI,CAAC,aAAa,CAAC,gBAAgB,IAAI,sBAAsB,EAC7D,EAAE,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,CACjD,CAAC;YACF,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,IAAI,6BAA6B,CAAC,0CAA0C,CAAC,CAAC;YACtF,CAAC;YACD,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC;gBAC7C,MAAM,cAAc,GAAG,IAAI,yBAAyB,CAClD,uCAAuC,EACvC,oBAAoB,EACpB,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;gBACF,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;gBACjE,MAAM,cAAc,CAAC;YACvB,CAAC;YACD,MAAM,mBAAmB,GACvB,KAAK,YAAY,6BAA6B;gBAC5C,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,IAAI,6BAA6B,CAAC,gDAAgD,EAAE;oBAClF,KAAK,EAAE,KAAK;iBACb,CAAC,CAAC;YACT,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,mBAAmB,CAAC,OAAO,EAAE,KAAK,EAAE,mBAAmB,CAAC,CAAC;YAC3E,MAAM,mBAAmB,CAAC;QAC5B,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;gBAC3B,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,SAAS,EAAE,CAAC,UAAU,CAAC;gBACvB,OAAO,EAAE,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,0BAA0B,CAAC;gBACjF,qBAAqB,EACnB,IAAI,CAAC,cAAc,CAAC,qBAAqB,IAAI,IAAI,CAAC,aAAa,CAAC,qBAAqB;gBACvF,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC,WAAW;aAC7C,CAAC,CAAC;YACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;YACvB,IAAI,CAAC,QAAQ,CAAC,8BAA8B,CAAC,SAAS,CAAC,CAAC;YACxD,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QACzE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,OAAO,KAAK,IAAI,CAAC;YACpE,MAAM,eAAe,GAAG,IAAI,yBAAyB,CACnD,SAAS;gBACP,CAAC,CAAC,uCAAuC;gBACzC,CAAC,CAAC,uCAAuC,EAC3C,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,kBAAkB,EACrD,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;YACF,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;YACnE,MAAM,eAAe,CAAC;QACxB,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,SAAS,CACpB,KAA4B,EAC5B,UAAiC,EAAE;QAEnC,IAAI,IAAI,CAAC,KAAK,KAAK,8BAA8B,CAAC,SAAS,EAAE,CAAC;YAC5D,MAAM,IAAI,yBAAyB,CACjC,uCAAuC,IAAI,CAAC,KAAK,GAAG,EACpD,cAAc,CACf,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC;YACjC,MAAM,IAAI,yBAAyB,CAAC,+BAA+B,EAAE,oBAAoB,CAAC,CAAC;QAC7F,CAAC;QAED,IAAI,WAAW,GAAyD,SAAS,CAAC;QAClF,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,8BAA8B,CAAC,KAAK,CAAC,CAAC;YACzD,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC;YAC/C,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;YAC3D,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;YAC7C,IAAI,KAAK,YAAY,uBAAuB,EAAE,CAAC;gBAC7C,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,IAAI,yBAAyB,CAAC,qCAAqC,EAAE,YAAY,EAAE;gBACvF,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEM,gBAAgB,CACrB,OAAsC,EACtC,UAA0C,EAAE;QAE5C,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IACjG,CAAC;IAEM,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,UAAqC,EAAE;QACzE,MAAM,IAAI,CAAC,SAAS,CAClB;YACE,IAAI,EAAE,0BAA0B;YAChC,QAAQ,EAAE,OAAO,CAAC,OAAO;YACzB,gBAAgB,EAAE,OAAO,CAAC,cAAc;YACxC,yFAAyF;YACzF,wFAAwF;YACxF,sBAAsB;YACtB,IAAI,EAAE;gBACJ,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;aACI;SAC9C,EACD,OAAO,CACR,CAAC;QACF,IAAI,OAAO,CAAC,cAAc,KAAK,KAAK,EAAE,CAAC;YACrC,MAAM,IAAI,CAAC,eAAe,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAEM,SAAS,CACd,KAA+B,EAC/B,UAAkC,EAAE;QAEpC,MAAM,KAAK,GAAG,KAAK,YAAY,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;QAC1E,OAAO,IAAI,CAAC,SAAS,CACnB;YACE,IAAI,EAAE,2BAA2B;YACjC,QAAQ,EAAE,OAAO,CAAC,OAAO;YACzB,KAAK,EAAE,kBAAkB,CAAC,KAAK,EAAE,QAAQ,CAAC;SAC3C,EACD,OAAO,CACR,CAAC;IACJ,CAAC;IAEM,WAAW,CAAC,UAAkC,EAAE;QACrD,OAAO,IAAI,CAAC,SAAS,CACnB,EAAE,IAAI,EAAE,2BAA2B,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,EAChE,OAAO,CACR,CAAC;IACJ,CAAC;IAEM,eAAe,CAAC,UAAkC,EAAE;QACzD,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,0BAA0B,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IAClG,CAAC;IAEM,gBAAgB,CAAC,UAAkC,EAAE;QAC1D,OAAO,IAAI,CAAC,SAAS,CACnB,EAAE,IAAI,EAAE,2BAA2B,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,EAChE,OAAO,CACR,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,cAAc,CACzB,MAAc,EACd,MAAc,EACd,UAA2C,EAAE;QAE7C,MAAM,IAAI,CAAC,SAAS,CAClB;YACE,IAAI,EAAE,0BAA0B;YAChC,QAAQ,EAAE,OAAO,CAAC,OAAO;YACzB,IAAI,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE;SAChE,EACD,OAAO,CACR,CAAC;QACF,IAAI,OAAO,CAAC,cAAc,KAAK,KAAK,EAAE,CAAC;YACrC,MAAM,IAAI,CAAC,eAAe,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAEM,eAAe,CAAC,UAAqC,EAAE;QAC5D,OAAO,IAAI,CAAC,SAAS,CACnB,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,EAClF,OAAO,CACR,CAAC;IACJ,CAAC;IAEM,cAAc,CAAC,UAA2C,EAAE;QACjE,OAAO,IAAI,CAAC,SAAS,CACnB,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,UAAU,EAAE,EACvF,OAAO,CACR,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,KAAK,CAChB,IAAI,GAAG,IAAI,EACX,MAAM,GAAG,2CAA2C;QAEpD,IACE,IAAI,CAAC,KAAK,KAAK,8BAA8B,CAAC,YAAY;YAC1D,IAAI,CAAC,KAAK,KAAK,8BAA8B,CAAC,OAAO,EACrD,CAAC;YACD,MAAM,IAAI,CAAC,MAAM,CAAC;YAClB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,8BAA8B,CAAC,OAAO,CAAC,CAAC;QACtD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC3C,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAEM,OAAO;QACZ,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAEM,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;QAClC,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,MAAM,IAAI,yBAAyB,CACjC,8DAA8D,EAC9D,cAAc,CACf,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC5B,IAAI,CAAC;YACH,OAAO,IAAI,EAAE,CAAC;gBACZ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBACxC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;oBAChB,OAAO;gBACT,CAAC;gBACD,MAAM,MAAM,CAAC,KAAK,CAAC;YACrB,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,IAAI,CAAC,KAAK,KAAK,8BAA8B,CAAC,SAAS,EAAE,CAAC;gBAC5D,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,IAA0B;QAC9C,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,gCAAgC,CAAC,IAAI,CAAC,CAAC;YACrD,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,aAAa,GACjB,KAAK,YAAY,uBAAuB;gBACtC,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,IAAI,uBAAuB,CAAC,wCAAwC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YAC9F,+EAA+E;YAC/E,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAEO,wBAAwB,CAAC,KAAY;QAC3C,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,yBAAyB,CAAC,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE;YAC7E,KAAK;SACN,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;IAEO,WAAW,CAAC,IAAY,EAAE,MAAc,EAAE,QAAiB;QACjE,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,IAAI,QAAQ,IAAI,IAAI,CAAC,KAAK,KAAK,8BAA8B,CAAC,OAAO,EAAE,CAAC;YACtE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,GAAG,IAAI,yBAAyB,CACzC,+CAA+C,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EACrF,kBAAkB,EAClB,EAAE,SAAS,EAAE,IAAI,EAAE,CACpB,CAAC;YACF,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAEO,oBAAoB,CAAC,KAAY;QACvC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,yBAAyB,CACzC,yCAAyC,EACzC,kBAAkB,EAClB;YACE,KAAK;SACN,CACF,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;IAEO,MAAM,CAAC,IAAY,EAAE,MAAc,EAAE,QAAiB,EAAE,KAAa;QAC3E,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC3C,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,8BAA8B,CAAC,YAAY,CAAC,CAAC;QAC3D,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QACrD,MAAM,CAAC,IAAI,CAAC,+BAA+B,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QACzE,sFAAsF;QACtF,4EAA4E;QAC5E,KAAK,IAAI,CAAC,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,qBAAqB,CAAC,IAAY,EAAE,MAAc;QAC9D,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,OAAO,CAAC,2CAA2C,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAEO,QAAQ,CAAC,KAAgC;QAC/C,IAAI,KAAK,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;YAChC,OAAO;QACT,CAAC;QACD,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,CAAC;QACxC,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,IAAI,CAAC;YACH,IAAI,CAAC,cAAc,CAAC,uBAAuB,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QACtE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,gFAAgF;YAChF,MAAM,CAAC,OAAO,CAAC,iDAAiD,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;CACF;AAED,SAAS,iBAAiB,CAAC,QAAgB;IACzC,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,SAAS,CAAC,6BAA6B,CAAC,CAAC;IACrD,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,UAAU,EAAE,CAAC,CAAC;IACvF,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,SAAS,CACjB,2GAA2G,CAC5G,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC;AAED,SAAS,iBAAiB,CACxB,QAAgB,EAChB,SAAiB,EACjB,UAAkB,EAClB,OAA+C;IAE/C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9B,GAAG,CAAC,QAAQ,GAAG,MAAM,CAAC;IACtB,GAAG,CAAC,QAAQ,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,WAAW,kBAAkB,CAAC,SAAS,CAAC,2BAA2B,CAAC;IACtH,IACE,OAAO,CAAC,KAAK,KAAK,SAAS;QAC3B,CAAC,OAAO,CAAC,KAAK,KAAK,IAAI;YACrB,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ;YACjC,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAC3E,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,6CAA6C,CAAC,CAAC;IACrE,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;QAChE,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1C,IAAI,uBAAuB,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACnF,MAAM,IAAI,SAAS,CAAC,oBAAoB,IAAI,6CAA6C,CAAC,CAAC;QAC7F,CAAC;QACD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;aAAM,IACL,OAAO,KAAK,KAAK,QAAQ;YACzB,OAAO,KAAK,KAAK,SAAS;YAC1B,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EACrD,CAAC;YACD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,SAAS,CACjB,oBAAoB,IAAI,2DAA2D,CACpF,CAAC;QACJ,CAAC;IACH,CAAC;IACD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IAChD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,iBAAiB,EAAE,wBAAwB,WAAW,EAAE,CAAC,CAAC;IAC/E,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;QAC3B,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,kBAAkB,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;QACjC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,0BAA0B,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC;AAED,SAAS,YAAY,CACnB,KAAa,EACb,aAA8C,EAC9C,0BAA8C;IAE9C,MAAM,YAAY,GAAG,wBAAwB,WAAW,EAAE,CAAC;IAC3D,MAAM,OAAO,GAA2B;QACtC,aAAa,EAAE,UAAU,KAAK,EAAE;QAChC,kBAAkB,EAAE,kBAAkB;QACtC,wBAAwB,EAAE,eAAe,EAAE;QAC3C,iBAAiB,EAAE,YAAY;QAC/B,YAAY,EAAE,aAAa,CAAC,eAAe;YACzC,CAAC,CAAC,GAAG,aAAa,CAAC,eAAe,IAAI,YAAY,EAAE;YACpD,CAAC,CAAC,YAAY;KACjB,CAAC;IACF,IAAI,0BAA0B,KAAK,SAAS,EAAE,CAAC;QAC7C,OAAO,CAAC,8BAA8B,CAAC,GAAG,0BAA0B,CAAC;IACvE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,eAAe;IACtB,OAAO,CACL,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAC5F,CAAC;AACJ,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { AbortSignalLike } from \"@azure/abort-controller\";\nimport type { TokenCredential } from \"@azure/core-auth\";\nimport type { OperationOptions } from \"@azure-rest/core-client\";\nimport { uint8ArrayToString } from \"@azure/core-util\";\nimport { SDK_VERSION } from \"../constants.js\";\nimport type {\n RealtimeConversationItemUnion,\n VoiceAgentClientEvent,\n VoiceAgentResponseCreateParams,\n VoiceAgentSessionUpdateConfig,\n VoiceAgentTransport,\n} from \"../models/models.js\";\nimport { logger } from \"../logger.js\";\nimport { AsyncQueue } from \"./asyncQueue.js\";\nimport {\n VoiceAgentAuthenticationError,\n VoiceAgentConnectionError,\n VoiceAgentProtocolError,\n} from \"./errors.js\";\nimport { deserializeVoiceAgentServerEvent, serializeVoiceAgentClientEvent } from \"./protocol.js\";\nimport type { VoiceAgentRealtimeEvent } from \"./events.js\";\nimport type {\n VoiceAgentWebSocketFactory,\n VoiceAgentWebSocketTransport,\n} from \"./webSocketTransportLike.js\";\nimport type { ResolvedTracingConfig } from \"../tracing/configuration.js\";\nimport { VoiceAgentRealtimeTracing } from \"../tracing/voiceAgentTracing.js\";\n\n// Project-owned configuration stays private; the standalone constructor/options are unchanged.\nconst projectTracingConfigs = new WeakMap<VoiceAgentRealtimeClient, ResolvedTracingConfig>();\n\nconst defaultCredentialScope = \"https://ai.azure.com/.default\";\nconst voiceAgentsPreview = \"VoiceAgents=V1Preview\";\nconst reservedQueryParameters = new Set([\n \"api-version\",\n \"agent_session_id\",\n \"store\",\n \"transport\",\n \"x-agent-version-override\",\n \"x-ms-client-sdk\",\n \"authorization\",\n \"api-key\",\n \"foundry_features\",\n \"foundry-features\",\n \"client-request-id\",\n \"x-ms-client-request-id\",\n \"structured_input\",\n \"structured_inputs\",\n \"x-ms-voice-structured-inputs\",\n]);\n\n/** Known values of {@link VoiceAgentConnectionState} reported by a voice-agent realtime connection. */\nexport const KnownVoiceAgentConnectionState = {\n Disconnected: \"disconnected\",\n Connecting: \"connecting\",\n Connected: \"connected\",\n Closing: \"closing\",\n} as const;\n\n/** Connection states reported by a voice-agent realtime connection. */\nexport type VoiceAgentConnectionState =\n (typeof KnownVoiceAgentConnectionState)[keyof typeof KnownVoiceAgentConnectionState];\n\n/** Called when a voice-agent connection changes state. */\nexport type VoiceAgentConnectionStateChangedHandler = (\n state: VoiceAgentConnectionState,\n previousState: VoiceAgentConnectionState,\n) => void;\n\n/** Options for the Voice Agents realtime client. */\nexport interface VoiceAgentRealtimeClientOptions {\n /** Microsoft Entra scopes used to acquire a WebSocket access token. */\n credentialScopes?: string | string[];\n /** Default connection timeout in milliseconds. */\n connectionTimeoutInMs?: number;\n /** API version sent during the WebSocket upgrade. */\n apiVersion?: string;\n /** Prefix added to the SDK user-agent value in Node.js. */\n userAgentPrefix?: string;\n /**\n * Overrides the transport used to establish the realtime WebSocket connection. Defaults to the\n * platform transport (`ws` in Node.js, the browser's native `WebSocket` in browsers/React Native).\n * Provide a custom factory to customize connection establishment.\n */\n webSocketFactory?: VoiceAgentWebSocketFactory;\n}\n\n/** Options for connecting the realtime client to a voice agent. */\nexport interface VoiceAgentRealtimeClientConnectOptions extends OperationOptions {\n /** Identifier used to correlate the voice session. */\n agentSessionId?: string;\n /** Overrides whether the conversation created by this session is persisted. */\n store?: boolean;\n /** Selects a specific immutable agent version. */\n agentVersionOverride?: string;\n /**\n * Selects the transport used for the realtime connection. Defaults to `\"websocket\"`. Set to\n * `\"webrtc\"` to negotiate a WebRTC peer connection instead; the caller is responsible for\n * completing the SDP offer/answer exchange using the `rtc.call.sdp.create` and\n * `rtc.call.sdp.created` events (see {@link VoiceAgentRealtimeEvent}).\n */\n transport?: VoiceAgentTransport;\n /**\n * Values used to render the agent's structured prompt inputs.\n * Serialized when `connect()` is called, before authentication.\n */\n structuredInputs?: Record<string, unknown>;\n /**\n * Additional query parameters for this connection's WebSocket upgrade URL.\n * Provide a plain object, including a null-prototype object.\n * Values override matching endpoint query parameters; `undefined` removes a parameter.\n * Values are URL-encoded automatically. Numbers must be finite.\n * SDK-managed parameters, authentication parameters, and names starting with `h-` are\n * reserved (case-insensitively) and cause a `TypeError`. Use the corresponding typed\n * options for session, version, storage, transport, and structured prompt inputs instead.\n * Both `structured_input` and `structured_inputs` are reserved.\n * Do not include secrets: query parameters can appear in server or proxy logs.\n */\n query?: Readonly<Record<string, string | number | boolean | undefined>>;\n /** Overrides the client connection timeout in milliseconds. */\n connectionTimeoutInMs?: number;\n /** Cancels the connection attempt. */\n abortSignal?: AbortSignalLike;\n /** Receives connection-state transitions. */\n onConnectionStateChange?: VoiceAgentConnectionStateChangedHandler;\n}\n\n/** Result supplied when a voice-agent connection closes. */\nexport interface VoiceAgentCloseResult {\n /** WebSocket close code. */\n code: number;\n /** WebSocket close reason. */\n reason: string;\n /** Whether the peer completed a normal WebSocket close handshake. */\n wasClean: boolean;\n /** Transport or protocol error associated with the close, if any. */\n error?: Error;\n}\n\n/** Options shared by realtime send operations. */\nexport interface VoiceAgentSendOptions extends OperationOptions {}\n\n/** Options shared by operations that build a protocol event on the caller's behalf. */\nexport interface VoiceAgentEventOptions extends VoiceAgentSendOptions {\n /** Client-generated event identifier. */\n eventId?: string;\n}\n\n/** Options shared by operations that add a conversation item and, by default, request a response. */\nexport interface VoiceAgentSendItemOptions extends VoiceAgentEventOptions {\n /** Whether to request a response after adding the item. Defaults to true. */\n createResponse?: boolean;\n}\n\n/** Options for sending text input. */\nexport interface VoiceAgentSendTextOptions extends VoiceAgentSendItemOptions {\n /** Item after which the new text item is inserted. */\n previousItemId?: string;\n}\n\n/** Options for returning a function result. */\nexport interface VoiceAgentSendToolOutputOptions extends VoiceAgentSendItemOptions {}\n\n/** Options for updating the live session. */\nexport interface VoiceAgentSessionUpdateOptions extends VoiceAgentEventOptions {}\n\n/** Options for creating a response. */\nexport interface VoiceAgentResponseOptions extends VoiceAgentEventOptions {\n /** Response-specific configuration. */\n response?: VoiceAgentResponseCreateParams;\n}\n\n/** Options for cancelling a response. */\nexport interface VoiceAgentCancelResponseOptions extends VoiceAgentEventOptions {\n /** Specific response to cancel. The active default-conversation response is used when omitted. */\n responseId?: string;\n}\n\n/**\n * A connected, bidirectional voice-agent stream.\n *\n * Supports exactly one `for await` iteration over server events; a second attempt throws.\n * Exiting the loop early (`break`, `return`, or an uncaught error in the loop body) closes\n * the connection as a side effect.\n * Unrecognized server event types are delivered as {@link VoiceAgentUnknownEvent} without\n * interrupting the stream. Malformed events still fail the iteration with a protocol error.\n */\nexport interface VoiceAgentConnection extends AsyncIterable<VoiceAgentRealtimeEvent> {\n /** Current connection state. */\n readonly state: VoiceAgentConnectionState;\n /** Resolves once the connection is closed. */\n readonly closed: Promise<VoiceAgentCloseResult>;\n /** Sends any generated client protocol event. */\n sendEvent(event: VoiceAgentClientEvent, options?: VoiceAgentSendOptions): Promise<void>;\n /** Updates supported live-session settings. */\n configureSession(\n session: VoiceAgentSessionUpdateConfig,\n options?: VoiceAgentSessionUpdateOptions,\n ): Promise<void>;\n /** Adds a user text item and, by default, requests a response. */\n sendText(text: string, options?: VoiceAgentSendTextOptions): Promise<void>;\n /** Appends base64-encoded audio bytes to the input buffer. */\n sendAudio(audio: Uint8Array | ArrayBuffer, options?: VoiceAgentEventOptions): Promise<void>;\n /** Commits buffered input audio. */\n commitAudio(options?: VoiceAgentEventOptions): Promise<void>;\n /** Clears buffered input audio. */\n clearInputAudio(options?: VoiceAgentEventOptions): Promise<void>;\n /** Clears pending output audio at the service. */\n clearOutputAudio(options?: VoiceAgentEventOptions): Promise<void>;\n /** Returns a client-executed function result to the agent. */\n sendToolOutput(\n callId: string,\n output: string,\n options?: VoiceAgentSendToolOutputOptions,\n ): Promise<void>;\n /** Requests a new response. */\n requestResponse(options?: VoiceAgentResponseOptions): Promise<void>;\n /** Cancels an in-progress response. */\n cancelResponse(options?: VoiceAgentCancelResponseOptions): Promise<void>;\n /** Gracefully closes the WebSocket connection. */\n close(code?: number, reason?: string): Promise<void>;\n /** Releases the connection. Equivalent to close(). */\n dispose(): Promise<void>;\n}\n\n/** Client for establishing realtime sessions with managed Foundry voice agents. */\nexport class VoiceAgentRealtimeClient {\n private readonly endpoint: string;\n private readonly credential: TokenCredential;\n private readonly options: Required<\n Pick<VoiceAgentRealtimeClientOptions, \"connectionTimeoutInMs\" | \"apiVersion\">\n > &\n VoiceAgentRealtimeClientOptions;\n\n public constructor(\n endpoint: string,\n credential: TokenCredential,\n options: VoiceAgentRealtimeClientOptions = {},\n ) {\n // Endpoint validation (https-only) is deferred to connect() so that merely constructing an\n // AIProjectClient (which eagerly creates this client) doesn't reject callers who intentionally\n // use an insecure local endpoint for the REST surface and never touch realtime connections.\n if (!endpoint.trim()) {\n throw new TypeError(\"endpoint must not be empty.\");\n }\n this.endpoint = endpoint;\n this.credential = credential;\n this.options = {\n ...options,\n connectionTimeoutInMs: options.connectionTimeoutInMs ?? 30_000,\n apiVersion: options.apiVersion ?? \"v1\",\n };\n }\n\n /** Establishes a WebSocket connection to a managed voice agent. */\n public async connect(\n agentName: string,\n options: VoiceAgentRealtimeClientConnectOptions = {},\n ): Promise<VoiceAgentConnection> {\n if (!agentName.trim()) {\n throw new TypeError(\"agentName must not be empty.\");\n }\n const url = buildWebSocketUrl(\n normalizeEndpoint(this.endpoint),\n agentName,\n this.options.apiVersion,\n options,\n );\n const serializedStructuredInputs = options.structuredInputs\n ? JSON.stringify(options.structuredInputs)\n : undefined;\n const tracingConfig = projectTracingConfigs.get(this);\n const tracing = tracingConfig?.enabled\n ? new VoiceAgentRealtimeTracing(this.endpoint, tracingConfig, options.transport)\n : undefined;\n try {\n const factory =\n this.options.webSocketFactory ??\n (await import(\"#platform/webSocketTransport\")).createDefaultVoiceAgentWebSocketFactory();\n const connection = new VoiceAgentConnectionImpl(\n url,\n agentName,\n this.credential,\n this.options,\n options,\n serializedStructuredInputs,\n factory,\n tracing,\n );\n await connection.open();\n return connection;\n } catch (error) {\n tracing?.close(undefined, false, error);\n throw error;\n }\n }\n}\n\n/** Creates the project's realtime client using its already-resolved tracing settings. @internal */\nexport function createVoiceAgentRealtimeClient(\n endpoint: string,\n credential: TokenCredential,\n options: VoiceAgentRealtimeClientOptions | undefined,\n tracingConfig: ResolvedTracingConfig | undefined,\n): VoiceAgentRealtimeClient {\n const client = new VoiceAgentRealtimeClient(endpoint, credential, options);\n if (tracingConfig) projectTracingConfigs.set(client, tracingConfig);\n return client;\n}\n\nclass VoiceAgentConnectionImpl implements VoiceAgentConnection {\n private readonly events: AsyncQueue<VoiceAgentRealtimeEvent>;\n private readonly transport: VoiceAgentWebSocketTransport;\n private readonly closePromise: Promise<VoiceAgentCloseResult>;\n private resolveClose!: (result: VoiceAgentCloseResult) => void;\n private currentState: VoiceAgentConnectionState = KnownVoiceAgentConnectionState.Disconnected;\n private iteratorStarted = false;\n private finished = false;\n\n public constructor(\n private readonly url: string,\n private readonly agentName: string,\n private readonly credential: TokenCredential,\n private readonly clientOptions: VoiceAgentRealtimeClientOptions & {\n connectionTimeoutInMs: number;\n apiVersion: string;\n },\n private readonly connectOptions: VoiceAgentRealtimeClientConnectOptions,\n private readonly serializedStructuredInputs: string | undefined,\n factory: VoiceAgentWebSocketFactory,\n private readonly tracing?: VoiceAgentRealtimeTracing,\n ) {\n this.events = new AsyncQueue<VoiceAgentRealtimeEvent>(10_000, {\n onOverflow: (error) => this.handleEventQueueOverflow(error),\n });\n this.transport = factory.create();\n this.closePromise = new Promise<VoiceAgentCloseResult>((resolve) => {\n this.resolveClose = resolve;\n });\n this.transport.setHandlers({\n onMessage: (data) => this.handleMessage(data),\n onClose: (code, reason, wasClean) => this.handleClose(code, reason, wasClean),\n onError: (error) => this.handleTransportError(error),\n });\n }\n\n public get state(): VoiceAgentConnectionState {\n return this.currentState;\n }\n\n public get closed(): Promise<VoiceAgentCloseResult> {\n return this.closePromise;\n }\n\n public async open(): Promise<void> {\n this.setState(KnownVoiceAgentConnectionState.Connecting);\n let token: string;\n try {\n const accessToken = await this.credential.getToken(\n this.clientOptions.credentialScopes ?? defaultCredentialScope,\n { abortSignal: this.connectOptions.abortSignal },\n );\n if (!accessToken) {\n throw new VoiceAgentAuthenticationError(\"The credential returned no access token.\");\n }\n token = accessToken.token;\n } catch (error) {\n if (this.connectOptions.abortSignal?.aborted) {\n const cancelledError = new VoiceAgentConnectionError(\n \"Voice-agent connection was cancelled.\",\n \"operationCancelled\",\n { cause: error },\n );\n this.finish(1006, cancelledError.message, false, cancelledError);\n throw cancelledError;\n }\n const authenticationError =\n error instanceof VoiceAgentAuthenticationError\n ? error\n : new VoiceAgentAuthenticationError(\"Failed to acquire a Voice Agents access token.\", {\n cause: error,\n });\n this.finish(1006, authenticationError.message, false, authenticationError);\n throw authenticationError;\n }\n\n try {\n await this.transport.connect({\n url: this.url,\n protocols: [\"realtime\"],\n headers: buildHeaders(token, this.clientOptions, this.serializedStructuredInputs),\n connectionTimeoutInMs:\n this.connectOptions.connectionTimeoutInMs ?? this.clientOptions.connectionTimeoutInMs,\n abortSignal: this.connectOptions.abortSignal,\n });\n this.tracing?.opened();\n this.setState(KnownVoiceAgentConnectionState.Connected);\n logger.info(\"Connected to voice agent\", { agentName: this.agentName });\n } catch (error) {\n const cancelled = this.connectOptions.abortSignal?.aborted === true;\n const connectionError = new VoiceAgentConnectionError(\n cancelled\n ? \"Voice-agent connection was cancelled.\"\n : \"Failed to connect to the voice agent.\",\n cancelled ? \"operationCancelled\" : \"connectionFailed\",\n { cause: error },\n );\n this.finish(1006, connectionError.message, false, connectionError);\n throw connectionError;\n }\n }\n\n public async sendEvent(\n event: VoiceAgentClientEvent,\n options: VoiceAgentSendOptions = {},\n ): Promise<void> {\n if (this.state !== KnownVoiceAgentConnectionState.Connected) {\n throw new VoiceAgentConnectionError(\n `Cannot send while the connection is ${this.state}.`,\n \"invalidState\",\n );\n }\n if (options.abortSignal?.aborted) {\n throw new VoiceAgentConnectionError(\"Send operation was cancelled.\", \"operationCancelled\");\n }\n\n let reservation: ReturnType<VoiceAgentRealtimeTracing[\"reserveSend\"]> = undefined;\n try {\n const serialized = serializeVoiceAgentClientEvent(event);\n reservation = this.tracing?.reserveSend(event);\n await this.transport.send(serialized, options.abortSignal);\n this.tracing?.sent(event, reservation);\n } catch (error) {\n this.tracing?.sendFailed(error, reservation);\n if (error instanceof VoiceAgentProtocolError) {\n throw error;\n }\n throw new VoiceAgentConnectionError(\"Failed to send a voice-agent event.\", \"sendFailed\", {\n cause: error,\n });\n }\n }\n\n public configureSession(\n session: VoiceAgentSessionUpdateConfig,\n options: VoiceAgentSessionUpdateOptions = {},\n ): Promise<void> {\n return this.sendEvent({ type: \"session.update\", event_id: options.eventId, session }, options);\n }\n\n public async sendText(text: string, options: VoiceAgentSendTextOptions = {}): Promise<void> {\n await this.sendEvent(\n {\n type: \"conversation.item.create\",\n event_id: options.eventId,\n previous_item_id: options.previousItemId,\n // `RealtimeConversationItemUnion` no longer enumerates a \"message\" item in the generated\n // models, but the wire protocol still accepts this shape; see the TypeSpec regeneration\n // report for details.\n item: {\n type: \"message\",\n role: \"user\",\n content: [{ type: \"input_text\", text }],\n } as unknown as RealtimeConversationItemUnion,\n },\n options,\n );\n if (options.createResponse !== false) {\n await this.requestResponse({ abortSignal: options.abortSignal });\n }\n }\n\n public sendAudio(\n audio: Uint8Array | ArrayBuffer,\n options: VoiceAgentEventOptions = {},\n ): Promise<void> {\n const bytes = audio instanceof Uint8Array ? audio : new Uint8Array(audio);\n return this.sendEvent(\n {\n type: \"input_audio_buffer.append\",\n event_id: options.eventId,\n audio: uint8ArrayToString(bytes, \"base64\"),\n },\n options,\n );\n }\n\n public commitAudio(options: VoiceAgentEventOptions = {}): Promise<void> {\n return this.sendEvent(\n { type: \"input_audio_buffer.commit\", event_id: options.eventId },\n options,\n );\n }\n\n public clearInputAudio(options: VoiceAgentEventOptions = {}): Promise<void> {\n return this.sendEvent({ type: \"input_audio_buffer.clear\", event_id: options.eventId }, options);\n }\n\n public clearOutputAudio(options: VoiceAgentEventOptions = {}): Promise<void> {\n return this.sendEvent(\n { type: \"output_audio_buffer.clear\", event_id: options.eventId },\n options,\n );\n }\n\n public async sendToolOutput(\n callId: string,\n output: string,\n options: VoiceAgentSendToolOutputOptions = {},\n ): Promise<void> {\n await this.sendEvent(\n {\n type: \"conversation.item.create\",\n event_id: options.eventId,\n item: { type: \"function_call_output\", call_id: callId, output },\n },\n options,\n );\n if (options.createResponse !== false) {\n await this.requestResponse({ abortSignal: options.abortSignal });\n }\n }\n\n public requestResponse(options: VoiceAgentResponseOptions = {}): Promise<void> {\n return this.sendEvent(\n { type: \"response.create\", event_id: options.eventId, response: options.response },\n options,\n );\n }\n\n public cancelResponse(options: VoiceAgentCancelResponseOptions = {}): Promise<void> {\n return this.sendEvent(\n { type: \"response.cancel\", event_id: options.eventId, response_id: options.responseId },\n options,\n );\n }\n\n public async close(\n code = 1000,\n reason = \"Client closed the voice-agent connection.\",\n ): Promise<void> {\n if (\n this.state === KnownVoiceAgentConnectionState.Disconnected ||\n this.state === KnownVoiceAgentConnectionState.Closing\n ) {\n await this.closed;\n return;\n }\n this.setState(KnownVoiceAgentConnectionState.Closing);\n try {\n await this.transport.close(code, reason);\n } finally {\n this.finish(code, reason, false);\n }\n }\n\n public dispose(): Promise<void> {\n return this.close();\n }\n\n public async *[Symbol.asyncIterator](): AsyncIterator<VoiceAgentRealtimeEvent> {\n if (this.iteratorStarted) {\n throw new VoiceAgentConnectionError(\n \"A voice-agent connection supports one active event iterator.\",\n \"invalidState\",\n );\n }\n this.iteratorStarted = true;\n try {\n while (true) {\n const result = await this.events.next();\n if (result.done) {\n return;\n }\n yield result.value;\n }\n } finally {\n if (this.state === KnownVoiceAgentConnectionState.Connected) {\n await this.close();\n }\n }\n }\n\n private handleMessage(data: string | ArrayBuffer): void {\n try {\n const event = deserializeVoiceAgentServerEvent(data);\n this.tracing?.received(event);\n this.events.enqueue(event);\n } catch (error) {\n const protocolError =\n error instanceof VoiceAgentProtocolError\n ? error\n : new VoiceAgentProtocolError(\"Failed to process a voice-agent event.\", { cause: error });\n // finish() closes the transport itself, so no additional close is needed here.\n this.finish(1002, protocolError.message, false, protocolError);\n }\n }\n\n private handleEventQueueOverflow(cause: Error): void {\n if (this.finished) {\n return;\n }\n const error = new VoiceAgentConnectionError(cause.message, \"connectionClosed\", {\n cause,\n });\n this.finish(1006, error.message, false, error);\n }\n\n private handleClose(code: number, reason: string, wasClean: boolean): void {\n if (this.finished) {\n return;\n }\n if (wasClean || this.state === KnownVoiceAgentConnectionState.Closing) {\n this.finish(code, reason, wasClean);\n } else {\n const error = new VoiceAgentConnectionError(\n `Voice-agent connection closed unexpectedly (${code}${reason ? `: ${reason}` : \"\"}).`,\n \"connectionClosed\",\n { closeCode: code },\n );\n this.finish(code, reason, false, error);\n }\n }\n\n private handleTransportError(cause: Error): void {\n if (this.finished) {\n return;\n }\n const error = new VoiceAgentConnectionError(\n \"Voice-agent WebSocket transport failed.\",\n \"connectionClosed\",\n {\n cause,\n },\n );\n this.finish(1006, cause.message, false, error);\n }\n\n private finish(code: number, reason: string, wasClean: boolean, error?: Error): void {\n if (this.finished) {\n return;\n }\n this.finished = true;\n this.tracing?.close(code, wasClean, error);\n if (error) {\n this.events.fail(error);\n } else {\n this.events.close();\n }\n this.setState(KnownVoiceAgentConnectionState.Disconnected);\n this.resolveClose({ code, reason, wasClean, error });\n logger.info(\"Voice-agent connection closed\", { code, reason, wasClean });\n // Ensure the socket never outlives the connection, even on paths that never closed it\n // themselves. Not awaited: finish() is synchronous because its callers are.\n void this.closeTransportQuietly(code, reason);\n }\n\n /**\n * Closes the transport, logging rather than rejecting: this is best-effort cleanup running after\n * the connection has already settled. A no-op if the transport is already closed.\n */\n private async closeTransportQuietly(code: number, reason: string): Promise<void> {\n try {\n await this.transport.close(code, reason);\n } catch (error) {\n logger.warning(\"Failed to close the voice-agent transport\", { error });\n }\n }\n\n private setState(state: VoiceAgentConnectionState): void {\n if (state === this.currentState) {\n return;\n }\n const previousState = this.currentState;\n this.currentState = state;\n try {\n this.connectOptions.onConnectionStateChange?.(state, previousState);\n } catch (error) {\n // A throwing caller callback must never interrupt connection lifecycle/cleanup.\n logger.warning(\"onConnectionStateChange callback threw an error\", { error });\n }\n }\n}\n\nfunction normalizeEndpoint(endpoint: string): string {\n const normalized = endpoint.trim();\n if (!normalized) {\n throw new TypeError(\"endpoint must not be empty.\");\n }\n const url = new URL(normalized.includes(\"://\") ? normalized : `https://${normalized}`);\n if (url.protocol !== \"https:\") {\n throw new TypeError(\n \"endpoint must use https; a plaintext endpoint would send the bearer token over an unencrypted connection.\",\n );\n }\n return url.toString();\n}\n\nfunction buildWebSocketUrl(\n endpoint: string,\n agentName: string,\n apiVersion: string,\n options: VoiceAgentRealtimeClientConnectOptions,\n): string {\n const url = new URL(endpoint);\n url.protocol = \"wss:\";\n url.pathname = `${url.pathname.replace(/\\/+$/, \"\")}/agents/${encodeURIComponent(agentName)}/endpoint/protocols/voice`;\n if (\n options.query !== undefined &&\n (options.query === null ||\n typeof options.query !== \"object\" ||\n ![Object.prototype, null].includes(Object.getPrototypeOf(options.query)))\n ) {\n throw new TypeError(\"query must be a record of query parameters.\");\n }\n for (const [name, value] of Object.entries(options.query ?? {})) {\n const normalizedName = name.toLowerCase();\n if (reservedQueryParameters.has(normalizedName) || normalizedName.startsWith(\"h-\")) {\n throw new TypeError(`Query parameter \"${name}\" is reserved; use the SDK's typed options.`);\n }\n if (value === undefined) {\n url.searchParams.delete(name);\n } else if (\n typeof value === \"string\" ||\n typeof value === \"boolean\" ||\n (typeof value === \"number\" && Number.isFinite(value))\n ) {\n url.searchParams.set(name, String(value));\n } else {\n throw new TypeError(\n `Query parameter \"${name}\" must be a string, boolean, finite number, or undefined.`,\n );\n }\n }\n url.searchParams.set(\"api-version\", apiVersion);\n url.searchParams.set(\"x-ms-client-sdk\", `azsdk-js-ai-projects/${SDK_VERSION}`);\n if (options.agentSessionId) {\n url.searchParams.set(\"agent_session_id\", options.agentSessionId);\n }\n if (options.store !== undefined) {\n url.searchParams.set(\"store\", String(options.store));\n }\n if (options.agentVersionOverride) {\n url.searchParams.set(\"x-agent-version-override\", options.agentVersionOverride);\n }\n if (options.transport) {\n url.searchParams.set(\"transport\", options.transport);\n }\n return url.toString();\n}\n\nfunction buildHeaders(\n token: string,\n clientOptions: VoiceAgentRealtimeClientOptions,\n serializedStructuredInputs: string | undefined,\n): Record<string, string> {\n const sdkUserAgent = `azsdk-js-ai-projects/${SDK_VERSION}`;\n const headers: Record<string, string> = {\n authorization: `Bearer ${token}`,\n \"foundry-features\": voiceAgentsPreview,\n \"x-ms-client-request-id\": createRequestId(),\n \"x-ms-client-sdk\": sdkUserAgent,\n \"user-agent\": clientOptions.userAgentPrefix\n ? `${clientOptions.userAgentPrefix} ${sdkUserAgent}`\n : sdkUserAgent,\n };\n if (serializedStructuredInputs !== undefined) {\n headers[\"x-ms-voice-structured-inputs\"] = serializedStructuredInputs;\n }\n return headers;\n}\n\nfunction createRequestId(): string {\n return (\n globalThis.crypto?.randomUUID?.() ?? `${Date.now()}-${Math.random().toString(36).slice(2)}`\n );\n}\n"]}
|
|
@@ -44,14 +44,12 @@ export interface ResolvedTracingConfig {
|
|
|
44
44
|
traceContextPropagation: boolean;
|
|
45
45
|
}
|
|
46
46
|
/**
|
|
47
|
-
* Resolves tracing options into a
|
|
47
|
+
* Resolves tracing options into a config object for the client instance.
|
|
48
48
|
* For each setting not explicitly provided, the corresponding environment variable
|
|
49
49
|
* is checked. If the env var is also not set, the default value is used.
|
|
50
50
|
*
|
|
51
|
-
* - `enabled`:
|
|
52
|
-
*
|
|
53
|
-
* Env var `AZURE_TRACING_GEN_AI_ENABLE` (accepts `"true"` or `"1"`) enables tracing
|
|
54
|
-
* when `tracingOptions` is not provided.
|
|
51
|
+
* - `enabled`: requires options and the experimental gate, resolved from
|
|
52
|
+
* `experimental` or `AZURE_EXPERIMENTAL_ENABLE_GENAI_TRACING`.
|
|
55
53
|
* - `contentRecording`: defaults to `false`. Env var: `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT`
|
|
56
54
|
* - `traceContextPropagation`: defaults to `true`. Env var: `AZURE_TRACING_GEN_AI_ENABLE_TRACE_CONTEXT_PROPAGATION`
|
|
57
55
|
* @internal
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"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
|
|
1
|
+
{"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;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,qBAAqB,CA6DzF"}
|
|
@@ -2,14 +2,12 @@
|
|
|
2
2
|
// Licensed under the MIT License.
|
|
3
3
|
import { logger } from "../logger.js";
|
|
4
4
|
/**
|
|
5
|
-
* Resolves tracing options into a
|
|
5
|
+
* Resolves tracing options into a config object for the client instance.
|
|
6
6
|
* For each setting not explicitly provided, the corresponding environment variable
|
|
7
7
|
* is checked. If the env var is also not set, the default value is used.
|
|
8
8
|
*
|
|
9
|
-
* - `enabled`:
|
|
10
|
-
*
|
|
11
|
-
* Env var `AZURE_TRACING_GEN_AI_ENABLE` (accepts `"true"` or `"1"`) enables tracing
|
|
12
|
-
* when `tracingOptions` is not provided.
|
|
9
|
+
* - `enabled`: requires options and the experimental gate, resolved from
|
|
10
|
+
* `experimental` or `AZURE_EXPERIMENTAL_ENABLE_GENAI_TRACING`.
|
|
13
11
|
* - `contentRecording`: defaults to `false`. Env var: `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT`
|
|
14
12
|
* - `traceContextPropagation`: defaults to `true`. Env var: `AZURE_TRACING_GEN_AI_ENABLE_TRACE_CONTEXT_PROPAGATION`
|
|
15
13
|
* @internal
|
|
@@ -65,6 +63,10 @@ export function resolveTracingConfig(options) {
|
|
|
65
63
|
logger.verbose(`Unable to read AZURE_TRACING_GEN_AI_ENABLE_TRACE_CONTEXT_PROPAGATION env var: ${e}`);
|
|
66
64
|
}
|
|
67
65
|
}
|
|
68
|
-
return {
|
|
66
|
+
return {
|
|
67
|
+
enabled,
|
|
68
|
+
contentRecording,
|
|
69
|
+
traceContextPropagation,
|
|
70
|
+
};
|
|
69
71
|
}
|
|
70
72
|
//# sourceMappingURL=configuration.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"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
|
|
1
|
+
{"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;;;;;;;;;;GAUG;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,gBAAyB,CAAC;IAC9B,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;QACL,OAAO;QACP,gBAAgB;QAChB,uBAAuB;KACxB,CAAC;AACJ,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 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`: requires options and the experimental gate, resolved from\n * `experimental` or `AZURE_EXPERIMENTAL_ENABLE_GENAI_TRACING`.\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: boolean;\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 {\n enabled,\n contentRecording,\n traceContextPropagation,\n };\n}\n"]}
|
|
@@ -8,7 +8,7 @@ export interface StartSpanResult {
|
|
|
8
8
|
/**
|
|
9
9
|
* Starts a new client span using the global OTel TracerProvider.
|
|
10
10
|
*/
|
|
11
|
-
export declare function startSpan(name: string): StartSpanResult;
|
|
11
|
+
export declare function startSpan(name: string, parentContext?: Context): StartSpanResult;
|
|
12
12
|
/**
|
|
13
13
|
* Injects trace context headers (traceparent/tracestate) for the current active span.
|
|
14
14
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tracingClient.d.ts","sourceRoot":"","sources":["../../../src/tracing/tracingClient.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGxD,YAAY,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,IAAI,CAAC;IACX,GAAG,EAAE,OAAO,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,SAAS,
|
|
1
|
+
{"version":3,"file":"tracingClient.d.ts","sourceRoot":"","sources":["../../../src/tracing/tracingClient.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGxD,YAAY,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,IAAI,CAAC;IACX,GAAG,EAAE,OAAO,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,aAAa,GAAE,OAA0B,GACxC,eAAe,CAMjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAI7D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEhE"}
|
|
@@ -11,9 +11,9 @@ export { SpanStatusCode } from "@opentelemetry/api";
|
|
|
11
11
|
/**
|
|
12
12
|
* Starts a new client span using the global OTel TracerProvider.
|
|
13
13
|
*/
|
|
14
|
-
export function startSpan(name) {
|
|
14
|
+
export function startSpan(name, parentContext = context.active()) {
|
|
15
15
|
const tracer = trace.getTracer(PACKAGE_NAME, SDK_VERSION);
|
|
16
|
-
const ctx =
|
|
16
|
+
const ctx = parentContext;
|
|
17
17
|
const span = tracer.startSpan(name, { kind: SpanKind.CLIENT }, ctx);
|
|
18
18
|
const spanCtx = trace.setSpan(ctx, span);
|
|
19
19
|
return { span, ctx: spanCtx };
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tracingClient.js","sourceRoot":"","sources":["../../../src/tracing/tracingClient.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAEjG,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG5D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAOpD;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,
|
|
1
|
+
{"version":3,"file":"tracingClient.js","sourceRoot":"","sources":["../../../src/tracing/tracingClient.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAEjG,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG5D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAOpD;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,IAAY,EACZ,gBAAyB,OAAO,CAAC,MAAM,EAAE;IAEzC,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,aAAa,CAAC;IAC1B,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,EAAE,GAAG,CAAC,CAAC;IACpE,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACzC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,oBAAoB,CAAC,CAAC;IACpE,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAI,GAAY,EAAE,EAAW;IAC3D,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAC/B,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\n/**\n * Thin wrapper around `\\@opentelemetry/api` for tracing.\n * Uses direct imports since `\\@opentelemetry/api` is an explicit dependency.\n * @internal\n */\n\nimport { trace, context, propagation, SpanKind, defaultTextMapSetter } from \"@opentelemetry/api\";\nimport type { Span, Context } from \"@opentelemetry/api\";\nimport { PACKAGE_NAME, SDK_VERSION } from \"../constants.js\";\n\nexport type { Span as OTelSpan } from \"@opentelemetry/api\";\nexport { SpanStatusCode } from \"@opentelemetry/api\";\n\nexport interface StartSpanResult {\n span: Span;\n ctx: Context;\n}\n\n/**\n * Starts a new client span using the global OTel TracerProvider.\n */\nexport function startSpan(\n name: string,\n parentContext: Context = context.active(),\n): StartSpanResult {\n const tracer = trace.getTracer(PACKAGE_NAME, SDK_VERSION);\n const ctx = parentContext;\n const span = tracer.startSpan(name, { kind: SpanKind.CLIENT }, ctx);\n const spanCtx = trace.setSpan(ctx, span);\n return { span, ctx: spanCtx };\n}\n\n/**\n * Injects trace context headers (traceparent/tracestate) for the current active span.\n */\nexport function createRequestHeaders(): Record<string, string> {\n const headers: Record<string, string> = {};\n propagation.inject(context.active(), headers, defaultTextMapSetter);\n return headers;\n}\n\n/**\n * Runs a callback with the given span context as the active context,\n * so that child operations (e.g. tracingFetch header injection) see this span\n * as their parent.\n */\nexport function runInSpanContext<T>(ctx: Context, fn: () => T): T {\n return context.with(ctx, fn);\n}\n"]}
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
import type { Attributes } from "@opentelemetry/api";
|
|
2
|
+
import type { ResolvedTracingConfig } from "./configuration.js";
|
|
3
|
+
import type { VoiceAgentClientEvent, VoiceAgentTransport } from "../models/models.js";
|
|
4
|
+
import type { VoiceAgentRealtimeEvent } from "../realtime/events.js";
|
|
5
|
+
/** @internal */
|
|
6
|
+
export declare function traceVoiceAgentOperation<T>(operationName: string, endpoint: string, config: ResolvedTracingConfig | undefined, operation: () => Promise<T>, resultAttributes?: (result: T) => Attributes): Promise<T>;
|
|
7
|
+
interface TrackedInputAudio {
|
|
8
|
+
sequence: number;
|
|
9
|
+
itemId?: string;
|
|
10
|
+
pendingQueue?: PendingInputAudio;
|
|
11
|
+
pendingSkipped?: boolean;
|
|
12
|
+
pendingSend?: boolean;
|
|
13
|
+
pendingTranscript?: string;
|
|
14
|
+
}
|
|
15
|
+
interface PendingInputAudio {
|
|
16
|
+
items: TrackedInputAudio[];
|
|
17
|
+
skipped: number;
|
|
18
|
+
}
|
|
19
|
+
interface ReservedInput {
|
|
20
|
+
sequence: number;
|
|
21
|
+
audio?: TrackedInputAudio;
|
|
22
|
+
}
|
|
23
|
+
/** Tracks SDK-observed realtime work, independently of the user's event iterator. @internal */
|
|
24
|
+
export declare class VoiceAgentRealtimeTracing {
|
|
25
|
+
private readonly endpoint;
|
|
26
|
+
private readonly config;
|
|
27
|
+
private readonly responses;
|
|
28
|
+
private session?;
|
|
29
|
+
private connectSpan?;
|
|
30
|
+
private ended;
|
|
31
|
+
private connected;
|
|
32
|
+
private model?;
|
|
33
|
+
private inputAudioBytes;
|
|
34
|
+
private inputSequence;
|
|
35
|
+
private nextInputSequence;
|
|
36
|
+
private inputAudioBuffer?;
|
|
37
|
+
private readonly inputAudioItems;
|
|
38
|
+
private readonly pendingAudioCommits;
|
|
39
|
+
private readonly pendingAudioMessages;
|
|
40
|
+
private pendingAudioClears;
|
|
41
|
+
private untrackedInputItems;
|
|
42
|
+
private finishedResponses;
|
|
43
|
+
private untrackedResponses;
|
|
44
|
+
constructor(endpoint: string, config: ResolvedTracingConfig, transport?: VoiceAgentTransport);
|
|
45
|
+
opened(): void;
|
|
46
|
+
reserveSend(event: VoiceAgentClientEvent): ReservedInput | undefined;
|
|
47
|
+
sent(event: VoiceAgentClientEvent, reservation?: ReservedInput): void;
|
|
48
|
+
sendFailed(error: unknown, reservation?: ReservedInput): void;
|
|
49
|
+
received(event: VoiceAgentRealtimeEvent): void;
|
|
50
|
+
private startInputAudio;
|
|
51
|
+
private enqueueInputAudio;
|
|
52
|
+
private rollbackPendingAudioMessage;
|
|
53
|
+
private matchInputAudio;
|
|
54
|
+
private rememberInputAudio;
|
|
55
|
+
private setInputAudioSummary;
|
|
56
|
+
private recordOutputPart;
|
|
57
|
+
private beginResponse;
|
|
58
|
+
private endResponse;
|
|
59
|
+
private flushObservedResponse;
|
|
60
|
+
close(code: number | undefined, wasClean: boolean, error?: unknown): void;
|
|
61
|
+
}
|
|
62
|
+
export {};
|
|
63
|
+
//# sourceMappingURL=voiceAgentTracing.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"voiceAgentTracing.d.ts","sourceRoot":"","sources":["../../../src/tracing/voiceAgentTracing.ts"],"names":[],"mappings":"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"}
|