@redpop/apple-mail-mcp 0.0.0-stage → 0.1.1

package/dist/signing.js.map

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

package/dist/state.js

@@ -0,0 +1,46 @@
+import { chmodSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { formatLocal } from './dates.js';
+export function defaultStateDir() {
+    return join(homedir(), 'Library', 'Application Support', 'apple-mail-mcp');
+}
+const MIN_INTERVAL_MS = 60_000;
+// Letzter Schreibzeitpunkt je Verzeichnis, damit pro Minute hoechstens einmal geschrieben wird.
+const lastWrite = new Map();
+export function readState(dir = defaultStateDir()) {
+    try {
+        const o = JSON.parse(readFileSync(join(dir, 'state.json'), 'utf8'));
+        if (typeof o.lastAccessOk !== 'string')
+            return null;
+        return {
+            lastAccessOk: o.lastAccessOk,
+            helperSha256: typeof o.helperSha256 === 'string' ? o.helperSha256 : null,
+            helperVersion: typeof o.helperVersion === 'string' ? o.helperVersion : null,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** Haelt fest, dass der Zugriff geklappt hat (Spec 12.3). Wirft nie; enthaelt keine Mail-Daten. */
+export function recordAccessOk(info, dir = defaultStateDir(), now = Date.now) {
+    const t = now();
+    const prev = lastWrite.get(dir);
+    if (prev !== undefined && t - prev < MIN_INTERVAL_MS)
+        return;
+    lastWrite.set(dir, t);
+    try {
+        mkdirSync(dir, { recursive: true, mode: 0o700 });
+        const file = join(dir, 'state.json');
+        const tmp = `${file}.${process.pid}.tmp`;
+        const body = { lastAccessOk: formatLocal(Math.floor(t / 1000)), helperSha256: info.helperSha256, helperVersion: info.helperVersion };
+        writeFileSync(tmp, JSON.stringify(body), { mode: 0o600 });
+        chmodSync(tmp, 0o600);
+        renameSync(tmp, file);
+    }
+    catch {
+        // Zustandsdatei ist nur eine Hilfe; ein Schreibfehler darf keinen Tool-Aufruf stoeren.
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACvF,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAWxC,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,qBAAqB,EAAE,gBAAgB,CAAC,CAAA;AAC5E,CAAC;AAED,MAAM,eAAe,GAAG,MAAM,CAAA;AAC9B,gGAAgG;AAChG,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAA;AAE3C,MAAM,UAAU,SAAS,CAAC,GAAG,GAAW,eAAe,EAAE;IACvD,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CAA4B,CAAA;QAC9F,IAAI,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAA;QACnD,OAAO;YACL,YAAY,EAAE,CAAC,CAAC,YAAY;YAC5B,YAAY,EAAE,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI;YACxE,aAAa,EAAE,OAAO,CAAC,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI;SAC5E,CAAA;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,cAAc,CAAC,IAAgB,EAAE,GAAG,GAAW,eAAe,EAAE,EAAE,GAAG,GAAiB,IAAI,CAAC,GAAG;IAC5G,MAAM,CAAC,GAAG,GAAG,EAAE,CAAA;IACf,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC/B,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,GAAG,IAAI,GAAG,eAAe;QAAE,OAAM;IAC5D,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;IACrB,IAAI,CAAC;QACH,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;QAChD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAA;QACpC,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,MAAM,CAAA;QACxC,MAAM,IAAI,GAAU,EAAE,YAAY,EAAE,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAA;QAC3I,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;QACzD,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACrB,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,uFAAuF;IACzF,CAAC;AACH,CAAC"}

package/dist/stdioRunner.js

@@ -0,0 +1,206 @@
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { HelperError } from './errors.js';
+import { helloResult } from './schemas.js';
+/** Protokollversion, die dieser Node-Teil spricht (Spec 7.3 hello). */
+export const PROTOCOL_VERSION = 1;
+/** Laengste erlaubte Antwortzeile (Spec 7.1). */
+export const MAX_LINE_BYTES = 32 * 1024 * 1024;
+export const DEFAULT_TIMEOUTS = { firstRequestMs: 15_000, requestMs: 10_000 };
+/**
+ * Haelt `mail-helper serve` als langlebigen Kindprozess und spricht NDJSON ueber
+ * stdin/stdout. Nach jedem Start geht zuerst `hello` raus; passt die Protokollversion
+ * nicht, wird der Prozess verworfen und alles Offene mit HELPER_VERSION_MISMATCH abgelehnt.
+ * Der Helper arbeitet sequenziell; die id macht eine Desynchronisation laut statt still.
+ */
+export function createStdioRunner(executable, timeouts = DEFAULT_TIMEOUTS, options = {}) {
+    const log = options.log ?? ((line) => void process.stderr.write(line + '\n'));
+    let live;
+    /** Teile der noch unvollstaendigen Antwortzeile; gesucht wird nur im jeweils neuen Teil (linear statt quadratisch). */
+    let chunks = [];
+    let chunkChars = 0;
+    let nextId = 1;
+    let helperVersion = null;
+    /** Hat der aktuelle Prozess schon eine echte Anfrage beantwortet (hello zaehlt nicht)? Steuert die Frist. */
+    let isWarm = false;
+    /**
+     * Timeouts in Folge auf echten Anfragen (nach erfolgreichem hello), unabhaengig von isWarm; zwei davon
+     * heissen: haengt, neu starten. Sonst bliebe ein Helper, der hello beantwortet und danach haengt, fuer immer.
+     */
+    let consecutiveTimeouts = 0;
+    const MAX_CONSECUTIVE_TIMEOUTS = 2;
+    const pending = [];
+    function rejectAllPending(error) {
+        while (pending.length > 0) {
+            const entry = pending.shift();
+            if (entry === undefined)
+                continue;
+            clearTimeout(entry.timer);
+            entry.reject(error);
+        }
+    }
+    /** Verwirft den Prozess; der naechste Aufruf startet von selbst einen frischen. */
+    function discardChild(error) {
+        const previous = live?.proc;
+        live = undefined;
+        chunks = [];
+        chunkChars = 0;
+        isWarm = false;
+        consecutiveTimeouts = 0;
+        rejectAllPending(error);
+        if (previous !== undefined) {
+            previous.removeAllListeners();
+            previous.stdout?.removeAllListeners();
+            previous.stdin?.end();
+            previous.kill();
+        }
+    }
+    function handleLine(line) {
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            // Unlesbare Zeile: die Leitung ist nicht mehr vertrauenswuerdig, also alles ablehnen und neu anfangen.
+            discardChild(new HelperError('HELPER_CRASHED', 'Unreadable response from the helper.'));
+            return;
+        }
+        // Ohne numerische id laesst sich die Antwort keiner Anfrage sicher zuordnen (der Helper hat eine
+        // Anfrage nicht lesen koennen). Kein Raten: die Leitung gilt als verloren, alles Offene scheitert laut.
+        if (typeof parsed.id !== 'number') {
+            discardChild(new HelperError('HELPER_CRASHED', 'The helper sent a response without a request id.'));
+            return;
+        }
+        const index = pending.findIndex((entry) => entry.id === parsed.id);
+        if (index === -1)
+            return; // Antwort auf etwas, das nicht mehr offen ist (z. B. nach Timeout).
+        const entry = pending.splice(index, 1)[0];
+        if (entry === undefined)
+            return;
+        clearTimeout(entry.timer);
+        // Nur eine echte Anfrage macht den Helper warm; hello oeffnet die Datenbank nie (Spec 7.2).
+        if (!entry.isHello)
+            isWarm = true;
+        consecutiveTimeouts = 0;
+        if (parsed.ok === true) {
+            entry.resolve(parsed.result);
+            return;
+        }
+        entry.reject(new HelperError(parsed.error?.code ?? 'HELPER_CRASHED', parsed.error?.message ?? 'Unknown error'));
+    }
+    function onData(chunk) {
+        let rest = chunk;
+        let newlineIndex = rest.indexOf('\n');
+        while (newlineIndex !== -1) {
+            chunks.push(rest.slice(0, newlineIndex));
+            const line = chunks.join('');
+            chunks = [];
+            chunkChars = 0;
+            rest = rest.slice(newlineIndex + 1);
+            if (Buffer.byteLength(line, 'utf8') > MAX_LINE_BYTES) {
+                discardChild(new HelperError('HELPER_CRASHED', 'response too large'));
+                return;
+            }
+            const trimmed = line.trim();
+            if (trimmed.length > 0) {
+                const before = live;
+                handleLine(trimmed);
+                if (live !== before)
+                    return; // handleLine hat den Prozess verworfen.
+            }
+            newlineIndex = rest.indexOf('\n');
+        }
+        if (rest.length > 0) {
+            chunks.push(rest);
+            chunkChars += rest.length;
+        }
+        // Zeichen sind hoechstens so gross wie Bytes: diese Schranke greift sicher, nie zu frueh.
+        if (chunkChars > MAX_LINE_BYTES)
+            discardChild(new HelperError('HELPER_CRASHED', 'response too large'));
+    }
+    /** Schickt eine Anfrage an den aktuellen Prozess und setzt die Frist. */
+    function send(proc, command, payload, timeoutMs, isHello) {
+        const request = new Promise((resolve, reject) => {
+            const id = nextId++;
+            const entry = {
+                id,
+                isHello,
+                resolve,
+                reject,
+                timer: setTimeout(() => {
+                    const index = pending.findIndex((candidate) => candidate.id === id);
+                    if (index !== -1)
+                        pending.splice(index, 1);
+                    const timeout = new HelperError('HELPER_TIMEOUT', `No response from the helper within ${String(timeoutMs)}ms.`);
+                    if (isHello) {
+                        discardChild(timeout);
+                        reject(timeout); // Der Eintrag ist schon aus pending entfernt; ohne dies bliebe ready offen.
+                        return;
+                    }
+                    consecutiveTimeouts += 1;
+                    if (consecutiveTimeouts >= MAX_CONSECUTIVE_TIMEOUTS) {
+                        discardChild(new HelperError('HELPER_TIMEOUT', 'The helper stopped responding and was restarted.'));
+                    }
+                    reject(timeout);
+                }, timeoutMs),
+            };
+            pending.push(entry);
+            proc.stdin?.write(`${JSON.stringify({ id, command, payload })}\n`);
+        });
+        if (!options.debug)
+            return request;
+        // Diagnose (APPLE_MAIL_MCP_DEBUG): nur Kommando, Dauer und Code, nie Payload oder Ergebnis.
+        const started = performance.now();
+        const done = (outcome) => log(`apple-mail-mcp: ${command} ${Math.round(performance.now() - started)} ms ${outcome}`);
+        request.then(() => done('ok'), (error) => done(error instanceof HelperError ? error.code : 'error'));
+        return request;
+    }
+    function ensureChild() {
+        if (live !== undefined)
+            return live;
+        // stderr geht unveraendert an den Elternprozess (Diagnose des Helpers).
+        const proc = spawn(executable, ['serve'], { stdio: ['pipe', 'pipe', 'inherit'] });
+        isWarm = false;
+        chunks = [];
+        chunkChars = 0;
+        proc.stdout?.setEncoding('utf8');
+        proc.stdout?.on('data', onData);
+        // EPIPE auf stdin darf den Server nicht mitreissen; 'exit' entscheidet ueber Offenes.
+        proc.stdin?.on('error', () => { });
+        proc.on('error', (error) => {
+            discardChild(new HelperError(error.code === 'ENOENT' ? 'HELPER_MISSING' : 'HELPER_CRASHED', error.message));
+        });
+        proc.on('exit', (code, signal) => {
+            const reason = signal !== null ? `signal ${signal}` : `exit code ${String(code)}`;
+            discardChild(new HelperError('HELPER_CRASHED', `The helper exited (${reason}).`));
+        });
+        const ready = send(proc, 'hello', {}, timeouts.firstRequestMs, true).then((result) => {
+            const hello = helloResult.safeParse(result);
+            if (!hello.success || hello.data.protocolVersion !== PROTOCOL_VERSION) {
+                const error = new HelperError('HELPER_VERSION_MISMATCH', 'The helper speaks a different protocol version.');
+                discardChild(error);
+                throw error;
+            }
+            helperVersion = hello.data.helperVersion;
+        });
+        ready.catch(() => { }); // Fehler erreichen den Aufrufer ueber run(); hier nur unbehandelte Rejection vermeiden.
+        live = { proc, ready };
+        return live;
+    }
+    return {
+        async run(command, payload) {
+            if (!existsSync(executable))
+                throw new HelperError('HELPER_MISSING', executable);
+            const current = ensureChild();
+            await current.ready;
+            if (live !== current)
+                throw new HelperError('HELPER_CRASHED', 'The helper stopped before the request could be sent.');
+            return send(current.proc, command, payload, isWarm ? timeouts.requestMs : timeouts.firstRequestMs, false);
+        },
+        stop() {
+            discardChild(new HelperError('HELPER_CRASHED', 'The helper was shut down.'));
+        },
+        helperVersion: () => helperVersion,
+    };
+}
+//# sourceMappingURL=stdioRunner.js.map

package/dist/stdioRunner.js.map

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

package/dist/summary.js

@@ -0,0 +1,57 @@
+import { z } from 'zod/v4';
+import { formatLocal } from './dates.js';
+import { messageLink } from './links.js';
+import { classify, redactSubject } from './securityMail.js';
+const Address = z.object({ address: z.string(), name: z.string().nullable() });
+const MailboxRef = z.object({ id: z.string(), name: z.string(), account: z.string() });
+export const MessageSummary = z.object({
+    id: z.string(),
+    link: z.string().nullable(),
+    subject: z.string(),
+    subjectRedacted: z.boolean().optional(),
+    from: Address.nullable(),
+    to: z.array(Address),
+    cc: z.array(Address),
+    recipientCount: z.number().int(),
+    date: z.string(),
+    mailboxes: z.array(MailboxRef),
+    unread: z.boolean(),
+    flagged: z.boolean(),
+    attachmentNames: z.array(z.string()),
+    attachmentCount: z.number().int(),
+    threadId: z.string().nullable(),
+    bodyLocal: z.enum(['full', 'partial', 'none']),
+    matchContext: z.string().optional(),
+});
+/** Standard fuer die Empfaengerzahl je Feld (entspricht dem Helper-Payload, Spec 7.3). */
+export const DEFAULT_MAX_RECIPIENTS = 5;
+export function toSummary(row, policy, config, maxRecipients = DEFAULT_MAX_RECIPIENTS) {
+    const from = row.sender === null || row.sender.address === '' ? null : { address: row.sender.address, name: row.sender.name };
+    const verdict = classify({ subject: row.subject, fromAddress: from?.address ?? null });
+    const redact = verdict.security && !config.showSecurityMails;
+    const pick = (type) => row.recipients.filter((r) => r.type === type).slice(0, maxRecipients).map((r) => ({ address: r.address, name: r.name }));
+    const accountName = new Map(policy.accounts.map((a) => [a.id, a.name]));
+    const mailboxes = row.mailboxIds.flatMap((id) => {
+        const mb = policy.mailboxes.get(id);
+        return mb ? [{ id: String(id), name: mb.name, account: accountName.get(mb.accountId) ?? mb.accountId }] : [];
+    });
+    return {
+        id: String(row.gid),
+        link: messageLink(row.messageIdHeader),
+        subject: redact ? redactSubject(row.subject) : row.subject,
+        ...(redact ? { subjectRedacted: true } : {}),
+        from,
+        to: pick('to'),
+        cc: pick('cc'),
+        recipientCount: row.recipientCount,
+        date: formatLocal(row.dateReceived),
+        mailboxes,
+        unread: !row.read,
+        flagged: row.flagged,
+        attachmentNames: row.attachmentNames,
+        attachmentCount: row.attachmentCount ?? row.attachmentNames.length,
+        threadId: row.conversationId ? String(row.conversationId) : null,
+        bodyLocal: row.file,
+    };
+}
+//# sourceMappingURL=summary.js.map

package/dist/summary.js.map

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

package/dist/tools/getMessage.js

@@ -0,0 +1,112 @@
+import { z } from 'zod/v4';
+import { HelperError } from '../errors.js';
+import { formatLocal } from '../dates.js';
+import { parseMessage, truncateText } from '../mime.js';
+import { stripQuotes } from '../quotes.js';
+import { getMessagesResult } from '../schemas.js';
+import { classify, redactSubject } from '../securityMail.js';
+import { MessageSummary, toSummary } from '../summary.js';
+import { respond } from './respond.js';
+const MAX_RECIPIENTS = 100;
+const Input = z
+    .object({
+    id: z.string().regex(/^\d+$/),
+    maxChars: z.number().int().min(500).max(100_000).default(20_000),
+    stripQuoted: z.boolean().default(false),
+})
+    .strict();
+const Address = z.object({ address: z.string(), name: z.string().nullable() });
+const Output = MessageSummary.omit({ matchContext: true }).extend({
+    replyTo: z.array(Address),
+    dateSent: z.string().nullable(),
+    body: z
+        .object({
+        text: z.string(),
+        format: z.enum(['plain', 'html']),
+        truncated: z.boolean(),
+        totalChars: z.number().int(),
+        quotedRemoved: z.boolean(),
+    })
+        .nullable(),
+    bodyAvailable: z.boolean(),
+    bodyUnavailableReason: z.enum(['not_downloaded', 'file_not_found', 'withheld_security', 'parse_failed']).nullable(),
+    attachments: z.array(z.object({ name: z.string(), downloaded: z.boolean() })),
+    note: z.string().optional(),
+});
+export function registerGetMessage(server, ctx) {
+    server.registerTool('get_message', {
+        description: 'Returns one message with its headers, attachment names and body text, as plain text with quoted replies optionally removed. Changes nothing.',
+        inputSchema: Input,
+        outputSchema: Output,
+        annotations: { title: 'Get message', readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    }, async (input) => respond(async () => {
+        const config = ctx.config();
+        const policy = await ctx.policy();
+        if (policy.allowedMailboxIds.length === 0)
+            throw new HelperError('MESSAGE_NOT_FOUND', '');
+        const gid = Number(input.id);
+        // Jenseits von 2^53 waere die Zahl gerundet und traefe womoeglich eine andere Mail: nie an den Helper.
+        if (!Number.isSafeInteger(gid))
+            throw new HelperError('MESSAGE_NOT_FOUND', '');
+        const raw = getMessagesResult.parse(await ctx.runner.run('get-messages', {
+            allowedMailboxIds: policy.allowedMailboxIds,
+            gids: [gid],
+            maxBytesPerMessage: 8 * 1024 * 1024,
+            maxBytesTotal: 16 * 1024 * 1024,
+        }));
+        const row = raw.messages.find((m) => m.gid === gid);
+        if (!row || raw.missing.includes(gid))
+            throw new HelperError('MESSAGE_NOT_FOUND', '');
+        const summary = toSummary(row, policy, config, MAX_RECIPIENTS);
+        const { matchContext: _m, ...base } = summary;
+        const exchange = row.mailboxIds.some((id) => policy.mailboxes.get(id)?.type === 'exchange');
+        const attachments = row.attachmentNames.map((name) => ({ name, downloaded: row.file === 'full' }));
+        const result = {
+            ...base,
+            replyTo: [],
+            dateSent: row.dateSent === null ? null : formatLocal(row.dateSent),
+            body: null,
+            bodyAvailable: false,
+            bodyUnavailableReason: null,
+            attachments,
+        };
+        const unavailable = (reason, extra = {}) => ({ structured: Output.parse({ ...result, bodyUnavailableReason: reason, ...extra }) });
+        if (row.raw === null && exchange)
+            return unavailable('file_not_found');
+        if (row.file === 'none')
+            return unavailable('not_downloaded');
+        if (row.raw === null)
+            return unavailable('file_not_found');
+        const parsed = await parseMessage(Buffer.from(row.raw, 'base64'));
+        if (!parsed.ok)
+            return unavailable('parse_failed');
+        result.to = parsed.headers.to.slice(0, MAX_RECIPIENTS);
+        result.cc = parsed.headers.cc.slice(0, MAX_RECIPIENTS);
+        result.replyTo = parsed.headers.replyTo.slice(0, MAX_RECIPIENTS);
+        const verdict = classify({ subject: row.subject, fromAddress: summary.from?.address ?? null, text: parsed.text });
+        if (verdict.security && !config.showSecurityMails) {
+            return unavailable('withheld_security', {
+                subject: redactSubject(row.subject),
+                subjectRedacted: true,
+                note: 'The body of this message was withheld because it looks like a security message (code, password reset or sign-in). The configuration decides this; tool parameters cannot change it.',
+            });
+        }
+        let text = parsed.text;
+        let quotedRemoved = false;
+        if (input.stripQuoted) {
+            const s = stripQuotes(text);
+            text = s.text;
+            quotedRemoved = s.removed;
+        }
+        const cut = truncateText(text, Math.min(input.maxChars, config.maxBodyChars));
+        return {
+            structured: Output.parse({
+                ...result,
+                body: { text: cut.text, format: parsed.format, truncated: cut.truncated, totalChars: cut.totalChars, quotedRemoved },
+                bodyAvailable: true,
+                ...(row.rawTruncated ? { note: 'The message file is larger than the read limit, so the body may end early.' } : {}),
+            }),
+        };
+    }, ctx));
+}
+//# sourceMappingURL=getMessage.js.map

package/dist/tools/getMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMessage.js","sourceRoot":"","sources":["../../src/tools/getMessage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,MAAM,cAAc,GAAG,GAAG,CAAA;AAE1B,MAAM,KAAK,GAAG,CAAC;KACZ,MAAM,CAAC;IACN,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;IAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IAChE,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACxC,CAAC;KACD,MAAM,EAAE,CAAA;AAEX,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;AAE9E,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IAChE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;IACzB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,IAAI,EAAE,CAAC;SACJ,MAAM,CAAC;QACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACjC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;QACtB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;QAC5B,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE;KAC3B,CAAC;SACD,QAAQ,EAAE;IACb,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE;IAC1B,qBAAqB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,cAAc,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnH,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC7E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAA;AAEF,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,GAAgB;IACpE,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,WAAW,EAAE,8IAA8I;QAC3J,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,MAAM;QACpB,WAAW,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KACtG,EACD,KAAK,EAAE,KAAK,EAAE,EAAE,CACd,OAAO,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,CAAA;QAC3B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,CAAA;QACjC,IAAI,MAAM,CAAC,iBAAiB,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,WAAW,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAA;QACzF,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QAC5B,uGAAuG;QACvG,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,WAAW,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAA;QAC9E,MAAM,GAAG,GAAG,iBAAiB,CAAC,KAAK,CACjC,MAAM,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE;YACnC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;YAC3C,IAAI,EAAE,CAAC,GAAG,CAAC;YACX,kBAAkB,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;YACnC,aAAa,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;SAChC,CAAC,CACH,CAAA;QACD,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAA;QACnD,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,WAAW,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAA;QAErF,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,CAAA;QAC9D,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAA;QAC7C,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,KAAK,UAAU,CAAC,CAAA;QAC3F,MAAM,WAAW,GAAG,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC,CAAC,CAAA;QAGlG,MAAM,MAAM,GAA4B;YACtC,GAAG,IAAI;YACP,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,GAAG,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClE,IAAI,EAAE,IAAI;YACV,aAAa,EAAE,KAAK;YACpB,qBAAqB,EAAE,IAAI;YAC3B,WAAW;SACZ,CAAA;QACD,MAAM,WAAW,GAAG,CAAC,MAAc,EAAE,KAAK,GAA4B,EAAE,EAAE,EAAE,CAC1E,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,MAAM,EAAE,qBAAqB,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;QAExF,IAAI,GAAG,CAAC,GAAG,KAAK,IAAI,IAAI,QAAQ;YAAE,OAAO,WAAW,CAAC,gBAAgB,CAAC,CAAA;QACtE,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,WAAW,CAAC,gBAAgB,CAAC,CAAA;QAC7D,IAAI,GAAG,CAAC,GAAG,KAAK,IAAI;YAAE,OAAO,WAAW,CAAC,gBAAgB,CAAC,CAAA;QAE1D,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAA;QACjE,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,WAAW,CAAC,cAAc,CAAC,CAAA;QAElD,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;QACtD,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;QACtD,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;QAEhE,MAAM,OAAO,GAAG,QAAQ,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,IAAI,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;QACjH,IAAI,OAAO,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAClD,OAAO,WAAW,CAAC,mBAAmB,EAAE;gBACtC,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC;gBACnC,eAAe,EAAE,IAAI;gBACrB,IAAI,EAAE,qLAAqL;aAC5L,CAAC,CAAA;QACJ,CAAC;QAED,IAAI,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;QACtB,IAAI,aAAa,GAAG,KAAK,CAAA;QACzB,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;YAC3B,IAAI,GAAG,CAAC,CAAC,IAAI,CAAA;YACb,aAAa,GAAG,CAAC,CAAC,OAAO,CAAA;QAC3B,CAAC;QACD,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,CAAA;QAC7E,OAAO;YACL,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC;gBACvB,GAAG,MAAM;gBACT,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,aAAa,EAAE;gBACpH,aAAa,EAAE,IAAI;gBACnB,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,4EAA4E,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpH,CAAC;SACH,CAAA;IACH,CAAC,EAAE,GAAG,CAAC,CACV,CAAA;AACH,CAAC"}

package/dist/tools/getThread.js

@@ -0,0 +1,52 @@
+import { z } from 'zod/v4';
+import { HelperError } from '../errors.js';
+import { threadResult } from '../schemas.js';
+import { MessageSummary, toSummary } from '../summary.js';
+import { respond } from './respond.js';
+const Input = z
+    .object({
+    id: z.string().regex(/^\d+$/),
+    limit: z.number().int().min(1).max(100).default(50),
+})
+    .strict();
+const Output = z.object({
+    threadId: z.string().nullable(),
+    messages: z.array(MessageSummary),
+    hasMore: z.boolean(),
+    note: z.string().optional(),
+});
+export function registerGetThread(server, ctx) {
+    server.registerTool('get_thread', {
+        description: 'Returns summaries of the messages in the conversation that contains the given message (up to the limit, oldest first), without bodies. Changes nothing.',
+        inputSchema: Input,
+        outputSchema: Output,
+        annotations: { title: 'Get thread', readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    }, async (input) => respond(async () => {
+        const config = ctx.config();
+        const policy = await ctx.policy();
+        if (policy.allowedMailboxIds.length === 0)
+            throw new HelperError('MESSAGE_NOT_FOUND', '');
+        const gid = Number(input.id);
+        // Jenseits von 2^53 waere die Zahl gerundet und traefe womoeglich eine andere Mail: nie an den Helper.
+        if (!Number.isSafeInteger(gid))
+            throw new HelperError('MESSAGE_NOT_FOUND', '');
+        const raw = threadResult.parse(await ctx.runner.run('thread', {
+            allowedMailboxIds: policy.allowedMailboxIds,
+            gid,
+            limit: input.limit,
+            maxRecipients: 5,
+        }));
+        const note = raw.hasMore
+            ? `This thread has more messages than the limit. The oldest ${input.limit} messages are shown; use get_message on a listed id for details.`
+            : undefined;
+        return {
+            structured: Output.parse({
+                threadId: raw.conversationId ? String(raw.conversationId) : null,
+                messages: raw.messages.map((r) => toSummary(r, policy, config, 5)),
+                hasMore: raw.hasMore,
+                ...(note ? { note } : {}),
+            }),
+        };
+    }, ctx));
+}
+//# sourceMappingURL=getThread.js.map

package/dist/tools/getThread.js.map

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

package/dist/tools/index.js

@@ -0,0 +1,11 @@
+import { registerGetMessage } from './getMessage.js';
+import { registerGetThread } from './getThread.js';
+import { registerListMailboxes } from './listMailboxes.js';
+import { registerSearchMessages } from './searchMessages.js';
+export function registerTools(server, ctx) {
+    registerListMailboxes(server, ctx);
+    registerSearchMessages(server, ctx);
+    registerGetMessage(server, ctx);
+    registerGetThread(server, ctx);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAE5D,MAAM,UAAU,aAAa,CAAC,MAAiB,EAAE,GAAgB;IAC/D,qBAAqB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAClC,sBAAsB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACnC,kBAAkB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC/B,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AAChC,CAAC"}

package/dist/tools/listMailboxes.js

@@ -0,0 +1,50 @@
+import { z } from 'zod/v4';
+import { respond } from './respond.js';
+const Input = z.object({}).strict();
+const Output = z.object({
+    accounts: z.array(z.object({
+        id: z.string(),
+        name: z.string(),
+        address: z.string().nullable(),
+        type: z.enum(['imap', 'local', 'exchange', 'other']),
+        mailboxes: z.array(z.object({
+            id: z.string(),
+            name: z.string(),
+            path: z.string(),
+            role: z.enum(['inbox', 'sent', 'drafts', 'archive', 'junk', 'trash', 'allmail', 'other']),
+            total: z.number().int(),
+            unread: z.number().int(),
+        })),
+    })),
+    note: z.string().optional(),
+});
+export function registerListMailboxes(server, ctx) {
+    server.registerTool('list_mailboxes', {
+        description: 'Lists the mail accounts and mailboxes that are visible under the current settings, with message counts. Changes nothing.',
+        inputSchema: Input,
+        outputSchema: Output,
+        annotations: { title: 'List mailboxes', readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    }, async () => respond(async () => {
+        const policy = await ctx.policy(true);
+        const accounts = policy.accounts.map((a) => ({
+            id: a.id,
+            name: a.name,
+            address: a.address,
+            type: a.type,
+            mailboxes: [...policy.mailboxes.values()]
+                .filter((m) => m.accountId === a.id)
+                .map((m) => ({
+                id: String(m.id),
+                name: m.name,
+                path: m.path.join('/'),
+                role: m.role,
+                total: m.total,
+                unread: m.unread,
+            })),
+        }));
+        const n = policy.unmatchedAllowlistEntries;
+        const note = n > 0 ? `${n} configured account${n === 1 ? '' : 's'} did not match any mail account.` : undefined;
+        return { structured: Output.parse({ accounts, ...(note ? { note } : {}) }) };
+    }, ctx));
+}
+//# sourceMappingURL=listMailboxes.js.map

package/dist/tools/listMailboxes.js.map

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

package/dist/tools/respond.js

@@ -0,0 +1,34 @@
+import { HelperError, describeError, fdaMessage } from '../errors.js';
+// Freigabe pro Code, nicht pro Herkunft: nur diese Codes geben ihren Text als Detail an das Modell weiter.
+// Node verfasst sie selbst (dates.ts, cursor.ts, context.ts); INVALID_INPUT kommt auch vom Helper, dort aber
+// nur mit festen Texten ohne Pfade oder Mail-Daten ("Invalid value for <feld>."). Ein neuer Helper-Text unter
+// einem dieser Codes darf deshalb nie Pfade oder Nutzerdaten enthalten. Alle anderen Codes geben nur den festen Text.
+const DETAIL_CODES = new Set(['INVALID_INPUT', 'INVALID_CURSOR', 'CONFIG_INVALID']);
+/**
+ * Einzige Stelle, an der Fehler zu Antworten werden. Das Modell bekommt Klartext,
+ * niemals einen Stacktrace.
+ *
+ * Bewusst ohne `: Promise<ToolResult>`-Rueckgabetyp-Annotation: `ToolResult` hat keine
+ * Indexsignatur, das SDK-eigene `CallToolResult` aber schon; eine explizite Annotation
+ * macht die Rueckgabe nominell inkompatibel und laesst `registerTool` auf die veraltete
+ * Raw-Shape-Ueberladung zurueckfallen. `satisfies` prueft dieselbe Form ohne Festnageln.
+ */
+export async function respond(produce, ctx) {
+    try {
+        const { structured } = await produce();
+        return { content: [{ type: 'text', text: JSON.stringify(structured, null, 2) }], structuredContent: structured };
+    }
+    catch (error) {
+        const openedNow = ctx.onHelperError(error);
+        let text;
+        if (error instanceof HelperError) {
+            text = error.code === 'FULL_DISK_ACCESS_REQUIRED' ? fdaMessage(ctx.bundlePath, openedNow, ctx.helperName) : describeError(error.code, DETAIL_CODES.has(error.code) ? error.message : undefined);
+        }
+        else {
+            // Keine Nutzerdaten und kein Stacktrace an das Modell.
+            text = describeError('UNKNOWN');
+        }
+        return { content: [{ type: 'text', text }], isError: true };
+    }
+}
+//# sourceMappingURL=respond.js.map