@iola_adm/iola-cli 0.2.33 → 0.2.35

package/README.md

@@ -90,6 +90,7 @@ iola agent
 
 ```bash
 iola skills list
+iola skills create mail-digest --description "Сводка почты" --instructions "Когда пользователь просит сводку почты, найди непрочитанные письма и кратко сгруппируй их по отправителям." --allowed-tools yandex_mail_list,yandex_mail_read --enable
 iola tools toolsets
 iola files mode read-only
 iola files tree .
@@ -201,7 +202,7 @@ Yandex Connector использует две встроенные OAuth-груп
 
 В `/yandex` функции выбираются номерами через запятую, как в мастере настройки. Там же есть пункт `Удалить подключение-коннектор`, который чистит локальные токены и настройки Yandex Connector. Мастер считает коннектор готовым только после токенов обеих групп.
 
-Первый набор Yandex tools уже доступен: профиль Yandex ID, список/поиск/папки/ссылки Яндекс Диска, статус/список/поиск/чтение/отправка Яндекс Почты, события Календаря, Контакты и подготовка встречи через календарь. Отправка письма, удаление файлов, публикация ссылок и создание событий требуют явного подтверждения.
+Yandex tools уже доступны: профиль Yandex ID, расширенная работа с Яндекс Диском (место, список, поиск, карточка, чтение текста, папки, загрузка, скачивание, ссылки, QR-коды к публичным ссылкам, отправка ссылки и QR по почте, перемещение, копирование, переименование, корзина), статус/список/поиск/чтение/отправка Яндекс Почты, полноценная работа с Календарем через CalDAV (календари, список, поиск, создание, перенос, редактирование, напоминания, повторы, удаление), Яндекс Документы/360 через Диск (создание текстовых документов, поиск, чтение, ссылки/QR, переименование, удаление), расширенные Яндекс Контакты (поиск, создание, обновление, удаление, импорт/экспорт, дубликаты, backup на Диск, дни рождения в календарь, регулярная contacts-maintenance проверка) и комбинированные сценарии: письмо контакту, ссылка+QR контакту, папка контакта на Диске, встреча/Телемост с контактом. Телемост пытается использовать прямой API, а если он недоступен текущему аккаунту, честно создает календарное событие без выдуманной ссылки. Отправка письма, удаление/перемещение файлов, публикация ссылок, изменение контактов, документов и событий требуют явного подтверждения.
 
 Инструкция: [Yandex Connector](https://github.com/adm-iola/iola-cli/wiki/Yandex-Connector).
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iola_adm/iola-cli",
-  "version": "0.2.33",
+  "version": "0.2.35",
   "description": "CLI и AI-агент городского округа Йошкар-Ола.",
   "license": "MIT",
   "homepage": "https://github.com/adm-iola/iola-cli#readme",
@@ -42,5 +42,8 @@
   ],
   "engines": {
     "node": ">=22.5.0"
+  },
+  "dependencies": {
+    "qrcode": "^1.5.4"
   }
 }

package/skills/user-skills/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: user-skills
+description: Создание и управление пользовательскими skills на базе встроенных tools iola-cli.
+---
+
+Используй этот skill, когда пользователь просит создать, добавить, изменить, включить, выключить или удалить пользовательский skill/скилл/навык.
+
+Пользовательские skills могут описывать любые сценарии работы CLI, но должны опираться на встроенные безопасные механизмы `iola-cli`: открытые данные, локальные файлы, Яндекс-сервисы, календарь, почту, контакты, Диск, browser runtime, cron, MCP, отчеты и память.
+
+Не создавай произвольный исполняемый JavaScript/PowerShell/Python-код внутри skill. Skill должен быть инструкцией и правилами использования существующих tools.
+
+Доступные tools:
+
+- `user_skill_list` - показать пользовательские skills.
+- `user_skill_create` - создать пользовательский skill в `~/.iola/skills`.
+- `user_skill_enable` - включить skill.
+- `user_skill_disable` - выключить skill.
+- `user_skill_delete` - удалить пользовательский skill.
+
+Схема `user_skill_create`:
+
+```json
+{
+  "name": "short-skill-name",
+  "description": "Короткое описание",
+  "instructions": "Что skill должен делать, когда включается, какие уточнения задавать, какие tools использовать.",
+  "tools": ["yandex_mail_search", "yandex_disk_save_text"],
+  "enable": true,
+  "confirm": true
+}
+```
+
+Правила:
+
+- Создавай skill только по явной просьбе пользователя.
+- Для `user_skill_create` и `user_skill_delete` всегда передавай `confirm=true`.
+- Если пользователь описал идею нечетко, сначала уточни, что является триггером, какие данные использовать и какое действие выполнить.
+- В инструкциях skill явно указывай, какие действия считаются опасными и требуют подтверждения пользователя.
+- Если skill должен писать файлы, отправлять письма, удалять данные, публиковать ссылки или менять внешние сервисы, в инструкциях обязательно требуй явного подтверждения пользователя.
+- Не сохраняй в skill OAuth-токены, API-ключи, пароли и другие секреты.

package/skills/yandex-services/SKILL.md

@@ -14,12 +14,24 @@ description: Сервисы Яндекса через Yandex Connector: ID, Ди
 - `yandex_disk_ls` - показать папку на Яндекс Диске.
 - `yandex_disk_mkdir` - создать папку на Яндекс Диске.
 - `yandex_disk_find` - найти файл или папку на Яндекс Диске.
+- `yandex_disk_stat` - получить карточку файла или папки: тип, размер, даты, публичная ссылка.
+- `yandex_disk_exists` - проверить, есть ли файл или папка.
+- `yandex_disk_read_text` - прочитать небольшой текстовый файл с Диска.
 - `yandex_disk_save_text` - сохранить текстовый результат в файл на Яндекс Диске.
 - `yandex_disk_upload` - загрузить локальный файл на Яндекс Диск.
 - `yandex_disk_download` - скачать файл с Яндекс Диска.
+- `yandex_disk_move` - переместить файл или папку.
+- `yandex_disk_copy` - скопировать файл или папку.
+- `yandex_disk_rename` - переименовать файл или папку.
 - `yandex_disk_share` - сделать публичную ссылку.
+- `yandex_disk_share_qr` - сделать публичную ссылку, создать локальный QR-код из ссылки, сохранить QR PNG на Диск и опубликовать QR.
+- `yandex_disk_share_email` - сделать публичную ссылку, QR-код и отправить ссылку + QR по Яндекс Почте email-адресу или контакту.
+- `yandex_disk_package_share_email` - создать/подготовить папку, перенести или скопировать в нее файлы из другой папки, сделать ссылку + QR и отправить по почте.
 - `yandex_disk_unshare` - снять публичную ссылку.
 - `yandex_disk_delete` - удалить файл или папку.
+- `yandex_disk_trash_list` - показать корзину Диска.
+- `yandex_disk_restore` - восстановить объект из корзины.
+- `yandex_disk_empty_trash` - очистить корзину.
 - `yandex_mail_status` - проверить доступ к Яндекс Почте.
 - `yandex_mail_folders` - показать папки Яндекс Почты.
 - `yandex_mail_list` - показать последние письма.
@@ -38,20 +50,80 @@ description: Сервисы Яндекса через Yandex Connector: ID, Ди
 - `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` - показать события.
-- `yandex_calendar_create_event` - создать событие.
+- `yandex_calendar_calendars` - показать доступные календари.
+- `yandex_calendar_list` - показать ближайшие события.
+- `yandex_calendar_search` - найти событие по названию, описанию, месту, UID или дате.
+- `yandex_calendar_get` - открыть карточку события.
+- `yandex_calendar_create_event` - создать событие с участниками, местом и напоминаниями.
+- `yandex_calendar_create_recurring_event` - создать повторяющееся событие.
+- `yandex_calendar_update` - изменить название, описание, место, время, участников, повторы или напоминания.
+- `yandex_calendar_move` - перенести событие на новую дату/время.
+- `yandex_calendar_add_reminder` - добавить напоминание к событию.
+- `yandex_calendar_delete` - удалить событие.
+- `yandex_docs_status` - проверить работу Яндекс Документов / 360 через Диск.
+- `yandex_docs_list` - показать документы на Яндекс Диске.
+- `yandex_docs_find` - найти документ по названию.
+- `yandex_docs_create_text` - создать текстовый/Markdown/HTML-документ на Яндекс Диске.
+- `yandex_docs_read` - прочитать небольшой текстовый документ.
+- `yandex_docs_share` - создать публичную ссылку и QR-код на документ.
+- `yandex_docs_rename` - переименовать документ.
+- `yandex_docs_delete` - удалить документ.
+- `yandex_docs_save_answer` - сохранить текст ответа как документ.
 - `yandex_contacts_status` - проверить доступ к Яндекс Контактам.
 - `yandex_contacts_list` - показать контакты.
-- `yandex_contacts_search` - найти контакт.
-- `yandex_contacts_create` - создать новый контакт.
+- `yandex_contacts_search` - найти контакт по имени, email, телефону, организации, адресу или заметке.
+- `yandex_contacts_get` - открыть карточку контакта.
+- `yandex_contacts_create` - создать новый контакт с email или телефоном.
+- `yandex_contacts_update` - обновить имя, email, телефон, адрес, заметку, день рождения, организацию или должность.
+- `yandex_contacts_delete` - удалить контакт.
 - `yandex_contacts_add_email` - добавить email в существующий контакт.
-- `yandex_telemost_create_event` - создать календарное событие для встречи.
+- `yandex_contacts_add_phone` - добавить телефон.
+- `yandex_contacts_add_address` - добавить адрес.
+- `yandex_contacts_add_note` - добавить заметку.
+- `yandex_contacts_add_birthday` - добавить день рождения.
+- `yandex_contacts_add_org` - добавить организацию и должность.
+- `yandex_contacts_remove_email` - удалить email из карточки.
+- `yandex_contacts_remove_phone` - удалить телефон из карточки.
+- `yandex_contacts_export_vcard` - экспортировать контакты в vCard.
+- `yandex_contacts_export_csv` - экспортировать контакты в CSV.
+- `yandex_contacts_import_vcard` - импортировать контакты из vCard.
+- `yandex_contacts_import_csv` - импортировать контакты из CSV.
+- `yandex_contacts_find_incomplete` - найти неполные контакты.
+- `yandex_contacts_find_duplicates` - найти дубликаты.
+- `yandex_contacts_backup_to_disk` - сохранить резервную копию контактов на Яндекс Диск.
+- `yandex_contacts_birthdays_to_calendar` - создать события дней рождения в календаре.
+- `yandex_contact_send_mail` - отправить письмо контакту по имени.
+- `yandex_contact_send_disk_link_qr` - отправить контакту ссылку и QR-код на объект Яндекс Диска.
+- `yandex_contact_create_disk_folder` - создать папку контакта на Диске и сохранить туда vCard/README.
+- `yandex_contact_create_calendar_event` - создать встречу с контактом.
+- `yandex_contact_create_telemost_event` - создать календарное событие для Телемоста с контактом.
+- `yandex_contact_from_public_entity` - создать контакт из открытого городского слоя, если у организации есть email или телефон.
+- `yandex_telemost_status` - проверить режим Телемоста.
+- `yandex_telemost_create_event` - создать встречу: если прямой Telemost API доступен аккаунту, добавить ссылку; иначе создать календарное событие с честным fallback.
+- Регулярная проверка контактов включается командой `iola yandex contacts-maintenance on --days 7`, выключается `iola yandex contacts-maintenance off`, ручная проверка `iola yandex contacts-maintenance tick`. Флаг `--backup` включает backup контактов на Диск при tick.
+
+Комбинированные сценарии:
+
+- Если пользователь просит "сделай ссылку и QR", используй `yandex_disk_share_qr`.
+- Если пользователь просит "отправь ссылку/QR по почте" или "отправь ссылку контакту", используй `yandex_disk_share_email`.
+- Если пользователь просит "перенеси/скопируй файлы из папки, создай ссылку/QR и отправь", используй `yandex_disk_package_share_email`.
+- Если получатель указан именем, сначала ищи его в контактах. Если контактов несколько или email не найден, попроси уточнение.
+- Если пользователь просит отправить письмо контакту, создать встречу с контактом или отправить ссылку контакту, используй специализированные `yandex_contact_*` tools, а не ручную цепочку из нескольких tools.
+- Если пользователь просит создать папку для контакта на Яндекс Диске, используй `yandex_contact_create_disk_folder`.
+- Если пользователь просит создать/найти/прочитать/переименовать/удалить документ именно на Яндекс Диске или в Яндекс 360, используй `yandex_docs_*`, а не общий список файлов.
+- Если пользователь просит перенести событие, добавить напоминание или удалить встречу, используй `yandex_calendar_move`, `yandex_calendar_add_reminder`, `yandex_calendar_delete`.
+- Если пользователь просит Телемост, используй `yandex_telemost_create_event`. Не обещай ссылку Телемоста, если API ее не вернул.
+- Если пользователь просит резервную копию контактов, используй `yandex_contacts_backup_to_disk`.
+- Если пользователь просит регулярную проверку контактов, дубликатов или неполных карточек, используй `iola yandex contacts-maintenance ...`.
+- Если пользователь просит импорт/экспорт контактов, используй CSV или vCard по расширению файла или явному формату.
+- QR-код создается локально из публичной ссылки Яндекс Диска, сохраняется PNG-файлом на Яндекс Диск рядом с исходным объектом и публикуется отдельной ссылкой.
+- REST API Яндекс Диска не отдает отдельное поле готового QR-кода, поэтому CLI не вытаскивает QR из API, а создает QR локально без сторонних QR-сервисов.
 
 Безопасность:
 
-- Для отправки письма, ответа на письмо, удаления письма, удаления файлов, публикации ссылки и создания событий нужен явный запрос пользователя и `confirm=true`.
+- Для отправки письма, ответа на письмо, удаления письма, удаления файлов, перемещения/копирования/переименования объектов, восстановления/очистки корзины, публикации ссылки, создания QR-ссылки, отправки ссылки по почте, создания/изменения/удаления событий и создания/изменения/удаления документов нужен явный запрос пользователя и `confirm=true`.
 - Для пересылки письма, создания контакта, создания события из письма и добавления отправителя в контакты также нужен явный запрос пользователя и `confirm=true`.
-- Не отправляй письма, не отвечай на письма, не пересылай письма, не создавай контакты/события, не удаляй письма/файлы и не публикуй ссылки по косвенному намерению.
+- Не отправляй письма, не отвечай на письма, не пересылай письма, не создавай контакты/события, не удаляй письма/файлы, не перемещай/копируй/переименовывай объекты и не публикуй ссылки по косвенному намерению.
 - Список писем и поиск не должны помечать письма прочитанными. Чтение письма по просьбе пользователя помечает письмо прочитанным.
 - Если пользователь просит отправить письмо по имени контакта, сначала ищи контакт. Если контактов несколько, покажи варианты и попроси уточнить. Если контакта нет или у него нет email, скажи прямо.
 - Если пользователь отправил письмо на введенный email и указал имя контакта, можно предложить добавить email в найденный контакт без email.