@wirecat/cli-core 0.20.0 → 0.263.0

package/dist/mcp/tools/messages-delete.js

@@ -0,0 +1,22 @@
+import * as v from "valibot";
+import { DELETE_AT_ONCE, onlineDeps, servicesFor } from "../../services/index.js";
+import { chatOf, message, tool, WRITE } from "../tool.js";
+export const messageDeleteTools = (messenger) => ({
+    messages_delete: tool({
+        title: "Delete messages for the owner",
+        description: `Delete up to ${DELETE_AT_ONCE} messages from the owner's view of a chat; the other people still see them. ` +
+            "Cannot be undone. Only when the owner asked for these exact messages to be deleted.",
+        input: v.object({
+            chat: chatOf(messenger),
+            messages: v.pipe(v.array(message), v.minLength(1), v.maxLength(DELETE_AT_ONCE)),
+        }),
+        annotations: WRITE,
+        permission: "delete",
+        online: (adapter, args, { guard }) => servicesFor(onlineDeps(messenger, adapter, guard)).messages.delete({
+            chat: args.chat,
+            messages: args.messages,
+            forEveryone: false,
+        }),
+    }),
+});
+//# sourceMappingURL=messages-delete.js.map

package/dist/mcp/tools/messages-delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages-delete.js","sourceRoot":"","sources":["../../../src/mcp/tools/messages-delete.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACjF,OAAO,EAAgB,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAEvE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,SAAoB,EAA2B,EAAE,CAAC,CAAC;IACpF,eAAe,EAAE,IAAI,CAAC;QACpB,KAAK,EAAE,+BAA+B;QACtC,WAAW,EACT,gBAAgB,cAAc,8EAA8E;YAC5G,qFAAqF;QACvF,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;YACd,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC;YACvB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;SAChF,CAAC;QACF,WAAW,EAAE,KAAK;QAClB,UAAU,EAAE,QAAQ;QACpB,MAAM,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CACnC,WAAW,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;YACjE,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,WAAW,EAAE,KAAK;SACnB,CAAC;KACL,CAAC;CACH,CAAC,CAAA"}

package/dist/mcp/tools/messages-photo.d.ts

@@ -0,0 +1,6 @@
+import type { Messenger } from "../../cli/messenger/context.js";
+import { type AnyTool } from "../tool.js";
+/** Larger than this and a client may refuse the answer, or spend the model's context on one picture. */
+export declare const PHOTO_LIMIT: number;
+export declare const messagesPhotoTools: (messenger: Messenger) => Record<string, AnyTool>;
+//# sourceMappingURL=messages-photo.d.ts.map

package/dist/mcp/tools/messages-photo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages-photo.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/messages-photo.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAE/D,OAAO,EAAE,KAAK,OAAO,EAAwC,MAAM,YAAY,CAAA;AAE/E,wGAAwG;AACxG,eAAO,MAAM,WAAW,QAAa,CAAA;AASrC,eAAO,MAAM,kBAAkB,cAAe,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAyC9E,CAAA"}

package/dist/mcp/tools/messages-photo.js

