@bivy/bivy 0.20.9-staging.6 → 0.20.9-staging.8

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
 ```
 

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

@@ -39,18 +39,12 @@ export const BIVY_AGENT_NOTE = [
         "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/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%);
@@ -655,20 +661,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; } }
@@ -2647,7 +2639,7 @@ a.queue-item:hover { border-color: var(--line-strong); background: var(--surface
 .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); }
@@ -3249,24 +3241,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); }

package/dist/ephemeral-teardown.js

@@ -9,6 +9,7 @@ export function readEphemeralTeardownConfig(env = process.env) {
         onFinish: env.BIVY_TEARDOWN_ON_FINISH === "1",
         finishGraceMs: Number(env.BIVY_TEARDOWN_FINISH_GRACE_MS) || 10_000,
         idleGraceMs: Number(env.BIVY_SESSION_IDLE_CLOSE_MS) || 30 * 60 * 1000,
+        sleep: env.BIVY_EPHEMERAL_SLEEP === "1",
     };
 }
 /**
@@ -20,8 +21,10 @@ export function readEphemeralTeardownConfig(env = process.env) {
 export function shouldSelfTeardown(cfg, state) {
     if (!cfg.enabled)
         return false;
+    // A fresh box waits for its first work. A sleeping machine woken for
+    // nothing goes back to sleep after the idle window instead of running to TTL.
     if (!state.everBusy)
-        return false;
+        return cfg.sleep && state.idleForMs >= cfg.idleGraceMs;
     if (state.anyWorking || state.anyRemoteActive || state.inFlightWork > 0)
         return false;
     const grace = cfg.onFinish ? cfg.finishGraceMs : cfg.idleGraceMs;
@@ -50,6 +53,13 @@ export async function performSelfTeardown(deps) {
     torndown = true;
     const log = deps.log ?? ((m) => console.log(`[ephemeral-teardown] ${m}`));
     const exit = deps.exit ?? ((c) => process.exit(c));
+    if (deps.sleep) {
+        // Exit only: the provider keeps the stopped machine and its disk, and a
+        // wake starts it again. Signalling settled would get it reaped.
+        log(`machine idle — sleeping (provider=${deps.provider})`);
+        exit(0);
+        return;
+    }
     log(`machine idle — self-teardown (provider=${deps.provider})`);
     try {
         await deps.signalSettled?.();

package/dist/server.js

@@ -80,7 +80,6 @@ import { exportProviderAuth, exportAccountApiKeys, exportAccountOAuthCredentials
 import { listProviders } from "./runtime/provider-catalog.js";
 import { exportLocalModels, importLocalModels } from "./runtime/local-model-store.js";
 import { sessionLikeFields } from "./session/start-like.js";
-import { MAX_SUGGESTION_TEXT, MAX_SUGGESTION_TITLE, SUGGESTION_RUNS, isTaskSuggestion } from "./session/suggestions.js";
 import { BIVY_AGENT_NOTE, mergeSyncedAgentInstructions, readAgentInstructions, sessionInstructions, writeAgentInstructions, MAX_AGENT_INSTRUCTIONS_BYTES } from "./agent-instructions.js";
 import { execEphemeralRequest } from "./ephemeral-exec.js";
 import { ApprovalManager } from "./approval.js";
@@ -143,7 +142,7 @@ import { AgentQuestions, askQuestionsFrom } from "./session/agent-questions.js";
 import { AutomationProposals, describeChange } from "./session/automation-proposals.js";
 import { createSessionTokenCodec, isSessionToken, sessionTokenAllows } from "./session/session-tokens.js";
 import { setSessionTokenSigner } from "./runtime/session-env.js";
-import { MAX_NOTICE_TEXT, isAgentNotice, noticePush } from "./session/notices.js";
+import { MAX_NOTICE_TEXT, noticePush } from "./session/notices.js";
 import { createForkCommands } from "./controllers/fork-commands.js";
 import { createGithubCommands } from "./controllers/github-commands.js";
 import { createCredentialCommands } from "./controllers/credential-commands.js";
@@ -7643,6 +7642,7 @@ function evaluateEphemeralTeardown() {
         }
         await performSelfTeardown({
             provider: ephemeralTeardownCfg.provider,
+            sleep: ephemeralTeardownCfg.sleep,
             signalSettled: signalSettledToControlPlane,
             shutdown: () => { try {
                 spawnSync("shutdown", ["-h", "now"], { stdio: "ignore" });
@@ -7657,7 +7657,7 @@ if (ephemeralTeardownCfg.enabled) {
     const ephemeralEvalMs = Math.max(2_000, Math.min(ephemeralTeardownCfg.finishGraceMs, 15_000));
     const ephemeralTeardownTimer = setInterval(() => evaluateEphemeralTeardown(), ephemeralEvalMs);
     ephemeralTeardownTimer.unref?.();
-    console.log(`[ephemeral-teardown] armed: provider=${ephemeralTeardownCfg.provider} onFinish=${ephemeralTeardownCfg.onFinish} ttl=${ephemeralTeardownCfg.ttlMin}m`);
+    console.log(`[ephemeral-teardown] armed: provider=${ephemeralTeardownCfg.provider} onFinish=${ephemeralTeardownCfg.onFinish} sleep=${ephemeralTeardownCfg.sleep} ttl=${ephemeralTeardownCfg.ttlMin}m`);
 }
 setTimeout(() => void sweepDiskGuardrails(), 30_000).unref?.();
 // One sweep shortly after boot clears ghosts left by a previous run before any
@@ -11741,10 +11741,9 @@ app.get("/api/session/:id/context", (req, res) => {
         previewAvailable,
     }));
 });
-// `bivy notify "<message>"`: a card in the chat, and a push naming the session
-// (never the text) when nobody has the app open, or when it's urgent. At most
-// one push a minute per session; later notices still post a card. A `bivy run`
-// terminal has no chat to hold the card, so its notice is the push alone.
+// `bivy notify`: a push naming the session (never any text) when nobody has the
+// app open, or when it's urgent. At most one push a minute per session. It adds
+// nothing to the chat: what the agent has to say belongs in its reply there.
 const lastNotifyPush = new Map();
 app.post("/api/session/:id/notify", (req, res) => {
     const record = openSessions.get(String(req.params.id));
@@ -11752,16 +11751,9 @@ app.post("/api/session/:id/notify", (req, res) => {
     const sessionId = record?.id ?? run?.sessionId;
     if (!sessionId)
         return res.status(404).json({ error: "Session not found" });
-    const text = typeof req.body?.text === "string" ? req.body.text.trim() : "";
-    const notice = { id: `notice-${randomBytes(8).toString("hex")}`, text, ...(req.body?.urgent === true ? { urgent: true } : {}) };
-    if (!isAgentNotice(notice))
-        return res.status(400).json({ error: `A notice needs text (up to ${MAX_NOTICE_TEXT} characters).` });
-    if (record) {
-        eventLog.appendNotice(record.id, { afterMessageCount: record.session.getMessages().length, notice });
-        broadcast(stampSessionEvent({ type: "session.event", sessionId: record.id, event: { type: "notice", id: notice.id, notice } }));
-    }
+    const urgent = req.body?.urgent === true;
     const watching = Boolean(record) && (clients.size > 0 || (relay?.clientCount ?? 0) > 0);
-    const push = noticePush({ urgent: notice.urgent, userWatching: watching, lastPushAt: lastNotifyPush.get(sessionId), now: Date.now(), pushConfigured: Boolean(sessionAdvertiseTarget) });
+    const push = noticePush({ urgent, userWatching: watching, lastPushAt: lastNotifyPush.get(sessionId), now: Date.now(), pushConfigured: Boolean(sessionAdvertiseTarget) });
     if (push === "sent") {
         lastNotifyPush.set(sessionId, Date.now());
         void sendNotificationHint({
@@ -11769,10 +11761,10 @@ app.post("/api/session/:id/notify", (req, res) => {
             sessionId,
             targetSessionId: sessionId,
             title: sessionNotifyLabel(record, run?.name || "A terminal session"),
-            body: "Has a message for you — tap to read it.",
+            body: "Wants you to take a look — tap to open the session.",
         });
     }
-    res.json({ ok: true, id: notice.id, posted: Boolean(record), push, userWatching: watching });
+    res.json({ ok: true, push, userWatching: watching });
 });
 // `bivy ask`: the question card and "needs your input" push, for any agent.
 // Returns at once with an id; `/wait` blocks up to 240s per call (under common
@@ -11830,23 +11822,6 @@ app.post("/api/session/:id/title", (req, res) => {
     sessionNamer.setSessionName(record, title);
     res.json({ ok: true, title });
 });
-// `bivy suggest "<task>"`: the agent proposes a task the user can start in one
-// tap, here, through this agent's sub-agents, or in a parallel session; `run`
-// is the one the agent recommends (see packages/web SuggestionCard).
-app.post("/api/session/:id/suggest", (req, res) => {
-    const record = openSessions.get(String(req.params.id));
-    if (!record)
-        return res.status(404).json({ error: "Session not found" });
-    const text = typeof req.body?.text === "string" ? req.body.text.trim() : "";
-    const title = typeof req.body?.title === "string" && req.body.title.trim() ? req.body.title.trim() : undefined;
-    const run = req.body?.run || undefined;
-    const suggestion = { id: `suggestion-${randomBytes(8).toString("hex")}`, text, ...(title ? { title } : {}), ...(run ? { run } : {}) };
-    if (!isTaskSuggestion(suggestion))
-        return res.status(400).json({ error: `A suggestion needs text (up to ${MAX_SUGGESTION_TEXT} characters), an optional title (up to ${MAX_SUGGESTION_TITLE}) and an optional run (${SUGGESTION_RUNS.join(", ")}).` });
-    eventLog.appendSuggestion(record.id, { afterMessageCount: record.session.getMessages().length, suggestion });
-    broadcast(stampSessionEvent({ type: "session.event", sessionId: record.id, event: { type: "suggestion", id: suggestion.id, suggestion } }));
-    res.json({ ok: true, id: suggestion.id });
-});
 // Explicit child Run API for first-party/user-directed workflows. These routes
 // are intentionally not advertised to agents as tools; the service still
 // authorizes every status lookup against this parent Session's provenance.

package/dist/session/event-log.js

@@ -31,7 +31,6 @@ import path from "node:path";
 import { normalizedIntermediateText, thinkingTextFromContent, mergeTranscript } from "./transcript-merge.js";
 import { DELEGATION_BLOCK, isDelegationCard } from "./delegations.js";
 import { APP_PIN_BLOCK, APP_PUBLICATION_BLOCK, APP_REVIEW_BLOCK, isAppPin, isAppReference, isAppReview } from "../apps/types.js";
-import { SUGGESTION_BLOCK, isTaskSuggestion } from "./suggestions.js";
 import { NOTICE_BLOCK, isAgentNotice } from "./notices.js";
 /**
  * Decompose a transcript message into serialization-independent "atoms": the
@@ -333,12 +332,6 @@ function isAppPublication(value) {
     const entry = value;
     return entry.bivyKind === "app-publication" && typeof entry.id === "string" && typeof entry.createdAt === "number" && typeof entry.afterMessageCount === "number" && isAppReference(entry.app);
 }
-function isSuggestionEntry(value) {
-    if (!value || typeof value !== "object")
-        return false;
-    const entry = value;
-    return entry.bivyKind === "suggestion" && typeof entry.id === "string" && typeof entry.createdAt === "number" && typeof entry.afterMessageCount === "number" && isTaskSuggestion(entry.suggestion);
-}
 function isNoticeEntry(value) {
     if (!value || typeof value !== "object")
         return false;
@@ -364,7 +357,7 @@ function isAppPinEntry(value) {
     return entry.bivyKind === "app-pin" && typeof entry.id === "string" && typeof entry.createdAt === "number" && typeof entry.afterMessageCount === "number" && isAppPin(entry.pin);
 }
 function isRecord(value) {
-    return isDelegationEntry(value) || isOverlay(value) || isBase(value) || isForkDisplay(value) || isAttachment(value) || isOutboundAttachment(value) || isInlineImage(value) || isAppPublication(value) || isAppReviewEntry(value) || isAppPinEntry(value) || isSuggestionEntry(value) || isNoticeEntry(value);
+    return isDelegationEntry(value) || isOverlay(value) || isBase(value) || isForkDisplay(value) || isAttachment(value) || isOutboundAttachment(value) || isInlineImage(value) || isAppPublication(value) || isAppReviewEntry(value) || isAppPinEntry(value) || isNoticeEntry(value);
 }
 /**
  * Fold attachment records into a text→refs list: last write wins per text (a
@@ -507,15 +500,11 @@ export function replayExtras(entries) {
         role: "assistant", content: [{ type: DELEGATION_BLOCK, delegation: entry.delegation }],
         id: `delegation-${entry.id}`, afterMessageCount: entry.afterMessageCount, createdAt: entry.createdAt,
     }));
-    const suggestions = entries.filter((entry) => entry.bivyKind === "suggestion").map((entry) => ({
-        role: "assistant", content: [{ type: SUGGESTION_BLOCK, suggestion: entry.suggestion }],
-        id: entry.id, afterMessageCount: entry.afterMessageCount, createdAt: entry.createdAt,
-    }));
     const notices = entries.filter((entry) => entry.bivyKind === "notice").map((entry) => ({
         role: "assistant", content: [{ type: NOTICE_BLOCK, notice: entry.notice }],
         id: entry.id, afterMessageCount: entry.afterMessageCount, createdAt: entry.createdAt,
     }));
-    return [...foldIntermediate(intermediate), ...foldTool(tool), ...replayOutboundAttachments(entries), ...publications, ...cards, ...pinCards, ...delegationCards, ...suggestions, ...notices];
+    return [...foldIntermediate(intermediate), ...foldTool(tool), ...replayOutboundAttachments(entries), ...publications, ...cards, ...pinCards, ...delegationCards, ...notices];
 }
 /**
  * Fold the outbound (agent-sent) attachment records into time-anchored synthetic
@@ -832,10 +821,6 @@ export class EventLog {
         this.load(id);
         this.enqueue(id, `pin:${entry.pin.id}`, { bivyKind: "app-pin", createdAt: entry.createdAt ?? Date.now(), afterMessageCount: entry.afterMessageCount, id: entry.pin.id, pin: structuredClone(entry.pin) });
     }
-    appendSuggestion(id, entry) {
-        this.load(id);
-        this.enqueue(id, `suggestion:${entry.suggestion.id}`, { bivyKind: "suggestion", createdAt: Date.now(), afterMessageCount: entry.afterMessageCount, id: entry.suggestion.id, suggestion: { ...entry.suggestion } });
-    }
     appendNotice(id, entry) {
         this.load(id);
         this.enqueue(id, `notice:${entry.notice.id}`, { bivyKind: "notice", createdAt: Date.now(), afterMessageCount: entry.afterMessageCount, id: entry.notice.id, notice: { ...entry.notice } });

package/dist/session/session-tokens.js

@@ -44,7 +44,7 @@ export function createSessionTokenCodec(key = randomBytes(32)) {
  */
 export const SESSION_TOKEN_ROUTES = [
     { method: "GET", path: /^\/api\/session\/([^/]+)\/context$/, session: "path" },
-    { method: "POST", path: /^\/api\/session\/([^/]+)\/(attach|suggest|notify|title)$/, session: "path" },
+    { method: "POST", path: /^\/api\/session\/([^/]+)\/(attach|notify|title)$/, session: "path" },
     { method: "POST", path: /^\/api\/session\/([^/]+)\/ask$/, session: "path" },
     { method: "GET", path: /^\/api\/session\/([^/]+)\/ask\/[^/]+$/, session: "path" },
     { method: "POST", path: /^\/api\/session\/([^/]+)\/ask\/[^/]+\/wait$/, session: "path" },