@withbuddi/buddi 0.1.0-pre.21 → 0.1.0-pre.23

package/packages/gateway/dist/tips/engine.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Which tip, if any, Home shows today (docs/dashboard.md, Home).
+ *
+ * Per rule the engine keeps the day its condition first held (`firstHeld`),
+ * the day it was last shown (`shownAt`), the day the owner put it off with ×
+ * (`laterAt`) and whether they said "Not this again" (`dismissed`). The rules:
+ *
+ * - at most one card a day: once a tip is shown on a day, no other shows that
+ *   day, and one put off or dismissed leaves the day empty;
+ * - a tip shows when its condition has held for `holdsForDays` and
+ *   `cooldownDays` have passed since it was last shown or put off; among
+ *   several, the one that has held longest, then the one first in `TIPS`;
+ * - never during first run, never while tips are off;
+ * - never a tip about a plugin that is not installed, unless its action
+ *   installs it;
+ * - a tip whose condition stops holding disappears, and its hold starts over;
+ * - dismissed is forever.
+ *
+ * Pure: state in, state out. `route.ts` reads and writes it under
+ * `core.web_settings` → `tips.state`.
+ */
+import type { Facts } from './facts.js';
+import type { TipAction, TipRule } from './rules.js';
+export interface TipRuleState {
+    firstHeld?: string;
+    shownAt?: string;
+    laterAt?: string;
+    dismissed?: boolean;
+    /** The day of "Not this again", when it was said since this was kept. */
+    dismissedAt?: string;
+}
+export type TipsState = Record<string, TipRuleState>;
+/** What Home draws. */
+export interface TipView {
+    id: string;
+    text: string;
+    action: TipAction;
+}
+/** `YYYY-MM-DD` on the owner's clock. */
+export declare function dayIn(at: Date, timezone: string): string;
+/** Whole days from `from` to `to`, both `YYYY-MM-DD`. */
+export declare function daysBetween(from: string, to: string): number;
+/**
+ * Today's tip, and the state to keep. The state changes when a hold starts or
+ * stops, and when a tip is picked for today.
+ */
+export declare function pickTip(rules: readonly TipRule[], facts: Facts, previous: TipsState, today: string): {
+    tip: TipView | null;
+    state: TipsState;
+};
+/** "Not this again": never again, until the Tips list brings it back. */
+export declare function dismissTip(previous: TipsState, id: string, today?: string): TipsState;
+/** "Bring back": the dismissal is forgotten; holds and cooldowns stay. */
+export declare function restoreTip(previous: TipsState, id: string): TipsState;
+export type TipStatus = 'today' | 'holding' | 'quiet' | 'dismissed' | 'shown';
+/** One row of the Tips list. */
+export interface TipListRow extends TipView {
+    status: TipStatus;
+    dismissedAt?: string;
+    holdsSince?: string;
+    shownAt?: string;
+}
+/**
+ * Every rule and where it stands, reading the state without changing it:
+ *
+ * - `today`: the engine would show it now and it has not been shown today;
+ * - `shown`: shown (or put off) today or within its cooldown;
+ * - `dismissed`: "Not this again";
+ * - `holding`: its condition holds, waiting its day;
+ * - `quiet`: its condition does not hold.
+ */
+export declare function listTips(rules: readonly TipRule[], facts: Facts, previous: TipsState, today: string): TipListRow[];
+/** ×: not today, and not before its cooldown has passed. */
+export declare function laterTip(previous: TipsState, id: string, today: string): TipsState;
+//# sourceMappingURL=engine.d.ts.map

package/packages/gateway/dist/tips/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/tips/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAErD,uBAAuB;AACvB,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,CAAC;CACnB;AAED,yCAAyC;AACzC,wBAAgB,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE5D;AAeD;;;GAGG;AACH,wBAAgB,OAAO,CACrB,KAAK,EAAE,SAAS,OAAO,EAAE,EACzB,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,SAAS,EACnB,KAAK,EAAE,MAAM,GACZ;IAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAyC3C;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAErF;AAED,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAMrE;AAED,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,CAAC;AAE9E,gCAAgC;AAChC,MAAM,WAAW,UAAW,SAAQ,OAAO;IACzC,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,CAwBlH;AAED,4DAA4D;AAC5D,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAElF"}

