littlebearapps/outlook-assistant

Перечисляет письма из общего почтового ящика, к которому у вошедшего пользователя есть доступ (только чтение). Возвращает постраничные сообщения из указанного `sharedMailbox` (или псевдонима `email`) и `folder` (по умолчанию `inbox`) с полями id/subject/from/receivedDateTime/preview — та же структура, что и в режиме списка `search-emails`. Требует, чтобы общий почтовый ящик был делегирован вошедшему пользователю в Exchange (настраивается администратором). Используйте `outputVerbosity` для управления количеством полей и `count` (по умолчанию 25, макс. 50) для размера страницы. Для полноценного поиска и фильтрации по общему почтовому ящику лучше использовать `search-emails` с путём к папке, ограниченной этим ящиком.

Помечает или снимает пометку с писем с помощью основных категорий (созданных через `manage-category`). action=`set` (по умолчанию) заменяет текущий набор категорий письма на переданный массив `categories`. action=`add` добавляет категории к уже имеющимся на письме. action=`remove` удаляет только указанные категории, оставляя остальные. Принимает либо `messageId` (одно письмо), либо `messageIds` (пакетно через Graph `$batch`). `categories` сопоставляются по отображаемому имени: имена должны уже существовать в основном списке (сначала создайте их через `manage-category`). Возвращает подтверждение по каждому письму.

Просматривайте или получайте вложения электронных писем. action=`list` (по умолчанию) возвращает метаданные всех вложений для `messageId` (id, name, contentType, size, isInline) — только чтение. action=`view` возвращает содержимое текстовых/JSON/XML-вложений, отображаемых в письме, по `attachmentId`; двоичные типы требуют скачивания. action=`download` сохраняет вложение на диск в `outputDir` (по умолчанию системная временная папка, создаётся автоматически) и возвращает путь к сохранённому файлу. `messageId` обязателен для всех действий; `attachmentId` обязателен для view/download. Используйте `outputVerbosity`, чтобы управлять набором полей вывода для действия list.

Управляйте аутентификацией с Microsoft Graph API. Действие `status` (по умолчанию) возвращает текущее состояние аутентификации и автоматически обновляет токен доступа, если он истёк, но refresh-токен ещё действителен (около 90 дней). Вызывайте его сначала, чтобы проверить состояние перед другими инструментами. Действие `authenticate` запускает OAuth-процесс: с `method: "device-code"` (по умолчанию, работает без браузера) возвращает код и URL, который пользователь должен открыть; с `method: "browser"` открывает локальный сервер аутентификации на порту :3333 (предварительно выполните `npm run auth-server`). Передайте `force: true`, чтобы перепройти аутентификацию, даже если есть действующая сессия. Действие `device-code-complete` завершает аутентификацию через код устройства после того, как пользователь ввёл код в браузере — вызывайте его, когда аутентификация отобразится как успешная. Действие `about` возвращает версию сервера, настроенную аудиторию, список областей и другие диагностические данные. Токены сохраняются в `~/.outlook-assistant-tokens.json` и переживают перезапуски сервера.

Создайте новое событие календаря в календаре по умолчанию вошедшего в систему пользователя. Возвращает созданное событие с его `id`, `webLink` и (если есть участники) автоматически сгенерированной ссылкой на онлайн-встречу — участники получают приглашения при сохранении. Время использует настроенный часовой пояс (по умолчанию Australia/Melbourne; переопределяется через `OUTLOOK_DEFAULT_TIMEZONE`); опустите суффикс `Z`, чтобы передать местное время. Используйте `manage-event` action=`update`, чтобы изменить событие после создания, или `manage-event` action=`cancel`/`delete`, чтобы удалить его.

Полный жизненный цикл черновика для рабочих процессов с проверкой перед отправкой (разрушительные: охватывает `send` и `delete`). action=`create` сохраняет новый черновик в папке Drafts и возвращает его id (используйте `dryRun: true`, чтобы просмотреть без сохранения; `checkRecipients: true` сначала запускает mail-tips). action=`update` обновляет существующий черновик по `id` (изменяются только переданные поля). action=`send` отправляет существующий черновик - разделяет лимит запросов с `send-email`. action=`delete` безвозвратно удаляет черновик. action=`reply`/`reply-all` создает черновик ответа из сообщения `id` (используйте `comment`, чтобы добавить текст в начало - взаимно исключает с `body`). action=`forward` создает черновик пересылки (требует `id` и `to`). Белый список получателей применяется к create/update/forward. Возвращает объект черновика для create/update/reply/forward; подтверждение статуса для send/delete.

