xitto-kernel 0.9.2 → 0.9.4

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.9.4
+
+- **執行中可中途補充（steering）**：任務跑到一半,使用者可隨時插話調整方向/補需求,不必取消重來。
+  - 排隊注入,**不中斷正在跑的工具**——下一個邊界才生效:
+    - agent 串流中 → 即時排進 agent 的 steeringQueue(turn 邊界 drain)
+    - 回合之間(goal loop 的驗收空檔,agent 已收尾)→ 緩衝到 task,kernel 下一輪用 `drainSteer` 折進指令
+    - 兩路互斥,不重複套用
+  - 後端:`createTaskStore.steer(id,text)` + `POST /v1/tasks/:id/steer`;kernel `runGoal` 新增 `opts.drainSteer` 鉤子
+  - 許願台:進行中顯示補充輸入框(Enter 送出)+「✋ 已收到,會在下一步納入」回饋;輸入內容/游標在每 1.2s 輪詢重繪間保留,不洗掉打到一半的字
+  - 測試 +4(196/196):串流即時路徑、回合間緩衝/drain-once、非進行中擋下、drainSteer 折進指令
+
+## 0.9.3
+
+- **許願台佈局優化（視覺層次 + 互動細節）**：
+  - **頂部列**：專案控制（下拉 + 選資料夾 + 新專案）群組成一個卡片靠右、加底部分隔線、置中對齊;標題與控制不再擠成一團;窄螢幕隱藏副標
+  - **左欄**：歷史成品與檔案兩段做成卡片區塊;**當前任務在歷史列高亮**(知道你正在看哪個);時間改友善格式(月/日 時:分);列項改輕量(hover/active),不再雙層卡片
+  - **許願框**：focus 高亮邊框 + 「⌘/Ctrl+Enter 送出」提示與快捷鍵
+  - **主區**：歡迎/空狀態改虛線框、置中,更像「等你下訂單」
+  - 純前端(CSS/HTML/小 JS);測試 192/192 + JS 語法 + 結構驗證
+
 ## 0.9.2
 
 - **修：報告顯示完成但找不到真實檔案**（成品寫到工作區外）。從執行歷史查出:某任務 workspace=`/Users/…/Xiza`（本地就地）,但 agent 把報告 `write` 到 `/tmp/…`、`/app/…`（絕對路徑,工作區外）→ 成品掃描只看工作區 → `artifacts:{created:[]}`,但 summary 說完成 → 使用者看到「有報告」卻找不到檔。兩道修法:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xitto-kernel",
