@agenticmail/enterprise 0.5.327 → 0.5.329

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 (888) hide show
  1. package/dist/agent-tools-F3CYENMK.js +13949 -0
  2. package/dist/browser-tool-P57PLVW2.js +4002 -0
  3. package/dist/chunk-3RI3AIJN.js +1519 -0
  4. package/dist/chunk-AD4DFKHR.js +4928 -0
  5. package/dist/chunk-UQXPVWXG.js +5101 -0
  6. package/dist/cli-agent-K6UFZRXC.js +2473 -0
  7. package/dist/cli-serve-4MT7RDEL.js +260 -0
  8. package/dist/cli.js +3 -3
  9. package/dist/dashboard/app.js +1 -1
  10. package/dist/dashboard/components/transport-encryption.js +0 -62
  11. package/dist/dashboard/pages/agent-detail/index.js +5 -2
  12. package/dist/dashboard/pages/agent-detail/manager.js +1 -1
  13. package/dist/dashboard/pages/agent-detail/overview.js +4 -2
  14. package/dist/dashboard/pages/agent-detail/tool-security.js +1 -1
  15. package/dist/dashboard/pages/domain-status.js +3 -6
  16. package/dist/dashboard/pages/memory-transfer.js +1 -1
  17. package/dist/dashboard/pages/messages.js +0 -1
  18. package/dist/dashboard/pages/roles.js +0 -2
  19. package/dist/dashboard/pages/workforce.js +0 -1
  20. package/dist/index.js +3 -3
  21. package/dist/runtime-L5ADJORP.js +45 -0
  22. package/dist/server-KSN56EZQ.js +28 -0
  23. package/dist/setup-UUNBBOQH.js +20 -0
  24. package/logs/cloudflared-error.log +42 -0
  25. package/logs/enterprise-out.log +6 -0
  26. package/package.json +1 -1
  27. package/src/admin/page-registry.ts +0 -290
  28. package/src/admin/routes.ts +0 -2968
  29. package/src/agent-tools/common.ts +0 -260
  30. package/src/agent-tools/index.ts +0 -542
  31. package/src/agent-tools/merge.ts +0 -62
  32. package/src/agent-tools/middleware.ts +0 -436
  33. package/src/agent-tools/schema/typebox.ts +0 -25
  34. package/src/agent-tools/security.ts +0 -352
  35. package/src/agent-tools/tool-resolver.ts +0 -1018
  36. package/src/agent-tools/tools/agenticmail.ts +0 -1017
  37. package/src/agent-tools/tools/bash.ts +0 -179
  38. package/src/agent-tools/tools/browser-tool.schema.ts +0 -112
  39. package/src/agent-tools/tools/browser-tool.ts +0 -388
  40. package/src/agent-tools/tools/browser.ts +0 -764
  41. package/src/agent-tools/tools/edit.ts +0 -100
  42. package/src/agent-tools/tools/enterprise-code-sandbox.ts +0 -395
  43. package/src/agent-tools/tools/enterprise-database.ts +0 -377
  44. package/src/agent-tools/tools/enterprise-diff.ts +0 -580
  45. package/src/agent-tools/tools/enterprise-documents.ts +0 -896
  46. package/src/agent-tools/tools/enterprise-http.ts +0 -485
  47. package/src/agent-tools/tools/enterprise-security-scan.ts +0 -528
  48. package/src/agent-tools/tools/enterprise-spreadsheet.ts +0 -825
  49. package/src/agent-tools/tools/glob.ts +0 -129
  50. package/src/agent-tools/tools/google/calendar.ts +0 -230
  51. package/src/agent-tools/tools/google/chat.ts +0 -725
  52. package/src/agent-tools/tools/google/contacts.ts +0 -209
  53. package/src/agent-tools/tools/google/docs.ts +0 -162
  54. package/src/agent-tools/tools/google/drive.ts +0 -392
  55. package/src/agent-tools/tools/google/forms.ts +0 -367
  56. package/src/agent-tools/tools/google/gmail.ts +0 -897
  57. package/src/agent-tools/tools/google/index.ts +0 -86
  58. package/src/agent-tools/tools/google/maps.ts +0 -543
  59. package/src/agent-tools/tools/google/meeting-voice.ts +0 -885
  60. package/src/agent-tools/tools/google/meetings.ts +0 -1094
  61. package/src/agent-tools/tools/google/sheets.ts +0 -215
  62. package/src/agent-tools/tools/google/slides.ts +0 -559
  63. package/src/agent-tools/tools/google/tasks.ts +0 -200
  64. package/src/agent-tools/tools/grep.ts +0 -178
  65. package/src/agent-tools/tools/integrations/_factory.ts +0 -102
  66. package/src/agent-tools/tools/integrations/activecampaign.ts +0 -14
  67. package/src/agent-tools/tools/integrations/adobe-sign.ts +0 -14
  68. package/src/agent-tools/tools/integrations/adp.ts +0 -14
  69. package/src/agent-tools/tools/integrations/airtable.ts +0 -14
  70. package/src/agent-tools/tools/integrations/apollo.ts +0 -14
  71. package/src/agent-tools/tools/integrations/asana.ts +0 -14
  72. package/src/agent-tools/tools/integrations/auth0.ts +0 -14
  73. package/src/agent-tools/tools/integrations/aws.ts +0 -14
  74. package/src/agent-tools/tools/integrations/azure-devops.ts +0 -14
  75. package/src/agent-tools/tools/integrations/bamboohr.ts +0 -14
  76. package/src/agent-tools/tools/integrations/basecamp.ts +0 -14
  77. package/src/agent-tools/tools/integrations/bigcommerce.ts +0 -14
  78. package/src/agent-tools/tools/integrations/bitbucket.ts +0 -14
  79. package/src/agent-tools/tools/integrations/box.ts +0 -14
  80. package/src/agent-tools/tools/integrations/brex.ts +0 -14
  81. package/src/agent-tools/tools/integrations/buffer.ts +0 -14
  82. package/src/agent-tools/tools/integrations/calendly.ts +0 -14
  83. package/src/agent-tools/tools/integrations/canva.ts +0 -14
  84. package/src/agent-tools/tools/integrations/chargebee.ts +0 -14
  85. package/src/agent-tools/tools/integrations/circleci.ts +0 -14
  86. package/src/agent-tools/tools/integrations/clickup.ts +0 -14
  87. package/src/agent-tools/tools/integrations/close.ts +0 -14
  88. package/src/agent-tools/tools/integrations/cloudflare.ts +0 -14
  89. package/src/agent-tools/tools/integrations/confluence.ts +0 -14
  90. package/src/agent-tools/tools/integrations/contentful.ts +0 -14
  91. package/src/agent-tools/tools/integrations/copper.ts +0 -14
  92. package/src/agent-tools/tools/integrations/crisp.ts +0 -14
  93. package/src/agent-tools/tools/integrations/crowdstrike.ts +0 -14
  94. package/src/agent-tools/tools/integrations/datadog.ts +0 -14
  95. package/src/agent-tools/tools/integrations/digitalocean.ts +0 -14
  96. package/src/agent-tools/tools/integrations/discord.ts +0 -14
  97. package/src/agent-tools/tools/integrations/docker.ts +0 -14
  98. package/src/agent-tools/tools/integrations/docusign.ts +0 -14
  99. package/src/agent-tools/tools/integrations/drift.ts +0 -14
  100. package/src/agent-tools/tools/integrations/dropbox.ts +0 -14
  101. package/src/agent-tools/tools/integrations/figma.ts +0 -14
  102. package/src/agent-tools/tools/integrations/firebase.ts +0 -14
  103. package/src/agent-tools/tools/integrations/flyio.ts +0 -14
  104. package/src/agent-tools/tools/integrations/freshbooks.ts +0 -14
  105. package/src/agent-tools/tools/integrations/freshdesk.ts +0 -14
  106. package/src/agent-tools/tools/integrations/freshsales.ts +0 -14
  107. package/src/agent-tools/tools/integrations/freshservice.ts +0 -14
  108. package/src/agent-tools/tools/integrations/front.ts +0 -14
  109. package/src/agent-tools/tools/integrations/github-actions.ts +0 -14
  110. package/src/agent-tools/tools/integrations/github.ts +0 -14
  111. package/src/agent-tools/tools/integrations/gitlab.ts +0 -14
  112. package/src/agent-tools/tools/integrations/gong.ts +0 -14
  113. package/src/agent-tools/tools/integrations/google-ads.ts +0 -14
  114. package/src/agent-tools/tools/integrations/google-analytics.ts +0 -14
  115. package/src/agent-tools/tools/integrations/google-cloud.ts +0 -14
  116. package/src/agent-tools/tools/integrations/gotomeeting.ts +0 -14
  117. package/src/agent-tools/tools/integrations/grafana.ts +0 -14
  118. package/src/agent-tools/tools/integrations/greenhouse.ts +0 -14
  119. package/src/agent-tools/tools/integrations/gusto.ts +0 -14
  120. package/src/agent-tools/tools/integrations/hashicorp-vault.ts +0 -14
  121. package/src/agent-tools/tools/integrations/heroku.ts +0 -14
  122. package/src/agent-tools/tools/integrations/hibob.ts +0 -14
  123. package/src/agent-tools/tools/integrations/hootsuite.ts +0 -14
  124. package/src/agent-tools/tools/integrations/hubspot.ts +0 -14
  125. package/src/agent-tools/tools/integrations/huggingface.ts +0 -14
  126. package/src/agent-tools/tools/integrations/index.ts +0 -474
  127. package/src/agent-tools/tools/integrations/intercom.ts +0 -14
  128. package/src/agent-tools/tools/integrations/jira.ts +0 -14
  129. package/src/agent-tools/tools/integrations/klaviyo.ts +0 -14
  130. package/src/agent-tools/tools/integrations/kubernetes.ts +0 -14
  131. package/src/agent-tools/tools/integrations/lattice.ts +0 -14
  132. package/src/agent-tools/tools/integrations/launchdarkly.ts +0 -14
  133. package/src/agent-tools/tools/integrations/lever.ts +0 -14
  134. package/src/agent-tools/tools/integrations/linear.ts +0 -14
  135. package/src/agent-tools/tools/integrations/linkedin.ts +0 -14
  136. package/src/agent-tools/tools/integrations/livechat.ts +0 -14
  137. package/src/agent-tools/tools/integrations/loom.ts +0 -14
  138. package/src/agent-tools/tools/integrations/mailchimp.ts +0 -14
  139. package/src/agent-tools/tools/integrations/mailgun.ts +0 -14
  140. package/src/agent-tools/tools/integrations/miro.ts +0 -14
  141. package/src/agent-tools/tools/integrations/mixpanel.ts +0 -14
  142. package/src/agent-tools/tools/integrations/monday.ts +0 -14
  143. package/src/agent-tools/tools/integrations/mongodb-atlas.ts +0 -14
  144. package/src/agent-tools/tools/integrations/neon.ts +0 -14
  145. package/src/agent-tools/tools/integrations/netlify.ts +0 -14
  146. package/src/agent-tools/tools/integrations/netsuite.ts +0 -14
  147. package/src/agent-tools/tools/integrations/newrelic.ts +0 -14
  148. package/src/agent-tools/tools/integrations/notion.ts +0 -14
  149. package/src/agent-tools/tools/integrations/okta.ts +0 -14
  150. package/src/agent-tools/tools/integrations/openai.ts +0 -14
  151. package/src/agent-tools/tools/integrations/opsgenie.ts +0 -14
  152. package/src/agent-tools/tools/integrations/outreach.ts +0 -14
  153. package/src/agent-tools/tools/integrations/paddle.ts +0 -14
  154. package/src/agent-tools/tools/integrations/pagerduty.ts +0 -14
  155. package/src/agent-tools/tools/integrations/pandadoc.ts +0 -14
  156. package/src/agent-tools/tools/integrations/paypal.ts +0 -14
  157. package/src/agent-tools/tools/integrations/personio.ts +0 -14
  158. package/src/agent-tools/tools/integrations/pinecone.ts +0 -14
  159. package/src/agent-tools/tools/integrations/pipedrive.ts +0 -14
  160. package/src/agent-tools/tools/integrations/plaid.ts +0 -14
  161. package/src/agent-tools/tools/integrations/postmark.ts +0 -14
  162. package/src/agent-tools/tools/integrations/power-automate.ts +0 -14
  163. package/src/agent-tools/tools/integrations/quickbooks.ts +0 -14
  164. package/src/agent-tools/tools/integrations/recurly.ts +0 -14
  165. package/src/agent-tools/tools/integrations/reddit.ts +0 -14
  166. package/src/agent-tools/tools/integrations/render.ts +0 -14
  167. package/src/agent-tools/tools/integrations/ringcentral.ts +0 -14
  168. package/src/agent-tools/tools/integrations/rippling.ts +0 -14
  169. package/src/agent-tools/tools/integrations/salesforce.ts +0 -14
  170. package/src/agent-tools/tools/integrations/salesloft.ts +0 -14
  171. package/src/agent-tools/tools/integrations/sanity.ts +0 -14
  172. package/src/agent-tools/tools/integrations/sap.ts +0 -14
  173. package/src/agent-tools/tools/integrations/segment.ts +0 -14
  174. package/src/agent-tools/tools/integrations/sendgrid.ts +0 -14
  175. package/src/agent-tools/tools/integrations/sentry.ts +0 -14
  176. package/src/agent-tools/tools/integrations/servicenow.ts +0 -14
  177. package/src/agent-tools/tools/integrations/shopify.ts +0 -14
  178. package/src/agent-tools/tools/integrations/shortcut.ts +0 -14
  179. package/src/agent-tools/tools/integrations/slack.ts +0 -14
  180. package/src/agent-tools/tools/integrations/smartsheet.ts +0 -14
  181. package/src/agent-tools/tools/integrations/snowflake.ts +0 -14
  182. package/src/agent-tools/tools/integrations/snyk.ts +0 -14
  183. package/src/agent-tools/tools/integrations/splunk.ts +0 -14
  184. package/src/agent-tools/tools/integrations/square.ts +0 -14
  185. package/src/agent-tools/tools/integrations/statuspage.ts +0 -14
  186. package/src/agent-tools/tools/integrations/stripe.ts +0 -14
  187. package/src/agent-tools/tools/integrations/supabase.ts +0 -14
  188. package/src/agent-tools/tools/integrations/teamwork.ts +0 -14
  189. package/src/agent-tools/tools/integrations/telegram.ts +0 -14
  190. package/src/agent-tools/tools/integrations/terraform.ts +0 -14
  191. package/src/agent-tools/tools/integrations/todoist.ts +0 -14
  192. package/src/agent-tools/tools/integrations/trello.ts +0 -14
  193. package/src/agent-tools/tools/integrations/twilio.ts +0 -14
  194. package/src/agent-tools/tools/integrations/twitter.ts +0 -14
  195. package/src/agent-tools/tools/integrations/vercel.ts +0 -14
  196. package/src/agent-tools/tools/integrations/weaviate.ts +0 -14
  197. package/src/agent-tools/tools/integrations/webex.ts +0 -14
  198. package/src/agent-tools/tools/integrations/webflow.ts +0 -14
  199. package/src/agent-tools/tools/integrations/whatsapp.ts +0 -14
  200. package/src/agent-tools/tools/integrations/whereby.ts +0 -14
  201. package/src/agent-tools/tools/integrations/woocommerce.ts +0 -14
  202. package/src/agent-tools/tools/integrations/wordpress.ts +0 -14
  203. package/src/agent-tools/tools/integrations/workday.ts +0 -14
  204. package/src/agent-tools/tools/integrations/wrike.ts +0 -14
  205. package/src/agent-tools/tools/integrations/xero.ts +0 -14
  206. package/src/agent-tools/tools/integrations/youtube.ts +0 -14
  207. package/src/agent-tools/tools/integrations/zendesk.ts +0 -14
  208. package/src/agent-tools/tools/integrations/zoho-crm.ts +0 -14
  209. package/src/agent-tools/tools/integrations/zoom.ts +0 -14
  210. package/src/agent-tools/tools/integrations/zuora.ts +0 -14
  211. package/src/agent-tools/tools/knowledge-search.ts +0 -318
  212. package/src/agent-tools/tools/local/coding.ts +0 -626
  213. package/src/agent-tools/tools/local/dependency-manager.ts +0 -647
  214. package/src/agent-tools/tools/local/file-edit.ts +0 -31
  215. package/src/agent-tools/tools/local/file-list.ts +0 -39
  216. package/src/agent-tools/tools/local/file-ops.ts +0 -48
  217. package/src/agent-tools/tools/local/file-read.ts +0 -39
  218. package/src/agent-tools/tools/local/file-search.ts +0 -46
  219. package/src/agent-tools/tools/local/file-write.ts +0 -28
  220. package/src/agent-tools/tools/local/filesystem.ts +0 -5
  221. package/src/agent-tools/tools/local/index.ts +0 -55
  222. package/src/agent-tools/tools/local/resolve-path.ts +0 -18
  223. package/src/agent-tools/tools/local/shell.ts +0 -277
  224. package/src/agent-tools/tools/local/system-info.ts +0 -29
  225. package/src/agent-tools/tools/management.ts +0 -425
  226. package/src/agent-tools/tools/mcp-bridge.ts +0 -142
  227. package/src/agent-tools/tools/mcp-server-tools.ts +0 -91
  228. package/src/agent-tools/tools/meeting-lifecycle.ts +0 -438
  229. package/src/agent-tools/tools/memory.ts +0 -509
  230. package/src/agent-tools/tools/messaging/index.ts +0 -6
  231. package/src/agent-tools/tools/messaging/telegram.ts +0 -167
  232. package/src/agent-tools/tools/messaging/whatsapp.ts +0 -651
  233. package/src/agent-tools/tools/microsoft/contacts.ts +0 -176
  234. package/src/agent-tools/tools/microsoft/excel-vba.ts +0 -331
  235. package/src/agent-tools/tools/microsoft/excel.ts +0 -261
  236. package/src/agent-tools/tools/microsoft/graph-api.ts +0 -161
  237. package/src/agent-tools/tools/microsoft/index.ts +0 -95
  238. package/src/agent-tools/tools/microsoft/onedrive.ts +0 -429
  239. package/src/agent-tools/tools/microsoft/onenote.ts +0 -186
  240. package/src/agent-tools/tools/microsoft/outlook-calendar.ts +0 -286
  241. package/src/agent-tools/tools/microsoft/outlook-mail.ts +0 -723
  242. package/src/agent-tools/tools/microsoft/planner.ts +0 -200
  243. package/src/agent-tools/tools/microsoft/powerbi.ts +0 -266
  244. package/src/agent-tools/tools/microsoft/powerpoint.ts +0 -186
  245. package/src/agent-tools/tools/microsoft/sharepoint.ts +0 -328
  246. package/src/agent-tools/tools/microsoft/teams.ts +0 -463
  247. package/src/agent-tools/tools/microsoft/todo.ts +0 -181
  248. package/src/agent-tools/tools/oauth-token-provider.ts +0 -101
  249. package/src/agent-tools/tools/read.ts +0 -160
  250. package/src/agent-tools/tools/visual-memory/capture.ts +0 -217
  251. package/src/agent-tools/tools/visual-memory/diff.ts +0 -283
  252. package/src/agent-tools/tools/visual-memory/index.ts +0 -698
  253. package/src/agent-tools/tools/visual-memory/phash.ts +0 -120
  254. package/src/agent-tools/tools/visual-memory/similarity.ts +0 -354
  255. package/src/agent-tools/tools/visual-memory/storage.ts +0 -534
  256. package/src/agent-tools/tools/visual-memory/types.ts +0 -100
  257. package/src/agent-tools/tools/web-fetch-utils.ts +0 -202
  258. package/src/agent-tools/tools/web-fetch.ts +0 -464
  259. package/src/agent-tools/tools/web-search.ts +0 -480
  260. package/src/agent-tools/tools/web-shared.ts +0 -232
  261. package/src/agent-tools/tools/write.ts +0 -68
  262. package/src/agent-tools/types.ts +0 -214
  263. package/src/agenticmail/index.ts +0 -34
  264. package/src/agenticmail/manager.ts +0 -253
  265. package/src/agenticmail/providers/google.ts +0 -391
  266. package/src/agenticmail/providers/imap.ts +0 -454
  267. package/src/agenticmail/providers/index.ts +0 -28
  268. package/src/agenticmail/providers/microsoft.ts +0 -260
  269. package/src/agenticmail/types.ts +0 -173
  270. package/src/auth/routes.ts +0 -1589
  271. package/src/browser/bridge-auth-registry.ts +0 -34
  272. package/src/browser/bridge-server.ts +0 -93
  273. package/src/browser/cdp.helpers.ts +0 -180
  274. package/src/browser/cdp.ts +0 -466
  275. package/src/browser/chrome.executables.ts +0 -625
  276. package/src/browser/chrome.profile-decoration.ts +0 -198
  277. package/src/browser/chrome.ts +0 -349
  278. package/src/browser/client-actions-core.ts +0 -259
  279. package/src/browser/client-actions-observe.ts +0 -184
  280. package/src/browser/client-actions-state.ts +0 -284
  281. package/src/browser/client-actions-types.ts +0 -16
  282. package/src/browser/client-actions-url.ts +0 -11
  283. package/src/browser/client-actions.ts +0 -4
  284. package/src/browser/client-fetch.ts +0 -253
  285. package/src/browser/client.ts +0 -337
  286. package/src/browser/config.ts +0 -301
  287. package/src/browser/constants.ts +0 -8
  288. package/src/browser/control-auth.ts +0 -94
  289. package/src/browser/control-service.ts +0 -81
  290. package/src/browser/csrf.ts +0 -87
  291. package/src/browser/enterprise-compat.ts +0 -562
  292. package/src/browser/extension-relay.ts +0 -834
  293. package/src/browser/http-auth.ts +0 -63
  294. package/src/browser/navigation-guard.ts +0 -50
  295. package/src/browser/paths.ts +0 -49
  296. package/src/browser/playwright.d.ts +0 -12
  297. package/src/browser/profiles-service.ts +0 -187
  298. package/src/browser/profiles.ts +0 -114
  299. package/src/browser/proxy-files.ts +0 -41
  300. package/src/browser/pw-ai-module.ts +0 -52
  301. package/src/browser/pw-ai-state.ts +0 -9
  302. package/src/browser/pw-ai.ts +0 -65
  303. package/src/browser/pw-role-snapshot.ts +0 -434
  304. package/src/browser/pw-session.ts +0 -810
  305. package/src/browser/pw-tools-core.activity.ts +0 -68
  306. package/src/browser/pw-tools-core.downloads.ts +0 -281
  307. package/src/browser/pw-tools-core.interactions.ts +0 -646
  308. package/src/browser/pw-tools-core.responses.ts +0 -124
  309. package/src/browser/pw-tools-core.shared.ts +0 -70
  310. package/src/browser/pw-tools-core.snapshot.ts +0 -213
  311. package/src/browser/pw-tools-core.state.ts +0 -209
  312. package/src/browser/pw-tools-core.storage.ts +0 -128
  313. package/src/browser/pw-tools-core.trace.ts +0 -37
  314. package/src/browser/pw-tools-core.ts +0 -8
  315. package/src/browser/resolved-config-refresh.ts +0 -59
  316. package/src/browser/routes/agent.act.shared.ts +0 -52
  317. package/src/browser/routes/agent.act.ts +0 -575
  318. package/src/browser/routes/agent.debug.ts +0 -149
  319. package/src/browser/routes/agent.shared.ts +0 -143
  320. package/src/browser/routes/agent.snapshot.ts +0 -333
  321. package/src/browser/routes/agent.storage.ts +0 -451
  322. package/src/browser/routes/agent.ts +0 -13
  323. package/src/browser/routes/basic.ts +0 -202
  324. package/src/browser/routes/dispatcher.ts +0 -126
  325. package/src/browser/routes/index.ts +0 -11
  326. package/src/browser/routes/path-output.ts +0 -1
  327. package/src/browser/routes/tabs.ts +0 -217
  328. package/src/browser/routes/types.ts +0 -26
  329. package/src/browser/routes/utils.ts +0 -73
  330. package/src/browser/screenshot.ts +0 -54
  331. package/src/browser/server-context.ts +0 -688
  332. package/src/browser/server-context.types.ts +0 -65
  333. package/src/browser/server-lifecycle.ts +0 -48
  334. package/src/browser/server-middleware.ts +0 -37
  335. package/src/browser/server.ts +0 -110
  336. package/src/browser/target-id.ts +0 -30
  337. package/src/browser/trash.ts +0 -21
  338. package/src/cli-agent.ts +0 -2452
  339. package/src/cli-reset-password.ts +0 -138
  340. package/src/cli-serve.ts +0 -314
  341. package/src/cli.ts +0 -103
  342. package/src/dashboard/app.js +0 -579
  343. package/src/dashboard/assets/brand-logos.js +0 -350
  344. package/src/dashboard/assets/icons/emoji-icons.js +0 -893
  345. package/src/dashboard/assets/logo.png +0 -0
  346. package/src/dashboard/assets/provider-logos.js +0 -139
  347. package/src/dashboard/components/error-boundary.js +0 -21
  348. package/src/dashboard/components/help-button.js +0 -65
  349. package/src/dashboard/components/icons.js +0 -64
  350. package/src/dashboard/components/knowledge-link.js +0 -79
  351. package/src/dashboard/components/modal.js +0 -125
  352. package/src/dashboard/components/org-switcher.js +0 -156
  353. package/src/dashboard/components/persona-fields.js +0 -460
  354. package/src/dashboard/components/settings-help.js +0 -193
  355. package/src/dashboard/components/tag-input.js +0 -96
  356. package/src/dashboard/components/timezones.js +0 -352
  357. package/src/dashboard/components/transport-encryption.js +0 -288
  358. package/src/dashboard/components/utils.js +0 -205
  359. package/src/dashboard/data/countries.js +0 -255
  360. package/src/dashboard/docs/activity.html +0 -253
  361. package/src/dashboard/docs/agent-activity.html +0 -199
  362. package/src/dashboard/docs/agent-autonomy.html +0 -161
  363. package/src/dashboard/docs/agent-budget.html +0 -190
  364. package/src/dashboard/docs/agent-channels.html +0 -189
  365. package/src/dashboard/docs/agent-communication.html +0 -171
  366. package/src/dashboard/docs/agent-configuration.html +0 -194
  367. package/src/dashboard/docs/agent-deployment.html +0 -323
  368. package/src/dashboard/docs/agent-email.html +0 -184
  369. package/src/dashboard/docs/agent-guardrails.html +0 -206
  370. package/src/dashboard/docs/agent-manager.html +0 -226
  371. package/src/dashboard/docs/agent-memory.html +0 -215
  372. package/src/dashboard/docs/agent-overview.html +0 -226
  373. package/src/dashboard/docs/agent-permissions.html +0 -305
  374. package/src/dashboard/docs/agent-personal.html +0 -155
  375. package/src/dashboard/docs/agent-security.html +0 -188
  376. package/src/dashboard/docs/agent-skills.html +0 -224
  377. package/src/dashboard/docs/agent-tool-security.html +0 -205
  378. package/src/dashboard/docs/agent-tools.html +0 -238
  379. package/src/dashboard/docs/agent-whatsapp.html +0 -210
  380. package/src/dashboard/docs/agent-workforce.html +0 -199
  381. package/src/dashboard/docs/agents.html +0 -258
  382. package/src/dashboard/docs/approvals.html +0 -200
  383. package/src/dashboard/docs/audit.html +0 -206
  384. package/src/dashboard/docs/browser-providers.html +0 -313
  385. package/src/dashboard/docs/cluster.html +0 -285
  386. package/src/dashboard/docs/community-skills.html +0 -253
  387. package/src/dashboard/docs/compliance.html +0 -221
  388. package/src/dashboard/docs/dashboard.html +0 -84
  389. package/src/dashboard/docs/database-access.html +0 -322
  390. package/src/dashboard/docs/dlp.html +0 -268
  391. package/src/dashboard/docs/docs-style.css +0 -26
  392. package/src/dashboard/docs/domain-status.html +0 -294
  393. package/src/dashboard/docs/guardrails.html +0 -265
  394. package/src/dashboard/docs/journal.html +0 -197
  395. package/src/dashboard/docs/knowledge-contributions.html +0 -286
  396. package/src/dashboard/docs/knowledge.html +0 -268
  397. package/src/dashboard/docs/memory-transfer.html +0 -311
  398. package/src/dashboard/docs/messages.html +0 -217
  399. package/src/dashboard/docs/multi-tenant.html +0 -311
  400. package/src/dashboard/docs/org-chart.html +0 -239
  401. package/src/dashboard/docs/organizations.html +0 -182
  402. package/src/dashboard/docs/roles.html +0 -195
  403. package/src/dashboard/docs/settings-network.html +0 -321
  404. package/src/dashboard/docs/settings-security.html +0 -347
  405. package/src/dashboard/docs/settings-tool-security.html +0 -176
  406. package/src/dashboard/docs/settings.html +0 -280
  407. package/src/dashboard/docs/skill-connections.html +0 -270
  408. package/src/dashboard/docs/skills.html +0 -206
  409. package/src/dashboard/docs/task-pipeline.html +0 -261
  410. package/src/dashboard/docs/transport-encryption.html +0 -359
  411. package/src/dashboard/docs/users.html +0 -225
  412. package/src/dashboard/docs/vault.html +0 -260
  413. package/src/dashboard/docs/workforce.html +0 -245
  414. package/src/dashboard/index.html +0 -444
  415. package/src/dashboard/pages/activity.js +0 -379
  416. package/src/dashboard/pages/agent-detail/activity.js +0 -277
  417. package/src/dashboard/pages/agent-detail/autonomy.js +0 -244
  418. package/src/dashboard/pages/agent-detail/budget.js +0 -269
  419. package/src/dashboard/pages/agent-detail/channels.js +0 -494
  420. package/src/dashboard/pages/agent-detail/communication.js +0 -296
  421. package/src/dashboard/pages/agent-detail/configuration.js +0 -882
  422. package/src/dashboard/pages/agent-detail/deployment.js +0 -958
  423. package/src/dashboard/pages/agent-detail/email.js +0 -674
  424. package/src/dashboard/pages/agent-detail/guardrails.js +0 -521
  425. package/src/dashboard/pages/agent-detail/index.js +0 -261
  426. package/src/dashboard/pages/agent-detail/manager.js +0 -357
  427. package/src/dashboard/pages/agent-detail/meeting-browser.js +0 -933
  428. package/src/dashboard/pages/agent-detail/memory.js +0 -368
  429. package/src/dashboard/pages/agent-detail/overview.js +0 -844
  430. package/src/dashboard/pages/agent-detail/permissions.js +0 -1163
  431. package/src/dashboard/pages/agent-detail/personal-details.js +0 -404
  432. package/src/dashboard/pages/agent-detail/security.js +0 -409
  433. package/src/dashboard/pages/agent-detail/shared.js +0 -85
  434. package/src/dashboard/pages/agent-detail/skills-section.js +0 -183
  435. package/src/dashboard/pages/agent-detail/tool-security.js +0 -380
  436. package/src/dashboard/pages/agent-detail/tools.js +0 -322
  437. package/src/dashboard/pages/agent-detail/whatsapp.js +0 -824
  438. package/src/dashboard/pages/agent-detail/workforce.js +0 -683
  439. package/src/dashboard/pages/agents.js +0 -1242
  440. package/src/dashboard/pages/approvals.js +0 -100
  441. package/src/dashboard/pages/audit.js +0 -198
  442. package/src/dashboard/pages/cluster.js +0 -512
  443. package/src/dashboard/pages/community-skills.js +0 -1219
  444. package/src/dashboard/pages/compliance.js +0 -475
  445. package/src/dashboard/pages/dashboard.js +0 -180
  446. package/src/dashboard/pages/database-access.js +0 -812
  447. package/src/dashboard/pages/dlp.js +0 -293
  448. package/src/dashboard/pages/domain-status.js +0 -951
  449. package/src/dashboard/pages/guardrails.js +0 -1035
  450. package/src/dashboard/pages/journal.js +0 -172
  451. package/src/dashboard/pages/knowledge-contributions.js +0 -1682
  452. package/src/dashboard/pages/knowledge-import.js +0 -455
  453. package/src/dashboard/pages/knowledge.js +0 -582
  454. package/src/dashboard/pages/login.js +0 -1056
  455. package/src/dashboard/pages/memory-transfer.js +0 -631
  456. package/src/dashboard/pages/messages.js +0 -303
  457. package/src/dashboard/pages/org-chart.js +0 -349
  458. package/src/dashboard/pages/organizations.js +0 -1081
  459. package/src/dashboard/pages/roles.js +0 -780
  460. package/src/dashboard/pages/settings.js +0 -3790
  461. package/src/dashboard/pages/skill-connections.js +0 -982
  462. package/src/dashboard/pages/skills.js +0 -879
  463. package/src/dashboard/pages/task-pipeline.js +0 -684
  464. package/src/dashboard/pages/users.js +0 -867
  465. package/src/dashboard/pages/vault.js +0 -791
  466. package/src/dashboard/pages/workforce.js +0 -851
  467. package/src/dashboard/vendor/react-dom.development.js +0 -29924
  468. package/src/dashboard/vendor/react-dom.production.min.js +0 -267
  469. package/src/dashboard/vendor/react.development.js +0 -3343
  470. package/src/dashboard/vendor/react.production.min.js +0 -31
  471. package/src/database-access/agent-tools.ts +0 -193
  472. package/src/database-access/connection-manager.ts +0 -1341
  473. package/src/database-access/index.ts +0 -21
  474. package/src/database-access/query-sanitizer.ts +0 -220
  475. package/src/database-access/routes.ts +0 -226
  476. package/src/database-access/types.ts +0 -226
  477. package/src/db/adapter.ts +0 -510
  478. package/src/db/dynamodb.ts +0 -454
  479. package/src/db/factory.ts +0 -129
  480. package/src/db/mongodb.ts +0 -360
  481. package/src/db/mysql.ts +0 -531
  482. package/src/db/postgres.ts +0 -863
  483. package/src/db/proxy.ts +0 -39
  484. package/src/db/resolve-driver.ts +0 -29
  485. package/src/db/sql-schema.ts +0 -124
  486. package/src/db/sqlite.ts +0 -493
  487. package/src/db/turso.ts +0 -470
  488. package/src/deploy/fly.ts +0 -368
  489. package/src/deploy/managed.ts +0 -235
  490. package/src/domain-lock/cli-recover.ts +0 -591
  491. package/src/domain-lock/cli-verify.ts +0 -190
  492. package/src/domain-lock/index.ts +0 -220
  493. package/src/engine/activity-routes.ts +0 -154
  494. package/src/engine/activity.ts +0 -568
  495. package/src/engine/agent-autonomy.ts +0 -974
  496. package/src/engine/agent-config.ts +0 -646
  497. package/src/engine/agent-heartbeat.ts +0 -720
  498. package/src/engine/agent-hierarchy.ts +0 -1064
  499. package/src/engine/agent-memory.ts +0 -806
  500. package/src/engine/agent-notify.ts +0 -50
  501. package/src/engine/agent-routes.ts +0 -2583
  502. package/src/engine/agent-status.ts +0 -311
  503. package/src/engine/ambient-memory.ts +0 -401
  504. package/src/engine/approvals.ts +0 -615
  505. package/src/engine/assets/thinking-hum.mp3 +0 -0
  506. package/src/engine/catalog-routes.ts +0 -232
  507. package/src/engine/chat-poller.ts +0 -913
  508. package/src/engine/chat-webhook-routes.ts +0 -304
  509. package/src/engine/cli-build-skill.ts +0 -285
  510. package/src/engine/cli-submit-skill.ts +0 -200
  511. package/src/engine/cli-validate.ts +0 -188
  512. package/src/engine/cluster.ts +0 -278
  513. package/src/engine/communication-routes.ts +0 -139
  514. package/src/engine/communication.ts +0 -765
  515. package/src/engine/community-registry.ts +0 -1529
  516. package/src/engine/community-routes.ts +0 -260
  517. package/src/engine/compliance-routes.ts +0 -133
  518. package/src/engine/compliance.ts +0 -1679
  519. package/src/engine/config-bus.ts +0 -103
  520. package/src/engine/db-adapter.ts +0 -1156
  521. package/src/engine/db-schema.ts +0 -1945
  522. package/src/engine/deploy-schema-routes.ts +0 -176
  523. package/src/engine/deployer.ts +0 -957
  524. package/src/engine/dlp-routes.ts +0 -101
  525. package/src/engine/dlp.ts +0 -410
  526. package/src/engine/email-poller.ts +0 -855
  527. package/src/engine/emoji.ts +0 -106
  528. package/src/engine/guardrail-routes.ts +0 -125
  529. package/src/engine/guardrails.ts +0 -465
  530. package/src/engine/index.ts +0 -255
  531. package/src/engine/journal-routes.ts +0 -56
  532. package/src/engine/journal.ts +0 -249
  533. package/src/engine/knowledge-contribution-routes.ts +0 -633
  534. package/src/engine/knowledge-contribution.ts +0 -1386
  535. package/src/engine/knowledge-import/chunker.ts +0 -241
  536. package/src/engine/knowledge-import/import-manager.ts +0 -416
  537. package/src/engine/knowledge-import/index.ts +0 -27
  538. package/src/engine/knowledge-import/processors/clean.ts +0 -149
  539. package/src/engine/knowledge-import/processors/extract-gdrive.ts +0 -102
  540. package/src/engine/knowledge-import/processors/extract-github.ts +0 -74
  541. package/src/engine/knowledge-import/processors/extract-sharepoint.ts +0 -69
  542. package/src/engine/knowledge-import/processors/extract-web.ts +0 -275
  543. package/src/engine/knowledge-import/processors/index.ts +0 -18
  544. package/src/engine/knowledge-import/processors/pipeline.ts +0 -171
  545. package/src/engine/knowledge-import/processors/types.ts +0 -78
  546. package/src/engine/knowledge-import/processors/validate.ts +0 -150
  547. package/src/engine/knowledge-import/provider-file-upload.ts +0 -95
  548. package/src/engine/knowledge-import/provider-github.ts +0 -144
  549. package/src/engine/knowledge-import/provider-google-sites.ts +0 -323
  550. package/src/engine/knowledge-import/provider-sharepoint.ts +0 -276
  551. package/src/engine/knowledge-import/provider-url.ts +0 -218
  552. package/src/engine/knowledge-import/routes.ts +0 -94
  553. package/src/engine/knowledge-import/types.ts +0 -92
  554. package/src/engine/knowledge-routes.ts +0 -231
  555. package/src/engine/knowledge.ts +0 -587
  556. package/src/engine/lifecycle.ts +0 -1420
  557. package/src/engine/mcp-process-manager.ts +0 -573
  558. package/src/engine/meeting-monitor.ts +0 -483
  559. package/src/engine/meeting-voice-intelligence.ts +0 -340
  560. package/src/engine/memory-routes.ts +0 -142
  561. package/src/engine/memory-transfer-routes.ts +0 -339
  562. package/src/engine/messaging-history.ts +0 -177
  563. package/src/engine/messaging-poller.ts +0 -786
  564. package/src/engine/model-fallback.ts +0 -141
  565. package/src/engine/oauth-connect-routes.ts +0 -603
  566. package/src/engine/oauth-connect.ts +0 -304
  567. package/src/engine/onboarding-routes.ts +0 -148
  568. package/src/engine/onboarding.ts +0 -574
  569. package/src/engine/org-approval-routes.ts +0 -146
  570. package/src/engine/org-integration-routes.ts +0 -399
  571. package/src/engine/org-integrations.ts +0 -608
  572. package/src/engine/org-policies.ts +0 -502
  573. package/src/engine/policy-import-routes.ts +0 -125
  574. package/src/engine/policy-import.ts +0 -1186
  575. package/src/engine/policy-routes.ts +0 -163
  576. package/src/engine/routes.ts +0 -1236
  577. package/src/engine/screen-unlock.ts +0 -136
  578. package/src/engine/session-router.ts +0 -212
  579. package/src/engine/skill-updater-routes.ts +0 -132
  580. package/src/engine/skill-updater.ts +0 -480
  581. package/src/engine/skill-validator.ts +0 -331
  582. package/src/engine/skills/agent-management.ts +0 -119
  583. package/src/engine/skills/agent-memory.ts +0 -19
  584. package/src/engine/skills/agenticmail.ts +0 -116
  585. package/src/engine/skills/core-tools.ts +0 -25
  586. package/src/engine/skills/database-access.ts +0 -78
  587. package/src/engine/skills/enterprise-code-sandbox.ts +0 -113
  588. package/src/engine/skills/enterprise-database.ts +0 -123
  589. package/src/engine/skills/enterprise-diff.ts +0 -95
  590. package/src/engine/skills/enterprise-documents.ts +0 -162
  591. package/src/engine/skills/enterprise-http.ts +0 -99
  592. package/src/engine/skills/enterprise-security-scan.ts +0 -125
  593. package/src/engine/skills/enterprise-spreadsheet.ts +0 -171
  594. package/src/engine/skills/gws-admin.ts +0 -18
  595. package/src/engine/skills/gws-calendar.ts +0 -21
  596. package/src/engine/skills/gws-chat.ts +0 -29
  597. package/src/engine/skills/gws-contacts.ts +0 -20
  598. package/src/engine/skills/gws-docs.ts +0 -18
  599. package/src/engine/skills/gws-drive.ts +0 -23
  600. package/src/engine/skills/gws-forms.ts +0 -23
  601. package/src/engine/skills/gws-gmail.ts +0 -30
  602. package/src/engine/skills/gws-groups.ts +0 -17
  603. package/src/engine/skills/gws-keep.ts +0 -17
  604. package/src/engine/skills/gws-maps.ts +0 -25
  605. package/src/engine/skills/gws-meet.ts +0 -23
  606. package/src/engine/skills/gws-sheets.ts +0 -22
  607. package/src/engine/skills/gws-sites.ts +0 -16
  608. package/src/engine/skills/gws-slides.ts +0 -27
  609. package/src/engine/skills/gws-tasks.ts +0 -22
  610. package/src/engine/skills/gws-vault.ts +0 -17
  611. package/src/engine/skills/index.ts +0 -159
  612. package/src/engine/skills/knowledge-search.ts +0 -18
  613. package/src/engine/skills/local-system.ts +0 -61
  614. package/src/engine/skills/m365-admin.ts +0 -18
  615. package/src/engine/skills/m365-bookings.ts +0 -17
  616. package/src/engine/skills/m365-copilot.ts +0 -17
  617. package/src/engine/skills/m365-excel.ts +0 -60
  618. package/src/engine/skills/m365-forms.ts +0 -17
  619. package/src/engine/skills/m365-onedrive.ts +0 -60
  620. package/src/engine/skills/m365-onenote.ts +0 -17
  621. package/src/engine/skills/m365-outlook.ts +0 -27
  622. package/src/engine/skills/m365-planner.ts +0 -18
  623. package/src/engine/skills/m365-power-automate.ts +0 -18
  624. package/src/engine/skills/m365-power-bi.ts +0 -19
  625. package/src/engine/skills/m365-powerpoint.ts +0 -33
  626. package/src/engine/skills/m365-sharepoint.ts +0 -20
  627. package/src/engine/skills/m365-teams.ts +0 -21
  628. package/src/engine/skills/m365-todo.ts +0 -17
  629. package/src/engine/skills/m365-whiteboard.ts +0 -16
  630. package/src/engine/skills/m365-word.ts +0 -42
  631. package/src/engine/skills/mcp-bridge.ts +0 -45
  632. package/src/engine/skills/meeting-lifecycle.ts +0 -20
  633. package/src/engine/skills/messaging.ts +0 -46
  634. package/src/engine/skills/visual-memory.ts +0 -25
  635. package/src/engine/skills.ts +0 -688
  636. package/src/engine/soul-library.ts +0 -142
  637. package/src/engine/soul-templates.json +0 -1525
  638. package/src/engine/storage-manager.ts +0 -252
  639. package/src/engine/storage-routes.ts +0 -113
  640. package/src/engine/storage.ts +0 -528
  641. package/src/engine/task-poller.ts +0 -394
  642. package/src/engine/task-queue-after-spawn.ts +0 -66
  643. package/src/engine/task-queue-before-spawn.ts +0 -113
  644. package/src/engine/task-queue-routes.ts +0 -161
  645. package/src/engine/task-queue.ts +0 -664
  646. package/src/engine/tenant.ts +0 -409
  647. package/src/engine/tool-catalog.ts +0 -354
  648. package/src/engine/vault-routes.ts +0 -134
  649. package/src/engine/vault.ts +0 -601
  650. package/src/engine/workforce-routes.ts +0 -331
  651. package/src/engine/workforce.ts +0 -1161
  652. package/src/index.ts +0 -77
  653. package/src/lib/cidr.ts +0 -122
  654. package/src/lib/config-store.ts +0 -86
  655. package/src/lib/resilience.ts +0 -326
  656. package/src/lib/text-search.ts +0 -358
  657. package/src/mcp/adapters/activecampaign.adapter.ts +0 -391
  658. package/src/mcp/adapters/adobe-sign.adapter.ts +0 -469
  659. package/src/mcp/adapters/adp.adapter.ts +0 -358
  660. package/src/mcp/adapters/airtable.adapter.ts +0 -273
  661. package/src/mcp/adapters/apollo.adapter.ts +0 -420
  662. package/src/mcp/adapters/asana.adapter.ts +0 -315
  663. package/src/mcp/adapters/auth0.adapter.ts +0 -386
  664. package/src/mcp/adapters/aws.adapter.ts +0 -345
  665. package/src/mcp/adapters/azure-devops.adapter.ts +0 -389
  666. package/src/mcp/adapters/bamboohr.adapter.ts +0 -376
  667. package/src/mcp/adapters/basecamp.adapter.ts +0 -366
  668. package/src/mcp/adapters/bigcommerce.adapter.ts +0 -429
  669. package/src/mcp/adapters/bitbucket.adapter.ts +0 -260
  670. package/src/mcp/adapters/box.adapter.ts +0 -350
  671. package/src/mcp/adapters/brex.adapter.ts +0 -367
  672. package/src/mcp/adapters/buffer.adapter.ts +0 -303
  673. package/src/mcp/adapters/calendly.adapter.ts +0 -262
  674. package/src/mcp/adapters/canva.adapter.ts +0 -256
  675. package/src/mcp/adapters/chargebee.adapter.ts +0 -448
  676. package/src/mcp/adapters/circleci.adapter.ts +0 -216
  677. package/src/mcp/adapters/clickup.adapter.ts +0 -335
  678. package/src/mcp/adapters/close.adapter.ts +0 -390
  679. package/src/mcp/adapters/cloudflare.adapter.ts +0 -378
  680. package/src/mcp/adapters/confluence.adapter.ts +0 -301
  681. package/src/mcp/adapters/contentful.adapter.ts +0 -355
  682. package/src/mcp/adapters/copper.adapter.ts +0 -468
  683. package/src/mcp/adapters/crisp.adapter.ts +0 -415
  684. package/src/mcp/adapters/crowdstrike.adapter.ts +0 -413
  685. package/src/mcp/adapters/datadog.adapter.ts +0 -373
  686. package/src/mcp/adapters/digitalocean.adapter.ts +0 -336
  687. package/src/mcp/adapters/discord.adapter.ts +0 -248
  688. package/src/mcp/adapters/docker.adapter.ts +0 -238
  689. package/src/mcp/adapters/docusign.adapter.ts +0 -431
  690. package/src/mcp/adapters/drift.adapter.ts +0 -386
  691. package/src/mcp/adapters/dropbox.adapter.ts +0 -315
  692. package/src/mcp/adapters/figma.adapter.ts +0 -302
  693. package/src/mcp/adapters/firebase.adapter.ts +0 -446
  694. package/src/mcp/adapters/flyio.adapter.ts +0 -302
  695. package/src/mcp/adapters/freshbooks.adapter.ts +0 -474
  696. package/src/mcp/adapters/freshdesk.adapter.ts +0 -441
  697. package/src/mcp/adapters/freshsales.adapter.ts +0 -457
  698. package/src/mcp/adapters/freshservice.adapter.ts +0 -481
  699. package/src/mcp/adapters/front.adapter.ts +0 -357
  700. package/src/mcp/adapters/github-actions.adapter.ts +0 -329
  701. package/src/mcp/adapters/github.adapter.ts +0 -387
  702. package/src/mcp/adapters/gitlab.adapter.ts +0 -368
  703. package/src/mcp/adapters/gong.adapter.ts +0 -386
  704. package/src/mcp/adapters/google-ads.adapter.ts +0 -363
  705. package/src/mcp/adapters/google-analytics.adapter.ts +0 -316
  706. package/src/mcp/adapters/google-cloud.adapter.ts +0 -312
  707. package/src/mcp/adapters/gotomeeting.adapter.ts +0 -255
  708. package/src/mcp/adapters/grafana.adapter.ts +0 -361
  709. package/src/mcp/adapters/greenhouse.adapter.ts +0 -354
  710. package/src/mcp/adapters/gusto.adapter.ts +0 -329
  711. package/src/mcp/adapters/hashicorp-vault.adapter.ts +0 -355
  712. package/src/mcp/adapters/heroku.adapter.ts +0 -291
  713. package/src/mcp/adapters/hibob.adapter.ts +0 -334
  714. package/src/mcp/adapters/hootsuite.adapter.ts +0 -322
  715. package/src/mcp/adapters/hubspot.adapter.ts +0 -400
  716. package/src/mcp/adapters/huggingface.adapter.ts +0 -349
  717. package/src/mcp/adapters/index.ts +0 -524
  718. package/src/mcp/adapters/intercom.adapter.ts +0 -269
  719. package/src/mcp/adapters/jira.adapter.ts +0 -482
  720. package/src/mcp/adapters/klaviyo.adapter.ts +0 -353
  721. package/src/mcp/adapters/kubernetes.adapter.ts +0 -431
  722. package/src/mcp/adapters/lattice.adapter.ts +0 -339
  723. package/src/mcp/adapters/launchdarkly.adapter.ts +0 -368
  724. package/src/mcp/adapters/lever.adapter.ts +0 -347
  725. package/src/mcp/adapters/linear.adapter.ts +0 -300
  726. package/src/mcp/adapters/linkedin.adapter.ts +0 -331
  727. package/src/mcp/adapters/livechat.adapter.ts +0 -259
  728. package/src/mcp/adapters/loom.adapter.ts +0 -230
  729. package/src/mcp/adapters/mailchimp.adapter.ts +0 -394
  730. package/src/mcp/adapters/mailgun.adapter.ts +0 -425
  731. package/src/mcp/adapters/miro.adapter.ts +0 -274
  732. package/src/mcp/adapters/mixpanel.adapter.ts +0 -324
  733. package/src/mcp/adapters/monday.adapter.ts +0 -308
  734. package/src/mcp/adapters/mongodb-atlas.adapter.ts +0 -345
  735. package/src/mcp/adapters/neon.adapter.ts +0 -312
  736. package/src/mcp/adapters/netlify.adapter.ts +0 -324
  737. package/src/mcp/adapters/netsuite.adapter.ts +0 -411
  738. package/src/mcp/adapters/newrelic.adapter.ts +0 -339
  739. package/src/mcp/adapters/notion.adapter.ts +0 -338
  740. package/src/mcp/adapters/okta.adapter.ts +0 -394
  741. package/src/mcp/adapters/openai.adapter.ts +0 -315
  742. package/src/mcp/adapters/opsgenie.adapter.ts +0 -375
  743. package/src/mcp/adapters/outreach.adapter.ts +0 -372
  744. package/src/mcp/adapters/paddle.adapter.ts +0 -467
  745. package/src/mcp/adapters/pagerduty.adapter.ts +0 -412
  746. package/src/mcp/adapters/pandadoc.adapter.ts +0 -389
  747. package/src/mcp/adapters/paypal.adapter.ts +0 -465
  748. package/src/mcp/adapters/personio.adapter.ts +0 -401
  749. package/src/mcp/adapters/pinecone.adapter.ts +0 -340
  750. package/src/mcp/adapters/pipedrive.adapter.ts +0 -324
  751. package/src/mcp/adapters/plaid.adapter.ts +0 -444
  752. package/src/mcp/adapters/postmark.adapter.ts +0 -387
  753. package/src/mcp/adapters/power-automate.adapter.ts +0 -388
  754. package/src/mcp/adapters/quickbooks.adapter.ts +0 -431
  755. package/src/mcp/adapters/recurly.adapter.ts +0 -433
  756. package/src/mcp/adapters/reddit.adapter.ts +0 -371
  757. package/src/mcp/adapters/render.adapter.ts +0 -332
  758. package/src/mcp/adapters/ringcentral.adapter.ts +0 -281
  759. package/src/mcp/adapters/rippling.adapter.ts +0 -287
  760. package/src/mcp/adapters/salesforce.adapter.ts +0 -321
  761. package/src/mcp/adapters/salesloft.adapter.ts +0 -413
  762. package/src/mcp/adapters/sanity.adapter.ts +0 -363
  763. package/src/mcp/adapters/sap.adapter.ts +0 -483
  764. package/src/mcp/adapters/segment.adapter.ts +0 -260
  765. package/src/mcp/adapters/sendgrid.adapter.ts +0 -265
  766. package/src/mcp/adapters/sentry.adapter.ts +0 -331
  767. package/src/mcp/adapters/servicenow.adapter.ts +0 -468
  768. package/src/mcp/adapters/shopify.adapter.ts +0 -451
  769. package/src/mcp/adapters/shortcut.adapter.ts +0 -290
  770. package/src/mcp/adapters/slack.adapter.ts +0 -380
  771. package/src/mcp/adapters/smartsheet.adapter.ts +0 -326
  772. package/src/mcp/adapters/snowflake.adapter.ts +0 -347
  773. package/src/mcp/adapters/snyk.adapter.ts +0 -394
  774. package/src/mcp/adapters/splunk.adapter.ts +0 -403
  775. package/src/mcp/adapters/square.adapter.ts +0 -467
  776. package/src/mcp/adapters/statuspage.adapter.ts +0 -401
  777. package/src/mcp/adapters/stripe.adapter.ts +0 -380
  778. package/src/mcp/adapters/supabase.adapter.ts +0 -334
  779. package/src/mcp/adapters/teamwork.adapter.ts +0 -404
  780. package/src/mcp/adapters/telegram.adapter.ts +0 -299
  781. package/src/mcp/adapters/terraform.adapter.ts +0 -300
  782. package/src/mcp/adapters/todoist.adapter.ts +0 -239
  783. package/src/mcp/adapters/trello.adapter.ts +0 -316
  784. package/src/mcp/adapters/twilio.adapter.ts +0 -233
  785. package/src/mcp/adapters/twitter.adapter.ts +0 -348
  786. package/src/mcp/adapters/vercel.adapter.ts +0 -219
  787. package/src/mcp/adapters/weaviate.adapter.ts +0 -371
  788. package/src/mcp/adapters/webex.adapter.ts +0 -237
  789. package/src/mcp/adapters/webflow.adapter.ts +0 -287
  790. package/src/mcp/adapters/whatsapp.adapter.ts +0 -273
  791. package/src/mcp/adapters/whereby.adapter.ts +0 -240
  792. package/src/mcp/adapters/woocommerce.adapter.ts +0 -454
  793. package/src/mcp/adapters/wordpress.adapter.ts +0 -455
  794. package/src/mcp/adapters/workday.adapter.ts +0 -354
  795. package/src/mcp/adapters/wrike.adapter.ts +0 -349
  796. package/src/mcp/adapters/xero.adapter.ts +0 -472
  797. package/src/mcp/adapters/youtube.adapter.ts +0 -401
  798. package/src/mcp/adapters/zendesk.adapter.ts +0 -399
  799. package/src/mcp/adapters/zoho-crm.adapter.ts +0 -410
  800. package/src/mcp/adapters/zoom.adapter.ts +0 -241
  801. package/src/mcp/adapters/zuora.adapter.ts +0 -476
  802. package/src/mcp/framework/api-executor.ts +0 -192
  803. package/src/mcp/framework/aws-sigv4.ts +0 -216
  804. package/src/mcp/framework/credential-resolver.ts +0 -128
  805. package/src/mcp/framework/oauth-token-manager.ts +0 -22
  806. package/src/mcp/framework/skill-mcp-framework.ts +0 -226
  807. package/src/mcp/framework/types.ts +0 -130
  808. package/src/mcp/index.ts +0 -124
  809. package/src/mcp/integration-catalog.ts +0 -178
  810. package/src/middleware/dns-rebinding.ts +0 -44
  811. package/src/middleware/egress-filter.ts +0 -104
  812. package/src/middleware/firewall.ts +0 -192
  813. package/src/middleware/geo-ip.ts +0 -156
  814. package/src/middleware/index.ts +0 -390
  815. package/src/middleware/network-config.ts +0 -90
  816. package/src/middleware/proxy-config.ts +0 -71
  817. package/src/middleware/request-limits.ts +0 -59
  818. package/src/middleware/transport-encryption.ts +0 -398
  819. package/src/registry/cli.ts +0 -63
  820. package/src/registry/server.ts +0 -504
  821. package/src/runtime/agent-loop.ts +0 -779
  822. package/src/runtime/compaction.ts +0 -638
  823. package/src/runtime/email-channel.ts +0 -120
  824. package/src/runtime/environment.ts +0 -300
  825. package/src/runtime/followup.ts +0 -211
  826. package/src/runtime/gateway.ts +0 -260
  827. package/src/runtime/hooks.ts +0 -564
  828. package/src/runtime/index.ts +0 -1110
  829. package/src/runtime/llm-client.ts +0 -1056
  830. package/src/runtime/model-router.ts +0 -97
  831. package/src/runtime/providers.ts +0 -228
  832. package/src/runtime/session-manager.ts +0 -345
  833. package/src/runtime/subagent.ts +0 -153
  834. package/src/runtime/tool-executor.ts +0 -208
  835. package/src/runtime/types.ts +0 -255
  836. package/src/security/brute-force.ts +0 -423
  837. package/src/security/config.ts +0 -159
  838. package/src/security/csp.ts +0 -407
  839. package/src/security/external-content.ts +0 -299
  840. package/src/security/index.ts +0 -557
  841. package/src/security/input-sanitizer.ts +0 -452
  842. package/src/security/output-filter.ts +0 -575
  843. package/src/security/port-scanner.ts +0 -342
  844. package/src/security/prompt-guard.ts +0 -387
  845. package/src/security/sql-guard.ts +0 -338
  846. package/src/security/threat-logger.ts +0 -484
  847. package/src/server.ts +0 -828
  848. package/src/setup/company.ts +0 -183
  849. package/src/setup/database.ts +0 -153
  850. package/src/setup/deployment.ts +0 -561
  851. package/src/setup/domain.ts +0 -112
  852. package/src/setup/index.ts +0 -171
  853. package/src/setup/provision.ts +0 -532
  854. package/src/setup/registration.ts +0 -302
  855. package/src/system-prompts/catchup.ts +0 -48
  856. package/src/system-prompts/google/calendar.ts +0 -37
  857. package/src/system-prompts/google/chat.ts +0 -92
  858. package/src/system-prompts/google/contacts.ts +0 -25
  859. package/src/system-prompts/google/docs.ts +0 -29
  860. package/src/system-prompts/google/drive.ts +0 -34
  861. package/src/system-prompts/google/forms.ts +0 -25
  862. package/src/system-prompts/google/gmail.ts +0 -50
  863. package/src/system-prompts/google/index.ts +0 -23
  864. package/src/system-prompts/google/maps.ts +0 -20
  865. package/src/system-prompts/google/meet.ts +0 -130
  866. package/src/system-prompts/google/sheets.ts +0 -32
  867. package/src/system-prompts/google/slides.ts +0 -26
  868. package/src/system-prompts/google/tasks.ts +0 -27
  869. package/src/system-prompts/index.ts +0 -88
  870. package/src/system-prompts/microsoft/contacts.ts +0 -34
  871. package/src/system-prompts/microsoft/excel.ts +0 -52
  872. package/src/system-prompts/microsoft/index.ts +0 -31
  873. package/src/system-prompts/microsoft/onedrive.ts +0 -41
  874. package/src/system-prompts/microsoft/onenote.ts +0 -36
  875. package/src/system-prompts/microsoft/outlook-calendar.ts +0 -37
  876. package/src/system-prompts/microsoft/outlook-mail.ts +0 -46
  877. package/src/system-prompts/microsoft/planner.ts +0 -37
  878. package/src/system-prompts/microsoft/powerbi.ts +0 -38
  879. package/src/system-prompts/microsoft/powerpoint.ts +0 -35
  880. package/src/system-prompts/microsoft/sharepoint.ts +0 -44
  881. package/src/system-prompts/microsoft/teams.ts +0 -49
  882. package/src/system-prompts/microsoft/todo.ts +0 -37
  883. package/src/system-prompts/shared-blocks.ts +0 -87
  884. package/src/system-prompts/task.ts +0 -21
  885. package/src/system-prompts/triage.ts +0 -34
  886. package/src/types/hono-env.ts +0 -18
  887. package/src/types/optional-deps.d.ts +0 -10
  888. /package/{src → dist}/dashboard/HELP-TOOLTIPS-GUIDE.md +0 -0