Экспортирует письма в файловые форматы для архивации, криминалистики или программной обработки. target=`message` (по умолчанию) экспортирует одно письмо по `id` в `savePath` — поддерживает `mime`/`eml`/`markdown`/`json`/`csv`. target=`messages` пакетно экспортирует либо явный массив `emailIds`, либо письма, подходящие под `searchQuery` (или сокращение `query`) в `outputDir` — поддерживает `markdown`/`json`/`csv`. target=`conversation` экспортирует всю ветку по `conversationId` в `outputDir` (по умолчанию в хронологическом порядке; передайте `order: "reverse"` для сортировки от новых к старым) — поддерживает `eml`/`mbox`/`markdown`/`json`/`html`/`csv`. target=`mime` возвращает сырые байты MIME в формате RFC-822 для `id` (используйте `headersOnly` только для заголовков, `base64` для кодированной передачи, `maxSize` для ограничения — по умолчанию 1 МБ). `includeAttachments` по умолчанию равен true для экспорта одного письма и false для пакетного. Поддерживаемые форматы зависят от цели — смотрите перечисление параметров.

Находит доступные для бронирования переговорные комнаты в организации пользователя через конечную точку Graph rooms (только чтение). Возвращает ресурсы комнат с полями displayName, emailAddress, building, floor, capacity и bookingType — подходит для передачи в `create-event` в качестве участников. Фильтрует по `query` (совпадение с именем/email), `building`, `floor` или минимальному `capacity`. Возвращает пустой список для личных аккаунтов (конечная точка rooms работает только в M365). Используйте `outputVerbosity`, чтобы управлять количеством полей.

Управление почтовыми папками (tool-level destructiveHint=true, потому что `delete` безвозвратно удаляет папку; `list` и `stats` — действия только для чтения, несмотря на аннотацию). action=`list` (по умолчанию) возвращает дерево папок с id/displayName/parentFolderId (включите `includeItemCounts` для непрочитанных/всего, `includeChildren` для иерархии). action=`create` создает новую папку внутри входящих (или внутри `folder`/`folderId`/`folderName`) и возвращает её id. action=`move` перемещает письма (массив `emailIds`) в `targetFolder`. action=`stats` возвращает счетчики (totalItemCount/unreadItemCount) — подходит для планирования пагинации; используйте с `outputVerbosity` чтобы уменьшить шум. action=`delete` безвозвратно удаляет папку и её содержимое — корзины нет.

Предварительная проверка получателя через Graph `POST /me/getMailTips` (только чтение; использует существующую область `Mail.Read` - без дополнительных разрешений). Возвращает подсказки по каждому получателю: автоматические ответы (отпуск), статус переполнения почтового ящика, пользовательские подсказки администратора, ограничения доставки, требования модерации, внешний или внутренний контекст, максимальный размер сообщения и количество участников группы (всего + внешние). Используйте перед `send-email` или `draft` action=`create`, чтобы выявить проблемы вроде автоматических ответов (OOO) или предупреждений о внешних получателях до отправки сообщения; `send-email`/`draft` принимают `checkRecipients: true`, чтобы вызывать это автоматически. Принимает строку с разделителями-запятыми или массив адресов; `tipTypes` фильтрует запрашиваемые подсказки (по умолчанию — все).

Выводит предстоящие события календаря для текущего пользователя (только чтение). Возвращает массив событий с полями id, subject, start/end, attendees, location, organiser и webLink. Используйте `count` (по умолчанию 10, максимум 50), чтобы управлять размером страницы; этот инструмент не фильтрует - для фильтрации запросов используйте Outlook UI или конкретные диапазоны дат через Graph. Время возвращается в настроенном часовом поясе (по умолчанию Australia/Melbourne; переопределяется через `OUTLOOK_DEFAULT_TIMEZONE`).

