@aglyn/plugins-outreach 1.0.0-beta.196 → 1.0.0-beta.198

package/src/lib/engine/mail-gateway.d.ts

@@ -0,0 +1,97 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export type OutreachMailGateway = 'barracuda' | 'proofpoint' | 'mimecast' | 'google' | 'microsoft' | 'other' | 'none';
+export declare const OUTREACH_MAIL_GATEWAYS: readonly OutreachMailGateway[];
+/** The gateway as the Check-people chip and the enrollment row name it. */
+export declare const OUTREACH_MAIL_GATEWAY_LABELS: Record<OutreachMailGateway, string>;
+/**
+ * The security gateways that stand in front of a whole company's mail and
+ * refuse a sender for everyone behind them: the ones the enroll dialog
+ * counts as "gateway-fronted".
+ */
+export declare const OUTREACH_GATEWAY_FRONTED: readonly OutreachMailGateway[];
+/** Blocks in the window, with no delivery beside them, that hold the next send. */
+export declare const OUTREACH_GATEWAY_HOLD_BLOCKS = 2;
+/** The days the hold is judged over. */
+export declare const OUTREACH_GATEWAY_WINDOW_DAYS = 30;
+/** The days the Check-people chip counts. */
+export declare const OUTREACH_GATEWAY_CHIP_DAYS = 7;
+/** How long a domain's MX answer is trusted before it is looked up again. */
+export declare const OUTREACH_DOMAIN_INTEL_TTL_MS: number;
+/** A send with no bounce this long after it counts as delivered. */
+export declare const OUTREACH_GATEWAY_DELIVERED_AFTER_MS: number;
+/**
+ * The gateway ONE host names, or `null` when it names none of the known
+ * ones — a Remote-MTA in a bounce, or one MX exchange.
+ */
+export declare function outreachMailGatewayOfHost(host: unknown): OutreachMailGateway | null;
+/**
+ * The gateway a domain's MX records name — see the module note. A domain
+ * whose exchanges name more than one is read as the first named one in MX
+ * order (the list is handed over lowest-priority-first); one that names
+ * none is `other`; an empty list is `none`.
+ */
+export declare function classifyOutreachMailGateway(mxHosts: readonly string[]): OutreachMailGateway;
+/** Whether the gateway is one of the security gateways that refuse a sender for a whole company. */
+export declare function isOutreachGatewayFronted(gateway: OutreachMailGateway | null | undefined): boolean;
+/** The counts one UTC day holds on a gateway's ledger. */
+export interface OutreachGatewayDayCounts {
+    sent: number;
+    delivered: number;
+    blocked: number;
+}
+/** `YYYY-MM-DD` in UTC: the day a ledger entry is filed under. */
+export declare function outreachGatewayDay(atMs: number): string;
+/** The ledger's counts summed over the last `days` UTC days, today included. */
+export declare function outreachGatewayWindow(days: Record<string, Partial<OutreachGatewayDayCounts>> | null | undefined, nowMs: number, windowDays: number): OutreachGatewayDayCounts;
+/** The ledger's days with everything older than `keepDays` dropped. */
+export declare function pruneOutreachGatewayDays<T>(days: Record<string, T> | null | undefined, nowMs: number, keepDays: number): Record<string, T>;
+/**
+ * What the gates and the enroll dialog know about the gateway in front of
+ * one address: which it is, and what it did with this organization's mail
+ * over the chip's week and the hold's month.
+ */
+export interface OutreachGatewayStanding {
+    gateway: OutreachMailGateway;
+    /** Blocks and deliveries in the last {@link OUTREACH_GATEWAY_CHIP_DAYS} days. */
+    blocked7: number;
+    delivered7: number;
+    /** Blocks and deliveries in the last {@link OUTREACH_GATEWAY_WINDOW_DAYS} days. */
+    blocked30: number;
+    delivered30: number;
+}
+/**
+ * Whether the gateway holds the next send — see the module note. A named
+ * gateway only: `other` is many exchanges, and `none` blocks instead.
+ */
+export declare function outreachGatewayHolds(standing: Pick<OutreachGatewayStanding, 'gateway' | 'blocked30' | 'delivered30'>): boolean;
+/** The sentence the hold is written with, on the enrollment and in the engine's reason. */
+export declare function outreachGatewayHoldReason(gateway: OutreachMailGateway, blocked30: number): string;
+/** The chip's tone: what color the Check-people step gives it. */
+export type OutreachGatewayChipTone = 'refused' | 'delivered' | 'neutral' | 'blocked';
+export interface OutreachGatewayChip {
+    label: string;
+    tone: OutreachGatewayChipTone;
+}
+/**
+ * The Check-people chip for one person, or `null` when there is nothing
+ * worth a chip: an unrecognized exchange with no verdict this week. Red for
+ * a gateway that refused this week, green for one that delivered, neutral
+ * for the hosted providers and the security gateways with no verdict yet,
+ * and blocked for a domain with no MX.
+ */
+export declare function outreachGatewayChip(standing: OutreachGatewayStanding | null | undefined): OutreachGatewayChip | null;

package/src/lib/engine/mail-gateway.js

@@ -0,0 +1,226 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /*==========================================
+ * THE MX RECORD PREDICTS THE GATEWAY, AND THE GATEWAY'S HISTORY PREDICTS
+ * THE BLOCK (AGL-3326).
+ *
+ * Two Barracuda gateways refused the same sender three days apart, and each
+ * refusal was read only after the email had left: a hard bounce, a paused
+ * mailbox, ten first emails still queued. Both domains had Barracuda ESS as
+ * their MX, and a third enrolled domain with the same MX was stopped by hand
+ * before it sent. So the signal is cheap and it is available BEFORE a send:
+ * the domain's MX names the gateway in front of it, and what that gateway
+ * has done with this organization's mail lately says what it will do next.
+ *
+ * ## The kinds
+ *
+ * A gateway is named by the MX host's suffix. `barracuda`, `proofpoint`
+ * and `mimecast` are the security gateways that refuse a SENDER on policy
+ * and reputation; `google` and `microsoft` are the two hosted providers,
+ * which judge mail one message at a time; `other` is every self-hosted or
+ * unrecognized exchange; `none` is a domain with no MX at all, which cannot
+ * receive mail and blocks the enrollment outright.
+ *
+ * ## The ledger and the hold
+ *
+ * Every send, every delivery and every block is counted per gateway per
+ * organization, by UTC day, and a gateway that has REFUSED this
+ * organization twice in the last {@link OUTREACH_GATEWAY_WINDOW_DAYS} days
+ * without delivering once holds the next send into it: nothing goes into a
+ * gateway that has refused us twice unless a member says so. `other` never
+ * holds, because it is a bucket of unrelated exchanges rather than one
+ * gateway; `none` blocks instead.
+ *==========================================*/ export const OUTREACH_MAIL_GATEWAYS = [
+    'barracuda',
+    'proofpoint',
+    'mimecast',
+    'google',
+    'microsoft',
+    'other',
+    'none'
+];
+/** The gateway as the Check-people chip and the enrollment row name it. */ export const OUTREACH_MAIL_GATEWAY_LABELS = {
+    barracuda: 'Barracuda',
+    proofpoint: 'Proofpoint',
+    mimecast: 'Mimecast',
+    google: 'Google Workspace',
+    microsoft: 'Microsoft 365',
+    other: 'Other mail gateway',
+    none: 'No MX record'
+};
+/**
+ * The security gateways that stand in front of a whole company's mail and
+ * refuse a sender for everyone behind them: the ones the enroll dialog
+ * counts as "gateway-fronted".
+ */ export const OUTREACH_GATEWAY_FRONTED = [
+    'barracuda',
+    'proofpoint',
+    'mimecast'
+];
+/** Blocks in the window, with no delivery beside them, that hold the next send. */ export const OUTREACH_GATEWAY_HOLD_BLOCKS = 2;
+/** The days the hold is judged over. */ export const OUTREACH_GATEWAY_WINDOW_DAYS = 30;
+/** The days the Check-people chip counts. */ export const OUTREACH_GATEWAY_CHIP_DAYS = 7;
+/** How long a domain's MX answer is trusted before it is looked up again. */ export const OUTREACH_DOMAIN_INTEL_TTL_MS = 7 * 24 * 60 * 60 * 1000;
+/** A send with no bounce this long after it counts as delivered. */ export const OUTREACH_GATEWAY_DELIVERED_AFTER_MS = 24 * 60 * 60 * 1000;
+/** The MX host suffixes each named gateway answers as, lowercase, no trailing dot. */ const GATEWAY_HOST_SUFFIXES = [
+    [
+        'barracuda',
+        [
+            '.ess.barracudanetworks.com',
+            '.barracudanetworks.com'
+        ]
+    ],
+    [
+        'proofpoint',
+        [
+            '.pphosted.com',
+            '.ppe-hosted.com',
+            '.proofpoint.com'
+        ]
+    ],
+    [
+        'mimecast',
+        [
+            '.mimecast.com',
+            '.mimecast.co.za',
+            '.mimecast-offshore.com'
+        ]
+    ],
+    [
+        'google',
+        [
+            '.google.com',
+            '.googlemail.com',
+            '.gmail.com'
+        ]
+    ],
+    [
+        'microsoft',
+        [
+            '.mail.protection.outlook.com',
+            '.outlook.com',
+            '.protection.outlook.com'
+        ]
+    ]
+];
+/** A host as the suffix table reads it: lowercase, trimmed, no trailing dot. */ function normalizeHost(host) {
+    return String(host != null ? host : '').trim().toLowerCase().replace(/\.$/, '');
+}
+/**
+ * The gateway ONE host names, or `null` when it names none of the known
+ * ones — a Remote-MTA in a bounce, or one MX exchange.
+ */ export function outreachMailGatewayOfHost(host) {
+    const name = normalizeHost(host);
+    if (!name) return null;
+    for (const [gateway, suffixes] of GATEWAY_HOST_SUFFIXES){
+        if (suffixes.some((suffix)=>name === suffix.slice(1) || name.endsWith(suffix))) return gateway;
+    }
+    return null;
+}
+/**
+ * The gateway a domain's MX records name — see the module note. A domain
+ * whose exchanges name more than one is read as the first named one in MX
+ * order (the list is handed over lowest-priority-first); one that names
+ * none is `other`; an empty list is `none`.
+ */ export function classifyOutreachMailGateway(mxHosts) {
+    const hosts = mxHosts.map(normalizeHost).filter(Boolean);
+    // A lone "." (or an empty exchange) is RFC 7505's null MX: the domain
+    // says outright that it takes no mail.
+    if (!hosts.length) return 'none';
+    for (const host of hosts){
+        const gateway = outreachMailGatewayOfHost(host);
+        if (gateway) return gateway;
+    }
+    return 'other';
+}
+/** Whether the gateway is one of the security gateways that refuse a sender for a whole company. */ export function isOutreachGatewayFronted(gateway) {
+    return gateway !== null && gateway !== undefined && OUTREACH_GATEWAY_FRONTED.includes(gateway);
+}
+/** `YYYY-MM-DD` in UTC: the day a ledger entry is filed under. */ export function outreachGatewayDay(atMs) {
+    return new Date(atMs).toISOString().slice(0, 10);
+}
+const count = (value)=>{
+    const number = Number(value);
+    return Number.isFinite(number) ? Math.max(0, Math.floor(number)) : 0;
+};
+/** The ledger's counts summed over the last `days` UTC days, today included. */ export function outreachGatewayWindow(days, nowMs, windowDays) {
+    const summed = {
+        sent: 0,
+        delivered: 0,
+        blocked: 0
+    };
+    if (!days) return summed;
+    const oldest = outreachGatewayDay(nowMs - (windowDays - 1) * 86400000);
+    const newest = outreachGatewayDay(nowMs);
+    for (const [day, counts] of Object.entries(days)){
+        if (day < oldest || day > newest) continue;
+        summed.sent += count(counts == null ? void 0 : counts.sent);
+        summed.delivered += count(counts == null ? void 0 : counts.delivered);
+        summed.blocked += count(counts == null ? void 0 : counts.blocked);
+    }
+    return summed;
+}
+/** The ledger's days with everything older than `keepDays` dropped. */ export function pruneOutreachGatewayDays(days, nowMs, keepDays) {
+    const oldest = outreachGatewayDay(nowMs - (keepDays - 1) * 86400000);
+    return Object.fromEntries(Object.entries(days != null ? days : {}).filter(([day])=>day >= oldest));
+}
+/**
+ * Whether the gateway holds the next send — see the module note. A named
+ * gateway only: `other` is many exchanges, and `none` blocks instead.
+ */ export function outreachGatewayHolds(standing) {
+    if (standing.gateway === 'other' || standing.gateway === 'none') return false;
+    return count(standing.blocked30) >= OUTREACH_GATEWAY_HOLD_BLOCKS && count(standing.delivered30) === 0;
+}
+/** The sentence the hold is written with, on the enrollment and in the engine's reason. */ export function outreachGatewayHoldReason(gateway, blocked30) {
+    const name = OUTREACH_MAIL_GATEWAY_LABELS[gateway];
+    return `${name} refused this sender ${blocked30 === 2 ? 'twice' : `${blocked30} times`} in the last ` + `${OUTREACH_GATEWAY_WINDOW_DAYS} days and delivered nothing, so this email is held. ` + 'Resume the enrollment to send it anyway.';
+}
+/**
+ * The Check-people chip for one person, or `null` when there is nothing
+ * worth a chip: an unrecognized exchange with no verdict this week. Red for
+ * a gateway that refused this week, green for one that delivered, neutral
+ * for the hosted providers and the security gateways with no verdict yet,
+ * and blocked for a domain with no MX.
+ */ export function outreachGatewayChip(standing) {
+    if (!standing) return null;
+    const name = OUTREACH_MAIL_GATEWAY_LABELS[standing.gateway];
+    if (standing.gateway === 'none') return {
+        label: 'No MX record — cannot receive mail',
+        tone: 'blocked'
+    };
+    const blocked = count(standing.blocked7);
+    const delivered = count(standing.delivered7);
+    const settled = blocked + delivered;
+    if (blocked > 0) {
+        return {
+            label: `${name} · ${blocked} of ${settled} ${settled === 1 ? 'send' : 'sends'} refused this week`,
+            tone: 'refused'
+        };
+    }
+    if (delivered > 0) {
+        return {
+            label: `${name} · ${delivered} of ${settled} delivered this week`,
+            tone: 'delivered'
+        };
+    }
+    if (standing.gateway === 'other') return null;
+    return {
+        label: name,
+        tone: 'neutral'
+    };
+}
+
+//# sourceMappingURL=mail-gateway.js.map

