@iola_adm/iola-cli 0.2.33 → 0.2.35

package/wiki/Skills-/320/270-toolsets.md

@@ -9,15 +9,18 @@ Skills не подмешиваются в каждый запрос целико
 - `local-files` - когда пользователь просит работать с локальными файлами, папками, архивами или документами;
 - `browser-agent` - когда запрос связан с сайтом, URL, страницей, скриншотом или браузером;
 - `local-model` - инструкции для локальных компактных моделей и tool-планирования;
-- `yandex-services` - когда запрос связан с Yandex Connector: Яндекс Диск, Почта, Календарь, Контакты, Телемост или Yandex ID.
+- `yandex-services` - когда запрос связан с Yandex Connector: Яндекс Диск, Почта, Календарь, Контакты, Телемост или Yandex ID;
+- `user-skills` - когда пользователь просит создать, включить, выключить или удалить собственный skill.
 
 Обычный диалог вроде `привет` не получает инструкции про слои, отчеты, файлы и браузер.
 
 ```bash
 iola skills list
 iola skills show open-data
+iola skills create mail-digest --description "Сводка почты" --instructions "Когда пользователь просит сводку почты, найди непрочитанные письма и кратко сгруппируй их по отправителям." --allowed-tools yandex_mail_list,yandex_mail_read --enable
 iola skills enable reports
 iola skills disable local-model
+iola skills delete mail-digest --yes
 iola skills paths
 ```
 
@@ -40,6 +43,24 @@ iola tools profile full
 Режим `safe` подходит для чтения и анализа без записи файлов и без запуска sync.
 Режим `full` предназначен для доверенного локального пользователя.
 
+## Пользовательские skills
+
+Пользователь может создавать собственные skills без редактирования npm-пакета. Такие skills сохраняются локально в `~/.iola/skills/<name>/SKILL.md` и не пропадают при обновлении CLI.
+
+Skill - это инструкция для агента, а не произвольный исполняемый код. Он может описывать любые сценарии, но должен опираться на встроенные tools `iola-cli`: открытые данные, Яндекс Почту/Диск/Календарь/Контакты, локальные файлы, browser runtime, cron, MCP, отчеты и память.
+
+Доступные tools управления:
+
+- `user_skill_list` - список пользовательских skills;
+- `user_skill_create` - создать skill;
+- `user_skill_enable` - включить skill;
+- `user_skill_disable` - выключить skill;
+- `user_skill_delete` - удалить пользовательский skill.
+
+При создании через AI пользователь может написать обычным языком: `создай скилл, который при просьбе "сводка почты" берет непрочитанные письма и группирует по отправителям`. CLI создаст локальный `SKILL.md` и включит его.
+
+Для опасных действий внутри пользовательского skill нужно явное подтверждение пользователя: отправка писем, удаление данных, публикация ссылок, запись файлов и изменение внешних сервисов.
+
 ## Yandex toolset
 
 Toolset `yandex` включает локальные tools для пользовательских сервисов Яндекса:
@@ -47,8 +68,9 @@ Toolset `yandex` включает локальные tools для пользов
 - Yandex ID: профиль, логин, email;
 - Яндекс Диск: список, создание папок, поиск, сохранение текста, загрузка, скачивание, публичные ссылки;
 - Яндекс Почта: статус, список писем, поиск, чтение, отправка;
-- Яндекс Календарь: статус, список событий, создание события;
-- Яндекс Контакты: статус, список, поиск;
-- Телемост: подготовка встречи через календарное событие.
+- Яндекс Календарь: календари, список, поиск, создание, перенос, редактирование, повторы, напоминания, удаление событий;
+- Яндекс Документы / 360: работа через Яндекс Диск - список, поиск, создание текстовых документов, чтение, ссылка/QR, переименование, удаление;
+- Яндекс Контакты: статус, список, поиск, карточка, создание, обновление, удаление, импорт/экспорт, дубликаты, неполные карточки, backup на Диск, дни рождения в календарь, письмо/ссылка/встреча по контакту;
+- Телемост: попытка прямого API и fallback через календарное событие, если API недоступен аккаунту.
 
