chore(i18n): refresh uk translations

docs/uk/plugins/sdk-migration.md

@@ -2,16 +2,16 @@
 read_when:
     - Ви бачите попередження OPENCLAW_PLUGIN_SDK_COMPAT_DEPRECATED
     - Ви бачите попередження OPENCLAW_EXTENSION_API_DEPRECATED
-    - Ви оновлюєте plugin до сучасної архітектури plugin
-    - Ви підтримуєте зовнішній plugin OpenClaw
+    - Ви оновлюєте плагін до сучасної архітектури плагінів
+    - Ви підтримуєте зовнішній плагін OpenClaw
 sidebarTitle: Migrate to SDK
-summary: Перехід із застарілого шару зворотної сумісності на сучасний plugin SDK
+summary: Перейдіть із застарілого шару зворотної сумісності на сучасний plugin SDK
 title: Міграція Plugin SDK
 x-i18n:
-    generated_at: "2026-04-05T18:13:15Z"
+    generated_at: "2026-04-05T21:36:53Z"
     model: gpt-5.4
     provider: openai
-    source_hash: d2a0f2501484b224a1f5b87dc66e9bef1dcb9d3225aaeefe711ed94bf70b6a16
+    source_hash: f4a5aba3ff99f9cc75518a914e7a9faf92b9021f26031f7ace74d0b58a3416da
     source_path: plugins/sdk-migration.md
     workflow: 15
 ---
@@ -19,65 +19,73 @@ x-i18n:
 # Міграція Plugin SDK
 
 OpenClaw перейшов від широкого шару зворотної сумісності до сучасної
-архітектури plugin із цілеспрямованими, задокументованими імпортами. Якщо ваш plugin було створено до
-появи нової архітектури, цей посібник допоможе вам виконати міграцію.
+архітектури плагінів із цільовими документованими імпортами. Якщо ваш плагін
+було створено до появи нової архітектури, цей посібник допоможе вам виконати
+міграцію.
 
 ## Що змінюється
 
-Стара система plugin надавала дві дуже широкі поверхні, які дозволяли plugin імпортувати
-все, що їм було потрібно, з однієї точки входу:
+Стара система плагінів надавала дві дуже широкі поверхні, які дозволяли
+плагінам імпортувати будь-що потрібне з однієї точки входу:
 
-- **`openclaw/plugin-sdk/compat`** — єдиний імпорт, який повторно експортував десятки
-  допоміжних функцій. Його було запроваджено, щоб зберегти працездатність старіших plugin на основі hook, поки
-  створювалася нова архітектура plugin.
-- **`openclaw/extension-api`** — міст, який надавав plugin прямий доступ до
-  допоміжних функцій на боці host, таких як вбудований виконавець агента.
+- **`openclaw/plugin-sdk/compat`** — єдиний імпорт, який повторно експортував
+  десятки допоміжних функцій. Його було запроваджено, щоб старіші плагіни на
+  основі хуків продовжували працювати, поки створювалася нова архітектура
+  плагінів.
+- **`openclaw/extension-api`** — міст, який надавав плагінам прямий доступ до
+  допоміжних функцій на стороні хоста, таких як вбудований запускник агента.
 
-Обидві поверхні тепер **застарілі**. Вони все ще працюють під час виконання, але нові
-plugin не повинні їх використовувати, а наявні plugin слід перенести до того, як наступний
-мажорний реліз їх видалить.
+Обидві поверхні тепер **застарілі**. Вони досі працюють під час виконання, але
+нові плагіни не повинні їх використовувати, а наявні плагіни слід перенести до
+того, як у наступному мажорному випуску їх буде видалено.
 
 <Warning>
-  Шар зворотної сумісності буде видалено в одному з майбутніх мажорних релізів.
-  Plugins, які досі імпортують із цих поверхонь, перестануть працювати, коли це станеться.
+  Шар зворотної сумісності буде видалено в одному з майбутніх мажорних
+  випусків. Плагіни, які досі імпортують із цих поверхонь, перестануть
+  працювати, коли це станеться.
 </Warning>
 
 ## Чому це змінилося
 
 Старий підхід спричиняв проблеми:
 
-- **Повільний запуск** — імпорт однієї допоміжної функції завантажував десятки не пов’язаних між собою модулів
-- **Циклічні залежності** — широкі повторні експорти спрощували створення циклів імпорту
-- **Нечітка поверхня API** — не було способу зрозуміти, які експорти є стабільними, а які внутрішніми
+- **Повільний запуск** — імпорт однієї допоміжної функції завантажував десятки
+  не пов’язаних модулів
+- **Циклічні залежності** — широкі повторні експорти спрощували створення
+  циклів імпорту
+- **Неочевидна поверхня API** — не було способу визначити, які експорти є
+  стабільними, а які внутрішніми
 
-Сучасний plugin SDK це виправляє: кожен шлях імпорту (`openclaw/plugin-sdk/\<subpath\>`)
-є невеликим самодостатнім модулем із чітким призначенням і задокументованим контрактом.
+Сучасний plugin SDK виправляє це: кожен шлях імпорту (`openclaw/plugin-sdk/\<subpath\>`)
+є невеликим автономним модулем із чітким призначенням і документованим
+контрактом.
 
-Застарілі зручні шви provider для вбудованих channels також зникли. Імпорти
-на кшталт `openclaw/plugin-sdk/slack`, `openclaw/plugin-sdk/discord`,
-`openclaw/plugin-sdk/signal`, `openclaw/plugin-sdk/whatsapp`,
-допоміжні шви з брендуванням channel, а також
-`openclaw/plugin-sdk/telegram-core` були приватними скороченнями монорепозиторію, а не
-стабільними контрактами plugin. Натомість використовуйте вузькі загальні підшляхи SDK. Усередині
-робочого простору вбудованих plugin зберігайте допоміжні функції, що належать provider, у власних
-`api.ts` або `runtime-api.ts` цього plugin.
+Застарілі зручні seam-інтерфейси провайдерів для вбудованих каналів також
+прибрано. Імпорти на кшталт `openclaw/plugin-sdk/slack`,
+`openclaw/plugin-sdk/discord`, `openclaw/plugin-sdk/signal`,
+`openclaw/plugin-sdk/whatsapp`, брендовані допоміжні seam-інтерфейси каналів і
+`openclaw/plugin-sdk/telegram-core` були приватними скороченнями
+mono-repo, а не стабільними контрактами плагінів. Натомість використовуйте
+вузькі універсальні підшляхи SDK. Усередині робочого простору вбудованих
+плагінів зберігайте допоміжні функції, що належать провайдеру, у власних
+`api.ts` або `runtime-api.ts` цього плагіна.
 
-Поточні приклади вбудованих provider:
+Поточні приклади вбудованих провайдерів:
 
-- Anthropic зберігає допоміжні функції потоків, специфічні для Claude, у власному шві `api.ts` /
-  `contract-api.ts`
-- OpenAI зберігає конструктори provider, допоміжні функції моделей за замовчуванням і конструктори provider реального часу
-  у власному `api.ts`
-- OpenRouter зберігає конструктор provider і допоміжні функції онбордингу/конфігурації у власному
-  `api.ts`
+- Anthropic зберігає допоміжні функції потоку, специфічні для Claude, у
+  власному seam-інтерфейсі `api.ts` / `contract-api.ts`
+- OpenAI зберігає побудовники провайдерів, допоміжні функції моделей за
+  замовчуванням і побудовники realtime-провайдерів у власному `api.ts`
+- OpenRouter зберігає побудовник провайдера та допоміжні функції онбордингу /
+  конфігурації у власному `api.ts`
 
 ## Як виконати міграцію
 
 <Steps>
-  <Step title="Перевірте поведінку резервного шляху оболонки Windows">
-    Якщо ваш plugin використовує `openclaw/plugin-sdk/windows-spawn`, нерозв’язані Windows
-    обгортки `.cmd`/`.bat` тепер завершуються із закритою відмовою, якщо ви явно не передасте
-    `allowShellFallback: true`.
+  <Step title="Перевірте резервну поведінку обгортки Windows">
+    Якщо ваш плагін використовує `openclaw/plugin-sdk/windows-spawn`, нерозв’язані
+    обгортки Windows `.cmd`/`.bat` тепер завершуються без резервного шляху, якщо
+    ви явно не передасте `allowShellFallback: true`.
 
     ```typescript
     // До
@@ -87,18 +95,19 @@ plugin не повинні їх використовувати, а наявні
     const program = applyWindowsSpawnProgramPolicy({
       candidate,
       // Установлюйте це лише для довірених сумісних викликів, які навмисно
-      // приймають резервний шлях через оболонку.
+      // допускають резервний шлях через оболонку.
       allowShellFallback: true,
     });
     ```
 
-    Якщо ваш виклик навмисно не покладається на резервний шлях оболонки, не встановлюйте
-    `allowShellFallback`, а натомість обробляйте викинуту помилку.
+    Якщо ваш виклик не покладається навмисно на резервний шлях через оболонку,
+    не встановлюйте `allowShellFallback` і натомість обробляйте викинуту
+    помилку.
 
   </Step>
 
   <Step title="Знайдіть застарілі імпорти">
-    Пошукайте у своєму plugin імпорти з будь-якої із застарілих поверхонь:
+    Знайдіть у своєму плагіні імпорти з будь-якої із застарілих поверхонь:
 
     ```bash
     grep -r "plugin-sdk/compat" my-plugin/
@@ -107,8 +116,9 @@ plugin не повинні їх використовувати, а наявні
 
   </Step>
 
-  <Step title="Замініть на цілеспрямовані імпорти">
-    Кожен експорт зі старої поверхні зіставляється з певним сучасним шляхом імпорту:
+  <Step title="Замініть їх цільовими імпортами">
+    Кожен експорт зі старої поверхні відповідає конкретному сучасному шляху
+    імпорту:
 
     ```typescript
     // До (застарілий шар зворотної сумісності)
@@ -118,14 +128,14 @@ plugin не повинні їх використовувати, а наявні
       resolveControlCommandGate,
     } from "openclaw/plugin-sdk/compat";
 
-    // Після (сучасні цілеспрямовані імпорти)
+    // Після (сучасні цільові імпорти)
     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";
     ```
 
-    Для допоміжних функцій на боці host використовуйте впроваджене середовище виконання plugin замість прямого
-    імпорту:
+    Для допоміжних функцій на стороні хоста використовуйте впроваджене
+    середовище виконання плагіна замість прямого імпорту:
 
     ```typescript
     // До (застарілий міст extension-api)
