mcp-evolution 0.0.0-stage → 0.8.1

package/dist/tools/fetch-privacy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-privacy.js","sourceRoot":"","sources":["../../src/tools/fetch-privacy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAE9D,MAAM,UAAU,oBAAoB,CAAC,MAAoB;IACvD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE,uEAAuE;QACpF,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC1B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,8BAA8B,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;YACnF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACvF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,QAAQ;gBAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAC3G,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/fetch-profile-picture.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistry } from "../registry.js";
+export declare function registerFetchProfilePicture(server: ToolRegistry): void;

package/dist/tools/fetch-profile-picture.js

@@ -0,0 +1,25 @@
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+import { PhoneOrJidSchema } from "../schemas.js";
+const schema = {
+    number: PhoneOrJidSchema,
+};
+export function registerFetchProfilePicture(server) {
+    server.registerTool("fetch_profile_picture", {
+        title: "Fetch Profile Picture",
+        description: "Fetch the profile picture URL of a WhatsApp contact via the selected instance.",
+        inputSchema: schema,
+    }, async (args, { client }) => {
+        try {
+            const data = await client.post(`/chat/fetchProfilePictureUrl/${client.instanceName}`, {
+                number: args.number,
+            });
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (e) {
+            if (e instanceof McpError)
+                return { isError: true, content: [{ type: "text", text: e.message }] };
+            throw e;
+        }
+    });
+}
+//# sourceMappingURL=fetch-profile-picture.js.map

package/dist/tools/fetch-profile-picture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-profile-picture.js","sourceRoot":"","sources":["../../src/tools/fetch-profile-picture.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,MAAM,GAAG;IACb,MAAM,EAAE,gBAAgB;CACzB,CAAC;AAEF,MAAM,UAAU,2BAA2B,CAAC,MAAoB;IAC9D,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EAAE,gFAAgF;QAC7F,WAAW,EAAE,MAAM;KACpB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACzB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,gCAAgC,MAAM,CAAC,YAAY,EAAE,EAAE;gBACpF,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACvF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,QAAQ;gBAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAC3G,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/find-chats.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistry } from "../registry.js";
+export declare function registerFindChats(server: ToolRegistry): void;

package/dist/tools/find-chats.js

@@ -0,0 +1,74 @@
+import { z } from "zod";
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+const schema = {
+    where: z
+        .record(z.unknown())
+        .optional()
+        .describe("Optional Prisma-style filter object (power-user). If supplied, search is ignored."),
+    search: z
+        .string()
+        .optional()
+        .describe("Convenience substring filter against pushName or remoteJid (case-insensitive). Ignored when where is provided."),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(500)
+        .default(50)
+        .optional()
+        .describe("Max results to return (default 50, max 500)."),
+    offset: z
+        .number()
+        .int()
+        .min(0)
+        .default(0)
+        .optional()
+        .describe("Skip first N results (default 0)."),
+};
+export function registerFindChats(server) {
+    server.registerTool("find_chats", {
+        title: "Find Chats",
+        description: "Find chats for the selected instance. Supports search, limit, and offset to prevent large payloads.",
+        inputSchema: schema,
+    }, async (args, { client, recipients }) => {
+        try {
+            const limit = args.limit ?? 50;
+            const offset = args.offset ?? 0;
+            // Build Evolution request body — pass limit/offset as top-level keys (Evolution v2)
+            const payload = args.where
+                ? { where: args.where, limit, offset }
+                : { limit, offset };
+            const raw = await client.post(`/chat/findChats/${client.instanceName}`, payload);
+            let chats = Array.isArray(raw) ? raw : [];
+            // Recipient allowlist: never expose chats outside it
+            if (recipients.restricted)
+                chats = chats.filter((c) => recipients.isAllowed(c.remoteJid));
+            // Client-side search only when no custom where was supplied
+            if (!args.where && args.search) {
+                const needle = args.search.toLowerCase();
+                chats = chats.filter((c) => c.pushName?.toLowerCase().includes(needle) ||
+                    c.remoteJid?.toLowerCase().includes(needle));
+            }
+            // Client-side safety net for limit/offset (in case Evolution ignores them)
+            chats = chats.slice(offset, offset + limit);
+            // Normalize to compact shape — drop all extra fields to shrink payload
+            const normalized = chats.map(({ remoteJid, pushName, name, unreadCount, updatedAt }) => ({
+                remoteJid,
+                pushName,
+                name,
+                unreadCount,
+                updatedAt,
+            }));
+            return {
+                content: [{ type: "text", text: JSON.stringify(normalized, null, 2) }],
+            };
+        }
+        catch (e) {
+            if (e instanceof McpError) {
+                return { isError: true, content: [{ type: "text", text: e.message }] };
+            }
+            throw e;
+        }
+    });
+}
+//# sourceMappingURL=find-chats.js.map

