chore(i18n): refresh uk translations

docs/uk/plugins/sdk-migration.md

@@ -2,107 +2,103 @@
 read_when:
     - Ви бачите попередження OPENCLAW_PLUGIN_SDK_COMPAT_DEPRECATED
     - Ви бачите попередження OPENCLAW_EXTENSION_API_DEPRECATED
-    - Ви оновлюєте плагін до сучасної архітектури плагінів
-    - Ви підтримуєте зовнішній плагін OpenClaw
+    - Ви оновлюєте plugin до сучасної архітектури plugins
+    - Ви підтримуєте зовнішній plugin OpenClaw
 sidebarTitle: Migrate to SDK
-summary: Перейдіть із застарілого шару зворотної сумісності на сучасний SDK плагінів
-title: Міграція SDK плагінів
+summary: Перехід із застарілого шару зворотної сумісності на сучасний plugin SDK
+title: Міграція Plugin SDK
 x-i18n:
-    generated_at: "2026-04-06T00:53:06Z"
+    generated_at: "2026-04-06T03:21:02Z"
     model: gpt-5.4
     provider: openai
-    source_hash: b71ce69b30c3bb02da1b263b1d11dc3214deae5f6fc708515e23b5a1c7bb7c8f
+    source_hash: f648ea36622ef899db7f31dff2d40bcd9c55b52f0d0c2e584925ace022c3c160
     source_path: plugins/sdk-migration.md
     workflow: 15
 ---
 
-# Міграція SDK плагінів
+# Міграція Plugin SDK
 
 OpenClaw перейшов від широкого шару зворотної сумісності до сучасної
-архітектури плагінів із вузькоспрямованими, документованими імпортами. Якщо ваш
-плагін було створено до появи нової архітектури, цей посібник допоможе вам
-виконати міграцію.
+архітектури plugins із цільовими, задокументованими імпортами. Якщо ваш plugin
+було створено до появи нової архітектури, цей посібник допоможе вам перейти на неї.
 
 ## Що змінюється
 
-Стара система плагінів надавала дві надто широкі поверхні, які дозволяли
-плагінам імпортувати все необхідне з однієї точки входу:
+Стара система plugins надавала дві широкі поверхні, які дозволяли plugins
+імпортувати все необхідне з однієї точки входу:
 
-- **`openclaw/plugin-sdk/compat`** — один імпорт, який повторно експортував
-  десятки допоміжних функцій. Його було додано, щоб старі плагіни на основі
-  хуків продовжували працювати, поки створювалася нова архітектура плагінів.
-- **`openclaw/extension-api`** — міст, який надавав плагінам прямий доступ до
-  допоміжних функцій на боці хоста, таких як вбудований запускальник агентів.
+- **`openclaw/plugin-sdk/compat`** — єдиний імпорт, який повторно експортував десятки
+  допоміжних засобів. Його було запроваджено, щоб старіші plugins на основі hook
+  продовжували працювати, поки створювалася нова архітектура plugins.
+- **`openclaw/extension-api`** — міст, який надавав plugins прямий доступ до
+  допоміжних засобів на боці хоста, як-от вбудований запускальник агента.
 
-Обидві поверхні тепер **застарілі**. Вони досі працюють під час виконання, але
-нові плагіни не повинні їх використовувати, а наявні плагіни мають перейти на
-новий підхід до того, як у наступному мажорному релізі їх буде вилучено.
+Обидві поверхні тепер **застарілі**. Вони все ще працюють під час виконання, але
+нові plugins не повинні їх використовувати, а наявні plugins слід перенести до того,
+як наступний мажорний випуск їх видалить.
 
 <Warning>
-  Шар зворотної сумісності буде вилучено в одному з майбутніх мажорних релізів.
-  Плагіни, які все ще імпортують із цих поверхонь, перестануть працювати, коли
-  це станеться.
+  Шар зворотної сумісності буде видалено в одному з майбутніх мажорних випусків.
+  Plugins, які все ще імпортують із цих поверхонь, перестануть працювати, коли це станеться.
 </Warning>
 
 ## Чому це змінилося
 
 Старий підхід спричиняв проблеми:
 
-- **Повільний запуск** — імпорт однієї допоміжної функції завантажував десятки
-  не пов’язаних між собою модулів
+- **Повільний запуск** — імпорт одного допоміжного засобу завантажував десятки не пов’язаних модулів
 - **Циклічні залежності** — широкі повторні експорти спрощували створення циклів імпорту
-- **Нечітка поверхня API** — не було способу зрозуміти, які експорти стабільні, а які внутрішні
+- **Нечітка поверхня API** — не було способу визначити, які експорти є стабільними, а які внутрішніми
 
-Сучасний SDK плагінів виправляє це: кожен шлях імпорту (`openclaw/plugin-sdk/\<subpath\>`)
-є невеликим, самодостатнім модулем із чітким призначенням і документованим контрактом.
+Сучасний plugin SDK це виправляє: кожен шлях імпорту (`openclaw/plugin-sdk/\<subpath\>`)
+є невеликим самодостатнім модулем із чітким призначенням і задокументованим контрактом.
 
-Застарілі зручні шви провайдерів для вбудованих каналів також зникли. Імпорти
+Застарілі зручні seams постачальників для вбудованих каналів також прибрано. Імпорти
 на кшталт `openclaw/plugin-sdk/slack`, `openclaw/plugin-sdk/discord`,
 `openclaw/plugin-sdk/signal`, `openclaw/plugin-sdk/whatsapp`,
-канально-брендовані допоміжні шви та
-`openclaw/plugin-sdk/telegram-core` були приватними скороченнями для монорепозиторію, а не
-стабільними контрактами плагінів. Натомість використовуйте вузькі загальні
-підшляхи SDK. Усередині робочого простору вбудованих плагінів зберігайте
-допоміжні функції, що належать провайдеру, у власному `api.ts` або
-`runtime-api.ts` цього плагіна.
+допоміжні seams із брендингом каналів, а також
+`openclaw/plugin-sdk/telegram-core` були приватними скороченнями mono-repo, а не
+стабільними контрактами plugins. Натомість використовуйте вузькі загальні підшляхи SDK. Усередині
+вбудованого робочого простору plugin тримайте допоміжні засоби, що належать постачальнику, у власних
+`api.ts` або `runtime-api.ts` цього plugin.
 
-Поточні приклади вбудованих провайдерів:
+Поточні приклади вбудованих постачальників:
 
-- Anthropic зберігає специфічні для Claude допоміжні функції потоків у власному шві `api.ts` /
+- Anthropic зберігає допоміжні засоби потоку, специфічні для Claude, у власному seam `api.ts` /
   `contract-api.ts`
-- OpenAI зберігає побудовники провайдерів, допоміжні функції моделей за замовчуванням і побудовники провайдерів реального часу
+- OpenAI зберігає конструктори постачальника, допоміжні засоби моделей за замовчуванням і конструктори постачальника реального часу
   у власному `api.ts`
-- OpenRouter зберігає побудовник провайдера та допоміжні функції онбордингу/конфігурації у власному
+- OpenRouter зберігає конструктор постачальника та допоміжні засоби onboarding/config у власному
   `api.ts`
 
 ## Як виконати міграцію
 
 <Steps>
-  <Step title="Перевірте поведінку запасного режиму оболонки Windows wrapper">
-    Якщо ваш плагін використовує `openclaw/plugin-sdk/windows-spawn`, невизначені Windows
-    wrapper-и `.cmd`/`.bat` тепер аварійно завершуються в закритому режимі, якщо ви явно не передасте
+  <Step title="Перевірте резервну поведінку Windows wrapper">
+    Якщо ваш plugin використовує `openclaw/plugin-sdk/windows-spawn`, нерозв’язані Windows
+    wrappers `.cmd`/`.bat` тепер завершуються з відмовою за замовчуванням, якщо ви явно не передасте
     `allowShellFallback: true`.
 
     ```typescript
-    // До
+    // Before
     const program = applyWindowsSpawnProgramPolicy({ candidate });
 
-    // Після
+    // After
     const program = applyWindowsSpawnProgramPolicy({
       candidate,
-      // Встановлюйте це лише для довірених сумісних викликів, які навмисно
-      // допускають запасний режим через оболонку.
+      // Only set this for trusted compatibility callers that intentionally
+      // accept shell-mediated fallback.
       allowShellFallback: true,
     });
     ```
 
-    Якщо ваш виклик не покладається навмисно на запасний режим оболонки, не
-    встановлюйте `allowShellFallback`, а натомість обробіть викинуту помилку.
+    Якщо ваш код виклику навмисно не покладається на резервний shell, не встановлюйте
+    `allowShellFallback`, а натомість обробіть викинуту помилку.
 
   </Step>
 
   <Step title="Знайдіть застарілі імпорти">
-    Знайдіть у своєму плагіні імпорти з будь-якої із застарілих поверхонь:
+    Знайдіть у своєму plugin імпорти з будь-якої із застарілих поверхонь:
 
     ```bash
     grep -r "plugin-sdk/compat" my-plugin/
@@ -111,36 +107,36 @@ OpenClaw перейшов від широкого шару зворотної с
 
   </Step>
 
-  <Step title="Замініть на вузькоспрямовані імпорти">
+  <Step title="Замініть на цільові імпорти">
     Кожен експорт зі старої поверхні відповідає певному сучасному шляху імпорту:
 
     ```typescript
-    // До (застарілий шар зворотної сумісності)
+    // Before (deprecated backwards-compatibility layer)
     import {
       createChannelReplyPipeline,
       createPluginRuntimeStore,
       resolveControlCommandGate,
     } from "openclaw/plugin-sdk/compat";
 
-    // Після (сучасні вузькоспрямовані імпорти)
+    // After (modern focused imports)
     import { createChannelReplyPipeline } from "openclaw/plugin-sdk/channel-reply-pipeline";
     import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
     import { resolveControlCommandGate } from "openclaw/plugin-sdk/command-auth";
     ```
 
-    Для допоміжних функцій на боці хоста використовуйте впроваджене середовище
-    виконання плагіна замість прямого імпорту:
+    Для допоміжних засобів на боці хоста використовуйте інжектований runtime plugin замість
+    прямого імпорту:
 
     ```typescript
-    // До (застарілий міст extension-api)
+    // Before (deprecated extension-api bridge)
     import { runEmbeddedPiAgent } from "openclaw/extension-api";
     const result = await runEmbeddedPiAgent({ sessionId, prompt });
 
