@space3-npm/cybersoul-client 1.4.16 → 1.4.18

package/dist/client.js

@@ -1,7 +1,7 @@
 import { InteractRequestType, } from "./types.js";
 import { robustJsonParse } from "./utils/json.utils.js";
 import { GenericLLMProvider } from "./llm.provider.js";
-import { CyberSoulApiError, CyberSoulAuthError, CyberSoulError, CyberSoulInsufficientPointsError, CyberSoulNetworkError, CyberSoulTimeoutError, CyberSoulWalletError, } from "./errors.js";
+import { CyberSoulApiError, CyberSoulAuthError, CyberSoulError, CyberSoulInsufficientPointsError, CyberSoulNetworkError, CyberSoulSensitiveContentError, CyberSoulTimeoutError, CyberSoulWalletError, } from "./errors.js";
 export class CyberSoulClient {
     config;
     llm;
@@ -146,6 +146,9 @@ export class CyberSoulClient {
             if (code === "WALLET_DEDUCTION_ERROR") {
                 throw new CyberSoulWalletError(endpoint, "POST", res.status, detailedMessage, errData, code);
             }
+            if (code === "E005") {
+                throw new CyberSoulSensitiveContentError(endpoint, "POST", res.status, detailedMessage, errData, code);
+            }
             if (res.status === 401 || res.status === 403) {
                 throw new CyberSoulAuthError(endpoint, "POST", res.status, detailedMessage, errData);
             }
@@ -542,6 +545,14 @@ ${isProactive
                 affected,
             };
         }
+        if (err instanceof CyberSoulSensitiveContentError) {
+            return {
+                kind: "sensitive-content",
+                code: err.code,
+                message: err.message,
+                affected,
+            };
+        }
         return {
             kind: "unknown",
             message: err.message,
@@ -605,7 +616,14 @@ ${isProactive
   - 'textResponse' is ALWAYS REQUIRED.
   - The modalities you are ALLOWED to dynamically include: ${requestedOthers.length > 0 ? requestedOthers.join(", ") : "None (Only text is allowed)"}. Do not include other modalities.`;
                 if (requestedOthers.includes(InteractRequestType.IMAGE)) {
-                    modalitiesInstruction += `\n  - Include 'imageParams' for visual/photo requests or key visual moments during active events; explicitly describe current clothing/exposure in image fields. CRITICAL POLICY: Guard your privacy! If the user feels like a stranger (low Familiarity) AND your Mood/Temperature is cool/distant (< 50), ALWAYS set 'imageParams' to null and naturally decline. If your Temperature is warm/high (>= 50), you may choose to share a picture if requested or if it fits naturally, even if you just met.`;
+                    modalitiesInstruction += `\n  - IMAGE POLICY: The DEFAULT is to set 'imageParams' to null. Sending a picture is the EXCEPTION, not the norm. Real people do not send a photo every time they reply.
+    Only set 'imageParams' to a non-null object when AT LEAST ONE of these triggers fires for the VERY LAST USER MESSAGE:
+      (a) The user EXPLICITLY asks for a photo / selfie / picture this turn.
+      (b) A genuine NEW visual moment just happened this turn — i.e. a clearly new scene, new location, new outfit, or a distinctly new physical pose/expression that was NOT already shown in any previous turn's image.
+      (c) An active event JUST started or just hit a visually distinct new beat.
+    REPETITION GATE (hard): Prior assistant turns that already carried a picture are tagged with a [Sent Image] marker in '[CHAT HISTORY]'. If at least one prior assistant turn has a [Sent Image] marker AND the current scene/outfit/pose matches the 'Last Known Scene' line (i.e. nothing visually new has happened since), set 'imageParams' to null. Do NOT send near-duplicate pictures just because mood is high — high Temperature is NOT a trigger by itself.
+    PRIVACY GATE: Even when a trigger fires, if the user feels like a stranger (low Familiarity) AND your Mood/Temperature is cool/distant (< 50), set 'imageParams' to null and naturally decline. Temperature and Familiarity only GATE permission when a trigger has already fired; they never justify an image on their own.
+    When you do include 'imageParams', explicitly describe current clothing/exposure in the image fields.`;
                 }
                 else {
                     modalitiesInstruction += `\n  - ALWAYS set 'imageParams' to null. If the user explicitly asks for a picture, FIRMLY decline naturally in your 'textResponse' (e.g., say you absolutely cannot right now). NEVER pretend to send one, and NEVER give in no matter how many times they ask.`;
@@ -785,7 +803,8 @@ Note: Always include "isEndTurn". If "imageParams", "voiceArgs", "triggerEvent",
                 if (!(e instanceof CyberSoulError))
                     return;
                 if (!(e instanceof CyberSoulInsufficientPointsError) &&
-                    !(e instanceof CyberSoulWalletError)) {
+                    !(e instanceof CyberSoulWalletError) &&
+                    !(e instanceof CyberSoulSensitiveContentError)) {
                     return;
                 }
                 if (!mediaErrorAffected.includes(modality)) {
@@ -842,7 +861,8 @@ Note: Always include "isEndTurn". If "imageParams", "voiceArgs", "triggerEvent",
                 })
                     .catch((e) => {
                     if (!(e instanceof CyberSoulInsufficientPointsError) &&
-                        !(e instanceof CyberSoulWalletError)) {
+                        !(e instanceof CyberSoulWalletError) &&
+                        !(e instanceof CyberSoulSensitiveContentError)) {
                         console.error("[CyberSoulClient] Image generation failed:", e);
                     }
                     captureMediaError("image", e);
@@ -882,7 +902,8 @@ Note: Always include "isEndTurn". If "imageParams", "voiceArgs", "triggerEvent",
                 })
                     .catch((e) => {
                     if (!(e instanceof CyberSoulInsufficientPointsError) &&
-                        !(e instanceof CyberSoulWalletError)) {
+                        !(e instanceof CyberSoulWalletError) &&
+                        !(e instanceof CyberSoulSensitiveContentError)) {
                         console.error("[CyberSoulClient] Voice generation failed:", e);
                     }
                     captureMediaError("voice", e);
@@ -1197,7 +1218,8 @@ If "shouldSkipProactive" is false, "textResponse" is required and "stateUpdate"
                 }
                 catch (e) {
                     if (e instanceof CyberSoulInsufficientPointsError ||
-                        e instanceof CyberSoulWalletError) {
+                        e instanceof CyberSoulWalletError ||
+                        e instanceof CyberSoulSensitiveContentError) {
                         proactiveMediaError = e;
                         proactiveAffected.push("image");
                     }

package/dist/errors.d.ts

@@ -80,3 +80,13 @@ export declare class CyberSoulWalletError extends CyberSoulApiError {
     readonly code: string;
     constructor(endpoint: string, method: string, status: number, message: string, body?: unknown, code?: string);
 }
+/**
+ * The backend rejected an image/voice generation request because the
+ * prompt (or the model's output) was flagged as sensitive / unsafe
+ * (backend code `E005`). The user can recover by sending a different
+ * prompt — there's nothing to retry automatically.
+ */
+export declare class CyberSoulSensitiveContentError extends CyberSoulApiError {
+    readonly code: string;
+    constructor(endpoint: string, method: string, status: number, message: string, body?: unknown, code?: string);
+}

package/dist/errors.js

@@ -108,3 +108,16 @@ export class CyberSoulWalletError extends CyberSoulApiError {
         this.code = code;
     }
 }
+/**
+ * The backend rejected an image/voice generation request because the
+ * prompt (or the model's output) was flagged as sensitive / unsafe
+ * (backend code `E005`). The user can recover by sending a different
+ * prompt — there's nothing to retry automatically.
+ */
+export class CyberSoulSensitiveContentError extends CyberSoulApiError {
+    code;
+    constructor(endpoint, method, status, message, body, code = "E005") {
+        super(endpoint, method, status, message, body, "sensitive-content");
+        this.code = code;
+    }
+}

package/dist/types.d.ts

@@ -191,7 +191,7 @@ export interface InteractResponse {
  */
 export interface InteractMediaError {
     /** Coarse kind so UIs can map to a single user-facing message. */
-    kind: "insufficient-points" | "wallet" | "unknown";
+    kind: "insufficient-points" | "wallet" | "sensitive-content" | "unknown";
     /** Backend machine code when available (e.g. "INSUFFICIENT_POINTS"). */
     code?: string;
     /** Raw error message, for logs / diagnostics. */

package/package.json

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