cc-viewer 1.2.1 → 1.2.2

package/concepts/ru/Tool-EnterPlanMode.md

@@ -0,0 +1,43 @@
+# EnterPlanMode
+
+## Определение
+
+Переключает Claude Code в режим планирования для исследования кодовой базы и проектирования плана перед реализацией.
+
+## Параметры
+
+Без параметров.
+
+## Сценарии использования
+
+**Подходящее применение:**
+- Реализация новых функций — требуются архитектурные решения
+- Существует несколько возможных решений — требуется выбор пользователя
+- Изменения кода влияют на существующее поведение или структуру
+- Изменения в нескольких файлах — потенциально 2-3 и более файлов
+- Неясные требования — необходимо сначала исследовать, чтобы понять объём
+- Предпочтения пользователя важны — реализация может иметь несколько разумных направлений
+
+**Неподходящее применение:**
+- Исправления одной или нескольких строк (опечатки, очевидные ошибки)
+- Пользователь дал очень конкретные инструкции
+- Чисто исследовательские задачи — следует использовать Task (тип Explore)
+
+## Поведение в режиме планирования
+
+После входа в режим планирования Claude Code:
+1. Использует инструменты Glob, Grep, Read для глубокого исследования кодовой базы
+2. Понимает существующие паттерны и архитектуру
+3. Проектирует план реализации
+4. Отправляет план на утверждение пользователю
+5. При необходимости уточнения может использовать AskUserQuestion
+6. Когда план готов, выходит через ExitPlanMode
+
+## Примечания
+
+- Этот инструмент требует согласия пользователя для входа в режим планирования
+- Если не уверены, нужно ли планирование, лучше планировать — заблаговременное согласование лучше, чем переделка
+
+## Значение в cc-viewer
+
+Вызов EnterPlanMode в логах запросов отображается как блок content `tool_use`. После входа в режим планирования последовательность запросов обычно состоит преимущественно из исследовательских вызовов инструментов (Glob, Grep, Read), до вызова ExitPlanMode.

package/concepts/ru/Tool-ExitPlanMode.md

@@ -0,0 +1,39 @@
+# ExitPlanMode
+
+## Определение
+
+Выходит из режима планирования и отправляет план на утверждение пользователю. Содержимое плана считывается из ранее записанного файла плана.
+
+## Параметры
+
+| Параметр | Тип | Обязательный | Описание |
+|------|------|------|------|
+| `allowedPrompts` | array | Нет | Список описаний разрешений, необходимых для реализации плана |
+
+Каждый элемент массива `allowedPrompts`:
+
+| Поле | Тип | Обязательный | Описание |
+|------|------|------|------|
+| `tool` | enum | Да | Применимый инструмент, в настоящее время поддерживается только `Bash` |
+| `prompt` | string | Да | Семантическое описание операции (например, "run tests", "install dependencies") |
+
+## Сценарии использования
+
+**Подходящее применение:**
+- План в режиме планирования завершён, готов к отправке на утверждение пользователю
+- Только для задач реализации, требующих написания кода
+
+**Неподходящее применение:**
+- Чисто исследовательские задачи — не требуют выхода из режима планирования
+- Хотите спросить пользователя «план подходит?» — это именно функция данного инструмента, не используйте AskUserQuestion для этого
+
+## Примечания
+
+- Этот инструмент не принимает содержимое плана в качестве параметра — он считывает его из ранее записанного файла плана
+- Пользователь увидит содержимое файла плана для утверждения
+- Не спрашивайте через AskUserQuestion «подходит ли план» перед вызовом этого инструмента — это дублирование
+- Не упоминайте «план» в вопросах, так как пользователь не видит содержимое плана до ExitPlanMode
+
+## Значение в cc-viewer
+
+Вызов ExitPlanMode обозначает конец фазы планирования. В логах запросов запросы после этого вызова обычно переходят к операциям реализации (Edit, Write, Bash и т.д.).

package/concepts/ru/Tool-Glob.md

