Skip to content

Open-source AI teammates in Slack, Teams, Discord, Telegram and Mattermost. Self-host it, with any agent harness and any model.

Bring the surface snapshot up to main

Petr Bauch770aa47151de
diff --git a/console/tooling-e2e/surface/exemptions.json b/console/tooling-e2e/surface/exemptions.json
index 396af9ff6..423bd87ed 100644
--- a/console/tooling-e2e/surface/exemptions.json
+++ b/console/tooling-e2e/surface/exemptions.json
@@ -1,40 +1,38 @@
{
"_about": "Read by src/gate/gate.ts; see the README, \"Coverage gate\". exempt and unauthenticated need a reason per entry. backlog is what no scenario covered when the gate landed: it only shrinks, and the gate fails on an entry a scenario now covers.",
"exempt": {
+ "GET /gateway/auth/oidc/callback": "Needs a live OIDC identity provider; the harness signs in with a password.",
+ "GET /gateway/auth/oidc/login": "Needs a live OIDC identity provider; the harness signs in with a password.",
"GET /gateway/docs": "FastAPI's generated API documentation; no behaviour of Switch's own to cover.",
"GET /gateway/docs/oauth2-redirect": "FastAPI's generated API documentation; no behaviour of Switch's own to cover.",
- "GET /gateway/redoc": "FastAPI's generated API documentation; no behaviour of Switch's own to cover.",
+ "GET /gateway/hosted-controller/machines": "Needs a hosted controller configured (HOSTED_CONTROLLER_CONFIG_PATH), which no stack the harness builds has.",
"GET /gateway/openapi.json": "FastAPI's generated API documentation; no behaviour of Switch's own to cover.",
- "GET /gateway/auth/oidc/login": "Needs a live OIDC identity provider; the harness signs in with a password.",
- "GET /gateway/auth/oidc/callback": "Needs a live OIDC identity provider; the harness signs in with a password.",
"GET /gateway/provider-connections/github/authorize": "Needs a registered GitHub App and a browser round trip through github.com.",
"GET /gateway/provider-connections/github/callback": "Needs a registered GitHub App and a browser round trip through github.com.",
- "POST /gateway/provider-connections/github/callback": "Needs a registered GitHub App and a browser round trip through github.com.",
+ "GET /gateway/redoc": "FastAPI's generated API documentation; no behaviour of Switch's own to cover.",
"GET /gateway/service-connections/{service}/flows/authorize": "Needs the third-party service's own sign-in page in a browser.",
"GET /gateway/service-connections/{service}/flows/callback": "Needs the third-party service's own sign-in page in a browser.",
- "POST /gateway/service-connections/{service}/flows/callback": "Needs the third-party service's own sign-in page in a browser.",
- "GET /gateway/hosted-controller/machines": "Needs a hosted controller configured (HOSTED_CONTROLLER_CONFIG_PATH), which no stack the harness builds has.",
- "POST /gateway/hosted-controller/machines/{machine_id}/prepare": "Needs a hosted controller configured (HOSTED_CONTROLLER_CONFIG_PATH), which no stack the harness builds has.",
- "POST /gateway/hosted-controller/machines/{machine_id}/observation": "Needs a hosted controller configured (HOSTED_CONTROLLER_CONFIG_PATH), which no stack the harness builds has."
+ "POST /gateway/auth/oidc/exchange": "Needs a code from a live OIDC sign-in; the harness signs in with a password.",
+ "POST /gateway/hosted-controller/machines/{machine_id}/observation": "Needs a hosted controller configured (HOSTED_CONTROLLER_CONFIG_PATH), which no stack the harness builds has.",
+ "POST /gateway/hosted-controller/machines/{machine_id}/prepare": "Needs a hosted controller configured (HOSTED_CONTROLLER_CONFIG_PATH), which no stack the harness builds has."
},
"unauthenticated": {
+ "GET /gateway/agents/known-types": "The catalogue of agent types this server can register and their option schemas; no tenant data. Public since the initial import, and nothing records whether that is deliberate.",
+ "GET /gateway/auth/config": "Read by the login page before any session exists, to choose which sign-in methods to offer.",
+ "GET /gateway/auth/oidc/callback": "The OIDC sign-in round trip, before any session exists.",
+ "GET /gateway/auth/oidc/login": "The OIDC sign-in round trip, before any session exists.",
"GET /gateway/docs": "FastAPI's generated docs, served without a session. They publish the gateway's whole route list and schemas to anyone who can reach it.",
"GET /gateway/docs/oauth2-redirect": "FastAPI's generated docs, served without a session. They publish the gateway's whole route list and schemas to anyone who can reach it.",
- "GET /gateway/redoc": "FastAPI's generated docs, served without a session. They publish the gateway's whole route list and schemas to anyone who can reach it.",
"GET /gateway/openapi.json": "FastAPI's generated docs, served without a session. They publish the gateway's whole route list and schemas to anyone who can reach it.",
- "POST /gateway/auth/login": "How a session is obtained.",
- "POST /gateway/auth/signup": "How an account, and its first session, is created.",
- "POST /gateway/auth/logout": "Only clears the session cookie; there is nothing behind it to protect.",
- "GET /gateway/auth/config": "Read by the login page before any session exists, to choose which sign-in methods to offer.",
- "GET /gateway/auth/oidc/login": "The OIDC sign-in round trip, before any session exists.",
- "GET /gateway/auth/oidc/callback": "The OIDC sign-in round trip, before any session exists.",
"GET /gateway/provider-connections/github/authorize": "The GitHub App's redirect round trip: the sign-in flow is identified by its state parameter, not a session.",
"GET /gateway/provider-connections/github/callback": "The GitHub App's redirect round trip: the sign-in flow is identified by its state parameter, not a session.",
- "POST /gateway/provider-connections/github/callback": "The GitHub App's redirect round trip: the sign-in flow is identified by its state parameter, not a session.",
+ "GET /gateway/redoc": "FastAPI's generated docs, served without a session. They publish the gateway's whole route list and schemas to anyone who can reach it.",
"GET /gateway/service-connections/{service}/flows/authorize": "The third-party sign-in round trip: the flow is identified by its state, not a session.",
"GET /gateway/service-connections/{service}/flows/callback": "The third-party sign-in round trip: the flow is identified by its state, not a session.",
- "POST /gateway/service-connections/{service}/flows/callback": "The third-party sign-in round trip: the flow is identified by its state, not a session.",
- "GET /gateway/agents/known-types": "The catalogue of agent types this server can register and their option schemas; no tenant data. Public since the initial import, and nothing records whether that is deliberate."
+ "POST /gateway/auth/login": "How a session is obtained.",
+ "POST /gateway/auth/logout": "Only clears the session cookie; there is nothing behind it to protect.",
+ "POST /gateway/auth/oidc/exchange": "Trades a code from an OIDC sign-in for a session, so it runs before one exists; the code is good only with the PKCE verifier its challenge was made from, and only while fresh.",
+ "POST /gateway/auth/signup": "How an account, and its first session, is created."
},
"backlog": [
"accept_task",
@@ -58,6 +56,7 @@
"finalise_task",
"get_advanced_config",
"get_agent_detail",
+ "get_my_context",
"get_role_detail",
"get_room_detail",
"get_room_group_detail",
@@ -81,9 +80,11 @@
"list_templates",
"load_internal_documents",
"release_role",
+ "remove_agent_service",
"run_template",
"save_template",
"send_targeted_message",
+ "set_agent_service",
"unarchive_room",
"unlink_rooms",
"update_agent_detail",
@@ -95,11 +96,13 @@
"DELETE /gateway/agents/{agent_id}",
"DELETE /gateway/agents/{agent_id}/service-grants/{service}",
"DELETE /gateway/api-keys/{key_id}",
+ "DELETE /gateway/auth/me",
"DELETE /gateway/chats/{room_id}/hidden",
"DELETE /gateway/chats/{room_id}/members/{member_user_id}",
"DELETE /gateway/collaborations/{bridge_id}",
"DELETE /gateway/collaborations/{bridge_id}/identities/{external_user_row_id}",
"DELETE /gateway/collaborations/{bridge_id}/teams/{team_id}",
+ "DELETE /gateway/connector-apps/{service}",
"DELETE /gateway/connectors/{connector_id}",
"DELETE /gateway/documents/{document_id}",
"DELETE /gateway/management/agents/{agent_id}",
@@ -150,11 +153,14 @@
"GET /gateway/chats/{room_id}/members",
"GET /gateway/chats/{room_id}/messages",
"GET /gateway/collaborations",
+ "GET /gateway/collaborations/setup/slack",
"GET /gateway/collaborations/types",
"GET /gateway/collaborations/{bridge_id}/directory",
"GET /gateway/collaborations/{bridge_id}/teams",
"GET /gateway/collaborations/{bridge_id}/teams-package",
"GET /gateway/collaborations/{bridge_id}/users",
+ "GET /gateway/connector-apps",
+ "GET /gateway/connector-apps/{service}/impact",
"GET /gateway/connectors",
"GET /gateway/connectors/types",
"GET /gateway/connectors/{connector_id}",
@@ -203,6 +209,7 @@
"GET /gateway/rooms/{room_id}/roles",
"GET /gateway/rooms/{room_id}/yaml",
"GET /gateway/service-connections",
+ "GET /gateway/service-connections/{service}/agents",
"GET /gateway/service-connections/{service}/flows/{flow_id}",
"GET /gateway/template-runs",
"GET /gateway/templates",
@@ -219,6 +226,7 @@
"GET /gateway/trust-settings",
"GET /gateway/users",
"GET /gateway/version",
+ "GET /gateway/workspace/services",
"PATCH /gateway/agents/{agent_id}/options",
"PATCH /gateway/collaborations/{bridge_id}",
"PATCH /gateway/documents/{document_id}",
@@ -250,9 +258,12 @@
"POST /gateway/chats/{room_id}/messages",
"POST /gateway/chats/{room_id}/warm",
"POST /gateway/collaborations",
+ "POST /gateway/collaborations/setup/slack/check",
"POST /gateway/collaborations/{bridge_id}/default",
"POST /gateway/collaborations/{bridge_id}/identities",
"POST /gateway/collaborations/{bridge_id}/teams/{team_id}",
+ "POST /gateway/connector-apps/{service}/check",
+ "POST /gateway/connector-apps/{service}/import",
"POST /gateway/connectors",
"POST /gateway/documents",
"POST /gateway/hosted-machines/ensure",
@@ -271,7 +282,6 @@
"POST /gateway/packages/{package_id}/references/{reference_id}",
"POST /gateway/provider-connections/github/flows",
"POST /gateway/provider-connections/github/flows/{flow_id}/complete",
- "POST /gateway/provider-connections/github/flows/{flow_id}/confirm",
"POST /gateway/references",
"POST /gateway/references/reference-types",
"POST /gateway/room-groups",
@@ -291,7 +301,6 @@
"POST /gateway/rooms/{room_id}/users",
"POST /gateway/service-connections/{service}/flows",
"POST /gateway/service-connections/{service}/flows/{flow_id}/complete",
- "POST /gateway/service-connections/{service}/flows/{flow_id}/confirm",
"POST /gateway/template-runs/{root_room_id}/continue",
"POST /gateway/template-runs/{root_room_id}/stop",
"POST /gateway/templates",
@@ -310,6 +319,7 @@
"PUT /gateway/agents/{agent_id}/service-grants/{service}",
"PUT /gateway/auth/me/password",
"PUT /gateway/chats/{room_id}/hidden",
+ "PUT /gateway/connector-apps/{service}",
"PUT /gateway/management/agents/{agent_id}",
"PUT /gateway/management/controllers/{controller_id}/provider-logins/{provider}",
"PUT /gateway/room-groups/{group_id}/rooms",
@@ -318,6 +328,7 @@
"PUT /gateway/rooms/{room_id}/protection",
"PUT /gateway/service-connections/{service}/key",
"PUT /gateway/tenants/{tenant_id}/budgets/{budget_id}",
- "PUT /gateway/trust-settings"
+ "PUT /gateway/trust-settings",
+ "PUT /gateway/workspace/services/{service}"
]
}
diff --git a/console/tooling-e2e/surface/server-surface.json b/console/tooling-e2e/surface/server-surface.json
index 6fef2272a..67634a36c 100644
--- a/console/tooling-e2e/surface/server-surface.json
+++ b/console/tooling-e2e/surface/server-surface.json
@@ -23,6 +23,7 @@
"finalise_task",
"get_advanced_config",
"get_agent_detail",
+ "get_my_context",
"get_role_detail",
"get_room_detail",
"get_room_group_detail",
@@ -49,9 +50,11 @@
"post_message",
"read_context",
"release_role",
+ "remove_agent_service",
"run_template",
"save_template",
"send_targeted_message",
+ "set_agent_service",
"unarchive_room",
"unlink_rooms",
"update_agent_detail",
@@ -83,6 +86,11 @@
"auth": "session",
"flags": []
},
+ {
+ "route": "DELETE /gateway/auth/me",
+ "auth": "session",
+ "flags": []
+ },
{
"route": "DELETE /gateway/chats/{room_id}/hidden",
"auth": "session",
@@ -108,6 +116,13 @@
"auth": "session",
"flags": []
},
+ {
+ "route": "DELETE /gateway/connector-apps/{service}",
+ "auth": "session",
+ "flags": [
+ "service_connections"
+ ]
+ },
{
"route": "DELETE /gateway/connectors/{connector_id}",
"auth": "session",
@@ -380,6 +395,11 @@
"auth": "session",
"flags": []
},
+ {
+ "route": "GET /gateway/collaborations/setup/slack",
+ "auth": "session",
+ "flags": []
+ },
{
"route": "GET /gateway/collaborations/types",
"auth": "session",
@@ -405,6 +425,20 @@
"auth": "session",
"flags": []
},
+ {
+ "route": "GET /gateway/connector-apps",
+ "auth": "session",
+ "flags": [
+ "service_connections"
+ ]
+ },
+ {
+ "route": "GET /gateway/connector-apps/{service}/impact",
+ "auth": "session",
+ "flags": [
+ "service_connections"
+ ]
+ },
{
"route": "GET /gateway/connectors",
"auth": "session",
@@ -692,6 +726,13 @@
"service_connections"
]
},
+ {
+ "route": "GET /gateway/service-connections/{service}/agents",
+ "auth": "session",
+ "flags": [
+ "service_connections"
+ ]
+ },
{
"route": "GET /gateway/service-connections/{service}/flows/authorize",
"auth": "none",
@@ -788,6 +829,13 @@
"auth": "session",
"flags": []
},
+ {
+ "route": "GET /gateway/workspace/services",
+ "auth": "session",
+ "flags": [
+ "service_connections"
+ ]
+ },
{
"route": "PATCH /gateway/agents/{agent_id}/options",
"auth": "session",
@@ -897,6 +945,11 @@
"auth": "none",
"flags": []
},
+ {
+ "route": "POST /gateway/auth/oidc/exchange",
+ "auth": "none",
+ "flags": []
+ },
{
"route": "POST /gateway/auth/refresh",
"auth": "session",
@@ -947,6 +1000,11 @@
"auth": "session",
"flags": []
},
+ {
+ "route": "POST /gateway/collaborations/setup/slack/check",
+ "auth": "session",
+ "flags": []
+ },
{
"route": "POST /gateway/collaborations/{bridge_id}/default",
"auth": "session",
@@ -962,6 +1020,20 @@
"auth": "session",
"flags": []
},
+ {
+ "route": "POST /gateway/connector-apps/{service}/check",
+ "auth": "session",
+ "flags": [
+ "service_connections"
+ ]
+ },
+ {
+ "route": "POST /gateway/connector-apps/{service}/import",
+ "auth": "session",
+ "flags": [
+ "service_connections"
+ ]
+ },
{
"route": "POST /gateway/connectors",
"auth": "session",
@@ -1060,11 +1132,6 @@
"auth": "session",
"flags": []
},
- {
- "route": "POST /gateway/provider-connections/github/callback",
- "auth": "none",
- "flags": []
- },
{
"route": "POST /gateway/provider-connections/github/flows",
"auth": "session",
@@ -1075,11 +1142,6 @@
"auth": "session",
"flags": []
},
- {
- "route": "POST /gateway/provider-connections/github/flows/{flow_id}/confirm",
- "auth": "session",
- "flags": []
- },
{
"route": "POST /gateway/references",
"auth": "session",
@@ -1177,13 +1239,6 @@
"service_connections"
]
},
- {
- "route": "POST /gateway/service-connections/{service}/flows/callback",
- "auth": "none",
- "flags": [
- "service_connections"
- ]
- },
{
"route": "POST /gateway/service-connections/{service}/flows/{flow_id}/complete",
"auth": "session",
@@ -1191,13 +1246,6 @@
"service_connections"
]
},
- {
- "route": "POST /gateway/service-connections/{service}/flows/{flow_id}/confirm",
- "auth": "session",
- "flags": [
- "service_connections"
- ]
- },
{
"route": "POST /gateway/template-runs/{root_room_id}/continue",
"auth": "session",
@@ -1290,6 +1338,13 @@
"auth": "session",
"flags": []
},
+ {
+ "route": "PUT /gateway/connector-apps/{service}",
+ "auth": "session",
+ "flags": [
+ "service_connections"
+ ]
+ },
{
"route": "PUT /gateway/management/agents/{agent_id}",
"auth": "session",
@@ -1340,6 +1395,13 @@
"route": "PUT /gateway/trust-settings",
"auth": "session",
"flags": []
+ },
+ {
+ "route": "PUT /gateway/workspace/services/{service}",
+ "auth": "session",
+ "flags": [
+ "service_connections"
+ ]
}
]
}
diff --git a/scripts/e2e_surface.py b/scripts/e2e_surface.py
index 3aa6fccdb..927f8cb64 100644
--- a/scripts/e2e_surface.py
+++ b/scripts/e2e_surface.py
@@ -140,6 +140,9 @@ def _config(flags: frozenset[str]) -> SwitchConfig:
def gateway_app(config: SwitchConfig) -> FastAPI:
app = create_gateway_app(
**{name: MagicMock() for name in _COLLABORATORS},
+ # No GitHub App configured, as on a server that has none: the app
+ # mounts the same routes either way.
+ connector_apps=MagicMock(**{"github_app.return_value": None}),
install_service=None,
invite_mailer=None,
config=config,