@dawnlit/outlook-bridge 1.0.0

package/dist/mac/templates.js

@@ -0,0 +1,266 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readTemplateEmails = readTemplateEmails;
+exports.saveTemplateEmail = saveTemplateEmail;
+exports.editEmailTemplate = editEmailTemplate;
+// Template emails: ordinary mail items kept in a mailbox folder and reused as
+// reply bodies, plus the compose-window editor for one.
+//
+// Outlook for Mac serves a message's HTML through `content` when `has html` is
+// true — the same thing COM's HTMLBody returns — which is what makes templates
+// portable between the two platforms rather than a Windows-only feature.
+const run_1 = require("./run");
+const scripts_1 = require("./scripts");
+const outlookTemplateSections_1 = require("../outlookTemplateSections");
+const mail_1 = require("../mail");
+const errors_1 = require("../errors");
+/** How deep under the mailbox root a template folder is searched for. */
+const TEMPLATE_SEARCH_DEPTH = 3;
+/** The cap Windows applies to a template body; a Word-generated one is huge. */
+const MAX_TEMPLATE_HTML = 100000;
+/** How much plain text stands in for a body when one wasn't asked for. */
+const PREVIEW_CHARS = 200;
+/**
+ * Embedded (cid:) images live as attachments on the TEMPLATE item, so reusing
+ * the HTML on a new email shows a broken "linked image" placeholder, and
+ * rewriting the refs renders invisibly. Neither works, so the img tags go —
+ * template emails are text/HTML only.
+ */
+function stripEmbeddedImages(html) {
+    return html.replace(/<img[^>]*src="cid:[^"]*"[^>]*>/gi, '');
+}
+/**
+ * Read the template emails saved in a mailbox folder (default "Templates"),
+ * returning each item's full HTML body. When the folder doesn't exist, returns
+ * folderFound:false plus the mailbox's folder names instead of throwing, so the
+ * caller can ask the user whether to create it rather than fail.
+ *
+ * Bodies are read in a second pass, for the chosen templates only. That is not
+ * a micro-optimisation: a folder of Word-sized templates is megabytes, and
+ * pulling all of them through stdout on a call that wanted one is what overruns
+ * the buffer — the same reason the Windows reader filters before reading.
+ */
+async function readTemplateEmails(emailAccount, folderName = 'Templates', limit = 20, includeBody = true, subject = '') {
+    const cap = (0, mail_1.clamp)(limit, 1, 50);
+    const wanted = (subject || '').trim().toLowerCase();
+    // Pass 1 — find the folder and index it: three bulk reads, no bodies.
+    const indexScript = `${scripts_1.FIND_FOLDER_HANDLER}
+tell application "Microsoft Outlook"
+${(0, scripts_1.accountLookupSnippet)(emailAccount)}
+    set rootFolder to root folder of targetAcct
+end tell
+set theFolder to my findFolderByName(rootFolder, "${(0, run_1.asEscape)(folderName)}", ${TEMPLATE_SEARCH_DEPTH})
+tell application "Microsoft Outlook"
+    if theFolder is missing value then
+        set names to {}
+        repeat with f in (mail folders of rootFolder)
+            try
+                set end of names to (name of f) as string
+            end try
+        end repeat
+        return ${(0, run_1.asRow)(['"0"', 'my sanitizeList(names)'])}
+    end if
+    set idList to id of every message of theFolder
+    set subjList to subject of every message of theFolder
+    try
+        set modList to modification date of every message of theFolder
+    on error
+        set modList to {}
+    end try
+    set hasMods to ((count of modList) is (count of idList))
+    set out to ${(0, run_1.asRow)(['"1"', '(name of theFolder as string)'])}
+    repeat with i from 1 to (count of idList)
+        set modAt to ""
+        if hasMods then set modAt to my isoDate(item i of modList)
+        set out to out & ${(0, run_1.asRow)([
+        '(item i of idList as string)',
+        '(item i of subjList)',
+        'modAt',
+    ])}
+    end repeat
+    return out
+end tell`;
+    const records = (0, run_1.splitRecords)(await (0, run_1.runOsaScript)(indexScript, 120000));
+    const header = (0, run_1.splitFields)(records[0] || '');
+    if ((0, run_1.field)(header, 0) !== '1') {
+        return {
+            folderFound: false,
+            folderPath: '',
+            templates: [],
+            availableFolders: (0, run_1.splitList)((0, run_1.field)(header, 1)),
+        };
+    }
+    const folderPath = (0, scripts_1.macFolderPath)(emailAccount, (0, run_1.field)(header, 1) || folderName, []);
+    const indexed = records.slice(1).map(record => {
+        const parts = (0, run_1.splitFields)(record);
+        return {
+            id: (0, run_1.field)(parts, 0),
+            subject: (0, run_1.field)(parts, 1).trim(),
+            lastModified: (0, run_1.field)(parts, 2),
+        };
+    });
+    // Newest first, matching the Windows reader's Sort on LastModificationTime —
+    // and done before the cap, so "the newest 20" means that rather than an
+    // arbitrary 20. 'yyyy-MM-dd HH:mm' sorts lexicographically.
+    indexed.sort((a, b) => b.lastModified.localeCompare(a.lastModified));
+    const chosen = indexed
+        .filter(item => !wanted || item.subject.toLowerCase() === wanted)
+        .slice(0, cap);
+    if (chosen.length === 0) {
+        return { folderFound: true, folderPath, templates: [], availableFolders: [] };
+    }
+    // Pass 2 — the bodies, for the chosen templates only.
+    const bodyProperty = includeBody ? 'content' : 'plain text content';
+    const bodyScript = `tell application "Microsoft Outlook"
+    set out to ""
+    repeat with theId in {${chosen.map(item => item.id).join(', ')}}
+        set theMsg to missing value
+        try
+            set theMsg to message id theId
+        end try
+        if theMsg is not missing value then
+            set bodyText to ""
+            try
+                set bodyText to (${bodyProperty} of theMsg) as string
+            end try
+            set out to out & ${(0, run_1.asRow)(['(theId as string)', 'bodyText'])}
+        end if
+    end repeat
+    return out
+end tell`;
+    const bodies = new Map();
+    for (const record of (0, run_1.splitRecords)(await (0, run_1.runOsaScript)(bodyScript, 120000))) {
+        const parts = (0, run_1.splitFields)(record);
+        bodies.set((0, run_1.field)(parts, 0), (0, run_1.field)(parts, 1));
+    }
+    const templates = chosen.map(item => {
+        const body = bodies.get(item.id) || '';
+        const html = includeBody
+            ? stripEmbeddedImages(body).slice(0, MAX_TEMPLATE_HTML)
+            : '';
+        // With a body in hand the HTML is authoritative (it survives Word splitting
+        // a marker across tags); without one, scan the plain-text body, where a
+        // marker cannot have been split.
+        const markers = (0, outlookTemplateSections_1.findTemplateMarkers)(includeBody ? html : body);
+        return {
+            entryId: item.id,
+            subject: item.subject,
+            htmlBody: html,
+            bodyPreview: includeBody ? '' : body.trim().slice(0, PREVIEW_CHARS),
+            sections: markers.sections,
+            placeholders: markers.placeholders,
+            lastModified: item.lastModified,
+        };
+    });
+    return { folderFound: true, folderPath, templates, availableFolders: [] };
+}
+/**
+ * Save a new template email into a mailbox folder (default "Templates"),
+ * creating the folder at the mailbox root if it doesn't exist. The item is a
+ * plain unsent mail (subject + HTML body) that can be edited in Outlook.
+ * Never overwrites an existing item — it always adds a new one, so check with
+ * readTemplateEmails first and only call after the user has agreed to create it.
+ */
+async function saveTemplateEmail(emailAccount, subject, htmlBody, folderName = 'Templates') {
+    const script = `${scripts_1.FIND_FOLDER_HANDLER}
+tell application "Microsoft Outlook"
+${(0, scripts_1.accountLookupSnippet)(emailAccount)}
+    set rootFolder to root folder of targetAcct
+end tell
+set theFolder to my findFolderByName(rootFolder, "${(0, run_1.asEscape)(folderName)}", ${TEMPLATE_SEARCH_DEPTH})
+tell application "Microsoft Outlook"
+    set wasCreated to false
+    if theFolder is missing value then
+        set theFolder to (make new mail folder at rootFolder with properties {name:"${(0, run_1.asEscape)(folderName)}"})
+        set wasCreated to true
+    end if
+    set countBefore to count of messages of theFolder
+    set newMsg to make new outgoing message with properties {subject:"${(0, run_1.asEscape)(subject)}", content:"${(0, run_1.asEscape)(htmlBody)}"}
+    try
+        set account of newMsg to targetAcct
+    end try
+    -- 'move' reports success even where it silently does nothing, so a template
+    -- that was never filed must not be reported as saved.
+    move newMsg to theFolder
+    if (count of messages of theFolder) is not greater than countBefore then error "Outlook did not file the template in '" & (name of theFolder) & "'."
+    return ${(0, run_1.asRow)(['(name of theFolder as string)', '(wasCreated as string)'])}
+end tell`;
+    const parts = (0, run_1.summaryFields)(await (0, run_1.runOsaScript)(script, 120000));
+    return {
+        folderPath: (0, scripts_1.macFolderPath)(emailAccount, (0, run_1.field)(parts, 0) || folderName, []),
+        folderCreated: (0, run_1.boolField)(parts, 1),
+    };
+}
+/**
+ * Open an Outlook compose window pre-filled with `currentHtml`, wait for the
+ * user to close it, and return the HTML they saved.
+ *
+ * Deliberately unbounded: the run lasts as long as the person is editing. Give
+ * it an AbortSignal (`bridge.withOptions({ signal })`) if the caller needs a way
+ * to give up on them.
+ *
+ * The macOS half of the round trip differs from Windows in one visible way: an
+ * edited draft is filed by answering Outlook's own "save this message?" prompt
+ * on close, so the subject tells the user to save rather than to press a key.
+ */
+async function editEmailTemplate(label, currentHtml) {
+    const subject = `${label} - Save and close when done`;
+    const script = `tell application "Microsoft Outlook"
+    set editSubject to "${(0, run_1.asEscape)(subject)}"
+    set draftMsg to make new outgoing message with properties {subject:editSubject, content:"${(0, run_1.asEscape)(currentHtml)}"}
+    open draftMsg
+    activate
+end tell
+
+-- Poll until the compose window is gone. A draft window carries the message it
+-- is editing as its object, so the one we opened is identified by subject rather
+-- than by counting windows the user may also have open.
+set stillOpen to true
+repeat while stillOpen
+    delay 0.7
+    set stillOpen to false
+    tell application "Microsoft Outlook"
+        try
+            repeat with w in draft windows
+                try
+                    if ((subject of (object of w)) as string) is editSubject then
+                        set stillOpen to true
+                        exit repeat
+                    end if
+                end try
+            end repeat
+        end try
+    end tell
+end repeat
+
+tell application "Microsoft Outlook"
+    -- Prefer the saved draft: it reflects what the user chose to keep, and it
+    -- survives the window closing. Any leftover editor drafts are removed so
+    -- they don't pile up in the Drafts folder.
+    set savedHtml to ""
+    try
+        repeat with acctList in {exchange accounts, imap accounts, pop accounts}
+            repeat with a in acctList
+                try
+                    repeat with m in (messages of (drafts of a))
+                        try
+                            if ((subject of m) as string) is editSubject then
+                                if savedHtml is "" then set savedHtml to (content of m) as string
+                                delete m
+                            end if
+                        end try
+                    end repeat
+                end try
+            end repeat
+        end repeat
+    end try
+    return my sanitize(savedHtml)
+end tell`;
+    // 0 disables the timeout: this run is as long as the edit takes.
+    const saved = await (0, run_1.runOsaScript)(script, 0);
+    if (!saved) {
+        throw new errors_1.NotFoundError('template', 'No template saved. Did you save the draft before closing?');
+    }
+    return saved;
+}
+//# sourceMappingURL=templates.js.map