package/packages/gateway/dist/tips/engine.js

@@ -0,0 +1,135 @@
+/** `YYYY-MM-DD` on the owner's clock. */
+export function dayIn(at, timezone) {
+    try {
+        return new Intl.DateTimeFormat('en-CA', { timeZone: timezone, year: 'numeric', month: '2-digit', day: '2-digit' }).format(at);
+    }
+    catch {
+        return at.toISOString().slice(0, 10);
+    }
+}
+/** Whole days from `from` to `to`, both `YYYY-MM-DD`. */
+export function daysBetween(from, to) {
+    return Math.round((Date.parse(`${to}T00:00:00Z`) - Date.parse(`${from}T00:00:00Z`)) / 86_400_000);
+}
+function applies(rule, facts) {
+    if (rule.plugin && !facts.plugins.has(rule.plugin) && !rule.installs)
+        return false;
+    try {
+        return rule.when(facts);
+    }
+    catch {
+        return false;
+    }
+}
+function viewOf(rule) {
+    return { id: rule.id, text: rule.text, action: { ...rule.action } };
+}
+/**
+ * Today's tip, and the state to keep. The state changes when a hold starts or
+ * stops, and when a tip is picked for today.
+ */
+export function pickTip(rules, facts, previous, today) {
+    const state = {};
+    for (const [id, entry] of Object.entries(previous))
+        state[id] = { ...entry };
+    // Holds first, for every rule, so a hold keeps counting while another tip shows.
+    const holding = new Set();
+    for (const rule of rules) {
+        const entry = (state[rule.id] ??= {});
+        if (applies(rule, facts)) {
+            holding.add(rule.id);
+            if (!entry.firstHeld)
+                entry.firstHeld = today;
+        }
+        else {
+            delete entry.firstHeld;
+        }
+        if (Object.keys(entry).length === 0)
+            delete state[rule.id];
+    }
+    if (facts.firstRun)
+        return { tip: null, state };
+    // One card a day: today's, if there was one.
+    const todays = rules.find((rule) => state[rule.id]?.shownAt === today);
+    if (todays) {
+        const entry = state[todays.id];
+        const live = holding.has(todays.id) && !entry.dismissed && entry.laterAt !== today;
+        return { tip: live ? viewOf(todays) : null, state };
+    }
+    const ready = rules
+        .map((rule, index) => ({ rule, index, entry: state[rule.id] }))
+        .filter(({ rule, entry }) => {
+        if (!entry || !holding.has(rule.id) || entry.dismissed || !entry.firstHeld)
+            return false;
+        if (daysBetween(entry.firstHeld, today) < rule.holdsForDays)
+            return false;
+        const last = [entry.shownAt, entry.laterAt].filter((d) => !!d).sort().pop();
+        return !last || daysBetween(last, today) >= rule.cooldownDays;
+    })
+        .sort((a, b) => a.entry.firstHeld.localeCompare(b.entry.firstHeld) || a.index - b.index);
+    const chosen = ready[0];
+    if (!chosen)
+        return { tip: null, state };
+    state[chosen.rule.id] = { ...chosen.entry, shownAt: today };
+    return { tip: viewOf(chosen.rule), state };
+}
+/** "Not this again": never again, until the Tips list brings it back. */
+export function dismissTip(previous, id, today) {
+    return { ...previous, [id]: { ...previous[id], dismissed: true, ...(today ? { dismissedAt: today } : {}) } };
+}
+/** "Bring back": the dismissal is forgotten; holds and cooldowns stay. */
+export function restoreTip(previous, id) {
+    const { dismissed: _d, dismissedAt: _at, ...rest } = previous[id] ?? {};
+    const next = { ...previous };
+    if (Object.keys(rest).length)
+        next[id] = rest;
+    else
+        delete next[id];
+    return next;
+}
+/**
+ * Every rule and where it stands, reading the state without changing it:
+ *
+ * - `today`: the engine would show it now and it has not been shown today;
+ * - `shown`: shown (or put off) today or within its cooldown;
+ * - `dismissed`: "Not this again";
+ * - `holding`: its condition holds, waiting its day;
+ * - `quiet`: its condition does not hold.
+ */
+export function listTips(rules, facts, previous, today) {
+    const { tip, state } = pickTip(rules, facts, previous, today);
+    return rules.map((rule) => {
+        const before = previous[rule.id] ?? {};
+        const after = state[rule.id] ?? {};
+        const row = viewOf(rule);
+        const last = [before.shownAt, before.laterAt].filter((d) => !!d).sort().pop();
+        if (before.shownAt)
+            row.shownAt = before.shownAt;
+        if (before.dismissed) {
+            row.status = 'dismissed';
+            if (before.dismissedAt)
+                row.dismissedAt = before.dismissedAt;
+        }
+        else if (tip?.id === rule.id && before.shownAt !== today) {
+            row.status = 'today';
+        }
+        else if (last && (last === today || daysBetween(last, today) < rule.cooldownDays)) {
+            row.status = 'shown';
+            row.shownAt = before.shownAt ?? last;
+        }
+        else if (!applies(rule, facts)) {
+            row.status = 'quiet';
+        }
+        else {
+            row.status = 'holding';
+        }
+        if (after.firstHeld && (row.status === 'holding' || row.status === 'today'))
+            row.holdsSince = after.firstHeld;
+        return row;
+    });
+}
+/** ×: not today, and not before its cooldown has passed. */
+export function laterTip(previous, id, today) {
+    return { ...previous, [id]: { ...previous[id], laterAt: today } };
+}
+//# sourceMappingURL=engine.js.map

