nexo-brain 2.2.0 → 2.3.1

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 (256) hide show
  1. package/README.md +5 -5
  2. package/package.json +6 -3
  3. package/src/auto_update.py +26 -0
  4. package/src/crons/manifest.json +6 -13
  5. package/src/crons/sync.py +150 -6
  6. package/src/db/__init__.py +13 -0
  7. package/src/db/_core.py +1 -0
  8. package/src/db/_cron_runs.py +74 -0
  9. package/src/db/_entities.py +1 -0
  10. package/src/db/_episodic.py +41 -6
  11. package/src/db/_learnings.py +1 -0
  12. package/src/db/_reminders.py +1 -0
  13. package/src/db/_schema.py +64 -0
  14. package/src/db/_sessions.py +1 -0
  15. package/src/db/_skills.py +515 -0
  16. package/src/hooks/session-stop.sh +13 -101
  17. package/src/plugin_loader.py +1 -0
  18. package/src/plugins/episodic_memory.py +5 -3
  19. package/src/plugins/schedule.py +212 -0
  20. package/src/plugins/skills.py +264 -0
  21. package/src/plugins/update.py +1 -0
  22. package/src/scripts/deep-sleep/apply_findings.py +111 -8
  23. package/src/scripts/deep-sleep/collect.py +34 -11
  24. package/src/scripts/deep-sleep/extract-prompt.md +38 -0
  25. package/src/scripts/deep-sleep/extract.py +81 -8
  26. package/src/scripts/deep-sleep/synthesize-prompt.md +29 -1
  27. package/src/scripts/deep-sleep/synthesize.py +4 -1
  28. package/src/scripts/nexo-catchup.py +65 -29
  29. package/src/scripts/nexo-cron-wrapper.sh +53 -0
  30. package/src/scripts/nexo-daily-self-audit.py +4 -2
  31. package/src/scripts/nexo-deep-sleep.sh +66 -77
  32. package/src/scripts/nexo-evolution-run.py +13 -0
  33. package/src/scripts/nexo-learning-housekeep.py +157 -1
  34. package/src/scripts/nexo-learning-validator.py +19 -0
  35. package/src/scripts/nexo-postmortem-consolidator.py +3 -2
  36. package/src/scripts/nexo-sleep.py +16 -11
  37. package/src/scripts/nexo-synthesis.py +46 -3
  38. package/src/scripts/nexo-watchdog.sh +91 -30
  39. package/src/server.py +6 -1
  40. package/src/tools_coordination.py +1 -0
  41. package/src/tools_sessions.py +1 -0
  42. package/scripts/migrate-to-unified 2.sh +0 -813
  43. package/scripts/migrate-to-unified.sh +0 -813
  44. package/scripts/migrate-v1.5-to-v1.6 2.py +0 -778
  45. package/scripts/migrate-v1.5-to-v1.6.py +0 -778
  46. package/scripts/migrate-v1.7-to-v1.8 2.py +0 -214
  47. package/scripts/migrate-v1.7-to-v1.8.py +0 -214
  48. package/scripts/pre-commit-check 2.sh +0 -55
  49. package/scripts/pre-commit-check.sh +0 -55
  50. package/src/__pycache__/auto_update.cpython-310.pyc +0 -0
  51. package/src/__pycache__/hnsw_index.cpython-310.pyc +0 -0
  52. package/src/__pycache__/kg_populate.cpython-310.pyc +0 -0
  53. package/src/__pycache__/knowledge_graph.cpython-310.pyc +0 -0
  54. package/src/__pycache__/plugin_loader.cpython-310.pyc +0 -0
  55. package/src/__pycache__/tools_coordination.cpython-310.pyc +0 -0
  56. package/src/__pycache__/tools_credentials.cpython-310.pyc +0 -0
  57. package/src/__pycache__/tools_learnings.cpython-310.pyc +0 -0
  58. package/src/__pycache__/tools_menu.cpython-310.pyc +0 -0
  59. package/src/__pycache__/tools_reminders.cpython-310.pyc +0 -0
  60. package/src/__pycache__/tools_reminders_crud.cpython-310.pyc +0 -0
  61. package/src/__pycache__/tools_sessions.cpython-310.pyc +0 -0
  62. package/src/__pycache__/tools_task_history.cpython-310.pyc +0 -0
  63. package/src/auto_close_sessions 2.py +0 -159
  64. package/src/auto_update 2.py +0 -634
  65. package/src/claim_graph 2.py +0 -323
  66. package/src/cognitive/__init__ 2.py +0 -62
  67. package/src/cognitive/__pycache__/__init__.cpython-310.pyc +0 -0
  68. package/src/cognitive/__pycache__/_core.cpython-310.pyc +0 -0
  69. package/src/cognitive/__pycache__/_decay.cpython-310.pyc +0 -0
  70. package/src/cognitive/__pycache__/_ingest.cpython-310.pyc +0 -0
  71. package/src/cognitive/__pycache__/_memory.cpython-310.pyc +0 -0
  72. package/src/cognitive/__pycache__/_search.cpython-310.pyc +0 -0
  73. package/src/cognitive/__pycache__/_trust.cpython-310.pyc +0 -0
  74. package/src/cognitive/_core 2.py +0 -567
  75. package/src/cognitive/_decay 2.py +0 -382
  76. package/src/cognitive/_ingest 2.py +0 -892
  77. package/src/cognitive/_memory 2.py +0 -912
  78. package/src/cognitive/_search 2.py +0 -949
  79. package/src/cognitive/_trust 2.py +0 -464
  80. package/src/crons/manifest 2.json +0 -106
  81. package/src/crons/sync 2.py +0 -217
  82. package/src/dashboard/__init__ 2.py +0 -0
  83. package/src/dashboard/__pycache__/__init__.cpython-310.pyc +0 -0
  84. package/src/dashboard/__pycache__/app.cpython-310.pyc +0 -0
  85. package/src/dashboard/app 2.py +0 -789
  86. package/src/db/__init__ 2.py +0 -89
  87. package/src/db/__pycache__/__init__.cpython-310.pyc +0 -0
  88. package/src/db/__pycache__/__init__.cpython-312.pyc +0 -0
  89. package/src/db/__pycache__/__init__.cpython-314.pyc +0 -0
  90. package/src/db/__pycache__/_core.cpython-310.pyc +0 -0
  91. package/src/db/__pycache__/_core.cpython-312.pyc +0 -0
  92. package/src/db/__pycache__/_core.cpython-314.pyc +0 -0
  93. package/src/db/__pycache__/_credentials.cpython-310.pyc +0 -0
  94. package/src/db/__pycache__/_credentials.cpython-312.pyc +0 -0
  95. package/src/db/__pycache__/_credentials.cpython-314.pyc +0 -0
  96. package/src/db/__pycache__/_entities.cpython-310.pyc +0 -0
  97. package/src/db/__pycache__/_entities.cpython-312.pyc +0 -0
  98. package/src/db/__pycache__/_entities.cpython-314.pyc +0 -0
  99. package/src/db/__pycache__/_episodic.cpython-310.pyc +0 -0
  100. package/src/db/__pycache__/_episodic.cpython-312.pyc +0 -0
  101. package/src/db/__pycache__/_episodic.cpython-314.pyc +0 -0
  102. package/src/db/__pycache__/_evolution.cpython-310.pyc +0 -0
  103. package/src/db/__pycache__/_evolution.cpython-312.pyc +0 -0
  104. package/src/db/__pycache__/_evolution.cpython-314.pyc +0 -0
  105. package/src/db/__pycache__/_fts.cpython-310.pyc +0 -0
  106. package/src/db/__pycache__/_fts.cpython-312.pyc +0 -0
  107. package/src/db/__pycache__/_fts.cpython-314.pyc +0 -0
  108. package/src/db/__pycache__/_learnings.cpython-310.pyc +0 -0
  109. package/src/db/__pycache__/_learnings.cpython-312.pyc +0 -0
  110. package/src/db/__pycache__/_learnings.cpython-314.pyc +0 -0
  111. package/src/db/__pycache__/_reminders.cpython-310.pyc +0 -0
  112. package/src/db/__pycache__/_reminders.cpython-312.pyc +0 -0
  113. package/src/db/__pycache__/_reminders.cpython-314.pyc +0 -0
  114. package/src/db/__pycache__/_schema.cpython-310.pyc +0 -0
  115. package/src/db/__pycache__/_schema.cpython-312.pyc +0 -0
  116. package/src/db/__pycache__/_schema.cpython-314.pyc +0 -0
  117. package/src/db/__pycache__/_sessions.cpython-310.pyc +0 -0
  118. package/src/db/__pycache__/_sessions.cpython-312.pyc +0 -0
  119. package/src/db/__pycache__/_sessions.cpython-314.pyc +0 -0
  120. package/src/db/__pycache__/_tasks.cpython-310.pyc +0 -0
  121. package/src/db/__pycache__/_tasks.cpython-312.pyc +0 -0
  122. package/src/db/__pycache__/_tasks.cpython-314.pyc +0 -0
  123. package/src/db/_core 2.py +0 -417
  124. package/src/db/_credentials 2.py +0 -124
  125. package/src/db/_entities 2.py +0 -178
  126. package/src/db/_episodic 2.py +0 -738
  127. package/src/db/_evolution 2.py +0 -54
  128. package/src/db/_fts 2.py +0 -406
  129. package/src/db/_learnings 2.py +0 -168
  130. package/src/db/_reminders 2.py +0 -338
  131. package/src/db/_schema 2.py +0 -364
  132. package/src/db/_sessions 2.py +0 -300
  133. package/src/db/_tasks 2.py +0 -91
  134. package/src/evolution_cycle 2.py +0 -266
  135. package/src/hnsw_index 2.py +0 -254
  136. package/src/hooks/auto_capture 2.py +0 -208
  137. package/src/hooks/caffeinate-guard 2.sh +0 -8
  138. package/src/hooks/capture-session 2.sh +0 -21
  139. package/src/hooks/capture-tool-logs 2.sh +0 -127
  140. package/src/hooks/daily-briefing-check 2.sh +0 -33
  141. package/src/hooks/inbox-hook 2.sh +0 -76
  142. package/src/hooks/post-compact 2.sh +0 -148
  143. package/src/hooks/pre-compact 2.sh +0 -151
  144. package/src/hooks/session-start 2.sh +0 -268
  145. package/src/hooks/session-stop 2.sh +0 -140
  146. package/src/kg_populate 2.py +0 -290
  147. package/src/knowledge_graph 2.py +0 -257
  148. package/src/maintenance 2.py +0 -59
  149. package/src/migrate_embeddings 2.py +0 -122
  150. package/src/plugin_loader 2.py +0 -202
  151. package/src/plugins/__init__ 2.py +0 -0
  152. package/src/plugins/__pycache__/__init__ 2.cpython-310.pyc +0 -0
  153. package/src/plugins/__pycache__/__init__.cpython-310.pyc +0 -0
  154. package/src/plugins/__pycache__/adaptive_mode 2.cpython-310.pyc +0 -0
  155. package/src/plugins/__pycache__/adaptive_mode.cpython-310.pyc +0 -0
  156. package/src/plugins/__pycache__/agents 2.cpython-310.pyc +0 -0
  157. package/src/plugins/__pycache__/agents.cpython-310.pyc +0 -0
  158. package/src/plugins/__pycache__/artifact_registry 2.cpython-310.pyc +0 -0
  159. package/src/plugins/__pycache__/artifact_registry.cpython-310.pyc +0 -0
  160. package/src/plugins/__pycache__/backup 2.cpython-310.pyc +0 -0
  161. package/src/plugins/__pycache__/backup.cpython-310.pyc +0 -0
  162. package/src/plugins/__pycache__/cognitive_memory 2.cpython-310.pyc +0 -0
  163. package/src/plugins/__pycache__/cognitive_memory.cpython-310.pyc +0 -0
  164. package/src/plugins/__pycache__/core_rules 2.cpython-310.pyc +0 -0
  165. package/src/plugins/__pycache__/core_rules.cpython-310.pyc +0 -0
  166. package/src/plugins/__pycache__/cortex 2.cpython-310.pyc +0 -0
  167. package/src/plugins/__pycache__/cortex.cpython-310.pyc +0 -0
  168. package/src/plugins/__pycache__/entities 2.cpython-310.pyc +0 -0
  169. package/src/plugins/__pycache__/entities.cpython-310.pyc +0 -0
  170. package/src/plugins/__pycache__/episodic_memory 2.cpython-310.pyc +0 -0
  171. package/src/plugins/__pycache__/episodic_memory.cpython-310.pyc +0 -0
  172. package/src/plugins/__pycache__/evolution 2.cpython-310.pyc +0 -0
  173. package/src/plugins/__pycache__/evolution.cpython-310.pyc +0 -0
  174. package/src/plugins/__pycache__/guard 2.cpython-310.pyc +0 -0
  175. package/src/plugins/__pycache__/guard.cpython-310.pyc +0 -0
  176. package/src/plugins/__pycache__/knowledge_graph_tools 2.cpython-310.pyc +0 -0
  177. package/src/plugins/__pycache__/knowledge_graph_tools.cpython-310.pyc +0 -0
  178. package/src/plugins/__pycache__/preferences 2.cpython-310.pyc +0 -0
  179. package/src/plugins/__pycache__/preferences.cpython-310.pyc +0 -0
  180. package/src/plugins/__pycache__/update 2.cpython-310.pyc +0 -0
  181. package/src/plugins/__pycache__/update.cpython-310.pyc +0 -0
  182. package/src/plugins/adaptive_mode 2.py +0 -805
  183. package/src/plugins/agents 2.py +0 -52
  184. package/src/plugins/artifact_registry 2.py +0 -450
  185. package/src/plugins/backup 2.py +0 -104
  186. package/src/plugins/cognitive_memory 2.py +0 -564
  187. package/src/plugins/core_rules 2.py +0 -252
  188. package/src/plugins/cortex 2.py +0 -299
  189. package/src/plugins/entities 2.py +0 -67
  190. package/src/plugins/episodic_memory 2.py +0 -533
  191. package/src/plugins/evolution 2.py +0 -115
  192. package/src/plugins/guard 2.py +0 -746
  193. package/src/plugins/knowledge_graph_tools 2.py +0 -105
  194. package/src/plugins/preferences 2.py +0 -47
  195. package/src/plugins/update 2.py +0 -256
  196. package/src/requirements 2.txt +0 -12
  197. package/src/rules/__init__ 2.py +0 -0
  198. package/src/rules/core-rules 2.json +0 -331
  199. package/src/rules/migrate 2.py +0 -207
  200. package/src/scripts/check-context 2.py +0 -264
  201. package/src/scripts/nexo-auto-update 2.py +0 -6
  202. package/src/scripts/nexo-backup 2.sh +0 -25
  203. package/src/scripts/nexo-brain-activation 2.sh +0 -140
  204. package/src/scripts/nexo-catchup 2.py +0 -242
  205. package/src/scripts/nexo-cognitive-decay 2.py +0 -182
  206. package/src/scripts/nexo-daily-self-audit 2.py +0 -552
  207. package/src/scripts/nexo-deep-sleep 2.sh +0 -97
  208. package/src/scripts/nexo-evolution-run 2.py +0 -597
  209. package/src/scripts/nexo-followup-hygiene 2.py +0 -112
  210. package/src/scripts/nexo-github-monitor 2.py +0 -256
  211. package/src/scripts/nexo-github-monitor.py +0 -256
  212. package/src/scripts/nexo-immune 2.py +0 -927
  213. package/src/scripts/nexo-inbox-hook 2.sh +0 -74
  214. package/src/scripts/nexo-install 2.py +0 -6
  215. package/src/scripts/nexo-learning-housekeep 2.py +0 -245
  216. package/src/scripts/nexo-learning-validator 2.py +0 -207
  217. package/src/scripts/nexo-migrate 2.py +0 -232
  218. package/src/scripts/nexo-postmortem-consolidator 2.py +0 -421
  219. package/src/scripts/nexo-pre-commit 2.py +0 -120
  220. package/src/scripts/nexo-prevent-sleep 2.sh +0 -29
  221. package/src/scripts/nexo-proactive-dashboard 2.py +0 -345
  222. package/src/scripts/nexo-reflection 2.py +0 -253
  223. package/src/scripts/nexo-runtime-preflight 2.py +0 -274
  224. package/src/scripts/nexo-send-email 2.py +0 -25
  225. package/src/scripts/nexo-send-email.py +0 -25
  226. package/src/scripts/nexo-send-reply 2.py +0 -178
  227. package/src/scripts/nexo-send-reply.py +0 -178
  228. package/src/scripts/nexo-sleep 2.py +0 -592
  229. package/src/scripts/nexo-snapshot-restore 2.sh +0 -35
  230. package/src/scripts/nexo-synthesis 2.py +0 -253
  231. package/src/scripts/nexo-tcc-approve 2.sh +0 -79
  232. package/src/scripts/nexo-update 2.sh +0 -161
  233. package/src/scripts/nexo-watchdog 2.sh +0 -878
  234. package/src/scripts/nexo-watchdog-smoke 2.py +0 -119
  235. package/src/server 2.py +0 -733
  236. package/src/storage_router 2.py +0 -32
  237. package/src/tools_coordination 2.py +0 -102
  238. package/src/tools_credentials 2.py +0 -68
  239. package/src/tools_learnings 2.py +0 -220
  240. package/src/tools_menu 2.py +0 -227
  241. package/src/tools_reminders 2.py +0 -86
  242. package/src/tools_reminders_crud 2.py +0 -159
  243. package/src/tools_sessions 2.py +0 -476
  244. package/src/tools_task_history 2.py +0 -57
  245. package/templates/CLAUDE.md 2.template +0 -63
  246. package/templates/openclaw 2.json +0 -13
  247. package/tests/__init__ 2.py +0 -0
  248. package/tests/__init__.py +0 -0
  249. package/tests/conftest 2.py +0 -71
  250. package/tests/conftest.py +0 -71
  251. package/tests/test_cognitive 2.py +0 -205
  252. package/tests/test_cognitive.py +0 -205
  253. package/tests/test_knowledge_graph 2.py +0 -140
  254. package/tests/test_knowledge_graph.py +0 -140
  255. package/tests/test_migrations 2.py +0 -137
  256. package/tests/test_migrations.py +0 -137
