diff --git a/docs/uk/plugins/sdk-migration.md b/docs/uk/plugins/sdk-migration.md
index 1019dc2a7..e371a6055 100644
--- a/docs/uk/plugins/sdk-migration.md
+++ b/docs/uk/plugins/sdk-migration.md
@@ -2,81 +2,81 @@
read_when:
- Ви бачите попередження OPENCLAW_PLUGIN_SDK_COMPAT_DEPRECATED
- Ви бачите попередження OPENCLAW_EXTENSION_API_DEPRECATED
- - Ви оновлюєте плагін до сучасної архітектури плагінів OpenClaw
- - Ви підтримуєте зовнішній плагін OpenClaw
+ - Ви оновлюєте plugin до сучасної архітектури plugin
+ - Ви підтримуєте зовнішній plugin OpenClaw
sidebarTitle: Migrate to SDK
-summary: Перехід із застарілого шару зворотної сумісності на сучасний Plugin SDK
+summary: Перейдіть із застарілого шару зворотної сумісності на сучасний plugin SDK
title: Міграція Plugin SDK
x-i18n:
- generated_at: "2026-04-06T15:30:56Z"
+ generated_at: "2026-04-06T22:33:54Z"
model: gpt-5.4
provider: openai
- source_hash: 770eca214dcd7c7c22ee507d4bb4359b505a29c9ecd4458f7b5e1362c5cd0d6e
+ source_hash: 3691060e9dc00ca8bee49240a047f0479398691bd14fb96e9204cc9243fdb32c
source_path: plugins/sdk-migration.md
workflow: 15
---
# Міграція Plugin SDK
-OpenClaw перейшов від широкого шару зворотної сумісності до сучасної
-архітектури плагінів із точковими, задокументованими імпортами. Якщо ваш плагін
-було створено до появи нової архітектури, цей посібник допоможе вам виконати міграцію.
+OpenClaw перейшов від широкого шару зворотної сумісності до сучасної архітектури
+plugin із цільовими, задокументованими імпортами. Якщо ваш plugin було створено
+до появи нової архітектури, цей посібник допоможе вам виконати міграцію.
## Що змінюється
-Стара система плагінів надавала дві дуже широкі поверхні, які дозволяли плагінам імпортувати
-все необхідне з однієї точки входу:
+Стара система plugin надавала дві дуже широкі поверхні, які дозволяли plugin
+імпортувати все, що їм потрібно, з однієї точки входу:
-- **`openclaw/plugin-sdk/compat`** — єдиний імпорт, який повторно експортував десятки
- допоміжних функцій. Його було запроваджено, щоб старі плагіни на основі hooks продовжували працювати,
- поки будувалася нова архітектура плагінів.
-- **`openclaw/extension-api`** — міст, який надавав плагінам прямий доступ до
- допоміжних засобів на боці хоста, таких як вбудований виконавець агента.
+- **`openclaw/plugin-sdk/compat`** — єдиний імпорт, який повторно експортував
+ десятки допоміжних засобів. Його було запроваджено, щоб старіші plugin на
+ основі hooks продовжували працювати, поки будувалася нова архітектура plugin.
+- **`openclaw/extension-api`** — міст, який надавав plugin прямий доступ до
+ допоміжних засобів на боці хоста, таких як вбудований runner агента.
-Обидві поверхні тепер **застарілі**. Вони все ще працюють під час runtime, але нові
-плагіни не повинні їх використовувати, а наявні плагіни слід перенести до того, як наступний
-мажорний реліз їх прибере.
+Обидві поверхні тепер **застарілі**. Вони все ще працюють під час виконання,
+але нові plugin не повинні їх використовувати, а наявні plugin мають виконати
+міграцію до того, як наступний мажорний реліз їх видалить.
- Шар зворотної сумісності буде вилучено в одному з майбутніх мажорних релізів.
- Плагіни, які все ще імпортують із цих поверхонь, перестануть працювати, коли це станеться.
+ Шар зворотної сумісності буде видалено в одному з майбутніх мажорних релізів.
+ Plugins, які все ще імпортують із цих поверхонь, перестануть працювати, коли це станеться.
## Чому це змінилося
Старий підхід створював проблеми:
-- **Повільний запуск** — імпорт однієї допоміжної функції завантажував десятки не пов’язаних модулів
+- **Повільний запуск** — імпорт одного допоміжного засобу завантажував десятки не пов’язаних між собою модулів
- **Циклічні залежності** — широкі повторні експорти спрощували створення циклів імпорту
-- **Нечітка поверхня API** — не було способу зрозуміти, які експорти є стабільними, а які внутрішніми
+- **Нечітка поверхня API** — не було способу визначити, які експорти були стабільними, а які внутрішніми
-Сучасний Plugin SDK це виправляє: кожен шлях імпорту (`openclaw/plugin-sdk/\`)
-є невеликим самодостатнім модулем із чітким призначенням і задокументованим контрактом.
+Сучасний plugin SDK виправляє це: кожен шлях імпорту (`openclaw/plugin-sdk/\`)
+є невеликим, самодостатнім модулем із чітким призначенням і задокументованим контрактом.
Застарілі зручні seams провайдерів для вбудованих каналів також зникли. Імпорти
на кшталт `openclaw/plugin-sdk/slack`, `openclaw/plugin-sdk/discord`,
`openclaw/plugin-sdk/signal`, `openclaw/plugin-sdk/whatsapp`,
-канальні допоміжні seams із брендовими назвами та
+допоміжні seams із брендуванням каналів і
`openclaw/plugin-sdk/telegram-core` були приватними скороченнями mono-repo, а не
-стабільними контрактами плагінів. Натомість використовуйте вузькі загальні subpath Plugin SDK. Усередині
-workspace вбудованих плагінів зберігайте допоміжні засоби, що належать провайдеру, у власних
-`api.ts` або `runtime-api.ts` цього плагіна.
+стабільними контрактами plugin. Натомість використовуйте вузькі узагальнені SDK subpaths. Усередині
+робочого простору вбудованих plugin зберігайте допоміжні засоби, що належать провайдеру, у власних
+`api.ts` або `runtime-api.ts` цього plugin.
Поточні приклади вбудованих провайдерів:
- Anthropic зберігає допоміжні засоби потоків, специфічні для Claude, у власному seam `api.ts` /
`contract-api.ts`
-- OpenAI зберігає builder-и провайдерів, допоміжні засоби типових моделей і builder-и realtime-провайдерів
+- OpenAI зберігає конструктори провайдерів, допоміжні засоби моделей за замовчуванням і конструктори realtime-провайдерів
у власному `api.ts`
-- OpenRouter зберігає builder провайдера та допоміжні засоби onboarding/config у власному
+- OpenRouter зберігає конструктор провайдера та допоміжні засоби онбордингу/конфігурації у власному
`api.ts`
## Як виконати міграцію
-
- Якщо ваш плагін використовує `openclaw/plugin-sdk/windows-spawn`, нерозв’язані Windows
- wrapper-и `.cmd`/`.bat` тепер аварійно завершуються із закритою помилкою, якщо ви явно не передасте
+
+ Якщо ваш plugin використовує `openclaw/plugin-sdk/windows-spawn`, нерозв’язані Windows
+ wrappers `.cmd`/`.bat` тепер аварійно завершуються в закритому режимі, якщо ви явно не передасте
`allowShellFallback: true`.
```typescript
@@ -92,13 +92,13 @@ workspace вбудованих плагінів зберігайте допом
});
```
- Якщо ваш викликаючий код навмисно не покладається на shell fallback, не задавайте
+ Якщо ваш виклик не покладається навмисно на резервний shell-механізм, не встановлюйте
`allowShellFallback`, а натомість обробляйте викинуту помилку.
- Знайдіть у своєму плагіні імпорти з будь-якої із застарілих поверхонь:
+ Знайдіть у своєму plugin імпорти з будь-якої із застарілих поверхонь:
```bash
grep -r "plugin-sdk/compat" my-plugin/
@@ -107,7 +107,7 @@ workspace вбудованих плагінів зберігайте допом
-
+
Кожен експорт зі старої поверхні відповідає конкретному сучасному шляху імпорту:
```typescript
@@ -124,7 +124,7 @@ workspace вбудованих плагінів зберігайте допом
import { resolveControlCommandGate } from "openclaw/plugin-sdk/command-auth";
```
- Для допоміжних засобів на боці хоста використовуйте вбудований runtime плагіна замість
+ Для допоміжних засобів на боці хоста використовуйте введений runtime plugin замість
прямого імпорту:
```typescript
@@ -136,7 +136,7 @@ workspace вбудованих плагінів зберігайте допом
const result = await api.runtime.agent.runEmbeddedPiAgent({ sessionId, prompt });
```
- Той самий шаблон застосовується й до інших допоміжних засобів застарілого bridge:
+ Той самий шаблон застосовується й до інших застарілих допоміжних засобів моста:
| Старий імпорт | Сучасний еквівалент |
| --- | --- |
@@ -146,7 +146,7 @@ workspace вбудованих плагінів зберігайте допом
| `resolveThinkingDefault` | `api.runtime.agent.resolveThinkingDefault` |
| `resolveAgentTimeoutMs` | `api.runtime.agent.resolveAgentTimeoutMs` |
| `ensureAgentWorkspace` | `api.runtime.agent.ensureAgentWorkspace` |
- | допоміжні засоби сховища сесій | `api.runtime.agent.session.*` |
+ | session store helpers | `api.runtime.agent.session.*` |
@@ -163,173 +163,174 @@ workspace вбудованих плагінів зберігайте допом
| Шлях імпорту | Призначення | Ключові експорти |
| --- | --- | --- |
- | `plugin-sdk/plugin-entry` | Канонічна допоміжна функція точки входу плагіна | `definePluginEntry` |
- | `plugin-sdk/core` | Застарілий umbrella-повторний експорт для визначень/builders точок входу каналів | `defineChannelPluginEntry`, `createChatChannelPlugin` |
+ | `plugin-sdk/plugin-entry` | Канонічний допоміжний засіб точки входу plugin | `definePluginEntry` |
+ | `plugin-sdk/core` | Застарілий umbrella-повторний експорт для визначень/конструкторів входу каналу | `defineChannelPluginEntry`, `createChatChannelPlugin` |
| `plugin-sdk/config-schema` | Експорт кореневої схеми конфігурації | `OpenClawSchema` |
- | `plugin-sdk/provider-entry` | Допоміжна функція точки входу для одного провайдера | `defineSingleProviderPluginEntry` |
- | `plugin-sdk/channel-core` | Точкові визначення та builder-и точок входу каналів | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` |
- | `plugin-sdk/setup` | Спільні допоміжні засоби майстра налаштування | Запити allowlist, builder-и стану налаштування |
- | `plugin-sdk/setup-runtime` | Допоміжні засоби runtime для етапу налаштування | Безпечні для імпорту setup patch adapters, допоміжні засоби lookup-note, `promptResolvedAllowFrom`, `splitSetupEntries`, delegated setup proxies |
- | `plugin-sdk/setup-adapter-runtime` | Допоміжні засоби setup adapter | `createEnvPatchedAccountSetupAdapter` |
+ | `plugin-sdk/provider-entry` | Допоміжний засіб точки входу для одного провайдера | `defineSingleProviderPluginEntry` |
+ | `plugin-sdk/channel-core` | Цільові визначення та конструктори входу каналу | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` |
+ | `plugin-sdk/setup` | Спільні допоміжні засоби майстра налаштування | Підказки allowlist, конструктори статусу налаштування |
+ | `plugin-sdk/setup-runtime` | Допоміжні засоби runtime для налаштування | Безпечні для імпорту patch-адаптери налаштування, допоміжні засоби приміток пошуку, `promptResolvedAllowFrom`, `splitSetupEntries`, делеговані проксі налаштування |
+ | `plugin-sdk/setup-adapter-runtime` | Допоміжні засоби адаптера налаштування | `createEnvPatchedAccountSetupAdapter` |
| `plugin-sdk/setup-tools` | Допоміжні засоби інструментів налаштування | `formatCliCommand`, `detectBinary`, `extractArchive`, `resolveBrewExecutable`, `formatDocsLink`, `CONFIG_DIR` |
- | `plugin-sdk/account-core` | Допоміжні засоби для кількох облікових записів | Допоміжні засоби списку/config/action-gate облікових записів |
+ | `plugin-sdk/account-core` | Допоміжні засоби для кількох облікових записів | Допоміжні засоби списку облікових записів/конфігурації/гейтів дій |
| `plugin-sdk/account-id` | Допоміжні засоби account-id | `DEFAULT_ACCOUNT_ID`, нормалізація account-id |
- | `plugin-sdk/account-resolution` | Допоміжні засоби пошуку облікового запису | Допоміжні засоби пошуку облікового запису + fallback до типового |
- | `plugin-sdk/account-helpers` | Вузькі допоміжні засоби для облікових записів | Допоміжні засоби списку облікових записів / дій з обліковими записами |
- | `plugin-sdk/channel-setup` | Adapters майстра налаштування | `createOptionalChannelSetupSurface`, `createOptionalChannelSetupAdapter`, `createOptionalChannelSetupWizard`, а також `DEFAULT_ACCOUNT_ID`, `createTopLevelChannelDmPolicy`, `setSetupChannelEnabled`, `splitSetupEntries` |
- | `plugin-sdk/channel-pairing` | Примітиви pairing для DM | `createChannelPairingController` |
- | `plugin-sdk/channel-reply-pipeline` | Налаштування префікса reply + typing | `createChannelReplyPipeline` |
- | `plugin-sdk/channel-config-helpers` | Factory для adapters конфігурації | `createHybridChannelConfigAdapter` |
- | `plugin-sdk/channel-config-schema` | Builder-и схем конфігурації | Типи схем конфігурації каналу |
+ | `plugin-sdk/account-resolution` | Допоміжні засоби пошуку облікового запису | Допоміжні засоби пошуку облікового запису + fallback до значення за замовчуванням |
+ | `plugin-sdk/account-helpers` | Вузькі допоміжні засоби облікового запису | Допоміжні засоби списку облікових записів/дій з обліковими записами |
+ | `plugin-sdk/channel-setup` | Адаптери майстра налаштування | `createOptionalChannelSetupSurface`, `createOptionalChannelSetupAdapter`, `createOptionalChannelSetupWizard`, а також `DEFAULT_ACCOUNT_ID`, `createTopLevelChannelDmPolicy`, `setSetupChannelEnabled`, `splitSetupEntries` |
+ | `plugin-sdk/channel-pairing` | Примітиви DM pairing | `createChannelPairingController` |
+ | `plugin-sdk/channel-reply-pipeline` | Підключення префікса відповіді + typing | `createChannelReplyPipeline` |
+ | `plugin-sdk/channel-config-helpers` | Фабрики адаптерів конфігурації | `createHybridChannelConfigAdapter` |
+ | `plugin-sdk/channel-config-schema` | Конструктори схем конфігурації | Типи схем конфігурації каналу |
| `plugin-sdk/telegram-command-config` | Допоміжні засоби конфігурації команд Telegram | Нормалізація назв команд, обрізання опису, перевірка дублікатів/конфліктів |
- | `plugin-sdk/channel-policy` | Розв’язання політик для груп/DM | `resolveChannelGroupRequireMention` |
- | `plugin-sdk/channel-lifecycle` | Відстеження стану облікового запису | `createAccountStatusSink` |
- | `plugin-sdk/inbound-envelope` | Допоміжні засоби inbound envelope | Спільні допоміжні засоби побудови route + envelope |
- | `plugin-sdk/inbound-reply-dispatch` | Допоміжні засоби inbound reply | Спільні допоміжні засоби record-and-dispatch |
+ | `plugin-sdk/channel-policy` | Визначення політики груп/DM | `resolveChannelGroupRequireMention` |
+ | `plugin-sdk/channel-lifecycle` | Відстеження статусу облікового запису | `createAccountStatusSink` |
+ | `plugin-sdk/inbound-envelope` | Допоміжні засоби вхідного envelope | Спільні допоміжні засоби побудови route + envelope |
+ | `plugin-sdk/inbound-reply-dispatch` | Допоміжні засоби вхідної відповіді | Спільні допоміжні засоби record-and-dispatch |
| `plugin-sdk/messaging-targets` | Розбір цілей повідомлень | Допоміжні засоби розбору/зіставлення цілей |
- | `plugin-sdk/outbound-media` | Допоміжні засоби outbound media | Спільне завантаження outbound media |
+ | `plugin-sdk/outbound-media` | Допоміжні засоби вихідного медіа | Спільне завантаження вихідного медіа |
| `plugin-sdk/outbound-runtime` | Допоміжні засоби outbound runtime | Допоміжні засоби outbound identity/send delegate |
- | `plugin-sdk/thread-bindings-runtime` | Допоміжні засоби thread-binding | Допоміжні засоби життєвого циклу та adapters thread-binding |
- | `plugin-sdk/agent-media-payload` | Застарілі допоміжні засоби media payload | Builder payload медіа агента для застарілих layout полів |
+ | `plugin-sdk/thread-bindings-runtime` | Допоміжні засоби thread-binding | Життєвий цикл thread-binding і допоміжні засоби адаптера |
+ | `plugin-sdk/agent-media-payload` | Застарілі допоміжні засоби media payload | Конструктор agent media payload для застарілих схем полів |
| `plugin-sdk/channel-runtime` | Застарілий shim сумісності | Лише застарілі утиліти channel runtime |
- | `plugin-sdk/channel-send-result` | Типи результатів надсилання | Типи результатів reply |
- | `plugin-sdk/runtime-store` | Постійне сховище плагіна | `createPluginRuntimeStore` |
- | `plugin-sdk/runtime` | Широкі допоміжні засоби runtime | Допоміжні засоби runtime/logging/backup/plugin-install |
- | `plugin-sdk/runtime-env` | Вузькі допоміжні засоби середовища runtime | Logger/runtime env, timeout, retry та backoff helpers |
- | `plugin-sdk/plugin-runtime` | Спільні допоміжні засоби runtime плагінів | Допоміжні засоби commands/hooks/http/interactive для плагінів |
- | `plugin-sdk/hook-runtime` | Допоміжні засоби конвеєра hooks | Спільні допоміжні засоби конвеєра webhook/internal hook |
+ | `plugin-sdk/channel-send-result` | Типи результатів надсилання | Типи результатів відповіді |
+ | `plugin-sdk/runtime-store` | Постійне сховище plugin | `createPluginRuntimeStore` |
+ | `plugin-sdk/runtime` | Широкі допоміжні засоби runtime | Допоміжні засоби runtime/logging/backup/install plugin |
+ | `plugin-sdk/runtime-env` | Вузькі допоміжні засоби середовища runtime | Logger/runtime env, допоміжні засоби timeout, retry і backoff |
+ | `plugin-sdk/plugin-runtime` | Спільні допоміжні засоби plugin runtime | Допоміжні засоби команд/hooks/http/interactive для plugin |
+ | `plugin-sdk/hook-runtime` | Допоміжні засоби pipeline hooks | Спільні допоміжні засоби pipeline webhook/internal hook |
| `plugin-sdk/lazy-runtime` | Допоміжні засоби lazy runtime | `createLazyRuntimeModule`, `createLazyRuntimeMethod`, `createLazyRuntimeMethodBinder`, `createLazyRuntimeNamedExport`, `createLazyRuntimeSurface` |
- | `plugin-sdk/process-runtime` | Допоміжні засоби process | Спільні допоміжні засоби exec |
+ | `plugin-sdk/process-runtime` | Допоміжні засоби процесів | Спільні допоміжні засоби exec |
| `plugin-sdk/cli-runtime` | Допоміжні засоби CLI runtime | Форматування команд, очікування, допоміжні засоби версій |
- | `plugin-sdk/gateway-runtime` | Допоміжні засоби gateway | Клієнт gateway і допоміжні засоби patch status каналів |
+ | `plugin-sdk/gateway-runtime` | Допоміжні засоби gateway | Gateway client і допоміжні засоби patch статусу каналу |
| `plugin-sdk/config-runtime` | Допоміжні засоби конфігурації | Допоміжні засоби завантаження/запису конфігурації |
| `plugin-sdk/telegram-command-config` | Допоміжні засоби команд Telegram | Допоміжні засоби перевірки команд Telegram зі стабільним fallback, коли поверхня контракту вбудованого Telegram недоступна |
- | `plugin-sdk/approval-runtime` | Допоміжні засоби prompts погодження | Payload погодження exec/plugin, допоміжні засоби capability/profile погодження, native routing/runtime погодження |
- | `plugin-sdk/approval-auth-runtime` | Допоміжні засоби auth погодження | Розв’язання approver, auth дій у тому самому чаті |
- | `plugin-sdk/approval-client-runtime` | Допоміжні засоби клієнта погодження | Native helpers профілю/фільтра погодження exec |
- | `plugin-sdk/approval-delivery-runtime` | Допоміжні засоби delivery погодження | Native adapters capability/delivery погодження |
- | `plugin-sdk/approval-native-runtime` | Допоміжні засоби цілей погодження | Native helpers binding цілей/облікових записів погодження |
- | `plugin-sdk/approval-reply-runtime` | Допоміжні засоби reply погодження | Helpers payload reply для погодження exec/plugin |
- | `plugin-sdk/security-runtime` | Допоміжні засоби безпеки | Спільні helpers довіри, DM gating, external-content та збирання секретів |
- | `plugin-sdk/ssrf-policy` | Допоміжні засоби політики SSRF | Helpers allowlist хостів і політики приватної мережі |
- | `plugin-sdk/ssrf-runtime` | Допоміжні засоби SSRF runtime | Pinned-dispatcher, guarded fetch, helpers політики SSRF |
+ | `plugin-sdk/approval-runtime` | Допоміжні засоби prompt для approval | Payload approval exec/plugin, допоміжні засоби можливостей/профілю approval, маршрутизація/runtime native approval |
+ | `plugin-sdk/approval-auth-runtime` | Допоміжні засоби auth для approval | Визначення approver, auth дій у тому самому чаті |
+ | `plugin-sdk/approval-client-runtime` | Допоміжні засоби approval client | Допоміжні засоби профілю/фільтра native approval exec |
+ | `plugin-sdk/approval-delivery-runtime` | Допоміжні засоби доставки approval | Адаптери можливостей/доставки native approval |
+ | `plugin-sdk/approval-native-runtime` | Допоміжні засоби цілей approval | Допоміжні засоби прив’язки цілі/облікового запису native approval |
+ | `plugin-sdk/approval-reply-runtime` | Допоміжні засоби відповіді approval | Допоміжні засоби payload відповіді approval exec/plugin |
+ | `plugin-sdk/security-runtime` | Допоміжні засоби безпеки | Спільні допоміжні засоби trust, DM gating, external-content і збору секретів |
+ | `plugin-sdk/ssrf-policy` | Допоміжні засоби політики SSRF | Допоміжні засоби allowlist хостів і політики приватної мережі |
+ | `plugin-sdk/ssrf-runtime` | Допоміжні засоби SSRF runtime | Допоміжні засоби pinned-dispatcher, guarded fetch, SSRF policy |
| `plugin-sdk/collection-runtime` | Допоміжні засоби обмеженого кешу | `pruneMapToMaxSize` |
- | `plugin-sdk/diagnostic-runtime` | Допоміжні засоби керування діагностикою | `isDiagnosticFlagEnabled`, `isDiagnosticsEnabled` |
- | `plugin-sdk/error-runtime` | Допоміжні засоби форматування помилок | `formatUncaughtError`, `isApprovalNotFoundError`, helpers графа помилок |
- | `plugin-sdk/fetch-runtime` | Допоміжні засоби обгорнутого fetch/proxy | `resolveFetch`, proxy helpers |
+ | `plugin-sdk/diagnostic-runtime` | Допоміжні засоби diagnostic gating | `isDiagnosticFlagEnabled`, `isDiagnosticsEnabled` |
+ | `plugin-sdk/error-runtime` | Допоміжні засоби форматування помилок | `formatUncaughtError`, `isApprovalNotFoundError`, допоміжні засоби графа помилок |
+ | `plugin-sdk/fetch-runtime` | Допоміжні засоби обгорнутого fetch/proxy | `resolveFetch`, допоміжні засоби proxy |
| `plugin-sdk/host-runtime` | Допоміжні засоби нормалізації хоста | `normalizeHostname`, `normalizeScpRemoteHost` |
- | `plugin-sdk/retry-runtime` | Допоміжні засоби retry | `RetryConfig`, `retryAsync`, виконувачі policy |
+ | `plugin-sdk/retry-runtime` | Допоміжні засоби retry | `RetryConfig`, `retryAsync`, виконавці policy |
| `plugin-sdk/allow-from` | Форматування allowlist | `formatAllowFromLowercase` |
- | `plugin-sdk/allowlist-resolution` | Відображення входів allowlist | `mapAllowlistResolutionInputs` |
- | `plugin-sdk/command-auth` | Керування доступом до команд і допоміжні засоби поверхні команд | `resolveControlCommandGate`, допоміжні засоби авторизації відправника, helpers реєстру команд |
- | `plugin-sdk/secret-input` | Розбір secret input | Допоміжні засоби secret input |
+ | `plugin-sdk/allowlist-resolution` | Зіставлення вводу allowlist | `mapAllowlistResolutionInputs` |
+ | `plugin-sdk/command-auth` | Допоміжні засоби gating команд і поверхні команд | `resolveControlCommandGate`, допоміжні засоби авторизації відправника, допоміжні засоби реєстру команд |
+ | `plugin-sdk/secret-input` | Розбір введення секретів | Допоміжні засоби введення секретів |
| `plugin-sdk/webhook-ingress` | Допоміжні засоби запитів webhook | Утиліти цілей webhook |
- | `plugin-sdk/webhook-request-guards` | Допоміжні засоби guard для тіла webhook-запиту | Допоміжні засоби читання/обмеження тіла запиту |
- | `plugin-sdk/reply-runtime` | Спільний runtime reply | Inbound dispatch, heartbeat, планувальник reply, chunking |
- | `plugin-sdk/reply-dispatch-runtime` | Вузькі допоміжні засоби dispatch reply | Helpers finalize + provider dispatch |
- | `plugin-sdk/reply-history` | Допоміжні засоби історії reply | `buildHistoryContext`, `buildPendingHistoryContextFromMap`, `recordPendingHistoryEntry`, `clearHistoryEntriesIfEnabled` |
- | `plugin-sdk/reply-reference` | Планування посилань reply | `createReplyReferencePlanner` |
- | `plugin-sdk/reply-chunking` | Допоміжні засоби chunks reply | Допоміжні засоби chunking тексту/markdown |
- | `plugin-sdk/session-store-runtime` | Допоміжні засоби сховища сесій | Шлях сховища + helpers updated-at |
- | `plugin-sdk/state-paths` | Допоміжні засоби шляхів стану | Допоміжні засоби state та OAuth dir |
- | `plugin-sdk/routing` | Допоміжні засоби routing/session-key | `resolveAgentRoute`, `buildAgentSessionKey`, `resolveDefaultAgentBoundAccountId`, helpers нормалізації session-key |
- | `plugin-sdk/status-helpers` | Допоміжні засоби стану каналів | Builder-и підсумку стану каналу/облікового запису, типові значення runtime-state, helpers метаданих проблем |
- | `plugin-sdk/target-resolver-runtime` | Допоміжні засоби розв’язання цілей | Спільні helpers розв’язання цілей |
- | `plugin-sdk/string-normalization-runtime` | Допоміжні засоби нормалізації рядків | Helpers нормалізації slug/рядків |
- | `plugin-sdk/request-url` | Допоміжні засоби URL запиту | Витягання рядкових URL із вхідних даних, подібних до запиту |
- | `plugin-sdk/run-command` | Допоміжні засоби команд із таймерами | Виконавець команд із таймером і нормалізованими stdout/stderr |
- | `plugin-sdk/param-readers` | Зчитувачі параметрів | Поширені зчитувачі параметрів tool/CLI |
- | `plugin-sdk/tool-send` | Витягнення надсилання tool | Витягання канонічних полів цілі надсилання з аргументів tool |
- | `plugin-sdk/temp-path` | Допоміжні засоби тимчасових шляхів | Спільні helpers шляхів для тимчасового завантаження |
- | `plugin-sdk/logging-core` | Допоміжні засоби логування | Logger підсистеми та helpers редагування чутливих даних |
- | `plugin-sdk/markdown-table-runtime` | Допоміжні засоби таблиць Markdown | Допоміжні засоби режиму таблиць Markdown |
- | `plugin-sdk/reply-payload` | Типи reply повідомлень | Типи payload reply |
- | `plugin-sdk/provider-setup` | Відібрані допоміжні засоби налаштування локальних/self-hosted провайдерів | Допоміжні засоби виявлення/конфігурації self-hosted провайдерів |
- | `plugin-sdk/self-hosted-provider-setup` | Точкові допоміжні засоби налаштування self-hosted провайдерів, сумісних з OpenAI | Ті самі допоміжні засоби виявлення/конфігурації self-hosted провайдерів |
- | `plugin-sdk/provider-auth-runtime` | Допоміжні засоби runtime-автентифікації провайдера | Допоміжні засоби runtime для розв’язання API key |
- | `plugin-sdk/provider-auth-api-key` | Допоміжні засоби налаштування API key провайдера | Допоміжні засоби onboarding/profile-write для API key |
- | `plugin-sdk/provider-auth-result` | Допоміжні засоби результатів автентифікації провайдера | Стандартний builder результату OAuth-автентифікації |
+ | `plugin-sdk/webhook-request-guards` | Допоміжні засоби guards для тіла webhook-запиту | Допоміжні засоби читання/обмеження тіла запиту |
+ | `plugin-sdk/reply-runtime` | Спільний runtime відповідей | Inbound dispatch, heartbeat, планувальник відповідей, chunking |
+ | `plugin-sdk/reply-dispatch-runtime` | Вузькі допоміжні засоби dispatch відповідей | Допоміжні засоби finalize + provider dispatch |
+ | `plugin-sdk/reply-history` | Допоміжні засоби історії відповідей | `buildHistoryContext`, `buildPendingHistoryContextFromMap`, `recordPendingHistoryEntry`, `clearHistoryEntriesIfEnabled` |
+ | `plugin-sdk/reply-reference` | Планування посилань на відповідь | `createReplyReferencePlanner` |
+ | `plugin-sdk/reply-chunking` | Допоміжні засоби chunks відповіді | Допоміжні засоби chunking тексту/markdown |
+ | `plugin-sdk/session-store-runtime` | Допоміжні засоби session store | Допоміжні засоби шляху сховища + updated-at |
+ | `plugin-sdk/state-paths` | Допоміжні засоби шляхів стану | Допоміжні засоби каталогів state і OAuth |
+ | `plugin-sdk/routing` | Допоміжні засоби routing/session-key | `resolveAgentRoute`, `buildAgentSessionKey`, `resolveDefaultAgentBoundAccountId`, допоміжні засоби нормалізації session-key |
+ | `plugin-sdk/status-helpers` | Допоміжні засоби статусу каналу | Конструктори підсумку статусу каналу/облікового запису, значення runtime-state за замовчуванням, допоміжні засоби метаданих проблем |
+ | `plugin-sdk/target-resolver-runtime` | Допоміжні засоби target resolver | Спільні допоміжні засоби target resolver |
+ | `plugin-sdk/string-normalization-runtime` | Допоміжні засоби нормалізації рядків | Допоміжні засоби нормалізації slug/рядків |
+ | `plugin-sdk/request-url` | Допоміжні засоби URL запиту | Витяг рядкових URL із request-подібних вхідних даних |
+ | `plugin-sdk/run-command` | Допоміжні засоби timed command | Виконавець команд із таймерами та нормалізованими stdout/stderr |
+ | `plugin-sdk/param-readers` | Читачі параметрів | Поширені читачі параметрів tool/CLI |
+ | `plugin-sdk/tool-send` | Витягування tool send | Витягування канонічних полів цілі надсилання з аргументів tool |
+ | `plugin-sdk/temp-path` | Допоміжні засоби тимчасових шляхів | Спільні допоміжні засоби тимчасових шляхів для завантажень |
+ | `plugin-sdk/logging-core` | Допоміжні засоби logging | Допоміжні засоби logger підсистеми та редагування |
+ | `plugin-sdk/markdown-table-runtime` | Допоміжні засоби markdown-table | Допоміжні засоби режимів markdown-таблиць |
+ | `plugin-sdk/reply-payload` | Типи reply повідомлень | Типи reply payload |
+ | `plugin-sdk/provider-setup` | Куровані допоміжні засоби налаштування локального/self-hosted провайдера | Допоміжні засоби виявлення/конфігурації self-hosted провайдера |
+ | `plugin-sdk/self-hosted-provider-setup` | Цільові допоміжні засоби налаштування self-hosted провайдера, сумісного з OpenAI | Ті самі допоміжні засоби виявлення/конфігурації self-hosted провайдера |
+ | `plugin-sdk/provider-auth-runtime` | Допоміжні засоби auth runtime провайдера | Допоміжні засоби визначення API-ключа під час runtime |
+ | `plugin-sdk/provider-auth-api-key` | Допоміжні засоби налаштування API-ключа провайдера | Допоміжні засоби онбордингу/запису профілю API-ключа |
+ | `plugin-sdk/provider-auth-result` | Допоміжні засоби результату auth провайдера | Стандартний конструктор результату OAuth auth |
| `plugin-sdk/provider-auth-login` | Допоміжні засоби інтерактивного входу провайдера | Спільні допоміжні засоби інтерактивного входу |
- | `plugin-sdk/provider-env-vars` | Допоміжні засоби env vars провайдера | Допоміжні засоби пошуку env vars автентифікації провайдера |
- | `plugin-sdk/provider-model-shared` | Спільні допоміжні засоби моделей/replay провайдера | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні builder-и policy replay, helpers endpoint провайдера та helpers нормалізації model-id |
+ | `plugin-sdk/provider-env-vars` | Допоміжні засоби env vars провайдера | Допоміжні засоби пошуку env vars auth провайдера |
+ | `plugin-sdk/provider-model-shared` | Спільні допоміжні засоби моделі/повтору провайдера | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні конструктори replay-policy, допоміжні засоби endpoint провайдера та нормалізації model-id |
| `plugin-sdk/provider-catalog-shared` | Спільні допоміжні засоби каталогу провайдера | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` |
- | `plugin-sdk/provider-onboard` | Patch-и onboarding провайдера | Допоміжні засоби конфігурації onboarding |
- | `plugin-sdk/provider-http` | Допоміжні засоби HTTP провайдера | Загальні helpers можливостей HTTP/endpoint провайдера |
- | `plugin-sdk/provider-web-fetch` | Допоміжні засоби web-fetch провайдера | Helpers реєстрації/кешу провайдера web-fetch |
- | `plugin-sdk/provider-web-search` | Допоміжні засоби web-search провайдера | Helpers реєстрації/кешу/конфігурації провайдера web-search |
- | `plugin-sdk/provider-tools` | Допоміжні засоби сумісності tools/schema провайдера | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, очищення схеми Gemini + діагностика, а також helpers сумісності xAI, як-от `resolveXaiModelCompatPatch` / `applyXaiModelCompat` |
- | `plugin-sdk/provider-usage` | Допоміжні засоби usage провайдера | `fetchClaudeUsage`, `fetchGeminiUsage`, `fetchGithubCopilotUsage` та інші helpers usage провайдера |
- | `plugin-sdk/provider-stream` | Допоміжні засоби обгортки потоків провайдера | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, типи stream wrapper і спільні helpers обгорток Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
+ | `plugin-sdk/provider-onboard` | Патчі онбордингу провайдера | Допоміжні засоби конфігурації онбордингу |
+ | `plugin-sdk/provider-http` | Допоміжні засоби HTTP провайдера | Узагальнені допоміжні засоби HTTP/можливостей endpoint провайдера |
+ | `plugin-sdk/provider-web-fetch` | Допоміжні засоби web-fetch провайдера | Допоміжні засоби реєстрації/кешу провайдера web-fetch |
+ | `plugin-sdk/provider-web-search-contract` | Допоміжні засоби контракту web-search провайдера | Цільові допоміжні засоби контракту конфігурації/облікових даних web-search, такі як `enablePluginInConfig`, `resolveProviderWebSearchPluginConfig` і scoped setters/getters облікових даних |
+ | `plugin-sdk/provider-web-search` | Допоміжні засоби web-search провайдера | Допоміжні засоби реєстрації/кешу/runtime провайдера web-search |
+ | `plugin-sdk/provider-tools` | Допоміжні засоби сумісності tool/schema провайдера | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, очищення схем Gemini + diagnostics і допоміжні засоби сумісності xAI, такі як `resolveXaiModelCompatPatch` / `applyXaiModelCompat` |
+ | `plugin-sdk/provider-usage` | Допоміжні засоби використання провайдера | `fetchClaudeUsage`, `fetchGeminiUsage`, `fetchGithubCopilotUsage` та інші допоміжні засоби використання провайдерів |
+ | `plugin-sdk/provider-stream` | Допоміжні засоби обгорток потоків провайдера | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, типи stream wrapper і спільні допоміжні засоби обгорток Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
| `plugin-sdk/keyed-async-queue` | Упорядкована асинхронна черга | `KeyedAsyncQueue` |
- | `plugin-sdk/media-runtime` | Спільні допоміжні засоби media | Допоміжні засоби отримання/перетворення/зберігання media плюс builder-и media payload |
- | `plugin-sdk/media-generation-runtime` | Спільні допоміжні засоби генерації media | Спільні helpers failover, вибір кандидатів і повідомлення про відсутню модель для генерації зображень/відео/музики |
- | `plugin-sdk/media-understanding` | Допоміжні засоби media understanding | Типи провайдера media understanding плюс provider-facing експорти helpers зображення/аудіо |
- | `plugin-sdk/text-runtime` | Спільні допоміжні засоби тексту | Видалення тексту, видимого асистенту, helpers рендерингу/chunking/table для markdown, helpers редагування, helpers тегів директив, утиліти безпечного тексту та пов’язані helpers тексту/логування |
- | `plugin-sdk/text-chunking` | Допоміжні засоби chunking тексту | Допоміжна функція chunking вихідного тексту |
- | `plugin-sdk/speech` | Допоміжні засоби speech | Типи провайдерів speech плюс provider-facing helpers директив, реєстру й валідації |
- | `plugin-sdk/speech-core` | Спільне ядро speech | Типи провайдерів speech, реєстр, директиви, нормалізація |
- | `plugin-sdk/realtime-transcription` | Допоміжні засоби realtime transcription | Типи провайдера та helpers реєстру |
- | `plugin-sdk/realtime-voice` | Допоміжні засоби realtime voice | Типи провайдера та helpers реєстру |
- | `plugin-sdk/image-generation-core` | Спільне ядро генерації зображень | Helpers типів, failover, auth і реєстру для генерації зображень |
+ | `plugin-sdk/media-runtime` | Спільні допоміжні засоби медіа | Допоміжні засоби fetch/transform/store медіа плюс конструктори media payload |
+ | `plugin-sdk/media-generation-runtime` | Спільні допоміжні засоби генерації медіа | Спільні допоміжні засоби failover, вибір кандидатів і повідомлення про відсутні моделі для генерації зображень/відео/музики |
+ | `plugin-sdk/media-understanding` | Допоміжні засоби media-understanding | Типи провайдера media understanding плюс орієнтовані на провайдера експорти допоміжних засобів для зображень/аудіо |
+ | `plugin-sdk/text-runtime` | Спільні текстові допоміжні засоби | Видалення видимого асистенту тексту, допоміжні засоби render/chunking/table для markdown, допоміжні засоби редагування, directive-tag, safe-text utilities і пов’язані допоміжні засоби text/logging |
+ | `plugin-sdk/text-chunking` | Допоміжні засоби text chunking | Допоміжний засіб chunking вихідного тексту |
+ | `plugin-sdk/speech` | Допоміжні засоби speech | Типи провайдера speech плюс орієнтовані на провайдера допоміжні засоби директив, реєстру та перевірки |
+ | `plugin-sdk/speech-core` | Спільне ядро speech | Типи провайдера speech, реєстр, директиви, нормалізація |
+ | `plugin-sdk/realtime-transcription` | Допоміжні засоби realtime transcription | Типи провайдера та допоміжні засоби реєстру |
+ | `plugin-sdk/realtime-voice` | Допоміжні засоби realtime voice | Типи провайдера та допоміжні засоби реєстру |
+ | `plugin-sdk/image-generation-core` | Спільне ядро генерації зображень | Допоміжні засоби типів, failover, auth і реєстру для генерації зображень |
| `plugin-sdk/music-generation` | Допоміжні засоби генерації музики | Типи провайдера/запиту/результату для генерації музики |
- | `plugin-sdk/music-generation-core` | Спільне ядро генерації музики | Типи генерації музики, helpers failover, пошук провайдера та розбір model-ref |
+ | `plugin-sdk/music-generation-core` | Спільне ядро генерації музики | Типи генерації музики, допоміжні засоби failover, пошук провайдера та розбір model-ref |
| `plugin-sdk/video-generation` | Допоміжні засоби генерації відео | Типи провайдера/запиту/результату для генерації відео |
- | `plugin-sdk/video-generation-core` | Спільне ядро генерації відео | Типи генерації відео, helpers failover, пошук провайдера та розбір model-ref |
- | `plugin-sdk/interactive-runtime` | Допоміжні засоби інтерактивних reply | Нормалізація/зменшення payload інтерактивних reply |
- | `plugin-sdk/channel-config-primitives` | Примітиви конфігурації каналу | Вузькі примітиви channel config-schema |
+ | `plugin-sdk/video-generation-core` | Спільне ядро генерації відео | Типи генерації відео, допоміжні засоби failover, пошук провайдера та розбір model-ref |
+ | `plugin-sdk/interactive-runtime` | Допоміжні засоби інтерактивної відповіді | Нормалізація/зведення payload інтерактивної відповіді |
+ | `plugin-sdk/channel-config-primitives` | Примітиви конфігурації каналу | Вузькі примітиви schema конфігурації каналу |
| `plugin-sdk/channel-config-writes` | Допоміжні засоби запису конфігурації каналу | Допоміжні засоби авторизації запису конфігурації каналу |
- | `plugin-sdk/channel-plugin-common` | Спільний prelude каналу | Експорти спільного prelude плагіна каналу |
- | `plugin-sdk/channel-status` | Допоміжні засоби стану каналу | Спільні helpers snapshot/summary стану каналу |
+ | `plugin-sdk/channel-plugin-common` | Спільний prelude каналу | Спільні експорти prelude channel plugin |
+ | `plugin-sdk/channel-status` | Допоміжні засоби статусу каналу | Спільні допоміжні засоби snapshot/summary статусу каналу |
| `plugin-sdk/allowlist-config-edit` | Допоміжні засоби конфігурації allowlist | Допоміжні засоби редагування/читання конфігурації allowlist |
- | `plugin-sdk/group-access` | Допоміжні засоби доступу до груп | Спільні helpers прийняття рішень щодо групового доступу |
- | `plugin-sdk/direct-dm` | Допоміжні засоби direct-DM | Спільні helpers auth/guard для direct-DM |
- | `plugin-sdk/extension-shared` | Спільні допоміжні засоби extension | Примітиви passive-channel/status та ambient proxy helper |
- | `plugin-sdk/webhook-targets` | Допоміжні засоби цілей webhook | Реєстр цілей webhook і helpers встановлення маршрутів |
- | `plugin-sdk/webhook-path` | Допоміжні засоби шляхів webhook | Допоміжні засоби нормалізації шляхів webhook |
- | `plugin-sdk/web-media` | Спільні допоміжні засоби web media | Допоміжні засоби завантаження віддалених/локальних media |
- | `plugin-sdk/zod` | Повторний експорт zod | Повторно експортований `zod` для споживачів Plugin SDK |
- | `plugin-sdk/memory-core` | Вбудовані допоміжні засоби memory-core | Поверхня допоміжних засобів memory manager/config/file/CLI |
- | `plugin-sdk/memory-core-engine-runtime` | Runtime facade рушія пам’яті | Runtime facade індексу/пошуку пам’яті |
- | `plugin-sdk/memory-core-host-engine-foundation` | Базовий рушій хоста пам’яті | Експорти foundation engine хоста пам’яті |
- | `plugin-sdk/memory-core-host-engine-embeddings` | Рушій embedding хоста пам’яті | Експорти embedding engine хоста пам’яті |
- | `plugin-sdk/memory-core-host-engine-qmd` | QMD-рушій хоста пам’яті | Експорти QMD engine хоста пам’яті |
- | `plugin-sdk/memory-core-host-engine-storage` | Рушій зберігання хоста пам’яті | Експорти storage engine хоста пам’яті |
+ | `plugin-sdk/group-access` | Допоміжні засоби доступу груп | Спільні допоміжні засоби рішень group-access |
+ | `plugin-sdk/direct-dm` | Допоміжні засоби direct-DM | Спільні допоміжні засоби auth/guard direct-DM |
+ | `plugin-sdk/extension-shared` | Спільні допоміжні засоби extension | Примітиви passive-channel/status і ambient proxy helper |
+ | `plugin-sdk/webhook-targets` | Допоміжні засоби цілей webhook | Реєстр цілей webhook і допоміжні засоби встановлення route |
+ | `plugin-sdk/webhook-path` | Допоміжні засоби шляху webhook | Допоміжні засоби нормалізації шляху webhook |
+ | `plugin-sdk/web-media` | Спільні допоміжні засоби web media | Допоміжні засоби завантаження віддаленого/локального медіа |
+ | `plugin-sdk/zod` | Повторний експорт Zod | Повторно експортований `zod` для споживачів plugin SDK |
+ | `plugin-sdk/memory-core` | Допоміжні засоби вбудованого memory-core | Поверхня допоміжних засобів memory manager/config/file/CLI |
+ | `plugin-sdk/memory-core-engine-runtime` | Фасад runtime для memory engine | Фасад runtime для індексації/пошуку пам’яті |
+ | `plugin-sdk/memory-core-host-engine-foundation` | Foundation engine хоста пам’яті | Експорти foundation engine хоста пам’яті |
+ | `plugin-sdk/memory-core-host-engine-embeddings` | Embedding engine хоста пам’яті | Експорти embedding engine хоста пам’яті |
+ | `plugin-sdk/memory-core-host-engine-qmd` | QMD engine хоста пам’яті | Експорти QMD engine хоста пам’яті |
+ | `plugin-sdk/memory-core-host-engine-storage` | Storage engine хоста пам’яті | Експорти storage engine хоста пам’яті |
| `plugin-sdk/memory-core-host-multimodal` | Мультимодальні допоміжні засоби хоста пам’яті | Мультимодальні допоміжні засоби хоста пам’яті |
- | `plugin-sdk/memory-core-host-query` | Допоміжні засоби запитів хоста пам’яті | Допоміжні засоби запитів хоста пам’яті |
- | `plugin-sdk/memory-core-host-secret` | Допоміжні засоби секретів хоста пам’яті | Допоміжні засоби секретів хоста пам’яті |
+ | `plugin-sdk/memory-core-host-query` | Допоміжні засоби query хоста пам’яті | Допоміжні засоби query хоста пам’яті |
+ | `plugin-sdk/memory-core-host-secret` | Допоміжні засоби secret хоста пам’яті | Допоміжні засоби secret хоста пам’яті |
| `plugin-sdk/memory-core-host-events` | Допоміжні засоби журналу подій хоста пам’яті | Допоміжні засоби журналу подій хоста пам’яті |
- | `plugin-sdk/memory-core-host-status` | Допоміжні засоби стану хоста пам’яті | Допоміжні засоби стану хоста пам’яті |
+ | `plugin-sdk/memory-core-host-status` | Допоміжні засоби статусу хоста пам’яті | Допоміжні засоби статусу хоста пам’яті |
| `plugin-sdk/memory-core-host-runtime-cli` | CLI runtime хоста пам’яті | Допоміжні засоби CLI runtime хоста пам’яті |
- | `plugin-sdk/memory-core-host-runtime-core` | Базовий runtime хоста пам’яті | Допоміжні засоби core runtime хоста пам’яті |
+ | `plugin-sdk/memory-core-host-runtime-core` | Core runtime хоста пам’яті | Допоміжні засоби core runtime хоста пам’яті |
| `plugin-sdk/memory-core-host-runtime-files` | Допоміжні засоби файлів/runtime хоста пам’яті | Допоміжні засоби файлів/runtime хоста пам’яті |
- | `plugin-sdk/memory-host-core` | Псевдонім core runtime хоста пам’яті | Нейтральний щодо постачальника псевдонім для допоміжних засобів core runtime хоста пам’яті |
- | `plugin-sdk/memory-host-events` | Псевдонім журналу подій хоста пам’яті | Нейтральний щодо постачальника псевдонім для допоміжних засобів журналу подій хоста пам’яті |
- | `plugin-sdk/memory-host-files` | Псевдонім файлів/runtime хоста пам’яті | Нейтральний щодо постачальника псевдонім для допоміжних засобів файлів/runtime хоста пам’яті |
- | `plugin-sdk/memory-host-markdown` | Допоміжні засоби керованого markdown | Спільні helpers керованого markdown для плагінів, суміжних із пам’яттю |
- | `plugin-sdk/memory-host-search` | Facade активного пошуку в пам’яті | Lazy facade runtime менеджера активного пошуку в пам’яті |
- | `plugin-sdk/memory-host-status` | Псевдонім стану хоста пам’яті | Нейтральний щодо постачальника псевдонім для допоміжних засобів стану хоста пам’яті |
- | `plugin-sdk/memory-lancedb` | Вбудовані допоміжні засоби memory-lancedb | Поверхня допоміжних засобів memory-lancedb |
- | `plugin-sdk/testing` | Утиліти тестування | Допоміжні засоби тестів і mocks |
+ | `plugin-sdk/memory-host-core` | Псевдонім core runtime хоста пам’яті | Нейтральний до постачальника псевдонім для допоміжних засобів core runtime хоста пам’яті |
+ | `plugin-sdk/memory-host-events` | Псевдонім журналу подій хоста пам’яті | Нейтральний до постачальника псевдонім для допоміжних засобів журналу подій хоста пам’яті |
+ | `plugin-sdk/memory-host-files` | Псевдонім файлів/runtime хоста пам’яті | Нейтральний до постачальника псевдонім для допоміжних засобів файлів/runtime хоста пам’яті |
+ | `plugin-sdk/memory-host-markdown` | Допоміжні засоби керованого markdown | Спільні допоміжні засоби керованого markdown для plugin, суміжних із пам’яттю |
+ | `plugin-sdk/memory-host-search` | Фасад активного пошуку пам’яті | Лінивий фасад runtime search-manager активної пам’яті |
+ | `plugin-sdk/memory-host-status` | Псевдонім статусу хоста пам’яті | Нейтральний до постачальника псевдонім для допоміжних засобів статусу хоста пам’яті |
+ | `plugin-sdk/memory-lancedb` | Допоміжні засоби вбудованого memory-lancedb | Поверхня допоміжних засобів memory-lancedb |
+ | `plugin-sdk/testing` | Утиліти тестування | Допоміжні засоби тестування та mocks |
Ця таблиця навмисно містить поширену підмножину для міграції, а не повну
-поверхню SDK. Повний список із понад 200 entrypoints міститься в
+поверхню SDK. Повний список із понад 200 entrypoints розміщено в
`scripts/lib/plugin-sdk-entrypoints.json`.
-Цей список усе ще включає деякі допоміжні seams вбудованих плагінів, такі як
+Цей список усе ще містить деякі допоміжні seams вбудованих plugin, такі як
`plugin-sdk/feishu`, `plugin-sdk/feishu-setup`, `plugin-sdk/zalo`,
-`plugin-sdk/zalo-setup` і `plugin-sdk/matrix*`. Вони й надалі експортуються для
-підтримки вбудованих плагінів і сумісності, але навмисно
-опущені з таблиці поширеної міграції й не є рекомендованою ціллю для
-нового коду плагінів.
+`plugin-sdk/zalo-setup` і `plugin-sdk/matrix*`. Вони й далі експортуються для
+підтримки та сумісності вбудованих plugin, але навмисно
+не включені до таблиці поширеної міграції та не є рекомендованою ціллю для
+нового коду plugin.
-Те саме правило застосовується до інших сімейств вбудованих helper-ів, таких як:
+Те саме правило застосовується й до інших сімейств вбудованих допоміжних засобів, зокрема:
-- helpers підтримки browser: `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support`
+- допоміжні засоби підтримки браузера: `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support`
- Matrix: `plugin-sdk/matrix*`
- LINE: `plugin-sdk/line*`
- IRC: `plugin-sdk/irc*`
-- поверхні вбудованих helper/plugin, такі як `plugin-sdk/googlechat`,
+- вбудовані допоміжні засоби/поверхні plugin, такі як `plugin-sdk/googlechat`,
`plugin-sdk/zalouser`, `plugin-sdk/bluebubbles*`,
`plugin-sdk/mattermost*`, `plugin-sdk/msteams`,
`plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/tlon`,
@@ -338,39 +339,39 @@ workspace вбудованих плагінів зберігайте допом
`plugin-sdk/diagnostics-otel`, `plugin-sdk/diffs`, `plugin-sdk/llm-task`,
`plugin-sdk/thread-ownership` і `plugin-sdk/voice-call`
-`plugin-sdk/github-copilot-token` наразі надає вузьку
-поверхню token-helper `DEFAULT_COPILOT_API_BASE_URL`,
+`plugin-sdk/github-copilot-token` наразі надає вузьку поверхню допоміжних засобів токена:
+`DEFAULT_COPILOT_API_BASE_URL`,
`deriveCopilotApiBaseUrlFromToken` і `resolveCopilotApiToken`.
-Використовуйте найвужчий імпорт, який відповідає вашому завданню. Якщо ви не можете знайти експорт,
+Використовуйте найвужчий імпорт, який відповідає вашому завданню. Якщо ви не можете знайти потрібний експорт,
перевірте вихідний код у `src/plugin-sdk/` або запитайте в Discord.
-## Графік вилучення
+## Хронологія видалення
| Коли | Що відбувається |
| ---------------------- | ----------------------------------------------------------------------- |
-| **Зараз** | Застарілі поверхні видають попередження під час runtime |
-| **У наступному мажорному релізі** | Застарілі поверхні буде вилучено; плагіни, які все ще їх використовують, перестануть працювати |
+| **Зараз** | Застарілі поверхні надсилають попередження під час runtime |
+| **Наступний мажорний реліз** | Застарілі поверхні буде видалено; plugins, які все ще їх використовують, перестануть працювати |
-Усі core-плагіни вже мігровано. Зовнішнім плагінам слід виконати міграцію
+Усі core plugins уже мігровано. Зовнішнім plugins слід виконати міграцію
до наступного мажорного релізу.
## Тимчасове приглушення попереджень
-Задайте ці змінні середовища, поки працюєте над міграцією:
+Поки ви працюєте над міграцією, встановіть ці змінні середовища:
```bash
OPENCLAW_SUPPRESS_PLUGIN_SDK_COMPAT_WARNING=1 openclaw gateway run
OPENCLAW_SUPPRESS_EXTENSION_API_WARNING=1 openclaw gateway run
```
-Це тимчасовий запасний вихід, а не постійне рішення.
+Це тимчасовий обхідний механізм, а не постійне рішення.
## Пов’язане
-- [Початок роботи](/uk/plugins/building-plugins) — створення вашого першого плагіна
-- [Огляд SDK](/uk/plugins/sdk-overview) — повний довідник імпортів subpath
-- [Плагіни каналів](/uk/plugins/sdk-channel-plugins) — створення плагінів каналів
-- [Плагіни провайдерів](/uk/plugins/sdk-provider-plugins) — створення плагінів провайдерів
-- [Внутрішня будова плагінів](/uk/plugins/architecture) — детальний розбір архітектури
-- [Маніфест плагіна](/uk/plugins/manifest) — довідник схеми маніфесту
+- [Початок роботи](/uk/plugins/building-plugins) — створіть свій перший plugin
+- [Огляд SDK](/uk/plugins/sdk-overview) — повний довідник імпорту subpath
+- [Channel Plugins](/uk/plugins/sdk-channel-plugins) — створення channel plugins
+- [Provider Plugins](/uk/plugins/sdk-provider-plugins) — створення provider plugins
+- [Внутрішня будова plugin](/uk/plugins/architecture) — глибокий огляд архітектури
+- [Маніфест plugin](/uk/plugins/manifest) — довідник зі схеми маніфесту
diff --git a/docs/uk/plugins/sdk-overview.md b/docs/uk/plugins/sdk-overview.md
index 0f043560e..43b4c0094 100644
--- a/docs/uk/plugins/sdk-overview.md
+++ b/docs/uk/plugins/sdk-overview.md
@@ -4,27 +4,27 @@ read_when:
- Вам потрібен довідник для всіх методів реєстрації в OpenClawPluginApi
- Ви шукаєте конкретний експорт SDK
sidebarTitle: SDK Overview
-summary: Карта імпорту, довідник API реєстрації та архітектура SDK
+summary: Карта імпортів, довідник API реєстрації та архітектура SDK
title: Огляд Plugin SDK
x-i18n:
- generated_at: "2026-04-06T19:43:38Z"
+ generated_at: "2026-04-06T22:34:13Z"
model: gpt-5.4
provider: openai
- source_hash: 33539f020cbf2c8471b75d764124b8930c6e4a59c5b121d7e382ffd68040076b
+ source_hash: fe1fe41beaf73a7bdf807e281d181df7a5da5819343823c4011651fb234b0905
source_path: plugins/sdk-overview.md
workflow: 15
---
# Огляд Plugin SDK
-Plugin SDK — це типізований контракт між плагінами та ядром. Ця сторінка є
-довідником про **що імпортувати** і **що можна реєструвати**.
+Plugin SDK — це типізований контракт між plugin-ами та ядром. Ця сторінка є
+довідником для **що імпортувати** і **що можна зареєструвати**.
- **Шукаєте практичний посібник?**
- - Перший плагін? Почніть із [Getting Started](/uk/plugins/building-plugins)
- - Плагін каналу? Дивіться [Channel Plugins](/uk/plugins/sdk-channel-plugins)
- - Плагін провайдера? Дивіться [Provider Plugins](/uk/plugins/sdk-provider-plugins)
+ **Шукаєте покроковий посібник?**
+ - Перший plugin? Почніть з [Getting Started](/uk/plugins/building-plugins)
+ - Channel plugin? Дивіться [Channel Plugins](/uk/plugins/sdk-channel-plugins)
+ - Provider plugin? Дивіться [Provider Plugins](/uk/plugins/sdk-provider-plugins)
## Угода щодо імпорту
@@ -36,37 +36,37 @@ import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
import { defineChannelPluginEntry } from "openclaw/plugin-sdk/channel-core";
```
-Кожен підшлях — це невеликий, самодостатній модуль. Це зберігає швидкий запуск і
-запобігає проблемам із циклічними залежностями. Для специфічних для каналу
-допоміжних засобів entry/build надавайте перевагу `openclaw/plugin-sdk/channel-core`; використовуйте `openclaw/plugin-sdk/core`
-для ширшої поверхні umbrella та спільних допоміжних функцій, як-от
+Кожен підшлях є невеликим самодостатнім модулем. Це пришвидшує запуск і
+запобігає проблемам із циклічними залежностями. Для специфічних для channel
+допоміжних засобів entry/build віддавайте перевагу `openclaw/plugin-sdk/channel-core`; `openclaw/plugin-sdk/core` залишайте для
+ширшої поверхні umbrella та спільних допоміжних засобів, таких як
`buildChannelConfigSchema`.
-Не додавайте та не покладайтеся на зручні seam-и з назвами провайдерів, як-от
+Не додавайте й не використовуйте seams зручності з іменами provider-ів, такі як
`openclaw/plugin-sdk/slack`, `openclaw/plugin-sdk/discord`,
`openclaw/plugin-sdk/signal`, `openclaw/plugin-sdk/whatsapp`, або
-допоміжні seam-и з брендуванням каналів. Вбудовані плагіни мають компонувати
-загальні підшляхи SDK у власних barrel-файлах `api.ts` або `runtime-api.ts`, а ядро
-має або використовувати ці локальні для плагіна barrel-файли, або додавати вузький загальний контракт SDK,
-коли потреба справді є міжканальною.
+допоміжні seams із брендингом channel. Бандловані plugins мають компонувати загальні
+підшляхи SDK у власних barrel-файлах `api.ts` або `runtime-api.ts`, а ядро
+має або використовувати ці локальні для plugin barrel-файли, або додавати вузький загальний SDK
+контракт, коли потреба справді є між channel-ами.
-Згенерована карта експорту все ще містить невеликий набір допоміжних
-seam-ів вбудованих плагінів, як-от `plugin-sdk/feishu`, `plugin-sdk/feishu-setup`,
+Згенерована карта експортів усе ще містить невеликий набір бандлованих-plugin
+helper seams, таких як `plugin-sdk/feishu`, `plugin-sdk/feishu-setup`,
`plugin-sdk/zalo`, `plugin-sdk/zalo-setup` і `plugin-sdk/matrix*`. Ці
-підшляхи існують лише для підтримки та сумісності вбудованих плагінів; їх
+підшляхи існують лише для підтримки та сумісності бандлованих plugin-ів; їх
навмисно пропущено в загальній таблиці нижче, і вони не є рекомендованим
-шляхом імпорту для нових сторонніх плагінів.
+шляхом імпорту для нових сторонніх plugin-ів.
## Довідник підшляхів
Найуживаніші підшляхи, згруповані за призначенням. Згенерований повний список із
-понад 200 підшляхів міститься в `scripts/lib/plugin-sdk-entrypoints.json`.
+понад 200 підшляхів знаходиться в `scripts/lib/plugin-sdk-entrypoints.json`.
-Зарезервовані допоміжні підшляхи вбудованих плагінів усе ще з’являються в цьому згенерованому списку.
-Розглядайте їх як поверхні деталей реалізації/сумісності, якщо лише сторінка документації
-явно не просуває один із них як публічний.
+Зарезервовані helper-підшляхи бандлованих plugin-ів усе ще з’являються в цьому згенерованому списку.
+Сприймайте їх як деталі реалізації/поверхні сумісності, якщо сторінка документації
+явно не позначає якийсь із них як публічний.
-### Точка входу плагіна
+### Plugin entry
| Subpath | Ключові експорти |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
@@ -76,178 +76,179 @@ seam-ів вбудованих плагінів, як-от `plugin-sdk/feishu`,
| `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry` |
-
+
| Subpath | Ключові експорти |
| --- | --- |
| `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` | Спільні допоміжні засоби майстра налаштування, запити allowlist, конструктори статусу налаштування |
+ | `plugin-sdk/setup` | Спільні допоміжні засоби майстра налаштування, запити allowlist, будівники статусу налаштування |
| `plugin-sdk/setup-runtime` | `createPatchedAccountSetupAdapter`, `createEnvPatchedAccountSetupAdapter`, `createSetupInputPresenceValidator`, `noteChannelLookupFailure`, `noteChannelLookupSummary`, `promptResolvedAllowFrom`, `splitSetupEntries`, `createAllowlistSetupWizardProxy`, `createDelegatedSetupWizardProxy` |
| `plugin-sdk/setup-adapter-runtime` | `createEnvPatchedAccountSetupAdapter` |
| `plugin-sdk/setup-tools` | `formatCliCommand`, `detectBinary`, `extractArchive`, `resolveBrewExecutable`, `formatDocsLink`, `CONFIG_DIR` |
- | `plugin-sdk/account-core` | Допоміжні засоби конфігурації/керування gate для кількох акаунтів, допоміжні засоби резервного використання акаунта за замовчуванням |
+ | `plugin-sdk/account-core` | Допоміжні засоби конфігурації/контролю дій для кількох облікових записів, допоміжні засоби fallback для типового облікового запису |
| `plugin-sdk/account-id` | `DEFAULT_ACCOUNT_ID`, допоміжні засоби нормалізації account-id |
- | `plugin-sdk/account-resolution` | Допоміжні засоби пошуку акаунта + резервного використання за замовчуванням |
- | `plugin-sdk/account-helpers` | Вузькі допоміжні засоби списку акаунтів/дій з акаунтами |
+ | `plugin-sdk/account-resolution` | Допоміжні засоби пошуку облікового запису + fallback до типового |
+ | `plugin-sdk/account-helpers` | Вузькі допоміжні засоби для списків облікових записів/дій з обліковими записами |
| `plugin-sdk/channel-pairing` | `createChannelPairingController` |
| `plugin-sdk/channel-reply-pipeline` | `createChannelReplyPipeline` |
| `plugin-sdk/channel-config-helpers` | `createHybridChannelConfigAdapter` |
- | `plugin-sdk/channel-config-schema` | Типи схеми конфігурації каналу |
- | `plugin-sdk/telegram-command-config` | Допоміжні засоби нормалізації/валідації власних команд Telegram із fallback для контракту вбудованого пакета |
+ | `plugin-sdk/channel-config-schema` | Типи схеми конфігурації channel |
+ | `plugin-sdk/telegram-command-config` | Допоміжні засоби нормалізації/валідації кастомних команд Telegram із fallback на bundled-contract |
| `plugin-sdk/channel-policy` | `resolveChannelGroupRequireMention` |
| `plugin-sdk/channel-lifecycle` | `createAccountStatusSink` |
- | `plugin-sdk/inbound-envelope` | Спільні допоміжні засоби побудови вхідних маршрутів і envelope |
- | `plugin-sdk/inbound-reply-dispatch` | Спільні допоміжні засоби запису й диспетчеризації вхідних даних |
- | `plugin-sdk/messaging-targets` | Допоміжні засоби розбору/зіставлення цілей |
+ | `plugin-sdk/inbound-envelope` | Спільні допоміжні засоби маршрутизації вхідних повідомлень + побудови envelope |
+ | `plugin-sdk/inbound-reply-dispatch` | Спільні допоміжні засоби запису та dispatch для вхідних повідомлень |
+ | `plugin-sdk/messaging-targets` | Допоміжні засоби розбору/зіставлення target |
| `plugin-sdk/outbound-media` | Спільні допоміжні засоби завантаження вихідних медіа |
- | `plugin-sdk/outbound-runtime` | Допоміжні засоби делегатів вихідної ідентичності/надсилання |
- | `plugin-sdk/thread-bindings-runtime` | Допоміжні засоби життєвого циклу та адаптера прив’язок потоків |
- | `plugin-sdk/agent-media-payload` | Застарілий конструктор медіа payload агента |
- | `plugin-sdk/conversation-runtime` | Допоміжні засоби прив’язки розмови/потоку, парування та налаштованої прив’язки |
- | `plugin-sdk/runtime-config-snapshot` | Допоміжний засіб знімка конфігурації часу виконання |
- | `plugin-sdk/runtime-group-policy` | Допоміжні засоби визначення group-policy часу виконання |
- | `plugin-sdk/channel-status` | Спільні допоміжні засоби знімка/підсумку статусу каналу |
- | `plugin-sdk/channel-config-primitives` | Вузькі примітиви schema конфігурації каналу |
- | `plugin-sdk/channel-config-writes` | Допоміжні засоби авторизації запису конфігурації каналу |
- | `plugin-sdk/channel-plugin-common` | Спільні exports-прелюдії плагіна каналу |
+ | `plugin-sdk/outbound-runtime` | Допоміжні засоби вихідної ідентичності/send delegate |
+ | `plugin-sdk/thread-bindings-runtime` | Життєвий цикл thread-binding та допоміжні засоби adapter |
+ | `plugin-sdk/agent-media-payload` | Застарілий builder media payload агента |
+ | `plugin-sdk/conversation-runtime` | Допоміжні засоби binding для conversation/thread, pairing і configured-binding |
+ | `plugin-sdk/runtime-config-snapshot` | Допоміжний засіб snapshot конфігурації runtime |
+ | `plugin-sdk/runtime-group-policy` | Допоміжні засоби визначення group-policy у runtime |
+ | `plugin-sdk/channel-status` | Спільні допоміжні засоби snapshot/summary статусу channel |
+ | `plugin-sdk/channel-config-primitives` | Вузькі примітиви schema конфігурації channel |
+ | `plugin-sdk/channel-config-writes` | Допоміжні засоби авторизації запису конфігурації channel |
+ | `plugin-sdk/channel-plugin-common` | Спільні prelude-експорти channel plugin |
| `plugin-sdk/allowlist-config-edit` | Допоміжні засоби редагування/читання конфігурації allowlist |
- | `plugin-sdk/group-access` | Спільні допоміжні засоби прийняття рішень щодо group-access |
- | `plugin-sdk/direct-dm` | Спільні допоміжні засоби auth/guard для прямих DM |
- | `plugin-sdk/interactive-runtime` | Допоміжні засоби нормалізації/згортання інтерактивного reply payload |
+ | `plugin-sdk/group-access` | Спільні допоміжні засоби рішень щодо доступу до group |
+ | `plugin-sdk/direct-dm` | Спільні допоміжні засоби auth/guard для direct-DM |
+ | `plugin-sdk/interactive-runtime` | Допоміжні засоби нормалізації/редукції payload інтерактивних відповідей |
| `plugin-sdk/channel-inbound` | Debounce, зіставлення згадок, допоміжні засоби envelope |
- | `plugin-sdk/channel-send-result` | Типи результату reply |
+ | `plugin-sdk/channel-send-result` | Типи результату відповіді |
| `plugin-sdk/channel-actions` | `createMessageToolButtonsSchema`, `createMessageToolCardSchema` |
- | `plugin-sdk/channel-targets` | Допоміжні засоби розбору/зіставлення цілей |
- | `plugin-sdk/channel-contract` | Типи контракту каналу |
+ | `plugin-sdk/channel-targets` | Допоміжні засоби розбору/зіставлення target |
+ | `plugin-sdk/channel-contract` | Типи контракту channel |
| `plugin-sdk/channel-feedback` | Підключення feedback/reaction |
- | `plugin-sdk/channel-secret-runtime` | Вузькі допоміжні засоби секретного контракту, такі як `collectSimpleChannelFieldAssignments`, `getChannelSurface`, `pushAssignment`, і типи secret target |
+ | `plugin-sdk/channel-secret-runtime` | Вузькі допоміжні засоби secret-contract, такі як `collectSimpleChannelFieldAssignments`, `getChannelSurface`, `pushAssignment`, і типи secret target |
-
+
| Subpath | Ключові експорти |
| --- | --- |
| `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry` |
- | `plugin-sdk/provider-setup` | Кураторські допоміжні засоби налаштування локального/self-hosted провайдера |
- | `plugin-sdk/self-hosted-provider-setup` | Сфокусовані допоміжні засоби налаштування self-hosted провайдера, сумісного з OpenAI |
- | `plugin-sdk/cli-backend` | Значення CLI backend за замовчуванням + константи watchdog |
- | `plugin-sdk/provider-auth-runtime` | Допоміжні засоби визначення API-ключа під час виконання для плагінів провайдерів |
- | `plugin-sdk/provider-auth-api-key` | Допоміжні засоби онбордингу/запису профілю API-ключа, такі як `upsertApiKeyProfile` |
- | `plugin-sdk/provider-auth-result` | Стандартний конструктор результату автентифікації OAuth |
- | `plugin-sdk/provider-auth-login` | Спільні інтерактивні допоміжні засоби входу для плагінів провайдерів |
- | `plugin-sdk/provider-env-vars` | Допоміжні засоби пошуку env-var автентифікації провайдера |
+ | `plugin-sdk/provider-setup` | Кураторські допоміжні засоби налаштування локальних/self-hosted provider-ів |
+ | `plugin-sdk/self-hosted-provider-setup` | Фокусовані допоміжні засоби налаштування self-hosted provider-ів, сумісних з OpenAI |
+ | `plugin-sdk/cli-backend` | Типові значення CLI backend + константи watchdog |
+ | `plugin-sdk/provider-auth-runtime` | Допоміжні засоби визначення API-ключів у runtime для provider plugin-ів |
+ | `plugin-sdk/provider-auth-api-key` | Допоміжні засоби онбордингу/запису профілю API-ключів, такі як `upsertApiKeyProfile` |
+ | `plugin-sdk/provider-auth-result` | Стандартний builder результату OAuth auth |
+ | `plugin-sdk/provider-auth-login` | Спільні допоміжні засоби інтерактивного входу для provider plugin-ів |
+ | `plugin-sdk/provider-env-vars` | Допоміжні засоби пошуку env var auth provider-ів |
| `plugin-sdk/provider-auth` | `createProviderApiKeyAuthMethod`, `ensureApiKeyFromOptionEnvOrPrompt`, `upsertAuthProfile`, `upsertApiKeyProfile`, `writeOAuthCredentials` |
- | `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні конструктори replay-policy, допоміжні засоби endpoint провайдера та допоміжні засоби нормалізації model-id, такі як `normalizeNativeXaiModelId` |
+ | `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні builder-и replay-policy, допоміжні засоби endpoint provider-ів і нормалізації model-id, такі як `normalizeNativeXaiModelId` |
| `plugin-sdk/provider-catalog-shared` | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` |
- | `plugin-sdk/provider-http` | Загальні допоміжні засоби HTTP/endpoint capability провайдера |
- | `plugin-sdk/provider-web-fetch` | Допоміжні засоби реєстрації/кешу провайдера web-fetch |
- | `plugin-sdk/provider-web-search` | Допоміжні засоби реєстрації/кешу/конфігурації провайдера web-search |
- | `plugin-sdk/provider-tools` | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, очищення схеми Gemini + діагностика, а також допоміжні засоби сумісності xAI, такі як `resolveXaiModelCompatPatch` / `applyXaiModelCompat` |
- | `plugin-sdk/provider-usage` | `fetchClaudeUsage` і подібні |
- | `plugin-sdk/provider-stream` | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, типи stream wrapper і спільні допоміжні wrapper-и Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
+ | `plugin-sdk/provider-http` | Загальні допоміжні засоби HTTP/endpoint capability provider-ів |
+ | `plugin-sdk/provider-web-fetch` | Допоміжні засоби реєстрації/cache для provider-ів web-fetch |
+ | `plugin-sdk/provider-web-search-contract` | Вузькі допоміжні засоби контракту конфігурації/облікових даних web-search, такі як `enablePluginInConfig`, `resolveProviderWebSearchPluginConfig` і scoped setter/getter-и облікових даних |
+ | `plugin-sdk/provider-web-search` | Допоміжні засоби реєстрації/cache/runtime для provider-ів web-search |
+ | `plugin-sdk/provider-tools` | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, очищення схеми Gemini + діагностика, а також xAI compat helpers, такі як `resolveXaiModelCompatPatch` / `applyXaiModelCompat` |
+ | `plugin-sdk/provider-usage` | `fetchClaudeUsage` та подібні |
+ | `plugin-sdk/provider-stream` | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, типи stream wrapper і спільні helper-и wrapper для Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
| `plugin-sdk/provider-onboard` | Допоміжні засоби patch конфігурації онбордингу |
- | `plugin-sdk/global-singleton` | Допоміжні засоби локального для процесу singleton/map/cache |
+ | `plugin-sdk/global-singleton` | Допоміжні засоби process-local singleton/map/cache |
-
+
| Subpath | Ключові експорти |
| --- | --- |
| `plugin-sdk/command-auth` | `resolveControlCommandGate`, допоміжні засоби реєстру команд, допоміжні засоби авторизації відправника |
- | `plugin-sdk/approval-auth-runtime` | Допоміжні засоби визначення approver і action-auth в тому самому чаті |
+ | `plugin-sdk/approval-auth-runtime` | Допоміжні засоби визначення approver і auth дій у тому ж chat |
| `plugin-sdk/approval-client-runtime` | Допоміжні засоби профілю/фільтра native exec approval |
- | `plugin-sdk/approval-delivery-runtime` | Адаптери native approval capability/delivery |
+ | `plugin-sdk/approval-delivery-runtime` | Native adapter-и capability/delivery для approval |
| `plugin-sdk/approval-native-runtime` | Допоміжні засоби native approval target + account-binding |
- | `plugin-sdk/approval-reply-runtime` | Допоміжні засоби payload відповіді на approve exec/plugin |
- | `plugin-sdk/command-auth-native` | Допоміжні засоби native command auth + native session-target |
+ | `plugin-sdk/approval-reply-runtime` | Допоміжні засоби payload відповіді для exec/plugin approval |
+ | `plugin-sdk/command-auth-native` | Native command auth + native session-target helpers |
| `plugin-sdk/command-detection` | Спільні допоміжні засоби виявлення команд |
- | `plugin-sdk/command-surface` | Допоміжні засоби нормалізації тіла команди та command-surface |
+ | `plugin-sdk/command-surface` | Допоміжні засоби нормалізації body команд і command-surface |
| `plugin-sdk/allow-from` | `formatAllowFromLowercase` |
- | `plugin-sdk/channel-secret-runtime` | Вузькі допоміжні засоби збирання секретних контрактів для поверхонь секретів каналу/плагіна |
- | `plugin-sdk/security-runtime` | Спільні допоміжні засоби довіри, DM gating, зовнішнього вмісту та збирання секретів |
- | `plugin-sdk/ssrf-policy` | Допоміжні засоби allowlist хостів і політики SSRF приватної мережі |
- | `plugin-sdk/ssrf-runtime` | Допоміжні засоби pinned-dispatcher, fetch із захистом від SSRF і політики SSRF |
+ | `plugin-sdk/channel-secret-runtime` | Вузькі допоміжні засоби збору secret-contract для поверхонь secret channel/plugin |
+ | `plugin-sdk/security-runtime` | Спільні допоміжні засоби довіри, DM gating, external-content і збору secret |
+ | `plugin-sdk/ssrf-policy` | Допоміжні засоби політики SSRF для allowlist хостів і приватних мереж |
+ | `plugin-sdk/ssrf-runtime` | Допоміжні засоби pinned-dispatcher, fetch із SSRF-захистом і політики SSRF |
| `plugin-sdk/secret-input` | Допоміжні засоби розбору secret input |
- | `plugin-sdk/webhook-ingress` | Допоміжні засоби запиту/цілі webhook |
- | `plugin-sdk/webhook-request-guards` | Допоміжні засоби розміру тіла запиту/timeout |
+ | `plugin-sdk/webhook-ingress` | Допоміжні засоби request/target для webhook |
+ | `plugin-sdk/webhook-request-guards` | Допоміжні засоби для розміру body/timeout запиту |
-
+
| Subpath | Ключові експорти |
| --- | --- |
- | `plugin-sdk/runtime` | Широкі допоміжні засоби часу виконання/логування/резервного копіювання/встановлення плагінів |
- | `plugin-sdk/runtime-env` | Вузькі допоміжні засоби env часу виконання, logger, timeout, retry і backoff |
+ | `plugin-sdk/runtime` | Широкі допоміжні засоби runtime/logging/backup/install plugin-ів |
+ | `plugin-sdk/runtime-env` | Вузькі допоміжні засоби env runtime, logger, timeout, retry і backoff |
| `plugin-sdk/runtime-store` | `createPluginRuntimeStore` |
- | `plugin-sdk/plugin-runtime` | Спільні допоміжні засоби команд/хуків/http/interactive для плагінів |
+ | `plugin-sdk/plugin-runtime` | Спільні допоміжні засоби команд/hook/http/interactive plugin-ів |
| `plugin-sdk/hook-runtime` | Спільні допоміжні засоби pipeline для webhook/internal hook |
- | `plugin-sdk/lazy-runtime` | Допоміжні засоби lazy import/binding часу виконання, такі як `createLazyRuntimeModule`, `createLazyRuntimeMethod` і `createLazyRuntimeSurface` |
- | `plugin-sdk/process-runtime` | Допоміжні засоби виконання процесів |
- | `plugin-sdk/cli-runtime` | Допоміжні засоби форматування CLI, очікування та версії |
- | `plugin-sdk/gateway-runtime` | Допоміжні засоби клієнта Gateway і patch статусу каналу |
+ | `plugin-sdk/lazy-runtime` | Допоміжні засоби lazy import/binding у runtime, такі як `createLazyRuntimeModule`, `createLazyRuntimeMethod` і `createLazyRuntimeSurface` |
+ | `plugin-sdk/process-runtime` | Допоміжні засоби exec процесів |
+ | `plugin-sdk/cli-runtime` | Допоміжні засоби форматування, очікування і версій для CLI |
+ | `plugin-sdk/gateway-runtime` | Допоміжні засоби клієнта gateway і patch статусу channel |
| `plugin-sdk/config-runtime` | Допоміжні засоби завантаження/запису конфігурації |
- | `plugin-sdk/telegram-command-config` | Нормалізація назв/описів команд Telegram і перевірки дублікатів/конфліктів, навіть коли поверхня контракту вбудованого Telegram недоступна |
- | `plugin-sdk/approval-runtime` | Допоміжні засоби approve exec/plugin, конструктори capability approval, допоміжні засоби auth/profile, допоміжні засоби native routing/runtime |
- | `plugin-sdk/reply-runtime` | Спільні допоміжні засоби часу виконання inbound/reply, chunking, dispatch, heartbeat, planner відповідей |
- | `plugin-sdk/reply-dispatch-runtime` | Вузькі допоміжні засоби dispatch/finalize відповідей |
- | `plugin-sdk/reply-history` | Спільні допоміжні засоби коротковіконної історії reply, такі як `buildHistoryContext`, `recordPendingHistoryEntry` і `clearHistoryEntriesIfEnabled` |
+ | `plugin-sdk/telegram-command-config` | Нормалізація назв/описів команд Telegram і перевірки дублювання/конфліктів, навіть коли поверхня bundled Telegram contract недоступна |
+ | `plugin-sdk/approval-runtime` | Допоміжні засоби exec/plugin approval, builder-и capability approval, допоміжні засоби auth/profile, native routing/runtime helpers |
+ | `plugin-sdk/reply-runtime` | Спільні допоміжні засоби runtime для вхідних повідомлень/відповідей, chunking, dispatch, heartbeat, planner відповідей |
+ | `plugin-sdk/reply-dispatch-runtime` | Вузькі допоміжні засоби dispatch/finalize для відповідей |
+ | `plugin-sdk/reply-history` | Спільні допоміжні засоби коротковіконної history відповідей, такі як `buildHistoryContext`, `recordPendingHistoryEntry` і `clearHistoryEntriesIfEnabled` |
| `plugin-sdk/reply-reference` | `createReplyReferencePlanner` |
- | `plugin-sdk/reply-chunking` | Вузькі допоміжні засоби chunking тексту/markdown |
- | `plugin-sdk/session-store-runtime` | Допоміжні засоби шляху до session store + `updated-at` |
- | `plugin-sdk/state-paths` | Допоміжні засоби шляхів до каталогів state/OAuth |
- | `plugin-sdk/routing` | Допоміжні засоби прив’язки route/session-key/account, такі як `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` | Загальні читачі параметрів tool/CLI |
- | `plugin-sdk/tool-send` | Витягування канонічних полів цілі надсилання з аргументів інструмента |
+ | `plugin-sdk/reply-chunking` | Вузькі допоміжні засоби chunking для text/markdown |
+ | `plugin-sdk/session-store-runtime` | Допоміжні засоби шляху session store + updated-at |
+ | `plugin-sdk/state-paths` | Допоміжні засоби шляхів до директорій state/OAuth |
+ | `plugin-sdk/routing` | Допоміжні засоби route/session-key/account binding, такі як `resolveAgentRoute`, `buildAgentSessionKey` і `resolveDefaultAgentBoundAccountId` |
+ | `plugin-sdk/status-helpers` | Спільні допоміжні засоби summary статусу channel/account, типові значення стану runtime та допоміжні засоби метаданих issue |
+ | `plugin-sdk/target-resolver-runtime` | Спільні допоміжні засоби визначення target |
+ | `plugin-sdk/string-normalization-runtime` | Допоміжні засоби нормалізації slug/string |
+ | `plugin-sdk/request-url` | Витягування рядкових URL із fetch/request-подібних входів |
+ | `plugin-sdk/run-command` | Timed command runner із нормалізованими результатами stdout/stderr |
+ | `plugin-sdk/param-readers` | Загальні reader-и параметрів tool/CLI |
+ | `plugin-sdk/tool-send` | Витягування канонічних полів target надсилання з аргументів tool |
| `plugin-sdk/temp-path` | Спільні допоміжні засоби шляхів до тимчасових завантажень |
- | `plugin-sdk/logging-core` | Допоміжні засоби logger підсистеми та редагування |
- | `plugin-sdk/markdown-table-runtime` | Допоміжні засоби режиму таблиць Markdown |
- | `plugin-sdk/json-store` | Невеликі допоміжні засоби читання/запису стану JSON |
- | `plugin-sdk/file-lock` | Допоміжні засоби реентерабельного file-lock |
- | `plugin-sdk/persistent-dedupe` | Допоміжні засоби кешу dedupe зберігання на диску |
- | `plugin-sdk/acp-runtime` | Допоміжні засоби ACP runtime/session і reply-dispatch |
+ | `plugin-sdk/logging-core` | Допоміжні засоби logger-а subsystem і редагування чутливих даних |
+ | `plugin-sdk/markdown-table-runtime` | Допоміжні засоби режиму Markdown-таблиць |
+ | `plugin-sdk/json-store` | Невеликі допоміжні засоби читання/запису JSON state |
+ | `plugin-sdk/file-lock` | Допоміжні засоби re-entrant file-lock |
+ | `plugin-sdk/persistent-dedupe` | Допоміжні засоби disk-backed dedupe cache |
+ | `plugin-sdk/acp-runtime` | Допоміжні засоби runtime/session ACP і reply-dispatch |
| `plugin-sdk/agent-config-primitives` | Вузькі примітиви schema конфігурації runtime агента |
- | `plugin-sdk/boolean-param` | Гнучкий читач булевих параметрів |
- | `plugin-sdk/dangerous-name-runtime` | Допоміжні засоби визначення збігів небезпечних назв |
- | `plugin-sdk/device-bootstrap` | Допоміжні засоби bootstrap пристрою та токенів парування |
- | `plugin-sdk/extension-shared` | Спільні примітиви допоміжних засобів passive-channel, status та ambient proxy |
- | `plugin-sdk/models-provider-runtime` | Допоміжні засоби `/models` command/provider reply |
- | `plugin-sdk/skill-commands-runtime` | Допоміжні засоби виведення списку команд Skills |
+ | `plugin-sdk/boolean-param` | Loose reader для boolean-параметрів |
+ | `plugin-sdk/dangerous-name-runtime` | Допоміжні засоби визначення зіставлення небезпечних імен |
+ | `plugin-sdk/device-bootstrap` | Допоміжні засоби bootstrap пристрою і pairing token |
+ | `plugin-sdk/extension-shared` | Спільні примітиви допоміжних засобів passive-channel, status і ambient proxy |
+ | `plugin-sdk/models-provider-runtime` | Допоміжні засоби відповіді provider-команди `/models` |
+ | `plugin-sdk/skill-commands-runtime` | Допоміжні засоби переліку команд Skills |
| `plugin-sdk/native-command-registry` | Допоміжні засоби реєстру/build/serialize native команд |
- | `plugin-sdk/provider-zai-endpoint` | Допоміжні засоби виявлення endpoint Z.AI |
- | `plugin-sdk/infra-runtime` | Допоміжні засоби системних подій/heartbeat |
- | `plugin-sdk/collection-runtime` | Невеликі допоміжні засоби обмеженого кешу |
+ | `plugin-sdk/provider-zai-endpoint` | Допоміжні засоби виявлення endpoint-ів Z.AI |
+ | `plugin-sdk/infra-runtime` | Допоміжні засоби system event/heartbeat |
+ | `plugin-sdk/collection-runtime` | Невеликі допоміжні засоби bounded cache |
| `plugin-sdk/diagnostic-runtime` | Допоміжні засоби діагностичних прапорців і подій |
- | `plugin-sdk/error-runtime` | Допоміжні засоби графа помилок, форматування, спільної класифікації помилок, `isApprovalNotFoundError` |
- | `plugin-sdk/fetch-runtime` | Обгорнуті допоміжні засоби fetch, proxy та pinned lookup |
+ | `plugin-sdk/error-runtime` | Граф помилок, форматування, спільні допоміжні засоби класифікації помилок, `isApprovalNotFoundError` |
+ | `plugin-sdk/fetch-runtime` | Допоміжні засоби wrapped fetch, proxy і pinned lookup |
| `plugin-sdk/host-runtime` | Допоміжні засоби нормалізації hostname і SCP host |
- | `plugin-sdk/retry-runtime` | Допоміжні засоби конфігурації retry і виконавця retry |
- | `plugin-sdk/agent-runtime` | Допоміжні засоби каталогу/ідентичності/workspace агента |
- | `plugin-sdk/directory-runtime` | Запит/дедуплікація каталогу на основі конфігурації |
+ | `plugin-sdk/retry-runtime` | Допоміжні засоби конфігурації retry і retry runner |
+ | `plugin-sdk/agent-runtime` | Допоміжні засоби dir/identity/workspace агента |
+ | `plugin-sdk/directory-runtime` | Запит/dedup директорій на основі конфігурації |
| `plugin-sdk/keyed-async-queue` | `KeyedAsyncQueue` |
-
+
| Subpath | Ключові експорти |
| --- | --- |
- | `plugin-sdk/media-runtime` | Спільні допоміжні засоби fetch/transform/store для медіа, а також конструктори медіа payload |
- | `plugin-sdk/media-generation-runtime` | Спільні допоміжні засоби failover генерації медіа, вибору кандидатів і повідомлень про відсутню модель |
- | `plugin-sdk/media-understanding` | Типи провайдерів media understanding, а також provider-facing експорти допоміжних засобів для зображень/аудіо |
- | `plugin-sdk/text-runtime` | Спільні допоміжні засоби тексту/markdown/логування, такі як видалення видимого асистенту тексту, допоміжні засоби render/chunking/table Markdown, редагування, directive-tag і safe-text utilities |
+ | `plugin-sdk/media-runtime` | Спільні допоміжні засоби fetch/transform/store медіа плюс builder-и media payload |
+ | `plugin-sdk/media-generation-runtime` | Спільні допоміжні засоби failover для генерації медіа, вибір candidate і повідомлення про відсутню модель |
+ | `plugin-sdk/media-understanding` | Типи provider-ів media understanding плюс експорти допоміжних засобів для зображень/аудіо для provider-ів |
+ | `plugin-sdk/text-runtime` | Спільні допоміжні засоби text/markdown/logging, такі як видалення видимого для асистента тексту, render/chunking/table helpers для markdown, helpers редагування чутливих даних, helpers тегів директив і safe-text utilities |
| `plugin-sdk/text-chunking` | Допоміжний засіб chunking вихідного тексту |
- | `plugin-sdk/speech` | Типи провайдерів speech, а також provider-facing допоміжні засоби directive, registry і validation |
- | `plugin-sdk/speech-core` | Спільні типи провайдерів speech, а також допоміжні засоби registry, directive і normalization |
- | `plugin-sdk/realtime-transcription` | Типи провайдерів realtime transcription і допоміжні засоби registry |
- | `plugin-sdk/realtime-voice` | Типи провайдерів realtime voice і допоміжні засоби registry |
- | `plugin-sdk/image-generation` | Типи провайдерів генерації зображень |
- | `plugin-sdk/image-generation-core` | Спільні типи генерації зображень, а також допоміжні засоби failover, auth і registry |
- | `plugin-sdk/music-generation` | Типи провайдера/запиту/результату генерації музики |
- | `plugin-sdk/music-generation-core` | Спільні типи генерації музики, допоміжні засоби failover, пошуку провайдера та розбору model-ref |
- | `plugin-sdk/video-generation` | Типи провайдера/запиту/результату генерації відео |
- | `plugin-sdk/video-generation-core` | Спільні типи генерації відео, допоміжні засоби failover, пошуку провайдера та розбору model-ref |
- | `plugin-sdk/webhook-targets` | Реєстр цілей webhook і допоміжні засоби встановлення маршрутів |
+ | `plugin-sdk/speech` | Типи speech provider-ів плюс допоміжні засоби директив, реєстру і валідації для provider-ів |
+ | `plugin-sdk/speech-core` | Спільні типи speech provider-ів, допоміжні засоби реєстру, директив і нормалізації |
+ | `plugin-sdk/realtime-transcription` | Типи provider-ів realtime transcription і допоміжні засоби реєстру |
+ | `plugin-sdk/realtime-voice` | Типи provider-ів realtime voice і допоміжні засоби реєстру |
+ | `plugin-sdk/image-generation` | Типи provider-ів генерації зображень |
+ | `plugin-sdk/image-generation-core` | Спільні типи генерації зображень, failover, auth і допоміжні засоби реєстру |
+ | `plugin-sdk/music-generation` | Типи provider/request/result для генерації музики |
+ | `plugin-sdk/music-generation-core` | Спільні типи генерації музики, допоміжні засоби failover, lookup provider-а і розбір model-ref |
+ | `plugin-sdk/video-generation` | Типи provider/request/result для генерації відео |
+ | `plugin-sdk/video-generation-core` | Спільні типи генерації відео, допоміжні засоби failover, lookup provider-а і розбір model-ref |
+ | `plugin-sdk/webhook-targets` | Допоміжні засоби реєстру target-ів webhook і встановлення route |
| `plugin-sdk/webhook-path` | Допоміжні засоби нормалізації шляху webhook |
| `plugin-sdk/web-media` | Спільні допоміжні засоби завантаження віддалених/локальних медіа |
| `plugin-sdk/zod` | Повторно експортований `zod` для споживачів Plugin SDK |
@@ -257,99 +258,99 @@ seam-ів вбудованих плагінів, як-от `plugin-sdk/feishu`,
| Subpath | Ключові експорти |
| --- | --- |
- | `plugin-sdk/memory-core` | Поверхня допоміжних засобів вбудованого memory-core для manager/config/file/CLI helpers |
- | `plugin-sdk/memory-core-engine-runtime` | Runtime facade індексу/пошуку пам’яті |
+ | `plugin-sdk/memory-core` | Поверхня helper-ів bundled memory-core для менеджера/конфігурації/файлів/CLI |
+ | `plugin-sdk/memory-core-engine-runtime` | Runtime facade індексації/пошуку пам’яті |
| `plugin-sdk/memory-core-host-engine-foundation` | Експорти foundation engine хоста пам’яті |
| `plugin-sdk/memory-core-host-engine-embeddings` | Експорти embedding engine хоста пам’яті |
| `plugin-sdk/memory-core-host-engine-qmd` | Експорти QMD engine хоста пам’яті |
| `plugin-sdk/memory-core-host-engine-storage` | Експорти storage engine хоста пам’яті |
- | `plugin-sdk/memory-core-host-multimodal` | Багатомодальні допоміжні засоби хоста пам’яті |
- | `plugin-sdk/memory-core-host-query` | Допоміжні засоби запитів хоста пам’яті |
- | `plugin-sdk/memory-core-host-secret` | Допоміжні засоби секретів хоста пам’яті |
+ | `plugin-sdk/memory-core-host-multimodal` | Допоміжні засоби multimodal хоста пам’яті |
+ | `plugin-sdk/memory-core-host-query` | Допоміжні засоби query хоста пам’яті |
+ | `plugin-sdk/memory-core-host-secret` | Допоміжні засоби 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-cli` | Допоміжні засоби runtime CLI хоста пам’яті |
| `plugin-sdk/memory-core-host-runtime-core` | Допоміжні засоби core runtime хоста пам’яті |
- | `plugin-sdk/memory-core-host-runtime-files` | Допоміжні засоби file/runtime хоста пам’яті |
- | `plugin-sdk/memory-host-core` | Нейтральний до вендора alias для допоміжних засобів core runtime хоста пам’яті |
- | `plugin-sdk/memory-host-events` | Нейтральний до вендора alias для допоміжних засобів журналу подій хоста пам’яті |
- | `plugin-sdk/memory-host-files` | Нейтральний до вендора alias для допоміжних засобів file/runtime хоста пам’яті |
- | `plugin-sdk/memory-host-markdown` | Спільні допоміжні засоби managed-markdown для плагінів, суміжних із пам’яттю |
- | `plugin-sdk/memory-host-search` | Активний runtime facade пам’яті для доступу до search-manager |
- | `plugin-sdk/memory-host-status` | Нейтральний до вендора alias для допоміжних засобів статусу хоста пам’яті |
- | `plugin-sdk/memory-lancedb` | Поверхня допоміжних засобів вбудованого memory-lancedb |
+ | `plugin-sdk/memory-core-host-runtime-files` | Допоміжні засоби файлів/runtime хоста пам’яті |
+ | `plugin-sdk/memory-host-core` | Незалежний від вендора псевдонім для helper-ів core runtime хоста пам’яті |
+ | `plugin-sdk/memory-host-events` | Незалежний від вендора псевдонім для helper-ів журналу подій хоста пам’яті |
+ | `plugin-sdk/memory-host-files` | Незалежний від вендора псевдонім для helper-ів файлів/runtime хоста пам’яті |
+ | `plugin-sdk/memory-host-markdown` | Спільні допоміжні засоби managed-markdown для plugin-ів, суміжних із пам’яттю |
+ | `plugin-sdk/memory-host-search` | Active memory runtime facade для доступу до search-manager |
+ | `plugin-sdk/memory-host-status` | Незалежний від вендора псевдонім для helper-ів статусу хоста пам’яті |
+ | `plugin-sdk/memory-lancedb` | Поверхня helper-ів bundled memory-lancedb |
-
- | Family | Поточні підшляхи | Призначене використання |
+
+ | Family | Поточні підшляхи | Призначення |
| --- | --- | --- |
- | Browser | `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support` | Допоміжні засоби підтримки вбудованого browser plugin (`browser-support` лишається compatibility barrel) |
- | Matrix | `plugin-sdk/matrix`, `plugin-sdk/matrix-helper`, `plugin-sdk/matrix-runtime-heavy`, `plugin-sdk/matrix-runtime-shared`, `plugin-sdk/matrix-runtime-surface`, `plugin-sdk/matrix-surface`, `plugin-sdk/matrix-thread-bindings` | Поверхня допоміжних засобів/runtime для вбудованого Matrix |
- | Line | `plugin-sdk/line`, `plugin-sdk/line-core`, `plugin-sdk/line-runtime`, `plugin-sdk/line-surface` | Поверхня допоміжних засобів/runtime для вбудованого LINE |
- | IRC | `plugin-sdk/irc`, `plugin-sdk/irc-surface` | Поверхня допоміжних засобів для вбудованого IRC |
- | Допоміжні засоби, специфічні для каналів | `plugin-sdk/googlechat`, `plugin-sdk/zalouser`, `plugin-sdk/bluebubbles`, `plugin-sdk/bluebubbles-policy`, `plugin-sdk/mattermost`, `plugin-sdk/mattermost-policy`, `plugin-sdk/feishu-conversation`, `plugin-sdk/msteams`, `plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/tlon`, `plugin-sdk/twitch` | Вбудовані seam-и сумісності/допоміжних засобів каналів |
- | Допоміжні засоби, специфічні для auth/плагіна | `plugin-sdk/github-copilot-login`, `plugin-sdk/github-copilot-token`, `plugin-sdk/diagnostics-otel`, `plugin-sdk/diffs`, `plugin-sdk/llm-task`, `plugin-sdk/thread-ownership`, `plugin-sdk/voice-call` | Вбудовані seam-и допоміжних засобів функцій/плагінів; `plugin-sdk/github-copilot-token` наразі експортує `DEFAULT_COPILOT_API_BASE_URL`, `deriveCopilotApiBaseUrlFromToken` і `resolveCopilotApiToken` |
+ | Browser | `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support` | Допоміжні засоби підтримки bundled browser plugin (`browser-support` залишається barrel-файлом сумісності) |
+ | Matrix | `plugin-sdk/matrix`, `plugin-sdk/matrix-helper`, `plugin-sdk/matrix-runtime-heavy`, `plugin-sdk/matrix-runtime-shared`, `plugin-sdk/matrix-runtime-surface`, `plugin-sdk/matrix-surface`, `plugin-sdk/matrix-thread-bindings` | Поверхня helper/runtime для bundled Matrix |
+ | Line | `plugin-sdk/line`, `plugin-sdk/line-core`, `plugin-sdk/line-runtime`, `plugin-sdk/line-surface` | Поверхня helper/runtime для bundled LINE |
+ | IRC | `plugin-sdk/irc`, `plugin-sdk/irc-surface` | Поверхня helper-ів для bundled IRC |
+ | Специфічні для channel helper-и | `plugin-sdk/googlechat`, `plugin-sdk/zalouser`, `plugin-sdk/bluebubbles`, `plugin-sdk/bluebubbles-policy`, `plugin-sdk/mattermost`, `plugin-sdk/mattermost-policy`, `plugin-sdk/feishu-conversation`, `plugin-sdk/msteams`, `plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/tlon`, `plugin-sdk/twitch` | Bundled seams сумісності/helper для channel |
+ | Специфічні для auth/plugin helper-и | `plugin-sdk/github-copilot-login`, `plugin-sdk/github-copilot-token`, `plugin-sdk/diagnostics-otel`, `plugin-sdk/diffs`, `plugin-sdk/llm-task`, `plugin-sdk/thread-ownership`, `plugin-sdk/voice-call` | Bundled helper seams для функцій/plugin-ів; `plugin-sdk/github-copilot-token` наразі експортує `DEFAULT_COPILOT_API_BASE_URL`, `deriveCopilotApiBaseUrlFromToken` і `resolveCopilotApiToken` |
## API реєстрації
-Зворотний виклик `register(api)` отримує об’єкт `OpenClawPluginApi` з такими
+Callback `register(api)` отримує об’єкт `OpenClawPluginApi` з такими
методами:
-### Реєстрація можливостей
+### Реєстрація capability
-| Method | Що реєструє |
-| ------------------------------------------------ | ------------------------------- |
-| `api.registerProvider(...)` | Текстовий inference (LLM) |
-| `api.registerCliBackend(...)` | Локальний backend inference CLI |
-| `api.registerChannel(...)` | Канал обміну повідомленнями |
-| `api.registerSpeechProvider(...)` | Синтез мовлення / STT |
-| `api.registerRealtimeTranscriptionProvider(...)` | Потокова realtime транскрипція |
-| `api.registerRealtimeVoiceProvider(...)` | Двоспрямовані сесії realtime voice |
-| `api.registerMediaUnderstandingProvider(...)` | Аналіз зображень/аудіо/відео |
-| `api.registerImageGenerationProvider(...)` | Генерація зображень |
-| `api.registerMusicGenerationProvider(...)` | Генерація музики |
-| `api.registerVideoGenerationProvider(...)` | Генерація відео |
-| `api.registerWebFetchProvider(...)` | Провайдер веб-завантаження / скрапінгу |
-| `api.registerWebSearchProvider(...)` | Вебпошук |
+| Method | Що реєструє |
+| ------------------------------------------------ | ------------------------------ |
+| `api.registerProvider(...)` | Текстовий inference (LLM) |
+| `api.registerCliBackend(...)` | Локальний inference backend CLI |
+| `api.registerChannel(...)` | Канал повідомлень |
+| `api.registerSpeechProvider(...)` | Text-to-speech / STT synthesis |
+| `api.registerRealtimeTranscriptionProvider(...)` | Потокова транскрипція в realtime |
+| `api.registerRealtimeVoiceProvider(...)` | Duplex-сеанси voice у realtime |
+| `api.registerMediaUnderstandingProvider(...)` | Аналіз зображень/аудіо/відео |
+| `api.registerImageGenerationProvider(...)` | Генерація зображень |
+| `api.registerMusicGenerationProvider(...)` | Генерація музики |
+| `api.registerVideoGenerationProvider(...)` | Генерація відео |
+| `api.registerWebFetchProvider(...)` | Provider web fetch / scrape |
+| `api.registerWebSearchProvider(...)` | Вебпошук |
-### Інструменти та команди
+### Tools і команди
-| Method | Що реєструє |
-| ------------------------------- | -------------------------------------------- |
+| Method | Що реєструє |
+| ------------------------------- | --------------------------------------------- |
| `api.registerTool(tool, opts?)` | Інструмент агента (обов’язковий або `{ optional: true }`) |
-| `api.registerCommand(def)` | Власна команда (обходить LLM) |
+| `api.registerCommand(def)` | Користувацька команда (минає LLM) |
### Інфраструктура
| Method | Що реєструє |
-| ---------------------------------------------- | ---------------------------------- |
-| `api.registerHook(events, handler, opts?)` | Хук подій |
-| `api.registerHttpRoute(params)` | HTTP endpoint Gateway |
-| `api.registerGatewayMethod(name, handler)` | RPC-метод Gateway |
-| `api.registerCli(registrar, opts?)` | Підкоманда CLI |
-| `api.registerService(service)` | Фонова служба |
-| `api.registerInteractiveHandler(registration)` | Інтерактивний обробник |
-| `api.registerMemoryPromptSupplement(builder)` | Адитивний розділ prompt, суміжний із пам’яттю |
+| ---------------------------------------------- | ----------------------------------- |
+| `api.registerHook(events, handler, opts?)` | Event hook |
+| `api.registerHttpRoute(params)` | HTTP endpoint gateway |
+| `api.registerGatewayMethod(name, handler)` | RPC-метод gateway |
+| `api.registerCli(registrar, opts?)` | Підкоманда CLI |
+| `api.registerService(service)` | Фоновий сервіс |
+| `api.registerInteractiveHandler(registration)` | Інтерактивний handler |
+| `api.registerMemoryPromptSupplement(builder)` | Адитивний розділ prompt-а, суміжний із пам’яттю |
| `api.registerMemoryCorpusSupplement(adapter)` | Адитивний корпус пошуку/читання пам’яті |
-Зарезервовані простори назв адмін-функцій ядра (`config.*`, `exec.approvals.*`, `wizard.*`,
-`update.*`) завжди залишаються `operator.admin`, навіть якщо плагін намагається призначити
-вужчу область видимості gateway-методу. Для методів,
-якими володіє плагін, віддавайте перевагу специфічним для плагіна префіксам.
+Зарезервовані простори імен адміністрування ядра (`config.*`, `exec.approvals.*`, `wizard.*`,
+`update.*`) завжди залишаються `operator.admin`, навіть якщо plugin намагається призначити
+вужчу область видимості gateway method. Для методів, що належать
+plugin-у, віддавайте перевагу префіксам, специфічним для plugin.
### Метадані реєстрації CLI
-`api.registerCli(registrar, opts?)` приймає два типи метаданих верхнього рівня:
+`api.registerCli(registrar, opts?)` приймає два види метаданих верхнього рівня:
-- `commands`: явні корені команд, якими володіє registrar
-- `descriptors`: дескриптори команд часу розбору, які використовуються для довідки кореневого CLI,
- маршрутизації та лінивої реєстрації CLI плагіна
+- `commands`: явні корені команд, які належать registrar
+- `descriptors`: дескриптори команд на етапі парсингу, що використовуються для root CLI help,
+ маршрутизації та лінивої реєстрації CLI plugin-ів
-Якщо ви хочете, щоб команда плагіна залишалася ліниво завантажуваною у звичайному шляху кореневого CLI,
-надайте `descriptors`, які охоплюють кожен корінь команди верхнього рівня, що експонується цим
-registrar.
+Якщо ви хочете, щоб команда plugin-а залишалася lazy-loaded у звичайному root CLI,
+надайте `descriptors`, які охоплюють кожен корінь команди верхнього рівня, що
+експонується цим registrar.
```typescript
api.registerCli(
@@ -361,7 +362,7 @@ api.registerCli(
descriptors: [
{
name: "matrix",
- description: "Керування акаунтами Matrix, верифікацією, пристроями та станом профілю",
+ description: "Керуйте обліковими записами Matrix, верифікацією, пристроями та станом профілю",
hasSubcommands: true,
},
],
@@ -369,42 +370,42 @@ api.registerCli(
);
```
-Використовуйте `commands` окремо лише тоді, коли вам не потрібна лінива реєстрація кореневого CLI.
-Цей eager-шлях сумісності залишається підтримуваним, але він не встановлює
-заповнювачі на основі descriptor для лінивого завантаження під час розбору.
+Використовуйте `commands` окремо лише тоді, коли вам не потрібна лінива реєстрація root CLI.
+Цей eager-шлях сумісності й надалі підтримується, але він не встановлює
+placeholder-и на основі descriptor для лінивого завантаження під час парсингу.
### Реєстрація CLI backend
-`api.registerCliBackend(...)` дозволяє плагіну володіти конфігурацією за замовчуванням для локального
-backend AI CLI, такого як `codex-cli`.
+`api.registerCliBackend(...)` дозволяє plugin-у володіти типовою конфігурацією для локального
+AI CLI backend, такого як `codex-cli`.
-- `id` backend стає префіксом провайдера в model ref на кшталт `codex-cli/gpt-5`.
-- `config` backend використовує ту саму форму, що й `agents.defaults.cliBackends.`.
+- `id` backend-а стає префіксом provider у model ref, як-от `codex-cli/gpt-5`.
+- `config` backend-а використовує ту саму форму, що й `agents.defaults.cliBackends.`.
- Конфігурація користувача все одно має пріоритет. OpenClaw об’єднує `agents.defaults.cliBackends.` поверх
- значення за замовчуванням плагіна перед запуском CLI.
-- Використовуйте `normalizeConfig`, коли backend потребує переписувань для сумісності після об’єднання
+ типового значення plugin-а перед запуском CLI.
+- Використовуйте `normalizeConfig`, коли backend потребує rewrites сумісності після об’єднання
(наприклад, нормалізації старих форм прапорців).
-### Ексклюзивні слоти
+### Exclusive slots
-| Method | Що реєструє |
-| ------------------------------------------ | ----------------------------------- |
-| `api.registerContextEngine(id, factory)` | Контекстний engine (лише один активний одночасно) |
-| `api.registerMemoryPromptSection(builder)` | Конструктор розділу prompt пам’яті |
-| `api.registerMemoryFlushPlan(resolver)` | Resolver плану скидання пам’яті |
-| `api.registerMemoryRuntime(runtime)` | Адаптер runtime пам’яті |
+| Method | Що реєструє |
+| ------------------------------------------ | --------------------------------- |
+| `api.registerContextEngine(id, factory)` | Context engine (одночасно активний лише один) |
+| `api.registerMemoryPromptSection(builder)` | Builder розділу prompt-а пам’яті |
+| `api.registerMemoryFlushPlan(resolver)` | Resolver плану flush пам’яті |
+| `api.registerMemoryRuntime(runtime)` | Adapter runtime пам’яті |
-### Адаптери вбудовування пам’яті
+### Адаптери embedding пам’яті
-| Method | Що реєструє |
-| ---------------------------------------------- | ------------------------------------------------ |
-| `api.registerMemoryEmbeddingProvider(adapter)` | Адаптер вбудовування пам’яті для активного плагіна |
+| Method | Що реєструє |
+| ---------------------------------------------- | ---------------------------------------------- |
+| `api.registerMemoryEmbeddingProvider(adapter)` | Адаптер embedding пам’яті для активного plugin-а |
- `registerMemoryPromptSection`, `registerMemoryFlushPlan` і
- `registerMemoryRuntime` є ексклюзивними для плагінів пам’яті.
-- `registerMemoryEmbeddingProvider` дозволяє активному плагіну пам’яті реєструвати один
- або кілька id адаптерів вбудовування (наприклад, `openai`, `gemini` або власний
- id, визначений плагіном).
+ `registerMemoryRuntime` є exclusive для plugin-ів пам’яті.
+- `registerMemoryEmbeddingProvider` дозволяє активному plugin-у пам’яті зареєструвати один
+ або більше id адаптерів embedding (наприклад, `openai`, `gemini` або власний
+ id, визначений plugin-ом).
- Конфігурація користувача, така як `agents.defaults.memorySearch.provider` і
`agents.defaults.memorySearch.fallback`, визначається відносно цих зареєстрованих
id адаптерів.
@@ -413,85 +414,85 @@ backend AI CLI, такого як `codex-cli`.
| Method | Що робить |
| -------------------------------------------- | ---------------------------- |
-| `api.on(hookName, handler, opts?)` | Типізований хук життєвого циклу |
-| `api.onConversationBindingResolved(handler)` | Зворотний виклик прив’язки розмови |
+| `api.on(hookName, handler, opts?)` | Типізований lifecycle hook |
+| `api.onConversationBindingResolved(handler)` | Callback розв’язання binding conversation |
-### Семантика рішень хуків
+### Семантика рішень hook
-- `before_tool_call`: повернення `{ block: true }` є термінальним. Щойно будь-який обробник встановлює це значення, обробники з нижчим пріоритетом пропускаються.
-- `before_tool_call`: повернення `{ block: false }` вважається відсутністю рішення (так само, як пропуск `block`), а не перевизначенням.
-- `before_install`: повернення `{ block: true }` є термінальним. Щойно будь-який обробник встановлює це значення, обробники з нижчим пріоритетом пропускаються.
-- `before_install`: повернення `{ block: false }` вважається відсутністю рішення (так само, як пропуск `block`), а не перевизначенням.
-- `reply_dispatch`: повернення `{ handled: true, ... }` є термінальним. Щойно будь-який обробник заявляє про диспетчеризацію, обробники з нижчим пріоритетом і шлях диспетчеризації моделі за замовчуванням пропускаються.
-- `message_sending`: повернення `{ cancel: true }` є термінальним. Щойно будь-який обробник встановлює це значення, обробники з нижчим пріоритетом пропускаються.
-- `message_sending`: повернення `{ cancel: false }` вважається відсутністю рішення (так само, як пропуск `cancel`), а не перевизначенням.
+- `before_tool_call`: повернення `{ block: true }` є термінальним. Щойно будь-який handler встановлює його, handler-и з нижчим пріоритетом пропускаються.
+- `before_tool_call`: повернення `{ block: false }` розглядається як відсутність рішення (так само, як пропуск `block`), а не як перевизначення.
+- `before_install`: повернення `{ block: true }` є термінальним. Щойно будь-який handler встановлює його, handler-и з нижчим пріоритетом пропускаються.
+- `before_install`: повернення `{ block: false }` розглядається як відсутність рішення (так само, як пропуск `block`), а не як перевизначення.
+- `reply_dispatch`: повернення `{ handled: true, ... }` є термінальним. Щойно будь-який handler заявляє dispatch, handler-и з нижчим пріоритетом і типовий шлях dispatch моделі пропускаються.
+- `message_sending`: повернення `{ cancel: true }` є термінальним. Щойно будь-який handler встановлює його, handler-и з нижчим пріоритетом пропускаються.
+- `message_sending`: повернення `{ cancel: false }` розглядається як відсутність рішення (так само, як пропуск `cancel`), а не як перевизначення.
### Поля об’єкта API
-| Field | Type | Description |
+| Field | Type | Опис |
| ------------------------ | ------------------------- | ------------------------------------------------------------------------------------------- |
-| `api.id` | `string` | Id плагіна |
+| `api.id` | `string` | ID plugin-а |
| `api.name` | `string` | Відображувана назва |
-| `api.version` | `string?` | Версія плагіна (необов’язково) |
-| `api.description` | `string?` | Опис плагіна (необов’язково) |
-| `api.source` | `string` | Шлях до джерела плагіна |
-| `api.rootDir` | `string?` | Кореневий каталог плагіна (необов’язково) |
-| `api.config` | `OpenClawConfig` | Поточний знімок конфігурації (активний знімок у пам’яті під час виконання, коли доступний) |
-| `api.pluginConfig` | `Record` | Конфігурація, специфічна для плагіна, з `plugins.entries..config` |
+| `api.version` | `string?` | Версія plugin-а (необов’язково) |
+| `api.description` | `string?` | Опис plugin-а (необов’язково) |
+| `api.source` | `string` | Шлях до джерела plugin-а |
+| `api.rootDir` | `string?` | Коренева директорія plugin-а (необов’язково) |
+| `api.config` | `OpenClawConfig` | Поточний snapshot конфігурації (активний snapshot 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"` — це легковагове вікно запуску/налаштування до повного entry |
-| `api.resolvePath(input)` | `(string) => string` | Визначення шляху відносно кореня плагіна |
+| `api.resolvePath(input)` | `(string) => string` | Визначити шлях відносно кореня plugin-а |
## Угода щодо внутрішніх модулів
-Усередині вашого плагіна використовуйте локальні barrel-файли для внутрішніх імпортів:
+Усередині вашого plugin-а використовуйте локальні barrel-файли для внутрішніх імпортів:
```
my-plugin/
api.ts # Публічні експорти для зовнішніх споживачів
runtime-api.ts # Лише внутрішні експорти runtime
- index.ts # Точка входу плагіна
- setup-entry.ts # Легка точка входу лише для налаштування (необов’язково)
+ index.ts # Точка входу plugin-а
+ setup-entry.ts # Легка entry-точка лише для налаштування (необов’язково)
```
- Ніколи не імпортуйте власний плагін через `openclaw/plugin-sdk/`
- із production-коду. Маршрутизуйте внутрішні імпорти через `./api.ts` або
+ Ніколи не імпортуйте власний plugin через `openclaw/plugin-sdk/`
+ у production-коді. Спрямовуйте внутрішні імпорти через `./api.ts` або
`./runtime-api.ts`. Шлях SDK є лише зовнішнім контрактом.
-Публічні поверхні вбудованих плагінів, завантажувані через facade (`api.ts`, `runtime-api.ts`,
-`index.ts`, `setup-entry.ts` і подібні публічні entry-файли), тепер надають перевагу
-активному знімку конфігурації runtime, коли OpenClaw уже запущений. Якщо знімок runtime
-ще не існує, вони повертаються до визначеного файла конфігурації на диску.
+Публічні поверхні бандлованих plugin-ів, завантажувані через facade (`api.ts`, `runtime-api.ts`,
+`index.ts`, `setup-entry.ts` та подібні публічні entry-файли), тепер віддають перевагу
+активному snapshot конфігурації runtime, коли OpenClaw уже запущено. Якщо snapshot runtime
+ще не існує, вони повертаються до визначеного файлу конфігурації на диску.
-Плагіни провайдерів також можуть експортувати вузький локальний для плагіна barrel-контракт, коли
-допоміжний засіб навмисно є специфічним для провайдера і ще не належить до загального підшляху SDK.
-Поточний вбудований приклад: провайдер Anthropic зберігає свої допоміжні засоби Claude
-stream у власному публічному seam `api.ts` / `contract-api.ts` замість
-просування логіки Anthropic beta-header і `service_tier` у загальний
-контракт `plugin-sdk/*`.
+Provider plugins також можуть експортувати вузький локальний для plugin-а barrel контракту, коли
+helper навмисно є специфічним для provider-а і ще не належить до загального підшляху SDK.
+Поточний bundled-приклад: provider Anthropic зберігає свої helper-и stream Claude
+у власному публічному seam `api.ts` / `contract-api.ts`, замість
+просування логіки Anthropic beta-header і `service_tier` до загального
+контракту `plugin-sdk/*`.
-Інші поточні вбудовані приклади:
+Інші поточні bundled-приклади:
-- `@openclaw/openai-provider`: `api.ts` експортує конструктори провайдера,
- допоміжні засоби моделі за замовчуванням і конструктори realtime-провайдера
-- `@openclaw/openrouter-provider`: `api.ts` експортує конструктор провайдера, а також
- допоміжні засоби онбордингу/конфігурації
+- `@openclaw/openai-provider`: `api.ts` експортує builder-и provider-ів,
+ helper-и типових моделей і builder-и realtime provider-ів
+- `@openclaw/openrouter-provider`: `api.ts` експортує builder provider-а плюс
+ helper-и онбордингу/конфігурації
- Production-код розширень також має уникати імпортів `openclaw/plugin-sdk/`.
- Якщо допоміжний засіб справді є спільним, перенесіть його в нейтральний підшлях SDK,
- такий як `openclaw/plugin-sdk/speech`, `.../provider-model-shared` або іншу
- поверхню, орієнтовану на можливості, замість жорсткого зв’язування двох плагінів.
+ Production-код extension також має уникати імпортів `openclaw/plugin-sdk/`.
+ Якщо helper справді є спільним, перенесіть його до нейтрального підшляху SDK,
+ такого як `openclaw/plugin-sdk/speech`, `.../provider-model-shared` або іншої
+ поверхні, орієнтованої на capability, замість жорсткого зв’язування двох plugin-ів між собою.
## Пов’язане
-- [Entry Points](/uk/plugins/sdk-entrypoints) — параметри `definePluginEntry` і `defineChannelPluginEntry`
-- [Runtime Helpers](/uk/plugins/sdk-runtime) — повний довідник простору назв `api.runtime`
+- [Entry Points](/uk/plugins/sdk-entrypoints) — опції `definePluginEntry` і `defineChannelPluginEntry`
+- [Runtime Helpers](/uk/plugins/sdk-runtime) — повний довідник namespace `api.runtime`
- [Setup and Config](/uk/plugins/sdk-setup) — пакування, маніфести, схеми конфігурації
- [Testing](/uk/plugins/sdk-testing) — утиліти тестування та правила lint
- [SDK Migration](/uk/plugins/sdk-migration) — міграція із застарілих поверхонь
-- [Plugin Internals](/uk/plugins/architecture) — поглиблена архітектура та модель можливостей
+- [Plugin Internals](/uk/plugins/architecture) — глибока архітектура і модель capability