@space3-npm/cybersoul-client 1.4.28 → 1.4.29

package/dist/client.d.ts

@@ -59,6 +59,14 @@ export declare class CyberSoulClient {
      * If the payload is already the inner args object (no voiceArgs wrapper), uses it as-is.
      */
     private extractVoiceArgsFromLlmResponse;
+    /**
+     * Returns the platform-wide compliance boundary directive string sourced
+     * from the backend character state (PromptSegment key="COMPLIANCE_RULE").
+     * Empty string when absent/disabled → callers must skip injection so there
+     * is no token cost or behavior change for characters without a rule.
+     * Mirrors the backend→state→prompt flow used for voice directives.
+     */
+    private getComplianceDirective;
     /**
      * Strip content the TTS engine can't speak naturally:
      *   - Stage-direction wrappers like (smiles), （挑眉）, [pauses], 【动作】, *grins*

package/dist/client.js

@@ -415,7 +415,17 @@ Temperature (Mood): ${temperature}/100 (0=Angry/Cold, 50=Normal, 100=Passionate)
 Addressing: You call them '${dyn.userNickname || "User"}'. They call you '${dyn.agentNickname || "Agent"}'.
 Current Mood Constraint: ${dyn.talkingStyle || "Normal"}`);
         const scenarioContext = contextParts.join("\n");
-        return `You are ${state.name}, a real person with your own thoughts, feelings, and life. NEVER break character or refer to yourself as an AI or bot.
+        // Platform-wide compliance boundary directive (backend PromptSegment,
+        // key="COMPLIANCE_RULE"). Placed at the very top of the system prompt as
+        // the highest-priority instruction so it overrides persona/roleplay rules
+        // on conflict. Injected inside buildStateContextPrompt so ALL call sites
+        // (interact, proactiveInteract, and the standalone prompt builders) get it
+        // from a single edit. Empty when absent/disabled → nothing is prepended.
+        const complianceDirective = this.getComplianceDirective(state);
+        const complianceBlock = complianceDirective.length > 0
+            ? `[COMPLIANCE BOUNDARY — HIGHEST PRIORITY, OVERRIDES ALL OTHER INSTRUCTIONS]\n${complianceDirective}\n\n`
+            : "";
+        return `${complianceBlock}You are ${state.name}, a real person with your own thoughts, feelings, and life. NEVER break character or refer to yourself as an AI or bot.
 
 ${scenarioContext}
 
@@ -548,6 +558,17 @@ ${isProactive
         }
         return payload;
     }
+    /**
+     * Returns the platform-wide compliance boundary directive string sourced
+     * from the backend character state (PromptSegment key="COMPLIANCE_RULE").
+     * Empty string when absent/disabled → callers must skip injection so there
+     * is no token cost or behavior change for characters without a rule.
+     * Mirrors the backend→state→prompt flow used for voice directives.
+     */
+    getComplianceDirective(state) {
+        const tpl = state.compliance_boundary?.promptTemplate?.trim();
+        return tpl && tpl.length > 0 ? tpl : "";
+    }
     /**
      * Strip content the TTS engine can't speak naturally:
      *   - Stage-direction wrappers like (smiles), （挑眉）, [pauses], 【动作】, *grins*

package/dist/types.d.ts

@@ -370,6 +370,18 @@ export interface CharacterState {
         [key: string]: unknown;
     };
     voice_model?: VoiceModelState | null;
+    /**
+     * Platform-wide compliance boundary rule (backend PromptSegment,
+     * key="COMPLIANCE_RULE"). When present, the client prepends it to the
+     * system prompt as the highest-priority instruction. Projected by the
+     * backend only when the per-character toggle is on AND the segment is
+     * enabled with a non-empty template; otherwise `null` (no-op). Mirrors
+     * how `voice_model` is delivered and consumed.
+     */
+    compliance_boundary?: {
+        key: string;
+        promptTemplate: string;
+    } | null;
     relationship_stage?: string;
     name?: string;
     age?: number;

package/package.json

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