nexo-brain 5.3.26 → 5.3.28

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (212) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/package.json +1 -1
  3. package/src/hook_guardrails.py +44 -0
  4. package/src/server.py +3 -0
  5. package/src/tools_sessions.py +6 -1
  6. package/src/dashboard/static/favicon 2.svg +0 -32
  7. package/src/dashboard/static/nexo-logo 2.png +0 -0
  8. package/src/dashboard/static/nexo-logo 2.svg +0 -40
  9. package/src/dashboard/static/style 2.css +0 -2458
  10. package/src/dashboard/templates/adaptive 2.html +0 -118
  11. package/src/dashboard/templates/artifacts 2.html +0 -133
  12. package/src/dashboard/templates/backups 2.html +0 -136
  13. package/src/dashboard/templates/base 2.html +0 -417
  14. package/src/dashboard/templates/calendar 2.html +0 -591
  15. package/src/dashboard/templates/chat 2.html +0 -356
  16. package/src/dashboard/templates/claims 2.html +0 -259
  17. package/src/dashboard/templates/cortex 2.html +0 -321
  18. package/src/dashboard/templates/credentials 2.html +0 -128
  19. package/src/dashboard/templates/crons 2.html +0 -370
  20. package/src/dashboard/templates/dashboard 2.html +0 -494
  21. package/src/dashboard/templates/dreams 2.html +0 -252
  22. package/src/dashboard/templates/email 2.html +0 -160
  23. package/src/dashboard/templates/evolution 2.html +0 -189
  24. package/src/dashboard/templates/feed 2.html +0 -249
  25. package/src/dashboard/templates/followup_health 2.html +0 -170
  26. package/src/dashboard/templates/graph 2.html +0 -201
  27. package/src/dashboard/templates/guard 2.html +0 -259
  28. package/src/dashboard/templates/inbox 2.html +0 -251
  29. package/src/dashboard/templates/memory 2.html +0 -420
  30. package/src/dashboard/templates/operations 2.html +0 -608
  31. package/src/dashboard/templates/plugins 2.html +0 -185
  32. package/src/dashboard/templates/protocol 2.html +0 -199
  33. package/src/dashboard/templates/rules 2.html +0 -246
  34. package/src/dashboard/templates/sentiment 2.html +0 -247
  35. package/src/dashboard/templates/sessions 2.html +0 -218
  36. package/src/dashboard/templates/skills 2.html +0 -329
  37. package/src/dashboard/templates/somatic 2.html +0 -73
  38. package/src/dashboard/templates/triggers 2.html +0 -133
  39. package/src/dashboard/templates/trust 2.html +0 -360
  40. package/src/db/__init__ 2.py +0 -259
  41. package/src/db/_core 2.py +0 -437
  42. package/src/db/_credentials 2.py +0 -124
  43. package/src/db/_episodic 2.py +0 -762
  44. package/src/db/_evolution 2.py +0 -54
  45. package/src/db/_fts 2.py +0 -406
  46. package/src/db/_goal_profiles 2.py +0 -376
  47. package/src/db/_hot_context 2.py +0 -660
  48. package/src/db/_outcomes 2.py +0 -800
  49. package/src/db/_personal_scripts 2.py +0 -582
  50. package/src/db/_sessions 2.py +0 -330
  51. package/src/db/_tasks 2.py +0 -91
  52. package/src/db/_watchers 2.py +0 -173
  53. package/src/doctor/formatters 2.py +0 -52
  54. package/src/doctor/models 2.py +0 -69
  55. package/src/doctor/planes 2.py +0 -87
  56. package/src/doctor/providers/__init__ 2.py +0 -1
  57. package/src/doctor/providers/deep 2.py +0 -367
  58. package/src/evolution_cycle 2.py +0 -519
  59. package/src/hooks/auto_capture 2.py +0 -208
  60. package/src/hooks/caffeinate-guard 2.sh +0 -8
  61. package/src/hooks/capture-session 2.sh +0 -21
  62. package/src/hooks/capture-tool-logs 2.sh +0 -158
  63. package/src/hooks/daily-briefing-check 2.sh +0 -33
  64. package/src/hooks/heartbeat-enforcement 2.py +0 -90
  65. package/src/hooks/heartbeat-posttool 2.sh +0 -18
  66. package/src/hooks/inbox-hook 2.sh +0 -76
  67. package/src/hooks/post-compact 2.sh +0 -152
  68. package/src/hooks/pre-compact 2.sh +0 -169
  69. package/src/hooks/protocol-guardrail 2.sh +0 -10
  70. package/src/hooks/protocol-pretool-guardrail 2.sh +0 -9
  71. package/src/hooks/session-stop 2.sh +0 -52
  72. package/src/kg_populate 2.py +0 -292
  73. package/src/maintenance 2.py +0 -53
  74. package/src/memory_backends 2.py +0 -71
  75. package/src/migrate_embeddings 2.py +0 -124
  76. package/src/nexo_sdk 2.py +0 -103
  77. package/src/observability 2.py +0 -199
  78. package/src/plugin_loader 2.py +0 -217
  79. package/src/plugins/__init__ 2.py +0 -0
  80. package/src/plugins/artifact_registry 2.py +0 -450
  81. package/src/plugins/backup 2.py +0 -127
  82. package/src/plugins/claims_tools 2.py +0 -119
  83. package/src/plugins/cognitive_memory 2.py +0 -609
  84. package/src/plugins/core_rules 2.py +0 -252
  85. package/src/plugins/cortex 2.py +0 -1155
  86. package/src/plugins/entities 2.py +0 -67
  87. package/src/plugins/episodic_memory 2.py +0 -560
  88. package/src/plugins/evolution 2.py +0 -167
  89. package/src/plugins/goal_engine 2.py +0 -142
  90. package/src/plugins/guard 2.py +0 -862
  91. package/src/plugins/impact 2.py +0 -29
  92. package/src/plugins/knowledge_graph_tools 2.py +0 -137
  93. package/src/plugins/media_memory_tools 2.py +0 -98
  94. package/src/plugins/memory_export 2.py +0 -196
  95. package/src/plugins/outcomes 2.py +0 -130
  96. package/src/plugins/personal_scripts 2.py +0 -117
  97. package/src/plugins/preferences 2.py +0 -47
  98. package/src/plugins/protocol 2.py +0 -1449
  99. package/src/plugins/simple_api 2.py +0 -106
  100. package/src/plugins/skills 2.py +0 -341
  101. package/src/plugins/state_watchers 2.py +0 -79
  102. package/src/plugins/update 2.py +0 -986
  103. package/src/plugins/user_state_tools 2.py +0 -43
  104. package/src/plugins/workflow 2.py +0 -588
  105. package/src/protocol_settings 2.py +0 -59
  106. package/src/public_contribution 2.py +0 -466
  107. package/src/public_evolution_queue 2.py +0 -241
  108. package/src/requirements 2.txt +0 -14
  109. package/src/retroactive_learnings 2.py +0 -373
  110. package/src/rules/__init__ 2.py +0 -0
  111. package/src/rules/core-rules 2.json +0 -331
  112. package/src/rules/migrate 2.py +0 -207
  113. package/src/runtime_power 2.py +0 -874
  114. package/src/script_registry 2.py +0 -1559
  115. package/src/scripts/check-context 2.py +0 -272
  116. package/src/scripts/deep-sleep/apply_findings 2.py +0 -2327
  117. package/src/scripts/deep-sleep/collect 2.py +0 -928
  118. package/src/scripts/deep-sleep/extract 2.py +0 -330
  119. package/src/scripts/deep-sleep/extract-prompt 2.md +0 -285
  120. package/src/scripts/deep-sleep/synthesize 2.py +0 -312
  121. package/src/scripts/deep-sleep/synthesize-prompt 2.md +0 -336
  122. package/src/scripts/nexo-agent-run 2.py +0 -75
  123. package/src/scripts/nexo-auto-update 2.py +0 -6
  124. package/src/scripts/nexo-backup 2.sh +0 -25
  125. package/src/scripts/nexo-brain-activation 2.sh +0 -140
  126. package/src/scripts/nexo-catchup 2.py +0 -300
  127. package/src/scripts/nexo-cognitive-decay 2.py +0 -257
  128. package/src/scripts/nexo-cortex-cycle 2.py +0 -293
  129. package/src/scripts/nexo-cron-wrapper 2.sh +0 -53
  130. package/src/scripts/nexo-daily-self-audit 2.py +0 -2161
  131. package/src/scripts/nexo-dashboard 2.sh +0 -29
  132. package/src/scripts/nexo-deep-sleep 2.sh +0 -86
  133. package/src/scripts/nexo-evolution-run 2.py +0 -1664
  134. package/src/scripts/nexo-followup-hygiene 2.py +0 -139
  135. package/src/scripts/nexo-hook-record 2.py +0 -42
  136. package/src/scripts/nexo-immune 2.py +0 -936
  137. package/src/scripts/nexo-impact-scorer 2.py +0 -117
  138. package/src/scripts/nexo-inbox-hook 2.sh +0 -74
  139. package/src/scripts/nexo-install 2.py +0 -6
  140. package/src/scripts/nexo-learning-housekeep 2.py +0 -401
  141. package/src/scripts/nexo-learning-validator 2.py +0 -266
  142. package/src/scripts/nexo-migrate 2.py +0 -260
  143. package/src/scripts/nexo-outcome-checker 2.py +0 -127
  144. package/src/scripts/nexo-postmortem-consolidator 2.py +0 -456
  145. package/src/scripts/nexo-pre-commit 2.py +0 -120
  146. package/src/scripts/nexo-prevent-sleep 2.sh +0 -35
  147. package/src/scripts/nexo-proactive-dashboard 2.py +0 -354
  148. package/src/scripts/nexo-reflection 2.py +0 -256
  149. package/src/scripts/nexo-runtime-preflight 2.py +0 -274
  150. package/src/scripts/nexo-sleep 2.py +0 -631
  151. package/src/scripts/nexo-snapshot-restore 2.sh +0 -35
  152. package/src/scripts/nexo-sync-clients 2.py +0 -16
  153. package/src/scripts/nexo-synthesis 2.py +0 -475
  154. package/src/scripts/nexo-tcc-approve 2.sh +0 -79
  155. package/src/scripts/nexo-update 2.sh +0 -306
  156. package/src/scripts/nexo-watchdog 2.sh +0 -1207
  157. package/src/scripts/nexo-watchdog-smoke 2.py +0 -119
  158. package/src/scripts/rehydrate_learnings_from_archive 2.py +0 -245
  159. package/src/server 2.py +0 -1296
  160. package/src/skills/run-nexo-audit-phase/guide 2.md +0 -43
  161. package/src/skills/run-nexo-audit-phase/skill 2.json +0 -59
  162. package/src/skills/run-nexo-core-fix-cycle/guide 2.md +0 -17
  163. package/src/skills/run-nexo-core-fix-cycle/script 2.py +0 -276
  164. package/src/skills/run-nexo-core-fix-cycle/skill 2.json +0 -58
  165. package/src/skills/run-release-final-audit/guide 2.md +0 -16
  166. package/src/skills/run-release-final-audit/script 2.py +0 -259
  167. package/src/skills/run-release-final-audit/skill 2.json +0 -77
  168. package/src/skills/run-runtime-doctor/guide 2.md +0 -12
  169. package/src/skills/run-runtime-doctor/script 2.py +0 -21
  170. package/src/skills/run-runtime-doctor/skill 2.json +0 -25
  171. package/src/skills_runtime 2.py +0 -932
  172. package/src/state_watchers_runtime 2.py +0 -475
  173. package/src/storage_router 2.py +0 -32
  174. package/src/system_catalog 2.py +0 -786
  175. package/src/tools_coordination 2.py +0 -103
  176. package/src/tools_credentials 2.py +0 -68
  177. package/src/tools_drive 2.py +0 -487
  178. package/src/tools_hot_context 2.py +0 -163
  179. package/src/tools_learnings 2.py +0 -612
  180. package/src/tools_menu 2.py +0 -229
  181. package/src/tools_reminders 2.py +0 -88
  182. package/src/tools_reminders_crud 2.py +0 -363
  183. package/src/tools_sessions 2.py +0 -1054
  184. package/src/tools_system_catalog 2.py +0 -19
  185. package/src/tools_task_history 2.py +0 -57
  186. package/src/tools_transcripts 2.py +0 -98
  187. package/src/transcript_utils 2.py +0 -412
  188. package/src/user_context 2.py +0 -46
  189. package/src/user_data_portability 2.py +0 -328
  190. package/src/user_state_model 2.py +0 -170
  191. package/templates/CLAUDE.md 2.template +0 -108
  192. package/templates/CODEX.AGENTS.md 2.template +0 -66
  193. package/templates/launchagents/README 2.md +0 -132
  194. package/templates/launchagents/com.nexo.auto-close-sessions 2.plist +0 -39
  195. package/templates/launchagents/com.nexo.catchup 2.plist +0 -39
  196. package/templates/launchagents/com.nexo.cognitive-decay 2.plist +0 -40
  197. package/templates/launchagents/com.nexo.dashboard 2.plist +0 -43
  198. package/templates/launchagents/com.nexo.deep-sleep 2.plist +0 -43
  199. package/templates/launchagents/com.nexo.evolution 2.plist +0 -44
  200. package/templates/launchagents/com.nexo.followup-hygiene 2.plist +0 -45
  201. package/templates/launchagents/com.nexo.immune 2.plist +0 -41
  202. package/templates/launchagents/com.nexo.postmortem 2.plist +0 -45
  203. package/templates/launchagents/com.nexo.self-audit 2.plist +0 -47
  204. package/templates/launchagents/com.nexo.synthesis 2.plist +0 -45
  205. package/templates/launchagents/com.nexo.watchdog 2.plist +0 -37
  206. package/templates/nexo_helper 2.py +0 -301
  207. package/templates/openclaw 2.json +0 -13
  208. package/templates/plugin-template 2.py +0 -40
  209. package/templates/script-template 2.py +0 -59
  210. package/templates/script-template 2.sh +0 -13
  211. package/templates/skill-script-template 2.py +0 -48
  212. package/templates/skill-template 2.md +0 -33
