@space3-npm/cybersoul-client 1.4.20 → 1.4.22

package/dist/client.d.ts

@@ -29,6 +29,11 @@ export declare class CyberSoulClient {
     private _updateDynamicContextInternal;
     private normalizeRequestTypes;
     private getElapsedTimeInfo;
+    /**
+     * Calculate time period from a timestamp.
+     * Pre-computes morning/afternoon/evening to reduce LLM cognitive load.
+     */
+    private getTimePeriodInfo;
     private buildStateContextPrompt;
     private normalizeOngoingSceneState;
     private getImageSchemaParams;

package/dist/client.js

@@ -258,6 +258,41 @@ export class CyberSoulClient {
             displayStr = `${Math.floor(elapsedMins)} mins`;
         return { elapsedMs, elapsedMins, elapsedHours, elapsedDays, elapsedYears, displayStr };
     }
+    /**
+     * Calculate time period from a timestamp.
+     * Pre-computes morning/afternoon/evening to reduce LLM cognitive load.
+     */
+    getTimePeriodInfo(timeMs) {
+        const date = new Date(timeMs);
+        const hour = parseInt(date.toLocaleString("zh-CN", {
+            timeZone: "Asia/Shanghai",
+            hour: "2-digit",
+            hour12: false,
+        }).split(":")[0]);
+        let period;
+        if (hour >= 6 && hour < 9) {
+            period = "Early Morning";
+        }
+        else if (hour >= 9 && hour < 12) {
+            period = "Late Morning";
+        }
+        else if (hour >= 12 && hour < 13) {
+            period = "Noon";
+        }
+        else if (hour >= 13 && hour < 18) {
+            period = "Afternoon";
+        }
+        else if (hour >= 18 && hour < 19) {
+            period = "Evening";
+        }
+        else if (hour >= 19 && hour < 23) {
+            period = "Night";
+        }
+        else {
+            period = "Late Night";
+        }
+        return { hour, period };
+    }
     buildStateContextPrompt(state, isProactive = false) {
         const dyn = state.dynamic_context || {};
         const stage = state.relationship_stage || "NEUTRAL";
@@ -275,8 +310,10 @@ Communication Style: ${state.communication_style || "None"}
 Interaction Boundaries: ${state.interaction_boundaries || "None"}`);
         // [2] SITUATIONAL CONTEXT
         const currentTimeMs = state.current_time ? new Date(state.current_time).getTime() : Date.now();
+        const timePeriod = this.getTimePeriodInfo(currentTimeMs);
+        const timeStr = new Date(currentTimeMs).toLocaleString("zh-CN", { timeZone: "Asia/Shanghai" });
         contextParts.push(`\n[SITUATIONAL CONTEXT]
-Current time: ${new Date(currentTimeMs).toLocaleString("zh-CN", { timeZone: "Asia/Shanghai" })}`);
+Current time: ${timeStr} (${timePeriod.period})`);
         if (dyn.lastInteractionAt) {
             contextParts.push(`Last interaction at: ${new Date(dyn.lastInteractionAt).toLocaleString("zh-CN", { timeZone: "Asia/Shanghai" })}`);
         }
@@ -1061,23 +1098,40 @@ CRITICAL: Output MUST be ONLY valid JSON with no markdown block wrappers. Do NOT
      */
     async proactiveInteract(params) {
         try {
-            // 1. Spam guard (the only hard-coded gate). Counts assistant messages
-            //    since the last user reply; bails out if the user has clearly
-            //    stopped responding.
+            // 1. Spam guard (the only hard-coded gate). Counts assistant
+            //    *turns* since the last user reply; bails out if the user has
+            //    clearly stopped responding.
+            //
+            //    A single character response can be emitted as multiple
+            //    HistoryEntry rows (one per modality: text + image + voice).
+            //    The host typically writes them within seconds of each other.
+            //    Counting entries directly would treat one multimodal reply
+            //    as 2-3 "unreplied messages" and trip `maxUnreplied = 2` on
+            //    the very first proactive attempt. Collapse consecutive
+            //    assistant entries whose timestamps are within
+            //    SAME_TURN_WINDOW_MS into a single turn before counting.
             const history = params.history || [];
             const maxUnreplied = params.maxUnreplied ?? 2;
+            const SAME_TURN_WINDOW_MS = 60_000;
             let consecutiveProactive = 0;
+            let lastAssistantTs = null;
             for (let i = history.length - 1; i >= 0; i--) {
                 const msg = history[i];
                 if (msg.role === "user")
                     break;
-                if (msg.role === "assistant")
+                if (msg.role !== "assistant")
+                    continue;
+                const ts = typeof msg.timestamp === "number" ? msg.timestamp : 0;
+                if (lastAssistantTs === null ||
+                    Math.abs(lastAssistantTs - ts) > SAME_TURN_WINDOW_MS) {
                     consecutiveProactive++;
+                }
+                lastAssistantTs = ts;
             }
             if (consecutiveProactive >= maxUnreplied) {
                 return {
                     status: "skipped",
-                    reason: `Spam guard: ${consecutiveProactive} consecutive un-replied messages already sent.`,
+                    reason: `Spam guard: ${consecutiveProactive} consecutive un-replied turns already sent.`,
                 };
             }
             // 2. Fetch state. baseContext below already includes stage,

package/package.json

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