package/packages/gateway/dist/tips/engine.js.map

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

package/packages/gateway/dist/tips/facts.d.ts

@@ -0,0 +1,69 @@
+/** The `core.web_settings` key the dashboard's page views are kept under. */
+export declare const TIPS_PAGES_KEY = "tips.pages";
+/** How many distinct pages are remembered; the oldest seen goes first. */
+export declare const TIPS_PAGES_CAP = 64;
+export interface Facts {
+    /** Whole days since the installation was first set up. */
+    daysSinceInstall: number;
+    /** First run is still going: no tip then. */
+    firstRun: boolean;
+    /** The owner's agents, the maker left out. */
+    agents: number;
+    agentIds: Set<string>;
+    /** Groups not archived. */
+    groups: number;
+    /** Installed plugin names. */
+    plugins: Set<string>;
+    /** The email plugin has at least one mailbox. */
+    mailboxSet: boolean;
+    /** Somebody reads the mail: Mail Triage is on the team. */
+    mailAgent: boolean;
+    speechInstalled: boolean;
+    /** The owner ever spoke to buddi (a recording) or an agent ever used speech. */
+    voiceUsed: boolean;
+    missions: number;
+    telegramPaired: boolean;
+    browserUsed: boolean;
+    toolsUsed: Set<string>;
+    pagesVisited: Set<string>;
+}
+interface Queryable {
+    query(sql: string, params?: unknown[]): Promise<{
+        rows: any[];
+    }>;
+}
+export interface FactsDeps {
+    pool: Queryable;
+    now: () => Date;
+    /** The roster as the catalog holds it now. */
+    agents: () => ReadonlyArray<{
+        id: string;
+        roles?: readonly string[];
+    }>;
+    /** Installed plugin names. */
+    plugins: () => readonly string[];
+    /** Whether the email plugin has a mailbox; its own page query answers it. */
+    mailboxSet: () => Promise<boolean>;
+}
+/** Mail Triage's agent id, as the email plugin proposes it. */
+export declare const MAIL_AGENT_ID = "mail-triage";
+/** The slice of `core.web_settings` the tips read and write; a map in tests. */
+export interface SettingsStore {
+    read<T>(key: string): Promise<T | null>;
+    write(key: string, value: unknown): Promise<void>;
+}
+/** `core.web_settings`, as a `SettingsStore`. */
+export declare function webSettingsStore(pool: Queryable): SettingsStore;
+/** The pages the dashboard said it opened, page → the day it last said so. */
+export declare function readPagesSeen(store: SettingsStore): Promise<Record<string, string>>;
+/** A page name the dashboard may report: its route, without the `#/`, short. */
+export declare const PAGE_NAME: RegExp;
+/**
+ * Remember one page seen on one day. Once a day per page: a second report the
+ * same day writes nothing. Capped: past `TIPS_PAGES_CAP` the page seen longest
+ * ago is forgotten.
+ */
+export declare function recordPageSeen(store: SettingsStore, page: string, day: string): Promise<boolean>;
+export declare function readFacts(deps: FactsDeps): Promise<Facts>;
+export {};
+//# sourceMappingURL=facts.d.ts.map

