@rubytech/create-maxy-code 0.1.0

package/payload/platform/plugins/contacts/mcp/dist/tools/contact-export.js

@@ -0,0 +1,119 @@
+/**
+ * GDPR Subject Access Export (Article 15).
+ *
+ * Gathers all data held on a specific contact across Neo4j stores:
+ *   Person → AccessGrants (via relationship)
+ *   Person → Conversations + Messages (via Person.sessionId → Conversation.conversationId)
+ *   Person → Emails (via Person.email → Email.fromAddress / toAddresses)
+ *
+ * Returns a self-contained JSON document suitable for handing to the data subject.
+ */
+import { getSession } from "../lib/neo4j.js";
+import { resolvePersonMatch } from "../lib/resolve-person.js";
+export async function contactExport(params) {
+    const { nodeId, email, telephone, accountId } = params;
+    const startMs = Date.now();
+    const { matchClause, queryParams } = resolvePersonMatch({ nodeId, email, telephone }, accountId);
+    const session = getSession();
+    try {
+        // Step 1: Resolve Person node
+        const personResult = await session.run(`${matchClause} RETURN p, elementId(p) AS nodeId`, queryParams);
+        if (personResult.records.length === 0) {
+            const identifier = email ?? telephone ?? nodeId ?? "unknown";
+            console.error(JSON.stringify({
+                tool: "contact-export",
+                status: "not-found",
+                identifier,
+                latencyMs: Date.now() - startMs,
+            }));
+            throw new Error("Contact not found");
+        }
+        const personRecord = personResult.records[0];
+        const personNodeId = personRecord.get("nodeId");
+        const personProps = personRecord.get("p").properties;
+        const person = {
+            nodeId: personNodeId,
+            properties: personProps,
+        };
+        // Step 2: Gather AccessGrants via relationship
+        const grantsResult = await session.run(`MATCH (p:Person)-[:HAS_ACCESS]->(g:AccessGrant)
+       WHERE elementId(p) = $personNodeId
+       RETURN g, elementId(g) AS gNodeId`, { personNodeId });
+        const accessGrants = grantsResult.records.map((r) => ({
+            nodeId: r.get("gNodeId"),
+            properties: r.get("g").properties,
+        }));
+        // Step 3: Gather Conversations + Messages via Person.sessionId
+        const conversations = [];
+        const sessionId = personProps.sessionId;
+        if (sessionId) {
+            const convResult = await session.run(`MATCH (c:Conversation {conversationId: $sessionId, accountId: $accountId})
+         RETURN c, elementId(c) AS cNodeId`, { sessionId, accountId });
+            for (const convRecord of convResult.records) {
+                const cNodeId = convRecord.get("cNodeId");
+                const convProps = convRecord.get("c").properties;
+                const msgResult = await session.run(`MATCH (m:Message)-[:PART_OF]->(c:Conversation)
+           WHERE elementId(c) = $cNodeId
+           RETURN m, elementId(m) AS mNodeId
+           ORDER BY m.createdAt ASC`, { cNodeId });
+                const messages = msgResult.records.map((r) => ({
+                    nodeId: r.get("mNodeId"),
+                    properties: r.get("m").properties,
+                }));
+                conversations.push({
+                    nodeId: cNodeId,
+                    properties: convProps,
+                    messages,
+                });
+            }
+        }
+        // Step 4: Gather Emails via Person.email
+        const emails = [];
+        const personEmail = personProps.email;
+        if (personEmail) {
+            const emailResult = await session.run(`MATCH (e:Email {accountId: $accountId})
+         WHERE e.fromAddress = $personEmail OR $personEmail IN e.toAddresses
+         RETURN e, elementId(e) AS eNodeId
+         ORDER BY e.receivedAt DESC`, { personEmail, accountId });
+            for (const r of emailResult.records) {
+                emails.push({
+                    nodeId: r.get("eNodeId"),
+                    properties: r.get("e").properties,
+                });
+            }
+        }
+        const totalMessages = conversations.reduce((sum, c) => sum + c.messages.length, 0);
+        console.error(JSON.stringify({
+            tool: "contact-export",
+            status: "success",
+            identifier: email ?? telephone ?? nodeId,
+            attributionPaths: [
+                ...(sessionId ? ["sessionId"] : []),
+                ...(personEmail ? ["email"] : []),
+            ],
+            counts: {
+                accessGrants: accessGrants.length,
+                conversations: conversations.length,
+                messages: totalMessages,
+                emails: emails.length,
+            },
+            latencyMs: Date.now() - startMs,
+        }));
+        return {
+            person,
+            accessGrants,
+            conversations,
+            emails,
+            summary: {
+                accessGrantCount: accessGrants.length,
+                conversationCount: conversations.length,
+                messageCount: totalMessages,
+                emailCount: emails.length,
+            },
+        };
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=contact-export.js.map

package/payload/platform/plugins/contacts/mcp/dist/tools/contact-export.js.map

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

package/payload/platform/plugins/contacts/mcp/dist/tools/contact-list.d.ts

@@ -0,0 +1,23 @@
+interface ContactListParams {
+    status?: string;
+    source?: string;
+    since?: string;
+    accountId?: string;
+    limit?: number;
+}
+interface ContactSummary {
+    nodeId: string;
+    givenName: string;
+    familyName?: string;
+    email?: string;
+    telephone?: string;
+    status: string;
+    source: string;
+    createdOn: string;
+}
+export declare function contactList(params: ContactListParams): Promise<{
+    contacts: ContactSummary[];
+    total: number;
+}>;
+export {};
+//# sourceMappingURL=contact-list.d.ts.map

package/payload/platform/plugins/contacts/mcp/dist/tools/contact-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contact-list.d.ts","sourceRoot":"","sources":["../../src/tools/contact-list.ts"],"names":[],"mappings":"AAIA,UAAU,iBAAiB;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC;IAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAmExD"}

package/payload/platform/plugins/contacts/mcp/dist/tools/contact-list.js

@@ -0,0 +1,49 @@
+import neo4j from "neo4j-driver";
+import { getSession } from "../lib/neo4j.js";
+import { notTrashed } from "../../../../../lib/graph-trash/dist/index.js";
+export async function contactList(params) {
+    const { status, source, since, accountId, limit = 50, } = params;
+    const session = getSession();
+    try {
+        const conditions = ["p.accountId = $accountId", notTrashed("p")];
+        const queryParams = { accountId, limit: neo4j.int(limit) };
+        if (status) {
+            conditions.push("p.status = $status");
+            queryParams.status = status;
+        }
+        if (source) {
+            conditions.push("p.source = $source");
+            queryParams.source = source;
+        }
+        if (since) {
+            conditions.push("p.createdOn >= $since");
+            queryParams.since = since;
+        }
+        const whereClause = conditions.join(" AND ");
+        const countResult = await session.run(`MATCH (p:Person) WHERE ${whereClause} RETURN count(p) AS total`, queryParams);
+        const total = countResult.records[0].get("total").toNumber();
+        const listResult = await session.run(`MATCH (p:Person)
+       WHERE ${whereClause}
+       RETURN p, elementId(p) AS nodeId
+       ORDER BY p.createdOn DESC
+       LIMIT $limit`, queryParams);
+        const contacts = listResult.records.map((record) => {
+            const p = record.get("p").properties;
+            return {
+                nodeId: record.get("nodeId"),
+                givenName: p.givenName,
+                familyName: p.familyName,
+                email: p.email,
+                telephone: p.telephone,
+                status: p.status,
+                source: p.source,
+                createdOn: p.createdOn,
+            };
+        });
+        return { contacts, total };
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=contact-list.js.map

package/payload/platform/plugins/contacts/mcp/dist/tools/contact-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contact-list.js","sourceRoot":"","sources":["../../src/tools/contact-list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,cAAc,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,8CAA8C,CAAC;AAqB1E,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAyB;IAEzB,MAAM,EACJ,MAAM,EACN,MAAM,EACN,KAAK,EACL,SAAS,EACT,KAAK,GAAG,EAAE,GACX,GAAG,MAAM,CAAC;IAEX,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,CAAC,0BAA0B,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QACjE,MAAM,WAAW,GAA4B,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAEpF,IAAI,MAAM,EAAE,CAAC;YACX,UAAU,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YACtC,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC;QAC9B,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACX,UAAU,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YACtC,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC;QAC9B,CAAC;QAED,IAAI,KAAK,EAAE,CAAC;YACV,UAAU,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;YACzC,WAAW,CAAC,KAAK,GAAG,KAAK,CAAC;QAC5B,CAAC;QAED,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE7C,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CACnC,0BAA0B,WAAW,2BAA2B,EAChE,WAAW,CACZ,CAAC;QACF,MAAM,KAAK,GACT,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CACnC,CAAC,QAAQ,EAAE,CAAC;QAEb,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,GAAG,CAClC;eACS,WAAW;;;oBAGN,EACd,WAAW,CACZ,CAAC;QAEF,MAAM,QAAQ,GAAqB,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YACnE,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC;YACrC,OAAO;gBACL,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAW;gBACtC,SAAS,EAAE,CAAC,CAAC,SAAmB;gBAChC,UAAU,EAAE,CAAC,CAAC,UAAgC;gBAC9C,KAAK,EAAE,CAAC,CAAC,KAA2B;gBACpC,SAAS,EAAE,CAAC,CAAC,SAA+B;gBAC5C,MAAM,EAAE,CAAC,CAAC,MAAgB;gBAC1B,MAAM,EAAE,CAAC,CAAC,MAAgB;gBAC1B,SAAS,EAAE,CAAC,CAAC,SAAmB;aACjC,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC"}

package/payload/platform/plugins/contacts/mcp/dist/tools/contact-lookup.d.ts

@@ -0,0 +1,21 @@
+interface ContactLookupParams {
+    email?: string;
+    telephone?: string;
+    name?: string;
+    accountId?: string;
+    limit?: number;
+}
+interface ContactRecord {
+    nodeId: string;
+    givenName: string;
+    familyName?: string;
+    email?: string;
+    telephone?: string;
+    jobTitle?: string;
+    source: string;
+    status: string;
+    createdOn: string;
+}
+export declare function contactLookup(params: ContactLookupParams): Promise<ContactRecord[]>;
+export {};
+//# sourceMappingURL=contact-lookup.d.ts.map

package/payload/platform/plugins/contacts/mcp/dist/tools/contact-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contact-lookup.d.ts","sourceRoot":"","sources":["../../src/tools/contact-lookup.ts"],"names":[],"mappings":"AAIA,UAAU,mBAAmB;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,aAAa;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,aAAa,EAAE,CAAC,CAkE1B"}

package/payload/platform/plugins/contacts/mcp/dist/tools/contact-lookup.js

@@ -0,0 +1,70 @@
+import neo4j from "neo4j-driver";
+import { getSession } from "../lib/neo4j.js";
+import { notTrashed } from "../../../../../lib/graph-trash/dist/index.js";
+export async function contactLookup(params) {
+    const { email, telephone, name, accountId, limit = 10 } = params;
+    const session = getSession();
+    try {
+        let query;
+        let queryParams;
+        const trashFilter = notTrashed("p");
+        if (email) {
+            query = `
+        MATCH (p:Person {accountId: $accountId})
+        WHERE p.email = $email AND ${trashFilter}
+        RETURN p, elementId(p) AS nodeId
+        LIMIT $limit
+      `;
+            queryParams = { email: email.toLowerCase(), accountId, limit: neo4j.int(limit) };
+        }
+        else if (telephone) {
+            query = `
+        MATCH (p:Person {accountId: $accountId})
+        WHERE p.telephone = $telephone AND ${trashFilter}
+        RETURN p, elementId(p) AS nodeId
+        LIMIT $limit
+      `;
+            queryParams = { telephone: telephone.trim(), accountId, limit: neo4j.int(limit) };
+        }
+        else if (name) {
+            query = `
+        MATCH (p:Person {accountId: $accountId})
+        WHERE (toLower(p.givenName) CONTAINS toLower($name)
+           OR toLower(p.familyName) CONTAINS toLower($name))
+           AND ${trashFilter}
+        RETURN p, elementId(p) AS nodeId
+        LIMIT $limit
+      `;
+            queryParams = { name, accountId, limit: neo4j.int(limit) };
+        }
+        else {
+            query = `
+        MATCH (p:Person {accountId: $accountId})
+        WHERE ${trashFilter}
+        RETURN p, elementId(p) AS nodeId
+        ORDER BY p.createdOn DESC
+        LIMIT $limit
+      `;
+            queryParams = { accountId, limit: neo4j.int(limit) };
+        }
+        const result = await session.run(query, queryParams);
+        return result.records.map((record) => {
+            const p = record.get("p").properties;
+            return {
+                nodeId: record.get("nodeId"),
+                givenName: p.givenName,
+                familyName: p.familyName,
+                email: p.email,
+                telephone: p.telephone,
+                jobTitle: p.jobTitle,
+                source: p.source,
+                status: p.status,
+                createdOn: p.createdOn,
+            };
+        });
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=contact-lookup.js.map

package/payload/platform/plugins/contacts/mcp/dist/tools/contact-lookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contact-lookup.js","sourceRoot":"","sources":["../../src/tools/contact-lookup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,cAAc,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,8CAA8C,CAAC;AAsB1E,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAA2B;IAE3B,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IAEjE,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,IAAI,KAAa,CAAC;QAClB,IAAI,WAAoC,CAAC;QAEzC,MAAM,WAAW,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,GAAG;;qCAEuB,WAAW;;;OAGzC,CAAC;YACF,WAAW,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACnF,CAAC;aAAM,IAAI,SAAS,EAAE,CAAC;YACrB,KAAK,GAAG;;6CAE+B,WAAW;;;OAGjD,CAAC;YACF,WAAW,GAAG,EAAE,SAAS,EAAE,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACpF,CAAC;aAAM,IAAI,IAAI,EAAE,CAAC;YAChB,KAAK,GAAG;;;;iBAIG,WAAW;;;OAGrB,CAAC;YACF,WAAW,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7D,CAAC;aAAM,CAAC;YACN,KAAK,GAAG;;gBAEE,WAAW;;;;OAIpB,CAAC;YACF,WAAW,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACvD,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAErD,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YACnC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC;YACrC,OAAO;gBACL,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAW;gBACtC,SAAS,EAAE,CAAC,CAAC,SAAmB;gBAChC,UAAU,EAAE,CAAC,CAAC,UAAgC;gBAC9C,KAAK,EAAE,CAAC,CAAC,KAA2B;gBACpC,SAAS,EAAE,CAAC,CAAC,SAA+B;gBAC5C,QAAQ,EAAE,CAAC,CAAC,QAA8B;gBAC1C,MAAM,EAAE,CAAC,CAAC,MAAgB;gBAC1B,MAAM,EAAE,CAAC,CAAC,MAAgB;gBAC1B,SAAS,EAAE,CAAC,CAAC,SAAmB;aACjC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC"}

package/payload/platform/plugins/contacts/mcp/dist/tools/contact-update.d.ts

@@ -0,0 +1,14 @@
+interface ContactUpdateParams {
+    nodeId?: string;
+    email?: string;
+    telephone?: string;
+    updates: Record<string, unknown>;
+    accountId?: string;
+}
+interface ContactUpdateResult {
+    nodeId: string;
+    updated: boolean;
+}
+export declare function contactUpdate(params: ContactUpdateParams): Promise<ContactUpdateResult>;
+export {};
+//# sourceMappingURL=contact-update.d.ts.map

package/payload/platform/plugins/contacts/mcp/dist/tools/contact-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contact-update.d.ts","sourceRoot":"","sources":["../../src/tools/contact-update.ts"],"names":[],"mappings":"AAGA,UAAU,mBAAmB;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,mBAAmB;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CAkD9B"}

package/payload/platform/plugins/contacts/mcp/dist/tools/contact-update.js

@@ -0,0 +1,43 @@
+import { getSession } from "../lib/neo4j.js";
+import { resolvePersonMatch } from "../lib/resolve-person.js";
+export async function contactUpdate(params) {
+    const { nodeId, email, telephone, updates, accountId } = params;
+    const { matchClause, queryParams } = resolvePersonMatch({ nodeId, email, telephone }, accountId);
+    const session = getSession();
+    try {
+        // Build SET clauses from updates (excluding protected fields)
+        const protectedFields = new Set(["accountId", "email", "createdOn", "embedding"]);
+        const setClauses = [];
+        let paramIndex = 0;
+        for (const [key, value] of Object.entries(updates)) {
+            if (protectedFields.has(key))
+                continue;
+            const paramName = `val_${paramIndex}`;
+            setClauses.push(`p.${key} = $${paramName}`);
+            queryParams[paramName] = value;
+            paramIndex++;
+        }
+        if (setClauses.length === 0) {
+            throw new Error("No valid fields to update");
+        }
+        setClauses.push(`p.updatedAt = $updatedAt`);
+        queryParams.updatedAt = new Date().toISOString();
+        const query = `
+      ${matchClause}
+      SET ${setClauses.join(", ")}
+      RETURN elementId(p) AS nodeId
+    `;
+        const result = await session.run(query, queryParams);
+        if (result.records.length === 0) {
+            throw new Error("Contact not found");
+        }
+        return {
+            nodeId: result.records[0].get("nodeId"),
+            updated: true,
+        };
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=contact-update.js.map

package/payload/platform/plugins/contacts/mcp/dist/tools/contact-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contact-update.js","sourceRoot":"","sources":["../../src/tools/contact-update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAe9D,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAA2B;IAE3B,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAEhE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,kBAAkB,CACrD,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,EAC5B,SAAU,CACX,CAAC;IAEF,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,8DAA8D;QAC9D,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;QAClF,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACnD,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YACvC,MAAM,SAAS,GAAG,OAAO,UAAU,EAAE,CAAC;YACtC,UAAU,CAAC,IAAI,CAAC,KAAK,GAAG,OAAO,SAAS,EAAE,CAAC,CAAC;YAC5C,WAAW,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC;YAC/B,UAAU,EAAE,CAAC;QACf,CAAC;QAED,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC/C,CAAC;QAED,UAAU,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAC5C,WAAW,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAEjD,MAAM,KAAK,GAAG;QACV,WAAW;YACP,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;;KAE5B,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAErD,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACvC,CAAC;QAED,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAW;YACjD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC"}

package/payload/platform/plugins/contacts/mcp/dist/tools/group-create.d.ts

@@ -0,0 +1,18 @@
+import { type CreatedBy } from "../../../../../lib/graph-write/dist/index.js";
+interface GroupCreateParams {
+    groupName: string;
+    agentSlug: string;
+    participants: string[];
+    accountId: string;
+    createdBy: CreatedBy;
+}
+interface GroupCreateResult {
+    conversationId: string;
+    groupSlug: string;
+    joined: string[];
+    notFound: string[];
+    shareableUrl: string;
+}
+export declare function groupCreate(params: GroupCreateParams): Promise<GroupCreateResult>;
+export {};
+//# sourceMappingURL=group-create.d.ts.map

package/payload/platform/plugins/contacts/mcp/dist/tools/group-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-create.d.ts","sourceRoot":"","sources":["../../src/tools/group-create.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,8CAA8C,CAAC;AAW9F,UAAU,iBAAiB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,UAAU,iBAAiB;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA6GvF"}

package/payload/platform/plugins/contacts/mcp/dist/tools/group-create.js

@@ -0,0 +1,95 @@
+import { randomUUID } from "node:crypto";
+import { getSession } from "../lib/neo4j.js";
+import { notTrashed } from "../../../../../lib/graph-trash/dist/index.js";
+import { stampCreatedBy } from "../../../../../lib/graph-write/dist/index.js";
+function generateGroupSlug(name) {
+    const base = name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-|-$/g, "")
+        .slice(0, 40);
+    return base || "group";
+}
+export async function groupCreate(params) {
+    const { groupName, agentSlug, participants, accountId, createdBy } = params;
+    if (!participants || participants.length < 2) {
+        throw new Error("At least 2 participants are required to create a group.");
+    }
+    const conversationId = randomUUID();
+    let groupSlug = generateGroupSlug(groupName);
+    const session = getSession();
+    try {
+        // Check slug uniqueness — only against live conversations. A trashed
+        // conversation holding the same slug would otherwise force an
+        // unnecessary slug suffix.
+        const existing = await session.run(`MATCH (c:Conversation {groupSlug: $slug, accountId: $accountId})
+       WHERE ${notTrashed("c")}
+       RETURN count(c) AS cnt`, { slug: groupSlug, accountId });
+        if ((existing.records[0]?.get("cnt")?.toNumber?.() ?? 0) > 0) {
+            groupSlug = `${groupSlug}-${randomUUID().slice(0, 4)}`;
+        }
+        // Pre-resolve every participant so we reject the whole call if fewer
+        // than one matches — creating a group Conversation with zero live
+        // participants is a write-doctrine orphan (Task 673). Participant
+        // PARTICIPATES_IN edges are added inside the same transaction as the
+        // Conversation node to guarantee ≥1 adjacency at commit time.
+        const resolvedParticipants = [];
+        const notFound = [];
+        for (const identifier of participants) {
+            const r = await session.run(`MATCH (p:Person {accountId: $accountId})
+         WHERE (p.givenName + COALESCE(' ' + p.familyName, '') = $identifier
+            OR p.email = $identifier
+            OR p.telephone = $identifier)
+           AND ${notTrashed("p")}
+         RETURN elementId(p) AS id, p.givenName AS name LIMIT 1`, { accountId, identifier });
+            if (r.records.length > 0) {
+                resolvedParticipants.push({
+                    identifier,
+                    personId: r.records[0].get("id"),
+                    givenName: r.records[0].get("name"),
+                });
+            }
+            else {
+                notFound.push(identifier);
+            }
+        }
+        if (resolvedParticipants.length === 0) {
+            throw new Error(`Write doctrine violated: group-create could not resolve any of the ${participants.length} participant(s) (${notFound.join(", ")}). A group Conversation with no live participants is an orphan.`);
+        }
+        const convoProps = stampCreatedBy({
+            conversationId,
+            accountId,
+            agentType: "public",
+            agentSlug,
+            channel: "webchat",
+            type: "group",
+            groupName,
+            groupSlug,
+            createdBy: "admin",
+        }, createdBy);
+        await session.executeWrite(async (tx) => {
+            await tx.run(`CREATE (c:Conversation $props)
+         SET c.createdAt = datetime(), c.updatedAt = datetime()
+         WITH c
+         UNWIND $participantIds AS pid
+         MATCH (p) WHERE elementId(p) = pid
+         MERGE (p)-[r:PARTICIPATES_IN]->(c)
+         ON CREATE SET r.joinedAt = datetime(), r.displayName = p.givenName`, {
+                props: convoProps,
+                participantIds: resolvedParticipants.map((p) => p.personId),
+            });
+        });
+        const joined = resolvedParticipants.map((p) => p.givenName);
+        const brandResult = await session.run(`MATCH (b:LocalBusiness {accountId: $accountId})
+       RETURN b.hostname AS hostname`, { accountId });
+        const hostname = brandResult.records[0]?.get("hostname");
+        const baseUrl = hostname ? `https://${hostname}` : "https://maxy.bot";
+        const shareableUrl = `${baseUrl}/g/${groupSlug}`;
+        console.error(`[group] created id=${conversationId.slice(0, 8)}… slug=${groupSlug} participants=${joined.length}${notFound.length > 0 ? ` notFound=${notFound.length}` : ""}`);
+        return { conversationId, groupSlug, joined, notFound, shareableUrl };
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=group-create.js.map

package/payload/platform/plugins/contacts/mcp/dist/tools/group-create.js.map

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

package/payload/platform/plugins/contacts/mcp/dist/tools/group-manage.d.ts

@@ -0,0 +1,15 @@
+interface GroupManageParams {
+    groupSlug: string;
+    action: "add" | "remove" | "list";
+    participant?: string;
+    accountId: string;
+}
+interface GroupManageResult {
+    action: string;
+    groupName: string;
+    participant?: string;
+    participants: string[];
+}
+export declare function groupManage(params: GroupManageParams): Promise<GroupManageResult>;
+export {};
+//# sourceMappingURL=group-manage.d.ts.map

package/payload/platform/plugins/contacts/mcp/dist/tools/group-manage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-manage.d.ts","sourceRoot":"","sources":["../../src/tools/group-manage.ts"],"names":[],"mappings":"AAGA,UAAU,iBAAiB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,iBAAiB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA2FvF"}

package/payload/platform/plugins/contacts/mcp/dist/tools/group-manage.js

@@ -0,0 +1,72 @@
+import { getSession } from "../lib/neo4j.js";
+import { notTrashed } from "../../../../../lib/graph-trash/dist/index.js";
+export async function groupManage(params) {
+    const { groupSlug, action, participant, accountId } = params;
+    const session = getSession();
+    try {
+        // Find the group (skip trashed — they should behave as not-found).
+        const groupResult = await session.run(`MATCH (c:Conversation {groupSlug: $groupSlug, accountId: $accountId, type: 'group'})
+       WHERE ${notTrashed("c")}
+       RETURN c.conversationId AS conversationId, c.groupName AS groupName`, { groupSlug, accountId });
+        const record = groupResult.records[0];
+        if (!record) {
+            throw new Error(`Group not found: ${groupSlug}`);
+        }
+        const conversationId = record.get("conversationId");
+        const groupName = record.get("groupName");
+        if (action === "add") {
+            if (!participant)
+                throw new Error("participant is required for add action");
+            const addResult = await session.run(`MATCH (p:Person {accountId: $accountId})
+         WHERE (p.givenName + COALESCE(' ' + p.familyName, '') = $participant
+            OR p.email = $participant
+            OR p.telephone = $participant)
+           AND ${notTrashed("p")}
+         WITH p LIMIT 1
+         MATCH (c:Conversation {conversationId: $conversationId})
+         MERGE (p)-[r:PARTICIPATES_IN]->(c)
+         ON CREATE SET r.joinedAt = datetime(), r.displayName = p.givenName
+         RETURN p.givenName AS name`, { accountId, participant, conversationId });
+            const name = addResult.records[0]?.get("name");
+            if (!name) {
+                throw new Error(`Contact not found: ${participant}`);
+            }
+            console.error(`[group] participant-added id=${conversationId.slice(0, 8)}… name=${name}`);
+        }
+        else if (action === "remove") {
+            if (!participant)
+                throw new Error("participant is required for remove action");
+            const removeResult = await session.run(`MATCH (p:Person {accountId: $accountId})-[r:PARTICIPATES_IN]->(c:Conversation {conversationId: $conversationId})
+         WHERE (p.givenName + COALESCE(' ' + p.familyName, '') = $participant
+            OR p.email = $participant
+            OR p.telephone = $participant)
+           AND ${notTrashed("p")}
+         DELETE r
+         RETURN count(r) AS removed`, { accountId, participant, conversationId });
+            const removed = removeResult.records[0]?.get("removed")?.toNumber?.() ?? 0;
+            if (removed === 0) {
+                throw new Error(`Participant not found in group: ${participant}`);
+            }
+            console.error(`[group] participant-removed id=${conversationId.slice(0, 8)}… name=${participant}`);
+        }
+        // Always return current participants. Trashed persons are filtered out
+        // so the group view reflects active membership only — the PARTICIPATES_IN
+        // edge survives soft-delete, but the participant list shouldn't surface
+        // them.
+        const listResult = await session.run(`MATCH (p:Person)-[r:PARTICIPATES_IN]->(c:Conversation {conversationId: $conversationId})
+       WHERE ${notTrashed("p")}
+       RETURN r.displayName AS displayName
+       ORDER BY r.joinedAt ASC`, { conversationId });
+        const participants = listResult.records.map((r) => r.get("displayName"));
+        return {
+            action,
+            groupName,
+            participant: participant ?? undefined,
+            participants,
+        };
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=group-manage.js.map

package/payload/platform/plugins/contacts/mcp/dist/tools/group-manage.js.map

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

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

@@ -0,0 +1,19 @@
+{
+  "name": "@maxy/contacts",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "neo4j-driver": "^5.28.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0"
+  }
+}

package/payload/platform/plugins/deep-research/PLUGIN.md

@@ -0,0 +1,13 @@
+---
+name: deep-research
+description: "Structured multi-source research workflow — query decomposition, search strategy, source evaluation, synthesis, and citation formatting. Uses Claude Code's native WebSearch and WebFetch tools."
+tools: []
+always: false
+embed: false
+---
+
+# Deep Research
+
+Structured research methodology for multi-source investigation. Uses Claude Code's native `WebSearch` and `WebFetch` tools — no API keys required. No MCP server; the plugin provides skills only.
+
+The researcher specialist is the primary consumer of this methodology. The admin agent can also call `WebSearch` directly for single queries without delegating to the researcher.