-    // Після (впроваджене середовище виконання)
+    // After (injected runtime)
     const result = await api.runtime.agent.runEmbeddedPiAgent({ sessionId, prompt });
     ```
 
-    Той самий шаблон застосовується й до інших застарілих допоміжних функцій моста:
+    Такий самий шаблон застосовується й до інших застарілих допоміжних засобів bridge:
 
     | Старий імпорт | Сучасний еквівалент |
     | --- | --- |
@@ -150,7 +146,7 @@ OpenClaw перейшов від широкого шару зворотної с
     | `resolveThinkingDefault` | `api.runtime.agent.resolveThinkingDefault` |
     | `resolveAgentTimeoutMs` | `api.runtime.agent.resolveAgentTimeoutMs` |
     | `ensureAgentWorkspace` | `api.runtime.agent.ensureAgentWorkspace` |
-    | допоміжні функції сховища сесій | `api.runtime.agent.session.*` |
+    | допоміжні засоби сховища сесій | `api.runtime.agent.session.*` |
 
   </Step>
 
@@ -167,165 +163,165 @@ OpenClaw перейшов від широкого шару зворотної с
 <Accordion title="Таблиця поширених шляхів імпорту">
   | Шлях імпорту | Призначення | Ключові експорти |
   | --- | --- | --- |
-  | `plugin-sdk/plugin-entry` | Канонічна допоміжна функція точки входу плагіна | `definePluginEntry` |
-  | `plugin-sdk/core` | Застарілий повторний umbrella-експорт для визначень/побудовників входу каналу | `defineChannelPluginEntry`, `createChatChannelPlugin` |
-  | `plugin-sdk/config-schema` | Експорт кореневої схеми конфігурації | `OpenClawSchema` |
-  | `plugin-sdk/provider-entry` | Допоміжна функція точки входу для одного провайдера | `defineSingleProviderPluginEntry` |
-  | `plugin-sdk/channel-core` | Вузькоспрямовані визначення та побудовники входу каналу | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` |
-  | `plugin-sdk/setup` | Спільні допоміжні функції майстра налаштування | Запити allowlist, побудовники статусу налаштування |
-  | `plugin-sdk/setup-runtime` | Допоміжні функції середовища виконання під час налаштування | Безпечні для імпорту адаптери латок налаштування, допоміжні функції нотаток пошуку, `promptResolvedAllowFrom`, `splitSetupEntries`, делеговані проксі налаштування |
-  | `plugin-sdk/setup-adapter-runtime` | Допоміжні функції адаптера налаштування | `createEnvPatchedAccountSetupAdapter` |
-  | `plugin-sdk/setup-tools` | Допоміжні інструменти налаштування | `formatCliCommand`, `detectBinary`, `extractArchive`, `resolveBrewExecutable`, `formatDocsLink`, `CONFIG_DIR` |
-  | `plugin-sdk/account-core` | Допоміжні функції для кількох облікових записів | Допоміжні функції списку/конфігурації/гейтів дій облікових записів |
-  | `plugin-sdk/account-id` | Допоміжні функції account-id | `DEFAULT_ACCOUNT_ID`, нормалізація account-id |
-  | `plugin-sdk/account-resolution` | Допоміжні функції пошуку облікового запису | Допоміжні функції пошуку облікового запису + запасного значення за замовчуванням |
-  | `plugin-sdk/account-helpers` | Вузькі допоміжні функції облікових записів | Допоміжні функції списку облікових записів/дій над обліковими записами |
+  | `plugin-sdk/plugin-entry` | Канонічний допоміжний засіб точки входу plugin | `definePluginEntry` |
+  | `plugin-sdk/core` | Застарілий узагальнений повторний експорт для визначень/конструкторів точок входу каналів | `defineChannelPluginEntry`, `createChatChannelPlugin` |
+  | `plugin-sdk/config-schema` | Експорт кореневої схеми config | `OpenClawSchema` |
+  | `plugin-sdk/provider-entry` | Допоміжний засіб точки входу для одного постачальника | `defineSingleProviderPluginEntry` |
+  | `plugin-sdk/channel-core` | Цільові визначення та конструктори точок входу каналів | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` |
+  | `plugin-sdk/setup` | Спільні допоміжні засоби майстра налаштування | Запити allowlist, конструктори стану налаштування |
+  | `plugin-sdk/setup-runtime` | Допоміжні засоби runtime для етапу налаштування | Безпечні для імпорту адаптери patch налаштування, допоміжні засоби нотаток пошуку, `promptResolvedAllowFrom`, `splitSetupEntries`, делеговані проксі налаштування |
+  | `plugin-sdk/setup-adapter-runtime` | Допоміжні засоби адаптера налаштування | `createEnvPatchedAccountSetupAdapter` |
+  | `plugin-sdk/setup-tools` | Допоміжні засоби інструментів налаштування | `formatCliCommand`, `detectBinary`, `extractArchive`, `resolveBrewExecutable`, `formatDocsLink`, `CONFIG_DIR` |
+  | `plugin-sdk/account-core` | Допоміжні засоби для кількох облікових записів | Допоміжні засоби списку облікових записів/config/action-gate |
+  | `plugin-sdk/account-id` | Допоміжні засоби account-id | `DEFAULT_ACCOUNT_ID`, нормалізація account-id |
+  | `plugin-sdk/account-resolution` | Допоміжні засоби пошуку облікових записів | Допоміжні засоби пошуку облікового запису + резервного вибору за замовчуванням |
+  | `plugin-sdk/account-helpers` | Вузькі допоміжні засоби облікових записів | Допоміжні засоби списку облікових записів/дій з обліковими записами |
   | `plugin-sdk/channel-setup` | Адаптери майстра налаштування | `createOptionalChannelSetupSurface`, `createOptionalChannelSetupAdapter`, `createOptionalChannelSetupWizard`, а також `DEFAULT_ACCOUNT_ID`, `createTopLevelChannelDmPolicy`, `setSetupChannelEnabled`, `splitSetupEntries` |
-  | `plugin-sdk/channel-pairing` | Примітиви парування DM | `createChannelPairingController` |
-  | `plugin-sdk/channel-reply-pipeline` | Налаштування префікса відповіді + набору тексту | `createChannelReplyPipeline` |
-  | `plugin-sdk/channel-config-helpers` | Фабрики адаптерів конфігурації | `createHybridChannelConfigAdapter` |
-  | `plugin-sdk/channel-config-schema` | Побудовники схем конфігурації | Типи схем конфігурації каналу |
-  | `plugin-sdk/telegram-command-config` | Допоміжні функції конфігурації команд Telegram | Нормалізація назв команд, обрізання опису, перевірка дублікатів/конфліктів |
+  | `plugin-sdk/channel-pairing` | Примітиви спаровування DM | `createChannelPairingController` |
+  | `plugin-sdk/channel-reply-pipeline` | Префікс відповіді + зв’язування індикатора набору | `createChannelReplyPipeline` |
+  | `plugin-sdk/channel-config-helpers` | Фабрики адаптерів config | `createHybridChannelConfigAdapter` |
+  | `plugin-sdk/channel-config-schema` | Конструктори схем config | Типи схем config каналу |
+  | `plugin-sdk/telegram-command-config` | Допоміжні засоби config команд Telegram | Нормалізація назв команд, обрізання описів, перевірка дублікатів/конфліктів |
   | `plugin-sdk/channel-policy` | Визначення політики груп/DM | `resolveChannelGroupRequireMention` |
-  | `plugin-sdk/channel-lifecycle` | Відстеження статусу облікових записів | `createAccountStatusSink` |
-  | `plugin-sdk/inbound-envelope` | Допоміжні функції вхідного envelope | Спільні допоміжні функції маршрутизації + побудовника envelope |
-  | `plugin-sdk/inbound-reply-dispatch` | Допоміжні функції вхідних відповідей | Спільні допоміжні функції запису та диспетчеризації |
-  | `plugin-sdk/messaging-targets` | Розбір цілей повідомлень | Допоміжні функції розбору/зіставлення цілей |
-  | `plugin-sdk/outbound-media` | Допоміжні функції вихідних медіа | Спільне завантаження вихідних медіа |
-  | `plugin-sdk/outbound-runtime` | Допоміжні функції середовища виконання вихідних операцій | Допоміжні функції ідентичності вихідних операцій/делегування надсилання |
-  | `plugin-sdk/thread-bindings-runtime` | Допоміжні функції прив’язки потоків | Життєвий цикл прив’язки потоків і допоміжні функції адаптерів |
-  | `plugin-sdk/agent-media-payload` | Застарілі допоміжні функції корисного навантаження медіа | Побудовник корисного навантаження медіа агента для застарілих макетів полів |
-  | `plugin-sdk/channel-runtime` | Застарілий shim сумісності | Лише застарілі утиліти середовища виконання каналу |
-  | `plugin-sdk/channel-send-result` | Типи результату надсилання | Типи результатів відповідей |
-  | `plugin-sdk/runtime-store` | Постійне сховище плагіна | `createPluginRuntimeStore` |
-  | `plugin-sdk/runtime` | Широкі допоміжні функції середовища виконання | Допоміжні функції середовища виконання/логування/резервного копіювання/встановлення плагіна |
-  | `plugin-sdk/runtime-env` | Вузькі допоміжні функції runtime env | Допоміжні функції logger/runtime env, timeout, retry і backoff |
-  | `plugin-sdk/plugin-runtime` | Спільні допоміжні функції runtime плагіна | Допоміжні функції команд/хуків/http/інтерактивності плагіна |
-  | `plugin-sdk/hook-runtime` | Допоміжні функції конвеєра хуків | Спільні допоміжні функції конвеєра webhook/внутрішніх хуків |
-  | `plugin-sdk/lazy-runtime` | Допоміжні функції ледачого середовища виконання | `createLazyRuntimeModule`, `createLazyRuntimeMethod`, `createLazyRuntimeMethodBinder`, `createLazyRuntimeNamedExport`, `createLazyRuntimeSurface` |
-  | `plugin-sdk/process-runtime` | Допоміжні функції процесів | Спільні допоміжні функції exec |
-  | `plugin-sdk/cli-runtime` | Допоміжні функції середовища виконання CLI | Форматування команд, очікування, допоміжні функції версій |
-  | `plugin-sdk/gateway-runtime` | Допоміжні функції Gateway | Клієнт Gateway і допоміжні функції латок статусу каналу |
-  | `plugin-sdk/config-runtime` | Допоміжні функції конфігурації | Допоміжні функції завантаження/запису конфігурації |
-  | `plugin-sdk/telegram-command-config` | Допоміжні функції команд Telegram | Допоміжні функції перевірки команд Telegram зі стабільним fallback, коли поверхня контракту вбудованого Telegram недоступна |
-  | `plugin-sdk/approval-runtime` | Допоміжні функції запитів на схвалення | Корисне навантаження схвалення exec/плагіна, допоміжні функції можливостей/профілів схвалення, нативна маршрутизація схвалення/допоміжні функції runtime |
-  | `plugin-sdk/approval-auth-runtime` | Допоміжні функції auth для схвалення | Визначення схвалювача, auth дій у тому самому чаті |
-  | `plugin-sdk/approval-client-runtime` | Допоміжні функції клієнта схвалення | Допоміжні функції профілю/фільтра нативного схвалення exec |
-  | `plugin-sdk/approval-delivery-runtime` | Допоміжні функції доставки схвалення | Адаптери можливостей/доставки нативного схвалення |
-  | `plugin-sdk/approval-native-runtime` | Допоміжні функції цілей схвалення | Допоміжні функції прив’язки цілі/облікового запису нативного схвалення |
-  | `plugin-sdk/approval-reply-runtime` | Допоміжні функції відповіді на схвалення | Допоміжні функції корисного навантаження відповіді для схвалення exec/плагіна |
-  | `plugin-sdk/security-runtime` | Допоміжні функції безпеки | Спільні допоміжні функції довіри, DM gating, external-content і збирання секретів |
-  | `plugin-sdk/ssrf-policy` | Допоміжні функції політики SSRF | Допоміжні функції allowlist хостів і політики приватних мереж |
-  | `plugin-sdk/ssrf-runtime` | Допоміжні функції runtime SSRF | Pinned-dispatcher, guarded fetch, допоміжні функції політики SSRF |
-  | `plugin-sdk/collection-runtime` | Допоміжні функції обмеженого кешу | `pruneMapToMaxSize` |
-  | `plugin-sdk/diagnostic-runtime` | Допоміжні функції діагностичного gating | `isDiagnosticFlagEnabled`, `isDiagnosticsEnabled` |
-  | `plugin-sdk/error-runtime` | Допоміжні функції форматування помилок | `formatUncaughtError`, `isApprovalNotFoundError`, допоміжні функції графа помилок |
-  | `plugin-sdk/fetch-runtime` | Допоміжні функції обгорнутого fetch/proxy | `resolveFetch`, допоміжні функції proxy |
-  | `plugin-sdk/host-runtime` | Допоміжні функції нормалізації хоста | `normalizeHostname`, `normalizeScpRemoteHost` |
-  | `plugin-sdk/retry-runtime` | Допоміжні функції retry | `RetryConfig`, `retryAsync`, виконавці політик |
+  | `plugin-sdk/channel-lifecycle` | Відстеження стану облікового запису | `createAccountStatusSink` |
+  | `plugin-sdk/inbound-envelope` | Допоміжні засоби вхідного envelope | Спільні допоміжні засоби маршрутів + побудови envelope |
+  | `plugin-sdk/inbound-reply-dispatch` | Допоміжні засоби вхідних відповідей | Спільні допоміжні засоби запису та диспетчеризації |
+  | `plugin-sdk/messaging-targets` | Розбір цілей повідомлень | Допоміжні засоби розбору/зіставлення цілей |
+  | `plugin-sdk/outbound-media` | Допоміжні засоби вихідного media | Спільне завантаження вихідного media |
+  | `plugin-sdk/outbound-runtime` | Допоміжні засоби вихідного runtime | Допоміжні засоби делегування ідентичності/надсилання для вихідних повідомлень |
+  | `plugin-sdk/thread-bindings-runtime` | Допоміжні засоби прив’язки thread | Допоміжні засоби життєвого циклу та адаптера прив’язки thread |
+  | `plugin-sdk/agent-media-payload` | Застарілі допоміжні засоби media payload | Конструктор media payload агента для застарілих макетів полів |
+  | `plugin-sdk/channel-runtime` | Застарілий shim сумісності | Лише застарілі утиліти runtime каналу |
+  | `plugin-sdk/channel-send-result` | Типи результатів надсилання | Типи результатів відповіді |
+  | `plugin-sdk/runtime-store` | Постійне сховище plugin | `createPluginRuntimeStore` |
+  | `plugin-sdk/runtime` | Широкі допоміжні засоби runtime | Допоміжні засоби runtime/логування/резервного копіювання/встановлення plugin |
+  | `plugin-sdk/runtime-env` | Вузькі допоміжні засоби середовища runtime | Logger/runtime env, допоміжні засоби timeout, retry і backoff |
+  | `plugin-sdk/plugin-runtime` | Спільні допоміжні засоби runtime plugin | Допоміжні засоби команд/hooks/http/interactive для plugin |
+  | `plugin-sdk/hook-runtime` | Допоміжні засоби конвеєра hook | Спільні допоміжні засоби конвеєра webhook/internal hook |
+  | `plugin-sdk/lazy-runtime` | Допоміжні засоби лінивого runtime | `createLazyRuntimeModule`, `createLazyRuntimeMethod`, `createLazyRuntimeMethodBinder`, `createLazyRuntimeNamedExport`, `createLazyRuntimeSurface` |
+  | `plugin-sdk/process-runtime` | Допоміжні засоби процесів | Спільні допоміжні засоби exec |
+  | `plugin-sdk/cli-runtime` | Допоміжні засоби runtime CLI | Форматування команд, очікування, допоміжні засоби версій |
+  | `plugin-sdk/gateway-runtime` | Допоміжні засоби gateway | Клієнт gateway і допоміжні засоби patch стану каналів |
+  | `plugin-sdk/config-runtime` | Допоміжні засоби config | Допоміжні засоби завантаження/запису config |
+  | `plugin-sdk/telegram-command-config` | Допоміжні засоби команд Telegram | Допоміжні засоби перевірки команд Telegram зі стабільним резервним варіантом, коли поверхня контракту вбудованого Telegram недоступна |
+  | `plugin-sdk/approval-runtime` | Допоміжні засоби запитів схвалення | Payload схвалення exec/plugin, допоміжні засоби можливостей/профілів схвалення, нативна маршрутизація/runtime схвалення |
+  | `plugin-sdk/approval-auth-runtime` | Допоміжні засоби auth для схвалення | Визначення approver, auth дій у тому самому чаті |
+  | `plugin-sdk/approval-client-runtime` | Допоміжні засоби клієнта схвалення | Допоміжні засоби профілю/фільтра нативного схвалення exec |
+  | `plugin-sdk/approval-delivery-runtime` | Допоміжні засоби доставки схвалення | Адаптери можливостей/доставки нативного схвалення |
+  | `plugin-sdk/approval-native-runtime` | Допоміжні засоби цілей схвалення | Допоміжні засоби прив’язки цілей/облікових записів нативного схвалення |
+  | `plugin-sdk/approval-reply-runtime` | Допоміжні засоби відповідей на схвалення | Допоміжні засоби payload відповідей для схвалення exec/plugin |
+  | `plugin-sdk/security-runtime` | Допоміжні засоби безпеки | Спільні допоміжні засоби довіри, DM gating, external-content і збирання секретів |
+  | `plugin-sdk/ssrf-policy` | Допоміжні засоби політики SSRF | Допоміжні засоби allowlist хостів і політики приватних мереж |
+  | `plugin-sdk/ssrf-runtime` | Допоміжні засоби runtime SSRF | Pinned-dispatcher, guarded fetch, допоміжні засоби політики SSRF |
+  | `plugin-sdk/collection-runtime` | Допоміжні засоби обмеженого кешу | `pruneMapToMaxSize` |
+  | `plugin-sdk/diagnostic-runtime` | Допоміжні засоби діагностичного gating | `isDiagnosticFlagEnabled`, `isDiagnosticsEnabled` |
+  | `plugin-sdk/error-runtime` | Допоміжні засоби форматування помилок | `formatUncaughtError`, `isApprovalNotFoundError`, допоміжні засоби графа помилок |
+  | `plugin-sdk/fetch-runtime` | Допоміжні засоби обгорнутого fetch/proxy | `resolveFetch`, допоміжні засоби proxy |
+  | `plugin-sdk/host-runtime` | Допоміжні засоби нормалізації хоста | `normalizeHostname`, `normalizeScpRemoteHost` |
+  | `plugin-sdk/retry-runtime` | Допоміжні засоби retry | `RetryConfig`, `retryAsync`, засоби запуску політик |
   | `plugin-sdk/allow-from` | Форматування allowlist | `formatAllowFromLowercase` |
-  | `plugin-sdk/allowlist-resolution` | Мапування вхідних даних allowlist | `mapAllowlistResolutionInputs` |
-  | `plugin-sdk/command-auth` | Gating команд і допоміжні функції поверхні команд | `resolveControlCommandGate`, допоміжні функції авторизації відправника, допоміжні функції реєстру команд |
-  | `plugin-sdk/secret-input` | Розбір секретного введення | Допоміжні функції секретного введення |
-  | `plugin-sdk/webhook-ingress` | Допоміжні функції запитів webhook | Утиліти цілей webhook |
-  | `plugin-sdk/webhook-request-guards` | Допоміжні функції guard для тіла webhook | Допоміжні функції читання/обмеження тіла запиту |
-  | `plugin-sdk/reply-runtime` | Спільне середовище виконання відповідей | Вхідна диспетчеризація, heartbeat, планувальник відповіді, chunking |
-  | `plugin-sdk/reply-dispatch-runtime` | Вузькі допоміжні функції диспетчеризації відповідей | Допоміжні функції фіналізації + диспетчеризації провайдера |
-  | `plugin-sdk/reply-history` | Допоміжні функції історії відповідей | `buildHistoryContext`, `buildPendingHistoryContextFromMap`, `recordPendingHistoryEntry`, `clearHistoryEntriesIfEnabled` |
-  | `plugin-sdk/reply-reference` | Планування посилань відповіді | `createReplyReferencePlanner` |
-  | `plugin-sdk/reply-chunking` | Допоміжні функції chunk відповіді | Допоміжні функції chunking тексту/markdown |
-  | `plugin-sdk/session-store-runtime` | Допоміжні функції сховища сесій | Допоміжні функції шляху сховища + updated-at |
-  | `plugin-sdk/state-paths` | Допоміжні функції шляхів стану | Допоміжні функції каталогів state і OAuth |
-  | `plugin-sdk/routing` | Допоміжні функції маршрутизації/session-key | `resolveAgentRoute`, `buildAgentSessionKey`, `resolveDefaultAgentBoundAccountId`, допоміжні функції нормалізації session-key |
-  | `plugin-sdk/status-helpers` | Допоміжні функції статусу каналу | Побудовники зведень статусу каналу/облікового запису, значення runtime-state за замовчуванням, допоміжні функції метаданих проблем |
-  | `plugin-sdk/target-resolver-runtime` | Допоміжні функції визначення цілі | Спільні допоміжні функції визначення цілі |
-  | `plugin-sdk/string-normalization-runtime` | Допоміжні функції нормалізації рядків | Допоміжні функції нормалізації slug/рядків |
-  | `plugin-sdk/request-url` | Допоміжні функції URL запиту | Витягнення рядкових URL із вхідних даних, схожих на запит |
-  | `plugin-sdk/run-command` | Допоміжні функції команд із тайм-аутом | Виконавець команд із тайм-аутом і нормалізованими stdout/stderr |
-  | `plugin-sdk/param-readers` | Зчитувачі параметрів | Поширені зчитувачі параметрів інструментів/CLI |
-  | `plugin-sdk/tool-send` | Витягнення надсилання інструменту | Витягнення канонічних полів цілі надсилання з аргументів інструменту |
-  | `plugin-sdk/temp-path` | Допоміжні функції тимчасових шляхів | Спільні допоміжні функції шляхів для тимчасових завантажень |
-  | `plugin-sdk/logging-core` | Допоміжні функції логування | Логер підсистеми та допоміжні функції редагування |
-  | `plugin-sdk/markdown-table-runtime` | Допоміжні функції markdown-таблиць | Допоміжні функції режиму markdown-таблиць |
-  | `plugin-sdk/reply-payload` | Типи корисного навантаження відповіді | Типи корисного навантаження відповіді |
-  | `plugin-sdk/provider-setup` | Кураторські допоміжні функції налаштування локального/self-hosted провайдера | Допоміжні функції виявлення/конфігурації self-hosted провайдера |
-  | `plugin-sdk/self-hosted-provider-setup` | Вузькоспрямовані допоміжні функції налаштування self-hosted провайдера, сумісного з OpenAI | Ті самі допоміжні функції виявлення/конфігурації self-hosted провайдера |
-  | `plugin-sdk/provider-auth-runtime` | Допоміжні функції runtime auth провайдера | Допоміжні функції визначення API-ключа під час виконання |
-  | `plugin-sdk/provider-auth-api-key` | Допоміжні функції налаштування API-ключа провайдера | Допоміжні функції онбордингу API-ключа/запису профілю |
-  | `plugin-sdk/provider-auth-result` | Допоміжні функції результату auth провайдера | Стандартний побудовник результату auth OAuth |
-  | `plugin-sdk/provider-auth-login` | Допоміжні функції інтерактивного входу провайдера | Спільні допоміжні функції інтерактивного входу |
-  | `plugin-sdk/provider-env-vars` | Допоміжні функції env vars провайдера | Допоміжні функції пошуку env vars для auth провайдера |
-  | `plugin-sdk/provider-model-shared` | Спільні допоміжні функції моделей/повторів провайдера | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні побудовники replay-policy, допоміжні функції endpoint провайдера та нормалізації model-id |
-  | `plugin-sdk/provider-catalog-shared` | Спільні допоміжні функції каталогу провайдера | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` |
-  | `plugin-sdk/provider-onboard` | Латки онбордингу провайдера | Допоміжні функції конфігурації онбордингу |
-  | `plugin-sdk/provider-http` | Допоміжні функції HTTP провайдера | Загальні допоміжні функції HTTP/можливостей endpoint провайдера |
-  | `plugin-sdk/provider-web-fetch` | Допоміжні функції web-fetch провайдера | Допоміжні функції реєстрації/кешу провайдера web-fetch |
-  | `plugin-sdk/provider-web-search` | Допоміжні функції web-search провайдера | Допоміжні функції реєстрації/кешу/конфігурації провайдера web-search |
-  | `plugin-sdk/provider-tools` | Допоміжні функції сумісності інструментів/схем провайдера | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, очищення схем Gemini + діагностика та допоміжні функції сумісності xAI, такі як `resolveXaiModelCompatPatch` / `applyXaiModelCompat` |
-  | `plugin-sdk/provider-usage` | Допоміжні функції використання провайдера | `fetchClaudeUsage`, `fetchGeminiUsage`, `fetchGithubCopilotUsage` та інші допоміжні функції використання провайдера |
-  | `plugin-sdk/provider-stream` | Допоміжні функції обгорток потоків провайдера | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, типи обгорток потоків і спільні допоміжні функції обгорток Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
-  | `plugin-sdk/keyed-async-queue` | Впорядкована асинхронна черга | `KeyedAsyncQueue` |
-  | `plugin-sdk/media-runtime` | Спільні допоміжні функції медіа | Допоміжні функції отримання/перетворення/зберігання медіа, а також побудовники корисного навантаження медіа |
-  | `plugin-sdk/media-understanding` | Допоміжні функції media-understanding | Типи провайдерів media-understanding та експорти допоміжних функцій для зображень/аудіо, орієнтовані на провайдерів |
-  | `plugin-sdk/text-runtime` | Спільні допоміжні функції тексту | Видалення видимого для помічника тексту, допоміжні функції рендерингу/chunking/table для markdown, редагування, теги директив, утиліти безпечного тексту та пов’язані допоміжні функції тексту/логування |
-  | `plugin-sdk/text-chunking` | Допоміжні функції chunking тексту | Допоміжна функція chunking вихідного тексту |
-  | `plugin-sdk/speech` | Допоміжні функції speech | Типи провайдерів speech та експорти допоміжних функцій директив, реєстру й перевірки, орієнтовані на провайдерів |
-  | `plugin-sdk/speech-core` | Спільне ядро speech | Типи провайдерів speech, реєстр, директиви, нормалізація |
-  | `plugin-sdk/realtime-transcription` | Допоміжні функції транскрипції в реальному часі | Типи провайдерів і допоміжні функції реєстру |
-  | `plugin-sdk/realtime-voice` | Допоміжні функції голосу в реальному часі | Типи провайдерів і допоміжні функції реєстру |
-  | `plugin-sdk/image-generation-core` | Спільне ядро генерації зображень | Допоміжні функції типів, failover, auth і реєстру для генерації зображень |
-  | `plugin-sdk/music-generation` | Допоміжні функції генерації музики | Типи провайдера/запиту/результату генерації музики |
-  | `plugin-sdk/music-generation-core` | Спільне ядро генерації музики | Допоміжні функції типів, failover, пошуку провайдера та розбору model-ref для генерації музики |
-  | `plugin-sdk/video-generation` | Допоміжні функції генерації відео | Типи провайдера/запиту/результату генерації відео |
-  | `plugin-sdk/video-generation-core` | Спільне ядро генерації відео | Допоміжні функції типів, failover, пошуку провайдера та розбору model-ref для генерації відео |
-  | `plugin-sdk/interactive-runtime` | Допоміжні функції інтерактивних відповідей | Нормалізація/зведення корисного навантаження інтерактивних відповідей |
-  | `plugin-sdk/channel-config-primitives` | Примітиви конфігурації каналу | Вузькі примітиви channel config-schema |
-  | `plugin-sdk/channel-config-writes` | Допоміжні функції запису конфігурації каналу | Допоміжні функції авторизації запису конфігурації каналу |
-  | `plugin-sdk/channel-plugin-common` | Спільний channel prelude | Експорти спільного channel prelude плагіна |
-  | `plugin-sdk/channel-status` | Допоміжні функції статусу каналу | Спільні допоміжні функції snapshot/summary статусу каналу |
-  | `plugin-sdk/allowlist-config-edit` | Допоміжні функції конфігурації allowlist | Допоміжні функції редагування/читання конфігурації allowlist |
-  | `plugin-sdk/group-access` | Допоміжні функції доступу до груп | Спільні допоміжні функції рішень щодо доступу до груп |
-  | `plugin-sdk/direct-dm` | Допоміжні функції прямих DM | Спільні допоміжні функції auth/guard для прямих DM |
-  | `plugin-sdk/extension-shared` | Спільні допоміжні функції розширень | Примітиви допоміжних функцій пасивного каналу/статусу |
-  | `plugin-sdk/webhook-targets` | Допоміжні функції цілей webhook | Реєстр цілей webhook і допоміжні функції встановлення маршрутів |
-  | `plugin-sdk/webhook-path` | Допоміжні функції шляхів webhook | Допоміжні функції нормалізації шляхів webhook |
-  | `plugin-sdk/web-media` | Спільні допоміжні функції web media | Допоміжні функції завантаження віддалених/локальних медіа |
-  | `plugin-sdk/zod` | Повторний експорт zod | Повторно експортований `zod` для споживачів SDK плагінів |
-  | `plugin-sdk/memory-core` | Допоміжні функції вбудованого memory-core | Поверхня допоміжних функцій memory manager/config/file/CLI |
-  | `plugin-sdk/memory-core-engine-runtime` | Фасад runtime рушія пам’яті | Фасад runtime індексації/пошуку пам’яті |
-  | `plugin-sdk/memory-core-host-engine-foundation` | Foundation-рушій хоста пам’яті | Експорти foundation-рушія хоста пам’яті |
-  | `plugin-sdk/memory-core-host-engine-embeddings` | Рушій embeddings хоста пам’яті | Експорти рушія embeddings хоста пам’яті |
-  | `plugin-sdk/memory-core-host-engine-qmd` | 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-status` | Допоміжні функції статусу хоста пам’яті | Допоміжні функції статусу хоста пам’яті |
-  | `plugin-sdk/memory-core-host-runtime-cli` | CLI runtime хоста пам’яті | Допоміжні функції CLI runtime хоста пам’яті |
-  | `plugin-sdk/memory-core-host-runtime-core` | Core runtime хоста пам’яті | Допоміжні функції core runtime хоста пам’яті |
-  | `plugin-sdk/memory-core-host-runtime-files` | Допоміжні функції файлів/runtime хоста пам’яті | Допоміжні функції файлів/runtime хоста пам’яті |
-  | `plugin-sdk/memory-lancedb` | Допоміжні функції вбудованого memory-lancedb | Поверхня допоміжних функцій memory-lancedb |
-  | `plugin-sdk/testing` | Тестові утиліти | Допоміжні функції та мок-об’єкти для тестування |
+  | `plugin-sdk/allowlist-resolution` | Зіставлення вхідних даних allowlist | `mapAllowlistResolutionInputs` |
+  | `plugin-sdk/command-auth` | Gating команд і допоміжні засоби поверхні команд | `resolveControlCommandGate`, допоміжні засоби авторизації відправника, допоміжні засоби реєстру команд |
+  | `plugin-sdk/secret-input` | Розбір введення секретів | Допоміжні засоби введення секретів |
+  | `plugin-sdk/webhook-ingress` | Допоміжні засоби запитів webhook | Утиліти цілей webhook |
+  | `plugin-sdk/webhook-request-guards` | Допоміжні засоби guard для тіла webhook-запиту | Допоміжні засоби читання/обмеження тіла запиту |
+  | `plugin-sdk/reply-runtime` | Спільний runtime відповідей | Вхідна диспетчеризація, heartbeat, планувальник відповідей, поділ на частини |
+  | `plugin-sdk/reply-dispatch-runtime` | Вузькі допоміжні засоби диспетчеризації відповідей | Допоміжні засоби фіналізації + диспетчеризації постачальника |
+  | `plugin-sdk/reply-history` | Допоміжні засоби історії відповідей | `buildHistoryContext`, `buildPendingHistoryContextFromMap`, `recordPendingHistoryEntry`, `clearHistoryEntriesIfEnabled` |
+  | `plugin-sdk/reply-reference` | Планування посилань на відповіді | `createReplyReferencePlanner` |
+  | `plugin-sdk/reply-chunking` | Допоміжні засоби поділу відповідей на частини | Допоміжні засоби поділу тексту/markdown на частини |
+  | `plugin-sdk/session-store-runtime` | Допоміжні засоби сховища сесій | Допоміжні засоби шляху сховища + updated-at |
+  | `plugin-sdk/state-paths` | Допоміжні засоби шляхів стану | Допоміжні засоби каталогів стану та OAuth |
+  | `plugin-sdk/routing` | Допоміжні засоби маршрутизації/ключів сесій | `resolveAgentRoute`, `buildAgentSessionKey`, `resolveDefaultAgentBoundAccountId`, допоміжні засоби нормалізації ключів сесій |
+  | `plugin-sdk/status-helpers` | Допоміжні засоби стану каналів | Конструктори зведення стану каналу/облікового запису, типові значення runtime-state, допоміжні засоби метаданих issue |
+  | `plugin-sdk/target-resolver-runtime` | Допоміжні засоби визначення цілей | Спільні допоміжні засоби визначення цілей |
+  | `plugin-sdk/string-normalization-runtime` | Допоміжні засоби нормалізації рядків | Допоміжні засоби нормалізації slug/рядків |
+  | `plugin-sdk/request-url` | Допоміжні засоби URL запиту | Витягування рядкових URL із запитоподібних входів |
+  | `plugin-sdk/run-command` | Допоміжні засоби команд із тайм-аутом | Запускач команд із тайм-аутом і нормалізованими stdout/stderr |
+  | `plugin-sdk/param-readers` | Зчитувачі параметрів | Загальні зчитувачі параметрів інструментів/CLI |
+  | `plugin-sdk/tool-send` | Витягування надсилання інструмента | Витягування канонічних полів цілі надсилання з аргументів інструмента |
+  | `plugin-sdk/temp-path` | Допоміжні засоби тимчасових шляхів | Спільні допоміжні засоби шляху для тимчасових завантажень |
+  | `plugin-sdk/logging-core` | Допоміжні засоби логування | Допоміжні засоби logger підсистеми та редагування |
+  | `plugin-sdk/markdown-table-runtime` | Допоміжні засоби markdown-таблиць | Допоміжні засоби режимів markdown-таблиць |
+  | `plugin-sdk/reply-payload` | Типи відповідей повідомлень | Типи payload відповідей |
+  | `plugin-sdk/provider-setup` | Кураторські допоміжні засоби налаштування локальних/self-hosted постачальників | Допоміжні засоби виявлення/config для self-hosted постачальників |
+  | `plugin-sdk/self-hosted-provider-setup` | Цільові допоміжні засоби налаштування self-hosted постачальників, сумісних з OpenAI | Ті самі допоміжні засоби виявлення/config для self-hosted постачальників |
+  | `plugin-sdk/provider-auth-runtime` | Допоміжні засоби auth постачальника під час runtime | Допоміжні засоби визначення API-ключа під час runtime |
+  | `plugin-sdk/provider-auth-api-key` | Допоміжні засоби налаштування API-ключа постачальника | Допоміжні засоби onboarding/запису профілю для API-ключа |
+  | `plugin-sdk/provider-auth-result` | Допоміжні засоби результату auth постачальника | Стандартний конструктор результату OAuth auth |
+  | `plugin-sdk/provider-auth-login` | Допоміжні засоби інтерактивного входу постачальника | Спільні допоміжні засоби інтерактивного входу |
+  | `plugin-sdk/provider-env-vars` | Допоміжні засоби env vars постачальника | Допоміжні засоби пошуку env vars auth постачальника |
+  | `plugin-sdk/provider-model-shared` | Спільні допоміжні засоби моделей/повторного відтворення постачальника | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні конструктори політики повторного відтворення, допоміжні засоби endpoint постачальника та допоміжні засоби нормалізації model-id |
+  | `plugin-sdk/provider-catalog-shared` | Спільні допоміжні засоби каталогу постачальника | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` |
+  | `plugin-sdk/provider-onboard` | Patches onboarding постачальника | Допоміжні засоби config onboarding |
+  | `plugin-sdk/provider-http` | Допоміжні засоби HTTP постачальника | Загальні допоміжні засоби HTTP/можливостей endpoint постачальника |
+  | `plugin-sdk/provider-web-fetch` | Допоміжні засоби web-fetch постачальника | Допоміжні засоби реєстрації/кешу постачальника web-fetch |
+  | `plugin-sdk/provider-web-search` | Допоміжні засоби web-search постачальника | Допоміжні засоби реєстрації/кешу/config постачальника web-search |
+  | `plugin-sdk/provider-tools` | Допоміжні засоби сумісності інструментів/схем постачальника | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, очищення схем Gemini + діагностика, а також допоміжні засоби сумісності xAI, такі як `resolveXaiModelCompatPatch` / `applyXaiModelCompat` |
+  | `plugin-sdk/provider-usage` | Допоміжні засоби використання постачальника | `fetchClaudeUsage`, `fetchGeminiUsage`, `fetchGithubCopilotUsage` та інші допоміжні засоби використання постачальника |
+  | `plugin-sdk/provider-stream` | Допоміжні засоби обгорток потоків постачальника | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, типи обгорток потоків і спільні допоміжні засоби обгорток Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
+  | `plugin-sdk/keyed-async-queue` | Упорядкована асинхронна черга | `KeyedAsyncQueue` |
+  | `plugin-sdk/media-runtime` | Спільні допоміжні засоби media | Допоміжні засоби отримання/перетворення/зберігання media, а також конструктори media payload |
+  | `plugin-sdk/media-generation-runtime` | Спільні допоміжні засоби генерації media | Спільні допоміжні засоби failover, вибору кандидатів і повідомлень про відсутню модель для генерації зображень/відео/музики |
+  | `plugin-sdk/media-understanding` | Допоміжні засоби media-understanding | Типи постачальників media understanding, а також експорти допоміжних засобів для зображень/аудіо, орієнтовані на постачальника |
+  | `plugin-sdk/text-runtime` | Спільні допоміжні засоби тексту | Видалення видимого для асистента тексту, допоміжні засоби рендерингу/chunking/таблиць markdown, редагування, допоміжні засоби тегів директив, утиліти safe-text та інші пов’язані допоміжні засоби тексту/логування |
+  | `plugin-sdk/text-chunking` | Допоміжні засоби поділу тексту на частини | Допоміжний засіб поділу вихідного тексту на частини |
+  | `plugin-sdk/speech` | Допоміжні засоби speech | Типи постачальників speech, а також експорти допоміжних засобів директив, реєстру та валідації, орієнтовані на постачальника |
+  | `plugin-sdk/speech-core` | Спільне ядро speech | Типи постачальників speech, реєстр, директиви, нормалізація |
+  | `plugin-sdk/realtime-transcription` | Допоміжні засоби транскрипції в реальному часі | Типи постачальників і допоміжні засоби реєстру |
+  | `plugin-sdk/realtime-voice` | Допоміжні засоби голосу в реальному часі | Типи постачальників і допоміжні засоби реєстру |
+  | `plugin-sdk/image-generation-core` | Спільне ядро генерації зображень | Допоміжні засоби типів, failover, auth і реєстру для генерації зображень |
+  | `plugin-sdk/music-generation` | Допоміжні засоби генерації музики | Типи постачальника/запиту/результату генерації музики |
+  | `plugin-sdk/music-generation-core` | Спільне ядро генерації музики | Типи генерації музики, допоміжні засоби failover, пошуку постачальника та розбору model-ref |
+  | `plugin-sdk/video-generation` | Допоміжні засоби генерації відео | Типи постачальника/запиту/результату генерації відео |
+  | `plugin-sdk/video-generation-core` | Спільне ядро генерації відео | Типи генерації відео, допоміжні засоби failover, пошуку постачальника та розбору model-ref |
+  | `plugin-sdk/interactive-runtime` | Допоміжні засоби інтерактивних відповідей | Нормалізація/редукція payload інтерактивних відповідей |
+  | `plugin-sdk/channel-config-primitives` | Примітиви config каналу | Вузькі примітиви schema config каналу |
+  | `plugin-sdk/channel-config-writes` | Допоміжні засоби запису config каналу | Допоміжні засоби авторизації запису config каналу |
+  | `plugin-sdk/channel-plugin-common` | Спільний prelude каналу | Експорти спільного prelude plugin каналу |
+  | `plugin-sdk/channel-status` | Допоміжні засоби стану каналу | Спільні допоміжні засоби знімків/зведень стану каналу |
+  | `plugin-sdk/allowlist-config-edit` | Допоміжні засоби config allowlist | Допоміжні засоби редагування/читання config allowlist |
+  | `plugin-sdk/group-access` | Допоміжні засоби доступу груп | Спільні допоміжні засоби рішень щодо group-access |
+  | `plugin-sdk/direct-dm` | Допоміжні засоби direct-DM | Спільні допоміжні засоби auth/guard для direct-DM |
+  | `plugin-sdk/extension-shared` | Спільні допоміжні засоби extension | Примітиви допоміжних засобів passive-channel/status |
+  | `plugin-sdk/webhook-targets` | Допоміжні засоби цілей webhook | Допоміжні засоби реєстру цілей webhook та встановлення маршрутів |
+  | `plugin-sdk/webhook-path` | Допоміжні засоби шляху webhook | Допоміжні засоби нормалізації шляху webhook |
+  | `plugin-sdk/web-media` | Спільні допоміжні засоби web media | Допоміжні засоби завантаження віддаленого/локального media |
+  | `plugin-sdk/zod` | Повторний експорт Zod | Повторно експортований `zod` для споживачів plugin SDK |
+  | `plugin-sdk/memory-core` | Вбудовані допоміжні засоби memory-core | Поверхня допоміжних засобів memory manager/config/file/CLI |
+  | `plugin-sdk/memory-core-engine-runtime` | Фасад runtime рушія memory | Фасад runtime індексації/пошуку memory |
+  | `plugin-sdk/memory-core-host-engine-foundation` | Базовий рушій хоста memory | Експорти базового рушія хоста memory |
+  | `plugin-sdk/memory-core-host-engine-embeddings` | Рушій embedding хоста memory | Експорти рушія embedding хоста memory |
+  | `plugin-sdk/memory-core-host-engine-qmd` | Рушій QMD хоста memory | Експорти рушія QMD хоста memory |
+  | `plugin-sdk/memory-core-host-engine-storage` | Рушій зберігання хоста memory | Експорти рушія зберігання хоста memory |
+  | `plugin-sdk/memory-core-host-multimodal` | Допоміжні засоби multimodal хоста memory | Допоміжні засоби multimodal хоста memory |
+  | `plugin-sdk/memory-core-host-query` | Допоміжні засоби query хоста memory | Допоміжні засоби query хоста memory |
+  | `plugin-sdk/memory-core-host-secret` | Допоміжні засоби secret хоста memory | Допоміжні засоби secret хоста memory |
+  | `plugin-sdk/memory-core-host-status` | Допоміжні засоби стану хоста memory | Допоміжні засоби стану хоста memory |
+  | `plugin-sdk/memory-core-host-runtime-cli` | Runtime CLI хоста memory | Допоміжні засоби runtime CLI хоста memory |
+  | `plugin-sdk/memory-core-host-runtime-core` | Базовий runtime хоста memory | Допоміжні засоби базового runtime хоста memory |
+  | `plugin-sdk/memory-core-host-runtime-files` | Допоміжні засоби файлів/runtime хоста memory | Допоміжні засоби файлів/runtime хоста memory |
+  | `plugin-sdk/memory-lancedb` | Вбудовані допоміжні засоби memory-lancedb | Поверхня допоміжних засобів memory-lancedb |
+  | `plugin-sdk/testing` | Тестові утиліти | Допоміжні засоби тестування та mocks |
 </Accordion>
 
