@aglyn/plugins-outreach 1.0.0-beta.143

package/src/lib/engine/sequence-validation.js

@@ -0,0 +1,291 @@
+/**
+ * @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.
+ */ /*==========================================
+ * WHAT A SEQUENCE MAY BE (AGL-2979).
+ *
+ * One validator for the three readers that need it: the editor, which shows
+ * every issue beside the field it belongs to; the route that saves, which
+ * refuses a sequence with an error; and activation, which also refuses while
+ * the organization's footer cannot be written. Each issue names its field by
+ * a dotted path (`steps.2.subject`) and says what to do in a sentence.
+ *
+ * ERRORS AND WARNINGS. An error is a sequence the engine cannot send or the
+ * rules forbid: a fifth email, a first email with no subject, a `Re:` on a
+ * message that answers nothing. A warning is a sequence that sends and
+ * probably is not what its author meant — a merge field nobody fills, a
+ * first email that never uses the personal line the rep writes at
+ * enrollment.
+ *==========================================*/ import { CRM_EMAIL_BODY_MAX, CRM_EMAIL_SUBJECT_MAX } from "@aglyn/aglyn/app-utils/crm";
+import { CRM_MERGE_FIELDS, crmMergeFieldsIn } from "@aglyn/aglyn/app-utils/crm-email-templates";
+import { crmThreadSubject } from "@aglyn/aglyn/app-utils/crm-inbound";
+import { OUTREACH_DEFAULT_ALLOWED_COUNTRIES, OUTREACH_MAX_EMAIL_STEPS, OUTREACH_MAX_STEP_DELAY_BUSINESS_DAYS, OUTREACH_MAX_STEPS, OUTREACH_MIN_EMAIL_FOLLOW_UP_BUSINESS_DAYS, OUTREACH_TASK_KINDS } from "../model/outreach.types.js";
+/** The merge field the rep's signal sentence is written into a step with. */ export const OUTREACH_PERSONAL_LINE_FIELD = 'enrollment.personalLine';
+/**
+ * Every field an Outreach step may use: the CRM's, which the composer fills
+ * through the CRM's own resolver, and the enrollment's.
+ */ export const OUTREACH_MERGE_FIELDS = [
+    ...CRM_MERGE_FIELDS,
+    {
+        key: OUTREACH_PERSONAL_LINE_FIELD,
+        label: 'Personal line',
+        group: 'Enrollment'
+    }
+];
+/** The longest name a sequence carries. */ export const OUTREACH_SEQUENCE_NAME_MAX = 120;
+/** The longest title a task step carries. */ export const OUTREACH_TASK_TITLE_MAX = 200;
+/** Whether any issue in the list stops a save or an activation. */ export function hasOutreachValidationErrors(issues) {
+    return issues.some((issue)=>issue.severity === 'error');
+}
+const error = (path, code, message)=>({
+        path,
+        code,
+        message,
+        severity: 'error'
+    });
+const warning = (path, code, message)=>({
+        path,
+        code,
+        message,
+        severity: 'warning'
+    });
+const asText = (value)=>typeof value === 'string' ? value : '';
+const isEmailStep = (step)=>(step == null ? void 0 : step.kind) === 'email';
+/** The index of the first email step, or `-1` for a sequence with none. */ export function firstEmailStepIndex(steps) {
+    return (steps != null ? steps : []).findIndex(isEmailStep);
+}
+/**
+ * Whether the email at `index` is sent as a reply in the thread an earlier
+ * email started: every email after the first unless it says otherwise. The
+ * first email starts the thread whatever its `replyInThread` says.
+ */ export function isInThreadEmailStep(steps, index) {
+    const step = steps == null ? void 0 : steps[index];
+    if (!isEmailStep(step)) return false;
+    const first = firstEmailStepIndex(steps);
+    return index > first && step.replyInThread !== false;
+}
+/**
+ * Whether a subject opens with a reply or forward prefix — `Re:`, `Fwd:`,
+ * `AW:` — which on an email that answers nothing tells the recipient a
+ * conversation exists that does not. The prefixes are the CRM thread
+ * reader's, so the two agree on what one looks like.
+ */ export function outreachSubjectHasReplyPrefix(subject) {
+    const collapsed = asText(subject).replace(/\s+/g, ' ').trim();
+    return collapsed !== '' && crmThreadSubject(collapsed) !== collapsed.slice(0, CRM_EMAIL_SUBJECT_MAX);
+}
+const WEEKDAY_NAMES = [
+    'Sunday',
+    'Monday',
+    'Tuesday',
+    'Wednesday',
+    'Thursday',
+    'Friday',
+    'Saturday'
+];
+/** A sending window's shape: at least one weekday, and an opening before a close. */ export function validateOutreachSendWindow(window, path = 'window') {
+    const issues = [];
+    const days = Array.isArray(window == null ? void 0 : window.days) ? window.days : [];
+    const daysValid = days.length > 0 && days.every((day)=>Number.isInteger(day) && day >= 0 && day < WEEKDAY_NAMES.length) && new Set(days).size === days.length;
+    if (!daysValid) {
+        issues.push(error(`${path}.days`, 'window_days_invalid', 'Pick at least one day of the week to send on.'));
+    }
+    const start = window == null ? void 0 : window.startMinute;
+    const end = window == null ? void 0 : window.endMinute;
+    const hoursValid = Number.isInteger(start) && Number.isInteger(end) && start >= 0 && end <= 24 * 60 && start < end;
+    if (!hoursValid) {
+        issues.push(error(path, 'window_hours_invalid', 'The sending hours need a start time before the end time, within one day.'));
+    }
+    return issues;
+}
+/**
+ * The allowed countries, as stored or typed, reduced to unique uppercase
+ * alpha-2 codes in the order given. Anything that is not two letters is
+ * dropped, so a caller that needs to report it checks the raw value.
+ */ export function normalizeOutreachAllowedCountries(value) {
+    if (!Array.isArray(value)) return [];
+    const codes = [];
+    for (const entry of value){
+        const code = asText(entry).trim().toUpperCase();
+        if (/^[A-Z]{2}$/.test(code) && !codes.includes(code)) codes.push(code);
+    }
+    return codes;
+}
+/**
+ * A stored settings map with the defaults applied: the United States alone,
+ * no customers, the mailbox's own window. A field a writer never set reads
+ * as its default rather than as a permission nobody gave.
+ */ export function readOutreachSequenceSettings(raw) {
+    const data = raw != null ? raw : {};
+    const countries = normalizeOutreachAllowedCountries(data['allowedCountries']);
+    const window = data['window'];
+    return {
+        window: window && typeof window === 'object' ? window : null,
+        allowedCountries: Array.isArray(data['allowedCountries']) ? countries : [
+            ...OUTREACH_DEFAULT_ALLOWED_COUNTRIES
+        ],
+        allowCustomers: data['allowCustomers'] === true
+    };
+}
+export function validateOutreachSequenceSettings(settings, path = 'settings') {
+    const issues = [];
+    if (settings == null ? void 0 : settings.window) {
+        issues.push(...validateOutreachSendWindow(settings.window, `${path}.window`));
+    }
+    const raw = Array.isArray(settings == null ? void 0 : settings.allowedCountries) ? settings.allowedCountries : [];
+    if (!raw.length) {
+        issues.push(error(`${path}.allowedCountries`, 'countries_required', 'Choose at least one country this sequence may send to.'));
+    }
+    raw.forEach((entry, index)=>{
+        if (!/^[A-Z]{2}$/.test(asText(entry))) {
+            issues.push(error(`${path}.allowedCountries.${index}`, 'country_invalid', `"${asText(entry)}" isn't a two-letter country code, like US.`));
+        }
+    });
+    return issues;
+}
+const KNOWN_MERGE_FIELDS = new Set(OUTREACH_MERGE_FIELDS.map((field)=>field.key));
+function mergeFieldWarnings(text, path) {
+    return crmMergeFieldsIn(text).filter((key)=>!KNOWN_MERGE_FIELDS.has(key)).map((key)=>warning(path, 'unknown_merge_field', `{{${key}}} isn't a merge field, so it will be sent empty.`));
+}
+function delayIssues(steps, step, index, path) {
+    const delay = step.delayBusinessDays;
+    const followsAnEmail = isEmailStep(step) && index > firstEmailStepIndex(steps);
+    const min = followsAnEmail ? OUTREACH_MIN_EMAIL_FOLLOW_UP_BUSINESS_DAYS : 0;
+    if (Number.isInteger(delay) && delay >= min && delay <= OUTREACH_MAX_STEP_DELAY_BUSINESS_DAYS) {
+        return [];
+    }
+    const message = min > 0 ? `Wait ${min}–${OUTREACH_MAX_STEP_DELAY_BUSINESS_DAYS} business days before this email.` : `Wait 0–${OUTREACH_MAX_STEP_DELAY_BUSINESS_DAYS} business days before this step.`;
+    return [
+        error(`${path}.delayBusinessDays`, 'delay_invalid', message)
+    ];
+}
+function emailStepIssues(steps, step, index, path) {
+    const issues = [];
+    const first = firstEmailStepIndex(steps) === index;
+    const startsThread = !isInThreadEmailStep(steps, index);
+    const subject = asText(step.subject);
+    if (startsThread) {
+        if (!subject.trim()) {
+            issues.push(error(`${path}.subject`, 'subject_required', first ? 'The first email needs a subject.' : 'An email that starts a new thread needs a subject.'));
+        } else if (outreachSubjectHasReplyPrefix(subject)) {
+            issues.push(error(`${path}.subject`, 'subject_reply_prefix', 'Remove the "Re:" or "Fwd:" — this email starts a conversation, it doesn\'t answer one.'));
+        }
+        if (subject.length > CRM_EMAIL_SUBJECT_MAX) {
+            issues.push(error(`${path}.subject`, 'subject_too_long', `Keep the subject under ${CRM_EMAIL_SUBJECT_MAX} characters.`));
+        }
+        issues.push(...mergeFieldWarnings(subject, `${path}.subject`));
+    }
+    const body = asText(step.body);
+    const templateId = asText(step.templateId).trim();
+    if (body.trim() && templateId) {
+        issues.push(error(`${path}.body`, 'body_and_template', 'Write the email here or pick a template, not both.'));
+    } else if (!body.trim() && !templateId) {
+        issues.push(error(`${path}.body`, 'body_required', 'Write the email, or pick a template.'));
+    }
+    if (body.length > CRM_EMAIL_BODY_MAX) {
+        issues.push(error(`${path}.body`, 'body_too_long', `Keep the email under ${CRM_EMAIL_BODY_MAX.toLocaleString('en-US')} characters.`));
+    }
+    if (body.trim()) {
+        issues.push(...mergeFieldWarnings(body, `${path}.body`));
+        if (first && !crmMergeFieldsIn(body).includes(OUTREACH_PERSONAL_LINE_FIELD)) {
+            issues.push(warning(`${path}.body`, 'personal_line_unused', `The first email doesn't use {{${OUTREACH_PERSONAL_LINE_FIELD}}}, so the line written for each person won't appear.`));
+        }
+    }
+    return issues;
+}
+/** The steps of a sequence: their count, their ids, and each one's own fields. */ export function validateOutreachSteps(steps, path = 'steps') {
+    const list = Array.isArray(steps) ? steps : [];
+    const issues = [];
+    if (!list.length) {
+        issues.push(error(path, 'steps_required', 'Add at least one step.'));
+        return issues;
+    }
+    if (list.length > OUTREACH_MAX_STEPS) {
+        issues.push(error(path, 'too_many_steps', `A sequence holds at most ${OUTREACH_MAX_STEPS} steps.`));
+    }
+    const emailCount = list.filter(isEmailStep).length;
+    if (emailCount > OUTREACH_MAX_EMAIL_STEPS) {
+        issues.push(error(path, 'too_many_email_steps', `A sequence sends at most ${OUTREACH_MAX_EMAIL_STEPS} emails to one person.`));
+    }
+    const seen = new Set();
+    list.forEach((step, index)=>{
+        const stepPath = `${path}.${index}`;
+        const id = asText(step == null ? void 0 : step.id).trim();
+        if (!id) {
+            issues.push(error(`${stepPath}.id`, 'step_id_required', 'Every step needs an id.'));
+        } else if (seen.has(id)) {
+            issues.push(error(`${stepPath}.id`, 'duplicate_step_id', 'Two steps share an id.'));
+        }
+        seen.add(id);
+        if (isEmailStep(step)) {
+            issues.push(...delayIssues(list, step, index, stepPath));
+            issues.push(...emailStepIssues(list, step, index, stepPath));
+        } else if ((step == null ? void 0 : step.kind) === 'task') {
+            issues.push(...delayIssues(list, step, index, stepPath));
+            if (!OUTREACH_TASK_KINDS.includes(step.taskKind)) {
+                issues.push(error(`${stepPath}.taskKind`, 'task_kind_invalid', 'Pick LinkedIn, Call or To-do.'));
+            }
+            const title = asText(step.title);
+            if (!title.trim()) {
+                issues.push(error(`${stepPath}.title`, 'task_title_required', 'Give the task a title.'));
+            } else if (title.length > OUTREACH_TASK_TITLE_MAX) {
+                issues.push(error(`${stepPath}.title`, 'task_title_too_long', `Keep the title under ${OUTREACH_TASK_TITLE_MAX} characters.`));
+            }
+        } else {
+            issues.push(error(stepPath, 'unknown_step_kind', 'A step is an email or a task.'));
+        }
+    });
+    return issues;
+}
+/** Everything a stored sequence has to be before it may be saved. */ export function validateOutreachSequence(sequence) {
+    var _ref;
+    const issues = [];
+    const name = asText(sequence == null ? void 0 : sequence.name);
+    if (!name.trim()) {
+        issues.push(error('name', 'name_required', 'Name the sequence.'));
+    } else if (name.length > OUTREACH_SEQUENCE_NAME_MAX) {
+        issues.push(error('name', 'name_too_long', `Keep the name under ${OUTREACH_SEQUENCE_NAME_MAX} characters.`));
+    }
+    const steps = (_ref = sequence == null ? void 0 : sequence.steps) != null ? _ref : [];
+    if (steps.some(isEmailStep) && !asText(sequence == null ? void 0 : sequence.mailboxId).trim()) {
+        issues.push(error('mailboxId', 'mailbox_required', 'Choose the mailbox this sequence sends from.'));
+    }
+    issues.push(...validateOutreachSteps(steps));
+    issues.push(...validateOutreachSequenceSettings(sequence == null ? void 0 : sequence.settings));
+    return issues;
+}
+/**
+ * The organization's footer fields: a legal name and a postal address, the
+ * two things the law requires every commercial email to carry.
+ */ export function validateOutreachOrgSettings(settings, path = 'orgSettings') {
+    const issues = [];
+    if (!asText(settings == null ? void 0 : settings.legalName).trim()) {
+        issues.push(error(`${path}.legalName`, 'legal_name_required', "Add your organization's legal name in Sequences settings. It goes in every email's footer."));
+    }
+    if (!asText(settings == null ? void 0 : settings.postalAddress).trim()) {
+        issues.push(error(`${path}.postalAddress`, 'postal_address_required', "Add your organization's postal address in Sequences settings. The law requires one in every sales email."));
+    }
+    return issues;
+}
+/**
+ * What activating a sequence refuses on: every issue saving refuses on, and
+ * an organization whose footer cannot be written yet.
+ */ export function validateOutreachSequenceActivation(sequence, orgSettings) {
+    return [
+        ...validateOutreachSequence(sequence),
+        ...validateOutreachOrgSettings(orgSettings)
+    ];
+}
+
+//# sourceMappingURL=sequence-validation.js.map