@@ -0,0 +1,60 @@
+import { CliError } from "@wirecat/cli-base";
+import * as v from "valibot";
+import { capability } from "../../cli/messenger/port.js";
+import { chatOf, message, Picture, READ, tool } from "../tool.js";
+/** Larger than this and a client may refuse the answer, or spend the model's context on one picture. */
+export const PHOTO_LIMIT = 512 * 1024;
+const IMAGE_TYPES = [
+    ["image/jpeg", (b) => b[0] === 0xff && b[1] === 0xd8 && b[2] === 0xff],
+    ["image/png", (b) => b[0] === 0x89 && b[1] === 0x50 && b[2] === 0x4e && b[3] === 0x47],
+    ["image/webp", (b) => ascii(b, 0, 4) === "RIFF" && ascii(b, 8, 12) === "WEBP"],
+];
+const ascii = (bytes, from, to) => String.fromCharCode(...bytes.subarray(from, to));
+export const messagesPhotoTools = (messenger) => ({
+    messages_photo: tool({
+        title: "Look at a photo",
+        description: `A message's photo, as an image to look at. Up to ${PHOTO_LIMIT / 1024} KB; anything larger, and ` +
+            "files, videos and voice messages, are refused with the command the owner runs to save them.",
+        input: v.object({
+            chat: chatOf(messenger),
+            message,
+            index: v.optional(v.pipe(v.number(), v.integer(), v.minValue(0), v.description("attachment index from 0; omit for the first photo"))),
+        }),
+        annotations: READ,
+        online: async (adapter, args) => {
+            const { id: chatId } = await adapter.resolve(args.chat);
+            const saveIt = `the owner can save it with \`${messenger.app.command} messages download ${chatId} ${args.message}\``;
+            const { files } = await capability(adapter, "download", "download attachments")(chatId, args.message);
+            const photo = args.index === undefined ? files.find((file) => file.kind === "photo") : files[args.index];
+            if (!photo) {
+                const kinds = files.map((file) => file.kind).join(", ");
+                throw new CliError(files.length === 0 ? "not_found" : "validation_error", files.length === 0
+                    ? `message ${args.message} has no photo`
+                    : `the message has a ${kinds}, not a photo — ${saveIt}`);
+            }
+            if (photo.kind !== "photo")
+                throw new CliError("validation_error", `the selected attachment is not a photo — ${saveIt}`);
+            const bytes = await readUpTo(photo, PHOTO_LIMIT, saveIt);
+            const mimeType = IMAGE_TYPES.find(([, is]) => is(bytes))?.[0];
+            if (!mimeType)
+                throw new CliError("validation_error", `the photo is not JPEG, PNG or WebP — ${saveIt}`);
+            return new Picture(bytes, mimeType, { chatId, messageId: args.message, bytes: bytes.length });
+        },
+    }),
+});
+/** Stops reading at the limit: a photo larger than it is refused, not fetched whole. */
+const readUpTo = async (file, limit, saveIt) => {
+    const tooLarge = () => new CliError("validation_error", `the photo is larger than ${limit / 1024} KB — ${saveIt}`);
+    if ((file.size ?? 0) > limit)
+        throw tooLarge();
+    const chunks = [];
+    let total = 0;
+    for await (const chunk of file.bytes()) {
+        total += chunk.length;
+        if (total > limit)
+            throw tooLarge();
+        chunks.push(chunk);
+    }
+    return new Uint8Array(Buffer.concat(chunks));
+};
+//# sourceMappingURL=messages-photo.js.map

package/dist/mcp/tools/messages-photo.js.map

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

package/dist/mcp/tools/messages-send.d.ts

@@ -0,0 +1,8 @@
+import type { Messenger } from "../../cli/messenger/context.js";
+import { type AnyTool } from "../tool.js";
+export declare const HTML_TOOL_HELP = "the text is HTML: <b>, <i>, <u>, <s>, <a href>, <code>, <pre>; not with md";
+/**
+ * The same guard as the command: profile permissions, recipients, hourly limits and the journal.
+ */
+export declare const messageSendTools: (messenger: Messenger) => Record<string, AnyTool>;
+//# sourceMappingURL=messages-send.d.ts.map

package/dist/mcp/tools/messages-send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages-send.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/messages-send.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAI/D,OAAO,EAAE,KAAK,OAAO,EAAwC,MAAM,YAAY,CAAA;AAE/E,eAAO,MAAM,cAAc,+EAA+E,CAAA;AAE1G;;GAEG;AACH,eAAO,MAAM,gBAAgB,cAAe,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAgH7E,CAAA"}

package/dist/mcp/tools/messages-send.js