-  "version": "0.9.2",
+  "version": "0.9.4",
   "type": "module",
   "description": "領域無關的 agent 底座（kernel + 可插拔 DomainPack），從 xitto-code 抽象而來",
   "keywords": [

package/src/app/server.js

@@ -139,6 +139,7 @@ export function createTaskStore({ runJob, concurrency = 2, onFinish, maxEvents =
     else if (ev.type === 'text') { p.phase = 'thinking'; t._textbuf = ((t._textbuf || '') + (ev.delta || '')).slice(-400); p.thinking = t._textbuf.replace(/\s+/g, ' ').trim().slice(-150); }
     else if (ev.type === 'round') { p.round = ev.round; if (ev.maxRounds) p.maxRounds = ev.maxRounds; p.thinking = ''; t._textbuf = ''; }
     else if (ev.type === 'phase') p.phase = ev.phase;
+    else if (ev.type === 'steered') { (p.steers ||= []).push(ev.text); if (p.steers.length > 8) p.steers.shift(); } // 使用者中途補充（給 UI 回饋「已收到」）
     else if (ev.type === 'needs_input') p.phase = 'needs-input';
     else if (ev.type === 'answered') p.phase = 'acting';
     else if (ev.type === 'end') p.phase = ev.status;
@@ -160,7 +161,7 @@ export function createTaskStore({ runJob, concurrency = 2, onFinish, maxEvents =
       t.status = 'running'; t.startedAt = new Date().toISOString();
       emit(t, { type: 'status', status: 'running' });
       Promise.resolve()
-        .then(() => runJob(t.spec, (ev) => emit(t, ev), makeAsk(t), (agent) => { t._agent = agent; }))
+        .then(() => runJob(t.spec, (ev) => emit(t, ev), makeAsk(t), (agent) => { t._agent = agent; }, () => { const b = t.steerBuf || []; t.steerBuf = []; return b; }))
         .then((result) => { t.status = 'done'; t.result = result; })
         .catch((e) => { t.status = 'error'; t.error = e.message || String(e); })
         .finally(() => {
@@ -214,6 +215,19 @@ export function createTaskStore({ runJob, concurrency = 2, onFinish, maxEvents =
       resolve(String(text ?? ''));
       return true;
     },
+    // 中途補充（steering）：任務進行中,使用者插話。agent 正在串流 → 即時排進 steeringQueue（下個 turn 邊界生效,不中斷當前工具）；
+    // 回合之間（goal loop 的 checkGoal 空檔,agent 已收尾）→ 緩衝到 task,由 kernel 下一輪 drainSteer 折進指令。兩路互斥,不重複套用。
+    steer(id, text) {
+      const t = tasks.get(id);
+      if (!t || t.status !== 'running') return false;
+      const msg = String(text ?? '').trim();
+      if (!msg) return false;
+      const live = !!(t._agent && t._agent.state && t._agent.state.isStreaming);
+      if (live) { try { t._agent.steer({ role: 'user', content: [{ type: 'text', text: msg }] }); } catch { (t.steerBuf ||= []).push(msg); } }
+      else (t.steerBuf ||= []).push(msg);
+      emit(t, { type: 'steered', text: msg, queued: !live });
+      return true;
+    },
     stats: () => ({ active, queued: queue.length, total: tasks.size }),
   };
 }
@@ -257,7 +271,7 @@ export function createServerApp({ model, getApiKey, token, baseDir = '.xitto-ser
 
   // 共用：跑一輪/一目標，回傳 { sessionId, text, usage, rounds, done }；onEvent 收原始 kernel 事件；
   // ask（可選）= 澄清通道,讓 agent 在背景任務中暫停問使用者。
-  async function runKernel(spec, onEvent, ask, onAgent) {
+  async function runKernel(spec, onEvent, ask, onAgent, drainSteer) {
     const make = PACKS[spec.pack || 'general'];
     if (!make) throw new Error(`未知 pack「${spec.pack}」，可用：${Object.keys(PACKS).join(', ')}`);
     // 持久工作空間（B 模型）：workdir 綁 workspace（非 sessionId）→ 檔案留存 + 五層沉澱跨成品累積。
@@ -272,7 +286,7 @@ export function createServerApp({ model, getApiKey, token, baseDir = '.xitto-ser
     const wrapped = (ev) => { if (ev.type === 'message_end' && ev.message?.usage) { usage.input += ev.message.usage.input || 0; usage.output += ev.message.usage.output || 0; } onEvent?.(ev); };
     if (spec.mode === 'goal') {
       // 結果導向：回傳交付物（做了什麼 + 產出的檔案 + 是否達成），對話只是過程
-      const o = await kernel.runOutcome(spec.goal || spec.input || "", { maxRounds: 8, history: sess.history, onEvent: wrapped, onAgent, onRound: (i) => wrapped({ type: 'round', round: i.round, maxRounds: i.maxRounds }) });
+      const o = await kernel.runOutcome(spec.goal || spec.input || "", { maxRounds: 8, history: sess.history, onEvent: wrapped, onAgent, drainSteer, onRound: (i) => wrapped({ type: 'round', round: i.round, maxRounds: i.maxRounds }) });
       sess.history = o.history || []; sessions.set(sessionId, sess); persistSession(sessionId, sess);
       try { rmSync(join(workdir, 'tmp'), { recursive: true, force: true }); } catch { /* 清過程檔,失敗無妨 */ }
       // 溯源：邏輯位置 workspace 永遠記；實體路徑只在本地模式給（託管不洩漏伺服器路徑）
@@ -295,7 +309,7 @@ export function createServerApp({ model, getApiKey, token, baseDir = '.xitto-ser
   const tasks = createTaskStore({
     concurrency,
     persistDir: join(baseDir, 'tasks'),
-    runJob: (spec, emit, ask, onAgent) => runKernel(spec, (ev) => { const m = mapEvent(ev); if (m) emit(m); }, ask, onAgent),
+    runJob: (spec, emit, ask, onAgent, drainSteer) => runKernel(spec, (ev) => { const m = mapEvent(ev); if (m) emit(m); }, ask, onAgent, drainSteer),
     onFinish: (task) => { log({ task: task.id, pack: task.spec.pack, mode: task.spec.mode || 'turn', status: task.status, ms: task.startedAt ? Date.parse(task.finishedAt) - Date.parse(task.startedAt) : 0 }); fireWebhook(task); },
   });
 
@@ -359,6 +373,19 @@ export function createServerApp({ model, getApiKey, token, baseDir = '.xitto-ser
       return json(res, 200, { ok: true, taskId: mAns[1], status: 'running' });
     }
 
+    // 中途補充（steering）：任務進行中,使用者插話調整方向/補需求。排隊注入,不中斷當前工作,下個邊界生效。
+    const mSteer = path.match(/^\/v1\/tasks\/([^/]+)\/steer$/);
+    if (req.method === 'POST' && mSteer) {
+      const body = await readBody(req);
+      const t = tasks.get(mSteer[1]);
+      if (!t) return json(res, 404, { error: 'task not found' });
+      if (t.status !== 'running') return json(res, 409, { error: '只有進行中的任務可以補充', status: t.status });
+      const ok = tasks.steer(mSteer[1], body.text);
+      if (!ok) return json(res, 400, { error: '補充內容為空或無法送出' });
+      log({ task: mSteer[1], action: 'steer' });
+      return json(res, 200, { ok: true, taskId: mSteer[1] });
+    }
+
     // 中斷任務（取消鈕）：控制權在使用者手上,降低「啟動了控制不了的東西」的焦慮
     const mCancel = path.match(/^\/v1\/tasks\/([^/]+)\/cancel$/);
     if (req.method === 'POST' && mCancel) {
@@ -436,7 +463,7 @@ export function startServer() {
     console.log(`🪄 許願台：http://localhost:${port}/  （瀏覽器打開即用——說出目標、交付成品）`);
     console.log(`xitto-kernel server · model ${model.id} · 沙箱 ${sandbox ? '開' : '關'} · 背景並發 ${concurrency}${local ? ' · 本地模式(顯示檔案位置)' : ''}`);
     console.log(`token: ${token === 'dev-token' ? 'dev-token（請設 XITTO_SERVER_TOKEN）' : '(已設定)'}`);
-    console.log('API：POST /v1/run · /v1/stream · /v1/tasks · /v1/tasks/:id/{answer,cancel}｜GET /v1/tasks[/:id[/events|/file]] · /health');
+    console.log('API：POST /v1/run · /v1/stream · /v1/tasks · /v1/tasks/:id/{answer,steer,cancel}｜GET /v1/tasks[/:id[/events|/file]] · /health');
   });
   return server;
 }

package/src/app/web/index.html

@@ -12,19 +12,27 @@
   /* 單頁佈局：頂部許願 + 左欄(歷史+檔案) + 主區(當前任務/成品/預覽共用)。窄螢幕收單欄 */
   .layout { display:grid; grid-template-columns:300px minmax(0,1fr); gap:24px; align-items:start; margin-top:18px; }
   .nav { position:sticky; top:14px; max-height:calc(100vh - 28px); display:flex; flex-direction:column; gap:16px; }
-  .navsec { display:flex; flex-direction:column; min-height:0; }
-  .navsec h3 { margin:0 0 8px; }
+  .navsec { display:flex; flex-direction:column; min-height:0; background:var(--card); border:1px solid var(--line); border-radius:12px; padding:10px 12px; }
+  .navsec h3 { margin:0 0 8px; position:sticky; top:0; }
   .hist-sec #history, .file-sec #wbfiles { overflow:auto; }      /* 兩段各自內捲,都到得了底 */
-  .hist-sec { flex:0 1 auto; max-height:42vh; } .hist-sec #history { max-height:38vh; }
-  .file-sec { flex:1 1 auto; min-height:0; } .file-sec #wbfiles { flex:1; }
+  .hist-sec { flex:0 1 auto; max-height:44vh; } .hist-sec #history { max-height:40vh; }
+  .file-sec { flex:1 1 auto; min-height:120px; } .file-sec #wbfiles { flex:1; }
   .work { min-width:0; }
-  .welcome { padding:40px 16px; text-align:center; line-height:2; }
+  .welcome { padding:56px 24px; text-align:center; line-height:2; font-size:15px; border:1px dashed var(--line); border-radius:14px; }
   @media (max-width:860px){ .layout{ grid-template-columns:1fr; } .nav{ position:static; max-height:none; } .hist-sec,.hist-sec #history,.file-sec #wbfiles{ max-height:none; } }
-  header { display:flex; align-items:baseline; gap:10px; margin-bottom:6px; }
-  header h1 { font-size:22px; margin:0; }
+  header { display:flex; align-items:center; gap:12px; padding-bottom:14px; border-bottom:1px solid var(--line); }
+  header h1 { font-size:20px; margin:0; white-space:nowrap; }
   header .sub { color:var(--dim); font-size:13px; }
-  .ask { background:var(--card); border:1px solid var(--line); border-radius:14px; padding:14px; margin:18px 0; }
-  .ask textarea { width:100%; background:#0c0e12; color:var(--fg); border:1px solid var(--line); border-radius:10px; padding:12px; font:inherit; resize:vertical; min-height:64px; }
+  .topctl { display:flex; align-items:center; gap:8px; background:var(--card); border:1px solid var(--line); border-radius:10px; padding:5px 8px; }
+  .prjlabel { color:var(--dim); font-size:12px; }
+  .topctl select { padding:5px 8px; max-width:200px; }
+  .topctl button { padding:5px 10px; font-size:13px; font-weight:500; }
+  @media (max-width:640px){ header .sub { display:none; } }
+  .ask { background:var(--card); border:1px solid var(--line); border-radius:14px; padding:14px; margin:18px 0; transition:border-color .15s; }
+  .ask:focus-within { border-color:var(--accent); }
+  .ask textarea { width:100%; background:#0c0e12; color:var(--fg); border:1px solid var(--line); border-radius:10px; padding:12px; font:inherit; resize:vertical; min-height:70px; outline:none; }
+  .ask textarea:focus { border-color:var(--accent); }
+  .askhint { color:var(--dim); font-size:12px; }
   .row { display:flex; gap:10px; align-items:center; margin-top:10px; }
   select, button { font:inherit; }
   select { background:#0c0e12; color:var(--fg); border:1px solid var(--line); border-radius:8px; padding:8px; }
@@ -71,13 +79,19 @@
   .qbox { margin-top:12px; padding:12px; background:#1d1c12; border:1px solid var(--warn); border-radius:10px; }
   .qbox .q { color:var(--warn); margin-bottom:8px; }
   .qbox input { width:100%; background:#0c0e12; color:var(--fg); border:1px solid var(--line); border-radius:8px; padding:9px; font:inherit; }
+  .steerbox { margin-top:12px; padding-top:10px; border-top:1px dashed var(--line); }
+  .steernote { font-size:12.5px; color:var(--ok); margin-bottom:6px; }
+  #steerin { width:100%; background:#0c0e12; color:var(--fg); border:1px solid var(--line); border-radius:8px; padding:9px 11px; font:inherit; outline:none; }
+  #steerin:focus { border-color:var(--accent); }
   h3 { color:var(--dim); font-size:13px; font-weight:600; text-transform:uppercase; letter-spacing:.05em; margin:28px 0 8px; }
-  .hist { background:var(--card); border:1px solid var(--line); border-radius:10px; padding:11px 14px; margin:8px 0; cursor:pointer; }
-  .hist:hover { border-color:var(--accent); }
-  .hist .g { font-size:14px; } .hist .m { color:var(--dim); font-size:12px; }
+  .hist { border:1px solid transparent; border-radius:8px; padding:8px 10px; margin:3px 0; cursor:pointer; }
+  .hist:hover { background:#0c0e12; }
+  .hist.active { background:#0c0e12; border-color:var(--accent); }
+  .hist .g { font-size:13.5px; line-height:1.4; } .hist .m { color:var(--dim); font-size:11px; margin-top:2px; }
   .empty { color:var(--dim); font-size:13px; }
-  .wbrow { display:flex; align-items:center; gap:10px; padding:9px 12px; background:var(--card); border:1px solid var(--line); border-radius:8px; margin:6px 0; }
-  .wbname { flex:1; color:var(--accent); cursor:pointer; font-size:14px; }
+  .wbrow { display:flex; align-items:center; gap:10px; padding:7px 10px; border-radius:8px; margin:1px 0; }
+  .wbrow:hover { background:#0c0e12; }
+  .wbname { flex:1; color:var(--accent); cursor:pointer; font-size:13.5px; }
   .wbmeta { color:var(--dim); font-size:12px; }
   .wbdel { cursor:pointer; opacity:.6; } .wbdel:hover { opacity:1; }
   .followup { margin-top:14px; padding-top:12px; border-top:1px solid var(--line); }
@@ -106,11 +120,14 @@
 <div class="wrap">
   <header>
     <h1>🪄 xitto 許願台</h1>
-    <span class="sub">說出你想完成的事，交給它去做、做完給你成品</span>
+    <span class="sub">說出你想完成的事，做完給你成品</span>
     <span class="spacer"></span>
-    <select id="space" title="專案／空間：不同專案的檔案與記憶各自獨立"></select>
-    <button class="ghost" id="browsebtn" title="瀏覽並選一個真實資料夾（本地模式）" style="display:none">📁 選資料夾</button>
-    <button class="ghost" id="newspace" title="新專案">＋</button>
+    <div class="topctl">
+      <span class="prjlabel">專案</span>
+      <select id="space" title="專案／空間：不同專案的檔案與記憶各自獨立"></select>
+      <button class="ghost" id="browsebtn" title="瀏覽並選一個真實資料夾（本地模式）" style="display:none">📁 選</button>
+      <button class="ghost" id="newspace" title="新增一個專案／空間">＋ 新專案</button>
+    </div>
   </header>
 
   <div id="fsmodal" class="modal" style="display:none">
@@ -132,6 +149,7 @@
     <div class="row">
       <select id="pack" title="領域"></select>
       <span class="spacer"></span>
+      <span class="askhint">⌘ / Ctrl + Enter 送出</span>
       <button id="go">交辦 →</button>
     </div>
   </div>
@@ -297,8 +315,9 @@ $("#go").onclick = async () => {
   $("#goal").value = "";
   $("#fview").style.display="none"; expandedLog=false;
   activeId = r.taskId;
-  poll();
+  poll(); loadHistory();
 };
+$("#goal").addEventListener("keydown", e=>{ if((e.metaKey||e.ctrlKey) && e.key==="Enter"){ e.preventDefault(); $("#go").click(); } });
 
 function statusClass(s){ return s==="running"?"running":s==="needs-input"?"needs":s==="done"?"done":(s==="error"||s==="cancelled"||s==="interrupted")?"error":""; }
 function statusText(s){ return ({queued:"排隊中",running:"進行中…","needs-input":"需要你回答",done:"已完成",error:"失敗",cancelled:"已中斷",interrupted:"已中斷(重啟)"})[s]||s; }
@@ -317,6 +336,8 @@ async function poll() {
 }
 
 function renderCurrent(t) {
+  // 保住 steer 輸入框的內容與游標：輪詢每 1.2s 重繪整張卡,別把使用者正打到一半的補充洗掉
+  const ps=(()=>{const el=document.getElementById("steerin");return el?{v:el.value,f:document.activeElement===el,s:el.selectionStart}:null;})();
   const a = t.result?.artifacts, files = a ? [...(a.created||[]).map(f=>[f,"new"]), ...(a.modified||[]).map(f=>[f,"mod"])] : [];
   const p = t.progress||{}, nLog=(p.log||[]).length;
   const logSec = nLog ? `<div class="logtoggle" onclick="toggleLog()">${expandedLog?"▾ 收合過程":"▸ 展開過程（"+nLog+" 步）"}</div>${expandedLog?`<div class="loglist">${logHtml(p)}</div>`:""}` : "";
@@ -329,6 +350,10 @@ function renderCurrent(t) {
     ${logSec}
     ${t.status==="needs-input"?`<div class="qbox"><div class="q">❓ ${esc(t.pending?.question)}</div>
       <input id="ans" placeholder="輸入你的回答，按 Enter 送出"></div>`:""}
+    ${t.status==="running"?`<div class="steerbox">
+      ${(p.steers||[]).slice(-3).map(s=>`<div class="steernote">✋ 已收到補充，會在下一步納入：${esc(s)}</div>`).join("")}
+      <input id="steerin" placeholder="想補充或調整方向？打字按 Enter——會在下一步納入，不中斷目前工作">
+    </div>`:""}
     ${t.status==="done"?`<div class="summary">${esc(t.result?.text||"")}</div>`:""}
     ${t.status==="error"?`<div class="summary">⚠ ${esc(t.error)}</div>`:""}
     ${files.length?`<div class="files">📦 成品：${files.map(([f,k])=>`<span class="file ${k==="mod"?"mod":""}" onclick="viewFile('${t.taskId}','${encodeURIComponent(f)}','${esc(f)}')">${k==="mod"?"~":"+"} ${esc(f)}</span>`).join("")}</div>`:""}
@@ -349,6 +374,17 @@ function renderCurrent(t) {
       poll();
     }};
   }
+  if (t.status==="running") {
+    const si = $("#steerin");
+    if (si) {
+      if (ps) { si.value = ps.v; if (ps.f) { si.focus(); try { si.setSelectionRange(ps.s, ps.s); } catch {} } }  // 還原打到一半的內容/游標
+      si.onkeydown = async (e) => { if (e.key==="Enter" && si.value.trim()) {
+        const txt = si.value.trim(); si.value = ""; si.disabled = true;
+        await api("/v1/tasks/"+t.taskId+"/steer", { method:"POST", body: JSON.stringify({ text: txt }) });
+        si.disabled = false; si.focus();
+      }};
+    }
+  }
 }
 
 // 繼續／調整：送出接續上一個任務對話(sessionId)+ 同工作區的後續任務
@@ -363,11 +399,12 @@ async function submitFollowup(sessionId, pack, workspace){
 async function loadHistory() {
   const r = await api("/v1/tasks").then(r=>r.json());
   const list = (r.tasks||[]).filter(t=>t.mode==="goal" && (t.workspace||"default")===curSpace).reverse();
-  $("#history").innerHTML = list.length ? list.map(t=>`<div class="hist" onclick="openTask('${t.taskId}')">
+  $("#history").innerHTML = list.length ? list.map(t=>`<div class="hist${t.taskId===activeId?' active':''}" onclick="openTask('${t.taskId}')">
     <div class="g">${t.continued?'<span class="cont" title="接續前一個任務">↳</span> ':''}${esc(t.goal||t.taskId)} <span class="status ${statusClass(t.status)}">${statusText(t.status)}</span></div>
-    <div class="m">${esc(t.createdAt)}</div></div>`).join("") : `<div class="empty">還沒有任何任務。</div>`;
+    <div class="m">${esc(fmtTime(t.createdAt))}</div></div>`).join("") : `<div class="empty">還沒有任何任務。</div>`;
 }
-async function openTask(id){ activeId=id; const t=await api("/v1/tasks/"+id).then(r=>r.json()); liveTask=t; renderCurrent(t); if(t.status==="running"||t.status==="queued"){poll();} window.scrollTo({top:0,behavior:"smooth"}); }
+function fmtTime(s){ try{ const d=new Date(s); return d.toLocaleString(undefined,{month:"numeric",day:"numeric",hour:"2-digit",minute:"2-digit"}); }catch{ return s; } }
+async function openTask(id){ activeId=id; const t=await api("/v1/tasks/"+id).then(r=>r.json()); liveTask=t; $("#fview").style.display="none"; renderCurrent(t); loadHistory(); if(t.status==="running"||t.status==="queued"){poll();} window.scrollTo({top:0,behavior:"smooth"}); }
 
 loadHistory(); loadFiles();
 </script>

package/src/kernel/index.js

@@ -442,6 +442,11 @@ export function createKernel(pack, config = {}) {
       let sameFeedback = 0;
       for (let round = 1; round <= maxRounds; round++) {
         opts.onRound?.({ round, maxRounds });
+        // 使用者中途補充（steering）：把上一輪之間累積的補充折進這一輪指令（回合內的即時補充走 agent.steer）。
+        if (opts.drainSteer) {
+          const extra = opts.drainSteer();
+          if (extra && extra.length) instruction += '\n\n[使用者中途補充，請納入考量並據此調整]\n' + extra.map((s) => `- ${s}`).join('\n');
+        }
         const r = await api.runTurn(instruction, { history, onEvent: opts.onEvent, onAgent: opts.onAgent });
         history = r.messages;
         if (r.aborted) return { done: false, aborted: true, rounds: round, history };