@songsid/agend 2.2.0 → 2.3.0-beta.2

package/dist/web-widget.js

@@ -0,0 +1,245 @@
+/**
+ * #1629 r4-4 (option A, the user's choice 2026-10-16): a widget is **declarative**. A mod supplies a small closed spec
+ * (which host components, in which order, with which labels) and data (the values they show); the page draws them
+ * with its own components (src/ui/shared/agent-widget.js). Nothing from a mod is HTML, script, an event handler, a
+ * URL or CSS: styling comes only from the agent's theme tokens and a person's own stylesheet, as everywhere else.
+ *
+ * Slots (r4 §2): `chat_header` and `details` are the agent's own areas (it, or a person, places a widget there);
+ * `sidebar` is the person's (their synced preference, never an agent's). A value is either the mod's (`key` → data)
+ * or one the page already shows (`bind`): the instance's own state, context and cost, and — in the person's sidebar
+ * only — the fleet's counts. The page resolves a bind from what it already has; nothing new is sent for it.
+ *
+ * One module validates and canonicalises both; the store keeps only what this returns, and the page checks again.
+ */
+import { createHash } from "node:crypto";
+import { canonicalText } from "./web-theme.js";
+export const WIDGET_SLOTS = ["chat_header", "details", "sidebar"];
+/** The agent's own slots. `sidebar` is a person's (owner_slot for an agent). */
+export const AGENT_WIDGET_SLOTS = ["chat_header", "details"];
+export const WIDGET_ITEM_TYPES = ["stat", "progress", "text", "list", "badge", "spark"];
+export const WIDGET_TONES = ["ok", "warn", "bad", "info", "muted"];
+/** Values the page already has for the instance itself (its status frame entry). */
+export const INSTANCE_BINDS = ["state", "context_pct", "cost_usd"];
+/** The fleet's counts: the person's sidebar only (an agent's widget never sees another instance). */
+export const FLEET_BINDS = ["fleet.idle", "fleet.working", "fleet.needs_you", "fleet.stopped"];
+/** The chat header is one short strip: at most 4 compact items, and no list or sparkline. */
+export const SLOT_RULES = {
+    chat_header: { maxItems: 4, types: ["stat", "progress", "text", "badge"], binds: INSTANCE_BINDS },
+    details: { maxItems: 8, types: WIDGET_ITEM_TYPES, binds: INSTANCE_BINDS },
+    sidebar: { maxItems: 8, types: WIDGET_ITEM_TYPES, binds: FLEET_BINDS },
+};
+/** Which binds each component can show (a bind is a number or a state word). */
+const BINDS_FOR = {
+    stat: ["context_pct", "cost_usd", ...FLEET_BINDS],
+    progress: ["context_pct"],
+    text: ["state"],
+    badge: ["state"],
+    list: [],
+    spark: [],
+};
+/** Every key an item of that type may carry (closed). */
+const ITEM_KEYS = {
+    stat: ["type", "label", "key", "bind", "unit"],
+    progress: ["type", "label", "key", "bind", "max"],
+    text: ["type", "label", "key", "bind"],
+    list: ["type", "label", "key"],
+    badge: ["type", "label", "key", "bind", "tone", "tones"],
+    spark: ["type", "label", "key"],
+};
+/** A label is required where the value alone would mean nothing. */
+const LABEL_REQUIRED = new Set(["stat", "progress", "spark"]);
+export const WIDGET_TITLE_MAX = 24;
+export const WIDGET_LABEL_MAX = 24;
+export const WIDGET_UNIT_MAX = 8;
+export const WIDGET_TEXT_MAX = 120;
+export const WIDGET_LIST_ITEMS = 6;
+export const WIDGET_LIST_TEXT_MAX = 60;
+export const WIDGET_SPARK_POINTS = 48;
+export const WIDGET_TONES_MAX = 8;
+export const WIDGET_NUMBER_MAX = 1e15;
+/** Canonical JSON bytes: the spec, and the data. */
+export const WIDGET_SPEC_MAX_BYTES = 2048;
+export const WIDGET_DATA_MAX_BYTES = 4096;
+const KEY = /^[a-z][a-z0-9_]{0,31}$/;
+const isObj = (v) => typeof v === "object" && v !== null && !Array.isArray(v) && Object.getPrototypeOf(v) === Object.prototype;
+const bytesOf = (v) => Buffer.byteLength(JSON.stringify(v), "utf8");
+const isNumber = (v) => typeof v === "number" && Number.isFinite(v) && Math.abs(v) <= WIDGET_NUMBER_MAX;
+/** A null-prototype map, so "__proto__" is an ordinary key. */
+function ownMap() { return Object.create(null); }
+function put(o, k, v) { Object.defineProperty(o, k, { value: v, enumerable: true, writable: true, configurable: true }); }
+/** A spec for `slot`, closed and canonical: unknown keys, types, binds or a component the slot can't hold are refused. */
+export function checkWidgetSpec(raw, slot) {
+    const errors = [];
+    const bad = (path, problem) => { errors.push({ path, problem }); };
+    if (!isObj(raw))
+        return { ok: false, errors: [{ path: "spec", problem: "an object { v: 1, title, items }" }] };
+    for (const k of Object.keys(raw))
+        if (!["v", "title", "items"].includes(k))
+            bad(k, "unknown key");
+    if (raw.v !== 1)
+        bad("v", "must be 1");
+    const title = canonicalText(raw.title, 1, WIDGET_TITLE_MAX);
+    if (title === null)
+        bad("title", `1..${WIDGET_TITLE_MAX} characters on one line`);
+    const rules = SLOT_RULES[slot];
+    const items = [];
+    if (!Array.isArray(raw.items) || raw.items.length < 1 || raw.items.length > rules.maxItems)
+        bad("items", `1..${rules.maxItems} items in ${slot}`);
+    else
+        raw.items.forEach((it, i) => {
+            const at = `items.${i}`;
+            if (!isObj(it)) {
+                bad(at, "an object");
+                return;
+            }
+            const type = it.type;
+            if (!WIDGET_ITEM_TYPES.includes(type)) {
+                bad(`${at}.type`, WIDGET_ITEM_TYPES.join(" | "));
+                return;
+            }
+            if (!rules.types.includes(type)) {
+                bad(`${at}.type`, `not in ${slot} (${rules.types.join(", ")})`);
+                return;
+            }
+            for (const k of Object.keys(it))
+                if (!ITEM_KEYS[type].includes(k))
+                    bad(`${at}.${k}`, "unknown key");
+            const out = { type };
+            if (it.label !== undefined || LABEL_REQUIRED.has(type)) {
+                const label = canonicalText(it.label, 1, WIDGET_LABEL_MAX);
+                if (label === null)
+                    bad(`${at}.label`, `1..${WIDGET_LABEL_MAX} characters on one line`);
+                else
+                    out.label = label;
+            }
+            const hasKey = it.key !== undefined, hasBind = it.bind !== undefined;
+            if (hasKey === hasBind)
+                bad(at, "exactly one of key (your data) or bind (a value the page has)");
+            if (hasKey) {
+                if (typeof it.key === "string" && KEY.test(it.key))
+                    out.key = it.key;
+                else
+                    bad(`${at}.key`, "a-z, 0-9 and _ (1..32, starting with a letter)");
+            }
+            if (hasBind) {
+                const b = it.bind;
+                if (!BINDS_FOR[type].includes(b))
+                    bad(`${at}.bind`, BINDS_FOR[type].length ? `${type} shows ${BINDS_FOR[type].join(", ")}` : `${type} has no bind`);
+                else if (!rules.binds.includes(b))
+                    bad(`${at}.bind`, `not in ${slot}`);
+                else
+                    out.bind = b;
+            }
+            if (it.unit !== undefined) {
+                const u = canonicalText(it.unit, 1, WIDGET_UNIT_MAX);
+                if (u === null)
+                    bad(`${at}.unit`, `1..${WIDGET_UNIT_MAX} characters`);
+                else
+                    out.unit = u;
+            }
+            if (it.max !== undefined) {
+                if (isNumber(it.max) && it.max > 0)
+                    out.max = it.max;
+                else
+                    bad(`${at}.max`, "a number > 0");
+            }
+            if (it.tone !== undefined) {
+                if (WIDGET_TONES.includes(it.tone))
+                    out.tone = it.tone;
+                else
+                    bad(`${at}.tone`, WIDGET_TONES.join(" | "));
+            }
+            if (it.tones !== undefined) {
+                if (!isObj(it.tones) || Object.keys(it.tones).length < 1 || Object.keys(it.tones).length > WIDGET_TONES_MAX)
+                    bad(`${at}.tones`, `1..${WIDGET_TONES_MAX} entries { value: tone }`);
+                else {
+                    const tones = ownMap();
+                    for (const [k, v] of Object.entries(it.tones)) {
+                        const word = canonicalText(k, 1, WIDGET_LABEL_MAX);
+                        if (word === null || !WIDGET_TONES.includes(v)) {
+                            bad(`${at}.tones`, `each value 1..${WIDGET_LABEL_MAX} characters → ${WIDGET_TONES.join(" | ")}`);
+                            break;
+                        }
+                        put(tones, word, v);
+                    }
+                    out.tones = tones;
+                }
+            }
+            items.push(out);
+        });
+    if (errors.length)
+        return { ok: false, errors };
+    const spec = { v: 1, title: title, items };
+    if (bytesOf(spec) > WIDGET_SPEC_MAX_BYTES)
+        return { ok: false, errors: [{ path: "spec", problem: `at most ${WIDGET_SPEC_MAX_BYTES} bytes` }] };
+    return { ok: true, value: spec };
+}
+/** Whether `v` is a value an item of `type` can show (the same rule on the page). */
+export function valueFits(type, v) {
+    switch (type) {
+        case "stat": return isNumber(v) || canonicalText(v, 1, WIDGET_LABEL_MAX) !== null;
+        case "progress": return isNumber(v);
+        case "text": return canonicalText(v, 1, WIDGET_TEXT_MAX) !== null;
+        case "badge": return canonicalText(v, 1, WIDGET_LABEL_MAX) !== null;
+        case "list": return Array.isArray(v) && v.length >= 1 && v.length <= WIDGET_LIST_ITEMS && v.every(s => canonicalText(s, 1, WIDGET_LIST_TEXT_MAX) !== null);
+        case "spark": return Array.isArray(v) && v.length >= 2 && v.length <= WIDGET_SPARK_POINTS && v.every(isNumber);
+    }
+}
+const normalized = (v) => typeof v === "string" ? v.normalize("NFC") : Array.isArray(v) ? v.map(x => typeof x === "string" ? x.normalize("NFC") : x) : v;
+/** Data for `spec`: closed to the keys the spec names, each value fitting every item that shows it. */
+export function checkWidgetData(raw, spec) {
+    if (!isObj(raw))
+        return { ok: false, errors: [{ path: "data", problem: "an object { key: value }" }] };
+    const users = new Map();
+    for (const it of spec.items)
+        if (it.key)
+            users.set(it.key, [...(users.get(it.key) ?? []), it.type]);
+    const errors = [];
+    const out = ownMap();
+    for (const [k, v] of Object.entries(raw)) {
+        const types = users.get(k);
+        if (!types) {
+            errors.push({ path: `data.${k.slice(0, 40)}`, problem: "no item shows this key" });
+            continue;
+        }
+        const bad = types.find(t => !valueFits(t, v));
+        if (bad) {
+            errors.push({ path: `data.${k}`, problem: `not a value a ${bad} shows` });
+            continue;
+        }
+        put(out, k, normalized(v));
+    }
+    if (errors.length)
+        return { ok: false, errors };
+    if (bytesOf(out) > WIDGET_DATA_MAX_BYTES)
+        return { ok: false, errors: [{ path: "data", problem: `at most ${WIDGET_DATA_MAX_BYTES} bytes` }] };
+    return { ok: true, value: out };
+}
+/** `patch` over `prev`: a key set to null is removed; the result is checked whole. */
+export function mergeWidgetData(prev, patch, spec) {
+    if (!isObj(patch))
+        return { ok: false, errors: [{ path: "data", problem: "an object { key: value | null }" }] };
+    const next = ownMap();
+    for (const [k, v] of Object.entries(prev))
+        put(next, k, v);
+    for (const [k, v] of Object.entries(patch)) {
+        if (v === null)
+            delete next[k];
+        else
+            put(next, k, v);
+    }
+    return checkWidgetData({ ...next }, spec);
+}
+/** The data kept when a spec changes: each value that still fits the new spec. */
+export function carryWidgetData(prev, spec) {
+    const out = ownMap();
+    for (const [k, v] of Object.entries(prev))
+        if (checkWidgetData({ [k]: v }, spec).ok)
+            put(out, k, v);
+    return out;
+}
+/** A spec's id: its content (canonical JSON). The same spec in two bundles is the same widget. */
+export function widgetId(spec) {
+    return createHash("sha256").update(JSON.stringify(spec)).digest("hex").slice(0, 32);
+}
+//# sourceMappingURL=web-widget.js.map

package/dist/web-widget.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@songsid/agend",
-  "version": "2.2.0",
+  "version": "2.3.0-beta.2",
   "description": "Multi-agent fleet daemon — run coding CLIs (Claude, Muse, Codex, OpenCode) from Discord or Telegram",
   "type": "module",
   "bin": {

package/templates/systemd.service.ejs

@@ -47,6 +47,14 @@ KillMode=mixed
 # server and every CLI the fleet starts. LimitCORE=0 covers a file core_pattern.
 CoredumpFilter=0
 LimitCORE=0
+# One OOM-killed process must not take the fleet with it (#2015). With the
+# default OOMPolicy=stop, a kernel OOM kill of ANY process in this cgroup (an
+# agent's one-off script, 2026-10-17) stopped the whole unit: every CLI, tmux
+# and the fleet. With continue only that process dies: a killed CLI is a crash
+# the fleet restarts, a killed tool child is an error its CLI sees, and a killed
+# fleet process is a failed main process that Restart=on-failure brings back.
+# systemd before 243 does not know the key and ignores it (with a warning).
+OOMPolicy=continue
 StandardOutput=append:<%= logPath %>
 StandardError=append:<%= logPath %>