@akanjs/cli 3.0.0-alpha.102 → 3.0.0-alpha.104

package/.build-stamp

@@ -1 +1 @@
-f85744854c5059c6127e0a720de471b1722191744441237c6816d7c59ec0fc90
+dd9f0e268907504c3c7608ed05e6f95752b6eb2dbfa2f31b3c69c451ff7806d9

package/{abstractCompactor-byytxs22.js → abstractCompactor-mjh5ppsq.js}

@@ -2,7 +2,7 @@
 import"./index-q0y2jq9j.js";
 import {
   AiSession
-} from "./index-c69j78kk.js";
+} from "./index-kn1h7p1x.js";
 import {
   AbstractDoc
 } from "./index-meh558jy.js";

package/{agent.command-v1a4746v.js → agent.command-d2gfxfck.js}

@@ -2,17 +2,17 @@
 import {
   Workspace,
   command
-} from "./index-znynzt5w.js";
+} from "./index-mak3cd28.js";
 import"./index-q0y2jq9j.js";
-import"./index-qsq3q8fy.js";
+import"./index-2tv3fdx4.js";
 import"./index-6wwzs1bc.js";
 import"./index-by5gpp8x.js";
-import"./index-fc1bh0a7.js";
-import"./index-gtmz74tj.js";
+import"./index-gyd220p2.js";
+import"./index-ktb5njgy.js";
 import"./index-h7yw2z9n.js";
 import {
   AgentScript
-} from "./index-29sxqfaw.js";
+} from "./index-ne2qy0nk.js";
 
 // pkgs/@akanjs/cli/agent/agent.command.ts
 class AgentCommand extends command("agent", [AgentScript], ({ public: target }) => ({

package/{application.command-fzdcnzhg.js → application.command-xgphqs7k.js}

@@ -6,19 +6,19 @@ import {
   Exec,
   Workspace,
   command
-} from "./index-znynzt5w.js";
+} from "./index-mak3cd28.js";
 import"./index-q0y2jq9j.js";
-import"./index-qsq3q8fy.js";
+import"./index-2tv3fdx4.js";
 import"./index-6wwzs1bc.js";
 import {
   ApplicationScript
-} from "./index-zz5jyd94.js";
-import"./index-gq44bqjt.js";
+} from "./index-yecdrt9a.js";
+import"./index-259dsnz3.js";
 import"./index-hwkygn9s.js";
 import {
   AbstractDoc
 } from "./index-meh558jy.js";
-import"./index-5svjba73.js";
+import"./index-j9yhg404.js";
 import {
   getMobileTargetChoices
 } from "./index-47pj3aee.js";

package/{applicationBuildRunner-s4gsk728.js → applicationBuildRunner-3d5q1yn7.js}

@@ -1,14 +1,14 @@
 // @bun
 import {
   Spinner
-} from "./index-qsq3q8fy.js";
+} from "./index-2tv3fdx4.js";
 import {
   AllRoutesBuilder,
   CsrArtifactBuilder,
   FontPruner,
   precompressArtifacts,
   SsrBaseArtifactBuilder
-} from "./index-p5neav9b.js";
+} from "./index-0vh9rgxz.js";
 import"./index-w8kmx1b6.js";
 import"./index-q0y2jq9j.js";
 import"./index-hwkygn9s.js";

package/{applicationReleasePackager-28v9vbzk.js → applicationReleasePackager-4yasxwv9.js}

@@ -4,7 +4,7 @@ import {
 } from "./index-q0y2jq9j.js";
 import {
   Spinner
-} from "./index-qsq3q8fy.js";
+} from "./index-2tv3fdx4.js";
 
 // pkgs/@akanjs/devkit/applicationReleasePackager.ts
 import { cp, mkdir, rm } from "fs/promises";

package/buildBatch.proc.js

@@ -2,7 +2,7 @@
 import {
   WorkspaceExecutor,
   AppExecutor
-} from "./index-qsq3q8fy.js";
+} from "./index-2tv3fdx4.js";
 import"./index-q0y2jq9j.js";
 import"./index-6wwzs1bc.js";
 import {
@@ -11,7 +11,7 @@ import {
   CsrArtifactBuilder,
   FontOptimizer,
   SsrBaseArtifactBuilder
-} from "./index-p5neav9b.js";
+} from "./index-0vh9rgxz.js";
 import"./index-w8kmx1b6.js";
 import"./index-hwkygn9s.js";
 import"./index-n68jx79w.js";

