@zq-silk/yui 0.15.8 → 0.15.11

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

@@ -33,27 +33,47 @@ export function renderTaskSurface(container, data, t, locale, actions) {
   message.required = true;
   message.maxLength = 8000;
   chatLabel.append(message);
+  // Submission intent is an explicit user choice, never inferred from the body
+  // (task-32 §2.5); discuss is the default so the control matches the service.
+  const intentLabel = node("label", "", say("Intent", "提交意图"));
+  const intentSelect = node("select", "");
+  const intentOptions = [
+    ["discuss", say("Discuss — route to planning", "讨论 — 进入规划")],
+    ["record", say("Record — save only", "记录 — 仅保存")],
+    ["develop", say("Develop — request activation", "开发 — 请求激活")]
+  ];
+  for (const [value, text] of intentOptions) {
+    const option = node("option", "", text);
+    option.value = value;
+    intentSelect.append(option);
+  }
+  intentSelect.value = "discuss";
+  intentLabel.append(intentSelect);
   chat.addEventListener("input", () => { chat.dataset.unsent = message.value ? "true" : "false"; });
   const send = node("button", "record-open", say("Send", "发送"));
   send.type = "submit";
   send.disabled = !["active", "draft"].includes(task.status);
   const sent = node("p", "muted", say("Not submitted", "未提交"));
   sent.setAttribute("role", "status");
-  chat.append(chatLabel, send, sent);
+  // §2.5 facets render here, one per line; cleared and repopulated on every submit.
+  const facets = node("div", "section-body");
+  facets.dataset.submissionFacets = "";
+  chat.append(chatLabel, intentLabel, send, sent, facets);
   chat.addEventListener("submit", async (event) => {
     event.preventDefault();
     if (send.disabled) return;
     send.disabled = true;
     chat.dataset.unsent = "true";
     const requestId = crypto.randomUUID();
+    const intent = intentSelect.value;
+    clear(facets);
     sent.textContent = say("Waiting for receipt · ", "等待回执 · ") + requestId;
     try {
-      const receipt = await actions.sendMessage(task.id, message.value, requestId);
-      sent.textContent = (receipt.disposition === "queued"
-        ? say("Queued for Leader; not proof of execution · ", "已为 Leader 排队，不代表已执行 · ")
-        : say("Saved to Task context; this Task's Leader is not waking · ",
-          "已保存到 Task 上下文；该 Task 的 Leader 不会被唤醒 · "))
-        + receipt.record.id;
+      // requestId is the submission key: the same key retried returns the original
+      // Message and routing rather than a second submission (task-32 §2.3).
+      const receipt = await actions.sendMessage(task.id, message.value, requestId, intent);
+      sent.textContent = say("Saved · ", "已保存 · ") + receipt.record.id;
+      renderSubmissionFacets(facets, receipt.submission, say);
       message.value = "";
       chat.dataset.unsent = "false";
       send.disabled = false;
@@ -63,11 +83,120 @@ export function renderTaskSurface(container, data, t, locale, actions) {
         send.disabled = false;
         return;
       }
+      // A lost response must never auto-replay a write; the same requestId is safe
+      // to resend by hand because the server dedups on it (§2.3), but the user
+      // reloads and inspects first rather than blindly resending.
       sent.textContent = say("Unknown submission outcome. Reload and inspect saved messages before sending again · ",
         "提交结果未知。请重新加载并检查已保存消息，不要盲目重发 · ") + requestId;
     }
   });
   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
@@ -350,4 +479,70 @@ export function renderTaskSurface(container, data, t, locale, actions) {
   scaffold.append(panels);
   container.append(scaffold);
 }
+
+// Render each task-32 §2.5 submission facet on its own line, never collapsed into
+// a single "started". This repo has one current server contract: every submission
+// returns its faceted receipt, so there is no old-server flat-disposition path to
+// fall back to. A missing facet block is a contract violation, reported as a
+// limited diagnostic rather than reinterpreted as a plausible flat result.
+function renderSubmissionFacets(container, submission, say) {
+  clear(container);
+  if (!submission) {
+    container.append(node("p", "muted",
+      say("Submission receipt is missing its §2.5 facets.", "提交回执缺少 §2.5 分面字段。")));
+    return;
+  }
+  const phaseText = {
+    "active": say("Active — delivery context", "进行中 — 交付上下文"),
+    "draft-planning": say("Draft, in planning", "草稿，规划中"),
+    "draft-unplanned": say("Draft, not yet planned", "草稿，尚未规划")
+  };
+  const planningText = {
+    "entered": say("Entered planning", "已进入规划"),
+    "continued": say("Continued planning", "继续规划"),
+    "none": say("No planning change", "规划无变化")
+  };
+  const activationText = {
+    "requested": say("Activation requested", "已请求激活"),
+    "pending": say("Activation pending", "激活待处理"),
+    "failed": say("Activation failed", "激活失败"),
+    "manual-required": say("Manual activation required", "需手动激活"),
+    "execution-stopped": say("Execution stopped; not activated", "执行已停止；未激活"),
+    "none": say("No activation", "无激活")
+  };
+  const deliveryText = {
+    "queued": say("Leader queued to act now", "已为 Leader 排队处理"),
+    "none": say("Leader not woken", "未唤醒 Leader")
+  };
+  const facts = [
+    [say("Phase", "阶段"), phaseText[submission.phase] ?? submission.phase],
+    [say("Planning", "规划"), planningText[submission.planning] ?? submission.planning],
+    [say("Activation", "激活"), activationText[submission.activation] ?? submission.activation],
+    [say("Delivery", "投递"), deliveryText[submission.delivery] ?? submission.delivery]
+  ];
+  for (const [label, value] of facts) {
+    container.append(node("p", "muted", label + ": " + value));
+  }
+  const step = submission.nextStep;
+  if (step) {
+    const nextText = step.kind === "activate-manually"
+      ? say("Next: activate this Task explicitly (yui task activate " + step.taskId + ").",
+        "下一步：显式激活该 Task（yui task activate " + step.taskId + "）。")
+      : step.kind === "start-execution"
+      ? say("Next: start execution first, then activate (" + step.taskId + ").",
+        "下一步：先启动执行，再激活（" + step.taskId + "）。")
+      : step.kind === "await-pending-activation"
+      ? say("Next: waiting on the pending activation " + step.activationRef + ".",
+        "下一步：等待待处理的激活 " + step.activationRef + "。")
+      : step.kind === "resolve-failed-activation"
+      ? say("Next: the prior activation failed (" + step.failure + "); retry with a new request or cancel " + step.activationRef + ".",
+        "下一步：之前的激活失败（" + step.failure + "）；请用新请求重试或取消 " + step.activationRef + "。")
+      : "";
+    if (nextText) {
+      const next = node("p", "", nextText);
+      next.dataset.nextStep = step.kind;
+      container.append(next);
+    }
+  }
+}
 `;

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

@@ -3,6 +3,7 @@ import { createServer } from "node:http";
 import WebSocket, { WebSocketServer } from "ws";
 import { usageError } from "../errors/cliError.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";
 const MAX_JSON_BODY_BYTES = 16 * 1024;
@@ -98,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 {
@@ -129,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;
@@ -160,11 +193,17 @@ async function handleHttpRequest(request, response, store, dependencies, token,
             else if (method === "POST" && action === "messages") {
                 const body = await readMutationBody(request);
                 if (typeof body !== "object" || body === null || Array.isArray(body)
-                    || Object.keys(body).some((key) => !["body", "requestId"].includes(key))
+                    || Object.keys(body).some((key) => !["body", "requestId", "intent"].includes(key))
                     || !("requestId" in body) || typeof body.requestId !== "string" || !body.requestId.trim()
                     || !("body" in body) || typeof body.body !== "string")
-                    throw new WebRequestRejected("Expected body and requestId only.");
-                value = { ...dependencies.surface.message(taskId, body.body), requestId: body.requestId };
+                    throw new WebRequestRejected("Expected body, requestId and optional intent.");
+                const intent = webSubmissionIntent(body);
+                // 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);
@@ -426,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.");
@@ -450,6 +569,18 @@ async function readMutationBody(request) {
         throw new WebRequestRejected(error instanceof Error ? error.message : "Invalid request body.");
     }
 }
+/** Validate an optional submission intent from a Web message body. Absent leaves
+ *  it undefined so the shared service applies the discuss default (task-32 §2.5).
+ *  A present-but-invalid value is rejected rather than silently downgraded. */
+function webSubmissionIntent(body) {
+    if (!("intent" in body) || body.intent === undefined)
+        return undefined;
+    if (typeof body.intent === "string"
+        && TASK_SUBMISSION_INTENTS.includes(body.intent)) {
+        return body.intent;
+    }
+    throw new WebRequestRejected(`intent must be one of ${TASK_SUBMISSION_INTENTS.join(", ")}.`);
+}
 async function readJsonBody(request) {
     const chunks = [];
     let size = 0;

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);