@fluxmail/core 0.19.0 → 0.19.1

package/dist/attachments.d.ts

@@ -0,0 +1,9 @@
+/** A filename safe for a download: control, path and reserved characters become underscores. */
+export declare function safeAttachmentFilename(filename: string): string;
+/** Response headers for downloading an attachment's decoded content. */
+export declare function attachmentDownloadHeaders(attachment: {
+    filename: string;
+    mimeType: string;
+    byteLength: number;
+}): Record<string, string>;
+//# sourceMappingURL=attachments.d.ts.map

package/dist/attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../src/attachments.ts"],"names":[],"mappings":"AAEA,gGAAgG;AAChG,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAS/D;AASD,wEAAwE;AACxE,wBAAgB,yBAAyB,CAAC,UAAU,EAAE;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASzB"}

package/dist/attachments.js

@@ -0,0 +1,27 @@
+const MIME_TYPE_PATTERN = /^[\w!#$&^_.+-]+\/[\w!#$&^_.+-]+$/;
+/** A filename safe for a download: control, path and reserved characters become underscores. */
+export function safeAttachmentFilename(filename) {
+    let safe = '';
+    for (const character of filename) {
+        const code = character.charCodeAt(0);
+        // encodeURIComponent throws on an unpaired surrogate, so replace it too.
+        const unpaired = character.length === 1 && code >= 0xd800 && code <= 0xdfff;
+        safe += code < 32 || code === 127 || unpaired || '/\\:*?"<>|'.includes(character) ? '_' : character;
+    }
+    return safe || 'attachment';
+}
+function encodeContentDispositionFilename(filename) {
+    return encodeURIComponent(filename).replace(/['()*]/g, (character) => `%${character.charCodeAt(0).toString(16).toUpperCase()}`);
+}
+/** Response headers for downloading an attachment's decoded content. */
+export function attachmentDownloadHeaders(attachment) {
+    const name = safeAttachmentFilename(attachment.filename);
+    return {
+        'content-type': MIME_TYPE_PATTERN.test(attachment.mimeType) ? attachment.mimeType : 'application/octet-stream',
+        'content-length': String(attachment.byteLength),
+        'content-disposition': `attachment; filename="${name.replace(/[^\x20-\x7e]/g, '_')}"; filename*=UTF-8''${encodeContentDispositionFilename(name)}`,
+        'cache-control': 'no-store',
+        'x-content-type-options': 'nosniff',
+    };
+}
+//# sourceMappingURL=attachments.js.map

package/dist/attachments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.js","sourceRoot":"","sources":["../src/attachments.ts"],"names":[],"mappings":"AAAA,MAAM,iBAAiB,GAAG,kCAAkC,CAAC;AAE7D,gGAAgG;AAChG,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,KAAK,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACrC,yEAAyE;QACzE,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC;QAC5E,IAAI,IAAI,IAAI,GAAG,EAAE,IAAI,IAAI,KAAK,GAAG,IAAI,QAAQ,IAAI,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IACtG,CAAC;IACD,OAAO,IAAI,IAAI,YAAY,CAAC;AAC9B,CAAC;AAED,SAAS,gCAAgC,CAAC,QAAgB;IACxD,OAAO,kBAAkB,CAAC,QAAQ,CAAC,CAAC,OAAO,CACzC,SAAS,EACT,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CACxE,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,yBAAyB,CAAC,UAIzC;IACC,MAAM,IAAI,GAAG,sBAAsB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACzD,OAAO;QACL,cAAc,EAAE,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,0BAA0B;QAC9G,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC;QAC/C,qBAAqB,EAAE,yBAAyB,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,uBAAuB,gCAAgC,CAAC,IAAI,CAAC,EAAE;QACjJ,eAAe,EAAE,UAAU;QAC3B,wBAAwB,EAAE,SAAS;KACpC,CAAC;AACJ,CAAC"}

package/dist/errors.d.ts

@@ -39,4 +39,9 @@ export declare function networkFailure(error: unknown): Pick<ProviderFailure, 'r
 /** A provider response is missing data Fluxmail needs. */
 export declare function invalidResponseError(message: string): EmailError;
 export declare function isEmailError(err: unknown): err is EmailError;
+/**
+ * Whether an error proves a send or change was not applied, so the caller may retry or report
+ * it as failed. Any other error leaves the outcome uncertain.
+ */
+export declare function isDefiniteDeliveryFailure(error: unknown): boolean;
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,cAAc,GACd,WAAW,GACX,iBAAiB,GACjB,sBAAsB,GACtB,sBAAsB,GACtB,sBAAsB,GACtB,mBAAmB,GACnB,wBAAwB,CAAC;AAE7B,eAAO,MAAM,cAAc,EAAE,SAAS,QAAQ,EAAiC,CAAC;AAEhF,kFAAkF;AAClF,eAAO,MAAM,eAAe,kRAgBlB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,+CAA+C;AAC/C,eAAO,MAAM,cAAc,kGASjB,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,6FAA6F;AAC7F,eAAO,MAAM,gBAAgB,yXAmBnB,CAAC;AAEX;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,2FAA2F;IAC3F,OAAO,CAAC,EAAE,eAAe,CAAC;gBAEd,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe;CAO7G;AAgBD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,QAAQ,CAAC,GAAG,SAAS,CAYrG;AAED,0DAA0D;AAC1D,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAEhE;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,UAAU,CAE5D"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,cAAc,GACd,WAAW,GACX,iBAAiB,GACjB,sBAAsB,GACtB,sBAAsB,GACtB,sBAAsB,GACtB,mBAAmB,GACnB,wBAAwB,CAAC;AAE7B,eAAO,MAAM,cAAc,EAAE,SAAS,QAAQ,EAAiC,CAAC;AAEhF,kFAAkF;AAClF,eAAO,MAAM,eAAe,kRAgBlB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,+CAA+C;AAC/C,eAAO,MAAM,cAAc,kGASjB,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,6FAA6F;AAC7F,eAAO,MAAM,gBAAgB,yXAmBnB,CAAC;AAEX;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,2FAA2F;IAC3F,OAAO,CAAC,EAAE,eAAe,CAAC;gBAEd,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe;CAO7G;AAgBD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,QAAQ,CAAC,GAAG,SAAS,CAYrG;AAED,0DAA0D;AAC1D,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAEhE;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,UAAU,CAE5D;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAajE"}

package/dist/errors.js

@@ -105,4 +105,20 @@ export function invalidResponseError(message) {
 export function isEmailError(err) {
     return err instanceof EmailError;
 }
+/**
+ * Whether an error proves a send or change was not applied, so the caller may retry or report
+ * it as failed. Any other error leaves the outcome uncertain.
+ */
+export function isDefiniteDeliveryFailure(error) {
+    return (isEmailError(error) &&
+        [
+            'invalid_request',
+            'not_found',
+            'permission_denied',
+            'unsupported_capability',
+            'auth_expired',
+            'rate_limited',
+            'entitlement_exceeded',
+        ].includes(error.code));
+}
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/index.d.ts

@@ -5,4 +5,5 @@ export * from './reply.js';
 export * from './addresses.js';
 export * from './search.js';
 export * from './searchContext.js';
+export * from './attachments.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -5,4 +5,5 @@ export * from './reply.js';
 export * from './addresses.js';
 export * from './search.js';
 export * from './searchContext.js';
+export * from './attachments.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}

package/dist/mcp/clients.d.ts

@@ -0,0 +1,16 @@
+/** Fixed labels for MCP clients. Client names are untrusted, so telemetry groups them into these. */
+export declare const mcpClients: readonly ["claude", "claude_desktop", "claude_code", "codex", "cursor", "chatgpt", "vscode", "windsurf", "cline", "roo_code", "goose", "zed", "muse", "other", "unknown"];
+export type McpClient = (typeof mcpClients)[number];
+export declare function classifyMcpClient(name: unknown): McpClient;
+export interface McpClientProperties {
+    mcp_client: McpClient;
+    /** The self-reported name, trimmed. Omitted when blank or longer than 128 characters. */
+    mcp_client_name?: string;
+    /** The self-reported version, trimmed. Omitted when blank or longer than 64 characters. */
+    mcp_client_version?: string;
+    /** A dated MCP revision such as `2026-07-28`. Omitted when absent or malformed. */
+    mcp_protocol_version?: string;
+}
+/** Describe an untrusted `clientInfo` object and protocol version from a request. */
+export declare function mcpClientProperties(info: unknown, protocolVersion?: unknown): McpClientProperties;
+//# sourceMappingURL=clients.d.ts.map

package/dist/mcp/clients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.d.ts","sourceRoot":"","sources":["../../src/mcp/clients.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG,eAAO,MAAM,UAAU,2KAgBb,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAwBpD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,CAQ1D;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,SAAS,CAAC;IACtB,yFAAyF;IACzF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2FAA2F;IAC3F,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mFAAmF;IACnF,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAOD,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,eAAe,CAAC,EAAE,OAAO,GAAG,mBAAmB,CAYjG"}

package/dist/mcp/clients.js

@@ -0,0 +1,69 @@
+/** Fixed labels for MCP clients. Client names are untrusted, so telemetry groups them into these. */
+export const mcpClients = [
+    'claude',
+    'claude_desktop',
+    'claude_code',
+    'codex',
+    'cursor',
+    'chatgpt',
+    'vscode',
+    'windsurf',
+    'cline',
+    'roo_code',
+    'goose',
+    'zed',
+    'muse',
+    'other',
+    'unknown',
+];
+const aliases = new Map([
+    ['claude', 'claude'],
+    ['claude_ai', 'claude'],
+    ['claude_desktop', 'claude_desktop'],
+    ['claude_code', 'claude_code'],
+    ['codex', 'codex'],
+    ['codex_mcp_client', 'codex'],
+    ['cursor', 'cursor'],
+    ['cursor_vscode', 'cursor'],
+    ['chatgpt', 'chatgpt'],
+    ['openai_mcp', 'chatgpt'],
+    ['vscode', 'vscode'],
+    ['visual_studio_code', 'vscode'],
+    ['windsurf', 'windsurf'],
+    ['cline', 'cline'],
+    ['roo_code', 'roo_code'],
+    ['goose', 'goose'],
+    ['zed', 'zed'],
+    ['muse', 'muse'],
+]);
+// Client names are untrusted. Classify them into fixed labels for stable grouping.
+export function classifyMcpClient(name) {
+    if (typeof name !== 'string' || !name.trim())
+        return 'unknown';
+    if (name.length > 128)
+        return 'other';
+    const normalized = name
+        .trim()
+        .toLowerCase()
+        .replace(/[ _-]+/g, '_');
+    return aliases.get(normalized) ?? 'other';
+}
+function boundedText(value, maxLength) {
+    const trimmed = typeof value === 'string' ? value.trim() : '';
+    return trimmed && trimmed.length <= maxLength ? trimmed : undefined;
+}
+/** Describe an untrusted `clientInfo` object and protocol version from a request. */
+export function mcpClientProperties(info, protocolVersion) {
+    const client = info && typeof info === 'object' ? info : {};
+    const name = boundedText(client.name, 128);
+    const version = boundedText(client.version, 64);
+    return {
+        mcp_client: classifyMcpClient(client.name),
+        ...(name ? { mcp_client_name: name } : {}),
+        ...(version ? { mcp_client_version: version } : {}),
+        ...(typeof protocolVersion === 'string' && /^\d{4}-\d{2}-\d{2}$/.test(protocolVersion)
+            ? { mcp_protocol_version: protocolVersion }
+            : {}),
+    };
+}
+//# sourceMappingURL=clients.js.map

package/dist/mcp/clients.js.map

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

package/dist/mcp/index.d.ts

@@ -1,3 +1,5 @@
 export * from './scopes.js';
 export * from './tools.js';
+export * from './results.js';
+export * from './clients.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}

package/dist/mcp/index.js

@@ -1,3 +1,5 @@
 export * from './scopes.js';
 export * from './tools.js';
+export * from './results.js';
+export * from './clients.js';
 //# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}

package/dist/mcp/pdf.d.ts

@@ -0,0 +1,18 @@
+import { type PdfText } from './results.js';
+export interface PdfTextExtractorOptions {
+    /**
+     * The worker module. It reads `{ bytes, cMapDirectory, firstPage, lastPage, maxPages, maxChars }`
+     * from `workerData` and posts one PdfText message.
+     */
+    workerUrl: URL;
+    /** pdf.js reads CMaps from a filesystem path ending in a separator; a file:// URL does not load. */
+    cMapDirectory: string;
+}
+export type PdfTextExtractor = (content: Buffer, signal: AbortSignal, pages?: string, onError?: (error: unknown) => void) => Promise<PdfText | undefined>;
+/**
+ * Extracts PDF text in memory-limited workers. At most PDF_TEXT_LIMITS.workers extractions run at
+ * once in the process. Waiting for a worker shares the extraction timeout. The extractor resolves
+ * undefined when extraction fails or is aborted.
+ */
+export declare function createPdfTextExtractor({ workerUrl, cMapDirectory }: PdfTextExtractorOptions): PdfTextExtractor;
+//# sourceMappingURL=pdf.d.ts.map

package/dist/mcp/pdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.d.ts","sourceRoot":"","sources":["../../src/mcp/pdf.ts"],"names":[],"mappings":"AACA,OAAO,EAAmC,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAE7E,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,SAAS,EAAE,GAAG,CAAC;IACf,oGAAoG;IACpG,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAC7B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,EACnB,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,KAC/B,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;AAmClC;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,SAAS,EAAE,aAAa,EAAE,EAAE,uBAAuB,GAAG,gBAAgB,CA2D9G"}

package/dist/mcp/pdf.js

@@ -0,0 +1,97 @@
+import { Worker } from 'node:worker_threads';
+import { PDF_TEXT_LIMITS, parsePageRange } from './results.js';
+// Shared by every extractor in this process, so concurrent extractions cannot multiply the
+// heap limit.
+let runningWorkers = 0;
+const workerQueue = [];
+/** Resolves true once a worker slot is held, or false when the signal aborts first. */
+function acquireWorkerSlot(signal) {
+    if (signal.aborted)
+        return Promise.resolve(false);
+    if (runningWorkers < PDF_TEXT_LIMITS.workers) {
+        runningWorkers++;
+        return Promise.resolve(true);
+    }
+    return new Promise((resolve) => {
+        const grant = () => {
+            signal.removeEventListener('abort', cancel);
+            resolve(true);
+        };
+        const cancel = () => {
+            workerQueue.splice(workerQueue.indexOf(grant), 1);
+            resolve(false);
+        };
+        workerQueue.push(grant);
+        signal.addEventListener('abort', cancel, { once: true });
+    });
+}
+/** Hand the slot to the next waiting extraction, or free it. */
+function releaseWorkerSlot() {
+    const next = workerQueue.shift();
+    if (next)
+        next();
+    else
+        runningWorkers--;
+}
+/**
+ * Extracts PDF text in memory-limited workers. At most PDF_TEXT_LIMITS.workers extractions run at
+ * once in the process. Waiting for a worker shares the extraction timeout. The extractor resolves
+ * undefined when extraction fails or is aborted.
+ */
+export function createPdfTextExtractor({ workerUrl, cMapDirectory }) {
+    const runPdfWorker = (content, signal, pages, onError) => {
+        const range = parsePageRange(pages);
+        if (!range)
+            return Promise.resolve(undefined);
+        return new Promise((resolve) => {
+            if (signal.aborted)
+                return resolve(undefined);
+            const bytes = new Uint8Array(content);
+            const worker = new Worker(workerUrl, {
+                workerData: {
+                    bytes,
+                    cMapDirectory,
+                    firstPage: range.first,
+                    lastPage: range.last,
+                    maxPages: PDF_TEXT_LIMITS.maxPages,
+                    maxChars: PDF_TEXT_LIMITS.maxChars,
+                },
+                transferList: [bytes.buffer],
+                resourceLimits: { maxOldGenerationSizeMb: PDF_TEXT_LIMITS.heapMb },
+            });
+            let settled = false;
+            const finish = (result, error) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                signal.removeEventListener('abort', abort);
+                if (error)
+                    onError?.(error);
+                // Resolve after the thread stops so a released slot no longer holds its heap.
+                void worker.terminate().finally(() => resolve(result));
+            };
+            const abort = () => finish();
+            const timer = setTimeout(() => finish(undefined, new Error('PDF text extraction timed out.')), PDF_TEXT_LIMITS.timeoutMs);
+            signal.addEventListener('abort', abort, { once: true });
+            worker.once('message', (result) => finish(result));
+            worker.once('error', (error) => finish(undefined, error));
+            worker.once('exit', (code) => finish(undefined, new Error(`PDF text worker exited with code ${code}.`)));
+        });
+    };
+    return async (content, signal, pages = '1-999999', onError) => {
+        const waitTimeout = AbortSignal.timeout(PDF_TEXT_LIMITS.timeoutMs);
+        if (!(await acquireWorkerSlot(AbortSignal.any([signal, waitTimeout])))) {
+            if (waitTimeout.aborted && !signal.aborted)
+                onError?.(new Error('PDF text extraction timed out waiting for a worker.'));
+            return undefined;
+        }
+        try {
+            return await runPdfWorker(content, signal, pages, onError);
+        }
+        finally {
+            releaseWorkerSlot();
+        }
+    };
+}
+//# sourceMappingURL=pdf.js.map

package/dist/mcp/pdf.js.map

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

package/dist/mcp/results.d.ts

@@ -0,0 +1,114 @@
+import type { Message, ModifyAction, Thread } from '../types.js';
+import type { ModifyActionName } from './scopes.js';
+/** The most body characters one MCP result returns, so one long email can't fill the model's context. */
+export declare const MAX_BODY_CHARS = 50000;
+export declare const MAX_THREAD_PAGE_TOKEN_CHARS = 1024;
+export declare const DEFAULT_THREAD_PAGE_SIZE = 10;
+export type BodyFormat = 'text' | 'html' | 'both' | 'none';
+export type BodyTruncation = Record<string, {
+    totalChars: number;
+    nextOffset?: number;
+}>;
+/** Keep the requested body parts, cut to a shared character budget, and say where each was cut. */
+export declare function selectBody(message: Message, format: BodyFormat, budget?: number): Message & {
+    bodyTruncation?: BodyTruncation;
+};
+export interface BodyPage {
+    format: 'text' | 'html';
+    text: string;
+    offset: number;
+    totalChars: number;
+    nextOffset?: number;
+}
+/** One window of a message body, for reading a long body in parts. */
+export declare function bodyPage(message: Message, format: 'text' | 'html', offset?: number, maxChars?: number): BodyPage;
+/**
+ * The message offset a thread page token points to, or undefined when the token is malformed or
+ * belongs to another thread. A token is the base64url JSON of the thread ID and the offset.
+ */
+export declare function threadPageOffset(threadId: string, pageToken: string | undefined): number | undefined;
+export interface ThreadPage {
+    id: string;
+    subject: string;
+    messages: Array<Message & {
+        bodyTruncation?: BodyTruncation;
+    }>;
+    nextPageToken?: string;
+}
+/** One page of a thread's messages. Bodies on the page share one character budget. */
+export declare function threadPage(thread: Thread, options: {
+    threadId: string;
+    offset: number;
+    pageSize?: number;
+    bodyFormat?: BodyFormat;
+}): ThreadPage;
+/** Folders a move can't target, because archive and trash have their own actions. */
+export declare const PROTECTED_MOVE_DESTINATIONS: ReadonlySet<string>;
+/**
+ * The provider action for a modify action and its arguments, or an error message for the
+ * caller when a required argument is missing or the move targets a protected folder.
+ */
+export declare function toModifyAction(action: ModifyActionName, args: {
+    folder?: string;
+    labels?: string[];
+}): {
+    action: ModifyAction;
+} | {
+    error: string;
+};
+export declare function mediaType(mimeType: string): string;
+export type AttachmentResourceContents = {
+    uri: string;
+    mimeType: string;
+    text: string;
+} | {
+    uri: string;
+    mimeType: string;
+    blob: string;
+};
+/**
+ * Some clients, including claude.ai, only pass a blob to the model through
+ * file storage, so UTF-8 text attachments go out as text.
+ */
+export declare function attachmentContents(uri: string, mimeType: string, content: Buffer): AttachmentResourceContents;
+export type InlineAttachmentContent = {
+    type: 'image';
+    data: string;
+    mimeType: string;
+} | {
+    type: 'resource';
+    resource: AttachmentResourceContents;
+};
+export declare function inlineContent(uri: string, mimeType: string, content: Buffer): InlineAttachmentContent;
+/** The URI of an attachment resource. The filename is display-only; lookups use the IDs. */
+export declare function attachmentUri(accountId: string, messageId: string, attachmentId: string, filename: string): string;
+export declare const ATTACHMENT_URI_TEMPLATE = "fluxmail://attachment/{accountId}/{messageId}/{attachmentId}/{filename}";
+/** Limits on PDF text extraction. At most `workers` extractions run at once in a process, across extractors. */
+export declare const PDF_TEXT_LIMITS: {
+    maxPages: number;
+    maxChars: number;
+    heapMb: number;
+    timeoutMs: number;
+    workers: number;
+};
+/** A PDF page or ascending page range such as 201-400. Check the order with parsePageRange. */
+export declare const PDF_PAGE_RANGE_PATTERN: RegExp;
+export declare const PDF_PAGE_RANGE_MESSAGE = "Use a page or an ascending range such as 201-400.";
+/** The first and last page of a range, or undefined when it is malformed or descending. */
+export declare function parsePageRange(pages: string): {
+    first: number;
+    last: number;
+} | undefined;
+export interface PdfText {
+    text: string;
+    firstPage: number;
+    lastPage: number;
+    totalPages: number;
+    cut: boolean;
+}
+/** The text block describing an extraction, or none when extraction failed. */
+export declare function pdfTextContent(filename: string, pdf: PdfText | undefined): Array<{
+    type: 'text';
+    text: string;
+}>;
+//# sourceMappingURL=results.d.ts.map

package/dist/mcp/results.d.ts.map

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