@framers/agentos-ext-gmail-source 0.5.2 → 0.6.1

package/dist/index.js

@@ -13,7 +13,7 @@ export { GmailOAuthFlow } from './GmailOAuthFlow.js';
 export { GMAIL_READONLY_SCOPE, GmailOAuthFault, } from './types.js';
 export { GmailTextFault, sanitizeMailText, sanitizeMailMetadata, sanitizeMailHeaders, } from './mailSanitize.js';
 export { messageText } from './messageText.js';
-export { GmailThreadMapper } from './mapThread.js';
+export { GmailThreadMapper, GMAIL_CATEGORIES } from './mapThread.js';
 export { GmailMappingFault } from './mime.js';
 export { GmailApi, GmailApiFault, } from './gmail.js';
 export { classifyGmailHttp, gmailOAuthFault } from './retry.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EACL,oBAAoB,EAAE,eAAe,GAEtC,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,cAAc,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,GAG5E,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAyB,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAA8B,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAA2B,MAAM,WAAW,CAAC;AACvE,OAAO,EACL,QAAQ,EAAE,aAAa,GAExB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAA6B,MAAM,YAAY,CAAC;AAC3F,OAAO,EACL,oBAAoB,EAAE,mBAAmB,GAE1C,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,kBAAkB,EAAE,iBAAiB,GAEtC,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EACL,oBAAoB,EAAE,eAAe,GAEtC,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,cAAc,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,GAG5E,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAyB,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAkD,MAAM,gBAAgB,CAAC;AACrH,OAAO,EAAE,iBAAiB,EAA2B,MAAM,WAAW,CAAC;AACvE,OAAO,EACL,QAAQ,EAAE,aAAa,GAExB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAA6B,MAAM,YAAY,CAAC;AAC3F,OAAO,EACL,oBAAoB,EAAE,mBAAmB,GAE1C,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,kBAAkB,EAAE,iBAAiB,GAEtC,MAAM,WAAW,CAAC"}

package/dist/mailSanitize.d.ts

@@ -2,8 +2,8 @@
  * @fileoverview Deterministic pre-storage sanitization of mail text: once percent and character references are decoded
  * and padding collapsed, address tokens, credential assignments, known credential shapes, private-key blocks and long
  * mixed tokens are replaced with fixed marks, and a final gate suppresses any line that still carries a credential
