@mulingai-npm/redis 3.44.2 → 3.44.3

package/dist/data/listener-presence.d.ts

@@ -115,5 +115,34 @@ export declare function isListenerPresent(lastHeartbeatMs: number, isAway: boole
  *
  * So a hidden reader still costs nothing, which was the original point, and a
  * hidden listener is served, which is the product.
+ *
+ * ─── THE READER CLAUSE IS GONE, 2026-08-31 ──────────────────────────────────
+ *
+ * `isAway && !isListening` no longer excludes anybody. The test is now a live
+ * heartbeat and nothing else, and everything above about audio survives only as
+ * the reason this function stopped trusting `isAway` in the first place.
+ *
+ * The rule it replaced punished the wrong person. A guest with earbuds in and
+ * the phone in their pocket counted; a guest READING CAPTIONS who glanced at
+ * WhatsApp for twenty seconds did not. Both have a dark screen. The only thing
+ * separating them was which flag happened to be set, which is an accident, not
+ * a principle.
+ *
+ * And the cost of being dropped was never "no captions for twenty seconds". The
+ * language left the room's set, so if the room was at its ceiling meanwhile,
+ * somebody else could take the slot and the reader came back to find their
+ * language gone entirely. David decided on 2026-08-31 to count them in.
+ *
+ * WHAT THIS DOES NOT DO IS TURN ON SPEECH FOR DARK SCREENS. Synthesis is gated
+ * by `getLanguagesWithActiveListeners`, which tests `listener.isListening`
+ * itself before ever calling this and passes `true` here, so it only ever used
+ * the heartbeat half. The expensive path is unchanged.
+ *
+ * What it does cost is TRANSLATION for a language held only by people whose
+ * screens are dark, and only until they are swept as gone. Measured on
+ * 2026-08-31: one target language ran about 28 to 41 output tokens per chunk and
+ * two ran about 50 to 67, so an extra language is roughly 20 to 25 output tokens
+ * a chunk. That is the price of not stealing a reader's language while they
+ * answer a message.
  */
-export declare function isListenerConsuming(lastHeartbeatMs: number, isAway: boolean, isListening: boolean, now?: number): boolean;
+export declare function isListenerConsuming(lastHeartbeatMs: number, _isAway: boolean, _isListening: boolean, now?: number): boolean;

package/dist/data/listener-presence.js

@@ -128,16 +128,54 @@ exports.isListenerPresent = isListenerPresent;
  *
  * So a hidden reader still costs nothing, which was the original point, and a
  * hidden listener is served, which is the product.
+ *
+ * ─── THE READER CLAUSE IS GONE, 2026-08-31 ──────────────────────────────────
+ *
+ * `isAway && !isListening` no longer excludes anybody. The test is now a live
+ * heartbeat and nothing else, and everything above about audio survives only as
+ * the reason this function stopped trusting `isAway` in the first place.
+ *
+ * The rule it replaced punished the wrong person. A guest with earbuds in and
+ * the phone in their pocket counted; a guest READING CAPTIONS who glanced at
+ * WhatsApp for twenty seconds did not. Both have a dark screen. The only thing
+ * separating them was which flag happened to be set, which is an accident, not
+ * a principle.
+ *
+ * And the cost of being dropped was never "no captions for twenty seconds". The
+ * language left the room's set, so if the room was at its ceiling meanwhile,
+ * somebody else could take the slot and the reader came back to find their
+ * language gone entirely. David decided on 2026-08-31 to count them in.
+ *
+ * WHAT THIS DOES NOT DO IS TURN ON SPEECH FOR DARK SCREENS. Synthesis is gated
+ * by `getLanguagesWithActiveListeners`, which tests `listener.isListening`
+ * itself before ever calling this and passes `true` here, so it only ever used
+ * the heartbeat half. The expensive path is unchanged.
+ *
+ * What it does cost is TRANSLATION for a language held only by people whose
+ * screens are dark, and only until they are swept as gone. Measured on
+ * 2026-08-31: one target language ran about 28 to 41 output tokens per chunk and
+ * two ran about 50 to 67, so an extra language is roughly 20 to 25 output tokens
+ * a chunk. That is the price of not stealing a reader's language while they
+ * answer a message.
  */
-function isListenerConsuming(lastHeartbeatMs, isAway, isListening, now = Date.now()) {
-    const age = now - lastHeartbeatMs;
-    // Heard nothing recently: unknown, and unknown is not consuming. Covers both
-    // 'gone' and the stale-heartbeat half of 'away'.
-    if (age > exports.LISTENER_PRESENT_MS)
-        return false;
-    // Hidden and reading only. Nothing is reaching them, so nothing is made.
-    if (isAway && !isListening)
-        return false;
-    return true;
+function isListenerConsuming(lastHeartbeatMs, 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+_isAway, 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+_isListening, now = Date.now()) {
+    /*
+     * A live heartbeat, and nothing else.
+     *
+     * The two flags are still taken so that every call site keeps compiling and
+     * keeps reading as a question about a specific listener, and so that the one
+     * place that genuinely needs isListening, getLanguagesWithActiveListeners,
+     * does not have to change shape. They are deliberately ignored: see the
+     * 2026-08-31 block above for why a hidden reader now counts.
+     *
+     * Heard nothing for ninety seconds is still not consuming. That is the
+     * genuinely unknown case, and it is what a closed tab looks like when its
+     * leave beacon never fired.
+     */
+    return now - lastHeartbeatMs <= exports.LISTENER_PRESENT_MS;
 }
 exports.isListenerConsuming = isListenerConsuming;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@mulingai-npm/redis",
-    "version": "3.44.2",
+    "version": "3.44.3",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
     "repository": {