@rubytech/create-maxy-code 0.1.496 → 0.1.498

package/payload/platform/plugins/outlook/mcp/dist/lib/conversation-archive-dispatch.js

@@ -0,0 +1,143 @@
+import { spawnSync } from "node:child_process";
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join, resolve } from "node:path";
+import { randomUUID } from "node:crypto";
+import { getSession } from "./neo4j.js";
+function ingestBashPath() {
+    const platformRoot = process.env.PLATFORM_ROOT ?? resolve(import.meta.dirname, "../../../..");
+    return resolve(platformRoot, "plugins/memory/bin/conversation-archive-ingest.sh");
+}
+/**
+ * Group messages into threads by Graph conversationId. A message with no
+ * conversationId falls back to its own messageId key, so it stands alone
+ * rather than colliding with other conversation-less messages.
+ */
+export function groupByThread(messages) {
+    const groups = new Map();
+    for (const m of messages) {
+        const rootKey = m.conversationId && m.conversationId.length > 0
+            ? `conv:${m.conversationId}`
+            : `msg:${m.messageId}`;
+        let g = groups.get(rootKey);
+        if (!g) {
+            g = { rootKey, messages: [], addresses: [] };
+            groups.set(rootKey, g);
+        }
+        g.messages.push(m);
+    }
+    for (const g of groups.values()) {
+        g.messages.sort((a, b) => a.receivedDateTime.localeCompare(b.receivedDateTime));
+        const addrs = new Set();
+        for (const m of g.messages) {
+            if (m.fromAddress)
+                addrs.add(m.fromAddress.trim().toLowerCase());
+            for (const a of m.toAddresses)
+                addrs.add(a.trim().toLowerCase());
+            for (const a of m.ccAddresses)
+                addrs.add(a.trim().toLowerCase());
+        }
+        g.addresses = [...addrs].filter((a) => a.length > 0).sort();
+    }
+    return [...groups.values()];
+}
+/** Thread JSON shape consumed by the `email` normaliser: [{from:{name,email},date,bodyText}]. */
+export function buildThreadJson(thread) {
+    return thread.messages.map((m) => ({
+        from: { name: m.fromName ?? null, email: m.fromAddress },
+        date: m.receivedDateTime,
+        bodyText: m.bodyText,
+    }));
+}
+async function resolveAddresses(addresses, accountId) {
+    const map = new Map();
+    if (addresses.length === 0)
+        return map;
+    const session = getSession();
+    try {
+        const r = await session.run(`UNWIND $addresses AS addr
+       OPTIONAL MATCH (p) WHERE (p:Person OR p:AdminUser)
+         AND p.accountId = $accountId
+         AND toLower(p.email) = addr
+       WITH addr, p
+       WHERE p IS NOT NULL
+       RETURN addr, elementId(p) AS eid`, { addresses, accountId });
+        for (const rec of r.records) {
+            map.set(rec.get("addr"), rec.get("eid"));
+        }
+    }
+    finally {
+        await session.close();
+    }
+    return map;
+}
+export async function dispatchOutlookMessagesToConversationArchive(messages) {
+    if (messages.length === 0) {
+        return { threadsDispatched: 0, threadsSkipped: 0, unresolvedAddresses: [] };
+    }
+    const accountId = messages[0].accountId;
+    const threads = groupByThread(messages);
+    const distinct = new Set();
+    for (const t of threads)
+        for (const a of t.addresses)
+            distinct.add(a);
+    const resolved = await resolveAddresses([...distinct], accountId);
+    let threadsDispatched = 0;
+    let threadsSkipped = 0;
+    const unresolved = new Set();
+    for (const thread of threads) {
+        const ids = [];
+        let ok = true;
+        for (const addr of thread.addresses) {
+            const eid = resolved.get(addr);
+            if (!eid) {
+                unresolved.add(addr);
+                ok = false;
+                continue;
+            }
+            ids.push(eid);
+        }
+        if (!ok) {
+            threadsSkipped += 1;
+            continue;
+        }
+        const tmpDir = mkdtempSync(join(tmpdir(), "outlook-thread-"));
+        const jsonPath = join(tmpDir, `thread-${thread.rootKey.replace(/[^a-z0-9-]+/gi, "_")}.json`);
+        try {
+            writeFileSync(jsonPath, JSON.stringify(buildThreadJson(thread)));
+            const exit = spawnSync("bash", [
+                ingestBashPath(),
+                jsonPath,
+                "--source",
+                "email",
+                "--participant-person-ids",
+                ids.join(","),
+                "--scope",
+                "admin",
+                "--session-id",
+                `outlook-${randomUUID()}`,
+            ], { stdio: ["ignore", "pipe", "inherit"] });
+            if (exit.status === 0) {
+                threadsDispatched += 1;
+                console.error(`[outlook-mcp] mail-ingest op=thread-dispatched root=${thread.rootKey} messages=${thread.messages.length} participants=${ids.length}`);
+            }
+            else {
+                threadsSkipped += 1;
+                // status is null when spawnSync itself failed to launch (bad path,
+                // ENOENT); surface exit.error so a launch failure is not reported as a
+                // silent skip with no cause. Dropping the error body would blind the
+                // operator to why every thread skipped.
+                console.error(`[outlook-mcp] mail-ingest op=thread-failed root=${thread.rootKey} status=${exit.status} err=${exit.error?.message ?? "none"}`);
+            }
+        }
+        finally {
+            rmSync(tmpDir, { recursive: true, force: true });
+        }
+    }
+    return {
+        threadsDispatched,
+        threadsSkipped,
+        unresolvedAddresses: [...unresolved].sort(),
+    };
+}
+//# sourceMappingURL=conversation-archive-dispatch.js.map