Читает или обновляет настройки на уровне почтового ящика (идемпотентно — безопасно повторять; set-операции работают как PATCH и сливаются с текущим состоянием). action=`get` (по умолчанию) возвращает настройки — используйте `section` для фильтрации (`language`, `timeZone`, `workingHours`, `automaticRepliesSetting` или `all`). action=`set-auto-replies` настраивает автоответ: `enabled` true/false, опционально `startDateTime`/`endDateTime` (ISO 8601) для запланированного режима, `internalReplyMessage` и (опционально) `externalReplyMessage`. action=`set-working-hours` обновляет расписание: `startTime`/`endTime` (HH:MM) и `daysOfWeek` (массив от `monday` до `sunday`). При set-действиях возвращает обновлённый объект настроек.

Управляет главным списком категорий пользователя (цветные метки, доступные в почте, календаре и контактах). action=`list` (по умолчанию) возвращает категории с id/displayName/color. action=`create` добавляет новую категорию — `displayName` обязателен, `color` опционален (preset0-preset24, например preset0=Red, preset7=Blue). action=`update` (псевдоним `set` — устарел) меняет имя/цвет по `id`. action=`delete` удаляет категорию — это НЕ снимает метки с уже помеченных сообщений; существующие сообщения сохраняют "осиротевшую" метку до ручной очистки. Используйте `apply-category` для маркировки/снятия меток с конкретных сообщений.

Полный CRUD над личными контактами Outlook текущего пользователя (деструктивная операция: включает действие `delete`). action=`list` (по умолчанию) возвращает контакты с пагинацией через `skip`/`count` (по умолчанию 50). action=`search` возвращает контакты, соответствующие `query` по имени или email (по умолчанию 25). action=`get` возвращает полную информацию о контакте по `id`. action=`create` добавляет новый контакт и возвращает его `id`. action=`update` обновляет переданные поля по `id` (изменяются только переданные поля). action=`delete` безвозвратно удаляет контакт по `id`. Используйте `outputVerbosity` (minimal/standard/full) на list/search, чтобы контролировать количество полей. Предпочитайте `search-people` для ранжирования по релевантности из разных источников (контакты + каталог + недавние сообщения) - этот инструмент ищет только по вашим личным контактам Outlook.

Управление существующим событием календаря (деструктивное: охватывает update/decline/cancel/delete — используйте dryRun, где поддерживается, для предварительного просмотра). action=`update` редактирует поля на месте через PATCH (subject, start, end, attendees, body, location, isOnlineMeeting, sensitivity, showAs, importance, categories, reminderMinutesBeforeStart) — изменяются только переданные поля; передайте `dryRun: true` для предварительного просмотра PATCH-нагрузки. action=`decline` отклоняет приглашение (опционально `comment`). action=`cancel` отменяет событие, которое вы организовали, и уведомляет участников. action=`delete` окончательно удаляет событие. Возвращает обновлённое событие при update; в остальных случаях — подтверждение статуса. Примечание: action `accept` отсутствует — принимайте приглашения в интерфейсе Outlook (глагол accept в Graph ненадёжен для событий).

Управляет переопределениями Фокусированного ящика — явными правилами, которые заставляют сообщения от указанного отправителя попадать в «Фокус» или «Другое» независимо от классификации ML. `action=list` (по умолчанию) возвращает существующие переопределения с id/отправителем/классификацией. `action=set` создаёт или обновляет переопределение для `emailAddress` (опционально `name`), направляя будущие письма в `focused` (по умолчанию) или `other`. `action=delete` удаляет переопределение для `emailAddress`. Примечание: это работает только для аккаунтов, у которых включен Фокусированный ящик — личные аккаунты Outlook.com без него возвращают пустой список.

CRUD правил входящей почты на стороне сервера (деструктивный: включает `delete`; поддерживает `dryRun` при создании/обновлении для предварительного просмотра). Правила выполняются на сервере Exchange независимо от того, какой клиент открыт. `action=list` (по умолчанию) возвращает правила с id/name/sequence — передайте `includeDetails: true`, чтобы развернуть условия/действия/исключения. `action=create` создаёт новое правило из параметров условий (12 поддерживаемых: fromAddresses, containsSubject, bodyContains, hasAttachments, importance, sentTo, sensitivity и т.д.), параметров действий (9 поддерживаемых: moveToFolder, forwardTo, redirectTo, assignCategories, markAsRead, delete и т.д.) и опциональных исключений `except*`. `action=update` исправляет указанные поля по `ruleId`. `action=reorder` меняет приоритет выполнения через `sequence` (меньше — раньше). `action=delete` удаляет правило. Список разрешённых получателей применяется для forwardTo/redirectTo. Действие `permanentDelete` намеренно пропущено (слишком опасно для использования AI — пользуйтесь интерфейсом Outlook). Применяются сессионные лимиты (`OUTLOOK_MAX_MANAGE_RULES_PER_SESSION`).