@@ -136,7 +146,8 @@ plugin не повинні їх використовувати, а наявні
     const result = await api.runtime.agent.runEmbeddedPiAgent({ sessionId, prompt });
     ```
 
-    Той самий шаблон застосовується й до інших допоміжних функцій застарілого моста:
+    Такий самий шаблон застосовується й до інших застарілих допоміжних функцій
+    моста:
 
     | Старий імпорт | Сучасний еквівалент |
     | --- | --- |
@@ -146,7 +157,7 @@ plugin не повинні їх використовувати, а наявні
     | `resolveThinkingDefault` | `api.runtime.agent.resolveThinkingDefault` |
     | `resolveAgentTimeoutMs` | `api.runtime.agent.resolveAgentTimeoutMs` |
     | `ensureAgentWorkspace` | `api.runtime.agent.ensureAgentWorkspace` |
-    | session store helpers | `api.runtime.agent.session.*` |
+    | допоміжні функції сховища сесій | `api.runtime.agent.session.*` |
 
   </Step>
 
@@ -163,163 +174,171 @@ plugin не повинні їх використовувати, а наявні
 <Accordion title="Таблиця поширених шляхів імпорту">
   | Шлях імпорту | Призначення | Ключові експорти |
   | --- | --- | --- |
-  | `plugin-sdk/plugin-entry` | Канонічна допоміжна функція точки входу plugin | `definePluginEntry` |
-  | `plugin-sdk/core` | Застарілий повторний експорт-парасолька для визначень/конструкторів входів channel | `defineChannelPluginEntry`, `createChatChannelPlugin` |
+  | `plugin-sdk/plugin-entry` | Канонічна допоміжна функція точки входу плагіна | `definePluginEntry` |
+  | `plugin-sdk/core` | Застарілий узагальнений повторний експорт для визначень / побудовників точок входу каналів | `defineChannelPluginEntry`, `createChatChannelPlugin` |
   | `plugin-sdk/config-schema` | Експорт кореневої схеми конфігурації | `OpenClawSchema` |
-  | `plugin-sdk/provider-entry` | Допоміжна функція точки входу для одного provider | `defineSingleProviderPluginEntry` |
-  | `plugin-sdk/channel-core` | Цілеспрямовані визначення входів і конструктори channel | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` |
-  | `plugin-sdk/setup` | Спільні допоміжні функції майстра налаштування | Запити allowlist, конструктори статусу налаштування |
-  | `plugin-sdk/setup-runtime` | Допоміжні функції середовища виконання під час налаштування | Безпечні для імпорту адаптери patch налаштування, допоміжні функції приміток пошуку, `promptResolvedAllowFrom`, `splitSetupEntries`, делеговані проксі налаштування |
+  | `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/setup-tools` | Допоміжні інструменти налаштування | `formatCliCommand`, `detectBinary`, `extractArchive`, `resolveBrewExecutable`, `formatDocsLink`, `CONFIG_DIR` |
+  | `plugin-sdk/account-core` | Допоміжні функції для кількох облікових записів | Допоміжні функції списку облікових записів / конфігурації / шлюзу дій |
   | `plugin-sdk/account-id` | Допоміжні функції ID облікового запису | `DEFAULT_ACCOUNT_ID`, нормалізація ID облікового запису |
-  | `plugin-sdk/account-resolution` | Допоміжні функції пошуку облікового запису | Допоміжні функції пошуку облікового запису + резервного значення за замовчуванням |
-  | `plugin-sdk/account-helpers` | Вузькі допоміжні функції облікового запису | Допоміжні функції списку облікових записів/дій з обліковими записами |
+  | `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` | Префікс відповіді + підключення typing | `createChannelReplyPipeline` |
+  | `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-sdk/channel-policy` | Визначення політик груп/DM | `resolveChannelGroupRequireMention` |
+  | `plugin-sdk/channel-config-schema` | Побудовники схем конфігурації | Типи схем конфігурації каналу |
+  | `plugin-sdk/telegram-command-config` | Допоміжні функції конфігурації команд Telegram | Нормалізація назв команд, обрізання описів, валідація дублікатів / конфліктів |
+  | `plugin-sdk/channel-policy` | Визначення політики груп / DM | `resolveChannelGroupRequireMention` |
   | `plugin-sdk/channel-lifecycle` | Відстеження статусу облікового запису | `createAccountStatusSink` |