@@ -0,0 +1,34 @@
+# Glob
+
+## Определение
+
+Быстрый инструмент сопоставления шаблонов имён файлов, поддерживающий кодовые базы любого размера. Возвращает совпавшие пути файлов, отсортированные по времени модификации.
+
+## Параметры
+
+| Параметр | Тип | Обязательный | Описание |
+|------|------|------|------|
+| `pattern` | string | Да | Шаблон glob (например, `**/*.js`, `src/**/*.ts`) |
+| `path` | string | Нет | Каталог поиска, по умолчанию текущий рабочий каталог. Не передавайте "undefined" или "null" |
+
+## Сценарии использования
+
+**Подходящее применение:**
+- Поиск файлов по шаблону имени
+- Поиск всех файлов определённого типа (например, всех файлов `.tsx`)
+- Локализация файлов при поиске определения класса (например, `class Foo`)
+- Можно параллельно отправлять несколько вызовов Glob в одном сообщении
+
+**Неподходящее применение:**
+- Поиск содержимого файлов — следует использовать Grep
+- Открытое исследование, требующее нескольких раундов поиска — следует использовать Task (тип Explore)
+
+## Примечания
+
+- Поддерживает стандартный синтаксис glob: `*` соответствует одному уровню, `**` — нескольким уровням, `{}` — множественному выбору
+- Результаты отсортированы по времени модификации
+- Более рекомендуется, чем команда `find` в Bash
+
+## Значение в cc-viewer
+
+Вызовы Glob в логах запросов отображаются как пары блоков content `tool_use` / `tool_result`. `tool_result` содержит список совпавших путей файлов.

package/concepts/ru/Tool-Grep.md

@@ -0,0 +1,47 @@
+# Grep
+
+## Определение
+
+Мощный инструмент поиска по содержимому на основе ripgrep. Поддерживает регулярные выражения, фильтрацию по типам файлов и несколько режимов вывода.
+
+## Параметры
+
+| Параметр | Тип | Обязательный | Описание |
+|------|------|------|------|
+| `pattern` | string | Да | Шаблон поиска регулярного выражения |
+| `path` | string | Нет | Путь поиска (файл или каталог), по умолчанию текущий рабочий каталог |
+| `glob` | string | Нет | Фильтр имён файлов (например, `*.js`, `*.{ts,tsx}`) |
+| `type` | string | Нет | Фильтр типа файла (например, `js`, `py`, `rust`), эффективнее чем glob |
+| `output_mode` | enum | Нет | Режим вывода: `files_with_matches` (по умолчанию), `content`, `count` |
+| `-i` | boolean | Нет | Поиск без учёта регистра |
+| `-n` | boolean | Нет | Отображение номеров строк (только режим content), по умолчанию true |
+| `-A` | number | Нет | Количество строк, отображаемых после совпадения |
+| `-B` | number | Нет | Количество строк, отображаемых перед совпадением |
+| `-C` / `context` | number | Нет | Количество строк, отображаемых до и после совпадения |
+| `head_limit` | number | Нет | Лимит количества результатов, по умолчанию 0 (без лимита) |
+| `offset` | number | Нет | Пропуск первых N результатов |
+| `multiline` | boolean | Нет | Включение многострочного режима сопоставления, по умолчанию false |
+
+## Сценарии использования
+
+**Подходящее применение:**
+- Поиск определённых строк или шаблонов в кодовой базе
+- Нахождение мест использования функций/переменных
+- Фильтрация результатов поиска по типу файла
+- Подсчёт совпадений
+
+**Неподходящее применение:**
+- Поиск файлов по имени — следует использовать Glob
+- Открытое исследование, требующее нескольких раундов поиска — следует использовать Task (тип Explore)
+
+## Примечания
+
+- Использует синтаксис ripgrep (не grep), специальные символы вроде фигурных скобок требуют экранирования
+- Режим `files_with_matches` возвращает только пути файлов, наиболее эффективный
+- Режим `content` возвращает содержимое совпавших строк, поддерживает контекстные строки
+- Многострочное сопоставление требует установки `multiline: true`
+- Всегда предпочитайте инструмент Grep вместо команд `grep` или `rg` в Bash
+
+## Значение в cc-viewer
+
+Вызовы Grep в логах запросов отображаются как пары блоков content `tool_use` / `tool_result`. `tool_result` содержит результаты поиска.

