imap-wizard 0.0.0-stage → 0.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 (404) hide show
  1. package/COPYING +674 -0
  2. package/LICENSE +155 -0
  3. package/README.md +498 -2
  4. package/dist/app.d.ts +61 -0
  5. package/dist/app.d.ts.map +1 -0
  6. package/dist/app.js +201 -0
  7. package/dist/app.js.map +1 -0
  8. package/dist/cache/body-cache.d.ts +29 -0
  9. package/dist/cache/body-cache.d.ts.map +1 -0
  10. package/dist/cache/body-cache.js +95 -0
  11. package/dist/cache/body-cache.js.map +1 -0
  12. package/dist/cache/schema.d.ts +40 -0
  13. package/dist/cache/schema.d.ts.map +1 -0
  14. package/dist/cache/schema.js +160 -0
  15. package/dist/cache/schema.js.map +1 -0
  16. package/dist/cache/store.d.ts +233 -0
  17. package/dist/cache/store.d.ts.map +1 -0
  18. package/dist/cache/store.js +556 -0
  19. package/dist/cache/store.js.map +1 -0
  20. package/dist/cache/sync-engine.d.ts +140 -0
  21. package/dist/cache/sync-engine.d.ts.map +1 -0
  22. package/dist/cache/sync-engine.js +477 -0
  23. package/dist/cache/sync-engine.js.map +1 -0
  24. package/dist/cli/account-commands.d.ts +51 -0
  25. package/dist/cli/account-commands.d.ts.map +1 -0
  26. package/dist/cli/account-commands.js +767 -0
  27. package/dist/cli/account-commands.js.map +1 -0
  28. package/dist/cli/config-commands.d.ts +9 -0
  29. package/dist/cli/config-commands.d.ts.map +1 -0
  30. package/dist/cli/config-commands.js +293 -0
  31. package/dist/cli/config-commands.js.map +1 -0
  32. package/dist/cli/email-commands.d.ts +18 -0
  33. package/dist/cli/email-commands.d.ts.map +1 -0
  34. package/dist/cli/email-commands.js +447 -0
  35. package/dist/cli/email-commands.js.map +1 -0
  36. package/dist/cli/guard.d.ts +11 -0
  37. package/dist/cli/guard.d.ts.map +1 -0
  38. package/dist/cli/guard.js +18 -0
  39. package/dist/cli/guard.js.map +1 -0
  40. package/dist/cli/http.d.ts +15 -0
  41. package/dist/cli/http.d.ts.map +1 -0
  42. package/dist/cli/http.js +263 -0
  43. package/dist/cli/http.js.map +1 -0
  44. package/dist/cli/install-commands.d.ts +18 -0
  45. package/dist/cli/install-commands.d.ts.map +1 -0
  46. package/dist/cli/install-commands.js +323 -0
  47. package/dist/cli/install-commands.js.map +1 -0
  48. package/dist/cli/keychain-commands.d.ts +9 -0
  49. package/dist/cli/keychain-commands.d.ts.map +1 -0
  50. package/dist/cli/keychain-commands.js +243 -0
  51. package/dist/cli/keychain-commands.js.map +1 -0
  52. package/dist/cli/notify.d.ts +8 -0
  53. package/dist/cli/notify.d.ts.map +1 -0
  54. package/dist/cli/notify.js +143 -0
  55. package/dist/cli/notify.js.map +1 -0
  56. package/dist/cli/providers.d.ts +13 -0
  57. package/dist/cli/providers.d.ts.map +1 -0
  58. package/dist/cli/providers.js +180 -0
  59. package/dist/cli/providers.js.map +1 -0
  60. package/dist/cli/scheduler.d.ts +8 -0
  61. package/dist/cli/scheduler.d.ts.map +1 -0
  62. package/dist/cli/scheduler.js +268 -0
  63. package/dist/cli/scheduler.js.map +1 -0
  64. package/dist/cli/setup.d.ts +12 -0
  65. package/dist/cli/setup.d.ts.map +1 -0
  66. package/dist/cli/setup.js +15 -0
  67. package/dist/cli/setup.js.map +1 -0
  68. package/dist/cli/test.d.ts +7 -0
  69. package/dist/cli/test.d.ts.map +1 -0
  70. package/dist/cli/test.js +67 -0
  71. package/dist/cli/test.js.map +1 -0
  72. package/dist/config/loader.d.ts +45 -0
  73. package/dist/config/loader.d.ts.map +1 -0
  74. package/dist/config/loader.js +487 -0
  75. package/dist/config/loader.js.map +1 -0
  76. package/dist/config/password-command.d.ts +14 -0
  77. package/dist/config/password-command.d.ts.map +1 -0
  78. package/dist/config/password-command.js +74 -0
  79. package/dist/config/password-command.js.map +1 -0
  80. package/dist/config/schema.d.ts +416 -0
  81. package/dist/config/schema.d.ts.map +1 -0
  82. package/dist/config/schema.js +260 -0
  83. package/dist/config/schema.js.map +1 -0
  84. package/dist/config/send-limit.d.ts +18 -0
  85. package/dist/config/send-limit.d.ts.map +1 -0
  86. package/dist/config/send-limit.js +64 -0
  87. package/dist/config/send-limit.js.map +1 -0
  88. package/dist/config/validate.d.ts +30 -0
  89. package/dist/config/validate.d.ts.map +1 -0
  90. package/dist/config/validate.js +120 -0
  91. package/dist/config/validate.js.map +1 -0
  92. package/dist/config/xdg.d.ts +44 -0
  93. package/dist/config/xdg.d.ts.map +1 -0
  94. package/dist/config/xdg.js +49 -0
  95. package/dist/config/xdg.js.map +1 -0
  96. package/dist/connections/manager.d.ts +53 -0
  97. package/dist/connections/manager.d.ts.map +1 -0
  98. package/dist/connections/manager.js +376 -0
  99. package/dist/connections/manager.js.map +1 -0
  100. package/dist/connections/types.d.ts +15 -0
  101. package/dist/connections/types.d.ts.map +1 -0
  102. package/dist/connections/types.js +2 -0
  103. package/dist/connections/types.js.map +1 -0
  104. package/dist/logging.d.ts +22 -0
  105. package/dist/logging.d.ts.map +1 -0
  106. package/dist/logging.js +33 -0
  107. package/dist/logging.js.map +1 -0
  108. package/dist/main.d.ts +15 -0
  109. package/dist/main.d.ts.map +1 -0
  110. package/dist/main.js +276 -0
  111. package/dist/main.js.map +1 -0
  112. package/dist/prompts/actions.prompt.d.ts +9 -0
  113. package/dist/prompts/actions.prompt.d.ts.map +1 -0
  114. package/dist/prompts/actions.prompt.js +70 -0
  115. package/dist/prompts/actions.prompt.js.map +1 -0
  116. package/dist/prompts/calendar.prompt.d.ts +9 -0
  117. package/dist/prompts/calendar.prompt.d.ts.map +1 -0
  118. package/dist/prompts/calendar.prompt.js +59 -0
  119. package/dist/prompts/calendar.prompt.js.map +1 -0
  120. package/dist/prompts/cleanup.prompt.d.ts +9 -0
  121. package/dist/prompts/cleanup.prompt.d.ts.map +1 -0
  122. package/dist/prompts/cleanup.prompt.js +82 -0
  123. package/dist/prompts/cleanup.prompt.js.map +1 -0
  124. package/dist/prompts/compose.prompt.d.ts +8 -0
  125. package/dist/prompts/compose.prompt.d.ts.map +1 -0
  126. package/dist/prompts/compose.prompt.js +124 -0
  127. package/dist/prompts/compose.prompt.js.map +1 -0
  128. package/dist/prompts/register.d.ts +8 -0
  129. package/dist/prompts/register.d.ts.map +1 -0
  130. package/dist/prompts/register.js +20 -0
  131. package/dist/prompts/register.js.map +1 -0
  132. package/dist/prompts/thread.prompt.d.ts +9 -0
  133. package/dist/prompts/thread.prompt.d.ts.map +1 -0
  134. package/dist/prompts/thread.prompt.js +62 -0
  135. package/dist/prompts/thread.prompt.js.map +1 -0
  136. package/dist/prompts/triage.prompt.d.ts +9 -0
  137. package/dist/prompts/triage.prompt.d.ts.map +1 -0
  138. package/dist/prompts/triage.prompt.js +71 -0
  139. package/dist/prompts/triage.prompt.js.map +1 -0
  140. package/dist/resources/accounts.resource.d.ts +9 -0
  141. package/dist/resources/accounts.resource.d.ts.map +1 -0
  142. package/dist/resources/accounts.resource.js +26 -0
  143. package/dist/resources/accounts.resource.js.map +1 -0
  144. package/dist/resources/mailboxes.resource.d.ts +10 -0
  145. package/dist/resources/mailboxes.resource.d.ts.map +1 -0
  146. package/dist/resources/mailboxes.resource.js +33 -0
  147. package/dist/resources/mailboxes.resource.js.map +1 -0
  148. package/dist/resources/register.d.ts +12 -0
  149. package/dist/resources/register.d.ts.map +1 -0
  150. package/dist/resources/register.js +20 -0
  151. package/dist/resources/register.js.map +1 -0
  152. package/dist/resources/scheduled.resource.d.ts +9 -0
  153. package/dist/resources/scheduled.resource.d.ts.map +1 -0
  154. package/dist/resources/scheduled.resource.js +31 -0
  155. package/dist/resources/scheduled.resource.js.map +1 -0
  156. package/dist/resources/stats.resource.d.ts +10 -0
  157. package/dist/resources/stats.resource.d.ts.map +1 -0
  158. package/dist/resources/stats.resource.js +50 -0
  159. package/dist/resources/stats.resource.js.map +1 -0
  160. package/dist/resources/templates.resource.d.ts +9 -0
  161. package/dist/resources/templates.resource.d.ts.map +1 -0
  162. package/dist/resources/templates.resource.js +34 -0
  163. package/dist/resources/templates.resource.js.map +1 -0
  164. package/dist/resources/unread.resource.d.ts +11 -0
  165. package/dist/resources/unread.resource.d.ts.map +1 -0
  166. package/dist/resources/unread.resource.js +53 -0
  167. package/dist/resources/unread.resource.js.map +1 -0
  168. package/dist/safety/audit.d.ts +17 -0
  169. package/dist/safety/audit.d.ts.map +1 -0
  170. package/dist/safety/audit.js +50 -0
  171. package/dist/safety/audit.js.map +1 -0
  172. package/dist/safety/rate-limiter.d.ts +22 -0
  173. package/dist/safety/rate-limiter.d.ts.map +1 -0
  174. package/dist/safety/rate-limiter.js +52 -0
  175. package/dist/safety/rate-limiter.js.map +1 -0
  176. package/dist/safety/validation.d.ts +46 -0
  177. package/dist/safety/validation.d.ts.map +1 -0
  178. package/dist/safety/validation.js +114 -0
  179. package/dist/safety/validation.js.map +1 -0
  180. package/dist/safety/webhook-guard.d.ts +33 -0
  181. package/dist/safety/webhook-guard.d.ts.map +1 -0
  182. package/dist/safety/webhook-guard.js +154 -0
  183. package/dist/safety/webhook-guard.js.map +1 -0
  184. package/dist/security/keychain.d.ts +31 -0
  185. package/dist/security/keychain.d.ts.map +1 -0
  186. package/dist/security/keychain.js +217 -0
  187. package/dist/security/keychain.js.map +1 -0
  188. package/dist/server.d.ts +13 -0
  189. package/dist/server.d.ts.map +1 -0
  190. package/dist/server.js +35 -0
  191. package/dist/server.js.map +1 -0
  192. package/dist/services/calendar.service.d.ts +22 -0
  193. package/dist/services/calendar.service.d.ts.map +1 -0
  194. package/dist/services/calendar.service.js +115 -0
  195. package/dist/services/calendar.service.js.map +1 -0
  196. package/dist/services/clipboard.service.d.ts +16 -0
  197. package/dist/services/clipboard.service.d.ts.map +1 -0
  198. package/dist/services/clipboard.service.js +92 -0
  199. package/dist/services/clipboard.service.js.map +1 -0
  200. package/dist/services/event-bus.d.ts +62 -0
  201. package/dist/services/event-bus.d.ts.map +1 -0
  202. package/dist/services/event-bus.js +16 -0
  203. package/dist/services/event-bus.js.map +1 -0
  204. package/dist/services/hooks.service.d.ts +88 -0
  205. package/dist/services/hooks.service.d.ts.map +1 -0
  206. package/dist/services/hooks.service.js +539 -0
  207. package/dist/services/hooks.service.js.map +1 -0
  208. package/dist/services/imap.service.d.ts +301 -0
  209. package/dist/services/imap.service.d.ts.map +1 -0
  210. package/dist/services/imap.service.js +2135 -0
  211. package/dist/services/imap.service.js.map +1 -0
  212. package/dist/services/label-strategy.d.ts +20 -0
  213. package/dist/services/label-strategy.d.ts.map +1 -0
  214. package/dist/services/label-strategy.js +247 -0
  215. package/dist/services/label-strategy.js.map +1 -0
  216. package/dist/services/local-calendar.service.d.ts +127 -0
  217. package/dist/services/local-calendar.service.d.ts.map +1 -0
  218. package/dist/services/local-calendar.service.js +537 -0
  219. package/dist/services/local-calendar.service.js.map +1 -0
  220. package/dist/services/notifier.service.d.ts +91 -0
  221. package/dist/services/notifier.service.d.ts.map +1 -0
  222. package/dist/services/notifier.service.js +381 -0
  223. package/dist/services/notifier.service.js.map +1 -0
  224. package/dist/services/oauth.service.d.ts +47 -0
  225. package/dist/services/oauth.service.d.ts.map +1 -0
  226. package/dist/services/oauth.service.js +140 -0
  227. package/dist/services/oauth.service.js.map +1 -0
  228. package/dist/services/presets.d.ts +36 -0
  229. package/dist/services/presets.d.ts.map +1 -0
  230. package/dist/services/presets.js +175 -0
  231. package/dist/services/presets.js.map +1 -0
  232. package/dist/services/reminders.service.d.ts +63 -0
  233. package/dist/services/reminders.service.d.ts.map +1 -0
  234. package/dist/services/reminders.service.js +305 -0
  235. package/dist/services/reminders.service.js.map +1 -0
  236. package/dist/services/scheduler.service.d.ts +42 -0
  237. package/dist/services/scheduler.service.d.ts.map +1 -0
  238. package/dist/services/scheduler.service.js +294 -0
  239. package/dist/services/scheduler.service.js.map +1 -0
  240. package/dist/services/smtp.service.d.ts +97 -0
  241. package/dist/services/smtp.service.d.ts.map +1 -0
  242. package/dist/services/smtp.service.js +339 -0
  243. package/dist/services/smtp.service.js.map +1 -0
  244. package/dist/services/template.service.d.ts +33 -0
  245. package/dist/services/template.service.d.ts.map +1 -0
  246. package/dist/services/template.service.js +123 -0
  247. package/dist/services/template.service.js.map +1 -0
  248. package/dist/services/verification.service.d.ts +26 -0
  249. package/dist/services/verification.service.d.ts.map +1 -0
  250. package/dist/services/verification.service.js +94 -0
  251. package/dist/services/verification.service.js.map +1 -0
  252. package/dist/services/watcher.service.d.ts +36 -0
  253. package/dist/services/watcher.service.d.ts.map +1 -0
  254. package/dist/services/watcher.service.js +238 -0
  255. package/dist/services/watcher.service.js.map +1 -0
  256. package/dist/tools/accounts.tool.d.ts +7 -0
  257. package/dist/tools/accounts.tool.d.ts.map +1 -0
  258. package/dist/tools/accounts.tool.js +33 -0
  259. package/dist/tools/accounts.tool.js.map +1 -0
  260. package/dist/tools/analytics.tool.d.ts +9 -0
  261. package/dist/tools/analytics.tool.d.ts.map +1 -0
  262. package/dist/tools/analytics.tool.js +32 -0
  263. package/dist/tools/analytics.tool.js.map +1 -0
  264. package/dist/tools/attachments.tool.d.ts +7 -0
  265. package/dist/tools/attachments.tool.d.ts.map +1 -0
  266. package/dist/tools/attachments.tool.js +93 -0
  267. package/dist/tools/attachments.tool.js.map +1 -0
  268. package/dist/tools/bulk.tool.d.ts +7 -0
  269. package/dist/tools/bulk.tool.d.ts.map +1 -0
  270. package/dist/tools/bulk.tool.js +80 -0
  271. package/dist/tools/bulk.tool.js.map +1 -0
  272. package/dist/tools/calendar.tool.d.ts +19 -0
  273. package/dist/tools/calendar.tool.d.ts.map +1 -0
  274. package/dist/tools/calendar.tool.js +576 -0
  275. package/dist/tools/calendar.tool.js.map +1 -0
  276. package/dist/tools/contacts.tool.d.ts +7 -0
  277. package/dist/tools/contacts.tool.d.ts.map +1 -0
  278. package/dist/tools/contacts.tool.js +49 -0
  279. package/dist/tools/contacts.tool.js.map +1 -0
  280. package/dist/tools/drafts.tool.d.ts +8 -0
  281. package/dist/tools/drafts.tool.d.ts.map +1 -0
  282. package/dist/tools/drafts.tool.js +110 -0
  283. package/dist/tools/drafts.tool.js.map +1 -0
  284. package/dist/tools/emails.tool.d.ts +17 -0
  285. package/dist/tools/emails.tool.d.ts.map +1 -0
  286. package/dist/tools/emails.tool.js +508 -0
  287. package/dist/tools/emails.tool.js.map +1 -0
  288. package/dist/tools/folders.tool.d.ts +7 -0
  289. package/dist/tools/folders.tool.d.ts.map +1 -0
  290. package/dist/tools/folders.tool.js +129 -0
  291. package/dist/tools/folders.tool.js.map +1 -0
  292. package/dist/tools/health.tool.d.ts +10 -0
  293. package/dist/tools/health.tool.d.ts.map +1 -0
  294. package/dist/tools/health.tool.js +106 -0
  295. package/dist/tools/health.tool.js.map +1 -0
  296. package/dist/tools/label.tool.d.ts +11 -0
  297. package/dist/tools/label.tool.d.ts.map +1 -0
  298. package/dist/tools/label.tool.js +190 -0
  299. package/dist/tools/label.tool.js.map +1 -0
  300. package/dist/tools/locate.tool.d.ts +11 -0
  301. package/dist/tools/locate.tool.d.ts.map +1 -0
  302. package/dist/tools/locate.tool.js +65 -0
  303. package/dist/tools/locate.tool.js.map +1 -0
  304. package/dist/tools/mailboxes.tool.d.ts +7 -0
  305. package/dist/tools/mailboxes.tool.d.ts.map +1 -0
  306. package/dist/tools/mailboxes.tool.js +49 -0
  307. package/dist/tools/mailboxes.tool.js.map +1 -0
  308. package/dist/tools/manage.tool.d.ts +7 -0
  309. package/dist/tools/manage.tool.d.ts.map +1 -0
  310. package/dist/tools/manage.tool.js +140 -0
  311. package/dist/tools/manage.tool.js.map +1 -0
  312. package/dist/tools/register.d.ts +20 -0
  313. package/dist/tools/register.d.ts.map +1 -0
  314. package/dist/tools/register.js +60 -0
  315. package/dist/tools/register.js.map +1 -0
  316. package/dist/tools/scheduler.tool.d.ts +9 -0
  317. package/dist/tools/scheduler.tool.d.ts.map +1 -0
  318. package/dist/tools/scheduler.tool.js +130 -0
  319. package/dist/tools/scheduler.tool.js.map +1 -0
  320. package/dist/tools/schemas.d.ts +146 -0
  321. package/dist/tools/schemas.d.ts.map +1 -0
  322. package/dist/tools/schemas.js +89 -0
  323. package/dist/tools/schemas.js.map +1 -0
  324. package/dist/tools/security.tool.d.ts +11 -0
  325. package/dist/tools/security.tool.d.ts.map +1 -0
  326. package/dist/tools/security.tool.js +49 -0
  327. package/dist/tools/security.tool.js.map +1 -0
  328. package/dist/tools/send.tool.d.ts +7 -0
  329. package/dist/tools/send.tool.d.ts.map +1 -0
  330. package/dist/tools/send.tool.js +196 -0
  331. package/dist/tools/send.tool.js.map +1 -0
  332. package/dist/tools/templates.tool.d.ts +12 -0
  333. package/dist/tools/templates.tool.d.ts.map +1 -0
  334. package/dist/tools/templates.tool.js +149 -0
  335. package/dist/tools/templates.tool.js.map +1 -0
  336. package/dist/tools/thread.tool.d.ts +10 -0
  337. package/dist/tools/thread.tool.d.ts.map +1 -0
  338. package/dist/tools/thread.tool.js +140 -0
  339. package/dist/tools/thread.tool.js.map +1 -0
  340. package/dist/tools/verification.tool.d.ts +5 -0
  341. package/dist/tools/verification.tool.d.ts.map +1 -0
  342. package/dist/tools/verification.tool.js +125 -0
  343. package/dist/tools/verification.tool.js.map +1 -0
  344. package/dist/tools/watcher.tool.d.ts +19 -0
  345. package/dist/tools/watcher.tool.d.ts.map +1 -0
  346. package/dist/tools/watcher.tool.js +319 -0
  347. package/dist/tools/watcher.tool.js.map +1 -0
  348. package/dist/types/index.d.ts +329 -0
  349. package/dist/types/index.d.ts.map +1 -0
  350. package/dist/types/index.js +5 -0
  351. package/dist/types/index.js.map +1 -0
  352. package/dist/utils/auth-results.d.ts +24 -0
  353. package/dist/utils/auth-results.d.ts.map +1 -0
  354. package/dist/utils/auth-results.js +71 -0
  355. package/dist/utils/auth-results.js.map +1 -0
  356. package/dist/utils/bulk-headers.d.ts +34 -0
  357. package/dist/utils/bulk-headers.d.ts.map +1 -0
  358. package/dist/utils/bulk-headers.js +112 -0
  359. package/dist/utils/bulk-headers.js.map +1 -0
  360. package/dist/utils/calendar-notes.d.ts +31 -0
  361. package/dist/utils/calendar-notes.d.ts.map +1 -0
  362. package/dist/utils/calendar-notes.js +83 -0
  363. package/dist/utils/calendar-notes.js.map +1 -0
  364. package/dist/utils/calendar-state.d.ts +27 -0
  365. package/dist/utils/calendar-state.d.ts.map +1 -0
  366. package/dist/utils/calendar-state.js +85 -0
  367. package/dist/utils/calendar-state.js.map +1 -0
  368. package/dist/utils/conference-details.d.ts +12 -0
  369. package/dist/utils/conference-details.d.ts.map +1 -0
  370. package/dist/utils/conference-details.js +71 -0
  371. package/dist/utils/conference-details.js.map +1 -0
  372. package/dist/utils/html.d.ts +24 -0
  373. package/dist/utils/html.d.ts.map +1 -0
  374. package/dist/utils/html.js +162 -0
  375. package/dist/utils/html.js.map +1 -0
  376. package/dist/utils/imap-client.d.ts +22 -0
  377. package/dist/utils/imap-client.d.ts.map +1 -0
  378. package/dist/utils/imap-client.js +26 -0
  379. package/dist/utils/imap-client.js.map +1 -0
  380. package/dist/utils/imap-error.d.ts +28 -0
  381. package/dist/utils/imap-error.d.ts.map +1 -0
  382. package/dist/utils/imap-error.js +82 -0
  383. package/dist/utils/imap-error.js.map +1 -0
  384. package/dist/utils/meeting-url.d.ts +10 -0
  385. package/dist/utils/meeting-url.d.ts.map +1 -0
  386. package/dist/utils/meeting-url.js +30 -0
  387. package/dist/utils/meeting-url.js.map +1 -0
  388. package/dist/utils/offline-notice.d.ts +10 -0
  389. package/dist/utils/offline-notice.d.ts.map +1 -0
  390. package/dist/utils/offline-notice.js +10 -0
  391. package/dist/utils/offline-notice.js.map +1 -0
  392. package/dist/utils/reply-chain.d.ts +6 -0
  393. package/dist/utils/reply-chain.d.ts.map +1 -0
  394. package/dist/utils/reply-chain.js +15 -0
  395. package/dist/utils/reply-chain.js.map +1 -0
  396. package/dist/utils/verification-code.d.ts +29 -0
  397. package/dist/utils/verification-code.d.ts.map +1 -0
  398. package/dist/utils/verification-code.js +305 -0
  399. package/dist/utils/verification-code.js.map +1 -0
  400. package/dist/utils/verification-link.d.ts +26 -0
  401. package/dist/utils/verification-link.d.ts.map +1 -0
  402. package/dist/utils/verification-link.js +197 -0
  403. package/dist/utils/verification-link.js.map +1 -0
  404. package/package.json +106 -4
