@wirecat/cli-core 0.20.0 → 0.263.0

package/dist/mcp/tools/chats.js

@@ -0,0 +1,186 @@
+import * as v from "valibot";
+import { registriesCover } from "../../botcheck/registries.js";
+import { listed } from "../../cli/paging.js";
+import { casKey } from "../../cli/registry-keys.js";
+import { checkedFilter } from "../../services/chats.js";
+import { EVENTS_DAYS, onlineDeps, servicesFor, storedDeps } from "../../services/index.js";
+import { momentOf } from "../../services/moment.js";
+import { chatOf, envelope, limit, page, paging, READ, tool } from "../tool.js";
+export const chatsTools = (messenger) => {
+    const chat = chatOf(messenger);
+    const chats = (adapter, guard) => servicesFor(onlineDeps(messenger, adapter, guard)).chats;
+    return {
+        chats_list: tool({
+            title: "List chats",
+            description: "Chats the owner is in, most recent first. Use it to find a chat's id before reading or sending. " +
+                "With search, kind or unread, every chat is searched, and partial says the messenger could not list them " +
+                "all. Returns { items, page, limit, hasMore, partial? }.",
+            input: v.object({
+                search: v.optional(v.pipe(v.string(), v.minLength(3), v.description("only chats whose name contains this"))),
+                kind: v.optional(v.picklist(["dialog", "group", "channel", "saved"])),
+                unread: v.optional(v.pipe(v.boolean(), v.description("only chats with unread messages"))),
+                limit,
+                page,
+            }),
+            annotations: READ,
+            served: async (services, { search, kind, unread, ...rest }, defaults) => {
+                const { size, number, window } = paging(rest, defaults);
+                const found = await services.chats.list(checkedFilter({ search, kind, unread }), window);
+                return { ...envelope(found, number, size), ...(found.partial ? { partial: true } : {}) };
+            },
+        }),
+        chats_events: tool({
+            title: "Who joined or left a chat",
+            description: "A chat's service messages since `since_time`: who joined, left, was added or removed, and by whom, oldest " +
+                `first — event is join, leave, add, remove, create, title or pin. ${EVENTS_DAYS} days back if not given. ` +
+                "`type` keeps only those events. Returns { items: [{ messageId, timestamp, event, by, people, title? }], page, " +
+                "limit, hasMore, chatId, since }; hasMore when the history was longer than one run reads.",
+            input: v.object({
+                chat,
+                since_time: v.optional(v.pipe(v.string(), v.description("an ISO 8601 time, or 2h / 1d ago"))),
+                type: v.optional(v.pipe(v.string(), v.description("only these events, comma-separated"))),
+            }),
+            annotations: READ,
+            online: async (adapter, args, { guard }) => {
+                const { events, more, ...rest } = await chats(adapter, guard).events(args.chat, {
+                    ...(args.since_time === undefined ? {} : { since: momentOf(args.since_time, "since_time") }),
+                    ...(args.type ? { only: args.type } : {}),
+                });
+                return { ...listed(events), hasMore: more, ...rest };
+            },
+        }),
+        stats_chats_show: tool({
+            title: "A chat's numbers for a period",
+            description: `Counts over a chat's stored messages since \`since_time\` (${EVENTS_DAYS} days back if not given): messages, ` +
+                "senders, replies, threads, reactions, views, forwards and comments where the messenger gave them, topPosts, and " +
+                "questions { asked, answered, medianMinutesToAnswer }. `by` adds a series row per day or week. Reads the local " +
+                "store only, so joins and leaves are not in it — chats_events has them. complete is false when the store does " +
+                "not hold the chat whole: then every number is a lower bound, and fetch names the CLI command that fills it.",
+            input: v.object({
+                chat,
+                since_time: v.optional(v.pipe(v.string(), v.description("an ISO 8601 time, or 2h / 1d ago"))),
+                by: v.optional(v.picklist(["day", "week"])),
+                timezone: v.optional(v.pipe(v.string(), v.description("the IANA timezone for calendar days"))),
+            }),
+            annotations: { ...READ, openWorldHint: false },
+            stored: (store, account, args, defaults) => servicesFor(storedDeps(messenger, store, account, defaults.guard)).chats.stats(args.chat, {
+                ...(args.since_time === undefined ? {} : { since: momentOf(args.since_time, "since_time") }),
+                ...(args.by ? { by: args.by } : {}),
+                ...(args.timezone === undefined ? {} : { timezone: args.timezone }),
+            }),
+        }),
+        chats_members: tool({
+            title: "Everyone in a group",
+            description: "A group's members, a page at a time: { id, name, username, role?, lastSeenAt? }. role is owner, admin or " +
+                "member; lastSeenAt is null when their privacy hides it. Returns { items, page, limit, hasMore }.",
+            input: v.object({ chat, limit, page }),
+            annotations: READ,
+            online: async (adapter, { chat: reference, ...rest }, defaults) => {
+                const { size, number, window } = paging(rest, defaults);
+                const found = await chats(adapter, defaults.guard).members(reference, window);
+                return { ...envelope(found, number, size), chatId: found.chatId };
+            },
+        }),
+        chats_members_audit: tool({
+            title: "Members that look like bots",
+            description: "Members of a group that look like bots, highest score first: { id, name, username, score, reasons }. " +
+                "Reasons: bot, scam, fake, deleted, no_photo, no_username, odd_name, never_wrote, link_first, burst_join, " +
+                "mass_invited. A score is a hint, never a verdict; the owner and admins are left out. Reads the member list " +
+                "a page at a time (budget pages); unknown names the signals the messenger gave nothing for; more says some " +
+                "members were not read. With deep, the top members also get the full contacts_check, one person a second" +
+                (registriesCover(messenger.provider)
+                    ? " — and their ids are sent to the public ban lists"
+                    : "; the public ban lists cover Telegram only, so nothing is sent") +
+                ". Removes nobody — that is chats_moderate, with the owner's confirmation.",
+            input: v.object({
+                chat,
+                budget: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1), v.description("pages of members to read"))),
+                min_score: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1))),
+                deep: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1), v.maxValue(50), v.description("check the top n in full"))),
+            }),
+            annotations: READ,
+            online: (adapter, args, { guard, env }) => {
+                const key = args.deep === undefined ? undefined : casKey(messenger.app, env);
+                return chats(adapter, guard).audit(args.chat, {
+                    ...(args.budget === undefined ? {} : { budget: args.budget }),
+                    ...(args.min_score === undefined ? {} : { minScore: args.min_score }),
+                    ...(args.deep === undefined ? {} : { deep: args.deep }),
+                    ...(key ? { registry: { casKey: key } } : {}),
+                });
+            },
+        }),
+        chats_members_history: tool({
+            title: "Who joined, left or changed their profile",
+            description: "A group's member history as the local store recorded it with chats members fetch, oldest first: " +
+                "{ chatId, items: [{ at, event: joined | left | changed, id, name, username, invitedBy?, before? }] }. " +
+                "before is the profile seen until then. A leave is recorded only from a member list read whole. Reads the " +
+                "local store only; empty until the owner fetches or tracks the chat.",
+            input: v.object({
+                chat,
+                since_time: v.optional(v.pipe(v.string(), v.description("an ISO 8601 time, or 2h / 1d ago"))),
+            }),
+            annotations: { ...READ, openWorldHint: false },
+            stored: async (store, account, args, defaults) => {
+                const { chatId, events } = await servicesFor(storedDeps(messenger, store, account, defaults.guard)).chats.memberHistory(args.chat, args.since_time === undefined ? {} : { since: momentOf(args.since_time, "since_time") });
+                return { chatId, items: events };
+            },
+        }),
+        chats_documents_list: tool({
+            title: "Google documents linked in a chat",
+            description: "Every Google Docs, Sheets, Slides, Forms or Drive link in a chat's stored messages, newest first, one item " +
+                "per link: { items: [{ url, documentId, title, inStore, locator, sentAt, sender: { id, name } }], page, " +
+                "limit, hasMore }. documentId is the Google file id in the URL, null when it carries none; title is the " +
+                "stored document's, null unless inStore. Reads the local store only.",
+            input: v.object({ chat, limit, page }),
+            annotations: { ...READ, openWorldHint: false },
+            stored: async (store, account, args, defaults) => {
+                const { size, number, window } = paging(args, defaults);
+                const found = await servicesFor(storedDeps(messenger, store, account, defaults.guard)).chatDocuments.list(args.chat, window);
+                return envelope(found, number, size);
+            },
+        }),
+        chats_tracking_list: tool({
+            title: "Chats whose members are recorded daily",
+            description: "The chats whose member lists serve fetches daily into the local store: [{ chatId, title, trackedAt, " +
+                "lastCount: { day, participants, listed, complete } | null }]. Reads the local store only. The owner adds " +
+                "one with the CLI: chats members fetch <chat> --track, or chats tracking add.",
+            input: v.object({}),
+            annotations: { ...READ, openWorldHint: false },
+            stored: async (store, account) => ({ items: await store.trackedChats(account) }),
+        }),
+        chats_tracking_show: tool({
+            title: "A chat's member count per day",
+            description: "Whether a chat's members are recorded daily, and its member count per day for the last 30 days: " +
+                "{ chatId, trackedAt | null, counts: [{ day, participants, listed, complete }] }. complete is false for a " +
+                "day whose member list was not read whole. Reads the local store only.",
+            input: v.object({ chat }),
+            annotations: { ...READ, openWorldHint: false },
+            stored: (store, account, args, defaults) => servicesFor(storedDeps(messenger, store, account, defaults.guard)).chats.trackedChat(args.chat),
+        }),
+        chats_inspect: tool({
+            title: "What a link leads to",
+            description: "What an invite or public link leads to, read without joining: { kind, title, id, username, " +
+                "participantsCount, description, member, approvalNeeded? }. id is null for a private chat the owner is not in.",
+            input: v.object({ link: v.pipe(v.string(), v.minLength(1), v.description("an invite link or a public one")) }),
+            annotations: READ,
+            online: (adapter, args, { guard }) => chats(adapter, guard).inspect(args.link),
+        }),
+        chats_send_as: tool({
+            title: "Who the owner may post as",
+            description: "The identities the owner may post as in a chat: { id, title, kind, premiumRequired, default }. kind is " +
+                "self, channel or group; self is always there; default is the chat's saved choice. Reading changes nothing. " +
+                "Pass an id as messages_send send_as. Returns { items, page, limit, hasMore }.",
+            input: v.object({ chat }),
+            annotations: READ,
+            served: async (services, args) => listed(await services.chats.sendAs(args.chat)),
+        }),
+        chats_show: tool({
+            title: "Show a chat",
+            description: "One chat: its kind, unread count, last message time and who is in it.",
+            input: v.object({ chat }),
+            annotations: READ,
+            served: (services, args) => services.chats.show(args.chat),
+        }),
+    };
+};
+//# sourceMappingURL=chats.js.map