package/concepts/ru/Tool-NotebookEdit.md

@@ -0,0 +1,33 @@
+# NotebookEdit
+
+## Определение
+
+Заменяет, вставляет или удаляет определённую ячейку в Jupyter notebook (файл .ipynb).
+
+## Параметры
+
+| Параметр | Тип | Обязательный | Описание |
+|------|------|------|------|
+| `notebook_path` | string | Да | Абсолютный путь к файлу notebook |
+| `new_source` | string | Да | Новое содержимое ячейки |
+| `cell_id` | string | Нет | ID ячейки для редактирования. В режиме вставки новая ячейка вставляется после этого ID |
+| `cell_type` | enum | Нет | Тип ячейки: `code` или `markdown`. Обязателен в режиме вставки |
+| `edit_mode` | enum | Нет | Режим редактирования: `replace` (по умолчанию), `insert`, `delete` |
+
+## Сценарии использования
+
+**Подходящее применение:**
+- Модификация ячеек кода или markdown в Jupyter notebook
+- Добавление новых ячеек в notebook
+- Удаление ячеек из notebook
+
+## Примечания
+
+- `cell_number` индексируется с 0
+- Режим `insert` вставляет новую ячейку в указанную позицию
+- Режим `delete` удаляет ячейку в указанной позиции
+- Путь должен быть абсолютным
+
+## Значение в cc-viewer
+
+Вызов NotebookEdit в логах запросов отображается как блок content `tool_use`, фиксирующий конкретные операции модификации notebook.

package/concepts/ru/Tool-Read.md

@@ -0,0 +1,41 @@
+# Read
+
+## Определение
+
+Читает содержимое файла из локальной файловой системы. Поддерживает текстовые файлы, изображения, PDF и Jupyter notebook.
+
+## Параметры
+
+| Параметр | Тип | Обязательный | Описание |
+|------|------|------|------|
+| `file_path` | string | Да | Абсолютный путь к файлу |
+| `offset` | number | Нет | Номер начальной строки (для сегментного чтения больших файлов) |
+| `limit` | number | Нет | Количество строк для чтения (для сегментного чтения больших файлов) |
+| `pages` | string | Нет | Диапазон страниц PDF (например, "1-5", "3", "10-20"), применимо только к PDF |
+
+## Сценарии использования
+
+**Подходящее применение:**
+- Чтение файлов кода, конфигурационных файлов и других текстовых файлов
+- Просмотр файлов изображений (Claude — мультимодальная модель)
+- Чтение PDF-документов
+- Чтение Jupyter notebook (возвращает все ячейки с выводом)
+- Параллельное чтение нескольких файлов для получения контекста
+
+**Неподходящее применение:**
+- Чтение каталогов — следует использовать команду `ls` в Bash
+- Открытое исследование кодовой базы — следует использовать Task (тип Explore)
+
+## Примечания
+
+- Путь должен быть абсолютным, не относительным
+- По умолчанию читает первые 2000 строк файла
+- Строки длиннее 2000 символов будут обрезаны
+- Вывод использует формат `cat -n`, нумерация строк начинается с 1
+- Большие PDF (более 10 страниц) должны иметь указанный параметр `pages`, максимум 20 страниц за раз
+- Чтение несуществующего файла вернёт ошибку (не вызовет сбой)
+- Можно параллельно вызывать несколько Read в одном сообщении
+
+## Значение в cc-viewer
+
+Вызовы Read в логах запросов отображаются как пары блоков content `tool_use` (вызов) и `tool_result` (возвращённое содержимое). `tool_result` содержит фактическое содержимое файла, что позволяет анализировать, какие файлы модель прочитала.

package/concepts/ru/Tool-Skill.md

