@agenticmail/enterprise 0.5.326 → 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 (868) hide show
  1. package/dist/dashboard/app.js +1 -1
  2. package/dist/dashboard/pages/cluster.js +1 -1
  3. package/logs/cloudflared-error.log +6 -0
  4. package/logs/enterprise-out.log +2 -0
  5. package/package.json +1 -1
  6. package/god_is_great.html +0 -35
  7. package/src/admin/page-registry.ts +0 -290
  8. package/src/admin/routes.ts +0 -2968
  9. package/src/agent-tools/common.ts +0 -260
  10. package/src/agent-tools/index.ts +0 -542
  11. package/src/agent-tools/merge.ts +0 -62
  12. package/src/agent-tools/middleware.ts +0 -436
  13. package/src/agent-tools/schema/typebox.ts +0 -25
  14. package/src/agent-tools/security.ts +0 -352
  15. package/src/agent-tools/tool-resolver.ts +0 -1018
  16. package/src/agent-tools/tools/agenticmail.ts +0 -1017
  17. package/src/agent-tools/tools/bash.ts +0 -179
  18. package/src/agent-tools/tools/browser-tool.schema.ts +0 -112
  19. package/src/agent-tools/tools/browser-tool.ts +0 -388
  20. package/src/agent-tools/tools/browser.ts +0 -764
  21. package/src/agent-tools/tools/edit.ts +0 -100
  22. package/src/agent-tools/tools/enterprise-code-sandbox.ts +0 -395
  23. package/src/agent-tools/tools/enterprise-database.ts +0 -377
  24. package/src/agent-tools/tools/enterprise-diff.ts +0 -580
  25. package/src/agent-tools/tools/enterprise-documents.ts +0 -896
  26. package/src/agent-tools/tools/enterprise-http.ts +0 -485
  27. package/src/agent-tools/tools/enterprise-security-scan.ts +0 -528
  28. package/src/agent-tools/tools/enterprise-spreadsheet.ts +0 -825
  29. package/src/agent-tools/tools/glob.ts +0 -129
  30. package/src/agent-tools/tools/google/calendar.ts +0 -230
  31. package/src/agent-tools/tools/google/chat.ts +0 -725
  32. package/src/agent-tools/tools/google/contacts.ts +0 -209
  33. package/src/agent-tools/tools/google/docs.ts +0 -162
  34. package/src/agent-tools/tools/google/drive.ts +0 -392
  35. package/src/agent-tools/tools/google/forms.ts +0 -367
  36. package/src/agent-tools/tools/google/gmail.ts +0 -897
  37. package/src/agent-tools/tools/google/index.ts +0 -86
  38. package/src/agent-tools/tools/google/maps.ts +0 -543
  39. package/src/agent-tools/tools/google/meeting-voice.ts +0 -885
  40. package/src/agent-tools/tools/google/meetings.ts +0 -1094
  41. package/src/agent-tools/tools/google/sheets.ts +0 -215
  42. package/src/agent-tools/tools/google/slides.ts +0 -559
  43. package/src/agent-tools/tools/google/tasks.ts +0 -200
  44. package/src/agent-tools/tools/grep.ts +0 -178
  45. package/src/agent-tools/tools/integrations/_factory.ts +0 -102
  46. package/src/agent-tools/tools/integrations/activecampaign.ts +0 -14
  47. package/src/agent-tools/tools/integrations/adobe-sign.ts +0 -14
  48. package/src/agent-tools/tools/integrations/adp.ts +0 -14
  49. package/src/agent-tools/tools/integrations/airtable.ts +0 -14
  50. package/src/agent-tools/tools/integrations/apollo.ts +0 -14
  51. package/src/agent-tools/tools/integrations/asana.ts +0 -14
  52. package/src/agent-tools/tools/integrations/auth0.ts +0 -14
  53. package/src/agent-tools/tools/integrations/aws.ts +0 -14
  54. package/src/agent-tools/tools/integrations/azure-devops.ts +0 -14
  55. package/src/agent-tools/tools/integrations/bamboohr.ts +0 -14
  56. package/src/agent-tools/tools/integrations/basecamp.ts +0 -14
  57. package/src/agent-tools/tools/integrations/bigcommerce.ts +0 -14
  58. package/src/agent-tools/tools/integrations/bitbucket.ts +0 -14
  59. package/src/agent-tools/tools/integrations/box.ts +0 -14
  60. package/src/agent-tools/tools/integrations/brex.ts +0 -14
  61. package/src/agent-tools/tools/integrations/buffer.ts +0 -14
  62. package/src/agent-tools/tools/integrations/calendly.ts +0 -14
  63. package/src/agent-tools/tools/integrations/canva.ts +0 -14
  64. package/src/agent-tools/tools/integrations/chargebee.ts +0 -14
  65. package/src/agent-tools/tools/integrations/circleci.ts +0 -14
  66. package/src/agent-tools/tools/integrations/clickup.ts +0 -14
  67. package/src/agent-tools/tools/integrations/close.ts +0 -14
  68. package/src/agent-tools/tools/integrations/cloudflare.ts +0 -14
  69. package/src/agent-tools/tools/integrations/confluence.ts +0 -14
  70. package/src/agent-tools/tools/integrations/contentful.ts +0 -14
  71. package/src/agent-tools/tools/integrations/copper.ts +0 -14
  72. package/src/agent-tools/tools/integrations/crisp.ts +0 -14
  73. package/src/agent-tools/tools/integrations/crowdstrike.ts +0 -14
  74. package/src/agent-tools/tools/integrations/datadog.ts +0 -14
  75. package/src/agent-tools/tools/integrations/digitalocean.ts +0 -14
  76. package/src/agent-tools/tools/integrations/discord.ts +0 -14
  77. package/src/agent-tools/tools/integrations/docker.ts +0 -14
  78. package/src/agent-tools/tools/integrations/docusign.ts +0 -14
  79. package/src/agent-tools/tools/integrations/drift.ts +0 -14
  80. package/src/agent-tools/tools/integrations/dropbox.ts +0 -14
  81. package/src/agent-tools/tools/integrations/figma.ts +0 -14
  82. package/src/agent-tools/tools/integrations/firebase.ts +0 -14
  83. package/src/agent-tools/tools/integrations/flyio.ts +0 -14
  84. package/src/agent-tools/tools/integrations/freshbooks.ts +0 -14
  85. package/src/agent-tools/tools/integrations/freshdesk.ts +0 -14
  86. package/src/agent-tools/tools/integrations/freshsales.ts +0 -14
  87. package/src/agent-tools/tools/integrations/freshservice.ts +0 -14
  88. package/src/agent-tools/tools/integrations/front.ts +0 -14
  89. package/src/agent-tools/tools/integrations/github-actions.ts +0 -14
  90. package/src/agent-tools/tools/integrations/github.ts +0 -14
  91. package/src/agent-tools/tools/integrations/gitlab.ts +0 -14
  92. package/src/agent-tools/tools/integrations/gong.ts +0 -14
  93. package/src/agent-tools/tools/integrations/google-ads.ts +0 -14
  94. package/src/agent-tools/tools/integrations/google-analytics.ts +0 -14
  95. package/src/agent-tools/tools/integrations/google-cloud.ts +0 -14
  96. package/src/agent-tools/tools/integrations/gotomeeting.ts +0 -14
  97. package/src/agent-tools/tools/integrations/grafana.ts +0 -14
  98. package/src/agent-tools/tools/integrations/greenhouse.ts +0 -14
  99. package/src/agent-tools/tools/integrations/gusto.ts +0 -14
  100. package/src/agent-tools/tools/integrations/hashicorp-vault.ts +0 -14
  101. package/src/agent-tools/tools/integrations/heroku.ts +0 -14
  102. package/src/agent-tools/tools/integrations/hibob.ts +0 -14
  103. package/src/agent-tools/tools/integrations/hootsuite.ts +0 -14
  104. package/src/agent-tools/tools/integrations/hubspot.ts +0 -14
  105. package/src/agent-tools/tools/integrations/huggingface.ts +0 -14
  106. package/src/agent-tools/tools/integrations/index.ts +0 -474
  107. package/src/agent-tools/tools/integrations/intercom.ts +0 -14
  108. package/src/agent-tools/tools/integrations/jira.ts +0 -14
  109. package/src/agent-tools/tools/integrations/klaviyo.ts +0 -14
  110. package/src/agent-tools/tools/integrations/kubernetes.ts +0 -14
  111. package/src/agent-tools/tools/integrations/lattice.ts +0 -14
  112. package/src/agent-tools/tools/integrations/launchdarkly.ts +0 -14
  113. package/src/agent-tools/tools/integrations/lever.ts +0 -14
  114. package/src/agent-tools/tools/integrations/linear.ts +0 -14
  115. package/src/agent-tools/tools/integrations/linkedin.ts +0 -14
  116. package/src/agent-tools/tools/integrations/livechat.ts +0 -14
  117. package/src/agent-tools/tools/integrations/loom.ts +0 -14
  118. package/src/agent-tools/tools/integrations/mailchimp.ts +0 -14
  119. package/src/agent-tools/tools/integrations/mailgun.ts +0 -14
  120. package/src/agent-tools/tools/integrations/miro.ts +0 -14
  121. package/src/agent-tools/tools/integrations/mixpanel.ts +0 -14
  122. package/src/agent-tools/tools/integrations/monday.ts +0 -14
  123. package/src/agent-tools/tools/integrations/mongodb-atlas.ts +0 -14
  124. package/src/agent-tools/tools/integrations/neon.ts +0 -14
  125. package/src/agent-tools/tools/integrations/netlify.ts +0 -14
  126. package/src/agent-tools/tools/integrations/netsuite.ts +0 -14
  127. package/src/agent-tools/tools/integrations/newrelic.ts +0 -14
  128. package/src/agent-tools/tools/integrations/notion.ts +0 -14
  129. package/src/agent-tools/tools/integrations/okta.ts +0 -14
  130. package/src/agent-tools/tools/integrations/openai.ts +0 -14
  131. package/src/agent-tools/tools/integrations/opsgenie.ts +0 -14
  132. package/src/agent-tools/tools/integrations/outreach.ts +0 -14
  133. package/src/agent-tools/tools/integrations/paddle.ts +0 -14
  134. package/src/agent-tools/tools/integrations/pagerduty.ts +0 -14
  135. package/src/agent-tools/tools/integrations/pandadoc.ts +0 -14
  136. package/src/agent-tools/tools/integrations/paypal.ts +0 -14
  137. package/src/agent-tools/tools/integrations/personio.ts +0 -14
  138. package/src/agent-tools/tools/integrations/pinecone.ts +0 -14
  139. package/src/agent-tools/tools/integrations/pipedrive.ts +0 -14
  140. package/src/agent-tools/tools/integrations/plaid.ts +0 -14
  141. package/src/agent-tools/tools/integrations/postmark.ts +0 -14
  142. package/src/agent-tools/tools/integrations/power-automate.ts +0 -14
  143. package/src/agent-tools/tools/integrations/quickbooks.ts +0 -14
  144. package/src/agent-tools/tools/integrations/recurly.ts +0 -14
  145. package/src/agent-tools/tools/integrations/reddit.ts +0 -14
  146. package/src/agent-tools/tools/integrations/render.ts +0 -14
  147. package/src/agent-tools/tools/integrations/ringcentral.ts +0 -14
  148. package/src/agent-tools/tools/integrations/rippling.ts +0 -14
  149. package/src/agent-tools/tools/integrations/salesforce.ts +0 -14
  150. package/src/agent-tools/tools/integrations/salesloft.ts +0 -14
  151. package/src/agent-tools/tools/integrations/sanity.ts +0 -14
  152. package/src/agent-tools/tools/integrations/sap.ts +0 -14
  153. package/src/agent-tools/tools/integrations/segment.ts +0 -14
  154. package/src/agent-tools/tools/integrations/sendgrid.ts +0 -14
  155. package/src/agent-tools/tools/integrations/sentry.ts +0 -14
  156. package/src/agent-tools/tools/integrations/servicenow.ts +0 -14
  157. package/src/agent-tools/tools/integrations/shopify.ts +0 -14
  158. package/src/agent-tools/tools/integrations/shortcut.ts +0 -14
  159. package/src/agent-tools/tools/integrations/slack.ts +0 -14
  160. package/src/agent-tools/tools/integrations/smartsheet.ts +0 -14
  161. package/src/agent-tools/tools/integrations/snowflake.ts +0 -14
  162. package/src/agent-tools/tools/integrations/snyk.ts +0 -14
  163. package/src/agent-tools/tools/integrations/splunk.ts +0 -14
  164. package/src/agent-tools/tools/integrations/square.ts +0 -14
  165. package/src/agent-tools/tools/integrations/statuspage.ts +0 -14
  166. package/src/agent-tools/tools/integrations/stripe.ts +0 -14
  167. package/src/agent-tools/tools/integrations/supabase.ts +0 -14
  168. package/src/agent-tools/tools/integrations/teamwork.ts +0 -14
  169. package/src/agent-tools/tools/integrations/telegram.ts +0 -14
  170. package/src/agent-tools/tools/integrations/terraform.ts +0 -14
  171. package/src/agent-tools/tools/integrations/todoist.ts +0 -14
  172. package/src/agent-tools/tools/integrations/trello.ts +0 -14
  173. package/src/agent-tools/tools/integrations/twilio.ts +0 -14
  174. package/src/agent-tools/tools/integrations/twitter.ts +0 -14
  175. package/src/agent-tools/tools/integrations/vercel.ts +0 -14
  176. package/src/agent-tools/tools/integrations/weaviate.ts +0 -14
  177. package/src/agent-tools/tools/integrations/webex.ts +0 -14
  178. package/src/agent-tools/tools/integrations/webflow.ts +0 -14
  179. package/src/agent-tools/tools/integrations/whatsapp.ts +0 -14
  180. package/src/agent-tools/tools/integrations/whereby.ts +0 -14
  181. package/src/agent-tools/tools/integrations/woocommerce.ts +0 -14
  182. package/src/agent-tools/tools/integrations/wordpress.ts +0 -14
  183. package/src/agent-tools/tools/integrations/workday.ts +0 -14
  184. package/src/agent-tools/tools/integrations/wrike.ts +0 -14
  185. package/src/agent-tools/tools/integrations/xero.ts +0 -14
  186. package/src/agent-tools/tools/integrations/youtube.ts +0 -14
  187. package/src/agent-tools/tools/integrations/zendesk.ts +0 -14
  188. package/src/agent-tools/tools/integrations/zoho-crm.ts +0 -14
  189. package/src/agent-tools/tools/integrations/zoom.ts +0 -14
  190. package/src/agent-tools/tools/integrations/zuora.ts +0 -14
  191. package/src/agent-tools/tools/knowledge-search.ts +0 -318
  192. package/src/agent-tools/tools/local/coding.ts +0 -626
  193. package/src/agent-tools/tools/local/dependency-manager.ts +0 -647
  194. package/src/agent-tools/tools/local/file-edit.ts +0 -31
  195. package/src/agent-tools/tools/local/file-list.ts +0 -39
  196. package/src/agent-tools/tools/local/file-ops.ts +0 -48
  197. package/src/agent-tools/tools/local/file-read.ts +0 -39
  198. package/src/agent-tools/tools/local/file-search.ts +0 -46
  199. package/src/agent-tools/tools/local/file-write.ts +0 -28
  200. package/src/agent-tools/tools/local/filesystem.ts +0 -5
  201. package/src/agent-tools/tools/local/index.ts +0 -55
  202. package/src/agent-tools/tools/local/resolve-path.ts +0 -18
  203. package/src/agent-tools/tools/local/shell.ts +0 -277
  204. package/src/agent-tools/tools/local/system-info.ts +0 -29
  205. package/src/agent-tools/tools/management.ts +0 -425
  206. package/src/agent-tools/tools/mcp-bridge.ts +0 -142
  207. package/src/agent-tools/tools/mcp-server-tools.ts +0 -91
  208. package/src/agent-tools/tools/meeting-lifecycle.ts +0 -438
  209. package/src/agent-tools/tools/memory.ts +0 -509
  210. package/src/agent-tools/tools/messaging/index.ts +0 -6
  211. package/src/agent-tools/tools/messaging/telegram.ts +0 -167
  212. package/src/agent-tools/tools/messaging/whatsapp.ts +0 -651
  213. package/src/agent-tools/tools/microsoft/contacts.ts +0 -176
  214. package/src/agent-tools/tools/microsoft/excel-vba.ts +0 -331
  215. package/src/agent-tools/tools/microsoft/excel.ts +0 -261
  216. package/src/agent-tools/tools/microsoft/graph-api.ts +0 -161
  217. package/src/agent-tools/tools/microsoft/index.ts +0 -95
  218. package/src/agent-tools/tools/microsoft/onedrive.ts +0 -429
  219. package/src/agent-tools/tools/microsoft/onenote.ts +0 -186
  220. package/src/agent-tools/tools/microsoft/outlook-calendar.ts +0 -286
  221. package/src/agent-tools/tools/microsoft/outlook-mail.ts +0 -723
  222. package/src/agent-tools/tools/microsoft/planner.ts +0 -200
  223. package/src/agent-tools/tools/microsoft/powerbi.ts +0 -266
  224. package/src/agent-tools/tools/microsoft/powerpoint.ts +0 -186
  225. package/src/agent-tools/tools/microsoft/sharepoint.ts +0 -328
  226. package/src/agent-tools/tools/microsoft/teams.ts +0 -463
  227. package/src/agent-tools/tools/microsoft/todo.ts +0 -181
  228. package/src/agent-tools/tools/oauth-token-provider.ts +0 -101
  229. package/src/agent-tools/tools/read.ts +0 -160
  230. package/src/agent-tools/tools/visual-memory/capture.ts +0 -217
  231. package/src/agent-tools/tools/visual-memory/diff.ts +0 -283
  232. package/src/agent-tools/tools/visual-memory/index.ts +0 -698
  233. package/src/agent-tools/tools/visual-memory/phash.ts +0 -120
  234. package/src/agent-tools/tools/visual-memory/similarity.ts +0 -354
  235. package/src/agent-tools/tools/visual-memory/storage.ts +0 -534
  236. package/src/agent-tools/tools/visual-memory/types.ts +0 -100
  237. package/src/agent-tools/tools/web-fetch-utils.ts +0 -202
  238. package/src/agent-tools/tools/web-fetch.ts +0 -464
  239. package/src/agent-tools/tools/web-search.ts +0 -480
  240. package/src/agent-tools/tools/web-shared.ts +0 -232
  241. package/src/agent-tools/tools/write.ts +0 -68
  242. package/src/agent-tools/types.ts +0 -214
  243. package/src/agenticmail/index.ts +0 -34
  244. package/src/agenticmail/manager.ts +0 -253
  245. package/src/agenticmail/providers/google.ts +0 -391
  246. package/src/agenticmail/providers/imap.ts +0 -454
  247. package/src/agenticmail/providers/index.ts +0 -28
  248. package/src/agenticmail/providers/microsoft.ts +0 -260
  249. package/src/agenticmail/types.ts +0 -173
  250. package/src/auth/routes.ts +0 -1589
  251. package/src/browser/bridge-auth-registry.ts +0 -34
  252. package/src/browser/bridge-server.ts +0 -93
  253. package/src/browser/cdp.helpers.ts +0 -180
  254. package/src/browser/cdp.ts +0 -466
  255. package/src/browser/chrome.executables.ts +0 -625
  256. package/src/browser/chrome.profile-decoration.ts +0 -198
  257. package/src/browser/chrome.ts +0 -349
  258. package/src/browser/client-actions-core.ts +0 -259
  259. package/src/browser/client-actions-observe.ts +0 -184
  260. package/src/browser/client-actions-state.ts +0 -284
  261. package/src/browser/client-actions-types.ts +0 -16
  262. package/src/browser/client-actions-url.ts +0 -11
  263. package/src/browser/client-actions.ts +0 -4
  264. package/src/browser/client-fetch.ts +0 -253
  265. package/src/browser/client.ts +0 -337
  266. package/src/browser/config.ts +0 -301
  267. package/src/browser/constants.ts +0 -8
  268. package/src/browser/control-auth.ts +0 -94
  269. package/src/browser/control-service.ts +0 -81
  270. package/src/browser/csrf.ts +0 -87
  271. package/src/browser/enterprise-compat.ts +0 -562
  272. package/src/browser/extension-relay.ts +0 -834
  273. package/src/browser/http-auth.ts +0 -63
  274. package/src/browser/navigation-guard.ts +0 -50
  275. package/src/browser/paths.ts +0 -49
  276. package/src/browser/playwright.d.ts +0 -12
  277. package/src/browser/profiles-service.ts +0 -187
  278. package/src/browser/profiles.ts +0 -114
  279. package/src/browser/proxy-files.ts +0 -41
  280. package/src/browser/pw-ai-module.ts +0 -52
  281. package/src/browser/pw-ai-state.ts +0 -9
  282. package/src/browser/pw-ai.ts +0 -65
  283. package/src/browser/pw-role-snapshot.ts +0 -434
  284. package/src/browser/pw-session.ts +0 -810
  285. package/src/browser/pw-tools-core.activity.ts +0 -68
  286. package/src/browser/pw-tools-core.downloads.ts +0 -281
  287. package/src/browser/pw-tools-core.interactions.ts +0 -646
  288. package/src/browser/pw-tools-core.responses.ts +0 -124
  289. package/src/browser/pw-tools-core.shared.ts +0 -70
  290. package/src/browser/pw-tools-core.snapshot.ts +0 -213
  291. package/src/browser/pw-tools-core.state.ts +0 -209
  292. package/src/browser/pw-tools-core.storage.ts +0 -128
  293. package/src/browser/pw-tools-core.trace.ts +0 -37
  294. package/src/browser/pw-tools-core.ts +0 -8
  295. package/src/browser/resolved-config-refresh.ts +0 -59
  296. package/src/browser/routes/agent.act.shared.ts +0 -52
  297. package/src/browser/routes/agent.act.ts +0 -575
  298. package/src/browser/routes/agent.debug.ts +0 -149
  299. package/src/browser/routes/agent.shared.ts +0 -143
  300. package/src/browser/routes/agent.snapshot.ts +0 -333
  301. package/src/browser/routes/agent.storage.ts +0 -451
  302. package/src/browser/routes/agent.ts +0 -13
  303. package/src/browser/routes/basic.ts +0 -202
  304. package/src/browser/routes/dispatcher.ts +0 -126
  305. package/src/browser/routes/index.ts +0 -11
  306. package/src/browser/routes/path-output.ts +0 -1
  307. package/src/browser/routes/tabs.ts +0 -217
  308. package/src/browser/routes/types.ts +0 -26
  309. package/src/browser/routes/utils.ts +0 -73
  310. package/src/browser/screenshot.ts +0 -54
  311. package/src/browser/server-context.ts +0 -688
  312. package/src/browser/server-context.types.ts +0 -65
  313. package/src/browser/server-lifecycle.ts +0 -48
  314. package/src/browser/server-middleware.ts +0 -37
  315. package/src/browser/server.ts +0 -110
  316. package/src/browser/target-id.ts +0 -30
  317. package/src/browser/trash.ts +0 -21
  318. package/src/cli-agent.ts +0 -2452
  319. package/src/cli-reset-password.ts +0 -138
  320. package/src/cli-serve.ts +0 -314
  321. package/src/cli.ts +0 -103
  322. package/src/dashboard/HELP-TOOLTIPS-GUIDE.md +0 -45
  323. package/src/dashboard/app.js +0 -579
  324. package/src/dashboard/assets/brand-logos.js +0 -350
  325. package/src/dashboard/assets/icons/emoji-icons.js +0 -893
  326. package/src/dashboard/assets/logo.png +0 -0
  327. package/src/dashboard/assets/provider-logos.js +0 -139
  328. package/src/dashboard/components/error-boundary.js +0 -21
  329. package/src/dashboard/components/help-button.js +0 -65
  330. package/src/dashboard/components/icons.js +0 -64
  331. package/src/dashboard/components/knowledge-link.js +0 -79
  332. package/src/dashboard/components/modal.js +0 -125
  333. package/src/dashboard/components/org-switcher.js +0 -156
  334. package/src/dashboard/components/persona-fields.js +0 -460
  335. package/src/dashboard/components/settings-help.js +0 -193
  336. package/src/dashboard/components/tag-input.js +0 -96
  337. package/src/dashboard/components/timezones.js +0 -352
  338. package/src/dashboard/components/transport-encryption.js +0 -288
  339. package/src/dashboard/components/utils.js +0 -205
  340. package/src/dashboard/data/countries.js +0 -255
  341. package/src/dashboard/docs/activity.html +0 -253
  342. package/src/dashboard/docs/agent-activity.html +0 -199
  343. package/src/dashboard/docs/agent-autonomy.html +0 -161
  344. package/src/dashboard/docs/agent-budget.html +0 -190
  345. package/src/dashboard/docs/agent-channels.html +0 -189
  346. package/src/dashboard/docs/agent-communication.html +0 -171
  347. package/src/dashboard/docs/agent-configuration.html +0 -194
  348. package/src/dashboard/docs/agent-deployment.html +0 -323
  349. package/src/dashboard/docs/agent-email.html +0 -184
  350. package/src/dashboard/docs/agent-guardrails.html +0 -206
  351. package/src/dashboard/docs/agent-manager.html +0 -226
  352. package/src/dashboard/docs/agent-memory.html +0 -215
  353. package/src/dashboard/docs/agent-overview.html +0 -226
  354. package/src/dashboard/docs/agent-permissions.html +0 -305
  355. package/src/dashboard/docs/agent-personal.html +0 -155
  356. package/src/dashboard/docs/agent-security.html +0 -188
  357. package/src/dashboard/docs/agent-skills.html +0 -224
  358. package/src/dashboard/docs/agent-tool-security.html +0 -205
  359. package/src/dashboard/docs/agent-tools.html +0 -238
  360. package/src/dashboard/docs/agent-whatsapp.html +0 -210
  361. package/src/dashboard/docs/agent-workforce.html +0 -199
  362. package/src/dashboard/docs/agents.html +0 -258
  363. package/src/dashboard/docs/approvals.html +0 -200
  364. package/src/dashboard/docs/audit.html +0 -206
  365. package/src/dashboard/docs/browser-providers.html +0 -313
  366. package/src/dashboard/docs/cluster.html +0 -285
  367. package/src/dashboard/docs/community-skills.html +0 -253
  368. package/src/dashboard/docs/compliance.html +0 -221
  369. package/src/dashboard/docs/dashboard.html +0 -84
  370. package/src/dashboard/docs/database-access.html +0 -322
  371. package/src/dashboard/docs/dlp.html +0 -268
  372. package/src/dashboard/docs/docs-style.css +0 -26
  373. package/src/dashboard/docs/domain-status.html +0 -294
  374. package/src/dashboard/docs/guardrails.html +0 -265
  375. package/src/dashboard/docs/journal.html +0 -197
  376. package/src/dashboard/docs/knowledge-contributions.html +0 -286
  377. package/src/dashboard/docs/knowledge.html +0 -268
  378. package/src/dashboard/docs/memory-transfer.html +0 -311
  379. package/src/dashboard/docs/messages.html +0 -217
  380. package/src/dashboard/docs/multi-tenant.html +0 -311
  381. package/src/dashboard/docs/org-chart.html +0 -239
  382. package/src/dashboard/docs/organizations.html +0 -182
  383. package/src/dashboard/docs/roles.html +0 -195
  384. package/src/dashboard/docs/settings-network.html +0 -321
  385. package/src/dashboard/docs/settings-security.html +0 -347
  386. package/src/dashboard/docs/settings-tool-security.html +0 -176
  387. package/src/dashboard/docs/settings.html +0 -280
  388. package/src/dashboard/docs/skill-connections.html +0 -270
  389. package/src/dashboard/docs/skills.html +0 -206
  390. package/src/dashboard/docs/task-pipeline.html +0 -261
  391. package/src/dashboard/docs/transport-encryption.html +0 -359
  392. package/src/dashboard/docs/users.html +0 -225
  393. package/src/dashboard/docs/vault.html +0 -260
  394. package/src/dashboard/docs/workforce.html +0 -245
  395. package/src/dashboard/index.html +0 -444
  396. package/src/dashboard/pages/activity.js +0 -379
  397. package/src/dashboard/pages/agent-detail/activity.js +0 -277
  398. package/src/dashboard/pages/agent-detail/autonomy.js +0 -244
  399. package/src/dashboard/pages/agent-detail/budget.js +0 -269
  400. package/src/dashboard/pages/agent-detail/channels.js +0 -494
  401. package/src/dashboard/pages/agent-detail/communication.js +0 -296
  402. package/src/dashboard/pages/agent-detail/configuration.js +0 -882
  403. package/src/dashboard/pages/agent-detail/deployment.js +0 -958
  404. package/src/dashboard/pages/agent-detail/email.js +0 -674
  405. package/src/dashboard/pages/agent-detail/guardrails.js +0 -521
  406. package/src/dashboard/pages/agent-detail/index.js +0 -261
  407. package/src/dashboard/pages/agent-detail/manager.js +0 -357
  408. package/src/dashboard/pages/agent-detail/meeting-browser.js +0 -933
  409. package/src/dashboard/pages/agent-detail/memory.js +0 -368
  410. package/src/dashboard/pages/agent-detail/overview.js +0 -844
  411. package/src/dashboard/pages/agent-detail/permissions.js +0 -1163
  412. package/src/dashboard/pages/agent-detail/personal-details.js +0 -404
  413. package/src/dashboard/pages/agent-detail/security.js +0 -409
  414. package/src/dashboard/pages/agent-detail/shared.js +0 -85
  415. package/src/dashboard/pages/agent-detail/skills-section.js +0 -183
  416. package/src/dashboard/pages/agent-detail/tool-security.js +0 -380
  417. package/src/dashboard/pages/agent-detail/tools.js +0 -322
  418. package/src/dashboard/pages/agent-detail/whatsapp.js +0 -824
  419. package/src/dashboard/pages/agent-detail/workforce.js +0 -683
  420. package/src/dashboard/pages/agents.js +0 -1242
  421. package/src/dashboard/pages/approvals.js +0 -100
  422. package/src/dashboard/pages/audit.js +0 -198
  423. package/src/dashboard/pages/cluster.js +0 -512
  424. package/src/dashboard/pages/community-skills.js +0 -1219
  425. package/src/dashboard/pages/compliance.js +0 -475
  426. package/src/dashboard/pages/dashboard.js +0 -180
  427. package/src/dashboard/pages/database-access.js +0 -812
  428. package/src/dashboard/pages/dlp.js +0 -293
  429. package/src/dashboard/pages/domain-status.js +0 -951
  430. package/src/dashboard/pages/guardrails.js +0 -1035
  431. package/src/dashboard/pages/journal.js +0 -172
  432. package/src/dashboard/pages/knowledge-contributions.js +0 -1682
  433. package/src/dashboard/pages/knowledge-import.js +0 -455
  434. package/src/dashboard/pages/knowledge.js +0 -582
  435. package/src/dashboard/pages/login.js +0 -1056
  436. package/src/dashboard/pages/memory-transfer.js +0 -631
  437. package/src/dashboard/pages/messages.js +0 -303
  438. package/src/dashboard/pages/org-chart.js +0 -349
  439. package/src/dashboard/pages/organizations.js +0 -1081
  440. package/src/dashboard/pages/roles.js +0 -780
  441. package/src/dashboard/pages/settings.js +0 -3790
  442. package/src/dashboard/pages/skill-connections.js +0 -982
  443. package/src/dashboard/pages/skills.js +0 -879
  444. package/src/dashboard/pages/task-pipeline.js +0 -684
  445. package/src/dashboard/pages/users.js +0 -867
  446. package/src/dashboard/pages/vault.js +0 -791
  447. package/src/dashboard/pages/workforce.js +0 -851
  448. package/src/dashboard/vendor/react-dom.development.js +0 -29924
  449. package/src/dashboard/vendor/react-dom.production.min.js +0 -267
  450. package/src/dashboard/vendor/react.development.js +0 -3343
  451. package/src/dashboard/vendor/react.production.min.js +0 -31
  452. package/src/database-access/agent-tools.ts +0 -193
  453. package/src/database-access/connection-manager.ts +0 -1341
  454. package/src/database-access/index.ts +0 -21
  455. package/src/database-access/query-sanitizer.ts +0 -220
  456. package/src/database-access/routes.ts +0 -226
  457. package/src/database-access/types.ts +0 -226
  458. package/src/db/adapter.ts +0 -510
  459. package/src/db/dynamodb.ts +0 -454
  460. package/src/db/factory.ts +0 -129
  461. package/src/db/mongodb.ts +0 -360
  462. package/src/db/mysql.ts +0 -531
  463. package/src/db/postgres.ts +0 -863
  464. package/src/db/proxy.ts +0 -39
  465. package/src/db/resolve-driver.ts +0 -29
  466. package/src/db/sql-schema.ts +0 -124
  467. package/src/db/sqlite.ts +0 -493
  468. package/src/db/turso.ts +0 -470
  469. package/src/deploy/fly.ts +0 -368
  470. package/src/deploy/managed.ts +0 -235
  471. package/src/domain-lock/cli-recover.ts +0 -591
  472. package/src/domain-lock/cli-verify.ts +0 -190
  473. package/src/domain-lock/index.ts +0 -220
  474. package/src/engine/activity-routes.ts +0 -154
  475. package/src/engine/activity.ts +0 -568
  476. package/src/engine/agent-autonomy.ts +0 -974
  477. package/src/engine/agent-config.ts +0 -646
  478. package/src/engine/agent-heartbeat.ts +0 -720
  479. package/src/engine/agent-hierarchy.ts +0 -1064
  480. package/src/engine/agent-memory.ts +0 -806
  481. package/src/engine/agent-notify.ts +0 -50
  482. package/src/engine/agent-routes.ts +0 -2583
  483. package/src/engine/agent-status.ts +0 -311
  484. package/src/engine/ambient-memory.ts +0 -401
  485. package/src/engine/approvals.ts +0 -615
  486. package/src/engine/assets/thinking-hum.mp3 +0 -0
  487. package/src/engine/catalog-routes.ts +0 -232
  488. package/src/engine/chat-poller.ts +0 -913
  489. package/src/engine/chat-webhook-routes.ts +0 -304
  490. package/src/engine/cli-build-skill.ts +0 -285
  491. package/src/engine/cli-submit-skill.ts +0 -200
  492. package/src/engine/cli-validate.ts +0 -188
  493. package/src/engine/cluster.ts +0 -278
  494. package/src/engine/communication-routes.ts +0 -139
  495. package/src/engine/communication.ts +0 -765
  496. package/src/engine/community-registry.ts +0 -1529
  497. package/src/engine/community-routes.ts +0 -260
  498. package/src/engine/compliance-routes.ts +0 -133
  499. package/src/engine/compliance.ts +0 -1679
  500. package/src/engine/config-bus.ts +0 -103
  501. package/src/engine/db-adapter.ts +0 -1156
  502. package/src/engine/db-schema.ts +0 -1945
  503. package/src/engine/deploy-schema-routes.ts +0 -176
  504. package/src/engine/deployer.ts +0 -957
  505. package/src/engine/dlp-routes.ts +0 -101
  506. package/src/engine/dlp.ts +0 -410
  507. package/src/engine/email-poller.ts +0 -855
  508. package/src/engine/emoji.ts +0 -106
  509. package/src/engine/guardrail-routes.ts +0 -125
  510. package/src/engine/guardrails.ts +0 -465
  511. package/src/engine/index.ts +0 -255
  512. package/src/engine/journal-routes.ts +0 -56
  513. package/src/engine/journal.ts +0 -249
  514. package/src/engine/knowledge-contribution-routes.ts +0 -633
  515. package/src/engine/knowledge-contribution.ts +0 -1386
  516. package/src/engine/knowledge-import/chunker.ts +0 -241
  517. package/src/engine/knowledge-import/import-manager.ts +0 -416
  518. package/src/engine/knowledge-import/index.ts +0 -27
  519. package/src/engine/knowledge-import/processors/clean.ts +0 -149
  520. package/src/engine/knowledge-import/processors/extract-gdrive.ts +0 -102
  521. package/src/engine/knowledge-import/processors/extract-github.ts +0 -74
  522. package/src/engine/knowledge-import/processors/extract-sharepoint.ts +0 -69
  523. package/src/engine/knowledge-import/processors/extract-web.ts +0 -275
  524. package/src/engine/knowledge-import/processors/index.ts +0 -18
  525. package/src/engine/knowledge-import/processors/pipeline.ts +0 -171
  526. package/src/engine/knowledge-import/processors/types.ts +0 -78
  527. package/src/engine/knowledge-import/processors/validate.ts +0 -150
  528. package/src/engine/knowledge-import/provider-file-upload.ts +0 -95
  529. package/src/engine/knowledge-import/provider-github.ts +0 -144
  530. package/src/engine/knowledge-import/provider-google-sites.ts +0 -323
  531. package/src/engine/knowledge-import/provider-sharepoint.ts +0 -276
  532. package/src/engine/knowledge-import/provider-url.ts +0 -218
  533. package/src/engine/knowledge-import/routes.ts +0 -94
  534. package/src/engine/knowledge-import/types.ts +0 -92
  535. package/src/engine/knowledge-routes.ts +0 -231
  536. package/src/engine/knowledge.ts +0 -587
  537. package/src/engine/lifecycle.ts +0 -1420
  538. package/src/engine/mcp-process-manager.ts +0 -573
  539. package/src/engine/meeting-monitor.ts +0 -483
  540. package/src/engine/meeting-voice-intelligence.ts +0 -340
  541. package/src/engine/memory-routes.ts +0 -142
  542. package/src/engine/memory-transfer-routes.ts +0 -339
  543. package/src/engine/messaging-history.ts +0 -177
  544. package/src/engine/messaging-poller.ts +0 -786
  545. package/src/engine/model-fallback.ts +0 -141
  546. package/src/engine/oauth-connect-routes.ts +0 -603
  547. package/src/engine/oauth-connect.ts +0 -304
  548. package/src/engine/onboarding-routes.ts +0 -148
  549. package/src/engine/onboarding.ts +0 -574
  550. package/src/engine/org-approval-routes.ts +0 -146
  551. package/src/engine/org-integration-routes.ts +0 -399
  552. package/src/engine/org-integrations.ts +0 -608
  553. package/src/engine/org-policies.ts +0 -502
  554. package/src/engine/policy-import-routes.ts +0 -125
  555. package/src/engine/policy-import.ts +0 -1186
  556. package/src/engine/policy-routes.ts +0 -163
  557. package/src/engine/routes.ts +0 -1236
  558. package/src/engine/screen-unlock.ts +0 -136
  559. package/src/engine/session-router.ts +0 -212
  560. package/src/engine/skill-updater-routes.ts +0 -132
  561. package/src/engine/skill-updater.ts +0 -480
  562. package/src/engine/skill-validator.ts +0 -331
  563. package/src/engine/skills/agent-management.ts +0 -119
  564. package/src/engine/skills/agent-memory.ts +0 -19
  565. package/src/engine/skills/agenticmail.ts +0 -116
  566. package/src/engine/skills/core-tools.ts +0 -25
  567. package/src/engine/skills/database-access.ts +0 -78
  568. package/src/engine/skills/enterprise-code-sandbox.ts +0 -113
  569. package/src/engine/skills/enterprise-database.ts +0 -123
  570. package/src/engine/skills/enterprise-diff.ts +0 -95
  571. package/src/engine/skills/enterprise-documents.ts +0 -162
  572. package/src/engine/skills/enterprise-http.ts +0 -99
  573. package/src/engine/skills/enterprise-security-scan.ts +0 -125
  574. package/src/engine/skills/enterprise-spreadsheet.ts +0 -171
  575. package/src/engine/skills/gws-admin.ts +0 -18
  576. package/src/engine/skills/gws-calendar.ts +0 -21
  577. package/src/engine/skills/gws-chat.ts +0 -29
  578. package/src/engine/skills/gws-contacts.ts +0 -20
  579. package/src/engine/skills/gws-docs.ts +0 -18
  580. package/src/engine/skills/gws-drive.ts +0 -23
  581. package/src/engine/skills/gws-forms.ts +0 -23
  582. package/src/engine/skills/gws-gmail.ts +0 -30
  583. package/src/engine/skills/gws-groups.ts +0 -17
  584. package/src/engine/skills/gws-keep.ts +0 -17
  585. package/src/engine/skills/gws-maps.ts +0 -25
  586. package/src/engine/skills/gws-meet.ts +0 -23
  587. package/src/engine/skills/gws-sheets.ts +0 -22
  588. package/src/engine/skills/gws-sites.ts +0 -16
  589. package/src/engine/skills/gws-slides.ts +0 -27
  590. package/src/engine/skills/gws-tasks.ts +0 -22
  591. package/src/engine/skills/gws-vault.ts +0 -17
  592. package/src/engine/skills/index.ts +0 -159
  593. package/src/engine/skills/knowledge-search.ts +0 -18
  594. package/src/engine/skills/local-system.ts +0 -61
  595. package/src/engine/skills/m365-admin.ts +0 -18
  596. package/src/engine/skills/m365-bookings.ts +0 -17
  597. package/src/engine/skills/m365-copilot.ts +0 -17
  598. package/src/engine/skills/m365-excel.ts +0 -60
  599. package/src/engine/skills/m365-forms.ts +0 -17
  600. package/src/engine/skills/m365-onedrive.ts +0 -60
  601. package/src/engine/skills/m365-onenote.ts +0 -17
  602. package/src/engine/skills/m365-outlook.ts +0 -27
  603. package/src/engine/skills/m365-planner.ts +0 -18
  604. package/src/engine/skills/m365-power-automate.ts +0 -18
  605. package/src/engine/skills/m365-power-bi.ts +0 -19
  606. package/src/engine/skills/m365-powerpoint.ts +0 -33
  607. package/src/engine/skills/m365-sharepoint.ts +0 -20
  608. package/src/engine/skills/m365-teams.ts +0 -21
  609. package/src/engine/skills/m365-todo.ts +0 -17
  610. package/src/engine/skills/m365-whiteboard.ts +0 -16
  611. package/src/engine/skills/m365-word.ts +0 -42
  612. package/src/engine/skills/mcp-bridge.ts +0 -45
  613. package/src/engine/skills/meeting-lifecycle.ts +0 -20
  614. package/src/engine/skills/messaging.ts +0 -46
  615. package/src/engine/skills/visual-memory.ts +0 -25
  616. package/src/engine/skills.ts +0 -688
  617. package/src/engine/soul-library.ts +0 -142
  618. package/src/engine/soul-templates.json +0 -1525
  619. package/src/engine/storage-manager.ts +0 -252
  620. package/src/engine/storage-routes.ts +0 -113
  621. package/src/engine/storage.ts +0 -528
  622. package/src/engine/task-poller.ts +0 -394
  623. package/src/engine/task-queue-after-spawn.ts +0 -66
  624. package/src/engine/task-queue-before-spawn.ts +0 -113
  625. package/src/engine/task-queue-routes.ts +0 -161
  626. package/src/engine/task-queue.ts +0 -664
  627. package/src/engine/tenant.ts +0 -409
  628. package/src/engine/tool-catalog.ts +0 -354
  629. package/src/engine/vault-routes.ts +0 -134
  630. package/src/engine/vault.ts +0 -601
  631. package/src/engine/workforce-routes.ts +0 -331
  632. package/src/engine/workforce.ts +0 -1161
  633. package/src/index.ts +0 -77
  634. package/src/lib/cidr.ts +0 -122
  635. package/src/lib/config-store.ts +0 -86
  636. package/src/lib/resilience.ts +0 -326
  637. package/src/lib/text-search.ts +0 -358
  638. package/src/mcp/adapters/activecampaign.adapter.ts +0 -391
  639. package/src/mcp/adapters/adobe-sign.adapter.ts +0 -469
  640. package/src/mcp/adapters/adp.adapter.ts +0 -358
  641. package/src/mcp/adapters/airtable.adapter.ts +0 -273
  642. package/src/mcp/adapters/apollo.adapter.ts +0 -420
  643. package/src/mcp/adapters/asana.adapter.ts +0 -315
  644. package/src/mcp/adapters/auth0.adapter.ts +0 -386
  645. package/src/mcp/adapters/aws.adapter.ts +0 -345
  646. package/src/mcp/adapters/azure-devops.adapter.ts +0 -389
  647. package/src/mcp/adapters/bamboohr.adapter.ts +0 -376
  648. package/src/mcp/adapters/basecamp.adapter.ts +0 -366
  649. package/src/mcp/adapters/bigcommerce.adapter.ts +0 -429
  650. package/src/mcp/adapters/bitbucket.adapter.ts +0 -260
  651. package/src/mcp/adapters/box.adapter.ts +0 -350
  652. package/src/mcp/adapters/brex.adapter.ts +0 -367
  653. package/src/mcp/adapters/buffer.adapter.ts +0 -303
  654. package/src/mcp/adapters/calendly.adapter.ts +0 -262
  655. package/src/mcp/adapters/canva.adapter.ts +0 -256
  656. package/src/mcp/adapters/chargebee.adapter.ts +0 -448
  657. package/src/mcp/adapters/circleci.adapter.ts +0 -216
  658. package/src/mcp/adapters/clickup.adapter.ts +0 -335
  659. package/src/mcp/adapters/close.adapter.ts +0 -390
  660. package/src/mcp/adapters/cloudflare.adapter.ts +0 -378
  661. package/src/mcp/adapters/confluence.adapter.ts +0 -301
  662. package/src/mcp/adapters/contentful.adapter.ts +0 -355
  663. package/src/mcp/adapters/copper.adapter.ts +0 -468
  664. package/src/mcp/adapters/crisp.adapter.ts +0 -415
  665. package/src/mcp/adapters/crowdstrike.adapter.ts +0 -413
  666. package/src/mcp/adapters/datadog.adapter.ts +0 -373
  667. package/src/mcp/adapters/digitalocean.adapter.ts +0 -336
  668. package/src/mcp/adapters/discord.adapter.ts +0 -248
  669. package/src/mcp/adapters/docker.adapter.ts +0 -238
  670. package/src/mcp/adapters/docusign.adapter.ts +0 -431
  671. package/src/mcp/adapters/drift.adapter.ts +0 -386
  672. package/src/mcp/adapters/dropbox.adapter.ts +0 -315
  673. package/src/mcp/adapters/figma.adapter.ts +0 -302
  674. package/src/mcp/adapters/firebase.adapter.ts +0 -446
  675. package/src/mcp/adapters/flyio.adapter.ts +0 -302
  676. package/src/mcp/adapters/freshbooks.adapter.ts +0 -474
  677. package/src/mcp/adapters/freshdesk.adapter.ts +0 -441
  678. package/src/mcp/adapters/freshsales.adapter.ts +0 -457
  679. package/src/mcp/adapters/freshservice.adapter.ts +0 -481
  680. package/src/mcp/adapters/front.adapter.ts +0 -357
  681. package/src/mcp/adapters/github-actions.adapter.ts +0 -329
  682. package/src/mcp/adapters/github.adapter.ts +0 -387
  683. package/src/mcp/adapters/gitlab.adapter.ts +0 -368
  684. package/src/mcp/adapters/gong.adapter.ts +0 -386
  685. package/src/mcp/adapters/google-ads.adapter.ts +0 -363
  686. package/src/mcp/adapters/google-analytics.adapter.ts +0 -316
  687. package/src/mcp/adapters/google-cloud.adapter.ts +0 -312
  688. package/src/mcp/adapters/gotomeeting.adapter.ts +0 -255
  689. package/src/mcp/adapters/grafana.adapter.ts +0 -361
  690. package/src/mcp/adapters/greenhouse.adapter.ts +0 -354
  691. package/src/mcp/adapters/gusto.adapter.ts +0 -329
  692. package/src/mcp/adapters/hashicorp-vault.adapter.ts +0 -355
  693. package/src/mcp/adapters/heroku.adapter.ts +0 -291
  694. package/src/mcp/adapters/hibob.adapter.ts +0 -334
  695. package/src/mcp/adapters/hootsuite.adapter.ts +0 -322
  696. package/src/mcp/adapters/hubspot.adapter.ts +0 -400
  697. package/src/mcp/adapters/huggingface.adapter.ts +0 -349
  698. package/src/mcp/adapters/index.ts +0 -524
  699. package/src/mcp/adapters/intercom.adapter.ts +0 -269
  700. package/src/mcp/adapters/jira.adapter.ts +0 -482
  701. package/src/mcp/adapters/klaviyo.adapter.ts +0 -353
  702. package/src/mcp/adapters/kubernetes.adapter.ts +0 -431
  703. package/src/mcp/adapters/lattice.adapter.ts +0 -339
  704. package/src/mcp/adapters/launchdarkly.adapter.ts +0 -368
  705. package/src/mcp/adapters/lever.adapter.ts +0 -347
  706. package/src/mcp/adapters/linear.adapter.ts +0 -300
  707. package/src/mcp/adapters/linkedin.adapter.ts +0 -331
  708. package/src/mcp/adapters/livechat.adapter.ts +0 -259
  709. package/src/mcp/adapters/loom.adapter.ts +0 -230
  710. package/src/mcp/adapters/mailchimp.adapter.ts +0 -394
  711. package/src/mcp/adapters/mailgun.adapter.ts +0 -425
  712. package/src/mcp/adapters/miro.adapter.ts +0 -274
  713. package/src/mcp/adapters/mixpanel.adapter.ts +0 -324
  714. package/src/mcp/adapters/monday.adapter.ts +0 -308
  715. package/src/mcp/adapters/mongodb-atlas.adapter.ts +0 -345
  716. package/src/mcp/adapters/neon.adapter.ts +0 -312
  717. package/src/mcp/adapters/netlify.adapter.ts +0 -324
  718. package/src/mcp/adapters/netsuite.adapter.ts +0 -411
  719. package/src/mcp/adapters/newrelic.adapter.ts +0 -339
  720. package/src/mcp/adapters/notion.adapter.ts +0 -338
  721. package/src/mcp/adapters/okta.adapter.ts +0 -394
  722. package/src/mcp/adapters/openai.adapter.ts +0 -315
  723. package/src/mcp/adapters/opsgenie.adapter.ts +0 -375
  724. package/src/mcp/adapters/outreach.adapter.ts +0 -372
  725. package/src/mcp/adapters/paddle.adapter.ts +0 -467
  726. package/src/mcp/adapters/pagerduty.adapter.ts +0 -412
  727. package/src/mcp/adapters/pandadoc.adapter.ts +0 -389
  728. package/src/mcp/adapters/paypal.adapter.ts +0 -465
  729. package/src/mcp/adapters/personio.adapter.ts +0 -401
  730. package/src/mcp/adapters/pinecone.adapter.ts +0 -340
  731. package/src/mcp/adapters/pipedrive.adapter.ts +0 -324
  732. package/src/mcp/adapters/plaid.adapter.ts +0 -444
  733. package/src/mcp/adapters/postmark.adapter.ts +0 -387
  734. package/src/mcp/adapters/power-automate.adapter.ts +0 -388
  735. package/src/mcp/adapters/quickbooks.adapter.ts +0 -431
  736. package/src/mcp/adapters/recurly.adapter.ts +0 -433
  737. package/src/mcp/adapters/reddit.adapter.ts +0 -371
  738. package/src/mcp/adapters/render.adapter.ts +0 -332
  739. package/src/mcp/adapters/ringcentral.adapter.ts +0 -281
  740. package/src/mcp/adapters/rippling.adapter.ts +0 -287
  741. package/src/mcp/adapters/salesforce.adapter.ts +0 -321
  742. package/src/mcp/adapters/salesloft.adapter.ts +0 -413
  743. package/src/mcp/adapters/sanity.adapter.ts +0 -363
  744. package/src/mcp/adapters/sap.adapter.ts +0 -483
  745. package/src/mcp/adapters/segment.adapter.ts +0 -260
  746. package/src/mcp/adapters/sendgrid.adapter.ts +0 -265
  747. package/src/mcp/adapters/sentry.adapter.ts +0 -331
  748. package/src/mcp/adapters/servicenow.adapter.ts +0 -468
  749. package/src/mcp/adapters/shopify.adapter.ts +0 -451
  750. package/src/mcp/adapters/shortcut.adapter.ts +0 -290
  751. package/src/mcp/adapters/slack.adapter.ts +0 -380
  752. package/src/mcp/adapters/smartsheet.adapter.ts +0 -326
  753. package/src/mcp/adapters/snowflake.adapter.ts +0 -347
  754. package/src/mcp/adapters/snyk.adapter.ts +0 -394
  755. package/src/mcp/adapters/splunk.adapter.ts +0 -403
  756. package/src/mcp/adapters/square.adapter.ts +0 -467
  757. package/src/mcp/adapters/statuspage.adapter.ts +0 -401
  758. package/src/mcp/adapters/stripe.adapter.ts +0 -380
  759. package/src/mcp/adapters/supabase.adapter.ts +0 -334
  760. package/src/mcp/adapters/teamwork.adapter.ts +0 -404
  761. package/src/mcp/adapters/telegram.adapter.ts +0 -299
  762. package/src/mcp/adapters/terraform.adapter.ts +0 -300
  763. package/src/mcp/adapters/todoist.adapter.ts +0 -239
  764. package/src/mcp/adapters/trello.adapter.ts +0 -316
  765. package/src/mcp/adapters/twilio.adapter.ts +0 -233
  766. package/src/mcp/adapters/twitter.adapter.ts +0 -348
  767. package/src/mcp/adapters/vercel.adapter.ts +0 -219
  768. package/src/mcp/adapters/weaviate.adapter.ts +0 -371
  769. package/src/mcp/adapters/webex.adapter.ts +0 -237
  770. package/src/mcp/adapters/webflow.adapter.ts +0 -287
  771. package/src/mcp/adapters/whatsapp.adapter.ts +0 -273
  772. package/src/mcp/adapters/whereby.adapter.ts +0 -240
  773. package/src/mcp/adapters/woocommerce.adapter.ts +0 -454
  774. package/src/mcp/adapters/wordpress.adapter.ts +0 -455
  775. package/src/mcp/adapters/workday.adapter.ts +0 -354
  776. package/src/mcp/adapters/wrike.adapter.ts +0 -349
  777. package/src/mcp/adapters/xero.adapter.ts +0 -472
  778. package/src/mcp/adapters/youtube.adapter.ts +0 -401
  779. package/src/mcp/adapters/zendesk.adapter.ts +0 -399
  780. package/src/mcp/adapters/zoho-crm.adapter.ts +0 -410
  781. package/src/mcp/adapters/zoom.adapter.ts +0 -241
  782. package/src/mcp/adapters/zuora.adapter.ts +0 -476
  783. package/src/mcp/framework/api-executor.ts +0 -192
  784. package/src/mcp/framework/aws-sigv4.ts +0 -216
  785. package/src/mcp/framework/credential-resolver.ts +0 -128
  786. package/src/mcp/framework/oauth-token-manager.ts +0 -22
  787. package/src/mcp/framework/skill-mcp-framework.ts +0 -226
  788. package/src/mcp/framework/types.ts +0 -130
  789. package/src/mcp/index.ts +0 -124
  790. package/src/mcp/integration-catalog.ts +0 -178
  791. package/src/middleware/dns-rebinding.ts +0 -44
  792. package/src/middleware/egress-filter.ts +0 -104
  793. package/src/middleware/firewall.ts +0 -192
  794. package/src/middleware/geo-ip.ts +0 -156
  795. package/src/middleware/index.ts +0 -390
  796. package/src/middleware/network-config.ts +0 -90
  797. package/src/middleware/proxy-config.ts +0 -71
  798. package/src/middleware/request-limits.ts +0 -59
  799. package/src/middleware/transport-encryption.ts +0 -398
  800. package/src/registry/cli.ts +0 -63
  801. package/src/registry/server.ts +0 -504
  802. package/src/runtime/agent-loop.ts +0 -779
  803. package/src/runtime/compaction.ts +0 -638
  804. package/src/runtime/email-channel.ts +0 -120
  805. package/src/runtime/environment.ts +0 -300
  806. package/src/runtime/followup.ts +0 -211
  807. package/src/runtime/gateway.ts +0 -260
  808. package/src/runtime/hooks.ts +0 -564
  809. package/src/runtime/index.ts +0 -1110
  810. package/src/runtime/llm-client.ts +0 -1056
  811. package/src/runtime/model-router.ts +0 -97
  812. package/src/runtime/providers.ts +0 -228
  813. package/src/runtime/session-manager.ts +0 -345
  814. package/src/runtime/subagent.ts +0 -153
  815. package/src/runtime/tool-executor.ts +0 -208
  816. package/src/runtime/types.ts +0 -255
  817. package/src/security/brute-force.ts +0 -423
  818. package/src/security/config.ts +0 -159
  819. package/src/security/csp.ts +0 -407
  820. package/src/security/external-content.ts +0 -299
  821. package/src/security/index.ts +0 -557
  822. package/src/security/input-sanitizer.ts +0 -452
  823. package/src/security/output-filter.ts +0 -575
  824. package/src/security/port-scanner.ts +0 -342
  825. package/src/security/prompt-guard.ts +0 -387
  826. package/src/security/sql-guard.ts +0 -338
  827. package/src/security/threat-logger.ts +0 -484
  828. package/src/server.ts +0 -828
  829. package/src/setup/company.ts +0 -183
  830. package/src/setup/database.ts +0 -153
  831. package/src/setup/deployment.ts +0 -561
  832. package/src/setup/domain.ts +0 -112
  833. package/src/setup/index.ts +0 -171
  834. package/src/setup/provision.ts +0 -532
  835. package/src/setup/registration.ts +0 -302
  836. package/src/system-prompts/catchup.ts +0 -48
  837. package/src/system-prompts/google/calendar.ts +0 -37
  838. package/src/system-prompts/google/chat.ts +0 -92
  839. package/src/system-prompts/google/contacts.ts +0 -25
  840. package/src/system-prompts/google/docs.ts +0 -29
  841. package/src/system-prompts/google/drive.ts +0 -34
  842. package/src/system-prompts/google/forms.ts +0 -25
  843. package/src/system-prompts/google/gmail.ts +0 -50
  844. package/src/system-prompts/google/index.ts +0 -23
  845. package/src/system-prompts/google/maps.ts +0 -20
  846. package/src/system-prompts/google/meet.ts +0 -130
  847. package/src/system-prompts/google/sheets.ts +0 -32
  848. package/src/system-prompts/google/slides.ts +0 -26
  849. package/src/system-prompts/google/tasks.ts +0 -27
  850. package/src/system-prompts/index.ts +0 -88
  851. package/src/system-prompts/microsoft/contacts.ts +0 -34
  852. package/src/system-prompts/microsoft/excel.ts +0 -52
  853. package/src/system-prompts/microsoft/index.ts +0 -31
  854. package/src/system-prompts/microsoft/onedrive.ts +0 -41
  855. package/src/system-prompts/microsoft/onenote.ts +0 -36
  856. package/src/system-prompts/microsoft/outlook-calendar.ts +0 -37
  857. package/src/system-prompts/microsoft/outlook-mail.ts +0 -46
  858. package/src/system-prompts/microsoft/planner.ts +0 -37
  859. package/src/system-prompts/microsoft/powerbi.ts +0 -38
  860. package/src/system-prompts/microsoft/powerpoint.ts +0 -35
  861. package/src/system-prompts/microsoft/sharepoint.ts +0 -44
  862. package/src/system-prompts/microsoft/teams.ts +0 -49
  863. package/src/system-prompts/microsoft/todo.ts +0 -37
  864. package/src/system-prompts/shared-blocks.ts +0 -87
  865. package/src/system-prompts/task.ts +0 -21
  866. package/src/system-prompts/triage.ts +0 -34
  867. package/src/types/hono-env.ts +0 -18
  868. 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>