@withbuddi/buddi 0.1.0-pre.29 → 0.1.0-pre.31

package/node_modules/@buddi/gateway/dist/web/alerts.js

@@ -0,0 +1,363 @@
+/**
+ * Alerts: decisions, not chores (docs/dashboard.md, "Alerts").
+ *
+ * What the watchers found, shaped for the owner. Three rules, and every
+ * surface that lists findings — the Alerts page, Home's Needs you — reads them
+ * from here so none of them can drift:
+ *
+ *  1. **Only the owner's line is ever sent.** A finding's `detail` is the agent
+ *     brief, written for a model; it never leaves this file. A finding without
+ *     an owner line shows its title.
+ *  2. **Only decisions are listed.** An `info` finding goes to the recap
+ *     silently: it is counted in one line ("12 notes saved for Friday's
+ *     recap") and listed only in that line's preview.
+ *  3. **Repeats are one row.** Open findings of the same watcher and kind are
+ *     one group, titled by the watcher's group spec, with the subjects inside.
+ *
+ * Every row carries the actions its findings declared (host API 1.23), shaped
+ * so the page can only ask for what was declared: a `run` or a `fill` is named
+ * by finding key and action index, and resolved again here before anything
+ * runs.
+ */
+import { OWNER_AGENT_ID, getActiveSchedule, isMuted, isSnoozed, muteFindings, nextAfter, ownerLineOf, sentinelMutes, SENTINEL_FINDING_COLUMNS, toSentinelFinding, } from '@buddi/core';
+import { recapMissionId } from '../missions/recap.js';
+import { renderFindings } from '../missions/sentinel-wake.js';
+/** Which plugin ships each watcher. */
+export function sentinelPlugins(manifests) {
+    const out = new Map();
+    for (const m of manifests)
+        for (const s of m.sentinels ?? [])
+            out.set(s.id, m.name);
+    return out;
+}
+/**
+ * The owner's line for a surface: the plugin's own fences round quoted mail
+ * (`<<<QUOTED MAIL …>>>`) are for a model reading it, not for a person, so a
+ * surface draws the words without them. The finding keeps them for the agent.
+ */
+export function plainLine(f) {
+    return unfenced(ownerLineOf(f));
+}
+function unfenced(text) {
+    return text.replace(/<<<[^<>]*>>>/g, '').replace(/\s+/g, ' ').trim();
+}
+function groupKey(f) {
+    return `${f.sentinelId}:${f.kind}`;
+}
+function fill(template, count) {
+    return template.split('{count}').join(String(count));
+}
+/** The action a single finding offers, as the page draws it. */
+function actionView(f, a, index, plugin) {
+    switch (a.kind) {
+        case 'open':
+            return { kind: 'open', label: a.label, plugin, ...(a.page ? { page: a.page } : {}), ...(a.item ? { item: a.item } : {}), ...(a.place ? { place: a.place } : {}) };
+        case 'run':
+            return { kind: 'run', label: a.label, key: f.key, index, ...(a.confirm ? { confirm: a.confirm } : {}), ...(a.tone ? { tone: a.tone } : {}) };
+        case 'fill':
+            return {
+                kind: 'fill',
+                label: a.label,
+                title: a.title ?? a.label,
+                fields: [{ key: f.key, index, label: a.field.label, type: a.field.type, value: a.field.value ?? null, hint: a.field.hint ?? null }],
+            };
+        case 'ask':
+            return { kind: 'ask', label: a.label ?? null };
+        case 'dismiss':
+            return { kind: 'dismiss', label: a.label };
+    }
+}
+/**
+ * A group's actions, from its first finding's: what makes sense for many at
+ * once. A `fill` gathers a field from every finding that offers the same tool
+ * — one quick form for nine balances. An `open` stays when every finding opens
+ * the same page (without an item when the items differ). A `run` is about one
+ * thing, so a group never offers it; each finding keeps its own on its row
+ * inside the group (`itemActions`).
+ */
+function groupActions(findings, plugin) {
+    const first = findings[0];
+    if (findings.length === 1) {
+        const own = first.actions.map((a, i) => actionView(first, a, i, plugin));
+        return own.length > 0 ? own : [{ kind: 'ask', label: null }];
+    }
+    const out = [];
+    first.actions.forEach((a) => {
+        if (a.kind === 'run')
+            return;
+        if (a.kind === 'fill') {
+            const fields = [];
+            for (const f of findings) {
+                const index = f.actions.findIndex((x) => x.kind === 'fill' && x.tool === a.tool);
+                const own = f.actions[index];
+                if (own === undefined || own.kind !== 'fill')
+                    continue;
+                fields.push({ key: f.key, index, label: own.field.label, type: own.field.type, value: own.field.value ?? null, hint: own.field.hint ?? null });
+            }
+            out.push({ kind: 'fill', label: a.groupLabel ?? a.label, title: a.title ?? a.groupLabel ?? a.label, fields });
+            return;
+        }
+        if (a.kind === 'open') {
+            const same = findings.every((f) => f.actions.some((x) => x.kind === 'open' && x.page === a.page && x.place === a.place));
+            if (!same)
+                return;
+            const oneItem = findings.every((f) => f.actions.some((x) => x.kind === 'open' && x.item === a.item));
+            out.push({ kind: 'open', label: a.label, plugin, ...(a.page ? { page: a.page } : {}), ...(oneItem && a.item ? { item: a.item } : {}), ...(a.place ? { place: a.place } : {}) });
+            return;
+        }
+        out.push(actionView(first, a, 0, plugin));
+    });
+    return out.length > 0 ? out : [{ kind: 'ask', label: null }];
+}
+/**
+ * One finding's own actions inside a group of many: every `run`, by its own
+ * key and index, and an `open` that names its own item when the group's
+ * opens could not (`groupActions` drops the item when they differ).
+ */
+function itemActions(f, group, plugin) {
+    const out = [];
+    f.actions.forEach((a, index) => {
+        if (a.kind === 'run')
+            out.push(actionView(f, a, index, plugin));
+        if (a.kind === 'open' && a.item) {
+            const covered = group.some((g) => g.kind === 'open' && g.page === a.page && g.place === a.place && g.item === a.item);
+            if (!covered)
+                out.push(actionView(f, a, index, plugin));
+        }
+    });
+    return out;
+}
+/** One row per watcher and kind; a fact on its own is a row of one. */
+export function groupFindings(findings, plugins) {
+    const buckets = new Map();
+    for (const f of findings) {
+        const key = groupKey(f);
+        const list = buckets.get(key);
+        if (list)
+            list.push(f);
+        else
+            buckets.set(key, [f]);
+    }
+    const groups = [];
+    for (const list of buckets.values()) {
+        list.sort((a, b) => a.firstSeenAt.getTime() - b.firstSeenAt.getTime() || a.key.localeCompare(b.key));
+        const first = list[0];
+        const plugin = plugins.get(first.sentinelId) ?? null;
+        const many = list.length > 1;
+        const spec = list.find((f) => f.group !== null)?.group ?? null;
+        const title = !many
+            ? plainLine(first)
+            : spec
+                ? fill(spec.title, list.length)
+                : `${plainLine(first)} — and ${list.length - 1} more like it`;
+        const line = many && spec?.ownerLine ? fill(spec.ownerLine, list.length) : null;
+        const subject = !many ? first.subject : null;
+        const actions = groupActions(list, plugin);
+        groups.push({
+            id: many ? groupKey(first) : first.key,
+            sentinelId: first.sentinelId,
+            plugin,
+            kind: first.kind,
+            title,
+            line,
+            urgent: list.some((f) => f.severity === 'urgent'),
+            since: first.firstSeenAt.toISOString(),
+            agentId: list.find((f) => f.agentId !== null)?.agentId ?? null,
+            keys: list.map((f) => f.key),
+            items: list.map((f) => {
+                const fillAction = f.actions.find((a) => a.kind === 'fill');
+                const hint = fillAction?.kind === 'fill' ? fillAction.field.hint : undefined;
+                const own = many ? itemActions(f, actions, plugin) : [];
+                return {
+                    key: f.key,
+                    line: plainLine(f),
+                    subject: f.subject ? { id: f.subject.id, label: unfenced(f.subject.label) } : null,
+                    note: hint ?? plainLine(f),
+                    firstSeenAt: f.firstSeenAt.toISOString(),
+                    ...(own.length > 0 ? { actions: own } : {}),
+                };
+            }),
+            actions,
+            stop: subject
+                ? { scope: 'subject', label: `${unfenced(subject.label)}: ${plainLine(first)}` }
+                : { scope: 'kind', label: title },
+            snoozedUntil: list.map((f) => f.snoozedUntil).find((d) => d !== null)?.toISOString() ?? null,
+            resolvedAt: list.every((f) => f.resolvedAt !== null) ? list[list.length - 1].resolvedAt.toISOString() : null,
+        });
+    }
+    // Urgent first, then the longest waiting.
+    groups.sort((a, b) => Number(b.urgent) - Number(a.urgent) || a.since.localeCompare(b.since));
+    return groups;
+}
+async function loadFindings(pool, where, params = []) {
+    const { rows } = await pool.query(`select ${SENTINEL_FINDING_COLUMNS} from core.sentinel_findings where ${where}`, params);
+    return rows.map(toSentinelFinding);
+}
+function notMuted(mutes) {
+    return (f) => !isMuted(mutes, f.sentinelId, f.kind, f.subject?.id ?? null);
+}
+/** The decisions alone: what the Alerts page lists and Home's Needs you counts. */
+export async function readAlertDecisions(pool, registry, now) {
+    const mutes = await sentinelMutes(pool);
+    const open = await loadFindings(pool, `resolved_at is null and severity = 'urgent'`);
+    const live = open.filter(notMuted(mutes)).filter((f) => !isSnoozed(f, now));
+    return groupFindings(live, sentinelPlugins(registry.manifests()));
+}
+/** When the recap runs next, if a plugin ships one and it is on. */
+async function nextRecap(pool, manifests, now) {
+    const missionId = recapMissionId(manifests) ?? null;
+    if (missionId === null)
+        return { missionId, nextAt: null };
+    const { rows } = await pool.query(`select enabled from core.missions where id = $1`, [missionId]);
+    if (rows[0]?.enabled !== true)
+        return { missionId, nextAt: null };
+    const spec = await getActiveSchedule(pool, missionId).catch(() => null);
+    if (!spec)
+        return { missionId, nextAt: null };
+    const next = nextAfter(spec.cron, now, spec.timezone);
+    return { missionId, nextAt: next ? next.toISOString() : null };
+}
+export async function readAlerts(pool, registry, now) {
+    const manifests = registry.manifests();
+    const plugins = sentinelPlugins(manifests);
+    const mutes = await sentinelMutes(pool);
+    const shown = notMuted(mutes);
+    const urgentOpen = (await loadFindings(pool, `resolved_at is null and severity = 'urgent'`)).filter(shown);
+    const open = urgentOpen.filter((f) => !isSnoozed(f, now));
+    const snoozed = urgentOpen.filter((f) => isSnoozed(f, now));
+    const resolved = (await loadFindings(pool, `resolved_at is not null and resolved_at > $1 order by resolved_at desc limit 20`, [
+        new Date(now.getTime() - 7 * 86_400_000).toISOString(),
+    ])).filter(shown);
+    // The recap's notes: what is queued for it, in the owner's words.
+    const queued = await loadFindings(pool, `key in (select finding_key from core.digest_items where consumed_at is null)`);
+    const notes = queued.filter(shown);
+    const recap = await nextRecap(pool, manifests, now);
+    return {
+        open: groupFindings(open, plugins),
+        snoozed: groupFindings(snoozed, plugins),
+        resolved: groupFindings(resolved, plugins),
+        recap: { count: notes.length, ...recap, groups: groupFindings(notes, plugins) },
+        mutes: mutes.map((m) => ({ id: m.id, sentinelId: m.sentinelId, label: m.label, createdAt: m.createdAt.toISOString() })),
+    };
+}
+async function openFinding(pool, key) {
+    const [f] = await loadFindings(pool, `key = $1 and resolved_at is null`, [key]);
+    return f ?? null;
+}
+/**
+ * "Stop telling me this" on a row. A finding with a subject silences that
+ * subject; a group, or a finding about nothing in particular, its whole kind.
+ * `group` says which the page drew.
+ */
+export async function muteAlert(pool, body, now) {
+    const key = typeof body.key === 'string' ? body.key : '';
+    const f = key ? await openFinding(pool, key) : null;
+    if (!f)
+        return { status: 404, body: { error: 'No open alert has that key.' } };
+    const scope = body.scope === 'kind' || f.subject === null ? 'kind' : 'subject';
+    const label = typeof body.label === 'string' && body.label.trim() !== ''
+        ? body.label.trim()
+        : scope === 'subject' && f.subject
+            ? `${f.subject.label}: ${plainLine(f)}`
+            : plainLine(f);
+    const mute = await muteFindings(pool, { sentinelId: f.sentinelId, kind: f.kind, subjectId: scope === 'subject' && f.subject ? f.subject.id : '', label }, now);
+    return { status: 200, body: { id: mute.id, label: mute.label } };
+}
+/** At most this many entries in one act: a quick form of every balance, not a script. */
+export const ALERT_ACT_MAX = 50;
+/**
+ * Run what a finding declared: a `run`, or a `fill` with the value the owner
+ * typed. The page names a finding key and an action index, never a tool, so
+ * it can only run what the watcher put on the row — and only a tool of the
+ * plugin that ships the watcher. A gated tool answers its approval, exactly
+ * as from the plugin's own page.
+ */
+export async function actOnAlerts(deps, body, session) {
+    const entries = Array.isArray(body.entries) ? body.entries : null;
+    if (entries === null || entries.length === 0)
+        return { status: 400, body: { error: 'Send `{ entries: [{ key, action, value? }] }`.' } };
+    if (entries.length > ALERT_ACT_MAX)
+        return { status: 400, body: { error: `At most ${ALERT_ACT_MAX} at once.` } };
+    const plugins = sentinelPlugins(deps.registry.manifests());
+    const results = [];
+    for (const raw of entries) {
+        const entry = (raw ?? {});
+        const key = typeof entry.key === 'string' ? entry.key : '';
+        const index = typeof entry.action === 'number' && Number.isInteger(entry.action) ? entry.action : -1;
+        const f = key ? await openFinding(deps.pool, key) : null;
+        const action = f?.actions[index];
+        if (!f || !action || (action.kind !== 'run' && action.kind !== 'fill')) {
+            results.push({ key, error: 'That alert has no such action any more.' });
+            continue;
+        }
+        const plugin = plugins.get(f.sentinelId);
+        if (plugin === undefined || deps.registry.pluginOf(action.tool) !== plugin) {
+            results.push({ key, error: `${action.tool} is not a tool of the plugin that raised this alert.` });
+            continue;
+        }
+        const args = { ...(action.args ?? {}) };
+        if (action.kind === 'fill') {
+            const value = entry.value;
+            if (action.field.type === 'number') {
+                const n = typeof value === 'number' ? value : typeof value === 'string' && value.trim() !== '' ? Number(value.replace(/[,\s]/g, '')) : NaN;
+                if (!Number.isFinite(n)) {
+                    results.push({ key, error: `${action.field.label}: a number, please.` });
+                    continue;
+                }
+                args[action.field.name] = n;
+            }
+            else {
+                if (typeof value !== 'string' || value.trim() === '') {
+                    results.push({ key, error: `${action.field.label}: nothing typed.` });
+                    continue;
+                }
+                args[action.field.name] = value.trim();
+            }
+        }
+        const result = await deps.registry.invoke(action.tool, args, { ...deps.ctx, agentId: OWNER_AGENT_ID, now: deps.now }, { askOnly: session.via === 'token' });
+        if (result.ok)
+            results.push({ key, result: result.output });
+        else if (result.reason === 'approval-required')
+            results.push({ key, approvalId: result.actionId });
+        else if (result.reason === 'ask-only')
+            results.push({ key, error: `An API token cannot run ${action.tool}: it runs without an approval.` });
+        else
+            results.push({ key, error: result.message });
+    }
+    return { status: 200, body: { results } };
+}
+/**
+ * "Ask <agent>": a turn with the agent that answers for the findings. The
+ * thread shows the owner's line as what he asked about; the agent reads the
+ * findings — brief, data and all — inside the watcher fence, the way a wake
+ * hands them over.
+ */
+export function askPrompt(findings) {
+    const payloads = findings.map((f) => ({
+        key: f.key,
+        sentinelId: f.sentinelId,
+        severity: f.severity,
+        title: f.title,
+        ...(f.ownerLine ? { ownerLine: f.ownerLine } : {}),
+        detail: f.detail,
+        agentId: f.agentId,
+        data: f.data ?? null,
+    }));
+    const label = findings.length === 1
+        ? `About: ${plainLine(findings[0])}`
+        : `About ${findings.length} alerts: ${plainLine(findings[0])}…`;
+    const prompt = [
+        findings.length === 1
+            ? 'The owner pressed "Ask" on this alert on his Alerts page. Check it with your own tools first, then tell him in a few plain sentences what it means and what you suggest — offer to do the part you can do.'
+            : 'The owner pressed "Ask" on these alerts, grouped on his Alerts page. Check them with your own tools first, then answer once, in a few plain sentences: what they mean together and what you suggest — offer to do the part you can do.',
+        '',
+        renderFindings(payloads),
+    ].join('\n');
+    return { label: label.length > 160 ? `${label.slice(0, 157)}…` : label, prompt };
+}
+export async function findingsForAsk(pool, keys) {
+    if (keys.length === 0)
+        return [];
+    return loadFindings(pool, `key = any($1::text[]) order by first_seen_at`, [[...keys].slice(0, ALERT_ACT_MAX)]);
+}
+//# sourceMappingURL=alerts.js.map