- * cue. Every count is a number; no matched value, offset or reverse mapping is kept, nothing is logged and no model or
- * network is called.
+ * cue, with the value after a line that introduces one. Every mark keeps its line's quote markers. Every count is a
+ * number; no matched value, offset or reverse mapping is kept, nothing is logged and no model or network is called.
  * @module agentos-ext-gmail-source/mailSanitize
  */
 /**
@@ -69,9 +69,18 @@ export declare class GmailTextFault extends Error {
  * than ASCII spaces and tabs, such as the no-break spaces and zero-width non-joiners mail templates repeat after a
  * preheader: it becomes one space, or nothing when it holds no space at all, so zero-width characters between letters
  * join them, and nothing when it holds an invisible character and ends a line. A run of ASCII spaces and tabs alone
- * stays as written. An assignment with an empty value, a block scalar
- * or an unclosed quote also suppresses the rest of the text. A replaced assignment and a line the final gate
- * suppresses keep their quote markers (`>`). The complete input is checked before the output cap clips the result.
+ * stays as written. An assignment with an empty value, a block scalar or an unclosed quote also suppresses the rest of
+ * the text. A line the final gate suppresses that introduces a value, ending with `:` or `=`, or with `is`, `are`,
+ * `was`, `were`, `be`, `below`, `follows` or `set`, `reset`, `changed` or `updated` followed by `to` (`below` and
+ * `follows` also with a full stop), also suppresses the value: the next line that holds text at the introduction's
+ * quote depth, past any blank lines, and the lines after it in its paragraph, which a blank line or a change of quote
+ * depth ends. One that ends with its cue, or with its cue and a full stop, as a label above its value does, also
+ * suppresses the next line that holds text when that line is one word at the label's quote depth. A line that holds
+ * text at another depth ends either and stays. A gated line that ends any other way, such as `Reset your password from
+ * Settings.` or `Your password was changed.`, leaves the next line alone. Every mark keeps its line's quote markers
+ * (`>`), each run of spaces and tabs among them shortened to one character, so trimming still reads removed history
+ * as quoted and a mark holds none of the padding of the line it replaces. The complete input is checked before the
+ * output cap clips the result.
  *
  * @param input Decoded text: a body or one display field.
  * @param policy The input, line and output bounds.
@@ -80,7 +89,20 @@ export declare class GmailTextFault extends Error {
  */
 export declare function sanitizeMailText(input: string, policy: GmailTextPolicy): GmailSanitizedText;
 /**
- * Use for every filename, label name and display field, after MIME decoding. Applies the same rules as
+ * Whether decoded text holds nothing but whitespace once its percent and character references are decoded, its
+ * padding collapsed and its format and control characters removed, the steps `sanitizeMailText` takes before any
+ * other. A MIME reader uses it to pass over an alternative whose text would sanitize away, such as a plain part of
+ * ` ` and `​` beside the HTML that holds the message.
+ *
+ * @param input Decoded text: one MIME part's body.
+ * @param maxInputCharacters The sanitizer's input cap. Text above it, before or after decoding, is not blank: the
+ * sanitizer refuses it rather than emptying it.
+ * @returns True when nothing but whitespace is left.
+ */
+export declare function blankMailText(input: string, maxInputCharacters: number): boolean;
+/**
+ * Use for every filename, label name and display field: a header value or filename after MIME decoding, and a label
+ * name as the labels response gives it, since that JSON text is never MIME encoded. Applies the same rules as
  * `sanitizeMailText` to the complete value, folds each whitespace run to one space and trims, then applies the
  * output cap.
  *

package/dist/mailSanitize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mailSanitize.d.ts","sourceRoot":"","sources":["../src/mailSanitize.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,sHAAsH;IACtH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,+FAA+F;IAC/F,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,iGAAiG;IACjG,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AACD,iHAAiH;AACjH,MAAM,WAAW,kBAAkB;IACjC,wFAAwF;IACxF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,6GAA6G;IAC7G,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,iEAAiE;IACjE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AACD,6FAA6F;AAC7F,MAAM,WAAW,gBAAgB;IAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AACnF,2FAA2F;AAC3F,MAAM,WAAW,qBAAqB;IACpC,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AACD,sGAAsG;AACtG,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG,iBAAiB,CAAC;AACnE,yGAAyG;AACzG,qBAAa,cAAe,SAAQ,KAAK;IAE3B,QAAQ,CAAC,MAAM,EAAE,gBAAgB;IAD7C,sDAAsD;gBACjC,MAAM,EAAE,gBAAgB;CAG9C;AAgFD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,kBAAkB,CA2C3F;AACD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,kBAAkB,CAM/F;AACD;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,EAAE,MAAM,EAAE,eAAe,GAAG,qBAAqB,CAsBxH"}
+{"version":3,"file":"mailSanitize.d.ts","sourceRoot":"","sources":["../src/mailSanitize.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,sHAAsH;IACtH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,+FAA+F;IAC/F,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,iGAAiG;IACjG,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AACD,iHAAiH;AACjH,MAAM,WAAW,kBAAkB;IACjC,wFAAwF;IACxF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,6GAA6G;IAC7G,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,iEAAiE;IACjE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AACD,6FAA6F;AAC7F,MAAM,WAAW,gBAAgB;IAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AACnF,2FAA2F;AAC3F,MAAM,WAAW,qBAAqB;IACpC,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AACD,sGAAsG;AACtG,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG,iBAAiB,CAAC;AACnE,yGAAyG;AACzG,qBAAa,cAAe,SAAQ,KAAK;IAE3B,QAAQ,CAAC,MAAM,EAAE,gBAAgB;IAD7C,sDAAsD;gBACjC,MAAM,EAAE,gBAAgB;CAG9C;AAoGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,kBAAkB,CAkE3F;AACD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAGhF;AACD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,kBAAkB,CAM/F;AACD;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,EAAE,MAAM,EAAE,eAAe,GAAG,qBAAqB,CAsBxH"}

package/dist/mailSanitize.js

@@ -2,8 +2,8 @@
  * @fileoverview Deterministic pre-storage sanitization of mail text: once percent and character references are decoded
  * and padding collapsed, address tokens, credential assignments, known credential shapes, private-key blocks and long
  * mixed tokens are replaced with fixed marks, and a final gate suppresses any line that still carries a credential
- * cue. Every count is a number; no matched value, offset or reverse mapping is kept, nothing is logged and no model or
- * network is called.
+ * cue, with the value after a line that introduces one. Every mark keeps its line's quote markers. Every count is a
+ * number; no matched value, offset or reverse mapping is kept, nothing is logged and no model or network is called.
  * @module agentos-ext-gmail-source/mailSanitize
  */
 import { collapsePadding, decodeCharacterReferences, holdsNamedReference } from './characters.js';
