06ketan/slideshot

Создаёт слайды. ВАЖНО: Используйте mode=default, если пользователь явно не выбрал token_saver. mode=default = ИИ пишет полный HTML (наилучшее качество). mode=token_saver = ИИ отправляет JSON, сервер использует базовые шаблоны. ТРЕБУЕТ discover_themes сначала И пользователь должен подтвердить структуру данных. После сохранения HTML этим инструментом вы ОБЯЗАНЫ показать htmlPath как артефакт предпросмотра кода. Затем ОСТАНОВИТЕСЬ и попросите пользователя подтвердить. НЕ вызывайте render_slides, пока пользователь явно не подтвердит.

ОБЯЗАТЕЛЬНЫЙ первый шаг – все остальные инструменты ОТКЛОНЯЮТ запросы, пока этот не вызван. Возвращает темы, предустановки ориентации, режимы использования токенов и форматы вывода. Используйте ТОЛЬКО встроенные подсказки выбора из массива "ask" – НЕ выводите темы в виде отдельного списка Markdown. НЕ спрашивайте, сколько слайдов (вы решаете на основе темы). После того как пользователь выберет параметры, покажите структуру данных предложенных слайдов и ДОЖДИТЕСЬ подтверждения перед вызовом create_slides.

Выполняет энергоэффективные частичные правки на ранее сгенерированной HTML-презентации. Используйте ЭТО ВМЕСТО полной перегенерации для небольших изменений — это экономит 60-90% токенов по сравнению с полной перезаписью. Операции: replace_slide (заменяет блок одного слайда по 1-индексированному slideIndex), patch_css (добавляет CSS-правила в <style>), swap_token (заменяет значение CSS-переменной, например {"--coral": "#FF0000"}), patch_class (добавляет/удаляет класс на конкретном слайде, например {"add": "dark"}). Читает из кэша или из htmlPath; сохраняет обновлённый HTML и возвращает новый htmlPath. После редактирования покажите htmlPath как превью-артефакт и ОСТАНОВИТЕСЬ — не вызывайте render_slides, пока пользователь не подтвердит.

Проверяет, что Puppeteer/Chromium может запускаться. Используйте, когда рендеринг не удаётся.

Идемпотентный, только для чтения, список всех доступных тем (8+). В отличие от discover_themes, этот инструмент НЕ запускает рабочий процесс создания слайдов — вызывайте его в любое время, когда пользователь в середине разговора спрашивает «какие темы есть?». Возвращает тот же каталог тем с уровнями (primary/secondary). Модели ДОЛЖНЫ показывать каждую полученную тему, никогда не сокращайте их.

Выполняет финальный рендеринг в PDF, WebP, PNG, PPTX. Принимает строку HTML или путь к HTML-файлу (htmlPath). Поддерживает параметры: width, height, selector, scale, webpQuality, orientation, pptxMode, pptxFilename, slideRange. НИКОГДА не вызывайте render_slides в одном вызове с create_slides. Когда пользователь передаёт путь к существующему HTML-файлу, передайте его как htmlPath и вызывайте этот инструмент напрямую — discover_themes или create_slides не нужны. Для полного рабочего процесса создания слайдов сначала ТРЕБУЮТСЯ и discover_themes, и create_slides, и вызывайте ТОЛЬКО ПОСЛЕ того, как пользователь подтвердит предварительный просмотр. Возвращает пути к файлам на диске.