@zq-silk/yui 0.15.9 → 0.15.12

package/dist/web/assets/client/taskSurface.js

@@ -91,6 +91,112 @@ export function renderTaskSurface(container, data, t, locale, actions) {
     }
   });
   summary.append(chat);
+  // decision-3 three-action input control (queue / steer / interrupt). This is
+  // the same application-layer path the CLI drives; the Web surface adds no
+  // fourth action and no auto-fallback. Steer/interrupt name an exact current
+  // Turn (expected-target); a mismatch or missing Turn is a visible failure
+  // receipt, never a silent downgrade to a queue.
+  const control = node("details", "record-card");
+  control.append(node("summary", "", say("Redirect a running Role (queue / steer / interrupt)",
+    "改向运行中的 Role（排队／即时插话／打断）")));
+  const controlForm = node("form", "record-block");
+  const actionLabel = node("label", "", say("Action", "动作"));
+  const action = node("select", "");
+  for (const [val, en, cn] of [["queue", "Queue (deliver at next opportunity)", "排队（下次机会送达）"],
+    ["steer", "Steer (inject into the exact current Turn)", "即时插话（注入当前 Turn）"],
+    ["interrupt", "Interrupt (native cancel of the current Turn)", "打断（原生取消当前 Turn）"]]) {
+    const opt = node("option", "", say(en, cn));
+    opt.value = val;
+    action.append(opt);
+  }
+  actionLabel.append(action);
+  const roleLabel = node("label", "", say("Target Role", "目标 Role"));
+  const role = node("input", "");
+  role.placeholder = say("e.g. worker (blank = Leader for queue)", "如 worker（排队留空 = Leader）");
+  roleLabel.append(role);
+  const bodyLabel = node("label", "", say("Message", "消息内容"));
+  const body = node("textarea", "");
+  body.maxLength = 8000;
+  bodyLabel.append(body);
+  const targetLabel = node("label", "", say("Expected current Turn", "预期当前 Turn"));
+  const expectedTarget = node("input", "");
+  expectedTarget.placeholder = say("exact current Turn id (attempt/native)", "当前 Turn 的精确标识");
+  targetLabel.append(expectedTarget);
+  const workItemLabel = node("label", "", say("Work Item (optional)", "Work Item（可选）"));
+  const workItem = node("input", "");
+  workItemLabel.append(workItem);
+  const thenLabel = node("label", "", say("Then-message ref (optional)", "打断后续消息引用（可选）"));
+  const thenMessage = node("input", "");
+  thenMessage.placeholder = say("task/message id already saved", "已保存的 task/message 引用");
+  thenLabel.append(thenMessage);
+  const controlSend = node("button", "record-open", say("Submit control", "提交控制"));
+  controlSend.type = "submit";
+  controlSend.disabled = !["active", "draft"].includes(task.status);
+  const controlSent = node("p", "muted", say("Not submitted", "未提交"));
+  controlSent.setAttribute("role", "status");
+  // Field visibility follows the selected action so the form can only submit a
+  // legal shape: interrupt carries no body; queue needs no expected-target;
+  // then-message is an interrupt-only continuation.
+  const applyAction = () => {
+    const kind = action.value;
+    bodyLabel.hidden = kind === "interrupt";
+    targetLabel.hidden = kind === "queue";
+    thenLabel.hidden = kind !== "interrupt";
+    roleLabel.hidden = false;
+    role.required = kind !== "queue";
+    body.required = kind !== "interrupt";
+    expectedTarget.required = kind !== "queue";
+  };
+  action.addEventListener("change", applyAction);
+  applyAction();
+  controlForm.addEventListener("input", () => { controlForm.dataset.unsent = "true"; });
+  controlForm.append(actionLabel, roleLabel, bodyLabel, targetLabel, workItemLabel, thenLabel, controlSend, controlSent);
+  controlForm.addEventListener("submit", async (event) => {
+    event.preventDefault();
+    if (controlSend.disabled) return;
+    controlSend.disabled = true;
+    controlForm.dataset.unsent = "true";
+    const requestId = crypto.randomUUID();
+    const kind = action.value;
+    const payload = { action: kind, requestId };
+    if (kind === "interrupt") {
+      payload.role = role.value.trim();
+      payload.expectedTarget = expectedTarget.value.trim();
+      if (thenMessage.value.trim()) payload.thenMessage = thenMessage.value.trim();
+    } else {
+      payload.body = body.value;
+      if (kind === "steer") { payload.to = role.value.trim(); payload.expectedTarget = expectedTarget.value.trim(); }
+      else if (role.value.trim()) payload.to = role.value.trim();
+      if (workItem.value.trim()) payload.workItem = workItem.value.trim();
+    }
+    controlSent.textContent = say("Waiting for receipt · ", "等待回执 · ") + requestId;
+    try {
+      const receipt = await actions.controlInput(task.id, payload, requestId);
+      // The receipt states exactly what settled: a live steer/interrupt names its
+      // Host outcome; a queue or a not-delivered/idempotent result names its own
+      // state. None of these implies the Provider executed the input.
+      const settled = receipt.steer || receipt.interrupt || receipt.delivery
+        || { state: receipt.disposition };
+      const outcome = settled.outcome ? " · outcome " + settled.outcome : "";
+      const detail = settled.detail ? " · " + settled.detail : "";
+      controlSent.textContent = say("Receipt: ", "回执：") + receipt.action + " · " + settled.state
+        + outcome + detail + (receipt.record ? " · " + receipt.record.id : "");
+      controlForm.dataset.unsent = "false";
+      controlSend.disabled = false;
+    } catch (error) {
+      if (error.disposition === "not-submitted") {
+        controlSent.textContent = say("Not submitted: ", "未提交：") + error.message;
+        controlSend.disabled = false;
+        return;
+      }
+      // A committed input whose live edge is delivery-unknown must not be
+      // blindly re-sent under a new requestId or a different action.
+      controlSent.textContent = say("Unknown outcome. Re-read the Session before acting; do not resend · ",
+        "结果未知。请先重新读取 Session，不要盲目重发 · ") + requestId;
+    }
+  });
+  control.append(controlForm);
+  summary.append(control);
   // A Draft's Leader conversation IS its planning Turn, so this entry point does
   // reach a Leader. Report the real planning facts the snapshot carries — Turn,
   // Session, environment and the time they were observed — instead of asserting
