@withbuddi/buddi 0.1.0-pre.16 → 0.1.0-pre.18

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

@@ -0,0 +1,48 @@
+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 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,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"}

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

@@ -0,0 +1,207 @@
+import { LOCAL_TIME } from '../time.js';
+import { ALWAYS_REACH, NOTIFICATION_KINDS, } from './types.js';
+/** "Present" is active on some surface within this long. */
+export const PRESENCE_WINDOW_MS = 2 * 60_000;
+/** When the day's held items go out when the owner has not said. */
+export const DEFAULT_END_OF_DAY = '18:00';
+export const DEFAULT_NOTIFICATION_SETTINGS = {
+    defaultChannel: null,
+    perKind: {},
+    quietStart: null,
+    quietEnd: null,
+    endOfDay: DEFAULT_END_OF_DAY,
+};
+const iso = (v) => v === null || v === undefined ? null : v instanceof Date ? v.toISOString() : String(v);
+export const NOTIFICATION_COLUMNS = 'id, kind, urgency, title, text, link, offers, dedupe_key, agent_id, plugin_id, action_id, state, due_at, ' +
+    'channel, fired_count, lowered, created_at, sent_at, seen_at, acted_at, error';
+export function toNotification(row) {
+    return {
+        id: String(row.id),
+        kind: row.kind,
+        urgency: row.urgency,
+        title: row.title,
+        text: row.text ?? null,
+        link: row.link ?? null,
+        offers: Array.isArray(row.offers) ? row.offers : [],
+        dedupeKey: row.dedupe_key ?? null,
+        agentId: row.agent_id ?? null,
+        pluginId: row.plugin_id ?? null,
+        actionId: row.action_id === null || row.action_id === undefined ? null : String(row.action_id),
+        state: row.state,
+        dueAt: iso(row.due_at),
+        channel: row.channel ?? null,
+        firedCount: Number(row.fired_count ?? 1),
+        lowered: row.lowered === true,
+        createdAt: iso(row.created_at),
+        sentAt: iso(row.sent_at),
+        seenAt: iso(row.seen_at),
+        actedAt: iso(row.acted_at),
+        error: row.error ?? null,
+    };
+}
+/* ------------------------------------------------------------------ *
+ * Reads and marks
+ * ------------------------------------------------------------------ */
+/** The newest first; at most 100. */
+export async function listNotifications(db, opts = {}) {
+    const limit = Math.max(1, Math.min(100, Math.floor(opts.limit ?? 20) || 20));
+    const { rows } = await db.query(`select ${NOTIFICATION_COLUMNS} from core.owner_notifications order by created_at desc, id limit $1`, [limit]);
+    return rows.map(toNotification);
+}
+/** One row, or null. */
+export async function getNotification(db, id) {
+    if (!UUID.test(id))
+        return null;
+    const { rows } = await db.query(`select ${NOTIFICATION_COLUMNS} from core.owner_notifications where id = $1`, [id]);
+    return rows[0] ? toNotification(rows[0]) : null;
+}
+/** The `digest` rows written since `since`, oldest first: what the recap may read. */
+export async function listDigestNotifications(db, since) {
+    const { rows } = await db.query(`select ${NOTIFICATION_COLUMNS} from core.owner_notifications
+      where urgency = 'digest' and created_at >= $1 order by created_at, id`, [since]);
+    return rows.map(toNotification);
+}
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/**
+ * 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 async function markSeen(db, id, now = new Date()) {
+    if (!UUID.test(id))
+        return false;
+    const { rows } = await db.query(`update core.owner_notifications set seen_at = coalesce(seen_at, $2), updated_at = $2
+      where id = $1 returning id`, [id, now]);
+    return rows.length > 0;
+}
+/** The owner did what it asked. Acted implies seen. */
+export async function markActed(db, id, now = new Date()) {
+    if (!UUID.test(id))
+        return false;
+    const { rows } = await db.query(`update core.owner_notifications
+        set acted_at = coalesce(acted_at, $2), seen_at = coalesce(seen_at, $2), updated_at = $2
+      where id = $1 returning id`, [id, now]);
+    return rows.length > 0;
+}
+/** Every row about this approval is acted on: the owner decided it, wherever. */
+export async function markActedForAction(db, actionId, now = new Date()) {
+    if (!UUID.test(actionId))
+        return 0;
+    const { rows } = await db.query(`update core.owner_notifications
+        set acted_at = coalesce(acted_at, $2), seen_at = coalesce(seen_at, $2), updated_at = $2
+      where action_id = $1 and acted_at is null returning id`, [actionId, now]);
+    return rows.length;
+}
+/* ------------------------------------------------------------------ *
+ * Presence
+ * ------------------------------------------------------------------ */
+/** A surface says the owner is there (`active`) or has left it (`away`). */
+export async function presenceTouch(db, surface, now = new Date(), state = 'active') {
+    if (state === 'active') {
+        await db.query(`insert into core.owner_presence (surface, last_active_at, away_at, updated_at) values ($1, $2, null, $2)
+       on conflict (surface) do update set last_active_at = excluded.last_active_at, away_at = null, updated_at = $2`, [surface, now]);
+    }
+    else {
+        await db.query(`insert into core.owner_presence (surface, last_active_at, away_at, updated_at) values ($1, $2, $2, $2)
+       on conflict (surface) do update set away_at = $2, updated_at = $2`, [surface, now]);
+    }
+}
+/** The surfaces the owner is active on now: within two minutes, and not away since. */
+export async function presentSurfaces(db, now = new Date()) {
+    const { rows } = await db.query(`select surface from core.owner_presence
+      where last_active_at > $1 and (away_at is null or away_at < last_active_at)
+      order by surface`, [new Date(now.getTime() - PRESENCE_WINDOW_MS)]);
+    return rows.map((r) => String(r.surface));
+}
+/** Is the owner active anywhere? Advisory: it picks where a message goes first, never whether. */
+export async function ownerPresent(db, now = new Date()) {
+    return (await presentSurfaces(db, now)).length > 0;
+}
+/* ------------------------------------------------------------------ *
+ * Settings
+ * ------------------------------------------------------------------ */
+export async function readNotificationSettings(db) {
+    const { rows } = await db.query(`select default_channel, per_kind, quiet_start, quiet_end, end_of_day from core.notification_settings where id`);
+    const row = rows[0];
+    if (!row)
+        return { ...DEFAULT_NOTIFICATION_SETTINGS, perKind: {} };
+    const perKind = {};
+    if (row.per_kind && typeof row.per_kind === 'object') {
+        for (const [k, v] of Object.entries(row.per_kind)) {
+            if (NOTIFICATION_KINDS.includes(k) && typeof v === 'string' && v !== '') {
+                perKind[k] = v;
+            }
+        }
+    }
+    return {
+        defaultChannel: row.default_channel ?? null,
+        perKind,
+        quietStart: row.quiet_start ?? null,
+        quietEnd: row.quiet_end ?? null,
+        endOfDay: row.end_of_day ?? DEFAULT_END_OF_DAY,
+    };
+}
+/**
+ * Check a whole settings value the page sent. Returns the settings to store,
+ * or the sentence that says what is wrong.
+ */
+export function parseNotificationSettings(input) {
+    if (!input || typeof input !== 'object' || Array.isArray(input))
+        return { ok: false, message: 'Settings must be an object.' };
+    const o = input;
+    const optionalTime = (v, name) => {
+        if (v === undefined || v === null || v === '')
+            return null;
+        if (typeof v !== 'string' || !LOCAL_TIME.test(v.trim()))
+            return new Error(`${name} must be a time like 22:00.`);
+        return v.trim();
+    };
+    const defaultChannel = o.defaultChannel === undefined || o.defaultChannel === null || o.defaultChannel === ''
+        ? null
+        : typeof o.defaultChannel === 'string' ? o.defaultChannel.trim() : undefined;
+    if (defaultChannel === undefined)
+        return { ok: false, message: 'defaultChannel must be a channel or empty.' };
+    const perKind = {};
+    if (o.perKind !== undefined && o.perKind !== null) {
+        if (typeof o.perKind !== 'object' || Array.isArray(o.perKind))
+            return { ok: false, message: 'perKind must be an object.' };
+        for (const [k, v] of Object.entries(o.perKind)) {
+            if (!NOTIFICATION_KINDS.includes(k))
+                return { ok: false, message: `${k} is not a kind of notification.` };
+            if (v === null || v === '' || v === 'default')
+                continue;
+            if (typeof v !== 'string')
+                return { ok: false, message: `perKind.${k} must be a channel, "default" or "off".` };
+            if (v === 'off' && ALWAYS_REACH.has(k)) {
+                return { ok: false, message: 'Approvals and questions cannot be turned off.' };
+            }
+            perKind[k] = v;
+        }
+    }
+    const quietStart = optionalTime(o.quietStart, 'Quiet hours start');
+    if (quietStart instanceof Error)
+        return { ok: false, message: quietStart.message };
+    const quietEnd = optionalTime(o.quietEnd, 'Quiet hours end');
+    if (quietEnd instanceof Error)
+        return { ok: false, message: quietEnd.message };
+    if ((quietStart === null) !== (quietEnd === null))
+        return { ok: false, message: 'Quiet hours need both a start and an end.' };
+    if (quietStart !== null && quietStart === quietEnd)
+        return { ok: false, message: 'Quiet hours cannot start and end at the same time.' };
+    const endOfDay = optionalTime(o.endOfDay, 'The end of the day');
+    if (endOfDay instanceof Error)
+        return { ok: false, message: endOfDay.message };
+    return {
+        ok: true,
+        settings: { defaultChannel, perKind, quietStart, quietEnd, endOfDay: endOfDay ?? DEFAULT_END_OF_DAY },
+    };
+}
+/** Replace the settings, whole. */
+export async function writeNotificationSettings(db, settings) {
+    await db.query(`insert into core.notification_settings (id, default_channel, per_kind, quiet_start, quiet_end, end_of_day, updated_at)
+     values (true, $1, $2::jsonb, $3, $4, $5, now())
+     on conflict (id) do update set default_channel = excluded.default_channel, per_kind = excluded.per_kind,
+       quiet_start = excluded.quiet_start, quiet_end = excluded.quiet_end, end_of_day = excluded.end_of_day,
+       updated_at = now()`, [settings.defaultChannel, JSON.stringify(settings.perKind), settings.quietStart, settings.quietEnd, settings.endOfDay]);
+}
+//# sourceMappingURL=store.js.map

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

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

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

