@aglyn/plugins-outreach 1.0.0-beta.143

package/src/lib/runtime/sync-job.js

@@ -0,0 +1,480 @@
+/**
+ * @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 { normalizeContactEmail } from "@aglyn/aglyn/app-utils/contacts";
+import { crmInboundExcerpt, emailAddressOf } from "@aglyn/aglyn/app-utils/crm-inbound";
+import { outreachMessageIdHeader } from "../engine/compose.js";
+import { readOutreachDeliveryReport } from "../engine/delivery-status.js";
+import { effectiveOutreachWindow, postponeOutreachForAutoReply } from "../engine/schedule.js";
+import { decideOutreachThread } from "../engine/thread-classification.js";
+import { outreachHeader, outreachThreadMessageFromGmail } from "../engine/thread-message.js";
+import { mailboxRef } from "../mailboxes/mailbox-credentials.js";
+import { markOutreachMailboxReconnectRequired } from "../mailboxes/mailbox-transport.js";
+import { OUTREACH_COLLECTIONS } from "../model/outreach.types.js";
+import { addOutreachDoNotContact } from "../storage/do-not-contact-store.js";
+import { outreachOrgCollection, readStoredOutreachEnrollment, readStoredOutreachMailbox, readStoredOutreachSequence } from "../storage/outreach-records.js";
+import { GmailTransportError, isReconnectRequired } from "../transport/gmail-errors.js";
+import { applyOutreachEvent, recordOutreachOptOut } from "./enrollment-events.js";
+import { applyOutreachMailboxHealth, emptyOutreachHealthDelta } from "./mailbox-health-store.js";
+import { fileOutreachEmail, fileOutreachTask } from "./timeline.js";
+import { outreachUnsubscribeMailbox } from "./unsubscribe-link.js";
+/*==========================================
+ * THE SYNC JOB (AGL-2981): every fifteen minutes, on the console.
+ *
+ * For each connected or paused mailbox, what came back since the last run —
+ * read with `format=full`, turned into the engine's message shape and
+ * classified by `decideOutreachThread`:
+ *
+ * - a REPLY stops the enrollment, files the message on the contact's
+ *   timeline (once per `Message-ID`, under the capture address's own id for
+ *   it) and gives the rep the task "Reply from <name>";
+ * - an OUT-OF-OFFICE postpones the next step a working week from the reply;
+ * - an OPT-OUT — a reply asking to be left alone, or a message to the
+ *   `+unsubscribe` address the `mailto:` names — puts the address on the
+ *   organization's do-not-contact list and off the site's `sales` topic,
+ *   and stops every open enrollment of it;
+ * - a HARD BOUNCE stops the enrollment, files the address on the platform's
+ *   suppression list and the do-not-contact list.
+ *
+ * Four reads find those, each narrowed by Gmail rather than read in full:
+ * the threads of this mailbox's enrollments that have new mail; delivery
+ * reports outside those threads (a receiving server's own bounce), by
+ * searching for the mail systems that send them; messages to the
+ * unsubscribe address; and messages from the people this mailbox is
+ * writing to, in a thread of their own.
+ *
+ * Every write it makes is idempotent — the do-not-contact list keeps its
+ * first entry, a topic opt-out keeps its first moment, a timeline entry is
+ * filed once per message — and the messages it handled are marked AFTER
+ * their effects, on the enrollment and on the mailbox, so a run that dies
+ * part-way repeats harmless work rather than skipping some. The mailbox's
+ * health takes the run's bounces and complaints in one write at the end,
+ * which is where it pauses itself.
+ *==========================================*/ export { OUTREACH_SYNC_JOB_ID } from "../constants/runtime-jobs.js";
+/** The furthest back a run reads: a mailbox's first run, or one that fell behind. */ export const OUTREACH_SYNC_LOOKBACK_MS = 7 * 24 * 60 * 60000;
+/** How far a run reads back past the previous one, for mail Gmail indexed late. */ export const OUTREACH_SYNC_OVERLAP_MS = 2 * 60 * 60000;
+/** How long after its last send an enrollment's mail is still watched. */ export const OUTREACH_SYNC_WATCH_MS = 45 * 24 * 60 * 60000;
+/** The most pages of one search a run reads. */ const SEARCH_PAGES = 5;
+/** Handled message ids a mailbox keeps, and an enrollment keeps. */ const MAILBOX_HANDLED_MAX = 500;
+const ENROLLMENT_HANDLED_MAX = 100;
+/** Addresses in one `from:` search. */ const FROM_CHUNK = 15;
+/** Runs the sync job once — see the module note. */ export async function runOutreachSyncJob(deps, context) {
+    const firestore = deps.firestore();
+    const report = {
+        mailboxes: 0,
+        threads: 0,
+        replies: 0,
+        optOuts: 0,
+        bounces: 0,
+        postponed: 0,
+        paused: 0
+    };
+    const all = await firestore.collectionGroup(OUTREACH_COLLECTIONS.mailboxes).get();
+    const byOrg = new Map();
+    for (const doc of all.docs){
+        var _byOrg_get;
+        var _doc_ref_parent_parent;
+        const orgId = (_doc_ref_parent_parent = doc.ref.parent.parent) == null ? void 0 : _doc_ref_parent_parent.id;
+        const mailbox = readStoredOutreachMailbox(doc.id, doc.data());
+        if (!orgId || !mailbox || mailbox.status !== 'connected' && mailbox.status !== 'paused') continue;
+        byOrg.set(orgId, [
+            ...(_byOrg_get = byOrg.get(orgId)) != null ? _byOrg_get : [],
+            mailbox
+        ]);
+    }
+    for (const [orgId, mailboxes] of byOrg){
+        if (deps.now() >= context.deadlineMs) break;
+        const orgSnapshot = await firestore.collection('orgs').doc(orgId).get();
+        const org = orgSnapshot.exists ? orgSnapshot.data() : null;
+        if (!org || await deps.orgRefusal(orgId, org)) continue;
+        for (const mailbox of mailboxes){
+            if (deps.now() >= context.deadlineMs) break;
+            try {
+                await syncMailbox(deps, firestore, {
+                    orgId,
+                    mailbox,
+                    report,
+                    nowMs: context.nowMs
+                });
+                report.mailboxes += 1;
+            } catch (error) {
+                // One mailbox's failure is its own; the next mailbox is read. A grant
+                // Google refused is the mailbox's to reconnect.
+                if (isReconnectRequired(error)) {
+                    await markOutreachMailboxReconnectRequired(firestore, {
+                        orgId,
+                        mailboxId: mailbox.id,
+                        errorCode: error instanceof GmailTransportError ? error.code : 'invalid_grant',
+                        nowMs: context.nowMs
+                    });
+                }
+                console.error('[outreach] syncing a mailbox failed', error);
+            }
+        }
+    }
+    return report;
+}
+/** Every stub a search finds, a few pages deep. */ async function search(client, q) {
+    const found = [];
+    let pageToken = null;
+    for(let page = 0; page < SEARCH_PAGES; page += 1){
+        const list = await client.listMessages({
+            q,
+            maxResults: 100,
+            pageToken,
+            includeSpamTrash: true
+        });
+        found.push(...list.messages.filter((message)=>message.id));
+        pageToken = list.nextPageToken;
+        if (!pageToken) break;
+    }
+    return found;
+}
+async function syncMailbox(deps, firestore, input) {
+    var _mailbox_sendAsOptions, _ref, _ref1, _ref2;
+    var _mailbox_sync, _mailbox_sync1, _mailbox_sync2;
+    const { orgId, mailbox, report, nowMs } = input;
+    const opened = await deps.openMailbox(mailbox.id);
+    if (opened.ok === false) {
+        if (opened.reason !== 'not-configured') {
+            await markOutreachMailboxReconnectRequired(firestore, {
+                orgId,
+                mailboxId: mailbox.id,
+                errorCode: opened.reason,
+                nowMs
+            });
+        }
+        return;
+    }
+    const unsubscribe = outreachUnsubscribeMailbox(mailbox.email);
+    const context = {
+        deps,
+        firestore,
+        orgId,
+        mailbox,
+        client: opened.client,
+        selfAddresses: [
+            mailbox.email,
+            mailbox.sendAs,
+            ...((_mailbox_sendAsOptions = mailbox.sendAsOptions) != null ? _mailbox_sendAsOptions : []).map((option)=>option.email)
+        ].filter(Boolean),
+        unsubscribeAddress: (_ref = unsubscribe == null ? void 0 : unsubscribe.address) != null ? _ref : null,
+        sequences: new Map(),
+        delta: emptyOutreachHealthDelta(),
+        report,
+        nowMs
+    };
+    // The enrollments this mailbox is writing to, by thread and by address.
+    const watched = await outreachOrgCollection(firestore, orgId, 'enrollments').where('mailboxId', '==', mailbox.id).where('lastSentAtMs', '>=', nowMs - OUTREACH_SYNC_WATCH_MS).get();
+    const byThread = new Map();
+    const byAddress = new Map();
+    for (const doc of watched.docs){
+        var _enrollment_lastSentAtMs, _known_lastSentAtMs;
+        const enrollment = readStoredOutreachEnrollment(doc.id, doc.data());
+        if (!enrollment) continue;
+        for (const threadId of enrollment.gmailThreadIds)byThread.set(threadId, enrollment);
+        const known = byAddress.get(enrollment.email);
+        if (!known || ((_enrollment_lastSentAtMs = enrollment.lastSentAtMs) != null ? _enrollment_lastSentAtMs : 0) > ((_known_lastSentAtMs = known.lastSentAtMs) != null ? _known_lastSentAtMs : 0)) byAddress.set(enrollment.email, enrollment);
+    }
+    const sinceMs = Math.max(Number((_mailbox_sync = mailbox.sync) == null ? void 0 : _mailbox_sync.throughMs) || 0, nowMs - OUTREACH_SYNC_LOOKBACK_MS) - OUTREACH_SYNC_OVERLAP_MS;
+    const after = `after:${Math.floor(sinceMs / 1000)}`;
+    // Every message this run or an earlier one handled outside an enrollment's
+    // thread; one message is handled once however many searches find it.
+    const handled = new Set((_ref1 = (_mailbox_sync1 = mailbox.sync) == null ? void 0 : _mailbox_sync1.handledMessageIds) != null ? _ref1 : []);
+    const newlyHandled = [];
+    const markHandled = (id)=>{
+        if (handled.has(id)) return;
+        handled.add(id);
+        newlyHandled.push(id);
+    };
+    const fresh = (stub)=>!handled.has(stub.id) && !byThread.has(stub.threadId);
+    // 1. The enrollments' own threads that have new mail.
+    const inbound = await search(context.client, `${after} -from:me`);
+    for (const threadId of new Set(inbound.map((stub)=>stub.threadId))){
+        const enrollment = byThread.get(threadId);
+        if (!enrollment) continue;
+        const thread = await context.client.getFullThread(threadId);
+        report.threads += 1;
+        await applyMessages(context, enrollment, thread.messages.map(outreachThreadMessageFromGmail));
+    }
+    // 2. Delivery reports outside those threads: a receiving server's bounce.
+    for (const stub of (await search(context.client, `${after} from:(mailer-daemon OR postmaster)`))){
+        if (!fresh(stub)) continue;
+        const message = outreachThreadMessageFromGmail(await context.client.getFullMessage(stub.id));
+        const delivery = readOutreachDeliveryReport(message);
+        if ((delivery == null ? void 0 : delivery.kind) === 'hard') {
+            for (const address of delivery.failedAddresses){
+                const enrollment = byAddress.get(address);
+                if (enrollment) await applyMessages(context, enrollment, [
+                    message
+                ]);
+            }
+        }
+        markHandled(stub.id);
+    }
+    // 3. Messages to the unsubscribe address: whoever wrote asked to leave.
+    if (unsubscribe) {
+        for (const stub of (await search(context.client, `${after} to:${unsubscribe.address}`))){
+            var _ref3;
+            var _metadata_headers_find;
+            if (handled.has(stub.id)) continue;
+            const metadata = await context.client.getMessage(stub.id, {
+                metadataHeaders: [
+                    'From'
+                ]
+            });
+            const from = emailAddressOf((_ref3 = (_metadata_headers_find = metadata.headers.find((header)=>header.name.toLowerCase() === 'from')) == null ? void 0 : _metadata_headers_find.value) != null ? _ref3 : '');
+            const address = normalizeContactEmail(from);
+            if (address && !context.selfAddresses.includes(address)) {
+                var _byAddress_get;
+                const enrollment = (_byAddress_get = byAddress.get(address)) != null ? _byAddress_get : null;
+                await recordOutreachOptOut(deps, {
+                    orgId,
+                    email: address,
+                    source: 'unsubscribe',
+                    enrollment,
+                    hostIds: enrollment ? [
+                        enrollment.hostId
+                    ] : [],
+                    detail: 'Wrote to the unsubscribe address.',
+                    nowMs
+                });
+                report.optOuts += 1;
+            }
+            markHandled(stub.id);
+        }
+    }
+    // 4. The people this mailbox writes to, answering in a thread of their own.
+    const addresses = [
+        ...byAddress.keys()
+    ];
+    for(let start = 0; start < addresses.length; start += FROM_CHUNK){
+        const chunk = addresses.slice(start, start + FROM_CHUNK);
+        for (const stub of (await search(context.client, `${after} from:(${chunk.join(' OR ')})`))){
+            var _normalizeContactEmail;
+            if (!fresh(stub)) continue;
+            const message = outreachThreadMessageFromGmail(await context.client.getFullMessage(stub.id));
+            const enrollment = byAddress.get((_normalizeContactEmail = normalizeContactEmail(emailAddressOf(message.from))) != null ? _normalizeContactEmail : '');
+            if (enrollment) await applyMessages(context, enrollment, [
+                message
+            ]);
+            markHandled(stub.id);
+        }
+    }
+    const paused = await applyOutreachMailboxHealth(deps, {
+        orgId,
+        mailboxId: mailbox.id,
+        delta: context.delta
+    });
+    if (paused) report.paused += 1;
+    await mailboxRef(firestore, orgId, mailbox.id).update({
+        sync: {
+            throughMs: nowMs,
+            handledMessageIds: [
+                ...(_ref2 = (_mailbox_sync2 = mailbox.sync) == null ? void 0 : _mailbox_sync2.handledMessageIds) != null ? _ref2 : [],
+                ...newlyHandled
+            ].slice(-MAILBOX_HANDLED_MAX)
+        }
+    });
+}
+/** The sequence an enrollment runs through, read once per run. */ async function sequenceOf(context, sequenceId) {
+    var _context_sequences_get;
+    if (!context.sequences.has(sequenceId)) {
+        const snapshot = await outreachOrgCollection(context.firestore, context.orgId, 'sequences').doc(sequenceId).get();
+        context.sequences.set(sequenceId, readStoredOutreachSequence(sequenceId, snapshot.exists ? snapshot.data() : undefined));
+    }
+    return (_context_sequences_get = context.sequences.get(sequenceId)) != null ? _context_sequences_get : null;
+}
+/** A message's `Message-ID` in header form, or `null` when it carries none. */ const messageIdOf = (message)=>outreachMessageIdHeader(outreachHeader(message, 'Message-ID'));
+/** A bounce's diagnostic with the recipient's address taken out of it. */ export function scrubbedOutreachDiagnostic(diagnostic, email) {
+    if (!diagnostic) return null;
+    const pattern = new RegExp(email.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'gi');
+    return diagnostic.replace(pattern, 'the address');
+}
+/** Files a message the person wrote on their timeline. */ async function fileInbound(context, enrollment, message) {
+    var _emailAddressOf, _ref, _message_textBody, _message_htmlBody;
+    const messageId = messageIdOf(message);
+    if (!messageId) return;
+    await fileOutreachEmail(context.deps, {
+        orgId: context.orgId,
+        hostId: enrollment.hostId,
+        contactId: enrollment.contactId,
+        direction: 'inbound',
+        subject: message.subject,
+        from: (_emailAddressOf = emailAddressOf(message.from)) != null ? _emailAddressOf : message.from,
+        to: context.mailbox.sendAs || context.mailbox.email,
+        messageId,
+        inReplyTo: outreachMessageIdHeader(outreachHeader(message, 'In-Reply-To')),
+        body: crmInboundExcerpt((_ref = (_message_textBody = message.textBody) != null ? _message_textBody : message.snippet) != null ? _ref : '', (_message_htmlBody = message.htmlBody) != null ? _message_htmlBody : ''),
+        atMs: message.internalDateMs,
+        byUid: ''
+    });
+}
+/**
+ * What the new messages of one enrollment mean, done: the effects first,
+ * each idempotent, then the event and the handled ids in one transaction.
+ */ async function applyMessages(context, enrollment, messages) {
+    var _enrollment_syncedMessageIds, _messages_find, _enrollment_messageIds_;
+    var _outcome_enrollment;
+    const { deps, firestore, report, nowMs } = context;
+    const decision = decideOutreachThread({
+        messages,
+        recipient: enrollment.email,
+        handledMessageIds: (_enrollment_syncedMessageIds = enrollment.syncedMessageIds) != null ? _enrollment_syncedMessageIds : [],
+        selfAddresses: context.selfAddresses,
+        unsubscribeAddress: context.unsubscribeAddress,
+        threadSubject: enrollment.threadSubject
+    });
+    const freshIds = decision.classifications.map((classification)=>classification.messageId).filter(Boolean);
+    if (!freshIds.length) return;
+    const decidedBy = decision.decidedBy;
+    const decidingMessage = decidedBy ? (_messages_find = messages.find((message)=>message.id === decidedBy.messageId)) != null ? _messages_find : null : null;
+    const lastSentMessageId = (_enrollment_messageIds_ = enrollment.messageIds[enrollment.messageIds.length - 1]) != null ? _enrollment_messageIds_ : null;
+    for (const classification of decision.classifications){
+        var _classification_bounce;
+        const aboutRecipient = !((_classification_bounce = classification.bounce) == null ? void 0 : _classification_bounce.recipients.length) || classification.bounce.recipients.includes(enrollment.email);
+        if (classification.kind === 'hard_bounce' && aboutRecipient) {
+            context.delta.bounces.push({
+                atMs: classification.atMs || nowMs,
+                messageId: lastSentMessageId
+            });
+        }
+        if (classification.complaint) {
+            var _context_delta_complaintAtMs;
+            context.delta.complaintAtMs = Math.max((_context_delta_complaintAtMs = context.delta.complaintAtMs) != null ? _context_delta_complaintAtMs : 0, classification.atMs || nowMs);
+        }
+    }
+    let event = null;
+    let postponedTo = null;
+    switch(decision.outcome){
+        case 'opted_out':
+            {
+                var _ref;
+                var _decidedBy_evidence;
+                if (decidingMessage) await fileInbound(context, enrollment, decidingMessage);
+                await recordOutreachOptOut(deps, {
+                    orgId: context.orgId,
+                    email: enrollment.email,
+                    source: (decidedBy == null ? void 0 : (_decidedBy_evidence = decidedBy.evidence) == null ? void 0 : _decidedBy_evidence.startsWith('To:')) ? 'unsubscribe' : 'opt_out_reply',
+                    enrollment,
+                    hostIds: [
+                        enrollment.hostId
+                    ],
+                    detail: (_ref = decidedBy == null ? void 0 : decidedBy.evidence) != null ? _ref : null,
+                    nowMs
+                });
+                report.optOuts += 1;
+                break;
+            }
+        case 'replied':
+            {
+                var _ref1;
+                if (decidingMessage) {
+                    await fileInbound(context, enrollment, decidingMessage);
+                    try {
+                        var _messageIdOf, _ref2, _decidingMessage_textBody, _decidingMessage_htmlBody;
+                        await fileOutreachTask(deps, {
+                            orgId: context.orgId,
+                            hostId: enrollment.hostId,
+                            contactId: enrollment.contactId,
+                            dedupeKey: `reply:${(_messageIdOf = messageIdOf(decidingMessage)) != null ? _messageIdOf : decidingMessage.id}`,
+                            title: `Reply from ${enrollment.contactName || enrollment.email}`,
+                            notes: crmInboundExcerpt((_ref2 = (_decidingMessage_textBody = decidingMessage.textBody) != null ? _decidingMessage_textBody : decidingMessage.snippet) != null ? _ref2 : '', (_decidingMessage_htmlBody = decidingMessage.htmlBody) != null ? _decidingMessage_htmlBody : '').slice(0, 500),
+                            kind: 'email',
+                            dueAtMs: nowMs,
+                            assigneeUid: context.mailbox.connectedByUid
+                        });
+                    } catch (error) {
+                        console.error('[outreach] the reply task could not be filed', error);
+                    }
+                }
+                context.delta.replies += 1;
+                event = {
+                    type: 'reply',
+                    atMs: (decidedBy == null ? void 0 : decidedBy.atMs) || nowMs,
+                    detail: (_ref1 = decidedBy == null ? void 0 : decidedBy.evidence) != null ? _ref1 : null
+                };
+                report.replies += 1;
+                break;
+            }
+        case 'bounced':
+            {
+                var _ref3, _ref4;
+                var _decidedBy_bounce, _decidedBy_bounce1;
+                const diagnostic = scrubbedOutreachDiagnostic((_ref3 = (_ref4 = decidedBy == null ? void 0 : (_decidedBy_bounce = decidedBy.bounce) == null ? void 0 : _decidedBy_bounce.diagnostic) != null ? _ref4 : decidedBy == null ? void 0 : (_decidedBy_bounce1 = decidedBy.bounce) == null ? void 0 : _decidedBy_bounce1.status) != null ? _ref3 : null, enrollment.email);
+                await deps.suppressBouncedEmail({
+                    email: enrollment.email,
+                    hostId: enrollment.hostId
+                });
+                await addOutreachDoNotContact(firestore, {
+                    orgId: context.orgId,
+                    email: enrollment.email,
+                    reason: 'hard_bounce',
+                    source: 'runtime',
+                    nowMs,
+                    enrollmentId: enrollment.id,
+                    sequenceId: enrollment.sequenceId,
+                    detail: diagnostic
+                });
+                event = {
+                    type: 'bounce',
+                    atMs: (decidedBy == null ? void 0 : decidedBy.atMs) || nowMs,
+                    detail: diagnostic
+                };
+                report.bounces += 1;
+                break;
+            }
+        case 'postpone':
+            {
+                const sequence = await sequenceOf(context, enrollment.sequenceId);
+                postponedTo = postponeOutreachForAutoReply({
+                    nextDueAtMs: enrollment.nextDueAtMs,
+                    receivedAtMs: (decidedBy == null ? void 0 : decidedBy.atMs) || nowMs,
+                    timeZone: context.mailbox.timezone,
+                    window: effectiveOutreachWindow(sequence == null ? void 0 : sequence.settings.window, context.mailbox.window),
+                    random: deps.random
+                });
+                break;
+            }
+        default:
+            break;
+    }
+    const outcome = await applyOutreachEvent(firestore, {
+        orgId: context.orgId,
+        enrollmentId: enrollment.id,
+        event,
+        extra: (current)=>{
+            var _current_syncedMessageIds;
+            const extra = {
+                syncedMessageIds: [
+                    ...(_current_syncedMessageIds = current.syncedMessageIds) != null ? _current_syncedMessageIds : [],
+                    ...freshIds
+                ].slice(-ENROLLMENT_HANDLED_MAX)
+            };
+            const waiting = current.status === 'active' || current.status === 'paused';
+            if (postponedTo !== null && waiting && current.nextDueAtMs !== null && postponedTo > current.nextDueAtMs) {
+                extra['nextDueAtMs'] = postponedTo;
+            }
+            return extra;
+        },
+        nowMs
+    });
+    if (postponedTo !== null && ((_outcome_enrollment = outcome.enrollment) == null ? void 0 : _outcome_enrollment.nextDueAtMs) === postponedTo) report.postponed += 1;
+    // The run's own view of the enrollment moves with it, so a second message
+    // of it in this run is judged against what this one did.
+    if (outcome.enrollment) Object.assign(enrollment, outcome.enrollment);
+}
+
+//# sourceMappingURL=sync-job.js.map

