@songsid/agend 2.1.7-beta.6 → 2.1.7-beta.7

package/dist/status-emojis.js

@@ -0,0 +1,206 @@
+/**
+ * Configurable delivery-status emojis (#1005).
+ *
+ * One module owns how a configured status emoji is read, checked, resolved
+ * and compared, so the reaction a bot stamps, the reaction it later removes,
+ * the reactions the fleet filters out as its own, and the list the
+ * instructions tell agents to avoid all come from the same value.
+ *
+ * Resolution, per status key: instance `status_emojis` → the bound channel's
+ * `options.status_emojis` → the built-in value for that platform. The
+ * built-ins are exactly what AgEnD stamped before this was configurable.
+ */
+export const STATUS_EMOJI_KEYS = ["received", "queued", "processing", "delivered", "failed"];
+export const STATUS_EMOJI_CONFIG_KEYS = [...STATUS_EMOJI_KEYS, "progress_prefix"];
+/**
+ * Telegram accepts only this fixed reaction set (Bot API ReactionTypeEmoji).
+ * Spelled as the Bot API spells them: without the U+FE0F variation selector.
+ */
+export const TELEGRAM_REACTION_EMOJIS = new Set([
+    "👍", "👎", "❤", "🔥", "🥰", "👏", "😁", "🤔", "🤯", "😱", "🤬", "😢", "🎉", "🤩", "🤮", "💩", "🙏", "👌", "🕊", "🤡",
+    "🥱", "🥴", "😍", "🐳", "❤‍🔥", "🌚", "🌭", "💯", "🤣", "⚡", "🍌", "🏆", "💔", "🤨", "😐", "🍓", "🍾", "💋", "🖕", "😈",
+    "😴", "😭", "🤓", "👻", "👨‍💻", "👀", "🎃", "🙈", "😇", "😨", "🤝", "✍", "🤗", "🫡", "🎅", "🎄", "☃", "💅", "🤪", "🗿",
+    "🆒", "💘", "🙉", "🦄", "😘", "💊", "🙊", "😎", "👾", "🤷‍♂", "🤷", "🤷‍♀", "😡",
+]);
+const BUILTIN_DEFAULT = {
+    received: "👀", queued: "⏳", processing: "👀", delivered: "✅", failed: "❌", progress_prefix: "👀",
+};
+/** Telegram's smaller vocabulary: ⏳/✅/❌ are not valid Telegram reactions. */
+const BUILTIN_TELEGRAM = {
+    received: "👀", queued: "👀", processing: "👀", delivered: "👀", failed: "👎", progress_prefix: "👀",
+};
+export function builtinStatusEmojis(platform) {
+    return { ...(platform === "telegram" ? BUILTIN_TELEGRAM : BUILTIN_DEFAULT) };
+}
+const GRAPHEMES = new Intl.Segmenter(undefined, { granularity: "grapheme" });
+function graphemeCount(s) {
+    let n = 0;
+    for (const _ of GRAPHEMES.segment(s))
+        if (++n > 1)
+            break;
+    return n;
+}
+const CUSTOM_TAG_RE = /^<(a?):([A-Za-z0-9_]{2,32}):(\d{15,25})>$/;
+const CUSTOM_BARE_RE = /^(?:(a):)?([A-Za-z0-9_]{2,32}):(\d{15,25})$/;
+const PICTOGRAPH_RE = /\p{Extended_Pictographic}|\p{Regional_Indicator}|\u20E3/u;
+/**
+ * Parse one configured value. Discord custom emoji may be written `<:name:id>`,
+ * `<a:name:id>` or bare `name:id`; anything else must be exactly one emoji
+ * grapheme (no spaces, no words, not two emojis). Returns null otherwise.
+ */
+export function normalizeEmoji(raw) {
+    if (typeof raw !== "string")
+        return null;
+    const s = raw.trim();
+    if (!s)
+        return null;
+    const custom = CUSTOM_TAG_RE.exec(s) ?? CUSTOM_BARE_RE.exec(s);
+    if (custom)
+        return { kind: "custom", animated: custom[1] === "a", name: custom[2], id: custom[3] };
+    // Exactly one grapheme: 👀✅ is two emojis that no platform can stamp as
+    // one reaction — accepting it lost that status silently. Segmenting by
+    // grapheme (not code points) keeps ZWJ sequences (👨‍👩‍👧), flags (🇹🇼) and
+    // skin tones (👍🏽) as the single emoji they are.
+    if (/[\sA-Za-z0-9<>:]/.test(s) || !PICTOGRAPH_RE.test(s) || graphemeCount(s) !== 1)
+        return null;
+    return { kind: "unicode", value: s };
+}
+const stripVariation = (s) => s.replace(/\uFE0F/g, "");
+/**
+ * Why a value cannot be used on `platform`, or null when it can. Telegram has
+ * no custom emoji and only the fixed reaction set; Discord takes any emoji.
+ * `progress_prefix` is message text, not a reaction, so any emoji works there.
+ */
+export function statusEmojiProblem(platform, key, raw) {
+    const e = normalizeEmoji(raw);
+    if (!e)
+        return `"${String(raw)}" is not an emoji (use a single emoji, or <:name:id> for a Discord server emoji)`;
+    if (platform !== "telegram")
+        return null;
+    if (e.kind === "custom")
+        return "Telegram has no server custom emoji";
+    if (key === "progress_prefix")
+        return null;
+    if (!TELEGRAM_REACTION_EMOJIS.has(stripVariation(e.value)))
+        return `"${e.value}" is not in Telegram's allowed reaction set`;
+    return null;
+}
+/**
+ * The string handed to adapter.react()/unreact(). The same form must go to
+ * both, or the old status reaction is never removed when the status advances.
+ * Discord's REST route and discord.js both take `name:id` for a custom emoji;
+ * Telegram wants its own spelling of the emoji (no variation selector).
+ */
+export function reactionForm(platform, raw) {
+    const e = normalizeEmoji(raw);
+    if (!e)
+        return raw;
+    if (e.kind === "custom")
+        return `${e.name}:${e.id}`;
+    return platform === "telegram" ? stripVariation(e.value) : e.value;
+}
+/** How a status emoji reads in text: custom emoji as `:name:`, not `<:name:id>`. */
+export function displayForm(raw) {
+    const e = normalizeEmoji(raw);
+    if (!e)
+        return raw;
+    return e.kind === "custom" ? `:${e.name}:` : e.value;
+}
+/** Message-text form (progress bubble): Discord renders `<:name:id>` inline. */
+export function textForm(platform, raw) {
+    const e = normalizeEmoji(raw);
+    if (!e)
+        return raw;
+    if (e.kind === "custom")
+        return platform === "discord" ? `<${e.animated ? "a" : ""}:${e.name}:${e.id}>` : `:${e.name}:`;
+    return e.value;
+}
+/**
+ * Comparison key for "is this reaction one of the status emojis": a custom
+ * emoji by id (its name can be renamed and is not unique), a unicode emoji
+ * without variation selectors (👁️ and 👁 are the same reaction).
+ */
+export function statusMatchKey(raw) {
+    const e = normalizeEmoji(raw);
+    if (e?.kind === "custom")
+        return `id:${e.id}`;
+    return stripVariation((e?.value ?? raw).trim());
+}
+/** The same key computed from an inbound reaction. */
+export function reactionMatchKey(emoji, emojiId) {
+    return emojiId ? `id:${emojiId}` : stripVariation(emoji.trim());
+}
+/**
+ * Resolve every status key. An unusable value never fails a reaction: it is
+ * reported through onInvalid and that key falls through to the next layer.
+ */
+export function resolveStatusEmojis(input) {
+    const out = builtinStatusEmojis(input.platform);
+    const layers = [["platform", input.platformConfig], ["instance", input.instanceConfig]];
+    for (const [source, cfg] of layers) {
+        if (!cfg || typeof cfg !== "object" || Array.isArray(cfg))
+            continue;
+        for (const key of STATUS_EMOJI_CONFIG_KEYS) {
+            const value = cfg[key];
+            if (value === undefined || value === null || value === "")
+                continue;
+            const problem = statusEmojiProblem(input.platform, key, value);
+            if (problem) {
+                input.onInvalid?.(source, key, value, problem);
+                continue;
+            }
+            out[key] = value.trim();
+        }
+    }
+    return out;
+}
+/** The status reactions (not progress_prefix), deduplicated, in display form. */
+export function statusAvoidList(resolved) {
+    return [...new Set(STATUS_EMOJI_KEYS.map(k => displayForm(resolved[k])))];
+}
+/** Match keys for every status reaction in `resolved`. */
+export function statusMatchKeys(resolved) {
+    return STATUS_EMOJI_KEYS.map(k => statusMatchKey(resolved[k]));
+}
+// ── Settings picker / preview (#1005 phase 3.2) ─────────────────────────────
+// The page asks the server to resolve and render, so what it previews is what
+// resolveStatusEmojis and reactionForm produce — picked == previewed == reacted.
+/** A handful of unicode status emojis to offer on Discord (Telegram offers its whole set). */
+export const STATUS_EMOJI_SUGGESTIONS = [
+    "👀", "⏳", "✅", "❌", "📥", "📨", "📬", "📭", "🟢", "🟡", "🔴", "⚪", "🔵", "✔️", "☑️", "✖️", "⚠️", "🚫",
+    "🔄", "⏱️", "⌛", "💬", "💭", "🧠", "⚙️", "🛠️", "🚀", "🎯", "🏁", "🎉", "👍", "👎", "👌", "🙏", "🤔", "🫡",
+    "🦊", "🍎", "🐱", "🐶", "🐼", "🦉", "🐙", "🌟", "⭐", "🔥", "💡", "📌",
+];
+/** Stored config form of a Discord server emoji. */
+export function customEmojiValue(e) {
+    return `<${e.animated ? "a" : ""}:${e.name}:${e.id}>`;
+}
+/** Discord's public CDN renders a known custom emoji id without any token. */
+export function emojiImageUrl(raw) {
+    const e = normalizeEmoji(raw);
+    if (e?.kind !== "custom")
+        return null;
+    return `https://cdn.discordapp.com/emojis/${e.id}.${e.animated ? "gif" : "png"}`;
+}
+export function previewStatusEmojis(input) {
+    const problems = [];
+    const resolved = resolveStatusEmojis({ ...input, onInvalid: (source, key, value, problem) => problems.push({ source, key, value, problem }) });
+    const usable = (cfg, key) => {
+        if (!cfg || typeof cfg !== "object" || Array.isArray(cfg))
+            return false;
+        const v = cfg[key];
+        return v !== undefined && v !== null && v !== "" && !statusEmojiProblem(input.platform, key, v);
+    };
+    const entries = STATUS_EMOJI_CONFIG_KEYS.map((key) => {
+        const value = resolved[key];
+        return {
+            key, value,
+            source: usable(input.instanceConfig, key) ? "instance" : usable(input.platformConfig, key) ? "platform" : "builtin",
+            applied: key === "progress_prefix" ? textForm(input.platform, value) : reactionForm(input.platform, value),
+            display: displayForm(value),
+            image_url: emojiImageUrl(value),
+        };
+    });
+    return { platform: input.platform, entries, problems, avoid: statusAvoidList(resolved) };
+}
+//# sourceMappingURL=status-emojis.js.map