@@ -0,0 +1,129 @@
1
+ /**
2
+ * MCP tools: create_mailbox, rename_mailbox, delete_mailbox
3
+ */
4
+ import { z } from 'zod';
5
+ import audit from '../safety/audit.js';
6
+ export default function registerFolderTools(server, imapService) {
7
+ // ---------------------------------------------------------------------------
8
+ // create_mailbox
9
+ // ---------------------------------------------------------------------------
10
+ server.registerTool('create_mailbox', {
11
+ title: 'Create mailbox',
12
+ description: "Create a new mailbox (folder). Use '/' as separator for nested folders (e.g., 'Work/Projects'). Use list_mailboxes to see existing folders.",
13
+ inputSchema: z.object({
14
+ account: z.string().describe('Account name from list_accounts'),
15
+ path: z
16
+ .string()
17
+ .min(1)
18
+ .describe("Folder path to create (e.g., 'Archive/2026' or 'Projects')"),
19
+ }),
20
+ annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true },
21
+ }, async ({ account, path: folderPath }) => {
22
+ try {
23
+ await imapService.createMailbox(account, folderPath);
24
+ await audit.log('create_mailbox', account, { path: folderPath }, 'ok');
25
+ return {
26
+ content: [
27
+ {
28
+ type: 'text',
29
+ text: `📁 Mailbox "${folderPath}" created.`,
30
+ },
31
+ ],
32
+ };
33
+ }
34
+ catch (err) {
35
+ const errMsg = err instanceof Error ? err.message : String(err);
36
+ await audit.log('create_mailbox', account, { path: folderPath }, 'error', errMsg);
37
+ return {
38
+ isError: true,
39
+ content: [
40
+ {
41
+ type: 'text',
42
+ text: `Failed to create mailbox: ${errMsg}`,
43
+ },
44
+ ],
45
+ };
46
+ }
47
+ });
48
+ // ---------------------------------------------------------------------------
49
+ // rename_mailbox
50
+ // ---------------------------------------------------------------------------
51
+ server.registerTool('rename_mailbox', {
52
+ title: 'Rename mailbox',
53
+ description: 'Rename an existing mailbox (folder). Use list_mailboxes to see current folder paths.',
54
+ inputSchema: z.object({
55
+ account: z.string().describe('Account name from list_accounts'),
56
+ path: z.string().min(1).describe('Current folder path'),
57
+ new_path: z.string().min(1).describe('New folder path'),
58
+ }),
59
+ annotations: { readOnlyHint: false, destructiveHint: false },
60
+ }, async ({ account, path: folderPath, new_path: newPath }) => {
61
+ try {
62
+ await imapService.renameMailbox(account, folderPath, newPath);
63
+ await audit.log('rename_mailbox', account, { path: folderPath, new_path: newPath }, 'ok');
64
+ return {
65
+ content: [
66
+ {
67
+ type: 'text',
68
+ text: `📁 Mailbox renamed from "${folderPath}" to "${newPath}".`,
69
+ },
70
+ ],
71
+ };
72
+ }
73
+ catch (err) {
74
+ const errMsg = err instanceof Error ? err.message : String(err);
75
+ await audit.log('rename_mailbox', account, { path: folderPath, new_path: newPath }, 'error', errMsg);
76
+ return {
77
+ isError: true,
78
+ content: [
79
+ {
80
+ type: 'text',
81
+ text: `Failed to rename mailbox: ${errMsg}`,
82
+ },
83
+ ],
84
+ };
85
+ }
86
+ });
87
+ // ---------------------------------------------------------------------------
88
+ // delete_mailbox
89
+ // ---------------------------------------------------------------------------
90
+ server.registerTool('delete_mailbox', {
91
+ title: 'Delete mailbox',
92
+ description: '⚠️ DESTRUCTIVE: Permanently delete a mailbox and ALL its contents. This cannot be undone. Use list_mailboxes to verify the folder path.',
93
+ inputSchema: z.object({
94
+ account: z.string().describe('Account name from list_accounts'),
95
+ path: z
96
+ .string()
97
+ .min(1)
98
+ .describe('Folder path to delete (⚠️ all emails inside will be lost)'),
99
+ }),
100
+ annotations: { readOnlyHint: false, destructiveHint: true },
101
+ }, async ({ account, path: folderPath }) => {
102
+ try {
103
+ await imapService.deleteMailbox(account, folderPath);
104
+ await audit.log('delete_mailbox', account, { path: folderPath }, 'ok');
105
+ return {
106
+ content: [
107
+ {
108
+ type: 'text',
109
+ text: `⚠️ Mailbox "${folderPath}" permanently deleted.`,
110
+ },
111
+ ],
112
+ };
113
+ }
114
+ catch (err) {
115
+ const errMsg = err instanceof Error ? err.message : String(err);
116
+ await audit.log('delete_mailbox', account, { path: folderPath }, 'error', errMsg);
117
+ return {
118
+ isError: true,
119
+ content: [
120
+ {
121
+ type: 'text',
122
+ text: `Failed to delete mailbox: ${errMsg}`,
123
+ },
124
+ ],
125
+ };
126
+ }
127
+ });
128
+ }
129
+ //# sourceMappingURL=folders.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"folders.tool.js","sourceRoot":"","sources":["../../src/tools/folders.tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * MCP Tool: check_health
3
+ *
4
+ * Connection health diagnostics for email accounts.
5
+ */
6
+ import type { McpServer } from '@modelcontextprotocol/server';
7
+ import type ConnectionManager from '../connections/manager.js';
8
+ import type ImapService from '../services/imap.service.js';
9
+ export default function registerHealthTools(server: McpServer, connections: ConnectionManager, imapService: ImapService): void;
10
+ //# sourceMappingURL=health.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"health.tool.d.ts","sourceRoot":"","sources":["../../src/tools/health.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAG9D,OAAO,KAAK,iBAAiB,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,WAAW,MAAM,6BAA6B,CAAC;AAU3D,MAAM,CAAC,OAAO,UAAU,mBAAmB,CACzC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,iBAAiB,EAC9B,WAAW,EAAE,WAAW,GACvB,IAAI,CAuGN"}
@@ -0,0 +1,106 @@
1
+ /**
2
+ * MCP Tool: check_health
3
+ *
4
+ * Connection health diagnostics for email accounts.
5
+ */
6
+ import { z } from 'zod';
7
+ /** How the account actually authenticates, as configured. */
8
+ function authType(cfg) {
9
+ if (cfg.oauth2)
10
+ return 'oauth2';
11
+ if (cfg.passwordCommand)
12
+ return 'password_command';
13
+ return 'password';
14
+ }
15
+ export default function registerHealthTools(server, connections, imapService) {
16
+ server.registerTool('check_health', {
17
+ title: 'Check health',
18
+ description: 'Check connection health, quota, and capabilities for email accounts. Useful for diagnosing issues.',
19
+ inputSchema: z.object({
20
+ account: z.string().optional().describe('Account name (checks all accounts if omitted)'),
21
+ }),
22
+ annotations: { readOnlyHint: true, destructiveHint: false },
23
+ }, async ({ account }) => {
24
+ try {
25
+ const names = account ? [account] : connections.getAccountNames();
26
+ const results = await Promise.all(names.map(async (name) => {
27
+ const cfg = connections.getAccount(name);
28
+ const result = {
29
+ name,
30
+ auth_type: authType(cfg),
31
+ };
32
+ // IMAP health
33
+ try {
34
+ const start = Date.now();
35
+ await connections.getImapClient(name);
36
+ const latency = Date.now() - start;
37
+ const capabilities = await imapService.getCapabilities(name);
38
+ const quota = await imapService.getQuota(name);
39
+ result.imap = {
40
+ connected: true,
41
+ latency_ms: latency,
42
+ host: cfg.imap.host,
43
+ capabilities: capabilities.slice(0, 20),
44
+ tls: cfg.imap.tls,
45
+ };
46
+ if (quota) {
47
+ result.quota = {
48
+ used_mb: quota.usedMb,
49
+ total_mb: quota.totalMb,
50
+ percentage: quota.percentage,
51
+ };
52
+ }
53
+ }
54
+ catch (err) {
55
+ result.imap = {
56
+ connected: false,
57
+ error: err instanceof Error ? err.message : String(err),
58
+ host: cfg.imap.host,
59
+ };
60
+ }
61
+ // SMTP health
62
+ try {
63
+ const start = Date.now();
64
+ await connections.verifySmtpTransport(name);
65
+ const latency = Date.now() - start;
66
+ result.smtp = {
67
+ connected: true,
68
+ latency_ms: latency,
69
+ host: cfg.smtp.host,
70
+ tls: cfg.smtp.tls,
71
+ };
72
+ }
73
+ catch (err) {
74
+ result.smtp = {
75
+ connected: false,
76
+ error: err instanceof Error ? err.message : String(err),
77
+ host: cfg.smtp.host,
78
+ };
79
+ }
80
+ return result;
81
+ }));
82
+ return {
83
+ content: [
84
+ {
85
+ type: 'text',
86
+ text: JSON.stringify({ accounts: results }, null, 2),
87
+ },
88
+ ],
89
+ };
90
+ }
91
+ catch (err) {
92
+ return {
93
+ content: [
94
+ {
95
+ type: 'text',
96
+ text: JSON.stringify({
97
+ error: err instanceof Error ? err.message : String(err),
98
+ }),
99
+ },
100
+ ],
101
+ isError: true,
102
+ };
103
+ }
104
+ });
105
+ }
106
+ //# sourceMappingURL=health.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"health.tool.js","sourceRoot":"","sources":["../../src/tools/health.tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ /**
2
+ * MCP tools: list_labels, add_label, remove_label, create_label, delete_label
3
+ *
4
+ * Provider-aware label management. Automatically detects whether the account
5
+ * uses ProtonMail (folder-based labels), Gmail (X-GM-LABELS), or standard
6
+ * IMAP keywords, and applies the correct strategy.
7
+ */
8
+ import type { McpServer } from '@modelcontextprotocol/server';
9
+ import type ImapService from '../services/imap.service.js';
10
+ export default function registerLabelTools(server: McpServer, imapService: ImapService): void;
11
+ //# sourceMappingURL=label.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"label.tool.d.ts","sourceRoot":"","sources":["../../src/tools/label.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAK9D,OAAO,KAAK,WAAW,MAAM,6BAA6B,CAAC;AAE3D,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,CA6M5F"}
@@ -0,0 +1,190 @@
1
+ /**
2
+ * MCP tools: list_labels, add_label, remove_label, create_label, delete_label
3
+ *
4
+ * Provider-aware label management. Automatically detects whether the account
5
+ * uses ProtonMail (folder-based labels), Gmail (X-GM-LABELS), or standard
6
+ * IMAP keywords, and applies the correct strategy.
7
+ */
8
+ import { z } from 'zod';
9
+ import audit from '../safety/audit.js';
10
+ import { validateLabelName } from '../safety/validation.js';
11
+ export default function registerLabelTools(server, imapService) {
12
+ // ---------------------------------------------------------------------------
13
+ // list_labels
14
+ // ---------------------------------------------------------------------------
15
+ server.registerTool('list_labels', {
16
+ title: 'List labels',
17
+ description: 'List available labels for an email account. ' +
18
+ 'Auto-detects the label system: ProtonMail folder-labels, Gmail X-GM-LABELS, or IMAP keywords. ' +
19
+ 'ProtonMail note: labels are represented as IMAP folders under the Labels/ prefix. ' +
20
+ 'Use list_emails with mailbox="Labels/<name>" to find emails tagged with a ProtonMail label.',
21
+ inputSchema: z.object({
22
+ account: z.string().describe('Account name from list_accounts'),
23
+ }),
24
+ annotations: { readOnlyHint: true },
25
+ }, async ({ account }) => {
26
+ try {
27
+ const labels = await imapService.listLabels(account);
28
+ if (labels.length === 0) {
29
+ return {
30
+ content: [
31
+ {
32
+ type: 'text',
33
+ text: 'No labels found. Use create_label to create one.',
34
+ },
35
+ ],
36
+ };
37
+ }
38
+ const { strategy } = labels[0];
39
+ const lines = [
40
+ `🏷️ ${labels.length} label(s) — strategy: ${strategy}`,
41
+ '',
42
+ ...labels.map((l) => ` • ${l.name}${l.path ? ` (${l.path})` : ''}`),
43
+ ];
44
+ return {
45
+ content: [{ type: 'text', text: lines.join('\n') }],
46
+ };
47
+ }
48
+ catch (err) {
49
+ const errMsg = err instanceof Error ? err.message : String(err);
50
+ return {
51
+ isError: true,
52
+ content: [{ type: 'text', text: `Failed to list labels: ${errMsg}` }],
53
+ };
54
+ }
55
+ });
56
+ // ---------------------------------------------------------------------------
57
+ // add_label
58
+ // ---------------------------------------------------------------------------
59
+ server.registerTool('add_label', {
60
+ title: 'Add label',
61
+ description: 'Add a label to an email. ' +
62
+ 'For ProtonMail, this copies the email into the corresponding Labels/<name> folder. ' +
63
+ 'For Gmail and standard IMAP, this sets a keyword flag on the message.',
64
+ inputSchema: z.object({
65
+ account: z.string().describe('Account name from list_accounts'),
66
+ emailId: z.string().describe('Email ID (UID) from list_emails'),
67
+ mailbox: z.string().describe('Mailbox containing the email (must be a real folder)'),
68
+ label: z.string().describe('Label name to add (e.g., "Important", "Project-X")'),
69
+ }),
70
+ annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true },
71
+ }, async ({ account, emailId, mailbox, label }) => {
72
+ try {
73
+ const cleanLabel = validateLabelName(label);
74
+ await imapService.addLabel(account, emailId, mailbox, cleanLabel);
75
+ await audit.log('add_label', account, { emailId, mailbox, label: cleanLabel }, 'ok');
76
+ return {
77
+ content: [
78
+ { type: 'text', text: `🏷️ Label "${label}" added to email ${emailId}.` },
79
+ ],
80
+ };
81
+ }
82
+ catch (err) {
83
+ const errMsg = err instanceof Error ? err.message : String(err);
84
+ await audit.log('add_label', account, { emailId, mailbox, label }, 'error', errMsg);
85
+ return {
86
+ isError: true,
87
+ content: [{ type: 'text', text: `Failed to add label: ${errMsg}` }],
88
+ };
89
+ }
90
+ });
91
+ // ---------------------------------------------------------------------------
92
+ // remove_label
93
+ // ---------------------------------------------------------------------------
94
+ server.registerTool('remove_label', {
95
+ title: 'Remove label',
96
+ description: 'Remove a label from an email. For ProtonMail, this removes the email from the label folder. ' +
97
+ 'For Gmail and standard IMAP, this removes a keyword flag.',
98
+ inputSchema: z.object({
99
+ account: z.string().describe('Account name from list_accounts'),
100
+ emailId: z.string().describe('Email ID (UID) from list_emails'),
101
+ mailbox: z.string().describe('Mailbox containing the email (must be a real folder)'),
102
+ label: z.string().describe('Label name to remove'),
103
+ }),
104
+ annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true },
105
+ }, async ({ account, emailId, mailbox, label }) => {
106
+ try {
107
+ const cleanLabel = validateLabelName(label);
108
+ await imapService.removeLabel(account, emailId, mailbox, cleanLabel);
109
+ await audit.log('remove_label', account, { emailId, mailbox, label: cleanLabel }, 'ok');
110
+ return {
111
+ content: [
112
+ {
113
+ type: 'text',
114
+ text: `🏷️ Label "${label}" removed from email ${emailId}.`,
115
+ },
116
+ ],
117
+ };
118
+ }
119
+ catch (err) {
120
+ const errMsg = err instanceof Error ? err.message : String(err);
121
+ await audit.log('remove_label', account, { emailId, mailbox, label }, 'error', errMsg);
122
+ return {
123
+ isError: true,
124
+ content: [{ type: 'text', text: `Failed to remove label: ${errMsg}` }],
125
+ };
126
+ }
127
+ });
128
+ // ---------------------------------------------------------------------------
129
+ // create_label
130
+ // ---------------------------------------------------------------------------
131
+ server.registerTool('create_label', {
132
+ title: 'Create label',
133
+ description: 'Create a new label. For ProtonMail, creates a folder under Labels/. ' +
134
+ 'For standard IMAP keywords, labels are auto-created on first use — this is a no-op.',
135
+ inputSchema: z.object({
136
+ account: z.string().describe('Account name from list_accounts'),
137
+ name: z
138
+ .string()
139
+ .describe('Label name (e.g., "Project-X"). For nested labels use "/" separator (e.g., "Work/Urgent").'),
140
+ }),
141
+ annotations: { readOnlyHint: false, destructiveHint: false },
142
+ }, async ({ account, name }) => {
143
+ try {
144
+ const cleanName = validateLabelName(name);
145
+ await imapService.createLabel(account, cleanName);
146
+ await audit.log('create_label', account, { name: cleanName }, 'ok');
147
+ return {
148
+ content: [{ type: 'text', text: `🏷️ Label "${name}" created.` }],
149
+ };
150
+ }
151
+ catch (err) {
152
+ const errMsg = err instanceof Error ? err.message : String(err);
153
+ await audit.log('create_label', account, { name }, 'error', errMsg);
154
+ return {
155
+ isError: true,
156
+ content: [{ type: 'text', text: `Failed to create label: ${errMsg}` }],
157
+ };
158
+ }
159
+ });
160
+ // ---------------------------------------------------------------------------
161
+ // delete_label
162
+ // ---------------------------------------------------------------------------
163
+ server.registerTool('delete_label', {
164
+ title: 'Delete label',
165
+ description: 'Delete a label. For ProtonMail, deletes the label folder. ' +
166
+ 'For standard IMAP keywords, labels cannot be deleted server-wide — use remove_label on individual emails.',
167
+ inputSchema: z.object({
168
+ account: z.string().describe('Account name from list_accounts'),
169
+ name: z.string().describe('Label name to delete'),
170
+ }),
171
+ annotations: { readOnlyHint: false, destructiveHint: true },
172
+ }, async ({ account, name }) => {
173
+ try {
174
+ await imapService.deleteLabel(account, name);
175
+ await audit.log('delete_label', account, { name }, 'ok');
176
+ return {
177
+ content: [{ type: 'text', text: `🏷️ Label "${name}" deleted.` }],
178
+ };
179
+ }
180
+ catch (err) {
181
+ const errMsg = err instanceof Error ? err.message : String(err);
182
+ await audit.log('delete_label', account, { name }, 'error', errMsg);
183
+ return {
184
+ isError: true,
185
+ content: [{ type: 'text', text: `Failed to delete label: ${errMsg}` }],
186
+ };
187
+ }
188
+ });
189
+ }
190
+ //# sourceMappingURL=label.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"label.tool.js","sourceRoot":"","sources":["../../src/tools/label.tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ /**
2
+ * MCP tool: find_email_folder
3
+ *
4
+ * Locates the real mailbox folder(s) containing an email.
5
+ * Essential when working with virtual folders like "All Mail" or "Starred",
6
+ * which don't support IMAP MOVE operations.
7
+ */
8
+ import type { McpServer } from '@modelcontextprotocol/server';
9
+ import type ImapService from '../services/imap.service.js';
10
+ export default function registerLocateTools(server: McpServer, imapService: ImapService): void;
11
+ //# sourceMappingURL=locate.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"locate.tool.d.ts","sourceRoot":"","sources":["../../src/tools/locate.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAG9D,OAAO,KAAK,WAAW,MAAM,6BAA6B,CAAC;AAE3D,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,CAkE7F"}
@@ -0,0 +1,65 @@
1
+ /**
2
+ * MCP tool: find_email_folder
3
+ *
4
+ * Locates the real mailbox folder(s) containing an email.
5
+ * Essential when working with virtual folders like "All Mail" or "Starred",
6
+ * which don't support IMAP MOVE operations.
7
+ */
8
+ import { z } from 'zod';
9
+ export default function registerLocateTools(server, imapService) {
10
+ server.registerTool('find_email_folder', {
11
+ title: 'Find email folder',
12
+ description: 'Find a real mailbox folder an email belongs to. ' +
13
+ 'Required before move_email or delete_email when the email was found in a virtual folder ' +
14
+ '(e.g., "All Mail", "Starred"). Returns the first real folder path found, to use as ' +
15
+ 'sourceMailbox; on a label-based server a message may also sit in other folders.',
16
+ inputSchema: z.object({
17
+ account: z.string().describe('Account name from list_accounts'),
18
+ emailId: z.string().describe('Email ID (UID) from list_emails'),
19
+ sourceMailbox: z
20
+ .string()
21
+ .default('INBOX')
22
+ .describe('Mailbox where the email is currently visible (e.g., "All Mail")'),
23
+ }),
24
+ annotations: { readOnlyHint: true },
25
+ }, async ({ account, emailId, sourceMailbox }) => {
26
+ try {
27
+ const { folders, messageId } = await imapService.findEmailFolder(account, emailId, sourceMailbox);
28
+ if (folders.length === 0) {
29
+ return {
30
+ content: [
31
+ {
32
+ type: 'text',
33
+ text: `No real folder found for email ${emailId}. It may only exist in virtual folders.`,
34
+ },
35
+ ],
36
+ };
37
+ }
38
+ const lines = [
39
+ `📁 Email ${emailId} found in:`,
40
+ ...folders.map((f) => ` • ${f}`),
41
+ '',
42
+ `Use this as sourceMailbox for move_email or delete_email.`,
43
+ ];
44
+ if (messageId) {
45
+ lines.push(`Message-ID: ${messageId}`);
46
+ }
47
+ return {
48
+ content: [{ type: 'text', text: lines.join('\n') }],
49
+ };
50
+ }
51
+ catch (err) {
52
+ const errMsg = err instanceof Error ? err.message : String(err);
53
+ return {
54
+ isError: true,
55
+ content: [
56
+ {
57
+ type: 'text',
58
+ text: `Failed to locate email: ${errMsg}`,
59
+ },
60
+ ],
61
+ };
62
+ }
63
+ });
64
+ }
65
+ //# sourceMappingURL=locate.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"locate.tool.js","sourceRoot":"","sources":["../../src/tools/locate.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,MAAiB,EAAE,WAAwB;IACrF,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,kDAAkD;YAClD,0FAA0F;YAC1F,qFAAqF;YACrF,iFAAiF;QACnF,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;YAC/D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;YAC/D,aAAa,EAAE,CAAC;iBACb,MAAM,EAAE;iBACR,OAAO,CAAC,OAAO,CAAC;iBAChB,QAAQ,CAAC,iEAAiE,CAAC;SAC/E,CAAC;QACF,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE;QAC5C,IAAI,CAAC;YACH,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,WAAW,CAAC,eAAe,CAC9D,OAAO,EACP,OAAO,EACP,aAAa,CACd,CAAC;YAEF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,kCAAkC,OAAO,yCAAyC;yBACzF;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG;gBACZ,YAAY,OAAO,YAAY;gBAC/B,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;gBACjC,EAAE;gBACF,2DAA2D;aAC5D,CAAC;YACF,IAAI,SAAS,EAAE,CAAC;gBACd,KAAK,CAAC,IAAI,CAAC,eAAe,SAAS,EAAE,CAAC,CAAC;YACzC,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;aAC7D,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAChE,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,2BAA2B,MAAM,EAAE;qBAC1C;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * MCP tool: list_mailboxes
3
+ */
4
+ import type { McpServer } from '@modelcontextprotocol/server';
5
+ import type ImapService from '../services/imap.service.js';
6
+ export default function registerMailboxesTools(server: McpServer, imapService: ImapService): void;
7
+ //# sourceMappingURL=mailboxes.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mailboxes.tool.d.ts","sourceRoot":"","sources":["../../src/tools/mailboxes.tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAG9D,OAAO,KAAK,WAAW,MAAM,6BAA6B,CAAC;AAG3D,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,CAgDhG"}
@@ -0,0 +1,49 @@
1
+ /**
2
+ * MCP tool: list_mailboxes
3
+ */
4
+ import { z } from 'zod';
5
+ import { mailboxListOutputSchema } from './schemas.js';
6
+ export default function registerMailboxesTools(server, imapService) {
7
+ server.registerTool('list_mailboxes', {
8
+ title: 'List mailboxes',
9
+ description: 'List all mailbox folders for an account with unread counts and special-use flags. Use list_accounts first to get the account name.',
10
+ inputSchema: z.object({
11
+ account: z.string().describe('Account name from list_accounts'),
12
+ }),
13
+ outputSchema: mailboxListOutputSchema,
14
+ annotations: { readOnlyHint: true, destructiveHint: false },
15
+ }, async ({ account }) => {
16
+ try {
17
+ const mailboxes = await imapService.listMailboxes(account);
18
+ const lines = mailboxes.map((mb) => {
19
+ const special = mb.specialUse ? ` [${mb.specialUse}]` : '';
20
+ if (mb.totalMessages === undefined) {
21
+ return `• ${mb.path}${special} — counts unavailable`;
22
+ }
23
+ const badge = mb.unseenMessages ? ` (${mb.unseenMessages} unread)` : '';
24
+ return `• ${mb.path}${special} — ${mb.totalMessages} messages${badge}`;
25
+ });
26
+ return {
27
+ content: [
28
+ {
29
+ type: 'text',
30
+ text: lines.join('\n') || 'No mailboxes found.',
31
+ },
32
+ ],
33
+ structuredContent: { account, count: mailboxes.length, mailboxes },
34
+ };
35
+ }
36
+ catch (err) {
37
+ return {
38
+ isError: true,
39
+ content: [
40
+ {
41
+ type: 'text',
42
+ text: `Failed to list mailboxes: ${err instanceof Error ? err.message : String(err)}`,
43
+ },
44
+ ],
45
+ };
46
+ }
47
+ });
48
+ }
49
+ //# sourceMappingURL=mailboxes.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mailboxes.tool.js","sourceRoot":"","sources":["../../src/tools/mailboxes.tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEvD,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAAC,MAAiB,EAAE,WAAwB;IACxF,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EACT,oIAAoI;QACtI,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;SAChE,CAAC;QACF,YAAY,EAAE,uBAAuB;QACrC,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE;KAC5D,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACpB,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAE3D,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;gBACjC,MAAM,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3D,IAAI,EAAE,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;oBACnC,OAAO,KAAK,EAAE,CAAC,IAAI,GAAG,OAAO,uBAAuB,CAAC;gBACvD,CAAC;gBACD,MAAM,KAAK,GAAG,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,cAAc,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxE,OAAO,KAAK,EAAE,CAAC,IAAI,GAAG,OAAO,MAAM,EAAE,CAAC,aAAa,YAAY,KAAK,EAAE,CAAC;YACzE,CAAC,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,qBAAqB;qBAChD;iBACF;gBACD,iBAAiB,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE;aACnE,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,6BAA6B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;qBACtF;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}