@agent-native/core 0.7.13 → 0.7.15

package/docs/content/template-content.md

@@ -1,19 +1,43 @@
 ---
-title: "Content Template"
-description: "A Notion-style document editor with an AI agent that can read, write, organize, and publish your pages."
+title: "Content"
+description: "A Notion-style document editor with an AI agent that can read, write, reorganize, and publish your pages — all in plain English."
 ---
 
-# Content Template
+# Content
 
-A hierarchical document editor in the style of Notion or Google Docs. The AI agent has full parity with the UI — it can create pages, edit selections, reorganize the tree, and sync with Notion, all while seeing exactly what you see.
+A Notion-style document workspace where the agent can read, write, reorganize, and publish pages for you. Open a doc, ask "rewrite this paragraph to be more concise" or "create a page called Q4 Planning with sub-pages for Goals, Metrics, and Risks" — same result whether you do it yourself or ask.
 
-## Overview {#overview}
+When you open the app, you'll see a sidebar tree of pages on the left, the editor in the middle, and the agent in the sidebar on the right. The agent always knows which page you're viewing and what text you have selected.
 
-The Content template is a rich-text document workspace with a sidebar tree, a Tiptap-based editor, and an agent panel. Pages live in a nested tree, content is stored as markdown in SQL, and the agent uses the same actions the UI calls for every operation.
+## What you can do with it
 
-Everything lives in one database (SQLite, Postgres, Turso — anything Drizzle supports) and the agent sees your current view, so you can say "rewrite this paragraph" or "add a sub-page for Q4 planning" and it knows what you mean without you pasting anything.
+- **Write rich text** with headings, lists, tables, code blocks, images, and links. Slash commands (`/`) insert blocks; selecting text pops up a formatting toolbar.
+- **Organize pages in a tree** — nest infinitely, drag to reorder, favorite pages you use often.
+- **Search across everything** with full-text search across titles and content.
+- **Sync with Notion.** Link a local doc to a Notion page and pull or push content in either direction. Comments sync both ways too.
+- **Collaborate in real time.** Multiple people (and the agent) can edit the same doc at the same time.
+- **Share docs** with teammates or make them public — private by default, with viewer / editor / admin roles.
+- **Ask the agent for anything**: "Rewrite this paragraph." "Add a TL;DR at the top." "Find all my meeting notes from last week." "Make this tone more formal."
 