-Ця таблиця навмисно охоплює поширену підмножину для міграції, а не всю
-поверхню SDK. Повний список із понад 200 точок входу міститься у
+Ця таблиця навмисно охоплює поширену підмножину для міграції, а не повну
+поверхню SDK. Повний список із понад 200 точок входу наведено у
 `scripts/lib/plugin-sdk-entrypoints.json`.
 
-Цей список усе ще включає деякі допоміжні шви вбудованих плагінів, наприклад
+Цей список усе ще містить деякі допоміжні seams вбудованих plugins, такі як
 `plugin-sdk/feishu`, `plugin-sdk/feishu-setup`, `plugin-sdk/zalo`,
-`plugin-sdk/zalo-setup` і `plugin-sdk/matrix*`. Вони й надалі експортуються для
-підтримки вбудованих плагінів і сумісності, але навмисно не включені до
-поширеної таблиці міграції й не є рекомендованою ціллю для
-нового коду плагінів.
+`plugin-sdk/zalo-setup` і `plugin-sdk/matrix*`. Вони й далі експортуються для
+підтримки вбудованих plugins і сумісності, але навмисно не включені до поширеної таблиці міграції
+і не є рекомендованою ціллю для нового коду plugin.
 
-Те саме правило застосовується до інших сімейств вбудованих допоміжних функцій, зокрема:
+Те саме правило застосовується до інших сімейств вбудованих допоміжних засобів, зокрема:
 
-- допоміжні функції підтримки браузера: `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support`
+- допоміжні засоби підтримки браузера: `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support`
 - Matrix: `plugin-sdk/matrix*`
 - LINE: `plugin-sdk/line*`
 - IRC: `plugin-sdk/irc*`
-- поверхні вбудованих допоміжних функцій/плагінів, такі як `plugin-sdk/googlechat`,
+- поверхні вбудованих helper/plugin, такі як `plugin-sdk/googlechat`,
   `plugin-sdk/zalouser`, `plugin-sdk/bluebubbles*`,
   `plugin-sdk/mattermost*`, `plugin-sdk/msteams`,
   `plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/tlon`,
@@ -334,26 +330,26 @@ OpenClaw перейшов від широкого шару зворотної с
   `plugin-sdk/diagnostics-otel`, `plugin-sdk/diffs`, `plugin-sdk/llm-task`,
   `plugin-sdk/thread-ownership` і `plugin-sdk/voice-call`
 
-`plugin-sdk/github-copilot-token` наразі надає вузьку
-поверхню допоміжних функцій токенів `DEFAULT_COPILOT_API_BASE_URL`,
+`plugin-sdk/github-copilot-token` наразі надає вузьку поверхню допоміжних засобів токенів
+`DEFAULT_COPILOT_API_BASE_URL`,
 `deriveCopilotApiBaseUrlFromToken` і `resolveCopilotApiToken`.
 
-Використовуйте найвужчий імпорт, який відповідає завданню. Якщо ви не можете
-знайти потрібний експорт, перевірте джерело в `src/plugin-sdk/` або запитайте в Discord.
+Використовуйте найвужчий імпорт, який відповідає вашому завданню. Якщо ви не можете знайти потрібний експорт,
+перевірте джерельний код у `src/plugin-sdk/` або запитайте в Discord.
 
-## Графік вилучення
+## Часова шкала видалення
 
 | Коли | Що відбувається |
 | ---------------------- | ----------------------------------------------------------------------- |
-| **Зараз** | Застарілі поверхні виводять попередження під час виконання |
-| **Наступний мажорний реліз** | Застарілі поверхні буде вилучено; плагіни, які й далі їх використовують, перестануть працювати |
+| **Зараз** | Застарілі поверхні видають попередження під час runtime |
+| **Наступний мажорний випуск** | Застарілі поверхні буде видалено; plugins, які досі їх використовують, перестануть працювати |
 
-Усі core-плагіни вже перенесено. Зовнішнім плагінам слід виконати міграцію
-до наступного мажорного релізу.
+Усі основні plugins уже перенесено. Зовнішні plugins слід перенести
+до наступного мажорного випуску.
 
-## Тимчасове вимкнення попереджень
+## Тимчасове приглушення попереджень
 
