@bivy/bivy 0.20.9-staging.3 → 0.20.9-staging.31

package/README.md

@@ -285,10 +285,9 @@ Every session gets the `bivy` CLI, so any agent with a shell can talk back
 through the app, not only agents with their own built-in tools:
 
 ```bash
-bivy notify "Tests are green, PR is up"     # chat card + phone push when you're away
+bivy notify                                 # push to your phone so you come back
 bivy ask "Ship to staging?" --option Yes --option No  # waits for your answer
 bivy attach report.png --caption "Before/after"       # show a file in the chat
-bivy suggest "Add a dark theme to settings"           # a next task you start in one tap
 bivy context --json                                   # session, workspace, machine, apps
 ```
 
@@ -527,6 +526,8 @@ use, modify, and self-host it under that license. If users interact with your
 modified version over a network, section 13 requires you to offer its
 corresponding source. See [LICENSE](LICENSE).
 
-Bivy Cloud is the hosted operation of that stack plus billing and plans, in a
-separate private repository. Contributions use the
-[DCO](CONTRIBUTING.md#certificate-of-origin); there is no CLA.
+Bivy Cloud is the hosted operation of that stack. Its plans, billing and
+managed-compute operations live in a separate private service behind Core's
+deployment extension. Contributions are made under the
+[Contributor License Agreement](CLA.md). The Bivy name and logo are covered by
+the [trademark policy](TRADEMARKS.md).

package/bin/bivy.mjs

@@ -2595,38 +2595,6 @@ async function cmdContext(args = []) {
   console.log(`\nEverything else: ${c.cyan("bivy help")} (or ${c.cyan("bivy help --json")}).`);
 }
 
-// `bivy suggest "<task>" [--title "…"] [--run here|subagents|new] [--session <id>]`
-// — propose a task the user can start in one tap, in this session or beside it. For an agent
-// offering next steps: write the task as a complete instruction.
-async function cmdSuggest(args = []) {
-  const usage = 'Usage: bivy suggest "<task>" [--title "short label"] [--run here|subagents|new] [--session <id>] [--json]';
-  if (args.includes("-h") || args.includes("--help")) {
-    console.log(`${usage}\n\nPost a task the user can start in one tap: in this session, through your sub-agents, or in a parallel session that works in its own copy of the project. Write it as a complete instruction, with paths relative to the project root.\n\n--run says where you recommend running it, which becomes the card's main button: here (builds on this conversation), subagents (independent tasks you can split across your own sub-agents; only if you have them), or new (bigger independent work the user will want to follow in its own session). Without it, one card recommends here and several recommend new.\n\n--json prints {"ok","id"}.`);
-    return;
-  }
-  const json = wantsJson(args);
-  const fail = (error) => cliError(error, { json, paint: c.red });
-  const flagsWithValue = new Set(["--session", "--title", "--run"]);
-  const flag = (name) => {
-    const i = args.indexOf(name);
-    return i >= 0 && i + 1 < args.length ? args[i + 1] : undefined;
-  };
-  const text = args.filter((a, i) => !a.startsWith("-") && !(i > 0 && flagsWithValue.has(args[i - 1]))).join(" ").trim();
-  const sessionId = resolveAttachSessionId({ sessionFlag: flag("--session"), env: process.env });
-  if (!text) return fail({ code: "usage", message: usage, exit: EXIT.usage });
-  const run = flag("--run");
-  if (run !== undefined && !["here", "subagents", "new"].includes(run)) return fail({ code: "usage", message: `--run is here, subagents or new (got "${run}").`, exit: EXIT.usage });
-  if (!sessionId) return fail({ code: "no_session", message: "No session id.", hint: "Run inside an agent session ($BIVY_SESSION_ID) or pass --session <id>.", next: "bivy sessions --json", exit: EXIT.usage });
-  const config = loadConfig();
-  if (!(await ensureNodeRunning(config))) return fail({ code: "node_unreachable", message: `Could not reach the Bivy node at ${url(config)}.`, next: "bivy status", exit: EXIT.unavailable });
-  const res = await sessionPost(config, sessionId, "suggest", { text, title: flag("--title"), run }).catch((error) => error);
-  if (res instanceof Error) return fail({ code: "node_unreachable", message: `Could not reach the Bivy node: ${res.message}`, next: "bivy status", exit: EXIT.unavailable });
-  const body = await res.json().catch(() => ({}));
-  if (!res.ok) return fail(sessionHttpError("Suggest", res.status, body));
-  if (json) { console.log(JSON.stringify(body)); return; }
-  console.log(c.green("Suggested in the chat. The user can start it in one tap."));
-}
-
 // `bivy title "<title>" [--session <id>]` — rename the session the agent runs in.
 async function cmdTitle(args = []) {
   const usage = 'Usage: bivy title "<title>" [--session <id>] [--json]';
@@ -2674,45 +2642,37 @@ function durationSeconds(text) {
   return m ? Number(m[1]) * (m[2] === "h" ? 3600 : m[2] === "m" ? 60 : 1) : NaN;
 }
 
-// `bivy notify "<message>" [--urgent]` — reach the user: a card in the chat,
-// and a push naming the session (never the text) when nobody has the app open.
+// `bivy notify [--urgent]` — bring the user back: a push naming the session
+// (never any text) when nobody has the app open. Nothing is posted in the chat.
 async function cmdNotify(args = []) {
-  const usage = 'Usage: bivy notify "<message>" [--urgent] [--session <id>] [--json]';
+  const usage = "Usage: bivy notify [--urgent] [--session <id>] [--json]";
   if (args.includes("-h") || args.includes("--help")) {
     console.log(`${usage}
 
-Send the user a message: it appears as a card in the chat, and their devices get
-a push notification (naming this session, not the text) when nobody has the app
-open. --urgent pushes even while they do. At most one push a minute per session;
-later messages still reach the chat. Use it when you finish long work, get
-blocked, or need the user to look at something. --json prints
-{"ok","id","push":"sent"|"user_watching"|"rate_limited","userWatching"}.`);
+Push to the user's devices so they come back to this session. The push names the
+session, nothing else, and nothing is posted in the chat: say what you need in
+your reply. It is sent only when nobody has the app open; --urgent pushes even
+while they do. At most one push a minute per session. You don't need it when you
+finish: Bivy already pushes when a turn ends while the user is away. --json prints
+{"ok","push":"sent"|"user_watching"|"rate_limited"|"unavailable","userWatching"}.`);
     return;
   }
   const json = wantsJson(args);
   const fail = (error) => cliError(error, { json, paint: c.red });
   const parsed = parseSessionArgs(args, ["--session"]);
   if (parsed.error) return fail({ code: "usage", message: parsed.error, exit: EXIT.usage });
-  const text = parsed.positional.join(" ").trim();
-  if (!text) return fail({ code: "usage", message: usage, exit: EXIT.usage });
   const sessionId = resolveAttachSessionId({ sessionFlag: parsed.one("--session"), env: process.env });
   if (!sessionId) return fail({ code: "no_session", message: "No session id.", hint: "Run inside an agent session ($BIVY_SESSION_ID) or pass --session <id>.", next: "bivy sessions --json", exit: EXIT.usage });
   const config = loadConfig();
   if (!(await ensureNodeRunning(config))) return fail({ code: "node_unreachable", message: `Could not reach the Bivy node at ${url(config)}.`, next: "bivy status", exit: EXIT.unavailable });
-  const res = await sessionPost(config, sessionId, "notify", { text, urgent: parsed.has("--urgent") }).catch((error) => error);
+  const res = await sessionPost(config, sessionId, "notify", { urgent: parsed.has("--urgent") }).catch((error) => error);
   if (res instanceof Error) return fail({ code: "node_unreachable", message: `Could not reach the Bivy node: ${res.message}`, next: "bivy status", exit: EXIT.unavailable });
   const body = await res.json().catch(() => ({}));
   if (!res.ok) return fail(sessionHttpError("Notify", res.status, body));
   if (json) { console.log(JSON.stringify(body)); return; }
-  const noPush = { user_watching: "the user has the app open; add --urgent to push anyway", rate_limited: "this session pushed less than a minute ago", unavailable: "this machine isn't signed in to a Bivy account" }[body.push];
-  // A terminal run (`bivy run`) has no chat to hold a card: the push is the notice.
-  if (body.posted === false) {
-    if (body.push === "sent") console.log(c.green("Pushed to the user's devices."));
-    else console.log(c.yellow(`Not delivered: a terminal run has no chat to post in, and no push was sent (${noPush ?? body.push}).`));
-    return;
-  }
-  const pushed = body.push === "sent" ? "and pushed to the user's devices" : noPush ? `(no push: ${noPush})` : "";
-  console.log(c.green(`Posted in the chat ${pushed}.`.replace(" .", ".")));
+  if (body.push === "sent") { console.log(c.green("Pushed to the user's devices.")); return; }
+  const noPush = { user_watching: "the user has the app open, so they see your reply; add --urgent to push anyway", rate_limited: "this session pushed less than a minute ago", unavailable: "this machine isn't signed in to a Bivy account" }[body.push];
+  console.log(c.yellow(`No push sent: ${noPush ?? body.push}.`));
 }
 
 // `bivy ask "<question>" [--option …]` — the question card, for any agent.
@@ -6515,9 +6475,6 @@ An agent's own --help passes through, e.g. 'bivy run claude --help'.`);
     case "attach":
       await cmdAttach(args);
       break;
-    case "suggest":
-      await cmdSuggest(args);
-      break;
     case "title":
       await cmdTitle(args);
       break;

package/bin/cli-commands.mjs

@@ -44,14 +44,12 @@ export const COMMANDS = [
   { name: "context", group: "session", scope: "session", json: true, usage: "context [--json]", summary: "Where this agent is running: session, workspace, machine, apps, and what to run next",
     tools: [{ name: "bivy_context", description: "Where you are running inside Bivy: your session, agent, workspace and git branch, the machine, apps you have published, whether the user has the app open, and the commands that reach them.", input: {}, argv: ["context"] }] },
   { name: "attach", group: "session", scope: "session", json: true, usage: 'attach <file> [--caption "…"] [--artifact]', summary: "Show a local file or image to the user in the chat" },
-  { name: "notify", group: "session", scope: "session", json: true, usage: 'notify "<message>" [--urgent]', summary: "Message the user: a card in the chat, and a push when they're away",
-    tools: [{ name: "notify_user", description: "Send the user a message: a card in the chat, and a push to their phone when nobody has the app open (the push names the session, not the text). Use it when long work finishes, you are blocked, or something needs their attention. At most one push a minute per session.", input: { message: { type: "string", description: "What to tell the user.", required: true }, urgent: { type: "boolean", description: "Push even while the user has the app open." } }, argv: ["notify", { arg: "message" }, { when: "urgent", flag: "--urgent" }] }] },
+  { name: "notify", group: "session", scope: "session", json: true, usage: "notify [--urgent]", summary: "Push to the user's phone so they come back (nothing posted in the chat)",
+    tools: [{ name: "notify_user", description: "Push to the user's phone so they come back to this session, e.g. when you are blocked on them while still working. The push names the session only and nothing is posted in the chat, so say what you need in your reply. Not needed when you finish: Bivy already pushes when a turn ends while they are away. Sent only when nobody has the app open, at most one a minute per session.", input: { urgent: { type: "boolean", description: "Push even while the user has the app open." } }, argv: ["notify", { when: "urgent", flag: "--urgent" }] }] },
   { name: "ask", group: "session", scope: "session", json: true, usage: 'ask "<question>" [--option A --option B] [--async]', summary: "Ask the user a question and wait for the answer", subcommands: ["status", "wait"],
     tools: [{ name: "ask_user", description: "Ask the user a question in the chat and wait for their answer (their phone gets a push). Offer 2-8 options, or none for a free-text answer; they can always write their own. Returns {status, answer}: status is answered, dismissed (decide yourself) or expired.", input: { question: { type: "string", description: "The question.", required: true }, options: { type: "array", items: { type: "string" }, description: "Choices to pick from (2-8)." }, multiple: { type: "boolean", description: "Allow several choices." }, header: { type: "string", description: "A short label for the card." }, timeout_seconds: { type: "number", description: "How long to wait (default 600)." } }, argv: ["ask", { arg: "question" }, { flag: "--option", from: "options" }, { when: "multiple", flag: "--multi" }, { flag: "--header", from: "header" }, { flag: "--timeout", from: "timeout_seconds" }] }] },
   { name: "title", group: "session", scope: "session", json: true, usage: 'title "<title>"', summary: "Rename this session",
     tools: [{ name: "set_session_title", description: "Rename this session in the user's session list. Use a short title (under 60 characters) that says what the work is, when the first message made a poor title or the work changed direction.", input: { title: { type: "string", description: "The new title.", required: true } }, argv: ["title", { arg: "title" }] }] },
-  { name: "suggest", group: "session", scope: "session", json: true, usage: 'suggest "<task>" [--title "label"] [--run here|subagents|new]', summary: "Propose a task the user can start in one tap",
-    tools: [{ name: "suggest_task", description: "Propose a next step the user can start in one tap: in this session, through your sub-agents, or in a parallel session with its own copy of the project. Write the task as a complete instruction with paths relative to the project root. Post one per idea instead of listing them.", input: { task: { type: "string", description: "The complete instruction.", required: true }, title: { type: "string", description: "A short label for the card." }, run: { type: "string", enum: ["here", "subagents", "new"], description: "Where you recommend running it: here (builds on this conversation), subagents (independent tasks you can split across your own sub-agents; only if you have them), or new (bigger independent work in its own session). Defaults: here for one card, new for several." } }, argv: ["suggest", { arg: "task" }, { flag: "--title", from: "title" }, { flag: "--run", from: "run" }] }] },
   { name: "app", group: "session", scope: "session", json: true, usage: "app <publish|shot|present|share|run|…>", summary: "Live previews: publish a web/terminal/desktop app, screenshot it, present it", subcommands: ["publish", "list", "remove", "shot", "present", "share", "notes", "run", "click", "type", "key", "scroll", "drag", "move", "menu"],
     tools: [
       { name: "app_publish", description: "Give the user a live preview of something with a UI, from an app manifest file (web server port, static build, terminal, or desktop app). Run `bivy app --help` for the manifest format.", input: { manifest_path: { type: "string", description: "Path to the manifest JSON.", required: true } }, argv: ["app", "publish", { arg: "manifest_path" }] },

package/bin/guides/talk-to-the-user.md

@@ -1,18 +1,24 @@
 # Talk to the user
 
-Summary: When to answer in chat, when to notify, when to ask and wait, and how to offer next steps.
+Summary: When to answer in chat, when to notify, and when to ask and wait.
 
 Your chat reply is the default. Reach for these when the chat alone won't do.
 
 ## They may be away: notify
 
-    bivy notify "Migration finished: 3 tables rewritten, all tests pass."
-    bivy notify --urgent "Production is serving the old build."
+    bivy notify
+    bivy notify --urgent
 
-Posts a card in the chat. When nobody has the app open, their devices get a push
-naming this session (the text stays in the chat). `--urgent` pushes even while
-they are looking. One push a minute per session; don't send one per step.
-Good moments: long work finished, you are blocked, something needs a look.
+Pushes to their devices so they come back to this session. The push names the
+session only and nothing is posted in the chat, so say what you need in your
+reply. It goes out only when nobody has the app open; `--urgent` pushes even
+while they are looking. One push a minute per session.
+
+You don't need it when you finish: Bivy already pushes when a turn ends while
+they are away. Use it while you keep working and need them, for example when a
+long run is blocked on something only they can do.
+
+Next steps and options go in your reply as plain text.
 
 ## You need a decision: ask
 
@@ -24,23 +30,6 @@ dismissed it (use your judgment), exit 5 that `--timeout` (default 10m) passed.
 For long waits use `--async`, keep working, and later `bivy ask wait <id>`.
 Ask only when you can't reasonably decide yourself.
 
-## Offer next steps: suggest
-
-    bivy suggest "Add a GET /version endpoint that returns the package version." --title "Add /version"
-
-Each suggestion is a card the user can start in one tap: here, through your
-sub-agents, or in a parallel session with its own copy of the project. Write it as
-a complete instruction with paths relative to the project root. Post one per idea
-instead of a bulleted list.
-
-`--run` picks the card's main button; the others stay one tap away:
-
-| `--run` | When |
-|---|---|
-| `here` | It builds on this conversation, or it's small. Default for a single card. |
-| `subagents` | Independent tasks you can split across your own sub-agents and report back on. Only if you have sub-agents. |
-| `new` | Bigger independent work the user will want to follow, review or merge on its own. Default for several cards. |
-
 ## Name the session: title
 
     bivy title "Fix login redirect loop"

package/dist/agent-instructions.js

@@ -30,27 +30,31 @@ export const MAX_AGENT_INSTRUCTIONS_BYTES = 16 * 1024;
 export const BIVY_AGENT_NOTE = [
     "You are running inside Bivy. The user follows this session in a chat app (web or phone): they cannot see your " +
         "terminal or files you only write to disk. $BIVY_SESSION_ID identifies this session; the `bivy` commands below use it.",
-    "- Show a LOCAL file or image (report, screenshot, chart, a file they asked for): run " +
-        '`bivy attach <path> [--caption "short note"]`, or call the `attach_to_chat` tool if you have it. Images render ' +
-        "inline, other files as downloads; the path must be inside the session workspace. Markdown image syntax like " +
-        "![](path) does not render a local path. A REMOTE `https://` image in markdown does render.",
+    "- Show an IMAGE (a screenshot, or a picture you rendered to a file) inside your reply: write it as markdown, " +
+        "`![short caption](relative/path.png)`, where you want it to appear. The path must be inside the session " +
+        "workspace; a remote `https://` image works too. No tool call needed.",
+    "- Show a FILE (a report, a log, data they asked for) inside your reply: put " +
+        '`::view{src=relative/path.pdf caption="what it is"}` on its own line, where you want it. Same workspace-only ' +
+        "rule. A `.csv`/`.tsv` renders as a table; anything else arrives as a download.",
+    "- Show a NUMBER or a CHART inside your reply: fence a spec as ```bivy. A number is " +
+        '`{"type":"metric","value":"4 650 kWh","label":"per year"}`; a chart is a plain Vega-Lite spec with its data ' +
+        "inline, or pointing at a workspace data file with `\"data\":{\"url\":\"data/use.csv\"}` (.csv/.tsv/.json). " +
+        "A chart cannot fetch a remote URL.",
+    "- Send a file WITHOUT writing a reply (or from a script): run " +
+        '`bivy attach <path> [--caption "short note"]`, or call the `attach_to_chat` tool if you have it.',
+    "- Put a published app's preview INSIDE your reply: `::view{app=<app id>}` on its own line. It frames the app " +
+        "where you wrote it, and still opens full screen on demand.",
     "- Something with a UI: `bivy app publish <manifest.json>` (a web server's port, a static build, a terminal) or " +
         "`bivy app run -- <command>` (a desktop app) gives the user a live preview; `bivy app shot` screenshots it so you " +
         "can check your work; `bivy app present` tells the user a visible change is ready to look at, and " +
         "`.bivy/scenarios/*.json` files let them open it in the states that matter (errors, empty, slow) with `--try`. " +
         "`bivy app --help` has the details.",
-    "- Proposing tasks the user could hand you (next steps, ideas, options): post each with " +
-        '`bivy suggest "<complete instruction>" [--title "short label"] [--run here|subagents|new]` instead of only ' +
-        "listing them. The user can start each in one tap, in this session, through your sub-agents, or in a parallel " +
-        "one that works in its own copy of the project, so write it to stand on its own, with paths relative to the " +
-        "project root. `--run` is the one you recommend: here when it builds on this conversation, subagents for " +
-        "independent tasks you can split and supervise (only if you have sub-agents), new for bigger work worth its " +
-        "own session.",
     '- If this session\'s title (taken from the first message) doesn\'t say what the work is, or the work changes ' +
         'direction: `bivy title "<short title>"`.',
-    "- When you finish long work, get blocked, or need the user to look at something: " +
-        '`bivy notify "<message>"` (a chat card, plus a push to their phone when they are away). To ask and wait for ' +
-        'an answer: `bivy ask "<question>" [--option A --option B]` prints their answer (or use your own ask-the-user tool).',
+    "- Your chat reply is what the user reads; when you finish while they are away, Bivy pushes to their phone for you. " +
+        'To bring them back while you keep working: `bivy notify` (a push only; say what you need in the chat). To ask ' +
+        'and wait for an answer: `bivy ask "<question>" [--option A --option B]` prints their answer (or use your own ' +
+        "ask-the-user tool).",
     "- Only when the user asks for another agent or another of their machines to take part: " +
         '`bivy delegate "<self-contained task>" --agent <id> [--machine <name>] --wait` runs it there and prints ' +
         "its answer and any branch/PR; `--to codex,grok@<machine>` asks several to compare, `bivy delegate machines` " +

package/dist/apps/remote-preview.js

@@ -24,6 +24,9 @@ export class RemotePreview {
         this.badge = badge;
     }
     get available() { return this.online && Boolean(this.gateway); }
+    /** Someone is loading or holding open a preview (pooled streams close after a
+     * few idle seconds; a dev server's live-reload socket stays open). */
+    get inUse() { return this.sockets.size > 0; }
     ready(origin, relayUrl) {
         this.disconnect();
         if (!origin)

package/dist/apps/service.js

@@ -814,8 +814,13 @@ export class AppService {
                 return;
             const now = Date.now();
             server.restarts = server.restarts.filter((at) => now - at < RESTART_WINDOW);
-            if (server.restarts.length >= MAX_RESTARTS)
+            // A crash loop stays down until the view is opened again, rather than
+            // retrying every time the window rolls over.
+            if (server.restarts.length >= MAX_RESTARTS) {
+                clearInterval(server.timer);
+                server.timer = undefined;
                 return;
+            }
             server.restarts.push(now);
             server.termId = undefined;
             void this.ensureServer(current).catch(() => { });

package/dist/apps/styles.css

@@ -485,6 +485,12 @@ input, textarea, select { font-family: inherit; font-size: 16px; }
 }
 .transcript-turn { display: flex; flex-direction: column; gap: var(--space-4); min-width: 0; }
 .transcript-standalone { display: flex; justify-content: center; min-width: 0; }
+/* A centered flex row lets a child grow past the column on one long unbroken
+   token (a path in an error); cap every standalone item to the column. */
+.transcript-standalone > * { min-width: 0; max-width: 100%; }
+/* Errors span the column so their edges line up with the turn content. */
+.transcript-error { flex: 1; display: flex; flex-direction: column; gap: var(--space-2); overflow-wrap: anywhere; }
+.transcript-error .settings-disclosure-body { margin: 0; padding: 0; white-space: pre-wrap; font-size: var(--text-xs); color: var(--muted); }
 .turn-response-body { display: flex; flex-direction: column; gap: var(--space-2); min-width: 0; }
 .jump-latest {
   position: absolute; left: 50%; bottom: 16px; transform: translateX(-50%);
@@ -633,6 +639,29 @@ input, textarea, select { font-family: inherit; font-size: 16px; }
 .msg.assistant .mermaid-diagram:first-child { margin-top: 0; }
 .msg.assistant .mermaid-diagram:last-child { margin-bottom: 0; }
 .msg.assistant .mermaid-diagram svg { display: inline-block; max-width: none; height: auto; vertical-align: top; }
+/* Mount point for a component the agent placed in its message (::view{…}, a
+   ```bivy fence). Layout only: what renders inside is an existing component
+   (.msg-attachment, .card), so this must not restyle its shell — it only gives
+   it the same vertical rhythm as a paragraph. Empty until the portal mounts,
+   and empty forever if a reference never resolves, so it carries no border or
+   background of its own that would leave a visible hole. */
+.msg.assistant .md-component { margin: 0.75em 0; }
+.msg.assistant .md-component:first-child { margin-top: 0; }
+.msg.assistant .md-component:last-child { margin-bottom: 0; }
+.msg.assistant .md-component:empty { margin: 0; }
+/* A placed component is a block in the reading column, not a tile in a row: it
+   fills the message width so every kind lines up with every other one and with
+   the prose around it. The fixed chip width belongs to the composer's wrapping
+   attachment list, where several chips share a line. */
+.msg.assistant .md-component > * { width: 100%; }
+/* A single number the agent wants read at a glance. Inherits .card's shell;
+   only the value's type scale is its own. */
+.metric-component { text-align: center; }
+.metric-value { font-size: var(--text-3xl); line-height: var(--lh-3xl); font-weight: var(--weight-semibold); }
+/* A table from a CSV or a spec reuses .markdown-table-wrap, so it reads exactly
+   like a table the agent wrote as markdown. The caption is the only addition. */
+.table-component { margin: 0; }
+.table-component figcaption { margin-top: var(--space-2); }
 /* Syntax highlighting for fenced code blocks (highlight.js token classes).
    Colors use light-dark() so one rule set tracks the app's light/dark scheme
    (color-scheme is set on :root). A GitHub-flavored palette that sits well on
@@ -655,20 +684,6 @@ input, textarea, select { font-family: inherit; font-size: 16px; }
 .entry-actions { display: flex; flex-wrap: wrap; gap: var(--space-2); font-style: normal; }
 .msg.system .entry-actions { justify-content: center; }
 .msg.thinking { align-self: flex-start; color: var(--muted); font-size: 13px; border-left: 2px solid var(--line-strong); padding-left: 10px; }
-.msg.error {
-  align-self: stretch; display: flex; gap: 8px; align-items: flex-start;
-  background: var(--danger-soft); border: 1px solid color-mix(in srgb, var(--danger) 45%, transparent);
-  border-left: 3px solid var(--danger); border-radius: var(--radius-sm); padding: 10px 12px;
-}
-.msg-error-icon {
-  flex: none; width: 18px; height: 18px; margin-top: 1px; border-radius: var(--radius-full);
-  background: var(--danger); color: var(--danger-contrast); font-weight: 700; font-size: 12px;
-  display: grid; place-items: center;
-}
-.msg-error-text {
-  flex: 1; min-width: 0; font-size: 13px; line-height: 1.45; color: var(--ink);
-  white-space: pre-wrap; overflow-wrap: anywhere; word-break: break-word;
-}
 .msg.streaming { position: relative; }
 .msg.streaming::after { content: "▍"; color: var(--accent); animation: blink 1s steps(2) infinite; }
 @keyframes blink { 50% { opacity: 0; } }
@@ -1477,10 +1492,8 @@ button.sheet-action:last-child { border-bottom: 0; }
 }
 /* Password-manager-style provider credential vault. Saved items are the primary
    list; the provider catalog appears only inside Add. */
-/* Wide settings panels that read as a shallow "vault": the credential vault and
-   the isolated-machine-profiles panel share this container + header layout. */
-.credential-vault, .machine-profiles { gap: 14px; max-width: 680px; width: 100%; }
-.credential-vault { overflow-wrap: anywhere; }
+/* The credential vault: a wide settings panel that reads as a shallow "vault". */
+.credential-vault { gap: 14px; max-width: 680px; width: 100%; overflow-wrap: anywhere; }
 .vault-title-row { display: flex; align-items: flex-start; justify-content: space-between; gap: 14px; }
 .vault-title-row > div { min-width: 0; }
 /* The header action (e.g. "+ Add profile") never shrinks or wraps — the title
@@ -1865,21 +1878,8 @@ button.template-card.is-featured .template-card-icon {
 }
 .automation-row .row-menu-btn { opacity: 0.72; }
 .automation-row:hover .row-menu-btn { opacity: 1; }
-.run-row { align-items: center; }
-.run-row-open {
-  appearance: none; border: 0; background: transparent; color: inherit; font: inherit;
-  text-align: left; padding: 0; cursor: pointer;
-}
-.run-row-open:disabled { cursor: default; }
-.run-row-open:not(:disabled):hover .automation-row-title strong { color: var(--accent); }
-.run-row-chevron {
-  display: grid; place-items: center; flex: none; width: 40px; min-height: 40px;
-  border: 0; border-radius: var(--radius-md); padding: 0; background: transparent;
-  color: var(--muted); font: inherit; font-size: 24px; line-height: 1; cursor: pointer;
-}
-.run-row-chevron:hover { color: var(--ink); background: var(--surface-2); }
 .runs-setup {
-  margin-top: 8px; border: 1px solid var(--line); border-radius: var(--radius-md);
+  margin-top: var(--space-6); border: 1px solid var(--line); border-radius: var(--radius-md);
   background: var(--surface); overflow: hidden;
 }
 .runs-setup > summary {
@@ -1894,16 +1894,13 @@ button.template-card.is-featured .template-card-icon {
 .runs-setup[open] .runs-setup-chevron { transform: rotate(90deg); }
 .runs-setup-body { display: flex; flex-direction: column; gap: 12px; padding: 14px; border-top: 1px solid var(--line); }
 .runs-setup-body .picker-search { max-width: 100%; box-sizing: border-box; }
-.runs-overview { margin-top: 18px; }
-.runs-overview .autom-section-head > div { min-width: 0; }
-.runs-overview .autom-section-head .settings-hint { margin: 3px 0 0; }
-/* Keep a single refresh action compact; stretching it to half the sheet makes
-   the run controls look like a form instead of a feed toolbar. */
-.runs-overview .autom-section-actions { justify-content: flex-end; }
-.runs-overview .autom-section-actions .btn { min-width: 96px; }
-.incoming-work { margin-top: 22px; }
-.incoming-work > .autom-section-label { margin-bottom: 8px; }
-.incoming-work > .settings-form { gap: 14px; }
+/* Runs feed: grouped like the session list (attention, in progress, by day). */
+.run-history { margin-top: var(--space-2); }
+.run-history .session-group-label { margin: 0; padding-inline: 0; }
+.run-history > .settings-form { gap: var(--space-2); padding: 0 0 var(--space-3); border-bottom: 1px solid var(--line); }
+.run-history > .settings-form:empty { display: none; }
+.run-history-failure { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.automation-history-row:disabled { cursor: default; }
 
 /* A runner is a first-class requirement, not a tiny select hidden under the
    prompt. Pairing/key readiness is visible before Save can become disabled. */
@@ -1955,14 +1952,6 @@ button.template-card.is-featured .template-card-icon {
 .run-timeline li span { color: var(--muted); font-size: 12px; }
 .run-timeline p { grid-column: 1 / -1; margin: 0; color: var(--muted); font-size: 12px; line-height: 1.4; }
 .run-timeline code { grid-column: 1 / -1; overflow-wrap: anywhere; font-size: 11px; }
-.run-history-filters {
-  display: flex; flex-wrap: wrap; gap: 6px; margin: 12px 0;
-}
-.run-history-filters .btn { white-space: nowrap; }
-@media (max-width: 479px) {
-  .run-history-filters { flex-wrap: nowrap; overflow-x: auto; margin-inline: -4px; padding-inline: 4px; scrollbar-width: none; }
-  .run-history-filters::-webkit-scrollbar { display: none; }
-}
 .run-details .run-sheet-failure { margin-top: 14px; border: 1px solid color-mix(in srgb, var(--danger) 35%, var(--line)); border-radius: var(--radius-md); }
 .run-details-receipt { margin-top: 18px !important; }
 .run-details-state {
@@ -2147,7 +2136,7 @@ button.template-card.is-featured .template-card-icon {
 .automation-detail-head .icon { flex-shrink: 0; }
 .automation-detail-head svg { width: var(--space-5); height: var(--space-5); }
 .automations-view.is-history .automations-view-body { flex: 1; padding: var(--space-5) var(--space-4); }
-.automation-history-view, .automation-history-view .runs-overview { margin-top: 0; }
+.automation-history-view { margin-top: 0; }
 .automation-history-row {
   display: flex; align-items: center; gap: var(--space-3); width: 100%;
   padding: var(--space-4) 0; border: 0; border-bottom: 1px solid var(--line);
@@ -2507,16 +2496,6 @@ a.queue-item:hover { border-color: var(--line-strong); background: var(--surface
   .automation-row-actions { width: auto; justify-content: flex-end; border-top: 0; padding-top: 0; }
   .automation-row-actions .btn { min-height: 40px; }
   .automation-row .row-menu-btn { min-width: 40px; min-height: 40px; opacity: 1; }
-  .run-row { align-items: flex-start; flex-wrap: wrap; }
-  .run-row .automation-row-main { flex-basis: 100%; }
-  .run-row .automation-row-actions { width: 100%; padding-top: 6px; }
-  .run-row-chevron { margin-left: auto; }
-  .runs-overview .autom-section-head { align-items: stretch; flex-direction: column; }
-  .runs-overview .autom-section-actions { display: grid; grid-template-columns: 1fr 1fr; width: 100%; }
-  /* Keep two actions balanced when needed, but don't make a lone Refresh button
-     occupy half the screen. */
-  .runs-overview .autom-section-actions:has(> :only-child) { display: flex; justify-content: flex-start; }
-  .runs-overview .autom-section-actions .btn { min-width: 96px; width: auto; }
   .queue-head { align-items: flex-start; gap: 10px; }
   .queue-head-actions { justify-content: flex-end; gap: 8px; min-width: 0; text-align: right; }
   .queue-head-actions .btn.link { overflow-wrap: anywhere; }
@@ -2617,15 +2596,6 @@ a.queue-item:hover { border-color: var(--line-strong); background: var(--surface
   transition: border-color 0.15s ease, box-shadow 0.15s ease;
 }
 .connect-option:hover { border-color: var(--line-strong); box-shadow: var(--shadow-md); }
-.connect-option-head { display: flex; align-items: flex-start; gap: 12px; }
-.connect-option-badge {
-  flex: none; width: 36px; height: 36px; display: grid; place-items: center;
-  border-radius: var(--radius-md); color: var(--accent);
-  background: color-mix(in srgb, var(--accent) 12%, transparent);
-}
-.connect-option-copy { min-width: 0; }
-.connect-option-copy h3 { margin: 1px 0 3px; font-size: 15px; }
-.connect-option-copy p { margin: 0; color: var(--muted); font-size: 13px; line-height: 1.45; }
 
 .connect-command {
   display: flex; align-items: center; gap: 8px; padding: 4px 4px 4px 12px;
@@ -2645,9 +2615,8 @@ a.queue-item:hover { border-color: var(--line-strong); background: var(--surface
 .connect-option-links { display: flex; flex-wrap: wrap; align-items: center; gap: var(--space-2); }
 .connect-option-link { align-self: flex-start; color: var(--accent); font-size: 12.5px; font-weight: 600; text-decoration: none; }
 .connect-option-link:hover { text-decoration: underline; }
-.connect-option-cta { align-self: flex-start; }
 /* A one-time "next step" card above the composer (automations, notifications). */
-.next-step { margin: 0 var(--space-4) var(--space-3); display: flex; align-items: center; justify-content: space-between; gap: var(--space-3); }
+.next-step { box-sizing: border-box; width: min(100% - 2 * var(--space-3), 800px - 2 * var(--space-3)); margin: 0 auto var(--space-3); display: flex; align-items: center; justify-content: space-between; gap: var(--space-3); }
 .next-step p { margin: var(--space-1) 0 0; color: var(--muted); font-size: var(--text-sm); }
 .next-step .banner { margin-top: var(--space-2); }
 .next-step .next-step-ok { margin: 0; color: var(--ok); font-weight: var(--weight-medium); }
@@ -3000,7 +2969,7 @@ textarea.picker-search { resize: vertical; font-family: ui-monospace, monospace;
 .node-switcher-btn.locked { cursor: default; }
 .node-switcher-name { max-width: 220px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 .node-switcher-caret { color: var(--muted); font-size: 9px; }
-.node-menu { position: absolute; left: 0; top: calc(100% + 6px); min-width: 220px; z-index: var(--z-dropdown); }
+.node-menu { position: absolute; left: 0; top: calc(100% + 6px); min-width: 220px; width: max-content; max-width: calc(100vw - var(--space-6)); z-index: var(--z-dropdown); }
 /* "Reconnecting…" line at the top of the open switcher, under the node the
    button shows — the dropdown's spelled-out counterpart to the spinner dot. */
 .node-menu-status { display: flex; align-items: center; gap: 8px; padding: 10px 14px; font-size: 13px; color: var(--muted); border-bottom: 1px solid var(--line); }
@@ -3015,6 +2984,8 @@ textarea.picker-search { resize: vertical; font-family: ui-monospace, monospace;
 .node-menu-item.active { font-weight: 600; }
 .node-menu-name { flex: 1; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 .node-menu-check { color: var(--accent); }
+/* Quiet trailing hint on a cloud row, e.g. "starts when you send". */
+.node-menu-meta { flex: none; color: var(--muted); font-size: var(--text-xs); }
 .node-menu-glyph { color: var(--accent); flex: none; }
 .eph-steps { margin: 4px 0; padding-left: 18px; color: var(--muted); font-size: 13px; display: grid; gap: 4px; }
 .code-snippet { margin: 6px 0 0; overflow: auto; border: 1px solid var(--line); border-radius: var(--radius-md); padding: 10px; background: var(--surface); font-size: 12px; }
@@ -3247,24 +3218,9 @@ p.setup-note .btn.link { min-height: 44px; margin-block: calc((1lh - 44px) / 2);
 .app-row-meta { color: var(--muted); font-size: var(--text-xs); line-height: var(--lh-xs); }
 .app-row-action { flex: none; display: flex; align-items: center; gap: var(--space-1); }
 .app-message { margin-block: var(--space-2); }
-/* Suggested task (SuggestionCard.tsx): a task the agent proposed, one tap to
-   start in its own session. Shell from .card; layout only here. */
-.suggestion-card { max-inline-size: 440px; display: flex; flex-direction: column; gap: var(--space-1); }
 /* The small label above a chat card's content, shared by every agent-posted card. */
-.suggestion-eyebrow, .delegation-eyebrow, .notice-eyebrow { margin: 0; color: var(--muted); font-size: var(--text-xs); font-weight: var(--weight-semibold); }
-.suggestion-title { margin: 0; font-size: var(--text-base); font-weight: var(--weight-semibold); overflow-wrap: anywhere; }
-.suggestion-text { margin: 0; color: var(--muted); font-size: var(--text-sm); white-space: pre-wrap; overflow-wrap: anywhere; display: -webkit-box; -webkit-line-clamp: 4; -webkit-box-orient: vertical; overflow: hidden; }
-.suggestion-text[data-expanded="true"] { display: block; overflow: visible; }
-.suggestion-actions { display: flex; flex-wrap: wrap; gap: var(--space-2); margin-top: var(--space-2); }
-.suggestion-bar, .suggestion-all { display: flex; flex-direction: column; gap: var(--space-1); margin-top: var(--space-2); }
-.suggestion-all { padding-top: var(--space-2); border-top: 1px solid var(--line); }
-.suggestion-bar .suggestion-actions, .suggestion-all .suggestion-actions { margin-top: 0; }
-.suggestion-hint { margin: 0; color: var(--muted); font-size: var(--text-xs); }
-/* In a set, the title is the checkbox's label, so the whole line is the tap target. */
-.suggestion-pick { display: flex; align-items: flex-start; gap: var(--space-2); cursor: pointer; }
-.suggestion-pick input { flex: none; inline-size: 18px; block-size: 18px; margin: 2px 0 0; accent-color: var(--accent); }
-.suggestion-status { margin: var(--space-2) 0 0; display: flex; align-items: center; gap: var(--space-2); color: var(--ok); font-size: var(--text-sm); font-weight: var(--weight-medium); }
-/* Notice (NoticeCard.tsx): a message the agent sent with `bivy notify`.
+.delegation-eyebrow, .notice-eyebrow { margin: 0; color: var(--muted); font-size: var(--text-xs); font-weight: var(--weight-semibold); }
+/* Notice (NoticeCard.tsx): a message from Bivy, e.g. applied automations.
    Shell and tone from .card, the urgent marker from .badge. */
 .notice-card { max-inline-size: 440px; display: flex; flex-direction: column; gap: var(--space-1); }
 .notice-eyebrow { display: flex; align-items: center; gap: var(--space-2); }
@@ -3629,21 +3585,13 @@ p.setup-note .btn.link { min-height: 44px; margin-block: calc((1lh - 44px) / 2);
 
   /* Compact, thumb-friendly automation list: the row is the editor link. */
   .automation-list { gap: var(--space-2); border: 0; }
-  .automation-row:not(.run-row) {
+  .automation-row {
     min-height: 0; padding: var(--space-3); border: 1px solid var(--line);
     border-radius: var(--radius-lg); background: var(--surface-2);
     grid-template-columns: 36px minmax(0, 1fr) auto; gap: var(--space-3);
     align-items: center;
   }
-  .run-row {
-    display: flex; flex-wrap: wrap; align-items: flex-start;
-    gap: var(--space-3); padding: var(--space-4);
-  }
-  .run-row-open { flex: 1 1 100%; min-width: 0; }
-  .run-row .automation-row-main { width: 100%; }
-  .run-row .automation-row-actions { width: 100%; justify-content: flex-start; flex-wrap: wrap; }
-  .run-row .run-row-chevron { margin-left: auto; }
-  .automation-row:not(.run-row):hover { background: var(--surface-3); }
+  .automation-row:hover { background: var(--surface-3); }
   .automation-row:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
   .automation-row-icon { width: 36px; height: 36px; }
   .automation-row-icon svg { width: 18px; height: 18px; }
@@ -3670,8 +3618,6 @@ p.setup-note .btn.link { min-height: 44px; margin-block: calc((1lh - 44px) / 2);
   .automation-history-view .autom-section-head { margin-bottom: var(--space-3); }
   .automation-history-view .automation-list { gap: var(--space-2); }
   .automation-history-view .automation-row { padding: var(--space-3); }
-  .automation-history-view .run-history-filters { flex-wrap: nowrap; overflow-x: auto; scrollbar-width: none; padding-bottom: var(--space-1); }
-  .automation-history-view .run-history-filters::-webkit-scrollbar { display: none; }
   .automations-view.is-history .automations-view-head-actions > .btn.primary { display: none; }
   .automation-history-view .autom-section-head { align-items: flex-start; gap: var(--space-3); }
   .automation-history-view .autom-section-head > strong { min-width: 0; line-height: var(--lh-lg); }
@@ -3687,3 +3633,22 @@ p.setup-note .btn.link { min-height: 44px; margin-block: calc((1lh - 44px) / 2);
   font-family: var(--font-serif);
   font-weight: var(--weight-medium);
 }
+/* A Vega-Lite chart an agent placed in a message. Vega owns the SVG inside
+   .chart-host, so nothing here styles its internals — colors come from the
+   tokens read in vega.ts, which is how the chart tracks light/dark. */
+.chart-component { margin: 0; }
+.chart-component .chart-host {
+  width: 100%; overflow-x: auto; -webkit-overflow-scrolling: touch; padding: 10px;
+  border: 1px solid var(--line); border-radius: var(--radius-sm); background: var(--surface);
+}
+.chart-component figcaption { margin-top: var(--space-2); }
+/* An app preview framed inside a message. Same bordered surface as a chart or
+   a mermaid diagram — all three are a figure in the prose, and should not read
+   as three different things. */
+.inline-app { margin: 0; }
+.inline-app-frame {
+  display: block; width: 100%; height: 420px; border: 1px solid var(--line);
+  border-radius: var(--radius-sm); background: var(--surface);
+}
+.inline-app figcaption { display: flex; gap: var(--space-2); align-items: baseline; justify-content: space-between; margin-top: var(--space-2); }
+.inline-app-open { flex: none; }