@agenticmail/enterprise 0.5.327 → 0.5.328

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 (866) hide show
  1. package/dist/dashboard/app.js +1 -1
  2. package/logs/cloudflared-error.log +6 -0
  3. package/logs/enterprise-out.log +1 -0
  4. package/package.json +1 -1
  5. package/src/admin/page-registry.ts +0 -290
  6. package/src/admin/routes.ts +0 -2968
  7. package/src/agent-tools/common.ts +0 -260
  8. package/src/agent-tools/index.ts +0 -542
  9. package/src/agent-tools/merge.ts +0 -62
  10. package/src/agent-tools/middleware.ts +0 -436
  11. package/src/agent-tools/schema/typebox.ts +0 -25
  12. package/src/agent-tools/security.ts +0 -352
  13. package/src/agent-tools/tool-resolver.ts +0 -1018
  14. package/src/agent-tools/tools/agenticmail.ts +0 -1017
  15. package/src/agent-tools/tools/bash.ts +0 -179
  16. package/src/agent-tools/tools/browser-tool.schema.ts +0 -112
  17. package/src/agent-tools/tools/browser-tool.ts +0 -388
  18. package/src/agent-tools/tools/browser.ts +0 -764
  19. package/src/agent-tools/tools/edit.ts +0 -100
  20. package/src/agent-tools/tools/enterprise-code-sandbox.ts +0 -395
  21. package/src/agent-tools/tools/enterprise-database.ts +0 -377
  22. package/src/agent-tools/tools/enterprise-diff.ts +0 -580
  23. package/src/agent-tools/tools/enterprise-documents.ts +0 -896
  24. package/src/agent-tools/tools/enterprise-http.ts +0 -485
  25. package/src/agent-tools/tools/enterprise-security-scan.ts +0 -528
  26. package/src/agent-tools/tools/enterprise-spreadsheet.ts +0 -825
  27. package/src/agent-tools/tools/glob.ts +0 -129
  28. package/src/agent-tools/tools/google/calendar.ts +0 -230
  29. package/src/agent-tools/tools/google/chat.ts +0 -725
  30. package/src/agent-tools/tools/google/contacts.ts +0 -209
  31. package/src/agent-tools/tools/google/docs.ts +0 -162
  32. package/src/agent-tools/tools/google/drive.ts +0 -392
  33. package/src/agent-tools/tools/google/forms.ts +0 -367
  34. package/src/agent-tools/tools/google/gmail.ts +0 -897
  35. package/src/agent-tools/tools/google/index.ts +0 -86
  36. package/src/agent-tools/tools/google/maps.ts +0 -543
  37. package/src/agent-tools/tools/google/meeting-voice.ts +0 -885
  38. package/src/agent-tools/tools/google/meetings.ts +0 -1094
  39. package/src/agent-tools/tools/google/sheets.ts +0 -215
  40. package/src/agent-tools/tools/google/slides.ts +0 -559
  41. package/src/agent-tools/tools/google/tasks.ts +0 -200
  42. package/src/agent-tools/tools/grep.ts +0 -178
  43. package/src/agent-tools/tools/integrations/_factory.ts +0 -102
  44. package/src/agent-tools/tools/integrations/activecampaign.ts +0 -14
  45. package/src/agent-tools/tools/integrations/adobe-sign.ts +0 -14
  46. package/src/agent-tools/tools/integrations/adp.ts +0 -14
  47. package/src/agent-tools/tools/integrations/airtable.ts +0 -14
  48. package/src/agent-tools/tools/integrations/apollo.ts +0 -14
  49. package/src/agent-tools/tools/integrations/asana.ts +0 -14
  50. package/src/agent-tools/tools/integrations/auth0.ts +0 -14
  51. package/src/agent-tools/tools/integrations/aws.ts +0 -14
  52. package/src/agent-tools/tools/integrations/azure-devops.ts +0 -14
  53. package/src/agent-tools/tools/integrations/bamboohr.ts +0 -14
  54. package/src/agent-tools/tools/integrations/basecamp.ts +0 -14
  55. package/src/agent-tools/tools/integrations/bigcommerce.ts +0 -14
  56. package/src/agent-tools/tools/integrations/bitbucket.ts +0 -14
  57. package/src/agent-tools/tools/integrations/box.ts +0 -14
  58. package/src/agent-tools/tools/integrations/brex.ts +0 -14
  59. package/src/agent-tools/tools/integrations/buffer.ts +0 -14
  60. package/src/agent-tools/tools/integrations/calendly.ts +0 -14
  61. package/src/agent-tools/tools/integrations/canva.ts +0 -14
  62. package/src/agent-tools/tools/integrations/chargebee.ts +0 -14
  63. package/src/agent-tools/tools/integrations/circleci.ts +0 -14
  64. package/src/agent-tools/tools/integrations/clickup.ts +0 -14
  65. package/src/agent-tools/tools/integrations/close.ts +0 -14
  66. package/src/agent-tools/tools/integrations/cloudflare.ts +0 -14
  67. package/src/agent-tools/tools/integrations/confluence.ts +0 -14
  68. package/src/agent-tools/tools/integrations/contentful.ts +0 -14
  69. package/src/agent-tools/tools/integrations/copper.ts +0 -14
  70. package/src/agent-tools/tools/integrations/crisp.ts +0 -14
  71. package/src/agent-tools/tools/integrations/crowdstrike.ts +0 -14
  72. package/src/agent-tools/tools/integrations/datadog.ts +0 -14
  73. package/src/agent-tools/tools/integrations/digitalocean.ts +0 -14
  74. package/src/agent-tools/tools/integrations/discord.ts +0 -14
  75. package/src/agent-tools/tools/integrations/docker.ts +0 -14
  76. package/src/agent-tools/tools/integrations/docusign.ts +0 -14
  77. package/src/agent-tools/tools/integrations/drift.ts +0 -14
  78. package/src/agent-tools/tools/integrations/dropbox.ts +0 -14
  79. package/src/agent-tools/tools/integrations/figma.ts +0 -14
  80. package/src/agent-tools/tools/integrations/firebase.ts +0 -14
  81. package/src/agent-tools/tools/integrations/flyio.ts +0 -14
  82. package/src/agent-tools/tools/integrations/freshbooks.ts +0 -14
  83. package/src/agent-tools/tools/integrations/freshdesk.ts +0 -14
  84. package/src/agent-tools/tools/integrations/freshsales.ts +0 -14
  85. package/src/agent-tools/tools/integrations/freshservice.ts +0 -14
  86. package/src/agent-tools/tools/integrations/front.ts +0 -14
  87. package/src/agent-tools/tools/integrations/github-actions.ts +0 -14
  88. package/src/agent-tools/tools/integrations/github.ts +0 -14
  89. package/src/agent-tools/tools/integrations/gitlab.ts +0 -14
  90. package/src/agent-tools/tools/integrations/gong.ts +0 -14
  91. package/src/agent-tools/tools/integrations/google-ads.ts +0 -14
  92. package/src/agent-tools/tools/integrations/google-analytics.ts +0 -14
  93. package/src/agent-tools/tools/integrations/google-cloud.ts +0 -14
  94. package/src/agent-tools/tools/integrations/gotomeeting.ts +0 -14
  95. package/src/agent-tools/tools/integrations/grafana.ts +0 -14
  96. package/src/agent-tools/tools/integrations/greenhouse.ts +0 -14
  97. package/src/agent-tools/tools/integrations/gusto.ts +0 -14
  98. package/src/agent-tools/tools/integrations/hashicorp-vault.ts +0 -14
  99. package/src/agent-tools/tools/integrations/heroku.ts +0 -14
  100. package/src/agent-tools/tools/integrations/hibob.ts +0 -14
  101. package/src/agent-tools/tools/integrations/hootsuite.ts +0 -14
  102. package/src/agent-tools/tools/integrations/hubspot.ts +0 -14
  103. package/src/agent-tools/tools/integrations/huggingface.ts +0 -14
  104. package/src/agent-tools/tools/integrations/index.ts +0 -474
  105. package/src/agent-tools/tools/integrations/intercom.ts +0 -14
  106. package/src/agent-tools/tools/integrations/jira.ts +0 -14
  107. package/src/agent-tools/tools/integrations/klaviyo.ts +0 -14
  108. package/src/agent-tools/tools/integrations/kubernetes.ts +0 -14
  109. package/src/agent-tools/tools/integrations/lattice.ts +0 -14
  110. package/src/agent-tools/tools/integrations/launchdarkly.ts +0 -14
  111. package/src/agent-tools/tools/integrations/lever.ts +0 -14
  112. package/src/agent-tools/tools/integrations/linear.ts +0 -14
  113. package/src/agent-tools/tools/integrations/linkedin.ts +0 -14
  114. package/src/agent-tools/tools/integrations/livechat.ts +0 -14
  115. package/src/agent-tools/tools/integrations/loom.ts +0 -14
  116. package/src/agent-tools/tools/integrations/mailchimp.ts +0 -14
  117. package/src/agent-tools/tools/integrations/mailgun.ts +0 -14
  118. package/src/agent-tools/tools/integrations/miro.ts +0 -14
  119. package/src/agent-tools/tools/integrations/mixpanel.ts +0 -14
  120. package/src/agent-tools/tools/integrations/monday.ts +0 -14
  121. package/src/agent-tools/tools/integrations/mongodb-atlas.ts +0 -14
  122. package/src/agent-tools/tools/integrations/neon.ts +0 -14
  123. package/src/agent-tools/tools/integrations/netlify.ts +0 -14
  124. package/src/agent-tools/tools/integrations/netsuite.ts +0 -14
  125. package/src/agent-tools/tools/integrations/newrelic.ts +0 -14
  126. package/src/agent-tools/tools/integrations/notion.ts +0 -14
  127. package/src/agent-tools/tools/integrations/okta.ts +0 -14
  128. package/src/agent-tools/tools/integrations/openai.ts +0 -14
  129. package/src/agent-tools/tools/integrations/opsgenie.ts +0 -14
  130. package/src/agent-tools/tools/integrations/outreach.ts +0 -14
  131. package/src/agent-tools/tools/integrations/paddle.ts +0 -14
  132. package/src/agent-tools/tools/integrations/pagerduty.ts +0 -14
  133. package/src/agent-tools/tools/integrations/pandadoc.ts +0 -14
  134. package/src/agent-tools/tools/integrations/paypal.ts +0 -14
  135. package/src/agent-tools/tools/integrations/personio.ts +0 -14
  136. package/src/agent-tools/tools/integrations/pinecone.ts +0 -14
  137. package/src/agent-tools/tools/integrations/pipedrive.ts +0 -14
  138. package/src/agent-tools/tools/integrations/plaid.ts +0 -14
  139. package/src/agent-tools/tools/integrations/postmark.ts +0 -14
  140. package/src/agent-tools/tools/integrations/power-automate.ts +0 -14
  141. package/src/agent-tools/tools/integrations/quickbooks.ts +0 -14
  142. package/src/agent-tools/tools/integrations/recurly.ts +0 -14
  143. package/src/agent-tools/tools/integrations/reddit.ts +0 -14
  144. package/src/agent-tools/tools/integrations/render.ts +0 -14
  145. package/src/agent-tools/tools/integrations/ringcentral.ts +0 -14
  146. package/src/agent-tools/tools/integrations/rippling.ts +0 -14
  147. package/src/agent-tools/tools/integrations/salesforce.ts +0 -14
  148. package/src/agent-tools/tools/integrations/salesloft.ts +0 -14
  149. package/src/agent-tools/tools/integrations/sanity.ts +0 -14
  150. package/src/agent-tools/tools/integrations/sap.ts +0 -14
  151. package/src/agent-tools/tools/integrations/segment.ts +0 -14
  152. package/src/agent-tools/tools/integrations/sendgrid.ts +0 -14
  153. package/src/agent-tools/tools/integrations/sentry.ts +0 -14
  154. package/src/agent-tools/tools/integrations/servicenow.ts +0 -14
  155. package/src/agent-tools/tools/integrations/shopify.ts +0 -14
  156. package/src/agent-tools/tools/integrations/shortcut.ts +0 -14
  157. package/src/agent-tools/tools/integrations/slack.ts +0 -14
  158. package/src/agent-tools/tools/integrations/smartsheet.ts +0 -14
  159. package/src/agent-tools/tools/integrations/snowflake.ts +0 -14
  160. package/src/agent-tools/tools/integrations/snyk.ts +0 -14
  161. package/src/agent-tools/tools/integrations/splunk.ts +0 -14
  162. package/src/agent-tools/tools/integrations/square.ts +0 -14
  163. package/src/agent-tools/tools/integrations/statuspage.ts +0 -14
  164. package/src/agent-tools/tools/integrations/stripe.ts +0 -14
  165. package/src/agent-tools/tools/integrations/supabase.ts +0 -14
  166. package/src/agent-tools/tools/integrations/teamwork.ts +0 -14
  167. package/src/agent-tools/tools/integrations/telegram.ts +0 -14
  168. package/src/agent-tools/tools/integrations/terraform.ts +0 -14
  169. package/src/agent-tools/tools/integrations/todoist.ts +0 -14
  170. package/src/agent-tools/tools/integrations/trello.ts +0 -14
  171. package/src/agent-tools/tools/integrations/twilio.ts +0 -14
  172. package/src/agent-tools/tools/integrations/twitter.ts +0 -14
  173. package/src/agent-tools/tools/integrations/vercel.ts +0 -14
  174. package/src/agent-tools/tools/integrations/weaviate.ts +0 -14
  175. package/src/agent-tools/tools/integrations/webex.ts +0 -14
  176. package/src/agent-tools/tools/integrations/webflow.ts +0 -14
  177. package/src/agent-tools/tools/integrations/whatsapp.ts +0 -14
  178. package/src/agent-tools/tools/integrations/whereby.ts +0 -14
  179. package/src/agent-tools/tools/integrations/woocommerce.ts +0 -14
  180. package/src/agent-tools/tools/integrations/wordpress.ts +0 -14
  181. package/src/agent-tools/tools/integrations/workday.ts +0 -14
  182. package/src/agent-tools/tools/integrations/wrike.ts +0 -14
  183. package/src/agent-tools/tools/integrations/xero.ts +0 -14
  184. package/src/agent-tools/tools/integrations/youtube.ts +0 -14
  185. package/src/agent-tools/tools/integrations/zendesk.ts +0 -14
  186. package/src/agent-tools/tools/integrations/zoho-crm.ts +0 -14
  187. package/src/agent-tools/tools/integrations/zoom.ts +0 -14
  188. package/src/agent-tools/tools/integrations/zuora.ts +0 -14
  189. package/src/agent-tools/tools/knowledge-search.ts +0 -318
  190. package/src/agent-tools/tools/local/coding.ts +0 -626
  191. package/src/agent-tools/tools/local/dependency-manager.ts +0 -647
  192. package/src/agent-tools/tools/local/file-edit.ts +0 -31
  193. package/src/agent-tools/tools/local/file-list.ts +0 -39
  194. package/src/agent-tools/tools/local/file-ops.ts +0 -48
  195. package/src/agent-tools/tools/local/file-read.ts +0 -39
  196. package/src/agent-tools/tools/local/file-search.ts +0 -46
  197. package/src/agent-tools/tools/local/file-write.ts +0 -28
  198. package/src/agent-tools/tools/local/filesystem.ts +0 -5
  199. package/src/agent-tools/tools/local/index.ts +0 -55
  200. package/src/agent-tools/tools/local/resolve-path.ts +0 -18
  201. package/src/agent-tools/tools/local/shell.ts +0 -277
  202. package/src/agent-tools/tools/local/system-info.ts +0 -29
  203. package/src/agent-tools/tools/management.ts +0 -425
  204. package/src/agent-tools/tools/mcp-bridge.ts +0 -142
  205. package/src/agent-tools/tools/mcp-server-tools.ts +0 -91
  206. package/src/agent-tools/tools/meeting-lifecycle.ts +0 -438
  207. package/src/agent-tools/tools/memory.ts +0 -509
  208. package/src/agent-tools/tools/messaging/index.ts +0 -6
  209. package/src/agent-tools/tools/messaging/telegram.ts +0 -167
  210. package/src/agent-tools/tools/messaging/whatsapp.ts +0 -651
  211. package/src/agent-tools/tools/microsoft/contacts.ts +0 -176
  212. package/src/agent-tools/tools/microsoft/excel-vba.ts +0 -331
  213. package/src/agent-tools/tools/microsoft/excel.ts +0 -261
  214. package/src/agent-tools/tools/microsoft/graph-api.ts +0 -161
  215. package/src/agent-tools/tools/microsoft/index.ts +0 -95
  216. package/src/agent-tools/tools/microsoft/onedrive.ts +0 -429
  217. package/src/agent-tools/tools/microsoft/onenote.ts +0 -186
  218. package/src/agent-tools/tools/microsoft/outlook-calendar.ts +0 -286
  219. package/src/agent-tools/tools/microsoft/outlook-mail.ts +0 -723
  220. package/src/agent-tools/tools/microsoft/planner.ts +0 -200
  221. package/src/agent-tools/tools/microsoft/powerbi.ts +0 -266
  222. package/src/agent-tools/tools/microsoft/powerpoint.ts +0 -186
  223. package/src/agent-tools/tools/microsoft/sharepoint.ts +0 -328
  224. package/src/agent-tools/tools/microsoft/teams.ts +0 -463
  225. package/src/agent-tools/tools/microsoft/todo.ts +0 -181
  226. package/src/agent-tools/tools/oauth-token-provider.ts +0 -101
  227. package/src/agent-tools/tools/read.ts +0 -160
  228. package/src/agent-tools/tools/visual-memory/capture.ts +0 -217
  229. package/src/agent-tools/tools/visual-memory/diff.ts +0 -283
  230. package/src/agent-tools/tools/visual-memory/index.ts +0 -698
  231. package/src/agent-tools/tools/visual-memory/phash.ts +0 -120
  232. package/src/agent-tools/tools/visual-memory/similarity.ts +0 -354
  233. package/src/agent-tools/tools/visual-memory/storage.ts +0 -534
  234. package/src/agent-tools/tools/visual-memory/types.ts +0 -100
  235. package/src/agent-tools/tools/web-fetch-utils.ts +0 -202
  236. package/src/agent-tools/tools/web-fetch.ts +0 -464
  237. package/src/agent-tools/tools/web-search.ts +0 -480
  238. package/src/agent-tools/tools/web-shared.ts +0 -232
  239. package/src/agent-tools/tools/write.ts +0 -68
  240. package/src/agent-tools/types.ts +0 -214
  241. package/src/agenticmail/index.ts +0 -34
  242. package/src/agenticmail/manager.ts +0 -253
  243. package/src/agenticmail/providers/google.ts +0 -391
  244. package/src/agenticmail/providers/imap.ts +0 -454
  245. package/src/agenticmail/providers/index.ts +0 -28
  246. package/src/agenticmail/providers/microsoft.ts +0 -260
  247. package/src/agenticmail/types.ts +0 -173
  248. package/src/auth/routes.ts +0 -1589
  249. package/src/browser/bridge-auth-registry.ts +0 -34
  250. package/src/browser/bridge-server.ts +0 -93
  251. package/src/browser/cdp.helpers.ts +0 -180
  252. package/src/browser/cdp.ts +0 -466
  253. package/src/browser/chrome.executables.ts +0 -625
  254. package/src/browser/chrome.profile-decoration.ts +0 -198
  255. package/src/browser/chrome.ts +0 -349
  256. package/src/browser/client-actions-core.ts +0 -259
  257. package/src/browser/client-actions-observe.ts +0 -184
  258. package/src/browser/client-actions-state.ts +0 -284
  259. package/src/browser/client-actions-types.ts +0 -16
  260. package/src/browser/client-actions-url.ts +0 -11
  261. package/src/browser/client-actions.ts +0 -4
  262. package/src/browser/client-fetch.ts +0 -253
  263. package/src/browser/client.ts +0 -337
  264. package/src/browser/config.ts +0 -301
  265. package/src/browser/constants.ts +0 -8
  266. package/src/browser/control-auth.ts +0 -94
  267. package/src/browser/control-service.ts +0 -81
  268. package/src/browser/csrf.ts +0 -87
  269. package/src/browser/enterprise-compat.ts +0 -562
  270. package/src/browser/extension-relay.ts +0 -834
  271. package/src/browser/http-auth.ts +0 -63
  272. package/src/browser/navigation-guard.ts +0 -50
  273. package/src/browser/paths.ts +0 -49
  274. package/src/browser/playwright.d.ts +0 -12
  275. package/src/browser/profiles-service.ts +0 -187
  276. package/src/browser/profiles.ts +0 -114
  277. package/src/browser/proxy-files.ts +0 -41
  278. package/src/browser/pw-ai-module.ts +0 -52
  279. package/src/browser/pw-ai-state.ts +0 -9
  280. package/src/browser/pw-ai.ts +0 -65
  281. package/src/browser/pw-role-snapshot.ts +0 -434
  282. package/src/browser/pw-session.ts +0 -810
  283. package/src/browser/pw-tools-core.activity.ts +0 -68
  284. package/src/browser/pw-tools-core.downloads.ts +0 -281
  285. package/src/browser/pw-tools-core.interactions.ts +0 -646
  286. package/src/browser/pw-tools-core.responses.ts +0 -124
  287. package/src/browser/pw-tools-core.shared.ts +0 -70
  288. package/src/browser/pw-tools-core.snapshot.ts +0 -213
  289. package/src/browser/pw-tools-core.state.ts +0 -209
  290. package/src/browser/pw-tools-core.storage.ts +0 -128
  291. package/src/browser/pw-tools-core.trace.ts +0 -37
  292. package/src/browser/pw-tools-core.ts +0 -8
  293. package/src/browser/resolved-config-refresh.ts +0 -59
  294. package/src/browser/routes/agent.act.shared.ts +0 -52
  295. package/src/browser/routes/agent.act.ts +0 -575
  296. package/src/browser/routes/agent.debug.ts +0 -149
  297. package/src/browser/routes/agent.shared.ts +0 -143
  298. package/src/browser/routes/agent.snapshot.ts +0 -333
  299. package/src/browser/routes/agent.storage.ts +0 -451
  300. package/src/browser/routes/agent.ts +0 -13
  301. package/src/browser/routes/basic.ts +0 -202
  302. package/src/browser/routes/dispatcher.ts +0 -126
  303. package/src/browser/routes/index.ts +0 -11
  304. package/src/browser/routes/path-output.ts +0 -1
  305. package/src/browser/routes/tabs.ts +0 -217
  306. package/src/browser/routes/types.ts +0 -26
  307. package/src/browser/routes/utils.ts +0 -73
  308. package/src/browser/screenshot.ts +0 -54
  309. package/src/browser/server-context.ts +0 -688
  310. package/src/browser/server-context.types.ts +0 -65
  311. package/src/browser/server-lifecycle.ts +0 -48
  312. package/src/browser/server-middleware.ts +0 -37
  313. package/src/browser/server.ts +0 -110
  314. package/src/browser/target-id.ts +0 -30
  315. package/src/browser/trash.ts +0 -21
  316. package/src/cli-agent.ts +0 -2452
  317. package/src/cli-reset-password.ts +0 -138
  318. package/src/cli-serve.ts +0 -314
  319. package/src/cli.ts +0 -103
  320. package/src/dashboard/HELP-TOOLTIPS-GUIDE.md +0 -45
  321. package/src/dashboard/app.js +0 -579
  322. package/src/dashboard/assets/brand-logos.js +0 -350
  323. package/src/dashboard/assets/icons/emoji-icons.js +0 -893
  324. package/src/dashboard/assets/logo.png +0 -0
  325. package/src/dashboard/assets/provider-logos.js +0 -139
  326. package/src/dashboard/components/error-boundary.js +0 -21
  327. package/src/dashboard/components/help-button.js +0 -65
  328. package/src/dashboard/components/icons.js +0 -64
  329. package/src/dashboard/components/knowledge-link.js +0 -79
  330. package/src/dashboard/components/modal.js +0 -125
  331. package/src/dashboard/components/org-switcher.js +0 -156
  332. package/src/dashboard/components/persona-fields.js +0 -460
  333. package/src/dashboard/components/settings-help.js +0 -193
  334. package/src/dashboard/components/tag-input.js +0 -96
  335. package/src/dashboard/components/timezones.js +0 -352
  336. package/src/dashboard/components/transport-encryption.js +0 -288
  337. package/src/dashboard/components/utils.js +0 -205
  338. package/src/dashboard/data/countries.js +0 -255
  339. package/src/dashboard/docs/activity.html +0 -253
  340. package/src/dashboard/docs/agent-activity.html +0 -199
  341. package/src/dashboard/docs/agent-autonomy.html +0 -161
  342. package/src/dashboard/docs/agent-budget.html +0 -190
  343. package/src/dashboard/docs/agent-channels.html +0 -189
  344. package/src/dashboard/docs/agent-communication.html +0 -171
  345. package/src/dashboard/docs/agent-configuration.html +0 -194
  346. package/src/dashboard/docs/agent-deployment.html +0 -323
  347. package/src/dashboard/docs/agent-email.html +0 -184
  348. package/src/dashboard/docs/agent-guardrails.html +0 -206
  349. package/src/dashboard/docs/agent-manager.html +0 -226
  350. package/src/dashboard/docs/agent-memory.html +0 -215
  351. package/src/dashboard/docs/agent-overview.html +0 -226
  352. package/src/dashboard/docs/agent-permissions.html +0 -305
  353. package/src/dashboard/docs/agent-personal.html +0 -155
  354. package/src/dashboard/docs/agent-security.html +0 -188
  355. package/src/dashboard/docs/agent-skills.html +0 -224
  356. package/src/dashboard/docs/agent-tool-security.html +0 -205
  357. package/src/dashboard/docs/agent-tools.html +0 -238
  358. package/src/dashboard/docs/agent-whatsapp.html +0 -210
  359. package/src/dashboard/docs/agent-workforce.html +0 -199
  360. package/src/dashboard/docs/agents.html +0 -258
  361. package/src/dashboard/docs/approvals.html +0 -200
  362. package/src/dashboard/docs/audit.html +0 -206
  363. package/src/dashboard/docs/browser-providers.html +0 -313
  364. package/src/dashboard/docs/cluster.html +0 -285
  365. package/src/dashboard/docs/community-skills.html +0 -253
  366. package/src/dashboard/docs/compliance.html +0 -221
  367. package/src/dashboard/docs/dashboard.html +0 -84
  368. package/src/dashboard/docs/database-access.html +0 -322
  369. package/src/dashboard/docs/dlp.html +0 -268
  370. package/src/dashboard/docs/docs-style.css +0 -26
  371. package/src/dashboard/docs/domain-status.html +0 -294
  372. package/src/dashboard/docs/guardrails.html +0 -265
  373. package/src/dashboard/docs/journal.html +0 -197
  374. package/src/dashboard/docs/knowledge-contributions.html +0 -286
  375. package/src/dashboard/docs/knowledge.html +0 -268
  376. package/src/dashboard/docs/memory-transfer.html +0 -311
  377. package/src/dashboard/docs/messages.html +0 -217
  378. package/src/dashboard/docs/multi-tenant.html +0 -311
  379. package/src/dashboard/docs/org-chart.html +0 -239
  380. package/src/dashboard/docs/organizations.html +0 -182
  381. package/src/dashboard/docs/roles.html +0 -195
  382. package/src/dashboard/docs/settings-network.html +0 -321
  383. package/src/dashboard/docs/settings-security.html +0 -347
  384. package/src/dashboard/docs/settings-tool-security.html +0 -176
  385. package/src/dashboard/docs/settings.html +0 -280
  386. package/src/dashboard/docs/skill-connections.html +0 -270
  387. package/src/dashboard/docs/skills.html +0 -206
  388. package/src/dashboard/docs/task-pipeline.html +0 -261
  389. package/src/dashboard/docs/transport-encryption.html +0 -359
  390. package/src/dashboard/docs/users.html +0 -225
  391. package/src/dashboard/docs/vault.html +0 -260
  392. package/src/dashboard/docs/workforce.html +0 -245
  393. package/src/dashboard/index.html +0 -444
  394. package/src/dashboard/pages/activity.js +0 -379
  395. package/src/dashboard/pages/agent-detail/activity.js +0 -277
  396. package/src/dashboard/pages/agent-detail/autonomy.js +0 -244
  397. package/src/dashboard/pages/agent-detail/budget.js +0 -269
  398. package/src/dashboard/pages/agent-detail/channels.js +0 -494
  399. package/src/dashboard/pages/agent-detail/communication.js +0 -296
  400. package/src/dashboard/pages/agent-detail/configuration.js +0 -882
  401. package/src/dashboard/pages/agent-detail/deployment.js +0 -958
  402. package/src/dashboard/pages/agent-detail/email.js +0 -674
  403. package/src/dashboard/pages/agent-detail/guardrails.js +0 -521
  404. package/src/dashboard/pages/agent-detail/index.js +0 -261
  405. package/src/dashboard/pages/agent-detail/manager.js +0 -357
  406. package/src/dashboard/pages/agent-detail/meeting-browser.js +0 -933
  407. package/src/dashboard/pages/agent-detail/memory.js +0 -368
  408. package/src/dashboard/pages/agent-detail/overview.js +0 -844
  409. package/src/dashboard/pages/agent-detail/permissions.js +0 -1163
  410. package/src/dashboard/pages/agent-detail/personal-details.js +0 -404
  411. package/src/dashboard/pages/agent-detail/security.js +0 -409
  412. package/src/dashboard/pages/agent-detail/shared.js +0 -85
  413. package/src/dashboard/pages/agent-detail/skills-section.js +0 -183
  414. package/src/dashboard/pages/agent-detail/tool-security.js +0 -380
  415. package/src/dashboard/pages/agent-detail/tools.js +0 -322
  416. package/src/dashboard/pages/agent-detail/whatsapp.js +0 -824
  417. package/src/dashboard/pages/agent-detail/workforce.js +0 -683
  418. package/src/dashboard/pages/agents.js +0 -1242
  419. package/src/dashboard/pages/approvals.js +0 -100
  420. package/src/dashboard/pages/audit.js +0 -198
  421. package/src/dashboard/pages/cluster.js +0 -512
  422. package/src/dashboard/pages/community-skills.js +0 -1219
  423. package/src/dashboard/pages/compliance.js +0 -475
  424. package/src/dashboard/pages/dashboard.js +0 -180
  425. package/src/dashboard/pages/database-access.js +0 -812
  426. package/src/dashboard/pages/dlp.js +0 -293
  427. package/src/dashboard/pages/domain-status.js +0 -951
  428. package/src/dashboard/pages/guardrails.js +0 -1035
  429. package/src/dashboard/pages/journal.js +0 -172
  430. package/src/dashboard/pages/knowledge-contributions.js +0 -1682
  431. package/src/dashboard/pages/knowledge-import.js +0 -455
  432. package/src/dashboard/pages/knowledge.js +0 -582
  433. package/src/dashboard/pages/login.js +0 -1056
  434. package/src/dashboard/pages/memory-transfer.js +0 -631
  435. package/src/dashboard/pages/messages.js +0 -303
  436. package/src/dashboard/pages/org-chart.js +0 -349
  437. package/src/dashboard/pages/organizations.js +0 -1081
  438. package/src/dashboard/pages/roles.js +0 -780
  439. package/src/dashboard/pages/settings.js +0 -3790
  440. package/src/dashboard/pages/skill-connections.js +0 -982
  441. package/src/dashboard/pages/skills.js +0 -879
  442. package/src/dashboard/pages/task-pipeline.js +0 -684
  443. package/src/dashboard/pages/users.js +0 -867
  444. package/src/dashboard/pages/vault.js +0 -791
  445. package/src/dashboard/pages/workforce.js +0 -851
  446. package/src/dashboard/vendor/react-dom.development.js +0 -29924
  447. package/src/dashboard/vendor/react-dom.production.min.js +0 -267
  448. package/src/dashboard/vendor/react.development.js +0 -3343
  449. package/src/dashboard/vendor/react.production.min.js +0 -31
  450. package/src/database-access/agent-tools.ts +0 -193
  451. package/src/database-access/connection-manager.ts +0 -1341
  452. package/src/database-access/index.ts +0 -21
  453. package/src/database-access/query-sanitizer.ts +0 -220
  454. package/src/database-access/routes.ts +0 -226
  455. package/src/database-access/types.ts +0 -226
  456. package/src/db/adapter.ts +0 -510
  457. package/src/db/dynamodb.ts +0 -454
  458. package/src/db/factory.ts +0 -129
  459. package/src/db/mongodb.ts +0 -360
  460. package/src/db/mysql.ts +0 -531
  461. package/src/db/postgres.ts +0 -863
  462. package/src/db/proxy.ts +0 -39
  463. package/src/db/resolve-driver.ts +0 -29
  464. package/src/db/sql-schema.ts +0 -124
  465. package/src/db/sqlite.ts +0 -493
  466. package/src/db/turso.ts +0 -470
  467. package/src/deploy/fly.ts +0 -368
  468. package/src/deploy/managed.ts +0 -235
  469. package/src/domain-lock/cli-recover.ts +0 -591
  470. package/src/domain-lock/cli-verify.ts +0 -190
  471. package/src/domain-lock/index.ts +0 -220
  472. package/src/engine/activity-routes.ts +0 -154
  473. package/src/engine/activity.ts +0 -568
  474. package/src/engine/agent-autonomy.ts +0 -974
  475. package/src/engine/agent-config.ts +0 -646
  476. package/src/engine/agent-heartbeat.ts +0 -720
  477. package/src/engine/agent-hierarchy.ts +0 -1064
  478. package/src/engine/agent-memory.ts +0 -806
  479. package/src/engine/agent-notify.ts +0 -50
  480. package/src/engine/agent-routes.ts +0 -2583
  481. package/src/engine/agent-status.ts +0 -311
  482. package/src/engine/ambient-memory.ts +0 -401
  483. package/src/engine/approvals.ts +0 -615
  484. package/src/engine/assets/thinking-hum.mp3 +0 -0
  485. package/src/engine/catalog-routes.ts +0 -232
  486. package/src/engine/chat-poller.ts +0 -913
  487. package/src/engine/chat-webhook-routes.ts +0 -304
  488. package/src/engine/cli-build-skill.ts +0 -285
  489. package/src/engine/cli-submit-skill.ts +0 -200
  490. package/src/engine/cli-validate.ts +0 -188
  491. package/src/engine/cluster.ts +0 -278
  492. package/src/engine/communication-routes.ts +0 -139
  493. package/src/engine/communication.ts +0 -765
  494. package/src/engine/community-registry.ts +0 -1529
  495. package/src/engine/community-routes.ts +0 -260
  496. package/src/engine/compliance-routes.ts +0 -133
  497. package/src/engine/compliance.ts +0 -1679
  498. package/src/engine/config-bus.ts +0 -103
  499. package/src/engine/db-adapter.ts +0 -1156
  500. package/src/engine/db-schema.ts +0 -1945
  501. package/src/engine/deploy-schema-routes.ts +0 -176
  502. package/src/engine/deployer.ts +0 -957
  503. package/src/engine/dlp-routes.ts +0 -101
  504. package/src/engine/dlp.ts +0 -410
  505. package/src/engine/email-poller.ts +0 -855
  506. package/src/engine/emoji.ts +0 -106
  507. package/src/engine/guardrail-routes.ts +0 -125
  508. package/src/engine/guardrails.ts +0 -465
  509. package/src/engine/index.ts +0 -255
  510. package/src/engine/journal-routes.ts +0 -56
  511. package/src/engine/journal.ts +0 -249
  512. package/src/engine/knowledge-contribution-routes.ts +0 -633
  513. package/src/engine/knowledge-contribution.ts +0 -1386
  514. package/src/engine/knowledge-import/chunker.ts +0 -241
  515. package/src/engine/knowledge-import/import-manager.ts +0 -416
  516. package/src/engine/knowledge-import/index.ts +0 -27
  517. package/src/engine/knowledge-import/processors/clean.ts +0 -149
  518. package/src/engine/knowledge-import/processors/extract-gdrive.ts +0 -102
  519. package/src/engine/knowledge-import/processors/extract-github.ts +0 -74
  520. package/src/engine/knowledge-import/processors/extract-sharepoint.ts +0 -69
  521. package/src/engine/knowledge-import/processors/extract-web.ts +0 -275
  522. package/src/engine/knowledge-import/processors/index.ts +0 -18
  523. package/src/engine/knowledge-import/processors/pipeline.ts +0 -171
  524. package/src/engine/knowledge-import/processors/types.ts +0 -78
  525. package/src/engine/knowledge-import/processors/validate.ts +0 -150
  526. package/src/engine/knowledge-import/provider-file-upload.ts +0 -95
  527. package/src/engine/knowledge-import/provider-github.ts +0 -144
  528. package/src/engine/knowledge-import/provider-google-sites.ts +0 -323
  529. package/src/engine/knowledge-import/provider-sharepoint.ts +0 -276
  530. package/src/engine/knowledge-import/provider-url.ts +0 -218
  531. package/src/engine/knowledge-import/routes.ts +0 -94
  532. package/src/engine/knowledge-import/types.ts +0 -92
  533. package/src/engine/knowledge-routes.ts +0 -231
  534. package/src/engine/knowledge.ts +0 -587
  535. package/src/engine/lifecycle.ts +0 -1420
  536. package/src/engine/mcp-process-manager.ts +0 -573
  537. package/src/engine/meeting-monitor.ts +0 -483
  538. package/src/engine/meeting-voice-intelligence.ts +0 -340
  539. package/src/engine/memory-routes.ts +0 -142
  540. package/src/engine/memory-transfer-routes.ts +0 -339
  541. package/src/engine/messaging-history.ts +0 -177
  542. package/src/engine/messaging-poller.ts +0 -786
  543. package/src/engine/model-fallback.ts +0 -141
  544. package/src/engine/oauth-connect-routes.ts +0 -603
  545. package/src/engine/oauth-connect.ts +0 -304
  546. package/src/engine/onboarding-routes.ts +0 -148
  547. package/src/engine/onboarding.ts +0 -574
  548. package/src/engine/org-approval-routes.ts +0 -146
  549. package/src/engine/org-integration-routes.ts +0 -399
  550. package/src/engine/org-integrations.ts +0 -608
  551. package/src/engine/org-policies.ts +0 -502
  552. package/src/engine/policy-import-routes.ts +0 -125
  553. package/src/engine/policy-import.ts +0 -1186
  554. package/src/engine/policy-routes.ts +0 -163
  555. package/src/engine/routes.ts +0 -1236
  556. package/src/engine/screen-unlock.ts +0 -136
  557. package/src/engine/session-router.ts +0 -212
  558. package/src/engine/skill-updater-routes.ts +0 -132
  559. package/src/engine/skill-updater.ts +0 -480
  560. package/src/engine/skill-validator.ts +0 -331
  561. package/src/engine/skills/agent-management.ts +0 -119
  562. package/src/engine/skills/agent-memory.ts +0 -19
  563. package/src/engine/skills/agenticmail.ts +0 -116
  564. package/src/engine/skills/core-tools.ts +0 -25
  565. package/src/engine/skills/database-access.ts +0 -78
  566. package/src/engine/skills/enterprise-code-sandbox.ts +0 -113
  567. package/src/engine/skills/enterprise-database.ts +0 -123
  568. package/src/engine/skills/enterprise-diff.ts +0 -95
  569. package/src/engine/skills/enterprise-documents.ts +0 -162
  570. package/src/engine/skills/enterprise-http.ts +0 -99
  571. package/src/engine/skills/enterprise-security-scan.ts +0 -125
  572. package/src/engine/skills/enterprise-spreadsheet.ts +0 -171
  573. package/src/engine/skills/gws-admin.ts +0 -18
  574. package/src/engine/skills/gws-calendar.ts +0 -21
  575. package/src/engine/skills/gws-chat.ts +0 -29
  576. package/src/engine/skills/gws-contacts.ts +0 -20
  577. package/src/engine/skills/gws-docs.ts +0 -18
  578. package/src/engine/skills/gws-drive.ts +0 -23
  579. package/src/engine/skills/gws-forms.ts +0 -23
  580. package/src/engine/skills/gws-gmail.ts +0 -30
  581. package/src/engine/skills/gws-groups.ts +0 -17
  582. package/src/engine/skills/gws-keep.ts +0 -17
  583. package/src/engine/skills/gws-maps.ts +0 -25
  584. package/src/engine/skills/gws-meet.ts +0 -23
  585. package/src/engine/skills/gws-sheets.ts +0 -22
  586. package/src/engine/skills/gws-sites.ts +0 -16
  587. package/src/engine/skills/gws-slides.ts +0 -27
  588. package/src/engine/skills/gws-tasks.ts +0 -22
  589. package/src/engine/skills/gws-vault.ts +0 -17
  590. package/src/engine/skills/index.ts +0 -159
  591. package/src/engine/skills/knowledge-search.ts +0 -18
  592. package/src/engine/skills/local-system.ts +0 -61
  593. package/src/engine/skills/m365-admin.ts +0 -18
  594. package/src/engine/skills/m365-bookings.ts +0 -17
  595. package/src/engine/skills/m365-copilot.ts +0 -17
  596. package/src/engine/skills/m365-excel.ts +0 -60
  597. package/src/engine/skills/m365-forms.ts +0 -17
  598. package/src/engine/skills/m365-onedrive.ts +0 -60
  599. package/src/engine/skills/m365-onenote.ts +0 -17
  600. package/src/engine/skills/m365-outlook.ts +0 -27
  601. package/src/engine/skills/m365-planner.ts +0 -18
  602. package/src/engine/skills/m365-power-automate.ts +0 -18
  603. package/src/engine/skills/m365-power-bi.ts +0 -19
  604. package/src/engine/skills/m365-powerpoint.ts +0 -33
  605. package/src/engine/skills/m365-sharepoint.ts +0 -20
  606. package/src/engine/skills/m365-teams.ts +0 -21
  607. package/src/engine/skills/m365-todo.ts +0 -17
  608. package/src/engine/skills/m365-whiteboard.ts +0 -16
  609. package/src/engine/skills/m365-word.ts +0 -42
  610. package/src/engine/skills/mcp-bridge.ts +0 -45
  611. package/src/engine/skills/meeting-lifecycle.ts +0 -20
  612. package/src/engine/skills/messaging.ts +0 -46
  613. package/src/engine/skills/visual-memory.ts +0 -25
  614. package/src/engine/skills.ts +0 -688
  615. package/src/engine/soul-library.ts +0 -142
  616. package/src/engine/soul-templates.json +0 -1525
  617. package/src/engine/storage-manager.ts +0 -252
  618. package/src/engine/storage-routes.ts +0 -113
  619. package/src/engine/storage.ts +0 -528
  620. package/src/engine/task-poller.ts +0 -394
  621. package/src/engine/task-queue-after-spawn.ts +0 -66
  622. package/src/engine/task-queue-before-spawn.ts +0 -113
  623. package/src/engine/task-queue-routes.ts +0 -161
  624. package/src/engine/task-queue.ts +0 -664
  625. package/src/engine/tenant.ts +0 -409
  626. package/src/engine/tool-catalog.ts +0 -354
  627. package/src/engine/vault-routes.ts +0 -134
  628. package/src/engine/vault.ts +0 -601
  629. package/src/engine/workforce-routes.ts +0 -331
  630. package/src/engine/workforce.ts +0 -1161
  631. package/src/index.ts +0 -77
  632. package/src/lib/cidr.ts +0 -122
  633. package/src/lib/config-store.ts +0 -86
  634. package/src/lib/resilience.ts +0 -326
  635. package/src/lib/text-search.ts +0 -358
  636. package/src/mcp/adapters/activecampaign.adapter.ts +0 -391
  637. package/src/mcp/adapters/adobe-sign.adapter.ts +0 -469
  638. package/src/mcp/adapters/adp.adapter.ts +0 -358
  639. package/src/mcp/adapters/airtable.adapter.ts +0 -273
  640. package/src/mcp/adapters/apollo.adapter.ts +0 -420
  641. package/src/mcp/adapters/asana.adapter.ts +0 -315
  642. package/src/mcp/adapters/auth0.adapter.ts +0 -386
  643. package/src/mcp/adapters/aws.adapter.ts +0 -345
  644. package/src/mcp/adapters/azure-devops.adapter.ts +0 -389
  645. package/src/mcp/adapters/bamboohr.adapter.ts +0 -376
  646. package/src/mcp/adapters/basecamp.adapter.ts +0 -366
  647. package/src/mcp/adapters/bigcommerce.adapter.ts +0 -429
  648. package/src/mcp/adapters/bitbucket.adapter.ts +0 -260
  649. package/src/mcp/adapters/box.adapter.ts +0 -350
  650. package/src/mcp/adapters/brex.adapter.ts +0 -367
  651. package/src/mcp/adapters/buffer.adapter.ts +0 -303
  652. package/src/mcp/adapters/calendly.adapter.ts +0 -262
  653. package/src/mcp/adapters/canva.adapter.ts +0 -256
  654. package/src/mcp/adapters/chargebee.adapter.ts +0 -448
  655. package/src/mcp/adapters/circleci.adapter.ts +0 -216
  656. package/src/mcp/adapters/clickup.adapter.ts +0 -335
  657. package/src/mcp/adapters/close.adapter.ts +0 -390
  658. package/src/mcp/adapters/cloudflare.adapter.ts +0 -378
  659. package/src/mcp/adapters/confluence.adapter.ts +0 -301
  660. package/src/mcp/adapters/contentful.adapter.ts +0 -355
  661. package/src/mcp/adapters/copper.adapter.ts +0 -468
  662. package/src/mcp/adapters/crisp.adapter.ts +0 -415
  663. package/src/mcp/adapters/crowdstrike.adapter.ts +0 -413
  664. package/src/mcp/adapters/datadog.adapter.ts +0 -373
  665. package/src/mcp/adapters/digitalocean.adapter.ts +0 -336
  666. package/src/mcp/adapters/discord.adapter.ts +0 -248
  667. package/src/mcp/adapters/docker.adapter.ts +0 -238
  668. package/src/mcp/adapters/docusign.adapter.ts +0 -431
  669. package/src/mcp/adapters/drift.adapter.ts +0 -386
  670. package/src/mcp/adapters/dropbox.adapter.ts +0 -315
  671. package/src/mcp/adapters/figma.adapter.ts +0 -302
  672. package/src/mcp/adapters/firebase.adapter.ts +0 -446
  673. package/src/mcp/adapters/flyio.adapter.ts +0 -302
  674. package/src/mcp/adapters/freshbooks.adapter.ts +0 -474
  675. package/src/mcp/adapters/freshdesk.adapter.ts +0 -441
  676. package/src/mcp/adapters/freshsales.adapter.ts +0 -457
  677. package/src/mcp/adapters/freshservice.adapter.ts +0 -481
  678. package/src/mcp/adapters/front.adapter.ts +0 -357
  679. package/src/mcp/adapters/github-actions.adapter.ts +0 -329
  680. package/src/mcp/adapters/github.adapter.ts +0 -387
  681. package/src/mcp/adapters/gitlab.adapter.ts +0 -368
  682. package/src/mcp/adapters/gong.adapter.ts +0 -386
  683. package/src/mcp/adapters/google-ads.adapter.ts +0 -363
  684. package/src/mcp/adapters/google-analytics.adapter.ts +0 -316
  685. package/src/mcp/adapters/google-cloud.adapter.ts +0 -312
  686. package/src/mcp/adapters/gotomeeting.adapter.ts +0 -255
  687. package/src/mcp/adapters/grafana.adapter.ts +0 -361
  688. package/src/mcp/adapters/greenhouse.adapter.ts +0 -354
  689. package/src/mcp/adapters/gusto.adapter.ts +0 -329
  690. package/src/mcp/adapters/hashicorp-vault.adapter.ts +0 -355
  691. package/src/mcp/adapters/heroku.adapter.ts +0 -291
  692. package/src/mcp/adapters/hibob.adapter.ts +0 -334
  693. package/src/mcp/adapters/hootsuite.adapter.ts +0 -322
  694. package/src/mcp/adapters/hubspot.adapter.ts +0 -400
  695. package/src/mcp/adapters/huggingface.adapter.ts +0 -349
  696. package/src/mcp/adapters/index.ts +0 -524
  697. package/src/mcp/adapters/intercom.adapter.ts +0 -269
  698. package/src/mcp/adapters/jira.adapter.ts +0 -482
  699. package/src/mcp/adapters/klaviyo.adapter.ts +0 -353
  700. package/src/mcp/adapters/kubernetes.adapter.ts +0 -431
  701. package/src/mcp/adapters/lattice.adapter.ts +0 -339
  702. package/src/mcp/adapters/launchdarkly.adapter.ts +0 -368
  703. package/src/mcp/adapters/lever.adapter.ts +0 -347
  704. package/src/mcp/adapters/linear.adapter.ts +0 -300
  705. package/src/mcp/adapters/linkedin.adapter.ts +0 -331
  706. package/src/mcp/adapters/livechat.adapter.ts +0 -259
  707. package/src/mcp/adapters/loom.adapter.ts +0 -230
  708. package/src/mcp/adapters/mailchimp.adapter.ts +0 -394
  709. package/src/mcp/adapters/mailgun.adapter.ts +0 -425
  710. package/src/mcp/adapters/miro.adapter.ts +0 -274
  711. package/src/mcp/adapters/mixpanel.adapter.ts +0 -324
  712. package/src/mcp/adapters/monday.adapter.ts +0 -308
  713. package/src/mcp/adapters/mongodb-atlas.adapter.ts +0 -345
  714. package/src/mcp/adapters/neon.adapter.ts +0 -312
  715. package/src/mcp/adapters/netlify.adapter.ts +0 -324
  716. package/src/mcp/adapters/netsuite.adapter.ts +0 -411
  717. package/src/mcp/adapters/newrelic.adapter.ts +0 -339
  718. package/src/mcp/adapters/notion.adapter.ts +0 -338
  719. package/src/mcp/adapters/okta.adapter.ts +0 -394
  720. package/src/mcp/adapters/openai.adapter.ts +0 -315
  721. package/src/mcp/adapters/opsgenie.adapter.ts +0 -375
  722. package/src/mcp/adapters/outreach.adapter.ts +0 -372
  723. package/src/mcp/adapters/paddle.adapter.ts +0 -467
  724. package/src/mcp/adapters/pagerduty.adapter.ts +0 -412
  725. package/src/mcp/adapters/pandadoc.adapter.ts +0 -389
  726. package/src/mcp/adapters/paypal.adapter.ts +0 -465
  727. package/src/mcp/adapters/personio.adapter.ts +0 -401
  728. package/src/mcp/adapters/pinecone.adapter.ts +0 -340
  729. package/src/mcp/adapters/pipedrive.adapter.ts +0 -324
  730. package/src/mcp/adapters/plaid.adapter.ts +0 -444
  731. package/src/mcp/adapters/postmark.adapter.ts +0 -387
  732. package/src/mcp/adapters/power-automate.adapter.ts +0 -388
  733. package/src/mcp/adapters/quickbooks.adapter.ts +0 -431
  734. package/src/mcp/adapters/recurly.adapter.ts +0 -433
  735. package/src/mcp/adapters/reddit.adapter.ts +0 -371
  736. package/src/mcp/adapters/render.adapter.ts +0 -332
  737. package/src/mcp/adapters/ringcentral.adapter.ts +0 -281
  738. package/src/mcp/adapters/rippling.adapter.ts +0 -287
  739. package/src/mcp/adapters/salesforce.adapter.ts +0 -321
  740. package/src/mcp/adapters/salesloft.adapter.ts +0 -413
  741. package/src/mcp/adapters/sanity.adapter.ts +0 -363
  742. package/src/mcp/adapters/sap.adapter.ts +0 -483
  743. package/src/mcp/adapters/segment.adapter.ts +0 -260
  744. package/src/mcp/adapters/sendgrid.adapter.ts +0 -265
  745. package/src/mcp/adapters/sentry.adapter.ts +0 -331
  746. package/src/mcp/adapters/servicenow.adapter.ts +0 -468
  747. package/src/mcp/adapters/shopify.adapter.ts +0 -451
  748. package/src/mcp/adapters/shortcut.adapter.ts +0 -290
  749. package/src/mcp/adapters/slack.adapter.ts +0 -380
  750. package/src/mcp/adapters/smartsheet.adapter.ts +0 -326
  751. package/src/mcp/adapters/snowflake.adapter.ts +0 -347
  752. package/src/mcp/adapters/snyk.adapter.ts +0 -394
  753. package/src/mcp/adapters/splunk.adapter.ts +0 -403
  754. package/src/mcp/adapters/square.adapter.ts +0 -467
  755. package/src/mcp/adapters/statuspage.adapter.ts +0 -401
  756. package/src/mcp/adapters/stripe.adapter.ts +0 -380
  757. package/src/mcp/adapters/supabase.adapter.ts +0 -334
  758. package/src/mcp/adapters/teamwork.adapter.ts +0 -404
  759. package/src/mcp/adapters/telegram.adapter.ts +0 -299
  760. package/src/mcp/adapters/terraform.adapter.ts +0 -300
  761. package/src/mcp/adapters/todoist.adapter.ts +0 -239
  762. package/src/mcp/adapters/trello.adapter.ts +0 -316
  763. package/src/mcp/adapters/twilio.adapter.ts +0 -233
  764. package/src/mcp/adapters/twitter.adapter.ts +0 -348
  765. package/src/mcp/adapters/vercel.adapter.ts +0 -219
  766. package/src/mcp/adapters/weaviate.adapter.ts +0 -371
  767. package/src/mcp/adapters/webex.adapter.ts +0 -237
  768. package/src/mcp/adapters/webflow.adapter.ts +0 -287
  769. package/src/mcp/adapters/whatsapp.adapter.ts +0 -273
  770. package/src/mcp/adapters/whereby.adapter.ts +0 -240
  771. package/src/mcp/adapters/woocommerce.adapter.ts +0 -454
  772. package/src/mcp/adapters/wordpress.adapter.ts +0 -455
  773. package/src/mcp/adapters/workday.adapter.ts +0 -354
  774. package/src/mcp/adapters/wrike.adapter.ts +0 -349
  775. package/src/mcp/adapters/xero.adapter.ts +0 -472
  776. package/src/mcp/adapters/youtube.adapter.ts +0 -401
  777. package/src/mcp/adapters/zendesk.adapter.ts +0 -399
  778. package/src/mcp/adapters/zoho-crm.adapter.ts +0 -410
  779. package/src/mcp/adapters/zoom.adapter.ts +0 -241
  780. package/src/mcp/adapters/zuora.adapter.ts +0 -476
  781. package/src/mcp/framework/api-executor.ts +0 -192
  782. package/src/mcp/framework/aws-sigv4.ts +0 -216
  783. package/src/mcp/framework/credential-resolver.ts +0 -128
  784. package/src/mcp/framework/oauth-token-manager.ts +0 -22
  785. package/src/mcp/framework/skill-mcp-framework.ts +0 -226
  786. package/src/mcp/framework/types.ts +0 -130
  787. package/src/mcp/index.ts +0 -124
  788. package/src/mcp/integration-catalog.ts +0 -178
  789. package/src/middleware/dns-rebinding.ts +0 -44
  790. package/src/middleware/egress-filter.ts +0 -104
  791. package/src/middleware/firewall.ts +0 -192
  792. package/src/middleware/geo-ip.ts +0 -156
  793. package/src/middleware/index.ts +0 -390
  794. package/src/middleware/network-config.ts +0 -90
  795. package/src/middleware/proxy-config.ts +0 -71
  796. package/src/middleware/request-limits.ts +0 -59
  797. package/src/middleware/transport-encryption.ts +0 -398
  798. package/src/registry/cli.ts +0 -63
  799. package/src/registry/server.ts +0 -504
  800. package/src/runtime/agent-loop.ts +0 -779
  801. package/src/runtime/compaction.ts +0 -638
  802. package/src/runtime/email-channel.ts +0 -120
  803. package/src/runtime/environment.ts +0 -300
  804. package/src/runtime/followup.ts +0 -211
  805. package/src/runtime/gateway.ts +0 -260
  806. package/src/runtime/hooks.ts +0 -564
  807. package/src/runtime/index.ts +0 -1110
  808. package/src/runtime/llm-client.ts +0 -1056
  809. package/src/runtime/model-router.ts +0 -97
  810. package/src/runtime/providers.ts +0 -228
  811. package/src/runtime/session-manager.ts +0 -345
  812. package/src/runtime/subagent.ts +0 -153
  813. package/src/runtime/tool-executor.ts +0 -208
  814. package/src/runtime/types.ts +0 -255
  815. package/src/security/brute-force.ts +0 -423
  816. package/src/security/config.ts +0 -159
  817. package/src/security/csp.ts +0 -407
  818. package/src/security/external-content.ts +0 -299
  819. package/src/security/index.ts +0 -557
  820. package/src/security/input-sanitizer.ts +0 -452
  821. package/src/security/output-filter.ts +0 -575
  822. package/src/security/port-scanner.ts +0 -342
  823. package/src/security/prompt-guard.ts +0 -387
  824. package/src/security/sql-guard.ts +0 -338
  825. package/src/security/threat-logger.ts +0 -484
  826. package/src/server.ts +0 -828
  827. package/src/setup/company.ts +0 -183
  828. package/src/setup/database.ts +0 -153
  829. package/src/setup/deployment.ts +0 -561
  830. package/src/setup/domain.ts +0 -112
  831. package/src/setup/index.ts +0 -171
  832. package/src/setup/provision.ts +0 -532
  833. package/src/setup/registration.ts +0 -302
  834. package/src/system-prompts/catchup.ts +0 -48
  835. package/src/system-prompts/google/calendar.ts +0 -37
  836. package/src/system-prompts/google/chat.ts +0 -92
  837. package/src/system-prompts/google/contacts.ts +0 -25
  838. package/src/system-prompts/google/docs.ts +0 -29
  839. package/src/system-prompts/google/drive.ts +0 -34
  840. package/src/system-prompts/google/forms.ts +0 -25
  841. package/src/system-prompts/google/gmail.ts +0 -50
  842. package/src/system-prompts/google/index.ts +0 -23
  843. package/src/system-prompts/google/maps.ts +0 -20
  844. package/src/system-prompts/google/meet.ts +0 -130
  845. package/src/system-prompts/google/sheets.ts +0 -32
  846. package/src/system-prompts/google/slides.ts +0 -26
  847. package/src/system-prompts/google/tasks.ts +0 -27
  848. package/src/system-prompts/index.ts +0 -88
  849. package/src/system-prompts/microsoft/contacts.ts +0 -34
  850. package/src/system-prompts/microsoft/excel.ts +0 -52
  851. package/src/system-prompts/microsoft/index.ts +0 -31
  852. package/src/system-prompts/microsoft/onedrive.ts +0 -41
  853. package/src/system-prompts/microsoft/onenote.ts +0 -36
  854. package/src/system-prompts/microsoft/outlook-calendar.ts +0 -37
  855. package/src/system-prompts/microsoft/outlook-mail.ts +0 -46
  856. package/src/system-prompts/microsoft/planner.ts +0 -37
  857. package/src/system-prompts/microsoft/powerbi.ts +0 -38
  858. package/src/system-prompts/microsoft/powerpoint.ts +0 -35
  859. package/src/system-prompts/microsoft/sharepoint.ts +0 -44
  860. package/src/system-prompts/microsoft/teams.ts +0 -49
  861. package/src/system-prompts/microsoft/todo.ts +0 -37
  862. package/src/system-prompts/shared-blocks.ts +0 -87
  863. package/src/system-prompts/task.ts +0 -21
  864. package/src/system-prompts/triage.ts +0 -34
  865. package/src/types/hono-env.ts +0 -18
  866. package/src/types/optional-deps.d.ts +0 -10
