cc-viewer 1.7.21 → 1.7.23

package/concepts/ru/Tool-ListPlugins.md

@@ -0,0 +1,35 @@
+# ListPlugins
+
+Перечисляет включённые у пользователя плагины claude.ai, опционально с фильтром по ключевому слову.
+
+## Когда использовать
+
+- Вам нужно знать, какие плагины уже включены — например, чтобы подтвердить, что установилось после карточки `SuggestPluginInstall`.
+- Пользователь спрашивает, какие у него плагины.
+
+## Активация
+
+- Требует разрешение на доступ к реестру плагинов.
+- Доступность зависит от типа сессии и внедрения функции — отключён в средах с HIPAA, всегда доступен в удалённых сессиях.
+
+## Параметры
+
+- `keywords` (array of strings, необязательный): фильтрация списка — до 8 элементов, каждый 1–64 символа. Опустите, чтобы перечислить всё.
+
+## Примеры
+
+### Пример 1: перечислить включённые плагины
+
+```
+ListPlugins()
+```
+
+### Пример 2: фильтр по ключевому слову
+
+```
+ListPlugins(keywords=["figma"])
+```
+
+## Примечания
+
+- Если каталог плагинов недостижим (forbidden), инструмент деградирует до пустого списка с предупреждением, а не падает.

package/concepts/ru/Tool-ListSkills.md

@@ -0,0 +1,37 @@
+# ListSkills
+
+Перечисляет включённые у пользователя навыки claude.ai, опционально с фильтром по ключевому слову.
+
+## Когда использовать
+
+- Вам нужен авторитетный список навыков, включённых сейчас — перед вызовом одного из них или чтобы подтвердить, что добавила карточка `SuggestSkills`.
+- Пользователь спрашивает, какие у него навыки.
+
+## Активация
+
+- Требует разрешение на доступ к реестру плагинов.
+- Отключён в средах с HIPAA.
+- Всегда доступен в удалённых сессиях.
+
+## Параметры
+
+- `keywords` (array of strings, необязательный): фильтрация списка — до 8 элементов, каждый 1–64 символа. Опустите, чтобы перечислить всё.
+
+## Примеры
+
+### Пример 1: перечислить включённые навыки
+
+```
+ListSkills()
+```
+
+### Пример 2: фильтр по ключевому слову
+
+```
+ListSkills(keywords=["review"])
+```
+
+## Примечания
+
+- Если каталог недостижим (forbidden), инструмент деградирует до пустого списка с предупреждением, а не падает.
+- Это список *включённых* навыков; используйте `SuggestSkills`, чтобы показать навыки, которые пользователь мог бы добавить.

package/concepts/ru/Tool-Monitor.md

@@ -10,6 +10,13 @@
 - Ожидание определённого условия на протяжении многих итераций (например, контрольной точки шага обучения или опустошения очереди)
 - **Не** для простого "ждать завершения" — для этого используйте `Bash` с `run_in_background`; он отправит одно уведомление о завершении, когда процесс завершится
 
+## Активация
+
+- Выключен по умолчанию (серверный фича-флаг).
+- Недоступен на Amazon Bedrock, Google Cloud и Microsoft Foundry.
+- Выключен, когда задано `DISABLE_TELEMETRY` или `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`.
+- Источник WebSocket требует Claude Code 2.1.195+.
+
 ## Параметры
 
 - `command` (строка, обязательный): Команда оболочки или скрипт для запуска. Каждая строка, записанная в стандартный вывод, становится отдельным событием уведомления. Монитор завершается, когда завершается процесс.

package/concepts/ru/Tool-Projects.md