-  | `plugin-sdk/inbound-envelope` | Допоміжні функції вхідного envelope | Спільні допоміжні функції маршрутизації + побудови envelope |
+  | `plugin-sdk/inbound-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 сумісності | Лише застарілі утиліти середовища виконання channel |
-  | `plugin-sdk/channel-send-result` | Типи результату відправлення | Типи результату відповіді |
-  | `plugin-sdk/runtime-store` | Постійне сховище plugin | `createPluginRuntimeStore` |
-  | `plugin-sdk/runtime` | Широкі допоміжні функції середовища виконання | Допоміжні функції середовища виконання/журналювання/резервного копіювання/встановлення plugin |
-  | `plugin-sdk/runtime-env` | Вузькі допоміжні функції середовища виконання | Допоміжні функції logger/середовища виконання, timeout, retry і backoff |
-  | `plugin-sdk/plugin-runtime` | Спільні допоміжні функції середовища виконання plugin | Допоміжні функції команд/hook/http/інтерактивності plugin |
-  | `plugin-sdk/hook-runtime` | Допоміжні функції конвеєра hook | Спільні допоміжні функції конвеєра webhook/внутрішніх hook |
-  | `plugin-sdk/lazy-runtime` | Допоміжні функції лінивого середовища виконання | `createLazyRuntimeModule`, `createLazyRuntimeMethod`, `createLazyRuntimeMethodBinder`, `createLazyRuntimeNamedExport`, `createLazyRuntimeSurface` |
+  | `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` | Широкі допоміжні функції середовища виконання | Допоміжні функції runtime / logging / backup / встановлення плагінів |
+  | `plugin-sdk/runtime-env` | Вузькі допоміжні функції середовища runtime | Logger / runtime env, timeout, retry і backoff helpers |
+  | `plugin-sdk/plugin-runtime` | Спільні допоміжні функції runtime плагінів | Допоміжні функції команд / hooks / http / interactive плагінів |
+  | `plugin-sdk/hook-runtime` | Допоміжні функції конвеєра hooks | Спільні допоміжні функції конвеєра webhook / internal hook |
+  | `plugin-sdk/lazy-runtime` | Допоміжні функції лінивого runtime | `createLazyRuntimeModule`, `createLazyRuntimeMethod`, `createLazyRuntimeMethodBinder`, `createLazyRuntimeNamedExport`, `createLazyRuntimeSurface` |
   | `plugin-sdk/process-runtime` | Допоміжні функції процесів | Спільні допоміжні функції exec |
-  | `plugin-sdk/cli-runtime` | Допоміжні функції середовища виконання CLI | Форматування команд, очікування, допоміжні функції версій |
-  | `plugin-sdk/gateway-runtime` | Допоміжні функції Gateway | Клієнт Gateway і допоміжні функції patch статусу channel |
-  | `plugin-sdk/config-runtime` | Допоміжні функції конфігурації | Допоміжні функції завантаження/запису конфігурації |
-  | `plugin-sdk/telegram-command-config` | Допоміжні функції команд Telegram | Стійкі до резервного шляху допоміжні функції перевірки команд Telegram, коли поверхня контракту вбудованого Telegram недоступна |
-  | `plugin-sdk/approval-runtime` | Допоміжні функції запитів схвалення | Навантаження схвалення exec/plugin, допоміжні функції можливостей/профілів схвалення, допоміжні функції маршрутизації/середовища виконання native-схвалень |
-  | `plugin-sdk/approval-auth-runtime` | Допоміжні функції auth схвалення | Визначення схвалювача, auth дій у тому самому чаті |
-  | `plugin-sdk/approval-client-runtime` | Допоміжні функції клієнта схвалення | Допоміжні функції профілю/фільтра native-схвалення exec |
-  | `plugin-sdk/approval-delivery-runtime` | Допоміжні функції доставлення схвалення | Адаптери можливостей/доставлення native-схвалення |
-  | `plugin-sdk/approval-native-runtime` | Допоміжні функції цілей схвалення | Допоміжні функції цілей native-схвалення/прив’язки облікового запису |
-  | `plugin-sdk/approval-reply-runtime` | Допоміжні функції відповіді на схвалення | Допоміжні функції навантаження відповіді на схвалення exec/plugin |
-  | `plugin-sdk/security-runtime` | Допоміжні функції безпеки | Спільні допоміжні функції довіри, шлюзів DM, зовнішнього вмісту та збору секретів |
-  | `plugin-sdk/ssrf-policy` | Допоміжні функції політики SSRF | Допоміжні функції allowlist host і політики приватної мережі |
-  | `plugin-sdk/ssrf-runtime` | Допоміжні функції середовища виконання SSRF | Закріплений dispatcher, guarded fetch, допоміжні функції політики SSRF |
+  | `plugin-sdk/cli-runtime` | Допоміжні функції CLI runtime | Форматування команд, очікування, допоміжні функції версій |
+  | `plugin-sdk/gateway-runtime` | Допоміжні функції gateway | Клієнт gateway і допоміжні функції патчів статусу каналу |
+  | `plugin-sdk/config-runtime` | Допоміжні функції конфігурації | Допоміжні функції завантаження / запису конфігурації |
+  | `plugin-sdk/telegram-command-config` | Допоміжні функції команд Telegram | Допоміжні функції валідації команд Telegram зі стабільним резервним шляхом, коли поверхня контракту вбудованого Telegram недоступна |
+  | `plugin-sdk/approval-runtime` | Допоміжні функції запитів на схвалення | Exec / plugin approval payload, approval capability / profile helpers, native approval routing / runtime helpers |
+  | `plugin-sdk/approval-auth-runtime` | Допоміжні функції авторизації схвалення | Визначення затверджувача, авторизація дій у тому самому чаті |
+  | `plugin-sdk/approval-client-runtime` | Допоміжні функції клієнта схвалення | Допоміжні функції профілю / фільтра native exec approval |
+  | `plugin-sdk/approval-delivery-runtime` | Допоміжні функції доставки схвалення | Адаптери native approval capability / delivery |
+  | `plugin-sdk/approval-native-runtime` | Допоміжні функції цілей схвалення | Допоміжні функції native approval target / account binding |
+  | `plugin-sdk/approval-reply-runtime` | Допоміжні функції відповіді на схвалення | Допоміжні функції exec / plugin approval reply payload |
+  | `plugin-sdk/security-runtime` | Допоміжні функції безпеки | Спільні допоміжні функції trust, DM gating, external-content і збирання секретів |
+  | `plugin-sdk/ssrf-policy` | Допоміжні функції політики SSRF | Допоміжні функції allowlist хостів і політики приватної мережі |
+  | `plugin-sdk/ssrf-runtime` | Допоміжні функції SSRF runtime | Допоміжні функції pinned-dispatcher, guarded fetch, SSRF policy |
   | `plugin-sdk/collection-runtime` | Допоміжні функції обмеженого кешу | `pruneMapToMaxSize` |
-  | `plugin-sdk/diagnostic-runtime` | Допоміжні функції шлюзування діагностики | `isDiagnosticFlagEnabled`, `isDiagnosticsEnabled` |
+  | `plugin-sdk/diagnostic-runtime` | Допоміжні функції діагностичного шлюзу | `isDiagnosticFlagEnabled`, `isDiagnosticsEnabled` |
   | `plugin-sdk/error-runtime` | Допоміжні функції форматування помилок | `formatUncaughtError`, `isApprovalNotFoundError`, допоміжні функції графа помилок |
-  | `plugin-sdk/fetch-runtime` | Допоміжні функції обгорнутого fetch/proxy | `resolveFetch`, допоміжні функції proxy |
-  | `plugin-sdk/host-runtime` | Допоміжні функції нормалізації host | `normalizeHostname`, `normalizeScpRemoteHost` |
+  | `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` | Шлюзування команд і допоміжні функції поверхні команд | `resolveControlCommandGate`, допоміжні функції авторизації відправника, допоміжні функції реєстру команд |
-  | `plugin-sdk/secret-input` | Аналіз вводу секретів | Допоміжні функції вводу секретів |
+  | `plugin-sdk/allowlist-resolution` | Мапінг вхідних даних allowlist | `mapAllowlistResolutionInputs` |
+  | `plugin-sdk/command-auth` | Шлюз команд і допоміжні функції поверхні команд | `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` | Вузькі допоміжні функції диспетчеризації відповідей | Допоміжні функції finalize + диспетчеризації provider |
+  | `plugin-sdk/webhook-request-guards` | Допоміжні функції захисту тіла запиту webhook | Допоміжні функції читання / обмеження тіла запиту |
+  | `plugin-sdk/reply-runtime` | Спільний runtime відповідей | Вхідна диспетчеризація, heartbeat, планувальник відповідей, chunking |
+  | `plugin-sdk/reply-dispatch-runtime` | Вузькі допоміжні функції диспетчеризації відповідей | Допоміжні функції finalize + provider dispatch |
   | `plugin-sdk/reply-history` | Допоміжні функції історії відповідей | `buildHistoryContext`, `buildPendingHistoryContextFromMap`, `recordPendingHistoryEntry`, `clearHistoryEntriesIfEnabled` |
-  | `plugin-sdk/reply-reference` | Планування посилань на відповіді | `createReplyReferencePlanner` |
-  | `plugin-sdk/reply-chunking` | Допоміжні функції chunk відповідей | Допоміжні функції chunk для тексту/markdown |
-  | `plugin-sdk/session-store-runtime` | Допоміжні функції сховища сесій | Допоміжні функції шляху сховища + updated-at |
-  | `plugin-sdk/state-paths` | Допоміжні функції шляхів стану | Допоміжні функції тек стану та OAuth |
-  | `plugin-sdk/routing` | Допоміжні функції маршрутизації/ключів сесій | `resolveAgentRoute`, `buildAgentSessionKey`, `resolveDefaultAgentBoundAccountId`, допоміжні функції нормалізації ключів сесій |
-  | `plugin-sdk/status-helpers` | Допоміжні функції статусу channel | Конструктори підсумків статусу channel/облікових записів, стандартні значення стану середовища виконання, допоміжні функції метаданих проблем |
-  | `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` | Зчитувачі параметрів | Загальні зчитувачі параметрів tool/CLI |
-  | `plugin-sdk/tool-send` | Витягування відправлення tool | Витягування канонічних полів цілі відправлення з аргументів tool |
-  | `plugin-sdk/temp-path` | Допоміжні функції тимчасових шляхів | Спільні допоміжні функції шляху для тимчасового завантаження |
-  | `plugin-sdk/logging-core` | Допоміжні функції журналювання | Logger підсистеми та допоміжні функції редагування |
-  | `plugin-sdk/markdown-table-runtime` | Допоміжні функції таблиць Markdown | Допоміжні функції режиму таблиць Markdown |
-  | `plugin-sdk/reply-payload` | Типи reply повідомлень | Типи навантаження reply |
-  | `plugin-sdk/provider-setup` | Кураторські допоміжні функції налаштування локальних/self-hosted provider | Допоміжні функції виявлення/конфігурації self-hosted provider |
-  | `plugin-sdk/self-hosted-provider-setup` | Цілеспрямовані допоміжні функції налаштування self-hosted provider, сумісних з OpenAI | Ті самі допоміжні функції виявлення/конфігурації self-hosted provider |
-  | `plugin-sdk/provider-auth-runtime` | Допоміжні функції auth provider у середовищі виконання | Допоміжні функції визначення API-ключа під час виконання |
-  | `plugin-sdk/provider-auth-api-key` | Допоміжні функції налаштування API-ключа provider | Допоміжні функції онбордингу/запису профілю API-ключа |
-  | `plugin-sdk/provider-auth-result` | Допоміжні функції результату auth provider | Стандартний конструктор результату auth OAuth |
-  | `plugin-sdk/provider-auth-login` | Допоміжні функції інтерактивного входу provider | Спільні допоміжні функції інтерактивного входу |
-  | `plugin-sdk/provider-env-vars` | Допоміжні функції змінних середовища provider | Допоміжні функції пошуку змінних середовища auth provider |
-  | `plugin-sdk/provider-model-shared` | Спільні допоміжні функції моделей/повторів provider | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні конструктори політики повторів, допоміжні функції endpoint provider і нормалізації ID моделі |
-  | `plugin-sdk/provider-catalog-shared` | Спільні допоміжні функції каталогу provider | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` |
-  | `plugin-sdk/provider-onboard` | Patch онбордингу provider | Допоміжні функції конфігурації онбордингу |
-  | `plugin-sdk/provider-http` | Допоміжні функції HTTP provider | Загальні допоміжні функції HTTP/можливостей endpoint provider |
-  | `plugin-sdk/provider-web-fetch` | Допоміжні функції web-fetch provider | Допоміжні функції реєстрації/кешу provider web-fetch |
-  | `plugin-sdk/provider-web-search` | Допоміжні функції web-search provider | Допоміжні функції реєстрації/кешу/конфігурації provider web-search |
-  | `plugin-sdk/provider-tools` | Допоміжні функції сумісності tool/схем provider | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, очищення схем Gemini + діагностика, а також допоміжні функції сумісності xAI, такі як `resolveXaiModelCompatPatch` / `applyXaiModelCompat` |
-  | `plugin-sdk/provider-usage` | Допоміжні функції використання provider | `fetchClaudeUsage`, `fetchGeminiUsage`, `fetchGithubCopilotUsage` та інші допоміжні функції використання provider |
-  | `plugin-sdk/provider-stream` | Допоміжні функції обгортки потоку provider | `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 | Типи provider media understanding, а також експорти допоміжних функцій зображень/аудіо для provider |
-  | `plugin-sdk/text-runtime` | Спільні допоміжні функції тексту | Видалення видимого для помічника тексту, допоміжні функції рендерингу/chunking/таблиць markdown, редагування, теги директив, безпечний текст та пов’язані допоміжні функції тексту/журналювання |
-  | `plugin-sdk/text-chunking` | Допоміжні функції chunk тексту | Допоміжна функція chunk вихідного тексту |
-  | `plugin-sdk/speech` | Допоміжні функції мовлення | Типи speech provider, а також допоміжні функції директив, реєстру та перевірки для provider |
-  | `plugin-sdk/speech-core` | Спільна база speech | Типи speech provider, реєстр, директиви, нормалізація |
-  | `plugin-sdk/realtime-transcription` | Допоміжні функції транскрипції в реальному часі | Типи provider і допоміжні функції реєстру |
-  | `plugin-sdk/realtime-voice` | Допоміжні функції голосу в реальному часі | Типи provider і допоміжні функції реєстру |
-  | `plugin-sdk/image-generation-core` | Спільна база генерації зображень | Допоміжні функції типів, failover, auth і реєстру для генерації зображень |
-  | `plugin-sdk/video-generation` | Допоміжні функції генерації відео | Типи provider/request/result для генерації відео |
-  | `plugin-sdk/video-generation-core` | Спільна база генерації відео | Типи генерації відео, допоміжні функції failover, пошук provider і аналіз model-ref |
-  | `plugin-sdk/interactive-runtime` | Допоміжні функції інтерактивних відповідей | Нормалізація/зведення навантаження інтерактивних відповідей |
-  | `plugin-sdk/channel-config-primitives` | Примітиви конфігурації channel | Вузькі примітиви config-schema для channel |
-  | `plugin-sdk/channel-config-writes` | Допоміжні функції запису конфігурації channel | Допоміжні функції авторизації запису конфігурації channel |
-  | `plugin-sdk/channel-plugin-common` | Спільний прелюд channel | Експорти спільного прелюду plugin channel |
-  | `plugin-sdk/channel-status` | Допоміжні функції статусу channel | Спільні допоміжні функції знімка/підсумку статусу channel |
-  | `plugin-sdk/allowlist-config-edit` | Допоміжні функції конфігурації allowlist | Допоміжні функції редагування/читання конфігурації allowlist |
-  | `plugin-sdk/group-access` | Допоміжні функції доступу груп | Спільні допоміжні функції рішень щодо групового доступу |
-  | `plugin-sdk/direct-dm` | Допоміжні функції direct-DM | Спільні допоміжні функції auth/guard для direct-DM |
-  | `plugin-sdk/extension-shared` | Спільні допоміжні функції extension | Примітиви допоміжних функцій пасивного channel/статусу |
+  | `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` | Допоміжні функції маршрутизації / ключів сесії | `resolveAgentRoute`, `buildAgentSessionKey`, `resolveDefaultAgentBoundAccountId`, допоміжні функції нормалізації ключів сесії |
+  | `plugin-sdk/status-helpers` | Допоміжні функції статусу каналу | Побудовники підсумку статусу каналу / облікового запису, значення runtime-state за замовчуванням, допоміжні функції метаданих проблем |
+  | `plugin-sdk/target-resolver-runtime` | Допоміжні функції визначення цілі | Спільні допоміжні функції визначення цілі |
+  | `plugin-sdk/string-normalization-runtime` | Допоміжні функції нормалізації рядків | Допоміжні функції нормалізації slug / string |
+  | `plugin-sdk/request-url` | Допоміжні функції URL запиту | Витягування URL-рядків із request-подібних входів |
+  | `plugin-sdk/run-command` | Допоміжні функції команд із таймером | Виконавець команд із нормалізованими stdout / stderr |
+  | `plugin-sdk/param-readers` | Зчитувачі параметрів | Загальні зчитувачі параметрів інструментів / CLI |
+  | `plugin-sdk/tool-send` | Витягування tool send | Витягування канонічних полів цілі надсилання з аргументів інструмента |
+  | `plugin-sdk/temp-path` | Допоміжні функції тимчасових шляхів | Спільні допоміжні функції тимчасових шляхів для завантажень |
+  | `plugin-sdk/logging-core` | Допоміжні функції логування | Логер підсистеми та допоміжні функції редагування чутливих даних |
+  | `plugin-sdk/markdown-table-runtime` | Допоміжні функції таблиць Markdown | Допоміжні режими таблиць Markdown |
+  | `plugin-sdk/reply-payload` | Типи payload відповідей повідомлень | Типи payload відповідей |
+  | `plugin-sdk/provider-setup` | Добірні допоміжні функції налаштування локальних / self-hosted провайдерів | Допоміжні функції виявлення / конфігурації self-hosted провайдерів |
+  | `plugin-sdk/self-hosted-provider-setup` | Цільові допоміжні функції налаштування OpenAI-compatible self-hosted провайдерів | Ті самі допоміжні функції виявлення / конфігурації self-hosted провайдерів |
+  | `plugin-sdk/provider-auth-runtime` | Допоміжні функції runtime авторизації провайдера | Допоміжні функції визначення API-ключів у runtime |
+  | `plugin-sdk/provider-auth-api-key` | Допоміжні функції налаштування API-ключів провайдера | Допоміжні функції онбордингу / запису профілю для API-ключів |
+  | `plugin-sdk/provider-auth-result` | Допоміжні функції результату авторизації провайдера | Стандартний побудовник OAuth auth-result |
+  | `plugin-sdk/provider-auth-login` | Допоміжні функції інтерактивного входу провайдера | Спільні допоміжні функції інтерактивного входу |
+  | `plugin-sdk/provider-env-vars` | Допоміжні функції env vars провайдера | Допоміжні функції пошуку env vars для авторизації провайдера |
+  | `plugin-sdk/provider-model-shared` | Спільні допоміжні функції моделей / replay провайдера | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні побудовники політик replay, допоміжні функції endpoint провайдера та нормалізації 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` | Спільні допоміжні функції тексту | Прибирання видимого для асистента тексту, допоміжні функції render / chunking / table для markdown, редагування чутливих даних, допоміжні функції тегів директив, безпечного тексту та інші пов’язані текстові / logging helpers |
+  | `plugin-sdk/text-chunking` | Допоміжні функції chunking тексту | Допоміжна функція chunking вихідного тексту |
+  | `plugin-sdk/speech` | Допоміжні функції speech | Типи провайдерів speech, а також експорти директив, реєстру та валідації для провайдерів |
+  | `plugin-sdk/speech-core` | Спільне ядро speech | Типи провайдерів speech, реєстр, директиви, нормалізація |
+  | `plugin-sdk/realtime-transcription` | Допоміжні функції realtime transcription | Типи провайдерів і допоміжні функції реєстру |
+  | `plugin-sdk/realtime-voice` | Допоміжні функції realtime voice | Типи провайдерів і допоміжні функції реєстру |
+  | `plugin-sdk/image-generation-core` | Спільне ядро image generation | Допоміжні функції типів, failover, auth і реєстру image generation |
+  | `plugin-sdk/video-generation` | Допоміжні функції video generation | Типи провайдерів / запитів / результатів video generation |
+  | `plugin-sdk/video-generation-core` | Спільне ядро video generation | Типи video generation, допоміжні функції failover, пошуку провайдера та розбору model-ref |
+  | `plugin-sdk/interactive-runtime` | Допоміжні функції інтерактивних відповідей | Нормалізація / зменшення payload інтерактивних відповідей |
+  | `plugin-sdk/channel-config-primitives` | Примітиви конфігурації каналу | Вузькі примітиви channel config-schema |
+  | `plugin-sdk/channel-config-writes` | Допоміжні функції запису конфігурації каналу | Допоміжні функції авторизації запису конфігурації каналу |
+  | `plugin-sdk/channel-plugin-common` | Спільна прелюдія каналу | Експорти спільної прелюдії channel plugin |
+  | `plugin-sdk/channel-status` | Допоміжні функції статусу каналу | Спільні допоміжні функції знімка / підсумку статусу каналу |
+  | `plugin-sdk/allowlist-config-edit` | Допоміжні функції конфігурації allowlist | Допоміжні функції редагування / читання конфігурації allowlist |
+  | `plugin-sdk/group-access` | Допоміжні функції доступу до груп | Спільні допоміжні функції визначення доступу до груп |
+  | `plugin-sdk/direct-dm` | Допоміжні функції direct-DM | Спільні допоміжні функції auth / guard для direct-DM |
+  | `plugin-sdk/extension-shared` | Спільні допоміжні функції розширень | Примітиви допоміжних функцій passive-channel / status |
   | `plugin-sdk/webhook-targets` | Допоміжні функції цілей webhook | Реєстр цілей webhook і допоміжні функції встановлення маршрутів |