package/dist/status-emojis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-emojis.js","sourceRoot":"","sources":["../src/status-emojis.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -89,6 +89,12 @@ export interface InstanceConfig {
     warm_cap?: number;
     /** Agent display name (e.g. "Kuro", "Luna") — chosen by the agent itself */
     display_name?: string;
+    /**
+     * #1005: this instance's own delivery-status emojis, overriding its
+     * channel's `options.status_emojis` per key. Keys: received, queued,
+     * processing, delivered, failed, progress_prefix.
+     */
+    status_emojis?: import("./status-emojis.js").StatusEmojiConfig;
     /** Human-readable description of what this instance does */
     description?: string;
     /** Tags for capability discovery (e.g. ["code-reviewer", "researcher", "executor"]) */

package/dist/ui/settings.html

@@ -145,6 +145,18 @@
     .pending-bar .grow { display:none; }
     .pending-bar button { flex:1; }
   }
+  /* #1005 status-emoji editor */
+  .se-preview { display: flex; flex-wrap: wrap; gap: 6px 14px; padding: 8px 10px; border: 1px solid var(--border); border-radius: var(--radius-sm); background: #fff; margin-bottom: 6px; }
+  .se-item { display: inline-flex; align-items: center; gap: 5px; font-size: 12px; color: var(--muted); }
+  .se-glyph { font-size: 20px; line-height: 1; min-width: 22px; text-align: center; }
+  .se-glyph img { width: 22px; height: 22px; object-fit: contain; vertical-align: middle; }
+  .se-row { display: grid; grid-template-columns: 120px 1fr auto auto; gap: 6px; align-items: center; margin: 4px 0; }
+  .se-row label { margin: 0; }
+  .se-picker { grid-column: 1 / -1; border: 1px solid var(--border); border-radius: var(--radius-sm); padding: 8px; background: #fff; }
+  .se-grid { display: flex; flex-wrap: wrap; gap: 4px; margin: 4px 0 8px; }
+  .se-grid button { padding: 3px 6px; font-size: 18px; line-height: 1.2; }
+  .se-grid button img { width: 22px; height: 22px; object-fit: contain; vertical-align: middle; }
+  .se-grid button.off { opacity: .45; }
 </style>
 </head>
 <body>
@@ -238,6 +250,11 @@
       backend: "Backend", model: "Model", workingDir: "Working directory", channelBinding: "Channel binding",
       description: "Description", systemPrompt: "System prompt", tags: "Tags", generalTopicField: "General topic (fleet dispatcher)",
       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_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)",
       classicAdmins: "ClassicBot admins", allowedGuilds: "Allowed guilds", type: "Type", adapterId: "Adapter id",
@@ -282,6 +299,11 @@
       mustNonNegative: "Must be 0 or greater", mustPositive: "Must be greater than 0", nonnegativeInteger: "Must be a non-negative integer", failoverEmpty: "Empty list disables failover", concurrencyRange: "Must be an integer from 1 to 20", concurrencyWarning: "May exceed CPU capacity on smaller hosts", staggerRange: "Must be between 0 and 30000", staggerWarning: "Very low values can cause startup spikes",
     },
     "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_hint: "留空即使用預設值。預覽由 AgEnD 依 bot 實際 react 的方式解析。",
       title: "⚙️ AgEnD 設定", reloadFleet: "↻ 重新載入", myAgents: "🤖 我的 Agent", bots: "🔌 機器人", classicChannels: "🎮 ClassicBot 頻道", noClassic: "沒有 ClassicBot 頻道 — 在聊天中用 /start 建立。",
       general: "⚙️ 一般設定", whatsNew: "🆕 更新重點", advanced: "📋 進階",
       expand: "▶ 展開", collapse: "▼ 收合", new: "+ 新增", add: "+ 加入", searchPh: "🔍 搜尋…",