package/dist/tools/find-chats.js.map

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

package/dist/tools/find-contacts.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistry } from "../registry.js";
+export declare function registerFindContacts(server: ToolRegistry): void;

package/dist/tools/find-contacts.js

@@ -0,0 +1,74 @@
+import { z } from "zod";
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+const schema = {
+    where: z
+        .record(z.unknown())
+        .optional()
+        .describe("Optional Prisma-style filter object (power-user). If supplied, search is ignored."),
+    search: z
+        .string()
+        .optional()
+        .describe("Convenience substring filter against pushName, name, or remoteJid (case-insensitive). Ignored when where is provided."),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(2000)
+        .default(200)
+        .optional()
+        .describe("Max results to return (default 200, max 2000)."),
+    offset: z
+        .number()
+        .int()
+        .min(0)
+        .default(0)
+        .optional()
+        .describe("Skip first N results (default 0)."),
+};
+export function registerFindContacts(server) {
+    server.registerTool("find_contacts", {
+        title: "Find Contacts",
+        description: "Find contacts for the selected instance. Supports search (substring on pushName/name/remoteJid), limit, and offset to prevent large payloads. " +
+            "Returns normalized { remoteJid, pushName, profilePicUrl, isBusiness } — extra fields dropped.",
+        inputSchema: schema,
+    }, async (args, { client, recipients }) => {
+        try {
+            const limit = args.limit ?? 200;
+            const offset = args.offset ?? 0;
+            const payload = args.where
+                ? { where: args.where, limit, offset }
+                : { limit, offset };
+            const raw = await client.post(`/chat/findContacts/${client.instanceName}`, payload);
+            let contacts = Array.isArray(raw) ? raw : [];
+            // Recipient allowlist: never expose contacts outside it
+            if (recipients.restricted)
+                contacts = contacts.filter((c) => recipients.isAllowed(c.remoteJid));
+            // Client-side search only when no custom where was supplied
+            if (!args.where && args.search) {
+                const needle = args.search.toLowerCase();
+                contacts = contacts.filter((c) => c.pushName?.toLowerCase().includes(needle) ||
+                    c.name?.toLowerCase().includes(needle) ||
+                    c.remoteJid?.toLowerCase().includes(needle));
+            }
+            // Client-side safety net for limit/offset (in case Evolution ignores them)
+            contacts = contacts.slice(offset, offset + limit);
+            // Normalize to compact shape — drop everything else
+            const normalized = contacts.map(({ remoteJid, pushName, profilePicUrl, isBusiness }) => ({
+                remoteJid,
+                pushName,
+                profilePicUrl,
+                isBusiness,
+            }));
+            return {
+                content: [{ type: "text", text: JSON.stringify(normalized, null, 2) }],
+            };
+        }
+        catch (e) {
+            if (e instanceof McpError) {
+                return { isError: true, content: [{ type: "text", text: e.message }] };
+            }
+            throw e;
+        }
+    });
+}
+//# sourceMappingURL=find-contacts.js.map

package/dist/tools/find-contacts.js.map

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

package/dist/tools/find-group-by-invite.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistry } from "../registry.js";
+export declare function registerFindGroupByInvite(server: ToolRegistry): void;