@@ -1,272 +0,0 @@
1
- #!/usr/bin/env python3
2
- """Context checker for NEXO operations - prevents duplicate actions.
3
-
4
- Mechanical checks (email sent, file exists, action done) run in Python.
5
- When the 'smart' command is used, NEXO asks the configured automation backend
6
- for semantic duplicate/conflict detection that goes beyond file checks.
7
- """
8
-
9
- from __future__ import annotations
10
-
11
- import hashlib
12
- import json
13
- import os
14
- import sys
15
- from datetime import datetime
16
- from pathlib import Path
17
-
18
- NEXO_HOME = Path(os.environ.get("NEXO_HOME", str(Path.home() / ".nexo")))
19
- NEXO_CODE = Path(os.environ.get("NEXO_CODE", str(Path(__file__).resolve().parents[1])))
20
- if str(NEXO_CODE) not in sys.path:
21
- sys.path.insert(0, str(NEXO_CODE))
22
-
23
- from agent_runner import AutomationBackendUnavailableError, run_automation_prompt
24
- try:
25
- from client_preferences import resolve_user_model as _resolve_user_model
26
- _USER_MODEL = _resolve_user_model()
27
- except Exception:
28
- _USER_MODEL = ""
29
-
30
-
31
-
32
- class ContextChecker:
33
- def __init__(self):
34
- self.state_dir = NEXO_HOME / "state"
35
- self.state_dir.mkdir(exist_ok=True)
36
-
37
- def check_email_sent(self, to_addr, subject, since_hours=72):
38
- """Check if email was already sent to address with subject."""
39
- sent_path = Path.home() / "mail" / ".nexo-sent" / ".Sent"
40
- if not sent_path.exists():
41
- return False
42
-
43
- subject_lower = subject.lower()
44
- to_lower = to_addr.lower()
45
- cutoff = datetime.now().timestamp() - (since_hours * 3600)
46
- cur_dir = sent_path / "cur"
47
- if not cur_dir.exists():
48
- return False
49
-
50
- for msg_file in cur_dir.iterdir():
51
- try:
52
- if msg_file.stat().st_mtime < cutoff:
53
- continue
54
- content = msg_file.read_text(errors="ignore")
55
- except (OSError, UnicodeDecodeError):
56
- continue
57
-
58
- content_lower = content.lower()
59
- if f"to:{to_lower}" in content_lower or f"to: {to_lower}" in content_lower:
60
- if subject_lower in content_lower:
61
- return True
62
- return False
63
-
64
- def check_file_exists(self, pattern, search_dirs=None):
65
- """Check if file matching pattern exists in common locations."""
66
- if search_dirs is None:
67
- search_dirs = [
68
- "/var/www/vhosts",
69
- str(NEXO_HOME),
70
- "/opt",
71
- ]
72
-
73
- for base_dir in search_dirs:
74
- if not os.path.exists(base_dir):
75
- continue
76
- matches = []
77
- try:
78
- for root, _, files in os.walk(base_dir):
79
- for filename in files:
80
- if pattern in filename:
81
- matches.append(str(Path(root) / filename))
82
- if len(matches) >= 5:
83
- return matches
84
- except OSError:
85
- continue
86
- return []
87
-
88
- def check_action_done(self, action_type, identifier, ttl_days=7):
89
- """Check if action was already performed recently."""
90
- action_file = self.state_dir / "actions.json"
91
- actions = {}
92
- if action_file.exists():
93
- with open(action_file) as fh:
94
- actions = json.load(fh)
95
-
96
- key = hashlib.md5(f"{action_type}:{identifier}".encode(), usedforsecurity=False).hexdigest()
97
- if key in actions:
98
- action_time = datetime.fromisoformat(actions[key]["timestamp"])
99
- age_days = (datetime.now() - action_time).days
100
- if age_days < ttl_days:
101
- return True, actions[key]
102
- return False, None
103
-
104
- def mark_action_done(self, action_type, identifier, metadata=None):
105
- """Mark action as completed."""
106
- action_file = self.state_dir / "actions.json"
107
- actions = {}
108
- if action_file.exists():
109
- with open(action_file) as fh:
110
- actions = json.load(fh)
111
-
112
- key = hashlib.md5(f"{action_type}:{identifier}".encode(), usedforsecurity=False).hexdigest()
113
- actions[key] = {
114
- "type": action_type,
115
- "identifier": identifier,
116
- "timestamp": datetime.now().isoformat(),
117
- "metadata": metadata or {},
118
- }
119
- with open(action_file, "w") as fh:
120
- json.dump(actions, fh, indent=2)
121
- return key
122
-
123
-
124
- def _extract_json(text: str) -> dict | None:
125
- text = (text or "").strip()
126
- if not text:
127
- return None
128
- if text.startswith("```"):
129
- lines = text.splitlines()
130
- end = len(lines)
131
- for idx in range(len(lines) - 1, 0, -1):
132
- if lines[idx].strip() == "```":
133
- end = idx
134
- break
135
- text = "\n".join(lines[1:end]).strip()
136
- brace_start = text.find("{")
137
- if brace_start < 0:
138
- return None
139
- depth = 0
140
- for idx in range(brace_start, len(text)):
141
- if text[idx] == "{":
142
- depth += 1
143
- elif text[idx] == "}":
144
- depth -= 1
145
- if depth == 0:
146
- try:
147
- return json.loads(text[brace_start:idx + 1])
148
- except json.JSONDecodeError:
149
- return None
150
- return None
151
-
152
-
153
- def smart_check(action_description: str, context: str = "") -> dict:
154
- """Use the automation backend to check if an action would be redundant."""
155
- checker = ContextChecker()
156
-
157
- state_file = checker.state_dir / "actions.json"
158
- recent_actions = {}
159
- if state_file.exists():
160
- try:
161
- all_actions = json.loads(state_file.read_text())
162
- cutoff = datetime.now().timestamp() - (7 * 86400)
163
- for key, value in all_actions.items():
164
- try:
165
- ts = datetime.fromisoformat(value["timestamp"]).timestamp()
166
- if ts > cutoff:
167
- recent_actions[key] = value
168
- except (ValueError, KeyError):
169
- pass
170
- except Exception:
171
- pass
172
-
173
- prompt = f"""You are a context deduplication engine for NEXO operations.
174
-
175
- PROPOSED ACTION:
176
- {action_description}
177
-
178
- ADDITIONAL CONTEXT:
179
- {context or "None"}
180
-
181
- RECENT ACTIONS (last 7 days):
182
- {json.dumps(list(recent_actions.values()), indent=1, default=str, ensure_ascii=False)}
183
-
184
- Respond with ONLY valid JSON:
185
- {{
186
- "redundant": true/false,
187
- "confidence": 0.0-1.0,
188
- "reason": "<one line explanation>",
189
- "matching_action": "<identifier of matching action if redundant, else null>"
190
- }}
191
-
192
- Rules:
193
- - Same recipient + same intent within 72h = redundant
194
- - Same file modification with same content = redundant
195
- - Similar but different scope (e.g. different recipients) = NOT redundant
196
- - When in doubt, say not redundant (false negatives are cheaper than false positives)"""
197
-
198
- try:
199
- result = run_automation_prompt(
200
- prompt,
201
- model=_USER_MODEL or "opus",
202
- timeout=300,
203
- output_format="text",
204
- append_system_prompt="Return exactly one valid JSON object.",
205
- allowed_tools="Read,Write,Edit,Glob,Grep,Bash,mcp__nexo__*",
206
- )
207
- if result.returncode == 0:
208
- parsed = _extract_json(result.stdout)
209
- if parsed:
210
- return parsed
211
- except AutomationBackendUnavailableError as exc:
212
- return {"redundant": False, "reason": f"Automation backend unavailable — {exc}"}
213
- except Exception:
214
- pass
215
-
216
- return {"redundant": False, "reason": "Automation check failed, defaulting to not redundant"}
217
-
218
-
219
- def main():
220
- """CLI interface for context checking."""
221
- if len(sys.argv) < 3:
222
- print("Usage: check-context.py <command> <args>")
223
- print("Commands:")
224
- print(" email <to> <subject> - Check if email was sent")
225
- print(" file <pattern> - Check if file exists")
226
- print(" action <type> <id> - Check if action was done")
227
- print(" smart <description> [ctx] - Intelligent duplicate check via automation backend")
228
- sys.exit(1)
229
-
230
- checker = ContextChecker()
231
- command = sys.argv[1]
232
-
233
- if command == "email":
234
- if len(sys.argv) < 4:
235
- print("Usage: check-context.py email <to> <subject>")
236
- sys.exit(1)
237
- exists = checker.check_email_sent(sys.argv[2], sys.argv[3])
238
- print("EXISTS" if exists else "NOT_FOUND")
239
- sys.exit(0 if not exists else 1)
240
-
241
- if command == "file":
242
- files = checker.check_file_exists(sys.argv[2])
243
- if files:
244
- print("\n".join(files))
245
- sys.exit(1)
246
- print("NOT_FOUND")
247
- sys.exit(0)
248
-
249
- if command == "action":
250
- if len(sys.argv) < 4:
251
- print("Usage: check-context.py action <type> <id>")
252
- sys.exit(1)
253
- done, data = checker.check_action_done(sys.argv[2], sys.argv[3])
254
- if done:
255
- print(f"DONE: {data}")
256
- sys.exit(1)
257
- print("NOT_DONE")
258
- sys.exit(0)
259
-
260
- if command == "smart":
261
- description = sys.argv[2]
262
- context = sys.argv[3] if len(sys.argv) > 3 else ""
263
- result = smart_check(description, context)
264
- print(json.dumps(result, indent=2, ensure_ascii=False))
265
- sys.exit(1 if result.get("redundant") else 0)
266
-
267
- print(f"Unknown command: {command}")
268
- sys.exit(1)
269
-
270
-
271
- if __name__ == "__main__":
272
- main()