package/packages/gateway/dist/tips/facts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facts.d.ts","sourceRoot":"","sources":["../../src/tips/facts.ts"],"names":[],"mappings":"AAaA,6EAA6E;AAC7E,eAAO,MAAM,cAAc,eAAe,CAAC;AAC3C,0EAA0E;AAC1E,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,MAAM,WAAW,KAAK;IACpB,0DAA0D;IAC1D,gBAAgB,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,QAAQ,EAAE,OAAO,CAAC;IAClB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,iDAAiD;IACjD,UAAU,EAAE,OAAO,CAAC;IACpB,2DAA2D;IAC3D,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,gFAAgF;IAChF,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC3B;AAED,UAAU,SAAS;IACjB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,EAAE,MAAM,IAAI,CAAC;IAChB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACvE,8BAA8B;IAC9B,OAAO,EAAE,MAAM,SAAS,MAAM,EAAE,CAAC;IACjC,6EAA6E;IAC7E,UAAU,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACpC;AAED,+DAA+D;AAC/D,eAAO,MAAM,aAAa,gBAAgB,CAAC;AAgB3C,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACxC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD;AAED,iDAAiD;AACjD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,aAAa,CAK/D;AAED,8EAA8E;AAC9E,wBAAsB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAWzF;AAED,gFAAgF;AAChF,eAAO,MAAM,SAAS,QAAiC,CAAC;AAExD;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOtG;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CA6C/D"}

package/packages/gateway/dist/tips/facts.js