package/dist/tools/find-group-by-invite.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+const schema = {
+    inviteCode: z.string().min(1).describe("Group invite code (the part after https://chat.whatsapp.com/)"),
+    includeParticipants: z
+        .boolean()
+        .default(false)
+        .optional()
+        .describe("When true, includes the full participant list in the response (may be large for big groups). " +
+        "Default false returns only admins + size, which covers 95% of use cases."),
+};
+export function registerFindGroupByInvite(server) {
+    server.registerTool("find_group_by_invite", {
+        title: "Find Group by Invite",
+        description: "Get group information from an invite code without joining via the selected instance. " +
+            "Returns { id, subject, subjectOwner, subjectTime, size, desc, descId, creation, owner, admins } by default. " +
+            "Set includeParticipants=true to also get the full participant list.",
+        inputSchema: schema,
+    }, async (args, { client, recipients }) => {
+        try {
+            const data = await client.get(`/group/inviteInfo/${client.instanceName}?inviteCode=${encodeURIComponent(args.inviteCode)}`);
+            if (recipients.restricted && !recipients.isAllowed(typeof data.id === "string" ? data.id : undefined)) {
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: "This group is not in the allowed recipients for this instance." }],
+                };
+            }
+            const participants = Array.isArray(data.participants) ? data.participants : [];
+            const admins = participants
+                .filter((p) => p.admin != null && p.admin !== "")
+                .map((p) => ({ jid: p.id ?? "", admin: p.admin }));
+            const normalized = {
+                id: data.id,
+                subject: data.subject,
+                subjectOwner: data.subjectOwner,
+                subjectTime: data.subjectTime,
+                size: participants.length,
+                desc: data.desc,
+                descId: data.descId,
+                creation: data.creation,
+                owner: data.owner,
+                admins,
+            };
+            if (args.includeParticipants) {
+                normalized["participants"] = participants.map((p) => ({ jid: p.id, admin: p.admin ?? null }));
+            }
+            return { content: [{ type: "text", text: JSON.stringify(normalized, null, 2) }] };
+        }
+        catch (e) {
+            if (e instanceof McpError)
+                return { isError: true, content: [{ type: "text", text: e.message }] };
+            throw e;
+        }
+    });
+}
+//# sourceMappingURL=find-group-by-invite.js.map

package/dist/tools/find-group-by-invite.js.map

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

package/dist/tools/find-labels.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistry } from "../registry.js";
+export declare function registerFindLabels(server: ToolRegistry): void;

package/dist/tools/find-labels.js

@@ -0,0 +1,22 @@
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+export function registerFindLabels(server) {
+    server.registerTool("find_labels", {
+        title: "Find Labels",
+        description: "List all WhatsApp labels for the selected instance (requires WhatsApp Business). " +
+            "Returns normalized { id, name, color } array — nested chat blobs dropped to prevent overflow.",
+        inputSchema: {},
+    }, async (_args, { client }) => {
+        try {
+            const data = await client.get(`/label/findLabels/${client.instanceName}`);
+            const raw = Array.isArray(data) ? data : [];
+            const normalized = raw.map(({ id, name, color }) => ({ id, name, color }));
+            return { content: [{ type: "text", text: JSON.stringify(normalized, null, 2) }] };
+        }
+        catch (e) {
+            if (e instanceof McpError)
+                return { isError: true, content: [{ type: "text", text: e.message }] };
+            throw e;
+        }
+    });
+}
+//# sourceMappingURL=find-labels.js.map

package/dist/tools/find-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-labels.js","sourceRoot":"","sources":["../../src/tools/find-labels.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAS9D,MAAM,UAAU,kBAAkB,CAAC,MAAoB;IACrD,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,mFAAmF;YACnF,+FAA+F;QACjG,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC1B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;YAC1E,MAAM,GAAG,GAAe,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAExD,MAAM,UAAU,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YAE3E,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAC7F,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,QAAQ;gBAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAC3G,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/find-messages.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistry } from "../registry.js";
+export declare function registerFindMessages(server: ToolRegistry): void;

package/dist/tools/find-messages.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+import { JidSchema } from "../schemas.js";
+import { normalizeMessage, extractMessages } from "../util/normalize.js";
+const schema = {
+    remoteJid: JidSchema,
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(200)
+        .default(50)
+        .optional()
+        .describe("Max messages to return (default 50, max 200)."),
+    offset: z
+        .number()
+        .int()
+        .min(0)
+        .default(0)
+        .optional()
+        .describe("Skip first N messages (default 0)."),
+};
+export function registerFindMessages(server) {
+    server.registerTool("find_messages", {
+        title: "Find Messages",
+        description: "Find messages by remoteJid (phone number or group JID) for the selected instance. " +
+            "Returns normalized { id, fromMe, remoteJid, timestamp, type, text, mediaKey?, quotedMessageId? } — raw payload dropped to prevent overflow.",
+        inputSchema: schema,
+    }, async (args, { client }) => {
+        try {
+            const limit = args.limit ?? 50;
+            const offset = args.offset ?? 0;
+            const payload = {
+                where: { key: { remoteJid: args.remoteJid } },
+                limit,
+                offset,
+            };
+            const data = await client.post(`/chat/findMessages/${client.instanceName}`, payload);
+            const rawArr = extractMessages(data);
+            // Client-side offset/limit safety net
+            const sliced = rawArr.slice(offset, offset + limit);
+            const normalized = sliced.map((m) => normalizeMessage(m));
+            return {
+                content: [{ type: "text", text: JSON.stringify(normalized, null, 2) }],
+            };
+        }
+        catch (e) {
+            if (e instanceof McpError) {
+                return { isError: true, content: [{ type: "text", text: e.message }] };
+            }
+            throw e;
+        }
+    });
+}
+//# sourceMappingURL=find-messages.js.map