@@ -1,239 +0,0 @@
1
- <!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">
2
- <title>Organization Chart — AgenticMail Enterprise</title>
3
- <link rel="stylesheet" href="/docs/docs-style.css">
4
- <script>document.documentElement.setAttribute('data-theme', localStorage.getItem('em_theme') || 'dark');</script>
5
- </head><body>
6
- <a href="javascript:history.back()" class="back">← Back to Dashboard</a>
7
- <h1>Organization Chart</h1>
8
- <p style="color:var(--text-muted);margin-bottom:24px">Visual hierarchy of all agents — reporting structure, status indicators, and interactive tree layout on a zoomable canvas.</p>
9
-
10
- <div class="toc">
11
- <h3>Table of Contents</h3>
12
- <ul>
13
- <li><a href="#overview">Overview</a></li>
14
- <li><a href="#how-it-works">How It Works</a></li>
15
- <li><a href="#key-concepts">Key Concepts</a></li>
16
- <li><a href="#canvas-interactions">Canvas Interactions</a></li>
17
- <li><a href="#node-cards">Node Cards</a></li>
18
- <li><a href="#summary-metrics">Summary Metrics</a></li>
19
- <li><a href="#hover-tooltip">Hover Tooltip</a></li>
20
- <li><a href="#external-managers">External Managers</a></li>
21
- <li><a href="#configuration">Configuration &amp; Setup</a></li>
22
- <li><a href="#api-reference">API Reference</a></li>
23
- <li><a href="#best-practices">Best Practices</a></li>
24
- <li><a href="#troubleshooting">Troubleshooting</a></li>
25
- <li><a href="#related">Related Pages</a></li>
26
- </ul>
27
- </div>
28
-
29
- <h2 id="overview">Overview</h2>
30
-
31
- <div class="tip">
32
- <strong>Non-technical summary:</strong> This page shows your AI agents organized like a company org chart — who reports to whom, who's online, and who's busy. Hover over any agent to see their details, and drag/zoom to explore large teams.
33
- </div>
34
-
35
- <p>The Organization Chart renders a top-down tree layout of all agents in your organization. Each agent is a card node showing name, role, state, and activity badges. Edges (SVG curved paths) connect agents to their managers, forming a visual reporting hierarchy.</p>
36
-
37
- <p>Key features:</p>
38
- <ul>
39
- <li>Automatic tree layout with top-down hierarchy</li>
40
- <li>Color-coded state indicators (running, stopped, error, paused)</li>
41
- <li>External (human) manager support with purple styling</li>
42
- <li>Interactive zoom, pan, and hover highlighting</li>
43
- <li>Summary metrics bar</li>
44
- <li>Rich hover tooltips with agent details</li>
45
- </ul>
46
-
47
- <h2 id="how-it-works">How It Works</h2>
48
-
49
- <ol>
50
- <li><strong>Fetch data</strong> — Two API calls: <code>/hierarchy/org-chart</code> for hierarchy data, and <code>/agents</code> for avatars and metadata.</li>
51
- <li><strong>Build tree</strong> — Agents are grouped by <code>managerId</code>. Agents without a manager (or with an unresolvable manager) become root nodes.</li>
52
- <li><strong>External managers</strong> — Agents with <code>managerType: 'external'</code> are grouped under synthetic purple nodes representing human managers.</li>
53
- <li><strong>Compute layout</strong> — A recursive algorithm calculates subtree widths, then positions nodes top-down with even spacing (220×72px nodes, 40px horizontal gap, 80px vertical gap).</li>
54
- <li><strong>Render</strong> — SVG cubic Bézier curves for edges, HTML div cards for nodes, all on a zoomable/pannable canvas.</li>
55
- <li><strong>Auto-fit</strong> — On first render, the canvas auto-zooms to fit all nodes in view.</li>
56
- </ol>
57
-
58
- <h2 id="key-concepts">Key Concepts</h2>
59
-
60
- <h3>Agent States</h3>
61
- <table>
62
- <thead><tr><th>State</th><th>Color</th><th>Meaning</th></tr></thead>
63
- <tbody>
64
- <tr><td>Running</td><td><span class="badge" style="background:#15803d22;color:#15803d">Green</span></td><td>Agent is active and processing</td></tr>
65
- <tr><td>Stopped</td><td><span class="badge" style="background:#6b739422;color:#6b7394">Gray</span></td><td>Agent is not running</td></tr>
66
- <tr><td>Error</td><td><span class="badge" style="background:#ef444422;color:#ef4444">Red</span></td><td>Agent encountered an error</td></tr>
67
- <tr><td>Paused</td><td><span class="badge" style="background:#991b1b22;color:#991b1b">Amber</span></td><td>Agent is temporarily paused</td></tr>
68
- <tr><td>Deploying</td><td><span class="badge" style="background:#06b6d422;color:#06b6d4">Cyan</span></td><td>Agent is being deployed</td></tr>
69
- <tr><td>External</td><td><span class="badge" style="background:#8b5cf622;color:#8b5cf6">Purple</span></td><td>Human/external manager node</td></tr>
70
- </tbody>
71
- </table>
72
-
73
- <h3>Manager Types</h3>
74
- <ul>
75
- <li><strong>Internal</strong> — Reports to another AI agent in the system</li>
76
- <li><strong>External</strong> — Reports to a human manager (shown as a purple node)</li>
77
- <li><strong>None</strong> — Root-level agent with no manager</li>
78
- </ul>
79
-
80
- <h2 id="canvas-interactions">Canvas Interactions</h2>
81
-
82
- <table>
83
- <thead><tr><th>Action</th><th>Effect</th></tr></thead>
84
- <tbody>
85
- <tr><td><strong>Hover</strong> on a node</td><td>Highlights the full chain (ancestors + descendants), dims everything else. Shows detail tooltip.</td></tr>
86
- <tr><td><strong>Scroll wheel</strong></td><td>Zoom in/out (15%–300%)</td></tr>
87
- <tr><td><strong>Click + drag</strong> background</td><td>Pan the canvas</td></tr>
88
- <tr><td><strong>Fit button</strong></td><td>Auto-zoom to fit all nodes</td></tr>
89
- <tr><td><strong>Refresh button</strong></td><td>Reload hierarchy data</td></tr>
90
- </tbody>
91
- </table>
92
-
93
- <h2 id="node-cards">Node Cards</h2>
94
-
95
- <p>Each agent node (220×72px) displays:</p>
96
- <ul>
97
- <li><strong>Avatar</strong> — Agent avatar image or colored initial circle with state-colored border</li>
98
- <li><strong>State dot</strong> — Small circle at bottom-right of avatar showing current state</li>
99
- <li><strong>Name</strong> — Agent name (truncated with ellipsis if too long)</li>
100
- <li><strong>Role</strong> — Agent role description</li>
101
- <li><strong>Badges:</strong>
102
- <ul>
103
- <li><span class="badge" style="background:#6366f122;color:#6366f1">MGR</span> — Agent is a manager (has subordinates)</li>
104
- <li><span class="badge" style="background:#991b1b22;color:#991b1b">N tasks</span> — Count of active tasks</li>
105
- <li><span class="badge" style="background:#ef444422;color:#ef4444">N err</span> — Errors today</li>
106
- </ul>
107
- </li>
108
- </ul>
109
-
110
- <h2 id="summary-metrics">Summary Metrics</h2>
111
-
112
- <p>Below the toolbar, a compact metrics bar shows:</p>
113
- <ul>
114
- <li><strong>Agents</strong> — Total count (excluding external managers)</li>
115
- <li><strong>Running</strong> — Active agents (green)</li>
116
- <li><strong>Stopped</strong> — Inactive agents (gray, shown only if &gt; 0)</li>
117
- <li><strong>Error</strong> — Agents in error state (red, shown only if &gt; 0)</li>
118
- <li><strong>Paused</strong> — Paused agents (amber, shown only if &gt; 0)</li>
119
- <li><strong>Human</strong> — External manager nodes (purple, shown only if &gt; 0)</li>
120
- <li><strong>Managers</strong> — Agents with subordinates</li>
121
- <li><strong>Active Tasks</strong> — Total across all agents</li>
122
- <li><strong>Errors Today</strong> — Total errors across all agents</li>
123
- </ul>
124
-
125
- <h2 id="hover-tooltip">Hover Tooltip</h2>
126
-
127
- <p>Hovering over any node shows a fixed-position tooltip with:</p>
128
- <ul>
129
- <li>Agent avatar, name, and role</li>
130
- <li>Current state</li>
131
- <li>Clocked-in status (Yes/No)</li>
132
- <li>Type (Internal AI / External Human)</li>
133
- <li>Reports to (manager name)</li>
134
- <li>Direct reports count</li>
135
- <li>Active tasks count</li>
136
- <li>Errors today count</li>
137
- <li>Last active timestamp (relative, e.g., "5m ago")</li>
138
- </ul>
139
-
140
- <h2 id="external-managers">External Managers</h2>
141
-
142
- <p>When agents have <code>managerType: 'external'</code> with a <code>managerName</code> and/or <code>managerEmail</code>, the system creates synthetic purple nodes representing human managers. These nodes:</p>
143
- <ul>
144
- <li>Use a purple gradient avatar</li>
145
- <li>Show "External Manager" as role</li>
146
- <li>Group all agents reporting to that human under a single node</li>
147
- <li>Are always shown as the root of their subtree</li>
148
- </ul>
149
-
150
- <div class="tip">
151
- <strong>Tip:</strong> External manager nodes let you visualize the complete reporting structure including human oversight, not just the AI-to-AI hierarchy.
152
- </div>
153
-
154
- <h2 id="configuration">Configuration &amp; Setup</h2>
155
-
156
- <h3>Setting Up the Hierarchy</h3>
157
- <p>The org chart automatically reflects agent configurations. To create hierarchy:</p>
158
- <ol>
159
- <li>Set <code>managerId</code> on agent config to point to another agent's ID for internal reporting</li>
160
- <li>Or set <code>managerType: 'external'</code> with <code>externalManagerName</code> and <code>externalManagerEmail</code> for human managers</li>
161
- <li>Agents without a manager appear as root nodes</li>
162
- </ol>
163
-
164
- <h3>Agent Avatars</h3>
165
- <p>Avatars are resolved from (in priority order):</p>
166
- <ol>
167
- <li><code>config.identity.avatar</code></li>
168
- <li><code>config.avatar</code></li>
169
- <li><code>config.persona.avatar</code></li>
170
- </ol>
171
- <p>If none is set, a colored circle with the first letter of the agent's name is shown.</p>
172
-
173
- <h2 id="api-reference">API Reference</h2>
174
-
175
- <table>
176
- <thead><tr><th>Endpoint</th><th>Method</th><th>Description</th></tr></thead>
177
- <tbody>
178
- <tr><td><code>/hierarchy/org-chart</code></td><td>GET</td><td>Full hierarchy with nodes (agentId, name, role, state, managerId, subordinates, etc.)</td></tr>
179
- <tr><td><code>/agents</code></td><td>GET</td><td>Agent list with config (for avatar resolution)</td></tr>
180
- </tbody>
181
- </table>
182
-
183
- <h3>Org Chart Node Fields</h3>
184
- <table>
185
- <thead><tr><th>Field</th><th>Type</th><th>Description</th></tr></thead>
186
- <tbody>
187
- <tr><td><code>agentId</code></td><td>string</td><td>Unique agent identifier</td></tr>
188
- <tr><td><code>name</code></td><td>string</td><td>Display name</td></tr>
189
- <tr><td><code>role</code></td><td>string</td><td>Agent role description</td></tr>
190
- <tr><td><code>state</code></td><td>string</td><td>running, stopped, error, paused, deploying</td></tr>
191
- <tr><td><code>managerId</code></td><td>string?</td><td>ID of parent agent</td></tr>
192
- <tr><td><code>managerType</code></td><td>string</td><td>internal, external, or none</td></tr>
193
- <tr><td><code>subordinateCount</code></td><td>number</td><td>Number of direct reports</td></tr>
194
- <tr><td><code>isManager</code></td><td>boolean</td><td>Whether this agent manages others</td></tr>
195
- <tr><td><code>activeTasks</code></td><td>number</td><td>Current active tasks</td></tr>
196
- <tr><td><code>errorsToday</code></td><td>number</td><td>Errors in the last 24h</td></tr>
197
- <tr><td><code>clockedIn</code></td><td>boolean</td><td>Workforce clock status</td></tr>
198
- </tbody>
199
- </table>
200
-
201
- <h2 id="best-practices">Best Practices</h2>
202
-
203
- <ul>
204
- <li><strong>Define clear reporting lines:</strong> Set <code>managerId</code> on every agent to create a clean hierarchy. Orphan agents cluster at the root level.</li>
205
- <li><strong>Use external managers:</strong> If humans oversee AI agents, set them as external managers for a complete picture.</li>
206
- <li><strong>Monitor error badges:</strong> Red error badges on nodes indicate agents needing attention — investigate promptly.</li>
207
- <li><strong>Keep teams balanced:</strong> If one manager agent has 20+ direct reports, consider adding intermediate management layers.</li>
208
- <li><strong>Set avatars:</strong> Custom avatars make the chart much easier to scan visually, especially with large teams.</li>
209
- <li><strong>Use Fit to View:</strong> After making hierarchy changes, click "Fit" to re-center the chart.</li>
210
- </ul>
211
-
212
- <h2 id="troubleshooting">Troubleshooting</h2>
213
-
214
- <table>
215
- <thead><tr><th>Issue</th><th>Solution</th></tr></thead>
216
- <tbody>
217
- <tr><td>Chart shows "No Organization Hierarchy Yet"</td><td>Add agents and set <code>managerId</code> to create reporting relationships. If agents exist but hierarchy endpoint returns null, the chart falls back to a flat list from <code>/agents</code>.</td></tr>
218
- <tr><td>All agents at root level</td><td>No <code>managerId</code> set on any agent. Configure manager relationships in agent settings.</td></tr>
219
- <tr><td>External manager not showing</td><td>Set <code>managerType: 'external'</code> with <code>externalManagerName</code> on the agent config. The email is optional but helps deduplicate.</td></tr>
220
- <tr><td>Avatars not showing</td><td>Set <code>config.identity.avatar</code> to a valid image URL on the agent.</td></tr>
221
- <tr><td>Canvas blank after loading</td><td>Click "Fit" to auto-zoom. The nodes may be outside the visible area.</td></tr>
222
- <tr><td>Nodes overlapping</td><td>The tree layout should prevent this. If it happens, check for circular manager references (Agent A manages B, B manages A).</td></tr>
223
- </tbody>
224
- </table>
225
-
226
- <h2 id="related">Related Pages</h2>
227
-
228
- <div class="nav">
229
- <a href="/docs/workforce.html">Workforce Management</a> — Agent schedules and clock management
230
- <a href="/docs/task-pipeline.html">Task Pipeline</a> — Task flow and delegation chains
231
- <a href="/docs/messages.html">Agent Messages</a> — Inter-agent communications
232
- <a href="/docs/activity.html">Activity Log</a> — Event and tool call history
233
- </div>
234
-
235
- <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)">
236
- <span>AgenticMail Enterprise Documentation</span>
237
- <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>
238
- </div>
239
- </body></html>
@@ -1,182 +0,0 @@
1
- <!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">
2
- <title>Organizations — AgenticMail Enterprise</title>
3
- <link rel="stylesheet" href="/docs/docs-style.css">
4
- <script>document.documentElement.setAttribute('data-theme', localStorage.getItem('em_theme') || 'dark');</script>
5
- </head><body>
6
- <a href="javascript:history.back()" class="back">← Back to Dashboard</a>
7
- <h1>Organizations</h1>
8
- <p style="color:var(--text-muted);margin-bottom:24px">Multi-tenant client management with billing, agent assignment, and revenue tracking</p>
9
-
10
- <div class="toc">
11
- <h3>Table of Contents</h3>
12
- <ul>
13
- <li><a href="#overview">Overview</a></li>
14
- <li><a href="#how-it-works">How It Works</a></li>
15
- <li><a href="#key-concepts">Key Concepts</a></li>
16
- <li><a href="#creating-organizations">Creating Organizations</a></li>
17
- <li><a href="#detail-view">Detail View</a></li>
18
- <li><a href="#billing">Billing &amp; Revenue Tracking</a></li>
19
- <li><a href="#api-reference">API Reference</a></li>
20
- <li><a href="#best-practices">Best Practices</a></li>
21
- <li><a href="#troubleshooting">Troubleshooting</a></li>
22
- <li><a href="#related">Related Pages</a></li>
23
- </ul>
24
- </div>
25
-
26
- <h2 id="overview">Overview</h2>
27
-
28
- <div class="tip">
29
- <strong>Non-technical summary:</strong> Organizations represent your clients or departments. Each organization is a separate tenant — you assign AI agents to organizations, set billing rates, and track revenue vs. costs. Think of it like managing client accounts at an agency: each client has their own agents, their own billing, and their own data boundary.
30
- </div>
31
-
32
- <p>The Organizations page (<code>OrganizationsPage</code>) provides full CRUD management for client organizations in a multi-tenant AgenticMail deployment. Organizations act as logical boundaries for agent assignment, knowledge base isolation, billing, and access control. Each organization has a unique slug, contact information, billing configuration, and a set of assigned agents.</p>
33
-
34
- <h2 id="how-it-works">How It Works</h2>
35
-
36
- <ol>
37
- <li><strong>Create an organization</strong> — Provide a name (auto-generates a URL-safe slug), contact details, description, and optional billing rate per agent per month.</li>
38
- <li><strong>Assign agents</strong> — Open the organization detail view and assign existing agents to it. Agents can be reassigned from other orgs.</li>
39
- <li><strong>Set billing rates</strong> — Configure a default per-agent monthly rate, or set custom rates per agent.</li>
40
- <li><strong>Monitor revenue</strong> — The billing tab shows revenue vs. token cost charts, margin calculations, and per-agent breakdowns.</li>
41
- <li><strong>Manage lifecycle</strong> — Activate, deactivate, or delete organizations as needed.</li>
42
- </ol>
43
-
44
- <h2 id="key-concepts">Key Concepts</h2>
45
-
46
- <h3>Organization Slug</h3>
47
- <p>A URL-safe identifier auto-generated from the organization name (e.g., "AgenticMail" → <code>agenticmail</code>). Slugs are immutable after creation and used throughout the system for routing and identification. You can manually edit the slug during creation.</p>
48
-
49
- <h3>Active vs. Inactive</h3>
50
- <p>Organizations can be toggled active/inactive. Deactivating an organization effectively suspends all linked agents. The toggle endpoint is <code>POST /api/organizations/{id}/toggle</code>.</p>
51
-
52
- <h3>Agent Assignment</h3>
53
- <p>Agents are assigned to organizations via <code>POST /api/agents/{id}/assign-org</code>. An agent can belong to only one organization at a time. Assigning an agent that's currently in another org will move it. Unassigning returns the agent to the default (internal) org.</p>
54
-
55
- <h2 id="creating-organizations">Creating Organizations</h2>
56
-
57
- <h3>Form Fields</h3>
58
- <table>
59
- <thead><tr><th>Field</th><th>Required</th><th>Description</th></tr></thead>
60
- <tbody>
61
- <tr><td>Name</td><td>Yes</td><td>Display name of the organization</td></tr>
62
- <tr><td>Slug</td><td>Yes</td><td>URL-safe identifier, auto-generated from name</td></tr>
63
- <tr><td>Contact Name</td><td>No</td><td>Primary contact person</td></tr>
64
- <tr><td>Contact Email</td><td>No</td><td>Primary contact email address</td></tr>
65
- <tr><td>Description</td><td>No</td><td>Brief description of the organization</td></tr>
66
- <tr><td>Billing Rate</td><td>No</td><td>Monthly rate per agent (default: 0.00)</td></tr>
67
- <tr><td>Currency</td><td>No</td><td>USD, EUR, GBP, NGN, CAD, or AUD (default: USD)</td></tr>
68
- </tbody>
69
- </table>
70
-
71
- <pre><code>POST /api/organizations
72
- Content-Type: application/json
73
-
74
- {
75
- "name": "AgenticMail",
76
- "slug": "agenticmail",
77
- "contact_name": "Ope Olatunji",
78
- "contact_email": "ope@agenticmail.com",
79
- "description": "Enterprise client — Q1 2026 onboarding",
80
- "billing_rate_per_agent": 99.00,
81
- "currency": "USD"
82
- }</code></pre>
83
-
84
- <h2 id="detail-view">Detail View</h2>
85
-
86
- <p>Clicking an organization card opens a detail modal with two tabs:</p>
87
-
88
- <h3>Agents Tab</h3>
89
- <ul>
90
- <li><strong>Linked agents list</strong> — Shows all agents assigned to this org with name, email, status badge, and an "Unassign" button</li>
91
- <li><strong>Assign agent dropdown</strong> — Lists all agents not currently in this org (including those in other orgs, labeled accordingly)</li>
92
- <li><strong>Status indicators</strong> — Active (green), Running (green), Suspended (yellow), Archived (gray)</li>
93
- </ul>
94
-
95
- <h3>Billing Tab</h3>
96
- <ul>
97
- <li><strong>Revenue vs Cost chart</strong> — Bar chart showing monthly revenue (green) and token cost (red) side by side</li>
98
- <li><strong>Summary stats</strong> — Total revenue, token cost, margin percentage, total tokens</li>
99
- <li><strong>Per-agent billing rates</strong> — Editable rate inputs for each agent (blank = uses org default)</li>
100
- <li><strong>Billing records table</strong> — Detailed monthly breakdown per agent: revenue, token cost, profit, tokens used</li>
101
- </ul>
102
-
103
- <div class="tip">
104
- <strong>How billing works:</strong> Each agent's monthly cost is calculated from LLM token usage. Revenue is the billing rate you set. The difference is your margin. Setting a billing rate of $99/agent/month with $3 in token costs gives you a 97% margin.
105
- </div>
106
-
107
- <h2 id="billing">Billing &amp; Revenue Tracking</h2>
108
-
109
- <p>Billing data is loaded from two endpoints:</p>
110
- <ul>
111
- <li><code>GET /api/organizations/{id}/billing-summary</code> — Monthly aggregated revenue, cost, and token counts</li>
112
- <li><code>GET /api/organizations/{id}/billing</code> — Individual billing records per agent per month</li>
113
- </ul>
114
-
115
- <p>Custom per-agent rates are saved via <code>PATCH /api/agents/{id}</code> with a <code>billingRate</code> field. The effective rate for an agent is: custom rate if set, otherwise the org's default rate.</p>
116
-
117
- <h2 id="api-reference">API Reference</h2>
118
-
119
- <table>
120
- <thead><tr><th>Endpoint</th><th>Method</th><th>Description</th></tr></thead>
121
- <tbody>
122
- <tr><td><code>/api/organizations</code></td><td>GET</td><td>List all organizations</td></tr>
123
- <tr><td><code>/api/organizations</code></td><td>POST</td><td>Create a new organization</td></tr>
124
- <tr><td><code>/api/organizations/{id}</code></td><td>GET</td><td>Get organization detail with linked agents</td></tr>
125
- <tr><td><code>/api/organizations/{id}</code></td><td>PATCH</td><td>Update organization fields</td></tr>
126
- <tr><td><code>/api/organizations/{id}</code></td><td>DELETE</td><td>Delete organization (must have 0 agents)</td></tr>
127
- <tr><td><code>/api/organizations/{id}/toggle</code></td><td>POST</td><td>Toggle active/inactive status</td></tr>
128
- <tr><td><code>/api/organizations/{id}/billing-summary</code></td><td>GET</td><td>Monthly billing aggregation</td></tr>
129
- <tr><td><code>/api/organizations/{id}/billing</code></td><td>GET</td><td>Per-agent billing records</td></tr>
130
- <tr><td><code>/api/agents/{id}/assign-org</code></td><td>POST</td><td>Assign agent to org</td></tr>
131
- <tr><td><code>/api/agents/{id}/unassign-org</code></td><td>POST</td><td>Remove agent from org</td></tr>
132
- <tr><td><code>/api/agents/{id}</code></td><td>PATCH</td><td>Update agent billing rate</td></tr>
133
- </tbody>
134
- </table>
135
-
136
- <h2 id="best-practices">Best Practices</h2>
137
-
138
- <ul>
139
- <li><strong>One org per client</strong> — Create a separate organization for each client to maintain data isolation and independent billing.</li>
140
- <li><strong>Set billing rates early</strong> — Configure rates before agents start processing tasks to ensure accurate revenue tracking from day one.</li>
141
- <li><strong>Use custom per-agent rates</strong> — Premium agents (e.g., with expensive models) should have higher billing rates to maintain margins.</li>
142
- <li><strong>Deactivate before deleting</strong> — Deactivate an organization first to confirm no critical workflows depend on it. Delete only when agent count is zero.</li>
143
- <li><strong>Monitor margins monthly</strong> — The billing tab's revenue vs. cost chart quickly reveals whether you're pricing correctly.</li>
144
- <li><strong>Slugs are permanent</strong> — Choose meaningful slugs during creation. They cannot be changed after the fact.</li>
145
- </ul>
146
-
147
- <h2 id="troubleshooting">Troubleshooting</h2>
148
-
149
- <div class="card">
150
- <h4>Cannot delete organization</h4>
151
- <p>Organizations can only be deleted when they have zero assigned agents. Unassign all agents first, then delete.</p>
152
- </div>
153
-
154
- <div class="card">
155
- <h4>Agent shows "[assigned elsewhere]" in dropdown</h4>
156
- <p>The agent is currently assigned to a different organization. Assigning it to this org will remove it from the previous one.</p>
157
- </div>
158
-
159
- <div class="card">
160
- <h4>Billing data shows $0.00 everywhere</h4>
161
- <p>Billing records are created as agents process tasks and accumulate token costs. New organizations will have empty billing until agents start working.</p>
162
- </div>
163
-
164
- <div class="danger">
165
- <strong>Deleting an organization is permanent.</strong> All billing history and configuration will be lost. Ensure you've exported any needed billing data before deletion.
166
- </div>
167
-
168
- <div class="nav">
169
- <h3 id="related">Related Pages</h3>
170
- <ul>
171
- <li><a href="/docs/agents.html">Agents</a> — Create and manage agents assigned to organizations</li>
172
- <li><a href="/docs/knowledge.html">Knowledge Bases</a> — Org-scoped document collections</li>
173
- <li><a href="/docs/approvals.html">Approvals</a> — Approve agent actions per organization</li>
174
- <li><a href="/docs/journal.html">Action Journal</a> — Org-filtered audit trail</li>
175
- </ul>
176
- </div>
177
-
178
- <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)">
179
- <span>AgenticMail Enterprise Documentation</span>
180
- <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>
181
- </div>
182
- </body></html>
@@ -1,195 +0,0 @@
1
- <!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">
2
- <title>Agent Roles — AgenticMail Enterprise</title>
3
- <link rel="stylesheet" href="/docs/docs-style.css">
4
- <script>document.documentElement.setAttribute('data-theme', localStorage.getItem('em_theme') || 'dark');</script>
5
- </head><body>
6
- <a href="javascript:history.back()" class="back">← Back to Dashboard</a>
7
- <h1>Agent Roles</h1>
8
- <p style="color:var(--text-muted);margin-bottom:24px">Create and manage agent role templates that appear in the Create Agent wizard — defining personality, skills, tone, and expertise for each agent type.</p>
9
-
10
- <div class="toc">
11
- <h3>Table of Contents</h3>
12
- <ul>
13
- <li><a href="#overview">Overview</a></li>
14
- <li><a href="#how-it-works">How It Works</a></li>
15
- <li><a href="#key-concepts">Key Concepts</a></li>
16
- <li><a href="#built-in-roles">Built-in Roles</a></li>
17
- <li><a href="#custom-roles">Creating Custom Roles</a></li>
18
- <li><a href="#personality">Personality / SOUL.md</a></li>
19
- <li><a href="#skills">Skills &amp; Presets</a></li>
20
- <li><a href="#org-scoping">Organization Scoping</a></li>
21
- <li><a href="#preview">Role Preview</a></li>
22
- <li><a href="#best-practices">Best Practices</a></li>
23
- <li><a href="#troubleshooting">Troubleshooting</a></li>
24
- <li><a href="#related">Related Pages</a></li>
25
- </ul>
26
- </div>
27
-
28
- <h2 id="overview">Overview</h2>
29
- <div class="card">
30
- <p><strong>For everyone:</strong> The Roles page manages the role templates that appear when creating a new AI agent. Each role template is like a job description — it defines who the agent is, how it communicates, what tools it uses, and what it's an expert in. When you select a role in the Create Agent wizard, all of this gets auto-configured, saving you from building each agent from scratch.</p>
31
- <p><strong>For technical users:</strong> Role templates are stored in two places: 51 built-in templates in <code>soul-templates.json</code> and custom templates in the <code>custom_roles</code> database table (migration v32). Custom roles can be org-scoped via <code>org_id</code>. The <code>/souls/by-category</code> API merges both sources, so custom roles appear alongside built-in ones in the Create Agent wizard. Each template contains a full SOUL.md personality prompt, identity metadata (role title, tone, language), suggested skills, and tags for search.</p>
32
- </div>
33
-
34
- <h2 id="how-it-works">How It Works</h2>
35
- <div class="card">
36
- <ol>
37
- <li><strong>Admin creates a role template</strong> via the Roles page — defining name, category, personality, skills, and tone.</li>
38
- <li><strong>Template appears in Create Agent wizard</strong> — Step 1 "Choose a Role Template" shows all built-in and custom templates grouped by category.</li>
39
- <li><strong>User selects the role</strong> — the wizard auto-fills the agent's personality (SOUL.md), job title, communication tone, suggested skills, and permission preset.</li>
40
- <li><strong>User customizes</strong> — all auto-filled fields can be edited before creating the agent.</li>
41
- </ol>
42
- <p>Custom role templates are merged with built-in templates in real-time. When the wizard loads, it queries <code>/api/engine/souls/by-category</code> which returns both sources combined.</p>
43
- </div>
44
-
45
- <h2 id="key-concepts">Key Concepts</h2>
46
- <div class="card">
47
- <table>
48
- <tr><th>Concept</th><th>Description</th></tr>
49
- <tr><td><strong>Role Template</strong></td><td>A complete agent identity definition — personality, skills, tone, tags. Used as a starting point when creating new agents.</td></tr>
50
- <tr><td><strong>Category</strong></td><td>One of 14 departments: Support, Sales, Engineering, Operations, HR, Finance, Marketing, Legal, Research, Creative, Executive, Data, Security, Education.</td></tr>
51
- <tr><td><strong>Personality</strong></td><td>The full SOUL.md prompt that defines the agent's identity, approach, communication style, expertise, principles, and boundaries. This is the core of what makes each role unique.</td></tr>
52
- <tr><td><strong>Identity</strong></td><td>Metadata: job title (e.g., "Customer Support Lead"), tone (formal/casual/professional/friendly), and language code.</td></tr>
53
- <tr><td><strong>Suggested Skills</strong></td><td>Tools auto-enabled when this role is selected — like agenticmail, web-search, memory, etc.</td></tr>
54
- <tr><td><strong>Suggested Preset</strong></td><td>Permission preset auto-applied when this role is selected (e.g., "Customer Support Agent").</td></tr>
55
- <tr><td><strong>Tags</strong></td><td>Searchable keywords (e.g., "support", "triage", "sla", "empathy") that help users find the right role.</td></tr>
56
- </table>
57
- </div>
58
-
59
- <h2 id="built-in-roles">Built-in Roles</h2>
60
- <div class="card">
61
- <p>AgenticMail ships with <strong>51 built-in role templates</strong> across 14 categories. These cover common enterprise agent roles from Customer Support Lead to Security Operations Analyst. Built-in roles:</p>
62
- <ul>
63
- <li>Cannot be edited or deleted (they're part of the core platform)</li>
64
- <li>Can be <strong>duplicated</strong> as a starting point for custom roles</li>
65
- <li>Are shown to all users regardless of organization</li>
66
- <li>Each has a comprehensive personality prompt with sections for Identity, Approach, Mental Models, Decision Framework, Communication Style, Expertise, Principles, and Boundaries</li>
67
- </ul>
68
- </div>
69
-
70
- <h2 id="custom-roles">Creating Custom Roles</h2>
71
- <div class="card">
72
- <p>Click <strong>"Create Role"</strong> to open the role form with four tabs:</p>
73
- <h4>General Tab</h4>
74
- <ul>
75
- <li><strong>Role Name</strong> — e.g., "Customer Onboarding Specialist". Auto-generates a slug ID.</li>
76
- <li><strong>Category</strong> — Which department this role belongs to (determines grouping in the wizard).</li>
77
- <li><strong>Description</strong> — Brief summary shown in the role card.</li>
78
- <li><strong>Job Title</strong> — The role title that appears in the agent's identity badges.</li>
79
- <li><strong>Tone</strong> — Formal, Casual, Professional, or Friendly.</li>
80
- <li><strong>Language</strong> — Language code (default: en).</li>
81
- <li><strong>Organization Scope</strong> — Global or restricted to a specific client org.</li>
82
- <li><strong>Tags</strong> — Keywords for searchability in the wizard.</li>
83
- </ul>
84
- <h4>Personality Tab</h4>
85
- <p>A large text editor for the full SOUL.md personality prompt. Aim for 500+ characters for a well-defined role. See <a href="#personality">Personality section</a>.</p>
86
- <h4>Skills &amp; Preset Tab</h4>
87
- <p>Select skills from the full catalog and optionally set a permission preset. See <a href="#skills">Skills section</a>.</p>
88
- <h4>Preview Tab</h4>
89
- <p>See exactly how the role will appear in the Create Agent wizard — the "resume card" with badges, skills, and personality excerpt.</p>
90
- </div>
91
-
92
- <h2 id="personality">Personality / SOUL.md</h2>
93
- <div class="card">
94
- <p>The personality is the most important part of a role template. It's a comprehensive prompt (typically 1000-5000 characters) that uses Markdown headings to define sections:</p>
95
- <pre><code># Role Name
96
-
97
- ## Identity
98
- You are the... (who this agent is, their core mission)
99
-
100
- ## Approach
101
- You... (how they work, their methodology)
102
-
103
- ## Mental Models
104
- ... (frameworks they use to think about problems)
105
-
106
- ## Decision Framework
107
- ... (how they prioritize and make decisions)
108
-
109
- ## Communication Style
110
- ... (how they write, their tone in practice)
111
-
112
- ## Expertise
113
- ... (comma-separated areas of knowledge)
114
-
115
- ## Principles
116
- - ... (operating rules they follow)
117
-
118
- ## Boundaries
119
- - ... (what they won't do, limitations)</code></pre>
120
- <p>The Create Agent wizard parses these sections to display a rich "resume card" preview when the role is selected.</p>
121
- </div>
122
-
123
- <h2 id="skills">Skills &amp; Presets</h2>
124
- <div class="card">
125
- <p>Each role template can suggest:</p>
126
- <ul>
127
- <li><strong>Skills</strong> — Tools auto-enabled when the role is selected. Browse the full skill catalog organized by category and check the ones relevant to this role. Common skills include <code>agenticmail</code>, <code>web-search</code>, <code>web-fetch</code>, <code>memory</code>, <code>summarize</code>.</li>
128
- <li><strong>Permission Preset</strong> — A named preset (e.g., "Customer Support Agent") that auto-configures tool permissions, rate limits, and risk levels.</li>
129
- </ul>
130
- <p>These are suggestions — users can always modify skills and permissions after selecting the role template.</p>
131
- </div>
132
-
133
- <h2 id="org-scoping">Organization Scoping</h2>
134
- <div class="card">
135
- <p>Custom roles can be scoped to control who sees them:</p>
136
- <ul>
137
- <li><strong>Global</strong> (no org selected) — Visible to all users across all organizations in the Create Agent wizard.</li>
138
- <li><strong>Org-scoped</strong> — Only visible to users who belong to that specific client organization.</li>
139
- </ul>
140
- <p>Use org-scoping when different clients need different agent templates. For example, a law firm client might need a "Legal Intake Specialist" role that isn't relevant to your other clients.</p>
141
- <p>The org switcher in the Roles page header lets you filter custom roles by organization.</p>
142
- </div>
143
-
144
- <h2 id="preview">Role Preview</h2>
145
- <div class="card">
146
- <p>The Preview tab shows the exact "resume card" that appears in the Create Agent wizard when a user selects this role. It includes:</p>
147
- <ul>
148
- <li>Role avatar (first letter), name, and description</li>
149
- <li>Identity badges: job title, tone, language, suggested preset</li>
150
- <li>Org-scoped indicator (if applicable)</li>
151
- <li>Suggested skills as colored pills</li>
152
- <li>Tags</li>
153
- <li>Personality excerpt (first 800 characters)</li>
154
- </ul>
155
- <p>Use this preview to verify the role looks polished before saving.</p>
156
- </div>
157
-
158
- <h2 id="best-practices">Best Practices</h2>
159
- <div class="card">
160
- <ul>
161
- <li><strong>Duplicate built-in roles to customize.</strong> Start from a built-in template that's close to what you need, then modify the personality and skills.</li>
162
- <li><strong>Write detailed personalities.</strong> The personality prompt is what makes each agent unique. Aim for 1000+ characters covering identity, approach, communication style, expertise, and boundaries.</li>
163
- <li><strong>Use structured Markdown headings.</strong> The wizard parses ## Identity, ## Approach, ## Expertise etc. to create the rich preview card.</li>
164
- <li><strong>Add relevant tags.</strong> Tags power the search in the Create Agent wizard. Add synonyms and related terms.</li>
165
- <li><strong>Scope org-specific roles.</strong> Don't clutter the global role list — if a role is only for one client, scope it to their org.</li>
166
- <li><strong>Select minimal skills.</strong> Only suggest skills the role actually needs. Users can always add more later.</li>
167
- <li><strong>Review in Preview tab.</strong> Always check the preview before saving to ensure it looks professional.</li>
168
- </ul>
169
- </div>
170
-
171
- <h2 id="troubleshooting">Troubleshooting</h2>
172
- <div class="card">
173
- <table>
174
- <tr><th>Issue</th><th>Solution</th></tr>
175
- <tr><td>Custom role doesn't appear in Create Agent wizard</td><td>Check that the role is active and either global or scoped to the user's org. The wizard calls <code>/api/engine/souls/by-category</code> which merges both sources.</td></tr>
176
- <tr><td>Role preview looks empty</td><td>Ensure the personality field has content. The preview card is built from the personality text.</td></tr>
177
- <tr><td>"Role with this name already exists"</td><td>Slug must be unique within the same org scope. Use a different name or different org.</td></tr>
178
- <tr><td>Skills list is empty in the form</td><td>Skills are loaded from <code>/api/engine/skills/by-category</code>. Ensure the engine is running and skills are registered.</td></tr>
179
- <tr><td>Built-in role can't be edited</td><td>By design. Use the "Duplicate" button to create an editable copy.</td></tr>
180
- </table>
181
- </div>
182
-
183
- <h2 id="related">Related Pages</h2>
184
- <div class="related">
185
- <a href="/docs/agents.html">Agents</a> — Create agents using role templates.
186
- <a href="/docs/skills.html">Skills</a> — Manage the skill catalog that roles reference.
187
- <a href="/docs/organizations.html">Organizations</a> — Client orgs that roles can be scoped to.
188
- <a href="/docs/agent-permissions.html">Agent Permissions</a> — Permission presets that roles can suggest.
189
- </div>
190
-
191
- <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)">
192
- <span>AgenticMail Enterprise Documentation</span>
193
- <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>
194
- </div>
195
- </body></html>