@@ -41,6 +41,15 @@ const assignment = /(?:(?<![a-z0-9])(?:pass|pwd|pw|authorization|cookie|set-cook
 // plural) and the compound cues count at the end of any identifier (`DB_PASSWORD`, `rsaPrivateKey`); `bearer` and the
 // SSH cues need a character other than a letter or digit before them. No cue continues into a letter or digit.
 const residual = /(?:(?<![a-z0-9])(?:bearer|ssh-(?:rsa|ed25519)|sshpass)|pass(?:word|wd|phrase)s?|api[ _-]?(?:key|token)|access[ _-]?token|refresh[ _-]?token|client[ _-]?secret|private[ _-]?key)(?![a-z0-9])/i;
+// How a line the final gate suppresses ends when it introduces a value on the lines after it ("Your password is:",
+// "Your new password is", "changed to", "is below."): with `:` or `=`, or with one of these words after its cue, `below`
+// and `follows` also with a full stop. A line ending any other way, such as "was changed.", introduces nothing.
+const introduction = /(?:[:=]|(?<![a-z0-9])(?:is|are|was|were|be|(?:below|follows)\.?|(?:set|reset|changed|updated)[ \t]+to))$/i;
+// A gated line that ends with its cue, or with its cue and a full stop, as a label above its value does ("Temporary
+// password", "Here is your new password.").
+const labelled = new RegExp(`(?:${residual.source})\\.?$`, 'i');
+// A line's quote prefix: its `>` markers and the spaces and tabs around them.
+const quotePrefix = /^[ \t]*(?:>[ \t]*)+/;
 const beginKey = /-----BEGIN [A-Z0-9 ]*PRIVATE KEY-----/;
 const endKey = /-----END [A-Z0-9 ]*PRIVATE KEY-----/;
 // Encoded bytes still present after the bounded decoding passes. A named reference the decoder knows, still present
@@ -83,6 +92,19 @@ function canonical(input, limit) {
     }
     return text;
 }
+// The prefix a mark keeps: the quote's `>` markers, each run of spaces and tabs among them shortened to its first
+// character, so a mark keeps its line's depth and none of the padding of the line it replaces.
+function markPrefix(quote) {
+    return quote.replace(/[ \t]+/g, (run) => run.charAt(0));
+}
+// The number of `>` markers in a quote prefix.
+function quoteDepth(quote) {
+    let depth = 0;
+    for (let i = 0; i < quote.length; i++)
+        if (quote.charCodeAt(i) === 0x3e)
+            depth++;
+    return depth;
+}
 // Clips without leaving the high half of a surrogate pair at the end.
 function clipped(text, maximum) {
     let end = Math.min(text.length, maximum);
@@ -120,9 +142,18 @@ function containsAuthenticatedUrl(line) {
  * than ASCII spaces and tabs, such as the no-break spaces and zero-width non-joiners mail templates repeat after a
  * preheader: it becomes one space, or nothing when it holds no space at all, so zero-width characters between letters
  * join them, and nothing when it holds an invisible character and ends a line. A run of ASCII spaces and tabs alone
- * stays as written. An assignment with an empty value, a block scalar
- * or an unclosed quote also suppresses the rest of the text. A replaced assignment and a line the final gate
- * suppresses keep their quote markers (`>`). The complete input is checked before the output cap clips the result.
+ * stays as written. An assignment with an empty value, a block scalar or an unclosed quote also suppresses the rest of
+ * the text. A line the final gate suppresses that introduces a value, ending with `:` or `=`, or with `is`, `are`,
+ * `was`, `were`, `be`, `below`, `follows` or `set`, `reset`, `changed` or `updated` followed by `to` (`below` and
+ * `follows` also with a full stop), also suppresses the value: the next line that holds text at the introduction's
+ * quote depth, past any blank lines, and the lines after it in its paragraph, which a blank line or a change of quote
+ * depth ends. One that ends with its cue, or with its cue and a full stop, as a label above its value does, also
+ * suppresses the next line that holds text when that line is one word at the label's quote depth. A line that holds
+ * text at another depth ends either and stays. A gated line that ends any other way, such as `Reset your password from
+ * Settings.` or `Your password was changed.`, leaves the next line alone. Every mark keeps its line's quote markers
+ * (`>`), each run of spaces and tabs among them shortened to one character, so trimming still reads removed history
+ * as quoted and a mark holds none of the padding of the line it replaces. The complete input is checked before the
+ * output cap clips the result.
  *
  * @param input Decoded text: a body or one display field.
  * @param policy The input, line and output bounds.
@@ -137,34 +168,60 @@ export function sanitizeMailText(input, policy) {
     let suppressedLines = 0;
     let insideKey = false;
     let credentialTail = false;
+    // After a gated line that introduces a value: `value` until the next line that holds text at the introduction's quote
+    // depth, which is the value, then `paragraph` while the lines after it hold text at that depth. After a gated line
+    // that ends with its cue: `label` until the next line that holds text, which is its value when it is one word at the
+    // label's depth. Blank lines before the value are passed over; a line that holds text at another depth ends either.
+    let introduced = 'none';
+    let valueDepth = 0;
     const lines = [];
     for (const raw of normalized.split('\n')) {
+        // Read before any branch: every mark keeps the line's quote markers, so removal cannot turn quoted history into
+        // fresh text and trimming still finds it.
+        const quote = raw.match(quotePrefix)?.[0] ?? '';
+        const marked = markPrefix(quote);
+        let line = raw.slice(quote.length);
+        let withinValue = false;
+        if (introduced !== 'none') {
+            const held = line.trim();
+            if (held === '') {
+                if (introduced === 'paragraph')
+                    introduced = 'none';
+            }
+            else if (quoteDepth(quote) !== valueDepth)
+                introduced = 'none';
+            else if (introduced === 'label') {
+                introduced = 'none';
+                withinValue = !/\s/.test(held);
+            }
+            else {
+                introduced = 'paragraph';
+                withinValue = true;
+            }
+        }
         if (credentialTail) {
             suppressedLines++;
-            lines.push(lineMark);
+            lines.push(marked + lineMark);
             continue;
         }
         if (insideKey || beginKey.test(raw)) {
             if (!insideKey)
                 secretRedactions++;
             insideKey = !endKey.test(raw);
-            lines.push(secretMark);
+            lines.push(marked + secretMark);
             continue;
         }
         if (raw.length > policy.maxLineCharacters || unresolved.test(raw) || holdsNamedReference(raw)) {
             suppressedLines++;
-            lines.push(lineMark);
+            lines.push(marked + lineMark);
             continue;
         }
-        // Preserve quote depth so removal cannot turn quoted history into fresh text.
-        const quote = raw.match(/^([ \t]*(?:>[ \t]*)+)/)?.[0] ?? '';
-        let line = raw.slice(quote.length);
         if (assignment.test(line) || containsAuthenticatedUrl(line) || /\bsshpass\s+-p\b/i.test(line)) {
             const found = assignment.exec(line);
             const value = found ? line.slice(found.index + found[0].length).trim() : null;
             credentialTail = value !== null && (value === '' || /^[|>][+-]?$/.test(value) || ((value[0] === '"' || value[0] === "'") && value.lastIndexOf(value[0]) === 0));
             secretRedactions++;
-            lines.push(quote + secretMark);
+            lines.push(marked + secretMark);
             continue;
         }
         for (const source of shapeSources) {
@@ -182,8 +239,25 @@ export function sanitizeMailText(input, policy) {
             return token; addressRedactions++; return addressMark; });
         const inspected = line.split(secretMark).join('').split(lineMark).join('');
         if (residual.test(inspected) || endKey.test(inspected)) {
+            // "Your password is:" names no assignment, so the value it introduces is on a later line. A label inside a value's
+            // paragraph leaves the paragraph's removal in place; one that is the word a label above it took ("Password" under
+            // "Your Wi-Fi password") is a label of its own.
+            const end = line.trimEnd();
+            if (introduction.test(end)) {
+                introduced = 'value';
+                valueDepth = quoteDepth(quote);
+            }
+            else if (introduced !== 'paragraph' && labelled.test(end)) {
+                introduced = 'label';
+                valueDepth = quoteDepth(quote);
+            }
             suppressedLines++;
-            lines.push(quote + lineMark);
+            lines.push(marked + lineMark);
+            continue;
+        }
+        if (withinValue) {
+            suppressedLines++;
+            lines.push(marked + lineMark);
             continue;
         }
         lines.push(quote + line);
@@ -193,7 +267,29 @@ export function sanitizeMailText(input, policy) {
     return { text, addressRedactions, secretRedactions, suppressedLines, truncated: text.length < complete.length };
 }
 /**
- * Use for every filename, label name and display field, after MIME decoding. Applies the same rules as
+ * Whether decoded text holds nothing but whitespace once its percent and character references are decoded, its
+ * padding collapsed and its format and control characters removed, the steps `sanitizeMailText` takes before any
+ * other. A MIME reader uses it to pass over an alternative whose text would sanitize away, such as a plain part of
+ * `&nbsp;` and `&#8203;` beside the HTML that holds the message.
+ *
+ * @param input Decoded text: one MIME part's body.
+ * @param maxInputCharacters The sanitizer's input cap. Text above it, before or after decoding, is not blank: the
+ * sanitizer refuses it rather than emptying it.
+ * @returns True when nothing but whitespace is left.
+ */
+export function blankMailText(input, maxInputCharacters) {
+    try {
+        return canonical(input, maxInputCharacters).trim().length === 0;
+    }
+    catch (error) {
+        if (error instanceof GmailTextFault)
+            return false;
+        throw error;
+    }
+}
+/**
+ * Use for every filename, label name and display field: a header value or filename after MIME decoding, and a label
+ * name as the labels response gives it, since that JSON text is never MIME encoded. Applies the same rules as
  * `sanitizeMailText` to the complete value, folds each whitespace run to one space and trims, then applies the
  * output cap.
  *

package/dist/mailSanitize.js.map

@@ -1 +1 @@
-{"version":3,"file":"mailSanitize.js","sourceRoot":"","sources":["../src/mailSanitize.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AA4ClG,yGAAyG;AACzG,MAAM,OAAO,cAAe,SAAQ,KAAK;IAElB;IADrB,sDAAsD;IACtD,YAAqB,MAAwB;QAC3C,KAAK,CAAC,cAAc,MAAM,EAAE,CAAC,CAAC;QADX,WAAM,GAAN,MAAM,CAAkB;QACZ,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC9D,CAAC;CACF;AAED,MAAM,WAAW,GAAG,mBAAmB,CAAC;AACxC,MAAM,UAAU,GAAG,kBAAkB,CAAC;AACtC,MAAM,QAAQ,GAAG,mCAAmC,CAAC;AACrD,oHAAoH;AACpH,oHAAoH;AACpH,0GAA0G;AAC1G,MAAM,YAAY,GAAsB;IACtC,MAAM,CAAC,GAAG,CAAA,6HAA6H;IACvI,MAAM,CAAC,GAAG,CAAA,+BAA+B;IACzC,MAAM,CAAC,GAAG,CAAA,qBAAqB;IAC/B,MAAM,CAAC,GAAG,CAAA,0BAA0B;IACpC,MAAM,CAAC,GAAG,CAAA,wCAAwC;IAClD,MAAM,CAAC,GAAG,CAAA,wCAAwC;IAClD,MAAM,CAAC,GAAG,CAAA,gFAAgF;CAC3F,CAAC;AACF,oHAAoH;AACpH,oHAAoH;AACpH,uHAAuH;AACvH,4EAA4E;AAC5E,MAAM,UAAU,GAAG,8UAA8U,CAAC;AAClW,mHAAmH;AACnH,sHAAsH;AACtH,+GAA+G;AAC/G,MAAM,QAAQ,GAAG,+LAA+L,CAAC;AACjN,MAAM,QAAQ,GAAG,uCAAuC,CAAC;AACzD,MAAM,MAAM,GAAG,qCAAqC,CAAC;AACrD,oHAAoH;AACpH,iGAAiG;AACjG,MAAM,UAAU,GAAG,yCAAyC,CAAC;AAE7D,SAAS,QAAQ,CAAC,MAAuB;IACvC,KAAK,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACtG,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;YAAE,MAAM,IAAI,cAAc,CAAC,eAAe,CAAC,CAAC;IAC3F,CAAC;IACD,IAAI,MAAM,CAAC,kBAAkB,GAAG,SAAS,IAAI,MAAM,CAAC,iBAAiB,GAAG,MAAM;WACzE,MAAM,CAAC,mBAAmB,GAAG,MAAM,CAAC,kBAAkB;QAAE,MAAM,IAAI,cAAc,CAAC,eAAe,CAAC,CAAC;AACzG,CAAC;AACD,oHAAoH;AACpH,kHAAkH;AAClH,mHAAmH;AACnH,sHAAsH;AACtH,qBAAqB;AACrB,SAAS,SAAS,CAAC,KAAa,EAAE,KAAa;IAC7C,IAAI,KAAK,CAAC,MAAM,GAAG,KAAK;QAAE,MAAM,IAAI,cAAc,CAAC,iBAAiB,CAAC,CAAC;IACtE,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC;QACtB,IAAI,GAAG,yBAAyB,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAC,GAAG,EAAE,EAAE;YAC3E,IAAI,CAAC;gBAAC,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,OAAO,GAAG,CAAC;YAAC,CAAC;QAC/D,CAAC,CAAC,CAAC,CAAC;QACJ,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,IAAI,CAAC;aACpG,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,wCAAwC,EAAE,EAAE,CAAC,CAAC;QACzF,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK;YAAE,MAAM,IAAI,cAAc,CAAC,iBAAiB,CAAC,CAAC;QACrE,IAAI,IAAI,KAAK,QAAQ;YAAE,MAAM;IAC/B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AACD,sEAAsE;AACtE,SAAS,OAAO,CAAC,IAAY,EAAE,OAAe;IAC5C,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAE,CAAC;WACrE,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAE,CAAC;QAAE,GAAG,EAAE,CAAC;IAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC5B,CAAC;AACD,qHAAqH;AACrH,sHAAsH;AACtH,wBAAwB;AACxB,SAAS,wBAAwB,CAAC,IAAY;IAC5C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,2CAA2C,CAAC,EAAE,CAAC;QAC/E,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9B,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ;gBAAE,OAAO,IAAI,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AACD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,MAAuB;IACrE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjB,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAC/D,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAAC,IAAI,gBAAgB,GAAG,CAAC,CAAC;IAAC,IAAI,eAAe,GAAG,CAAC,CAAC;IAC7E,IAAI,SAAS,GAAG,KAAK,CAAC;IAAC,IAAI,cAAc,GAAG,KAAK,CAAC;IAClD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAAC,IAAI,cAAc,EAAE,CAAC;YAAC,eAAe,EAAE,CAAC;YAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAAC,SAAS;QAAC,CAAC;QACpH,IAAI,SAAS,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,SAAS;gBAAE,gBAAgB,EAAE,CAAC;YACnC,SAAS,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAAC,SAAS;QACnC,CAAC;QACD,IAAI,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,iBAAiB,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9F,eAAe,EAAE,CAAC;YAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAAC,SAAS;QACpD,CAAC;QACD,8EAA8E;QAC9E,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,uBAAuB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5D,IAAI,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,wBAAwB,CAAC,IAAI,CAAC,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9F,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAAC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAAC,cAAc,GAAG,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,KAAK,EAAE,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAAC,gBAAgB,EAAE,CAAC;YAAC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,CAAC;YAAC,SAAS;QACpV,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;YAClC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,gBAAgB,EAAE,CAAC,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QACjG,CAAC;QACD,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,wBAAwB,EAAE,CAAC,KAAK,EAAE,EAAE;YACtD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpF,gBAAgB,EAAE,CAAC;gBAAC,OAAO,UAAU,CAAC;YACxC,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,mCAAmC,EACrD,GAAG,EAAE,GAAG,iBAAiB,EAAE,CAAC,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QACtD,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,sBAAsB,EACxC,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QACnG,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3E,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACvD,eAAe,EAAE,CAAC;YAAC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,CAAC;YAAC,SAAS;QAC5D,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAC3B,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC3D,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;AAClH,CAAC;AACD;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa,EAAE,MAAuB;IACzE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjB,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,EAAE,EAAE,GAAG,MAAM,EAAE,mBAAmB,EAAE,MAAM,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACpG,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACxD,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC3D,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;AACvF,CAAC;AACD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAoC,EAAE,MAAuB;IAC/F,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI;QAAE,MAAM,IAAI,cAAc,CAAC,iBAAiB,CAAC,CAAC;IACvE,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC7C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;QACvD,IAAI,UAAU,GAAG,MAAM,CAAC,kBAAkB;YAAE,MAAM,IAAI,cAAc,CAAC,iBAAiB,CAAC,CAAC;QACxF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACvC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,SAAS;QACtE,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,MAAe,EAAE,OAAe,EAAU,EAAE;QACvE,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzD,OAAO,oBAAoB,CAAC,GAAG,EAAE,EAAE,GAAG,MAAM,EAAE,mBAAmB,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC;IAC3H,CAAC,CAAC;IACF,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC;QACrE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC;KAC7F,CAAC;AACJ,CAAC"}
+{"version":3,"file":"mailSanitize.js","sourceRoot":"","sources":["../src/mailSanitize.ts"],"names":[],"mappings":"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"}

package/dist/mapThread.d.ts

@@ -1,5 +1,16 @@
 import { type SourceCachePermission, type SourceCacheHeaders, type SourceCacheDecision, type SourceSyncReadResult } from '@framers/agentos-ext-account-sources';
 import { type GmailMappingBounds } from './mime.js';
+/** A Gmail inbox tab beside Primary, by its `category:` search name. */
+export type GmailCategory = 'forums' | 'promotions' | 'social' | 'updates';
+/** Every category a client or a mapper can leave out, in the order the scan query names them. */
+export declare const GMAIL_CATEGORIES: readonly GmailCategory[];
+/**
+ * The categories an `excludedCategories` option names, deduplicated and in `GMAIL_CATEGORIES` order: none for an
+ * undefined option, null when the value is not an array of category names.
+ */
+export declare function gmailCategories(value: unknown): readonly GmailCategory[] | null;
+/** The system labels of the given categories. */
+export declare const categoryLabels: (categories: readonly GmailCategory[]) => ReadonlySet<string>;
 /** The per-read values of one `map` call. The host supplies every value; none comes from a browser request. */
 export interface GmailMapThreadOptions {
     /** The requested thread id; the response must carry the same id. */
@@ -24,12 +35,23 @@ export interface GmailMapThreadOptions {
     readonly permission: SourceCachePermission | null;
     /** The thread response's own cache headers. */
     readonly cacheHeaders: SourceCacheHeaders;
-    /** Label names from the cycle's labels response, by label id. */
+    /**
+     * Label names from the cycle's labels response, by label id. They are text from a JSON body, not MIME header values:
+     * each is sanitized again and never decoded as RFC 2047 words, so a literal `=?` in a name stays as written. A run of
+     * encoded words in a name is decoded only to look inside, and one whose text holds an address or a credential is
+     * replaced by what the sanitizer leaves of it.
+     */
     readonly labelNames: Readonly<Record<string, string>>;
     /** The labels response's own cache decision. Null, a refusal or an expired decision keeps ids without names. */
     readonly labelCache: SourceCacheDecision | null;
     /** Cancels the call between steps. */
     readonly signal?: AbortSignal;
+    /**
+     * The inbox tabs whose messages are left out of the copy, by their `category:` names; none by default. A message
+     * carrying such a category's label (`CATEGORY_PROMOTIONS` for `promotions`, and so on) is omitted and counted under
+     * `excluded_category`.
+     */
+    readonly excludedCategories?: readonly GmailCategory[];
 }
 /**
  * Maps one parsed Gmail thread into a sanitized account-source document: one thread, one document, with each retained
@@ -49,12 +71,15 @@ export declare class GmailThreadMapper {
      * Validates the whole response, filters each message by its internal date and by the spam, trash and draft labels,
      * keeps the newest eligible messages up to the cap with ties broken by id, spends the thread's character budget
      * newest first and renders the kept messages oldest first. A message's text is its sanitized header prefix followed
-     * by its sanitized, trimmed body, and its span covers the body alone. A message that cannot be read is counted under
-     * `metadata.omitted` by a fixed reason. The cache expiry is the earliest of the permission's retention, the read start
-     * plus `maximumCacheMs`, the response's cache headers, every kept message's window end and the label names' expiry.
-     * The version is the history id and `contentHash`, the SHA-256 of the normalized text, metadata and spans: a release
-     * that normalizes text differently changes it for exactly the threads whose normalized text, metadata or spans
-     * change, so the store writes those copies again at their next read and keeps the rest.
+     * by its sanitized, trimmed body, cut to the message cap (or the thread cap when that is smaller) and never shorter:
+     * the first message whose text does not fit in what the thread budget has left, and every older one, is counted
+     * under `thread_limit` instead, so the text of a retained message never depends on the rest of its thread. Its span
+     * covers the body alone. A message that cannot be read is counted under `metadata.omitted` by a fixed reason. The
+     * cache expiry is the earliest of the permission's retention, the read start plus `maximumCacheMs`, the response's
+     * cache headers, every kept message's window end and the label names' expiry. The version is the history id and
+     * `contentHash`, the SHA-256 of the normalized text, metadata and spans: a release that normalizes text differently
+     * changes it for exactly the threads whose normalized text, metadata or spans change, so the store writes those
+     * copies again at their next read and keeps the rest.
      *
      * @param input The parsed `threads.get` response in the `full` format, from a transport that capped its bytes.
      * @param options The per-read values.

package/dist/mapThread.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mapThread.d.ts","sourceRoot":"","sources":["../src/mapThread.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,KAAK,qBAAqB,EAAE,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EACjD,KAAK,oBAAoB,EACtD,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,WAAW,CAAC;AAOnB,+GAA+G;AAC/G,MAAM,WAAW,qBAAqB;IACpC,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,qHAAqH;IACrH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,gGAAgG;IAChG,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAClD,+CAA+C;IAC/C,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAC1C,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,gHAAgH;IAChH,QAAQ,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAChD,sCAAsC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAyCD;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C;;;OAGG;gBACS,MAAM,EAAE,kBAAkB;IAEtC,OAAO,CAAC,MAAM;YAKA,SAAS;IAyBvB;;;;;;;;;;;;;;;;;;OAkBG;IACG,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAmFzF"}
+{"version":3,"file":"mapThread.d.ts","sourceRoot":"","sources":["../src/mapThread.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,KAAK,qBAAqB,EAAE,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EACjD,KAAK,oBAAoB,EACtD,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,WAAW,CAAC;AAOnB,wEAAwE;AACxE,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,GAAG,SAAS,CAAC;AAC3E,iGAAiG;AACjG,eAAO,MAAM,gBAAgB,EAAE,SAAS,aAAa,EAA0E,CAAC;AAKhI;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,aAAa,EAAE,GAAG,IAAI,CAM/E;AACD,iDAAiD;AACjD,eAAO,MAAM,cAAc,eAAgB,SAAS,aAAa,EAAE,KAAG,YAAY,MAAM,CACtB,CAAC;AACnE,+GAA+G;AAC/G,MAAM,WAAW,qBAAqB;IACpC,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,qHAAqH;IACrH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,gGAAgG;IAChG,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAClD,+CAA+C;IAC/C,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAC1C;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,gHAAgH;IAChH,QAAQ,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAChD,sCAAsC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;CACxD;AA0CD;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C;;;OAGG;gBACS,MAAM,EAAE,kBAAkB;IAEtC,OAAO,CAAC,MAAM;YAKA,SAAS;IAiCvB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CA8FzF"}

package/dist/mapThread.js

@@ -7,9 +7,31 @@
  */
 import { createHash } from 'node:crypto';
 import { decideSourceCache, SourceSyncFault, } from '@framers/agentos-ext-account-sources';
-import { GmailMappingFault, mappingBounds, mappingActive, gmailId, parseMimeThread, decodedHeaders, decodeMimeWords, mimeBody, } from './mime.js';
-import { GmailTextFault, sanitizeMailHeaders, sanitizeMailMetadata, } from './mailSanitize.js';
+import { GmailMappingFault, mappingBounds, mappingActive, gmailId, parseMimeThread, decodedHeaders, decodeMimeWords, redactMimeWords, mimeBody, } from './mime.js';
+import { GmailTextFault, sanitizeMailText, sanitizeMailHeaders, sanitizeMailMetadata, } from './mailSanitize.js';
 import { messageText } from './messageText.js';
+/** Every category a client or a mapper can leave out, in the order the scan query names them. */
+export const GMAIL_CATEGORIES = Object.freeze(['forums', 'promotions', 'social', 'updates']);
+// The system label Gmail gives a message of each category.
+const CATEGORY_LABELS = Object.freeze({
+    forums: 'CATEGORY_FORUMS', promotions: 'CATEGORY_PROMOTIONS', social: 'CATEGORY_SOCIAL', updates: 'CATEGORY_UPDATES',
+});
+/**
+ * The categories an `excludedCategories` option names, deduplicated and in `GMAIL_CATEGORIES` order: none for an
+ * undefined option, null when the value is not an array of category names.
+ */
+export function gmailCategories(value) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value))
+        return null;
+    const entries = value;
+    if (entries.some((entry) => !GMAIL_CATEGORIES.includes(entry)))
+        return null;
+    return GMAIL_CATEGORIES.filter((category) => entries.includes(category));
+}
+/** The system labels of the given categories. */
+export const categoryLabels = (categories) => new Set(categories.map((category) => CATEGORY_LABELS[category]));
 // An epoch-millisecond value a Date can hold.
 const validTime = (n) => Number.isSafeInteger(n) && n >= 0 && n <= 8_640_000_000_000_000;
 const compareId = (a, b) => a < b ? -1 : a > b ? 1 : 0;
@@ -28,7 +50,8 @@ function configuration(options) {
     if (!gmailId(options.sourceId) || typeof url !== 'string' || !/^\/[A-Za-z0-9_-]+(?:\/[A-Za-z0-9_-]+)*\/?$/.test(url)
         || url.length > 512 || !validTime(options.cutoff) || !validTime(options.readStartedAt)
         || !validTime(options.receivedAt) || options.receivedAt < options.readStartedAt || options.cutoff > options.receivedAt
-        || !Number.isSafeInteger(options.windowMs) || options.windowMs < 1 || options.windowMs > 90 * 86_400_000) {
+        || !Number.isSafeInteger(options.windowMs) || options.windowMs < 1 || options.windowMs > 90 * 86_400_000
+        || gmailCategories(options.excludedCategories) === null) {
         throw new GmailMappingFault('configuration');
     }
 }
@@ -69,12 +92,20 @@ export class GmailThreadMapper {
         const attachments = body.attachments.map((attachment) => ({
             filename: metadata(attachment.filename), mediaType: metadata(attachment.mediaType, 128), size: attachment.size,
         }));
+        // A label name is JSON text, never MIME encoded: decoding it as RFC 2047 words refused a literal `=?` and lost every
+        // message carrying the label. It is sanitized as written, and a run of encoded words in it is decoded only to look
+        // inside: one whose text holds an address or a credential gives way to what the sanitizer leaves of it, so nothing
+        // a reader could decode back is stored.
+        const labelText = (raw) => redactMimeWords(raw, budget, (decoded) => {
+            const inspected = sanitizeMailText(decoded, this.policy(this.bounds.maxInputCharacters));
+            return inspected.addressRedactions + inspected.secretRedactions + inspected.suppressedLines > 0 ? inspected.text : null;
+        });
         const labels = message.labels.map((id) => {
             const permitted = options.labelCache?.kind === 'cache' && validTime(options.labelCache.expiresAt) && options.labelCache.expiresAt > options.receivedAt && options.labelCache.evidenceId.length > 0;
             const raw = permitted && Object.hasOwn(options.labelNames, id) ? options.labelNames[id] : id;
             if (typeof raw !== 'string')
                 throw new SourceSyncFault('invalid_response');
-            return { id, name: metadata(raw) };
+            return { id, name: sanitizeMailMetadata(labelText(raw), this.policy(200)).text };
         });
         const lines = ['subject', 'date', 'from', 'to', 'cc']
             .filter((key) => headers[key] !== '').map((key) => key[0].toUpperCase() + key.slice(1) + ': ' + headers[key]);
@@ -89,12 +120,15 @@ export class GmailThreadMapper {
      * Validates the whole response, filters each message by its internal date and by the spam, trash and draft labels,
      * keeps the newest eligible messages up to the cap with ties broken by id, spends the thread's character budget
      * newest first and renders the kept messages oldest first. A message's text is its sanitized header prefix followed
-     * by its sanitized, trimmed body, and its span covers the body alone. A message that cannot be read is counted under
-     * `metadata.omitted` by a fixed reason. The cache expiry is the earliest of the permission's retention, the read start
-     * plus `maximumCacheMs`, the response's cache headers, every kept message's window end and the label names' expiry.
-     * The version is the history id and `contentHash`, the SHA-256 of the normalized text, metadata and spans: a release
-     * that normalizes text differently changes it for exactly the threads whose normalized text, metadata or spans
-     * change, so the store writes those copies again at their next read and keeps the rest.
+     * by its sanitized, trimmed body, cut to the message cap (or the thread cap when that is smaller) and never shorter:
+     * the first message whose text does not fit in what the thread budget has left, and every older one, is counted
+     * under `thread_limit` instead, so the text of a retained message never depends on the rest of its thread. Its span
+     * covers the body alone. A message that cannot be read is counted under `metadata.omitted` by a fixed reason. The
+     * cache expiry is the earliest of the permission's retention, the read start plus `maximumCacheMs`, the response's
+     * cache headers, every kept message's window end and the label names' expiry. The version is the history id and
+     * `contentHash`, the SHA-256 of the normalized text, metadata and spans: a release that normalizes text differently
+     * changes it for exactly the threads whose normalized text, metadata or spans change, so the store writes those
+     * copies again at their next read and keeps the rest.
      *
      * @param input The parsed `threads.get` response in the `full` format, from a transport that capped its bytes.
      * @param options The per-read values.
@@ -109,6 +143,7 @@ export class GmailThreadMapper {
         mappingActive(options.signal);
         const skipped = (reason) => ({ kind: 'skipped', id: options.sourceId, reason });
         const budget = { bounds: this.bounds, rawBytes: 0, decodedBytes: 0, parts: 0 };
+        const excludedLabels = categoryLabels(gmailCategories(options.excludedCategories) ?? []);
         let thread;
         try {
             thread = parseMimeThread(input, options.sourceId, budget, options.signal);
@@ -133,18 +168,29 @@ export class GmailThreadMapper {
                 omit('excluded_label');
                 continue;
             }
+            if (message.labels.some((label) => excludedLabels.has(label))) {
+                omit('excluded_category');
+                continue;
+            }
             eligible.push(message);
         }
         eligible.sort(newest);
         const selected = eligible.slice(0, this.bounds.maxMessages);
         omit('message_limit', eligible.length - selected.length);
+        // Each message keeps its own cut, whatever else the thread holds: cutting the oldest kept message to what the newer
+        // ones left would change its text at every reply near the cap, and the account-source store charges a message its
+        // copy holds nothing only when its text hash, cut and length are unchanged. The first message that does not fit
+        // whole in what is left reaches the cap: it and every older message are omitted under `thread_limit`, unread, as
+        // they were once a cut message had filled the budget.
+        const cut = Math.min(this.bounds.maxMessageCharacters, this.bounds.maxThreadCharacters);
         const retained = [];
         let used = 0;
+        let full = false;
         let lastReason = 'no_eligible_content';
         for (const message of selected) {
             mappingActive(options.signal);
             const remaining = this.bounds.maxThreadCharacters - used - (retained.length ? 2 : 0);
-            if (remaining <= 0) {
+            if (full || remaining <= 0) {
                 omit('thread_limit');
                 continue;
             }
@@ -161,26 +207,32 @@ export class GmailThreadMapper {
                 continue;
             }
             mappingActive(options.signal);
-            const maximum = Math.min(this.bounds.maxMessageCharacters, remaining);
-            if (normalized.prefix.length > maximum) {
+            if (normalized.prefix.length > cut) {
                 lastReason = 'structure_limit';
                 omit('thread_limit');
                 continue;
             }
-            const body = clip(normalized.body, maximum - normalized.prefix.length);
+            const body = clip(normalized.body, cut - normalized.prefix.length);
             const text = normalized.prefix + body;
             if (!text) {
                 lastReason = 'no_eligible_content';
                 omit(lastReason);
                 continue;
             }
+            if (text.length > remaining) {
+                full = true;
+                omit('thread_limit');
+                continue;
+            }
             retained.push({ normalized, text, bodyStart: normalized.prefix.length,
                 truncated: normalized.truncated || body.length < normalized.body.length });
             used += text.length + (retained.length > 1 ? 2 : 0);
         }
         if (retained.length === 0) {
-            if (eligible.length === 0)
-                lastReason = omitted.excluded_label ? 'excluded_label' : omitted.out_of_window ? 'out_of_window' : lastReason;
+            if (eligible.length === 0) {
+                lastReason = omitted.excluded_label || omitted.excluded_category ? 'excluded_label'
+                    : omitted.out_of_window ? 'out_of_window' : lastReason;
+            }
             return skipped(lastReason);
         }
         retained.sort((a, b) => a.normalized.message.receivedAt - b.normalized.message.receivedAt