@@ -0,0 +1,104 @@
+/**
+ * What the tips are decided on (docs/dashboard.md, Home): a handful of facts
+ * about this installation, read from what already exists. Nothing here is
+ * recorded for the tips' sake except the pages the dashboard reports it
+ * opened (`tips.pages`), which nothing else knew.
+ *
+ * Every read is forgiving: a table a plugin owns may not be there, and a
+ * failed read is the quiet answer ("not used", "none"), so a broken query can
+ * only ever hold a tip back, never raise one.
+ */
+import { readWebSetting, writeWebSetting } from '@buddi/core';
+import { ROLE_MAKER } from '../agents/roles.js';
+/** The `core.web_settings` key the dashboard's page views are kept under. */
+export const TIPS_PAGES_KEY = 'tips.pages';
+/** How many distinct pages are remembered; the oldest seen goes first. */
+export const TIPS_PAGES_CAP = 64;
+/** Mail Triage's agent id, as the email plugin proposes it. */
+export const MAIL_AGENT_ID = 'mail-triage';
+const DAY_MS = 86_400_000;
+async function rows(pool, sql, params = []) {
+    try {
+        return (await pool.query(sql, params)).rows;
+    }
+    catch {
+        return [];
+    }
+}
+async function count(pool, sql) {
+    const [row] = await rows(pool, sql);
+    return Number(row?.n ?? 0) || 0;
+}
+/** `core.web_settings`, as a `SettingsStore`. */
+export function webSettingsStore(pool) {
+    return {
+        read: (key) => readWebSetting(pool, key),
+        write: (key, value) => writeWebSetting(pool, key, value),
+    };
+}
+/** The pages the dashboard said it opened, page → the day it last said so. */
+export async function readPagesSeen(store) {
+    try {
+        const value = await store.read(TIPS_PAGES_KEY);
+        const out = {};
+        if (value && typeof value === 'object' && !Array.isArray(value)) {
+            for (const [page, day] of Object.entries(value))
+                if (typeof day === 'string')
+                    out[page] = day;
+        }
+        return out;
+    }
+    catch {
+        return {};
+    }
+}
+/** A page name the dashboard may report: its route, without the `#/`, short. */
+export const PAGE_NAME = /^[a-z0-9][a-z0-9._/-]{0,63}$/;
+/**
+ * Remember one page seen on one day. Once a day per page: a second report the
+ * same day writes nothing. Capped: past `TIPS_PAGES_CAP` the page seen longest
+ * ago is forgotten.
+ */
+export async function recordPageSeen(store, page, day) {
+    const seen = await readPagesSeen(store);
+    if (seen[page] === day)
+        return false;
+    seen[page] = day;
+    const entries = Object.entries(seen).sort((a, b) => b[1].localeCompare(a[1]) || a[0].localeCompare(b[0]));
+    await store.write(TIPS_PAGES_KEY, Object.fromEntries(entries.slice(0, TIPS_PAGES_CAP)));
+    return true;
+}
+export async function readFacts(deps) {
+    const { pool } = deps;
+    const roster = deps.agents().filter((a) => !(a.roles ?? []).includes(ROLE_MAKER));
+    const agentIds = new Set(roster.map((a) => a.id));
+    const plugins = new Set(deps.plugins());
+    const [install] = await rows(pool, `select least((select min(created_at) from core.owner),
+                  (select min(started_at) from core.onboarding)) as at`);
+    const installedAt = install?.at ? new Date(install.at) : deps.now();
+    const daysSinceInstall = Math.max(0, Math.floor((deps.now().getTime() - installedAt.getTime()) / DAY_MS));
+    const [onboarding] = await rows(pool, `select state from core.onboarding limit 1`);
+    const firstRun = !onboarding || (onboarding.state !== 'done' && onboarding.state !== 'skipped');
+    const toolsUsed = new Set((await rows(pool, `select distinct payload->>'name' as name from core.events where kind = 'tool.called'`))
+        .map((r) => r.name)
+        .filter((n) => typeof n === 'string'));
+    const recorded = await count(pool, `select count(*)::int as n from core.artifacts where kind = 'audio' and created_by = 'owner' and deleted_at is null`);
+    return {
+        daysSinceInstall,
+        firstRun,
+        agents: roster.length,
+        agentIds,
+        groups: await count(pool, `select count(*)::int as n from core.groups where archived_at is null`),
+        plugins,
+        mailboxSet: plugins.has('email') ? await deps.mailboxSet().catch(() => false) : false,
+        mailAgent: agentIds.has(MAIL_AGENT_ID),
+        speechInstalled: plugins.has('speech'),
+        voiceUsed: recorded > 0 || [...toolsUsed].some((t) => t.startsWith('speech.')),
+        missions: await count(pool, `select count(*)::int as n from core.missions`),
+        telegramPaired: (await count(pool, `select count(*)::int as n from core.surface_identities where surface = 'telegram'`)) > 0,
+        browserUsed: [...toolsUsed].some((t) => t.startsWith('browser.')),
+        toolsUsed,
+        pagesVisited: new Set(Object.keys(await readPagesSeen(webSettingsStore(pool)))),
+    };
+}
+//# sourceMappingURL=facts.js.map

package/packages/gateway/dist/tips/facts.js.map

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

package/packages/gateway/dist/tips/route.d.ts

@@ -0,0 +1,25 @@
+import { type Facts, type SettingsStore } from './facts.js';
+import { type TipRule } from './rules.js';
+export declare const TIPS_STATE_KEY = "tips.state";
+export declare const TIPS_ENABLED_KEY = "tips.enabled";
+export interface TipsRouteDeps {
+    store: SettingsStore;
+    facts: () => Promise<Facts>;
+    now: () => Date;
+    timezone: string;
+    /** The rules; `TIPS` unless a test passes its own. */
+    rules?: readonly TipRule[];
+}
+export interface TipsReply {
+    status: number;
+    body: unknown;
+}
+/** Whether tips are on. Anything but an explicit `false` is on. */
+export declare function tipsEnabled(store: SettingsStore): Promise<boolean>;
+export declare function tipsRoute(deps: TipsRouteDeps, request: {
+    method: string;
+    path: string;
+    body?: Record<string, unknown>;
+    preview?: string | null;
+}): Promise<TipsReply>;
+//# sourceMappingURL=route.d.ts.map