package/dist/mcp/tools/chats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chats.js","sourceRoot":"","sources":["../../../src/mcp/tools/chats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAG9D,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAC1F,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,OAAO,EAAgB,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAE5F,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,SAAoB,EAA2B,EAAE;IAC1E,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,CAAA;IAC9B,MAAM,KAAK,GAAG,CAAC,OAAyB,EAAE,KAAgB,EAAE,EAAE,CAC5D,WAAW,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAA;IAC1D,OAAO;QACL,UAAU,EAAE,IAAI,CAAC;YACf,KAAK,EAAE,YAAY;YACnB,WAAW,EACT,kGAAkG;gBAClG,0GAA0G;gBAC1G,yDAAyD;YAC3D,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;gBACd,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,qCAAqC,CAAC,CAAC,CAAC;gBAC5G,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;gBACrE,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,iCAAiC,CAAC,CAAC,CAAC;gBACzF,KAAK;gBACL,IAAI;aACL,CAAC;YACF,WAAW,EAAE,IAAI;YACjB,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE;gBACtE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;gBACvD,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,CAAA;gBACxF,OAAO,EAAE,GAAG,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;YAC1F,CAAC;SACF,CAAC;QAEF,YAAY,EAAE,IAAI,CAAC;YACjB,KAAK,EAAE,2BAA2B;YAClC,WAAW,EACT,4GAA4G;gBAC5G,oEAAoE,WAAW,2BAA2B;gBAC1G,gHAAgH;gBAChH,0FAA0F;YAC5F,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;gBACd,IAAI;gBACJ,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,kCAAkC,CAAC,CAAC,CAAC;gBAC7F,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,oCAAoC,CAAC,CAAC,CAAC;aAC1F,CAAC;YACF,WAAW,EAAE,IAAI;YACjB,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;gBACzC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE;oBAC9E,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,CAAC;oBAC5F,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC1C,CAAC,CAAA;gBACF,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAAA;YACtD,CAAC;SACF,CAAC;QAEF,gBAAgB,EAAE,IAAI,CAAC;YACrB,KAAK,EAAE,+BAA+B;YACtC,WAAW,EACT,8DAA8D,WAAW,sCAAsC;gBAC/G,kHAAkH;gBAClH,gHAAgH;gBAChH,+GAA+G;gBAC/G,6GAA6G;YAC/G,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;gBACd,IAAI;gBACJ,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,kCAAkC,CAAC,CAAC,CAAC;gBAC7F,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;gBAC3C,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,qCAAqC,CAAC,CAAC,CAAC;aAC/F,CAAC;YACF,WAAW,EAAE,EAAE,GAAG,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;YAC9C,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CACzC,WAAW,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE;gBACxF,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,CAAC;gBAC5F,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnC,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;aACpE,CAAC;SACL,CAAC;QAEF,aAAa,EAAE,IAAI,CAAC;YAClB,KAAK,EAAE,qBAAqB;YAC5B,WAAW,EACT,2GAA2G;gBAC3G,kGAAkG;YACpG,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;YACtC,WAAW,EAAE,IAAI;YACjB,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE;gBAChE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;gBACvD,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;gBAC7E,OAAO,EAAE,GAAG,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAA;YACnE,CAAC;SACF,CAAC;QAEF,mBAAmB,EAAE,IAAI,CAAC;YACxB,KAAK,EAAE,6BAA6B;YACpC,WAAW,EACT,uGAAuG;gBACvG,2GAA2G;gBAC3G,6GAA6G;gBAC7G,4GAA4G;gBAC5G,yGAAyG;gBACzG,CAAC,eAAe,CAAC,SAAS,CAAC,QAAQ,CAAC;oBAClC,CAAC,CAAC,mDAAmD;oBACrD,CAAC,CAAC,gEAAgE,CAAC;gBACrE,2EAA2E;YAC7E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;gBACd,IAAI;gBACJ,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,0BAA0B,CAAC,CAAC,CAAC;gBAC7G,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrE,IAAI,EAAE,CAAC,CAAC,QAAQ,CACd,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC,CACzG;aACF,CAAC;YACF,WAAW,EAAE,IAAI;YACjB,MAAM,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE;gBACxC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;gBAC5E,OAAO,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE;oBAC5C,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;oBAC7D,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;oBACrE,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;oBACvD,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC9C,CAAC,CAAA;YACJ,CAAC;SACF,CAAC;QAEF,qBAAqB,EAAE,IAAI,CAAC;YAC1B,KAAK,EAAE,2CAA2C;YAClD,WAAW,EACT,kGAAkG;gBAClG,wGAAwG;gBACxG,2GAA2G;gBAC3G,qEAAqE;YACvE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;gBACd,IAAI;gBACJ,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,kCAAkC,CAAC,CAAC,CAAC;aAC9F,CAAC;YACF,WAAW,EAAE,EAAE,GAAG,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;YAC9C,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;gBAC/C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,WAAW,CAC1C,UAAU,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CACtD,CAAC,KAAK,CAAC,aAAa,CACnB,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,CACxF,CAAA;gBACD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;YAClC,CAAC;SACF,CAAC;QAEF,oBAAoB,EAAE,IAAI,CAAC;YACzB,KAAK,EAAE,mCAAmC;YAC1C,WAAW,EACT,6GAA6G;gBAC7G,yGAAyG;gBACzG,yGAAyG;gBACzG,qEAAqE;YACvE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;YACtC,WAAW,EAAE,EAAE,GAAG,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;YAC9C,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;gBAC/C,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;gBACvD,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CACvG,IAAI,CAAC,IAAI,EACT,MAAM,CACP,CAAA;gBACD,OAAO,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,CAAA;YACtC,CAAC;SACF,CAAC;QAEF,mBAAmB,EAAE,IAAI,CAAC;YACxB,KAAK,EAAE,wCAAwC;YAC/C,WAAW,EACT,sGAAsG;gBACtG,2GAA2G;gBAC3G,8EAA8E;YAChF,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;YACnB,WAAW,EAAE,EAAE,GAAG,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;YAC9C,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;SACjF,CAAC;QAEF,mBAAmB,EAAE,IAAI,CAAC;YACxB,KAAK,EAAE,+BAA+B;YACtC,WAAW,EACT,kGAAkG;gBAClG,2GAA2G;gBAC3G,uEAAuE;YACzE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;YACzB,WAAW,EAAE,EAAE,GAAG,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;YAC9C,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CACzC,WAAW,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;SAClG,CAAC;QAEF,aAAa,EAAE,IAAI,CAAC;YAClB,KAAK,EAAE,sBAAsB;YAC7B,WAAW,EACT,6FAA6F;gBAC7F,+GAA+G;YACjH,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,gCAAgC,CAAC,CAAC,EAAE,CAAC;YAC9G,WAAW,EAAE,IAAI;YACjB,MAAM,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;SAC/E,CAAC;QAEF,aAAa,EAAE,IAAI,CAAC;YAClB,KAAK,EAAE,2BAA2B;YAClC,WAAW,EACT,yGAAyG;gBACzG,6GAA6G;gBAC7G,+EAA+E;YACjF,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;YACzB,WAAW,EAAE,IAAI;YACjB,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SACjF,CAAC;QAEF,UAAU,EAAE,IAAI,CAAC;YACf,KAAK,EAAE,aAAa;YACpB,WAAW,EAAE,uEAAuE;YACpF,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;YACzB,WAAW,EAAE,IAAI;YACjB,MAAM,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;SAC3D,CAAC;KACH,CAAA;AACH,CAAC,CAAA"}