@@ -0,0 +1,136 @@
+/**
+ * Reaching the owner: the message, the record, the channel (docs/notifications.md).
+ *
+ * A surface is where the owner talks to buddi; a channel is how buddi reaches
+ * them when they are not looking. Core owns "reach the owner"; a channel only
+ * carries. Types only.
+ */
+import type { Offer } from '../offers/types.js';
+export declare const NOTIFICATION_KINDS: readonly ["approval", "question", "watcher", "reminder", "failure", "recap", "plugin"];
+export type NotificationKind = (typeof NOTIFICATION_KINDS)[number];
+export declare const NOTIFICATION_URGENCIES: readonly ["now", "today", "digest"];
+export type NotificationUrgency = (typeof NOTIFICATION_URGENCIES)[number];
+/** Kinds the owner asked for by starting the run: never quiet, never off. */
+export declare const ALWAYS_REACH: ReadonlySet<NotificationKind>;
+/** The one call's argument. */
+export interface OwnerMessage {
+    kind: NotificationKind;
+    urgency: NotificationUrgency;
+    /** One line: the whole message on a small channel. */
+    title: string;
+    /** A few lines, markdown-light. */
+    text?: string;
+    /** A dashboard place: `#/chat/…`, `#/settings/…`. */
+    link?: {
+        route: string;
+    };
+    /** Offers a report already stored; a channel that has buttons draws them. */
+    offers?: readonly Offer[];
+    /** "This thing, again": an unsent row with the same key is updated, not duplicated. */
+    dedupeKey?: string;
+    agentId?: string;
+    /** Stamped by the host for a plugin's call; a plugin never sets it. */
+    pluginId?: string;
+    /** Core only: the approval this message asks about, drawn as a card where a channel can. */
+    actionId?: string;
+}
+/** Where a row is in its life. See migration 043. */
+export type NotificationState = 'shown' | 'held' | 'stored' | 'sending' | 'sent' | 'failed';
+/** One row of `core.owner_notifications`. */
+export interface OwnerNotification {
+    id: string;
+    kind: NotificationKind;
+    urgency: NotificationUrgency;
+    title: string;
+    text: string | null;
+    link: string | null;
+    offers: Offer[];
+    dedupeKey: string | null;
+    agentId: string | null;
+    pluginId: string | null;
+    actionId: string | null;
+    state: NotificationState;
+    dueAt: string | null;
+    channel: string | null;
+    firedCount: number;
+    lowered: boolean;
+    createdAt: string;
+    sentAt: string | null;
+    seenAt: string | null;
+    actedAt: string | null;
+    error: string | null;
+}
+/** What a channel is handed: the message as stored, with its row's id. */
+export interface DeliverableMessage extends OwnerMessage {
+    /** The row's id; `today:<date>` for the end-of-day message, which is many rows. */
+    id: string;
+}
+/** A way to reach the owner, registered by whoever owns the transport. */
+export interface OwnerChannel {
+    /** `telegram.chat`, `local.notification`, `email.self`, `<plugin>.<what>`. Never `dashboard`. */
+    kind: string;
+    /**
+     * What Settings shows. Null, or a promise of null, when the channel has
+     * nothing to carry a message through now (a plugin's with no account): it
+     * is then neither listed nor picked.
+     */
+    describe(): ChannelDescription | null | Promise<ChannelDescription | null>;
+    can: {
+        offers: boolean;
+        attachments: boolean;
+        markdown: boolean;
+    };
+    /**
+     * Which channel is the default when the owner picked none: the lowest
+     * first, then the order they were registered. Absent is 100.
+     */
+    priority?: number;
+    /**
+     * `{ id }` once the transport took it. `'refused'`, or `{ refused }` with a
+     * sentence saying why, when it did not: the reason is what the row's
+     * `error` says.
+     */
+    deliver(message: DeliverableMessage): Promise<ChannelAnswer>;
+}
+/** A channel as Settings names it: "Telegram, @your_bot". */
+export interface ChannelDescription {
+    label: string;
+    where?: string;
+}
+/** What a channel's `deliver` answers. */
+export type ChannelAnswer = {
+    id: string;
+} | 'refused' | {
+    refused: string;
+};
+/** The Notifications page's values, defaults filled in. */
+export interface NotificationSettings {
+    /** A channel kind, or null for the first one registered. */
+    defaultChannel: string | null;
+    /** kind → a channel kind, or `off`. Approvals and questions are never off. */
+    perKind: Partial<Record<NotificationKind, string>>;
+    /** `HH:MM`, the owner's clock; both or neither. */
+    quietStart: string | null;
+    quietEnd: string | null;
+    /** `HH:MM`; when the day's held items go out. */
+    endOfDay: string;
+}
+/** What one call did. */
+export interface NotifyResult {
+    id: string;
+    state: NotificationState;
+    /** The channel kind it went to, `dashboard` when shown there, else null. */
+    channel: string | null;
+    error: string | null;
+    /** An unsent row with the same key took it. */
+    deduped: boolean;
+    /** The rate rule lowered it from `now` to `today`. */
+    lowered: boolean;
+}
+export interface NotifyDeps {
+    now?: () => Date;
+    /** The zone when the owner profile names none. Defaults to `BUDDI_TZ`, else New York. */
+    timezone?: string;
+    log?: (line: string) => void;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

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

@@ -0,0 +1,5 @@
+export const NOTIFICATION_KINDS = ['approval', 'question', 'watcher', 'reminder', 'failure', 'recap', 'plugin'];
+export const NOTIFICATION_URGENCIES = ['now', 'today', 'digest'];
+/** Kinds the owner asked for by starting the run: never quiet, never off. */
+export const ALWAYS_REACH = new Set(['approval', 'question']);
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/notifications/types.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAU,CAAC;AAGzH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAU,CAAC;AAG1E,6EAA6E;AAC7E,MAAM,CAAC,MAAM,YAAY,GAAkC,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC"}

package/packages/core/dist/owner.js

@@ -1,5 +1,5 @@
 /**
- * Owner identity and surface pairing (ARCHITECTURE.md, "Owner and surface
+ * Owner identity and surface pairing (docs/architecture.md, "Owner and surface
  * authentication").
  *
  * There is exactly one installation owner. Surfaces establish *identity* — they

package/packages/core/dist/pages/__fixtures__/demo.js

@@ -1,7 +1,7 @@
 /**
  * The synthetic plugin the page engine is tested against.
  *
- * `docs/specs/plugin-pages.md` §7 step 1: the proof that the engine is generic
+ * `docs/plugin-pages.md` §7 item 1: the proof that the engine is generic
  * is a plugin that is not email using every component once. It ships two pages
  * — a rail place and a settings tab — a query per read and a tool per write,
  * and nothing behind them but constants, so the same fixture serves core's

package/packages/core/dist/pages.d.ts

@@ -1,7 +1,7 @@
 /**
  * Plugin pages — a plugin's screens, as data.
  *
- * `docs/specs/plugin-pages.md`. A plugin already tells the dashboard how to
+ * `docs/plugin-pages.md`. A plugin already tells the dashboard how to
  * *draw a tool result* (`views.ts`); this tells it how to draw a whole screen:
  * a rail entry, or a settings tab, made of a small fixed set of generic
  * components. The rules are the ones views already follow, and they are the
@@ -29,7 +29,7 @@
  * The component set is sized by what email and finance need and does not grow
  * to fit one plugin's wish. A plugin that needs free layout, custom styling or
  * client-side logic serves its own app through the developer proxy
- * (`docs/specs/developer.md`).
+ * (`docs/developer.md`).
  */
 import type { Pool } from 'pg';
 import { z, type ZodTypeAny } from 'zod';
@@ -147,7 +147,7 @@ export type ArgRef = ValueRef | {
  * open a chat the owner already has in their rail.
  *
  * `{ proposals: true }` is the second, as narrow: the owner's Proposals inbox
- * (docs/specs/learning.md), filtered to *this* plugin's rules. A plugin that
+ * (docs/learning.md), filtered to *this* plugin's rules. A plugin that
  * proposes policies through core has its proposals there, not on its own
  * page, and the only useful thing its page can say about them is where they
  * are. It names no plugin: the dashboard fills in the one drawing the page.
@@ -757,7 +757,7 @@ export declare const PAGE_POOL_ACQUIRE_MS = 5000;
  * Two things it does **not** cover, and they are honest limits rather than
  * bugs: a superuser-ish role can still call `pg_read_file` or
  * `pg_terminate_backend`, neither of which writes a row. The answer to those
- * is a Postgres role without the grant — see `docs/specs/plugin-pages.md` §8.
+ * is a Postgres role without the grant — see `docs/plugin-pages.md` §8.
  *
  * The wrapper holds the client, takes one per statement and always gives it
  * back; `connect()` throws, so a query never sees one and cannot open a

package/packages/core/dist/pages.js

@@ -814,7 +814,7 @@ async function connectWithin(pool, ms) {
  * Two things it does **not** cover, and they are honest limits rather than
  * bugs: a superuser-ish role can still call `pg_read_file` or
  * `pg_terminate_backend`, neither of which writes a row. The answer to those
- * is a Postgres role without the grant — see `docs/specs/plugin-pages.md` §8.
+ * is a Postgres role without the grant — see `docs/plugin-pages.md` §8.
  *
  * The wrapper holds the client, takes one per statement and always gives it
  * back; `connect()` throws, so a query never sees one and cannot open a

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

@@ -1,6 +1,6 @@
 /**
  * `@buddi/core/plugin`: what a plugin imports from core
- * (docs/specs/plugin-host-api.md §3).
+ * (docs/plugin-host-api.md §3).
  *
  * The contract's types, and the pure helpers a plugin needs beside `ctx.buddi`
  * — a date in the owner's zone, a hash, a page's file answer, a URL check.
@@ -36,5 +36,5 @@ export type { SurfaceProfile } from '../surfaces.js';
 export type { ArtifactKind, ArtifactSource } from '../artifacts/store.js';
 export type { ToolPermission } from '../actions/permissions.js';
 export type { MisfirePolicy } from '../scheduler/types.js';
-export type { AccountsArea, ApprovalsArea, BuddiHost, ClockArea, DbArea, DbResult, DbTransaction, DirArea, EnqueueRunInput, FileRow, FilesArea, HttpArea, HttpRequest, HttpResponse, MemoryArea, MemoryNote, OwnerArea, PagesArea, ProposalsArea, RegisterHost, ScheduleArea, SecretBinding, SecretDeliveryContext, SecretDestination, SecretListing, SecretRule, SecretUseOutcome, SecretUseResult, SecretsArea, } from '../host/types.js';
+export type { AccountsArea, ApprovalsArea, BuddiHost, ChannelsArea, ClockArea, DbArea, DbResult, DbTransaction, DirArea, EnqueueRunInput, FileRow, FilesArea, HttpArea, HttpRequest, HttpResponse, MemoryArea, MemoryNote, OwnerArea, PluginChannel, PluginChannelMessage, PluginOwnerMessage, PagesArea, ProposalsArea, RegisterHost, ScheduleArea, SecretBinding, SecretDeliveryContext, SecretDestination, SecretListing, SecretRule, SecretUseOutcome, SecretUseResult, SecretsArea, } from '../host/types.js';
 //# sourceMappingURL=index.d.ts.map

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

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

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

@@ -1,6 +1,6 @@
 /**
  * `@buddi/core/plugin`: what a plugin imports from core
- * (docs/specs/plugin-host-api.md §3).
+ * (docs/plugin-host-api.md §3).
  *
  * The contract's types, and the pure helpers a plugin needs beside `ctx.buddi`
  * — a date in the owner's zone, a hash, a page's file answer, a URL check.

package/packages/core/dist/plugin/search.d.ts

@@ -1,7 +1,7 @@
 /**
  * Who searches the web for an agent: the name of the owner's override and its
  * parser, and what one server-side search looks like when the runtime reports
- * it. Moved here from `@buddi/runtime` (docs/specs/plugin-host-api.md §3): the
+ * it. Moved here from `@buddi/runtime` (docs/plugin-host-api.md §3): the
  * runtime reads the override before a request is built, the web plugin reads
  * it to pick its backend and records the searches, and both now read it from
  * one place. Pure: names, a parser and types.

package/packages/core/dist/plugin/search.js

@@ -1,7 +1,7 @@
 /**
  * Who searches the web for an agent: the name of the owner's override and its
  * parser, and what one server-side search looks like when the runtime reports
- * it. Moved here from `@buddi/runtime` (docs/specs/plugin-host-api.md §3): the
+ * it. Moved here from `@buddi/runtime` (docs/plugin-host-api.md §3): the
  * runtime reads the override before a request is built, the web plugin reads
  * it to pick its backend and records the searches, and both now read it from
  * one place. Pure: names, a parser and types.

package/packages/core/dist/plugin/url.js

@@ -2,7 +2,7 @@
  * The address rules for reaching the web: what a URL may name before a socket
  * exists.
  *
- * Moved here from `@buddi/tool-web`'s `guard.ts` (docs/specs/plugin-host-api.md
+ * Moved here from `@buddi/tool-web`'s `guard.ts` (docs/plugin-host-api.md
  * §3) so a plugin can check a URL without importing another plugin: the browser
  * plugin was the first. Pure — a URL in, a verdict out, nothing resolved. The
  * half that resolves, `guardedLookup`, does I/O and lives with the `http` area

package/packages/core/dist/plugin/uses.d.ts

@@ -1,6 +1,6 @@
 /**
  * What a plugin declares it reaches in buddi beyond itself: the areas of
- * `ctx.buddi` that are not always present (docs/specs/plugin-host-api.md §5).
+ * `ctx.buddi` that are not always present (docs/plugin-host-api.md §5).
  *
  * Declared twice, on purpose. The manifest's `uses` is what `ctx.buddi` is
  * built from; `package.json`'s `buddi.uses` is what the install card reads,
@@ -11,7 +11,7 @@
  * Pure: names, the owner's words for each, and the comparisons.
  */
 /** Every area a plugin may declare. `files:library` is `files`, over the whole library. */
-export declare const PLUGIN_USES: readonly ["http", "accounts", "files", "files:library", "memory", "proposals", "schedule", "secrets"];
+export declare const PLUGIN_USES: readonly ["http", "accounts", "files", "files:library", "memory", "proposals", "schedule", "secrets", "owner:notify", "owner:channel"];
 export type PluginUse = (typeof PLUGIN_USES)[number];
 /**
  * The line the owner reads on the install card for each area, in the spec's

package/packages/core/dist/plugin/uses.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uses.d.ts","sourceRoot":"","sources":["../../src/plugin/uses.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,2FAA2F;AAC3F,eAAO,MAAM,WAAW,uGASd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAShE,CAAC;AAEF,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,SAAS,EAAE,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAiBlE;AAED,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,SAAS,EAAE,EAC5B,KAAK,EAAE,SAAS,SAAS,EAAE,GAC1B;IAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAAC,OAAO,EAAE,SAAS,EAAE,CAAA;CAAE,CAK9C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,SAAS,SAAS,EAAE,EAC9B,GAAG,EAAE,SAAS,SAAS,EAAE,GACxB,MAAM,GAAG,SAAS,CAQpB"}
+{"version":3,"file":"uses.d.ts","sourceRoot":"","sources":["../../src/plugin/uses.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,2FAA2F;AAC3F,eAAO,MAAM,WAAW,wIAWd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAWhE,CAAC;AAEF,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,SAAS,EAAE,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAiBlE;AAED,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,SAAS,EAAE,EAC5B,KAAK,EAAE,SAAS,SAAS,EAAE,GAC1B;IAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAAC,OAAO,EAAE,SAAS,EAAE,CAAA;CAAE,CAK9C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,SAAS,SAAS,EAAE,EAC9B,GAAG,EAAE,SAAS,SAAS,EAAE,GACxB,MAAM,GAAG,SAAS,CAQpB"}

package/packages/core/dist/plugin/uses.js

@@ -1,6 +1,6 @@
 /**
  * What a plugin declares it reaches in buddi beyond itself: the areas of
- * `ctx.buddi` that are not always present (docs/specs/plugin-host-api.md §5).
+ * `ctx.buddi` that are not always present (docs/plugin-host-api.md §5).
  *
  * Declared twice, on purpose. The manifest's `uses` is what `ctx.buddi` is
  * built from; `package.json`'s `buddi.uses` is what the install card reads,
@@ -20,6 +20,8 @@ export const PLUGIN_USES = [
     'proposals',
     'schedule',
     'secrets',
+    'owner:notify',
+    'owner:channel',
 ];
 /**
  * The line the owner reads on the install card for each area, in the spec's
@@ -35,6 +37,8 @@ export const PLUGIN_USE_WORDS = {
     proposals: 'proposes rules',
     schedule: 'starts agent runs by itself',
     secrets: 'fills secrets you bind to it',
+    'owner:notify': 'can send you messages when you are away',
+    'owner:channel': 'adds a way for buddi to reach you',
 };
 export function isPluginUse(value) {
     return typeof value === 'string' && PLUGIN_USES.includes(value);

package/packages/core/dist/plugin/uses.js.map

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