package/src/lib/runtime/sync-job.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/outreach/src/lib/runtime/sync-job.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\nimport { normalizeContactEmail } from '@aglyn/aglyn/app-utils/contacts'\nimport { crmInboundExcerpt, emailAddressOf } from '@aglyn/aglyn/app-utils/crm-inbound'\nimport { outreachMessageIdHeader } from '../engine/compose'\nimport { readOutreachDeliveryReport } from '../engine/delivery-status'\nimport type { OutreachEnrollmentEvent } from '../engine/enrollment-state'\nimport { effectiveOutreachWindow, postponeOutreachForAutoReply } from '../engine/schedule'\nimport {\n  decideOutreachThread,\n  type OutreachMessageClassification,\n  type OutreachThreadDecision,\n} from '../engine/thread-classification'\nimport { outreachHeader, outreachThreadMessageFromGmail, type OutreachThreadMessage } from '../engine/thread-message'\nimport { mailboxRef } from '../mailboxes/mailbox-credentials'\nimport { markOutreachMailboxReconnectRequired } from '../mailboxes/mailbox-transport'\nimport {\n  OUTREACH_COLLECTIONS,\n  type OutreachEnrollment,\n  type OutreachMailbox,\n  type OutreachSequence,\n} from '../model/outreach.types'\nimport { addOutreachDoNotContact } from '../storage/do-not-contact-store'\nimport {\n  outreachOrgCollection,\n  readStoredOutreachEnrollment,\n  readStoredOutreachMailbox,\n  readStoredOutreachSequence,\n} from '../storage/outreach-records'\nimport type { GmailClient } from '../transport/gmail-client'\nimport { GmailTransportError, isReconnectRequired } from '../transport/gmail-errors'\nimport { applyOutreachEvent, recordOutreachOptOut } from './enrollment-events'\nimport {\n  applyOutreachMailboxHealth,\n  emptyOutreachHealthDelta,\n  type OutreachMailboxHealthDelta,\n} from './mailbox-health-store'\nimport type { OutreachRuntimeDeps } from './runtime-deps'\nimport { fileOutreachEmail, fileOutreachTask } from './timeline'\nimport { outreachUnsubscribeMailbox } from './unsubscribe-link'\n\n/*==========================================\n * THE SYNC JOB (AGL-2981): every fifteen minutes, on the console.\n *\n * For each connected or paused mailbox, what came back since the last run —\n * read with `format=full`, turned into the engine's message shape and\n * classified by `decideOutreachThread`:\n *\n * - a REPLY stops the enrollment, files the message on the contact's\n *   timeline (once per `Message-ID`, under the capture address's own id for\n *   it) and gives the rep the task \"Reply from <name>\";\n * - an OUT-OF-OFFICE postpones the next step a working week from the reply;\n * - an OPT-OUT — a reply asking to be left alone, or a message to the\n *   `+unsubscribe` address the `mailto:` names — puts the address on the\n *   organization's do-not-contact list and off the site's `sales` topic,\n *   and stops every open enrollment of it;\n * - a HARD BOUNCE stops the enrollment, files the address on the platform's\n *   suppression list and the do-not-contact list.\n *\n * Four reads find those, each narrowed by Gmail rather than read in full:\n * the threads of this mailbox's enrollments that have new mail; delivery\n * reports outside those threads (a receiving server's own bounce), by\n * searching for the mail systems that send them; messages to the\n * unsubscribe address; and messages from the people this mailbox is\n * writing to, in a thread of their own.\n *\n * Every write it makes is idempotent — the do-not-contact list keeps its\n * first entry, a topic opt-out keeps its first moment, a timeline entry is\n * filed once per message — and the messages it handled are marked AFTER\n * their effects, on the enrollment and on the mailbox, so a run that dies\n * part-way repeats harmless work rather than skipping some. The mailbox's\n * health takes the run's bounces and complaints in one write at the end,\n * which is where it pauses itself.\n *==========================================*/\n\nexport { OUTREACH_SYNC_JOB_ID } from '../constants/runtime-jobs'\n\n/** The furthest back a run reads: a mailbox's first run, or one that fell behind. */\nexport const OUTREACH_SYNC_LOOKBACK_MS = 7 * 24 * 60 * 60_000\n\n/** How far a run reads back past the previous one, for mail Gmail indexed late. */\nexport const OUTREACH_SYNC_OVERLAP_MS = 2 * 60 * 60_000\n\n/** How long after its last send an enrollment's mail is still watched. */\nexport const OUTREACH_SYNC_WATCH_MS = 45 * 24 * 60 * 60_000\n\n/** The most pages of one search a run reads. */\nconst SEARCH_PAGES = 5\n/** Handled message ids a mailbox keeps, and an enrollment keeps. */\nconst MAILBOX_HANDLED_MAX = 500\nconst ENROLLMENT_HANDLED_MAX = 100\n/** Addresses in one `from:` search. */\nconst FROM_CHUNK = 15\n\ntype Firestore = FirebaseFirestore.Firestore\n\nexport interface OutreachSyncReport {\n  [key: string]: number\n  mailboxes: number\n  threads: number\n  replies: number\n  optOuts: number\n  bounces: number\n  postponed: number\n  paused: number\n}\n\ninterface SyncContext {\n  deps: OutreachRuntimeDeps\n  firestore: Firestore\n  orgId: string\n  mailbox: OutreachMailbox\n  client: GmailClient\n  selfAddresses: string[]\n  unsubscribeAddress: string | null\n  sequences: Map<string, OutreachSequence | null>\n  delta: OutreachMailboxHealthDelta\n  report: OutreachSyncReport\n  nowMs: number\n}\n\n/** Runs the sync job once — see the module note. */\nexport async function runOutreachSyncJob(\n  deps: OutreachRuntimeDeps,\n  context: { nowMs: number; deadlineMs: number },\n): Promise<OutreachSyncReport> {\n  const firestore = deps.firestore()\n  const report: OutreachSyncReport = {\n    mailboxes: 0,\n    threads: 0,\n    replies: 0,\n    optOuts: 0,\n    bounces: 0,\n    postponed: 0,\n    paused: 0,\n  }\n  const all = await firestore.collectionGroup(OUTREACH_COLLECTIONS.mailboxes).get()\n  const byOrg = new Map<string, OutreachMailbox[]>()\n  for (const doc of all.docs) {\n    const orgId = doc.ref.parent.parent?.id\n    const mailbox = readStoredOutreachMailbox(doc.id, doc.data())\n    if (!orgId || !mailbox || (mailbox.status !== 'connected' && mailbox.status !== 'paused')) continue\n    byOrg.set(orgId, [...(byOrg.get(orgId) ?? []), mailbox])\n  }\n  for (const [orgId, mailboxes] of byOrg) {\n    if (deps.now() >= context.deadlineMs) break\n    const orgSnapshot = await firestore.collection('orgs').doc(orgId).get()\n    const org = (orgSnapshot.exists ? orgSnapshot.data() : null) as Record<string, unknown> | null\n    if (!org || (await deps.orgRefusal(orgId, org))) continue\n    for (const mailbox of mailboxes) {\n      if (deps.now() >= context.deadlineMs) break\n      try {\n        await syncMailbox(deps, firestore, { orgId, mailbox, report, nowMs: context.nowMs })\n        report.mailboxes += 1\n      } catch (error) {\n        // One mailbox's failure is its own; the next mailbox is read. A grant\n        // Google refused is the mailbox's to reconnect.\n        if (isReconnectRequired(error)) {\n          await markOutreachMailboxReconnectRequired(firestore, {\n            orgId,\n            mailboxId: mailbox.id,\n            errorCode: error instanceof GmailTransportError ? error.code : 'invalid_grant',\n            nowMs: context.nowMs,\n          })\n        }\n        console.error('[outreach] syncing a mailbox failed', error)\n      }\n    }\n  }\n  return report\n}\n\n/** Every stub a search finds, a few pages deep. */\nasync function search(\n  client: GmailClient,\n  q: string,\n): Promise<Array<{ id: string; threadId: string }>> {\n  const found: Array<{ id: string; threadId: string }> = []\n  let pageToken: string | null = null\n  for (let page = 0; page < SEARCH_PAGES; page += 1) {\n    const list = await client.listMessages({ q, maxResults: 100, pageToken, includeSpamTrash: true })\n    found.push(...list.messages.filter((message) => message.id))\n    pageToken = list.nextPageToken\n    if (!pageToken) break\n  }\n  return found\n}\n\nasync function syncMailbox(\n  deps: OutreachRuntimeDeps,\n  firestore: Firestore,\n  input: { orgId: string; mailbox: OutreachMailbox; report: OutreachSyncReport; nowMs: number },\n): Promise<void> {\n  const { orgId, mailbox, report, nowMs } = input\n  const opened = await deps.openMailbox(mailbox.id)\n  if (opened.ok === false) {\n    if (opened.reason !== 'not-configured') {\n      await markOutreachMailboxReconnectRequired(firestore, {\n        orgId,\n        mailboxId: mailbox.id,\n        errorCode: opened.reason,\n        nowMs,\n      })\n    }\n    return\n  }\n  const unsubscribe = outreachUnsubscribeMailbox(mailbox.email)\n  const context: SyncContext = {\n    deps,\n    firestore,\n    orgId,\n    mailbox,\n    client: opened.client,\n    selfAddresses: [\n      mailbox.email,\n      mailbox.sendAs,\n      ...(mailbox.sendAsOptions ?? []).map((option) => option.email),\n    ].filter(Boolean),\n    unsubscribeAddress: unsubscribe?.address ?? null,\n    sequences: new Map(),\n    delta: emptyOutreachHealthDelta(),\n    report,\n    nowMs,\n  }\n\n  // The enrollments this mailbox is writing to, by thread and by address.\n  const watched = await outreachOrgCollection(firestore, orgId, 'enrollments')\n    .where('mailboxId', '==', mailbox.id)\n    .where('lastSentAtMs', '>=', nowMs - OUTREACH_SYNC_WATCH_MS)\n    .get()\n  const byThread = new Map<string, OutreachEnrollment>()\n  const byAddress = new Map<string, OutreachEnrollment>()\n  for (const doc of watched.docs) {\n    const enrollment = readStoredOutreachEnrollment(doc.id, doc.data())\n    if (!enrollment) continue\n    for (const threadId of enrollment.gmailThreadIds) byThread.set(threadId, enrollment)\n    const known = byAddress.get(enrollment.email)\n    if (!known || (enrollment.lastSentAtMs ?? 0) > (known.lastSentAtMs ?? 0)) byAddress.set(enrollment.email, enrollment)\n  }\n\n  const sinceMs = Math.max(Number(mailbox.sync?.throughMs) || 0, nowMs - OUTREACH_SYNC_LOOKBACK_MS) - OUTREACH_SYNC_OVERLAP_MS\n  const after = `after:${Math.floor(sinceMs / 1000)}`\n  // Every message this run or an earlier one handled outside an enrollment's\n  // thread; one message is handled once however many searches find it.\n  const handled = new Set(mailbox.sync?.handledMessageIds ?? [])\n  const newlyHandled: string[] = []\n  const markHandled = (id: string) => {\n    if (handled.has(id)) return\n    handled.add(id)\n    newlyHandled.push(id)\n  }\n  const fresh = (stub: { id: string; threadId: string }) => !handled.has(stub.id) && !byThread.has(stub.threadId)\n\n  // 1. The enrollments' own threads that have new mail.\n  const inbound = await search(context.client, `${after} -from:me`)\n  for (const threadId of new Set(inbound.map((stub) => stub.threadId))) {\n    const enrollment = byThread.get(threadId)\n    if (!enrollment) continue\n    const thread = await context.client.getFullThread(threadId)\n    report.threads += 1\n    await applyMessages(context, enrollment, thread.messages.map(outreachThreadMessageFromGmail))\n  }\n\n  // 2. Delivery reports outside those threads: a receiving server's bounce.\n  for (const stub of await search(context.client, `${after} from:(mailer-daemon OR postmaster)`)) {\n    if (!fresh(stub)) continue\n    const message = outreachThreadMessageFromGmail(await context.client.getFullMessage(stub.id))\n    const delivery = readOutreachDeliveryReport(message)\n    if (delivery?.kind === 'hard') {\n      for (const address of delivery.failedAddresses) {\n        const enrollment = byAddress.get(address)\n        if (enrollment) await applyMessages(context, enrollment, [message])\n      }\n    }\n    markHandled(stub.id)\n  }\n\n  // 3. Messages to the unsubscribe address: whoever wrote asked to leave.\n  if (unsubscribe) {\n    for (const stub of await search(context.client, `${after} to:${unsubscribe.address}`)) {\n      if (handled.has(stub.id)) continue\n      const metadata = await context.client.getMessage(stub.id, { metadataHeaders: ['From'] })\n      const from = emailAddressOf(metadata.headers.find((header) => header.name.toLowerCase() === 'from')?.value ?? '')\n      const address = normalizeContactEmail(from)\n      if (address && !context.selfAddresses.includes(address)) {\n        const enrollment = byAddress.get(address) ?? null\n        await recordOutreachOptOut(deps, {\n          orgId,\n          email: address,\n          source: 'unsubscribe',\n          enrollment,\n          hostIds: enrollment ? [enrollment.hostId] : [],\n          detail: 'Wrote to the unsubscribe address.',\n          nowMs,\n        })\n        report.optOuts += 1\n      }\n      markHandled(stub.id)\n    }\n  }\n\n  // 4. The people this mailbox writes to, answering in a thread of their own.\n  const addresses = [...byAddress.keys()]\n  for (let start = 0; start < addresses.length; start += FROM_CHUNK) {\n    const chunk = addresses.slice(start, start + FROM_CHUNK)\n    for (const stub of await search(context.client, `${after} from:(${chunk.join(' OR ')})`)) {\n      if (!fresh(stub)) continue\n      const message = outreachThreadMessageFromGmail(await context.client.getFullMessage(stub.id))\n      const enrollment = byAddress.get(normalizeContactEmail(emailAddressOf(message.from)) ?? '')\n      if (enrollment) await applyMessages(context, enrollment, [message])\n      markHandled(stub.id)\n    }\n  }\n\n  const paused = await applyOutreachMailboxHealth(deps, { orgId, mailboxId: mailbox.id, delta: context.delta })\n  if (paused) report.paused += 1\n  await mailboxRef(firestore, orgId, mailbox.id).update({\n    sync: {\n      throughMs: nowMs,\n      handledMessageIds: [...(mailbox.sync?.handledMessageIds ?? []), ...newlyHandled].slice(-MAILBOX_HANDLED_MAX),\n    },\n  })\n}\n\n/** The sequence an enrollment runs through, read once per run. */\nasync function sequenceOf(context: SyncContext, sequenceId: string): Promise<OutreachSequence | null> {\n  if (!context.sequences.has(sequenceId)) {\n    const snapshot = await outreachOrgCollection(context.firestore, context.orgId, 'sequences').doc(sequenceId).get()\n    context.sequences.set(sequenceId, readStoredOutreachSequence(sequenceId, snapshot.exists ? snapshot.data() : undefined))\n  }\n  return context.sequences.get(sequenceId) ?? null\n}\n\n/** A message's `Message-ID` in header form, or `null` when it carries none. */\nconst messageIdOf = (message: OutreachThreadMessage) => outreachMessageIdHeader(outreachHeader(message, 'Message-ID'))\n\n/** A bounce's diagnostic with the recipient's address taken out of it. */\nexport function scrubbedOutreachDiagnostic(diagnostic: string | null, email: string): string | null {\n  if (!diagnostic) return null\n  const pattern = new RegExp(email.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&'), 'gi')\n  return diagnostic.replace(pattern, 'the address')\n}\n\n/** Files a message the person wrote on their timeline. */\nasync function fileInbound(context: SyncContext, enrollment: OutreachEnrollment, message: OutreachThreadMessage) {\n  const messageId = messageIdOf(message)\n  if (!messageId) return\n  await fileOutreachEmail(context.deps, {\n    orgId: context.orgId,\n    hostId: enrollment.hostId,\n    contactId: enrollment.contactId,\n    direction: 'inbound',\n    subject: message.subject,\n    from: emailAddressOf(message.from) ?? message.from,\n    to: context.mailbox.sendAs || context.mailbox.email,\n    messageId,\n    inReplyTo: outreachMessageIdHeader(outreachHeader(message, 'In-Reply-To')),\n    body: crmInboundExcerpt(message.textBody ?? message.snippet ?? '', message.htmlBody ?? ''),\n    atMs: message.internalDateMs,\n    byUid: '',\n  })\n}\n\n/**\n * What the new messages of one enrollment mean, done: the effects first,\n * each idempotent, then the event and the handled ids in one transaction.\n */\nasync function applyMessages(\n  context: SyncContext,\n  enrollment: OutreachEnrollment,\n  messages: readonly OutreachThreadMessage[],\n): Promise<void> {\n  const { deps, firestore, report, nowMs } = context\n  const decision: OutreachThreadDecision = decideOutreachThread({\n    messages,\n    recipient: enrollment.email,\n    handledMessageIds: enrollment.syncedMessageIds ?? [],\n    selfAddresses: context.selfAddresses,\n    unsubscribeAddress: context.unsubscribeAddress,\n    threadSubject: enrollment.threadSubject,\n  })\n  const freshIds = decision.classifications.map((classification) => classification.messageId).filter(Boolean)\n  if (!freshIds.length) return\n  const decidedBy: OutreachMessageClassification | null = decision.decidedBy\n  const decidingMessage = decidedBy ? messages.find((message) => message.id === decidedBy.messageId) ?? null : null\n  const lastSentMessageId = enrollment.messageIds[enrollment.messageIds.length - 1] ?? null\n\n  for (const classification of decision.classifications) {\n    const aboutRecipient =\n      !classification.bounce?.recipients.length || classification.bounce.recipients.includes(enrollment.email)\n    if (classification.kind === 'hard_bounce' && aboutRecipient) {\n      context.delta.bounces.push({ atMs: classification.atMs || nowMs, messageId: lastSentMessageId })\n    }\n    if (classification.complaint) {\n      context.delta.complaintAtMs = Math.max(context.delta.complaintAtMs ?? 0, classification.atMs || nowMs)\n    }\n  }\n\n  let event: OutreachEnrollmentEvent | null = null\n  let postponedTo: number | null = null\n  switch (decision.outcome) {\n    case 'opted_out': {\n      if (decidingMessage) await fileInbound(context, enrollment, decidingMessage)\n      await recordOutreachOptOut(deps, {\n        orgId: context.orgId,\n        email: enrollment.email,\n        source: decidedBy?.evidence?.startsWith('To:') ? 'unsubscribe' : 'opt_out_reply',\n        enrollment,\n        hostIds: [enrollment.hostId],\n        detail: decidedBy?.evidence ?? null,\n        nowMs,\n      })\n      report.optOuts += 1\n      break\n    }\n    case 'replied': {\n      if (decidingMessage) {\n        await fileInbound(context, enrollment, decidingMessage)\n        try {\n          await fileOutreachTask(deps, {\n            orgId: context.orgId,\n            hostId: enrollment.hostId,\n            contactId: enrollment.contactId,\n            dedupeKey: `reply:${messageIdOf(decidingMessage) ?? decidingMessage.id}`,\n            title: `Reply from ${enrollment.contactName || enrollment.email}`,\n            notes: crmInboundExcerpt(decidingMessage.textBody ?? decidingMessage.snippet ?? '', decidingMessage.htmlBody ?? '').slice(0, 500),\n            kind: 'email',\n            dueAtMs: nowMs,\n            assigneeUid: context.mailbox.connectedByUid,\n          })\n        } catch (error) {\n          console.error('[outreach] the reply task could not be filed', error)\n        }\n      }\n      context.delta.replies += 1\n      event = { type: 'reply', atMs: decidedBy?.atMs || nowMs, detail: decidedBy?.evidence ?? null }\n      report.replies += 1\n      break\n    }\n    case 'bounced': {\n      const diagnostic = scrubbedOutreachDiagnostic(decidedBy?.bounce?.diagnostic ?? decidedBy?.bounce?.status ?? null, enrollment.email)\n      await deps.suppressBouncedEmail({ email: enrollment.email, hostId: enrollment.hostId })\n      await addOutreachDoNotContact(firestore, {\n        orgId: context.orgId,\n        email: enrollment.email,\n        reason: 'hard_bounce',\n        source: 'runtime',\n        nowMs,\n        enrollmentId: enrollment.id,\n        sequenceId: enrollment.sequenceId,\n        detail: diagnostic,\n      })\n      event = { type: 'bounce', atMs: decidedBy?.atMs || nowMs, detail: diagnostic }\n      report.bounces += 1\n      break\n    }\n    case 'postpone': {\n      const sequence = await sequenceOf(context, enrollment.sequenceId)\n      postponedTo = postponeOutreachForAutoReply({\n        nextDueAtMs: enrollment.nextDueAtMs,\n        receivedAtMs: decidedBy?.atMs || nowMs,\n        timeZone: context.mailbox.timezone,\n        window: effectiveOutreachWindow(sequence?.settings.window, context.mailbox.window),\n        random: deps.random,\n      })\n      break\n    }\n    default:\n      break\n  }\n\n  const outcome = await applyOutreachEvent(firestore, {\n    orgId: context.orgId,\n    enrollmentId: enrollment.id,\n    event,\n    extra: (current) => {\n      const extra: Record<string, unknown> = {\n        syncedMessageIds: [...(current.syncedMessageIds ?? []), ...freshIds].slice(-ENROLLMENT_HANDLED_MAX),\n      }\n      const waiting = current.status === 'active' || current.status === 'paused'\n      if (postponedTo !== null && waiting && current.nextDueAtMs !== null && postponedTo > current.nextDueAtMs) {\n        extra['nextDueAtMs'] = postponedTo\n      }\n      return extra\n    },\n    nowMs,\n  })\n  if (postponedTo !== null && outcome.enrollment?.nextDueAtMs === postponedTo) report.postponed += 1\n  // The run's own view of the enrollment moves with it, so a second message\n  // of it in this run is judged against what this one did.\n  if (outcome.enrollment) Object.assign(enrollment, outcome.enrollment)\n}\n"],"names":["normalizeContactEmail","crmInboundExcerpt","emailAddressOf","outreachMessageIdHeader","readOutreachDeliveryReport","effectiveOutreachWindow","postponeOutreachForAutoReply","decideOutreachThread","outreachHeader","outreachThreadMessageFromGmail","mailboxRef","markOutreachMailboxReconnectRequired","OUTREACH_COLLECTIONS","addOutreachDoNotContact","outreachOrgCollection","readStoredOutreachEnrollment","readStoredOutreachMailbox","readStoredOutreachSequence","GmailTransportError","isReconnectRequired","applyOutreachEvent","recordOutreachOptOut","applyOutreachMailboxHealth","emptyOutreachHealthDelta","fileOutreachEmail","fileOutreachTask","outreachUnsubscribeMailbox","OUTREACH_SYNC_JOB_ID","OUTREACH_SYNC_LOOKBACK_MS","OUTREACH_SYNC_OVERLAP_MS","OUTREACH_SYNC_WATCH_MS","SEARCH_PAGES","MAILBOX_HANDLED_MAX","ENROLLMENT_HANDLED_MAX","FROM_CHUNK","runOutreachSyncJob","deps","context","firestore","report","mailboxes","threads","replies","optOuts","bounces","postponed","paused","all","collectionGroup","get","byOrg","Map","doc","docs","orgId","ref","parent","id","mailbox","data","status","set","now","deadlineMs","orgSnapshot","collection","org","exists","orgRefusal","syncMailbox","nowMs","error","mailboxId","errorCode","code","console","search","client","q","found","pageToken","page","list","listMessages","maxResults","includeSpamTrash","push","messages","filter","message","nextPageToken","input","opened","openMailbox","ok","reason","unsubscribe","email","selfAddresses","sendAs","sendAsOptions","map","option","Boolean","unsubscribeAddress","address","sequences","delta","watched","where","byThread","byAddress","enrollment","known","threadId","gmailThreadIds","lastSentAtMs","sinceMs","Math","max","Number","sync","throughMs","after","floor","handled","Set","handledMessageIds","newlyHandled","markHandled","has","add","fresh","stub","inbound","thread","getFullThread","applyMessages","getFullMessage","delivery","kind","failedAddresses","metadata","getMessage","metadataHeaders","from","headers","find","header","name","toLowerCase","value","includes","source","hostIds","hostId","detail","addresses","keys","start","length","chunk","slice","join","update","sequenceOf","sequenceId","snapshot","undefined","messageIdOf","scrubbedOutreachDiagnostic","diagnostic","pattern","RegExp","replace","fileInbound","messageId","contactId","direction","subject","to","inReplyTo","body","textBody","snippet","htmlBody","atMs","internalDateMs","byUid","outcome","decision","recipient","syncedMessageIds","threadSubject","freshIds","classifications","classification","decidedBy","decidingMessage","lastSentMessageId","messageIds","aboutRecipient","bounce","recipients","complaint","complaintAtMs","event","postponedTo","evidence","startsWith","dedupeKey","title","contactName","notes","dueAtMs","assigneeUid","connectedByUid","type","suppressBouncedEmail","enrollmentId","sequence","nextDueAtMs","receivedAtMs","timeZone","timezone","window","settings","random","extra","current","waiting","Object","assign"],"mappings":"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"}

package/src/lib/runtime/timeline.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @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 { PluginRecordTaskKind, PluginRecordWrite } from '@aglyn/aglyn/plugin-manager/plugin-record-timeline';
+import type { OutreachTaskKind } from '../model/outreach.types';
+import type { OutreachRuntimeDeps } from './runtime-deps';
+/**
+ * OUTREACH ON THE CONTACT'S TIMELINE (AGL-2981).
+ *
+ * Every email a sequence sends, every reply it reads, and every task it
+ * asks of the rep goes onto the contact's record through the core's
+ * record-timeline seam — whichever plugin keeps the workspace's records —
+ * never by writing that plugin's documents. An email is filed once per
+ * `Message-ID`, under the id the capture address would file a forwarded copy
+ * by; a task once per the key given here.
+ *
+ * The timeline is bookkeeping beside the act: an email has already left
+ * when it is filed, so a writer that refuses or fails is logged and the
+ * send stands. A workspace with no record system files nothing.
+ */
+/** The record system's word for a step's task kind. */
+export declare const OUTREACH_TASK_KIND_TO_RECORD: Record<OutreachTaskKind, PluginRecordTaskKind>;
+/** Files one email on a contact; never throws. */
+export declare function fileOutreachEmail(deps: Pick<OutreachRuntimeDeps, 'timeline'>, input: {
+    orgId: string;
+    hostId: string;
+    contactId: string;
+    direction: 'outbound' | 'inbound';
+    subject: string;
+    from: string;
+    to: string | null;
+    messageId: string;
+    inReplyTo?: string | null;
+    body: string;
+    atMs: number;
+    byUid: string;
+    byName?: string | null;
+}): Promise<PluginRecordWrite | null>;
+/**
+ * Files one task on a contact. Answers the record system's answer, `null`
+ * when the workspace keeps no records; a writer that THROWS is the caller's,
+ * which a step waits out rather than completing without its task.
+ */
+export declare function fileOutreachTask(deps: Pick<OutreachRuntimeDeps, 'timeline'>, input: {
+    orgId: string;
+    hostId: string;
+    contactId: string;
+    dedupeKey: string;
+    title: string;
+    notes?: string | null;
+    kind: PluginRecordTaskKind;
+    dueAtMs: number;
+    assigneeUid: string;
+}): Promise<PluginRecordWrite | null>;