package/dist/mcp/tools/contacts-write.d.ts

@@ -0,0 +1,5 @@
+import type { Messenger } from "../../cli/messenger/context.js";
+import { type AnyTool } from "../tool.js";
+/** The address book's writes, and the owner's profile. `contacts import` has no tool: it takes phone numbers, from a file the owner names. */
+export declare const contactWriteTools: (messenger: Messenger) => Record<string, AnyTool>;
+//# sourceMappingURL=contacts-write.d.ts.map

package/dist/mcp/tools/contacts-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contacts-write.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/contacts-write.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAI/D,OAAO,EAAE,KAAK,OAAO,EAAe,MAAM,YAAY,CAAA;AAItD,8IAA8I;AAC9I,eAAO,MAAM,iBAAiB,cAAe,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAiD9E,CAAA"}

package/dist/mcp/tools/contacts-write.js

@@ -0,0 +1,52 @@
+import * as v from "valibot";
+import { onlineDeps, servicesFor } from "../../services/index.js";
+import { tool, WRITE } from "../tool.js";
+const person = v.pipe(v.string(), v.minLength(1), v.description("person id, or part of a known name"));
+/** The address book's writes, and the owner's profile. `contacts import` has no tool: it takes phone numbers, from a file the owner names. */
+export const contactWriteTools = (messenger) => {
+    const people = (adapter, guard) => servicesFor(onlineDeps(messenger, adapter, guard)).people;
+    const simple = (name, title, description) => tool({
+        title,
+        description: `${description} Only when the owner asked, for this person.`,
+        input: v.object({ person }),
+        annotations: WRITE,
+        permission: "contacts",
+        online: (adapter, args, { guard }) => people(adapter, guard)[name](args.person),
+    });
+    return {
+        contacts_add: simple("add", "Add a contact", "Add a person to the owner's contacts."),
+        contacts_remove: simple("remove", "Remove a contact", "Remove a person from the owner's contacts; the chat stays."),
+        contacts_block: simple("block", "Block a person", "Stop a person from writing to the owner."),
+        contacts_unblock: simple("unblock", "Unblock a person", "Let a blocked person write to the owner again."),
+        account_update: tool({
+            title: "Change the owner's profile",
+            description: "Change the name or the description everyone sees on the owner's profile. Only when the owner asked " +
+                "for this exact change.",
+            input: v.object({
+                first_name: v.optional(v.pipe(v.string(), v.minLength(1))),
+                last_name: v.optional(v.string()),
+                description: v.optional(v.string()),
+            }),
+            annotations: WRITE,
+            permission: "profile",
+            online: (adapter, args, { guard }) => servicesFor(onlineDeps(messenger, adapter, guard)).account.update({
+                ...(args.first_name === undefined ? {} : { firstName: args.first_name }),
+                ...(args.last_name === undefined ? {} : { lastName: args.last_name }),
+                ...(args.description === undefined ? {} : { description: args.description }),
+            }),
+        }),
+        contacts_rename: tool({
+            title: "Rename a contact",
+            description: "Give a person a name only the owner sees. Only when the owner asked for this name.",
+            input: v.object({
+                person,
+                first_name: v.pipe(v.string(), v.minLength(1)),
+                last_name: v.optional(v.string()),
+            }),
+            annotations: WRITE,
+            permission: "contacts",
+            online: (adapter, args, { guard }) => people(adapter, guard).rename(args.person, args.first_name, args.last_name),
+        }),
+    };
+};
+//# sourceMappingURL=contacts-write.js.map