package/dist/mac/templates.js.map

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

package/dist/mail.d.ts

@@ -0,0 +1,72 @@
+import type { MailFolderRef } from './types';
+/**
+ * Clamp a caller's count to the range an operation actually accepts.
+ *
+ * These bounds ARE the argument contract — how far back a scan reaches, how many
+ * rows come back, how deep a folder walk goes — so they are stated here rather
+ * than once per platform, which is how the two came to disagree about what a
+ * `daysBack` of 0 means.
+ */
+export declare function clamp(value: number, min: number, max: number): number;
+/**
+ * The Outlook folders addressable by name rather than by walking from the Inbox,
+ * with their olDefaultFolders id. Sent Items is the one that earns this: "has this
+ * already gone out?" is otherwise unanswerable, and no amount of Inbox scanning
+ * substitutes for it.
+ *
+ * A well-known name always wins over a user folder of the same name — reach the
+ * latter by qualifying it (`Inbox\Drafts`).
+ */
+export declare const WELL_KNOWN_FOLDERS: Record<string, number>;
+/**
+ * Why `deleteOutlookEmails` refuses a message, worded once for both platforms.
+ *
+ * It reaches the caller verbatim in a per-email `reason`, so the two generated
+ * scripts must not word it independently — the same reasoning that put the
+ * attachment "not found" sentence in `shared/attachmentMatch.ts`. It also names
+ * the option a consumer of THIS package actually passes: the text used to say
+ * `allow_protected`, which is the tool-layer spelling and not a name this
+ * package exposes.
+ */
+export declare const PROTECTED_MAIL_REASON = "received or sent mail (Inbox/Sent Items or a subfolder) - pass allowProtected to override";
+/**
+ * Roots whose items are OUTGOING mail.
+ *
+ * Outgoing mail carries a sent timestamp where received mail carries a received
+ * one, and both platforms have to pick the same folders out on that basis —
+ * which is why it lives beside `WELL_KNOWN_FOLDERS` rather than as raw
+ * `olDefaultFolders` ids compared inline in each reader.
+ */
+export declare function isOutgoingRoot(rootId: number): boolean;
+/**
+ * Resolve a caller's folder string to a well-known root plus the segments below it.
+ *
+ * Accepts every shape a user has to hand: a bare name ("Invoices"), a relative
+ * path ("Invoices\\Paid"), a well-known folder ("Sent Items"), a path under one
+ * ("Deleted Items\\2026"), and the full FolderPath listInboxFolders prints
+ * ("\\\\team@x.com\\Inbox\\Invoices").
+ *
+ * An unrecognized first segment means Inbox-relative, which is what keeps a bare
+ * subfolder name working unchanged.
+ */
+export declare function mailFolderRef(folder: string): MailFolderRef;
+/**
+ * Split a plain-text reply into the sender's own text and the quoted thread
+ * below it.
+ *
+ * This matters more than it looks: the quoted original of a reply carries the
+ * text of the message it answers. Handing a caller one blob invites a figure
+ * from the outgoing message to be read back as the sender's answer, which is a
+ * worse failure than the truncation this exists to fix.
+ *
+ * Scans for the earliest of the separators Outlook and the common webmail
+ * clients emit. If the split would leave no new text at all — a bottom-posted
+ * reply, or a body that opens on a quote — it is abandoned and everything is
+ * returned as `body`, since dropping the sender's actual words is the one
+ * outcome worth avoiding.
+ */
+export declare function splitQuotedOriginal(text: string): {
+    body: string;
+    quoted: string;
+    separator: string;
+};