-Встановіть ці змінні середовища, поки працюєте над міграцією:
+Під час роботи над міграцією встановіть ці змінні середовища:
 
 ```bash
 OPENCLAW_SUPPRESS_PLUGIN_SDK_COMPAT_WARNING=1 openclaw gateway run
@@ -364,9 +360,9 @@ OPENCLAW_SUPPRESS_EXTENSION_API_WARNING=1 openclaw gateway run
 
 ## Пов’язане
 
-- [Початок роботи](/uk/plugins/building-plugins) — створіть свій перший плагін
-- [Огляд SDK](/uk/plugins/sdk-overview) — повний довідник імпортів підшляхів
-- [Плагіни каналів](/uk/plugins/sdk-channel-plugins) — створення плагінів каналів
-- [Плагіни провайдерів](/uk/plugins/sdk-provider-plugins) — створення плагінів провайдерів
-- [Внутрішня будова плагінів](/uk/plugins/architecture) — глибоке занурення в архітектуру
-- [Маніфест плагіна](/uk/plugins/manifest) — довідник зі схеми маніфесту
+- [Початок роботи](/uk/plugins/building-plugins) — створіть свій перший plugin
+- [Огляд SDK](/uk/plugins/sdk-overview) — повний довідник підшляхів імпорту
+- [Channel Plugins](/uk/plugins/sdk-channel-plugins) — створення channel plugins
+- [Provider Plugins](/uk/plugins/sdk-provider-plugins) — створення provider plugins
+- [Внутрішня будова plugins](/uk/plugins/architecture) — глибоке занурення в архітектуру
+- [Маніфест Plugin](/uk/plugins/manifest) — довідник зі схеми маніфесту

docs/uk/plugins/sdk-overview.md

@@ -1,30 +1,30 @@
 ---
 read_when:
-    - Потрібно знати, з якого підшляху SDK імпортувати
-    - Потрібен довідник для всіх методів реєстрації в OpenClawPluginApi
+    - Вам потрібно знати, з якого підшляху SDK імпортувати
+    - Ви хочете отримати довідник для всіх методів реєстрації в OpenClawPluginApi
     - Ви шукаєте конкретний експорт SDK
 sidebarTitle: SDK Overview
 summary: Карта імпортів, довідник API реєстрації та архітектура SDK
 title: Огляд Plugin SDK
 x-i18n:
-    generated_at: "2026-04-06T00:53:32Z"
+    generated_at: "2026-04-06T03:21:19Z"
     model: gpt-5.4
     provider: openai
-    source_hash: d801641f26f39dc21490d2a69a337ff1affb147141360916b8b58a267e9f822a
+    source_hash: d89657424b9449433caadfd0bf7df30c6054c1ec2b66970d209504395bf78072
     source_path: plugins/sdk-overview.md
     workflow: 15
 ---
 
 # Огляд Plugin SDK
 
-Plugin SDK — це типізований контракт між plugins і core. Ця сторінка —
-довідник про **що імпортувати** і **що можна зареєструвати**.
+Plugin SDK — це типізований контракт між plugins і core. Ця сторінка є
+довідником про **що імпортувати** і **що можна реєструвати**.
 
 <Tip>
   **Шукаєте практичний посібник?**
-  - Перший plugin? Почніть із [Getting Started](/uk/plugins/building-plugins)
-  - Channel plugin? Дивіться [Channel Plugins](/uk/plugins/sdk-channel-plugins)
-  - Provider plugin? Дивіться [Provider Plugins](/uk/plugins/sdk-provider-plugins)
+  - Перший plugin? Почніть із [Початок роботи](/uk/plugins/building-plugins)
+  - Channel plugin? Див. [Channel Plugins](/uk/plugins/sdk-channel-plugins)
+  - Provider plugin? Див. [Provider Plugins](/uk/plugins/sdk-provider-plugins)
 </Tip>
 
 ## Угода щодо імпорту
@@ -36,37 +36,37 @@ import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 import { defineChannelPluginEntry } from "openclaw/plugin-sdk/channel-core";
 ```
 
-Кожен підшлях — це невеликий самодостатній модуль. Це пришвидшує запуск і
-запобігає проблемам із циклічними залежностями. Для специфічних для channel
-хелперів входу/збірки надавайте перевагу `openclaw/plugin-sdk/channel-core`; `openclaw/plugin-sdk/core`
-залишайте для ширшої поверхні-парасольки та спільних хелперів, таких як
+Кожен підшлях — це невеликий самодостатній модуль. Це забезпечує швидкий
+запуск і запобігає проблемам із циклічними залежностями. Для специфічних для channel
+допоміжних засобів entry/build віддавайте перевагу `openclaw/plugin-sdk/channel-core`; залишайте `openclaw/plugin-sdk/core` для
+ширшої поверхні umbrella та спільних допоміжних засобів, таких як
 `buildChannelConfigSchema`.
 
-Не додавайте й не використовуйте зручні шви з назвами provider, як-от
+Не додавайте і не покладайтеся на зручні шви, названі на честь provider, такі як
 `openclaw/plugin-sdk/slack`, `openclaw/plugin-sdk/discord`,
 `openclaw/plugin-sdk/signal`, `openclaw/plugin-sdk/whatsapp`, або
-брендовані для channel хелпер-шви. Вбудовані plugins мають компонувати загальні
+допоміжні шви з брендуванням channel. Вбудовані plugins мають компонувати загальні
 підшляхи SDK у власних barrel-файлах `api.ts` або `runtime-api.ts`, а core
-має або використовувати ці локальні для plugin barrel-файли, або додавати вузький загальний SDK
-контракт, коли потреба справді є міжканальною.
+має або використовувати ці локальні для plugin barrel-файли, або додати вузький загальний контракт SDK,
+коли потреба справді є міжканальною.
 
-Згенерована карта експортів усе ще містить невеликий набір швів-хелперів для вбудованих plugin,
-таких як `plugin-sdk/feishu`, `plugin-sdk/feishu-setup`,
+Згенерована карта експортів усе ще містить невеликий набір допоміжних
+швів для вбудованих plugins, таких як `plugin-sdk/feishu`, `plugin-sdk/feishu-setup`,
 `plugin-sdk/zalo`, `plugin-sdk/zalo-setup` і `plugin-sdk/matrix*`. Ці
-підшляхи існують лише для підтримки та сумісності вбудованих plugins; вони
-навмисно не включені до загальної таблиці нижче й не є рекомендованим
+підшляхи існують лише для підтримки й сумісності вбудованих plugins; їх
+навмисно пропущено в загальній таблиці нижче, і вони не є рекомендованим
 шляхом імпорту для нових сторонніх plugins.
 
 ## Довідник підшляхів
 
 Найуживаніші підшляхи, згруповані за призначенням. Згенерований повний список із
-понад 200 підшляхів знаходиться в `scripts/lib/plugin-sdk-entrypoints.json`.
+понад 200 підшляхів міститься в `scripts/lib/plugin-sdk-entrypoints.json`.
 
-Зарезервовані підшляхи-хелпери для вбудованих plugins усе ще з’являються в цьому згенерованому списку.
-Ставтеся до них як до деталей реалізації/поверхонь сумісності, якщо тільки сторінка документації
-не позначає якийсь із них явно як публічний.
+Зарезервовані допоміжні підшляхи для вбудованих plugins усе ще з’являються в цьому
+згенерованому списку. Розглядайте їх як деталі реалізації/поверхні сумісності, якщо тільки сторінка документації
+явно не позначає якийсь із них як публічний.
 
-### Вхід plugin
+### Entry plugin
 
 | Subpath                     | Ключові експорти                                                                                                                      |
 | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
@@ -82,170 +82,171 @@ import { defineChannelPluginEntry } from "openclaw/plugin-sdk/channel-core";
     | `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` | Спільні хелпери майстра налаштування, запити списку дозволених, збирачі статусу налаштування |
+    | `plugin-sdk/setup` | Спільні допоміжні засоби майстра налаштування, запити allowlist, побудовники статусу налаштування |
     | `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` | Хелпери gate дій/конфігурації для багатьох облікових записів, хелпери резервного вибору стандартного облікового запису |
-    | `plugin-sdk/account-id` | `DEFAULT_ACCOUNT_ID`, хелпери нормалізації ID облікового запису |
-    | `plugin-sdk/account-resolution` | Хелпери пошуку облікового запису + резервного вибору стандартного |
-    | `plugin-sdk/account-helpers` | Вузькі хелпери списку облікових записів/дій над обліковими записами |
+    | `plugin-sdk/account-core` | Допоміжні засоби багатoоблікового запису config/action-gate, допоміжні засоби резервного варіанта облікового запису за замовчуванням |
+    | `plugin-sdk/account-id` | `DEFAULT_ACCOUNT_ID`, допоміжні засоби нормалізації account-id |
+    | `plugin-sdk/account-resolution` | Пошук облікового запису + допоміжні засоби резервного варіанта за замовчуванням |
+    | `plugin-sdk/account-helpers` | Вузькі допоміжні засоби списку облікових записів/дій з обліковими записами |
     | `plugin-sdk/channel-pairing` | `createChannelPairingController` |
     | `plugin-sdk/channel-reply-pipeline` | `createChannelReplyPipeline` |
     | `plugin-sdk/channel-config-helpers` | `createHybridChannelConfigAdapter` |
-    | `plugin-sdk/channel-config-schema` | Типи схем конфігурації channel |
-    | `plugin-sdk/telegram-command-config` | Хелпери нормалізації/валідації користувацьких команд Telegram із резервною підтримкою контракту вбудованого plugin |
+    | `plugin-sdk/channel-config-schema` | Типи схеми config для channel |
+    | `plugin-sdk/telegram-command-config` | Допоміжні засоби нормалізації/валідації користувацьких команд Telegram із резервним варіантом для вбудованого контракту |
     | `plugin-sdk/channel-policy` | `resolveChannelGroupRequireMention` |
     | `plugin-sdk/channel-lifecycle` | `createAccountStatusSink` |
-    | `plugin-sdk/inbound-envelope` | Спільні хелпери побудови вхідних маршрутів і envelope |
-    | `plugin-sdk/inbound-reply-dispatch` | Спільні хелпери запису та диспетчеризації вхідних даних |
-    | `plugin-sdk/messaging-targets` | Хелпери розбору/зіставлення цілей |
-    | `plugin-sdk/outbound-media` | Спільні хелпери завантаження вихідних медіа |
-    | `plugin-sdk/outbound-runtime` | Хелпери делегатів вихідної ідентичності/надсилання |
-    | `plugin-sdk/thread-bindings-runtime` | Хелпери життєвого циклу та адаптера прив’язок потоків |
-    | `plugin-sdk/agent-media-payload` | Застарілий збирач media payload агента |
-    | `plugin-sdk/conversation-runtime` | Хелпери прив’язки розмови/потоку, спарювання та налаштованих прив’язок |
-    | `plugin-sdk/runtime-config-snapshot` | Хелпер знімка runtime-конфігурації |
-    | `plugin-sdk/runtime-group-policy` | Хелпери визначення політики груп у runtime |
-    | `plugin-sdk/channel-status` | Спільні хелпери знімка/зведення статусу channel |
-    | `plugin-sdk/channel-config-primitives` | Вузькі примітиви schema конфігурації channel |
-    | `plugin-sdk/channel-config-writes` | Хелпери авторизації запису конфігурації channel |
-    | `plugin-sdk/channel-plugin-common` | Спільні prelude-експорти plugin для channel |
-    | `plugin-sdk/allowlist-config-edit` | Хелпери редагування/читання конфігурації списку дозволених |
-    | `plugin-sdk/group-access` | Спільні хелпери рішень доступу до груп |
-    | `plugin-sdk/direct-dm` | Спільні хелпери auth/guard для прямих DM |
-    | `plugin-sdk/interactive-runtime` | Хелпери нормалізації/скорочення interactive reply payload |
-    | `plugin-sdk/channel-inbound` | Хелпери debounce, зіставлення згадок та envelope |
+    | `plugin-sdk/inbound-envelope` | Спільні допоміжні засоби маршрутизації inbound + побудови envelope |
+    | `plugin-sdk/inbound-reply-dispatch` | Спільні допоміжні засоби запису й диспетчеризації inbound |
+    | `plugin-sdk/messaging-targets` | Допоміжні засоби розбору/зіставлення цілей |
+    | `plugin-sdk/outbound-media` | Спільні допоміжні засоби завантаження outbound media |
+    | `plugin-sdk/outbound-runtime` | Допоміжні засоби outbound identity/send delegate |
+    | `plugin-sdk/thread-bindings-runtime` | Допоміжні засоби життєвого циклу прив’язок потоків і адаптерів |
+    | `plugin-sdk/agent-media-payload` | Застарілий побудовник payload media агента |
+    | `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` | Спільні допоміжні засоби знімка/підсумку статусу channel |
+    | `plugin-sdk/channel-config-primitives` | Вузькі примітиви схеми config для channel |
+    | `plugin-sdk/channel-config-writes` | Допоміжні засоби авторизації запису config для channel |
+    | `plugin-sdk/channel-plugin-common` | Спільні prelude-експорти plugin channel |
+    | `plugin-sdk/allowlist-config-edit` | Допоміжні засоби редагування/читання config allowlist |
+    | `plugin-sdk/group-access` | Спільні допоміжні засоби рішень щодо group-access |
+    | `plugin-sdk/direct-dm` | Спільні допоміжні засоби auth/guard для прямих DM |
+    | `plugin-sdk/interactive-runtime` | Допоміжні засоби нормалізації/зведення payload інтерактивних відповідей |
+    | `plugin-sdk/channel-inbound` | Допоміжні засоби debounce, зіставлення згадок, envelope |
     | `plugin-sdk/channel-send-result` | Типи результатів reply |
     | `plugin-sdk/channel-actions` | `createMessageToolButtonsSchema`, `createMessageToolCardSchema` |
-    | `plugin-sdk/channel-targets` | Хелпери розбору/зіставлення цілей |
-    | `plugin-sdk/channel-contract` | Типи контракту channel |
-    | `plugin-sdk/channel-feedback` | Підключення feedback/reaction |
+    | `plugin-sdk/channel-targets` | Допоміжні засоби розбору/зіставлення цілей |
+    | `plugin-sdk/channel-contract` | Типи контрактів channel |
+    | `plugin-sdk/channel-feedback` | Зв’язування feedback/reaction |
   </Accordion>
 
   <Accordion title="Підшляхи provider">
     | Subpath | Ключові експорти |
     | --- | --- |
     | `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry` |
-    | `plugin-sdk/provider-setup` | Кураторські хелпери налаштування локальних/self-hosted provider |
-    | `plugin-sdk/self-hosted-provider-setup` | Сфокусовані хелпери налаштування self-hosted provider, сумісних з OpenAI |
-    | `plugin-sdk/provider-auth-runtime` | Хелпери визначення API-ключа в runtime для provider plugins |
-    | `plugin-sdk/provider-auth-api-key` | Хелпери онбордингу/запису профілю API-ключа |
-    | `plugin-sdk/provider-auth-result` | Стандартний збирач результату OAuth auth |
-    | `plugin-sdk/provider-auth-login` | Спільні інтерактивні хелпери входу для provider plugins |
-    | `plugin-sdk/provider-env-vars` | Хелпери пошуку env vars для auth provider |
+    | `plugin-sdk/provider-setup` | Кураторські допоміжні засоби налаштування локальних/self-hosted provider |
+    | `plugin-sdk/self-hosted-provider-setup` | Спеціалізовані допоміжні засоби налаштування self-hosted provider, сумісних з OpenAI |
+    | `plugin-sdk/provider-auth-runtime` | Допоміжні засоби визначення API-key під час виконання для plugins provider |
+    | `plugin-sdk/provider-auth-api-key` | Допоміжні засоби онбордингу/запису профілю API-key |
+    | `plugin-sdk/provider-auth-result` | Стандартний побудовник OAuth auth-result |
+    | `plugin-sdk/provider-auth-login` | Спільні допоміжні засоби інтерактивного входу для plugins provider |
+    | `plugin-sdk/provider-env-vars` | Допоміжні засоби пошуку env-var auth для provider |
     | `plugin-sdk/provider-auth` | `createProviderApiKeyAuthMethod`, `ensureApiKeyFromOptionEnvOrPrompt`, `upsertAuthProfile` |