@@ -0,0 +1,46 @@
+# Projects
+
+Управляет проектными документами в базе знаний проекта пользователя Claude: читает, ищет, записывает и удаляет документы, а также получает информацию о проекте.
+
+## Когда использовать
+
+- Сохранить документ (результат работы, заметки, справочный материал) в проект пользователя, чтобы он пережил сессию.
+- Прочитать или найти существующие проектные документы, чтобы заземлить текущую задачу в предыдущем контексте.
+- Загрузить локальный файл в проект, не загружая его содержимое в контекст.
+- Удалить устаревший проектный документ.
+
+## Параметры
+
+- `method` (string, обязательный): одно из `project_info`, `project_read`, `project_search`, `project_write`, `project_delete`.
+- `path` (string, необязательный): для `project_read`/`project_write`/`project_delete`: путь к документу. Для `project_write`: существующий путь заменяется на месте; новое голое имя файла (без "/") получает неймспейс `claude/<name>`.
+- `content` (string, необязательный): для `project_write`: встроенный текст документа. Взаимоисключающий с `local_path`.
+- `local_path` (string, необязательный): для `project_write`: файл внутри рабочей директории для загрузки — содержимое никогда не попадает в ваш контекст. Взаимоисключающий с `content`.
+- `present_to_user` (boolean, необязательный): для `project_write`: пометить этот документ как результат, который пользователю нужно увидеть. По умолчанию false; не задавайте для рутинных сохранений и массовых записей.
+- `query` (string, необязательный): для `project_search`: запрос к базе знаний.
+- `n` (number, необязательный): для `project_search`: количество совпадений (по умолчанию 5).
+
+## Примеры
+
+### Пример 1: записать результат в проект
+
+```
+Projects(
+  method="project_write",
+  path="claude/migration-plan.md",
+  local_path="./migration-plan.md",
+  present_to_user=true
+)
+```
+
+Загружает локальный файл, не подтягивая его содержимое в контекст, и помечает его как результат для пользователя.
+
+### Пример 2: поиск по базе знаний
+
+```
+Projects(method="project_search", query="authentication refresh tokens", n=5)
+```
+
+## Примечания
+
+- `content` — для текста, который вы составляете inline; `local_path` — для всего, что уже на диске — никогда не смешивайте их.
+- Используйте `present_to_user=true` экономно: только для того единственного документа, который пользователь запросил или с которым должен действовать.

package/concepts/ru/Tool-ProposeGoal.md

@@ -0,0 +1,43 @@
+# ProposeGoal
+
+Предлагает проверяемую цель завершения сессии. Цель показывается пользователю в диалоге утверждения (по умолчанию) и, будучи установленной, направляет остаток разговора к проверяемому результату.
+
+## Когда использовать
+
+- У сессии есть конкретное конечное состояние, которое оценщик мог бы проверить по разговору (например, "all tests in test/auth pass").
+- Вы хотите явного подтверждения пользователем того, что значит «готово», перед существенной работой.
+- Слова пользователя уже сформулировали результат, и вы хотите зафиксировать его как цель сессии.
+
+## Активация
+
+- Выключен по умолчанию (серверный фича-флаг).
+- Исключён из интерактивных и фоновых сессий.
+- Отключается ключом настроек `modelProposedGoals: "disabled"`.
+
+## Параметры
+
+- `condition` (string, обязательный): условие завершения, записанное так, чтобы отдельный оценщик мог проверить его по разговору (например, "all tests in test/auth pass (bun test exits 0)"). Не более 500 символов — пользователь должен иметь возможность прочитать условие целиком в диалоге утверждения.
+- `ask_user` (boolean, необязательный): спрашивать ли пользователя об утверждении до установки цели. По умолчанию true (показывается диалог утверждения). Задавайте false ТОЛЬКО когда собственные слова пользователя в этом разговоре назвали этот результат как желаемый; тогда цель устанавливается напрямую с видимым уведомлением, а пользователь может очистить её через `/goal clear`.
+
+## Примеры
+
+### Пример 1: предложить цель, подкреплённую тестами
+
+```
+ProposeGoal(condition="npm run test exits 0 with the new catalog cases included")
+```
+
+Пользователь видит условие в диалоге утверждения и может принять, отредактировать или отклонить его.
+
+### Пример 2: принять сформулированный пользователем результат напрямую
+
+```
+ProposeGoal(condition="the login form validates email format and shows an inline error", ask_user=false)
+```
+
+Допустимо только потому, что пользователь явно назвал этот результат ранее в разговоре.
+
+## Примечания
+
+- Держите `condition` коротким и объективно проверяемым — размытые цели ("make it better") лишают инструмент смысла.
+- `ask_user=false` строго ограничен результатами, которые пользователь сам назвал; всё остальное должно проходить через диалог утверждения.

package/concepts/ru/Tool-PushNotification.md