package/dist/tools/find-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-messages.js","sourceRoot":"","sources":["../../src/tools/find-messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEzE,MAAM,MAAM,GAAG;IACb,SAAS,EAAE,SAAS;IACpB,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,EAAE;SACV,QAAQ,CAAC,+CAA+C,CAAC;IAC5D,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,oCAAoC,CAAC;CAClD,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,MAAoB;IACvD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,oFAAoF;YACpF,6IAA6I;QAC/I,WAAW,EAAE,MAAM;KACpB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACzB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;YAEhC,MAAM,OAAO,GAAG;gBACd,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE;gBAC7C,KAAK;gBACL,MAAM;aACP,CAAC;YACF,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,sBAAsB,MAAM,CAAC,YAAY,EAAE,EAAE,OAAO,CAAC,CAAC;YAErF,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;YAErC,sCAAsC;YACtC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC;YACpD,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAA2C,CAAC,CAAC,CAAC;YAEpG,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAChF,CAAC;QACJ,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,QAAQ,EAAE,CAAC;gBAC1B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAClF,CAAC;YACD,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/find-webhook.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistry } from "../registry.js";
+export declare function registerFindWebhook(server: ToolRegistry): void;

package/dist/tools/find-webhook.js

@@ -0,0 +1,19 @@
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+export function registerFindWebhook(server) {
+    server.registerTool("find_webhook", {
+        title: "Find Webhook",
+        description: "Get the current webhook configuration for the selected WhatsApp instance.",
+        inputSchema: {},
+    }, async (_args, { client }) => {
+        try {
+            const data = await client.get(`/webhook/find/${client.instanceName}`);
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (e) {
+            if (e instanceof McpError)
+                return { isError: true, content: [{ type: "text", text: e.message }] };
+            throw e;
+        }
+    });
+}
+//# sourceMappingURL=find-webhook.js.map

package/dist/tools/find-webhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-webhook.js","sourceRoot":"","sources":["../../src/tools/find-webhook.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAE9D,MAAM,UAAU,mBAAmB,CAAC,MAAoB;IACtD,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,2EAA2E;QACxF,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC1B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,iBAAiB,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;YACtE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACvF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,QAAQ;gBAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAC3G,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/get-chat-history.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistry } from "../registry.js";
+export declare function registerGetChatHistory(server: ToolRegistry): void;

package/dist/tools/get-chat-history.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+import { JidSchema } from "../schemas.js";
+import { normalizeMessage, extractMessages } from "../util/normalize.js";
+const schema = {
+    remoteJid: JidSchema,
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(200)
+        .default(50)
+        .optional()
+        .describe("Max messages to return (default 50, max 200)."),
+    offset: z
+        .number()
+        .int()
+        .min(0)
+        .default(0)
+        .optional()
+        .describe("Skip first N messages (default 0)."),
+};
+export function registerGetChatHistory(server) {
+    server.registerTool("get_chat_history", {
+        title: "Get Chat History",
+        description: "Get chat history for a specific contact or group JID. " +
+            "Returns normalized { id, fromMe, remoteJid, timestamp, type, text, mediaKey?, quotedMessageId? } — raw payload dropped to prevent overflow.",
+        inputSchema: schema,
+    }, async (args, { client }) => {
+        try {
+            const limit = args.limit ?? 50;
+            const offset = args.offset ?? 0;
+            const payload = {
+                where: { key: { remoteJid: args.remoteJid } },
+                limit,
+                offset,
+            };
+            const data = await client.post(`/chat/findMessages/${client.instanceName}`, payload);
+            const rawArr = extractMessages(data);
+            // Client-side offset/limit safety net
+            const sliced = rawArr.slice(offset, offset + limit);
+            const normalized = sliced.map((m) => normalizeMessage(m));
+            return {
+                content: [{ type: "text", text: JSON.stringify(normalized, null, 2) }],
+            };
+        }
+        catch (e) {
+            if (e instanceof McpError) {
+                return { isError: true, content: [{ type: "text", text: e.message }] };
+            }
+            throw e;
+        }
+    });
+}
+//# sourceMappingURL=get-chat-history.js.map