-    | `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні збирачі replay-policy, хелпери endpoint provider та хелпери нормалізації model-id, такі як `normalizeNativeXaiModelId` |
+    | `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні побудовники replay-policy, допоміжні засоби endpoint provider і допоміжні засоби нормалізації model-id, такі як `normalizeNativeXaiModelId` |
     | `plugin-sdk/provider-catalog-shared` | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` |
-    | `plugin-sdk/provider-http` | Загальні хелпери HTTP/endpoint capability для provider |
-    | `plugin-sdk/provider-web-fetch` | Хелпери реєстрації/кешу provider web-fetch |
-    | `plugin-sdk/provider-web-search` | Хелпери реєстрації/кешу/конфігурації provider web-search |
-    | `plugin-sdk/provider-tools` | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, очищення схем Gemini + діагностика, а також xAI compat-хелпери, такі як `resolveXaiModelCompatPatch` / `applyXaiModelCompat` |
-    | `plugin-sdk/provider-usage` | `fetchClaudeUsage` та подібне |
-    | `plugin-sdk/provider-stream` | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, типи stream wrapper і спільні хелпери wrapper для Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
-    | `plugin-sdk/provider-onboard` | Хелпери патчів конфігурації онбордингу |
-    | `plugin-sdk/global-singleton` | Хелпери локального для процесу singleton/map/cache |
+    | `plugin-sdk/provider-http` | Загальні допоміжні засоби HTTP/можливостей endpoint для provider |
+    | `plugin-sdk/provider-web-fetch` | Допоміжні засоби реєстрації/кешування provider web-fetch |
+    | `plugin-sdk/provider-web-search` | Допоміжні засоби реєстрації/кешування/config provider 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 і спільні допоміжні обгортки для Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
+    | `plugin-sdk/provider-onboard` | Допоміжні засоби патчу config для онбордингу |
+    | `plugin-sdk/global-singleton` | Допоміжні засоби singleton/map/cache локально для процесу |
   </Accordion>
 
   <Accordion title="Підшляхи auth і безпеки">
     | Subpath | Ключові експорти |
     | --- | --- |
-    | `plugin-sdk/command-auth` | `resolveControlCommandGate`, хелпери реєстру команд, хелпери авторизації відправника |
-    | `plugin-sdk/approval-auth-runtime` | Хелпери визначення approver та auth дій у тому самому чаті |
-    | `plugin-sdk/approval-client-runtime` | Хелпери профілю/фільтра native exec approval |
-    | `plugin-sdk/approval-delivery-runtime` | Адаптери delivery/capability native approval |
-    | `plugin-sdk/approval-native-runtime` | Хелпери native approval target + прив’язки облікового запису |
-    | `plugin-sdk/approval-reply-runtime` | Хелпери approval reply payload для exec/plugin |
-    | `plugin-sdk/command-auth-native` | Native auth команд + хелпери native session-target |
-    | `plugin-sdk/command-detection` | Спільні хелпери виявлення команд |
-    | `plugin-sdk/command-surface` | Хелпери нормалізації тіла команди та поверхні команд |
+    | `plugin-sdk/command-auth` | `resolveControlCommandGate`, допоміжні засоби реєстру команд, допоміжні засоби авторизації відправника |
+    | `plugin-sdk/approval-auth-runtime` | Допоміжні засоби визначення approver і auth дій у тому самому chat |
+    | `plugin-sdk/approval-client-runtime` | Допоміжні засоби профілю/фільтра native exec approval |
+    | `plugin-sdk/approval-delivery-runtime` | Адаптери можливостей/доставки native approval |
+    | `plugin-sdk/approval-native-runtime` | Допоміжні засоби цілі native approval + прив’язки облікового запису |
+    | `plugin-sdk/approval-reply-runtime` | Допоміжні засоби payload reply для exec/plugin approval |
+    | `plugin-sdk/command-auth-native` | Допоміжні засоби native auth команд + native session-target |
+    | `plugin-sdk/command-detection` | Спільні допоміжні засоби виявлення команд |
+    | `plugin-sdk/command-surface` | Допоміжні засоби нормалізації тіла команди та surface команди |
     | `plugin-sdk/allow-from` | `formatAllowFromLowercase` |
-    | `plugin-sdk/security-runtime` | Спільні хелпери довіри, gate DM, зовнішнього контенту та збору секретів |
-    | `plugin-sdk/ssrf-policy` | Хелпери host allowlist та політики SSRF для приватних мереж |
-    | `plugin-sdk/ssrf-runtime` | Хелпери pinned-dispatcher, fetch із захистом SSRF та політики SSRF |
-    | `plugin-sdk/secret-input` | Хелпери розбору секретного вводу |
-    | `plugin-sdk/webhook-ingress` | Хелпери запиту/цілі webhook |
-    | `plugin-sdk/webhook-request-guards` | Хелпери розміру body/timeout запиту |
+    | `plugin-sdk/security-runtime` | Спільні допоміжні засоби довіри, DM gating, зовнішнього вмісту та збирання секретів |
+    | `plugin-sdk/ssrf-policy` | Допоміжні засоби allowlist хостів і політики SSRF для приватних мереж |
+    | `plugin-sdk/ssrf-runtime` | Допоміжні засоби pinned-dispatcher, fetch із захистом від SSRF і політики SSRF |
+    | `plugin-sdk/secret-input` | Допоміжні засоби розбору секретного вводу |
+    | `plugin-sdk/webhook-ingress` | Допоміжні засоби запиту/цілі webhook |
+    | `plugin-sdk/webhook-request-guards` | Допоміжні засоби для розміру тіла запиту/таймауту |
   </Accordion>
 
-  <Accordion title="Підшляхи runtime і сховища">
+  <Accordion title="Підшляхи runtime і storage">
     | Subpath | Ключові експорти |
     | --- | --- |
-    | `plugin-sdk/runtime` | Широкі хелпери runtime/logging/backup/встановлення plugin |
-    | `plugin-sdk/runtime-env` | Вузькі хелпери runtime env, logger, timeout, retry і backoff |
+    | `plugin-sdk/runtime` | Широкі допоміжні засоби runtime/logging/backup/встановлення plugin |
+    | `plugin-sdk/runtime-env` | Вузькі допоміжні засоби env runtime, logger, timeout, retry і backoff |
     | `plugin-sdk/runtime-store` | `createPluginRuntimeStore` |
-    | `plugin-sdk/plugin-runtime` | Спільні хелпери команд/hook/http/interactive для plugin |
-    | `plugin-sdk/hook-runtime` | Спільні хелпери конвеєра webhook/internal hook |
-    | `plugin-sdk/lazy-runtime` | Хелпери лінивого імпорту/прив’язки runtime, такі як `createLazyRuntimeModule`, `createLazyRuntimeMethod` і `createLazyRuntimeSurface` |
-    | `plugin-sdk/process-runtime` | Хелпери виконання процесів |
-    | `plugin-sdk/cli-runtime` | Хелпери форматування CLI, очікування та версії |
-    | `plugin-sdk/gateway-runtime` | Хелпери клієнта gateway і патчів статусу channel |
-    | `plugin-sdk/config-runtime` | Хелпери завантаження/запису конфігурації |
-    | `plugin-sdk/telegram-command-config` | Нормалізація назви/опису команд Telegram і перевірки дублікатів/конфліктів, навіть коли поверхня контракту вбудованого Telegram недоступна |
-    | `plugin-sdk/approval-runtime` | Хелпери approval для exec/plugin, збирачі approval-capability, хелпери auth/profile, native routing/runtime |
-    | `plugin-sdk/reply-runtime` | Спільні runtime-хелпери для inbound/reply, chunking, dispatch, heartbeat, планувальник reply |
-    | `plugin-sdk/reply-dispatch-runtime` | Вузькі хелпери dispatch/finalize для reply |
-    | `plugin-sdk/reply-history` | Спільні хелпери коротковіконної історії reply, такі як `buildHistoryContext`, `recordPendingHistoryEntry` і `clearHistoryEntriesIfEnabled` |
+    | `plugin-sdk/plugin-runtime` | Спільні допоміжні засоби plugin command/hook/http/interactive |
+    | `plugin-sdk/hook-runtime` | Спільні допоміжні засоби конвеєра webhook/internal hook |
+    | `plugin-sdk/lazy-runtime` | Допоміжні засоби lazy імпорту/прив’язки runtime, такі як `createLazyRuntimeModule`, `createLazyRuntimeMethod` і `createLazyRuntimeSurface` |
+    | `plugin-sdk/process-runtime` | Допоміжні засоби виконання процесів |
+    | `plugin-sdk/cli-runtime` | Допоміжні засоби форматування CLI, очікування та версій |
+    | `plugin-sdk/gateway-runtime` | Допоміжні засоби клієнта gateway і patch статусу channel |
+    | `plugin-sdk/config-runtime` | Допоміжні засоби завантаження/запису config |
+    | `plugin-sdk/telegram-command-config` | Допоміжні засоби нормалізації назви/опису команд Telegram і перевірки дублікатів/конфліктів, навіть коли surface контракту вбудованого Telegram недоступна |
+    | `plugin-sdk/approval-runtime` | Допоміжні засоби exec/plugin approval, побудовники можливостей approval, допоміжні засоби auth/profile, native маршрутизації/runtime |
+    | `plugin-sdk/reply-runtime` | Спільні допоміжні засоби runtime inbound/reply, chunking, dispatch, heartbeat, планувальник reply |
+    | `plugin-sdk/reply-dispatch-runtime` | Вузькі допоміжні засоби dispatch/finalize для reply |
+    | `plugin-sdk/reply-history` | Спільні допоміжні засоби коротковіконної history reply, такі як `buildHistoryContext`, `recordPendingHistoryEntry` і `clearHistoryEntriesIfEnabled` |
     | `plugin-sdk/reply-reference` | `createReplyReferencePlanner` |
-    | `plugin-sdk/reply-chunking` | Вузькі хелпери chunking тексту/markdown |
-    | `plugin-sdk/session-store-runtime` | Хелпери шляху сховища сесій + updated-at |
-    | `plugin-sdk/state-paths` | Хелпери шляхів директорій стану/OAuth |
-    | `plugin-sdk/routing` | Хелпери маршруту/ключа сесії/прив’язки облікового запису, такі як `resolveAgentRoute`, `buildAgentSessionKey` і `resolveDefaultAgentBoundAccountId` |
-    | `plugin-sdk/status-helpers` | Спільні хелпери зведення статусу channel/облікового запису, значення runtime-state за замовчуванням і хелпери метаданих issue |
-    | `plugin-sdk/target-resolver-runtime` | Спільні хелпери визначення цілей |
-    | `plugin-sdk/string-normalization-runtime` | Хелпери нормалізації slug/рядків |
-    | `plugin-sdk/request-url` | Витягування рядкових URL із fetch/request-подібних входів |
-    | `plugin-sdk/run-command` | Запуск команд із таймером і нормалізованими результатами stdout/stderr |
-    | `plugin-sdk/param-readers` | Поширені рідери параметрів tool/CLI |
-    | `plugin-sdk/tool-send` | Витягування канонічних полів цілі надсилання з аргументів tool |
-    | `plugin-sdk/temp-path` | Спільні хелпери шляхів тимчасового завантаження |
-    | `plugin-sdk/logging-core` | Хелпери logger підсистеми та редагування чутливих даних |
-    | `plugin-sdk/markdown-table-runtime` | Хелпери режиму таблиць Markdown |
-    | `plugin-sdk/json-store` | Невеликі хелпери читання/запису стану JSON |
-    | `plugin-sdk/file-lock` | Хелпери повторно вхідного file-lock |
-    | `plugin-sdk/persistent-dedupe` | Хелпери кешу дедуплікації зберігання на диску |
-    | `plugin-sdk/acp-runtime` | Хелпери runtime/session і reply-dispatch для ACP |
-    | `plugin-sdk/agent-config-primitives` | Вузькі примітиви schema runtime-конфігурації агента |
-    | `plugin-sdk/boolean-param` | Нестрогий рідер boolean-параметрів |
-    | `plugin-sdk/dangerous-name-runtime` | Хелпери визначення збігів небезпечних назв |
-    | `plugin-sdk/device-bootstrap` | Хелпери початкового налаштування пристрою та токенів pairing |
-    | `plugin-sdk/extension-shared` | Спільні примітиви хелперів пасивного channel і статусу |
-    | `plugin-sdk/models-provider-runtime` | Хелпери reply для команди `/models`/provider |
-    | `plugin-sdk/skill-commands-runtime` | Хелпери списку команд Skills |
-    | `plugin-sdk/native-command-registry` | Хелпери реєстру/build/serialize native command |
-    | `plugin-sdk/provider-zai-endpoint` | Хелпери виявлення endpoint Z.AI |
-    | `plugin-sdk/infra-runtime` | Хелпери системних подій/heartbeat |
-    | `plugin-sdk/collection-runtime` | Невеликі хелпери обмеженого кешу |
-    | `plugin-sdk/diagnostic-runtime` | Хелпери діагностичних прапорців і подій |
-    | `plugin-sdk/error-runtime` | Хелпери графа помилок, форматування, спільної класифікації помилок, `isApprovalNotFoundError` |
-    | `plugin-sdk/fetch-runtime` | Обгорнутий fetch, proxy та хелпери pinned lookup |
-    | `plugin-sdk/host-runtime` | Хелпери нормалізації hostname і SCP-host |
-    | `plugin-sdk/retry-runtime` | Хелпери конфігурації retry та запуску retry |
-    | `plugin-sdk/agent-runtime` | Хелпери директорії/ідентичності/робочого простору агента |
-    | `plugin-sdk/directory-runtime` | Запит/дедуплікація директорій на основі конфігурації |
+    | `plugin-sdk/reply-chunking` | Вузькі допоміжні засоби chunking text/markdown |
+    | `plugin-sdk/session-store-runtime` | Допоміжні засоби шляху до session store + updated-at |
+    | `plugin-sdk/state-paths` | Допоміжні засоби шляхів до каталогів state/OAuth |
+    | `plugin-sdk/routing` | Допоміжні засоби route/session-key/прив’язки облікового запису, такі як `resolveAgentRoute`, `buildAgentSessionKey` і `resolveDefaultAgentBoundAccountId` |
+    | `plugin-sdk/status-helpers` | Спільні допоміжні засоби підсумку статусу channel/account, значення за замовчуванням для runtime-state і допоміжні засоби метаданих issue |
+    | `plugin-sdk/target-resolver-runtime` | Спільні допоміжні засоби визначення цілей |
+    | `plugin-sdk/string-normalization-runtime` | Допоміжні засоби нормалізації slug/рядків |
+    | `plugin-sdk/request-url` | Витягує рядкові URL з вхідних даних, подібних до fetch/request |
+    | `plugin-sdk/run-command` | Виконавець команд із таймером і нормалізованими результатами stdout/stderr |
+    | `plugin-sdk/param-readers` | Загальні засоби читання параметрів tool/CLI |
+    | `plugin-sdk/tool-send` | Витягує канонічні поля цілі send з аргументів tool |
+    | `plugin-sdk/temp-path` | Спільні допоміжні засоби шляхів для тимчасових завантажень |
+    | `plugin-sdk/logging-core` | Допоміжні засоби logger підсистеми та редагування чутливих даних |
+    | `plugin-sdk/markdown-table-runtime` | Допоміжні засоби режиму таблиць Markdown |
+    | `plugin-sdk/json-store` | Невеликі допоміжні засоби читання/запису стану JSON |
+    | `plugin-sdk/file-lock` | Допоміжні засоби повторновхідного file-lock |
+    | `plugin-sdk/persistent-dedupe` | Допоміжні засоби dedupe cache із зберіганням на диску |
+    | `plugin-sdk/acp-runtime` | Допоміжні засоби runtime/session ACP і reply-dispatch |
+    | `plugin-sdk/agent-config-primitives` | Вузькі примітиви схеми config runtime агента |
+    | `plugin-sdk/boolean-param` | Гнучкий засіб читання булевих параметрів |
+    | `plugin-sdk/dangerous-name-runtime` | Допоміжні засоби визначення небезпечних назв |
+    | `plugin-sdk/device-bootstrap` | Допоміжні засоби початкового налаштування пристрою та токенів pairing |
+    | `plugin-sdk/extension-shared` | Спільні примітиви допоміжних засобів passive-channel і статусу |
+    | `plugin-sdk/models-provider-runtime` | Допоміжні засоби відповіді для команди `/models`/provider |
+    | `plugin-sdk/skill-commands-runtime` | Допоміжні засоби списку команд Skills |
+    | `plugin-sdk/native-command-registry` | Допоміжні засоби реєстру/build/serialize native команд |
+    | `plugin-sdk/provider-zai-endpoint` | Допоміжні засоби виявлення endpoint Z.AI |
+    | `plugin-sdk/infra-runtime` | Допоміжні засоби системних подій/heartbeat |
+    | `plugin-sdk/collection-runtime` | Невеликі допоміжні засоби обмеженого cache |
+    | `plugin-sdk/diagnostic-runtime` | Допоміжні засоби прапорців і подій діагностики |
+    | `plugin-sdk/error-runtime` | Граф помилок, форматування, спільні допоміжні засоби класифікації помилок, `isApprovalNotFoundError` |
+    | `plugin-sdk/fetch-runtime` | Обгорнуті допоміжні засоби fetch, proxy і pinned lookup |
+    | `plugin-sdk/host-runtime` | Допоміжні засоби нормалізації hostname і SCP host |
+    | `plugin-sdk/retry-runtime` | Допоміжні засоби config retry і виконавця retry |
+    | `plugin-sdk/agent-runtime` | Допоміжні засоби каталогу/ідентичності/workspace агента |
+    | `plugin-sdk/directory-runtime` | Запит/усунення дублікатів каталогів на основі config |
     | `plugin-sdk/keyed-async-queue` | `KeyedAsyncQueue` |
   </Accordion>
 
-  <Accordion title="Підшляхи capability і тестування">
+  <Accordion title="Підшляхи можливостей і тестування">
     | Subpath | Ключові експорти |
     | --- | --- |
-    | `plugin-sdk/media-runtime` | Спільні хелпери отримання/перетворення/збереження медіа плюс збирачі media payload |
-    | `plugin-sdk/media-understanding` | Типи provider для media understanding плюс орієнтовані на provider експорти хелперів зображень/аудіо |
-    | `plugin-sdk/text-runtime` | Спільні хелпери тексту/markdown/logging, такі як видалення видимого для асистента тексту, хелпери render/chunking/table для markdown, хелпери редагування чутливих даних, хелпери тегів directive і утиліти безпечного тексту |
-    | `plugin-sdk/text-chunking` | Хелпер chunking вихідного тексту |
-    | `plugin-sdk/speech` | Типи provider мовлення плюс орієнтовані на provider хелпери directive, registry і validation |
-    | `plugin-sdk/speech-core` | Спільні типи provider мовлення, registry, directive і хелпери нормалізації |
-    | `plugin-sdk/realtime-transcription` | Типи provider транскрипції в реальному часі та хелпери registry |
-    | `plugin-sdk/realtime-voice` | Типи provider голосу в реальному часі та хелпери registry |
-    | `plugin-sdk/image-generation` | Типи provider генерації зображень |
-    | `plugin-sdk/image-generation-core` | Спільні типи генерації зображень, failover, auth і хелпери registry |
-    | `plugin-sdk/music-generation` | Типи provider/request/result для генерації музики |
-    | `plugin-sdk/music-generation-core` | Спільні типи генерації музики, хелпери failover, пошуку provider і розбору model-ref |
-    | `plugin-sdk/video-generation` | Типи provider/request/result для генерації відео |
-    | `plugin-sdk/video-generation-core` | Спільні типи генерації відео, хелпери failover, пошуку provider і розбору model-ref |
-    | `plugin-sdk/webhook-targets` | Реєстр цілей webhook і хелпери встановлення маршрутів |
-    | `plugin-sdk/webhook-path` | Хелпери нормалізації шляху webhook |
-    | `plugin-sdk/web-media` | Спільні хелпери завантаження віддалених/локальних медіа |
+    | `plugin-sdk/media-runtime` | Спільні допоміжні засоби fetch/transform/store для media плюс побудовники payload media |
+    | `plugin-sdk/media-generation-runtime` | Спільні допоміжні засоби failover для media-generation, вибір кандидатів і повідомлення про відсутню модель |
+    | `plugin-sdk/media-understanding` | Типи provider для media understanding плюс експорти допоміжних засобів зображень/аудіо для provider |
+    | `plugin-sdk/text-runtime` | Спільні допоміжні засоби text/markdown/logging, такі як видалення видимого для assistant тексту, допоміжні засоби render/chunking/table для markdown, редагування чутливих даних, допоміжні засоби тегів директив і утиліти безпечного тексту |
+    | `plugin-sdk/text-chunking` | Допоміжний засіб chunking для outbound text |
+    | `plugin-sdk/speech` | Типи speech provider плюс експорти директив, реєстру й валідації для provider |
+    | `plugin-sdk/speech-core` | Спільні типи speech provider, реєстр, директиви та допоміжні засоби нормалізації |
+    | `plugin-sdk/realtime-transcription` | Типи provider для realtime transcription і допоміжні засоби реєстру |
+    | `plugin-sdk/realtime-voice` | Типи provider для realtime voice і допоміжні засоби реєстру |
+    | `plugin-sdk/image-generation` | Типи provider для image generation |
+    | `plugin-sdk/image-generation-core` | Спільні типи image-generation, failover, auth і допоміжні засоби реєстру |
+    | `plugin-sdk/music-generation` | Типи provider/request/result для music generation |
+    | `plugin-sdk/music-generation-core` | Спільні типи music-generation, допоміжні засоби failover, пошуку provider і розбору model-ref |
+    | `plugin-sdk/video-generation` | Типи provider/request/result для video generation |
+    | `plugin-sdk/video-generation-core` | Спільні типи video-generation, допоміжні засоби failover, пошуку provider і розбору model-ref |
+    | `plugin-sdk/webhook-targets` | Допоміжні засоби реєстру цілей webhook і встановлення route |
+    | `plugin-sdk/webhook-path` | Допоміжні засоби нормалізації шляху webhook |
+    | `plugin-sdk/web-media` | Спільні допоміжні засоби завантаження віддалених/локальних media |
     | `plugin-sdk/zod` | Повторно експортований `zod` для споживачів plugin SDK |
     | `plugin-sdk/testing` | `installCommonResolveTargetErrorCases`, `shouldAckReaction` |
   </Accordion>
@@ -253,31 +254,31 @@ import { defineChannelPluginEntry } from "openclaw/plugin-sdk/channel-core";
   <Accordion title="Підшляхи memory">
     | Subpath | Ключові експорти |
     | --- | --- |
-    | `plugin-sdk/memory-core` | Поверхня хелперів bundled memory-core для manager/config/file/CLI |
-    | `plugin-sdk/memory-core-engine-runtime` | Runtime-фасад індексу/пошуку memory |
-    | `plugin-sdk/memory-core-host-engine-foundation` | Експорти foundation engine для memory host |
-    | `plugin-sdk/memory-core-host-engine-embeddings` | Експорти embedding engine для memory host |
-    | `plugin-sdk/memory-core-host-engine-qmd` | Експорти QMD engine для memory host |
-    | `plugin-sdk/memory-core-host-engine-storage` | Експорти storage engine для memory host |
-    | `plugin-sdk/memory-core-host-multimodal` | Мультимодальні хелпери memory host |
-    | `plugin-sdk/memory-core-host-query` | Хелпери query для memory host |
-    | `plugin-sdk/memory-core-host-secret` | Хелпери secret для memory host |
-    | `plugin-sdk/memory-core-host-status` | Хелпери статусу memory host |
-    | `plugin-sdk/memory-core-host-runtime-cli` | Хелпери CLI runtime для memory host |
-    | `plugin-sdk/memory-core-host-runtime-core` | Хелпери core runtime для memory host |
-    | `plugin-sdk/memory-core-host-runtime-files` | Хелпери файлів/runtime для memory host |
-    | `plugin-sdk/memory-lancedb` | Поверхня хелперів bundled memory-lancedb |
+    | `plugin-sdk/memory-core` | Поверхня допоміжних засобів вбудованого memory-core для manager/config/file/CLI helpers |
+    | `plugin-sdk/memory-core-engine-runtime` | Runtime facade індексу/пошуку memory |
+    | `plugin-sdk/memory-core-host-engine-foundation` | Експорти foundation engine для хоста memory |
+    | `plugin-sdk/memory-core-host-engine-embeddings` | Експорти embedding engine для хоста memory |
+    | `plugin-sdk/memory-core-host-engine-qmd` | Експорти QMD engine для хоста memory |
+    | `plugin-sdk/memory-core-host-engine-storage` | Експорти storage engine для хоста memory |
+    | `plugin-sdk/memory-core-host-multimodal` | Допоміжні засоби multimodal для хоста memory |
+    | `plugin-sdk/memory-core-host-query` | Допоміжні засоби query для хоста memory |
+    | `plugin-sdk/memory-core-host-secret` | Допоміжні засоби secret для хоста memory |
+    | `plugin-sdk/memory-core-host-status` | Допоміжні засоби status для хоста memory |
+    | `plugin-sdk/memory-core-host-runtime-cli` | Допоміжні засоби CLI runtime для хоста memory |
+    | `plugin-sdk/memory-core-host-runtime-core` | Допоміжні засоби core runtime для хоста memory |
+    | `plugin-sdk/memory-core-host-runtime-files` | Допоміжні засоби file/runtime для хоста memory |
+    | `plugin-sdk/memory-lancedb` | Поверхня допоміжних засобів вбудованого memory-lancedb |
   </Accordion>
 
-  <Accordion title="Зарезервовані підшляхи вбудованих хелперів">
-    | Family | Поточні підшляхи | Призначене використання |
+  <Accordion title="Зарезервовані допоміжні підшляхи для вбудованих компонентів">
+    | Family | Поточні підшляхи | Призначення |
     | --- | --- | --- |
-    | Browser | `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support` | Хелпери підтримки bundled browser plugin (`browser-support` залишається barrel-файлом сумісності) |
-    | Matrix | `plugin-sdk/matrix`, `plugin-sdk/matrix-helper`, `plugin-sdk/matrix-runtime-heavy`, `plugin-sdk/matrix-runtime-shared`, `plugin-sdk/matrix-runtime-surface`, `plugin-sdk/matrix-surface`, `plugin-sdk/matrix-thread-bindings` | Поверхня хелперів/runtime для bundled Matrix |
-    | Line | `plugin-sdk/line`, `plugin-sdk/line-core`, `plugin-sdk/line-runtime`, `plugin-sdk/line-surface` | Поверхня хелперів/runtime для bundled LINE |
-    | IRC | `plugin-sdk/irc`, `plugin-sdk/irc-surface` | Поверхня хелперів для bundled IRC |
-    | Хелпери, специфічні для channel | `plugin-sdk/googlechat`, `plugin-sdk/zalouser`, `plugin-sdk/bluebubbles`, `plugin-sdk/bluebubbles-policy`, `plugin-sdk/mattermost`, `plugin-sdk/mattermost-policy`, `plugin-sdk/feishu-conversation`, `plugin-sdk/msteams`, `plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/tlon`, `plugin-sdk/twitch` | Шви сумісності/хелперів для вбудованих channel |
-    | Хелпери, специфічні для auth/plugin | `plugin-sdk/github-copilot-login`, `plugin-sdk/github-copilot-token`, `plugin-sdk/diagnostics-otel`, `plugin-sdk/diffs`, `plugin-sdk/llm-task`, `plugin-sdk/thread-ownership`, `plugin-sdk/voice-call` | Шви хелперів для вбудованих функцій/plugins; `plugin-sdk/github-copilot-token` наразі експортує `DEFAULT_COPILOT_API_BASE_URL`, `deriveCopilotApiBaseUrlFromToken` і `resolveCopilotApiToken` |
+    | Browser | `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support` | Допоміжні засоби підтримки вбудованого browser plugin (`browser-support` залишається barrel-файлом сумісності) |
+    | Matrix | `plugin-sdk/matrix`, `plugin-sdk/matrix-helper`, `plugin-sdk/matrix-runtime-heavy`, `plugin-sdk/matrix-runtime-shared`, `plugin-sdk/matrix-runtime-surface`, `plugin-sdk/matrix-surface`, `plugin-sdk/matrix-thread-bindings` | Поверхня допоміжних засобів/runtime для вбудованого Matrix |
+    | Line | `plugin-sdk/line`, `plugin-sdk/line-core`, `plugin-sdk/line-runtime`, `plugin-sdk/line-surface` | Поверхня допоміжних засобів/runtime для вбудованого LINE |
+    | IRC | `plugin-sdk/irc`, `plugin-sdk/irc-surface` | Поверхня допоміжних засобів для вбудованого IRC |
+    | Специфічні для channel helpers | `plugin-sdk/googlechat`, `plugin-sdk/zalouser`, `plugin-sdk/bluebubbles`, `plugin-sdk/bluebubbles-policy`, `plugin-sdk/mattermost`, `plugin-sdk/mattermost-policy`, `plugin-sdk/feishu-conversation`, `plugin-sdk/msteams`, `plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/tlon`, `plugin-sdk/twitch` | Шви сумісності/допоміжні шви для вбудованих channels |
+    | Специфічні для auth/plugin helpers | `plugin-sdk/github-copilot-login`, `plugin-sdk/github-copilot-token`, `plugin-sdk/diagnostics-otel`, `plugin-sdk/diffs`, `plugin-sdk/llm-task`, `plugin-sdk/thread-ownership`, `plugin-sdk/voice-call` | Допоміжні шви для вбудованих features/plugins; `plugin-sdk/github-copilot-token` наразі експортує `DEFAULT_COPILOT_API_BASE_URL`, `deriveCopilotApiBaseUrlFromToken` і `resolveCopilotApiToken` |
   </Accordion>
 </AccordionGroup>
 
@@ -286,56 +287,56 @@ import { defineChannelPluginEntry } from "openclaw/plugin-sdk/channel-core";
 Зворотний виклик `register(api)` отримує об’єкт `OpenClawPluginApi` з такими
 методами:
 
-### Реєстрація capability
+### Реєстрація можливостей
 
-| Method                                           | Що реєструє                     |
-| ------------------------------------------------ | ------------------------------- |
-| `api.registerProvider(...)`                      | Текстовий inference (LLM)       |
-| `api.registerChannel(...)`                       | Messaging channel               |
-| `api.registerSpeechProvider(...)`                | Синтез text-to-speech / STT     |
-| `api.registerRealtimeTranscriptionProvider(...)` | Потокова транскрипція в реальному часі |
-| `api.registerRealtimeVoiceProvider(...)`         | Дуплексні голосові сесії в реальному часі |
-| `api.registerMediaUnderstandingProvider(...)`    | Аналіз зображень/аудіо/відео    |
-| `api.registerImageGenerationProvider(...)`       | Генерація зображень             |
-| `api.registerMusicGenerationProvider(...)`       | Генерація музики                |
-| `api.registerVideoGenerationProvider(...)`       | Генерація відео                 |
-| `api.registerWebFetchProvider(...)`              | Provider web fetch / scrape     |
-| `api.registerWebSearchProvider(...)`             | Web search                      |
+| Method                                           | Що реєструє                    |
+| ------------------------------------------------ | ------------------------------ |
+| `api.registerProvider(...)`                      | Текстовий inference (LLM)      |
+| `api.registerChannel(...)`                       | Канал повідомлень              |
+| `api.registerSpeechProvider(...)`                | Синтез text-to-speech / STT    |
+| `api.registerRealtimeTranscriptionProvider(...)` | Потокова транскрипція realtime |
+| `api.registerRealtimeVoiceProvider(...)`         | Дуплексні сесії voice realtime |
+| `api.registerMediaUnderstandingProvider(...)`    | Аналіз зображень/аудіо/відео   |
+| `api.registerImageGenerationProvider(...)`       | Генерація зображень            |
+| `api.registerMusicGenerationProvider(...)`       | Генерація музики               |
+| `api.registerVideoGenerationProvider(...)`       | Генерація відео                |
+| `api.registerWebFetchProvider(...)`              | Provider для web fetch / scrape |
+| `api.registerWebSearchProvider(...)`             | Вебпошук                       |
 
 ### Tools і команди
 
-| Method                          | Що реєструє                                  |
-| ------------------------------- | -------------------------------------------- |
+| Method                          | Що реєструє                                   |
+| ------------------------------- | --------------------------------------------- |
 | `api.registerTool(tool, opts?)` | Tool агента (обов’язковий або `{ optional: true }`) |
-| `api.registerCommand(def)`      | Користувацьку команду (оминає LLM)           |
+| `api.registerCommand(def)`      | Користувацька команда (обходить LLM)          |
 
 ### Інфраструктура
 
 | Method                                         | Що реєструє          |
 | ---------------------------------------------- | -------------------- |
-| `api.registerHook(events, handler, opts?)`     | Hook подій           |
+| `api.registerHook(events, handler, opts?)`     | Хук події            |
 | `api.registerHttpRoute(params)`                | HTTP endpoint gateway |
 | `api.registerGatewayMethod(name, handler)`     | RPC-метод gateway    |
-| `api.registerCli(registrar, opts?)`            | Підкоманду CLI       |
-| `api.registerService(service)`                 | Фоновий сервіс       |
-| `api.registerInteractiveHandler(registration)` | Interactive handler  |
+| `api.registerCli(registrar, opts?)`            | Підкоманда CLI       |
+| `api.registerService(service)`                 | Фонова служба        |
+| `api.registerInteractiveHandler(registration)` | Інтерактивний handler |
 
 Зарезервовані простори імен адміністрування core (`config.*`, `exec.approvals.*`, `wizard.*`,
 `update.*`) завжди залишаються `operator.admin`, навіть якщо plugin намагається призначити
-вужчу область gateway method. Для методів, що належать plugin,
-використовуйте префікси, специфічні для plugin.
+вужчу область gateway method. Для
+методів, що належать plugin, віддавайте перевагу специфічним для plugin префіксам.
 
 ### Метадані реєстрації CLI
 
-`api.registerCli(registrar, opts?)` приймає два види метаданих верхнього рівня:
+`api.registerCli(registrar, opts?)` приймає два типи метаданих верхнього рівня:
 
-- `commands`: явні корені команд, якими володіє registrar
-- `descriptors`: дескриптори команд для етапу парсингу, які використовуються для довідки кореневого CLI,
-  маршрутизації та лінивої реєстрації CLI plugin
+- `commands`: явні корені команд, що належать registrar
+- `descriptors`: дескриптори команд на етапі розбору, що використовуються для довідки кореневого CLI,
+  маршрутизації та лінивої реєстрації plugin CLI
 
-Якщо ви хочете, щоб команда plugin залишалася ліниво завантажуваною у звичайному кореневому шляху CLI,
-надайте `descriptors`, які охоплюють кожен корінь команди верхнього рівня, що експонує
-цей registrar.
+Якщо ви хочете, щоб команда plugin залишалася ліниво завантажуваною в звичайному шляху кореневого CLI,
+надайте `descriptors`, які охоплюють кожен корінь команди верхнього рівня, що експонується цим
+registrar.
 
 ```typescript
 api.registerCli(
@@ -355,67 +356,67 @@ api.registerCli(
 );
 ```
 
-Використовуйте `commands` окремо лише тоді, коли вам не потрібна лінива реєстрація кореневого CLI.
-Цей eager-шлях сумісності залишається підтримуваним, але він не встановлює
-placeholders на основі descriptor для лінивого завантаження під час парсингу.
+Використовуйте лише `commands`, тільки якщо вам не потрібна лінива реєстрація кореневого CLI.
+Цей шлях сумісності з eager-завантаженням залишається підтримуваним, але він не встановлює
+заповнювачі на основі descriptor для лінивого завантаження під час розбору.
 
 ### Ексклюзивні слоти
 
-| Method                                     | Що реєструє                          |
-| ------------------------------------------ | ------------------------------------ |
-| `api.registerContextEngine(id, factory)`   | Context engine (одночасно активний лише один) |
-| `api.registerMemoryPromptSection(builder)` | Збирач секції prompt для memory      |
-| `api.registerMemoryFlushPlan(resolver)`    | Resolver плану flush для memory      |
-| `api.registerMemoryRuntime(runtime)`       | Адаптер runtime для memory           |
+| Method                                     | Що реєструє                         |
+| ------------------------------------------ | ----------------------------------- |
+| `api.registerContextEngine(id, factory)`   | Context engine (лише один активний одночасно) |
+| `api.registerMemoryPromptSection(builder)` | Побудовник секції prompt для memory |
+| `api.registerMemoryFlushPlan(resolver)`    | Resolver плану flush для memory     |
+| `api.registerMemoryRuntime(runtime)`       | Адаптер runtime для memory          |
 
-### Адаптери memory embedding
+### Адаптери embedding для memory
 
 | Method                                         | Що реєструє                                     |
 | ---------------------------------------------- | ----------------------------------------------- |
-| `api.registerMemoryEmbeddingProvider(adapter)` | Адаптер memory embedding для активного plugin   |
+| `api.registerMemoryEmbeddingProvider(adapter)` | Адаптер embedding для memory для активного plugin |
 
 - `registerMemoryPromptSection`, `registerMemoryFlushPlan` і
-  `registerMemoryRuntime` ексклюзивні для plugins memory.
-- `registerMemoryEmbeddingProvider` дозволяє активному plugin memory зареєструвати один
-  або кілька ID адаптерів embedding (наприклад, `openai`, `gemini` або користувацький
-  ID, визначений plugin).
+  `registerMemoryRuntime` є ексклюзивними для memory plugins.
+- `registerMemoryEmbeddingProvider` дає активному memory plugin змогу зареєструвати один
+  або кілька id адаптерів embedding (наприклад `openai`, `gemini` або користувацький
+  id, визначений plugin).
 - Конфігурація користувача, така як `agents.defaults.memorySearch.provider` і
-  `agents.defaults.memorySearch.fallback`, визначається відносно цих зареєстрованих
-  ID адаптерів.
+  `agents.defaults.memorySearch.fallback`, визначається відносно зареєстрованих id
+  цих адаптерів.
 
 ### Події та життєвий цикл
 
 | Method                                       | Що робить                    |
 | -------------------------------------------- | ---------------------------- |
-| `api.on(hookName, handler, opts?)`           | Типізований hook життєвого циклу |
-| `api.onConversationBindingResolved(handler)` | Зворотний виклик прив’язки розмови |
+| `api.on(hookName, handler, opts?)`           | Типізований хук життєвого циклу |
+| `api.onConversationBindingResolved(handler)` | Зворотний виклик прив’язки conversation |
 
-### Семантика рішень hook
+### Семантика рішень хуків
 
-- `before_tool_call`: повернення `{ block: true }` є термінальним. Щойно будь-який handler встановлює це значення, handlers із нижчим пріоритетом пропускаються.
-- `before_tool_call`: повернення `{ block: false }` вважається відсутністю рішення (так само, як пропуск `block`), а не перевизначенням.
-- `before_install`: повернення `{ block: true }` є термінальним. Щойно будь-який handler встановлює це значення, handlers із нижчим пріоритетом пропускаються.
-- `before_install`: повернення `{ block: false }` вважається відсутністю рішення (так само, як пропуск `block`), а не перевизначенням.
-- `reply_dispatch`: повернення `{ handled: true, ... }` є термінальним. Щойно будь-який handler бере dispatch на себе, handlers із нижчим пріоритетом і стандартний шлях dispatch моделі пропускаються.
-- `message_sending`: повернення `{ cancel: true }` є термінальним. Щойно будь-який handler встановлює це значення, handlers із нижчим пріоритетом пропускаються.
-- `message_sending`: повернення `{ cancel: false }` вважається відсутністю рішення (так само, як пропуск `cancel`), а не перевизначенням.
+- `before_tool_call`: повернення `{ block: true }` є термінальним. Щойно будь-який handler встановлює його, handlers із нижчим пріоритетом пропускаються.
+- `before_tool_call`: повернення `{ block: false }` вважається відсутністю рішення (так само, як і пропуск `block`), а не перевизначенням.
+- `before_install`: повернення `{ block: true }` є термінальним. Щойно будь-який handler встановлює його, handlers із нижчим пріоритетом пропускаються.
+- `before_install`: повернення `{ block: false }` вважається відсутністю рішення (так само, як і пропуск `block`), а не перевизначенням.
+- `reply_dispatch`: повернення `{ handled: true, ... }` є термінальним. Щойно будь-який handler перехоплює dispatch, handlers із нижчим пріоритетом і типовий шлях dispatch моделі пропускаються.
+- `message_sending`: повернення `{ cancel: true }` є термінальним. Щойно будь-який handler встановлює його, handlers із нижчим пріоритетом пропускаються.
+- `message_sending`: повернення `{ cancel: false }` вважається відсутністю рішення (так само, як і пропуск `cancel`), а не перевизначенням.
 
 ### Поля об’єкта API
 
-| Field                    | Type                      | Опис                                                                                       |
-| ------------------------ | ------------------------- | ------------------------------------------------------------------------------------------ |
-| `api.id`                 | `string`                  | ID plugin                                                                                  |
-| `api.name`               | `string`                  | Відображувана назва                                                                        |
-| `api.version`            | `string?`                 | Версія plugin (необов’язково)                                                              |
-| `api.description`        | `string?`                 | Опис plugin (необов’язково)                                                                |
-| `api.source`             | `string`                  | Шлях до джерела plugin                                                                     |
-| `api.rootDir`            | `string?`                 | Коренева директорія plugin (необов’язково)                                                 |
-| `api.config`             | `OpenClawConfig`          | Поточний знімок конфігурації (активний знімок runtime у пам’яті, коли доступний)          |
-| `api.pluginConfig`       | `Record<string, unknown>` | Конфігурація plugin із `plugins.entries.<id>.config`                                       |
-| `api.runtime`            | `PluginRuntime`           | [Хелпери runtime](/uk/plugins/sdk-runtime)                                                    |
-| `api.logger`             | `PluginLogger`            | Logger з областю видимості (`debug`, `info`, `warn`, `error`)                              |
-| `api.registrationMode`   | `PluginRegistrationMode`  | Поточний режим завантаження; `"setup-runtime"` — це легке вікно запуску/налаштування до повного входу |
-| `api.resolvePath(input)` | `(string) => string`      | Визначення шляху відносно кореня plugin                                                    |
+| Field                    | Type                      | Опис                                                                                         |
+| ------------------------ | ------------------------- | -------------------------------------------------------------------------------------------- |
+| `api.id`                 | `string`                  | Ідентифікатор plugin                                                                         |
+| `api.name`               | `string`                  | Відображувана назва                                                                          |
+| `api.version`            | `string?`                 | Версія plugin (необов’язково)                                                                |
+| `api.description`        | `string?`                 | Опис plugin (необов’язково)                                                                  |
+| `api.source`             | `string`                  | Шлях до джерела plugin                                                                       |
+| `api.rootDir`            | `string?`                 | Кореневий каталог plugin (необов’язково)                                                     |
+| `api.config`             | `OpenClawConfig`          | Поточний знімок config (активний внутрішньопам’ятний runtime-знімок, коли доступний)        |
+| `api.pluginConfig`       | `Record<string, unknown>` | Специфічна для plugin config із `plugins.entries.<id>.config`                               |
+| `api.runtime`            | `PluginRuntime`           | [Допоміжні засоби runtime](/uk/plugins/sdk-runtime)                                             |
+| `api.logger`             | `PluginLogger`            | Logger з областю дії (`debug`, `info`, `warn`, `error`)                                      |
+| `api.registrationMode`   | `PluginRegistrationMode`  | Поточний режим завантаження; `"setup-runtime"` — це легке вікно запуску/налаштування до повного entry |
+| `api.resolvePath(input)` | `(string) => string`      | Визначення шляху відносно кореня plugin                                                      |
 
 ## Угода щодо внутрішніх модулів
 
@@ -426,46 +427,46 @@ my-plugin/
   api.ts            # Публічні експорти для зовнішніх споживачів
   runtime-api.ts    # Лише внутрішні runtime-експорти
   index.ts          # Точка входу plugin
-  setup-entry.ts    # Легка точка входу лише для налаштування (необов’язково)
+  setup-entry.ts    # Полегшений entry лише для налаштування (необов’язково)
 ```
 
 <Warning>
   Ніколи не імпортуйте власний plugin через `openclaw/plugin-sdk/<your-plugin>`
-  з production-коду. Спрямовуйте внутрішні імпорти через `./api.ts` або
-  `./runtime-api.ts`. Шлях SDK — це лише зовнішній контракт.
+  у production-коді. Спрямовуйте внутрішні імпорти через `./api.ts` або
+  `./runtime-api.ts`. Шлях SDK є лише зовнішнім контрактом.
 </Warning>
 
-Публічні поверхні вбудованих plugins, завантажені через facade (`api.ts`, `runtime-api.ts`,
-`index.ts`, `setup-entry.ts` та подібні публічні entry-файли), тепер надають перевагу
-активному знімку runtime-конфігурації, коли OpenClaw уже запущено. Якщо знімок runtime
-ще не існує, вони повертаються до визначеного файлу конфігурації на диску.
+Поверхні публічних API вбудованих plugins, завантажені через facade (`api.ts`, `runtime-api.ts`,
+`index.ts`, `setup-entry.ts` та подібні публічні entry-файли), тепер віддають перевагу
+активному знімку runtime config, коли OpenClaw уже запущено. Якщо знімок runtime
+ще не існує, вони повертаються до визначеного файлу config на диску.
 
-Provider plugins також можуть експонувати вузький локальний для plugin barrel-контракт, коли
-хелпер навмисно є специфічним для provider і ще не належить до загального
-підшляху SDK. Поточний вбудований приклад: provider Anthropic тримає свої Claude
-stream-хелпери у власному публічному шві `api.ts` / `contract-api.ts`, замість того
-щоб просувати логіку Anthropic beta-header і `service_tier` у загальний
-контракт `plugin-sdk/*`.
+Plugins provider також можуть експонувати вузький локальний barrel-файл контракту plugin, коли
+допоміжний засіб навмисно є специфічним для provider і ще не належить до загального підшляху SDK.
+Поточний вбудований приклад: provider Anthropic зберігає свої допоміжні засоби Claude
+stream у власному публічному шві `api.ts` / `contract-api.ts`, замість того щоб
+просувати логіку Anthropic beta-header і `service_tier` до загального
+контракту `plugin-sdk/*`.
 
 Інші поточні вбудовані приклади:
 
-- `@openclaw/openai-provider`: `api.ts` експортує збирачі provider,
-  хелпери моделей за замовчуванням і збирачі provider для realtime
-- `@openclaw/openrouter-provider`: `api.ts` експортує збирач provider плюс
-  хелпери онбордингу/конфігурації
+- `@openclaw/openai-provider`: `api.ts` експортує побудовники provider,
+  допоміжні засоби моделей за замовчуванням і побудовники provider realtime
+- `@openclaw/openrouter-provider`: `api.ts` експортує побудовник provider, а також
+  допоміжні засоби онбордингу/config
 
 <Warning>
   Production-код extension також має уникати імпортів `openclaw/plugin-sdk/<other-plugin>`.
-  Якщо хелпер справді спільний, винесіть його в нейтральний підшлях SDK,
-  такий як `openclaw/plugin-sdk/speech`, `.../provider-model-shared` або іншу
-  поверхню, орієнтовану на capability, замість зв’язування двох plugins між собою.
+  Якщо допоміжний засіб справді є спільним, перемістіть його до нейтрального підшляху SDK,
+  такого як `openclaw/plugin-sdk/speech`, `.../provider-model-shared` або іншої
+  поверхні, орієнтованої на можливості, замість того щоб жорстко зв’язувати два plugins між собою.
 </Warning>
 
 ## Пов’язане
 
-- [Entry Points](/uk/plugins/sdk-entrypoints) — параметри `definePluginEntry` і `defineChannelPluginEntry`
-- [Runtime Helpers](/uk/plugins/sdk-runtime) — повний довідник простору імен `api.runtime`
-- [Setup and Config](/uk/plugins/sdk-setup) — пакування, маніфести, схеми конфігурації
-- [Testing](/uk/plugins/sdk-testing) — утиліти тестування та правила lint
-- [SDK Migration](/uk/plugins/sdk-migration) — міграція із застарілих поверхонь
-- [Plugin Internals](/uk/plugins/architecture) — поглиблена архітектура та модель capability
+- [Точки входу](/uk/plugins/sdk-entrypoints) — параметри `definePluginEntry` і `defineChannelPluginEntry`
+- [Допоміжні засоби runtime](/uk/plugins/sdk-runtime) — повний довідник простору імен `api.runtime`
+- [Налаштування і config](/uk/plugins/sdk-setup) — пакування, маніфести, схеми config
+- [Тестування](/uk/plugins/sdk-testing) — утиліти тестування та правила lint
+- [Міграція SDK](/uk/plugins/sdk-migration) — міграція із застарілих поверхонь
+- [Внутрішня будова plugin](/uk/plugins/architecture) — глибока архітектура та модель можливостей

docs/uk/tools/image-generation.md

@@ -1,30 +1,30 @@
 ---
 read_when:
-    - Генерування зображень через агента
+    - Створення зображень через агента
     - Налаштування провайдерів і моделей для генерації зображень
     - Розуміння параметрів інструмента image_generate
 summary: Створюйте та редагуйте зображення за допомогою налаштованих провайдерів (OpenAI, Google Gemini, fal, MiniMax, ComfyUI, Vydra)
 title: Генерація зображень
 x-i18n:
-    generated_at: "2026-04-06T01:23:49Z"
+    generated_at: "2026-04-06T03:19:54Z"
     model: gpt-5.4
     provider: openai
-    source_hash: dde416dd1441a06605db85b5813cf61ccfc525813d6db430b7b7dfa53d6a3134
+    source_hash: 903cc522c283a8da2cbd449ae3e25f349a74d00ecfdaf0f323fd8aa3f2107aea
     source_path: tools/image-generation.md
     workflow: 15
 ---
 
 # Генерація зображень
 
-Інструмент `image_generate` дає змогу агенту створювати й редагувати зображення за допомогою ваших налаштованих провайдерів. Згенеровані зображення автоматично доставляються як медіавкладення у відповіді агента.
+Інструмент `image_generate` дає агенту змогу створювати та редагувати зображення за допомогою ваших налаштованих провайдерів. Створені зображення автоматично доставляються як медіавкладення у відповіді агента.
 
 <Note>
-Інструмент з’являється лише тоді, коли доступний щонайменше один провайдер генерації зображень. Якщо ви не бачите `image_generate` серед інструментів вашого агента, налаштуйте `agents.defaults.imageGenerationModel` або задайте API-ключ провайдера.
+Інструмент з’являється лише тоді, коли доступний принаймні один провайдер генерації зображень. Якщо ви не бачите `image_generate` серед інструментів свого агента, налаштуйте `agents.defaults.imageGenerationModel` або задайте API-ключ провайдера.
 </Note>
 
-## Швидкий початок
+## Швидкий старт
 
-1. Установіть API-ключ щонайменше для одного провайдера (наприклад, `OPENAI_API_KEY` або `GEMINI_API_KEY`).
+1. Задайте API-ключ принаймні для одного провайдера (наприклад, `OPENAI_API_KEY` або `GEMINI_API_KEY`).
 2. За бажанням задайте бажану модель:
 
 ```json5
@@ -41,7 +41,7 @@ x-i18n:
 
 3. Попросіть агента: _"Згенеруй зображення дружнього маскота-лобстера."_
 
-Агент автоматично викликає `image_generate`. Додавати інструмент до allowlist не потрібно — його ввімкнено за замовчуванням, коли доступний провайдер.
+Агент автоматично викликає `image_generate`. Дозвільний список інструментів не потрібен — інструмент увімкнено за замовчуванням, коли доступний провайдер.
 
 ## Підтримувані провайдери
 
@@ -50,11 +50,11 @@ x-i18n:
 | OpenAI    | `gpt-image-1`                    | Так (до 5 зображень)               | `OPENAI_API_KEY`                                      |
 | Google    | `gemini-3.1-flash-image-preview` | Так                                | `GEMINI_API_KEY` або `GOOGLE_API_KEY`                 |
 | fal       | `fal-ai/flux/dev`                | Так                                | `FAL_KEY`                                             |
-| MiniMax   | `image-01`                       | Так (посилання на об’єкт)          | `MINIMAX_API_KEY` або MiniMax OAuth (`minimax-portal`) |
+| MiniMax   | `image-01`                       | Так (референс об’єкта)             | `MINIMAX_API_KEY` або MiniMax OAuth (`minimax-portal`) |
 | ComfyUI   | `workflow`                       | Так (1 зображення, налаштовується workflow) | `COMFY_API_KEY` або `COMFY_CLOUD_API_KEY` для хмари   |
 | Vydra     | `grok-imagine`                   | Ні                                 | `VYDRA_API_KEY`                                       |
 
-Використовуйте `action: "list"`, щоб переглянути доступні провайдери й моделі під час виконання:
+Використайте `action: "list"`, щоб переглянути доступні провайдери та моделі під час виконання:
 
 ```
 /tool image_generate action=list
@@ -62,22 +62,22 @@ x-i18n:
 
 ## Параметри інструмента
 
-| Параметр     | Тип      | Опис                                                                                  |
-| ------------ | -------- | ------------------------------------------------------------------------------------- |
-| `prompt`     | string   | Запит для генерації зображення (обов’язковий для `action: "generate"`)                |
-| `action`     | string   | `"generate"` (типово) або `"list"` для перегляду провайдерів                          |
-| `model`      | string   | Перевизначення провайдера/моделі, наприклад `openai/gpt-image-1`                      |
-| `image`      | string   | Шлях або URL одного еталонного зображення для режиму редагування                      |
-| `images`     | string[] | Кілька еталонних зображень для режиму редагування (до 5)                              |
-| `size`       | string   | Підказка щодо розміру: `1024x1024`, `1536x1024`, `1024x1536`, `1024x1792`, `1792x1024` |
-| `aspectRatio`| string   | Співвідношення сторін: `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9` |
-| `resolution` | string   | Підказка щодо роздільної здатності: `1K`, `2K` або `4K`                               |
-| `count`      | number   | Кількість зображень для генерації (1–4)                                               |
-| `filename`   | string   | Підказка для імені вихідного файлу                                                    |
+| Параметр      | Тип      | Опис                                                                                  |
+| ------------- | -------- | ------------------------------------------------------------------------------------- |
+| `prompt`      | string   | Запит для генерації зображення (обов’язковий для `action: "generate"`)                |
+| `action`      | string   | `"generate"` (за замовчуванням) або `"list"` для перегляду провайдерів                |
+| `model`       | string   | Перевизначення провайдера/моделі, наприклад `openai/gpt-image-1`                      |
+| `image`       | string   | Шлях або URL одного референсного зображення для режиму редагування                    |
+| `images`      | string[] | Кілька референсних зображень для режиму редагування (до 5)                            |
+| `size`        | string   | Підказка щодо розміру: `1024x1024`, `1536x1024`, `1024x1536`, `1024x1792`, `1792x1024` |
+| `aspectRatio` | string   | Співвідношення сторін: `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9` |
+| `resolution`  | string   | Підказка щодо роздільної здатності: `1K`, `2K` або `4K`                               |
+| `count`       | number   | Кількість зображень для генерації (1–4)                                               |
+| `filename`    | string   | Підказка щодо імені вихідного файла                                                   |
 
 Не всі провайдери підтримують усі параметри. Інструмент передає те, що підтримує кожен провайдер, ігнорує решту та повідомляє про відкинуті перевизначення в результаті інструмента.
 
-## Налаштування
+## Конфігурація
 
 ### Вибір моделі
 
@@ -94,57 +94,59 @@ x-i18n:
 }
 ```
 
-### Порядок вибору провайдерів
+### Порядок вибору провайдера
 
 Під час генерації зображення OpenClaw пробує провайдерів у такому порядку:
 
 1. Параметр **`model`** з виклику інструмента (якщо агент його вказує)
-2. **`imageGenerationModel.primary`** з конфігурації
-3. **`imageGenerationModel.fallbacks`** у заданому порядку
+2. **`imageGenerationModel.primary`** із конфігурації
+3. **`imageGenerationModel.fallbacks`** у вказаному порядку
 4. **Автовиявлення** — використовує лише типові значення провайдерів, підкріплені автентифікацією:
    - спочатку поточний провайдер за замовчуванням
-   - далі решта зареєстрованих провайдерів генерації зображень у порядку `provider-id`
+   - далі решта зареєстрованих провайдерів генерації зображень у порядку ідентифікаторів провайдерів
 
-Якщо провайдер не спрацьовує (помилка автентифікації, ліміт запитів тощо), автоматично пробується наступний кандидат. Якщо не спрацьовують усі, помилка містить подробиці кожної спроби.
+Якщо провайдер не спрацьовує (помилка автентифікації, обмеження швидкості тощо), автоматично пробується наступний кандидат. Якщо не спрацьовують усі, помилка містить подробиці кожної спроби.
 
 Примітки:
 
-- Автовиявлення враховує автентифікацію. Типове значення провайдера потрапляє до списку кандидатів лише тоді, коли OpenClaw справді може автентифікувати цей провайдер.
-- Використовуйте `action: "list"`, щоб переглянути поточні зареєстровані провайдери, їхні типові моделі та підказки щодо змінних середовища для автентифікації.
+- Автовиявлення враховує автентифікацію. Типове значення провайдера потрапляє до списку кандидатів лише тоді,
+  коли OpenClaw справді може автентифікувати цей провайдер.
+- Використайте `action: "list"`, щоб переглянути поточно зареєстрованих провайдерів, їхні
+  моделі за замовчуванням і підказки щодо змінних середовища для автентифікації.
 
 ### Редагування зображень
 
-OpenAI, Google, fal, MiniMax і ComfyUI підтримують редагування еталонних зображень. Передайте шлях або URL еталонного зображення:
+OpenAI, Google, fal, MiniMax і ComfyUI підтримують редагування референсних зображень. Передайте шлях або URL референсного зображення:
 
 ```