package/src/dashboard/docs/browser-providers.html DELETED
@@ -1,313 +0,0 @@
1
- <!DOCTYPE html>
2
- <html lang="en">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>Browser Provider Setup Guide — AgenticMail Enterprise</title>
7
- <style>
8
- /* ── Match the enterprise dashboard theme exactly ── */
9
- :root {
10
- --bg-primary: #0f1117; --bg-secondary: #161822; --bg-tertiary: #1c1f2e; --bg-card: #181b28;
11
- --text-primary: #e8eaf0; --text-secondary: #9ca3b8; --text-muted: #6b7394;
12
- --accent: #6366f1; --accent-soft: rgba(99,102,241,0.12);
13
- --border: #2a2f45; --border-light: #353a52; --radius: 10px;
14
- --success: #15803d; --warning: #eab308; --danger: #ef4444;
15
- --info-soft: rgba(99,102,241,0.06);
16
- }
17
- /* Light theme (warm golden parchment — matches dashboard) */
18
- [data-theme="light"] {
19
- --bg-primary: #d0c5a0; --bg-secondary: #ddd3b2; --bg-tertiary: #c8bc94; --bg-card: #e5dcc0;
20
- --text-primary: #2c2410; --text-secondary: #3d3520; --text-muted: #6b5e42;
21
- --accent: #2563eb; --accent-soft: rgba(37,99,235,0.1);
22
- --border: #b8ad8a; --border-light: #a89e7a; --info-soft: rgba(37,99,235,0.06);
23
- }
24
- * { box-sizing: border-box; margin: 0; padding: 0; }
25
- body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; background: var(--bg-primary); color: var(--text-primary); line-height: 1.7; padding: 32px; max-width: 900px; margin: 0 auto; }
26
- h1 { font-size: 28px; margin-bottom: 8px; }
27
- h2 { font-size: 20px; margin: 32px 0 12px; padding-bottom: 8px; border-bottom: 1px solid var(--border); }
28
- h3 { font-size: 16px; margin: 20px 0 8px; color: var(--accent); }
29
- p { margin-bottom: 12px; color: var(--text-secondary); }
30
- code { background: var(--bg-primary); border: 1px solid var(--border); padding: 2px 6px; border-radius: 4px; font-size: 13px; color: var(--accent); }
31
- pre { background: var(--bg-primary); border: 1px solid var(--border); padding: 16px; border-radius: var(--radius); overflow-x: auto; margin: 12px 0; font-size: 13px; line-height: 1.5; color: var(--text-secondary); }
32
- pre code { background: none; border: none; padding: 0; }
33
- .card { background: var(--bg-card); border: 1px solid var(--border); border-radius: var(--radius); padding: 20px; margin: 16px 0; }
34
- .tip { background: var(--info-soft); border: 1px solid rgba(59,130,246,0.3); padding: 12px 16px; border-radius: var(--radius); margin: 12px 0; font-size: 13px; color: var(--text-secondary); }
35
- .warning { background: rgba(245,158,11,0.08); border: 1px solid rgba(245,158,11,0.3); padding: 12px 16px; border-radius: var(--radius); margin: 12px 0; font-size: 13px; color: var(--text-secondary); }
36
- .danger { background: rgba(239,68,68,0.08); border: 1px solid rgba(239,68,68,0.3); padding: 12px 16px; border-radius: var(--radius); margin: 12px 0; font-size: 13px; color: var(--text-secondary); }
37
- table { width: 100%; border-collapse: collapse; margin: 12px 0; font-size: 13px; }
38
- th, td { text-align: left; padding: 8px 12px; border: 1px solid var(--border); color: var(--text-secondary); }
39
- th { background: var(--bg-secondary); font-weight: 600; color: var(--text-primary); }
40
- ul, ol { padding-left: 24px; margin-bottom: 12px; color: var(--text-secondary); }
41
- li { margin-bottom: 6px; }
42
- .badge { display: inline-block; padding: 2px 8px; border-radius: 4px; font-size: 11px; font-weight: 600; }
43
- .badge-easy { background: rgba(21,128,61,0.2); color: var(--success); }
44
- .badge-medium { background: rgba(245,158,11,0.2); color: var(--warning); }
45
- .badge-advanced { background: rgba(239,68,68,0.2); color: var(--danger); }
46
- a { color: var(--accent); }
47
- .back { display: inline-block; margin-bottom: 20px; font-size: 13px; color: var(--text-muted); text-decoration: none; }
48
- .back:hover { color: var(--text-primary); }
49
- strong { color: var(--text-primary); }
50
- </style>
51
- <script>
52
- // Sync theme with dashboard (reads from localStorage)
53
- (function() {
54
- var t = localStorage.getItem('em_theme') || 'dark';
55
- document.documentElement.setAttribute('data-theme', t);
56
- })();
57
- </script>
58
- <script>
59
- // Sync theme with dashboard preference
60
- (function() {
61
- var saved = localStorage.getItem('em-theme');
62
- if (saved === 'light') document.documentElement.setAttribute('data-theme', 'light');
63
- else if (saved === 'dark') document.documentElement.setAttribute('data-theme', 'dark');
64
- else if (window.matchMedia && window.matchMedia('(prefers-color-scheme: light)').matches) {
65
- document.documentElement.setAttribute('data-theme', 'light');
66
- }
67
- })();
68
- </script>
69
- </head>
70
- <body>
71
-
72
- <a class="back" href="/dashboard/agents">&#8592; Back to Dashboard</a>
73
-
74
- <h1>Browser Provider Setup Guide</h1>
75
- <p style="color: var(--text-muted); margin-bottom: 24px;">Complete reference for connecting your AI agents to browsers — local, remote, or cloud-hosted.</p>
76
-
77
- <div class="card">
78
- <h3 style="margin-top: 0;">Quick Comparison</h3>
79
- <table>
80
- <tr><th>Provider</th><th>Best For</th><th>Video Calls</th><th>Difficulty</th><th>Cost</th></tr>
81
- <tr><td><strong>Local Chromium</strong></td><td>Web scraping, form filling, screenshots</td><td>No (headless) / Yes (headed + display)</td><td><span class="badge badge-easy">Easy</span></td><td>Free</td></tr>
82
- <tr><td><strong>Remote CDP</strong></td><td>Video calls, persistent sessions, full control</td><td>Yes</td><td><span class="badge badge-medium">Medium</span></td><td>VM cost only</td></tr>
83
- <tr><td><strong>Browserless.io</strong></td><td>Scalable scraping, stealth, managed infra</td><td>No</td><td><span class="badge badge-easy">Easy</span></td><td>Free tier available</td></tr>
84
- <tr><td><strong>Browserbase</strong></td><td>AI automation, session replay, anti-detection</td><td>No</td><td><span class="badge badge-easy">Easy</span></td><td>Free tier available</td></tr>
85
- <tr><td><strong>Steel.dev</strong></td><td>Self-hostable, AI-native, open-source</td><td>No</td><td><span class="badge badge-medium">Medium</span></td><td>Free (self-hosted)</td></tr>
86
- <tr><td><strong>ScrapingBee</strong></td><td>Proxy rotation, CAPTCHA solving</td><td>No</td><td><span class="badge badge-easy">Easy</span></td><td>Free tier available</td></tr>
87
- </table>
88
- </div>
89
-
90
- <h2 id="local">1. Local Chromium (Default)</h2>
91
- <p>The simplest option. A headless Chromium browser runs on the same machine as AgenticMail. No external services needed.</p>
92
- <h3>When to use</h3>
93
- <ul>
94
- <li>Web scraping and data extraction</li>
95
- <li>Taking screenshots of web pages</li>
96
- <li>Filling out forms and automating websites</li>
97
- <li>Any task that doesn't need camera, microphone, or visible display</li>
98
- </ul>
99
- <h3>Setup</h3>
100
- <p>No setup needed — it's the default. Chromium is auto-detected (Google Chrome, system Chromium, or Playwright's bundled Chromium). If none found, we install Playwright Chromium automatically on first launch.</p>
101
- <div class="tip"><strong>Headed mode:</strong> If your server has a display (desktop machine, not headless server), switch to "Headed" in the dashboard to see the browser window. Useful for debugging.</div>
102
- <h3>Troubleshooting</h3>
103
- <table>
104
- <tr><th>Issue</th><th>Solution</th></tr>
105
- <tr><td>Chromium not found</td><td>We auto-install on first use. If it fails, check disk space (~300MB needed).</td></tr>
106
- <tr><td>Missing dependencies on Linux</td><td><code>apt-get install -y libnss3 libatk1.0-0 libatk-bridge2.0-0 libdrm2 libxcomposite1 libxdamage1 libxrandr2 libgbm1 libpango-1.0-0 libasound2</code></td></tr>
107
- <tr><td>"Display not available" in headed mode</td><td>Headed mode requires X11/Wayland. Use headless on servers, or install Xvfb: <code>apt-get install xvfb && Xvfb :99 &</code></td></tr>
108
- <tr><td>Timeout on navigation</td><td>Increase timeout in browser settings. Some sites need longer with JS rendering.</td></tr>
109
- </table>
110
-
111
- <h2 id="remote-cdp">2. Remote Browser (CDP)</h2>
112
- <p>Connect to a Chrome browser running on another machine. The agent controls it remotely via Chrome DevTools Protocol. This is the <strong>only option that supports video calls</strong> (Google Meet, Teams, Zoom) because it can access a real camera, microphone, and display.</p>
113
- <h3>When to use</h3>
114
- <ul>
115
- <li>Video calls and meetings (Google Meet, Microsoft Teams, Zoom)</li>
116
- <li>Persistent browser sessions (stay logged in across restarts)</li>
117
- <li>When you need a real display, camera, or microphone</li>
118
- <li>Agent on headless server but needs browser GUI</li>
119
- </ul>
120
- <h3>What you need</h3>
121
- <ol>
122
- <li>A machine with Google Chrome installed (any OS)</li>
123
- <li>Chrome launched with remote debugging enabled</li>
124
- <li>Network access between your AgenticMail server and that machine</li>
125
- </ol>
126
-
127
- <h3>Setup: macOS</h3>
128
- <div class="card">
129
- <p><strong>Step 1:</strong> Open Terminal on the Mac where Chrome should run.</p>
130
- <p><strong>Step 2:</strong> Launch Chrome with remote debugging:</p>
131
- <pre><code>/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
132
- --remote-debugging-port=9222 \
133
- --remote-debugging-address=0.0.0.0 \
134
- --user-data-dir=/tmp/chrome-remote \
135
- --no-first-run</code></pre>
136
- <p><strong>Step 3:</strong> In AgenticMail dashboard, enter: <code>192.168.x.x:9222</code> (the Mac's IP)</p>
137
- <p><strong>Step 4:</strong> Click "Test Connection" — you should see the Chrome version.</p>
138
- </div>
139
- <div class="tip"><strong>Run at startup:</strong> Add the command to Login Items in System Settings, or create a Launch Agent plist at <code>~/Library/LaunchAgents/com.chrome.remote.plist</code>.</div>
140
-
141
- <h3>Setup: Linux (Ubuntu/Debian)</h3>
142
- <div class="card">
143
- <p><strong>Step 1:</strong> Install Chrome:</p>
144
- <pre><code>wget -q -O - https://dl.google.com/linux/linux_signing_key.pub | sudo gpg --dearmor -o /usr/share/keyrings/google-chrome.gpg
145
- echo "deb [arch=amd64 signed-by=/usr/share/keyrings/google-chrome.gpg] http://dl.google.com/linux/chrome/deb/ stable main" | sudo tee /etc/apt/sources.list.d/google-chrome.list
146
- sudo apt-get update && sudo apt-get install -y google-chrome-stable</code></pre>
147
- <p><strong>Step 2:</strong> For headless servers (no display), install virtual display:</p>
148
- <pre><code>sudo apt-get install -y xvfb pulseaudio
149
- Xvfb :99 -screen 0 1920x1080x24 &
150
- export DISPLAY=:99
151
- pulseaudio --start</code></pre>
152
- <p><strong>Step 3:</strong> Launch Chrome:</p>
153
- <pre><code>google-chrome-stable \
154
- --remote-debugging-port=9222 \
155
- --remote-debugging-address=0.0.0.0 \
156
- --no-sandbox --disable-gpu \
157
- --user-data-dir=/tmp/chrome-remote \
158
- --no-first-run &</code></pre>
159
- <p><strong>Step 4:</strong> Enter <code>your-server-ip:9222</code> in the dashboard.</p>
160
- </div>
161
- <div class="tip"><strong>For video calls on Linux:</strong> Virtual camera: <code>sudo apt install v4l2loopback-dkms</code>. Virtual audio: PulseAudio virtual sinks.</div>
162
-
163
- <h3>Setup: Windows</h3>
164
- <div class="card">
165
- <p><strong>Step 1:</strong> Open PowerShell:</p>
166
- <pre><code>& "C:\Program Files\Google\Chrome\Application\chrome.exe" `
167
- --remote-debugging-port=9222 `
168
- --remote-debugging-address=0.0.0.0 `
169
- --user-data-dir="$env:TEMP\chrome-remote" `
170
- --no-first-run</code></pre>
171
- <p><strong>Step 2:</strong> Allow Chrome through Windows Firewall when prompted.</p>
172
- <p><strong>Step 3:</strong> Enter the Windows machine's IP:9222 in the dashboard.</p>
173
- </div>
174
-
175
- <h3>Setup: Cloud VMs</h3>
176
- <div class="card">
177
- <table>
178
- <tr><th>Provider</th><th>Recommended</th><th>Notes</th></tr>
179
- <tr><td>AWS</td><td>EC2 Ubuntu Desktop / WorkSpaces</td><td>t3.medium+. Open port 9222 in security group (restrict to your AgenticMail IP).</td></tr>
180
- <tr><td>Azure</td><td>Virtual Desktop or VM</td><td>B2s+. Open port 9222 in NSG.</td></tr>
181
- <tr><td>Google Cloud</td><td>Compute Engine with Desktop</td><td>e2-medium+. Open port 9222 in firewall.</td></tr>
182
- <tr><td>Hetzner</td><td>Cloud Server with Ubuntu Desktop</td><td>Cost-effective (~&#8364;4/mo). Open port 9222.</td></tr>
183
- <tr><td>DigitalOcean</td><td>Droplet with Desktop</td><td>2GB+ RAM. Open port 9222.</td></tr>
184
- </table>
185
- <p style="margin-top: 8px;">Follow the Linux setup above, then configure firewall to only allow your AgenticMail server's IP.</p>
186
- </div>
187
-
188
- <h3>Securing the Connection</h3>
189
- <div class="warning"><strong>Security:</strong> Chrome's debug port has NO authentication by default. Anyone who reaches port 9222 has full browser control. Always restrict access.</div>
190
- <p><strong>Option A: Firewall (simplest)</strong></p>
191
- <pre><code># Linux (ufw)
192
- sudo ufw allow from YOUR_AGENTICMAIL_IP to any port 9222
193
-
194
- # Linux (iptables)
195
- sudo iptables -A INPUT -p tcp --dport 9222 -s YOUR_AGENTICMAIL_IP -j ACCEPT
196
- sudo iptables -A INPUT -p tcp --dport 9222 -j DROP</code></pre>
197
- <p><strong>Option B: SSH Tunnel (most secure)</strong></p>
198
- <ol>
199
- <li>Don't expose port 9222 publicly</li>
200
- <li>In the dashboard, set Remote Browser Address to <code>localhost:9222</code></li>
201
- <li>In SSH Tunnel field, enter: <code>user@remote-host</code></li>
202
- <li>We auto-create the tunnel before connecting — all traffic encrypted</li>
203
- </ol>
204
-
205
- <h3>Troubleshooting</h3>
206
- <table>
207
- <tr><th>Issue</th><th>Solution</th></tr>
208
- <tr><td>"Cannot connect to CDP"</td><td>Check: Chrome running with --remote-debugging-port, firewall allows it, IP/port correct</td></tr>
209
- <tr><td>"Connection refused"</td><td>Ensure <code>--remote-debugging-address=0.0.0.0</code> is set, or use SSH tunnel</td></tr>
210
- <tr><td>"WebSocket handshake failed"</td><td>Use host:port format (e.g. <code>192.168.1.100:9222</code>) — we auto-discover the WebSocket URL</td></tr>
211
- <tr><td>No camera in video call</td><td>Remote machine needs a camera (physical or virtual). Linux: <code>sudo modprobe v4l2loopback</code></td></tr>
212
- <tr><td>No audio</td><td>Install PulseAudio on Linux. macOS/Windows: works automatically.</td></tr>
213
- <tr><td>SSH tunnel fails</td><td>Check: SSH key configured (no password), host reachable, user has access</td></tr>
214
- </table>
215
-
216
- <h2 id="browserless">3. Browserless.io</h2>
217
- <p>Managed cloud browser service. Chrome in the cloud, connect via API token. Scalable and maintenance-free.</p>
218
- <h3>Setup</h3>
219
- <ol>
220
- <li>Sign up at <a href="https://www.browserless.io" target="_blank">browserless.io</a></li>
221
- <li>Copy your API token from the <a href="https://www.browserless.io/dashboard" target="_blank">dashboard</a></li>
222
- <li>Paste in AgenticMail → Browser → Browserless → API Token</li>
223
- <li>Click "Test Connection"</li>
224
- </ol>
225
- <h3>Self-hosted</h3>
226
- <pre><code>docker run -d --name browserless -p 3000:3000 -e TOKEN=your-secret ghcr.io/browserless/chromium</code></pre>
227
- <p>Set endpoint to <code>ws://your-server:3000</code>.</p>
228
- <div class="warning"><strong>No video calls.</strong> Cloud browsers don't have camera/mic. Use Remote CDP for meetings.</div>
229
-
230
- <h2 id="browserbase">4. Browserbase</h2>
231
- <p>AI-native cloud browser. Session replay, anti-detection, built for agent automation.</p>
232
- <h3>Setup</h3>
233
- <ol>
234
- <li>Sign up at <a href="https://www.browserbase.com" target="_blank">browserbase.com</a></li>
235
- <li>Copy API key from <a href="https://www.browserbase.com/settings" target="_blank">Settings</a></li>
236
- <li>Copy Project ID from dashboard</li>
237
- <li>Enter both in AgenticMail → Browser → Browserbase</li>
238
- <li>"Test Connection"</li>
239
- </ol>
240
- <div class="tip"><strong>Session replay:</strong> Watch exactly what your agent did at browserbase.com.</div>
241
-
242
- <h2 id="steel">5. Steel.dev</h2>
243
- <p>Open-source browser API for AI agents. Self-host for free or use managed cloud.</p>
244
- <h3>Cloud setup</h3>
245
- <ol>
246
- <li>Sign up at <a href="https://app.steel.dev" target="_blank">app.steel.dev</a></li>
247
- <li>Copy API key</li>
248
- <li>Enter in AgenticMail → Browser → Steel</li>
249
- </ol>
250
- <h3>Self-hosted</h3>
251
- <pre><code>docker run -d --name steel -p 3000:3000 ghcr.io/nichochar/steel-browser:latest</code></pre>
252
- <p>Set endpoint to <code>http://your-server:3000</code>.</p>
253
-
254
- <h2 id="scrapingbee">6. ScrapingBee</h2>
255
- <p>Scraping API with proxy rotation and CAPTCHA solving. Routes your browser through their network for anti-detection.</p>
256
- <h3>Setup</h3>
257
- <ol>
258
- <li>Sign up at <a href="https://www.scrapingbee.com" target="_blank">scrapingbee.com</a></li>
259
- <li>Copy API key from <a href="https://www.scrapingbee.com/dashboard" target="_blank">dashboard</a></li>
260
- <li>Enter in AgenticMail → Browser → ScrapingBee</li>
261
- <li>"Test Connection" — shows remaining credits</li>
262
- </ol>
263
- <div class="warning"><strong>Proxy-based:</strong> Works differently from other providers. Some advanced Playwright features (file uploads, complex interactions) may not work through the proxy. Use Browserless or Browserbase for those.</div>
264
-
265
- <h2 id="security">Security Best Practices</h2>
266
- <div class="card">
267
- <h3 style="margin-top: 0;">All providers</h3>
268
- <ul>
269
- <li><strong>Domain allowlists:</strong> Restrict which websites agents can visit</li>
270
- <li><strong>Page limits:</strong> Limit concurrent pages to prevent runaway browsing</li>
271
- <li><strong>SSRF protection:</strong> Blocks navigation to internal IPs (enabled by default)</li>
272
- <li><strong>Rotate API keys:</strong> Change cloud provider keys periodically</li>
273
- </ul>
274
- <h3>Remote CDP</h3>
275
- <ul>
276
- <li><strong>Never expose port 9222 publicly</strong> without firewall or SSH tunnel</li>
277
- <li><strong>Use SSH tunnels</strong> for encrypted connections</li>
278
- <li><strong>Dedicated Chrome profile</strong> (--user-data-dir) — don't use your personal browser</li>
279
- <li><strong>Non-root user</strong> on Linux</li>
280
- <li><strong>Keep Chrome updated</strong></li>
281
- </ul>
282
- <h3>Cloud providers</h3>
283
- <ul>
284
- <li><strong>Credentials encrypted</strong> in AgenticMail vault</li>
285
- <li><strong>IP allowlists</strong> on provider dashboards</li>
286
- <li><strong>Usage alerts</strong> for unusual activity</li>
287
- </ul>
288
- </div>
289
-
290
- <h2 id="faq">FAQ</h2>
291
- <div class="card">
292
- <h3 style="margin-top: 0;">Can I use video calls with cloud providers?</h3>
293
- <p>No. Cloud providers don't have camera/mic. Use <strong>Remote CDP</strong> for meetings.</p>
294
- <h3>Which provider is fastest?</h3>
295
- <p>Local Chromium (no network latency). For cloud: Browserless and Steel are fastest.</p>
296
- <h3>Can I switch providers without losing anything?</h3>
297
- <p>Yes. Sessions are independent. Switching takes effect on next browser action. Cookies don't transfer between providers.</p>
298
- <h3>What if cloud provider goes down?</h3>
299
- <p>Agent falls back to local Chromium automatically.</p>
300
- <h3>Multiple browsers for different tasks?</h3>
301
- <p>Each agent has its own browser config. Create different agents for different purposes.</p>
302
- </div>
303
-
304
- <p style="margin-top: 32px; color: var(--text-muted); font-size: 12px; text-align: center;">
305
- AgenticMail Enterprise — Browser Provider Setup Guide
306
- </p>
307
-
308
- <div style="margin-top:40px;padding-top:16px;border-top:1px solid var(--border);display:flex;justify-content:space-between;align-items:center;font-size:12px;color:var(--text-muted)">
309
- <span>AgenticMail Enterprise Documentation</span>
310
- <a href="https://github.com/agenticmail/enterprise/issues" target="_blank" style="display:inline-flex;align-items:center;gap:4px;color:var(--text-muted);text-decoration:none"><svg width="14" height="14" viewBox="0 0 24 24" fill="currentColor"><path d="M12 0C5.37 0 0 5.37 0 12c0 5.31 3.435 9.795 8.205 11.385.6.105.825-.255.825-.57 0-.285-.015-1.23-.015-2.235-3.015.555-3.795-.735-4.035-1.41-.135-.345-.72-1.41-1.23-1.695-.42-.225-1.02-.78-.015-.795.945-.015 1.62.87 1.845 1.23 1.08 1.815 2.805 1.305 3.495.99.105-.78.42-1.305.765-1.605-2.67-.3-5.46-1.335-5.46-5.925 0-1.305.465-2.385 1.23-3.225-.12-.3-.54-1.53.12-3.18 0 0 1.005-.315 3.3 1.23.96-.27 1.98-.405 3-.405s2.04.135 3 .405c2.295-1.56 3.3-1.23 3.3-1.23.66 1.65.24 2.88.12 3.18.765.84 1.23 1.905 1.23 3.225 0 4.605-2.805 5.625-5.475 5.925.435.375.81 1.095.81 2.22 0 1.605-.015 2.895-.015 3.3 0 .315.225.69.825.57A12.02 12.02 0 0024 12c0-6.63-5.37-12-12-12z"/></svg> Report an issue</a>
311
- </div>
312
- </body>
313
- </html>
package/src/dashboard/docs/cluster.html DELETED
@@ -1,285 +0,0 @@
1
- <!DOCTYPE html>
2
- <html lang="en">
3
- <head>
4
- <meta charset="UTF-8">
5
- <title>Cluster Management — AgenticMail Enterprise Docs</title>
6
- <link rel="stylesheet" href="docs.css">
7
- </head>
8
- <body>
9
- <div class="docs-container">
10
- <nav class="docs-nav"><a href="/dashboard">&larr; Back to Dashboard</a></nav>
11
-
12
- <h1>Cluster Management</h1>
13
- <p class="docs-subtitle">Scale your AI workforce across multiple machines — Mac Minis, VPS, cloud instances, or any combination.</p>
14
-
15
- <div class="docs-toc">
16
- <h4>Contents</h4>
17
- <ul>
18
- <li><a href="#overview">Overview</a></li>
19
- <li><a href="#architecture">Architecture</a></li>
20
- <li><a href="#adding-nodes">Adding Worker Nodes</a></li>
21
- <li><a href="#manual">Method 1: Manual Registration</a></li>
22
- <li><a href="#ssh">Method 2: SSH Deploy</a></li>
23
- <li><a href="#script">Method 3: Setup Script</a></li>
24
- <li><a href="#env-vars">Environment Variables</a></li>
25
- <li><a href="#monitoring">Monitoring & Health</a></li>
26
- <li><a href="#node-detail">Node Detail & Actions</a></li>
27
- <li><a href="#load-balancing">Load Balancing</a></li>
28
- <li><a href="#database">Database Sharing</a></li>
29
- <li><a href="#networking">Networking Requirements</a></li>
30
- <li><a href="#security">Security Considerations</a></li>
31
- <li><a href="#edge-cases">Edge Cases & Troubleshooting</a></li>
32
- <li><a href="#api">API Reference</a></li>
33
- </ul>
34
- </div>
35
-
36
- <h2 id="overview">Overview</h2>
37
- <p>The Cluster system enables <strong>horizontal scaling</strong> of your AI agent workforce. Instead of running all agents on a single machine, you can distribute them across multiple worker nodes — each running one or more agents that report back to a central dashboard.</p>
38
- <p>This is useful when:</p>
39
- <ul>
40
- <li>You have more agents than a single machine can handle</li>
41
- <li>You want geographic distribution (agents closer to users)</li>
42
- <li>You need hardware isolation (GPU nodes for voice, separate machines for browser automation)</li>
43
- <li>You want fault tolerance (agents survive if one machine goes down)</li>
44
- <li>You're scaling from a single Mac Mini to a fleet of machines</li>
45
- </ul>
46
-
47
- <h2 id="architecture">Architecture</h2>
48
- <div class="docs-diagram">
49
- <pre>
50
- ┌─────────────────────────────────────┐
51
- │ Control Plane │
52
- │ (Enterprise Dashboard Server) │
53
- │ │
54
- │ ┌──────────┐ ┌────────────────┐ │
55
- │ │ Dashboard │ │ Cluster API │ │
56
- │ │ (UI) │ │ (REST + SSE) │ │
57
- │ └──────────┘ └────────────────┘ │
58
- │ │ │ │
59
- │ ┌──────────────────────────┐ │
60
- │ │ Shared Database │ │
61
- │ │ (Postgres / Supabase) │ │
62
- │ └──────────────────────────┘ │
63
- └─────────────┬───────────────────────┘
64
- │ HTTP (heartbeat, status)
65
- ┌────────┼────────┐
66
- │ │ │
67
- ┌────┴───┐ ┌──┴───┐ ┌──┴───┐
68
- │Worker 1│ │Worker│ │Worker│
69
- │Mac Mini│ │ VPS │ │ AWS │
70
- │Agent A │ │AgentB│ │AgentC│
71
- │Agent D │ │AgentE│ │AgentF│
72
- └────────┘ └──────┘ └──────┘
73
- </pre>
74
- </div>
75
-
76
- <h3>Key Concepts</h3>
77
- <table>
78
- <tr><th>Term</th><th>Description</th></tr>
79
- <tr><td><strong>Control Plane</strong></td><td>The central enterprise server running the dashboard, API, and database. One per deployment.</td></tr>
80
- <tr><td><strong>Worker Node</strong></td><td>Any machine running one or more agent processes. Reports to the control plane via HTTP.</td></tr>
81
- <tr><td><strong>Node ID</strong></td><td>Unique identifier for each worker node (e.g., "mac-mini-office", "aws-us-east-1").</td></tr>
82
- <tr><td><strong>Heartbeat</strong></td><td>Periodic HTTP POST from worker to control plane (every 30 seconds). Proves the node is alive.</td></tr>
83
- <tr><td><strong>Stale Threshold</strong></td><td>If no heartbeat received for 90 seconds, node is marked offline.</td></tr>
84
- <tr><td><strong>Capabilities</strong></td><td>Tags describing what the node can do: "browser", "voice", "gpu", "docker".</td></tr>
85
- </table>
86
-
87
- <h2 id="adding-nodes">Adding Worker Nodes</h2>
88
- <p>There are <strong>3 ways</strong> to add a worker node, all from the dashboard UI:</p>
89
-
90
- <h3 id="manual">Method 1: Manual Registration</h3>
91
- <p>Best for: Machines that already have AgenticMail installed and running.</p>
92
- <ol>
93
- <li>Go to <strong>Operations &gt; Cluster</strong> in the sidebar</li>
94
- <li>Click <strong>Add Worker Node</strong></li>
95
- <li>Select the <strong>Manual Registration</strong> tab</li>
96
- <li>Enter the node name, host IP/hostname, and port</li>
97
- <li>Click <strong>Test Connection</strong> to verify reachability</li>
98
- <li>Click <strong>Add Node</strong></li>
99
- </ol>
100
- <p>The node will appear in the cluster and start receiving heartbeats when the agent process has <code>WORKER_NODE_ID</code> set.</p>
101
-
102
- <h3 id="ssh">Method 2: SSH Deploy</h3>
103
- <p>Best for: Fresh machines where you want the dashboard to handle everything.</p>
104
- <ol>
105
- <li>Click <strong>Add Worker Node</strong> &gt; <strong>Deploy via SSH</strong> tab</li>
106
- <li>Enter the SSH host, username, and optionally paste a private key</li>
107
- <li>Optionally specify which agent IDs to deploy</li>
108
- <li>Click <strong>Deploy Worker</strong></li>
109
- </ol>
110
- <p>The dashboard will SSH into the machine, install Node.js, PM2, and AgenticMail, write the environment file, and start the agent processes. The node auto-registers on startup.</p>
111
-
112
- <div class="docs-note">
113
- <strong>Note:</strong> SSH deploy requires the dashboard server to have network access to the target machine on port 22. For cloud instances, make sure the security group allows SSH from the dashboard's IP.
114
- </div>
115
-
116
- <h3 id="script">Method 3: Setup Script</h3>
117
- <p>Best for: Machines you can't SSH into from the dashboard (firewalled, air-gapped, or you prefer manual control).</p>
118
- <ol>
119
- <li>Click <strong>Add Worker Node</strong> &gt; <strong>Setup Script</strong> tab</li>
120
- <li>Enter a name and port</li>
121
- <li>Click <strong>Generate Setup Script</strong></li>
122
- <li>Copy the script</li>
123
- <li>SSH into the target machine yourself and paste/run the script</li>
124
- <li>Edit <code>~/.agenticmail/worker.env</code> to set your <code>DATABASE_URL</code></li>
125
- <li>Start agents with <code>pm2 start "agenticmail-enterprise agent --id &lt;ID&gt;"</code></li>
126
- </ol>
127
-
128
- <h2 id="env-vars">Environment Variables</h2>
129
- <p>These environment variables control worker node behavior:</p>
130
- <table>
131
- <tr><th>Variable</th><th>Required</th><th>Description</th></tr>
132
- <tr><td><code>ENTERPRISE_URL</code></td><td>Yes</td><td>Full URL of the control plane (e.g., <code>https://acme.agenticmail.io</code>)</td></tr>
133
- <tr><td><code>WORKER_NODE_ID</code></td><td>Yes*</td><td>Unique node identifier. Triggers auto-registration on startup. <em>*Required for cluster mode.</em></td></tr>
134
- <tr><td><code>WORKER_NAME</code></td><td>No</td><td>Human-readable name shown in dashboard. Defaults to system hostname.</td></tr>
135
- <tr><td><code>WORKER_HOST</code></td><td>No</td><td>IP/hostname the control plane should use to reach this node. Defaults to "localhost".</td></tr>
136
- <tr><td><code>WORKER_CAPABILITIES</code></td><td>No</td><td>Comma-separated capabilities: "browser,voice,gpu,docker"</td></tr>
137
- <tr><td><code>DATABASE_URL</code></td><td>Yes</td><td>Same database as the control plane (shared Postgres)</td></tr>
138
- <tr><td><code>PORT</code></td><td>No</td><td>Agent API port (default: 3101)</td></tr>
139
- <tr><td><code>LOG_LEVEL</code></td><td>No</td><td>Set to "warn" for production noise suppression</td></tr>
140
- </table>
141
-
142
- <h2 id="monitoring">Monitoring & Health</h2>
143
- <h3>Real-Time Status</h3>
144
- <p>The Cluster page shows live status for every node via Server-Sent Events (SSE). No polling — updates appear instantly when:</p>
145
- <ul>
146
- <li>A node registers or re-registers</li>
147
- <li>A heartbeat is received (every 30s)</li>
148
- <li>A node goes offline (no heartbeat for 90s)</li>
149
- <li>Node agent list changes</li>
150
- </ul>
151
-
152
- <h3>Node Statuses</h3>
153
- <table>
154
- <tr><th>Status</th><th>Color</th><th>Meaning</th></tr>
155
- <tr><td>online</td><td style="color: #22c55e;">Green</td><td>Node is reachable and heartbeating normally</td></tr>
156
- <tr><td>degraded</td><td style="color: #f59e0b;">Orange</td><td>Node is reachable but reporting issues</td></tr>
157
- <tr><td>offline</td><td style="color: #6b7280;">Gray</td><td>No heartbeat for 90+ seconds</td></tr>
158
- </table>
159
-
160
- <h3>Stats Cards</h3>
161
- <p>The top of the Cluster page shows aggregate stats:</p>
162
- <ul>
163
- <li><strong>Total Nodes</strong> — All registered nodes (online + offline)</li>
164
- <li><strong>Online</strong> — Currently heartbeating nodes</li>
165
- <li><strong>Running Agents</strong> — Total agents across all online nodes</li>
166
- <li><strong>Total CPUs</strong> — Aggregate CPU cores across online nodes</li>
167
- <li><strong>Total Memory</strong> — Aggregate RAM across online nodes</li>
168
- </ul>
169
-
170
- <h2 id="node-detail">Node Detail & Actions</h2>
171
- <p>Click any node card to see full details:</p>
172
- <ul>
173
- <li><strong>Platform info</strong> — OS, architecture, CPU count, memory</li>
174
- <li><strong>Agent list</strong> — All agents running on this node with names and roles</li>
175
- <li><strong>Capabilities</strong> — What the node supports (browser, voice, etc.)</li>
176
- <li><strong>Ping</strong> — Test connection from dashboard to node (shows latency)</li>
177
- <li><strong>Restart Agents</strong> — Send restart signal to all agents on this node</li>
178
- </ul>
179
-
180
- <h2 id="load-balancing">Load Balancing</h2>
181
- <p>When deploying a new agent, the system can automatically select the best node:</p>
182
- <ul>
183
- <li><strong>Least-loaded</strong> — Node with fewest running agents</li>
184
- <li><strong>Capability-matching</strong> — If the agent needs "voice" or "browser", only nodes with those capabilities are considered</li>
185
- <li><strong>API endpoint</strong>: <code>GET /api/engine/cluster/best-node?capabilities=voice,browser</code></li>
186
- </ul>
187
-
188
- <h2 id="database">Database Sharing</h2>
189
- <p>All worker nodes <strong>must connect to the same database</strong> as the control plane. This is how agents share state, memory, tasks, and configuration.</p>
190
- <div class="docs-note">
191
- <strong>Recommended:</strong> Use a cloud-hosted PostgreSQL (Supabase, Neon, AWS RDS) accessible from all nodes. SQLite does NOT work for multi-node clusters.
192
- </div>
193
- <p>Connection pool settings are auto-optimized per node via the <code>smartDbConfig()</code> helper. Each node maintains its own small connection pool (3 connections max).</p>
194
-
195
- <h2 id="networking">Networking Requirements</h2>
196
- <table>
197
- <tr><th>Direction</th><th>From</th><th>To</th><th>Port</th><th>Purpose</th></tr>
198
- <tr><td>Outbound</td><td>Worker Node</td><td>Control Plane</td><td>3100 (or custom)</td><td>Heartbeats, status updates, task webhooks</td></tr>
199
- <tr><td>Outbound</td><td>Worker Node</td><td>Database</td><td>5432 (Postgres)</td><td>Shared database connection</td></tr>
200
- <tr><td>Inbound</td><td>Control Plane</td><td>Worker Node</td><td>3101 (or custom)</td><td>Health checks, ping, restart commands</td></tr>
201
- <tr><td>Outbound</td><td>Control Plane</td><td>Worker Node</td><td>22 (SSH)</td><td>Only for SSH deploy method</td></tr>
202
- </table>
203
- <p>If nodes are behind NAT or firewalls, only outbound from worker to control plane is strictly required. The test-connection and restart features need inbound access.</p>
204
-
205
- <h2 id="security">Security Considerations</h2>
206
- <ul>
207
- <li><strong>No authentication on cluster API (yet)</strong> — The heartbeat and status endpoints are unauthenticated for simplicity. Only expose the control plane's API behind a reverse proxy with authentication, or restrict by IP.</li>
208
- <li><strong>SSH keys</strong> — For SSH deploy, keys are used once and not persisted. Prefer SSH agent forwarding or temporary keys.</li>
209
- <li><strong>Database credentials</strong> — Each worker node needs <code>DATABASE_URL</code>. Use environment variables, never commit credentials.</li>
210
- <li><strong>TLS</strong> — Use HTTPS between workers and control plane in production. Set <code>ENTERPRISE_URL=https://...</code>.</li>
211
- <li><strong>Network segmentation</strong> — Place worker nodes and control plane on the same VPN/VPC for internal traffic.</li>
212
- </ul>
213
-
214
- <h2 id="edge-cases">Edge Cases & Troubleshooting</h2>
215
-
216
- <h3>Node keeps showing "offline"</h3>
217
- <ul>
218
- <li>Check <code>ENTERPRISE_URL</code> is correct and reachable from the worker</li>
219
- <li>Check <code>WORKER_NODE_ID</code> is set in the agent's environment</li>
220
- <li>Check firewall rules — worker must be able to POST to <code>ENTERPRISE_URL/api/engine/cluster/heartbeat/...</code></li>
221
- <li>Check agent logs: <code>pm2 logs agent-name</code></li>
222
- </ul>
223
-
224
- <h3>Duplicate node IDs</h3>
225
- <p>If two machines use the same <code>WORKER_NODE_ID</code>, they'll overwrite each other's registration. Use unique IDs per machine.</p>
226
-
227
- <h3>Agent appears on wrong node</h3>
228
- <p>Each agent process reports its <code>WORKER_NODE_ID</code> on startup. If you move an agent between machines, restart it on the new machine — it will re-register under the new node.</p>
229
-
230
- <h3>Control plane restarts</h3>
231
- <p>All node data is persisted in the <code>cluster_nodes</code> database table. On restart, nodes load from DB as "offline" and transition to "online" when the next heartbeat arrives (within 30s).</p>
232
-
233
- <h3>Worker restarts</h3>
234
- <p>PM2 auto-restarts crashed agent processes. On restart, the agent re-registers with the control plane within seconds.</p>
235
-
236
- <h3>Network partition</h3>
237
- <p>If a worker loses connectivity to the control plane, it continues running agents normally. It just stops reporting status. When connectivity resumes, the next heartbeat restores the "online" status.</p>
238
-
239
- <h3>Database failover</h3>
240
- <p>All nodes connect to the same database. If the database goes down, all nodes are affected. Use a cloud provider with automatic failover (Supabase, Neon, RDS Multi-AZ).</p>
241
-
242
- <h2 id="api">API Reference</h2>
243
- <table>
244
- <tr><th>Method</th><th>Endpoint</th><th>Description</th></tr>
245
- <tr><td>GET</td><td><code>/api/engine/cluster/nodes</code></td><td>List all nodes + cluster stats</td></tr>
246
- <tr><td>GET</td><td><code>/api/engine/cluster/nodes/:nodeId</code></td><td>Get specific node</td></tr>
247
- <tr><td>POST</td><td><code>/api/engine/cluster/register</code></td><td>Register a worker node</td></tr>
248
- <tr><td>POST</td><td><code>/api/engine/cluster/heartbeat/:nodeId</code></td><td>Worker heartbeat</td></tr>
249
- <tr><td>DELETE</td><td><code>/api/engine/cluster/nodes/:nodeId</code></td><td>Remove a node</td></tr>
250
- <tr><td>GET</td><td><code>/api/engine/cluster/best-node</code></td><td>Find best node for deployment</td></tr>
251
- <tr><td>POST</td><td><code>/api/engine/cluster/test-connection</code></td><td>Test connectivity to a node</td></tr>
252
- <tr><td>POST</td><td><code>/api/engine/cluster/deploy-via-ssh</code></td><td>Deploy worker via SSH</td></tr>
253
- <tr><td>POST</td><td><code>/api/engine/cluster/nodes/:nodeId/restart</code></td><td>Restart agents on a node</td></tr>
254
- <tr><td>GET</td><td><code>/api/engine/cluster/stream</code></td><td>SSE stream of cluster events</td></tr>
255
- </table>
256
-
257
- <h3>Register Node (POST /api/engine/cluster/register)</h3>
258
- <pre>
259
- {
260
- "nodeId": "mac-mini-office", // Required, unique, 2-64 chars, alphanumeric + .-_
261
- "name": "Office Mac Mini", // Optional display name
262
- "host": "192.168.1.50", // Required, IP or hostname
263
- "port": 3101, // Required, 1-65535
264
- "platform": "darwin", // Optional, auto-detected
265
- "arch": "arm64", // Optional, auto-detected
266
- "cpuCount": 10, // Optional, auto-detected
267
- "memoryMb": 16384, // Optional, auto-detected
268
- "version": "0.5.324", // Optional
269
- "agents": ["agent-uuid-1"], // Optional, list of agent IDs
270
- "capabilities": ["browser", "voice"] // Optional
271
- }
272
- </pre>
273
-
274
- <h3>Heartbeat (POST /api/engine/cluster/heartbeat/:nodeId)</h3>
275
- <pre>
276
- {
277
- "agents": ["agent-uuid-1"], // Current agent list
278
- "cpuUsage": 0.45, // Optional, 0-1
279
- "memoryUsage": 0.62 // Optional, 0-1
280
- }
281
- </pre>
282
-
283
- </div>
284
- </body>
285
- </html>