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

package/packages/tools/email/dist/tools/mailbox.d.ts

@@ -0,0 +1,108 @@
+/**
+ * The mailbox tools: select, then mark, archive, move, trash — and undo.
+ *
+ * The shape an agent is meant to follow is in every description: select the
+ * messages (`email.select_messages`, a read), tell the owner how many and
+ * show a few, then make the one gated call for all of them. The card says the
+ * count, the mailbox, the first five and the criteria; one approval covers up
+ * to `MAX_PER_CALL` messages.
+ *
+ * Tiers: marking, archiving, moving and undoing are gated and may be
+ * remembered ("Always"), because each is put back by `email.undo`. Trash is
+ * gated and asked every time: Trash is emptied by the provider on its own
+ * schedule, and after that there is nothing to undo.
+ */
+import type { ToolContext, ToolDefinition } from '@buddi/core/plugin';
+import { z } from 'zod';
+import { verbOf, type ActionOutcome, type ActionRecord, type MailboxActionKind, type Provenance, type WriterOptions } from '../mailbox/actions.js';
+import type { GatedToolDefinition } from '../types.js';
+/** What the owner approves for one change. The ids are sorted so the same set is the same card. */
+export interface MailboxEnvelope {
+    kind: MailboxActionKind;
+    accountId: string;
+    account: string;
+    ids: string[];
+    destination: string | null;
+    criteria: string | null;
+}
+/** The card. Count, mailbox, criteria, what happens, the first five. */
+export declare function renderMailboxPreview(input: {
+    kind: MailboxActionKind;
+    account: string;
+    destination: string | null;
+    criteria: string | null;
+    targets: ReadonlyArray<{
+        from: string;
+        subject: string;
+    }>;
+    gmail?: boolean;
+}): string;
+export declare function createMailboxTools(opts: WriterOptions): ToolDefinition<never, unknown>[];
+declare const selectInput: z.ZodObject<{
+    account: z.ZodOptional<z.ZodString>;
+    from: z.ZodOptional<z.ZodString>;
+    olderThanDays: z.ZodOptional<z.ZodNumber>;
+    newerThanDays: z.ZodOptional<z.ZodNumber>;
+    policy: z.ZodOptional<z.ZodString>;
+    unread: z.ZodOptional<z.ZodBoolean>;
+    folder: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    policy?: string | undefined;
+    from?: string | undefined;
+    folder?: string | undefined;
+    account?: string | undefined;
+    limit?: number | undefined;
+    text?: string | undefined;
+    unread?: boolean | undefined;
+    olderThanDays?: number | undefined;
+    newerThanDays?: number | undefined;
+}, {
+    policy?: string | undefined;
+    from?: string | undefined;
+    folder?: string | undefined;
+    account?: string | undefined;
+    limit?: number | undefined;
+    text?: string | undefined;
+    unread?: boolean | undefined;
+    olderThanDays?: number | undefined;
+    newerThanDays?: number | undefined;
+}>;
+export declare const selectTool: ToolDefinition<z.infer<typeof selectInput>, unknown>;
+declare const undoInput: z.ZodObject<{
+    change: z.ZodOptional<z.ZodString>;
+    account: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    account?: string | undefined;
+    change?: string | undefined;
+}, {
+    account?: string | undefined;
+    change?: string | undefined;
+}>;
+export interface UndoEnvelope {
+    changeId: string;
+    accountId: string;
+    kind: string;
+    count: number;
+}
+export declare function createUndoTool(opts: WriterOptions): GatedToolDefinition<z.infer<typeof undoInput>, unknown, UndoEnvelope>;
+/** Undo one change over a fresh connection. Shared by the tool and the Mail page's button. */
+export declare function runUndo(ctx: ToolContext, opts: WriterOptions, change: ActionRecord, provenance: Provenance): Promise<ActionOutcome>;
+/** The Mail page's Undo: the owner's own button, never listed to a model. */
+export declare function createUndoChangeTool(opts: WriterOptions): ToolDefinition<{
+    id: string;
+}, unknown>;
+/**
+ * Undo on the Mail page's Learned list: stop a rule that kept itself, and
+ * with `putBack`, also put back what it changed in the mailbox on arrival
+ * (each change through the trail, as Recent changes' Undo would). The rule's
+ * card becomes the owner's discard, so its kind's track record starts over.
+ * The owner's own button, never listed to a model.
+ */
+export declare function createUndoLearnedTool(opts: WriterOptions): ToolDefinition<{
+    id: string;
+    putBack?: boolean | string;
+}, unknown>;
+export { verbOf };
+//# sourceMappingURL=mailbox.d.ts.map