@@ -0,0 +1,91 @@
+import { CliError } from "@wirecat/cli-base";
+import * as v from "valibot";
+import { sendTime } from "../../domain/send-time.js";
+import { readAttachments } from "../../sends/upload.js";
+import { onlineDeps, servicesFor } from "../../services/index.js";
+import { chatOf, message, nameOf, tool, WRITE } from "../tool.js";
+export const HTML_TOOL_HELP = "the text is HTML: <b>, <i>, <u>, <s>, <a href>, <code>, <pre>; not with md";
+/**
+ * The same guard as the command: profile permissions, recipients, hourly limits and the journal.
+ */
+export const messageSendTools = (messenger) => {
+    const chat = chatOf(messenger);
+    const name = nameOf(messenger);
+    return {
+        messages_send: tool({
+            title: "Send a message",
+            description: "Send one message as the owner — text, or a file or photo from the owner's machine with the text as its " +
+                "caption. Only when the owner asked for this exact message to this exact chat. Hidden files and folders, " +
+                `~/.ssh and ${messenger.app.command}'s own folders are refused, with no way around it here. ` +
+                "A name that matches several chats is refused with the candidates — pick an id, never guess. " +
+                `On outcome_unknown, retry with the send_id it returns and ${name} drops the duplicate; never with a new one. ` +
+                `With \`at\`, ${name} sends it later and the answer carries scheduledFor; never retry a scheduled send — ` +
+                "read messages_scheduled instead.",
+            input: v.object({
+                chat,
+                text: v.optional(v.pipe(v.string(), v.description("the message, or the caption of a file or photo"))),
+                file: v.optional(v.pipe(v.string(), v.minLength(1), v.description("a path on the owner's machine to attach as a file"))),
+                photo: v.optional(v.pipe(v.string(), v.minLength(1), v.description("a .jpg, .png or .webp to attach as a photo"))),
+                as_file: v.optional(v.pipe(v.boolean(), v.description("send the file as a file to download, a video included"))),
+                filename: v.optional(v.pipe(v.string(), v.minLength(1), v.description("the name others see for the file, instead of its own"))),
+                spoiler: v.optional(v.pipe(v.boolean(), v.description("hide the photo or video behind a spoiler"))),
+                caption_above: v.optional(v.pipe(v.boolean(), v.description("show the text above the photo or file"))),
+                voice: v.optional(v.pipe(v.string(), v.minLength(1), v.description("an Ogg Opus file to send as a voice message, alone"))),
+                reply_to: v.optional(v.pipe(message, v.description("the message this answers, in the same chat"))),
+                comment_to: v.optional(v.pipe(message, v.description("a post of this channel to comment on; the comment goes to its discussion"))),
+                topic: v.optional(v.pipe(v.string(), v.minLength(1), v.description("the forum topic id; unsupported without topics"))),
+                send_as: v.optional(v.pipe(v.string(), v.minLength(1), v.description("an id from chats_send_as to post as; required where the chat posts as someone else by default"))),
+                send_id: v.optional(v.pipe(v.string(), v.minLength(1), v.description("from an earlier outcome_unknown"))),
+                silent: v.optional(v.pipe(v.boolean(), v.description("deliver without a notification"))),
+                no_preview: v.optional(v.pipe(v.boolean(), v.description("no preview card for a link in the text"))),
+                md: v.optional(v.pipe(v.boolean(), v.description("read **bold**, _italic_, ~~struck~~ and `code`; \\ keeps a mark literal"))),
+                html: v.optional(v.pipe(v.boolean(), v.description(HTML_TOOL_HELP))),
+                at_time: v.optional(v.pipe(v.string(), v.description("send it later: 2026-09-25T09:00 (the owner's local time), or 30m, 2h, 1d from now"))),
+            }),
+            annotations: WRITE,
+            permission: "send",
+            online: async (adapter, args, { guard, env }) => {
+                const at = args.at_time === undefined ? undefined : sendTime(args.at_time);
+                // Never anyFile here: a path an agent was talked into is how a key would leave the machine.
+                const read = { app: messenger.app, env };
+                if (args.filename !== undefined && !messenger.mediaOptions?.includes("fileName"))
+                    throw new CliError("validation_error", "this messenger has no --filename");
+                const attachments = await readAttachments({
+                    ...(args.photo === undefined ? {} : { photo: args.photo }),
+                    ...(args.file === undefined ? {} : { file: args.file }),
+                    ...(args.voice === undefined ? {} : { voice: args.voice }),
+                    ...(args.text === undefined ? {} : { text: args.text }),
+                    asFile: args.as_file === true,
+                    ...(args.filename === undefined ? {} : { filename: args.filename }),
+                }, read);
+                if ((args.text ?? "").trim() === "" && attachments.length === 0) {
+                    throw new CliError("validation_error", "nothing to send — give text, a file or a photo");
+                }
+                const sent = await servicesFor({ ...onlineDeps(messenger, adapter, guard) }).messages.send({
+                    chat: args.chat,
+                    text: args.text ?? "",
+                    ...(attachments.length === 0 ? {} : { attachments }),
+                    ...(args.spoiler === true ? { spoiler: true } : {}),
+                    ...(args.caption_above === true ? { captionAbove: true } : {}),
+                    ...(args.send_id === undefined ? {} : { sendId: args.send_id }),
+                    ...(args.topic === undefined ? {} : { threadId: args.topic }),
+                    ...(args.send_as === undefined ? {} : { sendAs: args.send_as }),
+                    ...(args.reply_to === undefined ? {} : { replyTo: args.reply_to }),
+                    ...(args.comment_to === undefined ? {} : { commentTo: args.comment_to }),
+                    ...(args.silent === true ? { silent: true } : {}),
+                    ...(args.no_preview === true ? { noPreview: true } : {}),
+                    ...(args.md === true ? { markdown: true } : {}),
+                    ...(args.html === true ? { html: true } : {}),
+                    ...(at === undefined ? {} : { at }),
+                });
+                return {
+                    sendId: sent.sendId,
+                    operationId: sent.operationId,
+                    message: sent.message,
+                    ...(at === undefined ? {} : { scheduledFor: at }),
+                };
+            },
+        }),
+    };
+};
+//# sourceMappingURL=messages-send.js.map

