@rubytech/create-maxy-code 0.1.158 → 0.1.161

package/payload/platform/plugins/email/mcp/dist/lib/graph.js

@@ -1,6 +1,4 @@
-import { createHash } from "node:crypto";
 import { getSession } from "./neo4j.js";
-import { computeEmbedding } from "./embedding.js";
 import neo4j from "neo4j-driver";
 /**
  * Strip RFC 2822 angle brackets from a Message-ID or In-Reply-To header.
@@ -15,304 +13,18 @@ export function stripAngleBrackets(value) {
     }
     return trimmed;
 }
-/** Globally-unique attachmentId for a thread, scoped by account + root messageId. */
-function deriveThreadAttachmentId(accountId, rootMessageId) {
-    return createHash("sha256")
-        .update(`email:${accountId}:${rootMessageId}`)
-        .digest("hex");
+export async function getMessageEnvelope(_messageId, _accountId) {
+    // Task 442 — sourcing per-message envelopes from IMAP, not the graph.
+    return null;
 }
-/** Fallback attachmentId for a message with no Message-ID header. */
-function deriveFallbackAttachmentId(data) {
-    return createHash("sha256")
-        .update(`email-fallback:${data.accountId}:${data.uidValidity}:${data.uid}:${data.mailbox}`)
-        .digest("hex");
-}
-function normaliseAddress(addr) {
-    return addr.trim().toLowerCase();
-}
-function renderMessageBlock(data, messageId) {
-    const headers = [
-        `Message-ID: ${messageId}`,
-        `From: ${data.fromName ? `${data.fromName} <${data.fromAddress}>` : data.fromAddress}`,
-        `To: ${data.toAddresses.join(", ")}`,
-        data.ccAddresses.length > 0 ? `Cc: ${data.ccAddresses.join(", ")}` : null,
-        `Date: ${data.receivedAt}`,
-        `Subject: ${data.subject}`,
-    ]
-        .filter((line) => line !== null)
-        .join("\n");
-    return `--- BEGIN MESSAGE ---\n${headers}\n\n${data.bodyPreview}\n--- END MESSAGE ---`;
-}
-/**
- * Find the thread KD that already contains the given message-id in its
- * messageIds array, scoped to one account. Returns null when no match
- * (the message starts a new thread or is an out-of-order reply whose
- * parent thread has not yet been ingested).
- */
-async function findThreadByMessageId(messageId, accountId) {
-    const session = getSession();
-    try {
-        const result = await session.run(`MATCH (kd:KnowledgeDocument {source: 'email', accountId: $accountId})
-       WHERE $messageId IN kd.messageIds
-       RETURN kd.attachmentId AS attachmentId, kd.body AS body,
-              kd.messageIds AS messageIds,
-              kd.messages AS messagesJson,
-              kd.firstReceivedAt AS firstReceivedAt,
-              kd.lastReceivedAt AS lastReceivedAt
-       LIMIT 1`, { messageId, accountId });
-        if (result.records.length === 0)
-            return null;
-        const record = result.records[0];
-        return {
-            attachmentId: record.get("attachmentId"),
-            body: record.get("body"),
-            messageIds: record.get("messageIds"),
-            messagesJson: record.get("messagesJson") ?? "[]",
-            firstReceivedAt: record.get("firstReceivedAt"),
-            lastReceivedAt: record.get("lastReceivedAt"),
-        };
-    }
-    finally {
-        await session.close();
-    }
-}
-/**
- * Ingest one IMAP message into the per-thread :KnowledgeDocument.
- *
- *  - If the message's In-Reply-To points to a known thread KD, the
- *    message is appended (body grows, messageIds grows, lastReceivedAt
- *    advances).
- *  - Otherwise, a new thread KD is created with this message as root.
- *
- * Person, address-edge, anchor, and embedding writes always run.
- * Discarded-screening messages skip embedding to keep vector search clean.
- */
-export async function storeEmailMessage(data) {
-    const messageId = stripAngleBrackets(data.messageId) ?? `synthetic:${deriveFallbackAttachmentId(data)}`;
-    const inReplyTo = stripAngleBrackets(data.inReplyTo);
-    const existing = inReplyTo ? await findThreadByMessageId(inReplyTo, data.accountId) : null;
-    const attachmentId = existing
-        ? existing.attachmentId
-        : deriveThreadAttachmentId(data.accountId, messageId);
-    // Already ingested? Idempotent skip — caught by messageIds-contains check.
-    if (existing && existing.messageIds.includes(messageId)) {
-        return { attachmentId, created: false, appended: false };
-    }
-    // Build new body + metadata (append or create).
-    const messageBlock = renderMessageBlock(data, messageId);
-    const newBody = existing ? `${existing.body}\n\n${messageBlock}` : messageBlock;
-    const newMessageIds = existing ? [...existing.messageIds, messageId] : [messageId];
-    const newEnvelope = {
-        messageId,
-        fromAddress: data.fromAddress,
-        fromName: data.fromName,
-        toAddresses: data.toAddresses,
-        ccAddresses: data.ccAddresses,
-        subject: data.subject,
-        receivedAt: data.receivedAt,
-        uid: data.uid,
-        mailbox: data.mailbox,
-    };
-    const existingMessages = existing
-        ? JSON.parse(existing.messagesJson)
-        : [];
-    const newMessages = [...existingMessages, newEnvelope];
-    const newLastReceivedAt = existing && data.receivedAt < existing.lastReceivedAt
-        ? existing.lastReceivedAt
-        : data.receivedAt;
-    const newFirstReceivedAt = existing && data.receivedAt > existing.firstReceivedAt
-        ? existing.firstReceivedAt
-        : data.receivedAt;
-    // Embedding: skip discarded messages so vector search stays clean.
-    let embedding = [];
-    if (data.screening !== "discarded") {
-        const embeddingText = [data.subject, data.bodyPreview].filter(Boolean).join(" — ");
-        embedding = await computeEmbedding(embeddingText);
-    }
-    const nowIso = new Date().toISOString();
-    // Collect addresses for Person/edge MERGE. Sender first so :FROM gets a
-    // displayName when only the sender carries one.
-    const addressRows = [
-        { address: data.fromAddress, displayName: data.fromName, edge: "FROM" },
-        ...data.toAddresses.map((address) => ({
-            address,
-            displayName: null,
-            edge: "TO",
-        })),
-        ...data.ccAddresses.map((address) => ({
-            address,
-            displayName: null,
-            edge: "CC",
-        })),
-    ]
-        .filter((row) => row.address && row.address.length > 0)
-        .map((row) => ({ ...row, address: normaliseAddress(row.address) }));
-    const session = getSession();
-    try {
-        await session.run(`MERGE (kd:KnowledgeDocument {attachmentId: $attachmentId})
-       ON CREATE SET
-         kd.source = 'email',
-         kd.scope = 'admin',
-         kd.accountId = $accountId,
-         kd.subject = $subject,
-         kd.createdAt = $nowIso,
-         kd.firstReceivedAt = $firstReceivedAt,
-         kd.screening = $screening,
-         kd.screeningReason = $screeningReason,
-         kd.promptInjectionFlag = $promptInjectionFlag
-       SET kd.body = $body,
-           kd.messageIds = $messageIds,
-           kd.messages = $messagesJson,
-           kd.lastReceivedAt = $lastReceivedAt,
-           kd.updatedAt = $nowIso
-       WITH kd
-       MERGE (ea:EmailAccount {accountId: $accountId})
-       MERGE (kd)-[:RECEIVED_BY]->(ea)`, {
-            attachmentId,
-            accountId: data.accountId,
-            subject: data.subject,
-            body: newBody,
-            messageIds: newMessageIds,
-            messagesJson: JSON.stringify(newMessages),
-            firstReceivedAt: newFirstReceivedAt,
-            lastReceivedAt: newLastReceivedAt,
-            nowIso,
-            screening: data.screening ?? null,
-            screeningReason: data.screeningReason ?? null,
-            promptInjectionFlag: data.promptInjectionFlag ?? null,
-        });
-        // Persons + address edges. UNWIND so one round-trip handles every address.
-        if (addressRows.length > 0) {
-            await session.run(`UNWIND $rows AS row
-         MERGE (p:Person {email: row.address})
-         ON CREATE SET p.displayName = row.displayName,
-                       p.scope = 'admin',
-                       p.accountId = $accountId,
-                       p.createdAt = $nowIso
-         WITH p, row
-         MATCH (kd:KnowledgeDocument {attachmentId: $attachmentId})
-         CALL {
-           WITH kd, p, row
-           WITH kd, p, row WHERE row.edge = 'FROM'
-           MERGE (kd)-[:FROM]->(p)
-         }
-         CALL {
-           WITH kd, p, row
-           WITH kd, p, row WHERE row.edge = 'TO'
-           MERGE (kd)-[:TO]->(p)
-         }
-         CALL {
-           WITH kd, p, row
-           WITH kd, p, row WHERE row.edge = 'CC'
-           MERGE (kd)-[:CC]->(p)
-         }`, { rows: addressRows, attachmentId, accountId: data.accountId, nowIso });
-        }
-        // Embedding written separately so the large vector doesn't go through the
-        // main MERGE params (some Neo4j versions reject very-large Cypher params).
-        if (embedding.length > 0) {
-            await session.run(`MATCH (kd:KnowledgeDocument {attachmentId: $attachmentId})
-         SET kd.embedding = $embedding`, { attachmentId, embedding });
-        }
-        return { attachmentId, created: !existing, appended: !!existing };
-    }
-    catch (err) {
-        if (err instanceof neo4j.Neo4jError &&
-            err.code === "Neo.ClientError.Schema.ConstraintValidationFailed") {
-            // Race: two concurrent writes for the same attachmentId. Treat as duplicate.
-            console.error(`[email-fetch] INFO: constraint caught duplicate attachmentId=${attachmentId} accountId=${data.accountId}`);
-            return { attachmentId, created: false, appended: false };
-        }
-        throw err;
-    }
-    finally {
-        await session.close();
-    }
-}
-/**
- * Ingest a batch of IMAP messages. Returns aggregate counts.
- *
- * Threads are intentionally not reordered — messages are processed in
- * input order. Callers that want chronological transcript shape should
- * pre-sort by `receivedAt` ascending.
- */
-export async function storeEmailMessages(messages) {
-    let threadsCreated = 0;
-    let messagesAppended = 0;
-    let duplicates = 0;
-    for (const message of messages) {
-        const result = await storeEmailMessage(message);
-        if (result.created) {
-            threadsCreated++;
-        }
-        else if (result.appended) {
-            messagesAppended++;
-        }
-        else {
-            duplicates++;
-        }
-    }
-    return { threadsCreated, messagesAppended, duplicates };
-}
-// ---------------------------------------------------------------------------
-// Read helpers — used by email-reply, email-read, email-search to look
-// individual messages and threads back out of the KD model.
-// ---------------------------------------------------------------------------
-/**
- * Look up a single message envelope by its Message-ID. Walks the thread
- * KD's `messages` array (JSON-encoded). Returns null when the thread KD
- * has not been ingested yet.
- */
-export async function getMessageEnvelope(messageId, accountId) {
-    const normalised = stripAngleBrackets(messageId);
-    if (!normalised)
-        return null;
-    const thread = await findThreadByMessageId(normalised, accountId);
-    if (!thread)
-        return null;
-    const messages = JSON.parse(thread.messagesJson);
-    return messages.find((m) => m.messageId === normalised) ?? null;
-}
-/**
- * Given a set of messageIds, locate each one inside its thread KD and
- * report:
- *   - threadId  — the thread KD's attachmentId
- *   - threadDepth — position of the message in the KD's messageIds array
- *                   (0 = root). Useful for sorting search hits by thread
- *                   position.
- *
- * Messages whose thread KD has not been ingested are absent from the map.
- */
-export async function getThreadInfo(messageIds, accountId) {
-    if (messageIds.length === 0)
-        return new Map();
-    const normalised = messageIds
-        .map((mid) => stripAngleBrackets(mid))
-        .filter((mid) => mid !== null);
-    if (normalised.length === 0)
-        return new Map();
-    const session = getSession();
-    try {
-        // Index-of-mid is computed inline with a list comprehension so the query
-        // does not depend on the apoc plugin being installed.
-        const result = await session.run(`UNWIND $messageIds AS mid
-       MATCH (kd:KnowledgeDocument {source: 'email', accountId: $accountId})
-       WHERE mid IN kd.messageIds
-       WITH mid, kd.attachmentId AS threadId,
-            [i IN range(0, size(kd.messageIds) - 1) WHERE kd.messageIds[i] = mid | i][0] AS threadDepth
-       RETURN mid AS messageId, threadDepth, threadId`, { messageIds: normalised, accountId });
-        const map = new Map();
-        for (const record of result.records) {
-            const mid = record.get("messageId");
-            map.set(mid, {
-                messageId: mid,
-                threadDepth: neo4j.integer.toNumber(record.get("threadDepth")),
-                threadId: record.get("threadId"),
-            });
-        }
-        return map;
-    }
-    finally {
-        await session.close();
-    }
+export async function getThreadInfo(_messageIds, _accountId) {
+    // Task 442 — per-message thread-depth lookup requires per-message nodes
+    // the new `:ConversationArchive` shape does not store.
+    return new Map();
 }
+// Re-export neo4j so consumers depending on the legacy module surface keep
+// working without churn. The actual neo4j-driver usage is now in
+// conversation-archive-dispatch.ts.
+export { neo4j };
+export { getSession };
 //# sourceMappingURL=graph.js.map

package/payload/platform/plugins/email/mcp/dist/lib/graph.js.map

@@ -1 +1 @@
-{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../src/lib/graph.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../src/lib/graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,MAAM,cAAc,CAAC;AAmCjC;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAoB;IACrD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACrD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAsBD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAAkB,EAClB,UAAkB;IAElB,sEAAsE;IACtE,OAAO,IAAI,CAAC;AACd,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,WAAqB,EACrB,UAAkB;IAElB,wEAAwE;IACxE,uDAAuD;IACvD,OAAO,IAAI,GAAG,EAAE,CAAC;AACnB,CAAC;AAED,2EAA2E;AAC3E,iEAAiE;AACjE,oCAAoC;AACpC,OAAO,EAAE,KAAK,EAAE,CAAC;AACjB,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/payload/platform/plugins/email/mcp/dist/lib/imap.d.ts

@@ -134,7 +134,7 @@ export declare function searchMessages(config: EmailConfig, password: string, qu
     beforeUid?: number;
 }): Promise<PaginatedMessages>;
 /**
- * Result from an incremental email fetch performed by the email-fetch dispatcher.
+ * Result from an incremental email fetch performed by the email-fetch tool.
  * Includes the raw envelope data needed for graph storage (not just display).
  */
 export interface FetchedEmail {

package/payload/platform/plugins/email/mcp/dist/lib/ingest-batch.d.ts

@@ -0,0 +1,23 @@
+/**
+ * In-memory pending batch between email-fetch and email-ingest.
+ *
+ * email-fetch pulls new IMAP messages and stashes them here. email-ingest
+ * reads the stash, writes only the operator-approved subset, and clears it.
+ *
+ * State is per-MCP-server-process, keyed by accountId. The server runs for
+ * the lifetime of a session, so the two tools share state across turns
+ * within one conversation. Restart drops the batch — the operator just
+ * runs "check my emails" again, which is the intended human-in-the-loop
+ * cadence.
+ */
+import type { FetchedEmail } from "./imap.js";
+export interface PendingBatch {
+    uidValidity: number;
+    maxUid: number;
+    recipientAddress: string;
+    messages: FetchedEmail[];
+}
+export declare function putBatch(accountId: string, batch: PendingBatch): void;
+export declare function takeBatch(accountId: string): PendingBatch | null;
+export declare function peekBatch(accountId: string): PendingBatch | null;
+//# sourceMappingURL=ingest-batch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ingest-batch.d.ts","sourceRoot":"","sources":["../../src/lib/ingest-batch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAID,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAErE;AAED,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAKhE;AAED,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAEhE"}

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

@@ -0,0 +1,15 @@
+const batches = new Map();
+export function putBatch(accountId, batch) {
+    batches.set(accountId, batch);
+}
+export function takeBatch(accountId) {
+    const b = batches.get(accountId);
+    if (!b)
+        return null;
+    batches.delete(accountId);
+    return b;
+}
+export function peekBatch(accountId) {
+    return batches.get(accountId) ?? null;
+}
+//# sourceMappingURL=ingest-batch.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ingest-batch.js","sourceRoot":"","sources":["../../src/lib/ingest-batch.ts"],"names":[],"mappings":"AAqBA,MAAM,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;AAEhD,MAAM,UAAU,QAAQ,CAAC,SAAiB,EAAE,KAAmB;IAC7D,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,SAAiB;IACzC,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACjC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC1B,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,SAAiB;IACzC,OAAO,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;AACxC,CAAC"}

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

@@ -0,0 +1,6 @@
+export interface EmailClassifyParams {
+    accountId: string;
+    rootMessageId: string;
+}
+export declare function emailClassify(params: EmailClassifyParams): Promise<string>;
+//# sourceMappingURL=email-classify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"email-classify.d.ts","sourceRoot":"","sources":["../../src/tools/email-classify.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAuCD,wBAAsB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CA8DhF"}

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

@@ -0,0 +1,89 @@
+import { createHash } from "node:crypto";
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { getSession } from "../lib/neo4j.js";
+// ---------------------------------------------------------------------------
+// email-classify — operator-solicited reclassify for one email-thread
+// :KnowledgeDocument keyed by its root Message-ID. Thin wrapper over the
+// generic kd-classify primitive (memory plugin): derives the
+// account-scoped attachmentId, runs the same body-growth gate, stages the
+// thread body to a temp file, and returns a dispatch envelope the admin
+// agent uses to hand off to the `librarian` specialist.
+//
+// The gate threshold and envelope shape mirror
+// `platform/plugins/memory/mcp/src/lib/kd-classify-gate.ts`; the two copies
+// are duplicated rather than cross-plugin-imported so each MCP process boots
+// independently. Keep both aligned when the contract changes. Task 401.
+// ---------------------------------------------------------------------------
+const KD_CLASSIFY_GROWTH_THRESHOLD = 0.25;
+function deriveThreadAttachmentId(accountId, rootMessageId) {
+    return createHash("sha256")
+        .update(`email:${accountId}:${rootMessageId}`)
+        .digest("hex");
+}
+async function readThread(accountId, attachmentId) {
+    const session = getSession();
+    try {
+        const result = await session.run(`MATCH (kd:KnowledgeDocument { source: 'email', accountId: $accountId, attachmentId: $attachmentId })
+       RETURN coalesce(size(kd.body), 0) AS bodyLen,
+              coalesce(kd.lastClassifiedBodyLength, 0) AS lastLen,
+              kd.body AS body`, { accountId, attachmentId });
+        if (result.records.length === 0)
+            return null;
+        const r = result.records[0];
+        return {
+            bodyLen: Number(r.get("bodyLen")),
+            lastClassifiedBodyLength: Number(r.get("lastLen")),
+            body: r.get("body") ?? "",
+        };
+    }
+    finally {
+        await session.close();
+    }
+}
+export async function emailClassify(params) {
+    const { accountId, rootMessageId } = params;
+    if (!rootMessageId.trim()) {
+        throw new Error("email-classify: rootMessageId is required.");
+    }
+    const attachmentId = deriveThreadAttachmentId(accountId, rootMessageId);
+    const meta = await readThread(accountId, attachmentId);
+    if (!meta) {
+        throw new Error(`email-classify: no email-thread :KnowledgeDocument for rootMessageId=${rootMessageId} in account ${accountId}. Have you run email-fetch + email-ingest first?`);
+    }
+    if (meta.bodyLen === 0) {
+        throw new Error(`email-classify: thread KD for rootMessageId=${rootMessageId} has empty body; cannot classify.`);
+    }
+    const lastLen = meta.lastClassifiedBodyLength;
+    const growthPct = lastLen > 0 ? (meta.bodyLen - lastLen) / lastLen : 1;
+    const isFirstClassify = lastLen <= 0;
+    const shouldProceed = isFirstClassify || growthPct >= KD_CLASSIFY_GROWTH_THRESHOLD;
+    process.stderr.write(`[email-classify] attachmentId=${attachmentId.slice(0, 12)} bodyLen=${meta.bodyLen} lastLen=${lastLen} growthPct=${growthPct.toFixed(3)} action=${shouldProceed ? "proceed" : "skip"}\n`);
+    if (!shouldProceed) {
+        const pctRounded = Math.round(growthPct * 100);
+        return `no classification needed (body grew ${pctRounded}% since last ingest; threshold ${Math.round(KD_CLASSIFY_GROWTH_THRESHOLD * 100)}%)`;
+    }
+    const accountDir = process.env.ACCOUNT_DIR;
+    if (!accountDir) {
+        throw new Error(`email-classify: ACCOUNT_DIR env not set; cannot stage thread body for librarian dispatch.`);
+    }
+    const tempFilePath = `${accountDir}/tmp/kd-classify-${attachmentId}.txt`;
+    await mkdir(dirname(tempFilePath), { recursive: true });
+    await writeFile(tempFilePath, meta.body, "utf-8");
+    const growthLabel = isFirstClassify
+        ? "first classify"
+        : `${Math.round(growthPct * 100)}% growth since last ingest`;
+    return [
+        `Ready to classify email :KnowledgeDocument into sections.`,
+        `attachmentId: ${attachmentId}`,
+        `rootMessageId: ${rootMessageId}`,
+        `bodyLen: ${meta.bodyLen} chars (${growthLabel})`,
+        `tempFilePath: ${tempFilePath}`,
+        ``,
+        `Next: dispatch the \`librarian\` specialist via the Task tool with this brief —`,
+        `  "Ingest the document at ${tempFilePath} using mode=document, attachmentId=${attachmentId},`,
+        `   anchor=LocalBusiness. The :KnowledgeDocument already exists and has source=email;`,
+        `   memory-ingest will MERGE by attachmentId and write :Section children, replacing any prior."`,
+    ].join("\n");
+}
+//# sourceMappingURL=email-classify.js.map

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

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

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

@@ -0,0 +1,15 @@
+interface FetchParams {
+    accountId: string;
+    since_uid?: number;
+}
+/**
+ * List new inbox messages since a UID high-water mark, without writing to
+ * the graph. Caches the batch in-memory so a follow-up email-ingest call
+ * can apply operator decisions.
+ *
+ * No classification, no embeddings, no graph writes. The operator triages
+ * by eye from the returned summary.
+ */
+export declare function emailFetch(params: FetchParams): Promise<string>;
+export {};
+//# sourceMappingURL=email-fetch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"email-fetch.d.ts","sourceRoot":"","sources":["../../src/tools/email-fetch.ts"],"names":[],"mappings":"AAIA,UAAU,WAAW;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CA+CrE"}

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

@@ -0,0 +1,49 @@
+import { loadCredentials, readPollState } from "../lib/credentials.js";
+import { fetchSinceUid } from "../lib/imap.js";
+import { putBatch } from "../lib/ingest-batch.js";
+/**
+ * List new inbox messages since a UID high-water mark, without writing to
+ * the graph. Caches the batch in-memory so a follow-up email-ingest call
+ * can apply operator decisions.
+ *
+ * No classification, no embeddings, no graph writes. The operator triages
+ * by eye from the returned summary.
+ */
+export async function emailFetch(params) {
+    const credResult = await loadCredentials(params.accountId);
+    if ("error" in credResult)
+        throw new Error(credResult.error);
+    const { config, password } = credResult.credentials;
+    const pollState = await readPollState(params.accountId);
+    const sinceUid = params.since_uid ?? pollState?.lastFetchedUid ?? 0;
+    const { uidValidity, emails, maxUid } = await fetchSinceUid(config, password, sinceUid, config.agentAddress);
+    console.error(`[email-fetch] tag=email-fetch listed=${emails.length} sinceUid=${sinceUid}`);
+    if (emails.length === 0) {
+        return `No new messages since UID ${sinceUid}.`;
+    }
+    // Stash for the follow-up email-ingest call.
+    putBatch(params.accountId, {
+        uidValidity,
+        maxUid,
+        recipientAddress: config.agentAddress,
+        messages: emails,
+    });
+    const lines = emails.map((m) => {
+        const header = [
+            `UID: ${m.uid}`,
+            `Message-ID: ${m.messageId ?? "(missing)"}`,
+            `From: ${m.fromName ? `${m.fromName} <${m.fromAddress}>` : m.fromAddress}`,
+            `Subject: ${m.subject}`,
+            `Date: ${m.date}`,
+        ].join("\n");
+        const body = m.bodyPreview ? `\n\n${m.bodyPreview}` : "";
+        return `${header}${body}\n---`;
+    }).join("\n\n");
+    const footer = [
+        "",
+        `Listed ${emails.length} new message(s) since UID ${sinceUid}. Nothing has been written to the graph.`,
+        `Call email-ingest with a disposition ("ingest" or "discard") for every Message-ID above to apply the operator's decisions.`,
+    ].join("\n");
+    return `${lines}\n${footer}`;
+}
+//# sourceMappingURL=email-fetch.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"email-fetch.js","sourceRoot":"","sources":["../../src/tools/email-fetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAOlD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAmB;IAClD,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC3D,IAAI,OAAO,IAAI,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC7D,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC;IAEpD,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,IAAI,SAAS,EAAE,cAAc,IAAI,CAAC,CAAC;IAEpE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CACzD,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,YAAY,CAChD,CAAC;IAEF,OAAO,CAAC,KAAK,CACX,wCAAwC,MAAM,CAAC,MAAM,aAAa,QAAQ,EAAE,CAC7E,CAAC;IAEF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,6BAA6B,QAAQ,GAAG,CAAC;IAClD,CAAC;IAED,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE;QACzB,WAAW;QACX,MAAM;QACN,gBAAgB,EAAE,MAAM,CAAC,YAAY;QACrC,QAAQ,EAAE,MAAM;KACjB,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG;YACb,QAAQ,CAAC,CAAC,GAAG,EAAE;YACf,eAAe,CAAC,CAAC,SAAS,IAAI,WAAW,EAAE;YAC3C,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;YAC1E,YAAY,CAAC,CAAC,OAAO,EAAE;YACvB,SAAS,CAAC,CAAC,IAAI,EAAE;SAClB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,OAAO,GAAG,MAAM,GAAG,IAAI,OAAO,CAAC;IACjC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,MAAM,MAAM,GAAG;QACb,EAAE;QACF,UAAU,MAAM,CAAC,MAAM,6BAA6B,QAAQ,0CAA0C;QACtG,4HAA4H;KAC7H,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,OAAO,GAAG,KAAK,KAAK,MAAM,EAAE,CAAC;AAC/B,CAAC"}

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

@@ -0,0 +1,20 @@
+export interface IngestDecision {
+    messageId: string;
+    disposition: "ingest" | "discard";
+}
+interface IngestParams {
+    accountId: string;
+    decisions: IngestDecision[];
+}
+/**
+ * Apply operator decisions to the most recent email-fetch batch.
+ *
+ * - Every pending message must have a decision; missing IDs cause refusal
+ *   so messages never silently fall through the high-water mark.
+ * - Only "ingest" entries are written to the graph; "discard" entries
+ *   advance the high-water mark without persisting anything.
+ * - The cached batch is consumed (taken, not peeked) only on success.
+ */
+export declare function emailIngest(params: IngestParams): Promise<string>;
+export {};
+//# sourceMappingURL=email-ingest.d.ts.map

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

@@ -0,0 +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"}