-## Quick start {#quick-start}
+## Getting started
+
+Live demo: [content.agent-native.com](https://content.agent-native.com).
+
+When you open the app, click **+ New page** in the sidebar, give it a title, and start writing. To use the agent, type in the sidebar:
+
+- "Create a page called Onboarding and add three sub-pages under it."
+- "Rewrite this paragraph to be more concise." (with a page open)
+- "Add a section about pricing with three bullet points."
+- "Summarize this doc into a TL;DR at the top."
+- "Pull the latest from Notion." (after linking a Notion page)
+
+Select text and hit Cmd+I to focus the agent with that selection pre-loaded — "make this punchier" then operates on exactly what you highlighted.
+
+## For developers
+
+The rest of this doc is for anyone forking the Content template or extending it.
+
+### Quick start
 
 Scaffold a new workspace with the Content template:
 
@@ -26,9 +50,7 @@ pnpm dev
 
 Open `http://localhost:8080` and create your first page. The agent panel is on the right — try asking it to "create a page called Onboarding and add three sub-pages under it".
 
-Live demo: https://content.agent-native.com
-
-## Key features {#key-features}
+### Key features (technical) {#key-features}
 
 ### Hierarchical pages
 
@@ -92,27 +114,15 @@ See the `sharing` skill.
 
 A dedicated team page at `/team` (see `app/routes/_app.team.tsx`) uses the framework's `TeamPage` component for creating orgs and managing members.
 
-## Working with the agent {#working-with-the-agent}
+### Working with the agent
 
 Because the agent sees your current screen, most prompts don't need you to reference a document explicitly. When you have a page open, "this" means that page.
 
-Example prompts:
-
-- "Rewrite this paragraph to be more concise."
-- "Add a section about pricing with three bullet points."
-- "Create a page called Q4 Planning with sub-pages for Goals, Metrics, and Risks."
-- "Summarize this doc into a TL;DR at the top."
-- "Find all my meeting notes from last week."
-- "Change the tone of this page to be more formal."
-- "Pull the latest from Notion."
-- "Share this doc with hbikna@gmail.com as an editor."
-- "Move this page under Onboarding."
-
 For small edits, the agent uses `edit-document --find ... --replace ...` so only the changed text flows through Yjs — you'll see the diff applied in place rather than the whole page re-render. For bigger rewrites it uses `update-document --content ...`.
 
 If you select text and press Cmd+I (or focus the agent panel), the selection travels with your next message as context, so "make this punchier" operates on exactly what you highlighted.
 
-## Data model {#data-model}
+### Data model
 
 Four core tables, all defined in `server/db/schema.ts`:
 
@@ -126,7 +136,7 @@ Content is stored as markdown. The editor converts to and from the Tiptap JSON m
 
 All ownable tables include `owner_email` and `org_id` via `ownableColumns()`, so a local-mode workspace (`local@localhost`) can be upgraded to a real account without losing history.
 
-## Customizing it {#customizing-it}
+### Customizing it
 
 The four places to look when changing behavior:
 

package/docs/content/template-design.md

@@ -0,0 +1,55 @@
+---
+title: "Design"
+description: "An Agent-native design tool — sketch a UI, brand kit, or marketing visual by prompt or by hand, with the agent as your co-designer."
+---
+
+# Design
+
+A design tool where the agent is a real collaborator. Sketch a UI, a brand kit, or a marketing visual by prompt or by hand, and the agent generates layouts, suggests color systems, swaps fonts, and adjusts spacing alongside you on the same canvas.
+
+Think along the lines of Figma or Canva, but the agent has full edit rights — it can move shapes, restyle layers, and generate new artwork from a description, all in the same canvas you're working in.
+
+## What you can do with it
+
+- **Prompt-driven design.** Describe what you want — "a hero section for a B2B fintech SaaS, dark mode, brand color #14B8A6" — and the agent drafts it on the canvas.
+- **Edit by hand or by chat.** Drag, resize, recolor with the toolbar; or ask the agent to "tighten the spacing", "swap the headline font for something more editorial", "make every CTA the brand teal".
+- **AI image generation built in.** Generate background art, illustrations, or icons inline. Re-run with refined prompts without leaving the canvas.
+- **Brand-aware.** Save a brand kit (colors, fonts, voice). The agent applies it consistently across new artwork.
+- **Components and frames.** Reusable components, multi-page documents, and export to PNG/SVG/PDF.
+- **Agent context awareness.** When a layer is selected, the agent knows what you've selected and can act on just that piece.
+
+## Why it's interesting
+
+Three things make Design a good showcase of what agent-native enables:
+
+1. **The agent edits the canvas directly.** Layers, frames, styles — the agent calls the same actions the toolbar does. There's no "AI mode" separate from the design tool; they're the same tool.
+2. **Selection-aware editing.** Select a button and ask "make this the brand teal across all pages" — the agent knows which element you mean and propagates the change.
+3. **Designs you own.** The files live in your SQL, the artwork lives in your storage, the agent is yours. Fork the template, plug in a different image-generation provider, integrate your team's component library — it's your code.
+
+## For developers
+
+The rest of this doc is for anyone forking the Design template or extending it.
+
+### Scaffolding
+
+```bash
+pnpm dlx @agent-native/core create my-design --template design --standalone
+```
+
+### Customize it
+
+Design is a full cloneable SaaS — fork it and ask the agent to extend it. Some examples:
+
+- "Add a 'Generate variations' button that produces five color-swap alternatives for the selected frame."
+- "Wire the brand kit to read from our marketing-site repo so colors stay in sync."
+- "Add a comments layer with @-mentions and email notifications."
+- "Auto-export every published frame as a 1200×630 OG image and upload to our CDN."
+- "Let me drop a Figma link in chat and have the agent re-create it as native components here."
+
+The agent edits routes, components, canvas actions, and the schema as needed. See [Cloneable SaaS](/docs/cloneable-saas) for the full clone, customize, deploy flow, and [Getting Started](/docs/getting-started) if this is your first agent-native template.
+
+## What's next
+
+- [**Cloneable SaaS**](/docs/cloneable-saas) — the clone-and-own model
+- [**Context Awareness**](/docs/context-awareness) — how the agent knows the selected layer
+- [**Tools**](/docs/tools) — generate one-off image-creation utilities alongside the canvas

package/docs/content/template-dispatch.md

@@ -11,7 +11,7 @@ If you're running an [multi-app workspace](/docs/multi-app-workspace) with many
 
 ## What it does {#what-it-does}
 
-- **Central inbox.** Slack DMs, Telegram messages, email notifications, A2A requests from other agents — all land in one place. The Dispatch agent triages and either handles them itself or delegates.
+- **Central inbox.** Slack DMs, Telegram messages, email notifications, A2A requests from other agents — all land in one place. The Dispatch agent triages and either handles them itself or delegates. See [Messaging](/docs/messaging) for how to wire Slack, email, and Telegram into your workspace.
 - **Orchestrator, not specialist.** Dispatch does _not_ try to be the email app or the analytics app. When someone asks "summarize last week's signups," Dispatch calls the analytics agent over A2A and returns the answer. When someone asks "draft a reply to Alice," Dispatch calls the mail agent.
 - **Secrets vault.** A central store for API keys, OAuth tokens, and shared credentials. Apps in the workspace resolve secrets from Dispatch instead of duplicating them in every `.env`. Requests + approvals for sensitive access.
 - **Integrations catalog.** One page showing every third-party integration — Slack, Telegram, SendGrid, Apollo, etc. — with a "configured / not configured / pending approval" status per app.
@@ -29,8 +29,21 @@ Use Dispatch when:
 
 Skip it for a single-app scaffold — use the [Starter template](/docs/template-starter) or any of the domain templates directly.
 
+## What you'll do with it {#what-youll-do}
+
+Day-to-day, Dispatch is the place admins and ops folks open to keep the workspace running:
+
+- **Connect Slack, email, and Telegram** so people can message your agent from wherever they already work. See [Messaging](/docs/messaging) for the wiring steps.
+- **Save shared secrets once.** API keys, OAuth tokens, and service credentials live in the vault and the other apps in your workspace pull from there instead of every team member juggling their own `.env`.
+- **Set up recurring jobs.** "Every Monday at 7am, ask the analytics agent for last week's signups and email me a summary." See [Recurring Jobs](/docs/recurring-jobs).
+- **Approve outbound actions before they fire.** Sending money, mass-emailing customers, or posting to a public Slack channel can be gated behind an admin OK.
+- **See who has access to what.** Per-app grants, request queue, and an audit log of who used which secret when.
+- **Route messages to the right specialist.** A Slack DM about analytics goes to the analytics agent; one about email goes to the mail agent — Dispatch picks.
+
 ## Architecture at a glance {#architecture}
 
+_How it works under the hood (for developers)._
+
 - **Orchestrator agent.** The chat is set up as a router: it reads `AGENTS.md`, `LEARNINGS.md`, and routes to specialist sub-agents or remote A2A agents.
 - **Remote agent registry.** A2A manifests live in `remote-agents/*.json` — one per app. Dispatch calls them using the `call-agent` action.
 - **Vault schema.** Drizzle tables for secrets, grants, requests, approvals, and audit logs. See `server/db/schema.ts` in the template.
@@ -52,6 +65,7 @@ Dispatch is a full cloneable SaaS like any other template — see [Cloneable Saa
 
 ## What's next
 
+- [**Messaging**](/docs/messaging) — connecting Slack, email, and Telegram so you can talk to your agent from anywhere
 - [**Multi-App Workspace**](/docs/multi-app-workspace) — running Dispatch alongside multiple apps
 - [**A2A Protocol**](/docs/a2a-protocol) — how Dispatch delegates to specialist agents
 - [**MCP Clients — Hub Mode**](/docs/mcp-clients#hub) — sharing MCP servers across the workspace

package/docs/content/template-forms.md

@@ -5,24 +5,26 @@ description: "Agent-native form builder — create, edit, and analyze forms thro
 
 # Forms
 
-Forms is an agent-native form builder with a simple premise: everything the GUI can do, the agent can do, and vice versa. You can drag fields around in the editor, or you can type "add a 'how did you hear about us' dropdown with five options and make it required" — same result, same underlying data.
+A form builder where the form builder _is_ the agent. Drag fields around in the editor, or just say "add a 'how did you hear about us' dropdown with five options and make it required" — same result, same underlying data. Think Typeform, but you can build, edit, and analyze forms by talking to the agent.
 
-Think Typeform, but the form builder _is_ the agent.
+When you open the app, you'll see a list of your forms on the left and the editor in the middle. Open a form and you can click any field to fine-tune it, or ask the agent to make changes for you.
 
-## What it does {#what-it-does}
+## What you can do with it
 
-- **Build forms conversationally.** "Create a contact form," "add a NPS score question," "make the email field required." The agent updates the schema; the preview updates live.
+- **Build forms conversationally.** "Create a contact form," "add an NPS score question," "make the email field required." The agent updates the schema and the preview updates live.
 - **Click-to-edit fine-tuning.** Every field in the preview is editable in place — label, placeholder, validation, conditional logic — with the usual GUI controls.
-- **Field types** out of the box: short text, long text, email, phone, URL, number, date, single-select, multi-select, rating, file upload, section header, conditional branch.
-- **Responses dashboard.** Per-response view + an aggregate dashboard the agent can pivot on request: "show me signups from the last 30 days grouped by source."
+- **Field types out of the box:** short text, long text, email, phone, URL, number, date, single-select, multi-select, rating, file upload, section header, conditional branch.
+- **Responses dashboard.** Per-response view plus an aggregate dashboard the agent can pivot on request: "show me signups from the last 30 days grouped by source."
 - **Agent-driven analysis.** Ask the agent to cluster free-text responses, extract sentiments, or draft a reply to everyone who scored the NPS below 7.
-- **Publishing.** Public share link with embed snippet, branded thank-you page, webhook on submit.
+- **Publish anywhere.** Public share link, embed snippet, branded thank-you page, webhook on submit.
 
-## Why it's interesting {#why}
+## Why it's interesting
 
-Forms is a clear example of the [ladder](/docs/what-is-agent-native#the-ladder) rung 3 payoff. The hard part of a form builder isn't the editor UI — it's everything around it: schema evolution, response analytics, conditional logic, publishing, notifications, integrations. Most of that is just prompting the agent, because every capability is an action the agent can call.
+The hard part of a form builder isn't the editor UI — it's everything around it: changing the questions after responses are already in, analyzing what people said, adding conditional logic, publishing, notifications, hooking it into Slack or your CRM. Most of that is just asking the agent. See [What is agent-native?](/docs/what-is-agent-native) for the bigger picture.
 
-## Scaffolding {#scaffolding}
+## For developers
+
+### Scaffolding
 
 ```bash
 pnpm dlx @agent-native/core create my-forms --template forms --standalone
@@ -34,15 +36,16 @@ For a workspace with forms alongside other apps:
 pnpm dlx @agent-native/core create my-platform  # pick Forms + other templates
 ```
 
-## Customize it {#customize}
+### Customize it
 
-Ask the agent:
+Ask the agent for the outcome you want:
 
-- "Add a new 'signature' field type that captures a drawn signature." It adds the schema entry, renders the component, handles storage.
-- "When someone submits a form, post the response to our #signups Slack channel." It wires the webhook.
-- "Add per-form access control — some are public, some require a login." It updates the publishing flow.
+- "Add a signature field where people can draw their name."
+- "When someone submits this form, post it in our #signups Slack channel." (Connect Slack first via [Messaging](/docs/messaging).)
+- "Make some forms public and others login-only."
+- "Send everyone who scored below 5 a follow-up email asking what we could do better."
 
-See [Cloneable SaaS](/docs/cloneable-saas) for the full clone → customize → deploy flow.
+The agent figures out the schema changes, components, and storage on its own — you just describe the result you want. See [Cloneable SaaS](/docs/cloneable-saas) for the full clone, customize, deploy flow.
 
 ## What's next
 

package/docs/content/template-mail.md

@@ -1,26 +1,79 @@
 ---
-title: "Mail Template"
-description: "An agent-native email client. A Gmail and Superhuman alternative you own."
+title: "Mail"
+description: "An agent-powered email client. Connect your Gmail and the agent can read, draft, send, and organize email for you."
 ---
 
-# Mail Template
+# Mail
 
-Mail is an agent-native email client built on `@agent-native/core`. It reads from your real Gmail when you connect a Google account, and works as a local mailbox when you don't — with an AI agent that can triage, search, draft, and send on your behalf.
+An agent-powered email client. Connect your Gmail account and the agent can read, draft, send, and organize email for you — alongside a fast, keyboard-first inbox you can drive yourself. Think Superhuman, but the agent is a first-class citizen and the codebase is yours to own.
 
-## Overview {#overview}
+When you open the app, you'll see your inbox on the left, the open thread in the middle, and the agent in the sidebar on the right. The agent always knows which view you're in and which thread you have open, so you can say "archive this" or "draft a friendly decline" without explaining what "this" is.
 
-Mail is a drop-in replacement for Gmail and Superhuman. The UI is keyboard-first: a thread list on the left, the open thread in the middle, and a compose panel that opens as tabs on the right. The agent sits alongside in the sidebar and has the same powers the UI has — read, search, archive, label, star, draft, and send — via actions in `templates/mail/actions/`.
+## What you can do with it
 
-Use it if you want:
+- **Read and triage email** with keyboard shortcuts (`J`/`K` to move, `E` to archive, `R` to reply, `C` to compose).
+- **Connect multiple Gmail accounts** — personal and work in one inbox.
+- **Ask the agent to do anything you can do.** "Summarize my unread emails." "Draft a reply that politely declines." "Archive all Netlify bot emails older than a week."
+- **Auto-triage with rules.** Set up automation rules in plain English ("from a newsletter") with actions (label, archive, mark read, star, trash).
+- **Track opens and clicks** on the emails you send.
+- **Search across every connected inbox** with one query.
+- **Bulk archive, export, and label** — useful for inbox cleanup.
 
-- An email client where an AI agent can actually work on your mail, not just suggest.
-- Superhuman-style keyboard shortcuts without the subscription.
-- Multi-account Gmail support (personal + work in one inbox).
-- Your own codebase. Fork it, change anything, own the data.
+## Getting started
 
-The agent always knows which view, thread, and message you're looking at because the UI writes that state into SQL (`application_state`) where the agent can read it.
+Live demo: [mail.agent-native.com](https://mail.agent-native.com).
 
-## Quick start {#quick-start}
+When you first open the app:
+
+1. Click **Settings** in the sidebar.
+2. Click **Connect Google account**, sign in to Gmail, and approve.
+3. (Optional) Connect a second Google account for work + personal.
+4. Head back to the inbox — your real Gmail will sync in.
+
+Without a Google account connected, the app runs against an empty local mailbox (useful for screenshots and demos, not much else).
+
+## Talking to the agent
+
+The agent reads `application_state.navigation` on every turn, so it already knows which view you're in, which thread is open, and which message is focused — you don't have to tell it. You can just say things like:
+
+- "Summarize my unread emails."
+- "Find the latest thread from Alice about the budget."
+- "Draft a reply that politely declines."
+- "Archive all Netlify bot emails older than a week."
+- "Open my starred emails."
+- "Make this draft more formal."
+- "Did they open my email?"
+
+If you select text and hit Cmd+I, that selection travels with your next message — so "make this punchier" operates on exactly what you highlighted.
+
+## Keyboard shortcuts
+
+| Key       | Action                      |
+| --------- | --------------------------- |
+| `J`       | Next email                  |
+| `K`       | Previous email              |
+| `Up/Down` | Same as J/K                 |
+| `Enter`   | Open focused email          |
+| `E`       | Archive email or thread     |
+| `D`       | Trash email or thread       |
+| `S`       | Star or unstar              |
+| `R`       | Reply                       |
+| `U`       | Toggle read/unread          |
+| `C`       | Compose new email           |
+| `/`       | Focus search bar            |
+| `Cmd+K`   | Open command palette        |
+| `G I`     | Go to Inbox                 |
+| `G S`     | Go to Starred               |
+| `G T`     | Go to Sent                  |
+| `G D`     | Go to Drafts                |
+| `G A`     | Go to Archive               |
+| `Esc`     | Close thread / clear search |
+
+## For developers
+
+The rest of this doc is for anyone forking the Mail template or extending it.
+
+### Quick start
 
 Create a new workspace with the Mail template:
 
@@ -37,94 +90,39 @@ Or add Mail to an existing agent-native workspace:
 agent-native add-app
 ```
 
-Live demo: [mail.agent-native.com](https://mail.agent-native.com)
-
-On first run, connect a Google account from Settings to sync real Gmail. Without a Google account, the app runs against an empty local email store (useful for screenshots or demos).
-
-## Key features {#key-features}
+### Key features (technical)
 
-### Gmail sync (multi-account)
+**Gmail sync (multi-account).** Connect one or many Google accounts via OAuth. List and search actions query all connected inboxes by default; results carry an `accountEmail` field so you can tell which inbox each thread came from. Scope to a single account with `--account=user@example.com`. OAuth tokens are stored via `@agent-native/core/oauth-tokens` under the `"google"` provider.
 
-Connect one or many Google accounts via OAuth. List and search actions query all connected inboxes by default; results carry an `accountEmail` field so you can tell which inbox each thread came from. Scope to a single account with `--account=user@example.com`. OAuth tokens are stored via `@agent-native/core/oauth-tokens` under the `"google"` provider.
+**Multiple compose drafts.** The compose panel supports multiple draft tabs at once. Each draft is stored as an `application_state` entry at `compose-{id}` and syncs live between the agent and the UI. The agent can create a new draft with `manage-draft --action=create`, edit your in-progress draft with `--action=update`, or close tabs with `--action=delete`. Drafts use markdown in the body field; the TipTap editor renders it as rich text and converts to HTML on send.
 
-### Keyboard-first navigation
+**AI triage via automations.** Mail supports automation rules that run against new inbox email using AI. A rule has a natural-language condition (for example, `"from a newsletter"` or `"subject contains invoice"`) and a list of actions (`label`, `archive`, `mark_read`, `star`, `trash`). Manage them via `pnpm action manage-automations --action=create|list|update|delete|enable|disable`, or through the Settings page. Rules fire automatically and can be triggered manually with `pnpm action trigger-automations`.
 
-The app is designed to run without a mouse. `J`/`K` move between threads, `E` archives, `R` replies, `C` composes, `/` focuses search, and `G` begins a "go to" chord (`G I` for Inbox, `G S` for Starred, etc.). See the [full list below](#keyboard-shortcuts).
+**Send tracking.** Sent messages get open-pixel and link-click tracking injected automatically. Settings live under `mail-settings.tracking` with `tracking.opens` and `tracking.clicks` (both default `true`). Only links in the new portion of a reply or forward are rewritten — quoted content is left alone. Pull stats for any sent message with `pnpm action get-tracking --id=<message-id>`, or from `GET /api/emails/:id/tracking`. Open and click events are stored in the `email_tracking` and `email_link_tracking` tables.
 
-### Multiple compose drafts
+**Search.** `pnpm action search-emails --q=<term>` searches across all views and all connected accounts. The UI search bar maps to the same action. Both `search-emails` and `list-emails` take `--compact` for shorter output and `--fields=from,subject,date` to limit returned fields.
 
-The compose panel supports multiple draft tabs at once. Each draft is stored as an `application_state` entry at `compose-{id}` and syncs live between the agent and the UI. The agent can create a new draft with `manage-draft --action=create`, edit your in-progress draft with `--action=update`, or close tabs with `--action=delete`. Drafts use markdown in the body field; the TipTap editor renders it as rich text and converts to HTML on send.
-
-### AI triage via automations
-
-Mail supports automation rules that run against new inbox email using AI. A rule has a natural-language condition (for example, `"from a newsletter"` or `"subject contains invoice"`) and a list of actions (`label`, `archive`, `mark_read`, `star`, `trash`). Manage them via `pnpm action manage-automations --action=create|list|update|delete|enable|disable`, or through the Settings page. Rules fire automatically and can be triggered manually with `pnpm action trigger-automations`.
-
-### Send tracking
-
-Sent messages get open-pixel and link-click tracking injected automatically. Settings live under `mail-settings.tracking` with `tracking.opens` and `tracking.clicks` (both default `true`). Only links in the new portion of a reply or forward are rewritten — quoted content is left alone. Pull stats for any sent message with `pnpm action get-tracking --id=<message-id>`, or from `GET /api/emails/:id/tracking`. Open and click events are stored in the `email_tracking` and `email_link_tracking` tables.
-
-### Search
-
-`pnpm action search-emails --q=<term>` searches across all views and all connected accounts. The UI search bar maps to the same action. Both `search-emails` and `list-emails` take `--compact` for shorter output and `--fields=from,subject,date` to limit returned fields.
-
-### Bulk operations and export
+**Bulk operations and export.**
 
 - `pnpm action bulk-archive --older-than=30` archives everything older than N days.
 - `pnpm action export-emails --view=inbox --output=file.json` dumps a view to JSON.
 - Archive, trash, mark-read, and star all accept comma-separated IDs (`--id=id1,id2,id3`) for bulk changes.
 
-### Inline thread previews in agent chat
-
-When the agent answers a question about a specific thread, it can embed a live preview of the thread directly in the chat message via an `embed` code fence. The preview is a sandboxed iframe that shows the full conversation without leaving the chat, with an "Open in app" button that navigates the main window to that thread.
+**Inline thread previews in agent chat.** When the agent answers a question about a specific thread, it can embed a live preview of the thread directly in the chat message via an `embed` code fence. The preview is a sandboxed iframe that shows the full conversation without leaving the chat, with an "Open in app" button that navigates the main window to that thread.
 
-## Working with the agent {#working-with-the-agent}
-
-The agent reads `application_state.navigation` on every turn, so it already knows which view you're in, which thread is open, and which message is focused — you don't have to tell it. You can just say things like:
-
-- "Summarize my unread emails."
-- "Find the latest thread from Alice about the budget."
-- "Draft a reply that politely declines."
-- "Archive all Netlify bot emails older than a week."
-- "Open my starred emails."
-- "Make this draft more formal."
-- "Did they open my email?"
-
-How the agent sees your context:
+### How the agent sees your context
 
 - **Current view and thread** — the UI writes `navigation` (view, threadId, focusedEmailId, search, label) whenever you navigate. The agent reads it via `readAppState("navigation")` or `pnpm action view-screen`.
 - **Open draft** — if you're composing a reply and ask "help me word this", the agent reads the matching `compose-{id}` entry to see your current subject and body, then writes an updated draft back. The UI picks up the edit live.
 - **Thread history** — for context mid-reply, the agent fetches the full thread with `pnpm action get-thread --id=<threadId>`.
 
-How the agent takes action:
+### How the agent takes action
 
 - **Mail operations** — archive, trash, star, mark read, send, draft — all run as `pnpm action <name>` scripts under `templates/mail/actions/`.
 - **Navigation** — to open a thread or switch views for you, the agent writes `application_state.navigate`, which the UI consumes and deletes. The `pnpm action navigate` script wraps this.
 - **Refresh** — after any change, the agent runs `pnpm action refresh-list` so the UI refetches.
 
-## Keyboard shortcuts {#keyboard-shortcuts}
-
-| Key       | Action                      |
-| --------- | --------------------------- |
-| `J`       | Next email                  |
-| `K`       | Previous email              |
-| `Up/Down` | Same as J/K                 |
-| `Enter`   | Open focused email          |
-| `E`       | Archive email or thread     |
-| `D`       | Trash email or thread       |
-| `S`       | Star or unstar              |
-| `R`       | Reply                       |
-| `U`       | Toggle read/unread          |
-| `C`       | Compose new email           |
-| `/`       | Focus search bar            |
-| `Cmd+K`   | Open command palette        |
-| `G I`     | Go to Inbox                 |
-| `G S`     | Go to Starred               |
-| `G T`     | Go to Sent                  |
-| `G D`     | Go to Drafts                |
-| `G A`     | Go to Archive               |
-| `Esc`     | Close thread / clear search |
-
-## Data model {#data-model}
+### Data model
 
 When a Google account is connected, email lives in Gmail — the app is a view on top. When no account is connected, emails live in the SQL settings store under `getSetting("local-emails")` (empty by default).
 
@@ -150,7 +148,7 @@ Routes in the UI:
 - `/settings` — account connections, tracking, automations.
 - `/team` — team members and shared resources.
 
-## Customizing it {#customizing-it}
+### Customizing it
 
 Mail is yours to change. Everything important lives in a handful of places — start there.
 

package/docs/content/template-slides.md

@@ -1,25 +1,51 @@
 ---
-title: "Slides Template"
-description: "Agent-native presentation editor — generate decks from a prompt, edit visually, and present in full-screen."
+title: "Slides"
+description: "Generate decks from a prompt, edit visually, and present full-screen. An open-source replacement for Google Slides, Pitch, and PowerPoint."
 ---
 
-# Slides Template
+# Slides
 
-An open-source, agent-native presentation editor built on `@agent-native/core`. It replaces Google Slides, Pitch, and PowerPoint with a deck you can author in three ways at once — by talking to the agent, by clicking the canvas, or by editing HTML.
+Generate full presentation decks from a prompt, edit slides visually, and present full-screen. Ask the agent for "a 10-slide pitch deck for a coffee subscription service" and watch it stream slide-by-slide into the editor in seconds. An open-source replacement for Google Slides, Pitch, and PowerPoint.
 
-## Overview {#overview}
+When you open the app, you'll see your deck list. Click into a deck and you get a slide editor in the middle, a sidebar of slides on the left, and the agent on the right.
 
-The Slides template is a full presentation studio:
+## What you can do with it
 
-- Generate complete decks from a prompt, one slide at a time.
-- Edit slides visually or drop into raw HTML for full control.
-- Generate images with Gemini, search stock photos, and look up company logos.
-- Present full-screen with keyboard navigation and speaker notes.
-- Comment, share, and collaborate in real time over Yjs.
+- **Generate decks from a prompt.** "Generate a 10-slide pitch deck for a coffee subscription service, audience is investors."
+- **Edit slides visually** — double-click text to edit, click a block for the bubble menu, use `/` for the slash menu to insert blocks.
+- **Generate images with AI.** Hero images, product mockups, illustrations — generated with Gemini, multiple variations per request.
+- **Search stock photos and company logos.** "Find the logo for stripe.com and add it to slide 2."
+- **Present full-screen** with keyboard navigation, auto-hiding controls, and speaker notes.
+- **Comment, collaborate, and share.** Multiple people can edit the same deck in real time. Generate a public read-only URL or share with specific teammates.
+- **Import from PDF.** Turn a PDF into a starter deck — the agent parses it and lays out the content.
 
-Every operation the UI does — creating a deck, adding a slide, swapping an image — is exposed as an action the agent can call too. The agent and UI always stay in sync because they read and write the same SQL database.
+## Getting started
 
-## Quick start {#quick-start}
+Live demo: [slides.agent-native.com](https://slides.agent-native.com).
+
+When you open the app:
+
+1. Click **New deck**.
+2. In the agent sidebar, ask: "Generate a 10-slide pitch deck for a coffee subscription service, audience is investors."
+3. Watch slides stream in. Click any slide to edit, or keep asking the agent to refine.
+
+### Useful prompts
+
+- "Generate a 10-slide pitch deck for a coffee subscription service, audience is investors."
+- "Add a pricing slide after slide 3."
+- "Make the title on this slide bigger and change the accent color to green."
+- "Generate a hero image for the current slide — dark, minimal, cinematic."
+- "Find the logo for stripe.com and add it to slide 2."
+- "Replace the word 'customers' with 'members' everywhere in this deck."
+- "Summarize this PDF as a 6-slide deck." (attach the PDF)
+
+Select text on a slide and hit Cmd+I to focus the agent with that selection — it'll act only on what you selected.
+
+## For developers
+
+The rest of this doc is for anyone forking the Slides template or extending it.
+
+### Quick start
 
 Create a new Slides app from the CLI:
 
@@ -29,11 +55,7 @@ cd my-slides
 pnpm dev
 ```
 
-Or try the hosted demo at [slides.agent-native.com](https://slides.agent-native.com).
-
-Once running, open the app, click "New deck", and ask the agent in the sidebar: "Generate a 10-slide pitch deck for a coffee subscription service."
-
-## Key features {#key-features}
+### Key features (technical) {#key-features}
 
 ### Prompt-to-deck generation
 
@@ -91,20 +113,10 @@ Cmd+Z and Cmd+Shift+Z work across the whole deck, with a labeled history panel (
 
 Turn a PDF into a starter deck. The `extract-pdf` action parses the file and hands the content to the agent for layout.
 
-## Working with the agent {#working-with-the-agent}
+### Working with the agent
 
 The agent chat lives in the sidebar. It can create decks, edit individual slides, generate images, search logos, and navigate the UI — all using the same actions you'd run from the CLI.
 
-### Example prompts
-
-- "Generate a 10-slide pitch deck for a coffee subscription service, audience is investors."
-- "Add a pricing slide after slide 3."
-- "Make the title on this slide bigger and change the accent color to green."
-- "Generate a hero image for the current slide — dark, minimal, cinematic."
-- "Find the logo for stripe.com and add it to slide 2."
-- "Replace the word 'customers' with 'members' everywhere in this deck."
-- "Summarize this PDF as a 6-slide deck." (attach the PDF)
-
 ### What the agent sees
 
 When a deck is open, the agent automatically sees:
@@ -123,7 +135,7 @@ Select text on a slide and hit Cmd+I to focus the agent with that selection pre-
 
 The agent can embed a live slide preview directly in a chat reply using the framework's embed fence. It renders a chromeless iframe via `app/routes/slide.tsx` so you can see the result without leaving the conversation.
 
-## Data model {#data-model}
+### Data model
 
 All deck data lives in SQL via Drizzle ORM. Schema: `templates/slides/server/db/schema.ts`.
 
@@ -169,7 +181,7 @@ Each slide inside `decks.data` is:
 
 `content` is raw HTML — the renderer (`app/components/deck/SlideRenderer.tsx`) provides the black background and fixed aspect ratio, and the HTML provides everything inside. Rich embedding is supported too: Excalidraw diagrams via `ExcalidrawSlide.tsx` and Mermaid charts via `MermaidRenderer.tsx`.
 
-## Customizing it {#customizing-it}
+### Customizing it
 
 The Slides template is fully forkable. Key places to look when extending it: