@decentnetwork/beagle 0.1.105 → 0.1.108

package/dist/assistant-stats.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Per-friend conversation statistics for the Assistant's friend filters.
+ *
+ * Computed HERE, in the server process, and never in the browser: the answer
+ * for a whole friend list is a few hundred bytes, while the history it is
+ * derived from is megabytes (one group thread on this Mac is 9 MB). Paging
+ * that into a tab — or over IPC — is what stalled the daemon in 0.1.90.
+ *
+ * The source is <configDir>/messages.json, the file BOTH backends write (the
+ * daemon's src/daemon/message-store.ts and our own src/message-store.ts use
+ * the same path and the same shape). Reading it directly is the same move
+ * friendStoreStamps() makes for `<keyFile>.friends.json`, and for the same
+ * reason: it is a file in our own config dir, and the alternative is an op
+ * that hauls every message across a socket to count them.
+ *
+ * Note for the ports (docs/assistant/SPEC.md): there are no call records in
+ * the store, so `lastCallTs` is always undefined and the `never-called`
+ * filter is not offered.
+ */
+export interface FriendStats {
+    /** Earliest message with this friend held on this device. */
+    firstMsgTs?: number;
+    lastInboundTs?: number;
+    lastOutboundTs?: number;
+    inboundCount: number;
+    outboundCount: number;
+    /** Always undefined: the store holds no call records. Kept so the shape
+     *  matches the spec and a later version can fill it in. */
+    lastCallTs?: number;
+}
+export interface HistoryStats {
+    byPeer: Map<string, FriendStats>;
+    /** Earliest message timestamp held on this device, across every thread.
+     *  Every Assistant answer is qualified with it: a friend you only talk to
+     *  on your phone looks silent here, and the user has to see that. */
+    historySince?: number;
+}
+/** Read and aggregate <configDir>/messages.json. Cached by mtime+size, so the
+ *  9 MB parse happens once per change however many commands are typed. */
+export declare function historyStats(messagesPath: string | undefined): HistoryStats;
+/** Split out from the file read so tests can feed it a plain object. */
+export declare function aggregate(raw: unknown): HistoryStats;

package/dist/assistant-stats.js

@@ -0,0 +1,78 @@
+/**
+ * Per-friend conversation statistics for the Assistant's friend filters.
+ *
+ * Computed HERE, in the server process, and never in the browser: the answer
+ * for a whole friend list is a few hundred bytes, while the history it is
+ * derived from is megabytes (one group thread on this Mac is 9 MB). Paging
+ * that into a tab — or over IPC — is what stalled the daemon in 0.1.90.
+ *
+ * The source is <configDir>/messages.json, the file BOTH backends write (the
+ * daemon's src/daemon/message-store.ts and our own src/message-store.ts use
+ * the same path and the same shape). Reading it directly is the same move
+ * friendStoreStamps() makes for `<keyFile>.friends.json`, and for the same
+ * reason: it is a file in our own config dir, and the alternative is an op
+ * that hauls every message across a socket to count them.
+ *
+ * Note for the ports (docs/assistant/SPEC.md): there are no call records in
+ * the store, so `lastCallTs` is always undefined and the `never-called`
+ * filter is not offered.
+ */
+import { readFileSync, statSync } from "fs";
+const EMPTY = { byPeer: new Map(), historySince: undefined };
+let cache = null;
+/** Read and aggregate <configDir>/messages.json. Cached by mtime+size, so the
+ *  9 MB parse happens once per change however many commands are typed. */
+export function historyStats(messagesPath) {
+    if (!messagesPath)
+        return EMPTY;
+    try {
+        const st = statSync(messagesPath);
+        if (cache && cache.path === messagesPath && cache.mtimeMs === st.mtimeMs && cache.size === st.size) {
+            return cache.stats;
+        }
+        const raw = JSON.parse(readFileSync(messagesPath, "utf-8"));
+        const stats = aggregate(raw);
+        cache = { path: messagesPath, mtimeMs: st.mtimeMs, size: st.size, stats };
+        return stats;
+    }
+    catch {
+        // Absent (nothing said yet), unreadable, or half-written: whatever we last
+        // read, else nothing. The friend list still answers, with zero counts —
+        // and the "since" line tells the user the history is not known.
+        return cache?.stats ?? EMPTY;
+    }
+}
+/** Split out from the file read so tests can feed it a plain object. */
+export function aggregate(raw) {
+    const byPeer = new Map();
+    let historySince;
+    const threads = (raw && typeof raw === "object" ? raw : {});
+    for (const [peer, value] of Object.entries(threads)) {
+        if (!Array.isArray(value))
+            continue;
+        const s = { inboundCount: 0, outboundCount: 0 };
+        for (const m of value) {
+            const ts = typeof m?.ts === "number" ? m.ts : undefined;
+            if (m?.dir === "in") {
+                s.inboundCount++;
+                if (ts !== undefined && (s.lastInboundTs === undefined || ts > s.lastInboundTs))
+                    s.lastInboundTs = ts;
+            }
+            else if (m?.dir === "out") {
+                s.outboundCount++;
+                if (ts !== undefined && (s.lastOutboundTs === undefined || ts > s.lastOutboundTs))
+                    s.lastOutboundTs = ts;
+            }
+            else {
+                continue; // not a message record
+            }
+            if (ts !== undefined && (s.firstMsgTs === undefined || ts < s.firstMsgTs))
+                s.firstMsgTs = ts;
+        }
+        byPeer.set(peer, s);
+        if (s.firstMsgTs !== undefined && (historySince === undefined || s.firstMsgTs < historySince)) {
+            historySince = s.firstMsgTs;
+        }
+    }
+    return { byPeer, historySince };
+}

package/dist/cli.js

@@ -171,6 +171,7 @@ async function main() {
         routesPath: resolve(args.configDir, "routes.yaml"),
         doraRosterPath,
         downloadsDir: resolve(args.configDir, "downloads"),
+        messagesPath: resolve(args.configDir, "messages.json"),
         callIce: {
             keyFile: resolve(decentlanCarrierDir(args.configDir), "keypair.json"),
             bootstrapNodes,

package/dist/desktop/app.js

@@ -1,4 +1,4 @@
-window.__DK_UI_VERSION="0.1.105";
+window.__DK_UI_VERSION="0.1.108";
 "use strict";
 (() => {
   // packages/beagle-ui/dist/beagle-ui.js
@@ -501,6 +501,558 @@ window.__DK_UI_VERSION="0.1.105";
     DK_ME_FALLBACK,
     dkCopy
   });
+  var actions_default = {
+    version: 1,
+    scope: "assistant",
+    note: "The Assistant's action list. /help is generated from it, the router dispatches from it, and iOS/Android implement it. A later natural-language layer translates a sentence into one of these actions and nothing else. See docs/assistant/SPEC.md.",
+    actions: [
+      {
+        name: "help",
+        usage: "/help",
+        summary: "List what the Assistant can do.",
+        params: { type: "object", properties: {}, required: [] },
+        confirm: "none",
+        scope: "assistant"
+      },
+      {
+        name: "friends-list",
+        usage: "/friends list [filter\u2026]",
+        summary: "Show friends as a table: name, last heard from, messages in/out. With no filter, everyone.",
+        params: {
+          type: "object",
+          properties: {
+            filters: {
+              type: "array",
+              items: { enum: ["never-messaged", "never-replied", "silent", "pending"] },
+              description: "Several filters are OR'd together."
+            },
+            silentDays: { type: "integer", minimum: 1, default: 90, description: "Argument of the silent filter: nothing from them in this many days." }
+          },
+          required: []
+        },
+        confirm: "none",
+        scope: "assistant"
+      },
+      {
+        name: "friends-remove",
+        usage: "/friends remove <filter\u2026>",
+        summary: "Same table with a tick per row and a Remove button. Nothing is removed by typing alone.",
+        params: {
+          type: "object",
+          properties: {
+            filters: {
+              type: "array",
+              items: { enum: ["never-messaged", "never-replied", "silent", "pending"] },
+              minItems: 1
+            },
+            silentDays: { type: "integer", minimum: 1, default: 90 }
+          },
+          required: ["filters"]
+        },
+        confirm: "list",
+        scope: "assistant"
+      },
+      {
+        name: "find",
+        usage: "/find <text>",
+        summary: "Friends whose name, alias, description or ens name contains the text.",
+        params: {
+          type: "object",
+          properties: { text: { type: "string", minLength: 1 } },
+          required: ["text"]
+        },
+        confirm: "none",
+        scope: "assistant"
+      },
+      {
+        name: "rename",
+        usage: "/rename <friend> <new name>",
+        summary: "Set a friend's alias \u2014 what you see them as, on this device.",
+        params: {
+          type: "object",
+          properties: {
+            friend: { type: "string", description: "Matches name, alias or userid prefix. Ambiguous = nothing happens, the candidates are listed." },
+            alias: { type: "string", minLength: 1 }
+          },
+          required: ["friend", "alias"]
+        },
+        confirm: "none",
+        scope: "assistant"
+      },
+      {
+        name: "mute",
+        usage: "/mute <friend>",
+        summary: "Stop alerts from one conversation.",
+        params: {
+          type: "object",
+          properties: { friend: { type: "string" } },
+          required: ["friend"]
+        },
+        confirm: "none",
+        scope: "assistant"
+      },
+      {
+        name: "unmute",
+        usage: "/unmute <friend>",
+        summary: "Alerts from that conversation again.",
+        params: {
+          type: "object",
+          properties: { friend: { type: "string" } },
+          required: ["friend"]
+        },
+        confirm: "none",
+        scope: "assistant"
+      },
+      {
+        name: "sound",
+        usage: "/sound on|off",
+        summary: "Sound on a new message.",
+        params: {
+          type: "object",
+          properties: { on: { type: "boolean" } },
+          required: ["on"]
+        },
+        confirm: "none",
+        scope: "assistant"
+      },
+      {
+        name: "flash",
+        usage: "/flash on|off",
+        summary: "Flash the window on a new message.",
+        params: {
+          type: "object",
+          properties: { on: { type: "boolean" } },
+          required: ["on"]
+        },
+        confirm: "none",
+        scope: "assistant"
+      },
+      {
+        name: "status",
+        usage: "/status",
+        summary: "Friends, pending requests, how far back the history on this device goes, app version.",
+        params: { type: "object", properties: {}, required: [] },
+        confirm: "none",
+        scope: "assistant"
+      }
+    ],
+    filters: [
+      {
+        name: "never-messaged",
+        usage: "never-messaged",
+        summary: "No message either way.",
+        guarded: true
+      },
+      {
+        name: "never-replied",
+        usage: "never-replied",
+        summary: "You wrote at least once, they never did.",
+        guarded: true
+      },
+      {
+        name: "silent",
+        usage: "silent [days]",
+        summary: "Nothing from them for this many days (default 90).",
+        guarded: true,
+        arg: { name: "days", type: "integer", default: 90, minimum: 1 }
+      },
+      {
+        name: "pending",
+        usage: "pending",
+        summary: "A request you sent that was never accepted.",
+        guarded: false
+      }
+    ],
+    dropped: [
+      {
+        name: "never-called",
+        reason: "The message store holds no call records on any platform, so the predicate cannot be evaluated. /api/assistant/friends returns lastCallTs: null and the filter is not offered."
+      }
+    ],
+    guard: {
+      recentDays: 14,
+      applies: "Filters marked guarded never match a friend accepted (or, with no acceptance stamp, requested) less than recentDays ago; the result says how many were skipped."
+    }
+  };
+  var ASSISTANT_ID = "__assistant__";
+  var DAY_MS = 864e5;
+  var RECENT_DAYS = 14;
+  var DEFAULT_SILENT_DAYS = 90;
+  var FILTER_NAMES = ["never-messaged", "never-replied", "silent", "pending"];
+  var GUARDED = /* @__PURE__ */ new Set(["never-messaged", "never-replied", "silent"]);
+  function parseCommand(line) {
+    const text = String(line != null ? line : "").trim();
+    if (!text.startsWith("/"))
+      return null;
+    const parts = text.slice(1).split(/\s+/).filter(Boolean);
+    if (!parts.length)
+      return null;
+    const head = parts[0].toLowerCase();
+    if (head === "friends") {
+      const sub = (parts[1] || "").toLowerCase();
+      if (sub === "list" || sub === "remove")
+        return { ok: true, name: `friends-${sub}`, args: parts.slice(2) };
+      return { ok: false, name: "friends", args: parts.slice(1), error: "friends-subcommand" };
+    }
+    return { ok: true, name: head, args: parts.slice(1) };
+  }
+  function parseFilters(args) {
+    const filters = [];
+    const unknown = [];
+    let silentDays = DEFAULT_SILENT_DAYS;
+    const words = (args != null ? args : []).map((a) => String(a).toLowerCase());
+    for (let i = 0; i < words.length; i++) {
+      const w = words[i];
+      if (!FILTER_NAMES.includes(w)) {
+        unknown.push(words[i]);
+        continue;
+      }
+      if (w === "silent") {
+        const n = Number(words[i + 1]);
+        if (Number.isInteger(n) && n > 0) {
+          silentDays = n;
+          i++;
+        }
+      }
+      if (!filters.includes(w))
+        filters.push(w);
+    }
+    return { filters, silentDays, unknown };
+  }
+  var acceptedOrRequestedAt = (f) => f.acceptedAt || f.requestedAt || 0;
+  function isRecent(friend, now, recentDays = RECENT_DAYS) {
+    const at = acceptedOrRequestedAt(friend);
+    return at > 0 && now - at < recentDays * DAY_MS;
+  }
+  function matchesFilter(friend, filter, { now, silentDays = DEFAULT_SILENT_DAYS } = {}) {
+    const inCount = friend.inboundCount || 0;
+    const outCount = friend.outboundCount || 0;
+    switch (filter) {
+      case "never-messaged":
+        return inCount === 0 && outCount === 0;
+      case "never-replied":
+        return outCount > 0 && inCount === 0;
+      case "silent":
+        return !friend.lastInboundTs || now - friend.lastInboundTs > silentDays * DAY_MS;
+      case "pending":
+        return friend.pending === true;
+      default:
+        return false;
+    }
+  }
+  function selectFriends(friends, filters, { now = Date.now(), silentDays = DEFAULT_SILENT_DAYS, recentDays = RECENT_DAYS } = {}) {
+    const pool = (friends != null ? friends : []).filter((f) => f && f.userid !== ASSISTANT_ID && !f.pinned);
+    if (!filters || !filters.length)
+      return { matched: pool.slice(), skippedRecent: [] };
+    const matched = [];
+    const skippedRecent = [];
+    for (const f of pool) {
+      let hit = false;
+      let guardedOnly = false;
+      for (const filter of filters) {
+        if (!matchesFilter(f, filter, { now, silentDays }))
+          continue;
+        if (GUARDED.has(filter) && isRecent(f, now, recentDays)) {
+          guardedOnly = true;
+          continue;
+        }
+        hit = true;
+        break;
+      }
+      if (hit)
+        matched.push(f);
+      else if (guardedOnly)
+        skippedRecent.push(f);
+    }
+    return { matched, skippedRecent };
+  }
+  function findFriends(friends, text) {
+    const q = String(text != null ? text : "").trim().toLowerCase();
+    if (!q)
+      return [];
+    return (friends != null ? friends : []).filter((f) => f && f.userid !== ASSISTANT_ID).filter((f) => [f.name, f.alias, f.description, f.ens].some((v) => typeof v === "string" && v.toLowerCase().includes(q)));
+  }
+  function resolveFriend(friends, token) {
+    const q = String(token != null ? token : "").trim().toLowerCase();
+    if (!q)
+      return { match: null, candidates: [] };
+    const pool = (friends != null ? friends : []).filter((f) => f && f.userid !== ASSISTANT_ID);
+    const exact = pool.filter((f) => [f.name, f.alias].some((v) => typeof v === "string" && v.toLowerCase() === q));
+    if (exact.length === 1)
+      return { match: exact[0], candidates: exact };
+    if (exact.length > 1)
+      return { match: null, candidates: exact };
+    const partial = pool.filter((f) => [f.name, f.alias].some((v) => typeof v === "string" && v.toLowerCase().startsWith(q)) || typeof f.userid === "string" && f.userid.toLowerCase().startsWith(q));
+    if (partial.length === 1)
+      return { match: partial[0], candidates: partial };
+    return { match: null, candidates: partial };
+  }
+  var ASSISTANT_PEER = {
+    id: ASSISTANT_ID,
+    userId: ASSISTANT_ID,
+    alias: "Beagle Assistant",
+    address: "",
+    online: true,
+    app: true,
+    pinned: true,
+    agent: false,
+    pending: false,
+    via: null,
+    ping: null,
+    ip: "",
+    unread: 0,
+    lastMsg: "",
+    lastTime: "",
+    lastTs: 0,
+    lastDir: null,
+    acceptedAt: 0,
+    requestedAt: 0,
+    wire: "163",
+    avatarUrl: null,
+    punkId: null
+  };
+  var fmtDate = (ts, lang) => !ts ? lang === "zh" ? "\u4ECE\u672A" : "never" : new Date(ts).toLocaleDateString(lang === "zh" ? "zh-CN" : "en-GB", { year: "numeric", month: "short", day: "numeric" });
+  var fmtAgo = (ts, now, lang) => {
+    if (!ts)
+      return lang === "zh" ? "\u4ECE\u672A" : "never";
+    const days = Math.floor((now - ts) / 864e5);
+    if (days <= 0)
+      return lang === "zh" ? "\u4ECA\u5929" : "today";
+    if (days === 1)
+      return lang === "zh" ? "1 \u5929\u524D" : "1 day ago";
+    return lang === "zh" ? `${days} \u5929\u524D` : `${days} days ago`;
+  };
+  var nameOf = (f) => f.alias || f.name || f.userid;
+  function sinceLine(historySince, lang) {
+    if (!historySince)
+      return lang === "zh" ? "*\u57FA\u4E8E\u672C\u8BBE\u5907\u4E0A\u7684\u6D88\u606F\uFF08\u672C\u673A\u6682\u65E0\u5386\u53F2\u8BB0\u5F55\uFF09*" : "*based on messages on this device (no history here yet)*";
+    return lang === "zh" ? `*\u57FA\u4E8E\u672C\u8BBE\u5907\u81EA ${fmtDate(historySince, lang)} \u8D77\u7684\u6D88\u606F*` : `*based on messages on this device since ${fmtDate(historySince, lang)}*`;
+  }
+  function friendTable(rows, now, lang) {
+    return rows.map((f) => lang === "zh" ? `- **${nameOf(f)}** \u2014 \u6700\u540E\u6536\u5230 ${fmtAgo(f.lastInboundTs, now, lang)} \xB7 \u6536 ${f.inboundCount || 0} / \u53D1 ${f.outboundCount || 0}` : `- **${nameOf(f)}** \u2014 last heard ${fmtAgo(f.lastInboundTs, now, lang)} \xB7 in ${f.inboundCount || 0} / out ${f.outboundCount || 0}`).join("\n");
+  }
+  function helpText(lang) {
+    const intro = lang === "zh" ? "**Beagle \u52A9\u624B** \u2014 \u53EA\u5728\u672C\u673A\u8FD0\u884C\uFF0C\u4E0D\u4F1A\u628A\u4EFB\u4F55\u5185\u5BB9\u53D1\u5230\u7F51\u7EDC\u4E0A\u3002\n\n\u53EF\u7528\u547D\u4EE4\uFF1A" : "**Beagle Assistant** \u2014 runs on this machine only; nothing here is sent over the network.\n\nCommands:";
+    const cmds = actions_default.actions.map((a) => `- \`${a.usage}\` \u2014 ${a.summary}`).join("\n");
+    const filters = actions_default.filters.map((f) => `- \`${f.usage}\` \u2014 ${f.summary}`).join("\n");
+    const tail = lang === "zh" ? `\u7B5B\u9009\u6761\u4EF6\uFF08\u53EF\u7EC4\u5408\uFF0C\u53D6\u5E76\u96C6\uFF09\uFF1A
+${filters}
+
+\u6700\u8FD1 ${RECENT_DAYS} \u5929\u5185\u6DFB\u52A0\u7684\u597D\u53CB\u4E0D\u4F1A\u88AB"\u4ECE\u672A/\u6C89\u9ED8"\u7C7B\u7B5B\u9009\u9009\u4E2D\u3002\u5220\u9664\u6C38\u8FDC\u9700\u8981\u5148\u786E\u8BA4\u3002` : `Filters (combine them; a friend matching any one is listed):
+${filters}
+
+Friends added in the last ${RECENT_DAYS} days are never matched by the "never/silent" filters. Removal always asks first.`;
+    return `${intro}
+${cmds}
+
+${tail}`;
+  }
+  var seq = 0;
+  var asMsg = (from, text, extra) => Object.assign({
+    id: `as-${Date.now()}-${seq++}`,
+    from,
+    time: (/* @__PURE__ */ new Date()).toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" }),
+    text
+  }, extra);
+  function AssistantPanel({ m, T, lang, onRemove }) {
+    const rows = m.assistant.rows || [];
+    const [sel, setSel] = React.useState(() => new Set(rows.map((r) => r.userid)));
+    const [busy, setBusy] = React.useState(false);
+    const [done, setDone] = React.useState(null);
+    if (!rows.length)
+      return null;
+    const toggle = (id) => setSel((s) => {
+      const n = new Set(s);
+      n.has(id) ? n.delete(id) : n.add(id);
+      return n;
+    });
+    const label = lang === "zh" ? `\u5220\u9664 ${sel.size} \u4F4D` : `Remove ${sel.size}`;
+    return /* @__PURE__ */ React.createElement("div", { style: { marginTop: 8, border: "1px solid var(--line)", borderRadius: 10, overflow: "hidden" } }, rows.map((r) => /* @__PURE__ */ React.createElement("label", { key: r.userid, style: {
+      display: "flex",
+      alignItems: "center",
+      gap: 8,
+      padding: "7px 10px",
+      borderBottom: "1px solid var(--line)",
+      fontSize: 13,
+      cursor: done ? "default" : "pointer"
+    } }, /* @__PURE__ */ React.createElement(
+      "input",
+      {
+        type: "checkbox",
+        checked: sel.has(r.userid),
+        disabled: !!done || busy,
+        onChange: () => toggle(r.userid)
+      }
+    ), /* @__PURE__ */ React.createElement("span", { style: { flex: 1 } }, nameOf(r)), /* @__PURE__ */ React.createElement("span", { style: { fontFamily: "var(--mono)", fontSize: 11, color: "var(--faint)" } }, r.userid.slice(0, 8), "\u2026"))), /* @__PURE__ */ React.createElement("div", { style: { display: "flex", alignItems: "center", gap: 10, padding: "8px 10px" } }, done ? /* @__PURE__ */ React.createElement("span", { style: { fontSize: 12.5, color: "var(--faint)" } }, done) : /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement(Btn, { size: "sm", tone: "danger", disabled: busy || !sel.size, onClick: () => {
+      setBusy(true);
+      onRemove([...sel]).then((r) => {
+        setDone(lang === "zh" ? `\u5DF2\u5220\u9664 ${r.removed} \u4F4D${r.failed ? `\uFF0C${r.failed} \u4F4D\u5931\u8D25` : ""}` : `Removed ${r.removed}${r.failed ? `, ${r.failed} failed` : ""}`);
+      }).finally(() => setBusy(false));
+    } }, busy ? T.working || "Working\u2026" : label), /* @__PURE__ */ React.createElement("span", { style: { fontSize: 12, color: "var(--faint)" } }, lang === "zh" ? "\u53D6\u6D88\u52FE\u9009\u53EF\u4FDD\u7559" : "Untick anyone you want to keep"))));
+  }
+  function useAssistant({ lang, T, muted, onToggleMute, sound, flash, setAlert, onReloadFriends }) {
+    const [thread, setThread] = React.useState(() => [{ day: (/* @__PURE__ */ new Date()).toLocaleDateString() }, asMsg("them", helpText(lang))]);
+    const append = React.useCallback((...ms) => setThread((t) => t.concat(ms)), []);
+    React.useEffect(() => {
+      setThread((t) => t.length === 2 ? [t[0], asMsg("them", helpText(lang))] : t);
+    }, [lang]);
+    const fetchFriends = async () => {
+      const r = await fetch("/api/assistant/friends").then((x) => x.json());
+      return { friends: r.friends || [], historySince: r.historySince || null, now: r.now || Date.now(), ver: r.beagleVer || "" };
+    };
+    const listReply = (rows, skipped, data, title) => {
+      if (!rows.length) {
+        return `${title}
+
+${lang === "zh" ? "\u6CA1\u6709\u7B26\u5408\u7684\u597D\u53CB\u3002" : "No friends match."}
+
+${sinceLine(data.historySince, lang)}`;
+      }
+      const skip = skipped.length ? lang === "zh" ? `
+
+*\u8DF3\u8FC7\u4E86 ${skipped.length} \u4F4D\u6700\u8FD1 ${RECENT_DAYS} \u5929\u5185\u6DFB\u52A0\u7684\u597D\u53CB\u3002*` : `
+
+*${skipped.length} friend${skipped.length > 1 ? "s" : ""} added in the last ${RECENT_DAYS} days ${skipped.length > 1 ? "were" : "was"} skipped.*` : "";
+      return `${title}
+
+${friendTable(rows, data.now, lang)}${skip}
+
+${sinceLine(data.historySince, lang)}`;
+    };
+    const ambiguous = (cands) => lang === "zh" ? `\u6709 ${cands.length} \u4F4D\u597D\u53CB\u7B26\u5408\uFF0C\u8BF7\u8BF4\u5F97\u66F4\u5177\u4F53\u4E00\u4E9B\uFF1A
+${cands.map((c) => `- ${nameOf(c)}`).join("\n")}` : `That matches ${cands.length} friends \u2014 be more specific:
+${cands.map((c) => `- ${nameOf(c)}`).join("\n")}`;
+    const notFound = (tok) => lang === "zh" ? `\u6CA1\u6709\u627E\u5230\u597D\u53CB "${tok}"\u3002` : `No friend matches "${tok}".`;
+    const handle = React.useCallback(async (text) => {
+      append(asMsg("me", text, { status: "read" }));
+      const cmd = parseCommand(text);
+      if (!cmd) {
+        return append(asMsg("them", lang === "zh" ? "\u6211\u53EA\u8BA4\u8BC6\u4EE5 `/` \u5F00\u5934\u7684\u547D\u4EE4\u3002\u8F93\u5165 `/help` \u770B\u770B\u80FD\u505A\u4EC0\u4E48\u3002" : "I only understand commands starting with `/`. Type `/help` to see them."));
+      }
+      if (cmd.ok === false) {
+        return append(asMsg("them", lang === "zh" ? "`/friends` \u9700\u8981 `list` \u6216 `remove`\uFF0C\u4F8B\u5982 `/friends list silent 90`\u3002" : "`/friends` needs `list` or `remove`, for example `/friends list silent 90`."));
+      }
+      try {
+        switch (cmd.name) {
+          case "help":
+            return append(asMsg("them", helpText(lang)));
+          case "status": {
+            const d = await fetchFriends();
+            const pending = d.friends.filter((f) => f.pending).length;
+            return append(asMsg("them", lang === "zh" ? `**\u72B6\u6001**
+
+- \u597D\u53CB\uFF1A${d.friends.length}
+- \u5F85\u5BF9\u65B9\u63A5\u53D7\uFF1A${pending}
+- \u672C\u673A\u5386\u53F2\u8D77\u81EA\uFF1A${fmtDate(d.historySince, lang)}
+- \u7248\u672C\uFF1A${d.ver}` : `**Status**
+
+- Friends: ${d.friends.length}
+- Waiting to be accepted: ${pending}
+- History on this device since: ${fmtDate(d.historySince, lang)}
+- Version: ${d.ver}`));
+          }
+          case "friends-list": {
+            const { filters, silentDays, unknown } = parseFilters(cmd.args);
+            if (unknown.length) {
+              return append(asMsg("them", lang === "zh" ? `\u4E0D\u8BA4\u8BC6\u7684\u7B5B\u9009\u6761\u4EF6\uFF1A${unknown.join(", ")}\u3002\u53EF\u7528\uFF1A${actions_default.filters.map((f) => f.name).join(", ")}\u3002` : `I don't know the filter${unknown.length > 1 ? "s" : ""} ${unknown.join(", ")}. Try: ${actions_default.filters.map((f) => f.name).join(", ")}.`));
+            }
+            const d = await fetchFriends();
+            const { matched, skippedRecent } = selectFriends(d.friends, filters, { now: d.now, silentDays });
+            const title = filters.length ? `**${filters.join(" + ")}**${filters.includes("silent") ? ` (${silentDays}d)` : ""} \u2014 ${matched.length}` : lang === "zh" ? `**\u5168\u90E8\u597D\u53CB** \u2014 ${matched.length}` : `**All friends** \u2014 ${matched.length}`;
+            return append(asMsg("them", listReply(matched, skippedRecent, d, title)));
+          }
+          case "friends-remove": {
+            const { filters, silentDays, unknown } = parseFilters(cmd.args);
+            if (unknown.length || !filters.length) {
+              return append(asMsg("them", lang === "zh" ? `\u5220\u9664\u9700\u8981\u7B5B\u9009\u6761\u4EF6\uFF0C\u4F8B\u5982 \`/friends remove never-messaged\`\u3002\u53EF\u7528\uFF1A${actions_default.filters.map((f) => f.name).join(", ")}\u3002` : `Removing needs a filter, for example \`/friends remove never-messaged\`. Available: ${actions_default.filters.map((f) => f.name).join(", ")}.`));
+            }
+            const d = await fetchFriends();
+            const { matched, skippedRecent } = selectFriends(d.friends, filters, { now: d.now, silentDays });
+            const title = lang === "zh" ? `**\u5C06\u8981\u5220\u9664 ${matched.length} \u4F4D\u597D\u53CB** \u2014 \u8BF7\u5148\u6838\u5BF9\u8FD9\u4EFD\u540D\u5355` : `**${matched.length} friend${matched.length === 1 ? "" : "s"} to remove** \u2014 check the list first`;
+            return append(asMsg(
+              "them",
+              listReply(matched, skippedRecent, d, title),
+              matched.length ? { assistant: { kind: "confirm", rows: matched } } : void 0
+            ));
+          }
+          case "find": {
+            const q = cmd.args.join(" ");
+            if (!q)
+              return append(asMsg("them", lang === "zh" ? "\u7528\u6CD5\uFF1A`/find <\u6587\u5B57>`" : "Usage: `/find <text>`"));
+            const d = await fetchFriends();
+            const rows = findFriends(d.friends, q);
+            const title = lang === "zh" ? `**"${q}"** \u2014 ${rows.length} \u4F4D` : `**"${q}"** \u2014 ${rows.length} found`;
+            return append(asMsg("them", listReply(rows, [], d, title)));
+          }
+          case "rename": {
+            const [tok, ...rest] = cmd.args;
+            const alias = rest.join(" ").trim();
+            if (!tok || !alias)
+              return append(asMsg("them", lang === "zh" ? "\u7528\u6CD5\uFF1A`/rename <\u597D\u53CB> <\u65B0\u540D\u5B57>`" : "Usage: `/rename <friend> <new name>`"));
+            const d = await fetchFriends();
+            const { match, candidates } = resolveFriend(d.friends, tok);
+            if (!match)
+              return append(asMsg("them", candidates.length ? ambiguous(candidates) : notFound(tok)));
+            const was = nameOf(match);
+            await dkApi.alias(match.userid, alias);
+            if (onReloadFriends)
+              onReloadFriends();
+            return append(asMsg("them", lang === "zh" ? `\u5DF2\u628A "${was}" \u6539\u540D\u4E3A "${alias}"\u3002` : `Renamed "${was}" to "${alias}".`));
+          }
+          case "mute":
+          case "unmute": {
+            const tok = cmd.args.join(" ").trim();
+            if (!tok)
+              return append(asMsg("them", `${lang === "zh" ? "\u7528\u6CD5" : "Usage"}: \`/${cmd.name} <friend>\``));
+            const d = await fetchFriends();
+            const { match, candidates } = resolveFriend(d.friends, tok);
+            if (!match)
+              return append(asMsg("them", candidates.length ? ambiguous(candidates) : notFound(tok)));
+            const isMuted = (muted || []).includes(match.userid);
+            const want = cmd.name === "mute";
+            if (isMuted !== want)
+              onToggleMute(match.userid);
+            return append(asMsg("them", want ? lang === "zh" ? `\u5DF2\u9759\u97F3 "${nameOf(match)}"\u3002` : `Muted "${nameOf(match)}".` : lang === "zh" ? `\u5DF2\u53D6\u6D88\u9759\u97F3 "${nameOf(match)}"\u3002` : `Unmuted "${nameOf(match)}".`));
+          }
+          case "sound":
+          case "flash": {
+            const word = (cmd.args[0] || "").toLowerCase();
+            if (word !== "on" && word !== "off") {
+              return append(asMsg("them", `${lang === "zh" ? "\u7528\u6CD5" : "Usage"}: \`/${cmd.name} on|off\``));
+            }
+            const on = word === "on";
+            setAlert(cmd.name, on);
+            const what = cmd.name === "sound" ? lang === "zh" ? "\u63D0\u793A\u97F3" : "Sound" : lang === "zh" ? "\u7A97\u53E3\u95EA\u70C1" : "Window flash";
+            return append(asMsg("them", lang === "zh" ? `${what}\u5DF2${on ? "\u5F00\u542F" : "\u5173\u95ED"}\u3002` : `${what} ${on ? "on" : "off"}.`));
+          }
+          default:
+            return append(asMsg("them", lang === "zh" ? `\u4E0D\u8BA4\u8BC6\u7684\u547D\u4EE4 \`/${cmd.name}\`\u3002\u8F93\u5165 \`/help\` \u770B\u770B\u53EF\u7528\u547D\u4EE4\u3002` : `I don't know \`/${cmd.name}\`. Type \`/help\` for the list.`));
+        }
+      } catch (e) {
+        return append(asMsg("them", lang === "zh" ? `\u51FA\u9519\u4E86\uFF1A${e && e.message || e}` : `That failed: ${e && e.message || e}`));
+      }
+    }, [append, lang, muted, onToggleMute, setAlert, onReloadFriends]);
+    const removeFriends = React.useCallback(async (ids) => {
+      let removed = 0;
+      const failed = [];
+      for (const id of ids) {
+        try {
+          const r = await dkApi.remove(id);
+          if (r && r.ok === false)
+            failed.push(id);
+          else
+            removed++;
+        } catch (e) {
+          failed.push(id);
+        }
+      }
+      if (onReloadFriends)
+        onReloadFriends();
+      append(asMsg("them", failed.length ? lang === "zh" ? `\u5DF2\u5220\u9664 ${removed} \u4F4D\uFF0C${failed.length} \u4F4D\u5931\u8D25\u3002` : `Removed ${removed}, ${failed.length} failed.` : lang === "zh" ? `\u5DF2\u5220\u9664 ${removed} \u4F4D\u597D\u53CB\u3002` : `Removed ${removed} friend${removed === 1 ? "" : "s"}.`));
+      return { removed, failed: failed.length };
+    }, [append, lang, onReloadFriends]);
+    return { thread, handle, removeFriends };
+  }
   function RequestsBlock({ T, requests, onAct }) {
     const [acted, setActed] = React.useState({});
     const [failed, setFailed] = React.useState({});
@@ -581,7 +1133,7 @@ window.__DK_UI_VERSION="0.1.105";
       whiteSpace: "nowrap",
       overflow: "hidden",
       textOverflow: "ellipsis"
-    } }, peer.alias || shortKey(peer.userId, 8, 5)), peer.agent && /* @__PURE__ */ React.createElement(Icon, { name: "bot", size: 13, color: "var(--faint)", stroke: 2 }), muted && /* @__PURE__ */ React.createElement(Icon, { name: "bellOff", size: 12, color: "var(--faint)", stroke: 2, title: T && T.mutedTag || "sound muted" }), peer.wire === "64" && /* @__PURE__ */ React.createElement(Tag, { tone: "off", style: { height: 15, fontSize: 9.5, padding: "0 4px" } }, "w64")), /* @__PURE__ */ React.createElement("div", { style: { display: "flex", alignItems: "center", gap: 6, marginTop: 2 } }, peer.ip ? /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement("span", { style: { fontFamily: "var(--mono)", fontSize: 11, color: "var(--faint)" } }, peer.ip), /* @__PURE__ */ React.createElement("span", { style: { color: "var(--line)", fontSize: 11 } }, "\xB7")) : null, /* @__PURE__ */ React.createElement("span", { style: {
+    } }, peer.alias || shortKey(peer.userId, 8, 5)), peer.agent && /* @__PURE__ */ React.createElement(Icon, { name: "bot", size: 13, color: "var(--faint)", stroke: 2 }), peer.app && /* @__PURE__ */ React.createElement(Tag, { tone: "accent", style: { height: 15, fontSize: 9.5, padding: "0 4px" } }, "APP"), muted && /* @__PURE__ */ React.createElement(Icon, { name: "bellOff", size: 12, color: "var(--faint)", stroke: 2, title: T && T.mutedTag || "sound muted" }), peer.wire === "64" && /* @__PURE__ */ React.createElement(Tag, { tone: "off", style: { height: 15, fontSize: 9.5, padding: "0 4px" } }, "w64")), /* @__PURE__ */ React.createElement("div", { style: { display: "flex", alignItems: "center", gap: 6, marginTop: 2 } }, peer.ip ? /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement("span", { style: { fontFamily: "var(--mono)", fontSize: 11, color: "var(--faint)" } }, peer.ip), /* @__PURE__ */ React.createElement("span", { style: { color: "var(--line)", fontSize: 11 } }, "\xB7")) : null, /* @__PURE__ */ React.createElement("span", { style: {
       fontSize: 11,
       color: "var(--dim)",
       whiteSpace: "nowrap",
@@ -637,6 +1189,8 @@ window.__DK_UI_VERSION="0.1.105";
       const s = (p.alias || "") + " " + p.userId + " " + p.ip;
       return s.toLowerCase().includes(q.toLowerCase());
     }).slice().sort((a, b) => {
+      if (!!a.pinned !== !!b.pinned)
+        return a.pinned ? -1 : 1;
       const ta = dkActivityTs(a), tb = dkActivityTs(b);
       if (ta !== tb)
         return tb - ta;
@@ -1302,7 +1856,7 @@ window.__DK_UI_VERSION="0.1.105";
       return null;
     }), err && /* @__PURE__ */ React.createElement("div", { style: { color: "var(--danger, #ff6b6b)", fontSize: 11.5, fontFamily: "var(--mono)" } }, err));
   }
-  function Msg({ m, peer, T, onTheater, onDelete, onCancel, onRetry, onRetryMsg, onReveal, onOpenFile, onCall, onFormSubmit, onNameCard, answered, selMode, selected, onToggleSel, busy, isGroup }) {
+  function Msg({ m, peer, T, lang, onTheater, onDelete, onCancel, onRetry, onRetryMsg, onReveal, onOpenFile, onCall, onFormSubmit, onNameCard, onAssistantRemove, answered, selMode, selected, onToggleSel, busy, isGroup }) {
     const mine = m.from === "me";
     const nativeMedia = !m.file ? dkNativeMediaFromText(m.text) : null;
     const grp = isGroup && m.dir !== "out" && !m.file && !nativeMedia ? dkGroupParse(m.text) : null;
@@ -1631,7 +2185,7 @@ window.__DK_UI_VERSION="0.1.105";
           letterSpacing: -0.1,
           wordBreak: "break-word"
         } }, /* @__PURE__ */ React.createElement(MarkdownText, { text: read.text, onNameCard })));
-      })(), read.form && /* @__PURE__ */ React.createElement("div", { style: { marginTop: 6 } }, /* @__PURE__ */ React.createElement(DkChatForm, { form: read.form, submitted, peer, onSubmit: onFormSubmit })), /* @__PURE__ */ React.createElement("div", { style: { display: "flex", alignItems: "center", gap: 4, margin: "3px 3px 0" } }, /* @__PURE__ */ React.createElement("span", { style: { fontFamily: "var(--mono)", fontSize: 10, color: "var(--faint)" } }, m.time), (() => {
+      })(), read.form && /* @__PURE__ */ React.createElement("div", { style: { marginTop: 6 } }, /* @__PURE__ */ React.createElement(DkChatForm, { form: read.form, submitted, peer, onSubmit: onFormSubmit })), m.assistant && onAssistantRemove && /* @__PURE__ */ React.createElement(AssistantPanel, { m, T, lang, onRemove: onAssistantRemove }), /* @__PURE__ */ React.createElement("div", { style: { display: "flex", alignItems: "center", gap: 4, margin: "3px 3px 0" } }, /* @__PURE__ */ React.createElement("span", { style: { fontFamily: "var(--mono)", fontSize: 10, color: "var(--faint)" } }, m.time), (() => {
         const sentDone = mine && m.status && m.status !== "queued" && m.status !== "sending" && m.status !== "failed";
         const via = !mine ? m.via : sentDone ? m.via === "offline" ? "offline" : "online" : null;
         if (!via)
@@ -1676,7 +2230,7 @@ window.__DK_UI_VERSION="0.1.105";
       ) : mine && m.via === "offline" && m.status !== "queued" && m.status !== "sending" ? /* @__PURE__ */ React.createElement(Icon, { name: "check", size: 12, stroke: 2.2, color: "#f59e0b", title: T.viaOutOffline || "posted to the offline relay \u2014 they get it when they come online" }) : mine && m.status === "sent" && m.confirmed === false ? /* @__PURE__ */ React.createElement(Icon, { name: "check", size: 12, stroke: 2.2, color: "var(--faint)", title: T.sentUnconfirmed || "sent \u2014 not confirmed by the peer" }) : mine && m.status && /* @__PURE__ */ React.createElement(Icon, { name: "checkCheck", size: 12, stroke: 2.2, color: m.status === "read" ? "var(--accent)" : "var(--faint)" })))
     );
   }
-  function Conversation({ T, peer, lang, peers, onOpenChat, thread: threadProp, onSend, onSendFile, onSendRtcFile, onAlias, onRemove, onOpenNet, onCall, onReloadThread, hasEarlier, onLoadEarlier, muted, onToggleMute, phone, onBack }) {
+  function Conversation({ T, peer, lang, peers, onOpenChat, thread: threadProp, onSend, onSendFile, onSendRtcFile, onAlias, onRemove, onOpenNet, onCall, onReloadThread, hasEarlier, onLoadEarlier, onAssistantRemove, muted, onToggleMute, phone, onBack }) {
     const scrollRef = React.useRef(null);
     const prependRef = React.useRef(null);
     const [earlierBusy, setEarlierBusy] = React.useState(false);
@@ -1981,7 +2535,11 @@ window.__DK_UI_VERSION="0.1.105";
           style: { width: 40, height: 44, flexShrink: 0, border: "none", background: "transparent", cursor: "pointer", display: "flex", alignItems: "center", justifyContent: "center", padding: 0 }
         },
         /* @__PURE__ */ React.createElement(Icon, { name: "chevronLeft", size: 26, stroke: 2.2, color: "var(--accent)" })
-      ), /* @__PURE__ */ React.createElement("div", { onClick: () => setPubProfile(true), title: T && T.pubOpen || "View public profile", style: { cursor: "pointer", flexShrink: 0 } }, /* @__PURE__ */ React.createElement(DkAvatar, { peer, size: 34, radius: 8 })), /* @__PURE__ */ React.createElement("div", { style: { minWidth: 0, flex: phone ? 1 : void 0 } }, /* @__PURE__ */ React.createElement("div", { style: { display: "flex", alignItems: "center", gap: 8, minWidth: 0 } }, /* @__PURE__ */ React.createElement("span", { onClick: () => setPubProfile(true), style: { fontFamily: peer.alias ? "var(--ui)" : "var(--mono)", fontSize: 15, fontWeight: 700, color: "var(--text)", cursor: "pointer", whiteSpace: "nowrap", overflow: "hidden", textOverflow: "ellipsis", minWidth: 0 } }, peer.alias || shortKey(peer.userId, phone ? 6 : 10, phone ? 4 : 6)), peer.agent && !phone && /* @__PURE__ */ React.createElement(Tag, { tone: "accent" }, "agent"), isGroup && !phone && /* @__PURE__ */ React.createElement(Tag, null, T && T.groupTag || "group"), !phone && /* @__PURE__ */ React.createElement(RouteTag, { peer })), phone ? /* @__PURE__ */ React.createElement("div", { style: { marginTop: 2, display: "flex" } }, /* @__PURE__ */ React.createElement(RouteTag, { peer })) : /* @__PURE__ */ React.createElement("div", { style: { display: "flex", alignItems: "center", gap: 8, marginTop: 2 } }, /* @__PURE__ */ React.createElement(Mono, { size: 11.5, dim: true, copy: peer.userId, title: peer.userId }, shortKey(peer.userId, 10, 6)), /* @__PURE__ */ React.createElement("span", { style: { color: "var(--line)" } }, "\xB7"), /* @__PURE__ */ React.createElement("button", { onClick: () => onOpenNet(peer), title: T && T.openNet || "Network view", style: { background: "none", border: "none", cursor: "pointer", padding: 0, color: "var(--accent)", display: "inline-flex", alignItems: "center" } }, /* @__PURE__ */ React.createElement(Icon, { name: "network", size: 12, stroke: 2 })), /* @__PURE__ */ React.createElement(Mono, { size: 11.5, dim: true, copy: peer.ip, title: peer.ip }, peer.ip), peer.address && /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement("span", { style: { color: "var(--line)" } }, "\xB7"), /* @__PURE__ */ React.createElement(
+      ), /* @__PURE__ */ React.createElement("div", { onClick: () => setPubProfile(true), title: T && T.pubOpen || "View public profile", style: { cursor: "pointer", flexShrink: 0 } }, /* @__PURE__ */ React.createElement(DkAvatar, { peer, size: 34, radius: 8 })), /* @__PURE__ */ React.createElement("div", { style: { minWidth: 0, flex: phone ? 1 : void 0 } }, /* @__PURE__ */ React.createElement("div", { style: { display: "flex", alignItems: "center", gap: 8, minWidth: 0 } }, /* @__PURE__ */ React.createElement("span", { onClick: () => setPubProfile(true), style: { fontFamily: peer.alias ? "var(--ui)" : "var(--mono)", fontSize: 15, fontWeight: 700, color: "var(--text)", cursor: "pointer", whiteSpace: "nowrap", overflow: "hidden", textOverflow: "ellipsis", minWidth: 0 } }, peer.alias || shortKey(peer.userId, phone ? 6 : 10, phone ? 4 : 6)), peer.app && !phone && /* @__PURE__ */ React.createElement(Tag, { tone: "accent" }, "APP"), peer.agent && !phone && /* @__PURE__ */ React.createElement(Tag, { tone: "accent" }, "agent"), isGroup && !phone && /* @__PURE__ */ React.createElement(Tag, null, T && T.groupTag || "group"), !phone && !peer.app && /* @__PURE__ */ React.createElement(RouteTag, { peer })), peer.app ? (
+        // The internal id is not an address anyone can use and not a name
+        // anyone chose; saying what this row IS is more use than showing it.
+        /* @__PURE__ */ React.createElement("div", { style: { marginTop: 2, fontFamily: "var(--mono)", fontSize: 11.5, color: "var(--faint)" } }, T && T.assistantSub || "Local \xB7 APP")
+      ) : phone ? /* @__PURE__ */ React.createElement("div", { style: { marginTop: 2, display: "flex" } }, /* @__PURE__ */ React.createElement(RouteTag, { peer })) : /* @__PURE__ */ React.createElement("div", { style: { display: "flex", alignItems: "center", gap: 8, marginTop: 2 } }, /* @__PURE__ */ React.createElement(Mono, { size: 11.5, dim: true, copy: peer.userId, title: peer.userId }, shortKey(peer.userId, 10, 6)), /* @__PURE__ */ React.createElement("span", { style: { color: "var(--line)" } }, "\xB7"), /* @__PURE__ */ React.createElement("button", { onClick: () => onOpenNet(peer), title: T && T.openNet || "Network view", style: { background: "none", border: "none", cursor: "pointer", padding: 0, color: "var(--accent)", display: "inline-flex", alignItems: "center" } }, /* @__PURE__ */ React.createElement(Icon, { name: "network", size: 12, stroke: 2 })), /* @__PURE__ */ React.createElement(Mono, { size: 11.5, dim: true, copy: peer.ip, title: peer.ip }, peer.ip), peer.address && /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement("span", { style: { color: "var(--line)" } }, "\xB7"), /* @__PURE__ */ React.createElement(
         Mono,
         {
           size: 11.5,
@@ -1999,7 +2557,7 @@ ${peer.address}`
           title: muted ? T && T.unmuteSound || "Turn sound back on for this chat" : T && T.muteSound || "Mute sound for this chat",
           onClick: () => onToggleMute(peer.id)
         }
-      ), onCall && /* @__PURE__ */ React.createElement(Btn, { icon: "phone", title: T && T.audioCall || "Audio call", onClick: () => onCall(peer.userId, false) }), onCall && /* @__PURE__ */ React.createElement(Btn, { icon: "video", title: T && T.videoCall || "Video call", onClick: () => onCall(peer.userId, true) }), onSendRtcFile && /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement(
+      ), onCall && !peer.app && /* @__PURE__ */ React.createElement(Btn, { icon: "phone", title: T && T.audioCall || "Audio call", onClick: () => onCall(peer.userId, false) }), onCall && !peer.app && /* @__PURE__ */ React.createElement(Btn, { icon: "video", title: T && T.videoCall || "Video call", onClick: () => onCall(peer.userId, true) }), onSendRtcFile && !peer.app && /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement(
         "input",
         {
           ref: rtcFileRef,
@@ -2013,19 +2571,19 @@ ${peer.address}`
       ), !phone && /* @__PURE__ */ React.createElement(Btn, { icon: "file", title: T && T.sendWebrtcFile || "Send file via WebRTC", onClick: () => rtcFileRef.current && rtcFileRef.current.click() })), /* @__PURE__ */ React.createElement("div", { style: { position: "relative" } }, /* @__PURE__ */ React.createElement(Btn, { icon: "more", onClick: () => setMenu((v) => !v) }), menu && /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement("div", { onClick: () => setMenu(false), style: { position: "fixed", inset: 0, zIndex: 40 } }), /* @__PURE__ */ React.createElement("div", { style: { position: "absolute", right: 0, top: 36, zIndex: 50, width: 180, background: "var(--panel-2)", border: "1px solid var(--line)", borderRadius: 9, padding: 6, boxShadow: "0 14px 40px rgba(0,0,0,0.4)" } }, phone && onToggleMute && /* @__PURE__ */ React.createElement(MenuItem, { icon: muted ? "bell" : "bellOff", label: muted ? T && T.unmuteSound || "Turn sound back on" : T && T.muteSound || "Mute sound", onClick: () => {
         setMenu(false);
         onToggleMute(peer.id);
-      } }), phone && onSendRtcFile && /* @__PURE__ */ React.createElement(MenuItem, { icon: "file", label: T && T.sendWebrtcFile || "Send file via WebRTC", onClick: () => {
+      } }), phone && onSendRtcFile && !peer.app && /* @__PURE__ */ React.createElement(MenuItem, { icon: "file", label: T && T.sendWebrtcFile || "Send file via WebRTC", onClick: () => {
         setMenu(false);
         rtcFileRef.current && rtcFileRef.current.click();
-      } }), phone && /* @__PURE__ */ React.createElement(MenuItem, { icon: "network", label: T && T.openNet || "Network view", onClick: () => {
+      } }), phone && !peer.app && /* @__PURE__ */ React.createElement(MenuItem, { icon: "network", label: T && T.openNet || "Network view", onClick: () => {
         setMenu(false);
         onOpenNet(peer);
-      } }), /* @__PURE__ */ React.createElement(MenuItem, { icon: "hash", label: T.alias, onClick: () => {
+      } }), !peer.app && /* @__PURE__ */ React.createElement(MenuItem, { icon: "hash", label: T.alias, onClick: () => {
         setMenu(false);
         onAlias(peer);
       } }), /* @__PURE__ */ React.createElement(MenuItem, { icon: "check", label: T.selectDelete || "Select & delete", onClick: () => {
         setMenu(false);
         setSelMode(true);
-      } }), /* @__PURE__ */ React.createElement("div", { style: { height: 1, background: "var(--line)", margin: "5px 4px" } }), /* @__PURE__ */ React.createElement(MenuItem, { icon: "trash", label: T.remove, danger: true, onClick: () => {
+      } }), !peer.app && /* @__PURE__ */ React.createElement("div", { style: { height: 1, background: "var(--line)", margin: "5px 4px" } }), !peer.app && /* @__PURE__ */ React.createElement(MenuItem, { icon: "trash", label: T.remove, danger: true, onClick: () => {
         setMenu(false);
         onRemove(peer);
       } }))))),
@@ -2047,8 +2605,10 @@ ${peer.address}`
           m,
           peer,
           T,
+          lang,
           isGroup,
           onTheater: setTheater,
+          onAssistantRemove,
           onDelete: (id) => doDelete([id]),
           onCancel: doCancel,
           onRetry: doRetry,
@@ -2097,7 +2657,7 @@ ${peer.address}`
             e.target.value = "";
           }
         }
-      ), /* @__PURE__ */ React.createElement(Btn, { icon: "paperclip", title: T.sendFile, onClick: () => fileRef.current && fileRef.current.click() }), /* @__PURE__ */ React.createElement(
+      ), !peer.app && /* @__PURE__ */ React.createElement(Btn, { icon: "paperclip", title: T.sendFile, onClick: () => fileRef.current && fileRef.current.click() }), /* @__PURE__ */ React.createElement(
         "input",
         {
           value: draft,
@@ -2200,12 +2760,12 @@ ${peer.address}`
   function ChatEmpty({ T }) {
     return /* @__PURE__ */ React.createElement("div", { style: { flex: 1, display: "flex", flexDirection: "column", alignItems: "center", justifyContent: "center", gap: 12, color: "var(--faint)", background: "var(--bg)" } }, /* @__PURE__ */ React.createElement(Icon, { name: "message", size: 40, stroke: 1.4, color: "var(--line)" }), /* @__PURE__ */ React.createElement("div", { style: { fontFamily: "var(--mono)", fontSize: 13 } }, T.pickPeer));
   }
-  function ChatTab({ T, lang, peers, requests, activeId, thread, onSelect, onAct, onAdd, onSend, onSendFile, onSendRtcFile, onAlias, onRemove, onOpenNet, onCall, onReloadThread, hasEarlier, onLoadEarlier, prefillAddr, onPrefillConsumed, muted, onToggleMute, phone, onBack }) {
+  function ChatTab({ T, lang, peers, requests, activeId, thread, onSelect, onAct, onAdd, onSend, onSendFile, onSendRtcFile, onAlias, onRemove, onOpenNet, onCall, onReloadThread, hasEarlier, onLoadEarlier, onAssistantRemove, prefillAddr, onPrefillConsumed, muted, onToggleMute, phone, onBack }) {
     const peer = peers.find((p) => p.id === activeId);
     if (phone) {
-      return peer ? /* @__PURE__ */ React.createElement(Conversation, { T, peer, lang, peers, onOpenChat: onSelect, thread, onSend, onSendFile, onSendRtcFile, onAlias, onRemove, onOpenNet, onCall, onReloadThread, hasEarlier, onLoadEarlier, muted: !!muted && muted.includes(peer.id), onToggleMute, phone: true, onBack }) : /* @__PURE__ */ React.createElement(PeerSidebar, { T, peers, requests, activeId, onSelect, onAct, onAdd, prefillAddr, onPrefillConsumed, muted, wide: true });
+      return peer ? /* @__PURE__ */ React.createElement(Conversation, { T, peer, lang, peers, onOpenChat: onSelect, thread, onSend, onSendFile, onSendRtcFile, onAlias, onRemove, onOpenNet, onCall, onReloadThread, hasEarlier, onLoadEarlier, onAssistantRemove, muted: !!muted && muted.includes(peer.id), onToggleMute, phone: true, onBack }) : /* @__PURE__ */ React.createElement(PeerSidebar, { T, peers, requests, activeId, onSelect, onAct, onAdd, prefillAddr, onPrefillConsumed, muted, wide: true });
     }
-    return /* @__PURE__ */ React.createElement("div", { style: { flex: 1, display: "flex", minWidth: 0, minHeight: 0 } }, /* @__PURE__ */ React.createElement(PeerSidebar, { T, peers, requests, activeId, onSelect, onAct, onAdd, prefillAddr, onPrefillConsumed, muted }), peer ? /* @__PURE__ */ React.createElement(Conversation, { T, peer, lang, peers, onOpenChat: onSelect, thread, onSend, onSendFile, onSendRtcFile, onAlias, onRemove, onOpenNet, onCall, onReloadThread, hasEarlier, onLoadEarlier, muted: !!muted && muted.includes(peer.id), onToggleMute }) : /* @__PURE__ */ React.createElement(ChatEmpty, { T }));
+    return /* @__PURE__ */ React.createElement("div", { style: { flex: 1, display: "flex", minWidth: 0, minHeight: 0 } }, /* @__PURE__ */ React.createElement(PeerSidebar, { T, peers, requests, activeId, onSelect, onAct, onAdd, prefillAddr, onPrefillConsumed, muted }), peer ? /* @__PURE__ */ React.createElement(Conversation, { T, peer, lang, peers, onOpenChat: onSelect, thread, onSend, onSendFile, onSendRtcFile, onAlias, onRemove, onOpenNet, onCall, onReloadThread, hasEarlier, onLoadEarlier, onAssistantRemove, muted: !!muted && muted.includes(peer.id), onToggleMute }) : /* @__PURE__ */ React.createElement(ChatEmpty, { T }));
   }
   Object.assign(window, { ChatTab });
   function CopyBtn({ value, copiedText = "Copied", copyFailedText = "Copy failed", copyTitle = "Copy" }) {
@@ -4968,6 +5528,7 @@ ${peer.address}`
       autoAcceptLabel: "Auto-accept friend requests",
       autoAcceptSub: "Off: requests wait in the sidebar for your approval.",
       groupSenderUnknown: "The group relays only this display name. Register Beagle as a group agent (/agent add <beagle address> in the group) to receive full member identities you can add as friends.",
+      assistantSub: "Local \xB7 APP",
       loadEarlier: "Load earlier messages",
       loadingEarlier: "Loading\u2026",
       pendingFriend: "Waiting for them to accept your friend request \u2014 messages will queue and deliver once they do.",
@@ -5162,6 +5723,7 @@ ${peer.address}`
       autoAcceptLabel: "\u81EA\u52A8\u63A5\u53D7\u597D\u53CB\u8BF7\u6C42",
       autoAcceptSub: "\u5173\u95ED\u540E\uFF0C\u597D\u53CB\u8BF7\u6C42\u4F1A\u7B49\u5F85\u4F60\u5728\u4FA7\u8FB9\u680F\u624B\u52A8\u786E\u8BA4\u3002",
       groupSenderUnknown: "\u7FA4\u670D\u52A1\u53EA\u8F6C\u53D1\u4E86\u663E\u793A\u540D\uFF0C\u62FF\u4E0D\u5230\u8BE5\u6210\u5458\u7684\u5B8C\u6574\u8EAB\u4EFD\u3002\u5728\u7FA4\u91CC\u6267\u884C /agent add <beagle \u5730\u5740> \u628A Beagle \u6CE8\u518C\u4E3A\u7FA4 agent \u540E\uFF0C\u5373\u53EF\u6536\u5230\u5B8C\u6574\u8EAB\u4EFD\u5E76\u4E00\u952E\u52A0\u597D\u53CB\u3002",
+      assistantSub: "\u672C\u673A \xB7 APP",
       loadEarlier: "\u52A0\u8F7D\u66F4\u65E9\u7684\u6D88\u606F",
       loadingEarlier: "\u52A0\u8F7D\u4E2D\u2026",
       pendingFriend: "\u7B49\u5F85\u5BF9\u65B9\u63A5\u53D7\u597D\u53CB\u8BF7\u6C42 \u2014 \u6D88\u606F\u4F1A\u5148\u6392\u961F\uFF0C\u5BF9\u65B9\u63A5\u53D7\u540E\u81EA\u52A8\u9001\u8FBE\u3002",
@@ -5508,7 +6070,7 @@ ${peer.address}`
       sessionStorage.setItem(key, "1");
       window.location.reload();
     }, [me && me.beagleVer]);
-    const peers = data.peers;
+    const peers = React.useMemo(() => [ASSISTANT_PEER].concat(data.peers || []), [data.peers]);
     const [pendingAddr, setPendingAddr] = React.useState(() => dkParseDeepLinkAddress());
     React.useEffect(() => {
       const onHash = () => {
@@ -5572,6 +6134,16 @@ ${peer.address}`
       flash: t.alertFlash !== false,
       muted: mutedIds
     });
+    const assistant = useAssistant({
+      lang: t.lang,
+      T,
+      muted: mutedIds,
+      onToggleMute,
+      sound: t.alertSound !== false,
+      flash: t.alertFlash !== false,
+      setAlert: (which, on) => setTweak(which === "sound" ? "alertSound" : "alertFlash", on),
+      onReloadFriends: () => data.refresh()
+    });
     const callCtl = useCallController(me.userId, (peerId, video, direction) => {
       const text = `WebRTC ${video ? "video" : "audio"} call: ${direction}`;
       dkApi.logLocal(peerId, direction === "outgoing" ? "out" : "in", text).then(() => {
@@ -5634,6 +6206,8 @@ ${peer.address}`
     React.useEffect(() => {
       if (!activeId)
         return;
+      if (activeId === ASSISTANT_ID)
+        return;
       data.loadThread(activeId, { reset: true });
       dkApi.markRead(activeId).then(data.refresh);
       const iv = setInterval(() => {
@@ -5677,6 +6251,10 @@ ${peer.address}`
     const onSend = (text) => {
       if (!activeId || !text || !text.trim())
         return;
+      if (activeId === ASSISTANT_ID) {
+        assistant.handle(text.trim());
+        return;
+      }
       dkApi.send(activeId, text.trim()).then(() => data.loadThread(activeId)).then(data.refresh);
     };
     const peerTakesRtcFile = (id) => {
@@ -5784,7 +6362,7 @@ ${peer.address}`
       fontWeight: 600,
       background: tab === n.id ? "var(--accent)" : "transparent",
       color: tab === n.id ? "#fff" : "var(--dim)"
-    } }, /* @__PURE__ */ React.createElement(Icon, { name: n.icon, size: 14, stroke: 2, color: tab === n.id ? "#fff" : "var(--dim)" }), n.label))), tab === "chat" && /* @__PURE__ */ React.createElement(ChatTab, { T, lang: t.lang, phone, onBack: closeConversation, peers, requests, activeId, thread: data.threads[activeId], onSelect, onAct, onAdd, onSend, onSendFile, onSendRtcFile, onAlias, onRemove, onOpenNet, onCall, onReloadThread: () => activeId && data.loadThread(activeId), hasEarlier: !!(activeId && data.earlier[activeId]), onLoadEarlier: () => activeId && data.loadEarlier(activeId), prefillAddr: pendingAddr, onPrefillConsumed: () => setPendingAddr(""), muted: mutedIds, onToggleMute }), tab === "here" && /* @__PURE__ */ React.createElement(DiscoverTab, { T, kind: "bridge", peers, meId: me.userId, onAdd, onOpenChat }), tab === "recommended" && /* @__PURE__ */ React.createElement(DiscoverTab, { T, kind: "recommended", peers, meId: me.userId, onAdd, onOpenChat }), tab === "registered" && /* @__PURE__ */ React.createElement(DiscoverTab, { T, kind: "registered", peers, meId: me.userId, onAdd, onOpenChat }), tab === "network" && /* @__PURE__ */ React.createElement(NetworkTab, { T, me, peers, exits, activeExit, reqCount: requests.length, onSetExit, onOpenChat, backend, onArmLan: armLan, onCancelLan: cancelLan }), tab === "apps" && /* @__PURE__ */ React.createElement(AppsTab, { T, t }), tab === "profile" && /* @__PURE__ */ React.createElement(ProfileTab, { T, me, onEdit, t, setTweak, onSetAvatar: (p) => dkApi.setProfileFull(p).then((r) => {
+    } }, /* @__PURE__ */ React.createElement(Icon, { name: n.icon, size: 14, stroke: 2, color: tab === n.id ? "#fff" : "var(--dim)" }), n.label))), tab === "chat" && /* @__PURE__ */ React.createElement(ChatTab, { T, lang: t.lang, phone, onBack: closeConversation, peers, requests, activeId, thread: activeId === ASSISTANT_ID ? assistant.thread : data.threads[activeId], onSelect, onAct, onAdd, onSend, onSendFile, onSendRtcFile, onAlias, onRemove, onOpenNet, onCall, onReloadThread: () => activeId && data.loadThread(activeId), hasEarlier: !!(activeId && activeId !== ASSISTANT_ID && data.earlier[activeId]), onAssistantRemove: activeId === ASSISTANT_ID ? assistant.removeFriends : null, onLoadEarlier: () => activeId && data.loadEarlier(activeId), prefillAddr: pendingAddr, onPrefillConsumed: () => setPendingAddr(""), muted: mutedIds, onToggleMute }), tab === "here" && /* @__PURE__ */ React.createElement(DiscoverTab, { T, kind: "bridge", peers, meId: me.userId, onAdd, onOpenChat }), tab === "recommended" && /* @__PURE__ */ React.createElement(DiscoverTab, { T, kind: "recommended", peers, meId: me.userId, onAdd, onOpenChat }), tab === "registered" && /* @__PURE__ */ React.createElement(DiscoverTab, { T, kind: "registered", peers, meId: me.userId, onAdd, onOpenChat }), tab === "network" && /* @__PURE__ */ React.createElement(NetworkTab, { T, me, peers, exits, activeExit, reqCount: requests.length, onSetExit, onOpenChat, backend, onArmLan: armLan, onCancelLan: cancelLan }), tab === "apps" && /* @__PURE__ */ React.createElement(AppsTab, { T, t }), tab === "profile" && /* @__PURE__ */ React.createElement(ProfileTab, { T, me, onEdit, t, setTweak, onSetAvatar: (p) => dkApi.setProfileFull(p).then((r) => {
       data.refresh();
       return r;
     }) })), phone && !inConversation && /* @__PURE__ */ React.createElement("div", { style: { flexShrink: 0, display: "flex", borderTop: "1px solid var(--line)", background: "var(--rail)", paddingBottom: "env(safe-area-inset-bottom, 0px)" } }, phoneNav.map((n) => /* @__PURE__ */ React.createElement(TabBarBtn, { key: n.id, icon: n.icon, label: n.label, active: n.active, badge: n.badge, onClick: n.go }))), data.locked && /* @__PURE__ */ React.createElement(

package/dist/message-store.js

@@ -162,6 +162,12 @@ export class MessageStore {
             arr = [];
             this.byPeer.set(peer, arr);
         }
+        // ts is the paging cursor (`before` is strict), so it must be unique per
+        // thread: a burst in one millisecond would otherwise be split by a page
+        // boundary and the rest of it skipped. Order is kept; the id is not touched.
+        const newest = arr.length ? arr[arr.length - 1].ts : -Infinity;
+        if (msg.ts <= newest)
+            msg.ts = newest + 1;
         arr.push(msg);
         if (arr.length > MAX_PER_PEER)
             arr.splice(0, arr.length - MAX_PER_PEER);

package/dist/server.d.ts

@@ -24,6 +24,10 @@ export interface BeagleServerOptions {
     /** Directory where the daemon saves received files (<configDir>/downloads).
      *  Used to serve GET /api/file-download. Undefined disables downloads. */
     downloadsDir?: string;
+    /** <configDir>/messages.json — the chat store BOTH backends write. Read
+     *  (never written) by GET /api/assistant/friends to count a friend's
+     *  history without hauling it over IPC. Undefined = no counts. */
+    messagesPath?: string;
     /** The swappable backend, so the UI can show which one is live and drive the
      *  LAN handoff. Optional: a caller that pins one backend just omits it and
      *  the network panel falls back to "no virtual LAN here". */

package/dist/server.js

@@ -24,6 +24,7 @@ import { DEFAULT_EXITS } from "./exits.js";
 import * as peerAddr from "@decentnetwork/peer";
 import { bridgeRoster } from "./bridge-roster.js";
 import { isSupervised } from "./relaunch.js";
+import { historyStats } from "./assistant-stats.js";
 // Directory holding the built desktop UI bundle (index.html, app.js, vendor/).
 // scripts/build-ui.mjs emits it next to this compiled module at dist/ui/desktop/.
 const DESKTOP_DIR = join(dirname(fileURLToPath(import.meta.url)), "desktop");
@@ -2237,6 +2238,58 @@ export function startBeagleServer(opts) {
                 sendJson(res, 200, { me, peers, requests, exits, activeExit });
                 return;
             }
+            // Everything the Assistant's friend filters need, in one answer: the
+            // friend list plus how much was said to each friend and when. The
+            // counts come from the store file in our own config dir — see
+            // assistant-stats.ts for why they are not fetched over IPC.
+            if (req.method === "GET" && url === "/api/assistant/friends") {
+                const [flist, ensPub] = await Promise.all([
+                    opts.call({ op: "friends-list" }),
+                    ensPublicByUserid(300),
+                ]);
+                const stamps = friendStoreStamps(opts.callIce?.keyFile);
+                const stats = historyStats(opts.messagesPath);
+                const fl = flist.ok ? (flist.data?.friends ?? []) : [];
+                const friends = fl.map((f) => {
+                    const uid = f.userid ?? "";
+                    const stamp = stamps.get(uid);
+                    const pub = ensPub.get(uid);
+                    const status = f.status;
+                    const acceptedAt = f.lastSeen ?? stamp?.acceptedAt ?? 0;
+                    const realName = typeof f.name === "string" && f.name !== uid ? f.name : undefined;
+                    const s = stats.byPeer.get(uid);
+                    return {
+                        userid: uid,
+                        name: f.alias || realName || pub?.displayName || uid,
+                        alias: f.alias || null,
+                        description: f.descr || pub?.description || null,
+                        ens: pub?.ens ?? null,
+                        acceptedAt,
+                        requestedAt: f.requestedAt ?? stamp?.requestedAt ?? 0,
+                        // A request we sent that was never accepted — same rule the
+                        // sidebar's waiting banner uses.
+                        pending: f.accepted === false || (status === "requested" && !acceptedAt),
+                        firstMsgTs: s?.firstMsgTs ?? null,
+                        lastInboundTs: s?.lastInboundTs ?? null,
+                        lastOutboundTs: s?.lastOutboundTs ?? null,
+                        inboundCount: s?.inboundCount ?? 0,
+                        outboundCount: s?.outboundCount ?? 0,
+                        // No call records exist in the store, so this is always null and
+                        // the Assistant does not offer a never-called filter.
+                        lastCallTs: null,
+                        // Only ever true if a backend starts saying so; nothing does today.
+                        agent: f.agent === true,
+                    };
+                });
+                sendJson(res, 200, {
+                    ok: true,
+                    friends,
+                    historySince: stats.historySince ?? null,
+                    beagleVer: beagleVersion(),
+                    now: Date.now(),
+                });
+                return;
+            }
             if (req.method === "GET" && url === "/api/chat-history") {
                 const q = new URL(req.url || "/", "http://x").searchParams;
                 const peer = q.get("peer") || undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decentnetwork/beagle",
-  "version": "0.1.105",
+  "version": "0.1.108",
   "description": "Beagle — P2P chat, file transfer and calls for regular users, on the Decent Network. No admin privilege required.",
   "type": "module",
   "main": "./dist/index.js",
@@ -28,14 +28,14 @@
   "dependencies": {
     "@decentnetwork/chat-components": "^0.1.3",
     "@decentnetwork/lan": "^0.1.283",
-    "@decentnetwork/peer": "^0.1.166",
+    "@decentnetwork/peer": "^0.1.168",
     "@decentnetwork/peer-webrtc": "^0.2.16",
     "js-yaml": "^4.1.0",
     "ws": "^8.21.1",
     "yargs": "^17.7.2"
   },
   "devDependencies": {
-    "@decentnetwork/beagle-ui": "^0.2.20",
+    "@decentnetwork/beagle-ui": "^0.2.22",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.11.0",
     "@types/yargs": "^17.0.32",