@oar-sh/oar 0.9.11 → 0.9.13

package/server/public/index.html

@@ -280,6 +280,7 @@
     --warn:      #d29922;
     --conversation-title-offline: #f0f6fc;
     --conversation-title-ready: #3fb950;
+    --conversation-title-idle: #238636;
     --conversation-title-question: #f85149;
     --conversation-title-error: #d29922;
     /* Relay reachability tones, shared by the sidebar dot and the mobile
@@ -347,6 +348,8 @@
     --warn:      #9a6700;
     --conversation-title-offline: #1F2328;
     --conversation-title-ready: #1a7f37;
+    /* Muted, not darker: a darker green would stand out more on white. */
+    --conversation-title-idle: #4c8b5c;
     --conversation-title-question: #cf222e;
     --conversation-title-error: #9a6700;
     --provider-github: #0969da;
@@ -842,17 +845,17 @@
   .conv-provider-indicator[data-provider="claude-cloud"] { color: var(--provider-claude-cloud); }
   .conv-item.worker-ui-offline .conv-title,
   #chat-title[data-ui-state="offline"] { color: var(--conversation-title-offline); }
+  /* Ready and idle: the darker green. Ready and working (a turn or
+     background work): the bright one. :where() keeps the working rule as
+     specific as the others, so an archived row stays muted. */
   .conv-item.worker-ui-ready .conv-title,
-  #chat-title[data-ui-state="ready"] { color: var(--conversation-title-ready); }
+  #chat-title[data-ui-state="ready"] { color: var(--conversation-title-idle); }
+  .conv-item.worker-ui-ready:where(.conv-working) .conv-title,
+  #chat-title[data-ui-state="ready"][data-working] { color: var(--conversation-title-ready); }
   .conv-item.worker-ui-question .conv-title,
   #chat-title[data-ui-state="question"] { color: var(--conversation-title-question); }
   .conv-item.worker-ui-error .conv-title,
   #chat-title[data-ui-state="error"] { color: var(--conversation-title-error); }
-  .conv-processing-dots {
-    display: inline-block;
-    min-width: 1.8ch;
-    letter-spacing: 0.02em;
-  }
   .conv-delete {
     position: absolute; right: 8px; top: 50%; transform: translateY(-50%);
     background: none; border: none; color: var(--muted); cursor: pointer; font-size: var(--fs-ui-icon);
@@ -2981,6 +2984,15 @@
   }
   .pending-action-text { overflow-wrap: anywhere; }
   .pending-action-cancel { margin-left: 0; }
+  /* The queued relay restart's row (relay-restart-ui.js): the headline, the
+     sessions it waits for (links), held messages, background tasks, buttons. */
+  .relay-restart-row { flex-direction: column; gap: 3px; }
+  .relay-restart-head { display: flex; flex-wrap: wrap; justify-content: center; gap: 6px; }
+  .relay-restart-waited { opacity: 0.85; }
+  .relay-restart-detail { color: var(--text); overflow-wrap: anywhere; max-height: 4.5em; overflow-y: auto; }
+  .relay-restart-session-link { color: inherit; text-decoration: underline; }
+  .relay-restart-actions { display: flex; flex-wrap: wrap; justify-content: center; gap: 6px; }
+  .relay-restart-row[data-asking="1"] .relay-restart-head { font-weight: 600; }
   .suspend-host-blockers {
     margin: 6px 0 10px;
     padding-left: 20px;
@@ -3379,6 +3391,189 @@
     .subagent-viewer-dialog { width: 100%; height: 100%; border: 0; border-radius: 0; }
     #subagent-viewer-body { padding: 8px 10px 28px; }
   }
