@iola_adm/iola-cli 0.2.31 → 0.2.33

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iola_adm/iola-cli",
-  "version": "0.2.31",
+  "version": "0.2.33",
   "description": "CLI и AI-агент городского округа Йошкар-Ола.",
   "license": "MIT",
   "homepage": "https://github.com/adm-iola/iola-cli#readme",

package/skills/yandex-services/SKILL.md

@@ -27,8 +27,15 @@ description: Сервисы Яндекса через Yandex Connector: ID, Ди
 - `yandex_mail_read` - прочитать письмо по UID; обычное чтение помечает письмо прочитанным.
 - `yandex_mail_send` - отправить письмо.
 - `yandex_mail_reply` - ответить на письмо по UID.
+- `yandex_mail_forward` - переслать письмо.
 - `yandex_mail_delete` - переместить письмо в корзину.
 - `yandex_mail_mark` - пометить письмо прочитанным или непрочитанным.
+- `yandex_mail_save_to_disk` - сохранить письмо на Яндекс Диск в Markdown.
+- `yandex_mail_create_calendar_event` - создать событие календаря из письма.
+- `yandex_mail_sender_to_contact` - добавить отправителя письма в контакты.
+- `yandex_mail_city_context` - найти в письме школы/детские сады/ИНН и подтянуть открытые городские слои.
+- `yandex_mail_map_addresses` - найти адреса в письме и дать ссылки на Яндекс.Карты.
+- `yandex_mail_create_task` - создать локальную задачу по письму.
 - Автоопрос почты включается командой `iola yandex mail-watch on --minutes 5`, выключается `iola yandex mail-watch off`, ручная проверка `iola yandex mail-watch tick`.
 - `yandex_calendar_status` - проверить доступ к Яндекс Календарю.
 - `yandex_calendar_list` - показать события.
@@ -36,13 +43,15 @@ description: Сервисы Яндекса через Yandex Connector: ID, Ди
 - `yandex_contacts_status` - проверить доступ к Яндекс Контактам.
 - `yandex_contacts_list` - показать контакты.
 - `yandex_contacts_search` - найти контакт.
+- `yandex_contacts_create` - создать новый контакт.
 - `yandex_contacts_add_email` - добавить email в существующий контакт.
 - `yandex_telemost_create_event` - создать календарное событие для встречи.
 
 Безопасность:
 
 - Для отправки письма, ответа на письмо, удаления письма, удаления файлов, публикации ссылки и создания событий нужен явный запрос пользователя и `confirm=true`.
-- Не отправляй письма, не отвечай на письма, не удаляй письма/файлы и не публикуй ссылки по косвенному намерению.
+- Для пересылки письма, создания контакта, создания события из письма и добавления отправителя в контакты также нужен явный запрос пользователя и `confirm=true`.
+- Не отправляй письма, не отвечай на письма, не пересылай письма, не создавай контакты/события, не удаляй письма/файлы и не публикуй ссылки по косвенному намерению.
 - Список писем и поиск не должны помечать письма прочитанными. Чтение письма по просьбе пользователя помечает письмо прочитанным.
 - Если пользователь просит отправить письмо по имени контакта, сначала ищи контакт. Если контактов несколько, покажи варианты и попроси уточнить. Если контакта нет или у него нет email, скажи прямо.
 - Если пользователь отправил письмо на введенный email и указал имя контакта, можно предложить добавить email в найденный контакт без email.

package/src/cli.js

@@ -170,14 +170,22 @@ const YANDEX_TOOLS = [
   "yandex_mail_read",
   "yandex_mail_send",
   "yandex_mail_reply",
+  "yandex_mail_forward",
   "yandex_mail_delete",
   "yandex_mail_mark",
+  "yandex_mail_save_to_disk",
+  "yandex_mail_create_calendar_event",
+  "yandex_mail_sender_to_contact",
+  "yandex_mail_city_context",
+  "yandex_mail_map_addresses",
+  "yandex_mail_create_task",
   "yandex_calendar_status",
   "yandex_calendar_create_event",
   "yandex_calendar_list",
   "yandex_contacts_status",
   "yandex_contacts_list",
   "yandex_contacts_search",
+  "yandex_contacts_create",
   "yandex_contacts_add_email",
   "yandex_telemost_create_event",
 ];
