@space3-npm/cybersoul-client 1.4.16 → 1.4.17

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,
@@ -785,7 +796,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 +854,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 +895,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 +1211,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.17",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",