@space3-npm/cybersoul-client 1.3.7 → 1.3.9

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.)`);
@@ -335,7 +342,7 @@ ${isProactive
         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()}`;
+        return `- Include 'triggerEvent' only if the VERY LAST USER MESSAGE proposes a new activity/hangout AND you accept the invitation, explicitly requests an outfit change AND you agree, or proposes intimate/romantic actions AND you agree; ignore older history. DO NOT include it if you decline or reject the proposal. ${this.getOutfitSelectionPrompt()}`;
     }
     getOutfitAcquisitionPolicyPrompt() {
         return `- Outfit acquisition (VERY LAST USER MESSAGE only): set giftOutfit for gift/buy/add-clothes intent; otherwise null. giftOutfit format: { "descriptionText": "short outfit description" }.`;
@@ -400,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 {
@@ -1016,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",

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.7",
+  "version": "1.3.9",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",