package/dist/mcp/tools/contacts-write.js.map

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

package/dist/mcp/tools/contacts.d.ts

@@ -0,0 +1,4 @@
+import type { Messenger } from "../../cli/messenger/context.js";
+import { type AnyTool } from "../tool.js";
+export declare const contactsTools: (messenger: Messenger) => Record<string, AnyTool>;
+//# sourceMappingURL=contacts.d.ts.map

package/dist/mcp/tools/contacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contacts.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/contacts.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAU/D,OAAO,EAAE,KAAK,OAAO,EAA6C,MAAM,YAAY,CAAA;AAEpF,eAAO,MAAM,aAAa,cAAe,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CA+K1E,CAAA"}

package/dist/mcp/tools/contacts.js

@@ -0,0 +1,156 @@
+import { CliError } from "@wirecat/cli-base";
+import * as v from "valibot";
+import { REGISTRIES, registriesCover } from "../../botcheck/registries.js";
+import { casKey } from "../../cli/registry-keys.js";
+import { levelFor } from "../../sends/permissions.js";
+import { onlineDeps, phoneOf, servicesFor, storedDeps } from "../../services/index.js";
+import { momentOf } from "../../services/moment.js";
+import { maskedAccount } from "../../services/people.js";
+import { CONTEXT_BYTES, CONTEXT_MESSAGES } from "../../services/person-context.js";
+import { SCOPES, TIMELINE_ITEMS } from "../../services/person-timeline.js";
+import { envelope, limit, page, paging, READ, tool } from "../tool.js";
+export const contactsTools = (messenger) => {
+    const people = (adapter, guard) => servicesFor(onlineDeps(messenger, adapter, guard)).people;
+    return {
+        contacts_list: tool({
+            title: "List contacts",
+            description: "People the owner has a one-to-one chat with. Returns { items, page, limit, hasMore }.",
+            input: v.object({
+                search: v.optional(v.pipe(v.string(), v.minLength(1), v.description("only people whose name contains this"))),
+                order: v.optional(v.picklist(["recent", "name"])),
+                limit,
+                page,
+            }),
+            annotations: READ,
+            served: async (services, { search, order, ...rest }, defaults) => {
+                const { size, number, window } = paging(rest, defaults);
+                const found = await services.people.list({
+                    order: order ?? "recent",
+                    ...(search ? { search } : {}),
+                    ...window,
+                });
+                return envelope(found, number, size);
+            },
+        }),
+        contacts_lookup: tool({
+            title: "Find a person by phone",
+            description: "Who has this phone number, where their privacy lets the owner find them: { id, name, username }. " +
+                "not_found otherwise. Nothing is added to the owner's contacts.",
+            input: v.object({ phone: v.pipe(v.string(), v.description("with the country code; spaces and + are fine")) }),
+            annotations: READ,
+            online: (adapter, args, { guard }) => people(adapter, guard).lookup(phoneOf(args.phone)),
+        }),
+        contacts_show: tool({
+            title: "Show a person",
+            description: "One person and the chats shared with them.",
+            input: v.object({
+                with_notes: v.optional(v.boolean()),
+                person: v.pipe(v.string(), v.minLength(1), v.description("person id, @username, or part of a name")),
+            }),
+            annotations: READ,
+            storedWhen: (args) => args.with_notes === true,
+            stored: async (store, account, args, defaults) => {
+                if (levelFor(defaults.settings.permissions ?? {}, "contacts.notes.list").level === "deny")
+                    throw new CliError("permission_error", "profile denies contacts.notes.list");
+                return servicesFor(storedDeps(messenger, store, account, defaults.guard)).people.show(args.person, {
+                    notes: true,
+                });
+            },
+            served: (services, args) => services.people.show(args.person),
+        }),
+        contacts_profile: tool({
+            title: "Profile of a person",
+            description: "What the messenger says about one person — { id, name, usernames, bio, birthday?, phone? (last four " +
+                "digits), flags { bot, verified, premium, scam, fake, restricted, deleted, support }, seen (online, recently, " +
+                "week, month, hidden or a time), contact?, mutualContact?, commonChatsCount?, registered? { at, source: " +
+                "telegram | max | estimate, precision }, hasPhoto? } — and chats: for each chat shared with them, " +
+                "theirMessages stored, firstAt, lastAt and complete (false: the count is a floor); aliases: earlier names " +
+                "and usernames the store saw — { name?, username?, link?, firstSeenAt, lastSeenAt, source: profile | " +
+                "messages (approximate) }. Reading tells them nothing.",
+            input: v.object({
+                person: v.pipe(v.string(), v.minLength(1), v.description("person id, @username, or part of a name")),
+            }),
+            annotations: READ,
+            served: async (services, args) => maskedAccount(await services.people.profile(args.person)),
+        }),
+        contacts_context: tool({
+            title: "What is known about a person",
+            description: "Everything the local store holds about one person, in every messenger linked to them: person { uid, " +
+                "identities }, shared chats, last { fromThem, fromMe, fromThemAnywhere }, recent { direct, groups }, " +
+                "mentions — each message with a locator. complete is false when a shared chat is not stored whole; notRead " +
+                "names it and why. Reads the store only; marks nothing read. Never assumes two people with one name are one. " +
+                "With chats: instead, { person, chats: [{ chat, messages, complete, more }] } — their newest messages in each " +
+                "chat named, oldest first, as { at, text } unless detail asks for ids and locators (1) or everything (2).",
+            input: v.object({
+                person: v.pipe(v.string(), v.minLength(1), v.description("person id, @username, or part of a name")),
+                limit: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1), v.maxValue(100), v.description("at most this many per list"))),
+                since_time: v.optional(v.pipe(v.string(), v.description("an ISO 8601 time, or 2h / 1d ago"))),
+                chats: v.optional(v.pipe(v.array(v.pipe(v.string(), v.minLength(1))), v.minLength(1), v.description("chats by id or name: their newest messages in each"))),
+                detail: v.optional(v.pipe(v.picklist([0, 1, 2]), v.description("with chats: 1 adds ids and locators, 2 everything"))),
+            }),
+            annotations: { ...READ, openWorldHint: false },
+            stored: (store, account, args, defaults) => {
+                const people = servicesFor(storedDeps(messenger, store, account, defaults.guard)).people;
+                if (args.chats !== undefined) {
+                    if (args.since_time !== undefined)
+                        throw new CliError("validation_error", "since_time is not used with chats");
+                    return people.messagesIn(args.person, {
+                        chats: args.chats,
+                        ...(args.limit === undefined ? {} : { limit: args.limit }),
+                        ...(args.detail === undefined ? {} : { detail: args.detail }),
+                    });
+                }
+                return people.context(args.person, {
+                    messages: args.limit ?? CONTEXT_MESSAGES,
+                    bytes: CONTEXT_BYTES,
+                    ...(args.since_time === undefined ? {} : { since: momentOf(args.since_time, "since_time") }),
+                });
+            },
+        }),
+        contacts_timeline: tool({
+            title: "What a person took part in",
+            description: "Everything one person took part in, in every messenger linked to them, newest first: person { uid, name }, " +
+                "items [{ at, subject (message, chat, email, meeting, task, document…), subjectId, role (sender, " +
+                "mentioned, participant, recipient, assignee, author…), scope, provider, account, chatId, locator, " +
+                "projectId }], limits, hasMore. A message carries a locator other tools take. Reads the store only.",
+            input: v.object({
+                person: v.pipe(v.string(), v.minLength(1), v.description("person id, @username, or part of a name")),
+                scope: v.optional(v.pipe(v.picklist(SCOPES), v.description("only personal or only work"))),
+                since_time: v.optional(v.pipe(v.string(), v.description("an ISO 8601 time, or 2h / 1d ago"))),
+                until_time: v.optional(v.pipe(v.string(), v.description("through this ISO 8601 time, or 2h / 1d ago"))),
+                limit: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1), v.maxValue(100), v.description(`at most this many; ${TIMELINE_ITEMS} if not given`))),
+            }),
+            annotations: { ...READ, openWorldHint: false },
+            stored: (store, account, args, defaults) => servicesFor(storedDeps(messenger, store, account, defaults.guard)).people.timeline(args.person, {
+                ...(args.scope === undefined ? {} : { scope: args.scope }),
+                ...(args.since_time === undefined ? {} : { since: momentOf(args.since_time, "since_time") }),
+                ...(args.until_time === undefined ? {} : { until: momentOf(args.until_time, "until_time") }),
+                ...(args.limit === undefined ? {} : { limit: args.limit }),
+            }),
+        }),
+        contacts_check: tool({
+            title: "Does a person look like a bot",
+            description: "Scores one person as a possible bot, fake or spammer: the messenger's own marks, their profile, what they " +
+                (registriesCover(messenger.provider)
+                    ? "wrote in the store, and the public ban lists " +
+                        `${Object.values(REGISTRIES)
+                            .map(({ title, docs }) => `${title} (${docs})`)
+                            .join(", ")} — **the person's id is sent to each of them** unless registries is false. `
+                    : "wrote in the store. The public ban lists cover Telegram only, so nothing is sent. ") +
+                "Returns { person, " +
+                "score, reasons: [{ reason, weight, source, detail }], registries: [{ name, answer: listed|clean|unknown, " +
+                "checkedAt, detail }], unknown, notes }. A hint, never a verdict; changes nothing.",
+            input: v.object({
+                person: v.pipe(v.string(), v.minLength(1), v.description("person id, @username, or part of a name")),
+                registries: v.optional(v.pipe(v.boolean(), v.description("false: skip public ban lists; default true asks them"))),
+            }),
+            annotations: READ,
+            served: (services, args, defaults) => {
+                const registries = args.registries !== false;
+                const key = registries ? casKey(messenger.app, defaults.env) : undefined;
+                return services.botcheck.person(args.person, { registries, ...(key ? { registry: { casKey: key } } : {}) });
+            },
+        }),
+    };
+};
+//# sourceMappingURL=contacts.js.map

package/dist/mcp/tools/contacts.js.map

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

package/dist/mcp/tools/conversations.d.ts

@@ -0,0 +1,5 @@
+import type { Messenger } from "../../cli/messenger/context.js";
+import { type AnyTool } from "../tool.js";
+/** Reads, and `conversations_refresh`, which writes derived indexes to the local store and never to the messenger. */
+export declare const conversationsTools: (messenger: Messenger) => Record<string, AnyTool>;
+//# sourceMappingURL=conversations.d.ts.map

package/dist/mcp/tools/conversations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/conversations.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAQ/D,OAAO,EAAE,KAAK,OAAO,EAAsC,MAAM,YAAY,CAAA;AAM7E,sHAAsH;AACtH,eAAO,MAAM,kBAAkB,cAAe,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAyS/E,CAAA"}