@@ -4007,14 +4015,22 @@ async function executeYandexTool(tool, args = {}) {
   if (tool === "yandex_mail_read") return yandexMailRead(args.uid || args.id, { mailbox: await resolveYandexMailbox(args.mailbox || args.folder || "INBOX"), markSeen: args.markSeen !== false });
   if (tool === "yandex_mail_send") return yandexMailSend(args);
   if (tool === "yandex_mail_reply") return yandexMailReply(args);
+  if (tool === "yandex_mail_forward") return yandexMailForward(args);
   if (tool === "yandex_mail_delete") return yandexMailDelete(args.uid || args.id, { ...args, mailbox: await resolveYandexMailbox(args.mailbox || args.folder || "INBOX") });
   if (tool === "yandex_mail_mark") return yandexMailMark(args.uid || args.id, args.seen !== false && args.unread !== true, { mailbox: await resolveYandexMailbox(args.mailbox || args.folder || "INBOX") });
+  if (tool === "yandex_mail_save_to_disk") return yandexMailSaveToDisk(args.uid || args.id, args);
+  if (tool === "yandex_mail_create_calendar_event") return yandexMailCreateCalendarEvent(args.uid || args.id, args);
+  if (tool === "yandex_mail_sender_to_contact") return yandexMailSenderToContact(args.uid || args.id, args);
+  if (tool === "yandex_mail_city_context") return yandexMailCityContext(args.uid || args.id, args);
+  if (tool === "yandex_mail_map_addresses") return yandexMailMapAddresses(args.uid || args.id, args);
+  if (tool === "yandex_mail_create_task") return yandexMailCreateTask(args.uid || args.id, args);
   if (tool === "yandex_calendar_status") return yandexCalendarStatus();
   if (tool === "yandex_calendar_create_event") return yandexCalendarCreateEvent(args);
   if (tool === "yandex_calendar_list") return yandexCalendarList(args);
   if (tool === "yandex_contacts_status") return yandexContactsStatus();
   if (tool === "yandex_contacts_list") return yandexContactsList(args);
   if (tool === "yandex_contacts_search") return yandexContactsSearch(args.query || "", args);
+  if (tool === "yandex_contacts_create") return yandexContactsCreate(args);
   if (tool === "yandex_contacts_add_email") return yandexContactsAddEmail(args.query || args.name || "", args.email, args);
   if (tool === "yandex_telemost_create_event") return yandexTelemostCreateEvent(args);
   throw new Error(`Yandex tool неизвестен: ${tool}`);
@@ -4132,8 +4148,13 @@ async function yandexMailCount(options = {}) {
 async function yandexMailSearch(query, options = {}) {
   const normalized = normalizeGeoText(query);
   if (!normalized) return yandexMailList(options);
+  const tokens = normalized.split(/\s+/u).filter((token) => token.length > 2 && !/^(про|обо?|где|что|кто|как)$/iu.test(token));
   const rows = await yandexMailList({ ...options, limit: Math.max(50, Number(options.limit || 20) * 3) });
-  return rows.filter((row) => normalizeGeoText(`${row.from} ${row.subject} ${row.snippet}`).includes(normalized)).slice(0, Number(options.limit || 20));
+  return rows.filter((row) => {
+    const haystack = normalizeGeoText(`${row.from} ${row.subject} ${row.snippet}`);
+    if (haystack.includes(normalized)) return true;
+    return tokens.length > 0 && tokens.every((token) => haystack.includes(token));
+  }).slice(0, Number(options.limit || 20));
 }
 
 async function yandexMailWatchTick(options = {}) {
@@ -4189,7 +4210,7 @@ async function yandexMailRead(uid, options = {}) {
   try {
     await imapAuthenticate(session, email, token);
     await imapCommand(session, `SELECT ${quoteImapMailbox(options.mailbox || "INBOX")}`);
-    const bodyAccessor = options.markSeen === false ? "BODY.PEEK[TEXT]" : "BODY[TEXT]";
+    const bodyAccessor = options.markSeen === false ? "BODY.PEEK[]" : "BODY[]";
     const fetch = await imapCommand(session, `UID FETCH ${Number(uid)} (UID FLAGS RFC822.SIZE BODY.PEEK[HEADER.FIELDS (DATE FROM SUBJECT MESSAGE-ID REFERENCES)] ${bodyAccessor})`, { timeout: 60000 });
     return parseImapFetchSummaries(fetch, { full: true })[0] || { uid, status: "not-found" };
   } finally {
@@ -4255,6 +4276,123 @@ async function yandexMailReply(args = {}) {
   return { ...result, replyToUid: Number(uid), originalFrom: original.from };
 }
 
+async function yandexMailForward(args = {}) {
+  if (!args.confirm) throw new Error("Для пересылки письма нужен аргумент confirm=true.");
+  const uid = args.uid || args.id;
+  const to = Array.isArray(args.to) ? args.to : String(args.to || "").split(/[;,]/).map((item) => item.trim()).filter(Boolean);
+  if (!uid) throw new Error("UID письма обязателен.");
+  if (!to.length) throw new Error("Получатель пересылки не указан.");
+  const original = await yandexMailRead(uid, { mailbox: await resolveYandexMailbox(args.mailbox || args.folder || "INBOX"), markSeen: true });
+  if (!original || original.status === "not-found") throw new Error(`Письмо #${uid} не найдено.`);
+  const text = [
+    args.text || args.comment || "",
+    "",
+    "---------- Пересланное письмо ----------",
+    `От: ${original.from || "-"}`,
+    `Дата: ${original.date || "-"}`,
+    `Тема: ${original.subject || "(без темы)"}`,
+    "",
+    original.snippet || "",
+  ].join("\n").trim();
+  return yandexMailSend({ to, subject: `Fwd: ${original.subject || "(без темы)"}`, text, confirm: true });
+}
+
+async function yandexMailSaveToDisk(uid, args = {}) {
+  if (!uid) throw new Error("UID письма обязателен.");
+  const row = await yandexMailRead(uid, { mailbox: await resolveYandexMailbox(args.mailbox || args.folder || "INBOX"), markSeen: args.markSeen !== false });
+  if (!row || row.status === "not-found") throw new Error(`Письмо #${uid} не найдено.`);
+  const safeSubject = slugForFile(row.subject || `mail-${uid}`).slice(0, 80);
+  const remotePath = args.path || args.remotePath || `${CLOUD_DEFAULT_REMOTE_DIR}/Почта/mail-${uid}-${safeSubject}.md`;
+  const text = [
+    `# ${row.subject || "(без темы)"}`,
+    "",
+    `- UID: ${row.uid}`,
+    `- От: ${row.from || "-"}`,
+    `- Дата: ${row.date || "-"}`,
+    "",
+    row.snippet || "",
+  ].join("\n");
+  const saved = await yandexDiskSaveText(text, remotePath);
+  return { ...saved, uid: row.uid, subject: row.subject };
+}
+
+async function yandexMailCreateCalendarEvent(uid, args = {}) {
+  if (!args.confirm) throw new Error("Для создания события из письма нужен аргумент confirm=true.");
+  if (!uid) throw new Error("UID письма обязателен.");
+  const row = await yandexMailRead(uid, { mailbox: await resolveYandexMailbox(args.mailbox || args.folder || "INBOX"), markSeen: true });
+  if (!row || row.status === "not-found") throw new Error(`Письмо #${uid} не найдено.`);
+  const detected = extractDateTimeFromText(`${row.subject}\n${row.snippet}`);
+  const start = args.start || detected.start || new Date(Date.now() + 3600000).toISOString();
+  const end = args.end || detected.end || new Date(new Date(start).getTime() + 3600000).toISOString();
+  return yandexCalendarCreateEvent({
+    title: args.title || row.subject || `Письмо #${uid}`,
+    description: [`Создано из письма #${uid}.`, `От: ${row.from || "-"}`, "", row.snippet || ""].join("\n"),
+    location: args.location || detected.location || "",
+    start,
+    end,
+    confirm: true,
+  });
+}
+
+async function yandexMailSenderToContact(uid, args = {}) {
+  if (!args.confirm) throw new Error("Для добавления отправителя в контакты нужен аргумент confirm=true.");
+  if (!uid) throw new Error("UID письма обязателен.");
+  const row = await yandexMailRead(uid, { mailbox: await resolveYandexMailbox(args.mailbox || args.folder || "INBOX"), markSeen: false });
+  if (!row || row.status === "not-found") throw new Error(`Письмо #${uid} не найдено.`);
+  const email = extractEmailAddress(row.from);
+  const name = extractDisplayName(row.from) || email;
+  if (!email) throw new Error("В отправителе письма не найден email.");
+  return yandexContactsCreate({ name, email, confirm: true });
+}
+
+async function yandexMailCityContext(uid, args = {}) {
+  if (!uid) throw new Error("UID письма обязателен.");
+  const row = await yandexMailRead(uid, { mailbox: await resolveYandexMailbox(args.mailbox || args.folder || "INBOX"), markSeen: false });
+  if (!row || row.status === "not-found") throw new Error(`Письмо #${uid} не найдено.`);
+  const text = `${row.subject}\n${row.snippet}`;
+  const queries = extractEducationQueriesFromText(text);
+  const results = [];
+  for (const query of queries) {
+    results.push(...searchLocalRecords(query, { dataset: "all", limit: 5, fts: true }));
+  }
+  const unique = dedupeBy(results, (item) => `${item.dataset || ""}:${item.inn || item.name}`);
+  return unique.slice(0, Number(args.limit || 10)).map((item) => ({
+    name: item.name,
+    inn: item.inn,
+    address: item.address,
+    phone: item.phone,
+    email: item.email,
+    website: item.website,
+    dataset: item.dataset,
+  }));
+}
+
+async function yandexMailMapAddresses(uid, args = {}) {
+  if (!uid) throw new Error("UID письма обязателен.");
+  const row = await yandexMailRead(uid, { mailbox: await resolveYandexMailbox(args.mailbox || args.folder || "INBOX"), markSeen: false });
+  if (!row || row.status === "not-found") throw new Error(`Письмо #${uid} не найдено.`);
+  const addresses = extractLikelyAddresses(`${row.subject}\n${row.snippet}`).slice(0, Number(args.limit || 5));
+  const rows = [];
+  for (const address of addresses) {
+    const point = await geocodeCached(address).catch(() => null);
+    rows.push({
+      address,
+      resolved: point?.address || "",
+      map: point?.lat && point?.lon ? `https://yandex.ru/maps/?pt=${point.lon},${point.lat}&z=16&l=map` : "",
+    });
+  }
+  return rows;
+}
+
+async function yandexMailCreateTask(uid, args = {}) {
+  if (!uid) throw new Error("UID письма обязателен.");
+  const row = await yandexMailRead(uid, { mailbox: await resolveYandexMailbox(args.mailbox || args.folder || "INBOX"), markSeen: false });
+  if (!row || row.status === "not-found") throw new Error(`Письмо #${uid} не найдено.`);
+  const title = args.title || `Ответить/разобрать письмо #${uid}: ${row.subject || "(без темы)"}`;
+  const id = addTask(title, `ask "прочитай письмо #${uid}"`);
+  return { id, title, uid: Number(uid), status: "open" };
+}
+
 async function yandexMailSend(args = {}) {
   if (!args.confirm) throw new Error("Для отправки письма нужен аргумент confirm=true.");
   const to = Array.isArray(args.to) ? args.to : String(args.to || "").split(/[;,]/).map((item) => item.trim()).filter(Boolean);
@@ -4513,14 +4651,14 @@ function stripMailBody(value) {
   const raw = String(value || "").replace(/\r/g, "");
   const withoutFetch = raw
     .replace(/^\* \d+ FETCH[^\n]*\n?/u, "")
-    .replace(/^BODY\[[^\n]*\]\s*\{\d+\}\n?/imu, "")
+    .replace(/^BODY(?:\.PEEK)?\[[^\n]*\]\s*\{\d+\}\n?/imu, "")
     .replace(/\n\)\s*$/u, "");
-  const bodyMatch = withoutFetch.match(/BODY\[TEXT\]\s*\{\d+\}\s*([\s\S]*)/iu);
+  const bodyMatch = withoutFetch.match(/BODY(?:\.PEEK)?\[[^\n]*\]\s*\{\d+\}\s*([\s\S]*)/iu);
   if (bodyMatch?.[1]) return extractMimeText(bodyMatch[1]);
   const headerEnd = withoutFetch.indexOf("\n\n");
   if (headerEnd < 0) return withoutFetch.replace(/[^\S\n]+/g, " ").trim();
   const headers = withoutFetch.slice(0, headerEnd);
-  const body = withoutFetch.slice(headerEnd + 2).replace(/^BODY\[[^\n]*\]\s*\{\d+\}\n?/imu, "");
+  const body = withoutFetch.slice(headerEnd + 2).replace(/^BODY(?:\.PEEK)?\[[^\n]*\]\s*\{\d+\}\n?/imu, "");
   return extractMimeText(`${headers}\n\n${body}`);
 }
 
@@ -4557,17 +4695,52 @@ function decodeMailPart(part) {
   const encoding = headers.match(/^Content-Transfer-Encoding:\s*([^\n]+)/imu)?.[1]?.trim().toLocaleLowerCase("en-US") || "";
   let decoded = body;
   if (encoding === "base64") {
-    decoded = Buffer.from(body.replace(/\s+/g, ""), "base64").toString("utf8");
+    const clean = body.replace(/\s+/g, "");
+    decoded = /^[A-Z0-9+/]+={0,2}$/iu.test(clean) && clean.length >= 8
+      ? Buffer.from(clean, "base64").toString("utf8")
+      : body;
   } else if (encoding === "quoted-printable") {
     decoded = decodeQuotedPrintable(body);
+  } else {
+    const clean = body.replace(/\s+/g, "");
+    if (/^[A-Z0-9+/]+={0,2}$/iu.test(clean) && clean.length >= 80) {
+      const candidate = Buffer.from(clean, "base64").toString("utf8");
+      if (/(<!doctype|<html|<body|[А-Яа-яЁё]{3,})/u.test(candidate)) decoded = candidate;
+    }
   }
-  return decoded.replace(/<[^>]+>/g, " ").replace(/[^\S\n]+/g, " ").replace(/\n{3,}/g, "\n\n").trim();
+  decoded = decodeEmbeddedBase64MailBody(decoded);
+  const cleaned = decoded
+    .replace(/<style\b[\s\S]*?<\/style>/giu, " ")
+    .replace(/<script\b[\s\S]*?<\/script>/giu, " ")
+    .replace(/<[^>]+>/g, " ")
+    .replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F-\u009F]+/gu, " ")
+    .replace(/[^\S\n]+/g, " ")
+    .replace(/\n{3,}/g, "\n\n")
+    .trim();
+  const firstCyrillic = cleaned.search(/[А-Яа-яЁё]{3,}/u);
+  if (firstCyrillic > 0 && firstCyrillic < 120 && cleaned.slice(0, firstCyrillic).includes("�")) {
+    return cleaned.slice(firstCyrillic).trim();
+  }
+  return cleaned;
 }
 
 function decodeQuotedPrintable(value) {
   return Buffer.from(String(value || "").replace(/=\n/gu, "").replace(/=([A-F0-9]{2})/giu, (_, hex) => String.fromCharCode(parseInt(hex, 16))), "binary").toString("utf8");
 }
 
+function decodeEmbeddedBase64MailBody(value) {
+  const text = String(value || "");
+  if (/(<!doctype|<html|<body|[А-Яа-яЁё]{3,})/u.test(text) && !/[A-Z0-9+/]{120,}/u.test(text)) return text;
+  const matches = text.match(/[A-Z0-9+/=\s]{160,}/giu) || [];
+  for (const match of matches) {
+    const clean = match.replace(/\s+/g, "");
+    if (!/^[A-Z0-9+/]+={0,2}$/iu.test(clean) || clean.length < 160) continue;
+    const candidate = Buffer.from(clean, "base64").toString("utf8");
+    if (/(<!doctype|<html|<body|[А-Яа-яЁё]{3,})/u.test(candidate)) return candidate;
+  }
+  return text;
+}
+
 async function yandexDavRequest(url, token, options = {}) {
   const response = await fetch(url, {
     method: options.method || "GET",
@@ -4715,6 +4888,33 @@ async function yandexContactsAddEmail(query, email, args = {}) {
   return { status: "updated", name: contact.name, email };
 }
 
+async function yandexContactsCreate(args = {}) {
+  if (!args.confirm) throw new Error("Для создания контакта нужен аргумент confirm=true.");
+  const name = String(args.name || args.email || "").trim();
+  const email = String(args.email || "").trim();
+  if (!name) throw new Error("Имя контакта обязательно.");
+  if (!email || !/[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}/iu.test(email)) throw new Error("Корректный email обязателен.");
+  const token = await requireYandexOAuthToken("organizer", "Яндекс Контакты");
+  const baseUrl = await yandexContactsBaseUrl(token);
+  const uid = `${randomUUID()}@iola-cli`;
+  const card = [
+    "BEGIN:VCARD",
+    "VERSION:3.0",
+    `UID:${uid}`,
+    `FN:${escapeVcardValue(name)}`,
+    `EMAIL;TYPE=INTERNET:${email}`,
+    "END:VCARD",
+    "",
+  ].join("\r\n");
+  await yandexDavRequest(new URL(`${encodeURIComponent(uid)}.vcf`, baseUrl).toString(), token, {
+    method: "PUT",
+    headers: { "content-type": "text/vcard; charset=utf-8" },
+    body: card,
+    timeout: 45000,
+  });
+  return { status: "created", name, email, uid };
+}
+
 function upsertVcardEmail(card, email, options = {}) {
   const text = String(card || "").replace(/\r/g, "").trim();
   if (!text.includes("BEGIN:VCARD")) throw new Error("Контакт не похож на vCard.");
@@ -4725,6 +4925,10 @@ function upsertVcardEmail(card, email, options = {}) {
   return text.replace(/\nEND:VCARD/iu, `\nEMAIL;TYPE=INTERNET:${email}\nEND:VCARD`);
 }
 
+function escapeVcardValue(value) {
+  return String(value || "").replace(/\\/g, "\\\\").replace(/\n/g, "\\n").replace(/,/g, "\\,").replace(/;/g, "\\;");
+}
+
 function contactMatchesQuery(contact, normalizedQuery) {
   const contactText = normalizeContactLookupText(`${contact.name || ""} ${contact.email || ""}`);
   if (!contactText || !normalizedQuery) return false;
@@ -10040,6 +10244,51 @@ async function buildYandexDirectAnswer(question, history = []) {
         const result = await yandexMailReply({ ...reply, confirm: true });
         return `Ответ отправлен на письмо #${result.replyToUid}: ${result.to.join(", ")}. Тема: ${result.subject}.`;
       }
+      if (/(перешли|переслать|перешли\s+письмо|fwd|forward)/iu.test(normalized)) {
+        const uid = resolveYandexMailUidFromQuestion(question, previousAssistantText);
+        const to = [...String(question || "").matchAll(/[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}/giu)].map((match) => match[0]);
+        if (!uid || !to.length) return "Для пересылки укажите письмо и получателя. Пример: перешли письмо #2382 user@example.com.";
+        const result = await yandexMailForward({ uid, to, confirm: true });
+        return `Письмо переслано: ${result.to.join(", ")}. Тема: ${result.subject}.`;
+      }
+      if (/(сохрани|запиши).{0,60}(диск|яндекс.?диск|облак)/iu.test(normalized)) {
+        const uid = resolveYandexMailUidFromQuestion(question, previousAssistantText);
+        if (!uid) return "Какое письмо сохранить на Диск? Укажите номер из списка или UID.";
+        const result = await yandexMailSaveToDisk(uid, { mailbox: extractYandexMailboxName(question) || "INBOX" });
+        return `Письмо #${uid} сохранено на Яндекс Диск: ${result.remote || result.path}.`;
+      }
+      if (/(создай|добавь).{0,40}(событи|встреч|календар)/iu.test(normalized)) {
+        const uid = resolveYandexMailUidFromQuestion(question, previousAssistantText);
+        if (!uid) return "Из какого письма создать событие? Укажите номер из списка или UID.";
+        const result = await yandexMailCreateCalendarEvent(uid, { mailbox: extractYandexMailboxName(question) || "INBOX", confirm: true });
+        return `Событие создано в Яндекс Календаре: ${result.title || result.uid}.`;
+      }
+      if (/(добавь|создай|сохрани).{0,50}(отправител|автор|контакт)/iu.test(normalized)) {
+        const uid = resolveYandexMailUidFromQuestion(question, previousAssistantText);
+        if (!uid) return "Из какого письма добавить отправителя в контакты? Укажите номер из списка или UID.";
+        const result = await yandexMailSenderToContact(uid, { mailbox: extractYandexMailboxName(question) || "INBOX", confirm: true });
+        return `Контакт создан: ${result.name}, ${result.email}.`;
+      }
+      if (/(школ|сад|детсад|инн|городск|сло[йи]|йошкар)/iu.test(normalized) && /(письм|письма|письме)/iu.test(normalized)) {
+        const uid = resolveYandexMailUidFromQuestion(question, previousAssistantText);
+        if (!uid) return "По какому письму проверить городские слои? Укажите номер из списка или UID.";
+        const rows = await yandexMailCityContext(uid, { mailbox: extractYandexMailboxName(question) || "INBOX" });
+        if (!rows.length) return "В письме не нашел совпадений со слоями школ и детских садов.";
+        return ["Нашел в городских слоях:", ...rows.map((row, index) => `${index + 1}. ${row.name}${row.inn ? `, ИНН ${row.inn}` : ""}${row.address ? `, ${row.address}` : ""}`)].join("\n");
+      }
+      if (/(адрес|карт|место|где)/iu.test(normalized) && /(письм|письма|письме)/iu.test(normalized)) {
+        const uid = resolveYandexMailUidFromQuestion(question, previousAssistantText);
+        if (!uid) return "Из какого письма взять адрес? Укажите номер из списка или UID.";
+        const rows = await yandexMailMapAddresses(uid, { mailbox: extractYandexMailboxName(question) || "INBOX" });
+        if (!rows.length) return "В письме не нашел адресов для карты.";
+        return ["Адреса из письма:", ...rows.map((row, index) => `${index + 1}. ${row.resolved || row.address}${row.map ? `\n${row.map}` : ""}`)].join("\n");
+      }
+      if (/(создай|добавь).{0,30}(задач|напомин)/iu.test(normalized)) {
+        const uid = resolveYandexMailUidFromQuestion(question, previousAssistantText);
+        if (!uid) return "По какому письму создать задачу? Укажите номер из списка или UID.";
+        const result = await yandexMailCreateTask(uid, { mailbox: extractYandexMailboxName(question) || "INBOX" });
+        return `Задача создана #${result.id}: ${result.title}.`;
+      }
       if (/(удали|удалить|перемести\s+в\s+корзин)/iu.test(normalized)) {
         const uid = resolveYandexMailUidFromQuestion(question, previousAssistantText);
         if (!uid) return "Какое письмо удалить? Укажите номер из списка или UID, например: удали письмо #2382.";
@@ -10157,7 +10406,7 @@ function isYandexServiceQuestion(normalized) {
 
 function isYandexIdentityQuestion(normalized) {
   const text = String(normalized || "");
-  return /(аккаунт|профил|логин|кто подключен|какой.*подключен|email|e-mail)/iu.test(text)
+  return /(аккаунт|аккант|акант|акаунт|акк?аунт|профил|логин|кто подключен|какой.*подключ|email|e-mail)/iu.test(text)
     && /(яндекс|яндес|язндекс|язндекс|яндкс|yandex)/iu.test(text);
 }
 
@@ -10169,7 +10418,7 @@ function isYandexMailFollowupQuestion(normalized, question) {
 }
 
 function cleanupYandexQuery(question) {
-  const stop = /^(?:в|на|у|из|для|по|яндекс|yandex|найди|поиск|покажи|посмотри|проверь|почт\p{L}*|письм\p{L}*|календар\p{L}*|контакт\p{L}*)$/iu;
+  const stop = /^(?:в|на|у|из|для|по|про|о|об|обо|яндекс|yandex|найди|поиск|покажи|посмотри|проверь|почт\p{L}*|письм\p{L}*|календар\p{L}*|контакт\p{L}*)$/iu;
   return String(question || "")
     .replace(/[?.!]+$/u, "")
     .split(/[^\p{L}\p{N}@._+-]+/gu)
@@ -10309,6 +10558,79 @@ function formatYandexMailRead(row) {
   ].filter((line) => line !== "").join("\n");
 }
 
+function slugForFile(value) {
+  return String(value || "")
+    .toLocaleLowerCase("ru-RU")
+    .replace(/[^\p{L}\p{N}._-]+/gu, "-")
+    .replace(/-+/g, "-")
+    .replace(/^-|-$/g, "")
+    || "item";
+}
+
+function extractDisplayName(value) {
+  const text = decodeMimeHeader(String(value || "").trim());
+  return text.match(/^(.+?)\s*<[^<>]+>/u)?.[1]?.replace(/^["']|["']$/g, "").trim() || "";
+}
+
+function extractDateTimeFromText(value) {
+  const text = String(value || "").toLocaleLowerCase("ru-RU");
+  let date = null;
+  if (/завтра/u.test(text)) date = new Date(Date.now() + 86400000);
+  if (/послезавтра/u.test(text)) date = new Date(Date.now() + 2 * 86400000);
+  const explicit = text.match(/(\d{1,2})[.\-/](\d{1,2})(?:[.\-/](\d{2,4}))?/u);
+  if (explicit) {
+    const year = explicit[3] ? Number(explicit[3].length === 2 ? `20${explicit[3]}` : explicit[3]) : new Date().getFullYear();
+    date = new Date(year, Number(explicit[2]) - 1, Number(explicit[1]), 9, 0, 0);
+  }
+  const time = text.match(/(?:в\s*)?(\d{1,2})[:.](\d{2})/u) || text.match(/(?:в\s+)(\d{1,2})\s*(?:час|ч\b)?/u);
+  if (!date && time) date = new Date();
+  if (date && time) {
+    date.setHours(Number(time[1]), Number(time[2] || 0), 0, 0);
+  }
+  if (!date) return {};
+  const start = date.toISOString();
+  const end = new Date(date.getTime() + 3600000).toISOString();
+  const location = extractLikelyAddresses(value)[0] || "";
+  return { start, end, location };
+}
+
+function extractEducationQueriesFromText(value) {
+  const text = String(value || "");
+  const queries = [];
+  for (const match of text.matchAll(/(?:школ[ауыи]?|сош|гимнази[яи]|лице[йя])\s*№?\s*(\d{1,3})/giu)) queries.push(`школа ${match[1]}`);
+  for (const match of text.matchAll(/(?:детск\w*\s+сад|детсад|садик)\s*№?\s*(\d{1,3})/giu)) queries.push(`детский сад ${match[1]}`);
+  for (const match of text.matchAll(/\bинн\s*(\d{10,12})\b/giu)) queries.push(match[1]);
+  return [...new Set(queries)];
+}
+
+function extractLikelyAddresses(value) {
+  const text = String(value || "").replace(/\s+/g, " ");
+  const rows = [];
+  const patterns = [
+    /(?:адрес|по адресу|место)\s*:?\s*([^.!?\n]{8,120})/giu,
+    /((?:ул\.?|улица|проспект|пр-т|бульвар|пер\.?|переулок)\s+[^.!?\n,]{3,80}(?:,\s*(?:д\.?\s*)?\d+[а-яa-z]?)?)/giu,
+  ];
+  for (const pattern of patterns) {
+    for (const match of text.matchAll(pattern)) {
+      const address = String(match[1] || "").trim().replace(/[;,]+$/u, "");
+      if (address.length >= 8 && !/https?:|www\.|@/iu.test(address) && /(ул\.?|улица|проспект|пр-т|бульвар|пер\.?|переулок|дом|д\.|\d)/iu.test(address)) rows.push(address);
+    }
+  }
+  return [...new Set(rows)].slice(0, 10);
+}
+
+function dedupeBy(rows, keyFn) {
+  const seen = new Set();
+  const result = [];
+  for (const row of rows) {
+    const key = keyFn(row);
+    if (seen.has(key)) continue;
+    seen.add(key);
+    result.push(row);
+  }
+  return result;
+}
+
 async function buildCloudDirectAnswer(question) {
   if (!isCloudQuestion(question)) return "";
   const normalized = String(question || "").toLocaleLowerCase("ru-RU");
@@ -10918,8 +11240,8 @@ async function buildLocalToolPlan(question, providerConfig, options) {
     `Доступные tools: ${availableToolNames(options).join(", ")}.`,
     "Схема: {\"steps\":[{\"tool\":\"search_data\",\"args\":{\"dataset\":\"schools|kindergartens|all\",\"query\":\"text\",\"limit\":10}}]}",
     "Минимальные tools: search_data {dataset,query,limit}, get_card {query}, export_report {name,format,output}, file_read {path}, browser_open {url}.",
-    "Yandex tools: yandex_identity_me {}, yandex_disk_ls {path}, yandex_disk_mkdir {path}, yandex_disk_find {query,path}, yandex_disk_save_text {path,text}, yandex_mail_folders {}, yandex_mail_list {mailbox,limit,unread}, yandex_mail_search {mailbox,query}, yandex_mail_read {mailbox,uid}, yandex_mail_mark {mailbox,uid,seen}, yandex_calendar_list {start,end}, yandex_contacts_search {query}.",
-    "Опасные Yandex tools используй только при явной просьбе пользователя и с confirm=true: yandex_disk_share, yandex_disk_delete, yandex_mail_send, yandex_mail_reply, yandex_mail_delete, yandex_calendar_create_event, yandex_telemost_create_event.",
+    "Yandex tools: yandex_identity_me {}, yandex_disk_ls {path}, yandex_disk_mkdir {path}, yandex_disk_find {query,path}, yandex_disk_save_text {path,text}, yandex_mail_folders {}, yandex_mail_list {mailbox,limit,unread}, yandex_mail_search {mailbox,query}, yandex_mail_read {mailbox,uid}, yandex_mail_mark {mailbox,uid,seen}, yandex_mail_save_to_disk {uid,path}, yandex_mail_city_context {uid}, yandex_mail_map_addresses {uid}, yandex_mail_create_task {uid,title}, yandex_calendar_list {start,end}, yandex_contacts_search {query}.",
+    "Опасные Yandex tools используй только при явной просьбе пользователя и с confirm=true: yandex_disk_share, yandex_disk_delete, yandex_mail_send, yandex_mail_reply, yandex_mail_forward, yandex_mail_delete, yandex_mail_create_calendar_event, yandex_mail_sender_to_contact, yandex_contacts_create, yandex_contacts_add_email, yandex_calendar_create_event, yandex_telemost_create_event.",
     "MCP tools доступны как mcp:SERVER:TOOL, например mcp:iola-local:search.",
     "Для выгрузки CSV добавь export_report с format=csv и output, если пользователь назвал файл.",
     `Вопрос: ${question}`,

package/test/smoke-test.js

@@ -81,7 +81,7 @@ assertIncludes(cliSource, "язндекс", "Yandex direct router should tolerat
 assertIncludes(cliSource, "yandexMailCount", "Yandex mail should answer unread count questions directly");
 assertIncludes(cliSource, "resolveYandexMailUidFromQuestion", "Yandex mail follow-ups should resolve selected message UID");
 assertIncludes(cliSource, "extractYandexMailUidByOrdinal", "Yandex mail follow-ups should support numbered selections");
-assertIncludes(cliSource, "BODY[TEXT]", "Yandex mail read should mark opened messages as seen");
+assertIncludes(cliSource, "BODY[]", "Yandex mail read should fetch full MIME messages and mark opened messages as seen");
 assertIncludes(cliSource, "markSeen === false", "Yandex mail read should keep an explicit no-mark fallback");
 assertIncludes(cliSource, "yandex_mail_folders", "Yandex mail should expose folders as a tool");
 assertIncludes(cliSource, "yandex_mail_reply", "Yandex mail should expose reply as a tool");
@@ -94,6 +94,13 @@ assertIncludes(cliSource, "yandexMailWatchTick", "Yandex mail should support man
 assertIncludes(cliSource, "resolveYandexMailRecipientFromContacts", "Yandex mail should resolve recipients from contacts");
 assertIncludes(cliSource, "yandexContactsAddEmail", "Yandex contacts should support adding email to a contact");
 assertIncludes(cliSource, "yandex_contacts_add_email", "Yandex contacts add email should be exposed as a tool");
+assertIncludes(cliSource, "yandex_mail_save_to_disk", "Yandex mail should save messages to Yandex Disk");
+assertIncludes(cliSource, "yandex_mail_create_calendar_event", "Yandex mail should create calendar events from messages");
+assertIncludes(cliSource, "yandex_mail_city_context", "Yandex mail should connect messages with city data layers");
+assertIncludes(cliSource, "yandex_mail_map_addresses", "Yandex mail should map addresses from messages");
+assertIncludes(cliSource, "yandex_mail_create_task", "Yandex mail should create local tasks from messages");
+assertIncludes(cliSource, "yandex_mail_forward", "Yandex mail should support forwarding messages");
+assertIncludes(cliSource, "yandexContactsCreate", "Yandex contacts should support creating contacts");
 assertIncludes(cliSource, "buildCasualDirectAnswer(question)", "Casual greetings should bypass external AI providers");
 assertNotIncludes(cliSource, "Сервисы через запятую [identity,disk]", "Yandex setup should not ask for services during connector setup");
 if (!packageJson.files.includes("docs/assets/iola-oauth-icon.png")) {

package/wiki//320/241/320/272/320/270/320/273/320/273/321/213-/320/264/320/273/321/217-/320/266/320/270/321/202/320/265/320/273/320/265/320/271.md

@@ -180,10 +180,17 @@ iola geo services "Йошкар-Ола, улица Петрова, 15"
 - пометить письмо прочитанным или непрочитанным;
 - отправить письмо только после явного запроса;
 - ответить на письмо по UID или номеру из последнего списка;
+- переслать письмо другому получателю;
 - удалить письмо безопасно: переместить его в корзину, а не стирать безвозвратно.
 - включить автоопрос новых писем, например каждые 5 минут;
 - выключить автоопрос новых писем;
 - вручную проверить новые письма через mail-watch tick;
+- сохранить письмо на Яндекс Диск в Markdown;
+- создать событие календаря из письма;
+- добавить отправителя письма в контакты;
+- найти в письме школу, детский сад или ИНН и подтянуть карточку из открытых городских слоев;
+- найти адреса в письме и дать ссылки на Яндекс.Карты;
+- создать локальную задачу по письму;
 - отправить письмо по имени контакта из Яндекс Контактов;
 - если найдено несколько однофамильцев, попросить уточнить получателя;
 - если контакт найден, но email не указан, прямо сообщить об этом;