@space3-npm/cybersoul-client 1.3.7 → 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.)`);
@@ -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.8",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",