package/src/lib/engine/sequence-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/outreach/src/lib/engine/sequence-validation.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 A SEQUENCE MAY BE (AGL-2979).\n *\n * One validator for the three readers that need it: the editor, which shows\n * every issue beside the field it belongs to; the route that saves, which\n * refuses a sequence with an error; and activation, which also refuses while\n * the organization's footer cannot be written. Each issue names its field by\n * a dotted path (`steps.2.subject`) and says what to do in a sentence.\n *\n * ERRORS AND WARNINGS. An error is a sequence the engine cannot send or the\n * rules forbid: a fifth email, a first email with no subject, a `Re:` on a\n * message that answers nothing. A warning is a sequence that sends and\n * probably is not what its author meant — a merge field nobody fills, a\n * first email that never uses the personal line the rep writes at\n * enrollment.\n *==========================================*/\n\nimport { CRM_EMAIL_BODY_MAX, CRM_EMAIL_SUBJECT_MAX } from '@aglyn/aglyn/app-utils/crm'\nimport {\n  CRM_MERGE_FIELDS,\n  type CrmMergeFieldGroup,\n  crmMergeFieldsIn,\n} from '@aglyn/aglyn/app-utils/crm-email-templates'\nimport { crmThreadSubject } from '@aglyn/aglyn/app-utils/crm-inbound'\nimport {\n  OUTREACH_DEFAULT_ALLOWED_COUNTRIES,\n  OUTREACH_MAX_EMAIL_STEPS,\n  OUTREACH_MAX_STEP_DELAY_BUSINESS_DAYS,\n  OUTREACH_MAX_STEPS,\n  OUTREACH_MIN_EMAIL_FOLLOW_UP_BUSINESS_DAYS,\n  OUTREACH_TASK_KINDS,\n  type OutreachEmailStep,\n  type OutreachOrgSettings,\n  type OutreachSendWindow,\n  type OutreachSequence,\n  type OutreachSequenceSettings,\n  type OutreachSequenceStep,\n} from '../model/outreach.types'\n\n/** The merge field the rep's signal sentence is written into a step with. */\nexport const OUTREACH_PERSONAL_LINE_FIELD = 'enrollment.personalLine'\n\n/** A merge field as the Outreach editor's picker offers it. */\nexport interface OutreachMergeFieldDefinition {\n  key: string\n  label: string\n  group: CrmMergeFieldGroup | 'Enrollment'\n}\n\n/**\n * Every field an Outreach step may use: the CRM's, which the composer fills\n * through the CRM's own resolver, and the enrollment's.\n */\nexport const OUTREACH_MERGE_FIELDS: readonly OutreachMergeFieldDefinition[] = [\n  ...CRM_MERGE_FIELDS,\n  { key: OUTREACH_PERSONAL_LINE_FIELD, label: 'Personal line', group: 'Enrollment' },\n]\n\n/** The longest name a sequence carries. */\nexport const OUTREACH_SEQUENCE_NAME_MAX = 120\n\n/** The longest title a task step carries. */\nexport const OUTREACH_TASK_TITLE_MAX = 200\n\nexport type OutreachValidationSeverity = 'error' | 'warning'\n\nexport type OutreachValidationCode =\n  | 'name_required'\n  | 'name_too_long'\n  | 'mailbox_required'\n  | 'steps_required'\n  | 'too_many_steps'\n  | 'too_many_email_steps'\n  | 'step_id_required'\n  | 'duplicate_step_id'\n  | 'unknown_step_kind'\n  | 'delay_invalid'\n  | 'subject_required'\n  | 'subject_too_long'\n  | 'subject_reply_prefix'\n  | 'body_required'\n  | 'body_and_template'\n  | 'body_too_long'\n  | 'unknown_merge_field'\n  | 'personal_line_unused'\n  | 'task_kind_invalid'\n  | 'task_title_required'\n  | 'task_title_too_long'\n  | 'window_days_invalid'\n  | 'window_hours_invalid'\n  | 'countries_required'\n  | 'country_invalid'\n  | 'legal_name_required'\n  | 'postal_address_required'\n\nexport interface OutreachValidationIssue {\n  /** The field, dotted: `name`, `steps.2.subject`, `settings.window`, `orgSettings.postalAddress`. */\n  path: string\n  code: OutreachValidationCode\n  message: string\n  severity: OutreachValidationSeverity\n}\n\n/** Whether any issue in the list stops a save or an activation. */\nexport function hasOutreachValidationErrors(\n  issues: readonly OutreachValidationIssue[],\n): boolean {\n  return issues.some((issue) => issue.severity === 'error')\n}\n\nconst error = (\n  path: string,\n  code: OutreachValidationCode,\n  message: string,\n): OutreachValidationIssue => ({ path, code, message, severity: 'error' })\n\nconst warning = (\n  path: string,\n  code: OutreachValidationCode,\n  message: string,\n): OutreachValidationIssue => ({ path, code, message, severity: 'warning' })\n\nconst asText = (value: unknown): string => (typeof value === 'string' ? value : '')\n\nconst isEmailStep = (step: OutreachSequenceStep | null | undefined): step is OutreachEmailStep =>\n  step?.kind === 'email'\n\n/** The index of the first email step, or `-1` for a sequence with none. */\nexport function firstEmailStepIndex(\n  steps: readonly OutreachSequenceStep[] | null | undefined,\n): number {\n  return (steps ?? []).findIndex(isEmailStep)\n}\n\n/**\n * Whether the email at `index` is sent as a reply in the thread an earlier\n * email started: every email after the first unless it says otherwise. The\n * first email starts the thread whatever its `replyInThread` says.\n */\nexport function isInThreadEmailStep(\n  steps: readonly OutreachSequenceStep[] | null | undefined,\n  index: number,\n): boolean {\n  const step = steps?.[index]\n  if (!isEmailStep(step)) return false\n  const first = firstEmailStepIndex(steps)\n  return index > first && step.replyInThread !== false\n}\n\n/**\n * Whether a subject opens with a reply or forward prefix — `Re:`, `Fwd:`,\n * `AW:` — which on an email that answers nothing tells the recipient a\n * conversation exists that does not. The prefixes are the CRM thread\n * reader's, so the two agree on what one looks like.\n */\nexport function outreachSubjectHasReplyPrefix(subject: unknown): boolean {\n  const collapsed = asText(subject).replace(/\\s+/g, ' ').trim()\n  return collapsed !== '' && crmThreadSubject(collapsed) !== collapsed.slice(0, CRM_EMAIL_SUBJECT_MAX)\n}\n\nconst WEEKDAY_NAMES = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday']\n\n/** A sending window's shape: at least one weekday, and an opening before a close. */\nexport function validateOutreachSendWindow(\n  window: OutreachSendWindow | null | undefined,\n  path = 'window',\n): OutreachValidationIssue[] {\n  const issues: OutreachValidationIssue[] = []\n  const days = Array.isArray(window?.days) ? window.days : []\n  const daysValid =\n    days.length > 0 &&\n    days.every((day) => Number.isInteger(day) && day >= 0 && day < WEEKDAY_NAMES.length) &&\n    new Set(days).size === days.length\n  if (!daysValid) {\n    issues.push(\n      error(`${path}.days`, 'window_days_invalid', 'Pick at least one day of the week to send on.'),\n    )\n  }\n  const start = window?.startMinute\n  const end = window?.endMinute\n  const hoursValid =\n    Number.isInteger(start) &&\n    Number.isInteger(end) &&\n    start >= 0 &&\n    end <= 24 * 60 &&\n    start < end\n  if (!hoursValid) {\n    issues.push(\n      error(\n        path,\n        'window_hours_invalid',\n        'The sending hours need a start time before the end time, within one day.',\n      ),\n    )\n  }\n  return issues\n}\n\n/**\n * The allowed countries, as stored or typed, reduced to unique uppercase\n * alpha-2 codes in the order given. Anything that is not two letters is\n * dropped, so a caller that needs to report it checks the raw value.\n */\nexport function normalizeOutreachAllowedCountries(value: unknown): string[] {\n  if (!Array.isArray(value)) return []\n  const codes: string[] = []\n  for (const entry of value) {\n    const code = asText(entry).trim().toUpperCase()\n    if (/^[A-Z]{2}$/.test(code) && !codes.includes(code)) codes.push(code)\n  }\n  return codes\n}\n\n/**\n * A stored settings map with the defaults applied: the United States alone,\n * no customers, the mailbox's own window. A field a writer never set reads\n * as its default rather than as a permission nobody gave.\n */\nexport function readOutreachSequenceSettings(\n  raw: Partial<OutreachSequenceSettings> | Record<string, unknown> | null | undefined,\n): OutreachSequenceSettings {\n  const data = (raw ?? {}) as Record<string, unknown>\n  const countries = normalizeOutreachAllowedCountries(data['allowedCountries'])\n  const window = data['window'] as OutreachSendWindow | null | undefined\n  return {\n    window: window && typeof window === 'object' ? window : null,\n    allowedCountries: Array.isArray(data['allowedCountries'])\n      ? countries\n      : [...OUTREACH_DEFAULT_ALLOWED_COUNTRIES],\n    allowCustomers: data['allowCustomers'] === true,\n  }\n}\n\nexport function validateOutreachSequenceSettings(\n  settings: OutreachSequenceSettings | null | undefined,\n  path = 'settings',\n): OutreachValidationIssue[] {\n  const issues: OutreachValidationIssue[] = []\n  if (settings?.window) {\n    issues.push(...validateOutreachSendWindow(settings.window, `${path}.window`))\n  }\n  const raw = Array.isArray(settings?.allowedCountries) ? settings.allowedCountries : []\n  if (!raw.length) {\n    issues.push(\n      error(\n        `${path}.allowedCountries`,\n        'countries_required',\n        'Choose at least one country this sequence may send to.',\n      ),\n    )\n  }\n  raw.forEach((entry, index) => {\n    if (!/^[A-Z]{2}$/.test(asText(entry))) {\n      issues.push(\n        error(\n          `${path}.allowedCountries.${index}`,\n          'country_invalid',\n          `\"${asText(entry)}\" isn't a two-letter country code, like US.`,\n        ),\n      )\n    }\n  })\n  return issues\n}\n\nconst KNOWN_MERGE_FIELDS = new Set(OUTREACH_MERGE_FIELDS.map((field) => field.key))\n\nfunction mergeFieldWarnings(text: string, path: string): OutreachValidationIssue[] {\n  return crmMergeFieldsIn(text)\n    .filter((key) => !KNOWN_MERGE_FIELDS.has(key))\n    .map((key) =>\n      warning(\n        path,\n        'unknown_merge_field',\n        `{{${key}}} isn't a merge field, so it will be sent empty.`,\n      ),\n    )\n}\n\nfunction delayIssues(\n  steps: readonly OutreachSequenceStep[],\n  step: OutreachSequenceStep,\n  index: number,\n  path: string,\n): OutreachValidationIssue[] {\n  const delay = step.delayBusinessDays\n  const followsAnEmail = isEmailStep(step) && index > firstEmailStepIndex(steps)\n  const min = followsAnEmail ? OUTREACH_MIN_EMAIL_FOLLOW_UP_BUSINESS_DAYS : 0\n  if (Number.isInteger(delay) && delay >= min && delay <= OUTREACH_MAX_STEP_DELAY_BUSINESS_DAYS) {\n    return []\n  }\n  const message =\n    min > 0\n      ? `Wait ${min}–${OUTREACH_MAX_STEP_DELAY_BUSINESS_DAYS} business days before this email.`\n      : `Wait 0–${OUTREACH_MAX_STEP_DELAY_BUSINESS_DAYS} business days before this step.`\n  return [error(`${path}.delayBusinessDays`, 'delay_invalid', message)]\n}\n\nfunction emailStepIssues(\n  steps: readonly OutreachSequenceStep[],\n  step: OutreachEmailStep,\n  index: number,\n  path: string,\n): OutreachValidationIssue[] {\n  const issues: OutreachValidationIssue[] = []\n  const first = firstEmailStepIndex(steps) === index\n  const startsThread = !isInThreadEmailStep(steps, index)\n  const subject = asText(step.subject)\n  if (startsThread) {\n    if (!subject.trim()) {\n      issues.push(\n        error(\n          `${path}.subject`,\n          'subject_required',\n          first\n            ? 'The first email needs a subject.'\n            : 'An email that starts a new thread needs a subject.',\n        ),\n      )\n    } else if (outreachSubjectHasReplyPrefix(subject)) {\n      issues.push(\n        error(\n          `${path}.subject`,\n          'subject_reply_prefix',\n          'Remove the \"Re:\" or \"Fwd:\" — this email starts a conversation, it doesn\\'t answer one.',\n        ),\n      )\n    }\n    if (subject.length > CRM_EMAIL_SUBJECT_MAX) {\n      issues.push(\n        error(\n          `${path}.subject`,\n          'subject_too_long',\n          `Keep the subject under ${CRM_EMAIL_SUBJECT_MAX} characters.`,\n        ),\n      )\n    }\n    issues.push(...mergeFieldWarnings(subject, `${path}.subject`))\n  }\n  const body = asText(step.body)\n  const templateId = asText(step.templateId).trim()\n  if (body.trim() && templateId) {\n    issues.push(\n      error(\n        `${path}.body`,\n        'body_and_template',\n        'Write the email here or pick a template, not both.',\n      ),\n    )\n  } else if (!body.trim() && !templateId) {\n    issues.push(error(`${path}.body`, 'body_required', 'Write the email, or pick a template.'))\n  }\n  if (body.length > CRM_EMAIL_BODY_MAX) {\n    issues.push(\n      error(\n        `${path}.body`,\n        'body_too_long',\n        `Keep the email under ${CRM_EMAIL_BODY_MAX.toLocaleString('en-US')} characters.`,\n      ),\n    )\n  }\n  if (body.trim()) {\n    issues.push(...mergeFieldWarnings(body, `${path}.body`))\n    if (first && !crmMergeFieldsIn(body).includes(OUTREACH_PERSONAL_LINE_FIELD)) {\n      issues.push(\n        warning(\n          `${path}.body`,\n          'personal_line_unused',\n          `The first email doesn't use {{${OUTREACH_PERSONAL_LINE_FIELD}}}, so the line written for each person won't appear.`,\n        ),\n      )\n    }\n  }\n  return issues\n}\n\n/** The steps of a sequence: their count, their ids, and each one's own fields. */\nexport function validateOutreachSteps(\n  steps: readonly OutreachSequenceStep[] | null | undefined,\n  path = 'steps',\n): OutreachValidationIssue[] {\n  const list = Array.isArray(steps) ? steps : []\n  const issues: OutreachValidationIssue[] = []\n  if (!list.length) {\n    issues.push(error(path, 'steps_required', 'Add at least one step.'))\n    return issues\n  }\n  if (list.length > OUTREACH_MAX_STEPS) {\n    issues.push(\n      error(path, 'too_many_steps', `A sequence holds at most ${OUTREACH_MAX_STEPS} steps.`),\n    )\n  }\n  const emailCount = list.filter(isEmailStep).length\n  if (emailCount > OUTREACH_MAX_EMAIL_STEPS) {\n    issues.push(\n      error(\n        path,\n        'too_many_email_steps',\n        `A sequence sends at most ${OUTREACH_MAX_EMAIL_STEPS} emails to one person.`,\n      ),\n    )\n  }\n  const seen = new Set<string>()\n  list.forEach((step, index) => {\n    const stepPath = `${path}.${index}`\n    const id = asText(step?.id).trim()\n    if (!id) {\n      issues.push(error(`${stepPath}.id`, 'step_id_required', 'Every step needs an id.'))\n    } else if (seen.has(id)) {\n      issues.push(error(`${stepPath}.id`, 'duplicate_step_id', 'Two steps share an id.'))\n    }\n    seen.add(id)\n    if (isEmailStep(step)) {\n      issues.push(...delayIssues(list, step, index, stepPath))\n      issues.push(...emailStepIssues(list, step, index, stepPath))\n    } else if (step?.kind === 'task') {\n      issues.push(...delayIssues(list, step, index, stepPath))\n      if (!(OUTREACH_TASK_KINDS as readonly string[]).includes(step.taskKind)) {\n        issues.push(\n          error(`${stepPath}.taskKind`, 'task_kind_invalid', 'Pick LinkedIn, Call or To-do.'),\n        )\n      }\n      const title = asText(step.title)\n      if (!title.trim()) {\n        issues.push(error(`${stepPath}.title`, 'task_title_required', 'Give the task a title.'))\n      } else if (title.length > OUTREACH_TASK_TITLE_MAX) {\n        issues.push(\n          error(\n            `${stepPath}.title`,\n            'task_title_too_long',\n            `Keep the title under ${OUTREACH_TASK_TITLE_MAX} characters.`,\n          ),\n        )\n      }\n    } else {\n      issues.push(\n        error(stepPath, 'unknown_step_kind', 'A step is an email or a task.'),\n      )\n    }\n  })\n  return issues\n}\n\n/** Everything a stored sequence has to be before it may be saved. */\nexport function validateOutreachSequence(\n  sequence: Pick<OutreachSequence, 'name' | 'mailboxId' | 'steps' | 'settings'> | null | undefined,\n): OutreachValidationIssue[] {\n  const issues: OutreachValidationIssue[] = []\n  const name = asText(sequence?.name)\n  if (!name.trim()) {\n    issues.push(error('name', 'name_required', 'Name the sequence.'))\n  } else if (name.length > OUTREACH_SEQUENCE_NAME_MAX) {\n    issues.push(\n      error('name', 'name_too_long', `Keep the name under ${OUTREACH_SEQUENCE_NAME_MAX} characters.`),\n    )\n  }\n  const steps = sequence?.steps ?? []\n  if (steps.some(isEmailStep) && !asText(sequence?.mailboxId).trim()) {\n    issues.push(\n      error('mailboxId', 'mailbox_required', 'Choose the mailbox this sequence sends from.'),\n    )\n  }\n  issues.push(...validateOutreachSteps(steps))\n  issues.push(...validateOutreachSequenceSettings(sequence?.settings))\n  return issues\n}\n\n/**\n * The organization's footer fields: a legal name and a postal address, the\n * two things the law requires every commercial email to carry.\n */\nexport function validateOutreachOrgSettings(\n  settings: Pick<OutreachOrgSettings, 'legalName' | 'postalAddress'> | null | undefined,\n  path = 'orgSettings',\n): OutreachValidationIssue[] {\n  const issues: OutreachValidationIssue[] = []\n  if (!asText(settings?.legalName).trim()) {\n    issues.push(\n      error(\n        `${path}.legalName`,\n        'legal_name_required',\n        \"Add your organization's legal name in Sequences settings. It goes in every email's footer.\",\n      ),\n    )\n  }\n  if (!asText(settings?.postalAddress).trim()) {\n    issues.push(\n      error(\n        `${path}.postalAddress`,\n        'postal_address_required',\n        \"Add your organization's postal address in Sequences settings. The law requires one in every sales email.\",\n      ),\n    )\n  }\n  return issues\n}\n\n/**\n * What activating a sequence refuses on: every issue saving refuses on, and\n * an organization whose footer cannot be written yet.\n */\nexport function validateOutreachSequenceActivation(\n  sequence: Pick<OutreachSequence, 'name' | 'mailboxId' | 'steps' | 'settings'> | null | undefined,\n  orgSettings: Pick<OutreachOrgSettings, 'legalName' | 'postalAddress'> | null | undefined,\n): OutreachValidationIssue[] {\n  return [...validateOutreachSequence(sequence), ...validateOutreachOrgSettings(orgSettings)]\n}\n"],"names":["CRM_EMAIL_BODY_MAX","CRM_EMAIL_SUBJECT_MAX","CRM_MERGE_FIELDS","crmMergeFieldsIn","crmThreadSubject","OUTREACH_DEFAULT_ALLOWED_COUNTRIES","OUTREACH_MAX_EMAIL_STEPS","OUTREACH_MAX_STEP_DELAY_BUSINESS_DAYS","OUTREACH_MAX_STEPS","OUTREACH_MIN_EMAIL_FOLLOW_UP_BUSINESS_DAYS","OUTREACH_TASK_KINDS","OUTREACH_PERSONAL_LINE_FIELD","OUTREACH_MERGE_FIELDS","key","label","group","OUTREACH_SEQUENCE_NAME_MAX","OUTREACH_TASK_TITLE_MAX","hasOutreachValidationErrors","issues","some","issue","severity","error","path","code","message","warning","asText","value","isEmailStep","step","kind","firstEmailStepIndex","steps","findIndex","isInThreadEmailStep","index","first","replyInThread","outreachSubjectHasReplyPrefix","subject","collapsed","replace","trim","slice","WEEKDAY_NAMES","validateOutreachSendWindow","window","days","Array","isArray","daysValid","length","every","day","Number","isInteger","Set","size","push","start","startMinute","end","endMinute","hoursValid","normalizeOutreachAllowedCountries","codes","entry","toUpperCase","test","includes","readOutreachSequenceSettings","raw","data","countries","allowedCountries","allowCustomers","validateOutreachSequenceSettings","settings","forEach","KNOWN_MERGE_FIELDS","map","field","mergeFieldWarnings","text","filter","has","delayIssues","delay","delayBusinessDays","followsAnEmail","min","emailStepIssues","startsThread","body","templateId","toLocaleString","validateOutreachSteps","list","emailCount","seen","stepPath","id","add","taskKind","title","validateOutreachSequence","sequence","name","mailboxId","validateOutreachOrgSettings","legalName","postalAddress","validateOutreachSequenceActivation","orgSettings"],"mappings":"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"}

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

@@ -0,0 +1,78 @@
+/**
+ * @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.
+ */
+import { type OutreachThreadMessage } from './thread-message';
+export type OutreachMessageKind = 'self' | 'hard_bounce' | 'soft_bounce' | 'delivery_report' | 'auto_reply' | 'opt_out' | 'reply';
+export interface OutreachBounceDetail {
+    /** The addresses the report says failed; empty when it names none. */
+    recipients: string[];
+    status: string | null;
+    diagnostic: string | null;
+}
+export interface OutreachMessageClassification {
+    messageId: string;
+    atMs: number;
+    kind: OutreachMessageKind;
+    /** The sender's address, normalized, when the `From` carried one. */
+    from: string | null;
+    /** Set on a bounce. */
+    bounce: OutreachBounceDetail | null;
+    /** An opt-out that calls the email spam. */
+    complaint: boolean;
+    /** What decided it, for the timeline and the log. */
+    evidence: string | null;
+}
+export interface OutreachMessageContext {
+    /** The mailbox's own addresses: the account's and every alias it sends as. */
+    selfAddresses: readonly string[];
+    /** The address a `List-Unsubscribe` mailto points at, when the runtime set one. */
+    unsubscribeAddress?: string | null;
+    /** The subject the thread was started with, so a new subject can be read on its own. */
+    threadSubject?: string | null;
+}
+/**
+ * Why a message is an automatic reply, or `null` when it is not one — see
+ * the module note for the headers and subjects read.
+ */
+export declare function outreachAutoReplyEvidence(message: Pick<OutreachThreadMessage, 'headers' | 'subject'>): string | null;
+/** What one message in an enrollment's thread is — see the module note. */
+export declare function classifyOutreachMessage(message: OutreachThreadMessage, context: OutreachMessageContext): OutreachMessageClassification;
+export type OutreachThreadOutcome = 'none' | 'postpone' | 'bounced' | 'replied' | 'opted_out';
+export interface OutreachThreadDecisionInput extends OutreachMessageContext {
+    /** The thread's messages, in any order. */
+    messages: readonly OutreachThreadMessage[];
+    /** The enrollment's recipient. */
+    recipient: string;
+    /** Messages received at or before this instant were handled by an earlier run. */
+    afterMs?: number | null;
+    /** Ids of messages an earlier run handled. */
+    handledMessageIds?: readonly string[];
+}
+export interface OutreachThreadDecision {
+    outcome: OutreachThreadOutcome;
+    /** The message that decided the outcome; `null` for `none`. */
+    decidedBy: OutreachMessageClassification | null;
+    /** Every new message, classified, oldest first. */
+    classifications: OutreachMessageClassification[];
+    /** A new reply called the email spam: the mailbox is paused as well. */
+    complaint: boolean;
+    /** New hard bounces that report this recipient. */
+    hardBounces: number;
+    /** New soft bounces that report this recipient. */
+    softBounces: number;
+}
+/** What the new messages in an enrollment's thread mean for it — see the module note. */
+export declare function decideOutreachThread(input: OutreachThreadDecisionInput): OutreachThreadDecision;

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

@@ -0,0 +1,224 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @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.
+ */ /*==========================================
+ * WHAT CAME BACK (AGL-2979).
+ *
+ * The runtime reads each enrollment's threads and asks what the new
+ * messages mean. Each message is one of:
+ *
+ * - `self` — the mailbox's own: a step, or the rep writing in the thread.
+ * - `hard_bounce` / `soft_bounce` — a delivery report (`./delivery-status.ts`).
+ * - `delivery_report` — a mail system's message that reports no failure.
+ * - `auto_reply` — an out-of-office or an autoresponder. It POSTPONES the
+ *   next step and does not stop the sequence: nobody answered.
+ * - `opt_out` — a reply that asks to be left alone (`./opt-out-intent.ts`),
+ *   or a message sent to the unsubscribe address.
+ * - `reply` — any other message from anybody else.
+ *
+ * ## Automatic replies
+ *
+ * Read from the headers the standards give an autoresponder —
+ * `Auto-Submitted` with any value but `no` (RFC 3834), `X-Autoreply`,
+ * `X-Autorespond`, `Precedence: auto_reply`, `bulk` or `junk` — and, for
+ * the servers that set none, from an out-of-office subject in the usual
+ * languages.
+ *
+ * ## The thread's outcome
+ *
+ * `opted_out` outranks `replied`, which outranks `bounced`, which outranks
+ * `postpone`: an opt-out is a reply that also has to reach the do-not-contact
+ * list, a person who wrote back matters more than a report about an earlier
+ * send, and an out-of-office only matters when nothing else happened. The
+ * bounces that report this recipient are counted either way, because mailbox
+ * health counts every one.
+ *==========================================*/ import { normalizeContactEmail } from "@aglyn/aglyn/app-utils/contacts";
+import { crmThreadSubject, emailAddressOf, htmlToPlainText } from "@aglyn/aglyn/app-utils/crm-inbound";
+import { readOutreachDeliveryReport, isMailerDaemonMessage } from "./delivery-status.js";
+import { detectOutreachOptOutIntent, detectOutreachOptOutSubject } from "./opt-out-intent.js";
+import { outreachHeader } from "./thread-message.js";
+const AUTO_REPLY_SUBJECT = new RegExp([
+    '^\\s*\\[?\\s*(',
+    'auto(matic)?[\\s-]*(reply|response|responder|answer)',
+    '|out[\\s-]+of[\\s-]+(the[\\s-]+)?office',
+    '|ooo\\b',
+    "|i('m| am) (currently )?(out of the office|away|on (vacation|leave|holiday))",
+    '|(on )?(vacation|holiday|annual leave)[\\s-]*(reply|response|notice|message|autoreply)',
+    '|away from (the |my )?(office|desk)',
+    '|abwesenheitsnotiz|abwesenheit',
+    '|r[ée]ponse automatique|absence du bureau',
+    '|respuesta autom[áa]tica|fuera de la oficina',
+    '|risposta automatica|fuori ufficio',
+    '|automatisch antwoord|afwezigheidsbericht',
+    '|resposta autom[áa]tica|fora do escrit[óo]rio',
+    '|autosvar|automaattinen vastaus',
+    ')'
+].join(''), 'i');
+/**
+ * Why a message is an automatic reply, or `null` when it is not one — see
+ * the module note for the headers and subjects read.
+ */ export function outreachAutoReplyEvidence(message) {
+    var _ref;
+    const autoSubmitted = outreachHeader(message, 'Auto-Submitted').split(';')[0].trim().toLowerCase();
+    if (autoSubmitted && autoSubmitted !== 'no') return `Auto-Submitted: ${autoSubmitted}`;
+    for (const name of [
+        'X-Autoreply',
+        'X-Autorespond'
+    ]){
+        const value = outreachHeader(message, name).trim();
+        if (value && value.toLowerCase() !== 'no') return `${name}: ${value}`;
+    }
+    const precedence = outreachHeader(message, 'Precedence').trim().toLowerCase();
+    if ([
+        'auto_reply',
+        'bulk',
+        'junk'
+    ].includes(precedence)) return `Precedence: ${precedence}`;
+    const subject = String((_ref = message == null ? void 0 : message.subject) != null ? _ref : '').replace(/^\s*(re|fwd?)\s*:\s*/i, '');
+    const match = AUTO_REPLY_SUBJECT.exec(subject);
+    return match ? `Subject: ${match[0].trim()}` : null;
+}
+function addressesIn(header) {
+    return header.split(',').map((part)=>emailAddressOf(part)).filter((address)=>address !== null);
+}
+function readableText(message) {
+    var _message_snippet;
+    if (message.textBody && message.textBody.trim()) return message.textBody;
+    if (message.htmlBody && message.htmlBody.trim()) return htmlToPlainText(message.htmlBody);
+    return (_message_snippet = message.snippet) != null ? _message_snippet : '';
+}
+/** What one message in an enrollment's thread is — see the module note. */ export function classifyOutreachMessage(message, context) {
+    var _message_id, _context_selfAddresses, _message_to, _message_subject;
+    const from = emailAddressOf(message.from);
+    const base = {
+        messageId: String((_message_id = message.id) != null ? _message_id : ''),
+        atMs: Number.isFinite(message.internalDateMs) ? message.internalDateMs : 0,
+        from,
+        bounce: null,
+        complaint: false,
+        evidence: null
+    };
+    const report = readOutreachDeliveryReport(message);
+    if (report) {
+        if (!report.kind) return _extends({}, base, {
+            kind: 'delivery_report',
+            evidence: 'delivery report'
+        });
+        return _extends({}, base, {
+            kind: report.kind === 'hard' ? 'hard_bounce' : 'soft_bounce',
+            bounce: {
+                recipients: report.failedAddresses,
+                status: report.status,
+                diagnostic: report.diagnostic
+            },
+            evidence: report.status ? `Status: ${report.status}` : 'delivery report'
+        });
+    }
+    const self = new Set(((_context_selfAddresses = context.selfAddresses) != null ? _context_selfAddresses : []).map((address)=>normalizeContactEmail(address)).filter((address)=>address !== null));
+    if (from && self.has(from)) return _extends({}, base, {
+        kind: 'self'
+    });
+    if (isMailerDaemonMessage(message)) {
+        return _extends({}, base, {
+            kind: 'delivery_report',
+            evidence: 'mail system message'
+        });
+    }
+    const unsubscribe = normalizeContactEmail(context.unsubscribeAddress);
+    if (unsubscribe && addressesIn((_message_to = message.to) != null ? _message_to : '').includes(unsubscribe)) {
+        return _extends({}, base, {
+            kind: 'opt_out',
+            evidence: `To: ${unsubscribe}`
+        });
+    }
+    const autoReply = outreachAutoReplyEvidence(message);
+    if (autoReply) return _extends({}, base, {
+        kind: 'auto_reply',
+        evidence: autoReply
+    });
+    const intent = detectOutreachOptOutIntent(readableText(message));
+    if (intent.optOut) {
+        return _extends({}, base, {
+            kind: 'opt_out',
+            complaint: intent.complaint,
+            evidence: intent.matched
+        });
+    }
+    // A subject is read only on a message that starts fresh — no `Re:`, and
+    // not the thread's own — and only when it says nothing but stop.
+    const subject = String((_message_subject = message.subject) != null ? _message_subject : '').replace(/\s+/g, ' ').trim();
+    const fresh = crmThreadSubject(subject) === subject;
+    if (subject && fresh && subject !== crmThreadSubject(context.threadSubject)) {
+        const subjectIntent = detectOutreachOptOutSubject(subject);
+        if (subjectIntent.optOut) {
+            return _extends({}, base, {
+                kind: 'opt_out',
+                evidence: `Subject: ${subjectIntent.matched}`
+            });
+        }
+    }
+    return _extends({}, base, {
+        kind: 'reply'
+    });
+}
+const RANK = {
+    none: 0,
+    postpone: 1,
+    bounced: 2,
+    replied: 3,
+    opted_out: 4
+};
+const OUTCOME_OF = {
+    auto_reply: 'postpone',
+    hard_bounce: 'bounced',
+    reply: 'replied',
+    opt_out: 'opted_out'
+};
+/** What the new messages in an enrollment's thread mean for it — see the module note. */ export function decideOutreachThread(input) {
+    var _input_handledMessageIds, _input_messages;
+    const recipient = normalizeContactEmail(input.recipient);
+    const handled = new Set((_input_handledMessageIds = input.handledMessageIds) != null ? _input_handledMessageIds : []);
+    const afterMs = typeof input.afterMs === 'number' ? input.afterMs : null;
+    const fresh = [
+        ...(_input_messages = input.messages) != null ? _input_messages : []
+    ].filter((message)=>message && !handled.has(message.id)).filter((message)=>afterMs === null || message.internalDateMs > afterMs).sort((a, b)=>a.internalDateMs - b.internalDateMs);
+    const decision = {
+        outcome: 'none',
+        decidedBy: null,
+        classifications: [],
+        complaint: false,
+        hardBounces: 0,
+        softBounces: 0
+    };
+    for (const message of fresh){
+        const classification = classifyOutreachMessage(message, input);
+        decision.classifications.push(classification);
+        const bounce = classification.bounce;
+        const aboutRecipient = !bounce || !bounce.recipients.length || recipient !== null && bounce.recipients.includes(recipient);
+        if (classification.kind === 'hard_bounce' && aboutRecipient) decision.hardBounces += 1;
+        if (classification.kind === 'soft_bounce' && aboutRecipient) decision.softBounces += 1;
+        if (classification.complaint) decision.complaint = true;
+        const outcome = OUTCOME_OF[classification.kind];
+        if (!outcome || classification.kind === 'hard_bounce' && !aboutRecipient) continue;
+        if (RANK[outcome] > RANK[decision.outcome]) {
+            decision.outcome = outcome;
+            decision.decidedBy = classification;
+        }
+    }
+    return decision;
+}
+
+//# sourceMappingURL=thread-classification.js.map