@@ -0,0 +1,35 @@
+# Skill
+
+## Определение
+
+Выполняет навык (skill) в основном диалоге. Навыки — это специализированные возможности, которые пользователь может вызывать через slash command (например, `/commit`, `/review-pr`).
+
+## Параметры
+
+| Параметр | Тип | Обязательный | Описание |
+|------|------|------|------|
+| `skill` | string | Да | Название навыка (например, "commit", "review-pr", "pdf") |
+| `args` | string | Нет | Аргументы навыка |
+
+## Сценарии использования
+
+**Подходящее применение:**
+- Пользователь ввёл slash command в формате `/<skill-name>`
+- Запрос пользователя соответствует функциональности зарегистрированного навыка
+
+**Неподходящее применение:**
+- Встроенные команды CLI (например, `/help`, `/clear`)
+- Навык уже выполняется
+- Название навыка отсутствует в списке доступных навыков
+
+## Примечания
+
+- После вызова навык разворачивается в полный prompt
+- Поддерживает полностью квалифицированные имена (например, `ms-office-suite:pdf`)
+- Список доступных навыков предоставляется в сообщениях system-reminder
+- Когда виден тег `<command-name>`, это означает, что навык загружен — следует выполнить его напрямую, а не вызывать этот инструмент повторно
+- Не упоминайте навык без фактического вызова инструмента
+
+## Значение в cc-viewer
+
+Вызов Skill в логах запросов отображается как блок content `tool_use`. Prompt, развёрнутый из навыка, влияет на system prompt или содержимое сообщений последующих запросов.

package/concepts/ru/Tool-Task.md

@@ -0,0 +1,53 @@
+# Task
+
+## Определение
+
+Запускает суб-агента (SubAgent) для автономной обработки сложных многоэтапных задач. Суб-агент — это независимый подпроцесс с собственным набором инструментов и контекстом.
+
+## Параметры
+
+| Параметр | Тип | Обязательный | Описание |
+|------|------|------|------|
+| `prompt` | string | Да | Описание задачи для выполнения суб-агентом |
+| `description` | string | Да | Краткое резюме в 3-5 словах |
+| `subagent_type` | string | Да | Тип суб-агента, определяет доступный набор инструментов |
+| `model` | enum | Нет | Указание модели (sonnet / opus / haiku), по умолчанию наследуется от родителя |
+| `max_turns` | integer | Нет | Максимальное количество агентных ходов |
+| `run_in_background` | boolean | Нет | Запускать ли в фоне, фоновая задача возвращает путь output_file |
+| `resume` | string | Нет | ID агента для возобновления, продолжение с последнего выполнения |
+| `isolation` | enum | Нет | Режим изоляции, `worktree` создаёт временный git worktree |
+
+## Типы суб-агентов
+
+| Тип | Назначение | Доступные инструменты |
+|------|------|----------|
+| `Bash` | Выполнение команд, операции git | Bash |
+| `general-purpose` | Общие многоэтапные задачи | Все инструменты |
+| `Explore` | Быстрое исследование кодовой базы | Все инструменты кроме Task/Edit/Write/NotebookEdit/ExitPlanMode |
+| `Plan` | Проектирование плана реализации | Все инструменты кроме Task/Edit/Write/NotebookEdit/ExitPlanMode |
+| `claude-code-guide` | Вопросы и ответы по руководству Claude Code | Glob, Grep, Read, WebFetch, WebSearch |
+| `statusline-setup` | Настройка строки состояния | Read, Edit |
+
+## Сценарии использования
+
+**Подходящее применение:**
+- Сложные задачи, требующие многоэтапного автономного выполнения
+- Исследование кодовой базы и глубокий анализ (тип Explore)
+- Параллельная работа, требующая изолированной среды
+- Длительные задачи, требующие фонового выполнения
+
+**Неподходящее применение:**
+- Чтение определённого пути файла — используйте Read или Glob напрямую
+- Поиск в 2-3 известных файлах — используйте Read напрямую
+- Поиск определения класса — используйте Glob напрямую
+
+## Примечания
+
+- После завершения суб-агент возвращает одно сообщение, его результаты не видны пользователю — основной агент должен их передать
+- Можно параллельно запускать несколько вызовов Task в одном сообщении для повышения эффективности
+- Прогресс фоновых задач проверяется через инструмент TaskOutput
+- Тип Explore медленнее прямого вызова Glob/Grep, используйте только когда простого поиска недостаточно
+
+## Значение в cc-viewer
+
+Вызов Task порождает цепочку запросов SubAgent, видимую в списке запросов как независимая последовательность подзапросов, отделённая от MainAgent. Запросы SubAgent обычно имеют упрощённый system prompt и меньше определений инструментов, что явно отличает их от MainAgent.