-  | `plugin-sdk/webhook-path` | Допоміжні функції шляху webhook | Допоміжні функції нормалізації шляху webhook |
-  | `plugin-sdk/web-media` | Спільні допоміжні функції web media | Допоміжні функції завантаження віддаленого/локального медіа |
+  | `plugin-sdk/webhook-path` | Допоміжні функції шляхів webhook | Допоміжні функції нормалізації шляхів webhook |
+  | `plugin-sdk/web-media` | Спільні допоміжні функції web media | Допоміжні функції завантаження віддалених / локальних медіа |
   | `plugin-sdk/zod` | Повторний експорт Zod | Повторно експортований `zod` для споживачів plugin SDK |
-  | `plugin-sdk/memory-core` | Допоміжні функції bundled memory-core | Поверхня допоміжних функцій memory manager/config/file/CLI |
-  | `plugin-sdk/memory-core-engine-runtime` | Фасад середовища виконання engine пам’яті | Фасад середовища виконання index/search пам’яті |
-  | `plugin-sdk/memory-core-host-engine-foundation` | Базовий engine host пам’яті | Експорти базового engine host пам’яті |
-  | `plugin-sdk/memory-core-host-engine-embeddings` | Engine embedding для host пам’яті | Експорти engine embedding для host пам’яті |
-  | `plugin-sdk/memory-core-host-engine-qmd` | Engine QMD для host пам’яті | Експорти engine QMD для host пам’яті |
-  | `plugin-sdk/memory-core-host-engine-storage` | Engine зберігання для host пам’яті | Експорти engine зберігання для host пам’яті |
-  | `plugin-sdk/memory-core-host-multimodal` | Допоміжні функції мультимодального host пам’яті | Допоміжні функції мультимодального host пам’яті |
-  | `plugin-sdk/memory-core-host-query` | Допоміжні функції запитів host пам’яті | Допоміжні функції запитів host пам’яті |
-  | `plugin-sdk/memory-core-host-secret` | Допоміжні функції секретів host пам’яті | Допоміжні функції секретів host пам’яті |
-  | `plugin-sdk/memory-core-host-status` | Допоміжні функції статусу host пам’яті | Допоміжні функції статусу host пам’яті |
-  | `plugin-sdk/memory-core-host-runtime-cli` | Середовище виконання CLI host пам’яті | Допоміжні функції середовища виконання CLI host пам’яті |
-  | `plugin-sdk/memory-core-host-runtime-core` | Базове середовище виконання host пам’яті | Допоміжні функції базового середовища виконання host пам’яті |
-  | `plugin-sdk/memory-core-host-runtime-files` | Допоміжні функції файлів/середовища виконання host пам’яті | Допоміжні функції файлів/середовища виконання host пам’яті |
-  | `plugin-sdk/memory-lancedb` | Допоміжні функції bundled memory-lancedb | Поверхня допоміжних функцій memory-lancedb |
-  | `plugin-sdk/testing` | Утиліти тестування | Допоміжні функції тестування та mock-об’єкти |
+  | `plugin-sdk/memory-core` | Вбудовані допоміжні функції memory-core | Поверхня допоміжних функцій менеджера пам’яті / конфігурації / файлів / CLI |
+  | `plugin-sdk/memory-core-engine-runtime` | Фасад runtime рушія пам’яті | Фасад runtime індексації / пошуку пам’яті |
+  | `plugin-sdk/memory-core-host-engine-foundation` | Базовий рушій memory host | Експорти базового рушія memory host |
+  | `plugin-sdk/memory-core-host-engine-embeddings` | Рушій embedding memory host | Експорти рушія embedding memory host |
+  | `plugin-sdk/memory-core-host-engine-qmd` | Рушій QMD memory host | Експорти рушія QMD memory host |
+  | `plugin-sdk/memory-core-host-engine-storage` | Рушій сховища memory host | Експорти рушія сховища memory host |
+  | `plugin-sdk/memory-core-host-multimodal` | Допоміжні функції multimodal memory host | Допоміжні функції multimodal memory host |
+  | `plugin-sdk/memory-core-host-query` | Допоміжні функції query memory host | Допоміжні функції query memory host |
+  | `plugin-sdk/memory-core-host-secret` | Допоміжні функції secret memory host | Допоміжні функції secret memory host |
+  | `plugin-sdk/memory-core-host-events` | Допоміжні функції журналу подій memory host | Допоміжні функції журналу подій memory host |
+  | `plugin-sdk/memory-core-host-status` | Допоміжні функції статусу memory host | Допоміжні функції статусу memory host |
+  | `plugin-sdk/memory-core-host-runtime-cli` | CLI runtime memory host | Допоміжні функції CLI runtime memory host |
+  | `plugin-sdk/memory-core-host-runtime-core` | Core runtime memory host | Допоміжні функції core runtime memory host |
+  | `plugin-sdk/memory-core-host-runtime-files` | Допоміжні функції файлів / runtime memory host | Допоміжні функції файлів / runtime memory host |
+  | `plugin-sdk/memory-host-core` | Псевдонім core runtime memory host | Нейтральний щодо постачальника псевдонім допоміжних функцій core runtime memory host |
+  | `plugin-sdk/memory-host-events` | Псевдонім журналу подій memory host | Нейтральний щодо постачальника псевдонім допоміжних функцій журналу подій memory host |
+  | `plugin-sdk/memory-host-files` | Псевдонім файлів / runtime memory host | Нейтральний щодо постачальника псевдонім допоміжних функцій файлів / runtime memory host |
+  | `plugin-sdk/memory-host-markdown` | Допоміжні функції керованого markdown | Спільні допоміжні функції керованого markdown для плагінів, суміжних із пам’яттю |
+  | `plugin-sdk/memory-host-search` | Фасад пошуку активної пам’яті | Лінивий фасад runtime менеджера пошуку активної пам’яті |
+  | `plugin-sdk/memory-host-status` | Псевдонім статусу memory host | Нейтральний щодо постачальника псевдонім допоміжних функцій статусу memory host |
+  | `plugin-sdk/memory-lancedb` | Вбудовані допоміжні функції memory-lancedb | Поверхня допоміжних функцій memory-lancedb |
+  | `plugin-sdk/testing` | Утиліти тестування | Допоміжні функції тестування та mocks |
 </Accordion>
 
 Ця таблиця навмисно містить поширену підмножину для міграції, а не повну
 поверхню SDK. Повний список із понад 200 точок входу міститься у
 `scripts/lib/plugin-sdk-entrypoints.json`.
 
-Цей список усе ще включає деякі допоміжні шви bundled-plugin, такі як
-`plugin-sdk/feishu`, `plugin-sdk/feishu-setup`, `plugin-sdk/zalo`,
-`plugin-sdk/zalo-setup` і `plugin-sdk/matrix*`. Вони й далі експортуються для
-підтримки bundled-plugin і сумісності, але навмисно
-пропущені з таблиці поширеної міграції й не є рекомендованою ціллю для
-нового коду plugin.
+Цей список досі містить деякі seam-інтерфейси допоміжних функцій вбудованих
+плагінів, наприклад `plugin-sdk/feishu`, `plugin-sdk/feishu-setup`,
+`plugin-sdk/zalo`, `plugin-sdk/zalo-setup` і `plugin-sdk/matrix*`. Вони
+й надалі експортуються для підтримки та сумісності вбудованих плагінів, але їх
+навмисно пропущено в таблиці поширених шляхів міграції, і вони не є
+рекомендованою ціллю для нового коду плагінів.
 
-Те саме правило застосовується до інших сімейств вбудованих допоміжних функцій, таких як:
+Те саме правило застосовується до інших сімейств вбудованих допоміжних
+функцій, таких як:
 
-- допоміжні функції підтримки browser: `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-support`
+- допоміжні функції підтримки браузера: `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-support`
 - Matrix: `plugin-sdk/matrix*`
 - LINE: `plugin-sdk/line*`
 - IRC: `plugin-sdk/irc*`
-- поверхні вбудованих допоміжних функцій/plugin, такі як `plugin-sdk/googlechat`,
+- поверхні вбудованих допоміжних функцій / плагінів, такі як `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`,
@@ -328,22 +347,22 @@ plugin не повинні їх використовувати, а наявні
   `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.
 
-## Хронологія видалення
+## Часова шкала видалення
 
-| Коли | Що відбувається |
-| --- | --- |
-| **Зараз** | Застарілі поверхні виводять попередження під час виконання |
-| **Наступний мажорний реліз** | Застарілі поверхні буде видалено; plugins, які все ще їх використовують, перестануть працювати |
+| Коли                   | Що відбувається                                                         |
+| ---------------------- | ----------------------------------------------------------------------- |
+| **Зараз**              | Застарілі поверхні виводять попередження під час виконання              |
+| **Наступний мажорний випуск** | Застарілі поверхні буде видалено; плагіни, які їх досі використовують, перестануть працювати |
 
-Усі core plugins уже мігровано. Зовнішнім plugins слід виконати міграцію
-до наступного мажорного релізу.
+Усі основні плагіни вже перенесено. Зовнішні плагіни слід перенести до
+наступного мажорного випуску.
 
 ## Тимчасове приглушення попереджень
 
@@ -354,13 +373,13 @@ OPENCLAW_SUPPRESS_PLUGIN_SDK_COMPAT_WARNING=1 openclaw gateway run
 OPENCLAW_SUPPRESS_EXTENSION_API_WARNING=1 openclaw gateway run
 ```
 
-Це тимчасовий обхідний шлях, а не постійне рішення.
+Це тимчасовий обхідний механізм, а не постійне рішення.
 
 ## Пов’язане
 
-- [Початок роботи](/plugins/building-plugins) — створіть свій перший plugin
-- [Огляд SDK](/plugins/sdk-overview) — повний довідник імпорту підшляхів
-- [Plugins channel](/plugins/sdk-channel-plugins) — створення plugins channel
-- [Plugins provider](/plugins/sdk-provider-plugins) — створення plugins provider
-- [Внутрішня будова plugin](/plugins/architecture) — глибокий розбір архітектури
-- [Маніфест plugin](/plugins/manifest) — довідник зі схеми маніфесту
+- [Початок роботи](/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) — довідник схеми маніфесту

docs/uk/plugins/sdk-overview.md

@@ -4,27 +4,27 @@ read_when:
     - Вам потрібен довідник для всіх методів реєстрації в OpenClawPluginApi
     - Ви шукаєте конкретний експорт SDK
 sidebarTitle: SDK Overview
-summary: Карта імпорту, довідник API реєстрації та архітектура SDK
+summary: Карта імпортів, довідник API реєстрації та архітектура SDK
 title: Огляд Plugin SDK
 x-i18n:
-    generated_at: "2026-04-05T18:49:41Z"
+    generated_at: "2026-04-05T21:37:00Z"
     model: gpt-5.4
     provider: openai