Читает одно письмо по идентификатору (только чтение). По умолчанию: возвращает полное тело сообщения (HTML по умолчанию преобразуется в текст), тему, from/to/cc, receivedDateTime, conversationId, метаданные вложений и webLink в формате Markdown. С параметром `headersMode: true`: вместо этого возвращает криминалистические заголовки RFC-822 (DKIM, SPF, DMARC, цепочку Received, Message-ID, Authentication-Results). Комбинируйте с `importantOnly: true` для подмножества, относящегося к безопасности, с `groupByType: true` для сгруппированного по категориям представления или с `raw: true` для JSON вместо Markdown. С параметром `includeHeaders: true` (не в режиме заголовков): добавляет основные заголовки вместе с телом. Используйте `outputVerbosity` (minimal/standard/full) для управления детализацией вывода.

Поиск, список, дельта-синхронизация или группировка писем по обсуждениям — шесть режимов, выбираемых параметрами (только чтение). Без параметров: выводит список последних писем в папке `folder` (по умолчанию `inbox`). С фильтрами `query`/`from`/`to`/`subject`/date: полноценный поиск (объединяется через OData filter). С `kqlQuery`: сырой язык ключевых запросов (Keyword Query Language) для расширенного поиска на стороне сервера. С `deltaMode: true`: возвращает текущее состояние плюс `deltaToken`; передайте токен обратно при следующем вызове, чтобы получить только инкрементальные изменения — идеально для мониторинга папки входящих. С `groupByConversation: true`: возвращает обсуждения (threads). С `conversationId`: возвращает все сообщения в одной ветке обсуждения. С `internetMessageId`: ищет письмо по его заголовку RFC Message-ID. Личные аккаунты Outlook.com имеют ограниченную поддержку `$search` — этот инструмент автоматически переключается на OData filters / boolean filters / последний список, но структурированные фильтры (`from`/`subject`/`receivedAfter`/`hasAttachments`/`unreadOnly`) дают более чистые результаты. По умолчанию возвращает постраничные сообщения с полями id/subject/from/receivedDateTime/preview; используйте `outputVerbosity` для расширенного вывода.

Поиск с сортировкой по релевантности в личных контактах, справочнике организации и недавних сообщениях через Microsoft Graph People API (только чтение). Возвращает объекты people с полями `displayName`, `emailAddresses`, `companyName`, `jobTitle` и метаданными релевантности: подходит для запросов вида "кто такой X?" или "кому написать о Y?". Используйте `manage-contact` с action=`search`, когда вам нужны записи только из вашего личного хранилища контактов.

Составляет и отправляет письмо немедленно (деструктивно: отправляет внешние коммуникации). Возвращает подтверждение с идентификатором сохранённого сообщения. Контроль безопасности: `dryRun: true` — возвращает готовое письмо для проверки без отправки; `checkRecipients: true` — сначала запускает `get-mail-tips`, чтобы отметить получателей с автоответом / переполненным ящиком / ограничением доставки / внешних получателей; комбинируйте оба флага для полной проверки перед отправкой. Подчиняется лимитам сессии (`OUTLOOK_MAX_EMAILS_PER_SESSION`) и белому списку получателей (`OUTLOOK_ALLOWED_RECIPIENTS`) — вызовы вне белого списка завершаются ошибкой до любых Graph-запросов. Для многошаговых сценариев составления/проверки используйте `draft` (действие `create` → `update` → `send`), так как черновики можно просмотреть в Outlook перед отправкой. Строки получателей через запятую или массивы — оба варианта допустимы.

Обновляет состояние сообщения без изменения содержимого (идемпотентно — безопасно для повторного вызова). `action=mark-read` / `mark-unread` переключает флаг `isRead` у одного сообщения по `id`. `action=flag` устанавливает флаг для последующего выполнения с опциональными `dueDateTime` / `startDateTime` (ISO 8601). `action=unflag` снимает флаг. `action=complete` отмечает флаг как выполненный. Flag / unflag / complete принимают либо `id` (одиночный), либо `ids` (массив для пакетной обработки) — пакетные операции используют Graph `$batch` для эффективности. Возвращает подтверждение статуса для каждого сообщения.