package/packages/tools/email/dist/tools/mailbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox.d.ts","sourceRoot":"","sources":["../../src/tools/mailbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAqB,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAcL,MAAM,EAEN,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,aAAa,EACnB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAgBvD,mGAAmG;AACnG,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAmBD,wEAAwE;AACxE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,MAAM,CA0BT;AA+GD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,GAAG,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAkCxF;AAMD,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUf,CAAC;AAEH,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAAE,OAAO,CAwC3E,CAAC;AAMF,QAAA,MAAM,SAAS;;;;;;;;;EAGb,CAAC;AAEH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAeD,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,mBAAmB,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CA+BzH;AAED,8FAA8F;AAC9F,wBAAsB,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CASzI;AAED,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,GAAG,cAAc,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,CAAC,CAejG;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,aAAa,GAAG,cAAc,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;CAAE,EAAE,OAAO,CAAC,CAkC9H;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/packages/tools/email/dist/tools/mailbox.js

@@ -0,0 +1,359 @@
+import { z } from 'zod';
+import { listAccounts } from '../config.js';
+import { describeUndo, destinationFor, findAction, lastUndoable, MailboxRefusal, MAX_PER_CALL, performAction, plural, requireTargets, sampleLines, serverFacts, undoAction, undoRefusal, verbOf, withWriter, } from '../mailbox/actions.js';
+import { selectMessages } from '../mailbox/select.js';
+import { undoLearnedRule } from '../policies/auto.js';
+import { ACCOUNT_ARG, accountScope, UUID } from './shared.js';
+const IDS = z
+    .array(UUID)
+    .min(1)
+    .max(MAX_PER_CALL)
+    .describe(`The message ids, from email.select_messages (or email.list_recent / email.search). One mailbox per call, at most ${MAX_PER_CALL}.`);
+const CRITERIA = z
+    .string()
+    .min(1)
+    .max(200)
+    .optional()
+    .describe('What these messages are, in the words email.select_messages gave back ("messages from news@shop.example older than 7 days in the inbox"). Shown on the approval card.');
+function provenanceOf(ctx, criteria) {
+    let runId = null;
+    try {
+        runId = ctx.provenance?.().runId ?? null;
+    }
+    catch {
+        runId = null;
+    }
+    const agent = ctx.agentId ?? '';
+    return {
+        origin: agent === 'owner' ? 'owner' : 'agent',
+        actor: agent || 'agent',
+        runId,
+        actionId: ctx.actionId ?? null,
+        criteria,
+    };
+}
+/** The card. Count, mailbox, criteria, what happens, the first five. */
+export function renderMailboxPreview(input) {
+    const n = plural(input.targets.length, 'message');
+    const head = {
+        'mark-read': `Mark ${n} as read in ${input.account}.`,
+        'mark-unread': `Mark ${n} as unread in ${input.account}.`,
+        archive: `Archive ${n} in ${input.account}.`,
+        move: `Move ${n} to ${input.destination} in ${input.account}.`,
+        trash: `Move ${n} to Trash in ${input.account}.`,
+    };
+    const what = {
+        'mark-read': 'Your mail server marks them read, everywhere you read mail.',
+        'mark-unread': 'Your mail server marks them unread, everywhere you read mail.',
+        archive: input.gmail
+            ? `They leave the inbox (the Inbox label comes off; they stay in ${input.destination} with their other labels). Nothing is deleted.`
+            : `They move to ${input.destination}. Nothing is deleted.`,
+        move: `They leave the folder they are in for ${input.destination}. Nothing is created and nothing is deleted.`,
+        trash: `They move to ${input.destination ?? 'Trash'} — not deleted, but your provider empties Trash on its own schedule (Gmail after 30 days), and after that they cannot come back. Asked every time.`,
+    };
+    return [
+        head[input.kind],
+        ...(input.criteria ? [`Which: ${input.criteria}.`] : []),
+        what[input.kind],
+        'Undo puts them back (email.undo, or Undo under Recent changes on the Mail page).',
+        '',
+        ...sampleLines(input.targets),
+    ].join('\n');
+}
+function resultOf(outcome) {
+    return {
+        changed: outcome.changed,
+        skipped: outcome.skipped,
+        change: outcome.action ? { id: outcome.action.id, kind: outcome.action.kind, destination: outcome.action.destination } : null,
+        note: outcome.note,
+    };
+}
+/**
+ * One gated mailbox tool. `describe` resolves the destination against the
+ * live server (a read: CAPABILITY and LIST), so an unknown folder or a server
+ * with no Archive is refused before anybody is asked.
+ */
+function mailboxTool(opts, def) {
+    return {
+        name: def.name,
+        description: def.description,
+        tier: 'gated',
+        ...(def.reusable ? { reusableApproval: true } : {}),
+        sequential: true,
+        input: def.input,
+        async describe(input, ctx) {
+            const db = ctx.buddi.db;
+            const kind = def.kind(input);
+            const { account, targets } = await requireTargets(db, input.ids, await listAccounts(db));
+            let destination = null;
+            let gmail = false;
+            if (kind !== 'mark-read' && kind !== 'mark-unread') {
+                await withWriter(ctx, account, opts, async (client) => {
+                    const facts = await serverFacts(client);
+                    gmail = facts.gmail;
+                    destination = destinationFor(facts, kind, account.address, input.folder);
+                });
+            }
+            const criteria = input.criteria?.trim() || null;
+            return {
+                envelope: {
+                    kind,
+                    accountId: account.id,
+                    account: account.address,
+                    ids: targets.map((t) => t.id).sort(),
+                    destination,
+                    criteria,
+                },
+                preview: renderMailboxPreview({ kind, account: account.address, destination, criteria, targets, gmail }),
+            };
+        },
+        async execute(input, ctx) {
+            const db = ctx.buddi.db;
+            // Exactly what was approved: the envelope's ids and destination.
+            const approved = ctx.approvedEffect?.envelope;
+            const kind = approved?.kind ?? def.kind(input);
+            const ids = approved?.ids ?? input.ids;
+            const { account, targets } = await requireTargets(db, ids, await listAccounts(db));
+            if (approved && approved.accountId !== account.id)
+                throw new MailboxRefusal('The messages are no longer in the mailbox that was approved.');
+            const criteria = approved?.criteria ?? (input.criteria?.trim() || null);
+            const outcome = await withWriter(ctx, account, opts, (client) => performAction(db, client, {
+                account,
+                kind,
+                targets,
+                ...(approved?.destination ? { folder: approved.destination } : input.folder ? { folder: input.folder } : {}),
+                provenance: provenanceOf(ctx, criteria),
+                now: ctx.buddi.clock.now(),
+            }));
+            return resultOf(outcome);
+        },
+    };
+}
+const FLOW = 'Find the messages with email.select_messages first, tell the owner how many and show a few, then make this one call for all of them (up to 500, one mailbox).';
+const markInput = z.object({
+    ids: IDS,
+    state: z.enum(['read', 'unread']).describe("'read' sets the mailbox's read mark; 'unread' clears it."),
+    criteria: CRITERIA,
+});
+const archiveInput = z.object({ ids: IDS, criteria: CRITERIA });
+const trashInput = z.object({ ids: IDS, criteria: CRITERIA });
+const moveInput = z.object({
+    ids: IDS,
+    folder: z
+        .string()
+        .min(1)
+        .describe('The folder (or Gmail label) to move them to, by its name. It must already exist: buddi creates nothing, and an unknown name is refused with the list of folders there are.'),
+    criteria: CRITERIA,
+});
+export function createMailboxTools(opts) {
+    const mark = mailboxTool(opts, {
+        name: 'email.mark',
+        description: `Mark messages read or unread in the owner's mailbox itself — the server's read mark, so every mail app he uses sees it. ${FLOW} Gated; the owner may allow it always. Undo with email.undo.`,
+        input: markInput,
+        kind: (input) => (input.state === 'read' ? 'mark-read' : 'mark-unread'),
+        reusable: true,
+    });
+    const archive = mailboxTool(opts, {
+        name: 'email.archive',
+        description: `Archive messages in the owner's mailbox: on Gmail they leave the inbox and keep their labels; on other servers they move to the server's Archive folder (refused, with a sentence, when it has none). Nothing is deleted. ${FLOW} Gated; the owner may allow it always. Undo with email.undo.`,
+        input: archiveInput,
+        kind: () => 'archive',
+        reusable: true,
+    });
+    const move = mailboxTool(opts, {
+        name: 'email.move',
+        description: `Move messages to an existing folder or Gmail label in the owner's mailbox, by its name. buddi creates no folder: an unknown name is refused with the list of the ones there are. ${FLOW} Gated; the owner may allow it always. Undo with email.undo.`,
+        input: moveInput,
+        kind: () => 'move',
+        reusable: true,
+    });
+    const trash = mailboxTool(opts, {
+        name: 'email.trash',
+        description: `Move messages to the Trash folder of the owner's mailbox. Never a permanent delete — but the provider empties Trash on its own schedule, so it is asked every time and never remembered. Prefer email.archive for anything the owner might want again. ${FLOW} Undo with email.undo while they are still in Trash.`,
+        input: trashInput,
+        kind: () => 'trash',
+        reusable: false,
+    });
+    return [selectTool, mark, archive, move, trash, createUndoTool(opts)];
+}
+/* ------------------------------------------------------------------ *
+ * Select
+ * ------------------------------------------------------------------ */
+const selectInput = z.object({
+    account: ACCOUNT_ARG.optional(),
+    from: z.string().min(1).optional().describe('One sender address, or a domain (shop.example) for everyone there.'),
+    olderThanDays: z.number().int().min(0).max(36_500).optional().describe('Only messages that arrived more than this many days ago.'),
+    newerThanDays: z.number().int().min(0).max(36_500).optional().describe('Only messages that arrived within this many days.'),
+    policy: UUID.optional().describe("The senders a rule from email.list_policies is about (its sender, domain, list or conversation)."),
+    unread: z.boolean().optional().describe('true: only unread messages; false: only read ones.'),
+    folder: z.string().min(1).optional().describe("A folder or Gmail label by name, or 'any'. Default: the inbox."),
+    text: z.string().min(2).optional().describe('Words in the subject, the sender or the body.'),
+    limit: z.number().int().positive().max(MAX_PER_CALL).optional().describe(`How many ids to return (default and most ${MAX_PER_CALL}). The count is always the whole match.`),
+});
+export const selectTool = {
+    name: 'email.select_messages',
+    untrusted: 'mail',
+    description: "Find the messages a mailbox cleanup would touch, without touching them: by sender or domain, age, a rule's senders, read state, folder and words. Returns how many match, their ids (up to 500), five of them to show the owner, and the criteria in words. Show the owner the count and the sample, then pass the ids and the criteria to email.mark, email.archive, email.move or email.trash — one gated call for all of them.",
+    tier: 'auto',
+    input: selectInput,
+    async execute(input, ctx) {
+        const scope = await accountScope(ctx.buddi.db, input.account);
+        const selection = await selectMessages(ctx.buddi.db, scope.accounts, {
+            ...(input.from ? { from: input.from } : {}),
+            ...(input.olderThanDays !== undefined ? { olderThanDays: input.olderThanDays } : {}),
+            ...(input.newerThanDays !== undefined ? { newerThanDays: input.newerThanDays } : {}),
+            ...(input.policy ? { policyId: input.policy } : {}),
+            ...(input.unread !== undefined ? { unread: input.unread } : {}),
+            ...(input.folder ? { folder: input.folder } : {}),
+            ...(input.text ? { text: input.text } : {}),
+            ...(input.limit ? { limit: input.limit } : {}),
+        }, ctx.buddi.clock.now());
+        const accounts = new Set(selection.sample.map((m) => m.account));
+        return {
+            count: selection.count,
+            criteria: selection.criteria,
+            ids: selection.ids,
+            sample: selection.sample,
+            truncated: selection.truncated,
+            note: selection.count === 0
+                ? 'Nothing matches; nothing to change.'
+                : `${plural(selection.count, 'message')} ${selection.criteria}.` +
+                    (selection.truncated ? ` One change covers ${MAX_PER_CALL}; the ids are the newest ${MAX_PER_CALL}.` : '') +
+                    (accounts.size > 1 ? ' They are in more than one mailbox: one change per mailbox.' : '') +
+                    ' Show the owner the count and the sample before asking for the change.',
+        };
+    },
+};
+/* ------------------------------------------------------------------ *
+ * Undo
+ * ------------------------------------------------------------------ */
+const undoInput = z.object({
+    change: UUID.optional().describe('The change to undo, by the id a mailbox tool or the Recent changes list gave. Leave it out for the most recent one.'),
+    account: ACCOUNT_ARG.optional(),
+});
+async function changeFor(ctx, input) {
+    const db = ctx.buddi.db;
+    if (input.change) {
+        const found = await findAction(db, input.change);
+        if (!found)
+            throw new MailboxRefusal(`There is no mailbox change ${input.change}.`);
+        return found;
+    }
+    const scope = await accountScope(db, input.account);
+    const last = await lastUndoable(db, scope.ids);
+    if (!last)
+        throw new MailboxRefusal('There is no mailbox change left to undo.');
+    return last;
+}
+export function createUndoTool(opts) {
+    return {
+        name: 'email.undo',
+        description: 'Put back a change buddi made to the owner\'s mailbox: unmark what was marked, move back what was archived, moved or trashed (while it is still in Trash). The most recent change unless you name one. Gated; the owner may allow it always.',
+        tier: 'gated',
+        reusableApproval: true,
+        sequential: true,
+        input: undoInput,
+        async describe(input, ctx) {
+            const change = await changeFor(ctx, input);
+            const refusal = undoRefusal(change);
+            if (refusal)
+                throw new MailboxRefusal(refusal);
+            const account = (await listAccounts(ctx.buddi.db)).find((a) => a.id === change.accountId);
+            if (!account)
+                throw new MailboxRefusal('That change was made in a mailbox that is turned off or no longer here.');
+            return {
+                envelope: { changeId: change.id, accountId: account.id, kind: change.kind, count: change.changed },
+                preview: [
+                    describeUndo(change, account.address),
+                    `The change was made ${change.createdAt ?? ''} by ${change.origin === 'policy' ? `a rule (${change.actor})` : change.actor}.`,
+                    '',
+                    ...sampleLines(change.items),
+                ].join('\n'),
+            };
+        },
+        async execute(input, ctx) {
+            const approved = ctx.approvedEffect?.envelope;
+            const change = await changeFor(ctx, approved ? { change: approved.changeId } : input);
+            return resultOf(await runUndo(ctx, opts, change, provenanceOf(ctx, null)));
+        },
+    };
+}
+/** Undo one change over a fresh connection. Shared by the tool and the Mail page's button. */
+export async function runUndo(ctx, opts, change, provenance) {
+    const db = ctx.buddi.db;
+    const refusal = undoRefusal(change);
+    if (refusal)
+        throw new MailboxRefusal(refusal);
+    const account = (await listAccounts(db)).find((a) => a.id === change.accountId);
+    if (!account)
+        throw new MailboxRefusal('That change was made in a mailbox that is turned off or no longer here.');
+    return withWriter(ctx, account, opts, (client) => undoAction(db, client, { account, action: change, provenance, now: ctx.buddi.clock.now() }));
+}
+/** The Mail page's Undo: the owner's own button, never listed to a model. */
+export function createUndoChangeTool(opts) {
+    const input = z.object({ id: UUID });
+    return {
+        name: 'email.undo_change',
+        description: 'Undo one mailbox change from the Mail page.',
+        tier: 'auto',
+        ownerOnly: true,
+        input,
+        async execute(args, ctx) {
+            const change = await findAction(ctx.buddi.db, args.id);
+            if (!change)
+                throw new MailboxRefusal('That change is no longer on the list.');
+            const outcome = await runUndo(ctx, opts, change, { origin: 'owner', actor: 'owner', criteria: null });
+            return resultOf(outcome);
+        },
+    };
+}
+/**
+ * Undo on the Mail page's Learned list: stop a rule that kept itself, and
+ * with `putBack`, also put back what it changed in the mailbox on arrival
+ * (each change through the trail, as Recent changes' Undo would). The rule's
+ * card becomes the owner's discard, so its kind's track record starts over.
+ * The owner's own button, never listed to a model.
+ */
+export function createUndoLearnedTool(opts) {
+    const input = z.object({ id: UUID, putBack: z.union([z.boolean(), z.literal('true'), z.literal('false')]).optional() });
+    return {
+        name: 'email.undo_learned',
+        description: 'Undo a rule that kept itself, from the Mail page.',
+        tier: 'auto',
+        ownerOnly: true,
+        input,
+        async execute(args, ctx) {
+            const buddi = ctx.buddi;
+            if (!buddi.proposals)
+                throw new MailboxRefusal('This buddi cannot reach its proposals.');
+            const now = buddi.clock.now();
+            const rule = await undoLearnedRule({ db: buddi.db, proposals: buddi.proposals }, args.id, now);
+            if (!rule)
+                throw new MailboxRefusal('That rule is no longer on the list.');
+            let putBack = 0;
+            const problems = [];
+            if (args.putBack === true || args.putBack === 'true') {
+                for (const id of rule.arrivalChanges) {
+                    const change = await findAction(buddi.db, id);
+                    if (!change || undoRefusal(change) !== null)
+                        continue;
+                    try {
+                        const outcome = await runUndo(ctx, opts, change, { origin: 'owner', actor: 'owner', criteria: null });
+                        putBack += outcome.changed;
+                    }
+                    catch (err) {
+                        problems.push(err instanceof Error ? err.message : String(err));
+                    }
+                }
+            }
+            const parts = [`Stopped quieting ${rule.matcher}; their next message is triaged as usual, and the same rule is not learned again for 90 days.`];
+            if (putBack > 0)
+                parts.push(`Put back ${plural(putBack, 'message')}.`);
+            if (problems.length > 0)
+                parts.push(`Not everything was put back: ${problems[0]}`);
+            return { id: rule.id, revoked: true, putBack, note: parts.join(' ') };
+        },
+    };
+}
+export { verbOf };
+//# sourceMappingURL=mailbox.js.map

