nexo-brain 2.1.0 → 2.2.0

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 (235) hide show
  1. package/README.md +3 -3
  2. package/bin/nexo-brain.js +53 -26
  3. package/package.json +1 -1
  4. package/scripts/migrate-to-unified 2.sh +813 -0
  5. package/scripts/migrate-v1.5-to-v1.6 2.py +778 -0
  6. package/scripts/migrate-v1.7-to-v1.8 2.py +214 -0
  7. package/scripts/pre-commit-check 2.sh +55 -0
  8. package/src/__pycache__/auto_update.cpython-310.pyc +0 -0
  9. package/src/__pycache__/hnsw_index.cpython-310.pyc +0 -0
  10. package/src/__pycache__/kg_populate.cpython-310.pyc +0 -0
  11. package/src/__pycache__/knowledge_graph.cpython-310.pyc +0 -0
  12. package/src/__pycache__/plugin_loader.cpython-310.pyc +0 -0
  13. package/src/__pycache__/tools_coordination.cpython-310.pyc +0 -0
  14. package/src/__pycache__/tools_credentials.cpython-310.pyc +0 -0
  15. package/src/__pycache__/tools_learnings.cpython-310.pyc +0 -0
  16. package/src/__pycache__/tools_menu.cpython-310.pyc +0 -0
  17. package/src/__pycache__/tools_reminders.cpython-310.pyc +0 -0
  18. package/src/__pycache__/tools_reminders_crud.cpython-310.pyc +0 -0
  19. package/src/__pycache__/tools_sessions.cpython-310.pyc +0 -0
  20. package/src/__pycache__/tools_task_history.cpython-310.pyc +0 -0
  21. package/src/auto_close_sessions 2.py +159 -0
  22. package/src/auto_update 2.py +634 -0
  23. package/src/claim_graph 2.py +323 -0
  24. package/src/cognitive/__init__ 2.py +62 -0
  25. package/src/cognitive/__pycache__/__init__.cpython-310.pyc +0 -0
  26. package/src/cognitive/__pycache__/_core.cpython-310.pyc +0 -0
  27. package/src/cognitive/__pycache__/_decay.cpython-310.pyc +0 -0
  28. package/src/cognitive/__pycache__/_ingest.cpython-310.pyc +0 -0
  29. package/src/cognitive/__pycache__/_memory.cpython-310.pyc +0 -0
  30. package/src/cognitive/__pycache__/_search.cpython-310.pyc +0 -0
  31. package/src/cognitive/__pycache__/_trust.cpython-310.pyc +0 -0
  32. package/src/cognitive/_core 2.py +567 -0
  33. package/src/cognitive/_decay 2.py +382 -0
  34. package/src/cognitive/_ingest 2.py +892 -0
  35. package/src/cognitive/_memory 2.py +912 -0
  36. package/src/cognitive/_search 2.py +949 -0
  37. package/src/cognitive/_trust 2.py +464 -0
  38. package/src/cognitive/_trust.py +10 -36
  39. package/src/crons/manifest 2.json +106 -0
  40. package/src/crons/sync 2.py +217 -0
  41. package/src/dashboard/__init__ 2.py +0 -0
  42. package/src/dashboard/__pycache__/__init__.cpython-310.pyc +0 -0
  43. package/src/dashboard/__pycache__/app.cpython-310.pyc +0 -0
  44. package/src/dashboard/app 2.py +789 -0
  45. package/src/db/__init__ 2.py +89 -0
  46. package/src/db/__pycache__/__init__.cpython-310.pyc +0 -0
  47. package/src/db/__pycache__/__init__.cpython-312.pyc +0 -0
  48. package/src/db/__pycache__/__init__.cpython-314.pyc +0 -0
  49. package/src/db/__pycache__/_core.cpython-310.pyc +0 -0
  50. package/src/db/__pycache__/_core.cpython-312.pyc +0 -0
  51. package/src/db/__pycache__/_core.cpython-314.pyc +0 -0
  52. package/src/db/__pycache__/_credentials.cpython-310.pyc +0 -0
  53. package/src/db/__pycache__/_credentials.cpython-312.pyc +0 -0
  54. package/src/db/__pycache__/_credentials.cpython-314.pyc +0 -0
  55. package/src/db/__pycache__/_entities.cpython-310.pyc +0 -0
  56. package/src/db/__pycache__/_entities.cpython-312.pyc +0 -0
  57. package/src/db/__pycache__/_entities.cpython-314.pyc +0 -0
  58. package/src/db/__pycache__/_episodic.cpython-310.pyc +0 -0
  59. package/src/db/__pycache__/_episodic.cpython-312.pyc +0 -0
  60. package/src/db/__pycache__/_episodic.cpython-314.pyc +0 -0
  61. package/src/db/__pycache__/_evolution.cpython-310.pyc +0 -0
  62. package/src/db/__pycache__/_evolution.cpython-312.pyc +0 -0
  63. package/src/db/__pycache__/_evolution.cpython-314.pyc +0 -0
  64. package/src/db/__pycache__/_fts.cpython-310.pyc +0 -0
  65. package/src/db/__pycache__/_fts.cpython-312.pyc +0 -0
  66. package/src/db/__pycache__/_fts.cpython-314.pyc +0 -0
  67. package/src/db/__pycache__/_learnings.cpython-310.pyc +0 -0
  68. package/src/db/__pycache__/_learnings.cpython-312.pyc +0 -0
  69. package/src/db/__pycache__/_learnings.cpython-314.pyc +0 -0
  70. package/src/db/__pycache__/_reminders.cpython-310.pyc +0 -0
  71. package/src/db/__pycache__/_reminders.cpython-312.pyc +0 -0
  72. package/src/db/__pycache__/_reminders.cpython-314.pyc +0 -0
  73. package/src/db/__pycache__/_schema.cpython-310.pyc +0 -0
  74. package/src/db/__pycache__/_schema.cpython-312.pyc +0 -0
  75. package/src/db/__pycache__/_schema.cpython-314.pyc +0 -0
  76. package/src/db/__pycache__/_sessions.cpython-310.pyc +0 -0
  77. package/src/db/__pycache__/_sessions.cpython-312.pyc +0 -0
  78. package/src/db/__pycache__/_sessions.cpython-314.pyc +0 -0
  79. package/src/db/__pycache__/_tasks.cpython-310.pyc +0 -0
  80. package/src/db/__pycache__/_tasks.cpython-312.pyc +0 -0
  81. package/src/db/__pycache__/_tasks.cpython-314.pyc +0 -0
  82. package/src/db/_core 2.py +417 -0
  83. package/src/db/_credentials 2.py +124 -0
  84. package/src/db/_entities 2.py +178 -0
  85. package/src/db/_episodic 2.py +738 -0
  86. package/src/db/_evolution 2.py +54 -0
  87. package/src/db/_fts 2.py +406 -0
  88. package/src/db/_learnings 2.py +168 -0
  89. package/src/db/_reminders 2.py +338 -0
  90. package/src/db/_schema 2.py +364 -0
  91. package/src/db/_sessions 2.py +300 -0
  92. package/src/db/_tasks 2.py +91 -0
  93. package/src/evolution_cycle 2.py +266 -0
  94. package/src/hnsw_index 2.py +254 -0
  95. package/src/hooks/auto_capture 2.py +208 -0
  96. package/src/hooks/caffeinate-guard 2.sh +8 -0
  97. package/src/hooks/capture-session 2.sh +21 -0
  98. package/src/hooks/capture-session.sh +2 -0
  99. package/src/hooks/capture-tool-logs 2.sh +127 -0
  100. package/src/hooks/capture-tool-logs.sh +3 -2
  101. package/src/hooks/daily-briefing-check 2.sh +33 -0
  102. package/src/hooks/inbox-hook 2.sh +76 -0
  103. package/src/hooks/inbox-hook.sh +3 -2
  104. package/src/hooks/post-compact 2.sh +148 -0
  105. package/src/hooks/post-compact.sh +1 -1
  106. package/src/hooks/pre-compact 2.sh +151 -0
  107. package/src/hooks/pre-compact.sh +1 -1
  108. package/src/hooks/session-start 2.sh +268 -0
  109. package/src/hooks/session-start.sh +6 -3
  110. package/src/hooks/session-stop 2.sh +140 -0
  111. package/src/hooks/session-stop.sh +1 -1
  112. package/src/kg_populate 2.py +290 -0
  113. package/src/knowledge_graph 2.py +257 -0
  114. package/src/maintenance 2.py +59 -0
  115. package/src/migrate_embeddings 2.py +122 -0
  116. package/src/plugin_loader 2.py +202 -0
  117. package/src/plugins/__init__ 2.py +0 -0
  118. package/src/plugins/__pycache__/__init__ 2.cpython-310.pyc +0 -0
  119. package/src/plugins/__pycache__/__init__.cpython-310.pyc +0 -0
  120. package/src/plugins/__pycache__/adaptive_mode 2.cpython-310.pyc +0 -0
  121. package/src/plugins/__pycache__/adaptive_mode.cpython-310.pyc +0 -0
  122. package/src/plugins/__pycache__/agents 2.cpython-310.pyc +0 -0
  123. package/src/plugins/__pycache__/agents.cpython-310.pyc +0 -0
  124. package/src/plugins/__pycache__/artifact_registry 2.cpython-310.pyc +0 -0
  125. package/src/plugins/__pycache__/artifact_registry.cpython-310.pyc +0 -0
  126. package/src/plugins/__pycache__/backup 2.cpython-310.pyc +0 -0
  127. package/src/plugins/__pycache__/backup.cpython-310.pyc +0 -0
  128. package/src/plugins/__pycache__/cognitive_memory 2.cpython-310.pyc +0 -0
  129. package/src/plugins/__pycache__/cognitive_memory.cpython-310.pyc +0 -0
  130. package/src/plugins/__pycache__/core_rules 2.cpython-310.pyc +0 -0
  131. package/src/plugins/__pycache__/core_rules.cpython-310.pyc +0 -0
  132. package/src/plugins/__pycache__/cortex 2.cpython-310.pyc +0 -0
  133. package/src/plugins/__pycache__/cortex.cpython-310.pyc +0 -0
  134. package/src/plugins/__pycache__/entities 2.cpython-310.pyc +0 -0
  135. package/src/plugins/__pycache__/entities.cpython-310.pyc +0 -0
  136. package/src/plugins/__pycache__/episodic_memory 2.cpython-310.pyc +0 -0
  137. package/src/plugins/__pycache__/episodic_memory.cpython-310.pyc +0 -0
  138. package/src/plugins/__pycache__/evolution 2.cpython-310.pyc +0 -0
  139. package/src/plugins/__pycache__/evolution.cpython-310.pyc +0 -0
  140. package/src/plugins/__pycache__/guard 2.cpython-310.pyc +0 -0
  141. package/src/plugins/__pycache__/guard.cpython-310.pyc +0 -0
  142. package/src/plugins/__pycache__/knowledge_graph_tools 2.cpython-310.pyc +0 -0
  143. package/src/plugins/__pycache__/knowledge_graph_tools.cpython-310.pyc +0 -0
  144. package/src/plugins/__pycache__/preferences 2.cpython-310.pyc +0 -0
  145. package/src/plugins/__pycache__/preferences.cpython-310.pyc +0 -0
  146. package/src/plugins/__pycache__/update 2.cpython-310.pyc +0 -0
  147. package/src/plugins/__pycache__/update.cpython-310.pyc +0 -0
  148. package/src/plugins/adaptive_mode 2.py +805 -0
  149. package/src/plugins/agents 2.py +52 -0
  150. package/src/plugins/artifact_registry 2.py +450 -0
  151. package/src/plugins/backup 2.py +104 -0
  152. package/src/plugins/cognitive_memory 2.py +564 -0
  153. package/src/plugins/core_rules 2.py +252 -0
  154. package/src/plugins/cortex 2.py +299 -0
  155. package/src/plugins/entities 2.py +67 -0
  156. package/src/plugins/episodic_memory 2.py +533 -0
  157. package/src/plugins/evolution 2.py +115 -0
  158. package/src/plugins/guard 2.py +746 -0
  159. package/src/plugins/knowledge_graph_tools 2.py +105 -0
  160. package/src/plugins/preferences 2.py +47 -0
  161. package/src/plugins/update 2.py +256 -0
  162. package/src/requirements 2.txt +12 -0
  163. package/src/rules/__init__ 2.py +0 -0
  164. package/src/rules/core-rules 2.json +331 -0
  165. package/src/rules/migrate 2.py +207 -0
  166. package/src/scripts/check-context 2.py +264 -0
  167. package/src/scripts/deep-sleep/apply_findings.py +58 -0
  168. package/src/scripts/deep-sleep/synthesize-prompt.md +30 -1
  169. package/src/scripts/nexo-auto-update 2.py +6 -0
  170. package/src/scripts/nexo-backup 2.sh +25 -0
  171. package/src/scripts/nexo-brain-activation 2.sh +140 -0
  172. package/src/scripts/nexo-catchup 2.py +242 -0
  173. package/src/scripts/nexo-cognitive-decay 2.py +182 -0
  174. package/src/scripts/nexo-daily-self-audit 2.py +552 -0
  175. package/src/scripts/nexo-deep-sleep 2.sh +97 -0
  176. package/src/scripts/nexo-evolution-run 2.py +597 -0
  177. package/src/scripts/nexo-followup-hygiene 2.py +112 -0
  178. package/src/scripts/nexo-github-monitor 2.py +256 -0
  179. package/src/scripts/nexo-immune 2.py +927 -0
  180. package/src/scripts/nexo-inbox-hook 2.sh +74 -0
  181. package/src/scripts/nexo-install 2.py +6 -0
  182. package/src/scripts/nexo-learning-housekeep 2.py +245 -0
  183. package/src/scripts/nexo-learning-validator 2.py +207 -0
  184. package/src/scripts/nexo-migrate 2.py +232 -0
  185. package/src/scripts/nexo-postmortem-consolidator 2.py +421 -0
  186. package/src/scripts/nexo-pre-commit 2.py +120 -0
  187. package/src/scripts/nexo-prevent-sleep 2.sh +29 -0
  188. package/src/scripts/nexo-proactive-dashboard 2.py +345 -0
  189. package/src/scripts/nexo-reflection 2.py +253 -0
  190. package/src/scripts/nexo-runtime-preflight 2.py +274 -0
  191. package/src/scripts/nexo-send-email 2.py +25 -0
  192. package/src/scripts/nexo-send-reply 2.py +178 -0
  193. package/src/scripts/nexo-sleep 2.py +592 -0
  194. package/src/scripts/nexo-snapshot-restore 2.sh +35 -0
  195. package/src/scripts/nexo-synthesis 2.py +253 -0
  196. package/src/scripts/nexo-tcc-approve 2.sh +79 -0
  197. package/src/scripts/nexo-update 2.sh +161 -0
  198. package/src/scripts/nexo-watchdog 2.sh +878 -0
  199. package/src/scripts/nexo-watchdog-smoke 2.py +119 -0
  200. package/src/server 2.py +733 -0
  201. package/src/server.py +6 -1
  202. package/src/storage_router 2.py +32 -0
  203. package/src/tools_coordination 2.py +102 -0
  204. package/src/tools_credentials 2.py +68 -0
  205. package/src/tools_learnings 2.py +220 -0
  206. package/src/tools_menu 2.py +227 -0
  207. package/src/tools_reminders 2.py +86 -0
  208. package/src/tools_reminders_crud 2.py +159 -0
  209. package/src/tools_reminders_crud.py +7 -0
  210. package/src/tools_sessions 2.py +476 -0
  211. package/src/tools_task_history 2.py +57 -0
  212. package/templates/CLAUDE.md 2.template +63 -0
  213. package/templates/openclaw 2.json +13 -0
  214. package/tests/__init__ 2.py +0 -0
  215. package/tests/conftest 2.py +71 -0
  216. package/tests/test_cognitive 2.py +205 -0
  217. package/tests/test_knowledge_graph 2.py +140 -0
  218. package/tests/test_migrations 2.py +137 -0
  219. package/src/__pycache__/hnsw_index.cpython-314.pyc +0 -0
  220. package/src/cognitive/__pycache__/__init__.cpython-312.pyc +0 -0
  221. package/src/cognitive/__pycache__/__init__.cpython-314.pyc +0 -0
  222. package/src/cognitive/__pycache__/_core.cpython-312.pyc +0 -0
  223. package/src/cognitive/__pycache__/_core.cpython-314.pyc +0 -0
  224. package/src/cognitive/__pycache__/_decay.cpython-312.pyc +0 -0
  225. package/src/cognitive/__pycache__/_decay.cpython-314.pyc +0 -0
  226. package/src/cognitive/__pycache__/_ingest.cpython-312.pyc +0 -0
  227. package/src/cognitive/__pycache__/_ingest.cpython-314.pyc +0 -0
  228. package/src/cognitive/__pycache__/_memory.cpython-312.pyc +0 -0
  229. package/src/cognitive/__pycache__/_memory.cpython-314.pyc +0 -0
  230. package/src/cognitive/__pycache__/_search.cpython-312.pyc +0 -0
  231. package/src/cognitive/__pycache__/_search.cpython-314.pyc +0 -0
  232. package/src/cognitive/__pycache__/_trust.cpython-312.pyc +0 -0
  233. package/src/cognitive/__pycache__/_trust.cpython-314.pyc +0 -0
  234. package/src/plugins/__pycache__/adaptive_mode.cpython-314.pyc +0 -0
  235. package/src/scripts/deep-sleep/__pycache__/extract.cpython-314.pyc +0 -0
