diff --git a/docs/uk/cli/migrate.md b/docs/uk/cli/migrate.md
index b06545507..90db37d94 100644
--- a/docs/uk/cli/migrate.md
+++ b/docs/uk/cli/migrate.md
@@ -1,24 +1,24 @@
---
read_when:
- - Ви хочете виконати міграцію з Hermes або іншої системи агентів до OpenClaw
- - Ви додаєте провайдера міграції, яким володіє Plugin
-summary: Довідка CLI для `openclaw migrate` (імпортувати стан з іншої системи агентів)
+ - Ви хочете перейти з Hermes або іншої агентної системи на OpenClaw
+ - Ви додаєте провайдера міграцій, що належить плагіну
+summary: Довідник CLI для `openclaw migrate` (імпорт стану з іншої агентної системи)
title: Міграція
x-i18n:
- generated_at: "2026-04-27T10:58:16Z"
- model: gpt-5.4
+ generated_at: "2026-04-29T19:09:22Z"
+ model: gpt-5.5
provider: openai
- source_hash: d59f9da14184ba4a8613699f7adb5787146ab1db1f79af605c1c25fcd4b2a112
+ source_hash: d3db14c16b8f9dcbf86a4f12558cf4e8555aa9a255637034fb804148996a225e
source_path: cli/migrate.md
- workflow: 15
+ workflow: 16
---
# `openclaw migrate`
-Імпортуйте стан з іншої системи агентів через провайдера міграції, яким володіє Plugin. Вбудовані провайдери охоплюють [Claude](/uk/install/migrating-claude) і [Hermes](/uk/install/migrating-hermes); сторонні плагіни можуть реєструвати додаткових провайдерів.
+Імпортуйте стан з іншої агентної системи через провайдер міграції, яким володіє Plugin. Вбудовані провайдери охоплюють [Claude](/uk/install/migrating-claude) і [Hermes](/uk/install/migrating-hermes); сторонні plugins можуть реєструвати додаткових провайдерів.
-Для покрокових інструкцій для користувачів дивіться [Міграція з Claude](/uk/install/migrating-claude) і [Міграція з Hermes](/uk/install/migrating-hermes). [Центр міграції](/uk/install/migrating) містить усі шляхи.
+Для користувацьких покрокових інструкцій див. [Міграція з Claude](/uk/install/migrating-claude) і [Міграція з Hermes](/uk/install/migrating-hermes). [Центр міграції](/uk/install/migrating) перелічує всі шляхи.
## Команди
@@ -43,92 +43,92 @@ openclaw onboard --import-from hermes --import-source ~/.hermes
Побудувати план і вийти без зміни стану.
- Перевизначити каталог стану джерела. Для Hermes типовим значенням є `~/.hermes`.
+ Перевизначити каталог стану джерела. Hermes за замовчуванням використовує `~/.hermes`.
- Імпортувати підтримувані облікові дані. Типово вимкнено.
+ Імпортувати підтримувані облікові дані. Вимкнено за замовчуванням.
- Дозволити apply замінювати наявні цілі, коли план повідомляє про конфлікти.
+ Дозволити застосуванню замінювати наявні цільові об’єкти, коли план повідомляє про конфлікти.
- Пропустити запит на підтвердження. Обов’язково в неінтерактивному режимі.
+ Пропустити запит підтвердження. Обов’язково в неінтерактивному режимі.
- Пропустити резервне копіювання перед apply. Потребує `--force`, коли локальний стан OpenClaw уже існує.
+ Пропустити резервну копію перед застосуванням. Потребує `--force`, коли існує локальний стан OpenClaw.
- Обов’язковий разом із `--no-backup`, коли apply інакше відмовився б пропускати резервне копіювання.
+ Потрібно разом із `--no-backup`, коли застосування інакше відмовилося б пропускати резервну копію.
- Надрукувати план або результат apply у форматі JSON. З `--json` і без `--yes` apply друкує план і не змінює стан.
+ Надрукувати план або результат застосування як JSON. З `--json` і без `--yes` застосування друкує план і не змінює стан.
## Модель безпеки
-`openclaw migrate` спочатку показує попередній перегляд.
+`openclaw migrate` спершу показує попередній перегляд.
-
- Провайдер повертає деталізований план до будь-яких змін, зокрема конфлікти, пропущені елементи та чутливі елементи. Плани JSON, вивід apply і звіти міграції редагують вкладені ключі, схожі на секрети, як-от API-ключі, токени, заголовки авторизації, cookie і паролі.
+
+ Провайдер повертає деталізований план до будь-яких змін, включно з конфліктами, пропущеними елементами та чутливими елементами. JSON-плани, вивід застосування та звіти міграції редагують вкладені ключі, схожі на секрети, як-от API-ключі, токени, заголовки авторизації, cookie та паролі.
- `openclaw migrate apply ` показує попередній перегляд плану та запитує підтвердження перед зміною стану, якщо не встановлено `--yes`. У неінтерактивному режимі apply потребує `--yes`.
+ `openclaw migrate apply ` попередньо показує план і запитує підтвердження перед зміною стану, якщо не встановлено `--yes`. У неінтерактивному режимі застосування потребує `--yes`.
- Apply створює й перевіряє резервну копію OpenClaw перед застосуванням міграції. Якщо локальний стан OpenClaw ще не існує, крок резервного копіювання пропускається, і міграція може продовжитися. Щоб пропустити резервне копіювання, коли стан існує, передайте і `--no-backup`, і `--force`.
+ Застосування створює й перевіряє резервну копію OpenClaw перед застосуванням міграції. Якщо локального стану OpenClaw ще немає, крок резервного копіювання пропускається, і міграція може продовжитися. Щоб пропустити резервну копію, коли стан існує, передайте і `--no-backup`, і `--force`.
- Apply відмовляється продовжувати, коли в плані є конфлікти. Перегляньте план, а потім перезапустіть із `--overwrite`, якщо заміна наявних цілей є навмисною. Провайдери все одно можуть записувати резервні копії на рівні елементів для перезаписаних файлів у каталог звіту міграції.
+ Застосування відмовляється продовжувати, коли план має конфлікти. Перегляньте план, потім запустіть повторно з `--overwrite`, якщо заміна наявних цільових об’єктів є навмисною. Провайдери все ще можуть записувати резервні копії на рівні елементів для перезаписаних файлів у каталозі звіту міграції.
- Секрети ніколи не імпортуються типово. Використовуйте `--include-secrets`, щоб імпортувати підтримувані облікові дані.
+ Секрети ніколи не імпортуються за замовчуванням. Використовуйте `--include-secrets`, щоб імпортувати підтримувані облікові дані.
## Провайдер Claude
-Вбудований провайдер Claude типово виявляє стан Claude Code у `~/.claude`. Використовуйте `--from `, щоб імпортувати конкретний домашній каталог Claude Code або корінь проєкту.
+Вбудований провайдер Claude за замовчуванням виявляє стан Claude Code у `~/.claude`. Використовуйте `--from `, щоб імпортувати певний домашній каталог Claude Code або корінь проєкту.
-Для покрокової інструкції для користувачів дивіться [Міграція з Claude](/uk/install/migrating-claude).
+Для користувацьких покрокових інструкцій див. [Міграція з Claude](/uk/install/migrating-claude).
### Що імпортує Claude
-- Файли `CLAUDE.md` проєкту та `.claude/CLAUDE.md` до робочого простору агента OpenClaw.
+- Проєктні `CLAUDE.md` і `.claude/CLAUDE.md` у робочий простір агента OpenClaw.
- Користувацький `~/.claude/CLAUDE.md`, доданий до `USER.md` робочого простору.
-- Визначення MCP-серверів із `.mcp.json` проєкту, `~/.claude.json` Claude Code і `claude_desktop_config.json` Claude Desktop.
-- Каталоги навичок Claude, які містять `SKILL.md`.
-- Markdown-файли команд Claude, перетворені на Skills OpenClaw лише з ручним викликом.
+- Визначення серверів MCP із проєктного `.mcp.json`, Claude Code `~/.claude.json` і Claude Desktop `claude_desktop_config.json`.
+- Каталоги Claude Skills, які містять `SKILL.md`.
+- Markdown-файли команд Claude, перетворені на OpenClaw Skills лише з ручним викликом.
-### Стан архіву та ручної перевірки
+### Архів і стан для ручного перегляду
-Хуки Claude, дозволи, типові значення середовища, локальна пам’ять, правила з прив’язкою до шляху, субагенти, кеші, плани й історія проєкту зберігаються у звіті міграції або позначаються як елементи для ручної перевірки. OpenClaw не виконує хуки, не копіює широкі списки дозволів і не імпортує стан OAuth/Desktop-облікових даних автоматично.
+Хуки Claude, дозволи, стандартні значення середовища, локальна пам’ять, правила з областю дії за шляхом, субагенти, кеші, плани та історія проєкту зберігаються у звіті міграції або повідомляються як елементи для ручного перегляду. OpenClaw не виконує хуки, не копіює широкі списки дозволів і не імпортує стан облікових даних OAuth/Desktop автоматично.
## Провайдер Hermes
-Вбудований провайдер Hermes типово виявляє стан у `~/.hermes`. Використовуйте `--from `, коли Hermes розміщено в іншому місці.
+Вбудований провайдер Hermes за замовчуванням виявляє стан у `~/.hermes`. Використовуйте `--from `, коли Hermes розташований в іншому місці.
### Що імпортує Hermes
-- Типову конфігурацію моделі з `config.yaml`.
-- Налаштованих провайдерів моделей і власні OpenAI-сумісні endpoint-и з `providers` і `custom_providers`.
-- Визначення MCP-серверів із `mcp_servers` або `mcp.servers`.
-- `SOUL.md` і `AGENTS.md` до робочого простору агента OpenClaw.
+- Стандартну конфігурацію моделі з `config.yaml`.
+- Налаштованих провайдерів моделей і власні OpenAI-сумісні кінцеві точки з `providers` і `custom_providers`.
+- Визначення серверів MCP з `mcp_servers` або `mcp.servers`.
+- `SOUL.md` і `AGENTS.md` у робочий простір агента OpenClaw.
- `memories/MEMORY.md` і `memories/USER.md`, додані до файлів пам’яті робочого простору.
-- Типові значення конфігурації пам’яті для файлової пам’яті OpenClaw, а також елементи архіву або ручної перевірки для зовнішніх провайдерів пам’яті, таких як Honcho.
-- Skills, що містять файл `SKILL.md` у `skills//`.
-- Значення конфігурації для кожної навички з `skills.config`.
+- Стандартні значення конфігурації пам’яті для файлової пам’яті OpenClaw, а також архівні елементи або елементи для ручного перегляду для зовнішніх провайдерів пам’яті, як-от Honcho.
+- Skills, які містять файл `SKILL.md` у `skills//`.
+- Значення конфігурації для окремих Skills з `skills.config`.
- Підтримувані API-ключі з `.env`, лише з `--include-secrets`.
### Підтримувані ключі `.env`
`OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `OPENROUTER_API_KEY`, `GOOGLE_API_KEY`, `GEMINI_API_KEY`, `GROQ_API_KEY`, `XAI_API_KEY`, `MISTRAL_API_KEY`, `DEEPSEEK_API_KEY`.
-### Лише архівний стан
+### Стан лише для архіву
-Стан Hermes, який OpenClaw не може безпечно інтерпретувати, копіюється до звіту міграції для ручної перевірки, але не завантажується до живої конфігурації чи облікових даних OpenClaw. Це зберігає непрозорий або небезпечний стан без удавання, що OpenClaw може автоматично його виконати чи довіряти йому:
+Стан Hermes, який OpenClaw не може безпечно інтерпретувати, копіюється у звіт міграції для ручного перегляду, але не завантажується в активну конфігурацію або облікові дані OpenClaw. Це зберігає непрозорий або небезпечний стан, не вдаючи, що OpenClaw може виконувати його або автоматично йому довіряти:
- `plugins/`
- `sessions/`
@@ -146,7 +146,7 @@ openclaw doctor
## Контракт Plugin
-Джерела міграції — це плагіни. Плагін оголошує свої ідентифікатори провайдерів у `openclaw.plugin.json`:
+Джерела міграції — це plugins. Plugin оголошує свої ідентифікатори провайдера в `openclaw.plugin.json`:
```json
{
@@ -156,22 +156,22 @@ openclaw doctor
}
```
-Під час виконання плагін викликає `api.registerMigrationProvider(...)`. Провайдер реалізує `detect`, `plan` і `apply`. Ядро володіє оркестрацією CLI, політикою резервного копіювання, запитами підтвердження, JSON-виводом і попередньою перевіркою конфліктів. Ядро передає перевірений план у `apply(ctx, plan)`, а провайдери можуть перебудовувати план лише тоді, коли цей аргумент відсутній для сумісності.
+Під час виконання Plugin викликає `api.registerMigrationProvider(...)`. Провайдер реалізує `detect`, `plan` і `apply`. Ядро відповідає за оркестрацію CLI, політику резервного копіювання, запити, JSON-вивід і попередню перевірку конфліктів. Ядро передає переглянутий план у `apply(ctx, plan)`, а провайдери можуть перебудовувати план лише тоді, коли цей аргумент відсутній для сумісності.
-Плагіни-провайдери можуть використовувати `openclaw/plugin-sdk/migration` для побудови елементів і підрахунку підсумків, а також `openclaw/plugin-sdk/migration-runtime` для копіювання файлів з урахуванням конфліктів, копіювання звітів лише в архів і звітів міграції.
+Провайдерські plugins можуть використовувати `openclaw/plugin-sdk/migration` для створення елементів і підрахунків у підсумках, а також `openclaw/plugin-sdk/migration-runtime` для копіювання файлів з урахуванням конфліктів, копій звітів лише для архіву, кешованих обгорток config-runtime і звітів міграції.
-## Інтеграція з онбордингом
+## Інтеграція з початковим налаштуванням
-Онбординг може пропонувати міграцію, коли провайдер виявляє відоме джерело. І `openclaw onboard --flow import`, і `openclaw setup --wizard --import-from hermes` використовують того самого провайдера міграції Plugin і все одно показують попередній перегляд перед застосуванням.
+Початкове налаштування може запропонувати міграцію, коли провайдер виявляє відоме джерело. І `openclaw onboard --flow import`, і `openclaw setup --wizard --import-from hermes` використовують того самого провайдера міграції Plugin і все одно показують попередній перегляд перед застосуванням.
-Імпорт через онбординг вимагає чистого налаштування OpenClaw. Спочатку скиньте конфігурацію, облікові дані, сесії та робочий простір, якщо у вас уже є локальний стан. Імпорт із резервним копіюванням плюс перезапис або злиття для наявних налаштувань увімкнено лише через feature gate.
+Імпорти під час початкового налаштування потребують свіжого налаштування OpenClaw. Спочатку скиньте конфігурацію, облікові дані, сеанси та робочий простір, якщо у вас уже є локальний стан. Імпорти з резервним копіюванням і перезаписом або злиттям закриті feature-gate для наявних налаштувань.
## Пов’язане
-- [Міграція з Hermes](/uk/install/migrating-hermes): покрокова інструкція для користувачів.
-- [Міграція з Claude](/uk/install/migrating-claude): покрокова інструкція для користувачів.
-- [Міграція](/uk/install/migrating): перенесення OpenClaw на нову машину.
+- [Міграція з Hermes](/uk/install/migrating-hermes): користувацькі покрокові інструкції.
+- [Міграція з Claude](/uk/install/migrating-claude): користувацькі покрокові інструкції.
+- [Міграція](/uk/install/migrating): перемістити OpenClaw на нову машину.
- [Doctor](/uk/gateway/doctor): перевірка стану після застосування міграції.
-- [Плагіни](/uk/tools/plugin): встановлення та реєстрація плагінів.
+- [Plugins](/uk/tools/plugin): встановлення й реєстрація plugins.
diff --git a/docs/uk/plugins/sdk-subpaths.md b/docs/uk/plugins/sdk-subpaths.md
index 60aced408..56d92842e 100644
--- a/docs/uk/plugins/sdk-subpaths.md
+++ b/docs/uk/plugins/sdk-subpaths.md
@@ -1,337 +1,337 @@
---
read_when:
- Вибір правильного підшляху plugin-sdk для імпорту Plugin
- - Аудит підшляхів вбудованих Plugin і допоміжних поверхонь
-summary: 'Каталог підшляхів Plugin SDK: які імпорти де розміщені, згруповано за областями'
+ - Аудит підшляхів вбудованих Plugin і допоміжних інтерфейсів
+summary: 'Каталог підшляхів Plugin SDK: які імпорти де розташовані, згруповані за розділами'
title: Підшляхи Plugin SDK
x-i18n:
- generated_at: "2026-04-29T15:39:38Z"
+ generated_at: "2026-04-29T19:09:24Z"
model: gpt-5.5
provider: openai
- source_hash: a2b2cb0880317d4bd3fa7c1803afc119d500b3f8ae3c5d444839c9d4d7633b80
+ source_hash: 60fe10982b9aa01af76bfbd72475168c8138f68dd410b4488b6b6c4c00097e53
source_path: plugins/sdk-subpaths.md
workflow: 16
---
Plugin SDK надається як набір вузьких підшляхів у `openclaw/plugin-sdk/`.
- На цій сторінці наведено поширені підшляхи, згруповані за призначенням. Згенерований
- повний список із 200+ підшляхів міститься в `scripts/lib/plugin-sdk-entrypoints.json`;
- зарезервовані допоміжні підшляхи вбудованих Plugin також є там, але вони є деталями
- реалізації, якщо сторінка документації явно не просуває їх. Мейнтейнери можуть перевіряти активні
+ Ця сторінка каталогізує часто використовувані підшляхи, згруповані за призначенням. Згенерований
+ повний список із понад 200 підшляхів зберігається в `scripts/lib/plugin-sdk-entrypoints.json`;
+ зарезервовані допоміжні підшляхи bundled-plugin також є там, але вони є деталлю
+ реалізації, якщо сторінка документації явно не підносить їх до публічного контракту. Мейнтейнери можуть перевіряти активні
зарезервовані допоміжні підшляхи за допомогою `pnpm plugins:boundary-report:summary`; невикористані
- зарезервовані допоміжні експорти провалюють звіт CI, замість того щоб залишатися в публічному SDK
+ зарезервовані допоміжні експорти провалюють CI-звіт замість того, щоб залишатися в публічному SDK
як неактивний борг сумісності.
- Посібник з авторства Plugin див. в [огляді Plugin SDK](/uk/plugins/sdk-overview).
+ Посібник з авторства плагінів див. у [огляді Plugin SDK](/uk/plugins/sdk-overview).
- ## Точка входу Plugin
+ ## Вхідна точка Plugin
- | Підшлях | Ключові експорти |
+ | Підшлях | Ключові експорти |
| ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `plugin-sdk/plugin-entry` | `definePluginEntry` |
| `plugin-sdk/core` | `defineChannelPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase`, `defineSetupPluginEntry`, `buildChannelConfigSchema` |
| `plugin-sdk/config-schema` | `OpenClawSchema` |
| `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry` |
- | `plugin-sdk/testing` | Широкий barrel сумісності для застарілих тестів Plugin; для нових тестів розширень віддавайте перевагу сфокусованим тестовим підшляхам |
- | `plugin-sdk/plugin-test-api` | Мінімальний mock builder `OpenClawPluginApi` для прямих модульних тестів реєстрації Plugin |
- | `plugin-sdk/agent-runtime-test-contracts` | Фікстури контрактів нативного адаптера середовища виконання агента для профілів автентифікації, придушення доставки, класифікації fallback, хуків інструментів, накладень промптів, схем і відновлення транскрипту |
- | `plugin-sdk/channel-test-helpers` | Допоміжні засоби для тестування життєвого циклу акаунта каналу, каталогу, send-config, runtime mock, хуків, точки входу вбудованого каналу, часової позначки envelope, відповіді pairing і загального контракту каналу |
+ | `plugin-sdk/testing` | Широкий barrel сумісності для застарілих тестів плагінів; для нових тестів розширень віддавайте перевагу сфокусованим тестовим підшляхам |
+ | `plugin-sdk/plugin-test-api` | Мінімальний mock builder `OpenClawPluginApi` для unit-тестів прямої реєстрації плагіна |
+ | `plugin-sdk/agent-runtime-test-contracts` | Фікстури контрактів нативного адаптера agent-runtime для профілів автентифікації, придушення доставки, класифікації fallback, хуків інструментів, накладень промптів, схем і відновлення транскрипта |
+ | `plugin-sdk/channel-test-helpers` | Тестові помічники для життєвого циклу облікового запису каналу, каталогу, send-config, mock runtime, хуків, bundled entry каналу, часової позначки конверта, відповіді pairing і загальних контрактів каналу |
| `plugin-sdk/channel-target-testing` | Спільний набір тестів для випадків помилок розв’язання цілі каналу |
- | `plugin-sdk/plugin-test-contracts` | Допоміжні засоби контрактів для реєстрації Plugin, маніфесту пакета, публічного артефакту, runtime API, побічного ефекту імпорту та прямого імпорту |
- | `plugin-sdk/plugin-test-runtime` | Фікстури середовища виконання Plugin, реєстру, реєстрації провайдера, майстра налаштування та runtime task-flow для тестів |
- | `plugin-sdk/provider-test-contracts` | Допоміжні засоби контрактів для середовища виконання провайдера, автентифікації, виявлення, onboard, каталогу, можливостей медіа, політики replay, realtime STT live-audio, web-search/fetch і майстра |
- | `plugin-sdk/provider-http-test-mocks` | Опційні HTTP/auth моки Vitest для тестів провайдера, які перевіряють `plugin-sdk/provider-http` |
+ | `plugin-sdk/plugin-test-contracts` | Помічники контрактів реєстрації плагіна, package manifest, публічного артефакту, runtime API, побічного ефекту імпорту та прямого імпорту |
+ | `plugin-sdk/plugin-test-runtime` | Фікстури runtime плагіна, registry, provider-registration, setup-wizard і runtime task-flow для тестів |
+ | `plugin-sdk/provider-test-contracts` | Помічники контрактів provider runtime, автентифікації, discovery, onboard, каталогу, медіаможливостей, політики replay, realtime STT live-audio, web-search/fetch і wizard |
+ | `plugin-sdk/provider-http-test-mocks` | Opt-in HTTP/auth mocks Vitest для тестів провайдера, які перевіряють `plugin-sdk/provider-http` |
| `plugin-sdk/test-env` | Фікстури тестового середовища, fetch/network, одноразового HTTP-сервера, вхідного запиту, live-test, тимчасової файлової системи та керування часом |
- | `plugin-sdk/test-fixtures` | Загальні тестові фікстури CLI, sandbox, skill, agent-message, system-event, перезавантаження модуля, шляху вбудованого Plugin, terminal, chunking, auth-token і typed-case |
- | `plugin-sdk/test-node-mocks` | Сфокусовані допоміжні засоби моків вбудованих модулів Node для використання всередині фабрик Vitest `vi.mock("node:*")` |
- | `plugin-sdk/migration` | Допоміжні засоби елементів провайдера міграції, як-от `createMigrationItem`, константи причин, маркери статусу елементів, допоміжні засоби редагування та `summarizeMigrationItems` |
- | `plugin-sdk/migration-runtime` | Допоміжні засоби міграції в середовищі виконання, як-от `copyMigrationFileItem` і `writeMigrationReport` |
+ | `plugin-sdk/test-fixtures` | Узагальнені тестові фікстури CLI, sandbox, skill, agent-message, system-event, перезавантаження модуля, шляху bundled plugin, термінала, chunking, auth-token і typed-case |
+ | `plugin-sdk/test-node-mocks` | Сфокусовані помічники mock для вбудованих модулів Node для використання всередині фабрик Vitest `vi.mock("node:*")` |
+ | `plugin-sdk/migration` | Помічники елементів провайдера міграції, як-от `createMigrationItem`, константи причин, маркери статусу елементів, помічники редагування та `summarizeMigrationItems` |
+ | `plugin-sdk/migration-runtime` | Runtime-помічники міграції, як-от `copyMigrationFileItem`, `withCachedMigrationConfigRuntime` і `writeMigrationReport` |
-
+
| Підшлях | Ключові експорти |
| --- | --- |
| `plugin-sdk/channel-core` | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` |
| `plugin-sdk/config-schema` | Експорт кореневої Zod-схеми `openclaw.json` (`OpenClawSchema`) |
| `plugin-sdk/channel-setup` | `createOptionalChannelSetupSurface`, `createOptionalChannelSetupAdapter`, `createOptionalChannelSetupWizard`, а також `DEFAULT_ACCOUNT_ID`, `createTopLevelChannelDmPolicy`, `setSetupChannelEnabled`, `splitSetupEntries` |
- | `plugin-sdk/setup` | Спільні допоміжні засоби майстра налаштування, промпти allowlist, будівники статусу налаштування |
+ | `plugin-sdk/setup` | Спільні помічники setup wizard, промпти allowlist, builders статусу setup |
| `plugin-sdk/setup-runtime` | `createPatchedAccountSetupAdapter`, `createEnvPatchedAccountSetupAdapter`, `createSetupInputPresenceValidator`, `noteChannelLookupFailure`, `noteChannelLookupSummary`, `promptResolvedAllowFrom`, `splitSetupEntries`, `createAllowlistSetupWizardProxy`, `createDelegatedSetupWizardProxy` |
| `plugin-sdk/setup-adapter-runtime` | `createEnvPatchedAccountSetupAdapter` |
| `plugin-sdk/setup-tools` | `formatCliCommand`, `detectBinary`, `extractArchive`, `resolveBrewExecutable`, `formatDocsLink`, `CONFIG_DIR` |
- | `plugin-sdk/account-core` | Допоміжні засоби config/action-gate для кількох акаунтів, допоміжні засоби fallback для стандартного акаунта |
- | `plugin-sdk/account-id` | `DEFAULT_ACCOUNT_ID`, допоміжні засоби нормалізації account-id |
- | `plugin-sdk/account-resolution` | Допоміжні засоби пошуку акаунта + default-fallback |
- | `plugin-sdk/account-helpers` | Вузькі допоміжні засоби account-list/account-action |
+ | `plugin-sdk/account-core` | Помічники multi-account config/action-gate, помічники fallback для default-account |
+ | `plugin-sdk/account-id` | `DEFAULT_ACCOUNT_ID`, помічники нормалізації account-id |
+ | `plugin-sdk/account-resolution` | Помічники пошуку облікового запису та default-fallback |
+ | `plugin-sdk/account-helpers` | Вузькі помічники account-list/account-action |
| `plugin-sdk/channel-pairing` | `createChannelPairingController` |
| `plugin-sdk/channel-reply-pipeline` | `createChannelReplyPipeline`, `resolveChannelSourceReplyDeliveryMode` |
| `plugin-sdk/channel-config-helpers` | `createHybridChannelConfigAdapter`, `resolveChannelDmAccess`, `resolveChannelDmAllowFrom`, `resolveChannelDmPolicy`, `normalizeChannelDmPolicy`, `normalizeLegacyDmAliases` |
- | `plugin-sdk/channel-config-schema` | Спільні примітиви схеми конфігурації каналу та загальний builder |
- | `plugin-sdk/bundled-channel-config-schema` | Схеми конфігурації вбудованих каналів OpenClaw лише для підтримуваних вбудованих Plugin |
- | `plugin-sdk/channel-config-schema-legacy` | Застарілий alias сумісності для схем конфігурації bundled-channel |
- | `plugin-sdk/telegram-command-config` | Допоміжні засоби нормалізації/валідації користувацьких команд Telegram з fallback на bundled-contract |
- | `plugin-sdk/command-gating` | Вузькі допоміжні засоби шлюзу авторизації команд |
+ | `plugin-sdk/channel-config-schema` | Спільні примітиви схеми конфігурації каналу та узагальнений builder |
+ | `plugin-sdk/bundled-channel-config-schema` | Схеми конфігурації bundled каналів OpenClaw лише для підтримуваних bundled plugins |
+ | `plugin-sdk/channel-config-schema-legacy` | Застарілий псевдонім сумісності для схем конфігурації bundled-channel |
+ | `plugin-sdk/telegram-command-config` | Помічники нормалізації/валідації користувацьких команд Telegram із fallback bundled-contract |
+ | `plugin-sdk/command-gating` | Вузькі помічники gate авторизації команд |
| `plugin-sdk/channel-policy` | `resolveChannelGroupRequireMention` |
- | `plugin-sdk/channel-lifecycle` | `createAccountStatusSink`, `createChannelRunQueue`, допоміжні засоби життєвого циклу/фіналізації draft stream |
- | `plugin-sdk/inbound-envelope` | Спільні допоміжні засоби для вхідного маршруту + envelope builder |
- | `plugin-sdk/inbound-reply-dispatch` | Спільні допоміжні засоби запису та dispatch вхідних даних |
- | `plugin-sdk/messaging-targets` | Допоміжні засоби парсингу/зіставлення цілей |
- | `plugin-sdk/outbound-media` | Спільні допоміжні засоби завантаження вихідних медіа |
- | `plugin-sdk/outbound-send-deps` | Легкий пошук залежностей вихідного надсилання для адаптерів каналів |
- | `plugin-sdk/outbound-runtime` | Допоміжні засоби вихідної доставки, ідентичності, send delegate, session, форматування та планування payload |
- | `plugin-sdk/poll-runtime` | Вузькі допоміжні засоби нормалізації poll |
- | `plugin-sdk/thread-bindings-runtime` | Допоміжні засоби життєвого циклу thread-binding та адаптера |
- | `plugin-sdk/agent-media-payload` | Застарілий builder медіа payload агента |
- | `plugin-sdk/conversation-runtime` | Допоміжні засоби прив’язки conversation/thread, pairing і configured-binding |
- | `plugin-sdk/runtime-config-snapshot` | Допоміжний засіб знімка runtime config |
- | `plugin-sdk/runtime-group-policy` | Допоміжні засоби розв’язання runtime group-policy |
- | `plugin-sdk/channel-status` | Спільні допоміжні засоби знімка/зведення статусу каналу |
+ | `plugin-sdk/channel-lifecycle` | `createAccountStatusSink`, `createChannelRunQueue`, помічники життєвого циклу/фіналізації draft stream |
+ | `plugin-sdk/inbound-envelope` | Спільні помічники inbound route і envelope builder |
+ | `plugin-sdk/inbound-reply-dispatch` | Спільні помічники record-and-dispatch для inbound |
+ | `plugin-sdk/messaging-targets` | Помічники parsing/matching цілей |
+ | `plugin-sdk/outbound-media` | Спільні помічники завантаження outbound media |
+ | `plugin-sdk/outbound-send-deps` | Легкий пошук outbound send залежностей для адаптерів каналів |
+ | `plugin-sdk/outbound-runtime` | Помічники outbound delivery, identity, send delegate, session, formatting і payload planning |
+ | `plugin-sdk/poll-runtime` | Вузькі помічники нормалізації poll |
+ | `plugin-sdk/thread-bindings-runtime` | Помічники життєвого циклу thread-binding і адаптера |
+ | `plugin-sdk/agent-media-payload` | Застарілий builder медіакорисного навантаження агента |
+ | `plugin-sdk/conversation-runtime` | Помічники conversation/thread binding, pairing і configured-binding |
+ | `plugin-sdk/runtime-config-snapshot` | Помічник runtime config snapshot |
+ | `plugin-sdk/runtime-group-policy` | Помічники розв’язання runtime group-policy |
+ | `plugin-sdk/channel-status` | Спільні помічники snapshot/summary статусу каналу |
| `plugin-sdk/channel-config-primitives` | Вузькі примітиви channel config-schema |
- | `plugin-sdk/channel-config-writes` | Допоміжні засоби авторизації channel config-write |
- | `plugin-sdk/channel-plugin-common` | Спільні експорти prelude для Plugin каналу |
- | `plugin-sdk/allowlist-config-edit` | Допоміжні засоби редагування/читання конфігурації allowlist |
- | `plugin-sdk/group-access` | Спільні допоміжні засоби ухвалення рішень group-access |
- | `plugin-sdk/direct-dm` | Спільні допоміжні засоби auth/guard для direct-DM |
- | `plugin-sdk/discord` | Застарілий фасад сумісності Discord для опублікованого `@openclaw/discord@2026.3.13` і відстежуваної сумісності власника; нові Plugin мають використовувати загальні підшляхи channel SDK |
- | `plugin-sdk/telegram-account` | Застарілий фасад сумісності розв’язання акаунта Telegram для відстежуваної сумісності власника; нові Plugin мають використовувати ін’єктовані runtime helpers або загальні підшляхи channel SDK |
- | `plugin-sdk/interactive-runtime` | Семантичне представлення повідомлень, доставка та застарілі допоміжні засоби інтерактивної відповіді. Див. [Представлення повідомлень](/uk/plugins/message-presentation) |
- | `plugin-sdk/channel-inbound` | Barrel сумісності для inbound debounce, зіставлення згадок, допоміжних засобів mention-policy та envelope |
- | `plugin-sdk/channel-inbound-debounce` | Вузькі допоміжні засоби inbound debounce |
- | `plugin-sdk/channel-mention-gating` | Вузькі допоміжні засоби mention-policy, маркера згадки та тексту згадки без ширшої поверхні inbound runtime |
- | `plugin-sdk/channel-envelope` | Вузькі допоміжні засоби форматування inbound envelope |
- | `plugin-sdk/channel-location` | Контекст розташування каналу та допоміжні засоби форматування |
- | `plugin-sdk/channel-logging` | Допоміжні засоби журналювання каналу для inbound drops і помилок typing/ack |
- | `plugin-sdk/channel-send-result` | Типи результатів відповіді |
- | `plugin-sdk/channel-actions` | Допоміжні засоби message-action каналу, а також застарілі допоміжні засоби нативної схеми, збережені для сумісності Plugin |
- | `plugin-sdk/channel-route` | Спільні допоміжні засоби нормалізації маршруту, parser-driven розв’язання цілі, перетворення thread-id на рядок, dedupe/compact ключів маршруту, типів parsed-target і порівняння route/target |
- | `plugin-sdk/channel-targets` | Допоміжні засоби парсингу цілей; виклики порівняння маршрутів мають використовувати `plugin-sdk/channel-route` |
+ | `plugin-sdk/channel-config-writes` | Помічники авторизації channel config-write |
+ | `plugin-sdk/channel-plugin-common` | Спільні prelude-експорти channel plugin |
+ | `plugin-sdk/allowlist-config-edit` | Помічники редагування/читання allowlist config |
+ | `plugin-sdk/group-access` | Спільні помічники рішень group-access |
+ | `plugin-sdk/direct-dm` | Спільні помічники direct-DM auth/guard |
+ | `plugin-sdk/discord` | Застарілий фасад сумісності Discord для опублікованого `@openclaw/discord@2026.3.13` і відстежуваної сумісності власника; нові плагіни мають використовувати узагальнені підшляхи channel SDK |
+ | `plugin-sdk/telegram-account` | Застарілий фасад сумісності Telegram account-resolution для відстежуваної сумісності власника; нові плагіни мають використовувати інжектовані runtime-помічники або узагальнені підшляхи channel SDK |
+ | `plugin-sdk/interactive-runtime` | Семантична презентація повідомлень, доставка та застарілі помічники interactive reply. Див. [Презентація повідомлень](/uk/plugins/message-presentation) |
+ | `plugin-sdk/channel-inbound` | Barrel сумісності для inbound debounce, mention matching, помічників mention-policy і envelope |
+ | `plugin-sdk/channel-inbound-debounce` | Вузькі помічники inbound debounce |
+ | `plugin-sdk/channel-mention-gating` | Вузькі помічники mention-policy, mention marker і mention text без ширшої surface inbound runtime |
+ | `plugin-sdk/channel-envelope` | Вузькі помічники форматування inbound envelope |
+ | `plugin-sdk/channel-location` | Помічники context і formatting для channel location |
+ | `plugin-sdk/channel-logging` | Помічники logging каналу для inbound drops і typing/ack failures |
+ | `plugin-sdk/channel-send-result` | Типи результату reply |
+ | `plugin-sdk/channel-actions` | Помічники message-action каналу, а також застарілі помічники native schema, збережені для сумісності плагінів |
+ | `plugin-sdk/channel-route` | Спільні помічники нормалізації route, parser-driven target resolution, stringification thread-id, dedupe/compact route keys, типів parsed-target і порівняння route/target |
+ | `plugin-sdk/channel-targets` | Помічники parsing цілей; викликачі порівняння route мають використовувати `plugin-sdk/channel-route` |
| `plugin-sdk/channel-contract` | Типи контрактів каналу |
- | `plugin-sdk/channel-feedback` | Підключення feedback/reaction |
- | `plugin-sdk/channel-secret-runtime` | Вузькі допоміжні засоби secret-contract, як-от `collectSimpleChannelFieldAssignments`, `getChannelSurface`, `pushAssignment` і типи secret target |
+ | `plugin-sdk/channel-feedback` | Зв’язування feedback/reaction |
+ | `plugin-sdk/channel-secret-runtime` | Вузькі помічники secret-contract, як-от `collectSimpleChannelFieldAssignments`, `getChannelSurface`, `pushAssignment`, і типи secret target |
-
- | Підшлях | Ключові експорти |
+
+ | Підшлях | Основні експорти |
| --- | --- |
| `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry` |
- | `plugin-sdk/lmstudio` | Підтримуваний фасад провайдера LM Studio для налаштування, виявлення каталогу та підготовки моделей під час виконання |
- | `plugin-sdk/lmstudio-runtime` | Підтримуваний фасад середовища виконання LM Studio для локальних стандартних налаштувань сервера, виявлення моделей, заголовків запитів і допоміжних засобів для завантажених моделей |
- | `plugin-sdk/provider-setup` | Відібрані допоміжні засоби налаштування локальних/самостійно розгорнутих провайдерів |
- | `plugin-sdk/self-hosted-provider-setup` | Спеціалізовані допоміжні засоби налаштування OpenAI-сумісних самостійно розгорнутих провайдерів |
- | `plugin-sdk/cli-backend` | Стандартні налаштування бекенду CLI + константи watchdog |
- | `plugin-sdk/provider-auth-runtime` | Допоміжні засоби визначення API-ключів під час виконання для Plugin провайдерів |
- | `plugin-sdk/provider-auth-api-key` | Допоміжні засоби onboarding/запису профілю API-ключа, як-от `upsertApiKeyProfile` |
- | `plugin-sdk/provider-auth-result` | Стандартний побудовник результату OAuth-автентифікації |
- | `plugin-sdk/provider-auth-login` | Спільні допоміжні засоби інтерактивного входу для Plugin провайдерів |
- | `plugin-sdk/provider-env-vars` | Допоміжні засоби пошуку змінних середовища автентифікації провайдера |
+ | `plugin-sdk/lmstudio` | Підтримуваний фасад постачальника LM Studio для налаштування, виявлення каталогу та підготовки моделей під час виконання |
+ | `plugin-sdk/lmstudio-runtime` | Підтримуваний runtime-фасад LM Studio для локальних стандартних параметрів сервера, виявлення моделей, заголовків запитів і допоміжних засобів для завантажених моделей |
+ | `plugin-sdk/provider-setup` | Відібрані допоміжні засоби налаштування локальних/самостійно розміщених постачальників |
+ | `plugin-sdk/self-hosted-provider-setup` | Спеціалізовані допоміжні засоби налаштування сумісних з OpenAI самостійно розміщених постачальників |
+ | `plugin-sdk/cli-backend` | Стандартні параметри бекенду CLI + константи сторожового контролю |
+ | `plugin-sdk/provider-auth-runtime` | Допоміжні засоби визначення API-ключів під час виконання для plugin постачальників |
+ | `plugin-sdk/provider-auth-api-key` | Допоміжні засоби початкового налаштування API-ключів/запису профілів, як-от `upsertApiKeyProfile` |
+ | `plugin-sdk/provider-auth-result` | Стандартний побудовник результату автентифікації OAuth |
+ | `plugin-sdk/provider-auth-login` | Спільні допоміжні засоби інтерактивного входу для plugin постачальників |
+ | `plugin-sdk/provider-env-vars` | Допоміжні засоби пошуку змінних середовища автентифікації постачальника |
| `plugin-sdk/provider-auth` | `createProviderApiKeyAuthMethod`, `ensureApiKeyFromOptionEnvOrPrompt`, `upsertAuthProfile`, `upsertApiKeyProfile`, `writeOAuthCredentials` |
- | `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні побудовники політики replay, допоміжні засоби endpoint провайдера та допоміжні засоби нормалізації ідентифікаторів моделей, як-от `normalizeNativeXaiModelId` |
- | `plugin-sdk/provider-catalog-runtime` | Runtime hook доповнення каталогу провайдера та seams реєстру plugin-провайдерів для контрактних тестів |
+ | `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні побудовники політик повторного відтворення, допоміжні засоби endpoint постачальника та допоміжні засоби нормалізації model-id, як-от `normalizeNativeXaiModelId` |
+ | `plugin-sdk/provider-catalog-runtime` | Runtime-хук розширення каталогу постачальника та шви реєстру plugin-постачальників для контрактних тестів |
| `plugin-sdk/provider-catalog-shared` | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `buildManifestModelProviderConfig`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` |
- | `plugin-sdk/provider-http` | Загальні допоміжні засоби можливостей HTTP/endpoint провайдера, HTTP-помилки провайдера та допоміжні засоби multipart-форм для аудіотранскрипції |
+ | `plugin-sdk/provider-http` | Універсальні допоміжні засоби можливостей HTTP/endpoint постачальника, HTTP-помилки постачальника та допоміжні засоби multipart-форми для аудіотранскрипції |
| `plugin-sdk/provider-web-fetch-contract` | Вузькі допоміжні засоби контракту конфігурації/вибору web-fetch, як-от `enablePluginInConfig` і `WebFetchProviderPlugin` |
- | `plugin-sdk/provider-web-fetch` | Допоміжні засоби реєстрації/кешування провайдера web-fetch |
- | `plugin-sdk/provider-web-search-config-contract` | Вузькі допоміжні засоби конфігурації/облікових даних web-search для провайдерів, яким не потрібне підключення ввімкнення Plugin |
- | `plugin-sdk/provider-web-search-contract` | Вузькі допоміжні засоби контракту конфігурації/облікових даних web-search, як-от `createWebSearchProviderContractFields`, `enablePluginInConfig`, `resolveProviderWebSearchPluginConfig`, а також обмежені за областю setter/getter облікових даних |
- | `plugin-sdk/provider-web-search` | Допоміжні засоби реєстрації/кешування/runtime провайдера web-search |
- | `plugin-sdk/provider-tools` | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, очищення схеми Gemini + діагностика, а також допоміжні засоби сумісності xAI, як-от `resolveXaiModelCompatPatch` / `applyXaiModelCompat` |
- | `plugin-sdk/provider-usage` | `fetchClaudeUsage` і подібні |
- | `plugin-sdk/provider-stream` | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, типи stream wrapper, а також спільні допоміжні засоби wrapper для Anthropic/Bedrock/DeepSeek V4/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
- | `plugin-sdk/provider-transport-runtime` | Допоміжні засоби нативного транспорту провайдера, як-от захищений fetch, перетворення транспортних повідомлень і writable потоки транспортних подій |
- | `plugin-sdk/provider-onboard` | Допоміжні засоби patch конфігурації onboarding |
- | `plugin-sdk/global-singleton` | Допоміжні засоби process-local singleton/map/cache |
+ | `plugin-sdk/provider-web-fetch` | Допоміжні засоби реєстрації/кешування постачальника web-fetch |
+ | `plugin-sdk/provider-web-search-config-contract` | Вузькі допоміжні засоби конфігурації/облікових даних вебпошуку для постачальників, яким не потрібне підключення ввімкнення plugin |
+ | `plugin-sdk/provider-web-search-contract` | Вузькі допоміжні засоби контракту конфігурації/облікових даних вебпошуку, як-от `createWebSearchProviderContractFields`, `enablePluginInConfig`, `resolveProviderWebSearchPluginConfig`, а також scoped setters/getters облікових даних |
+ | `plugin-sdk/provider-web-search` | Допоміжні засоби реєстрації/кешування/runtime постачальника вебпошуку |
+ | `plugin-sdk/provider-tools` | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, очищення схем Gemini + діагностика, а також допоміжні засоби сумісності xAI, як-от `resolveXaiModelCompatPatch` / `applyXaiModelCompat` |
+ | `plugin-sdk/provider-usage` | `fetchClaudeUsage` та подібні |
+ | `plugin-sdk/provider-stream` | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, типи обгорток потоків і спільні допоміжні засоби обгорток Anthropic/Bedrock/DeepSeek V4/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
+ | `plugin-sdk/provider-transport-runtime` | Допоміжні засоби нативного транспорту постачальника, як-от захищений fetch, перетворення транспортних повідомлень і записувані потоки транспортних подій |
+ | `plugin-sdk/provider-onboard` | Допоміжні засоби патчів конфігурації початкового налаштування |
+ | `plugin-sdk/global-singleton` | Допоміжні засоби singleton/map/cache у межах процесу |
| `plugin-sdk/group-activation` | Вузькі допоміжні засоби режиму активації групи та розбору команд |
- | Підшлях | Ключові експорти |
+ | Підшлях | Основні експорти |
| --- | --- |
- | `plugin-sdk/command-auth` | `resolveControlCommandGate`, допоміжні засоби реєстру команд, зокрема форматування меню динамічних аргументів, допоміжні засоби авторизації відправника |
+ | `plugin-sdk/command-auth` | `resolveControlCommandGate`, допоміжні засоби реєстру команд, зокрема форматування меню динамічних аргументів, допоміжні засоби авторизації відправників |
| `plugin-sdk/command-status` | Побудовники повідомлень команд/довідки, як-от `buildCommandsMessagePaginated` і `buildHelpMessage` |
| `plugin-sdk/approval-auth-runtime` | Допоміжні засоби визначення затверджувача та автентифікації дій у тому самому чаті |
- | `plugin-sdk/approval-client-runtime` | Допоміжні засоби профілю/фільтра затвердження нативного exec |
- | `plugin-sdk/approval-delivery-runtime` | Адаптери нативної можливості/доставки затверджень |
- | `plugin-sdk/approval-gateway-runtime` | Спільний допоміжний засіб визначення approval gateway |
- | `plugin-sdk/approval-handler-adapter-runtime` | Легкі допоміжні засоби завантаження нативного адаптера затверджень для гарячих entrypoint каналів |
- | `plugin-sdk/approval-handler-runtime` | Ширші допоміжні засоби runtime обробника затверджень; надавайте перевагу вужчим seams adapter/gateway, коли їх достатньо |
+ | `plugin-sdk/approval-client-runtime` | Допоміжні засоби профілю/фільтрів нативного затвердження exec |
+ | `plugin-sdk/approval-delivery-runtime` | Нативні адаптери можливостей/доставки затверджень |
+ | `plugin-sdk/approval-gateway-runtime` | Спільний допоміжний засіб визначення Gateway для затверджень |
+ | `plugin-sdk/approval-handler-adapter-runtime` | Легковагові допоміжні засоби завантаження нативного адаптера затверджень для гарячих entrypoint каналів |
+ | `plugin-sdk/approval-handler-runtime` | Ширші допоміжні засоби runtime обробника затверджень; віддавайте перевагу вужчим швам адаптера/Gateway, коли їх достатньо |
| `plugin-sdk/approval-native-runtime` | Допоміжні засоби нативної цілі затвердження + прив’язки облікового запису |
| `plugin-sdk/approval-reply-runtime` | Допоміжні засоби payload відповіді на затвердження exec/plugin |
- | `plugin-sdk/approval-runtime` | Допоміжні засоби payload затвердження exec/plugin, допоміжні засоби маршрутизації/runtime нативного затвердження та допоміжні засоби структурованого відображення затверджень, як-от `formatApprovalDisplayPath` |
- | `plugin-sdk/reply-dedupe` | Вузькі допоміжні засоби скидання dedupe вхідних відповідей |
+ | `plugin-sdk/approval-runtime` | Допоміжні засоби payload затвердження exec/plugin, нативні допоміжні засоби маршрутизації/runtime затверджень і допоміжні засоби структурованого відображення затверджень, як-от `formatApprovalDisplayPath` |
+ | `plugin-sdk/reply-dedupe` | Вузькі допоміжні засоби скидання дедуплікації вхідних відповідей |
| `plugin-sdk/channel-contract-testing` | Вузькі допоміжні засоби контрактного тестування каналів без широкого testing barrel |
| `plugin-sdk/command-auth-native` | Нативна автентифікація команд, форматування меню динамічних аргументів і допоміжні засоби нативної цілі сеансу |
| `plugin-sdk/command-detection` | Спільні допоміжні засоби виявлення команд |
- | `plugin-sdk/command-primitives-runtime` | Легкі предикати тексту команд для гарячих шляхів каналів |
+ | `plugin-sdk/command-primitives-runtime` | Легковагові предикати тексту команд для гарячих шляхів каналів |
| `plugin-sdk/command-surface` | Допоміжні засоби нормалізації тіла команди та command-surface |
| `plugin-sdk/allow-from` | `formatAllowFromLowercase` |
- | `plugin-sdk/channel-secret-runtime` | Вузькі допоміжні засоби збирання secret-contract для поверхонь секретів каналу/Plugin |
+ | `plugin-sdk/channel-secret-runtime` | Вузькі допоміжні засоби збирання secret-contract для поверхонь секретів каналів/plugin |
| `plugin-sdk/secret-ref-runtime` | Вузькі допоміжні засоби `coerceSecretRef` і типізації SecretRef для розбору secret-contract/config |
- | `plugin-sdk/security-runtime` | Спільні допоміжні засоби довіри, gating DM, зовнішнього вмісту, редагування чутливого тексту, порівняння секретів за сталий час і збирання секретів |
+ | `plugin-sdk/security-runtime` | Спільні допоміжні засоби довіри, обмеження DM, зовнішнього вмісту, редагування чутливого тексту, порівняння секретів за сталий час і збирання секретів |
| `plugin-sdk/ssrf-policy` | Допоміжні засоби allowlist хостів і політики SSRF для приватних мереж |
- | `plugin-sdk/ssrf-dispatcher` | Вузькі допоміжні засоби pinned-dispatcher без широкої інфраструктурної runtime-поверхні |
- | `plugin-sdk/ssrf-runtime` | Pinned-dispatcher, захищений SSRF fetch, помилка SSRF і допоміжні засоби політики SSRF |
+ | `plugin-sdk/ssrf-dispatcher` | Вузькі допоміжні засоби pinned-dispatcher без широкої runtime-поверхні інфраструктури |
+ | `plugin-sdk/ssrf-runtime` | Допоміжні засоби pinned-dispatcher, захищеного від SSRF fetch, помилки SSRF і політики SSRF |
| `plugin-sdk/secret-input` | Допоміжні засоби розбору введення секретів |
- | `plugin-sdk/webhook-ingress` | Допоміжні засоби Webhook-запитів/цілей і приведення raw websocket/body |
- | `plugin-sdk/webhook-request-guards` | Допоміжні засоби розміру тіла запиту/таймауту |
+ | `plugin-sdk/webhook-ingress` | Допоміжні засоби запитів/цілей Webhook і приведення сирого websocket/body |
+ | `plugin-sdk/webhook-request-guards` | Допоміжні засоби розміру тіла запиту/тайм-ауту |
| Підшлях | Ключові експорти |
| --- | --- |
- | `plugin-sdk/runtime` | Широкі допоміжні засоби для середовища виконання/логування/резервного копіювання/встановлення Plugin |
- | `plugin-sdk/runtime-env` | Вузькі допоміжні засоби для середовища виконання, середовища, логера, тайм-ауту, повторних спроб і backoff |
- | `plugin-sdk/browser-config` | Підтримуваний фасад конфігурації браузера для нормалізованого профілю/значень за замовчуванням, розбору CDP URL і допоміжних засобів автентифікації керування браузером |
- | `plugin-sdk/channel-runtime-context` | Допоміжні засоби для реєстрації та пошуку загального runtime-context каналу |
+ | `plugin-sdk/runtime` | Широкі помічники середовища виконання, журналювання, резервного копіювання та встановлення plugin |
+ | `plugin-sdk/runtime-env` | Вузькі помічники env середовища виконання, logger, timeout, retry та backoff |
+ | `plugin-sdk/browser-config` | Підтримуваний фасад конфігурації браузера для нормалізованого профілю/типових значень, розбору URL CDP та помічників автентифікації керування браузером |
+ | `plugin-sdk/channel-runtime-context` | Загальні помічники реєстрації та пошуку runtime-context каналу |
| `plugin-sdk/runtime-store` | `createPluginRuntimeStore` |
- | `plugin-sdk/plugin-runtime` | Спільні допоміжні засоби для команд/хуків/http/інтерактивності Plugin |
- | `plugin-sdk/hook-runtime` | Спільні допоміжні засоби конвеєра webhook/внутрішніх хуків |
- | `plugin-sdk/lazy-runtime` | Допоміжні засоби лінивого імпорту/прив’язування середовища виконання, як-от `createLazyRuntimeModule`, `createLazyRuntimeMethod` і `createLazyRuntimeSurface` |
- | `plugin-sdk/process-runtime` | Допоміжні засоби виконання процесів |
- | `plugin-sdk/cli-runtime` | Допоміжні засоби форматування CLI, очікування, версії, виклику аргументів і лінивих груп команд |
- | `plugin-sdk/gateway-runtime` | Клієнт Gateway, допоміжний засіб запуску клієнта з готовим циклом подій, Gateway CLI RPC, помилки протоколу Gateway і допоміжні засоби патчів статусу каналу |
- | `plugin-sdk/config-types` | Поверхня конфігурації лише для типів для форм конфігурації Plugin, як-от `OpenClawConfig`, і типів конфігурації каналів/провайдерів |
- | `plugin-sdk/plugin-config-runtime` | Допоміжні засоби пошуку runtime plugin-config, як-от `requireRuntimeConfig`, `resolvePluginConfigObject` і `resolveLivePluginConfigObject` |
- | `plugin-sdk/config-mutation` | Допоміжні засоби транзакційної зміни конфігурації, як-от `mutateConfigFile`, `replaceConfigFile` і `logConfigUpdated` |
- | `plugin-sdk/runtime-config-snapshot` | Допоміжні засоби знімка конфігурації поточного процесу, як-от `getRuntimeConfig`, `getRuntimeConfigSnapshot`, і сетери тестових знімків |
- | `plugin-sdk/telegram-command-config` | Нормалізація назв/описів команд Telegram і перевірки дублікатів/конфліктів, навіть коли поверхня контракту вбудованого Telegram недоступна |
- | `plugin-sdk/text-autolink-runtime` | Виявлення автопосилань на файлові посилання без широкого barrel text-runtime |
- | `plugin-sdk/approval-runtime` | Допоміжні засоби схвалення exec/Plugin, конструктори можливостей схвалення, допоміжні засоби auth/profile, допоміжні засоби native routing/runtime і форматування структурованого шляху відображення схвалення |
- | `plugin-sdk/reply-runtime` | Спільні допоміжні засоби середовища виконання вхідних повідомлень/відповідей, поділ на фрагменти, dispatch, Heartbeat, планувальник відповідей |
- | `plugin-sdk/reply-dispatch-runtime` | Вузькі допоміжні засоби dispatch/finalize відповіді та міток розмов |
- | `plugin-sdk/reply-history` | Спільні допоміжні засоби історії відповідей короткого вікна та маркери, як-от `buildHistoryContext`, `HISTORY_CONTEXT_MARKER`, `recordPendingHistoryEntry` і `clearHistoryEntriesIfEnabled` |
+ | `plugin-sdk/plugin-runtime` | Спільні помічники команд, хуків, http та інтерактивних можливостей plugin |
+ | `plugin-sdk/hook-runtime` | Спільні помічники конвеєра webhook/внутрішніх хуків |
+ | `plugin-sdk/lazy-runtime` | Помічники лінивого імпорту/прив’язування середовища виконання, як-от `createLazyRuntimeModule`, `createLazyRuntimeMethod` і `createLazyRuntimeSurface` |
+ | `plugin-sdk/process-runtime` | Помічники виконання процесів |
+ | `plugin-sdk/cli-runtime` | Помічники форматування CLI, очікування, версії, виклику з аргументами та лінивих груп команд |
+ | `plugin-sdk/gateway-runtime` | Клієнт Gateway, помічник запуску клієнта після готовності циклу подій, CLI RPC Gateway, помилки протоколу Gateway та помічники виправлень статусу каналу |
+ | `plugin-sdk/config-types` | Поверхня конфігурації лише для типів для форм конфігурації plugin, як-от `OpenClawConfig`, і типів конфігурації каналів/провайдерів |
+ | `plugin-sdk/plugin-config-runtime` | Помічники пошуку plugin-config у середовищі виконання, як-от `requireRuntimeConfig`, `resolvePluginConfigObject` і `resolveLivePluginConfigObject` |
+ | `plugin-sdk/config-mutation` | Помічники транзакційної зміни конфігурації, як-от `mutateConfigFile`, `replaceConfigFile` і `logConfigUpdated` |
+ | `plugin-sdk/runtime-config-snapshot` | Помічники знімка конфігурації поточного процесу, як-от `getRuntimeConfig`, `getRuntimeConfigSnapshot`, і сетери тестових знімків |
+ | `plugin-sdk/telegram-command-config` | Нормалізація назв/описів команд Telegram і перевірки дублікатів/конфліктів, навіть коли вбудована контрактна поверхня Telegram недоступна |
+ | `plugin-sdk/text-autolink-runtime` | Виявлення автопосилань на посилання файлів без широкого barrel text-runtime |
+ | `plugin-sdk/approval-runtime` | Помічники схвалення exec/plugin, побудовники можливостей схвалення, помічники auth/profile, помічники native routing/runtime і форматування шляхів структурованого відображення схвалень |
+ | `plugin-sdk/reply-runtime` | Спільні помічники середовища виконання inbound/reply, поділу на фрагменти, dispatch, Heartbeat, планувальник відповідей |
+ | `plugin-sdk/reply-dispatch-runtime` | Вузькі помічники dispatch/finalize відповідей і міток розмов |
+ | `plugin-sdk/reply-history` | Спільні помічники історії відповідей короткого вікна та маркери, як-от `buildHistoryContext`, `HISTORY_CONTEXT_MARKER`, `recordPendingHistoryEntry` і `clearHistoryEntriesIfEnabled` |
| `plugin-sdk/reply-reference` | `createReplyReferencePlanner` |
- | `plugin-sdk/reply-chunking` | Вузькі допоміжні засоби поділу тексту/Markdown на фрагменти |
- | `plugin-sdk/session-store-runtime` | Допоміжні засоби шляху сховища сесій, ключа сесії, updated-at і зміни сховища |
- | `plugin-sdk/cron-store-runtime` | Допоміжні засоби шляху/завантаження/збереження сховища Cron |
- | `plugin-sdk/state-paths` | Допоміжні засоби шляхів до директорій стану/OAuth |
- | `plugin-sdk/routing` | Допоміжні засоби маршруту/ключа сесії/прив’язки облікового запису, як-от `resolveAgentRoute`, `buildAgentSessionKey` і `resolveDefaultAgentBoundAccountId` |
- | `plugin-sdk/status-helpers` | Спільні допоміжні засоби зведення статусу каналу/облікового запису, значення за замовчуванням runtime-state і допоміжні засоби метаданих проблем |
- | `plugin-sdk/target-resolver-runtime` | Спільні допоміжні засоби resolver цілі |
- | `plugin-sdk/string-normalization-runtime` | Допоміжні засоби нормалізації slug/рядків |
- | `plugin-sdk/request-url` | Видобування рядкових URL з вхідних даних, подібних до fetch/request |
+ | `plugin-sdk/reply-chunking` | Вузькі помічники поділу text/markdown на фрагменти |
+ | `plugin-sdk/session-store-runtime` | Помічники шляху сховища сесій, session-key, updated-at і зміни сховища |
+ | `plugin-sdk/cron-store-runtime` | Помічники шляху/завантаження/збереження сховища Cron |
+ | `plugin-sdk/state-paths` | Помічники шляхів каталогів стану/OAuth |
+ | `plugin-sdk/routing` | Помічники маршруту/session-key/прив’язування акаунта, як-от `resolveAgentRoute`, `buildAgentSessionKey` і `resolveDefaultAgentBoundAccountId` |
+ | `plugin-sdk/status-helpers` | Спільні помічники підсумку статусу каналу/акаунта, типові значення runtime-state і помічники метаданих проблем |
+ | `plugin-sdk/target-resolver-runtime` | Спільні помічники resolver цілей |
+ | `plugin-sdk/string-normalization-runtime` | Помічники нормалізації slug/рядків |
+ | `plugin-sdk/request-url` | Витягування рядкових URL із fetch/request-подібних входів |
| `plugin-sdk/run-command` | Виконавець команд із таймером і нормалізованими результатами stdout/stderr |
- | `plugin-sdk/param-readers` | Спільні читачі параметрів інструментів/CLI |
- | `plugin-sdk/tool-payload` | Видобування нормалізованих payload з об’єктів результатів інструментів |
- | `plugin-sdk/tool-send` | Видобування канонічних полів цілі надсилання з аргументів інструменту |
- | `plugin-sdk/temp-path` | Спільні допоміжні засоби шляхів тимчасового завантаження |
- | `plugin-sdk/logging-core` | Логер підсистеми та допоміжні засоби редагування |
- | `plugin-sdk/markdown-table-runtime` | Допоміжні засоби режиму таблиць Markdown і перетворення |
- | `plugin-sdk/model-session-runtime` | Допоміжні засоби перевизначення моделі/сесії, як-от `applyModelOverrideToSessionEntry` і `resolveAgentMaxConcurrent` |
- | `plugin-sdk/talk-config-runtime` | Допоміжні засоби розв’язання конфігурації провайдера Talk |
- | `plugin-sdk/json-store` | Невеликі допоміжні засоби читання/запису стану JSON |
- | `plugin-sdk/file-lock` | Допоміжні засоби повторно вхідного file-lock |
- | `plugin-sdk/persistent-dedupe` | Допоміжні засоби кешу дедуплікації на диску |
- | `plugin-sdk/acp-runtime` | Допоміжні засоби середовища виконання/сесії ACP і reply-dispatch |
- | `plugin-sdk/acp-runtime-backend` | Легковагові допоміжні засоби реєстрації бекенду ACP і reply-dispatch для Plugin, завантажених під час запуску |
- | `plugin-sdk/acp-binding-resolve-runtime` | Розв’язання прив’язки ACP лише для читання без імпортів запуску життєвого циклу |
+ | `plugin-sdk/param-readers` | Спільні читачі параметрів tool/CLI |
+ | `plugin-sdk/tool-payload` | Витягування нормалізованих payload із об’єктів результату tool |
+ | `plugin-sdk/tool-send` | Витягування канонічних полів цілі надсилання з args tool |
+ | `plugin-sdk/temp-path` | Спільні помічники шляху тимчасового завантаження |
+ | `plugin-sdk/logging-core` | Помічники logger підсистеми та редагування чутливих даних |
+ | `plugin-sdk/markdown-table-runtime` | Помічники режиму та перетворення таблиць Markdown |
+ | `plugin-sdk/model-session-runtime` | Помічники перевизначення моделі/сесії, як-от `applyModelOverrideToSessionEntry` і `resolveAgentMaxConcurrent` |
+ | `plugin-sdk/talk-config-runtime` | Помічники розв’язання конфігурації провайдера Talk |
+ | `plugin-sdk/json-store` | Невеликі помічники читання/запису стану JSON |
+ | `plugin-sdk/file-lock` | Помічники реентерабельного file-lock |
+ | `plugin-sdk/persistent-dedupe` | Помічники дискового dedupe cache |
+ | `plugin-sdk/acp-runtime` | Помічники середовища виконання/сесії ACP і reply-dispatch |
+ | `plugin-sdk/acp-runtime-backend` | Легковажні помічники реєстрації backend ACP і reply-dispatch для plugins, завантажених під час запуску |
+ | `plugin-sdk/acp-binding-resolve-runtime` | Розв’язання прив’язування ACP лише для читання без імпортів запуску lifecycle |
| `plugin-sdk/agent-config-primitives` | Вузькі примітиви config-schema середовища виконання агента |
- | `plugin-sdk/boolean-param` | Нестрогий читач булевих параметрів |
- | `plugin-sdk/dangerous-name-runtime` | Допоміжні засоби розв’язання збігів небезпечних назв |
- | `plugin-sdk/device-bootstrap` | Допоміжні засоби bootstrap пристрою та токенів сполучення |
- | `plugin-sdk/extension-shared` | Спільні примітиви допоміжних засобів пасивного каналу, статусу та ambient proxy |
- | `plugin-sdk/models-provider-runtime` | Допоміжні засоби відповіді команди/провайдера `/models` |
- | `plugin-sdk/skill-commands-runtime` | Допоміжні засоби переліку команд Skills |
- | `plugin-sdk/native-command-registry` | Допоміжні засоби реєстру/побудови/серіалізації native команд |
- | `plugin-sdk/agent-harness` | Експериментальна поверхня trusted-plugin для низькорівневих harness агентів: типи harness, допоміжні засоби керування/переривання active-run, допоміжні засоби bridge інструментів OpenClaw, допоміжні засоби політики інструментів runtime-plan, класифікація результатів термінала, допоміжні засоби форматування/деталізації прогресу інструментів і утиліти результатів спроб |
- | `plugin-sdk/provider-zai-endpoint` | Допоміжні засоби виявлення endpoint Z.AI |
- | `plugin-sdk/async-lock-runtime` | Допоміжний засіб process-local async lock для невеликих файлів стану середовища виконання |
- | `plugin-sdk/channel-activity-runtime` | Допоміжний засіб телеметрії активності каналу |
- | `plugin-sdk/concurrency-runtime` | Допоміжний засіб обмеженої конкурентності асинхронних завдань |
- | `plugin-sdk/dedupe-runtime` | Допоміжні засоби кешу дедуплікації в пам’яті |
- | `plugin-sdk/delivery-queue-runtime` | Допоміжний засіб drain вихідної черги очікуваної доставки |
- | `plugin-sdk/file-access-runtime` | Допоміжні засоби безпечних шляхів локальних файлів і джерел медіа |
- | `plugin-sdk/heartbeat-runtime` | Допоміжні засоби подій і видимості Heartbeat |
- | `plugin-sdk/number-runtime` | Допоміжний засіб приведення чисел |
- | `plugin-sdk/secure-random-runtime` | Допоміжні засоби безпечних токенів/UUID |
- | `plugin-sdk/system-event-runtime` | Допоміжні засоби черги системних подій |
- | `plugin-sdk/transport-ready-runtime` | Допоміжний засіб очікування готовності транспорту |
- | `plugin-sdk/infra-runtime` | Застарілий compatibility shim; використовуйте наведені вище сфокусовані підшляхи середовища виконання |
- | `plugin-sdk/collection-runtime` | Невеликі допоміжні засоби обмеженого кешу |
- | `plugin-sdk/diagnostic-runtime` | Допоміжні засоби діагностичного прапорця, події та trace-context |
- | `plugin-sdk/error-runtime` | Граф помилок, форматування, спільні допоміжні засоби класифікації помилок, `isApprovalNotFoundError` |
- | `plugin-sdk/fetch-runtime` | Обгорнутий fetch, proxy, опція EnvHttpProxyAgent і допоміжні засоби pinned lookup |
- | `plugin-sdk/runtime-fetch` | Dispatcher-aware runtime fetch без імпортів proxy/guarded-fetch |
- | `plugin-sdk/response-limit-runtime` | Обмежений читач response-body без широкої media runtime surface |
- | `plugin-sdk/session-binding-runtime` | Поточний стан прив’язки розмови без налаштованої маршрутизації прив’язки або сховищ сполучення |
- | `plugin-sdk/session-store-runtime` | Допоміжні засоби session-store без широких імпортів запису/обслуговування конфігурації |
+ | `plugin-sdk/boolean-param` | Нестрогий читач булевого параметра |
+ | `plugin-sdk/dangerous-name-runtime` | Помічники розв’язання збігів небезпечних назв |
+ | `plugin-sdk/device-bootstrap` | Помічники початкового налаштування пристрою та токенів парування |
+ | `plugin-sdk/extension-shared` | Спільні примітиви пасивного каналу, статусу та помічника ambient proxy |
+ | `plugin-sdk/models-provider-runtime` | Помічники відповіді команди/провайдера `/models` |
+ | `plugin-sdk/skill-commands-runtime` | Помічники переліку команд Skills |
+ | `plugin-sdk/native-command-registry` | Помічники registry/build/serialize нативних команд |
+ | `plugin-sdk/agent-harness` | Експериментальна поверхня trusted-plugin для низькорівневих harness агентів: типи harness, помічники steer/abort для active-run, помічники bridge tool OpenClaw, помічники політики tool runtime-plan, класифікація результатів термінала, помічники форматування/деталізації прогресу tool і утиліти результатів спроб |
+ | `plugin-sdk/provider-zai-endpoint` | Помічники виявлення endpoint Z.AI |
+ | `plugin-sdk/async-lock-runtime` | Помічник локального для процесу async lock для невеликих файлів стану середовища виконання |
+ | `plugin-sdk/channel-activity-runtime` | Помічник телеметрії активності каналу |
+ | `plugin-sdk/concurrency-runtime` | Помічник обмеженої конкурентності async tasks |
+ | `plugin-sdk/dedupe-runtime` | Помічники in-memory dedupe cache |
+ | `plugin-sdk/delivery-queue-runtime` | Помічник drain вихідних pending-delivery |
+ | `plugin-sdk/file-access-runtime` | Помічники безпечних шляхів локальних файлів і джерел медіа |
+ | `plugin-sdk/heartbeat-runtime` | Помічники подій і видимості Heartbeat |
+ | `plugin-sdk/number-runtime` | Помічник числового приведення |
+ | `plugin-sdk/secure-random-runtime` | Помічники безпечних токенів/UUID |
+ | `plugin-sdk/system-event-runtime` | Помічники черги системних подій |
+ | `plugin-sdk/transport-ready-runtime` | Помічник очікування готовності транспорту |
+ | `plugin-sdk/infra-runtime` | Застарілий shim сумісності; використовуйте сфокусовані підшляхи середовища виконання вище |
+ | `plugin-sdk/collection-runtime` | Невеликі помічники bounded cache |
+ | `plugin-sdk/diagnostic-runtime` | Помічники діагностичних прапорців, подій і trace-context |
+ | `plugin-sdk/error-runtime` | Граф помилок, форматування, спільні помічники класифікації помилок, `isApprovalNotFoundError` |
+ | `plugin-sdk/fetch-runtime` | Обгорнутий fetch, proxy, опція EnvHttpProxyAgent і помічники pinned lookup |
+ | `plugin-sdk/runtime-fetch` | Dispatcher-aware fetch середовища виконання без імпортів proxy/guarded-fetch |
+ | `plugin-sdk/response-limit-runtime` | Читач обмеженого response-body без широкої поверхні media runtime |
+ | `plugin-sdk/session-binding-runtime` | Поточний стан прив’язування розмови без налаштованої маршрутизації прив’язувань або сховищ парування |
+ | `plugin-sdk/session-store-runtime` | Помічники session-store без широких імпортів запису/обслуговування конфігурації |
| `plugin-sdk/context-visibility-runtime` | Розв’язання видимості контексту та фільтрація додаткового контексту без широких імпортів конфігурації/безпеки |
- | `plugin-sdk/string-coerce-runtime` | Вузькі допоміжні засоби приведення та нормалізації примітивного record/рядка без імпортів markdown/logging |
- | `plugin-sdk/host-runtime` | Допоміжні засоби нормалізації hostname і SCP host |
- | `plugin-sdk/retry-runtime` | Допоміжні засоби конфігурації повторних спроб і виконавця повторних спроб |
- | `plugin-sdk/agent-runtime` | Допоміжні засоби директорії/ідентичності/робочого простору агента |
- | `plugin-sdk/directory-runtime` | Запит/дедуплікація директорій на основі конфігурації |
+ | `plugin-sdk/string-coerce-runtime` | Вузькі помічники приведення та нормалізації primitive record/string без імпортів markdown/logging |
+ | `plugin-sdk/host-runtime` | Помічники нормалізації hostname і SCP host |
+ | `plugin-sdk/retry-runtime` | Помічники конфігурації retry і виконавця retry |
+ | `plugin-sdk/agent-runtime` | Помічники каталогу/ідентичності/workspace агента |
+ | `plugin-sdk/directory-runtime` | Запит/дедуплікація directory на основі конфігурації |
| `plugin-sdk/keyed-async-queue` | `KeyedAsyncQueue` |
-
+
| Підшлях | Ключові експорти |
| --- | --- |
- | `plugin-sdk/media-runtime` | Спільні помічники для отримання/перетворення/збереження медіа, визначення розмірів відео на основі ffprobe та побудовники медіа-навантажень |
- | `plugin-sdk/media-store` | Вузькі помічники медіасховища, такі як `saveMediaBuffer` |
- | `plugin-sdk/media-generation-runtime` | Спільні помічники резервного перемикання для генерації медіа, вибір кандидатів і повідомлення про відсутні моделі |
- | `plugin-sdk/media-understanding` | Типи провайдерів розуміння медіа, а також експорти помічників для зображень/аудіо, орієнтовані на провайдерів |
- | `plugin-sdk/text-runtime` | Спільні помічники для тексту/markdown/логування, такі як вилучення видимого для асистента тексту, помічники рендерингу/розбиття/таблиць markdown, помічники редагування, помічники тегів директив і утиліти безпечного тексту |
- | `plugin-sdk/text-chunking` | Помічник розбиття вихідного тексту |
- | `plugin-sdk/speech` | Типи мовленнєвих провайдерів, а також орієнтовані на провайдерів експорти директив, реєстру, валідації, побудовника TTS, сумісного з OpenAI, і мовленнєвих помічників |
- | `plugin-sdk/speech-core` | Спільні типи мовленнєвих провайдерів, реєстр, директива, нормалізація та експорти мовленнєвих помічників |
- | `plugin-sdk/realtime-transcription` | Типи провайдерів транскрипції в реальному часі, помічники реєстру та спільний помічник сесії WebSocket |
- | `plugin-sdk/realtime-voice` | Типи провайдерів голосу в реальному часі та помічники реєстру |
- | `plugin-sdk/image-generation` | Типи провайдерів генерації зображень, а також помічники для ресурсів зображень/data URL і побудовник провайдера зображень, сумісний з OpenAI |
- | `plugin-sdk/image-generation-core` | Спільні типи генерації зображень, резервне перемикання, автентифікація та помічники реєстру |
+ | `plugin-sdk/media-runtime` | Спільні допоміжні засоби для отримання/перетворення/зберігання медіа, визначення розмірів відео на основі ffprobe та побудовники медіа-навантажень |
+ | `plugin-sdk/media-store` | Вузькі допоміжні засоби сховища медіа, як-от `saveMediaBuffer` |
+ | `plugin-sdk/media-generation-runtime` | Спільні допоміжні засоби резервного перемикання для генерації медіа, вибір кандидатів і повідомлення про відсутню модель |
+ | `plugin-sdk/media-understanding` | Типи провайдерів розуміння медіа, а також експорти допоміжних засобів для зображень/аудіо, призначені для провайдерів |
+ | `plugin-sdk/text-runtime` | Спільні допоміжні засоби для тексту/markdown/логування, як-от видалення видимого для асистента тексту, допоміжні засоби рендерингу/нарізання на фрагменти/таблиць markdown, допоміжні засоби редагування, директивних тегів і безпечного тексту |
+ | `plugin-sdk/text-chunking` | Допоміжний засіб нарізання вихідного тексту на фрагменти |
+ | `plugin-sdk/speech` | Типи мовленнєвих провайдерів, а також експорти директив, реєстру, валідації, OpenAI-сумісного побудовника TTS і допоміжних мовленнєвих засобів, призначені для провайдерів |
+ | `plugin-sdk/speech-core` | Спільні типи мовленнєвих провайдерів, реєстр, директива, нормалізація та експорти допоміжних мовленнєвих засобів |
+ | `plugin-sdk/realtime-transcription` | Типи провайдерів транскрипції в реальному часі, допоміжні засоби реєстру та спільний допоміжний засіб сеансу WebSocket |
+ | `plugin-sdk/realtime-voice` | Типи провайдерів голосу в реальному часі та допоміжні засоби реєстру |
+ | `plugin-sdk/image-generation` | Типи провайдерів генерації зображень, а також допоміжні засоби URL-адрес ресурсів/даних зображень і OpenAI-сумісний побудовник провайдера зображень |
+ | `plugin-sdk/image-generation-core` | Спільні типи генерації зображень, резервне перемикання, автентифікація та допоміжні засоби реєстру |
| `plugin-sdk/music-generation` | Типи провайдера/запиту/результату генерації музики |
- | `plugin-sdk/music-generation-core` | Спільні типи генерації музики, помічники резервного перемикання, пошук провайдера та розбір model-ref |
+ | `plugin-sdk/music-generation-core` | Спільні типи генерації музики, допоміжні засоби резервного перемикання, пошук провайдера та розбір посилань на моделі |
| `plugin-sdk/video-generation` | Типи провайдера/запиту/результату генерації відео |
- | `plugin-sdk/video-generation-core` | Спільні типи генерації відео, помічники резервного перемикання, пошук провайдера та розбір model-ref |
- | `plugin-sdk/webhook-targets` | Реєстр цілей Webhook і помічники встановлення маршрутів |
- | `plugin-sdk/webhook-path` | Помічники нормалізації шляху Webhook |
- | `plugin-sdk/web-media` | Спільні помічники завантаження віддалених/локальних медіа |
- | `plugin-sdk/zod` | Повторно експортований `zod` для споживачів plugin SDK |
- | `plugin-sdk/testing` | Широкий barrel сумісності для застарілих тестів plugin. Нові тести розширень натомість мають імпортувати сфокусовані підшляхи SDK, такі як `plugin-sdk/agent-runtime-test-contracts`, `plugin-sdk/plugin-test-runtime`, `plugin-sdk/channel-test-helpers`, `plugin-sdk/test-env` або `plugin-sdk/test-fixtures` |
- | `plugin-sdk/plugin-test-api` | Мінімальний помічник `createTestPluginApi` для модульних тестів прямої реєстрації plugin без імпорту мостів тестових помічників репозиторію |
- | `plugin-sdk/agent-runtime-test-contracts` | Нативні фікстури контрактів адаптера agent-runtime для тестів автентифікації, доставки, резервного режиму, tool-hook, prompt-overlay, схеми та проєкції транскрипту |
- | `plugin-sdk/channel-test-helpers` | Орієнтовані на канали тестові помічники для загальних контрактів дій/налаштування/статусу, перевірок каталогів, життєвого циклу запуску облікового запису, потоків send-config, runtime-моків, проблем статусу, вихідної доставки та реєстрації hook |
- | `plugin-sdk/channel-target-testing` | Спільний набір тестів для випадків помилок визначення цілі в тестах каналів |
- | `plugin-sdk/plugin-test-contracts` | Помічники контрактів для пакета plugin, реєстрації, публічного артефакту, прямого імпорту, runtime API та побічних ефектів імпорту |
- | `plugin-sdk/provider-test-contracts` | Помічники контрактів для runtime провайдера, автентифікації, виявлення, onboard, каталогу, майстра, медіа-можливостей, політики replay, realtime STT live-audio, web-search/fetch і stream |
- | `plugin-sdk/provider-http-test-mocks` | Опційні HTTP/auth-моки Vitest для тестів провайдерів, що перевіряють `plugin-sdk/provider-http` |
- | `plugin-sdk/test-fixtures` | Загальні фікстури для захоплення runtime CLI, sandbox-контексту, skill writer, agent-message, system-event, перезавантаження модуля, шляху bundled plugin, terminal-text, chunking, auth-token і typed-case |
- | `plugin-sdk/test-node-mocks` | Сфокусовані помічники моків вбудованих модулів Node для використання всередині фабрик Vitest `vi.mock("node:*")` |
+ | `plugin-sdk/video-generation-core` | Спільні типи генерації відео, допоміжні засоби резервного перемикання, пошук провайдера та розбір посилань на моделі |
+ | `plugin-sdk/webhook-targets` | Реєстр цілей Webhook і допоміжні засоби встановлення маршрутів |
+ | `plugin-sdk/webhook-path` | Допоміжні засоби нормалізації шляху Webhook |
+ | `plugin-sdk/web-media` | Спільні допоміжні засоби завантаження віддалених/локальних медіа |
+ | `plugin-sdk/zod` | Повторно експортований `zod` для споживачів SDK Plugin |
+ | `plugin-sdk/testing` | Широкий barrel сумісності для застарілих тестів Plugin. Нові тести розширень мають натомість імпортувати цільові підшляхи SDK, як-от `plugin-sdk/agent-runtime-test-contracts`, `plugin-sdk/plugin-test-runtime`, `plugin-sdk/channel-test-helpers`, `plugin-sdk/test-env` або `plugin-sdk/test-fixtures` |
+ | `plugin-sdk/plugin-test-api` | Мінімальний допоміжний засіб `createTestPluginApi` для прямих модульних тестів реєстрації Plugin без імпорту містків тестових допоміжних засобів репозиторію |
+ | `plugin-sdk/agent-runtime-test-contracts` | Нативні фікстури контрактів адаптера agent-runtime для тестів автентифікації, доставки, резервного сценарію, tool-hook, prompt-overlay, схеми та проєкції транскрипту |
+ | `plugin-sdk/channel-test-helpers` | Орієнтовані на канали тестові допоміжні засоби для загальних контрактів дій/налаштування/стану, тверджень щодо каталогів, життєвого циклу запуску акаунта, потоків send-config, моків runtime, проблем стану, вихідної доставки та реєстрації hook |
+ | `plugin-sdk/channel-target-testing` | Спільний набір сценаріїв помилок розв’язання цілі для тестів каналів |
+ | `plugin-sdk/plugin-test-contracts` | Допоміжні засоби контрактів пакета Plugin, реєстрації, публічного артефакту, прямого імпорту, runtime API та побічних ефектів імпорту |
+ | `plugin-sdk/provider-test-contracts` | Допоміжні засоби контрактів runtime провайдера, автентифікації, виявлення, onboard, каталогу, wizard, медіаможливостей, політики повторного відтворення, realtime STT live-audio, web-search/fetch і stream |
+ | `plugin-sdk/provider-http-test-mocks` | Опційні HTTP/auth моки Vitest для тестів провайдерів, які перевіряють `plugin-sdk/provider-http` |
+ | `plugin-sdk/test-fixtures` | Загальні фікстури захоплення runtime CLI, контексту пісочниці, записувача skill, повідомлень агента, системних подій, перезавантаження модулів, шляху до вбудованого Plugin, тексту термінала, нарізання на фрагменти, токена автентифікації та типізованих кейсів |
+ | `plugin-sdk/test-node-mocks` | Цільові допоміжні засоби моків вбудованих модулів Node для використання всередині фабрик Vitest `vi.mock("node:*")` |
| Підшлях | Ключові експорти |
| --- | --- |
- | `plugin-sdk/memory-core` | Поверхня bundled memory-core помічників для менеджера/конфігурації/файлів/помічників CLI |
- | `plugin-sdk/memory-core-engine-runtime` | Runtime-фасад індексу/пошуку пам’яті |
- | `plugin-sdk/memory-core-host-engine-foundation` | Експорти рушія foundation для хоста пам’яті |
- | `plugin-sdk/memory-core-host-engine-embeddings` | Контракти embedding хоста пам’яті, доступ до реєстру, локальний провайдер і загальні batch/remote помічники |
- | `plugin-sdk/memory-core-host-engine-qmd` | Експорти QMD-рушія хоста пам’яті |
- | `plugin-sdk/memory-core-host-engine-storage` | Експорти рушія сховища хоста пам’яті |
- | `plugin-sdk/memory-core-host-multimodal` | Мультимодальні помічники хоста пам’яті |
- | `plugin-sdk/memory-core-host-query` | Помічники запитів хоста пам’яті |
- | `plugin-sdk/memory-core-host-secret` | Помічники секретів хоста пам’яті |
- | `plugin-sdk/memory-core-host-events` | Помічники журналу подій хоста пам’яті |
- | `plugin-sdk/memory-core-host-status` | Помічники статусу хоста пам’яті |
- | `plugin-sdk/memory-core-host-runtime-cli` | Помічники runtime CLI хоста пам’яті |
- | `plugin-sdk/memory-core-host-runtime-core` | Помічники core runtime хоста пам’яті |
- | `plugin-sdk/memory-core-host-runtime-files` | Помічники файлів/runtime хоста пам’яті |
- | `plugin-sdk/memory-host-core` | Нейтральний до постачальника alias для помічників core runtime хоста пам’яті |
- | `plugin-sdk/memory-host-events` | Нейтральний до постачальника alias для помічників журналу подій хоста пам’яті |
- | `plugin-sdk/memory-host-files` | Нейтральний до постачальника alias для помічників файлів/runtime хоста пам’яті |
- | `plugin-sdk/memory-host-markdown` | Спільні managed-markdown помічники для plugin, суміжних із пам’яттю |
- | `plugin-sdk/memory-host-search` | Runtime-фасад Active memory для доступу до search-manager |
- | `plugin-sdk/memory-host-status` | Нейтральний до постачальника alias для помічників статусу хоста пам’яті |
+ | `plugin-sdk/memory-core` | Поверхня вбудованих допоміжних засобів memory-core для допоміжних засобів менеджера/config/файлів/CLI |
+ | `plugin-sdk/memory-core-engine-runtime` | Фасад runtime індексу/пошуку пам’яті |
+ | `plugin-sdk/memory-core-host-engine-foundation` | Експорти foundation engine хоста пам’яті |
+ | `plugin-sdk/memory-core-host-engine-embeddings` | Контракти embeddings хоста пам’яті, доступ до реєстру, локальний провайдер і загальні batch/remote допоміжні засоби |
+ | `plugin-sdk/memory-core-host-engine-qmd` | Експорти QMD engine хоста пам’яті |
+ | `plugin-sdk/memory-core-host-engine-storage` | Експорти storage engine хоста пам’яті |
+ | `plugin-sdk/memory-core-host-multimodal` | Мультимодальні допоміжні засоби хоста пам’яті |
+ | `plugin-sdk/memory-core-host-query` | Допоміжні засоби запитів хоста пам’яті |
+ | `plugin-sdk/memory-core-host-secret` | Допоміжні засоби секретів хоста пам’яті |
+ | `plugin-sdk/memory-core-host-events` | Допоміжні засоби журналу подій хоста пам’яті |
+ | `plugin-sdk/memory-core-host-status` | Допоміжні засоби стану хоста пам’яті |
+ | `plugin-sdk/memory-core-host-runtime-cli` | Допоміжні засоби runtime CLI хоста пам’яті |
+ | `plugin-sdk/memory-core-host-runtime-core` | Допоміжні засоби core runtime хоста пам’яті |
+ | `plugin-sdk/memory-core-host-runtime-files` | Допоміжні засоби файлів/runtime хоста пам’яті |
+ | `plugin-sdk/memory-host-core` | Вендорно-нейтральний псевдонім для допоміжних засобів core runtime хоста пам’яті |
+ | `plugin-sdk/memory-host-events` | Вендорно-нейтральний псевдонім для допоміжних засобів журналу подій хоста пам’яті |
+ | `plugin-sdk/memory-host-files` | Вендорно-нейтральний псевдонім для допоміжних засобів файлів/runtime хоста пам’яті |
+ | `plugin-sdk/memory-host-markdown` | Спільні допоміжні засоби managed-markdown для суміжних із пам’яттю Plugin |
+ | `plugin-sdk/memory-host-search` | Фасад runtime active memory для доступу до search-manager |
+ | `plugin-sdk/memory-host-status` | Вендорно-нейтральний псевдонім для допоміжних засобів стану хоста пам’яті |
-
- Наразі немає зарезервованих підшляхів SDK bundled-helper. Помічники, специфічні для власника,
- розташовані всередині пакета plugin-власника, тоді як повторно використовувані контракти хоста
- використовують загальні підшляхи SDK, такі як `plugin-sdk/gateway-runtime`,
+
+ Наразі немає зарезервованих підшляхів SDK для вбудованих допоміжних засобів. Специфічні для власника
+ допоміжні засоби містяться всередині пакета Plugin-власника, тоді як багаторазові контракти хоста
+ використовують загальні підшляхи SDK, як-от `plugin-sdk/gateway-runtime`,
`plugin-sdk/security-runtime` і `plugin-sdk/plugin-config-runtime`.
## Пов’язане
-- [Огляд Plugin SDK](/uk/plugins/sdk-overview)
-- [Налаштування Plugin SDK](/uk/plugins/sdk-setup)
-- [Створення plugins](/uk/plugins/building-plugins)
+- [Огляд SDK Plugin](/uk/plugins/sdk-overview)
+- [Налаштування SDK Plugin](/uk/plugins/sdk-setup)
+- [Створення Plugin](/uk/plugins/building-plugins)