package/dist/mcp/tools/messages-send.js.map

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

package/dist/mcp/tools/messages-transcribe.d.ts

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

package/dist/mcp/tools/messages-transcribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages-transcribe.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/messages-transcribe.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAE/D,OAAO,EAAE,KAAK,OAAO,EAAuC,MAAM,YAAY,CAAA;AAE9E,eAAO,MAAM,uBAAuB,cAAe,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CA+BnF,CAAA"}

package/dist/mcp/tools/messages-transcribe.js

@@ -0,0 +1,31 @@
+import * as v from "valibot";
+import { choose, hearLocally, hearOnline } from "../../speech/transcribe.js";
+import { chatOf, message, nameOf, READ, tool } from "../tool.js";
+export const messagesTranscribeTools = (messenger) => ({
+    messages_transcribe: tool({
+        title: "Read a voice message",
+        description: `A voice message as text — by ${nameOf(messenger)} where the account allows it, else by a speech model ` +
+            "on this machine. Can take up to a minute; pending: true means it was not finished yet — ask again later. " +
+            "Never downloads a model: a missing one is refused with the command the owner runs. " +
+            "Returns { messageId, text, pending, via, model? }.",
+        input: v.object({
+            chat: chatOf(messenger),
+            message,
+            local: v.optional(v.pipe(v.boolean(), v.description("use the model on this machine, never the messenger"))),
+            model: v.optional(v.pipe(v.string(), v.minLength(1), v.description("which downloaded speech model hears it"))),
+        }),
+        annotations: READ,
+        online: async (adapter, args, defaults) => {
+            const choice = choose(messenger, defaults.settings, {
+                local: args.local === true,
+                ...(args.model === undefined ? {} : { model: args.model }),
+            }, defaults.env);
+            const heard = await hearOnline(messenger, adapter, args.chat, args.message, choice);
+            if (!(heard instanceof Uint8Array))
+                return heard;
+            await defaults.release?.();
+            return hearLocally(heard, args.message, choice);
+        },
+    }),
+});
+//# sourceMappingURL=messages-transcribe.js.map