-    source_hash: d70ea8cc1343b2dc1b4243b0562d19bebb1fdf7eb5065220b17e87cfd8aecc3e
+    source_hash: 16f570adb0f98c70862fe1adbe875d217a350f1945159e6f1de66081a0e5a09a
     source_path: plugins/sdk-overview.md
     workflow: 15
 ---
 
 # Огляд Plugin SDK
 
-Plugin SDK — це типізований контракт між plugins і ядром. Ця сторінка є
-довідником про **що імпортувати** і **що можна реєструвати**.
+Plugin SDK — це типізований контракт між plugins і core. Ця сторінка є
+довідником для **того, що імпортувати** і **що можна реєструвати**.
 
 <Tip>
-  **Шукаєте покроковий посібник?**
+  **Шукаєте практичний посібник?**
   - Перший plugin? Почніть із [Getting Started](/uk/plugins/building-plugins)
-  - Plugin каналу? Дивіться [Channel Plugins](/uk/plugins/sdk-channel-plugins)
-  - Plugin постачальника? Дивіться [Provider Plugins](/uk/plugins/sdk-provider-plugins)
+  - Channel plugin? Дивіться [Channel Plugins](/uk/plugins/sdk-channel-plugins)
+  - Provider plugin? Дивіться [Provider Plugins](/uk/plugins/sdk-provider-plugins)
 </Tip>
 
 ## Угода щодо імпорту
@@ -36,247 +36,253 @@ import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 import { defineChannelPluginEntry } from "openclaw/plugin-sdk/channel-core";
 ```
 
-Кожен підшлях — це невеликий самодостатній модуль. Це забезпечує швидкий
-запуск і запобігає проблемам із циклічними залежностями. Для специфічних для
-каналів допоміжних засобів entry/build віддавайте перевагу
-`openclaw/plugin-sdk/channel-core`; залишайте `openclaw/plugin-sdk/core` для
-ширшої узагальненої поверхні та спільних помічників, таких як
+Кожен підшлях — це невеликий самодостатній модуль. Це зберігає швидкий запуск і
+запобігає проблемам із циклічними залежностями. Для специфічних для channel
+допоміжних засобів entry/build віддавайте перевагу `openclaw/plugin-sdk/channel-core`; `openclaw/plugin-sdk/core` залишайте
+для ширшої узагальненої поверхні та спільних допоміжних засобів, таких як
 `buildChannelConfigSchema`.
 
-Не додавайте й не використовуйте зручні шви, названі на честь постачальників,
-такі як `openclaw/plugin-sdk/slack`, `openclaw/plugin-sdk/discord`,
+Не додавайте й не використовуйте зручні seams з іменами provider, такі як
+`openclaw/plugin-sdk/slack`, `openclaw/plugin-sdk/discord`,
 `openclaw/plugin-sdk/signal`, `openclaw/plugin-sdk/whatsapp`, або
-допоміжні шви з брендуванням каналів. Вбудовані plugins мають компонувати
-узагальнені підшляхи SDK у власних barrel-файлах `api.ts` або `runtime-api.ts`,
-а ядро має або використовувати ці локальні barrel-файли plugin, або додавати
-вузький узагальнений контракт SDK, коли потреба справді є міжканальною.
+допоміжні seams із брендуванням channel. Bundled plugins мають компонувати узагальнені
+підшляхи SDK у власних barrel-файлах `api.ts` або `runtime-api.ts`, а core
+має або використовувати ці локальні для plugin barrel-файли, або додавати вузький узагальнений SDK
+контракт, коли потреба справді є міжканальною.
 
-Згенерована карта експортів усе ще містить невеликий набір допоміжних швів
-вбудованих plugins, таких як `plugin-sdk/feishu`, `plugin-sdk/feishu-setup`,
+Згенерована карта експортів усе ще містить невеликий набір допоміжних
+seams для bundled plugins, таких як `plugin-sdk/feishu`, `plugin-sdk/feishu-setup`,
 `plugin-sdk/zalo`, `plugin-sdk/zalo-setup` і `plugin-sdk/matrix*`. Ці
-підшляхи існують лише для підтримки та сумісності вбудованих plugins; вони
-навмисно не включені до загальної таблиці нижче і не є рекомендованим шляхом
-імпорту для нових сторонніх plugins.
+підшляхи існують лише для супроводу bundled plugins і сумісності; їх
+навмисно не включено до поширеної таблиці нижче, і вони не є рекомендованим
+шляхом імпорту для нових сторонніх plugins.
 
 ## Довідник підшляхів
 
-Найуживаніші підшляхи, згруповані за призначенням. Згенерований повний список
-із понад 200 підшляхів міститься у `scripts/lib/plugin-sdk-entrypoints.json`.
+Найуживаніші підшляхи, згруповані за призначенням. Згенерований повний список із
+понад 200 підшляхів міститься в `scripts/lib/plugin-sdk-entrypoints.json`.
 
-Зарезервовані допоміжні підшляхи вбудованих plugins усе ще з’являються в цьому
-згенерованому списку. Розглядайте їх як поверхні деталей реалізації/сумісності,
-якщо лише сторінка документації явно не просуває одну з них як публічну.
+Зарезервовані допоміжні підшляхи bundled plugins усе ще з’являються в цьому згенерованому списку.
+Розглядайте їх як деталі реалізації / поверхні сумісності, якщо лише якась сторінка документації
+явно не позначає один із них як публічний.
 
-### Entry plugin
+### Plugin entry
 
-| Підшлях                    | Ключові експорти                                                                                                                      |
-| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
+| Subpath                     | Key exports                                                                                                                            |
+| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
 | `plugin-sdk/plugin-entry`   | `definePluginEntry`                                                                                                                    |
 | `plugin-sdk/core`           | `defineChannelPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase`, `defineSetupPluginEntry`, `buildChannelConfigSchema` |
 | `plugin-sdk/config-schema`  | `OpenClawSchema`                                                                                                                       |
 | `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry`                                                                                                      |
 
 <AccordionGroup>
-  <Accordion title="Підшляхи каналів">
-    | Підшлях | Ключові експорти |
+  <Accordion title="Підшляхи channel">
+    | Subpath | Key exports |
     | --- | --- |
     | `plugin-sdk/channel-core` | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` |
-    | `plugin-sdk/config-schema` | Експорт кореневої Zod-схеми `openclaw.json` (`OpenClawSchema`) |
+    | `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` | Помічники для конфігурації/обмеження дій для кількох облікових записів, помічники резервного переходу на типовий обліковий запис |
-    | `plugin-sdk/account-id` | `DEFAULT_ACCOUNT_ID`, помічники нормалізації id облікового запису |
-    | `plugin-sdk/account-resolution` | Помічники пошуку облікового запису + резервного переходу до типового |
-    | `plugin-sdk/account-helpers` | Вузькі помічники для списку облікових записів/дій з обліковими записами |
+    | `plugin-sdk/account-core` | Допоміжні засоби для конфігурації/контролю дій для кількох облікових записів, допоміжні засоби резервного використання облікового запису за замовчуванням |
+    | `plugin-sdk/account-id` | `DEFAULT_ACCOUNT_ID`, допоміжні засоби нормалізації 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` | Типи схеми конфігурації каналу |
-    | `plugin-sdk/telegram-command-config` | Помічники нормалізації/валідації користувацьких команд Telegram із резервною підтримкою вбудованого контракту |
+    | `plugin-sdk/channel-config-schema` | Типи схеми конфігурації channel |
+    | `plugin-sdk/telegram-command-config` | Допоміжні засоби нормалізації/валідації користувацьких команд Telegram із резервною підтримкою bundled-контракту |
     | `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` | Застарілий побудовник медіа-пейлоаду агента |
-    | `plugin-sdk/conversation-runtime` | Помічники прив’язки розмови/потоку, pairing і configured-binding |
-    | `plugin-sdk/runtime-config-snapshot` | Помічник знімка конфігурації часу виконання |
-    | `plugin-sdk/runtime-group-policy` | Помічники визначення group-policy під час виконання |
-    | `plugin-sdk/channel-status` | Спільні помічники знімка/зведення статусу каналу |
-    | `plugin-sdk/channel-config-primitives` | Вузькі примітиви config-schema каналу |
-    | `plugin-sdk/channel-config-writes` | Помічники авторизації запису конфігурації каналу |
-    | `plugin-sdk/channel-plugin-common` | Спільні прелюд-експорти plugin каналу |
-    | `plugin-sdk/allowlist-config-edit` | Помічники редагування/читання конфігурації списку дозволених |
-    | `plugin-sdk/group-access` | Спільні помічники рішень щодо group-access |
-    | `plugin-sdk/direct-dm` | Спільні помічники auth/guard для прямих DM |
-    | `plugin-sdk/interactive-runtime` | Помічники нормалізації/скорочення пейлоаду інтерактивних відповідей |
-    | `plugin-sdk/channel-inbound` | Debounce, зіставлення згадок, помічники envelope |
+    | `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` | Допоміжні засоби життєвого циклу thread-binding і адаптерів |
+    | `plugin-sdk/agent-media-payload` | Застарілий конструктор медіа payload агента |
+    | `plugin-sdk/conversation-runtime` | Допоміжні засоби прив’язки conversation/thread, pairing і configured-binding |
+    | `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` | Допоміжні засоби редагування/читання конфігурації allowlist |
+    | `plugin-sdk/group-access` | Спільні допоміжні засоби прийняття рішень щодо доступу груп |
+    | `plugin-sdk/direct-dm` | Спільні допоміжні засоби автентифікації/захисту direct-DM |
+    | `plugin-sdk/interactive-runtime` | Допоміжні засоби нормалізації/скорочення payload інтерактивних відповідей |
+    | `plugin-sdk/channel-inbound` | Допоміжні засоби debounce, зіставлення згадок і envelope |
     | `plugin-sdk/channel-send-result` | Типи результатів відповіді |
     | `plugin-sdk/channel-actions` | `createMessageToolButtonsSchema`, `createMessageToolCardSchema` |
-    | `plugin-sdk/channel-targets` | Помічники розбору/зіставлення цілей |
-    | `plugin-sdk/channel-contract` | Типи контракту каналу |
+    | `plugin-sdk/channel-targets` | Допоміжні засоби розбору/зіставлення цілей |
+    | `plugin-sdk/channel-contract` | Типи контракту channel |
     | `plugin-sdk/channel-feedback` | Підключення feedback/reaction |
   </Accordion>
 
-  <Accordion title="Підшляхи постачальників">
-    | Підшлях | Ключові експорти |
+  <Accordion title="Підшляхи provider">
+    | Subpath | Key exports |
     | --- | --- |
     | `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry` |
-    | `plugin-sdk/provider-setup` | Добірні помічники налаштування локальних/self-hosted постачальників |
-    | `plugin-sdk/self-hosted-provider-setup` | Сфокусовані помічники налаштування self-hosted постачальника, сумісного з OpenAI |
-    | `plugin-sdk/provider-auth-runtime` | Помічники визначення API-ключа під час виконання для plugins постачальників |
-    | `plugin-sdk/provider-auth-api-key` | Помічники онбордингу/запису профілю для API-ключів |
-    | `plugin-sdk/provider-auth-result` | Стандартний побудовник результату OAuth auth |
-    | `plugin-sdk/provider-auth-login` | Спільні помічники інтерактивного входу для plugins постачальників |
-    | `plugin-sdk/provider-env-vars` | Помічники пошуку env vars auth постачальника |
+    | `plugin-sdk/provider-setup` | Відібрані допоміжні засоби налаштування локальних/self-hosted provider |
+    | `plugin-sdk/self-hosted-provider-setup` | Сфокусовані допоміжні засоби налаштування self-hosted provider, сумісних з OpenAI |
+    | `plugin-sdk/provider-auth-runtime` | Допоміжні засоби визначення API-ключа під час виконання для provider plugins |
+    | `plugin-sdk/provider-auth-api-key` | Допоміжні засоби онбордингу API-ключа / запису профілю |
+    | `plugin-sdk/provider-auth-result` | Стандартний конструктор результату OAuth-автентифікації |
+    | `plugin-sdk/provider-auth-login` | Спільні допоміжні засоби інтерактивного входу для provider plugins |
+    | `plugin-sdk/provider-env-vars` | Допоміжні засоби пошуку env vars автентифікації provider |
     | `plugin-sdk/provider-auth` | `createProviderApiKeyAuthMethod`, `ensureApiKeyFromOptionEnvOrPrompt`, `upsertAuthProfile` |
-    | `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні побудовники replay-policy, помічники endpoint постачальників і помічники нормалізації model-id, такі як `normalizeNativeXaiModelId` |
+    | `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні конструктори політик replay, допоміжні засоби endpoint provider і допоміжні засоби нормалізації id моделей, такі як `normalizeNativeXaiModelId` |
     | `plugin-sdk/provider-catalog-shared` | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` |
