@space3-npm/cybersoul-client 1.4.3 → 1.4.4

package/dist/client.d.ts

@@ -42,6 +42,22 @@ export declare class CyberSoulClient {
      * If the payload is already the inner args object (no voiceArgs wrapper), uses it as-is.
      */
     private extractVoiceArgsFromLlmResponse;
+    /**
+     * Strip content the TTS engine can't speak naturally:
+     *   - Stage-direction wrappers like (smiles), （挑眉）, [pauses], 【动作】, *grins*
+     *     — these slip through despite prompt instructions and the engine will
+     *     literally read the brackets/asterisks if left in.
+     *   - Emoji and emoji-component codepoints (Extended_Pictographic plus the
+     *     ZWJ / variation-selector / skin-tone / regional-indicator scaffolding
+     *     that builds composite emoji). TTS providers either read these aloud
+     *     as the literal Unicode name ("face with tears of joy") or produce a
+     *     glitchy artifact, both of which sound wrong.
+     *
+     * Collapses runs of whitespace introduced by removals and trims the result.
+     * Returns "" if everything gets stripped — callers should fall back to a
+     * neutral placeholder (e.g. "...") so the TTS call still has valid input.
+     */
+    private sanitizeTextForVoice;
     private formatHistoryEntries;
     private buildHistoryTranscript;
     interact(params: InteractParams): Promise<InteractResponse>;

package/dist/client.js

@@ -13,7 +13,7 @@ export class CyberSoulClient {
         this.requestTimeoutMs = config.requestTimeoutMs ?? 120000;
         this.maxRetries = Math.max(0, config.maxRetries ?? 1);
         // Setup Provider
-        this.llm = new GenericLLMProvider(config.llmConfig, config.backendUrl, config.characterKey);
+        this.llm = new GenericLLMProvider(config.llmConfig, config.backendUrl, config.characterKey, config.fetchImpl);
     }
     /**
      * Internal wrapper for fetch that automatically injects the backend URL and Character Auth token.
@@ -33,7 +33,8 @@ export class CyberSoulClient {
             const controller = new AbortController();
             const timeout = setTimeout(() => controller.abort(), this.requestTimeoutMs);
             try {
-                const response = await fetch(url, {
+                const fetchFn = this.config.fetchImpl ?? fetch;
+                const response = await fetchFn(url, {
                     ...options,
                     headers,
                     signal: controller.signal,
@@ -408,6 +409,32 @@ ${isProactive
         }
         return payload;
     }
+    /**
+     * Strip content the TTS engine can't speak naturally:
+     *   - Stage-direction wrappers like (smiles), （挑眉）, [pauses], 【动作】, *grins*
+     *     — these slip through despite prompt instructions and the engine will
+     *     literally read the brackets/asterisks if left in.
+     *   - Emoji and emoji-component codepoints (Extended_Pictographic plus the
+     *     ZWJ / variation-selector / skin-tone / regional-indicator scaffolding
+     *     that builds composite emoji). TTS providers either read these aloud
+     *     as the literal Unicode name ("face with tears of joy") or produce a
+     *     glitchy artifact, both of which sound wrong.
+     *
+     * Collapses runs of whitespace introduced by removals and trims the result.
+     * Returns "" if everything gets stripped — callers should fall back to a
+     * neutral placeholder (e.g. "...") so the TTS call still has valid input.
+     */
+    sanitizeTextForVoice(text) {
+        if (typeof text !== "string")
+            return "";
+        return text
+            // (parens), （全角）, [brackets], 【全角】, *asterisks*
+            .replace(/[\(（\[【\*].*?[\)）\]】\*]/g, "")
+            // emoji + ZWJ + variation selectors + skin-tone modifiers + regional indicators
+            .replace(/[\p{Extended_Pictographic}\u200D\uFE0F\uFE0E\u{1F3FB}-\u{1F3FF}\u{1F1E6}-\u{1F1FF}]/gu, "")
+            .replace(/\s+/g, " ")
+            .trim();
+    }
     formatHistoryEntries(history, userName, agentName, promptDirective = "") {
         const contextLines = [];
         for (let i = 0; i < history.length; i++) {
@@ -642,12 +669,8 @@ Note: Always include "isEndTurn". If "imageParams", "voiceArgs", "triggerEvent",
                 const normalizedVoiceArgs = parsedIntent.voiceArgs && typeof parsedIntent.voiceArgs === "object"
                     ? parsedIntent.voiceArgs
                     : {};
-                let textForVoice = resolvedTextResponse;
-                // One final bulletproof regex wash to strip (smiles) and *laughs* just in case the LLM disobeys
-                if (typeof textForVoice === "string") {
-                    textForVoice = textForVoice.replace(/[\(（\[【\*].*?[\)）\]】\*]/g, '').trim();
-                }
-                if (typeof textForVoice !== "string" || textForVoice.trim().length === 0) {
+                let textForVoice = this.sanitizeTextForVoice(resolvedTextResponse);
+                if (textForVoice.length === 0) {
                     textForVoice = "...";
                 }
                 mediaTasks.push(this.generatePrimitive("voice", {
@@ -994,7 +1017,7 @@ Output strictly valid JSON ONLY. No markdown, no conversational filler. Return e
             dynamicArgs = {};
         }
         const res = await this.generatePrimitive("voice", {
-            text: params.text,
+            text: this.sanitizeTextForVoice(params.text) || "...",
             dynamicArgs,
         });
         return {

package/dist/llm.provider.d.ts

@@ -3,8 +3,10 @@ export declare class GenericLLMProvider implements BaseLLMProvider {
     private config;
     private backendApiUrl;
     private backendAuthToken?;
+    private fetchImpl?;
     private static templateCache;
-    constructor(config: GenericLLMConfig, backendApiUrl: string, backendAuthToken?: string | undefined);
+    constructor(config: GenericLLMConfig, backendApiUrl: string, backendAuthToken?: string | undefined, fetchImpl?: typeof fetch | undefined);
+    private get fetchFn();
     private fetchTemplate;
     private extractResponse;
     generate(messages: {

package/dist/llm.provider.js

@@ -2,11 +2,16 @@ export class GenericLLMProvider {
     config;
     backendApiUrl;
     backendAuthToken;
+    fetchImpl;
     static templateCache = new Map();
-    constructor(config, backendApiUrl, backendAuthToken) {
+    constructor(config, backendApiUrl, backendAuthToken, fetchImpl) {
         this.config = config;
         this.backendApiUrl = backendApiUrl;
         this.backendAuthToken = backendAuthToken;
+        this.fetchImpl = fetchImpl;
+    }
+    get fetchFn() {
+        return this.fetchImpl ?? fetch;
     }
     async fetchTemplate() {
         const cacheKey = `${this.config.provider}:${this.config.model}`;
@@ -24,7 +29,7 @@ export class GenericLLMProvider {
             provider: this.config.provider,
             model: this.config.model
         });
-        const resp = await fetch(`${this.backendApiUrl}/api/v1/cyber-soul/llm-models/template?${qs.toString()}`, {
+        const resp = await this.fetchFn(`${this.backendApiUrl}/api/v1/cyber-soul/llm-models/template?${qs.toString()}`, {
             headers
         });
         if (!resp.ok) {
@@ -66,7 +71,7 @@ export class GenericLLMProvider {
         if (!payload.messages || (Array.isArray(payload.messages) && payload.messages.length === 0)) {
             payload.messages = messages;
         }
-        const response = await fetch(template.apiUrl, {
+        const response = await this.fetchFn(template.apiUrl, {
             method: 'POST',
             headers,
             body: JSON.stringify(payload)

package/dist/types.d.ts

@@ -10,6 +10,15 @@ export interface CyberSoulClientConfig {
     llmConfig: GenericLLMConfig;
     requestTimeoutMs?: number;
     maxRetries?: number;
+    /**
+     * Optional fetch override. When provided, the client uses this in
+     * place of the global `fetch` for every HTTP call (backend + LLM
+     * provider). Intended for environments where the global fetch is
+     * suspended by the host platform — e.g. React Native on Samsung
+     * BBA / Doze — and a native HTTP path must be used instead. Must
+     * conform to the standard `fetch` signature.
+     */
+    fetchImpl?: typeof fetch;
 }
 export declare enum InteractRequestType {
     AUTO = "auto",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@space3-npm/cybersoul-client",
-  "version": "1.4.3",
+  "version": "1.4.4",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",