@@ -1,122 +0,0 @@
1
- #!/usr/bin/env python3
2
- """
3
- Migrate cognitive.db embeddings between models.
4
-
5
- Usage:
6
- python migrate_embeddings.py upgrade # 384 → 768 (bge-small → bge-base)
7
- python migrate_embeddings.py rollback # Restore from backup
8
- python migrate_embeddings.py verify # Check current embedding dims
9
- """
10
-
11
- import os
12
- import shutil
13
- import sqlite3
14
- import sys
15
- import time
16
- import numpy as np
17
-
18
- NEXO_HOME = os.environ.get("NEXO_HOME", os.path.expanduser("~/.nexo"))
19
- _data_dir = os.path.join(NEXO_HOME, "data")
20
- os.makedirs(_data_dir, exist_ok=True)
21
- DB_PATH = os.path.join(_data_dir, "cognitive.db")
22
- BACKUP_PATH = DB_PATH + ".bak-384dims-pre-upgrade"
23
-
24
- MODELS = {
25
- "small": ("BAAI/bge-small-en-v1.5", 384),
26
- "base": ("BAAI/bge-base-en-v1.5", 768),
27
- }
28
-
29
-
30
- def verify():
31
- """Check current embedding dimensions in the database."""
32
- conn = sqlite3.connect(DB_PATH)
33
- for table in ["stm_memories", "ltm_memories"]:
34
- count = conn.execute(f"SELECT COUNT(*) FROM {table}").fetchone()[0]
35
- if count == 0:
36
- print(f" {table}: {count} rows (empty)")
37
- continue
38
- row = conn.execute(f"SELECT embedding FROM {table} LIMIT 1").fetchone()
39
- vec = np.frombuffer(row[0], dtype=np.float32)
40
- print(f" {table}: {count} rows, embedding dim = {len(vec)}")
41
- conn.close()
42
-
43
-
44
- def upgrade():
45
- """Re-embed all memories from bge-small (384) to bge-base (768)."""
46
- from fastembed import TextEmbedding
47
-
48
- # Verify current state
49
- print("Current state:")
50
- verify()
51
-
52
- # Verify backup exists
53
- if not os.path.exists(BACKUP_PATH):
54
- print(f"\nCreating backup at {BACKUP_PATH}")
55
- shutil.copy2(DB_PATH, BACKUP_PATH)
56
- else:
57
- print(f"\nBackup already exists at {BACKUP_PATH}")
58
-
59
- # Load new model
60
- model_name, expected_dim = MODELS["base"]
61
- print(f"\nLoading {model_name}...")
62
- model = TextEmbedding(model_name)
63
-
64
- conn = sqlite3.connect(DB_PATH)
65
-
66
- for table in ["stm_memories", "ltm_memories"]:
67
- rows = conn.execute(f"SELECT id, content FROM {table}").fetchall()
68
- if not rows:
69
- print(f"\n{table}: empty, skipping")
70
- continue
71
-
72
- print(f"\n{table}: re-embedding {len(rows)} memories...")
73
- t0 = time.time()
74
-
75
- # Batch embed for speed
76
- contents = [r[1] for r in rows]
77
- ids = [r[0] for r in rows]
78
-
79
- embeddings = list(model.embed(contents))
80
-
81
- for mem_id, emb in zip(ids, embeddings):
82
- blob = np.array(emb, dtype=np.float32).tobytes()
83
- conn.execute(f"UPDATE {table} SET embedding = ? WHERE id = ?", (blob, mem_id))
84
-
85
- conn.commit()
86
- elapsed = time.time() - t0
87
- print(f" Done: {len(rows)} memories in {elapsed:.1f}s ({elapsed/len(rows)*1000:.0f}ms/memory)")
88
-
89
- conn.close()
90
-
91
- print("\nAfter upgrade:")
92
- verify()
93
- print("\nUpgrade complete. Run 'verify' to confirm.")
94
-
95
-
96
- def rollback():
97
- """Restore database from pre-upgrade backup."""
98
- if not os.path.exists(BACKUP_PATH):
99
- print(f"ERROR: Backup not found at {BACKUP_PATH}")
100
- sys.exit(1)
101
-
102
- print(f"Restoring from {BACKUP_PATH}...")
103
- shutil.copy2(BACKUP_PATH, DB_PATH)
104
- print("Restored. Current state:")
105
- verify()
106
-
107
-
108
- if __name__ == "__main__":
109
- if len(sys.argv) < 2:
110
- print("Usage: python migrate_embeddings.py [upgrade|rollback|verify]")
111
- sys.exit(1)
112
-
113
- cmd = sys.argv[1]
114
- if cmd == "upgrade":
115
- upgrade()
116
- elif cmd == "rollback":
117
- rollback()
118
- elif cmd == "verify":
119
- verify()
120
- else:
121
- print(f"Unknown command: {cmd}")
122
- sys.exit(1)
@@ -1,202 +0,0 @@
1
- """Dynamic plugin loader for NEXO MCP server."""
2
-
3
- import importlib
4
- import importlib.util
5
- import os
6
- import signal
7
- import sys
8
- import time
9
-
10
- from db import get_db
11
- from fastmcp.tools import Tool
12
-
13
- SERVER_DIR = os.path.dirname(os.path.abspath(__file__))
14
- PLUGINS_DIR = os.path.join(SERVER_DIR, "plugins")
15
-
16
- # Personal plugins directory: NEXO_HOME/plugins/ (env var, defaults to ~/.nexo/)
17
- NEXO_HOME = os.environ.get("NEXO_HOME", os.path.expanduser("~/.nexo"))
18
- PERSONAL_PLUGINS_DIR = os.path.join(NEXO_HOME, "plugins")
19
-
20
- PLUGIN_LOAD_TIMEOUT = 10 # seconds per plugin
21
-
22
-
23
- class _PluginTimeout(Exception):
24
- pass
25
-
26
-
27
- def _timeout_handler(signum, frame):
28
- raise _PluginTimeout("Plugin loading timed out")
29
-
30
-
31
- def _ensure_src_in_path():
32
- """Ensure server src/ is in sys.path so personal plugins can import db, cognitive, etc."""
33
- if SERVER_DIR not in sys.path:
34
- sys.path.insert(0, SERVER_DIR)
35
-
36
-
37
- def load_all_plugins(mcp) -> int:
38
- """Load all plugins from repo and personal directories at startup. Returns total tools loaded."""
39
- _ensure_src_in_path()
40
- total = 0
41
-
42
- # Collect plugins: repo first, personal overrides
43
- plugin_map = {} # filename -> (dir_path, source_label)
44
-
45
- # 1. Repo plugins (base)
46
- if os.path.isdir(PLUGINS_DIR):
47
- for f in sorted(os.listdir(PLUGINS_DIR)):
48
- if f.endswith(".py") and f != "__init__.py":
49
- plugin_map[f] = (PLUGINS_DIR, "repo")
50
-
51
- # 2. Personal plugins (override if same filename)
52
- if os.path.isdir(PERSONAL_PLUGINS_DIR):
53
- for f in sorted(os.listdir(PERSONAL_PLUGINS_DIR)):
54
- if f.endswith(".py") and f != "__init__.py":
55
- source = "personal (override)" if f in plugin_map else "personal"
56
- plugin_map[f] = (PERSONAL_PLUGINS_DIR, source)
57
-
58
- # Load all in sorted order
59
- for f in sorted(plugin_map):
60
- plugins_dir, source_label = plugin_map[f]
61
- try:
62
- old_handler = signal.signal(signal.SIGALRM, _timeout_handler)
63
- signal.alarm(PLUGIN_LOAD_TIMEOUT)
64
- try:
65
- n = load_plugin(mcp, f, plugins_dir=plugins_dir)
66
- total += n
67
- print(f"[PLUGIN LOADED] {f} ({n} tools) from {source_label}: {plugins_dir}", file=sys.stderr)
68
- finally:
69
- signal.alarm(0)
70
- signal.signal(signal.SIGALRM, old_handler)
71
- except _PluginTimeout:
72
- print(f"[PLUGIN TIMEOUT] {f}: skipped after {PLUGIN_LOAD_TIMEOUT}s", file=sys.stderr)
73
- except Exception as e:
74
- print(f"[PLUGIN ERROR] {f}: {e}", file=sys.stderr)
75
- return total
76
-
77
-
78
- def load_plugin(mcp, filename: str, plugins_dir: str | None = None) -> int:
79
- """Load or reload a single plugin. Returns number of tools registered.
80
-
81
- Args:
82
- plugins_dir: Directory to load from. If None, searches repo PLUGINS_DIR first,
83
- then PERSONAL_PLUGINS_DIR. Personal plugins are loaded via
84
- importlib.util.spec_from_file_location.
85
- """
86
- if not filename.endswith(".py"):
87
- filename += ".py"
88
-
89
- if plugins_dir is not None:
90
- filepath = os.path.join(plugins_dir, filename)
91
- if not os.path.isfile(filepath):
92
- raise FileNotFoundError(f"Plugin not found: {filepath}")
93
- else:
94
- # Search repo first, then personal
95
- repo_path = os.path.join(PLUGINS_DIR, filename)
96
- personal_path = os.path.join(PERSONAL_PLUGINS_DIR, filename)
97
- if os.path.isfile(repo_path):
98
- plugins_dir = PLUGINS_DIR
99
- filepath = repo_path
100
- elif os.path.isfile(personal_path):
101
- plugins_dir = PERSONAL_PLUGINS_DIR
102
- filepath = personal_path
103
- else:
104
- raise FileNotFoundError(
105
- f"Plugin not found in repo ({PLUGINS_DIR}) or personal ({PERSONAL_PLUGINS_DIR}): {filename}"
106
- )
107
-
108
- module_name = f"plugins.{filename[:-3]}"
109
-
110
- # For personal plugins (outside repo), use spec_from_file_location
111
- if plugins_dir != PLUGINS_DIR:
112
- _ensure_src_in_path()
113
- spec = importlib.util.spec_from_file_location(module_name, filepath)
114
- if spec is None or spec.loader is None:
115
- raise ImportError(f"Cannot create module spec for {filepath}")
116
- mod = importlib.util.module_from_spec(spec)
117
- sys.modules[module_name] = mod
118
- spec.loader.exec_module(mod)
119
- elif module_name in sys.modules:
120
- mod = importlib.reload(sys.modules[module_name])
121
- else:
122
- mod = importlib.import_module(module_name)
123
-
124
- tools_list = getattr(mod, "TOOLS", [])
125
- tool_names = []
126
-
127
- for func, name, description in tools_list:
128
- try:
129
- mcp.local_provider.remove_tool(name)
130
- except Exception:
131
- pass
132
- t = Tool.from_function(func, name=name, description=description)
133
- mcp.add_tool(t)
134
- tool_names.append(name)
135
-
136
- source_label = "personal" if plugins_dir != PLUGINS_DIR else "repo"
137
- _update_registry(filename, len(tool_names), ",".join(tool_names), source_label)
138
-
139
- return len(tool_names)
140
-
141
-
142
- def remove_plugin(mcp, filename: str) -> list[str]:
143
- """Unregister a plugin's tools from MCP and clean the registry.
144
-
145
- Does NOT delete plugin files — only unregisters tools to avoid
146
- accidental deletion of code from repo or personal directories.
147
- """
148
- if not filename.endswith(".py"):
149
- filename += ".py"
150
-
151
- conn = get_db()
152
- row = conn.execute("SELECT tool_names FROM plugins WHERE filename = ?", (filename,)).fetchone()
153
-
154
- removed = []
155
- if row and row["tool_names"]:
156
- for name in row["tool_names"].split(","):
157
- name = name.strip()
158
- if name:
159
- try:
160
- mcp.local_provider.remove_tool(name)
161
- removed.append(name)
162
- except Exception:
163
- pass
164
-
165
- module_name = f"plugins.{filename[:-3]}"
166
- sys.modules.pop(module_name, None)
167
-
168
- conn = get_db()
169
- conn.execute("DELETE FROM plugins WHERE filename = ?", (filename,))
170
- conn.commit()
171
-
172
- return removed
173
-
174
-
175
- def list_plugins() -> list[dict]:
176
- """List all registered plugins with source info (repo/personal)."""
177
- conn = get_db()
178
- rows = conn.execute(
179
- "SELECT filename, tools_count, tool_names, loaded_at, created_by FROM plugins ORDER BY filename"
180
- ).fetchall()
181
- result = []
182
- for r in rows:
183
- d = dict(r)
184
- d["source"] = d.get("created_by", "repo")
185
- result.append(d)
186
- return result
187
-
188
-
189
- def _update_registry(filename: str, tools_count: int, tool_names: str, created_by: str):
190
- """Insert or update plugin registry entry. Non-fatal on lock — tools still work."""
191
- now = time.time()
192
- try:
193
- conn = get_db()
194
- conn.execute(
195
- "INSERT INTO plugins (filename, tools_count, tool_names, loaded_at, created_by) "
196
- "VALUES (?, ?, ?, ?, ?) "
197
- "ON CONFLICT(filename) DO UPDATE SET tools_count=?, tool_names=?, loaded_at=?, created_by=?",
198
- (filename, tools_count, tool_names, now, created_by, tools_count, tool_names, now, created_by),
199
- )
200
- conn.commit()
201
- except Exception as e:
202
- print(f"[PLUGIN REGISTRY] Skipped update for {filename}: {e}")
File without changes