@@ -0,0 +1,124 @@
1
+ """NEXO DB — Credentials module."""
2
+ import sqlite3, time
3
+ from db._core import get_db, now_epoch
4
+
5
+ # ── Credentials ────────────────────────────────────────────────────
6
+
7
+ def create_credential(service: str, key: str, value: str, notes: str = '') -> dict:
8
+ """Create a new credential entry."""
9
+ conn = get_db()
10
+ now = now_epoch()
11
+ try:
12
+ conn.execute(
13
+ "INSERT INTO credentials (service, key, value, notes, created_at, updated_at) "
14
+ "VALUES (?, ?, ?, ?, ?, ?)",
15
+ (service, key, value, notes, now, now)
16
+ )
17
+ conn.commit()
18
+ except sqlite3.IntegrityError:
19
+ return {"error": f"Credential {service}/{key} already exists. Use update instead."}
20
+ row = conn.execute(
21
+ "SELECT * FROM credentials WHERE service = ? AND key = ?", (service, key)
22
+ ).fetchone()
23
+ return dict(row)
24
+
25
+
26
+ def update_credential(service: str, key: str, value: str = None, notes: str = None) -> dict:
27
+ """Update value and/or notes for a credential."""
28
+ conn = get_db()
29
+ row = conn.execute(
30
+ "SELECT * FROM credentials WHERE service = ? AND key = ?", (service, key)
31
+ ).fetchone()
32
+ if not row:
33
+ return {"error": f"Credential {service}/{key} not found"}
34
+ updates = {"updated_at": now_epoch()}
35
+ if value is not None:
36
+ updates["value"] = value
37
+ if notes is not None:
38
+ updates["notes"] = notes
39
+ set_clause = ", ".join(f"{k} = ?" for k in updates)
40
+ values = list(updates.values()) + [service, key]
41
+ conn.execute(
42
+ f"UPDATE credentials SET {set_clause} WHERE service = ? AND key = ?", values
43
+ )
44
+ conn.commit()
45
+ row = conn.execute(
46
+ "SELECT * FROM credentials WHERE service = ? AND key = ?", (service, key)
47
+ ).fetchone()
48
+ return dict(row)
49
+
50
+
51
+ def delete_credential(service: str, key: str = None) -> bool:
52
+ """Delete credential(s). If key=None, delete all for the service."""
53
+ conn = get_db()
54
+ if key:
55
+ result = conn.execute(
56
+ "DELETE FROM credentials WHERE service = ? AND key = ?", (service, key)
57
+ )
58
+ else:
59
+ result = conn.execute(
60
+ "DELETE FROM credentials WHERE service = ?", (service,)
61
+ )
62
+ conn.commit()
63
+ deleted = result.rowcount > 0
64
+ return deleted
65
+
66
+
67
+ def get_credential(service: str, key: str = None) -> list[dict]:
68
+ """Get credential(s). If key=None, return all for the service.
69
+
70
+ When exact match fails, performs fuzzy search across service, key,
71
+ value and notes fields. Returns results tagged with _fuzzy=True so
72
+ the caller can differentiate suggestions from exact hits.
73
+ """
74
+ conn = get_db()
75
+ if key:
76
+ rows = conn.execute(
77
+ "SELECT * FROM credentials WHERE service = ? AND key = ?", (service, key)
78
+ ).fetchall()
79
+ else:
80
+ rows = conn.execute(
81
+ "SELECT * FROM credentials WHERE service = ?", (service,)
82
+ ).fetchall()
83
+ if rows:
84
+ return [dict(r) for r in rows]
85
+
86
+ # Fuzzy fallback: search term in service, key and notes (not value — too noisy)
87
+ # Prioritize: service/key matches first, notes-only matches second
88
+ term = f"%{service}%"
89
+ fuzzy_rows = conn.execute(
90
+ "SELECT *, "
91
+ "CASE WHEN service LIKE ? THEN 0 "
92
+ " WHEN key LIKE ? THEN 1 "
93
+ " ELSE 2 END AS _rank "
94
+ "FROM credentials WHERE "
95
+ "service LIKE ? OR key LIKE ? OR notes LIKE ? "
96
+ "ORDER BY _rank ASC, service ASC, key ASC",
97
+ (term, term, term, term, term),
98
+ ).fetchall()
99
+ results = []
100
+ for r in fuzzy_rows:
101
+ d = dict(r)
102
+ d["_fuzzy"] = True
103
+ d.pop("_rank", None)
104
+ results.append(d)
105
+ return results
106
+
107
+
108
+ def list_credentials(service: str = None) -> list[dict]:
109
+ """List service+key only (NO values) for security."""
110
+ conn = get_db()
111
+ if service:
112
+ rows = conn.execute(
113
+ "SELECT id, service, key, notes, created_at, updated_at "
114
+ "FROM credentials WHERE service = ? ORDER BY key ASC",
115
+ (service,)
116
+ ).fetchall()
117
+ else:
118
+ rows = conn.execute(
119
+ "SELECT id, service, key, notes, created_at, updated_at "
120
+ "FROM credentials ORDER BY service ASC, key ASC"
121
+ ).fetchall()
122
+ return [dict(r) for r in rows]
123
+
124
+
@@ -0,0 +1,178 @@
1
+ """NEXO DB — Entities module."""
2
+ import time
3
+ from db._core import get_db, _multi_word_like
4
+ from db._fts import fts_upsert
5
+
6
+ # ── Entities ──────────────────────────────────────────────────────
7
+
8
+ def create_entity(name: str, type: str, value: str, notes: str = "") -> int:
9
+ """Create a new entity. Returns the entity ID."""
10
+ conn = get_db()
11
+ now = time.time()
12
+ cursor = conn.execute(
13
+ "INSERT INTO entities (name, type, value, notes, created_at, updated_at) "
14
+ "VALUES (?, ?, ?, ?, ?, ?)",
15
+ (name, type, value, notes, now, now)
16
+ )
17
+ conn.commit()
18
+ eid = cursor.lastrowid
19
+ fts_upsert("entity", str(eid), name, f"{name} {value} {notes}", type or "general", commit=False)
20
+ return eid
21
+
22
+
23
+ def search_entities(query: str, type: str = "") -> list[dict]:
24
+ """Search entities by name or value. Multi-word AND search."""
25
+ conn = get_db()
26
+ frag, params = _multi_word_like(query, ["name", "value"])
27
+ if type:
28
+ where = f"type = ? AND ({frag})"
29
+ params.insert(0, type)
30
+ else:
31
+ where = frag
32
+ rows = conn.execute(
33
+ f"SELECT * FROM entities WHERE {where} ORDER BY updated_at DESC",
34
+ params
35
+ ).fetchall()
36
+ return [dict(r) for r in rows]
37
+
38
+
39
+ def list_entities(type: str = "") -> list[dict]:
40
+ """List all entities, optionally filtered by type."""
41
+ conn = get_db()
42
+ if type:
43
+ rows = conn.execute(
44
+ "SELECT * FROM entities WHERE type = ? ORDER BY name ASC",
45
+ (type,)
46
+ ).fetchall()
47
+ else:
48
+ rows = conn.execute(
49
+ "SELECT * FROM entities ORDER BY type ASC, name ASC"
50
+ ).fetchall()
51
+ return [dict(r) for r in rows]
52
+
53
+
54
+ def update_entity(id: int, **kwargs):
55
+ """Update entity fields: name, type, value, notes."""
56
+ conn = get_db()
57
+ allowed = {"name", "type", "value", "notes"}
58
+ updates = {k: v for k, v in kwargs.items() if k in allowed}
59
+ if not updates:
60
+ return
61
+ updates["updated_at"] = time.time()
62
+ set_clause = ", ".join(f"{k} = ?" for k in updates)
63
+ values = list(updates.values()) + [id]
64
+ conn.execute(f"UPDATE entities SET {set_clause} WHERE id = ?", values)
65
+ conn.commit()
66
+ row = conn.execute("SELECT * FROM entities WHERE id = ?", (id,)).fetchone()
67
+ if row:
68
+ r = dict(row)
69
+ fts_upsert("entity", str(id), r.get("name",""), f"{r.get('name','')} {r.get('value','')} {r.get('notes','')}", r.get("type","general"), commit=False)
70
+
71
+
72
+ def delete_entity(id: int) -> bool:
73
+ """Delete an entity. Returns True if deleted, False if not found."""
74
+ conn = get_db()
75
+ result = conn.execute("DELETE FROM entities WHERE id = ?", (id,))
76
+ conn.execute("DELETE FROM unified_search WHERE source = 'entity' AND source_id = ?", (str(id),))
77
+ conn.commit()
78
+ return result.rowcount > 0
79
+
80
+
81
+ # ── Preferences ───────────────────────────────────────────────────
82
+
83
+ def set_preference(key: str, value: str, category: str = "general"):
84
+ """Set a preference (insert or update)."""
85
+ conn = get_db()
86
+ now = time.time()
87
+ conn.execute(
88
+ "INSERT OR REPLACE INTO preferences (key, value, category, updated_at) "
89
+ "VALUES (?, ?, ?, ?)",
90
+ (key, value, category, now)
91
+ )
92
+ conn.commit()
93
+
94
+
95
+ def get_preference(key: str) -> dict | None:
96
+ """Get a single preference by key."""
97
+ conn = get_db()
98
+ row = conn.execute("SELECT * FROM preferences WHERE key = ?", (key,)).fetchone()
99
+ return dict(row) if row else None
100
+
101
+
102
+ def list_preferences(category: str = "") -> list[dict]:
103
+ """List all preferences, optionally filtered by category."""
104
+ conn = get_db()
105
+ if category:
106
+ rows = conn.execute(
107
+ "SELECT * FROM preferences WHERE category = ? ORDER BY key ASC",
108
+ (category,)
109
+ ).fetchall()
110
+ else:
111
+ rows = conn.execute(
112
+ "SELECT * FROM preferences ORDER BY category ASC, key ASC"
113
+ ).fetchall()
114
+ return [dict(r) for r in rows]
115
+
116
+
117
+ def delete_preference(key: str) -> bool:
118
+ """Delete a preference. Returns True if deleted, False if not found."""
119
+ conn = get_db()
120
+ result = conn.execute("DELETE FROM preferences WHERE key = ?", (key,))
121
+ conn.commit()
122
+ return result.rowcount > 0
123
+
124
+
125
+ # ── Agents ────────────────────────────────────────────────────────
126
+
127
+ def create_agent(id: str, name: str, specialization: str, model: str = "sonnet",
128
+ tools: str = "", context_files: str = "", rules: str = "") -> dict:
129
+ """Register a new agent. Uses INSERT OR REPLACE to allow re-registration."""
130
+ conn = get_db()
131
+ now = time.time()
132
+ conn.execute(
133
+ "INSERT OR REPLACE INTO agents (id, name, specialization, model, tools, context_files, rules, created_at, updated_at) "
134
+ "VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)",
135
+ (id, name, specialization, model, tools, context_files, rules, now, now)
136
+ )
137
+ conn.commit()
138
+ return {"id": id, "name": name}
139
+
140
+
141
+ def get_agent(id: str) -> dict | None:
142
+ """Get an agent by ID."""
143
+ conn = get_db()
144
+ row = conn.execute("SELECT * FROM agents WHERE id = ?", (id,)).fetchone()
145
+ return dict(row) if row else None
146
+
147
+
148
+ def list_agents() -> list[dict]:
149
+ """List all registered agents."""
150
+ conn = get_db()
151
+ rows = conn.execute(
152
+ "SELECT * FROM agents ORDER BY name ASC"
153
+ ).fetchall()
154
+ return [dict(r) for r in rows]
155
+
156
+
157
+ def update_agent(id: str, **kwargs):
158
+ """Update agent fields: name, specialization, model, tools, context_files, rules."""
159
+ conn = get_db()
160
+ allowed = {"name", "specialization", "model", "tools", "context_files", "rules"}
161
+ updates = {k: v for k, v in kwargs.items() if k in allowed}
162
+ if not updates:
163
+ return
164
+ updates["updated_at"] = time.time()
165
+ set_clause = ", ".join(f"{k} = ?" for k in updates)
166
+ values = list(updates.values()) + [id]
167
+ conn.execute(f"UPDATE agents SET {set_clause} WHERE id = ?", values)
168
+ conn.commit()
169
+
170
+
171
+ def delete_agent(id: str) -> bool:
172
+ """Delete an agent. Returns True if deleted, False if not found."""
173
+ conn = get_db()
174
+ result = conn.execute("DELETE FROM agents WHERE id = ?", (id,))
175
+ conn.commit()
176
+ return result.rowcount > 0
177
+
178
+