@telnyx/ai-agent-lib 0.3.1 → 0.3.2-beta.0

package/dist/client.d.ts

@@ -41,6 +41,26 @@ export declare class TelnyxAIAgent extends EventEmitter<AIAgentEvents> {
      * Audio is negotiated as recvonly so agent speech can still be received.
      */
     chatMode: boolean;
+    /**
+     * Datacenter identifier captured from the REGED message (e.g. `"ams3-prod"`).
+     * Populated right before `agent.connected` is emitted. `null` until the
+     * session registers, and always `null` on SDK versions that pre-date
+     * team-telnyx/webrtc#583.
+     */
+    dc: string | null;
+    /**
+     * Region identifier captured from the REGED message (e.g. `"eu-west"`).
+     * Populated right before `agent.connected` is emitted. `null` until the
+     * session registers, and always `null` on SDK versions that pre-date
+     * team-telnyx/webrtc#583.
+     */
+    region: string | null;
+    /**
+     * Call report identifier captured from the REGED message. Used by the
+     * underlying SDK to post call quality reports; exposed here so integrators
+     * can correlate client-side logs with server-side reports.
+     */
+    callReportId: string | null;
     constructor(params: TelnyxAIAgentConstructorParams);
     /**
      * Connects to the Telnyx WebRTC service and establishes a session with the AI agent.

package/dist/index.js

@@ -3535,6 +3535,26 @@ class Gt extends vt {
    * Audio is negotiated as recvonly so agent speech can still be received.
    */
   chatMode;
+  /**
+   * Datacenter identifier captured from the REGED message (e.g. `"ams3-prod"`).
+   * Populated right before `agent.connected` is emitted. `null` until the
+   * session registers, and always `null` on SDK versions that pre-date
+   * team-telnyx/webrtc#583.
+   */
+  dc = null;
+  /**
+   * Region identifier captured from the REGED message (e.g. `"eu-west"`).
+   * Populated right before `agent.connected` is emitted. `null` until the
+   * session registers, and always `null` on SDK versions that pre-date
+   * team-telnyx/webrtc#583.
+   */
+  region = null;
+  /**
+   * Call report identifier captured from the REGED message. Used by the
+   * underlying SDK to post call quality reports; exposed here so integrators
+   * can correlate client-side logs with server-side reports.
+   */
+  callReportId = null;
   constructor(e) {
     super(), this.agentId = e.agentId, this.versionId = e.versionId || "main", this.conversationId = e.conversationId, this.debug = e.debug || !1, this.chatMode = e.chatMode || !1, this.activeCall = null, J.setLevel(this.debug ? "debug" : "info");
     const t = {
@@ -3568,7 +3588,7 @@ class Gt extends vt {
    * Emits an 'agent.disconnected' event before completing cleanup.
    */
   async disconnect() {
-    this.audioStreamMonitor.destroy(), this.telnyxRTC.disconnect(), this.telnyxRTC.off(x.Ready, this.onClientReady), this.telnyxRTC.off(x.Error, this.onClientOrSocketError), this.telnyxRTC.off(x.SocketError, this.onClientOrSocketError), this.telnyxRTC.off(x.Notification, this.onNotification), this.emit("agent.disconnected"), this.transcription.removeAllListeners(), Ge.removeAllListeners(), this.removeAllListeners();
+    this.audioStreamMonitor.destroy(), this.telnyxRTC.disconnect(), this.telnyxRTC.off(x.Ready, this.onClientReady), this.telnyxRTC.off(x.Error, this.onClientOrSocketError), this.telnyxRTC.off(x.SocketError, this.onClientOrSocketError), this.telnyxRTC.off(x.Notification, this.onNotification), this.dc = null, this.region = null, this.callReportId = null, this.emit("agent.disconnected"), this.transcription.removeAllListeners(), Ge.removeAllListeners(), this.removeAllListeners();
   }
   /**
    * Sends a text message to the AI agent during an active conversation.
@@ -3671,7 +3691,14 @@ class Gt extends vt {
     this.audioStreamMonitor.setRemoteStream(e);
   }
   onClientReady = () => {
-    this.emit("agent.connected");
+    const e = this.telnyxRTC;
+    this.dc = e.dc ?? null, this.region = e.region ?? null, this.callReportId = e.callReportId ?? null;
+    const t = {
+      dc: this.dc,
+      region: this.region,
+      callReportId: this.callReportId
+    };
+    this.emit("agent.connected", t);
   };
   onClientOrSocketError = (e) => {
     this.emit("agent.error", e);

package/dist/types.d.ts

@@ -20,8 +20,30 @@ export type AgentStateData = {
     /** UTC timestamp (ISO 8601) when user stopped speaking and thinking state began. Only present when state is "thinking". */
     thinkingStartedAt?: string;
 };
+/**
+ * Connection metadata captured from the REGED message sent by the Telnyx
+ * voice-sdk-proxy when the WebRTC session is established.
+ *
+ * - `dc`: datacenter identifier that handled the connection
+ *   (e.g. `"ams3-prod"`, `"cn1-prod"`).
+ * - `region`: logical region the datacenter belongs to
+ *   (e.g. `"eu-west"`, `"us-central"`).
+ * - `callReportId`: identifier used by the SDK to post periodic call
+ *   quality reports to voice-sdk-proxy. Useful for correlating client
+ *   sessions with server-side reports when debugging.
+ *
+ * All fields are nullable because the underlying SDK only populates them
+ * when the proxy advertises the corresponding values in the REGED message.
+ * `dc` and `region` require `@telnyx/webrtc` >= the version that ships
+ * team-telnyx/webrtc#583; on older versions they will always be `null`.
+ */
+export type AgentConnectionInfo = {
+    dc: string | null;
+    region: string | null;
+    callReportId: string | null;
+};
 export type AIAgentEvents = {
-    "agent.connected": () => void;
+    "agent.connected": (info: AgentConnectionInfo) => void;
     "agent.disconnected": () => void;
     "agent.error": (error: Error) => void;
     "transcript.item": (item: TranscriptItem) => void;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@telnyx/ai-agent-lib",
   "private": false,
-  "version": "0.3.1",
+  "version": "0.3.2-beta.0",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",