package/payload/platform/plugins/outlook/mcp/dist/lib/conversation-archive-dispatch.js.map

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

package/payload/platform/plugins/outlook/mcp/dist/lib/neo4j.d.ts

@@ -0,0 +1,5 @@
+import { Driver, Session } from "neo4j-driver";
+export declare function getDriver(): Driver;
+export declare function getSession(): Session;
+export declare function closeDriver(): Promise<void>;
+//# sourceMappingURL=neo4j.d.ts.map

package/payload/platform/plugins/outlook/mcp/dist/lib/neo4j.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"neo4j.d.ts","sourceRoot":"","sources":["../../src/lib/neo4j.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AA8BtD,wBAAgB,SAAS,IAAI,MAAM,CAclC;AAED,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAKjD"}

package/payload/platform/plugins/outlook/mcp/dist/lib/neo4j.js

@@ -0,0 +1,44 @@
+import neo4j from "neo4j-driver";
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+// Minimal Neo4j accessor for the outlook plugin (Task 1656 — the plugin's
+// first Neo4j coupling). Mirrors plugins/email/mcp/src/lib/neo4j.ts: the URI
+// must be explicit (a silent bolt://localhost:7687 default was the vector for
+// orphan data across installs), and module init never touches the network —
+// the guard lives inside getDriver, so importing this file throws nothing even
+// when the plugin-system spawn enumerates with empty env.
+let driver = null;
+function readPassword() {
+    if (process.env.NEO4J_PASSWORD)
+        return process.env.NEO4J_PASSWORD;
+    const passwordFile = resolve(process.env.PLATFORM_ROOT ?? resolve(import.meta.dirname, "../../../.."), "config/.neo4j-password");
+    try {
+        return readFileSync(passwordFile, "utf-8").trim();
+    }
+    catch {
+        throw new Error(`Neo4j password not found. Expected at ${passwordFile} or in NEO4J_PASSWORD env var.`);
+    }
+}
+export function getDriver() {
+    if (!driver) {
+        const uri = process.env.NEO4J_URI;
+        if (!uri) {
+            throw new Error("[outlook] NEO4J_URI unset — refusing to default to bolt://localhost:7687");
+        }
+        const user = process.env.NEO4J_USER ?? "neo4j";
+        const password = readPassword();
+        console.error(`[outlook] resolved neo4j_uri=${uri}`);
+        driver = neo4j.driver(uri, neo4j.auth.basic(user, password));
+    }
+    return driver;
+}
+export function getSession() {
+    return getDriver().session();
+}
+export async function closeDriver() {
+    if (driver) {
+        await driver.close();
+        driver = null;
+    }
+}
+//# sourceMappingURL=neo4j.js.map