package/dist/mail.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROTECTED_MAIL_REASON = exports.WELL_KNOWN_FOLDERS = void 0;
+exports.clamp = clamp;
+exports.isOutgoingRoot = isOutgoingRoot;
+exports.mailFolderRef = mailFolderRef;
+exports.splitQuotedOriginal = splitQuotedOriginal;
+/**
+ * Clamp a caller's count to the range an operation actually accepts.
+ *
+ * These bounds ARE the argument contract — how far back a scan reaches, how many
+ * rows come back, how deep a folder walk goes — so they are stated here rather
+ * than once per platform, which is how the two came to disagree about what a
+ * `daysBack` of 0 means.
+ */
+function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, Math.floor(value)));
+}
+/**
+ * The Outlook folders addressable by name rather than by walking from the Inbox,
+ * with their olDefaultFolders id. Sent Items is the one that earns this: "has this
+ * already gone out?" is otherwise unanswerable, and no amount of Inbox scanning
+ * substitutes for it.
+ *
+ * A well-known name always wins over a user folder of the same name — reach the
+ * latter by qualifying it (`Inbox\Drafts`).
+ */
+exports.WELL_KNOWN_FOLDERS = {
+    inbox: 6,
+    'sent items': 5,
+    sent: 5,
+    'sent mail': 5,
+    drafts: 16,
+    'deleted items': 3,
+    deleted: 3,
+    trash: 3,
+    'junk email': 23,
+    junk: 23,
+    outbox: 4,
+};
+/**
+ * Why `deleteOutlookEmails` refuses a message, worded once for both platforms.
+ *
+ * It reaches the caller verbatim in a per-email `reason`, so the two generated
+ * scripts must not word it independently — the same reasoning that put the
+ * attachment "not found" sentence in `shared/attachmentMatch.ts`. It also names
+ * the option a consumer of THIS package actually passes: the text used to say
+ * `allow_protected`, which is the tool-layer spelling and not a name this
+ * package exposes.
+ */
+exports.PROTECTED_MAIL_REASON = 'received or sent mail (Inbox/Sent Items or a subfolder) - pass allowProtected to override';
+/**
+ * Roots whose items are OUTGOING mail.
+ *
+ * Outgoing mail carries a sent timestamp where received mail carries a received
+ * one, and both platforms have to pick the same folders out on that basis —
+ * which is why it lives beside `WELL_KNOWN_FOLDERS` rather than as raw
+ * `olDefaultFolders` ids compared inline in each reader.
+ */
+function isOutgoingRoot(rootId) {
+    return rootId === exports.WELL_KNOWN_FOLDERS['sent items']
+        || rootId === exports.WELL_KNOWN_FOLDERS.outbox
+        || rootId === exports.WELL_KNOWN_FOLDERS.drafts;
+}
+/**
+ * Resolve a caller's folder string to a well-known root plus the segments below it.
+ *
+ * Accepts every shape a user has to hand: a bare name ("Invoices"), a relative
+ * path ("Invoices\\Paid"), a well-known folder ("Sent Items"), a path under one
+ * ("Deleted Items\\2026"), and the full FolderPath listInboxFolders prints
+ * ("\\\\team@x.com\\Inbox\\Invoices").
+ *
+ * An unrecognized first segment means Inbox-relative, which is what keeps a bare
+ * subfolder name working unchanged.
+ */
+function mailFolderRef(folder) {
+    const rest = folder.trim().replace(/^\\\\[^\\/]+[\\/]/, '');
+    const segments = rest.split(/[\\/]+/).map(s => s.trim()).filter(Boolean);
+    if (segments.length > 0) {
+        const head = segments[0].toLowerCase();
+        if (Object.prototype.hasOwnProperty.call(exports.WELL_KNOWN_FOLDERS, head)) {
+            return { rootId: exports.WELL_KNOWN_FOLDERS[head], rootLabel: segments[0], segments: segments.slice(1) };
+        }
+    }
+    return { rootId: 6, rootLabel: 'Inbox', segments };
+}
+/**
+ * Split a plain-text reply into the sender's own text and the quoted thread
+ * below it.
+ *
+ * This matters more than it looks: the quoted original of a reply carries the
+ * text of the message it answers. Handing a caller one blob invites a figure
+ * from the outgoing message to be read back as the sender's answer, which is a
+ * worse failure than the truncation this exists to fix.
+ *
+ * Scans for the earliest of the separators Outlook and the common webmail
+ * clients emit. If the split would leave no new text at all — a bottom-posted
+ * reply, or a body that opens on a quote — it is abandoned and everything is
+ * returned as `body`, since dropping the sender's actual words is the one
+ * outcome worth avoiding.
+ */
+function splitQuotedOriginal(text) {
+    const lines = text.split(/\r?\n/);
+    const whole = { body: text, quoted: '', separator: '' };
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+        let separator = '';
+        if (/^-{2,}\s*original message\s*-{2,}$/i.test(line))
+            separator = '-----Original Message-----';
+        // Outlook's HTML thread rule, which sits directly above the From:/Sent: block.
+        else if (/^_{10,}$/.test(line))
+            separator = 'Outlook thread rule';
+        // "On Tue, Jul 21, 2026 at 9:14 AM John Doe <j@x.com> wrote:"
+        else if (/^on\b.{5,300}\bwrote:$/i.test(line))
+            separator = 'On … wrote:';
+        else if (/^>/.test(lines[i]))
+            separator = '> quoted lines';
+        // A bare header block: "From: …" followed by another header line.
+        else if (/^from:\s*\S/i.test(line) && /^(sent|date|to|subject|cc):/i.test((lines[i + 1] || '').trim())) {
+            separator = 'From:/Sent: header block';
+        }
+        if (!separator)
+            continue;
+        const body = lines.slice(0, i).join('\n').trimEnd();
+        if (!body.trim())
+            return whole;
+        return { body, quoted: lines.slice(i).join('\n').trim(), separator };
+    }
+    return whole;
+}
+//# sourceMappingURL=mail.js.map