package/concepts/ru/Tool-TaskCreate.md

@@ -0,0 +1,38 @@
+# TaskCreate
+
+## Определение
+
+Создаёт структурированную запись в списке задач для отслеживания прогресса, организации сложных задач и демонстрации пользователю хода работы.
+
+## Параметры
+
+| Параметр | Тип | Обязательный | Описание |
+|------|------|------|------|
+| `subject` | string | Да | Краткий заголовок задачи в повелительном наклонении (например, "Fix authentication bug") |
+| `description` | string | Да | Подробное описание, включающее контекст и критерии приёмки |
+| `activeForm` | string | Нет | Текст в настоящем продолженном времени, отображаемый во время выполнения (например, "Fixing authentication bug") |
+| `metadata` | object | Нет | Произвольные метаданные, прикреплённые к задаче |
+
+## Сценарии использования
+
+**Подходящее применение:**
+- Сложные многоэтапные задачи (более 3 шагов)
+- Пользователь предоставил несколько элементов для выполнения
+- Отслеживание работы в режиме планирования
+- Пользователь явно попросил использовать список todo
+
+**Неподходящее применение:**
+- Одиночная простая задача
+- Простые операции менее чем в 3 шага
+- Чистый диалог или информационный запрос
+
+## Примечания
+
+- Все вновь созданные задачи имеют начальный статус `pending`
+- `subject` использует повелительное наклонение ("Run tests"), `activeForm` — настоящее продолженное время ("Running tests")
+- После создания задачи можно установить зависимости (blocks/blockedBy) через TaskUpdate
+- Перед созданием следует вызвать TaskList для проверки на дубликаты
+
+## Значение в cc-viewer
+
+TaskCreate — это внутренняя операция управления задачами Claude Code, не порождающая независимого API-запроса. Однако в Chat Mode можно увидеть блок tool_use, в котором модель вызывает этот инструмент.

package/concepts/ru/Tool-TaskGet.md

@@ -0,0 +1,35 @@
+# TaskGet
+
+## Определение
+
+Получает полные детали задачи по её ID.
+
+## Параметры
+
+| Параметр | Тип | Обязательный | Описание |
+|------|------|------|------|
+| `taskId` | string | Да | ID задачи для получения |
+
+## Возвращаемое содержимое
+
+- `subject` — заголовок задачи
+- `description` — подробные требования и контекст
+- `status` — статус: `pending`, `in_progress` или `completed`
+- `blocks` — список задач, заблокированных этой задачей
+- `blockedBy` — список предшествующих задач, блокирующих эту задачу
+
+## Сценарии использования
+
+**Подходящее применение:**
+- Получение полного описания и контекста задачи перед началом работы
+- Понимание зависимостей задачи
+- Получение полных требований после назначения задачи
+
+## Примечания
+
+- После получения задачи следует проверить, пуст ли список `blockedBy`, прежде чем начинать работу
+- Используйте TaskList для просмотра сводки всех задач
+
+## Значение в cc-viewer
+
+TaskGet — это внутренняя операция управления задачами, не порождающая независимого API-запроса.

package/concepts/ru/Tool-TaskList.md

@@ -0,0 +1,36 @@
+# TaskList
+
+## Определение
+
+Отображает список всех задач в списке задач, позволяя просмотреть общий прогресс и доступную работу.
+
+## Параметры
+
+Без параметров.
+
+## Возвращаемое содержимое
+
+Сводка по каждой задаче:
+- `id` — идентификатор задачи
+- `subject` — краткое описание
+- `status` — статус: `pending`, `in_progress` или `completed`
+- `owner` — ответственный (ID агента), пустое означает не назначено
+- `blockedBy` — список ID незавершённых задач, блокирующих эту задачу
+
+## Сценарии использования
+
+**Подходящее применение:**
+- Просмотр доступных задач (статус pending, без owner, не заблокированы)
+- Проверка общего прогресса проекта
+- Поиск заблокированных задач
+- Поиск следующей задачи после завершения текущей
+
+## Примечания
+
+- Предпочитайте обработку задач в порядке ID (наименьший ID первым), так как ранние задачи обычно предоставляют контекст для последующих
+- Задачи с `blockedBy` не могут быть взяты до снятия зависимости
+- Используйте TaskGet для получения полных деталей конкретной задачи
+
+## Значение в cc-viewer
+
+TaskList — это внутренняя операция управления задачами, не порождающая независимого API-запроса.

