@songsid/agend 2.1.7 → 2.1.8-beta.10

package/dist/ui/settings.html

@@ -37,8 +37,20 @@
   .tag { font-size: 12px; color: var(--muted); background: #eef2ff; color: #3730a3; padding: 1px 7px; border-radius: 10px; }
   .tag.persona { background: #fdf2f8; color: #9d174d; }
   .tag.tg { background: #e0f2fe; color: #075985; }
+  .tag.se-default { background: transparent; color: var(--muted); border: 1px dashed var(--border); }
   .sub { font-size: 13px; color: var(--muted); margin-top: 3px; margin-left: 19px; }
   .spacer { flex: 1; }
+  /* "Connections & Bots" rows carry up to ten short facts. Left to shrink, every one of them wraps inside
+     its own box (a chip becomes two lines, "存取模式:" and "設定" break mid-word) and the tail is clipped by
+     the card. So: no fact wraps inside itself; when the row is too long it wraps between facts, and the
+     status/settings cluster stays together at the end. Long values (env names, user ids) may break
+     anywhere rather than push the row wider than its card. */
+  .conn-row { flex-wrap: wrap; row-gap: 6px; }
+  .conn-row > * { flex: 0 0 auto; max-width: 100%; }
+  .conn-row .name, .conn-row .tag, .conn-row button, .conn-row .row-end > * { white-space: nowrap; }
+  .conn-row .tag { overflow: hidden; text-overflow: ellipsis; }
+  .conn-row .sub { flex: 0 1 auto; min-width: 0; overflow-wrap: anywhere; }
+  .conn-row .row-end { display: inline-flex; align-items: center; gap: 10px; margin-left: auto; }
   button { font-family: inherit; font-size: 13px; border-radius: var(--radius-sm); padding: 6px 12px; border: 1px solid var(--border); background: #fff; color: var(--fg); cursor: pointer; }
   button:hover { background: #f3f4f6; }
   button.primary { background: var(--accent); color: #fff; border-color: var(--accent); font-weight: 600; }
@@ -252,8 +264,8 @@
       runtimeResources: "Runtime & Resources", autoPause: "Auto-pause after", minutes: "minutes", inheritDefault: "Inherit from defaults",
       statusEmojis: "Status emojis", statusEmojisInstance: "This agent's status emojis (override the connection's)", statusEmojisChannel: "Status emojis for this connection's bots",
       se_received: "Received", se_queued: "Queued", se_processing: "Processing", se_delivered: "Delivered", se_failed: "Failed", se_progress_prefix: "Progress prefix",
-      se_src_instance: "agent", se_src_platform: "connection", se_pick: "Pick…", se_useDefault: "Use the default", se_fallback: "the default is used instead",
-      se_unicode: "Emoji", se_telegramOnly: "Telegram allows only these reactions", se_serverEmojis: "This server's emojis", se_noServerEmojis: "This server has no custom emojis.", se_unavailable: "unavailable",
+      se_src_instance: "agent", se_src_platform: "connection", se_src_builtin: "default", se_pick: "Pick…", se_useDefault: "Use the default", se_fallback: "the default is used instead",
+      se_unicode: "Emoji", se_telegramOnly: "Telegram allows only these reactions", se_serverEmojis: "Server emojis", se_noServerEmojis: "No custom emojis on this server.", se_primaryServer: "primary", se_externalEmojiHint: "Another server's emoji needs the bot's Use External Emojis permission in the channel it reacts in.", se_unavailable: "unavailable",
       se_hint: "Empty keeps the default. The preview is resolved by AgEnD exactly as the bot will react.",
       detection: "Detection", startup: "Startup", backendSection: "Backend", advancedSection: "Advanced & Access", hangEnabled: "Hang detector enabled", hangTimeout: "Stuck timeout", agentMode: "Agent mode", toolSet: "Tool set", toolProgress: "Tool progress", replyCompletionGuard: "Require a delivered reply", replyGuardSupported: "Active for Claude Code in MCP mode.", replyGuardUnsupported: "Stored but inactive: {0} in {1} mode does not support reply-drop recovery.", logLevel: "Log level", concurrency: "Startup concurrency", staggerDelay: "Stagger delay", lightweight: "Lightweight mode", modelFailover: "Fallback model", displayName: "Display name", pause: "Pause", wake: "Wake", accessMode: "Access mode", affected: "Affected instances",
       language: "Language (bot replies)", defaultBackend: "Default backend", defaultModel: "Default model", allowedUsers: "Allowed users (primary bot)",
@@ -289,7 +301,10 @@
       applyRestartHint: "This change needs AgEnD itself restarted. You can restart it here, or run /restart in your chat channel.",
       applyBusy: "AgEnD is already reloading its configuration. Your changes are saved — try Apply again in a moment.",
       restartFleetButton: "Restart AgEnD", restartFleetConfirm: "Restart AgEnD now?\n\nEvery agent stops and starts again, work in progress is interrupted, and the panel is unreachable for up to a minute. A notice is posted to your chat channel.",
-      restartFleetStarted: "Restarting AgEnD — this page keeps checking.", restartFleetRefused: "Restart refused: {0}",
+      restartFleetStarted: "Restarting AgEnD — this page keeps checking.",
+      restartFleetBusy: "Restarting…", restartFleetTitle: "Restarting AgEnD…",
+      restartFleetWaiting: "AgEnD is restarting. This page keeps checking and will say when it is back — there is nothing to press.",
+      working: "Working…", restartFleetRefused: "Restart refused: {0}",
       restartFleetRateLimited: "Restart refused: {0} (try again in about {1} minutes)",
       signatureMismatch: "fleet.yaml and the running configuration disagree on: {0}. Restarting will not clear this — check fleet.log first.",
       applyStillWorking: "Still restarting ({0}s) — AgEnD is still working; this page keeps checking.",
@@ -301,8 +316,8 @@
     "zh-TW": {
       statusEmojis: "狀態 emoji", statusEmojisInstance: "此 Agent 的狀態 emoji（覆蓋連線設定）", statusEmojisChannel: "此連線 bot 的狀態 emoji",
       se_received: "已收到", se_queued: "排隊中", se_processing: "處理中", se_delivered: "已送達", se_failed: "失敗", se_progress_prefix: "進度前綴",
-      se_src_instance: "Agent", se_src_platform: "連線", se_pick: "選擇…", se_useDefault: "使用預設", se_fallback: "改用預設值",
-      se_unicode: "Emoji", se_telegramOnly: "Telegram 只允許這些反應", se_serverEmojis: "此伺服器的 emoji", se_noServerEmojis: "此伺服器沒有自訂 emoji。", se_unavailable: "無法使用",
+      se_src_instance: "Agent", se_src_platform: "連線", se_src_builtin: "預設", se_pick: "選擇…", se_useDefault: "使用預設", se_fallback: "改用預設值",
+      se_unicode: "Emoji", se_telegramOnly: "Telegram 只允許這些反應", se_serverEmojis: "伺服器 emoji", se_noServerEmojis: "此伺服器沒有自訂 emoji。", se_primaryServer: "主伺服器", se_externalEmojiHint: "使用其他伺服器的 emoji，bot 在要加反應的頻道需有「使用外部表情符號」權限。", se_unavailable: "無法使用",
       se_hint: "留空即使用預設值。預覽由 AgEnD 依 bot 實際 react 的方式解析。",
       title: "⚙️ AgEnD 設定", reloadFleet: "↻ 重新載入", myAgents: "🤖 我的 Agent", bots: "🔌 機器人", classicChannels: "🎮 ClassicBot 頻道", noClassic: "沒有 ClassicBot 頻道 — 在聊天中用 /start 建立。",
       general: "⚙️ 一般設定", whatsNew: "🆕 更新重點", advanced: "📋 進階",
@@ -345,7 +360,10 @@
       applyRestartHint: "此變更需要重新啟動 AgEnD 本身。可以在這裡重新啟動，或在聊天頻道執行 /restart。",
       applyBusy: "AgEnD 正在重新載入設定。你的變更已儲存，請稍候再按一次套用。",
       restartFleetButton: "重新啟動 AgEnD", restartFleetConfirm: "現在重新啟動 AgEnD？\n\n所有 agent 都會停止再啟動，進行中的工作會被中斷，面板會有最多約一分鐘無法連線。聊天頻道會收到一則通知。",
-      restartFleetStarted: "AgEnD 重新啟動中 —— 此頁面會持續確認。", restartFleetRefused: "重新啟動被拒絕：{0}",
+      restartFleetStarted: "AgEnD 重新啟動中 —— 此頁面會持續確認。",
+      restartFleetBusy: "重啟中…", restartFleetTitle: "AgEnD 重新啟動中…",
+      restartFleetWaiting: "AgEnD 正在重新啟動。此頁面會持續確認，恢復後會告訴你 —— 不需要再按任何按鈕。",
+      working: "執行中…", restartFleetRefused: "重新啟動被拒絕：{0}",
       restartFleetRateLimited: "重新啟動被拒絕：{0}（約 {1} 分鐘後可再試）",
       signatureMismatch: "fleet.yaml 與執行中的設定在這些項目上不一致：{0}。重新啟動無法解決，請先查看 fleet.log。",
       applyStillWorking: "仍在重啟中（{0} 秒）—— AgEnD 還在處理，此頁面會持續確認。",
@@ -525,7 +543,9 @@
       for (const entry of r.body.entries) {
         preview.append(el("span", { class: "se-item", title: `${entry.key}: ${entry.value}` }, emojiGlyph(entry),
           el("span", {}, t(`se_${entry.key}`)),
-          entry.source === "builtin" ? null : el("span", { class: "tag" }, t(`se_src_${entry.source}`))));
+          // Say where every value comes from, defaults included: 👀 is the built-in for three statuses, and
+          // an untagged 👀 left under "Processing" after Received is changed reads as if it had moved there.
+          el("span", { class: "tag" + (entry.source === "builtin" ? " se-default" : "") }, t(`se_src_${entry.source}`))));
       }
       problems.className = r.body.problems.length ? "feedback error" : "feedback";
       problems.textContent = r.body.problems.map(p => `⚠ ${t(`se_${p.key}`)}: ${p.problem} — ${t("se_fallback")}`).join("  ");
@@ -549,15 +569,27 @@
           const list = await fetchGuildEmojis(channelId, refreshList);
           guildBox.innerHTML = "";
           if (list.error) { guildBox.append(el("div", { class: "feedback error" }, `✗ ${list.error}`)); return; }
-          if (!list.emojis.length) { guildBox.append(el("div", { class: "hint" }, t("se_noServerEmojis"))); return; }
-          // An unavailable emoji (e.g. the server lost the Boost tier it
-          // needs) cannot be reacted with; picking it would preview fine and
-          // then fail silently on every status. Shown, but not pickable.
-          guildBox.append(grid(list.emojis.map(e => el("button", {
-            type: "button", class: "sm" + (e.available ? "" : " off"), title: `:${e.name}:${e.available ? "" : ` (${t("se_unavailable")})`}`,
-            ...(e.available ? {} : { disabled: "disabled", "aria-disabled": "true" }),
-            onclick: () => { if (e.available) choose(e.value); },
-          }, emojiImg(e.image_url, `:${e.name}:`)))));
+          // One group per server the bot can draw on (#1021), primary first;
+          // a bot reacts with a custom emoji from any server it is in.
+          const groups = list.guilds;
+          // Discord checks Use External Emojis in the channel being reacted in.
+          if (groups.length > 1) guildBox.append(el("div", { class: "hint" }, t("se_externalEmojiHint")));
+          for (const g of groups) {
+            if (groups.length > 1) {
+              guildBox.append(el("div", { class: "hint se-guild" }, g.name || g.id,
+                ...(g.primary ? [" ", el("span", { class: "tag" }, t("se_primaryServer"))] : [])));
+            }
+            if (g.error) { guildBox.append(el("div", { class: "feedback error" }, `✗ ${g.error}`)); continue; }
+            if (!g.emojis.length) { guildBox.append(el("div", { class: "hint" }, t("se_noServerEmojis"))); continue; }
+            // An unavailable emoji (e.g. the server lost the Boost tier it
+            // needs) cannot be reacted with; picking it would preview fine and
+            // then fail silently on every status. Shown, but not pickable.
+            guildBox.append(grid(g.emojis.map(e => el("button", {
+              type: "button", class: "sm" + (e.available ? "" : " off"), title: `:${e.name}:${e.available ? "" : ` (${t("se_unavailable")})`}`,
+              ...(e.available ? {} : { disabled: "disabled", "aria-disabled": "true" }),
+              onclick: () => { if (e.available) choose(e.value); },
+            }, emojiImg(e.image_url, `:${e.name}:`)))));
+          }
         };
         picker.append(el("div", { class: "hint", style: "display:flex;gap:8px;align-items:center" }, t("se_serverEmojis"),
           el("button", { type: "button", class: "sm ghost", onclick: () => load(true) }, "↻")), guildBox);
@@ -881,7 +913,8 @@
       : row.status === "running" ? "…" : "·";
     // restart-required is terminal and is NOT success: the value is saved and a
     // running AgEnD cannot adopt it.
-    const note = row.status === "restart-required" ? t("applyRestartNeeded")
+    const note = row.target === "fleet" && row.status === "running" ? t("restartFleetTitle")
+      : row.status === "restart-required" ? t("applyRestartNeeded")
       : row.settled_by === "no-change" ? t("applyNoChange")
       : row.settled_by === "fleet-restart" ? "(restart)"
       : row.kind === "hot" ? t("impactNow") : t("impactAgent");
@@ -892,17 +925,31 @@
       row.error ? el("span", { class: "err" }, row.error) : null);
   }
 
-  async function restartFleet(job) {
+  // One restart at a time, and a button that says so. Without this the panel re-drew a fresh, enabled
+  // "Restart AgEnD" button the instant the request was accepted, so a second press asked again.
+  let restartingFleet = false;
+  async function restartFleet(job, button) {
+    if (restartingFleet) return;
     // Its own confirmation, its own key. A single Apply must never be able to
     // carry a full-fleet restart along with it.
     if (!confirm(t("restartFleetConfirm"))) return;
+    restartingFleet = true;
+    const label = button?.textContent;
+    if (button) { button.disabled = true; button.textContent = t("restartFleetBusy"); }
     const key = (crypto.randomUUID ? crypto.randomUUID() : `r-${Date.now()}-${Math.random().toString(36).slice(2)}`);
-    const res = await api("/api/settings/restart-fleet", {
-      method: "POST",
-      headers: { "Idempotency-Key": key },
-      body: JSON.stringify({ job_id: job.id, confirm: "restart-agend", idempotency_key: key }),
-    });
+    let res;
+    try {
+      res = await api("/api/settings/restart-fleet", {
+        method: "POST",
+        headers: { "Idempotency-Key": key },
+        body: JSON.stringify({ job_id: job.id, confirm: "restart-agend", idempotency_key: key }),
+      });
+    } catch {
+      res = { ok: false, status: 0, body: null };
+    }
     if (!res.ok) {
+      restartingFleet = false;
+      if (button?.isConnected) { button.disabled = false; button.textContent = label; }
       const secs = res.body?.retry_after_seconds;
       showBanner(secs
         ? tf("restartFleetRateLimited", res.body?.error || "", Math.ceil(secs / 60))
@@ -910,17 +957,32 @@
       return;
     }
     showBanner(t("restartFleetStarted"));
-    await watchApplyJob(job);
+    // The server has moved this job's fleet row to "running" (and will settle it after the restart). Watch
+    // *that* job: the one in hand still says "restart-required" and is finished, so watching it ended at once.
+    const fresh = await api(`/api/settings/apply/${encodeURIComponent(job.id)}`).catch(() => null);
+    const watching = fresh?.ok && fresh.body?.id ? fresh.body : {
+      ...job, status: "running",
+      targets: job.targets.map(row => row.target === "fleet" ? { ...row, status: "running" } : row),
+    };
+    try {
+      await watchApplyJob(watching);
+      await reload();
+    } finally {
+      restartingFleet = false;
+    }
   }
 
   function renderApplyJob(job) {
     $("applyPanel").classList.add("open");
-    $("applyTitle").textContent = job.status === "done"
+    const fleetRestarting = job.status === "running" && job.targets.some(row => row.target === "fleet" && row.status === "running");
+    $("applyTitle").textContent = fleetRestarting ? t("restartFleetTitle")
+      : job.status === "done"
       ? (job.targets.some(r => r.status === "failed") ? t("applyPartial") : t("applyDone"))
       : job.status === "failed" ? t("applyPartial") : t("applying");
     const needsRestart = job.targets.some(row => row.status === "restart-required");
     const mismatch = state.schema.fleet_signature_mismatch;
-    $("applyNote").textContent = job.overdue
+    $("applyNote").textContent = fleetRestarting ? t("restartFleetWaiting")
+      : job.overdue
       ? tf("applyStillWorking", Math.round(job.elapsed_ms / 1000))
       : mismatch && needsRestart ? tf("signatureMismatch", mismatch.join(", "))
       : needsRestart ? t("applyRestartHint") : "";
@@ -928,8 +990,11 @@
     for (const row of job.targets) rows.append(applyRow(row));
     // A restart that cannot clear the mismatch is worse than no button at all.
     if (needsRestart && !mismatch) {
-      rows.append(el("div", { class: "apply-row" },
-        el("button", { class: "primary", onclick: () => restartFleet(job) }, t("restartFleetButton"))));
+      const restartButton = el("button", { class: "primary", onclick: ev => restartFleet(job, ev.currentTarget) },
+        restartingFleet ? t("restartFleetBusy") : t("restartFleetButton"));
+      // While a restart is under way this stays, disabled and saying so, if anything re-draws the panel.
+      if (restartingFleet) restartButton.disabled = true;
+      rows.append(el("div", { class: "apply-row" }, restartButton));
     }
     if (job.error) rows.append(el("div", { class: "apply-row err" }, job.error));
   }
@@ -944,7 +1009,10 @@
     let current = job;
     while (current.status === "running" && Date.now() < deadline) {
       await new Promise(r => setTimeout(r, 1000));
-      const res = await api(`/api/settings/apply/${encodeURIComponent(job.id)}`);
+      // A restart takes the server down under this request: the fetch rejects until AgEnD is back. That is
+      // the expected middle of a restart, not the end of the watch.
+      let res;
+      try { res = await api(`/api/settings/apply/${encodeURIComponent(job.id)}`); } catch { continue; }
       if (res.status === 404) {
         // The job outlives the process that made it, so a 404 means it aged out
         // of the store — not that it never happened.
@@ -1045,9 +1113,9 @@
         const form = agentEditForm(name, inst);
         openModal({ title: shortName(name, inst), subtitle: "ID: " + name, body: form.box, impacts: form.impacts, stage: form.stage });
       } }, t("settingsButton")),
-      running ? el("button", { class: "sm", onclick: () => pauseWakeAgent(name, "pause") }, t("pause")) : null,
-      paused ? el("button", { class: "sm", onclick: () => pauseWakeAgent(name, "wake") }, t("wake")) : null,
-      !paused ? el("button", { class: "sm", onclick: () => toggleAgent(name, running) }, running ? t("stop") : t("start")) : null,
+      running ? el("button", { class: "sm", onclick: ev => pauseWakeAgent(name, "pause", ev.currentTarget) }, t("pause")) : null,
+      paused ? el("button", { class: "sm", onclick: ev => pauseWakeAgent(name, "wake", ev.currentTarget) }, t("wake")) : null,
+      !paused ? el("button", { class: "sm", onclick: ev => toggleAgent(name, running, ev.currentTarget) }, running ? t("stop") : t("start")) : null,
       el("details", { class: "more-menu" },
         el("summary", { title: "More actions" }, "⋯"),
         el("div", { class: "menu" }, el("button", { class: "sm danger", onclick: () => delAgent(name) }, "Delete Agent"))),
@@ -1242,15 +1310,40 @@
     "instance.lightweight", "instance.model_failover", "instance.systemPrompt",
     "instance.tags", "instance.general_topic", "instance.status_emojis",
   ];
-  async function toggleAgent(name, running) {
-    if (running) await api(`/stop/${encodeURIComponent(name)}`, { method: "POST" });
-    else await api(`/api/instance/${encodeURIComponent(name)}/start`, { method: "POST" });
-    setTimeout(reloadLive, 800);
-  }
-  async function pauseWakeAgent(name, action) {
-    const res = await api(`/api/settings/instances/${encodeURIComponent(name)}/${action}`, { method: "POST" });
-    if (!res.ok) alert(res.body?.error || tf("actionFailed", action));
-    await reloadLive();
+  // Start, stop, pause and wake take a moment and used to give no sign of it, so they were pressed again.
+  // One action per agent at a time; the row's buttons are disabled and the pressed one says it is working.
+  const busyAgents = new Set();
+  async function runAgentAction(name, button, work) {
+    if (busyAgents.has(name)) return;
+    busyAgents.add(name);
+    const row = button?.closest(".item");
+    const buttons = row ? [...row.querySelectorAll("button")] : (button ? [button] : []);
+    const label = button?.textContent;
+    for (const b of buttons) b.disabled = true;
+    if (button) button.textContent = t("working");
+    try { await work(); }
+    finally {
+      busyAgents.delete(name);
+      // The list is normally redrawn by then; if it was not (a failed reload), give the buttons back.
+      for (const b of buttons) if (b.isConnected) b.disabled = false;
+      if (button?.isConnected) button.textContent = label;
+    }
+  }
+  function toggleAgent(name, running, button) {
+    return runAgentAction(name, button, async () => {
+      const res = running ? await api(`/stop/${encodeURIComponent(name)}`, { method: "POST" })
+        : await api(`/api/instance/${encodeURIComponent(name)}/start`, { method: "POST" });
+      if (!res.ok) showBanner(`${tf("actionFailed", running ? t("stop") : t("start"))}: ${res.body?.error || res.status}`, true);
+      await new Promise(r => setTimeout(r, 800));
+      await reloadLive();
+    });
+  }
+  function pauseWakeAgent(name, action, button) {
+    return runAgentAction(name, button, async () => {
+      const res = await api(`/api/settings/instances/${encodeURIComponent(name)}/${action}`, { method: "POST" });
+      if (!res.ok) alert(res.body?.error || tf("actionFailed", action));
+      await reloadLive();
+    });
   }
   async function delAgent(name) {
     if (!confirm(tf("deleteAgent", name))) return;
@@ -1295,7 +1388,7 @@
     chs.forEach((ch, i) => {
       const item = el("div", { class: "item" });
       const type = ch.type || "?";
-      item.append(el("div", { class: "item-row" },
+      item.append(el("div", { class: "item-row conn-row" },
         el("span", { class: "name" }, type === "telegram" ? "Telegram" : "Discord"),
         el("span", { class: "tag" + (i === 0 ? "" : " persona") + (type === "telegram" ? " tg" : "") }, ch.id || chLabel(i)),
         el("span", { class: "sub", style: "margin:0" }, ch.bot_token_env || "(no token env)"),
@@ -1305,13 +1398,14 @@
           (ch.access?.allowed_users || []).length
             ? (ch.access.allowed_users).slice(0, 3).join(", ") + ((ch.access.allowed_users).length > 3 ? ` +${(ch.access.allowed_users).length - 3}` : "")
             : t("noAllowedUsers")),
-        el("span", { class: "spacer" }),
-        el("span", { class: "tag", title: "secret status" }, state.connections.find(c => (c.id || c.type) === (ch.id || ch.type))?.token_present ? "Token configured" : "Token missing"),
-        el("span", { style: `color:${state.fleetUp ? "var(--green)" : "var(--red)"};font-size:13px` }, state.fleetUp ? "Connected" : "Problem"),
-        el("button", { class: "sm ghost", onclick: () => {
-          const form = botEditForm(ch, i);
-          openModal({ title: type === "telegram" ? "Telegram" : "Discord", subtitle: ch.id || chLabel(i), body: form.box, impacts: form.impacts, stage: form.stage });
-        } }, t("settingsButton")),
+        el("span", { class: "row-end" },
+          el("span", { class: "tag", title: "secret status" }, state.connections.find(c => (c.id || c.type) === (ch.id || ch.type))?.token_present ? "Token configured" : "Token missing"),
+          el("span", { style: `color:${state.fleetUp ? "var(--green)" : "var(--red)"};font-size:13px` }, state.fleetUp ? "Connected" : "Problem"),
+          el("button", { class: "sm ghost", onclick: () => {
+            const form = botEditForm(ch, i);
+            openModal({ title: type === "telegram" ? "Telegram" : "Discord", subtitle: ch.id || chLabel(i), body: form.box, impacts: form.impacts, stage: form.stage });
+          } }, t("settingsButton")),
+        ),
       ));
       host.append(item);
     });

package/dist/wake-coordinator.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Phase 2b (docs/design/phase2-submit-contract.md §1.2–§1.6, §3.1): the one
+ * owner that wakes a paused target because durable work is waiting for it.
+ *
+ * Before this, the only code that woke a target for a queued cross-instance
+ * message ran *after* the outbox pump had claimed the row, and the pump never
+ * claims a target without a live daemon — so a marker-only paused instance
+ * (paused across a fleet restart) was never woken: Bug1, the attempt_0
+ * deadlock. The coordinator wakes first; the pump stays the only claimer and
+ * only claims targets that are awake. Nothing here writes a pane or claims a
+ * row.
+ *
+ * Active only for targets whose `delivery_worker` is `wake_only` or `on`;
+ * `off` (the default) leaves every path as it was.
+ */
+import type { DeliveryWorkerMode } from "./types.js";
+import type { OutboxDelivery } from "./delivery-outbox.js";
+import type { PauseReason } from "./pause-marker.js";
+/** Row kinds that never warrant waking a target. Empty: every current kind asks for action (§1.2). */
+export declare const PASSIVE_KINDS: ReadonlySet<string>;
+export declare const isWakeEligibleKind: (kind: string) => boolean;
+export declare const WAKE_BACKOFF_BASE_MS = 1000;
+export declare const WAKE_BACKOFF_MAX_MS = 60000;
+/** Consecutive wake failures before both topics are told, once per failure episode. */
+export declare const WAKE_FAILURE_NOTICE_AFTER = 3;
+/** Pre-claim lease length (mirrors instance-lifecycle PRECLAIM_LEASE_MS). */
+export declare const PRECLAIM_WINDOW_MS = 120000;
+export declare const PARK_BASE_MS = 60000;
+export declare const PARK_MAX_MS: number;
+/** Queued work on an awake target that has not been claimed for this long is reported once (§1.4). */
+export declare const CLAIM_BLOCK_NOTICE_MS: number;
+/** How far `warm_cap` may be exceeded for leased work (§1.6). */
+export declare const DEFAULT_WARM_OVERFLOW = 2;
+export declare const WATCHDOG_INTERVAL_MS = 30000;
+export interface WakeCoordinatorDeps {
+    mode(target: string): DeliveryWorkerMode;
+    /**
+     * Whether the outbox can be read now. False once its database is closed
+     * (fleet shutdown, a test tearing down): the coordinator then does nothing,
+     * and stops itself, instead of querying a closed connection.
+     */
+    available(): boolean;
+    /** Rows still to deliver: queued, retry_wait, delivering, submission_started (created_seq order). */
+    listPending(): OutboxDelivery[];
+    isPaused(target: string): boolean;
+    pauseReason(target: string): PauseReason | null;
+    isRestarting(target: string): boolean;
+    /** The single-flight lifecycle wake, marked as the coordinator's own. */
+    wake(target: string): Promise<void>;
+    /** Instances counted against warm_cap right now (running, not paused, not general). */
+    residentNames(): string[];
+    /** warm_cap; 0 or less means unlimited. */
+    warmCap(): number;
+    warmOverflow(): number;
+    /** When the target was last woken or started for work (the pre-claim clock). */
+    wokeAt(target: string): number | undefined;
+    /** Why an awake target is not accepting input (dialog, auth hold…), or null. */
+    notAcceptingReason(target: string): string | null;
+    notifyTarget(target: string, text: string): void;
+    /**
+     * Run the outbox pump. A wake changes no outbox row, so nothing else would
+     * tell the pump that the target it skipped while paused can be claimed now.
+     */
+    kickPump(): void;
+    notifySender(source: string, text: string): void;
+    now(): number;
+    logger: {
+        info(obj: object, msg: string): void;
+        warn(obj: object, msg: string): void;
+        debug?(obj: object, msg: string): void;
+    };
+}
+export declare class WakeCoordinator {
+    private readonly deps;
+    private readonly states;
+    /** Targets whose wake is in flight (a reservation each, counted against the hard cap). */
+    private readonly reserved;
+    private scanTimer;
+    private watchdog;
+    private stopped;
+    constructor(deps: WakeCoordinatorDeps);
+    start(): void;
+    stop(): void;
+    /** Schedule a scan soon (coalesced). Safe to call from any event. */
+    kick(delayMs?: number): void;
+    private state;
+    private active;
+    /**
+     * The pump must not claim this target (§3.1, §1.4): it is paused, being
+     * woken, or awake but not accepting input by the daemon's own account
+     * (a dialog, a login failure, stuck). Called from the pump's claim
+     * callback, in the same synchronous step that reads the daemon's bootId, so
+     * the verdict and the claim are about the same daemon generation. A busy
+     * (working) target is accepting: the manager's idle gate still waits it out.
+     */
+    blocksClaim(target: string): boolean;
+    isWaking(target: string): boolean;
+    /** The last wake error, while the target is failing to wake (for the expiry reason). */
+    wakeFailure(target: string): string | null;
+    isParked(target: string): boolean;
+    /**
+     * A wake that did not come from here (an operator's /wake or wake_instance,
+     * a user's channel message) *succeeded*. Park and backoff block only
+     * automatic wakes, so such a wake always gets its one attempt (§1.6); only
+     * its success lifts them. A failed attempt, or a refusal for capacity,
+     * leaves the park and backoff exactly as they were. If the hold persists
+     * after a successful wake, the park comes back on its next window with the
+     * level kept (it is reset only by a delivery).
+     */
+    noteExternalWake(target: string): void;
+    /** A row for `target` was delivered: the hold is over, and so are the backoffs. */
+    noteDelivered(target: string): void;
+    /** Free warm slots under the hard cap, counting every target exactly once. */
+    private freeSlots;
+    /** Synchronously take a slot for `target` (before any await). */
+    tryReserve(target: string): symbol | null;
+    /** Return exactly the slot `token` holds (idempotent). */
+    release(target: string, token: symbol): void;
+    get reservedCount(): number;
+    /**
+     * One pass over the pending queue: wake what needs waking, park what will
+     * not take work. Runs from timers, so it must never throw: an exception
+     * there is uncaught and takes the whole fleet process down (e.g. a scan
+     * landing after the outbox's database was closed). The next kick or the
+     * watchdog retries.
+     */
+    scan(): void;
+    private scanOnce;
+    /**
+     * An awake target with queued work: past its pre-claim window without the
+     * work moving, it is parked (no automatic re-wake until the hold clears or
+     * the park expires), and a long pre-claim block is reported once.
+     */
+    private checkAwakeTarget;
+    /**
+     * Whether a wake completion must do nothing but return its slot: the
+     * coordinator was stopped, or the outbox went away while the wake was in
+     * flight (the coordinator stops itself then). Checked before any side
+     * effect, so a late completion can never kick a pump at a closed database.
+     */
+    private fencedCompletion;
+    private startWake;
+}