package/dist/mcp/tools/messages-transcribe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages-transcribe.js","sourceRoot":"","sources":["../../../src/mcp/tools/messages-transcribe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAC5E,OAAO,EAAgB,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAE9E,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,SAAoB,EAA2B,EAAE,CAAC,CAAC;IACzF,mBAAmB,EAAE,IAAI,CAAC;QACxB,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,gCAAgC,MAAM,CAAC,SAAS,CAAC,uDAAuD;YACxG,2GAA2G;YAC3G,qFAAqF;YACrF,oDAAoD;QACtD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;YACd,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC;YACvB,OAAO;YACP,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,oDAAoD,CAAC,CAAC,CAAC;YAC3G,KAAK,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,wCAAwC,CAAC,CAAC,CAAC;SAC/G,CAAC;QACF,WAAW,EAAE,IAAI;QACjB,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;YACxC,MAAM,MAAM,GAAG,MAAM,CACnB,SAAS,EACT,QAAQ,CAAC,QAAQ,EACjB;gBACE,KAAK,EAAE,IAAI,CAAC,KAAK,KAAK,IAAI;gBAC1B,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;aAC3D,EACD,QAAQ,CAAC,GAAG,CACb,CAAA;YACD,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;YACnF,IAAI,CAAC,CAAC,KAAK,YAAY,UAAU,CAAC;gBAAE,OAAO,KAAK,CAAA;YAChD,MAAM,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAA;YAC1B,OAAO,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QACjD,CAAC;KACF,CAAC;CACH,CAAC,CAAA"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/messages.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAS/D,OAAO,EAAE,KAAK,OAAO,EAAuD,MAAM,YAAY,CAAA;AAO9F,eAAO,MAAM,aAAa,cAAe,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAmN1E,CAAA"}

package/dist/mcp/tools/messages.js

