[rockfordlhotka]

Summary

People arriving at Scheduler had no way to learn that their agent can do the work for them. This adds a page that explains it, and links to it from where people land.

• New static page /agents, "Use Scheduler with your agent":
  • what an agent can do when you're invited and when you organize
  • your agent needs your calendar: Scheduler never reads one, so the checking happens in your agent. Connect every calendar that decides when you're free. Links to Adjutant for agents that have no calendar access, or calendars spread across several accounts.
  • connect: this server's MCP URL (taken from the request, like McpResource), then OAuth for agents that can open a browser (Claude custom connector, claude mcp add, VS Code mcp.json) or a personal access token from /account for headless agents such as RockBot
  • example requests, the two built-in prompts, and pointers to asking to organize and adding other addresses
• Links to it: a button on the home page, "Use with your agent" in the header, a one-line hint under the voting form (where people arrive from invitation emails), and the token section of /account.
• Emails: invitations, new-times emails and reminders follow the "ask your assistant" line with "How to connect your assistant" linking /agents, in plain text and HTML. The approval of a request to organize links it too. PlainTextEmailComposer now takes the public base URL and derives the MCP URL and the agents page URL from it.
• design.md (Web UI table, Email section) and the README mention the page.

Test plan

• AgentsPageTests: the home page links to /agents; the page returns 200 with this server's /mcp URL, the calendar, OAuth and token sections, the Adjutant link and the /account link
• Email tests: the plain-text invitation and approval carry the /agents URL; the HTML reminder and approval link it
• Full suite: Core 125, Data 177, Web 95, all passed
• Rendered the page at 1100 px and 390 px: no horizontal page scroll on a phone (the mcp.json block scrolls on its own)

🤖 Generated with Claude Code

[Copilot]

🟢 Approval recommended

No active review issues block approval of the agent setup guide and its page and email links.

No open issues 🎉

What changed in this PR

Adds a discoverable guide to using Scheduler through an AI agent, explaining calendar access and authentication while connecting the guide to existing pages and email flows.

Changes:

• Adds /agents with calendar requirements, OAuth and token setup, client examples, and suggested requests.
• Links the guide from navigation, home, voting, account, and relevant plain-text and HTML emails.
• Updates email URL construction, tests, and documentation.

File	Description
tests/​Scheduler.Web.Tests/​OrganizerRequestPageTests.cs	Checks the guide link in approval emails.
tests/​Scheduler.Web.Tests/​OrganizerPageTests.cs	Checks the guide link in reminder emails.
tests/​Scheduler.Web.Tests/​AgentsPageTests.cs	Covers page content, MCP URL, and home-page link.
tests/​Scheduler.Data.Tests/​Harness.cs	Passes the base URL to email composers.
tests/​Scheduler.Core.Tests/​EmailComposerTests.cs	Tests plain-text guide links and updates constructor calls.
src/​Scheduler.Web/​wwwroot/​app.css	Styles guide examples with horizontal code-block scrolling.
src/​Scheduler.Web/​SchedulerSetup.cs	Supplies the public base URL to the composer.
src/​Scheduler.Web/​Email/​Templates/​LinkEmail.razor	Supports an optional closing link.
src/​Scheduler.Web/​Email/​Templates/​EventEmail.razor	Renders the assistant setup link.
src/​Scheduler.Web/​Email/​HtmlEmailComposer.cs	Supplies guide links to relevant HTML emails.
src/​Scheduler.Web/​Components/​Pages/​Vote.razor	Adds an agent-guide hint beneath the forms.
src/​Scheduler.Web/​Components/​Pages/​Home.razor	Introduces agent assistance and links the guide.
src/​Scheduler.Web/​Components/​Pages/​Agents.razor	Implements the static agent setup guide.
src/​Scheduler.Web/​Components/​Pages/​Account.razor	Links token guidance to the guide.
src/​Scheduler.Web/​Components/​Layout/​MainLayout.razor	Adds the guide to header navigation.
src/​Scheduler.Core/​Email/​PlainTextEmailComposer.cs	Derives endpoint URLs and adds plain-text guide links.
README.md	Points deployed-server users to /agents.
docs/​design.md	Documents the page and email links.

_{Review effort: Balanced}