-    | `plugin-sdk/provider-http` | Узагальнені помічники HTTP/можливостей endpoint постачальника |
-    | `plugin-sdk/provider-web-fetch` | Помічники реєстрації/кешу постачальника web-fetch |
-    | `plugin-sdk/provider-web-search` | Помічники реєстрації/кешу/конфігурації постачальника web-search |
-    | `plugin-sdk/provider-tools` | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, очищення схеми Gemini + діагностика та помічники сумісності xAI, такі як `resolveXaiModelCompatPatch` / `applyXaiModelCompat` |
-    | `plugin-sdk/provider-usage` | `fetchClaudeUsage` та подібне |
-    | `plugin-sdk/provider-stream` | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, типи обгорток потоку та спільні помічники обгорток 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` | Допоміжні засоби реєстрації/кешування/конфігурації 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 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 |
   </Accordion>
 
-  <Accordion title="Підшляхи auth і безпеки">
-    | Підшлях | Ключові експорти |
+  <Accordion title="Підшляхи автентифікації та безпеки">
+    | Subpath | Key exports |
     | --- | --- |
-    | `plugin-sdk/command-auth` | `resolveControlCommandGate`, помічники реєстру команд, помічники авторизації відправника |
-    | `plugin-sdk/approval-auth-runtime` | Помічники визначення approver і auth дій у тому самому чаті |
-    | `plugin-sdk/approval-client-runtime` | Помічники профілю/фільтра native exec approval |
+    | `plugin-sdk/command-auth` | `resolveControlCommandGate`, допоміжні засоби реєстру команд, допоміжні засоби авторизації відправника |
+    | `plugin-sdk/approval-auth-runtime` | Допоміжні засоби визначення погоджувача та автентифікації дій у тому самому чаті |
+    | `plugin-sdk/approval-client-runtime` | Допоміжні засоби профілю/фільтра native exec approval |
     | `plugin-sdk/approval-delivery-runtime` | Адаптери native approval capability/delivery |
-    | `plugin-sdk/approval-native-runtime` | Помічники native approval target + прив’язки облікового запису |
-    | `plugin-sdk/approval-reply-runtime` | Помічники пейлоаду відповіді exec/plugin approval |
-    | `plugin-sdk/command-auth-native` | Native command auth + помічники native session-target |
-    | `plugin-sdk/command-detection` | Спільні помічники визначення команд |
-    | `plugin-sdk/command-surface` | Помічники нормалізації тіла команди й командної поверхні |
+    | `plugin-sdk/approval-native-runtime` | Допоміжні засоби цілі native approval + прив’язки облікового запису |
+    | `plugin-sdk/approval-reply-runtime` | Допоміжні засоби payload відповіді для exec/plugin approval |
+    | `plugin-sdk/command-auth-native` | Допоміжні засоби native command auth + native session-target |
+    | `plugin-sdk/command-detection` | Спільні допоміжні засоби виявлення команд |
+    | `plugin-sdk/command-surface` | Допоміжні засоби нормалізації тіла команди та поверхні команди |
     | `plugin-sdk/allow-from` | `formatAllowFromLowercase` |
-    | `plugin-sdk/security-runtime` | Спільні помічники довіри, DM gating, external-content і збору секретів |
-    | `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` | Помічники розміру тіла запиту/timeout |
+    | `plugin-sdk/security-runtime` | Спільні допоміжні засоби довіри, DM gating, external-content і збирання секретів |
+    | `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 та сховища">
+    | Subpath | Key exports |
     | --- | --- |
-    | `plugin-sdk/runtime` | Широка поверхня помічників runtime/logging/backup/install plugin |
-    | `plugin-sdk/runtime-env` | Вузькі помічники env runtime, logger, timeout, retry і backoff |
+    | `plugin-sdk/runtime` | Широка поверхня допоміжних засобів runtime/логування/резервного копіювання/встановлення plugin |
+    | `plugin-sdk/runtime-env` | Вузькі допоміжні засоби runtime env, logger, timeout, retry і backoff |
     | `plugin-sdk/runtime-store` | `createPluginRuntimeStore` |
-    | `plugin-sdk/plugin-runtime` | Спільні помічники команд/hook/http/interactive plugin |
-    | `plugin-sdk/hook-runtime` | Спільні помічники pipeline 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 і виправлення статусу каналу |
-    | `plugin-sdk/config-runtime` | Помічники завантаження/запису конфігурації |
-    | `plugin-sdk/telegram-command-config` | Нормалізація імен/описів команд Telegram та перевірки дублікатів/конфліктів, навіть коли поверхня контракту вбудованого Telegram недоступна |
-    | `plugin-sdk/approval-runtime` | Помічники exec/plugin approval, побудовники approval-capability, помічники auth/profile, native routing/runtime |
-    | `plugin-sdk/reply-runtime` | Спільні помічники runtime для вхідних повідомлень/відповідей, chunking, dispatch, heartbeat, planner відповіді |
-    | `plugin-sdk/reply-dispatch-runtime` | Вузькі помічники dispatch/finalize відповіді |
-    | `plugin-sdk/reply-history` | Спільні помічники reply-history для коротких вікон, такі як `buildHistoryContext`, `recordPendingHistoryEntry` і `clearHistoryEntriesIfEnabled` |
+    | `plugin-sdk/plugin-runtime` | Спільні допоміжні засоби команд/hook/http/interactive для plugin |
+    | `plugin-sdk/hook-runtime` | Спільні допоміжні засоби пайплайна webhook/internal hook |
+    | `plugin-sdk/lazy-runtime` | Допоміжні засоби lazy runtime import/binding, такі як `createLazyRuntimeModule`, `createLazyRuntimeMethod` і `createLazyRuntimeSurface` |
+    | `plugin-sdk/process-runtime` | Допоміжні засоби виконання процесів |
+    | `plugin-sdk/cli-runtime` | Допоміжні засоби форматування CLI, очікування та визначення версії |
+    | `plugin-sdk/gateway-runtime` | Допоміжні засоби клієнта gateway і patch стану channel |
+    | `plugin-sdk/config-runtime` | Допоміжні засоби завантаження/запису конфігурації |
+    | `plugin-sdk/telegram-command-config` | Допоміжні засоби нормалізації назв/описів команд Telegram і перевірки дублікатів/конфліктів, навіть коли поверхня bundled контракту Telegram недоступна |
+    | `plugin-sdk/approval-runtime` | Допоміжні засоби exec/plugin approval, конструктори approval capability, допоміжні засоби auth/profile, native routing/runtime |
+    | `plugin-sdk/reply-runtime` | Спільні допоміжні засоби inbound/reply runtime, chunking, dispatch, heartbeat, планувальник відповідей |
+    | `plugin-sdk/reply-dispatch-runtime` | Вузькі допоміжні засоби dispatch/finalize відповіді |
+    | `plugin-sdk/reply-history` | Спільні допоміжні засоби коротковіконної історії відповідей, такі як `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` | Помічники шляхів до директорій state/OAuth |
-    | `plugin-sdk/routing` | Помічники маршруту/ключа сесії/прив’язки облікового запису, такі як `resolveAgentRoute`, `buildAgentSessionKey` і `resolveDefaultAgentBoundAccountId` |
-    | `plugin-sdk/status-helpers` | Спільні помічники зведення статусу каналу/облікового запису, типові значення runtime-state і помічники метаданих проблем |
-    | `plugin-sdk/target-resolver-runtime` | Спільні помічники визначення цілей |
-    | `plugin-sdk/string-normalization-runtime` | Помічники нормалізації slug/рядків |
-    | `plugin-sdk/request-url` | Витягуйте рядкові URL з вхідних даних на кшталт fetch/request |
+    | `plugin-sdk/reply-chunking` | Вузькі допоміжні засоби chunking тексту/markdown |
+    | `plugin-sdk/session-store-runtime` | Допоміжні засоби шляху сховища сесій + updated-at |
+    | `plugin-sdk/state-paths` | Допоміжні засоби шляхів до каталогів state/OAuth |
+    | `plugin-sdk/routing` | Допоміжні засоби маршрутизації/ключа сесії/прив’язки облікового запису, такі як `resolveAgentRoute`, `buildAgentSessionKey` і `resolveDefaultAgentBoundAccountId` |
+    | `plugin-sdk/status-helpers` | Спільні допоміжні засоби підсумку стану channel/облікового запису, значення за замовчуванням стану runtime і допоміжні засоби метаданих проблем |
+    | `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 ACP і dispatch відповіді |
-    | `plugin-sdk/agent-config-primitives` | Вузькі примітиви config-schema runtime агента |
-    | `plugin-sdk/boolean-param` | Читач параметрів для нестрогих булевих значень |
-    | `plugin-sdk/dangerous-name-runtime` | Помічники визначення збігів небезпечних імен |
-    | `plugin-sdk/device-bootstrap` | Помічники bootstrap пристрою і токенів pairing |
-    | `plugin-sdk/extension-shared` | Спільні примітиви для passive-channel і статусних помічників |
-    | `plugin-sdk/models-provider-runtime` | Помічники `/models` command/provider reply |
-    | `plugin-sdk/skill-commands-runtime` | Помічники переліку команд Skills |
-    | `plugin-sdk/native-command-registry` | Помічники реєстру/build/serialize native command |
-    | `plugin-sdk/provider-zai-endpoint` | Помічники визначення endpoint Z.A.I |
-    | `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` | Помічники директорії/ідентичності/workspace агента |
-    | `plugin-sdk/directory-runtime` | Запит/дедуплікація директорій на основі конфігурації |
+    | `plugin-sdk/param-readers` | Поширені читачі параметрів tool/CLI |
+    | `plugin-sdk/tool-send` | Витягування канонічних полів цілі надсилання з аргументів tool |
+    | `plugin-sdk/temp-path` | Спільні допоміжні засоби шляхів для тимчасових завантажень |
+    | `plugin-sdk/logging-core` | Допоміжні засоби subsystem logger і редагування конфіденційних даних |
+    | `plugin-sdk/markdown-table-runtime` | Допоміжні засоби режиму таблиць Markdown |
+    | `plugin-sdk/json-store` | Невеликі допоміжні засоби читання/запису стану JSON |
+    | `plugin-sdk/file-lock` | Допоміжні засоби повторно вхідного file-lock |
+    | `plugin-sdk/persistent-dedupe` | Допоміжні засоби дискового кешу dedupe |
+    | `plugin-sdk/acp-runtime` | Допоміжні засоби ACP runtime/session і dispatch відповіді |
+    | `plugin-sdk/agent-config-primitives` | Вузькі примітиви schema конфігурації runtime агента |
+    | `plugin-sdk/boolean-param` | Читач нестрогих булевих параметрів |
+    | `plugin-sdk/dangerous-name-runtime` | Допоміжні засоби визначення небезпечних імен |
+    | `plugin-sdk/device-bootstrap` | Допоміжні засоби початкової ініціалізації пристрою та токенів pairing |
+    | `plugin-sdk/extension-shared` | Спільні примітиви пасивного channel і допоміжних засобів стану |
+    | `plugin-sdk/models-provider-runtime` | Допоміжні засоби відповіді `/models` command/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` | Допоміжні засоби каталогу/ідентичності/workspace агента |
+    | `plugin-sdk/directory-runtime` | Запит каталогу на основі конфігурації / dedup |
     | `plugin-sdk/keyed-async-queue` | `KeyedAsyncQueue` |
   </Accordion>
 
   <Accordion title="Підшляхи можливостей і тестування">
