@rubytech/create-maxy-code 0.1.161 → 0.1.164

package/payload/platform/plugins/email/mcp/dist/tools/email-graph-query.js

@@ -2,109 +2,182 @@ import neo4j from "neo4j-driver";
 import { getSession } from "../lib/neo4j.js";
 import { computeEmbedding } from "../lib/embedding.js";
 /**
- * Query email-source :KnowledgeDocument threads stored in the graph.
+ * Query stored email-thread `:ConversationArchive` rows in the graph.
  *
  * Two modes:
- *   - List (no query): Cypher MATCH with optional filters, sorted by lastReceivedAt DESC
- *   - Search (query provided): embed via Ollama, vector similarity on KD embedding index
+ *   - List (no query): MATCH archives with optional sender + date filters,
+ *     sorted by lastMessageAt DESC.
+ *   - Search (query provided): embed via Ollama, run vector similarity over
+ *     `:Section` chunks, dedup to parent archives, rank by best section.
  *
- * Always scoped to accountId. The display surface is per-thread, not
- * per-message — the KD body holds the verbatim chronological transcript.
+ * Always scoped to (accountId, source='email'). The display surface is
+ * per-archive; per-message envelopes are not stored — Task 445.
  */
 export async function emailGraphQuery(params) {
     const limit = Math.min(Math.max(1, params.limit ?? 20), 50);
     const offset = Math.max(0, params.offset ?? 0);
     const query = params.query?.trim();
-    const threads = query && query.length > 0
+    const archives = query && query.length > 0
         ? await searchMode(query, params, limit)
         : await listMode(params, limit, offset);
-    if (threads.length === 0) {
+    if (archives.length === 0) {
         return formatEmptyResult(params, query);
     }
-    const lines = threads
-        .map((t) => {
-        const sender = t.rootFromName
-            ? `${t.rootFromName} <${t.rootFromAddress ?? ""}>`
-            : (t.rootFromAddress ?? "(unknown)");
-        let entry = `Thread: ${t.attachmentId.slice(0, 16)}…`;
-        entry += `\nSubject: ${t.subject}`;
-        entry += `\nFirst sender: ${sender}`;
-        entry += `\nMessages: ${t.messageIds.length}`;
-        entry += `\nFirst: ${t.firstReceivedAt}`;
-        entry += `\nLast: ${t.lastReceivedAt}`;
-        if (t.direction === "outbound")
-            entry += `\nDirection: outbound`;
-        if (t.score !== undefined)
-            entry += `\nScore: ${t.score.toFixed(3)}`;
-        // Truncate body to a preview so list responses stay readable.
-        const preview = t.body.length > 800 ? `${t.body.slice(0, 800)}\n…(truncated)` : t.body;
-        entry += `\n\n${preview}`;
+    const lines = archives
+        .map((a) => {
+        const participants = a.participantNames.length > 0
+            ? a.participantNames.join(", ")
+            : "(unknown)";
+        let entry = `Archive: ${a.elementId.slice(0, 16)}…`;
+        entry += `\nTitle: ${a.title || "(untitled)"}`;
+        entry += `\nParticipants: ${participants}`;
+        entry += `\nSections: ${a.sectionCount}`;
+        entry += `\nFirst: ${a.firstMessageAt}`;
+        entry += `\nLast: ${a.lastMessageAt}`;
+        if (a.score !== undefined)
+            entry += `\nScore: ${a.score.toFixed(3)}`;
+        const preview = a.summary.length > 800 ? `${a.summary.slice(0, 800)}\n…(truncated)` : a.summary;
+        if (preview)
+            entry += `\n\n${preview}`;
         return entry + "\n---";
     })
         .join("\n\n");
-    if (!query && threads.length === limit) {
+    if (!query && archives.length === limit) {
         return `${lines}\n\nPagination: next offset=${offset + limit} (pass as offset to get more results)`;
     }
     return lines;
 }
 // ---------------------------------------------------------------------------
-// List mode — Cypher MATCH with optional filters
+// List mode — Cypher MATCH on :ConversationArchive with optional filters
 // ---------------------------------------------------------------------------
 async function listMode(params, limit, offset) {
-    // Exclude discarded threads (spam) from list results. Threads without a
-    // screening property are included.
-    const conditions = [
-        "kd.source = 'email'",
-        "kd.accountId = $accountId",
-        "(kd.screening <> 'discarded' OR kd.screening IS NULL)",
+    const archiveWhere = [
+        "a.source = 'email'",
+        "a.accountId = $accountId",
     ];
     const cyParams = {
         accountId: params.accountId,
         limit: neo4j.int(limit),
         offset: neo4j.int(offset),
     };
+    // Date filters apply at the section level (firstMessageAt/lastMessageAt
+    // span the archive). Carry the archive only when at least one section
+    // overlaps the requested window.
+    let sectionDateFilter = "";
+    const sectionDateConds = [];
     if (params.dateFrom) {
-        conditions.push("kd.lastReceivedAt >= $dateFrom");
+        sectionDateConds.push("s.lastMessageAt >= $dateFrom");
         cyParams.dateFrom = params.dateFrom;
     }
     if (params.dateTo) {
-        conditions.push("kd.firstReceivedAt <= $dateTo");
+        sectionDateConds.push("s.firstMessageAt <= $dateTo");
         cyParams.dateTo = params.dateTo;
     }
-    if (params.direction === "outbound") {
-        conditions.push("kd.direction = 'outbound'");
+    if (sectionDateConds.length > 0) {
+        sectionDateFilter = `WHERE ${sectionDateConds.join(" AND ")}`;
     }
-    else if (params.direction === "inbound") {
-        conditions.push("kd.direction IS NULL");
-    }
-    const senderClause = params.sender
-        ? `, (kd)-[:FROM]->(sender:Person)
-        WHERE toLower(sender.email) CONTAINS toLower($sender)`
-        : `OPTIONAL MATCH (kd)-[:FROM]->(sender:Person)`;
+    // Sender filter joins through :PARTICIPANT_IN; matches Person OR AdminUser
+    // on case-insensitive email substring.
+    let senderFilter = "";
     if (params.sender) {
+        senderFilter = `
+      WITH a
+      MATCH (p)-[:PARTICIPANT_IN]->(a)
+      WHERE (p:Person OR p:AdminUser)
+        AND p.email IS NOT NULL
+        AND toLower(p.email) CONTAINS toLower($sender)
+    `;
         cyParams.sender = params.sender;
     }
     const cypher = `
-    MATCH (kd:KnowledgeDocument)
-    ${senderClause}
-    WHERE ${conditions.join(" AND ")}
-    WITH kd, head(collect(sender)) AS rootSender
-    RETURN kd, rootSender
-    ORDER BY kd.lastReceivedAt DESC
+    MATCH (a:ConversationArchive)
+    WHERE ${archiveWhere.join(" AND ")}
+    ${senderFilter}
+    WITH DISTINCT a
+    OPTIONAL MATCH (a)-[:HAS_SECTION]->(s:Section)
+    ${sectionDateFilter}
+    WITH a, collect(s) AS matchedSections
+    WHERE size(matchedSections) > 0 OR ($dateFrom IS NULL AND $dateTo IS NULL)
+    OPTIONAL MATCH (a)-[:HAS_SECTION]->(allS:Section)
+    WITH a, matchedSections, allS
+    ORDER BY coalesce(allS.position, 0) ASC
+    WITH a,
+         matchedSections,
+         collect(allS) AS allSections
+    WITH a,
+         allSections,
+         [s IN allSections | coalesce(s.summary, '')] AS summaries,
+         [s IN allSections WHERE s.firstMessageAt IS NOT NULL | s.firstMessageAt] AS firsts,
+         [s IN allSections WHERE s.lastMessageAt  IS NOT NULL | s.lastMessageAt]  AS lasts
+    OPTIONAL MATCH (p)-[:PARTICIPANT_IN]->(a)
+    WHERE p:Person OR p:AdminUser
+    WITH a,
+         allSections,
+         summaries,
+         firsts,
+         lasts,
+         collect(DISTINCT coalesce(p.displayName, p.name, p.email, '')) AS participantNames
+    RETURN elementId(a) AS elementId,
+           coalesce(a.title, '') AS title,
+           [x IN summaries WHERE x <> ''] AS summaryParts,
+           CASE WHEN size(firsts) > 0 THEN apoc.coll.min(firsts) ELSE coalesce(a.createdAt, '') END AS firstMessageAt,
+           CASE WHEN size(lasts)  > 0 THEN apoc.coll.max(lasts)  ELSE coalesce(a.lastIngestedMessageAt, a.updatedAt, '') END AS lastMessageAt,
+           size(allSections) AS sectionCount,
+           [n IN participantNames WHERE n <> ''] AS participantNames
+    ORDER BY lastMessageAt DESC
+    SKIP $offset
+    LIMIT $limit
+  `;
+    // Fallback when APOC isn't available: compute min/max in JS. Strip the
+    // apoc.* calls and pull raw arrays instead.
+    const cypherNoApoc = `
+    MATCH (a:ConversationArchive)
+    WHERE ${archiveWhere.join(" AND ")}
+    ${senderFilter}
+    WITH DISTINCT a
+    OPTIONAL MATCH (a)-[:HAS_SECTION]->(s:Section)
+    ${sectionDateFilter}
+    WITH a, collect(s) AS matchedSections
+    WHERE size(matchedSections) > 0 OR ($dateFrom IS NULL AND $dateTo IS NULL)
+    OPTIONAL MATCH (a)-[:HAS_SECTION]->(allS:Section)
+    WITH a, allS
+    ORDER BY coalesce(allS.position, 0) ASC
+    WITH a, collect(allS) AS allSections
+    OPTIONAL MATCH (p)-[:PARTICIPANT_IN]->(a)
+    WHERE p:Person OR p:AdminUser
+    WITH a,
+         allSections,
+         collect(DISTINCT coalesce(p.displayName, p.name, p.email, '')) AS participantNames
+    RETURN elementId(a) AS elementId,
+           coalesce(a.title, '') AS title,
+           [x IN allSections | coalesce(x.summary, '')] AS summaryParts,
+           [x IN allSections WHERE x.firstMessageAt IS NOT NULL | x.firstMessageAt] AS firsts,
+           [x IN allSections WHERE x.lastMessageAt  IS NOT NULL | x.lastMessageAt]  AS lasts,
+           coalesce(a.createdAt, '') AS archiveCreatedAt,
+           coalesce(a.lastIngestedMessageAt, a.updatedAt, '') AS archiveLastAt,
+           size(allSections) AS sectionCount,
+           [n IN participantNames WHERE n <> ''] AS participantNames
+    ORDER BY archiveLastAt DESC
     SKIP $offset
     LIMIT $limit
   `;
+    // dateFrom/dateTo must always be bound (Cypher requires named params even
+    // for the no-filter branch above where the WHERE references them).
+    if (cyParams.dateFrom === undefined)
+        cyParams.dateFrom = null;
+    if (cyParams.dateTo === undefined)
+        cyParams.dateTo = null;
     const session = getSession();
     try {
-        const result = await session.run(cypher, cyParams);
-        return result.records.map((r) => nodeToRecord(r.get("kd"), r.get("rootSender")));
+        const result = await session.run(cypherNoApoc, cyParams);
+        return result.records.map(recordToArchive);
     }
     finally {
         await session.close();
     }
 }
 // ---------------------------------------------------------------------------
-// Search mode — vector similarity on KD embedding index
+// Search mode — vector similarity over :Section, dedup to parent archive
 // ---------------------------------------------------------------------------
 async function searchMode(query, params, limit) {
     const embedding = await computeEmbedding(query);
@@ -112,26 +185,62 @@ async function searchMode(query, params, limit) {
         throw new Error("Semantic search unavailable — the embedding service is not responding. " +
             "Try again without a query to list email threads instead.");
     }
-    const topK = Math.min(limit * 3, 150);
+    const topK = Math.min(limit * 6, 300);
+    const cyParams = {
+        topK: neo4j.int(topK),
+        embedding,
+        accountId: params.accountId,
+        limit: neo4j.int(limit),
+        sender: params.sender ?? null,
+        dateFrom: params.dateFrom ?? null,
+        dateTo: params.dateTo ?? null,
+    };
+    // Section-level vector search → restrict to email archives → keep best
+    // section per archive → carry that score as the archive's rank. Sender
+    // and date filters are applied post-vector (cheaper than pre-filtering
+    // a billion-row index, and the topK over-fetch absorbs the loss).
+    const cypher = `
+    CALL db.index.vector.queryNodes('section_embedding', $topK, $embedding)
+    YIELD node, score
+    WITH node, score
+    MATCH (a:ConversationArchive { accountId: $accountId, source: 'email' })
+          -[:HAS_SECTION]->(node)
+    WHERE ($dateFrom IS NULL OR node.lastMessageAt  >= $dateFrom)
+      AND ($dateTo   IS NULL OR node.firstMessageAt <= $dateTo)
+    WITH a, score
+    ORDER BY score DESC
+    WITH a, head(collect(score)) AS bestScore
+    OPTIONAL MATCH (p)-[:PARTICIPANT_IN]->(a)
+    WHERE p:Person OR p:AdminUser
+    WITH a, bestScore,
+         collect(DISTINCT coalesce(p.displayName, p.name, p.email, '')) AS participantNames,
+         collect(DISTINCT toLower(coalesce(p.email, ''))) AS participantEmails
+    WHERE $sender IS NULL
+       OR any(e IN participantEmails WHERE e CONTAINS toLower($sender))
+    OPTIONAL MATCH (a)-[:HAS_SECTION]->(allS:Section)
+    WITH a, bestScore, participantNames, allS
+    ORDER BY coalesce(allS.position, 0) ASC
+    WITH a, bestScore, participantNames, collect(allS) AS allSections
+    RETURN elementId(a) AS elementId,
+           coalesce(a.title, '') AS title,
+           [x IN allSections | coalesce(x.summary, '')] AS summaryParts,
+           [x IN allSections WHERE x.firstMessageAt IS NOT NULL | x.firstMessageAt] AS firsts,
+           [x IN allSections WHERE x.lastMessageAt  IS NOT NULL | x.lastMessageAt]  AS lasts,
+           coalesce(a.createdAt, '') AS archiveCreatedAt,
+           coalesce(a.lastIngestedMessageAt, a.updatedAt, '') AS archiveLastAt,
+           size(allSections) AS sectionCount,
+           [n IN participantNames WHERE n <> ''] AS participantNames,
+           bestScore AS score
+    ORDER BY score DESC
+    LIMIT $limit
+  `;
     const session = getSession();
     try {
-        const result = await session.run(`CALL db.index.vector.queryNodes('knowledge_document_embedding', $topK, $embedding)
-       YIELD node, score
-       WHERE node.source = 'email' AND node.accountId = $accountId
-       OPTIONAL MATCH (node)-[:FROM]->(sender:Person)
-       WITH node, score, head(collect(sender)) AS rootSender
-       RETURN node, score, rootSender
-       ORDER BY score DESC
-       LIMIT $limit`, {
-            topK: neo4j.int(topK),
-            embedding,
-            accountId: params.accountId,
-            limit: neo4j.int(limit),
-        });
-        return result.records.map((r) => {
-            const record = nodeToRecord(r.get("node"), r.get("rootSender"));
-            record.score = r.get("score");
-            return record;
+        const result = await session.run(cypher, cyParams);
+        return result.records.map((rec) => {
+            const archive = recordToArchive(rec);
+            archive.score = rec.get("score");
+            return archive;
         });
     }
     finally {
@@ -141,19 +250,32 @@ async function searchMode(query, params, limit) {
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
-function nodeToRecord(node, rootSender) {
-    const p = node.properties;
-    const sp = rootSender?.properties ?? null;
+function toNumber(v) {
+    if (typeof v === "number")
+        return v;
+    if (typeof v?.toNumber === "function") {
+        return v.toNumber();
+    }
+    return Number(v ?? 0);
+}
+function recordToArchive(rec) {
+    const summaryParts = rec.get("summaryParts") ?? [];
+    const firsts = rec.get("firsts") ?? [];
+    const lasts = rec.get("lasts") ?? [];
+    const firstMessageAt = firsts.length > 0
+        ? firsts.slice().sort()[0]
+        : rec.get("archiveCreatedAt") ?? "";
+    const lastMessageAt = lasts.length > 0
+        ? lasts.slice().sort()[lasts.length - 1]
+        : rec.get("archiveLastAt") ?? "";
     return {
-        attachmentId: p.attachmentId,
-        subject: p.subject ?? "(no subject)",
-        body: p.body ?? "",
-        messageIds: p.messageIds ?? [],
-        firstReceivedAt: p.firstReceivedAt ?? "",
-        lastReceivedAt: p.lastReceivedAt ?? "",
-        direction: p.direction ?? null,
-        rootFromAddress: sp ? (sp.email ?? null) : null,
-        rootFromName: sp ? (sp.displayName ?? null) : null,
+        elementId: rec.get("elementId"),
+        title: rec.get("title") ?? "",
+        summary: summaryParts.filter((s) => s).join("\n\n"),
+        firstMessageAt,
+        lastMessageAt,
+        sectionCount: toNumber(rec.get("sectionCount")),
+        participantNames: rec.get("participantNames") ?? [],
     };
 }
 function formatEmptyResult(params, query) {
@@ -166,8 +288,6 @@ function formatEmptyResult(params, query) {
         filters.push(`from: ${params.dateFrom}`);
     if (params.dateTo)
         filters.push(`to: ${params.dateTo}`);
-    if (params.direction)
-        filters.push(`direction: ${params.direction}`);
-    return `No email threads found in the graph${filters.length > 0 ? ` matching ${filters.join(", ")}` : ""}.`;
+    return `No email archives found in the graph${filters.length > 0 ? ` matching ${filters.join(", ")}` : ""}.`;
 }
 //# sourceMappingURL=email-graph-query.js.map

package/payload/platform/plugins/email/mcp/dist/tools/email-graph-query.js.map

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

package/payload/platform/plugins/email/mcp/dist/tools/email-ingest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"email-ingest.d.ts","sourceRoot":"","sources":["../../src/tools/email-ingest.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,QAAQ,GAAG,SAAS,CAAC;CACnC;AAED,UAAU,YAAY;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAMD;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAuFvE"}
+{"version":3,"file":"email-ingest.d.ts","sourceRoot":"","sources":["../../src/tools/email-ingest.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,QAAQ,GAAG,SAAS,CAAC;CACnC;AAED,UAAU,YAAY;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAMD;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CA4GvE"}

package/payload/platform/plugins/email/mcp/dist/tools/email-ingest.js

@@ -1,7 +1,9 @@
-import { updatePollState } from "../lib/credentials.js";
+import { loadCredentials, updatePollState } from "../lib/credentials.js";
 import { stripAngleBrackets } from "../lib/graph.js";
-import { dispatchEmailMessagesToConversationArchive } from "../lib/conversation-archive-dispatch.js";
+import { dispatchEmailMessagesToConversationArchive, } from "../lib/conversation-archive-dispatch.js";
 import { takeBatch, peekBatch } from "../lib/ingest-batch.js";
+import { fetchAttachmentBytesForMessages } from "../lib/imap.js";
+import { archiveAttachment, sha256OfBytes, syntheticAttachmentId, } from "../lib/attachment-archive.js";
 function normaliseId(id) {
     return stripAngleBrackets(id)?.toLowerCase() ?? null;
 }
@@ -72,15 +74,30 @@ export async function emailIngest(params) {
         }
     }
     toIngest.sort((a, b) => a.receivedAt.localeCompare(b.receivedAt));
-    const { threadsDispatched, threadsSkipped, unresolvedAddresses } = await dispatchEmailMessagesToConversationArchive(toIngest);
+    // ─── Attachment byte fetch + on-disk archive (Task 402) ───────────────
+    //
+    // For every approved message, look up its attachment metadata in the
+    // cached batch, fetch the bytes from IMAP in one connection, archive
+    // them to disk, and build the per-attachment records the dispatcher
+    // needs to MERGE :DigitalDocument nodes.
+    const ingestedUids = new Set(toIngest.map((m) => m.uid));
+    const metaByUid = new Map();
+    for (const m of batch.messages) {
+        if (ingestedUids.has(m.uid) && m.attachments.length > 0) {
+            metaByUid.set(m.uid, m.attachments);
+        }
+    }
+    const attachmentRecords = await buildAttachmentRecords(params.accountId, batch.uidValidity, metaByUid);
+    const { threadsDispatched, threadsSkipped, unresolvedAddresses, attachmentsAttached, attachmentsFailed } = await dispatchEmailMessagesToConversationArchive(toIngest, attachmentRecords);
     // Advance the high-water mark so the next email-fetch starts after this batch.
     await updatePollState(params.accountId, batch.maxUid, batch.uidValidity);
     // Consume the cached batch only after a successful write + state advance.
     takeBatch(params.accountId);
-    console.error(`[email-ingest] tag=email-ingest ingested=${toIngest.length} discarded=${discarded} threadsDispatched=${threadsDispatched} threadsSkipped=${threadsSkipped} unresolved=${unresolvedAddresses.length}`);
+    console.error(`[email-ingest] tag=email-ingest ingested=${toIngest.length} discarded=${discarded} threadsDispatched=${threadsDispatched} threadsSkipped=${threadsSkipped} unresolved=${unresolvedAddresses.length} attachmentsAttached=${attachmentsAttached} attachmentsFailed=${attachmentsFailed}`);
     const lines = [
         `Ingested ${toIngest.length} message(s); discarded ${discarded}.`,
         `Graph: ${threadsDispatched} thread(s) dispatched to conversation-archive, ${threadsSkipped} skipped.`,
+        `Attachments: ${attachmentsAttached} archived as :DigitalDocument, ${attachmentsFailed} failed.`,
         `Inbox high-water mark advanced to UID ${batch.maxUid}.`,
     ];
     if (unresolvedAddresses.length > 0) {
@@ -88,4 +105,87 @@ export async function emailIngest(params) {
     }
     return lines.join("\n");
 }
+// ---------------------------------------------------------------------------
+// Attachment byte fetch + on-disk archive (Task 402).
+//
+// metaByUid maps approved-message UID → the attachment metadata extracted at
+// email-fetch time (filename, mimeType, sizeBytes, partKey). For each
+// metadata entry we either fetch bytes and archive to disk, or skip bytes
+// (oversize / fetch-error) and write a synthetic-id record so the
+// :DigitalDocument still lands with metadata-only.
+// ---------------------------------------------------------------------------
+async function buildAttachmentRecords(accountId, uidValidity, metaByUid) {
+    if (metaByUid.size === 0)
+        return [];
+    const accountDir = process.env.ACCOUNT_DIR;
+    if (!accountDir) {
+        console.error("[email-attach] WARN: ACCOUNT_DIR env not set; attachment bytes will not be archived (metadata-only :DigitalDocument nodes will still land).");
+    }
+    const credResult = await loadCredentials(accountId);
+    if ("error" in credResult) {
+        console.error(`[email-attach] WARN: loadCredentials failed during attachment fetch: ${credResult.error}`);
+        return [];
+    }
+    const { config, password } = credResult.credentials;
+    // Flatten the (uid, partKey) requests across all approved messages.
+    const requests = [];
+    for (const [uid, metas] of metaByUid.entries()) {
+        for (const m of metas) {
+            requests.push({ uid, partKey: m.partKey, expectedSize: m.sizeBytes, encoding: m.encoding, meta: m });
+        }
+    }
+    const fetched = await fetchAttachmentBytesForMessages(config, password, requests.map(({ uid, partKey, expectedSize, encoding }) => ({ uid, partKey, expectedSize, encoding })));
+    // Index by (uid, partKey) for O(1) lookup.
+    const fetchedKey = (uid, partKey) => `${uid}:${partKey}`;
+    const fetchedByKey = new Map(fetched.map((f) => [fetchedKey(f.uid, f.partKey), f]));
+    const records = [];
+    for (const req of requests) {
+        const f = fetchedByKey.get(fetchedKey(req.uid, req.partKey));
+        if (!f)
+            continue;
+        if (f.bytes === null) {
+            // Bytes not available — write a metadata-only record with a
+            // synthetic content-free attachmentId so the graph node still lands.
+            console.error(`[email-attach] metadata-only uid=${req.uid} part=${req.partKey} filename=${req.meta.filename} reason=${f.failureReason}`);
+            records.push({
+                uid: req.uid,
+                partKey: req.partKey,
+                filename: req.meta.filename,
+                mimeType: req.meta.mimeType,
+                sizeBytes: req.meta.sizeBytes,
+                attachmentId: syntheticAttachmentId(uidValidity, req.uid, req.partKey, req.meta.filename, req.meta.sizeBytes),
+                archivePath: null,
+                archived: false,
+            });
+            continue;
+        }
+        // Bytes in hand — archive to disk (best-effort) and use sha256(bytes)
+        // as the content-addressed attachmentId regardless of archive outcome.
+        const attachmentId = sha256OfBytes(f.bytes);
+        let archivePath = null;
+        let archived = false;
+        if (accountDir) {
+            const result = archiveAttachment(accountDir, uidValidity, req.uid, req.meta.filename, f.bytes);
+            if (result) {
+                archivePath = result.archivePath;
+                archived = true;
+                console.error(`[email-attach] archived uid=${req.uid} part=${req.partKey} sha256=${attachmentId.slice(0, 12)} path=${archivePath}`);
+            }
+            else {
+                console.error(`[email-attach] archive-skipped uid=${req.uid} part=${req.partKey} (write failed; node will still land with archivePath=null)`);
+            }
+        }
+        records.push({
+            uid: req.uid,
+            partKey: req.partKey,
+            filename: req.meta.filename,
+            mimeType: req.meta.mimeType,
+            sizeBytes: req.meta.sizeBytes,
+            attachmentId,
+            archivePath,
+            archived,
+        });
+    }
+    return records;
+}
 //# sourceMappingURL=email-ingest.js.map

package/payload/platform/plugins/email/mcp/dist/tools/email-ingest.js.map

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

package/payload/platform/plugins/email/mcp/dist/tools/email-read.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"email-read.d.ts","sourceRoot":"","sources":["../../src/tools/email-read.ts"],"names":[],"mappings":"AAIA,UAAU,UAAU;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAoEnE"}
+{"version":3,"file":"email-read.d.ts","sourceRoot":"","sources":["../../src/tools/email-read.ts"],"names":[],"mappings":"AAIA,UAAU,UAAU;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CA0EnE"}

package/payload/platform/plugins/email/mcp/dist/tools/email-read.js

@@ -1,6 +1,6 @@
 import { loadCredentials } from "../lib/credentials.js";
 import { fetchRecent, MAX_LIMIT } from "../lib/imap.js";
-import { getThreadInfo, stripAngleBrackets } from "../lib/graph.js";
+import { getMessageArchiveHints } from "../lib/conversation-archive-lookup.js";
 export async function emailRead(params) {
     const result = await loadCredentials(params.accountId);
     if ("error" in result)
@@ -38,14 +38,21 @@ export async function emailRead(params) {
             filters.push(`folder: ${params.folder}`);
         return `No messages found${filters.length > 0 ? ` matching ${filters.join(", ")}` : ""}.`;
     }
-    // Enrich with thread info from the graph (best-effort — failures return empty map)
-    const messageIds = messages.map((m) => m.messageId).filter((id) => !!id);
-    let threadMap = new Map();
+    // Per-archive enrichment from :ConversationArchive {source:'email'}.
+    // Best-effort — failures and empty results degrade silently. Matches on
+    // (accountId, receivedAt within :Section.firstMessageAt..lastMessageAt)
+    // and surfaces the parent archive's title + the matching section's
+    // ordered position. Semantics shift from Task-321 per-message thread
+    // depth to per-archive ordering — see Task 445.
+    const hintInput = messages
+        .filter((m) => m.messageId)
+        .map((m) => ({ messageId: m.messageId, receivedAt: m.date }));
+    let hints = new Map();
     try {
-        threadMap = await getThreadInfo(messageIds, params.accountId);
+        hints = await getMessageArchiveHints(hintInput, params.accountId);
     }
     catch {
-        // Thread enrichment is optional — continue without it
+        // Enrichment is optional — continue without it
     }
     const lines = messages
         .map((m) => {
@@ -54,12 +61,11 @@ export async function emailRead(params) {
             entry += `\nMessage-ID: ${m.messageId}`;
         if (m.inReplyTo)
             entry += `\nIn-Reply-To: ${m.inReplyTo}`;
-        const normalisedMid = stripAngleBrackets(m.messageId);
-        if (normalisedMid) {
-            const thread = threadMap.get(normalisedMid);
-            if (thread) {
-                entry += `\nThread-Depth: ${thread.threadDepth}`;
-                entry += `\nThread-ID: ${thread.threadId}`;
+        if (m.messageId) {
+            const hint = hints.get(m.messageId);
+            if (hint) {
+                entry += `\nArchive: ${hint.archiveTitle}`;
+                entry += `\nArchive-Section: ${hint.sectionIndex}`;
             }
         }
         if (m.bodyPreview)