package/packages/tools/email/dist/tools/mailbox.js.map

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

package/packages/tools/email/dist/tools/policies.d.ts

@@ -64,6 +64,8 @@ declare const setInput: z.ZodObject<{
     instruction: z.ZodOptional<z.ZodString>;
     note: z.ZodOptional<z.ZodString>;
     label: z.ZodOptional<z.ZodString>;
+    onArrival: z.ZodOptional<z.ZodEnum<["archive", "mark-read", "move"]>>;
+    folder: z.ZodOptional<z.ZodString>;
     sender: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     scope: "sender" | "thread" | "list-id" | "domain";
@@ -71,8 +73,10 @@ declare const setInput: z.ZodObject<{
     action: "draft" | "ignore" | "archive" | "label" | "notify" | "hand-to-agent" | "wake";
     sender?: string | undefined;
     label?: string | undefined;
-    account?: string | undefined;
+    onArrival?: "move" | "archive" | "mark-read" | undefined;
     note?: string | undefined;
+    folder?: string | undefined;
+    account?: string | undefined;
     agentId?: string | undefined;
     instruction?: string | undefined;
 }, {
@@ -81,8 +85,10 @@ declare const setInput: z.ZodObject<{
     action: "draft" | "ignore" | "archive" | "label" | "notify" | "hand-to-agent" | "wake";
     sender?: string | undefined;
     label?: string | undefined;
-    account?: string | undefined;
+    onArrival?: "move" | "archive" | "mark-read" | undefined;
     note?: string | undefined;
+    folder?: string | undefined;
+    account?: string | undefined;
     agentId?: string | undefined;
     instruction?: string | undefined;
 }>;

package/packages/tools/email/dist/tools/policies.d.ts.map

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

package/packages/tools/email/dist/tools/policies.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { POLICY_ACTIONS, POLICY_SCOPES, isUnimplementedAction, } from '../policies/gate.js';
+import { ARRIVAL_KINDS, arrivalWords, POLICY_ACTIONS, POLICY_SCOPES, isUnimplementedAction, } from '../policies/gate.js';
 import { createPolicy, findPolicy, normalizeMatcher, policyStats, refusalFor, revokePolicy, PolicyRefusal, POLICY_COLUMNS, toPolicy, } from '../policies/store.js';
 import { senderVerdicts } from '../policies/learn.js';
 import { normalizeAddress } from '../mail.js';
@@ -70,7 +70,7 @@ const setInput = z.object({
         .describe("What happens to the next message that matches. 'ignore' files it with no model run at all; " +
         "'notify' tells the owner in one line; 'draft' starts a run with the instruction to write a reply; " +
         "'hand-to-agent' gives it to the agent named in agentId; 'wake' is the ordinary triage run. " +
-        "'archive' and 'label' are named here but refused: they need to write to the mailbox, which this build cannot do."),
+        "'archive' and 'label' are named here but refused as actions: to archive matching mail as it arrives, pick one of the others and set onArrival."),
     agentId: z
         .string()
         .min(1)
@@ -83,6 +83,15 @@ const setInput = z.object({
         .describe('For draft: what the reply should say, in one line.'),
     note: z.string().min(1).optional().describe('For notify: the line the owner gets.'),
     label: z.string().min(1).optional().describe('For label: the label to apply.'),
+    onArrival: z
+        .enum(ARRIVAL_KINDS)
+        .optional()
+        .describe("Also act in the owner's mailbox itself the moment a matching message arrives: 'archive' (out of the inbox), 'mark-read', or 'move' to an existing folder named in `folder`. Recorded on the undo trail; the owner undoes it from Recent changes on the Mail page or with email.undo."),
+    folder: z
+        .string()
+        .min(1)
+        .optional()
+        .describe("For onArrival 'move': the folder or Gmail label, by its name. It must already exist."),
     sender: z
         .string()
         .min(1)
@@ -99,6 +108,11 @@ function paramsOf(input) {
         params.note = input.note.trim();
     if (input.label)
         params.label = input.label.trim();
+    if (input.onArrival) {
+        params.onArrival = input.onArrival === 'move'
+            ? { kind: 'move', folder: (input.folder ?? '').trim() }
+            : { kind: input.onArrival };
+    }
     if (input.action === 'ignore') {
         params.category = 'promo';
         params.urgency = 'low';
@@ -133,6 +147,10 @@ export function renderPolicyPreview(input, verdicts, account) {
         `From now on, ${subject}${account ? ` arriving at ${account}` : ''} will ${what[input.action] ?? input.action}.`,
         'This decides every future message that matches, with no model run and nothing to approve each time.',
     ];
+    const onArrival = arrivalWords(input.onArrival ? { kind: input.onArrival, ...(input.folder ? { folder: input.folder.trim() } : {}) } : null);
+    if (onArrival) {
+        lines.push(`When one arrives, buddi will also ${onArrival} — a change on your mail server, recorded under Recent changes on the Mail page, where Undo puts it back.`);
+    }
     if (verdicts > 0) {
         lines.push(`${verdicts} earlier message${verdicts === 1 ? '' : 's'} from this sender ${verdicts === 1 ? 'has' : 'have'} been triaged.`);
     }
@@ -146,9 +164,30 @@ export function renderPolicyPreview(input, verdicts, account) {
     }
     return lines.join('\n');
 }
+/**
+ * A rule that moves mail on arrival must name a folder that exists. Checked
+ * against the folders the poll discovered (no connection needed); an account
+ * whose folders were never listed is let through, and the move refuses at
+ * arrival if the folder is not there.
+ */
+async function checkArrivalFolder(db, accountId, address, input) {
+    if (input.onArrival !== 'move')
+        return;
+    const wanted = (input.folder ?? '').trim();
+    if (wanted === '')
+        throw new PolicyRefusal('moving on arrival needs the folder to move to');
+    const { rows } = await db.query(`select name from email.folders where account_id = $1 order by name`, [accountId]);
+    const names = rows.map((r) => String(r.name));
+    if (names.length <= 1)
+        return;
+    const lower = wanted.toLowerCase();
+    if (names.some((n) => n.toLowerCase() === lower || n.toLowerCase().split(/[/.]/).pop() === lower))
+        return;
+    throw new PolicyRefusal(`${address} has no folder called "${wanted}", and buddi creates none. Its folders are: ${names.join(', ')}.`);
+}
 export const setPolicy = {
     name: 'email.set_policy',
-    description: 'Write a standing decision about incoming mail: what should happen, from now on, to messages from one sender, domain, mailing list or thread. It replaces whatever rule covered the same thing before. Use it when the owner says what they want done with a correspondent, not to record a one-off judgement about a single message.',
+    description: "Write a standing decision about incoming mail: what should happen, from now on, to messages from one sender, domain, mailing list or thread — and, optionally, what buddi also does in the mailbox when one arrives (`onArrival`: archive, mark-read, or move to an existing folder). It replaces whatever rule covered the same thing before. Use it when the owner says what they want done with a correspondent, not to record a one-off judgement about a single message; to clean up mail already there, use email.select_messages and the mailbox tools.",
     tier: 'gated',
     input: setInput,
     async describe(input, _ctx) {
@@ -156,6 +195,7 @@ export const setPolicy = {
         // Which mailbox this rule is about is part of the sentence being approved:
         // "ignore this sender" reads differently for work mail than for personal.
         const account = await requireOneAccount(_ctx.buddi.db, input.account);
+        await checkArrivalFolder(_ctx.buddi.db, account.id, account.address, input);
         const verdicts = input.scope === 'sender'
             ? (await senderVerdicts(_ctx.buddi.db, account.id, matcher, 20)).length
             : 0;