-    | Підшлях | Ключові експорти |
+    | Subpath | Key exports |
     | --- | --- |
-    | `plugin-sdk/media-runtime` | Спільні помічники fetch/transform/store медіа, а також побудовники медіа-пейлоаду |
-    | `plugin-sdk/media-understanding` | Типи постачальників media understanding, а також експорти помічників зображень/аудіо для постачальників |
-    | `plugin-sdk/text-runtime` | Спільні помічники тексту/markdown/logging, такі як видалення видимого для асистента тексту, render/chunking/table-помічники markdown, помічники редагування, помічники тегів директив і утиліти безпечного тексту |
-    | `plugin-sdk/text-chunking` | Помічник chunking вихідного тексту |
-    | `plugin-sdk/speech` | Типи постачальників мовлення, а також помічники директив, реєстру та валідації для постачальників |
-    | `plugin-sdk/speech-core` | Спільні типи постачальників мовлення, реєстр, директиви та помічники нормалізації |
-    | `plugin-sdk/realtime-transcription` | Типи постачальників realtime transcription і помічники реєстру |
-    | `plugin-sdk/realtime-voice` | Типи постачальників realtime voice і помічники реєстру |
-    | `plugin-sdk/image-generation` | Типи постачальників генерації зображень |
-    | `plugin-sdk/image-generation-core` | Спільні типи генерації зображень, failover, auth і помічники реєстру |
-    | `plugin-sdk/video-generation` | Типи постачальників/запитів/результатів генерації відео |
-    | `plugin-sdk/video-generation-core` | Спільні типи генерації відео, помічники failover, пошук постачальника і розбір model-ref |
-    | `plugin-sdk/webhook-targets` | Помічники реєстру цілей webhook і встановлення маршрутів |
-    | `plugin-sdk/webhook-path` | Помічники нормалізації шляху webhook |
-    | `plugin-sdk/web-media` | Спільні помічники завантаження віддалених/локальних медіа |
-    | `plugin-sdk/zod` | Повторно експортований `zod` для користувачів plugin SDK |
+    | `plugin-sdk/media-runtime` | Спільні допоміжні засоби fetch/transform/store медіа, а також конструктори media payload |
+    | `plugin-sdk/media-understanding` | Типи provider для media understanding, а також допоміжні експорти для роботи з image/audio на стороні provider |
+    | `plugin-sdk/text-runtime` | Спільні допоміжні засоби тексту/markdown/логування, такі як видалення видимого для асистента тексту, render/chunking/table helpers для markdown, допоміжні засоби редагування конфіденційних даних, directive-tag helpers і утиліти безпечного тексту |
+    | `plugin-sdk/text-chunking` | Допоміжний засіб chunking вихідного тексту |
+    | `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 для генерації зображень |
+    | `plugin-sdk/image-generation-core` | Спільні типи image-generation, failover, auth і допоміжні засоби реєстру |
+    | `plugin-sdk/video-generation` | Типи provider/request/result для генерації відео |
+    | `plugin-sdk/video-generation-core` | Спільні типи video-generation, допоміжні засоби failover, lookup provider і розбору model-ref |
+    | `plugin-sdk/webhook-targets` | Допоміжні засоби реєстру цілей webhook і встановлення маршрутів |
+    | `plugin-sdk/webhook-path` | Допоміжні засоби нормалізації шляху webhook |
+    | `plugin-sdk/web-media` | Спільні допоміжні засоби завантаження віддалених/локальних медіа |
+    | `plugin-sdk/zod` | Повторно експортований `zod` для користувачів Plugin SDK |
     | `plugin-sdk/testing` | `installCommonResolveTargetErrorCases`, `shouldAckReaction` |
   </Accordion>
 
-  <Accordion title="Підшляхи пам’яті">
-    | Підшлях | Ключові експорти |
+  <Accordion title="Підшляхи memory">
+    | Subpath | Key exports |
     | --- | --- |
-    | `plugin-sdk/memory-core` | Поверхня допоміжних засобів вбудованого memory-core для manager/config/file/CLI |
-    | `plugin-sdk/memory-core-engine-runtime` | Фасад runtime індексації/пошуку пам’яті |
-    | `plugin-sdk/memory-core-host-engine-foundation` | Експорти foundation engine хоста пам’яті |
-    | `plugin-sdk/memory-core-host-engine-embeddings` | Експорти embedding engine хоста пам’яті |
-    | `plugin-sdk/memory-core-host-engine-qmd` | Експорти QMD engine хоста пам’яті |
-    | `plugin-sdk/memory-core-host-engine-storage` | Експорти storage engine хоста пам’яті |
-    | `plugin-sdk/memory-core-host-multimodal` | Мультимодальні помічники хоста пам’яті |
-    | `plugin-sdk/memory-core-host-query` | Помічники запитів хоста пам’яті |
-    | `plugin-sdk/memory-core-host-secret` | Помічники секретів хоста пам’яті |
-    | `plugin-sdk/memory-core-host-status` | Помічники статусу хоста пам’яті |
-    | `plugin-sdk/memory-core-host-runtime-cli` | Помічники runtime CLI хоста пам’яті |
-    | `plugin-sdk/memory-core-host-runtime-core` | Помічники core runtime хоста пам’яті |
-    | `plugin-sdk/memory-core-host-runtime-files` | Помічники файлів/runtime хоста пам’яті |
-    | `plugin-sdk/memory-lancedb` | Поверхня допоміжних засобів вбудованого memory-lancedb |
+    | `plugin-sdk/memory-core` | Поверхня допоміжних засобів bundled memory-core для manager/config/file/CLI |
+    | `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-events` | Допоміжні засоби журналу подій хоста memory |
+    | `plugin-sdk/memory-core-host-status` | Допоміжні засоби стану хоста memory |
+    | `plugin-sdk/memory-core-host-runtime-cli` | Допоміжні засоби runtime CLI хоста memory |
+    | `plugin-sdk/memory-core-host-runtime-core` | Допоміжні засоби core runtime хоста memory |
+    | `plugin-sdk/memory-core-host-runtime-files` | Допоміжні засоби file/runtime хоста memory |
+    | `plugin-sdk/memory-host-core` | Нейтральний до вендора псевдонім для допоміжних засобів core runtime хоста memory |
+    | `plugin-sdk/memory-host-events` | Нейтральний до вендора псевдонім для допоміжних засобів журналу подій хоста memory |
+    | `plugin-sdk/memory-host-files` | Нейтральний до вендора псевдонім для допоміжних засобів file/runtime хоста memory |
+    | `plugin-sdk/memory-host-markdown` | Спільні допоміжні засоби керованого markdown для plugins, суміжних із memory |
+    | `plugin-sdk/memory-host-search` | Активна runtime facade memory для доступу до search-manager |
+    | `plugin-sdk/memory-host-status` | Нейтральний до вендора псевдонім для допоміжних засобів стану хоста memory |
+    | `plugin-sdk/memory-lancedb` | Поверхня допоміжних засобів bundled memory-lancedb |
   </Accordion>
 
-  <Accordion title="Зарезервовані допоміжні підшляхи вбудованих компонентів">
-    | Сімейство | Поточні підшляхи | Призначене використання |
+  <Accordion title="Зарезервовані підшляхи bundled-helper">
+    | Family | Current subpaths | Intended use |
     | --- | --- | --- |
-    | Browser | `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-support` | Допоміжні засоби підтримки вбудованого browser plugin |
-    | 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` | Поверхня helper/runtime вбудованого Matrix |
-    | Line | `plugin-sdk/line`, `plugin-sdk/line-core`, `plugin-sdk/line-runtime`, `plugin-sdk/line-surface` | Поверхня helper/runtime вбудованого LINE |
-    | IRC | `plugin-sdk/irc`, `plugin-sdk/irc-surface` | Поверхня допоміжних засобів вбудованого IRC |
-    | Специфічні для каналу помічники | `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` | Шви сумісності/допоміжні шви вбудованих каналів |
-    | Специфічні для 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-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-support` | Допоміжні засоби підтримки bundled browser plugin |
+    | 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-specific 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` | Bundled seams сумісності/допоміжних засобів для channel |
+    | Auth/plugin-specific 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` | Bundled seams допоміжних засобів feature/plugin; `plugin-sdk/github-copilot-token` наразі експортує `DEFAULT_COPILOT_API_BASE_URL`, `deriveCopilotApiBaseUrlFromToken` і `resolveCopilotApiToken` |
   </Accordion>
 </AccordionGroup>
 
@@ -287,53 +293,55 @@ import { defineChannelPluginEntry } from "openclaw/plugin-sdk/channel-core";
 
 ### Реєстрація можливостей
 
-| Метод                                            | Що реєструє                    |
-| ------------------------------------------------ | ------------------------------ |
-| `api.registerProvider(...)`                      | Текстовий inference (LLM)      |
-| `api.registerChannel(...)`                       | Канал повідомлень              |
-| `api.registerSpeechProvider(...)`                | Синтез text-to-speech / STT    |
-| `api.registerRealtimeTranscriptionProvider(...)` | Потокова transcription realtime |
-| `api.registerRealtimeVoiceProvider(...)`         | Двобічні сесії realtime voice  |
-| `api.registerMediaUnderstandingProvider(...)`    | Аналіз зображень/аудіо/відео   |
-| `api.registerImageGenerationProvider(...)`       | Генерація зображень            |
-| `api.registerVideoGenerationProvider(...)`       | Генерація відео                |
-| `api.registerWebFetchProvider(...)`              | Постачальник web fetch / scrape |
-| `api.registerWebSearchProvider(...)`             | Вебпошук                       |
+| Method                                           | What it registers                |
+| ------------------------------------------------ | -------------------------------- |
+| `api.registerProvider(...)`                      | Текстовий inference (LLM)        |
+| `api.registerChannel(...)`                       | Канал обміну повідомленнями      |
+| `api.registerSpeechProvider(...)`                | Синтез text-to-speech / STT      |
+| `api.registerRealtimeTranscriptionProvider(...)` | Потокова realtime transcription  |
+| `api.registerRealtimeVoiceProvider(...)`         | Дуплексні сесії realtime voice   |
+| `api.registerMediaUnderstandingProvider(...)`    | Аналіз зображень/аудіо/відео     |
+| `api.registerImageGenerationProvider(...)`       | Генерація зображень              |
+| `api.registerVideoGenerationProvider(...)`       | Генерація відео                  |
+| `api.registerWebFetchProvider(...)`              | Provider для web fetch / scrape  |
+| `api.registerWebSearchProvider(...)`             | Вебпошук                         |
 
 ### Tools і команди
 
-| Метод                          | Що реєструє                                   |
-| ------------------------------ | --------------------------------------------- |
-| `api.registerTool(tool, opts?)` | Agent tool (обов’язковий або `{ optional: true }`) |
+| Method                          | What it registers                             |
+| ------------------------------- | --------------------------------------------- |
+| `api.registerTool(tool, opts?)` | Tool агента (обов’язковий або `{ optional: true }`) |
 | `api.registerCommand(def)`      | Користувацька команда (обходить LLM)          |
 
 ### Інфраструктура
 
-| Метод                                         | Що реєструє           |
-| --------------------------------------------- | --------------------- |
-| `api.registerHook(events, handler, opts?)`     | Hook події            |
-| `api.registerHttpRoute(params)`                | HTTP endpoint gateway |
-| `api.registerGatewayMethod(name, handler)`     | RPC-метод gateway     |
-| `api.registerCli(registrar, opts?)`            | Підкоманду CLI        |
-| `api.registerService(service)`                 | Фоновий сервіс        |
-| `api.registerInteractiveHandler(registration)` | Інтерактивний handler |
+| Method                                         | What it registers                       |
+| ---------------------------------------------- | --------------------------------------- |
+| `api.registerHook(events, handler, opts?)`     | Hook подій                              |
+| `api.registerHttpRoute(params)`                | HTTP endpoint gateway                   |
+| `api.registerGatewayMethod(name, handler)`     | RPC-метод gateway                       |
+| `api.registerCli(registrar, opts?)`            | Підкоманда CLI                          |
+| `api.registerService(service)`                 | Фонова служба                           |
+| `api.registerInteractiveHandler(registration)` | Інтерактивний обробник                  |
+| `api.registerMemoryPromptSupplement(builder)`  | Додатковий суміжний із memory розділ prompt |
+| `api.registerMemoryCorpusSupplement(adapter)`  | Додатковий корпус для пошуку/читання memory |
 
-Зарезервовані простори імен core admin (`config.*`, `exec.approvals.*`, `wizard.*`,
-`update.*`) завжди залишаються `operator.admin`, навіть якщо plugin намагається
-призначити вужчу область gateway method. Для методів, що належать plugin,
-віддавайте перевагу префіксам, специфічним для plugin.
+Зарезервовані простори назв адміністрування core (`config.*`, `exec.approvals.*`, `wizard.*`,
+`update.*`) завжди залишаються `operator.admin`, навіть якщо plugin намагається призначити
+вужчу область видимості методу gateway. Для
+методів, що належать plugin, віддавайте перевагу префіксам, специфічним для plugin.
 
 ### Метадані реєстрації CLI
 
-`api.registerCli(registrar, opts?)` приймає два типи метаданих верхнього рівня:
+`api.registerCli(registrar, opts?)` приймає два види метаданих верхнього рівня:
 
-- `commands`: явні корені команд, що належать registrar
-- `descriptors`: дескриптори команд на етапі розбору, що використовуються для
-  довідки кореневого CLI, маршрутизації та лінивої реєстрації CLI plugin
+- `commands`: явні корені команд, якими володіє реєстратор
+- `descriptors`: дескриптори команд на етапі розбору, що використовуються для довідки кореневого CLI,
+  маршрутизації та лінивої реєстрації CLI plugin
 
-Якщо ви хочете, щоб команда plugin залишалася ліниво завантажуваною в
-звичайному шляху кореневого CLI, надайте `descriptors`, які охоплюють кожен
-корінь команди верхнього рівня, що надається цим registrar.
+Якщо ви хочете, щоб команда plugin залишалася ліниво завантажуваною у звичайному шляху кореневого CLI,
+надайте `descriptors`, які охоплюють кожен корінь команди верхнього рівня, що надається цим
+реєстратором.
 
 ```typescript
 api.registerCli(
@@ -345,7 +353,7 @@ api.registerCli(
     descriptors: [
       {
         name: "matrix",
-        description: "Керуйте обліковими записами Matrix, верифікацією, пристроями та станом профілю",
+        description: "Керування обліковими записами Matrix, верифікацією, пристроями та станом профілю",
         hasSubcommands: true,
       },
     ],
@@ -353,121 +361,117 @@ api.registerCli(
 );
 ```
 
-Використовуйте `commands` окремо лише тоді, коли вам не потрібна лінива
-реєстрація кореневого CLI. Цей сумісний eager-шлях усе ще підтримується, але
-він не встановлює placeholders на основі descriptor для лінивого завантаження
-на етапі розбору.
+Використовуйте `commands` окремо лише тоді, коли вам не потрібна лінива реєстрація кореневого CLI.
+Цей шлях eager сумісності залишається підтримуваним, але він не встановлює
+плейсхолдери на основі descriptor для лінивого завантаження на етапі розбору.
 
 ### Ексклюзивні слоти
 
-| Метод                                      | Що реєструє                          |
-| ------------------------------------------ | ------------------------------------ |
+| Method                                     | What it registers                     |
+| ------------------------------------------ | ------------------------------------- |
 | `api.registerContextEngine(id, factory)`   | Context engine (одночасно активний лише один) |
-| `api.registerMemoryPromptSection(builder)` | Побудовник секції prompt пам’яті     |
-| `api.registerMemoryFlushPlan(resolver)`    | Resolver плану скидання пам’яті      |
-| `api.registerMemoryRuntime(runtime)`       | Адаптер runtime пам’яті              |
+| `api.registerMemoryPromptSection(builder)` | Конструктор розділу prompt для memory |
+| `api.registerMemoryFlushPlan(resolver)`    | Resolver плану flush для memory       |
+| `api.registerMemoryRuntime(runtime)`       | Адаптер runtime для memory            |
 
-### Адаптери embeddings пам’яті
+### Адаптери вбудовування memory
 
-| Метод                                          | Що реєструє                                      |
-| ---------------------------------------------- | ------------------------------------------------ |
-| `api.registerMemoryEmbeddingProvider(adapter)` | Адаптер embeddings пам’яті для активного plugin |
+| Method                                         | What it registers                              |
+| ---------------------------------------------- | ---------------------------------------------- |
+| `api.registerMemoryEmbeddingProvider(adapter)` | Адаптер вбудовування memory для активного plugin |
 
 - `registerMemoryPromptSection`, `registerMemoryFlushPlan` і
-  `registerMemoryRuntime` є ексклюзивними для plugins пам’яті.
-- `registerMemoryEmbeddingProvider` дозволяє активному plugin пам’яті
-  зареєструвати один або кілька id адаптерів embeddings (наприклад `openai`,
-  `gemini` або користувацький id, визначений plugin).
-- Користувацька конфігурація, така як `agents.defaults.memorySearch.provider` і
-  `agents.defaults.memorySearch.fallback`, визначається відносно зареєстрованих
-  id цих адаптерів.
+  `registerMemoryRuntime` є ексклюзивними для memory plugins.
+- `registerMemoryEmbeddingProvider` дозволяє активному memory plugin реєструвати один
+  або більше id адаптерів вбудовування (наприклад `openai`, `gemini` або користувацький
+  id, визначений plugin).
+- Конфігурація користувача, така як `agents.defaults.memorySearch.provider` і
+  `agents.defaults.memorySearch.fallback`, визначається відносно цих зареєстрованих
+  id адаптерів.
 
 ### Події та життєвий цикл
 
-| Метод                                       | Що робить                    |
-| ------------------------------------------- | ---------------------------- |
-| `api.on(hookName, handler, opts?)`           | Типізований hook життєвого циклу |
-| `api.onConversationBindingResolved(handler)` | Колбек прив’язки розмови     |
+| Method                                       | What it does                  |
+| -------------------------------------------- | ----------------------------- |
+| `api.on(hookName, handler, opts?)`           | Типізований lifecycle hook    |
+| `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 бере диспетчеризацію на себе, handlers із нижчим пріоритетом і типовий шлях диспетчеризації моделі пропускаються.
-- `message_sending`: повернення `{ cancel: true }` є термінальним. Щойно будь-який handler встановлює це значення, handlers із нижчим пріоритетом пропускаються.
-- `message_sending`: повернення `{ cancel: false }` вважається відсутністю рішення (так само, як пропуск `cancel`), а не перевизначенням.
+- `before_tool_call`: повернення `{ block: true }` є термінальним. Щойно будь-який обробник встановлює це значення, обробники з нижчим пріоритетом пропускаються.
+- `before_tool_call`: повернення `{ block: false }` вважається відсутністю рішення (так само, як і пропуск `block`), а не перевизначенням.
+- `before_install`: повернення `{ block: true }` є термінальним. Щойно будь-який обробник встановлює це значення, обробники з нижчим пріоритетом пропускаються.
+- `before_install`: повернення `{ block: false }` вважається відсутністю рішення (так само, як і пропуск `block`), а не перевизначенням.
+- `reply_dispatch`: повернення `{ handled: true, ... }` є термінальним. Щойно будь-який обробник заявляє про dispatch, обробники з нижчим пріоритетом і стандартний шлях dispatch моделі пропускаються.
+- `message_sending`: повернення `{ cancel: true }` є термінальним. Щойно будь-який обробник встановлює це значення, обробники з нижчим пріоритетом пропускаються.
+- `message_sending`: повернення `{ cancel: false }` вважається відсутністю рішення (так само, як і пропуск `cancel`), а не перевизначенням.
 
 ### Поля об’єкта API
 
-| Поле                     | Тип                       | Опис                                                                                        |
+| Field                    | Type                      | Description                                                                                 |
 | ------------------------ | ------------------------- | ------------------------------------------------------------------------------------------- |
 | `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.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"` — це полегшене вікно запуску/налаштування до повного entry |
 | `api.resolvePath(input)` | `(string) => string`      | Визначити шлях відносно кореня plugin                                                       |
 
 ## Угода щодо внутрішніх модулів
 
-Усередині вашого plugin використовуйте локальні barrel-файли для внутрішніх
-імпортів:
+У межах вашого plugin використовуйте локальні barrel-файли для внутрішніх імпортів:
 
 ```
 my-plugin/
   api.ts            # Публічні експорти для зовнішніх споживачів
-  runtime-api.ts    # Лише внутрішні експорти runtime
+  runtime-api.ts    # Експорти runtime лише для внутрішнього використання
   index.ts          # Точка входу plugin
-  setup-entry.ts    # Полегшений entry лише для налаштування (необов’язково)
+  setup-entry.ts    # Полегшена точка входу лише для налаштування (необов’язково)
 ```
 
 <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 ще немає, вони переходять до резервного варіанту з визначеним
-файлом конфігурації на диску.
+Публічні поверхні bundled plugins, що завантажуються через facade (`api.ts`, `runtime-api.ts`,
+`index.ts`, `setup-entry.ts` та подібні публічні entry-файли), тепер віддають перевагу
+активному знімку конфігурації runtime, коли OpenClaw уже запущено. Якщо знімок runtime
+ще не існує, вони повертаються до визначеного конфігураційного файлу на диску.
 
-Plugins постачальників також можуть надавати вузький локальний barrel-контракт
-plugin, коли помічник навмисно є специфічним для постачальника і ще не належить
-до узагальненого підшляху SDK. Поточний вбудований приклад: постачальник
-Anthropic зберігає свої помічники потоку Claude у власному публічному шві
-`api.ts` / `contract-api.ts` замість того, щоб просувати логіку beta-header і
-`service_tier` Anthropic до узагальненого контракту `plugin-sdk/*`.
+Provider plugins також можуть надавати вузький локальний для plugin barrel контракту, коли
+допоміжний засіб навмисно є специфічним для provider і ще не належить до узагальненого SDK
+підшляху. Поточний bundled-приклад: provider Anthropic зберігає свої допоміжні засоби
+Claude stream у власному публічному seam `api.ts` / `contract-api.ts` замість
+перенесення логіки Anthropic beta-header і `service_tier` до узагальненого
+контракту `plugin-sdk/*`.
 
-Інші поточні вбудовані приклади:
+Інші поточні bundled-приклади:
 
-- `@openclaw/openai-provider`: `api.ts` експортує побудовники постачальника,
-  помічники типових моделей і побудовники realtime-постачальників
-- `@openclaw/openrouter-provider`: `api.ts` експортує побудовник постачальника, а також
-  помічники онбордингу/конфігурації
+- `@openclaw/openai-provider`: `api.ts` експортує конструктори provider,
+  допоміжні засоби моделей за замовчуванням і конструктори realtime provider
+- `@openclaw/openrouter-provider`: `api.ts` експортує конструктор provider, а також
+  допоміжні засоби онбордингу/конфігурації
 
 <Warning>
-  Production-код extensions також має уникати імпортів
-  `openclaw/plugin-sdk/<other-plugin>`. Якщо помічник справді є спільним,
-  просуньте його до нейтрального підшляху SDK, такого як
-  `openclaw/plugin-sdk/speech`, `.../provider-model-shared` або іншої
-  поверхні, орієнтованої на можливості, замість того щоб жорстко зв’язувати два plugins.
+  Production-код extension також має уникати імпортів `openclaw/plugin-sdk/<other-plugin>`.
+  Якщо допоміжний засіб справді є спільним, перенесіть його до нейтрального підшляху 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`
+- [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) — глибока архітектура та модель можливостей
+- [Plugin Internals](/uk/plugins/architecture) — поглиблена архітектура та модель можливостей