@@ -14,6 +14,12 @@
 
 Не отправляйте уведомление для плановых обновлений о ходе выполнения задачи и не подтверждайте им ответ на вопрос, который пользователь только что задал и явно ждёт. Не уведомляйте о завершении коротких задач — если пользователь только что отправил задачу и ждёт, уведомление не несёт никакой ценности и подрывает доверие к будущим уведомлениям. Настоятельно склоняйтесь к тому, чтобы не отправлять.
 
+## Активация
+
+- Выключен по умолчанию (серверный фича-флаг).
+- Доставка идёт через инфраструктуру, размещённую у Anthropic — недоступен на Amazon Bedrock, Claude Platform on AWS, Google Cloud и Microsoft Foundry.
+- Пуш на телефон дополнительно требует подключённого клиента Remote Control.
+
 ## Параметры
 
 - `message` (строка, обязательный): текст уведомления. Держите его в пределах 200 символов; мобильные операционные системы обрезают более длинные строки. Начинайте с того, на что пользователь будет реагировать: "build failed: 2 auth tests" информативнее, чем "task complete".

package/concepts/ru/Tool-REPL.md

@@ -0,0 +1,47 @@
+# REPL
+
+Выполняет JavaScript в постоянном vm-контексте Node.js внутри сессии. Поддерживается верхнеуровневый `await`, а переменные/функции, определённые в одном вызове, остаются доступными в последующих вызовах.
+
+## Когда использовать
+
+- Быстрые вычисления, трансформация данных или обработка JSON, которые проще сделать в коде, чем в shell-однострочниках.
+- Многошаговые скрипты, где промежуточное состояние должно сохраняться между вызовами (счётчики, накопленные результаты).
+- Интерактивное исследование поведения API или библиотеки перед записью его в файл.
+
+## Активация
+
+- Выключен по умолчанию — задайте `CLAUDE_CODE_REPL=true`, чтобы включить его.
+- В терминальных (`cli`) и claude.ai (`remote`) сессиях серверный фича-флаг также может включить его.
+- Когда выключен, REPL скрыт из списка инструментов модели. Когда включён, `Read`, `Glob`, `Grep`, `Bash`, `PowerShell` и `NotebookEdit` заменяются сокращениями REPL.
+
+## Параметры
+
+- `code` (string, обязательный): JavaScript-код для выполнения. Поддерживает верхнеуровневый await. Состояние сохраняется между вызовами.
+- `description` (string, необязательный): ясное, краткое описание того, что делает скрипт, в действительном залоге (5–10 слов), например "Trace upgrade message to its GrowthBook flag".
+- `timeout` (number, необязательный): таймаут в миллисекундах. По умолчанию 30000; максимум 600000.
+
+## Примеры
+
+### Пример 1: вычисление с повторным использованием состояния
+
+```
+REPL(code="const counts = new Map(); ['a','b','a'].forEach(k => counts.set(k, (counts.get(k)||0)+1)); counts.get('a')")
+```
+
+Возвращает `2`; `counts` остаётся определённым для последующих вызовов REPL в той же сессии.
+
+### Пример 2: верхнеуровневый await с увеличенным таймаутом
+
+```
+REPL(
+  code="const res = await fetch('https://example.com/api'); await res.json()",
+  description="Fetch example API and parse JSON",
+  timeout=60000
+)
+```
+
+## Примечания
+
+- Состояние привязано к сессии: перезапуск сессии очищает все определения.
+- Это среда JavaScript (Node) — используйте Bash для команд shell, тяжёлой работы с файловой системой или не-JS рантаймов.
+- Долго выполняющийся код должен задавать явный `timeout`; стандартные 30 с прерывают всё, что медленнее.

package/concepts/ru/Tool-ReadMcpResource.md

@@ -0,0 +1,32 @@
+# ReadMcpResource
+
+Читает один ресурс, предоставляемый подключённым MCP-сервером (Model Context Protocol), по его URI.
+
+## Когда использовать
+
+- MCP-сервер рекламирует ресурс (файл, запись, документ), чьё содержимое вам нужно в контексте.
+- У вас есть конкретный URI ресурса — из `ListMcpResources`, из документации сервера или из предыдущего результата инструмента.
+
+## Активация
+
+- Всегда включён, но не показывается в списке инструментов модели — предназначен для использования тонким клиентом / сайдкаром.
+
+## Параметры
+
+- `server` (string, обязательный): имя MCP-сервера.
+- `uri` (string, обязательный): URI ресурса для чтения.
+
+## Примеры
+
+### Пример 1: прочитать ресурс сервера по URI
+
+```
+ReadMcpResource(server="github", uri="file:///repo/docs/architecture.md")
+```
+
+Возвращает содержимое ресурса в том виде, как его предоставляет MCP-сервер `github`.
+
+## Примечания
+
+- Сначала используйте `ListMcpResources`, если не знаете, какие ресурсы предоставляет сервер; для листингов каталогового типа используйте `ReadMcpResourceDir`.
+- Схема URI специфична для сервера (`file://`, `https://`, пользовательские схемы) — проверьте, что рекламирует целевой сервер.

