@space3-npm/cybersoul-client 1.2.9 → 1.3.0

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { CyberSoulClientConfig, InteractParams, ProactiveParams, ProactiveResponse, OndemandEventParams, OndemandEventResponse, DispatcherIntent, InteractResponse, CharacterState, CoreMemory, UserCodex } from "./types.js";
+import { CyberSoulClientConfig, InteractParams, ProactiveParams, ProactiveResponse, OndemandEventParams, OndemandEventResponse, DispatcherIntent, InteractResponse, CharacterState, CoreMemory, UserCodex, LikedPicture } from "./types.js";
 export declare class CyberSoulClient {
     private config;
     private llm;
@@ -103,7 +103,7 @@ export declare class CyberSoulClient {
     /**
      * Save the recent story moment to the character's backend database to be picked up by the core memory consolidation.
      */
-    saveMoment(summary: string, date: string, time: string): Promise<void>;
+    saveMoment(summary: string, date: string, time: string, likedPictures?: LikedPicture[]): Promise<void>;
     /**
      * Consolidate Core Memory and User Codex using edge LLM logic and sync to remote DB
      */

package/dist/client.js

@@ -1,6 +1,6 @@
 import { InteractRequestType, } from "./types.js";
 import { robustJsonParse } from "./utils/json.utils.js";
-import { MinimaxProvider } from "./providers/minimax.provider.js";
+import { GenericLLMProvider } from "./llm.provider.js";
 export class CyberSoulClient {
     config;
     llm;
@@ -13,12 +13,7 @@ export class CyberSoulClient {
         this.requestTimeoutMs = config.requestTimeoutMs ?? 120000;
         this.maxRetries = Math.max(0, config.maxRetries ?? 1);
         // Setup Provider
-        if (config.llmConfig.provider === "minimax") {
-            this.llm = new MinimaxProvider(config.llmConfig);
-        }
-        else {
-            throw new Error(`Unsupported LLM provider: ${config.llmConfig.provider}`);
-        }
+        this.llm = new GenericLLMProvider(config.llmConfig, config.backendUrl, config.characterKey);
     }
     /**
      * Internal wrapper for fetch that automatically injects the backend URL and Character Auth token.
@@ -319,7 +314,7 @@ ${isProactive
   }`;
     }
     getOutfitSelectionPrompt() {
-        return `When generating a triggerEvent, you MUST provide a suitable 'triggerEvent.outfitId' if the VERY LAST USER MESSAGE explicitly asks for an outfit change, OR if the new activity implies a context/location shift that conflicts with the current outfit (e.g., currently in SLEEPWEAR at home but going outside). Otherwise, keep it null. When changing outfits, match it to the event's activity, environment, and relationship stage (e.g., DAILY, INTIMATE, SLEEPWEAR).`;
+        return `When generating a triggerEvent, you MUST provide a suitable 'triggerEvent.outfitId' if the VERY LAST USER MESSAGE explicitly asks for an outfit change, OR if the new activity implies a context/location shift that conflicts with the current outfit (e.g., currently in SLEEPWEAR at home but going outside). Otherwise, keep it null. When changing outfits, match it to the event's activity, environment, and relationship stage (e.g., CASUAL, COSTUME, INTIMATE, SLEEPWEAR, etc.).`;
     }
     getTriggerEventPolicyPrompt() {
         return `- Include 'triggerEvent' only if the VERY LAST USER MESSAGE proposes a new activity/hangout, explicitly requests an outfit change, or proposes intimate/romantic actions; ignore older history. ${this.getOutfitSelectionPrompt()}`;
@@ -420,7 +415,7 @@ ${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.`;
+                    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.`;
                 }
                 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.`;
@@ -474,12 +469,15 @@ USER ANALYSIS WORKFLOW:
 
 For 'isEndTurn', use true only when the interaction naturally concludes (confirmation/bye, event ending, or clear hard scene shift); otherwise false.
 
+If the user explicitly praises, loves, or stars the VERY LAST picture you sent (not general appearance, but the recent photo itself), set 'likePreviousPicture' to true in the JSON, otherwise false.
+
 Voice direction for voiceArgs: ${this.getVoiceDirectorInstruction(state)}
 
 Output JSON Schema:
 {
   "actionText": "(Scene descriptions, physical actions, expressions, inner feelings) ONLY. Never include spoken dialogue here.",
   "textResponse": "Spoken dialogue ONLY. Never include actions or parentheses.",
+  "likePreviousPicture": false,
   "stateUpdate": { "temperatureDelta": 1, "userNickname": "How character addresses user", "agentNickname": "How user addresses character", "talkingStyle": "Current speaking style", "ongoingScene": { "scene": "Current physical scene/activity", "outfit": "Current outfit wording; use 'naked' when applicable" } },
   "giftOutfit": { "descriptionText": "Concise description of the newly acquired outfit to add into wardrobe." },
   "userAnalysis": { "newFactsLearned": [{ "category": "realName|occupation|age|gender|hobby|trait|communicationStyle|boundary|preference", "value": "explicit new user fact from VERY LAST USER MESSAGE" }] },
@@ -609,6 +607,7 @@ Note: Always include "isEndTurn". If "imageParams", "voiceArgs", "triggerEvent",
                 actionText: parsedIntent.actionText || "",
                 imageUrl: finalImageUrl,
                 audioUrl: finalAudioUrl,
+                likePreviousPicture: parsedIntent.likePreviousPicture,
                 durationSec: finalDurationSec,
                 triggeredEvent: parsedIntent.triggerEvent || undefined,
                 stateUpdate: parsedIntent.stateUpdate,
@@ -769,7 +768,7 @@ CRITICAL: Output MUST be ONLY valid JSON with no markdown block wrappers. Do NOT
             // Determine modalities (reusing logic from interact)
             let modalitiesInstruction = "You are initiating conversation without a preceding user message.\\n";
             if (requestedOthers.includes(InteractRequestType.IMAGE)) {
-                modalitiesInstruction += "  - Include 'imageParams' for visual/photo requests or key visual moments; explicitly describe current clothing.\\n";
+                modalitiesInstruction += "  - Include 'imageParams' for visual/photo moments. CRITICAL POLICY: NEVER send pictures to strangers! If Stage is STRANGER or COLD, or Familiarity is very low (< 10), ALWAYS set 'imageParams' to null.\\n";
             }
             else {
                 modalitiesInstruction += "  - ALWAYS set 'imageParams' to null.\\n";
@@ -1006,13 +1005,14 @@ Output requirements:
     /**
      * Save the recent story moment to the character's backend database to be picked up by the core memory consolidation.
      */
-    async saveMoment(summary, date, time) {
+    async saveMoment(summary, date, time, likedPictures) {
         const res = await this.apiFetch("/api/v1/cyber-soul/characters/moments", {
             method: "POST",
             body: JSON.stringify({
                 summary,
                 date,
                 time,
+                likedPictures,
             }),
         });
         if (!res.ok) {

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export * from './types.js';
 export * from './client.js';
-export * from './providers/minimax.provider.js';
+export * from './llm.provider.js';

package/dist/index.js

@@ -1,3 +1,3 @@
 export * from './types.js';
 export * from './client.js';
-export * from './providers/minimax.provider.js';
+export * from './llm.provider.js';

package/dist/llm.provider.d.ts

@@ -0,0 +1,14 @@
+import { BaseLLMProvider, GenericLLMConfig } from './types.js';
+export declare class GenericLLMProvider implements BaseLLMProvider {
+    private config;
+    private backendApiUrl;
+    private backendAuthToken?;
+    private static templateCache;
+    constructor(config: GenericLLMConfig, backendApiUrl: string, backendAuthToken?: string | undefined);
+    private fetchTemplate;
+    private extractResponse;
+    generate(messages: {
+        role: string;
+        content: string;
+    }[], maxTokens?: number, temperature?: number): Promise<string>;
+}

package/dist/llm.provider.js

@@ -0,0 +1,85 @@
+export class GenericLLMProvider {
+    config;
+    backendApiUrl;
+    backendAuthToken;
+    static templateCache = new Map();
+    constructor(config, backendApiUrl, backendAuthToken) {
+        this.config = config;
+        this.backendApiUrl = backendApiUrl;
+        this.backendAuthToken = backendAuthToken;
+    }
+    async fetchTemplate() {
+        const cacheKey = `${this.config.provider}:${this.config.model}`;
+        if (GenericLLMProvider.templateCache.has(cacheKey)) {
+            return GenericLLMProvider.templateCache.get(cacheKey);
+        }
+        // Need an auth token to call the backend APIs
+        const headers = {
+            'Content-Type': 'application/json'
+        };
+        if (this.backendAuthToken) {
+            headers['Authorization'] = `Bearer ${this.backendAuthToken}`;
+        }
+        const qs = new URLSearchParams({
+            provider: this.config.provider,
+            model: this.config.model
+        });
+        const resp = await fetch(`${this.backendApiUrl}/api/v1/cyber-soul/llm-models/template?${qs.toString()}`, {
+            headers
+        });
+        if (!resp.ok) {
+            throw new Error(`Failed to fetch LLM generic template: ${resp.status}`);
+        }
+        const template = await resp.json();
+        GenericLLMProvider.templateCache.set(cacheKey, template);
+        return template;
+    }
+    extractResponse(data, responsePath) {
+        const parts = responsePath.split('.');
+        let cursor = data;
+        for (const part of parts) {
+            if (cursor === undefined || cursor === null)
+                return '';
+            cursor = cursor[part];
+        }
+        if (typeof cursor !== 'string') {
+            throw new Error(`Extraction resulted in non-string type: ${typeof cursor}`);
+        }
+        return cursor;
+    }
+    async generate(messages, maxTokens = 1500, temperature = 0.7) {
+        const template = await this.fetchTemplate();
+        const headers = { ...template.headersTemplate };
+        if (this.config.apiKey) {
+            for (const key of Object.keys(headers)) {
+                if (typeof headers[key] === 'string') {
+                    headers[key] = headers[key].replace('{{apiKey}}', this.config.apiKey);
+                }
+            }
+        }
+        const payload = { ...template.basePayload };
+        if (this.config.customSettings) {
+            Object.assign(payload, this.config.customSettings);
+        }
+        // We only explicitly map messages. Parameters like temperature or max_tokens
+        // should be defined in basePayload, customSettings, or configured via the UI.
+        if (!payload.messages || (Array.isArray(payload.messages) && payload.messages.length === 0)) {
+            payload.messages = messages;
+        }
+        const response = await fetch(template.apiUrl, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(payload)
+        });
+        if (!response.ok) {
+            throw new Error(`Generic API returned status: ${response.status}`);
+        }
+        const data = await response.json();
+        try {
+            return this.extractResponse(data, template.responsePath || 'choices.0.message.content');
+        }
+        catch (e) {
+            throw new Error(`Failed to extract response. Error: ${e?.message}`);
+        }
+    }
+}

package/dist/providers/generic-llm.provider.d.ts

@@ -0,0 +1,14 @@
+import { BaseLLMProvider, GenericLLMConfig } from '../types.js';
+export declare class GenericLLMProvider implements BaseLLMProvider {
+    private config;
+    private backendApiUrl;
+    private backendAuthToken?;
+    private static templateCache;
+    constructor(config: GenericLLMConfig, backendApiUrl: string, backendAuthToken?: string | undefined);
+    private fetchTemplate;
+    private extractResponse;
+    generate(messages: {
+        role: string;
+        content: string;
+    }[], maxTokens?: number, temperature?: number): Promise<string>;
+}

package/dist/providers/generic-llm.provider.js

@@ -0,0 +1,85 @@
+export class GenericLLMProvider {
+    config;
+    backendApiUrl;
+    backendAuthToken;
+    static templateCache = new Map();
+    constructor(config, backendApiUrl, backendAuthToken) {
+        this.config = config;
+        this.backendApiUrl = backendApiUrl;
+        this.backendAuthToken = backendAuthToken;
+    }
+    async fetchTemplate() {
+        const cacheKey = `${this.config.provider}:${this.config.model}`;
+        if (GenericLLMProvider.templateCache.has(cacheKey)) {
+            return GenericLLMProvider.templateCache.get(cacheKey);
+        }
+        // Need an auth token to call the backend APIs
+        const headers = {
+            'Content-Type': 'application/json'
+        };
+        if (this.backendAuthToken) {
+            headers['Authorization'] = `Bearer ${this.backendAuthToken}`;
+        }
+        const qs = new URLSearchParams({
+            provider: this.config.provider,
+            model: this.config.model || ''
+        });
+        const resp = await fetch(`${this.backendApiUrl}/api/v1/cyber-soul/llm-models/template?${qs.toString()}`, {
+            headers
+        });
+        if (!resp.ok) {
+            throw new Error(`Failed to fetch LLM generic template: ${resp.status}`);
+        }
+        const template = await resp.json();
+        GenericLLMProvider.templateCache.set(cacheKey, template);
+        return template;
+    }
+    extractResponse(data, responsePath) {
+        const parts = responsePath.split('.');
+        let cursor = data;
+        for (const part of parts) {
+            if (cursor === undefined || cursor === null)
+                return '';
+            cursor = cursor[part];
+        }
+        if (typeof cursor !== 'string') {
+            throw new Error(`Extraction resulted in non-string type: ${typeof cursor}`);
+        }
+        return cursor;
+    }
+    async generate(messages, maxTokens = 1500, temperature = 0.7) {
+        if (!this.config.apiKey) {
+            throw new Error("Missing Generic Provider API Key");
+        }
+        const template = await this.fetchTemplate();
+        const headers = { ...template.headersTemplate };
+        for (const key of Object.keys(headers)) {
+            if (typeof headers[key] === 'string') {
+                headers[key] = headers[key].replace('{{apiKey}}', this.config.apiKey);
+            }
+        }
+        const payload = { ...template.basePayload };
+        if (this.config.customSettings) {
+            Object.assign(payload, this.config.customSettings);
+        }
+        // We only explicitly map messages. Parameters like temperature or max_tokens
+        // should be defined in basePayload, customSettings, or configured via the UI.
+        if (!payload.messages)
+            payload.messages = messages;
+        const response = await fetch(template.apiUrl, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(payload)
+        });
+        if (!response.ok) {
+            throw new Error(`Generic API returned status: ${response.status}`);
+        }
+        const data = await response.json();
+        try {
+            return this.extractResponse(data, template.responsePath || 'choices.0.message.content');
+        }
+        catch (e) {
+            throw new Error(`Failed to extract response. Error: ${e?.message}`);
+        }
+    }
+}

package/dist/types.d.ts

@@ -1,12 +1,13 @@
-export interface LLMConfig {
-    provider: "minimax";
+export interface GenericLLMConfig {
+    provider: string;
     apiKey: string;
     model: string;
+    customSettings?: Record<string, any>;
 }
 export interface CyberSoulClientConfig {
     characterKey: string;
     backendUrl: string;
-    llmConfig: LLMConfig;
+    llmConfig: GenericLLMConfig;
     requestTimeoutMs?: number;
     maxRetries?: number;
 }
@@ -61,10 +62,21 @@ export interface OndemandEventResponse {
     scheduledDateStr?: string;
     error?: string;
 }
+export declare enum WardrobeCategory {
+    CASUAL = "CASUAL",
+    FORMAL = "FORMAL",
+    WORKWEAR = "WORKWEAR",
+    SPORTSWEAR = "SPORTSWEAR",
+    SWIMWEAR = "SWIMWEAR",
+    COSTUME = "COSTUME",
+    SLEEPWEAR = "SLEEPWEAR",
+    INTIMATE = "INTIMATE",
+    DAILY = "DAILY"
+}
 export interface WardrobeItem {
     id: string;
     itemName: string;
-    category: string;
+    category: WardrobeCategory;
     promptModifier: string;
 }
 export interface InteractResponse {
@@ -73,6 +85,7 @@ export interface InteractResponse {
     actionText?: string;
     imageUrl?: string;
     audioUrl?: string;
+    likePreviousPicture?: boolean;
     durationSec?: number;
     triggeredEvent?: {
         eventTitle?: string;
@@ -93,6 +106,7 @@ export interface DispatcherIntent {
     textResponse?: string;
     actionText?: string;
     imageParams?: any;
+    likePreviousPicture?: boolean;
     voiceArgs?: VoiceArgs | null;
     giftOutfit?: {
         descriptionText: string;
@@ -262,3 +276,8 @@ export interface ICharacterProfile {
     visualCustomConfig?: Record<string, Record<string, unknown>>;
     [key: string]: unknown;
 }
+export interface LikedPicture {
+    url: string;
+    date: string;
+    mediaId?: string;
+}

package/dist/types.js

@@ -5,3 +5,15 @@ export var InteractRequestType;
     InteractRequestType["IMAGE"] = "image";
     InteractRequestType["VOICE"] = "voice";
 })(InteractRequestType || (InteractRequestType = {}));
+export var WardrobeCategory;
+(function (WardrobeCategory) {
+    WardrobeCategory["CASUAL"] = "CASUAL";
+    WardrobeCategory["FORMAL"] = "FORMAL";
+    WardrobeCategory["WORKWEAR"] = "WORKWEAR";
+    WardrobeCategory["SPORTSWEAR"] = "SPORTSWEAR";
+    WardrobeCategory["SWIMWEAR"] = "SWIMWEAR";
+    WardrobeCategory["COSTUME"] = "COSTUME";
+    WardrobeCategory["SLEEPWEAR"] = "SLEEPWEAR";
+    WardrobeCategory["INTIMATE"] = "INTIMATE";
+    WardrobeCategory["DAILY"] = "DAILY";
+})(WardrobeCategory || (WardrobeCategory = {}));

package/package.json

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