Skip to content

armgit / macro

Public Imported from GitHub
0

Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.

feat(account-manager): let agent accounts manage accounts through DMs (#9584)

Eric Hayes6569225f6dbb
diff --git a/.github/workspace-dep-closures.json b/.github/workspace-dep-closures.json
index 505258b956..2b41a567ce 100644
--- a/.github/workspace-dep-closures.json
+++ b/.github/workspace-dep-closures.json
@@ -39,6 +39,80 @@
"crates/remote_env_var",
"crates/workspace-hack"
],
+ "account_manager": [
+ "crates/account_manager",
+ "crates/activity",
+ "crates/agent",
+ "crates/agent_correlation",
+ "crates/ai_toolset",
+ "crates/ai_usage",
+ "crates/attachment",
+ "crates/bot_id",
+ "crates/bot_token",
+ "crates/broadcast",
+ "crates/channel_sender",
+ "crates/channels",
+ "crates/connection_gateway_client",
+ "crates/connection_gateway_models",
+ "crates/contacts",
+ "crates/cowlike",
+ "crates/database_env_vars",
+ "crates/document_sub_type",
+ "crates/entity_access",
+ "crates/entity_access_db_utils",
+ "crates/entity_mutation",
+ "crates/filter_ast",
+ "crates/frecency",
+ "crates/genai_telemetry",
+ "crates/harness_id",
+ "crates/harness_token",
+ "crates/initiative",
+ "crates/invite_email",
+ "crates/ip_extractor",
+ "crates/item_filters",
+ "crates/kafka_util",
+ "crates/last_online_tracker",
+ "crates/macro_auth",
+ "crates/macro_authorization",
+ "crates/macro_aws_config",
+ "crates/macro_entrypoint",
+ "crates/macro_env",
+ "crates/macro_env_var",
+ "crates/macro_event_broker",
+ "crates/macro_event_topics",
+ "crates/macro_service_urls",
+ "crates/macro_tower_layers",
+ "crates/macro_user_id",
+ "crates/macro_uuid",
+ "crates/mention_utils",
+ "crates/messages",
+ "crates/model",
+ "crates/model-entity",
+ "crates/model-error-response",
+ "crates/model_file_type",
+ "crates/model_notifications",
+ "crates/model_owner",
+ "crates/model_user",
+ "crates/models_bulk_upload",
+ "crates/models_entity_access_management",
+ "crates/models_pagination",
+ "crates/models_permissions",
+ "crates/models_properties",
+ "crates/models_sfs",
+ "crates/non_empty",
+ "crates/notification",
+ "crates/notification_state",
+ "crates/prompt",
+ "crates/properties",
+ "crates/rate_limit",
+ "crates/remote_env_var",
+ "crates/share_permission_db_utils",
+ "crates/sqs_worker",
+ "crates/static_file_service_client",
+ "crates/system_properties",
+ "crates/user_api_key",
+ "crates/workspace-hack"
+ ],
"activity": [
"crates/activity",
"crates/agent_correlation",
@@ -5160,6 +5234,7 @@
],
"document_storage_service": [
"crates/access_requests",
+ "crates/account_manager",
"crates/activity",
"crates/agent",
"crates/agent_changes",
diff --git a/.sqlx/query-0e97264a176e4801556d7a49b7ca25849f455a0db1ef6e0ea7af834af3ba3e98.json b/.sqlx/query-0e97264a176e4801556d7a49b7ca25849f455a0db1ef6e0ea7af834af3ba3e98.json
new file mode 100644
index 0000000000..e964fb5b98
--- /dev/null
+++ b/.sqlx/query-0e97264a176e4801556d7a49b7ca25849f455a0db1ef6e0ea7af834af3ba3e98.json
@@ -0,0 +1,29 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "\n SELECT managed_user_id, manager_user_id\n FROM account_manager_grants\n WHERE id = $1\n AND status = 'approved'\n AND expires_at > $2\n FOR UPDATE\n ",
+ "describe": {
+ "columns": [
+ {
+ "ordinal": 0,
+ "name": "managed_user_id",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 1,
+ "name": "manager_user_id",
+ "type_info": "Text"
+ }
+ ],
+ "parameters": {
+ "Left": [
+ "Uuid",
+ "Timestamptz"
+ ]
+ },
+ "nullable": [
+ false,
+ false
+ ]
+ },
+ "hash": "0e97264a176e4801556d7a49b7ca25849f455a0db1ef6e0ea7af834af3ba3e98"
+}
diff --git a/.sqlx/query-2092c1c16d29714dd22a77db01e1977f709367efe148defd825c3c0abb36af71.json b/.sqlx/query-2092c1c16d29714dd22a77db01e1977f709367efe148defd825c3c0abb36af71.json
new file mode 100644
index 0000000000..0bc17e8124
--- /dev/null
+++ b/.sqlx/query-2092c1c16d29714dd22a77db01e1977f709367efe148defd825c3c0abb36af71.json
@@ -0,0 +1,73 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "\n UPDATE account_manager_grants\n SET status = $2, expires_at = $3\n WHERE id = $1\n AND status = 'pending'\n AND expires_at > $4\n RETURNING id, managed_user_id, manager_user_id, requested_by, status, expires_at,\n created_at, claimed_at, last_used_at\n ",
+ "describe": {
+ "columns": [
+ {
+ "ordinal": 0,
+ "name": "id",
+ "type_info": "Uuid"
+ },
+ {
+ "ordinal": 1,
+ "name": "managed_user_id",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 2,
+ "name": "manager_user_id",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 3,
+ "name": "requested_by",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 4,
+ "name": "status",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 5,
+ "name": "expires_at",
+ "type_info": "Timestamptz"
+ },
+ {
+ "ordinal": 6,
+ "name": "created_at",
+ "type_info": "Timestamptz"
+ },
+ {
+ "ordinal": 7,
+ "name": "claimed_at",
+ "type_info": "Timestamptz"
+ },
+ {
+ "ordinal": 8,
+ "name": "last_used_at",
+ "type_info": "Timestamptz"
+ }
+ ],
+ "parameters": {
+ "Left": [
+ "Uuid",
+ "Text",
+ "Timestamptz",
+ "Timestamptz"
+ ]
+ },
+ "nullable": [
+ false,
+ false,
+ false,
+ false,
+ false,
+ true,
+ false,
+ true,
+ true
+ ]
+ },
+ "hash": "2092c1c16d29714dd22a77db01e1977f709367efe148defd825c3c0abb36af71"
+}
diff --git a/.sqlx/query-2e47e4106ecf4e062d80884aa3bb01141b9322c3d751d30badf94f824fc80cf3.json b/.sqlx/query-2e47e4106ecf4e062d80884aa3bb01141b9322c3d751d30badf94f824fc80cf3.json
new file mode 100644
index 0000000000..f825e51318
--- /dev/null
+++ b/.sqlx/query-2e47e4106ecf4e062d80884aa3bb01141b9322c3d751d30badf94f824fc80cf3.json
@@ -0,0 +1,15 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "\n UPDATE account_manager_grants\n SET status = 'expired', expires_at = NULL\n WHERE managed_user_id = $1\n AND manager_user_id = $2\n AND status = 'pending'\n AND expires_at <= now()\n ",
+ "describe": {
+ "columns": [],
+ "parameters": {
+ "Left": [
+ "Text",
+ "Text"
+ ]
+ },
+ "nullable": []
+ },
+ "hash": "2e47e4106ecf4e062d80884aa3bb01141b9322c3d751d30badf94f824fc80cf3"
+}
diff --git a/.sqlx/query-45bf2bd3d2a375b9482b8eb5e201b9858cbeeb1a29152f213543f06489b6cca7.json b/.sqlx/query-45bf2bd3d2a375b9482b8eb5e201b9858cbeeb1a29152f213543f06489b6cca7.json
new file mode 100644
index 0000000000..8adad05349
--- /dev/null
+++ b/.sqlx/query-45bf2bd3d2a375b9482b8eb5e201b9858cbeeb1a29152f213543f06489b6cca7.json
@@ -0,0 +1,74 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "\n INSERT INTO account_manager_grants\n (id, managed_user_id, manager_user_id, requested_by, status, expires_at)\n VALUES ($1, $2, $3, $4, 'pending', $5)\n ON CONFLICT (managed_user_id, manager_user_id) WHERE status = 'pending' DO NOTHING\n RETURNING id, managed_user_id, manager_user_id, requested_by, status, expires_at,\n created_at, claimed_at, last_used_at\n ",
+ "describe": {
+ "columns": [
+ {
+ "ordinal": 0,
+ "name": "id",
+ "type_info": "Uuid"
+ },
+ {
+ "ordinal": 1,
+ "name": "managed_user_id",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 2,
+ "name": "manager_user_id",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 3,
+ "name": "requested_by",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 4,
+ "name": "status",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 5,
+ "name": "expires_at",
+ "type_info": "Timestamptz"
+ },
+ {
+ "ordinal": 6,
+ "name": "created_at",
+ "type_info": "Timestamptz"
+ },
+ {
+ "ordinal": 7,
+ "name": "claimed_at",
+ "type_info": "Timestamptz"
+ },
+ {
+ "ordinal": 8,
+ "name": "last_used_at",
+ "type_info": "Timestamptz"
+ }
+ ],
+ "parameters": {
+ "Left": [
+ "Uuid",
+ "Text",
+ "Text",
+ "Text",
+ "Timestamptz"
+ ]
+ },
+ "nullable": [
+ false,
+ false,
+ false,
+ false,
+ false,
+ true,
+ false,
+ true,
+ true
+ ]
+ },
+ "hash": "45bf2bd3d2a375b9482b8eb5e201b9858cbeeb1a29152f213543f06489b6cca7"
+}
diff --git a/.sqlx/query-5d1e9bf92264059c11b5552fc2f6154e37b1d50e960ee6dfc8fe40495ef5a89e.json b/.sqlx/query-5d1e9bf92264059c11b5552fc2f6154e37b1d50e960ee6dfc8fe40495ef5a89e.json
new file mode 100644
index 0000000000..d2a51b79e1
--- /dev/null
+++ b/.sqlx/query-5d1e9bf92264059c11b5552fc2f6154e37b1d50e960ee6dfc8fe40495ef5a89e.json
@@ -0,0 +1,46 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "\n SELECT\n u.id AS \"id!\",\n u.macro_user_id AS \"fusion_user_id?\",\n u.\"organizationId\" AS \"organization_id?\",\n NULL::uuid AS \"account_manager_grant_id?\",\n NULL::text AS \"manager_user_id?\"\n FROM \"UserApiKey\" k\n JOIN \"User\" u ON u.id = k.user_id\n WHERE k.hash = $1\n UNION ALL\n SELECT\n u.id,\n u.macro_user_id,\n u.\"organizationId\",\n g.id,\n g.manager_user_id\n FROM account_manager_grants g\n JOIN \"User\" u ON u.id = g.managed_user_id\n WHERE g.key_hash = $1\n AND g.status = 'active'\n ",
+ "describe": {
+ "columns": [
+ {
+ "ordinal": 0,
+ "name": "id!",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 1,
+ "name": "fusion_user_id?",
+ "type_info": "Uuid"
+ },
+ {
+ "ordinal": 2,
+ "name": "organization_id?",
+ "type_info": "Int4"
+ },
+ {
+ "ordinal": 3,
+ "name": "account_manager_grant_id?",
+ "type_info": "Uuid"
+ },
+ {
+ "ordinal": 4,
+ "name": "manager_user_id?",
+ "type_info": "Text"
+ }
+ ],
+ "parameters": {
+ "Left": [
+ "Bytea"
+ ]
+ },
+ "nullable": [
+ null,
+ null,
+ null,
+ null,
+ null
+ ]
+ },
+ "hash": "5d1e9bf92264059c11b5552fc2f6154e37b1d50e960ee6dfc8fe40495ef5a89e"
+}
diff --git a/.sqlx/query-63354943de3cc2b7967a7d90f272d8771e30cc6794d159a4721fe6c419f14ec8.json b/.sqlx/query-63354943de3cc2b7967a7d90f272d8771e30cc6794d159a4721fe6c419f14ec8.json
new file mode 100644
index 0000000000..40f7e4cfe6
--- /dev/null
+++ b/.sqlx/query-63354943de3cc2b7967a7d90f272d8771e30cc6794d159a4721fe6c419f14ec8.json
@@ -0,0 +1,14 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "\n UPDATE account_manager_grants\n SET last_used_at = now()\n WHERE id = (\n SELECT id FROM account_manager_grants\n WHERE id = $1\n AND (last_used_at IS NULL OR last_used_at < now() - interval '1 minute')\n FOR UPDATE SKIP LOCKED\n )\n ",
+ "describe": {
+ "columns": [],
+ "parameters": {
+ "Left": [
+ "Uuid"
+ ]
+ },
+ "nullable": []
+ },
+ "hash": "63354943de3cc2b7967a7d90f272d8771e30cc6794d159a4721fe6c419f14ec8"
+}
diff --git a/.sqlx/query-686866c771d5515d3619ac9201bdd6db3f78ec66cabf2a4642b713142848ed0e.json b/.sqlx/query-686866c771d5515d3619ac9201bdd6db3f78ec66cabf2a4642b713142848ed0e.json
new file mode 100644
index 0000000000..61eacbbeca
--- /dev/null
+++ b/.sqlx/query-686866c771d5515d3619ac9201bdd6db3f78ec66cabf2a4642b713142848ed0e.json
@@ -0,0 +1,70 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "\n UPDATE account_manager_grants\n SET status = 'revoked', key_hash = NULL, expires_at = NULL\n WHERE id = $1\n AND status IN ('pending', 'approved', 'active')\n RETURNING id, managed_user_id, manager_user_id, requested_by, status, expires_at,\n created_at, claimed_at, last_used_at\n ",
+ "describe": {
+ "columns": [
+ {
+ "ordinal": 0,
+ "name": "id",
+ "type_info": "Uuid"
+ },
+ {
+ "ordinal": 1,
+ "name": "managed_user_id",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 2,
+ "name": "manager_user_id",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 3,
+ "name": "requested_by",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 4,
+ "name": "status",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 5,
+ "name": "expires_at",
+ "type_info": "Timestamptz"
+ },
+ {
+ "ordinal": 6,
+ "name": "created_at",
+ "type_info": "Timestamptz"
+ },
+ {
+ "ordinal": 7,
+ "name": "claimed_at",
+ "type_info": "Timestamptz"
+ },
+ {
+ "ordinal": 8,
+ "name": "last_used_at",
+ "type_info": "Timestamptz"
+ }
+ ],
+ "parameters": {
+ "Left": [
+ "Uuid"
+ ]
+ },
+ "nullable": [
+ false,
+ false,
+ false,
+ false,
+ false,
+ true,
+ false,
+ true,
+ true
+ ]
+ },
+ "hash": "686866c771d5515d3619ac9201bdd6db3f78ec66cabf2a4642b713142848ed0e"
+}
diff --git a/.sqlx/query-80ae50019d2e14be381604ef54f19778d1157e5261074a654587c023f152d149.json b/.sqlx/query-80ae50019d2e14be381604ef54f19778d1157e5261074a654587c023f152d149.json
new file mode 100644
index 0000000000..0d2124b9f1
--- /dev/null
+++ b/.sqlx/query-80ae50019d2e14be381604ef54f19778d1157e5261074a654587c023f152d149.json
@@ -0,0 +1,71 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "\n SELECT id, managed_user_id, manager_user_id, requested_by, status, expires_at,\n created_at, claimed_at, last_used_at\n FROM account_manager_grants\n WHERE managed_user_id = $1\n AND manager_user_id = $2\n AND status = 'pending'\n ",
+ "describe": {
+ "columns": [
+ {
+ "ordinal": 0,
+ "name": "id",
+ "type_info": "Uuid"
+ },
+ {
+ "ordinal": 1,
+ "name": "managed_user_id",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 2,
+ "name": "manager_user_id",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 3,
+ "name": "requested_by",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 4,
+ "name": "status",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 5,
+ "name": "expires_at",
+ "type_info": "Timestamptz"
+ },
+ {
+ "ordinal": 6,
+ "name": "created_at",
+ "type_info": "Timestamptz"
+ },
+ {
+ "ordinal": 7,
+ "name": "claimed_at",
+ "type_info": "Timestamptz"
+ },
+ {
+ "ordinal": 8,
+ "name": "last_used_at",
+ "type_info": "Timestamptz"
+ }
+ ],
+ "parameters": {
+ "Left": [
+ "Text",
+ "Text"
+ ]
+ },
+ "nullable": [
+ false,
+ false,
+ false,
+ false,
+ false,
+ true,
+ false,
+ true,
+ true
+ ]
+ },
+ "hash": "80ae50019d2e14be381604ef54f19778d1157e5261074a654587c023f152d149"
+}
diff --git a/.sqlx/query-9038fb43d422882ff53f0f9e356107dbffcfcaba5b50dacf985972cdb6f89996.json b/.sqlx/query-9038fb43d422882ff53f0f9e356107dbffcfcaba5b50dacf985972cdb6f89996.json
new file mode 100644
index 0000000000..942c76720e
--- /dev/null
+++ b/.sqlx/query-9038fb43d422882ff53f0f9e356107dbffcfcaba5b50dacf985972cdb6f89996.json
@@ -0,0 +1,15 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "\n UPDATE account_manager_grants\n SET status = 'revoked', key_hash = NULL\n WHERE managed_user_id = $1\n AND manager_user_id = $2\n AND status = 'active'\n ",
+ "describe": {
+ "columns": [],
+ "parameters": {
+ "Left": [
+ "Text",
+ "Text"
+ ]
+ },
+ "nullable": []
+ },
+ "hash": "9038fb43d422882ff53f0f9e356107dbffcfcaba5b50dacf985972cdb6f89996"
+}
diff --git a/.sqlx/query-b27912fe2c28fd8276c0d1b5816f230b95fa7287497a9943cbc6b1401e3439fd.json b/.sqlx/query-b27912fe2c28fd8276c0d1b5816f230b95fa7287497a9943cbc6b1401e3439fd.json
new file mode 100644
index 0000000000..bbc80eda34
--- /dev/null
+++ b/.sqlx/query-b27912fe2c28fd8276c0d1b5816f230b95fa7287497a9943cbc6b1401e3439fd.json
@@ -0,0 +1,70 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "\n SELECT id, managed_user_id, manager_user_id, requested_by, status, expires_at,\n created_at, claimed_at, last_used_at\n FROM account_manager_grants\n WHERE managed_user_id = $1\n AND status IN ('approved', 'active')\n ORDER BY id DESC\n ",
+ "describe": {
+ "columns": [
+ {
+ "ordinal": 0,
+ "name": "id",
+ "type_info": "Uuid"
+ },
+ {
+ "ordinal": 1,
+ "name": "managed_user_id",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 2,
+ "name": "manager_user_id",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 3,
+ "name": "requested_by",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 4,
+ "name": "status",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 5,
+ "name": "expires_at",
+ "type_info": "Timestamptz"
+ },
+ {
+ "ordinal": 6,
+ "name": "created_at",
+ "type_info": "Timestamptz"
+ },
+ {
+ "ordinal": 7,
+ "name": "claimed_at",
+ "type_info": "Timestamptz"
+ },
+ {
+ "ordinal": 8,
+ "name": "last_used_at",
+ "type_info": "Timestamptz"
+ }
+ ],
+ "parameters": {
+ "Left": [
+ "Text"
+ ]
+ },
+ "nullable": [
+ false,
+ false,
+ false,
+ false,
+ false,
+ true,
+ false,
+ true,
+ true
+ ]
+ },
+ "hash": "b27912fe2c28fd8276c0d1b5816f230b95fa7287497a9943cbc6b1401e3439fd"
+}
diff --git a/.sqlx/query-bd9a999a4e780f9ef43cbd5f1653865ad9d1e9d7cccb3f336c4c809ad99e75a8.json b/.sqlx/query-bd9a999a4e780f9ef43cbd5f1653865ad9d1e9d7cccb3f336c4c809ad99e75a8.json
new file mode 100644
index 0000000000..ddcdf730f8
--- /dev/null
+++ b/.sqlx/query-bd9a999a4e780f9ef43cbd5f1653865ad9d1e9d7cccb3f336c4c809ad99e75a8.json
@@ -0,0 +1,22 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "SELECT \"isAgent\" FROM \"User\" WHERE id = $1",
+ "describe": {
+ "columns": [
+ {
+ "ordinal": 0,
+ "name": "isAgent",
+ "type_info": "Bool"
+ }
+ ],
+ "parameters": {
+ "Left": [
+ "Text"
+ ]
+ },
+ "nullable": [
+ false
+ ]
+ },
+ "hash": "bd9a999a4e780f9ef43cbd5f1653865ad9d1e9d7cccb3f336c4c809ad99e75a8"
+}
diff --git a/.sqlx/query-d4ca6bc23c07a54c7916ed96672f2210263008237ab982ab5da2d536d1c69fd1.json b/.sqlx/query-d4ca6bc23c07a54c7916ed96672f2210263008237ab982ab5da2d536d1c69fd1.json
new file mode 100644
index 0000000000..7d3d12cc85
--- /dev/null
+++ b/.sqlx/query-d4ca6bc23c07a54c7916ed96672f2210263008237ab982ab5da2d536d1c69fd1.json
@@ -0,0 +1,72 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "\n UPDATE account_manager_grants\n SET status = 'active', key_hash = $2, expires_at = NULL, claimed_at = $3\n WHERE id = $1\n RETURNING id, managed_user_id, manager_user_id, requested_by, status, expires_at,\n created_at, claimed_at, last_used_at\n ",
+ "describe": {
+ "columns": [
+ {
+ "ordinal": 0,
+ "name": "id",
+ "type_info": "Uuid"
+ },
+ {
+ "ordinal": 1,
+ "name": "managed_user_id",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 2,
+ "name": "manager_user_id",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 3,
+ "name": "requested_by",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 4,
+ "name": "status",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 5,
+ "name": "expires_at",
+ "type_info": "Timestamptz"
+ },
+ {
+ "ordinal": 6,
+ "name": "created_at",
+ "type_info": "Timestamptz"
+ },
+ {
+ "ordinal": 7,
+ "name": "claimed_at",
+ "type_info": "Timestamptz"
+ },
+ {
+ "ordinal": 8,
+ "name": "last_used_at",
+ "type_info": "Timestamptz"
+ }
+ ],
+ "parameters": {
+ "Left": [
+ "Uuid",
+ "Bytea",
+ "Timestamptz"
+ ]
+ },
+ "nullable": [
+ false,
+ false,
+ false,
+ false,
+ false,
+ true,
+ false,
+ true,
+ true
+ ]
+ },
+ "hash": "d4ca6bc23c07a54c7916ed96672f2210263008237ab982ab5da2d536d1c69fd1"
+}
diff --git a/.sqlx/query-fbaf34461669aae42672ea2620a0b537c5524fb1cb0d89a9222e4de456dc54b4.json b/.sqlx/query-fbaf34461669aae42672ea2620a0b537c5524fb1cb0d89a9222e4de456dc54b4.json
new file mode 100644
index 0000000000..812a10956c
--- /dev/null
+++ b/.sqlx/query-fbaf34461669aae42672ea2620a0b537c5524fb1cb0d89a9222e4de456dc54b4.json
@@ -0,0 +1,70 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "\n SELECT id, managed_user_id, manager_user_id, requested_by, status, expires_at,\n created_at, claimed_at, last_used_at\n FROM account_manager_grants\n WHERE id = $1\n ",
+ "describe": {
+ "columns": [
+ {
+ "ordinal": 0,
+ "name": "id",
+ "type_info": "Uuid"
+ },
+ {
+ "ordinal": 1,
+ "name": "managed_user_id",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 2,
+ "name": "manager_user_id",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 3,
+ "name": "requested_by",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 4,
+ "name": "status",
+ "type_info": "Text"
+ },
+ {
+ "ordinal": 5,
+ "name": "expires_at",
+ "type_info": "Timestamptz"
+ },
+ {
+ "ordinal": 6,
+ "name": "created_at",
+ "type_info": "Timestamptz"
+ },
+ {
+ "ordinal": 7,
+ "name": "claimed_at",
+ "type_info": "Timestamptz"
+ },
+ {
+ "ordinal": 8,
+ "name": "last_used_at",
+ "type_info": "Timestamptz"
+ }
+ ],
+ "parameters": {
+ "Left": [
+ "Uuid"
+ ]
+ },
+ "nullable": [
+ false,
+ false,
+ false,
+ false,
+ false,
+ true,
+ false,
+ true,
+ true
+ ]
+ },
+ "hash": "fbaf34461669aae42672ea2620a0b537c5524fb1cb0d89a9222e4de456dc54b4"
+}
diff --git a/.sqlx/query-fe966cb819586e1b423deafea194c0bd97468a16d1f81fae7ad0884cc79aa395.json b/.sqlx/query-fe966cb819586e1b423deafea194c0bd97468a16d1f81fae7ad0884cc79aa395.json
deleted file mode 100644
index 7b3c21e418..0000000000
--- a/.sqlx/query-fe966cb819586e1b423deafea194c0bd97468a16d1f81fae7ad0884cc79aa395.json
+++ /dev/null
@@ -1,34 +0,0 @@
-{
- "db_name": "PostgreSQL",
- "query": "\n SELECT\n u.id,\n u.macro_user_id AS \"fusion_user_id?\",\n u.\"organizationId\" AS \"organization_id?\"\n FROM \"UserApiKey\" k\n JOIN \"User\" u ON u.id = k.user_id\n WHERE k.hash = $1\n ",
- "describe": {
- "columns": [
- {
- "ordinal": 0,
- "name": "id",
- "type_info": "Text"
- },
- {
- "ordinal": 1,
- "name": "fusion_user_id?",
- "type_info": "Uuid"
- },
- {
- "ordinal": 2,
- "name": "organization_id?",
- "type_info": "Int4"
- }
- ],
- "parameters": {
- "Left": [
- "Bytea"
- ]
- },
- "nullable": [
- false,
- false,
- true
- ]
- },
- "hash": "fe966cb819586e1b423deafea194c0bd97468a16d1f81fae7ad0884cc79aa395"
-}
diff --git a/Cargo.lock b/Cargo.lock
index 8b6c151b28..383cec6058 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -37,6 +37,33 @@ dependencies = [
"workspace-hack",
]
+[[package]]
+name = "account_manager"
+version = "0.1.0"
+dependencies = [
+ "axum",
+ "channels",
+ "chrono",
+ "entity_access",
+ "macro_authorization",
+ "macro_db_migrator",
+ "macro_service_urls",
+ "macro_user_id",
+ "messages",
+ "model-error-response",
+ "rootcause",
+ "serde",
+ "sqlx",
+ "strum 0.27.2",
+ "thiserror 2.0.18",
+ "tokio",
+ "tracing",
+ "user_api_key",
+ "utoipa",
+ "uuid",
+ "workspace-hack",
+]
+
[[package]]
name = "activity"
version = "0.1.0"
@@ -6634,6 +6661,7 @@ name = "document_storage_service"
version = "0.1.0"
dependencies = [
"access_requests",
+ "account_manager",
"activity",
"agent_changes",
"agent_correlation",
diff --git a/Cargo.toml b/Cargo.toml
index 192d1aa80a..b0d1ef0914 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -144,6 +144,7 @@ members = [
"crates/task_dedup",
"crates/unfurl",
"crates/upstream_error",
+ "crates/account_manager",
"crates/user_api_key",
"crates/user_language",
"crates/webhook_signature",
diff --git a/apps/web/src/features/account-manager/account-manager-card-frame.tsx b/apps/web/src/features/account-manager/account-manager-card-frame.tsx
new file mode 100644
index 0000000000..c33b67c1ac
--- /dev/null
+++ b/apps/web/src/features/account-manager/account-manager-card-frame.tsx
@@ -0,0 +1,13 @@
+import type { ParentProps } from 'solid-js';
+
+/**
+ * The card's box, the same height in every state. Channels are a virtualized
+ * list, so a message that grows after mounting would jump the scroll position.
+ */
+export function AccountManagerCardFrame(props: ParentProps) {
+ return (
+ <span class="my-1 flex h-[4.5rem] max-w-md flex-col justify-center gap-1.5 rounded-lg border border-edge-muted bg-panel px-3">
+ {props.children}
+ </span>
+ );
+}
diff --git a/apps/web/src/features/account-manager/account-manager-card.test.tsx b/apps/web/src/features/account-manager/account-manager-card.test.tsx
new file mode 100644
index 0000000000..f1ddfeac7d
--- /dev/null
+++ b/apps/web/src/features/account-manager/account-manager-card.test.tsx
@@ -0,0 +1,151 @@
+import { queryClient } from '@queries/client';
+import {
+ cleanup,
+ fireEvent,
+ render,
+ screen,
+ waitFor,
+} from '@solidjs/testing-library';
+import { QueryClientProvider } from '@tanstack/solid-query';
+import { err, ok } from 'neverthrow';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { AccountManagerCard } from './account-manager-card';
+
+const MANAGED = 'macro|[email protected]';
+const MANAGER = 'macro|[email protected]';
+const GRANT_ID = '019a4f2e-7c1b-7d3a-9e2f-3b1c8d5a6f70';
+
+const mocks = vi.hoisted(() => ({
+ viewer: '',
+ getGrant: vi.fn(),
+ respond: vi.fn(),
+ claim: vi.fn(),
+ revoke: vi.fn(),
+}));
+
+vi.mock('@core/context/user', async (importOriginal) => ({
+ ...(await importOriginal<object>()),
+ useUserId: () => () => mocks.viewer,
+}));
+
+vi.mock('@service-storage/client', () => ({
+ storageServiceClient: {
+ getAccountManagerGrant: mocks.getGrant,
+ respondToAccountManagerRequest: mocks.respond,
+ claimAccountManagerToken: mocks.claim,
+ revokeAccountManagerGrant: mocks.revoke,
+ },
+}));
+
+function grant(status: string, requestedBy: 'managed' | 'manager') {
+ return {
+ id: GRANT_ID,
+ managedUserId: MANAGED,
+ managerUserId: MANAGER,
+ requestedBy,
+ status,
+ expiresAt: status === 'approved' ? '2026-11-11T00:00:00Z' : null,
+ createdAt: '2026-11-04T00:00:00Z',
+ claimedAt: null,
+ lastUsedAt: null,
+ };
+}
+
+async function showCard(viewer: string, shown: ReturnType<typeof grant>) {
+ mocks.viewer = viewer;
+ mocks.getGrant.mockResolvedValue(ok(shown));
+ render(() => (
+ <QueryClientProvider client={queryClient}>
+ <AccountManagerCard grantId={GRANT_ID} />
+ </QueryClientProvider>
+ ));
+ await waitFor(() => expect(mocks.getGrant).toHaveBeenCalled());
+}
+
+describe('AccountManagerCard', () => {
+ beforeEach(() => {
+ queryClient.clear();
+ vi.clearAllMocks();
+ });
+ afterEach(cleanup);
+
+ it('approving takes a confirmation before anything is granted', async () => {
+ await showCard(MANAGED, grant('pending', 'manager'));
+ mocks.respond.mockResolvedValue(ok(grant('approved', 'manager')));
+
+ fireEvent.click(await screen.findByRole('button', { name: 'Approve' }));
+ expect(mocks.respond).not.toHaveBeenCalled();
+
+ const buttons = await screen.findAllByRole('button', { name: 'Approve' });
+ const confirm = buttons[buttons.length - 1];
+ if (!confirm) throw new Error('expected the confirm button');
+ fireEvent.click(confirm);
+
+ await waitFor(() =>
+ expect(mocks.respond).toHaveBeenCalledWith({
+ id: GRANT_ID,
+ decision: 'approve',
+ })
+ );
+ });
+
+ it('the side that asked can withdraw but not approve', async () => {
+ await showCard(MANAGED, grant('pending', 'managed'));
+
+ await screen.findByRole('button', { name: 'Withdraw' });
+
+ expect(screen.queryByRole('button', { name: 'Approve' })).toBeNull();
+ });
+
+ it('only the manager is offered the token', async () => {
+ await showCard(MANAGED, grant('approved', 'manager'));
+
+ await screen.findByText(/^Expires .* unless the token is revealed$/);
+
+ expect(screen.queryByRole('button', { name: 'Reveal token' })).toBeNull();
+ });
+
+ it('reveals the token once to the manager', async () => {
+ await showCard(MANAGER, grant('approved', 'manager'));
+ mocks.claim.mockResolvedValue(
+ ok({ grant: grant('active', 'manager'), token: 'mak_secret' })
+ );
+
+ fireEvent.click(
+ await screen.findByRole('button', { name: 'Reveal token' })
+ );
+
+ await screen.findByDisplayValue('mak_secret');
+ expect(mocks.claim).toHaveBeenCalledTimes(1);
+ expect(screen.queryByRole('button', { name: 'Reveal token' })).toBeNull();
+ });
+
+ it.each(['declined', 'revoked', 'expired'])(
+ 'offers no actions once %s',
+ async (status) => {
+ await showCard(MANAGER, grant(status, 'manager'));
+
+ await screen.findByText(/declined|ended|expired/);
+
+ expect(screen.queryAllByRole('button')).toEqual([]);
+ }
+ );
+
+ it('shows the unavailable label for a status it does not know', async () => {
+ await showCard(MANAGER, grant('suspended', 'manager'));
+
+ await screen.findByText('This request isn’t available');
+ });
+
+ it('says so when the viewer may not see the request', async () => {
+ mocks.viewer = MANAGER;
+ mocks.getGrant.mockResolvedValue(err([{ code: 'NOT_FOUND' }]));
+ render(() => (
+ <QueryClientProvider client={queryClient}>
+ <AccountManagerCard grantId={GRANT_ID} />
+ </QueryClientProvider>
+ ));
+
+ await screen.findByText('This request isn’t available');
+ });
+});
diff --git a/apps/web/src/features/account-manager/account-manager-card.tsx b/apps/web/src/features/account-manager/account-manager-card.tsx
new file mode 100644
index 0000000000..480459f084
--- /dev/null
+++ b/apps/web/src/features/account-manager/account-manager-card.tsx
@@ -0,0 +1,277 @@
+import { formatLocale, t } from '@app/lib/i18n';
+import { CredentialField } from '@channel/Bots/CredentialField';
+import { useUserId } from '@core/context/user';
+import { getDisplayName, tryMacroId } from '@core/user';
+import XIcon from '@icon/system/regular/x.svg';
+import {
+ useAccountManagerGrantQuery,
+ useClaimAccountManagerTokenMutation,
+ useRespondToAccountManagerRequestMutation,
+ useRevokeAccountManagerGrantMutation,
+} from '@queries/account-managers/account-managers';
+import type { AccountManagerGrant } from '@service-storage/generated/schemas/accountManagerGrant';
+import { Button, Dialog, Panel } from '@ui';
+import { createSignal, Show, Suspense } from 'solid-js';
+import { match, P } from 'ts-pattern';
+import { AccountManagerCardFrame } from './account-manager-card-frame';
+
+/**
+ * The card for one account manager request: what happened to it, and what the
+ * viewer can do next. Its own Suspense keeps the frame on screen while the grant
+ * loads; without it, reading the query suspends the whole message.
+ */
+export function AccountManagerCard(props: { grantId: string }) {
+ const grantQuery = useAccountManagerGrantQuery(() => props.grantId);
+
+ return (
+ <AccountManagerCardFrame>
+ <Suspense>
+ <Show
+ when={grantQuery.data}
+ fallback={
+ <Show when={grantQuery.isError}>
+ <span class="text-sm text-ink-muted">
+ {t('accountManager.cardUnavailable')}
+ </span>
+ </Show>
+ }
+ >
+ {(grant) => <GrantContent grant={grant()} />}
+ </Show>
+ </Suspense>
+ </AccountManagerCardFrame>
+ );
+}
+
+function GrantContent(props: { grant: AccountManagerGrant }) {
+ const userId = useUserId();
+ const [confirming, setConfirming] = createSignal(false);
+ const [token, setToken] = createSignal<string>();
+ const [failed, setFailed] = createSignal(false);
+ const respond = useRespondToAccountManagerRequestMutation();
+ const claim = useClaimAccountManagerTokenMutation();
+ const revoke = useRevokeAccountManagerGrantMutation();
+
+ const isManager = () => userId() === props.grant.managerUserId;
+ const otherName = () => {
+ const other = isManager()
+ ? props.grant.managedUserId
+ : props.grant.managerUserId;
+ return getDisplayName(tryMacroId(other));
+ };
+ const askedByViewer = () =>
+ props.grant.requestedBy === (isManager() ? 'manager' : 'managed');
+ const expiryDate = () => {
+ const expiresAt = props.grant.expiresAt;
+ if (!expiresAt) return undefined;
+
+ return new Intl.DateTimeFormat(formatLocale(), {
+ dateStyle: 'medium',
+ }).format(new Date(expiresAt));
+ };
+ const busy = () => respond.isPending || claim.isPending || revoke.isPending;
+
+ const title = () => {
+ const name = otherName();
+ return match([props.grant.status, askedByViewer(), isManager()] as const)
+ .with(['pending', true, true], () =>
+ t('accountManager.cardOwnRequestManager', { name })
+ )
+ .with(['pending', true, false], () =>
+ t('accountManager.cardOwnRequestManaged', { name })
+ )
+ .with(['pending', false, true], () =>
+ t('accountManager.cardTitleManager', { name })
+ )
+ .with(['pending', false, false], () =>
+ t('accountManager.cardTitleManaged', { name })
+ )
+ .with(['approved', P._, true], () =>
+ t('accountManager.cardApprovedManager', { name })
+ )
+ .with(['approved', P._, false], () =>
+ t('accountManager.cardApprovedManaged', { name })
+ )
+ .with(['active', P._, true], () =>
+ t('accountManager.cardActiveManager', { name })
+ )
+ .with(['active', P._, false], () =>
+ t('accountManager.cardActiveManaged', { name })
+ )
+ .with(['declined', P._, P._], () => t('accountManager.cardDeclined'))
+ .with(['revoked', P._, P._], () => t('accountManager.cardRevoked'))
+ .with(['expired', P._, P._], () => t('accountManager.cardExpired'))
+ .exhaustive(() => t('accountManager.cardUnavailable'));
+ };
+
+ const run = async (action: () => Promise<unknown>) => {
+ setFailed(false);
+ try {
+ await action();
+ } catch {
+ setFailed(true);
+ }
+ };
+
+ const approve = () =>
+ run(async () => {
+ await respond.mutateAsync({
+ id: props.grant.id,
+ decision: 'approve',
+ });
+ setConfirming(false);
+ });
+
+ const reveal = () =>
+ run(async () => {
+ const claimed = await claim.mutateAsync({ id: props.grant.id });
+ setToken(claimed.token);
+ });
+
+ return (
+ <>
+ <span class="truncate text-sm font-medium text-ink">{title()}</span>
+ <span class="flex items-center gap-1">
+ <Show when={failed()}>
+ <span class="truncate text-xs text-alert-ink">
+ {t('accountManager.actionFailed')}
+ </span>
+ </Show>
+ <Show when={props.grant.status === 'pending' && !askedByViewer()}>
+ <Button
+ size="sm"
+ variant="primary"
+ disabled={busy()}
+ onClick={() => setConfirming(true)}
+ >
+ {t('accountManager.approve')}
+ </Button>
+ <Button
+ size="sm"
+ variant="ghost"
+ disabled={busy()}
+ onClick={() =>
+ run(() =>
+ respond.mutateAsync({
+ id: props.grant.id,
+ decision: 'decline',
+ })
+ )
+ }
+ >
+ {t('accountManager.decline')}
+ </Button>
+ </Show>
+ <Show when={props.grant.status === 'pending' && askedByViewer()}>
+ <span class="flex-1 text-xs text-ink-muted">
+ {t('accountManager.cardWaiting')}
+ </span>
+ <Button
+ size="sm"
+ variant="ghost"
+ disabled={busy()}
+ onClick={() =>
+ run(() => revoke.mutateAsync({ id: props.grant.id }))
+ }
+ >
+ {t('accountManager.withdraw')}
+ </Button>
+ </Show>
+ <Show when={props.grant.status === 'approved' && isManager()}>
+ <Button
+ size="sm"
+ variant="primary"
+ disabled={busy()}
+ onClick={reveal}
+ >
+ {t('accountManager.revealToken')}
+ </Button>
+ </Show>
+ <Show when={props.grant.status === 'active'}>
+ <span class="text-xs text-ink-muted">
+ {t('accountManager.cardFullAccess')}
+ </span>
+ </Show>
+ <Show when={props.grant.status === 'approved' && expiryDate()}>
+ {(date) => (
+ <span class="truncate text-xs text-ink-muted">
+ {t('accountManager.cardExpires', { date: date() })}
+ </span>
+ )}
+ </Show>
+ </span>
+
+ <Dialog
+ open={confirming()}
+ onOpenChange={(open) => !open && !busy() && setConfirming(false)}
+ >
+ <Panel depth={2} class="rounded-xl text-ink">
+ <Panel.Header class="gap-1 px-2">
+ <Dialog.CloseButton
+ as={Button}
+ variant="ghost"
+ size="icon-sm"
+ disabled={busy()}
+ >
+ <XIcon class="size-3.5 touch:size-6 shrink-0 pointer-events-none" />
+ </Dialog.CloseButton>
+ <Dialog.Title as="span" class="m-0 p-0 text-sm font-medium">
+ {t('accountManager.confirmTitle')}
+ </Dialog.Title>
+ </Panel.Header>
+ <Panel.Body class="flex flex-col gap-3 p-3">
+ <p class="wrap-anywhere text-sm text-ink-muted">
+ {isManager()
+ ? t('accountManager.confirmManager', { name: otherName() })
+ : t('accountManager.confirmManaged', { name: otherName() })}
+ </p>
+ <div class="flex justify-end gap-1 pt-2">
+ <Button
+ variant="ghost"
+ disabled={busy()}
+ onClick={() => setConfirming(false)}
+ >
+ {t('accountManager.cancel')}
+ </Button>
+ <Button variant="primary" disabled={busy()} onClick={approve}>
+ {t('accountManager.approve')}
+ </Button>
+ </div>
+ </Panel.Body>
+ </Panel>
+ </Dialog>
+
+ <Dialog
+ open={token() !== undefined}
+ onOpenChange={(open) => !open && setToken(undefined)}
+ >
+ <Panel depth={2} class="rounded-xl text-ink">
+ <Panel.Header class="gap-1 px-2">
+ <Dialog.Title as="span" class="m-0 p-0 text-sm font-medium">
+ {t('accountManager.tokenTitle')}
+ </Dialog.Title>
+ </Panel.Header>
+ <Panel.Body class="flex flex-col gap-3 p-3">
+ <CredentialField
+ label={t('accountManager.tokenLabel')}
+ value={token() ?? ''}
+ help={t('accountManager.tokenHelp')}
+ />
+ <div class="rounded-lg border border-alert/30 bg-alert-bg px-3 py-2.5 text-xs text-alert-ink">
+ {t('accountManager.tokenWarning')}
+ </div>
+ <div class="flex justify-end pt-2">
+ <Button
+ variant="secondary"
+ size="sm"
+ onClick={() => setToken(undefined)}
+ >
+ {t('accountManager.done')}
+ </Button>
+ </div>
+ </Panel.Body>
+ </Panel>
+ </Dialog>
+ </>
+ );
+}
diff --git a/apps/web/src/features/account-manager/account-manager-page.tsx b/apps/web/src/features/account-manager/account-manager-page.tsx
new file mode 100644
index 0000000000..360cd4b4ed
--- /dev/null
+++ b/apps/web/src/features/account-manager/account-manager-page.tsx
@@ -0,0 +1,17 @@
+import { t } from '@app/lib/i18n';
+import { useParams } from '@app/lib/split-router';
+import { AccountManagerCard } from './account-manager-card';
+
+/** Where the one-time link in an approval message lands. */
+export function AccountManagerPage() {
+ const params = useParams<{ grantId: string }>();
+
+ return (
+ <main class="h-full min-h-0 flex-1 overflow-y-auto bg-page text-ink">
+ <div class="mx-auto flex max-w-3xl flex-col gap-4 p-6">
+ <h1 class="text-lg font-semibold">{t('accountManager.pageTitle')}</h1>
+ <AccountManagerCard grantId={params.grantId} />
+ </div>
+ </main>
+ );
+}
diff --git a/apps/web/src/features/account-manager/account-manager-request-button.tsx b/apps/web/src/features/account-manager/account-manager-request-button.tsx
new file mode 100644
index 0000000000..d77e84fca1
--- /dev/null
+++ b/apps/web/src/features/account-manager/account-manager-request-button.tsx
@@ -0,0 +1,121 @@
+import { t } from '@app/lib/i18n';
+import { useChannelParticipants } from '@channel/use-channel-participants';
+import { toast } from '@core/component/Toast/Toast';
+import { useUserId } from '@core/context/user';
+import { getDisplayName, isAgentAccount, tryMacroId } from '@core/user';
+import UserGearIcon from '@icon/system/regular/user-gear.svg';
+import XIcon from '@icon/system/regular/x.svg';
+import { useRequestAccountManagerMutation } from '@queries/account-managers/account-managers';
+import type { AccountManagerRole } from '@service-storage/generated/schemas/accountManagerRole';
+import { Button, Dialog, Panel } from '@ui';
+import { createSignal, Show } from 'solid-js';
+
+/**
+ * Starts an account manager request from a DM between a person and an agent
+ * account: the manager is always the agent, and an agent can't be managed.
+ */
+export function AccountManagerRequestButton(props: { channelId: string }) {
+ const userId = useUserId();
+ const participants = useChannelParticipants(() => props.channelId);
+ const request = useRequestAccountManagerMutation();
+ const [open, setOpen] = createSignal(false);
+
+ const counterparty = () => participants.ids().find((id) => id !== userId());
+ const counterpartyMacroId = () => {
+ const id = counterparty();
+ return id ? tryMacroId(id) : undefined;
+ };
+ const counterpartyName = () => getDisplayName(counterpartyMacroId());
+ const counterpartyIsAgent = () => isAgentAccount(counterpartyMacroId());
+ const viewerIsAgent = () => {
+ const id = userId();
+ return id ? isAgentAccount(tryMacroId(id)) : false;
+ };
+
+ const ask = async (callerRole: AccountManagerRole) => {
+ const counterpartyId = counterparty();
+ if (!counterpartyId) return;
+
+ try {
+ await request.mutateAsync({ counterpartyId, callerRole });
+ toast.success(t('accountManager.requestSent'));
+ setOpen(false);
+ } catch {
+ toast.failure(t('accountManager.requestFailed'));
+ }
+ };
+
+ return (
+ <Show when={counterparty() && counterpartyIsAgent() !== viewerIsAgent()}>
+ <Button
+ size="icon-sm"
+ variant="ghost"
+ tooltip={t('accountManager.requestAction')}
+ aria-label={t('accountManager.requestAction')}
+ onClick={() => setOpen(true)}
+ >
+ <UserGearIcon class="size-4 shrink-0" />
+ </Button>
+ <Dialog
+ open={open()}
+ onOpenChange={(next) => !next && !request.isPending && setOpen(false)}
+ >
+ <Panel depth={2} class="rounded-xl text-ink">
+ <Panel.Header class="gap-1 px-2">
+ <Dialog.CloseButton
+ as={Button}
+ variant="ghost"
+ size="icon-sm"
+ disabled={request.isPending}
+ >
+ <XIcon class="size-3.5 touch:size-6 shrink-0 pointer-events-none" />
+ </Dialog.CloseButton>
+ <Dialog.Title as="span" class="m-0 p-0 text-sm font-medium">
+ {t('accountManager.requestDialogTitle')}
+ </Dialog.Title>
+ </Panel.Header>
+ <Panel.Body class="flex flex-col gap-4 p-3">
+ <Show when={counterpartyIsAgent()}>
+ <div class="flex flex-col items-start gap-2">
+ <p class="wrap-anywhere text-sm text-ink-muted">
+ {t('accountManager.askToBeManagedWarning', {
+ name: counterpartyName(),
+ })}
+ </p>
+ <Button
+ class="h-auto max-w-full wrap-anywhere whitespace-normal text-left"
+ variant="primary"
+ disabled={request.isPending}
+ onClick={() => ask('managed')}
+ >
+ {t('accountManager.askToBeManaged', {
+ name: counterpartyName(),
+ })}
+ </Button>
+ </div>
+ </Show>
+ <Show when={viewerIsAgent()}>
+ <div class="flex flex-col items-start gap-2">
+ <p class="wrap-anywhere text-sm text-ink-muted">
+ {t('accountManager.askToManageWarning', {
+ name: counterpartyName(),
+ })}
+ </p>
+ <Button
+ class="h-auto max-w-full wrap-anywhere whitespace-normal text-left"
+ variant="primary"
+ disabled={request.isPending}
+ onClick={() => ask('manager')}
+ >
+ {t('accountManager.askToManage', {
+ name: counterpartyName(),
+ })}
+ </Button>
+ </div>
+ </Show>
+ </Panel.Body>
+ </Panel>
+ </Dialog>
+ </Show>
+ );
+}
diff --git a/apps/web/src/features/channel/Channel/ChannelDetail.tsx b/apps/web/src/features/channel/Channel/ChannelDetail.tsx
index ee0d6f84e0..42eb5728ac 100644
--- a/apps/web/src/features/channel/Channel/ChannelDetail.tsx
+++ b/apps/web/src/features/channel/Channel/ChannelDetail.tsx
@@ -7,6 +7,7 @@ import {
PriorityCollapseOverflowSensor,
} from '@app/components/priority-collapse/PriorityCollapseOverflowSensor';
import { ViewShell } from '@app/components/view-shell';
+import { AccountManagerRequestButton } from '@app/features/account-manager/account-manager-request-button';
import {
DmWorkPanel,
DmWorkProvider,
@@ -45,6 +46,7 @@ import {
import { isMobile } from '@core/mobile/isMobile';
import { createMethodRegistration } from '@core/orchestrator';
import { lazyNamed } from '@core/util/lazyNamed';
+import { ChannelType } from '@service-storage/generated/schemas/channelType';
import { Tabs } from '@ui';
import {
type Accessor,
@@ -207,6 +209,11 @@ export function ChannelDetailActions(props: ChannelDetailHeaderProps) {
)}
</Show>
</HeaderActionGroup>
+ <Show when={channelType() === ChannelType.direct_message}>
+ <DebugSuspense name="ChannelDetail.account-manager">
+ <AccountManagerRequestButton channelId={props.channelId} />
+ </DebugSuspense>
+ </Show>
<Show
when={!isMobile() || activeTab() !== 'call' || !call.isInThisChannel()}
>
diff --git a/apps/web/src/features/settings/AccountManagers.tsx b/apps/web/src/features/settings/AccountManagers.tsx
new file mode 100644
index 0000000000..3c3fdfc388
--- /dev/null
+++ b/apps/web/src/features/settings/AccountManagers.tsx
@@ -0,0 +1,170 @@
+import { formatLocale, t } from '@app/lib/i18n';
+import { LoadingSpinner } from '@core/component/LoadingSpinner';
+import { toast } from '@core/component/Toast/Toast';
+import { getDisplayName, tryMacroId } from '@core/user';
+import XIcon from '@icon/system/regular/x.svg';
+import {
+ useAccountManagersQuery,
+ useRevokeAccountManagerGrantMutation,
+} from '@queries/account-managers/account-managers';
+import type { AccountManagerGrant } from '@service-storage/generated/schemas/accountManagerGrant';
+import { Button, Dialog, Panel } from '@ui';
+import { createSignal, For, Show } from 'solid-js';
+import { SettingsCard, SettingsPage } from './primitives';
+
+const managerName = (grant: AccountManagerGrant) =>
+ getDisplayName(tryMacroId(grant.managerUserId));
+
+export function AccountManagers() {
+ const grantsQuery = useAccountManagersQuery();
+ const revoke = useRevokeAccountManagerGrantMutation();
+ const [pending, setPending] = createSignal<AccountManagerGrant | null>(null);
+
+ const grants = () => grantsQuery.data ?? [];
+
+ const confirmRevoke = async () => {
+ const grant = pending();
+ if (!grant) return;
+
+ try {
+ await revoke.mutateAsync({ id: grant.id });
+ toast.success(t('accountManager.revoked'));
+ setPending(null);
+ } catch {
+ toast.failure(t('accountManager.revokeFailed'));
+ }
+ };
+
+ return (
+ <SettingsPage
+ title={t('accountManager.settingsTitle')}
+ description={t('accountManager.settingsDescription')}
+ >
+ <SettingsCard>
+ <Show
+ when={!grantsQuery.isLoading}
+ fallback={
+ <div class="flex min-h-36 items-center justify-center">
+ <LoadingSpinner class="size-10 p-2" />
+ </div>
+ }
+ >
+ <Show
+ when={!grantsQuery.isError}
+ fallback={
+ <div class="px-6 py-8 text-center text-sm text-ink-muted">
+ {t('accountManager.settingsLoadFailed')}
+ </div>
+ }
+ >
+ <Show
+ when={grants().length > 0}
+ fallback={
+ <div class="px-6 py-8 text-center text-sm text-ink-muted">
+ {t('accountManager.settingsEmpty')}
+ </div>
+ }
+ >
+ <For each={grants()}>
+ {(grant) => (
+ <div class="flex min-h-14 items-center gap-3 px-6 py-3.5">
+ <div class="min-w-0 flex-1">
+ <div class="truncate text-sm font-medium text-ink">
+ {managerName(grant)}
+ </div>
+ <div class="mt-0.5 text-xs text-ink-extra-muted">
+ {grantDetail(grant)}
+ </div>
+ </div>
+ <Button
+ variant="ghost"
+ size="sm"
+ onClick={() => setPending(grant)}
+ >
+ {t('accountManager.revoke')}
+ </Button>
+ </div>
+ )}
+ </For>
+ </Show>
+ </Show>
+ </Show>
+ </SettingsCard>
+
+ <Dialog
+ open={pending() !== null}
+ onOpenChange={(open) => !open && !revoke.isPending && setPending(null)}
+ >
+ <Panel depth={2} class="rounded-xl text-ink">
+ <Panel.Header class="gap-1 px-2">
+ <Dialog.CloseButton
+ as={Button}
+ variant="ghost"
+ size="icon-sm"
+ disabled={revoke.isPending}
+ >
+ <XIcon class="size-3.5 touch:size-6 shrink-0 pointer-events-none" />
+ </Dialog.CloseButton>
+ <Dialog.Title as="span" class="m-0 p-0 text-sm font-medium">
+ {t('accountManager.revokeTitle')}
+ </Dialog.Title>
+ </Panel.Header>
+ <Panel.Body class="flex flex-col gap-3 p-3">
+ <Show when={pending()}>
+ {(grant) => (
+ <p class="wrap-anywhere text-sm text-ink-muted">
+ {t('accountManager.revokeConfirm', {
+ name: managerName(grant()),
+ })}
+ </p>
+ )}
+ </Show>
+ <div class="flex justify-end gap-1 pt-2">
+ <Button
+ variant="ghost"
+ disabled={revoke.isPending}
+ onClick={() => setPending(null)}
+ >
+ {t('accountManager.cancel')}
+ </Button>
+ <Button
+ variant="danger"
+ disabled={revoke.isPending}
+ onClick={confirmRevoke}
+ >
+ {t('accountManager.revoke')}
+ </Button>
+ </div>
+ </Panel.Body>
+ </Panel>
+ </Dialog>
+ </SettingsPage>
+ );
+}
+
+function formatTime(timestamp: string) {
+ return new Intl.DateTimeFormat(formatLocale(), {
+ dateStyle: 'medium',
+ timeStyle: 'short',
+ }).format(new Date(timestamp));
+}
+
+function grantDetail(grant: AccountManagerGrant) {
+ if (grant.status === 'approved') {
+ return t('accountManager.settingsAwaitingClaim');
+ }
+
+ if (grant.lastUsedAt) {
+ return t('accountManager.settingsLastUsed', {
+ time: formatTime(grant.lastUsedAt),
+ });
+ }
+
+ if (grant.claimedAt) {
+ return t('accountManager.settingsGranted', {
+ time: formatTime(grant.claimedAt),
+ });
+ }
+
+ return t('accountManager.settingsNeverUsed');
+}
diff --git a/apps/web/src/features/settings/SettingsTabContent.tsx b/apps/web/src/features/settings/SettingsTabContent.tsx
index 3c415a0d6a..b7070a6221 100644
--- a/apps/web/src/features/settings/SettingsTabContent.tsx
+++ b/apps/web/src/features/settings/SettingsTabContent.tsx
@@ -6,6 +6,7 @@ import { CalendarSettings } from '../calendar/calendar-settings';
import { CrmSettings as Crm } from '../crm/crm-settings';
import { Usage } from '../usage/usage';
import { Account } from './Account';
+import { AccountManagers } from './AccountManagers';
import { Admin } from './Admin';
import { Agent } from './Agent';
import { AgentSettings } from './AgentSettings';
@@ -54,6 +55,9 @@ export function SettingsTabContent(props: { tab: SettingsTab }) {
<Show when={isCurrentTab('API Keys')}>
<ApiKeys />
</Show>
+ <Show when={isCurrentTab('Account Managers')}>
+ <AccountManagers />
+ </Show>
<Show when={isCurrentTab('Notifications')}>
<Notifications />
</Show>
diff --git a/apps/web/src/features/settings/core/settings-search.ts b/apps/web/src/features/settings/core/settings-search.ts
index a8a5573f31..750eda26ce 100644
--- a/apps/web/src/features/settings/core/settings-search.ts
+++ b/apps/web/src/features/settings/core/settings-search.ts
@@ -331,6 +331,11 @@ const SETTINGS: Setting[] = [
title: 'Create and revoke API keys',
keywords: 'token secret developer authentication',
},
+ {
+ tab: 'Account Managers',
+ title: 'See and revoke the agents managing your account',
+ keywords: 'agent manager token access revoke',
+ },
{
tab: 'Desktop App',
title: 'Desktop app version and download',
diff --git a/apps/web/src/lib/core/component/LexicalMarkdown/component/core/StaticMarkdown.test.tsx b/apps/web/src/lib/core/component/LexicalMarkdown/component/core/StaticMarkdown.test.tsx
index 87286357c8..c05fd79134 100644
--- a/apps/web/src/lib/core/component/LexicalMarkdown/component/core/StaticMarkdown.test.tsx
+++ b/apps/web/src/lib/core/component/LexicalMarkdown/component/core/StaticMarkdown.test.tsx
@@ -324,4 +324,18 @@ describe('static markdown ordered lists', () => {
expect(list?.style.counterReset).toBe('static-md-counter-1 5');
rendered.unmount();
});
+
+ it('previews an account manager card as text in a single line', () => {
+ const rendered = render(() => (
+ <StaticMarkdownContext>
+ <StaticMarkdown
+ markdown='<m-account-manager-request>{"id":"019a4f2e-7c1b-7d3a-9e2f-3b1c8d5a6f70"}</m-account-manager-request>'
+ singleLine
+ />
+ </StaticMarkdownContext>
+ ));
+
+ expect(rendered.container.textContent).toBe('Account manager request');
+ expect(rendered.queryByRole('button')).toBeNull();
+ });
});
diff --git a/apps/web/src/lib/core/component/LexicalMarkdown/component/core/StaticMarkdown.tsx b/apps/web/src/lib/core/component/LexicalMarkdown/component/core/StaticMarkdown.tsx
index cb6c35a51a..619855e2f9 100644
--- a/apps/web/src/lib/core/component/LexicalMarkdown/component/core/StaticMarkdown.tsx
+++ b/apps/web/src/lib/core/component/LexicalMarkdown/component/core/StaticMarkdown.tsx
@@ -11,6 +11,7 @@ import type { HeadingNode, QuoteNode } from '@lexical/rich-text';
import type { TableCellNode, TableNode, TableRowNode } from '@lexical/table';
import {
$isClassedBlockNode,
+ type AccountManagerRequestNode,
type AgentActivityNode,
type AgentContextNode,
type AgentSessionMentionNode,
@@ -85,6 +86,7 @@ import type { SearchMatchNode } from '@macro-inc/lexical-core/nodes/SearchMatchN
import { theme as baseTheme, createTheme } from '../../theme';
import { forceSingleLine, setEditorStateFromMarkdown } from '../../utils';
import { StaticCodeBoxAccessory } from '../accessory/CodeBoxAccessory';
+import { AccountManagerRequest as AccountManagerRequestDecorator } from '../decorator/AccountManagerRequest';
import { AgentActivity as AgentActivityDecorator } from '../decorator/AgentActivity';
import { AgentContext as AgentContextDecorator } from '../decorator/AgentContext';
import { AgentSessionMention as AgentSessionMentionDecorator } from '../decorator/AgentSessionMention';
@@ -486,6 +488,21 @@ const ConnectApp: TypedRenderableEntity<ConnectAppNode> = {
),
};
+const AccountManagerRequest: TypedRenderableEntity<AccountManagerRequestNode> =
+ {
+ guard: (node: LexicalNode): node is AccountManagerRequestNode =>
+ node.__type === 'account-manager-request',
+ render: (props) => (
+ <span>
+ {AccountManagerRequestDecorator({
+ ...props.node.exportComponentProps(),
+ key: props.node.getKey(),
+ theme: props.theme,
+ })}
+ </span>
+ ),
+ };
+
const DatabaseQuery: TypedRenderableEntity<DatabaseQueryNode> = {
guard: (node: LexicalNode): node is DatabaseQueryNode =>
node.__type === 'database-query',
@@ -1050,6 +1067,7 @@ const InlineEntities: RenderableEntity[] = [
eraseRenderableEntity(ThemeMention),
eraseRenderableEntity(TagMention),
eraseRenderableEntity(ConnectApp),
+ eraseRenderableEntity(AccountManagerRequest),
eraseRenderableEntity(DatabaseQuery),
eraseRenderableEntity(UnknownMention),
eraseRenderableEntity(Watermark),
diff --git a/apps/web/src/lib/core/component/LexicalMarkdown/component/decorator/AccountManagerRequest.tsx b/apps/web/src/lib/core/component/LexicalMarkdown/component/decorator/AccountManagerRequest.tsx
new file mode 100644
index 0000000000..e0ebc2f19f
--- /dev/null
+++ b/apps/web/src/lib/core/component/LexicalMarkdown/component/decorator/AccountManagerRequest.tsx
@@ -0,0 +1,19 @@
+import { AccountManagerCardFrame } from '@app/features/account-manager/account-manager-card-frame';
+import { lazyNamed } from '@core/util/lazyNamed';
+import type { AccountManagerRequestDecoratorProps } from '@macro-inc/lexical-core';
+import { Suspense } from 'solid-js';
+
+const AccountManagerCard = lazyNamed(
+ () => import('@app/features/account-manager/account-manager-card'),
+ 'AccountManagerCard'
+);
+
+export function AccountManagerRequest(
+ props: AccountManagerRequestDecoratorProps
+) {
+ return (
+ <Suspense fallback={<AccountManagerCardFrame />}>
+ <AccountManagerCard grantId={props.grantId} />
+ </Suspense>
+ );
+}
diff --git a/apps/web/src/lib/core/component/LexicalMarkdown/init.ts b/apps/web/src/lib/core/component/LexicalMarkdown/init.ts
index 2468001605..48b7148bc9 100644
--- a/apps/web/src/lib/core/component/LexicalMarkdown/init.ts
+++ b/apps/web/src/lib/core/component/LexicalMarkdown/init.ts
@@ -1,5 +1,6 @@
import { lazyNamed } from '@core/util/lazyNamed';
import {
+ AccountManagerRequestNode,
AgentActivityNode,
AgentContextNode,
AgentSessionMentionNode,
@@ -36,6 +37,7 @@ import {
} from '@macro-inc/lexical-core/decoratorRegistry';
import type { HtmlRenderDecoratorProps } from '@macro-inc/lexical-core/nodes/HtmlRenderNode';
import { createComponent, Suspense } from 'solid-js';
+import { AccountManagerRequest } from './component/decorator/AccountManagerRequest';
import { AgentActivity } from './component/decorator/AgentActivity';
import { AgentContext } from './component/decorator/AgentContext';
import { AgentSessionMention } from './component/decorator/AgentSessionMention';
@@ -107,6 +109,7 @@ export function initializeLexical() {
setDecorator(HtmlRenderNode, HtmlRender);
setDecorator(ThemeMentionNode, ThemeMention);
setDecorator(ConnectAppNode, ConnectApp);
+ setDecorator(AccountManagerRequestNode, AccountManagerRequest);
setDecorator(TagMentionNode, TagMention);
setDecorator(UnknownMentionNode, UnknownMention);
setDecorator(WatermarkNode, Watermark);
diff --git a/apps/web/src/lib/core/component/LexicalMarkdown/utils.ts b/apps/web/src/lib/core/component/LexicalMarkdown/utils.ts
index 143d683632..3af4d0d903 100644
--- a/apps/web/src/lib/core/component/LexicalMarkdown/utils.ts
+++ b/apps/web/src/lib/core/component/LexicalMarkdown/utils.ts
@@ -20,6 +20,7 @@ import {
mergeRegister,
} from '@lexical/utils';
import {
+ $isAccountManagerRequestNode,
$isDocumentMentionNode,
$isMentionNode,
$isWatermarkNode,
@@ -1205,6 +1206,17 @@ const $singleLineNode = (node: ElementNode): ElementNode | null => {
return p;
};
+/** A one-line preview has no room for a card with its own controls. */
+function $replaceAccountManagerCardsWithText(parent: ElementNode) {
+ for (const child of parent.getChildren()) {
+ if ($isAccountManagerRequestNode(child)) {
+ child.replace($createTextNode(child.getTextContent()));
+ } else if ($isElementNode(child)) {
+ $replaceAccountManagerCardsWithText(child);
+ }
+ }
+}
+
export function forceSingleLine(editor: LexicalEditor) {
editor.update(
() => {
@@ -1225,6 +1237,7 @@ export function forceSingleLine(editor: LexicalEditor) {
root.clear();
if (firstChild) {
root.append(firstChild);
+ $replaceAccountManagerCardsWithText(firstChild);
} else {
root.append($createParagraphNode().append($createTextNode('')));
}
diff --git a/apps/web/src/lib/core/component/LexicalMarkdown/version.ts b/apps/web/src/lib/core/component/LexicalMarkdown/version.ts
index c5ffbe3187..a02b305faa 100644
--- a/apps/web/src/lib/core/component/LexicalMarkdown/version.ts
+++ b/apps/web/src/lib/core/component/LexicalMarkdown/version.ts
@@ -38,5 +38,6 @@
* Version 9.1 - Oct 2026. Markdown m-link payloads preserve explicit unlinking; bare URLs import as links.
* Version 9.2 - Nov 2026. ImageNode may be a child of ListItemNode; Markdown stores it as an indented line under its item.
* Version 9.3 - Nov 2026. AgentActivityNode rows carry an optional `card`: a view the agent presented.
+ * Version 10.0 - Nov 2026. Added AccountManagerRequestNode: a DM card for one account manager request, holding only its grant id.
*/
-export const MARKDOWN_VERSION_COUNTER = 9.3;
+export const MARKDOWN_VERSION_COUNTER = 10.0;
diff --git a/apps/web/src/lib/core/constant/SettingsState.tsx b/apps/web/src/lib/core/constant/SettingsState.tsx
index 82b870fec1..d046842158 100644
--- a/apps/web/src/lib/core/constant/SettingsState.tsx
+++ b/apps/web/src/lib/core/constant/SettingsState.tsx
@@ -15,6 +15,7 @@ export type SettingsTab =
| 'Calendar'
| 'Account'
| 'API Keys'
+ | 'Account Managers'
| 'Notifications'
| 'Usage'
| 'Billing'
diff --git a/apps/web/src/lib/core/constant/settingsTabsConfig.tsx b/apps/web/src/lib/core/constant/settingsTabsConfig.tsx
index 7afc32e5a9..4d1135cef5 100644
--- a/apps/web/src/lib/core/constant/settingsTabsConfig.tsx
+++ b/apps/web/src/lib/core/constant/settingsTabsConfig.tsx
@@ -21,6 +21,7 @@ import AgentIcon from '@icon/system/regular/sparkle.svg';
import SwatchesIcon from '@icon/system/regular/swatches.svg';
import TagIcon from '@icon/system/regular/tag-simple.svg';
import UserIconPhosphor from '@icon/system/regular/user.svg';
+import UserGearIcon from '@icon/system/regular/user-gear.svg';
import UsersIcon from '@icon/system/regular/users.svg';
import UsersThreeIcon from '@icon/system/regular/users-three.svg';
import { type Component, createMemo } from 'solid-js';
@@ -261,6 +262,11 @@ export const SETTINGS_TAB_GROUPS: SettingsTabGroup[] = [
icon: KeyIcon,
keywords: ['api', 'key', 'token', 'authentication'],
}),
+ tabItem('tabAccountManagers', {
+ tab: 'Account Managers',
+ icon: UserGearIcon,
+ keywords: ['agent', 'manager', 'token', 'revoke', 'access'],
+ }),
tabItem('tabBots', {
tab: 'Bots',
icon: BotIcon,
@@ -285,6 +291,7 @@ export const SETTINGS_TAB_GROUPS: SettingsTabGroup[] = [
const SETTINGS_TAB_SLUGS: Record<SettingsTab, string> = {
Account: 'account',
'API Keys': 'api-keys',
+ 'Account Managers': 'account-managers',
Notifications: 'notifications',
Usage: 'usage',
Billing: 'billing',
@@ -366,6 +373,9 @@ export const useSettingsTabAvailable = () => {
// good place for a one-time secret.
case 'API Keys':
return !isMobile();
+ // Cutting off a manager can't wait for a desktop.
+ case 'Account Managers':
+ return true;
case 'Team':
case 'Team Members':
case 'Tags':
diff --git a/apps/web/src/lib/i18n/locales/en.ts b/apps/web/src/lib/i18n/locales/en.ts
index e01c4969b9..ddd9b174d0 100644
--- a/apps/web/src/lib/i18n/locales/en.ts
+++ b/apps/web/src/lib/i18n/locales/en.ts
@@ -1,3 +1,4 @@
+import accountManager from './en/account-manager';
import agentAutoArchive from './en/agent-auto-archive';
import agentSetup from './en/agent-setup';
import agentWork from './en/agent-work';
@@ -28,6 +29,7 @@ import viewMenus from './en/view-menus';
*/
export default {
agentAutoArchive,
+ accountManager,
agentSetup,
agentWork,
calls,
diff --git a/apps/web/src/lib/i18n/locales/en/account-manager.ts b/apps/web/src/lib/i18n/locales/en/account-manager.ts
new file mode 100644
index 0000000000..7df0f86513
--- /dev/null
+++ b/apps/web/src/lib/i18n/locales/en/account-manager.ts
@@ -0,0 +1,65 @@
+/** Account manager requests in DMs, the token page, and the settings tab. */
+export default {
+ requestAction: 'Account manager',
+ requestDialogTitle: 'Account manager',
+ askToBeManaged: 'Ask {{name}} to manage my account',
+ askToBeManagedWarning:
+ '{{name}} will get full access to your account until you revoke it in Settings → Account Managers.',
+ askToManage: 'Ask to manage {{name}}’s account',
+ askToManageWarning:
+ 'If {{name}} approves, this account gets a token with full access to theirs.',
+ requestSent: 'Request sent',
+ requestFailed: 'Couldn’t send the request',
+ cancel: 'Cancel',
+
+ cardTitleManaged: '{{name}} wants to manage your account',
+ cardTitleManager: '{{name}} wants you to manage their account',
+ cardOwnRequestManaged: 'You asked {{name}} to manage your account',
+ cardOwnRequestManager: 'You asked to manage {{name}}’s account',
+ cardApprovedManaged: '{{name}} can now reveal a token for your account',
+ cardApprovedManager: 'You can reveal your token for {{name}}’s account',
+ cardActiveManaged: '{{name}} manages your account',
+ cardActiveManager: 'You manage {{name}}’s account',
+ cardDeclined: 'This request was declined',
+ cardRevoked: 'This access has ended',
+ cardExpired: 'This request expired',
+ cardUnavailable: 'This request isn’t available',
+ cardWaiting: 'Waiting for a response',
+ cardFullAccess: 'Full access until revoked',
+ cardExpires: 'Expires {{date}} unless the token is revealed',
+
+ approve: 'Approve',
+ decline: 'Decline',
+ withdraw: 'Withdraw',
+ revealToken: 'Reveal token',
+ actionFailed: 'Something went wrong. Try again.',
+
+ confirmTitle: 'Approve account manager',
+ confirmManaged:
+ '{{name}} will get a token with full access to your account: your documents, messages, and everything else except its managers, API keys, sign-in, and deleting the account. It lasts until you revoke it in Settings → Account Managers.',
+ confirmManager: 'You’ll get a token with full access to {{name}}’s account.',
+
+ tokenTitle: 'Your token',
+ tokenLabel: 'SDK token',
+ tokenHelp: 'Shown only once',
+ tokenWarning:
+ 'Save this token now. It can’t be shown again; if you lose it, request access again.',
+ done: 'Done',
+
+ pageTitle: 'Account manager access',
+ settingsTitle: 'Account Managers',
+ settingsDescription:
+ 'Agent accounts with full access to your account. Revoking stops their token immediately; anything they already created stays.',
+ settingsEmpty: 'No one manages your account.',
+ settingsLoadFailed: 'Couldn’t load account managers.',
+ settingsGranted: 'Token revealed {{time}}',
+ settingsLastUsed: 'Last used {{time}}',
+ settingsNeverUsed: 'Not used yet',
+ settingsAwaitingClaim: 'Approved. Token not revealed yet.',
+ revoke: 'Revoke',
+ revokeTitle: 'Revoke account manager',
+ revokeConfirm:
+ '{{name}} will lose access to your account immediately. Anything it already created stays.',
+ revoked: 'Access revoked',
+ revokeFailed: 'Couldn’t revoke access',
+};
diff --git a/apps/web/src/lib/i18n/locales/en/settings-nav.ts b/apps/web/src/lib/i18n/locales/en/settings-nav.ts
index 69213a8b04..7254caf9a2 100644
--- a/apps/web/src/lib/i18n/locales/en/settings-nav.ts
+++ b/apps/web/src/lib/i18n/locales/en/settings-nav.ts
@@ -28,6 +28,7 @@ export default {
tabRuntimes: 'Runtimes',
tabMcpServer: 'MCP server',
tabApiKeys: 'API Keys',
+ tabAccountManagers: 'Account Managers',
tabBots: 'Bots',
tabDebug: 'Debug',
diff --git a/apps/web/src/lib/queries/account-managers/account-managers.ts b/apps/web/src/lib/queries/account-managers/account-managers.ts
new file mode 100644
index 0000000000..401bc24cf2
--- /dev/null
+++ b/apps/web/src/lib/queries/account-managers/account-managers.ts
@@ -0,0 +1,81 @@
+import { throwOnErr } from '@core/util/result';
+import { queryClient } from '@queries/client';
+import { storageServiceClient } from '@service-storage/client';
+import type { AccountManagerDecision } from '@service-storage/generated/schemas/accountManagerDecision';
+import type { AccountManagerGrant } from '@service-storage/generated/schemas/accountManagerGrant';
+import type { AccountManagerRole } from '@service-storage/generated/schemas/accountManagerRole';
+import { useMutation, useQuery } from '@tanstack/solid-query';
+import type { Accessor } from 'solid-js';
+import { accountManagerKeys } from './keys';
+
+function storeGrant(grant: AccountManagerGrant) {
+ queryClient.setQueryData(accountManagerKeys.grant(grant.id).queryKey, grant);
+ return queryClient.invalidateQueries({
+ queryKey: accountManagerKeys.list.queryKey,
+ });
+}
+
+function accountManagersOptions() {
+ return {
+ queryKey: accountManagerKeys.list.queryKey,
+ queryFn: () => throwOnErr(() => storageServiceClient.listAccountManagers()),
+ };
+}
+
+export function useAccountManagersQuery() {
+ return useQuery(accountManagersOptions);
+}
+
+function accountManagerGrantOptions(id: string) {
+ return {
+ queryKey: accountManagerKeys.grant(id).queryKey,
+ queryFn: () =>
+ throwOnErr(() => storageServiceClient.getAccountManagerGrant({ id })),
+ retry: false,
+ // The other account changes this grant, so a cached status can be wrong
+ // when a card or the approval link opens.
+ staleTime: 0,
+ };
+}
+
+export function useAccountManagerGrantQuery(id: Accessor<string>) {
+ return useQuery(() => accountManagerGrantOptions(id()));
+}
+
+export function useRequestAccountManagerMutation() {
+ return useMutation(() => ({
+ mutationFn: (vars: {
+ counterpartyId: string;
+ callerRole: AccountManagerRole;
+ }) => throwOnErr(() => storageServiceClient.requestAccountManager(vars)),
+ onSuccess: storeGrant,
+ }));
+}
+
+export function useRespondToAccountManagerRequestMutation() {
+ return useMutation(() => ({
+ mutationFn: (vars: { id: string; decision: AccountManagerDecision }) =>
+ throwOnErr(() =>
+ storageServiceClient.respondToAccountManagerRequest(vars)
+ ),
+ onSuccess: storeGrant,
+ }));
+}
+
+export function useClaimAccountManagerTokenMutation() {
+ return useMutation(() => ({
+ // The result holds the secret, so the cache must not keep it.
+ gcTime: 0,
+ mutationFn: (vars: { id: string }) =>
+ throwOnErr(() => storageServiceClient.claimAccountManagerToken(vars)),
+ onSuccess: (claimed) => storeGrant(claimed.grant),
+ }));
+}
+
+export function useRevokeAccountManagerGrantMutation() {
+ return useMutation(() => ({
+ mutationFn: (vars: { id: string }) =>
+ throwOnErr(() => storageServiceClient.revokeAccountManagerGrant(vars)),
+ onSuccess: storeGrant,
+ }));
+}
diff --git a/apps/web/src/lib/queries/account-managers/keys.ts b/apps/web/src/lib/queries/account-managers/keys.ts
new file mode 100644
index 0000000000..5de3137cf5
--- /dev/null
+++ b/apps/web/src/lib/queries/account-managers/keys.ts
@@ -0,0 +1,6 @@
+import { createQueryKeys } from '@lukemorales/query-key-factory';
+
+export const accountManagerKeys = createQueryKeys('accountManagers', {
+ list: null,
+ grant: (id: string) => [id],
+});
diff --git a/apps/web/src/lib/service-clients/service-storage/client.ts b/apps/web/src/lib/service-clients/service-storage/client.ts
index dd0093f16a..d83f7f8b1f 100644
--- a/apps/web/src/lib/service-clients/service-storage/client.ts
+++ b/apps/web/src/lib/service-clients/service-storage/client.ts
@@ -32,6 +32,9 @@ import type { ApiChannelListPage } from './channel-list-types';
import { fetchDatabaseOps } from './databases';
import type { AccessiblePipeline as PipelineResponse } from './generated/schemas/accessiblePipeline';
import type { AccessLevel } from './generated/schemas/accessLevel';
+import type { AccountManagerDecision } from './generated/schemas/accountManagerDecision';
+import type { AccountManagerGrant } from './generated/schemas/accountManagerGrant';
+import type { AccountManagersList } from './generated/schemas/accountManagersList';
import type { AddFavoriteRequest } from './generated/schemas/addFavoriteRequest';
import type { AddParticipantsRequest } from './generated/schemas/addParticipantsRequest';
import type { AddPinRequest } from './generated/schemas/addPinRequest';
@@ -61,6 +64,7 @@ import type { ChannelLabelRule } from './generated/schemas/channelLabelRule';
import type { ChannelLabelScopeSelection } from './generated/schemas/channelLabelScopeSelection';
import type { ChannelLabelsList } from './generated/schemas/channelLabelsList';
import { ChannelType } from './generated/schemas/channelType';
+import type { ClaimedAccountManagerToken } from './generated/schemas/claimedAccountManagerToken';
import {
type CloudStorageItemType,
CloudStorageItemType as CloudStorageItemTypeMap,
@@ -161,6 +165,7 @@ import type { RenameChannelLabelRequest } from './generated/schemas/renameChanne
import type { ReorderFavoritesRequest } from './generated/schemas/reorderFavoritesRequest';
import type { ReorderPinRequest } from './generated/schemas/reorderPinRequest';
import type { ReplaceCrmStagesRequest } from './generated/schemas/replaceCrmStagesRequest';
+import type { RequestAccountManagerBody } from './generated/schemas/requestAccountManagerBody';
import type { SaveDocumentResponseData } from './generated/schemas/saveDocumentResponseData';
import type { SearchContactsParams } from './generated/schemas/searchContactsParams';
import type { SearchContactsResponse } from './generated/schemas/searchContactsResponse';
@@ -964,6 +969,52 @@ export const storageServiceClient = {
});
},
+ async listAccountManagers() {
+ return (
+ await dssFetch<AccountManagersList>(`/account-managers`, {
+ method: 'GET',
+ })
+ ).map((result) => result.grants);
+ },
+
+ async getAccountManagerGrant(args: { id: string }) {
+ return await dssFetch<AccountManagerGrant>(
+ `/account-managers/${encodeURIComponent(args.id)}`,
+ { method: 'GET' }
+ );
+ },
+
+ async requestAccountManager(args: RequestAccountManagerBody) {
+ return await dssFetch<AccountManagerGrant>(`/account-managers`, {
+ method: 'POST',
+ body: JSON.stringify(args),
+ });
+ },
+
+ async respondToAccountManagerRequest(args: {
+ id: string;
+ decision: AccountManagerDecision;
+ }) {
+ return await dssFetch<AccountManagerGrant>(
+ `/account-managers/${encodeURIComponent(args.id)}/response`,
+ { method: 'POST', body: JSON.stringify({ decision: args.decision }) }
+ );
+ },
+
+ async claimAccountManagerToken(args: { id: string }) {
+ return await dssFetch<ClaimedAccountManagerToken>(
+ `/account-managers/${encodeURIComponent(args.id)}/token`,
+ { method: 'POST' }
+ );
+ },
+
+ async revokeAccountManagerGrant(args: { id: string }) {
+ return await dssFetch<AccountManagerGrant>(
+ `/account-managers/${encodeURIComponent(args.id)}`,
+ { method: 'DELETE' }
+ );
+ },
+
async listUserApiKeys() {
return (
await dssFetch<UserApiKeysList>(`/user-api-keys`, {
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/accountManagerDecision.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/accountManagerDecision.ts
new file mode 100644
index 0000000000..92f00b2753
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/accountManagerDecision.ts
@@ -0,0 +1,18 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+
+/**
+ * A response to a request.
+ */
+export type AccountManagerDecision =
+ (typeof AccountManagerDecision)[keyof typeof AccountManagerDecision];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const AccountManagerDecision = {
+ approve: 'approve',
+ decline: 'decline',
+} as const;
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/accountManagerGrant.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/accountManagerGrant.ts
new file mode 100644
index 0000000000..903148fd70
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/accountManagerGrant.ts
@@ -0,0 +1,35 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+import type { AccountManagerGrantClaimedAt } from './accountManagerGrantClaimedAt';
+import type { AccountManagerGrantExpiresAt } from './accountManagerGrantExpiresAt';
+import type { AccountManagerGrantLastUsedAt } from './accountManagerGrantLastUsedAt';
+import type { AccountManagerGrantStatus } from './accountManagerGrantStatus';
+import type { AccountManagerRole } from './accountManagerRole';
+
+/**
+ * A request for manager access and what became of it.
+ */
+export interface AccountManagerGrant {
+ /** When the manager claimed the credential. */
+ claimedAt?: AccountManagerGrantClaimedAt;
+ /** When the request was made. */
+ createdAt: string;
+ /** When the pending request or unclaimed approval stops being usable. */
+ expiresAt?: AccountManagerGrantExpiresAt;
+ /** Grant id. */
+ id: string;
+ /** When the credential was last used, to the minute. */
+ lastUsedAt?: AccountManagerGrantLastUsedAt;
+ /** The account being managed. */
+ managedUserId: string;
+ /** The agent account doing the managing. */
+ managerUserId: string;
+ /** The side that asked. */
+ requestedBy: AccountManagerRole;
+ /** Lifecycle status. */
+ status: AccountManagerGrantStatus;
+}
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/accountManagerGrantClaimedAt.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/accountManagerGrantClaimedAt.ts
new file mode 100644
index 0000000000..c5b9eccc01
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/accountManagerGrantClaimedAt.ts
@@ -0,0 +1,11 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+
+/**
+ * When the manager claimed the credential.
+ */
+export type AccountManagerGrantClaimedAt = string | null;
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/accountManagerGrantExpiresAt.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/accountManagerGrantExpiresAt.ts
new file mode 100644
index 0000000000..54f72bc22a
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/accountManagerGrantExpiresAt.ts
@@ -0,0 +1,11 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+
+/**
+ * When the pending request or unclaimed approval stops being usable.
+ */
+export type AccountManagerGrantExpiresAt = string | null;
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/accountManagerGrantLastUsedAt.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/accountManagerGrantLastUsedAt.ts
new file mode 100644
index 0000000000..e6214b350b
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/accountManagerGrantLastUsedAt.ts
@@ -0,0 +1,11 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+
+/**
+ * When the credential was last used, to the minute.
+ */
+export type AccountManagerGrantLastUsedAt = string | null;
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/accountManagerGrantStatus.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/accountManagerGrantStatus.ts
new file mode 100644
index 0000000000..a5307d45e7
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/accountManagerGrantStatus.ts
@@ -0,0 +1,22 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+
+/**
+ * Where a grant is in its lifecycle.
+ */
+export type AccountManagerGrantStatus =
+ (typeof AccountManagerGrantStatus)[keyof typeof AccountManagerGrantStatus];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const AccountManagerGrantStatus = {
+ pending: 'pending',
+ approved: 'approved',
+ declined: 'declined',
+ active: 'active',
+ revoked: 'revoked',
+ expired: 'expired',
+} as const;
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/accountManagerRole.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/accountManagerRole.ts
new file mode 100644
index 0000000000..d6883d5273
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/accountManagerRole.ts
@@ -0,0 +1,18 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+
+/**
+ * One side of a grant.
+ */
+export type AccountManagerRole =
+ (typeof AccountManagerRole)[keyof typeof AccountManagerRole];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const AccountManagerRole = {
+ managed: 'managed',
+ manager: 'manager',
+} as const;
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/accountManagersList.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/accountManagersList.ts
new file mode 100644
index 0000000000..f5c4efc990
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/accountManagersList.ts
@@ -0,0 +1,15 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+import type { AccountManagerGrant } from './accountManagerGrant';
+
+/**
+ * The managers of the caller's account.
+ */
+export interface AccountManagersList {
+ /** Approved and active grants on the caller's account. */
+ grants: AccountManagerGrant[];
+}
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/claimedAccountManagerToken.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/claimedAccountManagerToken.ts
new file mode 100644
index 0000000000..221bce5b04
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/claimedAccountManagerToken.ts
@@ -0,0 +1,17 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+import type { AccountManagerGrant } from './accountManagerGrant';
+
+/**
+ * The credential, returned only by the claim that issued it.
+ */
+export interface ClaimedAccountManagerToken {
+ /** The grant, now active. */
+ grant: AccountManagerGrant;
+ /** The secret. Shown only once. */
+ token: string;
+}
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/index.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/index.ts
index 0f651c810c..161383c400 100644
--- a/apps/web/src/lib/service-clients/service-storage/generated/schemas/index.ts
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/index.ts
@@ -20,6 +20,14 @@ export * from './accessRequestStateNextOffset';
export * from './accessRequestStateOwner';
export * from './accessRequestsCancelParams';
export * from './accessRequestsStateParams';
+export * from './accountManagerDecision';
+export * from './accountManagerGrant';
+export * from './accountManagerGrantClaimedAt';
+export * from './accountManagerGrantExpiresAt';
+export * from './accountManagerGrantLastUsedAt';
+export * from './accountManagerGrantStatus';
+export * from './accountManagerRole';
+export * from './accountManagersList';
export * from './activeCallSummary';
export * from './activeCallsResponse';
export * from './activeMeeting';
@@ -422,6 +430,7 @@ export * from './chatProjectId';
export * from './chatTokenCount';
export * from './chatType';
export * from './chatUpdatedAt';
+export * from './claimedAccountManagerToken';
export * from './claimedPairing';
export * from './claimPairingRequest';
export * from './cloudStorageItemType';
@@ -1741,6 +1750,7 @@ export * from './reorderPinRequest';
export * from './replaceCrmStagesRequest';
export * from './requestAccess';
export * from './requestAccessRevision';
+export * from './requestAccountManagerBody';
export * from './requestedLayout';
export * from './requestedLayoutOneOf';
export * from './requestedLayoutOneOfFive';
@@ -1754,6 +1764,7 @@ export * from './requestStatus';
export * from './resolveChannelAccessRequest';
export * from './resolveRequest';
export * from './resolveRequestGrantedLevel';
+export * from './respondToAccountManagerRequestBody';
export * from './responseStatus';
export * from './responseSummary';
export * from './resultColumn';
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/requestAccountManagerBody.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/requestAccountManagerBody.ts
new file mode 100644
index 0000000000..974eee70aa
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/requestAccountManagerBody.ts
@@ -0,0 +1,17 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+import type { AccountManagerRole } from './accountManagerRole';
+
+/**
+ * Request body for asking for a grant.
+ */
+export interface RequestAccountManagerBody {
+ /** The side the caller takes. */
+ callerRole: AccountManagerRole;
+ /** The other account (`macro|...`). */
+ counterpartyId: string;
+}
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/respondToAccountManagerRequestBody.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/respondToAccountManagerRequestBody.ts
new file mode 100644
index 0000000000..a0be33e0fc
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/respondToAccountManagerRequestBody.ts
@@ -0,0 +1,15 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+import type { AccountManagerDecision } from './accountManagerDecision';
+
+/**
+ * Request body for responding to a request.
+ */
+export interface RespondToAccountManagerRequestBody {
+ /** The response. */
+ decision: AccountManagerDecision;
+}
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/zod.ts b/apps/web/src/lib/service-clients/service-storage/generated/zod.ts
index 8761d765e1..765e4a96a6 100644
--- a/apps/web/src/lib/service-clients/service-storage/generated/zod.ts
+++ b/apps/web/src/lib/service-clients/service-storage/generated/zod.ts
@@ -6,6 +6,273 @@
*/
import * as zod from 'zod';
+/**
+ * @summary List the managers of the caller's account.
+ */
+export const listAccountManagersResponse = zod
+ .object({
+ grants: zod
+ .array(
+ zod
+ .object({
+ claimedAt: zod.iso
+ .datetime({})
+ .nullish()
+ .describe('When the manager claimed the credential.'),
+ createdAt: zod.iso
+ .datetime({})
+ .describe('When the request was made.'),
+ expiresAt: zod.iso
+ .datetime({})
+ .nullish()
+ .describe(
+ 'When the pending request or unclaimed approval stops being usable.'
+ ),
+ id: zod.uuid().describe('Grant id.'),
+ lastUsedAt: zod.iso
+ .datetime({})
+ .nullish()
+ .describe('When the credential was last used, to the minute.'),
+ managedUserId: zod.string().describe('The account being managed.'),
+ managerUserId: zod
+ .string()
+ .describe('The agent account doing the managing.'),
+ requestedBy: zod
+ .enum(['managed', 'manager'])
+ .describe('One side of a grant.'),
+ status: zod
+ .enum([
+ 'pending',
+ 'approved',
+ 'declined',
+ 'active',
+ 'revoked',
+ 'expired',
+ ])
+ .describe('Where a grant is in its lifecycle.'),
+ })
+ .describe('A request for manager access and what became of it.')
+ )
+ .describe("Approved and active grants on the caller's account."),
+ })
+ .describe("The managers of the caller's account.");
+
+/**
+ * @summary Ask another account for manager access, in your DM with them.
+ */
+export const requestAccountManagerBody = zod
+ .object({
+ callerRole: zod
+ .enum(['managed', 'manager'])
+ .describe('One side of a grant.'),
+ counterpartyId: zod.string().describe('The other account (`macro|...`).'),
+ })
+ .describe('Request body for asking for a grant.');
+
+export const requestAccountManagerResponse = zod
+ .object({
+ claimedAt: zod.iso
+ .datetime({})
+ .nullish()
+ .describe('When the manager claimed the credential.'),
+ createdAt: zod.iso.datetime({}).describe('When the request was made.'),
+ expiresAt: zod.iso
+ .datetime({})
+ .nullish()
+ .describe(
+ 'When the pending request or unclaimed approval stops being usable.'
+ ),
+ id: zod.uuid().describe('Grant id.'),
+ lastUsedAt: zod.iso
+ .datetime({})
+ .nullish()
+ .describe('When the credential was last used, to the minute.'),
+ managedUserId: zod.string().describe('The account being managed.'),
+ managerUserId: zod
+ .string()
+ .describe('The agent account doing the managing.'),
+ requestedBy: zod
+ .enum(['managed', 'manager'])
+ .describe('One side of a grant.'),
+ status: zod
+ .enum(['pending', 'approved', 'declined', 'active', 'revoked', 'expired'])
+ .describe('Where a grant is in its lifecycle.'),
+ })
+ .describe('A request for manager access and what became of it.');
+
+/**
+ * @summary Read a grant the caller is part of.
+ */
+export const getAccountManagerGrantParams = zod.object({
+ id: zod.uuid().describe('Grant id.'),
+});
+
+export const getAccountManagerGrantResponse = zod
+ .object({
+ claimedAt: zod.iso
+ .datetime({})
+ .nullish()
+ .describe('When the manager claimed the credential.'),
+ createdAt: zod.iso.datetime({}).describe('When the request was made.'),
+ expiresAt: zod.iso
+ .datetime({})
+ .nullish()
+ .describe(
+ 'When the pending request or unclaimed approval stops being usable.'
+ ),
+ id: zod.uuid().describe('Grant id.'),
+ lastUsedAt: zod.iso
+ .datetime({})
+ .nullish()
+ .describe('When the credential was last used, to the minute.'),
+ managedUserId: zod.string().describe('The account being managed.'),
+ managerUserId: zod
+ .string()
+ .describe('The agent account doing the managing.'),
+ requestedBy: zod
+ .enum(['managed', 'manager'])
+ .describe('One side of a grant.'),
+ status: zod
+ .enum(['pending', 'approved', 'declined', 'active', 'revoked', 'expired'])
+ .describe('Where a grant is in its lifecycle.'),
+ })
+ .describe('A request for manager access and what became of it.');
+
+/**
+ * @summary End a grant. Either side may withdraw it.
+ */
+export const revokeAccountManagerGrantParams = zod.object({
+ id: zod.uuid().describe('Grant id.'),
+});
+
+export const revokeAccountManagerGrantResponse = zod
+ .object({
+ claimedAt: zod.iso
+ .datetime({})
+ .nullish()
+ .describe('When the manager claimed the credential.'),
+ createdAt: zod.iso.datetime({}).describe('When the request was made.'),
+ expiresAt: zod.iso
+ .datetime({})
+ .nullish()
+ .describe(
+ 'When the pending request or unclaimed approval stops being usable.'
+ ),
+ id: zod.uuid().describe('Grant id.'),
+ lastUsedAt: zod.iso
+ .datetime({})
+ .nullish()
+ .describe('When the credential was last used, to the minute.'),
+ managedUserId: zod.string().describe('The account being managed.'),
+ managerUserId: zod
+ .string()
+ .describe('The agent account doing the managing.'),
+ requestedBy: zod
+ .enum(['managed', 'manager'])
+ .describe('One side of a grant.'),
+ status: zod
+ .enum(['pending', 'approved', 'declined', 'active', 'revoked', 'expired'])
+ .describe('Where a grant is in its lifecycle.'),
+ })
+ .describe('A request for manager access and what became of it.');
+
+/**
+ * @summary Approve or decline a request the caller didn't make.
+ */
+export const respondToAccountManagerRequestParams = zod.object({
+ id: zod.uuid().describe('Grant id.'),
+});
+
+export const respondToAccountManagerRequestBody = zod
+ .object({
+ decision: zod
+ .enum(['approve', 'decline'])
+ .describe('A response to a request.'),
+ })
+ .describe('Request body for responding to a request.');
+
+export const respondToAccountManagerRequestResponse = zod
+ .object({
+ claimedAt: zod.iso
+ .datetime({})
+ .nullish()
+ .describe('When the manager claimed the credential.'),
+ createdAt: zod.iso.datetime({}).describe('When the request was made.'),
+ expiresAt: zod.iso
+ .datetime({})
+ .nullish()
+ .describe(
+ 'When the pending request or unclaimed approval stops being usable.'
+ ),
+ id: zod.uuid().describe('Grant id.'),
+ lastUsedAt: zod.iso
+ .datetime({})
+ .nullish()
+ .describe('When the credential was last used, to the minute.'),
+ managedUserId: zod.string().describe('The account being managed.'),
+ managerUserId: zod
+ .string()
+ .describe('The agent account doing the managing.'),
+ requestedBy: zod
+ .enum(['managed', 'manager'])
+ .describe('One side of a grant.'),
+ status: zod
+ .enum(['pending', 'approved', 'declined', 'active', 'revoked', 'expired'])
+ .describe('Where a grant is in its lifecycle.'),
+ })
+ .describe('A request for manager access and what became of it.');
+
+/**
+ * @summary Issue the credential to the manager. Works once. A POST, so link previews
+and crawlers can't use it up.
+ */
+export const claimAccountManagerTokenParams = zod.object({
+ id: zod.uuid().describe('Grant id.'),
+});
+
+export const claimAccountManagerTokenResponse = zod
+ .object({
+ grant: zod
+ .object({
+ claimedAt: zod.iso
+ .datetime({})
+ .nullish()
+ .describe('When the manager claimed the credential.'),
+ createdAt: zod.iso.datetime({}).describe('When the request was made.'),
+ expiresAt: zod.iso
+ .datetime({})
+ .nullish()
+ .describe(
+ 'When the pending request or unclaimed approval stops being usable.'
+ ),
+ id: zod.uuid().describe('Grant id.'),
+ lastUsedAt: zod.iso
+ .datetime({})
+ .nullish()
+ .describe('When the credential was last used, to the minute.'),
+ managedUserId: zod.string().describe('The account being managed.'),
+ managerUserId: zod
+ .string()
+ .describe('The agent account doing the managing.'),
+ requestedBy: zod
+ .enum(['managed', 'manager'])
+ .describe('One side of a grant.'),
+ status: zod
+ .enum([
+ 'pending',
+ 'approved',
+ 'declined',
+ 'active',
+ 'revoked',
+ 'expired',
+ ])
+ .describe('Where a grant is in its lifecycle.'),
+ })
+ .describe('A request for manager access and what became of it.'),
+ token: zod.string().describe('The secret. Shown only once.'),
+ })
+ .describe('The credential, returned only by the claim that issued it.');
+
/**
* @summary Handler for `GET /agents`.
*/
diff --git a/apps/web/src/lib/service-clients/service-storage/openapi.json b/apps/web/src/lib/service-clients/service-storage/openapi.json
index 1d1c2d9822..2d4972c597 100644
--- a/apps/web/src/lib/service-clients/service-storage/openapi.json
+++ b/apps/web/src/lib/service-clients/service-storage/openapi.json
@@ -10,6 +10,444 @@
"version": "0.1.0"
},
"paths": {
+ "/account-managers": {
+ "get": {
+ "tags": ["account-managers"],
+ "summary": "List the managers of the caller's account.",
+ "operationId": "list_account_managers",
+ "responses": {
+ "200": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/AccountManagersList"
+ }
+ }
+ }
+ },
+ "401": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "403": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "500": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ }
+ }
+ },
+ "post": {
+ "tags": ["account-managers"],
+ "summary": "Ask another account for manager access, in your DM with them.",
+ "operationId": "request_account_manager",
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/RequestAccountManagerBody"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "200": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/AccountManagerGrant"
+ }
+ }
+ }
+ },
+ "400": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "401": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "403": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "500": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "/account-managers/{id}": {
+ "get": {
+ "tags": ["account-managers"],
+ "summary": "Read a grant the caller is part of.",
+ "operationId": "get_account_manager_grant",
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "description": "Grant id.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "format": "uuid"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/AccountManagerGrant"
+ }
+ }
+ }
+ },
+ "401": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "403": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "404": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "500": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ }
+ }
+ },
+ "delete": {
+ "tags": ["account-managers"],
+ "summary": "End a grant. Either side may withdraw it.",
+ "operationId": "revoke_account_manager_grant",
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "description": "Grant id.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "format": "uuid"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/AccountManagerGrant"
+ }
+ }
+ }
+ },
+ "401": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "403": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "404": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "409": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "500": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "/account-managers/{id}/response": {
+ "post": {
+ "tags": ["account-managers"],
+ "summary": "Approve or decline a request the caller didn't make.",
+ "operationId": "respond_to_account_manager_request",
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "description": "Grant id.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "format": "uuid"
+ }
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/RespondToAccountManagerRequestBody"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "200": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/AccountManagerGrant"
+ }
+ }
+ }
+ },
+ "401": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "403": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "404": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "409": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "500": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "/account-managers/{id}/token": {
+ "post": {
+ "tags": ["account-managers"],
+ "summary": "Issue the credential to the manager. Works once. A POST, so link previews\nand crawlers can't use it up.",
+ "operationId": "claim_account_manager_token",
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "description": "Grant id.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "format": "uuid"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ClaimedAccountManagerToken"
+ }
+ }
+ }
+ },
+ "401": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "403": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "404": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "409": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "500": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
"/agents": {
"get": {
"tags": ["agents"],
@@ -21699,6 +22137,97 @@
],
"description": "Metadata together with the caller's effective grant."
},
+ "AccountManagerDecision": {
+ "type": "string",
+ "description": "A response to a request.",
+ "enum": ["approve", "decline"]
+ },
+ "AccountManagerGrant": {
+ "type": "object",
+ "description": "A request for manager access and what became of it.",
+ "required": [
+ "id",
+ "managedUserId",
+ "managerUserId",
+ "requestedBy",
+ "status",
+ "createdAt"
+ ],
+ "properties": {
+ "claimedAt": {
+ "type": ["string", "null"],
+ "format": "date-time",
+ "description": "When the manager claimed the credential."
+ },
+ "createdAt": {
+ "type": "string",
+ "format": "date-time",
+ "description": "When the request was made."
+ },
+ "expiresAt": {
+ "type": ["string", "null"],
+ "format": "date-time",
+ "description": "When the pending request or unclaimed approval stops being usable."
+ },
+ "id": {
+ "type": "string",
+ "format": "uuid",
+ "description": "Grant id."
+ },
+ "lastUsedAt": {
+ "type": ["string", "null"],
+ "format": "date-time",
+ "description": "When the credential was last used, to the minute."
+ },
+ "managedUserId": {
+ "type": "string",
+ "description": "The account being managed."
+ },
+ "managerUserId": {
+ "type": "string",
+ "description": "The agent account doing the managing."
+ },
+ "requestedBy": {
+ "$ref": "#/components/schemas/AccountManagerRole",
+ "description": "The side that asked."
+ },
+ "status": {
+ "$ref": "#/components/schemas/AccountManagerGrantStatus",
+ "description": "Lifecycle status."
+ }
+ }
+ },
+ "AccountManagerGrantStatus": {
+ "type": "string",
+ "description": "Where a grant is in its lifecycle.",
+ "enum": [
+ "pending",
+ "approved",
+ "declined",
+ "active",
+ "revoked",
+ "expired"
+ ]
+ },
+ "AccountManagerRole": {
+ "type": "string",
+ "description": "One side of a grant.",
+ "enum": ["managed", "manager"]
+ },
+ "AccountManagersList": {
+ "type": "object",
+ "description": "The managers of the caller's account.",
+ "required": ["grants"],
+ "properties": {
+ "grants": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/AccountManagerGrant"
+ },
+ "description": "Approved and active grants on the caller's account."
+ }
+ }
+ },
"ActiveCallSummary": {
"type": "object",
"description": "A currently active call, as returned by the batch active-calls listing.",
@@ -26424,6 +26953,21 @@
}
}
},
+ "ClaimedAccountManagerToken": {
+ "type": "object",
+ "description": "The credential, returned only by the claim that issued it.",
+ "required": ["grant", "token"],
+ "properties": {
+ "grant": {
+ "$ref": "#/components/schemas/AccountManagerGrant",
+ "description": "The grant, now active."
+ },
+ "token": {
+ "type": "string",
+ "description": "The secret. Shown only once."
+ }
+ }
+ },
"ClaimedPairing": {
"type": "object",
"description": "The credential released to the daemon when a pairing is claimed.",
@@ -41091,6 +41635,21 @@
}
}
},
+ "RequestAccountManagerBody": {
+ "type": "object",
+ "description": "Request body for asking for a grant.",
+ "required": ["counterpartyId", "callerRole"],
+ "properties": {
+ "callerRole": {
+ "$ref": "#/components/schemas/AccountManagerRole",
+ "description": "The side the caller takes."
+ },
+ "counterpartyId": {
+ "type": "string",
+ "description": "The other account (`macro|...`)."
+ }
+ }
+ },
"RequestStatus": {
"type": "string",
"description": "Durable outcome; reading a notification never changes it.",
@@ -41238,6 +41797,17 @@
}
}
},
+ "RespondToAccountManagerRequestBody": {
+ "type": "object",
+ "description": "Request body for responding to a request.",
+ "required": ["decision"],
+ "properties": {
+ "decision": {
+ "$ref": "#/components/schemas/AccountManagerDecision",
+ "description": "The response."
+ }
+ }
+ },
"ResponseStatus": {
"type": "string",
"description": "Whether a ledger entry is a saved response or a stop at a gate.",
diff --git a/apps/web/src/routes/app-router-view.tsx b/apps/web/src/routes/app-router-view.tsx
index 6498873827..66f496cf09 100644
--- a/apps/web/src/routes/app-router-view.tsx
+++ b/apps/web/src/routes/app-router-view.tsx
@@ -85,6 +85,7 @@ import {
WelcomePage,
} from './pages';
import {
+ accountManagerRoute,
activityRoute,
agentChatsRoute,
agentSetupDoneRoute,
@@ -182,6 +183,10 @@ import {
withMeetingShell,
} from './shells';
+const AccountManagerPage = lazyNamed(
+ () => import('@app/features/account-manager/account-manager-page'),
+ 'AccountManagerPage'
+);
const AgentSetupPage = lazyNamed(
() => import('@app/features/agent-setup/agent-setup-page'),
'AgentSetupPage'
@@ -273,6 +278,10 @@ export function AppRouterView() {
<Route definition={taskSlugRoute} component={TaskSlugPage} />
<Route definition={signupRoute} component={SignupPage} />
<Route definition={agentSignupRoute} component={AgentSignup} />
+ <Route
+ definition={accountManagerRoute}
+ component={AccountManagerPage}
+ />
<Route definition={agentSetupRoute} component={AgentSetupPage} />
<Route
definition={agentSetupDoneRoute}
diff --git a/apps/web/src/routes/routes.ts b/apps/web/src/routes/routes.ts
index 0f1cdc2c64..c6734165b0 100644
--- a/apps/web/src/routes/routes.ts
+++ b/apps/web/src/routes/routes.ts
@@ -135,6 +135,14 @@ export const agentSetupDoneRoute = defineRoute({
externalSearch: '*',
});
+/** The one-time link in an account manager approval message. */
+export const accountManagerRoute = defineRoute({
+ id: 'account-manager',
+ path: 'account-manager/:grantId',
+ params: z.object({ grantId: z.string().uuid() }),
+ externalSearch: '*',
+});
+
export const emailSignupCallbackRoute = defineRoute({
id: 'email-signup-callback',
path: EMAIL_SIGNUP_CALLBACK_PATH,
diff --git a/crates/account_manager/AGENTS.md b/crates/account_manager/AGENTS.md
new file mode 100644
index 0000000000..d49b8125e2
--- /dev/null
+++ b/crates/account_manager/AGENTS.md
@@ -0,0 +1,56 @@
+# account_manager
+
+## What it is
+
+Part of account security: lets an agent account (`User."isAgent"`) manage a person's
+account. Either side asks in their DM, the other side approves, and the agent
+claims a credential once. The managed account revokes it from settings.
+
+## Start here
+
+- `src/domain/service.rs`: the rules: who may ask, respond, claim, and revoke.
+- `src/domain/models.rs`: the grant and its statuses.
+- `src/outbound/pg_account_manager_repo.rs`: `account_manager_grants`; status
+ changes are single conditional writes, so races resolve in the database.
+- `src/outbound/dm_delivery.rs`: posts the request card and the claim link.
+- `src/inbound/axum_router.rs`: HTTP routes, mounted by `document_storage_service`.
+
+## Scope
+
+- Owns: the `account_manager_grants` table's lifecycle.
+- Not here: authenticating with a manager credential → `macro_authorization`
+ (`CredentialOrigin::AccountManager`, `AccountHolderOrInternal`). Rendering the
+ card → `apps/web/src/features/account-manager`.
+
+## Boundaries
+
+- Depends on: `channels`, `messages`, `entity_access`, `macro_authorization`,
+ `user_api_key` (credential format and hashing).
+- Used by: `services/document_storage_service`.
+
+## Checks
+
+- `cargo test -p account_manager --all-features` (`SQLX_OFFLINE` unset).
+
+## Gotchas
+
+- The manager is always an agent and the managed account is always a person, so
+ there are no chains. An agent acts on what it reads, so a message could talk it
+ into approving a request and giving up its account. Whichever side didn't ask
+ responds; a manager may accept with its own API key.
+- A credential is a normal `mak_` key to the SDK, but it lives here, not in
+ `"UserApiKey"`, so it never appears in the API Keys tab or counts toward its
+ limit. Only its hash is stored.
+- Every route here refuses a manager credential, and so does each route using
+ `AccountHolderOrInternal`: API keys, API token exchange, bot tokens, harness
+ pairing approval, account links and merges, and account deletion. A new route
+ that mints a credential that outlives its request, changes who can sign in, or
+ deletes the account must use that policy too.
+- The card only carries the grant id, because anyone can type message markup. It
+ reads everything it shows from the server, which answers only the two accounts.
+- Revocation stops the credential immediately. It doesn't undo what the manager
+ already created, such as routines or webhooks.
+
+## Related
+
+- Rules: `.agents/rules/rust/security.md`
diff --git a/crates/account_manager/CLAUDE.md b/crates/account_manager/CLAUDE.md
new file mode 120000
index 0000000000..47dc3e3d86
--- /dev/null
+++ b/crates/account_manager/CLAUDE.md
@@ -0,0 +1 @@
+AGENTS.md
\ No newline at end of file
diff --git a/crates/account_manager/Cargo.toml b/crates/account_manager/Cargo.toml
new file mode 100644
index 0000000000..dc952f2f4c
--- /dev/null
+++ b/crates/account_manager/Cargo.toml
@@ -0,0 +1,46 @@
+[package]
+edition = "2024"
+name = "account_manager"
+publish = false
+version = "0.1.0"
+
+[features]
+default = []
+inbound = [
+ "dep:axum",
+ "dep:macro_authorization",
+ "dep:model-error-response",
+ "dep:utoipa",
+]
+outbound = [
+ "dep:channels",
+ "dep:entity_access",
+ "dep:macro_service_urls",
+ "dep:messages",
+]
+postgres = ["dep:sqlx"]
+
+[dependencies]
+axum = { workspace = true, optional = true }
+channels = { path = "../channels", optional = true, default-features = false, features = ["ports"] }
+chrono = { workspace = true, features = ["serde"] }
+entity_access = { path = "../entity_access", optional = true, default-features = false, features = ["ports"] }
+macro_authorization = { path = "../macro_authorization", optional = true, default-features = false, features = ["axum"] }
+macro_service_urls = { path = "../macro_service_urls", optional = true }
+macro_user_id = { path = "../macro_user_id" }
+messages = { path = "../messages", optional = true, default-features = false, features = ["ports"] }
+model-error-response = { path = "../model-error-response", optional = true }
+rootcause = { workspace = true }
+serde = { workspace = true }
+sqlx = { workspace = true, optional = true }
+strum = { workspace = true }
+thiserror = { workspace = true }
+tracing = { workspace = true }
+user_api_key = { path = "../user_api_key" }
+utoipa = { workspace = true, optional = true }
+uuid = { workspace = true, features = ["serde", "v7"] }
+workspace-hack = { version = "0.1", path = "../workspace-hack" }
+
+[dev-dependencies]
+macro_db_migrator = { path = "../macro_db_migrator" }
+tokio = { workspace = true, features = ["macros", "rt-multi-thread"] }
diff --git a/crates/account_manager/src/domain.rs b/crates/account_manager/src/domain.rs
new file mode 100644
index 0000000000..40c996a03e
--- /dev/null
+++ b/crates/account_manager/src/domain.rs
@@ -0,0 +1,5 @@
+//! Domain layer for account managers.
+
+pub mod models;
+pub mod ports;
+pub mod service;
diff --git a/crates/account_manager/src/domain/models.rs b/crates/account_manager/src/domain/models.rs
new file mode 100644
index 0000000000..447ace4725
--- /dev/null
+++ b/crates/account_manager/src/domain/models.rs
@@ -0,0 +1,154 @@
+//! Domain models for account managers.
+
+use std::time::Duration;
+
+use chrono::{DateTime, Utc};
+use macro_user_id::user_id::MacroUserIdStr;
+use serde::{Deserialize, Serialize};
+use uuid::Uuid;
+
+/// How long a request can wait for a response, and an approval for its claim.
+pub const RESPONSE_WINDOW: Duration = Duration::from_secs(7 * 24 * 60 * 60);
+
+/// Message tag that renders a grant's card. Mirrors `ACCOUNT_MANAGER_REQUEST_TAG`
+/// in `packages/lexical-core`.
+pub const CARD_TAG: &str = "m-account-manager-request";
+
+/// One side of a grant.
+#[derive(
+ Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize, strum::Display, strum::EnumString,
+)]
+#[cfg_attr(feature = "inbound", derive(utoipa::ToSchema))]
+#[serde(rename_all = "camelCase")]
+#[strum(serialize_all = "camelCase")]
+pub enum AccountManagerRole {
+ /// The person whose account is being managed.
+ Managed,
+ /// The agent account doing the managing.
+ Manager,
+}
+
+/// Where a grant is in its lifecycle.
+#[derive(
+ Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize, strum::Display, strum::EnumString,
+)]
+#[cfg_attr(feature = "inbound", derive(utoipa::ToSchema))]
+#[serde(rename_all = "camelCase")]
+#[strum(serialize_all = "camelCase")]
+pub enum AccountManagerGrantStatus {
+ /// Waiting for the side that didn't ask.
+ Pending,
+ /// Approved, with the credential not yet claimed.
+ Approved,
+ /// The side that didn't ask said no.
+ Declined,
+ /// The credential is claimed and works.
+ Active,
+ /// Withdrawn, or the credential no longer works.
+ Revoked,
+ /// Nobody responded or claimed in time.
+ Expired,
+}
+
+/// A request for manager access and what became of it.
+#[derive(Debug, Clone, Serialize, Deserialize)]
+#[cfg_attr(feature = "inbound", derive(utoipa::ToSchema))]
+#[serde(rename_all = "camelCase")]
+pub struct AccountManagerGrant {
+ /// Grant id.
+ pub id: Uuid,
+ /// The account being managed.
+ #[cfg_attr(feature = "inbound", schema(value_type = String))]
+ pub managed_user_id: MacroUserIdStr<'static>,
+ /// The agent account doing the managing.
+ #[cfg_attr(feature = "inbound", schema(value_type = String))]
+ pub manager_user_id: MacroUserIdStr<'static>,
+ /// The side that asked.
+ pub requested_by: AccountManagerRole,
+ /// Lifecycle status.
+ pub status: AccountManagerGrantStatus,
+ /// When the pending request or unclaimed approval stops being usable.
+ pub expires_at: Option<DateTime<Utc>>,
+ /// When the request was made.
+ pub created_at: DateTime<Utc>,
+ /// When the manager claimed the credential.
+ pub claimed_at: Option<DateTime<Utc>>,
+ /// When the credential was last used, to the minute.
+ pub last_used_at: Option<DateTime<Utc>>,
+}
+
+impl AccountManagerGrant {
+ /// The side `user` is on, or `None` when they aren't part of this grant.
+ pub fn role_of(&self, user: &MacroUserIdStr<'_>) -> Option<AccountManagerRole> {
+ if user.as_ref() == self.managed_user_id.as_ref() {
+ return Some(AccountManagerRole::Managed);
+ }
+
+ if user.as_ref() == self.manager_user_id.as_ref() {
+ return Some(AccountManagerRole::Manager);
+ }
+
+ None
+ }
+
+ /// The account that may respond: whichever side didn't ask.
+ pub fn responder(&self) -> &MacroUserIdStr<'static> {
+ match self.requested_by {
+ AccountManagerRole::Managed => &self.manager_user_id,
+ AccountManagerRole::Manager => &self.managed_user_id,
+ }
+ }
+
+ /// Show a lapsed request or approval as expired, before anything has
+ /// written that down.
+ pub fn at(mut self, now: DateTime<Utc>) -> Self {
+ let lapsed = self.expires_at.is_some_and(|expires_at| expires_at <= now);
+ let open = matches!(
+ self.status,
+ AccountManagerGrantStatus::Pending | AccountManagerGrantStatus::Approved
+ );
+
+ if lapsed && open {
+ self.status = AccountManagerGrantStatus::Expired;
+ }
+
+ self
+ }
+}
+
+/// A response to a request.
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
+#[cfg_attr(feature = "inbound", derive(utoipa::ToSchema))]
+#[serde(rename_all = "camelCase")]
+pub enum AccountManagerDecision {
+ /// Grant access.
+ Approve,
+ /// Refuse access.
+ Decline,
+}
+
+/// Errors returned by the account manager service.
+#[derive(Debug, thiserror::Error)]
+pub enum AccountManagerError {
+ /// The grant doesn't exist, or the caller isn't part of it.
+ #[error("account manager grant not found")]
+ NotFound,
+ /// The caller is part of the grant but it isn't theirs to do this to.
+ #[error("{0}")]
+ Forbidden(&'static str),
+ /// The grant has moved on, for example it expired or was already claimed.
+ #[error("{0}")]
+ Conflict(&'static str),
+ /// The request was invalid.
+ #[error("{0}")]
+ BadRequest(&'static str),
+ /// Any other internal error.
+ #[error("internal account manager error: {0:?}")]
+ Internal(rootcause::Report),
+}
+
+impl From<rootcause::Report> for AccountManagerError {
+ fn from(report: rootcause::Report) -> Self {
+ AccountManagerError::Internal(report)
+ }
+}
diff --git a/crates/account_manager/src/domain/ports.rs b/crates/account_manager/src/domain/ports.rs
new file mode 100644
index 0000000000..e816980566
--- /dev/null
+++ b/crates/account_manager/src/domain/ports.rs
@@ -0,0 +1,152 @@
+//! Ports (trait contracts) for the account manager domain.
+
+use chrono::{DateTime, Utc};
+use macro_user_id::user_id::MacroUserIdStr;
+use user_api_key::domain::models::UserApiKey;
+use uuid::Uuid;
+
+use crate::domain::models::{
+ AccountManagerDecision, AccountManagerError, AccountManagerGrant, AccountManagerRole,
+};
+
+/// Outbound persistence port for grants. Every status change is one conditional
+/// write, returning `None` when the grant isn't in the required state.
+pub trait AccountManagerRepo: Send + Sync + 'static {
+ /// The error type returned by repository operations.
+ type Err: std::error::Error + Send + Sync + 'static;
+
+ /// Whether the user is an agent account. `None` when there is no such user.
+ fn is_agent(
+ &self,
+ user: &MacroUserIdStr<'_>,
+ ) -> impl Future<Output = Result<Option<bool>, Self::Err>> + Send;
+
+ /// Open a request, or return the pair's request that is already pending.
+ fn open_request(
+ &self,
+ id: Uuid,
+ managed: &MacroUserIdStr<'_>,
+ manager: &MacroUserIdStr<'_>,
+ requested_by: AccountManagerRole,
+ expires_at: DateTime<Utc>,
+ ) -> impl Future<Output = Result<OpenedRequest, Self::Err>> + Send;
+
+ /// Load one grant.
+ fn get(
+ &self,
+ id: Uuid,
+ ) -> impl Future<Output = Result<Option<AccountManagerGrant>, Self::Err>> + Send;
+
+ /// List the grants on an account that are approved or active.
+ fn list_for_managed(
+ &self,
+ managed: &MacroUserIdStr<'_>,
+ ) -> impl Future<Output = Result<Vec<AccountManagerGrant>, Self::Err>> + Send;
+
+ /// Resolve an unexpired pending request.
+ fn respond(
+ &self,
+ id: Uuid,
+ decision: AccountManagerDecision,
+ claim_expires_at: DateTime<Utc>,
+ now: DateTime<Utc>,
+ ) -> impl Future<Output = Result<Option<AccountManagerGrant>, Self::Err>> + Send;
+
+ /// Activate an unclaimed, unexpired approval with this credential hash,
+ /// revoking any earlier active grant for the same pair.
+ fn claim(
+ &self,
+ id: Uuid,
+ key_hash: &[u8; 32],
+ now: DateTime<Utc>,
+ ) -> impl Future<Output = Result<Option<AccountManagerGrant>, Self::Err>> + Send;
+
+ /// End a pending, approved, or active grant, invalidating its credential.
+ fn revoke(
+ &self,
+ id: Uuid,
+ ) -> impl Future<Output = Result<Option<AccountManagerGrant>, Self::Err>> + Send;
+}
+
+/// The result of opening a request.
+#[derive(Debug, Clone)]
+pub struct OpenedRequest {
+ /// The pending request.
+ pub grant: AccountManagerGrant,
+ /// `false` when the pair already had this request pending.
+ pub created: bool,
+}
+
+/// Outbound port that tells the other side, in the pair's DM.
+pub trait AccountManagerDelivery: Send + Sync + 'static {
+ /// Post the request card as `sender`.
+ fn deliver_request(
+ &self,
+ sender: &MacroUserIdStr<'static>,
+ recipient: &MacroUserIdStr<'static>,
+ grant_id: Uuid,
+ ) -> impl Future<Output = Result<(), rootcause::Report>> + Send;
+
+ /// Post the one-time link as `sender`, the side that approved.
+ fn deliver_approval(
+ &self,
+ sender: &MacroUserIdStr<'static>,
+ recipient: &MacroUserIdStr<'static>,
+ grant_id: Uuid,
+ ) -> impl Future<Output = Result<(), rootcause::Report>> + Send;
+}
+
+/// A credential freshly claimed, shown only this once.
+#[derive(Debug, Clone)]
+pub struct ClaimedCredential {
+ /// The grant, now active.
+ pub grant: AccountManagerGrant,
+ /// The secret. Its `Debug` output is redacted.
+ pub key: UserApiKey,
+}
+
+/// Inbound service port: the account manager API used by drivers (HTTP).
+pub trait AccountManagerService: Send + Sync + 'static {
+ /// Ask `counterparty` for a grant in which the caller takes `caller_role`.
+ fn request(
+ &self,
+ caller: &MacroUserIdStr<'static>,
+ counterparty: &MacroUserIdStr<'static>,
+ caller_role: AccountManagerRole,
+ ) -> impl Future<Output = Result<AccountManagerGrant, AccountManagerError>> + Send;
+
+ /// Read a grant the caller is part of.
+ fn get(
+ &self,
+ caller: &MacroUserIdStr<'static>,
+ id: Uuid,
+ ) -> impl Future<Output = Result<AccountManagerGrant, AccountManagerError>> + Send;
+
+ /// List the managers of the caller's account.
+ fn list_managers(
+ &self,
+ caller: &MacroUserIdStr<'static>,
+ ) -> impl Future<Output = Result<Vec<AccountManagerGrant>, AccountManagerError>> + Send;
+
+ /// Approve or decline a request the caller didn't make.
+ fn respond(
+ &self,
+ caller: &MacroUserIdStr<'static>,
+ id: Uuid,
+ decision: AccountManagerDecision,
+ ) -> impl Future<Output = Result<AccountManagerGrant, AccountManagerError>> + Send;
+
+ /// Issue the credential to the manager. Works once.
+ fn claim(
+ &self,
+ caller: &MacroUserIdStr<'static>,
+ id: Uuid,
+ ) -> impl Future<Output = Result<ClaimedCredential, AccountManagerError>> + Send;
+
+ /// End a grant: either side may withdraw it at any point.
+ fn revoke(
+ &self,
+ caller: &MacroUserIdStr<'static>,
+ id: Uuid,
+ ) -> impl Future<Output = Result<AccountManagerGrant, AccountManagerError>> + Send;
+}
diff --git a/crates/account_manager/src/domain/service.rs b/crates/account_manager/src/domain/service.rs
new file mode 100644
index 0000000000..cda8c9f569
--- /dev/null
+++ b/crates/account_manager/src/domain/service.rs
@@ -0,0 +1,231 @@
+//! Account manager service implementation.
+
+#[cfg(test)]
+mod test;
+
+use chrono::Utc;
+use macro_user_id::user_id::MacroUserIdStr;
+use user_api_key::domain::models::UserApiKey;
+use uuid::Uuid;
+
+use crate::domain::models::{
+ AccountManagerDecision, AccountManagerError, AccountManagerGrant, AccountManagerGrantStatus,
+ AccountManagerRole, RESPONSE_WINDOW,
+};
+use crate::domain::ports::{
+ AccountManagerDelivery, AccountManagerRepo, AccountManagerService, ClaimedCredential,
+};
+
+fn internal(error: impl std::error::Error + Send + Sync + 'static) -> AccountManagerError {
+ rootcause::Report::new(error).into_dynamic().into()
+}
+
+/// Concrete account manager service.
+#[derive(Debug, Clone)]
+pub struct AccountManagerServiceImpl<R, D> {
+ repo: R,
+ delivery: D,
+}
+
+impl<R, D> AccountManagerServiceImpl<R, D>
+where
+ R: AccountManagerRepo,
+ D: AccountManagerDelivery,
+{
+ /// Create the service from its repository and DM delivery.
+ pub fn new(repo: R, delivery: D) -> Self {
+ Self { repo, delivery }
+ }
+
+ /// Load a grant the caller is part of. A stranger gets the same answer as
+ /// for a grant that doesn't exist.
+ async fn load(
+ &self,
+ caller: &MacroUserIdStr<'_>,
+ id: Uuid,
+ ) -> Result<(AccountManagerGrant, AccountManagerRole), AccountManagerError> {
+ let grant = self
+ .repo
+ .get(id)
+ .await
+ .map_err(internal)?
+ .ok_or(AccountManagerError::NotFound)?;
+ let role = grant.role_of(caller).ok_or(AccountManagerError::NotFound)?;
+
+ Ok((grant.at(Utc::now()), role))
+ }
+}
+
+impl<R, D> AccountManagerService for AccountManagerServiceImpl<R, D>
+where
+ R: AccountManagerRepo,
+ D: AccountManagerDelivery,
+{
+ #[tracing::instrument(err, skip_all, fields(role = %caller_role, grant_id = tracing::field::Empty))]
+ async fn request(
+ &self,
+ caller: &MacroUserIdStr<'static>,
+ counterparty: &MacroUserIdStr<'static>,
+ caller_role: AccountManagerRole,
+ ) -> Result<AccountManagerGrant, AccountManagerError> {
+ if caller.as_ref() == counterparty.as_ref() {
+ return Err(AccountManagerError::BadRequest(
+ "an account cannot manage itself",
+ ));
+ }
+
+ let (managed, manager) = match caller_role {
+ AccountManagerRole::Managed => (caller, counterparty),
+ AccountManagerRole::Manager => (counterparty, caller),
+ };
+
+ let manager_is_agent = self.repo.is_agent(manager).await.map_err(internal)?;
+ let managed_is_agent = self.repo.is_agent(managed).await.map_err(internal)?;
+ if manager_is_agent.is_none() || managed_is_agent.is_none() {
+ return Err(AccountManagerError::BadRequest("no such user"));
+ }
+ if manager_is_agent != Some(true) {
+ return Err(AccountManagerError::BadRequest(
+ "only an agent account can be an account manager",
+ ));
+ }
+
+ // An agent acts on what it reads, so a message could talk it into
+ // approving a request and giving up its whole account.
+ if managed_is_agent == Some(true) {
+ return Err(AccountManagerError::BadRequest(
+ "an agent account cannot be managed",
+ ));
+ }
+
+ let now = Utc::now();
+ let expires_at = now + RESPONSE_WINDOW;
+ let opened = self
+ .repo
+ .open_request(Uuid::now_v7(), managed, manager, caller_role, expires_at)
+ .await
+ .map_err(internal)?;
+ tracing::Span::current().record("grant_id", tracing::field::display(opened.grant.id));
+
+ if !opened.created {
+ return Ok(opened.grant);
+ }
+
+ // A request the other side never hears about must not block a retry.
+ if let Err(error) = self
+ .delivery
+ .deliver_request(caller, counterparty, opened.grant.id)
+ .await
+ {
+ self.repo.revoke(opened.grant.id).await.map_err(internal)?;
+ return Err(error.into());
+ }
+
+ Ok(opened.grant)
+ }
+
+ #[tracing::instrument(err, skip(self, caller))]
+ async fn get(
+ &self,
+ caller: &MacroUserIdStr<'static>,
+ id: Uuid,
+ ) -> Result<AccountManagerGrant, AccountManagerError> {
+ let (grant, _) = self.load(caller, id).await?;
+ Ok(grant)
+ }
+
+ #[tracing::instrument(err, skip_all)]
+ async fn list_managers(
+ &self,
+ caller: &MacroUserIdStr<'static>,
+ ) -> Result<Vec<AccountManagerGrant>, AccountManagerError> {
+ let grants = self.repo.list_for_managed(caller).await.map_err(internal)?;
+ let now = Utc::now();
+ Ok(grants
+ .into_iter()
+ .map(|grant| grant.at(now))
+ .filter(|grant| grant.status != AccountManagerGrantStatus::Expired)
+ .collect())
+ }
+
+ #[tracing::instrument(err, skip(self, caller))]
+ async fn respond(
+ &self,
+ caller: &MacroUserIdStr<'static>,
+ id: Uuid,
+ decision: AccountManagerDecision,
+ ) -> Result<AccountManagerGrant, AccountManagerError> {
+ let (grant, _) = self.load(caller, id).await?;
+ if grant.responder().as_ref() != caller.as_ref() {
+ return Err(AccountManagerError::Forbidden(
+ "only the side that didn't ask can respond",
+ ));
+ }
+
+ let now = Utc::now();
+ let responded = self
+ .repo
+ .respond(id, decision, now + RESPONSE_WINDOW, now)
+ .await
+ .map_err(internal)?
+ .ok_or(AccountManagerError::Conflict(
+ "this request is no longer open",
+ ))?;
+
+ if decision == AccountManagerDecision::Approve {
+ let recipient = match grant.role_of(caller) {
+ Some(AccountManagerRole::Managed) => &responded.manager_user_id,
+ _ => &responded.managed_user_id,
+ };
+ // The approval stands without the message: the card already shows
+ // it, and the manager can still claim from there.
+ if let Err(error) = self.delivery.deliver_approval(caller, recipient, id).await {
+ tracing::warn!(error = ?error, grant_id = %id, "could not post the approval");
+ }
+ }
+
+ Ok(responded)
+ }
+
+ #[tracing::instrument(err, skip(self, caller))]
+ async fn claim(
+ &self,
+ caller: &MacroUserIdStr<'static>,
+ id: Uuid,
+ ) -> Result<ClaimedCredential, AccountManagerError> {
+ let (_, role) = self.load(caller, id).await?;
+ if role != AccountManagerRole::Manager {
+ return Err(AccountManagerError::Forbidden(
+ "only the manager can claim this token",
+ ));
+ }
+
+ let key = UserApiKey::generate();
+ let grant = self
+ .repo
+ .claim(id, &key.hash(), Utc::now())
+ .await
+ .map_err(internal)?
+ .ok_or(AccountManagerError::Conflict(
+ "this token link has already been used or expired",
+ ))?;
+
+ Ok(ClaimedCredential { grant, key })
+ }
+
+ #[tracing::instrument(err, skip(self, caller))]
+ async fn revoke(
+ &self,
+ caller: &MacroUserIdStr<'static>,
+ id: Uuid,
+ ) -> Result<AccountManagerGrant, AccountManagerError> {
+ self.load(caller, id).await?;
+ self.repo
+ .revoke(id)
+ .await
+ .map_err(internal)?
+ .ok_or(AccountManagerError::Conflict(
+ "this access has already ended",
+ ))
+ }
+}
diff --git a/crates/account_manager/src/domain/service/test.rs b/crates/account_manager/src/domain/service/test.rs
new file mode 100644
index 0000000000..796598ab9f
--- /dev/null
+++ b/crates/account_manager/src/domain/service/test.rs
@@ -0,0 +1,459 @@
+use std::sync::{Arc, Mutex};
+
+use chrono::{DateTime, Duration, Utc};
+use macro_user_id::{cowlike::CowLike, user_id::MacroUserIdStr};
+use uuid::Uuid;
+
+use super::*;
+use crate::domain::ports::OpenedRequest;
+
+fn user(id: &'static str) -> MacroUserIdStr<'static> {
+ MacroUserIdStr::parse_from_str(id).unwrap()
+}
+
+#[derive(Debug, thiserror::Error)]
+#[error("fake repository error")]
+struct FakeError;
+
+/// Keeps grants in memory with the same state rules as the SQL.
+#[derive(Clone, Default)]
+struct FakeRepo {
+ grants: Arc<Mutex<Vec<AccountManagerGrant>>>,
+}
+
+impl FakeRepo {
+ fn expire(&self, id: Uuid) {
+ let mut grants = self.grants.lock().unwrap();
+ let grant = grants.iter_mut().find(|grant| grant.id == id).unwrap();
+ grant.expires_at = Some(Utc::now() - Duration::minutes(1));
+ }
+}
+
+impl AccountManagerRepo for FakeRepo {
+ type Err = FakeError;
+
+ async fn is_agent(&self, user: &MacroUserIdStr<'_>) -> Result<Option<bool>, FakeError> {
+ Ok(match user.as_ref() {
+ "macro|[email protected]" | "macro|[email protected]" => Some(true),
+ "macro|[email protected]" | "macro|[email protected]" => Some(false),
+ _ => None,
+ })
+ }
+
+ async fn open_request(
+ &self,
+ id: Uuid,
+ managed: &MacroUserIdStr<'_>,
+ manager: &MacroUserIdStr<'_>,
+ requested_by: AccountManagerRole,
+ expires_at: DateTime<Utc>,
+ ) -> Result<OpenedRequest, FakeError> {
+ let mut grants = self.grants.lock().unwrap();
+ let pending = grants.iter().find(|grant| {
+ grant.status == AccountManagerGrantStatus::Pending
+ && grant.managed_user_id.as_ref() == managed.as_ref()
+ && grant.manager_user_id.as_ref() == manager.as_ref()
+ });
+ if let Some(grant) = pending {
+ return Ok(OpenedRequest {
+ grant: grant.clone(),
+ created: false,
+ });
+ }
+
+ let grant = AccountManagerGrant {
+ id,
+ managed_user_id: MacroUserIdStr::parse_from_str(managed.as_ref())
+ .unwrap()
+ .into_owned(),
+ manager_user_id: MacroUserIdStr::parse_from_str(manager.as_ref())
+ .unwrap()
+ .into_owned(),
+ requested_by,
+ status: AccountManagerGrantStatus::Pending,
+ expires_at: Some(expires_at),
+ created_at: Utc::now(),
+ claimed_at: None,
+ last_used_at: None,
+ };
+ grants.push(grant.clone());
+ Ok(OpenedRequest {
+ grant,
+ created: true,
+ })
+ }
+
+ async fn get(&self, id: Uuid) -> Result<Option<AccountManagerGrant>, FakeError> {
+ let grants = self.grants.lock().unwrap();
+ Ok(grants.iter().find(|grant| grant.id == id).cloned())
+ }
+
+ async fn list_for_managed(
+ &self,
+ managed: &MacroUserIdStr<'_>,
+ ) -> Result<Vec<AccountManagerGrant>, FakeError> {
+ let grants = self.grants.lock().unwrap();
+ Ok(grants
+ .iter()
+ .filter(|grant| grant.managed_user_id.as_ref() == managed.as_ref())
+ .filter(|grant| {
+ matches!(
+ grant.status,
+ AccountManagerGrantStatus::Approved | AccountManagerGrantStatus::Active
+ )
+ })
+ .cloned()
+ .collect())
+ }
+
+ async fn respond(
+ &self,
+ id: Uuid,
+ decision: AccountManagerDecision,
+ claim_expires_at: DateTime<Utc>,
+ now: DateTime<Utc>,
+ ) -> Result<Option<AccountManagerGrant>, FakeError> {
+ let mut grants = self.grants.lock().unwrap();
+ let Some(grant) = grants.iter_mut().find(|grant| {
+ grant.id == id
+ && grant.status == AccountManagerGrantStatus::Pending
+ && grant.expires_at.is_some_and(|expires_at| expires_at > now)
+ }) else {
+ return Ok(None);
+ };
+ match decision {
+ AccountManagerDecision::Approve => {
+ grant.status = AccountManagerGrantStatus::Approved;
+ grant.expires_at = Some(claim_expires_at);
+ }
+ AccountManagerDecision::Decline => {
+ grant.status = AccountManagerGrantStatus::Declined;
+ grant.expires_at = None;
+ }
+ }
+ Ok(Some(grant.clone()))
+ }
+
+ async fn claim(
+ &self,
+ id: Uuid,
+ _key_hash: &[u8; 32],
+ now: DateTime<Utc>,
+ ) -> Result<Option<AccountManagerGrant>, FakeError> {
+ let mut grants = self.grants.lock().unwrap();
+ let Some(grant) = grants.iter_mut().find(|grant| {
+ grant.id == id
+ && grant.status == AccountManagerGrantStatus::Approved
+ && grant.expires_at.is_some_and(|expires_at| expires_at > now)
+ }) else {
+ return Ok(None);
+ };
+ grant.status = AccountManagerGrantStatus::Active;
+ grant.expires_at = None;
+ grant.claimed_at = Some(now);
+ Ok(Some(grant.clone()))
+ }
+
+ async fn revoke(&self, id: Uuid) -> Result<Option<AccountManagerGrant>, FakeError> {
+ let mut grants = self.grants.lock().unwrap();
+ let Some(grant) = grants.iter_mut().find(|grant| {
+ grant.id == id
+ && matches!(
+ grant.status,
+ AccountManagerGrantStatus::Pending
+ | AccountManagerGrantStatus::Approved
+ | AccountManagerGrantStatus::Active
+ )
+ }) else {
+ return Ok(None);
+ };
+ grant.status = AccountManagerGrantStatus::Revoked;
+ grant.expires_at = None;
+ Ok(Some(grant.clone()))
+ }
+}
+
+#[derive(Clone, Default)]
+struct FakeDelivery {
+ fail: Arc<Mutex<bool>>,
+ posts: Arc<Mutex<Vec<(String, String, &'static str)>>>,
+}
+
+impl FakeDelivery {
+ fn record(
+ &self,
+ sender: &MacroUserIdStr<'_>,
+ recipient: &MacroUserIdStr<'_>,
+ kind: &'static str,
+ ) -> Result<(), rootcause::Report> {
+ if *self.fail.lock().unwrap() {
+ return Err(rootcause::report!("delivery failed"));
+ }
+ self.posts.lock().unwrap().push((
+ sender.as_ref().to_string(),
+ recipient.as_ref().to_string(),
+ kind,
+ ));
+ Ok(())
+ }
+}
+
+impl AccountManagerDelivery for FakeDelivery {
+ async fn deliver_request(
+ &self,
+ sender: &MacroUserIdStr<'static>,
+ recipient: &MacroUserIdStr<'static>,
+ _grant_id: Uuid,
+ ) -> Result<(), rootcause::Report> {
+ self.record(sender, recipient, "request")
+ }
+
+ async fn deliver_approval(
+ &self,
+ sender: &MacroUserIdStr<'static>,
+ recipient: &MacroUserIdStr<'static>,
+ _grant_id: Uuid,
+ ) -> Result<(), rootcause::Report> {
+ self.record(sender, recipient, "approval")
+ }
+}
+
+fn service() -> (
+ AccountManagerServiceImpl<FakeRepo, FakeDelivery>,
+ FakeRepo,
+ FakeDelivery,
+) {
+ let repo = FakeRepo::default();
+ let delivery = FakeDelivery::default();
+ (
+ AccountManagerServiceImpl::new(repo.clone(), delivery.clone()),
+ repo,
+ delivery,
+ )
+}
+
+const AGENT: &str = "macro|[email protected]";
+const AGENT_2: &str = "macro|[email protected]";
+const PERSON: &str = "macro|[email protected]";
+const PERSON_2: &str = "macro|[email protected]";
+
+#[tokio::test]
+async fn an_agent_can_ask_to_manage_a_person() {
+ let (service, _, delivery) = service();
+
+ let grant = service
+ .request(&user(AGENT), &user(PERSON), AccountManagerRole::Manager)
+ .await
+ .unwrap();
+
+ assert_eq!(grant.manager_user_id.as_ref(), AGENT);
+ assert_eq!(grant.managed_user_id.as_ref(), PERSON);
+ assert_eq!(grant.requested_by, AccountManagerRole::Manager);
+ assert_eq!(
+ delivery.posts.lock().unwrap().as_slice(),
+ [(AGENT.to_string(), PERSON.to_string(), "request")]
+ );
+}
+
+#[tokio::test]
+async fn a_person_can_ask_an_agent_to_manage_them() {
+ let (service, _, _) = service();
+
+ let grant = service
+ .request(&user(PERSON), &user(AGENT), AccountManagerRole::Managed)
+ .await
+ .unwrap();
+
+ assert_eq!(grant.manager_user_id.as_ref(), AGENT);
+ assert_eq!(grant.requested_by, AccountManagerRole::Managed);
+}
+
+#[tokio::test]
+async fn an_agent_can_never_be_managed() {
+ let (service, _, delivery) = service();
+
+ let offered = service
+ .request(&user(AGENT), &user(AGENT_2), AccountManagerRole::Manager)
+ .await;
+ let asked = service
+ .request(&user(AGENT), &user(AGENT_2), AccountManagerRole::Managed)
+ .await;
+
+ assert!(matches!(offered, Err(AccountManagerError::BadRequest(_))));
+ assert!(matches!(asked, Err(AccountManagerError::BadRequest(_))));
+ assert!(delivery.posts.lock().unwrap().is_empty());
+}
+
+#[tokio::test]
+async fn a_person_can_never_be_the_manager() {
+ let (service, _, delivery) = service();
+
+ let offered = service
+ .request(&user(PERSON), &user(PERSON_2), AccountManagerRole::Manager)
+ .await;
+ let asked = service
+ .request(&user(AGENT), &user(PERSON), AccountManagerRole::Managed)
+ .await;
+
+ assert!(matches!(offered, Err(AccountManagerError::BadRequest(_))));
+ assert!(matches!(asked, Err(AccountManagerError::BadRequest(_))));
+ assert!(delivery.posts.lock().unwrap().is_empty());
+}
+
+#[tokio::test]
+async fn asking_again_returns_the_pending_request_without_reposting() {
+ let (service, _, delivery) = service();
+
+ let first = service
+ .request(&user(AGENT), &user(PERSON), AccountManagerRole::Manager)
+ .await
+ .unwrap();
+ let second = service
+ .request(&user(AGENT), &user(PERSON), AccountManagerRole::Manager)
+ .await
+ .unwrap();
+
+ assert_eq!(first.id, second.id);
+ assert_eq!(delivery.posts.lock().unwrap().len(), 1);
+}
+
+#[tokio::test]
+async fn a_request_that_could_not_be_delivered_does_not_block_a_retry() {
+ let (service, _, delivery) = service();
+ *delivery.fail.lock().unwrap() = true;
+
+ let failed = service
+ .request(&user(AGENT), &user(PERSON), AccountManagerRole::Manager)
+ .await;
+ assert!(matches!(failed, Err(AccountManagerError::Internal(_))));
+
+ *delivery.fail.lock().unwrap() = false;
+ service
+ .request(&user(AGENT), &user(PERSON), AccountManagerRole::Manager)
+ .await
+ .unwrap();
+
+ assert_eq!(delivery.posts.lock().unwrap().len(), 1);
+}
+
+#[tokio::test]
+async fn only_the_side_that_did_not_ask_can_respond() {
+ let (service, _, _) = service();
+ let grant = service
+ .request(&user(AGENT), &user(PERSON), AccountManagerRole::Manager)
+ .await
+ .unwrap();
+
+ let by_requester = service
+ .respond(&user(AGENT), grant.id, AccountManagerDecision::Approve)
+ .await;
+ let by_stranger = service
+ .respond(&user(PERSON_2), grant.id, AccountManagerDecision::Approve)
+ .await;
+
+ assert!(matches!(
+ by_requester,
+ Err(AccountManagerError::Forbidden(_))
+ ));
+ assert!(matches!(by_stranger, Err(AccountManagerError::NotFound)));
+}
+
+#[tokio::test]
+async fn an_expired_request_cannot_be_approved_and_reads_as_expired() {
+ let (service, repo, _) = service();
+ let grant = service
+ .request(&user(AGENT), &user(PERSON), AccountManagerRole::Manager)
+ .await
+ .unwrap();
+ repo.expire(grant.id);
+
+ let response = service
+ .respond(&user(PERSON), grant.id, AccountManagerDecision::Approve)
+ .await;
+ let read = service.get(&user(PERSON), grant.id).await.unwrap();
+
+ assert!(matches!(response, Err(AccountManagerError::Conflict(_))));
+ assert_eq!(read.status, AccountManagerGrantStatus::Expired);
+}
+
+#[tokio::test]
+async fn approval_posts_the_link_to_the_manager_and_only_the_manager_can_claim_once() {
+ let (service, _, delivery) = service();
+ let grant = service
+ .request(&user(AGENT), &user(PERSON), AccountManagerRole::Manager)
+ .await
+ .unwrap();
+ service
+ .respond(&user(PERSON), grant.id, AccountManagerDecision::Approve)
+ .await
+ .unwrap();
+
+ assert_eq!(
+ delivery.posts.lock().unwrap().last().unwrap(),
+ &(PERSON.to_string(), AGENT.to_string(), "approval")
+ );
+
+ let by_managed = service.claim(&user(PERSON), grant.id).await;
+ let by_stranger = service.claim(&user(AGENT_2), grant.id).await;
+ let claimed = service.claim(&user(AGENT), grant.id).await.unwrap();
+ let again = service.claim(&user(AGENT), grant.id).await;
+
+ assert!(matches!(by_managed, Err(AccountManagerError::Forbidden(_))));
+ assert!(matches!(by_stranger, Err(AccountManagerError::NotFound)));
+ assert_eq!(claimed.grant.status, AccountManagerGrantStatus::Active);
+ assert!(claimed.key.expose().starts_with("mak_"));
+ assert!(matches!(again, Err(AccountManagerError::Conflict(_))));
+}
+
+#[tokio::test]
+async fn a_declined_request_cannot_be_claimed() {
+ let (service, _, _) = service();
+ let grant = service
+ .request(&user(PERSON), &user(AGENT), AccountManagerRole::Managed)
+ .await
+ .unwrap();
+ service
+ .respond(&user(AGENT), grant.id, AccountManagerDecision::Decline)
+ .await
+ .unwrap();
+
+ let claim = service.claim(&user(AGENT), grant.id).await;
+
+ assert!(matches!(claim, Err(AccountManagerError::Conflict(_))));
+}
+
+#[tokio::test]
+async fn a_failed_approval_message_does_not_undo_the_approval() {
+ let (service, _, delivery) = service();
+ let grant = service
+ .request(&user(AGENT), &user(PERSON), AccountManagerRole::Manager)
+ .await
+ .unwrap();
+ *delivery.fail.lock().unwrap() = true;
+
+ let approved = service
+ .respond(&user(PERSON), grant.id, AccountManagerDecision::Approve)
+ .await
+ .unwrap();
+
+ assert_eq!(approved.status, AccountManagerGrantStatus::Approved);
+ service.claim(&user(AGENT), grant.id).await.unwrap();
+}
+
+#[tokio::test]
+async fn either_side_can_revoke_but_a_stranger_cannot() {
+ let (service, _, _) = service();
+ let grant = service
+ .request(&user(AGENT), &user(PERSON), AccountManagerRole::Manager)
+ .await
+ .unwrap();
+
+ let by_stranger = service.revoke(&user(PERSON_2), grant.id).await;
+ assert!(matches!(by_stranger, Err(AccountManagerError::NotFound)));
+
+ let revoked = service.revoke(&user(PERSON), grant.id).await.unwrap();
+ assert_eq!(revoked.status, AccountManagerGrantStatus::Revoked);
+
+ let again = service.revoke(&user(AGENT), grant.id).await;
+ assert!(matches!(again, Err(AccountManagerError::Conflict(_))));
+}
diff --git a/crates/account_manager/src/inbound.rs b/crates/account_manager/src/inbound.rs
new file mode 100644
index 0000000000..23d1bf0767
--- /dev/null
+++ b/crates/account_manager/src/inbound.rs
@@ -0,0 +1,3 @@
+//! Inbound (driving) adapters for account managers.
+
+pub mod axum_router;
diff --git a/crates/account_manager/src/inbound/axum_router.rs b/crates/account_manager/src/inbound/axum_router.rs
new file mode 100644
index 0000000000..cb36a94231
--- /dev/null
+++ b/crates/account_manager/src/inbound/axum_router.rs
@@ -0,0 +1,366 @@
+//! Axum router for account manager endpoints.
+
+use std::sync::Arc;
+
+use axum::{
+ Json, Router,
+ extract::{FromRef, Path, State},
+ http::StatusCode,
+ response::IntoResponse,
+ routing::{get, post},
+};
+use macro_authorization::{
+ AccountHolderOrInternal, MacroAuthorizationExtractor, MacroAuthorizationService,
+ MacroAuthorizationState,
+};
+use macro_user_id::user_id::MacroUserIdStr;
+use model_error_response::ErrorResponse;
+use serde::{Deserialize, Serialize};
+use uuid::Uuid;
+
+use crate::domain::{
+ models::{
+ AccountManagerDecision, AccountManagerError, AccountManagerGrant, AccountManagerRole,
+ },
+ ports::AccountManagerService,
+};
+
+/// Router state for account manager endpoints.
+pub struct AccountManagerRouterState<S, Auth> {
+ service: Arc<S>,
+ authorization_state: MacroAuthorizationState<Auth>,
+}
+
+impl<S, Auth> Clone for AccountManagerRouterState<S, Auth> {
+ fn clone(&self) -> Self {
+ Self {
+ service: self.service.clone(),
+ authorization_state: self.authorization_state.clone(),
+ }
+ }
+}
+
+impl<S, Auth> AccountManagerRouterState<S, Auth> {
+ /// Create router state from a shared service and authorization state.
+ pub fn new(service: Arc<S>, authorization_state: MacroAuthorizationState<Auth>) -> Self {
+ Self {
+ service,
+ authorization_state,
+ }
+ }
+}
+
+impl<S, Auth> FromRef<AccountManagerRouterState<S, Auth>> for MacroAuthorizationState<Auth> {
+ fn from_ref(state: &AccountManagerRouterState<S, Auth>) -> Self {
+ state.authorization_state.clone()
+ }
+}
+
+/// Build the account manager router. Every route refuses a manager credential,
+/// so a manager can't change who manages the account it acts as.
+pub fn account_manager_router<S, Auth, T>(state: AccountManagerRouterState<S, Auth>) -> Router<T>
+where
+ S: AccountManagerService,
+ Auth: MacroAuthorizationService,
+ T: Send + Sync + 'static,
+{
+ Router::new()
+ .route(
+ "/",
+ get(list_account_managers_handler::<S, Auth>)
+ .post(request_account_manager_handler::<S, Auth>),
+ )
+ .route(
+ "/{id}",
+ get(get_account_manager_grant_handler::<S, Auth>)
+ .delete(revoke_account_manager_grant_handler::<S, Auth>),
+ )
+ .route(
+ "/{id}/response",
+ post(respond_to_account_manager_request_handler::<S, Auth>),
+ )
+ .route(
+ "/{id}/token",
+ post(claim_account_manager_token_handler::<S, Auth>),
+ )
+ .with_state(state)
+}
+
+/// Request body for asking for a grant.
+#[derive(Debug, Deserialize, utoipa::ToSchema)]
+#[serde(rename_all = "camelCase")]
+pub struct RequestAccountManagerBody {
+ /// The other account (`macro|...`).
+ #[schema(value_type = String)]
+ pub counterparty_id: MacroUserIdStr<'static>,
+ /// The side the caller takes.
+ pub caller_role: AccountManagerRole,
+}
+
+/// Request body for responding to a request.
+#[derive(Debug, Deserialize, utoipa::ToSchema)]
+#[serde(rename_all = "camelCase")]
+pub struct RespondToAccountManagerRequestBody {
+ /// The response.
+ pub decision: AccountManagerDecision,
+}
+
+/// The managers of the caller's account.
+#[derive(Debug, Serialize, utoipa::ToSchema)]
+#[serde(rename_all = "camelCase")]
+pub struct AccountManagersList {
+ /// Approved and active grants on the caller's account.
+ pub grants: Vec<AccountManagerGrant>,
+}
+
+/// The credential, returned only by the claim that issued it.
+#[derive(Serialize, utoipa::ToSchema)]
+#[serde(rename_all = "camelCase")]
+pub struct ClaimedAccountManagerToken {
+ /// The grant, now active.
+ pub grant: AccountManagerGrant,
+ /// The secret. Shown only once.
+ pub token: String,
+}
+
+/// Path params addressing a grant.
+#[derive(Debug, Deserialize, utoipa::IntoParams)]
+#[into_params(parameter_in = Path)]
+pub struct AccountManagerGrantParams {
+ /// Grant id.
+ pub id: Uuid,
+}
+
+/// Ask another account for manager access, in your DM with them.
+#[utoipa::path(
+ post,
+ tag = "account-managers",
+ operation_id = "request_account_manager",
+ path = "/account-managers",
+ request_body = RequestAccountManagerBody,
+ responses(
+ (status = 200, body = AccountManagerGrant),
+ (status = 400, body = ErrorResponse),
+ (status = 401, body = ErrorResponse),
+ (status = 403, body = ErrorResponse),
+ (status = 500, body = ErrorResponse),
+ )
+)]
+#[tracing::instrument(err, skip_all)]
+pub async fn request_account_manager_handler<S, Auth>(
+ State(state): State<AccountManagerRouterState<S, Auth>>,
+ user: MacroAuthorizationExtractor<Auth, AccountHolderOrInternal>,
+ Json(body): Json<RequestAccountManagerBody>,
+) -> Result<Json<AccountManagerGrant>, AccountManagerError>
+where
+ S: AccountManagerService,
+ Auth: MacroAuthorizationService,
+{
+ let grant = state
+ .service
+ .request(
+ &user.authorization.user.macro_user_id,
+ &body.counterparty_id,
+ body.caller_role,
+ )
+ .await?;
+ Ok(Json(grant))
+}
+
+/// List the managers of the caller's account.
+#[utoipa::path(
+ get,
+ tag = "account-managers",
+ operation_id = "list_account_managers",
+ path = "/account-managers",
+ responses(
+ (status = 200, body = AccountManagersList),
+ (status = 401, body = ErrorResponse),
+ (status = 403, body = ErrorResponse),
+ (status = 500, body = ErrorResponse),
+ )
+)]
+#[tracing::instrument(err, skip_all)]
+pub async fn list_account_managers_handler<S, Auth>(
+ State(state): State<AccountManagerRouterState<S, Auth>>,
+ user: MacroAuthorizationExtractor<Auth, AccountHolderOrInternal>,
+) -> Result<Json<AccountManagersList>, AccountManagerError>
+where
+ S: AccountManagerService,
+ Auth: MacroAuthorizationService,
+{
+ let grants = state
+ .service
+ .list_managers(&user.authorization.user.macro_user_id)
+ .await?;
+ Ok(Json(AccountManagersList { grants }))
+}
+
+/// Read a grant the caller is part of.
+#[utoipa::path(
+ get,
+ tag = "account-managers",
+ operation_id = "get_account_manager_grant",
+ path = "/account-managers/{id}",
+ params(AccountManagerGrantParams),
+ responses(
+ (status = 200, body = AccountManagerGrant),
+ (status = 401, body = ErrorResponse),
+ (status = 403, body = ErrorResponse),
+ (status = 404, body = ErrorResponse),
+ (status = 500, body = ErrorResponse),
+ )
+)]
+#[tracing::instrument(err, skip_all)]
+pub async fn get_account_manager_grant_handler<S, Auth>(
+ State(state): State<AccountManagerRouterState<S, Auth>>,
+ user: MacroAuthorizationExtractor<Auth, AccountHolderOrInternal>,
+ Path(params): Path<AccountManagerGrantParams>,
+) -> Result<Json<AccountManagerGrant>, AccountManagerError>
+where
+ S: AccountManagerService,
+ Auth: MacroAuthorizationService,
+{
+ let grant = state
+ .service
+ .get(&user.authorization.user.macro_user_id, params.id)
+ .await?;
+ Ok(Json(grant))
+}
+
+/// Approve or decline a request the caller didn't make.
+#[utoipa::path(
+ post,
+ tag = "account-managers",
+ operation_id = "respond_to_account_manager_request",
+ path = "/account-managers/{id}/response",
+ params(AccountManagerGrantParams),
+ request_body = RespondToAccountManagerRequestBody,
+ responses(
+ (status = 200, body = AccountManagerGrant),
+ (status = 401, body = ErrorResponse),
+ (status = 403, body = ErrorResponse),
+ (status = 404, body = ErrorResponse),
+ (status = 409, body = ErrorResponse),
+ (status = 500, body = ErrorResponse),
+ )
+)]
+#[tracing::instrument(err, skip_all)]
+pub async fn respond_to_account_manager_request_handler<S, Auth>(
+ State(state): State<AccountManagerRouterState<S, Auth>>,
+ user: MacroAuthorizationExtractor<Auth, AccountHolderOrInternal>,
+ Path(params): Path<AccountManagerGrantParams>,
+ Json(body): Json<RespondToAccountManagerRequestBody>,
+) -> Result<Json<AccountManagerGrant>, AccountManagerError>
+where
+ S: AccountManagerService,
+ Auth: MacroAuthorizationService,
+{
+ let grant = state
+ .service
+ .respond(
+ &user.authorization.user.macro_user_id,
+ params.id,
+ body.decision,
+ )
+ .await?;
+ Ok(Json(grant))
+}
+
+/// Issue the credential to the manager. Works once. A POST, so link previews
+/// and crawlers can't use it up.
+#[utoipa::path(
+ post,
+ tag = "account-managers",
+ operation_id = "claim_account_manager_token",
+ path = "/account-managers/{id}/token",
+ params(AccountManagerGrantParams),
+ responses(
+ (status = 200, body = ClaimedAccountManagerToken),
+ (status = 401, body = ErrorResponse),
+ (status = 403, body = ErrorResponse),
+ (status = 404, body = ErrorResponse),
+ (status = 409, body = ErrorResponse),
+ (status = 500, body = ErrorResponse),
+ )
+)]
+#[tracing::instrument(err, skip_all)]
+pub async fn claim_account_manager_token_handler<S, Auth>(
+ State(state): State<AccountManagerRouterState<S, Auth>>,
+ user: MacroAuthorizationExtractor<Auth, AccountHolderOrInternal>,
+ Path(params): Path<AccountManagerGrantParams>,
+) -> Result<Json<ClaimedAccountManagerToken>, AccountManagerError>
+where
+ S: AccountManagerService,
+ Auth: MacroAuthorizationService,
+{
+ let claimed = state
+ .service
+ .claim(&user.authorization.user.macro_user_id, params.id)
+ .await?;
+ Ok(Json(ClaimedAccountManagerToken {
+ grant: claimed.grant,
+ token: claimed.key.expose().to_string(),
+ }))
+}
+
+/// End a grant. Either side may withdraw it.
+#[utoipa::path(
+ delete,
+ tag = "account-managers",
+ operation_id = "revoke_account_manager_grant",
+ path = "/account-managers/{id}",
+ params(AccountManagerGrantParams),
+ responses(
+ (status = 200, body = AccountManagerGrant),
+ (status = 401, body = ErrorResponse),
+ (status = 403, body = ErrorResponse),
+ (status = 404, body = ErrorResponse),
+ (status = 409, body = ErrorResponse),
+ (status = 500, body = ErrorResponse),
+ )
+)]
+#[tracing::instrument(err, skip_all)]
+pub async fn revoke_account_manager_grant_handler<S, Auth>(
+ State(state): State<AccountManagerRouterState<S, Auth>>,
+ user: MacroAuthorizationExtractor<Auth, AccountHolderOrInternal>,
+ Path(params): Path<AccountManagerGrantParams>,
+) -> Result<Json<AccountManagerGrant>, AccountManagerError>
+where
+ S: AccountManagerService,
+ Auth: MacroAuthorizationService,
+{
+ let grant = state
+ .service
+ .revoke(&user.authorization.user.macro_user_id, params.id)
+ .await?;
+ Ok(Json(grant))
+}
+
+impl IntoResponse for AccountManagerError {
+ fn into_response(self) -> axum::response::Response {
+ let status_code = match &self {
+ AccountManagerError::NotFound => StatusCode::NOT_FOUND,
+ AccountManagerError::Forbidden(_) => StatusCode::FORBIDDEN,
+ AccountManagerError::Conflict(_) => StatusCode::CONFLICT,
+ AccountManagerError::BadRequest(_) => StatusCode::BAD_REQUEST,
+ AccountManagerError::Internal(_) => StatusCode::INTERNAL_SERVER_ERROR,
+ };
+
+ let message = match &self {
+ AccountManagerError::Internal(_) => {
+ tracing::error!(error=?self, "account manager internal server error");
+ "internal server error".to_string()
+ }
+ error => error.to_string(),
+ };
+
+ (
+ status_code,
+ Json(ErrorResponse {
+ message: message.into(),
+ }),
+ )
+ .into_response()
+ }
+}
diff --git a/crates/account_manager/src/lib.rs b/crates/account_manager/src/lib.rs
new file mode 100644
index 0000000000..a833ab4893
--- /dev/null
+++ b/crates/account_manager/src/lib.rs
@@ -0,0 +1,17 @@
+#![deny(missing_docs)]
+//! Account managers: an agent account's full access to another account,
+//! requested and approved in a DM, following the hexagonal architecture pattern.
+//!
+//! # Architecture
+//!
+//! - **domain**: domain models, ports, and the service implementation.
+//! - **inbound**: driving adapters (Axum HTTP router).
+//! - **outbound**: driven adapters (Postgres repository, DM delivery).
+
+pub mod domain;
+
+#[cfg(feature = "inbound")]
+pub mod inbound;
+
+#[cfg(any(feature = "outbound", feature = "postgres"))]
+pub mod outbound;
diff --git a/crates/account_manager/src/outbound.rs b/crates/account_manager/src/outbound.rs
new file mode 100644
index 0000000000..ba6d96642e
--- /dev/null
+++ b/crates/account_manager/src/outbound.rs
@@ -0,0 +1,6 @@
+//! Outbound (driven) adapters for account managers.
+
+#[cfg(feature = "outbound")]
+pub mod dm_delivery;
+#[cfg(feature = "postgres")]
+pub mod pg_account_manager_repo;
diff --git a/crates/account_manager/src/outbound/dm_delivery.rs b/crates/account_manager/src/outbound/dm_delivery.rs
new file mode 100644
index 0000000000..3061974421
--- /dev/null
+++ b/crates/account_manager/src/outbound/dm_delivery.rs
@@ -0,0 +1,133 @@
+//! Posts account manager requests and approvals into the pair's DM.
+
+use std::sync::Arc;
+
+use channels::domain::{
+ models::{ChannelSender, GetOrCreateDmRequest},
+ ports::ChannelService,
+};
+use entity_access::domain::{models::EntityType, ports::EntityAccessService};
+use macro_service_urls::AppServiceUrl;
+use macro_user_id::user_id::MacroUserIdStr;
+use messages::domain::{
+ api::MessageCommands,
+ models::{MessageAttribution, PostMessage, PostMessageNotificationPolicy},
+ service::MessageWrite,
+};
+use rootcause::prelude::ResultExt;
+use uuid::Uuid;
+
+use crate::domain::{models::CARD_TAG, ports::AccountManagerDelivery};
+
+/// Delivery through the shared channel and message services.
+pub struct DmAccountManagerDelivery<C, A> {
+ channels: Arc<C>,
+ messages: Arc<dyn MessageCommands>,
+ access: Arc<A>,
+ app_url: AppServiceUrl,
+}
+
+impl<C, A> DmAccountManagerDelivery<C, A> {
+ /// Compose delivery from the services that own channels and messages.
+ pub fn new(
+ channels: Arc<C>,
+ messages: Arc<dyn MessageCommands>,
+ access: Arc<A>,
+ app_url: AppServiceUrl,
+ ) -> Self {
+ Self {
+ channels,
+ messages,
+ access,
+ app_url,
+ }
+ }
+}
+
+fn card(grant_id: Uuid) -> String {
+ format!(r#"<{CARD_TAG}>{{"id":"{grant_id}"}}</{CARD_TAG}>"#)
+}
+
+impl<C, A> DmAccountManagerDelivery<C, A>
+where
+ C: ChannelService,
+ A: EntityAccessService,
+{
+ async fn post(
+ &self,
+ sender: &MacroUserIdStr<'static>,
+ recipient: &MacroUserIdStr<'static>,
+ content: String,
+ ) -> Result<(), rootcause::Report> {
+ let channel = self
+ .channels
+ .get_or_create_dm(
+ ChannelSender::new_from_user(sender.clone()),
+ GetOrCreateDmRequest {
+ recipient_id: ChannelSender::new_from_user(recipient.clone()),
+ },
+ )
+ .await
+ .map_err(|error| rootcause::report!("could not open the DM: {error:?}"))?;
+ let access = self
+ .access
+ .generate_entity_access_receipt::<MessageWrite>(
+ sender,
+ None,
+ &channel.channel_id,
+ EntityType::Channel,
+ )
+ .await
+ .context("sender must be able to post in the DM")?;
+
+ self.messages
+ .post(
+ access,
+ PostMessage {
+ id: None,
+ attribution: MessageAttribution::ActingUser,
+ notification_policy: PostMessageNotificationPolicy::default(),
+ content,
+ thread_id: None,
+ anchor: None,
+ mentions: Vec::new(),
+ attachments: Vec::new(),
+ nonce: None,
+ },
+ )
+ .await
+ .context("could not post in the DM")?;
+
+ Ok(())
+ }
+}
+
+impl<C, A> AccountManagerDelivery for DmAccountManagerDelivery<C, A>
+where
+ C: ChannelService,
+ A: EntityAccessService,
+{
+ async fn deliver_request(
+ &self,
+ sender: &MacroUserIdStr<'static>,
+ recipient: &MacroUserIdStr<'static>,
+ grant_id: Uuid,
+ ) -> Result<(), rootcause::Report> {
+ self.post(sender, recipient, card(grant_id)).await
+ }
+
+ async fn deliver_approval(
+ &self,
+ sender: &MacroUserIdStr<'static>,
+ recipient: &MacroUserIdStr<'static>,
+ grant_id: Uuid,
+ ) -> Result<(), rootcause::Report> {
+ let link = format!("{}/app/account-manager/{grant_id}", self.app_url.as_ref());
+ let content = format!(
+ "{}\n\nAccess approved. The manager can reveal the token once at {link}",
+ card(grant_id),
+ );
+
+ self.post(sender, recipient, content).await
+ }
+}
diff --git a/crates/account_manager/src/outbound/pg_account_manager_repo.rs b/crates/account_manager/src/outbound/pg_account_manager_repo.rs
new file mode 100644
index 0000000000..ea103fac5a
--- /dev/null
+++ b/crates/account_manager/src/outbound/pg_account_manager_repo.rs
@@ -0,0 +1,330 @@
+//! PostgreSQL repository for `account_manager_grants`.
+
+#[cfg(test)]
+mod test;
+
+use chrono::{DateTime, Utc};
+use macro_user_id::user_id::MacroUserIdStr;
+use sqlx::PgPool;
+use uuid::Uuid;
+
+use crate::domain::models::{
+ AccountManagerDecision, AccountManagerGrant, AccountManagerGrantStatus, AccountManagerRole,
+};
+use crate::domain::ports::{AccountManagerRepo, OpenedRequest};
+
+/// Errors from the Postgres repository.
+#[derive(Debug, thiserror::Error)]
+pub enum PgAccountManagerRepoError {
+ /// A database operation failed.
+ #[error("account manager database operation failed")]
+ Database(#[from] sqlx::Error),
+ /// A stored row can't be represented in the domain.
+ #[error("invalid stored account manager grant")]
+ InvalidRow,
+}
+
+/// Postgres-backed grant storage.
+#[derive(Debug, Clone)]
+pub struct PgAccountManagerRepo {
+ pool: PgPool,
+}
+
+impl PgAccountManagerRepo {
+ /// Create a repository over the MacroDB pool.
+ pub fn new(pool: PgPool) -> Self {
+ Self { pool }
+ }
+}
+
+struct GrantRow {
+ id: Uuid,
+ managed_user_id: String,
+ manager_user_id: String,
+ requested_by: String,
+ status: String,
+ expires_at: Option<DateTime<Utc>>,
+ created_at: DateTime<Utc>,
+ claimed_at: Option<DateTime<Utc>>,
+ last_used_at: Option<DateTime<Utc>>,
+}
+
+impl TryFrom<GrantRow> for AccountManagerGrant {
+ type Error = PgAccountManagerRepoError;
+
+ fn try_from(row: GrantRow) -> Result<Self, Self::Error> {
+ let invalid = |_| PgAccountManagerRepoError::InvalidRow;
+
+ Ok(Self {
+ id: row.id,
+ managed_user_id: MacroUserIdStr::try_from(row.managed_user_id)
+ .map_err(|_| PgAccountManagerRepoError::InvalidRow)?,
+ manager_user_id: MacroUserIdStr::try_from(row.manager_user_id)
+ .map_err(|_| PgAccountManagerRepoError::InvalidRow)?,
+ requested_by: row
+ .requested_by
+ .parse::<AccountManagerRole>()
+ .map_err(invalid)?,
+ status: row
+ .status
+ .parse::<AccountManagerGrantStatus>()
+ .map_err(invalid)?,
+ expires_at: row.expires_at,
+ created_at: row.created_at,
+ claimed_at: row.claimed_at,
+ last_used_at: row.last_used_at,
+ })
+ }
+}
+
+fn grant(row: Option<GrantRow>) -> Result<Option<AccountManagerGrant>, PgAccountManagerRepoError> {
+ row.map(AccountManagerGrant::try_from).transpose()
+}
+
+impl AccountManagerRepo for PgAccountManagerRepo {
+ type Err = PgAccountManagerRepoError;
+
+ async fn is_agent(&self, user: &MacroUserIdStr<'_>) -> Result<Option<bool>, Self::Err> {
+ let is_agent = sqlx::query_scalar!(
+ r#"SELECT "isAgent" FROM "User" WHERE id = $1"#,
+ user.as_ref(),
+ )
+ .fetch_optional(&self.pool)
+ .await?;
+
+ Ok(is_agent)
+ }
+
+ async fn open_request(
+ &self,
+ id: Uuid,
+ managed: &MacroUserIdStr<'_>,
+ manager: &MacroUserIdStr<'_>,
+ requested_by: AccountManagerRole,
+ expires_at: DateTime<Utc>,
+ ) -> Result<OpenedRequest, Self::Err> {
+ let mut tx = self.pool.begin().await?;
+
+ sqlx::query!(
+ r#"
+ UPDATE account_manager_grants
+ SET status = 'expired', expires_at = NULL
+ WHERE managed_user_id = $1
+ AND manager_user_id = $2
+ AND status = 'pending'
+ AND expires_at <= now()
+ "#,
+ managed.as_ref(),
+ manager.as_ref(),
+ )
+ .execute(&mut *tx)
+ .await?;
+
+ let inserted = sqlx::query_as!(
+ GrantRow,
+ r#"
+ INSERT INTO account_manager_grants
+ (id, managed_user_id, manager_user_id, requested_by, status, expires_at)
+ VALUES ($1, $2, $3, $4, 'pending', $5)
+ ON CONFLICT (managed_user_id, manager_user_id) WHERE status = 'pending' DO NOTHING
+ RETURNING id, managed_user_id, manager_user_id, requested_by, status, expires_at,
+ created_at, claimed_at, last_used_at
+ "#,
+ id,
+ managed.as_ref(),
+ manager.as_ref(),
+ requested_by.to_string(),
+ expires_at,
+ )
+ .fetch_optional(&mut *tx)
+ .await?;
+
+ let (row, created) = match inserted {
+ Some(row) => (row, true),
+ None => {
+ let existing = sqlx::query_as!(
+ GrantRow,
+ r#"
+ SELECT id, managed_user_id, manager_user_id, requested_by, status, expires_at,
+ created_at, claimed_at, last_used_at
+ FROM account_manager_grants
+ WHERE managed_user_id = $1
+ AND manager_user_id = $2
+ AND status = 'pending'
+ "#,
+ managed.as_ref(),
+ manager.as_ref(),
+ )
+ .fetch_one(&mut *tx)
+ .await?;
+ (existing, false)
+ }
+ };
+
+ tx.commit().await?;
+
+ Ok(OpenedRequest {
+ grant: row.try_into()?,
+ created,
+ })
+ }
+
+ async fn get(&self, id: Uuid) -> Result<Option<AccountManagerGrant>, Self::Err> {
+ let row = sqlx::query_as!(
+ GrantRow,
+ r#"
+ SELECT id, managed_user_id, manager_user_id, requested_by, status, expires_at,
+ created_at, claimed_at, last_used_at
+ FROM account_manager_grants
+ WHERE id = $1
+ "#,
+ id,
+ )
+ .fetch_optional(&self.pool)
+ .await?;
+
+ grant(row)
+ }
+
+ async fn list_for_managed(
+ &self,
+ managed: &MacroUserIdStr<'_>,
+ ) -> Result<Vec<AccountManagerGrant>, Self::Err> {
+ let rows = sqlx::query_as!(
+ GrantRow,
+ r#"
+ SELECT id, managed_user_id, manager_user_id, requested_by, status, expires_at,
+ created_at, claimed_at, last_used_at
+ FROM account_manager_grants
+ WHERE managed_user_id = $1
+ AND status IN ('approved', 'active')
+ ORDER BY id DESC
+ "#,
+ managed.as_ref(),
+ )
+ .fetch_all(&self.pool)
+ .await?;
+
+ rows.into_iter()
+ .map(AccountManagerGrant::try_from)
+ .collect()
+ }
+
+ async fn respond(
+ &self,
+ id: Uuid,
+ decision: AccountManagerDecision,
+ claim_expires_at: DateTime<Utc>,
+ now: DateTime<Utc>,
+ ) -> Result<Option<AccountManagerGrant>, Self::Err> {
+ let (status, expires_at) = match decision {
+ AccountManagerDecision::Approve => {
+ (AccountManagerGrantStatus::Approved, Some(claim_expires_at))
+ }
+ AccountManagerDecision::Decline => (AccountManagerGrantStatus::Declined, None),
+ };
+ let row = sqlx::query_as!(
+ GrantRow,
+ r#"
+ UPDATE account_manager_grants
+ SET status = $2, expires_at = $3
+ WHERE id = $1
+ AND status = 'pending'
+ AND expires_at > $4
+ RETURNING id, managed_user_id, manager_user_id, requested_by, status, expires_at,
+ created_at, claimed_at, last_used_at
+ "#,
+ id,
+ status.to_string(),
+ expires_at,
+ now,
+ )
+ .fetch_optional(&self.pool)
+ .await?;
+
+ grant(row)
+ }
+
+ async fn claim(
+ &self,
+ id: Uuid,
+ key_hash: &[u8; 32],
+ now: DateTime<Utc>,
+ ) -> Result<Option<AccountManagerGrant>, Self::Err> {
+ let mut tx = self.pool.begin().await?;
+
+ // Taking the row first means a concurrent claim waits, then finds it
+ // no longer approved.
+ let claimable = sqlx::query!(
+ r#"
+ SELECT managed_user_id, manager_user_id
+ FROM account_manager_grants
+ WHERE id = $1
+ AND status = 'approved'
+ AND expires_at > $2
+ FOR UPDATE
+ "#,
+ id,
+ now,
+ )
+ .fetch_optional(&mut *tx)
+ .await?;
+
+ let Some(pair) = claimable else {
+ return Ok(None);
+ };
+
+ sqlx::query!(
+ r#"
+ UPDATE account_manager_grants
+ SET status = 'revoked', key_hash = NULL
+ WHERE managed_user_id = $1
+ AND manager_user_id = $2
+ AND status = 'active'
+ "#,
+ pair.managed_user_id,
+ pair.manager_user_id,
+ )
+ .execute(&mut *tx)
+ .await?;
+
+ let row = sqlx::query_as!(
+ GrantRow,
+ r#"
+ UPDATE account_manager_grants
+ SET status = 'active', key_hash = $2, expires_at = NULL, claimed_at = $3
+ WHERE id = $1
+ RETURNING id, managed_user_id, manager_user_id, requested_by, status, expires_at,
+ created_at, claimed_at, last_used_at
+ "#,
+ id,
+ &key_hash[..],
+ now,
+ )
+ .fetch_one(&mut *tx)
+ .await?;
+
+ tx.commit().await?;
+
+ grant(Some(row))
+ }
+
+ async fn revoke(&self, id: Uuid) -> Result<Option<AccountManagerGrant>, Self::Err> {
+ let row = sqlx::query_as!(
+ GrantRow,
+ r#"
+ UPDATE account_manager_grants
+ SET status = 'revoked', key_hash = NULL, expires_at = NULL
+ WHERE id = $1
+ AND status IN ('pending', 'approved', 'active')
+ RETURNING id, managed_user_id, manager_user_id, requested_by, status, expires_at,
+ created_at, claimed_at, last_used_at
+ "#,
+ id,
+ )
+ .fetch_optional(&self.pool)
+ .await?;
+
+ grant(row)
+ }
+}
diff --git a/crates/account_manager/src/outbound/pg_account_manager_repo/test.rs b/crates/account_manager/src/outbound/pg_account_manager_repo/test.rs
new file mode 100644
index 0000000000..18dccec953
--- /dev/null
+++ b/crates/account_manager/src/outbound/pg_account_manager_repo/test.rs
@@ -0,0 +1,230 @@
+use chrono::{Duration, Utc};
+use macro_db_migrator::MACRO_DB_MIGRATIONS;
+use macro_user_id::user_id::MacroUserIdStr;
+use sqlx::PgPool;
+use uuid::Uuid;
+
+use super::*;
+
+const AGENT: &str = "macro|[email protected]";
+const PERSON: &str = "macro|[email protected]";
+
+fn user(id: &'static str) -> MacroUserIdStr<'static> {
+ MacroUserIdStr::parse_from_str(id).unwrap()
+}
+
+async fn seed_users(pool: &PgPool) {
+ for (id, email, is_agent) in [
+ (AGENT, "[email protected]", true),
+ (PERSON, "[email protected]", false),
+ ] {
+ let macro_user_id = Uuid::now_v7();
+ sqlx::query!(
+ "INSERT INTO macro_user (id, username, email, stripe_customer_id) VALUES ($1, $2, $2, $3)",
+ macro_user_id,
+ email,
+ format!("stripe_{macro_user_id}"),
+ )
+ .execute(pool)
+ .await
+ .unwrap();
+ sqlx::query!(
+ r#"INSERT INTO "User" (id, email, macro_user_id, "isAgent") VALUES ($1, $2, $3, $4)"#,
+ id,
+ email,
+ macro_user_id,
+ is_agent,
+ )
+ .execute(pool)
+ .await
+ .unwrap();
+ }
+}
+
+async fn open(repo: &PgAccountManagerRepo, expires_at: DateTime<Utc>) -> OpenedRequest {
+ repo.open_request(
+ Uuid::now_v7(),
+ &user(PERSON),
+ &user(AGENT),
+ AccountManagerRole::Manager,
+ expires_at,
+ )
+ .await
+ .unwrap()
+}
+
+async fn approve(repo: &PgAccountManagerRepo, id: Uuid) {
+ let now = Utc::now();
+ repo.respond(
+ id,
+ AccountManagerDecision::Approve,
+ now + Duration::days(7),
+ now,
+ )
+ .await
+ .unwrap()
+ .unwrap();
+}
+
+#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]
+async fn is_agent_reads_the_account_flag(pool: PgPool) {
+ seed_users(&pool).await;
+ let repo = PgAccountManagerRepo::new(pool);
+
+ assert_eq!(repo.is_agent(&user(AGENT)).await.unwrap(), Some(true));
+ assert_eq!(repo.is_agent(&user(PERSON)).await.unwrap(), Some(false));
+ assert_eq!(
+ repo.is_agent(&user("macro|[email protected]"))
+ .await
+ .unwrap(),
+ None
+ );
+}
+
+#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]
+async fn one_pending_request_per_pair_until_it_expires(pool: PgPool) {
+ seed_users(&pool).await;
+ let repo = PgAccountManagerRepo::new(pool.clone());
+
+ let first = open(&repo, Utc::now() + Duration::days(7)).await;
+ let second = open(&repo, Utc::now() + Duration::days(7)).await;
+ assert!(first.created);
+ assert!(!second.created);
+ assert_eq!(first.grant.id, second.grant.id);
+
+ sqlx::query!(
+ "UPDATE account_manager_grants SET expires_at = now() - interval '1 minute' WHERE id = $1",
+ first.grant.id,
+ )
+ .execute(&pool)
+ .await
+ .unwrap();
+
+ let third = open(&repo, Utc::now() + Duration::days(7)).await;
+ assert!(third.created);
+ let lapsed = repo.get(first.grant.id).await.unwrap().unwrap();
+ assert_eq!(lapsed.status, AccountManagerGrantStatus::Expired);
+}
+
+#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]
+async fn a_lapsed_request_cannot_be_approved(pool: PgPool) {
+ seed_users(&pool).await;
+ let repo = PgAccountManagerRepo::new(pool);
+ let grant = open(&repo, Utc::now() - Duration::minutes(1)).await.grant;
+
+ let now = Utc::now();
+ let response = repo
+ .respond(grant.id, AccountManagerDecision::Approve, now, now)
+ .await
+ .unwrap();
+
+ assert!(response.is_none());
+}
+
+#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]
+async fn a_claim_works_once_and_replaces_the_pairs_earlier_credential(pool: PgPool) {
+ seed_users(&pool).await;
+ let repo = PgAccountManagerRepo::new(pool);
+
+ let earlier = open(&repo, Utc::now() + Duration::days(7)).await.grant;
+ approve(&repo, earlier.id).await;
+ let active = repo
+ .claim(earlier.id, &[1; 32], Utc::now())
+ .await
+ .unwrap()
+ .unwrap();
+ assert_eq!(active.status, AccountManagerGrantStatus::Active);
+ assert!(
+ repo.claim(earlier.id, &[2; 32], Utc::now())
+ .await
+ .unwrap()
+ .is_none()
+ );
+
+ let later = open(&repo, Utc::now() + Duration::days(7)).await.grant;
+ approve(&repo, later.id).await;
+
+ // Approving alone leaves the earlier credential working until the claim.
+ let before_claim = repo.get(earlier.id).await.unwrap().unwrap();
+ assert_eq!(before_claim.status, AccountManagerGrantStatus::Active);
+
+ repo.claim(later.id, &[3; 32], Utc::now())
+ .await
+ .unwrap()
+ .unwrap();
+
+ let replaced = repo.get(earlier.id).await.unwrap().unwrap();
+ assert_eq!(replaced.status, AccountManagerGrantStatus::Revoked);
+}
+
+#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]
+async fn racing_claims_issue_exactly_one_credential(pool: PgPool) {
+ seed_users(&pool).await;
+ let repo = PgAccountManagerRepo::new(pool.clone());
+ let grant = open(&repo, Utc::now() + Duration::days(7)).await.grant;
+ approve(&repo, grant.id).await;
+
+ let now = Utc::now();
+ let (first, second) = tokio::join!(
+ repo.claim(grant.id, &[5; 32], now),
+ repo.claim(grant.id, &[6; 32], now),
+ );
+ let first = first.unwrap();
+ let second = second.unwrap();
+
+ assert!(first.is_some() != second.is_some());
+ let expected: &[u8] = if first.is_some() { &[5; 32] } else { &[6; 32] };
+ let stored = sqlx::query_scalar!(
+ "SELECT key_hash FROM account_manager_grants WHERE id = $1",
+ grant.id,
+ )
+ .fetch_one(&pool)
+ .await
+ .unwrap();
+ assert_eq!(stored.as_deref(), Some(expected));
+}
+
+#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]
+async fn revoking_clears_the_credential_hash_and_list_hides_it(pool: PgPool) {
+ seed_users(&pool).await;
+ let repo = PgAccountManagerRepo::new(pool.clone());
+ let grant = open(&repo, Utc::now() + Duration::days(7)).await.grant;
+ approve(&repo, grant.id).await;
+ repo.claim(grant.id, &[4; 32], Utc::now())
+ .await
+ .unwrap()
+ .unwrap();
+ assert_eq!(repo.list_for_managed(&user(PERSON)).await.unwrap().len(), 1);
+
+ repo.revoke(grant.id).await.unwrap().unwrap();
+
+ let hash = sqlx::query_scalar!(
+ "SELECT key_hash FROM account_manager_grants WHERE id = $1",
+ grant.id,
+ )
+ .fetch_one(&pool)
+ .await
+ .unwrap();
+ assert!(hash.is_none());
+ assert!(
+ repo.list_for_managed(&user(PERSON))
+ .await
+ .unwrap()
+ .is_empty()
+ );
+ assert!(repo.revoke(grant.id).await.unwrap().is_none());
+}
+
+#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]
+async fn deleting_either_account_removes_the_grant(pool: PgPool) {
+ seed_users(&pool).await;
+ let repo = PgAccountManagerRepo::new(pool.clone());
+ let grant = open(&repo, Utc::now() + Duration::days(7)).await.grant;
+
+ sqlx::query!(r#"DELETE FROM "User" WHERE id = $1"#, AGENT)
+ .execute(&pool)
+ .await
+ .unwrap();
+
+ assert!(repo.get(grant.id).await.unwrap().is_none());
+}
diff --git a/crates/bots/src/inbound/axum_router.rs b/crates/bots/src/inbound/axum_router.rs
index dd5ea76ee3..75e2f4c1b8 100644
--- a/crates/bots/src/inbound/axum_router.rs
+++ b/crates/bots/src/inbound/axum_router.rs
@@ -27,8 +27,9 @@ use entity_access::{
inbound::axum_extractors::ChannelAccessLevelExtractor,
};
use macro_authorization::{
- AnyPrincipal, BotOnly, MacroAuthorization, MacroAuthorizationExtractor,
- MacroAuthorizationService, MacroAuthorizationState, UserOrInternal,
+ AccountHolderOrInternal, AnyPrincipal, BotOnly, MacroAuthorization,
+ MacroAuthorizationExtractor, MacroAuthorizationService, MacroAuthorizationState,
+ UserOrInternal,
};
use macro_user_id::user_id::MacroUserIdStr;
use model_error_response::ErrorResponse;
@@ -552,7 +553,7 @@ pub async fn create_token_handler<
Auth: MacroAuthorizationService,
>(
State(state): State<BotsRouterState<S, Svc, Auth>>,
- authorization: MacroAuthorizationExtractor<Auth, UserOrInternal>,
+ authorization: MacroAuthorizationExtractor<Auth, AccountHolderOrInternal>,
Path(path): Path<BotPath>,
Json(req): Json<CreateBotTokenRequest>,
) -> Result<(StatusCode, Json<CreateBotTokenResponse>), BotsHandlerErr> {
diff --git a/crates/channels/src/domain/activity.rs b/crates/channels/src/domain/activity.rs
index 25ec1e02a2..b8dea50da9 100644
--- a/crates/channels/src/domain/activity.rs
+++ b/crates/channels/src/domain/activity.rs
@@ -162,7 +162,10 @@ pub fn ingest_message_event(event_id: Uuid, event: &MessageTopicEvent) -> Ingest
};
// For agent (bot) messages, `triggered_by` is the user whose
// authority the message was sent under — the activity's subject.
- let on_behalf_of = m.triggered_by.as_deref().and_then(|id: &str| {
+ // A person's message with `triggered_by` came from their account
+ // manager, and remains that person's activity.
+ let bot_trigger = m.sender.as_bot().and(m.triggered_by.as_deref());
+ let on_behalf_of = bot_trigger.and_then(|id: &str| {
MacroUserIdStr::try_from(id.to_string())
.inspect_err(|e| {
// Fall back to the sender as subject, but loudly: the
diff --git a/crates/channels/src/domain/activity/test.rs b/crates/channels/src/domain/activity/test.rs
index e9fd6925f7..6d3af2d023 100644
--- a/crates/channels/src/domain/activity/test.rs
+++ b/crates/channels/src/domain/activity/test.rs
@@ -1,6 +1,7 @@
use ::activity::Action;
use ::activity::Actor;
use ::activity::EntityType;
+use bot_id::BotId;
use chrono::Utc;
use macro_user_id::user_id::MacroUserIdStr;
use uuid::Uuid;
@@ -28,7 +29,7 @@ fn posted(parent: MessageParent, created_at: chrono::DateTime<Utc>) -> MessagePo
message_id: Uuid::from_u128(8),
thread_id: None,
root_id: Uuid::from_u128(8),
- sender: Actor::new_from_user(user("macro|[email protected]")),
+ sender: Actor::new_from_bot(BotId::new_from_uuid(Uuid::from_u128(9))),
triggered_by: Some("macro|[email protected]".to_string()),
content: "hi".to_string(),
mentions: vec![],
@@ -96,12 +97,30 @@ fn message_posted_maps_to_messaged_with_triggered_by_as_subject() {
assert_eq!(activities[0].action, Action::Messaged);
// Delegation: the triggering user is the subject; the sender the actor.
assert_eq!(activities[0].subject_id, "macro|[email protected]");
- assert_eq!(activities[0].actor.as_ref(), "macro|[email protected]");
+ assert_eq!(
+ activities[0].actor.as_ref(),
+ Actor::new_from_bot(BotId::new_from_uuid(Uuid::from_u128(9))).as_ref()
+ );
assert_eq!(activities[0].occurred_at, created_at);
assert_eq!(activities[0].entity_id, CHANNEL_ID.to_string());
assert_eq!(activities[0].entity_type, EntityType::Channel);
}
+#[test]
+fn a_message_from_an_account_manager_stays_the_senders_activity() {
+ let mut posted = posted(MessageParent::Channel(CHANNEL_ID), Utc::now());
+ posted.sender = Actor::new_from_user(user("macro|[email protected]"));
+ posted.triggered_by = Some("macro|[email protected]".to_string());
+
+ let Ingest::Insert(activities) =
+ ingest_message_event(Uuid::now_v7(), &MessageTopicEvent::Posted(posted))
+ else {
+ panic!("expected activities");
+ };
+
+ assert_eq!(activities[0].subject_id, "macro|[email protected]");
+}
+
#[test]
fn document_discussion_posts_record_no_activity() {
let event = MessageTopicEvent::Posted(posted(
diff --git a/crates/external_chat/src/inbound/router.rs b/crates/external_chat/src/inbound/router.rs
index 52a375acc8..3b8685f4d0 100644
--- a/crates/external_chat/src/inbound/router.rs
+++ b/crates/external_chat/src/inbound/router.rs
@@ -114,7 +114,9 @@ impl IntoResponse for ApiError {
/// Who is acting, from how the caller authenticated.
pub fn authority(user: &MacroUserAuthentication) -> SendAuthority {
match user.origin {
- CredentialOrigin::MacroApiJwt | CredentialOrigin::UserApiKey => SendAuthority::UserApiToken,
+ CredentialOrigin::MacroApiJwt
+ | CredentialOrigin::UserApiKey
+ | CredentialOrigin::AccountManager(_) => SendAuthority::UserApiToken,
CredentialOrigin::Session if user.agent_id.is_none() => SendAuthority::Human,
CredentialOrigin::Session
| CredentialOrigin::Bot
diff --git a/crates/external_chat/src/inbound/router/test.rs b/crates/external_chat/src/inbound/router/test.rs
index af974ff101..07dcf541fc 100644
--- a/crates/external_chat/src/inbound/router/test.rs
+++ b/crates/external_chat/src/inbound/router/test.rs
@@ -42,7 +42,7 @@ fn verified_owner_api_credentials_remain_distinct_from_sessions_and_bots() {
(CredentialOrigin::Internal, None, SendAuthority::Automation),
] {
let user = MacroUserAuthentication {
- origin,
+ origin: origin.clone(),
agent_id,
agent_via: None,
macro_user_id: "macro|[email protected]".to_string().try_into().unwrap(),
diff --git a/crates/harnesses/src/inbound/axum_router.rs b/crates/harnesses/src/inbound/axum_router.rs
index 0e67e59e4c..e4e4d290ce 100644
--- a/crates/harnesses/src/inbound/axum_router.rs
+++ b/crates/harnesses/src/inbound/axum_router.rs
@@ -11,8 +11,8 @@ use axum::{
};
use harness_id::HarnessId;
use macro_authorization::{
- HarnessOnly, MacroAuthorizationExtractor, MacroAuthorizationService, MacroAuthorizationState,
- UserOrInternal,
+ AccountHolderOrInternal, HarnessOnly, MacroAuthorizationExtractor, MacroAuthorizationService,
+ MacroAuthorizationState, UserOrInternal,
};
use model_error_response::ErrorResponse;
use serde::Serialize;
@@ -201,7 +201,7 @@ pub async fn get_pairing_handler<S: HarnessService, Auth: MacroAuthorizationServ
)]
pub async fn approve_pairing_handler<S: HarnessService, Auth: MacroAuthorizationService>(
State(state): State<HarnessesRouterState<S, Auth>>,
- authorization: MacroAuthorizationExtractor<Auth, UserOrInternal>,
+ authorization: MacroAuthorizationExtractor<Auth, AccountHolderOrInternal>,
Path(path): Path<PairingCodePath>,
Json(req): Json<ApprovePairingRequest>,
) -> Result<Json<Harness>, HarnessesHandlerErr> {
diff --git a/crates/macro_authorization/AGENTS.md b/crates/macro_authorization/AGENTS.md
index 3c5c66500a..c8505f06ef 100644
--- a/crates/macro_authorization/AGENTS.md
+++ b/crates/macro_authorization/AGENTS.md
@@ -62,6 +62,12 @@ attribution) instead of sniffing request headers. `authorize_identity` retains
verified origin and signed agent attribution on user authentication. It
does not turn a user credential into bot authority or change endpoint policies.
+An account manager's credential arrives as a normal `x-macro-user-api-key` and
+authenticates as the managed account, with `CredentialOrigin::AccountManager`
+naming the grant and the agent holding it. `AccountHolderOrInternal` is
+`UserOrInternal` minus that credential: use it on anything that mints credentials,
+changes who can sign in, deletes the account, or changes its managers.
+
## Gotchas
- Both extractors reject (400) a request that combines explicit credential
diff --git a/crates/macro_authorization/src/domain/models.rs b/crates/macro_authorization/src/domain/models.rs
index af7b9e08e5..c63af1b119 100644
--- a/crates/macro_authorization/src/domain/models.rs
+++ b/crates/macro_authorization/src/domain/models.rs
@@ -28,7 +28,7 @@ pub struct MacroUserAuthentication {
/// The kind of credential that authenticated a user, set where the credential
/// is verified. Policies that need a person's own session match on it rather
/// than on request hints.
-#[derive(Clone, Copy, Debug, Eq, PartialEq)]
+#[derive(Clone, Debug, Eq, PartialEq)]
pub enum CredentialOrigin {
/// A personal session JWT.
Session,
@@ -36,6 +36,8 @@ pub enum CredentialOrigin {
MacroApiJwt,
/// A user API key.
UserApiKey,
+ /// A manager's credential for this account, held by another account.
+ AccountManager(AccountManagerCredential),
/// The acting user of a verified bot credential.
Bot,
/// The acting user of a verified harness credential.
@@ -44,6 +46,15 @@ pub enum CredentialOrigin {
Internal,
}
+/// Who holds an account manager credential, and through which grant.
+#[derive(Clone, Debug, Eq, PartialEq)]
+pub struct AccountManagerCredential {
+ /// The grant that issued the credential.
+ pub grant_id: Uuid,
+ /// The agent account holding the credential.
+ pub manager_user_id: MacroUserIdStr<'static>,
+}
+
/// The access scope selected for a bot-authorized request.
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub enum BotScope {
@@ -239,6 +250,17 @@ pub struct ResolvedApiKeyUser {
pub fusion_user_id: String,
/// The user's organization, when present.
pub organization_id: Option<i32>,
+ /// Set when the key is an account manager's credential, not the user's own.
+ pub account_manager: Option<AccountManagerCredential>,
+}
+
+/// A user API key's owner, and the manager holding the key when it isn't theirs.
+#[derive(Clone, Debug)]
+pub struct AuthorizedUserApiKey {
+ /// The account the key acts as.
+ pub user_context: UserContext,
+ /// Set when the key is an account manager's credential, not the user's own.
+ pub account_manager: Option<AccountManagerCredential>,
}
/// Unverified acting-user claims presented by a bot.
diff --git a/crates/macro_authorization/src/domain/ports.rs b/crates/macro_authorization/src/domain/ports.rs
index 0878db8828..f7da6c6f2a 100644
--- a/crates/macro_authorization/src/domain/ports.rs
+++ b/crates/macro_authorization/src/domain/ports.rs
@@ -4,9 +4,10 @@ use model_user::UserContext;
use rootcause::Report;
use super::models::{
- BotActingUserClaims, BotAuthentication, BotScope, BotTokenAuthorization, HarnessAuthentication,
- HarnessTokenAuthorization, InternalIdentityClaims, MacroAuthorizationError, ResolvedApiKeyUser,
- ResolvedBotActingUser, ValidatedCredential, ValidatedIdentity,
+ AuthorizedUserApiKey, BotActingUserClaims, BotAuthentication, BotScope, BotTokenAuthorization,
+ HarnessAuthentication, HarnessTokenAuthorization, InternalIdentityClaims,
+ MacroAuthorizationError, ResolvedApiKeyUser, ResolvedBotActingUser, ValidatedCredential,
+ ValidatedIdentity,
};
use uuid::Uuid;
@@ -78,15 +79,21 @@ pub trait UserApiKeyAuthorizationRepo: Clone + Send + Sync + 'static {
&self,
api_key: &str,
) -> impl Future<Output = Result<Option<ResolvedApiKeyUser>, Self::Err>> + Send;
+
+ /// Record that an account manager credential was just used.
+ fn mark_account_manager_grant_used(
+ &self,
+ grant_id: Uuid,
+ ) -> impl Future<Output = Result<(), Self::Err>> + Send;
}
/// Validates user API key credentials and resolves the owner's identity.
pub trait UserApiKeyAuthorizer: Clone + Send + Sync + 'static {
- /// Authorize a user API key and return the owner's user context.
+ /// Authorize a user API key and return the account it acts as.
fn authorize_user_api_key(
&self,
api_key: &str,
- ) -> impl Future<Output = Result<UserContext, Report<MacroAuthorizationError>>> + Send;
+ ) -> impl Future<Output = Result<AuthorizedUserApiKey, Report<MacroAuthorizationError>>> + Send;
}
/// User API key authorizer used by services that do not support this credential.
@@ -97,7 +104,7 @@ impl UserApiKeyAuthorizer for NoUserApiKeyAuthorizer {
async fn authorize_user_api_key(
&self,
_api_key: &str,
- ) -> Result<UserContext, Report<MacroAuthorizationError>> {
+ ) -> Result<AuthorizedUserApiKey, Report<MacroAuthorizationError>> {
Err(Report::new(MacroAuthorizationError::InvalidCredentials))
}
}
@@ -237,14 +244,15 @@ pub trait MacroAuthorizationService: Clone + Send + Sync + 'static {
claims: InternalIdentityClaims,
) -> impl Future<Output = Result<Option<UserContext>, Report<MacroAuthorizationError>>> + Send;
- /// Authorize a user API key and return the owner's user context.
+ /// Authorize a user API key and return the account it acts as.
///
/// Services reject user API keys unless they explicitly provide a user API
/// key authorizer.
fn authorize_user_api_key(
&self,
_api_key: &str,
- ) -> impl Future<Output = Result<UserContext, Report<MacroAuthorizationError>>> + Send {
+ ) -> impl Future<Output = Result<AuthorizedUserApiKey, Report<MacroAuthorizationError>>> + Send
+ {
async { Err(Report::new(MacroAuthorizationError::InvalidCredentials)) }
}
}
diff --git a/crates/macro_authorization/src/domain/service.rs b/crates/macro_authorization/src/domain/service.rs
index 00a24290ae..87403c55ab 100644
--- a/crates/macro_authorization/src/domain/service.rs
+++ b/crates/macro_authorization/src/domain/service.rs
@@ -10,8 +10,9 @@ use tracing::Level;
use super::{
models::{
- BotActingUserClaims, BotAuthentication, BotScope, HarnessAuthentication,
- InternalAuthConfig, InternalIdentityClaims, MacroAuthorizationError, ValidatedCredential,
+ AuthorizedUserApiKey, BotActingUserClaims, BotAuthentication, BotScope,
+ HarnessAuthentication, InternalAuthConfig, InternalIdentityClaims, MacroAuthorizationError,
+ ValidatedCredential,
},
ports::{
BotAuthorizer, HarnessAuthorizer, JwtValidator, MacroAuthorizationService,
@@ -53,8 +54,13 @@ where
}
}
-type UserApiKeyAuthorizationFuture<'a> =
- Pin<Box<dyn Future<Output = Result<UserContext, Report<MacroAuthorizationError>>> + Send + 'a>>;
+type UserApiKeyAuthorizationFuture<'a> = Pin<
+ Box<
+ dyn Future<Output = Result<AuthorizedUserApiKey, Report<MacroAuthorizationError>>>
+ + Send
+ + 'a,
+ >,
+>;
trait DynUserApiKeyAuthorizer: Send + Sync {
fn authorize_user_api_key<'a>(&'a self, api_key: &'a str) -> UserApiKeyAuthorizationFuture<'a>;
@@ -210,14 +216,17 @@ where
async fn authorize_user_api_key(
&self,
api_key: &str,
- ) -> Result<UserContext, Report<MacroAuthorizationError>> {
- let user = self
+ ) -> Result<AuthorizedUserApiKey, Report<MacroAuthorizationError>> {
+ let authorized = self
.user_api_key_authorizer
.authorize_user_api_key(api_key)
.await?;
- tracing::Span::current().record("user_id", tracing::field::display(&user.user_id));
- Ok(user)
+ tracing::Span::current().record(
+ "user_id",
+ tracing::field::display(&authorized.user_context.user_id),
+ );
+ Ok(authorized)
}
#[tracing::instrument(
diff --git a/crates/macro_authorization/src/domain/service/test.rs b/crates/macro_authorization/src/domain/service/test.rs
index 0185673ebd..1f04ac5158 100644
--- a/crates/macro_authorization/src/domain/service/test.rs
+++ b/crates/macro_authorization/src/domain/service/test.rs
@@ -12,9 +12,9 @@ use uuid::Uuid;
use super::MacroAuthorizationServiceImpl;
use crate::domain::{
models::{
- BotActingUserClaims, BotAuthentication, BotScope, CredentialOrigin, InternalAuthConfig,
- InternalIdentityClaims, MacroAuthorizationError, MacroUserAuthentication,
- ValidatedCredential, ValidatedIdentity,
+ AuthorizedUserApiKey, BotActingUserClaims, BotAuthentication, BotScope, CredentialOrigin,
+ InternalAuthConfig, InternalIdentityClaims, MacroAuthorizationError,
+ MacroUserAuthentication, ValidatedCredential, ValidatedIdentity,
},
ports::{
BotAuthorizer, JwtValidator, MacroAuthorizationService, NoBotAuthorizer,
@@ -85,13 +85,19 @@ impl UserApiKeyAuthorizer for FakeUserApiKeyAuthorizer {
async fn authorize_user_api_key(
&self,
api_key: &str,
- ) -> Result<UserContext, Report<MacroAuthorizationError>> {
+ ) -> Result<AuthorizedUserApiKey, Report<MacroAuthorizationError>> {
self.calls
.lock()
.expect("calls lock poisoned")
.push(api_key.to_string());
- self.result.clone().map_err(Report::new)
+ self.result
+ .clone()
+ .map(|user_context| AuthorizedUserApiKey {
+ user_context,
+ account_manager: None,
+ })
+ .map_err(Report::new)
}
}
@@ -511,7 +517,8 @@ async fn authorize_user_api_key_delegates_the_exact_key() {
authorizer.clone(),
);
- let context = service.authorize_user_api_key("mak_secret").await.unwrap();
+ let authorized = service.authorize_user_api_key("mak_secret").await.unwrap();
+ let context = authorized.user_context;
assert_eq!(context.user_id, "macro|[email protected]");
assert_eq!(context.fusion_user_id, "fusion-api-key-user");
diff --git a/crates/macro_authorization/src/domain/user_api_key_authorizer.rs b/crates/macro_authorization/src/domain/user_api_key_authorizer.rs
index 7b825716f3..30c1e2c1c8 100644
--- a/crates/macro_authorization/src/domain/user_api_key_authorizer.rs
+++ b/crates/macro_authorization/src/domain/user_api_key_authorizer.rs
@@ -8,7 +8,7 @@ use rootcause::Report;
use tracing::Level;
use super::{
- models::{MacroAuthorizationError, ResolvedApiKeyUser},
+ models::{AuthorizedUserApiKey, MacroAuthorizationError, ResolvedApiKeyUser},
ports::{UserApiKeyAuthorizationRepo, UserApiKeyAuthorizer},
};
@@ -29,11 +29,15 @@ impl<R> UserApiKeyAuthorizer for UserApiKeyAuthorizerService<R>
where
R: UserApiKeyAuthorizationRepo,
{
- #[tracing::instrument(err(level = Level::DEBUG), skip_all)]
+ #[tracing::instrument(
+ err(level = Level::DEBUG),
+ skip_all,
+ fields(account_manager_grant_id = tracing::field::Empty)
+ )]
async fn authorize_user_api_key(
&self,
api_key: &str,
- ) -> Result<UserContext, Report<MacroAuthorizationError>> {
+ ) -> Result<AuthorizedUserApiKey, Report<MacroAuthorizationError>> {
let owner = self
.repo
.find_key_owner(api_key)
@@ -41,7 +45,21 @@ where
.map_err(|error| repository_error(error, "find key owner"))?
.ok_or_else(|| Report::new(MacroAuthorizationError::InvalidCredentials))?;
- Ok(user_context(owner))
+ if let Some(manager) = &owner.account_manager {
+ tracing::Span::current().record(
+ "account_manager_grant_id",
+ tracing::field::display(manager.grant_id),
+ );
+ self.repo
+ .mark_account_manager_grant_used(manager.grant_id)
+ .await
+ .map_err(|error| repository_error(error, "mark account manager grant used"))?;
+ }
+
+ Ok(AuthorizedUserApiKey {
+ account_manager: owner.account_manager.clone(),
+ user_context: user_context(owner),
+ })
}
}
diff --git a/crates/macro_authorization/src/domain/user_api_key_authorizer/test.rs b/crates/macro_authorization/src/domain/user_api_key_authorizer/test.rs
index 24d6f391ee..fafc6692e3 100644
--- a/crates/macro_authorization/src/domain/user_api_key_authorizer/test.rs
+++ b/crates/macro_authorization/src/domain/user_api_key_authorizer/test.rs
@@ -1,8 +1,12 @@
use std::sync::{Arc, Mutex};
use super::*;
-use crate::domain::{models::ResolvedApiKeyUser, ports::UserApiKeyAuthorizationRepo};
+use crate::domain::{
+ models::{AccountManagerCredential, ResolvedApiKeyUser},
+ ports::UserApiKeyAuthorizationRepo,
+};
use macro_user_id::user_id::MacroUserIdStr;
+use uuid::Uuid;
const API_KEY: &str = "mak_test_secret";
const USER_ID: &str = "macro|[email protected]";
@@ -19,6 +23,7 @@ struct FakeRepo {
owner: Option<ResolvedApiKeyUser>,
failure: Option<Failure>,
keys: Arc<Mutex<Vec<String>>>,
+ used_grants: Arc<Mutex<Vec<Uuid>>>,
}
impl FakeRepo {
@@ -27,6 +32,7 @@ impl FakeRepo {
owner: Some(resolved_user()),
failure: None,
keys: Arc::new(Mutex::new(Vec::new())),
+ used_grants: Arc::new(Mutex::new(Vec::new())),
}
}
@@ -35,6 +41,7 @@ impl FakeRepo {
owner: None,
failure: None,
keys: Arc::new(Mutex::new(Vec::new())),
+ used_grants: Arc::new(Mutex::new(Vec::new())),
}
}
@@ -43,6 +50,7 @@ impl FakeRepo {
owner: None,
failure: Some(Failure::FindKeyOwner),
keys: Arc::new(Mutex::new(Vec::new())),
+ used_grants: Arc::new(Mutex::new(Vec::new())),
}
}
@@ -64,6 +72,14 @@ impl UserApiKeyAuthorizationRepo for FakeRepo {
}
Ok(self.owner.clone())
}
+
+ async fn mark_account_manager_grant_used(&self, grant_id: Uuid) -> Result<(), Self::Err> {
+ self.used_grants
+ .lock()
+ .expect("used grants lock poisoned")
+ .push(grant_id);
+ Ok(())
+ }
}
fn resolved_user() -> ResolvedApiKeyUser {
@@ -71,6 +87,7 @@ fn resolved_user() -> ResolvedApiKeyUser {
macro_user_id: MacroUserIdStr::try_from(USER_ID.to_string()).expect("valid Macro user id"),
fusion_user_id: FUSION_USER_ID.to_string(),
organization_id: Some(ORGANIZATION_ID),
+ account_manager: None,
}
}
@@ -79,7 +96,9 @@ async fn found_key_constructs_user_context() {
let repo = FakeRepo::found();
let authorizer = UserApiKeyAuthorizerService::new(repo.clone());
- let context = authorizer.authorize_user_api_key(API_KEY).await.unwrap();
+ let authorized = authorizer.authorize_user_api_key(API_KEY).await.unwrap();
+ assert_eq!(authorized.account_manager, None);
+ let context = authorized.user_context;
assert_eq!(context.user_id, USER_ID);
assert_eq!(context.fusion_user_id, FUSION_USER_ID);
@@ -88,6 +107,33 @@ async fn found_key_constructs_user_context() {
assert_eq!(repo.keys(), vec![API_KEY.to_string()]);
}
+#[tokio::test]
+async fn a_manager_key_acts_as_the_managed_account_and_names_its_holder() {
+ let grant_id = Uuid::now_v7();
+ let credential = AccountManagerCredential {
+ grant_id,
+ manager_user_id: MacroUserIdStr::try_from("macro|[email protected]".to_string())
+ .expect("valid Macro user id"),
+ };
+ let mut repo = FakeRepo::found();
+ repo.owner = Some(ResolvedApiKeyUser {
+ account_manager: Some(credential.clone()),
+ ..resolved_user()
+ });
+
+ let authorized = UserApiKeyAuthorizerService::new(repo.clone())
+ .authorize_user_api_key(API_KEY)
+ .await
+ .unwrap();
+
+ assert_eq!(authorized.user_context.user_id, USER_ID);
+ assert_eq!(authorized.account_manager, Some(credential));
+ assert_eq!(
+ *repo.used_grants.lock().expect("used grants lock poisoned"),
+ vec![grant_id]
+ );
+}
+
#[tokio::test]
async fn missing_key_is_invalid_credentials() {
let error = UserApiKeyAuthorizerService::new(FakeRepo::missing())
diff --git a/crates/macro_authorization/src/inbound.rs b/crates/macro_authorization/src/inbound.rs
index bf436ea487..cbcc16d391 100644
--- a/crates/macro_authorization/src/inbound.rs
+++ b/crates/macro_authorization/src/inbound.rs
@@ -5,8 +5,8 @@ pub mod axum;
#[allow(deprecated)]
pub use axum::{
- ActingEntity, ActingUser, ActingUserAuthorization, AnyPrincipal, AuthorizationPolicy,
- BOT_FOR_FUSIONAUTH_USER_ID_HEADER, BOT_FOR_MACRO_USER_ID_HEADER,
+ AccountHolderOrInternal, ActingEntity, ActingUser, ActingUserAuthorization, AnyPrincipal,
+ AuthorizationPolicy, BOT_FOR_FUSIONAUTH_USER_ID_HEADER, BOT_FOR_MACRO_USER_ID_HEADER,
BOT_FOR_ORGANIZATION_ID_HEADER, BOT_SCOPE_HEADER, BOT_TOKEN_HEADER, BotOnly,
CODE_EXECUTION_HEADER, HARNESS_FOR_MACRO_USER_ID_HEADER, HARNESS_TOKEN_HEADER, HarnessOnly,
INTERNAL_API_KEY_HEADER, INTERNAL_FUSIONAUTH_USER_ID_HEADER,
diff --git a/crates/macro_authorization/src/inbound/axum.rs b/crates/macro_authorization/src/inbound/axum.rs
index 1841908cc9..0d302a6db3 100644
--- a/crates/macro_authorization/src/inbound/axum.rs
+++ b/crates/macro_authorization/src/inbound/axum.rs
@@ -43,9 +43,9 @@ pub use internal::{
pub use macro_authorization::MacroAuthorizationExtractor;
pub use optional::OptionalMacroAuthorizationExtractor;
pub use policy::{
- ActingUser, ActingUserAuthorization, AnyPrincipal, AuthorizationPolicy, BotOnly, HarnessOnly,
- InternalAuthorization, InternalEntity, InternalOnly, UserBotOrHarness,
- UserBotOrHarnessAuthorization, UserBotOrHarnessEntity, UserOnly, UserOrBot,
+ AccountHolderOrInternal, ActingUser, ActingUserAuthorization, AnyPrincipal,
+ AuthorizationPolicy, BotOnly, HarnessOnly, InternalAuthorization, InternalEntity, InternalOnly,
+ UserBotOrHarness, UserBotOrHarnessAuthorization, UserBotOrHarnessEntity, UserOnly, UserOrBot,
UserOrBotAuthorization, UserOrBotEntity, UserOrInternal, UserOrInternalAuthorization,
UserOrInternalCaller, UserOrInternalEntity, UserOrInternalService,
UserOrInternalServiceAuthorization,
diff --git a/crates/macro_authorization/src/inbound/axum/policy.rs b/crates/macro_authorization/src/inbound/axum/policy.rs
index f75768d63d..f2d3c2f79d 100644
--- a/crates/macro_authorization/src/inbound/axum/policy.rs
+++ b/crates/macro_authorization/src/inbound/axum/policy.rs
@@ -5,7 +5,8 @@ use bot_id::BotId;
use harness_id::HarnessId;
use crate::{
- BotAuthentication, HarnessAuthentication, MacroAuthorization, MacroUserAuthentication,
+ BotAuthentication, CredentialOrigin, HarnessAuthentication, MacroAuthorization,
+ MacroUserAuthentication,
};
use super::{ActingEntity, MacroAuthorizationRejection, rejection, status_rejection};
@@ -32,6 +33,12 @@ pub trait AuthorizationPolicy: sealed::Sealed + Send + Sync + 'static {
fn acting_entity(output: &Self::Output) -> Self::ActingEntity<'_>;
}
+/// Like [`UserOrInternal`], but refuses an account manager's credential. For
+/// endpoints that create credentials, change who can sign in, delete the
+/// account, or change its managers: a manager must not be able to outlast its
+/// own revocation.
+pub struct AccountHolderOrInternal;
+
/// Admits directly authenticated users and internal services acting for a user.
pub struct UserOrInternal;
@@ -272,6 +279,27 @@ impl AuthorizationPolicy for UserOrInternal {
}
}
+impl AuthorizationPolicy for AccountHolderOrInternal {
+ type Output = UserOrInternalAuthorization;
+ type ActingEntity<'a> = UserOrInternalEntity<'a>;
+
+ fn narrow(
+ authorization: MacroAuthorization,
+ ) -> Result<Self::Output, MacroAuthorizationRejection> {
+ if let MacroAuthorization::User(user) = &authorization
+ && matches!(user.origin, CredentialOrigin::AccountManager(_))
+ {
+ return Err(forbidden());
+ }
+
+ UserOrInternal::narrow(authorization)
+ }
+
+ fn acting_entity(output: &Self::Output) -> Self::ActingEntity<'_> {
+ UserOrInternal::acting_entity(output)
+ }
+}
+
impl AuthorizationPolicy for UserOrInternalService {
type Output = UserOrInternalServiceAuthorization;
type ActingEntity<'a> = UserOrInternalEntity<'a>;
@@ -478,6 +506,7 @@ mod sealed {
pub trait Sealed {}
impl Sealed for super::UserOrInternal {}
+ impl Sealed for super::AccountHolderOrInternal {}
impl Sealed for super::UserOrInternalService {}
impl Sealed for super::ActingUser {}
impl Sealed for super::UserOnly {}
diff --git a/crates/macro_authorization/src/inbound/axum/test.rs b/crates/macro_authorization/src/inbound/axum/test.rs
index b886d060ec..942ca8baad 100644
--- a/crates/macro_authorization/src/inbound/axum/test.rs
+++ b/crates/macro_authorization/src/inbound/axum/test.rs
@@ -20,8 +20,9 @@ use uuid::Uuid;
use super::*;
use crate::{
- BotActingUserClaims, BotAuthentication, BotScope, InternalIdentityClaims, MacroAuthorization,
- MacroAuthorizationError, MacroAuthorizationService, MacroUserAuthentication,
+ AccountManagerCredential, AuthorizedUserApiKey, BotActingUserClaims, BotAuthentication,
+ BotScope, InternalIdentityClaims, MacroAuthorization, MacroAuthorizationError,
+ MacroAuthorizationService, MacroUserAuthentication,
};
const VALID_USER_ID: &str = "macro|[email protected]";
@@ -39,6 +40,7 @@ const BOT_TEAM_ID: Uuid = Uuid::from_u128(3);
const ACCESS_TOKEN_COOKIE: &str = "macro-access-token";
const API_KEY_USER_ID: &str = "macro|[email protected]";
const VALID_USER_API_KEY: &str = "mak_valid";
+const MANAGER_API_KEY: &str = "mak_manager";
#[derive(Clone, Debug, Eq, PartialEq)]
enum AuthorizationCall {
@@ -99,14 +101,26 @@ impl MacroAuthorizationService for FakeAuthorizationService {
async fn authorize_user_api_key(
&self,
api_key: &str,
- ) -> Result<UserContext, Report<MacroAuthorizationError>> {
+ ) -> Result<AuthorizedUserApiKey, Report<MacroAuthorizationError>> {
self.calls
.lock()
.expect("calls lock poisoned")
.push(AuthorizationCall::UserApiKey(api_key.to_string()));
match api_key {
- VALID_USER_API_KEY => Ok(user_context(API_KEY_USER_ID, Some(42))),
+ VALID_USER_API_KEY => Ok(AuthorizedUserApiKey {
+ user_context: user_context(API_KEY_USER_ID, Some(42)),
+ account_manager: None,
+ }),
+ MANAGER_API_KEY => Ok(AuthorizedUserApiKey {
+ user_context: user_context(API_KEY_USER_ID, Some(42)),
+ account_manager: Some(AccountManagerCredential {
+ grant_id: Uuid::nil(),
+ manager_user_id: MacroUserIdStr::parse_from_str("macro|[email protected]")
+ .expect("valid Macro user id")
+ .into_owned(),
+ }),
+ }),
"mak_unavailable" => Err(Report::new(MacroAuthorizationError::Unavailable)),
_ => Err(Report::new(MacroAuthorizationError::InvalidCredentials)),
}
@@ -373,6 +387,10 @@ fn test_router() -> (Router, FakeAuthorizationService) {
"/required/user-or-internal",
get(policy_handler::<UserOrInternal>),
)
+ .route(
+ "/required/account-holder",
+ get(policy_handler::<AccountHolderOrInternal>),
+ )
.route(
"/required/user-or-internal-service",
get(policy_handler::<UserOrInternalService>),
@@ -1367,6 +1385,43 @@ async fn user_api_key_authenticates_as_the_user() {
);
}
+#[tokio::test]
+async fn a_manager_credential_is_refused_only_where_the_account_holder_is_required() {
+ let (router, _) = test_router();
+
+ let (status, body) = send(
+ &router,
+ empty_body(user_api_key_request(
+ "/required/account-holder",
+ MANAGER_API_KEY,
+ )),
+ )
+ .await;
+ assert_eq!(status, StatusCode::FORBIDDEN);
+ assert_eq!(body, json!({ "message": "forbidden" }));
+
+ let (status, body) = send(
+ &router,
+ empty_body(user_api_key_request(
+ "/required/user-or-internal",
+ MANAGER_API_KEY,
+ )),
+ )
+ .await;
+ assert_eq!(status, StatusCode::OK);
+ assert_eq!(body["acting_entity"], API_KEY_USER_ID);
+
+ let (status, _) = send(
+ &router,
+ empty_body(user_api_key_request(
+ "/required/account-holder",
+ VALID_USER_API_KEY,
+ )),
+ )
+ .await;
+ assert_eq!(status, StatusCode::OK);
+}
+
#[tokio::test]
async fn user_api_key_is_forbidden_for_bot_and_internal_only_policies() {
let (router, service) = test_router();
diff --git a/crates/macro_authorization/src/inbound/axum/user_api_key.rs b/crates/macro_authorization/src/inbound/axum/user_api_key.rs
index b666630bfa..7187437a71 100644
--- a/crates/macro_authorization/src/inbound/axum/user_api_key.rs
+++ b/crates/macro_authorization/src/inbound/axum/user_api_key.rs
@@ -26,13 +26,18 @@ where
{
let api_key = user_api_key(&parts.headers)?;
let authorization = MacroAuthorizationState::<Svc>::from_ref(state);
- let user_context = authorization
+ let authorized = authorization
.service
.authorize_user_api_key(&api_key)
.await
.map_err(user_api_key_authorization_rejection)?;
- authenticated_user(user_context, CredentialOrigin::UserApiKey)
+ let origin = match authorized.account_manager {
+ Some(credential) => CredentialOrigin::AccountManager(credential),
+ None => CredentialOrigin::UserApiKey,
+ };
+
+ authenticated_user(authorized.user_context, origin)
}
fn user_api_key(headers: &HeaderMap) -> Result<String, MacroAuthorizationRejection> {
diff --git a/crates/macro_authorization/src/lib.rs b/crates/macro_authorization/src/lib.rs
index d7fef097cb..3c093629dd 100644
--- a/crates/macro_authorization/src/lib.rs
+++ b/crates/macro_authorization/src/lib.rs
@@ -23,6 +23,7 @@
//! | Policy | Admitted principals | Narrowed output |
//! |---|---|---|
//! | [`UserOrInternal`] | User or internal service acting for a user | [`UserOrInternalAuthorization`] |
+//! | [`AccountHolderOrInternal`] | Same as [`UserOrInternal`], refusing an account manager's credential | [`UserOrInternalAuthorization`] |
//! | [`UserOrInternalService`] | User or internal service, with optional acting user | [`UserOrInternalServiceAuthorization`] |
//! | [`ActingUser`] | Any principal with an acting user | [`ActingUserAuthorization`] |
//! | [`UserOnly`] | Directly authenticated user | [`MacroUserAuthentication`] |
@@ -62,11 +63,12 @@ pub use domain::{
bot_authorizer::BotAuthorizerService,
harness_authorizer::HarnessAuthorizerService,
models::{
- BotActingUserClaims, BotAuthentication, BotAuthorizationOwner, BotScope,
- BotTokenAuthorization, CredentialOrigin, HarnessAuthentication, HarnessAuthorizationOwner,
- HarnessTokenAuthorization, InternalAuthConfig, InternalIdentityClaims, MacroAuthorization,
- MacroAuthorizationError, MacroUserAuthentication, ResolvedApiKeyUser,
- ResolvedBotActingUser, ValidatedCredential, ValidatedIdentity,
+ AccountManagerCredential, AuthorizedUserApiKey, BotActingUserClaims, BotAuthentication,
+ BotAuthorizationOwner, BotScope, BotTokenAuthorization, CredentialOrigin,
+ HarnessAuthentication, HarnessAuthorizationOwner, HarnessTokenAuthorization,
+ InternalAuthConfig, InternalIdentityClaims, MacroAuthorization, MacroAuthorizationError,
+ MacroUserAuthentication, ResolvedApiKeyUser, ResolvedBotActingUser, ValidatedCredential,
+ ValidatedIdentity,
},
ports::{
BotAuthorizationRepo, BotAuthorizer, HarnessAuthorizationRepo, HarnessAuthorizer,
@@ -80,8 +82,8 @@ pub use domain::{
#[allow(deprecated)]
#[cfg(feature = "axum")]
pub use inbound::{
- ActingEntity, ActingUser, ActingUserAuthorization, AnyPrincipal, AuthorizationPolicy,
- BOT_FOR_FUSIONAUTH_USER_ID_HEADER, BOT_FOR_MACRO_USER_ID_HEADER,
+ AccountHolderOrInternal, ActingEntity, ActingUser, ActingUserAuthorization, AnyPrincipal,
+ AuthorizationPolicy, BOT_FOR_FUSIONAUTH_USER_ID_HEADER, BOT_FOR_MACRO_USER_ID_HEADER,
BOT_FOR_ORGANIZATION_ID_HEADER, BOT_SCOPE_HEADER, BOT_TOKEN_HEADER, BotOnly,
CODE_EXECUTION_HEADER, HARNESS_FOR_MACRO_USER_ID_HEADER, HARNESS_TOKEN_HEADER, HarnessOnly,
INTERNAL_API_KEY_HEADER, INTERNAL_FUSIONAUTH_USER_ID_HEADER,
diff --git a/crates/macro_authorization/src/outbound/pg_user_api_key_authorization.rs b/crates/macro_authorization/src/outbound/pg_user_api_key_authorization.rs
index 5352306aa5..0e5518f798 100644
--- a/crates/macro_authorization/src/outbound/pg_user_api_key_authorization.rs
+++ b/crates/macro_authorization/src/outbound/pg_user_api_key_authorization.rs
@@ -8,7 +8,10 @@ use sha2::{Digest, Sha256};
use sqlx::PgPool;
use thiserror::Error;
-use crate::domain::{models::ResolvedApiKeyUser, ports::UserApiKeyAuthorizationRepo};
+use crate::domain::{
+ models::{AccountManagerCredential, ResolvedApiKeyUser},
+ ports::UserApiKeyAuthorizationRepo,
+};
/// SHA-256 of a raw user API key's UTF-8 bytes.
///
@@ -52,6 +55,8 @@ struct ApiKeyUserRow {
id: String,
fusion_user_id: Option<uuid::Uuid>,
organization_id: Option<i32>,
+ account_manager_grant_id: Option<uuid::Uuid>,
+ manager_user_id: Option<String>,
}
impl TryFrom<ApiKeyUserRow> for ResolvedApiKeyUser {
@@ -64,11 +69,20 @@ impl TryFrom<ApiKeyUserRow> for ResolvedApiKeyUser {
.fusion_user_id
.ok_or(PgUserApiKeyAuthorizationRepoError::InvalidUserIdentity)?
.to_string();
+ let account_manager = match (row.account_manager_grant_id, row.manager_user_id) {
+ (Some(grant_id), Some(manager_user_id)) => Some(AccountManagerCredential {
+ grant_id,
+ manager_user_id: MacroUserIdStr::try_from(manager_user_id)
+ .map_err(|_| PgUserApiKeyAuthorizationRepoError::InvalidUserIdentity)?,
+ }),
+ _ => None,
+ };
Ok(Self {
macro_user_id,
fusion_user_id,
organization_id: row.organization_id,
+ account_manager,
})
}
}
@@ -82,12 +96,25 @@ impl UserApiKeyAuthorizationRepo for PgUserApiKeyAuthorizationRepo {
ApiKeyUserRow,
r#"
SELECT
- u.id,
+ u.id AS "id!",
u.macro_user_id AS "fusion_user_id?",
- u."organizationId" AS "organization_id?"
+ u."organizationId" AS "organization_id?",
+ NULL::uuid AS "account_manager_grant_id?",
+ NULL::text AS "manager_user_id?"
FROM "UserApiKey" k
JOIN "User" u ON u.id = k.user_id
WHERE k.hash = $1
+ UNION ALL
+ SELECT
+ u.id,
+ u.macro_user_id,
+ u."organizationId",
+ g.id,
+ g.manager_user_id
+ FROM account_manager_grants g
+ JOIN "User" u ON u.id = g.managed_user_id
+ WHERE g.key_hash = $1
+ AND g.status = 'active'
"#,
&key_hash[..],
)
@@ -96,4 +123,26 @@ impl UserApiKeyAuthorizationRepo for PgUserApiKeyAuthorizationRepo {
row.map(ResolvedApiKeyUser::try_from).transpose()
}
+
+ async fn mark_account_manager_grant_used(&self, grant_id: uuid::Uuid) -> Result<(), Self::Err> {
+ // Throttled, and skips a row another request is updating, so a busy
+ // credential never queues its requests on the row lock.
+ sqlx::query!(
+ r#"
+ UPDATE account_manager_grants
+ SET last_used_at = now()
+ WHERE id = (
+ SELECT id FROM account_manager_grants
+ WHERE id = $1
+ AND (last_used_at IS NULL OR last_used_at < now() - interval '1 minute')
+ FOR UPDATE SKIP LOCKED
+ )
+ "#,
+ grant_id,
+ )
+ .execute(&self.pool)
+ .await?;
+
+ Ok(())
+ }
}
diff --git a/crates/macro_authorization/src/outbound/pg_user_api_key_authorization/test.rs b/crates/macro_authorization/src/outbound/pg_user_api_key_authorization/test.rs
index 0f079b573a..4f8b281215 100644
--- a/crates/macro_authorization/src/outbound/pg_user_api_key_authorization/test.rs
+++ b/crates/macro_authorization/src/outbound/pg_user_api_key_authorization/test.rs
@@ -74,3 +74,54 @@ async fn unknown_key_returns_none(pool: PgPool) {
assert!(repo.find_key_owner("mak_unknown").await.unwrap().is_none());
}
+
+#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]
+async fn a_manager_credential_resolves_to_the_managed_account_until_revoked(pool: PgPool) {
+ const MANAGER_KEY: &str = "mak_manager_secret";
+ const MANAGER_ID: &str = "macro|[email protected]";
+
+ insert_user_and_key(&pool, USER_ID, USER_EMAIL, API_KEY).await;
+ insert_user_and_key(
+ &pool,
+ MANAGER_ID,
+ "mak_own",
+ )
+ .await;
+ let grant_id = Uuid::now_v7();
+ sqlx::query!(
+ r#"
+ INSERT INTO account_manager_grants
+ (id, managed_user_id, manager_user_id, requested_by, status, key_hash)
+ VALUES ($1, $2, $3, 'manager', 'active', $4)
+ "#,
+ grant_id,
+ USER_ID,
+ MANAGER_ID,
+ &hash_user_api_key(MANAGER_KEY)[..],
+ )
+ .execute(&pool)
+ .await
+ .unwrap();
+ let repo = PgUserApiKeyAuthorizationRepo::new(pool.clone());
+
+ let owner = repo.find_key_owner(MANAGER_KEY).await.unwrap().unwrap();
+ let credential = owner.account_manager.unwrap();
+ assert_eq!(owner.macro_user_id.as_ref(), USER_ID);
+ assert_eq!(credential.grant_id, grant_id);
+ assert_eq!(credential.manager_user_id.as_ref(), MANAGER_ID);
+
+ let own_key = repo.find_key_owner("mak_own").await.unwrap().unwrap();
+ assert_eq!(own_key.macro_user_id.as_ref(), MANAGER_ID);
+ assert_eq!(own_key.account_manager, None);
+
+ sqlx::query!(
+ "UPDATE account_manager_grants SET status = 'revoked', key_hash = NULL WHERE id = $1",
+ grant_id,
+ )
+ .execute(&pool)
+ .await
+ .unwrap();
+
+ assert!(repo.find_key_owner(MANAGER_KEY).await.unwrap().is_none());
+}
diff --git a/crates/macro_db_client/migrations/20261104193106_account_manager_grants.sql b/crates/macro_db_client/migrations/20261104193106_account_manager_grants.sql
new file mode 100644
index 0000000000..d12d77289f
--- /dev/null
+++ b/crates/macro_db_client/migrations/20261104193106_account_manager_grants.sql
@@ -0,0 +1,41 @@
+-- An agent account's manager access to another account: the request made in a
+-- DM, its approval, and the credential it produces. The credential is stored
+-- only as a SHA-256 hash, set when the manager claims it.
+CREATE TABLE account_manager_grants (
+ id uuid PRIMARY KEY,
+ managed_user_id text NOT NULL REFERENCES "User" (id) ON DELETE CASCADE,
+ manager_user_id text NOT NULL REFERENCES "User" (id) ON DELETE CASCADE,
+ requested_by text NOT NULL CHECK (requested_by IN ('managed', 'manager')),
+ status text NOT NULL CHECK (
+ status IN ('pending', 'approved', 'declined', 'active', 'revoked', 'expired')
+ ),
+ -- When the pending request or the unclaimed approval stops being usable.
+ expires_at timestamptz,
+ key_hash bytea,
+ created_at timestamptz NOT NULL DEFAULT now(),
+ claimed_at timestamptz,
+ last_used_at timestamptz,
+ CHECK (managed_user_id <> manager_user_id),
+ CHECK ((status = 'active') = (key_hash IS NOT NULL)),
+ CHECK ((status IN ('pending', 'approved')) = (expires_at IS NOT NULL))
+);
+
+CREATE UNIQUE INDEX account_manager_grants_one_pending_per_pair
+ ON account_manager_grants (managed_user_id, manager_user_id)
+ WHERE status = 'pending';
+
+CREATE UNIQUE INDEX account_manager_grants_one_active_per_pair
+ ON account_manager_grants (managed_user_id, manager_user_id)
+ WHERE status = 'active';
+
+CREATE UNIQUE INDEX account_manager_grants_key_hash
+ ON account_manager_grants (key_hash)
+ WHERE key_hash IS NOT NULL;
+
+-- The partial pair indexes can't serve an account's list of its managers.
+CREATE INDEX account_manager_grants_managed_user_id
+ ON account_manager_grants (managed_user_id);
+
+-- Backs the cascade from the manager's "User" row.
+CREATE INDEX account_manager_grants_manager_user_id
+ ON account_manager_grants (manager_user_id);
diff --git a/crates/messages/src/domain/models.rs b/crates/messages/src/domain/models.rs
index f7816a0de1..d6ee898f5b 100644
--- a/crates/messages/src/domain/models.rs
+++ b/crates/messages/src/domain/models.rs
@@ -553,6 +553,12 @@ pub enum MessageAttribution {
/// The client's self-reported name, for display only.
client: String,
},
+ /// An account manager posted with its credential for the sender's account;
+ /// the post records the manager's account.
+ AccountManager {
+ /// The agent account holding the credential.
+ manager_user_id: String,
+ },
/// Autonomous webhook delivery has no invoking user.
Unprompted,
}
@@ -562,7 +568,7 @@ impl MessageAttribution {
pub fn has_acting_user(&self) -> bool {
match self {
Self::ActingUser | Self::ActingUserVia { .. } => true,
- Self::Unprompted => false,
+ Self::AccountManager { .. } | Self::Unprompted => false,
}
}
}
diff --git a/crates/messages/src/domain/service.rs b/crates/messages/src/domain/service.rs
index 31776bb7aa..def0d2ae19 100644
--- a/crates/messages/src/domain/service.rs
+++ b/crates/messages/src/domain/service.rs
@@ -407,16 +407,24 @@ impl<R: MessageRepository, E: MessageEventPublisher> MessageService<R, E> {
actor: actor.clone(),
guest_name: None,
kind: MessageKind::Message,
- triggered_by: access
- .acting_user_id()
- .filter(|_| actor.as_bot().is_some() && input.attribution.has_acting_user())
- .map(ToString::to_string),
+ triggered_by: match &input.attribution {
+ MessageAttribution::AccountManager { manager_user_id } => {
+ Some(manager_user_id.clone())
+ }
+ MessageAttribution::ActingUser
+ | MessageAttribution::ActingUserVia { .. }
+ | MessageAttribution::Unprompted => access
+ .acting_user_id()
+ .filter(|_| actor.as_bot().is_some() && input.attribution.has_acting_user())
+ .map(ToString::to_string),
+ },
triggered_via: match &input.attribution {
MessageAttribution::ActingUserVia { client } if actor.as_bot().is_some() => {
Some(client.clone())
}
MessageAttribution::ActingUserVia { .. }
| MessageAttribution::ActingUser
+ | MessageAttribution::AccountManager { .. }
| MessageAttribution::Unprompted => None,
},
input,
diff --git a/crates/messages/src/inbound/axum_router.rs b/crates/messages/src/inbound/axum_router.rs
index 9b17056fff..c8a4f0b67c 100644
--- a/crates/messages/src/inbound/axum_router.rs
+++ b/crates/messages/src/inbound/axum_router.rs
@@ -11,8 +11,8 @@ use entity_access::domain::{
ports::EntityAccessService,
};
use macro_authorization::{
- AnyPrincipal, MacroAuthorization, MacroAuthorizationExtractor, MacroAuthorizationService,
- MacroAuthorizationState,
+ AnyPrincipal, CredentialOrigin, MacroAuthorization, MacroAuthorizationExtractor,
+ MacroAuthorizationService, MacroAuthorizationState,
};
use serde::{Deserialize, Serialize};
use std::sync::Arc;
@@ -262,6 +262,14 @@ where
/// user drives the agent through, when the credential names one.
/// Only a user credential carries one; it is set only alongside `agent_id`.
fn sender_attribution(principal: &MacroAuthorization) -> MessageAttribution {
+ if let MacroAuthorization::User(user) = principal
+ && let CredentialOrigin::AccountManager(credential) = &user.origin
+ {
+ return MessageAttribution::AccountManager {
+ manager_user_id: credential.manager_user_id.as_ref().to_owned(),
+ };
+ }
+
let via = match principal {
MacroAuthorization::User(user) => user.agent_via.as_ref(),
MacroAuthorization::Bot(_)
diff --git a/crates/user_api_key/AGENTS.md b/crates/user_api_key/AGENTS.md
index f79ef33394..bf619110be 100644
--- a/crates/user_api_key/AGENTS.md
+++ b/crates/user_api_key/AGENTS.md
@@ -13,6 +13,9 @@ here.
(feature `postgres`); also exposes lookup-by-key for `macro_authorization`.
- `src/inbound/axum_router.rs` (feature `inbound`): HTTP routes.
+These routes refuse an account manager's credential (`AccountHolderOrInternal`),
+whose hash lives in `account_manager_grants` rather than `"UserApiKey"`.
+
## Scope
- Owns: the `"UserApiKey"` table's lifecycle.
diff --git a/crates/user_api_key/src/inbound/axum_router.rs b/crates/user_api_key/src/inbound/axum_router.rs
index d6c1468585..be954cc5b6 100644
--- a/crates/user_api_key/src/inbound/axum_router.rs
+++ b/crates/user_api_key/src/inbound/axum_router.rs
@@ -10,7 +10,8 @@ use axum::{
routing::{delete, get, post},
};
use macro_authorization::{
- MacroAuthorizationExtractor, MacroAuthorizationService, MacroAuthorizationState, UserOrInternal,
+ AccountHolderOrInternal, MacroAuthorizationExtractor, MacroAuthorizationService,
+ MacroAuthorizationState,
};
use model_error_response::ErrorResponse;
use serde::{Deserialize, Serialize};
@@ -114,7 +115,7 @@ pub struct DeleteUserApiKeyParams {
#[tracing::instrument(err, skip_all)]
pub async fn create_user_api_key_handler<S, Auth>(
State(state): State<UserApiKeyRouterState<S, Auth>>,
- user: MacroAuthorizationExtractor<Auth, UserOrInternal>,
+ user: MacroAuthorizationExtractor<Auth, AccountHolderOrInternal>,
Json(body): Json<CreateUserApiKeyRequest>,
) -> Result<(StatusCode, Json<CreatedUserApiKey>), UserApiKeyError>
where
@@ -143,7 +144,7 @@ where
#[tracing::instrument(err, skip_all)]
pub async fn list_user_api_keys_handler<S, Auth>(
State(state): State<UserApiKeyRouterState<S, Auth>>,
- user: MacroAuthorizationExtractor<Auth, UserOrInternal>,
+ user: MacroAuthorizationExtractor<Auth, AccountHolderOrInternal>,
) -> Result<Json<UserApiKeysList>, UserApiKeyError>
where
S: UserApiKeyService,
@@ -173,7 +174,7 @@ where
#[tracing::instrument(err, skip_all)]
pub async fn delete_user_api_key_handler<S, Auth>(
State(state): State<UserApiKeyRouterState<S, Auth>>,
- user: MacroAuthorizationExtractor<Auth, UserOrInternal>,
+ user: MacroAuthorizationExtractor<Auth, AccountHolderOrInternal>,
Path(params): Path<DeleteUserApiKeyParams>,
) -> Result<StatusCode, UserApiKeyError>
where
diff --git a/crates/whatsapp_linked/src/inbound/router/test/http.rs b/crates/whatsapp_linked/src/inbound/router/test/http.rs
index 753f8b221e..f7b4c9fec7 100644
--- a/crates/whatsapp_linked/src/inbound/router/test/http.rs
+++ b/crates/whatsapp_linked/src/inbound/router/test/http.rs
@@ -25,9 +25,9 @@ use external_chat::{
outbound::pg::PgExternalChatRepository,
};
use macro_authorization::{
- BotActingUserClaims, BotAuthentication, BotScope, CredentialOrigin, HarnessAuthentication,
- HarnessAuthorizationOwner, InternalIdentityClaims, MacroAuthorizationError,
- MacroUserAuthentication, ValidatedCredential, ValidatedIdentity,
+ AuthorizedUserApiKey, BotActingUserClaims, BotAuthentication, BotScope, CredentialOrigin,
+ HarnessAuthentication, HarnessAuthorizationOwner, InternalIdentityClaims,
+ MacroAuthorizationError, MacroUserAuthentication, ValidatedCredential, ValidatedIdentity,
};
use macro_db_migrator::MACRO_DB_MIGRATIONS;
use model_user::UserContext;
@@ -115,9 +115,12 @@ impl MacroAuthorizationService for Credentials {
async fn authorize_user_api_key(
&self,
api_key: &str,
- ) -> Result<UserContext, Report<MacroAuthorizationError>> {
+ ) -> Result<AuthorizedUserApiKey, Report<MacroAuthorizationError>> {
match api_key {
- ALICE_API_KEY => Ok(context(ALICE)),
+ ALICE_API_KEY => Ok(AuthorizedUserApiKey {
+ user_context: context(ALICE),
+ account_manager: None,
+ }),
_ => Err(Report::new(MacroAuthorizationError::InvalidCredentials)),
}
}
diff --git a/docs/agent-guide/channels.md b/docs/agent-guide/channels.md
index 89d1ac45ec..3ee273e279 100644
--- a/docs/agent-guide/channels.md
+++ b/docs/agent-guide/channels.md
@@ -391,6 +391,25 @@ shows the Macro bot with **from <user>**. To check this, connect an MCP client
over OAuth, ask it to post in a channel and to comment on a document, and
confirm both show the client and the user on desktop and at phone width.
+## Account manager requests
+
+A DM between a person and an agent account has an account manager button
+(user-gear icon) in the channel top bar; a DM between two agents or two people
+doesn't, because an agent can't be managed and only an agent can manage. It starts
+a request: the person asks the agent to manage their account, or the agent asks to
+manage the person's. Either way a card appears
+in the DM (`<m-account-manager-request>{"id":"<grant>"}</...>`).
+
+- The side that didn't ask gets **Approve** and **Decline**. Approve opens a
+ confirmation stating the access it gives. The side that asked gets **Withdraw**.
+- Approval posts a second card with a one-time link to
+ `/app/account-manager/<grant>`. **Reveal token** on either surface works once,
+ only for the manager, and shows the token in a dialog.
+- Requests and unclaimed approvals expire after 7 days. Revoke active access from
+ Settings → Account Managers.
+- Messages the manager sends with the token show the managed account as sender,
+ with a `from <agent>` line (`triggered_by`).
+
## Message composer
Channel messages and thread replies have a microphone next to Send on pointer
diff --git a/docs/agent-guide/settings.md b/docs/agent-guide/settings.md
index b460fea99a..f1a68590f8 100644
--- a/docs/agent-guide/settings.md
+++ b/docs/agent-guide/settings.md
@@ -229,7 +229,8 @@ page. The main page has a profile shortcut and the same grouped Team, Blocks, Pe
and Developer sections as desktop, plus enabled admin settings. Search finds
individual settings; selecting a result opens its page and reveals the section. Tap a row to open that settings
page inside the sheet; **Back to settings** returns to the grouped list at its
-previous scroll position. `API Keys` is desktop-only and has no row here.
+previous scroll position. `API Keys` is desktop-only and has no row here; `Account Managers` has one, so
+access can be revoked from a phone.
**Close settings** at the top right, Escape, an
outside tap, or a downward swipe dismisses the sheet. A tap that dismisses a
menu opened inside the sheet leaves the sheet itself open. Opening Settings again
@@ -308,7 +309,7 @@ Left nav (feature and platform gates still apply):
sidebar is hidden, **Routines** (`/app/settings/routines`) follows Agents.
- **Personal**: Account, Appearance, Notifications, Keyboard shortcuts, Usage, Billing, Desktop App, Mobile App.
- **Workspace**: Tags, Integrations (email, accounts, team Slack export, AI apps and agent tools).
-- **Developer**: Runtimes, MCP server, API Keys, Bots.
+- **Developer**: Runtimes, MCP server, API Keys, Account Managers, Bots.
**Desktop App** (`/app/settings/desktop-app`) is titled
**Desktop App (Alpha)** and shows a compact Version, Build date, and Bundle
diff --git a/docs/guides/add-http-endpoint.md b/docs/guides/add-http-endpoint.md
index 8af51bf52c..9f83cbc068 100644
--- a/docs/guides/add-http-endpoint.md
+++ b/docs/guides/add-http-endpoint.md
@@ -46,6 +46,9 @@ those in place, but new routers live in the crate.
- **Authentication:** `MacroAuthorizationExtractor<Auth, Policy>` with the
narrowest policy in `crates/macro_authorization/src/inbound/axum/policy.rs`
(`UserOnly`, `UserOrInternal`, `InternalOnly`, `UserOrBot`, ...).
+ Use `AccountHolderOrInternal` for a route that mints a credential outliving its
+ request, changes who can sign in, or deletes the account: it refuses an account
+ manager's credential.
- **Authorization: every route keyed by an entity id needs that entity's access
extractor** from `crates/entity_access/src/inbound/axum_extractors/`
(`DocumentAccessExtractor`, `ForeignEntityAccessLevelExtractor`,
diff --git a/packages/lexical-core/decoratorRegistry.ts b/packages/lexical-core/decoratorRegistry.ts
index 42f94ac06d..8a7a1b7608 100644
--- a/packages/lexical-core/decoratorRegistry.ts
+++ b/packages/lexical-core/decoratorRegistry.ts
@@ -1,4 +1,8 @@
import type { Klass, LexicalNode } from 'lexical';
+import type {
+ AccountManagerRequestDecoratorProps,
+ AccountManagerRequestNode,
+} from './nodes/AccountManagerRequestNode';
import type {
AgentActivityDecoratorProps,
AgentActivityNode,
@@ -191,6 +195,10 @@ export interface NodeDecoratorMap {
klass: typeof TagMentionNode;
props: TagMentionDecoratorProps;
};
+ AccountManagerRequestNode: {
+ klass: typeof AccountManagerRequestNode;
+ props: AccountManagerRequestDecoratorProps;
+ };
ConnectAppNode: {
klass: typeof ConnectAppNode;
props: ConnectAppDecoratorProps;
diff --git a/packages/lexical-core/index.ts b/packages/lexical-core/index.ts
index 37ce3f050f..e7ce8af082 100644
--- a/packages/lexical-core/index.ts
+++ b/packages/lexical-core/index.ts
@@ -2,6 +2,7 @@ export * from './constants';
export * from './decoratorRegistry';
export * from './domFactoryRegistry';
export * from './node-list';
+export * from './nodes/AccountManagerRequestNode';
export * from './nodes/AgentActivityNode';
export * from './nodes/AgentContextNode';
export * from './nodes/AgentSessionMentionNode';
diff --git a/packages/lexical-core/node-list.ts b/packages/lexical-core/node-list.ts
index 19de868894..a14caeff5e 100644
--- a/packages/lexical-core/node-list.ts
+++ b/packages/lexical-core/node-list.ts
@@ -13,6 +13,7 @@ import {
TabNode,
TextNode,
} from 'lexical';
+import { AccountManagerRequestNode } from './nodes/AccountManagerRequestNode';
import { AgentActivityNode } from './nodes/AgentActivityNode';
import { AgentContextNode } from './nodes/AgentContextNode';
import { AgentSessionMentionNode } from './nodes/AgentSessionMentionNode';
@@ -122,6 +123,7 @@ export const SupportedNodeTypes = [
ThemeMentionNode,
TagMentionNode,
ConnectAppNode,
+ AccountManagerRequestNode,
UnknownMentionNode,
AwaitNode,
MagicChipNode,
diff --git a/packages/lexical-core/nodes/AccountManagerRequestNode.ts b/packages/lexical-core/nodes/AccountManagerRequestNode.ts
new file mode 100644
index 0000000000..3130bc8dc4
--- /dev/null
+++ b/packages/lexical-core/nodes/AccountManagerRequestNode.ts
@@ -0,0 +1,153 @@
+import {
+ $applyNodeReplacement,
+ DecoratorNode,
+ type DOMConversionMap,
+ type EditorConfig,
+ type EditorThemeClasses,
+ type LexicalEditor,
+ type LexicalNode,
+ type NodeKey,
+ type SerializedLexicalNode,
+ type Spread,
+} from 'lexical';
+import { type DecoratorComponent, getDecorator } from '../decoratorRegistry';
+import { $applyIdFromSerialized } from '../plugins/nodeIdPlugin';
+
+const VERSION = 1;
+
+/**
+ * The tag a DM message carries for an account manager request. Mirrors the
+ * backend's `CARD_TAG`; the payload shape is `{"id": ...}`.
+ */
+export const ACCOUNT_MANAGER_REQUEST_TAG = 'm-account-manager-request';
+
+const TEXT_CONTENT = 'Account manager request';
+
+export type AccountManagerRequestInfo = {
+ /** The grant the card reads its state from. */
+ grantId: string;
+};
+
+export type SerializedAccountManagerRequestNode = Spread<
+ AccountManagerRequestInfo,
+ SerializedLexicalNode
+>;
+
+export type AccountManagerRequestDecoratorProps = AccountManagerRequestInfo & {
+ key: NodeKey;
+ theme: EditorThemeClasses;
+};
+
+const UUID_PATTERN =
+ /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+
+export function isAccountManagerGrantId(value: unknown): value is string {
+ return typeof value === 'string' && UUID_PATTERN.test(value);
+}
+
+/**
+ * The card for one account manager request. Anyone can type message markup, so
+ * the node holds only the grant id and the card reads everything it shows from
+ * the server, which answers only the two accounts involved.
+ */
+export class AccountManagerRequestNode extends DecoratorNode<
+ DecoratorComponent<AccountManagerRequestDecoratorProps> | undefined
+> {
+ __grantId: string;
+
+ static getType() {
+ return 'account-manager-request';
+ }
+
+ isInline(): boolean {
+ return true;
+ }
+
+ isKeyboardSelectable(): boolean {
+ return true;
+ }
+
+ static clone(node: AccountManagerRequestNode) {
+ return new AccountManagerRequestNode(node.__grantId, node.__key);
+ }
+
+ constructor(grantId: string, key?: NodeKey) {
+ super(key);
+ this.__grantId = grantId;
+ }
+
+ static importJSON(serializedNode: SerializedAccountManagerRequestNode) {
+ const node = $createAccountManagerRequestNode(serializedNode.grantId);
+ $applyIdFromSerialized(node, serializedNode);
+ return node;
+ }
+
+ exportJSON(): SerializedAccountManagerRequestNode {
+ return {
+ ...super.exportJSON(),
+ grantId: this.__grantId,
+ type: AccountManagerRequestNode.getType(),
+ version: VERSION,
+ };
+ }
+
+ exportComponentProps(): AccountManagerRequestInfo {
+ return { grantId: this.__grantId };
+ }
+
+ createDOM(_config: EditorConfig): HTMLElement {
+ const span = document.createElement('span');
+ span.setAttribute('data-account-manager-request', this.__grantId);
+ return span;
+ }
+
+ updateDOM(_prevNode: AccountManagerRequestNode, _dom: HTMLElement): boolean {
+ return false;
+ }
+
+ /** Nothing pastes one of these; they only arrive through the transformer. */
+ static importDOM(): DOMConversionMap<HTMLElement> | null {
+ return null;
+ }
+
+ exportDOM() {
+ const element = document.createElement('span');
+ element.setAttribute('data-account-manager-request', this.__grantId);
+ element.textContent = TEXT_CONTENT;
+ return { element };
+ }
+
+ getTextContent(): string {
+ return TEXT_CONTENT;
+ }
+
+ getGrantId(): string {
+ return this.__grantId;
+ }
+
+ decorate(_: LexicalEditor, config: EditorConfig) {
+ const decorator = getDecorator<AccountManagerRequestDecoratorProps>(
+ AccountManagerRequestNode
+ );
+ if (decorator) {
+ return () =>
+ decorator({
+ grantId: this.__grantId,
+ key: this.getKey(),
+ theme: config.theme,
+ });
+ }
+ }
+}
+
+export function $createAccountManagerRequestNode(
+ grantId: string
+): AccountManagerRequestNode {
+ return $applyNodeReplacement(new AccountManagerRequestNode(grantId));
+}
+
+export function $isAccountManagerRequestNode(
+ node: AccountManagerRequestNode | LexicalNode | null | undefined
+): node is AccountManagerRequestNode {
+ return node instanceof AccountManagerRequestNode;
+}
diff --git a/packages/lexical-core/tests/account-manager-request.test.ts b/packages/lexical-core/tests/account-manager-request.test.ts
new file mode 100644
index 0000000000..51866a4de3
--- /dev/null
+++ b/packages/lexical-core/tests/account-manager-request.test.ts
@@ -0,0 +1,74 @@
+import {
+ $convertFromMarkdownString,
+ $convertToMarkdownString,
+} from '@lexical/markdown';
+import { $getRoot, $isParagraphNode, createEditor } from 'lexical';
+import { afterAll, beforeAll, describe, expect, it, vi } from 'vitest';
+import { SupportedNodeTypes } from '../node-list';
+import { $isAccountManagerRequestNode } from '../nodes/AccountManagerRequestNode';
+import { $isUnknownMentionNode } from '../nodes/UnknownMentionNode';
+import { ALL_TRANSFORMERS } from '../transformers';
+import { markdownToEmbeddingText, markdownToPlainText } from '../utils/parsers';
+
+const GRANT_ID = '019a4f2e-7c1b-7d3a-9e2f-3b1c8d5a6f70';
+const TAG = `<m-account-manager-request>{"id":"${GRANT_ID}"}</m-account-manager-request>`;
+
+function editorWith(markdown: string) {
+ const editor = createEditor({
+ nodes: SupportedNodeTypes,
+ onError: (error) => {
+ throw error;
+ },
+ });
+ editor.update(
+ () => {
+ $convertFromMarkdownString(markdown, ALL_TRANSFORMERS);
+ },
+ { discrete: true }
+ );
+ return editor;
+}
+
+function firstInlineNode(editor: ReturnType<typeof createEditor>) {
+ return editor.getEditorState().read(() => {
+ const [paragraph] = $getRoot().getChildren();
+ if (!$isParagraphNode(paragraph)) throw new Error('expected a paragraph');
+ return paragraph.getChildren()[0];
+ });
+}
+
+describe('account manager request card', () => {
+ let consoleError: ReturnType<typeof vi.spyOn>;
+ beforeAll(() => {
+ consoleError = vi.spyOn(console, 'error').mockImplementation(() => {});
+ });
+ afterAll(() => {
+ consoleError.mockRestore();
+ });
+
+ it('round-trips the tag through a node holding only the grant id', () => {
+ const editor = editorWith(TAG);
+ const node = firstInlineNode(editor);
+
+ if (!$isAccountManagerRequestNode(node)) throw new Error('expected a card');
+ expect(node.exportComponentProps()).toEqual({ grantId: GRANT_ID });
+ expect(
+ editor
+ .getEditorState()
+ .read(() => $convertToMarkdownString(ALL_TRANSFORMERS))
+ ).toBe(TAG);
+ });
+
+ it('falls back to an unknown mention for a payload that is not a grant id', () => {
+ const editor = editorWith(
+ '<m-account-manager-request>{"id":"not-a-uuid"}</m-account-manager-request>'
+ );
+
+ expect($isUnknownMentionNode(firstInlineNode(editor))).toBe(true);
+ });
+
+ it('never leaks the payload into plain text or embeddings', () => {
+ expect(markdownToPlainText(TAG)).toBe('Account manager request');
+ expect(markdownToEmbeddingText(TAG)).toBe('Account manager request');
+ });
+});
diff --git a/packages/lexical-core/transformers/index.ts b/packages/lexical-core/transformers/index.ts
index e61a745146..3ad815ec37 100644
--- a/packages/lexical-core/transformers/index.ts
+++ b/packages/lexical-core/transformers/index.ts
@@ -27,6 +27,7 @@ import {
E_PR_MENTION,
E_TAG_MENTION,
E_USER_MENTION,
+ I_ACCOUNT_MANAGER_REQUEST,
I_AGENT_SESSION_CARD,
I_AGENT_SESSION_MENTION,
I_BOOKING_LINK_MENTION,
@@ -107,6 +108,7 @@ export const INTERNAL_TRANSFORMERS: Transformer[] = [
I_THEME_MENTION,
I_TAG_MENTION,
I_CONNECT_APP,
+ I_ACCOUNT_MANAGER_REQUEST,
I_WATERMARK,
...CUSTOM_TRANSFORMERS,
ESCAPED_AUTO_LINK,
@@ -216,6 +218,7 @@ export const ALL_TRANSFORMERS: Transformer[] = [
I_THEME_MENTION,
I_TAG_MENTION,
I_CONNECT_APP,
+ I_ACCOUNT_MANAGER_REQUEST,
I_WATERMARK,
E_WATERMARK,
E_TAG_MENTION,
diff --git a/packages/lexical-core/transformers/mentions.ts b/packages/lexical-core/transformers/mentions.ts
index 0ec907dc3d..6af167f8ec 100644
--- a/packages/lexical-core/transformers/mentions.ts
+++ b/packages/lexical-core/transformers/mentions.ts
@@ -3,6 +3,11 @@ import type {
TextMatchTransformer,
} from '@lexical/markdown';
import type { ElementNode, LexicalNode, TextNode } from 'lexical';
+import {
+ ACCOUNT_MANAGER_REQUEST_TAG,
+ AccountManagerRequestNode,
+ isAccountManagerGrantId,
+} from '../nodes/AccountManagerRequestNode';
import {
$createAgentSessionMentionNode,
AgentSessionMentionNode,
@@ -658,6 +663,40 @@ export const I_CONNECT_APP: TextMatchTransformer = {
},
};
+// Account manager request cards. The payload is only a grant id: the card reads
+// everything it shows from the server.
+export const I_ACCOUNT_MANAGER_REQUEST: TextMatchTransformer = {
+ dependencies: [AccountManagerRequestNode, UnknownMentionNode],
+ type: 'text-match',
+ regExp: new RegExp(
+ `<${ACCOUNT_MANAGER_REQUEST_TAG}>(.*?)</${ACCOUNT_MANAGER_REQUEST_TAG}>`
+ ),
+ importRegExp: new RegExp(
+ `<${ACCOUNT_MANAGER_REQUEST_TAG}>(.*?)</${ACCOUNT_MANAGER_REQUEST_TAG}>`
+ ),
+ export: (node) => {
+ if (!(node instanceof AccountManagerRequestNode)) return null;
+ const data = JSON.stringify({ id: node.getGrantId() });
+ return `<${ACCOUNT_MANAGER_REQUEST_TAG}>${data}</${ACCOUNT_MANAGER_REQUEST_TAG}>`;
+ },
+ replace: (node: TextNode, match: RegExpMatchArray) => {
+ try {
+ const parsed: unknown = JSON.parse(match[1]);
+ const id =
+ typeof parsed === 'object' && parsed !== null && 'id' in parsed
+ ? parsed.id
+ : undefined;
+ if (!isAccountManagerGrantId(id)) {
+ throw new Error('Invalid account manager request payload');
+ }
+ node.replace(new AccountManagerRequestNode(id));
+ } catch (e) {
+ console.error('Error in I_ACCOUNT_MANAGER_REQUEST replace:', e);
+ replaceTextWithUnknownMention(node, 'Account manager request');
+ }
+ },
+};
+
// Internal Tag Mentions
export const I_TAG_MENTION: TextMatchTransformer = {
dependencies: [TagMentionNode, UnknownMentionNode],
diff --git a/packages/lexical-core/utils/parsers.ts b/packages/lexical-core/utils/parsers.ts
index 339b1a894b..688624e917 100644
--- a/packages/lexical-core/utils/parsers.ts
+++ b/packages/lexical-core/utils/parsers.ts
@@ -136,6 +136,14 @@ function githubPullRequestRef(url: string): string | undefined {
return match ? `${match[1]}/${match[2]}#${match[3]}` : undefined;
}
+/** Account manager cards read as what they are; their payload is only an id. */
+export function parseAccountManagerRequests(text: string): string {
+ return text.replace(
+ /<m-account-manager-request>.*?<\/m-account-manager-request>/g,
+ 'Account manager request'
+ );
+}
+
/** `<m-connect-app>` chips read as their call to action. */
export function parseConnectApps(text: string): string {
return text.replace(/<m-connect-app>(.*?)<\/m-connect-app>/g, (_, json) => {
@@ -321,6 +329,7 @@ function flattenMarkdown(
parseAgentSessionMentions,
parseTagMentions,
parseConnectApps,
+ parseAccountManagerRequests,
parseCursorSystemNotifications,
parseDatabaseQueries,
parseSnapshots,
@@ -523,6 +532,11 @@ export function markdownToEmbeddingText(markdown: string): string {
text = replaceJsonTag(text, 'm-connect-app', (data) =>
data.name ? `Connect ${data.name}` : ''
);
+ text = replaceJsonTag(
+ text,
+ 'm-account-manager-request',
+ () => 'Account manager request'
+ );
text = replaceJsonTag(
text,
'm-db-query',
diff --git a/packages/sdk/README.md b/packages/sdk/README.md
index 55e6f00970..de8c46ed88 100644
--- a/packages/sdk/README.md
+++ b/packages/sdk/README.md
@@ -69,6 +69,27 @@ web app and uses it like any other key. It can set up its profile with
`macro.me.update({ name, profilePicture: await macro.me.uploadProfilePicture(bytes, options) })`
and mint more keys with `macro.apiKeys.create(name)`.
+#### Account managers
+
+An agent account can manage a person's account: either side asks in their DM, and
+the other side approves. An agent account can't be managed.
+
+```ts
+// As the agent, ask to manage a person's account:
+const grant = await macro.accountManagers.askToManage(person);
+// Once the person approves, the agent gets the token, once:
+const token = await grant.claimToken();
+```
+
+A person can ask instead, with `macro.accountManagers.askToBeManagedBy(agent)`. Only the
+manager can claim, so the agent approves and claims with its own client, using the grant id
+from the card in the DM: `macro.accountManagers.byId(id)`.
+
+The token is an API key for the managed account, with full access except its
+managers, API keys and other credentials, sign-in, and deleting the account. It
+lasts until either side calls `grant.revoke()`, or the managed account revokes it
+in Settings → Account Managers.
+
#### Bot token
```ts
diff --git a/packages/sdk/generated/storage/index.ts b/packages/sdk/generated/storage/index.ts
index cb8f2a0d2b..c47e6b7bd5 100644
--- a/packages/sdk/generated/storage/index.ts
+++ b/packages/sdk/generated/storage/index.ts
@@ -1,4 +1,4 @@
// This file is auto-generated by @hey-api/openapi-ts
export { type Options, Sdk } from './sdk.gen';
-export type { AccentColor, AccessiblePipeline, AccessLevel, AccessRequest, AccessRequestsCancelData, AccessRequestsCancelErrors, AccessRequestsCancelResponses, AccessRequestsDirectData, AccessRequestsDirectErrors, AccessRequestsDirectResponse, AccessRequestsDirectResponses, AccessRequestsRemoveDirectData, AccessRequestsRemoveDirectErrors, AccessRequestsRemoveDirectResponses, AccessRequestsResolveData, AccessRequestsResolveErrors, AccessRequestsResolveResponse, AccessRequestsResolveResponses, AccessRequestsSetDirectData, AccessRequestsSetDirectErrors, AccessRequestsSetDirectResponses, AccessRequestsStateData, AccessRequestsStateErrors, AccessRequestsStateResponse, AccessRequestsStateResponses, AccessRequestsSubmitData, AccessRequestsSubmitErrors, AccessRequestsSubmitResponse, AccessRequestsSubmitResponses, AccessRequestState, ActiveCallsResponse, ActiveCallSummary, ActiveMeeting, ActiveMeetingsResponse, ActivityType, AddChannelBotData, AddChannelBotError, AddChannelBotErrors, AddChannelBotRequest, AddChannelBotResponse, AddChannelBotResponses, AddFavoriteData, AddFavoriteError, AddFavoriteErrors, AddFavoriteRequest, AddFavoriteResponse, AddFavoriteResponses, AddParticipantsData, AddParticipantsError, AddParticipantsErrors, AddParticipantsRequest, AddParticipantsResponses, AddPinHandlerData, AddPinHandlerError, AddPinHandlerErrors, AddPinHandlerResponse, AddPinHandlerResponses, AddPinRequest, Agent, AgentActionId, AgentChannelScope, AgentDmProfile, AgentMcpServer, AgentMcpServers, AgentPullRequestState, AgentSessionArchiveCause, AgentSessionFilters, AgentSessionLifecycleEvent, AgentSessionSource, AgentSessionVisibility, AgentTyping, AgentTypingPhase, AiAdmissionErrorBody, Anchor, AnchorId, AnchorResponse, AnnotationIncrementalUpdate, Answer, ApiActivity, ApiAttachmentChannelReference, ApiAttachmentCommentReference, ApiAttachmentEntityReference, ApiAttachmentGenericReference, ApiChannelAttachment, ApiChannelAttachmentsPage, ApiChannelDetail, ApiChannelListMessage, ApiChannelListPage, ApiChannelListParticipant, ApiChannelListType, ApiChannelParticipant, ApiChannelWithLatest, ApiEntityFilterAst, ApiGroupByField, ApiGroupMeta, ApiParticipantListRole, ApiParticipantRole, ApiPropertyEntityType, AppliedOps, ApplyCrmPipelineOpsData, ApplyCrmPipelineOpsResponse, ApplyCrmPipelineOpsResponses, ApplyDatabaseOpsData, ApplyDatabaseOpsError, ApplyDatabaseOpsErrors, ApplyDatabaseOpsResponse, ApplyDatabaseOpsResponses, ApplyOpsRequest, ApplyOpsResponse, ApproveHarnessPairingData, ApproveHarnessPairingError, ApproveHarnessPairingErrors, ApproveHarnessPairingResponse, ApproveHarnessPairingResponses, ApprovePairingRequest, AttachmentChange, AttendeeResponseStatus, Audience, Awareness, AwarenessRelay, BasicDocument, BasicDocumentSubType, BlockCrmDomainData, BlockCrmDomainError, BlockCrmDomainErrors, BlockCrmDomainResponse, BlockCrmDomainResponses, BomPart, BookingTarget, Bot, BotChannel, BotChannelType, BotId, BotKind, BotOwner, BotOwnerProfile, BotSenderProfile, BotToken, BranchNameResponse, BTreeMap, BulkWakeupRequest, BulkWakeupResponse, BulkWakeupSyncServiceDocumentsData, BulkWakeupSyncServiceDocumentsErrors, BulkWakeupSyncServiceDocumentsResponse, BulkWakeupSyncServiceDocumentsResponses, CalendarAttendee, CalendarEvent, CalendarEventFilters, CalendarEventSourceContent, CalendarJoinRequest, CalendarJoinRequestApiError, CalendarJoinRequestErrorCode, CalendarJoinRequestsResponse, CalendarJoinRequestStatus, CalendarMentionEvent, CalendarMentionPreviewItem, CalendarMentionPreviewKind, CalendarMentionPreviewRequest, CalendarMentionPreviewRequestItem, CalendarMentionPreviewResponse, CalendarMentionViewerCopy, CalendarOccurrence, CalendarOccurrenceItem, CalendarOccurrenceResponse, CalendarSyncStatus, CallActiveResponse, CallDiscussion, CallEntryStatus, CallFilters, CallProvider, CallRecord, CallRecordGuest, CallRecordParticipant, CallRecordPreview, CallRecordPreviewData, CallRecordSource, CallRecordTranscriptSegment, CallStatus, CallTokenResponse, CallWebhookData, CallWebhookError, CallWebhookErrors, CallWebhookResponses, CancelChannelAccessRequestData, CancelChannelAccessRequestError, CancelChannelAccessRequestErrors, CancelChannelAccessRequestResponses, CancelSlackImportData, CancelSlackImportErrors, CancelSlackImportResponse, CancelSlackImportResponses, CardPosition, CastVerdict, CellValue, CellWrite, ChangedFileDto, ChangesetDto, ChangesetSourceDto, Channel, ChannelAccessDecision, ChannelAccessRequest, ChannelAccessRequestedMetadata, ChannelAccessRequestState, ChannelAccessRequestStatus, ChannelCreatedMetadata, ChannelDeletedMetadata, ChannelFilters, ChannelJoinCodeResponse, ChannelLabel, ChannelLabelRule, ChannelLabelScopeSelection, ChannelLabelsList, ChannelMessage, ChannelParticipant, ChannelParticipantAddedMetadata, ChannelParticipantRemovedMetadata, ChannelPictureChangedMetadata, ChannelPreview, ChannelPreviewData, ChannelSender, ChannelSharePermission, ChannelThreadFilters, ChannelTopicEvent, ChannelType, ChannelUpdatedMetadata, ChannelWebhookRequest, ChannelWebhookResponse, ChannelWithParticipants, Chat, ChatFilters, CheckActiveCallData, CheckActiveCallError, CheckActiveCallErrors, CheckActiveCallResponse, CheckActiveCallResponses, ClaimedPairing, ClaimHarnessPairingData, ClaimHarnessPairingError, ClaimHarnessPairingErrors, ClaimHarnessPairingResponse, ClaimHarnessPairingResponses, ClaimPairingRequest, ClientOptions, CloudStorageItemType, CollaborateFormData, CollaborateFormError, CollaborateFormErrors, CollaborateFormResponse, CollaborateFormResponses, CollabSurfaceResponse, CollabSurfaceTokenResponse, Column, ColumnCast, ColumnChange, ColumnChangeKind, ColumnConfig, ColumnConversion, ColumnConversionRequest, ColumnDetail, ColumnId, ColumnKind, ColumnProtection, ColumnResult, CommandFailure, CommandRejectedMetadata, CommittedChange, CompleteSlackImportUploadsData, CompleteSlackImportUploadsErrors, CompleteSlackImportUploadsResponse, CompleteSlackImportUploadsResponses, CompleteUploads, ConferenceProvider, Conjunction, ConversationId, ConversationKind, ConversationMetadata, ConversationProgress, ConversationSeal, ConversationStatus, ConvertDatabaseColumnData, ConvertDatabaseColumnError, ConvertDatabaseColumnErrors, ConvertDatabaseColumnResponse, ConvertDatabaseColumnResponses, ConvertedCell, CopyDocumentData, CopyDocumentError, CopyDocumentErrors, CopyDocumentQueryParams, CopyDocumentRequest, CopyDocumentResponse, CopyDocumentResponse2, CopyDocumentResponses, CountedReaction, CreateAgentData, CreateAgentError, CreateAgentErrors, CreateAgentRequest, CreateAgentResponse, CreateAgentResponses, CreateAnchorData, CreateAnchorError, CreateAnchorErrors, CreateAnchorResponse, CreateAnchorResponses, CreateBotData, CreateBotError, CreateBotErrors, CreateBotRequest, CreateBotResponse, CreateBotResponses, CreateBotTokenData, CreateBotTokenError, CreateBotTokenErrors, CreateBotTokenRequest, CreateBotTokenResponse, CreateBotTokenResponse2, CreateBotTokenResponses, CreateBulkDocumentResponse, CreateBulkDocumentResponseData, CreateCanvasDocumentRequest, CreateCanvasDocumentResponse, CreateCanvasHandlerData, CreateCanvasHandlerError, CreateCanvasHandlerErrors, CreateCanvasHandlerResponse, CreateCanvasHandlerResponses, CreateChannelData, CreateChannelError, CreateChannelErrors, CreateChannelLabelData, CreateChannelLabelError, CreateChannelLabelErrors, CreateChannelLabelRequest, CreateChannelLabelResponse, CreateChannelLabelResponses, CreateChannelRequest, CreateChannelResponse, CreateChannelResponse2, CreateChannelResponses, CreateChannelScopedBotData, CreateChannelScopedBotError, CreateChannelScopedBotErrors, CreateChannelScopedBotRequest, CreateChannelScopedBotResponse, CreateChannelScopedBotResponse2, CreateChannelScopedBotResponses, CreateCollabSurfaceTokenData, CreateCollabSurfaceTokenError, CreateCollabSurfaceTokenErrors, CreateCollabSurfaceTokenResponse, CreateCollabSurfaceTokenResponses, CreateCrmCompanyData, CreateCrmCompanyError, CreateCrmCompanyErrors, CreateCrmCompanyRequest, CreateCrmCompanyResponse, CreateCrmCompanyResponses, CreateCrmContactData, CreateCrmContactError, CreateCrmContactErrors, CreateCrmContactRequest, CreateCrmContactResponse, CreateCrmContactResponses, CreateCrmPipelineData, CreateCrmPipelineResponse, CreateCrmPipelineResponses, CreateCrmTeamContactData, CreateCrmTeamContactError, CreateCrmTeamContactErrors, CreateCrmTeamContactRequest, CreateCrmTeamContactResponse, CreateCrmTeamContactResponses, CreateDatabaseData, CreateDatabaseError, CreateDatabaseErrors, CreateDatabaseRequest, CreateDatabaseResponse, CreateDatabaseResponses, CreateDatabaseWebhookData, CreateDatabaseWebhookError, CreateDatabaseWebhookErrors, CreateDatabaseWebhookRequest, CreateDatabaseWebhookResponse, CreateDatabaseWebhookResponses, CreatedDatabaseWebhookResponse, CreateDocumentData, CreateDocumentError, CreateDocumentErrors, CreateDocumentRequest, CreateDocumentResponse, CreateDocumentResponseData, CreateDocumentResponses, CreatedPairing, CreatedUserApiKey, CreateEntityMentionData, CreateEntityMentionError, CreateEntityMentionErrors, CreateEntityMentionRequest, CreateEntityMentionResponse, CreateEntityMentionResponse2, CreateEntityMentionResponses, CreateForm, CreateFormData, CreateFormError, CreateFormErrors, CreateFormResponse, CreateFormResponses, CreateHarnessPairingData, CreateHarnessPairingError, CreateHarnessPairingErrors, CreateHarnessPairingResponse, CreateHarnessPairingResponses, CreateImport, CreateInitiativeData, CreateInitiativeError, CreateInitiativeErrors, CreateInitiativeRequest, CreateInitiativeResponse, CreateInitiativeResponses, CreateInstructionsDocumentResponse, CreateInstructionsHandlerData, CreateInstructionsHandlerError, CreateInstructionsHandlerErrors, CreateInstructionsHandlerResponse, CreateInstructionsHandlerResponses, CreateMarkdownDocumentRequest, CreateMarkdownDocumentResponse, CreateMarkdownHandlerData, CreateMarkdownHandlerError, CreateMarkdownHandlerErrors, CreateMarkdownHandlerResponse, CreateMarkdownHandlerResponses, CreateMeetingRequest, CreatePairingRequest, CreatePipeline, CreateProjectHandlerData, CreateProjectHandlerError, CreateProjectHandlerErrors, CreateProjectHandlerResponse, CreateProjectHandlerResponses, CreateProjectRequest, CreateProjectResponse, CreateSkillHandlerData, CreateSkillHandlerError, CreateSkillHandlerErrors, CreateSkillHandlerResponse, CreateSkillHandlerResponses, CreateSkillRequest, CreateSkillResponse, CreateSlackImportData, CreateSlackImportErrors, CreateSlackImportResponse, CreateSlackImportResponses, CreateSnippetHandlerData, CreateSnippetHandlerError, CreateSnippetHandlerErrors, CreateSnippetHandlerResponse, CreateSnippetHandlerResponses, CreateSnippetRequest, CreateSnippetResponse, CreateTaskHandlerData, CreateTaskHandlerError, CreateTaskHandlerErrors, CreateTaskHandlerResponse, CreateTaskHandlerResponses, CreateTaskRequest, CreateTaskResponse, CreateToken, CreateUnthreadedAnchorRequest, CreateUnthreadedAnchorResponse, CreateUnthreadedPdfAnchorRequest, CreateUserApiKeyData, CreateUserApiKeyError, CreateUserApiKeyErrors, CreateUserApiKeyRequest, CreateUserApiKeyResponse, CreateUserApiKeyResponses, CreateViewHandlerData, CreateViewHandlerError, CreateViewHandlerErrors, CreateViewHandlerResponse, CreateViewHandlerResponses, CreateViewRequest, CreateWebhookData, CreateWebhookError, CreateWebhookErrors, CreateWebhookRequest, CreateWebhookResponse, CreateWebhookResponse2, CreateWebhookResponses, CrmAssociation, CrmBlockedDomainResponse, CrmCompanyFilters, CrmCompanyResponse, CrmContactResponse, CrmDomainResponse, CrmPermissionRole, CrmStageInput, CrmStageResponse, CrmStagesResponse, CrmTeamSettingsResponse, CustomSpeakerAssignment, Database, DatabaseDetail, DatabaseId, DatabaseOp, DatabaseQueryRequest, DatabaseView, DatabaseWebhookDeliveryResponse, DatabaseWebhookPayloadProblem, DatabaseWebhookResponse, DataType, DateOperator, DateRange, DateRangeOperator, DeclineCallData, DeclineCallError, DeclineCallErrors, DeclineCallResponse, DeclineCallResponses, DeclineRingData, DeclineRingError, DeclineRingErrors, DeclineRingResponse, DeclineRingResponses, DeleteAnchorData, DeleteAnchorError, DeleteAnchorErrors, DeleteAnchorResponse, DeleteAnchorResponses, DeleteBotData, DeleteBotError, DeleteBotErrors, DeleteBotResponse, DeleteBotResponses, DeleteCallRecordData, DeleteCallRecordError, DeleteCallRecordErrors, DeleteCallRecordResponse, DeleteCallRecordResponses, DeleteChannelData, DeleteChannelError, DeleteChannelErrors, DeleteChannelLabelData, DeleteChannelLabelError, DeleteChannelLabelErrors, DeleteChannelLabelResponse, DeleteChannelLabelResponses, DeleteChannelResponse, DeleteChannelResponses, DeleteCollabSurfaceData, DeleteCollabSurfaceError, DeleteCollabSurfaceErrors, DeleteCollabSurfaceResponse, DeleteCollabSurfaceResponses, DeleteDatabaseWebhookData, DeleteDatabaseWebhookError, DeleteDatabaseWebhookErrors, DeleteDatabaseWebhookResponse, DeleteDatabaseWebhookResponses, DeleteDocumentData, DeleteDocumentError, DeleteDocumentErrors, DeleteDocumentResponse, DeleteDocumentResponses, DeleteEntityMentionData, DeleteEntityMentionError, DeleteEntityMentionErrors, DeleteEntityMentionResponse, DeleteEntityMentionResponse2, DeleteEntityMentionResponses, DeleteHarnessData, DeleteHarnessError, DeleteHarnessErrors, DeleteHarnessResponse, DeleteHarnessResponses, DeleteHistoryHandlerData, DeleteHistoryHandlerError, DeleteHistoryHandlerErrors, DeleteHistoryHandlerResponse, DeleteHistoryHandlerResponses, DeleteInitiativeData, DeleteInitiativeError, DeleteInitiativeErrors, DeleteInitiativeResponse, DeleteInitiativeResponses, DeleteProjectHandlerData, DeleteProjectHandlerError, DeleteProjectHandlerErrors, DeleteProjectHandlerResponse, DeleteProjectHandlerResponses, DeleteSelfHarnessData, DeleteSelfHarnessError, DeleteSelfHarnessErrors, DeleteSelfHarnessResponse, DeleteSelfHarnessResponses, DeleteUnthreadedAnchorRequest, DeleteUnthreadedAnchorResponse, DeleteUnthreadedPdfAnchorRequest, DeleteUserApiKeyData, DeleteUserApiKeyError, DeleteUserApiKeyErrors, DeleteUserApiKeyResponse, DeleteUserApiKeyResponses, DeleteUserDocumentViewLocationData, DeleteUserDocumentViewLocationError, DeleteUserDocumentViewLocationErrors, DeleteUserDocumentViewLocationResponse, DeleteUserDocumentViewLocationResponses, DeleteViewHandlerData, DeleteViewHandlerError, DeleteViewHandlerErrors, DeleteViewHandlerResponses, DeleteWebhookData, DeleteWebhookError, DeleteWebhookErrors, DeleteWebhookResponse, DeleteWebhookResponses, DeliverDatabaseWebhookData, DeliverDatabaseWebhookError, DeliverDatabaseWebhookErrors, DeliverDatabaseWebhookResponse, DeliverDatabaseWebhookResponses, DirectAccess, DocumentAiEdited, DocumentAiEditFailed, DocumentAiEditFailedCode, DocumentAiEditRefused, DocumentAiEditRefusedCode, DocumentAiEditRequest, DocumentBasic, DocumentContent, DocumentContentLocation, DocumentContentState, DocumentContentUploadedMetadata, DocumentCopiedMetadata, DocumentCreatedMetadata, DocumentDeletedMetadata, DocumentFilters, DocumentId, DocumentInteractionMetadata, DocumentMetadata, DocumentMetadataWithContent, DocumentPermissionsToken, DocumentPermissionsTokenRequest, DocumentPermissionsTokenResponse, DocumentPreview, DocumentPreviewData, DocumentPreviewDataSubType, DocumentPurgedMetadata, DocumentResponse, DocumentResponseMetadata, DocumentResponseMetadataWithContent, DocumentStorageServiceApiVersion, DocumentSubType, DocumentSyncContentUpdatedMetadata, DocumentSyncEditor, DocumentTeamShareResponse, DocumentTextContent, DocumentTopicEvent, DocumentUpdatedMetadata, DuplicateDatabaseData, DuplicateDatabaseError, DuplicateDatabaseErrors, DuplicateDatabaseRequest, DuplicateDatabaseResponse, DuplicateDatabaseResponses, EditAnchorData, EditAnchorError, EditAnchorErrors, EditAnchorRequest, EditAnchorResponse, EditAnchorResponse2, EditAnchorResponses, EditCallRecordData, EditCallRecordError, EditCallRecordErrors, EditCallRecordRequest, EditCallRecordResponse, EditCallRecordResponses, EditCallTranscriptData, EditCallTranscriptError, EditCallTranscriptErrors, EditCallTranscriptRequest, EditCallTranscriptResponse, EditCallTranscriptResponses, EditDocumentData, EditDocumentError, EditDocumentErrors, EditDocumentResponse, EditDocumentResponse2, EditDocumentResponses, EditDocumentServiceArgs, EditDocumentWithAiData, EditDocumentWithAiError, EditDocumentWithAiErrors, EditDocumentWithAiResponse, EditDocumentWithAiResponses, EditMyFormResponseData, EditMyFormResponseError, EditMyFormResponseErrors, EditMyFormResponseResponse, EditMyFormResponseResponses, EditPdfAnchorRequest, EditPdfPlaceableCommentAnchorRequest, EditProjectV2Data, EditProjectV2Error, EditProjectV2Errors, EditProjectV2Response, EditProjectV2Responses, EditThreadV2Data, EditThreadV2Error, EditThreadV2Errors, EditThreadV2Response, EditThreadV2Responses, EmailFilters, EmailFollowup, EmailFollowupCommand, EmailFollowupResponse, EmailReminderCondition, EmailReminderPage, EmailReminderSummary, EmptyResponse, EnsureCollabSurfaceData, EnsureCollabSurfaceError, EnsureCollabSurfaceErrors, EnsureCollabSurfaceRequest, EnsureCollabSurfaceResponse, EnsureCollabSurfaceResponses, EnsureStarterHandlerData, EnsureStarterHandlerErrors, EnsureStarterHandlerResponse, EnsureStarterHandlerResponses, EntityFilters, EntityKind, EntityMessageCreateData, EntityMessageCreateResponse, EntityMessageCreateResponses, EntityMessageDeleteMessageData, EntityMessageDeleteMessageResponse, EntityMessageDeleteMessageResponses, EntityMessageDeleteThreadData, EntityMessageDeleteThreadResponse, EntityMessageDeleteThreadResponses, EntityMessageEditData, EntityMessageEditResponse, EntityMessageEditResponses, EntityMessageGetMessageData, EntityMessageGetMessageResponse, EntityMessageGetMessageResponses, EntityMessageGetThreadData, EntityMessageGetThreadResponse, EntityMessageGetThreadResponses, EntityMessageLegacyData, EntityMessageLegacyResponse, EntityMessageLegacyResponses, EntityMessagePatchThreadData, EntityMessagePatchThreadResponse, EntityMessagePatchThreadResponses, EntityMessageReactData, EntityMessageReactResponse, EntityMessageReactResponses, EntityMessageTypingData, EntityMessageTypingResponse, EntityMessageTypingResponses, EntityPermission, EntityPermissionResponse, EntityRef, EntityReference, EntityType, ErrorResponse, EventIcsData, EventIcsErrors, EventIcsResponse, EventIcsResponses, EventReminderOverride, EventReminders, EventStatus, EventTime, EventTransparency, EventType, EventVisibility, ExcludedDefaultView, ExcludeDefaultViewHandlerData, ExcludeDefaultViewHandlerError, ExcludeDefaultViewHandlerErrors, ExcludeDefaultViewHandlerResponses, ExcludeDefaultViewRequest, ExportDocumentData, ExportDocumentError, ExportDocumentErrors, ExportDocumentResponse, ExportDocumentResponse2, ExportDocumentResponses, ExternalChatAdd, ExternalChatAddData, ExternalChatAdded, ExternalChatAddResponse, ExternalChatAddResponses, ExternalChatAttachment, ExternalChatAttachmentState, ExternalChatBackfill, ExternalChatBackfillState, ExternalChatCall, ExternalChatCallOutcome, ExternalChatCapabilities, ExternalChatCommunity, ExternalChatContactCard, ExternalChatContacts, ExternalChatData, ExternalChatDeliveryData, ExternalChatDeliveryResponse, ExternalChatDeliveryResponses, ExternalChatDeliveryState, ExternalChatDetail, ExternalChatEvent, ExternalChatKind, ExternalChatLocation, ExternalChatMediaKind, ExternalChatMediaPresentation, ExternalChatMembers, ExternalChatMention, ExternalChatMessage, ExternalChatMessageAttachments, ExternalChatMessageAttachmentsData, ExternalChatMessageAttachmentsResponse, ExternalChatMessageAttachmentsResponses, ExternalChatMessageData, ExternalChatMessageKind, ExternalChatMessageResponse, ExternalChatMessageResponses, ExternalChatMessages, ExternalChatMessagesData, ExternalChatMessagesResponse, ExternalChatMessagesResponses, ExternalChatMutation, ExternalChatParticipant, ExternalChatPermissionsData, ExternalChatPermissionsResponse, ExternalChatPermissionsResponses, ExternalChatPersonRef, ExternalChatPoll, ExternalChatPollOption, ExternalChatProvider, ExternalChatReaction, ExternalChatReadData, ExternalChatReadResponse, ExternalChatReadResponses, ExternalChatReference, ExternalChatRemoveData, ExternalChatRemoveResponse, ExternalChatRemoveResponses, ExternalChatReplyBlock, ExternalChatReplyContent, ExternalChatResponse, ExternalChatResponses, ExternalChatRichContent, ExternalChatsData, ExternalChatSendData, ExternalChatSender, ExternalChatSendErrors, ExternalChatSendProgress, ExternalChatSendReply, ExternalChatSendResponse, ExternalChatSendResponses, ExternalChatSendsData, ExternalChatSendsResponse, ExternalChatSendsResponses, ExternalChatsResponse, ExternalChatsResponses, ExternalChatSummary, ExternalChatSystemAction, ExternalChatSystemLine, ExternalChatUpdatePermissionsData, ExternalChatUpdatePermissionsResponse, ExternalChatUpdatePermissionsResponses, ExternalChatUploadData, ExternalChatUploadedAttachment, ExternalChatUploadRequest, ExternalChatUploadResponse, ExternalChatUploadResponses, Favorite, FavoriteEntityRef, FavoritesList, FileChangeKindDto, FileSystemNodeWithIds, FileType, FileTypeUpdate, FilterCondition, FilterGroup, FilterNode, FilterTest, FinalizeSlackImportData, FinalizeSlackImportErrors, FinalizeSlackImportResponse, FinalizeSlackImportResponses, FolderItem, FollowupState, ForeignEntity, ForeignEntityFilters, Form, FormAccess, FormBranding, FormCollaboration, FormDetail, FormErrorCode, FormErrorResponse, FormLayout, FormPublicationProblem, FormQuestionDetail, FormResponse, FormSection, FormSectionDetail, FormSource, FormStatus, FormTally, Formula, GenericErrorResponse, GenericResponse, GenericSuccessResponse, GetActiveCallsData, GetActiveCallsError, GetActiveCallsErrors, GetActiveCallsResponse, GetActiveCallsResponses, GetActivityData, GetActivityError, GetActivityErrors, GetActivityResponse, GetActivityResponses, GetAttachmentReferencesData, GetAttachmentReferencesError, GetAttachmentReferencesErrors, GetAttachmentReferencesResponse, GetAttachmentReferencesResponse2, GetAttachmentReferencesResponses, GetBatchCallRecordPreviewData, GetBatchCallRecordPreviewError, GetBatchCallRecordPreviewErrors, GetBatchCallRecordPreviewRequest, GetBatchCallRecordPreviewResponse, GetBatchCallRecordPreviewResponse2, GetBatchCallRecordPreviewResponses, GetBatchChannelPreviewData, GetBatchChannelPreviewError, GetBatchChannelPreviewErrors, GetBatchChannelPreviewRequest, GetBatchChannelPreviewResponse, GetBatchChannelPreviewResponse2, GetBatchChannelPreviewResponses, GetBatchPreviewHandlerData, GetBatchPreviewHandlerError, GetBatchPreviewHandlerErrors, GetBatchPreviewHandlerResponse, GetBatchPreviewHandlerResponses, GetBatchPreviewRequest, GetBatchPreviewResponse, GetBatchProjectPreviewData, GetBatchProjectPreviewError, GetBatchProjectPreviewErrors, GetBatchProjectPreviewRequest, GetBatchProjectPreviewResponse, GetBatchProjectPreviewResponse2, GetBatchProjectPreviewResponses, GetBotData, GetBotError, GetBotErrors, GetBotOwnerProfilesData, GetBotOwnerProfilesError, GetBotOwnerProfilesErrors, GetBotOwnerProfilesResponse, GetBotOwnerProfilesResponses, GetBotResponse, GetBotResponses, GetCallRecordData, GetCallRecordError, GetCallRecordErrors, GetCallRecordResponse, GetCallRecordResponses, GetChannelAccessRequestData, GetChannelAccessRequestError, GetChannelAccessRequestErrors, GetChannelAccessRequestResponse, GetChannelAccessRequestResponses, GetChannelAttachmentsData, GetChannelAttachmentsError, GetChannelAttachmentsErrors, GetChannelAttachmentsResponse, GetChannelAttachmentsResponses, GetChannelData, GetChannelError, GetChannelErrors, GetChannelJoinLinkData, GetChannelJoinLinkError, GetChannelJoinLinkErrors, GetChannelJoinLinkResponse, GetChannelJoinLinkResponses, GetChannelParticipantsData, GetChannelParticipantsError, GetChannelParticipantsErrors, GetChannelParticipantsResponse, GetChannelParticipantsResponses, GetChannelResponse, GetChannelResponses, GetChannelsData, GetChannelsError, GetChannelsErrors, GetChannelsResponse, GetChannelsResponses, GetCollabSurfaceData, GetCollabSurfaceError, GetCollabSurfaceErrors, GetCollabSurfaceResponse, GetCollabSurfaceResponses, GetCompanyData, GetCompanyError, GetCompanyErrors, GetCompanyResponse, GetCompanyResponses, GetContactByEmailData, GetContactByEmailError, GetContactByEmailErrors, GetContactByEmailResponse, GetContactByEmailResponse2, GetContactByEmailResponses, GetContactData, GetContactError, GetContactErrors, GetContactResponse, GetContactResponses, GetCrmPipelineData, GetCrmPipelinePermissionsData, GetCrmPipelinePermissionsResponse, GetCrmPipelinePermissionsResponses, GetCrmPipelineResponse, GetCrmPipelineResponses, GetCrmPipelineRowsData, GetCrmPipelineRowsResponse, GetCrmPipelineRowsResponses, GetCrmPipelineStageRequirementsData, GetCrmPipelineStageRequirementsResponse, GetCrmPipelineStageRequirementsResponses, GetCrmPipelineTableData, GetCrmPipelineTableResponse, GetCrmPipelineTableResponses, GetCrmPipelineViewPositionsData, GetCrmPipelineViewPositionsResponse, GetCrmPipelineViewPositionsResponses, GetCrmTeamSettingsData, GetCrmTeamSettingsError, GetCrmTeamSettingsErrors, GetCrmTeamSettingsResponse, GetCrmTeamSettingsResponses, GetDatabaseData, GetDatabaseError, GetDatabaseErrors, GetDatabasePermissionsData, GetDatabasePermissionsError, GetDatabasePermissionsErrors, GetDatabasePermissionsResponse, GetDatabasePermissionsResponses, GetDatabaseQueryData, GetDatabaseQueryError, GetDatabaseQueryErrors, GetDatabaseQueryResponse, GetDatabaseQueryResponses, GetDatabaseResponse, GetDatabaseResponses, GetDatabaseRowHistoryData, GetDatabaseRowHistoryError, GetDatabaseRowHistoryErrors, GetDatabaseRowHistoryResponse, GetDatabaseRowHistoryResponses, GetDatabaseTableChangesData, GetDatabaseTableChangesError, GetDatabaseTableChangesErrors, GetDatabaseTableChangesResponse, GetDatabaseTableChangesResponses, GetDatabaseViewPositionsData, GetDatabaseViewPositionsError, GetDatabaseViewPositionsErrors, GetDatabaseViewPositionsResponse, GetDatabaseViewPositionsResponses, GetDocumentAnchorsData, GetDocumentAnchorsError, GetDocumentAnchorsErrors, GetDocumentAnchorsResponse, GetDocumentAnchorsResponses, GetDocumentBranchNameData, GetDocumentBranchNameError, GetDocumentBranchNameErrors, GetDocumentBranchNameResponse, GetDocumentBranchNameResponses, GetDocumentByTeamSlugData, GetDocumentByTeamSlugError, GetDocumentByTeamSlugErrors, GetDocumentByTeamSlugResponse, GetDocumentByTeamSlugResponses, GetDocumentData, GetDocumentError, GetDocumentErrors, GetDocumentGithubPullRequestsData, GetDocumentGithubPullRequestsError, GetDocumentGithubPullRequestsErrors, GetDocumentGithubPullRequestsResponse, GetDocumentGithubPullRequestsResponses, GetDocumentKeyResponse, GetDocumentKeyResponseData, GetDocumentListHandlerData, GetDocumentListHandlerError, GetDocumentListHandlerErrors, GetDocumentListHandlerResponse, GetDocumentListHandlerResponses, GetDocumentListResult, GetDocumentLocationV3Data, GetDocumentLocationV3Error, GetDocumentLocationV3Errors, GetDocumentLocationV3Response, GetDocumentLocationV3Responses, GetDocumentPermissionsResponseDataV2, GetDocumentPermissionsTokenData, GetDocumentPermissionsTokenError, GetDocumentPermissionsTokenErrors, GetDocumentPermissionsTokenResponse, GetDocumentPermissionsTokenResponses, GetDocumentPermissionsV2Data, GetDocumentPermissionsV2Error, GetDocumentPermissionsV2Errors, GetDocumentPermissionsV2Response, GetDocumentPermissionsV2Responses, GetDocumentProcessingResult, GetDocumentProcessingResultData, GetDocumentProcessingResultError, GetDocumentProcessingResultErrors, GetDocumentProcessingResultResponse, GetDocumentProcessingResultResponse2, GetDocumentProcessingResultResponses, GetDocumentResponse, GetDocumentResponse2, GetDocumentResponseData, GetDocumentResponses, GetDocumentSearchResponse, GetDocumentShortIdData, GetDocumentShortIdError, GetDocumentShortIdErrors, GetDocumentShortIdResponse, GetDocumentShortIdResponses, GetDocumentsResponse, GetDocumentTeamShareData, GetDocumentTeamShareError, GetDocumentTeamShareErrors, GetDocumentTeamShareResponse, GetDocumentTeamShareResponses, GetDocumentTextContentData, GetDocumentTextContentErrors, GetDocumentTextContentResponse, GetDocumentTextContentResponses, GetDocumentUserAccessLevelResponse, GetDocumentVersionData, GetDocumentVersionError, GetDocumentVersionErrors, GetDocumentVersionResponse, GetDocumentVersionResponses, GetDocumentViewsHandlerData, GetDocumentViewsHandlerError, GetDocumentViewsHandlerErrors, GetDocumentViewsHandlerResponse, GetDocumentViewsHandlerResponses, GetEmailFollowupData, GetEmailFollowupError, GetEmailFollowupErrors, GetEmailFollowupResponse, GetEmailFollowupResponses, GetEntityPermissionData, GetEntityPermissionErrors, GetEntityPermissionResponse, GetEntityPermissionResponses, GetForeignEntityBySourceData, GetForeignEntityBySourceError, GetForeignEntityBySourceErrors, GetForeignEntityBySourceResponse, GetForeignEntityBySourceResponses, GetForeignEntityData, GetForeignEntityError, GetForeignEntityErrors, GetForeignEntityResponse, GetForeignEntityResponses, GetFormData, GetFormError, GetFormErrors, GetFormPermissionsData, GetFormPermissionsError, GetFormPermissionsErrors, GetFormPermissionsResponse, GetFormPermissionsResponses, GetFormResponse, GetFormResponses, GetFormResponseSummaryData, GetFormResponseSummaryError, GetFormResponseSummaryErrors, GetFormResponseSummaryResponse, GetFormResponseSummaryResponses, GetFormTallyData, GetFormTallyError, GetFormTallyErrors, GetFormTallyResponse, GetFormTallyResponses, GetGithubPullRequestChangesData, GetGithubPullRequestChangesError, GetGithubPullRequestChangesErrors, GetGithubPullRequestChangesPatchData, GetGithubPullRequestChangesPatchError, GetGithubPullRequestChangesPatchErrors, GetGithubPullRequestChangesPatchResponse, GetGithubPullRequestChangesPatchResponses, GetGithubPullRequestChangesResponse, GetGithubPullRequestChangesResponses, GetGithubPullRequestData, GetGithubPullRequestError, GetGithubPullRequestErrors, GetGithubPullRequestFacetsData, GetGithubPullRequestFacetsError, GetGithubPullRequestFacetsErrors, GetGithubPullRequestFacetsResponse, GetGithubPullRequestFacetsResponses, GetGithubPullRequestResponse, GetGithubPullRequestResponses, GetGithubPullRequestTasksData, GetGithubPullRequestTasksError, GetGithubPullRequestTasksErrors, GetGithubPullRequestTasksResponse, GetGithubPullRequestTasksResponses, GetHarnessPairingData, GetHarnessPairingError, GetHarnessPairingErrors, GetHarnessPairingResponse, GetHarnessPairingResponses, GetHistoryHandlerData, GetHistoryHandlerError, GetHistoryHandlerErrors, GetHistoryHandlerResponse, GetHistoryHandlerResponses, GetInitiativeData, GetInitiativeError, GetInitiativeErrors, GetInitiativeResponse, GetInitiativeResponses, GetInstructionsDocumentResponse, GetInstructionsHandlerData, GetInstructionsHandlerError, GetInstructionsHandlerErrors, GetInstructionsHandlerResponse, GetInstructionsHandlerResponses, GetItemsSoupData, GetItemsSoupError, GetItemsSoupErrors, GetItemsSoupResponse, GetItemsSoupResponses, GetLocationHandlerData, GetLocationHandlerError, GetLocationHandlerErrors, GetLocationHandlerResponse, GetLocationHandlerResponses, GetMyChannelAccessRequestData, GetMyChannelAccessRequestError, GetMyChannelAccessRequestErrors, GetMyChannelAccessRequestResponse, GetMyChannelAccessRequestResponses, GetMyFormResponseData, GetMyFormResponseError, GetMyFormResponseErrors, GetMyFormResponseResponse, GetMyFormResponseResponses, GetOrCreateAction, GetOrCreateCallData, GetOrCreateCallError, GetOrCreateCallErrors, GetOrCreateCallResponse, GetOrCreateCallResponses, GetOrCreateChannelResponse, GetOrCreateDmData, GetOrCreateDmError, GetOrCreateDmErrors, GetOrCreateDmRequest, GetOrCreateDmResponse, GetOrCreateDmResponses, GetOrCreatePrivateData, GetOrCreatePrivateError, GetOrCreatePrivateErrors, GetOrCreatePrivateRequest, GetOrCreatePrivateResponse, GetOrCreatePrivateResponses, GetPendingProjectsHandlerData, GetPendingProjectsHandlerError, GetPendingProjectsHandlerErrors, GetPendingProjectsHandlerResponse, GetPendingProjectsHandlerResponses, GetPinsHandlerData, GetPinsHandlerError, GetPinsHandlerErrors, GetPinsHandlerResponse, GetPinsHandlerResponses, GetPinsResponse, GetProjectContentHandlerData, GetProjectContentHandlerError, GetProjectContentHandlerErrors, GetProjectContentHandlerResponse, GetProjectContentHandlerResponses, GetProjectContentResponse, GetProjectHandlerData, GetProjectHandlerError, GetProjectHandlerErrors, GetProjectHandlerResponse, GetProjectHandlerResponses, GetProjectPermissionsV2Data, GetProjectPermissionsV2Error, GetProjectPermissionsV2Errors, GetProjectPermissionsV2Response, GetProjectPermissionsV2Responses, GetProjectResponse, GetProjectResponseData, GetProjectsHandlerData, GetProjectsHandlerError, GetProjectsHandlerErrors, GetProjectsHandlerResponse, GetProjectsHandlerResponses, GetProjectsResponse, GetProjectUserAccessLevelData, GetProjectUserAccessLevelError, GetProjectUserAccessLevelErrors, GetProjectUserAccessLevelResponse, GetProjectUserAccessLevelResponses, GetRingStatusData, GetRingStatusError, GetRingStatusErrors, GetRingStatusResponse, GetRingStatusResponses, GetSelfBotData, GetSelfBotError, GetSelfBotErrors, GetSelfBotResponse, GetSelfBotResponses, GetSelfHarnessData, GetSelfHarnessError, GetSelfHarnessErrors, GetSelfHarnessResponse, GetSelfHarnessResponses, GetSkillDescriptionData, GetSkillDescriptionError, GetSkillDescriptionErrors, GetSkillDescriptionResponse, GetSkillDescriptionResponses, GetSlackImportData, GetSlackImportErrors, GetSlackImportResponse, GetSlackImportResponses, GetSystemSkillsHandlerData, GetSystemSkillsHandlerError, GetSystemSkillsHandlerErrors, GetSystemSkillsHandlerResponse, GetSystemSkillsHandlerResponses, GetUserDocumentsHandlerData, GetUserDocumentsHandlerError, GetUserDocumentsHandlerErrors, GetUserDocumentsHandlerResponse, GetUserDocumentsHandlerResponses, GetUserDocumentViewLocationData, GetUserDocumentViewLocationError, GetUserDocumentViewLocationErrors, GetUserDocumentViewLocationResponse, GetUserDocumentViewLocationResponses, GetUserHistoryResponse, GetViewsHandlerData, GetViewsHandlerError, GetViewsHandlerErrors, GetViewsHandlerResponse, GetViewsHandlerResponses, GetWebhookData, GetWebhookError, GetWebhookErrors, GetWebhookResponse, GetWebhookResponses, GithubLabelFacet, GithubPullRequest, GithubPullRequestChangesPatchResponse, GithubPullRequestChangesResponse, GithubPullRequestCheckRun, GithubPullRequestComment, GithubPullRequestFacets, GithubPullRequestLabel, GithubPullRequestReview, GithubPullRequestReviewDecision, GithubPullRequestReviewState, GithubPullRequestsResponse, GithubPullRequestTasks, GithubPullRequestTasksRequest, GithubPullRequestTasksResponse, GithubPullRequestUser, GithubRepositoryFacet, GithubUserFacet, GitRefDto, GroupedInitialParams, GroupedPageParams, GroupedSoupGroupPage, GroupedSoupInitialPage, GroupedSoupPage, GroupedSoupSort, GuestCallChatPostData, GuestCallChatPostErrors, GuestCallChatPostResponse, GuestCallChatPostResponses, GuestCallChatReadData, GuestCallChatReadErrors, GuestCallChatReadResponse, GuestCallChatReadResponses, GuestChatMessage, GuestChatPage, GuestChatPost, GuestId, GuestJoinRequest, GuestPolicy, HandlerData, HandlerError, HandlerErrors, HandlerResponse, HandlerResponses, Harness, HarnessAgent, HarnessId, HarnessOwner, HarnessSession, HashMap, HealthHandlerData, HealthHandlerResponse, HealthHandlerResponses, HighlightType, ImportCounters, ImportDatabaseTableData, ImportDatabaseTableError, ImportDatabaseTableErrors, ImportDatabaseTableResponse, ImportDatabaseTableResponses, ImportedAuthor, ImportError, ImportLimits, ImportPage, ImportProgress, ImportTable, ImportWarning, InferColumnTypeOutcome, InferColumnTypeRequest, InferDatabaseColumnTypeData, InferDatabaseColumnTypeError, InferDatabaseColumnTypeErrors, InferDatabaseColumnTypeResponse, InferDatabaseColumnTypeResponses, InFlightTurnSummary, IngestTranscriptData, IngestTranscriptError, IngestTranscriptErrors, IngestTranscriptResponses, InitializeUserDocumentsData, InitializeUserDocumentsError, InitializeUserDocumentsErrors, InitializeUserDocumentsResponse, InitializeUserDocumentsResponses, InitialPropertyValue, InitiativeDetail, InitiativeFilters, InitiativeId, InitiativeList, InitiativeSummary, InputReceivedMetadata, InstallSyncData, InstallSyncErrors, InteractionReason, InvalidDatabaseWebhookPayloadResponse, InviteMeetingRequest, InviteMeetingUsersRequest, Item, ItemWithUserAccessLevel, JobId, JobProcessingResultHandlerData, JobProcessingResultHandlerError, JobProcessingResultHandlerErrors, JobProcessingResultHandlerResponse, JobProcessingResultHandlerResponses, JobStatus, JoinChannelByCodeData, JoinChannelByCodeError, JoinChannelByCodeErrors, JoinChannelByCodeResponses, JoinChannelData, JoinChannelError, JoinChannelErrors, JoinChannelResponses, KeySegment, Lane, LaneKey, LatestMessage, LayoutProblem, LeaveCallResponse, LeaveChannelData, LeaveChannelError, LeaveChannelErrors, LeaveChannelResponses, LeaveOrEndCallData, LeaveOrEndCallError, LeaveOrEndCallErrors, LeaveOrEndCallResponse, LeaveOrEndCallResponses, LinkShare, ListAccessibleFormsData, ListAccessibleFormsError, ListAccessibleFormsErrors, ListAccessibleFormsResponse, ListAccessibleFormsResponses, ListAgentsData, ListAgentsError, ListAgentsErrors, ListAgentsResponse, ListAgentsResponses, ListBotChannelsData, ListBotChannelsError, ListBotChannelsErrors, ListBotChannelsResponse, ListBotChannelsResponses, ListBotsData, ListBotsError, ListBotsErrors, ListBotsResponse, ListBotsResponses, ListBotTokensData, ListBotTokensError, ListBotTokensErrors, ListBotTokensResponse, ListBotTokensResponses, ListChannelBotsData, ListChannelBotsError, ListChannelBotsErrors, ListChannelBotsResponse, ListChannelBotsResponses, ListChannelLabelsData, ListChannelLabelsError, ListChannelLabelsErrors, ListChannelLabelsResponse, ListChannelLabelsResponses, ListCompanyContactsData, ListCompanyContactsError, ListCompanyContactsErrors, ListCompanyContactsResponse, ListCompanyContactsResponses, ListCrmBlockedDomainsData, ListCrmBlockedDomainsError, ListCrmBlockedDomainsErrors, ListCrmBlockedDomainsResponse, ListCrmBlockedDomainsResponses, ListCrmPipelinesData, ListCrmPipelinesResponse, ListCrmPipelinesResponses, ListDatabaseColumnCastsData, ListDatabaseColumnCastsError, ListDatabaseColumnCastsErrors, ListDatabaseColumnCastsResponse, ListDatabaseColumnCastsResponses, ListDatabasesData, ListDatabasesError, ListDatabasesErrors, ListDatabasesResponse, ListDatabasesResponses, ListDatabaseWebhooksData, ListDatabaseWebhooksError, ListDatabaseWebhooksErrors, ListDatabaseWebhooksResponse, ListDatabaseWebhooksResponse2, ListDatabaseWebhooksResponses, ListedDatabase, ListedForm, ListEmailRemindersData, ListEmailRemindersError, ListEmailRemindersErrors, ListEmailRemindersResponse, ListEmailRemindersResponses, ListFavoritesData, ListFavoritesError, ListFavoritesErrors, ListFavoritesResponse, ListFavoritesResponses, ListFormsData, ListFormsError, ListFormsErrors, ListFormsResponse, ListFormsResponses, ListHarnessAgentsData, ListHarnessAgentsError, ListHarnessAgentsErrors, ListHarnessAgentsResponse, ListHarnessAgentsResponses, ListHarnessesData, ListHarnessesError, ListHarnessesErrors, ListHarnessesResponse, ListHarnessesResponses, ListHarnessSessionsData, ListHarnessSessionsError, ListHarnessSessionsErrors, ListHarnessSessionsResponse, ListHarnessSessionsResponses, ListInitiativesData, ListInitiativesError, ListInitiativesErrors, ListInitiativesResponse, ListInitiativesResponses, ListJoinRequestsData, ListJoinRequestsError, ListJoinRequestsErrors, ListJoinRequestsResponse, ListJoinRequestsResponses, ListOccurrencesData, ListOccurrencesErrors, ListOccurrencesResponse, ListOccurrencesResponses, ListSlackImportsData, ListSlackImportsResponse, ListSlackImportsResponses, ListTeamCalendarData, ListTeamCalendarResponse, ListTeamCalendarResponses, ListTeamOutOfOfficeData, ListTeamOutOfOfficeErrors, ListTeamOutOfOfficeResponse, ListTeamOutOfOfficeResponses, ListUserApiKeysData, ListUserApiKeysError, ListUserApiKeysErrors, ListUserApiKeysResponse, ListUserApiKeysResponses, ListWebhooksData, ListWebhooksError, ListWebhooksErrors, ListWebhooksResponse, ListWebhooksResponse2, ListWebhooksResponses, LocationResponseData, LocationResponseV3, MacroUserIdStr, MarkRead, Meeting, MeetingCancelData, MeetingCancelError, MeetingCancelErrors, MeetingCancelPreparationData, MeetingCancelPreparationError, MeetingCancelPreparationErrors, MeetingCancelPreparationResponse, MeetingCancelPreparationResponses, MeetingCancelResponse, MeetingCancelResponses, MeetingCreateData, MeetingCreateError, MeetingCreateErrors, MeetingCreateResponse, MeetingCreateResponses, MeetingGuestJoinData, MeetingGuestJoinError, MeetingGuestJoinErrors, MeetingGuestJoinResponse, MeetingGuestJoinResponses, MeetingGuestParticipantsData, MeetingGuestParticipantsError, MeetingGuestParticipantsErrors, MeetingGuestParticipantsResponse, MeetingGuestParticipantsResponses, MeetingInviteData, MeetingInviteError, MeetingInviteErrors, MeetingInvitePermissions, MeetingInvitePermissionsData, MeetingInvitePermissionsError, MeetingInvitePermissionsErrors, MeetingInvitePermissionsResponse, MeetingInvitePermissionsResponses, MeetingInviteResponse, MeetingInviteResponses, MeetingInviteUsersData, MeetingInviteUsersError, MeetingInviteUsersErrors, MeetingInviteUsersResponse, MeetingInviteUsersResponses, MeetingJoinData, MeetingJoinError, MeetingJoinErrors, MeetingJoinResponse, MeetingJoinResponses, MeetingLeaveData, MeetingLeaveError, MeetingLeaveErrors, MeetingLeaveResponse, MeetingLeaveResponses, MeetingListActiveData, MeetingListActiveError, MeetingListActiveErrors, MeetingListActiveResponse, MeetingListActiveResponses, MeetingListData, MeetingListError, MeetingListErrors, MeetingListResponse, MeetingListResponses, MeetingLookupData, MeetingLookupError, MeetingLookupErrors, MeetingLookupResponse, MeetingLookupResponses, MeetingParticipant, MeetingParticipants, MeetingParticipantsData, MeetingParticipantsError, MeetingParticipantsErrors, MeetingParticipantsResponse, MeetingParticipantsResponses, MeetingPreparation, MeetingPrepareData, MeetingPrepareError, MeetingPrepareErrors, MeetingPrepareResponse, MeetingPrepareResponses, MeetingShareData, MeetingShareError, MeetingShareErrors, MeetingShareResponse, MeetingShareResponses, MeetingsResponse, MeetingToken, MeetingUpdateData, MeetingUpdateError, MeetingUpdateErrors, MeetingUpdateResponse, MeetingUpdateResponses, MentionPreviewsData, MentionPreviewsErrors, MentionPreviewsResponse, MentionPreviewsResponses, Message, MessageAttachment, MessageAttachmentCreatedMetadata, MessageAttachmentRemovedMetadata, MessageChange, MessageCursor, MessageDeletedMetadata, MessageDirection, MessageEvent, MessageEventAttachment, MessageKind, MessageListItem, MessageMentionedMetadata, MessagePage, MessageParent, MessagePatch, MessagePatchedMetadata, MessagePostedMetadata, MessageThread, MessageThreadPreview, MessageTimelineData, MessageTimelineEntriesData, MessageTimelineEntriesResponse, MessageTimelineEntriesResponses, MessageTimelineEntry, MessageTimelinePage, MessageTimelineQuery, MessageTimelineResponse, MessageTimelineResponses, MessageTopicEvent, MyResponse, NewAttachment, NewColumn, NewOption, NewThreadAnchor, NewView, NotificationFilters, NotificationState, NumberOperator, OpBatch, Operator, OpRefusalResponse, OpResult, OptionId, OptionRef, PairingDetails, Params, ParticipantRole, PatchBotData, PatchBotError, PatchBotErrors, PatchBotRequest, PatchBotResponse, PatchBotResponses, PatchChannelData, PatchChannelError, PatchChannelErrors, PatchChannelRequest, PatchChannelResponse, PatchChannelResponses, PatchHarnessData, PatchHarnessError, PatchHarnessErrors, PatchHarnessRequest, PatchHarnessResponse, PatchHarnessResponses, PatchMessageNotificationPolicy, PatchProjectRequestV2, PatchThreadRequestV2, PatchViewHandlerData, PatchViewHandlerError, PatchViewHandlerErrors, PatchViewHandlerResponses, PatchWebhookData, PatchWebhookError, PatchWebhookErrors, PatchWebhookRequest, PatchWebhookResponse, PatchWebhookResponses, PdfAnchor, PdfAnchorId, PdfHighlightAnchor, PdfHighlightAnchorRequest, PdfHighlightRect, PdfHighlightRectAnchorRequest, PdfPlaceableCommentAnchor, PendingClaimResponse, PermanentlyDeleteDocumentData, PermanentlyDeleteDocumentError, PermanentlyDeleteDocumentErrors, PermanentlyDeleteDocumentResponse, PermanentlyDeleteDocumentResponses, PermanentlyDeleteProjectData, PermanentlyDeleteProjectError, PermanentlyDeleteProjectErrors, PermanentlyDeleteProjectResponse, PermanentlyDeleteProjectResponses, PinnedItem, PinRequest, Pipeline, PipelineRecordType, PipelineSharing, PostActivityData, PostActivityError, PostActivityErrors, PostActivityRequest, PostActivityResponse, PostActivityResponses, PostChannelBotWebhookData, PostChannelBotWebhookError, PostChannelBotWebhookErrors, PostChannelBotWebhookResponse, PostChannelBotWebhookResponses, PostGroupedSoupAstGroupPageRequest, PostGroupedSoupAstInitialRequest, PostGroupedSoupAstRequest, PostItemsSoupAstData, PostItemsSoupAstError, PostItemsSoupAstErrors, PostItemsSoupAstGroupedData, PostItemsSoupAstGroupedError, PostItemsSoupAstGroupedErrors, PostItemsSoupAstGroupedResponse, PostItemsSoupAstGroupedResponses, PostItemsSoupAstResponse, PostItemsSoupAstResponses, PostItemsSoupData, PostItemsSoupError, PostItemsSoupErrors, PostItemsSoupResponse, PostItemsSoupResponses, PostMessage, PostMessageNotificationPolicy, PostSoupAstRequest, PostSoupRequest, PresaveDocumentHandlerData, PresaveDocumentHandlerError, PresaveDocumentHandlerErrors, PresaveDocumentHandlerResponse, PresaveDocumentHandlerResponses, PreSaveDocumentRequest, PreSaveDocumentResponse, PreSaveDocumentResponseData, PresenceOperator, PresignedUrl, PreviewSmartTagData, PreviewSmartTagError, PreviewSmartTagErrors, PreviewSmartTagResponse, PreviewSmartTagResponses, Project, ProjectDeleteResponseData, ProjectDocumentStatus, ProjectFilters, ProjectPreview, ProjectPreviewData, PropertyBucketing, PropertyDateFilterRange, PropertyDateRange, PropertyDateRanges, PropertyDefinition, PropertyDefinitionWithOptions, PropertyFilter, PropertyInput, PropertyOption, PropertyOptionValue, PropertyOwner, PropertyValue, PutCrmTeamSettingsData, PutCrmTeamSettingsError, PutCrmTeamSettingsErrors, PutCrmTeamSettingsResponse, PutCrmTeamSettingsResponses, PutCrmTeamStagesData, PutCrmTeamStagesError, PutCrmTeamStagesErrors, PutCrmTeamStagesResponse, PutCrmTeamStagesResponses, PutFormLayoutData, PutFormLayoutError, PutFormLayoutErrors, PutFormLayoutResponse, PutFormLayoutResponses, QueryCrmPipelineRowsData, QueryCrmPipelineRowsResponse, QueryCrmPipelineRowsResponses, QueryDatabasesData, QueryDatabasesError, QueryDatabasesErrors, QueryDatabasesResponse, QueryDatabasesResponses, QueryDefinition, QuestionLayout, QuestionOption, QuestionTally, ReactionInput, RecentlyDeletedData, RecentlyDeletedError, RecentlyDeletedErrors, RecentlyDeletedResponse, RecentlyDeletedResponseData, RecentlyDeletedResponses, RegisterSlackImportUploadsData, RegisterSlackImportUploadsErrors, RegisterSlackImportUploadsResponse, RegisterSlackImportUploadsResponses, RegisterUploads, RemoveBotFromChannelByBotData, RemoveBotFromChannelByBotError, RemoveBotFromChannelByBotErrors, RemoveBotFromChannelByBotResponse, RemoveBotFromChannelByBotResponses, RemoveFavoriteByEntityData, RemoveFavoriteByEntityError, RemoveFavoriteByEntityErrors, RemoveFavoriteByEntityResponses, RemoveParticipantsData, RemoveParticipantsError, RemoveParticipantsErrors, RemoveParticipantsRequest, RemoveParticipantsResponses, RemovePinHandlerData, RemovePinHandlerError, RemovePinHandlerErrors, RemovePinHandlerResponse, RemovePinHandlerResponses, RenameChannelLabelData, RenameChannelLabelError, RenameChannelLabelErrors, RenameChannelLabelRequest, RenameChannelLabelResponse, RenameChannelLabelResponses, RenameCrmPipelineData, RenameCrmPipelineResponse, RenameCrmPipelineResponses, RenamePipeline, ReorderFavoritesData, ReorderFavoritesError, ReorderFavoritesErrors, ReorderFavoritesRequest, ReorderFavoritesResponses, ReorderPinRequest, ReorderPinsHandlerData, ReorderPinsHandlerError, ReorderPinsHandlerErrors, ReorderPinsHandlerResponse, ReorderPinsHandlerResponses, ReplaceCrmStagesRequest, RequestAccess, RequestChannelAccessData, RequestChannelAccessError, RequestChannelAccessErrors, RequestChannelAccessResponse, RequestChannelAccessResponses, RequestedLayout, RequestStatus, RequestToJoinData, RequestToJoinError, RequestToJoinErrors, RequestToJoinResponse, RequestToJoinResponses, ResetCrmTeamStagesData, ResetCrmTeamStagesError, ResetCrmTeamStagesErrors, ResetCrmTeamStagesResponse, ResetCrmTeamStagesResponses, ResolveChannelAccessRequest, ResolveChannelAccessRequestData, ResolveChannelAccessRequestError, ResolveChannelAccessRequestErrors, ResolveChannelAccessRequestResponse, ResolveChannelAccessRequestResponses, ResolveRequest, ResponseStatus, ResponseSummary, ResultColumn, ResultSet, RevertDeleteDocumentData, RevertDeleteDocumentError, RevertDeleteDocumentErrors, RevertDeleteDocumentResponse, RevertDeleteDocumentResponses, RevertDeleteProjectData, RevertDeleteProjectError, RevertDeleteProjectErrors, RevertDeleteProjectResponse, RevertDeleteProjectResponses, RevokeBotTokenData, RevokeBotTokenError, RevokeBotTokenErrors, RevokeBotTokenResponse, RevokeBotTokenResponses, RingStatus, RingStatusResponse, RowChange, RowChangeKind, RowChanges, RowHistoryEntry, RowHistoryResponse, RowId, RowsChange, RowsResult, S3ObjectInfo, SaveBomPart, SaveDatabaseQueryData, SaveDatabaseQueryError, SaveDatabaseQueryErrors, SaveDatabaseQueryResponse, SaveDatabaseQueryResponses, SaveDocumentHandlerData, SaveDocumentHandlerError, SaveDocumentHandlerErrors, SaveDocumentHandlerResponse, SaveDocumentHandlerResponses, SaveDocumentRequest, SaveDocumentResponse, SaveDocumentResponseData, SavedQuery, SaveQueryRequest, SearchContactsData, SearchContactsError, SearchContactsErrors, SearchContactsResponse, SearchContactsResponse2, SearchContactsResponses, SearchState, SectionCount, SessionDeletedMetadata, SessionIdentity, SessionMentionedMetadata, SessionOpenedMetadata, SessionRenamedMetadata, SessionSettledMetadata, SessionSource, SessionStoppedMetadata, SetChannelLabelData, SetChannelLabelError, SetChannelLabelErrors, SetChannelLabelRequest, SetChannelLabelResponse, SetChannelLabelResponses, SetChannelPictureData, SetChannelPictureError, SetChannelPictureErrors, SetChannelPictureRequest, SetChannelPictureResponse, SetChannelPictureResponses, SetCompanyHiddenData, SetCompanyHiddenError, SetCompanyHiddenErrors, SetCompanyHiddenRequest, SetCompanyHiddenResponse, SetCompanyHiddenResponses, SetCompanyNameRequest, SetContactHiddenData, SetContactHiddenError, SetContactHiddenErrors, SetContactHiddenRequest, SetContactHiddenResponse, SetContactHiddenResponses, SetContactNameRequest, SetCrmCompanyNameData, SetCrmCompanyNameError, SetCrmCompanyNameErrors, SetCrmCompanyNameResponse, SetCrmCompanyNameResponses, SetCrmContactNameData, SetCrmContactNameError, SetCrmContactNameErrors, SetCrmContactNameResponse, SetCrmContactNameResponses, SetCrmPipelineStageRequirementData, SetCrmPipelineStageRequirementResponse, SetCrmPipelineStageRequirementResponses, SetDirectAccess, SetDocumentTeamShareData, SetDocumentTeamShareError, SetDocumentTeamShareErrors, SetDocumentTeamShareRequest, SetDocumentTeamShareResponse, SetDocumentTeamShareResponses, SetEmailFollowupData, SetEmailFollowupError, SetEmailFollowupErrors, SetEmailFollowupResponse, SetEmailFollowupResponses, SetEmailSyncData, SetEmailSyncError, SetEmailSyncErrors, SetEmailSyncRequest, SetEmailSyncResponse, SetEmailSyncResponses, SetOperator, SetPropertyValue, SetSkillDescriptionData, SetSkillDescriptionError, SetSkillDescriptionErrors, SetSkillDescriptionRequest, SetSkillDescriptionResponse, SetSkillDescriptionResponses, Sha256Digest, ShareCrmPipelineData, ShareCrmPipelineResponse, ShareCrmPipelineResponses, ShareDatabaseAwarenessData, ShareDatabaseAwarenessError, ShareDatabaseAwarenessErrors, ShareDatabaseAwarenessResponse, ShareDatabaseAwarenessResponses, SharedEmailFilter, SharedExternalChatReference, ShareEntity, ShareEntityType, SharePermissionV2, SharePipeline, ShortIdResponse, SimpleMention, SimpleSaveData, SimpleSaveError, SimpleSaveErrors, SimpleSaveResponse, SimpleSaveResponses, SkillDescriptionBody, SkippedCell, SlackCompleteRequest, SlackCreateRequest, SlackRegisterRequest, SlackTimestamp, SlackUserId, SmartTagChannelMatch, SmartTagPreview, SortDirection, SortKey, SoupAgentSessionSoupPropertiesField, SoupApiItem, SoupApiSort, SoupApiSortDirection, SoupAttachment, SoupCalendarEventSoupPropertiesField, SoupCalendarEventTime, SoupCallRecordGuest, SoupCallRecordParticipant, SoupCallRecordSoupPropertiesField, SoupChannel, SoupChannelThread, SoupChatSoupPropertiesField, SoupContact, SoupCountedReaction, SoupCrmCompanySoupPropertiesField, SoupCrmContactSoupPropertiesField, SoupCrmDomain, SoupDatabaseRowSoupPropertiesField, SoupDocumentSoupPropertiesField, SoupDocumentSubType, SoupEmailThreadPreview, SoupEnrichedEmailThreadPreviewSoupPropertiesField, SoupForeignEntity, SoupInitiativeSoupPropertiesField, SoupItem, SoupLabel, SoupLabelListVisibility, SoupLabelType, SoupMessageAttachment, SoupMessageListVisibility, SoupMessageSender, SoupMessageSenderType, SoupPage, SoupProjectSoupPropertiesField, SoupPropertiesField, SoupProperty, SoupThreadInfo, SoupThreadReply, SourceBinding, SourceId, SourceIdentity, SqlCell, SqlEntityKind, SqlOutcome, SqlOutcomeKind, SqlSelectOption, SqlStatement, StageRequirement, StarterDatabase, StarterDocumentsResponse, StorageRow, StorageRows, StorageRowsQuery, StoredGithubPullRequest, StreamEventsData, StreamEventsError, StreamEventsErrors, StreamEventsResponse, StreamEventsResponses, String, Submission, SubmissionOutcome, SubmitFormResponseData, SubmitFormResponseError, SubmitFormResponseErrors, SubmitFormResponseResponse, SubmitFormResponseResponses, SuccessResponse, SurfaceState, SyncServiceVersionId, SystemSkillSummary, Table, TableChange, TableChanged, TableChanges, TableDetail, TableId, TableResult, TableVersion, TagFilterMode, TakenId, TallyBucket, TallyValue, TaskFilters, TaskSimilarityResult, TaskSimilaritySearchHandlerData, TaskSimilaritySearchHandlerError, TaskSimilaritySearchHandlerErrors, TaskSimilaritySearchHandlerResponse, TaskSimilaritySearchHandlerResponses, TaskSimilaritySearchRequest, TaskSimilaritySearchResponse, TeamCalendarContent, TeamCalendarCoverage, TeamCalendarDetails, TeamCalendarItem, TeamCalendarMember, TeamCalendarPage, TeamCalendarSharing, TeamOutOfOfficeItem, TeamOutOfOfficeResponse, TeamRole, TextOperator, ThreadAnchor, ThreadOrigin, ThreadPatch, ThreadState, TimelineActivity, ToggleShareWithTeamData, ToggleShareWithTeamError, ToggleShareWithTeamErrors, ToggleShareWithTeamResponse, ToggleShareWithTeamResponses, TouchedColumn, TouchedRow, TranscribeDictationData, TranscribeDictationError, TranscribeDictationErrors, TranscribeDictationResponse, TranscribeDictationResponses, TranscribeResponse, TranscriptSegmentRequest, TrashCrmPipelineData, TrashCrmPipelineResponse, TrashCrmPipelineResponses, TrashPipeline, TurnEndedMetadata, TurnStartedMetadata, TurnSummary, TypedSuccessResponse, TypedSuccessResponseGetDocumentResponseData, TypingInput, UnblockCrmDomainData, UnblockCrmDomainError, UnblockCrmDomainErrors, UnblockCrmDomainResponse, UnblockCrmDomainResponses, UndoChangeResponse, UndoDatabaseChangeData, UndoDatabaseChangeError, UndoDatabaseChangeErrors, UndoDatabaseChangeResponse, UndoDatabaseChangeResponses, UndoOutcome, UndoRefusal, UnlockedBooking, UpdateAgentData, UpdateAgentError, UpdateAgentErrors, UpdateAgentRequest, UpdateAgentResponse, UpdateAgentResponses, UpdateChannelSharePermission, UpdateCrmPipelinePermissionsData, UpdateCrmPipelinePermissionsResponse, UpdateCrmPipelinePermissionsResponses, UpdateCrmTeamSettingsRequest, UpdateDatabasePermissionsData, UpdateDatabasePermissionsError, UpdateDatabasePermissionsErrors, UpdateDatabasePermissionsResponse, UpdateDatabasePermissionsResponses, UpdateForm, UpdateFormData, UpdateFormError, UpdateFormErrors, UpdateFormPermissionsData, UpdateFormPermissionsError, UpdateFormPermissionsErrors, UpdateFormPermissionsResponse, UpdateFormPermissionsResponses, UpdateFormResponse, UpdateFormResponses, UpdateInitiativeData, UpdateInitiativeError, UpdateInitiativeErrors, UpdateInitiativeRequest, UpdateInitiativeResponse, UpdateInitiativeResponses, UpdateMeetingRequest, UpdateOperation, UpdateSharePermissionRequestV2, UploadDescriptor, UploadDocumentStatus, UploadExtractFolderHandlerData, UploadExtractFolderHandlerError, UploadExtractFolderHandlerErrors, UploadExtractFolderHandlerResponse, UploadExtractFolderHandlerResponses, UploadExtractFolderRequest, UploadFileData, UploadFileError, UploadFileErrors, UploadFileResponse, UploadFileResponse2, UploadFileResponses, UploadFolderHandlerData, UploadFolderHandlerError, UploadFolderHandlerErrors, UploadFolderHandlerResponse, UploadFolderHandlerResponses, UploadFolderRequest, UploadGrant, UploadId, UpsertHistoryHandlerData, UpsertHistoryHandlerError, UpsertHistoryHandlerErrors, UpsertHistoryHandlerResponse, UpsertHistoryHandlerResponses, UpsertUserDocumentViewLocationData, UpsertUserDocumentViewLocationError, UpsertUserDocumentViewLocationErrors, UpsertUserDocumentViewLocationRequest, UpsertUserDocumentViewLocationResponse, UpsertUserDocumentViewLocationResponses, UserApiKeyId, UserApiKeyInfo, UserApiKeysList, UserDocumentsResponse, UserDocumentViewLocation, UserDocumentViewLocationResponse, UserPinsResponse, UserViewsResponse, ValidateDocumentPermissionsTokenData, ValidateDocumentPermissionsTokenError, ValidateDocumentPermissionsTokenErrors, ValidateDocumentPermissionsTokenResponse, ValidateDocumentPermissionsTokenResponses, ValidateWebhookData, ValidateWebhookError, ValidateWebhookErrors, ValidateWebhookResponse, ValidateWebhookResponse2, ValidateWebhookResponses, Vec, VersionedTable, View, ViewChange, ViewColumn, ViewerCapabilities, ViewLayout, ViewPatch, ViewPosition, ViewPositionsResponse, ViewQuery, ViewResult, ViewsResponse, WaitingForInputMetadata, Webhook, WebhookEvent, WebhookFilter, WebhookScope, WebhookStatus, WebhookValidationTestEvent, WhatsAppAccount, WhatsappAccountData, WhatsappAccountResponse, WhatsappAccountResponses, WhatsAppAccountState, WhatsAppAccountView, WhatsappCancelPairingData, WhatsappCancelPairingResponse, WhatsappCancelPairingResponses, WhatsAppCannotAdd, WhatsAppChat, WhatsAppChats, WhatsappChatsData, WhatsappChatsResponse, WhatsappChatsResponses, WhatsAppConnect, WhatsappConnectData, WhatsappConnectResponse, WhatsappConnectResponses, WhatsAppDisconnect, WhatsappDisconnectData, WhatsAppDisconnectRequest, WhatsappDisconnectResponse, WhatsappDisconnectResponses, WhatsAppHistoryImport, WhatsappImportHistoryData, WhatsappImportHistoryResponse, WhatsappImportHistoryResponses, WhatsAppLookup, WhatsappLookupData, WhatsAppLookupRequest, WhatsappLookupResponse, WhatsappLookupResponses, WhatsAppLookupState, WhatsAppPairing, WhatsappPairingData, WhatsappPairingResponse, WhatsappPairingResponses, WhatsAppPairingState, WhatsAppPairState, WhatsappPasskeyData, WhatsappPasskeyResponse, WhatsappPasskeyResponses, WhatsappStartLookupData, WhatsappStartLookupResponse, WhatsappStartLookupResponses, Widget, WithCallId, WithChannelId, WithDocumentId, WithProjectId } from './types.gen';
+export type { AccentColor, AccessiblePipeline, AccessLevel, AccessRequest, AccessRequestsCancelData, AccessRequestsCancelErrors, AccessRequestsCancelResponses, AccessRequestsDirectData, AccessRequestsDirectErrors, AccessRequestsDirectResponse, AccessRequestsDirectResponses, AccessRequestsRemoveDirectData, AccessRequestsRemoveDirectErrors, AccessRequestsRemoveDirectResponses, AccessRequestsResolveData, AccessRequestsResolveErrors, AccessRequestsResolveResponse, AccessRequestsResolveResponses, AccessRequestsSetDirectData, AccessRequestsSetDirectErrors, AccessRequestsSetDirectResponses, AccessRequestsStateData, AccessRequestsStateErrors, AccessRequestsStateResponse, AccessRequestsStateResponses, AccessRequestsSubmitData, AccessRequestsSubmitErrors, AccessRequestsSubmitResponse, AccessRequestsSubmitResponses, AccessRequestState, AccountManagerDecision, AccountManagerGrant, AccountManagerGrantStatus, AccountManagerRole, AccountManagersList, ActiveCallsResponse, ActiveCallSummary, ActiveMeeting, ActiveMeetingsResponse, ActivityType, AddChannelBotData, AddChannelBotError, AddChannelBotErrors, AddChannelBotRequest, AddChannelBotResponse, AddChannelBotResponses, AddFavoriteData, AddFavoriteError, AddFavoriteErrors, AddFavoriteRequest, AddFavoriteResponse, AddFavoriteResponses, AddParticipantsData, AddParticipantsError, AddParticipantsErrors, AddParticipantsRequest, AddParticipantsResponses, AddPinHandlerData, AddPinHandlerError, AddPinHandlerErrors, AddPinHandlerResponse, AddPinHandlerResponses, AddPinRequest, Agent, AgentActionId, AgentChannelScope, AgentDmProfile, AgentMcpServer, AgentMcpServers, AgentPullRequestState, AgentSessionArchiveCause, AgentSessionFilters, AgentSessionLifecycleEvent, AgentSessionSource, AgentSessionVisibility, AgentTyping, AgentTypingPhase, AiAdmissionErrorBody, Anchor, AnchorId, AnchorResponse, AnnotationIncrementalUpdate, Answer, ApiActivity, ApiAttachmentChannelReference, ApiAttachmentCommentReference, ApiAttachmentEntityReference, ApiAttachmentGenericReference, ApiChannelAttachment, ApiChannelAttachmentsPage, ApiChannelDetail, ApiChannelListMessage, ApiChannelListPage, ApiChannelListParticipant, ApiChannelListType, ApiChannelParticipant, ApiChannelWithLatest, ApiEntityFilterAst, ApiGroupByField, ApiGroupMeta, ApiParticipantListRole, ApiParticipantRole, ApiPropertyEntityType, AppliedOps, ApplyCrmPipelineOpsData, ApplyCrmPipelineOpsResponse, ApplyCrmPipelineOpsResponses, ApplyDatabaseOpsData, ApplyDatabaseOpsError, ApplyDatabaseOpsErrors, ApplyDatabaseOpsResponse, ApplyDatabaseOpsResponses, ApplyOpsRequest, ApplyOpsResponse, ApproveHarnessPairingData, ApproveHarnessPairingError, ApproveHarnessPairingErrors, ApproveHarnessPairingResponse, ApproveHarnessPairingResponses, ApprovePairingRequest, AttachmentChange, AttendeeResponseStatus, Audience, Awareness, AwarenessRelay, BasicDocument, BasicDocumentSubType, BlockCrmDomainData, BlockCrmDomainError, BlockCrmDomainErrors, BlockCrmDomainResponse, BlockCrmDomainResponses, BomPart, BookingTarget, Bot, BotChannel, BotChannelType, BotId, BotKind, BotOwner, BotOwnerProfile, BotSenderProfile, BotToken, BranchNameResponse, BTreeMap, BulkWakeupRequest, BulkWakeupResponse, BulkWakeupSyncServiceDocumentsData, BulkWakeupSyncServiceDocumentsErrors, BulkWakeupSyncServiceDocumentsResponse, BulkWakeupSyncServiceDocumentsResponses, CalendarAttendee, CalendarEvent, CalendarEventFilters, CalendarEventSourceContent, CalendarJoinRequest, CalendarJoinRequestApiError, CalendarJoinRequestErrorCode, CalendarJoinRequestsResponse, CalendarJoinRequestStatus, CalendarMentionEvent, CalendarMentionPreviewItem, CalendarMentionPreviewKind, CalendarMentionPreviewRequest, CalendarMentionPreviewRequestItem, CalendarMentionPreviewResponse, CalendarMentionViewerCopy, CalendarOccurrence, CalendarOccurrenceItem, CalendarOccurrenceResponse, CalendarSyncStatus, CallActiveResponse, CallDiscussion, CallEntryStatus, CallFilters, CallProvider, CallRecord, CallRecordGuest, CallRecordParticipant, CallRecordPreview, CallRecordPreviewData, CallRecordSource, CallRecordTranscriptSegment, CallStatus, CallTokenResponse, CallWebhookData, CallWebhookError, CallWebhookErrors, CallWebhookResponses, CancelChannelAccessRequestData, CancelChannelAccessRequestError, CancelChannelAccessRequestErrors, CancelChannelAccessRequestResponses, CancelSlackImportData, CancelSlackImportErrors, CancelSlackImportResponse, CancelSlackImportResponses, CardPosition, CastVerdict, CellValue, CellWrite, ChangedFileDto, ChangesetDto, ChangesetSourceDto, Channel, ChannelAccessDecision, ChannelAccessRequest, ChannelAccessRequestedMetadata, ChannelAccessRequestState, ChannelAccessRequestStatus, ChannelCreatedMetadata, ChannelDeletedMetadata, ChannelFilters, ChannelJoinCodeResponse, ChannelLabel, ChannelLabelRule, ChannelLabelScopeSelection, ChannelLabelsList, ChannelMessage, ChannelParticipant, ChannelParticipantAddedMetadata, ChannelParticipantRemovedMetadata, ChannelPictureChangedMetadata, ChannelPreview, ChannelPreviewData, ChannelSender, ChannelSharePermission, ChannelThreadFilters, ChannelTopicEvent, ChannelType, ChannelUpdatedMetadata, ChannelWebhookRequest, ChannelWebhookResponse, ChannelWithParticipants, Chat, ChatFilters, CheckActiveCallData, CheckActiveCallError, CheckActiveCallErrors, CheckActiveCallResponse, CheckActiveCallResponses, ClaimAccountManagerTokenData, ClaimAccountManagerTokenError, ClaimAccountManagerTokenErrors, ClaimAccountManagerTokenResponse, ClaimAccountManagerTokenResponses, ClaimedAccountManagerToken, ClaimedPairing, ClaimHarnessPairingData, ClaimHarnessPairingError, ClaimHarnessPairingErrors, ClaimHarnessPairingResponse, ClaimHarnessPairingResponses, ClaimPairingRequest, ClientOptions, CloudStorageItemType, CollaborateFormData, CollaborateFormError, CollaborateFormErrors, CollaborateFormResponse, CollaborateFormResponses, CollabSurfaceResponse, CollabSurfaceTokenResponse, Column, ColumnCast, ColumnChange, ColumnChangeKind, ColumnConfig, ColumnConversion, ColumnConversionRequest, ColumnDetail, ColumnId, ColumnKind, ColumnProtection, ColumnResult, CommandFailure, CommandRejectedMetadata, CommittedChange, CompleteSlackImportUploadsData, CompleteSlackImportUploadsErrors, CompleteSlackImportUploadsResponse, CompleteSlackImportUploadsResponses, CompleteUploads, ConferenceProvider, Conjunction, ConversationId, ConversationKind, ConversationMetadata, ConversationProgress, ConversationSeal, ConversationStatus, ConvertDatabaseColumnData, ConvertDatabaseColumnError, ConvertDatabaseColumnErrors, ConvertDatabaseColumnResponse, ConvertDatabaseColumnResponses, ConvertedCell, CopyDocumentData, CopyDocumentError, CopyDocumentErrors, CopyDocumentQueryParams, CopyDocumentRequest, CopyDocumentResponse, CopyDocumentResponse2, CopyDocumentResponses, CountedReaction, CreateAgentData, CreateAgentError, CreateAgentErrors, CreateAgentRequest, CreateAgentResponse, CreateAgentResponses, CreateAnchorData, CreateAnchorError, CreateAnchorErrors, CreateAnchorResponse, CreateAnchorResponses, CreateBotData, CreateBotError, CreateBotErrors, CreateBotRequest, CreateBotResponse, CreateBotResponses, CreateBotTokenData, CreateBotTokenError, CreateBotTokenErrors, CreateBotTokenRequest, CreateBotTokenResponse, CreateBotTokenResponse2, CreateBotTokenResponses, CreateBulkDocumentResponse, CreateBulkDocumentResponseData, CreateCanvasDocumentRequest, CreateCanvasDocumentResponse, CreateCanvasHandlerData, CreateCanvasHandlerError, CreateCanvasHandlerErrors, CreateCanvasHandlerResponse, CreateCanvasHandlerResponses, CreateChannelData, CreateChannelError, CreateChannelErrors, CreateChannelLabelData, CreateChannelLabelError, CreateChannelLabelErrors, CreateChannelLabelRequest, CreateChannelLabelResponse, CreateChannelLabelResponses, CreateChannelRequest, CreateChannelResponse, CreateChannelResponse2, CreateChannelResponses, CreateChannelScopedBotData, CreateChannelScopedBotError, CreateChannelScopedBotErrors, CreateChannelScopedBotRequest, CreateChannelScopedBotResponse, CreateChannelScopedBotResponse2, CreateChannelScopedBotResponses, CreateCollabSurfaceTokenData, CreateCollabSurfaceTokenError, CreateCollabSurfaceTokenErrors, CreateCollabSurfaceTokenResponse, CreateCollabSurfaceTokenResponses, CreateCrmCompanyData, CreateCrmCompanyError, CreateCrmCompanyErrors, CreateCrmCompanyRequest, CreateCrmCompanyResponse, CreateCrmCompanyResponses, CreateCrmContactData, CreateCrmContactError, CreateCrmContactErrors, CreateCrmContactRequest, CreateCrmContactResponse, CreateCrmContactResponses, CreateCrmPipelineData, CreateCrmPipelineResponse, CreateCrmPipelineResponses, CreateCrmTeamContactData, CreateCrmTeamContactError, CreateCrmTeamContactErrors, CreateCrmTeamContactRequest, CreateCrmTeamContactResponse, CreateCrmTeamContactResponses, CreateDatabaseData, CreateDatabaseError, CreateDatabaseErrors, CreateDatabaseRequest, CreateDatabaseResponse, CreateDatabaseResponses, CreateDatabaseWebhookData, CreateDatabaseWebhookError, CreateDatabaseWebhookErrors, CreateDatabaseWebhookRequest, CreateDatabaseWebhookResponse, CreateDatabaseWebhookResponses, CreatedDatabaseWebhookResponse, CreateDocumentData, CreateDocumentError, CreateDocumentErrors, CreateDocumentRequest, CreateDocumentResponse, CreateDocumentResponseData, CreateDocumentResponses, CreatedPairing, CreatedUserApiKey, CreateEntityMentionData, CreateEntityMentionError, CreateEntityMentionErrors, CreateEntityMentionRequest, CreateEntityMentionResponse, CreateEntityMentionResponse2, CreateEntityMentionResponses, CreateForm, CreateFormData, CreateFormError, CreateFormErrors, CreateFormResponse, CreateFormResponses, CreateHarnessPairingData, CreateHarnessPairingError, CreateHarnessPairingErrors, CreateHarnessPairingResponse, CreateHarnessPairingResponses, CreateImport, CreateInitiativeData, CreateInitiativeError, CreateInitiativeErrors, CreateInitiativeRequest, CreateInitiativeResponse, CreateInitiativeResponses, CreateInstructionsDocumentResponse, CreateInstructionsHandlerData, CreateInstructionsHandlerError, CreateInstructionsHandlerErrors, CreateInstructionsHandlerResponse, CreateInstructionsHandlerResponses, CreateMarkdownDocumentRequest, CreateMarkdownDocumentResponse, CreateMarkdownHandlerData, CreateMarkdownHandlerError, CreateMarkdownHandlerErrors, CreateMarkdownHandlerResponse, CreateMarkdownHandlerResponses, CreateMeetingRequest, CreatePairingRequest, CreatePipeline, CreateProjectHandlerData, CreateProjectHandlerError, CreateProjectHandlerErrors, CreateProjectHandlerResponse, CreateProjectHandlerResponses, CreateProjectRequest, CreateProjectResponse, CreateSkillHandlerData, CreateSkillHandlerError, CreateSkillHandlerErrors, CreateSkillHandlerResponse, CreateSkillHandlerResponses, CreateSkillRequest, CreateSkillResponse, CreateSlackImportData, CreateSlackImportErrors, CreateSlackImportResponse, CreateSlackImportResponses, CreateSnippetHandlerData, CreateSnippetHandlerError, CreateSnippetHandlerErrors, CreateSnippetHandlerResponse, CreateSnippetHandlerResponses, CreateSnippetRequest, CreateSnippetResponse, CreateTaskHandlerData, CreateTaskHandlerError, CreateTaskHandlerErrors, CreateTaskHandlerResponse, CreateTaskHandlerResponses, CreateTaskRequest, CreateTaskResponse, CreateToken, CreateUnthreadedAnchorRequest, CreateUnthreadedAnchorResponse, CreateUnthreadedPdfAnchorRequest, CreateUserApiKeyData, CreateUserApiKeyError, CreateUserApiKeyErrors, CreateUserApiKeyRequest, CreateUserApiKeyResponse, CreateUserApiKeyResponses, CreateViewHandlerData, CreateViewHandlerError, CreateViewHandlerErrors, CreateViewHandlerResponse, CreateViewHandlerResponses, CreateViewRequest, CreateWebhookData, CreateWebhookError, CreateWebhookErrors, CreateWebhookRequest, CreateWebhookResponse, CreateWebhookResponse2, CreateWebhookResponses, CrmAssociation, CrmBlockedDomainResponse, CrmCompanyFilters, CrmCompanyResponse, CrmContactResponse, CrmDomainResponse, CrmPermissionRole, CrmStageInput, CrmStageResponse, CrmStagesResponse, CrmTeamSettingsResponse, CustomSpeakerAssignment, Database, DatabaseDetail, DatabaseId, DatabaseOp, DatabaseQueryRequest, DatabaseView, DatabaseWebhookDeliveryResponse, DatabaseWebhookPayloadProblem, DatabaseWebhookResponse, DataType, DateOperator, DateRange, DateRangeOperator, DeclineCallData, DeclineCallError, DeclineCallErrors, DeclineCallResponse, DeclineCallResponses, DeclineRingData, DeclineRingError, DeclineRingErrors, DeclineRingResponse, DeclineRingResponses, DeleteAnchorData, DeleteAnchorError, DeleteAnchorErrors, DeleteAnchorResponse, DeleteAnchorResponses, DeleteBotData, DeleteBotError, DeleteBotErrors, DeleteBotResponse, DeleteBotResponses, DeleteCallRecordData, DeleteCallRecordError, DeleteCallRecordErrors, DeleteCallRecordResponse, DeleteCallRecordResponses, DeleteChannelData, DeleteChannelError, DeleteChannelErrors, DeleteChannelLabelData, DeleteChannelLabelError, DeleteChannelLabelErrors, DeleteChannelLabelResponse, DeleteChannelLabelResponses, DeleteChannelResponse, DeleteChannelResponses, DeleteCollabSurfaceData, DeleteCollabSurfaceError, DeleteCollabSurfaceErrors, DeleteCollabSurfaceResponse, DeleteCollabSurfaceResponses, DeleteDatabaseWebhookData, DeleteDatabaseWebhookError, DeleteDatabaseWebhookErrors, DeleteDatabaseWebhookResponse, DeleteDatabaseWebhookResponses, DeleteDocumentData, DeleteDocumentError, DeleteDocumentErrors, DeleteDocumentResponse, DeleteDocumentResponses, DeleteEntityMentionData, DeleteEntityMentionError, DeleteEntityMentionErrors, DeleteEntityMentionResponse, DeleteEntityMentionResponse2, DeleteEntityMentionResponses, DeleteHarnessData, DeleteHarnessError, DeleteHarnessErrors, DeleteHarnessResponse, DeleteHarnessResponses, DeleteHistoryHandlerData, DeleteHistoryHandlerError, DeleteHistoryHandlerErrors, DeleteHistoryHandlerResponse, DeleteHistoryHandlerResponses, DeleteInitiativeData, DeleteInitiativeError, DeleteInitiativeErrors, DeleteInitiativeResponse, DeleteInitiativeResponses, DeleteProjectHandlerData, DeleteProjectHandlerError, DeleteProjectHandlerErrors, DeleteProjectHandlerResponse, DeleteProjectHandlerResponses, DeleteSelfHarnessData, DeleteSelfHarnessError, DeleteSelfHarnessErrors, DeleteSelfHarnessResponse, DeleteSelfHarnessResponses, DeleteUnthreadedAnchorRequest, DeleteUnthreadedAnchorResponse, DeleteUnthreadedPdfAnchorRequest, DeleteUserApiKeyData, DeleteUserApiKeyError, DeleteUserApiKeyErrors, DeleteUserApiKeyResponse, DeleteUserApiKeyResponses, DeleteUserDocumentViewLocationData, DeleteUserDocumentViewLocationError, DeleteUserDocumentViewLocationErrors, DeleteUserDocumentViewLocationResponse, DeleteUserDocumentViewLocationResponses, DeleteViewHandlerData, DeleteViewHandlerError, DeleteViewHandlerErrors, DeleteViewHandlerResponses, DeleteWebhookData, DeleteWebhookError, DeleteWebhookErrors, DeleteWebhookResponse, DeleteWebhookResponses, DeliverDatabaseWebhookData, DeliverDatabaseWebhookError, DeliverDatabaseWebhookErrors, DeliverDatabaseWebhookResponse, DeliverDatabaseWebhookResponses, DirectAccess, DocumentAiEdited, DocumentAiEditFailed, DocumentAiEditFailedCode, DocumentAiEditRefused, DocumentAiEditRefusedCode, DocumentAiEditRequest, DocumentBasic, DocumentContent, DocumentContentLocation, DocumentContentState, DocumentContentUploadedMetadata, DocumentCopiedMetadata, DocumentCreatedMetadata, DocumentDeletedMetadata, DocumentFilters, DocumentId, DocumentInteractionMetadata, DocumentMetadata, DocumentMetadataWithContent, DocumentPermissionsToken, DocumentPermissionsTokenRequest, DocumentPermissionsTokenResponse, DocumentPreview, DocumentPreviewData, DocumentPreviewDataSubType, DocumentPurgedMetadata, DocumentResponse, DocumentResponseMetadata, DocumentResponseMetadataWithContent, DocumentStorageServiceApiVersion, DocumentSubType, DocumentSyncContentUpdatedMetadata, DocumentSyncEditor, DocumentTeamShareResponse, DocumentTextContent, DocumentTopicEvent, DocumentUpdatedMetadata, DuplicateDatabaseData, DuplicateDatabaseError, DuplicateDatabaseErrors, DuplicateDatabaseRequest, DuplicateDatabaseResponse, DuplicateDatabaseResponses, EditAnchorData, EditAnchorError, EditAnchorErrors, EditAnchorRequest, EditAnchorResponse, EditAnchorResponse2, EditAnchorResponses, EditCallRecordData, EditCallRecordError, EditCallRecordErrors, EditCallRecordRequest, EditCallRecordResponse, EditCallRecordResponses, EditCallTranscriptData, EditCallTranscriptError, EditCallTranscriptErrors, EditCallTranscriptRequest, EditCallTranscriptResponse, EditCallTranscriptResponses, EditDocumentData, EditDocumentError, EditDocumentErrors, EditDocumentResponse, EditDocumentResponse2, EditDocumentResponses, EditDocumentServiceArgs, EditDocumentWithAiData, EditDocumentWithAiError, EditDocumentWithAiErrors, EditDocumentWithAiResponse, EditDocumentWithAiResponses, EditMyFormResponseData, EditMyFormResponseError, EditMyFormResponseErrors, EditMyFormResponseResponse, EditMyFormResponseResponses, EditPdfAnchorRequest, EditPdfPlaceableCommentAnchorRequest, EditProjectV2Data, EditProjectV2Error, EditProjectV2Errors, EditProjectV2Response, EditProjectV2Responses, EditThreadV2Data, EditThreadV2Error, EditThreadV2Errors, EditThreadV2Response, EditThreadV2Responses, EmailFilters, EmailFollowup, EmailFollowupCommand, EmailFollowupResponse, EmailReminderCondition, EmailReminderPage, EmailReminderSummary, EmptyResponse, EnsureCollabSurfaceData, EnsureCollabSurfaceError, EnsureCollabSurfaceErrors, EnsureCollabSurfaceRequest, EnsureCollabSurfaceResponse, EnsureCollabSurfaceResponses, EnsureStarterHandlerData, EnsureStarterHandlerErrors, EnsureStarterHandlerResponse, EnsureStarterHandlerResponses, EntityFilters, EntityKind, EntityMessageCreateData, EntityMessageCreateResponse, EntityMessageCreateResponses, EntityMessageDeleteMessageData, EntityMessageDeleteMessageResponse, EntityMessageDeleteMessageResponses, EntityMessageDeleteThreadData, EntityMessageDeleteThreadResponse, EntityMessageDeleteThreadResponses, EntityMessageEditData, EntityMessageEditResponse, EntityMessageEditResponses, EntityMessageGetMessageData, EntityMessageGetMessageResponse, EntityMessageGetMessageResponses, EntityMessageGetThreadData, EntityMessageGetThreadResponse, EntityMessageGetThreadResponses, EntityMessageLegacyData, EntityMessageLegacyResponse, EntityMessageLegacyResponses, EntityMessagePatchThreadData, EntityMessagePatchThreadResponse, EntityMessagePatchThreadResponses, EntityMessageReactData, EntityMessageReactResponse, EntityMessageReactResponses, EntityMessageTypingData, EntityMessageTypingResponse, EntityMessageTypingResponses, EntityPermission, EntityPermissionResponse, EntityRef, EntityReference, EntityType, ErrorResponse, EventIcsData, EventIcsErrors, EventIcsResponse, EventIcsResponses, EventReminderOverride, EventReminders, EventStatus, EventTime, EventTransparency, EventType, EventVisibility, ExcludedDefaultView, ExcludeDefaultViewHandlerData, ExcludeDefaultViewHandlerError, ExcludeDefaultViewHandlerErrors, ExcludeDefaultViewHandlerResponses, ExcludeDefaultViewRequest, ExportDocumentData, ExportDocumentError, ExportDocumentErrors, ExportDocumentResponse, ExportDocumentResponse2, ExportDocumentResponses, ExternalChatAdd, ExternalChatAddData, ExternalChatAdded, ExternalChatAddResponse, ExternalChatAddResponses, ExternalChatAttachment, ExternalChatAttachmentState, ExternalChatBackfill, ExternalChatBackfillState, ExternalChatCall, ExternalChatCallOutcome, ExternalChatCapabilities, ExternalChatCommunity, ExternalChatContactCard, ExternalChatContacts, ExternalChatData, ExternalChatDeliveryData, ExternalChatDeliveryResponse, ExternalChatDeliveryResponses, ExternalChatDeliveryState, ExternalChatDetail, ExternalChatEvent, ExternalChatKind, ExternalChatLocation, ExternalChatMediaKind, ExternalChatMediaPresentation, ExternalChatMembers, ExternalChatMention, ExternalChatMessage, ExternalChatMessageAttachments, ExternalChatMessageAttachmentsData, ExternalChatMessageAttachmentsResponse, ExternalChatMessageAttachmentsResponses, ExternalChatMessageData, ExternalChatMessageKind, ExternalChatMessageResponse, ExternalChatMessageResponses, ExternalChatMessages, ExternalChatMessagesData, ExternalChatMessagesResponse, ExternalChatMessagesResponses, ExternalChatMutation, ExternalChatParticipant, ExternalChatPermissionsData, ExternalChatPermissionsResponse, ExternalChatPermissionsResponses, ExternalChatPersonRef, ExternalChatPoll, ExternalChatPollOption, ExternalChatProvider, ExternalChatReaction, ExternalChatReadData, ExternalChatReadResponse, ExternalChatReadResponses, ExternalChatReference, ExternalChatRemoveData, ExternalChatRemoveResponse, ExternalChatRemoveResponses, ExternalChatReplyBlock, ExternalChatReplyContent, ExternalChatResponse, ExternalChatResponses, ExternalChatRichContent, ExternalChatsData, ExternalChatSendData, ExternalChatSender, ExternalChatSendErrors, ExternalChatSendProgress, ExternalChatSendReply, ExternalChatSendResponse, ExternalChatSendResponses, ExternalChatSendsData, ExternalChatSendsResponse, ExternalChatSendsResponses, ExternalChatsResponse, ExternalChatsResponses, ExternalChatSummary, ExternalChatSystemAction, ExternalChatSystemLine, ExternalChatUpdatePermissionsData, ExternalChatUpdatePermissionsResponse, ExternalChatUpdatePermissionsResponses, ExternalChatUploadData, ExternalChatUploadedAttachment, ExternalChatUploadRequest, ExternalChatUploadResponse, ExternalChatUploadResponses, Favorite, FavoriteEntityRef, FavoritesList, FileChangeKindDto, FileSystemNodeWithIds, FileType, FileTypeUpdate, FilterCondition, FilterGroup, FilterNode, FilterTest, FinalizeSlackImportData, FinalizeSlackImportErrors, FinalizeSlackImportResponse, FinalizeSlackImportResponses, FolderItem, FollowupState, ForeignEntity, ForeignEntityFilters, Form, FormAccess, FormBranding, FormCollaboration, FormDetail, FormErrorCode, FormErrorResponse, FormLayout, FormPublicationProblem, FormQuestionDetail, FormResponse, FormSection, FormSectionDetail, FormSource, FormStatus, FormTally, Formula, GenericErrorResponse, GenericResponse, GenericSuccessResponse, GetAccountManagerGrantData, GetAccountManagerGrantError, GetAccountManagerGrantErrors, GetAccountManagerGrantResponse, GetAccountManagerGrantResponses, GetActiveCallsData, GetActiveCallsError, GetActiveCallsErrors, GetActiveCallsResponse, GetActiveCallsResponses, GetActivityData, GetActivityError, GetActivityErrors, GetActivityResponse, GetActivityResponses, GetAttachmentReferencesData, GetAttachmentReferencesError, GetAttachmentReferencesErrors, GetAttachmentReferencesResponse, GetAttachmentReferencesResponse2, GetAttachmentReferencesResponses, GetBatchCallRecordPreviewData, GetBatchCallRecordPreviewError, GetBatchCallRecordPreviewErrors, GetBatchCallRecordPreviewRequest, GetBatchCallRecordPreviewResponse, GetBatchCallRecordPreviewResponse2, GetBatchCallRecordPreviewResponses, GetBatchChannelPreviewData, GetBatchChannelPreviewError, GetBatchChannelPreviewErrors, GetBatchChannelPreviewRequest, GetBatchChannelPreviewResponse, GetBatchChannelPreviewResponse2, GetBatchChannelPreviewResponses, GetBatchPreviewHandlerData, GetBatchPreviewHandlerError, GetBatchPreviewHandlerErrors, GetBatchPreviewHandlerResponse, GetBatchPreviewHandlerResponses, GetBatchPreviewRequest, GetBatchPreviewResponse, GetBatchProjectPreviewData, GetBatchProjectPreviewError, GetBatchProjectPreviewErrors, GetBatchProjectPreviewRequest, GetBatchProjectPreviewResponse, GetBatchProjectPreviewResponse2, GetBatchProjectPreviewResponses, GetBotData, GetBotError, GetBotErrors, GetBotOwnerProfilesData, GetBotOwnerProfilesError, GetBotOwnerProfilesErrors, GetBotOwnerProfilesResponse, GetBotOwnerProfilesResponses, GetBotResponse, GetBotResponses, GetCallRecordData, GetCallRecordError, GetCallRecordErrors, GetCallRecordResponse, GetCallRecordResponses, GetChannelAccessRequestData, GetChannelAccessRequestError, GetChannelAccessRequestErrors, GetChannelAccessRequestResponse, GetChannelAccessRequestResponses, GetChannelAttachmentsData, GetChannelAttachmentsError, GetChannelAttachmentsErrors, GetChannelAttachmentsResponse, GetChannelAttachmentsResponses, GetChannelData, GetChannelError, GetChannelErrors, GetChannelJoinLinkData, GetChannelJoinLinkError, GetChannelJoinLinkErrors, GetChannelJoinLinkResponse, GetChannelJoinLinkResponses, GetChannelParticipantsData, GetChannelParticipantsError, GetChannelParticipantsErrors, GetChannelParticipantsResponse, GetChannelParticipantsResponses, GetChannelResponse, GetChannelResponses, GetChannelsData, GetChannelsError, GetChannelsErrors, GetChannelsResponse, GetChannelsResponses, GetCollabSurfaceData, GetCollabSurfaceError, GetCollabSurfaceErrors, GetCollabSurfaceResponse, GetCollabSurfaceResponses, GetCompanyData, GetCompanyError, GetCompanyErrors, GetCompanyResponse, GetCompanyResponses, GetContactByEmailData, GetContactByEmailError, GetContactByEmailErrors, GetContactByEmailResponse, GetContactByEmailResponse2, GetContactByEmailResponses, GetContactData, GetContactError, GetContactErrors, GetContactResponse, GetContactResponses, GetCrmPipelineData, GetCrmPipelinePermissionsData, GetCrmPipelinePermissionsResponse, GetCrmPipelinePermissionsResponses, GetCrmPipelineResponse, GetCrmPipelineResponses, GetCrmPipelineRowsData, GetCrmPipelineRowsResponse, GetCrmPipelineRowsResponses, GetCrmPipelineStageRequirementsData, GetCrmPipelineStageRequirementsResponse, GetCrmPipelineStageRequirementsResponses, GetCrmPipelineTableData, GetCrmPipelineTableResponse, GetCrmPipelineTableResponses, GetCrmPipelineViewPositionsData, GetCrmPipelineViewPositionsResponse, GetCrmPipelineViewPositionsResponses, GetCrmTeamSettingsData, GetCrmTeamSettingsError, GetCrmTeamSettingsErrors, GetCrmTeamSettingsResponse, GetCrmTeamSettingsResponses, GetDatabaseData, GetDatabaseError, GetDatabaseErrors, GetDatabasePermissionsData, GetDatabasePermissionsError, GetDatabasePermissionsErrors, GetDatabasePermissionsResponse, GetDatabasePermissionsResponses, GetDatabaseQueryData, GetDatabaseQueryError, GetDatabaseQueryErrors, GetDatabaseQueryResponse, GetDatabaseQueryResponses, GetDatabaseResponse, GetDatabaseResponses, GetDatabaseRowHistoryData, GetDatabaseRowHistoryError, GetDatabaseRowHistoryErrors, GetDatabaseRowHistoryResponse, GetDatabaseRowHistoryResponses, GetDatabaseTableChangesData, GetDatabaseTableChangesError, GetDatabaseTableChangesErrors, GetDatabaseTableChangesResponse, GetDatabaseTableChangesResponses, GetDatabaseViewPositionsData, GetDatabaseViewPositionsError, GetDatabaseViewPositionsErrors, GetDatabaseViewPositionsResponse, GetDatabaseViewPositionsResponses, GetDocumentAnchorsData, GetDocumentAnchorsError, GetDocumentAnchorsErrors, GetDocumentAnchorsResponse, GetDocumentAnchorsResponses, GetDocumentBranchNameData, GetDocumentBranchNameError, GetDocumentBranchNameErrors, GetDocumentBranchNameResponse, GetDocumentBranchNameResponses, GetDocumentByTeamSlugData, GetDocumentByTeamSlugError, GetDocumentByTeamSlugErrors, GetDocumentByTeamSlugResponse, GetDocumentByTeamSlugResponses, GetDocumentData, GetDocumentError, GetDocumentErrors, GetDocumentGithubPullRequestsData, GetDocumentGithubPullRequestsError, GetDocumentGithubPullRequestsErrors, GetDocumentGithubPullRequestsResponse, GetDocumentGithubPullRequestsResponses, GetDocumentKeyResponse, GetDocumentKeyResponseData, GetDocumentListHandlerData, GetDocumentListHandlerError, GetDocumentListHandlerErrors, GetDocumentListHandlerResponse, GetDocumentListHandlerResponses, GetDocumentListResult, GetDocumentLocationV3Data, GetDocumentLocationV3Error, GetDocumentLocationV3Errors, GetDocumentLocationV3Response, GetDocumentLocationV3Responses, GetDocumentPermissionsResponseDataV2, GetDocumentPermissionsTokenData, GetDocumentPermissionsTokenError, GetDocumentPermissionsTokenErrors, GetDocumentPermissionsTokenResponse, GetDocumentPermissionsTokenResponses, GetDocumentPermissionsV2Data, GetDocumentPermissionsV2Error, GetDocumentPermissionsV2Errors, GetDocumentPermissionsV2Response, GetDocumentPermissionsV2Responses, GetDocumentProcessingResult, GetDocumentProcessingResultData, GetDocumentProcessingResultError, GetDocumentProcessingResultErrors, GetDocumentProcessingResultResponse, GetDocumentProcessingResultResponse2, GetDocumentProcessingResultResponses, GetDocumentResponse, GetDocumentResponse2, GetDocumentResponseData, GetDocumentResponses, GetDocumentSearchResponse, GetDocumentShortIdData, GetDocumentShortIdError, GetDocumentShortIdErrors, GetDocumentShortIdResponse, GetDocumentShortIdResponses, GetDocumentsResponse, GetDocumentTeamShareData, GetDocumentTeamShareError, GetDocumentTeamShareErrors, GetDocumentTeamShareResponse, GetDocumentTeamShareResponses, GetDocumentTextContentData, GetDocumentTextContentErrors, GetDocumentTextContentResponse, GetDocumentTextContentResponses, GetDocumentUserAccessLevelResponse, GetDocumentVersionData, GetDocumentVersionError, GetDocumentVersionErrors, GetDocumentVersionResponse, GetDocumentVersionResponses, GetDocumentViewsHandlerData, GetDocumentViewsHandlerError, GetDocumentViewsHandlerErrors, GetDocumentViewsHandlerResponse, GetDocumentViewsHandlerResponses, GetEmailFollowupData, GetEmailFollowupError, GetEmailFollowupErrors, GetEmailFollowupResponse, GetEmailFollowupResponses, GetEntityPermissionData, GetEntityPermissionErrors, GetEntityPermissionResponse, GetEntityPermissionResponses, GetForeignEntityBySourceData, GetForeignEntityBySourceError, GetForeignEntityBySourceErrors, GetForeignEntityBySourceResponse, GetForeignEntityBySourceResponses, GetForeignEntityData, GetForeignEntityError, GetForeignEntityErrors, GetForeignEntityResponse, GetForeignEntityResponses, GetFormData, GetFormError, GetFormErrors, GetFormPermissionsData, GetFormPermissionsError, GetFormPermissionsErrors, GetFormPermissionsResponse, GetFormPermissionsResponses, GetFormResponse, GetFormResponses, GetFormResponseSummaryData, GetFormResponseSummaryError, GetFormResponseSummaryErrors, GetFormResponseSummaryResponse, GetFormResponseSummaryResponses, GetFormTallyData, GetFormTallyError, GetFormTallyErrors, GetFormTallyResponse, GetFormTallyResponses, GetGithubPullRequestChangesData, GetGithubPullRequestChangesError, GetGithubPullRequestChangesErrors, GetGithubPullRequestChangesPatchData, GetGithubPullRequestChangesPatchError, GetGithubPullRequestChangesPatchErrors, GetGithubPullRequestChangesPatchResponse, GetGithubPullRequestChangesPatchResponses, GetGithubPullRequestChangesResponse, GetGithubPullRequestChangesResponses, GetGithubPullRequestData, GetGithubPullRequestError, GetGithubPullRequestErrors, GetGithubPullRequestFacetsData, GetGithubPullRequestFacetsError, GetGithubPullRequestFacetsErrors, GetGithubPullRequestFacetsResponse, GetGithubPullRequestFacetsResponses, GetGithubPullRequestResponse, GetGithubPullRequestResponses, GetGithubPullRequestTasksData, GetGithubPullRequestTasksError, GetGithubPullRequestTasksErrors, GetGithubPullRequestTasksResponse, GetGithubPullRequestTasksResponses, GetHarnessPairingData, GetHarnessPairingError, GetHarnessPairingErrors, GetHarnessPairingResponse, GetHarnessPairingResponses, GetHistoryHandlerData, GetHistoryHandlerError, GetHistoryHandlerErrors, GetHistoryHandlerResponse, GetHistoryHandlerResponses, GetInitiativeData, GetInitiativeError, GetInitiativeErrors, GetInitiativeResponse, GetInitiativeResponses, GetInstructionsDocumentResponse, GetInstructionsHandlerData, GetInstructionsHandlerError, GetInstructionsHandlerErrors, GetInstructionsHandlerResponse, GetInstructionsHandlerResponses, GetItemsSoupData, GetItemsSoupError, GetItemsSoupErrors, GetItemsSoupResponse, GetItemsSoupResponses, GetLocationHandlerData, GetLocationHandlerError, GetLocationHandlerErrors, GetLocationHandlerResponse, GetLocationHandlerResponses, GetMyChannelAccessRequestData, GetMyChannelAccessRequestError, GetMyChannelAccessRequestErrors, GetMyChannelAccessRequestResponse, GetMyChannelAccessRequestResponses, GetMyFormResponseData, GetMyFormResponseError, GetMyFormResponseErrors, GetMyFormResponseResponse, GetMyFormResponseResponses, GetOrCreateAction, GetOrCreateCallData, GetOrCreateCallError, GetOrCreateCallErrors, GetOrCreateCallResponse, GetOrCreateCallResponses, GetOrCreateChannelResponse, GetOrCreateDmData, GetOrCreateDmError, GetOrCreateDmErrors, GetOrCreateDmRequest, GetOrCreateDmResponse, GetOrCreateDmResponses, GetOrCreatePrivateData, GetOrCreatePrivateError, GetOrCreatePrivateErrors, GetOrCreatePrivateRequest, GetOrCreatePrivateResponse, GetOrCreatePrivateResponses, GetPendingProjectsHandlerData, GetPendingProjectsHandlerError, GetPendingProjectsHandlerErrors, GetPendingProjectsHandlerResponse, GetPendingProjectsHandlerResponses, GetPinsHandlerData, GetPinsHandlerError, GetPinsHandlerErrors, GetPinsHandlerResponse, GetPinsHandlerResponses, GetPinsResponse, GetProjectContentHandlerData, GetProjectContentHandlerError, GetProjectContentHandlerErrors, GetProjectContentHandlerResponse, GetProjectContentHandlerResponses, GetProjectContentResponse, GetProjectHandlerData, GetProjectHandlerError, GetProjectHandlerErrors, GetProjectHandlerResponse, GetProjectHandlerResponses, GetProjectPermissionsV2Data, GetProjectPermissionsV2Error, GetProjectPermissionsV2Errors, GetProjectPermissionsV2Response, GetProjectPermissionsV2Responses, GetProjectResponse, GetProjectResponseData, GetProjectsHandlerData, GetProjectsHandlerError, GetProjectsHandlerErrors, GetProjectsHandlerResponse, GetProjectsHandlerResponses, GetProjectsResponse, GetProjectUserAccessLevelData, GetProjectUserAccessLevelError, GetProjectUserAccessLevelErrors, GetProjectUserAccessLevelResponse, GetProjectUserAccessLevelResponses, GetRingStatusData, GetRingStatusError, GetRingStatusErrors, GetRingStatusResponse, GetRingStatusResponses, GetSelfBotData, GetSelfBotError, GetSelfBotErrors, GetSelfBotResponse, GetSelfBotResponses, GetSelfHarnessData, GetSelfHarnessError, GetSelfHarnessErrors, GetSelfHarnessResponse, GetSelfHarnessResponses, GetSkillDescriptionData, GetSkillDescriptionError, GetSkillDescriptionErrors, GetSkillDescriptionResponse, GetSkillDescriptionResponses, GetSlackImportData, GetSlackImportErrors, GetSlackImportResponse, GetSlackImportResponses, GetSystemSkillsHandlerData, GetSystemSkillsHandlerError, GetSystemSkillsHandlerErrors, GetSystemSkillsHandlerResponse, GetSystemSkillsHandlerResponses, GetUserDocumentsHandlerData, GetUserDocumentsHandlerError, GetUserDocumentsHandlerErrors, GetUserDocumentsHandlerResponse, GetUserDocumentsHandlerResponses, GetUserDocumentViewLocationData, GetUserDocumentViewLocationError, GetUserDocumentViewLocationErrors, GetUserDocumentViewLocationResponse, GetUserDocumentViewLocationResponses, GetUserHistoryResponse, GetViewsHandlerData, GetViewsHandlerError, GetViewsHandlerErrors, GetViewsHandlerResponse, GetViewsHandlerResponses, GetWebhookData, GetWebhookError, GetWebhookErrors, GetWebhookResponse, GetWebhookResponses, GithubLabelFacet, GithubPullRequest, GithubPullRequestChangesPatchResponse, GithubPullRequestChangesResponse, GithubPullRequestCheckRun, GithubPullRequestComment, GithubPullRequestFacets, GithubPullRequestLabel, GithubPullRequestReview, GithubPullRequestReviewDecision, GithubPullRequestReviewState, GithubPullRequestsResponse, GithubPullRequestTasks, GithubPullRequestTasksRequest, GithubPullRequestTasksResponse, GithubPullRequestUser, GithubRepositoryFacet, GithubUserFacet, GitRefDto, GroupedInitialParams, GroupedPageParams, GroupedSoupGroupPage, GroupedSoupInitialPage, GroupedSoupPage, GroupedSoupSort, GuestCallChatPostData, GuestCallChatPostErrors, GuestCallChatPostResponse, GuestCallChatPostResponses, GuestCallChatReadData, GuestCallChatReadErrors, GuestCallChatReadResponse, GuestCallChatReadResponses, GuestChatMessage, GuestChatPage, GuestChatPost, GuestId, GuestJoinRequest, GuestPolicy, HandlerData, HandlerError, HandlerErrors, HandlerResponse, HandlerResponses, Harness, HarnessAgent, HarnessId, HarnessOwner, HarnessSession, HashMap, HealthHandlerData, HealthHandlerResponse, HealthHandlerResponses, HighlightType, ImportCounters, ImportDatabaseTableData, ImportDatabaseTableError, ImportDatabaseTableErrors, ImportDatabaseTableResponse, ImportDatabaseTableResponses, ImportedAuthor, ImportError, ImportLimits, ImportPage, ImportProgress, ImportTable, ImportWarning, InferColumnTypeOutcome, InferColumnTypeRequest, InferDatabaseColumnTypeData, InferDatabaseColumnTypeError, InferDatabaseColumnTypeErrors, InferDatabaseColumnTypeResponse, InferDatabaseColumnTypeResponses, InFlightTurnSummary, IngestTranscriptData, IngestTranscriptError, IngestTranscriptErrors, IngestTranscriptResponses, InitializeUserDocumentsData, InitializeUserDocumentsError, InitializeUserDocumentsErrors, InitializeUserDocumentsResponse, InitializeUserDocumentsResponses, InitialPropertyValue, InitiativeDetail, InitiativeFilters, InitiativeId, InitiativeList, InitiativeSummary, InputReceivedMetadata, InstallSyncData, InstallSyncErrors, InteractionReason, InvalidDatabaseWebhookPayloadResponse, InviteMeetingRequest, InviteMeetingUsersRequest, Item, ItemWithUserAccessLevel, JobId, JobProcessingResultHandlerData, JobProcessingResultHandlerError, JobProcessingResultHandlerErrors, JobProcessingResultHandlerResponse, JobProcessingResultHandlerResponses, JobStatus, JoinChannelByCodeData, JoinChannelByCodeError, JoinChannelByCodeErrors, JoinChannelByCodeResponses, JoinChannelData, JoinChannelError, JoinChannelErrors, JoinChannelResponses, KeySegment, Lane, LaneKey, LatestMessage, LayoutProblem, LeaveCallResponse, LeaveChannelData, LeaveChannelError, LeaveChannelErrors, LeaveChannelResponses, LeaveOrEndCallData, LeaveOrEndCallError, LeaveOrEndCallErrors, LeaveOrEndCallResponse, LeaveOrEndCallResponses, LinkShare, ListAccessibleFormsData, ListAccessibleFormsError, ListAccessibleFormsErrors, ListAccessibleFormsResponse, ListAccessibleFormsResponses, ListAccountManagersData, ListAccountManagersError, ListAccountManagersErrors, ListAccountManagersResponse, ListAccountManagersResponses, ListAgentsData, ListAgentsError, ListAgentsErrors, ListAgentsResponse, ListAgentsResponses, ListBotChannelsData, ListBotChannelsError, ListBotChannelsErrors, ListBotChannelsResponse, ListBotChannelsResponses, ListBotsData, ListBotsError, ListBotsErrors, ListBotsResponse, ListBotsResponses, ListBotTokensData, ListBotTokensError, ListBotTokensErrors, ListBotTokensResponse, ListBotTokensResponses, ListChannelBotsData, ListChannelBotsError, ListChannelBotsErrors, ListChannelBotsResponse, ListChannelBotsResponses, ListChannelLabelsData, ListChannelLabelsError, ListChannelLabelsErrors, ListChannelLabelsResponse, ListChannelLabelsResponses, ListCompanyContactsData, ListCompanyContactsError, ListCompanyContactsErrors, ListCompanyContactsResponse, ListCompanyContactsResponses, ListCrmBlockedDomainsData, ListCrmBlockedDomainsError, ListCrmBlockedDomainsErrors, ListCrmBlockedDomainsResponse, ListCrmBlockedDomainsResponses, ListCrmPipelinesData, ListCrmPipelinesResponse, ListCrmPipelinesResponses, ListDatabaseColumnCastsData, ListDatabaseColumnCastsError, ListDatabaseColumnCastsErrors, ListDatabaseColumnCastsResponse, ListDatabaseColumnCastsResponses, ListDatabasesData, ListDatabasesError, ListDatabasesErrors, ListDatabasesResponse, ListDatabasesResponses, ListDatabaseWebhooksData, ListDatabaseWebhooksError, ListDatabaseWebhooksErrors, ListDatabaseWebhooksResponse, ListDatabaseWebhooksResponse2, ListDatabaseWebhooksResponses, ListedDatabase, ListedForm, ListEmailRemindersData, ListEmailRemindersError, ListEmailRemindersErrors, ListEmailRemindersResponse, ListEmailRemindersResponses, ListFavoritesData, ListFavoritesError, ListFavoritesErrors, ListFavoritesResponse, ListFavoritesResponses, ListFormsData, ListFormsError, ListFormsErrors, ListFormsResponse, ListFormsResponses, ListHarnessAgentsData, ListHarnessAgentsError, ListHarnessAgentsErrors, ListHarnessAgentsResponse, ListHarnessAgentsResponses, ListHarnessesData, ListHarnessesError, ListHarnessesErrors, ListHarnessesResponse, ListHarnessesResponses, ListHarnessSessionsData, ListHarnessSessionsError, ListHarnessSessionsErrors, ListHarnessSessionsResponse, ListHarnessSessionsResponses, ListInitiativesData, ListInitiativesError, ListInitiativesErrors, ListInitiativesResponse, ListInitiativesResponses, ListJoinRequestsData, ListJoinRequestsError, ListJoinRequestsErrors, ListJoinRequestsResponse, ListJoinRequestsResponses, ListOccurrencesData, ListOccurrencesErrors, ListOccurrencesResponse, ListOccurrencesResponses, ListSlackImportsData, ListSlackImportsResponse, ListSlackImportsResponses, ListTeamCalendarData, ListTeamCalendarResponse, ListTeamCalendarResponses, ListTeamOutOfOfficeData, ListTeamOutOfOfficeErrors, ListTeamOutOfOfficeResponse, ListTeamOutOfOfficeResponses, ListUserApiKeysData, ListUserApiKeysError, ListUserApiKeysErrors, ListUserApiKeysResponse, ListUserApiKeysResponses, ListWebhooksData, ListWebhooksError, ListWebhooksErrors, ListWebhooksResponse, ListWebhooksResponse2, ListWebhooksResponses, LocationResponseData, LocationResponseV3, MacroUserIdStr, MarkRead, Meeting, MeetingCancelData, MeetingCancelError, MeetingCancelErrors, MeetingCancelPreparationData, MeetingCancelPreparationError, MeetingCancelPreparationErrors, MeetingCancelPreparationResponse, MeetingCancelPreparationResponses, MeetingCancelResponse, MeetingCancelResponses, MeetingCreateData, MeetingCreateError, MeetingCreateErrors, MeetingCreateResponse, MeetingCreateResponses, MeetingGuestJoinData, MeetingGuestJoinError, MeetingGuestJoinErrors, MeetingGuestJoinResponse, MeetingGuestJoinResponses, MeetingGuestParticipantsData, MeetingGuestParticipantsError, MeetingGuestParticipantsErrors, MeetingGuestParticipantsResponse, MeetingGuestParticipantsResponses, MeetingInviteData, MeetingInviteError, MeetingInviteErrors, MeetingInvitePermissions, MeetingInvitePermissionsData, MeetingInvitePermissionsError, MeetingInvitePermissionsErrors, MeetingInvitePermissionsResponse, MeetingInvitePermissionsResponses, MeetingInviteResponse, MeetingInviteResponses, MeetingInviteUsersData, MeetingInviteUsersError, MeetingInviteUsersErrors, MeetingInviteUsersResponse, MeetingInviteUsersResponses, MeetingJoinData, MeetingJoinError, MeetingJoinErrors, MeetingJoinResponse, MeetingJoinResponses, MeetingLeaveData, MeetingLeaveError, MeetingLeaveErrors, MeetingLeaveResponse, MeetingLeaveResponses, MeetingListActiveData, MeetingListActiveError, MeetingListActiveErrors, MeetingListActiveResponse, MeetingListActiveResponses, MeetingListData, MeetingListError, MeetingListErrors, MeetingListResponse, MeetingListResponses, MeetingLookupData, MeetingLookupError, MeetingLookupErrors, MeetingLookupResponse, MeetingLookupResponses, MeetingParticipant, MeetingParticipants, MeetingParticipantsData, MeetingParticipantsError, MeetingParticipantsErrors, MeetingParticipantsResponse, MeetingParticipantsResponses, MeetingPreparation, MeetingPrepareData, MeetingPrepareError, MeetingPrepareErrors, MeetingPrepareResponse, MeetingPrepareResponses, MeetingShareData, MeetingShareError, MeetingShareErrors, MeetingShareResponse, MeetingShareResponses, MeetingsResponse, MeetingToken, MeetingUpdateData, MeetingUpdateError, MeetingUpdateErrors, MeetingUpdateResponse, MeetingUpdateResponses, MentionPreviewsData, MentionPreviewsErrors, MentionPreviewsResponse, MentionPreviewsResponses, Message, MessageAttachment, MessageAttachmentCreatedMetadata, MessageAttachmentRemovedMetadata, MessageChange, MessageCursor, MessageDeletedMetadata, MessageDirection, MessageEvent, MessageEventAttachment, MessageKind, MessageListItem, MessageMentionedMetadata, MessagePage, MessageParent, MessagePatch, MessagePatchedMetadata, MessagePostedMetadata, MessageThread, MessageThreadPreview, MessageTimelineData, MessageTimelineEntriesData, MessageTimelineEntriesResponse, MessageTimelineEntriesResponses, MessageTimelineEntry, MessageTimelinePage, MessageTimelineQuery, MessageTimelineResponse, MessageTimelineResponses, MessageTopicEvent, MyResponse, NewAttachment, NewColumn, NewOption, NewThreadAnchor, NewView, NotificationFilters, NotificationState, NumberOperator, OpBatch, Operator, OpRefusalResponse, OpResult, OptionId, OptionRef, PairingDetails, Params, ParticipantRole, PatchBotData, PatchBotError, PatchBotErrors, PatchBotRequest, PatchBotResponse, PatchBotResponses, PatchChannelData, PatchChannelError, PatchChannelErrors, PatchChannelRequest, PatchChannelResponse, PatchChannelResponses, PatchHarnessData, PatchHarnessError, PatchHarnessErrors, PatchHarnessRequest, PatchHarnessResponse, PatchHarnessResponses, PatchMessageNotificationPolicy, PatchProjectRequestV2, PatchThreadRequestV2, PatchViewHandlerData, PatchViewHandlerError, PatchViewHandlerErrors, PatchViewHandlerResponses, PatchWebhookData, PatchWebhookError, PatchWebhookErrors, PatchWebhookRequest, PatchWebhookResponse, PatchWebhookResponses, PdfAnchor, PdfAnchorId, PdfHighlightAnchor, PdfHighlightAnchorRequest, PdfHighlightRect, PdfHighlightRectAnchorRequest, PdfPlaceableCommentAnchor, PendingClaimResponse, PermanentlyDeleteDocumentData, PermanentlyDeleteDocumentError, PermanentlyDeleteDocumentErrors, PermanentlyDeleteDocumentResponse, PermanentlyDeleteDocumentResponses, PermanentlyDeleteProjectData, PermanentlyDeleteProjectError, PermanentlyDeleteProjectErrors, PermanentlyDeleteProjectResponse, PermanentlyDeleteProjectResponses, PinnedItem, PinRequest, Pipeline, PipelineRecordType, PipelineSharing, PostActivityData, PostActivityError, PostActivityErrors, PostActivityRequest, PostActivityResponse, PostActivityResponses, PostChannelBotWebhookData, PostChannelBotWebhookError, PostChannelBotWebhookErrors, PostChannelBotWebhookResponse, PostChannelBotWebhookResponses, PostGroupedSoupAstGroupPageRequest, PostGroupedSoupAstInitialRequest, PostGroupedSoupAstRequest, PostItemsSoupAstData, PostItemsSoupAstError, PostItemsSoupAstErrors, PostItemsSoupAstGroupedData, PostItemsSoupAstGroupedError, PostItemsSoupAstGroupedErrors, PostItemsSoupAstGroupedResponse, PostItemsSoupAstGroupedResponses, PostItemsSoupAstResponse, PostItemsSoupAstResponses, PostItemsSoupData, PostItemsSoupError, PostItemsSoupErrors, PostItemsSoupResponse, PostItemsSoupResponses, PostMessage, PostMessageNotificationPolicy, PostSoupAstRequest, PostSoupRequest, PresaveDocumentHandlerData, PresaveDocumentHandlerError, PresaveDocumentHandlerErrors, PresaveDocumentHandlerResponse, PresaveDocumentHandlerResponses, PreSaveDocumentRequest, PreSaveDocumentResponse, PreSaveDocumentResponseData, PresenceOperator, PresignedUrl, PreviewSmartTagData, PreviewSmartTagError, PreviewSmartTagErrors, PreviewSmartTagResponse, PreviewSmartTagResponses, Project, ProjectDeleteResponseData, ProjectDocumentStatus, ProjectFilters, ProjectPreview, ProjectPreviewData, PropertyBucketing, PropertyDateFilterRange, PropertyDateRange, PropertyDateRanges, PropertyDefinition, PropertyDefinitionWithOptions, PropertyFilter, PropertyInput, PropertyOption, PropertyOptionValue, PropertyOwner, PropertyValue, PutCrmTeamSettingsData, PutCrmTeamSettingsError, PutCrmTeamSettingsErrors, PutCrmTeamSettingsResponse, PutCrmTeamSettingsResponses, PutCrmTeamStagesData, PutCrmTeamStagesError, PutCrmTeamStagesErrors, PutCrmTeamStagesResponse, PutCrmTeamStagesResponses, PutFormLayoutData, PutFormLayoutError, PutFormLayoutErrors, PutFormLayoutResponse, PutFormLayoutResponses, QueryCrmPipelineRowsData, QueryCrmPipelineRowsResponse, QueryCrmPipelineRowsResponses, QueryDatabasesData, QueryDatabasesError, QueryDatabasesErrors, QueryDatabasesResponse, QueryDatabasesResponses, QueryDefinition, QuestionLayout, QuestionOption, QuestionTally, ReactionInput, RecentlyDeletedData, RecentlyDeletedError, RecentlyDeletedErrors, RecentlyDeletedResponse, RecentlyDeletedResponseData, RecentlyDeletedResponses, RegisterSlackImportUploadsData, RegisterSlackImportUploadsErrors, RegisterSlackImportUploadsResponse, RegisterSlackImportUploadsResponses, RegisterUploads, RemoveBotFromChannelByBotData, RemoveBotFromChannelByBotError, RemoveBotFromChannelByBotErrors, RemoveBotFromChannelByBotResponse, RemoveBotFromChannelByBotResponses, RemoveFavoriteByEntityData, RemoveFavoriteByEntityError, RemoveFavoriteByEntityErrors, RemoveFavoriteByEntityResponses, RemoveParticipantsData, RemoveParticipantsError, RemoveParticipantsErrors, RemoveParticipantsRequest, RemoveParticipantsResponses, RemovePinHandlerData, RemovePinHandlerError, RemovePinHandlerErrors, RemovePinHandlerResponse, RemovePinHandlerResponses, RenameChannelLabelData, RenameChannelLabelError, RenameChannelLabelErrors, RenameChannelLabelRequest, RenameChannelLabelResponse, RenameChannelLabelResponses, RenameCrmPipelineData, RenameCrmPipelineResponse, RenameCrmPipelineResponses, RenamePipeline, ReorderFavoritesData, ReorderFavoritesError, ReorderFavoritesErrors, ReorderFavoritesRequest, ReorderFavoritesResponses, ReorderPinRequest, ReorderPinsHandlerData, ReorderPinsHandlerError, ReorderPinsHandlerErrors, ReorderPinsHandlerResponse, ReorderPinsHandlerResponses, ReplaceCrmStagesRequest, RequestAccess, RequestAccountManagerBody, RequestAccountManagerData, RequestAccountManagerError, RequestAccountManagerErrors, RequestAccountManagerResponse, RequestAccountManagerResponses, RequestChannelAccessData, RequestChannelAccessError, RequestChannelAccessErrors, RequestChannelAccessResponse, RequestChannelAccessResponses, RequestedLayout, RequestStatus, RequestToJoinData, RequestToJoinError, RequestToJoinErrors, RequestToJoinResponse, RequestToJoinResponses, ResetCrmTeamStagesData, ResetCrmTeamStagesError, ResetCrmTeamStagesErrors, ResetCrmTeamStagesResponse, ResetCrmTeamStagesResponses, ResolveChannelAccessRequest, ResolveChannelAccessRequestData, ResolveChannelAccessRequestError, ResolveChannelAccessRequestErrors, ResolveChannelAccessRequestResponse, ResolveChannelAccessRequestResponses, ResolveRequest, RespondToAccountManagerRequestBody, RespondToAccountManagerRequestData, RespondToAccountManagerRequestError, RespondToAccountManagerRequestErrors, RespondToAccountManagerRequestResponse, RespondToAccountManagerRequestResponses, ResponseStatus, ResponseSummary, ResultColumn, ResultSet, RevertDeleteDocumentData, RevertDeleteDocumentError, RevertDeleteDocumentErrors, RevertDeleteDocumentResponse, RevertDeleteDocumentResponses, RevertDeleteProjectData, RevertDeleteProjectError, RevertDeleteProjectErrors, RevertDeleteProjectResponse, RevertDeleteProjectResponses, RevokeAccountManagerGrantData, RevokeAccountManagerGrantError, RevokeAccountManagerGrantErrors, RevokeAccountManagerGrantResponse, RevokeAccountManagerGrantResponses, RevokeBotTokenData, RevokeBotTokenError, RevokeBotTokenErrors, RevokeBotTokenResponse, RevokeBotTokenResponses, RingStatus, RingStatusResponse, RowChange, RowChangeKind, RowChanges, RowHistoryEntry, RowHistoryResponse, RowId, RowsChange, RowsResult, S3ObjectInfo, SaveBomPart, SaveDatabaseQueryData, SaveDatabaseQueryError, SaveDatabaseQueryErrors, SaveDatabaseQueryResponse, SaveDatabaseQueryResponses, SaveDocumentHandlerData, SaveDocumentHandlerError, SaveDocumentHandlerErrors, SaveDocumentHandlerResponse, SaveDocumentHandlerResponses, SaveDocumentRequest, SaveDocumentResponse, SaveDocumentResponseData, SavedQuery, SaveQueryRequest, SearchContactsData, SearchContactsError, SearchContactsErrors, SearchContactsResponse, SearchContactsResponse2, SearchContactsResponses, SearchState, SectionCount, SessionDeletedMetadata, SessionIdentity, SessionMentionedMetadata, SessionOpenedMetadata, SessionRenamedMetadata, SessionSettledMetadata, SessionSource, SessionStoppedMetadata, SetChannelLabelData, SetChannelLabelError, SetChannelLabelErrors, SetChannelLabelRequest, SetChannelLabelResponse, SetChannelLabelResponses, SetChannelPictureData, SetChannelPictureError, SetChannelPictureErrors, SetChannelPictureRequest, SetChannelPictureResponse, SetChannelPictureResponses, SetCompanyHiddenData, SetCompanyHiddenError, SetCompanyHiddenErrors, SetCompanyHiddenRequest, SetCompanyHiddenResponse, SetCompanyHiddenResponses, SetCompanyNameRequest, SetContactHiddenData, SetContactHiddenError, SetContactHiddenErrors, SetContactHiddenRequest, SetContactHiddenResponse, SetContactHiddenResponses, SetContactNameRequest, SetCrmCompanyNameData, SetCrmCompanyNameError, SetCrmCompanyNameErrors, SetCrmCompanyNameResponse, SetCrmCompanyNameResponses, SetCrmContactNameData, SetCrmContactNameError, SetCrmContactNameErrors, SetCrmContactNameResponse, SetCrmContactNameResponses, SetCrmPipelineStageRequirementData, SetCrmPipelineStageRequirementResponse, SetCrmPipelineStageRequirementResponses, SetDirectAccess, SetDocumentTeamShareData, SetDocumentTeamShareError, SetDocumentTeamShareErrors, SetDocumentTeamShareRequest, SetDocumentTeamShareResponse, SetDocumentTeamShareResponses, SetEmailFollowupData, SetEmailFollowupError, SetEmailFollowupErrors, SetEmailFollowupResponse, SetEmailFollowupResponses, SetEmailSyncData, SetEmailSyncError, SetEmailSyncErrors, SetEmailSyncRequest, SetEmailSyncResponse, SetEmailSyncResponses, SetOperator, SetPropertyValue, SetSkillDescriptionData, SetSkillDescriptionError, SetSkillDescriptionErrors, SetSkillDescriptionRequest, SetSkillDescriptionResponse, SetSkillDescriptionResponses, Sha256Digest, ShareCrmPipelineData, ShareCrmPipelineResponse, ShareCrmPipelineResponses, ShareDatabaseAwarenessData, ShareDatabaseAwarenessError, ShareDatabaseAwarenessErrors, ShareDatabaseAwarenessResponse, ShareDatabaseAwarenessResponses, SharedEmailFilter, SharedExternalChatReference, ShareEntity, ShareEntityType, SharePermissionV2, SharePipeline, ShortIdResponse, SimpleMention, SimpleSaveData, SimpleSaveError, SimpleSaveErrors, SimpleSaveResponse, SimpleSaveResponses, SkillDescriptionBody, SkippedCell, SlackCompleteRequest, SlackCreateRequest, SlackRegisterRequest, SlackTimestamp, SlackUserId, SmartTagChannelMatch, SmartTagPreview, SortDirection, SortKey, SoupAgentSessionSoupPropertiesField, SoupApiItem, SoupApiSort, SoupApiSortDirection, SoupAttachment, SoupCalendarEventSoupPropertiesField, SoupCalendarEventTime, SoupCallRecordGuest, SoupCallRecordParticipant, SoupCallRecordSoupPropertiesField, SoupChannel, SoupChannelThread, SoupChatSoupPropertiesField, SoupContact, SoupCountedReaction, SoupCrmCompanySoupPropertiesField, SoupCrmContactSoupPropertiesField, SoupCrmDomain, SoupDatabaseRowSoupPropertiesField, SoupDocumentSoupPropertiesField, SoupDocumentSubType, SoupEmailThreadPreview, SoupEnrichedEmailThreadPreviewSoupPropertiesField, SoupForeignEntity, SoupInitiativeSoupPropertiesField, SoupItem, SoupLabel, SoupLabelListVisibility, SoupLabelType, SoupMessageAttachment, SoupMessageListVisibility, SoupMessageSender, SoupMessageSenderType, SoupPage, SoupProjectSoupPropertiesField, SoupPropertiesField, SoupProperty, SoupThreadInfo, SoupThreadReply, SourceBinding, SourceId, SourceIdentity, SqlCell, SqlEntityKind, SqlOutcome, SqlOutcomeKind, SqlSelectOption, SqlStatement, StageRequirement, StarterDatabase, StarterDocumentsResponse, StorageRow, StorageRows, StorageRowsQuery, StoredGithubPullRequest, StreamEventsData, StreamEventsError, StreamEventsErrors, StreamEventsResponse, StreamEventsResponses, String, Submission, SubmissionOutcome, SubmitFormResponseData, SubmitFormResponseError, SubmitFormResponseErrors, SubmitFormResponseResponse, SubmitFormResponseResponses, SuccessResponse, SurfaceState, SyncServiceVersionId, SystemSkillSummary, Table, TableChange, TableChanged, TableChanges, TableDetail, TableId, TableResult, TableVersion, TagFilterMode, TakenId, TallyBucket, TallyValue, TaskFilters, TaskSimilarityResult, TaskSimilaritySearchHandlerData, TaskSimilaritySearchHandlerError, TaskSimilaritySearchHandlerErrors, TaskSimilaritySearchHandlerResponse, TaskSimilaritySearchHandlerResponses, TaskSimilaritySearchRequest, TaskSimilaritySearchResponse, TeamCalendarContent, TeamCalendarCoverage, TeamCalendarDetails, TeamCalendarItem, TeamCalendarMember, TeamCalendarPage, TeamCalendarSharing, TeamOutOfOfficeItem, TeamOutOfOfficeResponse, TeamRole, TextOperator, ThreadAnchor, ThreadOrigin, ThreadPatch, ThreadState, TimelineActivity, ToggleShareWithTeamData, ToggleShareWithTeamError, ToggleShareWithTeamErrors, ToggleShareWithTeamResponse, ToggleShareWithTeamResponses, TouchedColumn, TouchedRow, TranscribeDictationData, TranscribeDictationError, TranscribeDictationErrors, TranscribeDictationResponse, TranscribeDictationResponses, TranscribeResponse, TranscriptSegmentRequest, TrashCrmPipelineData, TrashCrmPipelineResponse, TrashCrmPipelineResponses, TrashPipeline, TurnEndedMetadata, TurnStartedMetadata, TurnSummary, TypedSuccessResponse, TypedSuccessResponseGetDocumentResponseData, TypingInput, UnblockCrmDomainData, UnblockCrmDomainError, UnblockCrmDomainErrors, UnblockCrmDomainResponse, UnblockCrmDomainResponses, UndoChangeResponse, UndoDatabaseChangeData, UndoDatabaseChangeError, UndoDatabaseChangeErrors, UndoDatabaseChangeResponse, UndoDatabaseChangeResponses, UndoOutcome, UndoRefusal, UnlockedBooking, UpdateAgentData, UpdateAgentError, UpdateAgentErrors, UpdateAgentRequest, UpdateAgentResponse, UpdateAgentResponses, UpdateChannelSharePermission, UpdateCrmPipelinePermissionsData, UpdateCrmPipelinePermissionsResponse, UpdateCrmPipelinePermissionsResponses, UpdateCrmTeamSettingsRequest, UpdateDatabasePermissionsData, UpdateDatabasePermissionsError, UpdateDatabasePermissionsErrors, UpdateDatabasePermissionsResponse, UpdateDatabasePermissionsResponses, UpdateForm, UpdateFormData, UpdateFormError, UpdateFormErrors, UpdateFormPermissionsData, UpdateFormPermissionsError, UpdateFormPermissionsErrors, UpdateFormPermissionsResponse, UpdateFormPermissionsResponses, UpdateFormResponse, UpdateFormResponses, UpdateInitiativeData, UpdateInitiativeError, UpdateInitiativeErrors, UpdateInitiativeRequest, UpdateInitiativeResponse, UpdateInitiativeResponses, UpdateMeetingRequest, UpdateOperation, UpdateSharePermissionRequestV2, UploadDescriptor, UploadDocumentStatus, UploadExtractFolderHandlerData, UploadExtractFolderHandlerError, UploadExtractFolderHandlerErrors, UploadExtractFolderHandlerResponse, UploadExtractFolderHandlerResponses, UploadExtractFolderRequest, UploadFileData, UploadFileError, UploadFileErrors, UploadFileResponse, UploadFileResponse2, UploadFileResponses, UploadFolderHandlerData, UploadFolderHandlerError, UploadFolderHandlerErrors, UploadFolderHandlerResponse, UploadFolderHandlerResponses, UploadFolderRequest, UploadGrant, UploadId, UpsertHistoryHandlerData, UpsertHistoryHandlerError, UpsertHistoryHandlerErrors, UpsertHistoryHandlerResponse, UpsertHistoryHandlerResponses, UpsertUserDocumentViewLocationData, UpsertUserDocumentViewLocationError, UpsertUserDocumentViewLocationErrors, UpsertUserDocumentViewLocationRequest, UpsertUserDocumentViewLocationResponse, UpsertUserDocumentViewLocationResponses, UserApiKeyId, UserApiKeyInfo, UserApiKeysList, UserDocumentsResponse, UserDocumentViewLocation, UserDocumentViewLocationResponse, UserPinsResponse, UserViewsResponse, ValidateDocumentPermissionsTokenData, ValidateDocumentPermissionsTokenError, ValidateDocumentPermissionsTokenErrors, ValidateDocumentPermissionsTokenResponse, ValidateDocumentPermissionsTokenResponses, ValidateWebhookData, ValidateWebhookError, ValidateWebhookErrors, ValidateWebhookResponse, ValidateWebhookResponse2, ValidateWebhookResponses, Vec, VersionedTable, View, ViewChange, ViewColumn, ViewerCapabilities, ViewLayout, ViewPatch, ViewPosition, ViewPositionsResponse, ViewQuery, ViewResult, ViewsResponse, WaitingForInputMetadata, Webhook, WebhookEvent, WebhookFilter, WebhookScope, WebhookStatus, WebhookValidationTestEvent, WhatsAppAccount, WhatsappAccountData, WhatsappAccountResponse, WhatsappAccountResponses, WhatsAppAccountState, WhatsAppAccountView, WhatsappCancelPairingData, WhatsappCancelPairingResponse, WhatsappCancelPairingResponses, WhatsAppCannotAdd, WhatsAppChat, WhatsAppChats, WhatsappChatsData, WhatsappChatsResponse, WhatsappChatsResponses, WhatsAppConnect, WhatsappConnectData, WhatsappConnectResponse, WhatsappConnectResponses, WhatsAppDisconnect, WhatsappDisconnectData, WhatsAppDisconnectRequest, WhatsappDisconnectResponse, WhatsappDisconnectResponses, WhatsAppHistoryImport, WhatsappImportHistoryData, WhatsappImportHistoryResponse, WhatsappImportHistoryResponses, WhatsAppLookup, WhatsappLookupData, WhatsAppLookupRequest, WhatsappLookupResponse, WhatsappLookupResponses, WhatsAppLookupState, WhatsAppPairing, WhatsappPairingData, WhatsappPairingResponse, WhatsappPairingResponses, WhatsAppPairingState, WhatsAppPairState, WhatsappPasskeyData, WhatsappPasskeyResponse, WhatsappPasskeyResponses, WhatsappStartLookupData, WhatsappStartLookupResponse, WhatsappStartLookupResponses, Widget, WithCallId, WithChannelId, WithDocumentId, WithProjectId } from './types.gen';
diff --git a/packages/sdk/generated/storage/sdk.gen.ts b/packages/sdk/generated/storage/sdk.gen.ts
index cae1d11040..550db9e0e2 100644
--- a/packages/sdk/generated/storage/sdk.gen.ts
+++ b/packages/sdk/generated/storage/sdk.gen.ts
@@ -2,7 +2,7 @@
import { type Client, type ClientMeta, formDataBodySerializer, type Options as Options2, type RequestResult, type ServerSentEventsResult, type TDataShape } from './client';
import { client } from './client.gen';
-import type { AccessRequestsCancelData, AccessRequestsCancelErrors, AccessRequestsCancelResponses, AccessRequestsDirectData, AccessRequestsDirectErrors, AccessRequestsDirectResponses, AccessRequestsRemoveDirectData, AccessRequestsRemoveDirectErrors, AccessRequestsRemoveDirectResponses, AccessRequestsResolveData, AccessRequestsResolveErrors, AccessRequestsResolveResponses, AccessRequestsSetDirectData, AccessRequestsSetDirectErrors, AccessRequestsSetDirectResponses, AccessRequestsStateData, AccessRequestsStateErrors, AccessRequestsStateResponses, AccessRequestsSubmitData, AccessRequestsSubmitErrors, AccessRequestsSubmitResponses, AddChannelBotData, AddChannelBotErrors, AddChannelBotResponses, AddFavoriteData, AddFavoriteErrors, AddFavoriteResponses, AddParticipantsData, AddParticipantsErrors, AddParticipantsResponses, AddPinHandlerData, AddPinHandlerErrors, AddPinHandlerResponses, ApplyCrmPipelineOpsData, ApplyCrmPipelineOpsResponses, ApplyDatabaseOpsData, ApplyDatabaseOpsErrors, ApplyDatabaseOpsResponses, ApproveHarnessPairingData, ApproveHarnessPairingErrors, ApproveHarnessPairingResponses, BlockCrmDomainData, BlockCrmDomainErrors, BlockCrmDomainResponses, BulkWakeupSyncServiceDocumentsData, BulkWakeupSyncServiceDocumentsErrors, BulkWakeupSyncServiceDocumentsResponses, CallWebhookData, CallWebhookErrors, CallWebhookResponses, CancelChannelAccessRequestData, CancelChannelAccessRequestErrors, CancelChannelAccessRequestResponses, CancelSlackImportData, CancelSlackImportErrors, CancelSlackImportResponses, CheckActiveCallData, CheckActiveCallErrors, CheckActiveCallResponses, ClaimHarnessPairingData, ClaimHarnessPairingErrors, ClaimHarnessPairingResponses, CollaborateFormData, CollaborateFormErrors, CollaborateFormResponses, CompleteSlackImportUploadsData, CompleteSlackImportUploadsErrors, CompleteSlackImportUploadsResponses, ConvertDatabaseColumnData, ConvertDatabaseColumnErrors, ConvertDatabaseColumnResponses, CopyDocumentData, CopyDocumentErrors, CopyDocumentResponses, CreateAgentData, CreateAgentErrors, CreateAgentResponses, CreateAnchorData, CreateAnchorErrors, CreateAnchorResponses, CreateBotData, CreateBotErrors, CreateBotResponses, CreateBotTokenData, CreateBotTokenErrors, CreateBotTokenResponses, CreateCanvasHandlerData, CreateCanvasHandlerErrors, CreateCanvasHandlerResponses, CreateChannelData, CreateChannelErrors, CreateChannelLabelData, CreateChannelLabelErrors, CreateChannelLabelResponses, CreateChannelResponses, CreateChannelScopedBotData, CreateChannelScopedBotErrors, CreateChannelScopedBotResponses, CreateCollabSurfaceTokenData, CreateCollabSurfaceTokenErrors, CreateCollabSurfaceTokenResponses, CreateCrmCompanyData, CreateCrmCompanyErrors, CreateCrmCompanyResponses, CreateCrmContactData, CreateCrmContactErrors, CreateCrmContactResponses, CreateCrmPipelineData, CreateCrmPipelineResponses, CreateCrmTeamContactData, CreateCrmTeamContactErrors, CreateCrmTeamContactResponses, CreateDatabaseData, CreateDatabaseErrors, CreateDatabaseResponses, CreateDatabaseWebhookData, CreateDatabaseWebhookErrors, CreateDatabaseWebhookResponses, CreateDocumentData, CreateDocumentErrors, CreateDocumentResponses, CreateEntityMentionData, CreateEntityMentionErrors, CreateEntityMentionResponses, CreateFormData, CreateFormErrors, CreateFormResponses, CreateHarnessPairingData, CreateHarnessPairingErrors, CreateHarnessPairingResponses, CreateInitiativeData, CreateInitiativeErrors, CreateInitiativeResponses, CreateInstructionsHandlerData, CreateInstructionsHandlerErrors, CreateInstructionsHandlerResponses, CreateMarkdownHandlerData, CreateMarkdownHandlerErrors, CreateMarkdownHandlerResponses, CreateProjectHandlerData, CreateProjectHandlerErrors, CreateProjectHandlerResponses, CreateSkillHandlerData, CreateSkillHandlerErrors, CreateSkillHandlerResponses, CreateSlackImportData, CreateSlackImportErrors, CreateSlackImportResponses, CreateSnippetHandlerData, CreateSnippetHandlerErrors, CreateSnippetHandlerResponses, CreateTaskHandlerData, CreateTaskHandlerErrors, CreateTaskHandlerResponses, CreateUserApiKeyData, CreateUserApiKeyErrors, CreateUserApiKeyResponses, CreateViewHandlerData, CreateViewHandlerErrors, CreateViewHandlerResponses, CreateWebhookData, CreateWebhookErrors, CreateWebhookResponses, DeclineCallData, DeclineCallErrors, DeclineCallResponses, DeclineRingData, DeclineRingErrors, DeclineRingResponses, DeleteAnchorData, DeleteAnchorErrors, DeleteAnchorResponses, DeleteBotData, DeleteBotErrors, DeleteBotResponses, DeleteCallRecordData, DeleteCallRecordErrors, DeleteCallRecordResponses, DeleteChannelData, DeleteChannelErrors, DeleteChannelLabelData, DeleteChannelLabelErrors, DeleteChannelLabelResponses, DeleteChannelResponses, DeleteCollabSurfaceData, DeleteCollabSurfaceErrors, DeleteCollabSurfaceResponses, DeleteDatabaseWebhookData, DeleteDatabaseWebhookErrors, DeleteDatabaseWebhookResponses, DeleteDocumentData, DeleteDocumentErrors, DeleteDocumentResponses, DeleteEntityMentionData, DeleteEntityMentionErrors, DeleteEntityMentionResponses, DeleteHarnessData, DeleteHarnessErrors, DeleteHarnessResponses, DeleteHistoryHandlerData, DeleteHistoryHandlerErrors, DeleteHistoryHandlerResponses, DeleteInitiativeData, DeleteInitiativeErrors, DeleteInitiativeResponses, DeleteProjectHandlerData, DeleteProjectHandlerErrors, DeleteProjectHandlerResponses, DeleteSelfHarnessData, DeleteSelfHarnessErrors, DeleteSelfHarnessResponses, DeleteUserApiKeyData, DeleteUserApiKeyErrors, DeleteUserApiKeyResponses, DeleteUserDocumentViewLocationData, DeleteUserDocumentViewLocationErrors, DeleteUserDocumentViewLocationResponses, DeleteViewHandlerData, DeleteViewHandlerErrors, DeleteViewHandlerResponses, DeleteWebhookData, DeleteWebhookErrors, DeleteWebhookResponses, DeliverDatabaseWebhookData, DeliverDatabaseWebhookErrors, DeliverDatabaseWebhookResponses, DuplicateDatabaseData, DuplicateDatabaseErrors, DuplicateDatabaseResponses, EditAnchorData, EditAnchorErrors, EditAnchorResponses, EditCallRecordData, EditCallRecordErrors, EditCallRecordResponses, EditCallTranscriptData, EditCallTranscriptErrors, EditCallTranscriptResponses, EditDocumentData, EditDocumentErrors, EditDocumentResponses, EditDocumentWithAiData, EditDocumentWithAiErrors, EditDocumentWithAiResponses, EditMyFormResponseData, EditMyFormResponseErrors, EditMyFormResponseResponses, EditProjectV2Data, EditProjectV2Errors, EditProjectV2Responses, EditThreadV2Data, EditThreadV2Errors, EditThreadV2Responses, EnsureCollabSurfaceData, EnsureCollabSurfaceErrors, EnsureCollabSurfaceResponses, EnsureStarterHandlerData, EnsureStarterHandlerErrors, EnsureStarterHandlerResponses, EntityMessageCreateData, EntityMessageCreateResponses, EntityMessageDeleteMessageData, EntityMessageDeleteMessageResponses, EntityMessageDeleteThreadData, EntityMessageDeleteThreadResponses, EntityMessageEditData, EntityMessageEditResponses, EntityMessageGetMessageData, EntityMessageGetMessageResponses, EntityMessageGetThreadData, EntityMessageGetThreadResponses, EntityMessageLegacyData, EntityMessageLegacyResponses, EntityMessagePatchThreadData, EntityMessagePatchThreadResponses, EntityMessageReactData, EntityMessageReactResponses, EntityMessageTypingData, EntityMessageTypingResponses, EventIcsData, EventIcsErrors, EventIcsResponses, ExcludeDefaultViewHandlerData, ExcludeDefaultViewHandlerErrors, ExcludeDefaultViewHandlerResponses, ExportDocumentData, ExportDocumentErrors, ExportDocumentResponses, ExternalChatAddData, ExternalChatAddResponses, ExternalChatData, ExternalChatDeliveryData, ExternalChatDeliveryResponses, ExternalChatMessageAttachmentsData, ExternalChatMessageAttachmentsResponses, ExternalChatMessageData, ExternalChatMessageResponses, ExternalChatMessagesData, ExternalChatMessagesResponses, ExternalChatPermissionsData, ExternalChatPermissionsResponses, ExternalChatReadData, ExternalChatReadResponses, ExternalChatRemoveData, ExternalChatRemoveResponses, ExternalChatResponses, ExternalChatsData, ExternalChatSendData, ExternalChatSendErrors, ExternalChatSendResponses, ExternalChatSendsData, ExternalChatSendsResponses, ExternalChatsResponses, ExternalChatUpdatePermissionsData, ExternalChatUpdatePermissionsResponses, ExternalChatUploadData, ExternalChatUploadResponses, FinalizeSlackImportData, FinalizeSlackImportErrors, FinalizeSlackImportResponses, GetActiveCallsData, GetActiveCallsErrors, GetActiveCallsResponses, GetActivityData, GetActivityErrors, GetActivityResponses, GetAttachmentReferencesData, GetAttachmentReferencesErrors, GetAttachmentReferencesResponses, GetBatchCallRecordPreviewData, GetBatchCallRecordPreviewErrors, GetBatchCallRecordPreviewResponses, GetBatchChannelPreviewData, GetBatchChannelPreviewErrors, GetBatchChannelPreviewResponses, GetBatchPreviewHandlerData, GetBatchPreviewHandlerErrors, GetBatchPreviewHandlerResponses, GetBatchProjectPreviewData, GetBatchProjectPreviewErrors, GetBatchProjectPreviewResponses, GetBotData, GetBotErrors, GetBotOwnerProfilesData, GetBotOwnerProfilesErrors, GetBotOwnerProfilesResponses, GetBotResponses, GetCallRecordData, GetCallRecordErrors, GetCallRecordResponses, GetChannelAccessRequestData, GetChannelAccessRequestErrors, GetChannelAccessRequestResponses, GetChannelAttachmentsData, GetChannelAttachmentsErrors, GetChannelAttachmentsResponses, GetChannelData, GetChannelErrors, GetChannelJoinLinkData, GetChannelJoinLinkErrors, GetChannelJoinLinkResponses, GetChannelParticipantsData, GetChannelParticipantsErrors, GetChannelParticipantsResponses, GetChannelResponses, GetChannelsData, GetChannelsErrors, GetChannelsResponses, GetCollabSurfaceData, GetCollabSurfaceErrors, GetCollabSurfaceResponses, GetCompanyData, GetCompanyErrors, GetCompanyResponses, GetContactByEmailData, GetContactByEmailErrors, GetContactByEmailResponses, GetContactData, GetContactErrors, GetContactResponses, GetCrmPipelineData, GetCrmPipelinePermissionsData, GetCrmPipelinePermissionsResponses, GetCrmPipelineResponses, GetCrmPipelineRowsData, GetCrmPipelineRowsResponses, GetCrmPipelineStageRequirementsData, GetCrmPipelineStageRequirementsResponses, GetCrmPipelineTableData, GetCrmPipelineTableResponses, GetCrmPipelineViewPositionsData, GetCrmPipelineViewPositionsResponses, GetCrmTeamSettingsData, GetCrmTeamSettingsErrors, GetCrmTeamSettingsResponses, GetDatabaseData, GetDatabaseErrors, GetDatabasePermissionsData, GetDatabasePermissionsErrors, GetDatabasePermissionsResponses, GetDatabaseQueryData, GetDatabaseQueryErrors, GetDatabaseQueryResponses, GetDatabaseResponses, GetDatabaseRowHistoryData, GetDatabaseRowHistoryErrors, GetDatabaseRowHistoryResponses, GetDatabaseTableChangesData, GetDatabaseTableChangesErrors, GetDatabaseTableChangesResponses, GetDatabaseViewPositionsData, GetDatabaseViewPositionsErrors, GetDatabaseViewPositionsResponses, GetDocumentAnchorsData, GetDocumentAnchorsErrors, GetDocumentAnchorsResponses, GetDocumentBranchNameData, GetDocumentBranchNameErrors, GetDocumentBranchNameResponses, GetDocumentByTeamSlugData, GetDocumentByTeamSlugErrors, GetDocumentByTeamSlugResponses, GetDocumentData, GetDocumentErrors, GetDocumentGithubPullRequestsData, GetDocumentGithubPullRequestsErrors, GetDocumentGithubPullRequestsResponses, GetDocumentListHandlerData, GetDocumentListHandlerErrors, GetDocumentListHandlerResponses, GetDocumentLocationV3Data, GetDocumentLocationV3Errors, GetDocumentLocationV3Responses, GetDocumentPermissionsTokenData, GetDocumentPermissionsTokenErrors, GetDocumentPermissionsTokenResponses, GetDocumentPermissionsV2Data, GetDocumentPermissionsV2Errors, GetDocumentPermissionsV2Responses, GetDocumentProcessingResultData, GetDocumentProcessingResultErrors, GetDocumentProcessingResultResponses, GetDocumentResponses, GetDocumentShortIdData, GetDocumentShortIdErrors, GetDocumentShortIdResponses, GetDocumentTeamShareData, GetDocumentTeamShareErrors, GetDocumentTeamShareResponses, GetDocumentTextContentData, GetDocumentTextContentErrors, GetDocumentTextContentResponses, GetDocumentVersionData, GetDocumentVersionErrors, GetDocumentVersionResponses, GetDocumentViewsHandlerData, GetDocumentViewsHandlerErrors, GetDocumentViewsHandlerResponses, GetEmailFollowupData, GetEmailFollowupErrors, GetEmailFollowupResponses, GetEntityPermissionData, GetEntityPermissionErrors, GetEntityPermissionResponses, GetForeignEntityBySourceData, GetForeignEntityBySourceErrors, GetForeignEntityBySourceResponses, GetForeignEntityData, GetForeignEntityErrors, GetForeignEntityResponses, GetFormData, GetFormErrors, GetFormPermissionsData, GetFormPermissionsErrors, GetFormPermissionsResponses, GetFormResponses, GetFormResponseSummaryData, GetFormResponseSummaryErrors, GetFormResponseSummaryResponses, GetFormTallyData, GetFormTallyErrors, GetFormTallyResponses, GetGithubPullRequestChangesData, GetGithubPullRequestChangesErrors, GetGithubPullRequestChangesPatchData, GetGithubPullRequestChangesPatchErrors, GetGithubPullRequestChangesPatchResponses, GetGithubPullRequestChangesResponses, GetGithubPullRequestData, GetGithubPullRequestErrors, GetGithubPullRequestFacetsData, GetGithubPullRequestFacetsErrors, GetGithubPullRequestFacetsResponses, GetGithubPullRequestResponses, GetGithubPullRequestTasksData, GetGithubPullRequestTasksErrors, GetGithubPullRequestTasksResponses, GetHarnessPairingData, GetHarnessPairingErrors, GetHarnessPairingResponses, GetHistoryHandlerData, GetHistoryHandlerErrors, GetHistoryHandlerResponses, GetInitiativeData, GetInitiativeErrors, GetInitiativeResponses, GetInstructionsHandlerData, GetInstructionsHandlerErrors, GetInstructionsHandlerResponses, GetItemsSoupData, GetItemsSoupErrors, GetItemsSoupResponses, GetLocationHandlerData, GetLocationHandlerErrors, GetLocationHandlerResponses, GetMyChannelAccessRequestData, GetMyChannelAccessRequestErrors, GetMyChannelAccessRequestResponses, GetMyFormResponseData, GetMyFormResponseErrors, GetMyFormResponseResponses, GetOrCreateCallData, GetOrCreateCallErrors, GetOrCreateCallResponses, GetOrCreateDmData, GetOrCreateDmErrors, GetOrCreateDmResponses, GetOrCreatePrivateData, GetOrCreatePrivateErrors, GetOrCreatePrivateResponses, GetPendingProjectsHandlerData, GetPendingProjectsHandlerErrors, GetPendingProjectsHandlerResponses, GetPinsHandlerData, GetPinsHandlerErrors, GetPinsHandlerResponses, GetProjectContentHandlerData, GetProjectContentHandlerErrors, GetProjectContentHandlerResponses, GetProjectHandlerData, GetProjectHandlerErrors, GetProjectHandlerResponses, GetProjectPermissionsV2Data, GetProjectPermissionsV2Errors, GetProjectPermissionsV2Responses, GetProjectsHandlerData, GetProjectsHandlerErrors, GetProjectsHandlerResponses, GetProjectUserAccessLevelData, GetProjectUserAccessLevelErrors, GetProjectUserAccessLevelResponses, GetRingStatusData, GetRingStatusErrors, GetRingStatusResponses, GetSelfBotData, GetSelfBotErrors, GetSelfBotResponses, GetSelfHarnessData, GetSelfHarnessErrors, GetSelfHarnessResponses, GetSkillDescriptionData, GetSkillDescriptionErrors, GetSkillDescriptionResponses, GetSlackImportData, GetSlackImportErrors, GetSlackImportResponses, GetSystemSkillsHandlerData, GetSystemSkillsHandlerErrors, GetSystemSkillsHandlerResponses, GetUserDocumentsHandlerData, GetUserDocumentsHandlerErrors, GetUserDocumentsHandlerResponses, GetUserDocumentViewLocationData, GetUserDocumentViewLocationErrors, GetUserDocumentViewLocationResponses, GetViewsHandlerData, GetViewsHandlerErrors, GetViewsHandlerResponses, GetWebhookData, GetWebhookErrors, GetWebhookResponses, GuestCallChatPostData, GuestCallChatPostErrors, GuestCallChatPostResponses, GuestCallChatReadData, GuestCallChatReadErrors, GuestCallChatReadResponses, HandlerData, HandlerErrors, HandlerResponses, HealthHandlerData, HealthHandlerResponses, ImportDatabaseTableData, ImportDatabaseTableErrors, ImportDatabaseTableResponses, InferDatabaseColumnTypeData, InferDatabaseColumnTypeErrors, InferDatabaseColumnTypeResponses, IngestTranscriptData, IngestTranscriptErrors, IngestTranscriptResponses, InitializeUserDocumentsData, InitializeUserDocumentsErrors, InitializeUserDocumentsResponses, InstallSyncData, InstallSyncErrors, JobProcessingResultHandlerData, JobProcessingResultHandlerErrors, JobProcessingResultHandlerResponses, JoinChannelByCodeData, JoinChannelByCodeErrors, JoinChannelByCodeResponses, JoinChannelData, JoinChannelErrors, JoinChannelResponses, LeaveChannelData, LeaveChannelErrors, LeaveChannelResponses, LeaveOrEndCallData, LeaveOrEndCallErrors, LeaveOrEndCallResponses, ListAccessibleFormsData, ListAccessibleFormsErrors, ListAccessibleFormsResponses, ListAgentsData, ListAgentsErrors, ListAgentsResponses, ListBotChannelsData, ListBotChannelsErrors, ListBotChannelsResponses, ListBotsData, ListBotsErrors, ListBotsResponses, ListBotTokensData, ListBotTokensErrors, ListBotTokensResponses, ListChannelBotsData, ListChannelBotsErrors, ListChannelBotsResponses, ListChannelLabelsData, ListChannelLabelsErrors, ListChannelLabelsResponses, ListCompanyContactsData, ListCompanyContactsErrors, ListCompanyContactsResponses, ListCrmBlockedDomainsData, ListCrmBlockedDomainsErrors, ListCrmBlockedDomainsResponses, ListCrmPipelinesData, ListCrmPipelinesResponses, ListDatabaseColumnCastsData, ListDatabaseColumnCastsErrors, ListDatabaseColumnCastsResponses, ListDatabasesData, ListDatabasesErrors, ListDatabasesResponses, ListDatabaseWebhooksData, ListDatabaseWebhooksErrors, ListDatabaseWebhooksResponses, ListEmailRemindersData, ListEmailRemindersErrors, ListEmailRemindersResponses, ListFavoritesData, ListFavoritesErrors, ListFavoritesResponses, ListFormsData, ListFormsErrors, ListFormsResponses, ListHarnessAgentsData, ListHarnessAgentsErrors, ListHarnessAgentsResponses, ListHarnessesData, ListHarnessesErrors, ListHarnessesResponses, ListHarnessSessionsData, ListHarnessSessionsErrors, ListHarnessSessionsResponses, ListInitiativesData, ListInitiativesErrors, ListInitiativesResponses, ListJoinRequestsData, ListJoinRequestsErrors, ListJoinRequestsResponses, ListOccurrencesData, ListOccurrencesErrors, ListOccurrencesResponses, ListSlackImportsData, ListSlackImportsResponses, ListTeamCalendarData, ListTeamCalendarResponses, ListTeamOutOfOfficeData, ListTeamOutOfOfficeErrors, ListTeamOutOfOfficeResponses, ListUserApiKeysData, ListUserApiKeysErrors, ListUserApiKeysResponses, ListWebhooksData, ListWebhooksErrors, ListWebhooksResponses, MeetingCancelData, MeetingCancelErrors, MeetingCancelPreparationData, MeetingCancelPreparationErrors, MeetingCancelPreparationResponses, MeetingCancelResponses, MeetingCreateData, MeetingCreateErrors, MeetingCreateResponses, MeetingGuestJoinData, MeetingGuestJoinErrors, MeetingGuestJoinResponses, MeetingGuestParticipantsData, MeetingGuestParticipantsErrors, MeetingGuestParticipantsResponses, MeetingInviteData, MeetingInviteErrors, MeetingInvitePermissionsData, MeetingInvitePermissionsErrors, MeetingInvitePermissionsResponses, MeetingInviteResponses, MeetingInviteUsersData, MeetingInviteUsersErrors, MeetingInviteUsersResponses, MeetingJoinData, MeetingJoinErrors, MeetingJoinResponses, MeetingLeaveData, MeetingLeaveErrors, MeetingLeaveResponses, MeetingListActiveData, MeetingListActiveErrors, MeetingListActiveResponses, MeetingListData, MeetingListErrors, MeetingListResponses, MeetingLookupData, MeetingLookupErrors, MeetingLookupResponses, MeetingParticipantsData, MeetingParticipantsErrors, MeetingParticipantsResponses, MeetingPrepareData, MeetingPrepareErrors, MeetingPrepareResponses, MeetingShareData, MeetingShareErrors, MeetingShareResponses, MeetingUpdateData, MeetingUpdateErrors, MeetingUpdateResponses, MentionPreviewsData, MentionPreviewsErrors, MentionPreviewsResponses, MessageTimelineData, MessageTimelineEntriesData, MessageTimelineEntriesResponses, MessageTimelineResponses, PatchBotData, PatchBotErrors, PatchBotResponses, PatchChannelData, PatchChannelErrors, PatchChannelResponses, PatchHarnessData, PatchHarnessErrors, PatchHarnessResponses, PatchViewHandlerData, PatchViewHandlerErrors, PatchViewHandlerResponses, PatchWebhookData, PatchWebhookErrors, PatchWebhookResponses, PermanentlyDeleteDocumentData, PermanentlyDeleteDocumentErrors, PermanentlyDeleteDocumentResponses, PermanentlyDeleteProjectData, PermanentlyDeleteProjectErrors, PermanentlyDeleteProjectResponses, PostActivityData, PostActivityErrors, PostActivityResponses, PostChannelBotWebhookData, PostChannelBotWebhookErrors, PostChannelBotWebhookResponses, PostItemsSoupAstData, PostItemsSoupAstErrors, PostItemsSoupAstGroupedData, PostItemsSoupAstGroupedErrors, PostItemsSoupAstGroupedResponses, PostItemsSoupAstResponses, PostItemsSoupData, PostItemsSoupErrors, PostItemsSoupResponses, PresaveDocumentHandlerData, PresaveDocumentHandlerErrors, PresaveDocumentHandlerResponses, PreviewSmartTagData, PreviewSmartTagErrors, PreviewSmartTagResponses, PutCrmTeamSettingsData, PutCrmTeamSettingsErrors, PutCrmTeamSettingsResponses, PutCrmTeamStagesData, PutCrmTeamStagesErrors, PutCrmTeamStagesResponses, PutFormLayoutData, PutFormLayoutErrors, PutFormLayoutResponses, QueryCrmPipelineRowsData, QueryCrmPipelineRowsResponses, QueryDatabasesData, QueryDatabasesErrors, QueryDatabasesResponses, RecentlyDeletedData, RecentlyDeletedErrors, RecentlyDeletedResponses, RegisterSlackImportUploadsData, RegisterSlackImportUploadsErrors, RegisterSlackImportUploadsResponses, RemoveBotFromChannelByBotData, RemoveBotFromChannelByBotErrors, RemoveBotFromChannelByBotResponses, RemoveFavoriteByEntityData, RemoveFavoriteByEntityErrors, RemoveFavoriteByEntityResponses, RemoveParticipantsData, RemoveParticipantsErrors, RemoveParticipantsResponses, RemovePinHandlerData, RemovePinHandlerErrors, RemovePinHandlerResponses, RenameChannelLabelData, RenameChannelLabelErrors, RenameChannelLabelResponses, RenameCrmPipelineData, RenameCrmPipelineResponses, ReorderFavoritesData, ReorderFavoritesErrors, ReorderFavoritesResponses, ReorderPinsHandlerData, ReorderPinsHandlerErrors, ReorderPinsHandlerResponses, RequestChannelAccessData, RequestChannelAccessErrors, RequestChannelAccessResponses, RequestToJoinData, RequestToJoinErrors, RequestToJoinResponses, ResetCrmTeamStagesData, ResetCrmTeamStagesErrors, ResetCrmTeamStagesResponses, ResolveChannelAccessRequestData, ResolveChannelAccessRequestErrors, ResolveChannelAccessRequestResponses, RevertDeleteDocumentData, RevertDeleteDocumentErrors, RevertDeleteDocumentResponses, RevertDeleteProjectData, RevertDeleteProjectErrors, RevertDeleteProjectResponses, RevokeBotTokenData, RevokeBotTokenErrors, RevokeBotTokenResponses, SaveDatabaseQueryData, SaveDatabaseQueryErrors, SaveDatabaseQueryResponses, SaveDocumentHandlerData, SaveDocumentHandlerErrors, SaveDocumentHandlerResponses, SearchContactsData, SearchContactsErrors, SearchContactsResponses, SetChannelLabelData, SetChannelLabelErrors, SetChannelLabelResponses, SetChannelPictureData, SetChannelPictureErrors, SetChannelPictureResponses, SetCompanyHiddenData, SetCompanyHiddenErrors, SetCompanyHiddenResponses, SetContactHiddenData, SetContactHiddenErrors, SetContactHiddenResponses, SetCrmCompanyNameData, SetCrmCompanyNameErrors, SetCrmCompanyNameResponses, SetCrmContactNameData, SetCrmContactNameErrors, SetCrmContactNameResponses, SetCrmPipelineStageRequirementData, SetCrmPipelineStageRequirementResponses, SetDocumentTeamShareData, SetDocumentTeamShareErrors, SetDocumentTeamShareResponses, SetEmailFollowupData, SetEmailFollowupErrors, SetEmailFollowupResponses, SetEmailSyncData, SetEmailSyncErrors, SetEmailSyncResponses, SetSkillDescriptionData, SetSkillDescriptionErrors, SetSkillDescriptionResponses, ShareCrmPipelineData, ShareCrmPipelineResponses, ShareDatabaseAwarenessData, ShareDatabaseAwarenessErrors, ShareDatabaseAwarenessResponses, SimpleSaveData, SimpleSaveErrors, SimpleSaveResponses, StreamEventsData, StreamEventsErrors, StreamEventsResponse, StreamEventsResponses, SubmitFormResponseData, SubmitFormResponseErrors, SubmitFormResponseResponses, TaskSimilaritySearchHandlerData, TaskSimilaritySearchHandlerErrors, TaskSimilaritySearchHandlerResponses, ToggleShareWithTeamData, ToggleShareWithTeamErrors, ToggleShareWithTeamResponses, TranscribeDictationData, TranscribeDictationErrors, TranscribeDictationResponses, TrashCrmPipelineData, TrashCrmPipelineResponses, UnblockCrmDomainData, UnblockCrmDomainErrors, UnblockCrmDomainResponses, UndoDatabaseChangeData, UndoDatabaseChangeErrors, UndoDatabaseChangeResponses, UpdateAgentData, UpdateAgentErrors, UpdateAgentResponses, UpdateCrmPipelinePermissionsData, UpdateCrmPipelinePermissionsResponses, UpdateDatabasePermissionsData, UpdateDatabasePermissionsErrors, UpdateDatabasePermissionsResponses, UpdateFormData, UpdateFormErrors, UpdateFormPermissionsData, UpdateFormPermissionsErrors, UpdateFormPermissionsResponses, UpdateFormResponses, UpdateInitiativeData, UpdateInitiativeErrors, UpdateInitiativeResponses, UploadExtractFolderHandlerData, UploadExtractFolderHandlerErrors, UploadExtractFolderHandlerResponses, UploadFileData, UploadFileErrors, UploadFileResponses, UploadFolderHandlerData, UploadFolderHandlerErrors, UploadFolderHandlerResponses, UpsertHistoryHandlerData, UpsertHistoryHandlerErrors, UpsertHistoryHandlerResponses, UpsertUserDocumentViewLocationData, UpsertUserDocumentViewLocationErrors, UpsertUserDocumentViewLocationResponses, ValidateDocumentPermissionsTokenData, ValidateDocumentPermissionsTokenErrors, ValidateDocumentPermissionsTokenResponses, ValidateWebhookData, ValidateWebhookErrors, ValidateWebhookResponses, WhatsappAccountData, WhatsappAccountResponses, WhatsappCancelPairingData, WhatsappCancelPairingResponses, WhatsappChatsData, WhatsappChatsResponses, WhatsappConnectData, WhatsappConnectResponses, WhatsappDisconnectData, WhatsappDisconnectResponses, WhatsappImportHistoryData, WhatsappImportHistoryResponses, WhatsappLookupData, WhatsappLookupResponses, WhatsappPairingData, WhatsappPairingResponses, WhatsappPasskeyData, WhatsappPasskeyResponses, WhatsappStartLookupData, WhatsappStartLookupResponses } from './types.gen';
+import type { AccessRequestsCancelData, AccessRequestsCancelErrors, AccessRequestsCancelResponses, AccessRequestsDirectData, AccessRequestsDirectErrors, AccessRequestsDirectResponses, AccessRequestsRemoveDirectData, AccessRequestsRemoveDirectErrors, AccessRequestsRemoveDirectResponses, AccessRequestsResolveData, AccessRequestsResolveErrors, AccessRequestsResolveResponses, AccessRequestsSetDirectData, AccessRequestsSetDirectErrors, AccessRequestsSetDirectResponses, AccessRequestsStateData, AccessRequestsStateErrors, AccessRequestsStateResponses, AccessRequestsSubmitData, AccessRequestsSubmitErrors, AccessRequestsSubmitResponses, AddChannelBotData, AddChannelBotErrors, AddChannelBotResponses, AddFavoriteData, AddFavoriteErrors, AddFavoriteResponses, AddParticipantsData, AddParticipantsErrors, AddParticipantsResponses, AddPinHandlerData, AddPinHandlerErrors, AddPinHandlerResponses, ApplyCrmPipelineOpsData, ApplyCrmPipelineOpsResponses, ApplyDatabaseOpsData, ApplyDatabaseOpsErrors, ApplyDatabaseOpsResponses, ApproveHarnessPairingData, ApproveHarnessPairingErrors, ApproveHarnessPairingResponses, BlockCrmDomainData, BlockCrmDomainErrors, BlockCrmDomainResponses, BulkWakeupSyncServiceDocumentsData, BulkWakeupSyncServiceDocumentsErrors, BulkWakeupSyncServiceDocumentsResponses, CallWebhookData, CallWebhookErrors, CallWebhookResponses, CancelChannelAccessRequestData, CancelChannelAccessRequestErrors, CancelChannelAccessRequestResponses, CancelSlackImportData, CancelSlackImportErrors, CancelSlackImportResponses, CheckActiveCallData, CheckActiveCallErrors, CheckActiveCallResponses, ClaimAccountManagerTokenData, ClaimAccountManagerTokenErrors, ClaimAccountManagerTokenResponses, ClaimHarnessPairingData, ClaimHarnessPairingErrors, ClaimHarnessPairingResponses, CollaborateFormData, CollaborateFormErrors, CollaborateFormResponses, CompleteSlackImportUploadsData, CompleteSlackImportUploadsErrors, CompleteSlackImportUploadsResponses, ConvertDatabaseColumnData, ConvertDatabaseColumnErrors, ConvertDatabaseColumnResponses, CopyDocumentData, CopyDocumentErrors, CopyDocumentResponses, CreateAgentData, CreateAgentErrors, CreateAgentResponses, CreateAnchorData, CreateAnchorErrors, CreateAnchorResponses, CreateBotData, CreateBotErrors, CreateBotResponses, CreateBotTokenData, CreateBotTokenErrors, CreateBotTokenResponses, CreateCanvasHandlerData, CreateCanvasHandlerErrors, CreateCanvasHandlerResponses, CreateChannelData, CreateChannelErrors, CreateChannelLabelData, CreateChannelLabelErrors, CreateChannelLabelResponses, CreateChannelResponses, CreateChannelScopedBotData, CreateChannelScopedBotErrors, CreateChannelScopedBotResponses, CreateCollabSurfaceTokenData, CreateCollabSurfaceTokenErrors, CreateCollabSurfaceTokenResponses, CreateCrmCompanyData, CreateCrmCompanyErrors, CreateCrmCompanyResponses, CreateCrmContactData, CreateCrmContactErrors, CreateCrmContactResponses, CreateCrmPipelineData, CreateCrmPipelineResponses, CreateCrmTeamContactData, CreateCrmTeamContactErrors, CreateCrmTeamContactResponses, CreateDatabaseData, CreateDatabaseErrors, CreateDatabaseResponses, CreateDatabaseWebhookData, CreateDatabaseWebhookErrors, CreateDatabaseWebhookResponses, CreateDocumentData, CreateDocumentErrors, CreateDocumentResponses, CreateEntityMentionData, CreateEntityMentionErrors, CreateEntityMentionResponses, CreateFormData, CreateFormErrors, CreateFormResponses, CreateHarnessPairingData, CreateHarnessPairingErrors, CreateHarnessPairingResponses, CreateInitiativeData, CreateInitiativeErrors, CreateInitiativeResponses, CreateInstructionsHandlerData, CreateInstructionsHandlerErrors, CreateInstructionsHandlerResponses, CreateMarkdownHandlerData, CreateMarkdownHandlerErrors, CreateMarkdownHandlerResponses, CreateProjectHandlerData, CreateProjectHandlerErrors, CreateProjectHandlerResponses, CreateSkillHandlerData, CreateSkillHandlerErrors, CreateSkillHandlerResponses, CreateSlackImportData, CreateSlackImportErrors, CreateSlackImportResponses, CreateSnippetHandlerData, CreateSnippetHandlerErrors, CreateSnippetHandlerResponses, CreateTaskHandlerData, CreateTaskHandlerErrors, CreateTaskHandlerResponses, CreateUserApiKeyData, CreateUserApiKeyErrors, CreateUserApiKeyResponses, CreateViewHandlerData, CreateViewHandlerErrors, CreateViewHandlerResponses, CreateWebhookData, CreateWebhookErrors, CreateWebhookResponses, DeclineCallData, DeclineCallErrors, DeclineCallResponses, DeclineRingData, DeclineRingErrors, DeclineRingResponses, DeleteAnchorData, DeleteAnchorErrors, DeleteAnchorResponses, DeleteBotData, DeleteBotErrors, DeleteBotResponses, DeleteCallRecordData, DeleteCallRecordErrors, DeleteCallRecordResponses, DeleteChannelData, DeleteChannelErrors, DeleteChannelLabelData, DeleteChannelLabelErrors, DeleteChannelLabelResponses, DeleteChannelResponses, DeleteCollabSurfaceData, DeleteCollabSurfaceErrors, DeleteCollabSurfaceResponses, DeleteDatabaseWebhookData, DeleteDatabaseWebhookErrors, DeleteDatabaseWebhookResponses, DeleteDocumentData, DeleteDocumentErrors, DeleteDocumentResponses, DeleteEntityMentionData, DeleteEntityMentionErrors, DeleteEntityMentionResponses, DeleteHarnessData, DeleteHarnessErrors, DeleteHarnessResponses, DeleteHistoryHandlerData, DeleteHistoryHandlerErrors, DeleteHistoryHandlerResponses, DeleteInitiativeData, DeleteInitiativeErrors, DeleteInitiativeResponses, DeleteProjectHandlerData, DeleteProjectHandlerErrors, DeleteProjectHandlerResponses, DeleteSelfHarnessData, DeleteSelfHarnessErrors, DeleteSelfHarnessResponses, DeleteUserApiKeyData, DeleteUserApiKeyErrors, DeleteUserApiKeyResponses, DeleteUserDocumentViewLocationData, DeleteUserDocumentViewLocationErrors, DeleteUserDocumentViewLocationResponses, DeleteViewHandlerData, DeleteViewHandlerErrors, DeleteViewHandlerResponses, DeleteWebhookData, DeleteWebhookErrors, DeleteWebhookResponses, DeliverDatabaseWebhookData, DeliverDatabaseWebhookErrors, DeliverDatabaseWebhookResponses, DuplicateDatabaseData, DuplicateDatabaseErrors, DuplicateDatabaseResponses, EditAnchorData, EditAnchorErrors, EditAnchorResponses, EditCallRecordData, EditCallRecordErrors, EditCallRecordResponses, EditCallTranscriptData, EditCallTranscriptErrors, EditCallTranscriptResponses, EditDocumentData, EditDocumentErrors, EditDocumentResponses, EditDocumentWithAiData, EditDocumentWithAiErrors, EditDocumentWithAiResponses, EditMyFormResponseData, EditMyFormResponseErrors, EditMyFormResponseResponses, EditProjectV2Data, EditProjectV2Errors, EditProjectV2Responses, EditThreadV2Data, EditThreadV2Errors, EditThreadV2Responses, EnsureCollabSurfaceData, EnsureCollabSurfaceErrors, EnsureCollabSurfaceResponses, EnsureStarterHandlerData, EnsureStarterHandlerErrors, EnsureStarterHandlerResponses, EntityMessageCreateData, EntityMessageCreateResponses, EntityMessageDeleteMessageData, EntityMessageDeleteMessageResponses, EntityMessageDeleteThreadData, EntityMessageDeleteThreadResponses, EntityMessageEditData, EntityMessageEditResponses, EntityMessageGetMessageData, EntityMessageGetMessageResponses, EntityMessageGetThreadData, EntityMessageGetThreadResponses, EntityMessageLegacyData, EntityMessageLegacyResponses, EntityMessagePatchThreadData, EntityMessagePatchThreadResponses, EntityMessageReactData, EntityMessageReactResponses, EntityMessageTypingData, EntityMessageTypingResponses, EventIcsData, EventIcsErrors, EventIcsResponses, ExcludeDefaultViewHandlerData, ExcludeDefaultViewHandlerErrors, ExcludeDefaultViewHandlerResponses, ExportDocumentData, ExportDocumentErrors, ExportDocumentResponses, ExternalChatAddData, ExternalChatAddResponses, ExternalChatData, ExternalChatDeliveryData, ExternalChatDeliveryResponses, ExternalChatMessageAttachmentsData, ExternalChatMessageAttachmentsResponses, ExternalChatMessageData, ExternalChatMessageResponses, ExternalChatMessagesData, ExternalChatMessagesResponses, ExternalChatPermissionsData, ExternalChatPermissionsResponses, ExternalChatReadData, ExternalChatReadResponses, ExternalChatRemoveData, ExternalChatRemoveResponses, ExternalChatResponses, ExternalChatsData, ExternalChatSendData, ExternalChatSendErrors, ExternalChatSendResponses, ExternalChatSendsData, ExternalChatSendsResponses, ExternalChatsResponses, ExternalChatUpdatePermissionsData, ExternalChatUpdatePermissionsResponses, ExternalChatUploadData, ExternalChatUploadResponses, FinalizeSlackImportData, FinalizeSlackImportErrors, FinalizeSlackImportResponses, GetAccountManagerGrantData, GetAccountManagerGrantErrors, GetAccountManagerGrantResponses, GetActiveCallsData, GetActiveCallsErrors, GetActiveCallsResponses, GetActivityData, GetActivityErrors, GetActivityResponses, GetAttachmentReferencesData, GetAttachmentReferencesErrors, GetAttachmentReferencesResponses, GetBatchCallRecordPreviewData, GetBatchCallRecordPreviewErrors, GetBatchCallRecordPreviewResponses, GetBatchChannelPreviewData, GetBatchChannelPreviewErrors, GetBatchChannelPreviewResponses, GetBatchPreviewHandlerData, GetBatchPreviewHandlerErrors, GetBatchPreviewHandlerResponses, GetBatchProjectPreviewData, GetBatchProjectPreviewErrors, GetBatchProjectPreviewResponses, GetBotData, GetBotErrors, GetBotOwnerProfilesData, GetBotOwnerProfilesErrors, GetBotOwnerProfilesResponses, GetBotResponses, GetCallRecordData, GetCallRecordErrors, GetCallRecordResponses, GetChannelAccessRequestData, GetChannelAccessRequestErrors, GetChannelAccessRequestResponses, GetChannelAttachmentsData, GetChannelAttachmentsErrors, GetChannelAttachmentsResponses, GetChannelData, GetChannelErrors, GetChannelJoinLinkData, GetChannelJoinLinkErrors, GetChannelJoinLinkResponses, GetChannelParticipantsData, GetChannelParticipantsErrors, GetChannelParticipantsResponses, GetChannelResponses, GetChannelsData, GetChannelsErrors, GetChannelsResponses, GetCollabSurfaceData, GetCollabSurfaceErrors, GetCollabSurfaceResponses, GetCompanyData, GetCompanyErrors, GetCompanyResponses, GetContactByEmailData, GetContactByEmailErrors, GetContactByEmailResponses, GetContactData, GetContactErrors, GetContactResponses, GetCrmPipelineData, GetCrmPipelinePermissionsData, GetCrmPipelinePermissionsResponses, GetCrmPipelineResponses, GetCrmPipelineRowsData, GetCrmPipelineRowsResponses, GetCrmPipelineStageRequirementsData, GetCrmPipelineStageRequirementsResponses, GetCrmPipelineTableData, GetCrmPipelineTableResponses, GetCrmPipelineViewPositionsData, GetCrmPipelineViewPositionsResponses, GetCrmTeamSettingsData, GetCrmTeamSettingsErrors, GetCrmTeamSettingsResponses, GetDatabaseData, GetDatabaseErrors, GetDatabasePermissionsData, GetDatabasePermissionsErrors, GetDatabasePermissionsResponses, GetDatabaseQueryData, GetDatabaseQueryErrors, GetDatabaseQueryResponses, GetDatabaseResponses, GetDatabaseRowHistoryData, GetDatabaseRowHistoryErrors, GetDatabaseRowHistoryResponses, GetDatabaseTableChangesData, GetDatabaseTableChangesErrors, GetDatabaseTableChangesResponses, GetDatabaseViewPositionsData, GetDatabaseViewPositionsErrors, GetDatabaseViewPositionsResponses, GetDocumentAnchorsData, GetDocumentAnchorsErrors, GetDocumentAnchorsResponses, GetDocumentBranchNameData, GetDocumentBranchNameErrors, GetDocumentBranchNameResponses, GetDocumentByTeamSlugData, GetDocumentByTeamSlugErrors, GetDocumentByTeamSlugResponses, GetDocumentData, GetDocumentErrors, GetDocumentGithubPullRequestsData, GetDocumentGithubPullRequestsErrors, GetDocumentGithubPullRequestsResponses, GetDocumentListHandlerData, GetDocumentListHandlerErrors, GetDocumentListHandlerResponses, GetDocumentLocationV3Data, GetDocumentLocationV3Errors, GetDocumentLocationV3Responses, GetDocumentPermissionsTokenData, GetDocumentPermissionsTokenErrors, GetDocumentPermissionsTokenResponses, GetDocumentPermissionsV2Data, GetDocumentPermissionsV2Errors, GetDocumentPermissionsV2Responses, GetDocumentProcessingResultData, GetDocumentProcessingResultErrors, GetDocumentProcessingResultResponses, GetDocumentResponses, GetDocumentShortIdData, GetDocumentShortIdErrors, GetDocumentShortIdResponses, GetDocumentTeamShareData, GetDocumentTeamShareErrors, GetDocumentTeamShareResponses, GetDocumentTextContentData, GetDocumentTextContentErrors, GetDocumentTextContentResponses, GetDocumentVersionData, GetDocumentVersionErrors, GetDocumentVersionResponses, GetDocumentViewsHandlerData, GetDocumentViewsHandlerErrors, GetDocumentViewsHandlerResponses, GetEmailFollowupData, GetEmailFollowupErrors, GetEmailFollowupResponses, GetEntityPermissionData, GetEntityPermissionErrors, GetEntityPermissionResponses, GetForeignEntityBySourceData, GetForeignEntityBySourceErrors, GetForeignEntityBySourceResponses, GetForeignEntityData, GetForeignEntityErrors, GetForeignEntityResponses, GetFormData, GetFormErrors, GetFormPermissionsData, GetFormPermissionsErrors, GetFormPermissionsResponses, GetFormResponses, GetFormResponseSummaryData, GetFormResponseSummaryErrors, GetFormResponseSummaryResponses, GetFormTallyData, GetFormTallyErrors, GetFormTallyResponses, GetGithubPullRequestChangesData, GetGithubPullRequestChangesErrors, GetGithubPullRequestChangesPatchData, GetGithubPullRequestChangesPatchErrors, GetGithubPullRequestChangesPatchResponses, GetGithubPullRequestChangesResponses, GetGithubPullRequestData, GetGithubPullRequestErrors, GetGithubPullRequestFacetsData, GetGithubPullRequestFacetsErrors, GetGithubPullRequestFacetsResponses, GetGithubPullRequestResponses, GetGithubPullRequestTasksData, GetGithubPullRequestTasksErrors, GetGithubPullRequestTasksResponses, GetHarnessPairingData, GetHarnessPairingErrors, GetHarnessPairingResponses, GetHistoryHandlerData, GetHistoryHandlerErrors, GetHistoryHandlerResponses, GetInitiativeData, GetInitiativeErrors, GetInitiativeResponses, GetInstructionsHandlerData, GetInstructionsHandlerErrors, GetInstructionsHandlerResponses, GetItemsSoupData, GetItemsSoupErrors, GetItemsSoupResponses, GetLocationHandlerData, GetLocationHandlerErrors, GetLocationHandlerResponses, GetMyChannelAccessRequestData, GetMyChannelAccessRequestErrors, GetMyChannelAccessRequestResponses, GetMyFormResponseData, GetMyFormResponseErrors, GetMyFormResponseResponses, GetOrCreateCallData, GetOrCreateCallErrors, GetOrCreateCallResponses, GetOrCreateDmData, GetOrCreateDmErrors, GetOrCreateDmResponses, GetOrCreatePrivateData, GetOrCreatePrivateErrors, GetOrCreatePrivateResponses, GetPendingProjectsHandlerData, GetPendingProjectsHandlerErrors, GetPendingProjectsHandlerResponses, GetPinsHandlerData, GetPinsHandlerErrors, GetPinsHandlerResponses, GetProjectContentHandlerData, GetProjectContentHandlerErrors, GetProjectContentHandlerResponses, GetProjectHandlerData, GetProjectHandlerErrors, GetProjectHandlerResponses, GetProjectPermissionsV2Data, GetProjectPermissionsV2Errors, GetProjectPermissionsV2Responses, GetProjectsHandlerData, GetProjectsHandlerErrors, GetProjectsHandlerResponses, GetProjectUserAccessLevelData, GetProjectUserAccessLevelErrors, GetProjectUserAccessLevelResponses, GetRingStatusData, GetRingStatusErrors, GetRingStatusResponses, GetSelfBotData, GetSelfBotErrors, GetSelfBotResponses, GetSelfHarnessData, GetSelfHarnessErrors, GetSelfHarnessResponses, GetSkillDescriptionData, GetSkillDescriptionErrors, GetSkillDescriptionResponses, GetSlackImportData, GetSlackImportErrors, GetSlackImportResponses, GetSystemSkillsHandlerData, GetSystemSkillsHandlerErrors, GetSystemSkillsHandlerResponses, GetUserDocumentsHandlerData, GetUserDocumentsHandlerErrors, GetUserDocumentsHandlerResponses, GetUserDocumentViewLocationData, GetUserDocumentViewLocationErrors, GetUserDocumentViewLocationResponses, GetViewsHandlerData, GetViewsHandlerErrors, GetViewsHandlerResponses, GetWebhookData, GetWebhookErrors, GetWebhookResponses, GuestCallChatPostData, GuestCallChatPostErrors, GuestCallChatPostResponses, GuestCallChatReadData, GuestCallChatReadErrors, GuestCallChatReadResponses, HandlerData, HandlerErrors, HandlerResponses, HealthHandlerData, HealthHandlerResponses, ImportDatabaseTableData, ImportDatabaseTableErrors, ImportDatabaseTableResponses, InferDatabaseColumnTypeData, InferDatabaseColumnTypeErrors, InferDatabaseColumnTypeResponses, IngestTranscriptData, IngestTranscriptErrors, IngestTranscriptResponses, InitializeUserDocumentsData, InitializeUserDocumentsErrors, InitializeUserDocumentsResponses, InstallSyncData, InstallSyncErrors, JobProcessingResultHandlerData, JobProcessingResultHandlerErrors, JobProcessingResultHandlerResponses, JoinChannelByCodeData, JoinChannelByCodeErrors, JoinChannelByCodeResponses, JoinChannelData, JoinChannelErrors, JoinChannelResponses, LeaveChannelData, LeaveChannelErrors, LeaveChannelResponses, LeaveOrEndCallData, LeaveOrEndCallErrors, LeaveOrEndCallResponses, ListAccessibleFormsData, ListAccessibleFormsErrors, ListAccessibleFormsResponses, ListAccountManagersData, ListAccountManagersErrors, ListAccountManagersResponses, ListAgentsData, ListAgentsErrors, ListAgentsResponses, ListBotChannelsData, ListBotChannelsErrors, ListBotChannelsResponses, ListBotsData, ListBotsErrors, ListBotsResponses, ListBotTokensData, ListBotTokensErrors, ListBotTokensResponses, ListChannelBotsData, ListChannelBotsErrors, ListChannelBotsResponses, ListChannelLabelsData, ListChannelLabelsErrors, ListChannelLabelsResponses, ListCompanyContactsData, ListCompanyContactsErrors, ListCompanyContactsResponses, ListCrmBlockedDomainsData, ListCrmBlockedDomainsErrors, ListCrmBlockedDomainsResponses, ListCrmPipelinesData, ListCrmPipelinesResponses, ListDatabaseColumnCastsData, ListDatabaseColumnCastsErrors, ListDatabaseColumnCastsResponses, ListDatabasesData, ListDatabasesErrors, ListDatabasesResponses, ListDatabaseWebhooksData, ListDatabaseWebhooksErrors, ListDatabaseWebhooksResponses, ListEmailRemindersData, ListEmailRemindersErrors, ListEmailRemindersResponses, ListFavoritesData, ListFavoritesErrors, ListFavoritesResponses, ListFormsData, ListFormsErrors, ListFormsResponses, ListHarnessAgentsData, ListHarnessAgentsErrors, ListHarnessAgentsResponses, ListHarnessesData, ListHarnessesErrors, ListHarnessesResponses, ListHarnessSessionsData, ListHarnessSessionsErrors, ListHarnessSessionsResponses, ListInitiativesData, ListInitiativesErrors, ListInitiativesResponses, ListJoinRequestsData, ListJoinRequestsErrors, ListJoinRequestsResponses, ListOccurrencesData, ListOccurrencesErrors, ListOccurrencesResponses, ListSlackImportsData, ListSlackImportsResponses, ListTeamCalendarData, ListTeamCalendarResponses, ListTeamOutOfOfficeData, ListTeamOutOfOfficeErrors, ListTeamOutOfOfficeResponses, ListUserApiKeysData, ListUserApiKeysErrors, ListUserApiKeysResponses, ListWebhooksData, ListWebhooksErrors, ListWebhooksResponses, MeetingCancelData, MeetingCancelErrors, MeetingCancelPreparationData, MeetingCancelPreparationErrors, MeetingCancelPreparationResponses, MeetingCancelResponses, MeetingCreateData, MeetingCreateErrors, MeetingCreateResponses, MeetingGuestJoinData, MeetingGuestJoinErrors, MeetingGuestJoinResponses, MeetingGuestParticipantsData, MeetingGuestParticipantsErrors, MeetingGuestParticipantsResponses, MeetingInviteData, MeetingInviteErrors, MeetingInvitePermissionsData, MeetingInvitePermissionsErrors, MeetingInvitePermissionsResponses, MeetingInviteResponses, MeetingInviteUsersData, MeetingInviteUsersErrors, MeetingInviteUsersResponses, MeetingJoinData, MeetingJoinErrors, MeetingJoinResponses, MeetingLeaveData, MeetingLeaveErrors, MeetingLeaveResponses, MeetingListActiveData, MeetingListActiveErrors, MeetingListActiveResponses, MeetingListData, MeetingListErrors, MeetingListResponses, MeetingLookupData, MeetingLookupErrors, MeetingLookupResponses, MeetingParticipantsData, MeetingParticipantsErrors, MeetingParticipantsResponses, MeetingPrepareData, MeetingPrepareErrors, MeetingPrepareResponses, MeetingShareData, MeetingShareErrors, MeetingShareResponses, MeetingUpdateData, MeetingUpdateErrors, MeetingUpdateResponses, MentionPreviewsData, MentionPreviewsErrors, MentionPreviewsResponses, MessageTimelineData, MessageTimelineEntriesData, MessageTimelineEntriesResponses, MessageTimelineResponses, PatchBotData, PatchBotErrors, PatchBotResponses, PatchChannelData, PatchChannelErrors, PatchChannelResponses, PatchHarnessData, PatchHarnessErrors, PatchHarnessResponses, PatchViewHandlerData, PatchViewHandlerErrors, PatchViewHandlerResponses, PatchWebhookData, PatchWebhookErrors, PatchWebhookResponses, PermanentlyDeleteDocumentData, PermanentlyDeleteDocumentErrors, PermanentlyDeleteDocumentResponses, PermanentlyDeleteProjectData, PermanentlyDeleteProjectErrors, PermanentlyDeleteProjectResponses, PostActivityData, PostActivityErrors, PostActivityResponses, PostChannelBotWebhookData, PostChannelBotWebhookErrors, PostChannelBotWebhookResponses, PostItemsSoupAstData, PostItemsSoupAstErrors, PostItemsSoupAstGroupedData, PostItemsSoupAstGroupedErrors, PostItemsSoupAstGroupedResponses, PostItemsSoupAstResponses, PostItemsSoupData, PostItemsSoupErrors, PostItemsSoupResponses, PresaveDocumentHandlerData, PresaveDocumentHandlerErrors, PresaveDocumentHandlerResponses, PreviewSmartTagData, PreviewSmartTagErrors, PreviewSmartTagResponses, PutCrmTeamSettingsData, PutCrmTeamSettingsErrors, PutCrmTeamSettingsResponses, PutCrmTeamStagesData, PutCrmTeamStagesErrors, PutCrmTeamStagesResponses, PutFormLayoutData, PutFormLayoutErrors, PutFormLayoutResponses, QueryCrmPipelineRowsData, QueryCrmPipelineRowsResponses, QueryDatabasesData, QueryDatabasesErrors, QueryDatabasesResponses, RecentlyDeletedData, RecentlyDeletedErrors, RecentlyDeletedResponses, RegisterSlackImportUploadsData, RegisterSlackImportUploadsErrors, RegisterSlackImportUploadsResponses, RemoveBotFromChannelByBotData, RemoveBotFromChannelByBotErrors, RemoveBotFromChannelByBotResponses, RemoveFavoriteByEntityData, RemoveFavoriteByEntityErrors, RemoveFavoriteByEntityResponses, RemoveParticipantsData, RemoveParticipantsErrors, RemoveParticipantsResponses, RemovePinHandlerData, RemovePinHandlerErrors, RemovePinHandlerResponses, RenameChannelLabelData, RenameChannelLabelErrors, RenameChannelLabelResponses, RenameCrmPipelineData, RenameCrmPipelineResponses, ReorderFavoritesData, ReorderFavoritesErrors, ReorderFavoritesResponses, ReorderPinsHandlerData, ReorderPinsHandlerErrors, ReorderPinsHandlerResponses, RequestAccountManagerData, RequestAccountManagerErrors, RequestAccountManagerResponses, RequestChannelAccessData, RequestChannelAccessErrors, RequestChannelAccessResponses, RequestToJoinData, RequestToJoinErrors, RequestToJoinResponses, ResetCrmTeamStagesData, ResetCrmTeamStagesErrors, ResetCrmTeamStagesResponses, ResolveChannelAccessRequestData, ResolveChannelAccessRequestErrors, ResolveChannelAccessRequestResponses, RespondToAccountManagerRequestData, RespondToAccountManagerRequestErrors, RespondToAccountManagerRequestResponses, RevertDeleteDocumentData, RevertDeleteDocumentErrors, RevertDeleteDocumentResponses, RevertDeleteProjectData, RevertDeleteProjectErrors, RevertDeleteProjectResponses, RevokeAccountManagerGrantData, RevokeAccountManagerGrantErrors, RevokeAccountManagerGrantResponses, RevokeBotTokenData, RevokeBotTokenErrors, RevokeBotTokenResponses, SaveDatabaseQueryData, SaveDatabaseQueryErrors, SaveDatabaseQueryResponses, SaveDocumentHandlerData, SaveDocumentHandlerErrors, SaveDocumentHandlerResponses, SearchContactsData, SearchContactsErrors, SearchContactsResponses, SetChannelLabelData, SetChannelLabelErrors, SetChannelLabelResponses, SetChannelPictureData, SetChannelPictureErrors, SetChannelPictureResponses, SetCompanyHiddenData, SetCompanyHiddenErrors, SetCompanyHiddenResponses, SetContactHiddenData, SetContactHiddenErrors, SetContactHiddenResponses, SetCrmCompanyNameData, SetCrmCompanyNameErrors, SetCrmCompanyNameResponses, SetCrmContactNameData, SetCrmContactNameErrors, SetCrmContactNameResponses, SetCrmPipelineStageRequirementData, SetCrmPipelineStageRequirementResponses, SetDocumentTeamShareData, SetDocumentTeamShareErrors, SetDocumentTeamShareResponses, SetEmailFollowupData, SetEmailFollowupErrors, SetEmailFollowupResponses, SetEmailSyncData, SetEmailSyncErrors, SetEmailSyncResponses, SetSkillDescriptionData, SetSkillDescriptionErrors, SetSkillDescriptionResponses, ShareCrmPipelineData, ShareCrmPipelineResponses, ShareDatabaseAwarenessData, ShareDatabaseAwarenessErrors, ShareDatabaseAwarenessResponses, SimpleSaveData, SimpleSaveErrors, SimpleSaveResponses, StreamEventsData, StreamEventsErrors, StreamEventsResponse, StreamEventsResponses, SubmitFormResponseData, SubmitFormResponseErrors, SubmitFormResponseResponses, TaskSimilaritySearchHandlerData, TaskSimilaritySearchHandlerErrors, TaskSimilaritySearchHandlerResponses, ToggleShareWithTeamData, ToggleShareWithTeamErrors, ToggleShareWithTeamResponses, TranscribeDictationData, TranscribeDictationErrors, TranscribeDictationResponses, TrashCrmPipelineData, TrashCrmPipelineResponses, UnblockCrmDomainData, UnblockCrmDomainErrors, UnblockCrmDomainResponses, UndoDatabaseChangeData, UndoDatabaseChangeErrors, UndoDatabaseChangeResponses, UpdateAgentData, UpdateAgentErrors, UpdateAgentResponses, UpdateCrmPipelinePermissionsData, UpdateCrmPipelinePermissionsResponses, UpdateDatabasePermissionsData, UpdateDatabasePermissionsErrors, UpdateDatabasePermissionsResponses, UpdateFormData, UpdateFormErrors, UpdateFormPermissionsData, UpdateFormPermissionsErrors, UpdateFormPermissionsResponses, UpdateFormResponses, UpdateInitiativeData, UpdateInitiativeErrors, UpdateInitiativeResponses, UploadExtractFolderHandlerData, UploadExtractFolderHandlerErrors, UploadExtractFolderHandlerResponses, UploadFileData, UploadFileErrors, UploadFileResponses, UploadFolderHandlerData, UploadFolderHandlerErrors, UploadFolderHandlerResponses, UpsertHistoryHandlerData, UpsertHistoryHandlerErrors, UpsertHistoryHandlerResponses, UpsertUserDocumentViewLocationData, UpsertUserDocumentViewLocationErrors, UpsertUserDocumentViewLocationResponses, ValidateDocumentPermissionsTokenData, ValidateDocumentPermissionsTokenErrors, ValidateDocumentPermissionsTokenResponses, ValidateWebhookData, ValidateWebhookErrors, ValidateWebhookResponses, WhatsappAccountData, WhatsappAccountResponses, WhatsappCancelPairingData, WhatsappCancelPairingResponses, WhatsappChatsData, WhatsappChatsResponses, WhatsappConnectData, WhatsappConnectResponses, WhatsappDisconnectData, WhatsappDisconnectResponses, WhatsappImportHistoryData, WhatsappImportHistoryResponses, WhatsappLookupData, WhatsappLookupResponses, WhatsappPairingData, WhatsappPairingResponses, WhatsappPasskeyData, WhatsappPasskeyResponses, WhatsappStartLookupData, WhatsappStartLookupResponses } from './types.gen';
export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown> = Options2<TData, ThrowOnError, TResponse> & {
/**
@@ -57,6 +57,63 @@ export class Sdk extends HeyApiClient {
Sdk.__registry.set(this, args?.key);
}
+ /**
+ * List the managers of the caller's account.
+ */
+ public listAccountManagers<ThrowOnError extends boolean = false>(options?: Options<ListAccountManagersData, ThrowOnError>): RequestResult<ListAccountManagersResponses, ListAccountManagersErrors, ThrowOnError> {
+ return (options?.client ?? this.client).get<ListAccountManagersResponses, ListAccountManagersErrors, ThrowOnError>({ url: '/account-managers', ...options });
+ }
+
+ /**
+ * Ask another account for manager access, in your DM with them.
+ */
+ public requestAccountManager<ThrowOnError extends boolean = false>(options: Options<RequestAccountManagerData, ThrowOnError>): RequestResult<RequestAccountManagerResponses, RequestAccountManagerErrors, ThrowOnError> {
+ return (options.client ?? this.client).post<RequestAccountManagerResponses, RequestAccountManagerErrors, ThrowOnError>({
+ url: '/account-managers',
+ ...options,
+ headers: {
+ 'Content-Type': 'application/json',
+ ...options.headers
+ }
+ });
+ }
+
+ /**
+ * End a grant. Either side may withdraw it.
+ */
+ public revokeAccountManagerGrant<ThrowOnError extends boolean = false>(options: Options<RevokeAccountManagerGrantData, ThrowOnError>): RequestResult<RevokeAccountManagerGrantResponses, RevokeAccountManagerGrantErrors, ThrowOnError> {
+ return (options.client ?? this.client).delete<RevokeAccountManagerGrantResponses, RevokeAccountManagerGrantErrors, ThrowOnError>({ url: '/account-managers/{id}', ...options });
+ }
+
+ /**
+ * Read a grant the caller is part of.
+ */
+ public getAccountManagerGrant<ThrowOnError extends boolean = false>(options: Options<GetAccountManagerGrantData, ThrowOnError>): RequestResult<GetAccountManagerGrantResponses, GetAccountManagerGrantErrors, ThrowOnError> {
+ return (options.client ?? this.client).get<GetAccountManagerGrantResponses, GetAccountManagerGrantErrors, ThrowOnError>({ url: '/account-managers/{id}', ...options });
+ }
+
+ /**
+ * Approve or decline a request the caller didn't make.
+ */
+ public respondToAccountManagerRequest<ThrowOnError extends boolean = false>(options: Options<RespondToAccountManagerRequestData, ThrowOnError>): RequestResult<RespondToAccountManagerRequestResponses, RespondToAccountManagerRequestErrors, ThrowOnError> {
+ return (options.client ?? this.client).post<RespondToAccountManagerRequestResponses, RespondToAccountManagerRequestErrors, ThrowOnError>({
+ url: '/account-managers/{id}/response',
+ ...options,
+ headers: {
+ 'Content-Type': 'application/json',
+ ...options.headers
+ }
+ });
+ }
+
+ /**
+ * Issue the credential to the manager. Works once. A POST, so link previews
+ * and crawlers can't use it up.
+ */
+ public claimAccountManagerToken<ThrowOnError extends boolean = false>(options: Options<ClaimAccountManagerTokenData, ThrowOnError>): RequestResult<ClaimAccountManagerTokenResponses, ClaimAccountManagerTokenErrors, ThrowOnError> {
+ return (options.client ?? this.client).post<ClaimAccountManagerTokenResponses, ClaimAccountManagerTokenErrors, ThrowOnError>({ url: '/account-managers/{id}/token', ...options });
+ }
+
/**
* Handler for `GET /agents`.
*/
diff --git a/packages/sdk/generated/storage/types.gen.ts b/packages/sdk/generated/storage/types.gen.ts
index 6696e12272..6a9ff6ee83 100644
--- a/packages/sdk/generated/storage/types.gen.ts
+++ b/packages/sdk/generated/storage/types.gen.ts
@@ -100,6 +100,73 @@ export type AccessiblePipeline = Pipeline & {
grant: AccessLevel;
};
+/**
+ * A response to a request.
+ */
+export type AccountManagerDecision = 'approve' | 'decline';
+
+/**
+ * A request for manager access and what became of it.
+ */
+export type AccountManagerGrant = {
+ /**
+ * When the manager claimed the credential.
+ */
+ claimedAt?: string | null;
+ /**
+ * When the request was made.
+ */
+ createdAt: string;
+ /**
+ * When the pending request or unclaimed approval stops being usable.
+ */
+ expiresAt?: string | null;
+ /**
+ * Grant id.
+ */
+ id: string;
+ /**
+ * When the credential was last used, to the minute.
+ */
+ lastUsedAt?: string | null;
+ /**
+ * The account being managed.
+ */
+ managedUserId: string;
+ /**
+ * The agent account doing the managing.
+ */
+ managerUserId: string;
+ /**
+ * The side that asked.
+ */
+ requestedBy: AccountManagerRole;
+ /**
+ * Lifecycle status.
+ */
+ status: AccountManagerGrantStatus;
+};
+
+/**
+ * Where a grant is in its lifecycle.
+ */
+export type AccountManagerGrantStatus = 'pending' | 'approved' | 'declined' | 'active' | 'revoked' | 'expired';
+
+/**
+ * One side of a grant.
+ */
+export type AccountManagerRole = 'managed' | 'manager';
+
+/**
+ * The managers of the caller's account.
+ */
+export type AccountManagersList = {
+ /**
+ * Approved and active grants on the caller's account.
+ */
+ grants: Array<AccountManagerGrant>;
+};
+
/**
* A currently active call, as returned by the batch active-calls listing.
*/
@@ -3355,6 +3422,20 @@ export type ClaimPairingRequest = {
device_secret: string;
};
+/**
+ * The credential, returned only by the claim that issued it.
+ */
+export type ClaimedAccountManagerToken = {
+ /**
+ * The grant, now active.
+ */
+ grant: AccountManagerGrant;
+ /**
+ * The secret. Shown only once.
+ */
+ token: string;
+};
+
/**
* The credential released to the daemon when a pairing is claimed.
*/
@@ -12475,6 +12556,20 @@ export type RequestAccess = {
revision?: number | null;
};
+/**
+ * Request body for asking for a grant.
+ */
+export type RequestAccountManagerBody = {
+ /**
+ * The side the caller takes.
+ */
+ callerRole: AccountManagerRole;
+ /**
+ * The other account (`macro|...`).
+ */
+ counterpartyId: string;
+};
+
/**
* Durable outcome; reading a notification never changes it.
*/
@@ -12562,6 +12657,16 @@ export type ResolveRequest = {
revision: number;
};
+/**
+ * Request body for responding to a request.
+ */
+export type RespondToAccountManagerRequestBody = {
+ /**
+ * The response.
+ */
+ decision: AccountManagerDecision;
+};
+
/**
* Whether a ledger entry is a saved response or a stop at a gate.
*/
@@ -17351,6 +17456,160 @@ export type WithProjectId = {
id: string;
};
+export type ListAccountManagersData = {
+ body?: never;
+ path?: never;
+ query?: never;
+ url: '/account-managers';
+};
+
+export type ListAccountManagersErrors = {
+ 401: ErrorResponse;
+ 403: ErrorResponse;
+ 500: ErrorResponse;
+};
+
+export type ListAccountManagersError = ListAccountManagersErrors[keyof ListAccountManagersErrors];
+
+export type ListAccountManagersResponses = {
+ 200: AccountManagersList;
+};
+
+export type ListAccountManagersResponse = ListAccountManagersResponses[keyof ListAccountManagersResponses];
+
+export type RequestAccountManagerData = {
+ body: RequestAccountManagerBody;
+ path?: never;
+ query?: never;
+ url: '/account-managers';
+};
+
+export type RequestAccountManagerErrors = {
+ 400: ErrorResponse;
+ 401: ErrorResponse;
+ 403: ErrorResponse;
+ 500: ErrorResponse;
+};
+
+export type RequestAccountManagerError = RequestAccountManagerErrors[keyof RequestAccountManagerErrors];
+
+export type RequestAccountManagerResponses = {
+ 200: AccountManagerGrant;
+};
+
+export type RequestAccountManagerResponse = RequestAccountManagerResponses[keyof RequestAccountManagerResponses];
+
+export type RevokeAccountManagerGrantData = {
+ body?: never;
+ path: {
+ /**
+ * Grant id.
+ */
+ id: string;
+ };
+ query?: never;
+ url: '/account-managers/{id}';
+};
+
+export type RevokeAccountManagerGrantErrors = {
+ 401: ErrorResponse;
+ 403: ErrorResponse;
+ 404: ErrorResponse;
+ 409: ErrorResponse;
+ 500: ErrorResponse;
+};
+
+export type RevokeAccountManagerGrantError = RevokeAccountManagerGrantErrors[keyof RevokeAccountManagerGrantErrors];
+
+export type RevokeAccountManagerGrantResponses = {
+ 200: AccountManagerGrant;
+};
+
+export type RevokeAccountManagerGrantResponse = RevokeAccountManagerGrantResponses[keyof RevokeAccountManagerGrantResponses];
+
+export type GetAccountManagerGrantData = {
+ body?: never;
+ path: {
+ /**
+ * Grant id.
+ */
+ id: string;
+ };
+ query?: never;
+ url: '/account-managers/{id}';
+};
+
+export type GetAccountManagerGrantErrors = {
+ 401: ErrorResponse;
+ 403: ErrorResponse;
+ 404: ErrorResponse;
+ 500: ErrorResponse;
+};
+
+export type GetAccountManagerGrantError = GetAccountManagerGrantErrors[keyof GetAccountManagerGrantErrors];
+
+export type GetAccountManagerGrantResponses = {
+ 200: AccountManagerGrant;
+};
+
+export type GetAccountManagerGrantResponse = GetAccountManagerGrantResponses[keyof GetAccountManagerGrantResponses];
+
+export type RespondToAccountManagerRequestData = {
+ body: RespondToAccountManagerRequestBody;
+ path: {
+ /**
+ * Grant id.
+ */
+ id: string;
+ };
+ query?: never;
+ url: '/account-managers/{id}/response';
+};
+
+export type RespondToAccountManagerRequestErrors = {
+ 401: ErrorResponse;
+ 403: ErrorResponse;
+ 404: ErrorResponse;
+ 409: ErrorResponse;
+ 500: ErrorResponse;
+};
+
+export type RespondToAccountManagerRequestError = RespondToAccountManagerRequestErrors[keyof RespondToAccountManagerRequestErrors];
+
+export type RespondToAccountManagerRequestResponses = {
+ 200: AccountManagerGrant;
+};
+
+export type RespondToAccountManagerRequestResponse = RespondToAccountManagerRequestResponses[keyof RespondToAccountManagerRequestResponses];
+
+export type ClaimAccountManagerTokenData = {
+ body?: never;
+ path: {
+ /**
+ * Grant id.
+ */
+ id: string;
+ };
+ query?: never;
+ url: '/account-managers/{id}/token';
+};
+
+export type ClaimAccountManagerTokenErrors = {
+ 401: ErrorResponse;
+ 403: ErrorResponse;
+ 404: ErrorResponse;
+ 409: ErrorResponse;
+ 500: ErrorResponse;
+};
+
+export type ClaimAccountManagerTokenError = ClaimAccountManagerTokenErrors[keyof ClaimAccountManagerTokenErrors];
+
+export type ClaimAccountManagerTokenResponses = {
+ 200: ClaimedAccountManagerToken;
+};
+
+export type ClaimAccountManagerTokenResponse = ClaimAccountManagerTokenResponses[keyof ClaimAccountManagerTokenResponses];
+
export type ListAgentsData = {
body?: never;
path?: never;
diff --git a/packages/sdk/specs/storage.json b/packages/sdk/specs/storage.json
index 1d1c2d9822..2d4972c597 100644
--- a/packages/sdk/specs/storage.json
+++ b/packages/sdk/specs/storage.json
@@ -10,6 +10,444 @@
"version": "0.1.0"
},
"paths": {
+ "/account-managers": {
+ "get": {
+ "tags": ["account-managers"],
+ "summary": "List the managers of the caller's account.",
+ "operationId": "list_account_managers",
+ "responses": {
+ "200": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/AccountManagersList"
+ }
+ }
+ }
+ },
+ "401": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "403": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "500": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ }
+ }
+ },
+ "post": {
+ "tags": ["account-managers"],
+ "summary": "Ask another account for manager access, in your DM with them.",
+ "operationId": "request_account_manager",
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/RequestAccountManagerBody"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "200": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/AccountManagerGrant"
+ }
+ }
+ }
+ },
+ "400": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "401": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "403": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "500": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "/account-managers/{id}": {
+ "get": {
+ "tags": ["account-managers"],
+ "summary": "Read a grant the caller is part of.",
+ "operationId": "get_account_manager_grant",
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "description": "Grant id.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "format": "uuid"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/AccountManagerGrant"
+ }
+ }
+ }
+ },
+ "401": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "403": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "404": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "500": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ }
+ }
+ },
+ "delete": {
+ "tags": ["account-managers"],
+ "summary": "End a grant. Either side may withdraw it.",
+ "operationId": "revoke_account_manager_grant",
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "description": "Grant id.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "format": "uuid"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/AccountManagerGrant"
+ }
+ }
+ }
+ },
+ "401": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "403": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "404": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "409": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "500": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "/account-managers/{id}/response": {
+ "post": {
+ "tags": ["account-managers"],
+ "summary": "Approve or decline a request the caller didn't make.",
+ "operationId": "respond_to_account_manager_request",
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "description": "Grant id.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "format": "uuid"
+ }
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/RespondToAccountManagerRequestBody"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "200": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/AccountManagerGrant"
+ }
+ }
+ }
+ },
+ "401": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "403": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "404": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "409": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "500": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "/account-managers/{id}/token": {
+ "post": {
+ "tags": ["account-managers"],
+ "summary": "Issue the credential to the manager. Works once. A POST, so link previews\nand crawlers can't use it up.",
+ "operationId": "claim_account_manager_token",
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "description": "Grant id.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "format": "uuid"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ClaimedAccountManagerToken"
+ }
+ }
+ }
+ },
+ "401": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "403": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "404": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "409": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "500": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
"/agents": {
"get": {
"tags": ["agents"],
@@ -21699,6 +22137,97 @@
],
"description": "Metadata together with the caller's effective grant."
},
+ "AccountManagerDecision": {
+ "type": "string",
+ "description": "A response to a request.",
+ "enum": ["approve", "decline"]
+ },
+ "AccountManagerGrant": {
+ "type": "object",
+ "description": "A request for manager access and what became of it.",
+ "required": [
+ "id",
+ "managedUserId",
+ "managerUserId",
+ "requestedBy",
+ "status",
+ "createdAt"
+ ],
+ "properties": {
+ "claimedAt": {
+ "type": ["string", "null"],
+ "format": "date-time",
+ "description": "When the manager claimed the credential."
+ },
+ "createdAt": {
+ "type": "string",
+ "format": "date-time",
+ "description": "When the request was made."
+ },
+ "expiresAt": {
+ "type": ["string", "null"],
+ "format": "date-time",
+ "description": "When the pending request or unclaimed approval stops being usable."
+ },
+ "id": {
+ "type": "string",
+ "format": "uuid",
+ "description": "Grant id."
+ },
+ "lastUsedAt": {
+ "type": ["string", "null"],
+ "format": "date-time",
+ "description": "When the credential was last used, to the minute."
+ },
+ "managedUserId": {
+ "type": "string",
+ "description": "The account being managed."
+ },
+ "managerUserId": {
+ "type": "string",
+ "description": "The agent account doing the managing."
+ },
+ "requestedBy": {
+ "$ref": "#/components/schemas/AccountManagerRole",
+ "description": "The side that asked."
+ },
+ "status": {
+ "$ref": "#/components/schemas/AccountManagerGrantStatus",
+ "description": "Lifecycle status."
+ }
+ }
+ },
+ "AccountManagerGrantStatus": {
+ "type": "string",
+ "description": "Where a grant is in its lifecycle.",
+ "enum": [
+ "pending",
+ "approved",
+ "declined",
+ "active",
+ "revoked",
+ "expired"
+ ]
+ },
+ "AccountManagerRole": {
+ "type": "string",
+ "description": "One side of a grant.",
+ "enum": ["managed", "manager"]
+ },
+ "AccountManagersList": {
+ "type": "object",
+ "description": "The managers of the caller's account.",
+ "required": ["grants"],
+ "properties": {
+ "grants": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/AccountManagerGrant"
+ },
+ "description": "Approved and active grants on the caller's account."
+ }
+ }
+ },
"ActiveCallSummary": {
"type": "object",
"description": "A currently active call, as returned by the batch active-calls listing.",
@@ -26424,6 +26953,21 @@
}
}
},
+ "ClaimedAccountManagerToken": {
+ "type": "object",
+ "description": "The credential, returned only by the claim that issued it.",
+ "required": ["grant", "token"],
+ "properties": {
+ "grant": {
+ "$ref": "#/components/schemas/AccountManagerGrant",
+ "description": "The grant, now active."
+ },
+ "token": {
+ "type": "string",
+ "description": "The secret. Shown only once."
+ }
+ }
+ },
"ClaimedPairing": {
"type": "object",
"description": "The credential released to the daemon when a pairing is claimed.",
@@ -41091,6 +41635,21 @@
}
}
},
+ "RequestAccountManagerBody": {
+ "type": "object",
+ "description": "Request body for asking for a grant.",
+ "required": ["counterpartyId", "callerRole"],
+ "properties": {
+ "callerRole": {
+ "$ref": "#/components/schemas/AccountManagerRole",
+ "description": "The side the caller takes."
+ },
+ "counterpartyId": {
+ "type": "string",
+ "description": "The other account (`macro|...`)."
+ }
+ }
+ },
"RequestStatus": {
"type": "string",
"description": "Durable outcome; reading a notification never changes it.",
@@ -41238,6 +41797,17 @@
}
}
},
+ "RespondToAccountManagerRequestBody": {
+ "type": "object",
+ "description": "Request body for responding to a request.",
+ "required": ["decision"],
+ "properties": {
+ "decision": {
+ "$ref": "#/components/schemas/AccountManagerDecision",
+ "description": "The response."
+ }
+ }
+ },
"ResponseStatus": {
"type": "string",
"description": "Whether a ledger entry is a saved response or a stop at a gate.",
diff --git a/packages/sdk/src/entities/account-managers/grant.ts b/packages/sdk/src/entities/account-managers/grant.ts
new file mode 100644
index 0000000000..1ba00fe3fb
--- /dev/null
+++ b/packages/sdk/src/entities/account-managers/grant.ts
@@ -0,0 +1,95 @@
+import type { AccountManagerGrant as AccountManagerGrantRecord } from '../../../generated/storage/types.gen';
+import { unwrap } from '../../utils';
+import type { MacroClient } from '../../utils/client';
+import { MacroEntity } from '../entity';
+import { User } from '../users/user';
+
+/** A request for an agent account to manage a person's account, and what became of it. */
+export class AccountManagerGrant extends MacroEntity<AccountManagerGrantRecord> {
+ /** Construct a lazy grant handle. */
+ static byId(client: MacroClient, id: string): AccountManagerGrant {
+ return new AccountManagerGrant(client, id);
+ }
+
+ /** Seed from a fetched grant. */
+ static from(
+ client: MacroClient,
+ record: AccountManagerGrantRecord,
+ ): AccountManagerGrant {
+ return new AccountManagerGrant(client, record.id, record);
+ }
+
+ protected async fetch(): Promise<AccountManagerGrantRecord> {
+ return unwrap(
+ await this.client.storage.getAccountManagerGrant({
+ path: { id: this.id },
+ }),
+ );
+ }
+
+ /** Where the grant is: `pending`, `approved`, `active`, `declined`, `revoked`, or `expired`. */
+ readonly status = this.field('status');
+
+ /** The side that asked: `managed` or `manager`. */
+ readonly requestedBy = this.field('requestedBy');
+
+ /** When the request was made. */
+ readonly createdAt = this.field('createdAt');
+
+ /** When the pending request or unclaimed approval stops being usable. */
+ readonly expiresAt = this.field('expiresAt');
+
+ /** When the manager claimed the token. */
+ readonly claimedAt = this.field('claimedAt');
+
+ /** When the token was last used, to the minute. */
+ readonly lastUsedAt = this.field('lastUsedAt');
+
+ /** The account being managed. */
+ async managed(): Promise<User> {
+ return User.byId(this.client, (await this.detail.get()).managedUserId);
+ }
+
+ /** The agent account doing the managing. */
+ async manager(): Promise<User> {
+ return User.byId(this.client, (await this.detail.get()).managerUserId);
+ }
+
+ /** Approve a request you didn't make. Only the side that didn't ask can. */
+ async approve(): Promise<void> {
+ await this.mutate((c) =>
+ c.storage.respondToAccountManagerRequest({
+ path: { id: this.id },
+ body: { decision: 'approve' },
+ }),
+ );
+ }
+
+ /** Decline a request you didn't make. Only the side that didn't ask can. */
+ async decline(): Promise<void> {
+ await this.mutate((c) =>
+ c.storage.respondToAccountManagerRequest({
+ path: { id: this.id },
+ body: { decision: 'decline' },
+ }),
+ );
+ }
+
+ /**
+ * Get the token for the managed account. Only the manager can, and only once:
+ * save it now. Use it as the SDK's `token` to act as the managed account.
+ */
+ async claimToken(): Promise<string> {
+ const claimed = await this.mutate((c) =>
+ c.storage.claimAccountManagerToken({ path: { id: this.id } }),
+ );
+ return claimed.token;
+ }
+
+ /** End the grant, stopping its token immediately. Either side can. */
+ async revoke(): Promise<void> {
+ await this.mutate((c) =>
+ c.storage.revokeAccountManagerGrant({ path: { id: this.id } }),
+ );
+ }
+}
diff --git a/packages/sdk/src/entities/account-managers/namespace.ts b/packages/sdk/src/entities/account-managers/namespace.ts
new file mode 100644
index 0000000000..d190a0a680
--- /dev/null
+++ b/packages/sdk/src/entities/account-managers/namespace.ts
@@ -0,0 +1,43 @@
+import { unwrap } from '../../utils';
+import type { MacroClient } from '../../utils/client';
+import type { User } from '../users/user';
+import { AccountManagerGrant } from './grant';
+
+/** Account managers: an agent account's full access to a person's account. */
+export class AccountManagerNamespace {
+ constructor(private readonly client: MacroClient) {}
+
+ /** Construct a lazy grant handle. */
+ byId(id: string): AccountManagerGrant {
+ return AccountManagerGrant.byId(this.client, id);
+ }
+
+ /** List the approved and active managers of the caller's account. */
+ async list(): Promise<AccountManagerGrant[]> {
+ return unwrap(await this.client.storage.listAccountManagers()).grants.map(
+ (record) => AccountManagerGrant.from(this.client, record),
+ );
+ }
+
+ /** Ask to manage `user`'s account, in your DM. The caller must be an agent account and `user` a person. */
+ async askToManage(user: User): Promise<AccountManagerGrant> {
+ return this.request(user, 'manager');
+ }
+
+ /** Ask `user`, an agent account, to manage the caller's account, in your DM. The caller must be a person. */
+ async askToBeManagedBy(user: User): Promise<AccountManagerGrant> {
+ return this.request(user, 'managed');
+ }
+
+ private async request(
+ user: User,
+ callerRole: 'managed' | 'manager',
+ ): Promise<AccountManagerGrant> {
+ const record = unwrap(
+ await this.client.storage.requestAccountManager({
+ body: { counterpartyId: user.id, callerRole },
+ }),
+ );
+ return AccountManagerGrant.from(this.client, record);
+ }
+}
diff --git a/packages/sdk/src/macro.ts b/packages/sdk/src/macro.ts
index e72bf6c0b5..70c98d98e2 100644
--- a/packages/sdk/src/macro.ts
+++ b/packages/sdk/src/macro.ts
@@ -1,4 +1,5 @@
import type { MacroOpts } from './config';
+import { AccountManagerNamespace } from './entities/account-managers/namespace';
import { AgentSessionNamespace } from './entities/agent-sessions/namespace';
import { AgentNamespace } from './entities/agents/namespace';
import { AiNamespace } from './entities/ai/namespace';
@@ -123,6 +124,9 @@ export class Macro<T extends MacroOpts = MacroOpts> {
/** apiKeys resources and operations. */
readonly apiKeys: ApiKeyNamespace;
+ /** accountManagers resources and operations. */
+ readonly accountManagers: AccountManagerNamespace;
+
/** harnesses resources and operations. */
readonly harnesses: HarnessNamespace;
@@ -224,6 +228,7 @@ export class Macro<T extends MacroOpts = MacroOpts> {
this.agents = new AgentNamespace(client);
this.initiatives = new InitiativeNamespace(client);
this.apiKeys = new ApiKeyNamespace(client);
+ this.accountManagers = new AccountManagerNamespace(client);
this.me = new MeNamespace(client);
this.harnesses = new HarnessNamespace(client);
this.meetings = new MeetingNamespace(client);
diff --git a/services/authentication_service/AGENTS.md b/services/authentication_service/AGENTS.md
index bfc205edeb..a4d6f74a50 100644
--- a/services/authentication_service/AGENTS.md
+++ b/services/authentication_service/AGENTS.md
@@ -85,7 +85,12 @@ inputs cannot select an agent, and ordinary user credentials remain unattributed
## Agent accounts
- An agent can do everything a person can, including inviting other agents. Do
- not gate actions on `isAgent`; it only changes signup and labeling.
+ not gate actions on `isAgent`; it only changes signup and labeling. The one
+ exception: only an agent can be an account manager, and an agent can't be
+ managed (`crates/account_manager`).
+- Routes that mint credentials, link a sign-in, merge accounts, or delete the
+ account use `AccountHolderOrInternal`, so an account manager's credential can't
+ outlast its own revocation or lock the account's owner out.
- `User."isAgent"` is set in the FusionAuth `user.create` webhook, from
`is_agent` on `/login/passwordless` (carried as FusionAuth user data) or a
pending agent `team_invite`. Those agents skip the seeded content, Loops, and
diff --git a/services/authentication_service/src/api/email/generate_email_link.rs b/services/authentication_service/src/api/email/generate_email_link.rs
index 95cd38f8dd..9276d76054 100644
--- a/services/authentication_service/src/api/email/generate_email_link.rs
+++ b/services/authentication_service/src/api/email/generate_email_link.rs
@@ -5,7 +5,7 @@ use axum::{
http::StatusCode,
response::{IntoResponse, Response},
};
-use macro_authorization::{MacroAuthorizationExtractor, UserOrInternal};
+use macro_authorization::{AccountHolderOrInternal, MacroAuthorizationExtractor};
use macro_middleware::tracking::ClientIp;
use utoipa::ToSchema;
@@ -39,7 +39,7 @@ static VERIFY_EMAIL_TEMPLATE: &str = include_str!("./_verify_email_template.html
#[tracing::instrument(skip(ctx, authorization, ip_context,req), fields(client_ip=%ip_context, email=%req.email, fusion_user_id=%authorization.authorization.user.user_context.fusion_user_id), err(Debug))]
pub async fn handler(
State(ctx): State<ApiContext>,
- authorization: MacroAuthorizationExtractor<AuthorizationService, UserOrInternal>,
+ authorization: MacroAuthorizationExtractor<AuthorizationService, AccountHolderOrInternal>,
ip_context: ClientIp,
extract::Json(mut req): extract::Json<GenerateEmailLinkRequest>,
) -> Result<Response, Response> {
diff --git a/services/authentication_service/src/api/jwt/macro_api_token.rs b/services/authentication_service/src/api/jwt/macro_api_token.rs
index b957d4229e..7d5f308cd9 100644
--- a/services/authentication_service/src/api/jwt/macro_api_token.rs
+++ b/services/authentication_service/src/api/jwt/macro_api_token.rs
@@ -6,7 +6,7 @@ use axum::{
response::{IntoResponse, Response},
};
use macro_auth::macro_api_token::EncodeMacroApiTokenArgs;
-use macro_authorization::{MacroAuthorizationExtractor, UserOrInternal};
+use macro_authorization::{AccountHolderOrInternal, MacroAuthorizationExtractor};
use sqlx::PgPool;
use utoipa::ToSchema;
@@ -44,7 +44,7 @@ pub struct MacroApiTokenQuery {
pub async fn handler(
State(db): State<PgPool>,
State(macro_api_token_context): State<MacroApiTokenContext>,
- authorization: MacroAuthorizationExtractor<AuthorizationService, UserOrInternal>,
+ authorization: MacroAuthorizationExtractor<AuthorizationService, AccountHolderOrInternal>,
Query(query): Query<MacroApiTokenQuery>,
) -> Result<Response, Response> {
let user_context = &authorization.authorization.user.user_context;
diff --git a/services/authentication_service/src/api/link/create_in_progress_link.rs b/services/authentication_service/src/api/link/create_in_progress_link.rs
index 088d168950..2fe48e5761 100644
--- a/services/authentication_service/src/api/link/create_in_progress_link.rs
+++ b/services/authentication_service/src/api/link/create_in_progress_link.rs
@@ -4,7 +4,7 @@ use axum::{
http::StatusCode,
response::{IntoResponse, Response},
};
-use macro_authorization::{MacroAuthorizationExtractor, UserOrInternal};
+use macro_authorization::{AccountHolderOrInternal, MacroAuthorizationExtractor};
use macro_middleware::tracking::ClientIp;
use model::response::ErrorResponse;
@@ -33,7 +33,7 @@ pub struct CreateInProgressLinkResponse {
pub async fn handler(
State(ctx): State<ApiContext>,
ip_context: ClientIp,
- authorization: MacroAuthorizationExtractor<AuthorizationService, UserOrInternal>,
+ authorization: MacroAuthorizationExtractor<AuthorizationService, AccountHolderOrInternal>,
) -> Result<Response, Response> {
tracing::info!("create_in_progress_link");
diff --git a/services/authentication_service/src/api/link/github.rs b/services/authentication_service/src/api/link/github.rs
index 282f278c1a..27c66f700b 100644
--- a/services/authentication_service/src/api/link/github.rs
+++ b/services/authentication_service/src/api/link/github.rs
@@ -9,7 +9,7 @@ use github::domain::{
models::{GithubError, GithubLinkStatus},
ports::GithubLinkService,
};
-use macro_authorization::{MacroAuthorizationExtractor, UserOrInternal};
+use macro_authorization::{AccountHolderOrInternal, MacroAuthorizationExtractor};
use macro_middleware::tracking::ClientIp;
use model::response::{EmptyResponse, ErrorResponse};
use serde_utils::urlencode::UrlEncoded;
@@ -140,7 +140,7 @@ impl IntoResponse for GithubLinkStatusError {
pub async fn check_github_link_status_handler(
State(ctx): State<ApiContext>,
ip_context: ClientIp,
- authorization: MacroAuthorizationExtractor<AuthorizationService, UserOrInternal>,
+ authorization: MacroAuthorizationExtractor<AuthorizationService, AccountHolderOrInternal>,
) -> Result<Response, GithubLinkStatusError> {
let user_id = &authorization.authorization.user.macro_user_id;
let status = ctx
@@ -198,7 +198,7 @@ pub async fn init_github_link_handler(
State(ctx): State<ApiContext>,
query: Query<InitGithubLinkQueryParams>,
ip_context: ClientIp,
- authorization: MacroAuthorizationExtractor<AuthorizationService, UserOrInternal>,
+ authorization: MacroAuthorizationExtractor<AuthorizationService, AccountHolderOrInternal>,
) -> Result<Json<InitGithubLinkResponse>, InitGithubLinkError> {
let Query(InitGithubLinkQueryParams { original_url }) = query;
let fusion_user_id = &authorization.authorization.user.user_context.fusion_user_id;
@@ -314,7 +314,7 @@ impl IntoResponse for DeleteGithubLinkError {
pub async fn delete_github_link_handler(
State(ctx): State<ApiContext>,
ip_context: ClientIp,
- authorization: MacroAuthorizationExtractor<AuthorizationService, UserOrInternal>,
+ authorization: MacroAuthorizationExtractor<AuthorizationService, AccountHolderOrInternal>,
) -> Result<Json<EmptyResponse>, DeleteGithubLinkError> {
ctx.github_link_service
.delete_user_link(&authorization.authorization.user.macro_user_id)
diff --git a/services/authentication_service/src/api/link/gmail.rs b/services/authentication_service/src/api/link/gmail.rs
index 033a431169..d27029b803 100644
--- a/services/authentication_service/src/api/link/gmail.rs
+++ b/services/authentication_service/src/api/link/gmail.rs
@@ -6,7 +6,7 @@ use axum::{
response::{IntoResponse, Response},
};
use calendar_events::domain::models::google_calendar_scope_parameter;
-use macro_authorization::{MacroAuthorizationExtractor, UserOrInternal};
+use macro_authorization::{AccountHolderOrInternal, MacroAuthorizationExtractor};
use macro_middleware::tracking::ClientIp;
use model::response::ErrorResponse;
use roles_and_permissions::domain::model::PermissionId;
@@ -319,7 +319,7 @@ impl IntoResponse for GmailLinkStatusError {
pub async fn check_gmail_link_status_handler(
State(ctx): State<ApiContext>,
ip_context: ClientIp,
- authorization: MacroAuthorizationExtractor<AuthorizationService, UserOrInternal>,
+ authorization: MacroAuthorizationExtractor<AuthorizationService, AccountHolderOrInternal>,
) -> Result<Json<GmailLinkStatusResponse>, GmailLinkStatusError> {
// Check if the user has an email link in db
if macro_db_client::email::check_user_email_link(
diff --git a/services/authentication_service/src/api/link/outlook.rs b/services/authentication_service/src/api/link/outlook.rs
index ee5ea5cd28..6c2a21edc2 100644
--- a/services/authentication_service/src/api/link/outlook.rs
+++ b/services/authentication_service/src/api/link/outlook.rs
@@ -5,7 +5,7 @@ use axum::{
http::StatusCode,
response::{IntoResponse, Response},
};
-use macro_authorization::{MacroAuthorizationExtractor, UserOrInternal};
+use macro_authorization::{AccountHolderOrInternal, MacroAuthorizationExtractor};
use macro_middleware::tracking::ClientIp;
use macro_user_id::user_id::MacroUserIdStr;
use model::response::ErrorResponse;
@@ -116,7 +116,7 @@ pub async fn init_outlook_link_handler(
reconnect_link_id,
}): Query<InitOutlookLinkQueryParams>,
ip_context: ClientIp,
- authorization: MacroAuthorizationExtractor<AuthorizationService, UserOrInternal>,
+ authorization: MacroAuthorizationExtractor<AuthorizationService, AccountHolderOrInternal>,
) -> Result<Json<InitOutlookLinkResponse>, InitOutlookLinkError> {
let service = ctx
.microsoft_auth
@@ -220,7 +220,7 @@ pub async fn email_connection_providers(
Query(EmailConnectionProvidersQueryParams { original_url }): Query<
EmailConnectionProvidersQueryParams,
>,
- authorization: MacroAuthorizationExtractor<AuthorizationService, UserOrInternal>,
+ authorization: MacroAuthorizationExtractor<AuthorizationService, AccountHolderOrInternal>,
) -> Result<Json<EmailConnectionProviders>, InitOutlookLinkError> {
if original_url
.as_ref()
diff --git a/services/authentication_service/src/api/merge/create_merge_request.rs b/services/authentication_service/src/api/merge/create_merge_request.rs
index 9e11fa0170..8950447521 100644
--- a/services/authentication_service/src/api/merge/create_merge_request.rs
+++ b/services/authentication_service/src/api/merge/create_merge_request.rs
@@ -5,7 +5,7 @@ use axum::{
http::StatusCode,
response::{IntoResponse, Response},
};
-use macro_authorization::{MacroAuthorizationExtractor, UserOrInternal};
+use macro_authorization::{AccountHolderOrInternal, MacroAuthorizationExtractor};
use macro_middleware::tracking::ClientIp;
use utoipa::ToSchema;
@@ -43,7 +43,7 @@ static MERGE_REQUEST_TEMPLATE: &str = include_str!("./_merge_request_template.ht
#[tracing::instrument(skip(ctx, authorization, ip_context,req), fields(client_ip=%ip_context, email=%req.email, fusion_user_id=%authorization.authorization.user.user_context.fusion_user_id), err(Debug))]
pub async fn handler(
State(ctx): State<ApiContext>,
- authorization: MacroAuthorizationExtractor<AuthorizationService, UserOrInternal>,
+ authorization: MacroAuthorizationExtractor<AuthorizationService, AccountHolderOrInternal>,
ip_context: ClientIp,
extract::Json(mut req): extract::Json<CreateAccountMergeRequest>,
) -> Result<Response, Response> {
diff --git a/services/authentication_service/src/api/merge/verify_merge_request.rs b/services/authentication_service/src/api/merge/verify_merge_request.rs
index ffb5ff67e4..62339ea771 100644
--- a/services/authentication_service/src/api/merge/verify_merge_request.rs
+++ b/services/authentication_service/src/api/merge/verify_merge_request.rs
@@ -6,7 +6,7 @@ use axum::{
http::StatusCode,
response::{IntoResponse, Response},
};
-use macro_authorization::{MacroAuthorizationExtractor, UserOrInternal};
+use macro_authorization::{AccountHolderOrInternal, MacroAuthorizationExtractor};
use macro_middleware::tracking::ClientIp;
use crate::api::context::{ApiContext, AuthorizationService};
@@ -37,7 +37,7 @@ pub struct Params {
pub async fn handler(
State(ctx): State<ApiContext>,
ip_context: ClientIp,
- authorization: MacroAuthorizationExtractor<AuthorizationService, UserOrInternal>,
+ authorization: MacroAuthorizationExtractor<AuthorizationService, AccountHolderOrInternal>,
extract::Path(Params { code }): extract::Path<Params>,
) -> Result<Response, Response> {
tracing::info!("verify_merge_request");
diff --git a/services/authentication_service/src/api/user/agent_setup.rs b/services/authentication_service/src/api/user/agent_setup.rs
index 54fae755ba..72cc8c6087 100644
--- a/services/authentication_service/src/api/user/agent_setup.rs
+++ b/services/authentication_service/src/api/user/agent_setup.rs
@@ -1,5 +1,5 @@
use axum::{Json, extract::State, http::StatusCode};
-use macro_authorization::{MacroAuthorizationExtractor, UserOrInternal};
+use macro_authorization::{AccountHolderOrInternal, MacroAuthorizationExtractor};
use macro_user_id::user_id::MacroUserIdStr;
use model::response::ErrorResponse;
use teams::domain::team_repo::TeamService;
@@ -52,7 +52,7 @@ fn error(status: StatusCode, message: &str) -> (StatusCode, Json<ErrorResponse<'
)]
pub async fn handler(
State(ctx): State<ApiContext>,
- authorization: MacroAuthorizationExtractor<AuthorizationService, UserOrInternal>,
+ authorization: MacroAuthorizationExtractor<AuthorizationService, AccountHolderOrInternal>,
) -> Result<Json<AgentSetupResponse>, (StatusCode, Json<ErrorResponse<'static>>)> {
let macro_user_id = &authorization.authorization.user.macro_user_id;
let user = macro_db_client::user::get::get_legacy_user_info(&ctx.db, macro_user_id)
diff --git a/services/authentication_service/src/api/user/delete_user.rs b/services/authentication_service/src/api/user/delete_user.rs
index a462897e52..ed04ca7a74 100644
--- a/services/authentication_service/src/api/user/delete_user.rs
+++ b/services/authentication_service/src/api/user/delete_user.rs
@@ -4,7 +4,7 @@ use axum::{
http::StatusCode,
response::{IntoResponse, Response},
};
-use macro_authorization::{MacroAuthorizationExtractor, UserOrInternal};
+use macro_authorization::{AccountHolderOrInternal, MacroAuthorizationExtractor};
use tower_cookies::Cookies;
use crate::api::{
@@ -29,7 +29,7 @@ use model::response::{ErrorResponse, GenericSuccessResponse};
#[tracing::instrument(skip(ctx, authorization, jwt_session, cookies), fields(user_id=%authorization.authorization.user.user_context.user_id))]
pub async fn handler(
State(ctx): State<ApiContext>,
- authorization: MacroAuthorizationExtractor<AuthorizationService, UserOrInternal>,
+ authorization: MacroAuthorizationExtractor<AuthorizationService, AccountHolderOrInternal>,
JwtSessionContext(jwt_session): JwtSessionContext,
cookies: Cookies,
) -> Result<Response, Response> {
diff --git a/services/document_storage_service/Cargo.toml b/services/document_storage_service/Cargo.toml
index 3d727efa4d..74abd2d031 100644
--- a/services/document_storage_service/Cargo.toml
+++ b/services/document_storage_service/Cargo.toml
@@ -311,6 +311,11 @@ tower-http = { workspace = true, features = ["compression-gzip"] }
tracing = { workspace = true }
unicode-segmentation = { workspace = true }
urlencoding = { workspace = true }
+account_manager = { path = "../../crates/account_manager", features = [
+ "inbound",
+ "outbound",
+ "postgres",
+] }
user_api_key = { path = "../../crates/user_api_key", features = [
"inbound",
"postgres",
diff --git a/services/document_storage_service/src/api.rs b/services/document_storage_service/src/api.rs
index 0247c15390..ee62f6414b 100644
--- a/services/document_storage_service/src/api.rs
+++ b/services/document_storage_service/src/api.rs
@@ -295,6 +295,12 @@ fn api_router(state: ApiContext) -> Router {
state.channel_labels_state.clone(),
),
)
+ .nest(
+ "/account-managers",
+ account_manager::inbound::axum_router::account_manager_router(
+ state.account_manager_state.clone(),
+ ),
+ )
.nest(
"/user-api-keys",
user_api_key::inbound::axum_router::user_api_key_router(
diff --git a/services/document_storage_service/src/api/context.rs b/services/document_storage_service/src/api/context.rs
index cf8e6e6632..c42de760eb 100644
--- a/services/document_storage_service/src/api/context.rs
+++ b/services/document_storage_service/src/api/context.rs
@@ -2,6 +2,13 @@ use contacts::domain::service::SqsContactsIngress;
use contacts::outbound::ingress::SqsContactsQueue;
use crate::{config::Config, service::s3::S3};
+use account_manager::{
+ domain::service::AccountManagerServiceImpl,
+ inbound::axum_router::AccountManagerRouterState,
+ outbound::{
+ dm_delivery::DmAccountManagerDelivery, pg_account_manager_repo::PgAccountManagerRepo,
+ },
+};
use axum::extract::FromRef;
use bots::{
domain::service::BotServiceImpl,
@@ -646,6 +653,16 @@ pub(crate) type DssChannelLabelsState =
pub(crate) type DssFavoritesState =
FavoritesRouterState<FavoritesServiceType, EntityAccessService, AuthorizationService>;
+/// Type alias for the account manager service.
+pub(crate) type AccountManagerServiceType = AccountManagerServiceImpl<
+ PgAccountManagerRepo,
+ DmAccountManagerDelivery<DssChannelService, EntityAccessService>,
+>;
+
+/// Type alias for the account manager router state.
+pub(crate) type DssAccountManagerState =
+ AccountManagerRouterState<AccountManagerServiceType, AuthorizationService>;
+
/// Type alias for the user API key service.
pub(crate) type UserApiKeyServiceType = UserApiKeyServiceImpl<PgUserApiKeysRepo>;
@@ -936,6 +953,7 @@ pub(crate) struct ApiContext {
pub favorites_mutation_service: Arc<FavoritesMutationServiceType>,
pub channel_labels_state: DssChannelLabelsState,
pub user_api_key_state: DssUserApiKeyState,
+ pub account_manager_state: DssAccountManagerState,
pub reminders_state: DssRemindersState,
pub access_requests_state: AccessRequestsState,
pub slack_state: DssSlackState,
diff --git a/services/document_storage_service/src/api/swagger.rs b/services/document_storage_service/src/api/swagger.rs
index 2dbb24a1ce..a701f91765 100644
--- a/services/document_storage_service/src/api/swagger.rs
+++ b/services/document_storage_service/src/api/swagger.rs
@@ -57,6 +57,13 @@ use crate::{
},
},
};
+use account_manager::domain::models::{
+ AccountManagerDecision, AccountManagerGrant, AccountManagerGrantStatus, AccountManagerRole,
+};
+use account_manager::inbound::axum_router::{
+ AccountManagersList, ClaimedAccountManagerToken, RequestAccountManagerBody,
+ RespondToAccountManagerRequestBody,
+};
use channel_labels::domain::models::{
ChannelLabel, ChannelLabelRule, ChannelLabelScopeSelection, ChannelLabelsList,
SmartTagChannelMatch, SmartTagPreview,
@@ -459,6 +466,12 @@ use utoipa::OpenApi;
channel_labels::inbound::axum_router::set_channel_label_handler,
// user api keys
+ account_manager::inbound::axum_router::request_account_manager_handler,
+ account_manager::inbound::axum_router::list_account_managers_handler,
+ account_manager::inbound::axum_router::get_account_manager_grant_handler,
+ account_manager::inbound::axum_router::respond_to_account_manager_request_handler,
+ account_manager::inbound::axum_router::claim_account_manager_token_handler,
+ account_manager::inbound::axum_router::revoke_account_manager_grant_handler,
user_api_key::inbound::axum_router::create_user_api_key_handler,
user_api_key::inbound::axum_router::list_user_api_keys_handler,
user_api_key::inbound::axum_router::delete_user_api_key_handler,
@@ -738,6 +751,14 @@ use utoipa::OpenApi;
GitRefDto,
Favorite,
FavoritesList,
+ AccountManagerDecision,
+ AccountManagerGrant,
+ AccountManagerGrantStatus,
+ AccountManagerRole,
+ AccountManagersList,
+ ClaimedAccountManagerToken,
+ RequestAccountManagerBody,
+ RespondToAccountManagerRequestBody,
CreatedUserApiKey,
CreateUserApiKeyRequest,
UserApiKeyInfo,
diff --git a/services/document_storage_service/src/server.rs b/services/document_storage_service/src/server.rs
index 9cb936bc38..27c8f4d652 100644
--- a/services/document_storage_service/src/server.rs
+++ b/services/document_storage_service/src/server.rs
@@ -16,6 +16,13 @@ use crate::{
outbound,
service::{self, s3::S3},
};
+use account_manager::{
+ domain::service::AccountManagerServiceImpl,
+ inbound::axum_router::AccountManagerRouterState,
+ outbound::{
+ dm_delivery::DmAccountManagerDelivery, pg_account_manager_repo::PgAccountManagerRepo,
+ },
+};
use agent_session_realtime::{
domain::service::AgentSessionLogConsumerService,
outbound::redis_stream::consumer::RedisLogStreamConsumer,
@@ -1975,6 +1982,15 @@ async fn run_server() -> anyhow::Result<()> {
favorites_service.clone(),
entity_access_service.clone(),
));
+ let account_manager_service = Arc::new(AccountManagerServiceImpl::new(
+ PgAccountManagerRepo::new(db.clone()),
+ DmAccountManagerDelivery::new(
+ channels_service.clone(),
+ message_commands.clone(),
+ entity_access_service.clone(),
+ macro_service_urls::AppServiceUrl::new()?,
+ ),
+ ));
let user_api_key_service = Arc::new(UserApiKeyServiceImpl::new(PgUserApiKeysRepo::new(
db.clone(),
)));
@@ -2263,6 +2279,10 @@ async fn run_server() -> anyhow::Result<()> {
entity_access_service.clone(),
authorization_state.clone(),
),
+ account_manager_state: AccountManagerRouterState::new(
+ account_manager_service,
+ authorization_state.clone(),
+ ),
user_api_key_state: UserApiKeyRouterState::new(
user_api_key_service,
authorization_state.clone(),