package/concepts/ru/Tool-ReadMcpResourceDir.md

@@ -0,0 +1,32 @@
+# ReadMcpResourceDir
+
+Перечисляет записи ресурса каталогового типа, предоставляемого подключённым MCP-сервером, по его URI.
+
+## Когда использовать
+
+- MCP-сервер организует ресурсы иерархически, и вам нужно перечислить один уровень этой иерархии.
+- Вы хотите осмотреться перед чтением отдельных ресурсов через `ReadMcpResource`.
+
+## Активация
+
+- Всегда включён, но не показывается в списке инструментов модели — предназначен для использования тонким клиентом / сайдкаром.
+
+## Параметры
+
+- `server` (string, обязательный): имя MCP-сервера.
+- `uri` (string, обязательный): URI ресурса-каталога для перечисления.
+
+## Примеры
+
+### Пример 1: перечислить каталог ресурсов
+
+```
+ReadMcpResourceDir(server="filesystem", uri="file:///project/src/")
+```
+
+Возвращает дочерние записи, которые сервер предоставляет под этим URI каталога.
+
+## Примечания
+
+- Поддерживается только серверами, которые моделируют свои ресурсы как каталоги; серверы с плоской структурой вернут ошибку или пустой листинг — откатывайтесь на `ListMcpResources`.
+- Комбинируйте с `ReadMcpResource`, чтобы углубляться в записи, которые выглядят релевантными.

package/concepts/ru/Tool-ReadNotifications.md

@@ -0,0 +1,27 @@
+# ReadNotifications
+
+Читает уведомления, поставленные в очередь для ассистента в текущей сессии — активность GitHub по подписанным PR (`github_webhook`), срабатывания запланированных триггеров (`trigger_fire`) и сообщения, приходящие из других сессий Claude (`mcp_send_message`).
+
+## Когда использовать
+
+- Вас уведомили, что что-то произошло — подписанный PR обновился, запланированный триггер сработал, другая сессия прислала вам сообщение — и вам нужны сами данные (payload).
+- Разгрузка накопившейся очереди: большие партии возвращаются по частям, поэтому продолжайте вызывать инструмент, пока результат не сообщит 0 `remaining`.
+
+## Параметры
+
+Этот инструмент не принимает параметров.
+
+## Примеры
+
+### Пример 1: разгрузить очередь уведомлений
+
+```
+ReadNotifications()
+```
+
+Возвращает поставленные в очередь уведомления, начиная с самых старых. Результат содержит счётчик `remaining` — сколько уведомлений осталось в очереди после этого чтения; вызовите инструмент ещё раз, чтобы прочитать их.
+
+## Примечания
+
+- Выгрузка ограничена по размеру: последующий вызов возвращает остаток ТОЙ ЖЕ очереди (плюс всё, что пришло заново), а не только новые поступления. Повторяйте цикл, пока `remaining` не станет 0.
+- Уведомления порождаются вебхуками GitHub по подписанным PR, запланированными триггерами и сообщениями из других сессий Claude; в текущей версии параметра фильтрации нет.

package/concepts/ru/Tool-RemoteTrigger.md

@@ -10,6 +10,13 @@
 - Отображение или аудит всех текущих триггеров для проверки их конфигурации и состояния
 - Обновление настроек триггера, таких как расписание, полезная нагрузка или описание, без необходимости его пересоздания
 
+## Активация
+
+- Требует тарифный план claude.ai Pro, Max, Team или Enterprise.
+- Недоступен на Amazon Bedrock, Claude Platform on AWS, Google Cloud и Microsoft Foundry.
+- Требует серверные фича-флаги и настройки политики `allow_remote_sessions` / `allow_routines`.
+- Не для самих удалённых сессий.
+
 ## Параметры
 
 - `action` (string, обязательный): выполняемая операция — одно из значений `list`, `get`, `create`, `update` или `run`