-Опасные действия ограничены: отправка письма, удаление файлов, публикация ссылок и создание событий требуют явного подтверждения в tool-вызове. Токены хранятся локально в `~/.iola/secrets.json`.
+Опасные действия ограничены: отправка письма, удаление файлов, публикация ссылок, создание/изменение документов и создание/изменение/удаление событий требуют явного подтверждения в tool-вызове. Токены хранятся локально в `~/.iola/secrets.json`.

package/wiki/Yandex-Connector.md

@@ -116,24 +116,86 @@ OAuth-права дают CLI разрешение обращаться к се
 - `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 на Диск;
+- `yandex_disk_share_email` - создать ссылку, QR-код и отправить их по Яндекс Почте;
 - `yandex_disk_unshare` - снять публичную ссылку;
 - `yandex_disk_delete` - удалить файл или папку;
+- `yandex_disk_trash_list` - показать корзину;
+- `yandex_disk_restore` - восстановить из корзины;
+- `yandex_disk_empty_trash` - очистить корзину;
+
+QR-код:
+
+В веб-интерфейсе Яндекс Диска QR-код доступен при работе с публичной ссылкой. В REST API отдельное поле готового QR-кода не документировано. Поэтому `iola-cli` берет публичную ссылку через API, локально создает PNG QR-кода, загружает этот PNG на Яндекс Диск рядом с исходным объектом и при необходимости публикует отдельную ссылку на QR.
 - `yandex_mail_status` - проверить доступ к Почте;
 - `yandex_mail_list` - показать последние письма;
 - `yandex_mail_search` - найти письма;
 - `yandex_mail_read` - прочитать письмо по UID;
 - `yandex_mail_send` - отправить письмо;
 - `yandex_calendar_status` - проверить доступ к Календарю;
-- `yandex_calendar_list` - показать события;
-- `yandex_calendar_create_event` - создать событие;
+- `yandex_calendar_calendars` - показать доступные календари;
+- `yandex_calendar_list` - показать ближайшие события;
+- `yandex_calendar_search` - найти событие;
+- `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` - создать текстовый документ на Яндекс Диске;
+- `yandex_docs_read` - прочитать небольшой текстовый документ;
+- `yandex_docs_share` - создать ссылку и QR-код на документ;
+- `yandex_docs_rename` - переименовать документ;
+- `yandex_docs_delete` - удалить документ;
 - `yandex_contacts_status` - проверить доступ к Контактам;
 - `yandex_contacts_list` - показать контакты;
-- `yandex_contacts_search` - найти контакт;
-- `yandex_telemost_create_event` - создать календарное событие для встречи.
+- `yandex_contacts_search` - найти контакт по имени, email, телефону, организации, адресу или заметке;
+- `yandex_contacts_get` - открыть карточку контакта;
+- `yandex_contacts_create` - создать контакт;
+- `yandex_contacts_update` - обновить поля контакта;
+- `yandex_contacts_delete` - удалить контакт;
+- `yandex_contacts_add_email`, `yandex_contacts_add_phone`, `yandex_contacts_add_address`, `yandex_contacts_add_note`, `yandex_contacts_add_birthday`, `yandex_contacts_add_org` - добавить отдельные поля;
+- `yandex_contacts_remove_email`, `yandex_contacts_remove_phone` - удалить отдельные поля;
+- `yandex_contacts_export_vcard`, `yandex_contacts_export_csv` - экспортировать контакты;
+- `yandex_contacts_import_vcard`, `yandex_contacts_import_csv` - импортировать контакты;
+- `yandex_contacts_find_incomplete` - найти неполные карточки;
+- `yandex_contacts_find_duplicates` - найти дубликаты;
+- `yandex_contacts_backup_to_disk` - сохранить backup контактов на Яндекс Диск;
+- `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` - создать контакт из открытого городского слоя;
+- `yandex_telemost_status` - проверить режим Телемоста;
+- `yandex_telemost_create_event` - создать встречу: прямой Telemost API используется только если он доступен аккаунту; иначе создается календарное событие без выдуманной ссылки.
+
+Регулярная проверка контактов:
+
+```bash
+iola yandex contacts-maintenance on --days 7
+iola yandex contacts-maintenance on --days 7 --backup
+iola yandex contacts-maintenance status
+iola yandex contacts-maintenance tick
+iola yandex contacts-maintenance off
+```
+
+Проверка ищет дубликаты и неполные карточки. Если включен `--backup`, при tick сохраняется CSV-копия контактов на Яндекс Диск.
 
 Включение сервиса в `/yandex` разрешает CLI использовать соответствующую категорию. Отправка письма, удаление файлов, публикация ссылок и создание событий требуют явного намерения пользователя и подтверждения в tool-вызове.
 

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

@@ -162,9 +162,37 @@ iola geo services "Йошкар-Ола, улица Петрова, 15"
 - показать файлы и папки в `/IOLA`;
 - создать папку;
 - найти файл или папку;
+- проверить, есть ли файл или папка;
+- показать карточку файла: размер, тип, даты изменения, публичная ссылка;
+- прочитать небольшой текстовый файл;
 - сохранить текстовый результат;
 - создать или снять публичную ссылку;
-- загрузить или скачать файл.
+- создать QR-код для публичной ссылки и сохранить его на Диск;
+- отправить публичную ссылку и QR-код по Яндекс Почте email-адресу или контакту;
+- загрузить или скачать файл;
+- переместить, скопировать или переименовать файл/папку;
+- удалить файл/папку в корзину;
+- показать корзину, восстановить объект из корзины или очистить корзину.
+
+Примеры:
+
+- `сколько места на Яндекс Диске`;
+- `покажи файлы на Яндекс Диске`;
+- `найди на Диске договор`;
+- `прочитай файл /IOLA/notes/todo.txt`;
+- `создай папку фото на Яндекс Диске`;
+- `сделай публичную ссылку на /IOLA/report.pdf`;
+- `сделай публичную ссылку и QR-код на /IOLA/report.pdf`;
+- `отправь ссылку и QR-код на /IOLA/report.pdf по почте user@example.com`;
+- `отправь Петрову ссылку и QR-код на папку /IOLA/reports`;
+- `создай папку /IOLA/share, перенеси файлы из папки /IOLA/inbox, сделай ссылку и QR-код и отправь по почте user@example.com`;
+- `сними публичную ссылку с /IOLA/report.pdf`;
+- `переименуй /IOLA/a.txt в b.txt`;
+- `перемести /IOLA/a.txt в /IOLA/archive/a.txt`;
+- `скопируй /IOLA/a.txt в /IOLA/copy/a.txt`;
+- `удали /IOLA/tmp.txt`;
+- `покажи корзину Яндекс Диска`;
+- `восстанови /IOLA/tmp.txt из корзины`.
 
 ### yandex-mail
 
@@ -205,7 +233,47 @@ iola geo services "Йошкар-Ола, улица Петрова, 15"
 Работать с Яндекс Календарем:
 
 - показать ближайшие события;
-- создать событие только после явного подтверждения.
+- показать список календарей;
+- найти событие по названию, месту, описанию или дате;
+- создать событие только после явного подтверждения;
+- создать повторяющееся событие;
+- перенести встречу на новую дату или время;
+- изменить название, описание или место события;
+- добавить напоминание;
+- удалить событие по явной просьбе.
+
+Примеры:
+
+- `покажи яндекс календарь`;
+- `найди событие собрание в яндекс календаре`;
+- `создай событие название: прием врача завтра в 10:00`;
+- `перенеси встречу прием врача на послезавтра в 11:00`;
+- `добавь напоминание 20 минут к событию прием врача`;
+- `удали событие прием врача`.
+
+### yandex-docs
+
+Работать с документами Яндекс 360 через Яндекс Диск:
+
+- показать документы в папке `/IOLA/docs`;
+- найти документ по названию;
+- создать текстовый, Markdown или HTML-документ;
+- прочитать небольшой текстовый документ;
+- создать публичную ссылку и QR-код на документ;
+- переименовать документ;
+- удалить документ по явной просьбе.
+
+Важно: CLI работает с документами как с файлами на Яндекс Диске. Он не подменяет веб-редактор Яндекс Документов и не обещает создание "нативного" документа, если Яндекс не дает стабильный API для этого действия.
+
+Примеры:
+
+- `покажи документы на Яндекс Диске`;
+- `найди документ справка на Яндекс Диске`;
+- `создай документ яндекс 360 название: заметка текст: купить лекарства`;
+- `прочитай документ /IOLA/docs/заметка.md`;
+- `сделай ссылку на документ /IOLA/docs/заметка.md`;
+- `переименуй документ /IOLA/docs/заметка.md в лекарства.md`;
+- `удали документ /IOLA/docs/лекарства.md`.
 
 ### yandex-contacts
 
@@ -213,11 +281,66 @@ iola geo services "Йошкар-Ола, улица Петрова, 15"
 
 - проверить доступ к адресной книге;
 - показать контакты;
-- найти контакт по имени, email или телефону.
+- найти контакт по имени, email, телефону, организации, адресу или заметке;
+- открыть карточку контакта;
+- создать контакт с email или телефоном;
+- добавить или обновить email, телефон, адрес, заметку, день рождения, организацию и должность;
+- удалить email или телефон из карточки;
+- удалить контакт по явной просьбе пользователя;
+- найти неполные контакты: без email, телефона или адреса;
+- найти дубликаты контактов;
+- экспортировать контакты в vCard или CSV;
+- импортировать контакты из vCard или CSV;
+- сохранить резервную копию контактов на Яндекс Диск;
+- создать события дней рождения в Яндекс Календаре;
+- включить регулярную проверку контактов: дубликаты, неполные карточки и опциональный backup на Диск.
+
+Примеры:
+
+- `найди контакт Петров`;
+- `создай контакт Иван Петров email ivan@example.com`;
+- `добавь телефон +7 999 123 45 67 к контакту Иван Петров`;
+- `добавь заметку к контакту Иван Петров заметка: родительский комитет`;
+- `покажи контакты без email`;
+- `покажи дубликаты контактов`;
+- `экспортируй контакты в csv`;
+- `сохрани резервную копию контактов на Яндекс Диск`;
+- `импортируй контакты из contacts.csv`;
+- `создай события дней рождения из контактов в календаре`.
+- `включи регулярную проверку контактов каждые 7 дней`;
+- `запусти проверку контактов сейчас`;
+- `включи проверку контактов с backup на Диск`.
+
+### yandex-contacts-combined
+
+Комбинированные сценарии с контактами:
+
+- отправить письмо контакту по имени;
+- если найдено несколько контактов, попросить уточнить;
+- если у контакта нет email, сказать прямо и не отправлять письмо;
+- отправить контакту публичную ссылку и QR-код на файл или папку Яндекс Диска;
+- создать папку контакта на Яндекс Диске и сохранить туда `contact.vcf` и `README.txt`;
+- создать встречу с контактом в Яндекс Календаре;
+- создать календарное событие для Телемоста с контактом;
+- создать контакт из открытого городского слоя, если у школы или детского сада есть публичный email или телефон.
+
+Примеры:
+
+- `отправь Петрову письмо текст: встреча завтра в 14:00`;
+- `отправь Иванову ссылку и QR-код на /IOLA/report.pdf`;
+- `создай папку на Яндекс Диске для контакта Иван Петров`;
+- `создай встречу с Иваном Петровым завтра в 15:00`;
+- `создай контакт из школы № 7`.
 
 ### yandex-telemost
 
-Подготовить встречу через календарное событие. CLI не должен сам нажимать финальные кнопки в интерфейсе Яндекса без явного действия пользователя.
+Подготовить встречу через Телемост:
+
+- проверить режим Телемоста;
+- попробовать создать ссылку через прямой API, если он доступен текущему аккаунту;
+- если прямой API недоступен, создать календарное событие и честно сообщить, что ссылка Телемоста не была получена через API.
+
+CLI не должен сам нажимать финальные кнопки в веб-интерфейсе Яндекса без явного действия пользователя и не должен выдумывать ссылку Телемоста.
 
 ## Yandex Connector backlog