package/{capacitorApp-8d6d4zkm.js → capacitorApp-36rbr858.js}

@@ -2,8 +2,8 @@
 import {
   isPlaceholderAppId2,
   CapacitorApp2
-} from "./index-1yxtbmbj.js";
-import"./index-qsq3q8fy.js";
+} from "./index-wt7qrtd4.js";
+import"./index-2tv3fdx4.js";
 import"./index-6wwzs1bc.js";
 import"./index-q0y2jq9j.js";
 export {

package/{cloud.command-wygy2z05.js → cloud.command-abgkk73f.js}

@@ -2,23 +2,23 @@
 import"./index-q0y2jq9j.js";
 import {
   GlobalConfig
-} from "./index-c69j78kk.js";
+} from "./index-kn1h7p1x.js";
 import {
   Workspace,
   command
-} from "./index-znynzt5w.js";
-import"./index-qsq3q8fy.js";
+} from "./index-mak3cd28.js";
+import"./index-2tv3fdx4.js";
 import"./index-6wwzs1bc.js";
-import"./index-zz5jyd94.js";
-import"./index-gq44bqjt.js";
+import"./index-yecdrt9a.js";
+import"./index-259dsnz3.js";
 import"./index-hwkygn9s.js";
 import"./index-kcxmv48c.js";
-import"./index-7d6vny25.js";
-import"./index-zxgr3s8s.js";
+import"./index-ws5e0j51.js";
+import"./index-yw4xj7pa.js";
 import {
   CloudScript
-} from "./index-yks023mb.js";
-import"./index-5svjba73.js";
+} from "./index-4c9ykbfq.js";
+import"./index-j9yhg404.js";
 
 // pkgs/@akanjs/cli/cloud/cloud.command.ts
 var localRegistryUrl = () => process.env.AKAN_NPM_REGISTRY ?? "http://127.0.0.1:4873";

package/{context.command-4vdt1aqq.js → context.command-ez8a0zyz.js}

@@ -2,25 +2,25 @@
 import {
   Workspace,
   command
-} from "./index-znynzt5w.js";
+} from "./index-mak3cd28.js";
 import"./index-q0y2jq9j.js";
-import"./index-qsq3q8fy.js";
+import"./index-2tv3fdx4.js";
 import"./index-6wwzs1bc.js";
 import"./index-by5gpp8x.js";
-import"./index-fc1bh0a7.js";
-import"./index-gtmz74tj.js";
+import"./index-gyd220p2.js";
+import"./index-ktb5njgy.js";
 import {
   ContextScript
-} from "./index-yza7zkpt.js";
-import"./index-1yxtbmbj.js";
+} from "./index-600zhnve.js";
+import"./index-wt7qrtd4.js";
 import"./index-h7yw2z9n.js";