package/dist/tools/get-chat-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-chat-history.js","sourceRoot":"","sources":["../../src/tools/get-chat-history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEzE,MAAM,MAAM,GAAG;IACb,SAAS,EAAE,SAAS;IACpB,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,EAAE;SACV,QAAQ,CAAC,+CAA+C,CAAC;IAC5D,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,oCAAoC,CAAC;CAClD,CAAC;AAEF,MAAM,UAAU,sBAAsB,CAAC,MAAoB;IACzD,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACT,wDAAwD;YACxD,6IAA6I;QAC/I,WAAW,EAAE,MAAM;KACpB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACzB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;YAEhC,MAAM,OAAO,GAAG;gBACd,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE;gBAC7C,KAAK;gBACL,MAAM;aACP,CAAC;YACF,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,sBAAsB,MAAM,CAAC,YAAY,EAAE,EAAE,OAAO,CAAC,CAAC;YAErF,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;YAErC,sCAAsC;YACtC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC;YACpD,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAA2C,CAAC,CAAC,CAAC;YAEpG,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAChF,CAAC;QACJ,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,QAAQ,EAAE,CAAC;gBAC1B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAClF,CAAC;YACD,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/get-group-info.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistry } from "../registry.js";
+export declare function registerGetGroupInfo(server: ToolRegistry): void;

package/dist/tools/get-group-info.js

@@ -0,0 +1,58 @@
+import { z } from "zod";
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+const schema = {
+    groupJid: z
+        .string()
+        .min(1)
+        .describe("The group JID (e.g. 120363xxxxxxxx@g.us)"),
+    includeParticipants: z
+        .boolean()
+        .default(false)
+        .optional()
+        .describe("When true, includes the full participant list in the response (may be large for big groups). " +
+        "Default false returns only admins + size, which covers 95% of use cases."),
+};
+export function registerGetGroupInfo(server) {
+    server.registerTool("get_group_info", {
+        title: "Get Group Info",
+        description: "Get detailed info for a specific WhatsApp group. " +
+            "By default returns { id, subject, subjectOwner, subjectTime, size, desc, descId, creation, owner, admins } — " +
+            "participant list is dropped to prevent payload overflow. " +
+            "Set includeParticipants=true to get the full list (use sparingly for large groups).",
+        inputSchema: schema,
+    }, async (args, { client }) => {
+        try {
+            const data = await client.get(`/group/findGroupInfos/${client.instanceName}?groupJid=${encodeURIComponent(args.groupJid)}`);
+            const participants = Array.isArray(data.participants) ? data.participants : [];
+            const admins = participants
+                .filter((p) => p.admin != null && p.admin !== "")
+                .map((p) => ({ jid: p.id ?? "", admin: p.admin }));
+            const normalized = {
+                id: data.id,
+                subject: data.subject,
+                subjectOwner: data.subjectOwner,
+                subjectTime: data.subjectTime,
+                size: participants.length,
+                desc: data.desc,
+                descId: data.descId,
+                creation: data.creation,
+                owner: data.owner,
+                admins,
+            };
+            if (args.includeParticipants) {
+                // Full list — only expose id and admin role
+                normalized["participants"] = participants.map((p) => ({ jid: p.id, admin: p.admin ?? null }));
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(normalized, null, 2) }],
+            };
+        }
+        catch (e) {
+            if (e instanceof McpError) {
+                return { isError: true, content: [{ type: "text", text: e.message }] };
+            }
+            throw e;
+        }
+    });
+}
+//# sourceMappingURL=get-group-info.js.map

package/dist/tools/get-group-info.js.map

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

package/dist/tools/get-group-resolved-participants.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistry } from "../registry.js";
+export declare function registerGetGroupResolvedParticipants(server: ToolRegistry): void;