@@ -277,7 +383,8 @@ export function renderTaskSurface(container, data, t, locale, actions) {
     const active = values("run").find((run) => run.roleName === role.name && run.status === "active");
     const incomplete = core.omitted.records > 0 || records("run").some((entry) => entry.omitted);
     roles.append(roleCard({
-      ...role, status: active || incomplete ? "unknown" : "idle",
+      ...role, providerRetry: entry.providerRetry,
+      status: entry.providerRetry?.status === "waiting" ? "waiting" : active || incomplete ? "unknown" : "idle",
       effectiveLaunch: active ? active.effective : null,
       launchDrift: active && active.effective.sourceDesiredRevision !== role.launchRevision
     }, task, t, locale, actions));

package/dist/web/assets/client/view.js

@@ -53,7 +53,7 @@ export function renderFilters(container, state, t, onFilter) {
         dot.classList.add(status);
         btn.append(dot);
       }
-      btn.append(node("span", "filter-label", translatedStatus(t, "status", status)));
+      btn.append(node("span", "filter-label", status === "all" ? t("filter.unarchived") : translatedStatus(t, "status", status)));
       const badge = node("span", "filter-count");
       btn.append(badge);
       btn.addEventListener("click", function () { onFilter(status); });
@@ -66,10 +66,17 @@ export function renderFilters(container, state, t, onFilter) {
     if (!btn) return;
     btn.classList.toggle("is-active", state.filter === status);
     const label = btn.querySelector(".filter-label");
-    if (label) label.textContent = translatedStatus(t, "status", status);
-    const count = status === "all" ? counts.total : counts[status];
+    if (label) label.textContent = status === "all"
+      ? t(state.catalogAll ? "catalog.all" : "filter.unarchived") : translatedStatus(t, "status", status);
+    const count = status === "all"
+      ? (counts.total === undefined ? undefined : counts.total - (state.catalogAll ? 0 : counts.archived || 0))
+      : counts[status];
     const badge = btn.querySelector(".filter-count");
     if (badge) {
+      if (status === "archived" && state.catalogScope && state.catalogScope.archived === "excluded") {
+        badge.hidden = true;
+        return;
+      }
       if (count !== undefined && count !== null) {
         badge.textContent = String(count);
         badge.hidden = false;
@@ -81,7 +88,7 @@ export function renderFilters(container, state, t, onFilter) {
 }
 
 function taskGroupOf(task, attentionIds) {
-  if (attentionIds.has(task.id)) return "attention";
+  if (attentionIds.has(task.id) || (task.attention && (task.attention.openInputs > 0 || task.attention.unknownOperations > 0))) return "attention";
   if (task.status === "active") return "active";
   if (task.status === "draft") return "draft";
   if (task.status === "cancelled") return "cancelled";
@@ -105,8 +112,9 @@ export function renderTasks(container, state, t, locale, onSelect) {
   const attentionIds = new Set((state.attention || []).map(function (item) { return item.taskId; }));
   const groups = { attention: [], active: [], draft: [], finished: [], cancelled: [], archived: [] };
   (state.tasks || []).forEach(function (task) {
+    if (state.filter === "all" && !state.catalogAll && task.status === "archived") return;
     if (state.filter !== "all" && task.status !== state.filter) return;
-    if (!taskMatchesQuery(task, query, locale)) return;
+    if (!state.catalogScope && !taskMatchesQuery(task, query, locale)) return;
     groups[taskGroupOf(task, attentionIds)].push(task);
   });
 
@@ -163,15 +171,33 @@ export function renderOverview(detail, state, t, locale, onSelect) {
   );
   wrap.append(rail);
 
+  if (state.catalogAttention) {
+    const catalog = node("section", "overview-block");
+    catalog.append(sectionHead(t("catalog.attention")));
+    catalog.append(node("p", "", t("catalog.signalsHelp")));
+    const groups = node("div", "overview-list");
+    Object.entries(state.catalogAttention).forEach(function (entry) {
+      const kind = entry[0], value = entry[1];
+      const button = node("button", "overview-row",
+        t("catalog." + kind) + " · " + value.count + " / " + value.taskCount + " " + t("catalog.tasks"));
+      button.type = "button";
+      button.dataset.catalogAttention = kind;
+      button.disabled = value.taskCount === 0;
+      groups.append(button);
+    });
+    catalog.append(groups);
+    wrap.append(catalog);
+  }
   const inbox = node("section", "overview-block");
   const inboxHead = sectionHead(t("overview.inbox"), {
-    count: (state.attention || []).length
+    count: counts ? counts.openInputs : (state.attention || []).length
   });
   inbox.append(inboxHead);
   const items = state.attention || [];
   if (!items.length) {
     const empty = node("div", "inbox-empty");
-    empty.append(node("span", "dot"), node("span", "", t("overview.inboxEmpty")));
+    empty.append(node("span", "dot"), node("span", "", counts && counts.openInputs > 0
+      ? t("catalog.inspectInputs") : t("overview.inboxEmpty")));
     inbox.append(empty);
   } else {
     const list = node("div", "inbox-list");
@@ -181,6 +207,7 @@ export function renderOverview(detail, state, t, locale, onSelect) {
     inbox.append(list);
   }
   wrap.append(inbox);
+  if (state.catalogScope) wrap.append(node("p", "", t("catalog.pageScope")));
 
   // Tasks whose Task-first projection says they need attention: blocked,
   // recovering, or in an attention state. This replaces the raw stalled-AgentRun
@@ -215,7 +242,7 @@ export function renderOverview(detail, state, t, locale, onSelect) {
   if (activeTasks.length) {
     duo.append(overviewBlock(t("overview.activeNow"), activeTasks, t, locale, onSelect));
   }
-  const recentTasks = (state.tasks || []).slice().sort(byNewest).slice(0, 8);
+  const recentTasks = (state.tasks || []).filter(function (task) { return task.status !== "archived"; }).sort(byNewest).slice(0, 8);
   if (recentTasks.length) {
     duo.append(overviewBlock(t("overview.recent"), recentTasks, t, locale, onSelect));
   }
@@ -332,9 +359,13 @@ export function renderTaskDetail(detail, data, t, locale, actions) {
         "muted mono",
         project.directory + " · " + project.coverage + " · "
           + (project.expectedLocalCommit ? project.expectedLocalCommit.slice(0, 12) : "unknown")
+          + " → " + (project.deliveryLocalCommit ? project.deliveryLocalCommit.slice(0, 12) : "unknown")
           + " → "
           + (project.remoteCommit ? project.remoteCommit.slice(0, 12) : "unknown")
+          + " · PR/MR: " + (project.state || "none")
+          + (project.adoption ? " · " + project.adoption.id : "")
       ));
+      card.append(node("p", "record-copy", project.reason));
     });
     summaryBody.append(card);
   }

package/dist/web/assets/shell.js

@@ -30,6 +30,7 @@ export const DASHBOARD_HTML = `<!doctype html>
         </div>
         <span class="live" title="Local loopback"><i aria-hidden="true"></i><span class="sr-only" data-i18n="brand.connection">Local loopback</span></span>
       </div>
+      <button id="global-input-open" class="operator-open" type="button">Global inputs · 全局消息</button>
       <label class="search">
         <span class="sr-only" data-i18n="search.label">Search tasks</span>
         <input id="search" type="search" placeholder="Filter by title, ID, tag, or project…" data-i18n-placeholder="search.placeholder">
@@ -37,6 +38,12 @@ export const DASHBOARD_HTML = `<!doctype html>
       </label>
       <div id="status-filters" class="filters" role="group" aria-label="Filter by status" data-i18n-aria-label="filters.label"></div>
       <div id="task-list" class="task-list" aria-label="Tasks" data-i18n-aria-label="board.title" aria-live="polite"><div class="loading" data-i18n="loading.dashboard">Reading local state…</div></div>
+      <div id="catalog-controls" class="catalog-pager" aria-live="polite">
+        <button id="catalog-reset" type="button" data-i18n="catalog.first">First page</button>
+        <span id="catalog-count"></span>
+        <button id="catalog-next" type="button" data-i18n="catalog.next" disabled>Next page</button>
+        <button id="catalog-attention-reset" type="button" data-i18n="catalog.clearAttention" hidden>Clear attention filter</button>
+      </div>
       <div class="sidebar-foot">
         <div class="sidebar-controls">
           <label class="select-control">
@@ -91,6 +98,28 @@ export const DASHBOARD_HTML = `<!doctype html>
       </nav>
       <main id="detail" class="detail" aria-labelledby="page-title" tabindex="-1"></main>
     </div>
+    <dialog id="global-input-dialog" class="global-input-dialog" aria-labelledby="global-input-title">
+      <h2 id="global-input-title">Global Role input · 全局 Role 消息</h2>
+      <p class="muted">Queue is the default. A cancel request does not prove the Turn stopped.<br>默认排队；取消请求不代表执行已停止。</p>
+      <form id="global-input-form" class="record-block">
+        <label>Role<input id="global-input-role" value="operator" required pattern="[A-Za-z0-9_-]+"></label>
+        <label>Action · 动作<select id="global-input-action">
+          <option value="queue">Queue · 排队</option>
+          <option value="steer">Steer · 当前轮插话</option>
+          <option value="interrupt">Interrupt · 请求取消</option>
+        </select></label>
+        <label id="global-input-body-label">Message · 消息<textarea id="global-input-body" maxlength="8000" required></textarea></label>
+        <label id="global-input-target-label" hidden>Expected Turn · 精确目标<input id="global-input-target"></label>
+        <label id="global-input-then-label" hidden>Then-message ID · 后续消息引用<input id="global-input-then"></label>
+        <div class="record-actions">
+          <button id="global-input-inspect" type="button" class="record-open">Read state · 读取状态</button>
+          <button id="global-input-submit" type="submit" class="record-open">Submit · 提交</button>
+          <button id="global-input-close" type="button" class="record-open">Close · 关闭</button>
+        </div>
+        <p id="global-input-receipt" role="status" class="muted">Not submitted · 未提交</p>
+        <pre id="global-input-state" class="global-input-state"></pre>
+      </form>
+    </dialog>
     <aside id="terminal-panel" class="terminal-panel" aria-labelledby="terminal-title" aria-hidden="true" hidden>
       <header class="terminal-head">
         <div>

package/dist/web/assets/styles/layout.js

@@ -9,7 +9,7 @@ body{margin:0;min-width:320px;height:100vh;overflow:hidden;font-size:14px}
 .app-shell{display:grid;grid-template-columns:var(--sidebar-w) minmax(0,1fr) 0;grid-template-rows:100vh;height:100vh;transition:grid-template-columns var(--motion-slow) var(--ease)}
 body.terminal-active .app-shell{grid-template-columns:var(--sidebar-w) minmax(0,1fr) var(--terminal-w)}
 /* Sidebar = persistent work index */
-.sidebar{display:flex;flex-direction:column;min-height:0;height:100vh;padding:16px 14px 14px}
+.sidebar{display:flex;flex-direction:column;min-width:0;min-height:0;height:100vh;padding:16px 14px 14px}
 .sidebar-brand{display:flex;gap:10px;align-items:center;flex:none;margin-bottom:14px}
 .brand-text{display:grid;gap:3px;min-width:0;flex:1}
 .sidebar .search{flex:none;margin-bottom:10px}
@@ -19,6 +19,13 @@ body.terminal-active .app-shell{grid-template-columns:var(--sidebar-w) minmax(0,
 .task-group-head{display:flex;align-items:baseline;gap:8px;padding:3px 4px 2px}
 .sidebar-foot{flex:none;padding-top:10px;margin-top:8px;display:grid;gap:8px}
 .sidebar-controls{display:grid;grid-template-columns:1fr 1fr;gap:8px;align-items:center}
+.catalog-pager{display:grid;grid-template-columns:1fr 1fr;gap:6px;flex:none;padding-top:10px}
+.catalog-pager span{grid-column:1/-1;grid-row:1;text-align:center;font-size:11px;color:var(--muted)}
+.catalog-pager button{min-height:32px;min-width:0;border:1px solid var(--border);border-radius:6px;background:var(--bg);color:var(--text);font:inherit;font-size:11px;cursor:pointer}
+.catalog-pager button:hover:not(:disabled){border-color:var(--accent)}
+.catalog-pager button:focus-visible{outline:2px solid var(--accent);outline-offset:2px}
+.catalog-pager button:disabled{opacity:.45;cursor:default}
+#catalog-attention-reset{grid-column:1/-1}
 /* Main column = top bar + optional section nav + reading surface */
 .main-col{display:flex;flex-direction:column;min-width:0;min-height:0;height:100vh;overflow-y:auto;scrollbar-gutter:stable}
 .topbar{position:sticky;top:0;z-index:30;flex:none;display:flex;align-items:center;justify-content:space-between;gap:18px;padding:11px max(var(--page-space),calc((100% - 1100px) / 2));background:color-mix(in srgb,var(--bg) 92%,transparent);backdrop-filter:blur(10px);-webkit-backdrop-filter:blur(10px);border-bottom:1px solid var(--border)}

package/dist/web/assets/styles/widgets.js

@@ -15,6 +15,18 @@ body{background:var(--ambient),var(--bg);background-attachment:fixed;color:var(-
 .skip-link:focus{top:14px}
 button{font:inherit;cursor:pointer}
 input:focus-visible,select:focus-visible,button:focus-visible,.task:focus-visible,.tab:focus-visible,.overview-row:focus-visible{outline:none;box-shadow:0 0 0 2px var(--bg),0 0 0 4px var(--accent)}
+.global-input-dialog{width:min(34rem,calc(100vw - 2rem));max-height:85vh;overflow:auto;color:var(--text);background:var(--bg-1);border:1px solid var(--border-strong);border-radius:var(--radius-lg);padding:var(--page-space)}
+.global-input-dialog::backdrop{background:color-mix(in srgb,var(--bg) 75%,transparent)}
+.global-input-dialog form,.global-input-dialog label{display:grid;gap:8px}
+.global-input-dialog form{gap:14px}
+.global-input-dialog p{overflow-wrap:anywhere}
+.global-input-dialog form,.global-input-dialog label{min-width:0}
+.global-input-dialog input,.global-input-dialog select,.global-input-dialog textarea{width:100%;box-sizing:border-box;padding:10px;color:var(--text);background:var(--bg);border:1px solid var(--border-strong);border-radius:var(--radius)}
+.global-input-dialog textarea{min-height:100px}
+.global-input-dialog .record-actions{display:flex;flex-wrap:wrap;gap:8px}
+.global-input-dialog button{min-height:44px}
+.global-input-state{white-space:pre-wrap;overflow-wrap:anywhere;font:12px var(--font-mono)}
+.global-input-dialog [hidden]{display:none}
 /* Sidebar */
 .sidebar{border-right:1px solid var(--border);background:color-mix(in srgb,var(--bg-1) 84%,transparent);backdrop-filter:blur(12px);-webkit-backdrop-filter:blur(12px)}
 .brand-mark{width:40px;height:40px;flex:none;display:grid;place-items:center;font-family:var(--font-display);font-size:21px;font-weight:600;color:var(--on-accent);border-radius:11px;background:linear-gradient(140deg,var(--accent),var(--accent-2));box-shadow:var(--glow)}

package/dist/web/webServer.js

@@ -1,11 +1,12 @@
 import { randomBytes, timingSafeEqual } from "node:crypto";
 import { createServer } from "node:http";
 import WebSocket, { WebSocketServer } from "ws";
-import { usageError } from "../errors/cliError.js";
+import { CliError, usageError } from "../errors/cliError.js";
+import { parseTaskCatalogOptions } from "../context/taskCatalog.js";
 import { WebRequestRejected } from "./webMutation.js";
 import { TASK_SUBMISSION_INTENTS } from "../message/message.js";
 import { DASHBOARD_HTML, findWebAsset } from "./assets/assetManifest.js";
-import { buildWebDashboardSnapshot, buildWebTaskDetail } from "./webSnapshot.js";
+import { buildWebDashboardSnapshot, buildWebTaskCatalog, buildWebTaskDetail } from "./webSnapshot.js";
 const MAX_JSON_BODY_BYTES = 16 * 1024;
 const MAX_TERMINAL_MESSAGE_BYTES = 64 * 1024;
 const MAX_TERMINAL_BUFFERED_BYTES = 1024 * 1024;
@@ -99,6 +100,38 @@ async function handleHttpRequest(request, response, store, dependencies, token,
         sendJson(response, 403, { error: "Invalid Yui web token.", disposition: "not-submitted" }, method === "HEAD");
         return;
     }
+    const globalControl = /^\/api\/roles\/([^/]+)\/control$/.exec(pathname);
+    if (globalControl && dependencies.surface) {
+        try {
+            const roleName = decodeURIComponent(globalControl[1]);
+            if (!/^[A-Za-z0-9_-]+$/.test(roleName))
+                throw new WebRequestRejected("Invalid Global Role.");
+            if (method === "GET") {
+                sendJson(response, 200, dependencies.surface.globalState(roleName), false);
+            }
+            else if (method === "POST") {
+                const body = await readMutationBody(request);
+                if (typeof body !== "object" || body === null || Array.isArray(body)
+                    || Object.keys(body).some(key => !["action", "requestId", "body", "expectedTarget", "thenMessage"].includes(key))) {
+                    throw new WebRequestRejected("Global input accepts only action, input and exact target fields.");
+                }
+                const input = body;
+                const parsed = parseWebControlInput({ ...input,
+                    ...(input.action === "interrupt" ? { role: roleName }
+                        : input.action === "steer" ? { to: roleName } : {}) });
+                sendJson(response, 200, {
+                    ...await dependencies.surface.globalControl(roleName, parsed), requestId: parsed.requestId
+                }, false);
+            }
+            else
+                sendJson(response, 405, { error: "Method not allowed.", disposition: "not-submitted" }, false);
+        }
+        catch (error) {
+            sendJson(response, 409, { error: error instanceof Error ? error.message : "Global input unavailable.",
+                disposition: error instanceof WebRequestRejected ? "not-submitted" : "unknown" }, false);
+        }
+        return;
+    }
     const panelTarget = /^\/api\/tasks\/([^/]+)\/panels$/.exec(pathname);
     if (panelTarget && dependencies.panels) {
         try {
@@ -130,7 +163,7 @@ async function handleHttpRequest(request, response, store, dependencies, token,
         }
         return;
     }
-    const surfaceTarget = /^\/api\/tasks\/([^/]+)\/(context|delta|inspect|metadata|messages)$/.exec(pathname);
+    const surfaceTarget = /^\/api\/tasks\/([^/]+)\/(context|delta|inspect|metadata|messages|control)$/.exec(pathname);
     if (surfaceTarget && dependencies.surface) {
         try {
             let taskId;
@@ -169,6 +202,10 @@ async function handleHttpRequest(request, response, store, dependencies, token,
                 // requestId is threaded as the submission key (§2.3) and echoed back on the receipt.
                 value = { ...dependencies.surface.message(taskId, body.body, intent, body.requestId), requestId: body.requestId };
             }
+            else if (method === "POST" && action === "control") {
+                const body = await readMutationBody(request);
+                value = { ...await dependencies.surface.control(taskId, parseWebControlInput(body)), requestId: parseWebControlRequestId(body) };
+            }
             else if (method === "POST" && action === "metadata") {
                 const body = await readMutationBody(request);
                 if (typeof body !== "object" || body === null || Array.isArray(body)
@@ -200,7 +237,13 @@ async function handleHttpRequest(request, response, store, dependencies, token,
                 sendAsset(response, asset, method === "HEAD");
             }
             else if (pathname === "/api/dashboard") {
-                sendJson(response, 200, buildWebDashboardSnapshot(store, now()), method === "HEAD");
+                const query = new URL(request.url, "http://localhost").searchParams;
+                const snapshot = query.has("view")
+                    ? buildWebTaskCatalog(store, parseTaskCatalogOptions([...query].flatMap(([key, value]) => key === "all"
+                        ? (value === "true" ? ["--all"] : ["--invalid-all"])
+                        : [`--${key}`, value])))
+                    : buildWebDashboardSnapshot(store, now());
+                sendJson(response, 200, snapshot, method === "HEAD");
             }
             else if (pathname.startsWith("/api/tasks/")) {
                 const taskId = decodeURIComponent(pathname.slice("/api/tasks/".length));
@@ -214,6 +257,10 @@ async function handleHttpRequest(request, response, store, dependencies, token,
             }
         }
         catch (error) {
+            if (error instanceof CliError) {
+                sendJson(response, 400, { error: error.message }, method === "HEAD");
+                return;
+            }
             if (error instanceof URIError) {
                 sendJson(response, 400, { error: "Invalid URL encoding." }, method === "HEAD");
                 return;
@@ -429,6 +476,86 @@ function parseAnswerPath(pathname) {
         return null;
     }
 }
+/** The three-action control body is validated to the exact CLI-equivalent
+ * shape before it reaches the surface, so an unknown or malformed field is a
+ * visible not-submitted rejection rather than a silent default. `requestId` is
+ * the caller-supplied idempotency key common to all three actions. */
+function parseWebControlRequestId(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new WebRequestRejected("Control input must be an object.");
+    }
+    const requestId = value.requestId;
+    if (typeof requestId !== "string" || !requestId.trim()) {
+        throw new WebRequestRejected("A non-empty requestId is required.");
+    }
+    return requestId;
+}
+function requiredControlString(input, key) {
+    const value = input[key];
+    if (typeof value !== "string" || !value.trim()) {
+        throw new WebRequestRejected(`${key} is required.`);
+    }
+    return value;
+}
+function optionalControlString(input, key) {
+    if (!(key in input) || input[key] === undefined)
+        return undefined;
+    const value = input[key];
+    if (typeof value !== "string" || !value.trim()) {
+        throw new WebRequestRejected(`${key} must be a non-empty string when provided.`);
+    }
+    return value;
+}
+function parseWebControlInput(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new WebRequestRejected("Control input must be an object.");
+    }
+    const input = value;
+    const action = input.action;
+    if (action === "queue") {
+        for (const key of Object.keys(input)) {
+            if (!["action", "body", "requestId", "to", "workItem", "reviewRound"].includes(key)) {
+                throw new WebRequestRejected(`Unexpected field for queue: ${key}.`);
+            }
+        }
+        if (input.workItem !== undefined && input.reviewRound !== undefined) {
+            throw new WebRequestRejected("A queue takes at most one of workItem or reviewRound.");
+        }
+        return { action: "queue", body: requiredControlString(input, "body"),
+            requestId: requiredControlString(input, "requestId"),
+            ...(optionalControlString(input, "to") === undefined ? {} : { to: optionalControlString(input, "to") }),
+            ...(optionalControlString(input, "workItem") === undefined ? {} : { workItem: optionalControlString(input, "workItem") }),
+            ...(optionalControlString(input, "reviewRound") === undefined ? {} : { reviewRound: optionalControlString(input, "reviewRound") }) };
+    }
+    if (action === "steer") {
+        for (const key of Object.keys(input)) {
+            if (!["action", "body", "requestId", "expectedTarget", "to", "workItem", "reviewRound"].includes(key)) {
+                throw new WebRequestRejected(`Unexpected field for steer: ${key}.`);
+            }
+        }
+        if (input.workItem !== undefined && input.reviewRound !== undefined) {
+            throw new WebRequestRejected("A steer takes at most one of workItem or reviewRound.");
+        }
+        return { action: "steer", body: requiredControlString(input, "body"),
+            requestId: requiredControlString(input, "requestId"),
+            expectedTarget: requiredControlString(input, "expectedTarget"),
+            to: requiredControlString(input, "to"),
+            ...(optionalControlString(input, "workItem") === undefined ? {} : { workItem: optionalControlString(input, "workItem") }),
+            ...(optionalControlString(input, "reviewRound") === undefined ? {} : { reviewRound: optionalControlString(input, "reviewRound") }) };
+    }
+    if (action === "interrupt") {
+        for (const key of Object.keys(input)) {
+            if (!["action", "requestId", "expectedTarget", "role", "thenMessage"].includes(key)) {
+                throw new WebRequestRejected(`Unexpected field for interrupt: ${key}.`);
+            }
+        }
+        return { action: "interrupt", requestId: requiredControlString(input, "requestId"),
+            expectedTarget: requiredControlString(input, "expectedTarget"),
+            role: requiredControlString(input, "role"),
+            ...(optionalControlString(input, "thenMessage") === undefined ? {} : { thenMessage: optionalControlString(input, "thenMessage") }) };
+    }
+    throw new WebRequestRejected("action must be one of queue, steer, or interrupt.");
+}
 function parseWebInputAnswer(value) {
     if (typeof value !== "object" || value === null || Array.isArray(value)) {
         throw new Error("Input answer must be an object.");

package/dist/web/webSnapshot.js

@@ -1,3 +1,5 @@
+import { providerRetryProjection } from "../runtime/providerRetry.js";
+import { readTaskCatalog } from "../context/taskCatalog.js";
 import { isRoleRunStalled, latestRunDurableProgressAt } from "../scheduler/roleRunStall.js";
 import { retiredTaskRecordIds } from "../task/taskRecordRetirement.js";
 import { buildTaskExecutionProjection } from "../scheduler/taskExecutionProjection.js";
@@ -9,6 +11,9 @@ import { runExecutionObservation } from "../agentRun/agentRun.js";
 import { resolveRuntimeHealth } from "../config/yuiConfig.js";
 import { projectSessionTokenMetrics, resolveSessionTokenIdentity } from "../runtime/sessionTokenMetrics.js";
 import { projectTaskRemoteDelivery } from "../task/remoteDelivery.js";
+export function buildWebTaskCatalog(store, options) {
+    return store.transaction(reader => readTaskCatalog(reader, options));
+}
 export function buildWebDashboardSnapshot(store, now = new Date()) {
     return store.transaction((reader) => {
         const statusCounts = {
@@ -25,14 +30,15 @@ export function buildWebDashboardSnapshot(store, now = new Date()) {
             statusCounts[task.status] += 1;
             const taskOpenInputs = reader.listInputRequests(task.id)
                 .filter((request) => request.status === "open").length;
-            openInputs += taskOpenInputs;
+            if (task.status !== "archived")
+                openInputs += taskOpenInputs;
             const taskOpen = reader.listInputRequests(task.id)
                 .filter((request) => request.status === "open");
-            for (const request of taskOpen) {
+            for (const request of task.status === "archived" ? [] : taskOpen) {
                 attention.push({ taskId: task.id, taskTitle: task.title, request });
             }
             const events = reader.listEvents?.(task.id) ?? [];
-            const needsAttentionCount = reader.listRuns(task.id)
+            const needsAttentionCount = task.status === "archived" ? 0 : reader.listRuns(task.id)
                 .filter((run) => run.status === "active" && isRoleRunStalled(events, run.id))
                 .length;
             const execution = buildTaskExecutionProjection(reader, task.id, task, now);
@@ -94,12 +100,15 @@ export function buildWebTaskDetail(store, taskId, now = new Date()) {
             const activeSession = sessions?.sessions[activeRun?.effective.agentId ?? sessions.activeAgentId];
             const effectiveLaunch = activeRun?.effective ?? activeSession?.effective ?? null;
             const delivery = sessions?.providerBinding?.run?.status;
+            const providerRetry = providerRetryProjection(sessions?.providerBinding);
             return {
                 ...role,
+                providerRetry,
                 // An open record is not proof that its Agent is running.
-                status: delivery === "accepted" ? "running"
-                    : delivery === "submitting" || delivery === "deferred" ? "waiting"
-                        : activeSession === undefined && activeRun === undefined ? "idle" : "unknown",
+                status: providerRetry?.status === "waiting" ? "waiting"
+                    : delivery === "accepted" ? "running"
+                        : delivery === "submitting" || delivery === "deferred" ? "waiting"
+                            : activeSession === undefined && activeRun === undefined ? "idle" : "unknown",
                 sessionTokens: projectSessionTokenMetrics(events, resolveSessionTokenIdentity(activeSession === undefined
                     ? null
                     : { taskId, roleName: role.name, ...activeSession })),
@@ -161,6 +170,7 @@ function webRemoteDelivery(reader, task) {
         publications: reader.listPublicationReferences(task.id),
         managedWorkspaces: reader.listManagedWorkspaces(task.id),
         runs: reader.listRuns(task.id),
+        integrations: reader.listIntegrationAttempts(task.id),
         currentCandidate: null
     });
 }