package/src/lib/engine/mail-gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/outreach/src/lib/engine/mail-gateway.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/*==========================================\n * THE MX RECORD PREDICTS THE GATEWAY, AND THE GATEWAY'S HISTORY PREDICTS\n * THE BLOCK (AGL-3326).\n *\n * Two Barracuda gateways refused the same sender three days apart, and each\n * refusal was read only after the email had left: a hard bounce, a paused\n * mailbox, ten first emails still queued. Both domains had Barracuda ESS as\n * their MX, and a third enrolled domain with the same MX was stopped by hand\n * before it sent. So the signal is cheap and it is available BEFORE a send:\n * the domain's MX names the gateway in front of it, and what that gateway\n * has done with this organization's mail lately says what it will do next.\n *\n * ## The kinds\n *\n * A gateway is named by the MX host's suffix. `barracuda`, `proofpoint`\n * and `mimecast` are the security gateways that refuse a SENDER on policy\n * and reputation; `google` and `microsoft` are the two hosted providers,\n * which judge mail one message at a time; `other` is every self-hosted or\n * unrecognized exchange; `none` is a domain with no MX at all, which cannot\n * receive mail and blocks the enrollment outright.\n *\n * ## The ledger and the hold\n *\n * Every send, every delivery and every block is counted per gateway per\n * organization, by UTC day, and a gateway that has REFUSED this\n * organization twice in the last {@link OUTREACH_GATEWAY_WINDOW_DAYS} days\n * without delivering once holds the next send into it: nothing goes into a\n * gateway that has refused us twice unless a member says so. `other` never\n * holds, because it is a bucket of unrelated exchanges rather than one\n * gateway; `none` blocks instead.\n *==========================================*/\n\nexport type OutreachMailGateway =\n  | 'barracuda'\n  | 'proofpoint'\n  | 'mimecast'\n  | 'google'\n  | 'microsoft'\n  | 'other'\n  | 'none'\n\nexport const OUTREACH_MAIL_GATEWAYS: readonly OutreachMailGateway[] = [\n  'barracuda',\n  'proofpoint',\n  'mimecast',\n  'google',\n  'microsoft',\n  'other',\n  'none',\n]\n\n/** The gateway as the Check-people chip and the enrollment row name it. */\nexport const OUTREACH_MAIL_GATEWAY_LABELS: Record<OutreachMailGateway, string> = {\n  barracuda: 'Barracuda',\n  proofpoint: 'Proofpoint',\n  mimecast: 'Mimecast',\n  google: 'Google Workspace',\n  microsoft: 'Microsoft 365',\n  other: 'Other mail gateway',\n  none: 'No MX record',\n}\n\n/**\n * The security gateways that stand in front of a whole company's mail and\n * refuse a sender for everyone behind them: the ones the enroll dialog\n * counts as \"gateway-fronted\".\n */\nexport const OUTREACH_GATEWAY_FRONTED: readonly OutreachMailGateway[] = ['barracuda', 'proofpoint', 'mimecast']\n\n/** Blocks in the window, with no delivery beside them, that hold the next send. */\nexport const OUTREACH_GATEWAY_HOLD_BLOCKS = 2\n\n/** The days the hold is judged over. */\nexport const OUTREACH_GATEWAY_WINDOW_DAYS = 30\n\n/** The days the Check-people chip counts. */\nexport const OUTREACH_GATEWAY_CHIP_DAYS = 7\n\n/** How long a domain's MX answer is trusted before it is looked up again. */\nexport const OUTREACH_DOMAIN_INTEL_TTL_MS = 7 * 24 * 60 * 60 * 1000\n\n/** A send with no bounce this long after it counts as delivered. */\nexport const OUTREACH_GATEWAY_DELIVERED_AFTER_MS = 24 * 60 * 60 * 1000\n\n/** The MX host suffixes each named gateway answers as, lowercase, no trailing dot. */\nconst GATEWAY_HOST_SUFFIXES: ReadonlyArray<readonly [OutreachMailGateway, readonly string[]]> = [\n  ['barracuda', ['.ess.barracudanetworks.com', '.barracudanetworks.com']],\n  ['proofpoint', ['.pphosted.com', '.ppe-hosted.com', '.proofpoint.com']],\n  ['mimecast', ['.mimecast.com', '.mimecast.co.za', '.mimecast-offshore.com']],\n  ['google', ['.google.com', '.googlemail.com', '.gmail.com']],\n  ['microsoft', ['.mail.protection.outlook.com', '.outlook.com', '.protection.outlook.com']],\n]\n\n/** A host as the suffix table reads it: lowercase, trimmed, no trailing dot. */\nfunction normalizeHost(host: unknown): string {\n  return String(host ?? '')\n    .trim()\n    .toLowerCase()\n    .replace(/\\.$/, '')\n}\n\n/**\n * The gateway ONE host names, or `null` when it names none of the known\n * ones — a Remote-MTA in a bounce, or one MX exchange.\n */\nexport function outreachMailGatewayOfHost(host: unknown): OutreachMailGateway | null {\n  const name = normalizeHost(host)\n  if (!name) return null\n  for (const [gateway, suffixes] of GATEWAY_HOST_SUFFIXES) {\n    if (suffixes.some((suffix) => name === suffix.slice(1) || name.endsWith(suffix))) return gateway\n  }\n  return null\n}\n\n/**\n * The gateway a domain's MX records name — see the module note. A domain\n * whose exchanges name more than one is read as the first named one in MX\n * order (the list is handed over lowest-priority-first); one that names\n * none is `other`; an empty list is `none`.\n */\nexport function classifyOutreachMailGateway(mxHosts: readonly string[]): OutreachMailGateway {\n  const hosts = mxHosts.map(normalizeHost).filter(Boolean)\n  // A lone \".\" (or an empty exchange) is RFC 7505's null MX: the domain\n  // says outright that it takes no mail.\n  if (!hosts.length) return 'none'\n  for (const host of hosts) {\n    const gateway = outreachMailGatewayOfHost(host)\n    if (gateway) return gateway\n  }\n  return 'other'\n}\n\n/** Whether the gateway is one of the security gateways that refuse a sender for a whole company. */\nexport function isOutreachGatewayFronted(gateway: OutreachMailGateway | null | undefined): boolean {\n  return gateway !== null && gateway !== undefined && OUTREACH_GATEWAY_FRONTED.includes(gateway)\n}\n\n/** The counts one UTC day holds on a gateway's ledger. */\nexport interface OutreachGatewayDayCounts {\n  sent: number\n  delivered: number\n  blocked: number\n}\n\n/** `YYYY-MM-DD` in UTC: the day a ledger entry is filed under. */\nexport function outreachGatewayDay(atMs: number): string {\n  return new Date(atMs).toISOString().slice(0, 10)\n}\n\nconst count = (value: unknown): number => {\n  const number = Number(value)\n  return Number.isFinite(number) ? Math.max(0, Math.floor(number)) : 0\n}\n\n/** The ledger's counts summed over the last `days` UTC days, today included. */\nexport function outreachGatewayWindow(\n  days: Record<string, Partial<OutreachGatewayDayCounts>> | null | undefined,\n  nowMs: number,\n  windowDays: number,\n): OutreachGatewayDayCounts {\n  const summed: OutreachGatewayDayCounts = { sent: 0, delivered: 0, blocked: 0 }\n  if (!days) return summed\n  const oldest = outreachGatewayDay(nowMs - (windowDays - 1) * 86_400_000)\n  const newest = outreachGatewayDay(nowMs)\n  for (const [day, counts] of Object.entries(days)) {\n    if (day < oldest || day > newest) continue\n    summed.sent += count(counts?.sent)\n    summed.delivered += count(counts?.delivered)\n    summed.blocked += count(counts?.blocked)\n  }\n  return summed\n}\n\n/** The ledger's days with everything older than `keepDays` dropped. */\nexport function pruneOutreachGatewayDays<T>(\n  days: Record<string, T> | null | undefined,\n  nowMs: number,\n  keepDays: number,\n): Record<string, T> {\n  const oldest = outreachGatewayDay(nowMs - (keepDays - 1) * 86_400_000)\n  return Object.fromEntries(Object.entries(days ?? {}).filter(([day]) => day >= oldest))\n}\n\n/**\n * What the gates and the enroll dialog know about the gateway in front of\n * one address: which it is, and what it did with this organization's mail\n * over the chip's week and the hold's month.\n */\nexport interface OutreachGatewayStanding {\n  gateway: OutreachMailGateway\n  /** Blocks and deliveries in the last {@link OUTREACH_GATEWAY_CHIP_DAYS} days. */\n  blocked7: number\n  delivered7: number\n  /** Blocks and deliveries in the last {@link OUTREACH_GATEWAY_WINDOW_DAYS} days. */\n  blocked30: number\n  delivered30: number\n}\n\n/**\n * Whether the gateway holds the next send — see the module note. A named\n * gateway only: `other` is many exchanges, and `none` blocks instead.\n */\nexport function outreachGatewayHolds(standing: Pick<OutreachGatewayStanding, 'gateway' | 'blocked30' | 'delivered30'>): boolean {\n  if (standing.gateway === 'other' || standing.gateway === 'none') return false\n  return count(standing.blocked30) >= OUTREACH_GATEWAY_HOLD_BLOCKS && count(standing.delivered30) === 0\n}\n\n/** The sentence the hold is written with, on the enrollment and in the engine's reason. */\nexport function outreachGatewayHoldReason(gateway: OutreachMailGateway, blocked30: number): string {\n  const name = OUTREACH_MAIL_GATEWAY_LABELS[gateway]\n  return (\n    `${name} refused this sender ${blocked30 === 2 ? 'twice' : `${blocked30} times`} in the last ` +\n    `${OUTREACH_GATEWAY_WINDOW_DAYS} days and delivered nothing, so this email is held. ` +\n    'Resume the enrollment to send it anyway.'\n  )\n}\n\n/** The chip's tone: what color the Check-people step gives it. */\nexport type OutreachGatewayChipTone = 'refused' | 'delivered' | 'neutral' | 'blocked'\n\nexport interface OutreachGatewayChip {\n  label: string\n  tone: OutreachGatewayChipTone\n}\n\n/**\n * The Check-people chip for one person, or `null` when there is nothing\n * worth a chip: an unrecognized exchange with no verdict this week. Red for\n * a gateway that refused this week, green for one that delivered, neutral\n * for the hosted providers and the security gateways with no verdict yet,\n * and blocked for a domain with no MX.\n */\nexport function outreachGatewayChip(standing: OutreachGatewayStanding | null | undefined): OutreachGatewayChip | null {\n  if (!standing) return null\n  const name = OUTREACH_MAIL_GATEWAY_LABELS[standing.gateway]\n  if (standing.gateway === 'none') return { label: 'No MX record — cannot receive mail', tone: 'blocked' }\n  const blocked = count(standing.blocked7)\n  const delivered = count(standing.delivered7)\n  const settled = blocked + delivered\n  if (blocked > 0) {\n    return {\n      label: `${name} · ${blocked} of ${settled} ${settled === 1 ? 'send' : 'sends'} refused this week`,\n      tone: 'refused',\n    }\n  }\n  if (delivered > 0) {\n    return { label: `${name} · ${delivered} of ${settled} delivered this week`, tone: 'delivered' }\n  }\n  if (standing.gateway === 'other') return null\n  return { label: name, tone: 'neutral' }\n}\n"],"names":["OUTREACH_MAIL_GATEWAYS","OUTREACH_MAIL_GATEWAY_LABELS","barracuda","proofpoint","mimecast","google","microsoft","other","none","OUTREACH_GATEWAY_FRONTED","OUTREACH_GATEWAY_HOLD_BLOCKS","OUTREACH_GATEWAY_WINDOW_DAYS","OUTREACH_GATEWAY_CHIP_DAYS","OUTREACH_DOMAIN_INTEL_TTL_MS","OUTREACH_GATEWAY_DELIVERED_AFTER_MS","GATEWAY_HOST_SUFFIXES","normalizeHost","host","String","trim","toLowerCase","replace","outreachMailGatewayOfHost","name","gateway","suffixes","some","suffix","slice","endsWith","classifyOutreachMailGateway","mxHosts","hosts","map","filter","Boolean","length","isOutreachGatewayFronted","undefined","includes","outreachGatewayDay","atMs","Date","toISOString","count","value","number","Number","isFinite","Math","max","floor","outreachGatewayWindow","days","nowMs","windowDays","summed","sent","delivered","blocked","oldest","newest","day","counts","Object","entries","pruneOutreachGatewayDays","keepDays","fromEntries","outreachGatewayHolds","standing","blocked30","delivered30","outreachGatewayHoldReason","outreachGatewayChip","label","tone","blocked7","delivered7","settled"],"mappings":"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"}

package/src/lib/engine/mailbox-health.d.ts

@@ -18,8 +18,8 @@
 export declare const OUTREACH_PAUSE_BOUNCES_PER_DAY = 2;
 /** How many of the most recent sends the bounce rate is taken over. */
 export declare const OUTREACH_BOUNCE_RATE_WINDOW_SENDS = 50;
-/** The bounce rate a mailbox may not exceed over that window. */
-export declare const OUTREACH_PAUSE_BOUNCE_RATE = 0.03;
+/** Hard bounces in that window that pause the mailbox. */
+export declare const OUTREACH_PAUSE_BOUNCES_PER_WINDOW = 3;
 /**
  * The fewest sends the window must hold before its bounce rate is judged
  * (AGL-3244). Below it the daily rule alone pauses the mailbox.
@@ -27,7 +27,7 @@ export declare const OUTREACH_PAUSE_BOUNCE_RATE = 0.03;
 export declare const OUTREACH_BOUNCE_RATE_MIN_SENDS = 25;
 /** How long a spam complaint keeps a mailbox paused. */
 export declare const OUTREACH_COMPLAINT_PAUSE_MS: number;
-export type OutreachHealthPauseReason = 'bounces_today' | 'bounce_rate' | 'complaint';
+export type OutreachHealthPauseReason = 'bounces_today' | 'bounces_in_window' | 'complaint';
 export interface OutreachMailboxHealthInput {
     /** Hard bounces on this mailbox's mail received during its current local day. */
     bouncesToday: number;

package/src/lib/engine/mailbox-health.js

@@ -24,14 +24,21 @@
  *
  * - it collects {@link OUTREACH_PAUSE_BOUNCES_PER_DAY} hard bounces in one
  *   of its own days; or
- * - more than {@link OUTREACH_PAUSE_BOUNCE_RATE} of its last
+ * - {@link OUTREACH_PAUSE_BOUNCES_PER_WINDOW} of its last
  *   {@link OUTREACH_BOUNCE_RATE_WINDOW_SENDS} sends hard-bounced, once the
  *   window holds at least {@link OUTREACH_BOUNCE_RATE_MIN_SENDS} of them
- *   (AGL-3244). Under that floor one bounce IS the rate — 1 of 21 is 4.8% —
- *   and a single gateway block on a cold day closed a whole sending window
- *   on the strength of one address. A mailbox with fewer sends is still
- *   judged on the sends it has by the first rule: a second bounce in one
- *   day pauses it whatever the window holds; or
+ *   (AGL-3244). Under that floor one bounce IS the window — 1 of 21 — and a
+ *   single gateway block on a cold day closed a whole sending window on the
+ *   strength of one address. A mailbox with fewer sends is still judged on
+ *   the sends it has by the first rule: a second bounce in one day pauses
+ *   it whatever the window holds.
+ *
+ *   A COUNT, not a rate (AGL-3326). The rule was "more than 3% of the last
+ *   50", and 3% of fifty is one and a half: a bounce from two days ago plus
+ *   one today made 4%, and paused a mailbox on the strength of history the
+ *   daily rule had already judged and let pass. Two bounces in one day are
+ *   the first rule's; the window rule is for a slow drip the days hide, and
+ *   three of fifty is where a drip stops being one address; or
  * - a reply called its email spam in the last week — a complaint is worth a
  *   week of review, and the pause lasts until the week is out.
  *
@@ -39,7 +46,7 @@
  * and the sending server is still retrying it.
  *==========================================*/ /** Hard bounces in one mailbox day that pause the mailbox. */ export const OUTREACH_PAUSE_BOUNCES_PER_DAY = 2;
 /** How many of the most recent sends the bounce rate is taken over. */ export const OUTREACH_BOUNCE_RATE_WINDOW_SENDS = 50;
-/** The bounce rate a mailbox may not exceed over that window. */ export const OUTREACH_PAUSE_BOUNCE_RATE = 0.03;
+/** Hard bounces in that window that pause the mailbox. */ export const OUTREACH_PAUSE_BOUNCES_PER_WINDOW = 3;
 /**
  * The fewest sends the window must hold before its bounce rate is judged
  * (AGL-3244). Below it the daily rule alone pauses the mailbox.
@@ -61,12 +68,11 @@ const count = (value)=>{
     }
     const sends = Math.min(count(input.recentSends), OUTREACH_BOUNCE_RATE_WINDOW_SENDS);
     const bounces = Math.min(count(input.recentHardBounces), sends);
-    if (sends >= OUTREACH_BOUNCE_RATE_MIN_SENDS && bounces / sends > OUTREACH_PAUSE_BOUNCE_RATE) {
-        const percent = (bounces / sends * 100).toFixed(1);
+    if (sends >= OUTREACH_BOUNCE_RATE_MIN_SENDS && bounces >= OUTREACH_PAUSE_BOUNCES_PER_WINDOW) {
         return {
             pause: true,
-            reason: 'bounce_rate',
-            message: `Paused: ${bounces} of the last ${sends} emails hard-bounced (${percent}%). Re-check the addresses in your sequences before resuming.`,
+            reason: 'bounces_in_window',
+            message: `Paused: ${bounces} of the last ${sends} emails hard-bounced. Re-check the addresses in your sequences before resuming.`,
             pausedUntilMs: null
         };
     }

package/src/lib/engine/mailbox-health.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/outreach/src/lib/engine/mailbox-health.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/*==========================================\n * WHEN A MAILBOX STOPS ITSELF (AGL-2979).\n *\n * Bounces are the one signal a small sender gets early: at this volume the\n * mailbox providers' own dashboards show nothing, and a list with bad\n * addresses in it shows up as hard bounces days before it shows up as a\n * reputation problem. So a mailbox pauses itself, and a person re-checks\n * the list before it sends again, when:\n *\n * - it collects {@link OUTREACH_PAUSE_BOUNCES_PER_DAY} hard bounces in one\n *   of its own days; or\n * - more than {@link OUTREACH_PAUSE_BOUNCE_RATE} of its last\n *   {@link OUTREACH_BOUNCE_RATE_WINDOW_SENDS} sends hard-bounced, once the\n *   window holds at least {@link OUTREACH_BOUNCE_RATE_MIN_SENDS} of them\n *   (AGL-3244). Under that floor one bounce IS the rate — 1 of 21 is 4.8% —\n *   and a single gateway block on a cold day closed a whole sending window\n *   on the strength of one address. A mailbox with fewer sends is still\n *   judged on the sends it has by the first rule: a second bounce in one\n *   day pauses it whatever the window holds; or\n * - a reply called its email spam in the last week — a complaint is worth a\n *   week of review, and the pause lasts until the week is out.\n *\n * Only hard bounces count. A soft bounce is a full mailbox or a busy server,\n * and the sending server is still retrying it.\n *==========================================*/\n\n/** Hard bounces in one mailbox day that pause the mailbox. */\nexport const OUTREACH_PAUSE_BOUNCES_PER_DAY = 2\n\n/** How many of the most recent sends the bounce rate is taken over. */\nexport const OUTREACH_BOUNCE_RATE_WINDOW_SENDS = 50\n\n/** The bounce rate a mailbox may not exceed over that window. */\nexport const OUTREACH_PAUSE_BOUNCE_RATE = 0.03\n\n/**\n * The fewest sends the window must hold before its bounce rate is judged\n * (AGL-3244). Below it the daily rule alone pauses the mailbox.\n */\nexport const OUTREACH_BOUNCE_RATE_MIN_SENDS = 25\n\n/** How long a spam complaint keeps a mailbox paused. */\nexport const OUTREACH_COMPLAINT_PAUSE_MS = 7 * 24 * 60 * 60 * 1000\n\nexport type OutreachHealthPauseReason = 'bounces_today' | 'bounce_rate' | 'complaint'\n\nexport interface OutreachMailboxHealthInput {\n  /** Hard bounces on this mailbox's mail received during its current local day. */\n  bouncesToday: number\n  /**\n   * The mailbox's most recent sends — at most\n   * {@link OUTREACH_BOUNCE_RATE_WINDOW_SENDS} of them — and how many of\n   * those hard-bounced.\n   */\n  recentSends: number\n  recentHardBounces: number\n  /** When a reply last called this mailbox's email spam, or `null`. */\n  lastComplaintAtMs?: number | null\n  nowMs: number\n}\n\nexport interface OutreachMailboxHealthDecision {\n  pause: boolean\n  reason: OutreachHealthPauseReason | null\n  /** What the mailbox's page says, in a sentence. */\n  message: string | null\n  /** For a complaint, when the pause may end; `null` when a person has to resume it. */\n  pausedUntilMs: number | null\n}\n\nconst count = (value: unknown): number => {\n  const number = Number(value)\n  return Number.isFinite(number) ? Math.max(0, Math.floor(number)) : 0\n}\n\n/** Whether a mailbox should pause itself now — see the module note. */\nexport function decideOutreachMailboxHealth(\n  input: OutreachMailboxHealthInput,\n): OutreachMailboxHealthDecision {\n  const bouncesToday = count(input.bouncesToday)\n  if (bouncesToday >= OUTREACH_PAUSE_BOUNCES_PER_DAY) {\n    return {\n      pause: true,\n      reason: 'bounces_today',\n      message: `Paused after ${bouncesToday} hard bounces today. Re-check the addresses in your sequences before resuming.`,\n      pausedUntilMs: null,\n    }\n  }\n  const sends = Math.min(count(input.recentSends), OUTREACH_BOUNCE_RATE_WINDOW_SENDS)\n  const bounces = Math.min(count(input.recentHardBounces), sends)\n  if (sends >= OUTREACH_BOUNCE_RATE_MIN_SENDS && bounces / sends > OUTREACH_PAUSE_BOUNCE_RATE) {\n    const percent = ((bounces / sends) * 100).toFixed(1)\n    return {\n      pause: true,\n      reason: 'bounce_rate',\n      message: `Paused: ${bounces} of the last ${sends} emails hard-bounced (${percent}%). Re-check the addresses in your sequences before resuming.`,\n      pausedUntilMs: null,\n    }\n  }\n  const complaintAtMs = input.lastComplaintAtMs\n  if (\n    typeof complaintAtMs === 'number' &&\n    Number.isFinite(complaintAtMs) &&\n    input.nowMs < complaintAtMs + OUTREACH_COMPLAINT_PAUSE_MS\n  ) {\n    return {\n      pause: true,\n      reason: 'complaint',\n      message:\n        'Paused for a week after a reply called an email spam. Review who your sequences are reaching.',\n      pausedUntilMs: complaintAtMs + OUTREACH_COMPLAINT_PAUSE_MS,\n    }\n  }\n  return { pause: false, reason: null, message: null, pausedUntilMs: null }\n}\n"],"names":["OUTREACH_PAUSE_BOUNCES_PER_DAY","OUTREACH_BOUNCE_RATE_WINDOW_SENDS","OUTREACH_PAUSE_BOUNCE_RATE","OUTREACH_BOUNCE_RATE_MIN_SENDS","OUTREACH_COMPLAINT_PAUSE_MS","count","value","number","Number","isFinite","Math","max","floor","decideOutreachMailboxHealth","input","bouncesToday","pause","reason","message","pausedUntilMs","sends","min","recentSends","bounces","recentHardBounces","percent","toFixed","complaintAtMs","lastComplaintAtMs","nowMs"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;;;;;;;;;;4CAwB4C,GAE5C,4DAA4D,GAC5D,OAAO,MAAMA,iCAAiC,EAAC;AAE/C,qEAAqE,GACrE,OAAO,MAAMC,oCAAoC,GAAE;AAEnD,+DAA+D,GAC/D,OAAO,MAAMC,6BAA6B,KAAI;AAE9C;;;CAGC,GACD,OAAO,MAAMC,iCAAiC,GAAE;AAEhD,sDAAsD,GACtD,OAAO,MAAMC,8BAA8B,IAAI,KAAK,KAAK,KAAK,KAAI;AA4BlE,MAAMC,QAAQ,CAACC;IACb,MAAMC,SAASC,OAAOF;IACtB,OAAOE,OAAOC,QAAQ,CAACF,UAAUG,KAAKC,GAAG,CAAC,GAAGD,KAAKE,KAAK,CAACL,WAAW;AACrE;AAEA,qEAAqE,GACrE,OAAO,SAASM,4BACdC,KAAiC;IAEjC,MAAMC,eAAeV,MAAMS,MAAMC,YAAY;IAC7C,IAAIA,gBAAgBf,gCAAgC;QAClD,OAAO;YACLgB,OAAO;YACPC,QAAQ;YACRC,SAAS,CAAC,aAAa,EAAEH,aAAa,8EAA8E,CAAC;YACrHI,eAAe;QACjB;IACF;IACA,MAAMC,QAAQV,KAAKW,GAAG,CAAChB,MAAMS,MAAMQ,WAAW,GAAGrB;IACjD,MAAMsB,UAAUb,KAAKW,GAAG,CAAChB,MAAMS,MAAMU,iBAAiB,GAAGJ;IACzD,IAAIA,SAASjB,kCAAkCoB,UAAUH,QAAQlB,4BAA4B;QAC3F,MAAMuB,UAAU,AAAC,CAAA,AAACF,UAAUH,QAAS,GAAE,EAAGM,OAAO,CAAC;QAClD,OAAO;YACLV,OAAO;YACPC,QAAQ;YACRC,SAAS,CAAC,QAAQ,EAAEK,QAAQ,aAAa,EAAEH,MAAM,sBAAsB,EAAEK,QAAQ,6DAA6D,CAAC;YAC/IN,eAAe;QACjB;IACF;IACA,MAAMQ,gBAAgBb,MAAMc,iBAAiB;IAC7C,IACE,OAAOD,kBAAkB,YACzBnB,OAAOC,QAAQ,CAACkB,kBAChBb,MAAMe,KAAK,GAAGF,gBAAgBvB,6BAC9B;QACA,OAAO;YACLY,OAAO;YACPC,QAAQ;YACRC,SACE;YACFC,eAAeQ,gBAAgBvB;QACjC;IACF;IACA,OAAO;QAAEY,OAAO;QAAOC,QAAQ;QAAMC,SAAS;QAAMC,eAAe;IAAK;AAC1E"}
+{"version":3,"sources":["../../../../../../../libs/plugins/outreach/src/lib/engine/mailbox-health.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/*==========================================\n * WHEN A MAILBOX STOPS ITSELF (AGL-2979).\n *\n * Bounces are the one signal a small sender gets early: at this volume the\n * mailbox providers' own dashboards show nothing, and a list with bad\n * addresses in it shows up as hard bounces days before it shows up as a\n * reputation problem. So a mailbox pauses itself, and a person re-checks\n * the list before it sends again, when:\n *\n * - it collects {@link OUTREACH_PAUSE_BOUNCES_PER_DAY} hard bounces in one\n *   of its own days; or\n * - {@link OUTREACH_PAUSE_BOUNCES_PER_WINDOW} of its last\n *   {@link OUTREACH_BOUNCE_RATE_WINDOW_SENDS} sends hard-bounced, once the\n *   window holds at least {@link OUTREACH_BOUNCE_RATE_MIN_SENDS} of them\n *   (AGL-3244). Under that floor one bounce IS the window — 1 of 21 — and a\n *   single gateway block on a cold day closed a whole sending window on the\n *   strength of one address. A mailbox with fewer sends is still judged on\n *   the sends it has by the first rule: a second bounce in one day pauses\n *   it whatever the window holds.\n *\n *   A COUNT, not a rate (AGL-3326). The rule was \"more than 3% of the last\n *   50\", and 3% of fifty is one and a half: a bounce from two days ago plus\n *   one today made 4%, and paused a mailbox on the strength of history the\n *   daily rule had already judged and let pass. Two bounces in one day are\n *   the first rule's; the window rule is for a slow drip the days hide, and\n *   three of fifty is where a drip stops being one address; or\n * - a reply called its email spam in the last week — a complaint is worth a\n *   week of review, and the pause lasts until the week is out.\n *\n * Only hard bounces count. A soft bounce is a full mailbox or a busy server,\n * and the sending server is still retrying it.\n *==========================================*/\n\n/** Hard bounces in one mailbox day that pause the mailbox. */\nexport const OUTREACH_PAUSE_BOUNCES_PER_DAY = 2\n\n/** How many of the most recent sends the bounce rate is taken over. */\nexport const OUTREACH_BOUNCE_RATE_WINDOW_SENDS = 50\n\n/** Hard bounces in that window that pause the mailbox. */\nexport const OUTREACH_PAUSE_BOUNCES_PER_WINDOW = 3\n\n/**\n * The fewest sends the window must hold before its bounce rate is judged\n * (AGL-3244). Below it the daily rule alone pauses the mailbox.\n */\nexport const OUTREACH_BOUNCE_RATE_MIN_SENDS = 25\n\n/** How long a spam complaint keeps a mailbox paused. */\nexport const OUTREACH_COMPLAINT_PAUSE_MS = 7 * 24 * 60 * 60 * 1000\n\nexport type OutreachHealthPauseReason = 'bounces_today' | 'bounces_in_window' | 'complaint'\n\nexport interface OutreachMailboxHealthInput {\n  /** Hard bounces on this mailbox's mail received during its current local day. */\n  bouncesToday: number\n  /**\n   * The mailbox's most recent sends — at most\n   * {@link OUTREACH_BOUNCE_RATE_WINDOW_SENDS} of them — and how many of\n   * those hard-bounced.\n   */\n  recentSends: number\n  recentHardBounces: number\n  /** When a reply last called this mailbox's email spam, or `null`. */\n  lastComplaintAtMs?: number | null\n  nowMs: number\n}\n\nexport interface OutreachMailboxHealthDecision {\n  pause: boolean\n  reason: OutreachHealthPauseReason | null\n  /** What the mailbox's page says, in a sentence. */\n  message: string | null\n  /** For a complaint, when the pause may end; `null` when a person has to resume it. */\n  pausedUntilMs: number | null\n}\n\nconst count = (value: unknown): number => {\n  const number = Number(value)\n  return Number.isFinite(number) ? Math.max(0, Math.floor(number)) : 0\n}\n\n/** Whether a mailbox should pause itself now — see the module note. */\nexport function decideOutreachMailboxHealth(\n  input: OutreachMailboxHealthInput,\n): OutreachMailboxHealthDecision {\n  const bouncesToday = count(input.bouncesToday)\n  if (bouncesToday >= OUTREACH_PAUSE_BOUNCES_PER_DAY) {\n    return {\n      pause: true,\n      reason: 'bounces_today',\n      message: `Paused after ${bouncesToday} hard bounces today. Re-check the addresses in your sequences before resuming.`,\n      pausedUntilMs: null,\n    }\n  }\n  const sends = Math.min(count(input.recentSends), OUTREACH_BOUNCE_RATE_WINDOW_SENDS)\n  const bounces = Math.min(count(input.recentHardBounces), sends)\n  if (sends >= OUTREACH_BOUNCE_RATE_MIN_SENDS && bounces >= OUTREACH_PAUSE_BOUNCES_PER_WINDOW) {\n    return {\n      pause: true,\n      reason: 'bounces_in_window',\n      message: `Paused: ${bounces} of the last ${sends} emails hard-bounced. Re-check the addresses in your sequences before resuming.`,\n      pausedUntilMs: null,\n    }\n  }\n  const complaintAtMs = input.lastComplaintAtMs\n  if (\n    typeof complaintAtMs === 'number' &&\n    Number.isFinite(complaintAtMs) &&\n    input.nowMs < complaintAtMs + OUTREACH_COMPLAINT_PAUSE_MS\n  ) {\n    return {\n      pause: true,\n      reason: 'complaint',\n      message:\n        'Paused for a week after a reply called an email spam. Review who your sequences are reaching.',\n      pausedUntilMs: complaintAtMs + OUTREACH_COMPLAINT_PAUSE_MS,\n    }\n  }\n  return { pause: false, reason: null, message: null, pausedUntilMs: null }\n}\n"],"names":["OUTREACH_PAUSE_BOUNCES_PER_DAY","OUTREACH_BOUNCE_RATE_WINDOW_SENDS","OUTREACH_PAUSE_BOUNCES_PER_WINDOW","OUTREACH_BOUNCE_RATE_MIN_SENDS","OUTREACH_COMPLAINT_PAUSE_MS","count","value","number","Number","isFinite","Math","max","floor","decideOutreachMailboxHealth","input","bouncesToday","pause","reason","message","pausedUntilMs","sends","min","recentSends","bounces","recentHardBounces","complaintAtMs","lastComplaintAtMs","nowMs"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4CA+B4C,GAE5C,4DAA4D,GAC5D,OAAO,MAAMA,iCAAiC,EAAC;AAE/C,qEAAqE,GACrE,OAAO,MAAMC,oCAAoC,GAAE;AAEnD,wDAAwD,GACxD,OAAO,MAAMC,oCAAoC,EAAC;AAElD;;;CAGC,GACD,OAAO,MAAMC,iCAAiC,GAAE;AAEhD,sDAAsD,GACtD,OAAO,MAAMC,8BAA8B,IAAI,KAAK,KAAK,KAAK,KAAI;AA4BlE,MAAMC,QAAQ,CAACC;IACb,MAAMC,SAASC,OAAOF;IACtB,OAAOE,OAAOC,QAAQ,CAACF,UAAUG,KAAKC,GAAG,CAAC,GAAGD,KAAKE,KAAK,CAACL,WAAW;AACrE;AAEA,qEAAqE,GACrE,OAAO,SAASM,4BACdC,KAAiC;IAEjC,MAAMC,eAAeV,MAAMS,MAAMC,YAAY;IAC7C,IAAIA,gBAAgBf,gCAAgC;QAClD,OAAO;YACLgB,OAAO;YACPC,QAAQ;YACRC,SAAS,CAAC,aAAa,EAAEH,aAAa,8EAA8E,CAAC;YACrHI,eAAe;QACjB;IACF;IACA,MAAMC,QAAQV,KAAKW,GAAG,CAAChB,MAAMS,MAAMQ,WAAW,GAAGrB;IACjD,MAAMsB,UAAUb,KAAKW,GAAG,CAAChB,MAAMS,MAAMU,iBAAiB,GAAGJ;IACzD,IAAIA,SAASjB,kCAAkCoB,WAAWrB,mCAAmC;QAC3F,OAAO;YACLc,OAAO;YACPC,QAAQ;YACRC,SAAS,CAAC,QAAQ,EAAEK,QAAQ,aAAa,EAAEH,MAAM,+EAA+E,CAAC;YACjID,eAAe;QACjB;IACF;IACA,MAAMM,gBAAgBX,MAAMY,iBAAiB;IAC7C,IACE,OAAOD,kBAAkB,YACzBjB,OAAOC,QAAQ,CAACgB,kBAChBX,MAAMa,KAAK,GAAGF,gBAAgBrB,6BAC9B;QACA,OAAO;YACLY,OAAO;YACPC,QAAQ;YACRC,SACE;YACFC,eAAeM,gBAAgBrB;QACjC;IACF;IACA,OAAO;QAAEY,OAAO;QAAOC,QAAQ;QAAMC,SAAS;QAAMC,eAAe;IAAK;AAC1E"}

package/src/lib/engine/thread-classification.d.ts

@@ -21,6 +21,8 @@ export interface OutreachBounceDetail {
     recipients: string[];
     status: string | null;
     diagnostic: string | null;
+    /** The receiving server the report names, when it does (AGL-3326). */
+    remoteMta: string | null;
 }
 export interface OutreachMessageClassification {
     messageId: string;

package/src/lib/engine/thread-classification.js

@@ -122,7 +122,8 @@ function readableText(message) {
             bounce: {
                 recipients: report.failedAddresses,
                 status: report.status,
-                diagnostic: report.diagnostic
+                diagnostic: report.diagnostic,
+                remoteMta: report.remoteMta
             },
             evidence: report.status ? `Status: ${report.status}` : 'delivery report'
         });

package/src/lib/engine/thread-classification.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/outreach/src/lib/engine/thread-classification.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/*==========================================\n * WHAT CAME BACK (AGL-2979).\n *\n * The runtime reads each enrollment's threads and asks what the new\n * messages mean. Each message is one of:\n *\n * - `self` — the mailbox's own: a step, or the rep writing in the thread.\n * - `hard_bounce` / `soft_bounce` — a delivery report (`./delivery-status.ts`).\n * - `delivery_report` — a mail system's message that reports no failure.\n * - `auto_reply` — an out-of-office or an autoresponder. It POSTPONES the\n *   next step and does not stop the sequence: nobody answered.\n * - `opt_out` — a reply that asks to be left alone (`./opt-out-intent.ts`),\n *   or a message sent to the unsubscribe address.\n * - `reply` — any other message from anybody else.\n *\n * ## Automatic replies\n *\n * Read from the headers the standards give an autoresponder —\n * `Auto-Submitted` with any value but `no` (RFC 3834), `X-Autoreply`,\n * `X-Autorespond`, `Precedence: auto_reply`, `bulk` or `junk` — and, for\n * the servers that set none, from an out-of-office subject in the usual\n * languages.\n *\n * ## The thread's outcome\n *\n * `opted_out` outranks `replied`, which outranks `bounced`, which outranks\n * `postpone`: an opt-out is a reply that also has to reach the do-not-contact\n * list, a person who wrote back matters more than a report about an earlier\n * send, and an out-of-office only matters when nothing else happened. The\n * bounces that report this recipient are counted either way, because mailbox\n * health counts every one.\n *==========================================*/\n\nimport { normalizeContactEmail } from '@aglyn/aglyn/app-utils/contacts'\nimport { crmThreadSubject, emailAddressOf, htmlToPlainText } from '@aglyn/aglyn/app-utils/crm-inbound'\nimport { readOutreachDeliveryReport, isMailerDaemonMessage } from './delivery-status'\nimport { detectOutreachOptOutIntent, detectOutreachOptOutSubject } from './opt-out-intent'\nimport { outreachHeader, type OutreachThreadMessage } from './thread-message'\n\nexport type OutreachMessageKind =\n  | 'self'\n  | 'hard_bounce'\n  | 'soft_bounce'\n  | 'delivery_report'\n  | 'auto_reply'\n  | 'opt_out'\n  | 'reply'\n\nexport interface OutreachBounceDetail {\n  /** The addresses the report says failed; empty when it names none. */\n  recipients: string[]\n  status: string | null\n  diagnostic: string | null\n}\n\nexport interface OutreachMessageClassification {\n  messageId: string\n  atMs: number\n  kind: OutreachMessageKind\n  /** The sender's address, normalized, when the `From` carried one. */\n  from: string | null\n  /** Set on a bounce. */\n  bounce: OutreachBounceDetail | null\n  /** An opt-out that calls the email spam. */\n  complaint: boolean\n  /** What decided it, for the timeline and the log. */\n  evidence: string | null\n}\n\nexport interface OutreachMessageContext {\n  /** The mailbox's own addresses: the account's and every alias it sends as. */\n  selfAddresses: readonly string[]\n  /** The address a `List-Unsubscribe` mailto points at, when the runtime set one. */\n  unsubscribeAddress?: string | null\n  /** The subject the thread was started with, so a new subject can be read on its own. */\n  threadSubject?: string | null\n}\n\nconst AUTO_REPLY_SUBJECT = new RegExp(\n  [\n    '^\\\\s*\\\\[?\\\\s*(',\n    'auto(matic)?[\\\\s-]*(reply|response|responder|answer)',\n    '|out[\\\\s-]+of[\\\\s-]+(the[\\\\s-]+)?office',\n    '|ooo\\\\b',\n    \"|i('m| am) (currently )?(out of the office|away|on (vacation|leave|holiday))\",\n    '|(on )?(vacation|holiday|annual leave)[\\\\s-]*(reply|response|notice|message|autoreply)',\n    '|away from (the |my )?(office|desk)',\n    '|abwesenheitsnotiz|abwesenheit',\n    '|r[ée]ponse automatique|absence du bureau',\n    '|respuesta autom[áa]tica|fuera de la oficina',\n    '|risposta automatica|fuori ufficio',\n    '|automatisch antwoord|afwezigheidsbericht',\n    '|resposta autom[áa]tica|fora do escrit[óo]rio',\n    '|autosvar|automaattinen vastaus',\n    ')',\n  ].join(''),\n  'i',\n)\n\n/**\n * Why a message is an automatic reply, or `null` when it is not one — see\n * the module note for the headers and subjects read.\n */\nexport function outreachAutoReplyEvidence(\n  message: Pick<OutreachThreadMessage, 'headers' | 'subject'>,\n): string | null {\n  const autoSubmitted = outreachHeader(message, 'Auto-Submitted').split(';')[0].trim().toLowerCase()\n  if (autoSubmitted && autoSubmitted !== 'no') return `Auto-Submitted: ${autoSubmitted}`\n  for (const name of ['X-Autoreply', 'X-Autorespond']) {\n    const value = outreachHeader(message, name).trim()\n    if (value && value.toLowerCase() !== 'no') return `${name}: ${value}`\n  }\n  const precedence = outreachHeader(message, 'Precedence').trim().toLowerCase()\n  if (['auto_reply', 'bulk', 'junk'].includes(precedence)) return `Precedence: ${precedence}`\n  const subject = String(message?.subject ?? '').replace(/^\\s*(re|fwd?)\\s*:\\s*/i, '')\n  const match = AUTO_REPLY_SUBJECT.exec(subject)\n  return match ? `Subject: ${match[0].trim()}` : null\n}\n\nfunction addressesIn(header: string): string[] {\n  return header\n    .split(',')\n    .map((part) => emailAddressOf(part))\n    .filter((address): address is string => address !== null)\n}\n\nfunction readableText(message: OutreachThreadMessage): string {\n  if (message.textBody && message.textBody.trim()) return message.textBody\n  if (message.htmlBody && message.htmlBody.trim()) return htmlToPlainText(message.htmlBody)\n  return message.snippet ?? ''\n}\n\n/** What one message in an enrollment's thread is — see the module note. */\nexport function classifyOutreachMessage(\n  message: OutreachThreadMessage,\n  context: OutreachMessageContext,\n): OutreachMessageClassification {\n  const from = emailAddressOf(message.from)\n  const base = {\n    messageId: String(message.id ?? ''),\n    atMs: Number.isFinite(message.internalDateMs) ? message.internalDateMs : 0,\n    from,\n    bounce: null,\n    complaint: false,\n    evidence: null,\n  }\n\n  const report = readOutreachDeliveryReport(message)\n  if (report) {\n    if (!report.kind) return { ...base, kind: 'delivery_report', evidence: 'delivery report' }\n    return {\n      ...base,\n      kind: report.kind === 'hard' ? 'hard_bounce' : 'soft_bounce',\n      bounce: {\n        recipients: report.failedAddresses,\n        status: report.status,\n        diagnostic: report.diagnostic,\n      },\n      evidence: report.status ? `Status: ${report.status}` : 'delivery report',\n    }\n  }\n\n  const self = new Set(\n    (context.selfAddresses ?? [])\n      .map((address) => normalizeContactEmail(address))\n      .filter((address): address is string => address !== null),\n  )\n  if (from && self.has(from)) return { ...base, kind: 'self' }\n  if (isMailerDaemonMessage(message)) {\n    return { ...base, kind: 'delivery_report', evidence: 'mail system message' }\n  }\n\n  const unsubscribe = normalizeContactEmail(context.unsubscribeAddress)\n  if (unsubscribe && addressesIn(message.to ?? '').includes(unsubscribe)) {\n    return { ...base, kind: 'opt_out', evidence: `To: ${unsubscribe}` }\n  }\n\n  const autoReply = outreachAutoReplyEvidence(message)\n  if (autoReply) return { ...base, kind: 'auto_reply', evidence: autoReply }\n\n  const intent = detectOutreachOptOutIntent(readableText(message))\n  if (intent.optOut) {\n    return { ...base, kind: 'opt_out', complaint: intent.complaint, evidence: intent.matched }\n  }\n  // A subject is read only on a message that starts fresh — no `Re:`, and\n  // not the thread's own — and only when it says nothing but stop.\n  const subject = String(message.subject ?? '').replace(/\\s+/g, ' ').trim()\n  const fresh = crmThreadSubject(subject) === subject\n  if (subject && fresh && subject !== crmThreadSubject(context.threadSubject)) {\n    const subjectIntent = detectOutreachOptOutSubject(subject)\n    if (subjectIntent.optOut) {\n      return { ...base, kind: 'opt_out', evidence: `Subject: ${subjectIntent.matched}` }\n    }\n  }\n  return { ...base, kind: 'reply' }\n}\n\nexport type OutreachThreadOutcome = 'none' | 'postpone' | 'bounced' | 'replied' | 'opted_out'\n\nexport interface OutreachThreadDecisionInput extends OutreachMessageContext {\n  /** The thread's messages, in any order. */\n  messages: readonly OutreachThreadMessage[]\n  /** The enrollment's recipient. */\n  recipient: string\n  /** Messages received at or before this instant were handled by an earlier run. */\n  afterMs?: number | null\n  /** Ids of messages an earlier run handled. */\n  handledMessageIds?: readonly string[]\n}\n\nexport interface OutreachThreadDecision {\n  outcome: OutreachThreadOutcome\n  /** The message that decided the outcome; `null` for `none`. */\n  decidedBy: OutreachMessageClassification | null\n  /** Every new message, classified, oldest first. */\n  classifications: OutreachMessageClassification[]\n  /** A new reply called the email spam: the mailbox is paused as well. */\n  complaint: boolean\n  /** New hard bounces that report this recipient. */\n  hardBounces: number\n  /** New soft bounces that report this recipient. */\n  softBounces: number\n}\n\nconst RANK: Record<OutreachThreadOutcome, number> = {\n  none: 0,\n  postpone: 1,\n  bounced: 2,\n  replied: 3,\n  opted_out: 4,\n}\n\nconst OUTCOME_OF: Partial<Record<OutreachMessageKind, OutreachThreadOutcome>> = {\n  auto_reply: 'postpone',\n  hard_bounce: 'bounced',\n  reply: 'replied',\n  opt_out: 'opted_out',\n}\n\n/** What the new messages in an enrollment's thread mean for it — see the module note. */\nexport function decideOutreachThread(input: OutreachThreadDecisionInput): OutreachThreadDecision {\n  const recipient = normalizeContactEmail(input.recipient)\n  const handled = new Set(input.handledMessageIds ?? [])\n  const afterMs = typeof input.afterMs === 'number' ? input.afterMs : null\n  const fresh = [...(input.messages ?? [])]\n    .filter((message) => message && !handled.has(message.id))\n    .filter((message) => afterMs === null || message.internalDateMs > afterMs)\n    .sort((a, b) => a.internalDateMs - b.internalDateMs)\n\n  const decision: OutreachThreadDecision = {\n    outcome: 'none',\n    decidedBy: null,\n    classifications: [],\n    complaint: false,\n    hardBounces: 0,\n    softBounces: 0,\n  }\n  for (const message of fresh) {\n    const classification = classifyOutreachMessage(message, input)\n    decision.classifications.push(classification)\n    const bounce = classification.bounce\n    const aboutRecipient =\n      !bounce || !bounce.recipients.length || (recipient !== null && bounce.recipients.includes(recipient))\n    if (classification.kind === 'hard_bounce' && aboutRecipient) decision.hardBounces += 1\n    if (classification.kind === 'soft_bounce' && aboutRecipient) decision.softBounces += 1\n    if (classification.complaint) decision.complaint = true\n    const outcome = OUTCOME_OF[classification.kind]\n    if (!outcome || (classification.kind === 'hard_bounce' && !aboutRecipient)) continue\n    if (RANK[outcome] > RANK[decision.outcome]) {\n      decision.outcome = outcome\n      decision.decidedBy = classification\n    }\n  }\n  return decision\n}\n"],"names":["normalizeContactEmail","crmThreadSubject","emailAddressOf","htmlToPlainText","readOutreachDeliveryReport","isMailerDaemonMessage","detectOutreachOptOutIntent","detectOutreachOptOutSubject","outreachHeader","AUTO_REPLY_SUBJECT","RegExp","join","outreachAutoReplyEvidence","message","autoSubmitted","split","trim","toLowerCase","name","value","precedence","includes","subject","String","replace","match","exec","addressesIn","header","map","part","filter","address","readableText","textBody","htmlBody","snippet","classifyOutreachMessage","context","from","base","messageId","id","atMs","Number","isFinite","internalDateMs","bounce","complaint","evidence","report","kind","recipients","failedAddresses","status","diagnostic","self","Set","selfAddresses","has","unsubscribe","unsubscribeAddress","to","autoReply","intent","optOut","matched","fresh","threadSubject","subjectIntent","RANK","none","postpone","bounced","replied","opted_out","OUTCOME_OF","auto_reply","hard_bounce","reply","opt_out","decideOutreachThread","input","recipient","handled","handledMessageIds","afterMs","messages","sort","a","b","decision","outcome","decidedBy","classifications","hardBounces","softBounces","classification","push","aboutRecipient","length"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/outreach/src/lib/engine/thread-classification.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/*==========================================\n * WHAT CAME BACK (AGL-2979).\n *\n * The runtime reads each enrollment's threads and asks what the new\n * messages mean. Each message is one of:\n *\n * - `self` — the mailbox's own: a step, or the rep writing in the thread.\n * - `hard_bounce` / `soft_bounce` — a delivery report (`./delivery-status.ts`).\n * - `delivery_report` — a mail system's message that reports no failure.\n * - `auto_reply` — an out-of-office or an autoresponder. It POSTPONES the\n *   next step and does not stop the sequence: nobody answered.\n * - `opt_out` — a reply that asks to be left alone (`./opt-out-intent.ts`),\n *   or a message sent to the unsubscribe address.\n * - `reply` — any other message from anybody else.\n *\n * ## Automatic replies\n *\n * Read from the headers the standards give an autoresponder —\n * `Auto-Submitted` with any value but `no` (RFC 3834), `X-Autoreply`,\n * `X-Autorespond`, `Precedence: auto_reply`, `bulk` or `junk` — and, for\n * the servers that set none, from an out-of-office subject in the usual\n * languages.\n *\n * ## The thread's outcome\n *\n * `opted_out` outranks `replied`, which outranks `bounced`, which outranks\n * `postpone`: an opt-out is a reply that also has to reach the do-not-contact\n * list, a person who wrote back matters more than a report about an earlier\n * send, and an out-of-office only matters when nothing else happened. The\n * bounces that report this recipient are counted either way, because mailbox\n * health counts every one.\n *==========================================*/\n\nimport { normalizeContactEmail } from '@aglyn/aglyn/app-utils/contacts'\nimport { crmThreadSubject, emailAddressOf, htmlToPlainText } from '@aglyn/aglyn/app-utils/crm-inbound'\nimport { readOutreachDeliveryReport, isMailerDaemonMessage } from './delivery-status'\nimport { detectOutreachOptOutIntent, detectOutreachOptOutSubject } from './opt-out-intent'\nimport { outreachHeader, type OutreachThreadMessage } from './thread-message'\n\nexport type OutreachMessageKind =\n  | 'self'\n  | 'hard_bounce'\n  | 'soft_bounce'\n  | 'delivery_report'\n  | 'auto_reply'\n  | 'opt_out'\n  | 'reply'\n\nexport interface OutreachBounceDetail {\n  /** The addresses the report says failed; empty when it names none. */\n  recipients: string[]\n  status: string | null\n  diagnostic: string | null\n  /** The receiving server the report names, when it does (AGL-3326). */\n  remoteMta: string | null\n}\n\nexport interface OutreachMessageClassification {\n  messageId: string\n  atMs: number\n  kind: OutreachMessageKind\n  /** The sender's address, normalized, when the `From` carried one. */\n  from: string | null\n  /** Set on a bounce. */\n  bounce: OutreachBounceDetail | null\n  /** An opt-out that calls the email spam. */\n  complaint: boolean\n  /** What decided it, for the timeline and the log. */\n  evidence: string | null\n}\n\nexport interface OutreachMessageContext {\n  /** The mailbox's own addresses: the account's and every alias it sends as. */\n  selfAddresses: readonly string[]\n  /** The address a `List-Unsubscribe` mailto points at, when the runtime set one. */\n  unsubscribeAddress?: string | null\n  /** The subject the thread was started with, so a new subject can be read on its own. */\n  threadSubject?: string | null\n}\n\nconst AUTO_REPLY_SUBJECT = new RegExp(\n  [\n    '^\\\\s*\\\\[?\\\\s*(',\n    'auto(matic)?[\\\\s-]*(reply|response|responder|answer)',\n    '|out[\\\\s-]+of[\\\\s-]+(the[\\\\s-]+)?office',\n    '|ooo\\\\b',\n    \"|i('m| am) (currently )?(out of the office|away|on (vacation|leave|holiday))\",\n    '|(on )?(vacation|holiday|annual leave)[\\\\s-]*(reply|response|notice|message|autoreply)',\n    '|away from (the |my )?(office|desk)',\n    '|abwesenheitsnotiz|abwesenheit',\n    '|r[ée]ponse automatique|absence du bureau',\n    '|respuesta autom[áa]tica|fuera de la oficina',\n    '|risposta automatica|fuori ufficio',\n    '|automatisch antwoord|afwezigheidsbericht',\n    '|resposta autom[áa]tica|fora do escrit[óo]rio',\n    '|autosvar|automaattinen vastaus',\n    ')',\n  ].join(''),\n  'i',\n)\n\n/**\n * Why a message is an automatic reply, or `null` when it is not one — see\n * the module note for the headers and subjects read.\n */\nexport function outreachAutoReplyEvidence(\n  message: Pick<OutreachThreadMessage, 'headers' | 'subject'>,\n): string | null {\n  const autoSubmitted = outreachHeader(message, 'Auto-Submitted').split(';')[0].trim().toLowerCase()\n  if (autoSubmitted && autoSubmitted !== 'no') return `Auto-Submitted: ${autoSubmitted}`\n  for (const name of ['X-Autoreply', 'X-Autorespond']) {\n    const value = outreachHeader(message, name).trim()\n    if (value && value.toLowerCase() !== 'no') return `${name}: ${value}`\n  }\n  const precedence = outreachHeader(message, 'Precedence').trim().toLowerCase()\n  if (['auto_reply', 'bulk', 'junk'].includes(precedence)) return `Precedence: ${precedence}`\n  const subject = String(message?.subject ?? '').replace(/^\\s*(re|fwd?)\\s*:\\s*/i, '')\n  const match = AUTO_REPLY_SUBJECT.exec(subject)\n  return match ? `Subject: ${match[0].trim()}` : null\n}\n\nfunction addressesIn(header: string): string[] {\n  return header\n    .split(',')\n    .map((part) => emailAddressOf(part))\n    .filter((address): address is string => address !== null)\n}\n\nfunction readableText(message: OutreachThreadMessage): string {\n  if (message.textBody && message.textBody.trim()) return message.textBody\n  if (message.htmlBody && message.htmlBody.trim()) return htmlToPlainText(message.htmlBody)\n  return message.snippet ?? ''\n}\n\n/** What one message in an enrollment's thread is — see the module note. */\nexport function classifyOutreachMessage(\n  message: OutreachThreadMessage,\n  context: OutreachMessageContext,\n): OutreachMessageClassification {\n  const from = emailAddressOf(message.from)\n  const base = {\n    messageId: String(message.id ?? ''),\n    atMs: Number.isFinite(message.internalDateMs) ? message.internalDateMs : 0,\n    from,\n    bounce: null,\n    complaint: false,\n    evidence: null,\n  }\n\n  const report = readOutreachDeliveryReport(message)\n  if (report) {\n    if (!report.kind) return { ...base, kind: 'delivery_report', evidence: 'delivery report' }\n    return {\n      ...base,\n      kind: report.kind === 'hard' ? 'hard_bounce' : 'soft_bounce',\n      bounce: {\n        recipients: report.failedAddresses,\n        status: report.status,\n        diagnostic: report.diagnostic,\n        remoteMta: report.remoteMta,\n      },\n      evidence: report.status ? `Status: ${report.status}` : 'delivery report',\n    }\n  }\n\n  const self = new Set(\n    (context.selfAddresses ?? [])\n      .map((address) => normalizeContactEmail(address))\n      .filter((address): address is string => address !== null),\n  )\n  if (from && self.has(from)) return { ...base, kind: 'self' }\n  if (isMailerDaemonMessage(message)) {\n    return { ...base, kind: 'delivery_report', evidence: 'mail system message' }\n  }\n\n  const unsubscribe = normalizeContactEmail(context.unsubscribeAddress)\n  if (unsubscribe && addressesIn(message.to ?? '').includes(unsubscribe)) {\n    return { ...base, kind: 'opt_out', evidence: `To: ${unsubscribe}` }\n  }\n\n  const autoReply = outreachAutoReplyEvidence(message)\n  if (autoReply) return { ...base, kind: 'auto_reply', evidence: autoReply }\n\n  const intent = detectOutreachOptOutIntent(readableText(message))\n  if (intent.optOut) {\n    return { ...base, kind: 'opt_out', complaint: intent.complaint, evidence: intent.matched }\n  }\n  // A subject is read only on a message that starts fresh — no `Re:`, and\n  // not the thread's own — and only when it says nothing but stop.\n  const subject = String(message.subject ?? '').replace(/\\s+/g, ' ').trim()\n  const fresh = crmThreadSubject(subject) === subject\n  if (subject && fresh && subject !== crmThreadSubject(context.threadSubject)) {\n    const subjectIntent = detectOutreachOptOutSubject(subject)\n    if (subjectIntent.optOut) {\n      return { ...base, kind: 'opt_out', evidence: `Subject: ${subjectIntent.matched}` }\n    }\n  }\n  return { ...base, kind: 'reply' }\n}\n\nexport type OutreachThreadOutcome = 'none' | 'postpone' | 'bounced' | 'replied' | 'opted_out'\n\nexport interface OutreachThreadDecisionInput extends OutreachMessageContext {\n  /** The thread's messages, in any order. */\n  messages: readonly OutreachThreadMessage[]\n  /** The enrollment's recipient. */\n  recipient: string\n  /** Messages received at or before this instant were handled by an earlier run. */\n  afterMs?: number | null\n  /** Ids of messages an earlier run handled. */\n  handledMessageIds?: readonly string[]\n}\n\nexport interface OutreachThreadDecision {\n  outcome: OutreachThreadOutcome\n  /** The message that decided the outcome; `null` for `none`. */\n  decidedBy: OutreachMessageClassification | null\n  /** Every new message, classified, oldest first. */\n  classifications: OutreachMessageClassification[]\n  /** A new reply called the email spam: the mailbox is paused as well. */\n  complaint: boolean\n  /** New hard bounces that report this recipient. */\n  hardBounces: number\n  /** New soft bounces that report this recipient. */\n  softBounces: number\n}\n\nconst RANK: Record<OutreachThreadOutcome, number> = {\n  none: 0,\n  postpone: 1,\n  bounced: 2,\n  replied: 3,\n  opted_out: 4,\n}\n\nconst OUTCOME_OF: Partial<Record<OutreachMessageKind, OutreachThreadOutcome>> = {\n  auto_reply: 'postpone',\n  hard_bounce: 'bounced',\n  reply: 'replied',\n  opt_out: 'opted_out',\n}\n\n/** What the new messages in an enrollment's thread mean for it — see the module note. */\nexport function decideOutreachThread(input: OutreachThreadDecisionInput): OutreachThreadDecision {\n  const recipient = normalizeContactEmail(input.recipient)\n  const handled = new Set(input.handledMessageIds ?? [])\n  const afterMs = typeof input.afterMs === 'number' ? input.afterMs : null\n  const fresh = [...(input.messages ?? [])]\n    .filter((message) => message && !handled.has(message.id))\n    .filter((message) => afterMs === null || message.internalDateMs > afterMs)\n    .sort((a, b) => a.internalDateMs - b.internalDateMs)\n\n  const decision: OutreachThreadDecision = {\n    outcome: 'none',\n    decidedBy: null,\n    classifications: [],\n    complaint: false,\n    hardBounces: 0,\n    softBounces: 0,\n  }\n  for (const message of fresh) {\n    const classification = classifyOutreachMessage(message, input)\n    decision.classifications.push(classification)\n    const bounce = classification.bounce\n    const aboutRecipient =\n      !bounce || !bounce.recipients.length || (recipient !== null && bounce.recipients.includes(recipient))\n    if (classification.kind === 'hard_bounce' && aboutRecipient) decision.hardBounces += 1\n    if (classification.kind === 'soft_bounce' && aboutRecipient) decision.softBounces += 1\n    if (classification.complaint) decision.complaint = true\n    const outcome = OUTCOME_OF[classification.kind]\n    if (!outcome || (classification.kind === 'hard_bounce' && !aboutRecipient)) continue\n    if (RANK[outcome] > RANK[decision.outcome]) {\n      decision.outcome = outcome\n      decision.decidedBy = classification\n    }\n  }\n  return decision\n}\n"],"names":["normalizeContactEmail","crmThreadSubject","emailAddressOf","htmlToPlainText","readOutreachDeliveryReport","isMailerDaemonMessage","detectOutreachOptOutIntent","detectOutreachOptOutSubject","outreachHeader","AUTO_REPLY_SUBJECT","RegExp","join","outreachAutoReplyEvidence","message","autoSubmitted","split","trim","toLowerCase","name","value","precedence","includes","subject","String","replace","match","exec","addressesIn","header","map","part","filter","address","readableText","textBody","htmlBody","snippet","classifyOutreachMessage","context","from","base","messageId","id","atMs","Number","isFinite","internalDateMs","bounce","complaint","evidence","report","kind","recipients","failedAddresses","status","diagnostic","remoteMta","self","Set","selfAddresses","has","unsubscribe","unsubscribeAddress","to","autoReply","intent","optOut","matched","fresh","threadSubject","subjectIntent","RANK","none","postpone","bounced","replied","opted_out","OUTCOME_OF","auto_reply","hard_bounce","reply","opt_out","decideOutreachThread","input","recipient","handled","handledMessageIds","afterMs","messages","sort","a","b","decision","outcome","decidedBy","classifications","hardBounces","softBounces","classification","push","aboutRecipient","length"],"mappings":"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"}

package/src/lib/enrollment/enroll-people.d.ts

@@ -14,7 +14,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { type OutreachGateLookups } from '../engine/gates';
+import { type OutreachGateHold, type OutreachGateLookups } from '../engine/gates';
 import { type OutreachAttestations, type OutreachSequenceSettings } from '../model/outreach.types';
 import type { OutreachEnrollBlock, OutreachEnrollPreviewPerson, OutreachPersonRef } from '../model/outreach-api';
 type Firestore = FirebaseFirestore.Firestore;
@@ -112,6 +112,11 @@ export interface OutreachEnrollDecision {
     email: string | null;
     /** What the rep confirmed, stamped with who and when. */
     attestations: OutreachAttestations;
+    /**
+     * The gateway hold the gates would put on the send (AGL-3326), which the
+     * member enrolling past the red chip releases; `null` when none applies.
+     */
+    hold: OutreachGateHold | null;
 }
 /** Confirm's answer for one person, with what the rep supplied — see the module note. */
 export declare function decideOutreachEnrollment(question: OutreachGateQuestion, facts: {