package/packages/gateway/dist/tips/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/tips/route.ts"],"names":[],"mappings":"AAgBA,OAAO,EAA6B,KAAK,KAAK,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,EAAQ,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAEhD,eAAO,MAAM,cAAc,eAAe,CAAC;AAC3C,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAE/C,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5B,GAAG,EAAE,MAAM,IAAI,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,KAAK,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf;AAOD,mEAAmE;AACnE,wBAAsB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAGxE;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACjG,OAAO,CAAC,SAAS,CAAC,CA6DpB"}

package/packages/gateway/dist/tips/route.js

@@ -0,0 +1,96 @@
+/**
+ * The tips' routes (docs/dashboard.md, Home):
+ *
+ *   GET  /api/tips                 { tips: [...rows], enabled }   every rule and where it stands (the Tips list)
+ *   GET  /api/tips/current         { tip | null, enabled }   today's tip, if any
+ *   POST /api/tips/:id/dismiss     "Not this again": never again
+ *   POST /api/tips/:id/later       ×: not before its cooldown has passed
+ *   POST /api/tips/:id/restore     "Bring back": forget a dismissal
+ *   POST /api/tips/seen-page { page }   the dashboard opened a page (once a day each)
+ *   GET  /api/tips/settings        { enabled }
+ *   PUT  /api/tips/settings { enabled }   Settings → Notifications → Tips on Home
+ *
+ * State lives in `core.web_settings`: `tips.state` (the engine's), `tips.enabled`
+ * (absent is on) and `tips.pages`.
+ */
+import { dayIn, dismissTip, laterTip, listTips, pickTip, restoreTip } from './engine.js';
+import { PAGE_NAME, recordPageSeen } from './facts.js';
+import { TIPS } from './rules.js';
+export const TIPS_STATE_KEY = 'tips.state';
+export const TIPS_ENABLED_KEY = 'tips.enabled';
+async function readState(store) {
+    const value = await store.read(TIPS_STATE_KEY).catch(() => null);
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+}
+/** Whether tips are on. Anything but an explicit `false` is on. */
+export async function tipsEnabled(store) {
+    const value = await store.read(TIPS_ENABLED_KEY).catch(() => null);
+    return value !== false;
+}
+export async function tipsRoute(deps, request) {
+    const { method, path } = request;
+    const body = request.body ?? {};
+    const rules = deps.rules ?? TIPS;
+    const today = dayIn(deps.now(), deps.timezone);
+    if (path === '/api/tips/settings') {
+        if (method === 'PUT') {
+            if (typeof body.enabled !== 'boolean')
+                return { status: 400, body: { error: '`enabled` must be true or false.' } };
+            await deps.store.write(TIPS_ENABLED_KEY, body.enabled);
+        }
+        else if (method !== 'GET') {
+            return { status: 405, body: { error: 'GET or PUT.' } };
+        }
+        return { status: 200, body: { enabled: await tipsEnabled(deps.store) } };
+    }
+    if (path === '/api/tips') {
+        if (method !== 'GET')
+            return { status: 405, body: { error: 'GET only.' } };
+        // Reads only: listing never marks a tip shown. It reads while tips are off too.
+        const tips = listTips(rules, await deps.facts(), await readState(deps.store), today);
+        return { status: 200, body: { tips, enabled: await tipsEnabled(deps.store) } };
+    }
+    if (path === '/api/tips/current') {
+        if (method !== 'GET')
+            return { status: 405, body: { error: 'GET only.' } };
+        // `?preview=<id>` shows one rule's card as it would look, touching no state:
+        // for eyeballing copy and layout on Home (`#/?tip=<id>`).
+        const preview = request.preview ?? null;
+        if (preview !== null) {
+            const rule = rules.find((r) => r.id === preview);
+            return rule
+                ? { status: 200, body: { tip: { id: rule.id, text: rule.text, action: { ...rule.action } }, enabled: true, preview: true } }
+                : { status: 404, body: { error: `No tip called "${preview}". Known: ${rules.map((r) => r.id).join(', ')}.` } };
+        }
+        if (!(await tipsEnabled(deps.store)))
+            return { status: 200, body: { tip: null, enabled: false } };
+        const previous = await readState(deps.store);
+        const { tip, state } = pickTip(rules, await deps.facts(), previous, today);
+        if (JSON.stringify(state) !== JSON.stringify(previous))
+            await deps.store.write(TIPS_STATE_KEY, state);
+        return { status: 200, body: { tip, enabled: true } };
+    }
+    if (path === '/api/tips/seen-page') {
+        if (method !== 'POST')
+            return { status: 405, body: { error: 'POST only.' } };
+        const page = typeof body.page === 'string' ? body.page.trim().toLowerCase() : '';
+        if (!PAGE_NAME.test(page))
+            return { status: 400, body: { error: '`page` must name a page.' } };
+        await recordPageSeen(deps.store, page, today);
+        return { status: 200, body: { ok: true } };
+    }
+    const act = /^\/api\/tips\/([a-z0-9-]+)\/(dismiss|later|restore)$/.exec(path);
+    if (act) {
+        if (method !== 'POST')
+            return { status: 405, body: { error: 'POST only.' } };
+        const id = act[1];
+        if (!rules.some((rule) => rule.id === id))
+            return { status: 404, body: { error: `There is no tip "${id}".` } };
+        const previous = await readState(deps.store);
+        const next = act[2] === 'dismiss' ? dismissTip(previous, id, today) : act[2] === 'restore' ? restoreTip(previous, id) : laterTip(previous, id, today);
+        await deps.store.write(TIPS_STATE_KEY, next);
+        return { status: 200, body: { ok: true } };
+    }
+    return { status: 404, body: { error: 'No such tips route.' } };
+}
+//# sourceMappingURL=route.js.map

