@bivy/bivy 0.17.3-staging.9 → 0.18.0

package/dist/apps/styles.css

@@ -116,6 +116,10 @@ input, textarea, select { font-family: inherit; font-size: 16px; }
 }
 .menu-item:hover, .menu-item[aria-checked="true"], .menu-item.active { background: var(--surface-2); }
 .menu-item.danger { color: var(--danger); }
+.menu-item-label { flex: 1; min-width: 0; }
+.menu-item.separated { margin-top: var(--space-1); border-top: 1px solid var(--line); border-radius: 0 0 var(--radius-sm) var(--radius-sm); }
+/* A section title inside a menu (e.g. "Preview cards" above its choices). */
+.menu-heading { padding: var(--space-2) var(--space-3) var(--space-1); color: var(--muted); font-size: var(--text-xs); font-weight: var(--weight-semibold); letter-spacing: 0.04em; text-transform: uppercase; }
 
 /* ---- Feedback ---- */
 .toast {
@@ -588,6 +592,12 @@ input, textarea, select { font-family: inherit; font-size: 16px; }
    discoverability pattern as .row-menu-btn — and a touch-friendly baseline
    opacity on devices with no hover. */
 .assistant-row { align-self: stretch; width: 100%; max-width: 680px; }
+/* The message "Show in chat" landed on (Artifacts / Apps pages). */
+.is-jump-target { border-radius: var(--radius-md); animation: jump-target 2.4s var(--ease-standard); }
+@keyframes jump-target {
+  0%, 50% { background: color-mix(in srgb, var(--accent) 10%, transparent); box-shadow: 0 0 0 var(--space-2) color-mix(in srgb, var(--accent) 10%, transparent); }
+  100% { background: transparent; box-shadow: 0 0 0 var(--space-2) transparent; }
+}
 .msg-actions { display: flex; align-items: center; gap: 2px; margin-top: var(--space-1); margin-left: -6px; }
 .msg-copy-btn, .msg-speak-btn {
   border: 0; background: transparent; color: var(--muted);
@@ -1271,6 +1281,7 @@ button.sheet-action:last-child { border-bottom: 0; }
 .fork-select-field select { width: 100%; padding: 10px 12px; border: 1px solid var(--line-strong); border-radius: var(--radius-md); background: var(--surface); color: var(--ink); }
 .fork-toggle { display: flex; align-items: center; gap: 8px; padding: 10px 12px; font-size: 13px; color: var(--ink); }
 .fork-toggle input { width: 16px; height: 16px; }
+.fork-note { margin: 0; padding: var(--space-2) var(--space-3); color: var(--muted); font-size: var(--text-sm); line-height: var(--lh-sm); }
 .fork-error { margin: 4px 12px; padding: 8px 10px; border-radius: var(--radius-md); background: var(--surface-2); color: var(--danger); font-size: 12px; }
 .fork-warn { margin: 4px 12px; padding: 8px 10px; border-radius: var(--radius-md); background: var(--surface-2); color: var(--muted); font-size: 12px; }
 .fork-submit { width: calc(100% - 24px); margin: var(--space-2) var(--space-3); }
@@ -1395,7 +1406,12 @@ button.sheet-action:last-child { border-bottom: 0; }
   font-weight: var(--weight-semibold); cursor: pointer; white-space: nowrap;
 }
 .seg-btn:hover { color: var(--ink); }
-.seg-btn[aria-selected="true"] { background: var(--surface); color: var(--accent); box-shadow: var(--shadow-sm); }
+.seg-btn[aria-selected="true"], .seg-btn[aria-checked="true"] { background: var(--surface); color: var(--accent); box-shadow: var(--shadow-sm); }
+/* Chat | Terminal in the session topbar (SessionViewToggle). */
+.topbar-subline { display: flex; align-items: center; gap: var(--space-3); min-width: 0; margin-top: 2px; }
+.topbar-subline .node-switcher { flex: 0 1 auto; }
+.session-view-toggle { flex: none; padding: 2px; }
+.session-view-toggle .seg-btn { display: inline-flex; align-items: center; gap: var(--space-1); padding: 2px var(--space-2); line-height: 1.25; }
 .automations-tabs {
   flex: none; align-self: center; max-width: calc(100% - var(--space-6));
   margin: var(--space-2) auto 0; overflow-x: auto;
@@ -1411,6 +1427,51 @@ button.sheet-action:last-child { border-bottom: 0; }
   .automations-view-head-actions > .btn.primary { padding: 9px 18px; }
   .automations-view-body { padding: 8px 24px max(48px, env(safe-area-inset-bottom)); }
 }
+/* Artifacts / Apps pages (LibraryView.tsx) share the Automations page shell:
+   a quiet image grid for files, a plain list for apps. */
+.library-view:focus { outline: none; }
+.library-view .automations-view-head { width: 100%; max-width: 1080px; margin: 0 auto; box-sizing: border-box; }
+.library-body { max-width: 1080px; }
+.library-toolbar { display: flex; margin: var(--space-2) 0 var(--space-4); }
+.library-loading { display: flex; justify-content: center; padding: var(--space-8) 0; }
+.library-body > .banner { margin: var(--space-2) 0; }
+.library-note { margin: var(--space-2) 0; font-size: var(--text-sm); color: var(--muted); }
+.library-grid {
+  list-style: none; margin: var(--space-2) 0 0; padding: 0;
+  display: grid; gap: var(--space-5) var(--space-3);
+  grid-template-columns: repeat(auto-fill, minmax(150px, 1fr));
+}
+.library-tile { display: flex; flex-direction: column; gap: var(--space-2); min-width: 0; }
+.library-tile-preview {
+  width: 100%; aspect-ratio: 4 / 3; padding: 0; overflow: hidden;
+  display: grid; place-items: center;
+  border: 1px solid var(--line); border-radius: var(--radius-lg);
+  background: var(--surface-2); color: var(--muted); font: inherit; cursor: pointer;
+  transition: border-color var(--dur-fast) var(--ease-standard);
+}
+.library-tile-preview:hover:not(:disabled) { border-color: var(--line-strong); }
+.library-tile-preview:disabled { cursor: progress; }
+.library-tile-preview img { display: block; width: 100%; height: 100%; object-fit: cover; }
+.library-tile-file { display: flex; flex-direction: column; align-items: center; gap: var(--space-1); }
+.library-tile-ext { font-size: var(--text-xs); font-weight: var(--weight-semibold); letter-spacing: 0.04em; }
+.library-tile-caption { display: flex; flex-direction: column; gap: 2px; min-width: 0; padding: 0 2px; }
+.library-tile-name {
+  overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
+  font-size: var(--text-sm); font-weight: var(--weight-medium); color: var(--ink);
+}
+.library-tile-note { font-size: var(--text-xs); color: var(--danger); }
+.library-source {
+  align-self: flex-start; display: inline-flex; align-items: center; gap: var(--space-1);
+  max-width: 100%; min-width: 0; min-height: 28px; padding: 0; border: 0; background: transparent;
+  color: var(--muted); font: inherit; font-size: var(--text-xs); text-align: left; cursor: pointer;
+}
+.library-source:hover { color: var(--ink); }
+.library-source svg, .library-source-when { flex: none; }
+.library-source-name { min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+@media (min-width: 640px) {
+  .library-grid { grid-template-columns: repeat(auto-fill, minmax(200px, 1fr)); gap: var(--space-6) var(--space-4); }
+}
+
 .autom-section { margin-top: 26px; }
 .autom-section-head {
   display: flex; align-items: center; justify-content: space-between; gap: 10px;
@@ -2445,6 +2506,12 @@ textarea.picker-search { resize: vertical; font-family: ui-monospace, monospace;
   height: var(--app-h, 100dvh); z-index: var(--z-sheet); display: flex; flex-direction: column;
   background: var(--bg); padding-top: env(safe-area-inset-top);
 }
+/* The same terminal inside the session pane (Chat | Terminal toggle): in the
+   main column's flow under the topbar, not a fixed full-screen layer. */
+.term-overlay.term-embedded {
+  position: relative; top: auto; left: auto; width: auto; height: auto;
+  flex: 1 1 auto; min-height: 0; z-index: auto; padding-top: 0;
+}
 .term-head { display: flex; align-items: center; gap: 10px; padding: 10px 14px; border-bottom: 1px solid var(--line); }
 .term-title { font-weight: 700; flex: 0 1 auto; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 .term-status { color: var(--muted); font-weight: 400; margin-left: 8px; font-size: 12px; }
@@ -2492,6 +2559,10 @@ textarea.picker-search { resize: vertical; font-family: ui-monospace, monospace;
 }
 .term-out .xterm { height: 100%; }
 .term-out .xterm-viewport { overflow-y: auto; overscroll-behavior: contain; }
+/* xterm.css paints the viewport #000; the GPU renderers cover it with the theme
+   background, the DOM fallback does not — a light-theme sliver below the last
+   row. Match readTheme()'s background. */
+.term-out .xterm .xterm-viewport { background-color: var(--bg); }
 /* Smooth momentum scrolling for the terminal viewport on touch devices. */
 .term-out .xterm-viewport { -webkit-overflow-scrolling: touch; scrollbar-width: thin; }
 
@@ -2834,6 +2905,8 @@ select.picker-search { appearance: auto; }
 .setup-card p { color: var(--ink); margin: 8px 0; }
 .setup-card .muted { color: var(--muted); font-size: 13px; }
 .setup-foot { margin-top: 18px; }
+.setup-foot a { color: var(--accent); }
+.setup-foot a:hover { color: var(--accent-hover); }
 .btn.block { display: block; width: 100%; text-align: center; text-decoration: none; margin-top: 12px; padding: 11px; }
 .setup-or { color: var(--muted); font-size: 13px; margin: 16px 0 8px; }
 .setup-email { display: flex; flex-direction: column; gap: 8px; }
@@ -2842,6 +2915,9 @@ select.picker-search { appearance: auto; }
 .setup-email .btn { width: 100%; white-space: nowrap; min-height: var(--space-7); }
 .setup-note { margin-top: 10px; word-break: break-word; }
 .setup-note .btn { min-height: var(--space-7); }
+/* Inline text actions flow with the sentence: negative block margins keep the
+   44px touch target from stretching the paragraph's line box. */
+p.setup-note .btn.link { min-height: 44px; margin-block: calc((1lh - 44px) / 2); padding-block: 0; font: inherit; vertical-align: middle; }
 .setup-error { margin: 8px 0 4px; padding: 10px 12px; border: 1px solid var(--danger); border-left-width: 3px; border-radius: var(--radius-md); background: var(--danger-soft, transparent); color: var(--ink); font-size: 13px; line-height: 1.4; text-align: left; }
 /* Setup / connect surfaces prefer a little vertical rhythm on inline banners. */
 .setup-card .banner.inline,
@@ -2852,6 +2928,9 @@ select.picker-search { appearance: auto; }
 .scrim { position: fixed; inset: 0; background: var(--overlay); z-index: var(--z-dropdown); }
 @media (max-width: 900px) {
   .app { grid-template-columns: 1fr; }
+  /* Share the subtitle line with the machine name: icons only (the accessible
+     name stays via aria-label). */
+  .session-view-label { display: none; }
   .only-mobile { display: inline-flex; }
   .sidebar {
     position: fixed; top: var(--app-top, 0px); left: 0; height: var(--app-h, 100dvh);
@@ -2953,18 +3032,86 @@ select.picker-search { appearance: auto; }
 
 /* Artifacts sheet (components/ArtifactsSheet.tsx) — agent-sent attachments,
    user uploads, and resolved inline images grouped by kind. */
-.app-views-heading { display: flex; align-items: center; justify-content: space-between; gap: var(--space-3); }
-.app-views-heading .artifact-name, .app-message .artifact-name { white-space: normal; overflow-wrap: anywhere; }
-.app-view-row { flex-wrap: wrap; }
-.app-views-heading > .btn, .app-view-actions .btn { min-block-size: var(--space-7); flex-shrink: 0; }
-.app-view-actions { display: flex; flex-wrap: wrap; justify-content: flex-end; gap: var(--space-2); margin-inline-start: auto; }
-.app-view-notice { display: flex; flex-direction: column; gap: var(--space-2); flex-basis: 100%; min-width: 0; }
-.app-view-notes { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: var(--space-1); font-size: var(--text-sm); overflow-wrap: anywhere; }
+/* An app, a view of it, or a server that could become one (AppRow.tsx): the
+   same tile, type and trailing action in the chat card, the Apps page and the
+   Apps sheet. Views nest inside their app's card as small rows. */
+.apps-card { border: 1px solid var(--line); border-radius: var(--radius-md); background: var(--surface); overflow-wrap: anywhere; }
+.apps-list { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: var(--space-2); }
+.app-row { display: flex; align-items: center; gap: var(--space-3); min-width: 0; padding: var(--space-3); }
+.app-tile { flex: none; display: grid; place-items: center; inline-size: 40px; block-size: 40px; border: 1px solid var(--line); border-radius: var(--radius-md); background: var(--surface-2); color: var(--ink); font-weight: var(--weight-semibold); }
+.app-row.small .app-tile { inline-size: 36px; block-size: 36px; border-radius: var(--radius-sm); color: var(--muted); }
+.app-tile-port { font-family: var(--font-mono); font-size: var(--text-xs); color: var(--ok); }
+.app-row-text { flex: 1; min-width: 0; display: flex; flex-direction: column; gap: 2px; }
+.app-row-name { font-size: var(--text-base); font-weight: var(--weight-semibold); }
+.app-row.small .app-row-name { font-size: var(--text-sm); }
+.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); }
+/* Review card (ReviewCard.tsx): the app at a moment worth judging. The
+   screenshot is shown whole, phone-shaped, on a quiet stage; Before/Now is the
+   canonical .segmented switch; one primary action. */
+.review-card { margin-block: var(--space-2); max-inline-size: 440px; }
+.review-stage { display: flex; flex-direction: column; align-items: center; gap: var(--space-2); margin: 0 var(--space-3); padding: var(--space-3); border-radius: var(--radius-md); background: var(--surface-2); }
+.review-shot { display: grid; place-items: center; padding: 0; border: 1px solid var(--line); border-radius: var(--radius-md); background: var(--bg); overflow: hidden; cursor: zoom-in; box-shadow: var(--shadow-sm); }
+.review-shot img { display: block; inline-size: auto; block-size: auto; max-inline-size: 100%; max-block-size: min(300px, 40vh); }
+.review-loading { display: grid; place-items: center; inline-size: 139px; block-size: min(300px, 40vh); max-inline-size: 100%; }
+.review-gone { margin: 0; padding: var(--space-6) var(--space-3); color: var(--muted); font-size: var(--text-sm); text-align: center; }
+.review-side .seg-btn { min-block-size: 44px; min-inline-size: 72px; }
+.review-banner { margin: 0 var(--space-3); }
+.review-note { margin: var(--space-3) var(--space-3) 0; padding-inline-start: var(--space-3); border-inline-start: 2px solid var(--line-strong); color: var(--ink); font-size: var(--text-sm); white-space: pre-wrap; }
+.review-status { margin: var(--space-2) var(--space-3) 0; color: var(--muted); font-size: var(--text-sm); }
+.review-actions { display: flex; padding: var(--space-3); }
+.review-actions .btn { flex: 1; min-block-size: 44px; }
+
+/* Apps sheet (AppsSheet.tsx): one card per app, its views nested, one primary
+   action per view; secondary tools as quiet icon buttons; rare or destructive
+   actions behind ⋯ (MoreMenu, the canonical .menu). Status uses .banner. */
+.apps-sheet { display: flex; flex-direction: column; gap: var(--space-4); padding: var(--space-2) var(--space-2) var(--space-4); }
+.apps-state { display: flex; align-items: center; justify-content: center; gap: var(--space-2); padding: var(--space-6) 0; color: var(--muted); font-size: var(--text-sm); }
+.apps-group { display: flex; flex-direction: column; gap: var(--space-2); }
+.apps-group-title { margin: 0; padding: 0 var(--space-1); color: var(--muted); font-size: var(--text-xs); font-weight: var(--weight-semibold); letter-spacing: 0.04em; text-transform: uppercase; }
+.apps-view { display: flex; flex-direction: column; border-top: 1px solid var(--line); }
+.apps-cmd { display: block; margin: 0 var(--space-3) var(--space-3); padding: var(--space-2) var(--space-3); border-radius: var(--radius-sm); background: var(--surface-2); color: var(--ink); font-family: var(--font-mono); font-size: var(--text-xs); white-space: pre-wrap; overflow-wrap: anywhere; }
+.apps-view-tools { display: flex; flex-wrap: wrap; align-items: center; gap: 0; padding: 0 var(--space-1) var(--space-1); }
+.apps-view-tools .btn { gap: 6px; padding-inline: var(--space-2); color: var(--muted); }
+.apps-view-tools .btn:hover:not(:disabled) { color: var(--ink); }
+.apps-more { position: relative; }
+.apps-view-tools .apps-more { margin-inline-start: auto; }
+.apps-more-menu { position: absolute; right: 0; top: calc(100% + var(--space-1)); z-index: var(--z-dropdown); }
+.apps-notice { display: flex; align-items: flex-start; gap: var(--space-2); margin: 0 var(--space-3) var(--space-3); padding: var(--space-2) var(--space-3); border-radius: var(--radius-sm); background: color-mix(in srgb, var(--ok) 12%, transparent); font-size: var(--text-sm); }
+.apps-notice > svg { flex: none; margin-top: 1px; color: var(--ok); }
+.apps-notes { display: flex; flex-direction: column; gap: var(--space-2); margin: 0 var(--space-3) var(--space-3); padding-top: var(--space-3); border-top: 1px dashed var(--line); }
+.apps-notes-head { display: flex; align-items: center; gap: var(--space-2); color: var(--muted); font-size: var(--text-xs); font-weight: var(--weight-semibold); letter-spacing: 0.04em; text-transform: uppercase; }
+.apps-count { min-inline-size: 18px; padding: 0 6px; border-radius: var(--radius-full); background: var(--surface-3); color: var(--ink); text-align: center; letter-spacing: 0; }
+.apps-notes ul { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: var(--space-2); }
+.apps-note { display: flex; flex-direction: column; gap: 2px; padding-inline-start: var(--space-3); border-inline-start: 2px solid var(--line-strong); }
+.apps-note-text { color: var(--ink); font-size: var(--text-sm); }
+.apps-notes-actions { display: flex; gap: var(--space-2); }
+.apps-empty { display: flex; flex-direction: column; align-items: center; gap: var(--space-2); padding: var(--space-6) var(--space-4); color: var(--muted); font-size: var(--text-sm); text-align: center; }
+.apps-empty strong { color: var(--ink); font-size: var(--text-base); }
+.apps-empty p { margin: 0; max-inline-size: 34ch; }
+.apps-foot { margin: 0; padding: 0 var(--space-1); color: var(--muted); font-size: var(--text-xs); line-height: var(--lh-xs); }
 /* Peek: an app preview framed in a drawer over the chat (PreviewPeek.tsx). */
 .preview-peek { display: block; inline-size: 100%; block-size: 100%; border: 0; border-radius: var(--radius-md); background: var(--bg); }
+/* Share-sheet landing (ShareDestinationSheet.tsx): what was shared, then one
+   row per destination — AppRow, with the session's app preview when it has one. */
+.share-sheet { display: flex; flex-direction: column; gap: var(--space-3); }
+.share-shared { display: flex; flex-direction: column; gap: var(--space-2); margin: 0; }
+.share-thumbs { display: flex; gap: var(--space-2); overflow-x: auto; }
+.share-thumb { flex: none; block-size: 96px; inline-size: auto; max-inline-size: 160px; object-fit: cover; border: 1px solid var(--line); border-radius: var(--radius-md); background: var(--surface-2); }
+.share-dests { display: flex; flex-direction: column; gap: var(--space-1); }
+.share-dest { display: block; inline-size: 100%; padding: 0; border: 1px solid var(--line); border-radius: var(--radius-md); background: var(--surface); color: inherit; font: inherit; text-align: start; cursor: pointer; }
+.share-dest:hover { background: var(--surface-2); }
+.share-dest .app-row { min-block-size: 44px; }
+.preview-peek-stage { position: relative; block-size: 100%; }
+/* Point and speak: the recording bar floats over the top of the preview while
+   the finger stays on the shell's mic, so nothing under it moves. */
+/* Draw: making the marked-up picture, or the choice when screenshots are off. */
+.preview-marking { position: absolute; inset-inline: var(--space-2); bottom: var(--space-2); z-index: var(--z-sticky); box-shadow: var(--shadow-lg); border-radius: var(--radius-md); background: var(--surface); }
+.preview-marking .banner { margin: 0; }
+.preview-marking .banner-actions { flex-wrap: wrap; }
+.preview-voice { position: absolute; inset-inline: var(--space-2); top: var(--space-2); z-index: var(--z-sticky); padding: var(--space-1) var(--space-2); border: 1px solid var(--line-strong); border-radius: var(--radius-full); background: var(--surface); box-shadow: var(--shadow-lg); }
 .app-terminal-status { padding: var(--space-2) var(--space-4); margin: 0; color: var(--muted); font-size: var(--text-sm); }
-.app-view-command { overflow-wrap: anywhere; white-space: pre-wrap; font-size: var(--text-xs); color: var(--muted); }
-.app-view-row .artifact-main { flex-basis: 60%; }
 .artifacts-group { display: flex; flex-direction: column; gap: 8px; margin-bottom: 16px; }
 .artifacts-group:last-child { margin-bottom: 0; }
 .artifacts-group-title { font-size: 12px; font-weight: 600; opacity: 0.6; text-transform: uppercase; letter-spacing: 0.04em; }
@@ -3201,3 +3348,8 @@ select.picker-search { appearance: auto; }
   .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); }
 }
+
+/* Handoff notes above the composer (HandoffBanner, StandbyNotice): shaped like
+   the composer itself, with one line of another device's draft. */
+.handoff-banner { border-radius: var(--radius-md); }
+.handoff-preview { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }

package/dist/apps/tokens.css

@@ -62,6 +62,12 @@
   --s-github: #24292f; --s-slack: #7c2d92; --s-linear: #5e6ad2; --s-schedule: #0e7490;
   --s-webhook: #6d28d9; --s-manual: #b45309; --s-cli: #3f6212; --s-app: #64748b;
 
+  /* ---- Annotation: marks drawn over an app preview. The same in both themes
+     (the app underneath has its own), vivid and rare in real UIs, with a white
+     halo so it reads on light and dark pages. The node composites it too. ---- */
+  --annotate: #ff2d78;
+  --annotate-halo: #ffffff;
+
   /* ---- Terminal text selection ---- */
   --term-selection: rgba(63, 99, 119, 0.30);
   --term-selection-inactive: rgba(63, 99, 119, 0.20);

package/dist/apps/types.js

@@ -1,5 +1,22 @@
 // SPDX-License-Identifier: AGPL-3.0-only
 // Copyright (c) 2026 Petter André Sjulstad
+export const REVIEW_CARD_MODES = ["ready", "every", "off"];
+export const APP_REVIEW_BLOCK = "bivy_app_review";
+const isShot = (value) => {
+    const shot = value;
+    return !!shot && typeof shot.hash === "string" && /^[0-9a-f]{64}$/.test(shot.hash) && [shot.size, shot.width, shot.height].every((n) => typeof n === "number" && n >= 0);
+};
+export function isAppReview(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const review = value;
+    return typeof review.id === "string" && typeof review.sessionId === "string" && typeof review.appId === "string" && /^[a-f0-9]{32}$/.test(review.appId)
+        && typeof review.viewId === "string" && typeof review.name === "string" && typeof review.view === "string" && typeof review.path === "string"
+        && (review.trigger === "present" || review.trigger === "run" || review.trigger === "asked" || review.trigger === "notes") && typeof review.at === "number"
+        && (review.shot === undefined || isShot(review.shot)) && (review.before === undefined || isShot(review.before))
+        && (review.note === undefined || typeof review.note === "string")
+        && (review.notes === undefined || (Number.isInteger(review.notes) && review.notes >= 0));
+}
 export const APP_PUBLICATION_BLOCK = "bivy_app";
 export function isAppReference(value) {
     if (!value || typeof value !== "object")

package/dist/attach.js

@@ -1,5 +1,6 @@
 // SPDX-License-Identifier: AGPL-3.0-only
 // Copyright (c) 2026 Petter André Sjulstad
+import { hostname } from "node:os";
 import { StringDecoder } from "node:string_decoder";
 import { WebSocket } from "ws";
 /**
@@ -50,6 +51,9 @@ const TTY_MODE_RESET = "\x1b[?1049l" + // leave the alternate screen
     "\x1b[?1l\x1b>" + // cursor keys + keypad back to normal mode
     "\x1b[?25h" + // cursor visible
     "\x1b[0m"; // reset colors/attributes
+/** How this terminal names itself to the node, so other devices can say where a
+ *  session was last driven ("Terminal on my-laptop"). */
+const DEVICE = { id: `terminal:${hostname()}`, label: `Terminal on ${hostname()}` };
 function parseArgs(argv) {
     let url = process.env.BIVY_URL || `http://localhost:${process.env.PORT || "4317"}`;
     let token = process.env.BIVY_DEVICE_TOKEN || undefined;
@@ -102,6 +106,9 @@ function bridge(args, open) {
         let bound = false;
         let detachArmed = 0;
         let settled = false;
+        // Set while the session this terminal showed is continuing as a chat in the
+        // app: the next key decides whether to take it back here or leave.
+        let handedToChat;
         const inputDecoder = new StringDecoder("utf8");
         const stdin = process.stdin;
         const wasRaw = stdin.isTTY ? stdin.isRaw : false;
@@ -144,6 +151,21 @@ function bridge(args, open) {
                 socket.send(JSON.stringify(payload));
         };
         const onInput = (data) => {
+            if (handedToChat) {
+                const sessionId = handedToChat;
+                handedToChat = undefined;
+                if (data[0] !== 0x0d && data[0] !== 0x0a) {
+                    finish(0);
+                    return;
+                }
+                // Reopen the chat's own TUI, resuming the same conversation; the node
+                // locks the chat again and every device sees the handoff.
+                process.stdout.write(c.dim("Taking it back…\r\n"));
+                modesReset = false;
+                const { cols, rows } = termSize();
+                send({ kind: "terminal.open.tui", sessionId, cols, rows });
+                return;
+            }
             // Ctrl-\ (0x1c) twice in a row detaches, leaving the daemon session alive.
             if (data.length === 1 && data[0] === 0x1c) {
                 const now = Date.now();
@@ -212,6 +234,17 @@ function bridge(args, open) {
                 if (typeof msg.data === "string")
                     process.stdout.write(msg.data);
             }
+            else if (type === "terminal.closed" && msg.reason === "chat" && msg.termId === termId) {
+                resetModes();
+                termId = undefined;
+                process.stdout.write(c.dim("\r\n[continued as chat in the Bivy app]\r\n"));
+                if (typeof msg.sessionId !== "string" || !msg.sessionId) {
+                    finish(0);
+                    return;
+                }
+                handedToChat = msg.sessionId;
+                process.stdout.write(`Press ${c.bold("Enter")} to take it back here, or any other key to leave.\r\n`);
+            }
             else if ((type === "terminal.exit" || type === "terminal.closed") && msg.termId === termId) {
                 const code = typeof msg.code === "number" ? msg.code : 0;
                 resetModes();
@@ -220,7 +253,7 @@ function bridge(args, open) {
             }
             else if (type === "terminal.error") {
                 process.stderr.write(c.red(`\r\n${String(msg.error || "Terminal error")}\r\n`));
-                if (!bound)
+                if (!bound || !termId)
                     finish(1);
             }
         });
@@ -247,7 +280,7 @@ function openDetached(args, spec, cols, rows) {
             catch { }
             resolve(code);
         };
-        socket.on("open", () => socket.send(JSON.stringify({ kind: "terminal.open.run", agent: spec.agent, label: spec.label, name: spec.name, model: spec.model, command: spec.command, args: spec.args ?? [], workspace: spec.workspace, sessionId: spec.sessionId, cols, rows })));
+        socket.on("open", () => socket.send(JSON.stringify({ kind: "terminal.open.run", agent: spec.agent, label: spec.label, name: spec.name, model: spec.model, command: spec.command, args: spec.args ?? [], workspace: spec.workspace, sessionId: spec.sessionId, cols, rows, device: DEVICE })));
         socket.on("error", (err) => {
             process.stderr.write(c.red(`Connection error: ${err instanceof Error ? err.message : String(err)}\n`));
             finish(1);
@@ -283,7 +316,7 @@ async function main() {
             process.exit(await openDetached(args, spec, cols, rows));
         }
         process.stdout.write(c.dim(`Starting ${c.cyan(spec.name || spec.label || spec.agent || spec.command)} — Ctrl-\\ Ctrl-\\ to detach\r\n`));
-        const code = await bridge(args, (ws) => ws.send(JSON.stringify({ kind: "terminal.open.run", agent: spec.agent, label: spec.label, name: spec.name, model: spec.model, command: spec.command, args: spec.args ?? [], workspace: spec.workspace, sessionId: spec.sessionId, cols, rows })));
+        const code = await bridge(args, (ws) => ws.send(JSON.stringify({ kind: "terminal.open.run", agent: spec.agent, label: spec.label, name: spec.name, model: spec.model, command: spec.command, args: spec.args ?? [], workspace: spec.workspace, sessionId: spec.sessionId, cols, rows, device: DEVICE })));
         process.exit(code);
     }
     // attach
@@ -297,7 +330,7 @@ async function main() {
 async function attachById(args, termId) {
     const { cols, rows } = termSize();
     process.stdout.write(c.dim(`Attaching to ${c.cyan(termId)} — Ctrl-\\ Ctrl-\\ to detach\r\n`));
-    const code = await bridge({ ...args, termId }, (ws) => ws.send(JSON.stringify({ kind: "terminal.attach", termId, cols, rows })));
+    const code = await bridge({ ...args, termId }, (ws) => ws.send(JSON.stringify({ kind: "terminal.attach", termId, cols, rows, device: DEVICE })));
     process.exit(code);
 }
 main().catch((error) => {

package/dist/controllers/app-commands.js

@@ -6,7 +6,7 @@ export function createAppCommands(service, workspaceFor, published = () => { })
         return workspace;
     };
     const operations = {
-        "apps.list": (msg) => service.list(String(msg.sessionId)),
+        "apps.list": (msg) => service.list(typeof msg.sessionId === "string" ? msg.sessionId : undefined),
         "apps.publish": (msg) => {
             const sessionId = String(msg.sessionId);
             const app = service.publish(sessionId, workspaceOf(sessionId), msg.manifest);
@@ -20,18 +20,30 @@ export function createAppCommands(service, workspaceFor, published = () => { })
             published(app);
             return { app };
         },
-        "apps.open": (msg) => service.open(String(msg.sessionId), String(msg.appId), String(msg.viewId), typeof msg.returnTo === "string" ? msg.returnTo : undefined, msg.direct === true, typeof msg.scale === "number" ? msg.scale : undefined),
+        "apps.open": (msg) => service.open(String(msg.sessionId), String(msg.appId), String(msg.viewId), typeof msg.returnTo === "string" ? msg.returnTo : undefined, msg.direct === true, typeof msg.scale === "number" ? msg.scale : undefined, typeof msg.path === "string" ? msg.path : undefined),
         "apps.shot": (msg) => service.shot(String(msg.sessionId), typeof msg.appId === "string" ? msg.appId : undefined, { widths: msg.widths, themes: msg.themes, path: typeof msg.path === "string" ? msg.path : undefined }),
+        "apps.input": (msg) => service.act(String(msg.sessionId), typeof msg.target === "string" ? msg.target : undefined, msg.action),
+        "apps.menu": (msg) => service.menu(String(msg.sessionId), typeof msg.target === "string" ? msg.target : undefined, msg.path),
+        "apps.present": (msg) => service.present(String(msg.sessionId), { target: typeof msg.target === "string" ? msg.target : undefined, path: typeof msg.path === "string" ? msg.path : undefined, note: typeof msg.note === "string" ? msg.note : undefined }),
+        "apps.showMe": (msg) => service.present(String(msg.sessionId), { target: typeof msg.appId === "string" ? msg.appId : undefined, trigger: "asked" }),
+        "apps.mute": (msg) => service.mute(String(msg.sessionId)),
+        "apps.reviewMode": (msg) => service.setReviewMode(String(msg.sessionId), String(msg.appId), msg.mode),
+        "apps.annotate": (msg) => service.annotate(String(msg.sessionId), msg),
         "apps.clearNotes": (msg) => service.clearNotes(String(msg.sessionId), String(msg.appId), String(msg.viewId)),
+        "apps.agentNotes": (msg) => service.setAgentNotes(String(msg.sessionId), String(msg.appId), msg.enabled === true),
+        "apps.notes": (msg) => service.notes(String(msg.sessionId), { app: typeof msg.appId === "string" ? msg.appId : undefined, view: typeof msg.view === "string" ? msg.view : undefined, since: typeof msg.since === "number" ? msg.since : undefined }),
         "apps.logs": (msg) => service.logs(String(msg.sessionId), String(msg.appId), String(msg.viewId)),
-        "apps.share": (msg) => service.share(String(msg.sessionId), String(msg.appId), String(msg.viewId)),
+        // The app UI passes exact IDs; `bivy app share` passes an app and/or view by ID or name.
+        "apps.share": (msg) => typeof msg.viewId === "string" && typeof msg.appId === "string"
+            ? service.share(String(msg.sessionId), msg.appId, msg.viewId)
+            : service.shareView(String(msg.sessionId), { app: typeof msg.appId === "string" ? msg.appId : undefined, view: typeof msg.view === "string" ? msg.view : undefined }),
         "apps.revoke": (msg) => service.revoke(String(msg.sessionId), String(msg.appId), String(msg.viewId)),
         "apps.remove": (msg) => { service.remove(String(msg.sessionId), String(msg.appId)); return { ok: true }; },
     };
     return Object.fromEntries(Object.entries(operations).map(([kind, execute]) => [kind, async (msg, ctx) => {
             try {
                 ctx.reply({ type: `${kind}.ok`, requestId: msg.requestId, ...await execute(msg) });
-                if (kind === "apps.publish" || kind === "apps.adopt" || kind === "apps.remove")
+                if (kind === "apps.publish" || kind === "apps.adopt" || kind === "apps.remove" || kind === "apps.reviewMode" || kind === "apps.agentNotes")
                     ctx.broadcast({ type: "apps.changed", sessionId: msg.sessionId });
             }
             catch (error) {

package/dist/controllers/artifact-commands.js

@@ -0,0 +1,42 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 Petter André Sjulstad
+//
+// The machine-wide Artifacts index behind the sidebar's Artifacts page: every
+// file an agent sent into a chat (`bivy attach` / `attach_to_chat`), across all
+// of this machine's sessions. Built from the same event-log records attachment
+// GC already sweeps, so there is no second index to keep in sync. Only what can
+// still be opened is listed: the session exists and the blob is still stored.
+/** Newest first, bounded like the per-session projection. */
+export const MAX_MACHINE_ARTIFACTS = 500;
+/** One entry per content hash — the newest send wins, so the same report sent
+ * to two sessions links to where it was sent last. */
+export function listMachineArtifacts(deps) {
+    const byHash = new Map();
+    for (const sessionId of deps.sessionIds()) {
+        for (const record of deps.scan(sessionId)) {
+            if (record.bivyKind !== "outbound-attachment")
+                continue;
+            const { ref } = record;
+            const existing = byHash.get(ref.hash);
+            if (existing && existing.createdAt >= record.createdAt)
+                continue;
+            byHash.set(ref.hash, {
+                sessionId, hash: ref.hash, name: ref.name, mimeType: ref.mimeType, kind: ref.kind, size: ref.size,
+                ...(record.caption ? { caption: record.caption } : {}),
+                createdAt: record.createdAt,
+                artifact: Boolean(record.artifact || existing?.artifact),
+            });
+        }
+    }
+    return [...byHash.values()]
+        .filter((item) => deps.stored(item.hash))
+        .sort((a, b) => b.createdAt - a.createdAt)
+        .slice(0, MAX_MACHINE_ARTIFACTS);
+}
+export function createArtifactCommands(deps) {
+    return {
+        "artifacts.list"(msg, ctx) {
+            ctx.reply({ type: "artifacts.list.ok", requestId: msg.requestId, artifacts: listMachineArtifacts(deps) });
+        },
+    };
+}

package/dist/controllers/presence-commands.js

@@ -0,0 +1,19 @@
+import { deviceFrom } from "../session/presence.js";
+/** Device handoff presence, shared by relay and HTTP: read a session's driver
+ * and carried-over draft, and publish this device's unsent draft. */
+export function createPresenceCommands(book, publish) {
+    return {
+        "session.presence.get"(input, ctx) {
+            const requestId = typeof input.requestId === "string" ? input.requestId : undefined;
+            ctx.reply({ type: "session.presence.get.ok", requestId, presence: book.get(String(input.sessionId)) });
+        },
+        "session.presence.draft"(input, ctx) {
+            const requestId = typeof input.requestId === "string" ? input.requestId : undefined;
+            const device = deviceFrom(input.device);
+            if (!device)
+                return ctx.reply({ type: "session.presence.draft.error", httpStatus: 400, requestId, error: "Missing device" });
+            publish(book.draft(String(input.sessionId), device, String(input.text ?? "")));
+            ctx.reply({ type: "session.presence.draft.ok", requestId });
+        },
+    };
+}

package/dist/protocol/client-command-routes.js

@@ -3,10 +3,12 @@
 /** Direct-mode adapters for operations whose canonical implementation is the
  * client command registry. Relay and HTTP now differ only in framing. */
 export const CLIENT_COMMAND_ROUTES = [
-    ...["list", "publish", "offers", "adopt", "open", "logs", "shot", "clearNotes", "share", "revoke", "remove"].map((action) => ({ method: "post", path: `/api/apps/${action}`, kind: `apps.${action}` })),
+    ...["list", "publish", "offers", "adopt", "open", "logs", "shot", "input", "menu", "present", "showMe", "mute", "reviewMode", "annotate", "clearNotes", "agentNotes", "notes", "share", "revoke", "remove"].map((action) => ({ method: "post", path: `/api/apps/${action}`, kind: `apps.${action}` })),
+    { method: "post", path: "/api/artifacts/list", kind: "artifacts.list" },
     { method: "post", path: "/api/auth/credentials/native-preview", kind: "credentials.native.preview" },
     { method: "post", path: "/api/auth/credentials/native-import", kind: "credentials.native.import" },
     { method: "post", path: "/api/session/pause", kind: "session.pause" },
+    ...["get", "draft"].map((action) => ({ method: "post", path: `/api/session/presence/${action}`, kind: `session.presence.${action}` })),
     { method: "post", path: "/api/session/resume", kind: "session.resume" },
     { method: "post", path: "/api/session/question/answer", kind: "session.question.answer" },
 ];

package/dist/protocol/client-command-schemas.js

@@ -8,15 +8,29 @@ const optionalSession = { sessionId: Type.Optional(Type.String()) };
  * this table remains migration-compatible; adding validation is one data row. */
 export const CLIENT_COMMAND_SCHEMAS = {
     ping: Type.Object(request),
-    "apps.list": Type.Object({ ...request, ...session }),
+    "apps.list": Type.Object({ ...request, ...optionalSession }),
+    "artifacts.list": Type.Object(request),
     "apps.publish": Type.Object({ ...request, ...session, manifest: Type.Unknown() }),
     "apps.offers": Type.Object({ ...request, ...session }),
     "apps.adopt": Type.Object({ ...request, ...session, port: Type.Integer({ minimum: 1024, maximum: 65535 }) }),
-    "apps.open": Type.Object({ ...request, ...session, appId: Type.String(), viewId: Type.String(), returnTo: Type.Optional(Type.String({ maxLength: 2048 })), direct: Type.Optional(Type.Boolean()), scale: Type.Optional(Type.Integer({ minimum: 1, maximum: 2 })) }),
+    "apps.open": Type.Object({ ...request, ...session, appId: Type.String(), viewId: Type.String(), returnTo: Type.Optional(Type.String({ maxLength: 2048 })), direct: Type.Optional(Type.Boolean()), scale: Type.Optional(Type.Integer({ minimum: 1, maximum: 2 })), path: Type.Optional(Type.String({ maxLength: 2048 })) }),
     "apps.shot": Type.Object({ ...request, ...session, appId: Type.Optional(Type.String()), widths: Type.Optional(Type.Array(Type.Integer(), { maxItems: 4 })), themes: Type.Optional(Type.Array(Type.Union([Type.Literal("light"), Type.Literal("dark")]), { maxItems: 2 })), path: Type.Optional(Type.String({ maxLength: 2048 })) }),
+    "apps.input": Type.Object({ ...request, ...session, target: Type.Optional(Type.String({ maxLength: 200 })), action: Type.Object({ kind: Type.String({ maxLength: 20 }) }) }),
+    "apps.menu": Type.Object({ ...request, ...session, target: Type.Optional(Type.String({ maxLength: 200 })), path: Type.Optional(Type.Array(Type.String({ minLength: 1, maxLength: 200 }), { minItems: 1, maxItems: 8 })) }),
+    "apps.present": Type.Object({ ...request, ...session, target: Type.Optional(Type.String({ maxLength: 200 })), path: Type.Optional(Type.String({ maxLength: 2048 })), note: Type.Optional(Type.String({ maxLength: 2000 })) }),
+    "apps.showMe": Type.Object({ ...request, ...session, appId: Type.Optional(Type.String()) }),
+    "apps.mute": Type.Object({ ...request, ...session }),
+    "apps.reviewMode": Type.Object({ ...request, ...session, appId: Type.String(), mode: Type.Union([Type.Literal("ready"), Type.Literal("every"), Type.Literal("off")]) }),
+    "apps.annotate": Type.Object({ ...request, ...session, appId: Type.String(), viewId: Type.String(), path: Type.Optional(Type.String({ maxLength: 2048 })),
+        viewport: Type.Object({ width: Type.Number(), height: Type.Number() }), scroll: Type.Optional(Type.Object({ x: Type.Number(), y: Type.Number() })),
+        dpr: Type.Optional(Type.Number()), theme: Type.Optional(Type.Union([Type.Literal("light"), Type.Literal("dark")])), compare: Type.Optional(Type.Integer({ minimum: 0 })),
+        strokes: Type.Array(Type.Object({ tool: Type.Union([Type.Literal("pen"), Type.Literal("box")]), points: Type.Array(Type.Array(Type.Number(), { minItems: 2, maxItems: 2 }), { maxItems: 10000 }) }), { minItems: 1, maxItems: 50 }),
+        signals: Type.Optional(Type.Record(Type.String(), Type.Boolean())) }),
     "apps.clearNotes": Type.Object({ ...request, ...session, appId: Type.String(), viewId: Type.String() }),
+    "apps.agentNotes": Type.Object({ ...request, ...session, appId: Type.String(), enabled: Type.Boolean() }),
+    "apps.notes": Type.Object({ ...request, ...session, appId: Type.Optional(Type.String({ maxLength: 200 })), view: Type.Optional(Type.String({ maxLength: 200 })), since: Type.Optional(Type.Number()) }),
     "apps.logs": Type.Object({ ...request, ...session, appId: Type.String(), viewId: Type.String() }),
-    "apps.share": Type.Object({ ...request, ...session, appId: Type.String(), viewId: Type.String() }),
+    "apps.share": Type.Object({ ...request, ...session, appId: Type.Optional(Type.String({ maxLength: 200 })), viewId: Type.Optional(Type.String()), view: Type.Optional(Type.String({ maxLength: 200 })) }),
     "apps.revoke": Type.Object({ ...request, ...session, appId: Type.String(), viewId: Type.String() }),
     "apps.remove": Type.Object({ ...request, ...session, appId: Type.String() }),
     "credentials.native.preview": Type.Object({ ...request, label: Type.Optional(Type.String({ maxLength: 100 })) }),
@@ -28,6 +42,8 @@ export const CLIENT_COMMAND_SCHEMAS = {
     }),
     "attachment.fetch": Type.Object({ ...request, hash: Type.String() }),
     "session.pause": Type.Object(session),
+    "session.presence.get": Type.Object({ ...request, ...session }),
+    "session.presence.draft": Type.Object({ ...request, ...session, device: Type.Object({ id: Type.String({ maxLength: 100 }), label: Type.Optional(Type.String({ maxLength: 200 })) }), text: Type.String({ maxLength: 20_000 }) }),
     "session.resume": Type.Object(session),
     "session.question.answer": Type.Object({ ...optionalSession, requestId: Type.String(), answers: Type.Optional(Type.Record(Type.String(), Type.String())) }),
     "session.replay": Type.Object({ ...session, afterSeq: Type.Optional(Type.Number()) }),