package/concepts/ru/Tool-TaskOutput.md

@@ -0,0 +1,34 @@
+# TaskOutput
+
+## Определение
+
+Получает вывод работающей или завершённой фоновой задачи. Применимо к фоновым оболочкам, асинхронным агентам и удалённым сессиям.
+
+## Параметры
+
+| Параметр | Тип | Обязательный | Описание |
+|------|------|------|------|
+| `task_id` | string | Да | ID задачи |
+| `block` | boolean | Да | Блокировать ли до завершения задачи, по умолчанию `true` |
+| `timeout` | number | Да | Максимальное время ожидания (миллисекунды), по умолчанию 30000, макс. 600000 |
+
+## Сценарии использования
+
+**Подходящее применение:**
+- Проверка прогресса фонового агента, запущенного через Task (`run_in_background: true`)
+- Получение результатов команд Bash, запущенных в фоне
+- Ожидание завершения асинхронной задачи и получение вывода
+
+**Неподходящее применение:**
+- Задачи переднего плана — задачи переднего плана возвращают результат напрямую, этот инструмент не нужен
+
+## Примечания
+
+- `block: true` блокирует до завершения задачи или истечения тайм-аута
+- `block: false` используется для неблокирующей проверки текущего состояния
+- ID задачи можно найти через команду `/tasks`
+- Применимо ко всем типам задач: фоновые оболочки, асинхронные агенты, удалённые сессии
+
+## Значение в cc-viewer
+
+Вызов TaskOutput сам по себе не порождает API-запрос — это внутренняя операция управления задачами Claude Code, не отображающаяся в логах запросов.

package/concepts/ru/Tool-TaskStop.md

@@ -0,0 +1,27 @@
+# TaskStop
+
+## Определение
+
+Останавливает работающую фоновую задачу.
+
+## Параметры
+
+| Параметр | Тип | Обязательный | Описание |
+|------|------|------|------|
+| `task_id` | string | Нет | ID фоновой задачи для остановки |
+| `shell_id` | string | Нет | Устарел, используйте `task_id` вместо этого |
+
+## Сценарии использования
+
+**Подходящее применение:**
+- Завершение долго работающей задачи, которая больше не нужна
+- Отмена ошибочно запущенной фоновой задачи
+
+## Примечания
+
+- Возвращает статус успеха или неудачи
+- Параметр `shell_id` устарел, следует использовать `task_id`
+
+## Значение в cc-viewer
+
+Вызов TaskStop сам по себе не порождает API-запрос — это внутренняя операция управления задачами Claude Code.

package/concepts/ru/Tool-TaskUpdate.md