package/packages/gateway/dist/tips/route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../../src/tips/route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAkB,MAAM,aAAa,CAAC;AACzG,OAAO,EAAE,SAAS,EAAE,cAAc,EAAkC,MAAM,YAAY,CAAC;AACvF,OAAO,EAAE,IAAI,EAAgB,MAAM,YAAY,CAAC;AAEhD,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC;AAC3C,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAgB/C,KAAK,UAAU,SAAS,CAAC,KAAoB;IAC3C,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAY,cAAc,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAC5E,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAClF,CAAC;AAED,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAoB;IACpD,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAU,gBAAgB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAC5E,OAAO,KAAK,KAAK,KAAK,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,IAAmB,EACnB,OAAkG;IAElG,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACjC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC;IACjC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE/C,IAAI,IAAI,KAAK,oBAAoB,EAAE,CAAC;QAClC,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YACrB,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,SAAS;gBAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,kCAAkC,EAAE,EAAE,CAAC;YACnH,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACzD,CAAC;aAAM,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YAC5B,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,CAAC;QACzD,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;IAC3E,CAAC;IAED,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,IAAI,MAAM,KAAK,KAAK;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,CAAC;QAC3E,gFAAgF;QAChF,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,KAAK,EAAE,EAAE,MAAM,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;QACrF,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;IACjF,CAAC;IAED,IAAI,IAAI,KAAK,mBAAmB,EAAE,CAAC;QACjC,IAAI,MAAM,KAAK,KAAK;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,CAAC;QAC3E,6EAA6E;QAC7E,0DAA0D;QAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;QACxC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;YACjD,OAAO,IAAI;gBACT,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;gBAC5H,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,kBAAkB,OAAO,aAAa,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACnH,CAAC;QACD,IAAI,CAAC,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC;QAClG,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC3E,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;YAAE,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;QACtG,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;IACvD,CAAC;IAED,IAAI,IAAI,KAAK,qBAAqB,EAAE,CAAC;QACnC,IAAI,MAAM,KAAK,MAAM;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,CAAC;QAC7E,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,0BAA0B,EAAE,EAAE,CAAC;QAC/F,MAAM,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QAC9C,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;IAC7C,CAAC;IAED,MAAM,GAAG,GAAG,sDAAsD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9E,IAAI,GAAG,EAAE,CAAC;QACR,IAAI,MAAM,KAAK,MAAM;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,CAAC;QAC7E,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;QACnB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,IAAI,EAAE,EAAE,CAAC;QAC/G,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;QACtJ,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QAC7C,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;IAC7C,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,EAAE,CAAC;AACjE,CAAC"}