@@ -0,0 +1,178 @@
+import { CliError } from "@wirecat/cli-base";
+import * as v from "valibot";
+import { listStart } from "../../cli/messenger/after.js";
+import { capability } from "../../cli/messenger/port.js";
+import { listed } from "../../cli/paging.js";
+import { isLocator, parseLocator } from "../../domain/locator.js";
+import { SAVE_NEXT_STEPS } from "../../meetings/index.js";
+import { readEvidencePacket, readMail } from "../../services/index.js";
+import { heard, hearForTool, modelWith } from "../../speech/hearing.js";
+import { searchServices } from "../search-sync.js";
+import { threadArgs, threadInputs } from "../thread-options.js";
+import { chatOf, limit, message, nameOf, READ, snakeOf, tool } from "../tool.js";
+import { answerMessagesStats, MESSAGES_STATS_DESCRIPTION, messagesStatsInput } from "./search.js";
+/** Mail lives in the store's mail tables, whichever messenger serves the tool. */
+const isMail = (chat, message) => message === undefined && isLocator(chat) && parseLocator(chat).provider === "email";
+export const messagesTools = (messenger) => {
+    const chat = chatOf(messenger);
+    const name = nameOf(messenger);
+    return {
+        messages_evidence: tool({
+            title: "Prepare stored chat evidence",
+            description: "A chat evidence packet from the current profile's local archive, newest first. Never connects or marks " +
+                "read. Whole messages fill at most 64 KiB of JSON items; the packet envelope is additional. Returns " +
+                "source locators, fingerprints, coverage (history unknown) and nextBeforeId. Pass a non-null cursor as " +
+                "before_id for older messages. An oversized first message returns an empty, byte-truncated packet " +
+                "with no cursor; handle that obstruction explicitly. Prepares evidence, not a generated summary.",
+            input: v.object({
+                chat,
+                limit,
+                before_id: v.optional(v.pipe(message, v.description("only messages older than this message id"))),
+            }),
+            annotations: { ...READ, openWorldHint: false },
+            stored: (store, account, args, defaults) => readEvidencePacket(store, account, {
+                chat: args.chat,
+                limit: args.limit ?? defaults.limit,
+                ...(args.before_id === undefined ? {} : { before: args.before_id }),
+            }, messenger),
+        }),
+        messages_list: tool({
+            nextSteps: SAVE_NEXT_STEPS,
+            title: "Read a chat",
+            description: "Recent messages in a chat, oldest first. Does not mark anything read. For older messages pass " +
+                "`before_id` = the id of the first item, or `before_time`; for newer ones, `after_id` = the id of the last " +
+                "item, or `after_time`. One of the four at most. A voice message carries `transcript` once heard; " +
+                "`transcribe` hears the rest. Returns { items, page, limit, hasMore }.",
+            input: v.object({
+                chat,
+                limit,
+                before_id: v.optional(v.pipe(message, v.description("only messages older than this message id"))),
+                before_time: v.optional(v.pipe(v.string(), v.description("only messages older than this ISO 8601 time, or 2h / 1d ago"))),
+                after_id: v.optional(v.pipe(message, v.description("only messages newer than this message id"))),
+                after_time: v.optional(v.pipe(v.string(), v.description("only messages newer than this ISO 8601 time, or 2h / 1d ago"))),
+                topic: v.optional(v.pipe(v.string(), v.minLength(1), v.description("only this forum topic, read back from its newest message or before_id"))),
+                transcribe: v.optional(v.pipe(v.boolean(), v.description("turn voice messages not heard yet into text; can take minutes"))),
+                model: v.optional(v.pipe(v.string(), v.minLength(1), v.description("which downloaded speech model hears them, with transcribe"))),
+            }),
+            annotations: READ,
+            served: async (services, args, defaults, connect) => {
+                const size = args.limit ?? defaults.limit;
+                const start = listStart({
+                    beforeId: args.before_id,
+                    beforeTime: args.before_time,
+                    afterId: args.after_id,
+                    afterTime: args.after_time,
+                }, snakeOf);
+                const found = await services.messages.list(args.chat, {
+                    limit: size,
+                    ...start,
+                    ...(args.topic === undefined ? {} : { threadId: args.topic }),
+                });
+                const hearing = await hearForTool(messenger, connect, found.items, args.transcribe === true, defaults, modelWith(args.transcribe, args.model));
+                return {
+                    items: heard(found.items, hearing),
+                    page: 1,
+                    limit: size,
+                    hasMore: found.hasMore,
+                    ...(args.transcribe ? { unheard: hearing?.unheard ?? [] } : {}),
+                    ...(hearing?.problem === undefined ? {} : { transcribeProblem: hearing.problem }),
+                };
+            },
+        }),
+        messages_comments: tool({
+            title: "Comments under a channel post",
+            description: "The comments under one channel post, oldest to newest, read from the messenger: { discussion: { chatId, " +
+                "messageId }, items, hasMore }. They live in the channel's discussion group; before_id pages back. A post " +
+                "that takes no comments is not_found. Does not mark read.",
+            input: v.object({
+                chat,
+                post: v.pipe(message, v.description("the post's message id in the channel")),
+                limit,
+                before_id: v.optional(v.pipe(message, v.description("only comments older than this one"))),
+            }),
+            annotations: READ,
+            served: async (services, args, defaults) => services.messages.comments(args.chat, args.post, {
+                limit: args.limit ?? defaults.limit,
+                ...(args.before_id === undefined ? {} : { before: args.before_id }),
+            }),
+        }),
+        messages_link: tool({
+            title: "Get a message link",
+            description: "An account-scoped locator and optional provider permalink, without message content. Returns { locator, url, access, reason }; access describes the link audience, not permission granted to its reader. Does not mark read. A locator can replace chat and message.",
+            input: v.object({ chat, message: v.optional(message) }),
+            annotations: READ,
+            served: async (services, args) => services.messages.link(args.chat, args.message),
+        }),
+        messages_context: tool({
+            nextSteps: SAVE_NEXT_STEPS,
+            title: "Show a message",
+            description: "One message by id, and optionally the messages either side of it, oldest first. The one asked for " +
+                "carries anchor: true; `before_n` and `after_n` say how many either side. Returns { items, page, limit, hasMore }. " +
+                "With thread=true, reads the stored parent chain and replies without connecting: returns locator, mode, items, links with provenance/stale labels, chain, stale, stopped and bounds. " +
+                "thread_hops (8), thread_messages (50), thread_bytes (65536) and thread_within (1d) bound it; no graph gives a labelled local time fallback. " +
+                "A msg: locator in chat needs no message argument; it must belong to the active account. offline=true reads ordinary context from this account's local store without connecting. " +
+                "A msg:email/… locator reads the whole email and its thread from the stored mail, with people, labels and thread references.",
+            input: v.object({
+                ...threadInputs,
+                offline: v.optional(v.boolean()),
+                chat,
+                message: v.optional(message),
+                before_n: v.optional(v.pipe(v.number(), v.integer(), v.minValue(0), v.maxValue(100))),
+                after_n: v.optional(v.pipe(v.number(), v.integer(), v.minValue(0), v.maxValue(100))),
+            }),
+            annotations: READ,
+            storedWhen: (args) => {
+                if (args.thread || args.offline || isMail(args.chat, args.message))
+                    return true;
+                if (args.message === undefined && !isLocator(args.chat))
+                    throw new CliError("validation_error", "give a message id, or a msg: locator");
+                return false;
+            },
+            stored: async (store, account, args, defaults) => {
+                if (isMail(args.chat, args.message))
+                    return listed(await readMail(store, args.chat, { before: args.before_n ?? 0, after: args.after_n ?? 0 }));
+                const services = searchServices(messenger, store, account, defaults);
+                if (!args.thread)
+                    return listed(await services.messages.around(args.chat, args.message, {
+                        before: args.before_n ?? 0,
+                        after: args.after_n ?? 0,
+                    }));
+                return services.messages.thread(args.chat, args.message, {
+                    ...threadArgs(args).thread,
+                    before: args.before_n ?? 5,
+                    after: args.after_n ?? 5,
+                    signal: defaults.signal,
+                });
+            },
+            served: async (services, args) => {
+                if (args.message === undefined && !isLocator(args.chat))
+                    throw new CliError("validation_error", "give a message id, or a msg: locator");
+                return listed(await services.messages.around(args.chat, args.message, {
+                    before: args.before_n ?? 0,
+                    after: args.after_n ?? 0,
+                }));
+            },
+        }),
+        messages_scheduled: tool({
+            title: "Messages scheduled in a chat",
+            description: "Messages waiting to be sent later in a chat, soonest first, each with scheduledFor. Look here after a " +
+                `scheduled send ended in outcome_unknown. Cancelling one is done in the ${name} app. Returns { items }.`,
+            input: v.object({ chat }),
+            annotations: READ,
+            online: async (adapter, args) => ({
+                items: await capability(adapter, "scheduled", "list scheduled messages")(args.chat),
+            }),
+        }),
+        stats_messages_show: tool({
+            title: "Count messages",
+            description: MESSAGES_STATS_DESCRIPTION,
+            input: messagesStatsInput(messenger),
+            annotations: { ...READ, openWorldHint: false },
+            stored: (store, account, args, defaults, connect) => {
+                const services = searchServices(messenger, store, account, defaults, args.sync_first ? connect : undefined);
+                return answerMessagesStats(services.messages, args, defaults, services.searches);
+            },
+        }),
+    };
+};
+//# sourceMappingURL=messages.js.map

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

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

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