package/concepts/ru/Tool-ScheduleWakeup.md

@@ -10,6 +10,11 @@
 - При запуске автономного цикла без промпта пользователя — передать буквальный sentinel `<<autonomous-loop-dynamic>>` как `prompt`
 - При опросе процесса, состояние которого вот-вот изменится (использовать короткую задержку для поддержания кэша в тёплом состоянии)
 
+## Активация
+
+- Недоступен на Amazon Bedrock, Claude Platform on AWS, Google Cloud Agent Platform и Microsoft Foundry.
+- Также выключен, когда отключено получение фича-флагов (переменные окружения телеметрии/трафика).
+
 ## Параметры
 
 - `delaySeconds` (число, обязательное): Секунды до возобновления. Среда выполнения автоматически ограничивает значение до `[60, 3600]`, поэтому ручное ограничение не требуется.

package/concepts/ru/Tool-SearchMcpRegistry.md

@@ -0,0 +1,31 @@
+# SearchMcpRegistry
+
+Ищет по реестру MCP-коннекторов по ключевым словам, чтобы обнаружить коннекторы, которые могут помочь завершить задачу.
+
+## Когда использовать
+
+- Задача выиграет от внешнего сервиса (базы данных, трекера задач, SaaS API), и вы хотите проверить, существует ли для него MCP-коннектор.
+- Пользователь называет продукт и просит подключить его — ищите в реестре подходящий коннектор.
+
+## Активация
+
+- Доступен только в удалённых (claude.ai) сессиях на собственном API.
+
+## Параметры
+
+- `keywords` (array of strings, обязательный): ключевые фразы, описывающие намерение пользователя или названный продукт. 1–8 элементов, каждый 1–64 символа.
+
+## Примеры
+
+### Пример 1: найти коннектор для названного продукта
+
+```
+SearchMcpRegistry(keywords=["linear", "issue tracker"])
+```
+
+Возвращает записи реестра, чьи коннекторы совпадают с ключевыми словами. Полные детали коннектора разрешайте через `SuggestConnectors`.
+
+## Примечания
+
+- Только для чтения и безопасен при параллельных вызовах; результаты ограничены по размеру.
+- Поиск ничего не устанавливает — это чистое обнаружение.

package/concepts/ru/Tool-SendFeedback.md

@@ -0,0 +1,38 @@
+# SendFeedback
+
+Отправляет структурированный отзыв о Claude Code в Anthropic — баг-репорты, идеи функций или отсутствующие возможности — не покидая сессию.
+
+## Когда использовать
+
+- Пользователь просит сообщить о баге или отправить отзыв о самом Claude Code.
+- Вы столкнулись с явным дефектом продукта (сломанная команда, неправильное поведение, краш), о котором стоит сообщить.
+- Пользователь описывает функцию, которую хотел бы видеть (идею или отсутствующую возможность).
+
+## Параметры
+
+- `type` (string, обязательный): одно из `bug`, `idea`, `missing_capability`.
+- `title` (string, обязательный): короткое, конкретное однострочное резюме проблемы.
+- `details` (string, обязательный): маркированные пункты с метками, по порядку: **What happened:** (наблюдаемое против ожидаемого, точный текст ошибки, если он короткий); **What the user said:** (цитата или "User didn't comment; observed by the model."); **Repro:** (минимальные шаги); **Evidence:** (ID запросов, временные метки, пути, версии — опустить, если нет); опционально финальный **Cause:** только если подтверждён в сессии. Одна-три строки на пункт; без повествовательных абзацев, без спекуляций, без секретов.
+- `area` (string, необязательный): короткий тег, называющий часть Claude Code, к которой это относится (например, "hooks config", "/help", "file editing"). Оставьте пустым, если неясно.
+- `failure_mode` (string, необязательный): для отчётов о поведении модели — ближайший режим сбоя (например, `instruction_following`, `repetition_and_looping`, `context_and_memory`, `stopping_short` или `other`). Опускайте только когда отчёт — чисто продуктовый/инструментальный баг.
+- `task_category` (string, необязательный): чем занималась сессия в момент проблемы: `code_edit`, `debug`, `explain`, `plan`, `shell`, `search`, `review` или `other`.
+
+## Примеры
+
+### Пример 1: сообщить о продуктовом баге
+
+```
+SendFeedback(
+  type="bug",
+  title="/export truncates the last message",
+  details="**What happened:** exported transcript is missing the final assistant message.\n**What the user said:** \"the last reply never shows up in the file\".\n**Repro:** run /export after any multi-turn session.\n**Evidence:** v2.1.233, macOS.",
+  area="/export",
+  task_category="other"
+)
+```
+
+## Примечания
+
+- Никогда не включайте секреты, токены или приватные данные пользователя в `details`.
+- Цитируйте слова пользователя, когда они доступны; иначе укажите, что модель наблюдала проблему.
+- Держите отчёт фактическим — спекуляции о первопричине допустимы только в `**Cause:**` и только когда подтверждены в сессии.

