@zq-silk/yui 0.15.9 → 0.15.11

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

@@ -131,6 +131,8 @@ function detailActions() {
     sendMessage: (taskId, body, requestId, intent) => submitMutation(taskId + "/messages",
       "/api/tasks/" + encodeURIComponent(taskId) + "/messages",
       { body, requestId, ...(intent === undefined ? {} : { intent }) }),
+    controlInput: (taskId, payload, requestId) => submitMutation(taskId + "/control/" + requestId,
+      "/api/tasks/" + encodeURIComponent(taskId) + "/control", payload),
     updateTask: (taskId, patch, requestId) => submitMutation(taskId + "/metadata",
       "/api/tasks/" + encodeURIComponent(taskId) + "/metadata", { patch, requestId }),
     panels: (taskId) => requestJson("/api/tasks/" + encodeURIComponent(taskId) + "/panels",
@@ -659,9 +661,62 @@ elements.refresh.addEventListener("click", function () { refreshDashboard(); });
 elements.operatorTerminal.addEventListener("click", function () {
   openTerminal({ scope: "global", roleName: "operator" });
 });
+const globalDialog = document.querySelector("#global-input-dialog");
+const globalForm = document.querySelector("#global-input-form");
+const globalRole = document.querySelector("#global-input-role");
+const globalAction = document.querySelector("#global-input-action");
+const globalBody = document.querySelector("#global-input-body");
+const globalTarget = document.querySelector("#global-input-target");
+const globalThen = document.querySelector("#global-input-then");
+const globalSubmit = document.querySelector("#global-input-submit");
+const globalReceipt = document.querySelector("#global-input-receipt");
+const globalState = document.querySelector("#global-input-state");
+document.querySelector("#global-input-open").addEventListener("click", () => globalDialog.showModal());
+document.querySelector("#global-input-close").addEventListener("click", () => globalDialog.close());
+globalAction.addEventListener("change", () => {
+  document.querySelector("#global-input-body-label").hidden = globalAction.value === "interrupt";
+  document.querySelector("#global-input-target-label").hidden = globalAction.value === "queue";
+  document.querySelector("#global-input-then-label").hidden = globalAction.value !== "interrupt";
+  globalBody.required = globalAction.value !== "interrupt";
+  globalTarget.required = globalAction.value !== "queue";
+});
+document.querySelector("#global-input-inspect").addEventListener("click", async () => {
+  try {
+    const facts = await requestJson("/api/roles/" + encodeURIComponent(globalRole.value.trim()) + "/control");
+    globalState.textContent = JSON.stringify(facts, null, 2);
+    globalTarget.value = facts.turn?.nativeTurnId || facts.turn?.attemptId || "";
+  } catch (error) { globalState.textContent = error.message; }
+});
+globalForm.addEventListener("submit", async event => {
+  event.preventDefault();
+  if (globalSubmit.disabled) return;
+  globalSubmit.disabled = true;
+  const role = globalRole.value.trim();
+  const action = globalAction.value;
+  const requestId = crypto.randomUUID();
+  const input = { action, requestId };
+  if (action !== "interrupt") input.body = globalBody.value;
+  if (action !== "queue") input.expectedTarget = globalTarget.value.trim();
+  if (action === "interrupt" && globalThen.value.trim()) input.thenMessage = globalThen.value.trim();
+  globalReceipt.textContent = "Waiting for receipt · 等待回执 · " + requestId;
+  try {
+    const receipt = await submitMutation("global/" + role, "/api/roles/" + encodeURIComponent(role) + "/control", input);
+    const status = receipt.steer || receipt.interrupt || receipt.delivery || {};
+    globalReceipt.textContent = JSON.stringify(receipt);
+    const unknown = ["pending", "delivery-unknown", "steer-unknown", "interrupt-unknown"].includes(status.state)
+      || status.code === "DELIVERY_UNKNOWN";
+    globalSubmit.disabled = unknown;
+    if (!unknown && !status.code) globalBody.value = "";
+  } catch (error) {
+    globalReceipt.textContent = error.disposition === "not-submitted" ? error.message
+      : "Outcome unknown; read state before acting. 结果未知，请先读取状态，不要重发。 · " + requestId;
+    globalSubmit.disabled = error.disposition !== "not-submitted";
+  }
+});
 elements.detailBack.addEventListener("click", clearSelection);
 elements.terminalClose.addEventListener("click", closeTerminalPanel);
 document.addEventListener("keydown", function (event) {
+  if (globalDialog.open) return;
   const active = document.activeElement;
   const typing = active && ["INPUT", "SELECT", "TEXTAREA"].includes(active.tagName);
   if (event.key === "Escape" && terminalPanelOpen()) {

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

@@ -107,6 +107,7 @@ const EXEC_STATUS_TONE = {
   "attention": "is-danger",
   "progressing-with-attention": "is-warning",
   "blocked": "is-danger",
+  "conflicted": "is-warning",
   "working": "is-active",
   "completed": "is-muted",
   "retired": "is-muted",

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

@@ -238,6 +238,7 @@ const messages = {
     "stats.running": "running",
     "status.active": "Active",
     "status.all": "All",
+    "filter.unarchived": "Unarchived",
     "status.archived": "Archived",
     "status.completed": "Completed",
     "status.draft": "Draft",
@@ -305,6 +306,7 @@ const messages = {
     "workExec.candidateStatus.none": "None",
     "workExec.candidateStatus.observed": "Observed",
     "workExec.candidateStatus.unknown": "Unknown",
+    "workExec.action.execute-directly": "Leader executes directly",
     "workExec.action.dispatch-work": "Dispatch work",
     "workExec.action.wait-for-lanes": "Wait for Lanes",
     "workExec.action.retry-or-settle-lanes": "Retry or settle exact Lanes",
@@ -344,6 +346,7 @@ const messages = {
     "exec.action.inspect-attention": "Inspect attention",
     "exec.action.recover-leader": "Recover leader",
     "exec.action.resolve-blocker": "Resolve blocker",
+    "exec.action.resolve-integration-conflicts": "Resolve Integration conflicts",
     "exec.action.complete-task": "Complete task",
     "exec.action.none": "—",
     "exec.attention.leader-recovery": "Leader recovery",
@@ -624,6 +627,7 @@ const messages = {
     "stats.running": "运行中",
     "status.active": "进行中",
     "status.all": "全部",
+    "filter.unarchived": "未归档",
     "status.archived": "已归档",
     "status.completed": "已完成",
     "status.draft": "草稿",
@@ -691,6 +695,7 @@ const messages = {
     "workExec.candidateStatus.none": "无",
     "workExec.candidateStatus.observed": "已观测",
     "workExec.candidateStatus.unknown": "未知",
+    "workExec.action.execute-directly": "Leader 直接执行",
     "workExec.action.dispatch-work": "派发工作",
     "workExec.action.wait-for-lanes": "等待 Lane",
     "workExec.action.retry-or-settle-lanes": "重试或结算指定 Lane",
@@ -730,6 +735,7 @@ const messages = {
     "exec.action.inspect-attention": "检查注意项",
     "exec.action.recover-leader": "恢复负责人",
     "exec.action.resolve-blocker": "解决阻塞",
+    "exec.action.resolve-integration-conflicts": "解决集成冲突",
     "exec.action.complete-task": "完成任务",
     "exec.action.none": "—",
     "exec.attention.leader-recovery": "负责人恢复",

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

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,8 +66,10 @@ 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("filter.unarchived") : translatedStatus(t, "status", status);
+    const count = status === "all"
+      ? (counts.total === undefined ? undefined : counts.total - (counts.archived || 0))
+      : counts[status];
     const badge = btn.querySelector(".filter-count");
     if (badge) {
       if (count !== undefined && count !== null) {
@@ -105,6 +107,7 @@ 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" && task.status === "archived") return;
     if (state.filter !== "all" && task.status !== state.filter) return;
     if (!taskMatchesQuery(task, query, locale)) return;
     groups[taskGroupOf(task, attentionIds)].push(task);
@@ -215,7 +218,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));
   }

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">
@@ -91,6 +92,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}

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

@@ -99,6 +99,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 +162,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 +201,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)
@@ -429,6 +465,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

@@ -25,14 +25,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);