@bytexbyte/nxtlinq-ai-agent-web-development 0.1.2 → 0.1.5

package/dist/createNxtlinqAgent.d.ts

@@ -3,7 +3,7 @@ import { type CreateWebPlatformPortsOptions } from './ports/createWebPlatformPor
 export type CreateNxtlinqAgentWebOptions = AgentConfig & CreateWebPlatformPortsOptions;
 /**
  * Create a platform-ready {@link NxtlinqAgent} for React Web custom UIs.
- * Applies browser defaults (`voiceTransport: webrtc`, `defaultModel`).
+ * Applies browser defaults (`voiceTransport: ws-realtime`, `defaultModel`).
  */
 export declare function createNxtlinqAgentWeb(options: CreateNxtlinqAgentWebOptions): NxtlinqAgent;
 //# sourceMappingURL=createNxtlinqAgent.d.ts.map

package/dist/createNxtlinqAgent.js

@@ -3,7 +3,7 @@ import { createWebPlatformPorts, } from './ports/createWebPlatformPorts';
 import { applyWebAgentDefaults } from './webAgentDefaults';
 /**
  * Create a platform-ready {@link NxtlinqAgent} for React Web custom UIs.
- * Applies browser defaults (`voiceTransport: webrtc`, `defaultModel`).
+ * Applies browser defaults (`voiceTransport: ws-realtime`, `defaultModel`).
  */
 export function createNxtlinqAgentWeb(options) {
     const { storage, fetchImpl, getTimezone, webrtc, enableWebRTC, ...rawConfig } = options;

package/dist/legacy/core/lib/useVoiceMode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useVoiceMode.d.ts","sourceRoot":"","sources":["../../../../src/legacy/core/lib/useVoiceMode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AACpG,OAAO,EAKL,KAAK,WAAW,EAEjB,MAAM,iBAAiB,CAAC;AAgBzB,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,OAAO,EAAE,CAAC;IAC7B,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC7D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,CAAC;AAEF,wBAAgB,YAAY,CAAC,EAC3B,MAAM,EACN,SAAS,EACT,QAAQ,EACR,UAAU,EACV,KAAK,EACL,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,WAAW,EACX,WAAW,EACX,OAAO,EACP,aAAa,EACb,gBAAgB,EAChB,cAA8B,GAC/B,EAAE,mBAAmB;;;;;;;;;;EAkWrB"}
+{"version":3,"file":"useVoiceMode.d.ts","sourceRoot":"","sources":["../../../../src/legacy/core/lib/useVoiceMode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AACpG,OAAO,EAKL,KAAK,WAAW,EAEjB,MAAM,iBAAiB,CAAC;AAgBzB,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,OAAO,EAAE,CAAC;IAC7B,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC7D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,CAAC;AAEF,wBAAgB,YAAY,CAAC,EAC3B,MAAM,EACN,SAAS,EACT,QAAQ,EACR,UAAU,EACV,KAAK,EACL,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,WAAW,EACX,WAAW,EACX,OAAO,EACP,aAAa,EACb,gBAAgB,EAChB,cAA8B,GAC/B,EAAE,mBAAmB;;;;;;;;;;EAoXrB"}

package/dist/legacy/core/lib/useVoiceMode.js

@@ -361,6 +361,25 @@ export function useVoiceMode({ apiKey, apiSecret, pseudoId, externalId, aitId, w
         };
     }, [handleStatus, handleTranscriptTurn, handleTranscriptUi, handleDone]);
     React.useEffect(() => () => { void stopVoiceSessionRef.current('unmount'); }, []);
+    // 追踪当前的 isVoiceMode 状态，用于 visibilitychange 事件
+    const isVoiceModeRef = React.useRef(isVoiceMode);
+    React.useEffect(() => {
+        isVoiceModeRef.current = isVoiceMode;
+    }, [isVoiceMode]);
+    // App 進入背景時立即退出語音 mode，防止後台語音連線異常斷開
+    React.useEffect(() => {
+        if (typeof document === 'undefined')
+            return;
+        const handleVisibilityChange = () => {
+            if (document.visibilityState !== 'hidden')
+                return;
+            if (!isVoiceModeRef.current)
+                return;
+            void exitVoiceMode();
+        };
+        document.addEventListener('visibilitychange', handleVisibilityChange);
+        return () => document.removeEventListener('visibilitychange', handleVisibilityChange);
+    }, [exitVoiceMode]);
     return {
         isVoiceMode,
         voiceStatus,

package/dist/webAgentDefaults.d.ts

@@ -1,7 +1,7 @@
 import type { AgentConfig } from '@bytexbyte/nxtlinq-ai-agent-core-development';
 /** Browser SDK defaults — integrators do not pass these props. */
 export declare const WEB_AGENT_DEFAULTS: {
-    readonly voiceTransport: "webrtc";
+    readonly voiceTransport: "ws-realtime";
     readonly voiceMode: "realtime";
     readonly defaultModel: "open-ai-stream";
 };

package/dist/webAgentDefaults.js

@@ -1,6 +1,6 @@
 /** Browser SDK defaults — integrators do not pass these props. */
 export const WEB_AGENT_DEFAULTS = {
-    voiceTransport: 'webrtc',
+    voiceTransport: 'ws-realtime',
     voiceMode: 'realtime',
     defaultModel: 'open-ai-stream',
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bytexbyte/nxtlinq-ai-agent-web-development",
-  "version": "0.1.2",
+  "version": "0.1.5",
   "description": "React Web headless SDK for nxtlinq AI Agent — hooks and browser ports",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -45,7 +45,7 @@
     "universal-cookie": "^8.0.1"
   },
   "devDependencies": {
-    "@bytexbyte/nxtlinq-ai-agent-core-development": "0.3.9",
+    "@bytexbyte/nxtlinq-ai-agent-core-development": "workspace:^",
     "@types/react": "^18.2.64",
     "@types/react-dom": "^18.2.25",
     "react": "^18.2.0",

package/src/createNxtlinqAgent.ts

@@ -13,7 +13,7 @@ export type CreateNxtlinqAgentWebOptions = AgentConfig & CreateWebPlatformPortsO
 
 /**
  * Create a platform-ready {@link NxtlinqAgent} for React Web custom UIs.
- * Applies browser defaults (`voiceTransport: webrtc`, `defaultModel`).
+ * Applies browser defaults (`voiceTransport: ws-realtime`, `defaultModel`).
  */
 export function createNxtlinqAgentWeb(options: CreateNxtlinqAgentWebOptions): NxtlinqAgent {
   const {

package/src/legacy/core/lib/useVoiceMode.ts

@@ -401,6 +401,24 @@ export function useVoiceMode({
 
   React.useEffect(() => () => { void stopVoiceSessionRef.current('unmount'); }, []);
 
+  // 追踪当前的 isVoiceMode 状态，用于 visibilitychange 事件
+  const isVoiceModeRef = React.useRef(isVoiceMode);
+  React.useEffect(() => {
+    isVoiceModeRef.current = isVoiceMode;
+  }, [isVoiceMode]);
+
+  // App 進入背景時立即退出語音 mode，防止後台語音連線異常斷開
+  React.useEffect(() => {
+    if (typeof document === 'undefined') return;
+    const handleVisibilityChange = () => {
+      if (document.visibilityState !== 'hidden') return;
+      if (!isVoiceModeRef.current) return;
+      void exitVoiceMode();
+    };
+    document.addEventListener('visibilitychange', handleVisibilityChange);
+    return () => document.removeEventListener('visibilitychange', handleVisibilityChange);
+  }, [exitVoiceMode]);
+
   return {
     isVoiceMode,
     voiceStatus,

package/src/webAgentDefaults.ts

@@ -2,7 +2,7 @@ import type { AgentConfig } from '@bytexbyte/nxtlinq-ai-agent-core-development';
 
 /** Browser SDK defaults — integrators do not pass these props. */
 export const WEB_AGENT_DEFAULTS = {
-  voiceTransport: 'webrtc',
+  voiceTransport: 'ws-realtime',
   voiceMode: 'realtime',
   defaultModel: 'open-ai-stream',
 } as const satisfies Partial<AgentConfig>;