-"Створи акварельну версію цього фото" + image: "/path/to/photo.jpg"
+"Згенеруй акварельну версію цього фото" + image: "/path/to/photo.jpg"
 ```
 
-OpenAI і Google підтримують до 5 еталонних зображень через параметр `images`. fal, MiniMax і ComfyUI підтримують 1.
+OpenAI і Google підтримують до 5 референсних зображень через параметр `images`. fal, MiniMax і ComfyUI підтримують 1.
 
 Генерація зображень MiniMax доступна через обидва вбудовані шляхи автентифікації MiniMax:
 
-- `minimax/image-01` для налаштувань з API-ключем
-- `minimax-portal/image-01` для налаштувань з OAuth
+- `minimax/image-01` для конфігурацій з API-ключем
+- `minimax-portal/image-01` для конфігурацій з OAuth
 
 ## Можливості провайдерів
 
-| Можливість            | OpenAI               | Google               | fal                 | MiniMax                    | ComfyUI                            | Vydra |
-| --------------------- | -------------------- | -------------------- | ------------------- | -------------------------- | ---------------------------------- | ----- |
-| Генерація             | Так (до 4)           | Так (до 4)           | Так (до 4)          | Так (до 9)                 | Так (результати визначаються workflow) | Так (1) |
-| Редагування/еталон    | Так (до 5 зображень) | Так (до 5 зображень) | Так (1 зображення)  | Так (1 зображення, посилання на об’єкт) | Так (1 зображення, налаштовується workflow) | Ні |
-| Керування розміром    | Так                  | Так                  | Так                 | Ні                         | Ні                                 | Ні |
-| Співвідношення сторін | Ні                   | Так                  | Так (лише генерація) | Так                        | Ні                                 | Ні |
-| Роздільна здатність (1K/2K/4K) | Ні         | Так                  | Так                 | Ні                         | Ні                                 | Ні |
+| Можливість            | OpenAI               | Google               | fal                 | MiniMax                    | ComfyUI                            | Vydra   |
+| --------------------- | -------------------- | -------------------- | ------------------- | -------------------------- | ---------------------------------- | ------- |
+| Генерація             | Так (до 4)           | Так (до 4)           | Так (до 4)          | Так (до 9)                 | Так (виходи визначаються workflow) | Так (1) |
+| Редагування/референс  | Так (до 5 зображень) | Так (до 5 зображень) | Так (1 зображення)  | Так (1 зображення, референс об’єкта) | Так (1 зображення, налаштовується workflow) | Ні      |
+| Керування розміром    | Так                  | Так                  | Так                 | Ні                         | Ні                                 | Ні      |
+| Співвідношення сторін | Ні                   | Так                  | Так (лише генерація) | Так                       | Ні                                 | Ні      |
+| Роздільна здатність (1K/2K/4K) | Ні         | Так                  | Так                 | Ні                         | Ні                                 | Ні      |
 
 ## Пов’язане
 
 - [Огляд інструментів](/uk/tools) — усі доступні інструменти агента
 - [fal](/uk/providers/fal) — налаштування провайдера зображень і відео fal
-- [ComfyUI](/uk/providers/comfy) — налаштування локального ComfyUI і Comfy Cloud workflow
+- [ComfyUI](/uk/providers/comfy) — налаштування локального ComfyUI і workflow Comfy Cloud
 - [Google (Gemini)](/uk/providers/google) — налаштування провайдера зображень Gemini
 - [MiniMax](/uk/providers/minimax) — налаштування провайдера зображень MiniMax
 - [OpenAI](/uk/providers/openai) — налаштування провайдера OpenAI Images
-- [Vydra](/providers/vydra) — налаштування зображень, відео та мовлення Vydra
-- [Довідник із конфігурації](/uk/gateway/configuration-reference#agent-defaults) — конфігурація `imageGenerationModel`
+- [Vydra](/uk/providers/vydra) — налаштування зображень, відео та мовлення Vydra
+- [Довідник з конфігурації](/uk/gateway/configuration-reference#agent-defaults) — конфігурація `imageGenerationModel`
 - [Моделі](/uk/concepts/models) — конфігурація моделей і перемикання на резервні варіанти

docs/uk/tools/video-generation.md

@@ -1,25 +1,25 @@
 ---
 read_when:
-    - Генерування відео через агента
+    - Генерація відео через агента
     - Налаштування провайдерів і моделей для генерації відео
-    - Розуміння параметрів інструмента video_generate
+    - Розуміння параметрів інструмента `video_generate`
 summary: Створюйте відео з тексту, зображень або наявних відео за допомогою 12 бекендів провайдерів
 title: Генерація відео
 x-i18n:
-    generated_at: "2026-04-06T01:23:59Z"
+    generated_at: "2026-04-06T03:20:03Z"
     model: gpt-5.4
     provider: openai
-    source_hash: 4afec87368232221db1aa5a3980254093d6a961b17271b2dcbf724e6bd455b16
+    source_hash: 90d8a392b35adbd899232b02c55c10895b9d7ffc9858d6ca448f2e4e4a57f12f
     source_path: tools/video-generation.md
     workflow: 15
 ---
 
 # Генерація відео
 
-Агенти OpenClaw можуть генерувати відео з текстових запитів, еталонних зображень або наявних відео. Підтримуються дванадцять бекендів провайдерів, кожен із різними варіантами моделей, режимами введення та наборами функцій. Агент автоматично вибирає відповідного провайдера на основі вашої конфігурації та доступних API-ключів.
+Агенти OpenClaw можуть створювати відео з текстових підказок, еталонних зображень або наявних відео. Підтримуються дванадцять бекендів провайдерів, кожен із різними варіантами моделей, режимами введення та наборами функцій. Агент автоматично вибирає відповідного провайдера на основі вашої конфігурації та доступних API-ключів.
 
 <Note>
-Інструмент `video_generate` з’являється лише тоді, коли доступний щонайменше один провайдер генерації відео. Якщо ви не бачите його серед інструментів агента, задайте API-ключ провайдера або налаштуйте `agents.defaults.videoGenerationModel`.
+Інструмент `video_generate` з’являється лише тоді, коли доступний принаймні один провайдер генерації відео. Якщо ви не бачите його серед інструментів агента, задайте API-ключ провайдера або налаштуйте `agents.defaults.videoGenerationModel`.
 </Note>
 
 ## Швидкий старт
@@ -30,7 +30,7 @@ x-i18n:
 export GEMINI_API_KEY="your-key"
 ```
 
