@agentconnect.md/setup 1.36.0 → 1.37.0-rc.3

package/README.md

@@ -1,17 +1,17 @@
 # `@agentconnect.md/setup`
 
-Browser-based Tenant Admin for AgentConnect self-hosting. It configures Logto,
-GitHub, Slack, Google, Feishu, and Lark through one authenticated local admin
+Browser-based Setup Server for AgentConnect self-hosting. It configures Logto,
+GitHub, Slack, Google, Feishu, and Lark through one authenticated local operator
 surface. Provider identities and write-only credentials are stored in the
 deployment database; the UI never returns stored secret values.
 
 This package has no command-line setup interface. Provider creation, match
 checks, edits, secret replacement, and clearing a provider configuration all
-happen in Tenant Admin.
+happen in Setup.
 
 ## Run with Docker Compose
 
-The local authentication stack includes Tenant Admin:
+The local authentication stack includes Setup Server:
 
 ```bash
 docker compose -f compose.yaml -f compose.logto.yaml up -d
@@ -19,15 +19,19 @@ docker compose -f compose.yaml -f compose.logto.yaml up -d
 
 Open:
 
-- Tenant Admin: `http://localhost:8091`
-- Logto Console: `http://admin.agentconnect.localhost:3002`
-- AgentConnect: `http://app.agentconnect.localhost:3000`
+- Setup: `http://localhost:8091`
+- Logto Console: `http://localhost:3002`
+- AgentConnect: `http://localhost:3000`
 
-Tenant Admin first guides the operator through Logto Management API setup. It
+Setup first guides the operator through Logto Management API setup. It
 does not display deployment configuration until an administrator has signed
 in. The first signed-in user is assigned the shared `ADMIN` role; sign in once
 more so the refreshed token contains that role.
 
+Google is the shortest local sign-in path because its Web OAuth client accepts
+the bundled bare `localhost` origins. Slack remains disabled until every
+required public origin uses HTTPS.
+
 ## Run from source
 
 Start the database and optional Logto services, then run the server directly:
@@ -44,14 +48,14 @@ are needed before the deployment database can be opened.
 The public service origins are also startup environment:
 
 ```dotenv
-AGENTCONNECT_PUBLIC_WEB_URL=http://app.agentconnect.localhost:3000
-AGENTCONNECT_PUBLIC_CP_URL=http://api.agentconnect.localhost:8080
-AGENTCONNECT_PUBLIC_RELAY_URL=http://relay.agentconnect.localhost:8090
+AGENTCONNECT_PUBLIC_WEB_URL=http://localhost:3000
+AGENTCONNECT_PUBLIC_CP_URL=http://localhost:8080
+AGENTCONNECT_PUBLIC_RELAY_URL=http://localhost:8090
 ```
 
-Tenant Admin shows these values at the top because GitHub and Slack manifests
-derive their callbacks from them. Change the environment and restart Tenant
-Admin before applying updated provider settings.
+Setup shows these values at the top because GitHub and Slack manifests
+derive their callbacks from them. Change the environment and restart Setup
+Server before applying updated provider settings.
 
 ## Configuration ownership
 
@@ -66,5 +70,5 @@ Restart the consuming services after editing:
 docker compose restart control-plane relay web
 ```
 
-Tenant Admin is bound to loopback in the supplied Compose stack. For a remote
+Setup Server is bound to loopback in the supplied Compose stack. For a remote
 host, forward the port over SSH instead of exposing this HTTP service publicly.