@withbuddi/buddi 0.1.0-pre.26 → 0.1.0-pre.28

package/node_modules/@buddi/tool-email/dist/policies/auto.js

@@ -0,0 +1,241 @@
+import { localDateString } from '@buddi/core/plugin';
+import { isNoReplyAddress, normalizeAddress } from '../mail.js';
+import { learnedKind, ruleOf, writeLearnedRule } from './learned.js';
+import { policyForSender, revokePolicy, toPolicy, POLICY_COLUMNS } from './store.js';
+/** The actions that only quiet a sender. */
+export const QUIET_ACTIONS = ['ignore'];
+/** The on-arrival actions a rule that keeps itself may carry. */
+export const QUIET_ARRIVALS = ['archive', 'mark-read'];
+/**
+ * May this rule keep itself, and why. Pure: the facts are read by the caller.
+ * Null is the answer far more often than not, and then it is a card.
+ */
+export function mayKeepItself(input) {
+    if (input.ownerHasWritten)
+        return null;
+    if (input.scope !== 'sender')
+        return null;
+    if (!QUIET_ACTIONS.includes(input.action))
+        return null;
+    const arrival = input.params?.onArrival;
+    if (arrival && !QUIET_ARRIVALS.includes(arrival.kind))
+        return null;
+    if (input.bulk)
+        return 'bulk';
+    if (input.trusted)
+        return 'track-record';
+    return null;
+}
+/**
+ * Is this sender's mail sent to many, in this account? A no-reply address, or
+ * any message from them that carried `List-Unsubscribe` / `Precedence: bulk`
+ * (`bulk`) or a `List-Id`.
+ */
+export async function isBulkSender(db, accountId, address) {
+    const matcher = normalizeAddress(address);
+    if (matcher === '' || !accountId)
+        return false;
+    if (isNoReplyAddress(matcher))
+        return true;
+    const { rows } = await db.query(`select exists (
+       select 1 from email.messages m
+        where m.account_id = $2::uuid and m.direction = 'in'
+          and email.address_of(m.from_addr) = $1
+          and (m.bulk or m.list_id is not null)
+     ) as bulk`, [matcher, accountId]);
+    return rows[0]?.bulk === true;
+}
+/**
+ * Has the owner ever sent mail to this address, from **any** mailbox? Stricter
+ * than the per-account veto on proposals: a rule that keeps itself does not
+ * get the benefit of a history split across accounts.
+ */
+export async function ownerHasWrittenAnywhere(db, address) {
+    const matcher = normalizeAddress(address);
+    if (matcher === '')
+        return true;
+    const { rows } = await db.query(`select count(*)::int as n from email.messages m
+      where m.direction = 'out'
+        and (
+          exists (select 1 from jsonb_array_elements_text(m.to_addrs) as a(addr) where email.address_of(a.addr) = $1)
+          or exists (select 1 from jsonb_array_elements_text(m.cc) as a(addr) where email.address_of(a.addr) = $1)
+        )`, [matcher]);
+    return Number(rows[0]?.n ?? 0) > 0;
+}
+/**
+ * Propose the rule and keep it in one transaction: the card (never
+ * announced), the rule through the same apply as a kept card, and the card
+ * marked kept by `auto`. Returns the kept card, or null when the owner
+ * discarded the same rule in the last 90 days (then nothing happens at all)
+ * or the rule could not be written (then the caller proposes it as a card).
+ */
+export async function keepLearnedItself(host, ask, reason, now, run) {
+    try {
+        return await host.db.transaction(async (tx) => {
+            const result = await host.proposals.proposePolicy(run, ask, tx, { announce: false });
+            const card = result.ok ? result.proposal : result.reason === 'already-open' ? result.existing : null;
+            if (!card)
+                return null;
+            return keepCardItself(host, tx, card, reason, now);
+        });
+    }
+    catch (err) {
+        if (err instanceof NotKept)
+            return null;
+        throw err;
+    }
+}
+class NotKept extends Error {
+}
+/** Write the rule an open card describes and mark the card kept by `auto`, inside `tx`. Throws `NotKept` to roll back. */
+async function keepCardItself(host, tx, card, reason, now) {
+    const written = await writeLearnedRule(tx, card, now, { keptBy: 'auto', autoReason: reason });
+    if (!written.ok)
+        throw new NotKept(written.note);
+    const kept = await host.proposals.keepItself(card.id, tx);
+    if (!kept)
+        throw new NotKept('the card was decided meanwhile');
+    return kept;
+}
+/**
+ * The one-time sweep, run on every start and idempotent: every open email
+ * card that qualifies as bulk today is kept the same way, so the pile that
+ * was waiting before this build disappears into Learned. Only the `bulk`
+ * reason: the track record decides new rules, not ones already waiting.
+ * A sender with a live rule of any kind is left alone — that rule is the
+ * owner's. Returns how many were kept.
+ */
+export async function sweepOpenBulkCards(host, now) {
+    const open = await host.proposals.listOpen();
+    let kept = 0;
+    for (const card of open) {
+        const rule = ruleOf(card.payload);
+        if (!rule.ok || !rule.accountId)
+            continue;
+        const ownerHasWritten = await ownerHasWrittenAnywhere(host.db, rule.matcher);
+        const bulk = rule.scope === 'sender' ? await isBulkSender(host.db, rule.accountId, rule.matcher) : false;
+        const reason = mayKeepItself({ scope: rule.scope, action: rule.action, params: rule.params, ownerHasWritten, bulk, trusted: false });
+        if (reason !== 'bulk')
+            continue;
+        if (await policyForSender(host.db, rule.matcher, rule.accountId))
+            continue;
+        try {
+            await host.db.transaction((tx) => keepCardItself(host, tx, card, reason, now));
+            kept += 1;
+        }
+        catch (err) {
+            if (!(err instanceof NotKept))
+                throw err;
+        }
+    }
+    return kept;
+}
+/** The kind an old card is, when it carries none (cards from before kinds). */
+export function kindOfCard(card) {
+    if (typeof card.payload.kind === 'string' && card.payload.kind)
+        return card.payload.kind;
+    const params = (card.payload.params ?? {});
+    return learnedKind(String(card.payload.action ?? ''), params.category);
+}
+/* ------------------------------------------------------------------ *
+ * The owner hears about it once a day
+ * ------------------------------------------------------------------ */
+/** The Mail page, where Learned lists them. */
+export const LEARNED_ROUTE = '#/p/email/mail';
+/** How many rules kept themselves on the owner's local day, by reason. Undone ones are not counted. */
+export async function learnedOn(db, day, timezone) {
+    const { rows } = await db.query(`select count(*) filter (where auto_reason = 'bulk')::int as bulk,
+            count(*) filter (where auto_reason is distinct from 'bulk')::int as track
+       from email.policies
+      where kept_by = 'auto' and revoked_at is null
+        and (kept_at at time zone $2)::date = $1::date`, [day, timezone]);
+    return { bulk: Number(rows[0]?.bulk ?? 0), trackRecord: Number(rows[0]?.track ?? 0) };
+}
+function plural(n, one, many = `${one}s`) {
+    return `${n} ${n === 1 ? one : many}`;
+}
+/** "buddi learned 7 rules: quieted 5 newsletters and 2 senders — review". */
+export function learnedLine(counts) {
+    const total = counts.bulk + counts.trackRecord;
+    if (total === 0)
+        return null;
+    const parts = [
+        counts.bulk > 0 ? plural(counts.bulk, 'newsletter') : null,
+        counts.trackRecord > 0 ? plural(counts.trackRecord, 'sender') : null,
+    ].filter((p) => p !== null);
+    return `buddi learned ${plural(total, 'rule')}: quieted ${parts.join(' and ')} — review`;
+}
+/**
+ * Tell the owner what kept itself today, in one line. Keyed per local day,
+ * so every call on the same day updates the one waiting line rather than
+ * adding another, at the `today` urgency (the end-of-day message). Nothing is
+ * sent when nothing kept itself. Never throws: the rules stand either way.
+ */
+export async function tellOwnerLearned(host, now) {
+    const notify = host.owner.notify;
+    if (!notify)
+        return null;
+    try {
+        const timezone = host.owner.timezone || 'UTC';
+        const day = localDateString(now, timezone);
+        const title = learnedLine(await learnedOn(host.db, day, timezone));
+        if (!title)
+            return null;
+        await notify({
+            urgency: 'today',
+            title,
+            text: 'Each is under Learned on the Mail page, with Undo.',
+            link: { route: LEARNED_ROUTE },
+            dedupeKey: `learned:${day}`,
+        });
+        return title;
+    }
+    catch (err) {
+        console.error(`email: could not tell the owner what it learned: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+}
+/** The rules that kept themselves, newest first, undone ones included (they say so). */
+export async function learnedRules(db, limit = 50) {
+    const { rows } = await db.query(`select ${POLICY_COLUMNS},
+            coalesce((select array_agg(a.id::text order by a.created_at desc)
+                        from email.mailbox_actions a
+                       where a.policy_id = p.id and a.kind <> 'undo' and a.undone_at is null), '{}') as arrival_changes
+       from email.policies p
+      where p.kept_by = 'auto'
+      order by p.kept_at desc nulls last, p.id desc
+      limit $1`, [limit]);
+    return rows.map((row) => {
+        const policy = toPolicy(row);
+        return {
+            id: policy.id,
+            accountId: policy.accountId,
+            matcher: policy.matcher,
+            action: policy.action,
+            params: policy.params,
+            autoReason: policy.autoReason ?? null,
+            keptAt: policy.keptAt ?? null,
+            revokedAt: policy.revokedAt,
+            proposalId: policy.proposalId ?? null,
+            arrivalChanges: Array.isArray(row.arrival_changes) ? row.arrival_changes.map(String) : [],
+        };
+    });
+}
+/**
+ * Undo a rule that kept itself: revoke it, and turn its card into the
+ * owner's discard — so the same rule is not learned again for 90 days and the
+ * kind's track record starts over. Returns the rule as it is now, or null.
+ */
+export async function undoLearnedRule(host, id, now) {
+    const rules = await learnedRules(host.db, 500);
+    const rule = rules.find((r) => r.id === id);
+    if (!rule)
+        return null;
+    await host.db.transaction(async (tx) => {
+        await revokePolicy(tx, id, now);
+        if (rule.proposalId)
+            await host.proposals.takeBack(rule.proposalId, { reason: 'undone by the owner', within: tx });
+    });
+    return { ...rule, revokedAt: rule.revokedAt ?? now.toISOString() };
+}
+//# sourceMappingURL=auto.js.map

package/node_modules/@buddi/tool-email/dist/policies/auto.js.map

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

package/node_modules/@buddi/tool-email/dist/policies/gate.d.ts

@@ -3,18 +3,28 @@ export type PolicyScope = (typeof POLICY_SCOPES)[number];
 export declare const POLICY_ACTIONS: readonly ["ignore", "archive", "label", "notify", "draft", "hand-to-agent", "wake"];
 export type PolicyAction = (typeof POLICY_ACTIONS)[number];
 export declare const POLICY_ORIGINS: readonly ["owner", "learned", "plugin"];
+/** What a rule may do in the mailbox when a message it matches arrives. */
+export declare const ARRIVAL_KINDS: readonly ["archive", "mark-read", "move"];
+export type ArrivalKind = (typeof ARRIVAL_KINDS)[number];
+export interface ArrivalAction {
+    kind: ArrivalKind;
+    /** `move`: the folder or Gmail label, by its server name. */
+    folder?: string;
+}
+/** The words a policy card and an approval use for an on-arrival action. */
+export declare function arrivalWords(action: ArrivalAction | undefined | null): string | null;
 export type PolicyOrigin = (typeof POLICY_ORIGINS)[number];
 /**
- * Actions that need an IMAP write this client does not have.
+ * Actions that are vocabulary, not behaviour.
  *
- * `ImapClient` is a peek-only port by construction (`ports.ts`): reading mail
- * must not mutate it, and nothing in this build can set a flag or move a
- * message. So `archive` and `label` are part of the vocabulary — they are what
- * the owner will want, and refusing to *name* them would be a worse lie than
- * refusing to perform them — and both are refused at the point a policy is
- * created, with "not yet". Should a row carrying one reach the gate anyway
- * (written by an older build, or by hand), the gate refuses it and falls
- * through to a run rather than silently dropping the message.
+ * `archive` and `label` are what an owner might ask a rule to do, and refusing
+ * to *name* them would be a worse lie than refusing them. They are refused as
+ * a rule's action at the point a policy is created: a rule that should archive
+ * matching mail picks a real action and carries an on-arrival mailbox action
+ * (`params.onArrival`, carried out by `mailbox/arrival.ts`). Should a row
+ * carrying one reach the gate anyway (written by an older build, or by hand),
+ * the gate refuses it and falls through to a run rather than silently
+ * dropping the message.
  */
 export declare const UNIMPLEMENTED_ACTIONS: readonly PolicyAction[];
 export declare function isUnimplementedAction(action: PolicyAction): boolean;
@@ -31,6 +41,14 @@ export interface PolicyParams {
     /** `ignore`: the triage row written from the policy. */
     category?: string;
     urgency?: 'urgent' | 'normal' | 'low';
+    /**
+     * What the rule also does in the mailbox itself, the moment a matching
+     * message arrives: archive it, mark it read, or move it to a folder that
+     * already exists. Any action may carry one (an `ignore` that also
+     * archives is the common case). Applied by `mailbox/arrival.ts` after the
+     * gate, recorded on the undo trail like any other mailbox change.
+     */
+    onArrival?: ArrivalAction;
     /**
      * `thread` and `list-id`: the sender this policy was created about.
      *
@@ -57,8 +75,14 @@ export interface PolicyRecord {
     }>;
     createdAt: string | null;
     revokedAt: string | null;
-    /** When the owner kept it from Settings → Proposals; null for any other rule. */
+    /** When it was kept from Settings → Proposals, or kept itself; null for any other rule. */
     keptAt?: string | null;
+    /** Who kept a learned rule: the owner, or the plugin itself under its own rule (`auto.ts`). */
+    keptBy?: 'owner' | 'auto' | null;
+    /** The `core.proposals` card it came from, when it came from one. */
+    proposalId?: string | null;
+    /** Why a rule kept itself: `bulk` or `track-record`. */
+    autoReason?: string | null;
 }
 /** Everything the gate is allowed to look at. Deliberately not the body. */
 export interface MessageHeader {

package/node_modules/@buddi/tool-email/dist/policies/gate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../../src/policies/gate.ts"],"names":[],"mappings":"AAwCA,eAAO,MAAM,aAAa,oDAAqD,CAAC;AAChF,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,eAAO,MAAM,cAAc,qFAQjB,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,eAAO,MAAM,cAAc,yCAA0C,CAAC;AACtE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,YAAY,EAAyB,CAAC;AAEnF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAEnE;AAED,mFAAmF;AACnF,MAAM,WAAW,YAAY;IAC3B,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,6EAA6E;IAC7E,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,4EAA4E;AAC5E,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,sEAAsE;IACtE,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC;IAC9B,8DAA8D;IAC9D,OAAO,EAAE,OAAO,CAAC;IACjB,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI5C;AAED,8EAA8E;AAC9E,wBAAgB,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CA2B5E;AAED,8EAA8E;AAC9E,wBAAgB,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAK/E;AAsDD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,SAAS,YAAY,EAAE,GAChC,YAAY,CAgCd;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAgB7D"}
+{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../../src/policies/gate.ts"],"names":[],"mappings":"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"}

package/node_modules/@buddi/tool-email/dist/policies/gate.js

@@ -16,9 +16,9 @@
  * What the gate never does:
  *
  *  - It never reads a *proposed* policy. Everything learned is a proposal on
- *    the settings page until the owner keeps it — promo included. Nothing
- *    learned applies itself while the Sent folder is unsynced (docs/email.md
- *    §3): "never replied" cannot be known from mail buddi has not read.
+ *    the settings page until it is kept — by the owner, or by itself for the
+ *    narrow class `auto.ts` allows (a quiet rule for a bulk sender the owner
+ *    never wrote to). A kept row is a kept row either way.
  *  - It never reads a revoked one. Revocation keeps the row as a record; it
  *    does not keep its effect.
  *  - It never trusts the message. A From header is forged as easily as it is
@@ -48,17 +48,32 @@ export const POLICY_ACTIONS = [
     'wake',
 ];
 export const POLICY_ORIGINS = ['owner', 'learned', 'plugin'];
+/** What a rule may do in the mailbox when a message it matches arrives. */
+export const ARRIVAL_KINDS = ['archive', 'mark-read', 'move'];
+/** The words a policy card and an approval use for an on-arrival action. */
+export function arrivalWords(action) {
+    if (!action)
+        return null;
+    switch (action.kind) {
+        case 'archive':
+            return 'archive it in your mailbox';
+        case 'mark-read':
+            return 'mark it read in your mailbox';
+        case 'move':
+            return `move it to ${action.folder ?? '(no folder named)'} in your mailbox`;
+    }
+}
 /**
- * Actions that need an IMAP write this client does not have.
+ * Actions that are vocabulary, not behaviour.
  *
- * `ImapClient` is a peek-only port by construction (`ports.ts`): reading mail
- * must not mutate it, and nothing in this build can set a flag or move a
- * message. So `archive` and `label` are part of the vocabulary — they are what
- * the owner will want, and refusing to *name* them would be a worse lie than
- * refusing to perform them — and both are refused at the point a policy is
- * created, with "not yet". Should a row carrying one reach the gate anyway
- * (written by an older build, or by hand), the gate refuses it and falls
- * through to a run rather than silently dropping the message.
+ * `archive` and `label` are what an owner might ask a rule to do, and refusing
+ * to *name* them would be a worse lie than refusing them. They are refused as
+ * a rule's action at the point a policy is created: a rule that should archive
+ * matching mail picks a real action and carries an on-arrival mailbox action
+ * (`params.onArrival`, carried out by `mailbox/arrival.ts`). Should a row
+ * carrying one reach the gate anyway (written by an older build, or by hand),
+ * the gate refuses it and falls through to a run rather than silently
+ * dropping the message.
  */
 export const UNIMPLEMENTED_ACTIONS = ['archive', 'label'];
 export function isUnimplementedAction(action) {

package/node_modules/@buddi/tool-email/dist/policies/gate.js.map

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

package/node_modules/@buddi/tool-email/dist/policies/learn.d.ts

@@ -9,16 +9,18 @@
  *    sender judged promo, promo, reply-needed, promo is a sender the owner may
  *    well hear from, and the run is counted from the newest verdict back, so
  *    one dissenting judgement resets it.
- *  - **Nothing applies itself.** A proposal is a card on the owner's
- *    Settings → Proposals inbox (`core.proposals`, docs/learning.md §2
- *    item 3), beside what the agents propose; this plugin writes no rule until
- *    the owner keeps it there, and then writes it through its own apply
- *    (`learned.ts`). The gate reads only kept rows. Promo is no exception. Since step 3 the
- *    Sent folder is synced, so "the owner never wrote back" is read off his own
- *    mail rather than inferred from drafts buddi sent — but a mailbox is synced
- *    from *now*, not from its beginning, and a sender answered before buddi
- *    arrived still looks unanswered. Silencing somebody on a history this
- *    installation has only part of stays the owner's tap to make.
+ *  - **A card, unless the rule only quiets a bulk sender.** A proposal is a
+ *    card on the owner's Settings → Proposals inbox (`core.proposals`,
+ *    docs/learning.md §2 item 3), beside what the agents propose; this plugin
+ *    writes no rule until the owner keeps it there, and then writes it through
+ *    its own apply (`learned.ts`). The gate reads only kept rows. The
+ *    exception is `auto.ts`: a rule that only quiets a sender the owner never
+ *    wrote to keeps itself when the sender's mail is bulk (List-Unsubscribe,
+ *    List-Id, Precedence, a no-reply address) or the owner has kept five of
+ *    its kind running. It is still recorded as a kept card, listed under
+ *    Learned on the Mail page with Undo, and the owner hears about it once a
+ *    day. Anyone else stays a card: a mailbox is synced from *now*, and a
+ *    person answered before buddi arrived still looks unanswered.
  *  - **The owner writing back vetoes silence.** Any proposal that would stop a
  *    run is refused for a sender the owner has actually sent mail to. A person
  *    who gets answers is not a newsletter, whatever the categories say.
@@ -29,8 +31,9 @@
  * The rule is a pure function; the query around it is the only database part.
  */
 import type { DbArea } from '@buddi/core/plugin';
-import type { ProposalsArea, Proposal as CoreProposal, ToolContext } from '@buddi/core/plugin';
+import type { Proposal as CoreProposal, ToolContext } from '@buddi/core/plugin';
 import type { PolicyAction } from './gate.js';
+import { type AutoHost, type AutoReason } from './auto.js';
 /** `ctx.buddi.db`, a transaction's handle, or anything that answers a query as they do. */
 type Db = Pick<DbArea, 'query'>;
 /** How many verdicts running make a pattern. Three: two is a coincidence. */
@@ -44,7 +47,9 @@ export interface Verdict {
 }
 export interface Proposal {
     action: PolicyAction;
-    /** Always true today: nothing learned applies itself. See the module note. */
+    /** The rule's kind (`learned.ts`, `LEARNED_KIND_LABELS`). */
+    kind: 'quiet-promo-sender' | 'quiet-low-sender' | 'notify-sender';
+    /** True: the pure rule proposes. Whether it keeps itself is `auto.ts`'s, on facts read around it. */
     proposed: boolean;
     /** The verdicts it was learned from, newest first. */
     createdFrom: Array<{
@@ -112,17 +117,20 @@ export interface OwnerReplies {
  * out of the average rather than guessed at.
  */
 export declare function ownerReplies(db: Db, accountId: string, address: string): Promise<OwnerReplies>;
-/** What `learnFromVerdict` proposed: a new card on the owner's inbox. */
+/** What `learnFromVerdict` learned: a new card on the owner's inbox, or a rule that kept itself. */
 export interface LearnedPolicy {
     proposal: CoreProposal;
     action: PolicyAction;
     matcher: string;
+    /** Set when the rule kept itself rather than waiting on a card, and why. */
+    keptItself: AutoReason | null;
 }
 /**
- * Called after a verdict is recorded. Proposes at most one rule on the
- * owner's Proposals inbox and returns it, or null when nothing was learned —
- * which is the usual answer. The rule itself is written only when the owner
- * keeps the card (`learned.ts`, `applyLearnedPolicy`).
+ * Called after a verdict is recorded. Learns at most one rule and returns it,
+ * or null when nothing was learned — which is the usual answer. The rule is a
+ * card the owner keeps (`learned.ts`, `applyLearnedPolicy`), unless it only
+ * quiets a sender `auto.ts` allows it to keep itself for; then it is written
+ * at once, recorded as kept by `auto`, and the owner's daily line is updated.
  *
  * A sender that already has a live policy learns nothing: whatever is there is
  * the owner's decision, and overwriting it would be this plugin arguing with
@@ -134,7 +142,7 @@ export interface LearnedPolicy {
  * untrusted, so the messages are the proposal's sources — by subject and
  * sender, never by body.
  */
-export declare function learnFromVerdict(db: Db, proposals: ProposalsArea, input: {
+export declare function learnFromVerdict(host: AutoHost, input: {
     from: string;
     accountId: string;
 }, now: Date, run?: Pick<ToolContext, 'agentId' | 'conversationId' | 'toolUseId' | 'provenance'> | null): Promise<LearnedPolicy | null>;

package/node_modules/@buddi/tool-email/dist/policies/learn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"learn.d.ts","sourceRoot":"","sources":["../../src/policies/learn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,IAAI,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAG/F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C,2FAA2F;AAC3F,KAAK,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEhC,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,8EAA8E;IAC9E,QAAQ,EAAE,OAAO,CAAC;IAClB,sDAAsD;IACtD,WAAW,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrE,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,eAAe,EAAE,OAAO,GACvB,QAAQ,GAAG,IAAI,CA2CjB;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,EAAE,EAAE,EAAE,EACN,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,MAA4B,GAClC,OAAO,CAAC,OAAO,EAAE,CAAC,CA0BpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,EAAE,EACN,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAoBlB;AAED,4EAA4E;AAC5E,eAAO,MAAM,YAAY,KAAK,CAAC;AAE/B,MAAM,WAAW,YAAY;IAC3B,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;;OAGG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,EAAE,EAAE,EAAE,EACN,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,CAAC,CA0CvB;AAED,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,EAAE,EACN,SAAS,EAAE,aAAa,EACxB,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAC1C,GAAG,EAAE,IAAI,EACT,GAAG,GAAE,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,gBAAgB,GAAG,WAAW,GAAG,YAAY,CAAC,GAAG,IAAW,GAC9F,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAiC/B"}
+{"version":3,"file":"learn.d.ts","sourceRoot":"","sources":["../../src/policies/learn.ts"],"names":[],"mappings":"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"}

package/node_modules/@buddi/tool-email/dist/policies/learn.js

@@ -1,6 +1,7 @@
 import { normalizeAddress } from '../mail.js';
 import { policyForSender } from './store.js';
 import { learnedPolicyInput, mailSources } from './learned.js';
+import { isBulkSender, keepLearnedItself, mayKeepItself, ownerHasWrittenAnywhere, tellOwnerLearned } from './auto.js';
 /** How many verdicts running make a pattern. Three: two is a coincidence. */
 export const CONSISTENT_VERDICTS = 3;
 /**
@@ -27,6 +28,7 @@ export function learnedProposal(verdicts, ownerHasReplied) {
     if (sameCategory && category === 'promo' && !ownerHasReplied) {
         return {
             action: 'ignore',
+            kind: 'quiet-promo-sender',
             proposed: true,
             createdFrom,
             why: `The last ${CONSISTENT_VERDICTS} messages from this sender were all marketing, and nothing here says you ever wrote back.`,
@@ -36,6 +38,7 @@ export function learnedProposal(verdicts, ownerHasReplied) {
     if (allLow && !ownerHasReplied) {
         return {
             action: 'ignore',
+            kind: 'quiet-low-sender',
             proposed: true,
             createdFrom,
             why: `The last ${CONSISTENT_VERDICTS} messages from this sender were all judged low — nothing is lost if you never read them.`,
@@ -45,6 +48,7 @@ export function learnedProposal(verdicts, ownerHasReplied) {
     if (sameCategory && (category === 'reply-needed' || category === 'relationship')) {
         return {
             action: 'notify',
+            kind: 'notify-sender',
             proposed: true,
             createdFrom,
             why: `The last ${CONSISTENT_VERDICTS} messages from this sender were all ${category}; a line when they write may be enough.`,
@@ -176,10 +180,11 @@ export async function ownerReplies(db, accountId, address) {
     };
 }
 /**
- * Called after a verdict is recorded. Proposes at most one rule on the
- * owner's Proposals inbox and returns it, or null when nothing was learned —
- * which is the usual answer. The rule itself is written only when the owner
- * keeps the card (`learned.ts`, `applyLearnedPolicy`).
+ * Called after a verdict is recorded. Learns at most one rule and returns it,
+ * or null when nothing was learned — which is the usual answer. The rule is a
+ * card the owner keeps (`learned.ts`, `applyLearnedPolicy`), unless it only
+ * quiets a sender `auto.ts` allows it to keep itself for; then it is written
+ * at once, recorded as kept by `auto`, and the owner's daily line is updated.
  *
  * A sender that already has a live policy learns nothing: whatever is there is
  * the owner's decision, and overwriting it would be this plugin arguing with
@@ -191,7 +196,8 @@ export async function ownerReplies(db, accountId, address) {
  * untrusted, so the messages are the proposal's sources — by subject and
  * sender, never by body.
  */
-export async function learnFromVerdict(db, proposals, input, now, run = null) {
+export async function learnFromVerdict(host, input, now, run = null) {
+    const db = host.db;
     const address = normalizeAddress(input.from);
     // No account is no learning. A policy learned from "every mailbox" would be a
     // rule about mail it was never shown.
@@ -205,13 +211,14 @@ export async function learnFromVerdict(db, proposals, input, now, run = null) {
     const proposal = learnedProposal(verdicts, replied);
     if (!proposal)
         return null;
+    const params = proposal.action === 'ignore'
+        ? { category: verdicts[0]?.category ?? 'promo', urgency: 'low' }
+        : { note: proposal.why };
     const ask = await learnedPolicyInput(db, {
         accountId: input.accountId,
         sender: address,
         action: proposal.action,
-        params: proposal.action === 'ignore'
-            ? { category: verdicts[0]?.category ?? 'promo', urgency: 'low' }
-            : { note: proposal.why },
+        params,
         verdicts: verdicts.slice(0, CONSISTENT_VERDICTS).map((v) => ({
             messageId: v.messageId,
             processingVersion: v.processingVersion,
@@ -220,10 +227,29 @@ export async function learnFromVerdict(db, proposals, input, now, run = null) {
         })),
         why: proposal.why,
         sources: await mailSources(db, proposal.createdFrom.map((v) => v.messageId)),
+        kind: proposal.kind,
     });
-    const result = await proposals.proposePolicy(run, ask);
+    // Only a quiet rule is even asked about; the facts are read only then.
+    if (proposal.action === 'ignore') {
+        const reason = mayKeepItself({
+            scope: 'sender',
+            action: proposal.action,
+            params,
+            ownerHasWritten: replied || (await ownerHasWrittenAnywhere(db, address)),
+            bulk: await isBulkSender(db, input.accountId, address),
+            trusted: (await host.proposals.trackRecord(proposal.kind)).trusted,
+        });
+        if (reason) {
+            const kept = await keepLearnedItself(host, ask, reason, now, run);
+            if (kept) {
+                await tellOwnerLearned(host, now);
+                return { proposal: kept, action: proposal.action, matcher: address, keptItself: reason };
+            }
+        }
+    }
+    const result = await host.proposals.proposePolicy(run, ask);
     if (!result.ok)
         return null;
-    return { proposal: result.proposal, action: proposal.action, matcher: address };
+    return { proposal: result.proposal, action: proposal.action, matcher: address, keptItself: null };
 }
 //# sourceMappingURL=learn.js.map