@agenticmail/enterprise 0.5.326 → 0.5.328

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