package/packages/gateway/dist/tips/rules.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The tips, as data (docs/dashboard.md, Home).
+ *
+ * One entry per tip. Adding a tip is adding an entry here and a case to
+ * `RULE_CASES` in `rules.test.ts`, which fails for a rule without one. Each is
+ * one sentence in buddi's voice and one action; the engine (`engine.ts`)
+ * decides which, if any, Home shows today.
+ */
+import type { Facts } from './facts.js';
+export interface TipAction {
+    label: string;
+    /** A dashboard hash, `#/…`. */
+    route: string;
+}
+export interface TipRule {
+    id: string;
+    /** Whether the tip applies now. */
+    when: (facts: Facts) => boolean;
+    /** How many days `when` must have held before the tip may show. */
+    holdsForDays: number;
+    text: string;
+    action: TipAction;
+    /** Days before a tip shown, or put off with ×, may show again. */
+    cooldownDays: number;
+    /**
+     * The plugin the tip is about. A tip about a plugin that is not installed
+     * never shows, unless `installs` says its action is the way to install it.
+     */
+    plugin?: string;
+    installs?: boolean;
+}
+export declare const TIPS: readonly TipRule[];
+//# sourceMappingURL=rules.d.ts.map

package/packages/gateway/dist/tips/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/tips/rules.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;IAChC,mEAAmE;IACnE,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,CAAC;IAClB,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,IAAI,EAAE,SAAS,OAAO,EAoDlC,CAAC"}

package/packages/gateway/dist/tips/rules.js

@@ -0,0 +1,54 @@
+export const TIPS = [
+    {
+        id: 'second-agent',
+        when: (f) => f.agents < 2 && f.daysSinceInstall >= 3,
+        holdsForDays: 1,
+        text: 'I am doing everything on my own so far. A teammate can take one whole job, your research or your day, off my desk.',
+        action: { label: 'Add a teammate', route: '#/agents' },
+        cooldownDays: 7,
+    },
+    {
+        id: 'make-group',
+        when: (f) => f.agents >= 3 && f.groups === 0,
+        holdsForDays: 1,
+        text: 'You have three agents now. Put them in a group and they work one question together, each on the part they know.',
+        action: { label: 'Make a group', route: '#/chat?group=new' },
+        cooldownDays: 7,
+    },
+    {
+        id: 'mail-triage',
+        when: (f) => f.mailboxSet && !f.mailAgent,
+        holdsForDays: 1,
+        text: 'Your mailbox is connected, but nobody reads it yet. Mail Triage would, and bring you only what needs you.',
+        action: { label: 'Meet Mail Triage', route: '#/settings/p.email.settings' },
+        cooldownDays: 7,
+        plugin: 'email',
+    },
+    {
+        id: 'voice-note',
+        when: (f) => f.speechInstalled && !f.voiceUsed,
+        holdsForDays: 1,
+        text: 'You can talk to me instead of typing. Press the microphone in any chat and just say it.',
+        action: { label: 'Send a voice note', route: '#/chat' },
+        cooldownDays: 7,
+        plugin: 'speech',
+    },
+    {
+        id: 'morning-brief',
+        when: (f) => f.missions === 0 && f.daysSinceInstall >= 7 && f.agentIds.has('planner'),
+        holdsForDays: 1,
+        text: 'Nothing runs on its own yet. Planner can have your day waiting for you every morning.',
+        action: { label: 'Ask Planner for a morning brief', route: '#/chat/planner' },
+        cooldownDays: 7,
+    },
+    {
+        id: 'open-website',
+        when: (f) => !f.browserUsed && f.daysSinceInstall >= 2,
+        holdsForDays: 1,
+        text: 'I can open a website, read it and tell you what matters. Try it with one you check every day.',
+        action: { label: 'Ask buddi to open a website', route: '#/chat' },
+        cooldownDays: 7,
+        plugin: 'browser',
+    },
+];
+//# sourceMappingURL=rules.js.map