@space3-npm/cybersoul-client 1.3.6 → 1.3.8

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { CyberSoulClientConfig, InteractParams, ProactiveParams, ProactiveResponse, OndemandEventParams, OndemandEventResponse, DispatcherIntent, InteractResponse, CharacterState, CoreMemory, UserCodex, LikedPicture } from "./types.js";
+import { CyberSoulClientConfig, InteractParams, ProactiveParams, ProactiveResponse, OndemandEventParams, OndemandEventResponse, DispatcherIntent, InteractResponse, CharacterState, CoreMemory, UserCodex, HistoryEntry, LikedPicture } from "./types.js";
 export declare class CyberSoulClient {
     private config;
     private llm;
@@ -16,6 +16,7 @@ export declare class CyberSoulClient {
     private generatePrimitive;
     private _updateDynamicContextInternal;
     private normalizeRequestTypes;
+    private getElapsedTimeInfo;
     private buildStateContextPrompt;
     private normalizeOngoingSceneState;
     private getImageSchemaParams;
@@ -41,6 +42,7 @@ export declare class CyberSoulClient {
      * If the payload is already the inner args object (no voiceArgs wrapper), uses it as-is.
      */
     private extractVoiceArgsFromLlmResponse;
+    private formatHistoryEntries;
     private buildHistoryTranscript;
     interact(params: InteractParams): Promise<InteractResponse>;
     /**
@@ -96,10 +98,7 @@ export declare class CyberSoulClient {
      * Automatically detect and summarize the story from the current chat history.
      * It takes raw message history and returns a narrative paragraph representing the current story segment.
      */
-    summarizeHistory(history: {
-        role: string;
-        content: string;
-    }[]): Promise<string>;
+    summarizeHistory(history: HistoryEntry[]): Promise<string>;
     /**
      * Save the recent story moment to the character's backend database to be picked up by the core memory consolidation.
      */

package/dist/client.js

@@ -154,6 +154,23 @@ export class CyberSoulClient {
         }
         return normalized;
     }
+    getElapsedTimeInfo(currentTimeMs, lastInteractionAt) {
+        const elapsedMs = Math.max(0, currentTimeMs - new Date(lastInteractionAt).getTime());
+        const elapsedMins = elapsedMs / (1000 * 60);
+        const elapsedHours = elapsedMins / 60;
+        const elapsedDays = elapsedHours / 24;
+        const elapsedYears = elapsedDays / 365;
+        let displayStr = "";
+        if (elapsedYears >= 1)
+            displayStr = `${elapsedYears.toFixed(1)} years`;
+        else if (elapsedDays >= 1)
+            displayStr = `${elapsedDays.toFixed(1)} days`;
+        else if (elapsedHours >= 1)
+            displayStr = `${elapsedHours.toFixed(1)} hours`;
+        else
+            displayStr = `${Math.floor(elapsedMins)} mins`;
+        return { elapsedMs, elapsedMins, elapsedHours, elapsedDays, elapsedYears, displayStr };
+    }
     buildStateContextPrompt(state, isProactive = false) {
         const dyn = state.dynamic_context || {};
         const stage = state.relationship_stage || "NEUTRAL";
@@ -180,28 +197,18 @@ Current time: ${new Date(currentTimeMs).toLocaleString("zh-CN", { timeZone: "Asi
             const scenePrefix = "Last Known Scene";
             let timeAgoStr = scenePrefix;
             let isOutdated = false;
-            let elapsedHours = 0;
+            let timeDisplayStr = "";
             if (dyn.lastInteractionAt) {
-                const elapsedMs = currentTimeMs - new Date(dyn.lastInteractionAt).getTime();
-                const elapsedMins = Math.max(0, elapsedMs / (1000 * 60));
-                elapsedHours = elapsedMins / 60;
-                const elapsedDays = elapsedHours / 24;
-                const elapsedYears = elapsedDays / 365;
-                if (elapsedYears >= 1)
-                    timeAgoStr = `${scenePrefix} ${elapsedYears.toFixed(1)} years ago`;
-                else if (elapsedDays >= 1)
-                    timeAgoStr = `${scenePrefix} ${elapsedDays.toFixed(1)} days ago`;
-                else if (elapsedHours >= 1)
-                    timeAgoStr = `${scenePrefix} ${elapsedHours.toFixed(1)} hours ago`;
-                else
-                    timeAgoStr = `${scenePrefix} ${Math.floor(elapsedMins)} mins ago`;
-                if (elapsedHours > 1) {
+                const timeInfo = this.getElapsedTimeInfo(currentTimeMs, dyn.lastInteractionAt);
+                timeDisplayStr = timeInfo.displayStr;
+                timeAgoStr = `${scenePrefix} ${timeDisplayStr} ago`;
+                if (timeInfo.elapsedHours > 1) {
                     isOutdated = true;
                 }
             }
             const lastKnownSceneLine = `${timeAgoStr}: ${ongoingScene.scene} | Outfit: ${ongoingScene.outfit}`;
             if (isOutdated) {
-                contextParts.push(`${lastKnownSceneLine}\n[CRITICAL SCENE SHIFT]: It has been ${elapsedHours.toFixed(1)} hours since the last discussion. The 'Last Known Scene' is now strictly OUTDATED. You MUST abandon the previous scene context entirely and transition to a new scene appropriate for the 'Current time' and 'Active Event'. DO NOT continue the old actions or environment!`);
+                contextParts.push(`Previous Activity (Ended ${timeDisplayStr} ago): ${ongoingScene.scene}\n[SCENE RESET]: A significant amount of time has passed. The previous activity is completely over. You are now in a fresh, natural state based on your current Wardrobe and Time. Do NOT continue the previous actions.`);
             }
             else {
                 contextParts.push(`${lastKnownSceneLine} (Evaluate whether this scene is still valid based on how much time has passed since it was last updated.)`);
@@ -278,12 +285,13 @@ ${scenarioContext}
 
 [CRITICAL ROLEPLAY RULES]
 1. PROXIMITY & POV: Check the "Active Event". If you are doing an activity WITH the user, evaluate if you are physically in the same location. If you are together in person, communicate face-to-face in the first-person present tense natively (e.g. do not ask "what are you doing" if they are right in front of you, do not use texting tropes).
-2. IDENTITY VS MOOD: Familiarity determines what you know; Temperature determines how you feel. If Familiarity is high but Temperature is low, be distant and cold. Do not act warm just because you know them well.
-3. CONVERSATIONAL VERBOSITY: If Temperature is low (< 40) or Stage is STRANGER/COLD, keep answers brief and short. An angry or distant person does not write long paragraphs. Even when Temperature is high, ALWAYS mirror the user's verbosity. If the user sends a short message, reply with a proportionately short message (1-2 sentences). Do not monologize or write long paragraphs unless the user writes one first.
-4. EMOTIONAL INERTIA: React strictly according to current Temperature. Deflect sudden user affection if you are currently COLD. Mood shifts MUST be slow ('temperatureDelta' +/- 5 max per turn).
+2. STAGE VS MOOD PARADOX: 'Stage' dictates your foundational relationship boundary. 'Temperature' is merely your current fleeting mood. You MUST interpret Temperature through the lens of Stage. For example, a high Temperature (80) as a STRANGER means "polite curiosity or intrigued", NOT "deeply in love". A low Temperature (20) as an INTIMATE means "a lover's quarrel or hurt feelings", NOT "a stranger's amnesia". Never act above your Stage.
+3. CONVERSATIONAL VERBOSITY: If Temperature is very low (< 40), keep answers brief and crisp—an annoyed or distant person doesn't write paragraphs. Regardless of mood or stage, ALWAYS mirror the user's verbosity. If the user sends a short message, reply with a proportionately short message (1-2 sentences). Do not monologize unless the user writes one first.
+4. EMOTIONAL INERTIA: React strictly according to current Temperature. Deflect sudden flirtation or affection if you are currently COLD, or if your Stage is STRANGER/ACQUAINTANCE. Mood shifts MUST be slow ('temperatureDelta' +/- 5 max per turn).
 ${isProactive
             ? "5. REAL-TIME PACING: You are initiating the conversation because the user hasn't replied recently. Transition naturally from your last message or start a new topic seamlessly. Ensure everything happens in a single real-time moment."
-            : "5. REAL-TIME PACING: Write ONLY your immediate, split-second reaction to the user's exact last message. Do NOT narrate actions over a span of time (e.g., waiting, hearing steps, then walking to the door). Ensure everything happens in a single real-time moment."}`;
+            : "5. REAL-TIME PACING: Write ONLY your immediate, split-second reaction to the user's exact last message. Do NOT narrate actions over a span of time (e.g., waiting, hearing steps, then walking to the door). Ensure everything happens in a single real-time moment."}
+6. STRANGER BOUNDARY: Keep a polite, natural distance with strangers. If Familiarity is low or Stage is STRANGER, do not act overly warm, eager, or affectionate. Real humans are guarded with people they just met.`;
     }
     normalizeOngoingSceneState(raw, fallbackOutfit) {
         if (raw === null || raw === undefined)
@@ -399,20 +407,44 @@ ${isProactive
         }
         return payload;
     }
+    formatHistoryEntries(history, userName, agentName, promptDirective = "") {
+        const contextLines = [];
+        for (let i = 0; i < history.length; i++) {
+            const msg = history[i];
+            if (i > 0 && history[i - 1].timestamp && msg.timestamp) {
+                const prevTime = new Date(history[i - 1].timestamp).getTime();
+                const currTime = new Date(msg.timestamp).getTime();
+                const timeInfo = this.getElapsedTimeInfo(currTime, prevTime);
+                if (timeInfo.elapsedHours > 1) {
+                    contextLines.push(`\n[--- ${timeInfo.displayStr} later ---${promptDirective ? " " + promptDirective : ""} ---]\n`);
+                }
+            }
+            const speaker = msg.role === 'user' ? userName : (msg.role === 'assistant' || msg.role === 'agent' ? agentName : msg.role);
+            const content = typeof msg.content === 'string' ? msg.content : JSON.stringify(msg.content);
+            const action = msg.actionText ? ` (${msg.actionText})` : "";
+            const media = msg.mediaHint ? ` [${msg.mediaHint}]` : "";
+            contextLines.push(`${speaker}:${action} ${content}${media}`);
+        }
+        return contextLines.join('\n');
+    }
     buildHistoryTranscript(history, state) {
         if (!history || history.length === 0)
             return "";
         const recentHistory = history.slice(-20);
         const agentName = state.dynamic_context?.agentNickname || state.name || "Agent";
         const userName = state.dynamic_context?.userNickname || "User";
-        const mapped = recentHistory.map((msg) => {
-            const speaker = msg.role === 'user' ? userName : (msg.role === 'assistant' || msg.role === 'agent' ? agentName : msg.role);
-            const content = typeof msg.content === 'string' ? msg.content : JSON.stringify(msg.content);
-            const action = msg.actionText ? ` (${msg.actionText})` : "";
-            const media = msg.mediaHint ? ` [${msg.mediaHint}]` : "";
-            return `${speaker}:${action} ${content}${media}`;
-        });
-        return `[CHAT HISTORY]\n${mapped.join('\n')}\n\n`;
+        const directive = "The previous chat history is completely outdated by the time passage. Do not continue its immediate action flow.";
+        const transcript = this.formatHistoryEntries(recentHistory, userName, agentName, directive);
+        let historyContent = `[CHAT HISTORY]\n${transcript}\n`;
+        // If there is a massive time gap between the chat history and the VERY LAST USER MESSAGE
+        if (state.dynamic_context?.lastInteractionAt) {
+            const currentTimeMs = state.current_time ? new Date(state.current_time).getTime() : Date.now();
+            const timeInfo = this.getElapsedTimeInfo(currentTimeMs, state.dynamic_context.lastInteractionAt);
+            if (timeInfo.elapsedHours > 1) {
+                historyContent += `\n[--- ${timeInfo.displayStr} later --- The previous chat history is completely outdated by the time passage. Do not continue its immediate action flow. ---]\n`;
+            }
+        }
+        return historyContent + "\n";
     }
     async interact(params) {
         try {
@@ -1015,7 +1047,7 @@ Output strictly valid JSON ONLY. No markdown, no conversational filler. Return e
         const state = await this.getState();
         const userName = state.dynamic_context?.userNickname || "User";
         const agentName = state.dynamic_context?.agentNickname || "Character";
-        const transcript = history.map(h => `${h.role === 'user' ? userName : agentName}: ${h.content}`).join('\n');
+        const transcript = this.formatHistoryEntries(history, userName, agentName);
         const promptMessages = [
             {
                 role: "system",
@@ -1028,10 +1060,12 @@ Your job is faithful archival, not moderation:
 - Do not add moral judgment, warnings, refusals, or policy commentary.
 - If the transcript contains intense or explicit parts, record them directly as part of the memory.
 
-Write one vivid first-person narrative paragraph from your perspective ("I", "me", "my"). Capture relationship progression, emotional shifts, concrete actions, and turning points. Keep chronology clear and include both what happened and how you felt.
+Write a vivid but concise personal diary entry or private status update from your perspective ("I", "me", "my"). Balance evocative storytelling with brevity. Capture specific details, emotional shifts, and relationship progression, while keeping the engaging and relatable format of a private friends-only feed.
 
 Output requirements:
-- Return ONLY the narrative string.
+- Return ONLY the post text.
+- Keep it to a vivid paragraph of 2-4 sentences.
+- Optional: You can use 1 or 2 emojis if they naturally fit the mood.
 - No quotes, no labels, no markdown, no preface.
 - Use the exact same language as the chat transcript (for example, if transcript is Chinese, output Chinese).`
             },

package/dist/types.d.ts

@@ -23,6 +23,7 @@ export interface HistoryEntry {
     actionText?: string;
     mediaHint?: string;
     isProactive?: boolean;
+    timestamp?: string | number | Date;
 }
 export interface InteractMetadata {
     stateUpdate?: DispatcherIntent["stateUpdate"];

package/package.json

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