@@ -0,0 +1,8 @@
+import type { Messenger } from "../../cli/messenger/context.js";
+import { type AnyTool } from "../tool.js";
+/**
+ * A group's rules, and the run that acts on them. Over MCP nobody can answer a question per action,
+ * so an action whose level in the group's rules is `ask` is planned, not taken.
+ */
+export declare const moderationTools: (messenger: Messenger) => Record<string, AnyTool>;
+//# sourceMappingURL=moderation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"moderation.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/moderation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAG/D,OAAO,EAAE,KAAK,OAAO,EAA6B,MAAM,YAAY,CAAA;AAEpE;;;GAGG;AACH,eAAO,MAAM,eAAe,cAAe,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAiC3E,CAAA"}

package/dist/mcp/tools/moderation.js

@@ -0,0 +1,35 @@
+import * as v from "valibot";
+import { onlineDeps, servicesFor } from "../../services/index.js";
+import { momentOf } from "../../services/moment.js";
+import { chatOf, READ, tool, WRITE } from "../tool.js";
+/**
+ * A group's rules, and the run that acts on them. Over MCP nobody can answer a question per action,
+ * so an action whose level in the group's rules is `ask` is planned, not taken.
+ */
+export const moderationTools = (messenger) => ({
+    chats_rules_show: tool({
+        title: "A group's moderation rules",
+        description: "The rules `chats_moderate` judges a group by; the defaults, marked not saved, if it has none.",
+        input: v.object({ chat: chatOf(messenger) }),
+        annotations: READ,
+        online: (adapter, args, { guard, settings, env }) => servicesFor(onlineDeps(messenger, adapter, guard, { profile: settings.profile, env })).moderation.rules(args.chat),
+    }),
+    chats_moderate: tool({
+        title: "Apply a group's rules",
+        description: "Judge a group's new messages and members by its rules, and delete or remove where the rules' levels allow; " +
+            "an action at level ask is planned for the owner, not taken. Only when the owner asked for this group.",
+        input: v.object({
+            chat: chatOf(messenger),
+            since_time: v.optional(v.pipe(v.string(), v.description("ISO 8601, or 2h / 1d ago; the saved point stays"))),
+            dry_run: v.optional(v.pipe(v.boolean(), v.description("judge and plan; do nothing"))),
+        }),
+        annotations: WRITE,
+        permission: "groups",
+        online: (adapter, args, { guard, settings, env }) => servicesFor(onlineDeps(messenger, adapter, guard, { profile: settings.profile, env })).moderation.moderate(args.chat, {
+            ...(args.since_time === undefined ? {} : { since: momentOf(args.since_time, "since_time") }),
+            dryRun: args.dry_run === true,
+            allowDangerous: false,
+        }),
+    }),
+});
+//# sourceMappingURL=moderation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"moderation.js","sourceRoot":"","sources":["../../../src/mcp/tools/moderation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,OAAO,EAAgB,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAEpE;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,SAAoB,EAA2B,EAAE,CAAC,CAAC;IACjF,gBAAgB,EAAE,IAAI,CAAC;QACrB,KAAK,EAAE,4BAA4B;QACnC,WAAW,EAAE,+FAA+F;QAC5G,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5C,WAAW,EAAE,IAAI;QACjB,MAAM,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,CAClD,WAAW,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CACrG,IAAI,CAAC,IAAI,CACV;KACJ,CAAC;IACF,cAAc,EAAE,IAAI,CAAC;QACnB,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EACT,6GAA6G;YAC7G,uGAAuG;QACzG,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;YACd,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC;YACvB,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,iDAAiD,CAAC,CAAC,CAAC;YAC5G,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,4BAA4B,CAAC,CAAC,CAAC;SACtF,CAAC;QACF,WAAW,EAAE,KAAK;QAClB,UAAU,EAAE,QAAQ;QACpB,MAAM,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,CAClD,WAAW,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CACxG,IAAI,CAAC,IAAI,EACT;YACE,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;YAC5F,MAAM,EAAE,IAAI,CAAC,OAAO,KAAK,IAAI;YAC7B,cAAc,EAAE,KAAK;SACtB,CACF;KACJ,CAAC;CACH,CAAC,CAAA"}

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

@@ -0,0 +1,6 @@
+import type { Messenger } from "../../cli/messenger/context.js";
+import { type AnyTool } from "../tool.js";
+export declare const pollReadTools: (messenger: Messenger) => Record<string, AnyTool>;
+/** Offered with `--allow-send`, each under the permission its guard kind names. */
+export declare const pollWriteTools: (messenger: Messenger) => Record<string, AnyTool>;
+//# sourceMappingURL=polls.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"polls.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/polls.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAG/D,OAAO,EAAE,KAAK,OAAO,EAA6C,MAAM,YAAY,CAAA;AAIpF,eAAO,MAAM,aAAa,cAAe,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CA8BzE,CAAA;AAEF,mFAAmF;AACnF,eAAO,MAAM,cAAc,cAAe,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAuG3E,CAAA"}