package/dist/mail.js.map

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

package/dist/outlookTemplateSections.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Section + placeholder composition for the operator's Outlook template emails.
+ *
+ * A template email is a normal saved mail the operator edits in Outlook, so the
+ * greeting, closing and signature are theirs. Where one template serves several
+ * reply types, the variants live inside it between markers:
+ *
+ *     Hello,
+ *     [[QUOTE]]     Thank you for your quote...        [[/QUOTE]]
+ *     [[NOQUOTE]]   Thank you for letting us know...   [[/NOQUOTE]]
+ *     [[CLARIFY]]   {{QUESTIONS}}                      [[/CLARIFY]]
+ *     Best regards, <signature>
+ *
+ * Composing keeps the requested section, drops the others, and substitutes any
+ * {{PLACEHOLDER}} — so the shared wording is written once and the caller only
+ * names a section instead of carrying (and editing) 40-50k of Word HTML.
+ *
+ * Everything here works on the raw HTML string rather than a parsed tree: Word's
+ * markup carries conditional comments and namespaced tags that a round-trip
+ * through a parser would rewrite, and the reply body must stay byte-identical to
+ * what the operator wrote.
+ */
+export interface TemplateMarkers {
+    /** Section names with both an opening and a closing marker, in document order. */
+    sections: string[];
+    /** `{{NAME}}` placeholders found anywhere in the template. */
+    placeholders: string[];
+}
+/** Find the markers in a template body (HTML or the plain-text body Outlook derives). */
+export declare function findTemplateMarkers(body: string): TemplateMarkers;
+/** Replace every occurrence of `token` with `value`, which is never rescanned. */
+export declare function replaceToken(html: string, token: string, value: string): string;
+/**
+ * Remove `token` along with the line it sits on — the table row or paragraph,
+ * label included. For an optional detail this is the difference between the email
+ * not mentioning it at all and it carrying a heading with nothing under it.
+ * Falls back to deleting just the token when it isn't inside a line element.
+ */
+export declare function removeTokenLine(html: string, token: string): string;
+/** Which of `tokens` the template actually uses — what the caller has to supply. */
+export declare function findTokens(html: string, tokens: string[]): string[];
+/**
+ * `{Token}`-shaped text still in a filled-in body: a placeholder misspelled in
+ * Outlook, or one the app has no field for. Reads the visible text only, so the
+ * braces in a Word <style> block are not mistaken for placeholders.
+ */
+export declare function findUnfilledTokens(html: string): string[];
+export interface ComposeOptions {
+    /** Section to keep; the other sections are dropped along with their markers. */
+    section?: string;
+    /** `{{NAME}}` → HTML to substitute. Names are matched case-insensitively. */
+    placeholders?: Record<string, string>;
+    /** Template name, for error messages. */
+    label?: string;
+}
+/**
+ * Resolve a template body down to the one reply that goes out: keep `section`,
+ * drop the rest, fill the placeholders. Throws rather than guessing — a template
+ * the operator edited into an unusable state must stop the run, not quietly send
+ * a reply with `[[QUOTE]]` or an empty question list in it.
+ */
+export declare function composeTemplateBody(html: string, options?: ComposeOptions): string;