package/concepts/ru/Tool-SendFile.md

@@ -0,0 +1,36 @@
+# SendFile
+
+Отправляет один или несколько файлов в другую сессию Claude Code — пир-сессию из списка `ListAgents` или явный адрес сессии.
+
+## Когда использовать
+
+- Пир-сессии нужен файл из вашей рабочей директории (отчёт, патч, фикстура), чтобы продолжить собственную задачу.
+- Вы координируете работу между сессиями и хотите передавать артефакты, а не только текст (для текста используйте `SendMessage`).
+
+## Активация
+
+- Межсессионная передача файлов должна быть доступна в сессии; когда это не так, валидация завершается ошибкой "Cross-session file transfer is not available in this session."
+- Ограничен теми же условиями межсессионного обмена сообщениями, что и `ListAgents` (серверные фича-флаги, выключены по умолчанию).
+
+## Параметры
+
+- `to` (string, обязательный): получатель — имя пир-сессии из `ListAgents` или явный адрес `uds:<socket>` / `bridge:<session id>`.
+- `files` (array of strings, обязательный): пути файлов (абсолютные или относительно cwd) для отправки. Всегда передавайте массив, даже для одного файла. 1–16 файлов, максимум 30 MiB каждый.
+- `message` (string, необязательный): короткое сообщение, доставляемое вместе с файлами.
+
+## Примеры
+
+### Пример 1: отправить отчёт в пир-сессию
+
+```
+SendFile(
+  to="teammate-a",
+  files=["./dist/report.html"],
+  message="The analysis you asked for"
+)
+```
+
+## Примечания
+
+- Передачи на удалённые машины могут требовать дополнительного одобрения.
+- Чтение содержимого файлов — часть отправки; отклоняется, если чтение файлов запрещено правилами разрешений.

package/concepts/ru/Tool-SendMessage.md

@@ -10,6 +10,11 @@
 - Ответ на протокольный запрос, такой как запрос на завершение работы или запрос на одобрение плана от лидера команды.
 - Замыкание цикла в конце делегированной задачи, чтобы лидер мог отметить пункт завершённым.
 
+## Активация
+
+- Ограничен теми же условиями межсессионного обмена сообщениями, что и `ListAgents` (серверные фича-флаги, выключены по умолчанию).
+- Сокомандники дополнительно требуют включённых экспериментальных команд агентов.
+
 ## Параметры
 
 - `to` (string, обязательный): `name` целевого сокомандника, зарегистрированное в команде, либо `*` для рассылки всем сокомандникам сразу.

package/concepts/ru/Tool-SendUserFile.md