+  /* The task console: a shell or Monitor task's output (task-console.mjs).
+     Same shell as the sub-agent viewer; the 16 terminal colours follow the
+     theme so red and green stay readable on Day and Night. */
+  :root {
+    --tc-ansi-0: #484f58;
+    --tc-ansi-1: #ff7b72;
+    --tc-ansi-2: #3fb950;
+    --tc-ansi-3: #d29922;
+    --tc-ansi-4: #58a6ff;
+    --tc-ansi-5: #bc8cff;
+    --tc-ansi-6: #39c5cf;
+    --tc-ansi-7: #b1bac4;
+    --tc-ansi-8: #6e7681;
+    --tc-ansi-9: #ffa198;
+    --tc-ansi-10: #56d364;
+    --tc-ansi-11: #e3b341;
+    --tc-ansi-12: #79c0ff;
+    --tc-ansi-13: #d2a8ff;
+    --tc-ansi-14: #56d4dd;
+    --tc-ansi-15: #f0f6fc;
+  }
+  :root[data-theme="light"] {
+    --tc-ansi-0: #24292f;
+    --tc-ansi-1: #cf222e;
+    --tc-ansi-2: #116329;
+    --tc-ansi-3: #4d2d00;
+    --tc-ansi-4: #0969da;
+    --tc-ansi-5: #8250df;
+    --tc-ansi-6: #1b7c83;
+    --tc-ansi-7: #6e7781;
+    --tc-ansi-8: #57606a;
+    --tc-ansi-9: #a40e26;
+    --tc-ansi-10: #1a7f37;
+    --tc-ansi-11: #633c01;
+    --tc-ansi-12: #218bff;
+    --tc-ansi-13: #a475f9;
+    --tc-ansi-14: #3192aa;
+    --tc-ansi-15: #8c959f;
+  }
+  #task-console-modal {
+    position: fixed; inset: 0; z-index: 10900; display: none;
+    align-items: center; justify-content: center;
+    background: rgba(0, 0, 0, 0.68); padding: 18px;
+  }
+  #task-console-modal.visible { display: flex; }
+  #task-console-title { flex: 1; min-width: 0; margin: 0; font-size: 1.05rem; font-weight: 600; overflow-wrap: anywhere; }
+  .task-console-meta-row { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; color: var(--muted); font-size: var(--fs-meta-sm); }
+  #task-console-meta { overflow-wrap: anywhere; }
+  .tc-stall { color: var(--muted); }
+  .tc-stall-warn { color: var(--warn); font-weight: 600; }
+  #task-console-chip { cursor: pointer; font: inherit; }
+  #task-console-failure {
+    background: none; border: 0; padding: 0; color: var(--accent); cursor: pointer;
+    font-size: var(--fs-meta-sm); text-decoration: underline; text-underline-offset: 3px;
+  }
+  #task-console-stop:hover:not(:disabled) { border-color: #f85149; color: #f85149; }
+  /* "Load earlier" within reach while following the end; the one at the top
+     of the output stays. */
+  #task-console-earlier-top {
+    background: none; border: 0; padding: 0; color: var(--accent); cursor: pointer;
+    font-size: var(--fs-meta-sm); text-decoration: underline; text-underline-offset: 3px;
+  }
+  #task-console-earlier-top:disabled { color: var(--muted); text-decoration: none; cursor: default; }
+  #task-console-earlier-top[hidden] { display: none; }
+  /* Where the output of a command piped into tail stops until it ends. */
+  #task-console-hold {
+    margin: 8px 0 0; padding: 6px 10px; border-left: 3px solid var(--warn); border-radius: 4px;
+    background: var(--bg2); color: var(--text); font-size: var(--fs-meta-sm);
+  }
+  #task-console-hold[hidden] { display: none; }
+  .tc-hold-text { font-weight: 600; }
+  .tc-hold-hint { color: var(--muted); margin-top: 2px; }
+  /* Wider screens: the console ends above the composer's open task row, so
+     the row's chip, clock and Stop stay in view (task-console.mjs sets the
+     bottom). Phones keep the full-screen console. */
+  #task-console-modal.tc-above-panel .task-console-dialog { height: 100%; }
+  #task-console-scroll {
+    flex: 1; overflow: auto; overscroll-behavior: contain; padding: 8px 14px 28px;
+    background: var(--bg);
+  }
+  #task-console-earlier {
+    display: block; margin: 0 auto 8px; border: 1px solid var(--border); background: var(--bg2);
+    color: var(--text); border-radius: 999px; padding: 3px 14px; font-size: var(--fs-meta-sm); cursor: pointer;
+  }
+  #task-console-earlier:disabled { opacity: 0.6; cursor: default; }
+  #task-console-earlier[hidden] { display: none; }
+  #task-console-body {
+    margin: 0; font-family: var(--mono, ui-monospace, SFMono-Regular, Menlo, Consolas, monospace);
+    font-size: var(--fs-meta-sm); line-height: 1.45; color: var(--text);
+    white-space: pre-wrap; overflow-wrap: anywhere;
+  }
+  .tc-line { min-height: 1.45em; }
+  .tc-line-partial { opacity: 0.85; }
+  .tc-line-target { background: rgba(248, 81, 73, 0.16); border-radius: 3px; }
+  .tc-line-count {
+    display: inline-block; margin-left: 8px; padding: 0 6px; border-radius: 999px;
+    border: 1px solid var(--border); color: var(--muted); font-size: 0.85em; user-select: none;
+  }
+  .tc-bold { font-weight: 700; }
+  .tc-dim { opacity: 0.65; }
+  .tc-italic { font-style: italic; }
+  .tc-underline { text-decoration: underline; }
+  .tc-fg-0 { color: var(--tc-ansi-0); }
+  .tc-fg-1 { color: var(--tc-ansi-1); }
+  .tc-fg-2 { color: var(--tc-ansi-2); }
+  .tc-fg-3 { color: var(--tc-ansi-3); }
+  .tc-fg-4 { color: var(--tc-ansi-4); }
+  .tc-fg-5 { color: var(--tc-ansi-5); }
+  .tc-fg-6 { color: var(--tc-ansi-6); }
+  .tc-fg-7 { color: var(--tc-ansi-7); }
+  .tc-fg-8 { color: var(--tc-ansi-8); }
+  .tc-fg-9 { color: var(--tc-ansi-9); }
+  .tc-fg-10 { color: var(--tc-ansi-10); }
+  .tc-fg-11 { color: var(--tc-ansi-11); }
+  .tc-fg-12 { color: var(--tc-ansi-12); }
+  .tc-fg-13 { color: var(--tc-ansi-13); }
+  .tc-fg-14 { color: var(--tc-ansi-14); }
+  .tc-fg-15 { color: var(--tc-ansi-15); }
+  .tc-bg-0 { background: var(--tc-ansi-0); }
+  .tc-bg-1 { background: var(--tc-ansi-1); }
+  .tc-bg-2 { background: var(--tc-ansi-2); }
+  .tc-bg-3 { background: var(--tc-ansi-3); }
+  .tc-bg-4 { background: var(--tc-ansi-4); }
+  .tc-bg-5 { background: var(--tc-ansi-5); }
+  .tc-bg-6 { background: var(--tc-ansi-6); }
+  .tc-bg-7 { background: var(--tc-ansi-7); }
+  .tc-bg-8 { background: var(--tc-ansi-8); }
+  .tc-bg-9 { background: var(--tc-ansi-9); }
+  .tc-bg-10 { background: var(--tc-ansi-10); }
+  .tc-bg-11 { background: var(--tc-ansi-11); }
+  .tc-bg-12 { background: var(--tc-ansi-12); }
+  .tc-bg-13 { background: var(--tc-ansi-13); }
+  .tc-bg-14 { background: var(--tc-ansi-14); }
+  .tc-bg-15 { background: var(--tc-ansi-15); }
+  /* Inverse text (SGR 7) with a side left unset: the console's own colours, swapped. */
+  .tc-fg-inverse { color: var(--bg); }
+  .tc-bg-inverse { background: var(--text); }
+  #task-console-status { color: var(--muted); padding: 10px 0; font-size: var(--fs-meta-sm); }
+  #task-console-status[hidden] { display: none; }
+  #task-console-jump {
+    position: absolute; left: 50%; bottom: 14px; transform: translateX(-50%);
+    border: 1px solid var(--accent); background: var(--bg3); color: var(--accent);
+    border-radius: 999px; padding: 5px 14px; font-size: var(--fs-meta-sm); cursor: pointer;
+    box-shadow: 0 2px 10px rgba(0, 0, 0, 0.35);
+  }
+  #task-console-jump[hidden] { display: none; }
+  /* Rows in the composer panel: the console opener, the health hints, the
+     ended rows. */
+  .bg-task-desc.task-console-open {
+    display: block; -webkit-line-clamp: unset; background: none; border: 0; padding: 0; margin: 0;
+    font: inherit; color: var(--text); text-align: left; cursor: pointer;
+    text-decoration: underline; text-decoration-color: transparent; text-underline-offset: 3px;
+  }
+  .bg-task-desc.task-console-open:hover, .bg-task-desc.task-console-open:focus-visible {
+    color: var(--accent); text-decoration-color: currentColor; outline: none;
+  }
+  .bg-task-desc-no-output { cursor: help; }
+  .bg-task-steps { color: var(--muted); flex-shrink: 0; font-variant-numeric: tabular-nums; white-space: nowrap; }
+  .bg-task-stall { color: var(--muted); flex-shrink: 0; white-space: nowrap; }
+  .bg-task-stall[hidden] { display: none; }
+  .bg-task-stall-warn { color: var(--warn); font-weight: 600; }
+  .bg-task-chip {
+    flex-shrink: 0; border: 1px solid var(--success); color: var(--success); background: transparent;
+    border-radius: 999px; padding: 0 7px; font-size: var(--fs-meta-sm); white-space: nowrap;
+    font-variant-numeric: tabular-nums;
+  }
+  .bg-task-chip[hidden] { display: none; }
+  .bg-task-chip-fail { border-color: var(--danger); color: var(--danger); }
+  .bg-task-row-ended { opacity: 0.62; }
+  .bg-task-row-ended:hover, .bg-task-row-ended:focus-within { opacity: 0.9; }
+  .bg-task-outcome { flex-shrink: 0; font-weight: 700; }
+  .bg-task-outcome-ok { color: var(--success); }
+  .bg-task-outcome-fail { color: var(--danger); }
+  .bg-task-dismiss {
+    flex-shrink: 0; background: transparent; border: 1px solid var(--border); color: var(--muted);
+    border-radius: 8px; width: 26px; height: 24px; line-height: 1; cursor: pointer; font-size: 1rem;
+  }
+  .bg-task-dismiss:hover { color: var(--text); border-color: var(--text); }
+  @media (max-width: 680px) {
+    #task-console-modal { padding: 0; }
+    #task-console-modal .subagent-viewer-dialog { width: 100%; height: 100%; border: 0; border-radius: 0; }
+    #task-console-scroll { padding: 8px 10px 28px; }
+  }
   /* Preview cards: same row grammar as a background task, with a link-shaped
      primary action. Shared by the composer panel and the settings list. */
   .preview-row {
@@ -3549,6 +3744,8 @@
   .relay-event-time { flex: 0 0 auto; }
   .relay-event-lines { margin: 2px 0 4px; padding-left: 18px; }
   .relay-event-line { margin: 2px 0; overflow-wrap: anywhere; white-space: pre-wrap; }
+  /* The relay's note to carry on after a restart (relay-restart-note-view.mjs). */
+  .relay-restart-note-text { padding-left: 0; overflow-wrap: anywhere; white-space: pre-wrap; }
   .relay-event-line.relay-event-question-asked,
   .relay-event-line.relay-event-error,
   .relay-event-line.relay-event-task-failed,
@@ -7005,6 +7202,22 @@
           >
         </div>
         <div class="settings-help" style="margin-top: 6px;">A conversation only scrolls by itself while you are at its end. Anywhere else it stays where you are reading, and the round button above the composer shows that something new or a question is waiting below. Your own message is the exception: sending one takes you to the end. Switch this off to stay put then too. Saved in this browser.</div>
+        <div class="settings-row settings-row-column" style="margin-top: 12px; margin-bottom: 0;">
+          <label for="conversation-window-retention-slider">Messages kept per conversation for switching back <span id="conversation-window-retention-value">200 messages</span></label>
+          <input
+            id="conversation-window-retention-slider"
+            type="range"
+            min="100"
+            max="1100"
+            step="100"
+            value="200"
+            aria-label="Messages kept per conversation for switching back"
+            aria-valuetext="200 messages"
+            oninput="previewConversationWindowRetention(this.value)"
+            onchange="updateConversationWindowRetention(this.value)"
+          >
+        </div>
+        <div class="settings-help" style="margin-top: 6px;">A conversation you switch away from and back to opens where you were reading, with the older messages you had loaded. This many are kept around that place for each of the last eight conversations; No limit keeps them all, at the cost of memory. Saved in this browser.</div>
         <div class="settings-row settings-row-column" style="margin-top: 12px; margin-bottom: 0;">
           <label for="turn-ceiling-slider">Max turn duration <span id="turn-ceiling-value">No limit</span></label>
           <input
@@ -7035,6 +7248,45 @@
           >
         </div>
         <div class="settings-help" style="margin-top: 6px;">How long background tasks may keep a session alive after its turn ends: backgrounded commands, subagents and monitors on Claude; background agents and detached shells on Copilot's SDK engine. When the limit is reached the tasks are stopped. Set to 0 for no limit — tasks then run until they finish or you stop them from the composer panel.</div>
+        <div class="settings-row settings-row-column" style="margin-top: 12px; margin-bottom: 0;">
+          <label for="task-stall-minutes-slider">Mark a background task as quiet after <span id="task-stall-minutes-value">10 min</span></label>
+          <input
+            id="task-stall-minutes-slider"
+            type="range"
+            min="1"
+            max="120"
+            step="1"
+            value="10"
+            aria-label="Minutes without output before a background task is marked as quiet"
+            oninput="previewTaskStallMinutesSetting(this.value)"
+            onchange="updateTaskStallMinutesSetting(this.value)"
+          >
+        </div>
+        <div class="settings-help" style="margin-top: 6px;">A shell or Monitor task that has written no output for this long gets an amber "no output for N min" note in the composer panel and its console.</div>
+        <div class="settings-row" style="margin-top: 12px; margin-bottom: 0;">
+          <label for="restart-resume-toggle">After a relay restart, tell interrupted sessions to carry on</label>
+          <input
+            id="restart-resume-toggle"
+            type="checkbox"
+            onchange="updateRestartResumeSettingFromToggle(this.checked)"
+            aria-label="After a relay restart, tell interrupted sessions to carry on"
+          >
+        </div>
+        <div class="settings-help" style="margin-top: 6px;">Most turns a restart interrupts run again by themselves. A turn that cannot (the agent had already taken the message, or had started on its own after a background task) just stops. With this on, such a session gets one relay note once the relay is back, saying when it restarted and asking the agent to check what it was doing and carry on. Your message is never sent again; idle, archived and usage-limit-paused sessions get nothing. Off by default; a setting of this relay.</div>
+        <div class="settings-row" style="margin-top: 12px; margin-bottom: 0;">
+          <label for="relay-restart-max-wait-select">Ask after a queued relay restart has waited</label>
+          <select id="relay-restart-max-wait-select" onchange="updateRelayRestartMaxWaitSetting(this.value)" aria-label="Ask after a queued relay restart has waited">
+            <option value="5">5 min</option>
+            <option value="10">10 min</option>
+            <option value="15">15 min</option>
+            <option value="30" selected>30 min</option>
+            <option value="60">1 h</option>
+            <option value="120">2 h</option>
+            <option value="240">4 h</option>
+            <option value="0">No limit</option>
+          </select>
+        </div>
+        <div class="settings-help" style="margin-top: 6px;">A queued relay restart waits for the running turns, and new messages wait for the restart. After this long the banner asks whether to restart now, keep waiting or cancel; it never restarts while the turns run, and still restarts as soon as they end. No limit waits until the turns end.</div>
         <div class="settings-row" style="margin-top: 12px; margin-bottom: 0;">
           <label for="subagent-record-retention-select">Keep sub-agent tool output</label>
           <select id="subagent-record-retention-select" onchange="updateSubagentRecordRetentionSetting(this.value)" aria-label="Keep sub-agent tool output">
@@ -7372,6 +7624,18 @@
               <option value="off">Off — no attribution</option>
             </select>
             <div id="claude-attribution-example" class="settings-help"></div>
+            <label for="claude-background-command-limit-slider" style="margin-top: 8px;">Claude background command limit <span id="claude-background-command-limit-value">2 h</span></label>
+            <input
+              id="claude-background-command-limit-slider"
+              type="range"
+              min="30"
+              max="480"
+              step="30"
+              value="120"
+              aria-label="Claude background command limit in minutes"
+              oninput="window.previewClaudeBackgroundCommandLimit?.(this.value)"
+            >
+            <div class="settings-help">How long a command Claude runs in the background may take before Claude Code stops it, unless Claude gives it its own timeout (up to 8 h). Commands in the foreground move to the background after 2 min. Applies to Claude sessions started after you save; a running session keeps its limit until it restarts.</div>
             <div id="claude-settings-status" class="settings-help settings-provider-status">Loading Claude settings…</div>
             <div style="display: flex; gap: 8px; margin-top: 8px;">
               <button id="claude-save-btn" type="button" class="summary-btn" onclick="saveClaudeSettings()">Save Claude settings</button>
@@ -7867,6 +8131,10 @@
             <label for="push-event-host-suspend-toggle">Host suspend fired or was dropped</label>
             <input id="push-event-host-suspend-toggle" type="checkbox" onchange="updatePushPreferencesFromControls()" checked disabled>
           </div>
+          <div class="settings-row" style="width: 100%; margin-top: 6px; margin-bottom: 0;">
+            <label for="push-event-relay-restart-toggle">Queued relay restart waited its maximum time</label>
+            <input id="push-event-relay-restart-toggle" type="checkbox" onchange="updatePushPreferencesFromControls()" checked disabled>
+          </div>
           <label style="margin-top: 10px;">Devices</label>
           <div id="push-device-list" style="width: 100%;"></div>
           <div class="settings-help">Notifications are only sent while no device has the app in the foreground. Content defaults to generic text; message previews are opt-in per device.</div>
@@ -8029,6 +8297,38 @@
   </div>
 </div>
 
+<!-- Task console: a shell or Monitor task's output, live while it runs
+     (task-console.mjs). -->
+<div id="task-console-modal" aria-hidden="true">
+  <div class="subagent-viewer-dialog task-console-dialog" role="dialog" aria-modal="true" aria-labelledby="task-console-title">
+    <div class="subagent-viewer-header">
+      <div class="subagent-viewer-title-row">
+        <span aria-hidden="true">⌨️</span>
+        <h2 id="task-console-title">Task</h2>
+        <button id="task-console-stop" class="subagent-viewer-btn" type="button" hidden>Stop</button>
+        <button class="subagent-viewer-btn task-console-close" type="button" aria-label="Close">×</button>
+      </div>
+      <div class="task-console-meta-row">
+        <span id="task-console-meta"></span>
+        <span id="task-console-stall" class="tc-stall" hidden></span>
+        <button id="task-console-chip" class="bg-task-chip" type="button" hidden></button>
+        <button id="task-console-failure" type="button" hidden>first failure</button>
+        <button id="task-console-earlier-top" type="button" hidden>Load earlier</button>
+      </div>
+    </div>
+    <div id="task-console-scroll">
+      <button id="task-console-earlier" type="button" hidden>Load earlier</button>
+      <pre id="task-console-body"></pre>
+      <div id="task-console-hold" role="note" hidden>
+        <div class="tc-hold-text"></div>
+        <div class="tc-hold-hint"></div>
+      </div>
+      <div id="task-console-status" hidden></div>
+    </div>
+    <button id="task-console-jump" type="button" hidden>Jump to end ↓</button>
+  </div>
+</div>
+
 <!-- Fullscreen file viewer. The content fills the screen; the chrome bars
      float over it and a tap on the content shows or hides them. -->
 <div id="file-preview-modal" aria-hidden="true">

package/server/relay-tools.md

@@ -22,6 +22,8 @@ Note: shutdown is queued and only completes when the current turn finishes, so i
 
 Use `restart: true` in the request body when the user wants a real relay restart rather than a plain shutdown. Example request body: `{ "reason": "manual-restart", "requestedBy": "localhost-api", "restart": true }`.
 
+Never pass `immediate` in that request body: it restarts without waiting for the running turns, which only the user may decide, with Restart now in the web UI.
+
 ## Preview servers
 
 Publish a local web server or a static directory on a public preview URL so the user can open it from any device, or list/close existing previews. Use this whenever the user wants to see, try, or share something with a web UI — never ask them to open localhost or forward a port. For a dev server: call this FIRST with {action:"create", port} to get the basePath, then start the server configured to serve under that basePath (Vite --base, Next basePath, Express mount prefix); the proxy forwards X-Forwarded-Prefix but does not rewrite bodies, so root-absolute asset paths will not work. For plain files or a build output: pass {action:"create", dir} instead and the relay serves the directory itself — no dev server needed. Always tell the user the returned URL and that the link is public: anyone who has it can reach the app without logging in. Publishing the same port or directory again in this conversation returns the same link. Previews never expire and survive a relay restart (a port preview until the machine reboots); close them with {action:"close"} when the user is done.
@@ -39,8 +41,12 @@ This relay itself is listed with "self": true when its owner switched agent sess
 - `create_session` starts a session with any provider that `relay_info` lists: a local one in a folder ("cwd"), or provider "claude-cloud" with "repo" (a GitHub URL or owner/repo) and an optional "branch". At most 4 sessions you started may work at the same time; a fifth is refused until one finishes.
 - The first `create_session` on this relay shows the user an approval card, once per conversation. A session that an agent created cannot create sessions itself (one level only).
 - Sessions you start here are grouped under this session in the user's sidebar. `list_sessions` lists in the sidebar's order (a group sorts by its newest session, head first) and shows the group as a "group" field (id, name, role); `read_session` adds the group's live members with their state. Agents only read groups, the user arranges them.
+- A "model" for `create_session` or `send` must be an id `relay_info` lists for the provider (Claude also takes "opus", "sonnet", "haiku"). An unknown id is refused with the close matches ("unknown model 'gpt-5-4' for Copilot; did you mean 'gpt-5.4'?") and nothing is created or sent: pick from the list instead of guessing. If the answer has a "modelNote" saying the model could not be checked, the relay had no model list yet.
 - A new session knows nothing of this conversation: write a self-contained prompt. A Claude Cloud session works on a fresh clone in a sandbox at Anthropic, so name the branch it should work on and push.
 - Follow each session with `wait` (the message id comes back from `create_session` and `send`) and `read_session`; "wait_seconds" is limited to the maximum set on the relay (default 600).
 - Sessions run on the relay owner's accounts and cost their usage: start only what the task needs.
+- `read_task_output` ("session", "task_id" from `read_session`'s tasks, optional "lines") reads the end of a background shell or Monitor task's output, also for an hour after it ended: the last lines, minutes since its last output, and pass/fail counts for a test run. Credentials are scrubbed out.
+
+On this relay and on a paired one, `subscribe` wakes you when something happens in the sessions you watch, instead of polling them. Leave "events" out unless you need more: the default (question_asked, error, turn_end, subagent_finished, task_failed, stalled, all_idle) wakes you for questions, errors, replies, finished sub-agents, failed tasks (a non-zero exit included), stalls and all_idle, but not for each shell command that ended well. To get those too, pass that list plus "task_finished" (and "task_started" for the starts); each one costs you a turn, so do it only if you must follow every command.
 
 Write actions may first wait for the user's approval. If a result lists `pendingQuestions`, the other agent is waiting for an answer: ask the user (unless they told you to decide), then pass it on with `answer_question`. Always tell the user which relay and session you worked on.

package/server/repositories/message-repository.mjs

@@ -2,6 +2,7 @@
 
 import { createShareVisibilityStatements } from './share-visibility-statements.mjs';
 import { createMessagePinStatements } from './message-pin-statements.mjs';
+import { createConversationHistoryPageStatements } from '../services/conversation-history-page.mjs';
 import { sessionWorkerProviderSqlList } from '../../shared/provider-routing.mjs';
 
 export function createMessageRepository(db) {
@@ -27,6 +28,8 @@ export function createMessageRepository(db) {
         // messages
         getMessages:    db.prepare(`SELECT * FROM messages WHERE conversation_id = ? ORDER BY timestamp ASC`),
         getSharedMessages: shareVisibility.getSharedMessages,
+        // One history page in SQL (conversation-history-page.mjs).
+        conversationHistoryPage: createConversationHistoryPageStatements(db),
         getMessageByConversation: db.prepare(`SELECT * FROM messages WHERE id = ? AND conversation_id = ? LIMIT 1`),
         setMessageShareVisibility: shareVisibility.setMessageShareVisibility,
         listHiddenMessages: shareVisibility.listHiddenMessages,
@@ -34,6 +37,9 @@ export function createMessageRepository(db) {
         listPinnedMessages: messagePins.listPinnedMessages,
         countPinnedMessages: messagePins.countPinnedMessages,
         getLatestConversationModel: db.prepare(`SELECT model FROM messages WHERE conversation_id = ? AND model IS NOT NULL AND model != '' ORDER BY timestamp DESC LIMIT 1`),
+        // The model of the conversation's latest user turn: one of the
+        // fallbacks for a send that names no model.
+        getLatestUserMessageModel: db.prepare(`SELECT model FROM messages WHERE conversation_id = ? AND role = 'user' AND model IS NOT NULL AND model != '' ORDER BY timestamp DESC LIMIT 1`),
         getRecentMessagesDesc: db.prepare(`SELECT id, role, text, timestamp FROM messages WHERE conversation_id = ? ORDER BY timestamp DESC LIMIT ?`),
         insertMsg:      db.prepare(`INSERT INTO messages (id, conversation_id, role, text, model, mode, attachments, timestamp, model_requested, model_actual, model_origin) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`),
         // Provenance is derived from the authenticated responder identity at
@@ -116,6 +122,11 @@ export function createMessageRepository(db) {
           ORDER BY captured_at DESC
           LIMIT 1
         `),
+        getMessageUsageSnapshotByResponse: db.prepare(`
+          SELECT *
+          FROM message_usage_snapshots
+          WHERE response_message_id = ? AND conversation_id = ?
+        `),
         listMessageUsageSnapshotsByConversation: db.prepare(`
           SELECT *
           FROM message_usage_snapshots

package/server/repositories/question-repository.mjs

@@ -174,6 +174,10 @@ export function createQuestionRepository(db) {
           WHERE response_message_id = ?
           ORDER BY created_at ASC, id ASC
         `),
+        // Every card of a conversation, for the shared view's link redaction:
+        // a paged transcript hydrates only its page's cards, yet a reply on
+        // the page may quote the link of a card outside it.
+        listPreviewCardJsonByConversation: db.prepare(`SELECT preview_json FROM preview_cards WHERE conversation_id = ?`),
         deleteConvPreviewCards: db.prepare(`DELETE FROM preview_cards WHERE conversation_id = ?`),
 
         // relay boards

package/server/repositories/remote-relay-repository.mjs

@@ -27,7 +27,9 @@ function parseOrigin(json) {
 
 export function createRemoteRelayRepository(db) {
   const hasUnlock = db.prepare(`SELECT 1 FROM conversation_remote_relay_unlocks WHERE conversation_id = ? AND remote_relay_id = ?`);
-  const listUnlocks = db.prepare(`SELECT remote_relay_id, message_id, created_at FROM conversation_remote_relay_unlocks WHERE conversation_id = ? ORDER BY created_at ASC`);
+  // Two unlocks can share a millisecond (Windows' clock is coarse); the rowid
+  // keeps them in the order they were recorded rather than by relay id.
+  const listUnlocks = db.prepare(`SELECT remote_relay_id, message_id, created_at FROM conversation_remote_relay_unlocks WHERE conversation_id = ? ORDER BY created_at ASC, rowid ASC`);
   const insertUnlock = db.prepare(`INSERT OR IGNORE INTO conversation_remote_relay_unlocks (conversation_id, remote_relay_id, message_id, created_at) VALUES (?, ?, ?, ?)`);
   // The relay's unlocks and the approvals stored under its id (`<id>:watch`).
   const deleteUnlocksForRelay = db.prepare(`
@@ -64,7 +66,7 @@ export function createRemoteRelayRepository(db) {
     hasUnlock(conversationId, remoteRelayId) {
       return !!hasUnlock.get(String(conversationId || ''), String(remoteRelayId || ''));
     },
-    /** `[{ remoteRelayId, messageId, createdAt }]`, oldest first. */
+    /** `[{ remoteRelayId, messageId, createdAt }]`, oldest first, ties in the order recorded. */
     listUnlocks(conversationId) {
       return listUnlocks.all(String(conversationId || '')).map((row) => ({
         remoteRelayId: row.remote_relay_id,