-import"./index-0amdxycf.js";
-import"./index-srdssqj7.js";
-import"./index-c69j78kk.js";
-import"./index-zmjppp25.js";
-import"./index-hyywke0f.js";
-import"./index-qkk27bk6.js";
-import"./index-8p8p0cf8.js";
+import"./index-fz5q3gd7.js";
+import"./index-7737gxcp.js";
+import"./index-kn1h7p1x.js";
+import"./index-8pm30m73.js";
+import"./index-pnqbkf5p.js";
+import"./index-4edzf1gr.js";
+import"./index-rwg2aa4f.js";
 
 // pkgs/@akanjs/cli/context/context.command.ts
 class ContextCommand extends command("context", [ContextScript], ({ public: target }) => ({

package/{devTui-qnf1txdz.js → devTui-70cjjtaw.js}

@@ -4,7 +4,7 @@ import {
   plainTextOf,
   HOST_SOURCE,
   DevLogBuffer
-} from "./index-zz5jyd94.js";
+} from "./index-yecdrt9a.js";
 
 // pkgs/@akanjs/cli/application/devTui.tsx
 import { render } from "ink";

package/{devTuiView-yzct2cq6.js → devTuiView-71wnkjft.js}

@@ -1,7 +1,7 @@
 // @bun
 // pkgs/@akanjs/cli/application/devTuiView.ts
 var createDevTuiView = async (supervisor) => {
-  const { DevTui } = await import("./devTui-qnf1txdz.js");
+  const { DevTui } = await import("./devTui-70cjjtaw.js");
   return new DevTui(supervisor);
 };
 export {

package/{guideline.command-p92dq6ts.js → guideline.command-xmqwx8zm.js}

@@ -4,11 +4,11 @@ import {
   runner,
   script,
   command
-} from "./index-znynzt5w.js";
+} from "./index-mak3cd28.js";
 import {
   FileSys
 } from "./index-q0y2jq9j.js";
-import"./index-qsq3q8fy.js";
+import"./index-2tv3fdx4.js";
 import {
   getDirname2
 } from "./index-6wwzs1bc.js";
@@ -17,7 +17,7 @@ import {
 } from "./index-h7yw2z9n.js";
 import {
   AiSession
-} from "./index-c69j78kk.js";
+} from "./index-kn1h7p1x.js";
 
 // pkgs/@akanjs/cli/guideline/guideline.script.ts
 import { Logger } from "akanjs/common";
@@ -135,9 +135,11 @@ Request: ${updateRequest}
   async requestCreateDocumentPage(page) {
     const writePath = this.#resolveDocsPagePath(page);
     if (!await this.workspace.exists(writePath))
-      await this.workspace.writeFile(writePath, `export default function Page() {
+      await this.workspace.writeFile(writePath, `import { page } from "akanjs/client";
+
+export default page().render(() => {
   return <div>No Content</div>;
-}
+});
 `);
     const instruction = await Prompter.getInstruction(this.name);
     const pageContent = await this.workspace.getLocalFile(writePath);
@@ -178,9 +180,11 @@ Please return only the file result in the following format for easy parsing.
   async requestUpdateDocumentPage(page, updateRequest) {
     const writePath = this.#resolveDocsPagePath(page);
     if (!await this.workspace.exists(writePath))
-      await this.workspace.writeFile(writePath, `export default function Page() {
+      await this.workspace.writeFile(writePath, `import { page } from "akanjs/client";
+
+export default page().render(() => {
   return <div>No Content</div>;
-}
+});
 `);
     const instruction = await Prompter.getInstruction(this.name);
     const pageContent = await this.workspace.getLocalFile(writePath);

package/guidelines/agentRule/agentRule.instruction.md

@@ -93,8 +93,7 @@ apps and libs never import it directly (`no-import-external-library`) — everyt
   model never saw is one it answers about from the filename. An adaptor declares `accepts: { image, document }` and
   `AgentService.readable` degrades the rest, so a text-only provider needs no attachment code at all — DeepSeek
   declares none, which is why an image against the default provider is refused out loud while an extracted PDF
-  works, `text` being readable by every model there is. **A `prompt()`'s `Msg.image` is the same wire shape** and
-  reaches the chat as an attachment rather than the literal `[image]` it used to become. Persisting keeps each
+  works, `text` being readable by every model there is. Persisting keeps each
   attachment's name and drops its content: web storage is a few megabytes, one screenshot fills a chunk of it, and
   a save that fails is silent — so keeping the bytes would quietly stop keeping the transcript.
   **The ceilings are the message's, not the file's**: 4 MB per file, 8 MB and five files per message, and the same
@@ -131,6 +130,11 @@ apps and libs never import it directly (`no-import-external-library`) — everyt
   `data-agent-zone` container; guides follow the layout cascade (ancestors and own, never a sibling's). Zone
   membership is positional — there is no per-declaration zone key, so a lib component joins whatever zone the app
   mounts it in.
+- **Two agents' turns run in parallel; their tool calls take turns.** Tool execution is serialized across the
+  whole page, because `AgentAbort` and `AgentProgress` reach the running call through a module slot rather than a
+  parameter — two calls in flight restore each other's slot and the second one's progress goes nowhere. Only the
+  execution queues: a zone parked on an approval card holds nothing up, since waiting for the user sits outside
+  the queue, and a call that is aborted releases it.
 - **Everything a zone publishes is named `<id>.<name>`,** and that name is what instructions must use. A bare
   `createVideoProject` inside a zone naming its tool `videoProjectDraft.createVideoProject` is a tool that does
   not exist: the model calls it, the surface answers `Unknown tool`, and a turn is gone. Build the name from the
@@ -367,18 +371,11 @@ apps and libs never import it directly (`no-import-external-library`) — everyt
   useless to a model — that is cheaper than every tool learning to avoid it.
 
 ## Slash Commands And The Transcript
-- **`prompt()` endpoints double as the chat's slash commands.** There is no listing endpoint — the client reads
-  its own serialized signals — so a prompt's dictionary `.desc()` is what the menu shows, and its guards are
-  enforced by the prompt's own GET at call time. Arguments are positional and whitespace-separated, and quoting
-  is how a sentence stays one of them (`/reviewTask t1 "look at the totals"`) — a prompt taking a single `String`
-  is the common case, and an unquoted sentence would fill its second parameter with the second word.
-- **The chat answers six slash commands of its own**, listed in the same `/` menu ahead of the prompts:
-  `/new` (`/clear`), `/retry`, `/compact`, `/copy`, `/help` and `/tools`. An app writes none of them and cannot add
-  one — the extension point for a product's own command is a `prompt()` endpoint, which is guarded and server-side.
-  **A built-in wins a name collision with a prompt of the same name**, the mirror image of the tool rule: a
-  component's `st.tool` shadows a built-in it means to replace, but no library's prompt may take `/new` away from
-  the user who typed it — so a shadowed prompt is dropped from the menu rather than listed twice. `/new` and
-  `/copy` are also dispatched *before* the is-a-turn-running check **and before the question card takes the
+- **The `/` menu is the chat's own.** An app's prompts are `page().prompt()` declarations served over MCP to
+  external agents; a browser chat lists none of them, so the menu holds the six built-in commands and nothing else.
+- **The chat answers six slash commands of its own**: `/new` (`/clear`), `/retry`, `/compact`, `/copy`, `/help` and
+  `/tools`. An app writes none of them and cannot add one — a workflow a person invokes by name belongs to MCP, as
+  a `page().prompt()`, where it is guarded by the page it opens. `/new` and `/copy` are dispatched *before* the is-a-turn-running check **and before the question card takes the
   composer**, because mid-turn is exactly when they are reached for and a question the agent asked is the middle
   of a turn like any other — answered as text, `/new` would have reached the model as the user's decision.
   `/new` therefore aborts the turn it is clearing and waits for it to wind down, since the loop clears its own
@@ -438,16 +435,17 @@ apps and libs never import it directly (`no-import-external-library`) — everyt
   row, Tab completing its name, and Escape closing the menu and then, pressed again, the panel.
 
 ## Built-In Tools
-- The framework publishes five built-ins on every store surface: `navigate` (internal paths only, the same
-  router `Link` rides), `goBack` (this session's history — global, because history is not a control a page owns and
-  a page that draws no back link is not one you may not leave — a screen that must not be left withholds them
-  with `builtins`, not with prose), `readScreen` (the rendered DOM as compact text —
-  headings, links, control values, and `(disabled)` on a control or button that has it; the chat's own UI is
-  skipped via `data-agent-ui`, and a password value is never read), `readState(key)` (one masked store key), and
-  `highlight(target)`. Declaring a hook tool under one of those names shadows the built-in, so reuse them only to
-  mean that. **There is no general-purpose wait**: a built-in one was reachable on every screen and a model spent
-  it on whatever key it liked, parking turns nobody asked to park. Waiting belongs to the screen that knows what
-  is worth waiting for — publish an `st.tool` beside the control that starts the work, and let it await the work.
+- The framework publishes five built-ins on every store surface: `navigate` (internal paths only, the same router
+  `Link` rides), `goBack` (this session's history — global, because history is not a control a page owns and a page
+  that draws no back link is not one you may not leave — a screen that must not be left withholds them with `builtins`,
+  not with prose), `readScreen` (the rendered DOM as compact text — headings, links, control values, and `(disabled)`
+  on a control or button that has it; the chat's own UI is skipped via `data-agent-ui`, and a password value is never
+  read), `readState(key)` (one masked store key — a key that is unknown or that this screen does not read is refused
+  *with the keys it can* read, the way `readScreen` names its sections), and `highlight(target)`. Declaring a hook tool
+  under one of those names shadows the built-in, so reuse them only to mean that. **There is no general-purpose wait**:
+  a built-in one was reachable on every screen and a model spent it on whatever key it liked, parking turns nobody
+  asked to park. Waiting belongs to the screen that knows what is worth waiting for — publish an `st.tool` beside the
+  control that starts the work, and let it await the work.
 - **A tool that changes the screen waits for the screen before it answers.** `router.push` returns while the RSC
   payload is still in flight and a store action that fires `void fetch.*` commits a tick later, so `navigate`
   awaits `ScreenSettle.wait()` — DOM quiescence, bounded, because the client router hands its promise to nobody —

package/guidelines/conventions/conventions.instruction.md

@@ -651,7 +651,7 @@ it.
   (`@libs/shared/srvkit`). Never sniff `aud` through a cast.
 - **The refusals are fail-closed**: a declared `mcp: false`, an endpoint with no `guards`, a mutation with no real
   guard, `pubsub` and `message`, an `Any` or `Upload` return, a file upload, a required `Any` argument, and the
-  generated `light<Model>` read. A `prompt` also refuses a list argument and any `Any` argument. **Every refusal
+  generated `light<Model>` read. An `enumOf` argument is checked against its values on every path. **Every refusal
   is named in the boot log**, along with every published entry missing a dictionary `.desc()` — an agent picks a
   tool by its description.
 - A refused endpoint answers the *same* "unknown tool" as one that does not exist, and a guard's refusal is
@@ -659,10 +659,14 @@ it.
 - **A `field.visual` field is stripped from every MCP result** and from the readable schema so the two agree.
 - **A structured result ships twice by default** — as `structuredContent` and as the same JSON in the text block.
   `option.setMcp({ legacyTextBlock: false })` leaves a pointer there instead.
-- **`prompt()`** is invoked by the *user* as a slash command, never chosen by the model. `exec` returns
-  `PromptMessage[]` built with `Msg.user` / `Msg.assistant` / `Msg.resource` / `Msg.image`; an embedded payload is
-  masked by the model you name, and one whose `hidden`/`secret` fields are populated with no model named is
-  refused. It is also mounted as a plain HTTP `GET` whether or not MCP is enabled, so guard it like any other read.
+- **A prompt is a screen: `page().prompt(name, description)`.** There is no `prompt()` on `endpoint()`.
+  `prompts/get` runs the page's body in the RSC worker under the caller's token — nothing is rendered — and answers
+  the description, one `resource` per `fetch.*` the page made (masked by the endpoint's return model, addressed by
+  its `akan://` uri, one document once whatever shapes read it) and the published tools of the modules it fetched
+  from, minus what is already attached; lists — only lists — are cut to `promptBudget`. A guard refusing a query
+  inside the body reads as the screen refusing the account, the same way a redirect does. A
+  required argument left out answers a pointer to the `<model>List…` tool, never a guess. The description is the
+  only instruction, in English — `<Agent.Guide>` never reaches MCP, and the in-page chat lists no page prompts.
 
 Full contract — configuration, wire behaviour, resource URIs, OAuth metadata, protocol revisions, and
 `McpProgress.report`: `get_guideline` with `mcpRule`, or `akan guideline show mcpRule`.
@@ -794,39 +798,50 @@ shape, so `cascade` never means "related" — it means one of exactly these:
 - Reserved `_*.tsx` route filenames are limited to `_index.tsx`, `_layout.tsx`, and `_overrides.tsx`; do not add files like `_Component.tsx` or `_helper.tsx`.
 - Page filenames must not start with an uppercase letter. Move helper components like `Component.tsx` to app `ui`, `common`, or `lib` instead.
 - Dynamic segments use `[id]`; route groups use directories like `(user)`, `(public)`, `(tab)`, or `(detail)`.
-- Page modules should usually export `default`, `pageConfig`, `head`, `generateHead`, or `Loading`.
+- **A route file exports one thing**: `export default page()…render(…)` for a page, `layout()…render(…)` for a
+  `_layout.tsx`, `rootLayout()…render(…)` for the app's (or a basePath's) root `_layout.tsx`. Every route setting
+  is a stage of the chain — `.param()`, `.search()`, `.config()`, `.head()` / `.metadata()`, `.loading()`;
+  `.notFound()` / `.error()` on a layout; `.fonts()` / `.theme()` / `.manifest()` / `.reconnect()` / `.wsConnect()`
+  / `.layoutStyle()` / `.gaTrackingId()` on the root layout; `.prompt()` on a page. A named export beside the chain,
+  or `page()` in a `_layout.tsx`, fails the build.
+- **A page names every `[x]` segment of its path with `.param("x", Type)`** and reads a query key only through
+  `.search("k", Type)`. Values arrive typed — `ID`/`String` → string, `Int`/`Float` → number, `Boolean`, `Date` →
+  Dayjs, an `enumOf` class → its union, `[T]` → array — a path value the type refuses answers not-found, and a
+  search value that fails is dropped. A layout may declare a subset. Names are string literals: `akan sync` reads
+  them off the source and refuses a `[projectId]` folder whose page declares no `.param("projectId")`. `lang` is
+  never declared: every route sits under `/:lang`, and the locale segment reaches every stage as `lang`.
 - `_overrides.tsx` is a logic-free UI-override manifest: imports plus a single `export default override({ Slot: AppComponent })` (from `akanjs/ui`), no `"use client"`. It re-skins framework `akanjs/ui` components for its route subtree; nested manifests merge over ancestors slot-by-slot (closest wins). See the UI Customization reference for the slot list.
-- Prefer `export default function Page` or `export default async function Page` for page components.
+- The legacy shape — `export default async function Page` beside `pageConfig` / `head` / `Loading` exports — still
+  loads and logs one deprecation warning per file at boot. Migrate with the `workspaceRecipes` recipe "Migrating
+  `page/` to the route chain"; new files are never written in it.
 - `libs/<lib>/page` follows the same rules and ships routes to apps that opt in with `syncPageLibs` in `akan.config.ts`: `true` takes every lib dep that has a `page` folder, an array takes the libs listed, `false` (the default) syncs nothing.
 - `akan sync` links those routes into `apps/<app>/page/(libs)/(<lib>)` — once per basePath when the app declares subRoutes. The folder is generated and gitignored; edit the lib source, never the link.
 - Both path segments are route groups, so a lib route mounts at its own path (`libs/<lib>/page/login/_index.tsx` serves `/login`). Two synced routes that resolve to the same pattern are a sync-time error.
-- `export const pageConfig = { devOnly: true }` keeps a route out of `akan build` while it keeps serving under `akan start` and keeps being typechecked. On a `_layout.tsx` it excludes every route under that directory too. Write it as a literal `true`/`false` — the build reads it off the source without evaluating the module.
+- `.config({ devOnly: true })` keeps a route out of `akan build` while it keeps serving under `akan start` and keeps being typechecked. On a `_layout.tsx` it excludes every route under that directory too. Write it as a literal `true`/`false` — the build reads it off the source without evaluating the module.
 - Before changing route behavior, check `pkgs/akanjs/server/routeTreeBuilder.ts` and nearby routes for the expected pattern.
 
 ### Page Body Shape
 
 ```tsx
-interface PageProps {
-  params: { orgId: string };
-}
-
-export default async function Page({ params }: PageProps) {
-  const { l } = usePage();
-  getSelf({ unauthorize: "/signin" });
-  const { orgId } = params;
-  const [{ org }, { taskInitInOrg }] = await Promise.all([fetch.viewOrg(orgId), fetch.initTaskInOrg(orgId)]);
-  return <Task.Zone.Card init={taskInitInOrg} prefix={`/org/${orgId}`} />;
-}
-
-export const pageConfig = { transition: "stack" } satisfies PageConfig;
+export default page()
+  .param("orgId", ID)
+  .config({ transition: "stack" })
+  .render(async ({ orgId }) => {
+    const { l } = usePage();
+    getSelf({ unauthorize: "/signin" });
+    const [{ org }, { taskInitInOrg }] = await Promise.all([fetch.viewOrg(orgId), fetch.initTaskInOrg(orgId)]);
+    return <Task.Zone.Card init={taskInitInOrg} prefix={`/org/${orgId}`} />;
+  });
 ```
 
-- There is no `loader=` / `render=` page prop. Pages are `export default async function Page`.
-- Declare `interface PageProps { params: {...}; searchParams?: {...} }` immediately above the default export.
-- Body order: `usePage()`, auth, destructure params, fetch, return.
+- There is no `loader=` / `render=` page prop and no `PageProps` interface: the chain declares the arguments and
+  `.render()` receives them flat, typed, with `lang` on every route and `children` added for a layout.
+- Body order inside `.render()`: `usePage()`, auth, fetch, return.
 - Run independent fetches through `Promise.all`, even when there is only one.
 - Gate auth at `_layout.tsx`; repeating `getSelf({ unauthorize: "/signin" })` in the page is fine and common.
-- Keep `async` even when nothing is awaited — it marks a real server page.
+- `async` on the render callback only when the body awaits; the callback is not a React component, so it takes no
+  name and no return type.
+- Publish a screen to agents with `.prompt(name, description)` — see MCP Exposure.
 - No `useState`, no `useEffect`, and no comments in page files.
 
 ## Akan Sync Conventions (`apps/**`, `libs/**`)