@@ -0,0 +1,38 @@
+# SendUserFile
+
+Отправляет пользователю один или несколько файлов — сгенерированные артефакты, скриншоты, отчёты — с контролем над тем, как клиент их представит.
+
+## Когда использовать
+
+- Вы создали файл, который нужен пользователю (отчёт, изображение, HTML-страница), и хотите его показать, а не просто упомянуть путь.
+- Ответ с вложением (`status="normal"`) или проактивный показ того, о чём пользователь не просил, но что ему нужно увидеть сейчас (`status="proactive"`).
+
+## Активация
+
+- Доступен только когда подключён клиент Remote Control или сессия выполняется в управляемой облачной среде (например, Claude Code в вебе).
+- Недоступен на Amazon Bedrock, Google Cloud и Microsoft Foundry.
+- Требует, чтобы сессия разрешала отправку файлов (возможность, открываемая настройками/фича-флагами); не предлагается в brief-режиме.
+
+## Параметры
+
+- `files` (array of strings, обязательный): пути файлов (абсолютные или относительно cwd) для отправки пользователю. Всегда передавайте массив, даже для одного файла.
+- `caption` (string, необязательный): короткая подпись к файлу(-ам).
+- `status` (string, обязательный): `proactive`, когда показываете файл, о котором пользователь не просил и который ему нужно увидеть сейчас — сгенерированный артефакт, завершённый отчёт; `normal`, когда отвечаете на то, что пользователь только что сказал.
+- `display` (string, необязательный): `render` открывает файл inline в боковой панели (HTML, SVG, Mermaid, изображения, PDF); `attach` показывает только карточку скачивания (результаты, которые пользователь сохранит и откроет в другом месте). Опустите, чтобы клиент решал по типу файла.
+
+## Примеры
+
+### Пример 1: доставить сгенерированный отчёт
+
+```
+SendUserFile(
+  files=["./out/weekly-report.html"],
+  caption="Weekly usage report",
+  status="proactive",
+  display="render"
+)
+```
+
+## Примечания
+
+- Выбирайте `display="attach"` для файлов, которые пользователь сохраняет и открывает в другом приложении; `render` — для всего, что он должен посмотреть немедленно.

package/concepts/ru/Tool-SendUserMessage.md

@@ -0,0 +1,38 @@
+# SendUserMessage
+
+Отправляет сообщение пользователю — основной видимый канал вывода в сессиях в стиле brief. Также известен под устаревшим псевдонимом `Brief`.
+
+## Когда использовать
+
+- Ответ на то, что пользователь только что сказал (`status="normal"`).
+- Проактивный показ того, о чём пользователь не просил и что ему нужно увидеть сейчас — задача, завершившаяся пока его нет, блокер, в который вы упёрлись, незапрошенное обновление статуса (`status="proactive"`).
+
+## Активация
+
+- По умолчанию скрыт в интерактивных сессиях; большинство интерактивных CLI-сессий вместо этого говорят с пользователем напрямую.
+- Включён в brief-режиме или через серверные фича-флаги.
+
+## Параметры
+
+В brief-режиме:
+
+- `message` (string, обязательный): сообщение для пользователя. Поддерживает markdown-форматирование.
+- `attachments` (array, необязательный): вложения, показываемые рядом с сообщением. Каждая запись — либо путь к файлу (абсолютный или относительно cwd) для локально читаемого файла, либо заранее разрешённый объект `{file_uuid, file_name, size, is_image}`, полученный от инструмента устройства, такого как `attach_file`.
+- `status` (string, обязательный): `proactive` для незапрошенных обновлений, которые нужны пользователю сейчас; `normal` при ответе пользователю.
+
+В сборках без brief доступен только `message`.
+
+## Примеры
+
+### Пример 1: проактивное уведомление о завершении
+
+```
+SendUserMessage(
+  message="The migration finished — 42 files updated, tests green.",
+  status="proactive"
+)
+```
+
+## Примечания
+
+- Используйте `proactive` экономно — он предназначен для вещей, которые действительно требуют внимания пользователя прямо сейчас.

package/concepts/ru/Tool-SuggestConnectors.md

@@ -0,0 +1,28 @@
+# SuggestConnectors
+
+Разрешает полные полезные данные (payload) коннекторов для значений `directoryUuid`, возвращённых `SearchMcpRegistry`, чтобы пользователю можно было предложить конкретные коннекторы для включения.
+
+## Когда использовать
+
+- После того как `SearchMcpRegistry` вернул кандидатов-коннекторы, чтобы получить их полные детали для представления.
+
+## Активация
+
+- Доступен только в удалённых (claude.ai) сессиях на собственном API.
+
+## Параметры
+
+- `uuids` (array of strings, обязательный): значения `directoryUuid` или `server_id` для разрешения. 1–32 элемента, каждый 1–64 символа.
+
+## Примеры
+
+### Пример 1: разрешить два попадания из реестра
+
+```
+SuggestConnectors(uuids=["d290f1ee-6c54-4b01-90e6-d701748f0851", "a1b2c3d4-0000-4000-8000-abcdefabcdef"])
+```
+
+## Примечания
+
+- Никогда не угадывайте UUID — разрешайте только идентификаторы, пришедшие из `SearchMcpRegistry`.
+- Инструмент сам ничего не подключает; включение коннектора происходит вне этого инструмента.