package/payload/platform/plugins/outlook/mcp/dist/lib/neo4j.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"neo4j.js","sourceRoot":"","sources":["../../src/lib/neo4j.ts"],"names":[],"mappings":"AAAA,OAAO,KAA0B,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,0EAA0E;AAC1E,6EAA6E;AAC7E,8EAA8E;AAC9E,4EAA4E;AAC5E,+EAA+E;AAC/E,0DAA0D;AAE1D,IAAI,MAAM,GAAkB,IAAI,CAAC;AAEjC,SAAS,YAAY;IACnB,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAElE,MAAM,YAAY,GAAG,OAAO,CAC1B,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,EACxE,wBAAwB,CACzB,CAAC;IAEF,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,yCAAyC,YAAY,gCAAgC,CACtF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CACb,0EAA0E,CAC3E,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,CAAC;QAC/C,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,gCAAgC,GAAG,EAAE,CAAC,CAAC;QACrD,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,SAAS,EAAE,CAAC,OAAO,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/payload/platform/plugins/outlook/mcp/dist/tools/mail-fetch-body.d.ts

@@ -3,6 +3,7 @@ export interface FetchBodyResult {
     id: string;
     subject: string | null;
     from: string | null;
+    fromName: string | null;
     to: string[];
     cc: string[];
     receivedDateTime: string;
@@ -12,6 +13,19 @@ export interface FetchBodyResult {
     contentType: "html" | "text";
     body: string;
 }
+/**
+ * Map Graph's `from.emailAddress` to the archive's { from, fromName } pair.
+ * Exported so the mapping is unit-testable without a live Graph call.
+ */
+export declare function mapRawFrom(from?: {
+    emailAddress?: {
+        address?: string;
+        name?: string;
+    };
+} | null): {
+    from: string | null;
+    fromName: string | null;
+};
 /**
  * Read the COMPLETE body of one message by id. Graph's bodyPreview (returned by
  * outlook-mail-list/-search) is capped near 255 chars; this requests the full

package/payload/platform/plugins/outlook/mcp/dist/tools/mail-fetch-body.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mail-fetch-body.d.ts","sourceRoot":"","sources":["../../src/tools/mail-fetch-body.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAMhE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAkBD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAC1B,OAAO,CAAC,eAAe,CAAC,CAmC1B"}
+{"version":3,"file":"mail-fetch-body.d.ts","sourceRoot":"","sources":["../../src/tools/mail-fetch-body.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAMhE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAkBD;;;GAGG;AACH,wBAAgB,UAAU,CACxB,IAAI,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAAG,IAAI,GACnE;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAKlD;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAC1B,OAAO,CAAC,eAAe,CAAC,CAqC1B"}

package/payload/platform/plugins/outlook/mcp/dist/tools/mail-fetch-body.js

@@ -3,6 +3,16 @@ import { htmlToText } from "../lib/html-to-text.js";
 import { log } from "../lib/log.js";
 import { addrs } from "../lib/recipients.js";
 const SELECT = "id,subject,from,toRecipients,ccRecipients,receivedDateTime,conversationId,isRead,hasAttachments,body";
+/**
+ * Map Graph's `from.emailAddress` to the archive's { from, fromName } pair.
+ * Exported so the mapping is unit-testable without a live Graph call.
+ */
+export function mapRawFrom(from) {
+    return {
+        from: from?.emailAddress?.address ?? null,
+        fromName: from?.emailAddress?.name ?? null,
+    };
+}
 /**
  * Read the COMPLETE body of one message by id. Graph's bodyPreview (returned by
  * outlook-mail-list/-search) is capped near 255 chars; this requests the full
@@ -24,10 +34,12 @@ export async function runMailFetchBody(config, args) {
         bytes: body.length,
         contentType,
     });
+    const fromMapped = mapRawFrom(msg.from);
     return {
         id: msg.id,
         subject: msg.subject ?? null,
-        from: msg.from?.emailAddress?.address ?? null,
+        from: fromMapped.from,
+        fromName: fromMapped.fromName,
         to: addrs(msg.toRecipients),
         cc: addrs(msg.ccRecipients),
         receivedDateTime: msg.receivedDateTime,

package/payload/platform/plugins/outlook/mcp/dist/tools/mail-fetch-body.js.map

@@ -1 +1 @@
-{"version":3,"file":"mail-fetch-body.js","sourceRoot":"","sources":["../../src/tools/mail-fetch-body.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,EAAE,KAAK,EAAqB,MAAM,sBAAsB,CAAC;AA6BhE,MAAM,MAAM,GACV,sGAAsG,CAAC;AAEzG;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAyB,EACzB,IAA2B;IAE3B,MAAM,IAAI,GAAG,gBAAgB,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;IAClE,MAAM,GAAG,GAAG,MAAM,SAAS,CACzB,MAAM,EACN,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAe,EAC7E,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,IAAI,EAAE,CAC1C,CAAC;IAEF,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IAChE,MAAM,WAAW,GAAoB,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAC1E,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,WAAW,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAE5D,GAAG,CAAC;QACF,KAAK,EAAE,iBAAiB;QACxB,EAAE,EAAE,YAAY;QAChB,OAAO,EAAE,MAAM,CAAC,SAAS;QACzB,EAAE,EAAE,IAAI,CAAC,SAAS;QAClB,KAAK,EAAE,IAAI,CAAC,MAAM;QAClB,WAAW;KACZ,CAAC,CAAC;IAEH,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI;QAC5B,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,IAAI,IAAI;QAC7C,EAAE,EAAE,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC;QAC3B,EAAE,EAAE,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC;QAC3B,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;QACtC,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,IAAI;QAC1C,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,KAAK;QAC3B,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,KAAK;QAC3C,WAAW;QACX,IAAI;KACL,CAAC;AACJ,CAAC"}
+{"version":3,"file":"mail-fetch-body.js","sourceRoot":"","sources":["../../src/tools/mail-fetch-body.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,EAAE,KAAK,EAAqB,MAAM,sBAAsB,CAAC;AA8BhE,MAAM,MAAM,GACV,sGAAsG,CAAC;AAEzG;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,IAAoE;IAEpE,OAAO;QACL,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,IAAI,IAAI;QACzC,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,IAAI,IAAI;KAC3C,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAyB,EACzB,IAA2B;IAE3B,MAAM,IAAI,GAAG,gBAAgB,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;IAClE,MAAM,GAAG,GAAG,MAAM,SAAS,CACzB,MAAM,EACN,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAe,EAC7E,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,IAAI,EAAE,CAC1C,CAAC;IAEF,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IAChE,MAAM,WAAW,GAAoB,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAC1E,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,WAAW,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAE5D,GAAG,CAAC;QACF,KAAK,EAAE,iBAAiB;QACxB,EAAE,EAAE,YAAY;QAChB,OAAO,EAAE,MAAM,CAAC,SAAS;QACzB,EAAE,EAAE,IAAI,CAAC,SAAS;QAClB,KAAK,EAAE,IAAI,CAAC,MAAM;QAClB,WAAW;KACZ,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI;QAC5B,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,EAAE,EAAE,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC;QAC3B,EAAE,EAAE,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC;QAC3B,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;QACtC,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,IAAI;QAC1C,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,KAAK;QAC3B,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,KAAK;QAC3C,WAAW;QACX,IAAI;KACL,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,27 @@
+import type { GraphClientConfig } from "../lib/graph-client.js";
+export interface IngestDecision {
+    messageId: string;
+    disposition: "ingest" | "discard";
+}
+/**
+ * Split decisions into ingest ids + a discard count. Refuses an empty array
+ * (nothing to do) or a duplicate messageId (ambiguous disposition) so the
+ * operator re-issues a clean set rather than a silent partial ingest. Unlike
+ * email-ingest there is no staged batch or high-water mark to guard: the ids
+ * are explicit and the per-message decision holds over exactly this call.
+ */
+export declare function validateDecisions(decisions: IngestDecision[]): {
+    toIngest: string[];
+    discarded: number;
+};
+/**
+ * Write operator-reviewed messages into the business graph. For each `ingest`
+ * decision the full body + envelope is fetched, threads are grouped by
+ * conversationId, participants are resolved closed-set against Neo4j, and each
+ * resolvable thread is dispatched through the shared conversation-archive
+ * script. Unresolved-address threads are skipped and reported.
+ */
+export declare function runMailIngest(config: GraphClientConfig, params: {
+    decisions: IngestDecision[];
+}): Promise<string>;
+//# sourceMappingURL=mail-ingest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mail-ingest.d.ts","sourceRoot":"","sources":["../../src/tools/mail-ingest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAOhE,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,QAAQ,GAAG,SAAS,CAAC;CACnC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,cAAc,EAAE,GAC1B;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAsB3C;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE;IAAE,SAAS,EAAE,cAAc,EAAE,CAAA;CAAE,GACtC,OAAO,CAAC,MAAM,CAAC,CAwCjB"}

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

@@ -0,0 +1,69 @@
+import { runMailFetchBody } from "./mail-fetch-body.js";
+import { dispatchOutlookMessagesToConversationArchive, } from "../lib/conversation-archive-dispatch.js";
+/**
+ * Split decisions into ingest ids + a discard count. Refuses an empty array
+ * (nothing to do) or a duplicate messageId (ambiguous disposition) so the
+ * operator re-issues a clean set rather than a silent partial ingest. Unlike
+ * email-ingest there is no staged batch or high-water mark to guard: the ids
+ * are explicit and the per-message decision holds over exactly this call.
+ */
+export function validateDecisions(decisions) {
+    if (decisions.length === 0) {
+        throw new Error("Refusing to ingest — no decisions passed. List messages with outlook-mail-list or outlook-mail-search first, then pass a disposition for each.");
+    }
+    const seen = new Set();
+    const toIngest = [];
+    let discarded = 0;
+    for (const d of decisions) {
+        const id = d.messageId.trim();
+        if (!id)
+            throw new Error(`Decision had a blank messageId: ${JSON.stringify(d)}`);
+        if (seen.has(id)) {
+            throw new Error(`Refusing to ingest — duplicate messageId "${id}". Pass one disposition per message.`);
+        }
+        seen.add(id);
+        if (d.disposition === "ingest")
+            toIngest.push(id);
+        else
+            discarded++;
+    }
+    return { toIngest, discarded };
+}
+/**
+ * Write operator-reviewed messages into the business graph. For each `ingest`
+ * decision the full body + envelope is fetched, threads are grouped by
+ * conversationId, participants are resolved closed-set against Neo4j, and each
+ * resolvable thread is dispatched through the shared conversation-archive
+ * script. Unresolved-address threads are skipped and reported.
+ */
+export async function runMailIngest(config, params) {
+    const { toIngest, discarded } = validateDecisions(params.decisions);
+    const messages = [];
+    for (const messageId of toIngest) {
+        const body = await runMailFetchBody(config, { messageId });
+        messages.push({
+            messageId: body.id,
+            conversationId: body.conversationId,
+            fromAddress: body.from,
+            fromName: body.fromName,
+            toAddresses: body.to,
+            ccAddresses: body.cc,
+            subject: body.subject,
+            bodyText: body.body,
+            receivedDateTime: body.receivedDateTime,
+            accountId: config.accountId,
+        });
+        console.error(`[outlook-mcp] mail-ingest op=ingest id=${body.id} conversationId=${body.conversationId ?? "none"} disposition=ingest`);
+    }
+    const { threadsDispatched, threadsSkipped, unresolvedAddresses } = await dispatchOutlookMessagesToConversationArchive(messages);
+    console.error(`[outlook-mcp] mail-ingest op=summary ingested=${toIngest.length} discarded=${discarded} threadsDispatched=${threadsDispatched} threadsSkipped=${threadsSkipped} unresolved=${unresolvedAddresses.length}`);
+    const lines = [
+        `Ingested ${toIngest.length} message(s); discarded ${discarded}.`,
+        `Graph: ${threadsDispatched} thread(s) dispatched to conversation-archive, ${threadsSkipped} skipped.`,
+    ];
+    if (unresolvedAddresses.length > 0) {
+        lines.push(`Unresolved sender/recipient addresses (no :Person or :AdminUser carries these emails — add them to the graph and re-run outlook-mail-ingest to land their threads): ${unresolvedAddresses.join(", ")}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=mail-ingest.js.map

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

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

package/payload/platform/plugins/outlook/mcp/package.json

@@ -11,6 +11,7 @@
   "dependencies": {
     "@microsoft/microsoft-graph-client": "^3.0.7",
     "@modelcontextprotocol/sdk": "^1.12.1",
+    "neo4j-driver": "^5.28.1",
     "zod": "^3.24.0"
   },
   "devDependencies": {

package/payload/platform/plugins/outlook/references/graph-surfaces.md

@@ -76,7 +76,8 @@ Reads the COMPLETE body (not `bodyPreview`). `body.contentType` is `html` or `te
 {
   id: string;
   subject: string | null;
-  from: string | null;
+  from: string | null;          // from.emailAddress.address
+  fromName: string | null;      // from.emailAddress.name (additive) — the sender display name outlook-mail-ingest carries into the archive
   to: string[];                 // toRecipients[].emailAddress.address
   cc: string[];
   receivedDateTime: string;
@@ -124,6 +125,14 @@ Recoverable — moves to Deleted Items, never hard-deletes or expunges. An id al
 
 **Returned shape:** `{ moved: string[]; notMoved: string[] }`.
 
+## outlook-mail-ingest
+
+**No direct Graph mutation.** Per approved message it calls `runMailFetchBody`'s `GET /me/messages/{id}?$select=…,body` to read the full body + envelope (including `conversationId` and the additive `fromName`). The graph write is delegated: threads are grouped by `conversationId`, participants resolve closed-set against Neo4j (`UNWIND $addresses … WHERE (p:Person OR p:AdminUser) AND p.accountId=$accountId AND toLower(p.email)=addr`), and each resolvable thread is written by spawning `plugins/memory/bin/conversation-archive-ingest.sh <thread.json> --source email --participant-person-ids <elementIds> --scope admin --session-id outlook-<uuid>`. The thread JSON is `[{from:{name,email}, date, bodyText}]`, the shape the shared `email` normaliser consumes. An unresolved From/To/Cc address skips its whole thread; no `:Person` is auto-created. This is the plugin's only Neo4j coupling (`neo4j-driver`, `lib/neo4j.ts`).
+
+**Input:** `{ decisions: [{ messageId, disposition: "ingest" | "discard" }], mailbox? }`. Refuses an empty array and a duplicate messageId.
+
+**Returned shape:** a plain-text summary — ingested/discarded counts, threads dispatched/skipped, and any unresolved addresses.
+
 ## outlook-mail-otp-extract
 
 **Endpoints:** `GET /me/mailFolders/Inbox/messages?$top=15&$orderby=receivedDateTime DESC&$select=id,subject,from,receivedDateTime` to list candidates, then `outlook-mail-fetch-body`'s `GET /me/messages/{id}?$select=…,body` per sender-matched candidate. Scans immediately, then polls every 5 s until a code is found or `timeout` seconds (default 60) elapse. `extractOtpFromText` is shared verbatim with the `email` plugin.

package/payload/platform/plugins/outlook/skills/outlook/SKILL.md

@@ -60,6 +60,10 @@ The revoke path below is scoped to one specific, visible failure. It is not a ge
 - `outlook-mail-reply messageId=<id> body=<text>` — reply in-thread. Threads natively (the original conversation is preserved). `replyAll=true` replies to the sender and every original recipient; `cc`/`bcc` add recipients; `attachments` is an array of file paths inside the account directory (up to 25 MB per file). The body is plain text, prepended above the quoted original. Needs `Mail.ReadWrite` + `Mail.Send`.
 - `outlook-mail-delete ids=[<id>...]` — move messages to Deleted Items. RECOVERABLE: it never hard-deletes or expunges, so recovery is possible from the mailbox's Deleted Items. Pass the ids from a prior list/search. An id already gone is reported not-moved without failing the rest. Needs `Mail.ReadWrite`.
 
+## Ingesting mail into memory
+
+Writing operator-reviewed messages into the business graph is the `outlook-mail-ingest` skill (its own SKILL.md), which drives the list, summarise, ask, ingest loop over `outlook-mail-ingest`.
+
 ## One-time codes (OTP)
 
 - `outlook-mail-otp-extract sender=<domain>` — poll the inbox for a verification code from a sender (e.g. `cloudflare.com`). Optional `subjectPattern` (regex) and `timeout` (seconds, default 60). Reads full bodies to extract the code. Used during service authentication.

package/payload/platform/plugins/outlook/skills/outlook-mail-ingest/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: outlook-mail-ingest
+description: "Operator-initiated Outlook mail ingestion. Activate when the operator asks to check, triage, or pull Outlook mail into memory ('check my Outlook', 'ingest these Outlook messages', 'pull that thread into the graph'). Drives a list, summarise, ask, ingest loop using the outlook-mail-list / outlook-mail-search and outlook-mail-ingest tools. Human-in-the-loop: nothing enters the graph without an explicit operator decision per message."
+---
+
+# Outlook mail ingestion
+
+Invoked from `specialists:personal-assistant`.
+
+Operator-initiated, human-in-the-loop ingestion of an Outlook mailbox into the business graph. Reviewed messages become `:ConversationArchive {source:'email'}` threads. A message enters the graph only when the operator says so, and only the ones they pick. There is no background poll, no automatic classifier, no silent writes.
+
+This is the Microsoft Graph analogue of the IMAP `email-ingest` skill. It differs in one structural way: Outlook reads are stateless Graph calls, so there is no staged batch and no high-water mark. You list with the ordinary read tools and pass the exact message ids you want to `outlook-mail-ingest`.
+
+## When to activate
+
+Activate when the operator wants to bring Outlook mail into the agent's memory. Typical phrasings:
+
+- "Check my Outlook."
+- "Ingest these Outlook messages."
+- "Pull that Outlook thread into the graph."
+
+Do not activate for:
+
+- Reading or searching mail already in the mailbox or the graph. Those are `outlook-mail-list`, `outlook-mail-search`, `outlook-mail-fetch-body`.
+- Drafting or sending. Those are `outlook-draft`, `outlook-mail-reply`, `outlook-mail-send`.
+- Setup, status, or OTP extraction. Those are direct tool calls.
+
+## Flow
+
+### 1. List
+
+Call `outlook-mail-list` (or `outlook-mail-search` for a sender or subject filter). Both return a preview per message with its id, sender, subject, and `receivedDateTime`. They write nothing to the graph.
+
+An account can hold more than one mailbox. When it does, every operational tool refuses unless it names one, and the refusal lists the connected mailboxes. That refusal means "say which mailbox", not "there is no mail". Resolve it with `outlook-mailbox-list`, then pass `mailbox` and carry on.
+
+Reads page beyond the newest window. When a response carries a `nextCursor`, older messages remain behind it; pass the cursor back to page on. Absence of a `nextCursor` is the only thing that means you saw everything in range.
+
+### 2. Summarise
+
+Present the listed messages to the operator as a numbered or per-id summary. For each, surface the sender, the subject, and a one-line gist from the preview. Where a message is obviously one or the other, suggest a disposition ("newsletter, looks like discard"; "thread reply from a known correspondent, looks like ingest"). The suggestion is a hint, never an action; the operator decides.
+
+There is no screener. If a message looks like phishing, say so in plain English so the operator can discard it by eye.
+
+### 3. Ask
+
+Ask the operator to confirm a disposition for every message you intend to ingest. Either a blanket call ("ingest all", "discard the rest") that you turn into the per-message map, or an explicit per-message choice ("ingest 1, 2, 4; discard 3"). If the operator answers ambiguously ("the work ones"), restate the messages you think they mean and confirm before proceeding. Never guess.
+
+### 4. Ingest
+
+Call `outlook-mail-ingest` with a `decisions` array: one `{ messageId, disposition }` per message, `disposition` being `ingest` or `discard`. The tool refuses an empty array and refuses a duplicate messageId, so pass a clean set with one disposition per id.
+
+For each `ingest` message the tool fetches the full body and envelope, groups messages into threads by Graph `conversationId`, and resolves every From/To/Cc address closed-set against the graph. An address that does not already resolve to a `:Person` or `:AdminUser` for this account causes its whole thread to skip; the tool returns the unresolved addresses. It never creates a `:Person`.
+
+On success the tool returns a one-line summary: how many were ingested, how many discarded, how many threads dispatched or skipped, and any unresolved addresses.
+
+### 5. Confirm
+
+Echo the tool's summary back to the operator in one sentence. If any thread was skipped for an unresolved address, tell the operator which address, and that adding that person to the graph and re-running will land the thread. If they want to draft a reply to anything just ingested, hand off to the Outlook compose tools.
+
+## Edge cases
+
+| Situation | Behaviour |
+|-----------|-----------|
+| The list returns zero messages | Tell the operator and stop. Do not call `outlook-mail-ingest`. |
+| An address on a thread does not resolve | The thread is skipped and the address is returned. Surface it; the operator adds the person to the graph, then re-runs for that message. |
+| Operator wants to ingest some now and review the rest later | Fine. Ids are explicit, so ingest exactly the ones decided now and list the rest again later. There is no high-water mark to advance and nothing is silently dropped. |
+| Operator abandons mid-flow | Do not call `outlook-mail-ingest`. Nothing was staged and nothing changes. |
+| A tool errors (Graph down, auth failure) | Surface the error verbatim. Do not retry silently. |
+
+## Out of scope
+
+- Automatic re-screening or classification. The operator is the screener.
+- Scheduled or recurring ingestion. The operator initiates every cycle.
+- Attachment ingest. This skill lands text threads only.
+- Other channels. WhatsApp, IMAP email, and the public web have their own ingestion paths.
+
+## Observability
+
+Each ingest emits tagged lines the operator can grep:
+
+- `[outlook-mcp] mail-ingest op=ingest id=<id> conversationId=<id> disposition=ingest` per approved message.
+- `[outlook-mcp] mail-ingest op=thread-dispatched root=<key> messages=<n> participants=<n>` per landed thread.
+- `[outlook-mcp] mail-ingest op=summary ingested=<n> discarded=<m> threadsDispatched=<n> threadsSkipped=<n> unresolved=<n>` once per call.
+
+A complete cycle is greppable as the `[outlook-mcp] mail-ingest` lines for one session. A `threadsSkipped` above zero with an `unresolved` count is the closed-set resolution refusing an unknown participant, not a failure.

package/payload/platform/plugins/sweep/PLUGIN.md

@@ -1,6 +1,9 @@
 ---
 name: sweep
 description: "Catch-up composition. On a catch me up / what did I miss / morning sync / sweep turn, reads every connected surface (inbox, calendar, contacts, and the site captures published sites write to Cloudflare D1), compares against the graph, and proposes graph writes for the operator to approve. Composes work, scheduling, contacts, and memory; adds no tools of its own and never sends."
+skills:
+  - skills/sweep-workflow/SKILL.md
+  - skills/email-graph-sweep/SKILL.md
 metadata: {"platform":{"always":false,"embed":["admin"],"pluginKey":"sweep","optional":true,"recommended":true}}
 ---
 
@@ -10,6 +13,7 @@ Sweep is a catch-up composition. When the operator asks to be caught up, it read
 
 This plugin adds no tools. It composes plugins that already ship: `work` for a new to-do, `scheduling` for a calendar event, `contacts` for a person or organisation, and `memory` for a standalone fact. Each of those plugins writes through its own schema-enforcing tool.
 
-## Skill
+## Skills
 
 - `sweep-workflow` — the read-dedupe-propose-approve-delegate workflow. Triggers on "catch me up", "what did I miss", "morning sync", and "sweep".
+- `email-graph-sweep` — enable or disable a recurring, per-account routine that turns new inbound mail into deduped graph entities and reports over a persistent channel on every fire. Gated on a mailbox connector and a registered persistent-channel destination; it writes where `sweep-workflow` only proposes, and it is opt-in, never auto-provisioned. Triggers on "set up an automatic email sweep", "turn my email into the graph automatically", and the disable equivalents.