package/node_modules/@buddi/gateway/dist/web/alerts.js.map

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

package/node_modules/@buddi/gateway/dist/web/api-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-routes.d.ts","sourceRoot":"","sources":["../../src/web/api-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEpE,gDAAgD;AAChD,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAExE,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,yDAAyD;IACzD,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,qGAAqG;AACrG,eAAO,MAAM,cAAc;;;;;;;CAOjB,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,cAAc,CAAC;AAEvD,6CAA6C;AAC7C,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;CAuBZ,CAAC;AACX,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,SAAS,CAAC;AAK7C,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EA8mBzC,CAAC;AAYF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CASpF;AAMD,wBAAgB,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAI9C;AAkDD,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,SAAS,QAAQ,EAAe,EAAE,KAAK,GAAE,MAAkB,GAAG,MAAM,CAuC9G;AAED,oFAAoF;AACpF,eAAO,MAAM,SAAS,gmNA+IrB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgQtD,CAAC"}
+{"version":3,"file":"api-routes.d.ts","sourceRoot":"","sources":["../../src/web/api-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEpE,gDAAgD;AAChD,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAExE,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,yDAAyD;IACzD,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,qGAAqG;AACrG,eAAO,MAAM,cAAc;;;;;;;CAOjB,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,cAAc,CAAC;AAEvD,6CAA6C;AAC7C,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;CAuBZ,CAAC;AACX,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,SAAS,CAAC;AAK7C,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EAgpBzC,CAAC;AAYF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CASpF;AAMD,wBAAgB,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAI9C;AAkDD,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,SAAS,QAAQ,EAAe,EAAE,KAAK,GAAE,MAAkB,GAAG,MAAM,CAuC9G;AAED,oFAAoF;AACpF,eAAO,MAAM,SAAS,gmNA+IrB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA0QtD,CAAC"}

package/node_modules/@buddi/gateway/dist/web/api-routes.js

@@ -73,7 +73,7 @@ export const API_ROUTES = [
     },
     {
         method: 'GET', path: '/api/lock/screen', area: 'session', whileLocked: true,
-        summary: 'What the lock screen draws: the time, counts waiting, the focus line, its widgets.',
+        summary: 'What the lock screen draws: the time, counts waiting (approvals, and everything else that needs the owner as `needs`), the focus line, its widgets.',
         query: 'hour?: number',
     },
     {
@@ -145,7 +145,7 @@ export const API_ROUTES = [
     {
         method: 'GET', path: '/api/overview', area: 'home',
         summary: "Home's whole first read: plugin blocks and glances, and counts of approvals, jobs, missions, reminders, watchers.",
-        answer: '{ now, timezone, paused, home: HomeBlock[], glances, approvals: { pending, oldestPendingAt }, jobs: Record<state, number>, missions, reminders, sentinels, mail, running }',
+        answer: '{ now, timezone, paused, home: HomeBlock[], glances, approvals: { pending, oldestPendingAt }, jobs: Record<state, number>, missions, reminders, sentinels, mail, running, needsYou: { approvals, questions, urgent, failed, proposals, asks, agentsToSetUp, signIns, recovery, total } }',
     },
     { method: 'GET', path: '/api/tips', area: 'home', summary: 'Every tip and its state.', answer: '{ tips: Tip[], enabled: boolean }' },
     {
@@ -165,7 +165,7 @@ export const API_ROUTES = [
     },
     {
         method: 'PUT', path: '/api/widgets/home', area: 'home', summary: "Save Home's widget layout.",
-        body: "{ placed: Array<{ id, widget, size: 'small'|'medium', settings? }> }", answer: 'the widgets view', errors: '400 an unknown widget or a bad setting',
+        body: "{ placements: Array<{ key?, widget, size: 'small'|'medium', settings? }> }", answer: 'the widgets view', errors: '400 an unknown widget or a bad setting',
     },
     {
         method: 'PUT', path: '/api/widgets/lock', area: 'home', summary: "Save the lock screen's widgets (up to four).",
@@ -181,6 +181,10 @@ export const API_ROUTES = [
         method: 'POST', path: '/api/home/glances/:id/hidden', area: 'home', summary: 'Hide a Home glance or show it again.',
         body: '{ hidden: boolean }', errors: '404 no such glance',
     },
+    {
+        method: 'POST', path: '/api/home/dismiss', area: 'home', summary: 'Close one thing on Home until it changes, or show it again.',
+        body: '{ slot: string, token: string | null }', answer: '{ dismissed: Record<slot, token> }', errors: '400',
+    },
     { method: 'GET', path: '/api/rail', area: 'home', summary: 'Which plugin pages the owner hid from the rail.', answer: '{ hidden: Array<{ plugin, page }> }' },
     {
         method: 'POST', path: '/api/rail/pages/:plugin/:page/hidden', area: 'home', summary: 'Hide a plugin page from the rail or show it again.',
@@ -382,24 +386,54 @@ export const API_ROUTES = [
         body: "{ cron?: string, timezone?: string, misfirePolicy?: 'skip'|'run-once', deadlineMinutes?: number|null }", errors: '400; 404',
     },
     {
-        method: 'GET', path: '/api/jobs', area: 'work', summary: 'The job queue, paged.',
-        query: 'state?, kind?, limit?, offset?', answer: '{ jobs: JobView[], total, counts }',
+        method: 'GET', path: '/api/jobs', area: 'work', summary: 'The job queue, paged. `counts.failed` is the failed jobs still asking for the owner; `counts.dismissed` the ones dismissed or quiet after 14 days.',
+        query: "state?, kind?, limit?, offset?, failed?: 'open'|'dismissed', dismissed?: '0' (leave dismissed failed jobs out)", answer: '{ jobs: JobView[], counts, paused }',
+    },
+    {
+        method: 'GET', path: '/api/jobs/failures', area: 'work', summary: 'Failed jobs grouped by cause, each group with a plain reason and whether a retry is likely to work; the dismissed ones apart.',
+        answer: '{ open: FailureGroupView[], dismissed: FailureGroupView[] }',
+    },
+    {
+        method: 'POST', path: '/api/jobs/dismiss', area: 'work', summary: 'Dismiss failed jobs: kept on record, out of the footer count and the default view.',
+        body: '{ ids?: string[], group?: string, all?: true }', answer: '{ ids: string[] }', errors: '400',
+    },
+    { method: 'POST', path: '/api/jobs/undismiss', area: 'work', summary: 'Take a dismissal back (Undo).', body: '{ ids: string[] }', answer: '{ ids: string[] }', errors: '400' },
+    {
+        method: 'POST', path: '/api/jobs/retry', area: 'work', summary: 'Retry failed jobs now, by ids, by cause group, or every one still asking.',
+        body: '{ ids?: string[], group?: string, dismissed?: boolean, all?: true }', answer: '{ jobs: JobView[] }', errors: '400',
     },
     { method: 'POST', path: '/api/jobs/:id/retry', area: 'work', summary: 'Retry a failed job.', errors: '404; 409 not failed' },
     { method: 'POST', path: '/api/jobs/:id/cancel', area: 'work', summary: 'Cancel a queued or failed job.', errors: '404; 409' },
     { method: 'GET', path: '/api/reminders', area: 'work', summary: 'Reminders agents set, pending and past.', query: 'limit?: number', answer: '{ reminders }' },
     { method: 'POST', path: '/api/reminders/:id/cancel', area: 'work', summary: 'Cancel a pending reminder.', body: '{ reason?: string }', errors: '404; 409' },
     {
-        method: 'GET', path: '/api/sentinels', area: 'work', summary: 'Watchers: each one, whether it is on, its last run and open findings.',
-        query: 'limit?: number (50)',
+        method: 'GET', path: '/api/sentinels', area: 'work', summary: 'Watchers: each one, whether it is on, its last run, and what they found as the owner reads it — decisions grouped, the recap counted, what he silenced.',
+        answer: '{ installed, runs, alerts: { open, snoozed, resolved, recap: { count, missionId, nextAt, groups }, mutes } }',
     },
     { method: 'POST', path: '/api/sentinels/:id/enabled', area: 'work', summary: 'Switch a watcher off or on.', body: '{ enabled: boolean }', answer: '{ sentinelId, enabled }', errors: '400 no watcher with that id' },
     {
         method: 'POST', path: '/api/alerts/:key/snooze', area: 'work', summary: 'Snooze an open alert, or wake it.',
-        body: '{ snoozed: boolean }', answer: '{ key, snoozedAt: string|null }', errors: '404 no open alert with that key',
+        body: '{ snoozed: boolean, days?: number }  // days: "Not now", quiet that long; none: until the fact changes', answer: '{ key, snoozedAt: string|null, snoozedUntil: string|null }', errors: '404 no open alert with that key',
+    },
+    {
+        method: 'POST', path: '/api/alerts/snooze', area: 'work', summary: 'Snooze several alerts at once (Clear all), or wake them (its Undo).',
+        body: '{ keys: string[], snoozed: boolean, days?: number }', answer: '{ keys: string[] }  // the ones that were open', errors: '400',
+    },
+    {
+        method: 'POST', path: '/api/alerts/mute', area: 'work', summary: '"Stop telling me this": silence the alert\'s subject, or its whole kind. Reversible from Settings → Watchers.',
+        body: "{ key: string, scope?: 'subject'|'kind', label?: string }", answer: '{ id, label }', errors: '404 no open alert with that key',
+    },
+    { method: 'POST', path: '/api/alerts/mutes/:id/remove', area: 'work', summary: 'Take a "Stop telling me this" back.', answer: '{ removed: true }', errors: '404' },
+    {
+        method: 'POST', path: '/api/alerts/act', area: 'work', summary: "Run what an alert declared (a run, or a fill with the typed value), as the owner. Named by key and action index, never by tool; a gated tool answers its approval.",
+        body: '{ entries: Array<{ key: string, action: number, value?: string|number }> }', answer: '{ results: Array<{ key, result? , approvalId?, error? }> }', errors: '400; 429',
+    },
+    {
+        method: 'POST', path: '/api/alerts/ask', area: 'work', summary: 'Ask the agent that answers for these alerts, handing it their briefs. The thread shows what was asked about.',
+        body: '{ keys: string[] }', answer: '{ agentId, conversationId, runId }', errors: '404; 409 no agent answers; 503 chat is not running',
     },
     /* ---------------- notifications ---------------- */
-    { method: 'GET', path: '/api/notifications', area: 'notifications', summary: 'The notifications buddi sent, newest first.', query: 'limit?: number' },
+    { method: 'GET', path: '/api/notifications', area: 'notifications', summary: 'The notifications buddi sent, newest first, each with needsOwner; with needs=1 the open ones that ask the owner for something.', query: 'limit?: number, needs?: 1' },
     { method: 'POST', path: '/api/notifications/:id/seen', area: 'notifications', summary: 'Mark a notification seen.', errors: '404' },
     { method: 'GET', path: '/api/notifications/settings', area: 'notifications', summary: 'Where and when buddi reaches the owner.', answer: '{ settings, channels }' },
     { method: 'PUT', path: '/api/notifications/settings', area: 'notifications', summary: 'Change the notification settings.', body: 'the settings object', answer: '{ settings, channels }', errors: '400' },
@@ -941,6 +975,16 @@ curl -N -H "Authorization: Bearer $BUDDI_TOKEN" "$BUDDI_URL/api/chat/conversatio
  * release has no entry and reads "unreleased" until the release adds it.
  */
 export const API_SINCE = {
+    'POST /api/home/dismiss': '0.1.0-pre.31',
+    'GET /api/jobs/failures': '0.1.0-pre.30',
+    'POST /api/jobs/dismiss': '0.1.0-pre.30',
+    'POST /api/jobs/undismiss': '0.1.0-pre.30',
+    'POST /api/jobs/retry': '0.1.0-pre.30',
+    'POST /api/alerts/snooze': '0.1.0-pre.30',
+    'POST /api/alerts/mute': '0.1.0-pre.30',
+    'POST /api/alerts/mutes/:id/remove': '0.1.0-pre.30',
+    'POST /api/alerts/act': '0.1.0-pre.30',
+    'POST /api/alerts/ask': '0.1.0-pre.30',
     'GET /api/lock': '0.1.0-pre.29',
     'POST /api/lock': '0.1.0-pre.29',
     'GET /api/lock/screen': '0.1.0-pre.29',