nexo-brain 7.31.2 → 7.31.4

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "7.31.2",
+  "version": "7.31.4",
   "description": "Local cognitive runtime for Claude Code \u2014 persistent memory, overnight learning, doctor diagnostics, personal scripts, recovery-aware jobs, startup preflight, and optional dashboard/power helper.",
   "author": {
     "name": "NEXO Brain",

package/README.md

@@ -18,9 +18,9 @@
 
 [Watch the overview video](https://nexo-brain.com/watch/) · [Watch on YouTube](https://www.youtube.com/watch?v=i2lkGhKyVqI) · [Open the infographic](https://nexo-brain.com/assets/nexo-brain-infographic-v5.png)
 
-Version `7.31.2` is the current packaged-runtime line. Patch release over v7.31.1 - the session ID becomes a durable identity (sessions survive quiet work periods; physical cleanup at 24h), runtime residents are isolated per generation so two installs can never kill each other's resident, and obsolete residents retire themselves once clients disconnect.
+Version `7.31.4` is the current packaged-runtime line. Patch release over v7.31.3 - memory recall honours absolute time ranges (ISO dates, start..end ranges, datetimes, epochs) and enforces the window in SQL, so asking about a specific past day returns that day.
 
-Previously in `7.31.1`: patch release over v7.31.0 - headless automations pause and queue when the selected engine is unavailable (credits, rate limits, expired auth) and resume automatically with one operator notice in their language; protocol nudge shaping ships in shadow mode; and the client config push stops writing an invalid `mcp__*` permission rule to Claude Code settings.
+Previously in `7.31.3`: patch release over v7.31.2 - the recommended Claude Code model returns to Opus 4.8 with max reasoning (installs riding NEXO defaults migrate back automatically; customized models untouched), and the dead heartbeat-enforcement hook trio is removed from the source tree.
 
 Previously in `7.30.33`: patch release over v7.30.32 - personal agent/script status now keeps the newest real run between manual executions and cron history, so a successful manual agent run cannot be hidden behind an older scheduled failure.
 

package/bin/nexo-brain.js

@@ -115,7 +115,7 @@ const PUBLIC_CONTRIBUTION_UPSTREAM = "wazionapps/nexo";
 const MODEL_DEFAULTS_PATH = path.join(__dirname, "..", "src", "model_defaults.json");
 function _loadModelDefaults() {
   const fallback = {
-    claude_code: { model: "claude-fable-5", reasoning_effort: "max", display_name: "Fable 5 with max reasoning" },
+    claude_code: { model: "claude-opus-4-8", reasoning_effort: "max", display_name: "Opus 4.8 with max reasoning" },
     codex: { model: "gpt-5.5", reasoning_effort: "xhigh", display_name: "GPT-5.5 with max reasoning" },
   };
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "7.31.2",
+  "version": "7.31.4",
   "mcpName": "io.github.wazionapps/nexo",
   "description": "NEXO Brain — Shared brain for AI agents. Persistent memory, semantic RAG, natural forgetting, metacognitive guard, trust scoring, 150+ MCP tools. Works with Claude Code, Codex, Claude Desktop & any MCP client. 100% local, free.",
   "homepage": "https://nexo-brain.com",

package/src/auto_update.py

@@ -2058,7 +2058,7 @@ def _refresh_resonance_tiers_model_defaults(dest: Path = NEXO_HOME) -> list[str]
         dest / "personal" / "brain" / "resonance_tiers.json",
         dest / "brain" / "resonance_tiers.json",
     ]
-    old_prefixes = ("claude-opus-4-6", "claude-opus-4-7", "claude-opus-4-8")
+    old_prefixes = ("claude-opus-4-6", "claude-opus-4-7", "claude-fable-5")
 
     for target_path in target_paths:
         try:
@@ -2089,7 +2089,7 @@ def _refresh_resonance_tiers_model_defaults(dest: Path = NEXO_HOME) -> list[str]
             model = str(claude.get("model") or "").strip()
             tier_changed = False
             if model and model.startswith(old_prefixes):
-                claude["model"] = str(source_claude.get("model") or "claude-fable-5")
+                claude["model"] = str(source_claude.get("model") or "claude-opus-4-8")
                 tier_changed = True
             if tier_changed and not str(claude.get("effort") or "").strip() and source_claude.get("effort"):
                 claude["effort"] = str(source_claude.get("effort"))

package/src/client_sync.py

@@ -83,7 +83,7 @@ except Exception:
 
     def resolve_client_runtime_profile(client: str, preferences: dict | None = None) -> dict:
         defaults = {
-            "claude_code": {"model": "claude-fable-5", "reasoning_effort": "max"},
+            "claude_code": {"model": "claude-opus-4-8", "reasoning_effort": "max"},
             "codex": {"model": "gpt-5.5", "reasoning_effort": "xhigh"},
         }
         return dict(defaults.get(client, {}))

package/src/db/_memory_v2.py

@@ -750,12 +750,23 @@ def list_memory_events(
     session_id: str = "",
     project_key: str = "",
     limit: int = 20,
+    start_ts: float | None = None,
+    end_ts: float | None = None,
 ) -> list[dict]:
     conn = _core().get_db()
     if not _table_exists(conn, "memory_events"):
         return []
     clauses = ["1=1"]
     params: list[Any] = []
+    # time_range push-down (ff78ff94): bounds must constrain the SQL fetch
+    # itself — Python-side filtering after a recency-truncated fetch made old
+    # windows return nothing.
+    if start_ts is not None:
+        clauses.append("created_at >= ?")
+        params.append(float(start_ts))
+    if end_ts is not None:
+        clauses.append("created_at < ?")
+        params.append(float(end_ts))
     if event_type.strip():
         clauses.append("event_type = ?")
         params.append(event_type.strip().lower())
@@ -798,12 +809,20 @@ def list_memory_observations(
     project_key: str = "",
     status: str = "",
     limit: int = 20,
+    start_ts: float | None = None,
+    end_ts: float | None = None,
 ) -> list[dict]:
     conn = _core().get_db()
     if not _table_exists(conn, "memory_observations"):
         return []
     clauses = ["1=1"]
     params: list[Any] = []
+    if start_ts is not None:
+        clauses.append("created_at >= ?")
+        params.append(float(start_ts))
+    if end_ts is not None:
+        clauses.append("created_at < ?")
+        params.append(float(end_ts))
     if observation_type.strip():
         clauses.append("observation_type = ?")
         params.append(observation_type.strip().lower())
@@ -845,6 +864,8 @@ def search_memory_observations_fts(
     *,
     project_key: str = "",
     limit: int = 20,
+    start_ts: float | None = None,
+    end_ts: float | None = None,
 ) -> list[dict]:
     conn = _core().get_db()
     if not _table_exists(conn, "memory_observations_fts"):
@@ -859,6 +880,12 @@ def search_memory_observations_fts(
          WHERE memory_observations_fts MATCH ?
     """
     params: list[Any] = [fts]
+    if start_ts is not None:
+        sql += " AND o.created_at >= ?"
+        params.append(float(start_ts))
+    if end_ts is not None:
+        sql += " AND o.created_at < ?"
+        params.append(float(end_ts))
     if project_key.strip():
         sql += " AND o.project_key = ?"
         params.append(project_key.strip())

package/src/managed_mcp/lock.json

@@ -39,9 +39,9 @@
     "open-computer-use": {
       "source_type": "npm",
       "package": "open-computer-use",
-      "version": "0.1.52",
-      "integrity": "sha512-KlOHmFvXHe2IEMGE/O+zMN5ASo+FQ42copj4j1xEOnyeLq4oxUxhtHqEdPUACCUcMZaHzKXfZboL1dk5a2GjLA==",
-      "tarball": "https://registry.npmjs.org/open-computer-use/-/open-computer-use-0.1.52.tgz",
+      "version": "0.1.53",
+      "integrity": "sha512-5qwCPl7Gm4Wk2i/wFkq2dVLN2SzNRQSJTd95zXdGF+u5ZsUXkFx1IFVdNbYelWOpc4fgy8Z8/gYrbacj/2chig==",
+      "tarball": "https://registry.npmjs.org/open-computer-use/-/open-computer-use-0.1.53.tgz",
       "bin": "open-computer-use-mcp",
       "engines": {}
     },

package/src/memory_retrieval.py

@@ -82,6 +82,40 @@ def _parse_time_range(value: str = "") -> tuple[float | None, float | None, str]
         unit = match.group(2)
         delta = timedelta(hours=amount) if unit.startswith("h") else timedelta(days=amount)
         return (now - delta).timestamp(), now.timestamp(), clean
+
+    # Operator bug (session ff78ff94, 11-jun): absolute values silently fell
+    # through to (None, None, "") which DISABLED the filter — asking for a
+    # specific past day returned the most recent events instead. Support ISO
+    # dates, ISO ranges (date end is inclusive: bound = next midnight), ISO
+    # datetimes, and epoch seconds / epoch ranges.
+    def _point(text, *, end_of_day=False):
+        text = text.strip()
+        if re.fullmatch(r"\d{9,}(\.\d+)?", text):
+            return float(text), False
+        try:
+            if re.fullmatch(r"\d{4}-\d{2}-\d{2}", text):
+                day = datetime.fromisoformat(text)
+                if end_of_day:
+                    return (day + timedelta(days=1)).timestamp(), True
+                return day.timestamp(), True
+            return datetime.fromisoformat(text).timestamp(), False
+        except ValueError:
+            return None, False
+
+    if ".." in clean:
+        left, _, right = clean.partition("..")
+        start_ts, _ = _point(left)
+        end_ts, _ = _point(right, end_of_day=True)
+        if start_ts is not None and end_ts is not None and end_ts > start_ts:
+            return start_ts, end_ts, f"range:{clean}"
+        return None, None, ""
+
+    point_ts, is_date = _point(clean)
+    if point_ts is not None:
+        if is_date:
+            return point_ts, point_ts + 86400, f"day:{clean}"
+        # Single datetime/epoch: a one-hour window centred forward.
+        return point_ts, point_ts + 3600, f"at:{clean}"
     return None, None, ""
 
 
@@ -177,6 +211,8 @@ def memory_search(
         clean_query,
         project_key="",
         limit=max_items * 3,
+        start_ts=start,
+        end_ts=end,
     ):
         uid = item.get("observation_uid") or f"id:{item.get('id')}"
         observations_by_uid[uid] = item
@@ -184,6 +220,8 @@ def memory_search(
         query=clean_query,
         project_key="",
         limit=max_items * 3,
+        start_ts=start,
+        end_ts=end,
     ):
         uid = item.get("observation_uid") or f"id:{item.get('id')}"
         observations_by_uid.setdefault(uid, item)
@@ -192,6 +230,8 @@ def memory_search(
         query=clean_query,
         project_key="",
         limit=max_items * 3,
+        start_ts=start,
+        end_ts=end,
     )
 
     candidates = [

package/src/model_defaults.json

@@ -1,17 +1,24 @@
 {
   "schema_version": 1,
   "claude_code": {
-    "model": "claude-fable-5",
+    "model": "claude-opus-4-8",
     "reasoning_effort": "max",
-    "display_name": "Fable 5 with max reasoning",
-    "recommendation_version": 4,
-    "previous_defaults": ["claude-opus-4-8", "claude-opus-4-7[1m]", "claude-opus-4-7", "claude-opus-4-6[1m]"]
+    "display_name": "Opus 4.8 with max reasoning",
+    "recommendation_version": 5,
+    "previous_defaults": [
+      "claude-fable-5",
+      "claude-opus-4-7[1m]",
+      "claude-opus-4-7",
+      "claude-opus-4-6[1m]"
+    ]
   },
   "codex": {
     "model": "gpt-5.5",
     "reasoning_effort": "xhigh",
     "display_name": "GPT-5.5 with max reasoning",
     "recommendation_version": 2,
-    "previous_defaults": ["gpt-5.4"]
+    "previous_defaults": [
+      "gpt-5.4"
+    ]
   }
 }

package/src/model_defaults.py

@@ -20,7 +20,7 @@ from typing import Any
 _FALLBACK: dict[str, Any] = {
     "schema_version": 1,
     "claude_code": {
-        "model": "claude-fable-5",
+        "model": "claude-opus-4-8",
         "reasoning_effort": "max",
         "display_name": "Fable 5 with max reasoning",
         "recommendation_version": 4,
@@ -99,7 +99,7 @@ def looks_like_claude_model(model: str) -> bool:
     return str(model or "").strip().lower().startswith(_CLAUDE_MODEL_PREFIXES)
 
 
-_CLAUDE_DEFAULT_PREFIXES = ("claude-opus-4-6", "claude-opus-4-7", "claude-opus-4-8")
+_CLAUDE_DEFAULT_PREFIXES = ("claude-opus-4-6", "claude-opus-4-7", "claude-opus-4-8", "claude-fable-5")
 
 
 def heal_runtime_profiles(profiles: dict) -> tuple[dict, list[str]]:

package/src/provider_circuit_breaker.py

@@ -51,7 +51,8 @@ DEFAULT_RETRY_AFTER_S = {
 _FAILURE_PATTERNS = (
     ("credits", re.compile(
         r"credit balance is too low|insufficient[_ ]quota|exceeded your current quota"
-        r"|billing hard limit|out of credits|usage limit reached|plan limits",
+        r"|billing hard limit|out of credits|usage limit reached|hit your usage limit"
+        r"|purchase more credits|plan limits",
         re.I)),
     ("rate_limit", re.compile(
         r"rate[_ -]?limit|too many requests|\b429\b|overloaded[_ ]error|\b529\b"

package/src/resonance_tiers.json

@@ -1,19 +1,19 @@
 {
   "tiers": {
     "maximo": {
-      "claude_code": { "model": "claude-fable-5", "effort": "max" },
+      "claude_code": { "model": "claude-opus-4-8", "effort": "max" },
       "codex":       { "model": "gpt-5.5",             "effort": "xhigh" }
     },
     "alto": {
-      "claude_code": { "model": "claude-fable-5", "effort": "xhigh" },
+      "claude_code": { "model": "claude-opus-4-8", "effort": "xhigh" },
       "codex":       { "model": "gpt-5.5",             "effort": "high" }
     },
     "medio": {
-      "claude_code": { "model": "claude-fable-5", "effort": "high" },
+      "claude_code": { "model": "claude-opus-4-8", "effort": "high" },
       "codex":       { "model": "gpt-5.5",             "effort": "medium" }
     },
     "bajo": {
-      "claude_code": { "model": "claude-fable-5", "effort": "medium" },
+      "claude_code": { "model": "claude-opus-4-8", "effort": "medium" },
       "codex":       { "model": "gpt-5.5",             "effort": "low" }
     },
     "muy_bajo": {

package/src/hooks/heartbeat-enforcement.py

@@ -1,103 +0,0 @@
-#!/usr/bin/env python3
-"""Heartbeat enforcement for NEXO sessions.
-
-Tracks user messages vs heartbeat calls. Emits a warning when more than two
-user messages pass without a heartbeat call.
-
-Modes:
-- HEARTBEAT_MODE=user_msg: increment counter on UserPromptSubmit
-- HEARTBEAT_MODE=post_tool: inspect PostToolUse payload, reset on heartbeat,
-  warn when other tools keep running without one
-"""
-
-from __future__ import annotations
-
-import json
-import os
-import sys
-import time
-from pathlib import Path
-
-try:
-    import paths
-except ModuleNotFoundError as exc:
-    if getattr(exc, "name", "") != "paths":
-        raise
-
-    class _PathsFallback:
-        @staticmethod
-        def operations_dir():
-            return Path(os.environ.get("NEXO_HOME", Path.home() / ".nexo")) / "operations"
-
-    paths = _PathsFallback()
-
-STATE_FILE = paths.operations_dir() / ".heartbeat-state.json"
-THRESHOLD = 2
-HEARTBEAT_TOOL = "nexo_heartbeat"
-SKIP_TOOLS = {"nexo_startup", "nexo_stop", "nexo_smart_startup"}
-
-
-def _read_state() -> dict:
-    try:
-        return json.loads(STATE_FILE.read_text())
-    except Exception:
-        return {"user_msgs": 0, "last_heartbeat_ts": 0.0, "last_user_msg_ts": 0.0}
-
-
-def _write_state(state: dict) -> None:
-    try:
-        STATE_FILE.parent.mkdir(parents=True, exist_ok=True)
-        STATE_FILE.write_text(json.dumps(state))
-    except Exception:
-        pass
-
-
-def handle_user_message() -> int:
-    state = _read_state()
-    state["user_msgs"] = state.get("user_msgs", 0) + 1
-    state["last_user_msg_ts"] = time.time()
-    _write_state(state)
-    return 0
-
-
-def handle_post_tool(payload: dict) -> int:
-    tool_name = str(payload.get("tool_name", "")).strip()
-    short_name = tool_name.rsplit("__", 1)[-1] if "__" in tool_name else tool_name
-    state = _read_state()
-
-    if short_name == HEARTBEAT_TOOL:
-        state["user_msgs"] = 0
-        state["last_heartbeat_ts"] = time.time()
-        _write_state(state)
-        return 0
-
-    if short_name in SKIP_TOOLS:
-        return 0
-
-    user_msgs = state.get("user_msgs", 0)
-    if user_msgs > THRESHOLD:
-        print(
-            f"\nWARNING: HEARTBEAT OVERDUE ({user_msgs} user messages without nexo_heartbeat). "
-            "Call nexo_heartbeat(sid=SID, task='...') before continuing."
-        )
-    return 0
-
-
-def main() -> int:
-    mode = os.environ.get("HEARTBEAT_MODE", "").strip()
-    if mode == "user_msg":
-        return handle_user_message()
-    if mode == "post_tool":
-        raw = sys.stdin.read()
-        if not raw.strip():
-            return 0
-        try:
-            payload = json.loads(raw)
-        except Exception:
-            return 0
-        return handle_post_tool(payload)
-    return 0
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())

package/src/hooks/heartbeat-posttool.sh

@@ -1,20 +0,0 @@
-#!/bin/bash
-# NEXO PostToolUse hook — heartbeat enforcement checker
-set -uo pipefail
-
-INPUT=$(cat || true)
-[ -z "$INPUT" ] && exit 0
-
-NEXO_HOME="${NEXO_HOME:-$HOME/.nexo}"
-HELPER=""
-if [ -n "${NEXO_CODE:-}" ] && [ -f "${NEXO_CODE%/}/hooks/heartbeat-enforcement.py" ]; then
-    HELPER="${NEXO_CODE%/}/hooks/heartbeat-enforcement.py"
-elif [ -f "$NEXO_HOME/core/hooks/heartbeat-enforcement.py" ]; then
-    HELPER="$NEXO_HOME/core/hooks/heartbeat-enforcement.py"
-elif [ -f "$NEXO_HOME/hooks/heartbeat-enforcement.py" ]; then
-    HELPER="$NEXO_HOME/hooks/heartbeat-enforcement.py"
-fi
-
-[ -z "$HELPER" ] && exit 0
-HEARTBEAT_MODE=post_tool python3 "$HELPER" <<< "$INPUT" 2>/dev/null || true
-exit 0

package/src/hooks/heartbeat-user-msg.sh

@@ -1,17 +0,0 @@
-#!/bin/bash
-# NEXO UserPromptSubmit hook — track user messages for heartbeat enforcement
-set -uo pipefail
-
-NEXO_HOME="${NEXO_HOME:-$HOME/.nexo}"
-HELPER=""
-if [ -n "${NEXO_CODE:-}" ] && [ -f "${NEXO_CODE%/}/hooks/heartbeat-enforcement.py" ]; then
-    HELPER="${NEXO_CODE%/}/hooks/heartbeat-enforcement.py"
-elif [ -f "$NEXO_HOME/core/hooks/heartbeat-enforcement.py" ]; then
-    HELPER="$NEXO_HOME/core/hooks/heartbeat-enforcement.py"
-elif [ -f "$NEXO_HOME/hooks/heartbeat-enforcement.py" ]; then
-    HELPER="$NEXO_HOME/hooks/heartbeat-enforcement.py"
-fi
-
-[ -z "$HELPER" ] && exit 0
-HEARTBEAT_MODE=user_msg python3 "$HELPER" 2>/dev/null || true
-exit 0