Skip to content

AI-powered virtual executive team — a single coherent executive persona backed by 8 specialist agents (FastAPI + Next.js).

feat(ui): put Act as me, Handle it for me and Take the lead under Delegate (#417)

Rufusfaf20f2532ca
diff --git a/docs/deployment.md b/docs/deployment.md
index 2fc5df88..0395905b 100644
--- a/docs/deployment.md
+++ b/docs/deployment.md
@@ -273,10 +273,10 @@ MS365_MCP_CLIENT_ID=<app id> uv run python scripts/connect-own-outlook.py --emai
No restart is needed. The address must be the owner's email on the People
page, and it must not be the Executive's own `EXEC_EMAIL_ADDRESS`. Then turn
-it on in Settings → Act as me; the setup status page shows the connection.
+it on in Delegate → Act as me; the setup status page shows the connection.
**Team members (optional).** Set `DELEGATION_TEAM_MEMBERS=true` and the owner
-gets **Let team members use it** in Settings → Act as me. Once they turn it
+gets **Let team members use it** in Delegate → Act as me. Once they turn it
on, each team member connects their own Gmail or Outlook the same way (the script with
their own address, one file each in the same directory) and turns it on for
themselves. A team member's mail, drafts, reply cards and audit rows are
diff --git a/packages/core/openexecutive/api/routes/take_the_lead.py b/packages/core/openexecutive/api/routes/take_the_lead.py
index 6c1c16f8..7b7d1fc1 100644
--- a/packages/core/openexecutive/api/routes/take_the_lead.py
+++ b/packages/core/openexecutive/api/routes/take_the_lead.py
@@ -1,5 +1,5 @@
"""Take the lead (orchestrator.take_the_lead): the switches and rules on
-Settings → Your Executive. What it did shows in Recent activity
+Delegate → Take the lead. What it did shows in Recent activity
(``today._build_activity``), with each person's own As you rows.
GET /take-the-lead — the As the Executive switch, its Ask
diff --git a/packages/core/openexecutive/config.py b/packages/core/openexecutive/config.py
index 06ea0f5e..c953b9c3 100644
--- a/packages/core/openexecutive/config.py
+++ b/packages/core/openexecutive/config.py
@@ -1068,7 +1068,7 @@ class Settings(BaseSettings):
20, alias="DELEGATION_HANDLE_IT_MAX_SENDS_PER_DAY", ge=1, le=500
)
# Whether the owner may let team members use Act as me for themselves
- # (Settings → Act as me → "Let team members use it", off until they turn
+ # (Delegate → Act as me → "Let team members use it", off until they turn
# it on). Off: the owner alone, as before (delegation.settings).
delegation_team_members: bool = Field(False, alias="DELEGATION_TEAM_MEMBERS")
diff --git a/packages/core/openexecutive/delegation/gmail.py b/packages/core/openexecutive/delegation/gmail.py
index e9e0acc3..de17bb27 100644
--- a/packages/core/openexecutive/delegation/gmail.py
+++ b/packages/core/openexecutive/delegation/gmail.py
@@ -95,7 +95,7 @@ STATUS_MESSAGES: dict[str, str] = {
"connected": "Connected.",
"not_configured": (
"Your mailbox isn't connected. Run scripts/connect-own-gmail.py (Gmail) or "
- "scripts/connect-own-outlook.py (Outlook) as yourself (Settings → Act as me "
+ "scripts/connect-own-outlook.py (Outlook) as yourself (Delegate → Act as me "
"shows how)."
),
"needs_reconnect": (
diff --git a/packages/core/openexecutive/guide/prebuilt/settings.json b/packages/core/openexecutive/guide/prebuilt/settings.json
index 158b7ad5..eb8a3cd8 100644
--- a/packages/core/openexecutive/guide/prebuilt/settings.json
+++ b/packages/core/openexecutive/guide/prebuilt/settings.json
@@ -1,7 +1,7 @@
{
"section_id": "settings",
"title": "Settings & Advanced",
- "markdown": "**What it is:** The settings that live outside the day-to-day nav: whether the Executive is running and how it sounds, who Open Executive is for, letting it write email as you, and the admin and power-user tools.\n\n**What it does:**\n\n- Opens on a page of tiles, one per settings page — **Your Executive**, **Act as me** (the owner, and team members once the owner lets them), **Workspace**, **Advanced** and **About**. Each tile says what's on its page and, where it can, how things stand now (running or paused, the voice, just you or your team, a newer version). Click a tile to open its page; the **Settings** link at the top of each page takes you back. Old links to a section (such as `/settings#workspace`) land on the matching page.\n- **Your Executive** shows whether the Executive is **running** or **paused**, with one button: **Pause…** opens the pause form; while it is paused, who paused it, the held count and **Resume** stay in view. Below it, **Voice** picks the voice the Executive answers you in.\n- **Workspace** holds, one card each: whether Open Executive is personal or for your team, your role when it's just you, your time zone, and whether the Executive books meetings without asking. **Company email domains** sits under **Advanced** at the bottom.\n- **Act as me** lets you have the Executive write email drafts as you, in your own voice, from your own Gmail — when you ask, and, if you turn it on, for mail in your inbox that needs you, which you can send from Home with one tap. Your mailbox and the two switches are up front; **How I write** (and, for the owner, **Let team members use it**) sit under **Advanced** at the bottom.\n- **Advanced** lists the pages that open their own screen, grouped by what you'd use them for: **Check & diagnose** (Setup status, Audit log, Token usage), **Configure** (Agent Council, Company Simulator, Client Companies) and **Learn** (User Guide, Architecture).\n- **About** shows the version this install runs, and whether a newer one is out.\n\n**How to use:**\n\n1. Click **Settings** at the bottom of the sidebar. (On a phone, open the menu with the button at the top left; Settings is at its bottom.)\n2. Click a tile to open that page.\n3. On **Advanced**, click a row to open that page:\n - **Setup status** — check that every part of your setup is working, and see what to do about anything that isn't.\n - **Agent Council** — change a specialist's model or prompt, or the Executive's voice.\n - **Audit log** — find out what the Executive did, and why.\n - **Token usage** — see what you're spending and where.\n - **User Guide** — this guide.\n - **Architecture** — the technical reference for how the system is built.\n - **Company Simulator** — try the Executive on a test company.\n - **Client Companies** — switch between clients if you do fractional work.\n\n**Checking your setup:**\n\n- Open **Settings → Advanced → Setup status**. Each part of your setup gets a light: green is working, amber needs attention, red isn't working, grey isn't set up (and is optional).\n- It tests things for real: the AI key, and each chat app's token, with a quick call that sends nothing. It also checks the Executive's email address, the company setup, the daily schedule, when and where your daily brief goes, and whether anyone on your team list can reach each chat app.\n- Anything that isn't green says what to do in plain words, with a button when the fix is on another page. After you change a setting and restart the app, click **Check again**.\n\n**Workspace:**\n\n- **Using Open Executive** — **Personal** or **Team**. You pick this when you first set up; change it here. Switching asks you to confirm and says what changes:\n - **Personal** pauses department check-ins and renames **Company** in the sidebar to **You**, with **Goals** (grouped by area), **People** and your profile — there is no Departments tab. Nothing is deleted — your departments stay, as the areas your goals are grouped by.\n - **Team** brings back **Company** with its **Departments** tab and their daily check-ins, and the People and Departments tiles on Home.\n- **Your role** (just you) — which describes you best (**Owner / founder**, **Executive inside an organisation**, **Independent or fractional**, or **Other**), your title, who you report to, what you're responsible for and what you're measured on. Every field is optional; click **Save role** after editing. The Executive uses it to fit its advice to your job — a VP gets help making the case to their boss, an owner gets help with a call that's theirs alone to make. It stays saved if you switch to your team.\n- **Time zone** — when your morning brief, end-of-day digest and reflection arrive, and how the Executive reads \"tomorrow at 9\". It suggests the zone your browser is in; **Follow server default** uses the server's setting.\n- **Book meetings without asking** — when on, the Executive books meetings on your calendar on its own; when off, each booking waits for your approval on Home. (Shown only when your install supports it.)\n- **Company email domains** (under **Advanced**, principal only) — mail from these domains matches a teammate by the part before the @, and a new address there is filled in as a teammate when someone writes in. It follows your own address unless you set it here.\n- Only the principal can change the mode, role and time zone. A persona you customised in Council stays in place in either mode.\n\n**Act as me:**\n\n- Normally the Executive writes only as itself, from its own email account. **Act as me** lets it write an email *as you*: ask in chat — \"reply to Dana as me: yes to the 5th\" — and it saves a draft in **your own Gmail Drafts** for you to read, change and send. Asking in chat never sends anything, and everything else it writes stays in its own name.\n- The owner sees this page, and so does each team member once the owner turns on **Let team members use it** under **Advanced** at the bottom of it (shown only where your install allows it). Each team member connects their own Gmail and turns it on for themselves. What it reads in their mail, the drafts it writes and their **Replies waiting** are theirs alone: the owner sees only who uses it and how many drafts and sends it made, and a conversation in which it read someone's mail can be opened only by that person. Turning the owner's switch off takes it away from the team from their next message. It works when you ask in the web app, in a direct message to the Executive on Slack or Discord, or in a verified private Telegram chat — never in a shared channel or thread, from an email, a scheduled job or anyone else's conversation.\n- **Your Gmail** — connect your own Gmail first. The page shows the command to run on a computer with a browser; sign in as yourself, put the file it writes where your install reads it, then click **Check again**. It won't connect the Executive's own address as yours.\n- **Write drafts as me** — the switch. It stays off until your Gmail is connected, and turning it off applies from your next message.\n- **Draft replies to my inbox** — a second switch, once **Write drafts as me** is on. Every few minutes the Executive looks at new mail in your inbox, and for mail that needs a personal reply from you — a question, a request, a meeting to arrange, an introduction or a follow-up — it writes a first reply in your Gmail Drafts and puts it at the top of **Needs you** on Home. Nothing is sent until you tap **Send** there. It only looks at mail that arrives after you turn it on, and leaves out newsletters, notifications, mailing lists, mail you've already answered and anything that doesn't need you; mail you answer within ten minutes never gets a draft. The first reply only acknowledges: it repeats only what you've already said in the thread, commits you to nothing and lists what's left for you to decide. Someone you've never written to gets a short holding reply. The line under the switch says how it's doing (for example, that your Gmail needs connecting again) and when it last looked; click **Check now** to look straight away. Turning **Write drafts as me** off turns this off too.\n- **How I write** (under **Advanced**) — click **Learn from my sent mail** and it reads your recent sent emails once and describes how you write (click **Edit how I write** to open the fields): your usual **Length** and **Tone**, a **Greeting** for your team, your contacts and anyone else ({first} stands for their first name), your **Sign-off**, your **Habits**, what you **Never** do, and a few **Examples of your writing** that set the tone. Change any of them and click **Save changes**; **Lock** stops it being relearned from your mail (you can still edit it); **Reset** starts over; **Remove examples** drops the examples. Your Gmail signature is added to every draft: **Refresh from Gmail** picks up a change you made to it in Gmail, **Don't add my signature** stops adding it, and **Add my Gmail signature** brings it back.\n- In chat you get a card, \"Drafted an email as you to …\", that opens the draft in Gmail. If the Executive isn't sure about something, it asks you instead of guessing.\n\n**Setting up just for yourself:**\n\n- The first time you set up, Open Executive asks who it is for — **Personal** or **Team** — before anything else, and saves your time zone from the browser. Re-running setup later skips this; change the mode here instead. Either way you can add teammates later from **People**.\n- **Personal** is for anyone who uses Open Executive just for themselves, whatever their role: your own business, a team you lead inside an organisation, or clients you advise as an independent or fractional executive.\n- Choosing **Personal** then asks **What's your role?** — the same fields as **Your role** above. Fill in what you like, or click **Skip for now**.\n- Just for yourself, the setup conversation asks about your work rather than your team, following the role you gave: an owner about what you offer, your customers, pricing, cash and runway; an executive inside an organisation about that organisation (it becomes your company profile), what you're responsible for, who you report to and what you're measured on; an independent about your practice and clients. Everyone is asked about their goals. On **Here's what I understood** there is a single **You** card (your name and role) next to **Your sign-in email**, instead of the team and department lists.\n- The step-by-step form skips the team size, team members and fractional executives steps.\n- In the sidebar, **You** takes the place of **Company** and holds **Goals**, **People** and your profile: **Business profile** if you own the business, **Your work** for any other role (or none). The profile page follows the same choice: for any other role it is worded around the organisation you work in (**Where You Work** in place of Company Basics). Either way departments are listed there as **Areas**, and your title, who you report to and what you're responsible for stay under **Your role** above.\n\n**Pausing the Executive:**\n\n- Open **Settings → Your Executive** (or **Pause or resume the Executive** in the account menu — the **⋯** next to your name at the bottom of the sidebar) and click **Pause…**. Add a reason if you like, and click **Pause Executive**.\n- While paused, the Executive starts nothing on its own: no briefs, nudges, monitoring, inbox processing or workflow timers. An amber banner appears on every page.\n- Chat and direct messages (Slack, Telegram, Discord, Google Chat) still get answers.\n- Nothing is lost. Work that falls due during the pause waits, and runs when you click **Resume**. The switch shows how many actions are waiting.\n- Anyone who can sign in can pause the Executive, but only the principal can resume it.\n\n*Tip: if you're looking for a feature that isn't in the sidebar, it's probably under **Settings → Advanced**. This guide is also in the account menu (the **⋯** next to your name at the bottom of the sidebar), with **Pause or resume the Executive** and, when you signed in with an account, **Sign out**.*",
+ "markdown": "**What it is:** The settings that live outside the day-to-day nav: whether the Executive is running and how it sounds, who Open Executive is for, letting it write email as you, and the admin and power-user tools.\n\n**What it does:**\n\n- Opens on a page of tiles, one per settings page — **Your Executive**, **Workspace**, **Advanced** and **About**. Each tile says what's on its page and, where it can, how things stand now (running or paused, the voice, just you or your team, a newer version). Click a tile to open its page; the **Settings** link at the top of each page takes you back. Old links to a section (such as `/settings#workspace`) land on the matching page. **Act as me**, **Handle it for me** and **Take the lead** are not in Settings: they are the three tabs of **Delegate** in the main menu.\n- **Your Executive** shows whether the Executive is **running** or **paused**, with one button: **Pause…** opens the pause form; while it is paused, who paused it, the held count and **Resume** stay in view. Below it, **Voice** picks the voice the Executive answers you in.\n- **Workspace** holds, one card each: whether Open Executive is personal or for your team, your role when it's just you, your time zone, and whether the Executive books meetings without asking. **Company email domains** sits under **Advanced** at the bottom.\n- **Act as me** (a tab of **Delegate** in the main menu) lets you have the Executive write email drafts as you, in your own voice, from your own Gmail — when you ask, and, if you turn it on, for mail in your inbox that needs you, which you can send from Home with one tap. Your mailbox and the two switches are up front; **How I write** (and, for the owner, **Let team members use it**) sit under **Advanced** at the bottom.\n- **Advanced** lists the pages that open their own screen, grouped by what you'd use them for: **Check & diagnose** (Setup status, Audit log, Token usage), **Configure** (Agent Council, Company Simulator, Client Companies) and **Learn** (User Guide, Architecture).\n- **About** shows the version this install runs, and whether a newer one is out.\n\n**How to use:**\n\n1. Click **Settings** at the bottom of the sidebar. (On a phone, open the menu with the button at the top left; Settings is at its bottom.)\n2. Click a tile to open that page.\n3. On **Advanced**, click a row to open that page:\n - **Setup status** — check that every part of your setup is working, and see what to do about anything that isn't.\n - **Agent Council** — change a specialist's model or prompt, or the Executive's voice.\n - **Audit log** — find out what the Executive did, and why.\n - **Token usage** — see what you're spending and where.\n - **User Guide** — this guide.\n - **Architecture** — the technical reference for how the system is built.\n - **Company Simulator** — try the Executive on a test company.\n - **Client Companies** — switch between clients if you do fractional work.\n\n**Checking your setup:**\n\n- Open **Settings → Advanced → Setup status**. Each part of your setup gets a light: green is working, amber needs attention, red isn't working, grey isn't set up (and is optional).\n- It tests things for real: the AI key, and each chat app's token, with a quick call that sends nothing. It also checks the Executive's email address, the company setup, the daily schedule, when and where your daily brief goes, and whether anyone on your team list can reach each chat app.\n- Anything that isn't green says what to do in plain words, with a button when the fix is on another page. After you change a setting and restart the app, click **Check again**.\n\n**Workspace:**\n\n- **Using Open Executive** — **Personal** or **Team**. You pick this when you first set up; change it here. Switching asks you to confirm and says what changes:\n - **Personal** pauses department check-ins and renames **Company** in the sidebar to **You**, with **Goals** (grouped by area), **People** and your profile — there is no Departments tab. Nothing is deleted — your departments stay, as the areas your goals are grouped by.\n - **Team** brings back **Company** with its **Departments** tab and their daily check-ins, and the People and Departments tiles on Home.\n- **Your role** (just you) — which describes you best (**Owner / founder**, **Executive inside an organisation**, **Independent or fractional**, or **Other**), your title, who you report to, what you're responsible for and what you're measured on. Every field is optional; click **Save role** after editing. The Executive uses it to fit its advice to your job — a VP gets help making the case to their boss, an owner gets help with a call that's theirs alone to make. It stays saved if you switch to your team.\n- **Time zone** — when your morning brief, end-of-day digest and reflection arrive, and how the Executive reads \"tomorrow at 9\". It suggests the zone your browser is in; **Follow server default** uses the server's setting.\n- **Book meetings without asking** — when on, the Executive books meetings on your calendar on its own; when off, each booking waits for your approval on Home. (Shown only when your install supports it.)\n- **Company email domains** (under **Advanced**, principal only) — mail from these domains matches a teammate by the part before the @, and a new address there is filled in as a teammate when someone writes in. It follows your own address unless you set it here.\n- Only the principal can change the mode, role and time zone. A persona you customised in Council stays in place in either mode.\n\n**Act as me (Delegate → Act as me):**\n\n- Normally the Executive writes only as itself, from its own email account. **Act as me** lets it write an email *as you*: ask in chat — \"reply to Dana as me: yes to the 5th\" — and it saves a draft in **your own Gmail Drafts** for you to read, change and send. Asking in chat never sends anything, and everything else it writes stays in its own name.\n- The owner sees this page, and so does each team member once the owner turns on **Let team members use it** under **Advanced** at the bottom of it (shown only where your install allows it). Each team member connects their own Gmail and turns it on for themselves. What it reads in their mail, the drafts it writes and their **Replies waiting** are theirs alone: the owner sees only who uses it and how many drafts and sends it made, and a conversation in which it read someone's mail can be opened only by that person. Turning the owner's switch off takes it away from the team from their next message. It works when you ask in the web app, in a direct message to the Executive on Slack or Discord, or in a verified private Telegram chat — never in a shared channel or thread, from an email, a scheduled job or anyone else's conversation.\n- **Your Gmail** — connect your own Gmail first. The page shows the command to run on a computer with a browser; sign in as yourself, put the file it writes where your install reads it, then click **Check again**. It won't connect the Executive's own address as yours.\n- **Write drafts as me** — the switch. It stays off until your Gmail is connected, and turning it off applies from your next message.\n- **Draft replies to my inbox** — a second switch, once **Write drafts as me** is on. Every few minutes the Executive looks at new mail in your inbox, and for mail that needs a personal reply from you — a question, a request, a meeting to arrange, an introduction or a follow-up — it writes a first reply in your Gmail Drafts and puts it at the top of **Needs you** on Home. Nothing is sent until you tap **Send** there. It only looks at mail that arrives after you turn it on, and leaves out newsletters, notifications, mailing lists, mail you've already answered and anything that doesn't need you; mail you answer within ten minutes never gets a draft. The first reply only acknowledges: it repeats only what you've already said in the thread, commits you to nothing and lists what's left for you to decide. Someone you've never written to gets a short holding reply. The line under the switch says how it's doing (for example, that your Gmail needs connecting again) and when it last looked; click **Check now** to look straight away. Turning **Write drafts as me** off turns this off too.\n- **How I write** (under **Advanced**) — click **Learn from my sent mail** and it reads your recent sent emails once and describes how you write (click **Edit how I write** to open the fields): your usual **Length** and **Tone**, a **Greeting** for your team, your contacts and anyone else ({first} stands for their first name), your **Sign-off**, your **Habits**, what you **Never** do, and a few **Examples of your writing** that set the tone. Change any of them and click **Save changes**; **Lock** stops it being relearned from your mail (you can still edit it); **Reset** starts over; **Remove examples** drops the examples. Your Gmail signature is added to every draft: **Refresh from Gmail** picks up a change you made to it in Gmail, **Don't add my signature** stops adding it, and **Add my Gmail signature** brings it back.\n- In chat you get a card, \"Drafted an email as you to …\", that opens the draft in Gmail. If the Executive isn't sure about something, it asks you instead of guessing.\n\n**Setting up just for yourself:**\n\n- The first time you set up, Open Executive asks who it is for — **Personal** or **Team** — before anything else, and saves your time zone from the browser. Re-running setup later skips this; change the mode here instead. Either way you can add teammates later from **People**.\n- **Personal** is for anyone who uses Open Executive just for themselves, whatever their role: your own business, a team you lead inside an organisation, or clients you advise as an independent or fractional executive.\n- Choosing **Personal** then asks **What's your role?** — the same fields as **Your role** above. Fill in what you like, or click **Skip for now**.\n- Just for yourself, the setup conversation asks about your work rather than your team, following the role you gave: an owner about what you offer, your customers, pricing, cash and runway; an executive inside an organisation about that organisation (it becomes your company profile), what you're responsible for, who you report to and what you're measured on; an independent about your practice and clients. Everyone is asked about their goals. On **Here's what I understood** there is a single **You** card (your name and role) next to **Your sign-in email**, instead of the team and department lists.\n- The step-by-step form skips the team size, team members and fractional executives steps.\n- In the sidebar, **You** takes the place of **Company** and holds **Goals**, **People** and your profile: **Business profile** if you own the business, **Your work** for any other role (or none). The profile page follows the same choice: for any other role it is worded around the organisation you work in (**Where You Work** in place of Company Basics). Either way departments are listed there as **Areas**, and your title, who you report to and what you're responsible for stay under **Your role** above.\n\n**Pausing the Executive:**\n\n- Open **Settings → Your Executive** (or **Pause or resume the Executive** in the account menu — the **⋯** next to your name at the bottom of the sidebar) and click **Pause…**. Add a reason if you like, and click **Pause Executive**.\n- While paused, the Executive starts nothing on its own: no briefs, nudges, monitoring, inbox processing or workflow timers. An amber banner appears on every page.\n- Chat and direct messages (Slack, Telegram, Discord, Google Chat) still get answers.\n- Nothing is lost. Work that falls due during the pause waits, and runs when you click **Resume**. The switch shows how many actions are waiting.\n- Anyone who can sign in can pause the Executive, but only the principal can resume it.\n\n*Tip: if you're looking for a feature that isn't in the sidebar, it's probably under **Settings → Advanced**. This guide is also in the account menu (the **⋯** next to your name at the bottom of the sidebar), with **Pause or resume the Executive** and, when you signed in with an account, **Sign out**.*",
"mermaid": null,
"generated_at": "2026-10-03T12:00:00Z"
}
diff --git a/packages/core/openexecutive/guide/prebuilt/today.json b/packages/core/openexecutive/guide/prebuilt/today.json
index f467aa42..85bf30f0 100644
--- a/packages/core/openexecutive/guide/prebuilt/today.json
+++ b/packages/core/openexecutive/guide/prebuilt/today.json
@@ -1,7 +1,7 @@
{
"section_id": "today",
"title": "Today / Morning Brief",
- "markdown": "**What it is:** A single screen of *what needs you right now* — the proactive digest the Executive prepares so you're not the one chasing status. In the app it's **Home**, the screen the app opens on.\n\n**What it does:**\n\n- Opens with a greeting, one line summing up the day (click a part of it — *2 awaiting reply*, *1 department at risk* — to open that list), and an **Ask your Executive anything…** box that starts a chat.\n- Puts what's waiting on your call up front under **Needs you**: the first card large, the next two below it, and **Show N more** for the rest.\n- Gathers everything else under **Everything else** as a row of count tiles — **Departments**, **People**, **Across the team** (waiting on someone else), **In flight**, **Handled overnight**, **Monitoring** — shown only when they have something in them. Click a tile to open its full list in a side panel.\n- The **Departments** tile shows each department's goal health — on-track, at-risk, or off-track — with the at-risk goals called out.\n- The **People** tile lists people with open items, their reply counts, SLA status, and whether they're on leave.\n- **Read today's brief** (next to **Needs you**) opens the written brief — what's going on across the company — in a side panel.\n- If your latest morning brief, end-of-day digest or weekly review couldn't be sent to you, a line at the top says why and what to connect. It goes away once that's fixed.\n- With **Settings → Act as me → Draft replies to my inbox** on, the replies the Executive wrote in your Gmail Drafts for mail that needs you come first in **Needs you**. Only you see them.\n- Surfaces proposals and alerts you can click to open a chat thread with full context.\n\n**How to use:**\n\n1. Click **Home** in the sidebar (or the Open Executive logo). On a phone, **Home** is the first button in the bar at the bottom.\n2. Work **Needs you** from the top. Each card has one main button and **Discuss**; everything else is in the card's **⋯** menu:\n - **Approve** — accept the recommendation; a chat opens so the Executive can carry it out. Usually the main button.\n - **Discuss** — open a chat with the context already filled in.\n - **Edit & approve** (in **⋯**) — reword the action first, then **Send approval**; your text is used exactly as written.\n - **Dismiss** (in **⋯**) — drop it and stay on Home. When the Executive thinks a card is stale, **Dismiss** is the main button instead.\n - **Nudge *name*** — the main button when the best move is chasing someone for a reply; **Run *workflow*** when the best move is a workflow.\n - **Open *name*'s page** (in **⋯**) — the person the item is waiting on.\n3. Some cards are simpler: a document card's main button is **Open document** (**Mark reviewed** is in its **⋯**), and a calendar-booking card books (or declines) the meeting directly when you click Approve or Dismiss. Only the person a booking was sent to for approval, or the owner, can approve or decline it.\n4. Keep it tidy from the **⋯** next to **Needs you**: **Dismiss N older than 7 days** clears stale items, and **Re-check relevance** asks the Executive to review every open item now.\n5. Open the **Departments** tile and click a department to ask for its status in chat.\n6. Work the replies waiting to be sent (they come first in **Needs you**): each card shows who wrote (and whether Gmail could confirm their address), what they wrote, your draft, and **Decide before sending** — what the draft leaves for you to answer. **Send** asks you once, naming who the reply goes to, then sends the draft from your Gmail exactly as it is there. If you changed who it goes to in Gmail, or they wrote again since, it asks a second time and says what changed. To change the wording, choose **Edit in Gmail** in the card's **⋯**, edit the draft there, then Send here or from Gmail. **Dismiss** (also in **⋯**) deletes the draft, unless you've already edited it in Gmail. On a server, Send needs signed sign-ins; until they're set up, send from Gmail. A card goes away on its own once you send or delete the draft in Gmail, or reply yourself, and after a week.\n\n**Example:** in a Discuss thread, just say *\"go ahead\"* to approve the proposal or *\"drop it\"* to dismiss it — no need to go back to the card. (Calendar bookings still need the Approve button.)\n\n**Just for yourself?** If you use Open Executive just for yourself (**Settings → Workspace → Personal**), Home leaves out the team parts: there are no Departments, People or Across the team tiles — everything that needs a decision is in **Needs you**. When a goal is slipping, the summary line at the top says how many goals are at risk; click it to open **Goals**. Instead, the tiles are **Due soon**, **Your projects** and **This week's review**, each opening its list in a side panel. **Your projects** lists the projects the Executive is tracking for you. Click **Done** when one is finished, or **Drop** to stop tracking it (it asks first, and removes the project from Pulse). **Due soon** lists what you've promised by a date and what others have asked of you, due in the next week — say *\"I'll send Northwind the proposal by Friday\"* in the web chat or your own Slack or Discord and it shows up here, and the Executive reminds you when it's due. Click **Done** once it's handled; **All open items** opens the full list. **Top three today**, right under **Needs you**, shows the three things to focus on today — the same three your morning brief opens with — each with a free slot in today's working hours when the Executive can read your calendar. **This week's review** shows your latest weekly review: when it ran and next week's top three. Click **Read the review** to see all of it.\n\nYour morning brief also opens with a **top three for today**, picked from what's overdue or due, goals that are slipping and the projects you're driving. When Google Workspace is connected and the Executive can read your calendar (it is your own account, or you shared your calendar with it), each of the three gets a free slot in today's working hours and the brief lists today's meetings; otherwise the three come without times. Every Friday afternoon (in your time zone) a **weekly review** arrives the same way: your goals graded by area, what's due or overdue, projects that went quiet, the week's decisions, a few older decisions to look back on, and next week's top three. Both also show up on Home (see above), so you see them even when no chat app or email is connected. When it asks how an older decision turned out, just tell the Executive in the web chat or your own Slack or Discord and it records the outcome against that decision.\n\n*Note: proposals are routed to the right person automatically based on who has authority over them.*",
+ "markdown": "**What it is:** A single screen of *what needs you right now* — the proactive digest the Executive prepares so you're not the one chasing status. In the app it's **Home**, the screen the app opens on.\n\n**What it does:**\n\n- Opens with a greeting, one line summing up the day (click a part of it — *2 awaiting reply*, *1 department at risk* — to open that list), and an **Ask your Executive anything…** box that starts a chat.\n- Puts what's waiting on your call up front under **Needs you**: the first card large, the next two below it, and **Show N more** for the rest.\n- Gathers everything else under **Everything else** as a row of count tiles — **Departments**, **People**, **Across the team** (waiting on someone else), **In flight**, **Handled overnight**, **Monitoring** — shown only when they have something in them. Click a tile to open its full list in a side panel.\n- The **Departments** tile shows each department's goal health — on-track, at-risk, or off-track — with the at-risk goals called out.\n- The **People** tile lists people with open items, their reply counts, SLA status, and whether they're on leave.\n- **Read today's brief** (next to **Needs you**) opens the written brief — what's going on across the company — in a side panel.\n- If your latest morning brief, end-of-day digest or weekly review couldn't be sent to you, a line at the top says why and what to connect. It goes away once that's fixed.\n- With **Delegate → Act as me → Draft replies to my inbox** on, the replies the Executive wrote in your Gmail Drafts for mail that needs you come first in **Needs you**. Only you see them.\n- Surfaces proposals and alerts you can click to open a chat thread with full context.\n\n**How to use:**\n\n1. Click **Home** in the sidebar (or the Open Executive logo). On a phone, **Home** is the first button in the bar at the bottom.\n2. Work **Needs you** from the top. Each card has one main button and **Discuss**; everything else is in the card's **⋯** menu:\n - **Approve** — accept the recommendation; a chat opens so the Executive can carry it out. Usually the main button.\n - **Discuss** — open a chat with the context already filled in.\n - **Edit & approve** (in **⋯**) — reword the action first, then **Send approval**; your text is used exactly as written.\n - **Dismiss** (in **⋯**) — drop it and stay on Home. When the Executive thinks a card is stale, **Dismiss** is the main button instead.\n - **Nudge *name*** — the main button when the best move is chasing someone for a reply; **Run *workflow*** when the best move is a workflow.\n - **Open *name*'s page** (in **⋯**) — the person the item is waiting on.\n3. Some cards are simpler: a document card's main button is **Open document** (**Mark reviewed** is in its **⋯**), and a calendar-booking card books (or declines) the meeting directly when you click Approve or Dismiss. Only the person a booking was sent to for approval, or the owner, can approve or decline it.\n4. Keep it tidy from the **⋯** next to **Needs you**: **Dismiss N older than 7 days** clears stale items, and **Re-check relevance** asks the Executive to review every open item now.\n5. Open the **Departments** tile and click a department to ask for its status in chat.\n6. Work the replies waiting to be sent (they come first in **Needs you**): each card shows who wrote (and whether Gmail could confirm their address), what they wrote, your draft, and **Decide before sending** — what the draft leaves for you to answer. **Send** asks you once, naming who the reply goes to, then sends the draft from your Gmail exactly as it is there. If you changed who it goes to in Gmail, or they wrote again since, it asks a second time and says what changed. To change the wording, choose **Edit in Gmail** in the card's **⋯**, edit the draft there, then Send here or from Gmail. **Dismiss** (also in **⋯**) deletes the draft, unless you've already edited it in Gmail. On a server, Send needs signed sign-ins; until they're set up, send from Gmail. A card goes away on its own once you send or delete the draft in Gmail, or reply yourself, and after a week.\n\n**Example:** in a Discuss thread, just say *\"go ahead\"* to approve the proposal or *\"drop it\"* to dismiss it — no need to go back to the card. (Calendar bookings still need the Approve button.)\n\n**Just for yourself?** If you use Open Executive just for yourself (**Settings → Workspace → Personal**), Home leaves out the team parts: there are no Departments, People or Across the team tiles — everything that needs a decision is in **Needs you**. When a goal is slipping, the summary line at the top says how many goals are at risk; click it to open **Goals**. Instead, the tiles are **Due soon**, **Your projects** and **This week's review**, each opening its list in a side panel. **Your projects** lists the projects the Executive is tracking for you. Click **Done** when one is finished, or **Drop** to stop tracking it (it asks first, and removes the project from Pulse). **Due soon** lists what you've promised by a date and what others have asked of you, due in the next week — say *\"I'll send Northwind the proposal by Friday\"* in the web chat or your own Slack or Discord and it shows up here, and the Executive reminds you when it's due. Click **Done** once it's handled; **All open items** opens the full list. **Top three today**, right under **Needs you**, shows the three things to focus on today — the same three your morning brief opens with — each with a free slot in today's working hours when the Executive can read your calendar. **This week's review** shows your latest weekly review: when it ran and next week's top three. Click **Read the review** to see all of it.\n\nYour morning brief also opens with a **top three for today**, picked from what's overdue or due, goals that are slipping and the projects you're driving. When Google Workspace is connected and the Executive can read your calendar (it is your own account, or you shared your calendar with it), each of the three gets a free slot in today's working hours and the brief lists today's meetings; otherwise the three come without times. Every Friday afternoon (in your time zone) a **weekly review** arrives the same way: your goals graded by area, what's due or overdue, projects that went quiet, the week's decisions, a few older decisions to look back on, and next week's top three. Both also show up on Home (see above), so you see them even when no chat app or email is connected. When it asks how an older decision turned out, just tell the Executive in the web chat or your own Slack or Discord and it records the outcome against that decision.\n\n*Note: proposals are routed to the right person automatically based on who has authority over them.*",
"mermaid": null,
"generated_at": "2026-10-03T12:00:00Z"
}
diff --git a/packages/ui/scripts/navConfig.test.mjs b/packages/ui/scripts/navConfig.test.mjs
index 6f1e7903..51db2282 100644
--- a/packages/ui/scripts/navConfig.test.mjs
+++ b/packages/ui/scripts/navConfig.test.mjs
@@ -12,18 +12,20 @@ import {
hubForPath,
isDestinationActive,
profileWording,
+ settingsHrefForHash,
settingsPageForHash,
} from "../src/components/shell/navConfig.ts";
const links = (items) => items.map((i) => `${i.label} → ${i.href}`);
const ROLE_KINDS = ["owner", "in_house", "independent", "other", null, undefined];
-test("the main menu is six places, team is the default", () => {
+test("the main menu is seven places, team is the default", () => {
assert.deepEqual(links(buildDestinations()), [
"Home → /",
"Chats → /chats",
"Work → /jobs",
"Company → /people",
+ "Delegate → /delegate/act-as-me",
"Knowledge → /knowledge",
"Pulse → /memories",
]);
@@ -33,7 +35,8 @@ test("the main menu is six places, team is the default", () => {
test("solo swaps Company for You, which opens on Goals", () => {
const solo = links(buildDestinations({ mode: "solo", roleKind: "owner" }));
assert.equal(solo[3], "You → /goals");
- assert.equal(solo.length, 6);
+ assert.equal(solo[4], "Delegate → /delegate/act-as-me");
+ assert.equal(solo.length, 7);
});
test("team hubs: Work and Company tabs", () => {
@@ -53,6 +56,22 @@ test("team hubs: Work and Company tabs", () => {
);
});
+test("Delegate holds Act as me, Handle it for me and Take the lead, each a named feature", () => {
+ for (const opts of [{}, { mode: "solo", roleKind: "owner" }]) {
+ const delegate = buildHubs(opts).find((h) => h.key === "delegate");
+ assert.deepEqual(links(delegate.tabs), [
+ "Act as me → /delegate/act-as-me",
+ "Handle it for me → /delegate/handle-it",
+ "Take the lead → /delegate/take-the-lead",
+ ]);
+ assert.deepEqual(
+ delegate.tabs.map((t) => t.feature),
+ ["act_as_me", "handle_it", "take_the_lead"],
+ );
+ assert.equal(hubForPath("/delegate/handle-it", opts)?.key, "delegate");
+ }
+});
+
test("team hubs ignore the role", () => {
for (const roleKind of ROLE_KINDS) {
assert.deepEqual(buildHubs({ roleKind }), buildHubs());
@@ -182,7 +201,6 @@ test("the Settings hub: one tile per page, each with its own route", () => {
SETTINGS_PAGES.map((p) => `${p.label} → ${p.href}`),
[
"Your Executive → /settings/executive",
- "Act as me → /settings/act-as-me",
"About you → /settings/memory",
"Workspace → /settings/workspace",
"Advanced → /settings/advanced",
@@ -203,7 +221,11 @@ test("old /settings#anchors land on the matching page", () => {
assert.equal(to("#executive"), "/settings/executive");
assert.equal(to("#on-its-own"), "/settings/executive");
assert.equal(to("#workspace"), "/settings/workspace");
- assert.equal(to("act-as-me"), "/settings/act-as-me");
+ assert.equal(to("act-as-me"), null);
+ // Act as me moved out of Settings: its old anchor goes to its Delegate tab.
+ assert.equal(settingsHrefForHash("#act-as-me"), "/delegate/act-as-me");
+ assert.equal(settingsHrefForHash("#workspace"), "/settings/workspace");
+ assert.equal(settingsHrefForHash("#nope"), null);
assert.equal(to("#memory"), "/settings/memory");
assert.equal(to("#tools"), "/settings/advanced");
for (const g of ADVANCED_GROUPS) assert.equal(to(`#tools-${g.key}`), "/settings/advanced");
diff --git a/packages/ui/src/app/delegate/act-as-me/page.tsx b/packages/ui/src/app/delegate/act-as-me/page.tsx
new file mode 100644
index 00000000..dd1de8c6
--- /dev/null
+++ b/packages/ui/src/app/delegate/act-as-me/page.tsx
@@ -0,0 +1,25 @@
+"use client";
+
+import ActAsMeCard, { ACT_AS_ME_INTRO } from "@/components/settings/ActAsMeCard";
+import { useDelegation } from "@/components/settings/HandleItCard";
+import DelegatePage from "@/components/delegate/DelegatePage";
+import { LearnedCard, SuggestedActionsCard, TrainingNote } from "@/components/settings/TrainingCard";
+
+// Delegate → Act as me: drafts written as you, in your own mailbox, and how
+// you write. Like someone new, each job can be in training (Off / In training
+// / On on its own card, as on Take the lead), and what it learned there is
+// listed at the bottom. What it sends as you on its own is the next tab,
+// Handle it for me.
+export default function ActAsMePage() {
+ const load = useDelegation();
+ const training = load.state === "ready" ? load.settings?.training : null;
+ return (
+ <DelegatePage feature="act_as_me" description={ACT_AS_ME_INTRO}>
+ {training && <TrainingNote />}
+ <ActAsMeCard onSettings={load.setSettings}>
+ {training && <SuggestedActionsCard training={training} onSettings={load.setSettings} />}
+ {training && <LearnedCard training={training} onSettings={load.setSettings} />}
+ </ActAsMeCard>
+ </DelegatePage>
+ );
+}
diff --git a/packages/ui/src/app/delegate/handle-it/page.tsx b/packages/ui/src/app/delegate/handle-it/page.tsx
new file mode 100644
index 00000000..b022b3bc
--- /dev/null
+++ b/packages/ui/src/app/delegate/handle-it/page.tsx
@@ -0,0 +1,26 @@
+"use client";
+
+import DelegatePage from "@/components/delegate/DelegatePage";
+import HandleItCard, { useDelegation } from "@/components/settings/HandleItCard";
+import SettingsCard from "@/components/settings/SettingsCard";
+
+// Delegate → Handle it for me: the replies and follow-ups it sends as you on
+// its own, from your own mailbox. It builds on Act as me (its inbox drafts),
+// so someone who can't have Act as me is told so here.
+export default function HandleItPage() {
+ const load = useDelegation();
+ return (
+ <DelegatePage feature="handle_it" description="Replies and follow-ups it sends as you, from your own mailbox.">
+ {load.state === "hidden" ? (
+ <SettingsCard>
+ <p className="text-[15px] text-fg-muted leading-relaxed">
+ Handle it for me sends replies through Act as me, which isn&apos;t available to you here. The owner of this
+ Open Executive can turn it on for team members.
+ </p>
+ </SettingsCard>
+ ) : (
+ <HandleItCard load={load} />
+ )}
+ </DelegatePage>
+ );
+}
diff --git a/packages/ui/src/app/delegate/page.tsx b/packages/ui/src/app/delegate/page.tsx
new file mode 100644
index 00000000..ab08abe0
--- /dev/null
+++ b/packages/ui/src/app/delegate/page.tsx
@@ -0,0 +1,6 @@
+import { redirect } from "next/navigation";
+
+// Delegate opens on its first tab.
+export default function DelegatePage() {
+ redirect("/delegate/act-as-me");
+}
diff --git a/packages/ui/src/app/delegate/take-the-lead/page.tsx b/packages/ui/src/app/delegate/take-the-lead/page.tsx
new file mode 100644
index 00000000..ab416267
--- /dev/null
+++ b/packages/ui/src/app/delegate/take-the-lead/page.tsx
@@ -0,0 +1,20 @@
+"use client";
+
+import DelegatePage from "@/components/delegate/DelegatePage";
+import TakeTheLeadCard from "@/components/settings/TakeTheLeadCard";
+import { MeetingAutonomySwitch } from "@/components/settings/WorkspaceCard";
+
+// Delegate → Take the lead: what the Executive does in its own name without
+// waiting to be asked, and booking meetings without asking. Pause, on
+// Settings → Your Executive, stops all of it.
+export default function TakeTheLeadPage() {
+ return (
+ <DelegatePage
+ feature="take_the_lead"
+ description="What the Executive does in its own name, without waiting to be asked. People can see it's the Executive."
+ >
+ <TakeTheLeadCard />
+ <MeetingAutonomySwitch />
+ </DelegatePage>
+ );
+}
diff --git a/packages/ui/src/app/settings/act-as-me/page.tsx b/packages/ui/src/app/settings/act-as-me/page.tsx
index a28dd179..0fa5354f 100644
--- a/packages/ui/src/app/settings/act-as-me/page.tsx
+++ b/packages/ui/src/app/settings/act-as-me/page.tsx
@@ -1,26 +1,6 @@
-"use client";
+import { redirect } from "next/navigation";
-import ActAsMeCard, { ACT_AS_ME_INTRO } from "@/components/settings/ActAsMeCard";
-import HandleItCard, { useDelegation } from "@/components/settings/HandleItCard";
-import SettingsSubpage from "@/components/settings/SettingsSubpage";
-import { LearnedCard, SuggestedActionsCard, TrainingNote } from "@/components/settings/TrainingCard";
-
-// Settings → Act as me: drafts written as you, in your own mailbox, and how
-// much it sends as you on its own (Handle it for me, up to Take the lead).
-// Like someone new, each job can be in training (Off / In training / On on
-// its own card, as on Take the lead), and what it learned there is listed at
-// the bottom.
+// Act as me moved to its own tab under Delegate in the main menu.
export default function ActAsMeSettingsPage() {
- const load = useDelegation();
- const training = load.state === "ready" ? load.settings?.training : null;
- return (
- <SettingsSubpage title="Act as me" description={ACT_AS_ME_INTRO}>
- {training && <TrainingNote />}
- <ActAsMeCard onSettings={load.setSettings}>
- <HandleItCard load={load} />
- {training && <SuggestedActionsCard training={training} onSettings={load.setSettings} />}
- {training && <LearnedCard training={training} onSettings={load.setSettings} />}
- </ActAsMeCard>
- </SettingsSubpage>
- );
+ redirect("/delegate/act-as-me");
}
diff --git a/packages/ui/src/app/settings/executive/page.tsx b/packages/ui/src/app/settings/executive/page.tsx
index c3eda7f5..1cd7f103 100644
--- a/packages/ui/src/app/settings/executive/page.tsx
+++ b/packages/ui/src/app/settings/executive/page.tsx
@@ -7,8 +7,6 @@ import ExecutiveRunSwitch from "@/components/executive/ExecutiveRunSwitch";
import VoicePicker from "@/components/executive/VoicePicker";
import SettingsCard from "@/components/settings/SettingsCard";
import SettingsSubpage from "@/components/settings/SettingsSubpage";
-import TakeTheLeadCard from "@/components/settings/TakeTheLeadCard";
-import { MeetingAutonomySwitch } from "@/components/settings/WorkspaceCard";
// What it always does without asking: no switch, only Pause stops these.
const ALWAYS_DOES: { title: string; text: string }[] = [
@@ -18,20 +16,19 @@ const ALWAYS_DOES: { title: string; text: string }[] = [
{ title: "Research and monitoring", text: "Follows the topics and sources you asked it to watch." },
];
-// Settings → Your Executive: everything the Executive does without asking
-// first, and the voice it answers in. Pause at the top stops all of it; then
-// what it always does and what it does as itself (Take the lead, booking
-// meetings). What it sends as you lives on Act as me. /settings/on-its-own
-// lands here.
+// Settings → Your Executive: Pause, what it always does without asking, and
+// the voice it answers in. Pause stops everything it does on its own,
+// including Take the lead and booking meetings, which live under Delegate
+// with what it sends as you. /settings/on-its-own lands here.
export default function ExecutiveSettingsPage() {
return (
<SettingsSubpage
title="Your Executive"
- description="What it does without asking you first, how much, and the voice it answers in."
+ description="Pause it, what it always does without asking, and the voice it answers in."
>
<SettingsCard
title="Pause everything"
- description="Stops everything it does on its own below, plus briefs, nudges and research. It still answers when someone messages it, and anything you tap Send or Approve on still goes."
+ description="Stops everything it does on its own, Take the lead included, plus briefs, nudges and research. It still answers when someone messages it, and anything you tap Send or Approve on still goes."
>
<ExecutiveRunSwitch />
</SettingsCard>
@@ -49,19 +46,10 @@ export default function ExecutiveSettingsPage() {
</ul>
</SettingsCard>
- <section aria-labelledby="exec-as-executive" className="space-y-3">
- <div>
- <h2 id="exec-as-executive" className="text-lg font-semibold text-fg">As the Executive</h2>
- <p className="mt-1 text-[15px] text-fg-muted">In its own name. People can see it&apos;s the Executive.</p>
- </div>
- <TakeTheLeadCard />
- <MeetingAutonomySwitch />
- </section>
-
<p className="text-[15px] text-fg-muted">
- Replies it sends as you, from your own mailbox, are under{" "}
- <Link href="/settings/act-as-me" className="font-medium text-accent underline-offset-2 hover:underline">
- Act as me
+ Take the lead, booking meetings and what it sends as you are under{" "}
+ <Link href="/delegate/take-the-lead" className="font-medium text-accent underline-offset-2 hover:underline">
+ Delegate
</Link>
.
</p>
diff --git a/packages/ui/src/app/settings/page.tsx b/packages/ui/src/app/settings/page.tsx
index 785b3a06..0a30c37f 100644
--- a/packages/ui/src/app/settings/page.tsx
+++ b/packages/ui/src/app/settings/page.tsx
@@ -6,33 +6,31 @@ import { useEffect, useState, useSyncExternalStore } from "react";
import { useExecutiveStatus } from "@/components/executive/ExecutiveStatusContext";
import Icon from "@/components/Icon";
-import { HANDLE_IT_MODES } from "@/components/settings/HandleItCard";
import { MODE_LABEL } from "@/components/settings/WorkspaceCard";
import {
ADVANCED_ITEMS,
SETTINGS_PAGES,
- settingsPageForHash,
+ settingsHrefForHash,
type SettingsPageDef,
type SettingsPageId,
} from "@/components/shell/navConfig";
import { useWorkspace } from "@/components/workspace/WorkspaceContext";
import {
getAgentDetail,
- getDelegation,
getHistory,
getVersion,
listPersonas,
- type DelegationSettings,
type HistoryState,
} from "@/lib/api";
import { retentionLabel } from "@/lib/history";
import { versionNotice } from "@/lib/versionNotice";
// Settings — a hub of tiles, one per page (SETTINGS_PAGES): Your Executive,
-// Act as me, About you, Workspace, Advanced and About. Each tile says what's on its page
+// About you, Workspace, Advanced and About. Each tile says what's on its page
// and, where it's cheap to know, how things stand right now. The one-page
// Settings this replaces used anchors (`/settings#workspace`); a link that
-// still carries one is sent on to the matching page.
+// still carries one is sent on to the matching page (Act as me's, to its tab
+// under Delegate).
function subscribeHash(onChange: () => void): () => void {
window.addEventListener("hashchange", onChange);
@@ -56,20 +54,15 @@ export default function SettingsPage() {
// none to read. The hub is held back until it is known, and while an old
// anchor link is on its way to its page, so the tiles don't flash.
const hash = useSyncExternalStore(subscribeHash, readHash, () => null);
- const target = hash === null ? null : settingsPageForHash(hash);
+ const target = hash === null ? null : settingsHrefForHash(hash);
useEffect(() => {
- if (target) router.replace(target.href);
+ if (target) router.replace(target);
}, [router, target]);
const statuses = useTileStatuses();
- // Act as me has a tile only for someone who can have it (GET /delegation
- // answers null for everyone else).
- // About you, only for someone with notes to keep (GET /memories/history
+ // About you has a tile only for someone with notes to keep (GET /memories/history
// answers null for anyone not signed in or not on the People list).
- const pages = SETTINGS_PAGES.filter(
- (p) =>
- (p.id !== "act-as-me" || statuses.actAsMeOffered) && (p.id !== "memory" || statuses.memoryOffered),
- );
+ const pages = SETTINGS_PAGES.filter((p) => p.id !== "memory" || statuses.memoryOffered);
if (hash === null || target) return <main className="flex-1" />;
@@ -138,13 +131,11 @@ function SettingsTile({ page, status }: { page: SettingsPageDef; status?: TileSt
// leaves its tile without a status rather than guessing.
function useTileStatuses(): {
byPage: Partial<Record<SettingsPageId, TileStatus>>;
- actAsMeOffered: boolean;
memoryOffered: boolean;
} {
const { status: run, unknown } = useExecutiveStatus();
const { mode, effectiveTimezone, loading: workspaceLoading } = useWorkspace();
const [voice, setVoice] = useState<string | null>(null);
- const [delegation, setDelegation] = useState<DelegationSettings | null | "error">(null);
const [version, setVersion] = useState<TileStatus | null>(null);
const [history, setHistory] = useState<HistoryState | null | "error">(null);
@@ -157,11 +148,6 @@ function useTileStatuses(): {
if (!ctrl.signal.aborted && name) setVoice(name);
})
.catch(() => {});
- getDelegation(ctrl.signal)
- .then((d) => setDelegation(d))
- .catch((err) => {
- if ((err as Error)?.name !== "AbortError") setDelegation("error");
- });
getHistory(undefined, ctrl.signal)
.then((h) => setHistory(h))
.catch((err) => {
@@ -193,25 +179,6 @@ function useTileStatuses(): {
byPage.executive = { text: `${voice} voice`, tone: "none" };
}
- if (delegation && delegation !== "error") {
- byPage["act-as-me"] =
- delegation.gmail.status === "connected"
- ? {
- text: delegation.enabled ? "Mailbox connected · drafts on" : "Mailbox connected",
- tone: "ok",
- }
- : { text: "Mailbox not connected", tone: "warn" };
- const handleIt = delegation.handle_it;
- if (handleIt?.enabled) {
- const mode = HANDLE_IT_MODES.find((m) => m.mode === handleIt.mode)?.label ?? "On";
- // Short enough for one line on a phone: the dial step is what matters.
- byPage["act-as-me"] = {
- text: delegation.training?.replies ? `Handles: ${mode}, in training` : `Handles: ${mode}`,
- tone: "ok",
- };
- }
- }
-
if (history && history !== "error") {
const days = history.company_retention_days;
byPage.memory = {
@@ -232,5 +199,5 @@ function useTileStatuses(): {
byPage.advanced = { text: `${ADVANCED_ITEMS.length} tools for power users`, tone: "none" };
if (version) byPage.about = version;
- return { byPage, actAsMeOffered: delegation !== null, memoryOffered: history !== null };
+ return { byPage, memoryOffered: history !== null };
}
diff --git a/packages/ui/src/components/RepliesWaiting.tsx b/packages/ui/src/components/RepliesWaiting.tsx
index c069b253..b823a766 100644
--- a/packages/ui/src/components/RepliesWaiting.tsx
+++ b/packages/ui/src/components/RepliesWaiting.tsx
@@ -25,7 +25,7 @@ import {
import FeatureName from "@/components/FeatureName";
// Home: the replies the Executive drafted in your own Gmail for mail that
-// needs you (Settings → Act as me → Draft replies to my inbox), shown as
+// needs you (Delegate → Act as me → Draft replies to my inbox), shown as
// cards in "Needs you". Each card shows who wrote, what they wrote, the
// draft, what it leaves you to decide and anything to check. Send (the
// card's primary) sends that draft from your Gmail exactly as it is there,
diff --git a/packages/ui/src/components/delegate/DelegatePage.tsx b/packages/ui/src/components/delegate/DelegatePage.tsx
new file mode 100644
index 00000000..5145a27c
--- /dev/null
+++ b/packages/ui/src/components/delegate/DelegatePage.tsx
@@ -0,0 +1,28 @@
+import type { ReactNode } from "react";
+
+import FeatureName, { type Feature } from "@/components/FeatureName";
+
+// The frame of each Delegate tab: the feature's brand label as the title, a
+// line under it, and the page's cards. The hub's tab row (rendered by the
+// shell) is the way between them, so there's no back link.
+export default function DelegatePage({
+ feature,
+ description,
+ children,
+}: {
+ feature: Feature;
+ description: ReactNode;
+ children: ReactNode;
+}) {
+ return (
+ <main className="flex-1 min-h-0 overflow-y-auto">
+ <div className="max-w-3xl mx-auto px-4 sm:px-6 pt-6 sm:pt-8 pb-16">
+ <h1 className="text-2xl sm:text-3xl tracking-tight">
+ <FeatureName feature={feature} />
+ </h1>
+ <p className="mt-3 text-[15px] text-fg-muted leading-relaxed">{description}</p>
+ <div className="mt-6 space-y-5">{children}</div>
+ </div>
+ </main>
+ );
+}
diff --git a/packages/ui/src/components/settings/ActAsMeCard.tsx b/packages/ui/src/components/settings/ActAsMeCard.tsx
index fa9d0056..a9a35ce5 100644
--- a/packages/ui/src/components/settings/ActAsMeCard.tsx
+++ b/packages/ui/src/components/settings/ActAsMeCard.tsx
@@ -30,7 +30,7 @@ import {
import { formatAgo } from "@/lib/setupStatus";
import { addPhrase, markNew, STYLE_PHRASES, styleSentences } from "@/lib/voiceStyle";
-// Settings → Act as me: let the Executive draft email AS you, in your own
+// Delegate → Act as me: let the Executive draft email AS you, in your own
// Gmail Drafts, when you ask it to — and, with Draft replies to my inbox on,
// for mail that needs you, which it sends when you tap Send on Today (or on
// its own, under Handle it for me).
@@ -412,7 +412,7 @@ function InboxSection({
description={
on
? handleItOn
- ? "When mail comes in that needs you, it writes a first reply in your Drafts. Handle it for me, below, sends the simple ones; the rest wait on Today, where you send, edit or dismiss them."
+ ? "When mail comes in that needs you, it writes a first reply in your Drafts. Handle it for me, on the next tab, sends the simple ones; the rest wait on Today, where you send, edit or dismiss them."
: "When mail comes in that needs you, it writes a first reply in your Drafts and puts it on Today, where you send it, edit it in your mailbox or dismiss it. Nothing is sent until you tap Send."
: actAsMeOn
? "Off: it only drafts when you ask it to in chat."
diff --git a/packages/ui/src/components/settings/HandleItCard.tsx b/packages/ui/src/components/settings/HandleItCard.tsx
index 695cb990..caa1e0b5 100644
--- a/packages/ui/src/components/settings/HandleItCard.tsx
+++ b/packages/ui/src/components/settings/HandleItCard.tsx
@@ -22,7 +22,7 @@ import {
} from "@/lib/api";
import { formatAgo } from "@/lib/setupStatus";
-// Handle it for me (PUT /delegation/handle-it) on Settings → Act as me:
+// Handle it for me (PUT /delegation/handle-it), its own tab under Delegate:
// replies the inbox watcher sends from your mailbox on its own. Plain code
// decides each one (delegation/handle_it.py). Off / In training / On, as on
// Take the lead: In training (Replies in training, delegation/training.py,
@@ -60,7 +60,7 @@ export type DelegationLoad = {
setSettings: (next: DelegationSettings) => void;
};
-// GET /delegation once for the Act as me page's Training and Handle it
+// GET /delegation once for a Delegate tab's Training and Handle it
// cards, so a change on one shows on the other. "hidden" for someone who
// can't have Act as me (GET /delegation answers null).
export function useDelegation(): DelegationLoad {
@@ -87,9 +87,9 @@ export function useDelegation(): DelegationLoad {
return { settings, state, setSettings };
}
-// Under Draft replies to my inbox on Settings → Act as me: nothing for
+// On Delegate → Handle it for me: nothing for
// someone who can't have Act as me; until the inbox watcher is on, the card
-// says to turn it on above.
+// says to turn it on, on the Act as me tab.
export default function HandleItCard({ load }: { load: DelegationLoad }) {
const { settings, state, setSettings } = load;
if (state === "loading") return <p className="text-[15px] text-fg-muted">Loading…</p>;
@@ -218,7 +218,7 @@ export function HandleItSection({
!handleIt.available
? "Needs signed sign-ins on this server before it can send anything as you."
: !inboxOn
- ? "Turn on Draft replies to my inbox above first."
+ ? "Turn on Draft replies to my inbox on the Act as me tab first."
: "Replies and follow-ups it sends as you."
}
>
diff --git a/packages/ui/src/components/settings/TrainingCard.tsx b/packages/ui/src/components/settings/TrainingCard.tsx
index ebaf4095..950a7b7e 100644
--- a/packages/ui/src/components/settings/TrainingCard.tsx
+++ b/packages/ui/src/components/settings/TrainingCard.tsx
@@ -13,7 +13,7 @@ import {
type TrainingSetting,
} from "@/lib/api";
-// Training on Settings → Act as me (delegation/training.py), the way Take the
+// Training on Delegate → Act as me (delegation/training.py), the way Take the
// lead has it: like someone new, each job can be In training, where it brings
// you its work first and learns who and how from what you approve. Each job's
// card carries its own Off / In training / On (Write drafts as me, Handle it
diff --git a/packages/ui/src/components/settings/WorkspaceCard.tsx b/packages/ui/src/components/settings/WorkspaceCard.tsx
index 4633e18c..a50a79b0 100644
--- a/packages/ui/src/components/settings/WorkspaceCard.tsx
+++ b/packages/ui/src/components/settings/WorkspaceCard.tsx
@@ -366,7 +366,7 @@ function RoleSection() {
// "Book meetings without asking" — the meeting_scheduling decision class
// between "propose" (each booking waits for approval in the briefing) and
// "auto_execute". Hidden when this backend has no such setting (404). Shown
-// on Settings → Your Executive, with what else the Executive does by itself.
+// on Delegate → Take the lead, with what else the Executive does by itself.
export function MeetingAutonomySwitch() {
const [mode, setMode] = useState<DecisionClassMode | null>(null);
const [state, setState] = useState<"loading" | "ready" | "absent" | "error">("loading");
diff --git a/packages/ui/src/components/shell/AppShell.tsx b/packages/ui/src/components/shell/AppShell.tsx
index dbdc8d1f..fe6e8fff 100644
--- a/packages/ui/src/components/shell/AppShell.tsx
+++ b/packages/ui/src/components/shell/AppShell.tsx
@@ -58,6 +58,9 @@ const SEGMENT_LABELS: Record<string, string> = {
status: "Setup status",
executive: "Your Executive",
"act-as-me": "Act as me",
+ delegate: "Delegate",
+ "handle-it": "Handle it for me",
+ "take-the-lead": "Take the lead",
memory: "About you",
workspace: "Workspace",
advanced: "Advanced",
diff --git a/packages/ui/src/components/shell/navConfig.ts b/packages/ui/src/components/shell/navConfig.ts
index 534aa446..a08e5595 100644
--- a/packages/ui/src/components/shell/navConfig.ts
+++ b/packages/ui/src/components/shell/navConfig.ts
@@ -1,5 +1,6 @@
// Type-only imports, so `npm test` can load this file under
// `node --experimental-strip-types` (see scripts/navConfig.test.mjs).
+import type { Feature } from "@/components/FeatureName";
import type { IconName } from "@/components/Icon";
import type { RoleKind, WorkspaceMode } from "@/lib/api";
@@ -20,6 +21,8 @@ export interface NavItem {
description: string;
/** Optional pending-count badge (e.g. items awaiting review). */
badge?: number;
+ /** A named feature: its tab shows the feature's brand label. */
+ feature?: Feature;
}
interface BuildOpts {
@@ -162,13 +165,40 @@ const WORK_TABS: NavItem[] = [
},
];
+// The Delegate hub's tabs: what the Executive does as you (Act as me,
+// Handle it for me) and on its own (Take the lead). Each is a named feature,
+// so its tab shows the brand label.
+const DELEGATE_TABS: NavItem[] = [
+ {
+ href: "/delegate/act-as-me",
+ label: "Act as me",
+ icon: "mail",
+ feature: "act_as_me",
+ description: "Your mailbox, drafts written as you, and how you write.",
+ },
+ {
+ href: "/delegate/handle-it",
+ label: "Handle it for me",
+ icon: "check-circle",
+ feature: "handle_it",
+ description: "Replies and follow-ups it sends as you on its own.",
+ },
+ {
+ href: "/delegate/take-the-lead",
+ label: "Take the lead",
+ icon: "bolt",
+ feature: "take_the_lead",
+ description: "What it does in its own name without waiting to be asked.",
+ },
+];
+
/**
* A hub: one menu entry that holds several pages, shown as a row of tabs at
* the top of each of them (components/ui/HubTabs.tsx). The menu entry opens
* the first tab.
*/
export interface Hub {
- key: "work" | "company" | "you";
+ key: "work" | "company" | "you" | "delegate";
label: string;
icon: IconName;
description: string;
@@ -203,7 +233,14 @@ export function buildHubs({
description: "People, goals, departments and the company profile.",
tabs: companyTabs(isOnboarded),
};
- return [work, people];
+ const delegate: Hub = {
+ key: "delegate",
+ label: "Delegate",
+ icon: "check-circle",
+ description: "What your Executive does as you, and on its own: Act as me, Handle it for me, Take the lead.",
+ tabs: DELEGATE_TABS,
+ };
+ return [work, people, delegate];
}
// The hub a page belongs to, or null for a page that isn't in one.
@@ -228,7 +265,7 @@ export interface Destination extends NavItem {
alsoActiveOn?: string[];
}
-// The main menu, the same in the sidebar on every page: six places, then
+// The main menu, the same in the sidebar on every page: seven places, then
// Settings at the bottom. Everything else is a tab inside one of them or a
// tool under Settings.
export function buildDestinations({
@@ -401,12 +438,11 @@ export function advancedItemsByGroup(): {
}
// The Settings hub's tiles, in hub order. Each opens a short page of its
-// own at `href`. "act-as-me" shows only for someone who can have Act as me
-// (the hub drops it when the card is hidden), "memory" only for someone with
+// own at `href`. "memory" shows only for someone with
// notes to keep (signed in and on the People list). `hashes` are the anchors the
// old one-page Settings used (`/settings#workspace`): links that still
// carry one land on the matching page (see settingsPageForHash).
-export type SettingsPageId = "executive" | "act-as-me" | "memory" | "workspace" | "advanced" | "about";
+export type SettingsPageId = "executive" | "memory" | "workspace" | "advanced" | "about";
export interface SettingsPageDef {
id: SettingsPageId;
@@ -427,14 +463,6 @@ export const SETTINGS_PAGES: SettingsPageDef[] = [
description: "Pause it, what it does without asking you, and the voice it answers in.",
hashes: ["executive", "on-its-own"],
},
- {
- id: "act-as-me",
- label: "Act as me",
- href: "/settings/act-as-me",
- icon: "mail",
- description: "Your mailbox, drafts and replies sent as you, and how you write.",
- hashes: ["act-as-me"],
- },
{
id: "memory",
label: "About you",
@@ -484,6 +512,19 @@ export function settingsPageForHash(hash: string): SettingsPageDef | null {
return SETTINGS_PAGES.find((p) => p.hashes.includes(id)) ?? null;
}
+// Old Settings anchors for pages that moved out of Settings, and where they
+// went: Act as me is a tab of Delegate now.
+const MOVED_HASHES: Record<string, string> = { "act-as-me": "/delegate/act-as-me" };
+
+// Where an old `/settings#<hash>` link should go: its Settings page, or the
+// page it moved to, or null.
+export function settingsHrefForHash(hash: string): string | null {
+ const page = settingsPageForHash(hash);
+ if (page) return page.href;
+ const id = hash.replace(/^#/, "").trim();
+ return MOVED_HASHES[id] ?? null;
+}
+
// The phone's bottom bar: five, with New chat in the middle. Knowledge,
// Pulse and Settings are in the menu the top bar's button opens.
// `?new=1` signals the chat home to reset to a fresh chat and strip the
diff --git a/packages/ui/src/components/ui/HubTabs.tsx b/packages/ui/src/components/ui/HubTabs.tsx
index 2297f9fd..faa5028f 100644
--- a/packages/ui/src/components/ui/HubTabs.tsx
+++ b/packages/ui/src/components/ui/HubTabs.tsx
@@ -2,11 +2,15 @@
import Link from "next/link";
+import FeatureName from "@/components/FeatureName";
+
import type { Hub } from "@/components/shell/navConfig";
import { isNavActive } from "@/components/shell/navConfig";
// The tab row at the top of every page in a hub (Work, Company / You), so
// the hub's pages read as one place. The shell renders it; pages don't.
+// A tab for a named feature (Delegate's) shows its brand label: in full on
+// the open tab, muted on the others.
export default function HubTabs({ hub, pathname }: { hub: Hub; pathname: string }) {
return (
<nav
@@ -16,6 +20,21 @@ export default function HubTabs({ hub, pathname }: { hub: Hub; pathname: string
<div className="flex gap-1 py-2">
{hub.tabs.map((tab) => {
const active = isNavActive(tab.href, pathname);
+ if (tab.feature) {
+ return (
+ <Link
+ key={tab.href}
+ href={tab.href}
+ title={tab.description}
+ aria-current={active ? "page" : undefined}
+ className={`flex flex-shrink-0 items-center rounded-xl px-1 sm:px-2 py-1.5 text-[13px] sm:text-[15px] transition-opacity ${
+ active ? "" : "opacity-60 grayscale hover:opacity-100 hover:grayscale-0"
+ }`}
+ >
+ <FeatureName feature={tab.feature} className={active ? "" : "!bg-transparent"} />
+ </Link>
+ );
+ }
return (
<Link
key={tab.href}
diff --git a/packages/ui/src/lib/api.ts b/packages/ui/src/lib/api.ts
index 9e0471e5..fcc388ba 100644
--- a/packages/ui/src/lib/api.ts
+++ b/packages/ui/src/lib/api.ts
@@ -4937,7 +4937,7 @@ export async function updateClientMeta(
return res.json();
}
-// ── Take the lead (Settings → Your Executive) ────────────────
+// ── Take the lead (Delegate → Take the lead) ────────────────
export type LeadRuleKind = "person" | "domain" | "words" | "amount";
diff --git a/packages/ui/src/lib/voiceStyle.ts b/packages/ui/src/lib/voiceStyle.ts
index 68d74e3e..fa419e02 100644
--- a/packages/ui/src/lib/voiceStyle.ts
+++ b/packages/ui/src/lib/voiceStyle.ts
@@ -1,4 +1,4 @@
-// Settings → Act as me → How I write: the style as a few plain sentences
+// Delegate → Act as me → How I write: the style as a few plain sentences
// instead of a form, which of them a described style adds, and the phrases a
// person can tap into their description. Kept free of React so scripts/ can
// test it.
diff --git a/scripts/connect-own-gmail.py b/scripts/connect-own-gmail.py
index 26d53006..386b3a54 100644
--- a/scripts/connect-own-gmail.py
+++ b/scripts/connect-own-gmail.py
@@ -128,7 +128,7 @@ def main() -> int:
)
print(f"Saved {path}")
print("Copy it into the API's DELEGATION_GOOGLE_CREDENTIALS_DIR (Docker: /data/delegation_google/),")
- print("then open Settings → Act as me. Do not commit it.")
+ print("then open Delegate → Act as me. Do not commit it.")
return 0
diff --git a/scripts/connect-own-outlook.py b/scripts/connect-own-outlook.py
index 2b33f1a8..42cd967c 100644
--- a/scripts/connect-own-outlook.py
+++ b/scripts/connect-own-outlook.py
@@ -187,7 +187,7 @@ def main() -> int:
)
print(f"Saved {path}")
print("Copy it into the API's DELEGATION_GOOGLE_CREDENTIALS_DIR (Docker: /data/delegation_google/),")
- print("then open Settings → Act as me. Do not commit it.")
+ print("then open Delegate → Act as me. Do not commit it.")
return 0