diff --git a/docs/uk/plugins/sdk-overview.md b/docs/uk/plugins/sdk-overview.md
index d9e78e3fd..a4cd41530 100644
--- a/docs/uk/plugins/sdk-overview.md
+++ b/docs/uk/plugins/sdk-overview.md
@@ -1,28 +1,27 @@
---
read_when:
- - Потрібно знати, з якого підшляху SDK імпортувати
- - Вам потрібен довідник усіх методів реєстрації в OpenClawPluginApi
+ - Потрібно знати, з якого підшляху SDK виконувати імпорт
+ - Вам потрібна довідка щодо всіх методів реєстрації в OpenClawPluginApi
- Ви шукаєте конкретний експорт SDK
sidebarTitle: SDK overview
-summary: Карта імпорту, довідник API реєстрації та архітектура SDK
+summary: Карта імпортів, довідник API реєстрації та архітектура SDK
title: Огляд Plugin SDK
x-i18n:
- generated_at: "2026-04-28T20:12:31Z"
+ generated_at: "2026-04-29T04:42:21Z"
model: gpt-5.5
provider: openai
- source_hash: 83f554cf3653cdae5027eac2048280a9200828c5ed256d975cd745a77ba1e796
+ source_hash: 7652c2be756dad14792f59f36fa2fc2becd1681454005cf391e401b89999b857
source_path: plugins/sdk-overview.md
workflow: 16
---
-SDK плагінів — це типізований контракт між плагінами та ядром. Ця сторінка є
-довідником щодо **того, що імпортувати** і **що можна реєструвати**.
+SDK Plugin є типізованим контрактом між плагінами та ядром. Ця сторінка є довідником щодо того, **що імпортувати** і **що можна реєструвати**.
Шукаєте натомість практичний посібник? Почніть із [Створення плагінів](/uk/plugins/building-plugins), використовуйте [Плагіни каналів](/uk/plugins/sdk-channel-plugins) для плагінів каналів, [Плагіни провайдерів](/uk/plugins/sdk-provider-plugins) для плагінів провайдерів і [Хуки Plugin](/uk/plugins/hooks) для плагінів інструментів або хуків життєвого циклу.
-## Угода щодо імпорту
+## Угода про імпорт
Завжди імпортуйте з конкретного підшляху:
@@ -31,161 +30,163 @@ import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
import { defineChannelPluginEntry } from "openclaw/plugin-sdk/channel-core";
```
-Кожен підшлях — це невеликий самодостатній модуль. Це забезпечує швидкий запуск і
-запобігає проблемам із циклічними залежностями. Для специфічних для каналу помічників входу/збирання
-віддавайте перевагу `openclaw/plugin-sdk/channel-core`; залишайте `openclaw/plugin-sdk/core` для
-ширшої поверхні-парасольки та спільних помічників, таких як
+Кожен підшлях є невеликим самодостатнім модулем. Це забезпечує швидкий запуск і
+запобігає проблемам із циклічними залежностями. Для допоміжних засобів входу/збірки,
+специфічних для каналів, віддавайте перевагу `openclaw/plugin-sdk/channel-core`; залиште `openclaw/plugin-sdk/core` для
+ширшої узагальнювальної поверхні та спільних допоміжних засобів, таких як
`buildChannelConfigSchema`.
-Для конфігурації каналу публікуйте JSON Schema, якою володіє канал, через
+Для конфігурації каналу публікуйте JSON Schema, що належить каналу, через
`openclaw.plugin.json#channelConfigs`. Підшлях `plugin-sdk/channel-config-schema`
-призначений для спільних примітивів схеми та універсального конструктора. Вбудовані
+призначений для спільних примітивів схем і загального конструктора. Вбудовані
плагіни OpenClaw використовують `plugin-sdk/bundled-channel-config-schema` для збережених
схем вбудованих каналів. Застарілі експорти сумісності залишаються в
-`plugin-sdk/channel-config-schema-legacy`; жоден підшлях вбудованих схем не є
-зразком для нових плагінів.
+`plugin-sdk/channel-config-schema-legacy`; жоден із підшляхів вбудованих схем не є
+шаблоном для нових плагінів.
- Не імпортуйте зручні шви з брендуванням провайдера або каналу (наприклад
+ Не імпортуйте зручні seams із брендингом провайдера або каналу (наприклад,
`openclaw/plugin-sdk/slack`, `.../discord`, `.../signal`, `.../whatsapp`).
- Вбудовані плагіни компонують універсальні підшляхи SDK у власних барелях `api.ts` /
- `runtime-api.ts`; споживачам ядра слід або використовувати ці локальні для плагіна
- барелі, або додати вузький універсальний контракт SDK, коли потреба справді
- є міжканальною.
+ Вбудовані плагіни компонують загальні підшляхи SDK у власних barrel-файлах `api.ts` /
+ `runtime-api.ts`; споживачі ядра мають або використовувати ці локальні для плагіна
+ barrel-файли, або додати вузький загальний контракт SDK, коли потреба справді є
+ міжканальною.
-Невеликий набір допоміжних швів вбудованих плагінів досі з’являється у згенерованій карті експортів,
-коли для них відстежується використання власником. Вони існують лише для супроводу
-вбудованих плагінів і не рекомендовані як шляхи імпорту для нових сторонніх
+Невеликий набір допоміжних seams вбудованих плагінів досі з'являється у згенерованій мапі експортів,
+коли для них відстежується використання власником. Вони існують лише для
+супроводу вбудованих плагінів і не рекомендовані як шляхи імпорту для нових сторонніх
плагінів.
-`openclaw/plugin-sdk/discord` також збережено як застарілий фасад сумісності
-для опублікованого пакета `@openclaw/discord@2026.3.13`. Не копіюйте цей шлях імпорту
-в нові плагіни; натомість використовуйте універсальні підшляхи SDK каналів.
+`openclaw/plugin-sdk/discord` і `openclaw/plugin-sdk/telegram-account` також
+збережені як застарілі фасади сумісності для відстежуваного використання власником. Не
+копіюйте ці шляхи імпорту в нові плагіни; натомість використовуйте ін'єктовані runtime-допоміжні засоби та
+загальні підшляхи SDK каналів.
## Довідник підшляхів
-SDK плагінів надається як набір вузьких підшляхів, згрупованих за областями (вхід
-плагіна, канал, провайдер, автентифікація, runtime, можливості, пам’ять і зарезервовані
-помічники вбудованих плагінів). Повний каталог — згрупований і з посиланнями — див.
-у [Підшляхи SDK Plugin](/uk/plugins/sdk-subpaths).
+SDK Plugin надається як набір вузьких підшляхів, згрупованих за областями (вхід
+плагіна, канал, провайдер, автентифікація, runtime, capability, пам'ять і зарезервовані
+допоміжні засоби вбудованих плагінів). Повний каталог — згрупований і з посиланнями — див.
+[Підшляхи SDK Plugin](/uk/plugins/sdk-subpaths).
-Згенерований список із понад 200 підшляхів міститься в `scripts/lib/plugin-sdk-entrypoints.json`.
+Згенерований список із понад 200 підшляхів розміщено в `scripts/lib/plugin-sdk-entrypoints.json`.
## API реєстрації
-Зворотний виклик `register(api)` отримує об’єкт `OpenClawPluginApi` з такими
+Callback `register(api)` отримує об'єкт `OpenClawPluginApi` з такими
методами:
-### Реєстрація можливостей
+### Реєстрація capability
-| Метод | Що він реєструє |
-| ------------------------------------------------ | ------------------------------------- |
-| `api.registerProvider(...)` | Текстове виведення (LLM) |
+| Метод | Що він реєструє |
+| ------------------------------------------------ | -------------------------------------- |
+| `api.registerProvider(...)` | Текстове виведення (LLM) |
| `api.registerAgentHarness(...)` | Експериментальний низькорівневий виконавець агента |
-| `api.registerCliBackend(...)` | Локальний бекенд виведення CLI |
-| `api.registerChannel(...)` | Канал обміну повідомленнями |
-| `api.registerSpeechProvider(...)` | Text-to-speech / STT синтез |
+| `api.registerCliBackend(...)` | Локальний backend виведення CLI |
+| `api.registerChannel(...)` | Канал обміну повідомленнями |
+| `api.registerSpeechProvider(...)` | Синтез text-to-speech / STT |
| `api.registerRealtimeTranscriptionProvider(...)` | Потокова транскрипція в реальному часі |
| `api.registerRealtimeVoiceProvider(...)` | Дуплексні голосові сесії в реальному часі |
-| `api.registerMediaUnderstandingProvider(...)` | Аналіз зображень/аудіо/відео |
-| `api.registerImageGenerationProvider(...)` | Генерація зображень |
-| `api.registerMusicGenerationProvider(...)` | Генерація музики |
-| `api.registerVideoGenerationProvider(...)` | Генерація відео |
-| `api.registerWebFetchProvider(...)` | Провайдер веботримання / скрейпінгу |
-| `api.registerWebSearchProvider(...)` | Вебпошук |
+| `api.registerMediaUnderstandingProvider(...)` | Аналіз зображень/аудіо/відео |
+| `api.registerImageGenerationProvider(...)` | Генерація зображень |
+| `api.registerMusicGenerationProvider(...)` | Генерація музики |
+| `api.registerVideoGenerationProvider(...)` | Генерація відео |
+| `api.registerWebFetchProvider(...)` | Провайдер веботримання / скрейпінгу |
+| `api.registerWebSearchProvider(...)` | Вебпошук |
### Інструменти та команди
-| Метод | Що він реєструє |
-| ----------------------------- | -------------------------------------------- |
-| `api.registerTool(tool, opts?)` | Інструмент агента (обов’язковий або `{ optional: true }`) |
-| `api.registerCommand(def)` | Користувацька команда (оминає LLM) |
+| Метод | Що він реєструє |
+| ------------------------------- | ------------------------------------------------ |
+| `api.registerTool(tool, opts?)` | Інструмент агента (обов'язковий або `{ optional: true }`) |
+| `api.registerCommand(def)` | Користувацька команда (оминає LLM) |
-Команди плагіна можуть задавати `agentPromptGuidance`, коли агенту потрібна коротка
-підказка маршрутизації, якою володіє команда. Тримайте цей текст про саму команду; не додавайте
-політику, специфічну для провайдера або плагіна, до побудовників промптів ядра.
+Команди Plugin можуть задавати `agentPromptGuidance`, коли агенту потрібна коротка,
+належна команді підказка маршрутизації. Тримайте цей текст про саму команду; не додавайте
+політику, специфічну для провайдера або плагіна, до конструкторів core prompt.
### Інфраструктура
-| Метод | Що він реєструє |
-| ---------------------------------------------- | -------------------------------------- |
-| `api.registerHook(events, handler, opts?)` | Хук події |
-| `api.registerHttpRoute(params)` | HTTP endpoint Gateway |
-| `api.registerGatewayMethod(name, handler)` | RPC-метод Gateway |
-| `api.registerGatewayDiscoveryService(service)` | Локальний рекламодавець виявлення Gateway |
-| `api.registerCli(registrar, opts?)` | Підкоманда CLI |
-| `api.registerService(service)` | Фонова служба |
-| `api.registerInteractiveHandler(registration)` | Інтерактивний обробник |
+| Метод | Що він реєструє |
+| ---------------------------------------------- | --------------------------------------- |
+| `api.registerHook(events, handler, opts?)` | Хук події |
+| `api.registerHttpRoute(params)` | HTTP endpoint Gateway |
+| `api.registerGatewayMethod(name, handler)` | RPC-метод Gateway |
+| `api.registerGatewayDiscoveryService(service)` | Оголошувач локального виявлення Gateway |
+| `api.registerCli(registrar, opts?)` | Підкоманда CLI |
+| `api.registerService(service)` | Фоновий сервіс |
+| `api.registerInteractiveHandler(registration)` | Інтерактивний обробник |
| `api.registerAgentToolResultMiddleware(...)` | Runtime middleware результатів інструментів |
-| `api.registerMemoryPromptSupplement(builder)` | Додатковий розділ промпта, суміжний із пам’яттю |
-| `api.registerMemoryCorpusSupplement(adapter)` | Додатковий корпус пошуку/читання пам’яті |
+| `api.registerMemoryPromptSupplement(builder)` | Додатковий розділ prompt поруч із пам'яттю |
+| `api.registerMemoryCorpusSupplement(adapter)` | Додатковий корпус пошуку/читання пам'яті |
-### Хост-хуки для плагінів робочих процесів
+### Хост-хуки для плагінів workflow
-Хост-хуки — це шви SDK для плагінів, яким потрібно брати участь у життєвому циклі хоста,
-а не лише додавати провайдера, канал або інструмент. Це
-універсальні контракти; їх може використовувати Plan Mode, але також можуть процеси схвалення,
-шлюзи політик робочої області, фонові монітори, майстри налаштування та супровідні UI-плагіни.
+Хост-хуки — це seams SDK для плагінів, яким потрібно брати участь у життєвому циклі хоста,
+а не лише додавати провайдера, канал або інструмент. Вони є
+загальними контрактами; Plan Mode може їх використовувати, але так само можуть workflow затверджень,
+гейти політик робочого простору, фонові монітори, майстри налаштування та супровідні UI
+плагіни.
-| Метод | Контракт, яким він володіє |
-| ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |
-| `api.registerSessionExtension(...)` | Стан сесії, яким володіє плагін і який сумісний із JSON, проєктований через сесії Gateway |
-| `api.enqueueNextTurnInjection(...)` | Стійкий контекст рівно один раз, інжектований у наступний хід агента для однієї сесії |
-| `api.registerTrustedToolPolicy(...)` | Політика інструментів довіреного передплагінного етапу, яка може блокувати або переписувати параметри інструментів |
-| `api.registerToolMetadata(...)` | Метадані відображення каталогу інструментів без зміни реалізації інструмента |
-| `api.registerCommand(...)` | Обмежені за областю команди плагіна; результати команд можуть задавати `continueAgent: true` |
+| Метод | Контракт, яким він володіє |
+| ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------- |
+| `api.registerSessionExtension(...)` | Належний Plugin JSON-сумісний стан сесії, проєктований через сесії Gateway |
+| `api.enqueueNextTurnInjection(...)` | Стійкий контекст exactly-once, ін'єктований у наступний хід агента для однієї сесії |
+| `api.registerTrustedToolPolicy(...)` | Політика інструментів до Plugin для вбудованих/довірених інструментів, що може блокувати або переписувати параметри інструмента |
+| `api.registerToolMetadata(...)` | Метадані відображення каталогу інструментів без зміни реалізації інструмента |
+| `api.registerCommand(...)` | Обмежені за scope команди Plugin; результати команд можуть задавати `continueAgent: true` |
| `api.registerControlUiDescriptor(...)` | Дескриптори внеску Control UI для поверхонь сесії, інструмента, запуску або налаштувань |
-| `api.registerRuntimeLifecycle(...)` | Зворотні виклики очищення для runtime-ресурсів, якими володіє плагін, на шляхах reset/delete/reload |
-| `api.registerAgentEventSubscription(...)` | Очищені підписки на події для стану робочого процесу та моніторів |
-| `api.setRunContext(...)` / `getRunContext(...)` / `clearRunContext(...)` | Чернетковий стан плагіна для окремого запуску, очищений під час завершального життєвого циклу запуску |
-| `api.registerSessionSchedulerJob(...)` | Записи завдань планувальника сесій, якими володіє плагін, із детермінованим очищенням |
+| `api.registerRuntimeLifecycle(...)` | Callback-и очищення для належних Plugin runtime-ресурсів на шляхах reset/delete/reload |
+| `api.registerAgentEventSubscription(...)` | Санітизовані підписки на події для стану workflow та моніторів |
+| `api.setRunContext(...)` / `getRunContext(...)` / `clearRunContext(...)` | Належний Plugin scratch-стан для кожного запуску, очищений у термінальному життєвому циклі запуску |
+| `api.registerSessionSchedulerJob(...)` | Належні Plugin записи завдань планувальника сесій із детермінованим очищенням |
Контракти навмисно розділяють повноваження:
-- Зовнішні плагіни можуть володіти розширеннями сесій, UI-дескрипторами, командами, метаданими інструментів, інжекціями в наступний хід і звичайними хуками.
-- Довірені політики інструментів виконуються перед звичайними хуками `before_tool_call` і доступні лише вбудованим плагінам, бо вони беруть участь у політиці безпеки хоста.
-- Зарезервоване володіння командами доступне лише вбудованим плагінам. Зовнішні плагіни мають використовувати власні імена команд або псевдоніми.
-- `allowPromptInjection=false` вимикає хуки, що змінюють промпт, зокрема
+- Зовнішні плагіни можуть володіти розширеннями сесій, UI-дескрипторами, командами, метаданими інструментів, ін'єкціями наступного ходу та звичайними хуками.
+- Довірені політики інструментів виконуються перед звичайними хуками `before_tool_call` і доступні лише для вбудованих компонентів, бо беруть участь у політиці безпеки хоста.
+- Зарезервоване володіння командами доступне лише для вбудованих компонентів. Зовнішні плагіни мають використовувати власні назви команд або псевдоніми.
+- `allowPromptInjection=false` вимикає хуки, що змінюють prompt, включно з
`agent_turn_prepare`, `before_prompt_build`, `heartbeat_prompt_contribution`,
- поля промпта зі спадкового `before_agent_start` та
+ полями prompt із застарілого `before_agent_start` і
`enqueueNextTurnInjection`.
-Приклади споживачів не з Plan:
+Приклади споживачів, що не належать до Plan:
-| Архетип плагіна | Використані хуки |
-| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
-| Процес схвалення | Розширення сесії, продовження команди, інжекція в наступний хід, UI-дескриптор |
-| Шлюз політик бюджету/робочої області | Довірена політика інструментів, метадані інструментів, проєкція сесії |
-| Фоновий монітор життєвого циклу | Очищення життєвого циклу runtime, підписка на події агента, володіння/очищення планувальника сесій, внесок промпта Heartbeat, UI-дескриптор |
-| Майстер налаштування або onboarding | Розширення сесії, команди з областю дії, дескриптор Control UI |
+| Архетип Plugin | Використані хуки |
+| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
+| Workflow затвердження | Розширення сесії, продовження команди, ін'єкція наступного ходу, UI-дескриптор |
+| Гейт політики бюджету/робочого простору | Довірена політика інструментів, метадані інструментів, проєкція сесії |
+| Фоновий монітор життєвого циклу | Очищення runtime-життєвого циклу, підписка на події агента, володіння/очищення планувальника сесій, внесок Heartbeat prompt, UI-дескриптор |
+| Майстер налаштування або onboarding | Розширення сесії, обмежені за scope команди, дескриптор Control UI |
- Зарезервовані адміністративні простори імен ядра (`config.*`, `exec.approvals.*`, `wizard.*`,
- `update.*`) завжди залишаються `operator.admin`, навіть якщо плагін намагається призначити
- вужчу область методу gateway. Віддавайте перевагу специфічним для плагіна префіксам для
- методів, якими володіє плагін.
+ Зарезервовані core admin namespaces (`config.*`, `exec.approvals.*`, `wizard.*`,
+ `update.*`) завжди залишаються `operator.admin`, навіть якщо Plugin намагається призначити
+ вужчий scope методу gateway. Віддавайте перевагу префіксам, специфічним для Plugin, для
+ методів, якими володіє Plugin.
Вбудовані плагіни можуть використовувати `api.registerAgentToolResultMiddleware(...)`, коли
їм потрібно переписати результат інструмента після виконання і до того, як runtime
- передасть цей результат назад у модель. Це довірений нейтральний до runtime
- шов для асинхронних редукторів виводу, таких як tokenjuice.
+ передасть цей результат назад у модель. Це довірений runtime-нейтральний
+ seam для асинхронних редукторів виводу, таких як tokenjuice.
Вбудовані плагіни мають оголошувати `contracts.agentToolResultMiddleware` для кожного
цільового runtime, наприклад `["pi", "codex"]`. Зовнішні плагіни
-не можуть реєструвати це middleware; залишайте звичайні хуки плагінів OpenClaw для роботи,
-яка не потребує таймінгу результату інструмента перед моделлю. Старий вбудований
+не можуть реєструвати це middleware; залишайте звичайні хуки Plugin OpenClaw для роботи,
+яка не потребує timing результату інструмента до моделі. Старий вбудований
шлях реєстрації фабрики розширення лише для Pi було видалено.
### Реєстрація виявлення Gateway
-`api.registerGatewayDiscoveryService(...)` дає плагіну змогу рекламувати активний
-Gateway у локальному транспорті виявлення, такому як mDNS/Bonjour. OpenClaw викликає
-службу під час запуску Gateway, коли локальне виявлення ввімкнено, передає
-поточні порти Gateway і несекретні TXT-підказки, а також викликає повернений
+`api.registerGatewayDiscoveryService(...)` дає Plugin змогу оголошувати активний
+Gateway на локальному транспорті виявлення, наприклад mDNS/Bonjour. OpenClaw викликає
+сервіс під час запуску Gateway, коли локальне виявлення увімкнене, передає
+поточні порти Gateway і несекретні TXT hint-дані, а також викликає повернений
обробник `stop` під час завершення роботи Gateway.
```typescript
@@ -202,19 +203,20 @@ api.registerGatewayDiscoveryService({
});
```
-Плагіни виявлення Gateway не повинні трактувати рекламовані значення TXT як секрети або
-автентифікацію. Виявлення — це підказка маршрутизації; довірою все ще керують автентифікація Gateway і TLS-пінінг.
+Плагіни виявлення Gateway не повинні трактувати оголошені TXT-значення як секрети або
+автентифікацію. Виявлення є routing hint; автентифікація Gateway і TLS pinning і далі
+відповідають за довіру.
### Метадані реєстрації CLI
-`api.registerCli(registrar, opts?)` приймає два типи метаданих верхнього рівня:
+`api.registerCli(registrar, opts?)` приймає два види метаданих верхнього рівня:
- `commands`: явні корені команд, якими володіє реєстратор
- `descriptors`: дескриптори команд часу розбору, які використовуються для довідки кореневого CLI,
маршрутизації та лінивої реєстрації CLI Plugin
-Якщо ви хочете, щоб команда Plugin залишалася ліниво завантажуваною у звичайному шляху кореневого CLI,
-надайте `descriptors`, які охоплюють кожен корінь команди верхнього рівня, що надається цим
+Якщо ви хочете, щоб команда Plugin залишалася ліниво завантажуваною у звичайному кореневому шляху CLI,
+надайте `descriptors`, які охоплюють кожен корінь команди верхнього рівня, відкритий цим
реєстратором.
```typescript
@@ -235,97 +237,98 @@ api.registerCli(
);
```
-Використовуйте `commands` самостійно лише тоді, коли вам не потрібна лінива реєстрація кореневого CLI.
-Цей енергійний шлях сумісності залишається підтримуваним, але він не встановлює
+Використовуйте `commands` окремо лише тоді, коли вам не потрібна лінива реєстрація кореневого CLI.
+Цей енергійний шлях сумісності й надалі підтримується, але він не встановлює
заповнювачі на основі дескрипторів для лінивого завантаження під час розбору.
-### Реєстрація бекенда CLI
+### Реєстрація бекенду CLI
`api.registerCliBackend(...)` дає Plugin змогу володіти типовою конфігурацією для локального
-AI CLI бекенда, такого як `codex-cli`.
+бекенду AI CLI, такого як `codex-cli`.
-- Backend `id` стає префіксом постачальника в посиланнях на модель, як-от `codex-cli/gpt-5`.
-- Backend `config` використовує ту саму форму, що й `agents.defaults.cliBackends.`.
-- Конфігурація користувача все одно має пріоритет. OpenClaw об'єднує `agents.defaults.cliBackends.` поверх
- типового значення Plugin перед запуском CLI.
-- Використовуйте `normalizeConfig`, коли backend потребує переписувань сумісності після об'єднання
- (наприклад, нормалізації старих форм прапорців).
+- `id` бекенду стає префіксом провайдера в посиланнях на моделі на кшталт `codex-cli/gpt-5`.
+- `config` бекенду використовує ту саму форму, що й `agents.defaults.cliBackends.`.
+- Конфігурація користувача все одно має пріоритет. OpenClaw об’єднує `agents.defaults.cliBackends.` поверх
+ типових налаштувань Plugin перед запуском CLI.
+- Використовуйте `normalizeConfig`, коли бекенду потрібні переписування для сумісності після об’єднання
+ (наприклад, нормалізація старих форм прапорців).
### Ексклюзивні слоти
-| Метод | Що він реєструє |
-| ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `api.registerContextEngine(id, factory)` | Рушій контексту (одночасно активний лише один). Callback `assemble()` отримує `availableTools` і `citationsMode`, щоб рушій міг адаптувати доповнення до prompt. |
-| `api.registerMemoryCapability(capability)` | Уніфікована можливість пам'яті |
-| `api.registerMemoryPromptSection(builder)` | Побудовник секції prompt пам'яті |
-| `api.registerMemoryFlushPlan(resolver)` | Резолвер плану очищення пам'яті |
-| `api.registerMemoryRuntime(runtime)` | Адаптер runtime пам'яті |
+| Метод | Що він реєструє |
+| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `api.registerContextEngine(id, factory)` | Контекстний рушій (одночасно активний лише один). Зворотний виклик `assemble()` отримує `availableTools` і `citationsMode`, щоб рушій міг адаптувати доповнення до промпта. |
+| `api.registerMemoryCapability(capability)` | Уніфікована можливість пам’яті |
+| `api.registerMemoryPromptSection(builder)` | Побудовник секції промпта пам’яті |
+| `api.registerMemoryFlushPlan(resolver)` | Резолвер плану скидання пам’яті |
+| `api.registerMemoryRuntime(runtime)` | Адаптер середовища виконання пам’яті |
-### Адаптери embedding пам'яті
+### Адаптери ембедингів пам’яті
-| Метод | Що він реєструє |
-| ---------------------------------------------- | ------------------------------------------------ |
-| `api.registerMemoryEmbeddingProvider(adapter)` | Адаптер embedding пам'яті для активного Plugin |
+| Метод | Що він реєструє |
+| ---------------------------------------------- | ---------------------------------------------- |
+| `api.registerMemoryEmbeddingProvider(adapter)` | Адаптер ембедингів пам’яті для активного Plugin |
-- `registerMemoryCapability` є рекомендованим ексклюзивним API Plugin пам'яті.
+- `registerMemoryCapability` — рекомендований ексклюзивний API Plugin пам’яті.
- `registerMemoryCapability` також може надавати `publicArtifacts.listArtifacts(...)`,
- щоб супутні plugins могли споживати експортовані артефакти пам'яті через
- `openclaw/plugin-sdk/memory-host-core`, а не звертатися до приватної структури конкретного
- Plugin пам'яті.
+ щоб супровідні Plugins могли споживати експортовані артефакти пам’яті через
+ `openclaw/plugin-sdk/memory-host-core`, а не звертатися до приватної структури
+ конкретного Plugin пам’яті.
- `registerMemoryPromptSection`, `registerMemoryFlushPlan` і
- `registerMemoryRuntime` є застаріло-сумісними ексклюзивними API Plugin пам'яті.
-- `MemoryFlushPlan.model` може прив'язати turn очищення до точного посилання `provider/model`,
- наприклад `ollama/qwen3:8b`, без успадкування активного ланцюжка fallback.
-- `registerMemoryEmbeddingProvider` дає активному Plugin пам'яті змогу зареєструвати один
- або більше id адаптерів embedding (наприклад `openai`, `gemini` або власний
- id, визначений Plugin).
-- Конфігурація користувача, як-от `agents.defaults.memorySearch.provider` і
- `agents.defaults.memorySearch.fallback`, розв'язується відносно цих зареєстрованих
- id адаптерів.
+ `registerMemoryRuntime` — це сумісні зі спадщиною ексклюзивні API Plugin пам’яті.
+- `MemoryFlushPlan.model` може прив’язати хід скидання до точного посилання
+ `provider/model`, такого як `ollama/qwen3:8b`, без успадкування активного
+ ланцюжка резервних варіантів.
+- `registerMemoryEmbeddingProvider` дає активному Plugin пам’яті змогу зареєструвати один
+ або кілька ідентифікаторів адаптерів ембедингів (наприклад, `openai`, `gemini` або власний
+ ідентифікатор, визначений Plugin).
+- Конфігурація користувача, така як `agents.defaults.memorySearch.provider` і
+ `agents.defaults.memorySearch.fallback`, розв’язується відносно цих зареєстрованих
+ ідентифікаторів адаптерів.
### Події та життєвий цикл
-| Метод | Що він робить |
-| -------------------------------------------- | -------------------------------- |
-| `api.on(hookName, handler, opts?)` | Типізований хук життєвого циклу |
-| `api.onConversationBindingResolved(handler)` | Callback прив'язки розмови |
+| Метод | Що він робить |
+| -------------------------------------------- | ------------------------------------- |
+| `api.on(hookName, handler, opts?)` | Типізований хук життєвого циклу |
+| `api.onConversationBindingResolved(handler)` | Зворотний виклик прив’язки розмови |
-Див. [Хуки Plugin](/uk/plugins/hooks) для прикладів, поширених назв хуків і семантики guard.
+Див. [хуки Plugin](/uk/plugins/hooks) для прикладів, поширених назв хуків і семантики захисту.
### Семантика рішень хуків
-- `before_tool_call`: повернення `{ block: true }` є термінальним. Щойно будь-який handler встановлює його, handlers із нижчим пріоритетом пропускаються.
+- `before_tool_call`: повернення `{ block: true }` є термінальним. Щойно будь-який обробник встановлює його, обробники з нижчим пріоритетом пропускаються.
- `before_tool_call`: повернення `{ block: false }` трактується як відсутність рішення (так само, як пропуск `block`), а не як перевизначення.
-- `before_install`: повернення `{ block: true }` є термінальним. Щойно будь-який handler встановлює його, handlers із нижчим пріоритетом пропускаються.
+- `before_install`: повернення `{ block: true }` є термінальним. Щойно будь-який обробник встановлює його, обробники з нижчим пріоритетом пропускаються.
- `before_install`: повернення `{ block: false }` трактується як відсутність рішення (так само, як пропуск `block`), а не як перевизначення.
-- `reply_dispatch`: повернення `{ handled: true, ... }` є термінальним. Щойно будь-який handler бере dispatch на себе, handlers із нижчим пріоритетом і типовий шлях dispatch моделі пропускаються.
-- `message_sending`: повернення `{ cancel: true }` є термінальним. Щойно будь-який handler встановлює його, handlers із нижчим пріоритетом пропускаються.
+- `reply_dispatch`: повернення `{ handled: true, ... }` є термінальним. Щойно будь-який обробник бере dispatch на себе, обробники з нижчим пріоритетом і типовий шлях dispatch моделі пропускаються.
+- `message_sending`: повернення `{ cancel: true }` є термінальним. Щойно будь-який обробник встановлює його, обробники з нижчим пріоритетом пропускаються.
- `message_sending`: повернення `{ cancel: false }` трактується як відсутність рішення (так само, як пропуск `cancel`), а не як перевизначення.
-- `message_received`: використовуйте типізоване поле `threadId`, коли потрібна маршрутизація вхідного thread/topic. Залишайте `metadata` для специфічних для каналу додаткових даних.
-- `message_sending`: використовуйте типізовані поля маршрутизації `replyToId` / `threadId`, перш ніж переходити до специфічних для каналу `metadata`.
-- `gateway_start`: використовуйте `ctx.config`, `ctx.workspaceDir` і `ctx.getCron?.()` для стану запуску, яким володіє gateway, замість покладання на внутрішні хуки `gateway:startup`.
-- `cron_changed`: спостерігайте за змінами життєвого циклу Cron, яким володіє gateway. Використовуйте `event.job?.state?.nextRunAtMs` і `ctx.getCron?.()` під час синхронізації зовнішніх планувальників пробудження, і зберігайте OpenClaw джерелом істини для перевірок строків і виконання.
+- `message_received`: використовуйте типізоване поле `threadId`, коли потрібна маршрутизація вхідної гілки/теми. Залишайте `metadata` для специфічних для каналу додаткових даних.
+- `message_sending`: використовуйте типізовані поля маршрутизації `replyToId` / `threadId`, перш ніж переходити до специфічного для каналу `metadata`.
+- `gateway_start`: використовуйте `ctx.config`, `ctx.workspaceDir` і `ctx.getCron?.()` для стану запуску, яким володіє Gateway, замість покладання на внутрішні хуки `gateway:startup`.
+- `cron_changed`: спостерігайте за змінами життєвого циклу Cron, яким володіє Gateway. Використовуйте `event.job?.state?.nextRunAtMs` і `ctx.getCron?.()` під час синхронізації зовнішніх планувальників пробудження, а OpenClaw залишайте джерелом істини для перевірок строків виконання та виконання.
-### Поля об'єкта API
+### Поля об’єкта API
-| Поле | Тип | Опис |
-| ------------------------ | ------------------------- | ----------------------------------------------------------------------------------------------------- |
-| `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` | Специфічна для Plugin конфігурація з `plugins.entries..config` |
-| `api.runtime` | `PluginRuntime` | [Runtime-помічники](/uk/plugins/sdk-runtime) |
-| `api.logger` | `PluginLogger` | Обмежений logger (`debug`, `info`, `warn`, `error`) |
-| `api.registrationMode` | `PluginRegistrationMode` | Поточний режим завантаження; `"setup-runtime"` — легке вікно startup/setup перед повним entry |
-| `api.resolvePath(input)` | `(string) => string` | Розв'язати шлях відносно кореня Plugin |
+| Поле | Тип | Опис |
+| ------------------------ | ------------------------- | -------------------------------------------------------------------------------------------- |
+| `api.id` | `string` | Ідентифікатор Plugin |
+| `api.name` | `string` | Відображувана назва |
+| `api.version` | `string?` | Версія Plugin (необов’язково) |
+| `api.description` | `string?` | Опис Plugin (необов’язково) |
+| `api.source` | `string` | Шлях до джерела Plugin |
+| `api.rootDir` | `string?` | Кореневий каталог Plugin (необов’язково) |
+| `api.config` | `OpenClawConfig` | Поточний знімок конфігурації (активний знімок середовища виконання в пам’яті, коли доступний) |
+| `api.pluginConfig` | `Record` | Специфічна для Plugin конфігурація з `plugins.entries..config` |
+| `api.runtime` | `PluginRuntime` | [Допоміжні засоби середовища виконання](/uk/plugins/sdk-runtime) |
+| `api.logger` | `PluginLogger` | Обмежений логер (`debug`, `info`, `warn`, `error`) |
+| `api.registrationMode` | `PluginRegistrationMode` | Поточний режим завантаження; `"setup-runtime"` — це легке вікно запуску/налаштування перед повним входом |
+| `api.resolvePath(input)` | `(string) => string` | Розв’язати шлях відносно кореня Plugin |
-## Угода щодо внутрішніх модулів
+## Конвенція внутрішніх модулів
-Усередині вашого Plugin використовуйте локальні barrel-файли для внутрішніх імпортів:
+У межах вашого Plugin використовуйте локальні barrel-файли для внутрішніх імпортів:
```
my-plugin/
@@ -337,55 +340,55 @@ my-plugin/
Ніколи не імпортуйте власний Plugin через `openclaw/plugin-sdk/`
- з production-коду. Спрямовуйте внутрішні імпорти через `./api.ts` або
- `./runtime-api.ts`. Шлях SDK є лише зовнішнім контрактом.
+ з виробничого коду. Спрямовуйте внутрішні імпорти через `./api.ts` або
+ `./runtime-api.ts`. Шлях SDK — лише зовнішній контракт.
-Публічні поверхні bundled Plugin, завантажені через facade (`api.ts`, `runtime-api.ts`,
-`index.ts`, `setup-entry.ts` і подібні публічні entry-файли), віддають перевагу
-активному runtime-знімку конфігурації, коли OpenClaw уже працює. Якщо runtime-знімка
-ще немає, вони повертаються до розв'язаної конфігурації з файлу на диску.
-Упаковані bundled facade Plugin слід завантажувати через facade loaders OpenClaw SDK;
-прямі імпорти з `dist/extensions/...` обходять staged runtime mirrors залежностей,
-які packaged installs використовують для залежностей, що належать Plugin.
+Публічні поверхні вбудованих Plugin, завантажені через фасад (`api.ts`, `runtime-api.ts`,
+`index.ts`, `setup-entry.ts` і подібні публічні вхідні файли), віддають перевагу
+активному знімку конфігурації середовища виконання, коли OpenClaw уже запущено. Якщо знімка середовища
+виконання ще немає, вони повертаються до розв’язаної конфігурації на диску.
+Фасади упакованих вбудованих Plugin слід завантажувати через фасадні завантажувачі OpenClaw SDK;
+прямі імпорти з `dist/extensions/...` оминають поетапні дзеркала залежностей середовища виконання,
+які упаковані встановлення використовують для залежностей, якими володіє Plugin.
-Provider plugins можуть надавати вузький локальний barrel контракту Plugin, коли
-helper навмисно специфічний для provider і ще не належить до generic SDK
-subpath. Bundled приклади:
+Plugin провайдерів можуть надавати вузький локальний для Plugin contract barrel, коли
+допоміжний засіб навмисно специфічний для провайдера і ще не належить до загального підшляху SDK.
+Вбудовані приклади:
-- **Anthropic**: публічний seam `api.ts` / `contract-api.ts` для Claude
- beta-header і stream helpers `service_tier`.
-- **`@openclaw/openai-provider`**: `api.ts` експортує provider builders,
- helpers типової моделі та realtime provider builders.
-- **`@openclaw/openrouter-provider`**: `api.ts` експортує provider builder
- плюс helpers onboarding/config.
+- **Anthropic**: публічний шов `api.ts` / `contract-api.ts` для beta-header Claude
+ і допоміжних засобів потоків `service_tier`.
+- **`@openclaw/openai-provider`**: `api.ts` експортує побудовники провайдера,
+ допоміжні засоби типових моделей і побудовники realtime-провайдера.
+- **`@openclaw/openrouter-provider`**: `api.ts` експортує побудовник провайдера,
+ а також допоміжні засоби onboarding/конфігурації.
- Production-код extension також має уникати імпортів `openclaw/plugin-sdk/`.
- Якщо helper справді спільний, підніміть його до нейтрального SDK subpath,
+ Виробничому коду розширення також слід уникати імпортів `openclaw/plugin-sdk/`.
+ Якщо допоміжний засіб справді спільний, піднесіть його до нейтрального підшляху SDK,
такого як `openclaw/plugin-sdk/speech`, `.../provider-model-shared` або інша
- поверхня, орієнтована на можливості, замість того щоб зв'язувати два plugins між собою.
+ поверхня, орієнтована на можливість, замість того щоб зв’язувати два Plugins між собою.
-## Пов'язане
+## Пов’язане
-
+
Параметри `definePluginEntry` і `defineChannelPluginEntry`.
-
+
Повна довідка простору імен `api.runtime`.
-
- Пакування, manifests і config schemas.
+
+ Пакування, маніфести та схеми конфігурації.
-
- Тестові утиліти та правила lint.
+
+ Утиліти тестування та правила lint.
-
+
Міграція із застарілих поверхонь.
-
- Поглиблена архітектура та модель можливостей.
+
+ Глибока архітектура та модель можливостей.
diff --git a/docs/uk/plugins/sdk-subpaths.md b/docs/uk/plugins/sdk-subpaths.md
index fd40859c6..093ccc523 100644
--- a/docs/uk/plugins/sdk-subpaths.md
+++ b/docs/uk/plugins/sdk-subpaths.md
@@ -1,28 +1,28 @@
---
read_when:
- Вибір правильного підшляху plugin-sdk для імпорту Plugin
- - Аудит підшляхів вбудованих Plugin і допоміжних інтерфейсів
-summary: 'Каталог підшляхів Plugin SDK: які імпорти де розташовані, згруповано за областями'
+ - Аудит підшляхів вбудованих Plugin і допоміжних поверхонь
+summary: 'Каталог підшляхів Plugin SDK: які імпорти де розміщені, згруповано за областями'
title: Підшляхи Plugin SDK
x-i18n:
- generated_at: "2026-04-28T20:12:45Z"
+ generated_at: "2026-04-29T04:42:23Z"
model: gpt-5.5
provider: openai
- source_hash: f66fa1c9f9398ae2124dc4b92d3b11a07800616f452409d12e851a6fb0bcd675
+ source_hash: 2ca42dc1b56245b8d26924eb2b957dac872fd0e2db4b62978ab2e2e15dcde3dc
source_path: plugins/sdk-subpaths.md
workflow: 16
---
- SDK Plugin надається як набір вузьких підшляхів у `openclaw/plugin-sdk/`.
+ Plugin SDK надається як набір вузьких підшляхів у `openclaw/plugin-sdk/`.
На цій сторінці наведено поширені підшляхи, згруповані за призначенням. Згенерований
повний список із понад 200 підшляхів міститься в `scripts/lib/plugin-sdk-entrypoints.json`;
- зарезервовані допоміжні підшляхи bundled-plugin також є там, але вони є деталлю
- реалізації, якщо сторінка документації явно не виносить їх на рівень публічного API. Супровідники можуть перевіряти активні
+ зарезервовані допоміжні підшляхи для вбудованих Plugin також наведені там, але вони є
+ деталлю реалізації, якщо сторінка документації явно не просуває їх. Мейнтейнери можуть перевіряти активні
зарезервовані допоміжні підшляхи за допомогою `pnpm plugins:boundary-report:summary`; невикористані
- зарезервовані допоміжні експорти призводять до помилки у звіті CI, а не залишаються в публічному SDK
+ зарезервовані допоміжні експорти спричиняють помилку звіту CI, а не залишаються в публічному SDK
як неактивний борг сумісності.
- Посібник з розробки Plugin див. у [огляді SDK Plugin](/uk/plugins/sdk-overview).
+ Посібник зі створення Plugin див. у [Огляді Plugin SDK](/uk/plugins/sdk-overview).
## Точка входу Plugin
@@ -32,298 +32,299 @@ x-i18n:
| `plugin-sdk/core` | `defineChannelPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase`, `defineSetupPluginEntry`, `buildChannelConfigSchema` |
| `plugin-sdk/config-schema` | `OpenClawSchema` |
| `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry` |
- | `plugin-sdk/testing` | Широкий barrel сумісності для застарілих тестів Plugin; для нових тестів розширень надавайте перевагу сфокусованим тестовим підшляхам |
- | `plugin-sdk/plugin-test-api` | Мінімальний builder моків `OpenClawPluginApi` для модульних тестів прямої реєстрації Plugin |
- | `plugin-sdk/agent-runtime-test-contracts` | Нативні fixtures контрактів адаптера agent-runtime для профілів автентифікації, пригнічення доставки, класифікації fallback, хуків інструментів, накладень промптів, схем і відновлення transcript |
- | `plugin-sdk/channel-test-helpers` | Помічники тестів життєвого циклу облікового запису каналу, каталогу, send-config, runtime-мока, хуків, точки входу bundled channel, timestamp envelope, pairing reply і generic channel contract |
- | `plugin-sdk/channel-target-testing` | Спільний набір тестів випадків помилок target-resolution каналу |
- | `plugin-sdk/plugin-test-contracts` | Помічники контрактів реєстрації Plugin, маніфесту пакета, публічного артефакту, runtime API, side-effect імпорту та прямого імпорту |
- | `plugin-sdk/plugin-test-runtime` | Fixtures для тестів runtime Plugin, registry, provider-registration, setup-wizard і runtime task-flow |
- | `plugin-sdk/provider-test-contracts` | Помічники контрактів provider runtime, auth, discovery, onboard, catalog, media capability, replay policy, realtime STT live-audio, web-search/fetch і wizard |
- | `plugin-sdk/provider-http-test-mocks` | Opt-in HTTP/auth моки Vitest для тестів провайдера, що перевіряють `plugin-sdk/provider-http` |
- | `plugin-sdk/test-env` | Fixtures тестового середовища, fetch/network, disposable HTTP server, incoming request, live-test, temporary filesystem і time-control |
- | `plugin-sdk/test-fixtures` | Generic fixtures для CLI, sandbox, skill, agent-message, system-event, module reload, bundled plugin path, terminal, chunking, auth-token і typed-case |
- | `plugin-sdk/test-node-mocks` | Сфокусовані помічники моків вбудованих модулів Node для використання у factory Vitest `vi.mock("node:*")` |
- | `plugin-sdk/migration` | Помічники елементів migration provider, як-от `createMigrationItem`, константи причин, маркери стану елементів, помічники редагування та `summarizeMigrationItems` |
+ | `plugin-sdk/testing` | Широкий barrel сумісності для застарілих тестів Plugin; для нових тестів розширень надавайте перевагу цільовим тестовим підшляхам |
+ | `plugin-sdk/plugin-test-api` | Мінімальний builder mock `OpenClawPluginApi` для unit-тестів прямої реєстрації Plugin |
+ | `plugin-sdk/agent-runtime-test-contracts` | Нативні фікстури контрактів адаптера agent-runtime для профілів автентифікації, приглушення доставки, класифікації fallback, хуків інструментів, накладень prompt, схем і відновлення transcript |
+ | `plugin-sdk/channel-test-helpers` | Помічники тестування життєвого циклу облікового запису каналу, каталогу, send-config, runtime mock, hook, точки входу вбудованого каналу, timestamp envelope, відповіді pairing і загального контракту каналу |
+ | `plugin-sdk/channel-target-testing` | Спільний набір тестів для випадків помилок розв’язання цілі каналу |
+ | `plugin-sdk/plugin-test-contracts` | Помічники контрактів реєстрації Plugin, маніфесту пакета, публічного артефакту, runtime API, побічного ефекту імпорту та прямого імпорту |
+ | `plugin-sdk/plugin-test-runtime` | Фікстури runtime Plugin, registry, реєстрації provider, setup-wizard і runtime task-flow для тестів |
+ | `plugin-sdk/provider-test-contracts` | Помічники контрактів runtime provider, auth, discovery, onboard, catalog, медіаможливостей, replay policy, realtime STT live-audio, web-search/fetch і wizard |
+ | `plugin-sdk/provider-http-test-mocks` | Opt-in HTTP/auth mocks Vitest для тестів provider, які перевіряють `plugin-sdk/provider-http` |
+ | `plugin-sdk/test-env` | Фікстури тестового середовища, fetch/network, одноразового HTTP-сервера, вхідного запиту, live-test, тимчасової файлової системи та керування часом |
+ | `plugin-sdk/test-fixtures` | Загальні тестові фікстури CLI, sandbox, skill, agent-message, system-event, перезавантаження модуля, шляху вбудованого Plugin, terminal, chunking, auth-token і typed-case |
+ | `plugin-sdk/test-node-mocks` | Цільові помічники mock для вбудованих модулів Node для використання всередині фабрик Vitest `vi.mock("node:*")` |
+ | `plugin-sdk/migration` | Помічники елементів provider міграції, як-от `createMigrationItem`, константи причин, маркери статусу елементів, помічники редагування та `summarizeMigrationItems` |
| `plugin-sdk/migration-runtime` | Runtime-помічники міграції, як-от `copyMigrationFileItem` і `writeMigrationReport` |
-
+
| Підшлях | Ключові експорти |
| --- | --- |
| `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` | Спільні помічники setup wizard, allowlist prompts, builder-и стану setup |
+ | `plugin-sdk/setup` | Спільні помічники setup wizard, prompt allowlist, builders статусу setup |
| `plugin-sdk/setup-runtime` | `createPatchedAccountSetupAdapter`, `createEnvPatchedAccountSetupAdapter`, `createSetupInputPresenceValidator`, `noteChannelLookupFailure`, `noteChannelLookupSummary`, `promptResolvedAllowFrom`, `splitSetupEntries`, `createAllowlistSetupWizardProxy`, `createDelegatedSetupWizardProxy` |
| `plugin-sdk/setup-adapter-runtime` | `createEnvPatchedAccountSetupAdapter` |
| `plugin-sdk/setup-tools` | `formatCliCommand`, `detectBinary`, `extractArchive`, `resolveBrewExecutable`, `formatDocsLink`, `CONFIG_DIR` |
- | `plugin-sdk/account-core` | Помічники multi-account config/action-gate, помічники fallback облікового запису за замовчуванням |
+ | `plugin-sdk/account-core` | Помічники config/action-gate для кількох облікових записів, помічники fallback для облікового запису за замовчуванням |
| `plugin-sdk/account-id` | `DEFAULT_ACCOUNT_ID`, помічники нормалізації account-id |
- | `plugin-sdk/account-resolution` | Помічники пошуку облікового запису та default-fallback |
+ | `plugin-sdk/account-resolution` | Помічники пошуку облікового запису та fallback за замовчуванням |
| `plugin-sdk/account-helpers` | Вузькі помічники account-list/account-action |
| `plugin-sdk/channel-pairing` | `createChannelPairingController` |
| `plugin-sdk/channel-reply-pipeline` | `createChannelReplyPipeline`, `resolveChannelSourceReplyDeliveryMode` |
| `plugin-sdk/channel-config-helpers` | `createHybridChannelConfigAdapter` |
| `plugin-sdk/channel-config-schema` | Спільні примітиви схеми конфігурації каналу та generic builder |
- | `plugin-sdk/bundled-channel-config-schema` | Bundled схеми конфігурації каналів OpenClaw лише для підтримуваних bundled plugins |
- | `plugin-sdk/channel-config-schema-legacy` | Застарілий псевдонім сумісності для bundled-channel config schemas |
- | `plugin-sdk/telegram-command-config` | Помічники нормалізації/валідації користувацьких команд Telegram із bundled-contract fallback |
- | `plugin-sdk/command-gating` | Вузькі помічники gate авторизації команд |
+ | `plugin-sdk/bundled-channel-config-schema` | Схеми конфігурації вбудованих каналів OpenClaw лише для підтримуваних вбудованих Plugin |
+ | `plugin-sdk/channel-config-schema-legacy` | Застарілий alias сумісності для схем конфігурації bundled-channel |
+ | `plugin-sdk/telegram-command-config` | Помічники нормалізації/валідації користувацьких команд Telegram з fallback bundled-contract |
+ | `plugin-sdk/command-gating` | Вузькі помічники authorization gate для команд |
| `plugin-sdk/channel-policy` | `resolveChannelGroupRequireMention` |
| `plugin-sdk/channel-lifecycle` | `createAccountStatusSink`, помічники життєвого циклу/finalization draft stream |
- | `plugin-sdk/inbound-envelope` | Спільні помічники inbound route та builder envelope |
+ | `plugin-sdk/inbound-envelope` | Спільні помічники inbound route і envelope builder |
| `plugin-sdk/inbound-reply-dispatch` | Спільні помічники record-and-dispatch для inbound |
| `plugin-sdk/messaging-targets` | Помічники parsing/matching цілей |
| `plugin-sdk/outbound-media` | Спільні помічники завантаження outbound media |
- | `plugin-sdk/outbound-send-deps` | Легкий пошук залежностей outbound send для адаптерів каналів |
- | `plugin-sdk/outbound-runtime` | Помічники outbound delivery, identity, send delegate, session, formatting і payload planning |
+ | `plugin-sdk/outbound-send-deps` | Легкий пошук залежностей outbound send для адаптерів каналу |
+ | `plugin-sdk/outbound-runtime` | Помічники outbound delivery, identity, send delegate, session, форматування та планування payload |
| `plugin-sdk/poll-runtime` | Вузькі помічники нормалізації poll |
| `plugin-sdk/thread-bindings-runtime` | Помічники життєвого циклу thread-binding і адаптера |
| `plugin-sdk/agent-media-payload` | Застарілий builder agent media payload |
| `plugin-sdk/conversation-runtime` | Помічники conversation/thread binding, pairing і configured-binding |
- | `plugin-sdk/runtime-config-snapshot` | Помічник snapshot runtime-конфігурації |
- | `plugin-sdk/runtime-group-policy` | Помічники вирішення runtime group-policy |
- | `plugin-sdk/channel-status` | Спільні помічники snapshot/summary стану каналу |
+ | `plugin-sdk/runtime-config-snapshot` | Помічник snapshot runtime config |
+ | `plugin-sdk/runtime-group-policy` | Помічники розв’язання runtime group-policy |
+ | `plugin-sdk/channel-status` | Спільні помічники snapshot/summary статусу каналу |
| `plugin-sdk/channel-config-primitives` | Вузькі примітиви channel config-schema |
| `plugin-sdk/channel-config-writes` | Помічники авторизації channel config-write |
- | `plugin-sdk/channel-plugin-common` | Спільні експорти прелюдії channel plugin |
+ | `plugin-sdk/channel-plugin-common` | Спільні експорти prelude для Plugin каналу |
| `plugin-sdk/allowlist-config-edit` | Помічники редагування/читання allowlist config |
- | `plugin-sdk/group-access` | Спільні помічники рішень group-access |
+ | `plugin-sdk/group-access` | Спільні помічники ухвалення рішень group-access |
| `plugin-sdk/direct-dm` | Спільні помічники direct-DM auth/guard |
- | `plugin-sdk/discord` | Застарілий фасад сумісності Discord для опублікованого `@openclaw/discord@2026.3.13`; нові plugins мають використовувати generic підшляхи SDK каналу |
- | `plugin-sdk/interactive-runtime` | Помічники semantic message presentation, delivery і застарілих interactive reply. Див. [подання повідомлень](/uk/plugins/message-presentation) |
+ | `plugin-sdk/discord` | Застарілий фасад сумісності Discord для опублікованого `@openclaw/discord@2026.3.13` і відстежуваної сумісності власника; нові Plugin мають використовувати загальні підшляхи SDK каналу |
+ | `plugin-sdk/telegram-account` | Застарілий фасад сумісності розв’язання облікового запису Telegram для відстежуваної сумісності власника; нові Plugin мають використовувати injected runtime helpers або загальні підшляхи SDK каналу |
+ | `plugin-sdk/interactive-runtime` | Семантичне представлення повідомлень, доставка та застарілі помічники interactive reply. Див. [Представлення повідомлень](/uk/plugins/message-presentation) |
| `plugin-sdk/channel-inbound` | Barrel сумісності для inbound debounce, mention matching, помічників mention-policy і envelope helpers |
| `plugin-sdk/channel-inbound-debounce` | Вузькі помічники inbound debounce |
| `plugin-sdk/channel-mention-gating` | Вузькі помічники mention-policy, mention marker і mention text без ширшої поверхні inbound runtime |
| `plugin-sdk/channel-envelope` | Вузькі помічники форматування inbound envelope |
- | `plugin-sdk/channel-location` | Контекст місця каналу та помічники форматування |
- | `plugin-sdk/channel-logging` | Помічники логування каналу для inbound drops і typing/ack failures |
- | `plugin-sdk/channel-send-result` | Типи результатів reply |
- | `plugin-sdk/channel-actions` | Помічники channel message-action, а також застарілі помічники native schema, збережені для сумісності Plugin |
- | `plugin-sdk/channel-route` | Спільна нормалізація маршрутів, parser-driven target resolution, stringification thread-id, dedupe/compact route keys, типи parsed-target і помічники порівняння route/target |
- | `plugin-sdk/channel-targets` | Помічники parsing цілей; виклики порівняння маршрутів мають використовувати `plugin-sdk/channel-route` |
+ | `plugin-sdk/channel-location` | Контекст розташування каналу та помічники форматування |
+ | `plugin-sdk/channel-logging` | Помічники logging каналу для inbound drops і typing/ack failures |
+ | `plugin-sdk/channel-send-result` | Типи результату відповіді |
+ | `plugin-sdk/channel-actions` | Помічники message-action каналу, а також застарілі помічники native schema, збережені для сумісності Plugin |
+ | `plugin-sdk/channel-route` | Спільні помічники нормалізації route, parser-driven target resolution, stringification thread-id, ключів dedupe/compact route, типів parsed-target і порівняння route/target |
+ | `plugin-sdk/channel-targets` | Помічники parsing цілей; виклики порівняння route мають використовувати `plugin-sdk/channel-route` |
| `plugin-sdk/channel-contract` | Типи контрактів каналу |
- | `plugin-sdk/channel-feedback` | Підключення feedback/reaction |
+ | `plugin-sdk/channel-feedback` | Wiring feedback/reaction |
| `plugin-sdk/channel-secret-runtime` | Вузькі помічники secret-contract, як-от `collectSimpleChannelFieldAssignments`, `getChannelSurface`, `pushAssignment`, і типи secret target |
- | Підшлях | Ключові експорти |
+ | Підшлях | Основні експорти |
| --- | --- |
| `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry` |
| `plugin-sdk/lmstudio` | Підтримуваний фасад провайдера LM Studio для налаштування, виявлення каталогу та підготовки моделей під час виконання |
- | `plugin-sdk/lmstudio-runtime` | Підтримуваний фасад середовища виконання LM Studio для локальних стандартних параметрів сервера, виявлення моделей, заголовків запитів і допоміжних функцій для завантажених моделей |
- | `plugin-sdk/provider-setup` | Добірні допоміжні функції налаштування локальних/самостійно розгорнутих провайдерів |
- | `plugin-sdk/self-hosted-provider-setup` | Спеціалізовані допоміжні функції налаштування самостійно розгорнутих OpenAI-сумісних провайдерів |
+ | `plugin-sdk/lmstudio-runtime` | Підтримуваний runtime-фасад LM Studio для стандартних параметрів локального сервера, виявлення моделей, заголовків запитів і допоміжних засобів для завантажених моделей |
+ | `plugin-sdk/provider-setup` | Добірні допоміжні засоби налаштування локальних/self-hosted провайдерів |
+ | `plugin-sdk/self-hosted-provider-setup` | Спеціалізовані допоміжні засоби налаштування OpenAI-сумісних self-hosted провайдерів |
| `plugin-sdk/cli-backend` | Стандартні параметри бекенда CLI + константи watchdog |
- | `plugin-sdk/provider-auth-runtime` | Допоміжні функції розв’язання API-ключів під час виконання для Plugin провайдерів |
- | `plugin-sdk/provider-auth-api-key` | Допоміжні функції онбордингу API-ключів/запису профілю, як-от `upsertApiKeyProfile` |
+ | `plugin-sdk/provider-auth-runtime` | Допоміжні засоби runtime для визначення API-ключів для Plugin провайдерів |
+ | `plugin-sdk/provider-auth-api-key` | Допоміжні засоби онбордингу API-ключів/запису профілів, як-от `upsertApiKeyProfile` |
| `plugin-sdk/provider-auth-result` | Стандартний конструктор результату автентифікації OAuth |
- | `plugin-sdk/provider-auth-login` | Спільні допоміжні функції інтерактивного входу для Plugin провайдерів |
- | `plugin-sdk/provider-env-vars` | Допоміжні функції пошуку змінних середовища автентифікації провайдера |
+ | `plugin-sdk/provider-auth-login` | Спільні допоміжні засоби інтерактивного входу для Plugin провайдерів |
+ | `plugin-sdk/provider-env-vars` | Допоміжні засоби пошуку змінних середовища автентифікації провайдера |
| `plugin-sdk/provider-auth` | `createProviderApiKeyAuthMethod`, `ensureApiKeyFromOptionEnvOrPrompt`, `upsertAuthProfile`, `upsertApiKeyProfile`, `writeOAuthCredentials` |
- | `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні конструктори політик відтворення, допоміжні функції кінцевих точок провайдерів і допоміжні функції нормалізації ID моделей, як-от `normalizeNativeXaiModelId` |
- | `plugin-sdk/provider-catalog-runtime` | Хук середовища виконання для доповнення каталогу провайдера та шви реєстру Plugin-провайдерів для контрактних тестів |
+ | `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні конструктори політик повторного відтворення, допоміжні засоби endpoint провайдера та допоміжні засоби нормалізації model-id, як-от `normalizeNativeXaiModelId` |
+ | `plugin-sdk/provider-catalog-runtime` | Runtime-хук доповнення каталогу провайдера та шви реєстру plugin-провайдерів для контрактних тестів |
| `plugin-sdk/provider-catalog-shared` | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `buildManifestModelProviderConfig`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` |
- | `plugin-sdk/provider-http` | Загальні допоміжні функції можливостей HTTP/кінцевих точок провайдерів, HTTP-помилки провайдерів і допоміжні функції multipart-форм для транскрипції аудіо |
- | `plugin-sdk/provider-web-fetch-contract` | Вузькі допоміжні функції контракту конфігурації/вибору web-fetch, як-от `enablePluginInConfig` і `WebFetchProviderPlugin` |
- | `plugin-sdk/provider-web-fetch` | Допоміжні функції реєстрації/кешування провайдера web-fetch |
- | `plugin-sdk/provider-web-search-config-contract` | Вузькі допоміжні функції конфігурації/облікових даних web-search для провайдерів, яким не потрібне підключення увімкнення Plugin |
- | `plugin-sdk/provider-web-search-contract` | Вузькі допоміжні функції контракту конфігурації/облікових даних web-search, як-от `createWebSearchProviderContractFields`, `enablePluginInConfig`, `resolveProviderWebSearchPluginConfig`, а також обмежені за областю сетери/гетери облікових даних |
- | `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/DeepSeek V4/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
- | `plugin-sdk/provider-transport-runtime` | Допоміжні функції нативного транспорту провайдерів, як-от захищений fetch, перетворення транспортних повідомлень і записувані потоки транспортних подій |
- | `plugin-sdk/provider-onboard` | Допоміжні функції патчів конфігурації онбордингу |
- | `plugin-sdk/global-singleton` | Допоміжні функції локальних для процесу singleton/map/cache |
- | `plugin-sdk/group-activation` | Вузькі допоміжні функції режиму активації груп і парсингу команд |
+ | `plugin-sdk/provider-http` | Загальні допоміжні засоби можливостей HTTP/endpoint провайдера, HTTP-помилки провайдера та допоміжні засоби multipart-форм для транскрибування аудіо |
+ | `plugin-sdk/provider-web-fetch-contract` | Вузькі допоміжні засоби контракту конфігурації/вибору web-fetch, як-от `enablePluginInConfig` і `WebFetchProviderPlugin` |
+ | `plugin-sdk/provider-web-fetch` | Допоміжні засоби реєстрації/кешу провайдера web-fetch |
+ | `plugin-sdk/provider-web-search-config-contract` | Вузькі допоміжні засоби конфігурації/облікових даних web-search для провайдерів, яким не потрібне підключення увімкнення Plugin |
+ | `plugin-sdk/provider-web-search-contract` | Вузькі допоміжні засоби контракту конфігурації/облікових даних web-search, як-от `createWebSearchProviderContractFields`, `enablePluginInConfig`, `resolveProviderWebSearchPluginConfig`, і scoped сетери/гетери облікових даних |
+ | `plugin-sdk/provider-web-search` | Допоміжні засоби реєстрації/кешу/runtime провайдера web-search |
+ | `plugin-sdk/provider-tools` | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, очищення схем Gemini + діагностика та допоміжні засоби сумісності xAI, як-от `resolveXaiModelCompatPatch` / `applyXaiModelCompat` |
+ | `plugin-sdk/provider-usage` | `fetchClaudeUsage` і подібні |
+ | `plugin-sdk/provider-stream` | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, типи обгорток потоку та спільні допоміжні засоби обгорток Anthropic/Bedrock/DeepSeek V4/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
+ | `plugin-sdk/provider-transport-runtime` | Допоміжні засоби нативного транспорту провайдера, як-от захищений fetch, перетворення транспортних повідомлень і придатні для запису потоки транспортних подій |
+ | `plugin-sdk/provider-onboard` | Допоміжні засоби патчів конфігурації онбордингу |
+ | `plugin-sdk/global-singleton` | Допоміжні засоби singleton/map/cache, локальні для процесу |
+ | `plugin-sdk/group-activation` | Вузькі допоміжні засоби режиму активації груп і парсингу команд |
- | Підшлях | Ключові експорти |
+ | Підшлях | Основні експорти |
| --- | --- |
- | `plugin-sdk/command-auth` | `resolveControlCommandGate`, допоміжні функції реєстру команд, зокрема форматування меню динамічних аргументів, допоміжні функції авторизації відправника |
+ | `plugin-sdk/command-auth` | `resolveControlCommandGate`, допоміжні засоби реєстру команд, зокрема форматування меню динамічних аргументів, допоміжні засоби авторизації відправника |
| `plugin-sdk/command-status` | Конструктори повідомлень команд/довідки, як-от `buildCommandsMessagePaginated` і `buildHelpMessage` |
- | `plugin-sdk/approval-auth-runtime` | Допоміжні функції розв’язання затверджувача та автентифікації дій у тому самому чаті |
- | `plugin-sdk/approval-client-runtime` | Допоміжні функції профілю/фільтра нативного затвердження exec |
- | `plugin-sdk/approval-delivery-runtime` | Нативні адаптери можливостей/доставки затверджень |
- | `plugin-sdk/approval-gateway-runtime` | Спільна допоміжна функція розв’язання Gateway для затверджень |
- | `plugin-sdk/approval-handler-adapter-runtime` | Легковагові допоміжні функції завантаження нативного адаптера затверджень для гарячих точок входу каналів |
- | `plugin-sdk/approval-handler-runtime` | Ширші допоміжні функції середовища виконання обробника затверджень; надавайте перевагу вужчим швам адаптера/Gateway, коли їх достатньо |
- | `plugin-sdk/approval-native-runtime` | Допоміжні функції нативної цілі затвердження + прив’язки облікового запису |
- | `plugin-sdk/approval-reply-runtime` | Допоміжні функції payload відповіді затвердження exec/Plugin |
- | `plugin-sdk/approval-runtime` | Допоміжні функції payload затвердження exec/Plugin, допоміжні функції маршрутизації/середовища виконання нативних затверджень і допоміжні функції структурованого відображення затверджень, як-от `formatApprovalDisplayPath` |
- | `plugin-sdk/reply-dedupe` | Вузькі допоміжні функції скидання дедуплікації вхідних відповідей |
- | `plugin-sdk/channel-contract-testing` | Вузькі допоміжні функції тестування контрактів каналів без широкого barrel для тестування |
- | `plugin-sdk/command-auth-native` | Нативна автентифікація команд, форматування меню динамічних аргументів і допоміжні функції нативної цілі сеансу |
- | `plugin-sdk/command-detection` | Спільні допоміжні функції виявлення команд |
- | `plugin-sdk/command-primitives-runtime` | Легковагові предикати тексту команд для гарячих шляхів каналів |
- | `plugin-sdk/command-surface` | Нормалізація тіла команд і допоміжні функції поверхні команд |
+ | `plugin-sdk/approval-auth-runtime` | Допоміжні засоби визначення approver і автентифікації дій у тому самому чаті |
+ | `plugin-sdk/approval-client-runtime` | Допоміжні засоби нативного профілю/фільтра схвалення exec |
+ | `plugin-sdk/approval-delivery-runtime` | Нативні адаптери можливостей/доставлення схвалення |
+ | `plugin-sdk/approval-gateway-runtime` | Спільний допоміжний засіб визначення Gateway схвалення |
+ | `plugin-sdk/approval-handler-adapter-runtime` | Легкі допоміжні засоби завантаження нативного адаптера схвалення для гарячих entrypoint каналів |
+ | `plugin-sdk/approval-handler-runtime` | Ширші допоміжні засоби runtime обробника схвалень; віддавайте перевагу вужчим швам adapter/gateway, коли їх достатньо |
+ | `plugin-sdk/approval-native-runtime` | Нативна ціль схвалення + допоміжні засоби прив’язування облікового запису |
+ | `plugin-sdk/approval-reply-runtime` | Допоміжні засоби payload відповіді схвалення exec/plugin |
+ | `plugin-sdk/approval-runtime` | Допоміжні засоби payload схвалення exec/plugin, нативні допоміжні засоби маршрутизації/runtime схвалення та допоміжні засоби структурованого відображення схвалення, як-от `formatApprovalDisplayPath` |
+ | `plugin-sdk/reply-dedupe` | Вузькі допоміжні засоби скидання дедуплікації вхідних відповідей |
+ | `plugin-sdk/channel-contract-testing` | Вузькі допоміжні засоби контрактного тестування каналів без широкого barrel для тестування |
+ | `plugin-sdk/command-auth-native` | Нативна автентифікація команд, форматування меню динамічних аргументів і допоміжні засоби нативної цілі сеансу |
+ | `plugin-sdk/command-detection` | Спільні допоміжні засоби виявлення команд |
+ | `plugin-sdk/command-primitives-runtime` | Легкі предикати тексту команд для гарячих шляхів каналів |
+ | `plugin-sdk/command-surface` | Нормалізація тіла команди та допоміжні засоби поверхні команд |
| `plugin-sdk/allow-from` | `formatAllowFromLowercase` |
- | `plugin-sdk/channel-secret-runtime` | Вузькі допоміжні функції збирання контрактів секретів для поверхонь секретів каналів/Plugin |
- | `plugin-sdk/secret-ref-runtime` | Вузькі допоміжні функції `coerceSecretRef` і типізації SecretRef для парсингу контрактів секретів/конфігурації |
- | `plugin-sdk/security-runtime` | Спільні допоміжні функції довіри, обмеження DM, зовнішнього вмісту, редагування чутливого тексту, порівняння секретів за сталий час і збирання секретів |
- | `plugin-sdk/ssrf-policy` | Допоміжні функції списку дозволених хостів і політики SSRF для приватної мережі |
- | `plugin-sdk/ssrf-dispatcher` | Вузькі допоміжні функції закріпленого диспетчера без широкої інфраструктурної поверхні середовища виконання |
- | `plugin-sdk/ssrf-runtime` | Допоміжні функції закріпленого диспетчера, захищеного від SSRF fetch, помилок SSRF і політик SSRF |
- | `plugin-sdk/secret-input` | Допоміжні функції парсингу введення секретів |
- | `plugin-sdk/webhook-ingress` | Допоміжні функції запиту/цілі Webhook і приведення сирого websocket/body |
- | `plugin-sdk/webhook-request-guards` | Допоміжні функції розміру/тайм-ауту тіла запиту |
+ | `plugin-sdk/channel-secret-runtime` | Вузькі допоміжні засоби збирання контракту секретів для поверхонь секретів channel/plugin |
+ | `plugin-sdk/secret-ref-runtime` | Вузькі допоміжні засоби `coerceSecretRef` і типізації SecretRef для парсингу контракту секретів/конфігурації |
+ | `plugin-sdk/security-runtime` | Спільні допоміжні засоби довіри, DM-gating, зовнішнього вмісту, редагування чутливого тексту, порівняння секретів за сталий час і збирання секретів |
+ | `plugin-sdk/ssrf-policy` | Допоміжні засоби allowlist хостів і політики SSRF для приватної мережі |
+ | `plugin-sdk/ssrf-dispatcher` | Вузькі допоміжні засоби pinned-dispatcher без широкої runtime-поверхні infra |
+ | `plugin-sdk/ssrf-runtime` | Допоміжні засоби pinned-dispatcher, SSRF-захищеного fetch, SSRF-помилки та SSRF-політики |
+ | `plugin-sdk/secret-input` | Допоміжні засоби парсингу введення секретів |
+ | `plugin-sdk/webhook-ingress` | Допоміжні засоби Webhook-запиту/цілі та приведення raw websocket/body |
+ | `plugin-sdk/webhook-request-guards` | Допоміжні засоби розміру тіла запиту/тайм-ауту |
| Підшлях | Ключові експорти |
| --- | --- |
- | `plugin-sdk/runtime` | Широкі допоміжні засоби для середовища виконання, журналювання, резервного копіювання та встановлення Plugin |
- | `plugin-sdk/runtime-env` | Вузькі допоміжні засоби для env середовища виконання, logger, timeout, retry і backoff |
- | `plugin-sdk/browser-config` | Підтримуваний фасад конфігурації браузера для нормалізованого профілю/типових значень, розбору URL CDP і допоміжних засобів автентифікації керування браузером |
- | `plugin-sdk/channel-runtime-context` | Допоміжні засоби реєстрації та пошуку generic контексту середовища виконання каналу |
+ | `plugin-sdk/runtime` | Широкі допоміжні засоби середовища виконання/журналювання/резервного копіювання/встановлення плагінів |
+ | `plugin-sdk/runtime-env` | Вузькі допоміжні засоби середовища виконання env, логера, таймауту, повторних спроб і backoff |
+ | `plugin-sdk/browser-config` | Підтримуваний фасад конфігурації браузера для нормалізованого профілю/стандартних значень, розбору URL CDP і допоміжних засобів автентифікації керування браузером |
+ | `plugin-sdk/channel-runtime-context` | Універсальні допоміжні засоби реєстрації та пошуку контексту середовища виконання каналу |
| `plugin-sdk/runtime-store` | `createPluginRuntimeStore` |
- | `plugin-sdk/plugin-runtime` | Спільні допоміжні засоби команд Plugin, hook, http та інтерактивної взаємодії |
- | `plugin-sdk/hook-runtime` | Спільні допоміжні засоби конвеєра Webhook/внутрішніх hook |
- | `plugin-sdk/lazy-runtime` | Допоміжні засоби лінивого імпорту/прив’язування середовища виконання, як-от `createLazyRuntimeModule`, `createLazyRuntimeMethod` і `createLazyRuntimeSurface` |
+ | `plugin-sdk/plugin-runtime` | Спільні допоміжні засоби команд/хуків/http/інтерактивної роботи Plugin |
+ | `plugin-sdk/hook-runtime` | Спільні допоміжні засоби конвеєра Webhook/внутрішніх хуків |
+ | `plugin-sdk/lazy-runtime` | Допоміжні засоби лінивого імпорту/прив'язування середовища виконання, як-от `createLazyRuntimeModule`, `createLazyRuntimeMethod` і `createLazyRuntimeSurface` |
| `plugin-sdk/process-runtime` | Допоміжні засоби виконання процесів |
| `plugin-sdk/cli-runtime` | Допоміжні засоби форматування CLI, очікування, версії, виклику аргументів і лінивих груп команд |
- | `plugin-sdk/gateway-runtime` | Клієнт Gateway, RPC CLI Gateway, помилки протоколу Gateway і допоміжні засоби patch статусу каналу |
- | `plugin-sdk/config-types` | Поверхня конфігурації лише для типів для форм конфігурації Plugin, як-от `OpenClawConfig`, і типів конфігурації каналів/провайдерів |
+ | `plugin-sdk/gateway-runtime` | Клієнт Gateway, RPC CLI шлюзу, помилки протоколу шлюзу та допоміжні засоби латок статусу каналу |
+ | `plugin-sdk/config-types` | Поверхня конфігурації лише з типами для форм конфігурації плагінів, як-от `OpenClawConfig`, і типів конфігурації каналів/провайдерів |
| `plugin-sdk/plugin-config-runtime` | Допоміжні засоби пошуку конфігурації Plugin у середовищі виконання, як-от `requireRuntimeConfig`, `resolvePluginConfigObject` і `resolveLivePluginConfigObject` |
| `plugin-sdk/config-mutation` | Допоміжні засоби транзакційної зміни конфігурації, як-от `mutateConfigFile`, `replaceConfigFile` і `logConfigUpdated` |
- | `plugin-sdk/runtime-config-snapshot` | Допоміжні засоби знімка конфігурації поточного процесу, як-от `getRuntimeConfig`, `getRuntimeConfigSnapshot`, і тестові setter знімків |
- | `plugin-sdk/telegram-command-config` | Нормалізація назв/описів команд Telegram і перевірки дублікатів/конфліктів, навіть коли вбудована контрактна поверхня Telegram недоступна |
- | `plugin-sdk/text-autolink-runtime` | Виявлення autolink для посилань на файли без широкого barrel text-runtime |
- | `plugin-sdk/approval-runtime` | Допоміжні засоби схвалення exec/Plugin, побудовники можливостей схвалення, допоміжні засоби auth/profile, native routing/runtime і форматування структурованого шляху відображення схвалення |
- | `plugin-sdk/reply-runtime` | Спільні допоміжні засоби середовища виконання inbound/reply, chunking, dispatch, Heartbeat, планувальник відповідей |
- | `plugin-sdk/reply-dispatch-runtime` | Вузькі допоміжні засоби dispatch/finalize відповіді та міток розмов |
- | `plugin-sdk/reply-history` | Спільні допоміжні засоби коротковіконної історії відповідей і маркери, як-от `buildHistoryContext`, `HISTORY_CONTEXT_MARKER`, `recordPendingHistoryEntry` і `clearHistoryEntriesIfEnabled` |
+ | `plugin-sdk/runtime-config-snapshot` | Допоміжні засоби знімка конфігурації поточного процесу, як-от `getRuntimeConfig`, `getRuntimeConfigSnapshot`, і сетери тестових знімків |
+ | `plugin-sdk/telegram-command-config` | Нормалізація назв/описів команд Telegram і перевірки дублікатів/конфліктів, навіть коли пакетна контрактна поверхня Telegram недоступна |
+ | `plugin-sdk/text-autolink-runtime` | Виявлення автопосилань на файлові посилання без широкого barrel `text-runtime` |
+ | `plugin-sdk/approval-runtime` | Допоміжні засоби затвердження exec/Plugin, побудовники можливостей затвердження, допоміжні засоби автентифікації/профілів, нативні допоміжні засоби маршрутизації/середовища виконання та форматування шляхів структурованого відображення затверджень |
+ | `plugin-sdk/reply-runtime` | Спільні допоміжні засоби середовища виконання вхідних повідомлень/відповідей, розбиття на частини, диспетчеризація, Heartbeat, планувальник відповідей |
+ | `plugin-sdk/reply-dispatch-runtime` | Вузькі допоміжні засоби диспетчеризації/фіналізації відповідей і міток розмов |
+ | `plugin-sdk/reply-history` | Спільні допоміжні засоби короткого вікна історії відповідей і маркери, як-от `buildHistoryContext`, `HISTORY_CONTEXT_MARKER`, `recordPendingHistoryEntry` і `clearHistoryEntriesIfEnabled` |
| `plugin-sdk/reply-reference` | `createReplyReferencePlanner` |
- | `plugin-sdk/reply-chunking` | Вузькі допоміжні засоби chunking тексту/Markdown |
- | `plugin-sdk/session-store-runtime` | Допоміжні засоби шляху сховища сесій, ключа сесії, updated-at і зміни сховища |
+ | `plugin-sdk/reply-chunking` | Вузькі допоміжні засоби розбиття тексту/markdown на частини |
+ | `plugin-sdk/session-store-runtime` | Допоміжні засоби шляху сховища сеансів, ключа сеансу, часу оновлення та зміни сховища |
| `plugin-sdk/cron-store-runtime` | Допоміжні засоби шляху/завантаження/збереження сховища Cron |
- | `plugin-sdk/state-paths` | Допоміжні засоби шляхів директорій стану/OAuth |
- | `plugin-sdk/routing` | Допоміжні засоби route/session-key/account binding, як-от `resolveAgentRoute`, `buildAgentSessionKey` і `resolveDefaultAgentBoundAccountId` |
- | `plugin-sdk/status-helpers` | Спільні допоміжні засоби підсумку статусу каналу/облікового запису, типові значення стану середовища виконання та допоміжні засоби метаданих issue |
- | `plugin-sdk/target-resolver-runtime` | Спільні допоміжні засоби розв’язувача цілей |
+ | `plugin-sdk/state-paths` | Допоміжні засоби шляхів каталогів стану/OAuth |
+ | `plugin-sdk/routing` | Допоміжні засоби маршруту/ключа сеансу/прив'язування облікового запису, як-от `resolveAgentRoute`, `buildAgentSessionKey` і `resolveDefaultAgentBoundAccountId` |
+ | `plugin-sdk/status-helpers` | Спільні допоміжні засоби зведення статусу каналу/облікового запису, стандартні значення стану середовища виконання та допоміжні засоби метаданих проблем |
+ | `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` | Спільні reader параметрів інструментів/CLI |
- | `plugin-sdk/tool-payload` | Витягує нормалізовані payload з об’єктів результату інструмента |
- | `plugin-sdk/tool-send` | Витягує канонічні поля цілі надсилання з аргументів інструмента |
- | `plugin-sdk/temp-path` | Спільні допоміжні засоби шляхів тимчасового завантаження |
- | `plugin-sdk/logging-core` | Допоміжні засоби logger підсистем і редагування секретних даних |
- | `plugin-sdk/markdown-table-runtime` | Допоміжні засоби режиму й перетворення Markdown-таблиць |
- | `plugin-sdk/model-session-runtime` | Допоміжні засоби перевизначення моделі/сесії, як-от `applyModelOverrideToSessionEntry` і `resolveAgentMaxConcurrent` |
- | `plugin-sdk/talk-config-runtime` | Допоміжні засоби розв’язання конфігурації talk-провайдера |
- | `plugin-sdk/json-store` | Невеликі допоміжні засоби читання/запису JSON-стану |
- | `plugin-sdk/file-lock` | Допоміжні засоби реентерабельного file-lock |
- | `plugin-sdk/persistent-dedupe` | Допоміжні засоби дискового dedupe-кешу |
- | `plugin-sdk/acp-runtime` | Допоміжні засоби середовища виконання/сесії ACP і dispatch відповідей |
- | `plugin-sdk/acp-runtime-backend` | Легкі допоміжні засоби реєстрації бекенду ACP і dispatch відповідей для Plugin, завантажених під час запуску |
- | `plugin-sdk/acp-binding-resolve-runtime` | Розв’язання ACP binding лише для читання без імпортів запуску lifecycle |
+ | `plugin-sdk/request-url` | Витягання рядкових URL з fetch/request-подібних вхідних даних |
+ | `plugin-sdk/run-command` | Запускач команд із таймером і нормалізованими результатами stdout/stderr |
+ | `plugin-sdk/param-readers` | Спільні зчитувачі параметрів інструментів/CLI |
+ | `plugin-sdk/tool-payload` | Витягання нормалізованих payload з об'єктів результатів інструментів |
+ | `plugin-sdk/tool-send` | Витягання канонічних полів цілі надсилання з аргументів інструмента |
+ | `plugin-sdk/temp-path` | Спільні допоміжні засоби шляхів тимчасових завантажень |
+ | `plugin-sdk/logging-core` | Допоміжні засоби логера підсистем і редагування конфіденційних даних |
+ | `plugin-sdk/markdown-table-runtime` | Допоміжні засоби режиму та перетворення таблиць Markdown |
+ | `plugin-sdk/model-session-runtime` | Допоміжні засоби перевизначення моделі/сеансу, як-от `applyModelOverrideToSessionEntry` і `resolveAgentMaxConcurrent` |
+ | `plugin-sdk/talk-config-runtime` | Допоміжні засоби розв'язання конфігурації провайдера Talk |
+ | `plugin-sdk/json-store` | Невеликі допоміжні засоби читання/запису стану JSON |
+ | `plugin-sdk/file-lock` | Допоміжні засоби повторно-вхідного блокування файлів |
+ | `plugin-sdk/persistent-dedupe` | Допоміжні засоби кешу дедуплікації на диску |
+ | `plugin-sdk/acp-runtime` | Допоміжні засоби середовища виконання/сеансу ACP і диспетчеризації відповідей |
+ | `plugin-sdk/acp-runtime-backend` | Легковагові допоміжні засоби реєстрації бекенда ACP і диспетчеризації відповідей для плагінів, завантажених під час запуску |
+ | `plugin-sdk/acp-binding-resolve-runtime` | Розв'язання прив'язок ACP лише для читання без імпортів запуску життєвого циклу |
| `plugin-sdk/agent-config-primitives` | Вузькі примітиви схеми конфігурації середовища виконання агента |
- | `plugin-sdk/boolean-param` | Нестрогий reader булевого параметра |
- | `plugin-sdk/dangerous-name-runtime` | Допоміжні засоби розв’язання зіставлення небезпечних імен |
- | `plugin-sdk/device-bootstrap` | Допоміжні засоби bootstrap пристрою та токенів pairing |
- | `plugin-sdk/extension-shared` | Спільні примітиви допоміжних засобів пасивного каналу, статусу й ambient proxy |
- | `plugin-sdk/models-provider-runtime` | Допоміжні засоби відповіді команди/провайдера `/models` |
- | `plugin-sdk/skill-commands-runtime` | Допоміжні засоби перелічення команд Skills |
- | `plugin-sdk/native-command-registry` | Допоміжні засоби реєстру/побудови/серіалізації native команд |
- | `plugin-sdk/agent-harness` | Експериментальна поверхня довірених Plugin для низькорівневих harness агентів: типи harness, допоміжні засоби steer/abort active-run, допоміжні засоби мосту інструментів OpenClaw, допоміжні засоби політики інструментів runtime-plan, класифікація результатів термінала, допоміжні засоби форматування/деталізації перебігу інструментів і утиліти результатів спроб |
+ | `plugin-sdk/boolean-param` | Нестрогий зчитувач булевих параметрів |
+ | `plugin-sdk/dangerous-name-runtime` | Допоміжні засоби розв'язання зіставлення небезпечних назв |
+ | `plugin-sdk/device-bootstrap` | Допоміжні засоби bootstrap пристрою та токена спарювання |
+ | `plugin-sdk/extension-shared` | Спільні примітиви допоміжних засобів пасивного каналу, статусу та ambient proxy |
+ | `plugin-sdk/models-provider-runtime` | Допоміжні засоби відповідей команди/провайдера `/models` |
+ | `plugin-sdk/skill-commands-runtime` | Допоміжні засоби списку команд Skills |
+ | `plugin-sdk/native-command-registry` | Допоміжні засоби реєстру/побудови/серіалізації нативних команд |
+ | `plugin-sdk/agent-harness` | Експериментальна поверхня довіреного Plugin для низькорівневих агентських harness: типи harness, допоміжні засоби скеровування/переривання активного запуску, допоміжні засоби моста інструментів OpenClaw, допоміжні засоби політик інструментів runtime-plan, класифікація результатів термінала, допоміжні засоби форматування/деталізації прогресу інструментів і утиліти результатів спроб |
| `plugin-sdk/provider-zai-endpoint` | Допоміжні засоби виявлення endpoint Z.AI |
- | `plugin-sdk/async-lock-runtime` | Допоміжний засіб локального для процесу async lock для невеликих файлів стану середовища виконання |
+ | `plugin-sdk/async-lock-runtime` | Допоміжний засіб локального для процесу асинхронного блокування для малих файлів стану середовища виконання |
| `plugin-sdk/channel-activity-runtime` | Допоміжний засіб телеметрії активності каналу |
- | `plugin-sdk/concurrency-runtime` | Допоміжний засіб обмеженої concurrency async-завдань |
- | `plugin-sdk/dedupe-runtime` | Допоміжні засоби in-memory dedupe-кешу |
- | `plugin-sdk/delivery-queue-runtime` | Допоміжний засіб drain для outbound pending-delivery |
- | `plugin-sdk/file-access-runtime` | Допоміжні засоби безпечних шляхів local-file і media-source |
- | `plugin-sdk/heartbeat-runtime` | Допоміжні засоби подій і видимості Heartbeat |
+ | `plugin-sdk/concurrency-runtime` | Допоміжний засіб обмеженої конкуренції асинхронних задач |
+ | `plugin-sdk/dedupe-runtime` | Допоміжні засоби кешу дедуплікації в пам'яті |
+ | `plugin-sdk/delivery-queue-runtime` | Допоміжний засіб спорожнення черги очікуваної вихідної доставки |
+ | `plugin-sdk/file-access-runtime` | Допоміжні засоби безпечних шляхів локальних файлів і джерел медіа |
+ | `plugin-sdk/heartbeat-runtime` | Допоміжні засоби подій Heartbeat і видимості |
| `plugin-sdk/number-runtime` | Допоміжний засіб числового приведення |
| `plugin-sdk/secure-random-runtime` | Допоміжні засоби безпечних токенів/UUID |
| `plugin-sdk/system-event-runtime` | Допоміжні засоби черги системних подій |
| `plugin-sdk/transport-ready-runtime` | Допоміжний засіб очікування готовності транспорту |
- | `plugin-sdk/infra-runtime` | Застарілий compatibility shim; використовуйте наведені вище спеціалізовані підшляхи середовища виконання |
- | `plugin-sdk/collection-runtime` | Допоміжні засоби невеликого обмеженого кешу |
- | `plugin-sdk/diagnostic-runtime` | Допоміжні засоби діагностичних flag, event і trace-context |
- | `plugin-sdk/error-runtime` | Допоміжні засоби графа помилок, форматування, спільної класифікації помилок, `isApprovalNotFoundError` |
- | `plugin-sdk/fetch-runtime` | Допоміжні засоби wrapped fetch, proxy і pinned lookup |
- | `plugin-sdk/runtime-fetch` | Runtime fetch з урахуванням dispatcher без імпортів proxy/guarded-fetch |
- | `plugin-sdk/response-limit-runtime` | Обмежений reader response-body без широкої media runtime surface |
- | `plugin-sdk/session-binding-runtime` | Поточний стан binding розмови без налаштованого binding routing або pairing stores |
- | `plugin-sdk/session-store-runtime` | Допоміжні засоби session-store без широких імпортів запису/обслуговування конфігурації |
- | `plugin-sdk/context-visibility-runtime` | Розв’язання видимості контексту та фільтрація додаткового контексту без широких імпортів конфігурації/безпеки |
- | `plugin-sdk/string-coerce-runtime` | Вузькі допоміжні засоби приведення й нормалізації примітивних записів/рядків без імпортів markdown/logging |
+ | `plugin-sdk/infra-runtime` | Застарілий shim сумісності; використовуйте наведені вище сфокусовані підшляхи середовища виконання |
+ | `plugin-sdk/collection-runtime` | Невеликі допоміжні засоби обмеженого кешу |
+ | `plugin-sdk/diagnostic-runtime` | Допоміжні засоби діагностичного прапорця, події та контексту трасування |
+ | `plugin-sdk/error-runtime` | Граф помилок, форматування, спільні допоміжні засоби класифікації помилок, `isApprovalNotFoundError` |
+ | `plugin-sdk/fetch-runtime` | Обгорнуті допоміжні засоби fetch, proxy та закріпленого пошуку |
+ | `plugin-sdk/runtime-fetch` | Fetch середовища виконання з урахуванням диспетчера без імпортів proxy/guarded-fetch |
+ | `plugin-sdk/response-limit-runtime` | Обмежений зчитувач тіла відповіді без широкої поверхні середовища виконання медіа |
+ | `plugin-sdk/session-binding-runtime` | Поточний стан прив'язування розмови без налаштованої маршрутизації прив'язок або сховищ спарювання |
+ | `plugin-sdk/session-store-runtime` | Допоміжні засоби сховища сеансів без широких імпортів записів/обслуговування конфігурації |
+ | `plugin-sdk/context-visibility-runtime` | Розв'язання видимості контексту та фільтрація додаткового контексту без широких імпортів конфігурації/безпеки |
+ | `plugin-sdk/string-coerce-runtime` | Вузькі допоміжні засоби приведення та нормалізації примітивних записів/рядків без імпортів markdown/журналювання |
| `plugin-sdk/host-runtime` | Допоміжні засоби нормалізації hostname і SCP host |
- | `plugin-sdk/retry-runtime` | Допоміжні засоби конфігурації retry та виконавця retry |
- | `plugin-sdk/agent-runtime` | Допоміжні засоби директорії/ідентичності/робочого простору агента |
- | `plugin-sdk/directory-runtime` | Запит/дедуп директорії на основі конфігурації |
+ | `plugin-sdk/retry-runtime` | Допоміжні засоби конфігурації повторних спроб і запуску повторних спроб |
+ | `plugin-sdk/agent-runtime` | Допоміжні засоби каталогу/ідентичності/робочого простору агента |
+ | `plugin-sdk/directory-runtime` | Запит/дедуплікація каталогу на основі конфігурації |
| `plugin-sdk/keyed-async-queue` | `KeyedAsyncQueue` |
- | Підшлях | Основні експорти |
+ | Підшлях | Ключові експорти |
| --- | --- |
- | `plugin-sdk/media-runtime` | Спільні помічники отримання/перетворення/зберігання медіа, а також конструктори медіа-навантажень |
- | `plugin-sdk/media-store` | Вузькі помічники сховища медіа, як-от `saveMediaBuffer` |
- | `plugin-sdk/media-generation-runtime` | Спільні помічники резервного перемикання для генерації медіа, вибір кандидатів і повідомлення про відсутню модель |
- | `plugin-sdk/media-understanding` | Типи провайдерів розуміння медіа, а також експорти помічників для зображень/аудіо, орієнтовані на провайдерів |
- | `plugin-sdk/text-runtime` | Спільні помічники для тексту/markdown/журналювання, як-от вилучення видимого для асистента тексту, помічники рендерингу/розбиття/таблиць markdown, помічники редагування, помічники тегів директив і утиліти безпечного тексту |
- | `plugin-sdk/text-chunking` | Помічник розбиття вихідного тексту |
- | `plugin-sdk/speech` | Типи мовних провайдерів, а також орієнтовані на провайдерів експорти директив, реєстру, валідації, OpenAI-сумісного конструктора TTS і мовних помічників |
- | `plugin-sdk/speech-core` | Спільні типи мовних провайдерів, експорти реєстру, директив, нормалізації та мовних помічників |
- | `plugin-sdk/realtime-transcription` | Типи провайдерів транскрипції в реальному часі, помічники реєстру та спільний помічник WebSocket-сеансу |
- | `plugin-sdk/realtime-voice` | Типи провайдерів голосу в реальному часі та помічники реєстру |
- | `plugin-sdk/image-generation` | Типи провайдерів генерації зображень, а також помічники ресурсів зображень/data URL і OpenAI-сумісний конструктор провайдера зображень |
- | `plugin-sdk/image-generation-core` | Спільні типи генерації зображень, резервне перемикання, автентифікація та помічники реєстру |
- | `plugin-sdk/music-generation` | Типи провайдерів/запитів/результатів генерації музики |
- | `plugin-sdk/music-generation-core` | Спільні типи генерації музики, помічники резервного перемикання, пошук провайдера та розбір посилань на модель |
- | `plugin-sdk/video-generation` | Типи провайдерів/запитів/результатів генерації відео |
- | `plugin-sdk/video-generation-core` | Спільні типи генерації відео, помічники резервного перемикання, пошук провайдера та розбір посилань на модель |
- | `plugin-sdk/webhook-targets` | Реєстр цілей Webhook і помічники встановлення маршрутів |
- | `plugin-sdk/webhook-path` | Помічники нормалізації шляху Webhook |
- | `plugin-sdk/web-media` | Спільні помічники завантаження віддалених/локальних медіа |
- | `plugin-sdk/zod` | Повторно експортований `zod` для споживачів plugin SDK |
- | `plugin-sdk/testing` | Широкий compatibility barrel для застарілих тестів plugin. Нові тести розширень натомість мають імпортувати сфокусовані підшляхи SDK, як-от `plugin-sdk/agent-runtime-test-contracts`, `plugin-sdk/plugin-test-runtime`, `plugin-sdk/channel-test-helpers`, `plugin-sdk/test-env` або `plugin-sdk/test-fixtures` |
- | `plugin-sdk/plugin-test-api` | Мінімальний помічник `createTestPluginApi` для unit-тестів прямої реєстрації plugin без імпорту мостів тестових помічників репозиторію |
- | `plugin-sdk/agent-runtime-test-contracts` | Нативні фікстури контрактів адаптера agent-runtime для тестів автентифікації, доставки, fallback, tool-hook, prompt-overlay, схеми та проєкції транскрипту |
- | `plugin-sdk/channel-test-helpers` | Орієнтовані на канал тестові помічники для загальних контрактів дій/налаштування/статусу, перевірок каталогів, життєвого циклу запуску облікового запису, потоків send-config, runtime-моків, проблем статусу, вихідної доставки та реєстрації хуків |
- | `plugin-sdk/channel-target-testing` | Спільний набір випадків помилок визначення цілі для тестів каналів |
- | `plugin-sdk/plugin-test-contracts` | Помічники контрактів пакета plugin, реєстрації, публічного артефакту, прямого імпорту, runtime API та побічних ефектів імпорту |
- | `plugin-sdk/provider-test-contracts` | Помічники контрактів runtime провайдера, автентифікації, виявлення, onboard, каталогу, майстра, медіа-можливостей, політики replay, live-audio realtime STT, web-search/fetch і потоків |
- | `plugin-sdk/provider-http-test-mocks` | Opt-in HTTP/auth моки Vitest для тестів провайдерів, які перевіряють `plugin-sdk/provider-http` |
- | `plugin-sdk/test-fixtures` | Загальні фікстури захоплення CLI runtime, контексту sandbox, записувача skill, agent-message, system-event, перезавантаження модуля, шляху bundled plugin, terminal-text, розбиття, auth-token і типізованих випадків |
- | `plugin-sdk/test-node-mocks` | Сфокусовані помічники моків вбудованих модулів Node для використання всередині фабрик Vitest `vi.mock("node:*")` |
+ | `plugin-sdk/media-runtime` | Спільні допоміжні засоби для отримання, перетворення та зберігання медіа, а також конструктори медіанавантажень |
+ | `plugin-sdk/media-store` | Вузькі допоміжні засоби сховища медіа, як-от `saveMediaBuffer` |
+ | `plugin-sdk/media-generation-runtime` | Спільні допоміжні засоби резервного перемикання для генерації медіа, вибір кандидатів і повідомлення про відсутні моделі |
+ | `plugin-sdk/media-understanding` | Типи провайдера розуміння медіа, а також експорти допоміжних засобів для зображень/аудіо, призначені для провайдерів |
+ | `plugin-sdk/text-runtime` | Спільні допоміжні засоби для тексту/markdown/журналювання, як-от видалення тексту, видимого асистенту, допоміжні засоби рендерингу/фрагментації/таблиць markdown, допоміжні засоби редагування, допоміжні засоби тегів директив і утиліти безпечного тексту |
+ | `plugin-sdk/text-chunking` | Допоміжний засіб фрагментації вихідного тексту |
+ | `plugin-sdk/speech` | Типи провайдера мовлення, а також експорти директив, реєстру, валідації, OpenAI-сумісного конструктора TTS і допоміжних засобів мовлення, призначені для провайдерів |
+ | `plugin-sdk/speech-core` | Спільні типи провайдера мовлення, реєстр, директива, нормалізація та експорти допоміжних засобів мовлення |
+ | `plugin-sdk/realtime-transcription` | Типи провайдера транскрипції в реальному часі, допоміжні засоби реєстру та спільний допоміжний засіб сеансу WebSocket |
+ | `plugin-sdk/realtime-voice` | Типи провайдера голосу в реальному часі та допоміжні засоби реєстру |
+ | `plugin-sdk/image-generation` | Типи провайдера генерації зображень, а також допоміжні засоби для ресурсів зображень/data URL і OpenAI-сумісний конструктор провайдера зображень |
+ | `plugin-sdk/image-generation-core` | Спільні типи генерації зображень, резервне перемикання, автентифікація та допоміжні засоби реєстру |
+ | `plugin-sdk/music-generation` | Типи провайдера/запиту/результату генерації музики |
+ | `plugin-sdk/music-generation-core` | Спільні типи генерації музики, допоміжні засоби резервного перемикання, пошук провайдера та розбір посилань на моделі |
+ | `plugin-sdk/video-generation` | Типи провайдера/запиту/результату генерації відео |
+ | `plugin-sdk/video-generation-core` | Спільні типи генерації відео, допоміжні засоби резервного перемикання, пошук провайдера та розбір посилань на моделі |
+ | `plugin-sdk/webhook-targets` | Реєстр цілей Webhook і допоміжні засоби встановлення маршрутів |
+ | `plugin-sdk/webhook-path` | Допоміжні засоби нормалізації шляху Webhook |
+ | `plugin-sdk/web-media` | Спільні допоміжні засоби завантаження віддалених/локальних медіа |
+ | `plugin-sdk/zod` | Повторно експортований `zod` для споживачів SDK плагінів |
+ | `plugin-sdk/testing` | Широкий barrel сумісності для застарілих тестів плагінів. Нові тести розширень мають натомість імпортувати сфокусовані підшляхи SDK, як-от `plugin-sdk/agent-runtime-test-contracts`, `plugin-sdk/plugin-test-runtime`, `plugin-sdk/channel-test-helpers`, `plugin-sdk/test-env` або `plugin-sdk/test-fixtures` |
+ | `plugin-sdk/plugin-test-api` | Мінімальний допоміжний засіб `createTestPluginApi` для прямих модульних тестів реєстрації плагінів без імпорту мостів допоміжних засобів тестування репозиторію |
+ | `plugin-sdk/agent-runtime-test-contracts` | Нативні фікстури контрактів адаптера середовища виконання агента для тестів автентифікації, доставлення, fallback, tool-hook, prompt-overlay, схеми та проєкції транскрипту |
+ | `plugin-sdk/channel-test-helpers` | Орієнтовані на канали допоміжні засоби тестування для загальних контрактів дій/налаштування/статусу, перевірок каталогів, життєвого циклу запуску облікового запису, потоків конфігурації надсилання, моків середовища виконання, проблем статусу, вихідного доставлення та реєстрації хуків |
+ | `plugin-sdk/channel-target-testing` | Спільний набір тестів випадків помилок розв’язання цілі для тестів каналів |
+ | `plugin-sdk/plugin-test-contracts` | Допоміжні засоби контрактів пакета плагіна, реєстрації, публічного артефакту, прямого імпорту, API середовища виконання та побічних ефектів імпорту |
+ | `plugin-sdk/provider-test-contracts` | Допоміжні засоби контрактів середовища виконання провайдера, автентифікації, виявлення, onboarding, каталогу, майстра, медіаможливостей, політики replay, живого аудіо STT у реальному часі, вебпошуку/отримання та stream |
+ | `plugin-sdk/provider-http-test-mocks` | Необов’язкові HTTP/автентифікаційні моки Vitest для тестів провайдерів, які перевіряють `plugin-sdk/provider-http` |
+ | `plugin-sdk/test-fixtures` | Загальні фікстури захоплення середовища виконання CLI, контексту пісочниці, записувача Skills, повідомлення агента, системної події, перезавантаження модуля, шляху вбудованого плагіна, термінального тексту, фрагментації, токена автентифікації та типізованих випадків |
+ | `plugin-sdk/test-node-mocks` | Сфокусовані допоміжні засоби моків вбудованих модулів Node для використання всередині фабрик Vitest `vi.mock("node:*")` |
- | Підшлях | Основні експорти |
+ | Підшлях | Ключові експорти |
| --- | --- |
- | `plugin-sdk/memory-core` | Поверхня bundled memory-core помічників для помічників manager/config/file/CLI |
- | `plugin-sdk/memory-core-engine-runtime` | Runtime-фасад індексу/пошуку пам’яті |
- | `plugin-sdk/memory-core-host-engine-foundation` | Експорти рушія foundation хоста пам’яті |
- | `plugin-sdk/memory-core-host-engine-embeddings` | Контракти embedding хоста пам’яті, доступ до реєстру, локальний провайдер і загальні batch/remote помічники |
+ | `plugin-sdk/memory-core` | Вбудована поверхня допоміжних засобів memory-core для допоміжних засобів менеджера/конфігурації/файлів/CLI |
+ | `plugin-sdk/memory-core-engine-runtime` | Фасад середовища виконання індексу/пошуку пам’яті |
+ | `plugin-sdk/memory-core-host-engine-foundation` | Експорти рушія основи хоста пам’яті |
+ | `plugin-sdk/memory-core-host-engine-embeddings` | Контракти embedding хоста пам’яті, доступ до реєстру, локальний провайдер і загальні допоміжні засоби пакетної/віддаленої обробки |
| `plugin-sdk/memory-core-host-engine-qmd` | Експорти рушія QMD хоста пам’яті |
| `plugin-sdk/memory-core-host-engine-storage` | Експорти рушія сховища хоста пам’яті |
- | `plugin-sdk/memory-core-host-multimodal` | Мультимодальні помічники хоста пам’яті |
- | `plugin-sdk/memory-core-host-query` | Помічники запитів хоста пам’яті |
- | `plugin-sdk/memory-core-host-secret` | Помічники секретів хоста пам’яті |
- | `plugin-sdk/memory-core-host-events` | Помічники журналу подій хоста пам’яті |
- | `plugin-sdk/memory-core-host-status` | Помічники статусу хоста пам’яті |
- | `plugin-sdk/memory-core-host-runtime-cli` | Помічники CLI runtime хоста пам’яті |
- | `plugin-sdk/memory-core-host-runtime-core` | Помічники core runtime хоста пам’яті |
- | `plugin-sdk/memory-core-host-runtime-files` | Помічники файлів/runtime хоста пам’яті |
- | `plugin-sdk/memory-host-core` | Нейтральний щодо постачальника псевдонім для core runtime помічників хоста пам’яті |
- | `plugin-sdk/memory-host-events` | Нейтральний щодо постачальника псевдонім для помічників журналу подій хоста пам’яті |
- | `plugin-sdk/memory-host-files` | Нейтральний щодо постачальника псевдонім для помічників файлів/runtime хоста пам’яті |
- | `plugin-sdk/memory-host-markdown` | Спільні помічники managed-markdown для plugins, суміжних із пам’яттю |
- | `plugin-sdk/memory-host-search` | Runtime-фасад Active Memory для доступу до search-manager |
- | `plugin-sdk/memory-host-status` | Нейтральний щодо постачальника псевдонім для помічників статусу хоста пам’яті |
+ | `plugin-sdk/memory-core-host-multimodal` | Допоміжні засоби мультимодальності хоста пам’яті |
+ | `plugin-sdk/memory-core-host-query` | Допоміжні засоби запитів хоста пам’яті |
+ | `plugin-sdk/memory-core-host-secret` | Допоміжні засоби секретів хоста пам’яті |
+ | `plugin-sdk/memory-core-host-events` | Допоміжні засоби журналу подій хоста пам’яті |
+ | `plugin-sdk/memory-core-host-status` | Допоміжні засоби статусу хоста пам’яті |
+ | `plugin-sdk/memory-core-host-runtime-cli` | Допоміжні засоби середовища виконання CLI хоста пам’яті |
+ | `plugin-sdk/memory-core-host-runtime-core` | Допоміжні засоби основного середовища виконання хоста пам’яті |
+ | `plugin-sdk/memory-core-host-runtime-files` | Допоміжні засоби файлів/середовища виконання хоста пам’яті |
+ | `plugin-sdk/memory-host-core` | Нейтральний щодо постачальника псевдонім для допоміжних засобів основного середовища виконання хоста пам’яті |
+ | `plugin-sdk/memory-host-events` | Нейтральний щодо постачальника псевдонім для допоміжних засобів журналу подій хоста пам’яті |
+ | `plugin-sdk/memory-host-files` | Нейтральний щодо постачальника псевдонім для допоміжних засобів файлів/середовища виконання хоста пам’яті |
+ | `plugin-sdk/memory-host-markdown` | Спільні допоміжні засоби керованого markdown для плагінів, суміжних із пам’яттю |
+ | `plugin-sdk/memory-host-search` | Фасад середовища виконання Active Memory для доступу до менеджера пошуку |
+ | `plugin-sdk/memory-host-status` | Нейтральний щодо постачальника псевдонім для допоміжних засобів статусу хоста пам’яті |
-
- Наразі немає зарезервованих підшляхів SDK bundled-helper. Власницькі
- помічники живуть у пакеті plugin власника, а повторно використовувані контракти хоста
+
+ Наразі немає зарезервованих підшляхів SDK для вбудованих допоміжних засобів. Допоміжні засоби, специфічні для власника,
+ розміщуються всередині пакета плагіна-власника, тоді як повторно використовувані контракти хоста
використовують загальні підшляхи SDK, як-от `plugin-sdk/gateway-runtime`,
`plugin-sdk/security-runtime` і `plugin-sdk/plugin-config-runtime`.
@@ -331,6 +332,6 @@ x-i18n:
## Пов’язане
-- [Огляд Plugin SDK](/uk/plugins/sdk-overview)
-- [Налаштування Plugin SDK](/uk/plugins/sdk-setup)
-- [Створення plugins](/uk/plugins/building-plugins)
+- [Огляд SDK плагінів](/uk/plugins/sdk-overview)
+- [Налаштування SDK плагінів](/uk/plugins/sdk-setup)
+- [Створення плагінів](/uk/plugins/building-plugins)