@withbuddi/buddi 0.1.0-pre.17 → 0.1.0-pre.19

package/packages/core/dist/notifications/channels.js

@@ -0,0 +1,87 @@
+/**
+ * The channels registry: who can carry a message to the owner from this
+ * process. A channel is registered by whatever owns the transport — the
+ * Telegram surface at gateway boot — and core never knows more about it than
+ * this shape.
+ */
+import { ALWAYS_REACH } from './types.js';
+const channels = new Map();
+/** Add a channel; the returned function removes exactly this registration. */
+export function registerChannel(channel) {
+    if (channel.kind === 'dashboard')
+        throw new Error('"dashboard" is a surface, not a channel');
+    channels.set(channel.kind, channel);
+    return () => {
+        if (channels.get(channel.kind) === channel)
+            channels.delete(channel.kind);
+    };
+}
+/** A channel's description, or null when it has nothing to carry a message now. Never throws. */
+async function described(channel) {
+    try {
+        return (await channel.describe()) ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/** The channels there are now, the default-when-none-is-picked first: by `priority`, then as registered. */
+async function available() {
+    const all = [...channels.values()].sort((a, b) => (a.priority ?? 100) - (b.priority ?? 100));
+    const answers = await Promise.all(all.map(described));
+    return all.flatMap((channel, i) => {
+        const description = answers[i];
+        return description ? [{ channel, description }] : [];
+    });
+}
+/** Every channel there is now, in the order `available` gives. */
+export async function listChannels() {
+    return (await available()).map(({ channel, description }) => ({
+        kind: channel.kind,
+        label: description.label,
+        ...(description.where ? { where: description.where } : {}),
+        can: channel.can,
+    }));
+}
+/** Tests only: forget every channel. */
+export function clearChannels() {
+    channels.clear();
+}
+/**
+ * The channel a message of this kind goes to: the kind's own choice when it
+ * names a channel there is now, else the default channel, else the first one
+ * (by `priority`, then as registered). `off` when the owner turned the kind off; null when there is
+ * nowhere to go.
+ */
+export async function channelFor(settings, kind) {
+    const own = kind ? settings.perKind[kind] : undefined;
+    if (own === 'off')
+        return ALWAYS_REACH.has(kind) ? channelFor(settings) : 'off';
+    const there = (await available()).map(({ channel }) => channel.kind);
+    if (own && there.includes(own))
+        return own;
+    if (settings.defaultChannel && there.includes(settings.defaultChannel))
+        return settings.defaultChannel;
+    return there[0] ?? null;
+}
+/**
+ * Hand a message to one channel. Never throws: a channel that refuses or
+ * throws is an answer, written on the row by the caller.
+ */
+export async function deliverTo(kind, message) {
+    const channel = channels.get(kind);
+    if (!channel)
+        return { ok: false, error: 'no channel' };
+    try {
+        const answer = await channel.deliver(message);
+        if (answer === 'refused')
+            return { ok: false, error: `${(await described(channel))?.label ?? kind} refused it` };
+        if ('refused' in answer)
+            return { ok: false, error: answer.refused };
+        return { ok: true, id: answer.id };
+    }
+    catch (err) {
+        return { ok: false, error: err instanceof Error ? err.message : String(err) };
+    }
+}
+//# sourceMappingURL=channels.js.map

package/packages/core/dist/notifications/channels.js.map

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

package/packages/core/dist/notifications/index.d.ts

@@ -0,0 +1,5 @@
+export * from './types.js';
+export * from './channels.js';
+export * from './store.js';
+export * from './notify.js';
+//# sourceMappingURL=index.d.ts.map

package/packages/core/dist/notifications/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/packages/core/dist/notifications/index.js

@@ -0,0 +1,5 @@
+export * from './types.js';
+export * from './channels.js';
+export * from './store.js';
+export * from './notify.js';
+//# sourceMappingURL=index.js.map

package/packages/core/dist/notifications/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/packages/core/dist/notifications/notify.d.ts

@@ -0,0 +1,35 @@
+import type { Queryable } from '../owner.js';
+import { type NotificationSettings, type NotifyDeps, type NotifyResult, type OwnerMessage } from './types.js';
+/** A `now` message shown on the dashboard goes to the channel after this long unseen. */
+export declare const ESCALATE_AFTER_MS: number;
+/** The rate rule: more than this many fires of one key in an hour lowers `now` to `today`. */
+export declare const RATE_LIMIT_PER_HOUR = 3;
+/** Said once, on the title, when the rate rule lowers a message. */
+export declare const LOWERED_SENTENCE = "This came up more than three times in an hour, so it waits for the end of the day.";
+/** The surface whose presence means "shown on the dashboard". */
+export declare const DASHBOARD_SURFACE = "web";
+/** Inside quiet hours at `now`, and the instant they end; null when there are none or it is not quiet. */
+export declare function quietUntil(settings: NotificationSettings, now: Date, timezone: string): Date | null;
+/**
+ * Tell the owner something. Writes the row, routes it, and never throws for
+ * a channel's sake: a message with nowhere to go is a row with `error`.
+ * Throws only for a malformed message, which is the caller's bug.
+ */
+export declare function notifyOwner(db: Queryable, deps: NotifyDeps, message: OwnerMessage): Promise<NotifyResult>;
+/** What one tick did. */
+export interface NotificationsTickResult {
+    escalated: number;
+    endOfDay: number;
+    failed: number;
+}
+/**
+ * The later half of routing: runs on the gateway's 60-second loop.
+ *
+ * 1. Quiet hours: a `now` row that falls due while it is quiet (and is not an
+ *    approval or a question) waits for the end of them.
+ * 2. Escalation: a `now` row shown on the dashboard and not seen, or held
+ *    through quiet hours, goes to its channel.
+ * 3. End of the day: every held `today` row goes out as one message.
+ */
+export declare function notificationsTick(db: Queryable, deps: NotifyDeps, now?: Date): Promise<NotificationsTickResult>;
+//# sourceMappingURL=notify.d.ts.map

package/packages/core/dist/notifications/notify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../../src/notifications/notify.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAiB7C,OAAO,EAKL,KAAK,oBAAoB,EAEzB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,YAAY,EAElB,MAAM,YAAY,CAAC;AAEpB,yFAAyF;AACzF,eAAO,MAAM,iBAAiB,QAAc,CAAC;AAE7C,8FAA8F;AAC9F,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,oEAAoE;AACpE,eAAO,MAAM,gBAAgB,uFAAuF,CAAC;AAErH,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAYvC,0GAA0G;AAC1G,wBAAgB,UAAU,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAOnG;AA0FD;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CA4F/G;AAED,yBAAyB;AACzB,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,GAAE,IAAiC,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAsEjJ"}

package/packages/core/dist/notifications/notify.js

@@ -0,0 +1,263 @@
+/**
+ * The one call that reaches the owner, and the tick that keeps its promises
+ * (docs/notifications.md).
+ *
+ * `notifyOwner` writes the row and routes it:
+ *
+ *   now     the owner is on the dashboard → shown there; if nobody has seen it
+ *           in ten minutes, the default channel anyway. Away → the default
+ *           channel at once. Quiet hours hold it until they end, except
+ *           approvals and questions.
+ *   today   held until the end of the owner's day, then one message for all.
+ *   digest  stored; the recap reads it.
+ *
+ * `notificationsTick` does the later half: escalations, the end of quiet
+ * hours, the end of the day. Every transition is one UPDATE guarded by the
+ * state it leaves, so two ticks never send one row twice.
+ */
+import { getOwnerProfile } from '../onboarding/store.js';
+import { scrubText } from '../secrets/scrub.js';
+import { isKnownTimezone, localDateString, localMinutesOfDay, minutesOfLocalTime, nextLocalTime, timezoneFromEnv, } from '../time.js';
+import { channelFor, deliverTo } from './channels.js';
+import { NOTIFICATION_COLUMNS, presentSurfaces, readNotificationSettings, toNotification, } from './store.js';
+import { ALWAYS_REACH, NOTIFICATION_KINDS, NOTIFICATION_URGENCIES, } from './types.js';
+/** A `now` message shown on the dashboard goes to the channel after this long unseen. */
+export const ESCALATE_AFTER_MS = 10 * 60_000;
+/** The rate rule: more than this many fires of one key in an hour lowers `now` to `today`. */
+export const RATE_LIMIT_PER_HOUR = 3;
+/** Said once, on the title, when the rate rule lowers a message. */
+export const LOWERED_SENTENCE = 'This came up more than three times in an hour, so it waits for the end of the day.';
+/** The surface whose presence means "shown on the dashboard". */
+export const DASHBOARD_SURFACE = 'web';
+async function ownerTimezone(db, deps) {
+    try {
+        const profile = await getOwnerProfile(db);
+        if (profile.timezone && isKnownTimezone(profile.timezone))
+            return profile.timezone.trim();
+    }
+    catch {
+        // No owner row yet is not a reason to lose a message.
+    }
+    return deps.timezone ?? timezoneFromEnv();
+}
+/** Inside quiet hours at `now`, and the instant they end; null when there are none or it is not quiet. */
+export function quietUntil(settings, now, timezone) {
+    if (!settings.quietStart || !settings.quietEnd)
+        return null;
+    const start = minutesOfLocalTime(settings.quietStart);
+    const end = minutesOfLocalTime(settings.quietEnd);
+    const at = localMinutesOfDay(now, timezone);
+    const quiet = start < end ? at >= start && at < end : at >= start || at < end;
+    return quiet ? nextLocalTime(now, timezone, settings.quietEnd) : null;
+}
+function route(message, ctx) {
+    const always = ALWAYS_REACH.has(message.kind);
+    if (!always && ctx.settings.perKind[message.kind] === 'off')
+        return { state: 'stored' };
+    if (message.urgency === 'digest')
+        return { state: 'stored' };
+    if (message.urgency === 'today') {
+        return { state: 'held', dueAt: nextLocalTime(ctx.now, ctx.timezone, ctx.settings.endOfDay) };
+    }
+    if (ctx.onDashboard) {
+        return { state: 'shown', dueAt: new Date(ctx.now.getTime() + ESCALATE_AFTER_MS), channel: 'dashboard' };
+    }
+    const quiet = always ? null : quietUntil(ctx.settings, ctx.now, ctx.timezone);
+    if (quiet)
+        return { state: 'held', dueAt: quiet };
+    return { state: 'deliver' };
+}
+function checkMessage(message) {
+    if (!NOTIFICATION_KINDS.includes(message.kind)) {
+        throw new Error(`"${String(message.kind)}" is not a kind of notification`);
+    }
+    if (!NOTIFICATION_URGENCIES.includes(message.urgency)) {
+        throw new Error(`"${String(message.urgency)}" is not an urgency (now, today or digest)`);
+    }
+    if (typeof message.title !== 'string' || message.title.trim() === '')
+        throw new Error('a notification needs a title');
+    if (message.link && (typeof message.link.route !== 'string' || !message.link.route.startsWith('#/'))) {
+        throw new Error('a notification link is a dashboard route, like #/chat/…');
+    }
+}
+function toDeliverable(row) {
+    return {
+        id: row.id,
+        kind: row.kind,
+        urgency: row.urgency,
+        title: row.title,
+        ...(row.text ? { text: row.text } : {}),
+        ...(row.link ? { link: { route: row.link } } : {}),
+        ...(row.offers.length > 0 ? { offers: row.offers } : {}),
+        ...(row.dedupeKey ? { dedupeKey: row.dedupeKey } : {}),
+        ...(row.agentId ? { agentId: row.agentId } : {}),
+        ...(row.pluginId ? { pluginId: row.pluginId } : {}),
+        ...(row.actionId ? { actionId: row.actionId } : {}),
+    };
+}
+/**
+ * Send one claimed row (`state = 'sending'`) and write what came of it. A
+ * channel that refuses or throws is written as `error`; nothing is thrown.
+ */
+async function sendClaimed(db, row, settings, now) {
+    const kind = await channelFor(settings, row.kind);
+    if (kind === 'off') {
+        await db.query(`update core.owner_notifications set state = 'stored', updated_at = $2 where id = $1 and state = 'sending'`, [row.id, now]);
+        return { state: 'stored', channel: null, error: null };
+    }
+    const outcome = kind === null ? { ok: false, error: 'no channel' } : await deliverTo(kind, toDeliverable(row));
+    if (outcome.ok) {
+        await db.query(`update core.owner_notifications set state = 'sent', channel = $2, sent_at = $3, error = null, updated_at = $3
+        where id = $1 and state = 'sending'`, [row.id, kind, now]);
+        return { state: 'sent', channel: kind, error: null };
+    }
+    await db.query(`update core.owner_notifications set state = 'failed', channel = $2, error = $3, updated_at = $4
+      where id = $1 and state = 'sending'`, [row.id, kind, outcome.error, now]);
+    return { state: 'failed', channel: kind, error: outcome.error };
+}
+/**
+ * Tell the owner something. Writes the row, routes it, and never throws for
+ * a channel's sake: a message with nowhere to go is a row with `error`.
+ * Throws only for a malformed message, which is the caller's bug.
+ */
+export async function notifyOwner(db, deps, message) {
+    checkMessage(message);
+    const now = deps.now?.() ?? new Date();
+    const timezone = await ownerTimezone(db, deps);
+    const settings = await readNotificationSettings(db);
+    const always = ALWAYS_REACH.has(message.kind);
+    const dedupeKey = message.dedupeKey?.trim() || null;
+    // What leaves the machine on a push channel is scrubbed like everything else.
+    const baseTitle = scrubText(message.title.trim().replace(/\s*\n\s*/g, ' '));
+    const text = message.text?.trim() ? scrubText(message.text.trim()) : null;
+    // The unsent row this key already has, if any: it is updated, not repeated.
+    let existing = null;
+    let fires = 0;
+    if (dedupeKey) {
+        const { rows } = await db.query(`select ${NOTIFICATION_COLUMNS} from core.owner_notifications
+        where dedupe_key = $1 and sent_at is null and state in ('shown', 'held', 'stored', 'failed')
+        order by created_at desc limit 1`, [dedupeKey]);
+        existing = rows[0] ? toNotification(rows[0]) : null;
+        const counted = await db.query(`select coalesce(sum(fired_count), 0)::int as n from core.owner_notifications
+        where dedupe_key = $1 and updated_at > $2`, [dedupeKey, new Date(now.getTime() - 3_600_000)]);
+        fires = Number(counted.rows[0]?.n ?? 0);
+    }
+    // The rate rule. Approvals and questions are never lowered.
+    let urgency = message.urgency;
+    let lowered = existing?.lowered ?? false;
+    if (!always && urgency === 'now' && dedupeKey && (lowered || fires + 1 > RATE_LIMIT_PER_HOUR)) {
+        urgency = 'today';
+        lowered = true;
+    }
+    const title = lowered ? `${baseTitle} ${LOWERED_SENTENCE}` : baseTitle;
+    const onDashboard = (await presentSurfaces(db, now)).includes(DASHBOARD_SURFACE);
+    let next = route({ kind: message.kind, urgency }, { now, timezone, settings, onDashboard });
+    // A repeat shown on the dashboard keeps the clock it started, unless the
+    // owner had already seen the earlier one: then the new content is unseen.
+    if (next.state === 'shown' && existing?.state === 'shown' && existing.seenAt === null && existing.dueAt) {
+        next = { ...next, dueAt: new Date(existing.dueAt) };
+    }
+    const state = next.state === 'deliver' ? 'sending' : next.state;
+    const dueAt = 'dueAt' in next ? next.dueAt : null;
+    const channel = next.state === 'shown' ? 'dashboard' : null;
+    const offers = JSON.stringify(message.offers ?? []);
+    let row;
+    if (existing) {
+        const { rows } = await db.query(`update core.owner_notifications
+          set urgency = $2, title = $3, text = $4, link = $5, offers = $6::jsonb, agent_id = coalesce($7, agent_id),
+              plugin_id = coalesce($8, plugin_id), action_id = coalesce($9::uuid, action_id), state = $10, due_at = $11,
+              channel = $12, fired_count = fired_count + 1, lowered = $13, seen_at = null, error = null, updated_at = $14
+        where id = $1 and sent_at is null and state in ('shown', 'held', 'stored', 'failed')
+        returning ${NOTIFICATION_COLUMNS}`, [existing.id, urgency, title, text, message.link?.route ?? null, offers, message.agentId ?? null,
+            message.pluginId ?? null, message.actionId ?? null, state, dueAt, channel, lowered, now]);
+        if (rows[0])
+            row = toNotification(rows[0]);
+        else
+            existing = null; // Sent between the read and the write: this is a new message after all.
+    }
+    if (!existing) {
+        const { rows } = await db.query(`insert into core.owner_notifications
+         (kind, urgency, title, text, link, offers, dedupe_key, agent_id, plugin_id, action_id, state, due_at, channel,
+          lowered, created_at, updated_at)
+       values ($1, $2, $3, $4, $5, $6::jsonb, $7, $8, $9, $10::uuid, $11, $12, $13, $14, $15, $15)
+       returning ${NOTIFICATION_COLUMNS}`, [message.kind, urgency, title, text, message.link?.route ?? null, offers, dedupeKey, message.agentId ?? null,
+            message.pluginId ?? null, message.actionId ?? null, state, dueAt, channel, lowered, now]);
+        row = toNotification(rows[0]);
+    }
+    row = row;
+    const result = {
+        id: row.id,
+        state: row.state,
+        channel: row.channel,
+        error: null,
+        deduped: existing !== null,
+        lowered,
+    };
+    if (row.state !== 'sending')
+        return result;
+    const sent = await sendClaimed(db, row, settings, now);
+    return { ...result, ...sent };
+}
+/**
+ * The later half of routing: runs on the gateway's 60-second loop.
+ *
+ * 1. Quiet hours: a `now` row that falls due while it is quiet (and is not an
+ *    approval or a question) waits for the end of them.
+ * 2. Escalation: a `now` row shown on the dashboard and not seen, or held
+ *    through quiet hours, goes to its channel.
+ * 3. End of the day: every held `today` row goes out as one message.
+ */
+export async function notificationsTick(db, deps, now = deps.now?.() ?? new Date()) {
+    const timezone = await ownerTimezone(db, deps);
+    const settings = await readNotificationSettings(db);
+    const outcome = { escalated: 0, endOfDay: 0, failed: 0 };
+    const quiet = quietUntil(settings, now, timezone);
+    if (quiet) {
+        await db.query(`update core.owner_notifications set state = 'held', due_at = $2, updated_at = $1
+        where urgency = 'now' and due_at <= $1 and acted_at is null and kind not in ('approval', 'question')
+          and ((state = 'shown' and seen_at is null) or state = 'held')`, [now, quiet]);
+    }
+    const { rows: claimed } = await db.query(`update core.owner_notifications set state = 'sending', updated_at = $1
+      where urgency = 'now' and due_at <= $1 and acted_at is null
+        and ((state = 'shown' and seen_at is null) or state = 'held')
+      returning ${NOTIFICATION_COLUMNS}`, [now]);
+    for (const raw of claimed) {
+        const sent = await sendClaimed(db, toNotification(raw), settings, now);
+        if (sent.state === 'sent')
+            outcome.escalated += 1;
+        if (sent.state === 'failed')
+            outcome.failed += 1;
+    }
+    // Held for the end of the day but already dealt with on the dashboard.
+    await db.query(`update core.owner_notifications set state = 'stored', updated_at = $1
+      where state = 'held' and urgency = 'today' and acted_at is not null`, [now]);
+    const { rows: today } = await db.query(`update core.owner_notifications set state = 'sending', updated_at = $1
+      where state = 'held' and urgency = 'today' and due_at <= $1 and acted_at is null
+      returning ${NOTIFICATION_COLUMNS}`, [now]);
+    if (today.length > 0) {
+        const rows = today.map(toNotification).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+        const kind = await channelFor(settings);
+        const message = {
+            id: `today:${localDateString(now, timezone)}`,
+            kind: 'recap',
+            urgency: 'today',
+            title: `Today, ${rows.length} ${rows.length === 1 ? 'thing' : 'things'}:`,
+            text: rows.map((r) => `- ${r.agentId ?? r.pluginId ?? 'buddi'}: ${r.title}`).join('\n'),
+            parts: rows.map(toDeliverable),
+        };
+        const answer = kind === null || kind === 'off' ? { ok: false, error: 'no channel' } : await deliverTo(kind, message);
+        const ids = rows.map((r) => r.id);
+        if (answer.ok) {
+            await db.query(`update core.owner_notifications set state = 'sent', channel = $2, sent_at = $3, error = null, updated_at = $3
+          where id = any($1::uuid[]) and state = 'sending'`, [ids, kind, now]);
+            outcome.endOfDay = rows.length;
+        }
+        else {
+            await db.query(`update core.owner_notifications set state = 'failed', channel = $2, error = $3, updated_at = $4
+          where id = any($1::uuid[]) and state = 'sending'`, [ids, kind === 'off' ? null : kind, answer.error, now]);
+            outcome.failed += rows.length;
+        }
+    }
+    return outcome;
+}
+//# sourceMappingURL=notify.js.map

package/packages/core/dist/notifications/notify.js.map

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

package/packages/core/dist/notifications/store.d.ts

@@ -0,0 +1,50 @@
+import type { Queryable } from '../owner.js';
+import { type NotificationSettings, type OwnerNotification } from './types.js';
+/** "Present" is active on some surface within this long. */
+export declare const PRESENCE_WINDOW_MS: number;
+/** When the day's held items go out when the owner has not said. */
+export declare const DEFAULT_END_OF_DAY = "18:00";
+export declare const DEFAULT_NOTIFICATION_SETTINGS: NotificationSettings;
+export declare const NOTIFICATION_COLUMNS: string;
+export declare function toNotification(row: Record<string, any>): OwnerNotification;
+/** The newest first; at most 100. */
+export declare function listNotifications(db: Queryable, opts?: {
+    limit?: number;
+}): Promise<OwnerNotification[]>;
+/** One row, or null. */
+export declare function getNotification(db: Queryable, id: string): Promise<OwnerNotification | null>;
+/** The `digest` rows written since `since`, oldest first: what the recap may read. */
+export declare function listDigestNotifications(db: Queryable, since: Date): Promise<OwnerNotification[]>;
+/**
+ * The owner saw it: the dashboard drew it, or they opened its link. The first
+ * time counts; a row seen before it escalated never escalates. False when
+ * there is no such row.
+ */
+export declare function markSeen(db: Queryable, id: string, now?: Date): Promise<boolean>;
+/** The owner did what it asked. Acted implies seen. */
+export declare function markActed(db: Queryable, id: string, now?: Date): Promise<boolean>;
+/** Every row carrying this dedupe key is acted on: the thing it asked about was decided. */
+export declare function markActedForKey(db: Queryable, key: string, now?: Date): Promise<number>;
+/** Every row about this approval is acted on: the owner decided it, wherever. */
+export declare function markActedForAction(db: Queryable, actionId: string, now?: Date): Promise<number>;
+/** A surface says the owner is there (`active`) or has left it (`away`). */
+export declare function presenceTouch(db: Queryable, surface: string, now?: Date, state?: 'active' | 'away'): Promise<void>;
+/** The surfaces the owner is active on now: within two minutes, and not away since. */
+export declare function presentSurfaces(db: Queryable, now?: Date): Promise<string[]>;
+/** Is the owner active anywhere? Advisory: it picks where a message goes first, never whether. */
+export declare function ownerPresent(db: Queryable, now?: Date): Promise<boolean>;
+export declare function readNotificationSettings(db: Queryable): Promise<NotificationSettings>;
+/**
+ * Check a whole settings value the page sent. Returns the settings to store,
+ * or the sentence that says what is wrong.
+ */
+export declare function parseNotificationSettings(input: unknown): {
+    ok: true;
+    settings: NotificationSettings;
+} | {
+    ok: false;
+    message: string;
+};
+/** Replace the settings, whole. */
+export declare function writeNotificationSettings(db: Queryable, settings: NotificationSettings): Promise<void>;
+//# sourceMappingURL=store.d.ts.map

package/packages/core/dist/notifications/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/notifications/store.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AAEpB,4DAA4D;AAC5D,eAAO,MAAM,kBAAkB,QAAa,CAAC;AAE7C,oEAAoE;AACpE,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAE1C,eAAO,MAAM,6BAA6B,EAAE,oBAM3C,CAAC;AAKF,eAAO,MAAM,oBAAoB,QAE+C,CAAC;AAEjF,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,iBAAiB,CAwB1E;AAMD,qCAAqC;AACrC,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAOlH;AAED,wBAAwB;AACxB,wBAAsB,eAAe,CAAC,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAIlG;AAED,sFAAsF;AACtF,wBAAsB,uBAAuB,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAOtG;AAID;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAQlG;AAED,uDAAuD;AACvD,wBAAsB,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CASnG;AAED,4FAA4F;AAC5F,wBAAsB,eAAe,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CASzG;AAED,iFAAiF;AACjF,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CASjH;AAMD,4EAA4E;AAC5E,wBAAsB,aAAa,CACjC,EAAE,EAAE,SAAS,EACb,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,IAAiB,EACtB,KAAK,GAAE,QAAQ,GAAG,MAAiB,GAClC,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,uFAAuF;AACvF,wBAAsB,eAAe,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,GAAE,IAAiB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAQ9F;AAED,kGAAkG;AAClG,wBAAsB,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,GAAE,IAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAE1F;AAMD,wBAAsB,wBAAwB,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAqB3F;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,GACb;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,oBAAoB,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAqC/E;AAED,mCAAmC;AACnC,wBAAsB,yBAAyB,CAAC,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAS5G"}