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,178 +0,0 @@
1
- #!/usr/bin/env python3
2
- """
3
- NEXO Email Reply Helper — Sends email replies with correct threading headers.
4
- NEXO calls this instead of building SMTP manually.
5
-
6
- Usage:
7
- nexo-send-reply.py --to addr --subject "Re: ..." --in-reply-to "<msg-id>" --body "text"
8
- nexo-send-reply.py --to addr --subject "Re: ..." --in-reply-to "<msg-id>" --body-file /tmp/reply.html --html
9
- nexo-send-reply.py --to addr --subject "New subject" --body "text" (new email, no threading)
10
-
11
- Options:
12
- --to Recipient (required)
13
- --cc CC recipients (comma-separated, default: info@example.com)
14
- --subject Subject line (required)
15
- --in-reply-to Message-ID of the email being replied to (for threading)
16
- --references Full References chain (optional, defaults to in-reply-to value)
17
- --body Plain text body (inline)
18
- --body-file Read body from file instead
19
- --html Treat body as HTML
20
- --quote Original message text to include as quoted reply
21
- --quote-file Read original message from file to quote
22
- --quote-from Sender of the original message (for "On date, X wrote:")
23
- --quote-date Date of the original message
24
- --attachment Path to file attachment (can be repeated)
25
- """
26
-
27
- import argparse
28
- import imaplib
29
- import json
30
- import os
31
- import smtplib
32
- import sys
33
- import time
34
- from email.message import EmailMessage
35
- from email.utils import make_msgid, formatdate
36
- from pathlib import Path
37
- import mimetypes
38
-
39
- NEXO_HOME = Path(os.environ.get("NEXO_HOME", str(Path.home() / ".nexo")))
40
- CONFIG_PATH = NEXO_HOME / "nexo-email" / "config.json"
41
-
42
-
43
- def load_config():
44
- with open(CONFIG_PATH) as f:
45
- return json.load(f)
46
-
47
-
48
- def build_message(args, config):
49
- msg = EmailMessage()
50
-
51
- # From / To / CC
52
- msg["From"] = f"NEXO <{config['email']}>"
53
- msg["To"] = args.to
54
- if args.cc:
55
- msg["Cc"] = args.cc
56
-
57
- # Subject
58
- msg["Subject"] = args.subject
59
-
60
- # Threading headers — this is the whole point of this script
61
- if args.in_reply_to:
62
- msg["In-Reply-To"] = args.in_reply_to
63
- msg["References"] = args.references or args.in_reply_to
64
-
65
- # Standard headers
66
- msg["Message-ID"] = make_msgid(domain="example.com")
67
- msg["Date"] = formatdate(localtime=True)
68
-
69
- # Body
70
- if args.body_file:
71
- body = Path(args.body_file).read_text(encoding="utf-8")
72
- else:
73
- body = args.body or ""
74
-
75
- # Quoted original message
76
- quote_text = ""
77
- if args.quote_file:
78
- quote_text = Path(args.quote_file).read_text(encoding="utf-8")
79
- elif args.quote:
80
- quote_text = args.quote
81
-
82
- if quote_text:
83
- quote_from = args.quote_from or args.to
84
- quote_date = args.quote_date or ""
85
- attribution = f"On {quote_date}, {quote_from} wrote:" if quote_date else f"{quote_from} wrote:"
86
-
87
- if args.html:
88
- quoted_html = quote_text.replace("\n", "<br>") if "<" not in quote_text else quote_text
89
- body = (
90
- f"{body}<br><br>"
91
- f"<div style=\"color:#666;\">{attribution}</div>"
92
- f"<blockquote style=\"margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;color:#666;\">"
93
- f"{quoted_html}"
94
- f"</blockquote>"
95
- )
96
- else:
97
- quoted_lines = "\n".join(f"> {line}" for line in quote_text.splitlines())
98
- body = f"{body}\n\n{attribution}\n{quoted_lines}"
99
-
100
- if args.html:
101
- msg.set_content(body, subtype="html")
102
- else:
103
- msg.set_content(body)
104
-
105
- # Attachments
106
- if args.attachment:
107
- for filepath in args.attachment:
108
- p = Path(filepath)
109
- if not p.exists():
110
- print(f"WARNING: attachment not found: {filepath}", file=sys.stderr)
111
- continue
112
- mime_type, _ = mimetypes.guess_type(str(p))
113
- if mime_type is None:
114
- mime_type = "application/octet-stream"
115
- maintype, subtype = mime_type.split("/", 1)
116
- with open(p, "rb") as f:
117
- msg.add_attachment(
118
- f.read(),
119
- maintype=maintype,
120
- subtype=subtype,
121
- filename=p.name
122
- )
123
-
124
- return msg
125
-
126
-
127
- def send(msg, config):
128
- with smtplib.SMTP_SSL(config["smtp_host"], config["smtp_port"]) as server:
129
- server.login(config["email"], config["password"])
130
- server.send_message(msg)
131
-
132
-
133
- def save_to_sent(msg, config):
134
- """Append the sent message to the IMAP Sent folder."""
135
- try:
136
- with imaplib.IMAP4_SSL(config["imap_host"], config["imap_port"]) as imap:
137
- imap.login(config["email"], config["password"])
138
- imap.append(
139
- "INBOX.Sent",
140
- r"\Seen",
141
- imaplib.Time2Internaldate(time.time()),
142
- msg.as_bytes(),
143
- )
144
- except Exception as e:
145
- print(f"WARNING: could not save to Sent folder: {e}", file=sys.stderr)
146
-
147
-
148
- def main():
149
- parser = argparse.ArgumentParser(description="NEXO Email Reply Helper")
150
- parser.add_argument("--to", required=True, help="Recipient email")
151
- parser.add_argument("--cc", default=None, help="CC recipients (comma-separated, no default)")
152
- parser.add_argument("--subject", required=True, help="Subject line")
153
- parser.add_argument("--in-reply-to", default=None, help="Message-ID for threading")
154
- parser.add_argument("--references", default=None, help="References chain for threading")
155
- parser.add_argument("--body", default=None, help="Body text inline")
156
- parser.add_argument("--body-file", default=None, help="Read body from file")
157
- parser.add_argument("--html", action="store_true", help="Body is HTML")
158
- parser.add_argument("--quote", default=None, help="Original message text to quote inline")
159
- parser.add_argument("--quote-file", default=None, help="Read original message from file to quote")
160
- parser.add_argument("--quote-from", default=None, help="Sender of original (for attribution line)")
161
- parser.add_argument("--quote-date", default=None, help="Date of original message")
162
- parser.add_argument("--attachment", action="append", help="File to attach (repeatable)")
163
- args = parser.parse_args()
164
-
165
- if not args.body and not args.body_file:
166
- print("ERROR: --body or --body-file required", file=sys.stderr)
167
- sys.exit(1)
168
-
169
- config = load_config()
170
- msg = build_message(args, config)
171
- send(msg, config)
172
- save_to_sent(msg, config)
173
-
174
- print(f"OK: sent to {args.to} | subject: {args.subject} | threaded: {bool(args.in_reply_to)}")
175
-
176
-
177
- if __name__ == "__main__":
178
- main()
@@ -1,178 +0,0 @@
1
- #!/usr/bin/env python3
2
- """
3
- NEXO Email Reply Helper — Sends email replies with correct threading headers.
4
- NEXO calls this instead of building SMTP manually.
5
-
6
- Usage:
7
- nexo-send-reply.py --to addr --subject "Re: ..." --in-reply-to "<msg-id>" --body "text"
8
- nexo-send-reply.py --to addr --subject "Re: ..." --in-reply-to "<msg-id>" --body-file /tmp/reply.html --html
9
- nexo-send-reply.py --to addr --subject "New subject" --body "text" (new email, no threading)
10
-
11
- Options:
12
- --to Recipient (required)
13
- --cc CC recipients (comma-separated, default: info@example.com)
14
- --subject Subject line (required)
15
- --in-reply-to Message-ID of the email being replied to (for threading)
16
- --references Full References chain (optional, defaults to in-reply-to value)
17
- --body Plain text body (inline)
18
- --body-file Read body from file instead
19
- --html Treat body as HTML
20
- --quote Original message text to include as quoted reply
21
- --quote-file Read original message from file to quote
22
- --quote-from Sender of the original message (for "On date, X wrote:")
23
- --quote-date Date of the original message
24
- --attachment Path to file attachment (can be repeated)
25
- """
26
-
27
- import argparse
28
- import imaplib
29
- import json
30
- import os
31
- import smtplib
32
- import sys
33
- import time
34
- from email.message import EmailMessage
35
- from email.utils import make_msgid, formatdate
36
- from pathlib import Path
37
- import mimetypes
38
-
39
- NEXO_HOME = Path(os.environ.get("NEXO_HOME", str(Path.home() / ".nexo")))
40
- CONFIG_PATH = NEXO_HOME / "nexo-email" / "config.json"
41
-
42
-
43
- def load_config():
44
- with open(CONFIG_PATH) as f:
45
- return json.load(f)
46
-
47
-
48
- def build_message(args, config):
49
- msg = EmailMessage()
50
-
51
- # From / To / CC
52
- msg["From"] = f"NEXO <{config['email']}>"
53
- msg["To"] = args.to
54
- if args.cc:
55
- msg["Cc"] = args.cc
56
-
57
- # Subject
58
- msg["Subject"] = args.subject
59
-
60
- # Threading headers — this is the whole point of this script
61
- if args.in_reply_to:
62
- msg["In-Reply-To"] = args.in_reply_to
63
- msg["References"] = args.references or args.in_reply_to
64
-
65
- # Standard headers
66
- msg["Message-ID"] = make_msgid(domain="example.com")
67
- msg["Date"] = formatdate(localtime=True)
68
-
69
- # Body
70
- if args.body_file:
71
- body = Path(args.body_file).read_text(encoding="utf-8")
72
- else:
73
- body = args.body or ""
74
-
75
- # Quoted original message
76
- quote_text = ""
77
- if args.quote_file:
78
- quote_text = Path(args.quote_file).read_text(encoding="utf-8")
79
- elif args.quote:
80
- quote_text = args.quote
81
-
82
- if quote_text:
83
- quote_from = args.quote_from or args.to
84
- quote_date = args.quote_date or ""
85
- attribution = f"On {quote_date}, {quote_from} wrote:" if quote_date else f"{quote_from} wrote:"
86
-
87
- if args.html:
88
- quoted_html = quote_text.replace("\n", "<br>") if "<" not in quote_text else quote_text
89
- body = (
90
- f"{body}<br><br>"
91
- f"<div style=\"color:#666;\">{attribution}</div>"
92
- f"<blockquote style=\"margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;color:#666;\">"
93
- f"{quoted_html}"
94
- f"</blockquote>"
95
- )
96
- else:
97
- quoted_lines = "\n".join(f"> {line}" for line in quote_text.splitlines())
98
- body = f"{body}\n\n{attribution}\n{quoted_lines}"
99
-
100
- if args.html:
101
- msg.set_content(body, subtype="html")
102
- else:
103
- msg.set_content(body)
104
-
105
- # Attachments
106
- if args.attachment:
107
- for filepath in args.attachment:
108
- p = Path(filepath)
109
- if not p.exists():
110
- print(f"WARNING: attachment not found: {filepath}", file=sys.stderr)
111
- continue
112
- mime_type, _ = mimetypes.guess_type(str(p))
113
- if mime_type is None:
114
- mime_type = "application/octet-stream"
115
- maintype, subtype = mime_type.split("/", 1)
116
- with open(p, "rb") as f:
117
- msg.add_attachment(
118
- f.read(),
119
- maintype=maintype,
120
- subtype=subtype,
121
- filename=p.name
122
- )
123
-
124
- return msg
125
-
126
-
127
- def send(msg, config):
128
- with smtplib.SMTP_SSL(config["smtp_host"], config["smtp_port"]) as server:
129
- server.login(config["email"], config["password"])
130
- server.send_message(msg)
131
-
132
-
133
- def save_to_sent(msg, config):
134
- """Append the sent message to the IMAP Sent folder."""
135
- try:
136
- with imaplib.IMAP4_SSL(config["imap_host"], config["imap_port"]) as imap:
137
- imap.login(config["email"], config["password"])
138
- imap.append(
139
- "INBOX.Sent",
140
- r"\Seen",
141
- imaplib.Time2Internaldate(time.time()),
142
- msg.as_bytes(),
143
- )
144
- except Exception as e:
145
- print(f"WARNING: could not save to Sent folder: {e}", file=sys.stderr)
146
-
147
-
148
- def main():
149
- parser = argparse.ArgumentParser(description="NEXO Email Reply Helper")
150
- parser.add_argument("--to", required=True, help="Recipient email")
151
- parser.add_argument("--cc", default=None, help="CC recipients (comma-separated, no default)")
152
- parser.add_argument("--subject", required=True, help="Subject line")
153
- parser.add_argument("--in-reply-to", default=None, help="Message-ID for threading")
154
- parser.add_argument("--references", default=None, help="References chain for threading")
155
- parser.add_argument("--body", default=None, help="Body text inline")
156
- parser.add_argument("--body-file", default=None, help="Read body from file")
157
- parser.add_argument("--html", action="store_true", help="Body is HTML")
158
- parser.add_argument("--quote", default=None, help="Original message text to quote inline")
159
- parser.add_argument("--quote-file", default=None, help="Read original message from file to quote")
160
- parser.add_argument("--quote-from", default=None, help="Sender of original (for attribution line)")
161
- parser.add_argument("--quote-date", default=None, help="Date of original message")
162
- parser.add_argument("--attachment", action="append", help="File to attach (repeatable)")
163
- args = parser.parse_args()
164
-
165
- if not args.body and not args.body_file:
166
- print("ERROR: --body or --body-file required", file=sys.stderr)
167
- sys.exit(1)
168
-
169
- config = load_config()
170
- msg = build_message(args, config)
171
- send(msg, config)
172
- save_to_sent(msg, config)
173
-
174
- print(f"OK: sent to {args.to} | subject: {args.subject} | threaded: {bool(args.in_reply_to)}")
175
-
176
-
177
- if __name__ == "__main__":
178
- main()