@@ -0,0 +1,49 @@
+# TaskUpdate
+
+## Определение
+
+Обновляет статус, содержимое или зависимости задачи в списке задач.
+
+## Параметры
+
+| Параметр | Тип | Обязательный | Описание |
+|------|------|------|------|
+| `taskId` | string | Да | ID задачи для обновления |
+| `status` | enum | Нет | Новый статус: `pending` / `in_progress` / `completed` / `deleted` |
+| `subject` | string | Нет | Новый заголовок |
+| `description` | string | Нет | Новое описание |
+| `activeForm` | string | Нет | Текст в настоящем продолженном времени, отображаемый во время выполнения |
+| `owner` | string | Нет | Новый ответственный за задачу (имя агента) |
+| `metadata` | object | Нет | Метаданные для слияния (установка в null удаляет ключ) |
+| `addBlocks` | string[] | Нет | Список ID задач, заблокированных этой задачей |
+| `addBlockedBy` | string[] | Нет | Список ID предшествующих задач, блокирующих эту задачу |
+
+## Переход статусов
+
+```
+pending → in_progress → completed
+```
+
+`deleted` может быть установлен из любого статуса, безвозвратно удаляет задачу.
+
+## Сценарии использования
+
+**Подходящее применение:**
+- Пометка задачи как `in_progress` при начале работы
+- Пометка задачи как `completed` после завершения работы
+- Установка зависимостей между задачами
+- Обновление содержимого задачи при изменении требований
+
+**Важные правила:**
+- Помечайте как `completed` только при полном завершении задачи
+- При ошибках или блокировках сохраняйте статус `in_progress`
+- Не помечайте как `completed`, когда тесты не проходят, реализация неполная или возникли неразрешённые ошибки
+
+## Примечания
+
+- Перед обновлением следует получить актуальное состояние задачи через TaskGet, чтобы избежать устаревших данных
+- После завершения задачи вызовите TaskList для поиска следующей доступной задачи
+
+## Значение в cc-viewer
+
+TaskUpdate — это внутренняя операция управления задачами, не порождающая независимого API-запроса.

package/concepts/ru/Tool-WebFetch.md

@@ -0,0 +1,36 @@
+# WebFetch
+
+## Определение
+
+Получает содержимое веб-страницы по указанному URL, конвертирует HTML в markdown и обрабатывает содержимое с помощью AI-модели согласно prompt.
+
+## Параметры
+
+| Параметр | Тип | Обязательный | Описание |
+|------|------|------|------|
+| `url` | string (URI) | Да | Полный URL для получения |
+| `prompt` | string | Да | Описание информации для извлечения со страницы |
+
+## Сценарии использования
+
+**Подходящее применение:**
+- Получение содержимого публичных веб-страниц
+- Просмотр онлайн-документации
+- Извлечение определённой информации с веб-страниц
+
+**Неподходящее применение:**
+- URL, требующие аутентификации (Google Docs, Confluence, Jira, GitHub и т.д.) — сначала поищите специализированный инструмент MCP
+- URL GitHub — предпочитайте использование `gh` CLI
+
+## Примечания
+
+- URL должен быть полным, валидным URL
+- HTTP автоматически обновляется до HTTPS
+- Слишком большое содержимое может быть сокращено
+- Включает 15-минутный самоочищающийся кеш
+- Когда URL перенаправляет на другой хост, инструмент возвращает URL перенаправления — необходимо повторить запрос с новым URL
+- Если доступен инструмент web fetch, предоставляемый MCP, предпочитайте его использование
+
+## Значение в cc-viewer
+
+Вызовы WebFetch в логах запросов отображаются как пары блоков content `tool_use` / `tool_result`. `tool_result` содержит резюме содержимого страницы, обработанное AI.

package/concepts/ru/Tool-WebSearch.md

@@ -0,0 +1,32 @@
+# WebSearch
+
+## Определение
+
+Выполняет запрос к поисковой системе, возвращая результаты поиска для получения актуальной информации.
+
+## Параметры
+
+| Параметр | Тип | Обязательный | Описание |
+|------|------|------|------|
+| `query` | string | Да | Поисковый запрос (минимум 2 символа) |
+| `allowed_domains` | string[] | Нет | Включать только результаты с этих доменов |
+| `blocked_domains` | string[] | Нет | Исключать результаты с этих доменов |
+
+## Сценарии использования
+
+**Подходящее применение:**
+- Получение актуальной информации за пределами даты отсечки знаний модели
+- Поиск текущих событий и последних данных
+- Поиск новейшей технической документации
+
+## Примечания
+
+- Результаты поиска возвращаются в формате гиперссылок markdown
+- После использования необходимо добавить раздел "Sources:" в конце ответа со списком соответствующих URL
+- Поддерживает фильтрацию доменов (включение/исключение)
+- В поисковых запросах следует использовать текущий год
+- Доступно только в США
+
+## Значение в cc-viewer
+
+Вызовы WebSearch в логах запросов отображаются как пары блоков content `tool_use` / `tool_result`. `tool_result` содержит список результатов поиска.