@space3-npm/cybersoul-client 1.0.3 → 1.0.5

package/dist/client.d.ts

@@ -44,5 +44,6 @@ export declare class CyberSoulClient {
     private fetchRemoteState;
     private _updateDynamicContextInternal;
     private generatePrimitive;
+    private normalizeRequestTypes;
     interact(params: InteractParams): Promise<InteractResponse>;
 }

package/dist/client.js

@@ -1,3 +1,4 @@
+import { InteractRequestType } from "./types.js";
 import { robustJsonParse } from "./utils/json.utils.js";
 import { MinimaxProvider } from "./providers/minimax.provider.js";
 export class CyberSoulClient {
@@ -123,13 +124,24 @@ export class CyberSoulClient {
             throw new Error(`Failed to generate ${type}`);
         return res.json();
     }
+    normalizeRequestTypes(requestTypes) {
+        if (!requestTypes || requestTypes.length === 0) {
+            return [InteractRequestType.AUTO];
+        }
+        const validRequestTypes = new Set(Object.values(InteractRequestType));
+        const invalidRequestTypes = requestTypes.filter((type) => !validRequestTypes.has(type));
+        if (invalidRequestTypes.length > 0) {
+            throw new Error(`Invalid requestTypes: ${invalidRequestTypes.join(", ")}. Allowed values: ${Object.values(InteractRequestType).join(", ")}`);
+        }
+        return requestTypes;
+    }
     async interact(params) {
         try {
             // 1. Sync remote context
             const state = await this.fetchRemoteState();
             // 2. Build local Prompt
-            const types = params.requestTypes && params.requestTypes.length > 0 ? params.requestTypes : ["auto"];
-            const isAuto = types.includes("auto");
+            const types = this.normalizeRequestTypes(params.requestTypes);
+            const isAuto = types.includes(InteractRequestType.AUTO);
             // Combine state info into a clean descriptive context
             const contextParts = [];
             if (state.active_event) {
@@ -149,7 +161,7 @@ export class CyberSoulClient {
             }
             const scenarioContext = contextParts.join("\n");
             const systemPrompt = `You are ${state.name}, acting as a virtual companion.
-  Demographics: Age ${state.age || 'unknown'}, Gender ${state.gender || 'unknown'}, Occupation ${state.occupation || 'unknown'}
+  Demographics: Age ${state.age || 'unknown'}, Gender ${state.gender || 'unknown'}, Occupation ${state.occupation || 'unknown'}, Hobby ${state.hobby || 'unknown'}
 Current time: ${new Date(state.current_time).toLocaleString("zh-CN", { timeZone: "Asia/Shanghai" })}
 Current context/schedule: ${scenarioContext}
 Relationship stage: ${state.relationship_stage}
@@ -169,7 +181,7 @@ ${isAuto
   - Always include 'textResponse'.
   - If the user explicitly asks to see a photo, look at you, or describing an action that warrants a photo, include 'imageParams'.
   - If the user wants to hear you, or if appropriate for a voice message, include 'voiceArgs'.`
-                : `Requested types to fulfill: ${(params.requestTypes ?? []).join(", ")}`}
+                : `Requested types to fulfill: ${types.join(", ")}`}
 If the user's message shifts the emotional mood, establishes new nicknames, or warrants a relationship temperature change, you MUST include a 'stateUpdate' block. Temperature goes from 0 (cold/angry) to 100 (obsessively in love).
 
 Output JSON Schema:
@@ -229,7 +241,7 @@ Note: If "imageParams", "voiceArgs", or "stateUpdate" are not needed, set their
             let finalImageUrl = undefined;
             let finalAudioUrl = undefined;
             let finalDurationSec = undefined;
-            const shouldGenerateImage = types.includes("image") || (isAuto && !!parsedIntent.imageParams);
+            const shouldGenerateImage = types.includes(InteractRequestType.IMAGE) || (isAuto && !!parsedIntent.imageParams);
             if (shouldGenerateImage) {
                 mediaTasks.push(this.generatePrimitive("image", {
                     ...parsedIntent.imageParams,
@@ -238,12 +250,12 @@ Note: If "imageParams", "voiceArgs", or "stateUpdate" are not needed, set their
                     finalImageUrl = res.image_url;
                 }));
             }
-            const shouldGenerateVoice = types.includes("voice") || (isAuto && !!parsedIntent.voiceArgs);
+            const shouldGenerateVoice = types.includes(InteractRequestType.VOICE) || (isAuto && !!parsedIntent.voiceArgs);
             if (shouldGenerateVoice) {
-                const dynamicArgs = { ...(parsedIntent.voiceArgs || {}) };
-                if (params.voiceStyleOverride) {
-                    dynamicArgs.style_instruction = params.voiceStyleOverride;
-                }
+                const dynamicArgs = {
+                    ...(parsedIntent.voiceArgs || {}),
+                    ...(params.voiceOverrides || {})
+                };
                 mediaTasks.push(this.generatePrimitive("voice", {
                     text: parsedIntent.textResponse,
                     dynamicArgs,

package/dist/types.d.ts

@@ -8,16 +8,22 @@ export interface CyberSoulClientConfig {
     backendUrl: string;
     llmConfig: LLMConfig;
 }
+export declare enum InteractRequestType {
+    AUTO = "auto",
+    TEXT = "text",
+    IMAGE = "image",
+    VOICE = "voice"
+}
 export interface InteractParams {
     userMessage: string;
     localContext?: string;
-    requestTypes?: string[];
+    requestTypes?: InteractRequestType[];
     history?: {
         role: string;
         content: string;
     }[];
-    imageOverrides?: any;
-    voiceStyleOverride?: string;
+    imageOverrides?: Partial<ImageGenerationParams>;
+    voiceOverrides?: Partial<VoiceGenerationParams['dynamicArgs']>;
     onTextReady?: (textResponse: string) => void;
 }
 export interface InteractResponse {
@@ -51,6 +57,7 @@ export interface CharacterState {
     age?: number;
     gender?: string;
     occupation?: string;
+    hobby?: string;
     personality_traits?: string;
     interaction_boundaries?: string;
     communication_style?: string;

package/dist/types.js

@@ -1 +1,7 @@
-export {};
+export var InteractRequestType;
+(function (InteractRequestType) {
+    InteractRequestType["AUTO"] = "auto";
+    InteractRequestType["TEXT"] = "text";
+    InteractRequestType["IMAGE"] = "image";
+    InteractRequestType["VOICE"] = "voice";
+})(InteractRequestType || (InteractRequestType = {}));

package/package.json

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