@@ -451,6 +473,118 @@
     return box;
   }
 
+  // ── Status emojis (#1005) ──
+  // The page never resolves or checks an emoji itself: /status-emojis/preview
+  // runs the code the bots react with, so what shows here is what gets
+  // stamped, and a picked server emoji is stored in the form they react with.
+  let statusEmojiCatalog = null;
+  async function loadStatusEmojiCatalog() {
+    if (statusEmojiCatalog) return statusEmojiCatalog;
+    const r = await api("/api/settings/status-emojis");
+    statusEmojiCatalog = r.ok ? r.body : { keys: [], builtins: {}, telegram_allowed: [], suggestions: [] };
+    return statusEmojiCatalog;
+  }
+  const guildEmojiLists = new Map();
+  function fetchGuildEmojis(channelId, refresh) {
+    if (refresh || !guildEmojiLists.has(channelId)) {
+      guildEmojiLists.set(channelId, api(`/api/settings/status-emojis/guild-emojis?channel=${encodeURIComponent(channelId)}${refresh ? "&refresh=1" : ""}`)
+        .then(r => r.ok ? r.body : { error: r.body?.error || `HTTP ${r.status}` }));
+    }
+    return guildEmojiLists.get(channelId);
+  }
+  // no-referrer: the settings URL can carry the web token.
+  const emojiImg = (url, alt) => el("img", { src: url, alt, referrerpolicy: "no-referrer", loading: "lazy" });
+  const emojiGlyph = (entry) => el("span", { class: "se-glyph" }, entry.image_url ? emojiImg(entry.image_url, entry.display) : entry.value);
+  /** Keys in catalog order, blanks dropped — so an unchanged map compares equal. */
+  function orderedStatusMap(map, keys) {
+    const out = {};
+    for (const key of keys) { const v = map?.[key]; if (typeof v === "string" && v.trim()) out[key] = v.trim(); }
+    return Object.keys(out).length ? out : null;
+  }
+  /**
+   * Editor for one status_emojis map. `scope.platform()` and
+   * `scope.channelId()` say where it applies; `scope.previewBody(map)` is what
+   * the preview resolves (the channel map, or an instance override on top of
+   * its channel's).
+   */
+  function statusEmojiEditor(own, scope) {
+    const values = { ...(own || {}) };
+    let keys = [];
+    const box = el("div", { class: "se" });
+    const preview = el("div", { class: "se-preview" }, el("span", { class: "hint" }, "…"));
+    const problems = el("div", { class: "feedback" });
+    const rows = el("div", { class: "se-rows" });
+    let timer = null, seq = 0;
+    const refresh = () => { clearTimeout(timer); timer = setTimeout(runPreview, 150); };
+    async function runPreview() {
+      const mine = ++seq;
+      const r = await api("/api/settings/status-emojis/preview", { method: "POST", body: JSON.stringify(scope.previewBody(orderedStatusMap(values, keys) || {})) });
+      if (mine !== seq) return;
+      preview.innerHTML = "";
+      if (!r.ok) { problems.className = "feedback error"; problems.textContent = `✗ ${r.body?.error || "preview failed"}`; return; }
+      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}`))));
+      }
+      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("  ");
+    }
+    function openPicker(row, key, input) {
+      row.querySelector(".se-picker")?.remove();
+      const picker = el("div", { class: "se-picker" });
+      const choose = (value) => { input.value = value; values[key] = value; picker.remove(); refresh(); };
+      const grid = (items) => { const g = el("div", { class: "se-grid" }); for (const it of items) g.append(it); return g; };
+      const unicodeButton = (emoji) => el("button", { type: "button", class: "sm", title: emoji, onclick: () => choose(emoji) }, emoji);
+      const platform = scope.platform();
+      const cat = statusEmojiCatalog;
+      // progress_prefix is message text, so Telegram's reaction set does not bind it.
+      const unicode = platform === "telegram" && key !== "progress_prefix" ? cat.telegram_allowed : cat.suggestions;
+      picker.append(el("div", { class: "hint" }, platform === "telegram" && key !== "progress_prefix" ? t("se_telegramOnly") : t("se_unicode")), grid(unicode.map(unicodeButton)));
+      const channelId = scope.channelId();
+      if (platform === "discord" && channelId) {
+        const guildBox = el("div");
+        const load = async (refreshList) => {
+          guildBox.innerHTML = ""; guildBox.append(el("div", { class: "hint" }, "…"));
+          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}:`)))));
+        };
+        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);
+        load(false);
+      }
+      picker.append(el("div", { class: "actions" }, el("button", { type: "button", class: "sm ghost", onclick: () => picker.remove() }, t("close"))));
+      row.append(picker);
+    }
+    (async () => {
+      const cat = await loadStatusEmojiCatalog();
+      keys = cat.keys;
+      const builtins = cat.builtins[scope.platform() === "telegram" ? "telegram" : "discord"] || {};
+      for (const key of keys) {
+        const input = el("input", { type: "text", value: values[key] || "", placeholder: builtins[key] || "", autocomplete: "off" });
+        input.addEventListener("input", () => { values[key] = input.value; refresh(); });
+        const row = el("div", { class: "se-row" });
+        row.append(el("label", {}, t(`se_${key}`)), input,
+          el("button", { type: "button", class: "sm", onclick: () => openPicker(row, key, input) }, t("se_pick")),
+          el("button", { type: "button", class: "sm ghost", title: t("se_useDefault"), onclick: () => { input.value = ""; values[key] = ""; refresh(); } }, "×"));
+        rows.append(row);
+      }
+      runPreview();
+    })();
+    box.append(preview, problems, rows, el("div", { class: "hint" }, t("se_hint")));
+    return { box, refresh, value: () => orderedStatusMap(values, keys), baseline: () => orderedStatusMap(own, keys) };
+  }
+
   /**
    * One modal edits one object, and closing it stages a change — it never
    * writes. Applying stays where it was: the Apply button on the pending bar.
@@ -980,6 +1114,15 @@
     const fallbackValue = Array.isArray(inst.model_failover) ? (inst.model_failover[0] || "") : (defaults.model_failover?.[0] || "");
     const failover = overrideControl(inst, "model_failover", el("input", { type: "text", value: fallbackValue, placeholder: "e.g. sonnet" }), defaults.model_failover?.[0] || "");
     const displayName = overrideControl(inst, "display_name", el("input", { type: "text", value: inst.display_name ?? defaults.display_name ?? "", placeholder: name }), defaults.display_name || "");
+    // The override sits on top of the bound channel's map, so the preview is
+    // resolved against whichever channel the form currently binds.
+    const boundChannelId = () => fChan.value || channelIds()[0] || null;
+    const statusEmojis = statusEmojiEditor(inst.status_emojis, {
+      platform: () => chById(boundChannelId())?.type,
+      channelId: boundChannelId,
+      previewBody: map => ({ channel_id: boundChannelId(), instance_config: map }),
+    });
+    fChan.addEventListener("change", statusEmojis.refresh);
     const autoFeedback = el("div", { class: "feedback" });
     const hangFeedback = el("div", { class: "feedback" });
     const failoverFeedback = el("div", { class: "feedback" });
@@ -1016,6 +1159,7 @@
         lightweight: lightweight.toggle.checked ? null : lightweight.input.checked,
         model_failover: failover.toggle.checked ? null : (failover.input.value.trim() ? [failover.input.value.trim()] : []),
         display_name: displayName.toggle.checked ? null : displayName.input.value.trim(),
+        status_emojis: statusEmojis.value(),
       };
       const patch = changedFields(nextPatch, {
         backend: inst.backend || defaults.backend || "claude-code",
@@ -1036,6 +1180,7 @@
         lightweight: hasOwn(inst, "lightweight") ? inst.lightweight : null,
         model_failover: hasOwn(inst, "model_failover") ? inst.model_failover : null,
         display_name: hasOwn(inst, "display_name") ? inst.display_name : null,
+        status_emojis: statusEmojis.baseline(),
       });
       state.fleet.instances[name] = { ...inst, ...patch };
       for (const [key, value] of Object.entries(patch)) if (value === null) delete state.fleet.instances[name][key];
@@ -1074,6 +1219,8 @@
         el("label", {}, t("systemPrompt"), impact("instance.systemPrompt")), fSys,
         el("label", {}, t("tags"), impact("instance.tags")), chipList(tags, null, "tag"),
         el("label", { style: "display:flex;align-items:center;gap:8px;cursor:pointer" }, fGeneral, el("span", {}, t("generalTopicField")), impact("instance.general_topic"))),
+      drawer(t("statusEmojis"),
+        el("label", {}, t("statusEmojisInstance"), impact("instance.status_emojis")), statusEmojis.box),
       el("div", { class: "actions" }, msg),
     );
     validate();
@@ -1093,7 +1240,7 @@
     "instance.tool_set", "instance.tool_progress",
     "instance.reply_completion_guard", "instance.log_level",
     "instance.lightweight", "instance.model_failover", "instance.systemPrompt",
-    "instance.tags", "instance.general_topic",
+    "instance.tags", "instance.general_topic", "instance.status_emojis",
   ];
   async function toggleAgent(name, running) {
     if (running) await api(`/stop/${encodeURIComponent(name)}`, { method: "POST" });
@@ -1328,6 +1475,11 @@
       });
       secretFeedback.className = "feedback"; secretFeedback.textContent = "Queued — click Apply changes.";
     };
+    const statusEmojis = statusEmojiEditor(ch.options?.status_emojis, {
+      platform: () => type,
+      channelId: () => connectionId,
+      previewBody: map => ({ channel_id: connectionId, platform: type, channel_config: map }),
+    });
     const validateAccess = () => setValidation(fMode, accessFeedback, "", fMode.value === "locked" && users.length === 0 ? t("accessLockedEmpty") : "");
     fMode.addEventListener("change", validateAccess);
     box.append(
@@ -1340,6 +1492,8 @@
         el("label", {}, type === "discord" ? "General channel id" : "Forum topic id"), fGeneral,
         el("div", { class: "hint" }, "The target is checked with the existing bot token before any binding is changed."),
         el("div", { class: "actions" }, bindingVerify, bindingFeedback)),
+      drawer(t("statusEmojis"),
+        el("label", {}, t("statusEmojisChannel"), impact("fleet.channel.options.status_emojis")), statusEmojis.box),
       drawer(t("advancedSection"),
         el("div", { class: "field" }, el("label", {}, t("tokenEnv")), el("div", { class: "sub" }, ch.bot_token_env || "(no token env)")),
         el("div", { class: "field" },
@@ -1352,7 +1506,7 @@
     validateAccess();
     return {
       box,
-      impacts: ["fleet.channel.access.mode", "fleet.channel.access.allowed_users", "fleet.channels"],
+      impacts: ["fleet.channel.access.mode", "fleet.channel.access.allowed_users", "fleet.channels", "fleet.channel.options.status_emojis"],
       // Staged, not saved: the old form wrote channels straight to the API from
       // inside the editor, which is the one thing a modal must not do.
       stage: () => {
@@ -1361,13 +1515,21 @@
         const stagedAllowedUsers = [...users];
         const nextChannels = structuredClone(originalChannels);
         nextChannels[i] = { ...nextChannels[i], access: { ...nextChannels[i].access, mode: stagedAccessMode, allowed_users: stagedAllowedUsers } };
-        if (sameValue(nextChannels, originalChannels)) return true;
+        const accessChanged = !sameValue(nextChannels, originalChannels);
+        const stagedStatusEmojis = statusEmojis.value();
+        const emojisChanged = !sameValue(stagedStatusEmojis, statusEmojis.baseline());
+        if (emojisChanged) {
+          const options = { ...(nextChannels[i].options || {}) };
+          if (stagedStatusEmojis) options.status_emojis = stagedStatusEmojis; else delete options.status_emojis;
+          nextChannels[i] = { ...nextChannels[i], options };
+        }
+        if (!accessChanged && !emojisChanged) return true;
         stageChange(`connections:${ch.id || chLabel(i)}`, {
-          label: `Update ${ch.id || chLabel(i)} access`,
-          impact: impactOf("fleet.channels"),
+          label: `Update ${ch.id || chLabel(i)} ${accessChanged && emojisChanged ? "access & status emojis" : accessChanged ? "access" : "status emojis"}`,
+          impact: impactOf(accessChanged ? "fleet.channels" : "fleet.channel.options.status_emojis"),
           // Confirm the immutable staged snapshot, not live form controls
           // that the user may edit again before pressing global Apply.
-          confirm: () => confirmAccessChange(previousAccess, stagedAccessMode, stagedAllowedUsers),
+          confirm: () => !accessChanged || confirmAccessChange(previousAccess, stagedAccessMode, stagedAllowedUsers),
           cancelMessage: t("accessChangeCancelled"),
           apply: () => api("/api/settings/fleet/channels", { method: "PUT", body: JSON.stringify(nextChannels) }),
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@songsid/agend",
-  "version": "2.1.7-beta.6",
+  "version": "2.1.7-beta.7",
   "description": "Multi-agent fleet daemon — run any coding CLI (Claude, Gemini, Codex, OpenCode) from Telegram",
   "type": "module",
   "bin": {