-2. За потреби закріпіть типову модель:
+2. За потреби закріпіть модель за замовчуванням:
 
 ```bash
 openclaw config set agents.defaults.videoGenerationModel.primary "google/veo-3.1-fast-generate-preview"
@@ -38,43 +38,43 @@ openclaw config set agents.defaults.videoGenerationModel.primary "google/veo-3.1
 
 3. Попросіть агента:
 
-> Згенеруй 5-секундне кінематографічне відео, де дружній лобстер катається на серфі на заході сонця.
+> Згенеруй 5-секундне кінематографічне відео з дружнім лобстером, який займається серфінгом на заході сонця.
 
 Агент автоматично викликає `video_generate`. Дозволений список інструментів не потрібен.
 
-## Що відбувається під час генерації відео
+## Що відбувається, коли ви генеруєте відео
 
 Генерація відео є асинхронною. Коли агент викликає `video_generate` у сесії:
 
-1. OpenClaw надсилає запит провайдеру й одразу повертає ID завдання.
+1. OpenClaw надсилає запит провайдеру й одразу повертає ідентифікатор завдання.
 2. Провайдер обробляє завдання у фоновому режимі (зазвичай від 30 секунд до 5 хвилин залежно від провайдера та роздільної здатності).
 3. Коли відео готове, OpenClaw пробуджує ту саму сесію внутрішньою подією завершення.
-4. Агент публікує готове відео назад в оригінальну розмову.
+4. Агент публікує готове відео назад у вихідну розмову.
 
-Поки завдання виконується, повторні виклики `video_generate` у тій самій сесії повертають поточний стан завдання замість запуску нової генерації. Використовуйте `openclaw tasks list` або `openclaw tasks show <taskId>`, щоб перевірити перебіг виконання з CLI.
+Поки завдання виконується, повторні виклики `video_generate` у тій самій сесії повертають поточний статус завдання замість запуску ще однієї генерації. Використовуйте `openclaw tasks list` або `openclaw tasks show <taskId>`, щоб перевірити прогрес через CLI.
 
 Поза запусками агента, прив’язаними до сесії (наприклад, під час прямих викликів інструмента), інструмент переходить до вбудованої генерації та повертає фінальний шлях до медіафайлу в тому самому ході.
 
 ## Підтримувані провайдери
 
-| Провайдер | Типова модель                  | Текст | Еталонне зображення | Еталонне відео   | API-ключ                                 |
-| --------- | ------------------------------ | ----- | ------------------- | ---------------- | ---------------------------------------- |
-| Alibaba   | `wan2.6-t2v`                   | Так   | Так (віддалений URL) | Так (віддалений URL) | `MODELSTUDIO_API_KEY`                |
-| BytePlus  | `seedance-1-0-lite-t2v-250428` | Так   | 1 зображення        | Ні               | `BYTEPLUS_API_KEY`                       |
-| ComfyUI   | `workflow`                     | Так   | 1 зображення        | Ні               | `COMFY_API_KEY` або `COMFY_CLOUD_API_KEY` |
-| fal       | `fal-ai/minimax/video-01-live` | Так   | 1 зображення        | Ні               | `FAL_KEY`                                |
-| Google    | `veo-3.1-fast-generate-preview` | Так  | 1 зображення        | 1 відео          | `GEMINI_API_KEY`                         |
-| MiniMax   | `MiniMax-Hailuo-2.3`           | Так   | 1 зображення        | Ні               | `MINIMAX_API_KEY`                        |
-| OpenAI    | `sora-2`                       | Так   | 1 зображення        | 1 відео          | `OPENAI_API_KEY`                         |
-| Qwen      | `wan2.6-t2v`                   | Так   | Так (віддалений URL) | Так (віддалений URL) | `QWEN_API_KEY`                       |
-| Runway    | `gen4.5`                       | Так   | 1 зображення        | 1 відео          | `RUNWAYML_API_SECRET`                    |
-| Together  | `Wan-AI/Wan2.2-T2V-A14B`       | Так   | 1 зображення        | Ні               | `TOGETHER_API_KEY`                       |
-| Vydra     | `veo3`                         | Так   | 1 зображення (`kling`) | Ні            | `VYDRA_API_KEY`                          |
-| xAI       | `grok-imagine-video`           | Так   | 1 зображення        | 1 відео          | `XAI_API_KEY`                            |
+| Провайдер | Модель за замовчуванням          | Текст | Еталонне зображення | Еталонне відео   | API-ключ                                 |
+| --------- | ------------------------------- | ----- | ------------------- | ---------------- | ---------------------------------------- |
+| Alibaba   | `wan2.6-t2v`                    | Так   | Так (віддалений URL) | Так (віддалений URL) | `MODELSTUDIO_API_KEY`                    |
+| BytePlus  | `seedance-1-0-lite-t2v-250428`  | Так   | 1 зображення        | Ні               | `BYTEPLUS_API_KEY`                       |
+| ComfyUI   | `workflow`                      | Так   | 1 зображення        | Ні               | `COMFY_API_KEY` or `COMFY_CLOUD_API_KEY` |
+| fal       | `fal-ai/minimax/video-01-live`  | Так   | 1 зображення        | Ні               | `FAL_KEY`                                |
+| Google    | `veo-3.1-fast-generate-preview` | Так   | 1 зображення        | 1 відео          | `GEMINI_API_KEY`                         |
+| MiniMax   | `MiniMax-Hailuo-2.3`            | Так   | 1 зображення        | Ні               | `MINIMAX_API_KEY`                        |
+| OpenAI    | `sora-2`                        | Так   | 1 зображення        | 1 відео          | `OPENAI_API_KEY`                         |
+| Qwen      | `wan2.6-t2v`                    | Так   | Так (віддалений URL) | Так (віддалений URL) | `QWEN_API_KEY`                           |
+| Runway    | `gen4.5`                        | Так   | 1 зображення        | 1 відео          | `RUNWAYML_API_SECRET`                    |
+| Together  | `Wan-AI/Wan2.2-T2V-A14B`        | Так   | 1 зображення        | Ні               | `TOGETHER_API_KEY`                       |
+| Vydra     | `veo3`                          | Так   | 1 зображення (`kling`) | Ні            | `VYDRA_API_KEY`                          |
+| xAI       | `grok-imagine-video`            | Так   | 1 зображення        | 1 відео          | `XAI_API_KEY`                            |
 
 Деякі провайдери приймають додаткові або альтернативні змінні середовища для API-ключів. Докладніше дивіться на окремих [сторінках провайдерів](#related).
 
-Запустіть `video_generate action=list`, щоб переглянути доступних провайдерів і моделі під час виконання.
+Виконайте `video_generate action=list`, щоб переглянути доступних провайдерів і моделі під час виконання.
 
 ## Параметри інструмента
 
@@ -82,54 +82,54 @@ openclaw config set agents.defaults.videoGenerationModel.primary "google/veo-3.1
 
 | Параметр | Тип    | Опис                                                                          |
 | -------- | ------ | ----------------------------------------------------------------------------- |
-| `prompt` | string | Текстовий опис відео для генерації (обов’язковий для `action: "generate"`)   |
+| `prompt` | string | Текстовий опис відео для генерації (обов’язковий для `action: "generate"`) |
 
 ### Вхідні дані контенту
 
-| Параметр | Тип      | Опис                                  |
-| -------- | -------- | ------------------------------------- |
+| Параметр | Тип      | Опис                                 |
+| -------- | -------- | ------------------------------------ |
 | `image`  | string   | Одне еталонне зображення (шлях або URL) |
-| `images` | string[] | Кілька еталонних зображень (до 5)     |
-| `video`  | string   | Одне еталонне відео (шлях або URL)    |
-| `videos` | string[] | Кілька еталонних відео (до 4)         |
+| `images` | string[] | Кілька еталонних зображень (до 5)    |
+| `video`  | string   | Одне еталонне відео (шлях або URL)   |
+| `videos` | string[] | Кілька еталонних відео (до 4)        |
 
 ### Керування стилем
 
 | Параметр          | Тип     | Опис                                                                     |
 | ----------------- | ------- | ------------------------------------------------------------------------ |
-| `aspectRatio`     | string  | `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9` |
+| `aspectRatio`     | string  | `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9`  |
 | `resolution`      | string  | `480P`, `720P` або `1080P`                                               |
 | `durationSeconds` | number  | Цільова тривалість у секундах (округлюється до найближчого значення, яке підтримує провайдер) |
 | `size`            | string  | Підказка щодо розміру, якщо провайдер це підтримує                       |
-| `audio`           | boolean | Увімкнути згенерований звук, якщо підтримується                          |
-| `watermark`       | boolean | Увімкнути або вимкнути водяний знак провайдера, якщо підтримується       |
+| `audio`           | boolean | Увімкнути згенероване аудіо, якщо підтримується                          |
+| `watermark`       | boolean | Перемкнути водяні знаки провайдера, якщо підтримується                   |
 
 ### Додатково
 
-| Параметр  | Тип    | Опис                                             |
-| --------- | ------ | ------------------------------------------------ |
-| `action`  | string | `"generate"` (типово), `"status"` або `"list"`   |
+| Параметр  | Тип    | Опис                                            |
+| --------- | ------ | ----------------------------------------------- |
+| `action`  | string | `"generate"` (за замовчуванням), `"status"` або `"list"` |
 | `model`   | string | Перевизначення провайдера/моделі (наприклад, `runway/gen4.5`) |
-| `filename` | string | Підказка для імені вихідного файлу              |
+| `filename`| string | Підказка для назви вихідного файлу              |
 
-Не всі провайдери підтримують усі параметри. Непідтримувані перевизначення ігноруються за принципом best-effort і повідомляються як попередження в результаті інструмента. Жорсткі обмеження можливостей (наприклад, надто багато еталонних вхідних даних) спричиняють помилку ще до надсилання.
+Не всі провайдери підтримують усі параметри. Непідтримувані перевизначення ігноруються в межах максимально можливого та повідомляються як попередження в результаті інструмента. Жорсткі обмеження можливостей (наприклад, надто багато еталонних входів) завершуються помилкою ще до надсилання.
 
 ## Дії
 
-- **generate** (типово) -- створити відео з указаного запиту та необов’язкових еталонних вхідних даних.
-- **status** -- перевірити стан активного відеозавдання для поточної сесії без запуску нової генерації.
+- **generate** (за замовчуванням) -- створити відео з указаного запиту та необов’язкових еталонних входів.
+- **status** -- перевірити стан поточного завдання генерації відео для поточної сесії без запуску нової генерації.
 - **list** -- показати доступних провайдерів, моделі та їхні можливості.
 
 ## Вибір моделі
 
 Під час генерації відео OpenClaw визначає модель у такому порядку:
 
-1. **`model` параметр інструмента** -- якщо агент указує його у виклику.
+1. **Параметр інструмента `model`** -- якщо агент указує його у виклику.
 2. **`videoGenerationModel.primary`** -- із конфігурації.
-3. **`videoGenerationModel.fallbacks`** -- пробуються по черзі.
-4. **Автовиявлення** -- використовує провайдерів, які мають дійсну автентифікацію, починаючи з поточного типового провайдера, а потім решту провайдерів в алфавітному порядку.
+3. **`videoGenerationModel.fallbacks`** -- випробовуються по черзі.
+4. **Автовизначення** -- використовує провайдерів із коректною автентифікацією, починаючи з поточного провайдера за замовчуванням, а потім решту провайдерів в алфавітному порядку.
 
-Якщо провайдер завершується помилкою, автоматично пробується наступний кандидат. Якщо всі кандидати завершуються помилкою, повідомлення про помилку містить деталі кожної спроби.
+Якщо провайдер не спрацьовує, автоматично випробовується наступний кандидат. Якщо не спрацьовують усі кандидати, помилка містить подробиці кожної спроби.
 
 ```json5
 {
@@ -146,24 +146,24 @@ openclaw config set agents.defaults.videoGenerationModel.primary "google/veo-3.1
 
 ## Примітки щодо провайдерів
 
-| Провайдер | Примітки                                                                                                                                    |
-| --------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
-| Alibaba   | Використовує асинхронну кінцеву точку DashScope/Model Studio. Еталонні зображення та відео мають бути віддаленими URL `http(s)`.         |
-| BytePlus  | Лише одне еталонне зображення.                                                                                                              |
-| ComfyUI   | Виконання локально або в хмарі на основі workflow. Підтримує text-to-video та image-to-video через налаштований граф.                     |
-| fal       | Використовує потік на базі черги для довготривалих завдань. Лише одне еталонне зображення.                                                 |
-| Google    | Використовує Gemini/Veo. Підтримує одне еталонне зображення або одне еталонне відео.                                                       |
-| MiniMax   | Лише одне еталонне зображення.                                                                                                              |
-| OpenAI    | Передається лише перевизначення `size`. Інші перевизначення стилю (`aspectRatio`, `resolution`, `audio`, `watermark`) ігноруються з попередженням. |
-| Qwen      | Той самий бекенд DashScope, що й Alibaba. Еталонні вхідні дані мають бути віддаленими URL `http(s)`; локальні файли одразу відхиляються. |
-| Runway    | Підтримує локальні файли через data URI. Для video-to-video потрібен `runway/gen4_aleph`. Для запусків лише з текстом доступні співвідношення сторін `16:9` і `9:16`. |
-| Together  | Лише одне еталонне зображення.                                                                                                              |
-| Vydra     | Використовує `https://www.vydra.ai/api/v1` напряму, щоб уникнути перенаправлень, які скидають автентифікацію. `veo3` постачається лише як text-to-video; для `kling` потрібен віддалений URL зображення. |
-| xAI       | Підтримує text-to-video, image-to-video, а також потоки редагування/розширення віддаленого відео.                                         |
+| Провайдер | Примітки                                                                                                                                                    |
+| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Alibaba   | Використовує асинхронну кінцеву точку DashScope/Model Studio. Еталонні зображення та відео мають бути віддаленими URL `http(s)`.                          |
+| BytePlus  | Лише одне еталонне зображення.                                                                                                                              |
+| ComfyUI   | Виконання локально або в хмарі на основі workflow. Підтримує перетворення тексту у відео та зображення у відео через налаштований граф.                   |
+| fal       | Використовує потік на основі черги для довготривалих завдань. Лише одне еталонне зображення.                                                               |
+| Google    | Використовує Gemini/Veo. Підтримує одне еталонне зображення або одне еталонне відео.                                                                        |
+| MiniMax   | Лише одне еталонне зображення.                                                                                                                              |
+| OpenAI    | Передається лише перевизначення `size`. Інші перевизначення стилю (`aspectRatio`, `resolution`, `audio`, `watermark`) ігноруються з попередженням.         |
+| Qwen      | Той самий бекенд DashScope, що й у Alibaba. Еталонні входи мають бути віддаленими URL `http(s)`; локальні файли одразу відхиляються.                       |
+| Runway    | Підтримує локальні файли через data URI. Для перетворення відео у відео потрібен `runway/gen4_aleph`. Для суто текстових запусків доступні співвідношення сторін `16:9` і `9:16`. |
+| Together  | Лише одне еталонне зображення.                                                                                                                              |
+| Vydra     | Використовує `https://www.vydra.ai/api/v1` безпосередньо, щоб уникнути перенаправлень, які скидають автентифікацію. `veo3` постачається лише як text-to-video; `kling` потребує віддалений URL зображення. |
+| xAI       | Підтримує перетворення тексту у відео, зображення у відео та віддалені потоки редагування/розширення відео.                                                |
 
 ## Конфігурація
 
-Задайте типову модель генерації відео у вашій конфігурації OpenClaw:
+Задайте модель генерації відео за замовчуванням у конфігурації OpenClaw:
 
 ```json5
 {
@@ -189,7 +189,7 @@ openclaw config set agents.defaults.videoGenerationModel.primary "qwen/wan2.6-t2
 - [Огляд інструментів](/uk/tools)
 - [Фонові завдання](/uk/automation/tasks) -- відстеження завдань для асинхронної генерації відео
 - [Alibaba Model Studio](/uk/providers/alibaba)
-- [BytePlus](/providers/byteplus)
+- [BytePlus](/uk/concepts/model-providers#byteplus-international)
 - [ComfyUI](/uk/providers/comfy)
 - [fal](/uk/providers/fal)
 - [Google (Gemini)](/uk/providers/google)
@@ -198,7 +198,7 @@ openclaw config set agents.defaults.videoGenerationModel.primary "qwen/wan2.6-t2
 - [Qwen](/uk/providers/qwen)
 - [Runway](/uk/providers/runway)
 - [Together AI](/uk/providers/together)
-- [Vydra](/providers/vydra)
+- [Vydra](/uk/providers/vydra)
 - [xAI](/uk/providers/xai)
 - [Довідник із конфігурації](/uk/gateway/configuration-reference#agent-defaults)
 - [Моделі](/uk/concepts/models)